openplanr 1.25.3 → 2.0.1

package/dist/services/operate/spec-operating-origin-service.js

@@ -0,0 +1,401 @@
+import { createHash } from 'node:crypto';
+import { constants } from 'node:fs';
+import { lstat, mkdir, open, readdir, readFile, realpath, rename, rm, writeFile, } from 'node:fs/promises';
+import path from 'node:path';
+import { assertOperatingOriginV1, assertOperatingPlanningProposalV1, createOperatingOriginV1, } from 'planr-pipeline/operate/planning-bridge-v2';
+import { sha256Jcs, validateProtocolArtifact } from 'planr-pipeline/protocol';
+import { parseMarkdown } from '../../utils/markdown.js';
+import { appendOpenPlanrProvenance, readOpenPlanrVersion, } from '../provenance-service.js';
+import { getSpecDesignDir, getSpecStoriesDir, getSpecsRootDir, getSpecTasksDir, prepareOperatingSpecDraft, } from '../spec-service.js';
+const ORIGIN_FILE = 'operating-origin.json';
+const LOCK_FILE = '.operate-planning.lock';
+const LOCK_WAIT_ATTEMPTS = 250;
+const LOCK_WAIT_MS = 20;
+function fail(code, message) {
+    throw Object.assign(new Error(message), { code });
+}
+function hashText(value) {
+    return `sha256:${createHash('sha256').update(value, 'utf8').digest('hex')}`;
+}
+function stableId(prefix, value) {
+    return `${prefix}_${sha256Jcs(value).slice('sha256:'.length, 'sha256:'.length + 32)}`;
+}
+function sameJson(left, right) {
+    return sha256Jcs(left) === sha256Jcs(right);
+}
+function contained(parent, candidate) {
+    const relative = path.relative(path.resolve(parent), path.resolve(candidate));
+    return relative.length > 0 && !relative.startsWith('..') && !path.isAbsolute(relative);
+}
+async function acquireLock(specsRoot) {
+    await mkdir(specsRoot, { recursive: true });
+    const lockPath = path.join(specsRoot, LOCK_FILE);
+    for (let attempt = 0; attempt < LOCK_WAIT_ATTEMPTS; attempt += 1) {
+        try {
+            const handle = await open(lockPath, constants.O_CREAT | constants.O_EXCL | constants.O_WRONLY, 0o600);
+            await handle.writeFile(JSON.stringify({ pid: process.pid, createdAt: new Date().toISOString() }));
+            await handle.sync();
+            await handle.close();
+            return async () => await rm(lockPath, { force: true });
+        }
+        catch (cause) {
+            if (cause.code !== 'EEXIST')
+                throw cause;
+            await new Promise((resolve) => setTimeout(resolve, LOCK_WAIT_MS));
+        }
+    }
+    fail('E_OPERATE_PLANNING_CONCURRENT', 'Another Planning promotion still owns the project-local transaction lock.');
+}
+async function publishedOrigins(specsRoot) {
+    const entries = await readdir(specsRoot, { withFileTypes: true });
+    const results = [];
+    for (const entry of entries) {
+        if (!entry.isDirectory() || !/^(?:SPEC|FEAT)-\d{3}-[a-z0-9-]+$/u.test(entry.name))
+            continue;
+        const specDir = path.join(specsRoot, entry.name);
+        try {
+            const origin = await readSpecOperatingOrigin(specDir);
+            results.push({ origin, specDir });
+        }
+        catch (cause) {
+            if (cause.code === 'ENOENT')
+                continue;
+            fail('E_OPERATE_ORIGIN_INVALID', 'A published operating-origin sidecar is invalid and requires explicit recovery.');
+        }
+    }
+    return results;
+}
+async function appendCorrelatedProvenance(input) {
+    await appendOpenPlanrProvenance({
+        projectDir: input.projectDir,
+        artifactId: input.specId,
+        artifactPath: input.specFile,
+        operation: 'created',
+        productVersion: readOpenPlanrVersion(),
+        runtime: 'openplanr',
+        phase: 'planning',
+        runId: input.transactionId,
+        eventId: input.eventId,
+        timestamp: input.timestamp,
+        correlation: {
+            correlation_id: input.correlationId,
+            proposal_id: input.proposalId,
+            proposal_hash: input.proposalHash,
+            transaction_id: input.transactionId,
+            receipt_hash: input.receiptHash,
+        },
+    }, input.hooks);
+}
+function receiptFromOrigin(origin, specDir, replayed) {
+    const spec = origin.spec;
+    const transaction = origin.transaction;
+    const specId = String(spec.specId);
+    const slug = String(spec.slug);
+    return {
+        transactionId: String(transaction.transactionId),
+        receiptHash: String(transaction.receiptHash),
+        correlationId: String(origin.correlationId),
+        proposalId: String(origin.proposalId),
+        proposalHash: String(origin.proposalHash),
+        specId,
+        slug,
+        specDir,
+        specFile: path.join(specDir, `${specId}-${slug}.md`),
+        contentHash: String(spec.contentHash),
+        originPath: path.join(specDir, ORIGIN_FILE),
+        originHash: String(origin.originHash),
+        provenanceEventId: String(transaction.planningProvenanceEventId),
+        replayed,
+    };
+}
+async function reconcilePublished(projectDir, proposal, match) {
+    const origin = match.origin;
+    if (origin.proposalHash !== proposal.proposalHash ||
+        origin.proposalRevision !== proposal.revision ||
+        origin.correlationId !== proposal.correlationId) {
+        fail('E_OPERATE_PLANNING_CONFLICT', 'The proposal identity is already bound to different published custody.');
+    }
+    const receipt = receiptFromOrigin(origin, match.specDir, true);
+    const content = await readFile(receipt.specFile, 'utf8').catch(() => fail('E_OPERATE_ORIGIN_INVALID', 'The published SPEC referenced by operating origin is missing.'));
+    if (hashText(content) !== receipt.contentHash) {
+        fail('E_OPERATE_ORIGIN_INVALID', 'The published SPEC content no longer matches its operating origin.');
+    }
+    await appendCorrelatedProvenance({
+        projectDir,
+        specId: receipt.specId,
+        specFile: receipt.specFile,
+        proposalId: receipt.proposalId,
+        proposalHash: receipt.proposalHash,
+        correlationId: receipt.correlationId,
+        transactionId: receipt.transactionId,
+        receiptHash: receipt.receiptHash,
+        eventId: receipt.provenanceEventId,
+        timestamp: String(origin.createdAt),
+    });
+    return receipt;
+}
+/**
+ * Promote one confirmed planning proposal into a SPEC, closed origin sidecar,
+ * and separately appended provenance record. Directory rename is the SPEC +
+ * origin commit point; a missing provenance append is reconciled on exact retry.
+ */
+export async function createSpecFromOperatingProposal(input) {
+    assertOperatingPlanningProposalV1(input.proposal);
+    if (input.proposal.state !== 'approved' ||
+        input.actor.actorId !== input.proposal.confirmation?.actorId ||
+        input.actor.kind !== 'human') {
+        fail('E_OPERATE_PLANNING_CONFIRMATION', 'Only the exact confirmed human proposal may create a SPEC.');
+    }
+    const specsRoot = getSpecsRootDir(input.projectDir, input.config);
+    const release = await acquireLock(specsRoot);
+    let staging = null;
+    try {
+        const matches = (await publishedOrigins(specsRoot)).filter(({ origin }) => origin.proposalId === input.proposal.proposalId);
+        if (matches.length > 1)
+            fail('E_OPERATE_PLANNING_CONFLICT', 'Duplicate published custody exists for this proposal.');
+        if (matches.length === 1)
+            return await reconcilePublished(input.projectDir, input.proposal, matches[0]);
+        const framing = input.proposal.framing;
+        const decision = input.proposal.decision;
+        const action = input.proposal.action;
+        const verification = input.proposal.verification;
+        const draft = await prepareOperatingSpecDraft(input.projectDir, input.config, {
+            title: String(framing.title),
+            slug: String(framing.slug),
+            actorId: input.actor.actorId,
+            framing: {
+                problem: String(framing.problem),
+                objective: String(framing.objective),
+                users: framing.users,
+                scope: framing.scope,
+                nonScope: framing.nonScope,
+                risks: framing.risks,
+                constraints: framing.constraints,
+                requirements: framing.requirements,
+                acceptanceOutcomes: framing.acceptanceOutcomes,
+            },
+            operatingOrigin: {
+                correlationId: String(input.proposal.correlationId),
+                proposalId: String(input.proposal.proposalId),
+                cycleId: String(input.proposal.cycleId),
+                decision: {
+                    decisionId: String(decision.decisionId),
+                    revision: Number(decision.revision),
+                    title: String(decision.title),
+                    outcome: String(decision.outcome),
+                    rationale: String(decision.rationale),
+                },
+                action: {
+                    actionId: String(action.actionId),
+                    revision: Number(action.revision),
+                    expectedResult: String(action.expectedResult),
+                },
+                perspectives: input.proposal.acceptedPerspectiveSummaries.map((perspective) => ({
+                    roleId: String(perspective.roleId),
+                    roleKind: perspective.roleKind,
+                    stance: String(perspective.stance),
+                    summary: String(perspective.summary),
+                    constraints: perspective.constraints,
+                    uncertainties: perspective.uncertainties,
+                })),
+                evidence: input.proposal.evidence.map((entry) => ({
+                    evidenceRefId: String(entry.evidenceRefId),
+                    relation: String(entry.relation),
+                    freshness: String(entry.freshness),
+                    confidence: Number(entry.confidence),
+                    accessState: String(entry.accessState),
+                    summary: entry.summary === null ? null : String(entry.summary),
+                    limitations: entry.limitations,
+                })),
+                omissions: input.proposal.omissions.map((entry) => ({
+                    count: Number(entry.count),
+                    reason: String(entry.reason),
+                })),
+                verification: {
+                    metricId: String(verification.metricId),
+                    baseline: Number(verification.baseline),
+                    target: Number(verification.target),
+                    window: String(verification.window),
+                    method: String(verification.method),
+                },
+            },
+            createdAt: String(input.proposal.confirmation.confirmedAt),
+        });
+        if (!contained(specsRoot, draft.specDir) || !contained(draft.specDir, draft.specFile)) {
+            fail('E_OPERATE_PLANNING_PATH', 'The planned SPEC path escapes the configured planning root.');
+        }
+        let stagedFrontmatter;
+        try {
+            stagedFrontmatter = parseMarkdown(draft.content).data;
+        }
+        catch {
+            fail('E_OPERATE_PLANNING_INVALID', 'The staged SPEC frontmatter is not canonical YAML.');
+        }
+        const expectedFrontmatter = {
+            id: draft.id,
+            title: String(framing.title),
+            slug: draft.slug,
+            schemaVersion: '1.7.0',
+            status: 'shaping',
+            priority: 'P1',
+            po: input.actor.actorId,
+            created: String(input.proposal.confirmation.confirmedAt).slice(0, 10),
+            updated: String(input.proposal.confirmation.confirmedAt).slice(0, 10),
+            ui_files: [],
+            tech_dependencies: [],
+        };
+        if (validateProtocolArtifact('spec', stagedFrontmatter, { protocolVersion: '1.7.0' }).length >
+            0 ||
+            !sameJson(stagedFrontmatter, expectedFrontmatter)) {
+            fail('E_OPERATE_PLANNING_INVALID', 'The staged SPEC frontmatter differs from its exact closed Planning draft.');
+        }
+        const contentHash = hashText(draft.content);
+        const transactionId = stableId('txn', {
+            proposalId: input.proposal.proposalId,
+            proposalHash: input.proposal.proposalHash,
+            specId: draft.id,
+            slug: draft.slug,
+            contentHash,
+        });
+        const provenanceEventId = stableId('prv', { transactionId, artifactId: draft.id });
+        const receiptHash = sha256Jcs({
+            transactionId,
+            correlationId: String(input.proposal.correlationId),
+            proposalId: String(input.proposal.proposalId),
+            proposalHash: String(input.proposal.proposalHash),
+            specId: draft.id,
+            slug: draft.slug,
+            contentHash,
+            provenanceEventId,
+        });
+        const createdAt = String(input.proposal.confirmation.confirmedAt);
+        const origin = createOperatingOriginV1({
+            proposal: input.proposal,
+            spec: { specId: draft.id, slug: draft.slug, contentHash, status: 'shaping' },
+            actor: input.actor,
+            transaction: { transactionId, receiptHash, planningProvenanceEventId: provenanceEventId },
+            createdAt,
+        });
+        staging = path.join(specsRoot, `.operate-planning-txn-${transactionId.slice(4)}`);
+        await mkdir(staging, { recursive: false, mode: 0o700 });
+        const stagedSpecFile = path.join(staging, path.basename(draft.specFile));
+        await mkdir(getSpecStoriesDir(staging), { recursive: true });
+        await mkdir(getSpecTasksDir(staging), { recursive: true });
+        await mkdir(getSpecDesignDir(staging), { recursive: true });
+        await writeFile(stagedSpecFile, draft.content, { encoding: 'utf8', flag: 'wx', mode: 0o600 });
+        await writeFile(path.join(getSpecDesignDir(staging), '.gitkeep'), '', {
+            flag: 'wx',
+            mode: 0o600,
+        });
+        await writeFile(path.join(staging, ORIGIN_FILE), `${JSON.stringify(origin, null, 2)}\n`, {
+            encoding: 'utf8',
+            flag: 'wx',
+            mode: 0o600,
+        });
+        const specHandle = await open(stagedSpecFile, 'r');
+        await specHandle.sync();
+        await specHandle.close();
+        const originHandle = await open(path.join(staging, ORIGIN_FILE), 'r');
+        await originHandle.sync();
+        await originHandle.close();
+        await rename(staging, draft.specDir);
+        staging = null;
+        await input.hooks?.afterSpecPublish?.();
+        await appendCorrelatedProvenance({
+            projectDir: input.projectDir,
+            specId: draft.id,
+            specFile: draft.specFile,
+            proposalId: String(input.proposal.proposalId),
+            proposalHash: String(input.proposal.proposalHash),
+            correlationId: String(input.proposal.correlationId),
+            transactionId,
+            receiptHash,
+            eventId: provenanceEventId,
+            timestamp: createdAt,
+            hooks: {
+                beforeWrite: input.hooks?.beforeProvenanceWrite,
+                afterPartialWrite: input.hooks?.afterProvenancePartialWrite,
+                afterSyncBeforeReturn: input.hooks?.afterProvenanceSyncBeforeReturn,
+            },
+        });
+        return receiptFromOrigin(origin, draft.specDir, false);
+    }
+    finally {
+        if (staging)
+            await rm(staging, { recursive: true, force: true });
+        await release();
+    }
+}
+async function readOperatingOriginSidecar(specDir) {
+    try {
+        const directoryStat = await lstat(specDir);
+        if (!directoryStat.isDirectory() || directoryStat.isSymbolicLink()) {
+            fail('E_OPERATE_ORIGIN_INVALID', 'Operating origin requires a regular SPEC directory.');
+        }
+        const originPath = path.join(specDir, ORIGIN_FILE);
+        const originStat = await lstat(originPath);
+        if (!originStat.isFile() || originStat.isSymbolicLink()) {
+            fail('E_OPERATE_ORIGIN_INVALID', 'Operating origin requires a regular closed sidecar.');
+        }
+        const origin = JSON.parse(await readFile(originPath, 'utf8'));
+        assertOperatingOriginV1(origin);
+        const spec = origin.spec;
+        const specId = String(spec.specId);
+        const slug = String(spec.slug);
+        const expectedBase = `${specId}-${slug}`;
+        if (path.basename(path.resolve(specDir)) !== expectedBase) {
+            fail('E_OPERATE_ORIGIN_INVALID', 'Operating origin does not match its canonical SPEC directory identity.');
+        }
+        const specPath = path.join(specDir, `${expectedBase}.md`);
+        const specStat = await lstat(specPath);
+        if (!specStat.isFile() || specStat.isSymbolicLink()) {
+            fail('E_OPERATE_ORIGIN_INVALID', 'Operating origin requires a regular canonical SPEC file.');
+        }
+        const [canonicalDir, canonicalSpec, canonicalOrigin] = await Promise.all([
+            realpath(specDir),
+            realpath(specPath),
+            realpath(originPath),
+        ]);
+        for (const candidate of [canonicalSpec, canonicalOrigin]) {
+            const relative = path.relative(canonicalDir, candidate);
+            if (!relative || relative.startsWith('..') || path.isAbsolute(relative)) {
+                fail('E_OPERATE_ORIGIN_INVALID', 'Operating origin custody escapes its SPEC directory.');
+            }
+        }
+        return { origin, specPath };
+    }
+    catch (cause) {
+        if (cause.code === 'E_OPERATE_ORIGIN_INVALID')
+            throw cause;
+        fail('E_OPERATE_ORIGIN_INVALID', 'Operating origin custody is missing, malformed, or inaccessible.');
+    }
+}
+/**
+ * Load only the immutable owner/source identity required to authorize a trace.
+ * Canonical SPEC markdown bytes are deliberately not read at this boundary.
+ */
+export async function readSpecOperatingOriginAuthority(specDir) {
+    const { origin } = await readOperatingOriginSidecar(specDir);
+    return Object.freeze({
+        actorId: String(origin.actor.actorId),
+        cycleId: String(origin.cycleId),
+        scopeId: String(origin.scopeId),
+        domainId: String(origin.domainId),
+        domainVersion: String(origin.domainVersion),
+        specId: String(origin.spec.specId),
+        originHash: String(origin.originHash),
+    });
+}
+export async function readSpecOperatingOrigin(specDir) {
+    const { origin, specPath } = await readOperatingOriginSidecar(specDir);
+    const spec = origin.spec;
+    const rawSpec = await readFile(specPath, 'utf8').catch(() => fail('E_OPERATE_ORIGIN_INVALID', 'Operating origin canonical SPEC bytes are inaccessible.'));
+    const frontmatter = parseMarkdown(rawSpec).data;
+    if (frontmatter.id !== spec.specId ||
+        frontmatter.slug !== spec.slug ||
+        hashText(rawSpec) !== spec.contentHash) {
+        fail('E_OPERATE_ORIGIN_INVALID', 'Operating origin does not match the canonical SPEC identity and bytes.');
+    }
+    return origin;
+}
+//# sourceMappingURL=spec-operating-origin-service.js.map

package/dist/services/operate/spec-operating-origin-service.js.map

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

package/dist/services/operate/storage-layout.d.ts

@@ -0,0 +1,82 @@
+export type OperateStorageInspection = Readonly<{
+    status: 'empty' | 'ready' | 'migration-required' | 'interrupted';
+    root: string;
+    legacyV2Root: string | null;
+    legacyNeutralRoot: string | null;
+    privatePaths: readonly string[];
+    interruptedEntries: readonly string[];
+}>;
+export type OperateStorageArchive = Readonly<{
+    archiveId: string;
+    source: 'operate-v2' | 'operate-legacy';
+    hash: string;
+    fileCount: number;
+}>;
+export type OperateStorageMigrationReceipt = Readonly<{
+    kind: 'operate-storage-migration-receipt';
+    migrated: boolean;
+    archives: readonly OperateStorageArchive[];
+    verificationProofHash: string | null;
+    activatedState: TreeDigest | null;
+    rollbackArchiveId: string | null;
+}>;
+export type OperateStorageRollbackReceipt = Readonly<{
+    kind: 'operate-storage-rollback-receipt';
+    restoredSource: 'operate-v2';
+    restoredTree: TreeDigest;
+    restoredLegacyTree: TreeDigest | null;
+    forwardSnapshotId: string;
+}>;
+export type OperateLegacyReplayProof = Readonly<{
+    kind: 'operate-legacy-replay-proof';
+    schemaVersion: '1.0.0';
+    protocolVersion: '2.0.0';
+    source: 'operate-v2';
+    projectFingerprint: string;
+    tree: TreeDigest;
+    replay: Readonly<{
+        currentGeneration: string;
+        stateCanonicalHash: string;
+        eventHead: Readonly<{
+            sequence: number;
+            hash: string | null;
+        }>;
+        artifactHashes: readonly Readonly<{
+            artifactId: string;
+            rawHash: string;
+        }>[];
+    }>;
+    verifier: Readonly<{
+        implementation: 'bundled-compatibility-reader';
+        verifierVersion: '1.0.0';
+    }>;
+    verifiedAt: string;
+    receiptHash: string;
+}>;
+type TreeDigest = Readonly<{
+    hash: string;
+    fileCount: number;
+}>;
+/**
+ * Rechecks a pre-change verifier receipt against exact current custody without
+ * activating, moving, or interpreting any legacy accepted result bytes.
+ */
+export declare function verifyOperateLegacyReplayProof(projectDir: string, value: unknown): Promise<OperateLegacyReplayProof>;
+export declare function inspectOperateStorage(projectDir: string): Promise<OperateStorageInspection>;
+export declare function ensureOperateStorageLayout(projectDir: string): Promise<string>;
+export declare function migrateOperateStorage(projectDir: string, options?: {
+    now?: Date;
+    onArchive?: (archive: OperateStorageArchive) => Promise<void>;
+    afterStagePrepared?: () => Promise<void>;
+    afterParkNeutral?: () => Promise<void>;
+    afterActivate?: () => Promise<void>;
+}): Promise<OperateStorageMigrationReceipt>;
+type RollbackHooks = Readonly<{
+    afterProgress?: () => Promise<void>;
+    afterRestoreV2?: () => Promise<void>;
+    afterParkForward?: () => Promise<void>;
+    afterRestoreNeutral?: () => Promise<void>;
+}>;
+export declare function rollbackOperateStorageMigration(projectDir: string, hooks?: RollbackHooks): Promise<OperateStorageRollbackReceipt>;
+export {};
+//# sourceMappingURL=storage-layout.d.ts.map

package/dist/services/operate/storage-layout.d.ts.map

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