claude-code-session-manager 0.96.0 → 0.98.0

package/dist/assets/{settingsSchema-BIvDZ1Cj.js → settingsSchema-IhUfucCF.js}

@@ -1 +1 @@
-import{az as b,ak as n,S as N,aR as k,ax as K}from"./index-XkrLB67D.js";function T({node:e,targetScope:r,onOverride:s,schema:a,rootLabel:m}){const[f,x]=b.useState(""),[u,o]=b.useState(!0),g=[],d=e.kind==="object"&&Object.keys(e.children).length===0,y=((a==null?void 0:a.rootKeys())??[]).length>0;return n.jsxs("div",{className:"h-full flex flex-col",children:[n.jsxs("div",{className:"shrink-0 border-b border-line bg-bg-elev px-3 py-1.5 flex items-center gap-2 text-xs",children:[n.jsxs("span",{className:"text-fg-faint",children:["merged · overrides → ",n.jsx("span",{className:"text-fg-dim",children:N[r].label})]}),y&&n.jsxs("label",{className:"flex items-center gap-1 text-fg-faint cursor-pointer",children:[n.jsx("input",{type:"checkbox",checked:u,onChange:t=>o(t.target.checked),className:"accent-accent"}),"show unset keys"]}),n.jsx("div",{className:"flex-1"}),n.jsx("input",{value:f,onChange:t=>x(t.target.value),placeholder:"filter keys or descriptions…",className:"bg-bg border border-line rounded px-2 py-0.5 text-xs text-fg w-56"})]}),n.jsx("div",{className:"flex-1 overflow-auto px-3 py-2 font-mono text-xs",children:d&&!u?n.jsx("div",{className:"text-fg-faint italic px-2 py-4",children:"no settings resolved — all scope files empty or missing"}):n.jsx(E,{node:e,path:g,label:m??"(root)",targetScope:r,onOverride:s,filter:f,depth:0,schema:a,showGhosts:u,defaultOpen:!0})})]})}function E(e){return e.node.kind==="object"?n.jsx(P,{...e,node:e.node}):e.node.kind==="array"?n.jsx(R,{...e,node:e.node}):n.jsx(J,{...e,node:e.node})}function A(e,r){return r.trim()?e.toLowerCase().includes(r.toLowerCase()):!0}function w(e,r,s){return!!(!s.trim()||e.some(a=>A(a,s))||r!=null&&r.description&&A(r.description,s))}function P({node:e,path:r,label:s,targetScope:a,onOverride:m,filter:f,depth:x,schema:u,showGhosts:o,defaultOpen:g}){const[d,h]=b.useState(g??x<2),y=(u==null?void 0:u.at(r))??null,t=new Set(Object.keys(e.children)),i=o?(y==null?void 0:y.knownChildren)??[]:[],c=Array.from(new Set([...t,...i])).sort(),l=b.useMemo(()=>f.trim()?c.filter(p=>{const v=(u==null?void 0:u.at([...r,p]))??null;return w([...r,p],v,f)?!0:t.has(p)?L(e.children[p],[...r,p],f,u):!1}):c,[c.join(","),f,e,r.join("."),u]);if(f.trim()&&l.length===0&&!w(r,y,f))return null;if(r.length===0)return n.jsx("div",{children:l.map(p=>j(p))});return n.jsxs("div",{children:[n.jsxs("div",{className:"flex items-center gap-1 py-0.5 hover:bg-bg-elev/50 rounded cursor-pointer",style:{paddingLeft:x*14},onClick:()=>h(!d),children:[n.jsx("span",{className:"text-fg-faint w-3 shrink-0",children:d?"▾":"▸"}),n.jsx("span",{className:"text-fg",children:s}),n.jsxs("span",{className:"text-fg-faint",children:[" {",t.size,i.length>t.size?`/${new Set([...t,...i]).size}`:"","}"]}),(y==null?void 0:y.description)&&n.jsxs("span",{className:"text-fg-faint truncate max-w-md",title:y.description,children:["— ",y.description]})]}),d&&l.map(p=>j(p))]});function j(p){if(t.has(p))return n.jsx(E,{node:e.children[p],path:[...r,p],label:p,targetScope:a,onOverride:m,filter:f,depth:x+1,schema:u,showGhosts:o},p);const v=(u==null?void 0:u.at([...r,p]))??null;return v?n.jsx(I,{path:[...r,p],label:p,info:v,targetScope:a,onSet:m,depth:x+1,filter:f},p):null}}function L(e,r,s,a){const m=(a==null?void 0:a.at(r))??null;if(w(r,m,s))return!0;if(e.kind!=="object")return!1;for(const f of Object.keys(e.children))if(L(e.children[f],[...r,f],s,a))return!0;return!1}function R({node:e,path:r,label:s,filter:a,depth:m,schema:f}){const[x,u]=b.useState(!0),o=(f==null?void 0:f.at(r))??null;return w(r,o,a)?n.jsxs("div",{children:[n.jsxs("div",{className:"flex items-center gap-1 py-0.5 hover:bg-bg-elev/50 rounded cursor-pointer",style:{paddingLeft:m*14},onClick:()=>u(!x),children:[n.jsx("span",{className:"text-fg-faint w-3 shrink-0",children:x?"▾":"▸"}),n.jsx("span",{className:"text-fg",children:s}),n.jsxs("span",{className:"text-fg-faint",children:[" [",e.items.length,"]"]}),n.jsx(S,{tone:"warn",children:"accumulated"}),(o==null?void 0:o.description)&&n.jsxs("span",{className:"text-fg-faint truncate max-w-md",title:o.description,children:["— ",o.description]})]}),x&&e.items.map((g,d)=>n.jsxs("div",{className:"flex items-start gap-2 py-0.5",style:{paddingLeft:(m+1)*14},children:[n.jsx("span",{className:"text-fg-faint w-3 shrink-0"}),n.jsxs("span",{className:"text-fg-faint",children:[d,":"]}),n.jsx("span",{className:"text-fg-dim truncate max-w-xl",children:O(g.value)}),n.jsx(C,{scope:g.fromScope})]},d))]}):null}function J({node:e,path:r,label:s,targetScope:a,onOverride:m,filter:f,depth:x,schema:u}){const[o,g]=b.useState(!1),d=(u==null?void 0:u.at(r))??null;if(!w(r,d,f))return null;const h=e.winner!==a,y=e.shadowed.length>0;return n.jsxs("div",{children:[n.jsxs("div",{className:"group flex items-center gap-2 py-0.5 hover:bg-bg-elev/50 rounded",style:{paddingLeft:x*14},children:[n.jsx("span",{className:`w-3 shrink-0 ${y?"text-fg-faint cursor-pointer":""}`,onClick:()=>y&&g(!o),children:y?o?"▾":"▸":""}),n.jsxs("span",{className:"text-fg",children:[s,":"]}),n.jsx("span",{className:"text-fg-dim truncate max-w-md",children:O(e.value)}),n.jsx(C,{scope:e.winner}),(d==null?void 0:d.deprecated)&&n.jsx(S,{tone:"warn",children:"deprecated"}),(d==null?void 0:d.default)!==void 0&&_(e.value,d.default)&&n.jsx(S,{tone:"dim",children:"= default"}),e.typeMismatch&&n.jsx("span",{className:"text-yellow-500/80",title:"shadowed scopes have a different value type",children:"⚠"}),(d==null?void 0:d.description)&&n.jsxs("span",{className:"text-fg-faint truncate max-w-md",title:d.description,children:["— ",d.description]}),n.jsx("div",{className:"flex-1"}),(d==null?void 0:d.enum)&&n.jsx(F,{values:d.enum}),n.jsx("button",{disabled:!h,onClick:()=>m(r,e.value),className:`opacity-0 group-hover:opacity-100 px-1.5 py-0 text-[10px] border rounded transition-opacity ${h?"border-accent/50 text-accent hover:bg-accent hover:text-bg":"border-line text-fg-faint cursor-not-allowed"}`,title:h?`copy into ${N[a].label} draft`:`already winning in ${N[a].label}`,children:"override"})]}),o&&e.shadowed.map((t,i)=>n.jsxs("div",{className:"flex items-center gap-2 py-0.5 text-fg-faint line-through",style:{paddingLeft:(x+1)*14+12},children:[n.jsx("span",{children:"shadowed:"}),n.jsx("span",{className:"truncate max-w-xl",children:O(t.value)}),n.jsx(C,{scope:t.scope,dim:!0})]},i))]})}function I({path:e,label:r,info:s,targetScope:a,onSet:m,depth:f,filter:x}){if(!w(e,s,x))return null;const u=s.default!==void 0?s.default:M(s.type),o=Array.isArray(s.type)?s.type.join("|"):s.type??"?";return n.jsxs("div",{className:"group flex items-center gap-2 py-0.5 hover:bg-bg-elev/50 rounded opacity-60",style:{paddingLeft:f*14},children:[n.jsx("span",{className:"w-3 shrink-0"}),n.jsx("span",{className:"text-fg-dim",children:r}),n.jsx(S,{tone:"dim",children:o}),s.required&&n.jsx(S,{tone:"warn",children:"required"}),s.default!==void 0&&n.jsxs("span",{className:"text-fg-faint",children:["default: ",O(s.default)]}),s.description&&n.jsxs("span",{className:"text-fg-faint truncate max-w-md",title:s.description,children:["— ",s.description]}),n.jsx("div",{className:"flex-1"}),s.enum&&n.jsx(F,{values:s.enum}),n.jsx("button",{onClick:()=>m(e,u),className:"opacity-0 group-hover:opacity-100 px-1.5 py-0 text-[10px] border border-accent/50 rounded text-accent hover:bg-accent hover:text-bg transition-opacity",title:`write to ${N[a].label} draft`,children:"set"})]})}function _(e,r){return e===r?!0:typeof e!=typeof r?!1:e&&r&&typeof e=="object"?JSON.stringify(e)===JSON.stringify(r):!1}function M(e){switch(Array.isArray(e)?e[0]:e){case"boolean":return!1;case"integer":case"number":return 0;case"string":return"";case"array":return[];case"object":return{};case"null":return null;default:return null}}function O(e){if(typeof e=="string")return JSON.stringify(e);if(e===null)return"null";if(typeof e=="object"){const r=JSON.stringify(e);return r.length>100?r.slice(0,100)+"…":r}return String(e)}function C({scope:e,dim:r}){const s=e==="user"?"bg-bg-hi text-fg-dim border-line":e==="project"?"bg-blue-950/30 text-blue-400/80 border-blue-900/40":"bg-purple-950/30 text-purple-400/80 border-purple-900/40";return n.jsx("span",{className:`text-[10px] px-1 py-0 rounded border uppercase tracking-wide shrink-0 ${s} ${r?"opacity-60":""}`,children:N[e].label})}function S({children:e,tone:r="default"}){const s={default:"bg-bg-hi text-fg-dim border-line",warn:"bg-yellow-950/30 text-yellow-500/80 border-yellow-900/40",dim:"bg-bg-elev text-fg-faint border-line"}[r];return n.jsx("span",{className:`text-[10px] px-1 py-0 rounded border uppercase tracking-wide shrink-0 ${s}`,children:e})}function F({values:e}){const r=e.map(s=>String(s)).join(" | ");return n.jsxs("span",{className:"text-[10px] text-fg-faint truncate max-w-xs",title:`allowed: ${r}`,children:["∈ ",r.length>30?r.slice(0,30)+"…":r]})}function G(e,r,s){const a=k(o=>o.files),m=k(o=>o.loadJson),f=k(o=>o.watchFile),x=k(o=>o.unwatchFile),u=b.useMemo(()=>{const o={};for(const g of e.scopes){const d=e.resolve(g,r??"",s);d&&(o[g]=d)}return o},[e,r,s]);return b.useEffect(()=>{const o=Object.values(u).filter(Boolean);return o.forEach(g=>{a[g]||m(g),f(g)}),()=>{o.forEach(g=>x(g))}},[JSON.stringify(u)]),u}function z(e){const r=e??{},s={...r.$defs??{},...r.definitions??{}},a=t=>{if(!t)return{};if(!t.$ref)return x(t);const i=/^#\/(\$defs|definitions)\/(.+)$/.exec(t.$ref);if(!i)return x(t);const c=s[i[2]];return c?a({...c,...u(t)}):x(t)},m=new Set(["__proto__","constructor","prototype"]),f=t=>{if(!t)return{};const i={};for(const[c,l]of Object.entries(t))m.has(c)||(i[c]=l);return i},x=t=>{if(!t.allOf||t.allOf.length===0)return t;const i={...t};delete i.allOf;for(const c of t.allOf){const l=a(c);Object.assign(i,{properties:{...f(i.properties),...f(l.properties)},required:B([...i.required??[],...l.required??[]])}),!i.description&&l.description&&(i.description=l.description),i.default===void 0&&l.default!==void 0&&(i.default=l.default),!i.type&&l.type&&(i.type=l.type)}return i},u=t=>{const{$ref:i,...c}=t;return c},o=(t,i)=>{let c=a(t);for(const l of i){if(!c)return null;if(/^\d+$/.test(l)){const v=Array.isArray(c.items)?c.items[Number(l)]:c.items;c=v?a(v):null;continue}const j=c.properties;if(j&&!m.has(l)&&l in j){c=a(j[l]);continue}const p=c.additionalProperties;if(p&&typeof p=="object"){c=a(p);continue}return null}return c},g=(t,i,c)=>{if(!t)return null;const l={};if(t.description&&(l.description=t.description),t.type&&(l.type=t.type),t.default!==void 0&&(l.default=t.default),t.enum&&(l.enum=t.enum),t.const!==void 0&&(l.const=t.const),t.deprecated&&(l.deprecated=!0),t.examples&&(l.examples=t.examples),t.properties&&(l.knownChildren=Object.keys(t.properties)),c&&(i!=null&&i.includes(c))&&(l.required=!0),t.items&&!Array.isArray(t.items)){const j=a(t.items),p=g(j,void 0,null);p&&(l.itemsInfo=p)}return(t.additionalProperties===!0||typeof t.additionalProperties=="object")&&(l.open=!0),l},d=t=>i=>{if(i.length===0)return g(a(t),void 0,null);const c=o(t,i.slice(0,-1));if(!c)return null;const l=i[i.length-1],j=o(c,[l]);return g(j,c.required,l)},h=t=>{const i=a(t);return Object.keys(i.properties??{})},y=t=>({at:d(t),rootKeys:()=>h(t),rootedAt:i=>{const c=o(t,i);return y(c??{})}});return y(r)}function B(e){return Array.from(new Set(e))}let $=null;function V(){return $||($=z(K)),$}export{T as E,V as s,G as u};
+import{az as b,ak as n,S as N,aR as k,ax as K}from"./index-Cd98Q1lD.js";function T({node:e,targetScope:r,onOverride:s,schema:a,rootLabel:m}){const[f,x]=b.useState(""),[u,o]=b.useState(!0),g=[],d=e.kind==="object"&&Object.keys(e.children).length===0,y=((a==null?void 0:a.rootKeys())??[]).length>0;return n.jsxs("div",{className:"h-full flex flex-col",children:[n.jsxs("div",{className:"shrink-0 border-b border-line bg-bg-elev px-3 py-1.5 flex items-center gap-2 text-xs",children:[n.jsxs("span",{className:"text-fg-faint",children:["merged · overrides → ",n.jsx("span",{className:"text-fg-dim",children:N[r].label})]}),y&&n.jsxs("label",{className:"flex items-center gap-1 text-fg-faint cursor-pointer",children:[n.jsx("input",{type:"checkbox",checked:u,onChange:t=>o(t.target.checked),className:"accent-accent"}),"show unset keys"]}),n.jsx("div",{className:"flex-1"}),n.jsx("input",{value:f,onChange:t=>x(t.target.value),placeholder:"filter keys or descriptions…",className:"bg-bg border border-line rounded px-2 py-0.5 text-xs text-fg w-56"})]}),n.jsx("div",{className:"flex-1 overflow-auto px-3 py-2 font-mono text-xs",children:d&&!u?n.jsx("div",{className:"text-fg-faint italic px-2 py-4",children:"no settings resolved — all scope files empty or missing"}):n.jsx(E,{node:e,path:g,label:m??"(root)",targetScope:r,onOverride:s,filter:f,depth:0,schema:a,showGhosts:u,defaultOpen:!0})})]})}function E(e){return e.node.kind==="object"?n.jsx(P,{...e,node:e.node}):e.node.kind==="array"?n.jsx(R,{...e,node:e.node}):n.jsx(J,{...e,node:e.node})}function A(e,r){return r.trim()?e.toLowerCase().includes(r.toLowerCase()):!0}function w(e,r,s){return!!(!s.trim()||e.some(a=>A(a,s))||r!=null&&r.description&&A(r.description,s))}function P({node:e,path:r,label:s,targetScope:a,onOverride:m,filter:f,depth:x,schema:u,showGhosts:o,defaultOpen:g}){const[d,h]=b.useState(g??x<2),y=(u==null?void 0:u.at(r))??null,t=new Set(Object.keys(e.children)),i=o?(y==null?void 0:y.knownChildren)??[]:[],c=Array.from(new Set([...t,...i])).sort(),l=b.useMemo(()=>f.trim()?c.filter(p=>{const v=(u==null?void 0:u.at([...r,p]))??null;return w([...r,p],v,f)?!0:t.has(p)?L(e.children[p],[...r,p],f,u):!1}):c,[c.join(","),f,e,r.join("."),u]);if(f.trim()&&l.length===0&&!w(r,y,f))return null;if(r.length===0)return n.jsx("div",{children:l.map(p=>j(p))});return n.jsxs("div",{children:[n.jsxs("div",{className:"flex items-center gap-1 py-0.5 hover:bg-bg-elev/50 rounded cursor-pointer",style:{paddingLeft:x*14},onClick:()=>h(!d),children:[n.jsx("span",{className:"text-fg-faint w-3 shrink-0",children:d?"▾":"▸"}),n.jsx("span",{className:"text-fg",children:s}),n.jsxs("span",{className:"text-fg-faint",children:[" {",t.size,i.length>t.size?`/${new Set([...t,...i]).size}`:"","}"]}),(y==null?void 0:y.description)&&n.jsxs("span",{className:"text-fg-faint truncate max-w-md",title:y.description,children:["— ",y.description]})]}),d&&l.map(p=>j(p))]});function j(p){if(t.has(p))return n.jsx(E,{node:e.children[p],path:[...r,p],label:p,targetScope:a,onOverride:m,filter:f,depth:x+1,schema:u,showGhosts:o},p);const v=(u==null?void 0:u.at([...r,p]))??null;return v?n.jsx(I,{path:[...r,p],label:p,info:v,targetScope:a,onSet:m,depth:x+1,filter:f},p):null}}function L(e,r,s,a){const m=(a==null?void 0:a.at(r))??null;if(w(r,m,s))return!0;if(e.kind!=="object")return!1;for(const f of Object.keys(e.children))if(L(e.children[f],[...r,f],s,a))return!0;return!1}function R({node:e,path:r,label:s,filter:a,depth:m,schema:f}){const[x,u]=b.useState(!0),o=(f==null?void 0:f.at(r))??null;return w(r,o,a)?n.jsxs("div",{children:[n.jsxs("div",{className:"flex items-center gap-1 py-0.5 hover:bg-bg-elev/50 rounded cursor-pointer",style:{paddingLeft:m*14},onClick:()=>u(!x),children:[n.jsx("span",{className:"text-fg-faint w-3 shrink-0",children:x?"▾":"▸"}),n.jsx("span",{className:"text-fg",children:s}),n.jsxs("span",{className:"text-fg-faint",children:[" [",e.items.length,"]"]}),n.jsx(S,{tone:"warn",children:"accumulated"}),(o==null?void 0:o.description)&&n.jsxs("span",{className:"text-fg-faint truncate max-w-md",title:o.description,children:["— ",o.description]})]}),x&&e.items.map((g,d)=>n.jsxs("div",{className:"flex items-start gap-2 py-0.5",style:{paddingLeft:(m+1)*14},children:[n.jsx("span",{className:"text-fg-faint w-3 shrink-0"}),n.jsxs("span",{className:"text-fg-faint",children:[d,":"]}),n.jsx("span",{className:"text-fg-dim truncate max-w-xl",children:O(g.value)}),n.jsx(C,{scope:g.fromScope})]},d))]}):null}function J({node:e,path:r,label:s,targetScope:a,onOverride:m,filter:f,depth:x,schema:u}){const[o,g]=b.useState(!1),d=(u==null?void 0:u.at(r))??null;if(!w(r,d,f))return null;const h=e.winner!==a,y=e.shadowed.length>0;return n.jsxs("div",{children:[n.jsxs("div",{className:"group flex items-center gap-2 py-0.5 hover:bg-bg-elev/50 rounded",style:{paddingLeft:x*14},children:[n.jsx("span",{className:`w-3 shrink-0 ${y?"text-fg-faint cursor-pointer":""}`,onClick:()=>y&&g(!o),children:y?o?"▾":"▸":""}),n.jsxs("span",{className:"text-fg",children:[s,":"]}),n.jsx("span",{className:"text-fg-dim truncate max-w-md",children:O(e.value)}),n.jsx(C,{scope:e.winner}),(d==null?void 0:d.deprecated)&&n.jsx(S,{tone:"warn",children:"deprecated"}),(d==null?void 0:d.default)!==void 0&&_(e.value,d.default)&&n.jsx(S,{tone:"dim",children:"= default"}),e.typeMismatch&&n.jsx("span",{className:"text-yellow-500/80",title:"shadowed scopes have a different value type",children:"⚠"}),(d==null?void 0:d.description)&&n.jsxs("span",{className:"text-fg-faint truncate max-w-md",title:d.description,children:["— ",d.description]}),n.jsx("div",{className:"flex-1"}),(d==null?void 0:d.enum)&&n.jsx(F,{values:d.enum}),n.jsx("button",{disabled:!h,onClick:()=>m(r,e.value),className:`opacity-0 group-hover:opacity-100 px-1.5 py-0 text-[10px] border rounded transition-opacity ${h?"border-accent/50 text-accent hover:bg-accent hover:text-bg":"border-line text-fg-faint cursor-not-allowed"}`,title:h?`copy into ${N[a].label} draft`:`already winning in ${N[a].label}`,children:"override"})]}),o&&e.shadowed.map((t,i)=>n.jsxs("div",{className:"flex items-center gap-2 py-0.5 text-fg-faint line-through",style:{paddingLeft:(x+1)*14+12},children:[n.jsx("span",{children:"shadowed:"}),n.jsx("span",{className:"truncate max-w-xl",children:O(t.value)}),n.jsx(C,{scope:t.scope,dim:!0})]},i))]})}function I({path:e,label:r,info:s,targetScope:a,onSet:m,depth:f,filter:x}){if(!w(e,s,x))return null;const u=s.default!==void 0?s.default:M(s.type),o=Array.isArray(s.type)?s.type.join("|"):s.type??"?";return n.jsxs("div",{className:"group flex items-center gap-2 py-0.5 hover:bg-bg-elev/50 rounded opacity-60",style:{paddingLeft:f*14},children:[n.jsx("span",{className:"w-3 shrink-0"}),n.jsx("span",{className:"text-fg-dim",children:r}),n.jsx(S,{tone:"dim",children:o}),s.required&&n.jsx(S,{tone:"warn",children:"required"}),s.default!==void 0&&n.jsxs("span",{className:"text-fg-faint",children:["default: ",O(s.default)]}),s.description&&n.jsxs("span",{className:"text-fg-faint truncate max-w-md",title:s.description,children:["— ",s.description]}),n.jsx("div",{className:"flex-1"}),s.enum&&n.jsx(F,{values:s.enum}),n.jsx("button",{onClick:()=>m(e,u),className:"opacity-0 group-hover:opacity-100 px-1.5 py-0 text-[10px] border border-accent/50 rounded text-accent hover:bg-accent hover:text-bg transition-opacity",title:`write to ${N[a].label} draft`,children:"set"})]})}function _(e,r){return e===r?!0:typeof e!=typeof r?!1:e&&r&&typeof e=="object"?JSON.stringify(e)===JSON.stringify(r):!1}function M(e){switch(Array.isArray(e)?e[0]:e){case"boolean":return!1;case"integer":case"number":return 0;case"string":return"";case"array":return[];case"object":return{};case"null":return null;default:return null}}function O(e){if(typeof e=="string")return JSON.stringify(e);if(e===null)return"null";if(typeof e=="object"){const r=JSON.stringify(e);return r.length>100?r.slice(0,100)+"…":r}return String(e)}function C({scope:e,dim:r}){const s=e==="user"?"bg-bg-hi text-fg-dim border-line":e==="project"?"bg-blue-950/30 text-blue-400/80 border-blue-900/40":"bg-purple-950/30 text-purple-400/80 border-purple-900/40";return n.jsx("span",{className:`text-[10px] px-1 py-0 rounded border uppercase tracking-wide shrink-0 ${s} ${r?"opacity-60":""}`,children:N[e].label})}function S({children:e,tone:r="default"}){const s={default:"bg-bg-hi text-fg-dim border-line",warn:"bg-yellow-950/30 text-yellow-500/80 border-yellow-900/40",dim:"bg-bg-elev text-fg-faint border-line"}[r];return n.jsx("span",{className:`text-[10px] px-1 py-0 rounded border uppercase tracking-wide shrink-0 ${s}`,children:e})}function F({values:e}){const r=e.map(s=>String(s)).join(" | ");return n.jsxs("span",{className:"text-[10px] text-fg-faint truncate max-w-xs",title:`allowed: ${r}`,children:["∈ ",r.length>30?r.slice(0,30)+"…":r]})}function G(e,r,s){const a=k(o=>o.files),m=k(o=>o.loadJson),f=k(o=>o.watchFile),x=k(o=>o.unwatchFile),u=b.useMemo(()=>{const o={};for(const g of e.scopes){const d=e.resolve(g,r??"",s);d&&(o[g]=d)}return o},[e,r,s]);return b.useEffect(()=>{const o=Object.values(u).filter(Boolean);return o.forEach(g=>{a[g]||m(g),f(g)}),()=>{o.forEach(g=>x(g))}},[JSON.stringify(u)]),u}function z(e){const r=e??{},s={...r.$defs??{},...r.definitions??{}},a=t=>{if(!t)return{};if(!t.$ref)return x(t);const i=/^#\/(\$defs|definitions)\/(.+)$/.exec(t.$ref);if(!i)return x(t);const c=s[i[2]];return c?a({...c,...u(t)}):x(t)},m=new Set(["__proto__","constructor","prototype"]),f=t=>{if(!t)return{};const i={};for(const[c,l]of Object.entries(t))m.has(c)||(i[c]=l);return i},x=t=>{if(!t.allOf||t.allOf.length===0)return t;const i={...t};delete i.allOf;for(const c of t.allOf){const l=a(c);Object.assign(i,{properties:{...f(i.properties),...f(l.properties)},required:B([...i.required??[],...l.required??[]])}),!i.description&&l.description&&(i.description=l.description),i.default===void 0&&l.default!==void 0&&(i.default=l.default),!i.type&&l.type&&(i.type=l.type)}return i},u=t=>{const{$ref:i,...c}=t;return c},o=(t,i)=>{let c=a(t);for(const l of i){if(!c)return null;if(/^\d+$/.test(l)){const v=Array.isArray(c.items)?c.items[Number(l)]:c.items;c=v?a(v):null;continue}const j=c.properties;if(j&&!m.has(l)&&l in j){c=a(j[l]);continue}const p=c.additionalProperties;if(p&&typeof p=="object"){c=a(p);continue}return null}return c},g=(t,i,c)=>{if(!t)return null;const l={};if(t.description&&(l.description=t.description),t.type&&(l.type=t.type),t.default!==void 0&&(l.default=t.default),t.enum&&(l.enum=t.enum),t.const!==void 0&&(l.const=t.const),t.deprecated&&(l.deprecated=!0),t.examples&&(l.examples=t.examples),t.properties&&(l.knownChildren=Object.keys(t.properties)),c&&(i!=null&&i.includes(c))&&(l.required=!0),t.items&&!Array.isArray(t.items)){const j=a(t.items),p=g(j,void 0,null);p&&(l.itemsInfo=p)}return(t.additionalProperties===!0||typeof t.additionalProperties=="object")&&(l.open=!0),l},d=t=>i=>{if(i.length===0)return g(a(t),void 0,null);const c=o(t,i.slice(0,-1));if(!c)return null;const l=i[i.length-1],j=o(c,[l]);return g(j,c.required,l)},h=t=>{const i=a(t);return Object.keys(i.properties??{})},y=t=>({at:d(t),rootKeys:()=>h(t),rootedAt:i=>{const c=o(t,i);return y(c??{})}});return y(r)}function B(e){return Array.from(new Set(e))}let $=null;function V(){return $||($=z(K)),$}export{T as E,V as s,G as u};

package/dist/index.html

@@ -7,7 +7,7 @@
     <link rel="preconnect" href="https://fonts.googleapis.com">
     <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
     <link href="https://fonts.googleapis.com/css2?family=Newsreader:ital,opsz,wght@0,6..72,400;0,6..72,500;0,6..72,600;0,6..72,700;1,6..72,400&family=Geist:wght@300;400;500;600;700&family=IBM+Plex+Mono:wght@400;500;600&display=swap" rel="stylesheet">
-    <script type="module" crossorigin src="./assets/index-XkrLB67D.js"></script>
+    <script type="module" crossorigin src="./assets/index-Cd98Q1lD.js"></script>
     <link rel="modulepreload" crossorigin href="./assets/monaco-editor-BW5C4Iv1.js">
     <link rel="stylesheet" crossorigin href="./assets/monaco-editor-BTnBOi8r.css">
     <link rel="stylesheet" crossorigin href="./assets/index-CKH5Uxik.css">

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-session-manager",
-  "version": "0.96.0",
+  "version": "0.98.0",
   "description": "Local cockpit for the Claude Code CLI — multi-tab terminal, full config surface, scheduler, voice dictation, and live observability.",
   "type": "module",
   "main": "src/main/index.cjs",
@@ -53,6 +53,7 @@
     "refresh:vad-assets": "node scripts/refresh-vad-assets.mjs",
     "health": "node src/main/health.cjs",
     "manual:check": "node web/manual/build.mjs --check",
+    "manual:readability": "node web/manual/readability.mjs",
     "manual:build": "node web/manual/build.mjs",
     "manual:figures": "xvfb-run -a node web/manual/capture-figures.mjs",
     "lint:selectors": "node scripts/check-unstable-selectors.cjs",

package/plugins/session-manager-dev/skills/builder/4-manual/SKILL.md

@@ -45,6 +45,8 @@ Edit the chapter HTML in `session-manager-operations/manual/chapters/`.
 
 Hard rules — these are the ones that protect a paying customer:
 
+- **Follow `manual/STYLE.md`** (voice, reading level, component vocabulary) — it is the single
+  writing contract for every chapter, revisions included.
 - **Every claim must be checkable against real code right now.** Read the file, run the
   command, confirm the constant. A wrong instruction in a paid product is a refund.
 - **Never invent a screenshot.** A figure slot that has no captured image stays a

package/plugins/session-manager-dev/skills/develop/SKILL.md

@@ -204,7 +204,10 @@ can't load skills.
 
    **Every plan ends with one `validate` PRD.** After the work-item PRDs are written, author
    exactly one more through `scheduler_create_prd`: `agentType: "validator"`, `tag: "build"`,
-   `estimateMinutes: 10`, `dependsOn` = every other slug in this plan, slug
+   `estimateMinutes: 10`, `dependsOn` = every other slug in this plan (`dependsOn` is capped at
+   100 entries; for a plan bigger than that, list only the plan's sink PRDs — those nothing else
+   in the plan depends on — since `hasDownstreamValidator` walks `dependsOn` transitively, so a
+   validator anchored on the sinks alone still covers every upstream PRD), slug
    `validate-<short-plan-name>`. Its Goal lists the plan's PRD slugs and titles; its Acceptance
    criteria give, per PRD, where its file lives
    (`<cwd>/session-manager-operations/scheduler/epics/<epic-id>/prds/<NN>-<slug>.md` while queued,
@@ -215,8 +218,10 @@ can't load skills.
    While a plan has a pending validator, the scheduler suppresses both the per-PRD validation
    prompt into this session and the in-run `/code-review` steps for its work-items — one review,
    once, at the end. If `scheduler_create_prd` rejects `agentType: "validator"` (persona not
-   installed on this machine yet), say so and fall back to today's per-PRD validation; do not
-   hand-write the file.
+   installed on this machine yet — the usual cause is a running app older than 0.96.0, since the
+   validator persona is only seeded to `~/.claude/agents` on app boot), say so and fall back to
+   today's per-PRD validation; do not hand-write the file. Note the stale-app cause in your report
+   so the human knows to restart onto >=0.96.0.
 
    - **Sub-tasked Acceptance Criteria** (either shape, when a single PRD legitimately spans more
      than one concern dimension from step 3 — e.g. it has both core-functionality and
@@ -452,8 +457,10 @@ can't load skills.
 ## Phase 2 — Validation runs as its own job; this session only decides
 
 Every plan queued in Phase 1 ends with a `validate` PRD (agentType `validator`) whose
-`dependsOn` lists every other slug in the plan, so the scheduler runs it exactly once, after the
-last work-item lands. That job — not this session — re-runs each PRD's gate, checks every
+`dependsOn` lists every other slug in the plan — or, for a plan over the 100-entry cap, just the
+plan's sink PRDs, since `hasDownstreamValidator` walks `dependsOn` transitively and still credits
+every upstream PRD — so the scheduler runs it exactly once, after the last work-item lands.
+That job — not this session — re-runs each PRD's gate, checks every
 acceptance criterion against the tree, reviews the plan's combined diff (`/code-review`,
 `/security-review`), commits a review record, and ends with `VALIDATION: <slug>
 VERIFIED|REFUTED` per PRD. The scheduler appends one verdict event per PRD to this Epic (the

package/src/main/__tests__/ipcSchemas-dependsOn.test.cjs

@@ -0,0 +1,39 @@
+/**
+ * ipcSchemas-dependsOn.test.cjs — dependsOn array cap for schedulerCreatePrd
+ * (PRD: raise-dependson-cap-to-100). A /develop plan's validate PRD depends
+ * on every other slug in the plan, so the cap must clear a 36-PRD plan while
+ * still bounding an unbounded payload.
+ *
+ * Run: timeout 300 npx vitest run src/main/__tests__/ipcSchemas-dependsOn.test.cjs
+ */
+
+'use strict';
+
+import { test, expect } from 'vitest';
+const { schemas } = require('../ipcSchemas.cjs');
+
+const basePrd = {
+  title: 'validate the plan',
+  estimateMinutes: 5,
+  goal: 'Validate the plan',
+  acceptanceCriteria: ['it validates'],
+  implementationNotes: 'n/a',
+};
+
+test('schedulerCreatePrd accepts 36 dependsOn entries', () => {
+  const dependsOn = Array.from({ length: 36 }, (_, i) => `prd-${i}`);
+  const result = schemas.schedulerCreatePrd.safeParse({ ...basePrd, dependsOn });
+  expect(result.success).toBe(true);
+});
+
+test('schedulerCreatePrd rejects 101 dependsOn entries', () => {
+  const dependsOn = Array.from({ length: 101 }, (_, i) => `prd-${i}`);
+  const result = schemas.schedulerCreatePrd.safeParse({ ...basePrd, dependsOn });
+  expect(result.success).toBe(false);
+});
+
+test('schedulerCreatePrd accepts exactly 100 dependsOn entries', () => {
+  const dependsOn = Array.from({ length: 100 }, (_, i) => `prd-${i}`);
+  const result = schemas.schedulerCreatePrd.safeParse({ ...basePrd, dependsOn });
+  expect(result.success).toBe(true);
+});

package/src/main/__tests__/planValidator.test.cjs

@@ -69,3 +69,57 @@ test('false when the depending row is not agentType validator', () => {
   ];
   expect(hasDownstreamValidator(job, jobs)).toBe(false);
 });
+
+test('true when a pending validator reaches the job transitively via one sink (2-hop)', () => {
+  const job = { slug: '111-alpha' };
+  const jobs = [
+    job,
+    { slug: '150-sink', agentType: 'dev-lead', status: 'pending', dependsOn: ['111-alpha'] },
+    { slug: '999-validate', agentType: 'validator', status: 'pending', dependsOn: ['150-sink'] },
+  ];
+  expect(hasDownstreamValidator(job, jobs)).toBe(true);
+});
+
+test('true when a pending validator reaches the job transitively via two intermediate sinks (3-hop)', () => {
+  const job = { slug: '111-alpha' };
+  const jobs = [
+    job,
+    { slug: '140-mid', agentType: 'dev-lead', status: 'pending', dependsOn: ['111-alpha'] },
+    { slug: '150-sink', agentType: 'dev-lead', status: 'pending', dependsOn: ['140-mid'] },
+    { slug: '999-validate', agentType: 'validator', status: 'pending', dependsOn: ['150-sink'] },
+  ];
+  expect(hasDownstreamValidator(job, jobs)).toBe(true);
+});
+
+test('false when the validator only reaches an unrelated branch', () => {
+  const job = { slug: '111-alpha' };
+  const jobs = [
+    job,
+    { slug: '222-beta', agentType: 'dev-lead', status: 'pending', dependsOn: [] },
+    { slug: '150-sink', agentType: 'dev-lead', status: 'pending', dependsOn: ['222-beta'] },
+    { slug: '999-validate', agentType: 'validator', status: 'pending', dependsOn: ['150-sink'] },
+  ];
+  expect(hasDownstreamValidator(job, jobs)).toBe(false);
+});
+
+test('cycle in dependsOn terminates and returns false when the job is not reachable', () => {
+  const job = { slug: '111-alpha' };
+  const jobs = [
+    job,
+    { slug: '200-a', agentType: 'dev-lead', status: 'pending', dependsOn: ['201-b'] },
+    { slug: '201-b', agentType: 'dev-lead', status: 'pending', dependsOn: ['200-a'] },
+    { slug: '999-validate', agentType: 'validator', status: 'pending', dependsOn: ['200-a'] },
+  ];
+  expect(hasDownstreamValidator(job, jobs)).toBe(false);
+});
+
+test('false when a same-named validator/sink pair belongs to a different project (cwd)', () => {
+  const job = { slug: '011-alpha', cwd: '/projectA' };
+  const jobs = [
+    job,
+    { slug: '012-sink', cwd: '/projectA', agentType: 'dev-lead', status: 'pending', dependsOn: [] },
+    { slug: '512-sink', cwd: '/projectB', agentType: 'dev-lead', status: 'pending', dependsOn: ['011-alpha'] },
+    { slug: '999-validate', cwd: '/projectB', agentType: 'validator', status: 'pending', dependsOn: ['sink'] },
+  ];
+  expect(hasDownstreamValidator(job, jobs)).toBe(false);
+});

package/src/main/__tests__/prdCreateAdoption.test.cjs

@@ -0,0 +1,205 @@
+/**
+ * prdCreateAdoption.test.cjs — PRD 1446: scheduler_create_prd wrote a PRD
+ * file and promised its queue row "on the next reconcile pass (~1 minute)",
+ * but nothing reliably ran that pass. The 60s pollLoop only reaches
+ * reconcile() via maybeLaunchWhenAvailable, which returns early while zero
+ * rows are pending; the 10-minute rescheduleTimer awaits refreshNextReset()
+ * -> billing.fetchUsage() BEFORE reconciling, and stalled indefinitely while
+ * the usage meter was rate-limited (PRDs 1420-1441 sat unadopted 17+
+ * minutes, 2026-09-25).
+ *
+ * Two fixes, exercised here:
+ *  1. scheduler.remote gained `requestReconcile()` — the SAME broadcast
+ *     coalescer / reconcile() seam `remote.resetJob` already used (no
+ *     second reconcile implementation) — and prdCreate.cjs's createPrd()
+ *     calls it right after a successful write.
+ *  2. rescheduleTimer's refreshNextReset() await is now bounded by a
+ *     RESCHEDULE_TIMER_BILLING_RACE_MS Promise.race against the cached
+ *     reset value, so its own mutate(reconcile) still runs even when
+ *     billing.fetchUsage() never resolves.
+ *
+ * HOME-isolated + fixture-project pattern mirrors reconcileTiming.test.cjs.
+ *
+ * Run: timeout 300 npx vitest run src/main/__tests__/prdCreateAdoption.test.cjs
+ */
+
+'use strict';
+
+import {
+  test, expect, beforeAll, afterAll, afterEach, vi,
+} from 'vitest';
+const fs = require('node:fs');
+const os = require('node:os');
+const path = require('node:path');
+
+let tmpHome;
+let originalHome;
+let scheduler;
+let usage;
+let config;
+let createPrd;
+
+/** A bare cwd for the fake-remote createPrd() tests below — these don't go
+ *  through a real Epic/queue, so all they need is a directory config.cjs's
+ *  validatePath will accept. Not os.homedir(): this file's beforeAll swaps
+ *  process.env.HOME for scheduler.cjs's isolation, so os.homedir() called
+ *  from inside a test would resolve to tmpHome instead of the real home
+ *  config.cjs's allowedRoots snapshot was seeded with at import time. */
+function makeAllowedCwd(prefix) {
+  const cwd = fs.mkdtempSync(path.join(os.tmpdir(), prefix));
+  config.addAllowedRoot(cwd);
+  return cwd;
+}
+
+beforeAll(() => {
+  originalHome = process.env.HOME;
+  tmpHome = fs.mkdtempSync(path.join(os.tmpdir(), 'sm-prd-adoption-home-'));
+  process.env.HOME = tmpHome;
+
+  // Required AFTER HOME is swapped, never at module top level: activeSessions.cjs
+  // (pulled in transitively by prdCreate.cjs/scheduler.cjs) snapshots
+  // `os.homedir()` into a module-scope constant at first require — loading it
+  // before this reassignment would permanently bake in the vitest sandbox's
+  // own HOME (tests/setup/schedulerSandbox.globalSetup.cjs) instead of this
+  // file's tmpHome, silently breaking every ~/.claude/projects-scan-dependent
+  // assertion below (allProjectCwds/reconcile would always come back empty).
+  scheduler = require('../scheduler.cjs');
+  usage = require('../usage.cjs');
+  config = require('../config.cjs');
+  ({ createPrd } = require('../lib/prdCreate.cjs'));
+
+  if (!scheduler.PRDS_DIR.startsWith(tmpHome)) {
+    throw new Error(`refusing to run: PRDS_DIR (${scheduler.PRDS_DIR}) is not under the temp HOME (${tmpHome})`);
+  }
+});
+
+afterAll(() => {
+  process.env.HOME = originalHome;
+  fs.rmSync(tmpHome, { recursive: true, force: true });
+});
+
+afterEach(() => {
+  vi.restoreAllMocks();
+  vi.useRealTimers();
+});
+
+function registerActiveProject(cwd) {
+  const projectsDir = path.join(tmpHome, '.claude', 'projects');
+  const slugDir = path.join(projectsDir, `fake-project-slug-${path.basename(cwd)}`);
+  fs.mkdirSync(slugDir, { recursive: true });
+  fs.writeFileSync(path.join(slugDir, 'transcript.jsonl'), `${JSON.stringify({ cwd })}\n`);
+}
+
+function makeFixtureProject(prefix) {
+  const cwd = fs.mkdtempSync(path.join(os.tmpdir(), prefix));
+  registerActiveProject(cwd);
+  return cwd;
+}
+
+function writeCanonicalPrd(cwd, epicId, slug) {
+  const epicPrdsDir = path.join(cwd, 'session-manager-operations', 'scheduler', 'epics', epicId, 'prds');
+  fs.mkdirSync(epicPrdsDir, { recursive: true });
+  fs.writeFileSync(
+    path.join(epicPrdsDir, `${slug}.md`),
+    `---\ntitle: Adoption fixture\ncwd: ${cwd}\nestimateMinutes: 10\nsourcePromptId: ${epicId}\ncreatedVia: scheduler-api\nissuedAt: 2026-09-25T00:00:00.000Z\n---\n\n# Goal\n\nSomething.\n`,
+    'utf8',
+  );
+}
+
+test('remote.requestReconcile() adopts a freshly-created PRD into a pending row with no tickQueue call', async () => {
+  const cwd = makeFixtureProject('sm-prd-adoption-fresh-');
+  writeCanonicalPrd(cwd, 'epic-fresh', '9001-fresh');
+
+  const tickQueueSpy = vi.spyOn(scheduler, 'tickQueue');
+
+  await scheduler.remote.requestReconcile();
+
+  expect(tickQueueSpy).not.toHaveBeenCalled();
+  const job = await scheduler.remote.getJob('9001-fresh');
+  expect(job).not.toBeNull();
+  expect(job.status).toBe('pending');
+});
+
+test('createPrd() calls remote.requestReconcile() once after a successful write and reports enqueued:true once the row exists', async () => {
+  const writes = new Map();
+  const requestReconcile = vi.fn(async () => {});
+  const remote = {
+    async allocateParallelGroup() { return '9002'; },
+    async readPrd(slug) {
+      return writes.has(slug) ? { ok: true, text: writes.get(slug) } : { ok: false, error: 'missing' };
+    },
+    async writePrd(slug, body) {
+      writes.set(slug, body);
+      return { ok: true, path: `/fake/${slug}.md` };
+    },
+    async listPrds() { return { prds: [], total: 0, limit: 0, offset: 0, hasMore: false }; },
+    requestReconcile,
+    // Simulates the reconcile pass having already produced the queue row by
+    // the time createPrd() checks for it.
+    async getJob(slug) { return writes.has(slug) ? { slug, status: 'pending' } : null; },
+  };
+
+  const result = await createPrd({
+    title: 'Adoption wiring check',
+    cwd: makeAllowedCwd('sm-prd-adoption-hit-'),
+    estimateMinutes: 10,
+    goal: 'g',
+    acceptanceCriteria: ['a'],
+    implementationNotes: 'n',
+  }, remote);
+
+  expect(result.ok).toBe(true);
+  expect(requestReconcile).toHaveBeenCalledTimes(1);
+  expect(result.enqueued).toBe(true);
+  expect(result.note).not.toMatch(/derived by the next scheduler reconcile pass/);
+});
+
+test('createPrd() reports enqueued:false with the deferred-pass note when the row is not visible right after reconcile', async () => {
+  const writes = new Map();
+  const requestReconcile = vi.fn(async () => {});
+  const remote = {
+    async allocateParallelGroup() { return '9003'; },
+    async readPrd(slug) {
+      return writes.has(slug) ? { ok: true, text: writes.get(slug) } : { ok: false, error: 'missing' };
+    },
+    async writePrd(slug, body) {
+      writes.set(slug, body);
+      return { ok: true, path: `/fake/${slug}.md` };
+    },
+    async listPrds() { return { prds: [], total: 0, limit: 0, offset: 0, hasMore: false }; },
+    requestReconcile,
+    async getJob() { return null; },
+  };
+
+  const result = await createPrd({
+    title: 'Adoption wiring miss',
+    cwd: makeAllowedCwd('sm-prd-adoption-miss-'),
+    estimateMinutes: 10,
+    goal: 'g',
+    acceptanceCriteria: ['a'],
+    implementationNotes: 'n',
+  }, remote);
+
+  expect(result.ok).toBe(true);
+  expect(requestReconcile).toHaveBeenCalledTimes(1);
+  expect(result.enqueued).toBe(false);
+  expect(result.note).toMatch(/derived by the next scheduler reconcile pass/);
+});
+
+test('rescheduleTimer still reconciles when billing.fetchUsage() never resolves', async () => {
+  const cwd = makeFixtureProject('sm-prd-adoption-stall-');
+  writeCanonicalPrd(cwd, 'epic-stall', '9004-stall');
+
+  vi.spyOn(usage, 'fetchUsage').mockImplementation(() => new Promise(() => {}));
+  vi.useFakeTimers({ toFake: ['setTimeout', 'clearTimeout'] });
+
+  const pending = scheduler.rescheduleTimer();
+  await vi.advanceTimersByTimeAsync(scheduler.RESCHEDULE_TIMER_BILLING_RACE_MS);
+  await pending;
+
+  vi.useRealTimers();
+
+  const job = await scheduler.remote.getJob('9004-stall');
+  expect(job).not.toBeNull();
+  expect(job.status).toBe('pending');
+}, 15_000);

package/src/main/__tests__/queueOpsAutoArchive.test.cjs

@@ -5,22 +5,39 @@
  *
  * selectAutoArchivable is pure (no fs) so it's fully covered here without
  * touching disk. autoArchiveCompleted's disk-mutating path (archiveMany) is
- * exercised only via its kill-switch / no-op branches, since archiveMany
- * targets the real ~/.claude/session-manager/scheduled-plans/prds-archived
- * directory (not test-injectable) — mutating that from a test run would be
- * an unwanted side effect on the developer's real filesystem.
+ * mostly exercised only via its kill-switch / no-op branches, since
+ * archiveMany's default destination is not test-injectable — except for the
+ * two retire-flag tests below, which write into PRDS_DIR (a lazy getter
+ * resolved under this run's SM_SCHEDULER_HOME sandbox — see
+ * tests/setup/schedulerSandbox.cjs — so they never touch a real
+ * ~/.claude/session-manager tree) and stub 'electron' via require.cache so
+ * registerQueueOpsHandlers' ipcMain.handle calls are no-ops outside a real
+ * Electron process. 'electron' is an externalized node_modules dependency
+ * under vitest, so vi.mock('electron', ...) never intercepts queueOps.cjs's
+ * own require('electron') — pre-seeding require.cache for its resolved path
+ * is the one hook that reaches it.
  *
  * Run: timeout 300 npx vitest run src/main/__tests__/queueOpsAutoArchive.test.cjs
  */
 
 'use strict';
 
-import { test, expect, afterEach } from 'vitest';
+import { test, expect, afterEach, vi } from 'vitest';
+const fs = require('node:fs');
+const path = require('node:path');
+
+const electronPath = require.resolve('electron');
+require.cache[electronPath] = {
+  id: electronPath,
+  filename: electronPath,
+  loaded: true,
+  exports: { ipcMain: { handle: () => {} } },
+};
 
 const RETENTION_MS = 7 * 24 * 60 * 60_000;
 const NOW = Date.parse('2026-07-24T12:00:00.000Z');
 
-const { selectAutoArchivable, autoArchiveCompleted } = require('../queueOps.cjs');
+const { selectAutoArchivable, autoArchiveCompleted, archiveMany, registerQueueOpsHandlers, PRDS_DIR } = require('../queueOps.cjs');
 
 function fresh(overrides = {}) {
   return {
@@ -152,3 +169,43 @@ test('selectAutoArchivable never selects a slug whose job is still pending or ru
   const slugs = selectAutoArchivable([pending, running, completed], { nowMs: NOW });
   expect(slugs).toEqual(['15-done']);
 });
+
+// ---------- retire-flag deadlock guard (PRD 1442: reconcile() -> mutate()
+// body -> autoArchiveCompleted -> archiveMany -> retireCompletedSlugsFn ->
+// mutate() re-entered every tick, so mutateTail never settled) ----------
+
+test('autoArchiveCompleted never invokes retireCompletedSlugs', async () => {
+  const slug = 'test-auto-archive-no-retire';
+  fs.mkdirSync(PRDS_DIR, { recursive: true });
+  const src = path.join(PRDS_DIR, `${slug}.md`);
+  fs.writeFileSync(src, '# Goal\n\ntest\n', 'utf8');
+
+  const spy = vi.fn(async () => {});
+  registerQueueOpsHandlers({ retireCompletedSlugs: spy });
+
+  const job = old({ slug, status: 'completed' });
+  const result = await autoArchiveCompleted({ jobs: [job] }, { nowMs: NOW });
+
+  expect(result.archived).toBe(1);
+  expect(fs.existsSync(src)).toBe(false);
+  expect(result.results[0].ok).toBe(true);
+  expect(fs.existsSync(result.results[0].archivedTo)).toBe(true);
+  expect(spy).not.toHaveBeenCalled();
+});
+
+test('manual archiveMany still retires', async () => {
+  const slug = 'test-manual-archive-still-retires';
+  fs.mkdirSync(PRDS_DIR, { recursive: true });
+  const src = path.join(PRDS_DIR, `${slug}.md`);
+  fs.writeFileSync(src, '# Goal\n\ntest\n', 'utf8');
+
+  const spy = vi.fn(async () => {});
+  registerQueueOpsHandlers({ retireCompletedSlugs: spy });
+
+  const result = await archiveMany([slug]);
+
+  expect(result.archived).toBe(1);
+  expect(fs.existsSync(src)).toBe(false);
+  expect(spy).toHaveBeenCalledTimes(1);
+  expect(spy).toHaveBeenCalledWith([slug]);
+});

package/src/main/__tests__/scheduler-mutate-reentrancy.test.cjs

@@ -0,0 +1,117 @@
+/**
+ * scheduler-mutate-reentrancy.test.cjs — regression cover for PRD 1443.
+ *
+ * mutate()'s chain (`mutateTail = mutateTail.then(...)`) is the single-writer
+ * lock over queue.json. Calling mutate() again from INSIDE a still-running
+ * mutate body (and awaiting it) used to queue the inner call behind
+ * mutateTail — which the outer call itself is holding — so the inner
+ * `await` never resolved and the whole scheduler froze (PRD 1442 was the one
+ * known path: reconcile -> autoArchiveCompleted -> retireCompletedSlugs ->
+ * mutate). The fix tracks "am I inside a live mutate body" via
+ * AsyncLocalStorage and rejects immediately on re-entry instead of
+ * deadlocking.
+ *
+ * HOME-isolated (mirrors scheduler-broadcast-reconcile.test.cjs): stub HOME to
+ * a mkdtemp dir and mock queueStore's read/write so this never touches real
+ * queue.json.
+ *
+ * Run: timeout 120 npx vitest run src/main/__tests__/scheduler-mutate-reentrancy.test.cjs
+ */
+'use strict';
+
+import { test, expect, beforeAll, afterAll, afterEach, vi } from 'vitest';
+const fs = require('node:fs');
+const os = require('node:os');
+const path = require('node:path');
+
+let tmpHome;
+let originalHome;
+let scheduler;
+let queueStore;
+
+beforeAll(() => {
+  originalHome = process.env.HOME;
+  tmpHome = fs.mkdtempSync(path.join(os.tmpdir(), 'sm-mutate-reentrancy-home-'));
+  process.env.HOME = tmpHome;
+
+  scheduler = require('../scheduler.cjs');
+  queueStore = require('../lib/queueStore.cjs');
+
+  if (!scheduler.PRDS_DIR.startsWith(tmpHome)) {
+    throw new Error(`refusing to run: PRDS_DIR (${scheduler.PRDS_DIR}) is not under the temp HOME (${tmpHome})`);
+  }
+});
+
+afterAll(() => {
+  process.env.HOME = originalHome;
+  fs.rmSync(tmpHome, { recursive: true, force: true });
+});
+
+function freshState() {
+  return { config: {}, jobs: [], scheduledFor: null, lastRunAt: null, paused: null };
+}
+
+function wait(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+afterEach(() => {
+  vi.restoreAllMocks();
+});
+
+test('nested awaited mutate rejects instead of hanging', async () => {
+  vi.spyOn(queueStore, 'readMerged').mockImplementation(async () => freshState());
+  vi.spyOn(queueStore, 'writeSplit').mockResolvedValue(undefined);
+
+  let innerRejection = null;
+  const outerPromise = scheduler._mutateForTests(async () => {
+    try {
+      await scheduler._mutateForTests(async () => 'inner-should-never-resolve');
+    } catch (err) {
+      innerRejection = err;
+    }
+    return 'outer-done';
+  });
+
+  const result = await Promise.race([
+    outerPromise,
+    wait(2000).then(() => { throw new Error('outer mutate did not settle within 2s'); }),
+  ]);
+
+  expect(result).toBe('outer-done');
+  expect(innerRejection).toBeInstanceOf(Error);
+  expect(innerRejection.message).toMatch(/re-entered/i);
+});
+
+test('mutate scheduled via setTimeout from a finished body runs normally', async () => {
+  vi.spyOn(queueStore, 'readMerged').mockImplementation(async () => freshState());
+  vi.spyOn(queueStore, 'writeSplit').mockResolvedValue(undefined);
+
+  let deferredResult = null;
+  let deferredError = null;
+
+  await scheduler._mutateForTests(async () => {
+    setTimeout(() => {
+      scheduler._mutateForTests(async () => 'deferred-ok')
+        .then((r) => { deferredResult = r; })
+        .catch((err) => { deferredError = err; });
+    }, 10);
+    return 'immediate';
+  });
+
+  await wait(300);
+
+  expect(deferredError).toBeNull();
+  expect(deferredResult).toBe('deferred-ok');
+});
+
+test('sequential mutates unaffected', async () => {
+  vi.spyOn(queueStore, 'readMerged').mockImplementation(async () => freshState());
+  vi.spyOn(queueStore, 'writeSplit').mockResolvedValue(undefined);
+
+  const r1 = await scheduler._mutateForTests(async () => 'first');
+  const r2 = await scheduler._mutateForTests(async () => 'second');
+
+  expect(r1).toBe('first');
+  expect(r2).toBe('second');
+});