@slowcook-ai/cli 0.16.0-alpha.3 → 0.17.0-alpha.0

package/dist/commands/on-mockup-approved/index.js

@@ -0,0 +1,359 @@
+/**
+ * `slowcook on-mockup-approved --pr <number>` — 0.16.0-α.25.
+ *
+ * Called from a workflow that fires on `pull_request.labeled` with
+ * label = `slowcook-mockup-approved`. Walks every cost source for the
+ * story (refine on the source issue, refine + spec-merge on the spec
+ * PR, recipe on the tests PR, vibe + plate on the mockup PR), itemizes
+ * each run, and posts (or UPDATES) a cost-rollup audit comment on the
+ * originating GitHub issue.
+ *
+ * α.25 changes vs α.23:
+ *  - Walks ALL related sources, not just the mockup PR. Captures
+ *    refine + recipe runs that previously went uncounted.
+ *  - Itemizes each run (one row per cost marker) instead of grouping
+ *    by agent. Includes timestamp, agent, model, $, source link, and
+ *    commit SHA when available (parsed from plate's breadcrumb JSON).
+ *  - Idempotent: looks for an existing `slowcook:on-mockup-approved`
+ *    marker in the issue's comments; updates that comment in place
+ *    instead of double-posting.
+ *
+ * Pairs with on-spec-merged / on-tests-merged / on-brew-merged so the
+ * issue thread tells the full pipeline story end-to-end.
+ */
+import { execSync } from "node:child_process";
+import { readFileSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import YAML from "yaml";
+import { Octokit } from "@octokit/rest";
+function parseArgs(argv) {
+    const args = { prNumber: 0, repoRoot: process.cwd() };
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        const next = argv[i + 1];
+        if (arg === "--pr" && next) {
+            args.prNumber = parseInt(next, 10);
+            i++;
+        }
+        else if (arg === "--cwd" && next) {
+            args.repoRoot = next;
+            i++;
+        }
+        else if (arg === "--owner" && next) {
+            args.owner = next;
+            i++;
+        }
+        else if (arg === "--repo" && next) {
+            args.repo = next;
+            i++;
+        }
+        else if (arg === "--help" || arg === "-h") {
+            printHelp();
+            process.exit(0);
+        }
+    }
+    if (!args.prNumber || isNaN(args.prNumber)) {
+        console.error("Missing required --pr <number>");
+        printHelp();
+        process.exit(64);
+    }
+    return args;
+}
+function printHelp() {
+    console.log(`
+slowcook on-mockup-approved — post (or update) a cost rollup on the source issue
+
+Triggered by a workflow listening for pull_request.labeled events on
+PRs labeled \`slowcook-mockup\` when the \`slowcook-mockup-approved\`
+label is added. Walks every related source (issue, spec PR, tests PR,
+mockup PR), itemizes every cost marker, posts a chronological table.
+
+Idempotent: re-running updates the existing rollup comment on the
+issue rather than posting a new one.
+
+Usage:
+  slowcook on-mockup-approved --pr <number> [options]
+
+Options:
+  --pr <number>    Mockup PR number (required)
+  --cwd <path>     Repo working directory (default: .)
+  --owner <login>  Repo owner (default: detected from git remote)
+  --repo <name>    Repo name (default: detected from git remote)
+
+Environment:
+  GITHUB_TOKEN  (required)  Token with issues:write + pull-requests:read
+
+Exit codes:
+  0   comment posted/updated (or nothing to do)
+  2   script error
+`);
+}
+function detectOwnerRepo(cwd) {
+    try {
+        const url = execSync("git remote get-url origin", {
+            cwd,
+            encoding: "utf8",
+            stdio: ["ignore", "pipe", "ignore"],
+        }).trim();
+        const m = url.match(/github\.com[:/]([^/]+)\/([^/.]+)(?:\.git)?$/);
+        if (m && m[1] && m[2])
+            return { owner: m[1], repo: m[2] };
+    }
+    catch { /* ignore */ }
+    return null;
+}
+const COST_MARKER_RE = /<!--\s*slowcook:cost\s+([^>]+?)\s*-->/g;
+const ROLLUP_MARKER = "slowcook:on-mockup-approved";
+/** Parse `key1=value1 key2=value2` pairs from a cost-marker body. */
+function parseMarkerKvs(s) {
+    const out = {};
+    for (const m of s.matchAll(/(\w+)=([^\s]+)/g)) {
+        out[m[1]] = m[2];
+    }
+    return out;
+}
+/**
+ * 0.16.0-α.25 — legacy-prose fallback for vibe runs that pre-date α.24's
+ * structured `<!-- slowcook:cost -->` emission. Vibe ≤α.11 wrote
+ * "Generated by `slowcook vibe@VERSION` (spend $X.XXXX)" in its PR
+ * body. We pluck that out so dogfood rollups stay accurate.
+ */
+const VIBE_LEGACY_PROSE_RE = /Generated by `slowcook vibe@([^`]+)`[^(]*\(spend \$([0-9.]+)\)/;
+function extractCostRunsFromBody(body, source, timestamp) {
+    const out = [];
+    // Legacy prose vibe — only fires when no structured vibe marker
+    // also exists (so we don't double-count post-α.24 vibe runs).
+    if (!/slowcook:cost\s+agent=vibe/.test(body)) {
+        const proseMatch = body.match(VIBE_LEGACY_PROSE_RE);
+        if (proseMatch) {
+            const usd = parseFloat(proseMatch[2]);
+            if (!Number.isNaN(usd)) {
+                out.push({
+                    agent: "vibe",
+                    usd,
+                    cli: proseMatch[1],
+                    timestamp,
+                    source,
+                    commitSha: null,
+                });
+            }
+        }
+    }
+    COST_MARKER_RE.lastIndex = 0;
+    // For plate-reply breadcrumbs, look for the amendment_commit so we
+    // can link to the diff. Same comment body usually carries both
+    // markers (cost + breadcrumb).
+    let amendmentCommit = null;
+    const breadcrumbMatch = body.match(/slowcook:plate-reply\s*\n\s*(\{[\s\S]*?\})\s*\n\s*-->/);
+    if (breadcrumbMatch && breadcrumbMatch[1]) {
+        try {
+            const payload = JSON.parse(breadcrumbMatch[1]);
+            if (payload.amendment_commit)
+                amendmentCommit = payload.amendment_commit;
+        }
+        catch { /* ignore */ }
+    }
+    let m;
+    while ((m = COST_MARKER_RE.exec(body)) !== null) {
+        const kvs = parseMarkerKvs(m[1]);
+        const usd = parseFloat(kvs["usd"] ?? "0");
+        if (!kvs["agent"] || Number.isNaN(usd))
+            continue;
+        out.push({
+            agent: kvs["agent"],
+            usd,
+            model: kvs["model"],
+            cli: kvs["cli"],
+            timestamp,
+            source,
+            commitSha: amendmentCommit,
+        });
+    }
+    return out;
+}
+async function fetchPrComments(octokit, owner, repo, prNumber) {
+    return octokit.paginate(octokit.rest.issues.listComments, {
+        owner, repo, issue_number: prNumber, per_page: 100,
+    });
+}
+async function fetchIssueComments(octokit, owner, repo, issueNumber) {
+    return octokit.paginate(octokit.rest.issues.listComments, {
+        owner, repo, issue_number: issueNumber, per_page: 100,
+    });
+}
+async function findRelatedPrs(octokit, owner, repo, storyId) {
+    // Search PRs by title for `story-{id}`. Captures spec, tests,
+    // mockup, brew PRs all in one pass. Excludes superseded specs etc.
+    const q = `repo:${owner}/${repo} is:pr in:title story-${storyId}`;
+    const res = await octokit.rest.search.issuesAndPullRequests({ q, per_page: 50 });
+    const out = [];
+    for (const item of res.data.items) {
+        if (!item.pull_request)
+            continue;
+        const title = item.title.toLowerCase();
+        let kind;
+        if (title.startsWith("spec:"))
+            kind = "spec";
+        else if (title.startsWith("tests:") || title.startsWith("recipe:"))
+            kind = "tests";
+        else if (title.startsWith("mockup:"))
+            kind = "mockup";
+        else if (title.startsWith("brew") || title.startsWith("brew ("))
+            kind = "brew";
+        else
+            continue; // unknown — likely a manual PR; skip
+        out.push({
+            kind,
+            number: item.number,
+            url: item.html_url,
+            body: item.body,
+            bodyTimestamp: item.created_at,
+        });
+    }
+    return out;
+}
+export async function onMockupApproved(argv) {
+    const args = parseArgs(argv);
+    const token = process.env["GITHUB_TOKEN"];
+    if (!token) {
+        console.error("GITHUB_TOKEN environment variable is not set.");
+        process.exit(2);
+    }
+    let owner = args.owner;
+    let repo = args.repo;
+    if (!owner || !repo) {
+        const detected = detectOwnerRepo(args.repoRoot);
+        if (!detected) {
+            console.error("Could not detect owner/repo from git remote. Pass --owner and --repo.");
+            process.exit(2);
+        }
+        owner = owner ?? detected.owner;
+        repo = repo ?? detected.repo;
+    }
+    const octokit = new Octokit({ auth: token, userAgent: "slowcook-ai/cli" });
+    // 1. Fetch the mockup PR to get its head ref + verify shape.
+    const pr = await octokit.rest.pulls.get({ owner, repo, pull_number: args.prNumber });
+    const headRef = pr.data.head.ref;
+    const headRefMatch = headRef.match(/^slowcook\/mockup\/story-([\w-]+)$/);
+    if (!headRefMatch || !headRefMatch[1]) {
+        console.error(`PR #${args.prNumber} head ref "${headRef}" doesn't match slowcook/mockup/story-N. Skipping.`);
+        return;
+    }
+    const storyId = headRefMatch[1];
+    // 2. Read the spec to find source_issue.
+    const specPath = join(args.repoRoot, "specs", `story-${storyId}.yaml`);
+    if (!existsSync(specPath)) {
+        console.error(`Spec not found at ${specPath}; cannot resolve source_issue.`);
+        process.exit(0);
+    }
+    const spec = YAML.parse(readFileSync(specPath, "utf8"));
+    if (!spec.source_issue) {
+        console.log(`Spec story-${storyId} has no source_issue. Nothing to bill.`);
+        return;
+    }
+    const issueMatchYaml = spec.source_issue.match(/^#?(\d+)$/);
+    if (!issueMatchYaml || !issueMatchYaml[1]) {
+        console.error(`spec source_issue "${spec.source_issue}" not numeric.`);
+        process.exit(0);
+    }
+    const issueNumber = parseInt(issueMatchYaml[1], 10);
+    // 3. Walk every related source for cost markers.
+    const issue = await octokit.rest.issues.get({ owner, repo, issue_number: issueNumber });
+    const issueUrl = issue.data.html_url;
+    const allRuns = [];
+    // 3a. Issue body + comments (refine often posts here).
+    if (issue.data.body) {
+        allRuns.push(...extractCostRunsFromBody(issue.data.body, { kind: "issue", number: issueNumber, url: issueUrl }, issue.data.created_at));
+    }
+    const issueComments = await fetchIssueComments(octokit, owner, repo, issueNumber);
+    for (const c of issueComments) {
+        if (!c.body)
+            continue;
+        allRuns.push(...extractCostRunsFromBody(c.body, { kind: "issue", number: issueNumber, url: c.html_url ?? issueUrl }, c.created_at ?? ""));
+    }
+    // 3b. Every PR matching `story-{id}` in title (spec / tests / mockup / brew).
+    const relatedPrs = await findRelatedPrs(octokit, owner, repo, storyId);
+    for (const pr of relatedPrs) {
+        // PR body (vibe's initial cost lives here for the mockup PR).
+        if (pr.body) {
+            allRuns.push(...extractCostRunsFromBody(pr.body, { kind: pr.kind, number: pr.number, url: pr.url }, pr.bodyTimestamp ?? ""));
+        }
+        // PR comments.
+        const prComments = await fetchPrComments(octokit, owner, repo, pr.number);
+        for (const c of prComments) {
+            if (!c.body)
+                continue;
+            allRuns.push(...extractCostRunsFromBody(c.body, { kind: pr.kind, number: pr.number, url: c.html_url ?? pr.url }, c.created_at ?? ""));
+        }
+    }
+    // Sort chronologically.
+    allRuns.sort((a, b) => (a.timestamp || "").localeCompare(b.timestamp || ""));
+    // 4. Build the rollup body.
+    const total = allRuns.reduce((s, r) => s + r.usd, 0);
+    const totalsByAgent = new Map();
+    for (const r of allRuns) {
+        const t = totalsByAgent.get(r.agent) ?? { runs: 0, usd: 0 };
+        t.runs += 1;
+        t.usd += r.usd;
+        totalsByAgent.set(r.agent, t);
+    }
+    const lines = [];
+    lines.push(`### slowcook · mockup approved (story-${storyId})`);
+    lines.push("");
+    lines.push(`Mockup PR #${args.prNumber} signed off; \`slowcook-mockup-approved\` label applied. ` +
+        `Plate refuses further amendments. **Next**: merge the PR to fire \`brew --mode plate\` ` +
+        `(once the recipe-tests PR is also merged).`);
+    lines.push("");
+    // Itemized rollup — one row per cost marker.
+    lines.push(`#### Itemised runs (${allRuns.length})`);
+    lines.push("");
+    if (allRuns.length === 0) {
+        lines.push("_No cost markers found across this story's PRs + issue. (Likely a pre-α.24 vibe run that didn't emit the structured marker.)_");
+    }
+    else {
+        lines.push("| # | When | Agent | Model | Source | $ | Diff |");
+        lines.push("|--:|---|---|---|---|---:|---|");
+        let i = 1;
+        for (const r of allRuns) {
+            const when = r.timestamp ? new Date(r.timestamp).toISOString().slice(0, 16).replace("T", " ") : "—";
+            const sourceLabel = `${r.source.kind} #${r.source.number}`;
+            const sourceLink = `[${sourceLabel}](${r.source.url})`;
+            const diff = r.commitSha
+                ? `[\`${r.commitSha.slice(0, 7)}\`](https://github.com/${owner}/${repo}/commit/${r.commitSha})`
+                : "—";
+            lines.push(`| ${i} | ${when} | \`${r.agent}\` | ${r.model ? `\`${r.model}\`` : "—"} | ${sourceLink} | $${r.usd.toFixed(4)} | ${diff} |`);
+            i++;
+        }
+    }
+    lines.push("");
+    // Totals by agent.
+    lines.push(`#### Totals by agent`);
+    lines.push("");
+    lines.push("| Agent | Runs | $ |");
+    lines.push("|---|---:|---:|");
+    for (const [agent, t] of [...totalsByAgent.entries()].sort()) {
+        lines.push(`| \`${agent}\` | ${t.runs} | $${t.usd.toFixed(4)} |`);
+    }
+    lines.push(`| **Total so far** | **${allRuns.length}** | **$${total.toFixed(4)}** |`);
+    lines.push("");
+    lines.push(`_Post-merge brew run will add its own line; \`on-brew-merged\` updates this comment when that lands._`);
+    lines.push("");
+    lines.push(`<!-- ${ROLLUP_MARKER} pr=${args.prNumber} story=${storyId} usd=${total.toFixed(4)} runs=${allRuns.length} -->`);
+    const newBody = lines.join("\n");
+    // 5. Post or update the rollup comment on the source issue.
+    const existingComments = await fetchIssueComments(octokit, owner, repo, issueNumber);
+    const existing = existingComments.find((c) => (c.body ?? "").includes(ROLLUP_MARKER));
+    if (existing) {
+        await octokit.rest.issues.updateComment({
+            owner, repo, comment_id: existing.id, body: newBody,
+        });
+        console.log(`Updated existing rollup comment on issue #${issueNumber} (story-${storyId}, ${allRuns.length} runs / $${total.toFixed(4)} total).`);
+    }
+    else {
+        await octokit.rest.issues.createComment({
+            owner, repo, issue_number: issueNumber, body: newBody,
+        });
+        console.log(`Posted new rollup comment on issue #${issueNumber} (story-${storyId}, ${allRuns.length} runs / $${total.toFixed(4)} total).`);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/on-mockup-approved/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/on-mockup-approved/index.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"}

package/dist/commands/plate/classify.js

@@ -0,0 +1,194 @@
+/**
+ * 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.
+ */
+const COSMETIC_WORDS = [
+    "color", "colour", "shade", "tint", "hue", "rgb", "hex",
+    "padding", "margin", "spacing", "gap", "indent",
+    "font", "typeface", "weight", "italic", "underline",
+    "alignment", "align", "center", "centre", "left-aligned", "right-aligned",
+    "shadow", "border", "outline", "radius", "rounded",
+    "size", "smaller", "bigger", "larger", "tighter", "looser",
+    "background", "bg",
+    "icon", "emoji",
+    "feel", "vibe", "look",
+    "ratio", "scale",
+];
+const STRUCTURAL_VERBS = [
+    "remove", "removed", "delete", "deleted", "drop",
+    "replace", "swap", "switch",
+    "add", "introduce", "include",
+    "change", "rename",
+    "split", "merge", "combine",
+    "block", "prevent", "disallow",
+    "require", "enforce",
+];
+export function classifyComment(args) {
+    const proseNorm = normalize(args.prose);
+    const specTerms = extractSpecTerms(args.specYaml);
+    const matched = [];
+    for (const term of specTerms) {
+        if (proseNorm.includes(term))
+            matched.push(term);
+    }
+    const cosmeticHits = COSMETIC_WORDS.filter((w) => containsWord(proseNorm, w));
+    const structuralVerb = STRUCTURAL_VERBS.find((v) => containsWord(proseNorm, v));
+    // Rule 1 — spec term + structural verb → spec-altering. Highest
+    // priority; this is the failure mode we MUST escalate. "Remove the
+    // pinned strip" / "replace pinned with bookmarked" etc.
+    if (matched.length > 0 && structuralVerb) {
+        return {
+            classification: "spec-altering",
+            rationale: `Mentions spec term${matched.length > 1 ? "s" : ""} (${matched.slice(0, 5).map((m) => `"${m}"`).join(", ")}) ` +
+                `together with structural verb "${structuralVerb}". This would change the spec's contract; ` +
+                `PM must confirm before the mock changes.`,
+            matchedSpecTerms: matched,
+        };
+    }
+    // Rule 2 — cosmetic word present (with or without spec term, but
+    // no structural verb) → cosmetic. A PM saying "the Pinned button
+    // background should be coral" is naming the element AND asking for
+    // a style change; that's still cosmetic. Amend the mock with min diff.
+    if (cosmeticHits.length > 0) {
+        return {
+            classification: "cosmetic",
+            rationale: `Style-only feedback (matched: ${cosmeticHits.slice(0, 5).map((w) => `"${w}"`).join(", ")})` +
+                (matched.length > 0
+                    ? `; spec term${matched.length > 1 ? "s" : ""} (${matched.slice(0, 3).map((m) => `"${m}"`).join(", ")}) named the element but no structural verb present.`
+                    : `; no spec terms triggered.`),
+            matchedSpecTerms: matched,
+        };
+    }
+    // Rule 3 — spec terms with no cosmetic word and no structural verb
+    // → mock-divergence. The PM is talking about something the spec
+    // mentions but neither styling it nor changing the contract.
+    // Likely "mock shows X but spec says Y."
+    if (matched.length > 0) {
+        return {
+            classification: "mock-divergence",
+            rationale: `Mentions spec term${matched.length > 1 ? "s" : ""} (${matched.slice(0, 5).map((m) => `"${m}"`).join(", ")}) ` +
+                `without a structural verb or styling cue. Likely the mock diverged from spec; align mock to spec.`,
+            matchedSpecTerms: matched,
+        };
+    }
+    // Rule 4 — fallthrough. No signal in any direction. Default to
+    // mock-divergence so plate's LLM still gets the chance to reason
+    // about both spec + comment in context (false-positive cost is low).
+    return {
+        classification: "mock-divergence",
+        rationale: `No clear spec or style signal in the prose. Defaulting to mock-divergence so plate has a chance to reconcile against the spec.`,
+        matchedSpecTerms: [],
+    };
+}
+/**
+ * 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 function extractSpecTerms(specYaml) {
+    const sections = ["acceptance_scenarios", "invariants", "api_contract"];
+    const terms = new Set();
+    // Also include ui_behavior viewport prose — a comment about
+    // "remove the desktop_light pinned strip" is spec-altering.
+    for (const sec of [...sections, "ui_behavior"]) {
+        const body = extractYamlSection(specYaml, sec);
+        if (!body)
+            continue;
+        for (const tok of tokenize(body)) {
+            if (isStopword(tok))
+                continue;
+            if (tok.length < 4)
+                continue; // skip short noise
+            terms.add(tok);
+        }
+    }
+    return Array.from(terms);
+}
+function extractYamlSection(yaml, sectionName) {
+    // Find the line `sectionName:` at indent 0; capture indented body
+    // until the next zero-indent line.
+    const lines = yaml.split(/\r?\n/);
+    const out = [];
+    let inSection = false;
+    for (const raw of lines) {
+        const m = raw.match(/^(\s*)([a-zA-Z_][\w]*)\s*:/);
+        if (m && m[1].length === 0) {
+            if (m[2] === sectionName) {
+                inSection = true;
+                continue;
+            }
+            else if (inSection) {
+                // hit a sibling top-level key
+                break;
+            }
+        }
+        if (inSection)
+            out.push(raw);
+    }
+    return out.join("\n");
+}
+function normalize(s) {
+    return s.toLowerCase().replace(/\s+/g, " ").trim();
+}
+function tokenize(s) {
+    // Split on non-word; preserve underscores (snake_case identifiers)
+    return s
+        .toLowerCase()
+        .split(/[^a-z0-9_]+/)
+        .filter((w) => w.length > 0);
+}
+function containsWord(haystackNorm, needle) {
+    // Word-boundary check; needle is already lowercase.
+    const re = new RegExp(`(^|[^a-z0-9_])${escapeRe(needle)}([^a-z0-9_]|$)`);
+    return re.test(haystackNorm);
+}
+function escapeRe(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+const STOPWORDS = new Set([
+    "the", "a", "an", "and", "or", "but", "of", "in", "on", "at", "to", "for", "with", "by", "is", "are", "was", "were", "be", "been", "being", "have", "has", "had", "do", "does", "did", "this", "that", "these", "those", "it", "its", "as", "if", "then", "else", "when", "while", "each", "every", "any", "all", "not", "no", "yes", "true", "false", "null", "can", "will", "may", "must", "should", "would", "also", "only", "very", "more", "most", "such", "than", "into", "from", "over", "under", "between", "through", "because", "since", "once", "yaml", "example", "note", "todo", "null_", "status", "approved", "draft", "paused", "active",
+]);
+function isStopword(w) {
+    if (STOPWORDS.has(w))
+        return true;
+    // Pure-numeric tokens are noise
+    if (/^[0-9]+$/.test(w))
+        return true;
+    return false;
+}
+//# sourceMappingURL=classify.js.map

package/dist/commands/plate/classify.js.map

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