usesteady 0.1.0-alpha.1

package/dist/src/understand/intent-interpretation/interpreters/color-intent.interpreter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-intent.interpreter.d.ts","sourceRoot":"","sources":["../../../../../src/understand/intent-interpretation/interpreters/color-intent.interpreter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAwB,MAAM,aAAa,CAAC;AAe3E,eAAO,MAAM,sBAAsB,EAAE,iBA4BpC,CAAC"}

package/dist/src/understand/intent-interpretation/interpreters/color-intent.interpreter.js

@@ -0,0 +1,66 @@
+/**
+ * Color intent interpreter.
+ *
+ * Scope: detect inputs that appear to be visual/color style changes.
+ * Priority 20 — runs after config (which owns toggle/enable verbs).
+ *
+ * Color signal words: named colors, comparative terms (darker/lighter), and
+ * the generic words "color" / "colour".
+ *
+ * UI target terms: component names that contextualize the color signal and
+ * raise confidence from "low" (color word only) to "medium" (color + target).
+ *
+ * Noun-context guard — DARK MODE:
+ *   "dark mode" as a compound noun refers to a UI theme variant, not a shade/color
+ *   change. The word "dark" alone would otherwise trigger this interpreter (false
+ *   positive). If the input contains the phrase "dark mode", the interpreter returns
+ *   null and yields to the config interpreter or bridge silence.
+ *
+ *   Examples of the guard in action:
+ *     "I want to add dark mode"   → null  (feature request, not color change)
+ *     "add a dark mode option"    → null  (same: feature request)
+ *     "make the background dark"  → visual_color  (shade change — guard does NOT fire)
+ *     "darker shade of blue"      → visual_color  (no "dark mode" phrase — guard OK)
+ *     "enable dark mode"          → config_change (config fires first at priority 10)
+ *
+ * Language contract:
+ *   Summary says "appears to be a color/style change request" — medium confidence.
+ *   Never says "background becomes blue" or infers the component type.
+ *   basis[] reports the exact matched token so the result is inspectable.
+ */
+const COLOR_WORDS_RE = /\b(blue|red|green|yellow|orange|purple|pink|black|white|gray|grey|teal|indigo|violet|cyan|magenta|coral|slate|stone|zinc|neutral|amber|lime|emerald|sky|rose|darker|lighter|dark|light|colors?|colours?)\b/i;
+const UI_COLOR_TARGETS_RE = /\b(button|background|header|footer|nav|sidebar|icon|badge|label|link|card|chip|tag|border|text|heading|banner|hero|modal|overlay|avatar)\b/i;
+/**
+ * Noun-context guard: "dark mode" is a compound noun (UI theme feature),
+ * not a color/shade description. Matched exactly as a phrase to avoid
+ * over-suppression of "dark background", "dark overlay", etc.
+ */
+const DARK_MODE_GUARD_RE = /\bdark\s+mode\b/i;
+export const colorIntentInterpreter = {
+    id: "color_intent",
+    priority: 20,
+    matches(input) {
+        if (DARK_MODE_GUARD_RE.test(input))
+            return false;
+        return COLOR_WORDS_RE.test(input);
+    },
+    interpret(input) {
+        if (DARK_MODE_GUARD_RE.test(input))
+            return null;
+        const colorMatch = COLOR_WORDS_RE.exec(input);
+        if (colorMatch === null)
+            return null;
+        const basis = [`matched color word: ${colorMatch[1]}`];
+        const targetMatch = UI_COLOR_TARGETS_RE.exec(input);
+        if (targetMatch !== null) {
+            basis.push(`ui target term: ${targetMatch[1]}`);
+        }
+        return {
+            category: "visual_color",
+            summary: "This appears to be a color/style change request.",
+            confidence: targetMatch !== null ? "medium" : "low",
+            basis,
+        };
+    },
+};
+//# sourceMappingURL=color-intent.interpreter.js.map

package/dist/src/understand/intent-interpretation/interpreters/color-intent.interpreter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-intent.interpreter.js","sourceRoot":"","sources":["../../../../../src/understand/intent-interpretation/interpreters/color-intent.interpreter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAIH,MAAM,cAAc,GAClB,6MAA6M,CAAC;AAEhN,MAAM,mBAAmB,GACvB,6IAA6I,CAAC;AAEhJ;;;;GAIG;AACH,MAAM,kBAAkB,GAAG,kBAAkB,CAAC;AAE9C,MAAM,CAAC,MAAM,sBAAsB,GAAsB;IACvD,EAAE,EAAE,cAAc;IAClB,QAAQ,EAAE,EAAE;IAEZ,OAAO,CAAC,KAAK;QACX,IAAI,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QACjD,OAAO,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;IAED,SAAS,CAAC,KAAK;QACb,IAAI,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAChD,MAAM,UAAU,GAAG,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC9C,IAAI,UAAU,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAErC,MAAM,KAAK,GAAa,CAAC,uBAAuB,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAEjE,MAAM,WAAW,GAAG,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpD,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;YACzB,KAAK,CAAC,IAAI,CAAC,mBAAmB,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAClD,CAAC;QAED,OAAO;YACL,QAAQ,EAAI,cAAc;YAC1B,OAAO,EAAK,kDAAkD;YAC9D,UAAU,EAAE,WAAW,KAAK,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK;YACnD,KAAK;SACN,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/src/understand/intent-interpretation/interpreters/config-intent.interpreter.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Config intent interpreter.
+ *
+ * Scope: detect inputs that appear to be feature flags, toggles, or configuration
+ * value changes. Priority 10 — runs before color/text to prevent "toggle dark mode"
+ * being misclassified as a color change.
+ *
+ * Strong verbs (always config-like regardless of noun):
+ *   toggle, enable, disable, activate, deactivate
+ *
+ * Config nouns (trigger even with generic verbs like "set" / "change"):
+ *   timeout, port, flag, config, configuration, env, environment, variable, feature, debug, logging
+ *
+ * Out of scope: general UI state like "disable the button" is borderline,
+ * but v1 errs toward config_change when a strong config verb is present.
+ * Confidence is "medium" throughout — the bridge never claims certainty.
+ */
+import type { IntentInterpreter } from "../types.js";
+export declare const configIntentInterpreter: IntentInterpreter;
+//# sourceMappingURL=config-intent.interpreter.d.ts.map

package/dist/src/understand/intent-interpretation/interpreters/config-intent.interpreter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-intent.interpreter.d.ts","sourceRoot":"","sources":["../../../../../src/understand/intent-interpretation/interpreters/config-intent.interpreter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAwB,MAAM,aAAa,CAAC;AA0C3E,eAAO,MAAM,uBAAuB,EAAE,iBA8BrC,CAAC"}

package/dist/src/understand/intent-interpretation/interpreters/config-intent.interpreter.js

@@ -0,0 +1,80 @@
+/**
+ * Config intent interpreter.
+ *
+ * Scope: detect inputs that appear to be feature flags, toggles, or configuration
+ * value changes. Priority 10 — runs before color/text to prevent "toggle dark mode"
+ * being misclassified as a color change.
+ *
+ * Strong verbs (always config-like regardless of noun):
+ *   toggle, enable, disable, activate, deactivate
+ *
+ * Config nouns (trigger even with generic verbs like "set" / "change"):
+ *   timeout, port, flag, config, configuration, env, environment, variable, feature, debug, logging
+ *
+ * Out of scope: general UI state like "disable the button" is borderline,
+ * but v1 errs toward config_change when a strong config verb is present.
+ * Confidence is "medium" throughout — the bridge never claims certainty.
+ */
+const STRONG_CONFIG_VERBS_RE = /\b(toggle|enable|disable|activate|deactivate)\b/i;
+/**
+ * Config noun patterns — deliberately narrow to prevent false positives.
+ *
+ * ── Precision fixes (Sessions 4–5) ────────────────────────────────────────────
+ *
+ *   Removed standalone "feature":
+ *     "launch the new feature" was incorrectly firing config_change.
+ *     "feature" alone is too broad — it matches product ops, not only config.
+ *
+ *   Removed standalone "flag":
+ *     "flag any user with N failed logins" incorrectly fired config_change.
+ *     "flag" as a user-labeling verb is not config work.
+ *
+ *   Added "feature[\s-]flag" as a compound phrase:
+ *     The original intent — catching "update the feature flag" — is preserved.
+ *     "toggle/enable/disable the flag" still fires via STRONG_CONFIG_VERBS_RE.
+ *
+ * ── Precision fix (Session 6) ─────────────────────────────────────────────────
+ *
+ *   Removed standalone "debug":
+ *     "debug the authentication error" / "debug the service mesh" incorrectly fired
+ *     config_change because "debug" as a bare noun matched CONFIG_NOUNS_RE.
+ *     Session 6 confirmed this fires across 4/4 diagnostic inputs, 3 personas — a
+ *     systematic false positive, not an edge case.
+ *
+ *   Added "debug[\s-](?:mode|log(?:ging)?|level|flag)" as a compound phrase:
+ *     "debug mode for the API server" and "debug logging" are legitimate config work
+ *     and must continue to fire. The compound catches these without absorbing
+ *     diagnostic-verb uses like "debug the X" (where X is a problem or system).
+ *
+ *   "enable debug logging" still fires:
+ *     The strong verb "enable" matches STRONG_CONFIG_VERBS_RE independently, so
+ *     removing bare "debug" does not break the strong-verb path.
+ */
+const CONFIG_NOUNS_RE = /\b(?:timeout|port|config(?:uration)?|env(?:ironment)?|variable|logging)\b|\bfeature[\s-]flag\b|\bdebug[\s-](?:mode|log(?:ging)?|level|flag)\b/i;
+export const configIntentInterpreter = {
+    id: "config_intent",
+    priority: 10,
+    matches(input) {
+        return STRONG_CONFIG_VERBS_RE.test(input) || CONFIG_NOUNS_RE.test(input);
+    },
+    interpret(input) {
+        const basis = [];
+        const verbMatch = STRONG_CONFIG_VERBS_RE.exec(input);
+        if (verbMatch !== null) {
+            basis.push(`matched config verb: ${verbMatch[1]}`);
+        }
+        const nounMatch = CONFIG_NOUNS_RE.exec(input);
+        if (nounMatch !== null) {
+            basis.push(`matched config keyword: ${nounMatch[1]}`);
+        }
+        if (basis.length === 0)
+            return null;
+        return {
+            category: "config_change",
+            summary: "This appears to be a configuration change request.",
+            confidence: "medium",
+            basis,
+        };
+    },
+};
+//# sourceMappingURL=config-intent.interpreter.js.map

package/dist/src/understand/intent-interpretation/interpreters/config-intent.interpreter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-intent.interpreter.js","sourceRoot":"","sources":["../../../../../src/understand/intent-interpretation/interpreters/config-intent.interpreter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,MAAM,sBAAsB,GAC1B,kDAAkD,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,eAAe,GACnB,gJAAgJ,CAAC;AAEnJ,MAAM,CAAC,MAAM,uBAAuB,GAAsB;IACxD,EAAE,EAAE,eAAe;IACnB,QAAQ,EAAE,EAAE;IAEZ,OAAO,CAAC,KAAK;QACX,OAAO,sBAAsB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3E,CAAC;IAED,SAAS,CAAC,KAAK;QACb,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,MAAM,SAAS,GAAG,sBAAsB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrD,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;YACvB,KAAK,CAAC,IAAI,CAAC,wBAAwB,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACrD,CAAC;QAED,MAAM,SAAS,GAAG,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC9C,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;YACvB,KAAK,CAAC,IAAI,CAAC,2BAA2B,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACxD,CAAC;QAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAEpC,OAAO;YACL,QAAQ,EAAI,eAAe;YAC3B,OAAO,EAAK,oDAAoD;YAChE,UAAU,EAAE,QAAQ;YACpB,KAAK;SACN,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/src/understand/intent-interpretation/interpreters/text-intent.interpreter.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Text intent interpreter.
+ *
+ * Scope: detect inputs that appear to be UI text/copy changes.
+ * Priority 30 — runs last; requires BOTH a text-change verb AND a text target.
+ * This tighter match prevents generic verbs ("change") alone from triggering.
+ *
+ * Text change verbs: change, update, rename, edit, modify, rewrite, replace
+ * Text target terms: heading, headline, text, label, copy, title, caption,
+ *                    paragraph, message, description, placeholder, content,
+ *                    wording, phrase
+ *
+ * "change the heading text" → text_change  (verb + target both present)
+ * "change the background"   → not matched  (no text target → falls through to color)
+ * "rename the title"        → text_change  (rename is a strong text verb)
+ * "update button label"     → text_change  (update + label)
+ *
+ * Language contract:
+ *   Summary says "appears to be a text/content change request."
+ *   Does NOT say "heading label" or infer element type from the target word.
+ *   basis[] records both matched tokens.
+ */
+import type { IntentInterpreter } from "../types.js";
+export declare const textIntentInterpreter: IntentInterpreter;
+//# sourceMappingURL=text-intent.interpreter.d.ts.map

package/dist/src/understand/intent-interpretation/interpreters/text-intent.interpreter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-intent.interpreter.d.ts","sourceRoot":"","sources":["../../../../../src/understand/intent-interpretation/interpreters/text-intent.interpreter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAwB,MAAM,aAAa,CAAC;AAQ3E,eAAO,MAAM,qBAAqB,EAAE,iBAuBnC,CAAC"}

package/dist/src/understand/intent-interpretation/interpreters/text-intent.interpreter.js

@@ -0,0 +1,47 @@
+/**
+ * Text intent interpreter.
+ *
+ * Scope: detect inputs that appear to be UI text/copy changes.
+ * Priority 30 — runs last; requires BOTH a text-change verb AND a text target.
+ * This tighter match prevents generic verbs ("change") alone from triggering.
+ *
+ * Text change verbs: change, update, rename, edit, modify, rewrite, replace
+ * Text target terms: heading, headline, text, label, copy, title, caption,
+ *                    paragraph, message, description, placeholder, content,
+ *                    wording, phrase
+ *
+ * "change the heading text" → text_change  (verb + target both present)
+ * "change the background"   → not matched  (no text target → falls through to color)
+ * "rename the title"        → text_change  (rename is a strong text verb)
+ * "update button label"     → text_change  (update + label)
+ *
+ * Language contract:
+ *   Summary says "appears to be a text/content change request."
+ *   Does NOT say "heading label" or infer element type from the target word.
+ *   basis[] records both matched tokens.
+ */
+const TEXT_VERBS_RE = /\b(change|update|rename|edit|modify|rewrite|replace)\b/i;
+const TEXT_TARGETS_RE = /\b(heading|headline|label|copy|title|caption|paragraph|message|description|placeholder|content|wording|phrase|sentence|text)\b/i;
+export const textIntentInterpreter = {
+    id: "text_intent",
+    priority: 30,
+    matches(input) {
+        return TEXT_VERBS_RE.test(input) && TEXT_TARGETS_RE.test(input);
+    },
+    interpret(input) {
+        const verbMatch = TEXT_VERBS_RE.exec(input);
+        const targetMatch = TEXT_TARGETS_RE.exec(input);
+        if (verbMatch === null || targetMatch === null)
+            return null;
+        return {
+            category: "text_change",
+            summary: "This appears to be a text/content change request.",
+            confidence: "medium",
+            basis: [
+                `matched text change verb: ${verbMatch[1]}`,
+                `matched text target: ${targetMatch[1]}`,
+            ],
+        };
+    },
+};
+//# sourceMappingURL=text-intent.interpreter.js.map

package/dist/src/understand/intent-interpretation/interpreters/text-intent.interpreter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-intent.interpreter.js","sourceRoot":"","sources":["../../../../../src/understand/intent-interpretation/interpreters/text-intent.interpreter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH,MAAM,aAAa,GACjB,yDAAyD,CAAC;AAE5D,MAAM,eAAe,GACnB,iIAAiI,CAAC;AAEpI,MAAM,CAAC,MAAM,qBAAqB,GAAsB;IACtD,EAAE,EAAE,aAAa;IACjB,QAAQ,EAAE,EAAE;IAEZ,OAAO,CAAC,KAAK;QACX,OAAO,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClE,CAAC;IAED,SAAS,CAAC,KAAK;QACb,MAAM,SAAS,GAAI,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7C,MAAM,WAAW,GAAG,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChD,IAAI,SAAS,KAAK,IAAI,IAAI,WAAW,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAE5D,OAAO;YACL,QAAQ,EAAI,aAAa;YACzB,OAAO,EAAK,mDAAmD;YAC/D,UAAU,EAAE,QAAQ;YACpB,KAAK,EAAE;gBACL,6BAA6B,SAAS,CAAC,CAAC,CAAC,EAAE;gBAC3C,wBAAwB,WAAW,CAAC,CAAC,CAAC,EAAE;aACzC;SACF,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/src/understand/intent-interpretation/interpreters/workflow-intent.interpreter.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Workflow intent interpreter.
+ *
+ * Scope: detect inputs that appear to be development lifecycle / operational
+ * workflow requests — commit actions, sequential multi-step flows, and
+ * simple operational cleanup tasks.
+ *
+ * Priority 5 — runs first (before config, color, text) because commit verbs
+ * are unambiguous and must not be misclassified as config or text changes.
+ *
+ * Two signal families (either alone is sufficient to classify):
+ *
+ *   1. Commit signals
+ *      "commit", "git commit", "save changes", "save my changes"
+ *      → clearly a dev-lifecycle intent regardless of surrounding words
+ *
+ *   2. Sequential workflow signals
+ *      Patterns like "and then <verb>", "build and deploy", "test and commit"
+ *      → two-step or multi-step operational chains
+ *
+ * Language contract:
+ *   Summary says "appears to be a development workflow request" — medium confidence.
+ *   basis[] records the exact matched token so results are inspectable.
+ *   Never guesses the target branch, file, or working directory.
+ *
+ * Out of scope (v1):
+ *   "push to production", "merge branch", "rebase" — too broad for v1;
+ *   these fall back to the generic fallback guidance.
+ *
+ * ── Hard invariant ────────────────────────────────────────────────────────────
+ *   Interpretation can improve guidance, but it can never manufacture executability.
+ */
+import type { IntentInterpreter } from "../types.js";
+export declare const workflowIntentInterpreter: IntentInterpreter;
+//# sourceMappingURL=workflow-intent.interpreter.d.ts.map

package/dist/src/understand/intent-interpretation/interpreters/workflow-intent.interpreter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-intent.interpreter.d.ts","sourceRoot":"","sources":["../../../../../src/understand/intent-interpretation/interpreters/workflow-intent.interpreter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAwB,MAAM,aAAa,CAAC;AA8B3E,eAAO,MAAM,yBAAyB,EAAE,iBAqCvC,CAAC"}

package/dist/src/understand/intent-interpretation/interpreters/workflow-intent.interpreter.js

@@ -0,0 +1,89 @@
+/**
+ * Workflow intent interpreter.
+ *
+ * Scope: detect inputs that appear to be development lifecycle / operational
+ * workflow requests — commit actions, sequential multi-step flows, and
+ * simple operational cleanup tasks.
+ *
+ * Priority 5 — runs first (before config, color, text) because commit verbs
+ * are unambiguous and must not be misclassified as config or text changes.
+ *
+ * Two signal families (either alone is sufficient to classify):
+ *
+ *   1. Commit signals
+ *      "commit", "git commit", "save changes", "save my changes"
+ *      → clearly a dev-lifecycle intent regardless of surrounding words
+ *
+ *   2. Sequential workflow signals
+ *      Patterns like "and then <verb>", "build and deploy", "test and commit"
+ *      → two-step or multi-step operational chains
+ *
+ * Language contract:
+ *   Summary says "appears to be a development workflow request" — medium confidence.
+ *   basis[] records the exact matched token so results are inspectable.
+ *   Never guesses the target branch, file, or working directory.
+ *
+ * Out of scope (v1):
+ *   "push to production", "merge branch", "rebase" — too broad for v1;
+ *   these fall back to the generic fallback guidance.
+ *
+ * ── Hard invariant ────────────────────────────────────────────────────────────
+ *   Interpretation can improve guidance, but it can never manufacture executability.
+ */
+/**
+ * Commit-intent signal: the user clearly wants to perform a commit action.
+ * Requires "commit" / "git commit" / "save changes" in the input.
+ *
+ * "commit" must not be in a noun-reference context.
+ * Noun exclusion pattern catches: "show last commit", "view recent commits",
+ * "latest commit", "previous commit", "check commit history", etc.
+ * In these cases, "commit" refers to a past recorded commit, not an action.
+ */
+const COMMIT_SIGNAL_RE = /\b(git\s+commit|save\s+(?:my\s+)?changes|commit)\b/i;
+/**
+ * Noun-context guard: "commit" is being used as a noun (reference to a
+ * past/existing commit object), NOT as a verb (the action of committing).
+ *
+ * If this matches, the commit signal must be suppressed.
+ */
+const COMMIT_NOUN_CONTEXT_RE = /\b(?:show|view|see|check|inspect|display|list|log)\b.{0,30}\bcommits?\b|\b(?:last|latest|recent|previous|prior|earliest|newest|oldest)\s+commits?\b|\bcommit\s+(?:history|log|message|hash|id|sha|diff)\b/i;
+/**
+ * Sequential workflow signal: two named actions chained together.
+ * Matches "and then <verb>", common two-step chains (build+deploy, test+commit, etc.).
+ */
+const SEQUENTIAL_SIGNAL_RE = /\b(?:and\s+then|then\s+(?:commit|deploy|push|build|test)|(?:build|test|run|compile|check|verify|clean|lint)\s+and\s+(?:then\s+)?(?:commit|deploy|push|build|test|clean|remove|delete))\b/i;
+export const workflowIntentInterpreter = {
+    id: "workflow_intent",
+    priority: 5,
+    matches(input) {
+        const hasSequential = SEQUENTIAL_SIGNAL_RE.test(input);
+        if (hasSequential)
+            return true;
+        // Suppress commit match when "commit" is in a noun-reference context
+        const hasCommit = COMMIT_SIGNAL_RE.test(input) && !COMMIT_NOUN_CONTEXT_RE.test(input);
+        return hasCommit;
+    },
+    interpret(input) {
+        const basis = [];
+        const sequentialMatch = SEQUENTIAL_SIGNAL_RE.exec(input);
+        if (sequentialMatch !== null) {
+            basis.push(`matched sequential workflow pattern: ${sequentialMatch[0].trim()}`);
+        }
+        // Only add commit basis when not in noun-reference context
+        if (!COMMIT_NOUN_CONTEXT_RE.test(input)) {
+            const commitMatch = COMMIT_SIGNAL_RE.exec(input);
+            if (commitMatch !== null) {
+                basis.push(`matched commit signal: ${commitMatch[1]}`);
+            }
+        }
+        if (basis.length === 0)
+            return null;
+        return {
+            category: "workflow_operation",
+            summary: "This appears to be a development workflow request.",
+            confidence: "medium",
+            basis,
+        };
+    },
+};
+//# sourceMappingURL=workflow-intent.interpreter.js.map

package/dist/src/understand/intent-interpretation/interpreters/workflow-intent.interpreter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-intent.interpreter.js","sourceRoot":"","sources":["../../../../../src/understand/intent-interpretation/interpreters/workflow-intent.interpreter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAIH;;;;;;;;GAQG;AACH,MAAM,gBAAgB,GACpB,qDAAqD,CAAC;AAExD;;;;;GAKG;AACH,MAAM,sBAAsB,GAC1B,4MAA4M,CAAC;AAE/M;;;GAGG;AACH,MAAM,oBAAoB,GACxB,2LAA2L,CAAC;AAE9L,MAAM,CAAC,MAAM,yBAAyB,GAAsB;IAC1D,EAAE,EAAE,iBAAiB;IACrB,QAAQ,EAAE,CAAC;IAEX,OAAO,CAAC,KAAK;QACX,MAAM,aAAa,GAAG,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvD,IAAI,aAAa;YAAE,OAAO,IAAI,CAAC;QAC/B,qEAAqE;QACrE,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtF,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,SAAS,CAAC,KAAK;QACb,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,MAAM,eAAe,GAAG,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzD,IAAI,eAAe,KAAK,IAAI,EAAE,CAAC;YAC7B,KAAK,CAAC,IAAI,CAAC,wCAAwC,eAAe,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAClF,CAAC;QAED,2DAA2D;QAC3D,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACxC,MAAM,WAAW,GAAG,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACjD,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;gBACzB,KAAK,CAAC,IAAI,CAAC,0BAA0B,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACzD,CAAC;QACH,CAAC;QAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAEpC,OAAO;YACL,QAAQ,EAAI,oBAAoB;YAChC,OAAO,EAAK,oDAAoD;YAChE,UAAU,EAAE,QAAQ;YACpB,KAAK;SACN,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/src/understand/intent-interpretation/registry.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Intent Interpretation Bridge — interpreter registry.
+ *
+ * This file owns the ordered list of IntentInterpreter instances.
+ * Orchestration logic lives in intent-interpretation.ts.
+ *
+ * Priority ordering is enforced here at compile time via the sort.
+ * Lower priority number = runs first.
+ *
+ * v1 registry:
+ *    5 — workflow  (commit verbs + sequential patterns; wins before config/color/text)
+ *   10 — config    (strong config verbs win over color words)
+ *   20 — color     (named colors + UI target terms)
+ *   30 — text      (text-change verb AND text target, both required)
+ */
+import type { IntentInterpreter } from "./types.js";
+export declare const ALL_INTENT_INTERPRETERS: ReadonlyArray<IntentInterpreter>;
+//# sourceMappingURL=registry.d.ts.map

package/dist/src/understand/intent-interpretation/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../src/understand/intent-interpretation/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAMpD,eAAO,MAAM,uBAAuB,EAAE,aAAa,CAAC,iBAAiB,CAK5B,CAAC"}

package/dist/src/understand/intent-interpretation/registry.js

@@ -0,0 +1,26 @@
+/**
+ * Intent Interpretation Bridge — interpreter registry.
+ *
+ * This file owns the ordered list of IntentInterpreter instances.
+ * Orchestration logic lives in intent-interpretation.ts.
+ *
+ * Priority ordering is enforced here at compile time via the sort.
+ * Lower priority number = runs first.
+ *
+ * v1 registry:
+ *    5 — workflow  (commit verbs + sequential patterns; wins before config/color/text)
+ *   10 — config    (strong config verbs win over color words)
+ *   20 — color     (named colors + UI target terms)
+ *   30 — text      (text-change verb AND text target, both required)
+ */
+import { workflowIntentInterpreter } from "./interpreters/workflow-intent.interpreter.js";
+import { configIntentInterpreter } from "./interpreters/config-intent.interpreter.js";
+import { colorIntentInterpreter } from "./interpreters/color-intent.interpreter.js";
+import { textIntentInterpreter } from "./interpreters/text-intent.interpreter.js";
+export const ALL_INTENT_INTERPRETERS = [
+    workflowIntentInterpreter, // priority  5
+    configIntentInterpreter, // priority 10
+    colorIntentInterpreter, // priority 20
+    textIntentInterpreter, // priority 30
+].sort((a, b) => a.priority - b.priority);
+//# sourceMappingURL=registry.js.map

package/dist/src/understand/intent-interpretation/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../../src/understand/intent-interpretation/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAAE,yBAAyB,EAAE,MAAM,+CAA+C,CAAC;AAC1F,OAAO,EAAE,uBAAuB,EAAE,MAAQ,6CAA6C,CAAC;AACxF,OAAO,EAAE,sBAAsB,EAAE,MAAS,4CAA4C,CAAC;AACvF,OAAO,EAAE,qBAAqB,EAAE,MAAU,2CAA2C,CAAC;AAEtF,MAAM,CAAC,MAAM,uBAAuB,GAAqC;IACvE,yBAAyB,EAAE,cAAc;IACzC,uBAAuB,EAAI,cAAc;IACzC,sBAAsB,EAAK,cAAc;IACzC,qBAAqB,EAAM,cAAc;CAC1C,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC"}

package/dist/src/understand/intent-interpretation/types.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Intent Interpretation Bridge types.
+ *
+ * ── Two interpretation families ────────────────────────────────────────────────
+ *
+ *   Change Interpretation (src/understand/interpretation/)
+ *     → For executable, structured commands: replace "X" with "Y" in <file>
+ *     → Runs when mode === "execute"
+ *     → Describes what the change means after the fact
+ *
+ *   Intent Interpretation Bridge (this module)
+ *     → For vague, incomplete requests: "make the button blue"
+ *     → Runs when CompletionResult.kind === "guided_recovery"
+ *     → Describes what the user appears to be trying to do
+ *     → Improves guidance labels — never invents missing values
+ *
+ * ── Scope contract ─────────────────────────────────────────────────────────────
+ *
+ *   The bridge MAY:
+ *     - Classify broad intent category (visual_color, text_change, config_change, workflow_operation)
+ *     - Rewrite guidance labels in human language
+ *     - Add rationale to "read first" steps
+ *     - Record what signals triggered the classification (basis[])
+ *     - Run for both guided_recovery and incomplete completion results (both become guide mode)
+ *
+ *   The bridge MUST NOT:
+ *     - Guess file paths
+ *     - Guess current or new values
+ *     - Turn guided_recovery or incomplete into complete
+ *     - Downgrade safety
+ *     - Override mode
+ *
+ * ── GuidancePayload (home of record) ─────────────────────────────────────────
+ *
+ *   GuidancePayload lives here because it is enriched by this layer.
+ *   intake/types.ts re-imports it from here to avoid circular dependencies.
+ *   (understand → intake would be upward; this module is understand-level.)
+ */
+import type { CompletionNextStep } from "../completion/types.js";
+export type IntentInterpretationCategory = "visual_color" | "text_change" | "config_change" | "workflow_operation" | "unknown";
+export type IntentInterpretation = {
+    readonly category: IntentInterpretationCategory;
+    readonly summary: string;
+    readonly confidence: "high" | "medium" | "low";
+    /**
+     * Inspectable evidence: what signals triggered this classification.
+     * Examples: ["matched color word: blue", "ui target term: button"]
+     * Never empty when category !== "unknown".
+     */
+    readonly basis: readonly string[];
+};
+/**
+ * GuidancePayload — the structured next-step payload for guide mode.
+ *
+ * When the bridge runs, it may attach an IntentInterpretation and rewrite
+ * nextSteps labels to be context-aware. It never fills in missing values.
+ *
+ * CONTRACT: interpretation is present only when category !== "unknown".
+ */
+export type GuidancePayload = {
+    readonly missing: readonly string[];
+    readonly nextSteps: readonly CompletionNextStep[];
+    readonly interpretation?: IntentInterpretation;
+};
+/**
+ * An IntentInterpreter classifies a user's vague input into a broad intent
+ * category and provides human-readable classification evidence.
+ *
+ * Rules:
+ *   - Must be deterministic (same input → same output, always)
+ *   - Must return null if input is outside its scope
+ *   - Must populate basis[] with specific matched evidence
+ *   - Must never infer values not present in the input text
+ *
+ * Priority: lower number = runs first.
+ */
+export type IntentInterpreter = {
+    readonly id: string;
+    readonly priority: number;
+    matches(input: string): boolean;
+    interpret(input: string): IntentInterpretation | null;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/src/understand/intent-interpretation/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/understand/intent-interpretation/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,MAAM,MAAM,4BAA4B,GACpC,cAAc,GACd,aAAa,GACb,eAAe,GACf,oBAAoB,GACpB,SAAS,CAAC;AAEd,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,QAAQ,EAAE,4BAA4B,CAAC;IAChD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IAC/C;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAClD,QAAQ,CAAC,cAAc,CAAC,EAAE,oBAAoB,CAAC;CAChD,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAChC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI,CAAC;CACvD,CAAC"}

package/dist/src/understand/intent-interpretation/types.js

@@ -0,0 +1,40 @@
+/**
+ * Intent Interpretation Bridge types.
+ *
+ * ── Two interpretation families ────────────────────────────────────────────────
+ *
+ *   Change Interpretation (src/understand/interpretation/)
+ *     → For executable, structured commands: replace "X" with "Y" in <file>
+ *     → Runs when mode === "execute"
+ *     → Describes what the change means after the fact
+ *
+ *   Intent Interpretation Bridge (this module)
+ *     → For vague, incomplete requests: "make the button blue"
+ *     → Runs when CompletionResult.kind === "guided_recovery"
+ *     → Describes what the user appears to be trying to do
+ *     → Improves guidance labels — never invents missing values
+ *
+ * ── Scope contract ─────────────────────────────────────────────────────────────
+ *
+ *   The bridge MAY:
+ *     - Classify broad intent category (visual_color, text_change, config_change, workflow_operation)
+ *     - Rewrite guidance labels in human language
+ *     - Add rationale to "read first" steps
+ *     - Record what signals triggered the classification (basis[])
+ *     - Run for both guided_recovery and incomplete completion results (both become guide mode)
+ *
+ *   The bridge MUST NOT:
+ *     - Guess file paths
+ *     - Guess current or new values
+ *     - Turn guided_recovery or incomplete into complete
+ *     - Downgrade safety
+ *     - Override mode
+ *
+ * ── GuidancePayload (home of record) ─────────────────────────────────────────
+ *
+ *   GuidancePayload lives here because it is enriched by this layer.
+ *   intake/types.ts re-imports it from here to avoid circular dependencies.
+ *   (understand → intake would be upward; this module is understand-level.)
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/understand/intent-interpretation/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/understand/intent-interpretation/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG"}