@ornexus/neocortex 4.60.22 → 4.60.24

package/packages/client/dist/yoloop/shared-discover-epics.js

@@ -1 +1 @@
-const me=Object.freeze({epicId:"P{number}",epicFilename:"docs/epics/epic-P{number}.md",storyId:"P{number}.NN",storyFilename:"docs/stories/P{number}.NN.story.md",acceptedOnly:Object.freeze({epicFilenames:Object.freeze(["docs/epics/epic-{number}.md","docs/epics/EPIC-{number}-{slug}.md","docs/epics/EPIC-{number}_{slug}.md","docs/epics/epic-{slug}.md"]),storyFilenames:Object.freeze(["docs/stories/{number}.NN.story.md","docs/stories/story-P{number}.NN.md","docs/stories/story-{number}.NN.md","docs/stories/EPIC-{number}.STORY-{number}.md"])})}),E=Object.freeze([/^epic-(P?\d+(?:\.\d+)?)\.md$/i,/^EPIC-(\d+)(?:[-_].*)?\.md$/,/^epic-([a-z0-9][a-z0-9_-]*)\.md$/i]),j=Object.freeze([/^(P?\d+\.\d+(?:\.\d+)?)\.story\.md$/i,/^story-(P?\d+\.\d+)\.md$/i,/^EPIC-(\d+)\.STORY-(\d+)\.md$/]),x=Object.freeze([".archive","_archive","_archives","_drafts","archive","archives","archived","drafts"]),A=/^---\s*\n([\s\S]*?)\n---/;function w(t,e){const i=new RegExp(`^${e}:\\s*(.+?)\\s*$`,"mi"),n=t.match(i);if(!n)return;let a=n[1].trim();return(a.startsWith('"')&&a.endsWith('"')||a.startsWith("'")&&a.endsWith("'"))&&(a=a.slice(1,-1)),a||void 0}function M(t){if(typeof t!="string"||t.length===0)return{};const e=t.match(A);if(!e)return{};const i=e[1];return{id:w(i,"id"),title:w(i,"title"),status:w(i,"status"),epic_id:w(i,"epic_id"),depends_on:Q(i),files_to_modify:R(i,"files_to_modify"),total_stories:D(w(i,"total_stories"))}}const C=32,Y=4096,G=/^\s*\*\*([^*\r\n]+?):\*\*\s*(.*?)\s*$/,B=new Set(["backlog","pending","ready","planning","in-progress","done","completed","merged","cancelled","canceled","abandoned","draft","template","archived","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"]);function W(t){let e=t.trim();return e.startsWith("`")&&e.endsWith("`")&&e.length>=2&&(e=e.slice(1,-1).trim()),(e.startsWith('"')&&e.endsWith('"')||e.startsWith("'")&&e.endsWith("'"))&&(e=e.slice(1,-1).trim()),e}function D(t){if(t===void 0||!/^\d{1,5}$/.test(t.trim()))return;const e=Number(t);return Number.isSafeInteger(e)?e:void 0}function H(t){const e=W(t).toLowerCase().replace(/[_\s]+/g,"-"),n={planned:"planning",complete:"completed",closed:"done",finished:"done"}[e]??e;return B.has(n)?n:void 0}function U(t){const e=t.trim().toLowerCase().replace(/[_-]+/g," ").replace(/\s+/g," ");if(e==="id"||e==="epic id")return"id";if(e==="title"||e==="titulo")return"title";if(e==="status")return"status";if(e==="total stories"||e==="total de stories")return"total_stories"}function Z(t){const e=t.find(a=>/^#\s+\S/.test(a));if(!e)return;const i=e.replace(/^#\s+/,"").trim();return(i.replace(/^(?:Epic|Story)\s+\S+\s*(?:(?:--?|:)|[\u2013\u2014])\s*/i,"")||i).slice(0,200)}function v(t,e,i,n){const a=[...new Set(t.map(W).filter(Boolean))];if(a.length>1){n.push(`legacy metadata ambiguous for '${e}' in '${i}': conflicting values ignored`);return}return a[0]}function X(t,e){const i=[],n=[],a=t.slice(0,Y).split(/\r?\n/,C);for(const d of a){if(n.length>0&&(/^\s*---\s*$/.test(d)||/^##\s+/.test(d)))break;n.push(d)}const o=new Map;for(const d of n){const u=d.match(G);if(!u)continue;const m=U(u[1]);if(!m)continue;const h=o.get(m)??[];h.push(u[2]),o.set(m,h)}const f=v(o.get("id")??[],"id",e,i),l=v(o.get("title")??[],"title",e,i),g=v(o.get("status")??[],"status",e,i),_=v(o.get("total_stories")??[],"total_stories",e,i),p=g===void 0?void 0:H(g);g!==void 0&&p===void 0&&i.push(`legacy metadata status unrecognized in '${e}': value ignored`);const y=D(_);_!==void 0&&y===void 0&&i.push(`legacy metadata total_stories invalid in '${e}': value ignored`);const b=f&&/^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/.test(f)?f:void 0;f!==void 0&&b===void 0&&i.push(`legacy metadata id invalid in '${e}': value ignored`);const r=Z(n),s=l??r;return{metadata:{...b?{id:b}:{},...s?{title:s.slice(0,200)}:{},...p?{status:p}:{},...y!==void 0?{total_stories:y}:{}},source:"legacy-metadata",warnings:Object.freeze(i)}}function q(t){return/^[A-Za-z0-9._-]{1,160}$/.test(t)?t:"markdown-target.md"}function K(t){return new TextEncoder().encode(t).length}function V(t){let e=!1;for(const i of t.split(/\r?\n/)){if(!i.trim()||i.trimStart().startsWith("#"))continue;const n=i.match(/^\s+-\s+(.+?)\s*$/);if(n){if(!e)return!0;const f=n[1].trim();if(f.startsWith('"')&&!f.endsWith('"')||f.startsWith("'")&&!f.endsWith("'"))return!0;continue}if(/^\s+/.test(i))return!0;const a=i.match(/^[A-Za-z0-9_-]+:\s*(.*?)\s*$/);if(!a)return!0;const o=a[1].trim();if(e=o.length===0,o.startsWith('"')&&!o.endsWith('"')||o.startsWith("'")&&!o.endsWith("'"))return!0}return!1}function J(t,e,i){const n=q(e),a=t.match(A);if(!a)return Object.freeze([`metadata-frontmatter reason=frontmatter-malformed file='${n}': repair the bounded leading YAML envelope; source content omitted`]);const o=a[1];return K(o)>8*1024||o.split(/\r?\n/).length>128?Object.freeze([`metadata-frontmatter reason=frontmatter-oversized file='${n}': reduce the leading YAML envelope; source content omitted`]):V(o)||o.trim().length>0&&Object.keys(i).length===0?Object.freeze([`metadata-frontmatter reason=frontmatter-unsupported-value file='${n}': use bounded scalar fields or string lists; source content omitted`]):Object.freeze([])}function F(t,e){if(/^---(?:\s*\r?\n|\s*$)/.test(t)){const i=M(t);return{metadata:i,source:"frontmatter",warnings:J(t,e,i)}}return typeof t!="string"||t.length===0?{metadata:{},source:"none",warnings:Object.freeze([])}:X(t,e)}function L(t){let e=t.trim();if((e.startsWith('"')&&e.endsWith('"')||e.startsWith("'")&&e.endsWith("'"))&&(e=e.slice(1,-1).trim()),!!e&&!/^(null|undefined|true|false)$/i.test(e))return e}function Q(t){return R(t,"depends_on")}function R(t,e){const i=e.replace(/[.*+?^${}()|[\]\\]/g,"\\$&"),a=t.match(new RegExp(`^${i}:[ \\t]*(.+?)[ \\t]*$`,"mi"))?.[1]?.trim();if(a!==void 0){const _=(a.startsWith("[")&&a.endsWith("]")?a.slice(1,-1).split(","):[a]).map(L).filter(p=>typeof p=="string"&&p.length>0);return _.length>0?Object.freeze(_):void 0}const o=t.split(/\r?\n/),f=[];let l=!1;for(const g of o){if(!l){new RegExp(`^${i}:\\s*$`,"i").test(g.trim())&&(l=!0);continue}if(/^[A-Za-z0-9_-]+:\s*/.test(g))break;const _=g.match(/^\s*-\s*(.+?)\s*$/);if(!_)continue;const p=L(_[1]);p&&f.push(p)}return f.length>0?Object.freeze(f):void 0}function N(t){return t.startsWith("_")||t.startsWith(".")}function ee(t){return x.includes(t)}async function ge(){const t=await import("node:fs"),e=await import("node:path");return{isDirectory(i){try{return t.statSync(i).isDirectory()}catch{return!1}},readdir(i){try{return t.readdirSync(i)}catch{return[]}},readFile(i){try{return t.readFileSync(i,"utf8")}catch{return""}},join(...i){try{return e.join(...i)}catch{return i.join("/")}}}}function te(t,e){let i=!1,n=null,a=null;for(let o=0;o<E.length;o++){const f=E[o],l=t.match(f);if(l){i=!0,n=l[1],a=o===2?"filename-slug":"filename-canonical";break}}return i?e.id&&e.id.length>0?{id:e.id,source:"frontmatter"}:{id:n,source:a}:null}function ie(t){for(const e of E){const i=t.match(e);if(i)return i[1]}return null}function O(t){const e=t.trim();return/^\d+(?:\.\d+)*$/i.test(e)?`P${e}`.toUpperCase():e.toUpperCase()}function ne(t){const e=O(t);return/^P\d+(?:\.\d+)?$/i.test(e)?`epic-${e}.md`:`epic-${t}.md`}function se(t){const e=O(t);return/^P\d+\.\d+(?:\.\d+)?$/i.test(e)?`${e}.story.md`:`${t}.story.md`}function P(t,e){return!t||!e?!1:O(t)!==O(e)}function re(t,e,i){return`frontmatter/filename mismatch: epic '${t}' has frontmatter id '${e}' but filename implies '${i}'. Repair by using generated canonical '${ne(e)}' or changing frontmatter id to '${i}'.`}function oe(t,e,i){return`frontmatter/filename mismatch: story '${t}' has frontmatter id '${e}' but filename implies '${i}'. Repair by using generated canonical '${se(e)}' or changing frontmatter id to '${i}'.`}function ae(t){let e=t.match(j[0]);if(e){const i=e[1],n=i.indexOf(".");return{id:i,epic_id_hint:n>0?i.slice(0,n):null}}if(e=t.match(j[1]),e){const i=e[1],n=i.indexOf(".");return{id:i,epic_id_hint:n>0?i.slice(0,n):null}}if(e=t.match(j[2]),e){const i=e[1],n=e[2];return{id:`${i}.${n}`,epic_id_hint:i}}return null}function ce(t,e){return e.join(t,"..","stories")}function he(t,e){const i=[],n=[],a=[],o=new Date().toISOString();if(typeof t!="string"||t.length===0)return Object.freeze({epics:Object.freeze([]),warnings:Object.freeze([]),skipped:Object.freeze([])});if(!e.isDirectory(t))return Object.freeze({epics:Object.freeze([]),warnings:Object.freeze([]),skipped:Object.freeze([])});const f=[...e.readdir(t)].sort(),l=[];for(const r of f){const s=e.join(t,r);if(N(r)){n.push(`${r}: ignored (draft or hidden prefix)`);continue}if(e.isDirectory(s)){if(ee(r)){n.push(`${r}: ignored subdirectory`);continue}n.push(`${r}: subdirectory not recursed`);continue}if(!r.endsWith(".md"))continue;if(!E.some(S=>S.test(r))){n.push(`${r}: did not match any EPIC_FILE_PATTERNS`);continue}const d=e.readFile(s),u=F(d,r);i.push(...u.warnings);const m=u.metadata,h=ie(r);m.id&&P(m.id,h)&&i.push(u.source==="frontmatter"?re(r,m.id,h):`legacy metadata/filename mismatch: epic '${r}' id does not match its filename`),l.push({filename:r,fullPath:s,metadata:m,metadataSource:u.source})}const g=new Map,_=[];for(const r of l){const s=te(r.filename,r.metadata);if(s===null){n.push(`${r.filename}: id resolution returned null`);continue}let c=s.id;const d=c,u=g.get(d)??0;u>0&&(c=`${d}-${u+1}`,i.push(`epic ID collision: '${d}' resolved to '${c}' for ${r.filename}`)),g.set(d,u+1),_.push({candidate:r,finalId:c,idSource:r.metadataSource==="legacy-metadata"&&r.metadata.id?"legacy-metadata":s.source})}const p=new Map,y=ce(t,e);if(e.isDirectory(y)){const r=[...e.readdir(y)].sort();for(const s of r){if(N(s)||!s.endsWith(".md"))continue;const c=e.join(y,s);if(e.isDirectory(c))continue;const d=ae(s);if(!d)continue;const u=e.readFile(c),m=F(u,s);i.push(...m.warnings);const h=m.metadata;h.id&&P(h.id,d.id)&&i.push(m.source==="frontmatter"?oe(s,h.id,d.id):`legacy metadata/filename mismatch: story '${s}' id does not match its filename`);const S=h.epic_id??d.epic_id_hint;if(!S){i.push(`story '${s}' has no epic_id (frontmatter or filename pattern)`);continue}const k=Object.freeze({id:d.id,epic_id:S,filename:s,path:c,...h.title?{title:h.title}:{},...h.status?{status:h.status}:{},...h.depends_on?{depends_on:h.depends_on}:{},...h.files_to_modify?{files_to_modify:h.files_to_modify}:{}});p.has(S)||p.set(S,[]),p.get(S).push(k)}}for(const r of _){const s=p.get(r.finalId)??[],c=Object.freeze({id:r.finalId,filename:r.candidate.filename,path:r.candidate.fullPath,...r.candidate.metadata.title?{title:r.candidate.metadata.title}:{},...r.candidate.metadata.status?{status:r.candidate.metadata.status}:{},...r.candidate.metadata.total_stories!==void 0?{total_stories:r.candidate.metadata.total_stories}:{},...r.candidate.metadata.depends_on?{depends_on:r.candidate.metadata.depends_on}:{},source:"discovered",discovered_at:o,stories:Object.freeze([...s]),t:r.idSource,e:r.candidate.metadataSource});a.push(c)}const b=new Set(a.map(r=>r.id));for(const[r,s]of p.entries())if(!b.has(r))for(const c of s)i.push(`orphan story '${c.filename}' references unknown epic '${r}'`);return Object.freeze({epics:Object.freeze(a),warnings:Object.freeze(i),skipped:Object.freeze(n)})}function de(t){return I(t)}function I(t){const e=ue(t);return e==="done"||e==="completed"||e==="merged"}function z(t){return I(t)}function ue(t){return typeof t=="string"?t.trim().toLowerCase().replace(/[_\s]+/g,"-"):""}function T(t){return!!t&&typeof t=="object"&&!Array.isArray(t)}function $(t){throw new Error(`epic-aggregate-writer:${t}`)}function fe(t){const e=[],i=new Set;for(const n of t)(typeof n!="string"||n.length===0)&&$("epic_aggregate_story_ref_invalid"),i.has(n)&&$("epic_aggregate_story_ref_duplicate"),i.add(n),e.push(n);return e}function le(t,e,i){const n=i[e];return n===void 0&&$("epic_aggregate_story_missing"),T(n)||$("epic_aggregate_story_not_object"),n.id!==e&&$("epic_aggregate_story_id_conflict"),n.epic_id!==t&&$("epic_aggregate_story_epic_conflict"),n}function pe(t,e,i,n,a){const o=e[t];T(o)||$("epic_aggregate_epic_not_object"),o.id!==t&&$("epic_aggregate_epic_id_conflict"),Array.isArray(o.stories)||$("epic_aggregate_story_list_not_array");const f=fe(o.stories),l=f.length,g=f.filter(s=>I(le(t,s,i).status)).length,_=a?.total_stories,p=a?.e==="legacy-metadata"&&z(o.status),y=p?_??l:l>0?l:_??0,b=p||l===0&&y>0&&z(o.status)?y:g,r=l>0&&g===l;z(o.status)&&!p&&!r&&l>0&&$("epic_aggregate_terminal_incomplete_conflict"),o.total_stories=y,o.completed_stories=b,!z(o.status)&&r&&(o.status="done",(o.completed_at===void 0||o.completed_at===null)&&(o.completed_at=n))}function _e(t,e,i){const n=t??{};(!n.epics||typeof n.epics!="object")&&(n.epics={}),(!n.stories||typeof n.stories!="object")&&(n.stories={});const a=n.epics,o=n.stories,f=[],l=[],g=new Set,_=new Map;let p=0;const y=i?.forceOverwrite===!0,b=i?.nowIso??new Date().toISOString(),r=new Set;for(const s of e.epics)r.add(s.id),_.set(s.id,s);for(const s of e.epics){const c=a[s.id];if(c&&c.source==="create-epic"&&!y){l.push({id:s.id,reason:"create-epic source preserved (defense)"});continue}if(c&&c.source==="discovered"&&!y){const u=c;u.depends_on=s.depends_on??[],u.stories=s.stories.map(m=>m.id),s.title!==void 0&&(u.title=s.title),s.status!==void 0&&!z(u.status)&&(u.status=s.status),g.add(s.id);continue}const d={id:s.id,title:s.title??"",status:s.status??"planning",source:"discovered",discovered_at:b,merged_at:b,stories:s.stories.map(u=>u.id),depends_on:s.depends_on??[]};a[s.id]=d,g.add(s.id),f.push(s.id)}for(const s of e.epics)for(const c of s.stories){const d=o[c.id];if(d&&d.source==="create-epic"&&!y){l.push({id:c.id,reason:"create-epic source preserved (defense, story)"});continue}if(d&&de(d.status)&&!y){const m=d;m.depends_on=c.depends_on??[],m.files_to_modify=c.files_to_modify??[];continue}if(d&&d.source==="discovered"&&!y){const m=d;m.depends_on=c.depends_on??[],m.files_to_modify=c.files_to_modify??[];continue}const u={id:c.id,epic_id:c.epic_id,title:c.title??"",status:c.status??"backlog",source:"discovered",discovered_at:b,depends_on:c.depends_on??[],files_to_modify:c.files_to_modify??[]};o[c.id]=u,p++}for(const s of g)pe(s,a,o,b,_.get(s));return{state:n,added:Object.freeze([...f]),skipped:Object.freeze([...l]),storiesAdded:p}}export{E as EPIC_FILE_PATTERNS,me as GENERATED_NAMING_CONTRACT,j as STORY_FILE_PATTERNS,ge as buildDefaultDiscoveryFs,he as discoverEpicsFromDir,te as getEpicIdFromDescriptor,_e as mergeDiscoveredIntoState};
+const me=Object.freeze({epicId:"P{number}",epicFilename:"docs/epics/epic-P{number}.md",storyId:"P{number}.NN",storyFilename:"docs/stories/P{number}.NN.story.md",acceptedOnly:Object.freeze({epicFilenames:Object.freeze(["docs/epics/epic-{number}.md","docs/epics/EPIC-{number}-{slug}.md","docs/epics/EPIC-{number}_{slug}.md","docs/epics/epic-{slug}.md"]),storyFilenames:Object.freeze(["docs/stories/{number}.NN.story.md","docs/stories/story-P{number}.NN.md","docs/stories/story-{number}.NN.md","docs/stories/EPIC-{number}.STORY-{number}.md"])})}),E=Object.freeze([/^epic-(P?\d+(?:\.\d+)?)\.md$/i,/^EPIC-(\d+)(?:[-_].*)?\.md$/,/^epic-([a-z0-9][a-z0-9_-]*)\.md$/i]),j=Object.freeze([/^(P?\d+\.\d+(?:\.\d+)?)\.story\.md$/i,/^story-(P?\d+\.\d+)\.md$/i,/^EPIC-(\d+)\.STORY-(\d+)\.md$/]),k=Object.freeze([".archive","_archive","_archives","_drafts","archive","archives","archived","drafts"]),A=/^---\s*\n([\s\S]*?)\n---/;function w(t,e){const i=new RegExp(`^${e}:\\s*(.+?)\\s*$`,"mi"),n=t.match(i);if(!n)return;let c=n[1].trim();return(c.startsWith('"')&&c.endsWith('"')||c.startsWith("'")&&c.endsWith("'"))&&(c=c.slice(1,-1)),c||void 0}function M(t){if(typeof t!="string"||t.length===0)return{};const e=t.match(A);if(!e)return{};const i=e[1];return{id:w(i,"id"),title:w(i,"title"),status:w(i,"status"),epic_id:w(i,"epic_id"),depends_on:Q(i),files_to_modify:R(i,"files_to_modify"),total_stories:D(w(i,"total_stories"))}}const C=32,G=4096,Y=/^\s*\*\*([^*\r\n]+?):\*\*\s*(.*?)\s*$/,B=new Set(["backlog","pending","ready","planning","in-progress","done","completed","merged","cancelled","canceled","abandoned","draft","template","archived","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"]);function W(t){let e=t.trim();return e.startsWith("`")&&e.endsWith("`")&&e.length>=2&&(e=e.slice(1,-1).trim()),(e.startsWith('"')&&e.endsWith('"')||e.startsWith("'")&&e.endsWith("'"))&&(e=e.slice(1,-1).trim()),e}function D(t){if(t===void 0||!/^\d{1,5}$/.test(t.trim()))return;const e=Number(t);return Number.isSafeInteger(e)?e:void 0}function H(t){const e=W(t).toLowerCase().replace(/[_\s]+/g,"-"),n={planned:"planning",complete:"completed",closed:"done",finished:"done"}[e]??e;return B.has(n)?n:void 0}function U(t){const e=t.trim().toLowerCase().replace(/[_-]+/g," ").replace(/\s+/g," ");if(e==="id"||e==="epic id")return"id";if(e==="title"||e==="titulo")return"title";if(e==="status")return"status";if(e==="total stories"||e==="total de stories")return"total_stories"}function Z(t){const e=t.find(c=>/^#\s+\S/.test(c));if(!e)return;const i=e.replace(/^#\s+/,"").trim();return(i.replace(/^(?:Epic|Story)\s+\S+\s*(?:(?:--?|:)|[\u2013\u2014])\s*/i,"")||i).slice(0,200)}function v(t,e,i,n){const c=[...new Set(t.map(W).filter(Boolean))];if(c.length>1){n.push(`legacy metadata ambiguous for '${e}' in '${i}': conflicting values ignored`);return}return c[0]}function X(t,e){const i=[],n=[],c=t.slice(0,G).split(/\r?\n/,C);for(const d of c){if(n.length>0&&(/^\s*---\s*$/.test(d)||/^##\s+/.test(d)))break;n.push(d)}const o=new Map;for(const d of n){const g=d.match(Y);if(!g)continue;const m=U(g[1]);if(!m)continue;const u=o.get(m)??[];u.push(g[2]),o.set(m,u)}const l=v(o.get("id")??[],"id",e,i),f=v(o.get("title")??[],"title",e,i),h=v(o.get("status")??[],"status",e,i),_=v(o.get("total_stories")??[],"total_stories",e,i),p=h===void 0?void 0:H(h);h!==void 0&&p===void 0&&i.push(`legacy metadata status unrecognized in '${e}': value ignored`);const y=D(_);_!==void 0&&y===void 0&&i.push(`legacy metadata total_stories invalid in '${e}': value ignored`);const b=l&&/^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/.test(l)?l:void 0;l!==void 0&&b===void 0&&i.push(`legacy metadata id invalid in '${e}': value ignored`);const r=Z(n),s=f??r;return{metadata:{...b?{id:b}:{},...s?{title:s.slice(0,200)}:{},...p?{status:p}:{},...y!==void 0?{total_stories:y}:{}},source:"legacy-metadata",warnings:Object.freeze(i)}}function q(t){return/^[A-Za-z0-9._-]{1,160}$/.test(t)?t:"markdown-target.md"}function K(t){return new TextEncoder().encode(t).length}function V(t){let e=!1;for(const i of t.split(/\r?\n/)){if(!i.trim()||i.trimStart().startsWith("#"))continue;const n=i.match(/^\s+-\s+(.+?)\s*$/);if(n){if(!e)return!0;const l=n[1].trim();if(l.startsWith('"')&&!l.endsWith('"')||l.startsWith("'")&&!l.endsWith("'"))return!0;continue}if(/^\s+/.test(i))return!0;const c=i.match(/^[A-Za-z0-9_-]+:\s*(.*?)\s*$/);if(!c)return!0;const o=c[1].trim();if(e=o.length===0,o.startsWith('"')&&!o.endsWith('"')||o.startsWith("'")&&!o.endsWith("'"))return!0}return!1}function J(t,e,i){const n=q(e),c=t.match(A);if(!c)return Object.freeze([`metadata-frontmatter reason=frontmatter-malformed file='${n}': repair the bounded leading YAML envelope; source content omitted`]);const o=c[1];return K(o)>8*1024||o.split(/\r?\n/).length>128?Object.freeze([`metadata-frontmatter reason=frontmatter-oversized file='${n}': reduce the leading YAML envelope; source content omitted`]):V(o)||o.trim().length>0&&Object.keys(i).length===0?Object.freeze([`metadata-frontmatter reason=frontmatter-unsupported-value file='${n}': use bounded scalar fields or string lists; source content omitted`]):Object.freeze([])}function F(t,e){if(/^---(?:\s*\r?\n|\s*$)/.test(t)){const i=M(t);return{metadata:i,source:"frontmatter",warnings:J(t,e,i)}}return typeof t!="string"||t.length===0?{metadata:{},source:"none",warnings:Object.freeze([])}:X(t,e)}function L(t){let e=t.trim();if((e.startsWith('"')&&e.endsWith('"')||e.startsWith("'")&&e.endsWith("'"))&&(e=e.slice(1,-1).trim()),!!e&&!/^(null|undefined|true|false)$/i.test(e))return e}function Q(t){return R(t,"depends_on")}function R(t,e){const i=e.replace(/[.*+?^${}()|[\]\\]/g,"\\$&"),c=t.match(new RegExp(`^${i}:[ \\t]*(.+?)[ \\t]*$`,"mi"))?.[1]?.trim();if(c!==void 0){const _=(c.startsWith("[")&&c.endsWith("]")?c.slice(1,-1).split(","):[c]).map(L).filter(p=>typeof p=="string"&&p.length>0);return _.length>0?Object.freeze(_):void 0}const o=t.split(/\r?\n/),l=[];let f=!1;for(const h of o){if(!f){new RegExp(`^${i}:\\s*$`,"i").test(h.trim())&&(f=!0);continue}if(/^[A-Za-z0-9_-]+:\s*/.test(h))break;const _=h.match(/^\s*-\s*(.+?)\s*$/);if(!_)continue;const p=L(_[1]);p&&l.push(p)}return l.length>0?Object.freeze(l):void 0}function N(t){return t.startsWith("_")||t.startsWith(".")}function ee(t){return k.includes(t)}async function ge(){const t=await import("node:fs"),e=await import("node:path");return{isDirectory(i){try{return t.statSync(i).isDirectory()}catch{return!1}},readdir(i){try{return t.readdirSync(i)}catch{return[]}},readFile(i){try{return t.readFileSync(i,"utf8")}catch{return""}},join(...i){try{return e.join(...i)}catch{return i.join("/")}}}}function te(t,e){let i=!1,n=null,c=null;for(let o=0;o<E.length;o++){const l=E[o],f=t.match(l);if(f){i=!0,n=f[1],c=o===2?"filename-slug":"filename-canonical";break}}return i?e.id&&e.id.length>0?{id:e.id,source:"frontmatter"}:{id:n,source:c}:null}function ie(t){for(const e of E){const i=t.match(e);if(i)return i[1]}return null}function O(t){const e=t.trim();return/^\d+(?:\.\d+)*$/i.test(e)?`P${e}`.toUpperCase():e.toUpperCase()}function ne(t){const e=O(t);return/^P\d+(?:\.\d+)?$/i.test(e)?`epic-${e}.md`:`epic-${t}.md`}function se(t){const e=O(t);return/^P\d+\.\d+(?:\.\d+)?$/i.test(e)?`${e}.story.md`:`${t}.story.md`}function P(t,e){return!t||!e?!1:O(t)!==O(e)}function re(t,e,i){return`frontmatter/filename mismatch: epic '${t}' has frontmatter id '${e}' but filename implies '${i}'. Repair by using generated canonical '${ne(e)}' or changing frontmatter id to '${i}'.`}function oe(t,e,i){return`frontmatter/filename mismatch: story '${t}' has frontmatter id '${e}' but filename implies '${i}'. Repair by using generated canonical '${se(e)}' or changing frontmatter id to '${i}'.`}function ce(t){let e=t.match(j[0]);if(e){const i=e[1],n=i.indexOf(".");return{id:i,epic_id_hint:n>0?i.slice(0,n):null}}if(e=t.match(j[1]),e){const i=e[1],n=i.indexOf(".");return{id:i,epic_id_hint:n>0?i.slice(0,n):null}}if(e=t.match(j[2]),e){const i=e[1],n=e[2];return{id:`${i}.${n}`,epic_id_hint:i}}return null}function ae(t,e){return e.join(t,"..","stories")}function he(t,e){const i=[],n=[],c=[],o=new Date().toISOString();if(typeof t!="string"||t.length===0)return Object.freeze({epics:Object.freeze([]),warnings:Object.freeze([]),skipped:Object.freeze([])});if(!e.isDirectory(t))return Object.freeze({epics:Object.freeze([]),warnings:Object.freeze([]),skipped:Object.freeze([])});const l=[...e.readdir(t)].sort(),f=[];for(const r of l){const s=e.join(t,r);if(N(r)){n.push(`${r}: ignored (draft or hidden prefix)`);continue}if(e.isDirectory(s)){if(ee(r)){n.push(`${r}: ignored subdirectory`);continue}n.push(`${r}: subdirectory not recursed`);continue}if(!r.endsWith(".md"))continue;if(!E.some(S=>S.test(r))){n.push(`${r}: did not match any EPIC_FILE_PATTERNS`);continue}const d=e.readFile(s),g=F(d,r);i.push(...g.warnings);const m=g.metadata,u=ie(r);m.id&&P(m.id,u)&&i.push(g.source==="frontmatter"?re(r,m.id,u):`legacy metadata/filename mismatch: epic '${r}' id does not match its filename`),f.push({filename:r,fullPath:s,metadata:m,metadataSource:g.source})}const h=new Map,_=[];for(const r of f){const s=te(r.filename,r.metadata);if(s===null){n.push(`${r.filename}: id resolution returned null`);continue}let a=s.id;const d=a,g=h.get(d)??0;g>0&&(a=`${d}-${g+1}`,i.push(`epic ID collision: '${d}' resolved to '${a}' for ${r.filename}`)),h.set(d,g+1),_.push({candidate:r,finalId:a,idSource:r.metadataSource==="legacy-metadata"&&r.metadata.id?"legacy-metadata":s.source})}const p=new Map,y=ae(t,e);if(e.isDirectory(y)){const r=[...e.readdir(y)].sort();for(const s of r){if(N(s)||!s.endsWith(".md"))continue;const a=e.join(y,s);if(e.isDirectory(a))continue;const d=ce(s);if(!d)continue;const g=e.readFile(a),m=F(g,s);i.push(...m.warnings);const u=m.metadata;u.id&&P(u.id,d.id)&&i.push(m.source==="frontmatter"?oe(s,u.id,d.id):`legacy metadata/filename mismatch: story '${s}' id does not match its filename`);const S=u.epic_id??d.epic_id_hint;if(!S){i.push(`story '${s}' has no epic_id (frontmatter or filename pattern)`);continue}const x=Object.freeze({id:d.id,epic_id:S,filename:s,path:a,...u.title?{title:u.title}:{},...u.status?{status:u.status}:{},...u.depends_on?{depends_on:u.depends_on}:{},...u.files_to_modify?{files_to_modify:u.files_to_modify}:{}});p.has(S)||p.set(S,[]),p.get(S).push(x)}}for(const r of _){const s=p.get(r.finalId)??[],a=Object.freeze({id:r.finalId,filename:r.candidate.filename,path:r.candidate.fullPath,...r.candidate.metadata.title?{title:r.candidate.metadata.title}:{},...r.candidate.metadata.status?{status:r.candidate.metadata.status}:{},...r.candidate.metadata.total_stories!==void 0?{total_stories:r.candidate.metadata.total_stories}:{},...r.candidate.metadata.depends_on?{depends_on:r.candidate.metadata.depends_on}:{},source:"discovered",discovered_at:o,stories:Object.freeze([...s]),t:r.idSource,e:r.candidate.metadataSource});c.push(a)}const b=new Set(c.map(r=>r.id));for(const[r,s]of p.entries())if(!b.has(r))for(const a of s)i.push(`orphan story '${a.filename}' references unknown epic '${r}'`);return Object.freeze({epics:Object.freeze(c),warnings:Object.freeze(i),skipped:Object.freeze(n)})}function de(t){return I(t)}function I(t){const e=ue(t);return e==="done"||e==="completed"||e==="merged"}function z(t){return I(t)}function ue(t){return typeof t=="string"?t.trim().toLowerCase().replace(/[_\s]+/g,"-"):""}function T(t){return!!t&&typeof t=="object"&&!Array.isArray(t)}function $(t){throw new Error(`epic-aggregate-writer:${t}`)}function fe(t){const e=[],i=new Set;for(const n of t)(typeof n!="string"||n.length===0)&&$("epic_aggregate_story_ref_invalid"),i.has(n)&&$("epic_aggregate_story_ref_duplicate"),i.add(n),e.push(n);return e}function le(t,e,i){const n=i[e];return n===void 0&&$("epic_aggregate_story_missing"),T(n)||$("epic_aggregate_story_not_object"),n.id!==e&&$("epic_aggregate_story_id_conflict"),n.epic_id!==t&&$("epic_aggregate_story_epic_conflict"),n}function pe(t,e,i,n,c){const o=e[t];T(o)||$("epic_aggregate_epic_not_object"),o.id!==t&&$("epic_aggregate_epic_id_conflict"),Array.isArray(o.stories)||$("epic_aggregate_story_list_not_array");const l=fe(o.stories),f=l.length,h=l.filter(s=>I(le(t,s,i).status)).length,_=c?.total_stories,p=c?.e==="legacy-metadata"&&z(o.status),y=p?_??f:f>0?f:_??0,b=p||f===0&&y>0&&z(o.status)?y:h,r=f>0&&h===f;z(o.status)&&!p&&!r&&f>0&&$("epic_aggregate_terminal_incomplete_conflict"),o.total_stories=y,o.completed_stories=b,!z(o.status)&&r&&(o.status="done",(o.completed_at===void 0||o.completed_at===null)&&(o.completed_at=n))}function _e(t,e,i){const n=t??{};(!n.epics||typeof n.epics!="object")&&(n.epics={}),(!n.stories||typeof n.stories!="object")&&(n.stories={});const c=n.epics,o=n.stories,l=[],f=[],h=new Set,_=new Map;let p=0;const y=i?.forceOverwrite===!0,b=i?.nowIso??new Date().toISOString(),r=new Set;for(const s of e.epics)r.add(s.id),_.set(s.id,s);for(const s of e.epics){const a=c[s.id],d=a;if(d&&(d.branch_mode==="epic"||typeof d.execution_branch=="string")){f.push({id:s.id,reason:"epic Git lifecycle preserved"});continue}if(a&&a.source==="create-epic"&&!y){f.push({id:s.id,reason:"create-epic source preserved (defense)"});continue}if(a&&a.source==="discovered"&&!y){const m=a;m.depends_on=s.depends_on??[],m.stories=s.stories.map(u=>u.id),s.title!==void 0&&(m.title=s.title),s.status!==void 0&&!z(m.status)&&(m.status=s.status),h.add(s.id);continue}const g={id:s.id,title:s.title??"",status:s.status??"planning",source:"discovered",discovered_at:b,merged_at:b,stories:s.stories.map(m=>m.id),depends_on:s.depends_on??[]};c[s.id]=g,h.add(s.id),l.push(s.id)}for(const s of e.epics)for(const a of s.stories){const d=o[a.id],g=c[s.id];if(d&&g&&(g.branch_mode==="epic"||typeof g.execution_branch=="string")){f.push({id:a.id,reason:"story Git lifecycle preserved"});continue}if(d&&d.source==="create-epic"&&!y){f.push({id:a.id,reason:"create-epic source preserved (defense, story)"});continue}if(d&&de(d.status)&&!y){const u=d;u.depends_on=a.depends_on??[],u.files_to_modify=a.files_to_modify??[];continue}if(d&&d.source==="discovered"&&!y){const u=d;u.depends_on=a.depends_on??[],u.files_to_modify=a.files_to_modify??[];continue}const m={id:a.id,epic_id:a.epic_id,title:a.title??"",status:a.status??"backlog",source:"discovered",discovered_at:b,depends_on:a.depends_on??[],files_to_modify:a.files_to_modify??[]};o[a.id]=m,p++}for(const s of h)pe(s,c,o,b,_.get(s));return{state:n,added:Object.freeze([...l]),skipped:Object.freeze([...f]),storiesAdded:p}}export{E as EPIC_FILE_PATTERNS,me as GENERATED_NAMING_CONTRACT,j as STORY_FILE_PATTERNS,ge as buildDefaultDiscoveryFs,he as discoverEpicsFromDir,te as getEpicIdFromDescriptor,_e as mergeDiscoveredIntoState};

package/packages/shared/dist/generated/command-registry.generated.js

@@ -1,41 +1,41 @@
 /** Generated by scripts/generate-command-registry.mjs. Do not edit. */
 export const COMMAND_REGISTRY_SCHEMA_VERSION = 1;
 export const COMMAND_REGISTRY_VERSION = "1.0.0";
-export const COMMAND_REGISTRY_CHECKSUM = "b8fcdb246f7e22f820f667442f7a489bf3f53376b6540280d59fb89495ff4520";
+export const COMMAND_REGISTRY_CHECKSUM = "5ed842e2bf9a9e959f23096cec199be4200bb4056b99479b5dc47b2dbe1293e6";
 export const COMMAND_REGISTRY_PROJECTION_MANIFEST = {
     "schemaVersion": 1,
     "registryVersion": "1.0.0",
-    "registryChecksum": "b8fcdb246f7e22f820f667442f7a489bf3f53376b6540280d59fb89495ff4520",
+    "registryChecksum": "5ed842e2bf9a9e959f23096cec199be4200bb4056b99479b5dc47b2dbe1293e6",
     "projections": [
         {
             "kind": "admin",
             "entryCount": 62,
-            "sha256": "4ca10e54b2028a01dad3b492dacead708d858842ba5ba23bcca70faa8c5b9689"
+            "sha256": "d752e65aa65ee7864416b4c68af6d516233e180cd5b0408dcb244751ede7a21a"
         },
         {
             "kind": "client",
             "entryCount": 62,
-            "sha256": "4ca10e54b2028a01dad3b492dacead708d858842ba5ba23bcca70faa8c5b9689"
+            "sha256": "d752e65aa65ee7864416b4c68af6d516233e180cd5b0408dcb244751ede7a21a"
         },
         {
             "kind": "docs",
             "entryCount": 62,
-            "sha256": "4ca10e54b2028a01dad3b492dacead708d858842ba5ba23bcca70faa8c5b9689"
+            "sha256": "d752e65aa65ee7864416b4c68af6d516233e180cd5b0408dcb244751ede7a21a"
         },
         {
             "kind": "metrics",
             "entryCount": 62,
-            "sha256": "4ca10e54b2028a01dad3b492dacead708d858842ba5ba23bcca70faa8c5b9689"
+            "sha256": "d752e65aa65ee7864416b4c68af6d516233e180cd5b0408dcb244751ede7a21a"
         },
         {
             "kind": "server",
             "entryCount": 67,
-            "sha256": "682d4238281ea4e00d110fdf7d67257cc9ee8c029a87232b26c8fc3f00604884"
+            "sha256": "1b3e29b3b462a8fb283a308e311ca681d7b106f986723d4c08b84805c878a00a"
         },
         {
             "kind": "shared",
             "entryCount": 67,
-            "sha256": "f82436b633efc99f247aa0f0e755d66fe538ba3afd205dcec49e4a5fdb7d9928"
+            "sha256": "0d181e8f869891e7c3e09b76ad00b122ca7c5a4ca530e86391d64517d14b7bc8"
         }
     ]
 };
@@ -1130,14 +1130,14 @@ export const GENERATED_SHARED_COMMANDS = [
         "name": "Diagnosticar Story ou Contexto",
         "number": 25,
         "policy": {
-            "billingClass": "billable",
-            "idempotencyClass": "logical-supported",
+            "billingClass": "non-billable",
+            "idempotencyClass": "none",
             "minimumTier": "free",
-            "mutationClass": "stateful",
+            "mutationClass": "read-only",
             "privilege": "authenticated",
-            "quotaClass": "workflow",
+            "quotaClass": "none",
             "replayClass": "signed-request",
-            "strictReadOnly": "deny"
+            "strictReadOnly": "allow"
         },
         "projections": [
             "admin",
@@ -2022,54 +2022,6 @@ export const GENERATED_SHARED_COMMANDS = [
         "visibility": "public",
         "subcommands": []
     },
-    {
-        "aliases": [
-            "inicializar"
-        ],
-        "category": "quick-start",
-        "compatibility": {
-            "deprecatedIn": null,
-            "introducedIn": "1.0.0",
-            "removedIn": null,
-            "replacement": null
-        },
-        "description": {
-            "en": "Initialize project",
-            "es": "Inicializar proyecto",
-            "pt-BR": "Inicializar projeto"
-        },
-        "examples": [
-            "@neocortex *init",
-            "@neocortex init",
-            "@neocortex 2"
-        ],
-        "id": "init",
-        "inputShape": "epics",
-        "mode": "utility",
-        "name": "Inicializar + Enrichment",
-        "number": 2,
-        "policy": {
-            "billingClass": "billable",
-            "idempotencyClass": "logical-supported",
-            "minimumTier": "free",
-            "mutationClass": "stateful",
-            "privilege": "authenticated",
-            "quotaClass": "workflow",
-            "replayClass": "signed-request",
-            "strictReadOnly": "deny"
-        },
-        "projections": [
-            "admin",
-            "client",
-            "docs",
-            "metrics",
-            "server",
-            "shared"
-        ],
-        "stepId": "step-u-init",
-        "visibility": "public",
-        "subcommands": []
-    },
     {
         "aliases": [
             "continuity-jobs",
@@ -2746,6 +2698,53 @@ export const GENERATED_SHARED_COMMANDS = [
         "visibility": "public",
         "subcommands": []
     },
+    {
+        "aliases": [
+            "migrate-project",
+            "project-id-migrate"
+        ],
+        "category": "recovery",
+        "compatibility": {
+            "deprecatedIn": null,
+            "introducedIn": "1.0.0",
+            "removedIn": null,
+            "replacement": null
+        },
+        "description": {
+            "en": "Migrate stable project identity with backup and remote seed.",
+            "es": "Migra la identidad estable del proyecto con respaldo y seed remoto.",
+            "pt-BR": "Migra a identidade estavel do projeto com backup e seed remoto."
+        },
+        "examples": [
+            "@neocortex *migrate-project-id"
+        ],
+        "id": "migrate-project-id",
+        "inputShape": "standalone",
+        "mode": "utility",
+        "name": "Migrate Project Identity",
+        "number": 63,
+        "policy": {
+            "billingClass": "non-billable",
+            "idempotencyClass": "logical-required",
+            "minimumTier": "free",
+            "mutationClass": "stateful",
+            "privilege": "authenticated",
+            "quotaClass": "none",
+            "replayClass": "signed-request",
+            "strictReadOnly": "deny"
+        },
+        "projections": [
+            "admin",
+            "client",
+            "docs",
+            "metrics",
+            "server",
+            "shared"
+        ],
+        "stepId": "step-u-migrate-project-id",
+        "visibility": "public",
+        "subcommands": []
+    },
     {
         "aliases": [
             "migrate",
@@ -3528,9 +3527,9 @@ export const GENERATED_SHARED_COMMANDS = [
             "replacement": null
         },
         "description": {
-            "en": "Setup branch",
-            "es": "Configurar branch",
-            "pt-BR": "Configurar branch"
+            "en": "Set up branch in the current checkout",
+            "es": "Configurar branch en el checkout actual",
+            "pt-BR": "Configurar branch no checkout atual"
         },
         "examples": [
             "@neocortex *setup-branch @docs/stories/P126.01.story.md"
@@ -3538,7 +3537,7 @@ export const GENERATED_SHARED_COMMANDS = [
         "id": "setup-branch",
         "inputShape": "story",
         "mode": "step",
-        "name": "Configurar Branch & Worktree",
+        "name": "Configurar Branch",
         "number": 24,
         "policy": {
             "billingClass": "billable",

package/packages/shared/dist/generated/invocation-schema.generated.js

@@ -2,13 +2,13 @@
 export const GENERATED_INVOCATION_SCHEMA_MANIFEST = {
     "schemaVersion": "p205-invocation-schema-v1",
     "registryVersion": "1.0.0",
-    "registryChecksum": "b8fcdb246f7e22f820f667442f7a489bf3f53376b6540280d59fb89495ff4520",
-    "schemaChecksum": "667c67ed7a55553d74eab12ec46c2e0f12b0529ad01303d4ca9cae14d49270bd",
+    "registryChecksum": "5ed842e2bf9a9e959f23096cec199be4200bb4056b99479b5dc47b2dbe1293e6",
+    "schemaChecksum": "c3252fa75c16cc81bd0ea0e8b33868d121c2e45258f9b425c310af9337cfbd6f",
     "commandCount": 62,
     "optionCount": 47,
-    "positionalCount": 44,
+    "positionalCount": 43,
     "operationCount": 33,
-    "projectionSha256": "84ffc9791306d642d0603ce81e0b0a12ee48a2ebbc6bf4ad3bb45b9eb940abff",
+    "projectionSha256": "9843f3f7155ed3a6244c020a324c2d2818c5d4fd2d7590eeb78b9e055bc18e75",
     "commands": [
         {
             "commandId": "arch-api-contracts",
@@ -830,26 +830,6 @@ export const GENERATED_INVOCATION_SCHEMA_MANIFEST = {
             ],
             "terminator": true
         },
-        {
-            "commandId": "init",
-            "inputShape": "epics",
-            "operation": {
-                "required": false,
-                "unknownAsPositional": false,
-                "operations": []
-            },
-            "options": [],
-            "positionals": [
-                {
-                    "cardinality": "one",
-                    "id": "epics",
-                    "kind": "target-ref",
-                    "order": 0,
-                    "required": false
-                }
-            ],
-            "terminator": true
-        },
         {
             "commandId": "jobs",
             "inputShape": "continuity-jobs",
@@ -1128,6 +1108,18 @@ export const GENERATED_INVOCATION_SCHEMA_MANIFEST = {
             ],
             "terminator": true
         },
+        {
+            "commandId": "migrate-project-id",
+            "inputShape": "standalone",
+            "operation": {
+                "required": false,
+                "unknownAsPositional": false,
+                "operations": []
+            },
+            "options": [],
+            "positionals": [],
+            "terminator": true
+        },
         {
             "commandId": "migrate-state",
             "inputShape": "standalone",

package/packages/shared/dist/invocation/index.d.ts

@@ -1,3 +1,8 @@
+export * from './input-envelope.js';
+export * from './project-identity-migration.js';
+export * from './state-projection.js';
+export * from './strict-effect-receipt.js';
+export * from './public-diagnostics.js';
 export declare const EXACT_INVOCATION_POLICY: "p205-exact-invocation-v1";
 export declare const INVOCATION_SCHEMA_VERSION: "p205-invocation-schema-v1";
 export declare const INVOCATION_LIMITS: Readonly<{
@@ -115,7 +120,7 @@ export interface InvocationCommandSchemaV1 {
     readonly positionals: readonly InvocationPositionalSchemaV1[];
     readonly terminator: true;
 }
-export declare const INVOCATION_SCHEMA_CHECKSUM: "667c67ed7a55553d74eab12ec46c2e0f12b0529ad01303d4ca9cae14d49270bd";
+export declare const INVOCATION_SCHEMA_CHECKSUM: "c3252fa75c16cc81bd0ea0e8b33868d121c2e45258f9b425c310af9337cfbd6f";
 export interface InvocationSchemaManifestV1 {
     readonly schemaVersion: typeof INVOCATION_SCHEMA_VERSION;
     readonly registryVersion: string;
@@ -172,4 +177,3 @@ export interface InvocationDeprecationCountV1 {
 }
 /** Count-only migration telemetry; raw input is intentionally not accepted. */
 export declare function createInvocationDeprecationCount(result: RejectedInvocationAdmissionV1): InvocationDeprecationCountV1;
-export {};

package/packages/shared/dist/invocation/index.js

@@ -9,6 +9,11 @@ import { createHash } from 'node:crypto';
 import { COMMAND_REGISTRY_CHECKSUM, COMMAND_REGISTRY_VERSION, GENERATED_SHARED_COMMANDS, } from '../generated/command-registry.generated.js';
 import { GENERATED_INVOCATION_SCHEMA_MANIFEST, GENERATED_INVOCATION_SCHEMAS, } from '../generated/invocation-schema.generated.js';
 import { canonicalizeCommandRegistryJcs } from '../command-registry-contract.js';
+export * from './input-envelope.js';
+export * from './project-identity-migration.js';
+export * from './state-projection.js';
+export * from './strict-effect-receipt.js';
+export * from './public-diagnostics.js';
 export const EXACT_INVOCATION_POLICY = 'p205-exact-invocation-v1';
 export const INVOCATION_SCHEMA_VERSION = 'p205-invocation-schema-v1';
 export const INVOCATION_LIMITS = Object.freeze({

package/packages/shared/dist/invocation/input-envelope.d.ts

@@ -0,0 +1,37 @@
+export declare const INVOKE_INPUT_ENVELOPE_VERSION: 2;
+export declare const INVOKE_HTTP_BODY_LIMIT_BYTES: number;
+export type InvokeInputSourceV2 = 'args' | 'stdin' | 'args-file';
+export type InvokeNewlineStyleV2 = 'none' | 'lf' | 'crlf' | 'mixed';
+export interface InvokeInputEnvelopeV2 {
+    readonly version: typeof INVOKE_INPUT_ENVELOPE_VERSION;
+    readonly source: InvokeInputSourceV2;
+    readonly rawArgs: string;
+    readonly byteLength: number;
+    readonly sha256: string;
+    readonly newlineStyle: InvokeNewlineStyleV2;
+    readonly admissionView: string;
+}
+export declare const INVOKE_INPUT_EVIDENCE_VERSION: 1;
+/** Public-safe transport projection; rawArgs remains the single args field. */
+export interface InvokeInputEvidenceV1 {
+    readonly version: typeof INVOKE_INPUT_EVIDENCE_VERSION;
+    readonly source: InvokeInputSourceV2;
+    readonly byteLength: number;
+    readonly sha256: string;
+    readonly newlineStyle: InvokeNewlineStyleV2;
+}
+export type InvocationMalformedInputReasonV1 = 'multiple-input-sources' | 'missing-input-value' | 'unexpected-cli-token' | 'invalid-utf8' | 'invalid-control-character' | 'unterminated-quote' | 'input-limit-exceeded';
+export interface InvocationInputDiagnosticV1 {
+    readonly code: 'INVOCATION_MALFORMED_INPUT';
+    readonly reason: InvocationMalformedInputReasonV1;
+    readonly source?: InvokeInputSourceV2;
+    readonly byteLength?: number;
+    readonly remediation: string;
+}
+export declare function classifyNewlineStyle(value: string): InvokeNewlineStyleV2;
+export declare function isInvokeHttpBodyBelowLimit(byteLength: number): boolean;
+export declare function invokeInputSha256(rawArgs: string): string;
+export declare function createInvokeInputEnvelopeV2(source: InvokeInputSourceV2, rawArgs: string): InvokeInputEnvelopeV2;
+export declare function projectInvokeInputEvidenceV1(envelope: InvokeInputEnvelopeV2): InvokeInputEvidenceV1;
+export declare function assertInvokeInputEvidenceV1(value: unknown, rawArgs?: string): asserts value is InvokeInputEvidenceV1;
+export declare function assertInvokeInputEnvelopeV2(value: unknown): asserts value is InvokeInputEnvelopeV2;

package/packages/shared/dist/invocation/input-envelope.js

@@ -0,0 +1,98 @@
+import { createHash } from 'node:crypto';
+import { SHA256_HEX_PATTERN } from './project-identity-migration.js';
+export const INVOKE_INPUT_ENVELOPE_VERSION = 2;
+export const INVOKE_HTTP_BODY_LIMIT_BYTES = 256 * 1024;
+export const INVOKE_INPUT_EVIDENCE_VERSION = 1;
+export function classifyNewlineStyle(value) {
+    const withoutCrlf = value.replaceAll('\r\n', '');
+    const hasCrlf = withoutCrlf.length !== value.length;
+    const hasLf = withoutCrlf.includes('\n');
+    const hasBareCr = withoutCrlf.includes('\r');
+    if (!hasCrlf && !hasLf && !hasBareCr)
+        return 'none';
+    if (hasCrlf && !hasLf && !hasBareCr)
+        return 'crlf';
+    if (!hasCrlf && hasLf && !hasBareCr)
+        return 'lf';
+    return 'mixed';
+}
+export function isInvokeHttpBodyBelowLimit(byteLength) {
+    return Number.isSafeInteger(byteLength) && byteLength >= 0 && byteLength < INVOKE_HTTP_BODY_LIMIT_BYTES;
+}
+export function invokeInputSha256(rawArgs) {
+    return createHash('sha256').update(rawArgs, 'utf8').digest('hex');
+}
+export function createInvokeInputEnvelopeV2(source, rawArgs) {
+    return Object.freeze({
+        version: INVOKE_INPUT_ENVELOPE_VERSION,
+        source,
+        rawArgs,
+        byteLength: Buffer.byteLength(rawArgs, 'utf8'),
+        sha256: invokeInputSha256(rawArgs),
+        newlineStyle: classifyNewlineStyle(rawArgs),
+        admissionView: rawArgs.trim(),
+    });
+}
+export function projectInvokeInputEvidenceV1(envelope) {
+    assertInvokeInputEnvelopeV2(envelope);
+    return Object.freeze({
+        version: INVOKE_INPUT_EVIDENCE_VERSION,
+        source: envelope.source,
+        byteLength: envelope.byteLength,
+        sha256: envelope.sha256,
+        newlineStyle: envelope.newlineStyle,
+    });
+}
+export function assertInvokeInputEvidenceV1(value, rawArgs) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error('INVOKE_INPUT_EVIDENCE_INVALID');
+    }
+    const candidate = value;
+    const expectedKeys = ['byteLength', 'newlineStyle', 'sha256', 'source', 'version'];
+    const actualKeys = Object.keys(candidate).sort();
+    if (actualKeys.length !== expectedKeys.length
+        || actualKeys.some((key, index) => key !== expectedKeys[index])
+        || candidate.version !== INVOKE_INPUT_EVIDENCE_VERSION
+        || !['args', 'stdin', 'args-file'].includes(String(candidate.source))
+        || !Number.isSafeInteger(candidate.byteLength)
+        || candidate.byteLength < 0
+        || typeof candidate.sha256 !== 'string'
+        || !SHA256_HEX_PATTERN.test(candidate.sha256)
+        || !['none', 'lf', 'crlf', 'mixed'].includes(String(candidate.newlineStyle))) {
+        throw new Error('INVOKE_INPUT_EVIDENCE_INVALID');
+    }
+    if (rawArgs !== undefined
+        && (candidate.byteLength !== Buffer.byteLength(rawArgs, 'utf8')
+            || candidate.sha256 !== invokeInputSha256(rawArgs)
+            || candidate.newlineStyle !== classifyNewlineStyle(rawArgs))) {
+        throw new Error('INVOKE_INPUT_EVIDENCE_CONFLICT');
+    }
+}
+export function assertInvokeInputEnvelopeV2(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error('INVOKE_INPUT_ENVELOPE_INVALID');
+    }
+    const candidate = value;
+    if (candidate.version !== INVOKE_INPUT_ENVELOPE_VERSION) {
+        throw new Error('INVOKE_INPUT_ENVELOPE_VERSION_UNSUPPORTED');
+    }
+    const expectedKeys = ['admissionView', 'byteLength', 'newlineStyle', 'rawArgs', 'sha256', 'source', 'version'];
+    const actualKeys = Object.keys(candidate).sort();
+    if (actualKeys.length !== expectedKeys.length
+        || actualKeys.some((key, index) => key !== expectedKeys[index])
+        || !['args', 'stdin', 'args-file'].includes(String(candidate.source))
+        || typeof candidate.rawArgs !== 'string'
+        || !Number.isSafeInteger(candidate.byteLength)
+        || typeof candidate.sha256 !== 'string'
+        || !SHA256_HEX_PATTERN.test(candidate.sha256)
+        || !['none', 'lf', 'crlf', 'mixed'].includes(String(candidate.newlineStyle))
+        || typeof candidate.admissionView !== 'string') {
+        throw new Error('INVOKE_INPUT_ENVELOPE_INVALID');
+    }
+    if (candidate.byteLength !== Buffer.byteLength(candidate.rawArgs, 'utf8')
+        || candidate.sha256 !== invokeInputSha256(candidate.rawArgs)
+        || candidate.newlineStyle !== classifyNewlineStyle(candidate.rawArgs)
+        || candidate.admissionView !== candidate.rawArgs.trim()) {
+        throw new Error('INVOKE_INPUT_ENVELOPE_INTEGRITY');
+    }
+}

package/packages/shared/dist/invocation/project-identity-migration.d.ts

@@ -0,0 +1,28 @@
+export declare const PROJECT_IDENTITY_MIGRATION_VERSION: 1;
+export declare const PROJECT_IDENTITY_MIGRATION_CAPABILITY: "project-identity-migration-v1";
+export declare const PROJECT_ID_PATTERN: RegExp;
+export declare const PROJECT_IDENTITY_OPERATION_PATTERN: RegExp;
+export declare const SHA256_HEX_PATTERN: RegExp;
+export declare const MAX_LEGACY_EPIC_FLOOR: number;
+export interface ProjectIdentityMigrationRequestV1 {
+    readonly version: typeof PROJECT_IDENTITY_MIGRATION_VERSION;
+    readonly operationId: string;
+    readonly projectId: string;
+    readonly localStateDigest: string;
+    readonly legacyEpicFloor: number;
+    readonly phase: 'prepare' | 'seed';
+}
+export interface ProjectIdentityMigrationReceiptV1 {
+    readonly version: typeof PROJECT_IDENTITY_MIGRATION_VERSION;
+    readonly operationId: string;
+    readonly projectId: string;
+    readonly status: 'seeded' | 'already-seeded';
+    readonly acceptedLegacyFloor: number;
+    readonly nextEpicNumber: number;
+    readonly serverCapability: typeof PROJECT_IDENTITY_MIGRATION_CAPABILITY;
+    readonly receiptDigest: string;
+}
+export type ProjectIdentityMigrationReceiptBodyV1 = Omit<ProjectIdentityMigrationReceiptV1, 'receiptDigest'>;
+export declare function computeProjectIdentityMigrationReceiptDigestV1(receipt: ProjectIdentityMigrationReceiptBodyV1): string;
+export declare function assertProjectIdentityMigrationRequestV1(value: unknown): asserts value is ProjectIdentityMigrationRequestV1;
+export declare function assertProjectIdentityMigrationReceiptV1(value: unknown): asserts value is ProjectIdentityMigrationReceiptV1;

package/packages/shared/dist/invocation/project-identity-migration.js

@@ -0,0 +1,83 @@
+export const PROJECT_IDENTITY_MIGRATION_VERSION = 1;
+export const PROJECT_IDENTITY_MIGRATION_CAPABILITY = 'project-identity-migration-v1';
+export const PROJECT_ID_PATTERN = /^prj_[a-f0-9]{32}$/;
+export const PROJECT_IDENTITY_OPERATION_PATTERN = /^mig_[a-f0-9]{32}$/;
+export const SHA256_HEX_PATTERN = /^[a-f0-9]{64}$/;
+export const MAX_LEGACY_EPIC_FLOOR = Number.MAX_SAFE_INTEGER - 1;
+export function computeProjectIdentityMigrationReceiptDigestV1(receipt) {
+    const canonicalBody = {
+        version: receipt.version,
+        operationId: receipt.operationId,
+        projectId: receipt.projectId,
+        status: receipt.status,
+        acceptedLegacyFloor: receipt.acceptedLegacyFloor,
+        nextEpicNumber: receipt.nextEpicNumber,
+        serverCapability: receipt.serverCapability,
+    };
+    return createHash('sha256')
+        .update(`nx-project-identity-migration-receipt-v1\0${JSON.stringify(canonicalBody)}`, 'utf8')
+        .digest('hex');
+}
+function record(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value)
+        ? value
+        : null;
+}
+function exactKeys(value, expected) {
+    const actual = Object.keys(value).sort();
+    return actual.length === expected.length && actual.every((key, index) => key === expected[index]);
+}
+function validFloor(value) {
+    return Number.isSafeInteger(value) && value >= 0;
+}
+export function assertProjectIdentityMigrationRequestV1(value) {
+    const candidate = record(value);
+    if (candidate?.version !== PROJECT_IDENTITY_MIGRATION_VERSION) {
+        throw new Error('PROJECT_IDENTITY_MIGRATION_VERSION_UNSUPPORTED');
+    }
+    const keys = ['legacyEpicFloor', 'localStateDigest', 'operationId', 'phase', 'projectId', 'version'];
+    if (!exactKeys(candidate, keys)
+        || typeof candidate.operationId !== 'string'
+        || !PROJECT_IDENTITY_OPERATION_PATTERN.test(candidate.operationId)
+        || typeof candidate.projectId !== 'string'
+        || !PROJECT_ID_PATTERN.test(candidate.projectId)
+        || typeof candidate.localStateDigest !== 'string'
+        || !SHA256_HEX_PATTERN.test(candidate.localStateDigest)
+        || (candidate.phase !== 'prepare' && candidate.phase !== 'seed')
+        || !validFloor(candidate.legacyEpicFloor)) {
+        throw new Error('PROJECT_IDENTITY_MIGRATION_INVALID');
+    }
+    if (candidate.legacyEpicFloor > MAX_LEGACY_EPIC_FLOOR) {
+        throw new Error('PROJECT_IDENTITY_MIGRATION_FLOOR_LIMIT');
+    }
+}
+export function assertProjectIdentityMigrationReceiptV1(value) {
+    const candidate = record(value);
+    if (candidate?.version !== PROJECT_IDENTITY_MIGRATION_VERSION) {
+        throw new Error('PROJECT_IDENTITY_MIGRATION_RECEIPT_VERSION_UNSUPPORTED');
+    }
+    const keys = [
+        'acceptedLegacyFloor', 'nextEpicNumber', 'operationId', 'projectId',
+        'receiptDigest', 'serverCapability', 'status', 'version',
+    ];
+    if (!exactKeys(candidate, keys)
+        || typeof candidate.operationId !== 'string'
+        || !PROJECT_IDENTITY_OPERATION_PATTERN.test(candidate.operationId)
+        || typeof candidate.projectId !== 'string'
+        || !PROJECT_ID_PATTERN.test(candidate.projectId)
+        || (candidate.status !== 'seeded' && candidate.status !== 'already-seeded')
+        || !validFloor(candidate.acceptedLegacyFloor)
+        || candidate.acceptedLegacyFloor > MAX_LEGACY_EPIC_FLOOR
+        || !Number.isSafeInteger(candidate.nextEpicNumber)
+        || candidate.nextEpicNumber <= candidate.acceptedLegacyFloor
+        || candidate.serverCapability !== PROJECT_IDENTITY_MIGRATION_CAPABILITY
+        || typeof candidate.receiptDigest !== 'string'
+        || !SHA256_HEX_PATTERN.test(candidate.receiptDigest)) {
+        throw new Error('PROJECT_IDENTITY_MIGRATION_RECEIPT_INVALID');
+    }
+    const receipt = candidate;
+    if (receipt.receiptDigest !== computeProjectIdentityMigrationReceiptDigestV1(receipt)) {
+        throw new Error('PROJECT_IDENTITY_MIGRATION_RECEIPT_INVALID');
+    }
+}
+import { createHash } from 'node:crypto';