ryugi-artifacts 1.70.2 → 1.71.0

package/README.md

@@ -9,6 +9,10 @@ npx ryugi-artifacts         # open the library of the current project
 npx ryugi-artifacts monitor # list running project servers
 ```
 
+Installed globally (`npm install -g ryugi-artifacts`), the command is `ryugi`;
+`ryugi-artifacts` stays as an alias. npx needs the package name, so
+`npx ryugi-artifacts` is the npx form.
+
 The server reads `.ryugi/artifacts/` in the selected project. Ryugi's skills
 start it for you; this package also runs standalone. Node.js is required.
 
@@ -28,12 +32,12 @@ Each operation declares its supported formats; unsupported modes fail before wor
 starts. There is no alternate legacy protocol or release gate.
 
 ```sh
-ryugi-artifacts check --artifact document/plan --format brief
-ryugi-artifacts publish --list --limit 10 --visibility private --format json
-ryugi-artifacts get https://ryugi.innei.dev/a/ID --format brief
-ryugi-artifacts get ID --detail --snapshot TOKEN --format json
-ryugi-artifacts get ID --download --out ./new-download --format json
-ryugi-artifacts config --output-format brief --project
+ryugi check --artifact document/plan --format brief
+ryugi publish --list --limit 10 --visibility private --format json
+ryugi get https://ryugi.innei.dev/a/ID --format brief
+ryugi get ID --detail --snapshot TOKEN --format json
+ryugi get ID --download --out ./new-download --format json
+ryugi config --output-format brief --project
 ```
 
 Selection order is explicit option, `RYUGI_ARTIFACTS_FORMAT`, project
@@ -54,7 +58,7 @@ Review reads are read-only. Preview a bounded page, read complete evidence, then
 explicitly acknowledge its receipt after using that evidence:
 
 For a complete review in one request, run
-`ryugi-artifacts comment list --artifact document/plan --sections all --detail`.
+`ryugi comment list --artifact document/plan --sections all --detail`.
 Documents include threads/asks; artboards include threads/groups/rounds. Each
 collection retains its own page, snapshot and continuation. Only a complete
 unread thread page issues a receipt; state collections do not. Follow every
@@ -62,11 +66,11 @@ relevant continuation before concluding. Filters, fields and existing cursors
 or snapshots require the single-collection form below.
 
 ```sh
-ryugi-artifacts comment list --artifact document/plan --section threads --format brief
-ryugi-artifacts comment read --artifact document/plan --thread THREAD --detail
-ryugi-artifacts comment ack --artifact document/plan --receipt RECEIPT
-ryugi-artifacts changes --artifact document/plan --detail
-ryugi-artifacts changes ack --artifact document/plan --receipt RECEIPT
+ryugi comment list --artifact document/plan --section threads --format brief
+ryugi comment read --artifact document/plan --thread THREAD --detail
+ryugi comment ack --artifact document/plan --receipt RECEIPT
+ryugi changes --artifact document/plan --detail
+ryugi changes ack --artifact document/plan --receipt RECEIPT
 ```
 
 `--all` and projected reads never issue receipts. Asks, groups and rounds are

package/dist/cli.cjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-"use strict";var Kn=Object.create;var Yt=Object.defineProperty;var Qn=Object.getOwnPropertyDescriptor;var Zn=Object.getOwnPropertyNames;var eo=Object.getPrototypeOf,to=Object.prototype.hasOwnProperty;var ro=(e,t,r,n)=>{if(t&&typeof t=="object"||typeof t=="function")for(let o of Zn(t))!to.call(e,o)&&o!==r&&Yt(e,o,{get:()=>t[o],enumerable:!(n=Qn(t,o))||n.enumerable});return e};var S=(e,t,r)=>(r=e!=null?Kn(eo(e)):{},ro(t||!e||!e.__esModule?Yt(r,"default",{value:e,enumerable:!0}):r,e));var Kt=require("node:util");var f=class extends Error{constructor(r,n="failed",o){super(r.message);this.error=r;this.kind=n;this.raw=o}error;kind;raw};function _e(e){if(e instanceof f)return e.error;let t=e,r=t?.fields;return{code:typeof r?.code=="string"?`E_${r.code.toUpperCase().replace(/^E_/,"")}`:"E_COMMAND_FAILED",message:typeof t?.message=="string"&&t.message?t.message:typeof r?.message=="string"?r.message:String(e),...typeof r?.status=="number"?{httpStatus:r.status}:{},...r&&Object.keys(r).length?{details:r}:{}}}function ce(e,t=!1){switch(e.kind){case"succeeded":return{outcome:t?"attention":"success",code:0};case"validation_failed":return{outcome:"attention",code:3};case"pending":return{outcome:"pending",code:4};case"action_required":return{outcome:"attention",code:2};case"partial":return{outcome:"partial",code:5};case"failed":return{outcome:"error",code:1};case"interrupted":return{outcome:"error",code:e.signal==="SIGINT"?130:143}}}function Jt(e,t,r,n){return!e||typeof e!="object"||Array.isArray(e)?e:Object.fromEntries(Object.entries(e).filter(([o])=>t.includes(o)?!0:(n.push({path:`${r}.${o}`,reason:"fields"}),!1)))}function ht(e,t,r,n){let o=[...t.coverage.omitted??[]],s=t.data;if(r.fields){let i=[...new Set([...r.fields,...n.requiredFields??[]])];if(n.collection&&s&&typeof s=="object"){let a=s,u=a[n.collection];s={...a,[n.collection]:Array.isArray(u)?u.map((p,d)=>Jt(p,i,`data.${n.collection}.${d}`,o)):u}}else s=Jt(s,i,"data",o)}return{schema:"ryugi.cli/v1",command:e,outcome:ce(t.completion,t.warnings.length>0).outcome,data:s,...t.coverage.page?{page:t.coverage.page}:{},...o.length?{omitted:o}:{},...t.effects.length?{effects:t.effects}:{},...t.warnings.length?{warnings:t.warnings}:{},...t.actions.length?{next:t.actions}:{},...t.completion.kind==="failed"?{error:t.completion.error}:t.completion.kind==="interrupted"?{error:{code:"E_INTERRUPTED",message:`Command interrupted by ${t.completion.signal}.`,details:{signal:t.completion.signal}}}:{}}}var Xt={format:{type:"string",value:"<brief|table|json|jsonl|raw>",help:"Output format (default: brief)"},json:{type:"boolean",help:"Shorthand for --format json"},detail:{type:"boolean",help:"Read complete evidence for the selected object or page"},fields:{type:"string",value:"<fields>",help:"Select public output fields, separated by commas"},quiet:{type:"boolean",help:"Print the command's declared scalar only"},verbose:{type:"boolean",help:"Include diagnostic details on stderr"}};function yt(e,t){let r={};for(let n=0;n<e.length;n++){let o=e[n];if(o==="--")break;if(!o.startsWith("--"))continue;let s=o.indexOf("="),i=o.slice(2,s<0?void 0:s),a=i==="source"?"boolean":t[i]?.type;a==="string"?r[i]=s<0?e[++n]??"":o.slice(s+1):a==="boolean"&&(r[i]=!0)}return r}function bt(e,t,r=process.env){let n=yt(e,t),o=["format","json","quiet","source"].filter(l=>n[l]!==void 0),s=r.RYUGI_ARTIFACTS_FORMAT??"brief",i=n.format??(n.json?"json":n.quiet?"quiet":n.source?"source":s),u=["brief","table","json","jsonl","raw","source","quiet"].includes(i),p={format:u?i:"brief",detail:!!n.detail||!!n.source,verbose:!!n.verbose},d;return o.length>1?d=new f({code:"E_OPTION_CONFLICT",message:"Choose one of --format, --json, --quiet or --source."}):(!u||!o.length&&!["brief","json","jsonl"].includes(s))&&(d=new f({code:"E_FORMAT_UNSUPPORTED",message:`Unknown output format: ${String(i)}`})),typeof n.fields=="string"&&(p.fields=n.fields.split(",").map(l=>l.trim()),p.fields.some(l=>!l)&&(d=new f({code:"E_ARGUMENT_INVALID",message:"--fields requires comma-separated field names."}))),{options:p,...d?{error:d}:{}}}var ue=S(require("node:fs"),1),zt=S(require("node:os"),1),M=S(require("node:path"),1),w=class extends Error{constructor(r,n={},o=1){super(r);this.fields=n;this.code=o}fields;code};function no(e){let t="";try{t=ue.default.realpathSync(zt.default.homedir())}catch{}let r=[];for(let n=e;r.push(n),!(ue.default.existsSync(M.default.join(n,".git"))&&(n!==t||e===t));n=M.default.dirname(n))if(M.default.dirname(n)===n)return e;return r.find(n=>ue.default.existsSync(M.default.join(n,".ryugi","artifacts")))??r.at(-1)}function z(e){let t;try{if(t=ue.default.realpathSync(M.default.resolve(e)),!ue.default.statSync(t).isDirectory())throw new Error("Not a directory")}catch{throw new w(`Project directory not found: ${e}`)}t=no(t);let r=M.default.join(t,".ryugi","artifacts"),n=M.default.join(r,".state");return{project:t,root:r,state:n,pid:M.default.join(n,"server.pid"),log:M.default.join(n,"server.log"),serverId:M.default.join(n,"server-instance-id"),info:M.default.join(n,"server-info"),version:M.default.join(n,"server-version"),owners:M.default.join(n,"owners"),agent:M.default.join(n,"agent"),stopped:M.default.join(n,"server-stopped"),lock:M.default.join(n,"start.lock")}}var ye=()=>process.env.RYUGI_ARTIFACTS_COMMAND||"ryugi-artifacts",le=/^(artboard|document|html|whiteboard)\/[a-z0-9][a-z0-9-]*$/,je="--artifact must be <type>/<id>: type artboard, document or html, id of lowercase letters, digits and hyphens";var Te="ryugi-artifacts",te={...Xt,"project-dir":{type:"string",value:"<path>",help:"Project directory (default: current directory)"}},Qt={help:{type:"boolean",short:"h",help:"Show this help"}};function be(e,t,r=0){let n=Object.fromEntries(Object.entries({...te,...t}).map(([o,{type:s,short:i}])=>[o,i?{type:s,short:i}:{type:s}]));try{let o=(0,Kt.parseArgs)({args:e,options:n,allowPositionals:r>0,strict:!0});if(o.positionals.length>r)throw new w(`Unknown argument: ${o.positionals[r]}`);return{values:o.values,positionals:o.positionals,projectDir:o.values["project-dir"]??process.cwd()}}catch(o){if(o instanceof w)throw o;let s=/'([^']+)'/.exec(o.message)?.[1];throw new w(s?`Unknown argument: ${s.split(" ")[0]}`:o.message)}}function Zt(e){let t=e.indexOf("--");return(t===-1?e:e.slice(0,t)).some(r=>r==="--help"||r==="-h")}function wt(e){let t=Math.max(...e.map(([r])=>r.length))+2;return e.map(([r,n])=>`  ${r.padEnd(t)}${n.replaceAll(`
+"use strict";var Kn=Object.create;var Yt=Object.defineProperty;var Qn=Object.getOwnPropertyDescriptor;var Zn=Object.getOwnPropertyNames;var eo=Object.getPrototypeOf,to=Object.prototype.hasOwnProperty;var ro=(e,t,r,n)=>{if(t&&typeof t=="object"||typeof t=="function")for(let o of Zn(t))!to.call(e,o)&&o!==r&&Yt(e,o,{get:()=>t[o],enumerable:!(n=Qn(t,o))||n.enumerable});return e};var S=(e,t,r)=>(r=e!=null?Kn(eo(e)):{},ro(t||!e||!e.__esModule?Yt(r,"default",{value:e,enumerable:!0}):r,e));var Kt=require("node:util");var f=class extends Error{constructor(r,n="failed",o){super(r.message);this.error=r;this.kind=n;this.raw=o}error;kind;raw};function _e(e){if(e instanceof f)return e.error;let t=e,r=t?.fields;return{code:typeof r?.code=="string"?`E_${r.code.toUpperCase().replace(/^E_/,"")}`:"E_COMMAND_FAILED",message:typeof t?.message=="string"&&t.message?t.message:typeof r?.message=="string"?r.message:String(e),...typeof r?.status=="number"?{httpStatus:r.status}:{},...r&&Object.keys(r).length?{details:r}:{}}}function ce(e,t=!1){switch(e.kind){case"succeeded":return{outcome:t?"attention":"success",code:0};case"validation_failed":return{outcome:"attention",code:3};case"pending":return{outcome:"pending",code:4};case"action_required":return{outcome:"attention",code:2};case"partial":return{outcome:"partial",code:5};case"failed":return{outcome:"error",code:1};case"interrupted":return{outcome:"error",code:e.signal==="SIGINT"?130:143}}}function Jt(e,t,r,n){return!e||typeof e!="object"||Array.isArray(e)?e:Object.fromEntries(Object.entries(e).filter(([o])=>t.includes(o)?!0:(n.push({path:`${r}.${o}`,reason:"fields"}),!1)))}function ht(e,t,r,n){let o=[...t.coverage.omitted??[]],s=t.data;if(r.fields){let i=[...new Set([...r.fields,...n.requiredFields??[]])];if(n.collection&&s&&typeof s=="object"){let a=s,u=a[n.collection];s={...a,[n.collection]:Array.isArray(u)?u.map((p,d)=>Jt(p,i,`data.${n.collection}.${d}`,o)):u}}else s=Jt(s,i,"data",o)}return{schema:"ryugi.cli/v1",command:e,outcome:ce(t.completion,t.warnings.length>0).outcome,data:s,...t.coverage.page?{page:t.coverage.page}:{},...o.length?{omitted:o}:{},...t.effects.length?{effects:t.effects}:{},...t.warnings.length?{warnings:t.warnings}:{},...t.actions.length?{next:t.actions}:{},...t.completion.kind==="failed"?{error:t.completion.error}:t.completion.kind==="interrupted"?{error:{code:"E_INTERRUPTED",message:`Command interrupted by ${t.completion.signal}.`,details:{signal:t.completion.signal}}}:{}}}var Xt={format:{type:"string",value:"<brief|table|json|jsonl|raw>",help:"Output format (default: brief)"},json:{type:"boolean",help:"Shorthand for --format json"},detail:{type:"boolean",help:"Read complete evidence for the selected object or page"},fields:{type:"string",value:"<fields>",help:"Select public output fields, separated by commas"},quiet:{type:"boolean",help:"Print the command's declared scalar only"},verbose:{type:"boolean",help:"Include diagnostic details on stderr"}};function yt(e,t){let r={};for(let n=0;n<e.length;n++){let o=e[n];if(o==="--")break;if(!o.startsWith("--"))continue;let s=o.indexOf("="),i=o.slice(2,s<0?void 0:s),a=i==="source"?"boolean":t[i]?.type;a==="string"?r[i]=s<0?e[++n]??"":o.slice(s+1):a==="boolean"&&(r[i]=!0)}return r}function bt(e,t,r=process.env){let n=yt(e,t),o=["format","json","quiet","source"].filter(l=>n[l]!==void 0),s=r.RYUGI_ARTIFACTS_FORMAT??"brief",i=n.format??(n.json?"json":n.quiet?"quiet":n.source?"source":s),u=["brief","table","json","jsonl","raw","source","quiet"].includes(i),p={format:u?i:"brief",detail:!!n.detail||!!n.source,verbose:!!n.verbose},d;return o.length>1?d=new f({code:"E_OPTION_CONFLICT",message:"Choose one of --format, --json, --quiet or --source."}):(!u||!o.length&&!["brief","json","jsonl"].includes(s))&&(d=new f({code:"E_FORMAT_UNSUPPORTED",message:`Unknown output format: ${String(i)}`})),typeof n.fields=="string"&&(p.fields=n.fields.split(",").map(l=>l.trim()),p.fields.some(l=>!l)&&(d=new f({code:"E_ARGUMENT_INVALID",message:"--fields requires comma-separated field names."}))),{options:p,...d?{error:d}:{}}}var ue=S(require("node:fs"),1),zt=S(require("node:os"),1),M=S(require("node:path"),1),w=class extends Error{constructor(r,n={},o=1){super(r);this.fields=n;this.code=o}fields;code};function no(e){let t="";try{t=ue.default.realpathSync(zt.default.homedir())}catch{}let r=[];for(let n=e;r.push(n),!(ue.default.existsSync(M.default.join(n,".git"))&&(n!==t||e===t));n=M.default.dirname(n))if(M.default.dirname(n)===n)return e;return r.find(n=>ue.default.existsSync(M.default.join(n,".ryugi","artifacts")))??r.at(-1)}function z(e){let t;try{if(t=ue.default.realpathSync(M.default.resolve(e)),!ue.default.statSync(t).isDirectory())throw new Error("Not a directory")}catch{throw new w(`Project directory not found: ${e}`)}t=no(t);let r=M.default.join(t,".ryugi","artifacts"),n=M.default.join(r,".state");return{project:t,root:r,state:n,pid:M.default.join(n,"server.pid"),log:M.default.join(n,"server.log"),serverId:M.default.join(n,"server-instance-id"),info:M.default.join(n,"server-info"),version:M.default.join(n,"server-version"),owners:M.default.join(n,"owners"),agent:M.default.join(n,"agent"),stopped:M.default.join(n,"server-stopped"),lock:M.default.join(n,"start.lock")}}var ye=()=>process.env.RYUGI_ARTIFACTS_COMMAND||"ryugi",le=/^(artboard|document|html|whiteboard)\/[a-z0-9][a-z0-9-]*$/,je="--artifact must be <type>/<id>: type artboard, document or html, id of lowercase letters, digits and hyphens";var Te="ryugi",te={...Xt,"project-dir":{type:"string",value:"<path>",help:"Project directory (default: current directory)"}},Qt={help:{type:"boolean",short:"h",help:"Show this help"}};function be(e,t,r=0){let n=Object.fromEntries(Object.entries({...te,...t}).map(([o,{type:s,short:i}])=>[o,i?{type:s,short:i}:{type:s}]));try{let o=(0,Kt.parseArgs)({args:e,options:n,allowPositionals:r>0,strict:!0});if(o.positionals.length>r)throw new w(`Unknown argument: ${o.positionals[r]}`);return{values:o.values,positionals:o.positionals,projectDir:o.values["project-dir"]??process.cwd()}}catch(o){if(o instanceof w)throw o;let s=/'([^']+)'/.exec(o.message)?.[1];throw new w(s?`Unknown argument: ${s.split(" ")[0]}`:o.message)}}function Zt(e){let t=e.indexOf("--");return(t===-1?e:e.slice(0,t)).some(r=>r==="--help"||r==="-h")}function wt(e){let t=Math.max(...e.map(([r])=>r.length))+2;return e.map(([r,n])=>`  ${r.padEnd(t)}${n.replaceAll(`
 `,`
   ${" ".repeat(t)}`)}`.trimEnd()).join(`
 `)}function er(e){return Object.entries(e).filter(([,t])=>t.help!==void 0).map(([t,r])=>[`${r.short?`-${r.short}, `:""}--${t}${r.value?` ${r.value}`:""}`,r.help])}function tr(e){return[(e.usage??["[options]"]).map((r,n)=>`${n?"       ":"Usage: "}${Te} ${e.name} ${r}`).join(`
@@ -62,7 +62,7 @@ function run(urls) {
 `)}function Fs(e){let t={...process.env,ARTIFACTS_HOST:e.host,ARTIFACTS_URL_HOST:e.urlHost};process.env.RYUGI_ARTIFACTS_COMMAND&&(t.RYUGI_ARTIFACTS_LAUNCHER=process.env.RYUGI_ARTIFACTS_COMMAND);for(let r of["RYUGI_ARTIFACTS_OWNER","RYUGI_ARTIFACTS_VERSION","RYUGI_ARTIFACTS_COMMAND","ARTIFACTS_OPEN_CMD","ARTIFACTS_ROOT"])delete t[r];return t}var Ms=e=>e.split(`
 `).find(t=>t.includes('"server-started"')),Us=e=>e.split(`
 `).find(t=>t.includes('"server-error"'));async function Gs(e,t,r){let n=await fetch(Vt(e,"/api/hub/projects"),{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({dir:t.project,...r?{open:r}:{},...r&&process.env.ARTIFACTS_OPEN_CMD?{openCmd:process.env.ARTIFACTS_OPEN_CMD}:{}}),signal:AbortSignal.timeout(Is)});if(!n.ok)throw new w(`The artifacts server refused this project: ${await n.text()}`)}async function Ut(e,t){if(t.signal?.throwIfAborted(),e.artifact!==void 0&&!le.test(e.artifact))throw new w(je);if(e.port!==void 0&&(!/^\d+$/.test(e.port)||Number(e.port)<1||Number(e.port)>65535))throw new w("--port must be a port number");e.urlHost||=e.host==="127.0.0.1"||e.host==="localhost"?"localhost":e.host,process.umask(63);let r=z(e.projectDir),n=pe();dr(n.home),U.default.mkdirSync(r.state,{recursive:!0}),U.default.existsSync(dt.default.join(r.state,".gitignore"))||U.default.writeFileSync(dt.default.join(r.state,".gitignore"),`*
-`);let o=process.env.RYUGI_ARTIFACTS_VERSION||"1.70.2",s=fe(n.projects).some(p=>p.dir===r.project),i=async(p,d)=>{Ls(r);let l=e.open&&!e.library&&(!d||!s);await Gs(p,r,l?e.artifact??!0:void 0);let m=js(p,r,e.artifact);d&&(m.reused=!0);let C=await Ts(m,p,r,e.artifact),T=xn(r.project);if(t.signal?.throwIfAborted(),e.library&&e.open&&(process.env.ARTIFACTS_OPEN_CMD?await new Promise(j=>(0,Oe.execFile)(process.env.ARTIFACTS_OPEN_CMD,[p.url],()=>j())):await Dt(p.url,[p.url]).catch(j=>t.log(j.message,"stderr"))),await t.ready(T?{...C,loginHint:T}:C),d&&s&&process.platform==="darwin"&&e.open&&e.openExisting&&e.artifact&&!process.env.ARTIFACTS_OPEN_CMD){let j=C.link;await Dt(typeof C.cloudLink=="string"?C.cloudLink:j,[j]).catch(D=>t.log(D.message,"stderr"))}};if(!await $s(n.lock))throw new w("Another start is still starting the artifacts server; retry in a moment");let a=!0,u=()=>{if(a){a=!1;try{U.default.rmdirSync(n.lock)}catch{}}};try{t.signal?.throwIfAborted();let p=Ps(n),d=Pn(n);if(p&&!d){for(let k=0;k<Os&&J(p)&&!d;k+=100)await me(100),d=Pn(n);!d&&J(p)&&await Nn(p,"stopping artifacts server")}if(p&&d){let k=W(n.version)??"",y=Tn(k,o),c=(d.host??"127.0.0.1")!==e.host||(d.urlHost??"localhost")!==e.urlHost||(d.cloudOrigin??Ln)!==xs(process.env)||e.port!==void 0&&String(d.port)!==e.port;if(y!=="replace"&&!c&&await Ns(d))return u(),await i(d,!0),0;await Nn(p,"running artifacts server")}await Ds(),U.default.rmSync(n.info,{force:!0});let l=Dn.default.randomBytes(24).toString("hex");U.default.writeFileSync(n.serverId,`${l}
+`);let o=process.env.RYUGI_ARTIFACTS_VERSION||"1.71.0",s=fe(n.projects).some(p=>p.dir===r.project),i=async(p,d)=>{Ls(r);let l=e.open&&!e.library&&(!d||!s);await Gs(p,r,l?e.artifact??!0:void 0);let m=js(p,r,e.artifact);d&&(m.reused=!0);let C=await Ts(m,p,r,e.artifact),T=xn(r.project);if(t.signal?.throwIfAborted(),e.library&&e.open&&(process.env.ARTIFACTS_OPEN_CMD?await new Promise(j=>(0,Oe.execFile)(process.env.ARTIFACTS_OPEN_CMD,[p.url],()=>j())):await Dt(p.url,[p.url]).catch(j=>t.log(j.message,"stderr"))),await t.ready(T?{...C,loginHint:T}:C),d&&s&&process.platform==="darwin"&&e.open&&e.openExisting&&e.artifact&&!process.env.ARTIFACTS_OPEN_CMD){let j=C.link;await Dt(typeof C.cloudLink=="string"?C.cloudLink:j,[j]).catch(D=>t.log(D.message,"stderr"))}};if(!await $s(n.lock))throw new w("Another start is still starting the artifacts server; retry in a moment");let a=!0,u=()=>{if(a){a=!1;try{U.default.rmdirSync(n.lock)}catch{}}};try{t.signal?.throwIfAborted();let p=Ps(n),d=Pn(n);if(p&&!d){for(let k=0;k<Os&&J(p)&&!d;k+=100)await me(100),d=Pn(n);!d&&J(p)&&await Nn(p,"stopping artifacts server")}if(p&&d){let k=W(n.version)??"",y=Tn(k,o),c=(d.host??"127.0.0.1")!==e.host||(d.urlHost??"localhost")!==e.urlHost||(d.cloudOrigin??Ln)!==xs(process.env)||e.port!==void 0&&String(d.port)!==e.port;if(y!=="replace"&&!c&&await Ns(d))return u(),await i(d,!0),0;await Nn(p,"running artifacts server")}await Ds(),U.default.rmSync(n.info,{force:!0});let l=Dn.default.randomBytes(24).toString("hex");U.default.writeFileSync(n.serverId,`${l}
 `),U.default.writeFileSync(n.version,`${o}
 `);let C=[dt.default.join(__dirname,"server.cjs"),`--artifacts-server-id=${l}`,...e.port?[`--port=${e.port}`]:[]],T=Fs(e);if(e.foreground||!e.background&&!!process.env.CODEX_CI){let k=(0,Oe.spawn)(process.execPath,C,{env:T,stdio:["ignore","pipe","pipe"]});U.default.writeFileSync(n.pid,`${k.pid}
 `);let y=()=>{k.kill("SIGTERM")};if(t.signal)t.signal.addEventListener("abort",y,{once:!0});else for(let v of["SIGINT","SIGTERM"])process.on(v,y);Gt.default.createInterface({input:k.stderr}).on("line",v=>t.log(v,"stderr"));let c=new Promise(v=>k.on("close",I=>v(I??1))),h=!1,g;Gt.default.createInterface({input:k.stdout}).on("line",v=>{let I;try{I=JSON.parse(v)}catch{t.log(v,"stdout");return}if(I.type!=="server-started"||h){t.event?t.event(I):I.type==="server-error"||I.type==="error"?t.failure(I):t.log(JSON.stringify(I),"stderr");return}h=!0,u(),g=i(I,!1),g.catch(()=>y())});try{let v=await c;return await g,v}finally{if(t.signal)t.signal.removeEventListener("abort",y);else for(let v of["SIGINT","SIGTERM"])process.removeListener(v,y)}}try{U.default.renameSync(n.log,`${n.log}.1`)}catch{}let D=U.default.openSync(n.log,"w"),b=(0,Oe.spawn)(process.execPath,C,{env:T,detached:!0,windowsHide:!0,stdio:["ignore",D,D]});U.default.closeSync(D),b.unref(),U.default.writeFileSync(n.pid,`${b.pid}
@@ -70,4 +70,4 @@ function run(urls) {
 `)};if(W(e.pid)===null)return{status:"not_running"};let r=Number(W(e.pid)),n=W(e.serverId)??"";if(!Number.isInteger(r)||r<=0||!/^[\w-]{32,64}$/.test(n)||!Se(r,n))return ee.default.rmSync(e.pid,{force:!0}),ee.default.rmSync(e.serverId,{force:!0}),t("stale_pid"),{status:"stale_pid"};try{process.kill(r,"SIGTERM")}catch{}if(!await re(r,7e3)){try{process.kill(r,"SIGKILL")}catch{}await re(r,1e3)}if(J(r))return{status:"failed",error:"process still running"};for(let o of[e.pid,e.serverId])ee.default.rmSync(o,{force:!0});return t("stop"),{status:"stopped"}}var Un={name:"stop",summary:"Stop this machine's artifacts server; the artifacts are kept",usage:["[options]"],options:{},semantic:e=>_({id:"stop",mode:"finite",output:{formats:["brief","json","jsonl","quiet"],scalar:t=>t.status},async run(){let t=await qs();return x({status:t.status==="stopped"?"stopped":t.status==="failed"?"failed":"unchanged",reason:t.status,scope:"machine",artifacts:"kept"},t.status==="failed"?{kind:"failed",error:{code:"E_SERVER_STOP_FAILED",message:t.error}}:{kind:"succeeded"})},present:Ws},e)};var Wt=require("node:child_process"),Bn=S(require("node:fs"),1);var pt=S(require("node:fs"),1),Gn=S(require("node:os"),1),ft=S(require("node:path"),1);function Vn(e,t){let r=e.split(".").map(Number),n=t.split(".").map(Number);for(let o=0;o<3;o++)if(r[o]!==n[o])return r[o]>n[o];return!1}var Wn=e=>ft.default.join(e.XDG_CACHE_HOME||ft.default.join(Gn.default.homedir(),".cache"),"ryugi","artifacts","latest.json");function qn(e,t,r){try{pt.default.mkdirSync(ft.default.dirname(e),{recursive:!0});let n=`${e}.${process.pid}`;pt.default.writeFileSync(n,JSON.stringify({version:t,checkedAt:r})),pt.default.renameSync(n,e)}catch{}}var H="ryugi-artifacts",mt=["npm","pnpm","yarn","bun"],Hs=[["npx",["/_npx/"]],["pnpm dlx",["/pnpm/dlx/","/.pnpm-store/dlx/"]],["bunx",["/bunx-","/.bun/install/cache/"]]],Bs=[["pnpm",["/pnpm/global/"]],["yarn",["/yarn/global/"]],["bun",["/.bun/install/global/"]],["npm",[`/lib/node_modules/${H}/`,`/npm/node_modules/${H}/`]]];function Ys(e,t){if(t.RYUGI_ARTIFACTS_COMMAND)return{kind:"launcher"};let r=e;try{r=Bn.default.realpathSync(e)}catch{}let n=r.replaceAll("\\","/").toLowerCase(),o=s=>s.some(i=>n.includes(i));for(let[s,i]of Hs)if(o(i))return{kind:"transient",runner:s};for(let[s,i]of Bs)if(o(i))return{kind:"global",pm:s};return n.includes("/node_modules/")?{kind:"unknown"}:{kind:"local"}}function Hn(e,t){let r=`${H}@${t}`;return{cmd:e,args:e==="npm"?["install","-g",r]:e==="yarn"?["global","add",r]:["add","-g",r]}}var he=({cmd:e,args:t})=>[e,...t].join(" ");async function Js(e){let t=e.endsWith("/")?e:`${e}/`;try{let r=await fetch(new URL(`${H}/latest`,t),{signal:AbortSignal.timeout(1e4)}),{version:n}=await r.json();if(r.ok&&typeof n=="string"&&/^\d+\.\d+\.\d+/.test(n))return n;throw new Error(`registry returned ${r.status}`)}catch(r){throw new w(`Could not get the latest ${H} version from ${t}: ${r.message}`)}}function Xs(e,t){return e.kind==="transient"?`You ran ${H} through ${e.runner}, which keeps no install to update. Run \`${e.runner} ${H}@latest\` to get ${t}.`:e.kind==="local"?"This is a local build from a Ryugi checkout. Update it with `git pull`, then `pnpm build` in artifacts/.":e.kind==="launcher"?`The Ryugi skill runs ${H} through its launcher, which moves to ${t} within a day of its release.`:null}var gt=class extends w{};async function zs(e,t={}){if(e.pm!==void 0&&!mt.includes(e.pm))throw new w(`--pm must be one of ${mt.join(", ")}`);let r=e.pm?{kind:"global",pm:e.pm}:Ys(e.file,e.env),n=await Js(e.registry);qn(Wn(e.env),n,Date.now());let o={type:"update-check",current:e.current,latest:n,install:r.kind};if(!Vn(n,e.current))return{...o,upToDate:!0,command:null};if(r.kind==="unknown"){let p=mt.map(d=>`  ${he(Hn(d,n))}`).join(`
 `);throw new gt(`Could not tell how ${H} was installed (${e.file}). Install ${n} with one of:
 ${p}
-or run \`${H} update --pm <${mt.join("|")}>\`.`)}if(r.kind!=="global")return{...o,upToDate:!1,command:null,message:Xs(r,n)};let s=Hn(r.pm,n);if(e.check)return{...o,upToDate:!1,command:he(s)};let i=process.platform==="win32";t.beforeInstall?.();let a=t.log?["inherit","pipe","pipe"]:["inherit",2,2],u=i?(0,Wt.spawnSync)(he(s),{stdio:[...a],env:e.env,shell:!0}):(0,Wt.spawnSync)(s.cmd,s.args,{stdio:[...a],env:e.env});if(u.stdout?.length&&t.log?.(u.stdout.toString()),u.stderr?.length&&t.log?.(u.stderr.toString()),u.error)throw new w(`Could not run ${he(s)}: ${u.error.message}`);if(u.status!==0)throw new w(`${he(s)} exited with ${u.status??u.signal}`);return{type:"updated",from:e.current,to:n,pm:r.pm,command:he(s)}}var Yn={name:"update",summary:"Install the newest ryugi-artifacts release with the package manager that installed this one",options:{check:{type:"boolean",help:"Compare versions only; do not install"},pm:{type:"string",value:"<npm|pnpm|yarn|bun>",help:"Use this package manager instead of detecting it"}},semantic:e=>_({id:"update",mode:"finite",output:{formats:["brief","json","jsonl"],fields:["current","latest","install","status","installed","message","command"]},async run(t,r){let n,o;try{o=await zs({current:"1.70.2",file:__filename,env:process.env,registry:process.env.npm_config_registry||"https://registry.npmjs.org/",check:!!e.values.check,pm:e.values.pm},{beforeInstall(){n=r.effects.begin("install",H)},log:r.diagnostic})}catch(i){throw i instanceof gt?new f({code:"E_INSTALL_UNKNOWN",message:i.message},"action_required"):i}o.type==="updated"&&n!==void 0&&r.effects.confirm(n,{from:o.from,to:o.to});let s=o.type==="updated"?{current:o.to,latest:o.to,install:"global",status:"updated",installed:!0,command:o.command}:{current:o.current,latest:o.latest,install:o.install,status:o.upToDate?"up_to_date":"available",installed:!1,command:o.command,...o.message?{message:o.message}:{}};return x(s,void 0,{effects:r.effects.snapshot()})},present:Ks},e)};function Ks({data:e}){return{heading:"Update",status:e.status,facts:[R("Current",A(e,"current"),!0),R("Latest",A(e,"latest")),R("Install",A(e,"install")),...e.message?[R("Advice",A(e,"message"))]:[]],sections:[]}}var qt=[Fn,Un,Hr,un,Kr,Vr,ln,sn,Zr,Yn];function Ht(e=process.stdout,t=process.stderr){let r=new WeakMap;for(let n of[e,t])n.on("error",o=>r.set(n,o));return{write(n,o){let s=n==="stdout"?e:t,i=r.get(s);return i?Promise.reject(i):new Promise((a,u)=>s.write(o,p=>p?u(p):a()))}}}function Bt(e){process.exitCode=e}var Xn=S(require("node:fs"),1);async function xe(e,t,r,n){return Ct({id:e,mode:"finite",output:{formats:[r.format]},run(){throw t},present(){return{heading:"Error",status:"failed",facts:[],sections:[]}}},void 0,{...r,fields:void 0,detail:!1},n)}function Jn(e,t){return{id:e,mode:"finite",output:{formats:["brief","json","jsonl"],fields:["text","version","capabilities","commands"]},run(){return x(t)},present({data:r}){return r.version?{heading:`ryugi-artifacts ${r.version}`,status:"",facts:[],sections:[]}:{heading:"Help",status:"",facts:[],sections:[{kind:"content",key:"text",text:r.text}]}}}}async function zn(e,t,r,n,o,s,i){let[a,...u]=e,p=t.find(d=>d.name===a);try{if(a==="--version"||a==="-v")return be(u,{},0),await _(Jn("version",{text:n,version:n,capabilities:["reviewBundlesV1"]}),void 0).run(o,s);if(a==="--help"||a==="-h"||p&&Zt(u)){p||be(u,{},0);let l=p?tr(p):rr(t,r);return await _(Jn("help",{text:l,commands:t.map(({name:m,summary:C})=>({name:m,summary:C}))}),void 0).run(o,s)}if(!p&&(!a||a.startsWith("-")||(()=>{try{return Xn.default.statSync(a).isDirectory()}catch{return!1}})())){let l=be(e,r,1);if(l.positionals.length&&l.values["project-dir"])throw new f({code:"E_ARGUMENT_INVALID",message:"Specify one project directory."});return l.projectDir=l.values["project-dir"]??l.positionals[0]??l.projectDir,l.values.foreground=!0,l.values.open=!l.values["no-open"],await lt(l,"browse").run(o,s,i)}if(!p)throw new f({code:a?.includes("/")?"E_PROJECT_NOT_FOUND":"E_UNKNOWN_COMMAND",message:a?`Unknown command: ${a}`:"Use start --foreground to browse with semantic output."});let d;try{d=be(u,p.options,p.positionals)}catch(l){throw new f({code:"E_ARGUMENT_INVALID",message:l.message})}return await p.semantic(d).run(o,s,i)}catch(d){return xe(p?.name??a??"browse",d,o,s)}}var Qs={"no-open":{type:"boolean",help:"Print the URL without opening a browser"}};async function Zs(e){let t=Object.assign({},te,...qt.map(a=>a.options)),r=Ht(),n;try{n=bt(e,t,Ir(e,t))}catch(a){return xe(e[0]??"browse",a,bt(e,t).options,r)}if(n.error)return xe(e[0]??"browse",n.error,n.options,r);let o=new AbortController,s=()=>o.abort("SIGINT"),i=()=>o.abort("SIGTERM");process.on("SIGINT",s),process.on("SIGTERM",i);try{return await zn(e,qt,Qs,"1.70.2",n.options,r,o.signal)}finally{process.removeListener("SIGINT",s),process.removeListener("SIGTERM",i)}}Zs(process.argv.slice(2)).then(Bt,e=>xe(process.argv[2]??"browse",e,{format:"brief"},Ht()).then(Bt));
+or run \`${H} update --pm <${mt.join("|")}>\`.`)}if(r.kind!=="global")return{...o,upToDate:!1,command:null,message:Xs(r,n)};let s=Hn(r.pm,n);if(e.check)return{...o,upToDate:!1,command:he(s)};let i=process.platform==="win32";t.beforeInstall?.();let a=t.log?["inherit","pipe","pipe"]:["inherit",2,2],u=i?(0,Wt.spawnSync)(he(s),{stdio:[...a],env:e.env,shell:!0}):(0,Wt.spawnSync)(s.cmd,s.args,{stdio:[...a],env:e.env});if(u.stdout?.length&&t.log?.(u.stdout.toString()),u.stderr?.length&&t.log?.(u.stderr.toString()),u.error)throw new w(`Could not run ${he(s)}: ${u.error.message}`);if(u.status!==0)throw new w(`${he(s)} exited with ${u.status??u.signal}`);return{type:"updated",from:e.current,to:n,pm:r.pm,command:he(s)}}var Yn={name:"update",summary:"Install the newest ryugi-artifacts release with the package manager that installed this one",options:{check:{type:"boolean",help:"Compare versions only; do not install"},pm:{type:"string",value:"<npm|pnpm|yarn|bun>",help:"Use this package manager instead of detecting it"}},semantic:e=>_({id:"update",mode:"finite",output:{formats:["brief","json","jsonl"],fields:["current","latest","install","status","installed","message","command"]},async run(t,r){let n,o;try{o=await zs({current:"1.71.0",file:__filename,env:process.env,registry:process.env.npm_config_registry||"https://registry.npmjs.org/",check:!!e.values.check,pm:e.values.pm},{beforeInstall(){n=r.effects.begin("install",H)},log:r.diagnostic})}catch(i){throw i instanceof gt?new f({code:"E_INSTALL_UNKNOWN",message:i.message},"action_required"):i}o.type==="updated"&&n!==void 0&&r.effects.confirm(n,{from:o.from,to:o.to});let s=o.type==="updated"?{current:o.to,latest:o.to,install:"global",status:"updated",installed:!0,command:o.command}:{current:o.current,latest:o.latest,install:o.install,status:o.upToDate?"up_to_date":"available",installed:!1,command:o.command,...o.message?{message:o.message}:{}};return x(s,void 0,{effects:r.effects.snapshot()})},present:Ks},e)};function Ks({data:e}){return{heading:"Update",status:e.status,facts:[R("Current",A(e,"current"),!0),R("Latest",A(e,"latest")),R("Install",A(e,"install")),...e.message?[R("Advice",A(e,"message"))]:[]],sections:[]}}var qt=[Fn,Un,Hr,un,Kr,Vr,ln,sn,Zr,Yn];function Ht(e=process.stdout,t=process.stderr){let r=new WeakMap;for(let n of[e,t])n.on("error",o=>r.set(n,o));return{write(n,o){let s=n==="stdout"?e:t,i=r.get(s);return i?Promise.reject(i):new Promise((a,u)=>s.write(o,p=>p?u(p):a()))}}}function Bt(e){process.exitCode=e}var Xn=S(require("node:fs"),1);async function xe(e,t,r,n){return Ct({id:e,mode:"finite",output:{formats:[r.format]},run(){throw t},present(){return{heading:"Error",status:"failed",facts:[],sections:[]}}},void 0,{...r,fields:void 0,detail:!1},n)}function Jn(e,t){return{id:e,mode:"finite",output:{formats:["brief","json","jsonl"],fields:["text","version","capabilities","commands"]},run(){return x(t)},present({data:r}){return r.version?{heading:`ryugi ${r.version}`,status:"",facts:[],sections:[]}:{heading:"Help",status:"",facts:[],sections:[{kind:"content",key:"text",text:r.text}]}}}}async function zn(e,t,r,n,o,s,i){let[a,...u]=e,p=t.find(d=>d.name===a);try{if(a==="--version"||a==="-v")return be(u,{},0),await _(Jn("version",{text:n,version:n,capabilities:["reviewBundlesV1"]}),void 0).run(o,s);if(a==="--help"||a==="-h"||p&&Zt(u)){p||be(u,{},0);let l=p?tr(p):rr(t,r);return await _(Jn("help",{text:l,commands:t.map(({name:m,summary:C})=>({name:m,summary:C}))}),void 0).run(o,s)}if(!p&&(!a||a.startsWith("-")||(()=>{try{return Xn.default.statSync(a).isDirectory()}catch{return!1}})())){let l=be(e,r,1);if(l.positionals.length&&l.values["project-dir"])throw new f({code:"E_ARGUMENT_INVALID",message:"Specify one project directory."});return l.projectDir=l.values["project-dir"]??l.positionals[0]??l.projectDir,l.values.foreground=!0,l.values.open=!l.values["no-open"],await lt(l,"browse").run(o,s,i)}if(!p)throw new f({code:a?.includes("/")?"E_PROJECT_NOT_FOUND":"E_UNKNOWN_COMMAND",message:a?`Unknown command: ${a}`:"Use start --foreground to browse with semantic output."});let d;try{d=be(u,p.options,p.positionals)}catch(l){throw new f({code:"E_ARGUMENT_INVALID",message:l.message})}return await p.semantic(d).run(o,s,i)}catch(d){return xe(p?.name??a??"browse",d,o,s)}}var Qs={"no-open":{type:"boolean",help:"Print the URL without opening a browser"}};async function Zs(e){let t=Object.assign({},te,...qt.map(a=>a.options)),r=Ht(),n;try{n=bt(e,t,Ir(e,t))}catch(a){return xe(e[0]??"browse",a,bt(e,t).options,r)}if(n.error)return xe(e[0]??"browse",n.error,n.options,r);let o=new AbortController,s=()=>o.abort("SIGINT"),i=()=>o.abort("SIGTERM");process.on("SIGINT",s),process.on("SIGTERM",i);try{return await zn(e,qt,Qs,"1.71.0",n.options,r,o.signal)}finally{process.removeListener("SIGINT",s),process.removeListener("SIGTERM",i)}}Zs(process.argv.slice(2)).then(Bt,e=>xe(process.argv[2]??"browse",e,{format:"brief"},Ht()).then(Bt));

package/dist/comment-threads.cjs

@@ -1,2 +1,53 @@
 // Generated from ryugi-cloud/packages/artifacts/src/shared/review-evidence.ts. Do not edit.
-"use strict";var u=Object.defineProperty;var c=Object.getOwnPropertyDescriptor;var h=Object.getOwnPropertyNames;var f=Object.prototype.hasOwnProperty;var k=(t,n)=>{for(var e in n)u(t,e,{get:n[e],enumerable:!0})},p=(t,n,e,s)=>{if(n&&typeof n=="object"||typeof n=="function")for(let o of h(n))!f.call(t,o)&&o!==e&&u(t,o,{get:()=>n[o],enumerable:!(s=c(n,o))||s.enumerable});return t};var l=t=>p(u({},"__esModule",{value:!0}),t);var x={};k(x,{humanTokens:()=>a,reviewStateKey:()=>m,unreadThreadCount:()=>w});module.exports=l(x);var i=require("node:crypto"),r=t=>(0,i.createHash)("sha256").update(JSON.stringify(t)).digest("hex"),m=(t,n)=>r([t,n]);function a(t){let n=t.messages.filter(e=>e.author==="human").map(e=>({token:r([t.id,"message",e.id,e.at,e.editedAt,e.deleted,e.text]),at:e.editedAt??e.at}));return t.statusBy==="human"&&n.push({token:r([t.id,"status",t.statusAt,t.status]),at:t.statusAt}),n}function w(t,n=[]){let e=new Set(n);return(t?.threads??[]).filter(s=>{let o=s.anchor;return o.ask===void 0&&o.choice===void 0&&o.submit===void 0&&a(s).some(d=>!e.has(d.token))}).length}0&&(module.exports={humanTokens,reviewStateKey,unreadThreadCount});
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/shared/review-evidence.ts
+var review_evidence_exports = {};
+__export(review_evidence_exports, {
+  humanTokens: () => humanTokens,
+  reviewStateKey: () => reviewStateKey,
+  unreadThreadCount: () => unreadThreadCount
+});
+module.exports = __toCommonJS(review_evidence_exports);
+var import_node_crypto = require("node:crypto");
+var hash = (value) => (0, import_node_crypto.createHash)("sha256").update(JSON.stringify(value)).digest("hex");
+var reviewStateKey = (artifact, agent) => hash([artifact, agent]);
+function humanTokens(thread) {
+  const values = thread.messages.filter((message) => message.author === "human").map((message) => ({
+    token: hash([thread.id, "message", message.id, message.at, message.editedAt, message.deleted, message.text]),
+    at: message.editedAt ?? message.at
+  }));
+  if (thread.statusBy === "human")
+    values.push({ token: hash([thread.id, "status", thread.statusAt, thread.status]), at: thread.statusAt });
+  return values;
+}
+function unreadThreadCount(file, consumed = []) {
+  const seen = new Set(consumed);
+  return (file?.threads ?? []).filter((thread) => {
+    const anchor = thread.anchor;
+    return anchor.ask === void 0 && anchor.choice === void 0 && anchor.submit === void 0 && humanTokens(thread).some((event) => !seen.has(event.token));
+  }).length;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  humanTokens,
+  reviewStateKey,
+  unreadThreadCount
+});