usesteady 0.1.0-alpha.1

package/dist/src/understand/interpretation/parser.js

@@ -0,0 +1,88 @@
+/**
+ * Change command parser.
+ *
+ * Supported formats — text replacement:
+ *   replace "X" with "Y" in <file>
+ *   patch <file> search="X" replace="Y"
+ *
+ * Supported formats — filesystem operations:
+ *   create (folder|directory) <path>
+ *   create file <path>
+ *   rename <path> to <newPath>
+ *   (delete|remove) (file|folder|directory)? <path>
+ *
+ * Returns null for any other input shape.
+ */
+import { normalizeIntent, intentToChange } from "./intent.js";
+// ─── Text replacement patterns ────────────────────────────────────────────────
+const REPLACE_PATTERN = /^\s*replace\s+"([^"]+)"\s+with\s+"([^"]+)"\s+in\s+(\S+)/i;
+const PATCH_PATTERN = /^\s*patch\s+(\S+)\s+search="([^"]+)"\s+replace="([^"]+)"/i;
+// ─── Filesystem operation patterns ───────────────────────────────────────────
+// create (folder|directory) <path>
+const CREATE_DIR_PATTERN = /^\s*create\s+(?:folder|directory)\s+(\S+)/i;
+// create file <path>
+const CREATE_FILE_PATTERN = /^\s*create\s+file\s+(\S+)/i;
+// rename <path> to <newPath>
+const RENAME_PATTERN = /^\s*rename\s+(\S+)\s+to\s+(\S+)/i;
+// (delete|remove) file|folder|directory <path>  — explicit keyword, any path token
+const DELETE_WITH_KEYWORD_PATTERN = /^\s*(?:delete|remove)\s+(?:file|folder|directory)\s+(\S+)/i;
+// (delete|remove) <path>  — bare path must contain a slash or extension
+// Intentionally rejects bare nouns ("delete cache", "delete everything")
+// to match the normalizer's looksLikePath constraint.
+const DELETE_BARE_PATTERN = /^\s*(?:delete|remove)\s+((?:\S+\/\S+|\S+\.\S+))/i;
+// ─── Parser ───────────────────────────────────────────────────────────────────
+export function parseChange(input) {
+    // ── 1. Deterministic NL normalization (handles natural-language variants) ──
+    // This runs before strict patterns so "create a test folder" and
+    // "make a folder called components" are recognized without silent skip.
+    const intent = normalizeIntent(input.trim());
+    if (intent !== null)
+        return intentToChange(intent);
+    // ── 2. Strict patterns (canonical exact-match formats) ────────────────────
+    // Text replacement (existing)
+    const replaceMatch = REPLACE_PATTERN.exec(input);
+    if (replaceMatch !== null) {
+        const fp = replaceMatch[3];
+        return {
+            oldValue: replaceMatch[1],
+            newValue: replaceMatch[2],
+            ...(fp !== undefined ? { filePath: fp } : {}),
+        };
+    }
+    const patchMatch = PATCH_PATTERN.exec(input);
+    if (patchMatch !== null) {
+        const fp = patchMatch[1];
+        return {
+            oldValue: patchMatch[2],
+            newValue: patchMatch[3],
+            ...(fp !== undefined ? { filePath: fp } : {}),
+        };
+    }
+    // Filesystem operations (new)
+    const createDirMatch = CREATE_DIR_PATTERN.exec(input);
+    if (createDirMatch !== null) {
+        return { operationType: "create_dir", dirPath: createDirMatch[1] };
+    }
+    const createFileMatch = CREATE_FILE_PATTERN.exec(input);
+    if (createFileMatch !== null) {
+        return { operationType: "write_file", filePath: createFileMatch[1], content: "" };
+    }
+    const renameMatch = RENAME_PATTERN.exec(input);
+    if (renameMatch !== null) {
+        return { operationType: "rename", filePath: renameMatch[1], newPath: renameMatch[2] };
+    }
+    const deleteKwMatch = DELETE_WITH_KEYWORD_PATTERN.exec(input);
+    if (deleteKwMatch !== null) {
+        return { operationType: "delete_file", filePath: deleteKwMatch[1] };
+    }
+    const deleteBareMatch = DELETE_BARE_PATTERN.exec(input);
+    if (deleteBareMatch !== null) {
+        return { operationType: "delete_file", filePath: deleteBareMatch[1] };
+    }
+    return null;
+}
+/** Extract the filename from a path without importing node:path. */
+export function basename(filePath) {
+    return filePath.split(/[/\\]/).pop() ?? filePath;
+}
+//# sourceMappingURL=parser.js.map

package/dist/src/understand/interpretation/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../../../src/understand/interpretation/parser.ts"],"names":[],"mappings":"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"}

package/dist/src/understand/interpretation/rules.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Interpretation rules — v1.
+ *
+ * Three categories are implemented:
+ *   1. Tailwind color change  (priority 10) — most specific, deterministic
+ *   2. CSS color change       (priority 20) — hex / rgb / hsl / CSS property
+ *   3. Config value change    (priority 30) — config files or value patterns
+ *   4. Text literal change    (priority 40) — human-readable UI copy
+ *
+ * Priority order matters: a Tailwind class could also look like a text literal
+ * if rule ordering were reversed. The most specific rule must run first.
+ */
+import type { InterpretationRule } from "./types.js";
+export declare const tailwindColorRule: InterpretationRule;
+export declare const cssColorRule: InterpretationRule;
+export declare const configValueRule: InterpretationRule;
+export declare const textLiteralRule: InterpretationRule;
+export declare const ALL_INTERPRETATION_RULES: ReadonlyArray<InterpretationRule>;
+//# sourceMappingURL=rules.d.ts.map

package/dist/src/understand/interpretation/rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../../../src/understand/interpretation/rules.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAwB,kBAAkB,EAAiB,MAAM,YAAY,CAAC;AA0H1F,eAAO,MAAM,iBAAiB,EAAE,kBAgC/B,CAAC;AAOF,eAAO,MAAM,YAAY,EAAE,kBA6B1B,CAAC;AAIF,eAAO,MAAM,eAAe,EAAE,kBAyC7B,CAAC;AAIF,eAAO,MAAM,eAAe,EAAE,kBAwB7B,CAAC;AAIF,eAAO,MAAM,wBAAwB,EAAE,aAAa,CAAC,kBAAkB,CAK9B,CAAC"}

package/dist/src/understand/interpretation/rules.js

@@ -0,0 +1,222 @@
+/**
+ * Interpretation rules — v1.
+ *
+ * Three categories are implemented:
+ *   1. Tailwind color change  (priority 10) — most specific, deterministic
+ *   2. CSS color change       (priority 20) — hex / rgb / hsl / CSS property
+ *   3. Config value change    (priority 30) — config files or value patterns
+ *   4. Text literal change    (priority 40) — human-readable UI copy
+ *
+ * Priority order matters: a Tailwind class could also look like a text literal
+ * if rule ordering were reversed. The most specific rule must run first.
+ */
+import { basename } from "./parser.js";
+// ─── Utilities ────────────────────────────────────────────────────────────────
+const TAILWIND_COLOR_NAMES = "slate|gray|zinc|neutral|stone|red|orange|amber|yellow|lime|green|emerald|" +
+    "teal|cyan|sky|blue|indigo|violet|purple|fuchsia|pink|rose|white|black|" +
+    "transparent|current|inherit";
+const TAILWIND_PREFIXES = "bg|text|border|ring|from|to|via|fill|stroke|shadow|outline|caret|accent";
+const TAILWIND_COLOR_RE = new RegExp(`\\b(?:${TAILWIND_PREFIXES})-(?:${TAILWIND_COLOR_NAMES})(?:-\\d+)?\\b`, "i");
+const TAILWIND_PREFIX_LABELS = {
+    bg: "background color",
+    text: "text color",
+    border: "border color",
+    ring: "ring / focus color",
+    from: "gradient start color",
+    to: "gradient end color",
+    via: "gradient midpoint color",
+    fill: "fill color",
+    stroke: "stroke color",
+    shadow: "shadow color",
+    outline: "outline color",
+    caret: "caret color",
+    accent: "accent color",
+};
+function tailwindColorClass(value) {
+    return TAILWIND_COLOR_RE.exec(value)?.[0] ?? null;
+}
+function tailwindPrefix(cls) {
+    const prefix = /^([a-z]+)-/i.exec(cls)?.[1]?.toLowerCase();
+    return prefix !== undefined
+        ? (TAILWIND_PREFIX_LABELS[prefix] ?? "color")
+        : "color";
+}
+// CSS color patterns
+const CSS_COLOR_VALUE_RE = /#[0-9a-fA-F]{3,8}\b|rgb\s*\(|rgba\s*\(|hsl\s*\(|hsla\s*\(/i;
+const CSS_NAMED_COLOR_RE = /\b(?:red|blue|green|yellow|white|black|orange|purple|pink|gray|grey|cyan|magenta|lime|coral|teal|navy|maroon|olive|silver|gold)\b/i;
+const CSS_PROPERTY_RE = /\b(?:color|background-color|background|border-color|fill|stroke)\s*:/i;
+const CSS_FILE_RE = /\.(css|scss|sass|less|styl)$/i;
+function isCssColor(value) {
+    return (CSS_COLOR_VALUE_RE.test(value) ||
+        CSS_NAMED_COLOR_RE.test(value) ||
+        CSS_PROPERTY_RE.test(value));
+}
+// Config file / value patterns
+const CONFIG_FILE_RE = /\.(json|yaml|yml|toml|env|ini|properties|conf|config)$/i;
+const CONFIG_FILE_NAME_RE = /(?:config|settings|env|rc)\.[a-z]+$/i;
+const CONFIG_VALUE_RE = /^\d+$|^https?:\/\/|^(true|false)$/i;
+function isConfigFile(filePath) {
+    if (filePath === undefined)
+        return false;
+    return CONFIG_FILE_RE.test(filePath) || CONFIG_FILE_NAME_RE.test(filePath);
+}
+function isConfigValue(value) {
+    return CONFIG_VALUE_RE.test(value);
+}
+// Text literal heuristic
+const TEXT_LITERAL_RE = /^[a-zA-Z][a-zA-Z0-9\s.,!?:;'\-/()\[\]]*$/;
+const CODE_NOISE_RE = /[{}<>@#$%^&*=_\\|`~]/;
+// Matches all-lowercase single tokens — utility classes, state names, event names,
+// design tokens, CSS property identifiers. These are code, not human UI copy.
+// Examples: flex, block, hidden, submit, disabled, primary, error, bg-cover, text-sm
+const LOWERCASE_TOKEN_RE = /^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/;
+// Tailwind/CSS fraction utilities: w-1/2, h-2/3, inset-1/2
+// The "/" between numbers is a strong code token indicator.
+const CSS_FRACTION_RE = /^[a-z-]*\d+\/\d+$/i;
+// CSS property declarations: "margin: 16px", "font-size: 14px", "z-index: 10"
+// A word (possibly hyphenated) followed by a colon is a CSS property, not UI text.
+const CSS_PROPERTY_DECL_RE = /^[a-z][a-z-]*\s*:/i;
+function isTextLiteral(value) {
+    if (!TEXT_LITERAL_RE.test(value))
+        return false;
+    if (CODE_NOISE_RE.test(value))
+        return false;
+    if (value.length < 2 || value.length > 120)
+        return false;
+    // Exclude lowercase-only tokens — code identifiers, not human UI copy.
+    // Text literals must either start uppercase OR be multi-word phrases.
+    if (LOWERCASE_TOKEN_RE.test(value))
+        return false;
+    // Exclude Tailwind/CSS fractional utilities like w-1/2, h-2/3.
+    if (CSS_FRACTION_RE.test(value))
+        return false;
+    // Exclude CSS property declarations like "margin: 16px", "font-size: 14px".
+    if (CSS_PROPERTY_DECL_RE.test(value))
+        return false;
+    return true;
+}
+// ─── Rule 1: Tailwind color change ────────────────────────────────────────────
+export const tailwindColorRule = {
+    id: "tailwind_color_change",
+    priority: 10,
+    matches(parsed) {
+        return (tailwindColorClass(parsed.oldValue) !== null ||
+            tailwindColorClass(parsed.newValue) !== null);
+    },
+    interpret(parsed) {
+        const oldCls = tailwindColorClass(parsed.oldValue);
+        const newCls = tailwindColorClass(parsed.newValue);
+        if (oldCls === null && newCls === null)
+            return null;
+        const property = tailwindPrefix(oldCls ?? newCls ?? "");
+        const fileLabel = parsed.filePath !== undefined
+            ? ` in ${basename(parsed.filePath)}`
+            : "";
+        return {
+            category: "tailwind_color_change",
+            summary: `Changes ${property} from '${parsed.oldValue}' to '${parsed.newValue}'${fileLabel}.`,
+            impact: [
+                "Visual change only — no logic, data, or behavior impact.",
+                `Affects rendered ${property}.`,
+                "Verify in browser after applying.",
+            ],
+            confidence: "high",
+        };
+    },
+};
+// ─── Rule 2: CSS color change ─────────────────────────────────────────────────
+// NOTE: File extension alone is NOT sufficient — .css files contain many non-color
+// properties (width, margin, font-size, z-index, etc.). We only fire when the
+// old or new value actually contains color-indicating content.
+export const cssColorRule = {
+    id: "css_color_change",
+    priority: 20,
+    matches(parsed) {
+        return isCssColor(parsed.oldValue) || isCssColor(parsed.newValue);
+    },
+    interpret(parsed) {
+        // Determine confidence: high if CSS property declaration is present,
+        // medium if only a color value or file-extension match.
+        const hasPropertyDecl = CSS_PROPERTY_RE.test(parsed.oldValue) ||
+            CSS_PROPERTY_RE.test(parsed.newValue);
+        const fileLabel = parsed.filePath !== undefined
+            ? ` in ${basename(parsed.filePath)}`
+            : "";
+        return {
+            category: "css_color_change",
+            summary: `Changes CSS color value from '${parsed.oldValue}' to '${parsed.newValue}'${fileLabel}.`,
+            impact: [
+                "Visual change only — no logic, data, or behavior impact.",
+                "Verify rendered result in browser after applying.",
+            ],
+            confidence: hasPropertyDecl ? "high" : "medium",
+        };
+    },
+};
+// ─── Rule 3: Config value change ──────────────────────────────────────────────
+export const configValueRule = {
+    id: "config_value_change",
+    priority: 30,
+    matches(parsed) {
+        return (isConfigFile(parsed.filePath) ||
+            (isConfigValue(parsed.oldValue) && isConfigValue(parsed.newValue)));
+    },
+    interpret(parsed) {
+        const fileLabel = parsed.filePath !== undefined
+            ? ` in ${basename(parsed.filePath)}`
+            : "";
+        // Produce tailored impact hints for known value shapes.
+        const impact = [
+            `Configuration change: '${parsed.oldValue}' → '${parsed.newValue}'.`,
+        ];
+        if (/^\d+$/.test(parsed.oldValue) && /^\d+$/.test(parsed.newValue)) {
+            // "may affect port, timeout, or limit" removed — too speculative without key context
+            impact.push("Numeric value change — verify all usages of this value have been updated.");
+        }
+        else if (/^https?:\/\//.test(parsed.oldValue) ||
+            /^https?:\/\//.test(parsed.newValue)) {
+            // "endpoint" removed — implies API server without proof
+            impact.push("URL value change — verify the new address is correct and reachable.");
+        }
+        else if (/^(true|false)$/i.test(parsed.oldValue)) {
+            impact.push("Boolean flag change — may toggle a feature or mode.");
+        }
+        return {
+            category: "config_value_change",
+            summary: `Changes configuration value from '${parsed.oldValue}' to '${parsed.newValue}'${fileLabel}.`,
+            impact,
+            confidence: isConfigFile(parsed.filePath) ? "high" : "medium",
+        };
+    },
+};
+// ─── Rule 4: Text literal change ──────────────────────────────────────────────
+export const textLiteralRule = {
+    id: "text_literal_change",
+    priority: 40,
+    matches(parsed) {
+        return isTextLiteral(parsed.oldValue) || isTextLiteral(parsed.newValue);
+    },
+    interpret(parsed) {
+        const fileLabel = parsed.filePath !== undefined
+            ? ` in ${basename(parsed.filePath)}`
+            : "";
+        return {
+            category: "text_literal_change",
+            summary: `Changes text '${parsed.oldValue}' to '${parsed.newValue}'${fileLabel}.`,
+            impact: [
+                "User-visible text change.",
+                "No logic, data, or behavior impact.",
+                "Review for consistency with other UI copy if this label appears elsewhere.",
+            ],
+            confidence: "medium",
+        };
+    },
+};
+// ─── Ordered registry ─────────────────────────────────────────────────────────
+export const ALL_INTERPRETATION_RULES = [
+    tailwindColorRule,
+    cssColorRule,
+    configValueRule,
+    textLiteralRule,
+].sort((a, b) => a.priority - b.priority);
+//# sourceMappingURL=rules.js.map

package/dist/src/understand/interpretation/rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.js","sourceRoot":"","sources":["../../../../src/understand/interpretation/rules.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,90 @@
+/**
+ * Change Interpretation types.
+ *
+ * ── Scope (v1) ────────────────────────────────────────────────────────────────
+ *   1. Tailwind / CSS color changes
+ *   2. Text literal changes (button labels, headings, UI copy)
+ *   3. Simple config value changes (port, URL, boolean, key-value)
+ *
+ * ── Role of interpretation ────────────────────────────────────────────────────
+ *   Interpretation is ADVISORY.
+ *   It does not change the execute/guide/refuse decision — that is locked
+ *   before interpretation runs.
+ *   It describes WHAT the human will experience from the change, not WHETHER
+ *   the change is allowed.
+ *
+ * ── ParsedChange ──────────────────────────────────────────────────────────────
+ *   All interpretation operates on a parsed representation of a structured
+ *   change command (replace "X" with "Y" in file, or patch file search="X" replace="Y").
+ *   Interpretation returns null for any input that cannot be parsed into this form.
+ *
+ * ── InterpretationRule ────────────────────────────────────────────────────────
+ *   Registry-driven, priority-ordered, deterministic.
+ *   Same shape as Safety and Completion rules — ownership, priority, traceability.
+ */
+export type InterpretationCategory = "tailwind_color_change" | "css_color_change" | "text_literal_change" | "config_value_change";
+export type InterpretationResult = {
+    readonly summary: string;
+    readonly impact: readonly string[];
+    readonly confidence: "high" | "medium" | "low";
+    readonly category: InterpretationCategory;
+};
+/**
+ * Parsed representation of a text replacement command.
+ * Both `replace "X" with "Y" in <file>` and `patch <file> search="X" replace="Y"`
+ * reduce to this shape.
+ */
+export type ReplaceChange = {
+    readonly oldValue: string;
+    readonly newValue: string;
+    readonly filePath?: string;
+};
+/**
+ * Filesystem operation — deterministic primitives that bypass the intake pipeline.
+ *
+ * These are explicit operations with no ambiguity — the user states exactly what
+ * to do. They do not go through safety/completeness intake; they go straight to
+ * human approval and then execution.
+ */
+export type FsChange = {
+    readonly operationType: "create_dir";
+    readonly dirPath: string;
+} | {
+    readonly operationType: "write_file";
+    readonly filePath: string;
+    readonly content: string;
+} | {
+    readonly operationType: "rename";
+    readonly filePath: string;
+    readonly newPath: string;
+} | {
+    readonly operationType: "delete_file";
+    readonly filePath: string;
+};
+/**
+ * Parsed representation of any structured command — replacement or filesystem op.
+ */
+export type ParsedChange = ReplaceChange | FsChange;
+/** Type guard: true when pc is a filesystem operation (not a text replacement). */
+export declare function isFsChange(pc: ParsedChange): pc is FsChange;
+/**
+ * An InterpretationRule classifies a ReplaceChange into a category and produces
+ * a human-readable description.
+ *
+ * Rules MUST:
+ *   - Be deterministic (same parsed input → same output)
+ *   - Return null if the change is outside their scope
+ *   - Never infer intent beyond what the old/new values demonstrate
+ *
+ * Priority: lower number = runs first.
+ *
+ * Note: rules only apply to ReplaceChange. FsChange operations have no
+ * interpretation rules — their intent is fully explicit in the operation type.
+ */
+export type InterpretationRule = {
+    readonly id: string;
+    readonly priority: number;
+    matches(parsed: ReplaceChange): boolean;
+    interpret(parsed: ReplaceChange): InterpretationResult | null;
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/understand/interpretation/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,MAAM,MAAM,sBAAsB,GAC9B,uBAAuB,GACvB,kBAAkB,GAClB,qBAAqB,GACrB,qBAAqB,CAAC;AAE1B,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IAC/C,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC;CAC3C,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,QAAQ,GAChB;IAAE,QAAQ,CAAC,aAAa,EAAE,YAAY,CAAC;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACnE;IAAE,QAAQ,CAAC,aAAa,EAAE,YAAY,CAAC;IAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC9F;IAAE,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC;IAAM,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC9F;IAAE,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzE;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,aAAa,GAAG,QAAQ,CAAC;AAEpD,mFAAmF;AACnF,wBAAgB,UAAU,CAAC,EAAE,EAAE,YAAY,GAAG,EAAE,IAAI,QAAQ,CAE3D;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC;IACxC,SAAS,CAAC,MAAM,EAAE,aAAa,GAAG,oBAAoB,GAAG,IAAI,CAAC;CAC/D,CAAC"}

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

@@ -0,0 +1,29 @@
+/**
+ * Change Interpretation types.
+ *
+ * ── Scope (v1) ────────────────────────────────────────────────────────────────
+ *   1. Tailwind / CSS color changes
+ *   2. Text literal changes (button labels, headings, UI copy)
+ *   3. Simple config value changes (port, URL, boolean, key-value)
+ *
+ * ── Role of interpretation ────────────────────────────────────────────────────
+ *   Interpretation is ADVISORY.
+ *   It does not change the execute/guide/refuse decision — that is locked
+ *   before interpretation runs.
+ *   It describes WHAT the human will experience from the change, not WHETHER
+ *   the change is allowed.
+ *
+ * ── ParsedChange ──────────────────────────────────────────────────────────────
+ *   All interpretation operates on a parsed representation of a structured
+ *   change command (replace "X" with "Y" in file, or patch file search="X" replace="Y").
+ *   Interpretation returns null for any input that cannot be parsed into this form.
+ *
+ * ── InterpretationRule ────────────────────────────────────────────────────────
+ *   Registry-driven, priority-ordered, deterministic.
+ *   Same shape as Safety and Completion rules — ownership, priority, traceability.
+ */
+/** Type guard: true when pc is a filesystem operation (not a text replacement). */
+export function isFsChange(pc) {
+    return "operationType" in pc;
+}
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/understand/interpretation/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AA4CH,mFAAmF;AACnF,MAAM,UAAU,UAAU,CAAC,EAAgB;IACzC,OAAO,eAAe,IAAI,EAAE,CAAC;AAC/B,CAAC"}

package/dist/src/understand/shared/types.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Shared types for the Understand layer.
+ *
+ * The Understand layer is ADVISORY, not authoritative.
+ * It reports on what it observes; it does not decide what happens.
+ * The Response Planner makes all decisions.
+ */
+export type UnderstandContext = {
+    readonly hasPriorSession: boolean;
+    readonly lastInput?: string;
+    readonly lastResult?: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/src/understand/shared/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/understand/shared/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B,CAAC"}

package/dist/src/understand/shared/types.js

@@ -0,0 +1,9 @@
+/**
+ * Shared types for the Understand layer.
+ *
+ * The Understand layer is ADVISORY, not authoritative.
+ * It reports on what it observes; it does not decide what happens.
+ * The Response Planner makes all decisions.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/understand/shared/types.js.map

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

package/dist/src/understand/silent-guidance/index.d.ts

@@ -0,0 +1,4 @@
+export type { SilentGuidanceMode } from "./types.js";
+export { selectSilentGuidanceMode } from "./selector.js";
+export { getSilentGuidanceSteps } from "./templates.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/understand/silent-guidance/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/understand/silent-guidance/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,wBAAwB,EAAE,MAAO,eAAe,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAS,gBAAgB,CAAC"}

package/dist/src/understand/silent-guidance/index.js

@@ -0,0 +1,3 @@
+export { selectSilentGuidanceMode } from "./selector.js";
+export { getSilentGuidanceSteps } from "./templates.js";
+//# sourceMappingURL=index.js.map

package/dist/src/understand/silent-guidance/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/understand/silent-guidance/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,MAAO,eAAe,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAS,gBAAgB,CAAC"}

package/dist/src/understand/silent-guidance/selector.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Silent Guidance Mode Selector.
+ *
+ * Inspects the raw input for shape-level signals and returns the most
+ * appropriate guidance template mode.
+ *
+ * ── Contracts ────────────────────────────────────────────────────────────────
+ *
+ *   1. Only called when bridgeSilenceReason === "no_interpreter_claimed".
+ *   2. Deterministic: same input → same mode, always.
+ *   3. Returns a mode — never null. "unknown" is the safe fallback.
+ *   4. Does NOT classify intent. Does NOT produce category/confidence.
+ *   5. Does NOT guess tools, services, file paths, or values.
+ *   6. Does NOT affect mode, signal, intentState, or any decision.
+ *   7. Regex match priority: investigation → operation → content_iteration → unknown.
+ *      First match wins. This ordering prevents cross-domain false positives.
+ *
+ * ── Pattern philosophy ────────────────────────────────────────────────────────
+ *
+ *   Patterns are narrow, not broad.  Better to fall through to "unknown"
+ *   (which still shows improved guidance over the old code-patch default)
+ *   than to claim a mode incorrectly.
+ *
+ *   Each pattern targets high-signal, low-ambiguity tokens:
+ *   - "debug" is always QA; "deploy" is always ops; "tagline" is always content.
+ *   - Ambiguous terms like "improve", "fix", "check" are deliberately excluded
+ *     unless combined with a domain-specific qualifier.
+ */
+import type { SilentGuidanceMode } from "./types.js";
+/**
+ * Select the appropriate silent guidance template mode for a bridge-silent flow.
+ *
+ * Priority (first match wins):
+ *   1. investigation    — QA / debugging signals
+ *   2. operation        — infra / schema / pipeline signals
+ *   3. content_iteration — copy / UX / product signals
+ *   4. unknown          — safe fallback (still better than code-patch default)
+ *
+ * "code_patch" is never returned here; it applies only when an interpreter
+ * already fired (bridgeFired === true), meaning the request is already
+ * enriched and needs no silent mode template.
+ */
+export declare function selectSilentGuidanceMode(input: string): SilentGuidanceMode;
+//# sourceMappingURL=selector.d.ts.map

package/dist/src/understand/silent-guidance/selector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selector.d.ts","sourceRoot":"","sources":["../../../../src/understand/silent-guidance/selector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAqHrD;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,CAK1E"}