CodeHear is a single VS Code extension for blind, visually impaired, and low-vision developers.

It narrates code structure (functions, classes, loops, call paths, diagnostics, and scope) so you can navigate code semantically instead of only hearing raw punctuation and line text.

What You Get (User POV)

Faster orientation in unknown files.
Deterministic structural narration while moving through code.
Dedicated ecosystem modes for repo understanding, debugging, review, testing, docs, and focus workflows.
Guided missions that announce "Step X of Y" progress.
Local-only AI reasoning via Ollama for optional, explicit commands.
Bookmarks, landmarks, macros, and accessibility profile export/import.

Core Guarantees

Local-first deterministic parser-driven narration.
Optional AI is local Ollama only (localhost), never cloud by default.
Real-time cursor narration does not depend on AI.
Single interruptible speech channel with dedupe/throttling.
Graceful fallback speech when syntax is incomplete or parsers fail.

Supported Languages

JavaScript (javascript, javascriptreact)
TypeScript (typescript, typescriptreact)
Python (python)
Java (java)
C (c)
C++ (cpp)
Go (go)
Rust (rust)

Install, Build, Validate

npm install
npm run compile
npm test

Optional full sanity workflow:

npm run sanity:first30

First Run (5 Minutes)

Press F5 to launch Extension Development Host.
Open a supported code file.
Move the cursor and run CodeHear: Describe Current Context.
Run CodeHear: Quick Context.
Run CodeHear: File Orientation Summary.
Switch modes with CodeHear: Switch Ecosystem Mode.

Voice Commands (Complete)

Important: CodeHear currently supports voice intent through the CodeHear: Switch Mode By Voice Intent command.

It opens an input box.
You can speak via OS dictation or type the phrase.
CodeHear parses your phrase into one ecosystem mode.
hear and here variants are accepted for all Hear modes (for example repo hear and repo here).
If voice input is not captured or cannot be mapped, CodeHear opens an accessible mode picker automatically.

Accepted Voice Intent Phrases By Mode

Mode	Accepted keywords and phrases
IDE	`ide`, `editor`, `code mode`, `coding`
RepoHear	`repohear`, `repo hear`, `repo`, `repository`
DebugHear	`debughear`, `debug hear`, `debug`, `debugging`
ReviewHear	`reviewhear`, `review hear`, `review`, `code review`, `pr review`
TestHear	`testhear`, `test hear`, `test`, `testing`
LearnHear	`learnhear`, `learn hear`, `learn`, `learning`
TerminalHear	`terminalhear`, `terminal hear`, `terminal`, `console`
GitHear	`githear`, `git hear`, `git`, `source control`
DocHear	`dochear`, `doc hear`, `docs`, `documentation`
SecurityHear	`securityhear`, `security hear`, `security`, `secure`
PerfHear	`perfhear`, `perf hear`, `performance`, `perf`
CollabHear	`collabhear`, `collab hear`, `collab`, `collaboration`, `handoff`
FocusHear	`focushear`, `focus hear`, `focus`, `low vision`

Voice Intent Examples

"Switch to DebugHear mode"
"Go to repo mode"
"Switch to repo here mode"
"Enable FocusHear"
"Switch to PR review"

Ecosystem Modes And How To Use Them

Mode	Best for	Start with
IDE	Core structural coding navigation	`codeHear.quickContext`, `codeHear.moveParent`
RepoHear	Understanding architecture and entrypoints	`codeHear.understandRepo`, `codeHear.repoOverviewLocal`
DebugHear	Diagnostics and bug triage	`codeHear.jumpToNextDiagnostic`, `codeHear.startDebugCopilotLoop`
ReviewHear	Risk-first changed file review	`codeHear.reviewChangedFiles`, `codeHear.reviewRiskSummaryLocal`
TestHear	Interpreting failing tests	`codeHear.testFailureExplanationLocal`, `codeHear.jumpToNextDiagnostic`
LearnHear	Beginner-friendly contextual learning	`codeHear.quickContext`, `codeHear.summarizeIntentLocal`
TerminalHear	Translating terminal output into actionable steps	`codeHear.testFailureExplanationLocal`, `codeHear.quickContext`
GitHear	Commit readiness and handoff	`codeHear.reviewChangedFiles`, `codeHear.generateHandoffSummary`
DocHear	Setup/troubleshooting/document navigation	`codeHear.repoOverviewLocal`, `codeHear.intentQuery`
SecurityHear	Security smell prioritization	`codeHear.reviewRiskSummaryLocal`, `codeHear.explainCurrentDiagnostic`
PerfHear	Performance hotspot awareness	`codeHear.audioRadar`, `codeHear.summarizeFunctionChangesSinceSave`
CollabHear	Team sync and handoff output	`codeHear.generateHandoffSummary`, `codeHear.missionStatus`
FocusHear	Reduced-clutter low-vision coding	`codeHear.quickContext`, `codeHear.fileOrientationSummary`

Complete Command Catalog (All Features)

Command ID	Command Palette Title	What it does	How to use
`codeHear.describeCurrentContext`	CodeHear: Describe Current Context	Speaks the semantic unit at cursor.	Run on any code line to hear current block meaning.
`codeHear.quickContext`	CodeHear: Quick Context	Speaks compact mode + task + location context.	Use as a frequent orientation checkpoint.
`codeHear.moveParent`	CodeHear: Move To Parent Node	Moves to parent AST node and narrates.	Run when you want to go one scope up.
`codeHear.moveFirstChild`	CodeHear: Move To First Child Node	Moves to first child node and narrates.	Run to drill into current block quickly.
`codeHear.moveNextSibling`	CodeHear: Move To Next Sibling	Moves to next sibling node.	Run for lateral navigation in same scope.
`codeHear.movePreviousSibling`	CodeHear: Move To Previous Sibling	Moves to previous sibling node.	Run to backtrack sibling-level traversal.
`codeHear.selectCurrentBlock`	CodeHear: Select Current Structural Block	Selects full current semantic block.	Run before refactor/copy actions.
`codeHear.jumpNextFunction`	CodeHear: Jump To Next Function	Jumps to next function or method.	Use to skim implementation order.
`codeHear.jumpNextClass`	CodeHear: Jump To Next Class	Jumps to next class block.	Use in OO-heavy files.
`codeHear.jumpNextLoop`	CodeHear: Jump To Next Loop	Jumps to next loop construct.	Use for performance and flow review.
`codeHear.jumpNextErrorNode`	CodeHear: Jump To Next Error Node	Jumps to parse error region.	Use when file has incomplete syntax.
`codeHear.fileOrientationSummary`	CodeHear: File Orientation Summary	Speaks classes/functions/loops/diagnostics map.	Run when opening unfamiliar files.
`codeHear.audioRadar`	CodeHear: Audio Radar	Plays optional earcon radar then structural summary.	Run for compact high-level topology.
`codeHear.speakBreadcrumbPath`	CodeHear: Speak Breadcrumb Path	Speaks AST breadcrumb chain.	Use to understand nested ownership.
`codeHear.speakCallPath`	CodeHear: Speak Call Path	Speaks call-path around selected symbol.	Use during bug tracing and design review.
`codeHear.intentQuery`	CodeHear: Intent Query	Finds likely code locations for natural-language query.	Ask "where is token validated" style questions.
`codeHear.summarizeFunctionChangesSinceSave`	CodeHear: Summarize Function Changes Since Save	Reports unsaved changes and risk signals in current scope.	Run before save/commit.
`codeHear.repeatLastAnnouncement`	CodeHear: Repeat Last Announcement	Repeats previous spoken output.	Use when speech was interrupted or missed.
`codeHear.spellCurrentToken`	CodeHear: Spell Current Token	Spells current token with optional phonetic map.	Use for exact symbol verification.
`codeHear.enterStickyCommandMode`	CodeHear: Enter Sticky Command Mode	Keeps command picker loop active for rapid nav.	Enter for repeated command bursts.
`codeHear.exitStickyCommandMode`	CodeHear: Exit Sticky Command Mode	Exits sticky command loop.	Run when finished burst actions.
`codeHear.repeatLastAction`	CodeHear: Repeat Last Action	Re-runs last command action.	Use for repetitive movement/check loops.

2) Diagnostics And Debug

Command ID	Command Palette Title	What it does	How to use
`codeHear.jumpToNextDiagnostic`	CodeHear: Jump To Next Diagnostic	Jumps cursor to next diagnostic.	Run to triage compile/lint errors quickly.
`codeHear.explainCurrentDiagnostic`	CodeHear: Explain Current Diagnostic	Speaks likely cause and fix pattern.	Run after jumping to an error.
`codeHear.startDebugCopilotLoop`	CodeHear: Start Debug Copilot Loop	Runs narrated debug sequence end-to-end.	Use when actively fixing a bug.
`codeHear.explainCurrentStackFrame`	CodeHear: Explain Current Stack Frame	Narrates current stack frame context.	Run in debug investigations.
`codeHear.summarizeVariableChanges`	CodeHear: Summarize Variable Changes	Narrates variable deltas around cursor context.	Use while stepping or reviewing state.
`codeHear.suggestNextBreakpoint`	CodeHear: Suggest Next Breakpoint	Suggests useful next breakpoint location.	Run after first failure localization.
`codeHear.speakCallStackBreadcrumb`	CodeHear: Speak Call Stack Breadcrumb	Speaks call-stack breadcrumb string.	Use for stack orientation mid-debug.

3) Ecosystem Modes

Command ID	Command Palette Title	What it does	How to use
`codeHear.switchMode`	CodeHear: Switch Ecosystem Mode	Opens picker and activates selected mode.	Main mode switch method.
`codeHear.switchModeByVoice`	CodeHear: Switch Mode By Voice Intent	Parses spoken/typed phrase into mode.	Use phrase like "switch to debughear".
`codeHear.currentMode`	CodeHear: Speak Current Mode	Speaks active mode and quick context.	Run when unsure of active context.
`codeHear.openActionCenter`	CodeHear: Open Mini Action Center	Opens compact action hub to run common extension commands.	Use as one-place command launcher.
`codeHear.listModes`	CodeHear: List Ecosystem Modes	Opens mode output panel with descriptions and actions.	Run to learn mode purpose and entry cues.

4) Mission Engine

Command ID	Command Palette Title	What it does	How to use
`codeHear.startMission`	CodeHear: Start Mission	Starts Bug-Fix, Feature, Review, or Test-Fix mission template.	Select template, then enter mission goal.
`codeHear.nextMissionStep`	CodeHear: Next Mission Step	Advances mission to next step.	Run after completing current step.
`codeHear.repeatMissionStep`	CodeHear: Repeat Mission Step	Repeats current mission instruction.	Run when you need current step repeated.
`codeHear.missionStatus`	CodeHear: Mission Status	Speaks template, step, and completion state.	Use in long sessions to re-sync.
`codeHear.completeMission`	CodeHear: Complete Mission	Marks mission complete and narrates completion.	Run when mission goal is done.

5) Local AI (Ollama, Localhost Only)

Command ID	Command Palette Title	What it does	How to use
`codeHear.setupLocalAiGuided`	CodeHear: Setup Local AI Guided	Guided setup for local Ollama endpoint/model.	Run once during initial setup.
`codeHear.checkLocalAiStatus`	CodeHear: Check Local AI Status	Reports health, model, and installed tags.	Run when local AI commands fail.
`codeHear.selectLocalAiModel`	CodeHear: Select Local AI Model	Picks installed model and updates settings.	Run after pulling new model.
`codeHear.summarizeIntentLocal`	CodeHear: Summarize Intent (Local Ollama)	Gives intent summary for current semantic node.	Run when learning unfamiliar blocks.
`codeHear.pullLocalAiModel`	CodeHear: Pull Local AI Model	Starts `ollama pull` in integrated terminal and syncs model settings.	Run when adding new model locally.
`codeHear.repoOverviewLocal`	CodeHear: Repo Overview (Local Reasoning)	Generates repository orientation narration.	Use for onboarding in unknown repo.
`codeHear.reviewRiskSummaryLocal`	CodeHear: Review Risk Summary (Local Reasoning)	Summarizes PR risk in concise spoken form.	Run before review or merge.
`codeHear.testFailureExplanationLocal`	CodeHear: Test Failure Explanation (Local Reasoning)	Explains pasted test failure text.	Paste assertion/trace and run command.
`codeHear.generateHandoffSummary`	CodeHear: Generate Accessibility Handoff Summary	Creates spoken + markdown team handoff artifact.	Run at end of session or shift handoff.

6) Task, Repo, Review, Productivity

Command ID	Command Palette Title	What it does	How to use
`codeHear.setTaskMode`	CodeHear: Set Task Mode	Sets read/debug/refactor/pr-review mode and narration presets.	Run at start of a focused task.
`codeHear.startTask`	CodeHear: Start Task	Generates and narrates multi-step task flow from your goal.	Enter goal like "find why login fails".
`codeHear.understandRepo`	CodeHear: Understand This Repo	Produces architecture/dataflow/hotspot/entrypoint summary.	Use during repo onboarding.
`codeHear.reviewChangedFiles`	CodeHear: Review Changed Files	Risk-ranks changed files and narrates review order.	Run before code review/commit.
`codeHear.showProductivityMetrics`	CodeHear: Show Productivity Metrics	Shows session productivity metrics panel.	Run to track workflow gains.
`codeHear.showRecentLandmarks`	CodeHear: Show Recent Landmarks	Lists recent visited semantic landmarks.	Use to jump back to recent context.
`codeHear.addBookmarkWithLabel`	CodeHear: Add Bookmark With Label	Saves labeled bookmark at current position.	Add stable navigation anchors.
`codeHear.jumpToBookmark`	CodeHear: Jump To Bookmark	Jumps to selected saved bookmark.	Use for fast context switching.
`codeHear.runMacro`	CodeHear: Run Macro	Executes pre-defined macro command sequence.	Use for repeatable command routines.
`codeHear.selectVoicePackTheme`	CodeHear: Select Voice Pack And Earcon Theme	Updates voice pack and earcon theme presets.	Use to tune fatigue and audio style.

7) Accessibility Profile Management

Command ID	Command Palette Title	What it does	How to use
`codeHear.exportProfile`	CodeHear: Export Accessibility Profile	Exports accessibility settings as JSON.	Use to back up/share setup.
`codeHear.importProfile`	CodeHear: Import Accessibility Profile	Imports profile JSON to workspace settings.	Use to apply team/user presets quickly.

8) Dynamic Intelligence Layer (A-I)

Command ID	Command Palette Title	What it does	How to use
`codeHear.currentIntentState`	CodeHear: Current Intent State	Speaks current inferred intent state and confidence.	Run to verify what CodeHear thinks you are doing.
`codeHear.explainWhyCurrentState`	CodeHear: Explain Why Current Intent State	Speaks intent state plus reasons from recent signals.	Run when state feels wrong and you want reasoning.
`codeHear.suggestNextAction`	CodeHear: Suggest Next Action	Speaks top next-best action from dynamic queue.	Run as lightweight guidance during debug/review loops.
`codeHear.acceptSuggestedAction`	CodeHear: Accept Suggested Action	Executes the top queued action (or speaks fallback).	Run to confirm queue recommendation immediately.
`codeHear.dismissSuggestedAction`	CodeHear: Dismiss Suggested Action	Removes top queued action.	Run when suggestion is low-value for current goal.
`codeHear.readSuggestionQueue`	CodeHear: Read Suggestion Queue	Opens output queue and narrates top suggestion.	Run to inspect ranked queue before acting.
`codeHear.currentRiskPulse`	CodeHear: Current Risk Pulse	Speaks current risk level, score, and confidence.	Run before commits or when edits feel risky.
`codeHear.explainRiskPulse`	CodeHear: Explain Risk Pulse	Explains why pulse is high/medium/low.	Run to understand risk drivers in current file.
`codeHear.jumpToTopRiskRegion`	CodeHear: Jump To Top Risk Region	Moves cursor to highest-risk tracked region.	Run for risk-first review and fix order.
`codeHear.enableMissionAutopilot`	CodeHear: Enable Mission Autopilot	Turns on automatic mission replanning.	Enable for long multi-step debugging sessions.
`codeHear.disableMissionAutopilot`	CodeHear: Disable Mission Autopilot	Turns off automatic mission replanning.	Disable for strict manual mission control.
`codeHear.contextRescueNow`	CodeHear: Context Rescue Now	Speaks drift recovery summary with landmarks and intent.	Run when feeling disoriented in deep code.
`codeHear.toggleAutoContextRescue`	CodeHear: Toggle Auto Context Rescue	Toggles automatic rescue trigger.	Run to control proactive rescue behavior.
`codeHear.predictNextLocations`	CodeHear: Predict Next Locations	Generates top predicted next jump targets.	Run before repeated diagnostic/changed-line jumps.
`codeHear.jumpPredictedLocation1`	CodeHear: Jump Predicted Location 1	Jumps to top prediction if confidence passes threshold.	Use with keyboard-only prediction workflow.
`codeHear.jumpPredictedLocation2`	CodeHear: Jump Predicted Location 2	Jumps to second prediction if confidence passes threshold.	Use when first prediction is not relevant.
`codeHear.jumpPredictedLocation3`	CodeHear: Jump Predicted Location 3	Jumps to third prediction if confidence passes threshold.	Use for broader predicted triage sweep.
`codeHear.handoffReadiness`	CodeHear: Handoff Readiness	Scores readiness and narrates blockers/actions.	Run before shift handoff or PR transfer.

Keybindings (Defaults)

CodeHear ships preset-based keybindings:

codeHear.keybindingPreset = nvda-friendly
codeHear.keybindingPreset = voiceover-friendly
codeHear.keybindingPreset = custom

High-use defaults (nvda-friendly) include:

Ctrl+Alt+D: Describe Current Context
Ctrl+Alt+Q: Quick Context
Ctrl+Alt+S: Switch Mode
Ctrl+Alt+W: Switch Mode By Voice Intent
Ctrl+Alt+0: Open Mini Action Center
Ctrl+Alt+Y: Speak Current Mode
Ctrl+Alt+E: Jump To Next Diagnostic
Ctrl+Alt+M: Enter Sticky Command Mode
Ctrl+Alt+R: Repeat Last Announcement

Workflow-gated defaults:

Ctrl+Alt+T: Start Task (read mode)
Ctrl+Alt+G: Start Debug Copilot Loop (debug mode)
Ctrl+Alt+V: Review Changed Files (pr-review mode)

Mission defaults:

Ctrl+Alt+Shift+T: Start Mission
Ctrl+Alt+]: Next Mission Step
Ctrl+Alt+[: Mission Status

Dynamic defaults:

Ctrl+Alt+1: Current Intent State
Ctrl+Alt+2: Suggest Next Action
Ctrl+Alt+3: Accept Suggested Action
Ctrl+Alt+4: Dismiss Suggested Action
Ctrl+Alt+5: Current Risk Pulse
Ctrl+Alt+6: Jump To Top Risk Region
Ctrl+Alt+7: Context Rescue Now
Ctrl+Alt+8: Predict Next Locations
Ctrl+Alt+9: Handoff Readiness
Ctrl+Alt+Shift+1: Jump Predicted Location 1
Ctrl+Alt+Shift+2: Jump Predicted Location 2
Ctrl+Alt+Shift+3: Jump Predicted Location 3

How To Use Every Feature Group (Practical Flows)

Flow A: Daily Coding Orientation

Run codeHear.switchMode and choose ide or focushear.
Run codeHear.quickContext every time you enter a new file/section.
Use codeHear.moveParent, codeHear.moveNextSibling, and codeHear.moveFirstChild for structural movement.
Use codeHear.fileOrientationSummary before larger edits.

Flow B: Fast Bug Fix

Run codeHear.switchModeByVoice with "switch to debughear".
Run codeHear.startMission with template bug-fix.
Run codeHear.startDebugCopilotLoop.
Run codeHear.nextMissionStep as each checkpoint is finished.
Run codeHear.completeMission when fixed.

Flow C: PR Review

Run codeHear.switchMode and select reviewhear.
Run codeHear.reviewChangedFiles.
Run codeHear.reviewRiskSummaryLocal (if local AI enabled).
Run codeHear.generateHandoffSummary for reviewer handoff notes.

Flow D: Test Failure Triage

Run codeHear.switchMode and select testhear or terminalhear.
Run codeHear.testFailureExplanationLocal and paste failing output.
Run codeHear.jumpToNextDiagnostic and codeHear.explainCurrentDiagnostic.
Run codeHear.summarizeFunctionChangesSinceSave before re-run.

Flow E: Repo Onboarding

Run codeHear.switchModeByVoice with "switch to repohear".
Run codeHear.understandRepo.
Run codeHear.repoOverviewLocal.
Run codeHear.intentQuery for targeted search (for example "where is auth token validated").

Flow F: Dynamic Rescue and Risk-First Fixing

Run codeHear.currentIntentState to confirm inferred task state.
Run codeHear.suggestNextAction and codeHear.acceptSuggestedAction for guided next step.
Run codeHear.currentRiskPulse and codeHear.jumpToTopRiskRegion to prioritize highest-risk edits.
Run codeHear.predictNextLocations then jump via codeHear.jumpPredictedLocation1/2/3.
Run codeHear.contextRescueNow when you lose track.
Run codeHear.handoffReadiness before handing work to teammate/reviewer.

Settings You Will Use Most

Narration and Accessibility

codeHear.verbosity
codeHear.verbosityProfile
codeHear.punctuationMode
codeHear.pushToTalk
codeHear.coexistenceMode
codeHear.announcementDedup
codeHear.announcementThrottleMs

Modes and Workflow

codeHear.mode.default
codeHear.mode.persistPerWorkspace
codeHear.taskMode
codeHear.taskModeAutoPreset

Voice and Earcons

codeHear.voice.rate
codeHear.voice.pitch
codeHear.voice.volume
codeHear.voice.preferredName
codeHear.voice.pausePunctuation
codeHear.voice.style
codeHear.voicePack
codeHear.earconTheme

Local AI (Optional)

codeHear.localAI.enabled
codeHear.localAI.provider
codeHear.localAI.baseUrl
codeHear.localAI.model
codeHear.localAI.timeoutMs
codeHear.localAI.maxTokens
codeHear.localAI.temperature
codeHear.localAI.spokenNoticeEnabled

Dynamic Intelligence

codeHear.dynamicNarration.enabled
codeHear.dynamicNarration.maxShiftPerMinute
codeHear.fatigueGuard.enabled
codeHear.fatigueGuard.checkpointMinutes
codeHear.intentEngine.enabled
codeHear.intentEngine.transitionDebounceMs
codeHear.suggestionEngine.enabled
codeHear.suggestionEngine.maxQueueSize
codeHear.riskPulse.enabled
codeHear.riskPulse.announceThreshold
codeHear.riskPulse.highRiskInterruptEnabled
codeHear.missionAutopilot.enabled
codeHear.contextRescue.autoEnabled
codeHear.contextRescue.cooldownMs
codeHear.sonar.enabled
codeHear.sonar.intensity
codeHear.sonar.depthMapping
codeHear.sonar.errorProximityAlerts
codeHear.prediction.enabled
codeHear.prediction.minConfidence
codeHear.handoffReadiness.enabled

Dynamic Triggers and Benefits

The dynamic layer continuously watches navigation, command usage, diagnostics, changed lines, mission state, and context drift signals.

Blind developers: Faster recovery from disorientation loops via proactive context rescue and intent narration.
Visually impaired developers: Lower cognitive load through confidence-ranked next actions and risk-first jumps.
Low-vision developers: Better sustained focus with fatigue checkpoints, adaptive verbosity, and sonar cues.

High-value trigger examples:

Repeated diagnostic jumps plus undo bursts: intent shifts toward debug.
Rapid file-switch loops with backtracking: context rescue trigger candidates.
Security-sensitive changed lines plus rising diagnostics: risk pulse threshold interrupt.
Mission in progress with scope/diagnostic/test changes: autopilot mission replan.

Deterministic Fallback Behavior

Local AI failures never block command completion.
Suggestions, risk explanations, and test-failure explanations fall back to deterministic local templates.
If Ollama is unavailable, CodeHear narrates actionable fix guidance and continues with non-AI output.
Push-to-talk and strict screen-reader coexistence still suppress auto narration paths exactly as before.

Local AI Policy

Local AI is optional.
Local AI endpoints must be localhost (localhost, 127.0.0.1, ::1).
Remote endpoints are blocked by design.
Cursor-move narration remains deterministic and non-AI.

Additional Guides

USER_POV_EXTENSION_GUIDE.md
ACCESSIBILITY_GUIDE.md
MODES_GUIDE.md
MISSIONS_GUIDE.md
OLLAMA_SETUP.md
TROUBLESHOOTING.md

Architecture Entry Points

Activation and runtime wiring: src/extension.ts
Structural command layer: src/commands/structuralCommands.ts
Workflow command layer: src/commands/workflowCommands.ts
Ecosystem/mode/mission/local-AI command layer: src/commands/ecosystemCommands.ts
Dynamic intent/risk/rescue/prediction command layer: src/commands/dynamicCommands.ts
Mode engine: src/workflows/modeManagerService.ts
Mission engine: src/workflows/missionEngineService.ts
Intent state engine: src/workflows/intentStateEngine.ts
Suggestion engine: src/workflows/suggestionEngine.ts
Risk pulse service: src/workflows/riskPulseService.ts
Context rescue service: src/workflows/contextRescueService.ts
Predictive jump service: src/workflows/predictiveJumpService.ts
Handoff readiness service: src/workflows/handoffReadinessService.ts
Sonar cue service: src/audio/sonarService.ts
Local AI service: src/ai/localAiService.ts

Current Validation Snapshot

Latest validation run in this repository:

npm run compile: passing
npm run lint: passing
npm test: passing (53 passing, 0 failing)
npm run sanity:first30: completed all scripted checks successfully

CodeHear