zigrix 0.1.1 → 0.2.0

package/dist/index.js

@@ -1,13 +1,15 @@
 #!/usr/bin/env node
 import fs from 'node:fs';
+import path from 'node:path';
 import { Command } from 'commander';
 import { addAgent, excludeAgent, includeAgent, listAgents, removeAgent, setAgentEnabled, setAgentRole, } from './agents/registry.js';
 import { runConfigure } from './configure.js';
-import { diffValues, getValueAtPath, parseConfigInput, resetValueAtPath, setValueAtPath } from './config/mutate.js';
+import { diffValues, getValueAtPath, parseConfigInput, resetValueAtPath, setValueAtPath, } from './config/mutate.js';
 import { defaultConfig, resolveAbsolutePath } from './config/defaults.js';
 import { getConfigValue, loadConfig, writeConfigFile, writeDefaultConfig } from './config/load.js';
 import { zigrixConfigJsonSchema } from './config/schema.js';
-import { gatherDoctor, renderDoctorText } from './doctor.js';
+import { gatherDoctor, gatherDoctorFailure, renderDoctorText } from './doctor.js';
+import { importOrchestrationState } from './migrate/import-orchestration.js';
 import { runOnboard } from './onboard.js';
 import { dispatchTask, resolveConfiguredProjectDir } from './orchestration/dispatch.js';
 import { collectEvidence, mergeEvidence } from './orchestration/evidence.js';
@@ -55,6 +57,27 @@ function loadRuntime() {
     const loaded = loadConfig();
     return { ...loaded, paths: resolvePaths(loaded.config) };
 }
+function resolveAgentsStateDir(config) {
+    const configuredHome = typeof config.openclaw.home === 'string' ? config.openclaw.home.trim() : '';
+    const openclawHome = configuredHome || process.env.OPENCLAW_HOME || '';
+    if (!openclawHome)
+        return null;
+    return path.join(openclawHome, 'agents');
+}
+function parseVerificationMap(raw) {
+    const [dod, test] = raw.split(/=(.*)/s, 2);
+    const left = dod?.trim() ?? '';
+    const right = test?.trim() ?? '';
+    if (!left || !right) {
+        throw new Error(`invalid verification map format: ${raw} (expected dod=test)`);
+    }
+    return { dod: left, test: right };
+}
+function runImportOrchestrationCommand(fromDir, yes) {
+    requireYes(yes, 'import legacy orchestration state');
+    const loaded = loadRuntime();
+    return importOrchestrationState(loaded.paths, { fromDir });
+}
 function listRuntimePathValues(loaded) {
     return {
         configPath: loaded.configPath,
@@ -112,14 +135,21 @@ program
     .version(pkgVersion);
 const config = program.command('config').description('Inspect Zigrix config');
 const pathCmd = program.command('path').description('Resolve runtime paths from Zigrix config');
-const agent = program.command('agent').description('Manage Zigrix agent registry and orchestration membership');
+const agent = program
+    .command('agent')
+    .description('Manage Zigrix agent registry and orchestration membership');
 const rule = program.command('rule').description('Inspect and validate rule assets');
 const template = program.command('template').description('Inspect and modify prompt templates');
-const reset = program.command('reset').description('Restore default config sections or clean runtime state');
+const reset = program
+    .command('reset')
+    .description('Restore default config sections or clean runtime state');
 const state = program.command('state').description('Inspect and verify runtime state');
+const migrate = program.command('migrate').description('Import legacy runtime state into Zigrix');
 const task = program.command('task').description('Task operations');
 const worker = program.command('worker').description('Worker lifecycle operations');
-const evidence = program.command('evidence').description('Evidence collection and merge operations');
+const evidence = program
+    .command('evidence')
+    .description('Evidence collection and merge operations');
 const report = program.command('report').description('User-facing reporting helpers');
 const pipeline = program.command('pipeline').description('High-level orchestration helpers');
 // ─── onboard ────────────────────────────────────────────────────────────────
@@ -184,8 +214,14 @@ program
     .description('Inspect environment, config, and runtime readiness')
     .option('--json')
     .action((options) => {
-    const loaded = loadRuntime();
-    const payload = gatherDoctor(loaded, loaded.paths);
+    let payload;
+    try {
+        const loaded = loadRuntime();
+        payload = gatherDoctor(loaded, loaded.paths);
+    }
+    catch (error) {
+        payload = gatherDoctorFailure(error);
+    }
     if (options.json) {
         printValue(payload, true);
         return;
@@ -307,8 +343,22 @@ agent
     .option('--json')
     .action((options) => {
     const loaded = loadConfig();
-    const result = addAgent(loaded.config, { id: options.id, role: options.role, runtime: options.runtime, label: options.label, enabled: !options.disabled, include: Boolean(options.include) });
-    persistAndPrintMutation({ configPath: loaded.configPath, baseDir: loaded.baseDir, nextConfig: result.config, json: options.json, action: 'agent.add', agentId: result.agentId });
+    const result = addAgent(loaded.config, {
+        id: options.id,
+        role: options.role,
+        runtime: options.runtime,
+        label: options.label,
+        enabled: !options.disabled,
+        include: Boolean(options.include),
+    });
+    persistAndPrintMutation({
+        configPath: loaded.configPath,
+        baseDir: loaded.baseDir,
+        nextConfig: result.config,
+        json: options.json,
+        action: 'agent.add',
+        agentId: result.agentId,
+    });
 });
 agent
     .command('remove <agentId>')
@@ -316,7 +366,14 @@ agent
     .action((agentId, options) => {
     const loaded = loadConfig();
     const result = removeAgent(loaded.config, agentId);
-    persistAndPrintMutation({ configPath: loaded.configPath, baseDir: loaded.baseDir, nextConfig: result.config, json: options.json, action: 'agent.remove', agentId: result.agentId });
+    persistAndPrintMutation({
+        configPath: loaded.configPath,
+        baseDir: loaded.baseDir,
+        nextConfig: result.config,
+        json: options.json,
+        action: 'agent.remove',
+        agentId: result.agentId,
+    });
 });
 agent
     .command('include <agentId>')
@@ -324,7 +381,14 @@ agent
     .action((agentId, options) => {
     const loaded = loadConfig();
     const result = includeAgent(loaded.config, agentId);
-    persistAndPrintMutation({ configPath: loaded.configPath, baseDir: loaded.baseDir, nextConfig: result.config, json: options.json, action: 'agent.include', agentId: result.agentId });
+    persistAndPrintMutation({
+        configPath: loaded.configPath,
+        baseDir: loaded.baseDir,
+        nextConfig: result.config,
+        json: options.json,
+        action: 'agent.include',
+        agentId: result.agentId,
+    });
 });
 agent
     .command('exclude <agentId>')
@@ -332,7 +396,14 @@ agent
     .action((agentId, options) => {
     const loaded = loadConfig();
     const result = excludeAgent(loaded.config, agentId);
-    persistAndPrintMutation({ configPath: loaded.configPath, baseDir: loaded.baseDir, nextConfig: result.config, json: options.json, action: 'agent.exclude', agentId: result.agentId });
+    persistAndPrintMutation({
+        configPath: loaded.configPath,
+        baseDir: loaded.baseDir,
+        nextConfig: result.config,
+        json: options.json,
+        action: 'agent.exclude',
+        agentId: result.agentId,
+    });
 });
 agent
     .command('enable <agentId>')
@@ -340,7 +411,14 @@ agent
     .action((agentId, options) => {
     const loaded = loadConfig();
     const result = setAgentEnabled(loaded.config, agentId, true);
-    persistAndPrintMutation({ configPath: loaded.configPath, baseDir: loaded.baseDir, nextConfig: result.config, json: options.json, action: 'agent.enable', agentId: result.agentId });
+    persistAndPrintMutation({
+        configPath: loaded.configPath,
+        baseDir: loaded.baseDir,
+        nextConfig: result.config,
+        json: options.json,
+        action: 'agent.enable',
+        agentId: result.agentId,
+    });
 });
 agent
     .command('disable <agentId>')
@@ -348,7 +426,14 @@ agent
     .action((agentId, options) => {
     const loaded = loadConfig();
     const result = setAgentEnabled(loaded.config, agentId, false);
-    persistAndPrintMutation({ configPath: loaded.configPath, baseDir: loaded.baseDir, nextConfig: result.config, json: options.json, action: 'agent.disable', agentId: result.agentId });
+    persistAndPrintMutation({
+        configPath: loaded.configPath,
+        baseDir: loaded.baseDir,
+        nextConfig: result.config,
+        json: options.json,
+        action: 'agent.disable',
+        agentId: result.agentId,
+    });
 });
 agent
     .command('set-role <agentId>')
@@ -357,7 +442,14 @@ agent
     .action((agentId, options) => {
     const loaded = loadConfig();
     const result = setAgentRole(loaded.config, agentId, options.role);
-    persistAndPrintMutation({ configPath: loaded.configPath, baseDir: loaded.baseDir, nextConfig: result.config, json: options.json, action: 'agent.set-role', agentId: result.agentId });
+    persistAndPrintMutation({
+        configPath: loaded.configPath,
+        baseDir: loaded.baseDir,
+        nextConfig: result.config,
+        json: options.json,
+        action: 'agent.set-role',
+        agentId: result.agentId,
+    });
 });
 // ─── rule ───────────────────────────────────────────────────────────────────
 rule
@@ -393,7 +485,14 @@ rule
         throw new Error('rule path must start with rules.');
     const loaded = loadConfig();
     const nextConfig = setValueAtPath(loaded.config, dottedPath, parseConfigInput(options.value));
-    persistConfigMutation({ configPath: loaded.configPath, baseDir: loaded.baseDir, nextConfig, json: options.json, action: 'rule.set', path: dottedPath });
+    persistConfigMutation({
+        configPath: loaded.configPath,
+        baseDir: loaded.baseDir,
+        nextConfig,
+        json: options.json,
+        action: 'rule.set',
+        path: dottedPath,
+    });
 });
 rule
     .command('diff <path>')
@@ -415,7 +514,14 @@ rule
     requireYes(options.yes, 'reset rule config');
     const loaded = loadConfig();
     const nextConfig = resetValueAtPath(loaded.config, options.path);
-    persistConfigMutation({ configPath: loaded.configPath, baseDir: loaded.baseDir, nextConfig, json: options.json, action: 'rule.reset', path: options.path });
+    persistConfigMutation({
+        configPath: loaded.configPath,
+        baseDir: loaded.baseDir,
+        nextConfig,
+        json: options.json,
+        action: 'rule.reset',
+        path: options.path,
+    });
 });
 // ─── template ───────────────────────────────────────────────────────────────
 template
@@ -452,7 +558,14 @@ template
         ...(options.placeholders ? { placeholders: parseConfigInput(options.placeholders) } : {}),
     };
     const nextConfig = setValueAtPath(loaded.config, `templates.${name}`, nextTemplate);
-    persistConfigMutation({ configPath: loaded.configPath, baseDir: loaded.baseDir, nextConfig, json: options.json, action: 'template.set', path: `templates.${name}` });
+    persistConfigMutation({
+        configPath: loaded.configPath,
+        baseDir: loaded.baseDir,
+        nextConfig,
+        json: options.json,
+        action: 'template.set',
+        path: `templates.${name}`,
+    });
 });
 template
     .command('diff <name>')
@@ -469,7 +582,14 @@ template
     requireYes(options.yes, 'reset template config');
     const loaded = loadConfig();
     const nextConfig = resetValueAtPath(loaded.config, `templates.${name}`);
-    persistConfigMutation({ configPath: loaded.configPath, baseDir: loaded.baseDir, nextConfig, json: options.json, action: 'template.reset', path: `templates.${name}` });
+    persistConfigMutation({
+        configPath: loaded.configPath,
+        baseDir: loaded.baseDir,
+        nextConfig,
+        json: options.json,
+        action: 'template.reset',
+        path: `templates.${name}`,
+    });
 });
 template
     .command('render <name>')
@@ -480,7 +600,11 @@ template
     const item = getValueAtPath(loaded.config, `templates.${name}`);
     if (!item?.body)
         throw new Error(`template not found: ${name}`);
-    printValue({ ok: true, name, rendered: renderTemplate(name, item.body, JSON.parse(options.context)) }, true);
+    printValue({
+        ok: true,
+        name,
+        rendered: renderTemplate(name, item.body, JSON.parse(options.context)),
+    }, true);
 });
 // ─── reset ──────────────────────────────────────────────────────────────────
 reset
@@ -492,7 +616,14 @@ reset
     requireYes(options.yes, 'reset config');
     const loaded = loadConfig();
     const nextConfig = resetValueAtPath(loaded.config, options.path);
-    persistConfigMutation({ configPath: loaded.configPath, baseDir: loaded.baseDir, nextConfig, json: options.json, action: 'reset.config', path: options.path });
+    persistConfigMutation({
+        configPath: loaded.configPath,
+        baseDir: loaded.baseDir,
+        nextConfig,
+        json: options.json,
+        action: 'reset.config',
+        path: options.path,
+    });
 });
 reset
     .command('state')
@@ -502,7 +633,12 @@ reset
     requireYes(options.yes, 'reset runtime state');
     const loaded = loadRuntime();
     // Remove task data but preserve config and rules
-    for (const dir of [loaded.paths.tasksDir, loaded.paths.evidenceDir, loaded.paths.promptsDir, loaded.paths.runsDir]) {
+    for (const dir of [
+        loaded.paths.tasksDir,
+        loaded.paths.evidenceDir,
+        loaded.paths.promptsDir,
+        loaded.paths.runsDir,
+    ]) {
         fs.rmSync(dir, { recursive: true, force: true });
     }
     fs.rmSync(loaded.paths.eventsFile, { force: true });
@@ -519,6 +655,24 @@ state
     const loaded = loadRuntime();
     printValue(verifyState(loaded.paths), true);
 });
+state
+    .command('import')
+    .description('Import legacy orchestration runtime state from a backup directory')
+    .requiredOption('--from <legacyDir>')
+    .option('--yes')
+    .option('--json')
+    .action((options) => {
+    printValue(runImportOrchestrationCommand(options.from, options.yes), true);
+});
+migrate
+    .command('import-orchestration')
+    .description('Import legacy orchestration runtime state from a backup directory')
+    .requiredOption('--from <legacyDir>')
+    .option('--yes')
+    .option('--json')
+    .action((options) => {
+    printValue(runImportOrchestrationCommand(options.from, options.yes), true);
+});
 program
     .command('index-rebuild')
     .option('--json')
@@ -608,7 +762,13 @@ task
     .option('--work-package <workPackage>')
     .option('--json')
     .action((options) => {
-    const payload = recordTaskProgress(loadRuntime().paths, { taskId: options.taskId, actor: options.actor, message: options.message, unitId: options.unitId, workPackage: options.workPackage });
+    const payload = recordTaskProgress(loadRuntime().paths, {
+        taskId: options.taskId,
+        actor: options.actor,
+        message: options.message,
+        unitId: options.unitId,
+        workPackage: options.workPackage,
+    });
     if (!payload)
         throw new Error(`task not found: ${options.taskId}`);
     printValue(payload, true);
@@ -620,9 +780,16 @@ task
     .option('--reason <reason>', 'block reason', 'stale_timeout')
     .option('--json')
     .action((options) => {
-    const paths = loadRuntime().paths;
+    const loaded = loadRuntime();
     const hours = Number(options.hours);
-    const payload = options.apply ? applyStalePolicy(paths, hours, options.reason) : { ok: true, hours, count: findStaleTasks(paths, hours).length, tasks: findStaleTasks(paths, hours) };
+    const agentsStateDir = resolveAgentsStateDir(loaded.config);
+    const preview = findStaleTasks(loaded.paths, hours, {
+        agentsStateDir,
+        fallbackReason: options.reason,
+    });
+    const payload = options.apply
+        ? applyStalePolicy(loaded.paths, hours, options.reason, { agentsStateDir })
+        : { ok: true, hours, requestedReason: options.reason, count: preview.length, tasks: preview };
     printValue(payload, true);
 });
 for (const [name, status] of Object.entries(STATUS_MAP)) {
@@ -668,7 +835,16 @@ worker
     .option('--project-dir <path>', 'working directory for this worker')
     .option('--json')
     .action((options) => {
-    const payload = prepareWorker(loadRuntime().paths, { taskId: options.taskId, agentId: options.agentId, description: options.description, constraints: options.constraints, unitId: options.unitId, workPackage: options.workPackage, dod: options.dod, projectDir: options.projectDir });
+    const payload = prepareWorker(loadRuntime().paths, {
+        taskId: options.taskId,
+        agentId: options.agentId,
+        description: options.description,
+        constraints: options.constraints,
+        unitId: options.unitId,
+        workPackage: options.workPackage,
+        dod: options.dod,
+        projectDir: options.projectDir,
+    });
     if (!payload)
         throw new Error(`task not found: ${options.taskId}`);
     printValue(payload, true);
@@ -685,7 +861,16 @@ worker
     .option('--reason <reason>')
     .option('--json')
     .action((options) => {
-    const payload = registerWorker(loadRuntime().paths, { taskId: options.taskId, agentId: options.agentId, sessionKey: options.sessionKey, runId: options.runId, sessionId: options.sessionId, unitId: options.unitId, workPackage: options.workPackage, reason: options.reason });
+    const payload = registerWorker(loadRuntime().paths, {
+        taskId: options.taskId,
+        agentId: options.agentId,
+        sessionKey: options.sessionKey,
+        runId: options.runId,
+        sessionId: options.sessionId,
+        unitId: options.unitId,
+        workPackage: options.workPackage,
+        reason: options.reason,
+    });
     if (!payload)
         throw new Error(`task not found: ${options.taskId}`);
     printValue(payload, true);
@@ -702,7 +887,16 @@ worker
     .option('--work-package <workPackage>')
     .option('--json')
     .action((options) => {
-    const payload = completeWorker(loadRuntime().paths, { taskId: options.taskId, agentId: options.agentId, sessionKey: options.sessionKey, runId: options.runId, sessionId: options.sessionId, result: options.result, unitId: options.unitId, workPackage: options.workPackage });
+    const payload = completeWorker(loadRuntime().paths, {
+        taskId: options.taskId,
+        agentId: options.agentId,
+        sessionKey: options.sessionKey,
+        runId: options.runId,
+        sessionId: options.sessionId,
+        result: options.result,
+        unitId: options.unitId,
+        workPackage: options.workPackage,
+    });
     if (!payload)
         throw new Error(`task not found: ${options.taskId}`);
     printValue(payload, true);
@@ -720,10 +914,28 @@ evidence
     .option('--summary <summary>')
     .option('--tool-result <toolResult>', 'repeatable', (value, prev = []) => [...prev, value], [])
     .option('--notes <notes>')
+    .option('--dod-item <dodItem>', 'repeatable', (value, prev = []) => [...prev, value], [])
+    .option('--test-case <testCase>', 'repeatable', (value, prev = []) => [...prev, value], [])
+    .option('--verification-map <mapping>', 'repeatable dod=test mapping', (value, prev = []) => [...prev, value], [])
     .option('--limit <limit>', 'transcript line limit', '40')
     .option('--json')
     .action((options) => {
-    const payload = collectEvidence(loadRuntime().paths, { taskId: options.taskId, agentId: options.agentId, runId: options.runId, unitId: options.unitId, sessionKey: options.sessionKey, sessionId: options.sessionId, transcript: options.transcript, summary: options.summary, toolResults: options.toolResult, notes: options.notes, limit: Number(options.limit) });
+    const payload = collectEvidence(loadRuntime().paths, {
+        taskId: options.taskId,
+        agentId: options.agentId,
+        runId: options.runId,
+        unitId: options.unitId,
+        sessionKey: options.sessionKey,
+        sessionId: options.sessionId,
+        transcript: options.transcript,
+        summary: options.summary,
+        toolResults: options.toolResult,
+        notes: options.notes,
+        dodItems: options.dodItem,
+        testCases: options.testCase,
+        verificationMappings: (options.verificationMap ?? []).map((item) => parseVerificationMap(item)),
+        limit: Number(options.limit),
+    });
     if (!payload)
         throw new Error(`task not found: ${options.taskId}`);
     printValue(payload, true);
@@ -735,7 +947,11 @@ evidence
     .option('--require-qa')
     .option('--json')
     .action((options) => {
-    const payload = mergeEvidence(loadRuntime().paths, { taskId: options.taskId, requiredAgents: options.requiredAgent, requireQa: Boolean(options.requireQa) });
+    const payload = mergeEvidence(loadRuntime().paths, {
+        taskId: options.taskId,
+        requiredAgents: options.requiredAgent,
+        requireQa: Boolean(options.requireQa),
+    });
     if (!payload)
         throw new Error(`task not found: ${options.taskId}`);
     printValue(payload, true);
@@ -747,7 +963,10 @@ report
     .option('--record-events')
     .option('--json')
     .action((options) => {
-    const payload = renderReport(loadRuntime().paths, { taskId: options.taskId, recordEvents: Boolean(options.recordEvents) });
+    const payload = renderReport(loadRuntime().paths, {
+        taskId: options.taskId,
+        recordEvents: Boolean(options.recordEvents),
+    });
     if (!payload)
         throw new Error(`task not found: ${options.taskId}`);
     printValue(payload, true);
@@ -760,12 +979,23 @@ pipeline
     .option('--scale <scale>', 'simple|normal|risky|large', 'normal')
     .option('--required-agent <agent>', 'repeatable', (value, prev = []) => [...prev, value], [])
     .option('--evidence-summary <agentEqSummary>', 'repeatable', (value, prev = []) => [...prev, value], [])
+    .option('--verification-map <agentEqDodEqTest>', 'repeatable agentId=dod=test', (value, prev = []) => [...prev, value], [])
     .option('--require-qa')
     .option('--auto-report')
     .option('--record-feedback')
     .option('--json')
     .action((options) => {
-    const payload = runPipeline(loadRuntime().paths, { title: options.title, description: options.description, scale: options.scale, requiredAgents: options.requiredAgent, evidenceSummaries: options.evidenceSummary, requireQa: Boolean(options.requireQa), autoReport: Boolean(options.autoReport), recordFeedback: Boolean(options.recordFeedback) });
+    const payload = runPipeline(loadRuntime().paths, {
+        title: options.title,
+        description: options.description,
+        scale: options.scale,
+        requiredAgents: options.requiredAgent,
+        evidenceSummaries: options.evidenceSummary,
+        verificationMappings: options.verificationMap,
+        requireQa: Boolean(options.requireQa),
+        autoReport: Boolean(options.autoReport),
+        recordFeedback: Boolean(options.recordFeedback),
+    });
     printValue(payload, true);
 });
 // ─── run / inspect ──────────────────────────────────────────────────────────

package/dist/migrate/import-orchestration.d.ts

@@ -0,0 +1,31 @@
+import { type ZigrixPaths } from '../state/paths.js';
+type ImportReport = {
+    ok: boolean;
+    action: 'migrate.import-orchestration';
+    fromDir: string;
+    destinationBaseDir: string;
+    importedTaskIds: string[];
+    synthesizedMetaTasks: string[];
+    skippedTaskIds: string[];
+    counts: {
+        source: Record<string, number>;
+        imported: Record<string, number>;
+    };
+    parity: {
+        tasks: boolean;
+        evidenceDirs: boolean;
+        evidenceFiles: boolean;
+        mergedFiles: boolean;
+        prompts: boolean;
+        events: boolean;
+        statusBuckets: boolean;
+        activeTasks: boolean;
+    };
+    stateCheck: Record<string, unknown>;
+    warnings: string[];
+    reportPath: string;
+};
+export declare function importOrchestrationState(paths: ZigrixPaths, params: {
+    fromDir: string;
+}): ImportReport;
+export {};