openplanr 1.25.3 → 2.0.1

package/dist/cli/commands/groups/operations.js

@@ -0,0 +1,17 @@
+import { registerArtifactCommand } from '../artifact.js';
+import { registerCompanyCommand } from '../company.js';
+import { registerDashboardCommand } from '../dashboard.js';
+import { registerDiagramCommand } from '../diagram/index.js';
+import { registerLandCommand } from '../land.js';
+import { registerLinearCommand } from '../linear.js';
+import { registerOperateCommand } from '../operate.js';
+export function registerOperationsCommands(program) {
+    registerArtifactCommand(program);
+    registerCompanyCommand(program);
+    registerDashboardCommand(program);
+    registerDiagramCommand(program);
+    registerLinearCommand(program);
+    registerOperateCommand(program);
+    registerLandCommand(program);
+}
+//# sourceMappingURL=operations.js.map

package/dist/cli/commands/groups/operations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.js","sourceRoot":"","sources":["../../../../src/cli/commands/groups/operations.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAEvD,MAAM,UAAU,0BAA0B,CAAC,OAAgB;IACzD,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACjC,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAChC,wBAAwB,CAAC,OAAO,CAAC,CAAC;IAClC,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAChC,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAC/B,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAChC,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAC/B,CAAC"}

package/dist/cli/commands/groups/planning.d.ts

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

package/dist/cli/commands/groups/planning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planning.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/groups/planning.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAazC,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAY/D"}

package/dist/cli/commands/groups/planning.js

@@ -0,0 +1,25 @@
+import { registerBacklogCommand } from '../backlog.js';
+import { registerChecklistCommand } from '../checklist.js';
+import { registerConfigCommand } from '../config-deterministic.js';
+import { registerEpicCommand } from '../epic.js';
+import { registerFeatureCommand } from '../feature.js';
+import { registerQuickCommand } from '../quick.js';
+import { registerRulesCommand } from '../rules.js';
+import { registerSpecCommand } from '../spec.js';
+import { registerStatusCommand } from '../status.js';
+import { registerStoryCommand } from '../story.js';
+import { registerTaskCommand } from '../task.js';
+export function registerPlanningCommands(program) {
+    registerBacklogCommand(program);
+    registerEpicCommand(program);
+    registerFeatureCommand(program);
+    registerStoryCommand(program);
+    registerTaskCommand(program);
+    registerQuickCommand(program);
+    registerSpecCommand(program);
+    registerChecklistCommand(program);
+    registerRulesCommand(program);
+    registerStatusCommand(program);
+    registerConfigCommand(program);
+}
+//# sourceMappingURL=planning.js.map

package/dist/cli/commands/groups/planning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"planning.js","sourceRoot":"","sources":["../../../../src/cli/commands/groups/planning.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,UAAU,wBAAwB,CAAC,OAAgB;IACvD,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAChC,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC7B,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAChC,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC9B,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC7B,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC9B,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC7B,wBAAwB,CAAC,OAAO,CAAC,CAAC;IAClC,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC9B,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAC/B,qBAAqB,CAAC,OAAO,CAAC,CAAC;AACjC,CAAC"}

package/dist/cli/commands/index.d.ts

@@ -0,0 +1,4 @@
+import type { Command } from 'commander';
+/** The single composition boundary for the stable root command catalog. */
+export declare function registerCliCommands(program: Command, version: string): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/commands/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOzC,2EAA2E;AAC3E,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAM3E"}

package/dist/cli/commands/index.js

@@ -0,0 +1,14 @@
+import { registerDeliveryCommands } from './groups/delivery.js';
+import { registerFoundationCommands } from './groups/foundation.js';
+import { registerIntelligenceCommands } from './groups/intelligence.js';
+import { registerOperationsCommands } from './groups/operations.js';
+import { registerPlanningCommands } from './groups/planning.js';
+/** The single composition boundary for the stable root command catalog. */
+export function registerCliCommands(program, version) {
+    registerFoundationCommands(program, version);
+    registerOperationsCommands(program);
+    registerPlanningCommands(program);
+    registerIntelligenceCommands(program);
+    registerDeliveryCommands(program, version);
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/commands/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/commands/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAEhE,2EAA2E;AAC3E,MAAM,UAAU,mBAAmB,CAAC,OAAgB,EAAE,OAAe;IACnE,0BAA0B,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC7C,0BAA0B,CAAC,OAAO,CAAC,CAAC;IACpC,wBAAwB,CAAC,OAAO,CAAC,CAAC;IAClC,4BAA4B,CAAC,OAAO,CAAC,CAAC;IACtC,wBAAwB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AAC7C,CAAC"}

package/dist/cli/commands/init-deterministic.d.ts

@@ -0,0 +1,3 @@
+import { type Command } from 'commander';
+export declare function registerInitCommand(program: Command): void;
+//# sourceMappingURL=init-deterministic.d.ts.map

package/dist/cli/commands/init-deterministic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-deterministic.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init-deterministic.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,OAAO,EAAU,MAAM,WAAW,CAAC;AAQjD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,QAoCnD"}

package/dist/cli/commands/init-deterministic.js

@@ -0,0 +1,40 @@
+import path from 'node:path';
+import { Option } from 'commander';
+import { createChecklist } from '../../services/checklist-service.js';
+import { createDefaultConfig, saveConfig } from '../../services/config-service.js';
+import { renderTemplate } from '../../services/template-service.js';
+import { ARTIFACT_DIRS, CONFIG_FILENAME } from '../../utils/constants.js';
+import { ensureDir, fileExists, writeFile } from '../../utils/fs.js';
+import { logger } from '../../utils/logger.js';
+export function registerInitCommand(program) {
+    program
+        .command('init')
+        .description('Initialize deterministic OpenPlanr project storage')
+        .option('--name <name>', 'project name')
+        .option('--force', 'replace the existing project configuration')
+        .addOption(new Option('--no-ai', 'deprecated no-op; initialization is always deterministic').hideHelp())
+        .addOption(new Option('-y, --yes', 'deprecated no-op retained for script compatibility').hideHelp())
+        .action(async (options) => {
+        const projectDir = program.opts().projectDir;
+        const configPath = path.join(projectDir, CONFIG_FILENAME);
+        if (await fileExists(configPath)) {
+            if (!options.force)
+                throw new Error('OpenPlanr is already initialized; pass --force to replace its configuration.');
+        }
+        const projectName = options.name?.trim() || path.basename(projectDir);
+        const config = createDefaultConfig(projectName);
+        const agileDir = path.join(projectDir, config.outputPaths.agile);
+        for (const directory of Object.values(ARTIFACT_DIRS))
+            await ensureDir(path.join(agileDir, directory));
+        await ensureDir(path.join(agileDir, 'diagrams'));
+        await saveConfig(projectDir, config);
+        await createChecklist(projectDir, config);
+        const estimationPath = path.join(agileDir, 'ESTIMATION.md');
+        if (!(await fileExists(estimationPath))) {
+            await writeFile(estimationPath, await renderTemplate('guides/estimation.md.hbs', {}));
+        }
+        logger.success(`Initialized ${projectName} at ${config.outputPaths.agile}/.`);
+        logger.info('Install a host plugin for agent-led Plan, Spec, and Ship workflows.');
+    });
+}
+//# sourceMappingURL=init-deterministic.js.map

package/dist/cli/commands/init-deterministic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-deterministic.js","sourceRoot":"","sources":["../../../src/cli/commands/init-deterministic.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAgB,MAAM,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AACnF,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC1E,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE/C,MAAM,UAAU,mBAAmB,CAAC,OAAgB;IAClD,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,oDAAoD,CAAC;SACjE,MAAM,CAAC,eAAe,EAAE,cAAc,CAAC;SACvC,MAAM,CAAC,SAAS,EAAE,4CAA4C,CAAC;SAC/D,SAAS,CACR,IAAI,MAAM,CAAC,SAAS,EAAE,0DAA0D,CAAC,CAAC,QAAQ,EAAE,CAC7F;SACA,SAAS,CACR,IAAI,MAAM,CAAC,WAAW,EAAE,oDAAoD,CAAC,CAAC,QAAQ,EAAE,CACzF;SACA,MAAM,CAAC,KAAK,EAAE,OAA2C,EAAE,EAAE;QAC5D,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,UAAoB,CAAC;QACvD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;QAC1D,IAAI,MAAM,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YACjC,IAAI,CAAC,OAAO,CAAC,KAAK;gBAChB,MAAM,IAAI,KAAK,CACb,8EAA8E,CAC/E,CAAC;QACN,CAAC;QACD,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QACtE,MAAM,MAAM,GAAG,mBAAmB,CAAC,WAAW,CAAC,CAAC;QAChD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACjE,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC;YAClD,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC;QAClD,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC;QACjD,MAAM,UAAU,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QACrC,MAAM,eAAe,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAC1C,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;QAC5D,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,cAAc,CAAC,CAAC,EAAE,CAAC;YACxC,MAAM,SAAS,CAAC,cAAc,EAAE,MAAM,cAAc,CAAC,0BAA0B,EAAE,EAAE,CAAC,CAAC,CAAC;QACxF,CAAC;QACD,MAAM,CAAC,OAAO,CAAC,eAAe,WAAW,OAAO,MAAM,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC,CAAC;QAC9E,MAAM,CAAC,IAAI,CAAC,qEAAqE,CAAC,CAAC;IACrF,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/commands/land.d.ts

@@ -0,0 +1,15 @@
+import type { Command } from 'commander';
+import type { LandingPrepareInputV1, LandingServiceV1 } from '../../services/landing/landing-service.js';
+export type LandCommandServiceFactory = (input: Readonly<{
+    projectDir: string;
+}>) => Promise<LandingServiceV1> | LandingServiceV1;
+export type LandCommandDependencies = Readonly<{
+    createService?: LandCommandServiceFactory;
+    authorityContext?: () => Readonly<{
+        agent: boolean;
+        hook: boolean;
+    }>;
+}>;
+export declare function readLandingPrepareRequestV1(pathname: string): Promise<LandingPrepareInputV1>;
+export declare function registerLandCommand(program: Command, dependencies?: LandCommandDependencies): void;
+//# sourceMappingURL=land.d.ts.map

package/dist/cli/commands/land.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"land.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/land.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAEV,qBAAqB,EACrB,gBAAgB,EACjB,MAAM,2CAA2C,CAAC;AAQnD,MAAM,MAAM,yBAAyB,GAAG,CACtC,KAAK,EAAE,QAAQ,CAAC;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,KACpC,OAAO,CAAC,gBAAgB,CAAC,GAAG,gBAAgB,CAAC;AAElD,MAAM,MAAM,uBAAuB,GAAG,QAAQ,CAAC;IAC7C,aAAa,CAAC,EAAE,yBAAyB,CAAC;IAC1C,gBAAgB,CAAC,EAAE,MAAM,QAAQ,CAAC;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CACtE,CAAC,CAAC;AA+CH,wBAAsB,2BAA2B,CAC/C,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,qBAAqB,CAAC,CAkChC;AAuCD,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,OAAO,EAChB,YAAY,GAAE,uBAA4B,GACzC,IAAI,CAwFN"}

package/dist/cli/commands/land.js

@@ -0,0 +1,176 @@
+import { lstat, readFile } from 'node:fs/promises';
+import { display, logger } from '../../utils/logger.js';
+import { CliBoundaryError, toCliFailureEnvelope } from '../error-boundary.js';
+const MAX_REQUEST_BYTES = 2 * 1024 * 1024;
+const PLAN_ID = /^land_[a-f0-9]{32}$/u;
+const OPERATION_ID = /^lop_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$/u;
+function stdinBytes() {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        let size = 0;
+        process.stdin.on('data', (chunk) => {
+            const bytes = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk, 'utf8');
+            size += bytes.byteLength;
+            if (size > MAX_REQUEST_BYTES) {
+                reject(new CliBoundaryError('E_LANDING_REQUEST_TOO_LARGE', 'The landing request exceeds the bounded input size.'));
+                process.stdin.pause();
+                return;
+            }
+            chunks.push(bytes);
+        });
+        process.stdin.once('error', reject);
+        process.stdin.once('end', () => resolve(Buffer.concat(chunks)));
+    });
+}
+async function requestBytes(pathname) {
+    if (pathname === '-')
+        return stdinBytes();
+    let metadata;
+    try {
+        metadata = await lstat(pathname);
+    }
+    catch (cause) {
+        throw new CliBoundaryError('E_LANDING_REQUEST_UNAVAILABLE', 'The landing request file is unavailable.', { cause, recovery: 'Provide one bounded regular JSON request file or use stdin (-).' });
+    }
+    if (!metadata.isFile() || metadata.isSymbolicLink() || metadata.size > MAX_REQUEST_BYTES) {
+        throw new CliBoundaryError('E_LANDING_REQUEST_INVALID', 'The landing request must be one bounded regular file.');
+    }
+    return readFile(pathname);
+}
+export async function readLandingPrepareRequestV1(pathname) {
+    const bytes = await requestBytes(pathname);
+    let value;
+    try {
+        const text = new TextDecoder('utf-8', { fatal: true }).decode(bytes);
+        value = JSON.parse(text);
+    }
+    catch (cause) {
+        throw new CliBoundaryError('E_LANDING_REQUEST_INVALID', 'Landing request JSON is invalid.', {
+            cause,
+        });
+    }
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new CliBoundaryError('E_LANDING_REQUEST_INVALID', 'Landing request must be one closed JSON object.');
+    }
+    const input = value;
+    const allowed = [
+        'baseRecords',
+        'createdAt',
+        'expiresAt',
+        'feature',
+        'operations',
+        'preconditions',
+        'receiptHash',
+    ];
+    if (Object.keys(input).some((key) => !allowed.includes(key))) {
+        throw new CliBoundaryError('E_LANDING_REQUEST_INVALID', 'Landing request contains an unknown field.');
+    }
+    return input;
+}
+function output(result, json) {
+    if (json) {
+        display.line(JSON.stringify(result));
+        return;
+    }
+    display.line(JSON.stringify(result, null, 2));
+}
+function failure(error) {
+    return Object.freeze(toCliFailureEnvelope(error, {
+        code: 'E_LANDING_FAILED',
+        problem: 'Landing stopped safely before any unacknowledged effect.',
+    }));
+}
+async function serviceFor(program, dependencies) {
+    if (!dependencies.createService) {
+        throw new CliBoundaryError('E_LANDING_HOST_NOT_CONFIGURED', 'No trusted installed landing host is configured.', { recovery: 'Install and verify the certified landing Package-B host.' });
+    }
+    return dependencies.createService({ projectDir: program.opts().projectDir });
+}
+function exactPlanId(value) {
+    if (!PLAN_ID.test(value)) {
+        throw new CliBoundaryError('E_LANDING_INPUT_INVALID', 'Landing plan identity is invalid.');
+    }
+}
+export function registerLandCommand(program, dependencies = {}) {
+    const command = program
+        .command('land')
+        .description('Inspect and owner-advance a certified landing plan');
+    command
+        .command('prepare')
+        .description('Prepare a read-only landing plan from a terminal PASS receipt')
+        .requiredOption('--request-file <path|->', 'read one closed landing request')
+        .option('--json', 'machine-readable output', false)
+        .action(async (options) => {
+        try {
+            const service = await serviceFor(program, dependencies);
+            const result = await service.prepare(await readLandingPrepareRequestV1(options.requestFile));
+            output(result, Boolean(options.json));
+        }
+        catch (error) {
+            output(failure(error), Boolean(options.json));
+            process.exitCode = 1;
+        }
+    });
+    for (const name of ['show', 'status']) {
+        command
+            .command(name)
+            .description(`${name === 'show' ? 'Show' : 'Read'} exact landing custody without effects`)
+            .argument('<planId>', 'exact land_ plan identity')
+            .option('--json', 'machine-readable output', false)
+            .action(async (planId, options) => {
+            try {
+                exactPlanId(planId);
+                const service = await serviceFor(program, dependencies);
+                output(await service[name](planId), Boolean(options.json));
+            }
+            catch (error) {
+                output(failure(error), Boolean(options.json));
+                process.exitCode = 1;
+            }
+        });
+    }
+    command
+        .command('advance')
+        .description('Review one neutral docket in a fresh owner terminal, then advance one phase')
+        .argument('<planId>', 'exact land_ plan identity')
+        .requiredOption('--operation <operationId>', 'exact lop_ operation identity')
+        .action(async (planId, options) => {
+        try {
+            exactPlanId(planId);
+            if (!OPERATION_ID.test(options.operation)) {
+                throw new CliBoundaryError('E_LANDING_INPUT_INVALID', 'Landing operation identity is invalid.');
+            }
+            const authority = dependencies.authorityContext?.() ?? {
+                agent: process.env.OPENPLANR_AGENT_CALL === '1' ||
+                    process.env.CODEX_THREAD_ID !== undefined ||
+                    process.env.CLAUDECODE === '1',
+                hook: process.env.OPENPLANR_HOOK === '1' ||
+                    process.env.HUSKY === '1' ||
+                    process.env.GITHUB_ACTIONS === 'true',
+            };
+            const rootOptions = program.opts();
+            const advanceInput = {
+                planId,
+                operationId: options.operation,
+                ownerInteractive: rootOptions.interactive !== false &&
+                    rootOptions.yes !== true &&
+                    Boolean(process.stdin.isTTY && process.stderr.isTTY),
+                yes: rootOptions.yes === true,
+                json: process.argv.includes('--json'),
+                agent: authority.agent,
+                hook: authority.hook,
+            };
+            const service = await serviceFor(program, dependencies);
+            const result = await service.advance(advanceInput);
+            output(result, false);
+        }
+        catch (error) {
+            const result = failure(error);
+            logger.error(`${String(result.code)}: ${String(result.problem)}`);
+            if (typeof result.recovery === 'string')
+                display.line(`  ${result.recovery}`);
+            process.exitCode = 1;
+        }
+    });
+}
+//# sourceMappingURL=land.js.map

package/dist/cli/commands/land.js.map

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

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

@@ -0,0 +1,54 @@
+export type OperateCommandOptions = {
+    json?: boolean;
+    scope?: string;
+    cycle?: string;
+    domain?: string;
+    domainVersion?: string;
+    focus?: string;
+    actor?: string;
+    actorKind?: 'agent' | 'human';
+    runtime?: string;
+    assignment?: string;
+    submission?: string;
+    mediaType?: string;
+    encoding?: 'utf-8' | 'binary';
+    contentBase64?: string;
+    contentFile?: string;
+    framingJson?: string;
+    framingFile?: string;
+    representation?: 'raw' | 'canonical' | 'metadata' | 'decoded-json';
+    owner?: string;
+    route?: 'contained-execution' | 'planning-work' | 'human-external' | 'observe-only';
+    choice?: string;
+    choiceHash?: string;
+    format?: 'json' | 'html';
+    port?: string;
+    watch?: boolean;
+    confirm?: string;
+};
+/**
+ * Typed CLI boundary error. The original failure remains available as `cause`,
+ * while `toJSON` deliberately exposes only the stable code and public problem.
+ */
+export declare class OperateCommandBoundaryError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string, cause?: unknown);
+    toJSON(): {
+        ok: false;
+        code: string;
+        problem: string;
+    };
+}
+export declare function normalizeOperateCommandError(error: unknown, fallback: Readonly<{
+    code: string;
+    message: string;
+}>): OperateCommandBoundaryError;
+/** Read exact bytes from a path or stdin without re-encoding submission content. */
+export declare function readOperateContentInput(source: string): Promise<Buffer>;
+/**
+ * Parse exact Planning framing. File/stdin bytes are decoded with a fatal UTF-8
+ * decoder, and object keys are intentionally left untouched for closed-contract
+ * validation by the Operate service.
+ */
+export declare function readOperateFramingInput(options: OperateCommandOptions): Promise<Record<string, unknown> | undefined>;
+//# sourceMappingURL=input.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/operate/input.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,KAAK,GAAG,WAAW,GAAG,UAAU,GAAG,cAAc,CAAC;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,qBAAqB,GAAG,eAAe,GAAG,gBAAgB,GAAG,cAAc,CAAC;IACpF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAaF;;;GAGG;AACH,qBAAa,2BAA4B,SAAQ,KAAK;IACpD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;IAM1D,MAAM,IAAI;QAAE,EAAE,EAAE,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;CAGvD;AAED,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,QAAQ,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,GACpD,2BAA2B,CA4B7B;AAED,oFAAoF;AACpF,wBAAsB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA0B7E;AASD;;;;GAIG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC,CAkB9C"}

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

@@ -0,0 +1,98 @@
+import { readFile } from 'node:fs/promises';
+import { resolve } from 'node:path';
+const SAFE_ERROR_CODE = /^[A-Z][A-Z0-9_]{1,127}$/u;
+const UNSAFE_SYSTEM_ERROR_CODES = new Set([
+    'EACCES',
+    'EISDIR',
+    'EMFILE',
+    'ENFILE',
+    'ENOENT',
+    'ENOTDIR',
+    'EPERM',
+]);
+/**
+ * Typed CLI boundary error. The original failure remains available as `cause`,
+ * while `toJSON` deliberately exposes only the stable code and public problem.
+ */
+export class OperateCommandBoundaryError extends Error {
+    code;
+    constructor(code, message, cause) {
+        super(message, cause === undefined ? undefined : { cause });
+        this.name = 'E_OPERATE_COMMAND_FAILED';
+        this.code = code;
+    }
+    toJSON() {
+        return { ok: false, code: this.code, problem: this.message };
+    }
+}
+export function normalizeOperateCommandError(error, fallback) {
+    if (error instanceof OperateCommandBoundaryError)
+        return error;
+    const candidate = error !== null && typeof error === 'object'
+        ? error
+        : null;
+    const candidateCode = typeof candidate?.code === 'string' ? candidate.code : '';
+    const systemFailure = typeof candidate?.errno === 'number' ||
+        typeof candidate?.path === 'string' ||
+        typeof candidate?.syscall === 'string';
+    const preserveTypedFailure = !systemFailure &&
+        SAFE_ERROR_CODE.test(candidateCode) &&
+        !UNSAFE_SYSTEM_ERROR_CODES.has(candidateCode);
+    return new OperateCommandBoundaryError(preserveTypedFailure ? candidateCode : fallback.code, preserveTypedFailure && typeof candidate?.message === 'string' && candidate.message.trim()
+        ? candidate.message
+        : fallback.message, error);
+}
+/** Read exact bytes from a path or stdin without re-encoding submission content. */
+export async function readOperateContentInput(source) {
+    if (source !== '-') {
+        try {
+            return await readFile(resolve(source));
+        }
+        catch (error) {
+            const missing = error?.code === 'ENOENT';
+            throw new OperateCommandBoundaryError(missing ? 'E_OPERATE_CONTENT_FILE_NOT_FOUND' : 'E_OPERATE_CONTENT_FILE_UNREADABLE', missing
+                ? 'The Operate content file does not exist.'
+                : 'The Operate content file could not be read.', error);
+        }
+    }
+    try {
+        const chunks = [];
+        for await (const chunk of process.stdin)
+            chunks.push(Buffer.from(chunk));
+        return Buffer.concat(chunks);
+    }
+    catch (error) {
+        throw new OperateCommandBoundaryError('E_OPERATE_CONTENT_STDIN_UNREADABLE', 'Operate content could not be read from standard input.', error);
+    }
+}
+function invalidPlanningInput(message, cause) {
+    return Object.assign(new Error(message), {
+        code: 'E_OPERATE_PLANNING_INVALID',
+        ...(cause === undefined ? {} : { cause }),
+    });
+}
+/**
+ * Parse exact Planning framing. File/stdin bytes are decoded with a fatal UTF-8
+ * decoder, and object keys are intentionally left untouched for closed-contract
+ * validation by the Operate service.
+ */
+export async function readOperateFramingInput(options) {
+    const inline = options.framingJson;
+    const file = options.framingFile;
+    if (inline === undefined && file === undefined)
+        return undefined;
+    let parsed;
+    try {
+        const source = inline ??
+            new TextDecoder('utf-8', { fatal: true }).decode(await readOperateContentInput(file ?? ''));
+        parsed = JSON.parse(source);
+    }
+    catch (error) {
+        throw invalidPlanningInput('Planning framing must be valid UTF-8 JSON.', error);
+    }
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        throw invalidPlanningInput('Planning framing must be a closed JSON object.');
+    }
+    return parsed;
+}
+//# sourceMappingURL=input.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"input.js","sourceRoot":"","sources":["../../../../src/cli/commands/operate/input.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA+BpC,MAAM,eAAe,GAAG,0BAA0B,CAAC;AACnD,MAAM,yBAAyB,GAAG,IAAI,GAAG,CAAC;IACxC,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,OAAO;CACR,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,OAAO,2BAA4B,SAAQ,KAAK;IAC3C,IAAI,CAAS;IAEtB,YAAY,IAAY,EAAE,OAAe,EAAE,KAAe;QACxD,KAAK,CAAC,OAAO,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAC5D,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;QACvC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,MAAM;QACJ,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;IAC/D,CAAC;CACF;AAED,MAAM,UAAU,4BAA4B,CAC1C,KAAc,EACd,QAAqD;IAErD,IAAI,KAAK,YAAY,2BAA2B;QAAE,OAAO,KAAK,CAAC;IAC/D,MAAM,SAAS,GACb,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QACzC,CAAC,CAAE,KAMC;QACJ,CAAC,CAAC,IAAI,CAAC;IACX,MAAM,aAAa,GAAG,OAAO,SAAS,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAChF,MAAM,aAAa,GACjB,OAAO,SAAS,EAAE,KAAK,KAAK,QAAQ;QACpC,OAAO,SAAS,EAAE,IAAI,KAAK,QAAQ;QACnC,OAAO,SAAS,EAAE,OAAO,KAAK,QAAQ,CAAC;IACzC,MAAM,oBAAoB,GACxB,CAAC,aAAa;QACd,eAAe,CAAC,IAAI,CAAC,aAAa,CAAC;QACnC,CAAC,yBAAyB,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAChD,OAAO,IAAI,2BAA2B,CACpC,oBAAoB,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,EACpD,oBAAoB,IAAI,OAAO,SAAS,EAAE,OAAO,KAAK,QAAQ,IAAI,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE;QACxF,CAAC,CAAC,SAAS,CAAC,OAAO;QACnB,CAAC,CAAC,QAAQ,CAAC,OAAO,EACpB,KAAK,CACN,CAAC;AACJ,CAAC;AAED,oFAAoF;AACpF,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,MAAc;IAC1D,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;QACnB,IAAI,CAAC;YACH,OAAO,MAAM,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;QACzC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAI,KAAsC,EAAE,IAAI,KAAK,QAAQ,CAAC;YAC3E,MAAM,IAAI,2BAA2B,CACnC,OAAO,CAAC,CAAC,CAAC,kCAAkC,CAAC,CAAC,CAAC,mCAAmC,EAClF,OAAO;gBACL,CAAC,CAAC,0CAA0C;gBAC5C,CAAC,CAAC,6CAA6C,EACjD,KAAK,CACN,CAAC;QACJ,CAAC;IACH,CAAC;IACD,IAAI,CAAC;QACH,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,OAAO,CAAC,KAAK;YAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QACzE,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,2BAA2B,CACnC,oCAAoC,EACpC,wDAAwD,EACxD,KAAK,CACN,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,oBAAoB,CAAC,OAAe,EAAE,KAAe;IAC5D,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,EAAE;QACvC,IAAI,EAAE,4BAA4B;QAClC,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;KAC1C,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,OAA8B;IAE9B,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IACnC,MAAM,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC;IACjC,IAAI,MAAM,KAAK,SAAS,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAEjE,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,MAAM,GACV,MAAM;YACN,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,uBAAuB,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;QAC9F,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,oBAAoB,CAAC,4CAA4C,EAAE,KAAK,CAAC,CAAC;IAClF,CAAC;IACD,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACnE,MAAM,oBAAoB,CAAC,gDAAgD,CAAC,CAAC;IAC/E,CAAC;IACD,OAAO,MAAiC,CAAC;AAC3C,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"assignments.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/operate/registrars/assignments.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOzC,OAAO,KAAK,EAAE,sCAAsC,EAAE,MAAM,gBAAgB,CAAC;AAG7E,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,sCAAsC,GACnD,IAAI,CAmHN;AAED,wBAAgB,oCAAoC,CAClD,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,sCAAsC,GACnD,IAAI,CAyDN"}