@ornexus/neocortex 4.60.71 → 4.60.73

package/packages/client/dist/generated/public-projections.generated.js

@@ -1 +1,149 @@
-const e={schemaVersion:"PublicProjectionBundle/1.0",generationId:"sha256:12838b51552e283fadffcea062246c8a0ca3b89353ccc01ce42b91361de6e0e9",sourceHash:"12838b51552e283fadffcea062246c8a0ca3b89353ccc01ce42b91361de6e0e9",catalogHash:"78c0271523e9a7dab978370cf6fc9c4abb3692b7fd21b9e8118bff1886b8fa19",publicProjectionHash:"e5022ae52f9241a51faab0e1d6f64c953e402fecaabac2d384298376dc14002d",stageProjectionHash:"f9875354257eb62be4509cd5cbf0b8e5e214a7414e82b8a8e45bc2baea6f0477",compilationHash:"82aeb4d0dceff6954222b15e35f9baf1d0eab7b14b6a994daaa7e7d793d65626",registry:{version:"1.0.0",checksum:"184a2d616e0734fd3173d60889d74bae031280513831ec1f0a3a8c36959d2994"},artifacts:[{kind:"catalog",schemaVersion:"ExecutableGraphCatalogPublicProjection/1.0",relativePath:"catalog.json",sha256:"47bfe074c0e3094296bae58393c801a745b102d548099596ccb3d8e419a3e738",entryCount:97,generationId:"sha256:12838b51552e283fadffcea062246c8a0ca3b89353ccc01ce42b91361de6e0e9"},{kind:"commands",schemaVersion:"CommandRegistryPublicProjection/1.0",relativePath:"commands.json",sha256:"907c009c7b10ad01eadb7a7f603af8759f348fe444af98a24c4558117bd09146",entryCount:62,generationId:"sha256:12838b51552e283fadffcea062246c8a0ca3b89353ccc01ce42b91361de6e0e9"},{kind:"progress-view",schemaVersion:"ProgressViewContractProjection/1.0",relativePath:"progress-view.json",sha256:"96f6ca2d3948891efe31fceb031001428190d31cbbbf1bf53446fcaf3be31fbb",entryCount:1,generationId:"sha256:12838b51552e283fadffcea062246c8a0ca3b89353ccc01ce42b91361de6e0e9"},{kind:"stages",schemaVersion:"ExecutableGraphStageProjection/1.0",relativePath:"stages.json",sha256:"5444c07f918f6b6760d8ba1161a66a7635841dac0da3a52ddb95c600e33e9700",entryCount:85,generationId:"sha256:12838b51552e283fadffcea062246c8a0ca3b89353ccc01ce42b91361de6e0e9"},{kind:"surfaces",schemaVersion:"PublicProjectionSurfaces/1.0",relativePath:"surfaces.json",sha256:"38b6f572e04f77d0fd8f22bdd43ffd67d7c763e28301160342cd228321f631e6",entryCount:6,generationId:"sha256:12838b51552e283fadffcea062246c8a0ca3b89353ccc01ce42b91361de6e0e9"}],compatibility:{status:"compatible",routeCount:97,rootCommandCount:62,operationCount:35,aliasCount:199},contractVersions:{catalog:"ExecutableGraphCatalogPublicProjection/1.0",stages:"ExecutableGraphStageProjection/1.0",progress:"ProgressSnapshot/1.0",progressView:"ProgressView/1.0",readiness:"ExecutableGraphReadinessVector/1.0",validation:"ValidationMatrix/1.1"},surfaces:[{kind:"admin",artifactKinds:["catalog","stages","commands","surfaces","progress-view"],progressView:"ProgressView/1.0",authority:"read-only-projection"},{kind:"client",artifactKinds:["catalog","stages","commands","surfaces","progress-view"],progressView:"ProgressView/1.0",authority:"read-only-projection"},{kind:"docs",artifactKinds:["catalog","stages","commands","surfaces","progress-view"],progressView:"ProgressView/1.0",authority:"read-only-projection"},{kind:"metrics",artifactKinds:["catalog","stages","commands","surfaces","progress-view"],progressView:"ProgressView/1.0",authority:"read-only-projection"},{kind:"runtime-preview",artifactKinds:["catalog","stages","commands","surfaces","progress-view"],progressView:"ProgressView/1.0",authority:"read-only-projection"},{kind:"tests",artifactKinds:["catalog","stages","commands","surfaces","progress-view"],progressView:"ProgressView/1.0",authority:"read-only-projection"}],publicSafe:!0,bundleHash:"9a6fd0a7a924a3a1f0406dc607e1c2a1c8a05f5efd55af24de6cb0f3bac25ab5"},a=e.generationId,c=e.bundleHash;export{e as PUBLIC_PROJECTION_BUNDLE,c as PUBLIC_PROJECTION_BUNDLE_HASH,a as PUBLIC_PROJECTION_GENERATION_ID};
+/** Generated by scripts/generate-public-catalog-projections.mjs. Do not edit. */
+export const PUBLIC_PROJECTION_BUNDLE = {
+    "schemaVersion": "PublicProjectionBundle/1.0",
+    "generationId": "sha256:12838b51552e283fadffcea062246c8a0ca3b89353ccc01ce42b91361de6e0e9",
+    "sourceHash": "12838b51552e283fadffcea062246c8a0ca3b89353ccc01ce42b91361de6e0e9",
+    "catalogHash": "78c0271523e9a7dab978370cf6fc9c4abb3692b7fd21b9e8118bff1886b8fa19",
+    "publicProjectionHash": "e5022ae52f9241a51faab0e1d6f64c953e402fecaabac2d384298376dc14002d",
+    "stageProjectionHash": "f9875354257eb62be4509cd5cbf0b8e5e214a7414e82b8a8e45bc2baea6f0477",
+    "compilationHash": "82aeb4d0dceff6954222b15e35f9baf1d0eab7b14b6a994daaa7e7d793d65626",
+    "registry": {
+        "version": "1.0.0",
+        "checksum": "184a2d616e0734fd3173d60889d74bae031280513831ec1f0a3a8c36959d2994"
+    },
+    "artifacts": [
+        {
+            "kind": "catalog",
+            "schemaVersion": "ExecutableGraphCatalogPublicProjection/1.0",
+            "relativePath": "catalog.json",
+            "sha256": "47bfe074c0e3094296bae58393c801a745b102d548099596ccb3d8e419a3e738",
+            "entryCount": 97,
+            "generationId": "sha256:12838b51552e283fadffcea062246c8a0ca3b89353ccc01ce42b91361de6e0e9"
+        },
+        {
+            "kind": "commands",
+            "schemaVersion": "CommandRegistryPublicProjection/1.0",
+            "relativePath": "commands.json",
+            "sha256": "907c009c7b10ad01eadb7a7f603af8759f348fe444af98a24c4558117bd09146",
+            "entryCount": 62,
+            "generationId": "sha256:12838b51552e283fadffcea062246c8a0ca3b89353ccc01ce42b91361de6e0e9"
+        },
+        {
+            "kind": "progress-view",
+            "schemaVersion": "ProgressViewContractProjection/1.0",
+            "relativePath": "progress-view.json",
+            "sha256": "96f6ca2d3948891efe31fceb031001428190d31cbbbf1bf53446fcaf3be31fbb",
+            "entryCount": 1,
+            "generationId": "sha256:12838b51552e283fadffcea062246c8a0ca3b89353ccc01ce42b91361de6e0e9"
+        },
+        {
+            "kind": "stages",
+            "schemaVersion": "ExecutableGraphStageProjection/1.0",
+            "relativePath": "stages.json",
+            "sha256": "5444c07f918f6b6760d8ba1161a66a7635841dac0da3a52ddb95c600e33e9700",
+            "entryCount": 85,
+            "generationId": "sha256:12838b51552e283fadffcea062246c8a0ca3b89353ccc01ce42b91361de6e0e9"
+        },
+        {
+            "kind": "surfaces",
+            "schemaVersion": "PublicProjectionSurfaces/1.0",
+            "relativePath": "surfaces.json",
+            "sha256": "38b6f572e04f77d0fd8f22bdd43ffd67d7c763e28301160342cd228321f631e6",
+            "entryCount": 6,
+            "generationId": "sha256:12838b51552e283fadffcea062246c8a0ca3b89353ccc01ce42b91361de6e0e9"
+        }
+    ],
+    "compatibility": {
+        "status": "compatible",
+        "routeCount": 97,
+        "rootCommandCount": 62,
+        "operationCount": 35,
+        "aliasCount": 199
+    },
+    "contractVersions": {
+        "catalog": "ExecutableGraphCatalogPublicProjection/1.0",
+        "stages": "ExecutableGraphStageProjection/1.0",
+        "progress": "ProgressSnapshot/1.0",
+        "progressView": "ProgressView/1.0",
+        "readiness": "ExecutableGraphReadinessVector/1.0",
+        "validation": "ValidationMatrix/1.1"
+    },
+    "surfaces": [
+        {
+            "kind": "admin",
+            "artifactKinds": [
+                "catalog",
+                "stages",
+                "commands",
+                "surfaces",
+                "progress-view"
+            ],
+            "progressView": "ProgressView/1.0",
+            "authority": "read-only-projection"
+        },
+        {
+            "kind": "client",
+            "artifactKinds": [
+                "catalog",
+                "stages",
+                "commands",
+                "surfaces",
+                "progress-view"
+            ],
+            "progressView": "ProgressView/1.0",
+            "authority": "read-only-projection"
+        },
+        {
+            "kind": "docs",
+            "artifactKinds": [
+                "catalog",
+                "stages",
+                "commands",
+                "surfaces",
+                "progress-view"
+            ],
+            "progressView": "ProgressView/1.0",
+            "authority": "read-only-projection"
+        },
+        {
+            "kind": "metrics",
+            "artifactKinds": [
+                "catalog",
+                "stages",
+                "commands",
+                "surfaces",
+                "progress-view"
+            ],
+            "progressView": "ProgressView/1.0",
+            "authority": "read-only-projection"
+        },
+        {
+            "kind": "runtime-preview",
+            "artifactKinds": [
+                "catalog",
+                "stages",
+                "commands",
+                "surfaces",
+                "progress-view"
+            ],
+            "progressView": "ProgressView/1.0",
+            "authority": "read-only-projection"
+        },
+        {
+            "kind": "tests",
+            "artifactKinds": [
+                "catalog",
+                "stages",
+                "commands",
+                "surfaces",
+                "progress-view"
+            ],
+            "progressView": "ProgressView/1.0",
+            "authority": "read-only-projection"
+        }
+    ],
+    "publicSafe": true,
+    "bundleHash": "9a6fd0a7a924a3a1f0406dc607e1c2a1c8a05f5efd55af24de6cb0f3bac25ab5"
+};
+export const PUBLIC_PROJECTION_GENERATION_ID = PUBLIC_PROJECTION_BUNDLE.generationId;
+export const PUBLIC_PROJECTION_BUNDLE_HASH = PUBLIC_PROJECTION_BUNDLE.bundleHash;

package/packages/client/dist/git/direct-yolo-c01-retry.js

@@ -1,4 +1,138 @@
-import{execFileSync as H}from"node:child_process";import{createHash as P,randomBytes as R}from"node:crypto";import{existsSync as k,readFileSync as E,writeFileSync as D}from"node:fs";import{join as u,resolve as O}from"node:path";import{acquireGitLifecyclePhysicalIntegrationLock as C,assertGitLifecyclePrivateFile as j,ensureGitLifecyclePrivateChildDirectory as L,gitLifecycleRuntimeDirectory as G,readGitLifecycleRuntime as N,releaseGitLifecyclePhysicalIntegrationLock as T}from"./git-lifecycle-store.js";const _=["809db253d486b5d2620d318666219e8a2b4df05016174ba3c8a33fa17b65802a","50224b193dae7ba2a066e54f7091d2656302b849ea7a145a3a4c556d85f3fe3c","f757f6bf1182f23e5d7acbe47cbce9f0fa12f211d290b486892c6722bc42b4e8","9cd927d02ff5979b5077e75b09cb34be275eca0e1c955403235b9ba0fb7a55eb","a3f880e8d5bca9158a88c46f88754c0948237a3e8516c83a762ba1ee22c27d46"];function i(n,r){const o={...process.env};for(const e of["GIT_DIR","GIT_WORK_TREE","GIT_INDEX_FILE","GIT_COMMON_DIR","GIT_NAMESPACE"])delete o[e];return H("git",[...r],{cwd:n,env:o,encoding:"utf8",stdio:["ignore","pipe","pipe"],timeout:3e4,maxBuffer:16*1024*1024}).trim()}function y(n){return P("sha256").update(n).digest("hex")}function c(n){return n&&typeof n=="object"&&!Array.isArray(n)?n:void 0}async function $(n,r){const o=O(n);if(!/^[A-Za-z][A-Za-z0-9_-]*\.[A-Za-z0-9._-]+$/.test(r))throw new Error("direct-yolo-retry-story-invalid");const e=r.split(".")[0],f=i(o,["rev-parse","HEAD"]),s=i(o,["symbolic-ref","--quiet","--short","HEAD"]);if(i(o,["status","--porcelain=v1","--untracked-files=all"]))throw new Error("direct-yolo-retry-checkout-dirty");const t=E(u(o,".neocortex/state.json"),"utf8"),m=c(JSON.parse(t)),a=c(c(m?.stories)?.[r]),d=c(c(m?.epics)?.[e]);if(!a||!d||a.epic_id!==e||d.branch_mode!=="epic"||d.execution_branch!==s||s!==`epic/${e}`)throw new Error("direct-yolo-retry-story-binding-invalid");const p=a.steps_completed;if(a.status!=="create-tasks"||typeof a.last_step!="string"||y(a.last_step)!==_.at(-1)||a.branch_name!==s||!Array.isArray(p)||p.length!==_.length||p.some((S,v)=>typeof S!="string"||y(S)!==_[v])||a.checkpoint||a.pr_number)throw new Error("direct-yolo-retry-progress-ineligible");const h=await N(o,{required:!0}),w=c(h.epics[e]),b=c(w?.branch_lease),l=c(w?.origin_binding);if(c(h.stories[r])&&Object.keys(c(h.stories[r])).length>0||!l||l.executionBranch!==s||typeof l.originHeadSha!="string"||!/^[a-f0-9]{40,64}$/.test(l.originHeadSha)||b&&(!Number.isFinite(Date.parse(String(b.expiresAt)))||Date.parse(String(b.expiresAt))>Date.now()))throw new Error("direct-yolo-retry-runtime-active");i(o,["merge-base","--is-ancestor",String(l.originHeadSha),f]);const g=await L(await G(o),"private-execution"),A=y(r);for(const S of[`session-${A}.json`,`baseline-${A}.json`]){const v=u(g,S);if(k(v))throw await j(v,g),new Error("direct-yolo-retry-private-evidence-present")}const x=`.neocortex/recovery/${r}-c01-${y(`${f}\0${y(t)}`).slice(0,16)}.json`;if(k(u(o,x)))throw new Error("direct-yolo-retry-already-recorded");if(i(o,["rev-parse","HEAD"])!==f||E(u(o,".neocortex/state.json"),"utf8")!==t)throw new Error("direct-yolo-retry-preflight-raced");return Object.freeze({schemaVersion:1,kind:"direct-yolo-c01-retry-plan",storyId:r,epicId:e,executionBranch:s,previousHeadSha:f,previousStateSha256:y(t),runtimeRevision:h.revision,previousStatus:"create-tasks",previousStepsCompleted:[...p],auditPath:x,publicSafe:!0})}async function q(n,r,o){const e=O(n),f=`retry-${R(16).toString("hex")}`,s=await C(e,{kind:"direct",storyId:r,sessionId:f,idempotencyKey:f,expiresAt:new Date(Date.now()+5*6e4).toISOString(),persistent:!1});if(!s.ok)throw new Error(s.reasonCode);try{const t=await $(e,r);if(t.previousHeadSha!==o)throw new Error("direct-yolo-retry-head-mismatch");const m=u(e,".neocortex/state.json"),a=JSON.parse(E(m,"utf8")),d=a.stories[r];d.status="backlog",d.steps_completed=[],d.last_step=null,d.branch_name=null;const p={...t,recordedAt:new Date().toISOString(),reason:"private-session-lost",newAttemptStatus:"backlog",oldProgressAcceptedForNewAttempt:!1};d.last_updated=p.recordedAt;const h=await $(e,r);if(JSON.stringify(h)!==JSON.stringify(t))throw new Error("direct-yolo-retry-apply-raced");if(i(e,["rev-parse","HEAD"])!==o||y(E(m,"utf8"))!==t.previousStateSha256||i(e,["status","--porcelain=v1","--untracked-files=all"]))throw new Error("direct-yolo-retry-apply-raced");const{mkdirSync:w}=await import("node:fs");if(w(u(e,".neocortex/recovery"),{recursive:!0}),D(u(e,t.auditPath),`${JSON.stringify(p,null,2)}
-`,{flag:"wx"}),D(m,`${JSON.stringify(a,null,2)}
-`),(await N(e,{required:!0})).revision!==t.runtimeRevision)throw new Error("direct-yolo-retry-runtime-raced");i(e,["add","--",".neocortex/state.json",t.auditPath]),i(e,["commit","-m",`chore(${r}): begin audited C01 retry`,"-m",`Neocortex-C01-Retry-From: ${t.previousHeadSha}`,"-m",`Neocortex-C01-Retry-Audit: ${t.auditPath}`]);const l=i(e,["rev-parse","HEAD"]),g=i(e,["diff-tree","--no-commit-id","--name-only","-r",l]).split(`
-`).filter(Boolean).sort();if(i(e,["rev-parse",`${l}^`])!==t.previousHeadSha||JSON.stringify(g)!==JSON.stringify([".neocortex/state.json",t.auditPath].sort())||i(e,["status","--porcelain=v1","--untracked-files=all"]))throw new Error("direct-yolo-retry-postcommit-unverified");return{plan:t,newHeadSha:l}}finally{await T(s.path,s.owner).catch(()=>{})}}export{q as applyDirectYoloC01Retry,$ as inspectDirectYoloC01Retry};
+/** Audited restart of a pre-implementation epic story after its private C01 session was lost. */
+import { execFileSync } from 'node:child_process';
+import { createHash, randomBytes } from 'node:crypto';
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { acquireGitLifecyclePhysicalIntegrationLock, assertGitLifecyclePrivateFile, ensureGitLifecyclePrivateChildDirectory, gitLifecycleRuntimeDirectory, readGitLifecycleRuntime, releaseGitLifecyclePhysicalIntegrationLock, } from './git-lifecycle-store.js';
+// Server-owned step identifiers stay outside the published client bundle.
+const COMPLETED_BEFORE_IMPLEMENTATION_SHA256 = [
+    '809db253d486b5d2620d318666219e8a2b4df05016174ba3c8a33fa17b65802a',
+    '50224b193dae7ba2a066e54f7091d2656302b849ea7a145a3a4c556d85f3fe3c',
+    'f757f6bf1182f23e5d7acbe47cbce9f0fa12f211d290b486892c6722bc42b4e8',
+    '9cd927d02ff5979b5077e75b09cb34be275eca0e1c955403235b9ba0fb7a55eb',
+    'a3f880e8d5bca9158a88c46f88754c0948237a3e8516c83a762ba1ee22c27d46',
+];
+function git(root, args) {
+    const env = { ...process.env };
+    for (const key of ['GIT_DIR', 'GIT_WORK_TREE', 'GIT_INDEX_FILE', 'GIT_COMMON_DIR', 'GIT_NAMESPACE'])
+        delete env[key];
+    return execFileSync('git', [...args], { cwd: root, env, encoding: 'utf8',
+        stdio: ['ignore', 'pipe', 'pipe'], timeout: 30_000, maxBuffer: 16 * 1024 * 1024 }).trim();
+}
+function digest(value) { return createHash('sha256').update(value).digest('hex'); }
+function record(value) {
+    return value && typeof value === 'object' && !Array.isArray(value) ? value : undefined;
+}
+/** No mutation: require missing private session, expired lease, clean Git, and exact C01-C05 progress. */
+export async function inspectDirectYoloC01Retry(projectRoot, storyId) {
+    const root = resolve(projectRoot);
+    if (!/^[A-Za-z][A-Za-z0-9_-]*\.[A-Za-z0-9._-]+$/.test(storyId))
+        throw new Error('direct-yolo-retry-story-invalid');
+    const epicId = storyId.split('.')[0];
+    const head = git(root, ['rev-parse', 'HEAD']);
+    const branch = git(root, ['symbolic-ref', '--quiet', '--short', 'HEAD']);
+    if (git(root, ['status', '--porcelain=v1', '--untracked-files=all']))
+        throw new Error('direct-yolo-retry-checkout-dirty');
+    const stateText = readFileSync(join(root, '.neocortex/state.json'), 'utf8');
+    const state = record(JSON.parse(stateText));
+    const story = record(record(state?.stories)?.[storyId]);
+    const epic = record(record(state?.epics)?.[epicId]);
+    if (!story || !epic || story.epic_id !== epicId || epic.branch_mode !== 'epic'
+        || epic.execution_branch !== branch || branch !== `epic/${epicId}`)
+        throw new Error('direct-yolo-retry-story-binding-invalid');
+    const steps = story.steps_completed;
+    if (story.status !== 'create-tasks' || typeof story.last_step !== 'string'
+        || digest(story.last_step) !== COMPLETED_BEFORE_IMPLEMENTATION_SHA256.at(-1)
+        || story.branch_name !== branch || !Array.isArray(steps)
+        || steps.length !== COMPLETED_BEFORE_IMPLEMENTATION_SHA256.length
+        || steps.some((step, index) => typeof step !== 'string'
+            || digest(step) !== COMPLETED_BEFORE_IMPLEMENTATION_SHA256[index])
+        || story.checkpoint || story.pr_number)
+        throw new Error('direct-yolo-retry-progress-ineligible');
+    const runtime = await readGitLifecycleRuntime(root, { required: true });
+    const runtimeEpic = record(runtime.epics[epicId]);
+    const lease = record(runtimeEpic?.branch_lease);
+    const origin = record(runtimeEpic?.origin_binding);
+    if (record(runtime.stories[storyId]) && Object.keys(record(runtime.stories[storyId])).length > 0
+        || !origin || origin.executionBranch !== branch || typeof origin.originHeadSha !== 'string'
+        || !/^[a-f0-9]{40,64}$/.test(origin.originHeadSha)
+        || lease && (!Number.isFinite(Date.parse(String(lease.expiresAt)))
+            || Date.parse(String(lease.expiresAt)) > Date.now()))
+        throw new Error('direct-yolo-retry-runtime-active');
+    git(root, ['merge-base', '--is-ancestor', String(origin.originHeadSha), head]);
+    const privateRoot = await ensureGitLifecyclePrivateChildDirectory(await gitLifecycleRuntimeDirectory(root), 'private-execution');
+    const storyHash = digest(storyId);
+    for (const name of [`session-${storyHash}.json`, `baseline-${storyHash}.json`]) {
+        const path = join(privateRoot, name);
+        if (existsSync(path)) {
+            await assertGitLifecyclePrivateFile(path, privateRoot);
+            throw new Error('direct-yolo-retry-private-evidence-present');
+        }
+    }
+    const auditPath = `.neocortex/recovery/${storyId}-c01-${digest(`${head}\0${digest(stateText)}`).slice(0, 16)}.json`;
+    if (existsSync(join(root, auditPath)))
+        throw new Error('direct-yolo-retry-already-recorded');
+    if (git(root, ['rev-parse', 'HEAD']) !== head || readFileSync(join(root, '.neocortex/state.json'), 'utf8') !== stateText) {
+        throw new Error('direct-yolo-retry-preflight-raced');
+    }
+    return Object.freeze({ schemaVersion: 1, kind: 'direct-yolo-c01-retry-plan', storyId, epicId,
+        executionBranch: branch, previousHeadSha: head, previousStateSha256: digest(stateText),
+        runtimeRevision: runtime.revision,
+        previousStatus: 'create-tasks', previousStepsCompleted: [...steps],
+        auditPath, publicSafe: true });
+}
+/** Commit a new C01 attempt; the prior progress stays reachable in the parent commit. */
+export async function applyDirectYoloC01Retry(projectRoot, storyId, expectedHeadSha) {
+    const root = resolve(projectRoot);
+    const lockId = `retry-${randomBytes(16).toString('hex')}`;
+    const lock = await acquireGitLifecyclePhysicalIntegrationLock(root, {
+        kind: 'direct', storyId, sessionId: lockId, idempotencyKey: lockId,
+        expiresAt: new Date(Date.now() + 5 * 60_000).toISOString(), persistent: false,
+    });
+    if (!lock.ok)
+        throw new Error(lock.reasonCode);
+    try {
+        const plan = await inspectDirectYoloC01Retry(root, storyId);
+        if (plan.previousHeadSha !== expectedHeadSha)
+            throw new Error('direct-yolo-retry-head-mismatch');
+        const statePath = join(root, '.neocortex/state.json');
+        const state = JSON.parse(readFileSync(statePath, 'utf8'));
+        const story = state.stories[storyId];
+        story.status = 'backlog';
+        story.steps_completed = [];
+        story.last_step = null;
+        story.branch_name = null;
+        const audit = { ...plan, recordedAt: new Date().toISOString(), reason: 'private-session-lost',
+            newAttemptStatus: 'backlog', oldProgressAcceptedForNewAttempt: false };
+        story.last_updated = audit.recordedAt;
+        const reconfirmed = await inspectDirectYoloC01Retry(root, storyId);
+        if (JSON.stringify(reconfirmed) !== JSON.stringify(plan))
+            throw new Error('direct-yolo-retry-apply-raced');
+        if (git(root, ['rev-parse', 'HEAD']) !== expectedHeadSha
+            || digest(readFileSync(statePath, 'utf8')) !== plan.previousStateSha256
+            || git(root, ['status', '--porcelain=v1', '--untracked-files=all']))
+            throw new Error('direct-yolo-retry-apply-raced');
+        const { mkdirSync } = await import('node:fs');
+        mkdirSync(join(root, '.neocortex/recovery'), { recursive: true });
+        writeFileSync(join(root, plan.auditPath), `${JSON.stringify(audit, null, 2)}\n`, { flag: 'wx' });
+        writeFileSync(statePath, `${JSON.stringify(state, null, 2)}\n`);
+        const runtimeBeforeCommit = await readGitLifecycleRuntime(root, { required: true });
+        if (runtimeBeforeCommit.revision !== plan.runtimeRevision)
+            throw new Error('direct-yolo-retry-runtime-raced');
+        git(root, ['add', '--', '.neocortex/state.json', plan.auditPath]);
+        git(root, ['commit', '-m', `chore(${storyId}): begin audited C01 retry`,
+            '-m', `Neocortex-C01-Retry-From: ${plan.previousHeadSha}`,
+            '-m', `Neocortex-C01-Retry-Audit: ${plan.auditPath}`]);
+        const newHeadSha = git(root, ['rev-parse', 'HEAD']);
+        const committedPaths = git(root, ['diff-tree', '--no-commit-id', '--name-only', '-r', newHeadSha])
+            .split('\n').filter(Boolean).sort();
+        if (git(root, ['rev-parse', `${newHeadSha}^`]) !== plan.previousHeadSha
+            || JSON.stringify(committedPaths) !== JSON.stringify(['.neocortex/state.json', plan.auditPath].sort())
+            || git(root, ['status', '--porcelain=v1', '--untracked-files=all']))
+            throw new Error('direct-yolo-retry-postcommit-unverified');
+        return { plan, newHeadSha };
+    }
+    finally {
+        await releaseGitLifecyclePhysicalIntegrationLock(lock.path, lock.owner).catch(() => undefined);
+    }
+}