@north-light/crouter 0.3.349 → 0.3.351

package/dist/commands/sys/sync-project-guidance.js

@@ -1,4 +1,4 @@
-var F=Object.defineProperty;var p=(e,t)=>F(e,"name",{value:t,configurable:!0});import{envProfileId as O}from"../../shared/env.js";import{existsSync as b,readdirSync as W,statSync as S}from"node:fs";import{basename as _,join as g,resolve as $}from"node:path";import{defineLeaf as z}from"../../core/command.js";import{parseFrontmatterGeneric as v}from"../../core/frontmatter.js";import{usage as w}from"../../core/errors.js";import{pathExists as E,readText as j,realpathOrSelf as y,walkFiles as A,writeText as U}from"../../core/fs-utils.js";import{loadProfileManifest as q}from"../../core/profiles/manifest.js";import{CRTR_DIR_NAME as k}from"../../types.js";import{memoryFilePath as J,serializeMemoryDoc as X}from"../memory/shared.js";import{normalizedName as B,routeFromDescription as K,scalarString as x}from"./sync-shared.js";import{deriveProjectNamespace as H}from"../../core/memory/project-namespace.js";import{associateRepository as C}from"../../core/memory/repository-association.js";import{openProjectMemoryStore as P}from"../../core/memory-resolver.js";import{composeCanonicalName as T,localNameFromPath as Q,resolveLocalName as V,validateExplicitLocalName as Y}from"../../core/memory/identity.js";const Z=new Set(["node_modules",".git",".venv","venv","dist","build",".next",".cache",".yalc",".sisyphus",k]),ee=["AGENTS.md","CLAUDE.md"];function te(e){if(e!==void 0)return[$(e)];const t=[$(process.cwd())],o=O();if(o!==void 0&&o!=="")try{const{manifest:a}=q(o);for(const r of a.projects){const n=$(r.path);t.includes(n)||t.push(n)}}catch{}return t}p(te,"projectDocRoots");function oe(e){const t=[];if(!b(e)||!S(e).isDirectory())return t;const o=$(e),a=[o];for(;a.length>0;){const r=a.pop();for(const i of ee){const d=g(r,i);if(b(d)&&S(d).isFile()){t.push({kind:"agents",path:d,sourceDir:r,walkRoot:o});break}}const n=g(r,".claude","rules");if(b(n))for(const i of A(n,d=>d.endsWith(".md")))t.push({kind:"rule",path:i,sourceDir:r,walkRoot:o});let c;try{c=W(r,{withFileTypes:!0})}catch{continue}for(const i of c)i.isDirectory()&&!Z.has(i.name)&&a.push(g(r,i.name))}return t}p(oe,"collectProjectDocCandidates");function N(e){for(const t of e.split(`
-`)){const o=t.replace(/^#+\s*/,"").replace(/\s+/g," ").trim();if(o!=="")return o.length>200?`${o.slice(0,197)}...`:o}return"Migrated project guidance."}p(N,"synthesizeShortForm");function L(e){const t=[];let o=0,a="";for(const r of e){if(r==="{"?o+=1:r==="}"&&(o=Math.max(0,o-1)),r===","&&o===0){t.push(a),a="";continue}a+=r}return t.push(a),t.map(r=>r.trim()).filter(r=>r!=="")}p(L,"splitTopLevelCommas");function re(e){return typeof e=="string"?L(e):Array.isArray(e)?e.filter(t=>typeof t=="string").flatMap(L):[]}p(re,"normalizeRulePaths");function ne(e,t,o,a){const r=C(e);let n;if(r.ok)n=r.association.repositoryRoot;else if(r.ok===!1&&r.code==="no-project-root")n=y(t);else{const s=r.ok===!1?r.reason:"unknown repository association failure";throw w(`cannot associate project guidance at ${e}: ${s}`,{next:`Run \`crtr sys migrate --dir ${e}\`.`})}n=y(n);const c=a.get(n);if(c!==void 0)return c;const i=P(n);if(i.mountStatus==="ready"){const u={namespace:i.repositoryNamespace??i.namespace,repositoryRoot:n,initialize:!1};return a.set(n,u),u}const d=g(n,k,"memory");if((E(d)?A(d,s=>s.endsWith(".md")):[]).length>0)throw w(`project memory store at ${d} is undeclared or invalid`,{next:`Run \`crtr sys migrate --dir ${n}\`.`});const f=H({ownerDir:n,rootBody:o.get(n)});if(f.ok===!1)throw w(`cannot initialize project memory store at ${d}: ${f.reason}`,{next:`Run \`crtr sys migrate --dir ${n}\`.`});const h={namespace:f.namespace,repositoryRoot:n,initialize:!0};return a.set(n,h),h}p(ne,"resolveRepositoryNamespace");function se(){return[{on:"workspace-open",at:"content"},{on:"read",match:"./**",at:"content"}]}p(se,"frontDoorSurfaces");function ae(e){const t=e.trim();return!t.includes("/")||t.startsWith("/")||t.startsWith("**")||t.startsWith("./")?t:`./${t}`}p(ae,"anchorReadGlob");function ie(e,t){const o=v(j(e.path)),a=y(e.sourceDir)===t.repositoryRoot;return M(e,t.namespace,o.body,a,o.data??{})}p(ie,"prepareAgentsCandidate");function ce(e){return Array.isArray(e.surfaces)?e.surfaces.filter(t=>{if(t===null||typeof t!="object"||Array.isArray(t))return!1;const o=t;if(o.on!=="read"||!["name","preview","content"].includes(String(o.at)))return!1;const a=o.match,r=typeof a=="string"?a.trim()!=="":Array.isArray(a)&&a.length>0&&a.every(c=>typeof c=="string"&&c.trim()!==""),n=o["match-frontmatter"];return r||n!==null&&typeof n=="object"&&!Array.isArray(n)}):[]}p(ce,"sourceReadRoute");function M(e,t,o,a,r={}){if(!a){const c=ce(r),i=x(r["when-and-why-to-read"])?.trim(),d={kind:"knowledge","when-and-why-to-read":i!==void 0&&i!==""?i:`When working under ${t}, this knowledge should be read because it carries the nested project guidance.`,"short-form":N(o),...c.length>0?{surfaces:c}:{}};return{candidate:e,name:"",target:g(e.sourceDir,k,"memory","INDEX.md"),frontmatter:d,body:o}}const n={kind:"knowledge",namespace:t,"when-and-why-to-read":`When working in ${t}, this knowledge should be read because it is the project's operating guide.`,"short-form":N(o),surfaces:se()};return{candidate:e,name:t,target:g(e.sourceDir,k,"memory","INDEX.md"),frontmatter:n,body:o}}p(M,"prepareRootCandidate");function de(e,t){const o=C(e.sourceDir);if(!o.ok)throw w(`cannot associate rule guidance at ${e.path}: ${o.reason}`,{next:`Run \`crtr sys migrate --dir ${e.sourceDir}\`.`});const a=T(t.namespace,o.association.ownerRelativePath),r=j(e.path),n=v(r),c=n.data??{},i=B(_(e.path)),d=Q(`${i}.md`),l=V(c,d),f=Y(l,a);if(f.ok===!1)throw w(`invalid local rule name in ${e.path}: ${f.reason}`);const h=x(c.description)??"",s=T(a,l),u={kind:"knowledge",name:l,"when-and-why-to-read":h!==""?K(h,"knowledge"):`When working under ${a}, this knowledge should be read because it is migrated project rule guidance.`,"short-form":h!==""?h.replace(/\s+/g," ").trim():N(n.body)},m=re(c.paths).map(ae);return u.surfaces=m.length>0?[{on:"read",match:m.length===1?m[0]:m,at:"content"}]:[{on:"read",match:"./**",at:"content"}],{candidate:e,name:s,target:J(g(e.sourceDir,k,"memory"),l),frontmatter:u,body:n.body}}p(de,"prepareRuleCandidate");function I(e,t){return E(e.target)&&!t.overwrite?{source:e.candidate.path,target:e.target,name:e.name,scope:"project",status:"skipped",reason:"target memory doc already exists; re-run with --overwrite to replace it"}:(t.dryRun||U(e.target,X(e.frontmatter,e.body)),{source:e.candidate.path,target:e.target,name:e.name,scope:"project",status:t.dryRun?"would-import":"imported"})}p(I,"convertProjectDoc");function ue(e,t){if(e.kind!=="agents")return;let o;try{o=v(j(e.path)).data?.namespace}catch{return}if(o===void 0)return;const a=y(e.sourceDir)===t.repositoryRoot,r=g(t.repositoryRoot,k,"memory","INDEX.md");if(!a)throw w(`project guidance at ${e.path} declares a namespace, but ${r} is the only declaration for this repository`,{next:`Run \`crtr sys migrate --dir ${t.repositoryRoot}\`.`});if(o!==t.namespace)throw w(`project guidance namespace ${JSON.stringify(o)} conflicts with the declared store namespace ${JSON.stringify(t.namespace)}`,{next:`Run \`crtr sys migrate --dir ${t.repositoryRoot}\` for a repository-wide identity change.`})}p(ue,"validateAuthoredNamespace");function pe(e){const t=e.filter(i=>i.status==="imported").length,o=e.filter(i=>i.status==="would-import").length,a=e.filter(i=>i.status==="skipped").length,r=o>0?`crtr sys sync project-guidance \u2014 dry run: ${o} would import, ${a} skipped`:`crtr sys sync project-guidance \u2014 ${t} imported, ${a} skipped`,n=e.map(i=>{const d=i.reason?` (${i.reason})`:"";return`| ${i.status} | ${i.scope}/${i.name||"\u2014"} | ${i.target} | ${i.source}${d} |`}),c=n.length===0?["No sync candidates."]:["| status | memory doc | target | source |","| --- | --- | --- | --- |",...n];return[r,"",...c].join(`
-`)}p(pe,"renderSummary");const Ee=z({name:"project-guidance",description:"migrate repository guidance into repository-root and nested crouter memory docs",whenToUse:"migrating repository CLAUDE.md/AGENTS.md/.claude/rules into the crouter memory-doc model: one-way copy into the repository root's or nested store's .crouter/memory/. Only the repository-root guide becomes the workspace front door; nested guides and rules keep read routes. Never exports memory docs back to these source files.",help:{name:"sys sync project-guidance",summary:"one-way migration: CLAUDE.md/AGENTS.md/.claude/rules \u2192 repository-root and nested crouter memory docs",params:[{kind:"flag",name:"source",type:"string",required:!1,constraint:"The root to walk recursively for CLAUDE.md/AGENTS.md/.claude/rules files. Default: cwd plus every project in the current profile's purview (when one is selected)."},{kind:"flag",name:"dry-run",type:"bool",required:!1,constraint:"Show what would be migrated without writing memory docs."},{kind:"flag",name:"overwrite",type:"bool",required:!1,constraint:"Replace an existing target memory doc. Default: skip existing docs to avoid clobbering user-authored memory."}],output:[{name:"results",type:"object[]",required:!0,constraint:"Each: {source,target,name,scope,status,reason?}; status is one of imported, skipped, would-import."}],outputKind:"object",effects:["Copies the repository-root CLAUDE.md/AGENTS.md into the repository-root .crouter/memory/INDEX.md with the namespace declaration and workspace front-door surfaces. Copies nested guides into nested .crouter/memory/INDEX.md files without namespace, name, or workspace-open metadata. Copies each .claude/rules/*.md into its nested store with a local name and a content read entry over the source paths (\u2018./\u2019-anchored when repo-relative), or a plain read route when no paths are declared. Originals are left untouched.","Skips existing memory docs unless --overwrite is present.","With --dry-run: read-only; writes nothing."]},run:p(async e=>{const t=e.source,o=e.dryRun??!1,a=e.overwrite??!1,r=[],n=new Set,c=[];for(const s of te(t))for(const u of oe(s))n.has(u.path)||(n.add(u.path),c.push(u));const i=new Map;for(const s of c)if(s.kind==="agents")try{i.set(y(s.sourceDir),v(j(s.path)).body)}catch{i.set(y(s.sourceDir),void 0)}const d=new Map,l=new Map;for(const s of c){const u=ne(s.sourceDir,s.walkRoot,i,d);l.set(s.path,u),ue(s,u)}const f=[];for(const s of c){const u=l.get(s.path);try{const m=s.kind==="agents"?ie(s,u):de(s,u);f.push({candidate:s,prepared:m})}catch(m){const R=(m instanceof Error?m.message:String(m)).split(`
-`)[0];r.push({source:s.path,target:"",name:"",scope:"project",status:"skipped",reason:`unparseable source frontmatter: ${R} \u2014 fix the source file and re-run`})}}for(const s of d.values()){if(c.some(D=>D.kind==="agents"&&l.get(D.path)?.repositoryRoot===s.repositoryRoot&&y(D.sourceDir)===s.repositoryRoot)||P(s.repositoryRoot).mountStatus==="ready")continue;const m=c.find(D=>l.get(D.path)?.repositoryRoot===s.repositoryRoot);if(m===void 0)continue;const R={...m,kind:"agents",sourceDir:s.repositoryRoot},G=M(R,s.namespace,"Migrated project guidance.",!0);r.push(I(G,{dryRun:o,overwrite:a}))}const h=[...f].sort((s,u)=>{const m=y(s.candidate.sourceDir)===l.get(s.candidate.path).repositoryRoot,R=y(u.candidate.sourceDir)===l.get(u.candidate.path).repositoryRoot;return Number(R)-Number(m)});for(const{prepared:s}of h)r.push(I(s,{dryRun:o,overwrite:a}));return{results:r}},"run"),render:p(e=>pe(e.results),"render")});export{Ee as sysSyncProjectGuidanceLeaf};
+var F=Object.defineProperty;var p=(e,t)=>F(e,"name",{value:t,configurable:!0});import{envProfileId as O}from"../../shared/env.js";import{existsSync as j,readdirSync as W,statSync as E}from"node:fs";import{basename as _,join as g,resolve as b}from"node:path";import{defineLeaf as z}from"../../core/command.js";import{parseFrontmatterGeneric as D}from"../../core/frontmatter.js";import{usage as w}from"../../core/errors.js";import{pathExists as N,readText as $,realpathOrSelf as y,walkFiles as A,writeText as U}from"../../core/fs-utils.js";import{loadProfileManifest as q}from"../../core/profiles/manifest.js";import{CRTR_DIR_NAME as k}from"../../types.js";import{memoryFilePath as J,serializeMemoryDoc as X}from"../../core/memory/mutation-domain.js";import{normalizedName as B,routeFromDescription as K,scalarString as x}from"./sync-shared.js";import{deriveProjectNamespace as H}from"../../core/memory/project-namespace.js";import{associateRepository as C}from"../../core/memory/repository-association.js";import{openProjectMemoryStore as P}from"../../core/memory-resolver.js";import{composeCanonicalName as T,localNameFromPath as Q,resolveLocalName as V,validateExplicitLocalName as Y}from"../../core/memory/identity.js";const Z=new Set(["node_modules",".git",".venv","venv","dist","build",".next",".cache",".yalc",".sisyphus",k]),ee=["AGENTS.md","CLAUDE.md"];function te(e){if(e!==void 0)return[b(e)];const t=[b(process.cwd())],o=O();if(o!==void 0&&o!=="")try{const{manifest:a}=q(o);for(const r of a.projects){const n=b(r.path);t.includes(n)||t.push(n)}}catch{}return t}p(te,"projectDocRoots");function oe(e){const t=[];if(!j(e)||!E(e).isDirectory())return t;const o=b(e),a=[o];for(;a.length>0;){const r=a.pop();for(const i of ee){const u=g(r,i);if(j(u)&&E(u).isFile()){t.push({kind:"agents",path:u,sourceDir:r,walkRoot:o});break}}const n=g(r,".claude","rules");if(j(n))for(const i of A(n,u=>u.endsWith(".md")))t.push({kind:"rule",path:i,sourceDir:r,walkRoot:o});let c;try{c=W(r,{withFileTypes:!0})}catch{continue}for(const i of c)i.isDirectory()&&!Z.has(i.name)&&a.push(g(r,i.name))}return t}p(oe,"collectProjectDocCandidates");function S(e){for(const t of e.split(`
+`)){const o=t.replace(/^#+\s*/,"").replace(/\s+/g," ").trim();if(o!=="")return o.length>200?`${o.slice(0,197)}...`:o}return"Migrated project guidance."}p(S,"synthesizeShortForm");function L(e){const t=[];let o=0,a="";for(const r of e){if(r==="{"?o+=1:r==="}"&&(o=Math.max(0,o-1)),r===","&&o===0){t.push(a),a="";continue}a+=r}return t.push(a),t.map(r=>r.trim()).filter(r=>r!=="")}p(L,"splitTopLevelCommas");function re(e){return typeof e=="string"?L(e):Array.isArray(e)?e.filter(t=>typeof t=="string").flatMap(L):[]}p(re,"normalizeRulePaths");function ne(e,t,o,a){const r=C(e);let n;if(r.ok)n=r.association.repositoryRoot;else if(r.ok===!1&&r.code==="no-project-root")n=y(t);else{const s=r.ok===!1?r.reason:"unknown repository association failure";throw w(`cannot associate project guidance at ${e}: ${s}`,{next:`Run \`crtr sys migrate --dir ${e}\`.`})}n=y(n);const c=a.get(n);if(c!==void 0)return c;const i=P(n);if(i.mountStatus==="ready"){const d={namespace:i.repositoryNamespace??i.namespace,repositoryRoot:n,initialize:!1};return a.set(n,d),d}const u=g(n,k,"memory");if((N(u)?A(u,s=>s.endsWith(".md")):[]).length>0)throw w(`project memory store at ${u} is undeclared or invalid`,{next:`Run \`crtr sys migrate --dir ${n}\`.`});const f=H({ownerDir:n,rootBody:o.get(n)});if(f.ok===!1)throw w(`cannot initialize project memory store at ${u}: ${f.reason}`,{next:`Run \`crtr sys migrate --dir ${n}\`.`});const h={namespace:f.namespace,repositoryRoot:n,initialize:!0};return a.set(n,h),h}p(ne,"resolveRepositoryNamespace");function se(){return[{on:"workspace-open",at:"content"},{on:"read",match:"./**",at:"content"}]}p(se,"frontDoorSurfaces");function ae(e){const t=e.trim();return!t.includes("/")||t.startsWith("/")||t.startsWith("**")||t.startsWith("./")?t:`./${t}`}p(ae,"anchorReadGlob");function ie(e,t){const o=D($(e.path)),a=y(e.sourceDir)===t.repositoryRoot;return M(e,t.namespace,o.body,a,o.data??{})}p(ie,"prepareAgentsCandidate");function ce(e){return Array.isArray(e.surfaces)?e.surfaces.filter(t=>{if(t===null||typeof t!="object"||Array.isArray(t))return!1;const o=t;if(o.on!=="read"||!["name","preview","content"].includes(String(o.at)))return!1;const a=o.match,r=typeof a=="string"?a.trim()!=="":Array.isArray(a)&&a.length>0&&a.every(c=>typeof c=="string"&&c.trim()!==""),n=o["match-frontmatter"];return r||n!==null&&typeof n=="object"&&!Array.isArray(n)}):[]}p(ce,"sourceReadRoute");function M(e,t,o,a,r={}){if(!a){const c=ce(r),i=x(r["when-and-why-to-read"])?.trim(),u={kind:"knowledge",privacy:"public","when-and-why-to-read":i!==void 0&&i!==""?i:`When working under ${t}, this knowledge should be read because it carries the nested project guidance.`,"short-form":S(o),...c.length>0?{surfaces:c}:{}};return{candidate:e,name:"",target:g(e.sourceDir,k,"memory","INDEX.md"),frontmatter:u,body:o}}const n={kind:"knowledge",privacy:"public",namespace:t,"when-and-why-to-read":`When working in ${t}, this knowledge should be read because it is the project's operating guide.`,"short-form":S(o),surfaces:se()};return{candidate:e,name:t,target:g(e.sourceDir,k,"memory","INDEX.md"),frontmatter:n,body:o}}p(M,"prepareRootCandidate");function ue(e,t){const o=C(e.sourceDir);if(!o.ok)throw w(`cannot associate rule guidance at ${e.path}: ${o.reason}`,{next:`Run \`crtr sys migrate --dir ${e.sourceDir}\`.`});const a=T(t.namespace,o.association.ownerRelativePath),r=$(e.path),n=D(r),c=n.data??{},i=B(_(e.path)),u=Q(`${i}.md`),l=V(c,u),f=Y(l,a);if(f.ok===!1)throw w(`invalid local rule name in ${e.path}: ${f.reason}`);const h=x(c.description)??"",s=T(a,l),d={kind:"knowledge",privacy:"public",name:l,"when-and-why-to-read":h!==""?K(h,"knowledge"):`When working under ${a}, this knowledge should be read because it is migrated project rule guidance.`,"short-form":h!==""?h.replace(/\s+/g," ").trim():S(n.body)},m=re(c.paths).map(ae);return d.surfaces=m.length>0?[{on:"read",match:m.length===1?m[0]:m,at:"content"}]:[{on:"read",match:"./**",at:"content"}],{candidate:e,name:s,target:J(g(e.sourceDir,k,"memory"),l),frontmatter:d,body:n.body}}p(ue,"prepareRuleCandidate");function I(e,t){if(N(e.target)&&!t.overwrite)return{source:e.candidate.path,target:e.target,name:e.name,scope:"project",status:"skipped",reason:"target memory doc already exists; re-run with --overwrite to replace it"};if(!t.dryRun){const o=N(e.target)?D($(e.target)).data?.privacy??"private":"public";U(e.target,X({...e.frontmatter,privacy:o},e.body))}return{source:e.candidate.path,target:e.target,name:e.name,scope:"project",status:t.dryRun?"would-import":"imported"}}p(I,"convertProjectDoc");function de(e,t){if(e.kind!=="agents")return;let o;try{o=D($(e.path)).data?.namespace}catch{return}if(o===void 0)return;const a=y(e.sourceDir)===t.repositoryRoot,r=g(t.repositoryRoot,k,"memory","INDEX.md");if(!a)throw w(`project guidance at ${e.path} declares a namespace, but ${r} is the only declaration for this repository`,{next:`Run \`crtr sys migrate --dir ${t.repositoryRoot}\`.`});if(o!==t.namespace)throw w(`project guidance namespace ${JSON.stringify(o)} conflicts with the declared store namespace ${JSON.stringify(t.namespace)}`,{next:`Run \`crtr sys migrate --dir ${t.repositoryRoot}\` for a repository-wide identity change.`})}p(de,"validateAuthoredNamespace");function pe(e){const t=e.filter(i=>i.status==="imported").length,o=e.filter(i=>i.status==="would-import").length,a=e.filter(i=>i.status==="skipped").length,r=o>0?`crtr sys sync project-guidance \u2014 dry run: ${o} would import, ${a} skipped`:`crtr sys sync project-guidance \u2014 ${t} imported, ${a} skipped`,n=e.map(i=>{const u=i.reason?` (${i.reason})`:"";return`| ${i.status} | ${i.scope}/${i.name||"\u2014"} | ${i.target} | ${i.source}${u} |`}),c=n.length===0?["No sync candidates."]:["| status | memory doc | target | source |","| --- | --- | --- | --- |",...n];return[r,"",...c].join(`
+`)}p(pe,"renderSummary");const Ee=z({name:"project-guidance",description:"migrate repository guidance into repository-root and nested crouter memory docs",whenToUse:"migrating repository CLAUDE.md/AGENTS.md/.claude/rules into the crouter memory-doc model: one-way copy into the repository root's or nested store's .crouter/memory/. Only the repository-root guide becomes the workspace front door; nested guides and rules keep read routes. Never exports memory docs back to these source files.",help:{name:"sys sync project-guidance",summary:"one-way migration: CLAUDE.md/AGENTS.md/.claude/rules \u2192 repository-root and nested crouter memory docs",params:[{kind:"flag",name:"source",type:"string",required:!1,constraint:"The root to walk recursively for CLAUDE.md/AGENTS.md/.claude/rules files. Default: cwd plus every project in the current profile's purview (when one is selected)."},{kind:"flag",name:"dry-run",type:"bool",required:!1,constraint:"Show what would be migrated without writing memory docs."},{kind:"flag",name:"overwrite",type:"bool",required:!1,constraint:"Replace an existing target memory doc. Default: skip existing docs to avoid clobbering user-authored memory."}],output:[{name:"results",type:"object[]",required:!0,constraint:"Each: {source,target,name,scope,status,reason?}; status is one of imported, skipped, would-import."}],outputKind:"object",effects:["Copies the repository-root CLAUDE.md/AGENTS.md into the repository-root .crouter/memory/INDEX.md with the namespace declaration and workspace front-door surfaces. Copies nested guides into nested .crouter/memory/INDEX.md files without namespace, name, or workspace-open metadata. Copies each .claude/rules/*.md into its nested store with a local name and a content read entry over the source paths (\u2018./\u2019-anchored when repo-relative), or a plain read route when no paths are declared. Originals are left untouched.","Skips existing memory docs unless --overwrite is present.","With --dry-run: read-only; writes nothing."]},run:p(async e=>{const t=e.source,o=e.dryRun??!1,a=e.overwrite??!1,r=[],n=new Set,c=[];for(const s of te(t))for(const d of oe(s))n.has(d.path)||(n.add(d.path),c.push(d));const i=new Map;for(const s of c)if(s.kind==="agents")try{i.set(y(s.sourceDir),D($(s.path)).body)}catch{i.set(y(s.sourceDir),void 0)}const u=new Map,l=new Map;for(const s of c){const d=ne(s.sourceDir,s.walkRoot,i,u);l.set(s.path,d),de(s,d)}const f=[];for(const s of c){const d=l.get(s.path);try{const m=s.kind==="agents"?ie(s,d):ue(s,d);f.push({candidate:s,prepared:m})}catch(m){const R=(m instanceof Error?m.message:String(m)).split(`
+`)[0];r.push({source:s.path,target:"",name:"",scope:"project",status:"skipped",reason:`unparseable source frontmatter: ${R} \u2014 fix the source file and re-run`})}}for(const s of u.values()){if(c.some(v=>v.kind==="agents"&&l.get(v.path)?.repositoryRoot===s.repositoryRoot&&y(v.sourceDir)===s.repositoryRoot)||P(s.repositoryRoot).mountStatus==="ready")continue;const m=c.find(v=>l.get(v.path)?.repositoryRoot===s.repositoryRoot);if(m===void 0)continue;const R={...m,kind:"agents",sourceDir:s.repositoryRoot},G=M(R,s.namespace,"Migrated project guidance.",!0);r.push(I(G,{dryRun:o,overwrite:a}))}const h=[...f].sort((s,d)=>{const m=y(s.candidate.sourceDir)===l.get(s.candidate.path).repositoryRoot,R=y(d.candidate.sourceDir)===l.get(d.candidate.path).repositoryRoot;return Number(R)-Number(m)});for(const{prepared:s}of h)r.push(I(s,{dryRun:o,overwrite:a}));return{results:r}},"run"),render:p(e=>pe(e.results),"render")});export{Ee as sysSyncProjectGuidanceLeaf};

package/dist/commands/sys/sync-skills.js

@@ -1,2 +1,2 @@
-var _=Object.defineProperty;var s=(e,o)=>_(e,"name",{value:o,configurable:!0});import{existsSync as $}from"node:fs";import{homedir as v}from"node:os";import{basename as j,dirname as h,join as g,relative as E,resolve as y,sep as C}from"node:path";import{defineLeaf as N}from"../../core/command.js";import{usage as I}from"../../core/errors.js";import{parseFrontmatterGeneric as q}from"../../core/frontmatter.js";import{pathExists as T,readJsonIfExists as M,readText as O,walkFiles as P,writeJson as D,writeText as W}from"../../core/fs-utils.js";import{composeCanonicalName as J}from"../../core/memory/identity.js";import{findProjectScopeRoot as G}from"../../core/scope.js";import{CRTR_DIR_NAME as z}from"../../types.js";import{memoryFilePath as H,requireMountedStore as U,resolveWriteSelector as B,serializeMemoryDoc as X}from"../memory/shared.js";import{normalizedName as R,routeFromDescription as Y,scalarString as x}from"./sync-shared.js";const Q="<!-- crtr-boot-skill v",L="SKILL.md",w="skill-import-ignore.json",V=new Set(["node_modules",".git",".venv","venv","dist","build",".next",".cache",".yalc",".sisyphus",z]);function Z(){const e=G();return e?h(e):null}s(Z,"projectDir");function k(){return g(v(),".crouter",w)}s(k,"ignoreFilePath");function ee(){const e=[{label:"claude-user",root:g(v(),".claude","skills"),defaultScope:"user"},{label:"pi-user",root:g(v(),".pi","agent","skills"),defaultScope:"user"}],o=Z();return o&&(e.push({label:"claude-project",root:g(o,".claude","skills"),defaultScope:"project"}),e.push({label:"pi-project",root:g(o,".pi","agent","skills"),defaultScope:"project"})),e}s(ee,"defaultSourceRoots");function te(e,o){if(e===void 0)return ee();const r=y(e);if(o!==void 0&&o!=="user"&&o!=="project")throw I(`invalid --scope: ${o} (expected user|project)`);return[{label:"source",root:r,defaultScope:o??"user"}]}s(te,"sourceRootsFromArg");function oe(e){const o=e.root;if(!$(o))return[];const r=y(o),t=[];if(j(r)===L)return t.push({path:r,root:h(r),source:e.label,defaultScope:e.defaultScope}),t;const i=g(r,L);if($(i))return t.push({path:i,root:h(r),source:e.label,defaultScope:e.defaultScope}),t;for(const a of P(r,c=>c===L,c=>V.has(c)))t.push({path:a,root:r,source:e.label,defaultScope:e.defaultScope});return t}s(oe,"collectCandidates");function re(e,o){const r=x(o?.name);if(r&&r.trim()!=="")return R(r);const t=E(e.root,h(e.path)).split(C).join("/");return R(t||j(h(e.path)))}s(re,"nameForCandidate");function ne(){const e=new Map;return o=>{const r=e.get(o);if(r!==void 0)return r;const{memoryDir:t,store:i}=B({scope:o});U(i);const a={memoryDir:t,namespace:i.namespace};return e.set(o,a),a}}s(ne,"storeResolver");function se(){let e;try{e=M(k())}catch(r){throw I(`invalid JSON in ${k()}: ${r instanceof Error?r.message:String(r)}`)}if(e===null)return{version:1,ignored:[]};if(typeof e!="object"||e===null||e.version!==1||!Array.isArray(e.ignored))throw I(`malformed ${k()}: expected {"version":1,"ignored":[...]}`);const o=[];for(const r of e.ignored){if(typeof r!="object"||r===null)continue;const t=r;typeof t.source=="string"&&typeof t.name=="string"&&(t.scope==="user"||t.scope==="project")&&typeof t.ignoredAt=="string"&&o.push({source:y(t.source),name:t.name,scope:t.scope,ignoredAt:t.ignoredAt})}return{version:1,ignored:o}}s(se,"readIgnoreState");function ie(e){D(k(),e)}s(ie,"writeIgnoreState");function K(e,o){const r=y(e.candidate.path);return o.ignored.some(t=>t.source===r||t.scope===e.scope&&t.name===e.name)}s(K,"isIgnored");function ae(e,o){return K(e,o)?!1:(o.ignored.push({source:y(e.candidate.path),name:e.name,scope:e.scope,ignoredAt:new Date().toISOString()}),o.ignored.sort((r,t)=>`${r.scope}/${r.name}`.localeCompare(`${t.scope}/${t.name}`)),!0)}s(ae,"rememberIgnored");function F(e,o,r){return{source:e.path,target:"",name:"",scope:o,status:"skipped",reason:r}}s(F,"skipResult");function ce(e,o,r){const t=O(e.path),i=r??e.defaultScope;if(t.includes(Q))return F(e,i,"legacy generated crtr boot skill is pruned by host exports, not imported");const a=q(t),c=a.data??{},u=c.kind==="preference"?"preference":"knowledge",d=re(e,c);if(d==="")return F(e,i,"could not derive memory document name");const m=o(i),n=H(m.memoryDir,d),p=J(m.namespace,d);return{candidate:e,raw:t,parsed:a,sourceFm:c,kind:u,name:p,scope:i,target:n}}s(ce,"prepareCandidate");function le(e,o){if(T(e.target)&&!o.overwrite)return{source:e.candidate.path,target:e.target,name:e.name,scope:e.scope,status:"skipped",reason:"target memory doc already exists; re-run with --overwrite to replace it"};const r=x(e.sourceFm.description)??"",t={...e.sourceFm};return delete t.name,delete t.description,delete t.type,delete t.keywords,delete t["system-prompt-visibility"],delete t["file-read-visibility"],delete t["applies-to"],delete t["read-when"],t.kind=e.kind,(typeof t["when-and-why-to-read"]!="string"||t["when-and-why-to-read"].trim()==="")&&(t["when-and-why-to-read"]=Y(r,e.kind)),(typeof t["short-form"]!="string"||t["short-form"].trim()==="")&&(t["short-form"]=r.replace(/\s+/g," ").trim()),Array.isArray(t.surfaces)||(t.surfaces=[{on:"boot",at:"preview"}]),o.dryRun||W(e.target,X(t,e.parsed.body)),{source:e.candidate.path,target:e.target,name:e.name,scope:e.scope,status:o.dryRun?"would-import":"imported"}}s(le,"convertPrepared");function A(e,o,r){return{source:e.candidate.path,target:e.target,name:e.name,scope:e.scope,status:r?"would-ignore":"ignored",reason:o}}s(A,"ignoreResult");function de(e,o){const r=e.filter(n=>n.status==="imported").length,t=e.filter(n=>n.status==="would-import").length,i=e.filter(n=>n.status==="skipped").length,a=e.filter(n=>n.status==="ignored").length,c=e.filter(n=>n.status==="would-ignore").length;let u;o?u=`crtr sys sync skills \u2014 ${c>0?`${c} would ignore`:`${a} ignored`}, ${i} skipped`:t>0?u=`crtr sys sync skills \u2014 dry run: ${t} would import, ${i} skipped, ${a} ignored`:u=`crtr sys sync skills \u2014 ${r} imported, ${i} skipped, ${a} ignored`;const d=e.map(n=>{const p=n.target||"\u2014",f=n.reason?` (${n.reason})`:"";return`| ${n.status} | ${n.scope}/${n.name||"\u2014"} | ${p} | ${n.source}${f} |`}),m=d.length===0?["No sync candidates."]:["| status | memory doc | target | source |","| --- | --- | --- | --- |",...d];return[u,"",...m].join(`
-`)}s(de,"renderSummary");const Le=N({name:"skills",description:"import host Agent Skill (SKILL.md) bundles as crouter memory docs",whenToUse:"migrating legacy host-native Agent Skill bundles (SKILL.md \u2014 Claude/pi user or project skill roots, or an explicit bundle/root via --source) into the crouter memory-doc model. One-way: crouter never re-exports memory docs back to SKILL.md, and stops reading the originals unconditionally once migrated.",help:{name:"sys sync skills",summary:"one-way import: host SKILL.md bundles \u2192 crouter memory docs",params:[{kind:"flag",name:"source",type:"string",required:!1,constraint:"A SKILL.md file, a single skill bundle dir containing SKILL.md, or a skills root to scan recursively. Default: the user/project Claude and pi skill roots that exist."},{kind:"flag",name:"scope",type:"enum",choices:["user","project"],required:!1,constraint:"Target memory scope for the selected sources. Default: user for user host roots and project for project host roots; an explicit value applies to every selected source. `project` writes into the nearest project store walking up from cwd, which must already declare its `namespace:` \u2014 this lane imports documents into a store, never the declaration itself."},{kind:"flag",name:"dry-run",type:"bool",required:!1,constraint:"Show what would be imported without writing memory docs."},{kind:"flag",name:"overwrite",type:"bool",required:!1,constraint:"Replace an existing target memory doc. Default: skip existing docs to avoid clobbering user-authored memory."},{kind:"flag",name:"ignore",type:"bool",required:!1,constraint:`Permanently ignore every selected SKILL.md source by recording it in ~/.crouter/${w}. Honors --source/--scope; with no --source, ignores every currently discovered default host skill candidate.`},{kind:"flag",name:"include-ignored",type:"bool",required:!1,constraint:"Include ignored candidates in the report without making sync read-only. Pair with --dry-run to audit the full candidate set without importing non-ignored skills."}],output:[{name:"results",type:"object[]",required:!0,constraint:"Each: {source,target,name,scope,status,reason?}; status is one of imported, skipped, would-import, ignored, would-ignore. `name` is the full canonical name the imported doc answers at \u2014 a user import\u2019s bundle name, a project import\u2019s `<namespace>/<bundle name>`."}],outputKind:"object",effects:["Writes memory/<bundle name>.md in the selected crouter scope with substrate frontmatter and the SKILL.md body. The file stays store-local; a project import answers at `<namespace>/<bundle name>`.","Refuses a project store that declares no namespace, naming the `crtr sys migrate --dir` (legacy store) or `crtr memory write <namespace> --dir` (empty store) remedy; it never declares one itself.","Skips existing memory docs unless --overwrite is present.","Skips marker-bearing generated crtr boot skills; host exports prune those legacy artifacts instead.",`With --ignore: writes ~/.crouter/${w} and does not import the selected sources.`,"With --dry-run: read-only; writes nothing."]},run:s(async e=>{const o=e.source,r=e.scope,t=e.dryRun??!1,i=e.overwrite??!1,a=e.ignore??!1,c=e.includeIgnored??!1,u=te(o,r),d=new Set,m=[];for(const b of u)for(const l of oe(b))d.has(l.path)||(d.add(l.path),m.push(l));const n=ne(),p=se(),f=[];let S=!1;for(const b of m){const l=ce(b,n,r);if("status"in l){f.push(l);continue}if(a){t||(S=ae(l,p)||S),f.push(A(l,t?"would record permanent ignore":`recorded in ~/.crouter/${w}`,t));continue}if(K(l,p)){c&&f.push(A(l,`matched ~/.crouter/${w}`,!1));continue}f.push(le(l,{dryRun:t,overwrite:i}))}return S&&ie(p),{results:f,ignoreFile:k(),ignoreMode:a}},"run"),render:s(e=>de(e.results,e.ignoreMode===!0),"render")});export{Le as sysSyncSkillsLeaf};
+var C=Object.defineProperty;var s=(e,o)=>C(e,"name",{value:o,configurable:!0});import{existsSync as L}from"node:fs";import{homedir as N}from"node:os";import{basename as $,dirname as h,join as g,relative as q,resolve as y,sep as T}from"node:path";import{defineLeaf as D}from"../../core/command.js";import{usage as v}from"../../core/errors.js";import{parseFrontmatterGeneric as j}from"../../core/frontmatter.js";import{pathExists as R,readJsonIfExists as M,readText as x,walkFiles as O,writeJson as P,writeText as W}from"../../core/fs-utils.js";import{composeCanonicalName as J}from"../../core/memory/identity.js";import{findProjectScopeRoot as G}from"../../core/scope.js";import{runtimeRoot as z}from"../../core/layout.js";import{piAgentDir as H}from"../../core/runtime/package-health.js";import{CRTR_DIR_NAME as U}from"../../types.js";import{memoryFilePath as B,requireMountedStore as X,serializeMemoryDoc as Y}from"../../core/memory/mutation-domain.js";import{resolveWriteSelector as Q}from"../../core/memory/cli-selector.js";import{normalizedName as K,routeFromDescription as V,scalarString as A}from"./sync-shared.js";const Z="<!-- crtr-boot-skill v",I="SKILL.md",w="skill-import-ignore.json",ee=new Set(["node_modules",".git",".venv","venv","dist","build",".next",".cache",".yalc",".sisyphus",U]);function te(){const e=G();return e?h(e):null}s(te,"projectDir");function k(){return g(z(),w)}s(k,"ignoreFilePath");function oe(){const e=[{label:"claude-user",root:g(N(),".claude","skills"),defaultScope:"user"},{label:"pi-user",root:g(H(),"skills"),defaultScope:"user"}],o=te();return o&&(e.push({label:"claude-project",root:g(o,".claude","skills"),defaultScope:"project"}),e.push({label:"pi-project",root:g(o,".pi","agent","skills"),defaultScope:"project"})),e}s(oe,"defaultSourceRoots");function re(e,o){if(e===void 0)return oe();const r=y(e);if(o!==void 0&&o!=="user"&&o!=="project")throw v(`invalid --scope: ${o} (expected user|project)`);return[{label:"source",root:r,defaultScope:o??"user"}]}s(re,"sourceRootsFromArg");function ne(e){const o=e.root;if(!L(o))return[];const r=y(o),t=[];if($(r)===I)return t.push({path:r,root:h(r),source:e.label,defaultScope:e.defaultScope}),t;const i=g(r,I);if(L(i))return t.push({path:i,root:h(r),source:e.label,defaultScope:e.defaultScope}),t;for(const a of O(r,c=>c===I,c=>ee.has(c)))t.push({path:a,root:r,source:e.label,defaultScope:e.defaultScope});return t}s(ne,"collectCandidates");function se(e,o){const r=A(o?.name);if(r&&r.trim()!=="")return K(r);const t=q(e.root,h(e.path)).split(T).join("/");return K(t||$(h(e.path)))}s(se,"nameForCandidate");function ie(){const e=new Map;return o=>{const r=e.get(o);if(r!==void 0)return r;const{memoryDir:t,store:i}=Q({scope:o});X(i);const a={memoryDir:t,namespace:i.namespace};return e.set(o,a),a}}s(ie,"storeResolver");function ae(){let e;try{e=M(k())}catch(r){throw v(`invalid JSON in ${k()}: ${r instanceof Error?r.message:String(r)}`)}if(e===null)return{version:1,ignored:[]};if(typeof e!="object"||e===null||e.version!==1||!Array.isArray(e.ignored))throw v(`malformed ${k()}: expected {"version":1,"ignored":[...]}`);const o=[];for(const r of e.ignored){if(typeof r!="object"||r===null)continue;const t=r;typeof t.source=="string"&&typeof t.name=="string"&&(t.scope==="user"||t.scope==="project")&&typeof t.ignoredAt=="string"&&o.push({source:y(t.source),name:t.name,scope:t.scope,ignoredAt:t.ignoredAt})}return{version:1,ignored:o}}s(ae,"readIgnoreState");function ce(e){P(k(),e)}s(ce,"writeIgnoreState");function F(e,o){const r=y(e.candidate.path);return o.ignored.some(t=>t.source===r||t.scope===e.scope&&t.name===e.name)}s(F,"isIgnored");function le(e,o){return F(e,o)?!1:(o.ignored.push({source:y(e.candidate.path),name:e.name,scope:e.scope,ignoredAt:new Date().toISOString()}),o.ignored.sort((r,t)=>`${r.scope}/${r.name}`.localeCompare(`${t.scope}/${t.name}`)),!0)}s(le,"rememberIgnored");function _(e,o,r){return{source:e.path,target:"",name:"",scope:o,status:"skipped",reason:r}}s(_,"skipResult");function de(e,o,r){const t=x(e.path),i=r??e.defaultScope;if(t.includes(Z))return _(e,i,"legacy generated crtr boot skill is pruned by host exports, not imported");const a=j(t),c=a.data??{},u=c.kind==="preference"?"preference":"knowledge",d=se(e,c);if(d==="")return _(e,i,"could not derive memory document name");const m=o(i),n=B(m.memoryDir,d),p=J(m.namespace,d);return{candidate:e,raw:t,parsed:a,sourceFm:c,kind:u,name:p,scope:i,target:n}}s(de,"prepareCandidate");function ue(e,o){if(R(e.target)&&!o.overwrite)return{source:e.candidate.path,target:e.target,name:e.name,scope:e.scope,status:"skipped",reason:"target memory doc already exists; re-run with --overwrite to replace it"};const r=A(e.sourceFm.description)??"",t={...e.sourceFm};return delete t.name,delete t.description,delete t.type,delete t.keywords,delete t["system-prompt-visibility"],delete t["file-read-visibility"],delete t["applies-to"],delete t["read-when"],t.kind=e.kind,(typeof t["when-and-why-to-read"]!="string"||t["when-and-why-to-read"].trim()==="")&&(t["when-and-why-to-read"]=V(r,e.kind)),(typeof t["short-form"]!="string"||t["short-form"].trim()==="")&&(t["short-form"]=r.replace(/\s+/g," ").trim()),Array.isArray(t.surfaces)||(t.surfaces=[{on:"boot",at:"preview"}]),o.dryRun||(t.privacy=R(e.target)?j(x(e.target)).data?.privacy??"private":t.privacy??"public",W(e.target,Y(t,e.parsed.body))),{source:e.candidate.path,target:e.target,name:e.name,scope:e.scope,status:o.dryRun?"would-import":"imported"}}s(ue,"convertPrepared");function E(e,o,r){return{source:e.candidate.path,target:e.target,name:e.name,scope:e.scope,status:r?"would-ignore":"ignored",reason:o}}s(E,"ignoreResult");function me(e,o){const r=e.filter(n=>n.status==="imported").length,t=e.filter(n=>n.status==="would-import").length,i=e.filter(n=>n.status==="skipped").length,a=e.filter(n=>n.status==="ignored").length,c=e.filter(n=>n.status==="would-ignore").length;let u;o?u=`crtr sys sync skills \u2014 ${c>0?`${c} would ignore`:`${a} ignored`}, ${i} skipped`:t>0?u=`crtr sys sync skills \u2014 dry run: ${t} would import, ${i} skipped, ${a} ignored`:u=`crtr sys sync skills \u2014 ${r} imported, ${i} skipped, ${a} ignored`;const d=e.map(n=>{const p=n.target||"\u2014",f=n.reason?` (${n.reason})`:"";return`| ${n.status} | ${n.scope}/${n.name||"\u2014"} | ${p} | ${n.source}${f} |`}),m=d.length===0?["No sync candidates."]:["| status | memory doc | target | source |","| --- | --- | --- | --- |",...d];return[u,"",...m].join(`
+`)}s(me,"renderSummary");const Ke=D({name:"skills",description:"import host Agent Skill (SKILL.md) bundles as crouter memory docs",whenToUse:"migrating legacy host-native Agent Skill bundles (SKILL.md \u2014 Claude/pi user or project skill roots, or an explicit bundle/root via --source) into the crouter memory-doc model. One-way: crouter never re-exports memory docs back to SKILL.md, and stops reading the originals unconditionally once migrated.",help:{name:"sys sync skills",summary:"one-way import: host SKILL.md bundles \u2192 crouter memory docs",params:[{kind:"flag",name:"source",type:"string",required:!1,constraint:"A SKILL.md file, a single skill bundle dir containing SKILL.md, or a skills root to scan recursively. Default: the user/project Claude and pi skill roots that exist."},{kind:"flag",name:"scope",type:"enum",choices:["user","project"],required:!1,constraint:"Target memory scope for the selected sources. Default: user for user host roots and project for project host roots; an explicit value applies to every selected source. `project` writes into the nearest project store walking up from cwd, which must already declare its `namespace:` \u2014 this lane imports documents into a store, never the declaration itself."},{kind:"flag",name:"dry-run",type:"bool",required:!1,constraint:"Show what would be imported without writing memory docs."},{kind:"flag",name:"overwrite",type:"bool",required:!1,constraint:"Replace an existing target memory doc. Default: skip existing docs to avoid clobbering user-authored memory."},{kind:"flag",name:"ignore",type:"bool",required:!1,constraint:`Permanently ignore every selected SKILL.md source by recording it in ~/.crouter/${w}. Honors --source/--scope; with no --source, ignores every currently discovered default host skill candidate.`},{kind:"flag",name:"include-ignored",type:"bool",required:!1,constraint:"Include ignored candidates in the report without making sync read-only. Pair with --dry-run to audit the full candidate set without importing non-ignored skills."}],output:[{name:"results",type:"object[]",required:!0,constraint:"Each: {source,target,name,scope,status,reason?}; status is one of imported, skipped, would-import, ignored, would-ignore. `name` is the full canonical name the imported doc answers at \u2014 a user import\u2019s bundle name, a project import\u2019s `<namespace>/<bundle name>`."}],outputKind:"object",effects:["Writes memory/<bundle name>.md in the selected crouter scope with substrate frontmatter and the SKILL.md body. The file stays store-local; a project import answers at `<namespace>/<bundle name>`.","Refuses a project store that declares no namespace, naming the `crtr sys migrate --dir` (legacy store) or `crtr memory write <namespace> --dir` (empty store) remedy; it never declares one itself.","Skips existing memory docs unless --overwrite is present.","Skips marker-bearing generated crtr boot skills; host exports prune those legacy artifacts instead.",`With --ignore: writes ~/.crouter/${w} and does not import the selected sources.`,"With --dry-run: read-only; writes nothing."]},run:s(async e=>{const o=e.source,r=e.scope,t=e.dryRun??!1,i=e.overwrite??!1,a=e.ignore??!1,c=e.includeIgnored??!1,u=re(o,r),d=new Set,m=[];for(const b of u)for(const l of ne(b))d.has(l.path)||(d.add(l.path),m.push(l));const n=ie(),p=ae(),f=[];let S=!1;for(const b of m){const l=de(b,n,r);if("status"in l){f.push(l);continue}if(a){t||(S=le(l,p)||S),f.push(E(l,t?"would record permanent ignore":`recorded in ~/.crouter/${w}`,t));continue}if(F(l,p)){c&&f.push(E(l,`matched ~/.crouter/${w}`,!1));continue}f.push(ue(l,{dryRun:t,overwrite:i}))}return S&&ce(p),{results:f,ignoreFile:k(),ignoreMode:a}},"run"),render:s(e=>me(e.results,e.ignoreMode===!0),"render")});export{Ke as sysSyncSkillsLeaf};

package/dist/commands/sys/worktrees.d.ts

@@ -1 +1,2 @@
+export declare function formatSize(bytes: number | null): string;
 export declare const sysWorktreesLeaf: import("../../core/command.js").LeafDef;

package/dist/commands/sys/worktrees.js

@@ -2,4 +2,4 @@ var i=Object.defineProperty;var r=(t,n)=>i(t,"name",{value:n,configurable:!0});i
 
 ${n.map(e=>{const a=[`- \`${e.node_id}\` \u2014 ${e.reason} \xB7 ${u(e.size_bytes)} \xB7 ${e.attempts} attempt${e.attempts===1?"":"s"} \xB7 ${e.last_attempt}`,`  - path: \`${e.path}\``,`  - branch: \`${e.branch}\``,`  - repo root: \`${e.repo_root}\``];return e.detail!==void 0&&a.push(`  - detail: ${e.detail}`),a.join(`
 `)}).join(`
-`)}`},"render")});export{p as sysWorktreesLeaf};
+`)}`},"render")});export{u as formatSize,p as sysWorktreesLeaf};

package/dist/commands/sys.js

@@ -1 +1 @@
-var t=Object.defineProperty;var r=(o,m)=>t(o,"name",{value:m,configurable:!0});import{defineSysBranch as s}from"./sys/branch.js";import{configBranch as f}from"./sys/config.js";import{daemonBranch as e}from"./sys/daemon.js";import{sysDoctorLeaf as i}from"./sys/doctor.js";import{sysFeedbackLeaf as a}from"./sys/feedback.js";import{sysLogsLeaf as p}from"./sys/logs.js";import{sysWorktreesLeaf as n}from"./sys/worktrees.js";import{sysSettingsLeaf as c}from"./sys/settings.js";import{sysConnectLeaf as y}from"./sys/connect.js";import{sysSetupLeaf as L}from"./sys/setup.js";import{tutorialBranch as h}from"./sys/tutorial/branch.js";import{supportBranch as B}from"./sys/support.js";import{contextBranch as g}from"./sys/context.js";import{sysSyncBranch as u}from"./sys/sync.js";import{sysMigrateLeaf as S}from"./sys/migrate.js";import{sysUpdateLeaf as d,sysVersionLeaf as k}from"./sys/update.js";function G(){return s([c,f,y,L,h,i,g,a,p,n,B,d,k,S,u,e])}r(G,"registerSys");export{G as registerSys};
+var s=Object.defineProperty;var r=(o,m)=>s(o,"name",{value:m,configurable:!0});import{defineSysBranch as t}from"./sys/branch.js";import{configBranch as f}from"./sys/config.js";import{daemonBranch as e}from"./sys/daemon.js";import{sysDoctorLeaf as i}from"./sys/doctor.js";import{sysFeedbackLeaf as a}from"./sys/feedback.js";import{sysLogsLeaf as p}from"./sys/logs.js";import{sysWorktreesLeaf as n}from"./sys/worktrees.js";import{sysSpacesLeaf as y}from"./sys/spaces.js";import{sysSettingsLeaf as c}from"./sys/settings.js";import{sysConnectLeaf as L}from"./sys/connect.js";import{sysSetupLeaf as h}from"./sys/setup.js";import{tutorialBranch as B}from"./sys/tutorial/branch.js";import{supportBranch as S}from"./sys/support.js";import{contextBranch as g}from"./sys/context.js";import{sysSyncBranch as u}from"./sys/sync.js";import{sysMigrateLeaf as d}from"./sys/migrate.js";import{sysJoinLeaf as k}from"./sys/join.js";import{sysUpdateLeaf as x,sysVersionLeaf as b}from"./sys/update.js";function K(){return t([c,f,L,h,B,i,g,a,p,n,y,S,x,b,d,k,u,e])}r(K,"registerSys");export{K as registerSys};

package/dist/core/auth-file.js

@@ -1,2 +1,2 @@
-var m=Object.defineProperty;var a=(e,t)=>m(e,"name",{value:t,configurable:!0});import{execSync as w}from"node:child_process";import{homedir as A}from"node:os";import{join as k}from"node:path";import{LockedJsonFile as d}from"./locked-file.js";function c(){return k(A(),".pi","agent","auth.json")}a(c,"defaultAuthPath");function l(e){if(e===void 0||e.trim()==="")return{};const t=JSON.parse(e);return t!==null&&typeof t=="object"?t:{}}a(l,"parse");function p(e){return`${JSON.stringify(e,null,2)}
-`}a(p,"serialize");const _=/^[A-Za-z_][A-Za-z0-9_]*/,C=/^[A-Za-z_][A-Za-z0-9_]*$/,x=new Map;function O(e){if(x.has(e))return x.get(e);let t;try{t=w(e,{encoding:"utf-8",timeout:1e4,stdio:["ignore","pipe","ignore"]}).trim()||void 0}catch{t=void 0}return x.set(e,t),t}a(O,"runValueCommand");function N(e,t){if(e.startsWith("!"))return O(e.slice(1));let n="",i=0;for(;i<e.length;){const r=e.indexOf("$",i);if(r<0){n+=e.slice(i);break}n+=e.slice(i,r);const s=e[r+1];if(s==="$"||s==="!"){n+=s,i=r+2;continue}let u,f=r+1;if(s==="{"){const o=e.indexOf("}",r+2),y=o<0?void 0:e.slice(r+2,o);y!==void 0&&C.test(y)&&(u=y,f=o+1)}else{const o=_.exec(e.slice(r+1));o!==null&&(u=o[0],f=r+1+u.length)}if(u===void 0){n+="$",i=r+1;continue}const h=t?.[u]||process.env[u];if(h===void 0||h==="")return;n+=h,i=f}return n}a(N,"resolveCredentialValue");async function j(e=c()){return l(new d(e).readUnlocked())}a(j,"readAuthCredentials");async function z(e,t=c()){return(await j(t))[e]}a(z,"readAuthCredential");async function L(e,t,n=c()){await new d(n).withLockAsync(async i=>{const r=l(i);return r[e]=t,{result:void 0,next:p(r)}})}a(L,"setAuthCredential");async function E(e,t=c()){return new d(t).withLockAsync(async n=>{const i=l(n),r=Object.hasOwn(i,e);return delete i[e],{result:r,next:p(i)}})}a(E,"deleteAuthCredential");class S{static{a(this,"CrouterCredentialStore")}authPath;file;constructor(t=c()){this.authPath=t,this.file=new d(t)}async read(t){const n=await z(t,this.authPath);return n?.type!=="api_key"||n.key===void 0?n:{...n,key:N(n.key,n.env)}}async list(){return Object.entries(l(this.file.readUnlocked())).map(([t,n])=>({providerId:t,type:n.type}))}async modify(t,n){return this.file.withLockAsync(async i=>{const r=l(i),s=await n(r[t]);return s===void 0?{result:r[t]}:(r[t]=s,{result:s,next:p(r)})})}async delete(t){await E(t,this.authPath)}}export{S as CrouterCredentialStore,c as defaultAuthPath,E as deleteAuthCredential,z as readAuthCredential,j as readAuthCredentials,N as resolveCredentialValue,L as setAuthCredential};
+var w=Object.defineProperty;var s=(e,t)=>w(e,"name",{value:t,configurable:!0});import{execSync as m}from"node:child_process";import{join as A}from"node:path";import{secretsDir as k}from"./layout.js";import{LockedJsonFile as d}from"./locked-file.js";function o(){return A(k(),"auth.json")}s(o,"defaultAuthPath");function l(e){if(e===void 0||e.trim()==="")return{};const t=JSON.parse(e);return t!==null&&typeof t=="object"?t:{}}s(l,"parse");function p(e){return`${JSON.stringify(e,null,2)}
+`}s(p,"serialize");const _=/^[A-Za-z_][A-Za-z0-9_]*/,C=/^[A-Za-z_][A-Za-z0-9_]*$/,x=new Map;function O(e){if(x.has(e))return x.get(e);let t;try{t=m(e,{encoding:"utf-8",timeout:1e4,stdio:["ignore","pipe","ignore"]}).trim()||void 0}catch{t=void 0}return x.set(e,t),t}s(O,"runValueCommand");function N(e,t){if(e.startsWith("!"))return O(e.slice(1));let n="",i=0;for(;i<e.length;){const r=e.indexOf("$",i);if(r<0){n+=e.slice(i);break}n+=e.slice(i,r);const a=e[r+1];if(a==="$"||a==="!"){n+=a,i=r+2;continue}let u,f=r+1;if(a==="{"){const c=e.indexOf("}",r+2),y=c<0?void 0:e.slice(r+2,c);y!==void 0&&C.test(y)&&(u=y,f=c+1)}else{const c=_.exec(e.slice(r+1));c!==null&&(u=c[0],f=r+1+u.length)}if(u===void 0){n+="$",i=r+1;continue}const h=t?.[u]||process.env[u];if(h===void 0||h==="")return;n+=h,i=f}return n}s(N,"resolveCredentialValue");async function j(e=o()){return l(new d(e).readUnlocked())}s(j,"readAuthCredentials");async function z(e,t=o()){return(await j(t))[e]}s(z,"readAuthCredential");async function L(e,t,n=o()){await new d(n).withLockAsync(async i=>{const r=l(i);return r[e]=t,{result:void 0,next:p(r)}})}s(L,"setAuthCredential");async function E(e,t=o()){return new d(t).withLockAsync(async n=>{const i=l(n),r=Object.hasOwn(i,e);return delete i[e],{result:r,next:p(i)}})}s(E,"deleteAuthCredential");class S{static{s(this,"CrouterCredentialStore")}authPath;file;constructor(t=o()){this.authPath=t,this.file=new d(t)}async read(t){const n=await z(t,this.authPath);return n?.type!=="api_key"||n.key===void 0?n:{...n,key:N(n.key,n.env)}}async list(){return Object.entries(l(this.file.readUnlocked())).map(([t,n])=>({providerId:t,type:n.type}))}async modify(t,n){return this.file.withLockAsync(async i=>{const r=l(i),a=await n(r[t]);return a===void 0?{result:r[t]}:(r[t]=a,{result:a,next:p(r)})})}async delete(t){await E(t,this.authPath)}}export{S as CrouterCredentialStore,o as defaultAuthPath,E as deleteAuthCredential,z as readAuthCredential,j as readAuthCredentials,N as resolveCredentialValue,L as setAuthCredential};

package/dist/core/bash-job-supervisor.d.ts

@@ -0,0 +1,6 @@
+export declare const MAX_BACKGROUND_BASH_LOG_BYTES: number;
+export declare const BACKGROUND_BASH_LOG_TRUNCATION_MARKER = "\n[background bash job output truncated at 10 MiB; remaining output discarded]\n";
+/** File-backed command supervisor. The daemon receives completed Linux jobs
+ * from the durable file state; on a Mac the existing CLI completion notice
+ * remains the owner of delivery. $12 selects that direct Mac path. */
+export declare const BASH_JOB_SUPERVISOR_SCRIPT: string;

package/dist/core/bash-job-supervisor.js

@@ -0,0 +1,4 @@
+const t=10485760,e=`
+[background bash job output truncated at 10 MiB; remaining output discarded]
+`,n=['const fs = require("node:fs");',"const cap = 10485760;",`const marker = Buffer.from(${JSON.stringify(e)});`,"const prefixCap = cap - marker.length;",'const fd = fs.openSync(process.argv[1], "w");',"let written = 0;","let truncated = false;",'process.stdin.on("data", (chunk) => {',"  if (truncated) return;","  const available = prefixCap - written;","  if (available > 0) {","    const prefix = chunk.subarray(0, available);","    fs.writeSync(fd, prefix);","    written += prefix.length;","    if (prefix.length === chunk.length) return;","  }","  fs.writeSync(fd, marker);","  truncated = true;","});",'process.stdin.on("end", () => fs.closeSync(fd));'].join(" "),r=["SECONDS=0","n=$(command -v nice)",'${n:+"$n" -n "${10}"} "${9}" "$1" 2>&1 | "${11}" -e '+JSON.stringify(n)+' "$2"',"ec=${PIPESTATUS[0]}","d=$SECONDS",'echo "$ec" > "$3"','if [ "$d" -lt 60 ]; then','  el="${d}s"','elif [ "$d" -lt 3600 ]; then','  el="$((d / 60))m $(printf "%02d" "$((d % 60))")s"',"else",'  el="$((d / 3600))h $(printf "%02d" "$((d / 60 % 60))")m"',"fi",'if mv "$4" "$5" 2>/dev/null; then',"  :",'elif [ -f "$6" ] && [ "${12}" = direct ]; then','  crtr node message send "Background bash job $7 finished (exit $ec) after $el. Log: $2  Command: $1" --to "$8" --tier urgent || true',"fi"].join(`
+`);export{e as BACKGROUND_BASH_LOG_TRUNCATION_MARKER,r as BASH_JOB_SUPERVISOR_SCRIPT,t as MAX_BACKGROUND_BASH_LOG_BYTES};

package/dist/core/bash-jobs.d.ts

@@ -1,5 +1,8 @@
 export interface BashJobPaths {
     jobId: string;
+    /** The node's agent folder (the parent of its context folder): every job
+     * file resolves beneath it, so a symlink the agent plants is never followed. */
+    root: string;
     dir: string;
     cmdSh: string;
     jobLog: string;
@@ -75,10 +78,9 @@ export declare function writeJobDeadlineMs(paths: BashJobPaths, deadlineMs: numb
 /** Drop a job's cancel deadline so it runs to completion — the node has claimed
  * it. Best-effort: a job with no deadline file is already in this state. */
 export declare function clearJobDeadline(paths: BashJobPaths): void;
-/** Whether a persisted job supervisor process group is still present. EPERM
- *  means the group exists but cannot be signaled by this process; it is still
- *  live for the status surface. */
-export declare function isBashJobProcessGroupAlive(pgid: number): boolean;
+/** Launcher jobs have a root-owned bwrap pid, not a process group; direct
+ *  jobs keep their detached supervisor process group. */
+export declare function isBashJobProcessGroupAlive(pgid: number, identity?: string): boolean;
 /** Best-effort cancellation for a detached bash supervisor. It snapshots the
  * observable descendant tree while the supervisor is still alive, signals its
  * leaves before their parents, then uses the shared identity-guarded KILL
@@ -108,7 +110,7 @@ export type StopBackgroundBashJobResult = {
  * supervisor exits, so a retired, still-foreground, or already-stopped job
  * would otherwise have its recorded pgid signaled long after the OS could have
  * reused that id for an unrelated process group. */
-export declare function stopBackgroundBashJob(contextDir: string, jobId: string): Promise<StopBackgroundBashJobResult>;
+export declare function stopBackgroundBashJob(contextDir: string, jobId: string, allowForeground?: boolean, nodeId?: string, reason?: string): Promise<StopBackgroundBashJobResult>;
 /** Last `count` lines of a job log, cheaply: read at most the trailing 64 KiB
  * rather than the whole file, which for a long-running job can be enormous. */
 export declare function tailJobLog(logPath: string, count: number): string[];
@@ -146,10 +148,15 @@ export interface BashJobStatus {
  * absent — whether handed off by the menu, the valve deadline, or broker
  * termination. Read-only; never mutates. Skips malformed/partially-written
  * directories. Returns oldest-first by startedAtMs. */
-export declare function activeBackgroundBashJobs(contextDir: string): BashJobStatus[];
+export declare function activeBackgroundBashJobs(contextDir: string, includeForeground?: boolean): BashJobStatus[];
 /** Every live background job for this node whose auto-cancel deadline has
  * passed at `now`. The daemon's deadline lane stops exactly these. A job with
  * no deadline (deliberate handoff, or one the node claimed) never appears. */
+export declare function completedBackgroundBashJobs(contextDir: string): Array<{
+    jobId: string;
+    exitCode: number;
+    startedAtMs: number;
+}>;
 export declare function expiredAutoBackgroundBashJobs(contextDir: string, now: number): BashJobStatus[];
 /** Credit every armed auto-cancel deadline for an interval the node was not
  * permitted to run. A profile pause stops the owning node, so without this the

package/dist/core/bash-jobs.js

@@ -1,7 +1,8 @@
-var A=Object.defineProperty;var o=(t,n)=>A(t,"name",{value:n,configurable:!0});import{randomBytes as J}from"node:crypto";import{closeSync as g,existsSync as d,mkdirSync as E,openSync as m,readdirSync as y,readFileSync as f,readSync as N,renameSync as k,rmSync as L,statSync as w,writeFileSync as h}from"node:fs";import{join as s}from"node:path";import{captureTeardownSnapshot as $,isAnyPidAlive as T,killProcessTreePids as S}from"./canvas/pid.js";const _=280;function I(t){if(typeof t!="string"||/[\p{Cc}\p{Cf}]/u.test(t))return null;const n=t.trim();return n===""?null:Buffer.byteLength(n,"utf8")<=_?n:null}o(I,"normalizeBashJobPurpose");function l(t){return s(t,"jobs")}o(l,"bashJobsDir");function Y(t){return typeof t=="string"&&t!==""&&t!=="."&&t!==".."&&/^[A-Za-z0-9._~-]+$/u.test(t)&&Buffer.byteLength(t,"utf8")<=128}o(Y,"isSafeBashJobId");function a(t,n){const e=s(l(t),n);return{jobId:n,dir:e,cmdSh:s(e,"cmd.sh"),jobLog:s(e,"job.log"),jobExit:s(e,"job.exit"),jobRun:s(e,"job.run"),jobBg:s(e,"job.bg"),jobDone:s(e,"job.done"),jobPgid:s(e,"job.pgid"),jobPgidIdentity:s(e,"job.pgid-identity"),jobPurpose:s(e,"purpose"),jobDeadline:s(e,"job.deadline")}}o(a,"bashJobPaths");function R(t,n){try{const e=Number(f(a(t,n).jobPgid,"utf8").trim());return Number.isInteger(e)&&e>1?e:void 0}catch{return}}o(R,"readJobPgid");function D(t,n){try{const e=f(a(t,n).jobPgidIdentity,"utf8").trim();return e===""?void 0:e}catch{return}}o(D,"readJobPgidIdentity");function F(t,n){try{return I(f(a(t,n).jobPurpose,"utf8"))}catch{return null}}o(F,"readJobPurpose");const j=10,O=19;function x(t){return s(l(t),"niceness")}o(x,"bashNicenessPath");function Z(t){try{const n=Number(f(x(t),"utf8").trim());return!Number.isInteger(n)||n<0||n>O?j:n}catch{return j}}o(Z,"readBashNiceness");function q(t,n){E(l(t),{recursive:!0}),h(x(t),`${Math.trunc(n)}
-`)}o(q,"writeBashNiceness");function C(t,n){try{const e=Number(f(a(t,n).jobDeadline,"utf8").trim());return Number.isFinite(e)?e:void 0}catch{return}}o(C,"readJobDeadlineMs");function z(t,n){h(t.jobDeadline,`${Math.trunc(n)}
-`)}o(z,"writeJobDeadlineMs");function Q(t){try{L(t.jobDeadline,{force:!0})}catch{}}o(Q,"clearJobDeadline");function V(t){try{return process.kill(-t,0),!0}catch(n){return n.code==="EPERM"}}o(V,"isBashJobProcessGroupAlive");async function v(t,n){const e=$(t,n);if(e.reused||e.tree.length===0)return!1;const r=[...e.tree].reverse(),i=T(r);return S(r,"SIGTERM",e.identities),await new Promise(c=>setTimeout(c,400)),S(r,"SIGKILL",e.identities),i}o(v,"cancelBashJobProcessTree");async function tt(t,n){const e=a(t,n);if(!d(e.dir))return{kind:"missing"};if(!d(e.jobBg)||d(e.jobExit))return{kind:"retired",logPath:e.jobLog};const r=R(t,n),i=D(t,n);if(r===void 0||i===void 0)return{kind:"not-stoppable",logPath:e.jobLog};try{const u=m(e.jobExit,"wx");try{h(u,`143
-`)}finally{g(u)}}catch(u){if(u.code==="EEXIST")return{kind:"retired",logPath:e.jobLog};throw u}return{kind:"stopped",signaled:await v(r,i),pgid:r,logPath:e.jobLog}}o(tt,"stopBackgroundBashJob");function nt(t,n){if(n<=0)return[];const e=64*1024;let r;try{const i=w(t).size,c=Math.max(0,i-e),u=Buffer.alloc(Math.min(i,e));r=m(t,"r"),N(r,u,0,u.length,c);const p=u.toString("utf8"),b=(c>0?p.slice(p.indexOf(`
-`)+1):p).split(`
-`);return b[b.length-1]===""&&b.pop(),b.slice(-n)}catch{return[]}finally{r!==void 0&&g(r)}}o(nt,"tailJobLog");function et(){return`${Date.now()}-${J(4).toString("hex")}`}o(et,"newBashJobId");function B(t){const n=t.indexOf("-");if(n<=0||n===t.length-1)return;const e=Number(t.slice(0,n));return Number.isFinite(e)?e:void 0}o(B,"jobStartedAtMs");function rt(t){const n=Math.max(0,Math.floor(t/1e3));if(n<60)return`${n}s`;const e=Math.floor(n/60),r=n%60;if(e<60)return`${e}m ${String(r).padStart(2,"0")}s`;const i=Math.floor(e/60),c=e%60;return`${i}h ${String(c).padStart(2,"0")}m`}o(rt,"formatBashElapsed");function ot(t){return(t.split(`
-`).map(e=>e.trim()).find(e=>e!=="")??"").replace(/\s+/g," ")}o(ot,"bashJobCommandLine");function M(t){let n;try{n=y(l(t))}catch{return[]}const e=[];for(const r of n){const i=a(t,r);if(!d(i.jobBg)||d(i.jobExit))continue;const c=B(r);if(c===void 0)continue;let u;try{u=f(i.cmdSh,"utf8")}catch{continue}e.push({jobId:r,command:u,purpose:F(t,r),startedAtMs:c,logPath:i.jobLog,deadlineAtMs:C(t,r)??null})}return e.sort((r,i)=>r.startedAtMs-i.startedAtMs)}o(M,"activeBackgroundBashJobs");function it(t,n){return M(t).filter(e=>e.deadlineAtMs!==null&&n>=e.deadlineAtMs)}o(it,"expiredAutoBackgroundBashJobs");function st(t,n){if(!Number.isFinite(n)||n<=0)return 0;let e=0;for(const r of M(t))if(r.deadlineAtMs!==null)try{z(a(t,r.jobId),r.deadlineAtMs+n),e+=1}catch{}return e}o(st,"shiftAutoBackgroundBashDeadlines");function G(t){try{return k(t.jobRun,t.jobBg),"backgrounded"}catch(n){if(n.code!=="ENOENT")throw n;return d(t.jobBg)?"already-backgrounded":d(t.jobDone)?"finished":"missing"}}o(G,"backgroundBashJob");function P(t){let n;try{n=y(l(t))}catch{return[]}return n.flatMap(e=>{const r=a(t,e);return d(r.cmdSh)&&d(r.jobLog)&&d(r.jobRun)?[r]:[]})}o(P,"runningBashJobs");function ut(t){let n;for(const e of P(t)){const r=B(e.jobId);r!==void 0&&(n===void 0||r<n)&&(n=r)}return n}o(ut,"oldestRunningBashJobStartedAtMs");function ct(t){const n=[];for(const e of P(t))G(e)==="backgrounded"&&n.push(e);return n}o(ct,"backgroundRunningBashJobs");export{j as DEFAULT_BASH_NICENESS,O as MAX_BASH_NICENESS,M as activeBackgroundBashJobs,G as backgroundBashJob,ct as backgroundRunningBashJobs,ot as bashJobCommandLine,a as bashJobPaths,l as bashJobsDir,x as bashNicenessPath,v as cancelBashJobProcessTree,Q as clearJobDeadline,it as expiredAutoBackgroundBashJobs,rt as formatBashElapsed,V as isBashJobProcessGroupAlive,Y as isSafeBashJobId,B as jobStartedAtMs,et as newBashJobId,I as normalizeBashJobPurpose,ut as oldestRunningBashJobStartedAtMs,Z as readBashNiceness,C as readJobDeadlineMs,R as readJobPgid,D as readJobPgidIdentity,F as readJobPurpose,st as shiftAutoBackgroundBashDeadlines,tt as stopBackgroundBashJob,nt as tailJobLog,q as writeBashNiceness,z as writeJobDeadlineMs};
+var N=Object.defineProperty;var o=(t,e)=>N(t,"name",{value:e,configurable:!0});import{randomBytes as k}from"node:crypto";import{closeSync as w,openSync as L,readSync as T,statSync as $}from"node:fs";import{dirname as g,join as c}from"node:path";import{captureTeardownSnapshot as I,isAnyPidAlive as R,isPidAlive as _,killProcessTreePids as y}from"./canvas/pid.js";import{launcherRequest as O}from"../launcher/client.js";import{LaunchRefused as F}from"../launcher/spec.js";import{createFileBeneath as S,existsBeneath as C,readdirBeneath as v,readFileBeneath as z,renameBeneath as X,unlinkBeneath as G,writeFileBeneath as x}from"./spaces/open-beneath.js";const H=280;function q(t){if(typeof t!="string"||/[\p{Cc}\p{Cf}]/u.test(t))return null;const e=t.trim();return e===""?null:Buffer.byteLength(e,"utf8")<=H?e:null}o(q,"normalizeBashJobPurpose");function m(t){return c(t,"jobs")}o(m,"bashJobsDir");function p(t,e){return z(g(t),e).toString("utf8")}o(p,"readJobText");function j(t){return v(g(t),m(t)).map(e=>e.name)}o(j,"jobIds");function a(t,e){return C(t.root,e)}o(a,"has");function E(t,e){try{G(t,e)}catch(n){if(n.code!=="ENOENT")throw n}}o(E,"unlinkIfPresent");function U(t){return typeof t=="string"&&t!==""&&t!=="."&&t!==".."&&/^[A-Za-z0-9._~-]+$/u.test(t)&&Buffer.byteLength(t,"utf8")<=128}o(U,"isSafeBashJobId");function l(t,e){const n=c(m(t),e);return{jobId:e,root:g(t),dir:n,cmdSh:c(n,"cmd.sh"),jobLog:c(n,"job.log"),jobExit:c(n,"job.exit"),jobRun:c(n,"job.run"),jobBg:c(n,"job.bg"),jobDone:c(n,"job.done"),jobPgid:c(n,"job.pgid"),jobPgidIdentity:c(n,"job.pgid-identity"),jobPurpose:c(n,"purpose"),jobDeadline:c(n,"job.deadline")}}o(l,"bashJobPaths");function W(t,e){try{const n=Number(p(t,l(t,e).jobPgid).trim());return Number.isInteger(n)&&n>1?n:void 0}catch{return}}o(W,"readJobPgid");function K(t,e){try{const n=p(t,l(t,e).jobPgidIdentity).trim();return n===""?void 0:n}catch{return}}o(K,"readJobPgidIdentity");function Y(t,e){try{return q(p(t,l(t,e).jobPurpose))}catch{return null}}o(Y,"readJobPurpose");const P=10,Z=19;function M(t){return c(m(t),"niceness")}o(M,"bashNicenessPath");function at(t){try{const e=Number(p(t,M(t)).trim());return!Number.isInteger(e)||e<0||e>Z?P:e}catch{return P}}o(at,"readBashNiceness");function dt(t,e){x(g(t),M(t),`${Math.trunc(e)}
+`)}o(dt,"writeBashNiceness");function Q(t,e){try{const n=Number(p(t,l(t,e).jobDeadline).trim());return Number.isFinite(n)?n:void 0}catch{return}}o(Q,"readJobDeadlineMs");function V(t,e){x(t.root,t.jobDeadline,`${Math.trunc(e)}
+`)}o(V,"writeJobDeadlineMs");function ft(t){try{E(t.root,t.jobDeadline)}catch{}}o(ft,"clearJobDeadline");function lt(t,e){if(e===`launcher:${t}`)return _(t);try{return process.kill(-t,0),!0}catch(n){return n.code==="EPERM"}}o(lt,"isBashJobProcessGroupAlive");async function D(t,e){const n=I(t,e);if(n.reused||n.tree.length===0)return!1;const r=[...n.tree].reverse(),s=R(r);return y(r,"SIGTERM",n.identities),await new Promise(i=>setTimeout(i,400)),y(r,"SIGKILL",n.identities),s}o(D,"cancelBashJobProcessTree");async function ht(t,e,n=!1,r,s){const i=l(t,e);if(!a(i,i.dir))return{kind:"missing"};if(!a(i,i.jobBg)&&!(n&&a(i,i.jobRun))||a(i,i.jobExit))return{kind:"retired",logPath:i.jobLog};const u=W(t,e),d=K(t,e);if(u===void 0||d===void 0)return{kind:"not-stoppable",logPath:i.jobLog};const h=c(i.dir,"job.stop");try{S(i.root,h,s===void 0?"":`${s}
+`)}catch(f){if(f.code==="EEXIST")return{kind:"retired",logPath:i.jobLog};throw f}try{let f;if(d===`launcher:${u}`){if(r===void 0)throw new Error("launcher job stop requires its owning node");try{if(!("ok"in await O({operation:"stop",pid:u,nodeId:r})))throw new Error("launcher did not stop job");f=!0}catch(b){if(!(b instanceof F&&b.refusal==="invalid_spec"))throw b;f=!1}}else f=await D(u,d);try{S(i.root,i.jobExit,`143
+`)}catch(b){if(b.code!=="EEXIST")throw b}return{kind:"stopped",signaled:f,pgid:u,logPath:i.jobLog}}catch(f){throw E(i.root,h),f}}o(ht,"stopBackgroundBashJob");function bt(t,e){if(e<=0)return[];const n=64*1024;let r;try{const s=$(t).size,i=Math.max(0,s-n),u=Buffer.alloc(Math.min(s,n));r=L(t,"r"),T(r,u,0,u.length,i);const d=u.toString("utf8"),h=(i>0?d.slice(d.indexOf(`
+`)+1):d).split(`
+`);return h[h.length-1]===""&&h.pop(),h.slice(-e)}catch{return[]}finally{r!==void 0&&w(r)}}o(bt,"tailJobLog");function pt(){return`${Date.now()}-${k(4).toString("hex")}`}o(pt,"newBashJobId");function B(t){const e=t.indexOf("-");if(e<=0||e===t.length-1)return;const n=Number(t.slice(0,e));return Number.isFinite(n)?n:void 0}o(B,"jobStartedAtMs");function gt(t){const e=Math.max(0,Math.floor(t/1e3));if(e<60)return`${e}s`;const n=Math.floor(e/60),r=e%60;if(n<60)return`${n}m ${String(r).padStart(2,"0")}s`;const s=Math.floor(n/60),i=n%60;return`${s}h ${String(i).padStart(2,"0")}m`}o(gt,"formatBashElapsed");function mt(t){return(t.split(`
+`).map(n=>n.trim()).find(n=>n!=="")??"").replace(/\s+/g," ")}o(mt,"bashJobCommandLine");function A(t,e=!1){let n;try{n=j(t)}catch{return[]}const r=[];for(const s of n){const i=B(s);if(i===void 0)continue;const u=l(t,s);let d;try{if(!a(u,u.jobBg)&&!(e&&a(u,u.jobRun))||a(u,u.jobExit))continue;d=p(t,u.cmdSh)}catch{continue}r.push({jobId:s,command:d,purpose:Y(t,s),startedAtMs:i,logPath:u.jobLog,deadlineAtMs:Q(t,s)??null})}return r.sort((s,i)=>s.startedAtMs-i.startedAtMs)}o(A,"activeBackgroundBashJobs");function jt(t){let e;try{e=j(t)}catch(r){if(r.code==="ENOENT")return[];throw r}const n=[];for(const r of e){if(!U(r))continue;const s=l(t,r);if(!a(s,s.jobBg)||!a(s,s.jobExit)||a(s,c(s.dir,"job.stop")))continue;const i=B(r);if(i===void 0)continue;const u=Number(p(t,s.jobExit).trim());Number.isSafeInteger(u)&&n.push({jobId:r,exitCode:u,startedAtMs:i})}return n}o(jt,"completedBackgroundBashJobs");function Bt(t,e){return A(t).filter(n=>n.deadlineAtMs!==null&&e>=n.deadlineAtMs)}o(Bt,"expiredAutoBackgroundBashJobs");function yt(t,e){if(!Number.isFinite(e)||e<=0)return 0;let n=0;for(const r of A(t))if(r.deadlineAtMs!==null)try{V(l(t,r.jobId),r.deadlineAtMs+e),n+=1}catch{}return n}o(yt,"shiftAutoBackgroundBashDeadlines");function tt(t){try{return X(t.root,t.jobRun,t.jobBg),"backgrounded"}catch(e){if(e.code!=="ENOENT")throw e;return a(t,t.jobBg)?"already-backgrounded":a(t,t.jobDone)?"finished":"missing"}}o(tt,"backgroundBashJob");function J(t){let e;try{e=j(t)}catch{return[]}return e.flatMap(n=>{const r=l(t,n);try{return a(r,r.cmdSh)&&a(r,r.jobLog)&&a(r,r.jobRun)?[r]:[]}catch{return[]}})}o(J,"runningBashJobs");function St(t){let e;for(const n of J(t)){const r=B(n.jobId);r!==void 0&&(e===void 0||r<e)&&(e=r)}return e}o(St,"oldestRunningBashJobStartedAtMs");function xt(t){const e=[];for(const n of J(t))tt(n)==="backgrounded"&&e.push(n);return e}o(xt,"backgroundRunningBashJobs");export{P as DEFAULT_BASH_NICENESS,Z as MAX_BASH_NICENESS,A as activeBackgroundBashJobs,tt as backgroundBashJob,xt as backgroundRunningBashJobs,mt as bashJobCommandLine,l as bashJobPaths,m as bashJobsDir,M as bashNicenessPath,D as cancelBashJobProcessTree,ft as clearJobDeadline,jt as completedBackgroundBashJobs,Bt as expiredAutoBackgroundBashJobs,gt as formatBashElapsed,lt as isBashJobProcessGroupAlive,U as isSafeBashJobId,B as jobStartedAtMs,pt as newBashJobId,q as normalizeBashJobPurpose,St as oldestRunningBashJobStartedAtMs,at as readBashNiceness,Q as readJobDeadlineMs,W as readJobPgid,K as readJobPgidIdentity,Y as readJobPurpose,yt as shiftAutoBackgroundBashDeadlines,ht as stopBackgroundBashJob,bt as tailJobLog,dt as writeBashNiceness,V as writeJobDeadlineMs};

package/dist/core/broker-client/transport-relay.d.ts

@@ -13,17 +13,20 @@ export interface RelayTarget {
     /** The raw bearer token. NEVER logged, NEVER echoed. */
     relayToken: string;
 }
+export interface LocalRelayTarget {
+    /** The owner's daemon API socket. The viewer has already called ensureAttach. */
+    socketPath: string;
+}
 export declare class RelayTransport extends EventEmitter implements Transport {
     private readonly nodeId;
     private readonly target;
     private ws;
     private closeEmitted;
-    constructor(nodeId: string, target: RelayTarget);
+    constructor(nodeId: string, target: RelayTarget | LocalRelayTarget);
     private get url();
     private dial;
     connect(): void;
-    /** Re-dial the same crtrd attach endpoint — the preview endpoint is the
-     *  stable remote anchor, as `view.sock` is locally. */
+    /** Re-dial the same daemon attach endpoint after a broker replacement. */
     redial(_options?: RedialOptions): Promise<void>;
     send(frame: ClientToBroker): void;
     destroy(): void;

package/dist/core/broker-client/transport-relay.js

@@ -1 +1 @@
-var l=Object.defineProperty;var a=(i,t)=>l(i,"name",{value:t,configurable:!0});import{EventEmitter as d}from"node:events";import{WebSocket as h}from"ws";import{classify as m}from"../fault-classifier.js";import{BrokerUnavailableError as f}from"./transport.js";function u(i,t){const e=new URL(i.previewEndpoint);return e.protocol=e.protocol==="http:"?"ws:":"wss:",e.pathname=`/v1/nodes/${encodeURIComponent(t)}/attach`,e.search="?wakeParked=1",e.hash="",e.toString()}a(u,"relayUrl");class S extends d{static{a(this,"RelayTransport")}nodeId;target;ws;closeEmitted=!1;constructor(t,e){super(),this.nodeId=t,this.target=e}get url(){return u(this.target,this.nodeId)}dial(){const t=new h(this.url,{headers:{authorization:`Bearer ${this.target.relayToken}`},perMessageDeflate:!1});return this.ws=t,t}connect(){const t=this.dial();t.on("open",()=>{this.emit("connect")}),t.on("message",e=>this.onMessage(e)),t.on("error",e=>this.onError(e)),t.on("close",(e,s)=>this.onClose(e,s.toString()))}redial(t){return this.destroy(),this.closeEmitted=!1,new Promise((e,s)=>{const r=this.dial();let n=!1;r.on("open",()=>{n||(n=!0,this.emit("connect"),e())}),r.on("message",o=>this.onMessage(o)),r.on("error",o=>{if(n){this.onError(o);return}n=!0;try{r.terminate()}catch{}s(o)}),r.on("close",(o,c)=>{n&&this.onClose(o,c.toString())})})}send(t){const e=this.ws;if(!(e===void 0||e.readyState!==h.OPEN))try{e.send(JSON.stringify(t))}catch{}}destroy(){const t=this.ws;if(t!==void 0&&t.readyState<=h.OPEN)try{t.close()}catch{}}onMessage(t){let e;try{e=JSON.parse(t.toString())}catch{return}this.emit("frame",e)}onError(t){this.emitError(new Error(`relay transport error: ${t.message}`))}onClose(t,e){if(this.closeEmitted)return;this.closeEmitted=!0;const s=m("viewer\u2194broker",{code:t,reason:e});(t===1008||s.kind==="protocol"||t===1011&&(/^no running broker/.test(e)||/^no node /.test(e)))&&this.emitError(new f(this.nodeId)),this.emit("close")}emitError(t){this.listenerCount("error")>0&&this.emit("error",t)}}export{S as RelayTransport};
+var l=Object.defineProperty;var a=(r,t)=>l(r,"name",{value:t,configurable:!0});import{EventEmitter as d}from"node:events";import{WebSocket as h}from"ws";import{classify as m}from"../fault-classifier.js";import{BrokerUnavailableError as f}from"./transport.js";function u(r,t){if("socketPath"in r)return`ws+unix://${r.socketPath}:/v1/nodes/${encodeURIComponent(t)}/attach?revive=0`;const e=new URL(r.previewEndpoint);return e.protocol=e.protocol==="http:"?"ws:":"wss:",e.pathname=`/v1/nodes/${encodeURIComponent(t)}/attach`,e.search="?wakeParked=1",e.hash="",e.toString()}a(u,"relayUrl");class k extends d{static{a(this,"RelayTransport")}nodeId;target;ws;closeEmitted=!1;constructor(t,e){super(),this.nodeId=t,this.target=e}get url(){return u(this.target,this.nodeId)}dial(){const t=new h(this.url,{..."relayToken"in this.target?{headers:{authorization:`Bearer ${this.target.relayToken}`}}:{},perMessageDeflate:!1});return this.ws=t,t}connect(){const t=this.dial();t.on("open",()=>{this.emit("connect")}),t.on("message",e=>this.onMessage(e)),t.on("error",e=>this.onError(e)),t.on("close",(e,n)=>this.onClose(e,n.toString()))}redial(t){return this.destroy(),this.closeEmitted=!1,new Promise((e,n)=>{const o=this.dial();let i=!1;o.on("open",()=>{i||(i=!0,this.emit("connect"),e())}),o.on("message",s=>this.onMessage(s)),o.on("error",s=>{if(i){this.onError(s);return}i=!0;try{o.terminate()}catch{}n(s)}),o.on("close",(s,c)=>{i&&this.onClose(s,c.toString())})})}send(t){const e=this.ws;if(!(e===void 0||e.readyState!==h.OPEN))try{e.send(JSON.stringify(t))}catch{}}destroy(){const t=this.ws;if(t!==void 0&&t.readyState<=h.OPEN)try{t.close()}catch{}}onMessage(t){let e;try{e=JSON.parse(t.toString())}catch{return}this.emit("frame",e)}onError(t){this.emitError(new Error(`relay transport error: ${t.message}`))}onClose(t,e){if(this.closeEmitted)return;this.closeEmitted=!0;const n=m("viewer\u2194broker",{code:t,reason:e});(t===1008||n.kind==="protocol"||t===1011&&(/^no running broker/.test(e)||/^no node /.test(e)))&&this.emitError(new f(this.nodeId)),this.emit("close")}emitError(t){this.listenerCount("error")>0&&this.emit("error",t)}}export{k as RelayTransport};

package/dist/core/broker-client/transport-socket.d.ts

@@ -3,13 +3,18 @@ import { type ClientToBroker } from '../runtime/broker-protocol.js';
 import { type RedialOptions, type Transport } from './transport.js';
 export declare class SocketTransport extends EventEmitter implements Transport {
     private readonly nodeId;
+    private readonly options;
     private socket;
     private decoder;
     private closeEmitted;
     /** One redial fault line per reconnect EPISODE, not per attempt — see
      *  {@link recordSocketFault}. */
     private redialFaultRecorded;
-    constructor(nodeId: string);
+    /** `recordsViewerFaults: false` is for an internal daemon reader: its
+     *  connect outcome says nothing about any person's viewer. */
+    constructor(nodeId: string, options?: {
+        recordsViewerFaults?: boolean;
+    });
     /** The broker binds `viewSocketPath(id)` — resolve it the same way. */
     get socketPath(): string;
     private recordSocketFault;

package/dist/core/broker-client/transport-socket.js

@@ -1 +1 @@
-var f=Object.defineProperty;var a=(n,e)=>f(n,"name",{value:e,configurable:!0});import{EventEmitter as k}from"node:events";import{createConnection as d}from"node:net";import{viewSocketPath as u}from"../canvas/paths.js";import{classify as E}from"../fault-classifier.js";import{clearNodeFault as v,recordNodeFault as F}from"../runtime/broker/daemon-ops.js";import{emitEvent as c}from"../events/emit.js";import{CLIENT_READ_CAPS as l,encodeFrame as p,FrameDecoder as h,FrameOverflowError as w}from"../runtime/broker-protocol.js";import{BrokerUnavailableError as b}from"./transport.js";class P extends k{static{a(this,"SocketTransport")}nodeId;socket;decoder=new h(l);closeEmitted=!1;redialFaultRecorded=!1;constructor(e){super(),this.nodeId=e}get socketPath(){return u(this.nodeId)}recordSocketFault(e,t){if(e==="redial"){if(this.redialFaultRecorded)return;this.redialFaultRecorded=!0}const o=E("viewer\u2194broker",t);F(this.nodeId,{link:"viewer\u2194broker",op:e,kind:o.kind,retry:e==="redial"?{disposition:"auto",by:"client"}:{disposition:"manual"},message:t instanceof Error?t.message:String(t)}).catch(r=>{c({event:"broker.daemon.operation.failed",level:"error",node_id:this.nodeId,error:r,fields:{operation:"viewer_fault_record"}})})}connect(){const e=d(this.socketPath);this.socket=e,e.on("connect",()=>{this.redialFaultRecorded=!1,this.clearSocketFault(),this.emit("connect")}),e.on("data",t=>this.onData(t)),e.on("error",t=>this.onError(t,"connect")),e.on("close",()=>this.onClose())}redial(e={}){return this.destroy(),this.decoder=new h(l),this.closeEmitted=!1,e.brokerUnavailableIsExpected&&(this.redialFaultRecorded=!1,this.clearSocketFault()),new Promise((t,o)=>{const r=d(this.socketPath);this.socket=r;let s=!1;r.on("connect",()=>{s||(s=!0,this.redialFaultRecorded=!1,this.clearSocketFault(),this.emit("connect"),t())}),r.on("data",i=>this.onData(i)),r.on("error",i=>{if(s){this.onError(i,"redial");return}s=!0;const m=i.code==="ECONNREFUSED"||i.code==="ENOENT";(!e.brokerUnavailableIsExpected||!m)&&this.recordSocketFault("redial",i);try{r.destroy()}catch{}o(i)}),r.on("close",()=>this.onClose())})}send(e){const t=this.socket;if(!(t===void 0||t.destroyed))try{t.write(p(e))}catch{}}destroy(){const e=this.socket;if(e!==void 0&&!e.destroyed)try{e.destroy()}catch{}}clearSocketFault(){v(this.nodeId,{link:"viewer\u2194broker"}).catch(e=>{c({event:"broker.daemon.operation.failed",level:"error",node_id:this.nodeId,error:e,fields:{operation:"viewer_fault_clear"}})})}onData(e){let t;try{t=this.decoder.push(e)}catch(o){const r=o instanceof w?`broker sent an oversized frame (${o.message}) \u2014 disconnecting`:`failed to decode a broker frame: ${String(o)}`;this.emitError(new Error(r)),this.destroy();return}for(const o of t)this.emit("frame",o)}onError(e,t){this.recordSocketFault(t,e),e.code==="ECONNREFUSED"||e.code==="ENOENT"?this.emitError(new b(this.nodeId)):this.emitError(new Error(`view socket error: ${e.message}`))}onClose(){this.closeEmitted||(this.closeEmitted=!0,this.emit("close"))}emitError(e){this.listenerCount("error")>0&&this.emit("error",e)}}export{P as SocketTransport};
+var m=Object.defineProperty;var d=(n,e)=>m(n,"name",{value:e,configurable:!0});import{EventEmitter as u}from"node:events";import{viewSocketPath as k}from"../canvas/paths.js";import{connectViewSocket as a}from"../runtime/view-socket.js";import{classify as E}from"../fault-classifier.js";import{clearNodeFault as F,recordNodeFault as p}from"../runtime/broker/daemon-ops.js";import{emitEvent as c}from"../events/emit.js";import{CLIENT_READ_CAPS as l,encodeFrame as v,FrameDecoder as h,FrameOverflowError as w}from"../runtime/broker-protocol.js";import{BrokerUnavailableError as b}from"./transport.js";class U extends u{static{d(this,"SocketTransport")}nodeId;options;socket;decoder=new h(l);closeEmitted=!1;redialFaultRecorded=!1;constructor(e,t={}){super(),this.nodeId=e,this.options=t}get socketPath(){return k(this.nodeId)}recordSocketFault(e,t){if(this.options.recordsViewerFaults===!1)return;if(e==="redial"){if(this.redialFaultRecorded)return;this.redialFaultRecorded=!0}const o=E("viewer\u2194broker",t);p(this.nodeId,{link:"viewer\u2194broker",op:e,kind:o.kind,retry:e==="redial"?{disposition:"auto",by:"client"}:{disposition:"manual"},message:t instanceof Error?t.message:String(t)}).catch(r=>{c({event:"broker.daemon.operation.failed",level:"error",node_id:this.nodeId,error:r,fields:{operation:"viewer_fault_record"}})})}connect(){const e=a(this.nodeId);this.socket=e,e.on("connect",()=>{this.redialFaultRecorded=!1,this.clearSocketFault(),this.emit("connect")}),e.on("data",t=>this.onData(t)),e.on("error",t=>this.onError(t,"connect")),e.on("close",()=>this.onClose())}redial(e={}){return this.destroy(),this.decoder=new h(l),this.closeEmitted=!1,e.brokerUnavailableIsExpected&&(this.redialFaultRecorded=!1,this.clearSocketFault()),new Promise((t,o)=>{const r=a(this.nodeId);this.socket=r;let s=!1;r.on("connect",()=>{s||(s=!0,this.redialFaultRecorded=!1,this.clearSocketFault(),this.emit("connect"),t())}),r.on("data",i=>this.onData(i)),r.on("error",i=>{if(s){this.onError(i,"redial");return}s=!0;const f=i.code==="ECONNREFUSED"||i.code==="ENOENT";(!e.brokerUnavailableIsExpected||!f)&&this.recordSocketFault("redial",i);try{r.destroy()}catch{}o(i)}),r.on("close",()=>this.onClose())})}send(e){const t=this.socket;if(!(t===void 0||t.destroyed))try{t.write(v(e))}catch{}}destroy(){const e=this.socket;if(e!==void 0&&!e.destroyed)try{e.destroy()}catch{}}clearSocketFault(){this.options.recordsViewerFaults!==!1&&F(this.nodeId,{link:"viewer\u2194broker"}).catch(e=>{c({event:"broker.daemon.operation.failed",level:"error",node_id:this.nodeId,error:e,fields:{operation:"viewer_fault_clear"}})})}onData(e){let t;try{t=this.decoder.push(e)}catch(o){const r=o instanceof w?`broker sent an oversized frame (${o.message}) \u2014 disconnecting`:`failed to decode a broker frame: ${String(o)}`;this.emitError(new Error(r)),this.destroy();return}for(const o of t)this.emit("frame",o)}onError(e,t){this.recordSocketFault(t,e),e.code==="ECONNREFUSED"||e.code==="ENOENT"?this.emitError(new b(this.nodeId)):this.emitError(new Error(`view socket error: ${e.message}`))}onClose(){this.closeEmitted||(this.closeEmitted=!0,this.emit("close"))}emitError(e){this.listenerCount("error")>0&&this.emit("error",e)}}export{U as SocketTransport};

package/dist/core/canvas/canvas.d.ts

@@ -1,3 +1,4 @@
+import type { DatabaseSync } from 'node:sqlite';
 import type { ExitIntent, Lifecycle, Mode, NodeIdentity, NodeMemoryTarget, NodeMeta, NodeOutcomeKind, NodeRow, NodeStatus, SubscriptionRef, TerminalReason } from './types.js';
 export interface OutcomeDeliveryBinding {
     actionName: string;
@@ -6,9 +7,11 @@ export interface OutcomeDeliveryBinding {
     configOrigin: string;
     payload?: unknown;
 }
+export declare function assertRunNotDeleting(db: DatabaseSync, runId: string): void;
 /** Create a SQL-authoritative node, then ensure its artifact directories exist. */
 export declare function createNode(meta: NodeMeta, opts?: {
     outcomeDelivery?: OutcomeDeliveryBinding;
+    withinCreate?: (db: DatabaseSync, row: NodeMeta) => void;
 }): NodeMeta;
 /** The canonical node record, hydrated from SQL. Null if unknown. */
 export declare function getNode(nodeId: string): NodeMeta | null;
@@ -28,6 +31,12 @@ export declare function dueNodeDeadlines(nowIso: string): NodeRow[];
 export declare function setNodeDeadline(nodeId: string, deadlineAt: string | null): boolean;
 /** Shift active/idle profile deadlines by a completed profile pause duration. */
 export declare function shiftProfileNodeDeadlines(profileId: string, pauseDurationMs: number): number;
+/** OWN-11 for a joined runtime: a `user:local` subject becomes the owner, a
+ *  `user:local` grantee becomes `app:terminal` (no node has the owner as grantee),
+ *  a terminal node born before the local grant mirror (no subject) gets the owner,
+ *  and a reference to the dropped local grant is cleared so the node resolves the
+ *  synced grant by grantee and subject. */
+export declare function rewriteLocalNodeIdentity(db: DatabaseSync, owner: string, localGrantId: string): number;
 type NodeUpdate = Partial<Omit<NodeIdentity, 'node_id' | 'pi_session_id' | 'pi_session_file' | 'managed_worktree'>>;
 /** Update node identity/configuration columns. Sessions and worktrees have named stores. */
 export declare function updateNode(nodeId: string, patch: NodeUpdate): NodeMeta;
@@ -56,7 +65,7 @@ export declare function transitionStatusIntent(nodeId: string, fields: {
         reason: TerminalReason;
         detailJson: string | null;
         at: string;
-        /** Canonical-final only: replace a prior failure outcome. */
+        /** Replace a prior outcome after a run resumes or when its final is committed. */
         supersede?: boolean;
         /** The document composed at outcome time for an armed delivery. */
         documentJson?: string | null;
@@ -328,6 +337,15 @@ export declare function isCollectible(row: NodeRow, opts?: {
 export interface DeleteNodeResult {
     deleted: boolean;
 }
+/** A node's files, located while its row still names its app. */
+export interface NodeFiles {
+    nodeId: string;
+    app: string | null;
+}
+export declare function nodeFiles(nodeId: string): NodeFiles;
+/** Remove every directory a deleted node owned. A conversation another node
+ *  still references keeps its file, and so its conversations directory. */
+export declare function removeNodeFiles(files: NodeFiles): void;
 /** Hard-delete ONE node: drop its row (the edges→nodes FK, ON DELETE CASCADE,
  *  GCs its edges) and remove its on-disk `nodes/<id>/` dir. The single-node
  *  analogue of {@link pruneNodes}, for IMMEDIATE reaping — e.g. an empty node the
@@ -342,18 +360,17 @@ export declare function deleteNode(nodeId: string): DeleteNodeResult;
  *  their directories. The caller must tear down engines and viewers first. */
 export declare function deleteNodes(nodeIds: readonly string[]): string[];
 /** Retention sweep: remove TERMINAL nodes (status dead | done | canceled) whose
- *  `created` is older than `ttlDays`, bounding the otherwise-unbounded growth of
- *  node rows + dirs. Open managed-worktree nodes are retained so their checkout
- *  remains owned until `node worktree close`. The edges→nodes FK (`ON DELETE
+ *  last activity ({@link lastActivityMs}) is older than `ttlDays`, bounding the
+ *  otherwise-unbounded growth of node rows + dirs. Only {@link isCollectible}
+ *  rows qualify, and never one `held` claims. The edges→nodes FK (`ON DELETE
  *  CASCADE`, migration v4) GCs each pruned node's edges automatically; the
  *  on-disk `nodes/<id>/` dir is removed too.
  *
  *  With `includeStale`, ALSO prunes nominally-live (active | idle) nodes past the
- *  TTL whose process is provably gone — `pi_pid` is NULL or no longer alive. This
- *  reaps stale roots (a bare `crtr` whose pi died without the row transitioning),
- *  which the daemon's supervision never reconciled. A genuinely-running node keeps
- *  a live `pi_pid`, so it is protected, as is the CALLER ($CRTR_NODE_ID). Without
- *  the flag, active | idle are NEVER touched (the daemon's domain).
+ *  TTL whose process is provably gone and that nothing will bring back: no live
+ *  `pi_pid`, not sleeping until a wake (`idle-release`), no unseen wake mail,
+ *  not frozen, not in respawn backoff, not an app run, not held, and never the CALLER
+ *  ($CRTR_NODE_ID). Without the flag, active | idle are NEVER touched.
  *
  *  Row deletes run in ONE transaction, so the sweep is all-or-nothing. Dir
  *  removals follow after COMMIT — the fs isn't transactional, and by then
@@ -361,24 +378,28 @@ export declare function deleteNodes(nodeIds: readonly string[]): string[];
  *  reports the candidate set and deletes NOTHING. */
 export declare function pruneNodes(opts: {
     ttlDays: number;
+    held: (nodeId: string) => boolean;
     dryRun?: boolean;
     includeStale?: boolean;
+    removeDirs?: (dirs: string[]) => void;
 }): PruneResult;
-/** Count-based retention sweep: retain the `maxNodes` MOST-RECENTLY-ACTIVE
- *  nodes plus every row the collection authority retains, so the real retained
- *  floor is `max(maxNodes, retainedCount)`. Bounds the otherwise-unbounded growth
- *  the TTL sweep can't (a canvas that never crosses the TTL still grows without
- *  limit).
- *
- *  Algorithm: order ALL nodes by recency DESC (telemetry.json mtime, falling back
- *  to `created`); `target = max(maxNodes, retainedCount)`; delete every node
- *  ranked beyond `target` (0-indexed rank >= target) that is collectible.
+/** A node's most recent activity (epoch ms): the latest of its lifecycle
+ *  timestamps (created, launched, settled, finalized, outcome, last run event)
+ *  and the mtime of `job/telemetry.json`, which every turn_end rewrites. 0 when
+ *  none is readable. The single clock every retention decision uses. Never throws. */
+export declare function lastActivityMs(row: Pick<NodeRow, 'node_id' | 'created' | 'launched_at' | 'last_settled_at' | 'finalized_at' | 'outcome_at' | 'last_activity_at'>): number;
+/** Count-based retention sweep: keep every row that is not collectible or that
+ *  `held` claims, plus the most recently active collectible rows up to
+ *  `maxNodes` in total, so the real retained floor is `max(maxNodes,
+ *  retainedCount)`. Bounds the growth the TTL sweep can't (a canvas that never
+ *  crosses the TTL still grows without limit). Recency is {@link lastActivityMs}.
  *
  *  Mirrors {@link pruneNodes} exactly for the delete (shared `deletePrunedNodes`:
  *  transactioned row sweep + FK edge cascade + best-effort dir removal). `dryRun`
  *  reports the candidate set and deletes NOTHING. */
 export declare function pruneToLimit(opts: {
     maxNodes: number;
+    held: (nodeId: string) => boolean;
     dryRun?: boolean;
 }): PruneResult;
 export {};