@ornexus/neocortex 4.60.16

package/packages/client/dist/memory/project-memory-writer.js

@@ -0,0 +1,36 @@
+import{existsSync as y,lstatSync as C,mkdirSync as $,copyFileSync as v,readdirSync as W,readFileSync as k,readlinkSync as F,renameSync as z,rmSync as T,statSync as de,symlinkSync as N,unlinkSync as G,writeFileSync as j}from"node:fs";import{platform as A}from"node:os";import{dirname as x,join as p,relative as ue}from"node:path";import{CANONICAL_PROJECT_MEMORY_SOURCE as b,getProjectMemoryTarget as I,renderArchitectureReferenceTable as le}from"./shared-project-memory-types.js";function me(){return{readFile(e){try{return k(e,"utf8")}catch{return}},writeFileAtomic(e,t){$(x(e),{recursive:!0});const r=`${e}.tmp-${process.pid}-${Date.now()}`,n=y(e)?`${e}.bak-${Date.now()}`:void 0;try{return j(r,t,"utf8"),n!==void 0&&v(e,n),z(r,e),{backupPath:n}}catch(o){if(T(r,{force:!0}),n!==void 0&&y(n))try{v(n,e)}catch{}throw o}},join(...e){return p(...e)}}}function O(e){return`<!-- ${e.ownedBlockName}-START -->`}function _(e){return`<!-- ${e.ownedBlockName}-END -->`}function g(e){const t=new Set,r=[];for(const n of e){const o=n.trim().replace(/\s+/g," ");o.length===0||t.has(o.toLowerCase())||(t.add(o.toLowerCase()),r.push(o))}return r}function fe(e){const t=new Set,r=[];for(const n of e)t.has(n.path)||(t.add(n.path),r.push(n));return r}function pe(e){switch(e.templateKind){case"neocortex-md":return"# NEOCORTEX.md Project Memory";case"claude-md":return"# CLAUDE.md Project Memory";case"agents-md":return"# AGENTS.md Project Instructions";case"gemini-md":return"# GEMINI.md Project Memory";case"copilot-instructions":return"# GitHub Copilot Repository Instructions";case"cursor-rule":return`---
+description: Neocortex project memory
+alwaysApply: true
+---
+
+# Cursor Project Memory`}}const ye=["Keep always-loaded memory compact: laws, active context, and references only.","Preserve human-authored instructions outside this owned block.","Prefer repository SSoT docs over duplicating architecture details here."],be=["Consult `docs/architecture/` before changes that affect architecture, contracts, data, security, performance, UX, or infrastructure.","Reference architecture documents by repository path, such as `docs/architecture/architecture.md`, before changing related implementation.","Summarize decisions and trade-offs in NEOCORTEX.md; do not paste complete architecture documents into memory.","Update memory for durable cross-layer changes across skills/agents, frontend, backend, API, DB, schemas, envs, DevOps, cyber security, testing/QA, observability, product, docs, and platform contracts.","Prioritize compact summaries of durable decisions, public contracts, operational risks, debts, command behavior, and repository paths; skip transient logs, raw payloads, secrets, private prompts, long documents, and duplicated canonical sources.","Keep platform memory files symlink-backed or include-backed to NEOCORTEX.md when supported."],We=["skills-agents","frontend","backend","api","db","schemas","envs","devops","cyber-security","testing-qa","observability","product-business","docs-architecture","platform-memory","command-behavior","generic"],he=360,X={feature:"Features",rule:"Rules/Policies",flag:"Flags",route:"Routes",api:"APIs/Contracts","db-schema":"DB/Schema",architecture:"Architecture",debt:"Debts",decision:"Decisions",generic:"General Updates"},ge=/\b(private|proprietary|server[- ]only|system)\s+prompt\b|\b(api[-_ ]?key|license[-_ ]?key|password|authorization|bearer|token|secret)\s*[:=]|\b(ghp_[A-Za-z0-9_]+|sk-[A-Za-z0-9_-]+|xox[baprs]-[A-Za-z0-9-]+)\b|\b(customer|cliente)\s+(payload|record|email|phone)\b|\b(customer|cliente)\s+(data|dados)\s+(payload|record|email|phone)\b|\b(customer|cliente)\s+(data|dados)\s*[:=]|\braw\s+payload\b/i;function ke(e){const t=e.toLowerCase();return/\b(project memory|canonical memory|memory heuristic|neocortex\.md|\*update-memory)\b/.test(t)?"decision":/\b(feature|capability|funcionalidade|release)\b/.test(t)?"feature":/\b(rule|policy|guardrail|regra|lei|must|never)\b/.test(t)?"rule":/\b(flag|feature[- ]?flag|toggle|env var|environment variable)\b/.test(t)?"flag":/\b(api|contract|schema contract|graphql|rest|rpc|webhook)\b/.test(t)?"api":/\b(db|database|schema|migration|table|column|prisma|sql)\b/.test(t)?"db-schema":/\b(decision|decisão|decisao|accepted|rejected|trade[- ]?off)\b/.test(t)?"decision":/\b(route|endpoint route|url path|pathname)\b|\/(api|admin|portal|v\d+)\//.test(t)?"route":/\b(architecture|arquitetura|adr|topology|infra|boundary)\b/.test(t)?"architecture":/\b(debt|follow[- ]?up|todo|tech[- ]?debt|dívida|divida)\b/.test(t)?"debt":"generic"}function we(e){const t=e.toLowerCase();return/\b(neocortex\.md|project memory|canonical memory|memory wrapper|symlink|owned block|memory heuristic)\b/.test(t)?"platform-memory":/\b(command|cli|\*update-memory|\*create-epic|\*arch-plan|workflow behavior)\b/.test(t)?"command-behavior":/\b(skill|agent|subagent|orchestrator|opencode|codex|claude|gemini|cursor)\b/.test(t)?"skills-agents":/\b(frontend|ui|ux|react|component|design[- ]?system|css|accessibility|a11y)\b/.test(t)?"frontend":/\b(backend|server|service|worker|job|queue)\b/.test(t)?"backend":/\b(api|endpoint|rest|graphql|rpc|webhook|contract)\b/.test(t)?"api":/\b(db|database|table|column|migration|sql|prisma)\b/.test(t)?"db":/\b(schema|schemas|zod|json schema|protobuf|openapi)\b/.test(t)?"schemas":/\b(env|environment|\.env\.example|config|configuration|feature[- ]?flag)\b/.test(t)?"envs":/\b(devops|deploy|deployment|ci|cd|docker|container|kubernetes|infra|terraform|rollback)\b/.test(t)?"devops":/\b(security|cyber|auth|authorization|permission|compliance|vulnerability|secret|token redaction)\b/.test(t)?"cyber-security":/\b(test|testing|qa|e2e|unit|integration|snapshot|property[- ]?based|flaky)\b/.test(t)?"testing-qa":/\b(observability|metric|metrics|log|logging|trace|tracing|alert|monitoring|slo)\b/.test(t)?"observability":/\b(product|business|user journey|onboarding|pricing|tenant|customer-facing)\b/.test(t)?"product-business":/\b(docs|documentation|architecture|arquitetura|adr|runbook|decision record)\b/.test(t)?"docs-architecture":"generic"}function K(e){const t=e.trim().replace(/\s+/g," ");if(Buffer.byteLength(t,"utf8")<=he)return t;const r=t.match(/(?:^|\s)([\w.-]+(?:\/[\w.@-]+)+(?:\.[A-Za-z0-9]+)?)/)?.[1],n=t.slice(0,220).replace(/\s+\S*$/,"").trim();return r?`${n}\u2026 See ${r} for details.`:`${n}\u2026 Details omitted from always-loaded memory; keep source content in repository docs.`}function Ee(e){f(e);const t=ke(e),r=we(e);return{kind:t,layer:r,sectionTitle:X[t],summary:K(e),reasonCode:`memory_update_${t.replace("-","_")}`}}function H(e){const t=new Set,r=[];for(const n of e){const o=Ee(n),i=`${o.kind}:${o.summary.toLowerCase()}`;t.has(i)||(t.add(i),r.push(o))}return r}function f(e){if(ge.test(e))throw new Error("Project memory input violates IP boundary guardrails.")}function Y(e,t){const r=(e??"").split(`
+`),n=t.split(`
+`),o=[],i=Math.max(r.length,n.length);for(let d=0;d<i;d++){const a=r[d],u=n[d];if(a!==u&&(a!==void 0&&o.push(`- ${a}`),u!==void 0&&o.push(`+ ${u}`),o.length>=80)){o.push("\u2026 diff truncated; inspect repository diff for full context.");break}}const s=o.join(`
+`);return f(s),s}function L(e){f(e.path),f(e.title),f(e.purpose),f(e.suggestedUsage)}function Ce(e,t,r){e.forEach(f),t.forEach(L),r?.universalLaws?.forEach(f),r?.businessContext?.forEach(f),r?.activeContext?.forEach(f),r?.repositoryMap?.forEach(f),r?.environmentPractices?.forEach(f),r?.platformMemoryContract?.forEach(f),r?.maintenanceRules?.forEach(f),r?.heuristics?.forEach(f),r?.importantReferences?.forEach(L),r?.architectureReferences?.forEach(L)}function J(e){return[pe(e),"","This file contains compact, always-loaded project memory. Keep detailed architecture in referenced docs.",""].join(`
+`)}function Z(e,t,r,n){Ce(t,r,n);const o=g([...ye,...n?.universalLaws??[]]),i=g([...n?.activeContext??[],...t.map(K)]),s=H(t),d=g(n?.businessContext??["Product/business context was not explicitly documented during bootstrap; treat conclusions as repository-inferred until a human updates this section."]),a=g(n?.repositoryMap??["Source, tests, package/build files, docs, CI, and runtime manifests are the permitted bootstrap sources for repository orientation."]),u=g(n?.environmentPractices??["Use `.env.example` for configuration shape only; do not read real environment files or credential-bearing files into always-loaded memory."]),c=g(n?.platformMemoryContract??["Semantic platform memory file must resolve to NEOCORTEX.md through a symlink; do not replace it with an unrelated wrapper or copied frontmatter.","Platform wrapper/frontmatter must be preserved via split/include/managed block while the semantic memory payload remains symlink-backed by NEOCORTEX.md."]),l=g(n?.maintenanceRules??["Keep NEOCORTEX.md deterministic, compact, objective, and direct; store only summaries, indexes, and links to detailed docs.","Do not copy protected prompt bodies, proprietary wrappers, server-side internals, customer data, license keys, or long document bodies into always-loaded memory."]),h=fe([...n?.importantReferences??[],...n?.architectureReferences??[],...r]),R=g([...be,...n?.heuristics??[]]),w=o.map(m=>`- ${m}`),S=i.length>0?i.map(m=>`- ${m}`):["- No active project notes recorded."],ie=h.length>0?le(h):"No architecture references discovered.",ae=s.length>0?Object.entries(X).flatMap(([m,ce])=>{const U=s.filter(E=>E.kind===m);return U.length>0?[`### ${ce}`,...U.map(E=>`- [${E.reasonCode}] ${E.summary} (layer: ${E.layer})`)]:[]}):["- No durable change feedback recorded."];return[O(e),"## Universal Project Laws",...w,"","## Business/Product Context",...d.map(m=>`- ${m}`),"","## Active Context",...S,"","## Durable Change Feedback",...ae,"","## Architecture References",ie,"","## Repository Map",...a.map(m=>`- ${m}`),"","## Environment/Container/Production/Security/Dev Practices",...u.map(m=>`- ${m}`),"","## Platform Memory Contract",...c.map(m=>`- ${m}`),`- NEOCORTEX.md is the canonical project memory source for every platform target; run \`${e.bidirectionalReference.feedbackTrigger}\` when durable context discovered in a platform wrapper should be fed back into canonical memory.`,"","## Maintenance Rules",...l.map(m=>`- ${m}`),"","## Architecture Heuristics",...R.map(m=>`- ${m}`),_(e)].join(`
+`)}const Q=["docs/architecture","docs/arquitetura-software"],Pe=["README.md","readme.md","architecture.md","docs/architecture.md"],Re=["package.json","pnpm-lock.yaml","package-lock.json","yarn.lock","tsconfig.json","vite.config.ts","turbo.json"],Se=["Dockerfile","docker-compose.yml","compose.yml",".env.example","fly.toml"],$e=["AGENTS.md","CLAUDE.md","GEMINI.md",".opencode/AGENTS.md",".cursor/rules/neocortex.mdc"];function V(e,t,r=24e3){const n=p(e,t);try{if(!y(n)||C(n).isDirectory())return;const o=k(n,"utf8");return o.length<=r?o:o.slice(0,r)}catch{return}}function D(e,t){$(x(e),{recursive:!0});const r=`${e}.tmp-${process.pid}-${Date.now()}`,n=y(e)?`${e}.bak-${Date.now()}`:void 0;try{return j(r,t,"utf8"),n!==void 0&&v(e,n),z(r,e),n}catch(o){if(T(r,{force:!0}),n!==void 0&&y(n))try{v(n,e)}catch{}throw o}}function q(e){return Array.from(new Set(H(e).map(t=>t.reasonCode)))}function P(e,t){try{return y(p(e,t))}catch{return!1}}function ve(e,t){try{return W(p(e,t),{withFileTypes:!0}).filter(r=>!r.name.startsWith(".")&&!r.name.toLowerCase().includes("secret")).sort((r,n)=>r.name.localeCompare(n.name)).slice(0,8).map(r=>`${t}/${r.name}${r.isDirectory()?"/":""}`)}catch{return[]}}function ee(e,t,r=16){try{const n=W(p(e,t),{withFileTypes:!0}).filter(i=>!i.name.startsWith(".")&&!i.name.startsWith("_")).sort((i,s)=>i.name.localeCompare(s.name)),o=[];for(const i of n){const s=`${t}/${i.name}`;if(i.isDirectory()?o.push(...ee(e,s,r-o.length)):/\.(md|markdown)$/i.test(i.name)&&o.push(s),o.length>=r)break}return o}catch{return[]}}function Te(e,t){const r=t.match(/^#\s+(.+?)\s*$/m)?.[1]?.trim();return r?r.replace(/[`*_#]/g,""):e.split("/").pop()?.replace(/\.(md|markdown)$/i,"").replace(/[-_]+/g," ")??e}function xe(e,t){const r=/\b(stale|deprecated|outdated|incerto|uncertain)\b/i.test(`${e}
+${t.slice(0,2e3)}`),n=t.replace(/^---[\s\S]*?---\s*/,"").split(/\n{2,}/).map(i=>i.replace(/^#+\s+.+$/gm,"").replace(/[`*_>#]/g,"").replace(/\s+/g," ").trim()).find(i=>i.length>0&&!i.startsWith("|"));return`${r?"[stale/uncertain evidence] ":""}${(n??"Architecture reference for this project.").slice(0,180)}`}function Oe(e){const t=e.toLowerCase();return/deploy|infra|docker|production|runbook/.test(t)?"Use before changing deployment, runtime, containers, or production operations.":/security|auth|compliance/.test(t)?"Use before changing auth, compliance, or security-sensitive behavior.":/api|contract|state|schema/.test(t)?"Use before changing contracts, APIs, schemas, or persisted state.":"Use before implementation in this area; verify freshness when marked stale or uncertain."}function te(e){const t=Re.filter(c=>P(e,c)),r=Se.filter(c=>P(e,c)),n=$e.filter(c=>P(e,c)),o=["packages","src","apps","tests","__tests__"].filter(c=>P(e,c)),s=[...Q.flatMap(c=>ee(e,c)),...Pe.filter(c=>P(e,c))].slice(0,24).flatMap(c=>{const l=V(e,c,48e3);return l?[{path:c,title:Te(c,l),purpose:xe(c,l),suggestedUsage:Oe(c),source:Q.some(h=>c.startsWith(`${h}/`))?"architecture-root":"fallback-file"}]:[]}),d=V(e,"package.json"),a=d?.match(/"name"\s*:\s*"([^"]+)"/)?.[1],u=[...d?.matchAll(/"(test|build|lint|typecheck|dev)"\s*:/g)??[]].map(c=>c[1]);return{universalLaws:["Bootstrap canonical memory before creating or repairing platform memory wrappers when NEOCORTEX.md is absent.","Use only permitted repository sources for bootstrap: package/build files, architecture docs, README/deploy docs, .env.example, runtime manifests, CI, source/test layout, and platform memory wrappers."],businessContext:[a?`Repository package name: ${a}.`:"Repository product name was not declared in package metadata.","Business/product conclusions are bootstrap-inferred and must be refined from canonical docs or human input."],activeContext:[`Bootstrap scanned ${t.length} package/build files, ${s.length} architecture/readme docs, ${r.length} runtime/config templates, and ${n.length} platform memory wrappers.`,u.length>0?`Detected quality scripts: ${u.sort().join(", ")}.`:"No standard quality scripts were detected in package metadata."],repositoryMap:[t.length>0?`Package/build files: ${t.join(", ")}.`:"No package/build files detected in permitted bootstrap set.",o.length>0?`Source/test roots: ${o.flatMap(c=>ve(e,c)).slice(0,16).join(", ")}.`:"Source/test roots were not detected in standard locations.",n.length>0?`Platform memory/wrappers: ${n.join(", ")}.`:"No platform memory wrappers detected before bootstrap."],environmentPractices:[r.length>0?`Runtime/config templates: ${r.join(", ")}.`:"No Docker/compose/.env.example/runtime manifest detected in permitted bootstrap set.","Read `.env.example` only for configuration shape; never ingest real .env files, credentials, customer data, or license keys into memory.","Run repository quality scripts before commit and keep CI/deploy evidence referenced by path or URL rather than copied verbatim."],platformMemoryContract:["Semantic platform memory file must resolve to NEOCORTEX.md through a symlink; do not replace it with an unrelated wrapper or copied frontmatter.","Preserve wrappers/frontmatter via split/include/managed block while the semantic memory payload remains symlink-backed by NEOCORTEX.md."],maintenanceRules:["Generated memory must be deterministic, objective, direct, compact, and inside the target always-loaded context budget.","Cite long architecture docs by path with usage guidance; mark stale or uncertain docs when repository evidence indicates that status.","Do not copy protected prompt bodies, proprietary wrappers, server internals, secrets, customer data, license keys, or complete long documents."],architectureReferences:s,heuristics:["Before processing a story, consult the cited Architecture References whose path or suggested usage intersects the change.","When a referenced doc is marked stale/uncertain, validate against current package/runtime/source evidence before relying on it."]}}function B(e,t,r){const n=O(t),o=_(t),i=e.indexOf(n),s=e.indexOf(o);if(i>=0&&s>=i){const a=s+o.length;return`${e.slice(0,i)}${r}${e.slice(a)}`}const d=e.endsWith(`
+`)?`
+`:`
+
+`;return`${e}${d}${r}
+`}function Me(e){return e.endsWith(".mdc")?`---
+description: Neocortex project memory
+alwaysApply: true
+---
+
+`:e.endsWith(".toml")?`[agent]
+name = "neocortex"
+description = "Neocortex project memory wrapper"
+
+`:e.endsWith(".agent.md")?`---
+name: neocortex
+description: Neocortex project memory wrapper
+---
+
+`:""}function re(e,t){const r=x(p(e,t)),n=p(e,b),o=ue(r,n);return o.length>0?o:b}function M(e,t){return!!(e.targetId==="canonical"||e.requiresWrapperPreservation||e.linkRequirement.requiresWrapperPreservation||e.linkRequirement.wrapperAllowed||t==="AGENTS.md"||t.includes("/agents/")||t.includes("/skills/")||t.endsWith(".toml")||t.endsWith(".mdc")||t.endsWith(".agent.md")||t.endsWith(".instructions.md"))}function Ne(e){return e.linkRequirement.symlinkBacked&&e.linkRequirement.semanticFileRequired}function ne(e,t,r,n){if(n!==void 0)return n;const o=Ne(t);if(!o)return{os:A(),supported:!1,permission:"unknown",filesystem:"unknown",targetPolicy:t.linkRequirement.policy,targetPolicyAllowsSymlink:o,requiresWrapperPreservation:M(t,r),reason:`target policy ${t.linkRequirement.policy} does not allow semantic symlink orchestration`};const i=p(e,".neocortex","tmp"),s=p(i,`symlink-capability-source-${process.pid}-${Date.now()}`),d=p(i,`symlink-capability-link-${process.pid}-${Date.now()}`);try{$(i,{recursive:!0}),j(s,"probe","utf8"),N(s,d);const a=C(d).isSymbolicLink()&&de(d).isFile();return{os:A(),supported:a,permission:a?"ok":"unknown",filesystem:a?"supports-symlink":"no-symlink-support",targetPolicy:t.linkRequirement.policy,targetPolicyAllowsSymlink:o,requiresWrapperPreservation:M(t,r),reason:a?void 0:"filesystem probe did not create a resolvable symbolic link"}}catch(a){const u=a instanceof Error?a.message:String(a),c=/EPERM|EACCES|operation not permitted|permission/i.test(u);return{os:A(),supported:!1,permission:c?"denied":"unknown",filesystem:"no-symlink-support",targetPolicy:t.linkRequirement.policy,targetPolicyAllowsSymlink:o,requiresWrapperPreservation:M(t,r),reason:u}}finally{T(d,{force:!0}),T(s,{force:!0})}}function je(e,t,r,n){const o=re(n,t),i=r??`${Me(t)}# ${e.platformName} Neocortex Memory Wrapper
+
+`,s=[O(e),"## Canonical Project Memory Source","",`This platform wrapper preserves host-specific frontmatter/instructions while resolving project memory to \`${o}\`.`,"",`- Canonical source: \`${b}\``,`- Symlink-backed/source-of-truth file: \`${o}\``,`- Feedback loop: read \`${o}\` for shared context and run \`${e.bidirectionalReference.feedbackTrigger}\` when durable platform findings should update \`${b}\`.`,"- Human-authored content outside this managed block is preserved byte-for-byte.",_(e)].join(`
+`);return B(i,e,s)}function oe(e,t,r,n,o,i=!1){const s=p(e,t),a=`${["[NEOCORTEX COMPATIBILITY REMEDIATION]","Materialized project memory fallback because semantic symlink orchestration failed.","This is not product mode; repair host permissions/filesystem support and restore the symlink to NEOCORTEX.md.","WARNING: materialized fallback is remediation debt, not a silent mode; run *update-memory for durable context and repair this file back to canonical NEOCORTEX.md resolution.",`Fallback reason: ${o}`,""].join(`
+`)}${r}`,c=(y(s)?k(s,"utf8"):void 0)!==a;return c&&!i&&(y(s)&&C(s).isSymbolicLink()&&G(s),D(s,a)),{filePath:s,relativeFile:t,changed:c,content:a,mode:"compatibility-materialized-fallback",canonicalSource:b,symlinkCapability:n,fallbackReason:o,remediationDebt:`Repair ${t} so it is a symlink to ${b}; fallback is compatibility remediation only.`}}function Ae(e,t,r,n,o,i=!1){const s=p(e,t),d=re(e,t);$(x(s),{recursive:!0});const a=ne(e,r,t,o);if(!a.supported)return oe(e,t,n,a,a.reason??"symlink capability detection reported unsupported host",i);if(i){let c=!0;try{c=!(y(s)&&C(s).isSymbolicLink()&&F(s)===d)}catch{c=!0}return{filePath:s,relativeFile:t,changed:c,content:n,mode:"semantic-symlink",canonicalSource:b,symlinkCapability:a}}let u=!1;try{return y(s)?C(s).isSymbolicLink()&&F(s)===d?u=!1:(G(s),N(d,s),u=!0):(N(d,s),u=!0),{filePath:s,relativeFile:t,changed:u,content:k(s,"utf8"),mode:"semantic-symlink",canonicalSource:b,symlinkCapability:a}}catch(c){const l=c instanceof Error?c.message:String(c);return oe(e,t,n,{...a,supported:!1,permission:/EPERM|EACCES|operation not permitted|permission/i.test(l)?"denied":a.permission,filesystem:"no-symlink-support",reason:l},l,i)}}function Ie(e,t,r,n,o){const i=a=>a.split(`
+`).length<=e.budget.maxLines&&Buffer.byteLength(a,"utf8")<=e.budget.maxBytes;if(i(t))return t;const s=Z(e,r.slice(0,8),n.slice(0,12),o),d=B(t.includes(O(e))?t:J(e),e,s);return i(d)?d:d.slice(0,e.budget.maxBytes)}function se(e,t,r=[],n=[],o){const i=t??J(e),s=Z(e,r,n,o),d=B(i,e,s);return Ie(e,d,r,n,o)}function _e(e){const t=I(e.targetId),r=e.fs??me(),n=r.join(e.projectRoot,t.primaryFile);if(t.targetId!=="canonical"&&e.fs===void 0){const a=Le(e).files.find(u=>u.relativeFile===t.primaryFile);if(a===void 0)throw new Error(`Primary project memory file was not written for ${t.targetId}.`);return{filePath:a.filePath,changed:a.changed,content:a.content}}const o=r.readFile(n),i=e.bootstrapArchitecture??(e.fs===void 0&&t.targetId==="canonical"&&o===void 0?te(e.projectRoot):void 0),s=se(t,o,e.memoryNotes,e.architectureReferences,i);if(o===s)return{filePath:n,changed:!1,content:s};const d=e.dryRun?void 0:r.writeFileAtomic(n,s);return{filePath:n,changed:!0,content:s,safeDiff:Y(o,s),backupPath:d?.backupPath,reasonCodes:q(e.memoryNotes??[])}}function Fe(e){return _e({...e,targetId:"canonical"})}function Le(e){if(e.fs!==void 0)throw new Error("writeProjectMemoryTargetFiles requires the node filesystem to manage symlinks safely.");const t=I(e.targetId),r=I("canonical"),n=p(e.projectRoot,b),o=y(n)?k(n,"utf8"):void 0,i=e.bootstrapArchitecture??(o===void 0?te(e.projectRoot):void 0),s=se(r,o,e.memoryNotes,e.architectureReferences,i),d=!y(n)||k(n,"utf8")!==s;let a;if(d&&!e.dryRun&&(a=D(n,s)),t.targetId==="canonical")return{targetId:t.targetId,canonicalFilePath:n,changed:d,files:[{filePath:n,relativeFile:b,changed:d,content:s,mode:"canonical",canonicalSource:b,safeDiff:Y(o,s),backupPath:a,reasonCodes:q(e.memoryNotes??[])}]};const c=Array.from(new Set([t.primaryFile,...t.secondaryFiles])).map(l=>{if(!M(t,l))return Ae(e.projectRoot,l,t,s,e.symlinkCapability,e.dryRun);const h=p(e.projectRoot,l),R=y(h)?k(h,"utf8"):void 0,w=je(t,l,R,e.projectRoot),S=R!==w;return S&&!e.dryRun&&D(h,w),{filePath:h,relativeFile:l,changed:S,content:w,mode:"managed-wrapper",canonicalSource:b,symlinkCapability:ne(e.projectRoot,t,l,e.symlinkCapability),reasonCodes:q(e.memoryNotes??[])}});return{targetId:t.targetId,canonicalFilePath:n,files:c,changed:d||c.some(l=>l.changed)}}export{We as PROJECT_MEMORY_LAYER_CATEGORIES,te as bootstrapArchitectureMemory,se as buildProjectMemoryContent,Ee as classifyProjectMemoryUpdate,me as createNodeProjectMemoryFs,Y as createSafeProjectMemoryDiff,Fe as writeCanonicalProjectMemory,_e as writeProjectMemory,Le as writeProjectMemoryTargetFiles};

package/packages/client/dist/memory/shared-project-memory-types.d.ts

@@ -0,0 +1,370 @@
+/**
+ * P130.06: Client-side SSoT-Shadow mirror for project memory targets.
+ *
+ * The published client tarball must not import the workspace-only shared package
+ * at runtime. Keep this file in sync with `packages/shared/src/project-memory-*`
+ * and enforce drift through the P130.06 release tests.
+ */
+export type ProjectMemoryTargetId = 'canonical' | 'claude-code' | 'codex' | 'gemini-cli' | 'antigravity' | 'vscode' | 'cursor' | 'opencode' | 'openclaw' | 'kimi' | 'github-copilot-cli';
+export type ProjectMemoryTemplateKind = 'neocortex-md' | 'claude-md' | 'agents-md' | 'gemini-md' | 'copilot-instructions' | 'cursor-rule';
+export interface ProjectMemoryBudget {
+    readonly maxLines: number;
+    readonly maxBytes: number;
+}
+export type ProjectMemoryLinkPolicy = 'mandatory-semantic-symlink' | 'symlink-backed-wrapper' | 'safe-include-fallback';
+export interface ProjectMemoryLinkRequirement {
+    readonly canonicalSource: typeof CANONICAL_PROJECT_MEMORY_SOURCE;
+    readonly semanticFileRequired: boolean;
+    readonly symlinkBacked: boolean;
+    readonly wrapperAllowed: boolean;
+    readonly includeFallbackAllowed: boolean;
+    readonly requiresWrapperPreservation: boolean;
+    readonly fallbackIsCompatibilityRemediation: boolean;
+    readonly policy: ProjectMemoryLinkPolicy;
+    readonly notes: string;
+}
+export interface ProjectMemoryTarget {
+    readonly targetId: ProjectMemoryTargetId;
+    readonly platformName: string;
+    readonly canonicalSource: typeof CANONICAL_PROJECT_MEMORY_SOURCE;
+    readonly primaryFile: string;
+    readonly secondaryFiles: readonly string[];
+    readonly ownedBlockName: string;
+    readonly templateKind: ProjectMemoryTemplateKind;
+    readonly budget: ProjectMemoryBudget;
+    readonly linkRequirement: ProjectMemoryLinkRequirement;
+    readonly bidirectionalReference: ProjectMemoryBidirectionalReference;
+    readonly requiresWrapperPreservation: boolean;
+    readonly notes: string;
+}
+export interface ProjectMemoryBidirectionalReference {
+    readonly canonicalSource: typeof CANONICAL_PROJECT_MEMORY_SOURCE;
+    readonly resolvesVia: ProjectMemoryLinkPolicy;
+    readonly feedbackTrigger: '*update-memory';
+    readonly guidance: string;
+}
+export type ArchitectureReferenceSource = 'architecture-root' | 'fallback-file';
+export interface ArchitectureReference {
+    readonly path: string;
+    readonly title: string;
+    readonly purpose: string;
+    readonly suggestedUsage: string;
+    readonly source: ArchitectureReferenceSource;
+}
+export interface BootstrapArchitectureMemory {
+    readonly universalLaws?: readonly string[];
+    readonly businessContext?: readonly string[];
+    readonly activeContext?: readonly string[];
+    readonly repositoryMap?: readonly string[];
+    readonly environmentPractices?: readonly string[];
+    readonly platformMemoryContract?: readonly string[];
+    readonly maintenanceRules?: readonly string[];
+    readonly importantReferences?: readonly ArchitectureReference[];
+    readonly architectureReferences?: readonly ArchitectureReference[];
+    readonly heuristics?: readonly string[];
+}
+export declare const CANONICAL_PROJECT_MEMORY_SOURCE: "NEOCORTEX.md";
+export declare const PROJECT_MEMORY_TARGET_IDS: readonly ["claude-code", "codex", "gemini-cli", "antigravity", "vscode", "cursor", "opencode", "openclaw", "kimi", "github-copilot-cli"];
+export declare const PROJECT_MEMORY_TARGETS: {
+    readonly canonical: {
+        readonly targetId: "canonical";
+        readonly platformName: "Neocortex Canonical Memory";
+        readonly canonicalSource: "NEOCORTEX.md";
+        readonly primaryFile: "NEOCORTEX.md";
+        readonly secondaryFiles: readonly ["AGENTS.md", "CLAUDE.md", "GEMINI.md"];
+        readonly ownedBlockName: "NEOCORTEX-MEMORY";
+        readonly templateKind: "neocortex-md";
+        readonly budget: {
+            readonly maxLines: 220;
+            readonly maxBytes: 18000;
+        };
+        readonly linkRequirement: {
+            readonly canonicalSource: "NEOCORTEX.md";
+            readonly semanticFileRequired: true;
+            readonly symlinkBacked: true;
+            readonly wrapperAllowed: false;
+            readonly includeFallbackAllowed: false;
+            readonly requiresWrapperPreservation: false;
+            readonly fallbackIsCompatibilityRemediation: true;
+            readonly policy: "mandatory-semantic-symlink";
+            readonly notes: "Semantic platform memory file must resolve to NEOCORTEX.md through a symlink; do not replace it with an unrelated wrapper or copied frontmatter.";
+        };
+        readonly bidirectionalReference: ProjectMemoryBidirectionalReference;
+        readonly requiresWrapperPreservation: false;
+        readonly notes: "Canonical compact project memory source for platform symlinks and wrappers. Store only summaries, indexes, and links to architecture docs here.";
+    };
+    readonly 'claude-code': {
+        readonly targetId: "claude-code";
+        readonly platformName: "Claude Code";
+        readonly canonicalSource: "NEOCORTEX.md";
+        readonly primaryFile: "CLAUDE.md";
+        readonly secondaryFiles: readonly [".claude/agents/neocortex.md"];
+        readonly ownedBlockName: "NEOCORTEX-MEMORY";
+        readonly templateKind: "claude-md";
+        readonly budget: {
+            readonly maxLines: 320;
+            readonly maxBytes: 28000;
+        };
+        readonly linkRequirement: {
+            readonly canonicalSource: "NEOCORTEX.md";
+            readonly semanticFileRequired: true;
+            readonly symlinkBacked: true;
+            readonly wrapperAllowed: false;
+            readonly includeFallbackAllowed: false;
+            readonly requiresWrapperPreservation: false;
+            readonly fallbackIsCompatibilityRemediation: true;
+            readonly policy: "mandatory-semantic-symlink";
+            readonly notes: "Semantic platform memory file must resolve to NEOCORTEX.md through a symlink; do not replace it with an unrelated wrapper or copied frontmatter.";
+        };
+        readonly bidirectionalReference: ProjectMemoryBidirectionalReference;
+        readonly requiresWrapperPreservation: false;
+        readonly notes: "Claude Code project memory. Resolve to NEOCORTEX.md; keep root content concise and link deeper docs with @path references.";
+    };
+    readonly codex: {
+        readonly targetId: "codex";
+        readonly platformName: "Codex CLI";
+        readonly canonicalSource: "NEOCORTEX.md";
+        readonly primaryFile: "AGENTS.md";
+        readonly secondaryFiles: readonly [".codex/agents/neocortex.toml"];
+        readonly ownedBlockName: "NEOCORTEX-MEMORY";
+        readonly templateKind: "agents-md";
+        readonly budget: {
+            readonly maxLines: 220;
+            readonly maxBytes: 18000;
+        };
+        readonly linkRequirement: {
+            readonly canonicalSource: "NEOCORTEX.md";
+            readonly semanticFileRequired: true;
+            readonly symlinkBacked: true;
+            readonly wrapperAllowed: false;
+            readonly includeFallbackAllowed: false;
+            readonly requiresWrapperPreservation: false;
+            readonly fallbackIsCompatibilityRemediation: true;
+            readonly policy: "mandatory-semantic-symlink";
+            readonly notes: "Semantic platform memory file must resolve to NEOCORTEX.md through a symlink; do not replace it with an unrelated wrapper or copied frontmatter.";
+        };
+        readonly bidirectionalReference: ProjectMemoryBidirectionalReference;
+        readonly requiresWrapperPreservation: true;
+        readonly notes: "Codex root instructions. Uppercase AGENTS.md is required on case-sensitive filesystems.";
+    };
+    readonly 'gemini-cli': {
+        readonly targetId: "gemini-cli";
+        readonly platformName: "Gemini CLI";
+        readonly canonicalSource: "NEOCORTEX.md";
+        readonly primaryFile: "GEMINI.md";
+        readonly secondaryFiles: readonly [".gemini/agents/neocortex.md"];
+        readonly ownedBlockName: "NEOCORTEX-MEMORY";
+        readonly templateKind: "gemini-md";
+        readonly budget: {
+            readonly maxLines: 260;
+            readonly maxBytes: 22000;
+        };
+        readonly linkRequirement: {
+            readonly canonicalSource: "NEOCORTEX.md";
+            readonly semanticFileRequired: true;
+            readonly symlinkBacked: true;
+            readonly wrapperAllowed: false;
+            readonly includeFallbackAllowed: false;
+            readonly requiresWrapperPreservation: false;
+            readonly fallbackIsCompatibilityRemediation: true;
+            readonly policy: "mandatory-semantic-symlink";
+            readonly notes: "Semantic platform memory file must resolve to NEOCORTEX.md through a symlink; do not replace it with an unrelated wrapper or copied frontmatter.";
+        };
+        readonly bidirectionalReference: ProjectMemoryBidirectionalReference;
+        readonly requiresWrapperPreservation: false;
+        readonly notes: "Gemini CLI context file. Prefer shallow @file.md imports for detailed architecture docs.";
+    };
+    readonly antigravity: {
+        readonly targetId: "antigravity";
+        readonly platformName: "Antigravity";
+        readonly canonicalSource: "NEOCORTEX.md";
+        readonly primaryFile: "GEMINI.md";
+        readonly secondaryFiles: readonly [".gemini/agents/neocortex.md"];
+        readonly ownedBlockName: "NEOCORTEX-MEMORY";
+        readonly templateKind: "gemini-md";
+        readonly budget: {
+            readonly maxLines: 260;
+            readonly maxBytes: 22000;
+        };
+        readonly linkRequirement: {
+            readonly canonicalSource: "NEOCORTEX.md";
+            readonly semanticFileRequired: true;
+            readonly symlinkBacked: true;
+            readonly wrapperAllowed: false;
+            readonly includeFallbackAllowed: false;
+            readonly requiresWrapperPreservation: false;
+            readonly fallbackIsCompatibilityRemediation: true;
+            readonly policy: "mandatory-semantic-symlink";
+            readonly notes: "Semantic platform memory file must resolve to NEOCORTEX.md through a symlink; do not replace it with an unrelated wrapper or copied frontmatter.";
+        };
+        readonly bidirectionalReference: ProjectMemoryBidirectionalReference;
+        readonly requiresWrapperPreservation: false;
+        readonly notes: "Antigravity currently shares GEMINI.md behavior with the Gemini target stubs.";
+    };
+    readonly vscode: {
+        readonly targetId: "vscode";
+        readonly platformName: "VS Code / GitHub Copilot";
+        readonly canonicalSource: "NEOCORTEX.md";
+        readonly primaryFile: ".github/copilot-instructions.md";
+        readonly secondaryFiles: readonly [".github/instructions/neocortex.instructions.md", ".github/agents/neocortex.agent.md"];
+        readonly ownedBlockName: "NEOCORTEX-MEMORY";
+        readonly templateKind: "copilot-instructions";
+        readonly budget: {
+            readonly maxLines: 180;
+            readonly maxBytes: 14000;
+        };
+        readonly linkRequirement: {
+            readonly canonicalSource: "NEOCORTEX.md";
+            readonly semanticFileRequired: true;
+            readonly symlinkBacked: true;
+            readonly wrapperAllowed: true;
+            readonly includeFallbackAllowed: false;
+            readonly requiresWrapperPreservation: true;
+            readonly fallbackIsCompatibilityRemediation: true;
+            readonly policy: "symlink-backed-wrapper";
+            readonly notes: "Platform wrapper/frontmatter is allowed only when the semantic memory payload remains symlink-backed by NEOCORTEX.md.";
+        };
+        readonly bidirectionalReference: ProjectMemoryBidirectionalReference;
+        readonly requiresWrapperPreservation: true;
+        readonly notes: "VS Code and GitHub Copilot always-on repository instructions.";
+    };
+    readonly cursor: {
+        readonly targetId: "cursor";
+        readonly platformName: "Cursor";
+        readonly canonicalSource: "NEOCORTEX.md";
+        readonly primaryFile: ".cursor/rules/neocortex.mdc";
+        readonly secondaryFiles: readonly ["AGENTS.md"];
+        readonly ownedBlockName: "NEOCORTEX-MEMORY";
+        readonly templateKind: "cursor-rule";
+        readonly budget: {
+            readonly maxLines: 180;
+            readonly maxBytes: 14000;
+        };
+        readonly linkRequirement: {
+            readonly canonicalSource: "NEOCORTEX.md";
+            readonly semanticFileRequired: true;
+            readonly symlinkBacked: true;
+            readonly wrapperAllowed: true;
+            readonly includeFallbackAllowed: false;
+            readonly requiresWrapperPreservation: true;
+            readonly fallbackIsCompatibilityRemediation: true;
+            readonly policy: "symlink-backed-wrapper";
+            readonly notes: "Platform wrapper/frontmatter is allowed only when the semantic memory payload remains symlink-backed by NEOCORTEX.md.";
+        };
+        readonly bidirectionalReference: ProjectMemoryBidirectionalReference;
+        readonly requiresWrapperPreservation: true;
+        readonly notes: "Cursor rule memory. Use AGENTS.md as compatibility fallback when Cursor rules are absent.";
+    };
+    readonly opencode: {
+        readonly targetId: "opencode";
+        readonly platformName: "OpenCode";
+        readonly canonicalSource: "NEOCORTEX.md";
+        readonly primaryFile: "AGENTS.md";
+        readonly secondaryFiles: readonly [".opencode/AGENTS.md", ".opencode/agents/neocortex-root.md", ".opencode/agents/neocortex.md", ".agent/skills/neocortex/SKILL.md"];
+        readonly ownedBlockName: "NEOCORTEX-MEMORY";
+        readonly templateKind: "agents-md";
+        readonly budget: {
+            readonly maxLines: 220;
+            readonly maxBytes: 18000;
+        };
+        readonly linkRequirement: {
+            readonly canonicalSource: "NEOCORTEX.md";
+            readonly semanticFileRequired: true;
+            readonly symlinkBacked: true;
+            readonly wrapperAllowed: false;
+            readonly includeFallbackAllowed: false;
+            readonly requiresWrapperPreservation: false;
+            readonly fallbackIsCompatibilityRemediation: true;
+            readonly policy: "mandatory-semantic-symlink";
+            readonly notes: "Semantic platform memory file must resolve to NEOCORTEX.md through a symlink; do not replace it with an unrelated wrapper or copied frontmatter.";
+        };
+        readonly bidirectionalReference: ProjectMemoryBidirectionalReference;
+        readonly requiresWrapperPreservation: true;
+        readonly notes: "OpenCode agent memory. It consumes AGENTS.md-compatible instructions and must resolve to canonical NEOCORTEX.md.";
+    };
+    readonly openclaw: {
+        readonly targetId: "openclaw";
+        readonly platformName: "OpenClaw";
+        readonly canonicalSource: "NEOCORTEX.md";
+        readonly primaryFile: ".openclaw/skills/neocortex/SKILL.md";
+        readonly secondaryFiles: readonly ["~/.openclaw/skills/neocortex/SKILL.md"];
+        readonly ownedBlockName: "NEOCORTEX-MEMORY";
+        readonly templateKind: "agents-md";
+        readonly budget: {
+            readonly maxLines: 220;
+            readonly maxBytes: 18000;
+        };
+        readonly linkRequirement: {
+            readonly canonicalSource: "NEOCORTEX.md";
+            readonly semanticFileRequired: true;
+            readonly symlinkBacked: true;
+            readonly wrapperAllowed: true;
+            readonly includeFallbackAllowed: true;
+            readonly requiresWrapperPreservation: true;
+            readonly fallbackIsCompatibilityRemediation: true;
+            readonly policy: "safe-include-fallback";
+            readonly notes: "Use a safe include/import only for platforms that cannot consume symlinks directly; the include must resolve back to NEOCORTEX.md.";
+        };
+        readonly bidirectionalReference: ProjectMemoryBidirectionalReference;
+        readonly requiresWrapperPreservation: true;
+        readonly notes: "OpenClaw Skill thin-client memory entrypoint. Use the project Skill path when --create-project is requested; do not mutate ~/.openclaw/openclaw.json, and keep memory content public-safe.";
+    };
+    readonly kimi: {
+        readonly targetId: "kimi";
+        readonly platformName: "Kimi";
+        readonly canonicalSource: "NEOCORTEX.md";
+        readonly primaryFile: "KIMI.md";
+        readonly secondaryFiles: readonly ["AGENTS.md", ".kimi/skills/neocortex/SKILL.md"];
+        readonly ownedBlockName: "NEOCORTEX-MEMORY";
+        readonly templateKind: "agents-md";
+        readonly budget: {
+            readonly maxLines: 220;
+            readonly maxBytes: 18000;
+        };
+        readonly linkRequirement: {
+            readonly canonicalSource: "NEOCORTEX.md";
+            readonly semanticFileRequired: true;
+            readonly symlinkBacked: true;
+            readonly wrapperAllowed: true;
+            readonly includeFallbackAllowed: true;
+            readonly requiresWrapperPreservation: true;
+            readonly fallbackIsCompatibilityRemediation: true;
+            readonly policy: "safe-include-fallback";
+            readonly notes: "Use a safe include/import only for platforms that cannot consume symlinks directly; the include must resolve back to NEOCORTEX.md.";
+        };
+        readonly bidirectionalReference: ProjectMemoryBidirectionalReference;
+        readonly requiresWrapperPreservation: true;
+        readonly notes: "Kimi memory entrypoint. Prefer a symlink to NEOCORTEX.md; use a compact include only if the host cannot follow symlinks.";
+    };
+    readonly 'github-copilot-cli': {
+        readonly targetId: "github-copilot-cli";
+        readonly platformName: "GitHub Copilot CLI / gh alias";
+        readonly canonicalSource: "NEOCORTEX.md";
+        readonly primaryFile: ".github/copilot-instructions.md";
+        readonly secondaryFiles: readonly ["AGENTS.md"];
+        readonly ownedBlockName: "NEOCORTEX-MEMORY";
+        readonly templateKind: "copilot-instructions";
+        readonly budget: {
+            readonly maxLines: 180;
+            readonly maxBytes: 14000;
+        };
+        readonly linkRequirement: {
+            readonly canonicalSource: "NEOCORTEX.md";
+            readonly semanticFileRequired: true;
+            readonly symlinkBacked: true;
+            readonly wrapperAllowed: true;
+            readonly includeFallbackAllowed: true;
+            readonly requiresWrapperPreservation: true;
+            readonly fallbackIsCompatibilityRemediation: true;
+            readonly policy: "safe-include-fallback";
+            readonly notes: "Use a safe include/import only for platforms that cannot consume symlinks directly; the include must resolve back to NEOCORTEX.md.";
+        };
+        readonly bidirectionalReference: ProjectMemoryBidirectionalReference;
+        readonly requiresWrapperPreservation: true;
+        readonly notes: "GitHub Copilot CLI or gh alias instructions. Resolve compact memory back to NEOCORTEX.md without copying private prompt bodies.";
+    };
+};
+export declare function getProjectMemoryTarget(targetId: ProjectMemoryTargetId): ProjectMemoryTarget;
+export declare function isProjectMemoryTargetId(value: string): value is ProjectMemoryTargetId;
+export declare function listProjectMemoryTargets(): readonly ProjectMemoryTarget[];
+export declare function renderArchitectureReferenceTable(references: readonly ArchitectureReference[]): string;

package/packages/client/dist/memory/shared-project-memory-types.js

@@ -0,0 +1,2 @@
+const e="NEOCORTEX.md",r={canonicalSource:e,semanticFileRequired:!0,symlinkBacked:!0,wrapperAllowed:!1,includeFallbackAllowed:!1,requiresWrapperPreservation:!1,fallbackIsCompatibilityRemediation:!0,policy:"mandatory-semantic-symlink",notes:"Semantic platform memory file must resolve to NEOCORTEX.md through a symlink; do not replace it with an unrelated wrapper or copied frontmatter."},c={canonicalSource:e,semanticFileRequired:!0,symlinkBacked:!0,wrapperAllowed:!0,includeFallbackAllowed:!1,requiresWrapperPreservation:!0,fallbackIsCompatibilityRemediation:!0,policy:"symlink-backed-wrapper",notes:"Platform wrapper/frontmatter is allowed only when the semantic memory payload remains symlink-backed by NEOCORTEX.md."},a={canonicalSource:e,semanticFileRequired:!0,symlinkBacked:!0,wrapperAllowed:!0,includeFallbackAllowed:!0,requiresWrapperPreservation:!0,fallbackIsCompatibilityRemediation:!0,policy:"safe-include-fallback",notes:"Use a safe include/import only for platforms that cannot consume symlinks directly; the include must resolve back to NEOCORTEX.md."};function t(o){return{canonicalSource:e,resolvesVia:o.policy,feedbackTrigger:"*update-memory",guidance:"Treat NEOCORTEX.md as canonical project memory; consult it before platform-specific memory, and run *update-memory when durable project context changes should flow back to the canonical source."}}const l=["claude-code","codex","gemini-cli","antigravity","vscode","cursor","opencode","openclaw","kimi","github-copilot-cli"],s={canonical:{targetId:"canonical",platformName:"Neocortex Canonical Memory",canonicalSource:e,primaryFile:e,secondaryFiles:["AGENTS.md","CLAUDE.md","GEMINI.md"],ownedBlockName:"NEOCORTEX-MEMORY",templateKind:"neocortex-md",budget:{maxLines:220,maxBytes:18e3},linkRequirement:r,bidirectionalReference:t(r),requiresWrapperPreservation:!1,notes:"Canonical compact project memory source for platform symlinks and wrappers. Store only summaries, indexes, and links to architecture docs here."},"claude-code":{targetId:"claude-code",platformName:"Claude Code",canonicalSource:e,primaryFile:"CLAUDE.md",secondaryFiles:[".claude/agents/neocortex.md"],ownedBlockName:"NEOCORTEX-MEMORY",templateKind:"claude-md",budget:{maxLines:320,maxBytes:28e3},linkRequirement:r,bidirectionalReference:t(r),requiresWrapperPreservation:!1,notes:"Claude Code project memory. Resolve to NEOCORTEX.md; keep root content concise and link deeper docs with @path references."},codex:{targetId:"codex",platformName:"Codex CLI",canonicalSource:e,primaryFile:"AGENTS.md",secondaryFiles:[".codex/agents/neocortex.toml"],ownedBlockName:"NEOCORTEX-MEMORY",templateKind:"agents-md",budget:{maxLines:220,maxBytes:18e3},linkRequirement:r,bidirectionalReference:t(r),requiresWrapperPreservation:!0,notes:"Codex root instructions. Uppercase AGENTS.md is required on case-sensitive filesystems."},"gemini-cli":{targetId:"gemini-cli",platformName:"Gemini CLI",canonicalSource:e,primaryFile:"GEMINI.md",secondaryFiles:[".gemini/agents/neocortex.md"],ownedBlockName:"NEOCORTEX-MEMORY",templateKind:"gemini-md",budget:{maxLines:260,maxBytes:22e3},linkRequirement:r,bidirectionalReference:t(r),requiresWrapperPreservation:!1,notes:"Gemini CLI context file. Prefer shallow @file.md imports for detailed architecture docs."},antigravity:{targetId:"antigravity",platformName:"Antigravity",canonicalSource:e,primaryFile:"GEMINI.md",secondaryFiles:[".gemini/agents/neocortex.md"],ownedBlockName:"NEOCORTEX-MEMORY",templateKind:"gemini-md",budget:{maxLines:260,maxBytes:22e3},linkRequirement:r,bidirectionalReference:t(r),requiresWrapperPreservation:!1,notes:"Antigravity currently shares GEMINI.md behavior with the Gemini target stubs."},vscode:{targetId:"vscode",platformName:"VS Code / GitHub Copilot",canonicalSource:e,primaryFile:".github/copilot-instructions.md",secondaryFiles:[".github/instructions/neocortex.instructions.md",".github/agents/neocortex.agent.md"],ownedBlockName:"NEOCORTEX-MEMORY",templateKind:"copilot-instructions",budget:{maxLines:180,maxBytes:14e3},linkRequirement:c,bidirectionalReference:t(c),requiresWrapperPreservation:!0,notes:"VS Code and GitHub Copilot always-on repository instructions."},cursor:{targetId:"cursor",platformName:"Cursor",canonicalSource:e,primaryFile:".cursor/rules/neocortex.mdc",secondaryFiles:["AGENTS.md"],ownedBlockName:"NEOCORTEX-MEMORY",templateKind:"cursor-rule",budget:{maxLines:180,maxBytes:14e3},linkRequirement:c,bidirectionalReference:t(c),requiresWrapperPreservation:!0,notes:"Cursor rule memory. Use AGENTS.md as compatibility fallback when Cursor rules are absent."},opencode:{targetId:"opencode",platformName:"OpenCode",canonicalSource:e,primaryFile:"AGENTS.md",secondaryFiles:[".opencode/AGENTS.md",".opencode/agents/neocortex-root.md",".opencode/agents/neocortex.md",".agent/skills/neocortex/SKILL.md"],ownedBlockName:"NEOCORTEX-MEMORY",templateKind:"agents-md",budget:{maxLines:220,maxBytes:18e3},linkRequirement:r,bidirectionalReference:t(r),requiresWrapperPreservation:!0,notes:"OpenCode agent memory. It consumes AGENTS.md-compatible instructions and must resolve to canonical NEOCORTEX.md."},openclaw:{targetId:"openclaw",platformName:"OpenClaw",canonicalSource:e,primaryFile:".openclaw/skills/neocortex/SKILL.md",secondaryFiles:["~/.openclaw/skills/neocortex/SKILL.md"],ownedBlockName:"NEOCORTEX-MEMORY",templateKind:"agents-md",budget:{maxLines:220,maxBytes:18e3},linkRequirement:a,bidirectionalReference:t(a),requiresWrapperPreservation:!0,notes:"OpenClaw Skill thin-client memory entrypoint. Use the project Skill path when --create-project is requested; do not mutate ~/.openclaw/openclaw.json, and keep memory content public-safe."},kimi:{targetId:"kimi",platformName:"Kimi",canonicalSource:e,primaryFile:"KIMI.md",secondaryFiles:["AGENTS.md",".kimi/skills/neocortex/SKILL.md"],ownedBlockName:"NEOCORTEX-MEMORY",templateKind:"agents-md",budget:{maxLines:220,maxBytes:18e3},linkRequirement:a,bidirectionalReference:t(a),requiresWrapperPreservation:!0,notes:"Kimi memory entrypoint. Prefer a symlink to NEOCORTEX.md; use a compact include only if the host cannot follow symlinks."},"github-copilot-cli":{targetId:"github-copilot-cli",platformName:"GitHub Copilot CLI / gh alias",canonicalSource:e,primaryFile:".github/copilot-instructions.md",secondaryFiles:["AGENTS.md"],ownedBlockName:"NEOCORTEX-MEMORY",templateKind:"copilot-instructions",budget:{maxLines:180,maxBytes:14e3},linkRequirement:a,bidirectionalReference:t(a),requiresWrapperPreservation:!0,notes:"GitHub Copilot CLI or gh alias instructions. Resolve compact memory back to NEOCORTEX.md without copying private prompt bodies."}};function d(o){return s[o]}function p(o){return o==="canonical"||l.includes(o)}function u(){return l.map(o=>s[o])}function y(o){const n=i=>i.replace(/\|/g,"\\|").replace(/\n/g," ");return["| Path | Title | Purpose | Suggested Usage |","| --- | --- | --- | --- |",...o.map(i=>`| ${n(i.path)} | ${n(i.title)} | ${n(i.purpose)} | ${n(i.suggestedUsage)} |`)].join(`
+`)}export{e as CANONICAL_PROJECT_MEMORY_SOURCE,s as PROJECT_MEMORY_TARGETS,l as PROJECT_MEMORY_TARGET_IDS,d as getProjectMemoryTarget,p as isProjectMemoryTargetId,u as listProjectMemoryTargets,y as renderArchitectureReferenceTable};

package/packages/client/dist/policy/architecture-policy.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @license FSL-1.1
+ * Copyright (c) 2026 OrNexus AI
+ *
+ * This file is part of Neocortex CLI, licensed under the
+ * Functional Source License, Version 1.1 (FSL-1.1).
+ *
+ * Change Date: February 20, 2029
+ * Change License: MIT
+ *
+ * See the LICENSE file in the project root for full license text.
+ */
+import type { ArchitecturePolicy, ArchitecturePolicyValidationResult } from './shared-policy-types.js';
+/**
+ * Relative path from project root to consumer policy file.
+ * Consumer copies `architecture-policy.template.json` (from repo root) to
+ * this path and edits.
+ */
+export declare const POLICY_FILE_PATH = ".neocortex/architecture-policy.json";
+/**
+ * Pure function validator. Zero I/O. Deterministic.
+ *
+ * Returns `ArchitecturePolicyValidationResult` with:
+ * - `valid: true` iff all required fields correct and no hard errors
+ * - `errors`: hard failures (schema version mismatch, bad mode, type errors)
+ * - `warnings`: soft issues (unknown optional fields -- forward-compat)
+ */
+export declare function validatePolicy(candidate: unknown): ArchitecturePolicyValidationResult;
+/**
+ * Async reader. NEVER throws.
+ *
+ * Returns `undefined` when:
+ * - file does not exist (ENOENT; silent, expected default)
+ * - permission denied (EACCES; warns stderr)
+ * - malformed JSON (warns stderr with path)
+ * - schema invalid (warns stderr with error list)
+ *
+ * Returns typed `ArchitecturePolicy` on full success.
+ */
+export declare function readArchitecturePolicy(projectRoot: string): Promise<ArchitecturePolicy | undefined>;

package/packages/client/dist/policy/architecture-policy.js

@@ -0,0 +1,2 @@
+import{readFile as u}from"node:fs/promises";import{join as d}from"node:path";const p=".neocortex/architecture-policy.json",f=Object.freeze(["interactive","yoloop_friendly","fully_automated"]),y=Object.freeze(["aws","gcp","oci","azure","any"]),_=Object.freeze(["REST","GraphQL","tRPC"]),g=Object.freeze(["sync","async","hybrid"]),m=Object.freeze(["mobile-first","desktop-first","responsive"]),O=Object.freeze(["conservative","balanced","aggressive"]),b=Object.freeze(["TDD","test-after","BDD"]),h=new Set(["primary_persona","cloud_provider","api_style","integration_style","ui_priority","refactor_aggressiveness","test_workflow"]);function v(n){const r=[],o=[];if(typeof n!="object"||n===null||Array.isArray(n))return{valid:!1,errors:Object.freeze(["Policy must be a plain object"]),warnings:Object.freeze([])};const t=n;if(t.schema_version!==1&&r.push(`schema_version must be 1, got ${JSON.stringify(t.schema_version)}`),(typeof t.mode!="string"||!f.includes(t.mode))&&r.push(`mode must be one of [${f.join(", ")}], got ${JSON.stringify(t.mode)}`),t.defaults!==void 0&&t.defaults!==null)if(typeof t.defaults!="object"||Array.isArray(t.defaults))r.push("defaults must be an object");else{const e=t.defaults;for(const c of Object.keys(e))h.has(c)||o.push(`defaults.${c}: unknown field (ignored)`);e.primary_persona!==void 0&&e.primary_persona!==null&&typeof e.primary_persona!="string"&&r.push("defaults.primary_persona must be string or null"),i(e,"cloud_provider",y,r),i(e,"api_style",_,r),i(e,"integration_style",g,r),i(e,"ui_priority",m,r),i(e,"refactor_aggressiveness",O,r),i(e,"test_workflow",b,r)}return t.preserved_interactions!==void 0&&t.preserved_interactions!==null&&(!Array.isArray(t.preserved_interactions)||!t.preserved_interactions.every(e=>typeof e=="string"))&&r.push("preserved_interactions must be array of strings"),{valid:r.length===0,errors:Object.freeze(r),warnings:Object.freeze(o)}}async function A(n){const r=d(n,p);let o;try{o=await u(r,"utf8")}catch(s){if(s.code==="ENOENT")return;const l=s.message??String(s);console.warn(`[Neocortex] architecture-policy read failed (${r}): ${l}`);return}const t=o.replace(/^/,"").replace(/\r\n/g,`
+`);let e;try{e=JSON.parse(t)}catch(s){const a=s.message??String(s);console.warn(`[Neocortex] architecture-policy malformed JSON (${r}): ${a}. Proceeding without policy.`);return}const c=v(e);if(!c.valid){console.warn(`[Neocortex] architecture-policy schema invalid (${r}): ${c.errors.join("; ")}. Proceeding without policy.`);return}return e}function i(n,r,o,t){const e=n[r];e!=null&&(typeof e!="string"||!o.includes(e))&&t.push(`defaults.${r} must be one of [${o.join(", ")}] or null, got ${JSON.stringify(e)}`)}export{p as POLICY_FILE_PATH,A as readArchitecturePolicy,v as validatePolicy};

package/packages/client/dist/policy/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license FSL-1.1
+ * Copyright (c) 2026 OrNexus AI
+ *
+ * Barrel export for Epic P107.02 policy reader module.
+ */
+export { readArchitecturePolicy, validatePolicy, POLICY_FILE_PATH, } from './architecture-policy.js';
+export type { ArchitecturePolicy, ArchitectureDefaults, ArchitecturePolicyValidationResult, PolicyMode, } from './shared-policy-types.js';

package/packages/client/dist/policy/index.js

@@ -0,0 +1 @@
+import{readArchitecturePolicy as c,validatePolicy as i,POLICY_FILE_PATH as o}from"./architecture-policy.js";export{o as POLICY_FILE_PATH,c as readArchitecturePolicy,i as validatePolicy};

package/packages/client/dist/policy/shared-policy-types.d.ts

@@ -0,0 +1,89 @@
+/**
+ * P119.02: Inlined byte-identical types from
+ * `@neocortex/shared/types/architecture-policy`.
+ *
+ * SSoT-Shadow pattern (P92.01 server precedent extended by P117.01 to client
+ * checkpoint dist + P117.07 to client yoloop dist). Client tarball is published
+ * standalone via `@ornexus/neocortex` and does NOT include `@neocortex/shared`
+ * as a runtime dependency (workspace package, excluded from tarball per
+ * `.npmignore` + `tsconfig.build.json`). Any non-erased import of
+ * `@neocortex/shared` in `packages/client/dist/**` causes runtime
+ * `ERR_MODULE_NOT_FOUND` on globally installed `@ornexus/neocortex`.
+ *
+ * Pre-P119.02, three files leaked `import type` statements from
+ * `@neocortex/shared` in the published v4.19.1 tarball:
+ *   - dist/policy/architecture-policy.d.ts
+ *   - dist/policy/index.d.ts
+ *   - dist/commands/invoke.d.ts (imported `YoloopPersistedState`)
+ *
+ * Type-only `import type` is erased at runtime (no module resolution attempt),
+ * but produces TS2307 in consumer projects that try to use the types via
+ * globally-installed CLI (`npm install -g @ornexus/neocortex`).
+ *
+ * Sync responsibility: `policy-shared-sync.test.ts` (client-side drift test,
+ * mirror of `checkpoint-shared-sync.test.ts` P117.01). Drift test fails CI
+ * if these diverge from SSoT canonical at
+ * `packages/shared/src/types/architecture-policy.ts`.
+ *
+ * Defense-in-depth: `validate-pre-publish.js` ships
+ * `validateClientNoSharedImport()` (P117.01) scanning client dist for
+ * `@neocortex/shared` runtime references. P119.02 expands its scope to also
+ * walk `dist/policy/` and `dist/commands/` (in addition to checkpoint + yoloop
+ * coverage from P117).
+ *
+ * DO NOT EDIT WITHOUT also editing
+ * `packages/shared/src/types/architecture-policy.ts`.
+ */
+/**
+ * Policy mode controls how server-side injector treats consumer defaults.
+ *
+ * - `interactive`: Ask user on every decision (pre-P107 behavior, backward compat).
+ * - `yoloop_friendly`: Apply `defaults.*` when set + log audit entry (P107.05).
+ * - `fully_automated`: Apply `defaults.*` silently; still preserves `preserved_interactions`.
+ */
+export type PolicyMode = 'interactive' | 'yoloop_friendly' | 'fully_automated';
+/**
+ * Optional default values that drive step prompt behavior.
+ * All fields are optional -- unset fields fall back to interactive questions.
+ * Each field maps to a specific stepId via `POLICY_FIELD_BY_STEP` (server-side).
+ */
+export interface ArchitectureDefaults {
+    /** For step-a-01 PRD generation. Free-form string (e.g. "B2B SaaS buyer"). */
+    readonly primary_persona?: string;
+    /** For step-a-02 architecture choices. */
+    readonly cloud_provider?: 'aws' | 'gcp' | 'oci' | 'azure' | 'any';
+    /** For step-a-03 api-contracts. */
+    readonly api_style?: 'REST' | 'GraphQL' | 'tRPC';
+    /** For step-a-04 api-integrations. */
+    readonly integration_style?: 'sync' | 'async' | 'hybrid';
+    /** For step-a-08 ux-design. */
+    readonly ui_priority?: 'mobile-first' | 'desktop-first' | 'responsive';
+    /** For step-r-03 refactor-plan. */
+    readonly refactor_aggressiveness?: 'conservative' | 'balanced' | 'aggressive';
+    /** For step-c-04 write-spec. */
+    readonly test_workflow?: 'TDD' | 'test-after' | 'BDD';
+}
+/**
+ * Top-level policy shape persisted in `.neocortex/architecture-policy.json`.
+ * Consumer copies `architecture-policy.template.json` from repo root and edits.
+ */
+export interface ArchitecturePolicy {
+    /** Wire-format version. Must be literal 1 in v1. */
+    readonly schema_version: 1;
+    readonly mode: PolicyMode;
+    readonly defaults?: ArchitectureDefaults;
+    /**
+     * stepIds that ALWAYS require human interaction, regardless of mode.
+     * Defaults to `ARCHITECTURE_POLICY_DEFAULT_PRESERVED` if absent.
+     */
+    readonly preserved_interactions?: readonly string[];
+}
+/**
+ * Output of `validateArchitecturePolicy()` (server-side P107.03 exports validator).
+ * Fail-soft shape: validation errors NEVER throw; caller decides action.
+ */
+export interface ArchitecturePolicyValidationResult {
+    readonly valid: boolean;
+    readonly errors: readonly string[];
+    readonly warnings: readonly string[];
+}