coding-agent-harness 1.0.7 → 1.1.0

package/dist/commands/migration-command.mjs

@@ -1,4 +1,3 @@
-// @ts-nocheck
 import { applyStructureMigration, buildMigrationPlan, planStructureMigration, runMigration, verifyMigrationSession, } from "../lib/harness-core.mjs";
 import { applyTaskAuditIndexMigration, planTaskAuditIndexMigration, } from "../lib/task-audit-migration.mjs";
 export function runMigrationCommand(command, { args, takeFlag, takeOption, targetArg }) {
@@ -8,6 +7,7 @@ export function runMigrationCommand(command, { args, takeFlag, takeOption, targe
         const planOnly = takeFlag("--plan");
         const force = takeFlag("--force");
         try {
+            const shouldApply = apply && !planOnly;
             const result = apply && !planOnly
                 ? applyStructureMigration(targetArg(), { force })
                 : planStructureMigration(targetArg());
@@ -15,7 +15,7 @@ export function runMigrationCommand(command, { args, takeFlag, takeOption, targe
                 console.log(JSON.stringify(result, null, 2));
             }
             else {
-                console.log(`Structure migration ${result.applied ? "applied" : "plan"}: ${result.target}`);
+                console.log(`Structure migration ${shouldApply ? "applied" : "plan"}: ${result.target}`);
                 console.log(`manifest: ${result.manifest}`);
                 console.log(`actions: ${result.summary.actions}`);
                 for (const action of result.actions || [])
@@ -23,7 +23,7 @@ export function runMigrationCommand(command, { args, takeFlag, takeOption, targe
             }
         }
         catch (error) {
-            console.error(error.message);
+            console.error(errorMessage(error));
             process.exit(1);
         }
         return;
@@ -52,10 +52,11 @@ export function runMigrationCommand(command, { args, takeFlag, takeOption, targe
             process.exit(result.failures?.length ? 1 : 0);
         }
         catch (error) {
-            if (json && error.plan)
-                console.error(JSON.stringify(error.plan, null, 2));
+            const plan = readProperty(error, "plan");
+            if (json && plan)
+                console.error(JSON.stringify(plan, null, 2));
             else
-                console.error(error.message);
+                console.error(errorMessage(error));
             process.exit(1);
         }
     }
@@ -99,7 +100,7 @@ export function runMigrationCommand(command, { args, takeFlag, takeOption, targe
             }
         }
         catch (error) {
-            console.error(error.message);
+            console.error(errorMessage(error));
             process.exit(1);
         }
         return;
@@ -122,7 +123,7 @@ export function runMigrationCommand(command, { args, takeFlag, takeOption, targe
             }), null, 2));
         }
         catch (error) {
-            console.error(error.message);
+            console.error(errorMessage(error));
             process.exit(1);
         }
         return;
@@ -150,3 +151,12 @@ export function runMigrationCommand(command, { args, takeFlag, takeOption, targe
     }
     throw new Error(`Unsupported migration command: ${command}`);
 }
+function readProperty(value, key) {
+    return isRecord(value) ? value[key] : undefined;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}

package/dist/commands/module-command.mjs

@@ -0,0 +1,142 @@
+import { normalizeTarget, prepareModuleRegistration, prepareModuleScaffold, prepareModuleUnregister, readHarnessModules, } from "../lib/harness-core.mjs";
+import { takeRepeatedOptionsFromArgs } from "../lib/command-registry.mjs";
+import { beginGovernanceSync, commitGovernanceSync, governanceRelativePaths, releaseGovernanceSync } from "../lib/governance-sync.mjs";
+export function runModuleCommand({ args, takeFlag, takeOption, targetArg }) {
+    const subcommand = args.shift() || "list";
+    const json = takeFlag("--json");
+    if (subcommand === "list") {
+        const modules = readHarnessModules(targetArg());
+        const items = Object.entries(modules.items || {}).map(([key, module]) => ({ key, ...module }));
+        if (json)
+            console.log(JSON.stringify({ schema: modules.schema, generatedView: modules.generatedView, modules: items }, null, 2));
+        else
+            for (const item of items)
+                console.log(`${item.key}\t${item.status || "planned"}\t${item.title || item.key}`);
+        return;
+    }
+    if (subcommand === "inspect") {
+        const moduleKey = args.shift();
+        if (!moduleKey) {
+            console.error("Missing module key");
+            process.exit(2);
+        }
+        const modules = readHarnessModules(targetArg());
+        const module = modules.items[moduleKey];
+        if (!module) {
+            console.error(`Module is not registered: ${moduleKey}`);
+            process.exit(1);
+        }
+        console.log(JSON.stringify({ key: moduleKey, ...module }, null, 2));
+        return;
+    }
+    if (subcommand === "register") {
+        const dryRun = takeFlag("--dry-run");
+        const moduleKey = args.shift();
+        if (!moduleKey) {
+            console.error("Missing module key");
+            process.exit(2);
+        }
+        const input = {
+            title: takeOption("--title", ""),
+            prefix: takeOption("--prefix", ""),
+            status: takeOption("--status", "planned"),
+            branch: takeOption("--branch", ""),
+            owner: takeOption("--owner", "coordinator"),
+            currentStep: takeOption("--current-step", ""),
+            locale: takeOption("--locale", ""),
+            scope: takeRepeatedOptionsFromArgs(args, "--scope"),
+            shared: takeRepeatedOptionsFromArgs(args, "--shared"),
+            dependsOn: takeRepeatedOptionsFromArgs(args, "--depends-on"),
+        };
+        const target = normalizeTarget(targetArg());
+        const planned = prepareModuleRegistration(target, moduleKey, input, { dryRun: true });
+        const context = beginGovernanceSync(target, {
+            operation: `module register ${moduleKey}`,
+            dryRun,
+            allowDirtyWorktree: true,
+            allowedRelativePaths: governanceRelativePaths(planned.changes),
+        });
+        try {
+            const result = prepareModuleRegistration(target, moduleKey, input, { dryRun });
+            const commit = commitGovernanceSync(context, governanceRelativePaths(result.changes), { message: `chore(harness): register module ${result.moduleKey}` });
+            console.log(JSON.stringify({ ...result, governance: { commit } }, null, 2));
+        }
+        catch (error) {
+            console.error(errorMessage(error));
+            process.exit(1);
+        }
+        finally {
+            releaseGovernanceSync(context);
+        }
+        return;
+    }
+    if (subcommand === "unregister") {
+        const dryRun = takeFlag("--dry-run");
+        const moduleKey = args.shift();
+        if (!moduleKey) {
+            console.error("Missing module key");
+            process.exit(2);
+        }
+        const target = normalizeTarget(targetArg());
+        const planned = prepareModuleUnregister(target, moduleKey, { dryRun: true });
+        const context = beginGovernanceSync(target, {
+            operation: `module unregister ${moduleKey}`,
+            dryRun,
+            allowDirtyWorktree: true,
+            allowedRelativePaths: governanceRelativePaths(planned.changes),
+        });
+        try {
+            const result = prepareModuleUnregister(target, moduleKey, { dryRun });
+            const commit = commitGovernanceSync(context, governanceRelativePaths(result.changes), { message: `chore(harness): unregister module ${result.moduleKey}` });
+            console.log(JSON.stringify({ ...result, governance: { commit } }, null, 2));
+        }
+        catch (error) {
+            console.error(errorMessage(error));
+            process.exit(1);
+        }
+        finally {
+            releaseGovernanceSync(context);
+        }
+        return;
+    }
+    if (subcommand === "scaffold") {
+        const dryRun = takeFlag("--dry-run");
+        const all = takeFlag("--all");
+        const locale = takeOption("--locale", "");
+        const moduleKey = all ? "" : args.shift();
+        if (!all && !moduleKey) {
+            console.error("Missing module key");
+            process.exit(2);
+        }
+        const target = normalizeTarget(targetArg());
+        const modules = readHarnessModules(target);
+        const keys = all ? Object.keys(modules.items || {}).sort() : [moduleKey || ""];
+        const plannedChanges = keys.flatMap((key) => prepareModuleScaffold(target, key, { dryRun: true, locale }).changes);
+        const context = beginGovernanceSync(target, {
+            operation: all ? "module scaffold --all" : `module scaffold ${moduleKey}`,
+            dryRun,
+            allowDirtyWorktree: true,
+            allowedRelativePaths: governanceRelativePaths(plannedChanges),
+            allowDirtyWriteScope: true,
+        });
+        try {
+            const results = keys.map((key) => prepareModuleScaffold(target, key, { dryRun, locale }));
+            const changes = results.flatMap((result) => result.changes);
+            const commit = commitGovernanceSync(context, governanceRelativePaths(changes), { message: all ? "chore(harness): scaffold registered modules" : `chore(harness): scaffold module ${moduleKey}` });
+            console.log(JSON.stringify({ modules: results, changes, governance: { commit } }, null, 2));
+        }
+        catch (error) {
+            console.error(errorMessage(error));
+            process.exit(1);
+        }
+        finally {
+            releaseGovernanceSync(context);
+        }
+        return;
+    }
+    console.error(`Unknown module subcommand: ${subcommand}`);
+    process.exit(2);
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}

package/dist/commands/preset-command.mjs

@@ -1,5 +1,7 @@
-// @ts-nocheck
-import { checkPresetPackage, inspectPresetPackage, installPresetPackage, listPresetPackages, seedBundledPresets, uninstallPresetPackage, } from "../lib/harness-core.mjs";
+import fs from "node:fs";
+import path from "node:path";
+import { checkPresetPackage, inspectPresetPackage, installPresetPackage, auditBundledPresetDrift, listPresetPackages, seedBundledPresets, runPresetAction, runPresetEntrypoint, uninstallPresetPackage, } from "../lib/harness-core.mjs";
+import { takeOptionFromArgs } from "../lib/command-registry.mjs";
 export function runPresetCommand({ args, takeFlag, targetArg }) {
     const subcommand = args.shift() || "list";
     const json = takeFlag("--json");
@@ -49,10 +51,11 @@ export function runPresetCommand({ args, takeFlag, targetArg }) {
         }
         else if (subcommand === "install") {
             const force = takeFlag("--force");
+            const allowScripts = takeFlag("--allow-scripts");
             const source = args.shift();
             if (!source)
                 throw new Error("Missing preset source");
-            const result = installPresetPackage(source, { force, scope: project ? "project" : "user", targetInput: targetArg() });
+            const result = installPresetPackage(source, { force, allowScripts, scope: project ? "project" : "user", targetInput: targetArg() });
             if (json)
                 console.log(JSON.stringify(result, null, 2));
             else
@@ -70,6 +73,16 @@ export function runPresetCommand({ args, takeFlag, targetArg }) {
                     console.log(`${preset.action}: ${preset.id}@${preset.version}`);
             }
         }
+        else if (subcommand === "audit") {
+            const result = auditBundledPresetDrift({ scope: project ? "project" : "user", targetInput: targetArg() });
+            if (json)
+                console.log(JSON.stringify(result, null, 2));
+            else {
+                console.log(`Preset audit ${result.scope}: ${result.stale} stale or missing bundled presets`);
+                for (const preset of result.presets)
+                    console.log(`${preset.upgradeAction}: ${preset.id}@${preset.installedVersion || "missing"} [builtin ${preset.builtinVersion}]`);
+            }
+        }
         else if (subcommand === "uninstall") {
             const id = args.shift();
             if (!id)
@@ -80,12 +93,60 @@ export function runPresetCommand({ args, takeFlag, targetArg }) {
             else
                 console.log(`${result.removed ? "Removed" : "Preset not installed"}: ${result.id}`);
         }
+        else if (subcommand === "run") {
+            const allowScripts = takeFlag("--allow-scripts");
+            const taskRef = takeOptionFromArgs(args, "--task", "");
+            const useCurrentPreset = takeFlag("--use-current-preset");
+            const reason = takeOptionFromArgs(args, "--reason", "");
+            const id = args.shift();
+            const entrypoint = args.shift();
+            if (!id)
+                throw new Error("Missing preset id");
+            if (!entrypoint)
+                throw new Error("Missing preset entrypoint");
+            const result = runPresetEntrypoint(id, entrypoint, { taskRef, targetInput: targetArg(), json, allowScripts, useCurrentPreset, reason });
+            if (json)
+                console.log(JSON.stringify(result, null, 2));
+            else
+                console.log(`Preset run ${result.status}: ${result.preset}.${result.entrypoint} (${result.materialized.length} writes)`);
+        }
+        else if (subcommand === "action") {
+            const allowScripts = takeFlag("--allow-scripts");
+            const useCurrentPreset = takeFlag("--use-current-preset");
+            const reason = takeOptionFromArgs(args, "--reason", "");
+            const taskRef = takeOptionFromArgs(args, "--task", "");
+            const id = args.shift();
+            const action = args.shift();
+            if (!id)
+                throw new Error("Missing preset id");
+            if (!action)
+                throw new Error("Missing preset action");
+            const target = takeTrailingActionTarget(args);
+            const result = runPresetAction(id, action, { taskRef, targetInput: target, json, allowScripts, useCurrentPreset, reason, actionArgs: args });
+            if (json)
+                console.log(JSON.stringify(result, null, 2));
+            else
+                console.log(`Preset action ${result.status}: ${result.preset}.${result.action} (${result.materialized.length} writes) [${result.source} ${String(result.manifestSha256 || "").slice(0, 12)}]`);
+        }
         else {
             throw new Error(`Unknown preset subcommand: ${subcommand}`);
         }
     }
     catch (error) {
-        console.error(error.message);
+        console.error(errorMessage(error));
         process.exit(1);
     }
 }
+function takeTrailingActionTarget(args) {
+    const candidate = args[args.length - 1] || "";
+    if (!candidate || candidate.startsWith("-"))
+        return ".";
+    if (candidate === "." || candidate.startsWith("~") || candidate.includes("/") || candidate.includes("\\") || fs.existsSync(path.resolve(candidate))) {
+        args.pop();
+        return candidate;
+    }
+    return ".";
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}