@holdyourvoice/hyv 3.6.0 → 3.6.1

package/dist/cli.js

@@ -1,979 +1,10 @@
 #!/usr/bin/env node
-import { closeSync, constants, fstatSync, linkSync, lstatSync, mkdtempSync, openSync, readFileSync, readSync, realpathSync, rmSync, writeFileSync } from 'node:fs';
-import { dirname, extname, isAbsolute, join, resolve } from 'node:path';
-import { RULESET_VERSION, serializedRules } from './ai-editor.js';
-import { parseCopySpec } from './copy-spec.js';
-import { analyzeBatch, parseWritingBrief } from './editorial-packs.js';
-import { clearLearning, composeLearning, inspectLearning, migrateLearningV2ToV3, profileFingerprint, ratifyLearningEvent, recordLearningInstruction, supersedeLearningEvent } from './learning.js';
-import { cleanHygiene, finalOutputCheck, inspectHygiene } from './hygiene.js';
-import { applyHiddenTextPolicy, inspectHiddenText, parseHiddenTextPolicy } from './hidden-text.js';
-import { analyze, rewritePrompt, verify, verifyWithCopySpec } from './pipeline.js';
-import { parseProfile } from './profile.js';
-import { evaluateRewriteResponse, parseRewriteTask, prepareRewriteTask } from './rewrite-task.js';
-import { parseJudgmentEnvelope, preparePostCandidateJudgment, preparePreEditJudgment, reducePostCandidate, reducePreEdit } from './judgment-task.js';
-import { evaluateRebuildResponse, parseRebuildTask, prepareRebuildTask, writerRequestForRebuild } from './rebuild-task.js';
-import { canonicalJson, parseCanonicalJson } from './canonical-json.js';
-import { MAX_JSON_BYTES } from './internal.js';
-import { finalizeLifecycle, inspectLifecycle, prepareLifecycle, recordApprovedLearning, submitSemanticVerdict, validateFinalApproval } from './lifecycle-adapter.js';
-import { buildProfile, buildProfileV3 } from './voice-dna.js';
-import { loadApprovalContext } from './approval-context.js';
-import { formatFactLintReport, lintFacts } from './fact-linter.js';
-import { lintLogic } from './logic-linter.js';
-import { loadAll, validateAll, validateId, sortedIds, describe, emitJson, emitPrompt } from './agents/index.js';
-import { inspectDeliveryIntegrity, parseDeliveryIntegrityPolicy } from './delivery-integrity.js';
-import { assessProfileReadiness } from './profile-quality.js';
-import { evaluateStrictQuality } from './strict-quality.js';
-import { normalizeFinding, parseSurfacePolicy } from './disposition.js';
-import { composeTeamProfile, parseTeamProfileBundle } from './team-profile.js';
-import { composeProfiles, parseProfileRatio } from './profile-compose.js';
-import { scoreHeldoutProfile } from './profile-score.js';
-import { ingestGmailSentMbox, ingestTelegramDesktopJson } from './sample-ingest.js';
-import { evaluateIsolatedBacktest } from './backtest.js';
-import { watchProfileSamples } from './profile-watch.js';
-import { evaluateLocalComposite } from './local-eval.js';
-import { findWritingExamples } from './writing-examples.js';
+import { runAgent } from './cli/agents.js';
+import { runProfile, runScore, runBacktest, runEvaluateLocal, runIngest, runTeamProfile } from './cli/profiles.js';
+import { runDeliveryCheck, runAnalyze, runStrictCheck, runHygiene, runInspectHiddenText, runApplyHiddenTextPolicy, runFinalCheck, runFactLint, runLogicLint, runBatchAnalyze, runVerify, runVerifySpec, runPatterns, runDispositions } from './cli/checks.js';
+import { runRewritePrompt, runPrepareRewrite, runApplyRewrite, runPrepareJudgment, runReduceJudgment, runPrepareRebuild, runApplyRebuild, runRebuildWriterRequest } from './cli/rewriting.js';
+import { runLifecycle, runLearning } from './cli/lifecycle.js';
 const usage = 'Commands: agent, profile, team-profile, analyze, score, backtest, evaluate-local, ingest, strict-check, hygiene, inspect-hidden-text, apply-hidden-text-policy, final-check, delivery-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, dispositions, mcp';
-function input(path) {
-    return path === '-' ? readFileSync(0, 'utf8') : readFileSync(path, 'utf8');
-}
-function parseBoundedJson(text) {
-    if (Buffer.byteLength(text, 'utf8') > MAX_JSON_BYTES)
-        throw new Error('JSON input exceeds the byte limit.');
-    const value = JSON.parse(text);
-    canonicalJson(value);
-    return value;
-}
-function readBoundedDescriptor(descriptor) {
-    const chunks = [];
-    let size = 0;
-    while (size <= MAX_JSON_BYTES) {
-        const chunk = Buffer.allocUnsafe(Math.min(64 * 1024, MAX_JSON_BYTES + 1 - size));
-        const count = readSync(descriptor, chunk, 0, chunk.length, null);
-        if (!count)
-            break;
-        chunks.push(chunk.subarray(0, count));
-        size += count;
-    }
-    if (size > MAX_JSON_BYTES)
-        throw new Error('JSON input exceeds the byte limit.');
-    return Buffer.concat(chunks, size).toString('utf8');
-}
-function readJson(path) {
-    if (path === '-')
-        return parseBoundedJson(readBoundedDescriptor(0));
-    let descriptor;
-    try {
-        descriptor = openSync(path, constants.O_RDONLY);
-        return parseBoundedJson(readBoundedDescriptor(descriptor));
-    }
-    finally {
-        if (descriptor !== undefined)
-            closeSync(descriptor);
-    }
-}
-function capabilityArguments(args) {
-    const values = [];
-    let source;
-    for (let index = 0; index < args.length; index += 1) {
-        if (args[index] === '--capability-stdin') {
-            if (source)
-                throw new Error('Choose one capability source.');
-            source = { kind: 'stdin' };
-            continue;
-        }
-        if (args[index] === '--capability-file') {
-            const path = args[index + 1];
-            if (source || !path || path.startsWith('--capability-'))
-                throw new Error('Choose one capability source.');
-            source = { kind: 'file', path };
-            index += 1;
-            continue;
-        }
-        values.push(args[index]);
-    }
-    if (!source)
-        return { values };
-    if (source.kind === 'stdin' && values.includes('-'))
-        throw new Error('Capability stdin cannot be combined with another stdin input.');
-    let raw;
-    if (source.kind === 'stdin')
-        raw = readBoundedDescriptor(0);
-    else {
-        let descriptor;
-        try {
-            descriptor = openSync(source.path, constants.O_RDONLY | (constants.O_NOFOLLOW ?? 0));
-            const before = fstatSync(descriptor);
-            if (!before.isFile() || before.uid !== process.geteuid?.() || (before.mode & 0o077) !== 0 || before.nlink !== 1 || before.size > MAX_JSON_BYTES)
-                throw new Error('Capability file is unavailable or unsafe.');
-            raw = readBoundedDescriptor(descriptor);
-            const after = fstatSync(descriptor);
-            if (before.dev !== after.dev || before.ino !== after.ino || before.size !== after.size || before.mtimeMs !== after.mtimeMs)
-                throw new Error('Capability file is unavailable or unsafe.');
-        }
-        catch {
-            throw new Error('Capability file is unavailable or unsafe.');
-        }
-        finally {
-            if (descriptor !== undefined)
-                closeSync(descriptor);
-        }
-    }
-    if (Buffer.byteLength(raw, 'utf8') > MAX_JSON_BYTES)
-        throw new Error('JSON input exceeds the byte limit.');
-    return { values, capability: parseCanonicalJson(Buffer.from(raw, 'utf8')) };
-}
-function rebuildArguments(args) {
-    const values = [];
-    let policyPath;
-    for (let index = 0; index < args.length; index += 1) {
-        if (args[index] !== '--recomposition-policy') {
-            values.push(args[index]);
-            continue;
-        }
-        const path = args[index + 1];
-        if (policyPath || !path || path === '-' || path.startsWith('--'))
-            throw new Error('Choose one recomposition policy file.');
-        policyPath = path;
-        index += 1;
-    }
-    const capability = capabilityArguments(values);
-    return { ...capability, ...(policyPath ? { recompositionPolicy: readJson(policyPath) } : {}) };
-}
-function readProfile(path) {
-    return parseProfile(JSON.parse(input(path)));
-}
-function requireProfileV3(profile) {
-    if (profile.version !== '3')
-        throw new Error('This learning operation requires a Profile v3.');
-    return profile;
-}
-function learningArguments(args) {
-    const values = [];
-    const options = {};
-    for (const argument of args) {
-        if (!argument.startsWith('--')) {
-            values.push(argument);
-            continue;
-        }
-        const [name, ...parts] = argument.slice(2).split('=');
-        const value = parts.join('=').trim();
-        if (!value)
-            throw new Error(`Learning option --${name} requires a value.`);
-        if (name === 'mutation-id' && value.length <= 200)
-            options.mutationId = value;
-        else if (name === 'authority' && ['founder', 'team', 'system'].includes(value))
-            options.authority = value;
-        else if (name === 'provenance' && value.length <= 500)
-            options.provenance = value;
-        else if (name === 'weight' && Number.isFinite(Number(value)) && Number(value) > 0)
-            options.weight = Number(value);
-        else if (name === 'compatibility' && ['same-or-newer', 'exact'].includes(value))
-            options.compatibility = value;
-        else
-            throw new Error(`Invalid learning option: --${name}=${value}`);
-    }
-    return { values, options };
-}
-function readBrief(path) {
-    return path ? parseWritingBrief(JSON.parse(input(path))) : undefined;
-}
-function prepareContext(paths) {
-    let copySpec;
-    let writingBrief;
-    for (const path of paths) {
-        const value = JSON.parse(input(path));
-        try {
-            const parsed = parseCopySpec(value);
-            if (copySpec)
-                throw new Error('Prepare-rewrite accepts at most one CopySpec.');
-            copySpec = parsed;
-            continue;
-        }
-        catch (error) {
-            if (error instanceof Error && error.message === 'Prepare-rewrite accepts at most one CopySpec.')
-                throw error;
-        }
-        try {
-            const parsed = parseWritingBrief(value);
-            if (writingBrief)
-                throw new Error('Prepare-rewrite accepts at most one WritingBrief.');
-            writingBrief = parsed;
-        }
-        catch (error) {
-            if (error instanceof Error && error.message === 'Prepare-rewrite accepts at most one WritingBrief.')
-                throw error;
-            throw new Error(`Expected a valid CopySpec or WritingBrief at ${path}.`);
-        }
-    }
-    return { copySpec, writingBrief };
-}
-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 = [];
-    const avoid = [];
-    for (const argument of rest) {
-        if (argument.startsWith('--avoid=')) {
-            const phrase = argument.slice('--avoid='.length).trim();
-            if (!phrase)
-                throw new Error('Avoid phrases must use --avoid=phrase.');
-            avoid.push(phrase);
-        }
-        else {
-            samples.push(argument);
-        }
-    }
-    if (!output || samples.length < 2)
-        throw new Error('Usage: hyv profile profile.json sample-a.md sample-b.md [sample-c.md] [--avoid=phrase]');
-    return { output, samples, avoid };
-}
-function cleanedPath(path) {
-    const extension = extname(path);
-    const stem = extension ? path.slice(0, -extension.length) : path;
-    return `${stem}.cleaned${extension}`;
-}
-function hygieneArguments(args) {
-    const [path, ...options] = args;
-    if (!path)
-        throw new Error('Usage: hyv hygiene draft.md [--fix] [--output=cleaned.md]');
-    let fix = false;
-    let output;
-    for (const option of options) {
-        if (option === '--fix')
-            fix = true;
-        else if (option.startsWith('--output='))
-            output = option.slice('--output='.length).trim();
-        else
-            throw new Error('Usage: hyv hygiene draft.md [--fix] [--output=cleaned.md]');
-    }
-    if (output !== undefined && (!output || !fix))
-        throw new Error('--output requires --fix and a non-empty path.');
-    return { path, fix, ...(output ? { output } : {}) };
-}
-function writeNewFileAtomically(path, text) {
-    const temporaryDirectory = mkdtempSync(join(dirname(resolve(path)), '.hyv-hygiene-'));
-    const temporaryPath = join(temporaryDirectory, 'cleaned');
-    let primaryError;
-    try {
-        writeFileSync(temporaryPath, text, 'utf8');
-        try {
-            linkSync(temporaryPath, path);
-        }
-        catch (error) {
-            const code = error.code;
-            if (!['EPERM', 'ENOTSUP', 'EOPNOTSUPP', 'EXDEV'].includes(code ?? ''))
-                throw error;
-            throw new Error(`Atomic hygiene output is not supported by this filesystem: ${path}`);
-        }
-    }
-    catch (error) {
-        primaryError = error.code === 'EEXIST' ? new Error(`Hygiene output already exists: ${path}`) : error;
-    }
-    try {
-        rmSync(temporaryDirectory, { recursive: true, force: true });
-    }
-    catch (error) {
-        if (!primaryError)
-            console.error(`Warning: output was published, but temporary-file cleanup failed: ${error instanceof Error ? error.message : String(error)}`);
-    }
-    if (primaryError)
-        throw primaryError;
-}
-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);
-        }
-    }
-    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 (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 (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 (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);
-        }
-        return 0;
-    }
-    throw new Error('Usage: hyv agent <list|validate|describe|emit> ...');
-}
-async function runProfileWatch(args) {
-    const [output, ...rest] = args;
-    const samples = [];
-    let id = '';
-    let channel;
-    let debounceMs = 500;
-    for (const value of rest) {
-        if (value.startsWith('--id='))
-            id = value.slice('--id='.length);
-        else if (value.startsWith('--channel='))
-            channel = value.slice('--channel='.length);
-        else if (value.startsWith('--debounce-ms='))
-            debounceMs = Number(value.slice('--debounce-ms='.length));
-        else
-            samples.push(value);
-    }
-    if (!output || !isAbsolute(output) || !id || !channel || samples.length < 2)
-        throw new Error('Usage: hyv profile watch /absolute/profile.json --id=writer.channel --channel=email sample-a.md sample-b.md [--debounce-ms=500]');
-    outputOutsideGitCheckout(dirname(output));
-    let initial = true;
-    const rebuild = () => {
-        const profile = buildProfileV3(samples.map(input), id, channel);
-        writeFileSync(output, JSON.stringify(profile, null, 2) + '\n', { encoding: 'utf8', flag: initial ? 'wx' : 'w', mode: 0o600 });
-        initial = false;
-        json({ version: '1', status: 'rebuilt', sampleCount: samples.length, profileId: profile.id, revisionDigest: profile.revisionDigest });
-    };
-    rebuild();
-    const handle = watchProfileSamples({ samples, debounceMs, rebuild });
-    await new Promise((resolve) => process.once('SIGINT', resolve));
-    handle.close();
-    return 0;
-}
-function runProfile(args) {
-    if (args[0] === 'watch')
-        return runProfileWatch(args.slice(1));
-    if (args[0] === 'assess') {
-        if (args.length < 3)
-            throw new Error('Usage: hyv profile assess sample-a.md sample-b.md [sample-c.md]');
-        json(assessProfileReadiness(args.slice(1).map(input)));
-        return 0;
-    }
-    if (args[0] === 'compose') {
-        const rest = args.slice(1);
-        const ratioIndex = rest.findIndex((value) => value === '--ratio' || value.startsWith('--ratio='));
-        if (ratioIndex < 0)
-            throw new Error('Usage: hyv profile compose --ratio 70:30 profile-a.json profile-b.json [profile-c.json]');
-        const ratio = rest[ratioIndex] === '--ratio' ? rest[ratioIndex + 1] : rest[ratioIndex].slice('--ratio='.length);
-        const profilePaths = rest.filter((_, index) => index !== ratioIndex && index !== ratioIndex + Number(rest[ratioIndex] === '--ratio'));
-        if (!ratio || profilePaths.length < 2)
-            throw new Error('Usage: hyv profile compose --ratio 70:30 profile-a.json profile-b.json [profile-c.json]');
-        const profiles = profilePaths.map(readProfile);
-        if (profiles.some((profile) => profile.version !== '3'))
-            throw new Error('Profile composition requires Profile v3 inputs.');
-        json(composeProfiles(profiles, parseProfileRatio(ratio, profiles.length)));
-        return 0;
-    }
-    if (args[0] === 'v3') {
-        const [output, ...rest] = args.slice(1);
-        const samples = [];
-        const avoid = [];
-        let id = '';
-        let channel;
-        let tone;
-        for (const argument of rest) {
-            if (argument.startsWith('--id='))
-                id = argument.slice('--id='.length);
-            else if (argument.startsWith('--channel='))
-                channel = argument.slice('--channel='.length);
-            else if (argument.startsWith('--avoid='))
-                avoid.push(argument.slice('--avoid='.length));
-            else if (argument.startsWith('--tone=')) {
-                const values = argument.slice('--tone='.length).split(',').map(Number);
-                if (values.length !== 5 || values.some((value) => !Number.isFinite(value) || value < 0 || value > 1))
-                    throw new Error('Tone must use five 0–1 comma-separated values: formality,confidence,warmth,energy,complexity.');
-                tone = { formality: values[0], confidence: values[1], warmth: values[2], energy: values[3], complexity: values[4] };
-            }
-            else
-                samples.push(argument);
-        }
-        if (!output || !id || !channel || samples.length < 2)
-            throw new Error('Usage: hyv profile v3 profile.json --id=writer.channel --channel=email sample-a.md sample-b.md [--tone=0,0,0,0,0] [--avoid=phrase]');
-        writeJson(output, buildProfileV3(samples.map(input), id, channel, avoid, tone));
-        return 0;
-    }
-    const { output, samples, avoid } = profileArguments(args);
-    writeJson(output, buildProfile(samples.map(input), avoid));
-    return 0;
-}
-function runScore(args) {
-    const [draftPath, profilePath, ...rest] = args;
-    if (!draftPath || !profilePath)
-        throw new Error('Usage: hyv score draft.md profile.json heldout-a.md heldout-b.md heldout-c.md [--channel=channel]');
-    const samplePaths = [];
-    let channel;
-    for (const value of rest) {
-        if (value.startsWith('--channel='))
-            channel = value.slice('--channel='.length);
-        else
-            samplePaths.push(value);
-    }
-    if (samplePaths.length < 3)
-        throw new Error('Usage: hyv score draft.md profile.json heldout-a.md heldout-b.md heldout-c.md [--channel=channel]');
-    json(scoreHeldoutProfile(input(draftPath), readProfile(profilePath), samplePaths.map(input), channel));
-    return 0;
-}
-function runBacktest(args) {
-    const [contextPath, targetPath, candidatePath, profilePath, ...heldoutPaths] = args;
-    if (!contextPath || !targetPath || !candidatePath || !profilePath || heldoutPaths.length < 3)
-        throw new Error('Usage: hyv backtest context.md heldout-target.md candidate.md profile.json heldout-a.md heldout-b.md heldout-c.md');
-    json(evaluateIsolatedBacktest(input(contextPath), input(targetPath), input(candidatePath), readProfile(profilePath), heldoutPaths.map(input)));
-    return 0;
-}
-function readEvalParagraphs(path, label) {
-    const value = readJson(path);
-    if (!Array.isArray(value) || !value.every((item) => item && typeof item === 'object' && typeof item.paragraph_id === 'string' && typeof item.text === 'string'))
-        throw new Error(`${label} must be a JSON array of { paragraph_id, text } values.`);
-    return value.map((item) => ({ paragraphId: item.paragraph_id, text: item.text }));
-}
-function runEvaluateLocal(args) {
-    const [inputPath, candidatePath, userPath, aiShadowPath] = args;
-    if (!inputPath || !candidatePath || !userPath || !aiShadowPath || args.length !== 4)
-        throw new Error('Usage: hyv evaluate-local input.md candidate.md user-paragraphs.json ai-shadow-paragraphs.json');
-    json(evaluateLocalComposite(input(inputPath), input(candidatePath), readEvalParagraphs(userPath, 'User paragraphs'), readEvalParagraphs(aiShadowPath, 'AI-shadow paragraphs')));
-    return 0;
-}
-function outputOutsideGitCheckout(path) {
-    if (!isAbsolute(path))
-        throw new Error('Sample ingest output must be an absolute path outside a Git checkout.');
-    let current;
-    try {
-        const stats = lstatSync(path);
-        if (!stats.isDirectory() || stats.isSymbolicLink())
-            throw new Error('Sample ingest output directory must be an existing non-symlink directory outside a Git checkout.');
-        current = realpathSync(path);
-    }
-    catch (error) {
-        if (error instanceof Error && error.message.includes('Sample ingest output directory'))
-            throw error;
-        throw new Error('Sample ingest output directory must already exist and remain outside a Git checkout.');
-    }
-    for (;;) {
-        try {
-            lstatSync(join(current, '.git'));
-            throw new Error('Sample ingest output must be outside a Git checkout.');
-        }
-        catch (error) {
-            if (error instanceof Error && error.message === 'Sample ingest output must be outside a Git checkout.')
-                throw error;
-        }
-        const parent = dirname(current);
-        if (parent === current)
-            return;
-        current = parent;
-    }
-}
-function runIngest(args) {
-    const [sourceType, sourcePath, ...options] = args;
-    let owner = '';
-    let output = '';
-    const blockedWords = [];
-    for (const option of options) {
-        if (option.startsWith('--owner='))
-            owner = option.slice('--owner='.length);
-        else if (option.startsWith('--output='))
-            output = option.slice('--output='.length);
-        else if (option.startsWith('--blocked='))
-            blockedWords.push(option.slice('--blocked='.length));
-        else
-            throw new Error('Usage: hyv ingest <gmail-sent-mbox|telegram-desktop-json> export --owner=owner --output=/absolute/safe-directory [--blocked=word]');
-    }
-    if (!sourcePath || !owner || !output || !['gmail-sent-mbox', 'telegram-desktop-json'].includes(sourceType ?? ''))
-        throw new Error('Usage: hyv ingest <gmail-sent-mbox|telegram-desktop-json> export --owner=owner --output=/absolute/safe-directory [--blocked=word]');
-    outputOutsideGitCheckout(output);
-    const result = sourceType === 'gmail-sent-mbox'
-        ? ingestGmailSentMbox(input(sourcePath), owner, blockedWords)
-        : ingestTelegramDesktopJson(input(sourcePath), owner, blockedWords);
-    const outputDirectory = realpathSync(output);
-    const samplesPath = join(outputDirectory, 'samples.jsonl');
-    const receiptPath = join(outputDirectory, 'receipt.json');
-    try {
-        writeFileSync(samplesPath, result.samples.map((sample) => JSON.stringify({ text: sample })).join('\n') + (result.samples.length ? '\n' : ''), { encoding: 'utf8', flag: 'wx', mode: 0o600 });
-    }
-    catch (error) {
-        if (error.code === 'ENOENT')
-            throw new Error('Sample ingest output directory must already exist and remain outside a Git checkout.');
-        throw error;
-    }
-    try {
-        writeFileSync(receiptPath, JSON.stringify(result.receipt, null, 2) + '\n', { encoding: 'utf8', flag: 'wx', mode: 0o600 });
-    }
-    catch (error) {
-        try {
-            rmSync(samplesPath, { force: true });
-        }
-        catch { }
-        throw error;
-    }
-    json(result.receipt);
-    return 0;
-}
-function runTeamProfile(args) {
-    const [action, bundlePath, authorPath, ...brandPaths] = args;
-    if (action === 'validate' && bundlePath && !authorPath) {
-        json(parseTeamProfileBundle(readJson(bundlePath)));
-        return 0;
-    }
-    if (action === 'compose' && bundlePath && authorPath) {
-        const brands = brandPaths.map(readProfile).filter((profile) => profile.version === '3');
-        if (brands.length !== brandPaths.length)
-            throw new Error('Team brand profiles must use Profile v3.');
-        json(composeTeamProfile(readProfile(authorPath), brands, parseTeamProfileBundle(readJson(bundlePath))));
-        return 0;
-    }
-    throw new Error('Usage: hyv team-profile <validate bundle.json|compose bundle.json author-profile.json [brand-profile.json...]>');
-}
-function runDeliveryCheck(args) {
-    const [path, policyPath, ...extra] = args;
-    if (!path || extra.length)
-        throw new Error('Usage: hyv delivery-check <path|-> [policy.json]');
-    const report = inspectDeliveryIntegrity(input(path), policyPath ? parseDeliveryIntegrityPolicy(readJson(policyPath)) : undefined, process.cwd());
-    json(report);
-    return report.passed ? 0 : 2;
-}
-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 runStrictCheck(args) {
-    const [draft, profilePath, ...samplePaths] = args;
-    if (!draft || !profilePath || samplePaths.length < 2)
-        throw new Error('Usage: hyv strict-check draft.md profile-v3.json sample-a.md sample-b.md [sample-c.md ...]');
-    const report = evaluateStrictQuality(input(draft), readProfile(profilePath), samplePaths.map(input));
-    json(report);
-    return report.disposition === 'strict-ready' ? 0 : 2;
-}
-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;
-    }
-    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]');
-    }
-    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, ...rest] = args;
-    const exampleOption = rest.find((value) => value.startsWith('--examples-json='));
-    const briefPaths = rest.filter((value) => !value.startsWith('--'));
-    const briefPath = briefPaths[0];
-    if (!draft || !profilePath || briefPaths.length > 1 || rest.some((value) => value.startsWith('--') && !value.startsWith('--examples-json=')))
-        throw new Error('Usage: hyv rewrite-prompt draft.md profile.json [writing-brief.json] [--examples-json=local-examples.json]');
-    const profile = readProfile(profilePath);
-    const examplesValue = exampleOption ? readJson(exampleOption.slice('--examples-json='.length)) : undefined;
-    if (examplesValue !== undefined && (!Array.isArray(examplesValue) || !examplesValue.every((item) => item && typeof item === 'object' && typeof item.basename === 'string' && typeof item.text === 'string')))
-        throw new Error('Local examples must be a JSON array of { basename, text } values.');
-    const draftText = input(draft);
-    console.log(rewritePrompt(draftText, profile, composeLearning(profile), readBrief(briefPath), examplesValue ? findWritingExamples(draftText, examplesValue) : []));
-    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 (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]');
-}
-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;
-}
-function runDispositions(args) {
-    const [draft, profilePath, briefPath, surfacePolicyPath] = args;
-    if (!draft || !profilePath)
-        throw new Error('Usage: hyv dispositions draft.md profile.json [writing-brief.json]');
-    const report = analyze(input(draft), readProfile(profilePath), readBrief(briefPath));
-    const policy = surfacePolicyPath ? parseSurfacePolicy(readJson(surfacePolicyPath)) : undefined;
-    json({ version: '1', findings: [report.voiceDna, report.aiEditor, report.editorial].flatMap((engine) => engine?.findings.map((finding) => normalizeFinding(finding, policy)) ?? []) });
-    return 0;
-}
 async function runMcp(args) {
     if (args.length > 0)
         throw new Error('Usage: hyv mcp');