@holdyourvoice/hyv 3.3.5 → 3.4.1

package/dist/cli.js

@@ -19,7 +19,8 @@ import { buildProfile } from './voice-dna.js';
 import { loadApprovalContext } from './approval-context.js';
 import { formatFactLintReport, lintFacts } from './fact-linter.js';
 import { lintLogic } from './logic-linter.js';
-const usage = 'Commands: profile, analyze, hygiene, inspect-hidden-text, apply-hidden-text-policy, final-check, fact-lint, logic-lint, batch-analyze, rewrite-prompt, prepare-rewrite, apply-rewrite, prepare-judgment, reduce-judgment, prepare-rebuild, rebuild-writer-request, apply-rebuild, verify, verify-spec, lifecycle, learning, patterns, mcp';
+import { loadAll, validateAll, validateId, sortedIds, describe, emitJson, emitPrompt } from './agents/index.js';
+const usage = 'Commands: agent, profile, analyze, hygiene, inspect-hidden-text, apply-hidden-text-policy, final-check, fact-lint, logic-lint, batch-analyze, rewrite-prompt, prepare-rewrite, apply-rewrite, prepare-judgment, reduce-judgment, prepare-rebuild, rebuild-writer-request, apply-rebuild, verify, verify-spec, lifecycle, learning, patterns, mcp';
 function input(path) {
     return path === '-' ? readFileSync(0, 'utf8') : readFileSync(path, 'utf8');
 }
@@ -198,6 +199,9 @@ function json(value) {
     console.log(JSON.stringify(value, null, 2));
 }
 function canonical(value) { process.stdout.write(`${canonicalJson(value)}\n`); }
+function writeJson(path, value) {
+    writeFileSync(path, `${JSON.stringify(value, null, 2)}\n`);
+}
 function profileArguments(args) {
     const [output, ...rest] = args;
     const samples = [];
@@ -269,348 +273,491 @@ function writeNewFileAtomically(path, text) {
     if (primaryError)
         throw primaryError;
 }
-export async function runCli(args) {
-    const [command, ...rest] = args;
-    if (command === 'profile') {
-        const { output, samples, avoid } = profileArguments(rest);
-        writeFileSync(output, `${JSON.stringify(buildProfile(samples.map(input), avoid), null, 2)}\n`);
-        return 0;
-    }
-    if (command === 'analyze') {
-        const [draft, profilePath, briefPath] = rest;
-        if (!draft || !profilePath)
-            throw new Error('Usage: hyv analyze draft.md profile.json [writing-brief.json]');
-        json(analyze(input(draft), readProfile(profilePath), readBrief(briefPath)));
-        return 0;
-    }
-    if (command === 'hygiene') {
-        const { path, fix, output } = hygieneArguments(rest);
-        if (fix && path === '-')
-            throw new Error('hyv hygiene --fix requires a file path so the original can be preserved.');
-        const text = input(path);
-        if (!fix) {
-            json(inspectHygiene(text));
-            return 0;
+function agentFlags(args) {
+    const values = [];
+    let host = 'generic';
+    let mode;
+    let output;
+    for (let index = 0; index < args.length; index += 1) {
+        const argument = args[index];
+        if (argument === '--host') {
+            const value = args[index + 1];
+            if (!value || value.startsWith('--'))
+                throw new Error('Usage: hyv agent --host HOST requires a value.');
+            host = value;
+            index += 1;
+        }
+        else if (argument.startsWith('--host=')) {
+            const value = argument.slice('--host='.length);
+            if (!value)
+                throw new Error('Usage: hyv agent --host HOST requires a value.');
+            host = value;
+        }
+        else if (argument === '--mode') {
+            const value = args[index + 1];
+            if (value !== 'prompt' && value !== 'json')
+                throw new Error('Usage: hyv agent --mode prompt|json requires a mode.');
+            mode = value;
+            index += 1;
+        }
+        else if (argument.startsWith('--mode=')) {
+            const value = argument.slice('--mode='.length);
+            if (value !== 'prompt' && value !== 'json')
+                throw new Error('Usage: hyv agent --mode prompt|json requires a mode.');
+            mode = value;
+        }
+        else if (argument === '--output') {
+            const value = args[index + 1];
+            if (!value || value.startsWith('--'))
+                throw new Error('Usage: hyv agent --output FILE requires a value.');
+            output = value;
+            index += 1;
+        }
+        else if (argument.startsWith('--output=')) {
+            const value = argument.slice('--output='.length);
+            if (!value)
+                throw new Error('Usage: hyv agent --output FILE requires a value.');
+            output = value;
+        }
+        else {
+            values.push(argument);
         }
-        const outputPath = output ?? cleanedPath(path);
-        if (resolve(outputPath) === resolve(path))
-            throw new Error('Hygiene output must differ from the input path.');
-        const result = cleanHygiene(text);
-        writeNewFileAtomically(outputPath, result.cleaned);
-        json({ ...result.report, changed: result.changed, changes: result.changes, outputPath });
-        return 0;
     }
-    if (command === 'inspect-hidden-text') {
-        const [path, policyPath, ...extra] = rest;
-        if (!path || extra.length)
-            throw new Error('Usage: hyv inspect-hidden-text draft.md [policy.json]');
-        json(inspectHiddenText(input(path), policyPath ? parseHiddenTextPolicy(readJson(policyPath)) : undefined));
+    return { values, host, mode, output };
+}
+function runAgent(args) {
+    const [subcommand, ...subargs] = args;
+    if (subcommand === 'list') {
+        if (subargs.length)
+            throw new Error('Usage: hyv agent list');
+        const packages = loadAll();
+        const ids = sortedIds(packages);
+        json(ids.map((id) => {
+            const descriptor = packages.get(id).descriptor;
+            return { id, role: descriptor.role, workflow_phase: descriptor.workflow_phase, description: descriptor.description };
+        }));
         return 0;
     }
-    if (command === 'apply-hidden-text-policy') {
-        const [path, policyPath, output, ...extra] = rest;
-        if (!path || !policyPath || !output || extra.length)
-            throw new Error('Usage: hyv apply-hidden-text-policy draft.md policy.json output.md');
-        if (path === '-' || resolve(path) === resolve(output))
-            throw new Error('Hidden-text output must differ from the input path.');
-        const result = applyHiddenTextPolicy(input(path), parseHiddenTextPolicy(readJson(policyPath)));
-        writeNewFileAtomically(output, result.output);
-        json({ ...result, outputPath: output });
+    if (subcommand === 'validate') {
+        if (subargs.length > 1)
+            throw new Error('Usage: hyv agent validate [id]');
+        const packages = loadAll();
+        const id = subargs[0];
+        if (id !== undefined)
+            validateId(packages, id);
+        validateAll(packages);
+        json({ schema_version: '1.0.0', status: 'PASS', agent: id ?? 'all' });
         return 0;
     }
-    if (command === 'final-check') {
-        const [path, ...options] = rest;
-        if (!path || options.length)
-            throw new Error('Usage: hyv final-check <path|->');
-        const result = finalOutputCheck(input(path));
-        if (!result.accepted) {
-            console.error(JSON.stringify(result, null, 2));
-            return 2;
-        }
-        if (result.changed)
-            console.error(JSON.stringify({ changed: true, changes: result.changes }, null, 2));
-        process.stdout.write(result.output);
+    if (subcommand === 'describe') {
+        const { values, host, mode, output } = agentFlags(subargs);
+        if (values.length !== 1 || mode !== undefined || output !== undefined)
+            throw new Error('Usage: hyv agent describe <id> [--host HOST]');
+        const packages = loadAll();
+        validateId(packages, values[0]);
+        json(describe(packages.get(values[0]), host));
         return 0;
     }
-    if (command === 'fact-lint') {
-        const [draftPath, ...options] = rest;
-        const sources = [];
-        let metadata;
-        let strict = false;
-        let human = false;
-        if (!draftPath)
-            throw new Error('Usage: hyv fact-lint <draft|-> --source=id:path [--source=id:path] [--metadata=metadata.json] [--strict] [--human]');
-        for (const option of options) {
-            if (option === '--strict') {
-                strict = true;
-                continue;
-            }
-            if (option === '--human') {
-                human = true;
-                continue;
-            }
-            if (option.startsWith('--source=')) {
-                const value = option.slice('--source='.length);
-                const separator = value.indexOf(':');
-                const id = value.slice(0, separator).trim();
-                const path = value.slice(separator + 1);
-                if (separator < 1 || !id || !path)
-                    throw new Error('Sources must use --source=id:path.');
-                sources.push({ id, text: input(path) });
-                continue;
-            }
-            if (option.startsWith('--metadata=')) {
-                metadata = JSON.parse(input(option.slice('--metadata='.length)));
-                continue;
-            }
-            throw new Error('Usage: hyv fact-lint <draft|-> --source=id:path [--source=id:path] [--metadata=metadata.json] [--strict] [--human]');
+    if (subcommand === 'emit') {
+        const { values, host, mode, output } = agentFlags(subargs);
+        if (values.length !== 1)
+            throw new Error('Usage: hyv agent emit <id> --mode prompt|json [--host HOST] [--output FILE]');
+        if (!mode)
+            throw new Error('Usage: hyv agent emit <id> --mode prompt|json [--host HOST] [--output FILE]');
+        const packages = loadAll();
+        validateId(packages, values[0]);
+        const pkg = packages.get(values[0]);
+        const body = mode === 'prompt' ? emitPrompt(pkg, host) : `${emitJson(pkg, host)}\n`;
+        if (output !== undefined) {
+            writeFileSync(output, body, { encoding: 'utf8', flag: 'wx' });
+        }
+        else {
+            process.stdout.write(body);
         }
-        const report = lintFacts({ sources, draft: input(draftPath), metadata });
-        if (human)
-            console.log(formatFactLintReport(report));
-        else
-            json(report);
-        return strict && report.findings.some((item) => item.severity === 'error') ? 2 : 0;
-    }
-    if (command === 'logic-lint') {
-        const [draftPath, briefPath, ...extra] = rest;
-        if (!draftPath || extra.length)
-            throw new Error('Usage: hyv logic-lint <draft|-> [writing-brief.json]');
-        const report = lintLogic(input(draftPath), readBrief(briefPath));
-        json(report);
-        return report.passed ? 0 : 2;
-    }
-    if (command === 'batch-analyze') {
-        if (rest.length < 2)
-            throw new Error('Usage: hyv batch-analyze draft-a.md draft-b.md [draft-c.md]');
-        json(analyzeBatch(rest.map(input)));
         return 0;
     }
-    if (command === 'rewrite-prompt') {
-        const [draft, profilePath, briefPath] = rest;
-        if (!draft || !profilePath)
-            throw new Error('Usage: hyv rewrite-prompt draft.md profile.json [writing-brief.json]');
-        const profile = readProfile(profilePath);
-        console.log(rewritePrompt(input(draft), profile, composeLearning(profile), readBrief(briefPath)));
+    throw new Error('Usage: hyv agent <list|validate|describe|emit> ...');
+}
+function runProfile(args) {
+    const { output, samples, avoid } = profileArguments(args);
+    writeJson(output, buildProfile(samples.map(input), avoid));
+    return 0;
+}
+function runAnalyze(args) {
+    const [draft, profilePath, briefPath] = args;
+    if (!draft || !profilePath)
+        throw new Error('Usage: hyv analyze draft.md profile.json [writing-brief.json]');
+    json(analyze(input(draft), readProfile(profilePath), readBrief(briefPath)));
+    return 0;
+}
+function runHygiene(args) {
+    const { path, fix, output } = hygieneArguments(args);
+    if (fix && path === '-')
+        throw new Error('hyv hygiene --fix requires a file path so the original can be preserved.');
+    const text = input(path);
+    if (!fix) {
+        json(inspectHygiene(text));
         return 0;
     }
-    if (command === 'prepare-rewrite') {
-        const [draft, profilePath, output, ...contextPaths] = rest;
-        if (!draft || !profilePath || !output)
-            throw new Error('Usage: hyv prepare-rewrite draft.md profile.json task.json [copy-spec.json] [writing-brief.json]');
-        const context = prepareContext(contextPaths);
-        const task = prepareRewriteTask(input(draft), readProfile(profilePath), context.copySpec, context.writingBrief);
-        writeFileSync(output, `${JSON.stringify(task, null, 2)}\n`);
-        json({ version: task.version, fingerprint: task.fingerprint, eligibleSentenceIds: task.eligibleSentenceIds });
-        return 0;
+    const outputPath = output ?? cleanedPath(path);
+    if (resolve(outputPath) === resolve(path))
+        throw new Error('Hygiene output must differ from the input path.');
+    const result = cleanHygiene(text);
+    writeNewFileAtomically(outputPath, result.cleaned);
+    json({ ...result.report, changed: result.changed, changes: result.changes, outputPath });
+    return 0;
+}
+function runInspectHiddenText(args) {
+    const [path, policyPath, ...extra] = args;
+    if (!path || extra.length)
+        throw new Error('Usage: hyv inspect-hidden-text draft.md [policy.json]');
+    json(inspectHiddenText(input(path), policyPath ? parseHiddenTextPolicy(readJson(policyPath)) : undefined));
+    return 0;
+}
+function runApplyHiddenTextPolicy(args) {
+    const [path, policyPath, output, ...extra] = args;
+    if (!path || !policyPath || !output || extra.length)
+        throw new Error('Usage: hyv apply-hidden-text-policy draft.md policy.json output.md');
+    if (path === '-' || resolve(path) === resolve(output))
+        throw new Error('Hidden-text output must differ from the input path.');
+    const result = applyHiddenTextPolicy(input(path), parseHiddenTextPolicy(readJson(policyPath)));
+    writeNewFileAtomically(output, result.output);
+    json({ ...result, outputPath: output });
+    return 0;
+}
+function runFinalCheck(args) {
+    const [path, ...options] = args;
+    if (!path || options.length)
+        throw new Error('Usage: hyv final-check <path|->');
+    const result = finalOutputCheck(input(path));
+    if (!result.accepted) {
+        console.error(JSON.stringify(result, null, 2));
+        return 2;
+    }
+    if (result.changed)
+        console.error(JSON.stringify({ changed: true, changes: result.changes }, null, 2));
+    process.stdout.write(result.output);
+    return 0;
+}
+function runFactLint(args) {
+    const [draftPath, ...options] = args;
+    const sources = [];
+    let metadata;
+    let strict = false;
+    let human = false;
+    if (!draftPath)
+        throw new Error('Usage: hyv fact-lint <draft|-> --source=id:path [--source=id:path] [--metadata=metadata.json] [--strict] [--human]');
+    for (const option of options) {
+        if (option === '--strict') {
+            strict = true;
+            continue;
+        }
+        if (option === '--human') {
+            human = true;
+            continue;
+        }
+        if (option.startsWith('--source=')) {
+            const value = option.slice('--source='.length);
+            const separator = value.indexOf(':');
+            const id = value.slice(0, separator).trim();
+            const path = value.slice(separator + 1);
+            if (separator < 1 || !id || !path)
+                throw new Error('Sources must use --source=id:path.');
+            sources.push({ id, text: input(path) });
+            continue;
+        }
+        if (option.startsWith('--metadata=')) {
+            metadata = JSON.parse(input(option.slice('--metadata='.length)));
+            continue;
+        }
+        throw new Error('Usage: hyv fact-lint <draft|-> --source=id:path [--source=id:path] [--metadata=metadata.json] [--strict] [--human]');
     }
-    if (command === 'apply-rewrite') {
-        const [taskPath, responsePath, profilePath] = rest;
-        if (!taskPath || !responsePath || !profilePath)
-            throw new Error('Usage: hyv apply-rewrite task.json response.json profile.json');
-        const result = evaluateRewriteResponse(parseRewriteTask(JSON.parse(input(taskPath))), input(responsePath), readProfile(profilePath));
-        json(result);
-        return result.status === 'accepted' ? 0 : 2;
-    }
-    if (command === 'prepare-judgment') {
-        const [stage, kind, draft, profilePath, output, candidatePath] = rest;
-        if (!stage || !kind || !draft || !profilePath || !output)
-            throw new Error('Usage: hyv prepare-judgment pre-edit|post-candidate kind draft.md profile.json task.json [candidate.md]');
-        if (stage === 'post-candidate' && !candidatePath)
-            throw new Error('Usage: hyv prepare-judgment post-candidate kind draft.md profile.json task.json candidate.md');
-        const profile = readProfile(profilePath);
-        const task = stage === 'pre-edit'
-            ? preparePreEditJudgment(input(draft), profile, kind)
-            : preparePostCandidateJudgment(input(draft), input(candidatePath ?? ''), profile, kind);
-        writeFileSync(output, `${JSON.stringify(task, null, 2)}\n`);
-        json({ version: task.version, stage: task.stage, judgmentType: task.judgmentType, taskFingerprint: task.taskFingerprint });
+    const report = lintFacts({ sources, draft: input(draftPath), metadata });
+    if (human)
+        console.log(formatFactLintReport(report));
+    else
+        json(report);
+    return strict && report.findings.some((item) => item.severity === 'error') ? 2 : 0;
+}
+function runLogicLint(args) {
+    const [draftPath, briefPath, ...extra] = args;
+    if (!draftPath || extra.length)
+        throw new Error('Usage: hyv logic-lint <draft|-> [writing-brief.json]');
+    const report = lintLogic(input(draftPath), readBrief(briefPath));
+    json(report);
+    return report.passed ? 0 : 2;
+}
+function runBatchAnalyze(args) {
+    if (args.length < 2)
+        throw new Error('Usage: hyv batch-analyze draft-a.md draft-b.md [draft-c.md]');
+    json(analyzeBatch(args.map(input)));
+    return 0;
+}
+function runRewritePrompt(args) {
+    const [draft, profilePath, briefPath] = args;
+    if (!draft || !profilePath)
+        throw new Error('Usage: hyv rewrite-prompt draft.md profile.json [writing-brief.json]');
+    const profile = readProfile(profilePath);
+    console.log(rewritePrompt(input(draft), profile, composeLearning(profile), readBrief(briefPath)));
+    return 0;
+}
+function runPrepareRewrite(args) {
+    const [draft, profilePath, output, ...contextPaths] = args;
+    if (!draft || !profilePath || !output)
+        throw new Error('Usage: hyv prepare-rewrite draft.md profile.json task.json [copy-spec.json] [writing-brief.json]');
+    const context = prepareContext(contextPaths);
+    const task = prepareRewriteTask(input(draft), readProfile(profilePath), context.copySpec, context.writingBrief);
+    writeJson(output, task);
+    json({ version: task.version, fingerprint: task.fingerprint, eligibleSentenceIds: task.eligibleSentenceIds });
+    return 0;
+}
+function runApplyRewrite(args) {
+    const [taskPath, responsePath, profilePath] = args;
+    if (!taskPath || !responsePath || !profilePath)
+        throw new Error('Usage: hyv apply-rewrite task.json response.json profile.json');
+    const result = evaluateRewriteResponse(parseRewriteTask(JSON.parse(input(taskPath))), input(responsePath), readProfile(profilePath));
+    json(result);
+    return result.status === 'accepted' ? 0 : 2;
+}
+function runPrepareJudgment(args) {
+    const [stage, kind, draft, profilePath, output, candidatePath] = args;
+    if (!stage || !kind || !draft || !profilePath || !output)
+        throw new Error('Usage: hyv prepare-judgment pre-edit|post-candidate kind draft.md profile.json task.json [candidate.md]');
+    if (stage === 'post-candidate' && !candidatePath)
+        throw new Error('Usage: hyv prepare-judgment post-candidate kind draft.md profile.json task.json candidate.md');
+    const profile = readProfile(profilePath);
+    const task = stage === 'pre-edit'
+        ? preparePreEditJudgment(input(draft), profile, kind)
+        : preparePostCandidateJudgment(input(draft), input(candidatePath ?? ''), profile, kind);
+    writeJson(output, task);
+    json({ version: task.version, stage: task.stage, judgmentType: task.judgmentType, taskFingerprint: task.taskFingerprint });
+    return 0;
+}
+function runReduceJudgment(args) {
+    if (args.length < 3)
+        throw new Error('Usage: hyv reduce-judgment envelope.json envelope.json [envelope.json...]');
+    const envelopes = args.map((path) => parseJudgmentEnvelope(JSON.parse(input(path))));
+    json(envelopes[0]?.stage === 'pre-edit' ? reducePreEdit(envelopes) : reducePostCandidate(envelopes));
+    return 0;
+}
+function runPrepareRebuild(args) {
+    const { values, capability, recompositionPolicy } = rebuildArguments(args);
+    const [draft, profilePath, reductionPath, specPath, output, briefPath] = values;
+    if (!draft || !profilePath || !reductionPath || !specPath || !output || !capability) {
+        throw new Error('Usage: hyv prepare-rebuild draft.md profile.json reduction.json copy-spec.json task.json [writing-brief.json] [--recomposition-policy policy.json] (--capability-stdin|--capability-file path)');
+    }
+    const context = loadApprovalContext();
+    const task = prepareRebuildTask(input(draft), readProfile(profilePath), readJson(reductionPath), parseCopySpec(JSON.parse(input(specPath))), capability, context.trustStore, context.now, briefPath ? parseWritingBrief(JSON.parse(input(briefPath))) : undefined, recompositionPolicy);
+    writeJson(output, task);
+    json({ version: task.version, fingerprint: task.fingerprint, recommendationFingerprint: task.recommendationFingerprint, authorizationFingerprint: task.authorizationFingerprint, ...(task.recompositionPolicy ? { recompositionPolicy: task.recompositionPolicy } : {}) });
+    return 0;
+}
+function runApplyRebuild(args) {
+    const { values, capability } = capabilityArguments(args);
+    const [taskPath, responsePath, profilePath, ...extra] = values;
+    if (!taskPath || !responsePath || !profilePath || extra.length || !capability)
+        throw new Error('Usage: hyv apply-rebuild task.json response.json profile.json (--capability-stdin|--capability-file path)');
+    const context = loadApprovalContext();
+    const result = evaluateRebuildResponse(parseRebuildTask(JSON.parse(input(taskPath))), input(responsePath), readProfile(profilePath), capability, context.trustStore, context.now);
+    json(result);
+    return result.status === 'accepted' ? 0 : 2;
+}
+function runRebuildWriterRequest(args) {
+    const [taskPath, output, ...extra] = args;
+    if (!taskPath || !output || extra.length)
+        throw new Error('Usage: hyv rebuild-writer-request task.json writer-request.json');
+    const request = writerRequestForRebuild(parseRebuildTask(JSON.parse(input(taskPath))));
+    writeJson(output, request);
+    json({ version: request.version, taskFingerprint: request.taskFingerprint, copySpecFingerprint: request.copySpecFingerprint, ...(request.recompositionPolicyFingerprint ? { recompositionPolicyFingerprint: request.recompositionPolicyFingerprint } : {}) });
+    return 0;
+}
+function runVerify(args) {
+    const [original, candidate, profilePath, briefPath] = args;
+    if (!original || !candidate || !profilePath)
+        throw new Error('Usage: hyv verify original.md candidate.md profile.json [writing-brief.json]');
+    const profile = readProfile(profilePath);
+    const originalText = input(original);
+    const candidateText = input(candidate);
+    const result = verify(originalText, candidateText, profile, readBrief(briefPath));
+    json(result);
+    return result.passed ? 0 : 2;
+}
+function runVerifySpec(args) {
+    const [original, candidate, profilePath, specPath, briefPath] = args;
+    if (!original || !candidate || !profilePath || !specPath)
+        throw new Error('Usage: hyv verify-spec original.md candidate.md profile.json copy-spec.json [writing-brief.json]');
+    const profile = readProfile(profilePath);
+    const candidateText = input(candidate);
+    const result = verifyWithCopySpec(input(original), candidateText, profile, parseCopySpec(JSON.parse(input(specPath))), readBrief(briefPath));
+    json(result);
+    return result.passed ? 0 : 2;
+}
+function runLifecycle(args) {
+    const [action, ...raw] = args;
+    if (action === 'prepare-semantic')
+        return prepareSemanticLifecycle(raw);
+    if (action === 'submit-verdict')
+        return submitLifecycleVerdict(raw);
+    if (action === 'inspect')
+        return inspectLifecycleArtifact(raw);
+    if (action === 'validate-final-approval' || action === 'finalize')
+        return finishLifecycle(action, raw);
+    throw new Error('Usage: hyv lifecycle <prepare-semantic|submit-verdict|inspect|validate-final-approval|finalize> ...');
+}
+function prepareSemanticLifecycle(args) {
+    const [deterministicPath, bindingPath, receiptPath, policy, violationsPath, output, ...extra] = args;
+    if (!deterministicPath || !bindingPath || !receiptPath || !policy || !violationsPath || !output || extra.length || !['normal', 'high_assurance'].includes(policy))
+        throw new Error('Usage: hyv lifecycle prepare-semantic deterministic.json binding.json receipt.json <normal|high_assurance> violations.json output.json');
+    if (policy === 'high_assurance')
+        throw new Error('High-assurance semantic review requires a trusted embedding.');
+    const result = prepareLifecycle(readJson(deterministicPath), readJson(bindingPath), readJson(receiptPath), policy, readJson(violationsPath));
+    const serialized = canonicalJson(result);
+    writeFileSync(output, `${serialized}\n`, { encoding: 'utf8', flag: 'wx', mode: 0o600 });
+    process.stdout.write(`${serialized}\n`);
+    return 0;
+}
+function submitLifecycleVerdict(args) {
+    const [artifactPath, taskPath, evaluatorId, verdictPath, ...extra] = args;
+    if (!artifactPath || !taskPath || !evaluatorId || !verdictPath || extra.length)
+        throw new Error('Usage: hyv lifecycle submit-verdict artifact.json task.json evaluator-id verdict.json');
+    const artifact = readJson(artifactPath);
+    const task = readJson(taskPath);
+    if (task.policy !== 'normal')
+        throw new Error('High-assurance semantic review requires a trusted embedding.');
+    const result = submitSemanticVerdict(artifact, task, evaluatorId, readJson(verdictPath), loadApprovalContext());
+    canonical(result.ok ? result.artifact : { error: result.error });
+    return result.ok && result.artifact.status === 'ready_for_human_review' ? 0 : 2;
+}
+function inspectLifecycleArtifact(args) {
+    const [artifactPath, ...extra] = args;
+    if (!artifactPath || extra.length)
+        throw new Error('Usage: hyv lifecycle inspect artifact.json');
+    canonical(inspectLifecycle(readJson(artifactPath)));
+    return 0;
+}
+function finishLifecycle(action, args) {
+    const { values, capability } = capabilityArguments(args);
+    if (action === 'validate-final-approval') {
+        const [artifactPath, ...extra] = values;
+        if (!artifactPath || extra.length || !capability)
+            throw new Error('Usage: hyv lifecycle validate-final-approval artifact.json (--capability-stdin|--capability-file path)');
+        const result = validateFinalApproval(readJson(artifactPath), capability, loadApprovalContext());
+        canonical(result);
+        return result.ok ? 0 : 2;
+    }
+    const [artifactPath, decisionPath, ...extra] = values;
+    if (!artifactPath || !decisionPath || extra.length)
+        throw new Error('Usage: hyv lifecycle finalize artifact.json decision.json [--capability-stdin|--capability-file path]');
+    const decision = readJson(decisionPath);
+    if (decision.decision === 'approve' && !capability)
+        throw new Error('Approval requires a capability.');
+    if (decision.decision === 'reject' && capability)
+        throw new Error('Rejection does not accept a capability.');
+    const result = finalizeLifecycle(readJson(artifactPath), decision, loadApprovalContext(), capability);
+    canonical(result.ok ? result.artifact : { error: result.error });
+    return result.ok && result.artifact.status === 'approved' ? 0 : 2;
+}
+function runLearning(args) {
+    const [action, ...raw] = args;
+    if (action === 'record-approved')
+        return runRecordApprovedLearning(raw);
+    const { values, options } = learningArguments(raw);
+    const [profilePath, ...operands] = values;
+    if (!action || !profilePath)
+        throw new Error('Usage: hyv learning <show|inspect|add|record|ratify|supersede|migrate|clear> profile.json [value] [options]');
+    const profile = readProfile(profilePath);
+    if (action === 'show') {
+        json({ profile: profileFingerprint(profile), preferences: composeLearning(profile, options) });
         return 0;
     }
-    if (command === 'reduce-judgment') {
-        if (rest.length < 3)
-            throw new Error('Usage: hyv reduce-judgment envelope.json envelope.json [envelope.json...]');
-        const envelopes = rest.map((path) => parseJudgmentEnvelope(JSON.parse(input(path))));
-        const stage = envelopes[0]?.stage;
-        json(stage === 'pre-edit' ? reducePreEdit(envelopes) : reducePostCandidate(envelopes));
+    if (action === 'inspect') {
+        if (Object.keys(options).length)
+            throw new Error('Usage: hyv learning inspect profile.json');
+        json(inspectLearning(profile));
         return 0;
     }
-    if (command === 'prepare-rebuild') {
-        const { values, capability, recompositionPolicy } = rebuildArguments(rest);
-        const [draft, profilePath, reductionPath, specPath, output, briefPath] = values;
-        if (!draft || !profilePath || !reductionPath || !specPath || !output || !capability) {
-            throw new Error('Usage: hyv prepare-rebuild draft.md profile.json reduction.json copy-spec.json task.json [writing-brief.json] [--recomposition-policy policy.json] (--capability-stdin|--capability-file path)');
-        }
-        const context = loadApprovalContext();
-        const task = prepareRebuildTask(input(draft), readProfile(profilePath), readJson(reductionPath), parseCopySpec(JSON.parse(input(specPath))), capability, context.trustStore, context.now, briefPath ? parseWritingBrief(JSON.parse(input(briefPath))) : undefined, recompositionPolicy);
-        writeFileSync(output, `${JSON.stringify(task, null, 2)}\n`);
-        json({ version: task.version, fingerprint: task.fingerprint, recommendationFingerprint: task.recommendationFingerprint, authorizationFingerprint: task.authorizationFingerprint, ...(task.recompositionPolicy ? { recompositionPolicy: task.recompositionPolicy } : {}) });
+    if (action === 'add' || action === 'record') {
+        const text = operands.join(' ').trim();
+        if (!text)
+            throw new Error('Usage: hyv learning record profile.json "instruction" [options]');
+        const result = recordLearningInstruction(profile, text, options);
+        json(action === 'add' ? { added: result.status === 'recorded' } : result);
         return 0;
     }
-    if (command === 'apply-rebuild') {
-        const { values, capability } = capabilityArguments(rest);
-        const [taskPath, responsePath, profilePath, ...extra] = values;
-        if (!taskPath || !responsePath || !profilePath || extra.length || !capability)
-            throw new Error('Usage: hyv apply-rebuild task.json response.json profile.json (--capability-stdin|--capability-file path)');
-        const context = loadApprovalContext();
-        const result = evaluateRebuildResponse(parseRebuildTask(JSON.parse(input(taskPath))), input(responsePath), readProfile(profilePath), capability, context.trustStore, context.now);
-        json(result);
-        return result.status === 'accepted' ? 0 : 2;
-    }
-    if (command === 'rebuild-writer-request') {
-        const [taskPath, output, ...extra] = rest;
-        if (!taskPath || !output || extra.length)
-            throw new Error('Usage: hyv rebuild-writer-request task.json writer-request.json');
-        const request = writerRequestForRebuild(parseRebuildTask(JSON.parse(input(taskPath))));
-        writeFileSync(output, `${JSON.stringify(request, null, 2)}\n`);
-        json({ version: request.version, taskFingerprint: request.taskFingerprint, copySpecFingerprint: request.copySpecFingerprint, ...(request.recompositionPolicyFingerprint ? { recompositionPolicyFingerprint: request.recompositionPolicyFingerprint } : {}) });
+    if (action === 'ratify' || action === 'supersede') {
+        const [eventId, ...extra] = operands;
+        if (!eventId || extra.length)
+            throw new Error(`Usage: hyv learning ${action} profile.json event-id [options]`);
+        json(action === 'ratify' ? ratifyLearningEvent(requireProfileV3(profile), eventId, options) : supersedeLearningEvent(requireProfileV3(profile), eventId, options));
         return 0;
     }
-    if (command === 'verify') {
-        const [original, candidate, profilePath, briefPath] = rest;
-        if (!original || !candidate || !profilePath)
-            throw new Error('Usage: hyv verify original.md candidate.md profile.json [writing-brief.json]');
-        const profile = readProfile(profilePath);
-        const originalText = input(original);
-        const candidateText = input(candidate);
-        const result = verify(originalText, candidateText, profile, readBrief(briefPath));
-        json(result);
-        return result.passed ? 0 : 2;
-    }
-    if (command === 'verify-spec') {
-        const [original, candidate, profilePath, specPath, briefPath] = rest;
-        if (!original || !candidate || !profilePath || !specPath)
-            throw new Error('Usage: hyv verify-spec original.md candidate.md profile.json copy-spec.json [writing-brief.json]');
-        const profile = readProfile(profilePath);
-        const candidateText = input(candidate);
-        const result = verifyWithCopySpec(input(original), candidateText, profile, parseCopySpec(JSON.parse(input(specPath))), readBrief(briefPath));
-        json(result);
-        return result.passed ? 0 : 2;
-    }
-    if (command === 'lifecycle') {
-        const [action, ...raw] = rest;
-        if (action === 'prepare-semantic') {
-            const [deterministicPath, bindingPath, receiptPath, policy, violationsPath, output, ...extra] = raw;
-            if (!deterministicPath || !bindingPath || !receiptPath || !policy || !violationsPath || !output || extra.length || !['normal', 'high_assurance'].includes(policy))
-                throw new Error('Usage: hyv lifecycle prepare-semantic deterministic.json binding.json receipt.json <normal|high_assurance> violations.json output.json');
-            if (policy === 'high_assurance')
-                throw new Error('High-assurance semantic review requires a trusted embedding.');
-            const result = prepareLifecycle(readJson(deterministicPath), readJson(bindingPath), readJson(receiptPath), policy, readJson(violationsPath));
-            const serialized = canonicalJson(result);
-            writeFileSync(output, `${serialized}\n`, { encoding: 'utf8', flag: 'wx', mode: 0o600 });
-            process.stdout.write(`${serialized}\n`);
-            return 0;
-        }
-        if (action === 'submit-verdict') {
-            const [artifactPath, taskPath, evaluatorId, verdictPath, ...extra] = raw;
-            if (!artifactPath || !taskPath || !evaluatorId || !verdictPath || extra.length)
-                throw new Error('Usage: hyv lifecycle submit-verdict artifact.json task.json evaluator-id verdict.json');
-            const artifact = readJson(artifactPath);
-            const task = readJson(taskPath);
-            if (task.policy !== 'normal')
-                throw new Error('High-assurance semantic review requires a trusted embedding.');
-            const result = submitSemanticVerdict(artifact, task, evaluatorId, readJson(verdictPath), loadApprovalContext());
-            canonical(result.ok ? result.artifact : { error: result.error });
-            return result.ok && result.artifact.status === 'ready_for_human_review' ? 0 : 2;
-        }
-        if (action === 'inspect') {
-            const [artifactPath, ...extra] = raw;
-            if (!artifactPath || extra.length)
-                throw new Error('Usage: hyv lifecycle inspect artifact.json');
-            canonical(inspectLifecycle(readJson(artifactPath)));
-            return 0;
-        }
-        if (action === 'validate-final-approval' || action === 'finalize') {
-            const { values, capability } = capabilityArguments(raw);
-            if (action === 'validate-final-approval') {
-                const [artifactPath, ...extra] = values;
-                if (!artifactPath || extra.length || !capability)
-                    throw new Error('Usage: hyv lifecycle validate-final-approval artifact.json (--capability-stdin|--capability-file path)');
-                const result = validateFinalApproval(readJson(artifactPath), capability, loadApprovalContext());
-                canonical(result);
-                return result.ok ? 0 : 2;
-            }
-            const [artifactPath, decisionPath, ...extra] = values;
-            if (!artifactPath || !decisionPath || extra.length)
-                throw new Error('Usage: hyv lifecycle finalize artifact.json decision.json [--capability-stdin|--capability-file path]');
-            const decision = readJson(decisionPath);
-            if (decision.decision === 'approve' && !capability)
-                throw new Error('Approval requires a capability.');
-            if (decision.decision === 'reject' && capability)
-                throw new Error('Rejection does not accept a capability.');
-            const result = finalizeLifecycle(readJson(artifactPath), decision, loadApprovalContext(), capability);
-            canonical(result.ok ? result.artifact : { error: result.error });
-            return result.ok && result.artifact.status === 'approved' ? 0 : 2;
-        }
-        throw new Error('Usage: hyv lifecycle <prepare-semantic|submit-verdict|inspect|validate-final-approval|finalize> ...');
-    }
-    if (command === 'learning') {
-        const [action, ...raw] = rest;
-        if (action === 'record-approved') {
-            const { values, capability } = capabilityArguments(raw);
-            const [readyPath, approvedPath, originalPath, candidatePath, profilePath, decisionPath, ...contextPaths] = values;
-            if (!readyPath || !approvedPath || !originalPath || !candidatePath || !profilePath || !decisionPath || !capability)
-                throw new Error('Usage: hyv learning record-approved ready.json approved.json original.md candidate.md profile.json decision.json [copy-spec.json] [writing-brief.json] (--capability-stdin|--capability-file path)');
-            const context = prepareContext(contextPaths);
-            const status = recordApprovedLearning({ ready: readJson(readyPath), approved: readJson(approvedPath), decision: readJson(decisionPath), capability, source: input(originalPath), candidate: input(candidatePath), profile: readProfile(profilePath), context: loadApprovalContext(), copySpec: context.copySpec, writingBrief: context.writingBrief });
-            canonical({ status });
-            return status === 'write_failed' ? 2 : 0;
-        }
-        const { values, options } = learningArguments(raw);
-        const [profilePath, ...operands] = values;
-        if (!action || !profilePath)
-            throw new Error('Usage: hyv learning <show|inspect|add|record|ratify|supersede|migrate|clear> profile.json [value] [options]');
-        const profile = readProfile(profilePath);
-        if (action === 'show') {
-            json({ profile: profileFingerprint(profile), preferences: composeLearning(profile, options) });
-            return 0;
-        }
-        if (action === 'inspect') {
-            if (Object.keys(options).length)
-                throw new Error('Usage: hyv learning inspect profile.json');
-            json(inspectLearning(profile));
-            return 0;
-        }
-        if (action === 'add' || action === 'record') {
-            const text = operands.join(' ').trim();
-            if (!text)
-                throw new Error('Usage: hyv learning record profile.json "instruction" [options]');
-            const result = recordLearningInstruction(profile, text, options);
-            json(action === 'add' ? { added: result.status === 'recorded' } : result);
-            return 0;
-        }
-        if (action === 'ratify' || action === 'supersede') {
-            const [eventId, ...extra] = operands;
-            if (!eventId || extra.length)
-                throw new Error(`Usage: hyv learning ${action} profile.json event-id [options]`);
-            json(action === 'ratify' ? ratifyLearningEvent(requireProfileV3(profile), eventId, options) : supersedeLearningEvent(requireProfileV3(profile), eventId, options));
-            return 0;
-        }
-        if (action === 'migrate') {
-            const [targetPath, ...extra] = operands;
-            if (!targetPath || extra.length || profile.version !== '2')
-                throw new Error('Usage: hyv learning migrate source-v2.json target-v3.json [options]');
-            json(migrateLearningV2ToV3(profile, requireProfileV3(readProfile(targetPath)), options));
-            return 0;
-        }
-        if (action === 'clear') {
-            if (operands.length || Object.keys(options).length)
-                throw new Error('Usage: hyv learning clear profile.json');
-            json({ cleared: clearLearning(profile) });
-            return 0;
-        }
-        throw new Error('Usage: hyv learning <show|inspect|add|record|ratify|supersede|migrate|clear> profile.json [value] [options]');
-    }
-    if (command === 'patterns') {
-        json({ version: RULESET_VERSION, rules: serializedRules() });
+    if (action === 'migrate') {
+        const [targetPath, ...extra] = operands;
+        if (!targetPath || extra.length || profile.version !== '2')
+            throw new Error('Usage: hyv learning migrate source-v2.json target-v3.json [options]');
+        json(migrateLearningV2ToV3(profile, requireProfileV3(readProfile(targetPath)), options));
         return 0;
     }
-    if (command === 'mcp') {
-        if (rest.length > 0)
-            throw new Error('Usage: hyv mcp');
-        await import('./mcp.js');
+    if (action === 'clear') {
+        if (operands.length || Object.keys(options).length)
+            throw new Error('Usage: hyv learning clear profile.json');
+        json({ cleared: clearLearning(profile) });
         return 0;
     }
-    throw new Error(`${usage}.`);
+    throw new Error('Usage: hyv learning <show|inspect|add|record|ratify|supersede|migrate|clear> profile.json [value] [options]');
+}
+function runRecordApprovedLearning(args) {
+    const { values, capability } = capabilityArguments(args);
+    const [readyPath, approvedPath, originalPath, candidatePath, profilePath, decisionPath, ...contextPaths] = values;
+    if (!readyPath || !approvedPath || !originalPath || !candidatePath || !profilePath || !decisionPath || !capability)
+        throw new Error('Usage: hyv learning record-approved ready.json approved.json original.md candidate.md profile.json decision.json [copy-spec.json] [writing-brief.json] (--capability-stdin|--capability-file path)');
+    const context = prepareContext(contextPaths);
+    const status = recordApprovedLearning({ ready: readJson(readyPath), approved: readJson(approvedPath), decision: readJson(decisionPath), capability, source: input(originalPath), candidate: input(candidatePath), profile: readProfile(profilePath), context: loadApprovalContext(), copySpec: context.copySpec, writingBrief: context.writingBrief });
+    canonical({ status });
+    return status === 'write_failed' ? 2 : 0;
+}
+function runPatterns() {
+    json({ version: RULESET_VERSION, rules: serializedRules() });
+    return 0;
+}
+async function runMcp(args) {
+    if (args.length > 0)
+        throw new Error('Usage: hyv mcp');
+    await import('./mcp.js');
+    return 0;
+}
+const commandHandlers = {
+    agent: runAgent,
+    profile: runProfile,
+    analyze: runAnalyze,
+    hygiene: runHygiene,
+    'inspect-hidden-text': runInspectHiddenText,
+    'apply-hidden-text-policy': runApplyHiddenTextPolicy,
+    'final-check': runFinalCheck,
+    'fact-lint': runFactLint,
+    'logic-lint': runLogicLint,
+    'batch-analyze': runBatchAnalyze,
+    'rewrite-prompt': runRewritePrompt,
+    'prepare-rewrite': runPrepareRewrite,
+    'apply-rewrite': runApplyRewrite,
+    'prepare-judgment': runPrepareJudgment,
+    'reduce-judgment': runReduceJudgment,
+    'prepare-rebuild': runPrepareRebuild,
+    'apply-rebuild': runApplyRebuild,
+    'rebuild-writer-request': runRebuildWriterRequest,
+    verify: runVerify,
+    'verify-spec': runVerifySpec,
+    lifecycle: runLifecycle,
+    learning: runLearning,
+    patterns: runPatterns,
+    mcp: runMcp,
+};
+export async function runCli(args) {
+    const [command, ...rest] = args;
+    const handler = command ? commandHandlers[command] : undefined;
+    if (!handler)
+        throw new Error(`${usage}.`);
+    return handler(rest);
 }
 void (async () => {
     try {