pi-gsd 2.0.24 → 2.1.0

package/dist/pi-gsd-tools.js

@@ -350,7 +350,7 @@ ${p}
 `,h=Jt.default.join(t,n.directory,f);if(ls.default.existsSync(h)){y({error:"File already exists",path:J(Jt.default.relative(t,h))},r);return}ls.default.writeFileSync(h,Ie(g),"utf-8");let x=J(Jt.default.relative(t,h));y({created:!0,path:x,template:e},r,x)}var ls,Jt,Ks=L(()=>{"use strict";ls=U(require("fs")),Jt=U(require("path"));ye();Ve()});var Xe,ds,us,Jr=L(()=>{"use strict";Xe=require("@oclif/core");je();ds=class t extends w{static description="Select a workflow template";static args={type:Xe.Args.string({required:!0})};static flags={...w.baseFlags};async run(){let{flags:e,args:s}=await this.parse(t),{cwd:r,raw:n}=this.resolveContext(e),{cmdTemplateSelect:i}=await Promise.resolve().then(()=>(Ks(),Zs));i(r,s.type,n)}},us=class t extends w{static description="Fill a template with values";static args={type:Xe.Args.string({required:!0})};static flags={...w.baseFlags,phase:Xe.Flags.string(),plan:Xe.Flags.string(),name:Xe.Flags.string(),type:Xe.Flags.string({char:"t"}),wave:Xe.Flags.string(),fields:Xe.Flags.string({description:"JSON fields"})};async run(){let{flags:e,args:s}=await this.parse(t),{cwd:r,raw:n}=this.resolveContext(e),{cmdTemplateFill:i}=await Promise.resolve().then(()=>(Ks(),Zs)),o={};if(e.fields)try{o=JSON.parse(e.fields)}catch{}i(r,s.type,{phase:e.phase??void 0,plan:e.plan??void 0,name:e.name??void 0,type:e.type??void 0,wave:e.wave??void 0,...o},n)}}});var Ft,ms,ps,fs,gs,hs,Yr=L(()=>{"use strict";Ft=require("@oclif/core");je();ms=class t extends w{static description="Show project progress";static args={format:Ft.Args.string({default:"json"})};static flags={...w.baseFlags};async run(){let{flags:e,args:s}=await this.parse(t),{cwd:r,raw:n}=this.resolveContext(e),{cmdProgressRender:i}=await Promise.resolve().then(()=>(_e(),ve));i(r,s.format,n)}},ps=class t extends w{static description="Show project statistics";static args={format:Ft.Args.string({default:"json"})};static flags={...w.baseFlags};async run(){let{flags:e,args:s}=await this.parse(t),{cwd:r,raw:n}=this.resolveContext(e),{cmdStats:i}=await Promise.resolve().then(()=>(_e(),ve));i(r,s.format,n)}},fs=class t extends w{static description="Mark a todo as complete";static args={id:Ft.Args.string({required:!0})};static flags={...w.baseFlags};async run(){let{flags:e,args:s}=await this.parse(t),{cwd:r,raw:n}=this.resolveContext(e),{cmdTodoComplete:i}=await Promise.resolve().then(()=>(_e(),ve));i(r,s.id,n)}},gs=class t extends w{static description="Match todos to phase";static args={phase:Ft.Args.string({required:!0})};static flags={...w.baseFlags};async run(){let{flags:e,args:s}=await this.parse(t),{cwd:r,raw:n}=this.resolveContext(e),{cmdTodoMatchPhase:i}=await Promise.resolve().then(()=>(_e(),ve));i(r,s.phase,n)}},hs=class t extends w{static description="Extract fields from summary files";static args={phase:Ft.Args.string({required:!0})};static flags={...w.baseFlags,fields:w.baseFlags.pick};async run(){let{flags:e,args:s}=await this.parse(t),{cwd:r,raw:n}=this.resolveContext(e),{cmdSummaryExtract:i}=await Promise.resolve().then(()=>(_e(),ve)),o=e.fields?e.fields.split(","):null;i(r,s.phase,o,n)}}});function ft(t){let e=[],s=/^```[^\n]*\n[\s\S]*?^```/gm,r;for(;(r=s.exec(t))!==null;)e.push([r.index,r.index+r[0].length]);return e}function gt(t,e){return e.some(([s,r])=>t>=s&&t<r)}function Va(t){let e={},s=/([a-zA-Z0-9_:-]+)(?:=(?:"([^"]*)"|'([^']*)'|([^\s/>]*)))?/g,r;for(;(r=s.exec(t))!==null;){let n=r[1],i=r[2]??r[3]??r[4]??"";e[n]=i}return e}function Hr(t,e){if(t[e]!=="<")return null;let s=/^<([a-zA-Z0-9_:-]+)((?:\s+[a-zA-Z0-9_:-]+(?:=(?:"[^"]*"|'[^']*'|[^\s/>]*))?)*)?\s*(\/??>)/,r=t.slice(e),n=s.exec(r);if(!n)return null;let i=n[1],o=(n[2]??"").trim(),a=n[3],c=Va(o);if(a==="/>")return{node:{tag:i,attrs:c,children:[],selfClosing:!0},end:e+n[0].length};let l=e+n[0].length,d=[],u=`</${i}>`;for(;l<t.length;){let m=t.indexOf("<",l);if(m===-1)break;if(t.startsWith(u,m))return{node:{tag:i,attrs:c,children:d,selfClosing:!1},end:m+u.length};if(t.startsWith("<!--",m)){let f=t.indexOf("-->",m+4);l=f!==-1?f+3:t.length;continue}let p=Hr(t,m);p?(d.push(p.node),l=p.end):l=m+1}return{node:{tag:i,attrs:c,children:d,selfClosing:!1},end:l}}function Yt(t){let e=ft(t),s=[],r=/<(gsd-[a-zA-Z0-9_-]+)/g,n;for(;(n=r.exec(t))!==null;){let i=n.index;if(gt(i,e))continue;let o=n[1];if(!za.has(o))continue;let a=Hr(t,i);a&&(s.push({node:a.node,start:i,end:a.end}),r.lastIndex=a.end)}return s}function ys(t,e,s,r){return t.slice(0,e)+r+t.slice(s)}var za,Qs=L(()=>{"use strict";za=new Set(["gsd-execute","gsd-arguments","gsd-paste","gsd-include","gsd-version"])});function Xr(){let t=new Map,e=new Map,s=r=>{let n=t.get(r)?.value;if(n!==void 0)return n;let i=r.indexOf(".");if(i===-1)return;let o=r.slice(0,i),a=r.slice(i+1),c=t.get(o)?.value;if(c!==void 0)try{let l=JSON.parse(c);for(let d of a.split(".")){if(l===null||typeof l!="object")return;l=l[d]}return l==null?void 0:String(l)}catch{return}};return{set(r,n,i){let o=t.get(r);o?.owner&&i&&o.owner!==i?(t.delete(r),t.set(`${o.owner}:${r}`,{name:`${o.owner}:${r}`,value:o.value,owner:o.owner}),t.set(`${i}:${r}`,{name:`${i}:${r}`,value:n,owner:i})):t.set(r,{name:r,value:n,owner:i})},get(r){return t.get(r)?.value},resolve(r){return s(r)},setArray(r,n,i){e.set(r,n),t.set(r,{name:r,value:JSON.stringify(n),owner:i})},getArray(r){if(e.has(r))return e.get(r);let n=t.get(r)?.value;if(n)try{let i=JSON.parse(n);if(Array.isArray(i))return i.map(o=>typeof o=="string"?o:JSON.stringify(o))}catch{}},has(r){return t.has(r)||e.has(r)},entries(){return t.entries()},snapshot(){let r={};for(let[n,i]of t)r[n]=i.value;return r}}}var Zr=L(()=>{"use strict"});function Kr(t,e,s){let r=t.children.find(g=>g.tag==="settings"),n=r?.children.some(g=>g.tag==="keep-extra-args")??!1,i=r?.children.some(g=>g.tag==="strict-args")??!1,a=r?.children.find(g=>g.tag==="delimiters")?.children.find(g=>g.tag==="delimiter"),c;if(a){let g=a.attrs.value??"",h=g==="\\n"?`
 `:g;c=e.split(h).map(x=>x.trim()).filter(Boolean)}else c=e.trim().split(/\s+/).filter(Boolean);let l=t.children.filter(g=>g.tag==="arg"),d=new Set;for(let g of l.filter(h=>h.attrs.type==="flag")){let h=g.attrs.flag??`--${g.attrs.name}`,x=c.indexOf(h),S=g.attrs.name;S&&(x===-1?s.set(S,"false",void 0):(s.set(S,"true",void 0),d.add(x)))}let u=l.filter(g=>g.attrs.type!=="flag"),m=c.filter((g,h)=>!d.has(h)),p=0;for(let g=0;g<u.length;g++){let h=u[g],x=h.attrs.name,S=h.attrs.type??"string",v=g===u.length-1;if(x){if(p>=m.length){if(!("optional"in h.attrs))throw new ht(`Missing required argument '${x}' (type: ${S})`);s.set(x,"",void 0);continue}if(S==="string"&&v)s.set(x,m.slice(p).join(" "),void 0),p=m.length;else if(S==="number"){let C=m[p++],P=Number(C);if(isNaN(P))throw new ht(`Argument '${x}' expected a number, got '${C}'`);s.set(x,String(P),void 0)}else if(S==="boolean"){let C=m[p++].toLowerCase();if(C!=="true"&&C!=="false")throw new ht(`Argument '${x}' expected true/false, got '${C}'`);s.set(x,C,void 0)}else s.set(x,m[p++]??"",void 0)}}let f=m.slice(p).join(" ");if(f){if(i)throw new ht(`Unexpected extra arguments: '${f}'`);n&&s.set("_extra",f,void 0)}}var ht,er=L(()=>{"use strict";ht=class extends Error{constructor(e){super(e),this.name="WxpArgumentsError"}}});function xs(t,e,s){switch(t.position){case"project":return Ze.default.resolve(e,t.path);case"pkg":return Ze.default.resolve(s,t.path);case"absolute":return Ze.default.resolve(t.path)}}function tr(t,e,s,r){let n=Ze.default.resolve(t),i=`${Ze.default.sep}.planning`;if(n.includes(`${i}${Ze.default.sep}`)||n.endsWith(i))return{ok:!1,reason:".planning/ files are never processed by WXP (hard security invariant)"};for(let o of e.untrustedPaths){let a=xs(o,s,r);if(n.startsWith(a+Ze.default.sep)||n===a)return{ok:!1,reason:`File '${t}' is in an explicitly untrusted path: ${a}`}}for(let o of e.trustedPaths){let a=xs(o,s,r);if(n.startsWith(a+Ze.default.sep)||n===a)return{ok:!0}}return{ok:!1,reason:`File '${t}' is not in a trusted WXP path.`}}function ei(t,e){let s=Ze.default.basename(t);return e.shellBanlist.includes(s)?{ok:!1,reason:`Command '${s}' is explicitly banned by WXP security config.`}:e.shellAllowlist.includes(s)?{ok:!0}:{ok:!1,reason:`Command '${s}' is not in the WXP shell allowlist. Allowed: ${e.shellAllowlist.join(", ")}`}}var Ze,Qr,Ht=L(()=>{"use strict";Ze=U(require("path")),Qr=["pi-gsd-tools","git","node","cat","ls","echo","find"]});function Ss(t,e){if(t.attrs.string!==void 0)return t.attrs.string;if(t.attrs.name!==void 0){let s=e.resolve(t.attrs.name)??"",r=t.attrs.wrap;return r?`${r}${s}${r}`:s}return t.attrs.value!==void 0?t.attrs.value:""}function ni(t,e,s){let r=t.attrs.command??"",n=ei(r,s);if(!n.ok)throw new yt(r,"",e.snapshot(),n.reason);let i=t.children.find(u=>u.tag==="args"),o=t.children.find(u=>u.tag==="outs"),a=i?i.children.filter(u=>u.tag==="arg").map(u=>Ss(u,e)):[],c=o?o.children.some(u=>u.tag==="suppress-errors"):!1,l=o?o.children.filter(u=>u.tag==="out"&&u.attrs.name).map(u=>u.attrs.name):[],d="";try{d=(0,ti.execFileSync)(r,a,{encoding:"utf8",timeout:s.shellTimeoutMs,windowsHide:!0}).trim()}catch(u){if(c){for(let f of l)e.set(f,"",void 0);return}let m=u,p=(m.stderr??m.message??String(u)).trim();throw new yt(r,p,e.snapshot(),`Shell '${r} ${a.join(" ")}' failed: ${p}`)}l.length>0&&e.set(l[0],d,void 0)}var ti,yt,bs=L(()=>{"use strict";ti=require("child_process");Ht();yt=class extends Error{constructor(s,r,n,i){super(i);this.command=s;this.stderr=r;this.variableSnapshot=n;this.name="WxpShellError"}command;stderr;variableSnapshot}});function si(t,e){if(t.attrs.op!=="split")throw new xt('<string-op> only op="split" is supported in v1');let r=t.children.find(m=>m.tag==="args"),n=t.children.find(m=>m.tag==="outs");if(!r||!n)throw new xt("<string-op> requires <args> and <outs>");let i=r.children.filter(m=>m.tag==="arg"),o=n.children.filter(m=>m.tag==="out"),a=i[0],c=i[1];if(!a)throw new xt('<string-op op="split"> requires at least 2 <arg> children');let l=Ss(a,e);if(a.attrs.name&&e.get(a.attrs.name)===void 0)throw new xt(`string-op split: source variable '${a.attrs.name}' is not defined`);let d=c?Ss(c,e):"",u=l.split(d);o.forEach((m,p)=>{let f=m.attrs.name;f&&e.set(f,u[p+1]??u[p]??"",void 0)})}var xt,nr=L(()=>{"use strict";bs();xt=class extends Error{constructor(e){super(e),this.name="WxpStringOpError"}}});function vs(t,e){return t.attrs.name?e.resolve(t.attrs.name)??"":t.attrs.value!==void 0?t.attrs.value:""}function ri(t){return t.attrs.type==="number"}function Ga(t,e){let s=t.children.find(a=>a.tag==="left"),r=t.children.find(a=>a.tag==="right");if(!s||!r)return!1;if(ri(s)||ri(r)){let a=Number(vs(s,e)),c=Number(vs(r,e));switch(t.tag){case"equals":return a===c;case"not-equals":return a!==c;case"less-than":return a<c;case"greater-than":return a>c;case"less-than-or-equal":return a<=c;case"greater-than-or-equal":return a>=c;default:return!1}}let i=vs(s,e),o=vs(r,e);switch(t.tag){case"equals":return i===o;case"not-equals":return i!==o;case"starts-with":return i.startsWith(o);case"contains":return i.includes(o);case"less-than":return Number(i)<Number(o);case"greater-than":return Number(i)>Number(o);case"less-than-or-equal":return Number(i)<=Number(o);case"greater-than-or-equal":return Number(i)>=Number(o);default:return!1}}function Zt(t,e){return t.tag==="and"?t.children.filter(s=>Xt.has(s.tag)).every(s=>Zt(s,e)):t.tag==="or"?t.children.filter(s=>Xt.has(s.tag)).some(s=>Zt(s,e)):Ga(t,e)}function ii(t,e){let s=t.children.find(n=>n.tag==="condition");if(!s)return!1;let r=s.children.find(n=>Xt.has(n.tag));return r?Zt(r,e):!1}function oi(t,e){let s=t.children.find(r=>Xt.has(r.tag));return s?Zt(s,e):!0}var Ba,Xt,ai=L(()=>{"use strict";Ba=new Set(["equals","not-equals","starts-with","contains","less-than","greater-than","less-than-or-equal","greater-than-or-equal"]),Xt=new Set([...Ba,"and","or"])});function Ja(t,e,s){let r=(t.attrs.msg??"").replace(/\{([^}]+)\}/g,(i,o)=>e.resolve(o)??""),n=t.attrs.level;s.onDisplay(r,n==="warning"||n==="error"?n:"info")}function Ya(t,e){let s=t.attrs.src??"",r=t.attrs.out??"",n=t.attrs.path,i=e.get(s);if(i===void 0)throw new Error(`<json-parse>: source variable '${s}' is not defined`);let o;try{o=JSON.parse(i)}catch{throw new Error(`<json-parse>: '${s}' does not contain valid JSON`)}if(n){let a=n.replace(/^\$\.?/,"").split("."),c=o;for(let l of a){if(c===null||typeof c!="object")throw new Error(`<json-parse>: path '${n}' not found`);c=c[l]}o=c}Array.isArray(o)?e.setArray(r,o.map(a=>typeof a=="string"?a:JSON.stringify(a))):o!==null&&typeof o=="object"?e.set(r,JSON.stringify(o),void 0):e.set(r,o==null?"":String(o),void 0)}function Ha(t,e){let s=t.attrs.path??"",r=t.attrs.out??"",n=Kt.default.readFileSync(Qt.default.resolve(s),"utf8");e.set(r,n,void 0)}function Xa(t,e,s){let r=t.attrs.path??"",n=t.attrs.src??"",i=Qt.default.resolve(r);if(Kt.default.existsSync(i))throw new Error(`<write-file>: '${r}' already exists (create-only, never overwrites)`);for(let a of s.config.trustedPaths){let c=xs(a,s.projectRoot,s.pkgRoot);if(i.startsWith(c+Qt.default.sep)||i===c)throw new Error(`<write-file>: cannot write to trusted harness path '${r}'`)}let o=e.get(n)??"";Kt.default.mkdirSync(Qt.default.dirname(i),{recursive:!0}),Kt.default.writeFileSync(i,o,"utf8")}function Za(t,e,s){let r=t.attrs.var??"",n=t.attrs.item??"",i=t.children.find(l=>l.tag==="where"),o=t.children.find(l=>l.tag==="sort-by"),a=t.children.filter(l=>l.tag!=="where"&&l.tag!=="sort-by"),c=e.getArray(r);if(c){if(i&&(c=c.filter(l=>(e.set(n,l,void 0),oi(i,e)))),o){let l=o.attrs.key??"",d=o.attrs.type??"string",u=o.attrs.order??"asc";c=[...c].sort((m,p)=>{e.set(n,m,void 0);let f=e.resolve(`${n}.${l}`)??e.resolve(l)??"";e.set(n,p,void 0);let g=e.resolve(`${n}.${l}`)??e.resolve(l)??"",h=d==="number"?Number(f)-Number(g):f.localeCompare(g);return u==="desc"?-h:h})}for(let l of c){e.set(n,l,void 0);for(let d of a)sr(d,e,s)}}}function sr(t,e,s){switch(t.tag){case"shell":ni(t,e,s.config);break;case"string-op":si(t,e);break;case"json-parse":Ya(t,e);break;case"read-file":Ha(t,e);break;case"write-file":Xa(t,e,s);break;case"display":Ja(t,e,s);break;case"for-each":Za(t,e,s);break;case"if":{let r=ii(t,e),n=t.children.find(a=>a.tag==="then"),i=t.children.find(a=>a.tag==="else"),o=r?n:i;if(o)for(let a of o.children)sr(a,e,s);break}case"gsd-execute":rr(t,e,s);break;default:break}}function rr(t,e,s){try{for(let r of t.children)sr(r,e,s)}catch(r){throw r instanceof yt||r instanceof Error?new _s(r,e.snapshot(),`Execution failed: ${r.message}`):r}}var Kt,Qt,_s,ir=L(()=>{"use strict";Kt=U(require("fs")),Qt=U(require("path"));bs();nr();ai();Ht();_s=class extends Error{constructor(s,r,n){super(n);this.cause=s;this.variableSnapshot=r;this.name="WxpExecutionError"}cause;variableSnapshot}});function ci(t,e){let s=ft(t),r=/<gsd-paste\s+name="([^"]+)"\s*\/>/g,n=[],i;for(;(i=r.exec(t))!==null;)gt(i.index,s)||n.push({index:i.index,full:i[0],name:i[1]});for(let a of n)if(e.get(a.name)===void 0)throw new ws(a.name,e.snapshot());let o=t;for(let a=n.length-1;a>=0;a--){let c=n[a],l=e.get(c.name);o=o.slice(0,c.index)+l+o.slice(c.index+c.full.length)}return o}var ws,or=L(()=>{"use strict";Qs();ws=class extends Error{constructor(s,r){super(`<gsd-paste name="${s}" /> references undefined variable '${s}'`);this.variableName=s;this.variableSnapshot=r;this.name="WxpPasteError"}variableName;variableSnapshot}});function li(t,e,s,r,n,i="",o=Qa){let a=tr(e,s,r,n);if(!a.ok)throw new St(e,new Error(a.reason),{},[],[]);return ec(t,e,s,r,n,i,o)}function ec(t,e,s,r,n,i,o){let a=Xr(),c=[],l=t,d={config:s,projectRoot:r,pkgRoot:n,onDisplay:o};for(let u=0;u<Ka;u++){let p=Yt(l).filter(g=>g.node.tag!=="gsd-version");if(p.length===0)break;let f=p.map(g=>g.node.tag);try{let g=!1;for(let x of Yt(l)){if(x.node.tag!=="gsd-include"||gt(x.start,ft(l)))continue;let S=x.node.attrs.path;if(!S)continue;let v=ks.default.resolve(r,S);if(!ar.default.existsSync(v))throw new Error(`Include not found: ${S}`);let C=tr(v,s,r,n);if(!C.ok)throw new Error(`Include rejected: ${C.reason}`);let P=ar.default.readFileSync(v,"utf8"),$=ks.default.basename(v,ks.default.extname(v));for(let k of x.node.children)if(k.tag==="gsd-arguments")for(let j of k.children.filter(R=>R.tag==="arg")){let R=j.attrs.name,E=j.attrs.as;if(R&&E){let V=a.get(R);V!==void 0&&a.set(E,V,$)}}let T="include-arguments"in x.node.attrs?`
 ${i}`:"";l=ys(l,x.start,x.end,P+T),c.push("gsd-include"),g=!0;break}if(g)continue;for(let x of Yt(l))if(x.node.tag==="gsd-arguments"&&!gt(x.start,ft(l))){Kr(x.node,i,a),l=ys(l,x.start,x.end,""),c.push("gsd-arguments"),g=!0;break}if(g)continue;for(let x of Yt(l))if(x.node.tag==="gsd-execute"&&!gt(x.start,ft(l))){rr(x.node,a,d),l=ys(l,x.start,x.end,""),c.push("gsd-execute"),g=!0;break}if(g)continue;let h=ci(l,a);if(h!==l){l=h,c.push("gsd-paste");continue}break}catch(g){if(g instanceof St)throw g;let h=g instanceof Error?g:new Error(String(g));throw new St(e,h,a.snapshot(),f,c)}}return l}var ar,ks,Ka,Qa,St,di=L(()=>{"use strict";ar=U(require("fs")),ks=U(require("path"));Qs();Zr();er();ir();or();Ht();ir();bs();or();nr();er();Ka=50,Qa=()=>{},St=class extends Error{constructor(s,r,n,i,o){super(["WXP Processing Error",`File: ${s}`,`Error: ${r.message}`,`Variable Namespace: ${JSON.stringify(n,null,2)}`,`Pending Operations: [${i.join(", ")}]`,`Completed Operations: [${o.join(", ")}]`].join(`
-`));this.filePath=s;this.cause=r;this.variableSnapshot=n;this.pendingOperations=i;this.completedOperations=o;this.name="WxpProcessingError"}filePath;cause;variableSnapshot;pendingOperations;completedOperations}});var bt,ui,cr,Ps,mi=L(()=>{"use strict";bt=require("@oclif/core"),ui=require("@oclif/core"),cr=U(require("path"));di();Ht();Ps=class t extends ui.Command{static description="Process WXP tags in a workflow file";static args={file:bt.Args.string({description:"File to process",required:!1})};static flags={input:bt.Flags.string({description:"Input content string (alternative to file)"}),arguments:bt.Flags.string({description:"Raw $ARGUMENTS string",default:""}),"project-root":bt.Flags.string({description:"Project root directory",default:process.cwd()}),"pkg-root":bt.Flags.string({description:"Package root directory",default:process.cwd()})};async run(){let{flags:e,args:s}=await this.parse(t),r,n;if(e.input!==void 0)r=e.input,n=cr.default.join(e["project-root"],".pi","gsd","workflows","_inline.md");else if(s.file){let o=await import("fs");n=cr.default.resolve(s.file),r=o.default.readFileSync(n,"utf8")}else{this.error("Provide a file argument or --input string");return}let i={trustedPaths:[{position:"project",path:".pi/gsd"},{position:"pkg",path:"gsd"}],untrustedPaths:[],shellAllowlist:[...Qr],shellBanlist:[],shellTimeoutMs:3e4};try{let o=li(r,n,i,e["project-root"],e["pkg-root"],e.arguments);process.stdout.write(o)}catch(o){throw o instanceof St&&this.error(o.message,{exit:1}),o}}}});var pi={};xe(pi,{AuditUatCommand:()=>Hn,CommitCommand:()=>is,ConfigEnsureSectionCommand:()=>Fn,ConfigGetCommand:()=>An,ConfigNewProjectCommand:()=>En,ConfigSetCommand:()=>jn,ConfigSetModelProfileCommand:()=>Rn,FrontmatterGetCommand:()=>os,FrontmatterMergeCommand:()=>cs,FrontmatterSetCommand:()=>as,InitCommand:()=>_n,MilestoneCompleteCommand:()=>Un,PhaseAddBatchCommand:()=>Tn,PhaseAddCommand:()=>In,PhaseCompleteCommand:()=>Nn,PhaseInsertCommand:()=>Dn,PhaseNextDecimalCommand:()=>Mn,PhasePlanIndexCommand:()=>Wn,PhaseRemoveCommand:()=>On,ProgressCommand:()=>ms,RequirementsMarkCompleteCommand:()=>Vn,RoadmapAnalyzeCommand:()=>Pn,RoadmapGetPhaseCommand:()=>$n,RoadmapUpdatePlanProgressCommand:()=>Cn,ScaffoldCommand:()=>ss,StateAdvancePlanCommand:()=>gn,StateGetCommand:()=>mn,StateJsonCommand:()=>un,StateLoadCommand:()=>hn,StatePatchCommand:()=>fn,StateReconcileCommand:()=>xn,StateUpdateCommand:()=>pn,StateUpdateProgressCommand:()=>yn,StatsCommand:()=>ps,SummaryExtractCommand:()=>hs,TemplateFillCommand:()=>us,TemplateSelectCommand:()=>ds,TodoCompleteCommand:()=>fs,TodoMatchPhaseCommand:()=>gs,ValidateAgentsCommand:()=>Jn,ValidateConsistencyCommand:()=>Bn,ValidateHealthCommand:()=>Gn,VerifyCommand:()=>Yn,WorkstreamCompleteCommand:()=>Qn,WorkstreamCreateCommand:()=>Xn,WorkstreamGetCommand:()=>ts,WorkstreamListCommand:()=>Zn,WorkstreamProgressCommand:()=>ns,WorkstreamSetCommand:()=>es,WorkstreamStatusCommand:()=>Kn,WxpProcessCommand:()=>Ps});var fi=L(()=>{"use strict";Pr();Cr();jr();Mr();Tr();Dr();Ur();Vr();zr();Br();Gr();Jr();Yr();mi()});var gi=Ei((Od,tc)=>{tc.exports={name:"pi-gsd",version:"2.0.24",description:"Get Shit Done - Unofficial port of the renowned AI-native project-planning spec-driven toolkit",main:"dist/pi-gsd-tools.js",bin:{"pi-gsd-tools":"./dist/pi-gsd-tools.js","pi-gsd":"./dist/pi-gsd-tools.js"},scripts:{build:"tsup",dev:"tsup src/cli.ts --format cjs --out-dir dist --watch",typecheck:"tsc --noEmit",check:"tsc --noEmit && npm run build",postinstall:"node scripts/postinstall.js",prepublishOnly:"npm run build",test:"vitest run","test:unit":"vitest run src/wxp/__tests__ --ignore src/wxp/__tests__/integration.test.ts","test:integration":"vitest run src/wxp/__tests__/integration.test.ts",lint:"eslint src/ --ext .ts"},files:["gsd","dist","scripts/postinstall.js","README.md","LICENSE"],engines:{node:">=18.0.0"},keywords:["ai","agent","planning","cli","workflow","get-shit-done","gsd","productivity","project-management","milestones","phases","spec","pi-package"],author:"Alessio Corsi",license:"MIT",repository:{type:"git",url:"https://github.com/fulgidus/pi-gsd.git"},bugs:{url:"https://github.com/fulgidus/pi-gsd/issues"},homepage:"https://github.com/fulgidus/pi-gsd#readme",publishConfig:{access:"public",registry:"https://registry.npmjs.org/"},pi:{extensions:["./dist/pi-gsd-hooks.js"],prompts:["./gsd/prompts"]},dependencies:{"@oclif/core":"^4.10.5","@toon-format/toon":"^2.1.0","jsonpath-plus":"^10.4.0",zod:"^3.25.76"},devDependencies:{"@mariozechner/pi-coding-agent":"^0.65.0","@types/node":"^22.0.0","@typescript-eslint/eslint-plugin":"^8.58.0","@typescript-eslint/parser":"^8.58.0",eslint:"^10.2.0",tsup:"^8.0.0",typescript:"^5.0.0",vitest:"^4.1.2"}}});var $s={};xe($s,{cmdExtractMessages:()=>oc,cmdProfileSample:()=>ac,cmdScanSessions:()=>ic});function lr(t){if(t)return t;let e=process.env.HOME??"",s=De.join(e,".agent","projects");return re.existsSync(s)?s:De.join(e,".claude","projects")}function dr(){let t=process.env.HOME??"";return De.join(t,".pi","agent","sessions")}function ur(t){return t.startsWith("--")&&t.endsWith("--")?"/"+t.slice(2,-2).replace(/-/g,"/"):t}function nc(t){try{let e=re.readFileSync(t,"utf-8").split(`
+`));this.filePath=s;this.cause=r;this.variableSnapshot=n;this.pendingOperations=i;this.completedOperations=o;this.name="WxpProcessingError"}filePath;cause;variableSnapshot;pendingOperations;completedOperations}});var bt,ui,cr,Ps,mi=L(()=>{"use strict";bt=require("@oclif/core"),ui=require("@oclif/core"),cr=U(require("path"));di();Ht();Ps=class t extends ui.Command{static description="Process WXP tags in a workflow file";static args={file:bt.Args.string({description:"File to process",required:!1})};static flags={input:bt.Flags.string({description:"Input content string (alternative to file)"}),arguments:bt.Flags.string({description:"Raw $ARGUMENTS string",default:""}),"project-root":bt.Flags.string({description:"Project root directory",default:process.cwd()}),"pkg-root":bt.Flags.string({description:"Package root directory",default:process.cwd()})};async run(){let{flags:e,args:s}=await this.parse(t),r,n;if(e.input!==void 0)r=e.input,n=cr.default.join(e["project-root"],".pi","gsd","workflows","_inline.md");else if(s.file){let o=await import("fs");n=cr.default.resolve(s.file),r=o.default.readFileSync(n,"utf8")}else{this.error("Provide a file argument or --input string");return}let i={trustedPaths:[{position:"project",path:".pi/gsd"},{position:"pkg",path:"gsd"}],untrustedPaths:[],shellAllowlist:[...Qr],shellBanlist:[],shellTimeoutMs:3e4};try{let o=li(r,n,i,e["project-root"],e["pkg-root"],e.arguments);process.stdout.write(o)}catch(o){throw o instanceof St&&this.error(o.message,{exit:1}),o}}}});var pi={};xe(pi,{AuditUatCommand:()=>Hn,CommitCommand:()=>is,ConfigEnsureSectionCommand:()=>Fn,ConfigGetCommand:()=>An,ConfigNewProjectCommand:()=>En,ConfigSetCommand:()=>jn,ConfigSetModelProfileCommand:()=>Rn,FrontmatterGetCommand:()=>os,FrontmatterMergeCommand:()=>cs,FrontmatterSetCommand:()=>as,InitCommand:()=>_n,MilestoneCompleteCommand:()=>Un,PhaseAddBatchCommand:()=>Tn,PhaseAddCommand:()=>In,PhaseCompleteCommand:()=>Nn,PhaseInsertCommand:()=>Dn,PhaseNextDecimalCommand:()=>Mn,PhasePlanIndexCommand:()=>Wn,PhaseRemoveCommand:()=>On,ProgressCommand:()=>ms,RequirementsMarkCompleteCommand:()=>Vn,RoadmapAnalyzeCommand:()=>Pn,RoadmapGetPhaseCommand:()=>$n,RoadmapUpdatePlanProgressCommand:()=>Cn,ScaffoldCommand:()=>ss,StateAdvancePlanCommand:()=>gn,StateGetCommand:()=>mn,StateJsonCommand:()=>un,StateLoadCommand:()=>hn,StatePatchCommand:()=>fn,StateReconcileCommand:()=>xn,StateUpdateCommand:()=>pn,StateUpdateProgressCommand:()=>yn,StatsCommand:()=>ps,SummaryExtractCommand:()=>hs,TemplateFillCommand:()=>us,TemplateSelectCommand:()=>ds,TodoCompleteCommand:()=>fs,TodoMatchPhaseCommand:()=>gs,ValidateAgentsCommand:()=>Jn,ValidateConsistencyCommand:()=>Bn,ValidateHealthCommand:()=>Gn,VerifyCommand:()=>Yn,WorkstreamCompleteCommand:()=>Qn,WorkstreamCreateCommand:()=>Xn,WorkstreamGetCommand:()=>ts,WorkstreamListCommand:()=>Zn,WorkstreamProgressCommand:()=>ns,WorkstreamSetCommand:()=>es,WorkstreamStatusCommand:()=>Kn,WxpProcessCommand:()=>Ps});var fi=L(()=>{"use strict";Pr();Cr();jr();Mr();Tr();Dr();Ur();Vr();zr();Br();Gr();Jr();Yr();mi()});var gi=Ei((Od,tc)=>{tc.exports={name:"pi-gsd",version:"2.1.0",description:"Get Shit Done - Unofficial port of the renowned AI-native project-planning spec-driven toolkit",main:"dist/pi-gsd-tools.js",bin:{"pi-gsd-tools":"./dist/pi-gsd-tools.js","pi-gsd":"./dist/pi-gsd-tools.js"},scripts:{build:"tsup",dev:"tsup src/cli.ts --format cjs --out-dir dist --watch",typecheck:"tsc --noEmit",check:"tsc --noEmit && npm run build",postinstall:"node scripts/postinstall.js",prepublishOnly:"npm run build",test:"vitest run","test:unit":"vitest run src/wxp/__tests__ --ignore src/wxp/__tests__/integration.test.ts","test:integration":"vitest run src/wxp/__tests__/integration.test.ts",lint:"eslint src/ --ext .ts"},files:["gsd","dist","scripts/postinstall.js","README.md","LICENSE"],engines:{node:">=18.0.0"},keywords:["ai","agent","planning","cli","workflow","get-shit-done","gsd","productivity","project-management","milestones","phases","spec","pi-package"],author:"Alessio Corsi",license:"MIT",repository:{type:"git",url:"https://github.com/fulgidus/pi-gsd.git"},bugs:{url:"https://github.com/fulgidus/pi-gsd/issues"},homepage:"https://github.com/fulgidus/pi-gsd#readme",publishConfig:{access:"public",registry:"https://registry.npmjs.org/"},pi:{extensions:["./dist/pi-gsd-hooks.js"],prompts:["./gsd/prompts"]},dependencies:{"@oclif/core":"^4.10.5","@toon-format/toon":"^2.1.0","jsonpath-plus":"^10.4.0",zod:"^3.25.76"},devDependencies:{"@mariozechner/pi-coding-agent":"^0.65.0","@types/node":"^22.0.0","@typescript-eslint/eslint-plugin":"^8.58.0","@typescript-eslint/parser":"^8.58.0",eslint:"^10.2.0",tsup:"^8.0.0",typescript:"^5.0.0",vitest:"^4.1.2"}}});var $s={};xe($s,{cmdExtractMessages:()=>oc,cmdProfileSample:()=>ac,cmdScanSessions:()=>ic});function lr(t){if(t)return t;let e=process.env.HOME??"",s=De.join(e,".agent","projects");return re.existsSync(s)?s:De.join(e,".claude","projects")}function dr(){let t=process.env.HOME??"";return De.join(t,".pi","agent","sessions")}function ur(t){return t.startsWith("--")&&t.endsWith("--")?"/"+t.slice(2,-2).replace(/-/g,"/"):t}function nc(t){try{let e=re.readFileSync(t,"utf-8").split(`
 `).find(r=>r.trim().length>0);if(!e)return!1;let s=JSON.parse(e);return s.type==="session"&&"version"in s}catch{return!1}}function sc(t){return typeof t=="string"?t:Array.isArray(t)?t.filter(e=>e!==null&&typeof e=="object"&&e.type==="text").map(e=>String(e.text??"")).join(" "):""}function rc(t){try{let e=re.readFileSync(t,"utf-8").split(`
 `).filter(Boolean),s=[];for(let r of e)try{let n=JSON.parse(r);n.type==="message"&&n.message&&s.push(n)}catch{}return s}catch{return[]}}async function ic(t,e,s){let n=(e.harness??null)==="pi",i=dr(),o=re.existsSync(i),a=[];if(o)try{let m=re.readdirSync(i,{withFileTypes:!0}).filter(p=>p.isDirectory());for(let p of m){let f=De.join(i,p.name),g=re.readdirSync(f).filter(h=>h.endsWith(".jsonl"));a.push({name:p.name,sessions:g.length,path:f,source:"pi",cwd:ur(p.name)})}}catch{}let c=lr(n&&!t?null:t),l=!n||t?re.existsSync(c):!1,d=[];if(l&&(!n||t))try{let m=re.readdirSync(c,{withFileTypes:!0}).filter(p=>p.isDirectory());for(let p of m){let f=De.join(c,p.name),g=re.readdirSync(f).filter(h=>h.endsWith(".jsonl")||h.endsWith(".json"));d.push({name:p.name,sessions:g.length,path:f,source:"claude"})}}catch{}let u=n?[...a,...d]:[...d,...a];if(u.length===0){let m=[];o?m.push(i):m.push(i+" (not found)"),n||m.push(l?c:c+" (not found)"),y({available:!1,reason:`No sessions found. Searched: ${m.join(", ")}`,projects:[],count:0},s);return}y({available:!0,pi_base:o?i:null,claude_base:l?c:null,projects:u,count:u.length},s)}async function oc(t,e,s,r){let n=dr(),i=null,o="claude";if(re.existsSync(n)){let d=De.join(n,t);if(re.existsSync(d))i=d,o="pi";else try{let u=re.readdirSync(n,{withFileTypes:!0}).filter(m=>m.isDirectory());for(let m of u){let p=ur(m.name);if(p.endsWith("/"+t)||p===t||m.name===t){i=De.join(n,m.name),o="pi";break}}}catch{}}if(!i){let d=lr(r),u=De.join(d,t);re.existsSync(u)&&(i=u,o="claude")}if(!i){y({error:`Project not found: ${t}`,available_projects:[]},s);return}let a=[],c=re.readdirSync(i).filter(d=>d.endsWith(".jsonl")),l=e.limit??null;for(let d of c){if(e.sessionId&&!d.includes(e.sessionId))continue;let u=De.join(i,d);if(o==="pi"||nc(u))try{let m=re.readFileSync(u,"utf-8").split(`
 `).filter(Boolean);for(let p of m)try{let f=JSON.parse(p);if(f.type==="message"&&f.message&&(a.push(f.message),l&&a.length>=l))break}catch{}}catch{}else try{let m=re.readFileSync(u,"utf-8").split(`

package/gsd/prompts/gsd-discuss-milestone.md

@@ -0,0 +1,7 @@
+---
+description: "Capture milestone scope before planning. Optional — /gsd-new-milestone works without it. Flags: --auto"
+---
+<gsd-include path=".pi/gsd/workflows/discuss-milestone.md" include-arguments />
+<gsd-include path=".pi/gsd/templates/milestone-context.md" />
+
+$ARGUMENTS

package/gsd/templates/milestone-context.md

@@ -0,0 +1,231 @@
+# Milestone Context Template
+
+Template for `.planning/MILESTONE-CONTEXT.md` — captures product scope decisions for an upcoming milestone.
+
+**Purpose:** Document what the milestone should deliver so `/gsd-new-milestone` can start with known intent rather than gathering it inline. Consumed and deleted by `new-milestone` after it generates requirements and a roadmap.
+
+**Key principle:** Product-level only. WHAT users will be able to do — not HOW it will be implemented. Implementation decisions happen in `/gsd-discuss-phase` per phase.
+
+**Downstream consumer:**
+- `new-milestone` — reads `<scope>` for feature scoping, `<constraints>` for requirements boundaries, `<success>` to inform success criteria in ROADMAP.md
+
+---
+
+## File Template
+
+```markdown
+# Milestone Context
+
+**Gathered:** [date]
+**Status:** Ready for /gsd-new-milestone
+
+<milestone_goal>
+## Goal
+
+[One sentence: what this milestone delivers for users]
+
+</milestone_goal>
+
+<scope>
+## Scope
+
+### In this milestone
+
+- **[Capability name]**: [What users can do — one line]
+- **[Capability name]**: [What users can do — one line]
+
+### Explicitly out of scope
+
+- **[Capability name]**: [Reason — "deferred to next milestone", "separate product area", etc.]
+
+[If no explicit exclusions: "No explicit exclusions — boundary is the in-scope list above"]
+
+</scope>
+
+<constraints>
+## Constraints
+
+- [Hard constraint — e.g., "no breaking changes to existing API"]
+- [Hard constraint — e.g., "must work with existing auth system"]
+
+[If none: "None — unconstrained milestone"]
+
+</constraints>
+
+<success>
+## Success Definition
+
+This milestone is successful when:
+- [Observable user outcome — something that can be demoed]
+- [Observable user outcome]
+
+</success>
+
+<open_questions>
+## Open Questions for Planning
+
+- [Question to resolve early in new-milestone or research]
+
+[If none: "None — scope is clear"]
+
+</open_questions>
+
+---
+
+*Milestone context gathered: [date]*
+*Run /gsd-new-milestone to start planning*
+```
+
+<good_examples>
+
+**Example 1: SaaS product — adding collaboration**
+
+```markdown
+# Milestone Context
+
+**Gathered:** 2025-03-15
+**Status:** Ready for /gsd-new-milestone
+
+<milestone_goal>
+## Goal
+
+Users can invite teammates and collaborate on projects in real time.
+
+</milestone_goal>
+
+<scope>
+## Scope
+
+### In this milestone
+
+- **Invite by email**: User can send invites to teammates by email address
+- **Role-based access**: Owner, editor, and viewer roles with clear permission boundaries
+- **Shared project view**: Teammates see the same project state with live updates
+- **Activity feed**: Users can see who changed what and when
+
+### Explicitly out of scope
+
+- **SSO / SAML**: Enterprise auth deferred to v2.0
+- **Guest links**: Public sharing without accounts — separate product decision needed
+
+</scope>
+
+<constraints>
+## Constraints
+
+- No breaking changes to existing project data model — solo users must not need to migrate
+- Invite emails must go through existing SendGrid integration (no new email provider)
+
+</constraints>
+
+<success>
+## Success Definition
+
+This milestone is successful when:
+- A user can invite a colleague and both see the same project within 60 seconds
+- A viewer cannot accidentally edit or delete content
+
+</success>
+
+<open_questions>
+## Open Questions for Planning
+
+- Should activity feed be real-time (websocket) or polling? Affects architecture phase ordering.
+- What happens to a project if the owner deletes their account?
+
+</open_questions>
+
+---
+
+*Milestone context gathered: 2025-03-15*
+*Run /gsd-new-milestone to start planning*
+```
+
+**Example 2: CLI tool — v1.1 reliability release**
+
+```markdown
+# Milestone Context
+
+**Gathered:** 2025-04-01
+**Status:** Ready for /gsd-new-milestone
+
+<milestone_goal>
+## Goal
+
+The backup CLI is reliable enough for unattended production use.
+
+</milestone_goal>
+
+<scope>
+## Scope
+
+### In this milestone
+
+- **Retry with backoff**: Transient network failures retry automatically, not silently fail
+- **Structured logging**: Machine-readable log output for monitoring integration
+- **Config file support**: Users can set defaults in a config file, not just flags
+- **Dry-run mode**: Users can preview what would be backed up before committing
+
+### Explicitly out of scope
+
+- **Restore command**: Planned for v1.2
+- **S3 backend**: Deferred — local filesystem only for now
+
+</scope>
+
+<constraints>
+## Constraints
+
+- Must remain backwards compatible with v1.0 flag interface — existing scripts must not break
+- No new runtime dependencies (Node built-ins only)
+
+</constraints>
+
+<success>
+## Success Definition
+
+This milestone is successful when:
+- A backup job can run overnight on a cron without manual intervention
+- A failed run produces a log entry that tells an ops engineer exactly what went wrong
+
+</success>
+
+<open_questions>
+## Open Questions for Planning
+
+- Should config file use TOML, JSON, or dotenv format? Research common CLI conventions.
+
+</open_questions>
+
+---
+
+*Milestone context gathered: 2025-04-01*
+*Run /gsd-new-milestone to start planning*
+```
+
+</good_examples>
+
+<guidelines>
+**What makes a good MILESTONE-CONTEXT.md:**
+
+Good goal (specific, user-observable):
+- "Users can invite teammates and collaborate on projects in real time."
+- "The backup CLI is reliable enough for unattended production use."
+
+Bad goal (too vague):
+- "Improve collaboration features"
+- "Make things more reliable"
+
+Good scope item (user action):
+- "User can invite colleagues by email address"
+- "Dry-run mode previews changes before committing"
+
+Bad scope item (implementation detail):
+- "Add Redis pub/sub for real-time updates"
+- "Refactor retry logic in backup module"
+
+**After creation:**
+- File lives at `.planning/MILESTONE-CONTEXT.md`
+- `new-milestone` reads it in step 2, uses it for requirements scoping, then deletes it
+- It does NOT persist — it's a handoff document, not a record
+</guidelines>

package/gsd/workflows/complete-milestone.md

@@ -230,12 +230,18 @@ Tag: v[X.Y]
 
 ## ▶ Next Up
 
-**Start Next Milestone** - questioning → research → requirements → roadmap
+**Start Next Milestone** - requirements → research → roadmap
 
 `/gsd-new-milestone`
 
 <sub>`/new` first → fresh context window</sub>
 
+---
+
+**Optional pre-step:** Capture scope intent before the planning session
+
+`/gsd-discuss-milestone` — crystallize what to build next, then run `/gsd-new-milestone`
+
 ---
 ```
 

package/gsd/workflows/discuss-milestone.md

@@ -0,0 +1,467 @@
+<gsd-version v="2.0.24" />
+
+<gsd-arguments>
+  <settings>
+    <keep-extra-args />
+  </settings>
+  <arg name="auto" type="flag" flag="--auto" optional />
+</gsd-arguments>
+
+<gsd-execute>
+  <shell command="pi-gsd-tools">
+    <args>
+      <arg string="init" />
+      <arg string="milestone-op" />
+    </args>
+    <outs>
+      <out type="string" name="init" />
+    </outs>
+  </shell>
+  <shell command="pi-gsd-tools">
+    <args>
+      <arg string="state" />
+      <arg string="json" />
+      <arg string="--raw" />
+    </args>
+    <outs>
+      <suppress-errors />
+      <out type="string" name="state" />
+    </outs>
+  </shell>
+  <shell command="pi-gsd-tools">
+    <args>
+      <arg string="roadmap" />
+      <arg string="analyze" />
+      <arg string="--raw" />
+    </args>
+    <outs>
+      <suppress-errors />
+      <out type="string" name="roadmap" />
+    </outs>
+  </shell>
+</gsd-execute>
+
+## Context (pre-injected)
+
+**Init:**
+<gsd-paste name="init" />
+
+**Project State:**
+<gsd-paste name="state" />
+
+**Current Roadmap:**
+<gsd-paste name="roadmap" />
+
+---
+
+<purpose>
+Crystallize what the next milestone should deliver before starting the planning machinery. You are a thinking partner — a PM who knows what shipped, asks smart questions, and helps the user clarify product scope before committing to a roadmap.
+
+Output: `.planning/MILESTONE-CONTEXT.md`, consumed by /gsd-new-milestone.
+
+Optional step — /gsd-new-milestone works without it. The value is separating the "what do we build?" conversation from the requirements and roadmapping machinery.
+</purpose>
+
+<philosophy>
+**User = product owner. Agent = PM/advisor.**
+
+The user knows:
+- What users are struggling with
+- What the next logical product step is
+- What MUST ship vs nice-to-have
+- Any hard constraints (tech, team, timeline)
+
+The user doesn't need to define:
+- How to structure phases (that's the roadmapper)
+- Implementation approach (that's research + discuss-phase)
+- Which requirements to write (that's new-milestone)
+
+Your job: help the user articulate a clear, scoped milestone intent that new-milestone can turn into requirements and a roadmap.
+</philosophy>
+
+<scope_guardrail>
+**Product-level only.** This discussion is about WHAT the milestone delivers, not HOW.
+
+**Allowed:**
+- "Should we tackle X or defer it?"
+- "What's the must-have vs nice-to-have split?"
+- "Any hard constraints for this cycle?"
+- "How will we know this milestone is done?"
+
+**Not here:**
+- "Should we use Redis or Postgres for this?"
+- "Which architecture pattern?"
+- "How should we structure the phases?"
+
+If the user goes implementation-level, redirect:
+```
+"That's a planning question — /gsd-new-milestone and /gsd-discuss-phase will handle it.
+For now: do you want [capability] in scope for this milestone?"
+```
+</scope_guardrail>
+
+<answer_validation>
+After every AskUserQuestion call, check if the response is empty or whitespace-only. If so:
+1. Retry once with the same parameters
+2. If still empty, present options as a plain-text numbered list
+
+**Text mode (`workflow.text_mode: true` or `--text` flag):**
+Replace ALL AskUserQuestion calls with plain-text numbered lists. User types a number.
+Required for Claude Code remote sessions where TUI menus don't forward.
+</answer_validation>
+
+<process>
+
+## 1. Initialize
+
+<!-- Context pre-injected above via WXP -->
+
+Parse init JSON for: `commit_docs`, `context_window`, `milestone_version`, `milestone_name`, `last_completed_milestone`, `roadmap_exists`, `state_exists`.
+
+**If `state_exists` is false:**
+```
+No .planning/ directory found. Set up a project first:
+
+/gsd-new-project
+```
+Exit workflow.
+
+Read project files:
+```bash
+cat .planning/PROJECT.md 2>/dev/null || true
+cat .planning/MILESTONES.md 2>/dev/null || true
+```
+
+Extract from PROJECT.md: project name, core value, non-negotiables, target users.
+Extract from MILESTONES.md: what shipped in completed milestones (summaries, not full detail).
+
+**Read text mode config:**
+```bash
+TEXT_MODE=$(pi-gsd-tools config-get workflow.text_mode 2>/dev/null || echo "false")
+```
+Enable text mode if `--text` in $ARGUMENTS OR `TEXT_MODE` is `true`.
+
+## 2. Check Existing MILESTONE-CONTEXT.md
+
+```bash
+test -f .planning/MILESTONE-CONTEXT.md && echo "exists" || echo "absent"
+```
+
+**If exists:**
+
+**If `--auto`:** Load existing content, continue to step 3 to refresh it. Log: `[auto] Existing MILESTONE-CONTEXT.md found — refreshing.`
+
+**Otherwise,** use AskUserQuestion:
+- header: "Context exists"
+- question: "MILESTONE-CONTEXT.md already exists. What do you want to do?"
+- options:
+  - "Update it" — Revise and improve existing context
+  - "View it" — Show current content, then decide
+  - "Skip" — Use as-is, go straight to /gsd-new-milestone
+
+If "View": display file contents, then re-ask "Update it" / "Skip".
+If "Skip": display `Next: /gsd-new-milestone` and exit.
+If "Update": load existing content, continue to step 3.
+
+**If absent:** Continue to step 3.
+
+## 3. Retrospective Framing
+
+Sets the context for "what's next" based on what shipped.
+
+**If `last_completed_milestone` is not null:**
+
+Read the matching section in `.planning/MILESTONES.md` for `last_completed_milestone.version`.
+
+Display (no user input needed):
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ Last milestone: [version] — [name]
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+[2-3 sentence summary of what shipped from MILESTONES.md]
+```
+
+Then ask ONE freeform question (plain text, NOT AskUserQuestion):
+
+> "What feedback or signals are shaping what you want to build next?"
+
+Wait for response. Use the answer to seed the scope discussion. Do not ask follow-ups from this — carry the insight forward.
+
+**If `--auto`:** Skip retrospective question. Read STATE.md accumulated context for any signals.
+
+**If no completed milestones:** Skip retrospective entirely. Continue to step 4.
+
+## 4. Gather Milestone Intent
+
+Open question to surface rough direction before structuring.
+
+Ask (plain text, NOT AskUserQuestion):
+
+> "What do you want this milestone to deliver? Give me the rough picture — we'll tighten the scope next."
+
+Wait for response. Parse it for:
+- Feature/capability mentions → candidates for scope-in
+- Exclusions or "not yet" signals → candidates for scope-out
+- Urgency or priority cues
+- Any constraints mentioned in passing
+
+Reflect back in 2-3 sentences:
+```
+"So the core of this milestone is [X]. You also mentioned [Y],
+and [Z] sounds like a natural boundary. Is that the right picture?"
+```
+
+If they confirm: proceed to step 5 with extracted candidates.
+If they adjust: incorporate and reflect again. Max 2 loops, then proceed.
+
+**If `--auto`:** Skip reflection loop. Extract candidates from the intent statement directly and proceed.
+
+## 5. Scope Discussion
+
+Turn the rough intent into a clear in/out split.
+
+**Build candidate list** from:
+- Step 4's response (feature/capability mentions)
+- STATE.md accumulated context (pending items, blockers noted)
+- MILESTONES.md "Future Requirements" or deferred items from last milestone
+- Any items in `.planning/REQUIREMENTS.md` marked Out of Scope that might be reconsidered
+
+Group related candidates into clusters (2-4 features per cluster). Present one cluster at a time.
+
+**For each cluster:**
+
+If text mode: present as numbered list with multi-select.
+Otherwise use AskUserQuestion (multiSelect: true):
+- header: "Scope: [cluster]" (max 12 chars)
+- question: "Which of these belong in this milestone?"
+- options: each candidate with a 1-line description
+
+After all clusters, show a running tally:
+```
+Scoped in:  [N] capabilities
+Deferred:   [M] capabilities
+```
+
+**Explicit exclusions** — after clusters are done:
+
+If text mode: ask as plain-text.
+Otherwise use AskUserQuestion:
+- header: "Out of scope"
+- question: "Anything to explicitly exclude — even if it seems related?"
+- options:
+  - "Nothing to add — the scope list covers it"
+  - "Yes, I want to explicitly exclude something"
+
+If "Yes": ask them to name it (plain text). Capture with reason.
+
+**If `--auto`:** Include everything mentioned in step 4's intent or with a clear priority signal. Exclude only items the user explicitly flagged as "not now" or "next milestone".
+
+## 6. Constraints
+
+Anything that bounds how this milestone must be shaped.
+
+If text mode: present as numbered multi-select list.
+Otherwise use AskUserQuestion (multiSelect: true):
+- header: "Constraints"
+- question: "Any hard constraints for this milestone?"
+- options:
+  - "No breaking changes — existing integrations must keep working"
+  - "No new external dependencies"
+  - "Must maintain backwards compatibility with existing data"
+  - "Performance budget — no regressions on key metrics"
+  - "None — this milestone is unconstrained"
+  - "Other — let me describe it"
+
+If "Other": ask plain text, record result.
+
+**If `--auto`:** Default to "None" unless PROJECT.md or STATE.md explicitly mentions active constraints.
+
+## 7. Success Definition
+
+How does "done" look from the outside?
+
+Ask (plain text, NOT AskUserQuestion):
+
+> "Finish this sentence: this milestone is a success when users can ___."
+
+Wait for response. Parse 1-3 observable outcomes.
+
+If the response is vague ("when everything works", "when it's polished"), prompt once:
+
+> "What's a concrete user action that proves it — something you could demo?"
+
+Capture outcomes. If they list more than 3, keep the 3 most concrete and user-observable.
+
+**If `--auto`:** Derive success outcomes from scoped capabilities — "user can [primary action]" for each major in-scope cluster.
+
+## 8. Open Questions
+
+Surface anything that needs resolving in new-milestone or early research — not as a blocker, but as a signal.
+
+Ask (plain text):
+
+> "Any open questions or risks you want the planning session to address early?"
+
+If they say "no" or give nothing: record "None — scope is clear."
+If they give questions: capture them for the MILESTONE-CONTEXT.md open_questions section.
+
+**If `--auto`:** Skip. Default to "None."
+
+## 9. Write MILESTONE-CONTEXT.md
+
+Write to `.planning/MILESTONE-CONTEXT.md`:
+
+```markdown
+# Milestone Context
+
+**Gathered:** [ISO date]
+**Status:** Ready for /gsd-new-milestone
+
+<milestone_goal>
+## Goal
+
+[One sentence distilled from step 4 — what this milestone delivers for users]
+
+</milestone_goal>
+
+<scope>
+## Scope
+
+### In this milestone
+
+[For each scoped-in capability, in priority order:]
+- **[Capability name]**: [1-line description of what it means for users]
+
+### Explicitly out of scope
+
+[For each explicit exclusion:]
+- **[Capability name]**: [reason — "deferred to next milestone", "separate product area", etc.]
+
+[If no explicit exclusions: "No explicit exclusions — boundary is the in-scope list above"]
+
+</scope>
+
+<constraints>
+## Constraints
+
+[For each constraint from step 6:]
+- [Constraint statement]
+
+[If none: "None — unconstrained milestone"]
+
+</constraints>
+
+<success>
+## Success Definition
+
+This milestone is successful when:
+- [Observable user outcome 1]
+- [Observable user outcome 2]
+[- [Observable user outcome 3] — only if genuinely distinct]
+
+</success>
+
+<open_questions>
+## Open Questions for Planning
+
+[Questions from step 8 that new-milestone or early research should address:]
+- [Question]
+
+[If none: "None — scope is clear"]
+
+</open_questions>
+
+---
+
+*Milestone context gathered: [date]*
+*Run /gsd-new-milestone to start planning*
+```
+
+## 10. Commit
+
+```bash
+pi-gsd-tools commit "docs: capture milestone context" --files .planning/MILESTONE-CONTEXT.md
+```
+
+If `commit_docs` is false: skip commit silently.
+
+## 11. Present Summary and Next Steps
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ GSD ► MILESTONE CONTEXT CAPTURED ✓
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+**Goal:** [one sentence from context file]
+
+**In scope ([N] capabilities):**
+[bullet list]
+
+**Constraints:** [list or "none"]
+**Success:** [first observable outcome]
+
+───────────────────────────────────────────────────────────────
+
+## ▶ Next Up
+
+**Start milestone planning** — requirements, research, roadmap
+
+`/gsd-new-milestone`
+
+<sub>`/new` first → fresh context window</sub>
+
+───────────────────────────────────────────────────────────────
+```
+
+## 12. Auto-Advance
+
+1. Parse `--auto` flag from $ARGUMENTS.
+2. Sync chain flag with intent — clear if not in `--auto` run:
+   ```bash
+   if [[ ! "$ARGUMENTS" =~ --auto ]]; then
+     pi-gsd-tools config-set workflow._auto_chain_active false 2>/dev/null
+   fi
+   ```
+3. Read chain flag and config:
+   ```bash
+   AUTO_CHAIN=$(pi-gsd-tools config-get workflow._auto_chain_active 2>/dev/null || echo "false")
+   AUTO_CFG=$(pi-gsd-tools config-get workflow.auto_advance 2>/dev/null || echo "false")
+   ```
+
+**If `--auto` OR `AUTO_CHAIN` is true OR `AUTO_CFG` is true:**
+
+Display:
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ GSD ► AUTO-ADVANCING TO NEW-MILESTONE
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Context captured. Launching new-milestone...
+```
+
+Launch:
+```
+Skill(skill="gsd-new-milestone", args="--auto ${GSD_WS}")
+```
+
+Handle return:
+- **MILESTONE INITIALIZED** → Display success banner, done.
+- **CHECKPOINT / BLOCKED** → Stop chain, show: `Continue: /gsd-new-milestone ${GSD_WS}`
+
+**If not auto:** Step 11 already shown. Done.
+
+</process>
+
+<success_criteria>
+- [ ] .planning/ exists (state_exists check)
+- [ ] Existing MILESTONE-CONTEXT.md handled (update/view/skip)
+- [ ] Last completed milestone surfaced for retrospective framing
+- [ ] Milestone intent gathered via open conversation
+- [ ] Scope in/out defined per capability cluster
+- [ ] Hard constraints captured
+- [ ] Success definition captured as observable user outcomes
+- [ ] Open questions captured for planning session
+- [ ] MILESTONE-CONTEXT.md written to .planning/
+- [ ] Committed (if commit_docs)
+- [ ] User knows next step: /gsd-new-milestone
+</success_criteria>

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pi-gsd",
-	"version": "2.0.24",
+	"version": "2.1.0",
 	"description": "Get Shit Done - Unofficial port of the renowned AI-native project-planning spec-driven toolkit",
 	"main": "dist/pi-gsd-tools.js",
 	"bin": {

package/scripts/postinstall.js

@@ -4,7 +4,7 @@
  *
  * Runs automatically after `npm install pi-gsd` (or `pi install npm:pi-gsd`).
  * Copies runtime harness content from this package's `gsd/` into the consumer
- * project's `.pi/gsd/`, and hook scripts into `.pi/hooks/`.
+ * project's `.pi/gsd/`, and hook scripts into `.pi/gsd/hooks/`.
  *
  * Version detection: each installed .md file carries a `<gsd-version v="X.Y.Z" />`
  * tag stamped with the npm package version that wrote it. On reinstall we read
@@ -14,7 +14,7 @@
  *
  * Excluded from the `.pi/gsd/` copy:
  *   gsd/prompts/  → served from npm package via pi.prompts (not installed locally)
- *   gsd/hooks/    → copied to .pi/hooks/ instead
+ *   gsd/hooks/    → copied to .pi/gsd/hooks/ instead
  */
 
 "use strict";
@@ -131,7 +131,7 @@ function main() {
     const gsdSrc    = path.join(PKG_DIR, "gsd");
     const gsdDest   = path.join(PROJECT_ROOT, ".pi", "gsd");
     const hooksSrc  = path.join(gsdSrc, "hooks");
-    const hooksDest = path.join(PROJECT_ROOT, ".pi", "hooks");
+    const hooksDest = path.join(PROJECT_ROOT, ".pi", "gsd", "hooks");
 
     // Detect installed version from a sample file's <gsd-version> tag.
     const sample = path.join(gsdDest, "workflows", "plan-phase.md");
@@ -164,11 +164,23 @@ function main() {
         log("skip", `.pi/gsd  (v${pkgVersion} already installed, ${gsdSkipped} files skipped)`);
     }
 
-    // ── Hook scripts → .pi/hooks/ ─────────────────────────────────────────────
+    // ── Hook scripts → .pi/gsd/hooks/ ──────────────────────────────────────────
     if (fs.existsSync(hooksSrc)) {
         const { copied: hCopied } = copyDir(hooksSrc, hooksDest, overwriteAll, null, pkgVersion);
         if (hCopied > 0) {
-            log("ok", `.pi/hooks  (${hCopied} hook${hCopied === 1 ? "" : "s"} installed)`);
+            log("ok", `.pi/gsd/hooks  (${hCopied} hook${hCopied === 1 ? "" : "s"} installed)`);
+        }
+    }
+
+    // ── Cleanup: stale .pi/hooks/ from old layout (pi ≥0.35 renames this dir) ──
+    const oldHooksDir = path.join(PROJECT_ROOT, ".pi", "hooks");
+    if (fs.existsSync(oldHooksDir)) {
+        const oldEntries = fs.readdirSync(oldHooksDir);
+        const allGsd = oldEntries.every((f) => f.startsWith("gsd-") && f.endsWith(".js"));
+        if (allGsd) {
+            for (const f of oldEntries) fs.rmSync(path.join(oldHooksDir, f));
+            fs.rmdirSync(oldHooksDir);
+            log("ok", ".pi/hooks  (removed - hooks moved to .pi/gsd/hooks/)");
         }
     }