zigrix 0.1.0-alpha.9 → 0.1.0

package/dist/index.js

@@ -4,12 +4,12 @@ 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 { defaultConfig } from './config/defaults.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 { runOnboard } from './onboard.js';
-import { dispatchTask } from './orchestration/dispatch.js';
+import { dispatchTask, resolveConfiguredProjectDir } from './orchestration/dispatch.js';
 import { collectEvidence, mergeEvidence } from './orchestration/evidence.js';
 import { finalizeTask } from './orchestration/finalize.js';
 import { runPipeline } from './orchestration/pipeline.js';
@@ -19,7 +19,7 @@ import { listRules, renderTemplate, validateRules } from './rules/templates.js';
 import { runWorkflow, summarizeRun } from './runner/run.js';
 import { loadRunRecord } from './runner/store.js';
 import { ensureBaseState, resolvePaths } from './state/paths.js';
-import { applyStalePolicy, createTask, findStaleTasks, listTaskEvents, listTasks, loadTask, rebuildIndex, recordTaskProgress, updateTaskStatus, } from './state/tasks.js';
+import { applyStalePolicy, createTask, findStaleTasks, listTaskEvents, listTasks, loadTask, rebuildIndex, recordTaskProgress, resolveTaskPaths, updateTaskStatus, } from './state/tasks.js';
 import { verifyState } from './state/verify.js';
 import { runDashboard, DASHBOARD_DEFAULT_PORT } from './dashboard.js';
 const STATUS_MAP = {
@@ -33,19 +33,16 @@ function printValue(value, json = false) {
     }
     console.log(value);
 }
-function requireConfigPath(configPath, baseDir) {
-    if (!configPath) {
-        throw new Error(`zigrix config not found under ${baseDir}; run 'zigrix onboard' first`);
-    }
+function requireConfigPath(configPath) {
     return configPath;
 }
 function persistAndPrintMutation(params) {
-    const targetPath = requireConfigPath(params.configPath, params.baseDir);
+    const targetPath = requireConfigPath(params.configPath);
     writeConfigFile(targetPath, params.nextConfig);
     printValue({ ok: true, action: params.action, agentId: params.agentId, configPath: targetPath }, params.json);
 }
 function persistConfigMutation(params) {
-    const targetPath = requireConfigPath(params.configPath, params.baseDir);
+    const targetPath = requireConfigPath(params.configPath);
     writeConfigFile(targetPath, params.nextConfig);
     printValue({ ok: true, action: params.action, path: params.path ?? null, configPath: targetPath }, params.json);
 }
@@ -54,10 +51,59 @@ function requireYes(yes, action = 'perform this action') {
         throw new Error(`refusing to ${action} without --yes`);
     }
 }
-function loadRuntime(options) {
-    const loaded = loadConfig({ baseDir: options.baseDir, configPath: options.config });
+function loadRuntime() {
+    const loaded = loadConfig();
     return { ...loaded, paths: resolvePaths(loaded.config) };
 }
+function listRuntimePathValues(loaded) {
+    return {
+        configPath: loaded.configPath,
+        'paths.baseDir': loaded.paths.baseDir,
+        'paths.tasksDir': loaded.paths.tasksDir,
+        'paths.evidenceDir': loaded.paths.evidenceDir,
+        'paths.promptsDir': loaded.paths.promptsDir,
+        'paths.eventsFile': loaded.paths.eventsFile,
+        'paths.indexFile': loaded.paths.indexFile,
+        'paths.runsDir': loaded.paths.runsDir,
+        'paths.rulesDir': loaded.paths.rulesDir,
+        'workspace.projectsBaseDir': loaded.config.workspace.projectsBaseDir,
+    };
+}
+function resolveRuntimePathValue(loaded, requestedKey) {
+    const normalized = requestedKey.trim();
+    const aliases = {
+        configPath: 'configPath',
+        baseDir: 'paths.baseDir',
+        tasksDir: 'paths.tasksDir',
+        evidenceDir: 'paths.evidenceDir',
+        promptsDir: 'paths.promptsDir',
+        eventsFile: 'paths.eventsFile',
+        indexFile: 'paths.indexFile',
+        runsDir: 'paths.runsDir',
+        rulesDir: 'paths.rulesDir',
+        projectsBaseDir: 'workspace.projectsBaseDir',
+        workspaceBaseDir: 'workspace.projectsBaseDir',
+        'paths.baseDir': 'paths.baseDir',
+        'paths.tasksDir': 'paths.tasksDir',
+        'paths.evidenceDir': 'paths.evidenceDir',
+        'paths.promptsDir': 'paths.promptsDir',
+        'paths.eventsFile': 'paths.eventsFile',
+        'paths.indexFile': 'paths.indexFile',
+        'paths.runsDir': 'paths.runsDir',
+        'paths.rulesDir': 'paths.rulesDir',
+        'workspace.projectsBaseDir': 'workspace.projectsBaseDir',
+    };
+    const canonicalKey = aliases[normalized];
+    if (!canonicalKey) {
+        throw new Error(`unknown path key: ${requestedKey}`);
+    }
+    const values = listRuntimePathValues(loaded);
+    return {
+        requestedKey,
+        canonicalKey,
+        value: values[canonicalKey] ?? null,
+    };
+}
 const { version: pkgVersion } = JSON.parse(fs.readFileSync(new URL('../package.json', import.meta.url), 'utf-8'));
 const program = new Command();
 program
@@ -65,6 +111,7 @@ program
     .description('Zigrix — multi-project parallel task orchestration CLI')
     .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 rule = program.command('rule').description('Inspect and validate rule assets');
 const template = program.command('template').description('Inspect and modify prompt templates');
@@ -78,16 +125,20 @@ const pipeline = program.command('pipeline').description('High-level orchestrati
 // ─── onboard ────────────────────────────────────────────────────────────────
 program
     .command('onboard')
-    .description('Set up Zigrix for first use (creates ~/.zigrix, seeds rules, registers agents)')
+    .description('Set up Zigrix for first use (creates config.paths.baseDir state, seeds rules, registers agents, and captures workspace defaults)')
     .option('--yes', 'non-interactive confirmation')
     .option('--json', 'JSON output')
-    .option('--project-dir <path>', 'path to project directory containing orchestration/rules/')
+    .option('--project-dir <path>', 'optional directory to import rule templates from (`rules/defaults` or `rules`); otherwise bundled defaults are used')
+    .option('--projects-base-dir <path>', 'workspace base directory to persist in zigrix.config.json')
     .option('--orchestrator-id <agentId>', 'set orchestration orchestrator agent id')
+    .option('--gateway-url <url>', 'OpenClaw gateway URL (auto-detected from openclaw.json when available)')
     .action(async (options) => {
     const result = await runOnboard({
         yes: Boolean(options.yes),
         projectDir: options.projectDir,
+        projectsBaseDir: options.projectsBaseDir,
         orchestratorId: options.orchestratorId,
+        gatewayUrl: options.gatewayUrl,
         silent: Boolean(options.json),
     });
     printValue(result, options.json ?? true);
@@ -98,7 +149,7 @@ program
     .description('Reconfigure agents, rules, PATH, skills, or workspace settings')
     .option('--section <section>', 'reconfigure specific section (agents|rules|workspace|path|skills), repeatable', (value, prev = []) => [...prev, value], [])
     .option('--projects-base-dir <path>', 'set projects base directory')
-    .option('--project-dir <path>', 'path to project directory containing orchestration/rules/')
+    .option('--project-dir <path>', 'optional directory to import rule templates from (`rules/defaults` or `rules`); otherwise bundled defaults are used')
     .option('--orchestrator-id <agentId>', 'set orchestration orchestrator agent id')
     .option('--yes', 'non-interactive confirmation')
     .option('--json', 'JSON output')
@@ -121,8 +172,8 @@ program
     .option('--json', 'JSON output')
     .action((options) => {
     console.error('⚠️  "zigrix init" is deprecated. Use "zigrix onboard" instead.');
-    const configPath = writeDefaultConfig(undefined, Boolean(options.yes));
-    const loaded = loadRuntime({ config: configPath });
+    const configPath = writeDefaultConfig(Boolean(options.yes));
+    const loaded = loadRuntime();
     ensureBaseState(loaded.paths);
     rebuildIndex(loaded.paths);
     printValue({ ok: true, path: configPath, deprecated: true, useInstead: 'zigrix onboard' }, options.json);
@@ -131,11 +182,9 @@ program
 program
     .command('doctor')
     .description('Inspect environment, config, and runtime readiness')
-    .option('--config <path>')
-    .option('--base-dir <path>')
     .option('--json')
     .action((options) => {
-    const loaded = loadRuntime({ baseDir: options.baseDir, config: options.config });
+    const loaded = loadRuntime();
     const payload = gatherDoctor(loaded, loaded.paths);
     if (options.json) {
         printValue(payload, true);
@@ -143,23 +192,48 @@ program
     }
     console.log(renderDoctorText(payload));
 });
+// ─── path ───────────────────────────────────────────────────────────────────
+pathCmd
+    .command('get <key>')
+    .description('Resolve one runtime path by key or alias (for example: tasksDir, paths.tasksDir, workspace.projectsBaseDir)')
+    .option('--json', 'JSON output')
+    .action((key, options) => {
+    const loaded = loadRuntime();
+    const resolved = resolveRuntimePathValue(loaded, key);
+    if (options.json) {
+        printValue({ ok: true, ...resolved }, true);
+        return;
+    }
+    printValue(resolved.value, false);
+});
+pathCmd
+    .command('list')
+    .description('List resolved runtime paths')
+    .option('--json', 'JSON output')
+    .action((options) => {
+    const loaded = loadRuntime();
+    const values = listRuntimePathValues(loaded);
+    if (options.json) {
+        printValue({ ok: true, values }, true);
+        return;
+    }
+    for (const [key, value] of Object.entries(values)) {
+        console.log(`${key}=${value ?? ''}`);
+    }
+});
 // ─── config ─────────────────────────────────────────────────────────────────
 config
     .command('validate')
-    .option('--config <path>', 'explicit config path')
-    .option('--base-dir <path>', 'Zigrix base directory override')
     .option('--json', 'JSON output')
     .action((options) => {
-    const loaded = loadConfig({ baseDir: options.baseDir, configPath: options.config });
+    const loaded = loadConfig();
     printValue({ ok: true, configPath: loaded.configPath, baseDir: loaded.baseDir }, options.json);
 });
 config
     .command('get [path]')
-    .option('--config <path>', 'explicit config path')
-    .option('--base-dir <path>', 'Zigrix base directory override')
     .option('--json', 'JSON output')
     .action((dottedPath, options) => {
-    const loaded = loadConfig({ baseDir: options.baseDir, configPath: options.config });
+    const loaded = loadConfig();
     printValue(getConfigValue(loaded.config, dottedPath) ?? null, true);
 });
 config
@@ -179,11 +253,9 @@ config
 config
     .command('set <path>')
     .requiredOption('--value <jsonOrString>')
-    .option('--config <path>', 'explicit config path')
-    .option('--base-dir <path>', 'Zigrix base directory override')
     .option('--json', 'JSON output')
     .action((dottedPath, options) => {
-    const loaded = loadConfig({ baseDir: options.baseDir, configPath: options.config });
+    const loaded = loadConfig();
     const nextConfig = setValueAtPath(loaded.config, dottedPath, parseConfigInput(options.value));
     persistConfigMutation({
         configPath: loaded.configPath,
@@ -196,23 +268,19 @@ config
 });
 config
     .command('diff <path>')
-    .option('--config <path>', 'explicit config path')
-    .option('--base-dir <path>', 'Zigrix base directory override')
     .option('--json', 'JSON output')
     .action((dottedPath, options) => {
-    const loaded = loadConfig({ baseDir: options.baseDir, configPath: options.config });
+    const loaded = loadConfig();
     printValue(diffValues(getValueAtPath(loaded.config, dottedPath), getValueAtPath(defaultConfig, dottedPath)), true);
 });
 config
     .command('reset')
     .option('--path <path>', 'dotted config path to restore from defaults', 'all')
-    .option('--config <path>', 'explicit config path')
-    .option('--base-dir <path>', 'Zigrix base directory override')
     .option('--yes', 'confirm destructive reset')
     .option('--json', 'JSON output')
     .action((options) => {
     requireYes(options.yes, 'reset config');
-    const loaded = loadConfig({ baseDir: options.baseDir, configPath: options.config });
+    const loaded = loadConfig();
     const nextConfig = resetValueAtPath(loaded.config, options.path);
     persistConfigMutation({
         configPath: loaded.configPath,
@@ -226,10 +294,8 @@ config
 // ─── agent ──────────────────────────────────────────────────────────────────
 agent
     .command('list')
-    .option('--config <path>')
-    .option('--base-dir <path>')
     .option('--json')
-    .action((options) => printValue(listAgents(loadConfig({ baseDir: options.baseDir, configPath: options.config }).config), true));
+    .action((options) => printValue(listAgents(loadConfig().config), true));
 agent
     .command('add')
     .requiredOption('--id <agentId>')
@@ -238,102 +304,80 @@ agent
     .option('--label <label>')
     .option('--include')
     .option('--disabled')
-    .option('--config <path>')
-    .option('--base-dir <path>')
     .option('--json')
     .action((options) => {
-    const loaded = loadConfig({ baseDir: options.baseDir, configPath: options.config });
+    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 });
 });
 agent
     .command('remove <agentId>')
-    .option('--config <path>')
-    .option('--base-dir <path>')
     .option('--json')
     .action((agentId, options) => {
-    const loaded = loadConfig({ baseDir: options.baseDir, configPath: options.config });
+    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 });
 });
 agent
     .command('include <agentId>')
-    .option('--config <path>')
-    .option('--base-dir <path>')
     .option('--json')
     .action((agentId, options) => {
-    const loaded = loadConfig({ baseDir: options.baseDir, configPath: options.config });
+    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 });
 });
 agent
     .command('exclude <agentId>')
-    .option('--config <path>')
-    .option('--base-dir <path>')
     .option('--json')
     .action((agentId, options) => {
-    const loaded = loadConfig({ baseDir: options.baseDir, configPath: options.config });
+    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 });
 });
 agent
     .command('enable <agentId>')
-    .option('--config <path>')
-    .option('--base-dir <path>')
     .option('--json')
     .action((agentId, options) => {
-    const loaded = loadConfig({ baseDir: options.baseDir, configPath: options.config });
+    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 });
 });
 agent
     .command('disable <agentId>')
-    .option('--config <path>')
-    .option('--base-dir <path>')
     .option('--json')
     .action((agentId, options) => {
-    const loaded = loadConfig({ baseDir: options.baseDir, configPath: options.config });
+    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 });
 });
 agent
     .command('set-role <agentId>')
     .requiredOption('--role <role>')
-    .option('--config <path>')
-    .option('--base-dir <path>')
     .option('--json')
     .action((agentId, options) => {
-    const loaded = loadConfig({ baseDir: options.baseDir, configPath: options.config });
+    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 });
 });
 // ─── rule ───────────────────────────────────────────────────────────────────
 rule
     .command('list')
-    .option('--config <path>')
-    .option('--base-dir <path>')
     .option('--json')
-    .action((options) => printValue(listRules(loadConfig({ baseDir: options.baseDir, configPath: options.config }).config), true));
+    .action((options) => printValue(listRules(loadConfig().config), true));
 rule
     .command('get <path>')
-    .option('--config <path>')
-    .option('--base-dir <path>')
     .option('--json')
-    .action((dottedPath, options) => printValue(getConfigValue(loadConfig({ baseDir: options.baseDir, configPath: options.config }).config, dottedPath) ?? null, true));
+    .action((dottedPath, options) => printValue(getConfigValue(loadConfig().config, dottedPath) ?? null, true));
 rule
     .command('validate')
-    .option('--config <path>')
-    .option('--base-dir <path>')
     .option('--json')
-    .action((options) => printValue(validateRules(loadConfig({ baseDir: options.baseDir, configPath: options.config }).config), true));
+    .action((options) => printValue(validateRules(loadConfig().config), true));
 rule
     .command('render <templateKind>')
     .requiredOption('--context <json>')
-    .option('--config <path>')
-    .option('--base-dir <path>')
     .option('--json')
     .action((templateKind, options) => {
-    const loaded = loadConfig({ baseDir: options.baseDir, configPath: options.config });
+    const loaded = loadConfig();
     const tpl = getConfigValue(loaded.config, `templates.${templateKind}`);
     if (!tpl?.body)
         throw new Error(`template not found: ${templateKind}`);
@@ -343,59 +387,49 @@ rule
 rule
     .command('set <path>')
     .requiredOption('--value <jsonOrString>')
-    .option('--config <path>')
-    .option('--base-dir <path>')
     .option('--json')
     .action((dottedPath, options) => {
     if (!dottedPath.startsWith('rules.'))
         throw new Error('rule path must start with rules.');
-    const loaded = loadConfig({ baseDir: options.baseDir, configPath: options.config });
+    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 });
 });
 rule
     .command('diff <path>')
-    .option('--config <path>')
-    .option('--base-dir <path>')
     .option('--json')
     .action((dottedPath, options) => {
     if (!dottedPath.startsWith('rules.'))
         throw new Error('rule path must start with rules.');
-    const loaded = loadConfig({ baseDir: options.baseDir, configPath: options.config });
+    const loaded = loadConfig();
     printValue(diffValues(getValueAtPath(loaded.config, dottedPath), getValueAtPath(defaultConfig, dottedPath)), true);
 });
 rule
     .command('reset')
     .requiredOption('--path <path>')
-    .option('--config <path>')
-    .option('--base-dir <path>')
     .option('--yes')
     .option('--json')
     .action((options) => {
     if (!options.path.startsWith('rules.'))
         throw new Error('rule path must start with rules.');
     requireYes(options.yes, 'reset rule config');
-    const loaded = loadConfig({ baseDir: options.baseDir, configPath: options.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 });
 });
 // ─── template ───────────────────────────────────────────────────────────────
 template
     .command('list')
-    .option('--config <path>')
-    .option('--base-dir <path>')
     .option('--json')
     .action((options) => {
-    const loaded = loadConfig({ baseDir: options.baseDir, configPath: options.config });
+    const loaded = loadConfig();
     printValue(Object.keys(loaded.config.templates).map((name) => ({ name, path: `templates.${name}` })), true);
 });
 template
     .command('get <name>')
-    .option('--config <path>')
-    .option('--base-dir <path>')
     .option('--json')
     .action((name, options) => {
-    const loaded = loadConfig({ baseDir: options.baseDir, configPath: options.config });
+    const loaded = loadConfig();
     printValue(getValueAtPath(loaded.config, `templates.${name}`) ?? null, true);
 });
 template
@@ -404,11 +438,9 @@ template
     .option('--format <format>', 'markdown|text')
     .option('--version <version>')
     .option('--placeholders <jsonArray>')
-    .option('--config <path>')
-    .option('--base-dir <path>')
     .option('--json')
     .action((name, options) => {
-    const loaded = loadConfig({ baseDir: options.baseDir, configPath: options.config });
+    const loaded = loadConfig();
     const current = getValueAtPath(loaded.config, `templates.${name}`);
     if (!current)
         throw new Error(`template not found: ${name}`);
@@ -424,33 +456,27 @@ template
 });
 template
     .command('diff <name>')
-    .option('--config <path>')
-    .option('--base-dir <path>')
     .option('--json')
     .action((name, options) => {
-    const loaded = loadConfig({ baseDir: options.baseDir, configPath: options.config });
+    const loaded = loadConfig();
     printValue(diffValues(getValueAtPath(loaded.config, `templates.${name}`), getValueAtPath(defaultConfig, `templates.${name}`)), true);
 });
 template
     .command('reset <name>')
-    .option('--config <path>')
-    .option('--base-dir <path>')
     .option('--yes')
     .option('--json')
     .action((name, options) => {
     requireYes(options.yes, 'reset template config');
-    const loaded = loadConfig({ baseDir: options.baseDir, configPath: options.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}` });
 });
 template
     .command('render <name>')
     .requiredOption('--context <json>')
-    .option('--config <path>')
-    .option('--base-dir <path>')
     .option('--json')
     .action((name, options) => {
-    const loaded = loadConfig({ baseDir: options.baseDir, configPath: options.config });
+    const loaded = loadConfig();
     const item = getValueAtPath(loaded.config, `templates.${name}`);
     if (!item?.body)
         throw new Error(`template not found: ${name}`);
@@ -460,25 +486,21 @@ template
 reset
     .command('config')
     .option('--path <path>', 'dotted config path to restore from defaults', 'all')
-    .option('--config <path>')
-    .option('--base-dir <path>')
     .option('--yes')
     .option('--json')
     .action((options) => {
     requireYes(options.yes, 'reset config');
-    const loaded = loadConfig({ baseDir: options.baseDir, configPath: options.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 });
 });
 reset
     .command('state')
-    .option('--base-dir <path>')
-    .option('--config <path>')
     .option('--yes')
     .option('--json')
     .action((options) => {
     requireYes(options.yes, 'reset runtime state');
-    const loaded = loadRuntime({ baseDir: options.baseDir, config: options.config });
+    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]) {
         fs.rmSync(dir, { recursive: true, force: true });
@@ -492,37 +514,31 @@ reset
 // ─── state ──────────────────────────────────────────────────────────────────
 state
     .command('check')
-    .option('--base-dir <path>')
-    .option('--config <path>')
     .option('--json')
     .action((options) => {
-    const loaded = loadRuntime({ baseDir: options.baseDir, config: options.config });
+    const loaded = loadRuntime();
     printValue(verifyState(loaded.paths), true);
 });
 program
     .command('index-rebuild')
-    .option('--config <path>')
-    .option('--base-dir <path>')
     .option('--json')
     .action((options) => {
-    const loaded = loadRuntime({ baseDir: options.baseDir, config: options.config });
+    const loaded = loadRuntime();
     printValue(rebuildIndex(loaded.paths), true);
 });
 // ─── task ───────────────────────────────────────────────────────────────────
 task
     .command('dispatch')
-    .description('Create a task with full orchestration metadata and boot prompt (replaces dev_dispatch.py)')
+    .description('Create a task with full orchestration metadata and boot prompt')
     .requiredOption('--title <title>')
     .requiredOption('--description <description>')
     .requiredOption('--scale <scale>', 'simple|normal|risky|large')
     .option('--project-dir <path>', 'target project directory')
     .option('--requested-by <name>', 'who requested this task')
     .option('--constraints <constraints>', 'task constraints')
-    .option('--config <path>')
-    .option('--base-dir <path>')
     .option('--json')
     .action((options) => {
-    const loaded = loadRuntime({ baseDir: options.baseDir, config: options.config });
+    const loaded = loadRuntime();
     const result = dispatchTask(loaded.paths, loaded.config, {
         title: options.title,
         description: options.description,
@@ -542,37 +558,47 @@ task
     .option('--project-dir <path>', 'target project directory for this task')
     .option('--requested-by <name>', 'who requested this task')
     .option('--prefix <prefix>', 'task ID prefix (DEV|TEST)', 'DEV')
-    .option('--config <path>')
-    .option('--base-dir <path>')
     .option('--json')
     .action((options) => {
-    const loaded = loadRuntime({ baseDir: options.baseDir, config: options.config });
-    const created = createTask(loaded.paths, { title: options.title, description: options.description, scale: options.scale, requiredAgents: options.requiredAgent, projectDir: options.projectDir, requestedBy: options.requestedBy, prefix: options.prefix });
-    printValue(created, true);
+    const loaded = loadRuntime();
+    const projectDir = options.projectDir
+        ? resolveAbsolutePath(options.projectDir)
+        : resolveConfiguredProjectDir(loaded.config);
+    const created = createTask(loaded.paths, {
+        title: options.title,
+        description: options.description,
+        scale: options.scale,
+        requiredAgents: options.requiredAgent,
+        projectDir,
+        requestedBy: options.requestedBy,
+        prefix: options.prefix,
+    });
+    printValue({
+        ...created,
+        ...resolveTaskPaths(loaded.paths, created.taskId),
+    }, true);
 });
 task
     .command('list')
-    .option('--config <path>')
-    .option('--base-dir <path>')
     .option('--json')
-    .action((options) => printValue(listTasks(loadRuntime({ baseDir: options.baseDir, config: options.config }).paths), true));
+    .action((options) => printValue(listTasks(loadRuntime().paths), true));
 task
     .command('status <taskId>')
-    .option('--config <path>')
-    .option('--base-dir <path>')
     .option('--json')
     .action((taskId, options) => {
-    const payload = loadTask(loadRuntime({ baseDir: options.baseDir, config: options.config }).paths, taskId);
+    const loaded = loadRuntime();
+    const payload = loadTask(loaded.paths, taskId);
     if (!payload)
         throw new Error(`task not found: ${taskId}`);
-    printValue(payload, true);
+    printValue({
+        ...payload,
+        ...resolveTaskPaths(loaded.paths, taskId),
+    }, true);
 });
 task
     .command('events [taskId]')
-    .option('--config <path>')
-    .option('--base-dir <path>')
     .option('--json')
-    .action((taskId, options) => printValue(listTaskEvents(loadRuntime({ baseDir: options.baseDir, config: options.config }).paths, taskId), true));
+    .action((taskId, options) => printValue(listTaskEvents(loadRuntime().paths, taskId), true));
 task
     .command('progress')
     .requiredOption('--task-id <taskId>')
@@ -580,11 +606,9 @@ task
     .requiredOption('--message <message>')
     .option('--unit-id <unitId>')
     .option('--work-package <workPackage>')
-    .option('--config <path>')
-    .option('--base-dir <path>')
     .option('--json')
     .action((options) => {
-    const payload = recordTaskProgress(loadRuntime({ baseDir: options.baseDir, config: options.config }).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);
@@ -594,11 +618,9 @@ task
     .option('--hours <hours>', 'stale threshold hours', '24')
     .option('--apply')
     .option('--reason <reason>', 'block reason', 'stale_timeout')
-    .option('--config <path>')
-    .option('--base-dir <path>')
     .option('--json')
     .action((options) => {
-    const paths = loadRuntime({ baseDir: options.baseDir, config: options.config }).paths;
+    const paths = loadRuntime().paths;
     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) };
     printValue(payload, true);
@@ -606,11 +628,9 @@ task
 for (const [name, status] of Object.entries(STATUS_MAP)) {
     task
         .command(`${name} <taskId>`)
-        .option('--config <path>')
-        .option('--base-dir <path>')
         .option('--json')
         .action((taskId, options) => {
-        const payload = updateTaskStatus(loadRuntime({ baseDir: options.baseDir, config: options.config }).paths, taskId, status);
+        const payload = updateTaskStatus(loadRuntime().paths, taskId, status);
         if (!payload)
             throw new Error(`task not found: ${taskId}`);
         printValue(payload, true);
@@ -618,18 +638,16 @@ for (const [name, status] of Object.entries(STATUS_MAP)) {
 }
 task
     .command('finalize <taskId>')
-    .description('Finalize a task: merge evidence, check units, optionally auto-report (replaces dev_finalize.py)')
-    .option('--auto-report', 'auto-transition to REPORTED if complete')
+    .description('Finalize a task: merge evidence, check units, and auto-report by default')
+    .option('--no-auto-report', 'skip auto-transition to REPORTED (default: auto-report enabled)')
     .option('--sec-issues', 'flag security issues (blocks auto-report)')
     .option('--qa-issues', 'flag QA issues (blocks auto-report)')
-    .option('--config <path>')
-    .option('--base-dir <path>')
     .option('--json')
     .action((taskId, options) => {
-    const loaded = loadRuntime({ baseDir: options.baseDir, config: options.config });
+    const loaded = loadRuntime();
     const result = finalizeTask(loaded.paths, {
         taskId,
-        autoReport: Boolean(options.autoReport),
+        autoReport: options.autoReport !== false,
         secIssues: Boolean(options.secIssues),
         qaIssues: Boolean(options.qaIssues),
     });
@@ -648,11 +666,9 @@ worker
     .option('--work-package <workPackage>')
     .option('--dod <dod>')
     .option('--project-dir <path>', 'working directory for this worker')
-    .option('--config <path>')
-    .option('--base-dir <path>')
     .option('--json')
     .action((options) => {
-    const payload = prepareWorker(loadRuntime({ baseDir: options.baseDir, config: options.config }).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);
@@ -667,11 +683,9 @@ worker
     .option('--unit-id <unitId>')
     .option('--work-package <workPackage>')
     .option('--reason <reason>')
-    .option('--config <path>')
-    .option('--base-dir <path>')
     .option('--json')
     .action((options) => {
-    const payload = registerWorker(loadRuntime({ baseDir: options.baseDir, config: options.config }).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);
@@ -686,11 +700,9 @@ worker
     .option('--result <result>', 'done|blocked|skipped', 'done')
     .option('--unit-id <unitId>')
     .option('--work-package <workPackage>')
-    .option('--config <path>')
-    .option('--base-dir <path>')
     .option('--json')
     .action((options) => {
-    const payload = completeWorker(loadRuntime({ baseDir: options.baseDir, config: options.config }).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);
@@ -709,11 +721,9 @@ evidence
     .option('--tool-result <toolResult>', 'repeatable', (value, prev = []) => [...prev, value], [])
     .option('--notes <notes>')
     .option('--limit <limit>', 'transcript line limit', '40')
-    .option('--config <path>')
-    .option('--base-dir <path>')
     .option('--json')
     .action((options) => {
-    const payload = collectEvidence(loadRuntime({ baseDir: options.baseDir, config: options.config }).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, limit: Number(options.limit) });
     if (!payload)
         throw new Error(`task not found: ${options.taskId}`);
     printValue(payload, true);
@@ -723,11 +733,9 @@ evidence
     .requiredOption('--task-id <taskId>')
     .option('--required-agent <agent>', 'repeatable', (value, prev = []) => [...prev, value], [])
     .option('--require-qa')
-    .option('--config <path>')
-    .option('--base-dir <path>')
     .option('--json')
     .action((options) => {
-    const payload = mergeEvidence(loadRuntime({ baseDir: options.baseDir, config: options.config }).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);
@@ -737,11 +745,9 @@ report
     .command('render')
     .requiredOption('--task-id <taskId>')
     .option('--record-events')
-    .option('--config <path>')
-    .option('--base-dir <path>')
     .option('--json')
     .action((options) => {
-    const payload = renderReport(loadRuntime({ baseDir: options.baseDir, config: options.config }).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);
@@ -757,22 +763,18 @@ pipeline
     .option('--require-qa')
     .option('--auto-report')
     .option('--record-feedback')
-    .option('--config <path>')
-    .option('--base-dir <path>')
     .option('--json')
     .action((options) => {
-    const payload = runPipeline(loadRuntime({ baseDir: options.baseDir, config: options.config }).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, requireQa: Boolean(options.requireQa), autoReport: Boolean(options.autoReport), recordFeedback: Boolean(options.recordFeedback) });
     printValue(payload, true);
 });
 // ─── run / inspect ──────────────────────────────────────────────────────────
 program
     .command('run <workflowPath>')
     .description('Run a minimal sequential workflow file')
-    .option('--config <path>')
-    .option('--base-dir <path>')
     .option('--json')
     .action(async (workflowPath, options) => {
-    const loaded = loadConfig({ baseDir: options.baseDir, configPath: options.config });
+    const loaded = loadConfig();
     const result = await runWorkflow({ config: loaded.config, workflowPath });
     if (options.json) {
         printValue({ ...result.record, savedPath: result.savedPath }, true);
@@ -784,11 +786,9 @@ program
 program
     .command('inspect <runIdOrPath>')
     .description('Inspect a saved run record')
-    .option('--config <path>')
-    .option('--base-dir <path>')
     .option('--json')
     .action((runIdOrPath, options) => {
-    const loaded = loadConfig({ baseDir: options.baseDir, configPath: options.config });
+    const loaded = loadConfig();
     printValue(loadRunRecord(loaded.config, runIdOrPath), true);
 });
 // ─── dashboard ──────────────────────────────────────────────────────────────