brainclaw 1.14.0 → 1.16.0

package/dist/cli/register-planning.js

@@ -0,0 +1,167 @@
+import { runPlanResource } from '../commands/plan-resource.js';
+import { runMove } from '../commands/move.js';
+import { runListPlans } from '../commands/list-plans.js';
+import { runSequenceResource } from '../commands/sequence.js';
+import { runAddStep } from '../commands/add-step.js';
+import { runCompleteStep } from '../commands/complete-step.js';
+import { runUpdateStep } from '../commands/update-step.js';
+import { runDeleteStep } from '../commands/delete-step.js';
+import { runEstimationReport } from '../commands/estimation-report.js';
+import { runUpdatePlan } from '../commands/update-plan.js';
+import { runSurfaceTaskResource } from '../commands/surface-task-resource.js';
+import { runDeletePlan } from '../commands/delete-plan.js';
+export function registerPlanningCommands(program) {
+    // --- plan ---
+    program
+        .command('plan <subcommand> [args...]')
+        .description('Manage shared plan items (create, list, update, delete)')
+        .option('--json', 'Output as JSON for list')
+        .option('--all', 'Include done and dropped plan items in list')
+        .option('--type <type>', 'Plan type or filter: feat, fix, chore, spike, doc')
+        .option('--status <status>', 'Status filter/update: todo, in_progress, blocked, done, dropped')
+        .option('--priority <priority>', 'Priority: low, medium, high', 'medium')
+        .option('--assignee <assignee>', 'Assignee for this plan item')
+        .option('--project <project>', 'Optional project namespace')
+        .option('--tag <tags...>', 'Tags for this plan item')
+        .option('--path <paths...>', 'Related file paths')
+        .option('--depends-on <ids...>', 'Dependency IDs for this plan item')
+        .option('--author <author>', 'Author name')
+        .option('--estimate <minutes>', 'Estimated effort in minutes (positive integer, e.g. --estimate 30)')
+        .option('--actual-effort <effort>', 'Actual effort spent (e.g. "20min", "1h30m")')
+        .option('--store <target>', 'Target store level: local (default), repo, workspace, user')
+        .option('--recursive', 'Include plans from descendant brainclaw projects (for list)')
+        .option('--local-only', 'Read from local store only for list (skip parent stores in chain)')
+        .action((subcommand, args, options) => {
+        runPlanResource(subcommand, args, { ...options, actualEffort: options.actualEffort, localOnly: options.localOnly });
+    });
+    // --- move (cross-project relocation, pln#595) ---
+    program
+        .command('move <entity> <id>')
+        .description('Relocate a brainclaw item to another project, id-preserving (multi-project workspaces). Relocatable: plan, decision, constraint, trap, handoff, sequence.')
+        .requiredOption('--to <project>', 'Target project (name, path, or basename)')
+        .option('--from <project>', 'Source project (defaults to the current project)')
+        .option('--force', 'Move even if an active claim references the item')
+        .option('--json', 'Output as JSON')
+        .action((entity, id, options) => runMove(entity, id, options));
+    // --- list-plans ---
+    program
+        .command('list-plans')
+        .description('List shared plan items')
+        .option('--json', 'Output as JSON')
+        .option('--status <status>', 'Status: todo, in_progress, blocked, done, dropped')
+        .option('--type <type>', 'Filter by type: feat, fix, chore, spike, doc')
+        .option('--assignee <assignee>', 'Filter by assignee')
+        .option('--project <project>', 'Filter by project namespace')
+        .option('--all', 'Include done and dropped plan items')
+        .option('--recursive', 'Include plans from descendant brainclaw projects')
+        .option('--local-only', 'Read from local store only (skip parent stores in chain)')
+        .action((options) => {
+        runListPlans({ ...options, localOnly: options.localOnly });
+    });
+    program
+        .command('sequence <subcommand> [args...]')
+        .description('Manage coordination sequences (create, list, show, update)')
+        .option('--json', 'Output as JSON')
+        .option('--description <text>', 'Optional sequence description')
+        .option('--status <status>', 'Sequence status: draft, active, archived')
+        .option('--owner <owner>', 'Optional sequence owner')
+        .option('--items <json>', 'Sequence items JSON array')
+        .option('--name <name>', 'Optional sequence name for update')
+        .option('--tag <tags...>', 'Tags for this sequence')
+        .option('--author <author>', 'Author name')
+        .action((subcommand, args, options) => {
+        runSequenceResource(subcommand, args, options);
+    });
+    // --- add-step ---
+    program
+        .command('add-step <planId> <text>')
+        .description('Add an optional step to a plan item')
+        .option('--assign <assignee>', 'Assign this step to an agent or person')
+        .option('--estimate <minutes>', 'Step-level estimate (minutes, or a duration like "2h"/"30m")')
+        .option('--actual-effort <effort>', 'Step-level actual effort (e.g. "45m", "2h")')
+        .action((planId, text, options) => {
+        runAddStep(planId, text, { assignee: options.assign, estimatedEffort: options.estimate, actualEffort: options.actualEffort });
+    });
+    // --- complete-step ---
+    program
+        .command('complete-step <planId> <stepId>')
+        .description('Mark a plan step as done')
+        .action((planId, stepId) => {
+        runCompleteStep(planId, stepId);
+    });
+    // --- update-step ---
+    program
+        .command('update-step <planId> <stepId>')
+        .description('Update a plan step (status, text, assignee, effort)')
+        .option('--status <status>', 'New status: todo, in_progress, testing, done, blocked')
+        .option('--text <text>', 'Replace step description')
+        .option('--assign <assignee>', 'Assign the step (empty string to unassign)')
+        .option('--estimate <minutes>', 'Step-level estimate (minutes, or a duration like "2h"/"30m")')
+        .option('--actual-effort <effort>', 'Step-level actual effort (e.g. "45m", "2h")')
+        .action((planId, stepId, options) => {
+        runUpdateStep(planId, stepId, options);
+    });
+    // --- delete-step ---
+    program
+        .command('delete-step <planId> <stepId>')
+        .description('Remove a step from a plan')
+        .action((planId, stepId) => {
+        runDeleteStep(planId, stepId);
+    });
+    // --- estimation-report ---
+    program
+        .command('estimation-report')
+        .description('Show estimation accuracy report for completed plans')
+        .option('--agent <name>', 'Filter by agent/author name')
+        .option('--json', 'Output as JSON')
+        .option('--outlier-threshold <minutes>', 'Drop plan-wallclock actuals over N minutes from the stats (default 1440 = 24h; 0 disables)')
+        .action((options) => {
+        runEstimationReport({
+            agent: options.agent,
+            json: options.json,
+            outlierThresholdMinutes: options.outlierThreshold !== undefined ? Number(options.outlierThreshold) : undefined,
+        });
+    });
+    // --- update-plan ---
+    program
+        .command('update-plan <id>')
+        .description('Update a shared plan item')
+        .option('--status <status>', 'Status: todo, in_progress, blocked, done, dropped')
+        .option('--assignee <assignee>', 'Assign a user or agent to this plan item')
+        .option('--project <project>', 'Set or change project namespace')
+        .option('--priority <priority>', 'Priority: low, medium, high')
+        .option('--actual-effort <effort>', 'Actual effort spent (e.g. "20min", "1h30m")')
+        .action((id, options) => {
+        runUpdatePlan(id, { ...options, actualEffort: options.actualEffort });
+    });
+    // --- surface-task ---
+    program
+        .command('surface-task <subcommand> [args...]')
+        .description('Manage queued tasks for desktop AI surfaces such as ChatGPT Desktop or Claude Desktop')
+        .option('--json', 'Output as JSON for list')
+        .option('--all', 'Include completed, cancelled, and failed tasks in list')
+        .option('--status <status>', 'Status filter/update: queued, in_progress, completed, cancelled, failed')
+        .option('--target <surface>', 'Target surface, e.g. chatgpt, claude, gemini')
+        .option('--kind <kind>', 'Task kind: visual_asset, draft, summary, analysis, research, custom')
+        .option('--instructions <text>', 'Detailed instructions for the target surface')
+        .option('--output <paths...>', 'Expected output paths')
+        .option('--result <text>', 'Optional result note when updating a task')
+        .option('--tag <tags...>', 'Tags for this task')
+        .option('--path <paths...>', 'Related file paths')
+        .option('--agent <agent>', 'Author agent name')
+        .option('--agent-id <agentId>', 'Author agent id')
+        .action((subcommand, args, options) => {
+        runSurfaceTaskResource(subcommand, args, {
+            ...options,
+            agentId: options.agentId,
+        });
+    });
+    // --- delete-plan ---
+    program
+        .command('delete-plan <id>')
+        .description('Delete a shared plan item')
+        .action((id) => {
+        runDeletePlan(id);
+    });
+}
+//# sourceMappingURL=register-planning.js.map

package/dist/cli/register-review.js

@@ -0,0 +1,149 @@
+import { runReview } from '../commands/review.js';
+import { runShowCandidate } from '../commands/show-candidate.js';
+import { runStarCandidate } from '../commands/star-candidate.js';
+import { runUseCandidate } from '../commands/use-candidate.js';
+import { runAccept } from '../commands/accept.js';
+import { runAdapterOpenclawImport } from '../commands/adapter-openclaw-import.js';
+import { runReject } from '../commands/reject.js';
+import { runHarvestCandidates, runHarvestLane } from '../commands/harvest.js';
+import { runPruneCandidates } from '../commands/prune-candidates.js';
+import { cleanupStaleCandidates } from '../core/candidates.js';
+import { memoryExists } from '../core/io.js';
+import { collect } from './shared.js';
+export function registerReviewCommands(program) {
+    // --- review ---
+    program
+        .command('review')
+        .description('List pending memory candidates')
+        .option('--json', 'Output as JSON')
+        .option('--type <type>', 'Filter by type')
+        .option('--prioritized', 'Sort by review priority and show SLA')
+        .option('--only-overdue', 'Show only candidates overdue review SLA')
+        .option('--assignee <assignee>', 'Filter by assignee tag (assignee:<name>)')
+        .option('--for-curator <curator>', 'Shortcut assignee filter for curator queue')
+        .option('--take <count>', 'Limit number of reviewed items', parseInt)
+        .option('--claim <curator>', 'Atomically assign selected candidates to a curator')
+        .option('--auto', 'Auto-promote candidates meeting the configured score threshold')
+        .option('--auto-by <actor>', 'Actor identity for auto-promotion (defaults to current user)')
+        .action((options) => {
+        runReview({ ...options, autoBy: options.autoBy });
+    });
+    // --- show-candidate ---
+    program
+        .command('show-candidate <id>')
+        .description('Show details of a memory candidate')
+        .option('--related', 'Show related candidates by shared tags/paths')
+        .action((id, options) => {
+        runShowCandidate(id, { related: options.related });
+    });
+    // --- star-candidate ---
+    program
+        .command('star-candidate <id>')
+        .description('Add an adoption star to a pending candidate')
+        .option('--by <actor>', 'Agent or person adding the star')
+        .action((id, options) => {
+        runStarCandidate(id, options);
+    });
+    // --- use-candidate ---
+    program
+        .command('use-candidate <id>')
+        .description('Record that a pending candidate was reused in a concrete work context')
+        .option('--by <actor>', 'Agent or person using the candidate')
+        .requiredOption('--context <context>', 'Work context where the candidate was reused')
+        .action((id, options) => {
+        runUseCandidate(id, options);
+    });
+    // --- accept ---
+    program
+        .command('accept <id>')
+        .description('Accept a candidate into canonical memory')
+        .option('--by <reviewer>', 'Reviewer identity used for governance checks')
+        .action((id, options) => {
+        runAccept(id, options.by);
+    });
+    // --- adapter-openclaw-import ---
+    program
+        .command('adapter-openclaw-import [file]')
+        .description('Import OpenClaw runtime events file as memory candidates')
+        .option('--session <id>', 'Import runtime events from a session id in .brainclaw/runtime/')
+        .option('--dry-run', 'Preview import without creating candidates')
+        .option('--source <source>', 'Source label for imported candidates', 'openclaw')
+        .option('--author <author>', 'Author for imported candidates')
+        .action((file, options) => {
+        runAdapterOpenclawImport(file, options);
+    });
+    // --- reject ---
+    program
+        .command('reject <id>')
+        .description('Reject a memory candidate')
+        .option('--by <reviewer>', 'Reviewer identity used for rejection attribution')
+        .option('--reason <reason>', 'Reason for rejection')
+        .action((id, options) => {
+        runReject(id, options.reason, options.by);
+    });
+    // --- harvest-candidates ---
+    program
+        .command('harvest-candidates')
+        .description('Harvest candidates from worktree inboxes into the main project store (codex sandbox bridge)')
+        .option('--dry-run', 'Preview what would be imported without writing anything')
+        .option('--worktree <path>', 'Explicit worktree path to scan (repeatable)', collect, [])
+        .option('--json', 'Output as JSON')
+        .action((options) => {
+        const globalOpts = program.opts();
+        runHarvestCandidates({ ...options, cwd: globalOpts.cwd });
+    });
+    // --- harvest (lane results, pln#526) ---
+    program
+        .command('harvest [assignment_id]')
+        .description('Harvest a worker LANE-RESULT.json from its worktree into the project (pass an assignment id, or --all)')
+        .option('--all', 'Harvest every lane result found across worktrees')
+        .option('--integrate', 'Worktree-as-contract (pln#534): commit the worktree diff on behalf of a sandboxed worker, lifecycle the assignment, and release the claim')
+        .option('--orphaned', 'Recover a dead worker that left NO lane-result (pln#554): typecheck + commit the worktree on behalf, lifecycle, release. Never deletes or resets anything')
+        .option('--base <ref>', 'Base ref for --orphaned commits-ahead comparison (default: master)')
+        .option('--dry-run', 'Preview without writing events/markers')
+        .option('--worktree <path>', 'Explicit worktree path to scan (repeatable)', collect, [])
+        .option('--json', 'Output as JSON')
+        .action((assignmentId, options) => {
+        const globalOpts = program.opts();
+        runHarvestLane(assignmentId, { ...options, cwd: globalOpts.cwd });
+    });
+    // --- prune-candidates ---
+    program
+        .command('prune-candidates')
+        .description('Remove old rejected candidates')
+        .option('--days <days>', 'Max age in days', parseInt)
+        .option('--dry-run', 'Preview without deleting')
+        .action((options) => {
+        runPruneCandidates(options);
+    });
+    // --- cleanup-candidates ---
+    program
+        .command('cleanup-candidates')
+        .description('Remove stale auto-generated pending candidates')
+        .option('--max-age <days>', 'Max age in days before cleanup', parseInt)
+        .option('--dry-run', 'Preview without deleting')
+        .action((options) => {
+        if (!memoryExists()) {
+            console.error('Error: .brainclaw/ not found. Run `brainclaw init` first.');
+            process.exit(1);
+        }
+        const maxAgeDays = options.maxAge ?? 30;
+        const result = cleanupStaleCandidates({
+            maxAgeDays,
+            dryRun: options.dryRun,
+        });
+        if (result.matched === 0) {
+            console.log(`No stale auto-generated candidates older than ${maxAgeDays} days found.`);
+            return;
+        }
+        if (options.dryRun) {
+            console.log(`Would remove ${result.matched} stale auto-generated candidate(s):`);
+            for (const candidate of result.candidates) {
+                console.log(`  [${candidate.id}] ${candidate.text}`);
+            }
+            return;
+        }
+        console.log(`✔ Removed ${result.deleted} stale auto-generated candidate(s) older than ${maxAgeDays} days.`);
+    });
+}
+//# sourceMappingURL=register-review.js.map

package/dist/cli/shared.js

@@ -0,0 +1,5 @@
+// pln#622 PR5 — helpers shared across CLI register modules.
+export function collect(value, previous) {
+    return [...previous, value];
+}
+//# sourceMappingURL=shared.js.map