@slowcook-ai/cli 0.19.0-alpha.8 → 0.19.1

package/dist/lib/mock-shape.js

@@ -0,0 +1,77 @@
+/**
+ * 0.19.0+ (sc#82) — mock-shape detection.
+ *
+ * Reads `.brewing/mock.yaml` to tell downstream agents (vibe, plate,
+ * recon, port, run-mock) which mock shape the consumer is on. Defaults
+ * to `nextjs` when the file is absent — preserves backwards-compat with
+ * pre-sc#82 consumers whose mock predates the config.
+ *
+ * Single source of truth so every agent reads + writes consistent
+ * conventions: paths to screens, design-system dir, router file,
+ * scenario registry. Nothing else should hard-code these locations.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import YAML from "yaml";
+import { z } from "zod";
+const MockShapeConfigSchema = z.object({
+    schema_version: z.literal(1),
+    shape: z.enum(["vite", "nextjs"]),
+    mock_root: z.string().default("mock"),
+    screens_root: z.string().default("mock/src/apps"),
+    design_system_dir: z.string().default("mock/src/design-system"),
+    router_file: z.string().optional(),
+    scenarios_dir: z.string().default("mock/scenarios"),
+    scenario_registry_file: z.string().default("mock/src/lib/scenario-registry.ts"),
+});
+const NEXTJS_DEFAULT = {
+    schema_version: 1,
+    shape: "nextjs",
+    mock_root: "mock",
+    screens_root: "mock/src/app",
+    design_system_dir: "mock/src/design-system",
+    scenarios_dir: "mock/scenarios",
+    scenario_registry_file: "mock/src/lib/scenario-registry.ts",
+};
+const VITE_DEFAULT = {
+    schema_version: 1,
+    shape: "vite",
+    mock_root: "mock",
+    screens_root: "mock/src/apps",
+    design_system_dir: "mock/src/design-system",
+    router_file: "mock/src/App.tsx",
+    scenarios_dir: "mock/scenarios",
+    scenario_registry_file: "mock/src/lib/scenario-registry.ts",
+};
+/**
+ * Load `.brewing/mock.yaml`. Returns a default config when the file is
+ * absent (preserves backwards-compat with pre-sc#82 consumers). Throws
+ * on parse error / schema violation so a mis-authored config surfaces
+ * loudly rather than silently disabling features.
+ */
+export function loadMockShapeConfig(repoRoot) {
+    const p = join(repoRoot, ".brewing", "mock.yaml");
+    if (!existsSync(p)) {
+        // Heuristic fallback: if mock/src/app/ exists (Next.js convention),
+        // treat as nextjs. If mock/src/App.tsx exists (Vite convention),
+        // treat as vite. Otherwise nextjs for legacy safety.
+        const viteAppFile = join(repoRoot, "mock", "src", "App.tsx");
+        if (existsSync(viteAppFile))
+            return VITE_DEFAULT;
+        return NEXTJS_DEFAULT;
+    }
+    const raw = YAML.parse(readFileSync(p, "utf8"));
+    const parsed = MockShapeConfigSchema.safeParse(raw);
+    if (!parsed.success) {
+        throw new Error(`Invalid .brewing/mock.yaml: ${parsed.error.issues.map((i) => i.message).join("; ")}`);
+    }
+    return parsed.data;
+}
+/**
+ * Returns true when the consumer is on the Vite mock shape. Most
+ * agents only need this binary; full config is for path lookups.
+ */
+export function isViteMock(repoRoot) {
+    return loadMockShapeConfig(repoRoot).shape === "vite";
+}
+//# sourceMappingURL=mock-shape.js.map

package/dist/lib/mock-shape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-shape.js","sourceRoot":"","sources":["../../src/lib/mock-shape.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,cAAc,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5B,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACjC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;IACrC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,eAAe,CAAC;IACjD,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,wBAAwB,CAAC;IAC/D,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC;IACnD,sBAAsB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,mCAAmC,CAAC;CAChF,CAAC,CAAC;AAIH,MAAM,cAAc,GAAoB;IACtC,cAAc,EAAE,CAAC;IACjB,KAAK,EAAE,QAAQ;IACf,SAAS,EAAE,MAAM;IACjB,YAAY,EAAE,cAAc;IAC5B,iBAAiB,EAAE,wBAAwB;IAC3C,aAAa,EAAE,gBAAgB;IAC/B,sBAAsB,EAAE,mCAAmC;CAC5D,CAAC;AAEF,MAAM,YAAY,GAAoB;IACpC,cAAc,EAAE,CAAC;IACjB,KAAK,EAAE,MAAM;IACb,SAAS,EAAE,MAAM;IACjB,YAAY,EAAE,eAAe;IAC7B,iBAAiB,EAAE,wBAAwB;IAC3C,WAAW,EAAE,kBAAkB;IAC/B,aAAa,EAAE,gBAAgB;IAC/B,sBAAsB,EAAE,mCAAmC;CAC5D,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAgB;IAClD,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;IAClD,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;QACnB,oEAAoE;QACpE,iEAAiE;QACjE,qDAAqD;QACrD,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;QAC7D,IAAI,UAAU,CAAC,WAAW,CAAC;YAAE,OAAO,YAAY,CAAC;QACjD,OAAO,cAAc,CAAC;IACxB,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;IAChD,MAAM,MAAM,GAAG,qBAAqB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IACpD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CACb,+BAA+B,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACtF,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,QAAgB;IACzC,OAAO,mBAAmB,CAAC,QAAQ,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC;AACxD,CAAC"}

package/dist/lib/read-only.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 0.19.0-α.13 — single env-var knob for "don't write to the
+ * consumer's GitHub repo." Used when a slowcook maintainer (or
+ * anyone debugging) replays a slowcook command on someone else's
+ * repo — clones, checks out, runs the LLM, gets a verdict, but
+ * never commits / pushes / comments / labels / closes.
+ *
+ * This complements per-command `--dry-run` flags. A command's
+ * `--dry-run` typically gates SOME local writes (e.g., persisting
+ * a verdict file in `.brewing/`); SLOWCOOK_READ_ONLY gates remote
+ * writes specifically. Both can be set together.
+ *
+ * Pure: just inspects process.env. Tested in isolation.
+ */
+export declare function isReadOnlyMode(env?: NodeJS.ProcessEnv): boolean;
+/**
+ * Log-once wrapper: when read-only mode is on, print a single banner
+ * to stderr identifying the command. Idempotent: caller can call
+ * once at command entry; further log-once is the caller's job.
+ */
+export declare function logReadOnlyBanner(commandName: string): void;
+//# sourceMappingURL=read-only.d.ts.map

package/dist/lib/read-only.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-only.d.ts","sourceRoot":"","sources":["../../src/lib/read-only.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,wBAAgB,cAAc,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAO5E;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAI3D"}

package/dist/lib/read-only.js

@@ -0,0 +1,34 @@
+/**
+ * 0.19.0-α.13 — single env-var knob for "don't write to the
+ * consumer's GitHub repo." Used when a slowcook maintainer (or
+ * anyone debugging) replays a slowcook command on someone else's
+ * repo — clones, checks out, runs the LLM, gets a verdict, but
+ * never commits / pushes / comments / labels / closes.
+ *
+ * This complements per-command `--dry-run` flags. A command's
+ * `--dry-run` typically gates SOME local writes (e.g., persisting
+ * a verdict file in `.brewing/`); SLOWCOOK_READ_ONLY gates remote
+ * writes specifically. Both can be set together.
+ *
+ * Pure: just inspects process.env. Tested in isolation.
+ */
+export function isReadOnlyMode(env = process.env) {
+    const v = env["SLOWCOOK_READ_ONLY"];
+    if (typeof v !== "string")
+        return false;
+    // Truthy values: "1", "true", "yes" (case-insensitive). Anything
+    // else (including "0", "false", "") is OFF.
+    const norm = v.trim().toLowerCase();
+    return norm === "1" || norm === "true" || norm === "yes";
+}
+/**
+ * Log-once wrapper: when read-only mode is on, print a single banner
+ * to stderr identifying the command. Idempotent: caller can call
+ * once at command entry; further log-once is the caller's job.
+ */
+export function logReadOnlyBanner(commandName) {
+    if (isReadOnlyMode()) {
+        console.error(`  [SLOWCOOK_READ_ONLY=1] ${commandName} will skip GitHub writes (commits / pushes / comments / labels / closes).`);
+    }
+}
+//# sourceMappingURL=read-only.js.map

package/dist/lib/read-only.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-only.js","sourceRoot":"","sources":["../../src/lib/read-only.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,UAAU,cAAc,CAAC,MAAyB,OAAO,CAAC,GAAG;IACjE,MAAM,CAAC,GAAG,GAAG,CAAC,oBAAoB,CAAC,CAAC;IACpC,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACxC,iEAAiE;IACjE,4CAA4C;IAC5C,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACpC,OAAO,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,KAAK,CAAC;AAC3D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,WAAmB;IACnD,IAAI,cAAc,EAAE,EAAE,CAAC;QACrB,OAAO,CAAC,KAAK,CAAC,4BAA4B,WAAW,2EAA2E,CAAC,CAAC;IACpI,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@slowcook-ai/cli",
-  "version": "0.19.0-alpha.8",
+  "version": "0.19.1",
   "description": "CLI for the slowcook brewing harness",
   "license": "MIT",
   "author": "aminazar",
@@ -30,20 +30,25 @@
   "types": "./dist/cli.d.ts",
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "REPORTING.md",
+    "AGENTS.md"
   ],
   "dependencies": {
-    "@anthropic-ai/sdk": "^0.32.1",
-    "@octokit/rest": "^21.0.2",
-    "ts-morph": "^24.0.0",
-    "yaml": "^2.6.0",
-    "zod": "^3.23.8",
-    "@slowcook-ai/stack-ts": "^0.9.9-alpha.0",
+    "@anthropic-ai/sdk": "^0.98.0",
+    "@octokit/rest": "^22.0.1",
+    "ts-morph": "^28.0.0",
+    "yaml": "^2.9.0",
+    "zod": "^4.4.3",
+    "@slowcook-ai/core": "^0.14.0",
+    "@slowcook-ai/stack-ts": "^0.9.9",
+    "@slowcook-ai/forge-github": "^0.12.2",
     "@slowcook-ai/recorder": "^0.9.1",
-    "@slowcook-ai/llm-anthropic": "^0.16.0-alpha.1",
-    "@slowcook-ai/review-overlay": "^0.5.5",
-    "@slowcook-ai/core": "^0.13.0",
-    "@slowcook-ai/forge-github": "^0.12.0"
+    "@slowcook-ai/llm-anthropic": "^0.16.0",
+    "@slowcook-ai/review-overlay": "^0.5.5"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.1"
   },
   "publishConfig": {
     "access": "public"