@kynver-app/runtime 0.1.3 → 0.1.5

package/dist/index.js

@@ -638,6 +638,16 @@ import path7 from "node:path";
 // src/prompt.ts
 function buildPrompt(input) {
   const ownership = input.ownedPaths.length ? `Owned paths: ${input.ownedPaths.join(", ")}. Do not edit outside these paths without stopping and reporting why.` : "Owned paths: unrestricted for this worker, but keep edits tightly scoped.";
+  const progressLines = [
+    "Structured plan progress (required when planId is set):",
+    "- Harness checkpoints only: `kynver plan progress --plan <planId> --row <rowKey> --role implementer --status running|partial|blocked` (the by-id harness route rejects `done` and confirm events).",
+    "- When a slice is finished, emit `partial` with evidence (`--evidence pr:<url>`, `--evidence path:<file>`, or `--evidence command:<cmd>`). Do not propose or confirm row `done` from the worker CLI.",
+    "- Propose/confirm row `done` is MCP/session only: chat agents use `agent_os_plan_progress_event_append` on the slug route (implementer proposes with `proposed: true`; report_reviewer/deep_reviewer confirm with `proposed: false`).",
+    "- When blocked on operator/Ghost/runtime review, create a linked review task (MCP `agent_os_plan_review_task_create` or API) and pass `--review-task <taskId>`.",
+    "- Before the completion report: mark completion-report rows partial with evidence; do not skip report review.",
+    "- After implementation: wait for report_reviewer then deep_reviewer confirmation (via MCP/session agents) before follow-up rows close.",
+    input.planId ? `Active planId: ${input.planId}${input.taskId ? ` \xB7 taskId: ${input.taskId}` : ""}` : "No planId on this worker \u2014 still emit progress when you touch plan-scoped work."
+  ];
   return [
     "You are running under the Kynver AgentOS runtime.",
     "Immediately state your plan before editing.",
@@ -647,6 +657,8 @@ function buildPrompt(input) {
     "After each major step, append one JSON line to the heartbeat file with fields: ts, phase, summary, changedFiles, blocker.",
     "Final response must include files changed, verification commands, and unresolved risks.",
     "",
+    ...progressLines,
+    "",
     "Task:",
     input.task
   ].join("\n");
@@ -1513,6 +1525,102 @@ async function runDaemon(args) {
   console.error(JSON.stringify({ event: "daemon_stop", runId, agentOsId }));
 }
 
+// src/plan-progress.ts
+function parseEvidenceArg(raw) {
+  const idx = raw.indexOf(":");
+  if (idx <= 0) throw new Error(`invalid --evidence ${raw} (expected type:value)`);
+  return { type: raw.slice(0, idx), value: raw.slice(idx + 1) };
+}
+async function emitPlanProgress(args) {
+  const planId = required(args.plan ? String(args.plan) : void 0, "plan");
+  const agentOsId = (args.agentOsId ? String(args.agentOsId) : loadUserConfig().agentOsId) || "";
+  if (!agentOsId) {
+    console.error("requires --agent-os-id or agentOsId in ~/.kynver/config.json");
+    process.exit(1);
+  }
+  const roleLane = required(args.role ? String(args.role) : void 0, "role");
+  const status = required(args.status ? String(args.status) : void 0, "status");
+  const evidence = [];
+  const rawEvidence = args.evidence;
+  if (Array.isArray(rawEvidence)) {
+    for (const item of rawEvidence) evidence.push(parseEvidenceArg(String(item)));
+  } else if (typeof rawEvidence === "string") {
+    evidence.push(parseEvidenceArg(rawEvidence));
+  }
+  const base = resolveBaseUrl(args.baseUrl ? String(args.baseUrl) : void 0);
+  const secret = resolveCallbackSecret(args.secret ? String(args.secret) : void 0);
+  const url = `${base}/api/agent-os/by-id/${encodeURIComponent(agentOsId)}/plans/${encodeURIComponent(planId)}/progress-events`;
+  const cfg = loadUserConfig();
+  const provider = cfg.workerProvider ? `provider:${cfg.workerProvider}` : void 0;
+  const body = {
+    rowKey: args.row ? String(args.row) : void 0,
+    rowId: args.rowId ? String(args.rowId) : void 0,
+    taskId: args.task ? String(args.task) : void 0,
+    reviewTaskId: args.reviewTask ? String(args.reviewTask) : void 0,
+    roleLane,
+    status,
+    note: args.note ? String(args.note) : void 0,
+    remainingWork: args.remaining ? String(args.remaining) : void 0,
+    evidence: evidence.length ? evidence : void 0,
+    proposed: args.proposed === true || args.proposed === "true",
+    executorRef: args.executorRef ? String(args.executorRef) : provider
+  };
+  const res = await fetch(url, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      "X-OpenClaw-Cron-Secret": secret
+    },
+    body: JSON.stringify(body)
+  });
+  const text = await res.text();
+  let parsed = null;
+  try {
+    parsed = JSON.parse(text);
+  } catch {
+    parsed = text;
+  }
+  if (!res.ok) {
+    console.error(JSON.stringify({ httpStatus: res.status, response: parsed }, null, 2));
+    process.exit(1);
+  }
+  console.log(JSON.stringify(parsed, null, 2));
+}
+async function verifyPlan(args) {
+  const planId = required(args.plan ? String(args.plan) : void 0, "plan");
+  const slug = loadUserConfig().agentOsSlug;
+  if (!slug) {
+    console.error("requires agentOsSlug in ~/.kynver/config.json for verify (session route)");
+    process.exit(1);
+  }
+  const base = resolveBaseUrl(args.baseUrl ? String(args.baseUrl) : void 0);
+  const apiKey = process.env.KYNVER_API_KEY;
+  const headers = { "Content-Type": "application/json" };
+  if (apiKey) headers.Authorization = `Bearer ${apiKey}`;
+  const url = `${base}/api/agent-os/${encodeURIComponent(slug)}/plans/${encodeURIComponent(planId)}/verify`;
+  const res = await fetch(url, {
+    method: "POST",
+    headers,
+    body: JSON.stringify({
+      worktreePath: args.worktree ? String(args.worktree) : void 0,
+      taskId: args.task ? String(args.task) : void 0,
+      humanOverride: args.humanOverride === true || args.humanOverride === "true"
+    })
+  });
+  const text = await res.text();
+  let parsed = null;
+  try {
+    parsed = JSON.parse(text);
+  } catch {
+    parsed = text;
+  }
+  if (!res.ok) {
+    console.error(JSON.stringify({ httpStatus: res.status, response: parsed }, null, 2));
+    process.exit(1);
+  }
+  console.log(JSON.stringify(parsed, null, 2));
+}
+
 // src/cli.ts
 function isHelpFlag(arg) {
   return arg === "help" || arg === "--help" || arg === "-h";
@@ -1539,7 +1647,9 @@ function usage(code = 0) {
       "  kynver worker status --run RUN_ID --name worker",
       "  kynver worker tail --run RUN_ID --name worker [--lines 40] [--raw]",
       "  kynver worker stop --run RUN_ID --name worker",
-      "  kynver worker complete --run RUN_ID --name worker [--agent-os-id AOS_ID] [--task-id TASK_ID] [--base-url URL] [--secret SECRET]"
+      "  kynver worker complete --run RUN_ID --name worker [--agent-os-id AOS_ID] [--task-id TASK_ID] [--base-url URL] [--secret SECRET]",
+      "  kynver plan progress --plan PLAN_ID --row ROW_KEY --role ROLE --status STATUS [--task TASK_ID] [--note NOTE] [--evidence type:value] [--agent-os-id AOS_ID]",
+      "  kynver plan verify --plan PLAN_ID [--worktree PATH] [--task TASK_ID] [--human-override]"
     ].join("\n")
   );
   process.exit(code);
@@ -1549,7 +1659,7 @@ async function main(argv = process.argv.slice(2)) {
   const scope = argv.shift();
   let action;
   let rest;
-  if (scope === "run" || scope === "worker") {
+  if (scope === "run" || scope === "worker" || scope === "plan") {
     action = argv.shift();
     rest = argv;
   } else {
@@ -1562,6 +1672,8 @@ async function main(argv = process.argv.slice(2)) {
   if (scope === "login") return void await runLogin(args);
   if (scope === "setup") return void await runSetup(args);
   if (scope === "daemon") return void await runDaemon(args);
+  if (scope === "plan" && action === "progress") return void await emitPlanProgress(args);
+  if (scope === "plan" && action === "verify") return void await verifyPlan(args);
   if (scope === "run" && action === "create") return createRun(args);
   if (scope === "run" && action === "list") return listRuns();
   if (scope === "run" && action === "status") return runStatus(args);