@veewo/claw 0.2.4 → 0.2.6

package/dist/cli.js

@@ -6,11 +6,11 @@ import { createInterface } from "node:readline";
 import { pathToFileURL } from "node:url";
 import { createHash } from "node:crypto";
 import { spawn, spawnSync } from "node:child_process";
-import { buildDirectWorkflowGuidance, buildKnowledgeDelegateDispatch, buildKnowledgeAssignmentTemplate, buildKnowledgeWriterAssignments, DEFAULT_MAX_TASKS_TO_KEEP, checkProjectProtocol, ClawError, buildPlanWorkflowGuidance, buildMemoryIndex, buildSessionStartDefaultPrompt, buildSessionStartRecoveredPrompt, editPlan, ensureProjectProtocol, enforceTaskRetention, findKnowledgeFinalizationJobPath, findTaskDirectory, runDailyMaintenance, ingestTruth, initProject, getTemplateTaskDoneChoices, resolvePlanTemplateFile, resolvePlanEffectiveConfig, resolveProjectContext, resolveWorkflowProjectContext, resolveSessionWorkflowContext, deleteSessionWorkflow, sweepExpiredSessionWorkflows, resolveSessionBoundPlan, resolveContext, resolveSeedPlanTemplate, searchMemoryAsync, warmProjectMemoryEmbedding, showPlan, createSubplan, switchTask, tryCaptureKnowledgeStop, claimKnowledgeFinalizationJob, doneKnowledgeFinalizationJob, readKnowledgeFinalizationJob, waitForKnowledgeFinalizationJobReady, listKnowledgeFinalizationJobs, listRetryableKnowledgeFinalizationJobs, normalizeTruthMarkdownEncoding, recordKnowledgeFinalizationResult, unbindSession, writePlan, } from "@veewo/claw-core";
+import { buildDirectWorkflowGuidance, appendKnowledgeTaskConclusions, buildKnowledgeAtomicDispatch, buildKnowledgeDelegateDispatch, buildKnowledgeAssignmentTemplate, buildKnowledgeWriterAssignments, DEFAULT_MAX_TASKS_TO_KEEP, checkProjectProtocol, ClawError, buildPlanWorkflowGuidance, buildMemoryIndex, buildSessionStartDefaultPrompt, buildSessionStartRecoveredPrompt, editPlan, ensureProjectProtocol, enforceTaskRetention, findKnowledgeFinalizationJobPath, findTaskDirectory, runDailyMaintenance, ingestTruth, initProject, getTemplateTaskDoneChoices, resolvePlanTemplateFile, resolvePlanEffectiveConfig, resolveKnowledgeWriterForHost, resolveProjectContext, resolveWorkflowProjectContext, resolveSessionWorkflowContext, deleteSessionWorkflow, sweepExpiredSessionWorkflows, resolveSessionBoundPlan, resolveContext, resolveSeedPlanTemplate, searchMemoryAsync, warmProjectMemoryEmbedding, showPlan, createSubplan, switchTask, tryCaptureKnowledgeStop, claimKnowledgeFinalizationJob, doneKnowledgeFinalizationJob, readKnowledgeFinalizationJob, waitForKnowledgeFinalizationJobReady, listKnowledgeFinalizationJobs, listRetryableKnowledgeFinalizationJobs, normalizeTruthMarkdownEncoding, recordKnowledgeFinalizationResult, unbindSession, writePlan, } from "@veewo/claw-core";
 import { buildCodexDriverEnvelope } from "./codex-driver.js";
 import { buildCodexHostActions } from "./codex-host-actions.js";
 import { checkCodexRuntime, resolveCodexSdkEntryPath } from "./codex-runtime.js";
-import { extractLatestFinalAssistantMessage, extractTaskDoneConclusions, } from "./codex-transcript.js";
+import { extractLatestFinalAssistantMessage, extractTaskDoneConclusions, findCodexTranscriptPath, } from "./codex-transcript.js";
 import { consumeBufferedHookInput } from "./knowledge-hook-preflight.js";
 import { resolveInvocationHost, withoutInvocationHost } from "./invocation-host.js";
 import { runOpencodeKnowledgeWriter } from "./opencode-runner.js";
@@ -283,7 +283,7 @@ const COMMAND_HELP = {
                 description: "Create a flat subplan file under the task directory. Uses explicit `--template` first, otherwise the project's configured `defaultPlanTemplate`, and finally falls back to the built-in `default`. The current session binding switches to the subplan and returns to its parent when the subplan ends.",
                 summary: "Create a subplan under a parent task's task item.",
                 options: [
-                    { flag: "--parent <task-name>", detail: "(required) Parent task name." },
+                    { flag: "--parent <task-name>", detail: "(required) Parent task directory name (`taskName`), not its plan title." },
                     { flag: "--task-id <number>", detail: "(required) Parent task item id to split into a subplan." },
                     { flag: "--template <name>", detail: "Optional plan template name. Overrides the project's configured default template." },
                     { flag: "--template-file <path>", detail: "Exact plan template file. Mutually exclusive with --template." },
@@ -336,10 +336,17 @@ const COMMAND_HELP = {
                 ],
             },
             claim: {
-                usage: ["{script} knowledge claim --job <path>"],
-                description: "Claim a queued or retryable job after its executor session has been bound.",
-                summary: "Claim a session-bound finalization job.",
-                options: [{ flag: "--job <path>", detail: "(required) Finalization job JSON path." }],
+                usage: [
+                    "{script} knowledge claim --job <path>",
+                    "{script} knowledge claim --project-root <path> --finalize-id <id>",
+                ],
+                description: "Claim a queued or retryable job. Codex subagent claims capture the existing task conclusions from the parent transcript before ownership is granted.",
+                summary: "Claim a ready finalization job and prepare its report.",
+                options: [
+                    { flag: "--job <path>", detail: "Exact finalization job JSON path." },
+                    { flag: "--project-root <path>", detail: "Project that owns a ready finalization job." },
+                    { flag: "--finalize-id <id>", detail: "Finalization id used with --project-root." },
+                ],
             },
             done: {
                 usage: [
@@ -977,6 +984,38 @@ function serializeSessionError(error) {
     }
     return { code: "SESSION_COMMAND_FAILED", message: error instanceof Error ? error.message : String(error) };
 }
+function readCindyKnowledgeClaimCaptureInput() {
+    const raw = fs.readFileSync(0, "utf8").trim();
+    if (!raw) {
+        throw new ClawError("PROJECT_CONFIG_INVALID", "Cindy knowledge claim report input is empty.");
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        throw new ClawError("PROJECT_CONFIG_INVALID", "Cindy knowledge claim report input is invalid JSON.");
+    }
+    const sessionId = typeof parsed.session_id === "string" ? parsed.session_id.trim() : "";
+    const turnId = typeof parsed.turn_id === "string" ? parsed.turn_id.trim() : "";
+    const taskConclusions = Array.isArray(parsed.task_conclusions)
+        ? parsed.task_conclusions.flatMap((entry) => {
+            if (!entry || typeof entry !== "object" || Array.isArray(entry))
+                return [];
+            const item = entry;
+            const itemTurnId = typeof item.turnId === "string" ? item.turnId.trim() : "";
+            const message = typeof item.message === "string" ? item.message.trim() : "";
+            return itemTurnId && message ? [{ turnId: itemTurnId, message }] : [];
+        })
+        : [];
+    if (!sessionId || !turnId) {
+        throw new ClawError("PROJECT_CONFIG_INVALID", "Cindy knowledge claim report input requires session_id and turn_id.");
+    }
+    if (taskConclusions.length === 0) {
+        throw new ClawError("PROJECT_CONFIG_INVALID", "Cindy knowledge claim report input requires at least one task conclusion.");
+    }
+    return { sessionId, turnId, taskConclusions };
+}
 function runKnowledge(args) {
     const subcommand = args.shift();
     switch (subcommand) {
@@ -1039,9 +1078,68 @@ function runKnowledge(args) {
             return;
         }
         case "claim": {
-            const jobPath = readRequiredFlag(args, "--job");
+            const explicitJobPath = readOptionalFlag(args, "--job");
+            const projectRoot = readOptionalFlag(args, "--project-root");
+            const finalizeId = readOptionalFlag(args, "--finalize-id");
+            const captureCindyReport = readBooleanFlag(args, "--cindy-report-stdin");
+            const cindyCapture = captureCindyReport ? readCindyKnowledgeClaimCaptureInput() : undefined;
+            if (explicitJobPath && (projectRoot || finalizeId)) {
+                throw new ClawError("PROJECT_CONFIG_INVALID", "knowledge claim accepts either --job or --project-root with --finalize-id.");
+            }
+            if (!explicitJobPath && (!projectRoot || !finalizeId)) {
+                throw new ClawError("PROJECT_CONFIG_INVALID", "knowledge claim requires --job or both --project-root and --finalize-id.");
+            }
             assertNoRemainingArgs(args, "knowledge claim");
-            const job = claimKnowledgeFinalizationJob(jobPath);
+            const jobPath = explicitJobPath ?? findKnowledgeFinalizationJobPath(resolveProjectContext(path.resolve(projectRoot)), finalizeId);
+            if (!jobPath) {
+                throw new Error(`Knowledge finalization ${finalizeId} is unavailable.`);
+            }
+            const job = claimKnowledgeFinalizationJob(jobPath, {
+                prepare: (queued) => {
+                    if (queued.writer?.executionPolicy !== "subagent"
+                        || queued.reportCapture?.mode !== "claim"
+                        || queued.reportCapture.status === "captured") {
+                        return;
+                    }
+                    if (queued.host === "cindy") {
+                        if (!cindyCapture) {
+                            throw new Error(`Cindy report capture is unavailable for knowledge session ${queued.sessionId}.`);
+                        }
+                        if (cindyCapture.sessionId !== queued.sessionId) {
+                            throw new Error("Cindy report capture does not match the originating knowledge session.");
+                        }
+                        const capturedAt = new Date().toISOString();
+                        appendKnowledgeTaskConclusions(queued.reportPath, queued.sessionId, cindyCapture.taskConclusions, capturedAt);
+                        return {
+                            reportCapture: {
+                                ...queued.reportCapture,
+                                status: "captured",
+                                capturedAt,
+                                messageCount: cindyCapture.taskConclusions.length,
+                            },
+                        };
+                    }
+                    if (queued.host !== "codex") {
+                        throw new Error(`Claim-time report capture is unavailable for host ${queued.host ?? "unknown"}.`);
+                    }
+                    const transcriptPath = findCodexTranscriptPath(queued.sessionId);
+                    if (!transcriptPath) {
+                        throw new Error(`Codex transcript is unavailable for knowledge session ${queued.sessionId}.`);
+                    }
+                    const conclusions = extractTaskDoneConclusions(transcriptPath, undefined, queued.reportCapture.startedAt);
+                    const capturedAt = new Date().toISOString();
+                    appendKnowledgeTaskConclusions(queued.reportPath, queued.sessionId, conclusions, capturedAt);
+                    return {
+                        reportCapture: {
+                            ...queued.reportCapture,
+                            status: "captured",
+                            capturedAt,
+                            transcriptPath,
+                            messageCount: conclusions.length,
+                        },
+                    };
+                },
+            });
             const assignments = job ? buildKnowledgeWriterAssignments(job) : [];
             const templatePath = job
                 ? path.join(path.dirname(jobPath), `${job.finalizeId}.assignments.json`)
@@ -1059,6 +1157,7 @@ function runKnowledge(args) {
                 claimed: Boolean(job),
                 ...(job ? {
                     finalizeId: job.finalizeId,
+                    jobPath,
                     claimToken: job.claimToken,
                     projectRoot: job.projectRoot,
                     writer: job.writer ?? null,
@@ -1139,14 +1238,15 @@ async function runPlan(args, effectiveHost) {
                 ? showPlan({ cwd: process.cwd(), ...target, ownerSessionKey })
                 : undefined;
             const project = entersEndTerminal ? tryResolveHookProject(process.cwd()) : null;
-            const effectiveWriter = current && project
+            const effectiveWriter = resolveKnowledgeWriterForHost(current && project
                 ? resolvePlanEffectiveConfig(project.projectConfig, current.plan)?.knowledgeWriter
-                : undefined;
+                : undefined, effectiveHost);
             if (current
                 && !current.plan.parentPlan
                 && effectiveWriter?.executionPolicy === "subagent"
-                && effectiveHost !== "codex") {
-                throw new ClawError("PROJECT_CONFIG_INVALID", 'knowledgeWriter.executionPolicy "subagent" is supported only by the Codex host.', { host: effectiveHost ?? null });
+                && effectiveHost !== "codex"
+                && effectiveHost !== "cindy") {
+                throw new ClawError("PROJECT_CONFIG_INVALID", 'knowledgeWriter.executionPolicy "subagent" is supported only by the Codex or Cindy host.', { host: effectiveHost ?? null });
             }
             const queuePlanEndFinalization = entersEndTerminal
                 ? preparePlanEndFinalization(process.cwd(), ownerSessionKey)
@@ -1162,11 +1262,12 @@ async function runPlan(args, effectiveHost) {
             const completionRefresh = queuePlanEndFinalization?.(result.taskName);
             const knowledgeDispatch = (current
                 && project
-                && effectiveHost === "codex"
+                && (effectiveHost === "codex" || effectiveHost === "cindy")
                 && !current.plan.parentPlan
                 && effectiveWriter?.executionPolicy === "subagent"
                 && result.knowledgeFinalizeId)
                 ? buildKnowledgeDispatch({
+                    host: effectiveHost,
                     finalizeId: result.knowledgeFinalizeId,
                     writer: effectiveWriter,
                 })
@@ -1245,13 +1346,14 @@ async function runPlan(args, effectiveHost) {
                 ownerSessionKey,
             });
             const project = tryResolveHookProject(process.cwd());
-            const effectiveWriter = project
+            const effectiveWriter = resolveKnowledgeWriterForHost(project
                 ? resolvePlanEffectiveConfig(project.projectConfig, current.plan)?.knowledgeWriter
-                : undefined;
+                : undefined, effectiveHost);
             if (!current.plan.parentPlan
                 && effectiveWriter?.executionPolicy === "subagent"
-                && effectiveHost !== "codex") {
-                throw new ClawError("PROJECT_CONFIG_INVALID", 'knowledgeWriter.executionPolicy "subagent" is supported only by the Codex host.', { host: effectiveHost ?? null });
+                && effectiveHost !== "codex"
+                && effectiveHost !== "cindy") {
+                throw new ClawError("PROJECT_CONFIG_INVALID", 'knowledgeWriter.executionPolicy "subagent" is supported only by the Codex or Cindy host.', { host: effectiveHost ?? null });
             }
             const queuePlanEndFinalization = preparePlanEndFinalization(process.cwd(), ownerSessionKey);
             const result = await editPlan({
@@ -1263,11 +1365,12 @@ async function runPlan(args, effectiveHost) {
                 ownerSessionKey,
             });
             const completionRefresh = queuePlanEndFinalization?.(result.taskName);
-            const knowledgeDispatch = (effectiveHost === "codex"
+            const knowledgeDispatch = ((effectiveHost === "codex" || effectiveHost === "cindy")
                 && !current.plan.parentPlan
                 && effectiveWriter?.executionPolicy === "subagent"
                 && result.knowledgeFinalizeId)
                 ? buildKnowledgeDispatch({
+                    host: effectiveHost,
                     finalizeId: result.knowledgeFinalizeId,
                     writer: effectiveWriter,
                 })
@@ -1394,7 +1497,7 @@ async function runTask(args, effectiveHost) {
                 cwd: process.cwd(),
                 ...target,
                 operations,
-                commandSource: "plan.edit",
+                commandSource: "task.add",
                 host: effectiveHost,
                 ownerSessionKey: resolveOwnerSessionKey() ?? undefined,
             });
@@ -1410,7 +1513,7 @@ async function runTask(args, effectiveHost) {
                 cwd: process.cwd(),
                 ...target,
                 operations,
-                commandSource: "plan.edit",
+                commandSource: "task.edit",
                 host: effectiveHost,
                 ownerSessionKey: resolveOwnerSessionKey() ?? undefined,
             });
@@ -1426,7 +1529,7 @@ async function runTask(args, effectiveHost) {
                 cwd: process.cwd(),
                 ...target,
                 operations,
-                commandSource: "plan.edit",
+                commandSource: "task.remove",
                 host: effectiveHost,
                 ownerSessionKey: resolveOwnerSessionKey() ?? undefined,
             });
@@ -1442,6 +1545,7 @@ async function runTask(args, effectiveHost) {
                 cwd: process.cwd(),
                 ...target,
                 operations,
+                commandSource: "task.done",
                 host: effectiveHost,
                 ownerSessionKey: resolveOwnerSessionKey() ?? undefined,
             });
@@ -2805,9 +2909,13 @@ function stripBom(content) {
     return content.charCodeAt(0) === 0xfeff ? content.slice(1) : content;
 }
 function buildKnowledgeDispatch(input) {
+    if (input.host === "cindy") {
+        return buildKnowledgeAtomicDispatch(input);
+    }
     return buildKnowledgeDelegateDispatch({
         policy: "subagent",
-        ...input,
+        finalizeId: input.finalizeId,
+        writer: input.writer,
     });
 }
 function compactPlanCommandResult(command, result, effectiveHost, completionRefresh, forceProjectionSync = false, knowledgeDispatch) {