claude-code-session-manager 0.100.0 → 0.101.0

package/dist/assets/{settingsSchema-D6iRguNV.js → settingsSchema-Wrvn-Yz1.js}

@@ -1 +1 @@
-import{ay as b,aj as n,S as N,aP as O,aw as K}from"./index-vx8O73l8.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(J,{...e,node:e.node}):n.jsx(R,{...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 J({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:k(g.value)}),n.jsx(C,{scope:g.fromScope})]},d))]}):null}function R({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:k(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:k(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: ",k(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 k(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=O(o=>o.files),m=O(o=>o.loadJson),f=O(o=>o.watchFile),x=O(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 B(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:q([...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 q(e){return Array.from(new Set(e))}let $=null;function V(){return $||($=B(K)),$}export{T as E,V as s,G as u};
+import{ax as b,ai as n,S as N,aO as O,av as K}from"./index-DbCQPWWY.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(J,{...e,node:e.node}):n.jsx(R,{...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 J({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:k(g.value)}),n.jsx(C,{scope:g.fromScope})]},d))]}):null}function R({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:k(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:k(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: ",k(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 k(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=O(o=>o.files),m=O(o=>o.loadJson),f=O(o=>o.watchFile),x=O(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 B(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:q([...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 q(e){return Array.from(new Set(e))}let $=null;function V(){return $||($=B(K)),$}export{T as E,V as s,G as u};

package/dist/index.html

@@ -7,10 +7,10 @@
     <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-vx8O73l8.js"></script>
+    <script type="module" crossorigin src="./assets/index-DbCQPWWY.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-Bta-hwud.css">
+    <link rel="stylesheet" crossorigin href="./assets/index-D89EUizB.css">
   </head>
   <body class="bg-bg text-fg font-sans antialiased">
     <div id="root"></div>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-session-manager",
-  "version": "0.100.0",
+  "version": "0.101.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",

package/scripts/scheduler-mcp-server.cjs

@@ -12,6 +12,7 @@
  *   feedback_open_session({ ... }) -> POST /admin/feedback/open-session
  *
  *   project_home_write({ cwd?, html }) -> POST /admin/project-home/write
+ *   project_demo_video_write({ cwd?, html }) -> POST /admin/project-home/demo-video/write
  *
  * This is a separate process from the Electron app — it only ever reaches
  * it over the token-authed loopback HTTP API in admin-api.json, never by
@@ -375,6 +376,25 @@ const TOOLS = [
       required: ['html'],
     },
   },
+  {
+    name: 'project_demo_video_write',
+    description: descriptionFor('project_demo_video_write'),
+    inputSchema: {
+      type: 'object',
+      properties: {
+        cwd: { type: 'string', description: "Optional: absolute path to the target project. Defaults to the calling session's own project root (SM_PROJECT_ROOT or process.cwd()) when omitted." },
+        html: {
+          type: 'string',
+          description: 'The complete self-contained HTML/JS document for a 30-second-or-less demo video (<= 2MB). '
+            + 'It is rejected for: being empty; <script src>, <link href=http*>, @import, or url(http*) (no remote references); '
+            + 'fetch/XMLHttpRequest/WebSocket/EventSource/sendBeacon/dynamic import/importScripts/<iframe>/<object>/<embed>/window.open/'
+            + 'any http(s)/// src or href (no network-capable APIs — the document is CSP-fenced after it is written); '
+            + 'or missing a <meta name="sm-demo-duration" content="N"> tag with 5 <= N <= 30.',
+        },
+      },
+      required: ['html'],
+    },
+  },
   {
     name: 'session_manager_help',
     description: descriptionFor('session_manager_help'),
@@ -599,6 +619,14 @@ async function handleCallTool(request) {
       const result = await adminRequest('POST', '/admin/project-home/write', { cwd, html: args.html });
       return { content: [{ type: 'text', text: JSON.stringify(result) }] };
     }
+    if (name === 'project_demo_video_write') {
+      if (!args || typeof args.html !== 'string' || args.html.length === 0) {
+        return errorResult('missing required argument: html');
+      }
+      const cwd = resolveCwdArg(args);
+      const result = await adminRequest('POST', '/admin/project-home/demo-video/write', { cwd, html: args.html });
+      return { content: [{ type: 'text', text: JSON.stringify(result) }] };
+    }
     if (name === 'session_manager_help') {
       const toolName = args && typeof args.tool === 'string' ? args.tool : null;
       const topic = args && typeof args.topic === 'string' ? args.topic : null;

package/src/main/build-info.json

@@ -1,8 +1,8 @@
 {
-  "version": "0.100.0",
-  "gitSha": "e2cdd120c1125c4310e8bae3ed007d1d6e55a850",
-  "gitShortSha": "e2cdd120",
+  "version": "0.101.0",
+  "gitSha": "c57a278f1ec1bf0c508ff6a1fcc260195febd6e3",
+  "gitShortSha": "c57a278f",
   "gitBranch": "HEAD",
-  "builtAt": "2026-10-03T03:50:40.894Z",
+  "builtAt": "2026-10-03T17:17:40.599Z",
   "dirty": false
 }

package/src/main/chatRunner.cjs

@@ -30,7 +30,7 @@
  *   chat:run:queued     { tabId, sessionId, position }   — waiting behind a busy lane
  *   chat:run:started    { tabId, sessionId }
  *   chat:run:output     { tabId, delta }
- *   chat:run:tool-use   { tabId, id, kind, label }
+ *   chat:run:tool-use   { tabId, id, kind, label, detail }
  *   chat:run:complete   { tabId, sessionId, finalMessage }
  *   chat:run:needs-input { tabId, sessionId, questions, raw }
  *   chat:run:error      { tabId, sessionId, message }
@@ -736,9 +736,10 @@ function executeRun({ tabId, sessionId, prompt, cwd, resume, silent, onSilentRes
             if (!silent) broadcast('chat:run:output', { tabId, delta: block.text });
           } else if (block.type === 'tool_use' && typeof block.name === 'string') {
             const classified = classifyToolUse(block);
-            recentToolUses.push({ ...classified, detail: describeToolUseInput(block) });
+            const detail = describeToolUseInput(block);
+            recentToolUses.push({ ...classified, detail });
             if (recentToolUses.length > RECENT_TOOL_USE_LIMIT) recentToolUses.shift();
-            if (!silent) broadcast('chat:run:tool-use', { tabId, id: block.id, ...classified });
+            if (!silent) broadcast('chat:run:tool-use', { tabId, id: block.id, ...classified, detail });
           }
         }
       } else if (event.type === 'user') {

package/src/main/index.cjs

@@ -33,6 +33,7 @@ const { createAdminHttp } = require('./lib/localAdminHttp.cjs');
 const prdCreate = require('./lib/prdCreate.cjs');
 const prdAdminRoutes = require('./lib/prdAdminRoutes.cjs');
 const projectHomeAdminRoutes = require('./lib/projectHomeAdminRoutes.cjs');
+const { smfileResponseHeaders, shouldBlockFrameNavigation } = require('./lib/smfileHeaders.cjs');
 const { appendAuditEvent } = require('./lib/auditLog.cjs');
 const chatRunner = require('./chatRunner.cjs');
 const promptSessionEvents = require('./promptSessionEvents.cjs');
@@ -455,6 +456,21 @@ function createWindow() {
     configMgr.releaseWatchesForSender(mainWindow.webContents.id);
   });
 
+  // CSP (frame-src/connect-src) does not govern a subframe navigating itself —
+  // a demo-video document could still exfiltrate data via meta refresh or
+  // `location.href = 'https://…'`. Block any such navigation out of an
+  // smfile:// demo-video subframe.
+  mainWindow.webContents.on('will-frame-navigate', (details) => {
+    if (shouldBlockFrameNavigation({
+      isMainFrame: details.isMainFrame,
+      currentUrl: details.frame?.url,
+      targetUrl: details.url,
+    })) {
+      details.preventDefault();
+      console.warn('[main] blocked will-frame-navigate to', details.url);
+    }
+  });
+
   mainWindow.webContents.on('context-menu', (_e, params) => {
     const items = [];
     if (params.editFlags.canCopy) items.push({ label: 'Copy', role: 'copy' });
@@ -1276,7 +1292,7 @@ app.whenReady().then(async () => {
       const buf = await fs.promises.readFile(realPath);
       const ext = path.extname(realPath).toLowerCase();
       const type = SMFILE_MIME[ext] || 'application/octet-stream';
-      return new Response(buf, { headers: { 'content-type': type } });
+      return new Response(buf, { headers: smfileResponseHeaders(realPath, type) });
     } catch (err) {
       return new Response(`smfile error: ${err && err.message}`, { status: 404 });
     }

package/src/main/ipcSchemas.cjs

@@ -730,6 +730,13 @@ const projectHomeAdminWriteBody = z.object({
   html: z.string(),
 }).strict();
 
+// Mirrors projectHomeAdminWriteBody; content limits (network-check rejections,
+// size cap, duration meta) live in projectHomeAdminRoutes.cjs's validateDemoVideoHtml.
+const projectDemoVideoAdminWriteBody = z.object({
+  cwd: z.string().min(1).max(4096).optional(),
+  html: z.string(),
+}).strict();
+
 const projectBriefSetPin = z.object({
   cwd: z.string().min(1).max(4096),
   block: PROJECT_BRIEF_BLOCK,
@@ -1132,6 +1139,7 @@ module.exports = {
     projectBriefCwd,
     projectPagesCwd,
     projectHomeAdminWriteBody,
+    projectDemoVideoAdminWriteBody,
     projectBriefSetPin,
     projectBriefUpdate,
     promptSessionTranscriptAppend,

package/src/main/lib/builtinMacros.cjs

@@ -0,0 +1,39 @@
+'use strict';
+
+/**
+ * builtinMacros.cjs — the machine-local Macro library's seeded built-ins.
+ *
+ * These drive Project Home's one-click actions through the same (agent, tag,
+ * prompt) hot-key framework as user-created macros. `macroLibrary.cjs`'s
+ * `ensureBuiltins` seeds any entry here that is missing from macros.json, and
+ * upgrades an unedited stored copy whose `builtinVersion` is behind this file.
+ *
+ * Plain Node, no Electron imports.
+ */
+
+const BUILTIN_MACROS = Object.freeze([
+  Object.freeze({
+    id: 'builtin-project-home',
+    label: 'Project Home',
+    agentName: 'project-home-builder',
+    tag: 'project-home-builder',
+    surface: 'project-home',
+    projects: ['*'],
+    builtinVersion: 1,
+    prompt:
+      "Generate this project's Project Home page: one self-contained HTML overview (what it is, who it is for, key features, structure, how to run it, key commands), grounded only in what you read in the repository. Save it with a single project_home_write call.",
+  }),
+  Object.freeze({
+    id: 'builtin-demo-video',
+    label: 'Demo Video',
+    agentName: 'demo-video-builder',
+    tag: 'project-home-builder',
+    surface: 'project-home',
+    projects: ['*'],
+    builtinVersion: 1,
+    prompt:
+      'Generate a 30-second demo video for this project as one self-contained HTML/JavaScript animation that presents its main goals and key features, grounded only in what you read in the repository. Save it with a single project_demo_video_write call.',
+  }),
+]);
+
+module.exports = { BUILTIN_MACROS };

package/src/main/lib/macroLibrary.cjs

@@ -43,6 +43,7 @@ const { EpicTagSchema } = require('./promptSessionSchema.cjs');
 const { WORK_TYPES } = require('./workTypeLibrary.cjs');
 const { PERSONA_NAME_RE } = require('./personaMerge.cjs');
 const { schedulerHome } = require('./schedulerPaths.cjs');
+const { BUILTIN_MACROS } = require('./builtinMacros.cjs');
 
 const ALL_PROJECTS = '*';
 const STORE_VERSION = 1;
@@ -57,6 +58,7 @@ const AbsolutePathSchema = z.string().max(1024).refine(
 );
 const MacroProjectEntrySchema = z.union([z.literal(ALL_PROJECTS), AbsolutePathSchema]);
 const MacroProjectsSchema = z.array(MacroProjectEntrySchema).max(200);
+const MacroSurfaceSchema = z.enum(['sessions', 'project-home']);
 
 const MacroSchema = z.object({
   id: MacroIdSchema,
@@ -65,6 +67,9 @@ const MacroSchema = z.object({
   tag: EpicTagSchema,
   prompt: MacroPromptSchema,
   projects: MacroProjectsSchema,
+  surface: MacroSurfaceSchema.default('sessions'),
+  builtin: z.boolean().optional(),
+  builtinVersion: z.number().int().optional(),
   createdAt: z.string().min(1).max(64),
   updatedAt: z.string().min(1).max(64),
 });
@@ -75,7 +80,11 @@ const MacroSaveSchema = z.object({
   agentName: MacroAgentNameSchema,
   tag: EpicTagSchema,
   prompt: MacroPromptSchema,
-  projects: MacroProjectsSchema.default([]),
+  // Omitted (not merely `[]`) means "leave projects unchanged" on update, so a
+  // label/prompt-only edit of a macro (builtin or otherwise) can't silently
+  // wipe its visibility back to no projects. `undefined` on create means [].
+  projects: MacroProjectsSchema.optional(),
+  surface: MacroSurfaceSchema.optional(),
 });
 
 const MacroDeleteSchema = z.object({ id: MacroIdSchema });
@@ -185,6 +194,73 @@ async function writeStore(filePath, macros) {
   await writeJsonAtomic(filePath, { version: STORE_VERSION, macros });
 }
 
+function resolveBuiltins(opts) {
+  return opts && Object.prototype.hasOwnProperty.call(opts, 'builtins') ? opts.builtins : BUILTIN_MACROS;
+}
+
+/**
+ * Pure. Seeds any `builtins` entry missing from `macros` (as `builtin: true`),
+ * and upgrades a stored built-in that is behind the shipped `builtinVersion`
+ * AND was never user-edited (`updatedAt === createdAt`). A user-edited
+ * built-in is left untouched. Returns `{ macros, changed }`.
+ */
+function ensureBuiltins(macros, builtins) {
+  if (!builtins || builtins.length === 0) return { macros, changed: false };
+  let changed = false;
+  const next = macros.slice();
+  const now = new Date().toISOString();
+  for (const b of builtins) {
+    const idx = next.findIndex((m) => m.id === b.id);
+    if (idx === -1) {
+      next.push({
+        id: b.id,
+        label: b.label,
+        agentName: b.agentName,
+        tag: b.tag,
+        prompt: b.prompt,
+        projects: b.projects.slice(),
+        surface: b.surface,
+        builtin: true,
+        builtinVersion: b.builtinVersion,
+        createdAt: now,
+        updatedAt: now,
+      });
+      changed = true;
+      continue;
+    }
+    const stored = next[idx];
+    const storedVersion = stored.builtinVersion || 0;
+    const neverEdited = stored.updatedAt === stored.createdAt;
+    if (storedVersion < b.builtinVersion && neverEdited) {
+      next[idx] = {
+        ...stored,
+        label: b.label,
+        agentName: b.agentName,
+        tag: b.tag,
+        prompt: b.prompt,
+        surface: b.surface,
+        builtinVersion: b.builtinVersion,
+        updatedAt: stored.createdAt,
+      };
+      changed = true;
+    }
+  }
+  return { macros: next, changed };
+}
+
+/** Apply builtin seeding/upgrades, writing only when something changed. */
+async function applyBuiltins(filePath, macros, opts) {
+  const { macros: next, changed } = ensureBuiltins(macros, resolveBuiltins(opts));
+  if (!changed) return { macros, failed: false };
+  try {
+    await writeStore(filePath, next);
+  } catch (err) {
+    console.warn('[macroLibrary] could not persist built-in macro seeding:', err && err.message);
+    return { macros, failed: false };
+  }
+  return { macros: next, failed: false };
+}
+
 // --- migration --------------------------------------------------------------
 
 function isValidProject(p) {
@@ -246,7 +322,7 @@ async function migrateFromPersonas(opts) {
  */
 async function loadStore(filePath, opts) {
   const cur = await readStore(filePath);
-  if (cur.state === 'ok') return { macros: cur.macros, failed: false };
+  if (cur.state === 'ok') return applyBuiltins(filePath, cur.macros, opts);
   if (cur.state === 'unreadable') return { macros: [], failed: true };
   if (cur.state === 'corrupt') {
     const quarantine = `${filePath}.corrupt-${Date.now()}`;
@@ -263,7 +339,7 @@ async function loadStore(filePath, opts) {
       console.warn('[macroLibrary] could not write fresh macros.json:', err && err.message);
       return { macros: [], failed: true };
     }
-    return { macros: [], failed: false };
+    return applyBuiltins(filePath, [], opts);
   }
   // missing: migrate once
   const seeded = await migrateFromPersonas(opts);
@@ -274,7 +350,7 @@ async function loadStore(filePath, opts) {
     console.warn('[macroLibrary] could not write migrated macros.json:', err && err.message);
     return { macros: seeded, failed: true };
   }
-  return { macros: seeded, failed: false };
+  return applyBuiltins(filePath, seeded, opts);
 }
 
 // --- public API -------------------------------------------------------------
@@ -283,8 +359,11 @@ async function loadStore(filePath, opts) {
 async function listMacros(opts = {}) {
   const filePath = resolvePath(opts);
   const first = await readStore(filePath);
-  if (first.state === 'ok') return first.macros;
-  // Missing/corrupt: repair inside the write chain so racing callers don't double-seed.
+  if (first.state === 'ok') {
+    const { changed } = ensureBuiltins(first.macros, resolveBuiltins(opts));
+    if (!changed) return first.macros;
+  }
+  // Missing/corrupt/needs-seeding: repair inside the write chain so racing callers don't double-seed.
   return serialize(async () => (await loadStore(filePath, opts)).macros);
 }
 
@@ -305,14 +384,24 @@ async function saveMacro(input, opts = {}) {
   return serialize(async () => {
     const macros = await loadForWrite(filePath, opts);
     const now = new Date().toISOString();
-    const projects = normalizeProjects(parsed.projects);
     let saved;
     if (parsed.id) {
       const idx = macros.findIndex((m) => m.id === parsed.id);
       if (idx === -1) throw new Error(`macro not found: ${parsed.id}`);
-      saved = { ...macros[idx], label: parsed.label, agentName: parsed.agentName, tag: parsed.tag, prompt: parsed.prompt, projects, updatedAt: now };
+      const projects = parsed.projects !== undefined ? normalizeProjects(parsed.projects) : macros[idx].projects;
+      saved = {
+        ...macros[idx],
+        label: parsed.label,
+        agentName: parsed.agentName,
+        tag: parsed.tag,
+        prompt: parsed.prompt,
+        projects,
+        surface: parsed.surface ?? macros[idx].surface,
+        updatedAt: now,
+      };
       macros[idx] = saved;
     } else {
+      const projects = parsed.projects !== undefined ? normalizeProjects(parsed.projects) : [];
       saved = {
         id: newId(parsed.label, new Set(macros.map((m) => m.id))),
         label: parsed.label,
@@ -320,6 +409,7 @@ async function saveMacro(input, opts = {}) {
         tag: parsed.tag,
         prompt: parsed.prompt,
         projects,
+        surface: parsed.surface ?? 'sessions',
         createdAt: now,
         updatedAt: now,
       };
@@ -336,6 +426,8 @@ async function deleteMacro(input, opts = {}) {
   const filePath = resolvePath(opts);
   return serialize(async () => {
     const macros = await loadForWrite(filePath, opts);
+    const target = macros.find((m) => m.id === id);
+    if (target && target.builtin) throw new Error('built-in macros cannot be deleted');
     const next = macros.filter((m) => m.id !== id);
     if (next.length !== macros.length) await writeStore(filePath, next);
     return { ok: true };
@@ -361,6 +453,7 @@ async function setMacroProject(input, opts = {}) {
       if (enabled) return { ok: true, macro };
       return { ok: false, error: 'macro is shown in every project' };
     }
+    if (macro.builtin && !enabled) return { ok: false, error: 'built-in macro visibility cannot be narrowed' };
     const has = macro.projects.includes(target);
     if (enabled === has) return { ok: true, macro };
     const projects = enabled ? [...macro.projects, target] : macro.projects.filter((p) => p !== target);
@@ -383,4 +476,5 @@ module.exports = {
   deleteMacro,
   setMacroProject,
   defaultFilePath,
+  ensureBuiltins,
 };

package/src/main/lib/mcpToolCatalog.cjs

@@ -270,6 +270,29 @@ const MCP_TOOL_CATALOG = [
     exampleArgs: { cwd: '/home/bilko/Projects/session-manager', html: '<!DOCTYPE html><html><body><h1>Example</h1></body></html>' },
     notes: "cwd is optional — defaults to the calling session's own project root (SM_PROJECT_ROOT or process.cwd()) when omitted.",
   },
+  {
+    name: 'project_demo_video_write',
+    group: 'project-home',
+    purpose: "Write this project's 30-second demo video — ONE self-contained HTML/JS document — to "
+      + "session-manager-operations/project-pages/demo-video/index.html via the session-manager app's admin API. "
+      + 'The only write path for the demo video.',
+    whenToUse: 'Use when asked to generate or refresh the demo video. Compose the whole document yourself '
+      + '(inline <style>/<script>, data: URIs for assets, CSS/JS-driven animation) from what is really true about '
+      + 'the project, declare its length with <meta name="sm-demo-duration" content="N"> (5-30 seconds), then '
+      + 'pass the full document as `html`.',
+    whenNotToUse: 'Never fabricate content — every claim must trace to something concrete in the project. The '
+      + 'document must be self-contained and non-network-capable: the call is rejected for empty input, more than '
+      + '2MB, any <script src>, <link href="http…">, @import, or url(http…) (no remote references); any '
+      + 'fetch/XMLHttpRequest/WebSocket/EventSource/sendBeacon/dynamic import/importScripts/<iframe>/<object>/'
+      + '<embed>/window.open/http(s)-pointing src or href (no network-capable APIs); or a missing/out-of-range '
+      + 'sm-demo-duration meta tag.',
+    exampleArgs: {
+      cwd: '/home/bilko/Projects/session-manager',
+      html: '<!DOCTYPE html><html><head><meta name="sm-demo-duration" content="30"></head><body><h1>Example</h1></body></html>',
+    },
+    notes: "cwd is optional — defaults to the calling session's own project root (SM_PROJECT_ROOT or process.cwd()) when omitted. "
+      + 'The document is CSP-stamped after it is written, so the viewer sandbox is the real network fence — these checks are defence in depth.',
+  },
   {
     name: 'session_manager_help',
     group: 'help',

package/src/main/lib/opsOwnership.cjs

@@ -48,10 +48,11 @@ const OWNERS = Object.freeze({
   'scheduler': 'scheduler',
   // Project Home owns the synthesized Brief (generate + hand-edit).
   'project-brief': 'project-home',
-  // Project Home owns project-pages/home.html, written only via the
-  // project_home_write MCP tool -> /admin/project-home/write route
-  // (config.cjs's writeTextAtomic). See
-  // session-manager-operations/project-pages/README.md.
+  // Project Home owns project-pages/home.html and project-pages/demo-video/
+  // index.html, written only via the project_home_write ->
+  // /admin/project-home/write and project_demo_video_write ->
+  // /admin/project-home/demo-video/write routes (config.cjs's
+  // writeTextAtomic). See session-manager-operations/project-pages/README.md.
   'project-pages': 'project-home',
   // Structured per-tab error log lines (JSONL), tagged for tracing/analysis.
   'logs': 'logs',