austere-axi 0.1.0 → 0.1.1

package/README.md

@@ -54,11 +54,42 @@ agent edits statements ◄── austere-axi poll plan.html ◄─┘  (long-pol
 
 ## Install
 
+Requires Node.js 20 or later.
+
+**Run it without installing** (what agents use):
+
+```sh
+npx -y austere-axi --help
+```
+
+`npx` downloads the package into npm's cache and runs it. `-y` skips the install prompt, so a non-interactive agent never stalls on it. Prefix every command below the same way: `npx -y austere-axi spec`, `npx -y austere-axi plan.html`, and so on.
+
+**Or install the command globally:**
+
+```sh
+npm install -g austere-axi
+austere-axi --help
+```
+
+A global install stays on the version you installed until `npm update -g austere-axi`. Mixing the two is fine: a newer CLI replaces an older background server automatically.
+
+**Agent skill (optional):**
+
 ```sh
 npx skills add MandalorianBatman/austere-axi --skill austere
 ```
 
-The skill is a stub that sends the agent to `npx -y austere-axi --help` and `spec`. The CLI is the source of truth, so an installed skill cannot go stale. No setup is needed: any agent can run `npx -y austere-axi` directly.
+The skill tells an agent when a page beats prose and adds an `/austere <request>` command. It is a stub that sends the agent to `npx -y austere-axi --help` and `spec`, so an installed copy cannot go stale. Agents that can run shell commands do not need it.
+
+## Quick start
+
+```sh
+npx -y austere-axi spec              # component reference for the agent (read once per session)
+npx -y austere-axi plan.html         # validate and open the page for review
+npx -y austere-axi poll plan.html    # wait for the reviewer to press Send
+```
+
+`--help` prints the file skeleton and the full review loop.
 
 ## CLI
 

package/dist/austere.js

@@ -1257,6 +1257,6 @@ ${n}`}})}}let r=e;return{type:r.type??Cl.ContinueConversation,params:{...r.param
 `;)r++;continue}let l=r,c=n,u=0,d=null,p=!1;for(;r<o;){let x=a[r];if(d){p?p=!1:x==="\\"?p=!0:x===d&&(d=null),x===`
 `&&n++,r++;continue}if(x==='"'||x==="'"){d=x,r++;continue}if(x==="#"||x==="/"&&a[r+1]==="/"){for(;r<o&&a[r]!==`
 `;)r++;continue}if(x==="("||x==="["||x==="{")u++;else if(x===")"||x==="]"||x==="}")u=Math.max(0,u-1);else if(x===`
-`){if(u===0&&!mza(a,r+1))break;n++}r++}let f=a.slice(l,r).replace(/\s+$/,""),m=/^\s*([A-Za-z_$][\w$]*)\s*=/.exec(f);m&&pza.test(m[1][0])&&t.push({id:m[1],text:f,line:c,endLine:n})}return t}function mza(e,t){let a=t;for(;a<e.length&&(e[a]===" "||e[a]==="	");)a++;return e[a]==="?"||e[a]===":"}function ix(e){let t=new Map;for(let a of fza(e))t.set(a.id,a);return t}function WTt(e,t){let a=ix(e),r=ix(t),n=[];for(let[o,i]of r){let l=a.get(o);(!l||GTt(l.text)!==GTt(i.text))&&n.push(o)}return n}function jG(e,t){let a=new RegExp(`(^|[^\\w$])${gza(t)}(?![\\w$])`),r=[];for(let[n,o]of e){if(n===t)continue;let i=o.text.slice(o.text.indexOf("=")+1);a.test(hza(i))&&r.push(n)}return r}function hza(e){return e.replace(/"(?:[^"\\]|\\.)*"|'(?:[^'\\]|\\.)*'/gs,'""')}function GTt(e){return e.replace(/\s+/g," ").trim()}function gza(e){return e.replace(/[$()*+.?[\\\]^{|}]/g,"\\$&")}var lx=te(kt(),1),UG="0.1.0",yza='script[type="text/openui"], script[type="text/openui-lang"]';function xza(){if(document.getElementById("austere-styles"))return;let e=document.createElement("style");if(e.id="austere-styles",e.textContent=[rne,ene,tne,ane].join(`
+`){if(u===0&&!mza(a,r+1))break;n++}r++}let f=a.slice(l,r).replace(/\s+$/,""),m=/^\s*([A-Za-z_$][\w$]*)\s*=/.exec(f);m&&pza.test(m[1][0])&&t.push({id:m[1],text:f,line:c,endLine:n})}return t}function mza(e,t){let a=t;for(;a<e.length&&(e[a]===" "||e[a]==="	");)a++;return e[a]==="?"||e[a]===":"}function ix(e){let t=new Map;for(let a of fza(e))t.set(a.id,a);return t}function WTt(e,t){let a=ix(e),r=ix(t),n=[];for(let[o,i]of r){let l=a.get(o);(!l||GTt(l.text)!==GTt(i.text))&&n.push(o)}return n}function jG(e,t){let a=new RegExp(`(^|[^\\w$])${gza(t)}(?![\\w$])`),r=[];for(let[n,o]of e){if(n===t)continue;let i=o.text.slice(o.text.indexOf("=")+1);a.test(hza(i))&&r.push(n)}return r}function hza(e){return e.replace(/"(?:[^"\\]|\\.)*"|'(?:[^'\\]|\\.)*'/gs,'""')}function GTt(e){return e.replace(/\s+/g," ").trim()}function gza(e){return e.replace(/[$()*+.?[\\\]^{|}]/g,"\\$&")}var lx=te(kt(),1),UG="0.1.1",yza='script[type="text/openui"], script[type="text/openui-lang"]';function xza(){if(document.getElementById("austere-styles"))return;let e=document.createElement("style");if(e.id="austere-styles",e.textContent=[rne,ene,tne,ane].join(`
 `),document.head.appendChild(e),!document.querySelector('meta[name="viewport"]')){let t=document.createElement("meta");t.name="viewport",t.content="width=device-width, initial-scale=1",document.head.appendChild(t)}document.documentElement.classList.add("austere"),document.documentElement.style.colorScheme="dark"}function KTt(e){if(!e||typeof e!="object")return;let t={};for(let[a,r]of Object.entries(e))if(!a.startsWith("$"))if(r&&typeof r=="object"&&!Array.isArray(r))if("value"in r&&Object.keys(r).length<=3)t[a]=r.value;else{let n=KTt(r);n&&Object.keys(n).length&&(t[a]=n)}else t[a]=r;return Object.keys(t).length?t:void 0}function vza(){let e=window.parent&&window.parent!==window,t=new Map,a=r=>{e&&window.parent.postMessage({austere:1,...r},"*")};return window.addEventListener("message",r=>{if(r.source!==window.parent)return;let n=r.data;!n||n.austere!==1||typeof n.type!="string"||t.get(n.type)?.forEach(o=>o(n))}),{framed:e,connected:!1,send:a,on(r,n){return t.has(r)||t.set(r,new Set),t.get(r).add(n),()=>t.get(r).delete(n)}}}function HG(e){let t=document.createElement("div");t.className="austere-toast",t.setAttribute("data-austere-ui",""),t.textContent=e,document.body.appendChild(t),setTimeout(()=>t.classList.add("out"),2600),setTimeout(()=>t.remove(),3100)}function bza(e){let t=[e.message];return e.form&&t.push(`form: ${JSON.stringify(e.form)}`),e.context!==void 0&&t.push(`context: ${JSON.stringify(e.context)}`),t.join(`
 `)}function kza({initialProgram:e,bridge:t,annotator:a,initialState:r}){let[n,o]=(0,Uo.useState)(e),i=(0,Uo.useRef)(e),l=(0,Uo.useRef)(null);(0,Uo.useEffect)(()=>t.on("source",({program:p})=>{if(typeof p!="string"||p===i.current)return;let f=WTt(i.current,p);i.current=p,l.current=f,o(p)}),[t]),(0,Uo.useEffect)(()=>t.on("reveal",({id:p})=>{a?.reveal(p,ix(i.current),jG)}),[t,a]),(0,Uo.useEffect)(()=>{let p=l.current;if(!p)return;l.current=null;let f=setTimeout(()=>{let m=ix(i.current),x=p.filter(b=>b!=="root");a?.flash(x,"changed",m,jG),t.send({type:"changes",ids:x})},120);return()=>clearTimeout(f)},[n,a,t]);let c=(0,Uo.useCallback)(p=>{if(p.type==="open_url"){let x=p.params?.url;typeof x=="string"&&/^(https?:|mailto:)/i.test(x)&&window.open(x,"_blank","noopener");return}if(p.type!=="continue_conversation")return;let f={kind:"action",message:p.humanFriendlyMessage||"(button)"},m=KTt(p.formState);if(m&&(f.form=m),p.params?.context!==void 0&&(f.context=p.params.context),t.connected)t.send({type:"action",item:f}),HG("Queued for the agent \u2014 press Send when ready");else{let x=bza(f);navigator.clipboard?.writeText(x).then(()=>HG("Copied \u2014 paste it to your agent"),()=>HG(x))}},[t]),u=(0,Uo.useCallback)(p=>{t.send({type:"errors",errors:(p||[]).map(f=>({source:f.source,code:f.code,statementId:f.statementId,message:f.message,hint:f.hint}))})},[t]),d=(0,Uo.useCallback)(p=>t.send({type:"state",state:p}),[t]);return(0,lx.jsx)(Qre,{mode:"dark",children:(0,lx.jsx)("main",{className:"austere-page",children:(0,lx.jsx)(L2,{response:n,library:BG,isStreaming:!1,onAction:c,onError:u,onStateUpdate:d,initialState:r})})})}function ZTt(){xza();let e=document.querySelector(yza),t=e?e.textContent:"",a=document.createElement("div");a.id="austere-root",document.body.appendChild(a);let r=vza(),n=null,o=!1,i=l=>{o||(o=!0,(0,XTt.createRoot)(a).render((0,lx.jsx)(kza,{initialProgram:t,bridge:r,annotator:n,initialState:l})))};if(!r.framed){i(void 0);return}n=VTt({post:l=>r.send(l)}),BTt(l=>r.send({type:"runtime-error",error:l})),r.on("init",l=>{if(r.connected=!0,n.setMode(l.mode),i(l.state||void 0),l.scrollY>0){let c=0,u=()=>{window.scrollTo(0,l.scrollY),Math.abs(window.scrollY-l.scrollY)>2&&++c<20&&setTimeout(u,50)};setTimeout(u,30)}r.send({type:"ready",title:document.title,version:UG})}),r.on("mode",l=>n.setMode(l.mode)),window.addEventListener("scroll",()=>r.send({type:"scroll",y:window.scrollY}),{passive:!0}),r.send({type:"hello",title:document.title,version:UG}),setTimeout(()=>i(void 0),600)}document.readyState==="loading"?document.addEventListener("DOMContentLoaded",ZTt,{once:!0}):ZTt();window.__austere={version:UG,library:BG};})();

package/dist/cli.mjs

@@ -605,7 +605,7 @@ var init_paths = __esm({
     HERE = path.dirname(fileURLToPath(import.meta.url));
     BUNDLED = true;
     ASSET_DIR = BUNDLED ? HERE : path.resolve(HERE, "../../dist");
-    VERSION = true ? "0.1.0" : JSON.parse(fs.readFileSync(path.resolve(HERE, "../../package.json"), "utf8")).version;
+    VERSION = true ? "0.1.1" : JSON.parse(fs.readFileSync(path.resolve(HERE, "../../package.json"), "utf8")).version;
     CLI_ENTRY = BUNDLED ? fileURLToPath(import.meta.url) : path.resolve(HERE, "main.js");
   }
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "austere-axi",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Agent-authored review artifacts in OpenUI Lang: a few hundred tokens instead of a whole HTML page, with statement-level annotations fed back to the agent.",
   "type": "module",
   "license": "MIT",