usesteady 0.1.0-alpha.1

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

@@ -0,0 +1,72 @@
+/**
+ * Deterministic intent normalizer — P0 natural-language normalization.
+ *
+ * Combines broad natural-language verb coverage (create, mkdir, scaffold,
+ * spin up…) with a looksLikePath() safety gate that blocks ambiguous or
+ * nonsense captures before they reach the execution pipeline.
+ *
+ * Design decisions locked:
+ *   – No AI / model calls
+ *   – Class 1: leading polite-prefix stripping (please, can you, could you,
+ *     i need, i want to) — only the leading softener is removed, never
+ *     mid-sentence words
+ *   – Class 2: article/noise tolerance for rename ("the file X") and delete
+ *     ("the X folder") — surgical patterns, not general NL parsing
+ *   – Class 3 intentional gap: "make a folder for X" stays null — "for X"
+ *     is ambiguous (purpose vs. name) and belongs in a clarification card
+ *   – looksLikePath() gate: all NL-captured names must look like real paths
+ *   – extractPathFromTail() is intentionally absent from NL matchers;
+ *     only explicit CLI commands (mkdir, touch, mv, rm) are unguarded
+ *   – Reversed patterns ("create X folder") use looksLikePath; multi-word
+ *     captures like "some structure to the" are automatically rejected
+ *   – Broad delete matching restricted to tokens with extension or separator
+ *     (bare nouns require an explicit type keyword)
+ *   – If normalisation fails, caller falls through to strict parser
+ *   – No change to authority model or execution scope
+ */
+import type { ParsedChange } from "./types.js";
+export type ParsedIntent = {
+    readonly kind: "create_dir";
+    readonly path: string;
+} | {
+    readonly kind: "create_file";
+    readonly path: string;
+    readonly content?: string;
+} | {
+    readonly kind: "rename";
+    readonly from: string;
+    readonly to: string;
+} | {
+    readonly kind: "delete";
+    readonly path: string;
+} | {
+    readonly kind: "replace";
+    readonly find: string;
+    readonly replace: string;
+    readonly file: string;
+};
+/**
+ * Convert a free-form user string into a structured ParsedIntent.
+ *
+ * Returns null when:
+ *   - The input is empty or whitespace
+ *   - The input is ambiguous or vague (no recognised operation + valid path)
+ *   - A required field (path, from/to, etc.) cannot be determined safely
+ *
+ * On null the caller falls through to the strict canonical parser.
+ */
+export declare function normalizeIntent(raw: string): ParsedIntent | null;
+/**
+ * Convert a ParsedIntent into the canonical ParsedChange used by the execution
+ * pipeline (FsChange | ReplaceChange).
+ *
+ * This is the only bridge between the normalizer and the execution path.
+ * No new execution paths are introduced here.
+ */
+export declare function intentToChange(intent: ParsedIntent): ParsedChange;
+/**
+ * Human-readable "SYSTEM WILL:" description for a ParsedIntent.
+ * Used in the UI approval frame to surface normalised intent to the user.
+ */
+export declare function describeIntent(intent: ParsedIntent): string;
+//# sourceMappingURL=intent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"intent.d.ts","sourceRoot":"","sources":["../../../../src/understand/interpretation/intent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAA2B,MAAM,YAAY,CAAC;AAIxE,MAAM,MAAM,YAAY,GACpB;IAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACvD;IAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAClF;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC5E;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACvD;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAK,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AA+U7G;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAmBhE;AAID;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CAmCjE;AAID;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAQ3D"}

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

@@ -0,0 +1,414 @@
+/**
+ * Deterministic intent normalizer — P0 natural-language normalization.
+ *
+ * Combines broad natural-language verb coverage (create, mkdir, scaffold,
+ * spin up…) with a looksLikePath() safety gate that blocks ambiguous or
+ * nonsense captures before they reach the execution pipeline.
+ *
+ * Design decisions locked:
+ *   – No AI / model calls
+ *   – Class 1: leading polite-prefix stripping (please, can you, could you,
+ *     i need, i want to) — only the leading softener is removed, never
+ *     mid-sentence words
+ *   – Class 2: article/noise tolerance for rename ("the file X") and delete
+ *     ("the X folder") — surgical patterns, not general NL parsing
+ *   – Class 3 intentional gap: "make a folder for X" stays null — "for X"
+ *     is ambiguous (purpose vs. name) and belongs in a clarification card
+ *   – looksLikePath() gate: all NL-captured names must look like real paths
+ *   – extractPathFromTail() is intentionally absent from NL matchers;
+ *     only explicit CLI commands (mkdir, touch, mv, rm) are unguarded
+ *   – Reversed patterns ("create X folder") use looksLikePath; multi-word
+ *     captures like "some structure to the" are automatically rejected
+ *   – Broad delete matching restricted to tokens with extension or separator
+ *     (bare nouns require an explicit type keyword)
+ *   – If normalisation fails, caller falls through to strict parser
+ *   – No change to authority model or execution scope
+ */
+// ─── Path safety gate ─────────────────────────────────────────────────────────
+/**
+ * Returns true only when a captured string plausibly looks like a filesystem
+ * path.  This is the core guard that prevents ambiguous NL prose (e.g.
+ * "some structure to the") from being accepted as a directory name.
+ *
+ * Accepts:
+ *   clean identifier     "test", "components", "MyApp", "my-app"
+ *   path with slashes    "src/utils", "lib/auth/index"
+ *   name with extension  "README.md", "App.tsx", "config.json"
+ *   dotfile              ".gitignore", ".env"
+ *
+ * Rejects:
+ *   empty string, strings with spaces, strings that are pure prose
+ */
+function looksLikePath(s) {
+    if (!s || s.length === 0)
+        return false;
+    if (s.includes(" "))
+        return false;
+    if (/\.[a-zA-Z0-9]{1,10}$/.test(s))
+        return true; // has extension
+    if (s.includes("/") || s.includes("\\"))
+        return true; // path separator
+    if (/^[a-zA-Z0-9_\-.]+$/.test(s))
+        return true; // clean identifier
+    return false;
+}
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+/** Collapse internal whitespace and trim. */
+function collapseSpaces(s) {
+    return s.replace(/\s+/g, " ").trim();
+}
+/**
+ * Class 1 — Strip a single leading polite softener.
+ *
+ * Only the leading prefix is removed, never words mid-sentence.
+ * Supported prefixes: please, can you, could you, i need [to], i want to.
+ *
+ * Examples:
+ *   "please create folder utils"       → "create folder utils"
+ *   "can you create a folder called utils" → "create a folder called utils"
+ *   "i need a folder called auth"      → "a folder called auth"
+ *   "i want to rename old.ts to new.ts" → "rename old.ts to new.ts"
+ *   "i need to delete src/old.ts"      → "delete src/old.ts"
+ */
+const POLITE_PREFIX = /^(?:please\s+|can\s+you\s+|could\s+you\s+|i\s+need\s+(?:to\s+)?|i\s+want\s+to\s+)/i;
+function stripLeadingPrefix(s) {
+    return s.replace(POLITE_PREFIX, "").trimStart();
+}
+/**
+ * Extract the content of the first quoted segment (double, single, backtick).
+ * Allows quoted paths that contain spaces.
+ */
+function extractQuoted(input) {
+    const dq = /"([^"]+)"/.exec(input);
+    if (dq?.[1])
+        return dq[1].trim();
+    const sq = /'([^']+)'/.exec(input);
+    if (sq?.[1])
+        return sq[1].trim();
+    const bq = /`([^`]+)`/.exec(input);
+    if (bq?.[1])
+        return bq[1].trim();
+    return null;
+}
+/**
+ * Clean a raw capture-group value and apply looksLikePath.
+ *
+ * Order:
+ *  1. Try quoted extraction (allows space-containing paths)
+ *  2. Strip NL filler prefixes (called/named/as)
+ *  3. Apply looksLikePath gate — rejects multi-word prose, pure nouns, etc.
+ */
+function cleanPath(raw) {
+    if (!raw)
+        return null;
+    const trimmed = raw.trim();
+    if (!trimmed)
+        return null;
+    // Quoted paths bypass the looksLikePath check (user explicitly delimited them)
+    const quoted = extractQuoted(trimmed);
+    if (quoted && quoted.length > 0)
+        return quoted;
+    // Strip common filler prefixes before validating
+    const stripped = trimmed
+        .replace(/^(?:called|named|as)\s+/i, "")
+        .replace(/[.?!]+$/, "")
+        .trim();
+    if (!stripped)
+        return null;
+    return looksLikePath(stripped) ? stripped : null;
+}
+// ─── matchCreateDir ───────────────────────────────────────────────────────────
+// Forward: verb + [a] + dir-keyword + [called/named] + name
+// Covers: "create folder test", "initialize directory src/utils", "scaffold folder components"
+const CREATE_DIR_FORWARD = [
+    /^(?:create|make|add|new|init|initialize|scaffold|generate|setup)\s+(?:a\s+)?(?:folder|directory|dir)\s+(?:(?:called|named)\s+)?(?<p>.+)$/i,
+    // "a new" adjective form — "called/named" is REQUIRED after the keyword to prevent
+    // "initialize a new folder structure" from matching with path="structure"
+    /^(?:create|make|add|init|initialize|scaffold|generate|setup)\s+a\s+new\s+(?:folder|directory|dir)\s+(?:called|named)\s+(?<p>.+)$/i,
+    // "set up" and "spin up" contain a space — listed separately to avoid regex complexity
+    /^(?:set\s+up|spin\s+up)\s+(?:a\s+)?(?:folder|directory|dir)\s+(?:(?:called|named)\s+)?(?<p>.+)$/i,
+    // No-verb form — produced by polite-prefix stripping ("i need a folder called auth"
+    // → "a folder called auth").  "called/named" is REQUIRED; there is no action verb
+    // to act as an anchor so we need the strongest possible discriminator.
+    /^a[n]?\s+(?:new\s+)?(?:folder|directory|dir)\s+(?:called|named)\s+(?<p>.+)$/i,
+];
+// Reversed: verb + [a] + name + dir-keyword
+// Covers: "create a test folder", "make a components folder", "add utils directory"
+// Only the most natural-sounding verbs — not "scaffold a foo folder"
+const CREATE_DIR_REVERSED = [
+    /^(?:create|make|add)\s+(?:a\s+)?(?<p>.+?)\s+(?:folder|directory|dir)$/i,
+];
+function matchCreateDir(raw) {
+    // 1. CLI-native: mkdir <path>  (unguarded — user intentionally typed CLI syntax)
+    const mkdirM = /^mkdir\s+(?<p>.+)$/i.exec(raw);
+    if (mkdirM?.groups?.p) {
+        const p = mkdirM.groups.p.trim();
+        return p ? { kind: "create_dir", path: p } : null;
+    }
+    // 2. Forward: verb + keyword + name  (cleanPath applies looksLikePath gate)
+    for (const pat of CREATE_DIR_FORWARD) {
+        const m = pat.exec(raw);
+        if (m?.groups?.p) {
+            const path = cleanPath(m.groups.p);
+            if (path)
+                return { kind: "create_dir", path };
+        }
+    }
+    // 3. Reversed: verb + name + keyword
+    //    Multi-word captures like "some structure to the" fail looksLikePath ✓
+    for (const pat of CREATE_DIR_REVERSED) {
+        const m = pat.exec(raw);
+        if (m?.groups?.p) {
+            const path = cleanPath(m.groups.p);
+            if (path)
+                return { kind: "create_dir", path };
+        }
+    }
+    return null;
+}
+// ─── matchCreateFile ──────────────────────────────────────────────────────────
+// [a] + [new/empty/blank] adjective slot — "create a new file", "make an empty file called x"
+const CREATE_FILE_FORWARD = [
+    /^(?:create|make|add|new|write)\s+(?:a[n]?\s+)?(?:new|empty|blank)?\s*file\s+(?:(?:called|named)\s+)?(?<p>.+)$/i,
+    // No-verb form — produced by polite-prefix stripping ("i need a file called X")
+    // "called/named" is REQUIRED as the discriminating anchor.
+    /^a[n]?\s+(?:new|empty|blank)?\s*file\s+(?:called|named)\s+(?<p>.+)$/i,
+];
+const CREATE_FILE_REVERSED = [
+    /^(?:create|make|add)\s+(?:a\s+)?(?<p>.+?)\s+file$/i,
+];
+function matchCreateFile(raw) {
+    // 1. CLI-native: touch <path>  (unguarded)
+    const touchM = /^touch\s+(?<p>.+)$/i.exec(raw);
+    if (touchM?.groups?.p) {
+        const p = touchM.groups.p.trim();
+        return p ? { kind: "create_file", path: p } : null;
+    }
+    // 2. Forward: verb + "file" + name
+    for (const pat of CREATE_FILE_FORWARD) {
+        const m = pat.exec(raw);
+        if (m?.groups?.p) {
+            const path = cleanPath(m.groups.p);
+            if (path)
+                return { kind: "create_file", path };
+        }
+    }
+    // 3. Reversed: verb + name + "file"
+    //    "create a README.md file"  — looksLikePath gate blocks prose captures
+    for (const pat of CREATE_FILE_REVERSED) {
+        const m = pat.exec(raw);
+        if (m?.groups?.p) {
+            const path = cleanPath(m.groups.p);
+            if (path)
+                return { kind: "create_file", path };
+        }
+    }
+    return null;
+}
+// ─── matchRename ──────────────────────────────────────────────────────────────
+function matchRename(raw) {
+    // 1. CLI-native: mv <from> <to>  (unguarded — expects exactly two tokens)
+    const mvM = /^mv\s+(\S+)\s+(\S+)$/i.exec(raw);
+    if (mvM?.[1] && mvM?.[2]) {
+        return { kind: "rename", from: mvM[1], to: mvM[2] };
+    }
+    // 1b. Quoted paths — rename "from path" to "to path"
+    //     Allows space-containing filenames: rename "my file.ts" to "your file.ts"
+    //     Double-quote form:
+    const dqM = /^(?:rename|move)\s+"([^"]+)"\s+to\s+"([^"]+)"$/i.exec(raw);
+    if (dqM?.[1] && dqM?.[2]) {
+        return { kind: "rename", from: dqM[1].trim(), to: dqM[2].trim() };
+    }
+    //     Single-quote form:
+    const sqM = /^(?:rename|move)\s+'([^']+)'\s+to\s+'([^']+)'$/i.exec(raw);
+    if (sqM?.[1] && sqM?.[2]) {
+        return { kind: "rename", from: sqM[1].trim(), to: sqM[2].trim() };
+    }
+    // 2. rename/move <path> to <path>
+    //    Class 2: optional "the file|folder|directory" article noise before the source path
+    //    "rename the file old.ts to new.ts" → from="old.ts", to="new.ts"
+    const m = /^(?:rename|move)\s+(?:the\s+(?:file|folder|directory)\s+)?(\S+(?:\/\S+)*)\s+to\s+(\S+(?:\/\S+)*)$/i.exec(raw);
+    if (m?.[1] && m?.[2]) {
+        return { kind: "rename", from: m[1], to: m[2] };
+    }
+    return null;
+}
+// ─── matchDelete ──────────────────────────────────────────────────────────────
+function matchDelete(raw) {
+    // 1. CLI-native: rm <path>  (unguarded)
+    const rmM = /^rm\s+(?<p>.+)$/i.exec(raw);
+    if (rmM?.groups?.p) {
+        const p = rmM.groups.p.trim();
+        return p ? { kind: "delete", path: p } : null;
+    }
+    // 2. Class 2: "delete the X folder" / "remove the X file"
+    //    Article noise before a single-token path and an explicit type keyword.
+    //    Single-token constraint (`\S+`) prevents multi-word captures; looksLikePath
+    //    rejects bare prose nouns.  "delete the old stuff folder" fails because
+    //    `\S+` only captures "old" and then `\s+folder$` can't match " stuff folder".
+    const articleM = /^(?:delete|remove)\s+the\s+(\S+)\s+(?:file|folder|directory|dir)$/i.exec(raw);
+    if (articleM?.[1]) {
+        const path = cleanPath(articleM[1]);
+        if (path)
+            return { kind: "delete", path };
+    }
+    // 3. Explicit keyword: delete/remove [the] file|folder|directory <name>
+    //    "delete file src/unused.ts"  "remove folder temp"  "remove directory build"
+    //    "remove the file temp.txt"  "delete the folder build"  (Class 2 — keyword-first)
+    //    cleanPath gate: "delete folder the old stuff" → looksLikePath fails ✓
+    const kwM = /^(?:delete|remove)\s+(?:the\s+)?(?:file|folder|directory|dir)\s+(?<p>.+)$/i.exec(raw);
+    if (kwM?.groups?.p) {
+        const path = cleanPath(kwM.groups.p);
+        if (path)
+            return { kind: "delete", path };
+    }
+    // 4. Bare path: delete/remove <single-token-path>
+    //    Restricted to tokens with an extension OR path separator.
+    //    This intentionally rejects bare identifiers like "delete cache" or
+    //    "delete everything" — single nouns are too ambiguous without a keyword.
+    const bareM = /^(?:delete|remove)\s+(\S+)$/i.exec(raw);
+    if (bareM?.[1]) {
+        const candidate = bareM[1];
+        const hasExt = /\.[a-zA-Z0-9]{1,10}$/.test(candidate);
+        const hasSep = candidate.includes("/") || candidate.includes("\\");
+        if (hasExt || hasSep) {
+            return { kind: "delete", path: candidate };
+        }
+    }
+    return null;
+}
+// ─── matchReplace ─────────────────────────────────────────────────────────────
+function matchReplace(raw) {
+    // replace "X" with "Y" in file  (double quotes)
+    const rdq = /^replace\s+"([^"]+)"\s+with\s+"([^"]+)"\s+in\s+(\S+(?:\/\S+)*)$/i.exec(raw);
+    if (rdq?.[1] && rdq?.[2] && rdq?.[3]) {
+        return { kind: "replace", find: rdq[1], replace: rdq[2], file: rdq[3] };
+    }
+    // replace 'X' with 'Y' in file  (single quotes)
+    const rsq = /^replace\s+'([^']+)'\s+with\s+'([^']+)'\s+in\s+(\S+(?:\/\S+)*)$/i.exec(raw);
+    if (rsq?.[1] && rsq?.[2] && rsq?.[3]) {
+        return { kind: "replace", find: rsq[1], replace: rsq[2], file: rsq[3] };
+    }
+    // change "X" to "Y" in file  (double quotes, natural phrasing)
+    const cdq = /^change\s+"([^"]+)"\s+to\s+"([^"]+)"\s+in\s+(\S+(?:\/\S+)*)$/i.exec(raw);
+    if (cdq?.[1] && cdq?.[2] && cdq?.[3]) {
+        return { kind: "replace", find: cdq[1], replace: cdq[2], file: cdq[3] };
+    }
+    // change 'X' to 'Y' in file  (single quotes)
+    const csq = /^change\s+'([^']+)'\s+to\s+'([^']+)'\s+in\s+(\S+(?:\/\S+)*)$/i.exec(raw);
+    if (csq?.[1] && csq?.[2] && csq?.[3]) {
+        return { kind: "replace", find: csq[1], replace: csq[2], file: csq[3] };
+    }
+    // Unquoted single-token forms — "change foo to bar in App.tsx"
+    //   and "replace foo with bar in App.tsx"
+    //
+    // Safety constraints (both must hold):
+    //   1. find and replace are single non-space tokens (\S+) — multi-word values
+    //      fail to match, e.g. "change old button text to new one in App.tsx" → null
+    //   2. file must have a recognised extension OR a path separator — bare words
+    //      like "production" or "config" are rejected to prevent over-matching prose.
+    //      This is intentionally stricter than looksLikePath's clean-identifier check.
+    const unquotedChange = /^change\s+(\S+)\s+to\s+(\S+)\s+in\s+(\S+)$/i.exec(raw);
+    if (unquotedChange?.[1] && unquotedChange?.[2] && unquotedChange?.[3]) {
+        const file = unquotedChange[3];
+        const hasExt = /\.[a-zA-Z0-9]{1,10}$/.test(file);
+        const hasSep = file.includes("/") || file.includes("\\");
+        if (hasExt || hasSep) {
+            return { kind: "replace", find: unquotedChange[1], replace: unquotedChange[2], file };
+        }
+    }
+    const unquotedReplace = /^replace\s+(\S+)\s+with\s+(\S+)\s+in\s+(\S+)$/i.exec(raw);
+    if (unquotedReplace?.[1] && unquotedReplace?.[2] && unquotedReplace?.[3]) {
+        const file = unquotedReplace[3];
+        const hasExt = /\.[a-zA-Z0-9]{1,10}$/.test(file);
+        const hasSep = file.includes("/") || file.includes("\\");
+        if (hasExt || hasSep) {
+            return { kind: "replace", find: unquotedReplace[1], replace: unquotedReplace[2], file };
+        }
+    }
+    return null;
+}
+// ─── normalizeIntent ──────────────────────────────────────────────────────────
+/**
+ * Convert a free-form user string into a structured ParsedIntent.
+ *
+ * Returns null when:
+ *   - The input is empty or whitespace
+ *   - The input is ambiguous or vague (no recognised operation + valid path)
+ *   - A required field (path, from/to, etc.) cannot be determined safely
+ *
+ * On null the caller falls through to the strict canonical parser.
+ */
+export function normalizeIntent(raw) {
+    const collapsed = collapseSpaces(raw);
+    if (!collapsed)
+        return null;
+    // Class 1: strip a single leading polite softener before matching.
+    // Only the social wrapper is removed; mid-sentence words are untouched.
+    const input = collapseSpaces(stripLeadingPrefix(collapsed));
+    if (!input)
+        return null;
+    // replace/change must be tested first — the verb "replace" is also a
+    // file-like create verb in some patterns; checking it first avoids ambiguity.
+    return (matchReplace(input) ??
+        matchCreateDir(input) ??
+        matchCreateFile(input) ??
+        matchRename(input) ??
+        matchDelete(input) ??
+        null);
+}
+// ─── intentToChange ───────────────────────────────────────────────────────────
+/**
+ * Convert a ParsedIntent into the canonical ParsedChange used by the execution
+ * pipeline (FsChange | ReplaceChange).
+ *
+ * This is the only bridge between the normalizer and the execution path.
+ * No new execution paths are introduced here.
+ */
+export function intentToChange(intent) {
+    switch (intent.kind) {
+        case "create_dir":
+            return {
+                operationType: "create_dir",
+                dirPath: intent.path,
+            };
+        case "create_file":
+            return {
+                operationType: "write_file",
+                filePath: intent.path,
+                content: intent.content ?? "",
+            };
+        case "rename":
+            return {
+                operationType: "rename",
+                filePath: intent.from,
+                newPath: intent.to,
+            };
+        case "delete":
+            return {
+                operationType: "delete_file",
+                filePath: intent.path,
+            };
+        case "replace":
+            return {
+                oldValue: intent.find,
+                newValue: intent.replace,
+                filePath: intent.file,
+            };
+    }
+}
+// ─── describeIntent ───────────────────────────────────────────────────────────
+/**
+ * Human-readable "SYSTEM WILL:" description for a ParsedIntent.
+ * Used in the UI approval frame to surface normalised intent to the user.
+ */
+export function describeIntent(intent) {
+    switch (intent.kind) {
+        case "create_dir": return `Create directory: ./${intent.path}`;
+        case "create_file": return `Create file: ./${intent.path}`;
+        case "rename": return `Rename path: ${intent.from}  →  ${intent.to}`;
+        case "delete": return `Delete path: ./${intent.path}`;
+        case "replace": return `Replace text in: ${intent.file}`;
+    }
+}
+//# sourceMappingURL=intent.js.map

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

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

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

@@ -0,0 +1,26 @@
+/**
+ * Change Interpretation orchestrator — v1.
+ *
+ * CONTRACT:
+ *   Interpretation is ADVISORY. It does not alter the execute/guide/refuse
+ *   decision produced by the intake pipeline. It describes what the human
+ *   will experience from the change.
+ *
+ *   Returns null when:
+ *     - Input cannot be parsed as a structured change command
+ *     - No rule matches the parsed change (change type is outside v1 scope)
+ *
+ *   v1 scope:
+ *     - Tailwind / CSS color changes
+ *     - Text literal changes
+ *     - Simple config value changes
+ *
+ * Future scope (not implemented in v1):
+ *   - Structural code changes
+ *   - Import / dependency changes
+ *   - Multi-file changes
+ *   - Logic / control-flow changes
+ */
+import type { InterpretationResult } from "./types.js";
+export declare function interpretChange(input: string): InterpretationResult | null;
+//# sourceMappingURL=interpretation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"interpretation.d.ts","sourceRoot":"","sources":["../../../../src/understand/interpretation/interpretation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAKvD,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI,CAe1E"}

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

@@ -0,0 +1,43 @@
+/**
+ * Change Interpretation orchestrator — v1.
+ *
+ * CONTRACT:
+ *   Interpretation is ADVISORY. It does not alter the execute/guide/refuse
+ *   decision produced by the intake pipeline. It describes what the human
+ *   will experience from the change.
+ *
+ *   Returns null when:
+ *     - Input cannot be parsed as a structured change command
+ *     - No rule matches the parsed change (change type is outside v1 scope)
+ *
+ *   v1 scope:
+ *     - Tailwind / CSS color changes
+ *     - Text literal changes
+ *     - Simple config value changes
+ *
+ * Future scope (not implemented in v1):
+ *   - Structural code changes
+ *   - Import / dependency changes
+ *   - Multi-file changes
+ *   - Logic / control-flow changes
+ */
+import { isFsChange } from "./types.js";
+import { parseChange } from "./parser.js";
+import { ALL_INTERPRETATION_RULES } from "./rules.js";
+export function interpretChange(input) {
+    const parsed = parseChange(input);
+    if (parsed === null)
+        return null;
+    // FS operations have no interpretation rules — their intent is fully explicit.
+    if (isFsChange(parsed))
+        return null;
+    for (const rule of ALL_INTERPRETATION_RULES) {
+        if (rule.matches(parsed)) {
+            const result = rule.interpret(parsed);
+            if (result !== null)
+                return result;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=interpretation.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"interpretation.js","sourceRoot":"","sources":["../../../../src/understand/interpretation/interpretation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAEtD,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IAClC,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAEjC,+EAA+E;IAC/E,IAAI,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IAEpC,KAAK,MAAM,IAAI,IAAI,wBAAwB,EAAE,CAAC;QAC5C,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACzB,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YACtC,IAAI,MAAM,KAAK,IAAI;gBAAE,OAAO,MAAM,CAAC;QACrC,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

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

@@ -0,0 +1,20 @@
+/**
+ * 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 type { ParsedChange } from "./types.js";
+export declare function parseChange(input: string): ParsedChange | null;
+/** Extract the filename from a path without importing node:path. */
+export declare function basename(filePath: string): string;
+//# sourceMappingURL=parser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../../src/understand/interpretation/parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAqC/C,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAyD9D;AAED,oEAAoE;AACpE,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEjD"}