@slowcook-ai/cli 0.15.0-alpha.4 → 0.16.0-alpha.10

package/dist/commands/init/mock.js

@@ -0,0 +1,500 @@
+/**
+ * `slowcook init mock` — scaffold the consumer's mock/ directory.
+ *
+ * Writes the consumer-side shell of the singular mock app: package.json
+ * (depending on @slowcook-ai/mock-runtime + next + react), Dockerfile,
+ * tsconfig, next.config.js, postcss.config.mjs, layout.tsx, page.tsx,
+ * scenario-registry.ts, globals.css (copied from src/app/globals.css if
+ * present), .gitignore, README.md.
+ *
+ * Refuses to overwrite existing files unless --force.
+ *
+ * After running this once, the consumer commits + pushes; vibe runs
+ * after (slowcook 0.16-α.3+) populate `mock/scenarios/` + extend
+ * `mock/src/lib/scenario-registry.ts`.
+ */
+import { writeFileSync, existsSync, mkdirSync, readFileSync } from "node:fs";
+import { dirname, join, relative } from "node:path";
+export function parseMockInitArgs(argv, runtimeVersion) {
+    const args = {
+        cwd: process.cwd(),
+        force: false,
+        dryRun: false,
+        runtimeVersion,
+    };
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        const next = argv[i + 1];
+        if (a === "--cwd" && next) {
+            args.cwd = next;
+            i++;
+        }
+        else if (a === "--force") {
+            args.force = true;
+        }
+        else if (a === "--dry-run") {
+            args.dryRun = true;
+        }
+        else if (a === "--runtime-version" && next) {
+            args.runtimeVersion = next;
+            i++;
+        }
+        else if (a === "--help" || a === "-h") {
+            printHelp();
+            process.exit(0);
+        }
+    }
+    return args;
+}
+function printHelp() {
+    console.log(`
+slowcook init mock — scaffold the consumer's mock/ directory
+
+Writes the consumer-side shell of the singular UI mock app.
+Imports its runtime (Scenario types, hooks, ScenarioPicker,
+ScenarioRegistryProvider) from @slowcook-ai/mock-runtime so updates
+ship via npm bump rather than a re-init.
+
+Usage:
+  slowcook init mock [--cwd <path>] [--force] [--dry-run]
+
+Options:
+  --cwd <path>             Repo root (default: cwd).
+  --force                  Overwrite existing files.
+  --dry-run                Print planned actions without writing.
+  --runtime-version <v>    Pin of @slowcook-ai/mock-runtime (default: matches cli version).
+
+What it writes:
+  mock/package.json                      depends on @slowcook-ai/mock-runtime + next + react
+  mock/Dockerfile                        multi-stage; runs on port 3100
+  mock/tsconfig.json                     path aliases @/* → src/*; @/mock/* → lib/mock-runtime/*
+  mock/next.config.js                    turbopack root pinned to mock/ (avoids parent-src auto-discovery)
+  mock/postcss.config.mjs                @tailwindcss/postcss plugin
+  mock/.gitignore                        node_modules, .next, .turbo, .env*.local
+  mock/README.md                         what the mock is + scenario authoring guide
+  mock/src/app/layout.tsx                root layout; ScenarioRegistryProvider wraps children
+  mock/src/app/page.tsx                  renders <ScenarioPicker /> from the runtime
+  mock/src/app/globals.css               copied from src/app/globals.css if present, else a minimal
+                                         Tailwind-v4 directives file (consumer expected to extend)
+  mock/src/lib/scenario-registry.ts      consumer-owned; vibe extends this with scenario imports
+  mock/scenarios/.gitkeep                empty until vibe writes story-N.ts files
+`);
+}
+export function planMockFiles(args) {
+    const productionGlobals = join(args.cwd, "src/app/globals.css");
+    let globalsContents;
+    let globalsNote;
+    if (existsSync(productionGlobals)) {
+        try {
+            globalsContents = readFileSync(productionGlobals, "utf8");
+            globalsNote = `(copied from src/app/globals.css — design tokens shared with production)`;
+        }
+        catch {
+            globalsContents = MINIMAL_GLOBALS_CSS;
+            globalsNote = "(could not read src/app/globals.css; wrote minimal Tailwind directives — extend manually)";
+        }
+    }
+    else {
+        globalsContents = MINIMAL_GLOBALS_CSS;
+        globalsNote = "(no src/app/globals.css found; wrote minimal Tailwind directives — extend manually)";
+    }
+    return [
+        { path: "mock/package.json", contents: PACKAGE_JSON(args.runtimeVersion), skipIfExists: true },
+        { path: "mock/Dockerfile", contents: DOCKERFILE, skipIfExists: true },
+        { path: "mock/tsconfig.json", contents: TSCONFIG, skipIfExists: true },
+        { path: "mock/next.config.js", contents: NEXT_CONFIG, skipIfExists: true },
+        { path: "mock/postcss.config.mjs", contents: POSTCSS_CONFIG, skipIfExists: true },
+        { path: "mock/.gitignore", contents: GITIGNORE, skipIfExists: true },
+        { path: "mock/README.md", contents: README, skipIfExists: true },
+        { path: "mock/src/app/layout.tsx", contents: LAYOUT_TSX, skipIfExists: true },
+        { path: "mock/src/app/page.tsx", contents: PAGE_TSX, skipIfExists: true },
+        {
+            path: "mock/src/app/globals.css",
+            contents: globalsContents + `\n/* ${globalsNote} */\n`,
+            skipIfExists: true,
+        },
+        { path: "mock/src/lib/scenario-registry.ts", contents: SCENARIO_REGISTRY, skipIfExists: true },
+        { path: "mock/scenarios/.gitkeep", contents: "", skipIfExists: true },
+    ];
+}
+export async function initMock(argv, cliVersion) {
+    const runtimeVersion = mockRuntimeVersionFor(cliVersion);
+    const args = parseMockInitArgs(argv, runtimeVersion);
+    const files = planMockFiles(args);
+    console.log(`slowcook init mock · cwd: ${relative(process.cwd(), args.cwd) || "."}`);
+    console.log(`runtime: @slowcook-ai/mock-runtime@${args.runtimeVersion}`);
+    console.log();
+    const actions = [];
+    for (const f of files) {
+        const full = join(args.cwd, f.path);
+        if (existsSync(full) && !args.force) {
+            actions.push({ action: "SKIP", reason: "exists (pass --force to overwrite)", path: f.path });
+        }
+        else {
+            actions.push({ action: "WRITE", reason: "", path: f.path });
+        }
+    }
+    for (const a of actions) {
+        const tag = a.action === "WRITE" ? "WRITE" : "SKIP ";
+        console.log(`  ${tag}  ${a.path}${a.reason ? ` (${a.reason})` : ""}`);
+    }
+    console.log();
+    if (args.dryRun) {
+        console.log("--dry-run: no files written.");
+        return;
+    }
+    let written = 0;
+    let skipped = 0;
+    for (const f of files) {
+        const full = join(args.cwd, f.path);
+        if (existsSync(full) && !args.force) {
+            skipped += 1;
+            continue;
+        }
+        mkdirSync(dirname(full), { recursive: true });
+        writeFileSync(full, f.contents, "utf8");
+        written += 1;
+    }
+    console.log(`Done. Wrote ${written} file(s); skipped ${skipped}.`);
+    console.log();
+    console.log("Next steps:");
+    console.log("  1. cd mock && npm install");
+    console.log("  2. npm run dev   # http://localhost:3100");
+    console.log("  3. Verify the empty scenario picker renders");
+    console.log("  4. Commit + push the mock/ directory");
+    console.log("  5. Future vibe runs (slowcook 0.16-α.3+) populate mock/scenarios/ +");
+    console.log("     extend mock/src/lib/scenario-registry.ts");
+}
+/**
+ * The mock-runtime package versions track slowcook's overall release
+ * cadence. Until 0.16 final cuts we hardcode the latest known version
+ * here. After 0.16 the cli's package.json could carry a peer-pin field.
+ */
+function mockRuntimeVersionFor(_cliVersion) {
+    return "^0.1.1";
+}
+// ---------------- templates ----------------
+const PACKAGE_JSON = (runtimeVersion) => `{
+  "name": "${"$"}{REPO_NAME}-mock",
+  "version": "0.0.0",
+  "private": true,
+  "description": "Singular UI mock app. Run with \`npm run dev\` on :3100. See mock/README.md.",
+  "type": "module",
+  "scripts": {
+    "dev": "next dev -p 3100",
+    "build": "next build",
+    "start": "next start -p 3100",
+    "lint": "next lint"
+  },
+  "dependencies": {
+    "@slowcook-ai/mock-runtime": "${runtimeVersion}",
+    "next": "^16.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  "devDependencies": {
+    "@tailwindcss/postcss": "^4",
+    "@types/node": "^22",
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "tailwindcss": "^4",
+    "typescript": "^5"
+  }
+}
+`;
+const DOCKERFILE = `# Singular UI mock — runnable on the consumer's box per scenario.
+# Build (from repo root):   docker build -t mock -f mock/Dockerfile .
+# Run:                      docker run -p 3100:3100 mock
+# Open:                     http://localhost:3100/?scenario=story-N
+
+FROM node:20-alpine AS deps
+WORKDIR /app
+COPY mock/package.json mock/package-lock.json* ./
+RUN if [ -f package-lock.json ]; then npm ci; else npm install; fi
+
+FROM node:20-alpine AS builder
+WORKDIR /app
+COPY --from=deps /app/node_modules ./node_modules
+COPY mock ./
+RUN npm run build
+
+FROM node:20-alpine AS runner
+WORKDIR /app
+ENV NODE_ENV=production
+ENV PORT=3100
+ENV HOSTNAME=0.0.0.0
+COPY --from=builder /app/public ./public
+COPY --from=builder /app/.next ./.next
+COPY --from=builder /app/node_modules ./node_modules
+COPY --from=builder /app/package.json ./package.json
+EXPOSE 3100
+CMD ["npm", "run", "start"]
+`;
+const TSCONFIG = `{
+  "compilerOptions": {
+    "target": "ES2017",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "react-jsx",
+    "incremental": true,
+    "plugins": [{ "name": "next" }],
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["src/*"]
+    }
+  },
+  "include": ["next-env.d.ts", "src/**/*.ts", "src/**/*.tsx", "scenarios/**/*.ts", ".next/types/**/*.ts"],
+  "exclude": ["node_modules"]
+}
+`;
+const NEXT_CONFIG = `import { fileURLToPath } from "node:url";
+import { dirname } from "node:path";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+/** @type {import('next').NextConfig} */
+const nextConfig = {
+  reactStrictMode: true,
+  images: { unoptimized: true },
+  // Mock app lives inside the consumer's repo. Without an explicit
+  // turbopack root, Next walks up + treats the parent as the workspace
+  // root, which can pull the parent's src/ into the mock build. Pinning
+  // to this directory keeps the mock self-contained.
+  turbopack: { root: __dirname },
+  outputFileTracingRoot: __dirname,
+};
+
+export default nextConfig;
+`;
+const POSTCSS_CONFIG = `export default {
+  plugins: {
+    "@tailwindcss/postcss": {},
+  },
+};
+`;
+const GITIGNORE = `node_modules
+.next
+.turbo
+out
+.env*.local
+`;
+const MINIMAL_GLOBALS_CSS = `@import "tailwindcss";
+
+/*
+ * No src/app/globals.css was found at init time. This is a minimal
+ * Tailwind-v4 directives file. Add your project's tokens (CSS custom
+ * properties, @theme block) here so the mock matches production
+ * visually.
+ *
+ * Vibe + plate work best when this file mirrors production's tokens
+ * exactly — they steer toward existing token names, so the better the
+ * token coverage here the cleaner their output.
+ */
+
+:root {
+  --background: #ffffff;
+  --foreground: #1a1a1a;
+  --card-bg: #ffffff;
+  --card-border: rgba(26, 26, 26, 0.06);
+}
+
+@media (prefers-color-scheme: dark) {
+  :root {
+    --background: #0f0f18;
+    --foreground: #e8e8f0;
+    --card-bg: rgba(255, 255, 255, 0.03);
+    --card-border: rgba(255, 255, 255, 0.06);
+  }
+}
+
+@theme inline {
+  --color-background: var(--background);
+  --color-foreground: var(--foreground);
+  --color-card-bg: var(--card-bg);
+  --color-card-border: var(--card-border);
+}
+
+body {
+  background: var(--background);
+  color: var(--foreground);
+}
+`;
+const LAYOUT_TSX = `import type { Metadata } from "next";
+import type { ReactNode } from "react";
+import { ScenarioRegistryProvider } from "@slowcook-ai/mock-runtime";
+import { registry } from "@/lib/scenario-registry";
+import "./globals.css";
+
+export const metadata: Metadata = {
+  title: "mock",
+  description: "Singular mock app. Each ?scenario=story-N renders the UI with that story's fixture data.",
+};
+
+export default function RootLayout({ children }: { children: ReactNode }) {
+  return (
+    <html lang="en">
+      <body className="bg-background text-foreground antialiased">
+        <ScenarioRegistryProvider registry={registry}>
+          {children}
+          {/*
+            Review-overlay mount-point.
+              npm install @slowcook-ai/review-overlay
+              import { SlowcookReviewOverlay } from "@slowcook-ai/review-overlay/react";
+              <SlowcookReviewOverlay
+                enabled={process.env["NEXT_PUBLIC_SLOWCOOK_REVIEW"] === "1"}
+                owner={process.env["NEXT_PUBLIC_SLOWCOOK_OWNER"] ?? ""}
+                repo={process.env["NEXT_PUBLIC_SLOWCOOK_REPO"] ?? ""}
+                prNumber={parseInt(process.env["NEXT_PUBLIC_SLOWCOOK_PR_NUMBER"] ?? "0", 10)}
+                storyId={process.env["NEXT_PUBLIC_SLOWCOOK_STORY_ID"] ?? null}
+              />
+            Slowcook's preview-deploy workflow sets the env vars from the PR
+            context. Production builds keep NEXT_PUBLIC_SLOWCOOK_REVIEW unset
+            so the overlay tree-shakes out.
+          */}
+        </ScenarioRegistryProvider>
+      </body>
+    </html>
+  );
+}
+`;
+const PAGE_TSX = `import { ScenarioPicker } from "@slowcook-ai/mock-runtime";
+
+/**
+ * Mock app homepage = scenario picker (provided by the runtime).
+ *
+ * Replaces this with a custom picker if you want different grouping/
+ * filtering. The runtime's hooks + registry API are stable; this UI
+ * is a default that consumers can swap.
+ */
+export default function Page() {
+  return <ScenarioPicker />;
+}
+`;
+const SCENARIO_REGISTRY = `import { defineScenarios } from "@slowcook-ai/mock-runtime";
+
+/**
+ * The consumer-owned scenario registry.
+ *
+ * Vibe extends this when it adds a new scenario:
+ *   - one new \`import\` line for the scenario file
+ *   - one new entry in the \`defineScenarios([...])\` array
+ *
+ * Hand-edits are fine too — vibe + plate respect existing entries
+ * and only append.
+ */
+
+// Vibe-managed imports below this line. Don't reorder; vibe inserts
+// new lines at the bottom of the import block.
+// e.g. import story017 from "../../scenarios/story-017.js";
+
+export const registry = defineScenarios([
+  // story017,
+]);
+`;
+const README = `# \`mock/\` — singular UI mock app
+
+Per-consumer mock app, scaffolded by \`slowcook init mock\`. The runtime
+(scenario types + hooks + picker UI) ships via \`@slowcook-ai/mock-runtime\`;
+the bits in this directory are the consumer-owned shell.
+
+## Run it
+
+\`\`\`bash
+cd mock
+npm install
+npm run dev
+# → http://localhost:3100
+\`\`\`
+
+The homepage is the **scenario picker**. Each scenario maps to one
+story (or one flow within a story) — clicking a scenario navigates to
+that story's preferred initial path with \`?scenario=story-N\` set.
+
+## Architecture in one paragraph
+
+The mock is the **design contract**. Vibe writes scenarios for each
+story (\`mock/scenarios/story-N.ts\`); plate amends per PM feedback;
+PM reviews via the live mock URL on the consumer's box. After PM
+approves, brew copies the mock's components into \`src/\` and adds the
+real-data wiring. The mock + production stay in two separate
+filesystems; mock never touches \`src/\`, brew never touches \`mock/\`.
+
+The mock has NO backend. Scenarios are plain TypeScript modules read
+by React hooks. Mutations are local component state — they reset on
+page reload, which is the right behavior for a mockup (PM either keeps
+clicking or refreshes to start over).
+
+## Add a scenario by hand
+
+\`\`\`ts
+// mock/scenarios/story-017.ts
+import type { Scenario } from "@slowcook-ai/mock-runtime";
+
+const scenario: Scenario = {
+  id: "017",
+  name: "Owner with 3 pins, 8 reactions",
+  user: { id: "amin", handle: "amin", display_name: "Amin Azar" },
+  initialPath: "/u/amin",
+  fixtures: {
+    pins: [/* ... */],
+    reactions: [/* ... */],
+  },
+  expectedInteractions: [
+    "Click Pin on first reaction → strip prepends",
+    "Click Pinned on strip card → strip removes; reaction's Pin re-enables",
+  ],
+};
+
+export default scenario;
+\`\`\`
+
+Then add to the registry in \`mock/src/lib/scenario-registry.ts\`:
+
+\`\`\`ts
+import { defineScenarios } from "@slowcook-ai/mock-runtime";
+import story017 from "../../scenarios/story-017.js";
+
+export const registry = defineScenarios([story017]);
+\`\`\`
+
+Refresh the dev server — the scenario appears in the picker.
+
+## Use scenario data in a component
+
+\`\`\`tsx
+"use client";
+import { useScenarioFixture } from "@slowcook-ai/mock-runtime";
+
+interface Pin { id: string; rewo_id: string; pinned_at: string; }
+
+export function PinsStrip() {
+  const pins = useScenarioFixture<Pin[]>("pins");
+  return <div>{pins.map(p => /* ... */)}</div>;
+}
+\`\`\`
+
+The hook is a typed accessor over \`useScenario().fixtures[domain]\`.
+It throws a clear error in dev when the scenario doesn't have that
+domain populated.
+
+## Roadmap
+
+- \`@slowcook-ai/review-overlay\` package (slowcook 0.16-α.5) — adds
+  a floating toggle for nav-mode ↔ comment-mode; comments post to
+  the mockup PR with element selector + screenshot + viewport metadata
+- \`slowcook preview deploy\` (0.16-α.4) — SSH-deploys the docker
+  build to the consumer's box; preview URL posted to PR
+- \`slowcook port\` (0.16-α.7) — deterministic copy of mock components
+  → \`src/\` (mock + production stay separate filesystems)
+- Vibe + plate v2 (0.16-α.3 / α.6) — populate this directory based
+  on spec + PM feedback
+`;
+//# sourceMappingURL=mock.js.map

package/dist/commands/init/mock.js.map

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

package/dist/commands/plate/classify.d.ts

@@ -0,0 +1,65 @@
+/**
+ * PM-comment classifier — 0.16.0-α.7.
+ *
+ * Each element-anchored review-overlay comment on a slowcook-mockup PR
+ * gets categorized so plate knows what to do with it:
+ *
+ *   - "cosmetic"      → amend the mock with minimum diff
+ *   - "spec-altering" → ESCALATE: would invalidate a spec assertion or
+ *                       acceptance scenario; PM must confirm the spec
+ *                       change before plate touches the mock
+ *   - "mock-divergence" → the mock diverged from the spec; align mock
+ *                         to spec; note in summary why the PM ask is
+ *                         being interpreted this way
+ *
+ * α.7 ships a deterministic heuristic. Each classification has a clear
+ * rationale string so the escalation comment can quote the trigger.
+ *
+ * Heuristic structure:
+ *   1. Parse the spec YAML to extract the salient assertion targets:
+ *        - acceptance_scenarios prose lines
+ *        - api_contract response field names
+ *        - invariants prose
+ *        - ui_behavior viewport prose
+ *      → a flat set of "spec terms" (lowercased, normalized words).
+ *   2. Score the comment prose against those terms:
+ *        - any direct mention of an acceptance keyword phrase     → spec-altering
+ *        - mention of a domain noun + a "remove/change/replace"   → spec-altering
+ *        - mentions only adjective/style words (color, padding,   → cosmetic
+ *          font, spacing, alignment, shadow, etc.)
+ *        - else                                                   → mock-divergence
+ *
+ * The heuristic is intentionally conservative on spec-altering: false
+ * positives only cost a PM confirm round; false negatives let plate
+ * silently weaken the spec, which is the failure mode the architecture
+ * is designed to prevent. When in doubt → escalate.
+ *
+ * No LLM dep here — pure functions over inputs. LLM-backed classifier
+ * is a future α.7.1 upgrade if heuristic shows real misses.
+ */
+export type Classification = "cosmetic" | "spec-altering" | "mock-divergence";
+export interface ClassifyResult {
+    classification: Classification;
+    /** Why this classification — included verbatim in escalation comments. */
+    rationale: string;
+    /** The spec terms (if any) that matched in the comment prose. */
+    matchedSpecTerms: string[];
+}
+export interface ClassifyArgs {
+    /** Free prose written by the PM in the review-overlay comment. */
+    prose: string;
+    /**
+     * Spec YAML body. Hand-parsed for the assertion targets; we don't
+     * need a full YAML parser since the heuristic only needs salient
+     * words from acceptance_scenarios / invariants / api_contract.
+     */
+    specYaml: string;
+}
+export declare function classifyComment(args: ClassifyArgs): ClassifyResult;
+/**
+ * Extract candidate "spec terms" — lowercase, deduplicated significant
+ * tokens from the spec sections plate cares about. Used by the
+ * classifier to detect overlap between PM prose and spec assertions.
+ */
+export declare function extractSpecTerms(specYaml: string): string[];
+//# sourceMappingURL=classify.d.ts.map

package/dist/commands/plate/classify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify.d.ts","sourceRoot":"","sources":["../../../src/commands/plate/classify.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,eAAe,GAAG,iBAAiB,CAAC;AAE9E,MAAM,WAAW,cAAc;IAC7B,cAAc,EAAE,cAAc,CAAC;IAC/B,0EAA0E;IAC1E,SAAS,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AAyBD,MAAM,WAAW,YAAY;IAC3B,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,YAAY,GAAG,cAAc,CAgElE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAe3D"}