@stcrft/statecraft 1.1.2

package/README.md

@@ -0,0 +1,43 @@
+# Statecraft CLI
+
+Validate and summarize Statecraft board files from the terminal.
+
+## Commands
+
+- **`statecraft validate [path]`** — Parse and validate a board file. Exits 0 if valid, 1 on parse or validation errors.
+- **`statecraft summarize [path]`** — Summarize a board. Prints a text summary to stdout.
+- **`statecraft render [path]`** — Serve the board UI in the browser. Starts a local server that serves the built renderer, `GET /api/board` (board file from disk), and a WebSocket for live updates when the file changes. Options: `--port 3000` (default), `--open` (open browser).
+
+## Path handling
+
+- **Single path only.** One board file per run. Passing multiple paths (e.g. `statecraft validate a.yaml b.yaml`) is not supported and will exit with an error.
+- **Default path:** If you omit the path, the CLI uses **`./board.yaml`** (relative to the current working directory).
+- **Relative vs absolute:** The path is relative to the current working directory unless you pass an absolute path. The core library resolves paths internally, so the CLI passes your argument through as-is.
+
+### Examples
+
+```bash
+# Validate the default board (./board.yaml)
+statecraft validate
+
+# Validate a specific file
+statecraft validate examples/board.yaml
+statecraft validate /path/to/board.yaml
+```
+
+## Development
+
+From the repo root:
+
+```bash
+pnpm build          # build all packages (required before `render` so renderer dist exists)
+pnpm cli validate   # run the CLI (uses workspace script)
+pnpm cli render --open   # serve board UI (opens browser)
+```
+
+Or from this package:
+
+```bash
+pnpm build
+node dist/index.js validate
+```

package/dist/index.js

@@ -0,0 +1,493 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { createRequire } from "module";
+import { Command } from "commander";
+
+// src/constants.ts
+var DEFAULT_BOARD_PATH = "./board.yaml";
+var DEFAULT_RENDER_PORT = 3e3;
+var RENDER_WATCH_DEBOUNCE_MS = 100;
+var INIT_DEFAULT_BOARD_PATH = "board.yaml";
+var INIT_DEFAULT_TASKS_DIR = "tasks";
+var CANONICAL_COLUMNS = ["Backlog", "Ready", "In Progress", "Done"];
+var SPEC_FILENAME = "spec.md";
+
+// src/executors/init.ts
+import fs from "fs";
+import path from "path";
+import readline from "readline";
+import { stringify } from "yaml";
+
+// src/executors/rule-content.ts
+function buildStatecraftRuleBody(boardPath, tasksDir) {
+  return `# Statecraft
+
+This project uses Statecraft for the task board.
+
+- **Board file:** \`${boardPath}\`
+- **Task spec files:** \`${tasksDir}/<task-id>.md\` (relative to board directory)
+- **Columns (canonical):** Backlog \u2192 Ready \u2192 In Progress \u2192 Done.
+
+## Commands
+
+- Get board format spec: \`statecraft spec\`
+- Validate board: \`statecraft validate ${boardPath}\`
+- View board in browser: \`statecraft render ${boardPath}\`
+
+## Task lifecycle (edit board and task files directly)
+
+- **Prepare for work:** When the task has a clear definition and dependencies are satisfied, set \`status\` to **Ready**.
+- **Start work:** Set the task's \`status\` to **In Progress**. Optionally open/read the task's \`spec\` file.
+- **Finish work:** Set the task's \`status\` to **Done** only when the task's acceptance criteria (in its spec file) are satisfied.
+- **Create task:** Add an entry under \`tasks\` with \`status: Backlog\` (id, title, optional description, spec, owner, priority, depends_on). If needed, create \`${tasksDir}/<task-id>.md\` with description and DoD.
+
+## AI guidelines for creating tickets
+
+- **Task naming:** kebab-case, verb or noun phrase (e.g. \`fix-auth-timeout\`).
+- **Description:** One line summary; optional markdown for context.
+- **Definition of Done:** Acceptance criteria in task spec; all checked before moving to Done.
+- **Task fields (from spec):** \`title\` (required), \`status\` (required), optional \`description\`, \`spec\` (path to .md), \`owner\`, \`priority\`, \`depends_on\`.
+- **Spec file:** Path relative to board directory, e.g. \`${tasksDir}/<task-id>.md\`.
+`;
+}
+
+// src/executors/init.ts
+function question(rl, prompt, defaultValue) {
+  const suffix = defaultValue !== void 0 ? ` (default: ${defaultValue})` : "";
+  return new Promise((resolve) => {
+    rl.question(`${prompt}${suffix}: `, (answer) => {
+      const trimmed = answer.trim();
+      resolve(trimmed !== "" ? trimmed : defaultValue ?? "");
+    });
+  });
+}
+async function getAnswer(rl, answers, index, prompt, defaultValue) {
+  if (answers !== void 0) {
+    const raw = answers[index.current++] ?? "";
+    const trimmed = raw.trim();
+    return trimmed !== "" ? trimmed : defaultValue ?? "";
+  }
+  return question(rl, prompt, defaultValue);
+}
+function parseWipLimit(wipStr) {
+  if (wipStr === "") return void 0;
+  const n = parseInt(wipStr, 10);
+  return Number.isInteger(n) && n >= 1 ? n : void 0;
+}
+async function collectInitAnswers(rl, answers, index) {
+  const boardName = await getAnswer(rl, answers, index, "Board name");
+  const boardPath = await getAnswer(rl, answers, index, "Path for board file", INIT_DEFAULT_BOARD_PATH);
+  const tasksDir = await getAnswer(
+    rl,
+    answers,
+    index,
+    "Directory for task .md files (relative to board)",
+    INIT_DEFAULT_TASKS_DIR
+  );
+  const wipStr = await getAnswer(
+    rl,
+    answers,
+    index,
+    "WIP limit for In Progress (optional, press Enter to skip)",
+    ""
+  );
+  const genCursor = await getAnswer(rl, answers, index, "Generate Cursor rule? (Y/n)", "Y");
+  const genClaude = await getAnswer(rl, answers, index, "Generate Claude Code rule? (y/n)", "n");
+  const genCodex = await getAnswer(rl, answers, index, "Generate Codex instructions (AGENTS.md)? (y/n)", "n");
+  return {
+    boardName,
+    boardPath,
+    tasksDir,
+    wipStr,
+    generateCursorRule: /^y(es)?$/i.test(genCursor.trim()),
+    generateClaudeRule: /^y(es)?$/i.test(genClaude.trim()),
+    generateCodexAgents: /^y(es)?$/i.test(genCodex.trim())
+  };
+}
+function buildBoardFromAnswers(boardName, tasksDir, wipStr) {
+  const inProgressLimit = parseWipLimit(wipStr);
+  const columns = [
+    CANONICAL_COLUMNS[0],
+    CANONICAL_COLUMNS[1],
+    inProgressLimit != null ? { name: CANONICAL_COLUMNS[2], limit: inProgressLimit } : CANONICAL_COLUMNS[2],
+    CANONICAL_COLUMNS[3]
+  ];
+  return {
+    board: boardName,
+    columns,
+    tasks: {}
+  };
+}
+function ensureDirAndWrite(filePath, content) {
+  const dir = path.dirname(filePath);
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { recursive: true });
+  }
+  fs.writeFileSync(filePath, content, "utf-8");
+}
+function writeBoardFile(cwd, boardPath, board) {
+  const absolutePath = path.resolve(cwd, boardPath);
+  const yamlContent = stringify(board, { lineWidth: 0 });
+  ensureDirAndWrite(absolutePath, yamlContent);
+}
+function writeRuleFile(filePath, content, log) {
+  ensureDirAndWrite(filePath, content);
+  log(filePath);
+}
+var CODECX_MARKER = "## Statecraft (generated by statecraft init)";
+function writeCursorRule(cwd, boardPath, specDir, log) {
+  const cursorRulesDir = path.resolve(cwd, ".cursor", "rules");
+  const cursorRulePath = path.join(cursorRulesDir, "statecraft.mdc");
+  const content = buildCursorRuleContent(boardPath, specDir);
+  writeRuleFile(cursorRulePath, content, (p) => log(`Wrote Cursor rule to ${p}`));
+}
+function writeClaudeRule(cwd, boardPath, specDir, log) {
+  const claudeRulesDir = path.resolve(cwd, ".claude", "rules");
+  const claudeRulePath = path.join(claudeRulesDir, "statecraft.md");
+  const content = buildClaudeRuleContent(boardPath, specDir);
+  writeRuleFile(claudeRulePath, content, (p) => log(`Wrote Claude Code rule to ${p}`));
+}
+function writeCodexRule(cwd, boardPath, specDir, log) {
+  const codexAgentsPath = path.resolve(cwd, "AGENTS.md");
+  const codexContent = buildCodexAgentsContent(boardPath, specDir);
+  if (fs.existsSync(codexAgentsPath)) {
+    const existing = fs.readFileSync(codexAgentsPath, "utf-8");
+    if (existing.includes(CODECX_MARKER)) {
+      log("AGENTS.md already contains Statecraft section; skipped.");
+      return;
+    }
+    fs.writeFileSync(codexAgentsPath, existing.trimEnd() + "\n\n" + codexContent + "\n", "utf-8");
+    log(`Appended Statecraft section to ${codexAgentsPath}`);
+  } else {
+    fs.writeFileSync(codexAgentsPath, codexContent + "\n", "utf-8");
+    log(`Wrote Codex instructions to ${codexAgentsPath}`);
+  }
+}
+function buildCursorRuleContent(boardPath, tasksDir) {
+  return `---
+description: Statecraft board and task workflow; when to update the board and how to create tasks
+alwaysApply: false
+---
+${buildStatecraftRuleBody(boardPath, tasksDir)}`;
+}
+function buildClaudeRuleContent(boardPath, tasksDir) {
+  return buildStatecraftRuleBody(boardPath, tasksDir);
+}
+function buildCodexAgentsContent(boardPath, tasksDir) {
+  return `## Statecraft (generated by statecraft init)
+
+${buildStatecraftRuleBody(boardPath, tasksDir)}`;
+}
+async function runInit(options) {
+  const answers = options?.answers;
+  const cwd = options?.cwd ?? process.cwd();
+  const answerIndex = { current: 0 };
+  const rl = answers === void 0 ? readline.createInterface({ input: process.stdin, output: process.stdout }) : null;
+  const log = (msg) => {
+    if (rl) process.stdout.write(msg + "\n");
+  };
+  try {
+    if (rl) {
+      process.stdout.write("\nStatecraft init \u2014 create your board and connect it to your workflow.\n\n");
+    }
+    const collected = await collectInitAnswers(rl, answers, answerIndex);
+    if (!collected.boardName) {
+      process.stderr.write("Board name is required.\n");
+      process.exitCode = 1;
+      return;
+    }
+    rl?.close();
+    const board = buildBoardFromAnswers(collected.boardName, collected.tasksDir, collected.wipStr);
+    writeBoardFile(cwd, collected.boardPath, board);
+    const absolutePath = path.resolve(cwd, collected.boardPath);
+    log(`
+Created board at ${absolutePath}`);
+    log(`Task spec files: ${path.join(path.dirname(collected.boardPath), collected.tasksDir)}/<task-id>.md`);
+    const specDir = path.join(path.dirname(collected.boardPath), collected.tasksDir);
+    if (collected.generateCursorRule) writeCursorRule(cwd, collected.boardPath, specDir, log);
+    if (collected.generateClaudeRule) writeClaudeRule(cwd, collected.boardPath, specDir, log);
+    if (collected.generateCodexAgents) writeCodexRule(cwd, collected.boardPath, specDir, log);
+    log("\nRun `statecraft validate " + collected.boardPath + "` to validate, or `statecraft render " + collected.boardPath + "` to view.");
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    process.stderr.write(message + "\n");
+    process.exitCode = 1;
+  } finally {
+    rl?.close();
+  }
+}
+
+// src/render-server.ts
+import express from "express";
+import fs2 from "fs";
+import path2 from "path";
+import { createServer } from "http";
+import { WebSocketServer } from "ws";
+import { fileURLToPath } from "url";
+var __dirname2 = path2.dirname(fileURLToPath(import.meta.url));
+function getRendererDistPath() {
+  return path2.resolve(__dirname2, "..", "..", "renderer", "dist");
+}
+function readBoardContent(boardPath) {
+  try {
+    const resolved = path2.resolve(process.cwd(), boardPath);
+    return fs2.readFileSync(resolved, "utf-8");
+  } catch {
+    return null;
+  }
+}
+function startRenderServer(options) {
+  const { boardPath, port = DEFAULT_RENDER_PORT, openBrowser = false } = options;
+  const rendererDist = getRendererDistPath();
+  if (!fs2.existsSync(rendererDist) || !fs2.statSync(rendererDist).isDirectory()) {
+    process.stderr.write(
+      "Renderer build not found. Run: pnpm build\n"
+    );
+    process.exitCode = 1;
+    return;
+  }
+  const app = express();
+  const resolvedBoardPath = path2.resolve(process.cwd(), boardPath);
+  const boardDir = path2.dirname(resolvedBoardPath);
+  app.get("/api/board", (_req, res) => {
+    const content = readBoardContent(boardPath);
+    if (content === null) {
+      res.status(404).type("text/plain").send("Board file not found or unreadable.");
+      return;
+    }
+    res.type("text/yaml").send(content);
+  });
+  app.get("/api/spec", (req, res) => {
+    const rawPath = typeof req.query.path === "string" ? req.query.path : "";
+    if (!rawPath || rawPath.includes("..")) {
+      res.status(400).type("text/plain").send("Invalid or missing path.");
+      return;
+    }
+    const ext = path2.extname(rawPath).toLowerCase();
+    if (ext !== ".md") {
+      res.status(400).type("text/plain").send("Only .md spec files are allowed.");
+      return;
+    }
+    const resolved = path2.resolve(boardDir, rawPath);
+    const relative = path2.relative(boardDir, resolved);
+    if (relative.startsWith("..") || path2.isAbsolute(relative)) {
+      res.status(400).type("text/plain").send("Path must be under board directory.");
+      return;
+    }
+    try {
+      const content = fs2.readFileSync(resolved, "utf-8");
+      res.type("text/markdown").send(content);
+    } catch {
+      res.status(404).type("text/plain").send("Spec file not found or unreadable.");
+    }
+  });
+  app.use(express.static(rendererDist));
+  app.use((_req, res, next) => {
+    if (_req.method !== "GET" || res.headersSent) return next();
+    const indexHtml = path2.join(rendererDist, "index.html");
+    if (fs2.existsSync(indexHtml)) {
+      res.sendFile(indexHtml);
+    } else {
+      res.status(404).send("Not found");
+    }
+  });
+  const server = createServer(app);
+  const wss = new WebSocketServer({ noServer: true });
+  server.on("upgrade", (request, socket, head) => {
+    const url = new URL(request.url ?? "", `http://${request.headers.host}`);
+    if (url.pathname === "/api/board/watch") {
+      wss.handleUpgrade(request, socket, head, (ws) => {
+        wss.emit("connection", ws, request);
+      });
+    } else {
+      socket.destroy();
+    }
+  });
+  let debounceTimer = null;
+  function broadcastBoard() {
+    const content = readBoardContent(boardPath);
+    const payload = content ?? "";
+    wss.clients.forEach((client) => {
+      if (client.readyState === 1) {
+        client.send(payload);
+      }
+    });
+  }
+  wss.on("connection", (ws) => {
+    const content = readBoardContent(boardPath);
+    if (content !== null) {
+      ws.send(content);
+    }
+  });
+  try {
+    fs2.watch(resolvedBoardPath, { persistent: false }, () => {
+      if (debounceTimer) clearTimeout(debounceTimer);
+      debounceTimer = setTimeout(() => {
+        debounceTimer = null;
+        broadcastBoard();
+      }, RENDER_WATCH_DEBOUNCE_MS);
+    });
+  } catch {
+  }
+  server.on("error", (err) => {
+    process.stderr.write(`Render server error: ${err.message}
+`);
+    if (err.code === "EADDRINUSE") {
+      process.stderr.write(`Port ${port} is in use. Try --port <number>.
+`);
+    }
+    process.exitCode = 1;
+  });
+  server.listen(port, () => {
+    const url = `http://localhost:${port}`;
+    process.stdout.write(`Open ${url}
+`);
+    if (openBrowser) {
+      import("open").then(({ default: open }) => {
+        open(url).catch(() => {
+        });
+      });
+    }
+  });
+  const shutdown = () => {
+    server.close(() => {
+      process.exit(process.exitCode ?? 0);
+    });
+  };
+  process.on("SIGINT", shutdown);
+  process.on("SIGTERM", shutdown);
+}
+
+// src/executors/render.ts
+function runRender(path5, options) {
+  startRenderServer({
+    boardPath: path5,
+    port: options.port,
+    openBrowser: options.open
+  });
+}
+
+// src/executors/spec.ts
+import fs4 from "fs";
+import path4 from "path";
+import { fileURLToPath as fileURLToPath2 } from "url";
+
+// src/utils.ts
+import fs3 from "fs";
+import path3 from "path";
+function findPackageRoot(startDir) {
+  let dir = path3.resolve(startDir);
+  for (; ; ) {
+    const pkgPath = path3.join(dir, "package.json");
+    if (fs3.existsSync(pkgPath)) return dir;
+    const parent = path3.dirname(dir);
+    if (parent === dir) return null;
+    dir = parent;
+  }
+}
+
+// src/executors/spec.ts
+function runSpec() {
+  const thisFile = fileURLToPath2(import.meta.url);
+  const startDir = path4.dirname(thisFile);
+  const packageRoot = findPackageRoot(startDir);
+  if (!packageRoot) {
+    process.stderr.write("statecraft spec: could not find package root\n");
+    process.exitCode = 1;
+    return;
+  }
+  const specPath = path4.join(packageRoot, SPEC_FILENAME);
+  if (!fs4.existsSync(specPath)) {
+    process.stderr.write(`statecraft spec: spec file not found at ${specPath}
+`);
+    process.exitCode = 1;
+    return;
+  }
+  try {
+    const content = fs4.readFileSync(specPath, "utf-8");
+    process.stdout.write(content);
+    if (!content.endsWith("\n")) process.stdout.write("\n");
+    process.exitCode = 0;
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    process.stderr.write(`statecraft spec: ${message}
+`);
+    process.exitCode = 1;
+  }
+}
+
+// src/executors/summarize.ts
+import { parseBoard, summarize } from "@stcrft/statecraft-core";
+function runSummarize(path5) {
+  try {
+    const board = parseBoard(path5);
+    const summary = summarize(board);
+    process.stdout.write(summary);
+    process.exitCode = 0;
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    process.stderr.write(message + "\n");
+    process.exitCode = 1;
+  }
+}
+
+// src/executors/validate.ts
+import { parseBoard as parseBoard2, validate } from "@stcrft/statecraft-core";
+function formatValidationError(err) {
+  const prefix = err.path != null && err.path !== "" ? `${err.path}: ` : "";
+  return `${prefix}${err.message}`;
+}
+function runValidate(path5) {
+  try {
+    const board = parseBoard2(path5);
+    const result = validate(board);
+    if (!result.valid) {
+      for (const err of result.errors) {
+        process.stderr.write(formatValidationError(err) + "\n");
+      }
+      process.exitCode = 1;
+      return;
+    }
+    process.exitCode = 0;
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    process.stderr.write(message + "\n");
+    process.exitCode = 1;
+  }
+}
+
+// src/index.ts
+var require2 = createRequire(import.meta.url);
+var { version } = require2("../package.json");
+function rejectMultiplePaths(extra) {
+  if (extra.length > 0) {
+    process.stderr.write("Only one board file per run. Multiple paths are not supported.\n");
+    process.exitCode = 1;
+  }
+}
+var program = new Command();
+program.name("statecraft").description("Validate, summarize, and render Statecraft board files").version(version);
+program.command("init").description("Interactive setup: create board and configure Statecraft for your workflow").action(async () => {
+  await runInit().catch((err) => {
+    process.stderr.write(err instanceof Error ? err.message : String(err) + "\n");
+    process.exitCode = 1;
+  });
+});
+program.command("spec").description("Print the board format spec (for AI agents)").action(() => {
+  runSpec();
+});
+program.command("validate").description("Validate a board file (exit 0 if valid, 1 on errors)").argument("[path]", "path to board file", DEFAULT_BOARD_PATH).argument("[extra...]", "ignored (only one path allowed)").action((path5, extra) => {
+  rejectMultiplePaths(extra);
+  if (process.exitCode !== 1) runValidate(path5);
+});
+program.command("summarize").description("Print a short text summary of the board").argument("[path]", "path to board file", DEFAULT_BOARD_PATH).argument("[extra...]", "ignored (only one path allowed)").action((path5, extra) => {
+  rejectMultiplePaths(extra);
+  if (process.exitCode !== 1) runSummarize(path5);
+});
+program.command("render").description("Serve the board in the browser (read-only UI)").argument("[path]", "path to board file", DEFAULT_BOARD_PATH).option("-p, --port <number>", "port for the server", String(DEFAULT_RENDER_PORT)).option("--open", "open browser after starting server").action((path5, options) => {
+  const port = parseInt(options.port, 10) || DEFAULT_RENDER_PORT;
+  runRender(path5, { port, open: options.open ?? false });
+});
+program.parseAsync();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/constants.ts","../src/executors/init.ts","../src/executors/rule-content.ts","../src/render-server.ts","../src/executors/render.ts","../src/executors/spec.ts","../src/utils.ts","../src/executors/summarize.ts","../src/executors/validate.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { createRequire } from \"node:module\";\nimport { Command } from \"commander\";\nimport { DEFAULT_BOARD_PATH, DEFAULT_RENDER_PORT } from \"./constants.js\";\nimport { runInit, runRender, runSpec, runSummarize, runValidate } from \"./executors/index.js\";\n\nconst require = createRequire(import.meta.url);\nconst { version } = require(\"../package.json\") as { version: string };\n\nfunction rejectMultiplePaths(extra: string[]): void {\n  if (extra.length > 0) {\n    process.stderr.write(\"Only one board file per run. Multiple paths are not supported.\\n\");\n    process.exitCode = 1;\n  }\n}\n\nconst program = new Command();\n\nprogram\n  .name(\"statecraft\")\n  .description(\"Validate, summarize, and render Statecraft board files\")\n  .version(version);\n\nprogram\n  .command(\"init\")\n  .description(\"Interactive setup: create board and configure Statecraft for your workflow\")\n  .action(async () => {\n    await runInit().catch((err) => {\n      process.stderr.write(err instanceof Error ? err.message : String(err) + \"\\n\");\n      process.exitCode = 1;\n    });\n  });\n\nprogram\n  .command(\"spec\")\n  .description(\"Print the board format spec (for AI agents)\")\n  .action(() => {\n    runSpec();\n  });\n\nprogram\n  .command(\"validate\")\n  .description(\"Validate a board file (exit 0 if valid, 1 on errors)\")\n  .argument(\"[path]\", \"path to board file\", DEFAULT_BOARD_PATH)\n  .argument(\"[extra...]\", \"ignored (only one path allowed)\")\n  .action((path: string, extra: string[]) => {\n    rejectMultiplePaths(extra);\n    if (process.exitCode !== 1) runValidate(path);\n  });\n\nprogram\n  .command(\"summarize\")\n  .description(\"Print a short text summary of the board\")\n  .argument(\"[path]\", \"path to board file\", DEFAULT_BOARD_PATH)\n  .argument(\"[extra...]\", \"ignored (only one path allowed)\")\n  .action((path: string, extra: string[]) => {\n    rejectMultiplePaths(extra);\n    if (process.exitCode !== 1) runSummarize(path);\n  });\n\nprogram\n  .command(\"render\")\n  .description(\"Serve the board in the browser (read-only UI)\")\n  .argument(\"[path]\", \"path to board file\", DEFAULT_BOARD_PATH)\n  .option(\"-p, --port <number>\", \"port for the server\", String(DEFAULT_RENDER_PORT))\n  .option(\"--open\", \"open browser after starting server\")\n  .action((path: string, options: { port: string; open: boolean }) => {\n    const port = parseInt(options.port, 10) || DEFAULT_RENDER_PORT;\n    runRender(path, { port, open: options.open ?? false });\n  });\n\nprogram.parseAsync();\n","/** Default path to the board file when none is given (validate, summarize, render). */\nexport const DEFAULT_BOARD_PATH = \"./board.yaml\";\n\n/** Default port for the render server. */\nexport const DEFAULT_RENDER_PORT = 3000;\n\n/** Debounce delay (ms) for file watcher before broadcasting board updates to WebSocket clients. */\nexport const RENDER_WATCH_DEBOUNCE_MS = 100;\n\n/** Default board file path offered by init (cwd). */\nexport const INIT_DEFAULT_BOARD_PATH = \"board.yaml\";\n\n/** Default directory for task .md files (relative to board), offered by init. */\nexport const INIT_DEFAULT_TASKS_DIR = \"tasks\";\n\n/** Canonical column set per spec; init creates boards with these columns. */\nexport const CANONICAL_COLUMNS = [\"Backlog\", \"Ready\", \"In Progress\", \"Done\"] as const;\n\n/** Filename of the board format spec shipped with the CLI package (statecraft spec). */\nexport const SPEC_FILENAME = \"spec.md\";\n","import fs from \"node:fs\";\nimport path from \"node:path\";\nimport readline from \"node:readline\";\nimport { stringify } from \"yaml\";\nimport {\n  CANONICAL_COLUMNS,\n  INIT_DEFAULT_BOARD_PATH,\n  INIT_DEFAULT_TASKS_DIR,\n} from \"../constants.js\";\nimport { buildStatecraftRuleBody } from \"./rule-content.js\";\n\nexport interface InitAnswers {\n  boardName: string;\n  columns: Array<{ name: string; limit?: number }>;\n  boardPath: string;\n  tasksDir: string;\n}\n\n/** Raw answers collected from prompts (before parsing WIP or booleans). */\ninterface CollectedInitAnswers {\n  boardName: string;\n  boardPath: string;\n  tasksDir: string;\n  wipStr: string;\n  generateCursorRule: boolean;\n  generateClaudeRule: boolean;\n  generateCodexAgents: boolean;\n}\n\nfunction question(rl: readline.Interface, prompt: string, defaultValue?: string): Promise<string> {\n  const suffix = defaultValue !== undefined ? ` (default: ${defaultValue})` : \"\";\n  return new Promise((resolve) => {\n    rl.question(`${prompt}${suffix}: `, (answer) => {\n      const trimmed = answer.trim();\n      resolve(trimmed !== \"\" ? trimmed : (defaultValue ?? \"\"));\n    });\n  });\n}\n\nasync function getAnswer(\n  rl: readline.Interface | null,\n  answers: string[] | undefined,\n  index: { current: number },\n  prompt: string,\n  defaultValue?: string\n): Promise<string> {\n  if (answers !== undefined) {\n    const raw = answers[index.current++] ?? \"\";\n    const trimmed = raw.trim();\n    return trimmed !== \"\" ? trimmed : (defaultValue ?? \"\");\n  }\n  return question(rl!, prompt, defaultValue);\n}\n\nfunction parseWipLimit(wipStr: string): number | undefined {\n  if (wipStr === \"\") return undefined;\n  const n = parseInt(wipStr, 10);\n  return Number.isInteger(n) && n >= 1 ? n : undefined;\n}\n\n/** Collect all init prompts into a structured object. */\nasync function collectInitAnswers(\n  rl: readline.Interface | null,\n  answers: string[] | undefined,\n  index: { current: number }\n): Promise<CollectedInitAnswers> {\n  const boardName = await getAnswer(rl, answers, index, \"Board name\");\n  const boardPath = await getAnswer(rl, answers, index, \"Path for board file\", INIT_DEFAULT_BOARD_PATH);\n  const tasksDir = await getAnswer(\n    rl,\n    answers,\n    index,\n    \"Directory for task .md files (relative to board)\",\n    INIT_DEFAULT_TASKS_DIR\n  );\n  const wipStr = await getAnswer(\n    rl,\n    answers,\n    index,\n    \"WIP limit for In Progress (optional, press Enter to skip)\",\n    \"\"\n  );\n  const genCursor = await getAnswer(rl, answers, index, \"Generate Cursor rule? (Y/n)\", \"Y\");\n  const genClaude = await getAnswer(rl, answers, index, \"Generate Claude Code rule? (y/n)\", \"n\");\n  const genCodex = await getAnswer(rl, answers, index, \"Generate Codex instructions (AGENTS.md)? (y/n)\", \"n\");\n\n  return {\n    boardName,\n    boardPath,\n    tasksDir,\n    wipStr,\n    generateCursorRule: /^y(es)?$/i.test(genCursor.trim()),\n    generateClaudeRule: /^y(es)?$/i.test(genClaude.trim()),\n    generateCodexAgents: /^y(es)?$/i.test(genCodex.trim()),\n  };\n}\n\n/** Build the board object (name, columns, empty tasks) from collected answers. */\nfunction buildBoardFromAnswers(\n  boardName: string,\n  tasksDir: string,\n  wipStr: string\n): { board: string; columns: Array<string | { name: string; limit: number }>; tasks: Record<string, never> } {\n  const inProgressLimit = parseWipLimit(wipStr);\n  const columns: Array<string | { name: string; limit: number }> = [\n    CANONICAL_COLUMNS[0],\n    CANONICAL_COLUMNS[1],\n    inProgressLimit != null ? { name: CANONICAL_COLUMNS[2], limit: inProgressLimit } : CANONICAL_COLUMNS[2],\n    CANONICAL_COLUMNS[3],\n  ];\n  return {\n    board: boardName,\n    columns,\n    tasks: {},\n  };\n}\n\n/** Ensure parent directory exists and write file. */\nfunction ensureDirAndWrite(filePath: string, content: string): void {\n  const dir = path.dirname(filePath);\n  if (!fs.existsSync(dir)) {\n    fs.mkdirSync(dir, { recursive: true });\n  }\n  fs.writeFileSync(filePath, content, \"utf-8\");\n}\n\n/** Write board YAML to cwd-relative path. */\nfunction writeBoardFile(\n  cwd: string,\n  boardPath: string,\n  board: { board: string; columns: unknown[]; tasks: object }\n): void {\n  const absolutePath = path.resolve(cwd, boardPath);\n  const yamlContent = stringify(board, { lineWidth: 0 });\n  ensureDirAndWrite(absolutePath, yamlContent);\n}\n\n/** Write a rule file and optionally log. */\nfunction writeRuleFile(\n  filePath: string,\n  content: string,\n  log: (msg: string) => void\n): void {\n  ensureDirAndWrite(filePath, content);\n  log(filePath);\n}\n\nconst CODECX_MARKER = \"## Statecraft (generated by statecraft init)\";\n\nfunction writeCursorRule(cwd: string, boardPath: string, specDir: string, log: (msg: string) => void): void {\n  const cursorRulesDir = path.resolve(cwd, \".cursor\", \"rules\");\n  const cursorRulePath = path.join(cursorRulesDir, \"statecraft.mdc\");\n  const content = buildCursorRuleContent(boardPath, specDir);\n  writeRuleFile(cursorRulePath, content, (p) => log(`Wrote Cursor rule to ${p}`));\n}\n\nfunction writeClaudeRule(cwd: string, boardPath: string, specDir: string, log: (msg: string) => void): void {\n  const claudeRulesDir = path.resolve(cwd, \".claude\", \"rules\");\n  const claudeRulePath = path.join(claudeRulesDir, \"statecraft.md\");\n  const content = buildClaudeRuleContent(boardPath, specDir);\n  writeRuleFile(claudeRulePath, content, (p) => log(`Wrote Claude Code rule to ${p}`));\n}\n\nfunction writeCodexRule(cwd: string, boardPath: string, specDir: string, log: (msg: string) => void): void {\n  const codexAgentsPath = path.resolve(cwd, \"AGENTS.md\");\n  const codexContent = buildCodexAgentsContent(boardPath, specDir);\n  if (fs.existsSync(codexAgentsPath)) {\n    const existing = fs.readFileSync(codexAgentsPath, \"utf-8\");\n    if (existing.includes(CODECX_MARKER)) {\n      log(\"AGENTS.md already contains Statecraft section; skipped.\");\n      return;\n    }\n    fs.writeFileSync(codexAgentsPath, existing.trimEnd() + \"\\n\\n\" + codexContent + \"\\n\", \"utf-8\");\n    log(`Appended Statecraft section to ${codexAgentsPath}`);\n  } else {\n    fs.writeFileSync(codexAgentsPath, codexContent + \"\\n\", \"utf-8\");\n    log(`Wrote Codex instructions to ${codexAgentsPath}`);\n  }\n}\n\n// --- Public rule content builders (used by init and by tests) ---\n\nexport function buildCursorRuleContent(boardPath: string, tasksDir: string): string {\n  return `---\ndescription: Statecraft board and task workflow; when to update the board and how to create tasks\nalwaysApply: false\n---\n${buildStatecraftRuleBody(boardPath, tasksDir)}`;\n}\n\n/** Claude Code: modular rule in .claude/rules/ (markdown, no frontmatter). */\nexport function buildClaudeRuleContent(boardPath: string, tasksDir: string): string {\n  return buildStatecraftRuleBody(boardPath, tasksDir);\n}\n\n/** Codex: section for AGENTS.md at project root. */\nexport function buildCodexAgentsContent(boardPath: string, tasksDir: string): string {\n  return `## Statecraft (generated by statecraft init)\n\n${buildStatecraftRuleBody(boardPath, tasksDir)}`;\n}\n\n// --- runInit ---\n\nexport interface RunInitOptions {\n  /** For tests: pre-filled answers (board name, board path, tasks dir, WIP, Cursor y/n, Claude y/n, Codex y/n). */\n  answers?: string[];\n  /** For tests: working directory for writing board and rule files (default: process.cwd()). */\n  cwd?: string;\n}\n\nexport async function runInit(options?: RunInitOptions): Promise<void> {\n  const answers = options?.answers;\n  const cwd = options?.cwd ?? process.cwd();\n  const answerIndex = { current: 0 };\n  const rl = answers === undefined ? readline.createInterface({ input: process.stdin, output: process.stdout }) : null;\n  const log = (msg: string) => {\n    if (rl) process.stdout.write(msg + \"\\n\");\n  };\n\n  try {\n    if (rl) {\n      process.stdout.write(\"\\nStatecraft init — create your board and connect it to your workflow.\\n\\n\");\n    }\n\n    const collected = await collectInitAnswers(rl, answers, answerIndex);\n    if (!collected.boardName) {\n      process.stderr.write(\"Board name is required.\\n\");\n      process.exitCode = 1;\n      return;\n    }\n\n    rl?.close();\n\n    const board = buildBoardFromAnswers(collected.boardName, collected.tasksDir, collected.wipStr);\n    writeBoardFile(cwd, collected.boardPath, board);\n\n    const absolutePath = path.resolve(cwd, collected.boardPath);\n    log(`\\nCreated board at ${absolutePath}`);\n    log(`Task spec files: ${path.join(path.dirname(collected.boardPath), collected.tasksDir)}/<task-id>.md`);\n\n    const specDir = path.join(path.dirname(collected.boardPath), collected.tasksDir);\n\n    if (collected.generateCursorRule) writeCursorRule(cwd, collected.boardPath, specDir, log);\n    if (collected.generateClaudeRule) writeClaudeRule(cwd, collected.boardPath, specDir, log);\n    if (collected.generateCodexAgents) writeCodexRule(cwd, collected.boardPath, specDir, log);\n\n    log(\"\\nRun `statecraft validate \" + collected.boardPath + \"` to validate, or `statecraft render \" + collected.boardPath + \"` to view.\");\n  } catch (err) {\n    const message = err instanceof Error ? err.message : String(err);\n    process.stderr.write(message + \"\\n\");\n    process.exitCode = 1;\n  } finally {\n    rl?.close();\n  }\n}\n","/**\n * Shared content for generated AI rules (Cursor, Claude Code, Codex).\n * Single source for the Statecraft rule body so init only orchestrates.\n */\n\nexport function buildStatecraftRuleBody(boardPath: string, tasksDir: string): string {\n  return `# Statecraft\n\nThis project uses Statecraft for the task board.\n\n- **Board file:** \\`${boardPath}\\`\n- **Task spec files:** \\`${tasksDir}/<task-id>.md\\` (relative to board directory)\n- **Columns (canonical):** Backlog → Ready → In Progress → Done.\n\n## Commands\n\n- Get board format spec: \\`statecraft spec\\`\n- Validate board: \\`statecraft validate ${boardPath}\\`\n- View board in browser: \\`statecraft render ${boardPath}\\`\n\n## Task lifecycle (edit board and task files directly)\n\n- **Prepare for work:** When the task has a clear definition and dependencies are satisfied, set \\`status\\` to **Ready**.\n- **Start work:** Set the task's \\`status\\` to **In Progress**. Optionally open/read the task's \\`spec\\` file.\n- **Finish work:** Set the task's \\`status\\` to **Done** only when the task's acceptance criteria (in its spec file) are satisfied.\n- **Create task:** Add an entry under \\`tasks\\` with \\`status: Backlog\\` (id, title, optional description, spec, owner, priority, depends_on). If needed, create \\`${tasksDir}/<task-id>.md\\` with description and DoD.\n\n## AI guidelines for creating tickets\n\n- **Task naming:** kebab-case, verb or noun phrase (e.g. \\`fix-auth-timeout\\`).\n- **Description:** One line summary; optional markdown for context.\n- **Definition of Done:** Acceptance criteria in task spec; all checked before moving to Done.\n- **Task fields (from spec):** \\`title\\` (required), \\`status\\` (required), optional \\`description\\`, \\`spec\\` (path to .md), \\`owner\\`, \\`priority\\`, \\`depends_on\\`.\n- **Spec file:** Path relative to board directory, e.g. \\`${tasksDir}/<task-id>.md\\`.\n`;\n}\n","import express, { type Request, type Response } from \"express\";\nimport fs from \"node:fs\";\nimport path from \"node:path\";\nimport { createServer } from \"node:http\";\nimport { WebSocket, WebSocketServer } from \"ws\";\nimport { fileURLToPath } from \"node:url\";\nimport { DEFAULT_RENDER_PORT, RENDER_WATCH_DEBOUNCE_MS } from \"./constants.js\";\n\nconst __dirname = path.dirname(fileURLToPath(import.meta.url));\n\n/**\n * Resolve path to the renderer's dist folder (sibling package in monorepo).\n * When running from packages/cli/dist, go up to packages and into renderer/dist.\n */\nfunction getRendererDistPath(): string {\n  return path.resolve(__dirname, \"..\", \"..\", \"renderer\", \"dist\");\n}\n\n/**\n * Read board file and return content as UTF-8. Returns null on error.\n */\nfunction readBoardContent(boardPath: string): string | null {\n  try {\n    const resolved = path.resolve(process.cwd(), boardPath);\n    return fs.readFileSync(resolved, \"utf-8\");\n  } catch {\n    return null;\n  }\n}\n\nexport interface RenderServerOptions {\n  boardPath: string;\n  port?: number;\n  openBrowser?: boolean;\n}\n\n/**\n * Start the render server: static app + GET /api/board + WebSocket /api/board/watch.\n * Watches the board file and broadcasts content to WS clients on change.\n */\nexport function startRenderServer(options: RenderServerOptions): void {\n  const { boardPath, port = DEFAULT_RENDER_PORT, openBrowser = false } = options;\n  const rendererDist = getRendererDistPath();\n\n  if (!fs.existsSync(rendererDist) || !fs.statSync(rendererDist).isDirectory()) {\n    process.stderr.write(\n      \"Renderer build not found. Run: pnpm build\\n\"\n    );\n    process.exitCode = 1;\n    return;\n  }\n\n  const app = express();\n\n  // Board file directory (for resolving spec paths relative to board)\n  const resolvedBoardPath = path.resolve(process.cwd(), boardPath);\n  const boardDir = path.dirname(resolvedBoardPath);\n\n  // API: board file content (raw YAML)\n  app.get(\"/api/board\", (_req: Request, res: Response) => {\n    const content = readBoardContent(boardPath);\n    if (content === null) {\n      res.status(404).type(\"text/plain\").send(\"Board file not found or unreadable.\");\n      return;\n    }\n    res.type(\"text/yaml\").send(content);\n  });\n\n  // API: spec file content (path relative to board file directory; only .md files)\n  app.get(\"/api/spec\", (req: Request, res: Response) => {\n    const rawPath = typeof req.query.path === \"string\" ? req.query.path : \"\";\n    if (!rawPath || rawPath.includes(\"..\")) {\n      res.status(400).type(\"text/plain\").send(\"Invalid or missing path.\");\n      return;\n    }\n    const ext = path.extname(rawPath).toLowerCase();\n    if (ext !== \".md\") {\n      res.status(400).type(\"text/plain\").send(\"Only .md spec files are allowed.\");\n      return;\n    }\n    const resolved = path.resolve(boardDir, rawPath);\n    const relative = path.relative(boardDir, resolved);\n    if (relative.startsWith(\"..\") || path.isAbsolute(relative)) {\n      res.status(400).type(\"text/plain\").send(\"Path must be under board directory.\");\n      return;\n    }\n    try {\n      const content = fs.readFileSync(resolved, \"utf-8\");\n      res.type(\"text/markdown\").send(content);\n    } catch {\n      res.status(404).type(\"text/plain\").send(\"Spec file not found or unreadable.\");\n    }\n  });\n\n  // Static files (must be after /api routes so they take precedence)\n  app.use(express.static(rendererDist));\n\n  // SPA fallback: serve index.html for GET requests not handled by static (Express 5 / path-to-regexp v8 reject bare '*')\n  app.use((_req: Request, res: Response, next: express.NextFunction) => {\n    if (_req.method !== \"GET\" || res.headersSent) return next();\n    const indexHtml = path.join(rendererDist, \"index.html\");\n    if (fs.existsSync(indexHtml)) {\n      res.sendFile(indexHtml);\n    } else {\n      res.status(404).send(\"Not found\");\n    }\n  });\n\n  const server = createServer(app);\n\n  // WebSocket: /api/board/watch — broadcast board content on file change\n  const wss = new WebSocketServer({ noServer: true });\n\n  server.on(\"upgrade\", (request, socket, head) => {\n    const url = new URL(request.url ?? \"\", `http://${request.headers.host}`);\n    if (url.pathname === \"/api/board/watch\") {\n      wss.handleUpgrade(request, socket, head, (ws: WebSocket) => {\n        wss.emit(\"connection\", ws, request);\n      });\n    } else {\n      socket.destroy();\n    }\n  });\n\n  let debounceTimer: ReturnType<typeof setTimeout> | null = null;\n\n  function broadcastBoard(): void {\n    const content = readBoardContent(boardPath);\n    const payload = content ?? \"\";\n    wss.clients.forEach((client: WebSocket) => {\n      if (client.readyState === 1) {\n        client.send(payload);\n      }\n    });\n  }\n\n  wss.on(\"connection\", (ws: WebSocket) => {\n    // Send current board on connect\n    const content = readBoardContent(boardPath);\n    if (content !== null) {\n      ws.send(content);\n    }\n  });\n\n  try {\n    fs.watch(resolvedBoardPath, { persistent: false }, () => {\n      if (debounceTimer) clearTimeout(debounceTimer);\n      debounceTimer = setTimeout(() => {\n        debounceTimer = null;\n        broadcastBoard();\n      }, RENDER_WATCH_DEBOUNCE_MS);\n    });\n  } catch {\n    // File might not exist yet; watcher will not run\n  }\n\n  server.on(\"error\", (err: Error & { code?: string }) => {\n    process.stderr.write(`Render server error: ${err.message}\\n`);\n    if (err.code === \"EADDRINUSE\") {\n      process.stderr.write(`Port ${port} is in use. Try --port <number>.\\n`);\n    }\n    process.exitCode = 1;\n  });\n\n  server.listen(port, () => {\n    const url = `http://localhost:${port}`;\n    process.stdout.write(`Open ${url}\\n`);\n    if (openBrowser) {\n      import(\"open\").then(({ default: open }) => {\n        open(url).catch(() => {});\n      });\n    }\n  });\n\n  const shutdown = () => {\n    server.close(() => {\n      process.exit(process.exitCode ?? 0);\n    });\n  };\n  process.on(\"SIGINT\", shutdown);\n  process.on(\"SIGTERM\", shutdown);\n}\n","import { startRenderServer } from \"../render-server.js\";\n\nexport function runRender(path: string, options: { port: number; open: boolean }): void {\n  startRenderServer({\n    boardPath: path,\n    port: options.port,\n    openBrowser: options.open,\n  });\n}\n","import fs from \"node:fs\";\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { SPEC_FILENAME } from \"../constants.js\";\nimport { findPackageRoot } from \"../utils.js\";\n\nexport function runSpec(): void {\n  const thisFile = fileURLToPath(import.meta.url);\n  const startDir = path.dirname(thisFile);\n  const packageRoot = findPackageRoot(startDir);\n  if (!packageRoot) {\n    process.stderr.write(\"statecraft spec: could not find package root\\n\");\n    process.exitCode = 1;\n    return;\n  }\n  const specPath = path.join(packageRoot, SPEC_FILENAME);\n  if (!fs.existsSync(specPath)) {\n    process.stderr.write(`statecraft spec: spec file not found at ${specPath}\\n`);\n    process.exitCode = 1;\n    return;\n  }\n  try {\n    const content = fs.readFileSync(specPath, \"utf-8\");\n    process.stdout.write(content);\n    if (!content.endsWith(\"\\n\")) process.stdout.write(\"\\n\");\n    process.exitCode = 0;\n  } catch (err) {\n    const message = err instanceof Error ? err.message : String(err);\n    process.stderr.write(`statecraft spec: ${message}\\n`);\n    process.exitCode = 1;\n  }\n}\n","/**\n * Shared CLI utilities (path resolution, etc.).\n */\nimport fs from \"node:fs\";\nimport path from \"node:path\";\n\n/**\n * Walk up from startDir until a directory containing package.json is found.\n * @returns Absolute path to package root, or null if not found.\n */\nexport function findPackageRoot(startDir: string): string | null {\n  let dir = path.resolve(startDir);\n  for (;;) {\n    const pkgPath = path.join(dir, \"package.json\");\n    if (fs.existsSync(pkgPath)) return dir;\n    const parent = path.dirname(dir);\n    if (parent === dir) return null;\n    dir = parent;\n  }\n}\n","import { parseBoard, summarize } from \"@stcrft/statecraft-core\";\n\nexport function runSummarize(path: string): void {\n  try {\n    const board = parseBoard(path);\n    const summary = summarize(board);\n    process.stdout.write(summary);\n    process.exitCode = 0;\n  } catch (err) {\n    const message = err instanceof Error ? err.message : String(err);\n    process.stderr.write(message + \"\\n\");\n    process.exitCode = 1;\n  }\n}\n","import { parseBoard, validate } from \"@stcrft/statecraft-core\";\n\nfunction formatValidationError(err: { message: string; path?: string }): string {\n  const prefix = err.path != null && err.path !== \"\" ? `${err.path}: ` : \"\";\n  return `${prefix}${err.message}`;\n}\n\nexport function runValidate(path: string): void {\n  try {\n    const board = parseBoard(path);\n    const result = validate(board);\n    if (!result.valid) {\n      for (const err of result.errors) {\n        process.stderr.write(formatValidationError(err) + \"\\n\");\n      }\n      process.exitCode = 1;\n      return;\n    }\n    process.exitCode = 0;\n  } catch (err) {\n    const message = err instanceof Error ? err.message : String(err);\n    process.stderr.write(message + \"\\n\");\n    process.exitCode = 1;\n  }\n}\n"],"mappings":"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","names":["fs","path","__dirname","path","fs","path","fs","path","fileURLToPath","fs","path","fileURLToPath","path","fs","path","parseBoard","path","require","path"]}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@stcrft/statecraft",
+  "version": "1.1.2",
+  "description": "CLI for Statecraft: validate, summarize, and render board-as-code",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/KristijanS99/statecraft.git"
+  },
+  "license": "GPL-3.0-only",
+  "engines": {
+    "node": ">=20"
+  },
+  "bin": {
+    "statecraft": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "spec.md"
+  ],
+  "scripts": {
+    "build": "node scripts/copy-spec.mjs && tsup",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@stcrft/statecraft-core": "workspace:*",
+    "commander": "^12.1.0",
+    "express": "^5.2.1",
+    "open": "^11.0.0",
+    "ws": "^8.18.0",
+    "yaml": "^2.8.2"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.0",
+    "@types/node": "^22.0.0",
+    "@types/ws": "^8.5.0",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "vitest": "^4.0.18"
+  }
+}

package/spec.md

@@ -0,0 +1,172 @@
+# Statecraft board DSL — Spec (v0)
+
+This document defines the Statecraft board format. A single file describes one Kanban-style board in YAML. The file is the source of truth for AI agents and developers; tools (CLI, renderer) read and validate it.
+
+**One board per file.** Use `.yaml` or `.yml`. Convention: name the file e.g. `board.yaml`, or pass the path explicitly to tools.
+
+---
+
+## Overview
+
+- **Format:** YAML (UTF-8).
+- **Scope:** One board per file. Top-level keys: `board`, `columns`, `tasks`.
+- **Purpose:** Machine-readable task state: columns, tasks, status, dependencies, optional WIP limits. Designed for AI agents to read, write, and update; versioned in Git; developers can work with the same files.
+
+---
+
+## Board
+
+**Required.** Identifies the board.
+
+| Key     | Type   | Required | Description                |
+|---------|--------|----------|----------------------------|
+| `board` | string | Yes      | Board name (human-readable label). |
+
+---
+
+## Columns
+
+**Required.** The board **must** use the following columns in this exact order. This is the only supported workflow; it gives AI agents a single, unambiguous contract.
+
+### Canonical column set
+
+| Column         | Meaning for AI |
+|----------------|----------------|
+| **Backlog**    | Not yet selected for immediate work. New tasks are created here. May be unrefined or unprioritized. |
+| **Ready**      | Prepared and selected to be worked on next. Definition is clear (e.g. in spec file), dependencies met or N/A; safe to move to In Progress when capacity is free. |
+| **In Progress** | Currently being worked on. Move a task here when starting work; at most one (or a configurable WIP limit) at a time per column if enforced. |
+| **Done**       | Completed and accepted. Move here when the task’s acceptance criteria (in its spec file) are satisfied. |
+
+- **Order:** `Backlog` → `Ready` → `In Progress` → `Done` (left to right).
+- **Syntax:** Each column is either a string (name only) or an object with `name` and optional `limit`. The `limit` (positive integer) is a WIP limit: max tasks allowed in that column. Typically only **In Progress** has a limit (e.g. `{ name: "In Progress", limit: 3 }`).
+- Validators must reject boards whose `columns` do not match this set (same names, same order). Column names are case-sensitive.
+
+---
+
+## Tasks
+
+**Required** (but may be an empty object). Map of task id → task. Task id is a string key (e.g. `AUTH-12`, `task-1`). Each task has the following fields:
+
+| Field        | Type   | Required | Description |
+|--------------|--------|----------|-------------|
+| `title`      | string | Yes      | Short description of the task. |
+| `status`     | string | Yes      | Current column; must match one of the column names. |
+| `description` | string | No      | Inline summary or context; may be markdown. Use for one-liners. |
+| `spec`       | string | No       | Path to a markdown file (e.g. `.md`) with full task spec, acceptance criteria, notes. Path is **relative to the board file's directory**. AI agents can read this file for context. |
+| `owner`      | string | No       | Assignee (e.g. username or agent id). |
+| `priority`    | string | No       | e.g. `low`, `medium`, `high`. Semantics are tool-specific. |
+| `depends_on` | string or list of strings | No | Task id(s) that must be completed before this task; single id or list. |
+
+- Task ids must be unique within the board.
+- `status` must equal one of the column names from `columns`.
+- `depends_on` must reference task ids that exist in `tasks` (validation rule).
+- `spec`: resolved relative to the directory containing the board file. Tools may warn if the file is missing; validation does not require the file to exist.
+
+---
+
+## CRUS: AI behavior
+
+Statecraft is built around **CRUS** (Create, Read, Update, Summarize). AI agents must follow this behavior when working with the board.
+
+### Create
+
+- **Where:** New tasks are created with `status: Backlog`.
+- **What:** Add an entry under `tasks` with at least `title` and `status`. Use a stable, kebab-case **task id** (e.g. `fix-auth-timeout`). Optionally set `description`, `spec` (path to a `.md` file relative to the board directory), `owner`, `priority`, `depends_on`.
+- **Spec file:** If the task has acceptance criteria or context, create a markdown file (e.g. `tasks/<task-id>.md`) and set `spec: tasks/<task-id>.md`. Path is relative to the board file’s directory.
+
+### Read
+
+- **Board file:** The single source of truth. Read it to see all tasks, their `status`, and dependencies (`depends_on`).
+- **Spec files:** For a task with a `spec` field, read that file for full description and definition of done. Resolve the path relative to the board file’s directory.
+- **Status:** A task’s `status` is exactly one of the canonical column names (Backlog, Ready, In Progress, Done). Use it to reason about what is not yet selected, ready to start, in progress, or completed.
+
+### Update
+
+- **How:** Edit the board YAML file (and, if needed, task spec files) directly. There are no separate “move” APIs; changing `status` is the update.
+- **Prepare for work:** When a task has a clear definition and dependencies are satisfied (or N/A), set `status` to `Ready`. Do not move to In Progress until the task is Ready (or skip Ready if the workflow is minimal).
+- **Start work:** Set the task’s `status` to `In Progress`. Optionally read the task’s `spec` file first.
+- **Finish work:** Set the task’s `status` to `Done` only when the task’s acceptance criteria (in its spec file, if present) are satisfied. Do not move to Done without meeting the definition of done.
+- **Create / change fields:** Add or edit `title`, `status`, `description`, `spec`, `owner`, `priority`, `depends_on` in the board file; create or edit the spec file when the task has one.
+
+### Summarize
+
+- Completion is represented by moving tasks to **Done**, not by deleting them. Use `statecraft summarize` (or equivalent) to produce a short summary of the board (counts, task list, WIP, blocked). Summarize replaces “delete”: tasks are completed and reasoned about, not removed.
+
+---
+
+## Example
+
+Complete valid board:
+
+```yaml
+board: "Auth Service"
+
+columns:
+  - Backlog
+  - Ready
+  - name: In Progress
+    limit: 3
+  - Done
+
+tasks:
+  AUTH-7:
+    title: "Audit existing JWT usage"
+    status: Done
+    owner: kristijan
+    priority: high
+    description: "List all endpoints and call sites using JWT."
+
+  AUTH-12:
+    title: "Replace JWT with PASETO"
+    status: In Progress
+    owner: kristijan
+    priority: high
+    depends_on: AUTH-7
+    spec: tasks/AUTH-12.md
+
+  AUTH-13:
+    title: "Add rate limiting to auth endpoints"
+    status: Ready
+    priority: medium
+    description: "Per-IP and per-user limits; configurable thresholds."
+
+  AUTH-14:
+    title: "Document auth API"
+    status: Backlog
+    priority: low
+```
+
+---
+
+## Constraints (for validation)
+
+Tools that validate board files should enforce:
+
+1. **Board:** `board` is present and a non-empty string.
+2. **Columns:** `columns` is present and **must equal the canonical set** in order: Backlog, Ready, In Progress, Done. Each entry is either the string (e.g. `"Backlog"`, `"Ready"`, `"In Progress"`, `"Done"`) or an object `{ name: "<exact name>", limit: N }` with optional positive integer `limit` (typically only on In Progress). No extra or missing columns; no reordering.
+3. **Tasks:** `tasks` is present (may be `{}`). Each key is a task id; each value has required `title` and `status`. `status` must be one of the canonical column names. `depends_on` entries must be task ids that exist in `tasks`. Task ids are unique.
+4. **WIP:** If a column has a `limit`, the number of tasks with that column as `status` must not exceed `limit`.
+
+These constraints are the basis for parser/validator implementations; this spec does not define error messages or reporting format.
+
+---
+
+## Setup and AI workflow
+
+**Creating a board:** Use **`statecraft init`** to create a board file and optionally connect Statecraft to your AI workflow. Init creates a board with the **canonical columns** (Backlog, Ready, In Progress, Done) and prompts for: board name, optional WIP limit for In Progress, board file path, directory for task `.md` files (relative to the board), and whether to generate rules for **Cursor**, **Claude Code**, and/or **Codex**. It writes valid board YAML and, if you choose, tool-specific rule files so your AI assistant knows where the board is and how to follow CRUS.
+
+**Generated rule files:**
+
+- **Cursor:** `.cursor/rules/statecraft.mdc` — Cursor rules with YAML frontmatter (description, alwaysApply) and Markdown body.
+- **Claude Code:** `.claude/rules/statecraft.md` — Modular rule in Claude Code’s rules directory (Markdown, no frontmatter).
+- **Codex:** `AGENTS.md` at project root — Codex custom instructions; init creates the file or appends a Statecraft section if `AGENTS.md` already exists.
+
+**Where AI guidelines live:** When init generates any of these files, it embeds **AI guidelines** for creating and updating tasks: task naming (e.g. kebab-case), description and DoD, task fields from this spec (`title`, `status`, `description`, `spec`, `owner`, `priority`, `depends_on`), and the convention for spec files (e.g. `tasks/<task-id>.md`). Each rule also describes the **task lifecycle**: how to start work, finish work, and create tasks by editing the board file and task spec files directly. To customize guidelines, edit the generated file(s) after init.
+
+**Spec and validation:** After init, run `statecraft spec` to print this spec (for AI agents) and `statecraft validate <board-path>` to validate the board.
+
+---
+
+## See also
+
+- **Example boards** in the repo: [`examples/`](../examples/) — `board.yaml` (full), `board-minimal.yaml` (minimal). Use with `statecraft validate examples/board.yaml` and similar.