openplanr 1.25.3 → 2.0.1

package/dist/services/landing/landing-service.js

@@ -0,0 +1,197 @@
+import path from 'node:path';
+import { LandingOperationRegistryV1, } from './operation-registry.js';
+import { LandingReceiptCustodyV1, } from './receipt-custody.js';
+export class LandingServiceError extends Error {
+    code;
+    recovery;
+    constructor(code, message, recovery) {
+        super(message);
+        this.name = 'LandingServiceError';
+        this.code = code;
+        this.recovery = recovery;
+    }
+}
+function landingFunction(api, name) {
+    const value = api[name];
+    if (typeof value !== 'function') {
+        throw new LandingServiceError('E_LANDING_HOST_NOT_CONFIGURED', 'The verified landing package API is unavailable.');
+    }
+    return value;
+}
+function record(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new LandingServiceError('E_LANDING_INPUT_INVALID', 'Landing input is invalid.');
+    }
+    return value;
+}
+function operationFor(plan, operationId) {
+    const operations = plan.operations;
+    if (!Array.isArray(operations)) {
+        throw new LandingServiceError('E_LANDING_BINDING_MISMATCH', 'Landing plan is invalid.');
+    }
+    const matches = operations.filter((value) => value !== null &&
+        typeof value === 'object' &&
+        !Array.isArray(value) &&
+        value.operationId === operationId);
+    if (matches.length !== 1) {
+        throw new LandingServiceError('E_LANDING_BINDING_MISMATCH', 'Landing operation does not belong to the exact plan.');
+    }
+    return matches[0];
+}
+function registryOperationId(operation) {
+    const value = operation.registryOperationId;
+    if (typeof value !== 'string') {
+        throw new LandingServiceError('E_LANDING_BINDING_MISMATCH', 'Landing operation registry binding is invalid.');
+    }
+    return value;
+}
+function dates(input) {
+    const createdAt = input.createdAt ?? new Date().toISOString();
+    const expiresAt = input.expiresAt ?? new Date(Date.parse(createdAt) + 60 * 60 * 1_000).toISOString();
+    if (!Number.isFinite(Date.parse(createdAt)) ||
+        !Number.isFinite(Date.parse(expiresAt)) ||
+        Date.parse(expiresAt) <= Date.parse(createdAt)) {
+        throw new LandingServiceError('E_LANDING_INPUT_INVALID', 'Landing plan time is invalid.');
+    }
+    return { createdAt, expiresAt };
+}
+export class LandingServiceV1 {
+    #projectDir;
+    #handoff;
+    #custody;
+    #operations;
+    constructor(input) {
+        this.#projectDir = path.resolve(input.projectDir);
+        this.#handoff = input.handoff;
+        this.#custody =
+            input.custody ??
+                new LandingReceiptCustodyV1({ root: path.join(this.#projectDir, '.planr', 'landing') });
+        this.#operations = new LandingOperationRegistryV1({
+            operationRegistry: input.handoff.registryValues.operationRegistry,
+            adapters: input.adapters,
+        });
+    }
+    async #inspection(feature, receiptHash) {
+        const inspect = landingFunction(this.#handoff.landingApi, 'inspectShipClosureForLanding');
+        return inspect({ projectRoot: this.#projectDir, feature, receiptHash });
+    }
+    async #bound(snapshot) {
+        const bind = landingFunction(this.#handoff.landingApi, 'bindLandingPlan');
+        return bind({
+            plan: snapshot.plan,
+            closureInspection: await this.#inspection(snapshot.feature, snapshot.receiptHash),
+            operationRegistry: this.#handoff.registryValues.operationRegistry,
+            baseRecords: snapshot.baseRecords,
+        });
+    }
+    async prepare(input) {
+        if (!input ||
+            typeof input.feature !== 'string' ||
+            !input.feature.trim() ||
+            !/^sha256:[a-f0-9]{64}$/u.test(input.receiptHash) ||
+            !Array.isArray(input.operations) ||
+            input.operations.length === 0 ||
+            !Array.isArray(input.preconditions ?? []) ||
+            !Array.isArray(input.baseRecords ?? [])) {
+            throw new LandingServiceError('E_LANDING_INPUT_INVALID', 'Landing preparation is invalid.');
+        }
+        const first = record(input.operations[0]);
+        const operationAdapterId = registryOperationId(first);
+        const target = await this.#operations.inspect(operationAdapterId, {
+            kind: 'landing-target-inspection',
+            schemaVersion: '1.0.0',
+            authority: 'none',
+            projectRoot: this.#projectDir,
+            operation: first,
+        });
+        if (first.targetBeforeHash !== target.targetStateHash) {
+            throw new LandingServiceError('E_LANDING_BINDING_MISMATCH', 'Landing target changed before plan preparation.');
+        }
+        const prepare = landingFunction(this.#handoff.landingApi, 'prepareLanding');
+        const closureInspection = await this.#inspection(input.feature, input.receiptHash);
+        const time = dates(input);
+        const plan = prepare({
+            closureInspection,
+            currentTargetHash: target.targetStateHash,
+            operations: input.operations,
+            preconditions: input.preconditions ?? [],
+            baseRecords: input.baseRecords ?? [],
+            operationRegistry: this.#handoff.registryValues.operationRegistry,
+            ...time,
+        });
+        const snapshot = await this.#custody.initialize({
+            feature: input.feature,
+            receiptHash: input.receiptHash,
+            plan,
+            baseRecords: input.baseRecords ?? [],
+        });
+        const status = await this.status(String(plan.planId));
+        return Object.freeze({
+            ok: true,
+            operation: 'landing.prepare',
+            authority: 'none',
+            effects: [],
+            ownerActionRequired: true,
+            plan: structuredClone(snapshot.plan),
+            status,
+        });
+    }
+    async show(planId) {
+        const snapshot = await this.#custody.read(planId);
+        const show = landingFunction(this.#handoff.landingApi, 'showLanding');
+        return show({ plan: await this.#bound(snapshot), events: snapshot.events });
+    }
+    async status(planId) {
+        const snapshot = await this.#custody.read(planId);
+        const status = landingFunction(this.#handoff.landingApi, 'landingStatus');
+        return status({ plan: await this.#bound(snapshot), events: snapshot.events });
+    }
+    async advance(input) {
+        if (input.json || input.yes || input.agent || input.hook) {
+            throw new LandingServiceError('E_LANDING_MACHINE_AUTHORITY_FORBIDDEN', 'Landing effects cannot be authorized by JSON, --yes, an agent, or a hook.', 'Run the exact command in a fresh owner-controlled terminal without automation flags.');
+        }
+        if (!input.ownerInteractive || !process.stdin.isTTY || !process.stderr.isTTY) {
+            throw new LandingServiceError('E_LANDING_OWNER_INTERACTIVE_REQUIRED', 'Landing advance requires a fresh owner-controlled OS terminal.', 'Open an owner-controlled terminal and review the neutral docket.');
+        }
+        const snapshot = await this.#custody.read(input.planId);
+        const plan = await this.#bound(snapshot);
+        const operation = operationFor(plan, input.operationId);
+        const adapterId = registryOperationId(operation);
+        const callbacks = {
+            snapshot: async () => {
+                const stored = await this.#custody.read(input.planId);
+                const currentTarget = await this.#operations.inspect(adapterId, {
+                    kind: 'landing-target-inspection',
+                    schemaVersion: '1.0.0',
+                    authority: 'none',
+                    projectRoot: this.#projectDir,
+                    operation,
+                });
+                return Object.freeze({
+                    candidateDigest: stored.candidateDigest,
+                    repositoryHeads: stored.repositoryHeads,
+                    targetStateHash: currentTarget.targetStateHash,
+                    events: stored.events,
+                    journalHead: stored.journalHead,
+                    landingReceipt: stored.landingReceipt,
+                    pendingIntent: stored.pendingIntent,
+                    phaseReceiptHeadHash: stored.phaseReceiptHeadHash,
+                    phaseReceipts: stored.phaseReceipts,
+                    confirmations: stored.confirmations,
+                    evidenceRecordsByOperation: stored.evidenceRecordsByOperation,
+                    evidenceContextsByOperation: stored.evidenceContextsByOperation,
+                    startedAt: stored.startedAt,
+                });
+            },
+            commitIntent: (request) => this.#custody.commitIntent(input.planId, request),
+            dispatch: (request) => this.#operations.dispatch(adapterId, request),
+            reconcile: (request) => this.#operations.reconcile(adapterId, request),
+            commitOutcome: (request) => this.#custody.commitOutcome(input.planId, request),
+        };
+        const createHost = landingFunction(this.#handoff.landingApi, 'createLandingOwnerRuntimeHost');
+        const advance = landingFunction(this.#handoff.landingApi, 'advanceLanding');
+        const host = createHost(callbacks);
+        return advance({ host, plan, operationId: input.operationId, now: input.now });
+    }
+}
+//# sourceMappingURL=landing-service.js.map

package/dist/services/landing/landing-service.js.map

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

package/dist/services/landing/operation-registry.d.ts

@@ -0,0 +1,56 @@
+export type LandingOperationRegistryErrorCode = 'E_LANDING_OPERATION_REGISTRY_INVALID' | 'E_LANDING_OPERATION_ADAPTER_MISSING' | 'E_LANDING_OPERATION_ADAPTER_MISMATCH' | 'E_LANDING_OPERATION_TARGET_MISMATCH' | 'E_LANDING_OPERATION_OUTPUT_UNSAFE' | 'E_LANDING_OPERATION_TIMEOUT' | 'E_LANDING_OPERATION_FAILED';
+export declare class LandingOperationRegistryError extends Error {
+    readonly code: LandingOperationRegistryErrorCode;
+    constructor(code: LandingOperationRegistryErrorCode, message: string);
+}
+export type LandingOperationRegistrationV1 = Readonly<{
+    operationId: string;
+    operationVersion: string;
+    kind: string;
+    effectClass: string;
+    recoveryClass: string;
+    runtimeAdapterRequired: true;
+    portableAuthority: 'none';
+    registrationHash: `sha256:${string}`;
+}>;
+export type LandingOperationInspectionV1 = Readonly<{
+    targetStateHash: `sha256:${string}`;
+}>;
+export type LandingOperationDispatchResultV1 = Readonly<{
+    status: 'succeeded' | 'failed' | 'blocked' | 'uncertain' | 'recovery_required';
+    targetAfterHash: `sha256:${string}` | null;
+    completedAt: string;
+    evidenceRecords: readonly Readonly<Record<string, unknown>>[];
+    evidenceContexts: Readonly<Record<string, unknown>>;
+    canary: Readonly<Record<string, unknown>> | null;
+    containment: Readonly<Record<string, unknown>> | null;
+    recovery: Readonly<Record<string, unknown>> | null;
+}>;
+export type LandingOperationReconciliationV1 = LandingOperationDispatchResultV1 | Readonly<{
+    disposition: 'not-started' | 'unknown';
+    targetAfterHash: null;
+    completedAt: string;
+}>;
+export interface LandingOperationAdapterV1 {
+    readonly adapterId: string;
+    readonly operationId: string;
+    readonly operationVersion: string;
+    readonly registrationHash: `sha256:${string}`;
+    inspectTarget(request: Readonly<Record<string, unknown>>): Promise<LandingOperationInspectionV1>;
+    dispatch(request: Readonly<Record<string, unknown>>): Promise<LandingOperationDispatchResultV1>;
+    reconcile(request: Readonly<Record<string, unknown>>): Promise<LandingOperationReconciliationV1>;
+}
+export declare class LandingOperationRegistryV1 {
+    #private;
+    constructor(input: {
+        operationRegistry: Readonly<Record<string, unknown>>;
+        adapters?: readonly LandingOperationAdapterV1[];
+    });
+    list(): readonly LandingOperationRegistrationV1[];
+    registration(operationId: string): LandingOperationRegistrationV1;
+    adapter(operationId: string): LandingOperationAdapterV1;
+    inspect(operationId: string, request: Readonly<Record<string, unknown>>): Promise<LandingOperationInspectionV1>;
+    dispatch(operationId: string, request: Readonly<Record<string, unknown>>): Promise<LandingOperationDispatchResultV1>;
+    reconcile(operationId: string, request: Readonly<Record<string, unknown>>): Promise<LandingOperationReconciliationV1>;
+}
+//# sourceMappingURL=operation-registry.d.ts.map

package/dist/services/landing/operation-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-registry.d.ts","sourceRoot":"","sources":["../../../src/services/landing/operation-registry.ts"],"names":[],"mappings":"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"}

package/dist/services/landing/operation-registry.js

@@ -0,0 +1,165 @@
+export class LandingOperationRegistryError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = 'LandingOperationRegistryError';
+        this.code = code;
+    }
+}
+const HASH = /^sha256:[a-f0-9]{64}$/u;
+const ID = /^[a-z][a-z0-9-]{0,63}$/u;
+const PRIVATE_VALUE = /(?:^|[\s"'`(])\/(?:Users|home|private|var|etc|tmp)\/|(?:^|[\s"'`(])[A-Za-z]:[\\/][^\s]+|-----BEGIN [A-Z ]*PRIVATE KEY-----|\b(?:api[-_ ]?key|access[-_ ]?token|client[-_ ]?secret|password|passwd|secret|token)\s*[:=]\s*[^\s]+/iu;
+const SENSITIVE_KEY = /(?:authorization|cookie|password|passwd|secret|token|api[-_]?key|credential|private[-_]?key)/iu;
+function fail(code, message) {
+    throw new LandingOperationRegistryError(code, message);
+}
+function record(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        fail('E_LANDING_OPERATION_REGISTRY_INVALID', 'Landing operation registry is invalid.');
+    }
+    return value;
+}
+function portable(value, key = '', seen = new Set()) {
+    if (SENSITIVE_KEY.test(key)) {
+        fail('E_LANDING_OPERATION_OUTPUT_UNSAFE', 'Landing adapter output is not portable.');
+    }
+    if (typeof value === 'string') {
+        if (PRIVATE_VALUE.test(value)) {
+            fail('E_LANDING_OPERATION_OUTPUT_UNSAFE', 'Landing adapter output is not portable.');
+        }
+        return;
+    }
+    if (!value || typeof value !== 'object')
+        return;
+    if (seen.has(value)) {
+        fail('E_LANDING_OPERATION_OUTPUT_UNSAFE', 'Landing adapter output contains a cycle.');
+    }
+    seen.add(value);
+    try {
+        if (Array.isArray(value)) {
+            for (const nested of value)
+                portable(nested, key, seen);
+        }
+        else {
+            for (const [nestedKey, nested] of Object.entries(value))
+                portable(nested, nestedKey, seen);
+        }
+    }
+    finally {
+        seen.delete(value);
+    }
+}
+function inspection(value) {
+    const input = record(value);
+    if (Object.keys(input).length !== 1 ||
+        typeof input.targetStateHash !== 'string' ||
+        !HASH.test(input.targetStateHash)) {
+        fail('E_LANDING_OPERATION_TARGET_MISMATCH', 'Landing target inspection is invalid.');
+    }
+    return Object.freeze({ targetStateHash: input.targetStateHash });
+}
+function dispatchResult(value) {
+    const input = record(value);
+    const expected = [
+        'canary',
+        'completedAt',
+        'containment',
+        'evidenceContexts',
+        'evidenceRecords',
+        'recovery',
+        'status',
+        'targetAfterHash',
+    ];
+    if (JSON.stringify(Object.keys(input).sort()) !== JSON.stringify(expected) ||
+        !['succeeded', 'failed', 'blocked', 'uncertain', 'recovery_required'].includes(String(input.status)) ||
+        (input.targetAfterHash !== null &&
+            (typeof input.targetAfterHash !== 'string' || !HASH.test(input.targetAfterHash))) ||
+        typeof input.completedAt !== 'string' ||
+        !Number.isFinite(Date.parse(input.completedAt)) ||
+        !Array.isArray(input.evidenceRecords) ||
+        !input.evidenceContexts ||
+        typeof input.evidenceContexts !== 'object' ||
+        Array.isArray(input.evidenceContexts)) {
+        fail('E_LANDING_OPERATION_FAILED', 'Landing adapter result is invalid.');
+    }
+    portable(input);
+    return structuredClone(input);
+}
+function reconciliation(value) {
+    const input = record(value);
+    if ('disposition' in input) {
+        if (!['not-started', 'unknown'].includes(String(input.disposition)) ||
+            input.targetAfterHash !== null ||
+            typeof input.completedAt !== 'string' ||
+            !Number.isFinite(Date.parse(input.completedAt)) ||
+            JSON.stringify(Object.keys(input).sort()) !==
+                JSON.stringify(['completedAt', 'disposition', 'targetAfterHash'])) {
+            fail('E_LANDING_OPERATION_FAILED', 'Landing reconciliation is invalid.');
+        }
+        return Object.freeze(structuredClone(input));
+    }
+    return dispatchResult(input);
+}
+export class LandingOperationRegistryV1 {
+    #registrations;
+    #adapters;
+    constructor(input) {
+        const source = record(input.operationRegistry);
+        if (!Array.isArray(source.operations)) {
+            fail('E_LANDING_OPERATION_REGISTRY_INVALID', 'Landing operation membership is invalid.');
+        }
+        const registrations = new Map();
+        for (const value of source.operations) {
+            const row = record(value);
+            if (!ID.test(row.operationId) ||
+                row.operationVersion !== '1.0.0' ||
+                row.runtimeAdapterRequired !== true ||
+                row.portableAuthority !== 'none' ||
+                !HASH.test(row.registrationHash) ||
+                registrations.has(row.operationId)) {
+                fail('E_LANDING_OPERATION_REGISTRY_INVALID', 'Landing operation row is invalid.');
+            }
+            registrations.set(row.operationId, Object.freeze(structuredClone(row)));
+        }
+        const adapters = new Map();
+        for (const adapter of input.adapters ?? []) {
+            const registration = registrations.get(adapter.operationId);
+            if (!registration ||
+                !ID.test(adapter.adapterId) ||
+                adapter.operationVersion !== registration.operationVersion ||
+                adapter.registrationHash !== registration.registrationHash ||
+                adapters.has(adapter.operationId)) {
+                fail('E_LANDING_OPERATION_ADAPTER_MISMATCH', 'Landing adapter is not registry-bound.');
+            }
+            adapters.set(adapter.operationId, adapter);
+        }
+        this.#registrations = registrations;
+        this.#adapters = adapters;
+    }
+    list() {
+        return Object.freeze([...this.#registrations.values()].map((value) => structuredClone(value)));
+    }
+    registration(operationId) {
+        const value = this.#registrations.get(operationId);
+        if (!value)
+            fail('E_LANDING_OPERATION_REGISTRY_INVALID', 'Landing operation is unknown.');
+        return Object.freeze(structuredClone(value));
+    }
+    adapter(operationId) {
+        const value = this.#adapters.get(operationId);
+        if (!value) {
+            fail('E_LANDING_OPERATION_ADAPTER_MISSING', 'No trusted local landing adapter is configured.');
+        }
+        return value;
+    }
+    async inspect(operationId, request) {
+        return inspection(await this.adapter(operationId).inspectTarget(request));
+    }
+    async dispatch(operationId, request) {
+        return dispatchResult(await this.adapter(operationId).dispatch(request));
+    }
+    async reconcile(operationId, request) {
+        return reconciliation(await this.adapter(operationId).reconcile(request));
+    }
+}
+//# sourceMappingURL=operation-registry.js.map

package/dist/services/landing/operation-registry.js.map

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

package/dist/services/landing/receipt-custody.d.ts

@@ -0,0 +1,48 @@
+export type LandingReceiptCustodyErrorCode = 'E_LANDING_CUSTODY_INVALID' | 'E_LANDING_CUSTODY_UNSAFE' | 'E_LANDING_CUSTODY_NOT_FOUND' | 'E_LANDING_CUSTODY_CONFLICT' | 'E_LANDING_CUSTODY_LOCKED';
+export declare class LandingReceiptCustodyError extends Error {
+    readonly code: LandingReceiptCustodyErrorCode;
+    constructor(code: LandingReceiptCustodyErrorCode, message: string);
+}
+export type LandingReceiptCustodySnapshotV1 = Readonly<{
+    feature: string;
+    receiptHash: `sha256:${string}`;
+    plan: Readonly<Record<string, unknown>>;
+    baseRecords: readonly Readonly<Record<string, unknown>>[];
+    candidateDigest: `sha256:${string}`;
+    repositoryHeads: readonly Readonly<{
+        repositoryKey: string;
+        head: string;
+    }>[];
+    targetStateHash: `sha256:${string}`;
+    events: readonly Readonly<Record<string, unknown>>[];
+    journalHead: Readonly<{
+        sequence: number;
+        hash: `sha256:${string}` | null;
+    }>;
+    landingReceipt: Readonly<Record<string, unknown>> | null;
+    pendingIntent: Readonly<Record<string, unknown>> | null;
+    phaseReceiptHeadHash: `sha256:${string}` | null;
+    phaseReceipts: readonly Readonly<Record<string, unknown>>[];
+    confirmations: readonly Readonly<Record<string, unknown>>[];
+    evidenceRecordsByOperation: Readonly<Record<string, unknown>>;
+    evidenceContextsByOperation: Readonly<Record<string, unknown>>;
+    startedAt: string | null;
+}>;
+export declare class LandingReceiptCustodyV1 {
+    #private;
+    constructor(input: {
+        root: string;
+        now?: () => number;
+        lockTtlMs?: number;
+    });
+    initialize(input: {
+        feature: string;
+        receiptHash: `sha256:${string}`;
+        plan: Readonly<Record<string, unknown>>;
+        baseRecords: readonly Readonly<Record<string, unknown>>[];
+    }): Promise<LandingReceiptCustodySnapshotV1>;
+    read(planId: string): Promise<LandingReceiptCustodySnapshotV1>;
+    commitIntent(planId: string, request: Readonly<Record<string, unknown>>): Promise<Readonly<Record<string, unknown>>>;
+    commitOutcome(planId: string, request: Readonly<Record<string, unknown>>): Promise<Readonly<Record<string, unknown>>>;
+}
+//# sourceMappingURL=receipt-custody.d.ts.map

package/dist/services/landing/receipt-custody.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"receipt-custody.d.ts","sourceRoot":"","sources":["../../../src/services/landing/receipt-custody.ts"],"names":[],"mappings":"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"}