@slowcook-ai/cli 0.19.5 → 0.20.0

package/dist/help.js

@@ -0,0 +1,131 @@
+/**
+ * `packages/cli/src/help.ts` — render the command manifest into the
+ * two surfaces consumers see:
+ *
+ *  1. `slowcook help` — plain-text terminal output (what `cli.ts` emits)
+ *  2. README catalog block — markdown spliced into packages/cli/README.md
+ *
+ * Both come from `COMMANDS` in `./commands.manifest.ts`. Adding a
+ * command in one place updates both surfaces.
+ */
+import { visibleCommands, findCommand } from "./commands.manifest.js";
+const GROUP_ORDER = [
+    "pipeline",
+    "checks",
+    "plumbing",
+    "knowledge",
+    "ops",
+    "experimental",
+];
+const GROUP_LABELS = {
+    pipeline: "Pipeline (agent-driven)",
+    checks: "Checks + guards",
+    plumbing: "Setup + lifecycle plumbing",
+    knowledge: "Knowledge + accounting",
+    ops: "Ops (preview, dev-env, etc.)",
+    experimental: "Experimental",
+};
+function statusBadge(status) {
+    switch (status) {
+        case "alpha": return " [alpha]";
+        case "experimental": return " [experimental]";
+        case "deprecated": return " [DEPRECATED]";
+        case "stable":
+        case undefined:
+        default: return "";
+    }
+}
+function groupBy(cmds) {
+    const out = {
+        pipeline: [], checks: [], plumbing: [], knowledge: [], ops: [], experimental: [],
+    };
+    for (const c of cmds)
+        out[c.group].push(c);
+    return out;
+}
+/**
+ * Plain-text help block for `slowcook help`.
+ *
+ * Format (preserves the existing 0.19 shape — backward compat with any
+ * tool that greps `slowcook help` output):
+ *
+ *   slowcook — TDD-first agentic development harness
+ *
+ *   Usage:
+ *     <usage lines>
+ *
+ *   Commands available in <version>:
+ *     <name>  <description>
+ *
+ *   Docs: https://github.com/aminazar/slowcook
+ */
+export function renderHelp(version) {
+    const cmds = visibleCommands();
+    const usageLines = cmds.map((c) => `  ${c.usage}`).join("\n");
+    // Description block: align names in a column. Longest visible name width.
+    const nameWidth = Math.max(...cmds.map((c) => c.name.length)) + 2;
+    const descLines = cmds
+        .map((c) => `  ${c.name.padEnd(nameWidth)}${c.description}${statusBadge(c.status)}`)
+        .join("\n");
+    return `
+slowcook — TDD-first agentic development harness
+
+Usage:
+${usageLines}
+
+Commands available in ${version}:
+${descLines}
+
+For per-command details: slowcook help <command>   or   slowcook <command> --help
+
+Docs: https://github.com/aminazar/slowcook
+`;
+}
+/**
+ * Per-command help (shown by `slowcook help <cmd>` or future
+ * standardized `slowcook <cmd> --help` shims). Returns `undefined`
+ * if the name is unknown so the caller can decide on the fallback.
+ */
+export function renderCommandHelp(nameOrAlias) {
+    const cmd = findCommand(nameOrAlias);
+    if (!cmd)
+        return undefined;
+    const aliases = cmd.aliases?.length ? `\nAliases: ${cmd.aliases.join(", ")}` : "";
+    return `
+slowcook ${cmd.name}${statusBadge(cmd.status)}
+
+${cmd.description}
+
+Usage:
+  ${cmd.usage}${aliases}
+
+Group: ${GROUP_LABELS[cmd.group]}
+`;
+}
+/**
+ * Markdown catalog block spliced into packages/cli/README.md between
+ * `<!-- COMMANDS BLOCK BEGIN -->` and `<!-- COMMANDS BLOCK END -->` by
+ * `scripts/sync-readme-help.sh`.
+ *
+ * Grouped by `CommandGroup`; one bullet per command with name + usage
+ * + description. Hidden commands (version, help) excluded.
+ */
+export function renderReadmeBlock() {
+    const grouped = groupBy(visibleCommands());
+    const sections = [];
+    for (const g of GROUP_ORDER) {
+        const entries = grouped[g];
+        if (entries.length === 0)
+            continue;
+        sections.push(`### ${GROUP_LABELS[g]}\n`);
+        for (const c of entries) {
+            sections.push(`- **\`${c.name}\`**${statusBadge(c.status)} — ${c.description}`);
+            sections.push(`  \`\`\``);
+            sections.push(`  ${c.usage}`);
+            sections.push(`  \`\`\``);
+        }
+        sections.push("");
+    }
+    return sections.join("\n");
+}
+//# sourceMappingURL=help.js.map

package/dist/help.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@slowcook-ai/cli",
-  "version": "0.19.5",
+  "version": "0.20.0",
   "description": "CLI for the slowcook brewing harness",
   "license": "MIT",
   "author": "aminazar",
@@ -35,17 +35,19 @@
     "AGENTS.md"
   ],
   "dependencies": {
-    "@anthropic-ai/sdk": "^0.98.0",
+    "@anthropic-ai/sdk": "^0.100.1",
     "@octokit/rest": "^22.0.1",
+    "@playwright/test": "^1.40.0",
     "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.3",
-    "@slowcook-ai/llm-anthropic": "^0.16.3",
-    "@slowcook-ai/review-overlay": "^0.5.5",
-    "@slowcook-ai/recorder": "^0.9.1"
+    "@slowcook-ai/forge-github": "^0.13.0",
+    "@slowcook-ai/llm-anthropic": "^0.17.0",
+    "@slowcook-ai/recorder": "^0.9.1",
+    "@slowcook-ai/gates": "^0.11.0",
+    "@slowcook-ai/review-overlay": "^0.5.5"
   },
   "devDependencies": {
     "@types/node": "^25.9.1"