mirror of
https://github.com/anomalyco/hex.git
synced 2026-11-21 02:09:25 +08:00
Replace unconditional HXTM output with lookup-time flags for prefix and next-word suggestions, deterministic fixes, whole-word spatial readings, and both halves of missed spaces. Still use blocked words for probabilities, and keep a fully typed spelling (including out-of-model words) through space or a distinct literal chip. The Inter Keyboard switch enables profanity only; preference-aware caches refresh even in the active editor. Verified 8 filter tests and 5 existing tests in each of debug and release, including every curated entry across the four layouts. Reproduced offensive suggestions and space replacements on the Studio API 35 IME before the change; after it, confirmed safe near-miss results, intentional literals, live toggle refresh, and light/dark settings. The 4,000-sentence phase-4 replay changed English WER from 7.4045% to 7.4117% and left Spanish at 10.3301%.
Project Documentation
Start with the document for your task. Plans and archived prototypes do not override shipped behavior.
User Guides
../README.md: install and use Hex on macOS, Windows, and Linux.windows.md: Windows x64 and ARM64 beta requirements, installation, and source builds.linux.md: Linux X11 and native Wayland beta requirements and installation.nix.md: Nix packaging for Linux, development, and per-user autostart.../ios/README.md: build and test the iOS prototype.../sdk/typescript/README.md: use the public TypeScript transcription SDK with an explicitly supplied native helper.
Engineering Reference
../AGENTS.md: architecture, invariants, development commands, and diagnostics. This is the implementation authority.../ROADMAP.md: prioritized product and engineering work.design-system.md: Rune +rune-kit+ OpenCode theme components, Hex pieces, copy rules, and--snapscene verification.features/README.md: existing user-facing capabilities, entry points, available verification, and gaps; detailed dictation and recovery maps.perf.md: strobe benchmarks, the cases that drive the window through its accessibility tree, and how a benchmarked copy of Hex stays isolated.downloads.md: public download paths, R2 custom domains, GitHub release mirrors, and network recovery.opencode-compatibility.md: audited OpenCode V2 source and CLI baseline, integration contract, and validation limits.plans/personal-commands.md: shipped personal command contract and remaining lifecycle work.plans/quickjs.md: why and how configs run in embedded QuickJS instead of Bun, with size and latency measurements.specs/local-transcription-service.md: implemented macOS local-service protocol and lifecycle guarantees.
Architecture Decisions And Active Plans
plans/rune-ui.md: implemented; Rune desktop UI port, surfaces, goldens, and remaining real-window checklist.plans/single-process.md: implemented; one Hex process per user on macOS, Windows, and Linux hosting Rune windows and overlays.plans/rune-dependency.md: decision record for Rune as a public MIT Git dependency and Nix output-hash updates.plans/shared-desktop-ui.md: implemented; how macOS, Windows, and Linux share one window and one settings file.plans/swift-app-handoff.md: manual download handoff from Swift, without data import or automatic replacement.plans/typescript-sdk.md: published SDK status, remaining signed-helper packaging, and first-consumer validation.plans/linux.md: Linux X11/Wayland validation and later capability slices.plans/meeting-live-transcription.md: evaluation of Apple SpeechTranscriber vs Moonshine for live meeting drafts.plans/granola-import.md: research on importing historical Granola meetings intohex mcp.
When a plan disagrees with AGENTS.md about shipped behavior, update the plan.
Research And Archives
research/transcription-benchmark.md: historical benchmark method and measurements.../prototypes/app-shell/README.md: archived app-shell comparison prototype.
Releases
releases/ contains version-specific release notes and drafts. ../release-notes/ contains legacy inputs from versions
2.0.0 through 2.0.9. Published notes and the SDK changelog describe their release,
not current behavior; preserve them as historical records. A draft note is not
evidence that its release has been published.