@ornexus/neocortex 4.60.58 → 4.60.60

package/packages/client/dist/git/legacy-story-branch-checkpoint.d.ts

@@ -0,0 +1,38 @@
+type Result<T> = {
+    readonly ok: true;
+    readonly value: T;
+} | {
+    readonly ok: false;
+    readonly reasonCode: string;
+};
+type Issue = {
+    readonly number: number;
+    readonly title: string;
+    readonly state: string;
+    readonly url: string;
+};
+type IssueVerifier = (repository: string, number: number) => Promise<Issue>;
+export interface LegacyStoryC01CheckpointReceipt {
+    readonly schemaVersion: 1;
+    readonly kind: 'legacy-story-c01-checkpoint';
+    readonly storyId: string;
+    readonly epicId: string;
+    readonly branch: string;
+    readonly issueNumber: number;
+    readonly repository: string;
+    readonly stateSha256: string;
+    readonly storySha256: string;
+    readonly reused: boolean;
+    readonly checkpointAccepted: true;
+    readonly localOnly: true;
+}
+export declare function acceptLegacyStoryBranchC01(options: {
+    readonly projectRoot: string;
+    readonly storyId: string;
+    readonly issueNumber: number;
+    /** Test seam; the productive CLI always uses authenticated gh readback. */
+    readonly verifyIssue?: IssueVerifier;
+    readonly afterStatePersist?: () => Promise<void>;
+    readonly afterStoryPersist?: () => Promise<void>;
+}): Promise<Result<LegacyStoryC01CheckpointReceipt>>;
+export {};

package/packages/client/dist/git/legacy-story-branch-checkpoint.js

@@ -0,0 +1,9 @@
+import{execFileSync as O}from"node:child_process";import{createHash as K,randomBytes as R}from"node:crypto";import{closeSync as G,constants as L,existsSync as Z,fstatSync as q,openSync as T,readFileSync as V,realpathSync as B}from"node:fs";import{join as k,resolve as Y}from"node:path";import{parseDocument as M}from"yaml";import{resolveBranchUnit as U}from"../../../shared/dist/yoloop/branch-unit.js";import{acquireGitLifecyclePhysicalIntegrationLock as Q,assertGitLifecyclePrivateFile as j,ensureGitLifecyclePrivateChildDirectory as X,gitLifecycleRuntimeDirectory as tt,releaseGitLifecyclePhysicalIntegrationLock as et}from"./git-lifecycle-store.js";import{GIT_LIFECYCLE_SETUP_BRANCH_STEP_ID as v}from"./git-lifecycle-step-ids.js";import{anchoredAtomicWriteFile as rt,anchoredCompareAndSwapFile as D}from"./secure-filesystem-boundary.js";import{readCompletedLegacyStoryBranchPlan as st}from"./legacy-story-branch-setup.js";function p(t){return{ok:!1,reasonCode:t}}function g(t){return K("sha256").update(t).digest("hex")}function S(t){return t&&typeof t=="object"&&!Array.isArray(t)?t:null}function l(t,c){return O("git",[...c],{cwd:t,encoding:"utf8",stdio:["ignore","pipe","pipe"],maxBuffer:4*1024*1024}).trim()}function C(t,c){return O("git",[...c],{cwd:t,encoding:"utf8",stdio:["ignore","pipe","pipe"],maxBuffer:4*1024*1024})}function $(t){const c=T(t,L.O_RDONLY|(L.O_NOFOLLOW??0));try{const e=q(c);if(!e.isFile()||e.size>2*1024*1024)throw new Error("legacy-branch-checkpoint-file-unsafe");return V(c,"utf8")}finally{G(c)}}function ct(t){const e=l(t,["remote","get-url","origin"]).match(/^(?:https:\/\/github\.com\/|git@github\.com:)([A-Za-z0-9_.-]+)\/([A-Za-z0-9_.-]+?)(?:\.git)?$/);if(!e||e[1].includes("..")||e[2].includes(".."))throw new Error("legacy-branch-issue-repository-invalid");return`${e[1]}/${e[2]}`}async function nt(t,c){const e=O("gh",["issue","view",String(c),"--repo",t,"--json","number,title,state,url"],{encoding:"utf8",timeout:15e3,stdio:["ignore","pipe","pipe"],maxBuffer:16384});return JSON.parse(e)}function ot(t,c,e,s,r){if(t.number!==s||t.title!==`[YOLO] Story ${e} - Workflow Run`||t.state!=="OPEN"&&!(r&&t.state==="CLOSED")||t.url.toLowerCase()!==`https://github.com/${c}/issues/${s}`.toLowerCase())throw new Error("legacy-branch-issue-evidence-invalid")}function at(t,c){const e=t.worktreePath,s=C(e,["show","HEAD:.neocortex/state.json"]);if(g(s)!==t.stateSha256)throw new Error("legacy-branch-checkpoint-base-state-mismatch");const r=S(JSON.parse(s)),h=S(r?.stories),o=S(r?.epics),a=S(h?.[t.storyId]),f=S(o?.[t.epicId]),i=Object.entries(h??{}).flatMap(([d,z])=>{const P=S(z);return P?.epic_id===t.epicId?[{...P,id:d}]:[]});if(!f||f.id!==t.epicId||f.branch_mode==="epic"||U(f,i).mode!=="story"||!a||a.id!==t.storyId||a.epic_id!==t.epicId||a.status!=="backlog"&&a.status!=="ready_to_start"||!Array.isArray(a.steps_completed)||a.steps_completed.length!==0||a.branch_name||a.issue_number||a.last_step)throw new Error("legacy-branch-checkpoint-state-conflict");a.status="branch-ready",a.steps_completed=[v],a.last_step=v,a.branch_name=t.branch,a.issue_number=c;const u=`${JSON.stringify(r,null,2)}
+`,b=`docs/stories/${t.storyId}.story.md`,y=C(e,["show",`HEAD:${b}`]),I=y.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n/);if(!I)throw new Error("legacy-branch-checkpoint-frontmatter-invalid");const n=M(I[1],{strict:!0,uniqueKeys:!0});if(n.errors.length>0||n.get("id")!==t.storyId||(n.get("epic_id")??n.get("epic"))!==t.epicId)throw new Error("legacy-branch-checkpoint-frontmatter-invalid");const w=S(n.toJS()),m=["stepsCompleted","steps_completed"].filter(d=>n.has(d)),A=["branchName","branch_name"].filter(d=>n.has(d)),_=["lastStep","last_step"].filter(d=>n.has(d)),N=["issueNumber","issue_number"].filter(d=>n.has(d));if(m.length>1||A.length>1||_.length>1||N.length>1||n.has("status")&&!["backlog","ready","ready_to_start"].includes(String(n.get("status")))||n.has("currentStatus")&&!["backlog","ready","ready_to_start"].includes(String(w?.currentStatus))||m.length===1&&(!Array.isArray(w?.[m[0]])||(w?.[m[0]]).length!==0)||A.length===1&&w?.[A[0]]!=null||_.length===1&&w?.[_[0]]!=null||N.length===1&&w?.[N[0]]!=null)throw new Error("legacy-branch-checkpoint-frontmatter-conflict");n.set("status","branch-ready"),n.has("currentStatus")&&n.set("currentStatus","branch-ready"),n.set(m[0]??"stepsCompleted",[v]),n.set(_[0]??"lastStep",v),n.set(A[0]??"branchName",t.branch),n.set(N[0]??"issueNumber",c);const F=`---
+${n.toString({lineWidth:0})}---
+${y.slice(I[0].length)}`;return{storyPath:b,stateBefore:s,stateAfter:u,storyBefore:y,storyAfter:F}}function E(t,c,e){const s=B(t.worktreePath);if(t.epicId!==t.storyId.split(".")[0]||t.branch!==`story/${t.epicId}/${t.storyId}`||!/^[A-Za-z0-9][A-Za-z0-9_-]*$/.test(t.epicId)||!l(c,["check-ref-format","--branch",t.branch])||!l(c,["check-ref-format","--branch",t.baseBranch]))throw new Error("legacy-branch-checkpoint-plan-invalid");const r=i=>B(Y(i,l(i,["rev-parse","--git-common-dir"]))),h=l(c,["worktree","list","--porcelain"]).split(/\n\n+/).filter(i=>i.split(`
+`).includes(`branch refs/heads/${t.branch}`));if(s!==t.worktreePath||h.length!==1||!h[0].split(`
+`).includes(`worktree ${s}`)||h[0].split(`
+`).some(i=>i.startsWith("locked")||i.startsWith("prunable"))||r(s)!==r(c)||B(l(s,["rev-parse","--show-toplevel"]))!==s||l(s,["symbolic-ref","--quiet","--short","HEAD"])!==t.branch||l(s,["rev-parse","HEAD"])!==t.baseHeadSha||l(s,["rev-parse",`refs/heads/${t.branch}`])!==t.baseHeadSha||l(s,["rev-parse",`refs/remotes/origin/${t.baseBranch}`])!==t.baseHeadSha)throw new Error("legacy-branch-checkpoint-physical-mismatch");const o=$(k(s,".neocortex/state.json")),a=$(k(s,e.storyPath));if(![e.stateBefore,e.stateAfter].includes(o)||![e.storyBefore,e.storyAfter].includes(a))throw new Error("legacy-branch-checkpoint-preimage-conflict");if(C(s,["status","--porcelain=v1","-uall"]).split(`
+`).filter(Boolean).some(i=>{if(!i.startsWith(" M "))return!0;const u=i.slice(3);return u!==".neocortex/state.json"&&u!==e.storyPath}))throw new Error("legacy-branch-checkpoint-worktree-dirty");return{stateCurrent:o,storyCurrent:a}}async function it(t){return X(await tt(t),"legacy-story-branch-intents")}function x(t){return`${g(t)}.c01.json`}function J(t){return`${g(t)}.c01.accepted.json`}async function H(t,c){const e=k(t,c);if(!Z(e))return null;await j(e,t);const s=$(e);if(s.length>4096)throw new Error("legacy-branch-checkpoint-journal-invalid");return JSON.parse(s)}async function W(t,c,e){await rt(t,c,`${JSON.stringify(e)}
+`),await j(k(t,c),t)}async function wt(t){if(!Number.isSafeInteger(t.issueNumber)||t.issueNumber<=0)return p("legacy-branch-issue-number-invalid");const c=`legacy-c01-${R(16).toString("hex")}`,e=await Q(t.projectRoot,{kind:"direct",storyId:t.storyId,sessionId:c,idempotencyKey:c,expiresAt:new Date(Date.now()+5*6e4).toISOString(),persistent:!1});if(!e.ok)return p(e.reasonCode);try{const s=await st(t);if(!s.ok)return s;const r=s.value,h=B(t.projectRoot),o=at(r,t.issueNumber),a=E(r,h,o),f=ct(h),i=await it(h),u={schemaVersion:1,kind:"legacy-story-c01-acceptance-intent",storyId:r.storyId,planDigest:g(JSON.stringify(r)),repository:f,issueNumber:t.issueNumber,stateBefore:g(o.stateBefore),stateAfter:g(o.stateAfter),storyBefore:g(o.storyBefore),storyAfter:g(o.storyAfter)},b=await H(i,x(r.storyId));if(b&&JSON.stringify(b)!==JSON.stringify(u))return p("legacy-branch-checkpoint-journal-conflict");if(!b&&(a.stateCurrent!==o.stateBefore||a.storyCurrent!==o.storyBefore))return p("legacy-branch-checkpoint-unjournaled-drift");const y=await H(i,J(r.storyId));if(y&&JSON.stringify(y)!==JSON.stringify(u))return p("legacy-branch-checkpoint-accepted-conflict");const I=await(t.verifyIssue??nt)(f,t.issueNumber);ot(I,f,r.storyId,t.issueNumber,!!y),b||await W(i,x(r.storyId),u);const n=E(r,h,o);if(y&&(n.stateCurrent!==o.stateAfter||n.storyCurrent!==o.storyAfter))return p("legacy-branch-checkpoint-accepted-physical-mismatch");n.stateCurrent===o.stateBefore&&(await D(k(r.worktreePath,".neocortex"),"state.json",o.stateAfter,u.stateBefore),await t.afterStatePersist?.()),E(r,h,o).storyCurrent===o.storyBefore&&(await D(k(r.worktreePath,"docs/stories"),`${r.storyId}.story.md`,o.storyAfter,u.storyBefore),await t.afterStoryPersist?.());const m=E(r,h,o);return m.stateCurrent!==o.stateAfter||m.storyCurrent!==o.storyAfter?p("legacy-branch-checkpoint-post-write-mismatch"):(y||await W(i,J(r.storyId),u),{ok:!0,value:Object.freeze({schemaVersion:1,kind:"legacy-story-c01-checkpoint",storyId:r.storyId,epicId:r.epicId,branch:r.branch,issueNumber:t.issueNumber,repository:f,stateSha256:u.stateAfter,storySha256:u.storyAfter,reused:!!y,checkpointAccepted:!0,localOnly:!0})})}catch(s){const r=s instanceof Error?s.message:"";return p(r.startsWith("legacy-branch-")?r:r.includes("secure-filesystem-cas-conflict")?"legacy-branch-checkpoint-write-raced":"legacy-branch-checkpoint-failed")}finally{await et(e.path,e.owner).catch(()=>{})}}export{wt as acceptLegacyStoryBranchC01};

package/packages/client/dist/git/legacy-story-branch-setup.d.ts

@@ -0,0 +1,56 @@
+/**
+ * @license FSL-1.1
+ * Copyright (c) 2026 OrNexus AI
+ *
+ * Root-owned physical branch preparation for projects that recorded the
+ * legacy story-branch topology. It deliberately leaves state and story
+ * checkpoint acceptance to a separate root transaction.
+ */
+export type LegacyStoryBranchSetupResult<T> = {
+    readonly ok: true;
+    readonly value: T;
+} | {
+    readonly ok: false;
+    readonly reasonCode: string;
+};
+export interface LegacyStoryBranchPlan {
+    readonly schemaVersion: 1;
+    readonly kind: 'legacy-story-branch-plan';
+    readonly storyId: string;
+    readonly epicId: string;
+    readonly worktreePath: string;
+    readonly branch: string;
+    readonly baseBranch: string;
+    readonly baseHeadSha: string;
+    readonly currentHeadSha: string;
+    readonly existingBranchHeadSha: string | null;
+    readonly stateSha256: string;
+    /** Contains a local worktree path; never forward this receipt to invoke. */
+    readonly localOnly: true;
+}
+export interface LegacyStoryBranchSetupReceipt extends Omit<LegacyStoryBranchPlan, 'kind'> {
+    readonly kind: 'legacy-story-branch-setup-receipt';
+    readonly headSha: string;
+    readonly reused: boolean;
+    readonly checkpointAccepted: false;
+}
+/** Read-only physical planning; no fetch, checkout, issue creation or state write. */
+export declare function planLegacyStoryBranchSetup(options: {
+    readonly projectRoot: string;
+    readonly storyId: string;
+}): LegacyStoryBranchSetupResult<LegacyStoryBranchPlan>;
+/** Local-only completion record; callers must still recompute physical truth. */
+export declare function readCompletedLegacyStoryBranchPlan(options: {
+    readonly projectRoot: string;
+    readonly storyId: string;
+}): Promise<LegacyStoryBranchSetupResult<LegacyStoryBranchPlan>>;
+/** Proves a switched branch against the private intent durably written before switch. */
+export declare function verifyLegacyStoryBranchSetup(options: {
+    readonly projectRoot: string;
+    readonly storyId: string;
+}): Promise<LegacyStoryBranchSetupResult<LegacyStoryBranchSetupReceipt>>;
+/** Switches only the proven epic worktree; root checkpoint acceptance is separate. */
+export declare function prepareLegacyStoryBranchSetup(options: {
+    readonly projectRoot: string;
+    readonly storyId: string;
+}): Promise<LegacyStoryBranchSetupResult<LegacyStoryBranchSetupReceipt>>;

package/packages/client/dist/git/legacy-story-branch-setup.js

@@ -0,0 +1,4 @@
+import{execFileSync as T}from"node:child_process";import{createHash as w,randomBytes as V}from"node:crypto";import{closeSync as G,constants as B,existsSync as L,fstatSync as U,openSync as M,readFileSync as Y,realpathSync as y}from"node:fs";import{join as d,resolve as O}from"node:path";import{resolveBranchUnit as K}from"../../../shared/dist/yoloop/branch-unit.js";import{acquireGitLifecyclePhysicalIntegrationLock as Q,assertGitLifecyclePrivateFile as S,ensureGitLifecyclePrivateChildDirectory as X,gitLifecycleRuntimeDirectory as ee,releaseGitLifecyclePhysicalIntegrationLock as re}from"./git-lifecycle-store.js";import{GIT_LIFECYCLE_SETUP_BRANCH_STEP_ID as te}from"./git-lifecycle-step-ids.js";import{anchoredAtomicWriteFile as N}from"./secure-filesystem-boundary.js";const ae="legacy-story-branch-intents";function x(r){return`${w("sha256").update(r).digest("hex")}.json`}function _(r){return`${w("sha256").update(r).digest("hex")}.completed.json`}function P(r){return w("sha256").update(JSON.stringify(r)).digest("hex")}async function k(r){return X(await ee(r),ae)}function ne(r,e){const t=f(r);if(!t||Object.keys(t).sort().join(",")!==["baseBranch","baseHeadSha","branch","currentHeadSha","epicId","existingBranchHeadSha","kind","localOnly","schemaVersion","stateSha256","storyId","worktreePath"].sort().join(",")||t.schemaVersion!==1||t.kind!=="legacy-story-branch-plan"||t.storyId!==e||t.localOnly!==!0||t.existingBranchHeadSha!==null||typeof t.epicId!="string"||typeof t.branch!="string"||typeof t.baseBranch!="string"||typeof t.worktreePath!="string"||![t.baseHeadSha,t.currentHeadSha,t.stateSha256].every(a=>typeof a=="string"&&/^[0-9a-f]{40,64}$/.test(a)))throw new Error("legacy-branch-intent-invalid");return t}async function R(r,e){const t=await k(r),a=d(t,x(e));if(!L(a))return null;await S(a,t);const c=b(a);if(c.length>4096)throw new Error("legacy-branch-intent-invalid");return ne(JSON.parse(c),e)}async function ce(r,e){const t=await k(r),a=await R(r,e.storyId);if(a){if(JSON.stringify(a)!==JSON.stringify(e))throw new Error("legacy-branch-intent-conflict");return}await N(t,x(e.storyId),`${JSON.stringify(e)}
+`),await S(d(t,x(e.storyId)),t)}async function z(r,e){const t=await k(r),a=d(t,_(e.storyId));if(!L(a))return!1;await S(a,t);const c=b(a);if(c.length>512)throw new Error("legacy-branch-completion-invalid");const n=f(JSON.parse(c));if(!n||Object.keys(n).sort().join(",")!=="kind,planDigest,schemaVersion,storyId"||n.schemaVersion!==1||n.kind!=="legacy-story-branch-switch-completed"||n.storyId!==e.storyId||n.planDigest!==P(e))throw new Error("legacy-branch-completion-invalid");return!0}async function oe(r,e){if(await z(r,e))return;const t=await k(r);await N(t,_(e.storyId),`${JSON.stringify({schemaVersion:1,kind:"legacy-story-branch-switch-completed",storyId:e.storyId,planDigest:P(e)})}
+`),await S(d(t,_(e.storyId)),t)}function i(r){return{ok:!1,reasonCode:r}}function A(r,e){return T("git",[...e],{cwd:r,encoding:"utf8",stdio:["ignore","pipe","pipe"],maxBuffer:4*1024*1024})}function o(r,e){return A(r,e).trim()}function H(r,e){try{return o(r,e),!0}catch{return!1}}function f(r){return r&&typeof r=="object"&&!Array.isArray(r)?r:null}function m(r,e){return e.length>0&&e.length<=200&&!e.startsWith("-")&&!e.includes("..")&&!e.includes("@{")&&H(r,["check-ref-format","--branch",e])}function b(r){const e=M(r,B.O_RDONLY|(B.O_NOFOLLOW??0));try{const t=U(e);if(!t.isFile()||t.size>2*1024*1024)throw new Error("legacy-branch-state-unsafe");return Y(e,"utf8")}finally{G(e)}}function W(r){return o(r,["worktree","list","--porcelain"]).split(/\n\n+/).flatMap(e=>{const t=e.split(`
+`),a=t.find(n=>n.startsWith("worktree ")),c=t.find(n=>n.startsWith("branch refs/heads/"));return!a||!c?[]:[{path:a.slice(9),branch:c.slice(18),unsafe:t.some(n=>n.startsWith("prunable")||n.startsWith("locked"))}]})}function se(r){const e=y(r.projectRoot);if(!/^[A-Za-z0-9][A-Za-z0-9_-]*\.[A-Za-z0-9._-]+$/.test(r.storyId))throw new Error("legacy-branch-story-id-invalid");if(y(o(e,["rev-parse","--show-toplevel"]))!==e)throw new Error("legacy-branch-project-root-invalid");const t=d(e,".neocortex/state.json"),a=b(t),c=f(JSON.parse(a)),n=f(c?.stories),u=f(c?.epics),h=f(n?.[r.storyId]),s=h?.epic_id,g=typeof s=="string"?f(u?.[s]):null;if(!h||h.id!==r.storyId||typeof s!="string"||!/^[A-Za-z0-9][A-Za-z0-9_-]*$/.test(s)||!g||g.id!==s)throw new Error("legacy-branch-story-state-invalid");const J=Object.entries(n??{}).flatMap(([p,q])=>{const D=f(q);return D?.epic_id===s?[{...D,id:p}]:[]});if(K(g,J).mode!=="story"||g.branch_mode==="epic")throw new Error("legacy-branch-mode-invalid");if(h.status!=="backlog"&&h.status!=="ready_to_start")throw new Error("legacy-branch-story-status-invalid");if(!Array.isArray(h.steps_completed)||h.steps_completed.includes(te)||h.branch_name)throw new Error("legacy-branch-story-already-started");const v=f(c?.config)?.default_branch,I=`story/${s}/${r.storyId}`;if(typeof v!="string"||!m(e,v)||!m(e,I)||!m(e,`epic/${s}`))throw new Error("legacy-branch-ref-invalid");const E=W(e).filter(p=>p.branch===`epic/${s}`);if(E.length!==1||E[0].unsafe)throw new Error("legacy-branch-epic-worktree-unavailable");const l=y(E[0].path);if(typeof g.worktree_path=="string"&&y(O(e,g.worktree_path))!==l)throw new Error("legacy-branch-epic-worktree-mismatch");const $=p=>y(O(p,o(p,["rev-parse","--git-common-dir"])));if($(l)!==$(e)||y(o(l,["rev-parse","--show-toplevel"]))!==l||o(l,["symbolic-ref","--quiet","--short","HEAD"])!==`epic/${s}`)throw new Error("legacy-branch-worktree-identity-invalid");const Z=d(l,".neocortex/state.json");if(b(Z)!==a)throw new Error("legacy-branch-worktree-state-mismatch");if(o(l,["status","--porcelain=v1","-uall"])!=="")throw new Error("legacy-branch-worktree-dirty");const j=`refs/remotes/origin/${v}`;if(!H(l,["show-ref","--verify","--quiet",j]))throw new Error("legacy-branch-origin-ref-missing");if(A(l,["show",`${j}:.neocortex/state.json`])!==a)throw new Error("legacy-branch-origin-state-mismatch");const F=`refs/heads/${I}`;if(H(l,["show-ref","--verify","--quiet",F]))throw new Error("legacy-branch-existing-ref-needs-review");return Object.freeze({schemaVersion:1,kind:"legacy-story-branch-plan",storyId:r.storyId,epicId:s,worktreePath:l,branch:I,baseBranch:v,baseHeadSha:o(l,["rev-parse",j]),currentHeadSha:o(l,["rev-parse","HEAD"]),existingBranchHeadSha:null,stateSha256:w("sha256").update(a).digest("hex"),localOnly:!0})}function C(r){try{return{ok:!0,value:se(r)}}catch(e){return i(e instanceof Error&&e.message.startsWith("legacy-branch-")?e.message:"legacy-branch-preflight-failed")}}async function ie(r){try{const e=y(r.projectRoot);if(y(o(e,["rev-parse","--show-toplevel"]))!==e||!/^[A-Za-z0-9][A-Za-z0-9_-]*\.[A-Za-z0-9._-]+$/.test(r.storyId))return i("legacy-branch-project-root-invalid");const t=await R(e,r.storyId);return t?await z(e,t)?{ok:!0,value:t}:i("legacy-branch-completion-missing"):i("legacy-branch-intent-missing")}catch(e){return i(e instanceof Error&&e.message.startsWith("legacy-branch-")?e.message:"legacy-branch-completion-read-failed")}}async function he(r){try{const e=y(r.projectRoot),t=await ie(r);if(!t.ok)return t;const a=t.value;if(a.epicId!==r.storyId.split(".")[0]||a.branch!==`story/${a.epicId}/${r.storyId}`||!m(e,a.branch)||!m(e,a.baseBranch)||y(a.worktreePath)!==a.worktreePath)return i("legacy-branch-intent-invalid");const c=W(e).filter(s=>s.branch===a.branch);if(c.length!==1||c[0].unsafe||y(c[0].path)!==a.worktreePath)return i("legacy-branch-story-worktree-mismatch");const n=a.worktreePath,u=s=>y(O(s,o(s,["rev-parse","--git-common-dir"])));if(u(n)!==u(e)||y(o(n,["rev-parse","--show-toplevel"]))!==n||o(n,["symbolic-ref","--quiet","--short","HEAD"])!==a.branch||o(n,["rev-parse","HEAD"])!==a.baseHeadSha||o(n,["rev-parse",`refs/heads/${a.branch}`])!==a.baseHeadSha||o(n,["rev-parse",`refs/remotes/origin/${a.baseBranch}`])!==a.baseHeadSha)return i("legacy-branch-physical-identity-mismatch");const h=b(d(n,".neocortex/state.json"));return w("sha256").update(h).digest("hex")!==a.stateSha256||A(n,["show","HEAD:.neocortex/state.json"])!==h||o(n,["status","--porcelain=v1","-uall"])!==""?i("legacy-branch-physical-state-mismatch"):{ok:!0,value:Object.freeze({...a,kind:"legacy-story-branch-setup-receipt",headSha:a.baseHeadSha,reused:!0,checkpointAccepted:!1})}}catch(e){return i(e instanceof Error&&e.message.startsWith("legacy-branch-")?e.message:"legacy-branch-verification-failed")}}async function ve(r){const e=C(r);if(!e.ok){if(e.reasonCode==="legacy-branch-epic-worktree-unavailable"){const c=await he(r);return c.ok?c:e}return e}const t=`legacy-setup-${V(16).toString("hex")}`,a=await Q(r.projectRoot,{kind:"direct",storyId:r.storyId,sessionId:t,idempotencyKey:t,expiresAt:new Date(Date.now()+5*6e4).toISOString(),persistent:!1});if(!a.ok)return i(a.reasonCode);try{const c=C(r);if(!c.ok||JSON.stringify(c.value)!==JSON.stringify(e.value))return i("legacy-branch-preflight-raced");const{worktreePath:n,branch:u,baseBranch:h}=c.value;await ce(r.projectRoot,c.value),o(n,["switch","-c",u,`refs/remotes/origin/${h}`]);const s=o(n,["rev-parse","HEAD"]);return o(n,["symbolic-ref","--quiet","--short","HEAD"])!==u||s!==c.value.baseHeadSha||o(n,["status","--porcelain=v1","-uall"])!==""||w("sha256").update(b(d(n,".neocortex/state.json"))).digest("hex")!==c.value.stateSha256?i("legacy-branch-post-switch-invalid"):(await oe(r.projectRoot,c.value),{ok:!0,value:Object.freeze({...c.value,kind:"legacy-story-branch-setup-receipt",headSha:s,reused:!1,checkpointAccepted:!1})})}catch(c){return i(c instanceof Error&&c.message.startsWith("legacy-branch-")?c.message:"legacy-branch-switch-failed")}finally{await re(a.path,a.owner).catch(()=>{})}}export{C as planLegacyStoryBranchSetup,ve as prepareLegacyStoryBranchSetup,ie as readCompletedLegacyStoryBranchPlan,he as verifyLegacyStoryBranchSetup};

package/packages/client/dist/git/legacy-story-pr.d.ts

@@ -0,0 +1,514 @@
+import { type C12RemoteObservation, type C12RemoteReasonCode } from '../../../shared/dist/merge-readiness/c12-remote-observation.js';
+type Result<T> = {
+    readonly ok: true;
+    readonly value: T;
+} | {
+    readonly ok: false;
+    readonly reasonCode: string;
+};
+type Pr = {
+    readonly number: number;
+    readonly state: string;
+    readonly headRefName: string;
+    readonly headRefOid: string;
+    readonly baseRefName: string;
+    readonly url: string;
+};
+export interface LegacyStoryPrPlan {
+    readonly schemaVersion: 1;
+    readonly kind: 'legacy-story-pr-plan';
+    readonly storyId: string;
+    readonly epicId: string;
+    readonly repository: string;
+    readonly branch: string;
+    readonly baseBranch: string;
+    readonly headSha: string;
+    readonly baseSha: string;
+    readonly qaAuthority: 'root-review-required';
+    readonly localOnly: true;
+}
+export interface LegacyStorySyncPlan {
+    readonly schemaVersion: 1;
+    readonly kind: 'legacy-story-c09-sync-plan';
+    readonly storyId: string;
+    readonly epicId: string;
+    readonly repository: string;
+    readonly branch: string;
+    readonly baseBranch: string;
+    readonly headSha: string;
+    readonly baseSha: string;
+    readonly mergeBaseSha: string;
+    readonly stateSha256: string;
+    readonly storySha256: string;
+    readonly baseAlreadyAncestor: boolean;
+    readonly physicalSync: false;
+    readonly checkpointAccepted: false;
+    readonly localOnly: true;
+}
+export interface LegacyStoryCommitPlan {
+    readonly schemaVersion: 1;
+    readonly kind: 'legacy-story-c08-commit-plan';
+    readonly storyId: string;
+    readonly epicId: string;
+    readonly repository: string;
+    readonly branch: string;
+    readonly baseBranch: string;
+    readonly headSha: string;
+    readonly remoteHeadSha: null;
+    readonly baseSha: string;
+    readonly indexDigestSha256: string;
+    readonly stagedPatchSha256: string;
+    readonly changedPaths: readonly string[];
+    readonly stateSha256: string;
+    readonly storySha256: string;
+    readonly stateIndexBlobSha: string;
+    readonly storyIndexBlobSha: string;
+    readonly physicalCommit: false;
+    readonly checkpointAccepted: false;
+    readonly localOnly: true;
+}
+export interface LegacyStoryPrReceipt {
+    readonly schemaVersion: 1;
+    readonly kind: 'legacy-story-pr-provider-receipt';
+    readonly storyId: string;
+    readonly epicId: string;
+    readonly repository: string;
+    readonly branch: string;
+    readonly baseBranch: string;
+    readonly headSha: string;
+    readonly number: number;
+    readonly url: string;
+    readonly reused: boolean;
+    readonly checkpointAccepted: false;
+    readonly publicSafe: true;
+}
+export interface LegacyStoryPrProvider {
+    list(repository: string, branch: string, baseBranch: string): Promise<readonly Pr[]>;
+    create(repository: string, branch: string, baseBranch: string, title: string, bodyFile: string): Promise<void>;
+}
+export interface LegacyStoryPrMergeObservation {
+    readonly number: number;
+    readonly state: string;
+    readonly headRefName: string;
+    readonly headRefOid: string;
+    readonly baseRefName: string;
+    readonly baseRefOid: string;
+    readonly isDraft: boolean;
+    readonly mergeable: string;
+    readonly mergeCommit: {
+        readonly oid: string;
+    } | null;
+    readonly statusCheckRollup: readonly unknown[];
+    readonly url: string;
+}
+export interface LegacyStoryPrMergeProvider {
+    view(repository: string, prNumber: number): Promise<LegacyStoryPrMergeObservation>;
+    /** Immediate merge with a provider-enforced expected PR head, never auto-merge. */
+    merge(repository: string, prNumber: number, expectedHeadSha: string): Promise<void>;
+}
+export interface LegacyStoryIssueProvider {
+    view(repository: string, issueNumber: number): Promise<{
+        readonly number: number;
+        readonly title: string;
+        readonly state: string;
+        readonly url: string;
+    }>;
+}
+export interface LegacyStoryIssueCloser extends LegacyStoryIssueProvider {
+    close(repository: string, issueNumber: number): Promise<void>;
+}
+/** Root-owned C08 basis. Only a cleanly staged, same-story write set may
+ * cross into a future physical commit. This plan neither commits nor pushes. */
+export declare function planLegacyStoryCommitC08(options: {
+    readonly projectRoot: string;
+    readonly storyId: string;
+}): Result<LegacyStoryCommitPlan>;
+export interface LegacyStoryCommitReceipt {
+    readonly schemaVersion: 1;
+    readonly kind: 'legacy-story-c08-commit-accepted';
+    readonly storyId: string;
+    readonly epicId: string;
+    readonly branch: string;
+    readonly checkpointHeadSha: string;
+    readonly qaSha256: string;
+    readonly reused: boolean;
+    readonly physicalCommit: true;
+    readonly checkpointAccepted: true;
+    readonly publicSafe: true;
+}
+/** Root-owned C08 effect: one locally committed story checkpoint, full P205 on
+ * that immutable HEAD, then a first non-force remote push and exact readback. */
+export declare function acceptLegacyStoryCommitC08(options: {
+    readonly projectRoot: string;
+    readonly storyId: string;
+    readonly authorize: boolean;
+    /** Synthetic seams; the productive CLI uses durable C01 proof and complete P205. */
+    readonly verifyC01?: () => Promise<boolean>;
+    readonly verifyQa?: (headSha: string) => Promise<string>;
+    readonly afterStateWrite?: () => Promise<void>;
+    readonly afterCommit?: () => Promise<void>;
+    readonly afterPush?: () => Promise<void>;
+}): Promise<Result<LegacyStoryCommitReceipt>>;
+/** Read-only C09 basis. A merge-base observation is not a synchronized story:
+ * only a later root-owned Git/state checkpoint may turn C08 into C09. */
+export declare function planLegacyStorySyncC09(options: {
+    readonly projectRoot: string;
+    readonly storyId: string;
+}): Result<LegacyStorySyncPlan>;
+export interface LegacyStorySyncReceipt {
+    readonly schemaVersion: 1;
+    readonly kind: 'legacy-story-c09-sync-accepted';
+    readonly storyId: string;
+    readonly epicId: string;
+    readonly branch: string;
+    readonly baseSha: string;
+    readonly checkpointHeadSha: string;
+    readonly qaSha256: string;
+    readonly reused: boolean;
+    readonly physicalSync: true;
+    readonly checkpointAccepted: true;
+    readonly publicSafe: true;
+}
+/** Root-only C09 physical sync. The merge and checkpoint are prepared in a
+ * detached private worktree; the live story branch moves only after candidate
+ * QA and an exact non-force remote readback. An interrupted push is reconciled
+ * from the private intent rather than replaying the merge. */
+export declare function acceptLegacyStorySyncC09(options: {
+    readonly projectRoot: string;
+    readonly storyId: string;
+    readonly authorize: boolean;
+    /** Synthetic seam; productive CLI always runs the complete P205 gate. */
+    readonly verifyQa?: (plan: LegacyStoryPrPlan) => Promise<string>;
+    readonly afterCommit?: () => Promise<void>;
+    readonly afterPush?: () => Promise<void>;
+}): Promise<Result<LegacyStorySyncReceipt>>;
+export declare function planLegacyStoryPr(options: {
+    readonly projectRoot: string;
+    readonly storyId: string;
+}): Result<LegacyStoryPrPlan>;
+export declare function createLegacyStoryPr(options: {
+    readonly projectRoot: string;
+    readonly storyId: string;
+    readonly bodyFile: string;
+    readonly authorize: boolean;
+    readonly provider?: LegacyStoryPrProvider;
+    /** Synthetic test seam. The productive CLI always executes the P205 complete gate. */
+    readonly verifyQa?: (plan: LegacyStoryPrPlan) => Promise<string>;
+}): Promise<Result<LegacyStoryPrReceipt>>;
+export interface LegacyStoryC10CheckpointReceipt {
+    readonly schemaVersion: 1;
+    readonly kind: 'legacy-story-c10-checkpoint';
+    readonly storyId: string;
+    readonly epicId: string;
+    readonly branch: string;
+    readonly repository: string;
+    readonly number: number;
+    readonly url: string;
+    readonly headSha: string;
+    readonly stateSha256: string;
+    readonly storySha256: string;
+    readonly reused: boolean;
+    readonly checkpointAccepted: true;
+    readonly localOnly: true;
+}
+/** Accepts only an exact, still-open provider PR after physical local QA. */
+export declare function acceptLegacyStoryPrC10(options: {
+    readonly projectRoot: string;
+    readonly storyId: string;
+    readonly prNumber: number;
+    readonly provider?: LegacyStoryPrProvider;
+    /** Synthetic test seam. The productive CLI always executes the P205 complete gate. */
+    readonly verifyQa?: (plan: LegacyStoryPrPlan) => Promise<string>;
+    readonly afterStatePersist?: () => Promise<void>;
+    readonly afterStoryPersist?: () => Promise<void>;
+}): Promise<Result<LegacyStoryC10CheckpointReceipt>>;
+/** Read-only C10 predecessor for the root-owned C11 review. */
+export declare function readAcceptedLegacyStoryPrC10(options: {
+    readonly projectRoot: string;
+    readonly storyId: string;
+    readonly prNumber: number;
+    readonly provider?: LegacyStoryPrProvider;
+}): Promise<Result<{
+    readonly plan: LegacyStoryPrPlan;
+    readonly receipt: LegacyStoryC10CheckpointReceipt;
+}>>;
+export interface LegacyStoryPrReviewPlan {
+    readonly schemaVersion: 1;
+    readonly kind: 'legacy-story-pr-review-plan';
+    readonly storyId: string;
+    readonly epicId: string;
+    readonly repository: string;
+    readonly branch: string;
+    readonly baseBranch: string;
+    readonly baseSha: string;
+    readonly headSha: string;
+    readonly prNumber: number;
+    readonly diffSha256: string;
+    readonly changedPaths: readonly string[];
+    readonly checkpointAccepted: false;
+    readonly localOnly: true;
+}
+export interface LegacyStoryC11CheckpointReceipt {
+    readonly schemaVersion: 1;
+    readonly kind: 'legacy-story-c11-checkpoint';
+    readonly storyId: string;
+    readonly epicId: string;
+    readonly branch: string;
+    readonly prNumber: number;
+    readonly headSha: string;
+    readonly reviewSha256: string;
+    readonly qaSha256: string;
+    readonly stateSha256: string;
+    readonly storySha256: string;
+    readonly reused: boolean;
+    readonly checkpointAccepted: true;
+    readonly localOnly: true;
+}
+export declare function planLegacyStoryPrReview(options: {
+    readonly projectRoot: string;
+    readonly storyId: string;
+    readonly prNumber: number;
+    readonly provider?: LegacyStoryPrProvider;
+}): Promise<Result<LegacyStoryPrReviewPlan>>;
+/** Root-only C11 acceptance. The caller supplies an independently reviewed,
+ * public-safe report; neither the server selection nor a sandbox return can
+ * approve this checkpoint. It never commits, pushes, or merges the PR. */
+export declare function acceptLegacyStoryPrReviewC11(options: {
+    readonly projectRoot: string;
+    readonly storyId: string;
+    readonly prNumber: number;
+    readonly reportFile: string;
+    readonly authorize: boolean;
+    readonly provider?: LegacyStoryPrProvider;
+    /** Synthetic seam; the productive CLI always executes the P205 complete gate. */
+    readonly verifyQa?: (plan: LegacyStoryPrPlan) => Promise<string>;
+    readonly afterStatePersist?: () => Promise<void>;
+    readonly afterStoryPersist?: () => Promise<void>;
+}): Promise<Result<LegacyStoryC11CheckpointReceipt>>;
+/** Independent readback for the eventual C12 integration boundary. A saved
+ * status or provider PR alone is never a review verdict. */
+export declare function readAcceptedLegacyStoryPrReviewC11(options: {
+    readonly projectRoot: string;
+    readonly storyId: string;
+    readonly prNumber: number;
+    readonly provider?: LegacyStoryPrProvider;
+}): Promise<Result<{
+    readonly plan: LegacyStoryPrReviewPlan;
+    readonly receipt: LegacyStoryC11CheckpointReceipt;
+}>>;
+export interface LegacyStoryPrMergePlan {
+    readonly schemaVersion: 1;
+    readonly kind: 'legacy-story-pr-merge-plan';
+    readonly storyId: string;
+    readonly epicId: string;
+    readonly repository: string;
+    readonly branch: string;
+    readonly baseBranch: string;
+    readonly baseSha: string;
+    readonly originalHeadSha: string;
+    readonly prNumber: number;
+    readonly reviewArtifactPath: string;
+    readonly reviewArtifactSha256: string;
+    readonly reviewSha256: string;
+    readonly qaSha256: string;
+    readonly stateSha256: string;
+    readonly storySha256: string;
+    readonly nextAuthority: 'root-review-commit-and-new-head-qa-required';
+    readonly physicalMerge: false;
+    readonly localOnly: true;
+}
+/** Plan only: the old PR is not ready for physical merge while C10/C11 remain
+ * uncommitted. This validates the exact review artifact to integrate next. */
+export declare function planLegacyStoryPrMergeC12(options: {
+    readonly projectRoot: string;
+    readonly storyId: string;
+    readonly prNumber: number;
+    readonly provider?: LegacyStoryPrProvider;
+}): Promise<Result<LegacyStoryPrMergePlan>>;
+export interface LegacyStoryPrPreparedReceipt {
+    readonly schemaVersion: 1;
+    readonly kind: 'legacy-story-c12-prepared';
+    readonly storyId: string;
+    readonly epicId: string;
+    readonly branch: string;
+    readonly prNumber: number;
+    readonly originalHeadSha: string;
+    readonly candidateHeadSha: string;
+    readonly qaSha256: string;
+    readonly reused: boolean;
+    readonly physicalMerge: false;
+    readonly localOnly: true;
+}
+/** Commit only the reviewed C10/C11 metadata and public review artifact to
+ * the existing PR branch, then run P205 on that new immutable HEAD and push
+ * without force. This prepares C12; it does not merge or close the story. */
+export declare function prepareLegacyStoryPrMergeC12(options: {
+    readonly projectRoot: string;
+    readonly storyId: string;
+    readonly prNumber: number;
+    readonly authorize: boolean;
+    readonly provider?: LegacyStoryPrProvider;
+    /** Synthetic seam; the productive CLI always executes the P205 complete gate. */
+    readonly verifyQa?: (plan: LegacyStoryPrPlan) => Promise<string>;
+    readonly afterCommit?: () => Promise<void>;
+    readonly afterPush?: () => Promise<void>;
+}): Promise<Result<LegacyStoryPrPreparedReceipt>>;
+export interface LegacyStoryPrMergedReceipt {
+    readonly schemaVersion: 1;
+    readonly kind: 'legacy-story-c12-merged';
+    readonly storyId: string;
+    readonly epicId: string;
+    readonly prNumber: number;
+    readonly branch: string;
+    readonly candidateHeadSha: string;
+    readonly mergeCommitSha: string;
+    readonly baseHeadSha: string;
+    readonly qaSha256: string;
+    readonly remoteObservationDigest: string;
+    readonly reused: boolean;
+    readonly physicalMerge: true;
+    readonly checkpointAccepted: false;
+    readonly localOnly: true;
+}
+/** Narrow root review gate until the scoped-CI debt adapter is integrated.
+ * Non-blocking remote findings cannot be silently omitted or treated as green. */
+export interface LegacyStoryPrRootMergeDecision {
+    readonly schemaVersion: 1;
+    readonly kind: 'legacy-story-c12-root-merge-decision';
+    readonly storyId: string;
+    readonly epicId: string;
+    readonly prNumber: number;
+    readonly candidateHeadSha: string;
+    readonly baseSha: string;
+    readonly reviewSha256: string;
+    readonly remoteObservationDigest: string;
+    readonly canMerge: true;
+    readonly blockingChecks: readonly [];
+    readonly nonBlockingChecks: readonly [];
+    readonly followUpDebt: readonly [];
+}
+export interface LegacyStoryPrRemoteDebtPlan {
+    readonly schemaVersion: 1;
+    readonly kind: 'legacy-story-c12-remote-debt-required';
+    readonly storyId: string;
+    readonly epicId: string;
+    readonly prNumber: number;
+    readonly candidateHeadSha: string;
+    readonly baseSha: string;
+    readonly reviewSha256: string;
+    readonly remoteObservationDigest: string;
+    readonly reasonCodes: readonly C12RemoteReasonCode[];
+    readonly reasonCounts: C12RemoteObservation['reasonCounts'];
+    readonly canMerge: false;
+    readonly publicSafe: true;
+}
+export interface LegacyStoryPrRemoteDebtReceipt {
+    readonly schemaVersion: 1;
+    readonly kind: 'legacy-story-c12-remote-debt-journaled';
+    readonly storyId: string;
+    readonly epicId: string;
+    readonly prNumber: number;
+    readonly candidateHeadSha: string;
+    readonly remoteObservationDigest: string;
+    readonly reasonCodes: readonly C12RemoteReasonCode[];
+    readonly reasonCounts: C12RemoteObservation['reasonCounts'];
+    readonly reused: boolean;
+    readonly durableObservation: true;
+    readonly registryRecorded: false;
+    readonly canMerge: false;
+    readonly publicSafe: true;
+}
+/** Root-only readback of the prepared PR candidate. This produces a closed
+ * decision only for a categorized clean rollup, otherwise a non-authorizing
+ * debt plan. It neither persists debt, runs QA nor merges. */
+export declare function planLegacyStoryPrMergeDecisionC12(options: {
+    readonly projectRoot: string;
+    readonly storyId: string;
+    readonly prNumber: number;
+    readonly provider?: LegacyStoryPrProvider;
+    readonly mergeProvider?: LegacyStoryPrMergeProvider;
+}): Promise<Result<LegacyStoryPrRootMergeDecision | LegacyStoryPrRemoteDebtPlan>>;
+/** Persist an exact categorized remote observation before any C12 effect.
+ * This is a private replay-safe evidence journal, not the canonical scoped-CI
+ * registry writer and never merge authorization. */
+export declare function recordLegacyStoryPrRemoteDebtC12(options: {
+    readonly projectRoot: string;
+    readonly storyId: string;
+    readonly prNumber: number;
+    readonly provider?: LegacyStoryPrProvider;
+    readonly mergeProvider?: LegacyStoryPrMergeProvider;
+}): Promise<Result<LegacyStoryPrRemoteDebtReceipt>>;
+/** One root-owned immediate provider merge attempt. An uncertain effect is
+ * never retried automatically; later calls only reconcile physical truth. */
+export declare function mergeLegacyStoryPrC12(options: {
+    readonly projectRoot: string;
+    readonly storyId: string;
+    readonly prNumber: number;
+    readonly authorize: boolean;
+    readonly provider?: LegacyStoryPrProvider;
+    readonly mergeProvider?: LegacyStoryPrMergeProvider;
+    readonly rootDecision?: LegacyStoryPrRootMergeDecision;
+    /** Synthetic seam; the productive CLI always executes the complete P205 gate. */
+    readonly verifyQa?: (plan: LegacyStoryPrPlan) => Promise<string>;
+    readonly afterMerge?: () => Promise<void>;
+}): Promise<Result<LegacyStoryPrMergedReceipt>>;
+export interface LegacyStoryPrPostMergePlan {
+    readonly schemaVersion: 1;
+    readonly kind: 'legacy-story-c12-post-merge-plan';
+    readonly storyId: string;
+    readonly epicId: string;
+    readonly repository: string;
+    readonly baseBranch: string;
+    readonly prNumber: number;
+    readonly issueNumber: number;
+    readonly candidateHeadSha: string;
+    readonly mergeCommitSha: string;
+    readonly stateSha256: string;
+    readonly storySha256: string;
+    readonly nextAuthority: 'root-state-checkpoint-and-issue-closure-required';
+    readonly checkpointAccepted: false;
+    readonly localOnly: true;
+}
+/** A provider's MERGED flag is not the C12 state checkpoint. This read-only
+ * preflight requires the exact merge commit at the current base HEAD, the
+ * accepted C11 bytes, and the still-open same-story issue before any write. */
+export declare function planLegacyStoryPrPostMergeC12(options: {
+    readonly projectRoot: string;
+    readonly storyId: string;
+    readonly prNumber: number;
+    readonly mergeProvider?: LegacyStoryPrMergeProvider;
+    readonly issueProvider?: LegacyStoryIssueProvider;
+}): Promise<Result<LegacyStoryPrPostMergePlan>>;
+export interface LegacyStoryPrPostMergeReceipt {
+    readonly schemaVersion: 1;
+    readonly kind: 'legacy-story-c12-post-merge-accepted';
+    readonly storyId: string;
+    readonly epicId: string;
+    readonly prNumber: number;
+    readonly issueNumber: number;
+    readonly mergeCommitSha: string;
+    readonly checkpointHeadSha: string;
+    readonly qaSha256: string;
+    readonly reused: boolean;
+    readonly physicalMerge: true;
+    readonly issueClosed: true;
+    readonly checkpointAccepted: true;
+    readonly publicSafe: true;
+}
+/** Root-owned C12 terminal checkpoint. The private intent precedes issue close,
+ * which is re-read on replay. A story becomes done only after an exact two-file
+ * base commit, fresh P205, non-force push and provider/issue readback. */
+export declare function acceptLegacyStoryPrPostMergeC12(options: {
+    readonly projectRoot: string;
+    readonly storyId: string;
+    readonly prNumber: number;
+    readonly authorize: boolean;
+    readonly mergeProvider?: LegacyStoryPrMergeProvider;
+    readonly issueProvider?: LegacyStoryIssueCloser;
+    /** Synthetic seam; the productive CLI always runs P205 on checkpoint HEAD. */
+    readonly verifyQa?: (plan: LegacyStoryPrPlan) => Promise<string>;
+    readonly afterIssueClose?: () => Promise<void>;
+    readonly afterCommit?: () => Promise<void>;
+    readonly afterPush?: () => Promise<void>;
+}): Promise<Result<LegacyStoryPrPostMergeReceipt>>;
+export {};