@slowcook-ai/cli 0.17.0-alpha.5 → 0.17.0-alpha.7

package/dist/commands/recon/shape-emit.js

@@ -0,0 +1,350 @@
+/**
+ * @slowcook 0.17.6+ — recon shape-test emission.
+ *
+ * Reads mock UI files for a story and emits structural assertions to
+ * `tests/integration/story-N-shape.test.tsx`. Pure deterministic; no LLM.
+ *
+ * Asserts SHAPE only (per `feedback_shape_tests_belong_to_recon_not_testgen`):
+ *   - testid presence + cardinality
+ *   - DOM containment (e.g. badge inside <header>)
+ *   - className tokens (visual/a11y signals like `rounded-full`, `min-h-[44px]`)
+ *   - CSS variable tokens (no inline hex/rgb)
+ *
+ * Never asserts WIRING (per `feedback_testgen_must_not_over_assert_mock`):
+ *   - No spied-on hooks, no import existence, no readFileSync of source
+ *   - No mock-only chrome (subtrees marked `data-mock-chrome="true"` are
+ *     mechanically excluded from the testid+class extraction)
+ *
+ * Test rendering uses plain props (no scenario-runtime), so mock-chrome
+ * never actually renders in the test even if it weren't filtered.
+ */
+import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
+import { join, relative } from "node:path";
+const TOKENS_OF_INTEREST = [
+    // Shape tokens
+    "rounded-full", "rounded-2xl", "rounded-xl", "rounded-lg", "rounded-md", "rounded-sm",
+    // Tap-target / a11y mandates
+    "min-h-[44px]", "min-h-11", "h-11", "min-w-[44px]",
+    // Common layout primitives that imply structural intent
+    "flex", "grid", "inline-flex",
+];
+/**
+ * Scan a mock UI file, return the SHAPE-relevant facts after stripping
+ * mock-only chrome subtrees.
+ */
+export function extractShape(absFile, repoRoot) {
+    if (!existsSync(absFile))
+        return null;
+    const body = readFileSync(absFile, "utf8");
+    const fileRel = relative(repoRoot, absFile).replace(/\\/g, "/");
+    // Strip mock-only chrome subtrees BEFORE extraction.
+    const cleaned = stripMockChromeSubtrees(body);
+    // Component name: simplest extraction.
+    const nameMatch = cleaned.match(/export\s+(?:default\s+)?function\s+([A-Z]\w*)/);
+    const componentName = nameMatch ? nameMatch[1] ?? null : null;
+    const testids = [...new Set(extractTestids(cleaned))];
+    const visualTokens = [...new Set(extractTokens(cleaned, TOKENS_OF_INTEREST))];
+    const hasHeader = /<header\b/.test(cleaned);
+    return { file: fileRel, testids, visualTokens, hasHeader, componentName };
+}
+/**
+ * Strip JSX subtrees marked as mock-only chrome. Three conventions
+ * recognised (any one is enough):
+ *   1. `data-mock-chrome="true"` attribute on the wrapping element
+ *   2. JSX comment immediately preceding: `{/* Mock-only ... */ `}`
+    * 3.;
+Source;
+comment;
+immediately;
+preceding;
+the;
+element: `// Mock-only ...`
+    *
+    * Conservative;
+false;
+positives(treating, real, shape);
+are
+    * worse;
+than;
+false;
+negatives.We;
+only;
+strip;
+elements;
+with (the)
+    explicit
+        * marker;
+the;
+comment - based;
+heuristics;
+are;
+best - effort;
+fallback.
+    * /;
+export function stripMockChromeSubtrees(source) {
+    let out = source;
+    // Pass 1: strip elements opened with data-mock-chrome="true" (and their
+    // children up to the matching closing tag).
+    out = stripBalancedJsxBlock(out, /<(\w+)\b[^>]*\bdata-mock-chrome\s*=\s*["']true["'][^>]*>/);
+    // Pass 2: best-effort — strip the JSX block that immediately follows
+    // a `{/* Mock-only ... */}` JSX comment.
+    out = stripBalancedJsxBlockAfter(out, /\{\/\*\s*Mock-only[^*]*\*\/\s*\}\s*/);
+    return out;
+}
+/**
+ * Repeatedly find a JSX opening tag matching `openRe` and remove the
+ * balanced subtree (open tag + children + close tag).
+ *
+ * Self-closing tags (e.g. `<Foo />`) are also handled. Tag-name balanced.
+ */
+function stripBalancedJsxBlock(source, openRe) {
+    let s = source;
+    for (let safety = 0; safety < 64; safety++) {
+        const m = openRe.exec(s);
+        if (!m)
+            break;
+        const start = m.index;
+        const tagName = m[1];
+        const openTag = m[0];
+        // Self-closing? remove just that.
+        if (openTag.endsWith("/>")) {
+            s = s.slice(0, start) + s.slice(start + openTag.length);
+            openRe.lastIndex = 0;
+            continue;
+        }
+        // Walk forward to find balanced close.
+        let depth = 1;
+        let i = start + openTag.length;
+        const openTagRe = new RegExp(`<${tagName}\\b[^>]*?>`, "g");
+        const closeTagRe = new RegExp(`</${tagName}\\s*>`, "g");
+        while (i < s.length && depth > 0) {
+            openTagRe.lastIndex = i;
+            closeTagRe.lastIndex = i;
+            const oNext = openTagRe.exec(s);
+            const cNext = closeTagRe.exec(s);
+            if (!cNext)
+                break;
+            if (oNext && oNext.index < cNext.index) {
+                // skip self-closing inside (rare for compound tag)
+                if (!oNext[0].endsWith("/>"))
+                    depth++;
+                i = oNext.index + oNext[0].length;
+            }
+            else {
+                depth--;
+                i = cNext.index + cNext[0].length;
+                if (depth === 0) {
+                    s = s.slice(0, start) + s.slice(i);
+                    break;
+                }
+            }
+        }
+        openRe.lastIndex = 0;
+    }
+    return s;
+}
+function stripBalancedJsxBlockAfter(source, markerRe) {
+    let s = source;
+    for (let safety = 0; safety < 32; safety++) {
+        const m = markerRe.exec(s);
+        if (!m)
+            break;
+        // Find the JSX opening tag immediately after the marker.
+        const after = s.slice(m.index + m[0].length);
+        const tagMatch = /^\s*<(\w+)\b[^>]*>/.exec(after);
+        if (!tagMatch) {
+            // Marker not followed by a JSX tag; just remove the marker comment.
+            s = s.slice(0, m.index) + s.slice(m.index + m[0].length);
+            continue;
+        }
+        // Use stripBalancedJsxBlock at the marker position with the tag-specific regex.
+        const openTagAbsoluteIdx = m.index + m[0].length + (after.indexOf("<"));
+        const tagName = tagMatch[1];
+        if (!tagName) {
+            s = s.slice(0, m.index) + s.slice(m.index + m[0].length);
+            continue;
+        }
+        const openTagRe = new RegExp(`<${tagName}\\b[^>]*?>`);
+        const sliced = s.slice(openTagAbsoluteIdx);
+        const stripped = stripBalancedJsxBlock(sliced, openTagRe);
+        s = s.slice(0, m.index) + stripped;
+        markerRe.lastIndex = 0;
+    }
+    return s;
+}
+function extractTestids(source) {
+    const out = [];
+    for (const m of source.matchAll(/data-testid\s*=\s*["']([^"']+)["']/g)) {
+        if (m[1])
+            out.push(m[1]);
+    }
+    return out;
+}
+function extractTokens(source, tokens) {
+    const out = [];
+    for (const t of tokens) {
+        // Look in className strings/template literals.
+        const re = new RegExp(`className\\s*=\\s*["'\`][^"'\`]*\\b${escapeRegExp(t)}\\b`);
+        if (re.test(source))
+            out.push(t);
+    }
+    return out;
+}
+function escapeRegExp(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+export function synthesiseShapeTestFile(opts) {
+    const { story, shapes } = opts;
+    const lines = [];
+    lines.push("// @vitest-environment jsdom");
+    lines.push("//");
+    lines.push(`// AUTO-GENERATED by slowcook recon (story-${story}). Do not edit by hand.`);
+    lines.push("// Asserts STRUCTURAL SHAPE only (DOM containment, testid cardinality,");
+    lines.push("// className tokens, CSS-variable usage). Behavioral assertions live in");
+    lines.push(`// the testgen-emitted story-${story}-*.test.{ts,tsx} files.`);
+    lines.push("//");
+    lines.push("// Mock-only chrome (data-mock-chrome=\"true\" subtrees) is excluded.");
+    lines.push("// Re-running recon regenerates this file.");
+    lines.push("");
+    lines.push(`import { describe, it, expect } from "vitest";`);
+    lines.push("");
+    lines.push(`describe("story-${story} structural shape (recon-emitted)", () => {`);
+    // For each unique testid across all shapes, emit cardinality + presence assertions
+    // backed by source-greppable checks (NOT a render — recon doesn't have a
+    // render-helper available without the consumer's test setup).
+    // The render-based assertions need the consumer's renderWithProviders helper +
+    // Component import + props; recon emits a TODO scaffold the operator (or a
+    // future iteration of brew) fills in.
+    const allTestids = [...new Set(shapes.flatMap((s) => s.testids))];
+    if (allTestids.length === 0) {
+        lines.push(`  it.skip("no testids found in mock UI — nothing to assert", () => {});`);
+    }
+    else {
+        // Source-grep based assertions: cheap + always work without a render.
+        lines.push(``);
+        lines.push(`  // Source-grep assertions: testids the mock exposes must remain in src/`);
+        lines.push(`  // after brew's edits. These don't require a render.`);
+        lines.push(`  import { readFileSync, existsSync } from "node:fs";`);
+        lines.push(``);
+        for (const shape of shapes) {
+            const srcPath = mockToSrcPath(shape.file);
+            lines.push(`  describe("from mock ${shape.file}", () => {`);
+            lines.push(`    const srcPath = "${srcPath}";`);
+            lines.push(`    const src = existsSync(srcPath) ? readFileSync(srcPath, "utf8") : "";`);
+            lines.push(``);
+            for (const tid of shape.testids) {
+                lines.push(`    it("preserves data-testid='${tid}' (mock-only chrome excluded)", () => {`);
+                lines.push(`      expect(src).toMatch(/data-testid\\s*=\\s*["']${escapeRegexForTest(tid)}["']/);`);
+                lines.push(`    });`);
+            }
+            for (const token of shape.visualTokens) {
+                lines.push(`    it("preserves visual token '${token}'", () => {`);
+                lines.push(`      expect(src).toMatch(/className=[^>]*\\b${escapeRegexForTest(token)}\\b/);`);
+                lines.push(`    });`);
+            }
+            if (shape.hasHeader) {
+                lines.push(`    it("retains a <header> element (semantic landmark)", () => {`);
+                lines.push(`      expect(src).toMatch(/<header\\b/);`);
+                lines.push(`    });`);
+            }
+            lines.push(`  });`);
+            lines.push(``);
+        }
+        // Anti-wiring assertion: no inline hex colors (force token-family preservation).
+        lines.push(`  describe("token-family preservation", () => {`);
+        for (const shape of shapes) {
+            const srcPath = mockToSrcPath(shape.file);
+            lines.push(`    it("${shape.componentName ?? shape.file}: no inline hex/rgb colors (use var(--) tokens)", () => {`);
+            lines.push(`      const src = existsSync("${srcPath}") ? readFileSync("${srcPath}", "utf8") : "";`);
+            lines.push(`      // Allow hex in JSDoc/comments; only flag in className/style attribute values.`);
+            lines.push(`      const styled = src.match(/(?:className|style)\\s*=\\s*[\"\`'][^\"\`']*?[#][0-9a-fA-F]{3,8}[^\"\`']*?[\"\`']/g) || [];`);
+            lines.push(`      expect(styled, "no inline hex in className/style").toEqual([]);`);
+            lines.push(`    });`);
+        }
+        lines.push(`  });`);
+    }
+    lines.push(`});`);
+    return lines.join("\n") + "\n";
+}
+function mockToSrcPath(mockPath) {
+    // mock/src/components/X.tsx → src/components/X.tsx
+    return mockPath.replace(/^mock\/src\//, "src/");
+}
+function escapeRegexForTest(s) {
+    return s.replace(/[.*+?^${}()|[\]\\\/]/g, "\\\\$&");
+}
+// ---- Discovery: which mock files belong to a story ----
+/**
+ * Walk mock/src/ + return any file that contains `story-N` in source
+ * OR is referenced by a scenario file for the story.
+ *
+ * For 0.17.6 first cut: simple — any file under mock/src/components/
+ * that lives in a directory referenced by the story's scenario.
+ * Conservative — caller can pass explicit list via --mock-files.
+ */
+export function findMockFilesForStory(repoRoot, story) {
+    const out = new Set();
+    // Look for mock/scenarios/story-N*.ts
+    const scenariosDir = join(repoRoot, "mock/scenarios");
+    if (existsSync(scenariosDir)) {
+        for (const name of readdirSync(scenariosDir)) {
+            if (!name.startsWith(`story-${story}`))
+                continue;
+            const body = readFileSync(join(scenariosDir, name), "utf8");
+            // Pull `from "@/components/X/Y"` imports
+            for (const m of body.matchAll(/from\s+["']@\/(components\/[\w\-./[\]]+)["']/g)) {
+                if (m[1]) {
+                    const candidates = [
+                        `mock/src/${m[1]}.tsx`,
+                        `mock/src/${m[1]}.ts`,
+                        `mock/src/${m[1]}/index.tsx`,
+                    ];
+                    for (const c of candidates) {
+                        if (existsSync(join(repoRoot, c)))
+                            out.add(c);
+                    }
+                }
+            }
+        }
+    }
+    // Also: any mock component referenced by a story-N test file
+    const testsDir = join(repoRoot, "tests/integration");
+    if (existsSync(testsDir)) {
+        for (const name of readdirSync(testsDir)) {
+            if (!name.startsWith(`story-${story}`))
+                continue;
+            const body = readFileSync(join(testsDir, name), "utf8");
+            for (const m of body.matchAll(/from\s+["']@\/(components\/[\w\-./[\]]+)["']/g)) {
+                if (m[1]) {
+                    const candidates = [
+                        `mock/src/${m[1]}.tsx`,
+                        `mock/src/${m[1]}.ts`,
+                    ];
+                    for (const c of candidates) {
+                        if (existsSync(join(repoRoot, c)))
+                            out.add(c);
+                    }
+                }
+            }
+        }
+    }
+    // Recurse: include direct imports of the discovered files
+    for (const file of [...out]) {
+        const body = readFileSync(join(repoRoot, file), "utf8");
+        for (const m of body.matchAll(/from\s+["']\.\/(\w+)["']/g)) {
+            if (m[1]) {
+                const dir = file.split("/").slice(0, -1).join("/");
+                const candidate = `${dir}/${m[1]}.tsx`;
+                if (existsSync(join(repoRoot, candidate)))
+                    out.add(candidate);
+            }
+        }
+    }
+    return [...out];
+}
+// Re-export for tests
+export { join as _join };
+// re-export to placate tsc unused-import warnings
+void readdirSync;
+void statSync;
+//# sourceMappingURL=shape-emit.js.map

package/dist/commands/recon/shape-emit.js.map

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

package/dist/commands/recon/shape-preserve.d.ts

@@ -0,0 +1,63 @@
+/**
+ * @slowcook 0.17.6+ — recon shape-preservation tests.
+ *
+ * Reads mock UI files for a story and emits structural assertions to
+ * tests/integration/story-N-shape.test.tsx. Pure deterministic; no LLM.
+ *
+ * Asserts SHAPE only (per `feedback_shape_tests_belong_to_recon_not_testgen`):
+ *   - testid presence + cardinality
+ *   - DOM containment (e.g. badge inside <header>)
+ *   - className tokens (visual/a11y signals like `rounded-full`, `min-h-[44px]`)
+ *   - CSS variable tokens (no inline hex/rgb)
+ *
+ * Never asserts WIRING (per `feedback_testgen_must_not_over_assert_mock`):
+ *   - No spied-on hooks, no import existence, no readFileSync of source
+ *   - No mock-only chrome (subtrees marked `data-mock-chrome="true"` are
+ *     mechanically excluded from the testid+class extraction)
+ *
+ * Test rendering uses plain props (no scenario-runtime), so mock-chrome
+ * never actually renders in the test even if it weren't filtered.
+ */
+import { join } from "node:path";
+export interface ExtractedShape {
+    /** Component file scanned (mock-side). */
+    file: string;
+    /** Testids found on non-mock-chrome JSX (deduped). */
+    testids: string[];
+    /** Visual className tokens worth preserving (subset; see TOKENS_OF_INTEREST). */
+    visualTokens: string[];
+    /** Whether the component renders any element with a `<header>` ancestor. */
+    hasHeader: boolean;
+    /** Component name (best-effort). */
+    componentName: string | null;
+}
+/**
+ * Scan a mock UI file, return the SHAPE-relevant facts after stripping
+ * mock-only chrome subtrees.
+ */
+export declare function extractShape(absFile: string, repoRoot: string): ExtractedShape | null;
+/**
+ * Strip JSX subtrees marked as mock-only chrome. Two conventions:
+ *   1. data-mock-chrome="true" attribute on the wrapping element
+ *   2. JSX comment immediately preceding (matching /Mock-only/i)
+ *
+ * Conservative — false positives (treating real shape as chrome) are
+ * worse than false negatives.
+ */
+export declare function stripMockChromeSubtrees(source: string): string;
+interface SynthOpts {
+    story: string;
+    shapes: ExtractedShape[];
+}
+export declare function synthesiseShapeTestFile(opts: SynthOpts): string;
+/**
+ * Walk mock/src/ + return any file that contains `story-N` in source
+ * OR is referenced by a scenario file for the story.
+ *
+ * For 0.17.6 first cut: simple — any file under mock/src/components/
+ * that lives in a directory referenced by the story's scenario.
+ * Conservative — caller can pass explicit list via --mock-files.
+ */
+export declare function findMockFilesForStory(repoRoot: string, story: string): string[];
+export { join as _join };
+//# sourceMappingURL=shape-preserve.d.ts.map

package/dist/commands/recon/shape-preserve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shape-preserve.d.ts","sourceRoot":"","sources":["../../../src/commands/recon/shape-preserve.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,EAAE,IAAI,EAAY,MAAM,WAAW,CAAC;AAE3C,MAAM,WAAW,cAAc;IAC7B,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,iFAAiF;IACjF,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,4EAA4E;IAC5E,SAAS,EAAE,OAAO,CAAC;IACnB,oCAAoC;IACpC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAWD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAiBrF;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAY9D;AA0GD,UAAU,SAAS;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,cAAc,EAAE,CAAC;CAC1B;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAmE/D;AAaD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CA+E/E;AAGD,OAAO,EAAE,IAAI,IAAI,KAAK,EAAE,CAAC"}