pipe-kan 0.31.0 → 0.32.0

package/dist/pipe-kan.js

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 
 // src/server.ts
-import { readFileSync as readFileSync6, writeSync } from "node:fs";
+import { readFileSync as readFileSync7, writeSync } from "node:fs";
 import { createServer } from "node:http";
 import { tmpdir as tmpdir3 } from "node:os";
-import { join as join10 } from "node:path";
+import { join as join11 } from "node:path";
 
 // src/app.ts
 import { readFileSync as readFileSync2 } from "node:fs";
@@ -399,8 +399,16 @@ function parseFlags(flags) {
         statusEq.push(status);
       continue;
     }
-    if (token === "--projects") {
-      [projectsValue, i] = takeValue(list, i, "--projects");
+    if (token === "--projects" || token.startsWith("--projects=")) {
+      const parts = [];
+      if (token.startsWith("--projects=")) {
+        parts.push(token.slice("--projects=".length));
+      }
+      while (i + 1 < list.length && !list[i + 1].startsWith("-")) {
+        i++;
+        parts.push(list[i]);
+      }
+      projectsValue = parts.join(",");
       continue;
     }
     if (token === "-q" || token === "--jql") {
@@ -2272,6 +2280,123 @@ async function refreshFromJira(app, kind, opts = {}) {
   await app.refresh();
 }
 
+// src/factory-ledger.ts
+import { existsSync as existsSync2, readFileSync as readFileSync3, statSync } from "node:fs";
+import { homedir as homedir3 } from "node:os";
+import { join as join4 } from "node:path";
+var DEFAULT_LEDGER_PATH = "~/code/software-factory/asf/runtime/factory-coordinator/jobs.jsonl";
+function resolveLedgerPath(env = process.env) {
+  const raw = env.FACTORY_LEDGER_PATH ?? DEFAULT_LEDGER_PATH;
+  return raw.startsWith("~/") ? join4(homedir3(), raw.slice(2)) : raw;
+}
+function parseJobsJsonl(text) {
+  const events = [];
+  for (const line of text.split(`
+`)) {
+    const trimmed = line.trim();
+    if (!trimmed)
+      continue;
+    try {
+      events.push(JSON.parse(trimmed));
+    } catch {}
+  }
+  return events;
+}
+function lc(...parts) {
+  return parts.filter(Boolean).join(" ").toLowerCase();
+}
+function deriveStageTag(events) {
+  if (!events.length)
+    return null;
+  const last = events[events.length - 1];
+  if (last.status === "done" || last.status === "cancelled")
+    return null;
+  const text = lc(last.detail, last.summary, last.target_agent, last.from_bot);
+  const fromBot = lc(last.from_bot);
+  const targetAgent = lc(last.target_agent);
+  const detail = lc(last.detail);
+  if (last.status === "blocked" || /needs.{0,4}judgment|green.{0,4}light|await.{0,4}ship|awaiting.{0,4}ship|needs.{0,4}input|waiting.{0,4}operator|checks.{0,4}pass|verify.{0,4}pass|human.{0,4}gate/.test(text)) {
+    return "human-wait";
+  }
+  if (last.status === "queued" || last.status === "routed" || /grokbot.{0,4}coordinator|intake.{0,4}switchboard/.test(fromBot) || /routing|switchboard/.test(text)) {
+    return "coordinator";
+  }
+  if (/planner|plan_|stage_1a/.test(targetAgent) || /planner|to.{0,2}spec|to.{0,2}tickets|grill.{0,4}with.{0,4}docs|stage_1/.test(text)) {
+    return "planning";
+  }
+  if (/desk=/.test(detail) || /preflight|research.{0,4}gate|research.{0,4}dossier/.test(text)) {
+    return "desk";
+  }
+  if (/maker|implement|referee|omp|stage_2/.test(targetAgent) || /\bmaker\b|implement|referee|stage_2|pr.{0,4}open|pull.{0,4}request/.test(text)) {
+    return "maker";
+  }
+  return "coordinator";
+}
+function extractPrUrl(detail) {
+  if (!detail)
+    return;
+  const m = /https:\/\/github\.com\/[^\s"']+\/pull\/\d+/.exec(detail);
+  return m?.[0];
+}
+function groupByLatest(events) {
+  const map = new Map;
+  for (const ev of events) {
+    if (!ev.id)
+      continue;
+    const list = map.get(ev.id);
+    if (list) {
+      list.push(ev);
+    } else {
+      map.set(ev.id, [ev]);
+    }
+  }
+  return map;
+}
+function jobFromEvents(id, events) {
+  const last = events[events.length - 1];
+  const pullRequestUrl = events.map((e) => e.pull_request_url ?? extractPrUrl(e.detail)).find(Boolean);
+  return {
+    id,
+    summary: last.summary ?? "",
+    status: last.status ?? "",
+    stageTag: deriveStageTag(events),
+    latestTs: last.ts,
+    ...pullRequestUrl ? { pullRequestUrl } : {},
+    ...last.plane_project ? { planeProject: last.plane_project } : {},
+    ...last.detail ? { detail: last.detail } : {},
+    ...last.session ? { session: last.session } : {},
+    ...last.from_bot ? { fromBot: last.from_bot } : {}
+  };
+}
+function classifyJobs(events) {
+  const grouped = groupByLatest(events);
+  const jobs = [];
+  for (const [id, evs] of grouped) {
+    jobs.push(jobFromEvents(id, evs));
+  }
+  jobs.sort((a, b) => b.latestTs.localeCompare(a.latestTs));
+  return jobs;
+}
+var _cache = null;
+function readLedger(env = process.env) {
+  const path = resolveLedgerPath(env);
+  if (!existsSync2(path)) {
+    return { jobs: [], error: `Ledger not found: ${path}` };
+  }
+  try {
+    const mtime = statSync(path).mtimeMs;
+    if (_cache && _cache.path === path && _cache.mtime === mtime) {
+      return { jobs: _cache.jobs };
+    }
+    const text = readFileSync3(path, "utf8");
+    const jobs = classifyJobs(parseJobsJsonl(text));
+    _cache = { path, mtime, jobs };
+    return { jobs };
+  } catch (err) {
+    return { jobs: [], error: String(err) };
+  }
+}
+
 // src/app-api.ts
 function json(res, status, body) {
   res.statusCode = status;
@@ -2416,6 +2541,26 @@ function handleAppApi(req, res, app, opts = {}) {
     });
     return true;
   }
+  if (url.pathname === "/api/factory/jobs" && method === "GET") {
+    reply(req, res, async () => {
+      const result = readLedger();
+      json(res, result.error && result.jobs.length === 0 ? 503 : 200, result);
+    });
+    return true;
+  }
+  if (/^\/api\/factory\/jobs\/[^/]+$/.test(url.pathname) && method === "GET") {
+    reply(req, res, async () => {
+      const id = url.pathname.slice("/api/factory/jobs/".length);
+      const result = readLedger();
+      const job = result.jobs.find((j) => j.id === id);
+      if (!job) {
+        json(res, 404, { error: `Job not found: ${id}`, ledgerError: result.error });
+        return;
+      }
+      json(res, 200, { job });
+    });
+    return true;
+  }
   return false;
 }
 
@@ -2505,10 +2650,10 @@ function formatCard(card) {
 }
 
 // src/server/agent/config.ts
-import { existsSync as existsSync2, mkdirSync as mkdirSync2, readFileSync as readFileSync3, writeFileSync as writeFileSync2 } from "node:fs";
-import { homedir as homedir3 } from "node:os";
-import { delimiter as delimiter2, dirname as dirname2, join as join4 } from "node:path";
-var DEFAULT_CONFIG_PATH = join4(homedir3(), ".config", "pipe-kan", "agent.json");
+import { existsSync as existsSync3, mkdirSync as mkdirSync2, readFileSync as readFileSync4, writeFileSync as writeFileSync2 } from "node:fs";
+import { homedir as homedir4 } from "node:os";
+import { delimiter as delimiter2, dirname as dirname2, join as join5 } from "node:path";
+var DEFAULT_CONFIG_PATH = join5(homedir4(), ".config", "pipe-kan", "agent.json");
 var FALLBACK_MODELS = {
   cursor: [
     { id: "composer-2", name: "Composer 2" },
@@ -2550,21 +2695,21 @@ function commandOnPath(command, env = process.env) {
   if (!command)
     return false;
   if (command.includes("/") || command.includes("\\"))
-    return existsSync2(command);
+    return existsSync3(command);
   const pathVar = env.PATH ?? "";
   for (const dir of pathVar.split(delimiter2)) {
     if (!dir)
       continue;
-    if (existsSync2(join4(dir, command)))
+    if (existsSync3(join5(dir, command)))
       return true;
   }
   return false;
 }
 function loadAgentConfig(path = agentConfigPath()) {
-  if (!existsSync2(path))
+  if (!existsSync3(path))
     return structuredClone(DEFAULT_CONFIG);
   try {
-    const raw = JSON.parse(readFileSync3(path, "utf8"));
+    const raw = JSON.parse(readFileSync4(path, "utf8"));
     return mergeConfig(raw);
   } catch {
     return structuredClone(DEFAULT_CONFIG);
@@ -2600,7 +2745,7 @@ function mergeConfig(raw) {
 }
 function ensureAgentConfigDir(path = agentConfigPath()) {
   const dir = dirname2(path);
-  if (!existsSync2(dir))
+  if (!existsSync3(dir))
     mkdirSync2(dir, { recursive: true });
 }
 
@@ -2608,7 +2753,7 @@ function ensureAgentConfigDir(path = agentConfigPath()) {
 import { spawn as spawn2 } from "node:child_process";
 import { mkdtempSync, rmSync } from "node:fs";
 import { tmpdir as tmpdir2 } from "node:os";
-import { join as join5 } from "node:path";
+import { join as join6 } from "node:path";
 import { Readable } from "node:stream";
 
 // node_modules/@agentclientprotocol/sdk/dist/schema/index.js
@@ -12334,7 +12479,7 @@ class AcpSession {
   executeTool = null;
   stderr = "";
   selectedModelId = null;
-  workspace = mkdtempSync(join5(tmpdir2(), "pipe-kan-agent-"));
+  workspace = mkdtempSync(join6(tmpdir2(), "pipe-kan-agent-"));
   constructor(config) {
     this.config = config;
     this.id = crypto.randomUUID();
@@ -12646,17 +12791,17 @@ function permissionOptionForDecision(options, decision) {
 }
 
 // src/server/agent/skills.ts
-import { existsSync as existsSync3, readFileSync as readFileSync4, readdirSync } from "node:fs";
-import { homedir as homedir4 } from "node:os";
-import { join as join6 } from "node:path";
+import { existsSync as existsSync4, readFileSync as readFileSync5, readdirSync } from "node:fs";
+import { homedir as homedir5 } from "node:os";
+import { join as join7 } from "node:path";
 import { fileURLToPath } from "node:url";
 function createSkillRegistry(bundledDir) {
-  const dir = bundledDir ?? join6(fileURLToPath(new URL(".", import.meta.url)), "..", "..", "..", ".agents", "skills");
-  const userDir = join6(homedir4(), ".pi", "agent", "skills");
+  const dir = bundledDir ?? join7(fileURLToPath(new URL(".", import.meta.url)), "..", "..", "..", ".agents", "skills");
+  const userDir = join7(homedir5(), ".pi", "agent", "skills");
   return {
     list() {
       const bundled = listSkills(dir);
-      const user = existsSync3(userDir) ? listSkills(userDir) : [];
+      const user = existsSync4(userDir) ? listSkills(userDir) : [];
       const map = new Map;
       for (const skill of bundled)
         map.set(skill.id, skill);
@@ -12666,10 +12811,10 @@ function createSkillRegistry(bundledDir) {
     },
     load(id) {
       const userPath = skillPath(userDir, id);
-      if (existsSync3(userPath))
+      if (existsSync4(userPath))
         return readSkill(userPath, id);
       const bundledPath = skillPath(dir, id);
-      if (existsSync3(bundledPath))
+      if (existsSync4(bundledPath))
         return readSkill(bundledPath, id);
       return;
     }
@@ -12686,16 +12831,16 @@ function skillContextBlock(skill) {
   };
 }
 function listSkills(dir) {
-  if (!existsSync3(dir))
+  if (!existsSync4(dir))
     return [];
   return readdirSync(dir, { withFileTypes: true }).filter((entry) => entry.isDirectory()).map((entry) => readSkill(skillPath(dir, entry.name), entry.name)).filter((skill) => skill !== undefined);
 }
 function skillPath(dir, id) {
-  return join6(dir, id, "SKILL.md");
+  return join7(dir, id, "SKILL.md");
 }
 function readSkill(path, id) {
   try {
-    const text = readFileSync4(path, "utf8");
+    const text = readFileSync5(path, "utf8");
     const front = parseFrontMatter(text);
     return {
       id,
@@ -12722,8 +12867,8 @@ function parseFrontMatter(text) {
 }
 
 // src/server/agent/tools.ts
-import { readFileSync as readFileSync5 } from "node:fs";
-import { join as join7 } from "node:path";
+import { mkdirSync as mkdirSync3, readFileSync as readFileSync6, writeFileSync as writeFileSync3 } from "node:fs";
+import { join as join8 } from "node:path";
 var TOOLS = [
   {
     name: "board_state",
@@ -12799,6 +12944,35 @@ var TOOLS = [
       labels: { type: "string", description: "Comma-separated replacement labels" }
     },
     mutates: true
+  },
+  {
+    name: "factory_job_status",
+    description: "Read the latest status and factory stage tag for one or more software-factory jobs from the local ledger. Pass a job id (gbj-YYYYMMDD-NNN) for a single job, or omit id to get the 20 most-recent active jobs.",
+    parameters: {
+      id: { type: "string", description: "Optional job id, e.g. gbj-20260926-011" }
+    },
+    mutates: false
+  },
+  {
+    name: "factory_start_job",
+    description: "Request the Grokbot Coordinator to start a new factory job. Writes a start-request to docs/factory/outbox/ for the coordinator to pick up. Requires user approval. Does NOT append to jobs.jsonl directly.",
+    parameters: {
+      summary: { type: "string", description: "One-line job summary" },
+      repo: { type: "string", description: "Target repo path, e.g. ~/code/pipe-kan" },
+      session: { type: "string", description: "Herdr session name, e.g. jira-kan" },
+      notes: { type: "string", description: "Optional extra context for the coordinator" }
+    },
+    mutates: true
+  },
+  {
+    name: "factory_move_job",
+    description: "Request the Grokbot Coordinator to move a factory job to a new status or stage. Writes a move-request to docs/factory/outbox/ for the coordinator to pick up. Requires user approval. Does NOT append to jobs.jsonl directly.",
+    parameters: {
+      id: { type: "string", description: "Job id to move, e.g. gbj-20260926-011" },
+      status: { type: "string", description: "Target status: queued|routed|in_progress|blocked|done|cancelled" },
+      detail: { type: "string", description: "Optional detail message for the ledger event" }
+    },
+    mutates: true
   }
 ];
 var skills;
@@ -12843,7 +13017,7 @@ var EXECUTORS = {
       return { ok: false, error: "Path traversal not allowed" };
     const repoRoot = process.cwd();
     try {
-      const text = readFileSync5(join7(repoRoot, relPath), "utf8");
+      const text = readFileSync6(join8(repoRoot, relPath), "utf8");
       return { ok: true, value: { path: relPath, text } };
     } catch (err) {
       return { ok: false, error: String(err) };
@@ -12914,6 +13088,93 @@ var EXECUTORS = {
     if (result.error)
       return { ok: false, error: result.error };
     return { ok: true, value: { key, __ui_action: "refresh_board" } };
+  },
+  factory_job_status(args) {
+    const id = typeof args.id === "string" ? args.id.trim() : "";
+    const ledger = readLedger();
+    if (id) {
+      const job = ledger.jobs.find((j) => j.id === id);
+      if (!job) {
+        return { ok: false, error: `Job not found: ${id}${ledger.error ? ` (${ledger.error})` : ""}` };
+      }
+      return { ok: true, value: { job, ledgerError: ledger.error } };
+    }
+    const active = ledger.jobs.filter((j) => j.stageTag !== null).slice(0, 20);
+    return {
+      ok: true,
+      value: { jobs: active, total: ledger.jobs.length, ledgerError: ledger.error }
+    };
+  },
+  factory_start_job(args) {
+    const summary = String(args.summary ?? "").trim();
+    if (!summary)
+      return { ok: false, error: "Missing summary" };
+    const repo = String(args.repo ?? "").trim();
+    const session = String(args.session ?? "").trim();
+    const notes = typeof args.notes === "string" ? args.notes.trim() : undefined;
+    const ts = new Date().toISOString();
+    const requestId = crypto.randomUUID();
+    const outboxDir = join8(process.cwd(), "docs/factory/outbox");
+    mkdirSync3(outboxDir, { recursive: true });
+    const filename = `${ts.replace(/[:.]/g, "-")}-${requestId}-start.json`;
+    const payload = {
+      action: "start_job",
+      requested_by: "pipe-kan-acp",
+      ts,
+      requestId,
+      summary,
+      ...repo ? { repo } : {},
+      ...session ? { session } : {},
+      ...notes ? { notes } : {}
+    };
+    writeFileSync3(join8(outboxDir, filename), JSON.stringify(payload, null, 2) + `
+`, "utf8");
+    return {
+      ok: true,
+      value: {
+        message: `Start request written to docs/factory/outbox/${filename}. The Grokbot Coordinator will pick this up and append the real ledger event.`,
+        outboxFile: filename
+      }
+    };
+  },
+  factory_move_job(args) {
+    const id = String(args.id ?? "").trim();
+    const status = String(args.status ?? "").trim();
+    if (!id)
+      return { ok: false, error: "Missing job id" };
+    if (!status)
+      return { ok: false, error: "Missing target status" };
+    const validStatuses = ["queued", "routed", "in_progress", "blocked", "done", "cancelled"];
+    if (!validStatuses.includes(status)) {
+      return {
+        ok: false,
+        error: `Invalid status '${status}'. Must be one of: ${validStatuses.join(", ")}`
+      };
+    }
+    const detail = typeof args.detail === "string" ? args.detail.trim() : undefined;
+    const ts = new Date().toISOString();
+    const requestId = crypto.randomUUID();
+    const outboxDir = join8(process.cwd(), "docs/factory/outbox");
+    mkdirSync3(outboxDir, { recursive: true });
+    const filename = `${ts.replace(/[:.]/g, "-")}-${requestId}-move.json`;
+    const payload = {
+      action: "move_job",
+      requested_by: "pipe-kan-acp",
+      ts,
+      requestId,
+      id,
+      status,
+      ...detail ? { detail } : {}
+    };
+    writeFileSync3(join8(outboxDir, filename), JSON.stringify(payload, null, 2) + `
+`, "utf8");
+    return {
+      ok: true,
+      value: {
+        message: `Move request for ${id} → ${status} written to docs/factory/outbox/${filename}. The Grokbot Coordinator will pick this up and append the real ledger event.`,
+        outboxFile: filename
+      }
+    };
   }
 };
 var SYSTEM_TEXT = `Your working context is the attached Jira issues from the pipe. Answer from that payload. Do not search GitHub, git history, or local source files unless the user explicitly asks about the pipe-kan app itself.
@@ -13389,12 +13650,12 @@ function handleRequest(req, res, ctx) {
 }
 
 // src/jira-config.ts
-import { mkdirSync as mkdirSync3, writeFileSync as writeFileSync3 } from "node:fs";
-import { join as join8 } from "node:path";
+import { mkdirSync as mkdirSync4, writeFileSync as writeFileSync4 } from "node:fs";
+import { join as join9 } from "node:path";
 function writeJiraConfig(dir, server) {
-  mkdirSync3(dir, { recursive: true });
-  const path = join8(dir, "jira.config.yml");
-  writeFileSync3(path, [
+  mkdirSync4(dir, { recursive: true });
+  const path = join9(dir, "jira.config.yml");
+  writeFileSync4(path, [
     "installation: Cloud",
     `server: ${server}`,
     `login: ${ME.emailAddress}`,
@@ -13448,8 +13709,8 @@ function stdinStat() {
 }
 
 // src/ui.ts
-import { createReadStream, existsSync as existsSync4, statSync } from "node:fs";
-import { dirname as dirname3, extname, join as join9, resolve as resolve2, sep } from "node:path";
+import { createReadStream, existsSync as existsSync5, statSync as statSync2 } from "node:fs";
+import { dirname as dirname3, extname, join as join10, resolve as resolve2, sep } from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 var types = {
   ".css": "text/css; charset=utf-8",
@@ -13466,7 +13727,7 @@ function packageRoot(from = import.meta.url) {
   return resolve2(dirname3(fileURLToPath2(from)), "..");
 }
 function uiDir(root) {
-  return join9(root, "dist", "ui");
+  return join10(root, "dist", "ui");
 }
 function inside(root, file) {
   const base = resolve2(root);
@@ -13475,12 +13736,12 @@ function inside(root, file) {
 }
 function sendUi(root, req, res) {
   const ui = uiDir(root);
-  const index = join9(ui, "index.html");
-  if (!existsSync4(index))
+  const index = join10(ui, "index.html");
+  if (!existsSync5(index))
     return false;
   const path = new URL(req.url ?? "/", "http://127.0.0.1").pathname;
   const wanted = resolve2(ui, `.${decodeURIComponent(path)}`);
-  const file = inside(ui, wanted) && existsSync4(wanted) && statSync(wanted).isFile() ? wanted : index;
+  const file = inside(ui, wanted) && existsSync5(wanted) && statSync2(wanted).isFile() ? wanted : index;
   res.setHeader("content-type", types[extname(file)] ?? "application/octet-stream");
   createReadStream(file).pipe(res);
   return true;
@@ -13496,7 +13757,7 @@ function announce(line) {
 }
 async function runServer(opts) {
   const piped = await readPipe();
-  const raw = piped ?? JSON.parse(readFileSync6(join10(opts.root, "fixtures/issues.json"), "utf8"));
+  const raw = piped ?? JSON.parse(readFileSync7(join11(opts.root, "fixtures/issues.json"), "utf8"));
   const flags = argvToFlags(process.argv);
   const { app, store, kind } = await createBoardApp({
     raw,
@@ -13533,7 +13794,7 @@ async function runServer(opts) {
     announce(`cli plane ${planeHost()} ${planeWorkspace(flags)}`);
     announce(`Plane host default ${DEFAULT_PLANE_HOST}`);
   } else {
-    const fakeConfig = writeJiraConfig(join10(tmpdir3(), "pipe-kan"), origin);
+    const fakeConfig = writeJiraConfig(join11(tmpdir3(), "pipe-kan"), origin);
     announce(`cli ${kind === "jira" ? resolveJiraBin() : "store"}`);
     announce(`Fake Jira ${origin}/rest/api/2/search`);
     announce(`Fake Jira config ${fakeConfig}`);