@ornexus/neocortex 4.60.66 → 4.60.68

package/packages/client/dist/state/project-state-snapshot.js

@@ -1 +1,1677 @@
-import{createHash as H}from"node:crypto";import{analyzeDependencyDag as I,StructuralDagError as y}from"./structural-dag-projection.js";import{classifyInvocationShapeV2 as O}from"./invocation-shape.js";const U=12,J=16,k=["active","archived","rolled-back","synthetic","orphan"],Q=new Set(["in-progress","branch-ready","diagnose","research","write-spec","create-tasks","implemented","refactor-suggest-done","property-tests-emitted","tests-validated","qa-gate-passed","memory-updated","committed","synced","pr-created","pr-reviewed","partial"]),n=(r,e,t={})=>({commandId:r,stateProjectionPolicy:e,...t}),A=Object.freeze({status:n("status","full"),"arch-plan":n("arch-plan","full"),"arch-prd":n("arch-prd","full"),"arch-architecture":n("arch-architecture","epic-targeted",{structuralRequired:!0}),"arch-api-contracts":n("arch-api-contracts","epic-targeted",{structuralRequired:!0}),"arch-api-integrations":n("arch-api-integrations","epic-targeted",{structuralRequired:!0}),"arch-database":n("arch-database","epic-targeted",{structuralRequired:!0}),"arch-security":n("arch-security","epic-targeted",{structuralRequired:!0}),"arch-design-system":n("arch-design-system","epic-targeted",{structuralRequired:!0}),"arch-ux-design":n("arch-ux-design","epic-targeted",{structuralRequired:!0}),"arch-performance":n("arch-performance","epic-targeted",{structuralRequired:!0}),"arch-testing":n("arch-testing","epic-targeted",{structuralRequired:!0}),"arch-infrastructure":n("arch-infrastructure","epic-targeted",{structuralRequired:!0}),"arch-review":n("arch-review","epic-targeted",{structuralRequired:!0}),"arch-fitness-functions":n("arch-fitness-functions","epic-targeted",{structuralRequired:!0}),"create-epic":n("create-epic","epic-summary"),"idea-diagnose":n("idea-diagnose","full"),"idea-research":n("idea-research","epic-targeted",{structuralRequired:!0}),"generate-epic":n("generate-epic","epic-targeted",{structuralRequired:!0}),exec:n("exec","story-targeted",{structuralRequired:!0}),yolo:n("yolo","story-targeted",{structuralRequired:!0}),"yolo-inline":n("yolo-inline","story-targeted",{structuralRequired:!0}),epic:n("epic","epic-targeted",{structuralRequired:!0}),"setup-branch":n("setup-branch","story-targeted",{structuralRequired:!0}),diagnose:n("diagnose","adaptive-targeted"),"diagnose-inline":n("diagnose-inline","full"),research:n("research","adaptive-targeted"),"research-inline":n("research-inline","full"),"write-spec":n("write-spec","story-targeted",{structuralRequired:!0}),"create-tasks":n("create-tasks","story-targeted",{structuralRequired:!0}),implement:n("implement","story-targeted",{structuralRequired:!0}),commit:n("commit","story-targeted",{structuralRequired:!0}),"commit-push":n("commit","story-targeted",{structuralRequired:!0}),sync:n("sync","story-targeted",{structuralRequired:!0}),"sync-main":n("sync","story-targeted",{structuralRequired:!0}),"create-pr":n("create-pr","story-targeted",{structuralRequired:!0}),review:n("review","story-targeted"),"review-pr":n("review","story-targeted"),merge:n("merge","story-targeted",{structuralRequired:!0}),"merge-pr":n("merge","story-targeted",{structuralRequired:!0}),"fix-blocked":n("fix-blocked","story-targeted"),"finalize-epic":n("finalize-epic","epic-targeted"),"resolve-conflicts":n("resolve-conflicts","story-targeted"),"update-memory":n("update-memory","full"),"update-project-memory":n("update-memory","story-targeted",{structuralRequired:!0}),refactor:n("refactor","adaptive-targeted"),"refactor-suggest":n("refactor","story-targeted",{structuralRequired:!0}),cleanup:n("cleanup","full"),audit:n("audit","full"),"tech-debt":n("tech-debt","full"),menu:n("menu","full"),plans:n("plans","full"),billing:n("billing","full"),subscribe:n("subscribe","full"),"qa-scan":n("qa-scan","full"),yoloop:n("yoloop","yoloop-targeted",{structuralRequired:!0}),"migrate-state":n("migrate-state","full"),"migrate-project-id":n("migrate-project-id","full"),"policy-audit":n("policy-audit","full"),"mutation-test":n("mutation-test","full"),"sync-openapi":n("sync-openapi","full"),"generate-pacts":n("generate-pacts","full"),"verify-pacts":n("verify-pacts","full"),"property-test":n("property-test","full"),"property-tests":n("property-test","story-targeted",{structuralRequired:!0}),"chaos-plan":n("chaos-plan","full"),"ui-ux-review":n("ui-ux-review","adaptive-targeted"),"solyd-system":n("solyd-system","adaptive-targeted"),goal:n("goal","continuity-scoped"),loop:n("loop","continuity-scoped"),jobs:n("jobs","continuity-scoped"),runner:n("runner","continuity-scoped"),"goal-tick":n("goal-tick","continuity-scoped"),"loop-tick":n("loop-tick","continuity-scoped"),"validate-tests":n("validate-tests","story-targeted",{structuralRequired:!0}),"qa-gate":n("qa-gate","story-targeted",{structuralRequired:!0})}),X=Object.freeze({st:"status",arquitetura:"arch-plan",architecture:"arch-plan",arch:"arch-plan",prd:"arch-prd","product-requirements":"arch-prd","arch-doc":"arch-architecture","tech-architecture":"arch-architecture","api-contracts":"arch-api-contracts","api-contract":"arch-api-contracts","api-integrations":"arch-api-integrations","api-int":"arch-api-integrations","database-schema":"arch-database","db-schema":"arch-database",db:"arch-database","cyber-security":"arch-security",security:"arch-security",sec:"arch-security","design-system":"arch-design-system",ds:"arch-design-system","atomic-design":"arch-design-system","ux-design":"arch-ux-design",ux:"arch-ux-design",wireframes:"arch-ux-design",wireframe:"arch-ux-design","user-flows":"arch-ux-design",performance:"arch-performance",perf:"arch-performance","capacity-planning":"arch-performance",capacity:"arch-performance","arch-perf":"arch-performance","performance-strategy":"arch-performance","testing-strategy":"arch-testing","test-plan":"arch-testing","test-strategy":"arch-testing","arch-test":"arch-testing",infrastructure:"arch-infrastructure",infra:"arch-infrastructure","deploy-plan":"arch-infrastructure",deployment:"arch-infrastructure","arch-infra":"arch-infrastructure","arch-deploy":"arch-infrastructure","review-consolidation":"arch-review",consolidation:"arch-review","architecture-review":"arch-review","arch-consolidation":"arch-review",fitness:"arch-fitness-functions","fitness-functions":"arch-fitness-functions",archfit:"arch-fitness-functions","arch-fit":"arch-fitness-functions","fit-funcs":"arch-fitness-functions","criar-epic":"create-epic",planejamento:"create-epic","idea-diag":"idea-diagnose","idea-pesq":"idea-research","gerar-epic":"generate-epic",executar:"exec",pipeline:"exec","parallel-epic":"epic",setup:"setup-branch",branch:"setup-branch",diag:"diagnose",diagnostico:"diagnose",c02:"diagnose",pesquisar:"research",pesq:"research","research-fix":"research",c03:"research",spec:"write-spec",especificacao:"write-spec",c04:"write-spec",tasks:"create-tasks",tarefas:"create-tasks",c05:"create-tasks",impl:"implement",implementar:"implement",c06:"implement",push:"commit",commit_push:"commit",cp:"commit",c07:"commit",sincronizar:"sync",c08:"sync",pr:"create-pr",c09:"create-pr",revisar:"review",c11:"review",mesclar:"merge",c12:"merge",fix:"fix-blocked",corrigir:"fix-blocked",finalizar:"finalize-epic",conflitos:"resolve-conflicts",memoria:"update-memory",refactoring:"refactor",refact:"refactor",refac:"refactor",rf:"refactor","cleanup-code":"refactor","code-cleanup":"refactor","code-quality":"refactor","improve-code":"refactor",modernize:"refactor",modernization:"refactor",legacy:"refactor","legacy-code":"refactor","debt-pay":"refactor","pay-debt":"refactor","debt-reduction":"refactor","smell-fix":"refactor","fix-smells":"refactor","code-smells":"refactor",strangler:"refactor","strangler-fig":"refactor",limpar:"cleanup",limpeza:"cleanup",auditar:"audit",auditoria:"audit",debt:"tech-debt",debts:"tech-debt","debt-list":"tech-debt","tech-debts":"tech-debt",td:"tech-debt",help:"menu",ajuda:"menu","?":"menu",commands:"menu",cmds:"menu",planos:"plans",pricing:"plans",bill:"billing",subscription:"billing",sub:"billing",upgrade:"subscribe",checkout:"subscribe",qa:"qa-scan","qa-test":"qa-scan","visual-qa":"qa-scan","e2e-scan":"qa-scan",troubleshoot:"qa-scan","debug-ui":"qa-scan",scan:"qa-scan",a11y:"qa-scan",accessibility:"qa-scan",wcag:"qa-scan","auto-yolo":"yoloop","epic-runner":"yoloop","story-runner":"yoloop","loop-yolo":"yoloop","auto-epic":"yoloop",migrate:"migrate-state","state-migrate":"migrate-state","schema-migrate":"migrate-state",policy:"policy-audit","audit-policy":"policy-audit","policy-history":"policy-audit",policies:"policy-audit",mutation:"mutation-test",stryker:"mutation-test","kill-mutants":"mutation-test","openapi-sync":"sync-openapi","api-sync":"sync-openapi","spec-sync":"sync-openapi","regen-openapi":"sync-openapi",pacts:"generate-pacts","gen-pacts":"generate-pacts","regen-pacts":"generate-pacts","create-pacts":"generate-pacts","verify-pact":"verify-pacts","pact-verify":"verify-pacts","check-pacts":"verify-pacts","pact-check":"verify-pacts",property:"property-test",pbt:"property-test",proptest:"property-test","invariant-test":"property-test",chaos:"chaos-plan",gameday:"chaos-plan","resilience-test":"chaos-plan","ux-review":"ui-ux-review","design-review":"ui-ux-review","visual-review":"ui-ux-review","product-polish":"ui-ux-review","security-system":"solyd-system","authorized-security":"solyd-system","sec-system":"solyd-system",goals:"goal","durable-goal":"goal","continuity-goal":"goal",loops:"loop","durable-loop":"loop","continuity-loop":"loop",job:"jobs","continuity-jobs":"jobs","neocortex-runner":"runner","continuity-runner":"runner"}),ee=Object.freeze({1:"status",3:"arch-plan",4:"arch-prd",5:"arch-architecture",6:"arch-api-contracts",7:"arch-api-integrations",8:"arch-database",9:"arch-security",10:"arch-design-system",11:"arch-ux-design",12:"arch-performance",13:"arch-testing",14:"arch-infrastructure",15:"arch-review",16:"arch-fitness-functions",17:"create-epic",18:"idea-diagnose",19:"idea-research",20:"generate-epic",21:"exec",22:"yolo",23:"epic",24:"setup-branch",25:"diagnose",26:"research",27:"write-spec",28:"create-tasks",29:"implement",30:"commit",31:"sync",32:"create-pr",33:"review",34:"merge",35:"fix-blocked",36:"finalize-epic",37:"resolve-conflicts",38:"update-memory",39:"refactor",40:"cleanup",41:"audit",42:"tech-debt",43:"menu",44:"plans",45:"billing",46:"subscribe",47:"qa-scan",48:"yoloop",49:"migrate-state",50:"policy-audit",51:"mutation-test",52:"sync-openapi",53:"generate-pacts",54:"verify-pacts",55:"property-test",56:"chaos-plan",57:"ui-ux-review",58:"solyd-system",59:"goal",60:"loop",61:"jobs",62:"runner"});function d(r,e=120){if(typeof r!="string")return;const t=r.trim();if(t)return t.replace(/[^a-z0-9_.:-]+/gi,"_").slice(0,e)}function w(r,e=120){if(typeof r!="string")return;const t=r.trim(),i=d(r,e);return i===t?i:void 0}function T(r){if(typeof r!="string")return;const e=r.trim();if(!(!e||e.length>240||!/^[A-Za-z0-9][A-Za-z0-9._/-]*$/.test(e)||e.includes("..")||e.includes("//")||e.includes("@{")||e.endsWith("/")||e.endsWith(".")||e.split("/").some(t=>!t||t.startsWith(".")||t.endsWith(".lock"))))return e}function te(r){if(typeof r!="string")return;const e=r.replace(/\\/g,"/");if(!(!e||e.length>240||e.startsWith("/")||/^[A-Za-z]:/.test(e)||e.includes("..")||e.includes("//")||e.split("/").includes(".")||!/^[A-Za-z0-9._/:@#-]+$/.test(e)))return e}function S(r){if(r===void 0||!Array.isArray(r)||r.length>128)return;const e=r.map(te);if(!e.some(t=>t===void 0))return[...new Set(e)].sort((t,i)=>t.localeCompare(i,"en"))}function re(r){return typeof r=="string"&&Q.has(r.trim().toLowerCase().replace(/_/g,"-"))}function C(r,e){const t={};for(const i of e){const c=r[i];typeof c=="string"||typeof c=="boolean"||typeof c=="number"&&Number.isFinite(c)?t[i]=c:Array.isArray(c)&&c.every(o=>typeof o=="string")&&(t[i]=[...c])}return t}function ie(r,e){const t=e.checkpoint;if(!h(t)||t.schemaVersion!==1||t.storyId!==r||t.epicId!==e.epic_id||!T(t.branch)||typeof t.baseSha!="string"||!/^[0-9a-f]{7,64}$/i.test(t.baseSha)||typeof t.headSha!="string"||!/^[0-9a-f]{7,64}$/i.test(t.headSha)||t.baseSha===t.headSha||!w(t.idempotencyKey)||typeof t.recordedAt!="string"||!Number.isFinite(Date.parse(t.recordedAt))||!Array.isArray(t.commits)||t.commits.length===0||t.commits.length>256||t.commits.some(c=>typeof c!="string"||!/^[0-9a-f]{7,64}$/i.test(c))||!Array.isArray(t.receiptRefs)||t.receiptRefs.length===0||t.receiptRefs.length>256||t.receiptRefs.some(c=>typeof c!="string"||c.length>240||c.includes("..")||!/^[A-Za-z0-9._:/#\-[\]]+$/.test(c))||!h(t.qaReceipt)||t.qaReceipt.kind!=="story_qa_evidence"||t.qaReceipt.producer!=="local-yolo-tdd"||!["passed","blocked"].includes(String(t.qaVerdict))||!["approved","changes-requested","pending"].includes(String(t.reviewVerdict))||(t.reviewVerdict==="pending"?t.reviewReceipt!==void 0:!h(t.reviewReceipt)))return;const i=C(t,["schemaVersion","storyId","epicId","branch","baseSha","headSha","idempotencyKey","dispatchId","bundleId","bundleDigest","graphRevision","claimRevision","qaVerdict","reviewVerdict","recordedAt","commits","receiptRefs"]);return i.qaReceipt=C(t.qaReceipt,["schemaVersion","kind","producer","evidenceVersion","storyId","epicId","contract","command","manifestDigest","gateIds","resultDigest","baseSha","headSha","bundleDigest","graphRevision","sourceEvidenceDigest","verdict","checkedAt","receiptRef"]),h(t.reviewReceipt)&&(i.reviewReceipt=C(t.reviewReceipt,["schemaVersion","kind","producer","storyId","epicId","baseSha","headSha","bundleDigest","graphRevision","sourceEvidenceDigest","qaReceiptRef","verdict","reviewedAt","receiptRef"])),i}function ce(r,e){const t=e.checkpoint_verification;if(!(!h(t)||t.schemaVersion!==1||t.kind!=="story_checkpoint_physical_verification"||t.producer!=="client-p205-transient-v1"||t.publicSafe!==!0||t.storyId!==r||t.epicId!==e.epic_id||!["verified","rejected"].includes(String(t.verdict))))return C(t,["schemaVersion","kind","producer","storyId","epicId","branch","baseSha","headSha","aggregateHeadSha","commitBodyDigest","changedPathsDigest","claimVerification","effectiveClaimRevision","command","manifestDigest","gateIds","resultDigest","graphRevision","executionEvidenceDigest","sourceEvidenceDigest","verifiedAt","verdict","reasonCodes","publicSafe"])}function M(r,e){const t=e.scheduling_checkpoint_evidence,i=new Set(["schemaVersion","kind","producer","storyId","epicId","branch","baseSha","headSha","graphRevision","effectiveClaimRevision","sourceEvidenceDigest","verifiedAt","reasonCodes","integrationAuthorized","publicSafe"]);if(!(!h(t)||Object.keys(t).some(c=>!i.has(c))||t.schemaVersion!==1||t.kind!=="story_scheduling_checkpoint_evidence"||t.producer!=="client-git-physical-v1"||t.publicSafe!==!0||t.integrationAuthorized!==!1||t.storyId!==r||t.epicId!==e.epic_id||!T(t.branch)||typeof t.baseSha!="string"||!/^[0-9a-f]{40,64}$/i.test(t.baseSha)||typeof t.headSha!="string"||!/^[0-9a-f]{40,64}$/i.test(t.headSha)||typeof t.graphRevision!="string"||!/^[0-9a-f]{64}$/i.test(t.graphRevision)||typeof t.effectiveClaimRevision!="string"||!/^[0-9a-f]{64}$/i.test(t.effectiveClaimRevision)||typeof t.sourceEvidenceDigest!="string"||!/^[0-9a-f]{64}$/i.test(t.sourceEvidenceDigest)||typeof t.verifiedAt!="string"||!Number.isFinite(Date.parse(t.verifiedAt))||!Array.isArray(t.reasonCodes)||t.reasonCodes.length!==1||t.reasonCodes[0]!=="checkpoint-git-scheduling-verified"))return C(t,[...i])}function oe(r,e){const t={...e},i=M(r,e);return i?(t.scheduling_checkpoint_evidence=i,delete t.checkpoint,delete t.checkpoint_verification):delete t.scheduling_checkpoint_evidence,t}function h(r){return r!==null&&typeof r=="object"&&!Array.isArray(r)}function _(...r){const e=new Set,t=[];for(const i of r)for(const c of i??[]){const o=d(c,80);if(!(!o||e.has(o))&&(e.add(o),t.push(o),t.length>=J))return t}return t}function ne(r){return r.trim().replace(/^@?\*/,"").replace(/^@/,"").toLowerCase()}function se(r){return r.trim().split(/\s+/,1)[0]??""}function z(r){if(/^@epic-P[0-9]{1,12}$/.test(r.trim()))return A.epic;const e=se(r);if(!e)return A.menu;const t=ne(e),i=ee[t]??X[t]??t;return A[i]??null}function ae(r,e,t,i="full-compatible",c=["full-state"]){return{kind:"full",commandId:t?.commandId??null,stateProjectionPolicy:t?.stateProjectionPolicy??null,projectionMode:i,trigger:r,targetEpicId:null,targetStoryId:null,includedStoryCount:Object.keys(e.stories).length,includedEpicCount:Object.keys(e.epics).length,omittedStoryCount:0,omittedEpicCount:0,reason:"full-state",reasonCodes:_(c)}}function ze(r,e,t,i="full-compatible",c=["full-state"]){const o=ae(r,e,t,i,c);return v({...e,scope:o},e,o)}function de(r){const[e]=r.trim().split(/\s+/,1);return e?/^[A-Z]?\d+(?:\.\d+)+$/i.test(e.replace(/^@/,""))||/(?:^|\/)[A-Z]?\d+(?:\.\d+)+\.story\.md$/i.test(e.replace(/^@/,"")):!1}function F(r){const e=r.match(/(?:^|[/@\s])([A-Z]?\d+(?:\.\d+)+)\.story\.md\b/i);return e?.[1]?e[1]:r.match(/(?:^|\s|@)([A-Z]?\d+(?:\.\d+)+)(?=$|\s)/i)?.[1]??null}function ue(r){const e=r.trim(),t=e.search(/\s/);return t===-1?"":e.slice(t).trim()}function q(r){return ue(r).split(/\s+/).map(e=>e.replace(/^@/,"").replace(/^['"]|['"]$/g,"")).filter(e=>e.length>0&&!e.startsWith("-"))}function Fe(r){return q(r)[0]??null}function P(r,e){const i=r.replace(/^@/,"").replace(/^epic-/i,"").replace(/\.md$/i,""),c=[i,i.toUpperCase(),/^p\d+$/i.test(i)?`P${i.replace(/^p/i,"")}`:null,/^\d+$/.test(i)?`P${i}`:null].filter(o=>typeof o=="string"&&o.length>0);for(const o of c)if(e.epics[o])return o;return null}function le(r,e){const t=r.match(/(?:^|[/@\s])epic-(P?\d+)\.md\b/i);return t?.[1]?P(t[1],e):null}function R(r,e){const t=r.trim().match(/^@epic-(P[0-9]{1,12})$/);if(t)return P(t[1],e);const i=le(r,e);if(i)return i;for(const c of q(r)){if(/^[A-Z]?\d+(?:\.\d+)+$/i.test(c))continue;const o=P(c,e);if(o)return o}return null}function pe(r,e){const t=R(r,e);if(t)return t;const i=e.yoloop,c=i?.state?.currentSession?.currentEpicId;if(typeof c=="string"&&e.epics[c])return c;const o=i?.lock?.currentEpicId??i?.lock?.epicId;return typeof o=="string"&&e.epics[o]?o:null}function fe(r){const e=r.match(/(?:^|[/@\s])epic-(P?\d+)\.md\b/i)?.[1];if(e)return/^P/i.test(e)?e.toUpperCase():`P${e}`;for(const t of q(r)){if(/^P\d+$/i.test(t))return t.toUpperCase();if(/^\d+$/.test(t))return`P${t}`}return null}function j(r,e){if(typeof r.epic_id=="string"&&r.epic_id.length>0)return r.epic_id;const t=e.split(".").slice(0,-1).join(".");return t.length>0?t:null}function L(r){return typeof r=="string"&&["done","completed","merged","cancelled","canceled","abandoned"].includes(r.toLowerCase())}function x(r,e,t){if(t.has(r))return;const i=e.stories[r];if(!i)return;t.add(r);const c=i.depends_on;if(Array.isArray(c))for(const o of c)typeof o=="string"&&x(o,e,t)}function ye(r,e){const t=I(e.stories,[r]),i={};for(const c of t.orderedIds){const o=e.stories[c];o&&(i[c]=o)}return i}function $(r,e,t=[]){const i={};for(const c of t)e.epics[c]&&(i[c]=e.epics[c]);for(const[c,o]of Object.entries(r)){const s=j(o,c);s&&e.epics[s]&&(i[s]=e.epics[s])}return i}function me(r,e,t){if(t.has(r))return;const i=e.epics[r];if(!i)return;t.add(r);const c=i.depends_on;if(Array.isArray(c))for(const o of c)typeof o=="string"&&o.length>0&&me(o,e,t)}function V(r,e,t){const i=I(t.epics,[r]),c=new Set(i.orderedIds);for(const[s,a]of Object.entries(e)){const u=j(a,s);u&&t.epics[u]&&c.add(u)}const o={};for(const s of[...c].sort((a,u)=>a.localeCompare(u,"en"))){const a=t.epics[s];a&&(o[s]=s===r?a:K(s,a))}return o}function G(r,e,t){const i=e.stories;if(!Array.isArray(i)||i.some(s=>typeof s!="string"||s.length===0))throw new y("STRUCTURAL_DEPENDENCY_MISSING",{nodes:0,edges:0,malformedStoryMemberships:1});const c=I(t.stories,i),o={};for(const s of c.orderedIds){const a=t.stories[s];a&&(o[s]=j(a,s)===r?oe(s,a):Y(s,a))}return o}function ge(r,e,t){const i=[...e.stories].sort((s,a)=>s.localeCompare(a,"en")),c=Object.entries(t).filter(([s,a])=>j(a,s)===r).map(([s])=>s).sort((s,a)=>s.localeCompare(a,"en")),o=H("sha256").update(`target-epic-coverage-v1\0${JSON.stringify({targetEpicId:r,declaredStoryIds:i,includedStoryIds:c})}`).digest("hex");return{schemaVersion:"TargetEpicCoverage/1.0",targetEpicId:r,declaredStoryIds:i,includedStoryIds:c,membershipSha256:o,publicSafe:!0}}function Y(r,e){const t=Array.isArray(e.depends_on)?[...new Set(e.depends_on.filter(m=>typeof m=="string"&&m.length>0))].sort((m,E)=>m.localeCompare(E,"en")):[],i={id:d(e.id)??r,...d(e.epic_id)?{epic_id:d(e.epic_id)}:{},...d(e.status,40)?{status:d(e.status,40)}:{},depends_on:t},c=M(r,e);if(!re(e.status))return{...i,...c?{scheduling_checkpoint_evidence:c}:{}};const o=e.source==="create-epic"||e.source==="discovered"?e.source:void 0,s=T(e.branch_name),a=w(e.last_step,120),u=Array.isArray(e.steps_completed)&&e.steps_completed.length<=64?e.steps_completed.map(m=>w(m,120)):[],l=u.length>0&&u.every(m=>m!==void 0)?u:void 0,f=typeof e.pr_number=="number"&&Number.isSafeInteger(e.pr_number)&&e.pr_number>0?e.pr_number:void 0,p=ie(r,e),g=p?ce(r,e):void 0;return{...i,...o?{source:o}:{},...s?{branch_name:s}:{},...a?{last_step:a}:{},...l?{steps_completed:l}:{},...f?{pr_number:f}:{},...p?{checkpoint:p}:{},...g?{checkpoint_verification:g}:{},...c?{scheduling_checkpoint_evidence:c}:{},...S(e.files_to_modify)!==void 0?{files_to_modify:S(e.files_to_modify)}:{},...S(e.contracts)!==void 0?{contracts:S(e.contracts)}:{},...S(e.contract_refs)!==void 0?{contract_refs:S(e.contract_refs)}:{},...S(e.shared_surfaces)!==void 0?{shared_surfaces:S(e.shared_surfaces)}:{}}}function K(r,e){const t=Array.isArray(e.stories)?[...new Set(e.stories.filter(c=>typeof c=="string"&&c.length>0))].sort((c,o)=>c.localeCompare(o,"en")):[],i=Array.isArray(e.depends_on)?[...new Set(e.depends_on.filter(c=>typeof c=="string"&&c.length>0))].sort((c,o)=>c.localeCompare(o,"en")):[];return{id:d(e.id)??r,...d(e.status,40)?{status:d(e.status,40)}:{},...d(e.lifecycle_classification,40)?{lifecycle_classification:d(e.lifecycle_classification,40)}:{},stories:t,depends_on:i}}function he(r,e,t){const i=I(e.stories),c=I(e.epics),o=Object.fromEntries(i.orderedIds.map(u=>[u,Y(u,e.stories[u])])),s=Object.fromEntries(c.orderedIds.map(u=>[u,K(u,e.epics[u])])),a={kind:"projected",commandId:t.commandId,stateProjectionPolicy:t.stateProjectionPolicy,projectionMode:"yoloop-discovery",trigger:r,targetEpicId:null,targetStoryId:null,includedStoryCount:i.orderedIds.length,includedEpicCount:c.orderedIds.length,omittedStoryCount:0,omittedEpicCount:0,reason:"targeted-invocation",reasonCodes:_(["structural-required","yoloop-discovery",`structural-edges-${i.edgeCount+c.edgeCount}`,"content-fields-omitted"])};return v({...e,stories:o,epics:s,scope:a},e,a)}function be(r,e){const t=new Set,i=r.stories;if(Array.isArray(i))for(const o of i)typeof o=="string"&&x(o,e,t);const c={};for(const o of t){const s=e.stories[o];s&&(c[o]=s)}return c}function _e(r){const e={};for(const[t,i]of Object.entries(r.epics))e[t]={id:d(i.id)??t,...d(i.status)?{status:d(i.status)}:{},...k.includes(i.lifecycle_classification)?{lifecycle_classification:i.lifecycle_classification}:{},...typeof i.total_stories=="number"&&Number.isFinite(i.total_stories)?{total_stories:i.total_stories}:{},...typeof i.completed_stories=="number"&&Number.isFinite(i.completed_stories)?{completed_stories:i.completed_stories}:{}};return e}function W(r){const e={};for(const t of Object.values(r)){const i=d(t.status,40)??"unknown";e[i]=(e[i]??0)+1}return e}function Se(r){const e=Object.fromEntries(k.map(t=>[t,0]));for(const t of Object.values(r)){const i=k.includes(t.lifecycle_classification)?t.lifecycle_classification:"active";e[i]=(e[i]??0)+1}return e}function N(r,e){if(!e)return!0;const t=r.epics[e];return t?!k.includes(t.lifecycle_classification)||t.lifecycle_classification==="active":!0}function Z(r){for(const e of["last_updated","updated_at","completed_at","created_at","discovered_at"]){const t=r[e];if(typeof t!="string")continue;const i=Date.parse(t);if(Number.isFinite(i))return i}return 0}function je(r){return Object.entries(r.stories).map(([e,t])=>({id:e,story:t,timestamp:Z(t)})).sort((e,t)=>t.timestamp-e.timestamp||e.id.localeCompare(t.id)).slice(0,U).map(({id:e,story:t})=>({id:e,...d(t.epic_id)?{epicId:d(t.epic_id)}:{},...d(t.status,40)?{status:d(t.status,40)}:{},...d(t.last_step??t.lastStep)?{lastStep:d(t.last_step??t.lastStep)}:{},...d(t.last_updated??t.updated_at??t.completed_at??t.created_at)?{lastUpdated:d(t.last_updated??t.updated_at??t.completed_at??t.created_at)}:{}}))}function ve(r){const e=r.current_session;if(!e)return;const t={activeEpicId:d(e.active_epic_id)??null,activeStoryId:d(e.active_story_id)??null,activeStepId:d(e.active_step_id)??null,sessionId:d(e.session_id)??null,startedAt:d(e.started_at)??null};return Object.values(t).some(i=>i!=null)?t:void 0}function Ie(r){const e=r.yoloop;if(!h(e))return;const t=h(e.state)?e.state:void 0,i=h(t?.currentSession)?t.currentSession:void 0,c=h(e.lock)?e.lock:void 0,o={...typeof e.active=="boolean"?{active:e.active}:{},currentEpicId:d(i?.currentEpicId??e.currentEpicId)??null,currentStoryId:d(i?.currentStoryId??e.currentStoryId)??null,sessionId:d(i?.sessionId??e.sessionId)??null,lockEpicId:d(c?.currentEpicId??c?.epicId)??null};return Object.keys(o).length>0?o:void 0}function ke(r){const e=r.continuity;if(!h(e))return;const t=Array.isArray(e.reasonCodes)?e.reasonCodes.filter(i=>typeof i=="string"):void 0;return{present:!0,activeJobId:d(e.activeJobId??e.jobId)??null,activeGoalId:d(e.activeGoalId??e.goalId)??null,activeLoopId:d(e.activeLoopId??e.loopId)??null,...t&&t.length>0?{reasonCodes:_(t)}:{}}}function Ce(r,e,t){const i=d(e?.activeStoryId),c=d(e?.activeEpicId),o=d(e?.activeStepId),s=i&&r.stories[i]?j(r.stories[i],i):null;if((i||c||o)&&N(r,c??s))return{epicId:c??null,storyId:i??null,stepId:o??null};const a=d(t?.currentStoryId),u=d(t?.currentEpicId??t?.lockEpicId);if((a||u)&&N(r,u))return{epicId:u??null,storyId:a??null,stepId:null};const l=Object.entries(r.stories).map(([f,p])=>({id:f,story:p,timestamp:Z(p)})).filter(({id:f,story:p})=>!L(p.status)&&N(r,j(p,f))).sort((f,p)=>p.timestamp-f.timestamp||f.id.localeCompare(p.id))[0];return l?{epicId:j(l.story,l.id),storyId:l.id,stepId:d(l.story.last_step??l.story.lastStep)??null}:{epicId:null,storyId:null,stepId:null}}function Ee(r,e){const t=W(r.stories),i=W(r.epics),c=Se(r.epics),o=Object.values(r.epics).filter(g=>(k.includes(g.lifecycle_classification)?g.lifecycle_classification:"active")==="active"&&!L(g.status)).length,s=ve(r),a=Ie(r),u=ke(r),l=Ce(r,s,a),f=je(r),p=_(e.reasonCodes,["state-summary-attached","state-summary-bounded",`projection-${e.projectionMode??e.kind}`,e.stateProjectionPolicy?`policy-${e.stateProjectionPolicy}`:"policy-unknown",f.length>=U?"recent-stories-capped":"recent-stories-bounded",l.storyId||l.epicId?"active-ref-derived":"active-ref-empty",a?"yoloop-session-present":"yoloop-session-absent",u?"continuity-session-present":"continuity-session-absent"]);return{schemaVersion:1,totals:{stories:Object.keys(r.stories).length,epics:Object.keys(r.epics).length,storyStatus:t,epicStatus:i,epicLifecycle:c,activeEpics:o,blockedStories:t.blocked??0},active:l,blockedCount:t.blocked??0,recentStories:f,...s?{currentSession:s}:{},...a?{currentYoloopSession:a}:{},...u?{currentContinuitySession:u}:{},projection:{commandId:e.commandId??null,stateProjectionPolicy:e.stateProjectionPolicy??null,projectionMode:e.projectionMode,scopeKind:e.kind,includedStoryCount:e.includedStoryCount,includedEpicCount:e.includedEpicCount??Object.keys(r.epics).length,omittedStoryCount:e.omittedStoryCount,omittedEpicCount:e.omittedEpicCount,reason:e.reason},reasonCodes:p,publicSafe:!0}}function v(r,e,t){return{...r,stateSummary:Ee(e,t)}}function Re(r,e,t){const i={};for(const o of Object.keys(e.epics))i[o]={id:o};const c={kind:"projected",commandId:t.commandId,stateProjectionPolicy:t.stateProjectionPolicy,projectionMode:"summary-only",trigger:r,targetEpicId:null,targetStoryId:null,includedStoryCount:0,includedEpicCount:Object.keys(i).length,omittedStoryCount:Object.keys(e.stories).length,omittedEpicCount:0,reason:"epic-summary",reasonCodes:["epic-summary","stories-omitted","epic-stubs-only"]};return v({...e,stories:{},epics:i,scope:c},e,c)}function b(r,e,t,i=["summary-only","stories-omitted"],c="summary-only"){const o=_e(e),s={kind:"projected",commandId:t.commandId,stateProjectionPolicy:t.stateProjectionPolicy,projectionMode:c,trigger:r,targetEpicId:null,targetStoryId:null,includedStoryCount:0,includedEpicCount:Object.keys(o).length,omittedStoryCount:Object.keys(e.stories).length,omittedEpicCount:Math.max(0,Object.keys(e.epics).length-Object.keys(o).length),reason:"summary-only",reasonCodes:_(i)};return v({...e,stories:{},epics:o,scope:s},e,s)}function D(r,e,t,i,c,o){const s=e.stories[i];if(!s)throw new y("STRUCTURAL_TARGET_NOT_FOUND",{stories:Object.keys(e.stories).length,epics:Object.keys(e.epics).length,targetKind:"story"});const a=j(s,i);if(!a)throw new y("STRUCTURAL_TARGET_NOT_FOUND",{stories:Object.keys(e.stories).length,epics:Object.keys(e.epics).length,targetKind:"epic"});const u=e.epics[a];if(!u)throw new y("STRUCTURAL_TARGET_NOT_FOUND",{stories:Object.keys(e.stories).length,epics:Object.keys(e.epics).length,targetKind:"epic"});const l=c==="yolo-story",f=l?G(a,u,e):ye(i,e),p=l?V(a,f,e):$(f,e);if(!f[i]||!p[a])throw new y("STRUCTURAL_TARGET_NOT_FOUND",{stories:Object.keys(f).length,epics:Object.keys(p).length,targetKind:"story"});const g={kind:"projected",commandId:t.commandId,stateProjectionPolicy:t.stateProjectionPolicy,projectionMode:c,trigger:r,targetEpicId:a,targetStoryId:i,includedStoryCount:Object.keys(f).length,includedEpicCount:Object.keys(p).length,omittedStoryCount:Math.max(0,Object.keys(e.stories).length-Object.keys(f).length),omittedEpicCount:Math.max(0,Object.keys(e.epics).length-Object.keys(p).length),reason:"targeted-invocation",reasonCodes:_(o,l?["epic-graph-authority-complete"]:[])};return v({...e,stories:f,epics:p,scope:g},e,g)}function B(r,e,t,i,c,o){const s=e.epics[i];if(!s)throw new y("STRUCTURAL_TARGET_NOT_FOUND",{stories:Object.keys(e.stories).length,epics:Object.keys(e.epics).length,targetKind:"epic"});const a=be(s,e),u=$(a,e,[i]);if(!u[i])throw new y("STRUCTURAL_TARGET_NOT_FOUND",{stories:Object.keys(a).length,epics:Object.keys(u).length,targetKind:"epic"});const l={kind:"projected",commandId:t.commandId,stateProjectionPolicy:t.stateProjectionPolicy,projectionMode:c,trigger:r,targetEpicId:i,targetStoryId:null,includedStoryCount:Object.keys(a).length,includedEpicCount:Object.keys(u).length,omittedStoryCount:Math.max(0,Object.keys(e.stories).length-Object.keys(a).length),omittedEpicCount:Math.max(0,Object.keys(e.epics).length-Object.keys(u).length),reason:"targeted-invocation",reasonCodes:_(o)};return v({...e,stories:a,epics:u,scope:l},e,l)}function Oe(r,e,t){const i=fe(r),c=R(r,e);if(i&&!c)throw new y("STRUCTURAL_TARGET_NOT_FOUND",{stories:Object.keys(e.stories).length,epics:Object.keys(e.epics).length,targetKind:"epic"});const o=pe(r,e),s=O({commandId:t.commandId,explicitYoloopEpicId:c,sessionYoloopEpicId:c?null:o});if(s==="yoloop-discovery")return he(r,e,t);if(!o||s!=="yoloop-target"&&s!=="yoloop-session")throw new y("STRUCTURAL_TARGET_NOT_FOUND",{stories:Object.keys(e.stories).length,epics:Object.keys(e.epics).length,targetKind:"epic"});const a=e.epics[o];if(!a)throw new y("STRUCTURAL_TARGET_NOT_FOUND",{stories:Object.keys(e.stories).length,epics:Object.keys(e.epics).length,targetKind:"epic"});const u=G(o,a,e),l=V(o,u,e);if(!l[o])throw new y("STRUCTURAL_TARGET_NOT_FOUND",{stories:Object.keys(u).length,epics:Object.keys(l).length,targetKind:"epic"});const f=s,p={kind:"projected",commandId:t.commandId,stateProjectionPolicy:t.stateProjectionPolicy,projectionMode:f,trigger:r,targetEpicId:o,targetStoryId:null,targetEpicCoverage:ge(o,a,u),includedStoryCount:Object.keys(u).length,includedEpicCount:Object.keys(l).length,omittedStoryCount:Math.max(0,Object.keys(e.stories).length-Object.keys(u).length),omittedEpicCount:Math.max(0,Object.keys(e.epics).length-Object.keys(l).length),reason:"targeted-invocation",reasonCodes:["structural-required",f,"yoloop-targeted"]};return v({...e,stories:u,epics:l,scope:p},e,p)}function Ae(r,e){const t={};for(const[i,c]of Object.entries(r.epics)){const o=Array.isArray(c.stories)?c.stories.filter(s=>typeof s=="string"&&e.has(s)):[];t[i]={id:d(c.id)??i,...d(c.status,40)?{status:d(c.status,40)}:{},...typeof c.total_stories=="number"&&Number.isFinite(c.total_stories)?{total_stories:c.total_stories}:{},...typeof c.completed_stories=="number"&&Number.isFinite(c.completed_stories)?{completed_stories:c.completed_stories}:{},...o.length>0?{stories:o}:{},...o.length>0&&Array.isArray(c.depends_on)?{depends_on:c.depends_on.filter(s=>typeof s=="string"&&s.length>0)}:{},...o.length>0&&(c.branch_mode==="epic"||c.branch_mode==="story")?{branch_mode:c.branch_mode}:{},...o.length>0&&typeof c.execution_branch=="string"?{execution_branch:c.execution_branch}:{},...o.length>0&&typeof c.origin_branch=="string"?{origin_branch:c.origin_branch}:{},...o.length>0&&(c.branch_lease===null||typeof c.branch_lease=="object")?{branch_lease:c.branch_lease}:{},...o.length>0&&(c.origin_binding===null||typeof c.origin_binding=="object")?{origin_binding:c.origin_binding}:{},...o.length>0&&(c.aggregate_qa_receipt===null||typeof c.aggregate_qa_receipt=="object")?{aggregate_qa_receipt:c.aggregate_qa_receipt}:{}}}return t}function we(r){return r.stateSummary?.totals.stories??(r.scope?.includedStoryCount??Object.keys(r.stories).length)+(r.scope?.omittedStoryCount??0)}function Te(r){return r.stateSummary?.totals.epics??(r.scope?.includedEpicCount??Object.keys(r.epics).length)+(r.scope?.omittedEpicCount??0)}function qe(r,e){if(r.stateSummary)return{...r.stateSummary,projection:{...r.stateSummary.projection,scopeKind:"projected",projectionMode:e.projectionMode,includedStoryCount:e.includedStoryCount,includedEpicCount:e.includedEpicCount??r.stateSummary.projection.includedEpicCount,omittedStoryCount:e.omittedStoryCount,omittedEpicCount:e.omittedEpicCount,reason:"body-size"},reasonCodes:_(r.stateSummary.reasonCodes,["payload-size-guardrail","state-summary-preserved","nonessential-state-degraded"])}}function Le(r){const e=r.scope,t=new Set,i=e?.projectionMode==="structural-required"||e?.projectionMode==="yolo-story"||e?.projectionMode==="yoloop-target"||e?.projectionMode==="yoloop-session"||e?.projectionMode==="yoloop-discovery";if(i)for(const m of Object.keys(r.stories))t.add(m);else e?.targetStoryId&&x(e.targetStoryId,r,t);const c={};for(const m of t){const E=r.stories[m];E&&(c[m]=E)}const o=Ae(r,t),s=Object.keys(c).length,a=Object.keys(o).length,u=Math.max(0,we(r)-s),l=Math.max(0,Te(r)-a),f=i?e?.projectionMode??"structural-required":e?.projectionMode==="yolo-story"?"yolo-story":"summary-only",p={kind:"projected",commandId:e?.commandId??null,stateProjectionPolicy:e?.stateProjectionPolicy??null,projectionMode:f,targetEpicId:e?.targetEpicId??null,targetStoryId:e?.targetStoryId??null,...e?.targetEpicCoverage?{targetEpicCoverage:e.targetEpicCoverage}:{},includedStoryCount:s,includedEpicCount:a,omittedStoryCount:u,omittedEpicCount:l,reason:"body-size",reasonCodes:_(e?.reasonCodes,["payload-size-guardrail",t.size>0?"structural-targets-preserved":"stories-omitted","epics-stubbed","state-summary-preserved","redundant-trigger-omitted"])},g=qe(r,p);return{...r,stories:c,epics:o,scope:p,...g?{stateSummary:g}:{}}}function Pe(r,e){const t=r.trim(),i=z(t);try{if(!i){if(de(t)){const o=n("story-reference","story-targeted"),s=F(t);if(s)return D(t,e,o,s,"targeted-story",["story-reference-targeted"])}return b(t,e,n("unknown","adaptive-targeted"),["unknown-command-summary-only"])}if(i.stateProjectionPolicy==="epic-summary")return Re(t,e,i);if(i.stateProjectionPolicy==="yoloop-targeted")return Oe(t,e,i);const c=F(t);if(i.stateProjectionPolicy==="story-targeted"){if(c){const s=O({commandId:i.commandId,targetStoryId:c})==="yolo-story";return D(t,e,i,c,s?"yolo-story":i.structuralRequired?"structural-required":"targeted-story",[s?"yolo-story":i.structuralRequired?"structural-required":"targeted-story"])}if(i.commandId==="yolo"||i.commandId==="yolo-inline"){const o=O({commandId:i.commandId});return b(t,e,i,["yolo-inline","stories-omitted","historical-content-omitted"],o??"yolo-inline")}return i.commandId==="commit"&&/^\*?(?:commit|commit-push)$/i.test(t)?b(t,e,i,["working-tree-commit","stories-omitted","historical-content-omitted"]):i.structuralRequired?(()=>{throw new y("STRUCTURAL_TARGET_NOT_FOUND",{stories:Object.keys(e.stories).length,epics:Object.keys(e.epics).length,targetKind:"story"})})():b(t,e,i,["story-target-missing-summary-only"])}if(i.stateProjectionPolicy==="adaptive-targeted"){if(c&&e.stories[c])return D(t,e,i,c,"targeted-story",["adaptive-story-targeted"]);const o=R(t,e);return o?B(t,e,i,o,"targeted-epic",["adaptive-epic-targeted"]):b(t,e,i,["adaptive-summary-only","target-unresolved-summary-only"])}if(i.stateProjectionPolicy==="epic-targeted"){if(i.commandId.startsWith("arch-")&&/(?:^|\s)epic-arch\s*$/i.test(t)&&e.archPlan?.execution?.currentStageCommand===i.commandId)return b(t,e,i,["architecture-root-delegated"]);const o=R(t,e);return o?B(t,e,i,o,i.structuralRequired?"structural-required":"targeted-epic",[i.structuralRequired?"structural-required":"targeted-epic"]):i.structuralRequired?(()=>{throw new y("STRUCTURAL_TARGET_NOT_FOUND",{stories:Object.keys(e.stories).length,epics:Object.keys(e.epics).length,targetKind:"epic"})})():b(t,e,i,["epic-target-missing-summary-only"])}return i.stateProjectionPolicy==="continuity-scoped"?b(t,e,i,["continuity-scoped-summary-only"]):b(t,e,i,["policy-full-summary-only"])}catch(c){if(c instanceof y)throw c;if(i?.structuralRequired)throw new y("STRUCTURAL_DEPENDENCY_MISSING",{stories:Object.keys(e.stories).length,epics:Object.keys(e.epics).length,projectionErrors:1});return b(t,e,i??n("unknown","adaptive-targeted"),["projection-error-summary-only"])}}const xe=new Set(["yolo-story","yolo-inline","yoloop-target","yoloop-session","yoloop-discovery"]);function Ne(r){let e=0;for(const t of[r.stories,r.epics])for(const i of Object.values(t))Array.isArray(i.depends_on)&&(e+=i.depends_on.filter(c=>typeof c=="string").length);return e}function $e(r,e){const t=z(r.trim());if(!t||!["yolo","yolo-inline","yoloop"].includes(t.commandId))return null;try{const i=Pe(r,e),c=i.scope?.projectionMode;if(!c||!xe.has(c))throw new y("STRUCTURAL_DEPENDENCY_MISSING",{stories:Object.keys(i.stories).length,epics:Object.keys(i.epics).length,projectionShapeErrors:1});return Object.freeze({ok:!0,version:2,shape:c,snapshot:i,included:{epics:i.scope?.includedEpicCount??Object.keys(i.epics).length,stories:i.scope?.includedStoryCount??Object.keys(i.stories).length,edges:Ne(i)},omitted:{epics:i.scope?.omittedEpicCount??0,stories:i.scope?.omittedStoryCount??0},cycleCount:0})}catch(i){if(!(i instanceof y))throw i;return Object.freeze({ok:!1,code:i.code,publicDetails:i.publicDetails})}}export{Le as degradeStateSnapshotForPayloadLimit,Pe as projectStateSnapshotForInvoke,$e as projectStateSnapshotResultV2ForInvoke};
+/**
+ * @license FSL-1.1
+ * Copyright (c) 2026 OrNexus AI
+ *
+ * Pure request-scoped projection helpers for invoke state snapshots.
+ */
+import { createHash } from 'node:crypto';
+import { analyzeDependencyDag, StructuralDagError, } from './structural-dag-projection.js';
+import { classifyInvocationShapeV2 } from './invocation-shape.js';
+const RECENT_STORY_LIMIT = 12;
+const REASON_CODE_LIMIT = 16;
+const EPIC_LIFECYCLE_CLASSIFICATIONS = ['active', 'archived', 'rolled-back', 'synthetic', 'orphan'];
+// Publish-safe shadow of packages/shared/src/yoloop/status-policy.ts. The
+// standalone client tarball cannot take a runtime dependency on @neocortex/shared.
+const YOLOOP_ACTIVE_STORY_STATUS_SET = new Set([
+    'in-progress', 'branch-ready', 'diagnose', 'research', 'write-spec',
+    'create-tasks', 'implemented', 'refactor-suggest-done',
+    'property-tests-emitted', 'tests-validated', 'qa-gate-passed',
+    'memory-updated', 'committed', 'synced', 'pr-created', 'pr-reviewed',
+    'partial',
+]);
+const policy = (commandId, stateProjectionPolicy, options = {}) => ({
+    commandId,
+    stateProjectionPolicy,
+    ...options,
+});
+// P198.03: local publish-safe shadow of the P198.01 shared command-context
+// projection policies. The published CLI does not ship `packages/shared/dist`, so
+// this file must not add a runtime `@neocortex/shared` import until packaging is
+// changed. Keep ids/aliases/numbers aligned with the public command registry.
+const COMMAND_POLICY_BY_ID = Object.freeze({
+    status: policy('status', 'full'),
+    'arch-plan': policy('arch-plan', 'full'),
+    'arch-prd': policy('arch-prd', 'full'),
+    'arch-architecture': policy('arch-architecture', 'epic-targeted', { structuralRequired: true }),
+    'arch-api-contracts': policy('arch-api-contracts', 'epic-targeted', { structuralRequired: true }),
+    'arch-api-integrations': policy('arch-api-integrations', 'epic-targeted', { structuralRequired: true }),
+    'arch-database': policy('arch-database', 'epic-targeted', { structuralRequired: true }),
+    'arch-security': policy('arch-security', 'epic-targeted', { structuralRequired: true }),
+    'arch-design-system': policy('arch-design-system', 'epic-targeted', { structuralRequired: true }),
+    'arch-ux-design': policy('arch-ux-design', 'epic-targeted', { structuralRequired: true }),
+    'arch-performance': policy('arch-performance', 'epic-targeted', { structuralRequired: true }),
+    'arch-testing': policy('arch-testing', 'epic-targeted', { structuralRequired: true }),
+    'arch-infrastructure': policy('arch-infrastructure', 'epic-targeted', { structuralRequired: true }),
+    'arch-review': policy('arch-review', 'epic-targeted', { structuralRequired: true }),
+    'arch-fitness-functions': policy('arch-fitness-functions', 'epic-targeted', { structuralRequired: true }),
+    'create-epic': policy('create-epic', 'epic-summary'),
+    'idea-diagnose': policy('idea-diagnose', 'full'),
+    'idea-research': policy('idea-research', 'epic-targeted', { structuralRequired: true }),
+    'generate-epic': policy('generate-epic', 'epic-targeted', { structuralRequired: true }),
+    exec: policy('exec', 'story-targeted', { structuralRequired: true }),
+    yolo: policy('yolo', 'story-targeted', { structuralRequired: true }),
+    'yolo-inline': policy('yolo-inline', 'story-targeted', { structuralRequired: true }),
+    epic: policy('epic', 'epic-targeted', { structuralRequired: true }),
+    'setup-branch': policy('setup-branch', 'story-targeted', { structuralRequired: true }),
+    diagnose: policy('diagnose', 'adaptive-targeted'),
+    'diagnose-inline': policy('diagnose-inline', 'full'),
+    research: policy('research', 'adaptive-targeted'),
+    'research-inline': policy('research-inline', 'full'),
+    'write-spec': policy('write-spec', 'story-targeted', { structuralRequired: true }),
+    'create-tasks': policy('create-tasks', 'story-targeted', { structuralRequired: true }),
+    implement: policy('implement', 'story-targeted', { structuralRequired: true }),
+    commit: policy('commit', 'story-targeted', { structuralRequired: true }),
+    'commit-push': policy('commit', 'story-targeted', { structuralRequired: true }),
+    sync: policy('sync', 'story-targeted', { structuralRequired: true }),
+    'sync-main': policy('sync', 'story-targeted', { structuralRequired: true }),
+    'create-pr': policy('create-pr', 'story-targeted', { structuralRequired: true }),
+    review: policy('review', 'story-targeted'),
+    'review-pr': policy('review', 'story-targeted'),
+    merge: policy('merge', 'story-targeted', { structuralRequired: true }),
+    'merge-pr': policy('merge', 'story-targeted', { structuralRequired: true }),
+    'fix-blocked': policy('fix-blocked', 'story-targeted'),
+    'finalize-epic': policy('finalize-epic', 'epic-targeted'),
+    'resolve-conflicts': policy('resolve-conflicts', 'story-targeted'),
+    'update-memory': policy('update-memory', 'full'),
+    'update-project-memory': policy('update-memory', 'story-targeted', { structuralRequired: true }),
+    refactor: policy('refactor', 'adaptive-targeted'),
+    'refactor-suggest': policy('refactor', 'story-targeted', { structuralRequired: true }),
+    cleanup: policy('cleanup', 'full'),
+    audit: policy('audit', 'full'),
+    'tech-debt': policy('tech-debt', 'full'),
+    menu: policy('menu', 'full'),
+    plans: policy('plans', 'full'),
+    billing: policy('billing', 'full'),
+    subscribe: policy('subscribe', 'full'),
+    'qa-scan': policy('qa-scan', 'full'),
+    yoloop: policy('yoloop', 'yoloop-targeted', { structuralRequired: true }),
+    'migrate-state': policy('migrate-state', 'full'),
+    'migrate-project-id': policy('migrate-project-id', 'full'),
+    'policy-audit': policy('policy-audit', 'full'),
+    'mutation-test': policy('mutation-test', 'full'),
+    'sync-openapi': policy('sync-openapi', 'full'),
+    'generate-pacts': policy('generate-pacts', 'full'),
+    'verify-pacts': policy('verify-pacts', 'full'),
+    'property-test': policy('property-test', 'full'),
+    'property-tests': policy('property-test', 'story-targeted', { structuralRequired: true }),
+    'chaos-plan': policy('chaos-plan', 'full'),
+    'ui-ux-review': policy('ui-ux-review', 'adaptive-targeted'),
+    'solyd-system': policy('solyd-system', 'adaptive-targeted'),
+    goal: policy('goal', 'continuity-scoped'),
+    loop: policy('loop', 'continuity-scoped'),
+    jobs: policy('jobs', 'continuity-scoped'),
+    runner: policy('runner', 'continuity-scoped'),
+    'goal-tick': policy('goal-tick', 'continuity-scoped'),
+    'loop-tick': policy('loop-tick', 'continuity-scoped'),
+    'validate-tests': policy('validate-tests', 'story-targeted', { structuralRequired: true }),
+    'qa-gate': policy('qa-gate', 'story-targeted', { structuralRequired: true }),
+});
+const COMMAND_ALIAS_TO_ID = Object.freeze({
+    st: 'status',
+    arquitetura: 'arch-plan',
+    architecture: 'arch-plan',
+    arch: 'arch-plan',
+    prd: 'arch-prd',
+    'product-requirements': 'arch-prd',
+    'arch-doc': 'arch-architecture',
+    'tech-architecture': 'arch-architecture',
+    'api-contracts': 'arch-api-contracts',
+    'api-contract': 'arch-api-contracts',
+    'api-integrations': 'arch-api-integrations',
+    'api-int': 'arch-api-integrations',
+    'database-schema': 'arch-database',
+    'db-schema': 'arch-database',
+    db: 'arch-database',
+    'cyber-security': 'arch-security',
+    security: 'arch-security',
+    sec: 'arch-security',
+    'design-system': 'arch-design-system',
+    ds: 'arch-design-system',
+    'atomic-design': 'arch-design-system',
+    'ux-design': 'arch-ux-design',
+    ux: 'arch-ux-design',
+    wireframes: 'arch-ux-design',
+    wireframe: 'arch-ux-design',
+    'user-flows': 'arch-ux-design',
+    performance: 'arch-performance',
+    perf: 'arch-performance',
+    'capacity-planning': 'arch-performance',
+    capacity: 'arch-performance',
+    'arch-perf': 'arch-performance',
+    'performance-strategy': 'arch-performance',
+    'testing-strategy': 'arch-testing',
+    'test-plan': 'arch-testing',
+    'test-strategy': 'arch-testing',
+    'arch-test': 'arch-testing',
+    infrastructure: 'arch-infrastructure',
+    infra: 'arch-infrastructure',
+    'deploy-plan': 'arch-infrastructure',
+    deployment: 'arch-infrastructure',
+    'arch-infra': 'arch-infrastructure',
+    'arch-deploy': 'arch-infrastructure',
+    'review-consolidation': 'arch-review',
+    consolidation: 'arch-review',
+    'architecture-review': 'arch-review',
+    'arch-consolidation': 'arch-review',
+    fitness: 'arch-fitness-functions',
+    'fitness-functions': 'arch-fitness-functions',
+    archfit: 'arch-fitness-functions',
+    'arch-fit': 'arch-fitness-functions',
+    'fit-funcs': 'arch-fitness-functions',
+    'criar-epic': 'create-epic',
+    planejamento: 'create-epic',
+    'idea-diag': 'idea-diagnose',
+    'idea-pesq': 'idea-research',
+    'gerar-epic': 'generate-epic',
+    executar: 'exec',
+    pipeline: 'exec',
+    'parallel-epic': 'epic',
+    setup: 'setup-branch',
+    branch: 'setup-branch',
+    diag: 'diagnose',
+    diagnostico: 'diagnose',
+    c02: 'diagnose',
+    pesquisar: 'research',
+    pesq: 'research',
+    'research-fix': 'research',
+    c03: 'research',
+    spec: 'write-spec',
+    especificacao: 'write-spec',
+    c04: 'write-spec',
+    tasks: 'create-tasks',
+    tarefas: 'create-tasks',
+    c05: 'create-tasks',
+    impl: 'implement',
+    implementar: 'implement',
+    c06: 'implement',
+    push: 'commit',
+    'commit_push': 'commit',
+    cp: 'commit',
+    c07: 'commit',
+    sincronizar: 'sync',
+    c08: 'sync',
+    pr: 'create-pr',
+    c09: 'create-pr',
+    revisar: 'review',
+    c11: 'review',
+    mesclar: 'merge',
+    c12: 'merge',
+    fix: 'fix-blocked',
+    corrigir: 'fix-blocked',
+    finalizar: 'finalize-epic',
+    conflitos: 'resolve-conflicts',
+    memoria: 'update-memory',
+    refactoring: 'refactor',
+    refact: 'refactor',
+    refac: 'refactor',
+    rf: 'refactor',
+    'cleanup-code': 'refactor',
+    'code-cleanup': 'refactor',
+    'code-quality': 'refactor',
+    'improve-code': 'refactor',
+    modernize: 'refactor',
+    modernization: 'refactor',
+    legacy: 'refactor',
+    'legacy-code': 'refactor',
+    'debt-pay': 'refactor',
+    'pay-debt': 'refactor',
+    'debt-reduction': 'refactor',
+    'smell-fix': 'refactor',
+    'fix-smells': 'refactor',
+    'code-smells': 'refactor',
+    strangler: 'refactor',
+    'strangler-fig': 'refactor',
+    limpar: 'cleanup',
+    limpeza: 'cleanup',
+    auditar: 'audit',
+    auditoria: 'audit',
+    debt: 'tech-debt',
+    debts: 'tech-debt',
+    'debt-list': 'tech-debt',
+    'tech-debts': 'tech-debt',
+    td: 'tech-debt',
+    help: 'menu',
+    ajuda: 'menu',
+    '?': 'menu',
+    commands: 'menu',
+    cmds: 'menu',
+    planos: 'plans',
+    pricing: 'plans',
+    bill: 'billing',
+    subscription: 'billing',
+    sub: 'billing',
+    upgrade: 'subscribe',
+    checkout: 'subscribe',
+    qa: 'qa-scan',
+    'qa-test': 'qa-scan',
+    'visual-qa': 'qa-scan',
+    'e2e-scan': 'qa-scan',
+    troubleshoot: 'qa-scan',
+    'debug-ui': 'qa-scan',
+    scan: 'qa-scan',
+    a11y: 'qa-scan',
+    accessibility: 'qa-scan',
+    wcag: 'qa-scan',
+    'auto-yolo': 'yoloop',
+    'epic-runner': 'yoloop',
+    'story-runner': 'yoloop',
+    'loop-yolo': 'yoloop',
+    'auto-epic': 'yoloop',
+    migrate: 'migrate-state',
+    'state-migrate': 'migrate-state',
+    'schema-migrate': 'migrate-state',
+    policy: 'policy-audit',
+    'audit-policy': 'policy-audit',
+    'policy-history': 'policy-audit',
+    policies: 'policy-audit',
+    mutation: 'mutation-test',
+    stryker: 'mutation-test',
+    'kill-mutants': 'mutation-test',
+    'openapi-sync': 'sync-openapi',
+    'api-sync': 'sync-openapi',
+    'spec-sync': 'sync-openapi',
+    'regen-openapi': 'sync-openapi',
+    pacts: 'generate-pacts',
+    'gen-pacts': 'generate-pacts',
+    'regen-pacts': 'generate-pacts',
+    'create-pacts': 'generate-pacts',
+    'verify-pact': 'verify-pacts',
+    'pact-verify': 'verify-pacts',
+    'check-pacts': 'verify-pacts',
+    'pact-check': 'verify-pacts',
+    property: 'property-test',
+    pbt: 'property-test',
+    proptest: 'property-test',
+    'invariant-test': 'property-test',
+    chaos: 'chaos-plan',
+    gameday: 'chaos-plan',
+    'resilience-test': 'chaos-plan',
+    'ux-review': 'ui-ux-review',
+    'design-review': 'ui-ux-review',
+    'visual-review': 'ui-ux-review',
+    'product-polish': 'ui-ux-review',
+    'security-system': 'solyd-system',
+    'authorized-security': 'solyd-system',
+    'sec-system': 'solyd-system',
+    goals: 'goal',
+    'durable-goal': 'goal',
+    'continuity-goal': 'goal',
+    loops: 'loop',
+    'durable-loop': 'loop',
+    'continuity-loop': 'loop',
+    job: 'jobs',
+    'continuity-jobs': 'jobs',
+    'neocortex-runner': 'runner',
+    'continuity-runner': 'runner',
+});
+const COMMAND_NUMBER_TO_ID = Object.freeze({
+    '1': 'status',
+    '3': 'arch-plan',
+    '4': 'arch-prd',
+    '5': 'arch-architecture',
+    '6': 'arch-api-contracts',
+    '7': 'arch-api-integrations',
+    '8': 'arch-database',
+    '9': 'arch-security',
+    '10': 'arch-design-system',
+    '11': 'arch-ux-design',
+    '12': 'arch-performance',
+    '13': 'arch-testing',
+    '14': 'arch-infrastructure',
+    '15': 'arch-review',
+    '16': 'arch-fitness-functions',
+    '17': 'create-epic',
+    '18': 'idea-diagnose',
+    '19': 'idea-research',
+    '20': 'generate-epic',
+    '21': 'exec',
+    '22': 'yolo',
+    '23': 'epic',
+    '24': 'setup-branch',
+    '25': 'diagnose',
+    '26': 'research',
+    '27': 'write-spec',
+    '28': 'create-tasks',
+    '29': 'implement',
+    '30': 'commit',
+    '31': 'sync',
+    '32': 'create-pr',
+    '33': 'review',
+    '34': 'merge',
+    '35': 'fix-blocked',
+    '36': 'finalize-epic',
+    '37': 'resolve-conflicts',
+    '38': 'update-memory',
+    '39': 'refactor',
+    '40': 'cleanup',
+    '41': 'audit',
+    '42': 'tech-debt',
+    '43': 'menu',
+    '44': 'plans',
+    '45': 'billing',
+    '46': 'subscribe',
+    '47': 'qa-scan',
+    '48': 'yoloop',
+    '49': 'migrate-state',
+    '50': 'policy-audit',
+    '51': 'mutation-test',
+    '52': 'sync-openapi',
+    '53': 'generate-pacts',
+    '54': 'verify-pacts',
+    '55': 'property-test',
+    '56': 'chaos-plan',
+    '57': 'ui-ux-review',
+    '58': 'solyd-system',
+    '59': 'goal',
+    '60': 'loop',
+    '61': 'jobs',
+    '62': 'runner',
+});
+function safeToken(value, maxLength = 120) {
+    if (typeof value !== 'string')
+        return undefined;
+    const trimmed = value.trim();
+    if (!trimmed)
+        return undefined;
+    return trimmed.replace(/[^a-z0-9_.:-]+/gi, '_').slice(0, maxLength);
+}
+function safeCanonicalToken(value, maxLength = 120) {
+    if (typeof value !== 'string')
+        return undefined;
+    const trimmed = value.trim();
+    const safe = safeToken(value, maxLength);
+    return safe === trimmed ? safe : undefined;
+}
+function safeGitRef(value) {
+    if (typeof value !== 'string')
+        return undefined;
+    const trimmed = value.trim();
+    if (!trimmed || trimmed.length > 240 || !/^[A-Za-z0-9][A-Za-z0-9._/-]*$/.test(trimmed)
+        || trimmed.includes('..') || trimmed.includes('//') || trimmed.includes('@{')
+        || trimmed.endsWith('/') || trimmed.endsWith('.')
+        || trimmed.split('/').some((part) => !part || part.startsWith('.') || part.endsWith('.lock')))
+        return undefined;
+    return trimmed;
+}
+function safeWriteRef(value) {
+    if (typeof value !== 'string')
+        return undefined;
+    const normalized = value.replace(/\\/g, '/');
+    if (!normalized || normalized.length > 240 || normalized.startsWith('/')
+        || /^[A-Za-z]:/.test(normalized) || normalized.includes('..') || normalized.includes('//')
+        || normalized.split('/').includes('.') || !/^[A-Za-z0-9._/:@#-]+$/.test(normalized))
+        return undefined;
+    return normalized;
+}
+function safeWriteRefs(value) {
+    if (value === undefined)
+        return undefined;
+    if (!Array.isArray(value) || value.length > 128)
+        return undefined;
+    const refs = value.map(safeWriteRef);
+    if (refs.some((ref) => ref === undefined))
+        return undefined;
+    return [...new Set(refs)].sort((left, right) => left.localeCompare(right, 'en'));
+}
+function isActiveYoloopStory(status) {
+    return typeof status === 'string'
+        && YOLOOP_ACTIVE_STORY_STATUS_SET.has(status.trim().toLowerCase().replace(/_/g, '-'));
+}
+function pickPublicScalarFields(value, allowlist) {
+    const result = {};
+    for (const key of allowlist) {
+        const field = value[key];
+        if (typeof field === 'string' || typeof field === 'boolean'
+            || typeof field === 'number' && Number.isFinite(field))
+            result[key] = field;
+        else if (Array.isArray(field) && field.every((item) => typeof item === 'string'))
+            result[key] = [...field];
+    }
+    return result;
+}
+function publicResumeCheckpoint(storyId, story) {
+    const value = story.checkpoint;
+    if (!isRecord(value) || value.schemaVersion !== 1 || value.storyId !== storyId
+        || value.epicId !== story.epic_id || !safeGitRef(value.branch)
+        || typeof value.baseSha !== 'string' || !/^[0-9a-f]{7,64}$/i.test(value.baseSha)
+        || typeof value.headSha !== 'string' || !/^[0-9a-f]{7,64}$/i.test(value.headSha)
+        || value.baseSha === value.headSha || !safeCanonicalToken(value.idempotencyKey)
+        || typeof value.recordedAt !== 'string' || !Number.isFinite(Date.parse(value.recordedAt))
+        || !Array.isArray(value.commits) || value.commits.length === 0 || value.commits.length > 256
+        || value.commits.some((sha) => typeof sha !== 'string' || !/^[0-9a-f]{7,64}$/i.test(sha))
+        || !Array.isArray(value.receiptRefs) || value.receiptRefs.length === 0 || value.receiptRefs.length > 256
+        || value.receiptRefs.some((ref) => typeof ref !== 'string' || ref.length > 240 || ref.includes('..')
+            || !/^[A-Za-z0-9._:/#\-[\]]+$/.test(ref))
+        || !isRecord(value.qaReceipt) || value.qaReceipt.kind !== 'story_qa_evidence'
+        || value.qaReceipt.producer !== 'local-yolo-tdd'
+        || !['passed', 'blocked'].includes(String(value.qaVerdict))
+        || !['approved', 'changes-requested', 'pending'].includes(String(value.reviewVerdict)))
+        return undefined;
+    if (value.reviewVerdict === 'pending' ? value.reviewReceipt !== undefined : !isRecord(value.reviewReceipt))
+        return undefined;
+    // collectStateSnapshot already validated field values. Re-project the exact
+    // public allowlist so later hooks or synthetic callers cannot append content.
+    const result = pickPublicScalarFields(value, [
+        'schemaVersion', 'storyId', 'epicId', 'branch', 'baseSha', 'headSha',
+        'idempotencyKey', 'dispatchId', 'bundleId', 'bundleDigest', 'graphRevision',
+        'claimRevision', 'qaVerdict', 'reviewVerdict', 'recordedAt', 'commits',
+        'receiptRefs',
+    ]);
+    result.qaReceipt = pickPublicScalarFields(value.qaReceipt, [
+        'schemaVersion', 'kind', 'producer', 'evidenceVersion', 'storyId', 'epicId',
+        'contract', 'command', 'manifestDigest', 'gateIds', 'resultDigest', 'baseSha',
+        'headSha', 'bundleDigest', 'graphRevision', 'sourceEvidenceDigest', 'verdict',
+        'checkedAt', 'receiptRef',
+    ]);
+    if (isRecord(value.reviewReceipt)) {
+        result.reviewReceipt = pickPublicScalarFields(value.reviewReceipt, [
+            'schemaVersion', 'kind', 'producer', 'storyId', 'epicId', 'baseSha',
+            'headSha', 'bundleDigest', 'graphRevision', 'sourceEvidenceDigest',
+            'qaReceiptRef', 'verdict', 'reviewedAt', 'receiptRef',
+        ]);
+    }
+    return result;
+}
+function publicCheckpointVerification(storyId, story) {
+    const value = story.checkpoint_verification;
+    if (!isRecord(value) || value.schemaVersion !== 1
+        || value.kind !== 'story_checkpoint_physical_verification'
+        || value.producer !== 'client-p205-transient-v1' || value.publicSafe !== true
+        || value.storyId !== storyId || value.epicId !== story.epic_id
+        || !['verified', 'rejected'].includes(String(value.verdict)))
+        return undefined;
+    return pickPublicScalarFields(value, [
+        'schemaVersion', 'kind', 'producer', 'storyId', 'epicId', 'branch',
+        'baseSha', 'headSha', 'aggregateHeadSha', 'commitBodyDigest',
+        'changedPathsDigest', 'claimVerification', 'effectiveClaimRevision',
+        'command', 'manifestDigest', 'gateIds', 'resultDigest', 'graphRevision',
+        'executionEvidenceDigest', 'sourceEvidenceDigest', 'verifiedAt', 'verdict',
+        'reasonCodes', 'publicSafe',
+    ]);
+}
+function publicSchedulingCheckpointEvidence(storyId, story) {
+    const value = story.scheduling_checkpoint_evidence;
+    const allowed = new Set([
+        'schemaVersion', 'kind', 'producer', 'storyId', 'epicId', 'branch', 'baseSha', 'headSha',
+        'graphRevision', 'effectiveClaimRevision', 'sourceEvidenceDigest', 'verifiedAt', 'reasonCodes',
+        'integrationAuthorized', 'publicSafe',
+    ]);
+    if (!isRecord(value) || Object.keys(value).some((key) => !allowed.has(key))
+        || value.schemaVersion !== 1 || value.kind !== 'story_scheduling_checkpoint_evidence'
+        || value.producer !== 'client-git-physical-v1' || value.publicSafe !== true
+        || value.integrationAuthorized !== false || value.storyId !== storyId || value.epicId !== story.epic_id
+        || !safeGitRef(value.branch) || typeof value.baseSha !== 'string' || !/^[0-9a-f]{40,64}$/i.test(value.baseSha)
+        || typeof value.headSha !== 'string' || !/^[0-9a-f]{40,64}$/i.test(value.headSha)
+        || typeof value.graphRevision !== 'string' || !/^[0-9a-f]{64}$/i.test(value.graphRevision)
+        || typeof value.effectiveClaimRevision !== 'string' || !/^[0-9a-f]{64}$/i.test(value.effectiveClaimRevision)
+        || typeof value.sourceEvidenceDigest !== 'string' || !/^[0-9a-f]{64}$/i.test(value.sourceEvidenceDigest)
+        || typeof value.verifiedAt !== 'string' || !Number.isFinite(Date.parse(value.verifiedAt))
+        || !Array.isArray(value.reasonCodes) || value.reasonCodes.length !== 1
+        || value.reasonCodes[0] !== 'checkpoint-git-scheduling-verified')
+        return undefined;
+    return pickPublicScalarFields(value, [...allowed]);
+}
+function projectSchedulingLane(storyId, story) {
+    const projected = { ...story };
+    const evidence = publicSchedulingCheckpointEvidence(storyId, story);
+    if (evidence) {
+        projected.scheduling_checkpoint_evidence = evidence;
+        delete projected.checkpoint;
+        delete projected.checkpoint_verification;
+    }
+    else {
+        delete projected.scheduling_checkpoint_evidence;
+    }
+    return projected;
+}
+function isRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+function safeReasonCodes(...groups) {
+    const seen = new Set();
+    const reasonCodes = [];
+    for (const group of groups) {
+        for (const reasonCode of group ?? []) {
+            const safe = safeToken(reasonCode, 80);
+            if (!safe || seen.has(safe))
+                continue;
+            seen.add(safe);
+            reasonCodes.push(safe);
+            if (reasonCodes.length >= REASON_CODE_LIMIT)
+                return reasonCodes;
+        }
+    }
+    return reasonCodes;
+}
+function normalizeCommandToken(input) {
+    return input.trim().replace(/^@?\*/, '').replace(/^@/, '').toLowerCase();
+}
+function leadingCommandToken(input) {
+    return input.trim().split(/\s+/, 1)[0] ?? '';
+}
+function resolveCommandProjectionPolicy(args) {
+    // The exact published @epic-P{N} spelling is a one-token command and its
+    // own target. It must receive the same structural projection as *epic.
+    if (/^@epic-P[0-9]{1,12}$/.test(args.trim()))
+        return COMMAND_POLICY_BY_ID.epic;
+    const token = leadingCommandToken(args);
+    if (!token)
+        return COMMAND_POLICY_BY_ID.menu;
+    const normalized = normalizeCommandToken(token);
+    const commandId = COMMAND_NUMBER_TO_ID[normalized]
+        ?? COMMAND_ALIAS_TO_ID[normalized]
+        ?? normalized;
+    return COMMAND_POLICY_BY_ID[commandId] ?? null;
+}
+function createFullScope(trigger, snapshot, commandPolicy, projectionMode = 'full-compatible', reasonCodes = ['full-state']) {
+    return {
+        kind: 'full',
+        commandId: commandPolicy?.commandId ?? null,
+        stateProjectionPolicy: commandPolicy?.stateProjectionPolicy ?? null,
+        projectionMode,
+        trigger,
+        targetEpicId: null,
+        targetStoryId: null,
+        includedStoryCount: Object.keys(snapshot.stories).length,
+        includedEpicCount: Object.keys(snapshot.epics).length,
+        omittedStoryCount: 0,
+        omittedEpicCount: 0,
+        reason: 'full-state',
+        reasonCodes: safeReasonCodes(reasonCodes),
+    };
+}
+function fullSnapshot(trigger, snapshot, commandPolicy, projectionMode = 'full-compatible', reasonCodes = ['full-state']) {
+    const scope = createFullScope(trigger, snapshot, commandPolicy, projectionMode, reasonCodes);
+    return withStateSummary({
+        ...snapshot,
+        scope,
+    }, snapshot, scope);
+}
+function firstTokenIsStoryReference(args) {
+    const [firstToken] = args.trim().split(/\s+/, 1);
+    if (!firstToken)
+        return false;
+    return (/^[A-Z]?\d+(?:\.\d+)+$/i.test(firstToken.replace(/^@/, '')) ||
+        /(?:^|\/)[A-Z]?\d+(?:\.\d+)+\.story\.md$/i.test(firstToken.replace(/^@/, '')));
+}
+function extractStoryId(args) {
+    const storyFileMatch = args.match(/(?:^|[/@\s])([A-Z]?\d+(?:\.\d+)+)\.story\.md\b/i);
+    if (storyFileMatch?.[1])
+        return storyFileMatch[1];
+    const storyIdMatch = args.match(/(?:^|\s|@)([A-Z]?\d+(?:\.\d+)+)(?=$|\s)/i);
+    return storyIdMatch?.[1] ?? null;
+}
+function triggerRemainder(args) {
+    const trimmed = args.trim();
+    const firstWhitespace = trimmed.search(/\s/);
+    return firstWhitespace === -1 ? '' : trimmed.slice(firstWhitespace).trim();
+}
+function positionalTokens(args) {
+    return triggerRemainder(args)
+        .split(/\s+/)
+        .map((token) => token.replace(/^@/, '').replace(/^['"]|['"]$/g, ''))
+        .filter((token) => token.length > 0 && !token.startsWith('-'));
+}
+function firstPositionalArg(args) {
+    return positionalTokens(args)[0] ?? null;
+}
+function resolveEpicId(candidate, snapshot) {
+    const normalized = candidate.replace(/^@/, '').replace(/^epic-/i, '');
+    const withoutExtension = normalized.replace(/\.md$/i, '');
+    const candidates = [
+        withoutExtension,
+        withoutExtension.toUpperCase(),
+        /^p\d+$/i.test(withoutExtension)
+            ? `P${withoutExtension.replace(/^p/i, '')}`
+            : null,
+        /^\d+$/.test(withoutExtension) ? `P${withoutExtension}` : null,
+    ].filter((entry) => typeof entry === 'string' && entry.length > 0);
+    for (const entry of candidates) {
+        if (snapshot.epics[entry])
+            return entry;
+    }
+    return null;
+}
+function extractEpicIdFromCanonicalFile(args, snapshot) {
+    const match = args.match(/(?:^|[/@\s])epic-(P?\d+)\.md\b/i);
+    if (!match?.[1])
+        return null;
+    return resolveEpicId(match[1], snapshot);
+}
+function extractTargetEpicId(args, snapshot) {
+    const directEpic = args.trim().match(/^@epic-(P[0-9]{1,12})$/);
+    if (directEpic)
+        return resolveEpicId(directEpic[1], snapshot);
+    const fromFile = extractEpicIdFromCanonicalFile(args, snapshot);
+    if (fromFile)
+        return fromFile;
+    for (const token of positionalTokens(args)) {
+        if (/^[A-Z]?\d+(?:\.\d+)+$/i.test(token))
+            continue;
+        const fromToken = resolveEpicId(token, snapshot);
+        if (fromToken)
+            return fromToken;
+    }
+    return null;
+}
+function extractYoloopTargetEpicId(args, snapshot) {
+    const fromTarget = extractTargetEpicId(args, snapshot);
+    if (fromTarget)
+        return fromTarget;
+    const yoloop = snapshot.yoloop;
+    const sessionEpicId = yoloop?.state?.currentSession?.currentEpicId;
+    if (typeof sessionEpicId === 'string' && snapshot.epics[sessionEpicId]) {
+        return sessionEpicId;
+    }
+    const lockEpicId = yoloop?.lock?.currentEpicId ?? yoloop?.lock?.epicId;
+    if (typeof lockEpicId === 'string' && snapshot.epics[lockEpicId]) {
+        return lockEpicId;
+    }
+    return null;
+}
+function explicitYoloopEpicCandidate(args) {
+    const fromFile = args.match(/(?:^|[/@\s])epic-(P?\d+)\.md\b/i)?.[1];
+    if (fromFile)
+        return /^P/i.test(fromFile) ? fromFile.toUpperCase() : `P${fromFile}`;
+    for (const token of positionalTokens(args)) {
+        if (/^P\d+$/i.test(token))
+            return token.toUpperCase();
+        if (/^\d+$/.test(token))
+            return `P${token}`;
+    }
+    return null;
+}
+function storyEpicId(story, storyId) {
+    if (typeof story.epic_id === 'string' && story.epic_id.length > 0) {
+        return story.epic_id;
+    }
+    const derived = storyId.split('.').slice(0, -1).join('.');
+    return derived.length > 0 ? derived : null;
+}
+function isTerminalStoryStatus(status) {
+    return typeof status === 'string' && ['done', 'completed', 'merged', 'cancelled', 'canceled', 'abandoned'].includes(status.toLowerCase());
+}
+function addStoryAndDependencies(storyId, snapshot, includedStoryIds) {
+    if (includedStoryIds.has(storyId))
+        return;
+    const story = snapshot.stories[storyId];
+    if (!story)
+        return;
+    includedStoryIds.add(storyId);
+    const dependsOn = story.depends_on;
+    if (!Array.isArray(dependsOn))
+        return;
+    for (const dependencyId of dependsOn) {
+        if (typeof dependencyId === 'string') {
+            addStoryAndDependencies(dependencyId, snapshot, includedStoryIds);
+        }
+    }
+}
+function buildProjectedStories(targetStoryId, snapshot) {
+    const analysis = analyzeDependencyDag(snapshot.stories, [targetStoryId]);
+    const projectedStories = {};
+    for (const storyId of analysis.orderedIds) {
+        const story = snapshot.stories[storyId];
+        if (story) {
+            projectedStories[storyId] = story;
+        }
+    }
+    return projectedStories;
+}
+function buildProjectedEpics(projectedStories, snapshot, requiredEpicIds = []) {
+    const projectedEpics = {};
+    for (const epicId of requiredEpicIds) {
+        if (snapshot.epics[epicId]) {
+            projectedEpics[epicId] = snapshot.epics[epicId];
+        }
+    }
+    for (const [storyId, story] of Object.entries(projectedStories)) {
+        const epicId = storyEpicId(story, storyId);
+        if (epicId && snapshot.epics[epicId]) {
+            projectedEpics[epicId] = snapshot.epics[epicId];
+        }
+    }
+    return projectedEpics;
+}
+function addEpicAndDependencies(epicId, snapshot, includedEpicIds) {
+    if (includedEpicIds.has(epicId))
+        return;
+    const epic = snapshot.epics[epicId];
+    if (!epic)
+        return;
+    includedEpicIds.add(epicId);
+    const dependsOn = epic.depends_on;
+    if (!Array.isArray(dependsOn))
+        return;
+    for (const dependencyId of dependsOn) {
+        if (typeof dependencyId === 'string' && dependencyId.length > 0) {
+            addEpicAndDependencies(dependencyId, snapshot, includedEpicIds);
+        }
+    }
+}
+function buildProjectedYoloopEpics(targetEpicId, projectedStories, snapshot) {
+    const epicAnalysis = analyzeDependencyDag(snapshot.epics, [targetEpicId]);
+    const requiredEpicIds = new Set(epicAnalysis.orderedIds);
+    for (const [storyId, story] of Object.entries(projectedStories)) {
+        const parentEpicId = storyEpicId(story, storyId);
+        if (parentEpicId && snapshot.epics[parentEpicId])
+            requiredEpicIds.add(parentEpicId);
+    }
+    const projectedEpics = {};
+    for (const epicId of [...requiredEpicIds].sort((left, right) => left.localeCompare(right, 'en'))) {
+        const epic = snapshot.epics[epicId];
+        if (!epic)
+            continue;
+        projectedEpics[epicId] = epicId === targetEpicId ? epic : compactStructuralEpic(epicId, epic);
+    }
+    return projectedEpics;
+}
+function buildProjectedYoloopStories(targetEpicId, targetEpic, snapshot) {
+    const storyIds = targetEpic.stories;
+    if (!Array.isArray(storyIds)
+        || storyIds.some((storyId) => typeof storyId !== 'string' || storyId.length === 0)) {
+        throw new StructuralDagError('STRUCTURAL_DEPENDENCY_MISSING', {
+            nodes: 0,
+            edges: 0,
+            malformedStoryMemberships: 1,
+        });
+    }
+    const analysis = analyzeDependencyDag(snapshot.stories, storyIds);
+    const projectedStories = {};
+    for (const storyId of analysis.orderedIds) {
+        const story = snapshot.stories[storyId];
+        if (story) {
+            projectedStories[storyId] = storyEpicId(story, storyId) === targetEpicId
+                ? projectSchedulingLane(storyId, story)
+                : compactStructuralStory(storyId, story);
+        }
+    }
+    return projectedStories;
+}
+function buildTargetEpicCoverage(targetEpicId, targetEpic, projectedStories) {
+    const declaredStoryIds = [...targetEpic.stories]
+        .sort((left, right) => left.localeCompare(right, 'en'));
+    const includedStoryIds = Object.entries(projectedStories)
+        .filter(([storyId, story]) => storyEpicId(story, storyId) === targetEpicId)
+        .map(([storyId]) => storyId)
+        .sort((left, right) => left.localeCompare(right, 'en'));
+    const membershipSha256 = createHash('sha256')
+        .update(`target-epic-coverage-v1\0${JSON.stringify({ targetEpicId, declaredStoryIds, includedStoryIds })}`)
+        .digest('hex');
+    return {
+        schemaVersion: 'TargetEpicCoverage/1.0',
+        targetEpicId,
+        declaredStoryIds,
+        includedStoryIds,
+        membershipSha256,
+        publicSafe: true,
+    };
+}
+function compactStructuralStory(storyId, story) {
+    const dependsOn = Array.isArray(story.depends_on)
+        ? [...new Set(story.depends_on.filter((value) => typeof value === 'string' && value.length > 0))]
+            .sort((left, right) => left.localeCompare(right, 'en'))
+        : [];
+    const compact = {
+        id: safeToken(story.id) ?? storyId,
+        ...(safeToken(story.epic_id) ? { epic_id: safeToken(story.epic_id) } : {}),
+        ...(safeToken(story.status, 40) ? { status: safeToken(story.status, 40) } : {}),
+        depends_on: dependsOn,
+    };
+    const schedulingEvidence = publicSchedulingCheckpointEvidence(storyId, story);
+    if (!isActiveYoloopStory(story.status)) {
+        return { ...compact, ...(schedulingEvidence ? { scheduling_checkpoint_evidence: schedulingEvidence } : {}) };
+    }
+    const source = story.source === 'create-epic' || story.source === 'discovered'
+        ? story.source : undefined;
+    const branchName = safeGitRef(story.branch_name);
+    const lastStep = safeCanonicalToken(story.last_step, 120);
+    const steps = Array.isArray(story.steps_completed) && story.steps_completed.length <= 64
+        ? story.steps_completed.map((step) => safeCanonicalToken(step, 120))
+        : [];
+    const validSteps = steps.length > 0 && steps.every((step) => step !== undefined)
+        ? steps : undefined;
+    const prNumber = typeof story.pr_number === 'number' && Number.isSafeInteger(story.pr_number)
+        && story.pr_number > 0 ? story.pr_number : undefined;
+    const checkpoint = publicResumeCheckpoint(storyId, story);
+    const checkpointVerification = checkpoint ? publicCheckpointVerification(storyId, story) : undefined;
+    return {
+        ...compact,
+        ...(source ? { source } : {}),
+        ...(branchName ? { branch_name: branchName } : {}),
+        ...(lastStep ? { last_step: lastStep } : {}),
+        ...(validSteps ? { steps_completed: validSteps } : {}),
+        ...(prNumber ? { pr_number: prNumber } : {}),
+        ...(checkpoint ? { checkpoint } : {}),
+        ...(checkpointVerification ? { checkpoint_verification: checkpointVerification } : {}),
+        ...(schedulingEvidence ? { scheduling_checkpoint_evidence: schedulingEvidence } : {}),
+        ...(safeWriteRefs(story.files_to_modify) !== undefined
+            ? { files_to_modify: safeWriteRefs(story.files_to_modify) } : {}),
+        ...(safeWriteRefs(story.contracts) !== undefined
+            ? { contracts: safeWriteRefs(story.contracts) } : {}),
+        ...(safeWriteRefs(story.contract_refs) !== undefined
+            ? { contract_refs: safeWriteRefs(story.contract_refs) } : {}),
+        ...(safeWriteRefs(story.shared_surfaces) !== undefined
+            ? { shared_surfaces: safeWriteRefs(story.shared_surfaces) } : {}),
+    };
+}
+function compactStructuralEpic(epicId, epic) {
+    const stories = Array.isArray(epic.stories)
+        ? [...new Set(epic.stories.filter((value) => typeof value === 'string' && value.length > 0))]
+            .sort((left, right) => left.localeCompare(right, 'en'))
+        : [];
+    const dependsOn = Array.isArray(epic.depends_on)
+        ? [...new Set(epic.depends_on.filter((value) => typeof value === 'string' && value.length > 0))]
+            .sort((left, right) => left.localeCompare(right, 'en'))
+        : [];
+    return {
+        id: safeToken(epic.id) ?? epicId,
+        ...(safeToken(epic.status, 40) ? { status: safeToken(epic.status, 40) } : {}),
+        ...(safeToken(epic.lifecycle_classification, 40)
+            ? { lifecycle_classification: safeToken(epic.lifecycle_classification, 40) }
+            : {}),
+        stories,
+        depends_on: dependsOn,
+    };
+}
+function buildYoloopDiscoveryProjection(trigger, snapshot, commandPolicy) {
+    const storyAnalysis = analyzeDependencyDag(snapshot.stories);
+    const epicAnalysis = analyzeDependencyDag(snapshot.epics);
+    const projectedStories = Object.fromEntries(storyAnalysis.orderedIds.map((storyId) => [
+        storyId,
+        compactStructuralStory(storyId, snapshot.stories[storyId]),
+    ]));
+    const projectedEpics = Object.fromEntries(epicAnalysis.orderedIds.map((epicId) => [
+        epicId,
+        compactStructuralEpic(epicId, snapshot.epics[epicId]),
+    ]));
+    const scope = {
+        kind: 'projected',
+        commandId: commandPolicy.commandId,
+        stateProjectionPolicy: commandPolicy.stateProjectionPolicy,
+        projectionMode: 'yoloop-discovery',
+        trigger,
+        targetEpicId: null,
+        targetStoryId: null,
+        includedStoryCount: storyAnalysis.orderedIds.length,
+        includedEpicCount: epicAnalysis.orderedIds.length,
+        omittedStoryCount: 0,
+        omittedEpicCount: 0,
+        reason: 'targeted-invocation',
+        reasonCodes: safeReasonCodes([
+            'structural-required',
+            'yoloop-discovery',
+            `structural-edges-${storyAnalysis.edgeCount + epicAnalysis.edgeCount}`,
+            'content-fields-omitted',
+        ]),
+    };
+    return withStateSummary({
+        ...snapshot,
+        stories: projectedStories,
+        epics: projectedEpics,
+        scope,
+    }, snapshot, scope);
+}
+function buildProjectedTargetEpicStories(targetEpic, snapshot) {
+    const includedStoryIds = new Set();
+    const storyIds = targetEpic.stories;
+    if (Array.isArray(storyIds)) {
+        for (const storyId of storyIds) {
+            if (typeof storyId === 'string') {
+                addStoryAndDependencies(storyId, snapshot, includedStoryIds);
+            }
+        }
+    }
+    const projectedStories = {};
+    for (const storyId of includedStoryIds) {
+        const story = snapshot.stories[storyId];
+        if (story) {
+            projectedStories[storyId] = story;
+        }
+    }
+    return projectedStories;
+}
+function buildEpicStubs(snapshot) {
+    const projectedEpics = {};
+    for (const [epicId, epic] of Object.entries(snapshot.epics)) {
+        projectedEpics[epicId] = {
+            id: safeToken(epic.id) ?? epicId,
+            ...(safeToken(epic.status) ? { status: safeToken(epic.status) } : {}),
+            ...(EPIC_LIFECYCLE_CLASSIFICATIONS.includes(epic.lifecycle_classification)
+                ? { lifecycle_classification: epic.lifecycle_classification }
+                : {}),
+            ...(typeof epic.total_stories === 'number' && Number.isFinite(epic.total_stories)
+                ? { total_stories: epic.total_stories }
+                : {}),
+            ...(typeof epic.completed_stories === 'number' && Number.isFinite(epic.completed_stories)
+                ? { completed_stories: epic.completed_stories }
+                : {}),
+        };
+    }
+    return projectedEpics;
+}
+function countStatuses(records) {
+    const counts = {};
+    for (const record of Object.values(records)) {
+        const status = safeToken(record.status, 40) ?? 'unknown';
+        counts[status] = (counts[status] ?? 0) + 1;
+    }
+    return counts;
+}
+function countEpicLifecycles(records) {
+    const counts = Object.fromEntries(EPIC_LIFECYCLE_CLASSIFICATIONS.map((classification) => [classification, 0]));
+    for (const record of Object.values(records)) {
+        const classification = EPIC_LIFECYCLE_CLASSIFICATIONS.includes(record.lifecycle_classification)
+            ? record.lifecycle_classification
+            : 'active';
+        counts[classification] = (counts[classification] ?? 0) + 1;
+    }
+    return counts;
+}
+function isActiveEpicLifecycle(snapshot, epicId) {
+    if (!epicId)
+        return true;
+    const epic = snapshot.epics[epicId];
+    if (!epic)
+        return true;
+    return !EPIC_LIFECYCLE_CLASSIFICATIONS.includes(epic.lifecycle_classification) || epic.lifecycle_classification === 'active';
+}
+function sortableStoryTimestamp(story) {
+    for (const key of ['last_updated', 'updated_at', 'completed_at', 'created_at', 'discovered_at']) {
+        const value = story[key];
+        if (typeof value !== 'string')
+            continue;
+        const parsed = Date.parse(value);
+        if (Number.isFinite(parsed))
+            return parsed;
+    }
+    return 0;
+}
+function recentStories(snapshot) {
+    return Object.entries(snapshot.stories)
+        .map(([id, story]) => ({ id, story, timestamp: sortableStoryTimestamp(story) }))
+        .sort((left, right) => right.timestamp - left.timestamp || left.id.localeCompare(right.id))
+        .slice(0, RECENT_STORY_LIMIT)
+        .map(({ id, story }) => ({
+        id,
+        ...(safeToken(story.epic_id) ? { epicId: safeToken(story.epic_id) } : {}),
+        ...(safeToken(story.status, 40) ? { status: safeToken(story.status, 40) } : {}),
+        ...(safeToken(story.last_step ?? story.lastStep) ? { lastStep: safeToken(story.last_step ?? story.lastStep) } : {}),
+        ...(safeToken(story.last_updated ?? story.updated_at ?? story.completed_at ?? story.created_at)
+            ? { lastUpdated: safeToken(story.last_updated ?? story.updated_at ?? story.completed_at ?? story.created_at) }
+            : {}),
+    }));
+}
+function currentSessionRef(snapshot) {
+    const session = snapshot.current_session;
+    if (!session)
+        return undefined;
+    const ref = {
+        activeEpicId: safeToken(session.active_epic_id) ?? null,
+        activeStoryId: safeToken(session.active_story_id) ?? null,
+        activeStepId: safeToken(session.active_step_id) ?? null,
+        sessionId: safeToken(session.session_id) ?? null,
+        startedAt: safeToken(session.started_at) ?? null,
+    };
+    return Object.values(ref).some((value) => value !== null && value !== undefined) ? ref : undefined;
+}
+function yoloopSessionRef(snapshot) {
+    const yoloop = snapshot.yoloop;
+    if (!isRecord(yoloop))
+        return undefined;
+    const state = isRecord(yoloop.state) ? yoloop.state : undefined;
+    const currentSession = isRecord(state?.currentSession) ? state.currentSession : undefined;
+    const lock = isRecord(yoloop.lock) ? yoloop.lock : undefined;
+    const ref = {
+        ...(typeof yoloop.active === 'boolean' ? { active: yoloop.active } : {}),
+        currentEpicId: safeToken(currentSession?.currentEpicId ?? yoloop.currentEpicId) ?? null,
+        currentStoryId: safeToken(currentSession?.currentStoryId ?? yoloop.currentStoryId) ?? null,
+        sessionId: safeToken(currentSession?.sessionId ?? yoloop.sessionId) ?? null,
+        lockEpicId: safeToken(lock?.currentEpicId ?? lock?.epicId) ?? null,
+    };
+    return Object.keys(ref).length > 0 ? ref : undefined;
+}
+function continuitySessionRef(snapshot) {
+    const continuity = snapshot.continuity;
+    if (!isRecord(continuity))
+        return undefined;
+    const reasonCodes = Array.isArray(continuity.reasonCodes)
+        ? continuity.reasonCodes.filter((entry) => typeof entry === 'string')
+        : undefined;
+    return {
+        present: true,
+        activeJobId: safeToken(continuity.activeJobId ?? continuity.jobId) ?? null,
+        activeGoalId: safeToken(continuity.activeGoalId ?? continuity.goalId) ?? null,
+        activeLoopId: safeToken(continuity.activeLoopId ?? continuity.loopId) ?? null,
+        ...(reasonCodes && reasonCodes.length > 0 ? { reasonCodes: safeReasonCodes(reasonCodes) } : {}),
+    };
+}
+function deriveActiveRef(snapshot, session, yoloop) {
+    const sessionStoryId = safeToken(session?.activeStoryId);
+    const sessionEpicId = safeToken(session?.activeEpicId);
+    const sessionStepId = safeToken(session?.activeStepId);
+    const sessionStoryEpicId = sessionStoryId && snapshot.stories[sessionStoryId]
+        ? storyEpicId(snapshot.stories[sessionStoryId], sessionStoryId)
+        : null;
+    if ((sessionStoryId || sessionEpicId || sessionStepId) && isActiveEpicLifecycle(snapshot, sessionEpicId ?? sessionStoryEpicId)) {
+        return {
+            epicId: sessionEpicId ?? null,
+            storyId: sessionStoryId ?? null,
+            stepId: sessionStepId ?? null,
+        };
+    }
+    const yoloopStoryId = safeToken(yoloop?.currentStoryId);
+    const yoloopEpicId = safeToken(yoloop?.currentEpicId ?? yoloop?.lockEpicId);
+    if ((yoloopStoryId || yoloopEpicId) && isActiveEpicLifecycle(snapshot, yoloopEpicId)) {
+        return {
+            epicId: yoloopEpicId ?? null,
+            storyId: yoloopStoryId ?? null,
+            stepId: null,
+        };
+    }
+    const latestNonTerminal = Object.entries(snapshot.stories)
+        .map(([id, story]) => ({ id, story, timestamp: sortableStoryTimestamp(story) }))
+        .filter(({ id, story }) => !isTerminalStoryStatus(story.status) && isActiveEpicLifecycle(snapshot, storyEpicId(story, id)))
+        .sort((left, right) => right.timestamp - left.timestamp || left.id.localeCompare(right.id))[0];
+    if (latestNonTerminal) {
+        return {
+            epicId: storyEpicId(latestNonTerminal.story, latestNonTerminal.id),
+            storyId: latestNonTerminal.id,
+            stepId: safeToken(latestNonTerminal.story.last_step ?? latestNonTerminal.story.lastStep) ?? null,
+        };
+    }
+    return { epicId: null, storyId: null, stepId: null };
+}
+function buildStateSummary(sourceSnapshot, scope) {
+    const storyStatus = countStatuses(sourceSnapshot.stories);
+    const epicStatus = countStatuses(sourceSnapshot.epics);
+    const epicLifecycle = countEpicLifecycles(sourceSnapshot.epics);
+    const activeEpics = Object.values(sourceSnapshot.epics).filter((epic) => {
+        const lifecycle = EPIC_LIFECYCLE_CLASSIFICATIONS.includes(epic.lifecycle_classification)
+            ? epic.lifecycle_classification
+            : 'active';
+        return lifecycle === 'active' && !isTerminalStoryStatus(epic.status);
+    }).length;
+    const session = currentSessionRef(sourceSnapshot);
+    const yoloop = yoloopSessionRef(sourceSnapshot);
+    const continuity = continuitySessionRef(sourceSnapshot);
+    const active = deriveActiveRef(sourceSnapshot, session, yoloop);
+    const recent = recentStories(sourceSnapshot);
+    const reasonCodes = safeReasonCodes(scope.reasonCodes, [
+        'state-summary-attached',
+        'state-summary-bounded',
+        `projection-${scope.projectionMode ?? scope.kind}`,
+        scope.stateProjectionPolicy ? `policy-${scope.stateProjectionPolicy}` : 'policy-unknown',
+        recent.length >= RECENT_STORY_LIMIT ? 'recent-stories-capped' : 'recent-stories-bounded',
+        active.storyId || active.epicId ? 'active-ref-derived' : 'active-ref-empty',
+        yoloop ? 'yoloop-session-present' : 'yoloop-session-absent',
+        continuity ? 'continuity-session-present' : 'continuity-session-absent',
+    ]);
+    return {
+        schemaVersion: 1,
+        totals: {
+            stories: Object.keys(sourceSnapshot.stories).length,
+            epics: Object.keys(sourceSnapshot.epics).length,
+            storyStatus,
+            epicStatus,
+            epicLifecycle,
+            activeEpics,
+            blockedStories: storyStatus.blocked ?? 0,
+        },
+        active,
+        blockedCount: storyStatus.blocked ?? 0,
+        recentStories: recent,
+        ...(session ? { currentSession: session } : {}),
+        ...(yoloop ? { currentYoloopSession: yoloop } : {}),
+        ...(continuity ? { currentContinuitySession: continuity } : {}),
+        projection: {
+            commandId: scope.commandId ?? null,
+            stateProjectionPolicy: scope.stateProjectionPolicy ?? null,
+            projectionMode: scope.projectionMode,
+            scopeKind: scope.kind,
+            includedStoryCount: scope.includedStoryCount,
+            includedEpicCount: scope.includedEpicCount ?? Object.keys(sourceSnapshot.epics).length,
+            omittedStoryCount: scope.omittedStoryCount,
+            omittedEpicCount: scope.omittedEpicCount,
+            reason: scope.reason,
+        },
+        reasonCodes,
+        publicSafe: true,
+    };
+}
+function withStateSummary(projected, sourceSnapshot, scope) {
+    return {
+        ...projected,
+        stateSummary: buildStateSummary(sourceSnapshot, scope),
+    };
+}
+function buildCreateEpicProjection(trigger, snapshot, commandPolicy) {
+    const projectedEpics = {};
+    for (const epicId of Object.keys(snapshot.epics)) {
+        projectedEpics[epicId] = { id: epicId };
+    }
+    const scope = {
+        kind: 'projected',
+        commandId: commandPolicy.commandId,
+        stateProjectionPolicy: commandPolicy.stateProjectionPolicy,
+        projectionMode: 'summary-only',
+        trigger,
+        targetEpicId: null,
+        targetStoryId: null,
+        includedStoryCount: 0,
+        includedEpicCount: Object.keys(projectedEpics).length,
+        omittedStoryCount: Object.keys(snapshot.stories).length,
+        omittedEpicCount: 0,
+        reason: 'epic-summary',
+        reasonCodes: ['epic-summary', 'stories-omitted', 'epic-stubs-only'],
+    };
+    return withStateSummary({
+        ...snapshot,
+        stories: {},
+        epics: projectedEpics,
+        scope,
+    }, snapshot, scope);
+}
+function buildSummaryOnlyProjection(trigger, snapshot, commandPolicy, reasonCodes = ['summary-only', 'stories-omitted'], projectionMode = 'summary-only') {
+    const projectedEpics = buildEpicStubs(snapshot);
+    const scope = {
+        kind: 'projected',
+        commandId: commandPolicy.commandId,
+        stateProjectionPolicy: commandPolicy.stateProjectionPolicy,
+        projectionMode,
+        trigger,
+        targetEpicId: null,
+        targetStoryId: null,
+        includedStoryCount: 0,
+        includedEpicCount: Object.keys(projectedEpics).length,
+        omittedStoryCount: Object.keys(snapshot.stories).length,
+        omittedEpicCount: Math.max(0, Object.keys(snapshot.epics).length - Object.keys(projectedEpics).length),
+        reason: 'summary-only',
+        reasonCodes: safeReasonCodes(reasonCodes),
+    };
+    return withStateSummary({
+        ...snapshot,
+        stories: {},
+        epics: projectedEpics,
+        scope,
+    }, snapshot, scope);
+}
+function buildStoryProjection(trigger, snapshot, commandPolicy, targetStoryId, projectionMode, reasonCodes) {
+    const targetStory = snapshot.stories[targetStoryId];
+    if (!targetStory) {
+        throw new StructuralDagError('STRUCTURAL_TARGET_NOT_FOUND', {
+            stories: Object.keys(snapshot.stories).length,
+            epics: Object.keys(snapshot.epics).length,
+            targetKind: 'story',
+        });
+    }
+    const targetEpicId = storyEpicId(targetStory, targetStoryId);
+    if (!targetEpicId) {
+        throw new StructuralDagError('STRUCTURAL_TARGET_NOT_FOUND', {
+            stories: Object.keys(snapshot.stories).length,
+            epics: Object.keys(snapshot.epics).length,
+            targetKind: 'epic',
+        });
+    }
+    const targetEpic = snapshot.epics[targetEpicId];
+    if (!targetEpic) {
+        throw new StructuralDagError('STRUCTURAL_TARGET_NOT_FOUND', {
+            stories: Object.keys(snapshot.stories).length,
+            epics: Object.keys(snapshot.epics).length,
+            targetKind: 'epic',
+        });
+    }
+    // Direct *yolo needs the same epic topology seen by *yoloop so a standalone
+    // invocation can bootstrap the canonical P207 graph epoch. Other story
+    // commands remain dependency-scoped. Stories outside the owning epic are
+    // retained only as compact structural dependencies by the yoloop projector.
+    const yoloEpicGraph = projectionMode === 'yolo-story';
+    const projectedStories = yoloEpicGraph
+        ? buildProjectedYoloopStories(targetEpicId, targetEpic, snapshot)
+        : buildProjectedStories(targetStoryId, snapshot);
+    const projectedEpics = yoloEpicGraph
+        ? buildProjectedYoloopEpics(targetEpicId, projectedStories, snapshot)
+        : buildProjectedEpics(projectedStories, snapshot);
+    if (!projectedStories[targetStoryId] || !projectedEpics[targetEpicId]) {
+        throw new StructuralDagError('STRUCTURAL_TARGET_NOT_FOUND', {
+            stories: Object.keys(projectedStories).length,
+            epics: Object.keys(projectedEpics).length,
+            targetKind: 'story',
+        });
+    }
+    const scope = {
+        kind: 'projected',
+        commandId: commandPolicy.commandId,
+        stateProjectionPolicy: commandPolicy.stateProjectionPolicy,
+        projectionMode,
+        trigger,
+        targetEpicId,
+        targetStoryId,
+        includedStoryCount: Object.keys(projectedStories).length,
+        includedEpicCount: Object.keys(projectedEpics).length,
+        omittedStoryCount: Math.max(0, Object.keys(snapshot.stories).length - Object.keys(projectedStories).length),
+        omittedEpicCount: Math.max(0, Object.keys(snapshot.epics).length - Object.keys(projectedEpics).length),
+        reason: 'targeted-invocation',
+        reasonCodes: safeReasonCodes(reasonCodes, yoloEpicGraph ? ['epic-graph-authority-complete'] : []),
+    };
+    return withStateSummary({
+        ...snapshot,
+        stories: projectedStories,
+        epics: projectedEpics,
+        scope,
+    }, snapshot, scope);
+}
+function buildTargetedEpicProjection(trigger, snapshot, commandPolicy, targetEpicId, projectionMode, reasonCodes) {
+    const targetEpic = snapshot.epics[targetEpicId];
+    if (!targetEpic) {
+        throw new StructuralDagError('STRUCTURAL_TARGET_NOT_FOUND', {
+            stories: Object.keys(snapshot.stories).length,
+            epics: Object.keys(snapshot.epics).length,
+            targetKind: 'epic',
+        });
+    }
+    const projectedStories = buildProjectedTargetEpicStories(targetEpic, snapshot);
+    const projectedEpics = buildProjectedEpics(projectedStories, snapshot, [targetEpicId]);
+    if (!projectedEpics[targetEpicId]) {
+        throw new StructuralDagError('STRUCTURAL_TARGET_NOT_FOUND', {
+            stories: Object.keys(projectedStories).length,
+            epics: Object.keys(projectedEpics).length,
+            targetKind: 'epic',
+        });
+    }
+    const scope = {
+        kind: 'projected',
+        commandId: commandPolicy.commandId,
+        stateProjectionPolicy: commandPolicy.stateProjectionPolicy,
+        projectionMode,
+        trigger,
+        targetEpicId,
+        targetStoryId: null,
+        includedStoryCount: Object.keys(projectedStories).length,
+        includedEpicCount: Object.keys(projectedEpics).length,
+        omittedStoryCount: Math.max(0, Object.keys(snapshot.stories).length - Object.keys(projectedStories).length),
+        omittedEpicCount: Math.max(0, Object.keys(snapshot.epics).length - Object.keys(projectedEpics).length),
+        reason: 'targeted-invocation',
+        reasonCodes: safeReasonCodes(reasonCodes),
+    };
+    return withStateSummary({
+        ...snapshot,
+        stories: projectedStories,
+        epics: projectedEpics,
+        scope,
+    }, snapshot, scope);
+}
+function buildYoloopProjection(trigger, snapshot, commandPolicy) {
+    const explicitCandidate = explicitYoloopEpicCandidate(trigger);
+    const explicitTargetEpicId = extractTargetEpicId(trigger, snapshot);
+    if (explicitCandidate && !explicitTargetEpicId) {
+        throw new StructuralDagError('STRUCTURAL_TARGET_NOT_FOUND', {
+            stories: Object.keys(snapshot.stories).length,
+            epics: Object.keys(snapshot.epics).length,
+            targetKind: 'epic',
+        });
+    }
+    const targetEpicId = extractYoloopTargetEpicId(trigger, snapshot);
+    const shape = classifyInvocationShapeV2({
+        commandId: commandPolicy.commandId,
+        explicitYoloopEpicId: explicitTargetEpicId,
+        sessionYoloopEpicId: explicitTargetEpicId ? null : targetEpicId,
+    });
+    if (shape === 'yoloop-discovery')
+        return buildYoloopDiscoveryProjection(trigger, snapshot, commandPolicy);
+    if (!targetEpicId || (shape !== 'yoloop-target' && shape !== 'yoloop-session')) {
+        throw new StructuralDagError('STRUCTURAL_TARGET_NOT_FOUND', {
+            stories: Object.keys(snapshot.stories).length,
+            epics: Object.keys(snapshot.epics).length,
+            targetKind: 'epic',
+        });
+    }
+    const targetEpic = snapshot.epics[targetEpicId];
+    if (!targetEpic) {
+        throw new StructuralDagError('STRUCTURAL_TARGET_NOT_FOUND', {
+            stories: Object.keys(snapshot.stories).length,
+            epics: Object.keys(snapshot.epics).length,
+            targetKind: 'epic',
+        });
+    }
+    const projectedStories = buildProjectedYoloopStories(targetEpicId, targetEpic, snapshot);
+    const projectedEpics = buildProjectedYoloopEpics(targetEpicId, projectedStories, snapshot);
+    if (!projectedEpics[targetEpicId]) {
+        throw new StructuralDagError('STRUCTURAL_TARGET_NOT_FOUND', {
+            stories: Object.keys(projectedStories).length,
+            epics: Object.keys(projectedEpics).length,
+            targetKind: 'epic',
+        });
+    }
+    const projectionMode = shape;
+    const scope = {
+        kind: 'projected',
+        commandId: commandPolicy.commandId,
+        stateProjectionPolicy: commandPolicy.stateProjectionPolicy,
+        projectionMode,
+        trigger,
+        targetEpicId,
+        targetStoryId: null,
+        targetEpicCoverage: buildTargetEpicCoverage(targetEpicId, targetEpic, projectedStories),
+        includedStoryCount: Object.keys(projectedStories).length,
+        includedEpicCount: Object.keys(projectedEpics).length,
+        omittedStoryCount: Math.max(0, Object.keys(snapshot.stories).length - Object.keys(projectedStories).length),
+        omittedEpicCount: Math.max(0, Object.keys(snapshot.epics).length - Object.keys(projectedEpics).length),
+        reason: 'targeted-invocation',
+        reasonCodes: ['structural-required', projectionMode, 'yoloop-targeted'],
+    };
+    return withStateSummary({
+        ...snapshot,
+        stories: projectedStories,
+        epics: projectedEpics,
+        scope,
+    }, snapshot, scope);
+}
+function buildPayloadGuardrailEpics(snapshot, retainedStoryIds) {
+    const projectedEpics = {};
+    for (const [epicId, epic] of Object.entries(snapshot.epics)) {
+        const retainedEpicStories = Array.isArray(epic.stories)
+            ? epic.stories.filter((storyId) => typeof storyId === 'string' && retainedStoryIds.has(storyId))
+            : [];
+        projectedEpics[epicId] = {
+            id: safeToken(epic.id) ?? epicId,
+            ...(safeToken(epic.status, 40) ? { status: safeToken(epic.status, 40) } : {}),
+            ...(typeof epic.total_stories === 'number' && Number.isFinite(epic.total_stories)
+                ? { total_stories: epic.total_stories }
+                : {}),
+            ...(typeof epic.completed_stories === 'number' && Number.isFinite(epic.completed_stories)
+                ? { completed_stories: epic.completed_stories }
+                : {}),
+            ...(retainedEpicStories.length > 0 ? { stories: retainedEpicStories } : {}),
+            ...(retainedEpicStories.length > 0 && Array.isArray(epic.depends_on)
+                ? { depends_on: epic.depends_on.filter((value) => typeof value === 'string' && value.length > 0) }
+                : {}),
+            ...(retainedEpicStories.length > 0 && (epic.branch_mode === 'epic' || epic.branch_mode === 'story')
+                ? { branch_mode: epic.branch_mode }
+                : {}),
+            ...(retainedEpicStories.length > 0 && typeof epic.execution_branch === 'string'
+                ? { execution_branch: epic.execution_branch }
+                : {}),
+            ...(retainedEpicStories.length > 0 && typeof epic.origin_branch === 'string'
+                ? { origin_branch: epic.origin_branch }
+                : {}),
+            ...(retainedEpicStories.length > 0 && (epic.branch_lease === null || typeof epic.branch_lease === 'object')
+                ? { branch_lease: epic.branch_lease }
+                : {}),
+            ...(retainedEpicStories.length > 0 && (epic.origin_binding === null || typeof epic.origin_binding === 'object')
+                ? { origin_binding: epic.origin_binding }
+                : {}),
+            ...(retainedEpicStories.length > 0 && (epic.aggregate_qa_receipt === null || typeof epic.aggregate_qa_receipt === 'object')
+                ? { aggregate_qa_receipt: epic.aggregate_qa_receipt }
+                : {}),
+        };
+    }
+    return projectedEpics;
+}
+function sourceStoryTotal(snapshot) {
+    return snapshot.stateSummary?.totals.stories
+        ?? ((snapshot.scope?.includedStoryCount ?? Object.keys(snapshot.stories).length) + (snapshot.scope?.omittedStoryCount ?? 0));
+}
+function sourceEpicTotal(snapshot) {
+    return snapshot.stateSummary?.totals.epics
+        ?? ((snapshot.scope?.includedEpicCount ?? Object.keys(snapshot.epics).length) + (snapshot.scope?.omittedEpicCount ?? 0));
+}
+function updateStateSummaryForPayloadGuardrail(snapshot, scope) {
+    if (!snapshot.stateSummary)
+        return undefined;
+    return {
+        ...snapshot.stateSummary,
+        projection: {
+            ...snapshot.stateSummary.projection,
+            scopeKind: 'projected',
+            projectionMode: scope.projectionMode,
+            includedStoryCount: scope.includedStoryCount,
+            includedEpicCount: scope.includedEpicCount ?? snapshot.stateSummary.projection.includedEpicCount,
+            omittedStoryCount: scope.omittedStoryCount,
+            omittedEpicCount: scope.omittedEpicCount,
+            reason: 'body-size',
+        },
+        reasonCodes: safeReasonCodes(snapshot.stateSummary.reasonCodes, ['payload-size-guardrail', 'state-summary-preserved', 'nonessential-state-degraded']),
+    };
+}
+/**
+ * P198.04 -- deterministic post-assembly state degradation.
+ *
+ * This helper is intentionally pure and request-only. It removes historical story
+ * bodies that are not structural for the already-projected request, converts the
+ * epic map to public stubs, keeps `stateSummary`, and preserves structural-required
+ * story/yolo/yoloop target state instead of silently corrupting it.
+ */
+export function degradeStateSnapshotForPayloadLimit(snapshot) {
+    const scope = snapshot.scope;
+    const retainedStoryIds = new Set();
+    const preserveProjectedStructuralStories = scope?.projectionMode === 'structural-required'
+        || scope?.projectionMode === 'yolo-story'
+        || scope?.projectionMode === 'yoloop-target'
+        || scope?.projectionMode === 'yoloop-session'
+        || scope?.projectionMode === 'yoloop-discovery';
+    if (preserveProjectedStructuralStories) {
+        for (const storyId of Object.keys(snapshot.stories)) {
+            retainedStoryIds.add(storyId);
+        }
+    }
+    else if (scope?.targetStoryId) {
+        addStoryAndDependencies(scope.targetStoryId, snapshot, retainedStoryIds);
+    }
+    const projectedStories = {};
+    for (const storyId of retainedStoryIds) {
+        const story = snapshot.stories[storyId];
+        if (story)
+            projectedStories[storyId] = story;
+    }
+    const projectedEpics = buildPayloadGuardrailEpics(snapshot, retainedStoryIds);
+    const includedStoryCount = Object.keys(projectedStories).length;
+    const includedEpicCount = Object.keys(projectedEpics).length;
+    const omittedStoryCount = Math.max(0, sourceStoryTotal(snapshot) - includedStoryCount);
+    const omittedEpicCount = Math.max(0, sourceEpicTotal(snapshot) - includedEpicCount);
+    const projectionMode = preserveProjectedStructuralStories
+        ? scope?.projectionMode ?? 'structural-required'
+        : scope?.projectionMode === 'yolo-story'
+            ? 'yolo-story'
+            : 'summary-only';
+    const nextScope = {
+        kind: 'projected',
+        commandId: scope?.commandId ?? null,
+        stateProjectionPolicy: scope?.stateProjectionPolicy ?? null,
+        projectionMode,
+        targetEpicId: scope?.targetEpicId ?? null,
+        targetStoryId: scope?.targetStoryId ?? null,
+        ...(scope?.targetEpicCoverage ? { targetEpicCoverage: scope.targetEpicCoverage } : {}),
+        includedStoryCount,
+        includedEpicCount,
+        omittedStoryCount,
+        omittedEpicCount,
+        reason: 'body-size',
+        reasonCodes: safeReasonCodes(scope?.reasonCodes, [
+            'payload-size-guardrail',
+            retainedStoryIds.size > 0 ? 'structural-targets-preserved' : 'stories-omitted',
+            'epics-stubbed',
+            'state-summary-preserved',
+            'redundant-trigger-omitted',
+        ]),
+    };
+    const stateSummary = updateStateSummaryForPayloadGuardrail(snapshot, nextScope);
+    return {
+        ...snapshot,
+        stories: projectedStories,
+        epics: projectedEpics,
+        scope: nextScope,
+        ...(stateSummary ? { stateSummary } : {}),
+    };
+}
+/**
+ * Return a request-scoped state snapshot for invoke commands.
+ *
+ * The function is intentionally pure. Structural uncertainty fails closed;
+ * callers must surface the public code instead of sending a full-state fallback.
+ */
+export function projectStateSnapshotForInvoke(args, snapshot) {
+    const trigger = args.trim();
+    const commandPolicy = resolveCommandProjectionPolicy(trigger);
+    try {
+        if (!commandPolicy) {
+            if (firstTokenIsStoryReference(trigger)) {
+                const storyReferencePolicy = policy('story-reference', 'story-targeted');
+                const targetStoryId = extractStoryId(trigger);
+                if (targetStoryId) {
+                    return buildStoryProjection(trigger, snapshot, storyReferencePolicy, targetStoryId, 'targeted-story', ['story-reference-targeted']);
+                }
+            }
+            return buildSummaryOnlyProjection(trigger, snapshot, policy('unknown', 'adaptive-targeted'), ['unknown-command-summary-only']);
+        }
+        if (commandPolicy.stateProjectionPolicy === 'epic-summary') {
+            return buildCreateEpicProjection(trigger, snapshot, commandPolicy);
+        }
+        if (commandPolicy.stateProjectionPolicy === 'yoloop-targeted') {
+            return buildYoloopProjection(trigger, snapshot, commandPolicy);
+        }
+        const targetStoryId = extractStoryId(trigger);
+        if (commandPolicy.stateProjectionPolicy === 'story-targeted') {
+            if (targetStoryId) {
+                const invocationShape = classifyInvocationShapeV2({ commandId: commandPolicy.commandId, targetStoryId });
+                const yoloStory = invocationShape === 'yolo-story';
+                return buildStoryProjection(trigger, snapshot, commandPolicy, targetStoryId, yoloStory ? 'yolo-story' : commandPolicy.structuralRequired ? 'structural-required' : 'targeted-story', [yoloStory ? 'yolo-story' : commandPolicy.structuralRequired ? 'structural-required' : 'targeted-story']);
+            }
+            if (commandPolicy.commandId === 'yolo' || commandPolicy.commandId === 'yolo-inline') {
+                const invocationShape = classifyInvocationShapeV2({ commandId: commandPolicy.commandId });
+                return buildSummaryOnlyProjection(trigger, snapshot, commandPolicy, ['yolo-inline', 'stories-omitted', 'historical-content-omitted'], invocationShape ?? 'yolo-inline');
+            }
+            // Commit without a story is an exact root working-tree workflow. It
+            // needs no story graph, but a malformed or unknown target must not gain
+            // this summary-only escape from structural target validation.
+            if (commandPolicy.commandId === 'commit' && /^\*?(?:commit|commit-push)$/i.test(trigger)) {
+                return buildSummaryOnlyProjection(trigger, snapshot, commandPolicy, ['working-tree-commit', 'stories-omitted', 'historical-content-omitted']);
+            }
+            return commandPolicy.structuralRequired
+                ? (() => {
+                    throw new StructuralDagError('STRUCTURAL_TARGET_NOT_FOUND', {
+                        stories: Object.keys(snapshot.stories).length,
+                        epics: Object.keys(snapshot.epics).length,
+                        targetKind: 'story',
+                    });
+                })()
+                : buildSummaryOnlyProjection(trigger, snapshot, commandPolicy, ['story-target-missing-summary-only']);
+        }
+        if (commandPolicy.stateProjectionPolicy === 'adaptive-targeted') {
+            if (targetStoryId && snapshot.stories[targetStoryId]) {
+                return buildStoryProjection(trigger, snapshot, commandPolicy, targetStoryId, 'targeted-story', ['adaptive-story-targeted']);
+            }
+            const targetEpicId = extractTargetEpicId(trigger, snapshot);
+            if (targetEpicId) {
+                return buildTargetedEpicProjection(trigger, snapshot, commandPolicy, targetEpicId, 'targeted-epic', ['adaptive-epic-targeted']);
+            }
+            return buildSummaryOnlyProjection(trigger, snapshot, commandPolicy, ['adaptive-summary-only', 'target-unresolved-summary-only']);
+        }
+        if (commandPolicy.stateProjectionPolicy === 'epic-targeted') {
+            // The root *arch-plan pipeline delegates its current stage with the
+            // internal marker `epic-arch`. It has no user-selected epic yet; keep
+            // this exact marker only when the bounded root checkpoint names the
+            // same stage. The server still verifies the accounting receipt.
+            if (commandPolicy.commandId.startsWith('arch-')
+                && /(?:^|\s)epic-arch\s*$/i.test(trigger)
+                && snapshot.archPlan?.execution?.currentStageCommand === commandPolicy.commandId) {
+                return buildSummaryOnlyProjection(trigger, snapshot, commandPolicy, ['architecture-root-delegated']);
+            }
+            const targetEpicId = extractTargetEpicId(trigger, snapshot);
+            if (targetEpicId) {
+                return buildTargetedEpicProjection(trigger, snapshot, commandPolicy, targetEpicId, commandPolicy.structuralRequired ? 'structural-required' : 'targeted-epic', [commandPolicy.structuralRequired ? 'structural-required' : 'targeted-epic']);
+            }
+            return commandPolicy.structuralRequired
+                ? (() => {
+                    throw new StructuralDagError('STRUCTURAL_TARGET_NOT_FOUND', {
+                        stories: Object.keys(snapshot.stories).length,
+                        epics: Object.keys(snapshot.epics).length,
+                        targetKind: 'epic',
+                    });
+                })()
+                : buildSummaryOnlyProjection(trigger, snapshot, commandPolicy, ['epic-target-missing-summary-only']);
+        }
+        if (commandPolicy.stateProjectionPolicy === 'continuity-scoped') {
+            return buildSummaryOnlyProjection(trigger, snapshot, commandPolicy, ['continuity-scoped-summary-only']);
+        }
+        return buildSummaryOnlyProjection(trigger, snapshot, commandPolicy, ['policy-full-summary-only']);
+    }
+    catch (error) {
+        if (error instanceof StructuralDagError)
+            throw error;
+        if (commandPolicy?.structuralRequired) {
+            throw new StructuralDagError('STRUCTURAL_DEPENDENCY_MISSING', {
+                stories: Object.keys(snapshot.stories).length,
+                epics: Object.keys(snapshot.epics).length,
+                projectionErrors: 1,
+            });
+        }
+        return buildSummaryOnlyProjection(trigger, snapshot, commandPolicy ?? policy('unknown', 'adaptive-targeted'), ['projection-error-summary-only']);
+    }
+}
+const V2_INVOCATION_SHAPES = new Set([
+    'yolo-story',
+    'yolo-inline',
+    'yoloop-target',
+    'yoloop-session',
+    'yoloop-discovery',
+]);
+function projectedEdgeCount(snapshot) {
+    let edges = 0;
+    for (const collection of [snapshot.stories, snapshot.epics]) {
+        for (const entry of Object.values(collection)) {
+            if (Array.isArray(entry.depends_on)) {
+                edges += entry.depends_on.filter((value) => typeof value === 'string').length;
+            }
+        }
+    }
+    return edges;
+}
+/**
+ * Versioned result contract for the five structural YOLO/yoloop shapes.
+ * Other command families retain their existing projection policy and return
+ * null because they are outside StateProjectionV2's closed shape union.
+ */
+export function projectStateSnapshotResultV2ForInvoke(args, snapshot) {
+    const commandPolicy = resolveCommandProjectionPolicy(args.trim());
+    if (!commandPolicy
+        || !['yolo', 'yolo-inline', 'yoloop'].includes(commandPolicy.commandId)) {
+        return null;
+    }
+    try {
+        const projected = projectStateSnapshotForInvoke(args, snapshot);
+        const shape = projected.scope?.projectionMode;
+        if (!shape || !V2_INVOCATION_SHAPES.has(shape)) {
+            throw new StructuralDagError('STRUCTURAL_DEPENDENCY_MISSING', {
+                stories: Object.keys(projected.stories).length,
+                epics: Object.keys(projected.epics).length,
+                projectionShapeErrors: 1,
+            });
+        }
+        return Object.freeze({
+            ok: true,
+            version: 2,
+            shape,
+            snapshot: projected,
+            included: {
+                epics: projected.scope?.includedEpicCount ?? Object.keys(projected.epics).length,
+                stories: projected.scope?.includedStoryCount ?? Object.keys(projected.stories).length,
+                edges: projectedEdgeCount(projected),
+            },
+            omitted: {
+                epics: projected.scope?.omittedEpicCount ?? 0,
+                stories: projected.scope?.omittedStoryCount ?? 0,
+            },
+            cycleCount: 0,
+        });
+    }
+    catch (error) {
+        if (!(error instanceof StructuralDagError))
+            throw error;
+        return Object.freeze({
+            ok: false,
+            code: error.code,
+            publicDetails: error.publicDetails,
+        });
+    }
+}