openplanr 1.25.2 → 2.0.0

package/dist/cli/commands/operate/registrars/measurement.js

@@ -0,0 +1,122 @@
+import { display } from '../../../../utils/logger.js';
+import { readOperateContentInput } from '../input.js';
+const MAX_MEASUREMENT_REQUEST_BYTES = 256 * 1024;
+async function measurementRequest(source, expectedKeys) {
+    const bytes = await readOperateContentInput(source);
+    if (bytes.byteLength > MAX_MEASUREMENT_REQUEST_BYTES) {
+        throw Object.assign(new Error('Measurement request exceeds its bounded input size.'), {
+            code: 'E_MEASUREMENT_SCHEDULE_INVALID',
+        });
+    }
+    let value;
+    try {
+        value = JSON.parse(new TextDecoder('utf-8', { fatal: true }).decode(bytes));
+    }
+    catch (cause) {
+        throw Object.assign(new Error('Measurement request must be valid UTF-8 JSON.'), {
+            code: 'E_MEASUREMENT_SCHEDULE_INVALID',
+            cause,
+        });
+    }
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw Object.assign(new Error('Measurement request must be one closed object.'), {
+            code: 'E_MEASUREMENT_SCHEDULE_INVALID',
+        });
+    }
+    const request = value;
+    if (expectedKeys &&
+        JSON.stringify(Object.keys(request).sort()) !== JSON.stringify([...expectedKeys].sort())) {
+        throw Object.assign(new Error('Measurement request contains unsupported fields.'), {
+            code: 'E_MEASUREMENT_SCHEDULE_INVALID',
+        });
+    }
+    return request;
+}
+function renderMeasurementResult(result, json = false) {
+    if (json)
+        display.line(JSON.stringify(result));
+    else {
+        if (!result.ok) {
+            display.line(`${result.error?.code ?? 'E_MEASUREMENT_SCHEDULE_FAILED'}: ${result.error?.problem ?? 'Measurement command failed.'}`);
+        }
+        display.line(result.nextAction);
+        if (result.data?.confirmationDigest) {
+            display.line(`Confirm digest: ${String(result.data.confirmationDigest)}`);
+        }
+    }
+    if (!result.ok)
+        process.exitCode = 1;
+}
+export function registerMeasurementCommands(program, operate, dependencies) {
+    const measurement = operate
+        .command('measurement')
+        .description('Preview and manage disabled-by-default measurement schedules');
+    const actor = (actorId) => ({
+        actorId,
+        kind: 'human',
+        runtime: 'openplanr',
+    });
+    const client = async () => dependencies.createClient(program.opts().projectDir);
+    measurement
+        .command('preview')
+        .requiredOption('--request-file <path|->', 'exact disabled schedule JSON')
+        .requiredOption('--actor <actorId>', 'exact schedule owner')
+        .option('--json')
+        .action(async (options) => {
+        const schedule = await measurementRequest(options.requestFile ?? '');
+        renderMeasurementResult(await (await client()).measurement({
+            operation: 'measurement.preview',
+            schedule: schedule,
+            actor: actor(options.actor ?? ''),
+        }), options.json);
+    });
+    measurement
+        .command('enable')
+        .requiredOption('--request-file <path|->', 'closed JSON with schedule and transition')
+        .requiredOption('--actor <actorId>', 'exact schedule owner')
+        .requiredOption('--confirm <digest>', 'exact digest returned by preview')
+        .option('--json')
+        .action(async (options) => {
+        const request = await measurementRequest(options.requestFile ?? '', [
+            'schedule',
+            'transition',
+        ]);
+        renderMeasurementResult(await (await client()).measurement({
+            operation: 'measurement.enable',
+            schedule: request.schedule,
+            transition: request.transition,
+            confirmDigest: options.confirm ?? '',
+            actor: actor(options.actor ?? ''),
+        }), options.json);
+    });
+    measurement
+        .command('disable')
+        .argument('<scheduleId>')
+        .requiredOption('--request-file <path|->', 'exact disable transition JSON')
+        .requiredOption('--actor <actorId>', 'exact schedule owner')
+        .requiredOption('--confirm <digest>', 'current exact schedule digest')
+        .option('--json')
+        .action(async (scheduleId, options) => {
+        const transition = await measurementRequest(options.requestFile ?? '');
+        renderMeasurementResult(await (await client()).measurement({
+            operation: 'measurement.disable',
+            scheduleId,
+            transition,
+            confirmDigest: options.confirm ?? '',
+            actor: actor(options.actor ?? ''),
+        }), options.json);
+    });
+    measurement
+        .command('status')
+        .argument('<scheduleId>')
+        .requiredOption('--actor <actorId>', 'exact schedule owner')
+        .option('--json')
+        .action(async (scheduleId, options) => {
+        renderMeasurementResult(await (await client()).measurement({
+            operation: 'measurement.status',
+            scheduleId,
+            actor: actor(options.actor ?? ''),
+        }), options.json);
+    });
+}
+//# sourceMappingURL=measurement.js.map

package/dist/cli/commands/operate/registrars/measurement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"measurement.js","sourceRoot":"","sources":["../../../../../src/cli/commands/operate/registrars/measurement.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AACtD,OAAO,EAA8B,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAGlF,MAAM,6BAA6B,GAAG,GAAG,GAAG,IAAI,CAAC;AAEjD,KAAK,UAAU,kBAAkB,CAC/B,MAAc,EACd,YAAgC;IAEhC,MAAM,KAAK,GAAG,MAAM,uBAAuB,CAAC,MAAM,CAAC,CAAC;IACpD,IAAI,KAAK,CAAC,UAAU,GAAG,6BAA6B,EAAE,CAAC;QACrD,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,qDAAqD,CAAC,EAAE;YACpF,IAAI,EAAE,gCAAgC;SACvC,CAAC,CAAC;IACL,CAAC;IACD,IAAI,KAAc,CAAC;IACnB,IAAI,CAAC;QACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC9E,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,+CAA+C,CAAC,EAAE;YAC9E,IAAI,EAAE,gCAAgC;YACtC,KAAK;SACN,CAAC,CAAC;IACL,CAAC;IACD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAChE,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,gDAAgD,CAAC,EAAE;YAC/E,IAAI,EAAE,gCAAgC;SACvC,CAAC,CAAC;IACL,CAAC;IACD,MAAM,OAAO,GAAG,KAAgC,CAAC;IACjD,IACE,YAAY;QACZ,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,IAAI,EAAE,CAAC,EACxF,CAAC;QACD,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,kDAAkD,CAAC,EAAE;YACjF,IAAI,EAAE,gCAAgC;SACvC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,uBAAuB,CAAC,MAAkC,EAAE,IAAI,GAAG,KAAK;IAC/E,IAAI,IAAI;QAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;SAC1C,CAAC;QACJ,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CACV,GAAG,MAAM,CAAC,KAAK,EAAE,IAAI,IAAI,+BAA+B,KAAK,MAAM,CAAC,KAAK,EAAE,OAAO,IAAI,6BAA6B,EAAE,CACtH,CAAC;QACJ,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAChC,IAAI,MAAM,CAAC,IAAI,EAAE,kBAAkB,EAAE,CAAC;YACpC,OAAO,CAAC,IAAI,CAAC,mBAAmB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,OAAgB,EAChB,OAAgB,EAChB,YAAoD;IAEpD,MAAM,WAAW,GAAG,OAAO;SACxB,OAAO,CAAC,aAAa,CAAC;SACtB,WAAW,CAAC,8DAA8D,CAAC,CAAC;IAC/E,MAAM,KAAK,GAAG,CAAC,OAAe,EAAE,EAAE,CAAC,CAAC;QAClC,OAAO;QACP,IAAI,EAAE,OAAgB;QACtB,OAAO,EAAE,WAAW;KACrB,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,KAAK,IAAI,EAAE,CAAC,YAAY,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,UAAoB,CAAC,CAAC;IAE1F,WAAW;SACR,OAAO,CAAC,SAAS,CAAC;SAClB,cAAc,CAAC,yBAAyB,EAAE,8BAA8B,CAAC;SACzE,cAAc,CAAC,mBAAmB,EAAE,sBAAsB,CAAC;SAC3D,MAAM,CAAC,QAAQ,CAAC;SAChB,MAAM,CAAC,KAAK,EAAE,OAAyD,EAAE,EAAE;QAC1E,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,OAAO,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;QACrE,uBAAuB,CACrB,MAAM,CAAC,MAAM,MAAM,EAAE,CAAC,CAAC,WAAW,CAAC;YACjC,SAAS,EAAE,qBAAqB;YAChC,QAAQ,EAAE,QAA+B;YACzC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;SAClC,CAAC,EACF,OAAO,CAAC,IAAI,CACb,CAAC;IACJ,CAAC,CAAC,CAAC;IAEL,WAAW;SACR,OAAO,CAAC,QAAQ,CAAC;SACjB,cAAc,CAAC,yBAAyB,EAAE,0CAA0C,CAAC;SACrF,cAAc,CAAC,mBAAmB,EAAE,sBAAsB,CAAC;SAC3D,cAAc,CAAC,oBAAoB,EAAE,kCAAkC,CAAC;SACxE,MAAM,CAAC,QAAQ,CAAC;SAChB,MAAM,CAAC,KAAK,EAAE,OAAyD,EAAE,EAAE;QAC1E,MAAM,OAAO,GAAG,MAAM,kBAAkB,CAAC,OAAO,CAAC,WAAW,IAAI,EAAE,EAAE;YAClE,UAAU;YACV,YAAY;SACb,CAAC,CAAC;QACH,uBAAuB,CACrB,MAAM,CAAC,MAAM,MAAM,EAAE,CAAC,CAAC,WAAW,CAAC;YACjC,SAAS,EAAE,oBAAoB;YAC/B,QAAQ,EAAE,OAAO,CAAC,QAA+B;YACjD,UAAU,EAAE,OAAO,CAAC,UAAqC;YACzD,aAAa,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;YACpC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;SAClC,CAAC,EACF,OAAO,CAAC,IAAI,CACb,CAAC;IACJ,CAAC,CAAC,CAAC;IAEL,WAAW;SACR,OAAO,CAAC,SAAS,CAAC;SAClB,QAAQ,CAAC,cAAc,CAAC;SACxB,cAAc,CAAC,yBAAyB,EAAE,+BAA+B,CAAC;SAC1E,cAAc,CAAC,mBAAmB,EAAE,sBAAsB,CAAC;SAC3D,cAAc,CAAC,oBAAoB,EAAE,+BAA+B,CAAC;SACrE,MAAM,CAAC,QAAQ,CAAC;SAChB,MAAM,CACL,KAAK,EAAE,UAAkB,EAAE,OAAyD,EAAE,EAAE;QACtF,MAAM,UAAU,GAAG,MAAM,kBAAkB,CAAC,OAAO,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;QACvE,uBAAuB,CACrB,MAAM,CAAC,MAAM,MAAM,EAAE,CAAC,CAAC,WAAW,CAAC;YACjC,SAAS,EAAE,qBAAqB;YAChC,UAAU;YACV,UAAU;YACV,aAAa,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;YACpC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;SAClC,CAAC,EACF,OAAO,CAAC,IAAI,CACb,CAAC;IACJ,CAAC,CACF,CAAC;IAEJ,WAAW;SACR,OAAO,CAAC,QAAQ,CAAC;SACjB,QAAQ,CAAC,cAAc,CAAC;SACxB,cAAc,CAAC,mBAAmB,EAAE,sBAAsB,CAAC;SAC3D,MAAM,CAAC,QAAQ,CAAC;SAChB,MAAM,CAAC,KAAK,EAAE,UAAkB,EAAE,OAA8B,EAAE,EAAE;QACnE,uBAAuB,CACrB,MAAM,CAAC,MAAM,MAAM,EAAE,CAAC,CAAC,WAAW,CAAC;YACjC,SAAS,EAAE,oBAAoB;YAC/B,UAAU;YACV,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;SAClC,CAAC,EACF,OAAO,CAAC,IAAI,CACb,CAAC;IACJ,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/commands/operate/registrars/note-validation.d.ts

@@ -0,0 +1,6 @@
+import { type Command } from 'commander';
+import type { OperateCommandRegistrationDependencies } from './contracts.js';
+type NoteValidationDependencies = Pick<OperateCommandRegistrationDependencies, 'inspectOperateReviewNote'>;
+export declare function registerOperateNoteValidationCommand(operate: Command, dependencies: NoteValidationDependencies): void;
+export {};
+//# sourceMappingURL=note-validation.d.ts.map

package/dist/cli/commands/operate/registrars/note-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"note-validation.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/operate/registrars/note-validation.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,OAAO,EAAU,MAAM,WAAW,CAAC;AAGjD,OAAO,KAAK,EACV,sCAAsC,EAKvC,MAAM,gBAAgB,CAAC;AAQxB,KAAK,0BAA0B,GAAG,IAAI,CACpC,sCAAsC,EACtC,0BAA0B,CAC3B,CAAC;AA2GF,wBAAgB,oCAAoC,CAClD,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,0BAA0B,GACvC,IAAI,CAwBN"}

package/dist/cli/commands/operate/registrars/note-validation.js

@@ -0,0 +1,103 @@
+import { readFile } from 'node:fs/promises';
+import { resolve } from 'node:path';
+import { Option } from 'commander';
+import { display } from '../../../../utils/logger.js';
+import { OperateCommandBoundaryError } from '../input.js';
+const PROFILES = ['advisor', 'challenger', 'chair', 'board-report'];
+const CONTRACT_VERSIONS = ['auto', '1.0.0', '2.0.0'];
+const PUBLIC_DIAGNOSTIC_CODE = /^E_[A-Z0-9_]{1,127}$/u;
+const MAX_PUBLIC_DIAGNOSTICS = 50;
+const MAX_DIAGNOSTIC_TEXT = 500;
+async function readNote(path) {
+    let bytes;
+    try {
+        bytes = await readFile(resolve(path));
+    }
+    catch (error) {
+        const missing = error?.code === 'ENOENT';
+        throw new OperateCommandBoundaryError(missing ? 'E_OPERATE_NOTE_NOT_FOUND' : 'E_OPERATE_NOTE_UNREADABLE', missing
+            ? 'The Operate note file does not exist.'
+            : 'The Operate note file could not be read.', error);
+    }
+    try {
+        return new TextDecoder('utf-8', { fatal: true }).decode(bytes);
+    }
+    catch (error) {
+        throw new OperateCommandBoundaryError('E_OPERATE_NOTE_UTF8_INVALID', 'The Operate note must be valid UTF-8 Markdown.', error);
+    }
+}
+function publicDiagnostics(diagnostics) {
+    return {
+        entries: diagnostics.slice(0, MAX_PUBLIC_DIAGNOSTICS).map(({ code, message }) => ({
+            code: PUBLIC_DIAGNOSTIC_CODE.test(code) ? code : 'E_OPERATE_NOTE_DIAGNOSTIC_INVALID',
+            problem: String(message).replace(/\s+/gu, ' ').trim().slice(0, MAX_DIAGNOSTIC_TEXT),
+        })),
+        omitted: Math.max(0, diagnostics.length - MAX_PUBLIC_DIAGNOSTICS),
+    };
+}
+function renderResult(result, json = false) {
+    const diagnostics = publicDiagnostics(result.diagnostics);
+    const checkCount = result.diagnostics.length;
+    const data = {
+        profile: result.profile,
+        contractVersion: result.contractVersion,
+        contractKind: result.contractKind,
+        versionSource: result.versionSource,
+        byteLength: result.byteLength,
+        itemCount: result.itemCount,
+    };
+    if (json) {
+        display.line(JSON.stringify(result.ok
+            ? {
+                ok: true,
+                operation: 'operate.note.validate',
+                data,
+                diagnostics: diagnostics.entries,
+                ...(diagnostics.omitted > 0 ? { diagnosticsOmitted: diagnostics.omitted } : {}),
+            }
+            : {
+                ok: false,
+                code: 'E_OPERATE_NOTE_INVALID',
+                problem: `The Operate ${result.profile} note failed ${checkCount} contract check${checkCount === 1 ? '' : 's'}.`,
+                data,
+                diagnostics: diagnostics.entries,
+                ...(diagnostics.omitted > 0 ? { diagnosticsOmitted: diagnostics.omitted } : {}),
+            }));
+    }
+    else if (result.ok) {
+        display.line(`Operate ${result.profile} note is valid for ${result.contractKind}@${result.contractVersion} · ${result.byteLength} bytes · ${result.itemCount} item(s).`);
+    }
+    else {
+        display.line(`E_OPERATE_NOTE_INVALID: The Operate ${result.profile} note failed ${checkCount} contract check${checkCount === 1 ? '' : 's'}.`);
+        for (const diagnostic of diagnostics.entries) {
+            display.line(`- ${diagnostic.code}: ${diagnostic.problem}`);
+        }
+        if (diagnostics.omitted > 0) {
+            display.line(`- E_OPERATE_NOTE_DIAGNOSTICS_TRUNCATED: ${diagnostics.omitted} additional diagnostic(s) omitted.`);
+        }
+    }
+    if (!result.ok)
+        process.exitCode = 1;
+}
+export function registerOperateNoteValidationCommand(operate, dependencies) {
+    operate
+        .command('validate-note')
+        .description('Inspect one Operate Markdown note against a selected or detected output contract')
+        .argument('<file>', 'Markdown note to validate')
+        .addOption(new Option('--profile <profile>', 'advisor, challenger, chair, or board-report')
+        .choices([...PROFILES])
+        .makeOptionMandatory())
+        .addOption(new Option('--contract-version <version>', 'note contract version: auto, 1.0.0, or 2.0.0')
+        .choices([...CONTRACT_VERSIONS])
+        .default('auto'))
+        .option('--json')
+        .action(async (file, options) => {
+        const markdown = await readNote(file);
+        const result = await dependencies.inspectOperateReviewNote(markdown, {
+            profile: options.profile,
+            contractVersion: options.contractVersion,
+        });
+        renderResult(result, options.json);
+    });
+}
+//# sourceMappingURL=note-validation.js.map

package/dist/cli/commands/operate/registrars/note-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"note-validation.js","sourceRoot":"","sources":["../../../../../src/cli/commands/operate/registrars/note-validation.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/operate/registrars/planning.d.ts

@@ -0,0 +1,4 @@
+import { type Command } from 'commander';
+import type { OperateCommandRegistrationDependencies } from './contracts.js';
+export declare function registerPlanningCommands(program: Command, operate: Command, dependencies: OperateCommandRegistrationDependencies): void;
+//# sourceMappingURL=planning.d.ts.map

package/dist/cli/commands/operate/registrars/planning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planning.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/operate/registrars/planning.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAU,MAAM,WAAW,CAAC;AAEjD,OAAO,KAAK,EAAE,sCAAsC,EAAE,MAAM,gBAAgB,CAAC;AAG7E,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,sCAAsC,GACnD,IAAI,CAyDN"}

package/dist/cli/commands/operate/registrars/planning.js

@@ -0,0 +1,41 @@
+import { Option } from 'commander';
+import { readOperateFramingInput } from '../input.js';
+import { dispatch } from './dispatch.js';
+export function registerPlanningCommands(program, operate, dependencies) {
+    const planning = operate
+        .command('planning')
+        .description('Preview and explicitly promote planning-work Actions into SPECs');
+    planning
+        .command('preview')
+        .argument('<actionId>')
+        .requiredOption('--actor <actorId>', 'exact authorized human Action owner')
+        .addOption(new Option('--framing-json <json>', 'exact closed Planning framing JSON').conflicts('framingFile'))
+        .addOption(new Option('--framing-file <path>', 'read exact Planning framing JSON from path or stdin (-)').conflicts('framingJson'))
+        .option('--json')
+        .action(async (actionId, options) => {
+        const framing = await readOperateFramingInput(options);
+        return dispatch(program, {
+            operation: 'operate.planning.preview',
+            request: {
+                actionId,
+                actor: { actorId: options.actor ?? '', kind: 'human', runtime: 'openplanr' },
+                ...(framing ? { framing } : {}),
+            },
+        }, options, dependencies);
+    });
+    planning
+        .command('create-spec')
+        .argument('<proposalId>')
+        .requiredOption('--actor <actorId>', 'exact human actor bound by planning preview')
+        .requiredOption('--confirm <digest>', 'exact digest printed by planning preview')
+        .option('--json')
+        .action(async (proposalId, options) => dispatch(program, {
+        operation: 'operate.planning.create-spec',
+        request: {
+            proposalId,
+            confirmDigest: options.confirm ?? '',
+            actor: { actorId: options.actor ?? '', kind: 'human', runtime: 'openplanr' },
+        },
+    }, options, dependencies));
+}
+//# sourceMappingURL=planning.js.map

package/dist/cli/commands/operate/registrars/planning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"planning.js","sourceRoot":"","sources":["../../../../../src/cli/commands/operate/registrars/planning.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,MAAM,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAA8B,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAElF,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,MAAM,UAAU,wBAAwB,CACtC,OAAgB,EAChB,OAAgB,EAChB,YAAoD;IAEpD,MAAM,QAAQ,GAAG,OAAO;SACrB,OAAO,CAAC,UAAU,CAAC;SACnB,WAAW,CAAC,iEAAiE,CAAC,CAAC;IAClF,QAAQ;SACL,OAAO,CAAC,SAAS,CAAC;SAClB,QAAQ,CAAC,YAAY,CAAC;SACtB,cAAc,CAAC,mBAAmB,EAAE,qCAAqC,CAAC;SAC1E,SAAS,CACR,IAAI,MAAM,CAAC,uBAAuB,EAAE,oCAAoC,CAAC,CAAC,SAAS,CACjF,aAAa,CACd,CACF;SACA,SAAS,CACR,IAAI,MAAM,CACR,uBAAuB,EACvB,yDAAyD,CAC1D,CAAC,SAAS,CAAC,aAAa,CAAC,CAC3B;SACA,MAAM,CAAC,QAAQ,CAAC;SAChB,MAAM,CAAC,KAAK,EAAE,QAAgB,EAAE,OAA8B,EAAE,EAAE;QACjE,MAAM,OAAO,GAAG,MAAM,uBAAuB,CAAC,OAAO,CAAC,CAAC;QACvD,OAAO,QAAQ,CACb,OAAO,EACP;YACE,SAAS,EAAE,0BAA0B;YACrC,OAAO,EAAE;gBACP,QAAQ;gBACR,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE;gBAC5E,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAChC;SACF,EACD,OAAO,EACP,YAAY,CACb,CAAC;IACJ,CAAC,CAAC,CAAC;IACL,QAAQ;SACL,OAAO,CAAC,aAAa,CAAC;SACtB,QAAQ,CAAC,cAAc,CAAC;SACxB,cAAc,CAAC,mBAAmB,EAAE,6CAA6C,CAAC;SAClF,cAAc,CAAC,oBAAoB,EAAE,0CAA0C,CAAC;SAChF,MAAM,CAAC,QAAQ,CAAC;SAChB,MAAM,CAAC,KAAK,EAAE,UAAkB,EAAE,OAA8B,EAAE,EAAE,CACnE,QAAQ,CACN,OAAO,EACP;QACE,SAAS,EAAE,8BAA8B;QACzC,OAAO,EAAE;YACP,UAAU;YACV,aAAa,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;YACpC,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE;SAC7E;KACF,EACD,OAAO,EACP,YAAY,CACb,CACF,CAAC;AACN,CAAC"}

package/dist/cli/commands/operate/registrars/recovery.d.ts

@@ -0,0 +1,4 @@
+import type { Command } from 'commander';
+import type { OperateCommandRegistrationDependencies } from './contracts.js';
+export declare function registerRecoveryCommands(program: Command, operate: Command, dependencies: OperateCommandRegistrationDependencies): void;
+//# sourceMappingURL=recovery.d.ts.map

package/dist/cli/commands/operate/registrars/recovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recovery.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/operate/registrars/recovery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQzC,OAAO,KAAK,EAAE,sCAAsC,EAAE,MAAM,gBAAgB,CAAC;AAG7E,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,sCAAsC,GACnD,IAAI,CAkFN"}

package/dist/cli/commands/operate/registrars/recovery.js

@@ -0,0 +1,65 @@
+import { migrateProjectOperateStorage, readOperateStorageStatus, rollbackProjectOperateStorage, } from '../../../../services/operate/storage-migration-service.js';
+import { display } from '../../../../utils/logger.js';
+import { dispatch } from './dispatch.js';
+export function registerRecoveryCommands(program, operate, dependencies) {
+    const recovery = operate.command('recovery').description('Inspect or restore durable state');
+    recovery
+        .command('storage-status')
+        .description('Inspect neutral or legacy Operate storage without activating it')
+        .option('--json')
+        .action(async (options) => {
+        const status = await readOperateStorageStatus(program.opts().projectDir);
+        if (options.json)
+            display.line(JSON.stringify(status));
+        else {
+            display.line(`Operate storage: ${status.status}`);
+            if (status.legacySources.length > 0) {
+                display.line(`Legacy sources: ${status.legacySources.join(', ')}`);
+            }
+            if (status.pinnedVerifierRequired) {
+                display.line('The bundled offline compatibility verifier will run before migration.');
+            }
+            display.line(`Next action: ${status.nextAction}`);
+        }
+    });
+    recovery
+        .command('migrate-storage')
+        .description('Replay-verify legacy v2 storage and activate its exact state with rollback custody')
+        .option('--json')
+        .action(async (options) => {
+        const projectDir = program.opts().projectDir;
+        const receipt = await migrateProjectOperateStorage(projectDir);
+        if (options.json)
+            display.line(JSON.stringify(receipt));
+        else {
+            display.line(receipt.migrated
+                ? `Activated verified legacy state; retained ${receipt.archives.length} rollback archive(s).`
+                : 'Operate storage already uses the neutral layout.');
+        }
+    });
+    recovery
+        .command('rollback-storage')
+        .description('Restore the verified pre-migration v2 Store and preserve forward state')
+        .option('--json')
+        .action(async (options) => {
+        const receipt = await rollbackProjectOperateStorage(program.opts().projectDir);
+        if (options.json)
+            display.line(JSON.stringify(receipt));
+        else
+            display.line(`Restored ${receipt.restoredSource}; preserved ${receipt.forwardSnapshotId}.`);
+    });
+    recovery
+        .command('inspect')
+        .option('--json')
+        .action(async (options) => dispatch(program, { operation: 'operate.recovery.inspect', request: {} }, options, dependencies));
+    recovery
+        .command('restore')
+        .argument('<generation>')
+        .option('--json')
+        .action(async (generation, options) => dispatch(program, { operation: 'operate.recovery.restore', request: { generation } }, options, dependencies));
+    recovery
+        .command('clear-stale-lock')
+        .option('--json')
+        .action(async (options) => dispatch(program, { operation: 'operate.recovery.clear-stale-lock', request: {} }, options, dependencies));
+}
+//# sourceMappingURL=recovery.js.map

package/dist/cli/commands/operate/registrars/recovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recovery.js","sourceRoot":"","sources":["../../../../../src/cli/commands/operate/registrars/recovery.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/operate/registrars/reviews.d.ts

@@ -0,0 +1,4 @@
+import { type Command } from 'commander';
+import type { OperateCommandRegistrationDependencies } from './contracts.js';
+export declare function registerArtifactAndReviewCommands(program: Command, operate: Command, dependencies: OperateCommandRegistrationDependencies): void;
+//# sourceMappingURL=reviews.d.ts.map

package/dist/cli/commands/operate/registrars/reviews.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reviews.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/operate/registrars/reviews.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAU,MAAM,WAAW,CAAC;AAEjD,OAAO,KAAK,EAAE,sCAAsC,EAAE,MAAM,gBAAgB,CAAC;AAG7E,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,sCAAsC,GACnD,IAAI,CA+FN"}

package/dist/cli/commands/operate/registrars/reviews.js

@@ -0,0 +1,83 @@
+import { Option } from 'commander';
+import { dispatch, dispatchExactReviewChoice } from './dispatch.js';
+export function registerArtifactAndReviewCommands(program, operate, dependencies) {
+    operate
+        .command('artifact')
+        .argument('<artifactId>')
+        .requiredOption('--actor <actorId>')
+        .requiredOption('--actor-kind <kind>', 'agent or human')
+        .requiredOption('--runtime <runtime>', 'exact actor runtime')
+        .requiredOption('--scope <scopeId>')
+        .requiredOption('--domain <domainId>')
+        .requiredOption('--domain-version <version>')
+        .option('--assignment <assignmentId>', 'issued Assignment (required for agents)')
+        .addOption(new Option('--representation <representation>', 'raw, canonical, metadata, or decoded-json')
+        .choices(['raw', 'canonical', 'metadata', 'decoded-json'])
+        .default('metadata'))
+        .option('--json')
+        .action(async (artifactId, options) => {
+        if (!['agent', 'human'].includes(options.actorKind ?? '')) {
+            throw Object.assign(new Error('Artifact actor kind must be agent or human.'), {
+                code: 'E_OPERATE_ACTOR_KIND_INVALID',
+            });
+        }
+        if (options.actorKind === 'agent' && !options.assignment) {
+            throw Object.assign(new Error('Agent Artifact reads require --assignment.'), {
+                code: 'E_OPERATE_ASSIGNMENT_REQUIRED',
+            });
+        }
+        return dispatch(program, {
+            operation: 'operate.artifact.get',
+            request: {
+                artifactId,
+                representation: options.representation ?? 'metadata',
+                actor: {
+                    actorId: options.actor ?? '',
+                    kind: options.actorKind,
+                    runtime: options.runtime ?? '',
+                },
+                scope: {
+                    scopeId: options.scope ?? '',
+                    domainId: options.domain ?? '',
+                    domainVersion: options.domainVersion ?? '',
+                },
+                assignmentId: options.assignment ?? null,
+            },
+        }, options, dependencies);
+    });
+    operate
+        .command('review')
+        .argument('<reviewId>')
+        .requiredOption('--actor <actorId>')
+        .requiredOption('--cycle <cycleId>')
+        .requiredOption('--scope <scopeId>')
+        .requiredOption('--domain <domainId>')
+        .requiredOption('--domain-version <version>')
+        .option('--json')
+        .action(async (reviewId, options) => dispatch(program, {
+        operation: 'operate.review.get',
+        request: {
+            reviewId,
+            cycleId: options.cycle ?? '',
+            actor: { actorId: options.actor ?? '', kind: 'human', runtime: 'openplanr' },
+            scope: {
+                scopeId: options.scope ?? '',
+                domainId: options.domain ?? '',
+                domainVersion: options.domainVersion ?? '',
+            },
+        },
+    }, options, dependencies));
+    operate
+        .command('decide')
+        .argument('<reviewId>')
+        .requiredOption('--actor <actorId>')
+        .requiredOption('--cycle <cycleId>')
+        .requiredOption('--scope <scopeId>')
+        .requiredOption('--domain <domainId>')
+        .requiredOption('--domain-version <version>')
+        .requiredOption('--choice <choiceId>', 'exact choice identity from the latest Review read')
+        .requiredOption('--choice-hash <digest>', 'exact choice digest from the latest Review read')
+        .option('--json')
+        .action(async (reviewId, options) => dispatchExactReviewChoice(program, reviewId, options, dependencies));
+}
+//# sourceMappingURL=reviews.js.map

package/dist/cli/commands/operate/registrars/reviews.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reviews.js","sourceRoot":"","sources":["../../../../../src/cli/commands/operate/registrars/reviews.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/operate/registration.d.ts

@@ -0,0 +1,4 @@
+/** Stable public entrypoint for the decomposed Operate command registrars. */
+export type { OperateCommandRegistrationDependencies, OperateNoteContractVersion, OperateNoteContractVersionSelector, OperateNoteContractVersionSource, OperateNoteValidationProfile, OperateNoteValidationResult, } from './registrars/contracts.js';
+export { registerOperateCommandDefinition } from './registrars/index.js';
+//# sourceMappingURL=registration.d.ts.map

package/dist/cli/commands/operate/registration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registration.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/operate/registration.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAE9E,YAAY,EACV,sCAAsC,EACtC,0BAA0B,EAC1B,kCAAkC,EAClC,gCAAgC,EAChC,4BAA4B,EAC5B,2BAA2B,GAC5B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,gCAAgC,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/cli/commands/operate/registration.js

@@ -0,0 +1,3 @@
+/** Stable public entrypoint for the decomposed Operate command registrars. */
+export { registerOperateCommandDefinition } from './registrars/index.js';
+//# sourceMappingURL=registration.js.map

package/dist/cli/commands/operate/registration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registration.js","sourceRoot":"","sources":["../../../../src/cli/commands/operate/registration.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAU9E,OAAO,EAAE,gCAAgC,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/cli/commands/operate/render.d.ts

@@ -0,0 +1,19 @@
+import type { OperateApiEnvelopeV2 } from '../../../services/operate/client.js';
+import type { PublicOperatingDomain } from '../../../services/operate/domain-catalog-service.js';
+export type OperateExperienceSurfaceData = {
+    kind: 'operate-experience-surface';
+    surface: string;
+    domainId: string;
+    scopeId: string;
+    status: string;
+    eventHead: {
+        sequence: number;
+    };
+    viewHash: string;
+    reasonCodes: string[];
+    data: Record<string, unknown>;
+};
+export declare function renderOperateDomainCatalog(domains: readonly PublicOperatingDomain[], json?: boolean): void;
+export declare function renderOperateExperienceSurfaceHuman(data: OperateExperienceSurfaceData): string[];
+export declare function renderOperateEnvelope(envelope: OperateApiEnvelopeV2, json?: boolean): void;
+//# sourceMappingURL=render.d.ts.map

package/dist/cli/commands/operate/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/operate/render.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAChF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qDAAqD,CAAC;AAGjG,MAAM,MAAM,4BAA4B,GAAG;IACzC,IAAI,EAAE,4BAA4B,CAAC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B,CAAC;AAEF,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,SAAS,qBAAqB,EAAE,EACzC,IAAI,UAAQ,GACX,IAAI,CAkBN;AAED,wBAAgB,mCAAmC,CAAC,IAAI,EAAE,4BAA4B,GAAG,MAAM,EAAE,CAuHhG;AAMD,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,oBAAoB,EAAE,IAAI,UAAQ,GAAG,IAAI,CAyExF"}