allyhub 0.7.1 → 0.8.0

package/dist/commands/scenery-text.js

@@ -1,5 +1,5 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{relative as S}from"node:path";import{CAMERA_DEFAULTS as F,SOLVE_DEFAULTS as b,fieldOfView as y,topObjects as w}from"@allyhub-next/scenery";import{ruleOf as j}from"@allyhub-next/scenery-host";export const plural=(e,t)=>`${String(e)} ${t}${e===1?"":"s"}`,shown=(e,t)=>{const s=S(e,t);return s===""||s.startsWith("..")?t:s};const c=e=>e.toFixed(2),l=e=>`(${c(e[0])}, ${c(e[1])}, ${c(e[2])})`,f=e=>e>=1e6?`${(e/1e6).toFixed(2)} M`:e>=1e4?`${(e/1e3).toFixed(1)} k`:String(e),k=e=>e>=1e9?`${(e/1e9).toFixed(2)} GB`:e>=1e6?`${(e/1e6).toFixed(1)} MB`:`${(e/1e3).toFixed(0)} kB`;export function facing(e){const[t,s,o]=e;if(Math.abs(s)>.99)return s>0?"faces up":"faces down";const n=Math.atan2(t,o)*180/Math.PI,i=[[0,"+Z"],[90,"+X"],[180,"−Z"],[-180,"−Z"],[-90,"−X"]].find(([r])=>Math.abs(n-Number(r))<.05);return i?`faces ${String(i[1])}`:`faces yaw ${n.toFixed(1)}°`}const x=200;export function objectLine(e){const t=[`${"  ".repeat(e.depth)}${e.path}`,e.type];return e.visible||t.push("hidden"),t.push(`at ${l(e.position)} m`,facing(e.front)),e.upright&&e.box?(t.push(`size ${c(e.upright.length)} × ${c(e.upright.width)} × ${c(e.upright.height)} m upright (along ${e.upright.angle.toFixed(1)}°)`,`box ${l(e.box.min)} to ${l(e.box.max)}`),e.own&&t.push(`own ${c(e.own.size[0])} × ${c(e.own.size[1])} × ${c(e.own.size[2])} m`)):t.push("draws nothing"),e.triangles>0&&t.push(`${f(e.triangles)} tris in ${String(e.meshes)} ${e.meshes===1?"mesh":"meshes"}`),e.materials.length>0&&t.push(e.materials.join(", ")),t.join(" | ")}export function cameraLine(e,t){const s=t.target===void 0?t.direction?`along ${l(t.direction)}`:`yaw ${String(t.yaw??0)}° pitch ${String(t.pitch??0)}°`:typeof t.target=="string"?`→ ${t.target}`:`→ ${l(t.target)}`,o=t.fov!==void 0?`fov ${String(t.fov)}°`:`${String(t.lens??F.lens)} mm`;return`  ${e}: at ${l(t.position)} ${s}, ${o}`}export function inventoryText(e,t,s){const o=t.totals,n=t.objects.filter($=>$.name!=="").length,i=[`${e} at ${t.t.toFixed(2)} s. Y up, metres; a camera looks down −Z, a glTF model faces +Z. Positions and sizes in world space.`,`Drawn by ${t.renderer.gl||"an unknown renderer"}, three.js r${t.renderer.three} (${t.renderer.kind}).`,`${plural(o.objects,"object")} (${String(n)} named, ${String(t.unnamed)} unnamed), ${String(o.meshes)} meshes, ${f(o.triangles)} triangles, ${plural(o.drawCalls,"draw call")}, ${plural(o.textures,"texture")} (${k(o.textureBytes)} with mipmaps); a ${String(o.frameSize[0])} × ${String(o.frameSize[1])} frame drew in ${o.frameMs.toFixed(0)} ms${o.transmission?`, ${o.transmission.withoutMs.toFixed(0)} ms without its ${plural(o.transmission.objects.length,"transmissive object")} (${o.transmission.objects.join(", ")}), for which three.js draws the scene once more`:""}.`],r=Object.entries(t.repeated);r.length>0&&i.push(`Names given to more than one object (a camera, move or measurement cannot use them): ${r.map(([$,u])=>`${$} (${String(u)})`).join(", ")}.`),i.push("","Objects:");const a=s?t.objects:w(t.objects);for(const $ of a.slice(0,x))i.push(objectLine($));a.length>x&&i.push(`… ${String(a.length-x)} more, in --json.`);const h=s?0:t.objects.length-w(t.objects).length;h>0&&i.push(`(${plural(h,"object")} inside models and groups not listed: --nested lists them.)`),i.push("",t.lights.length>0?"Lights:":"Lights: none.");for(const $ of t.lights){const u=$.type==="DirectionalLight"?"lx":$.type==="PointLight"||$.type==="SpotLight"?"cd":"";i.push(`  ${$.path} | ${$.type} | at ${l($.position)}${$.target?` → ${l($.target)}`:""} | ${$.color} ${String($.intensity)}${u?` ${u}`:""}${$.castShadow?` | shadows ${String($.shadowMap??"")}`:""}${$.angle!==void 0?` | cone ${String($.angle)}°`:""}${$.distance!==void 0?` | reach ${String($.distance)} m`:""}`)}const g=Object.entries(t.cameras);i.push("",g.length>0?"Cameras:":"Cameras: none named.");for(const[$,u]of g)i.push(cameraLine($,u));return i.push(t.moves.length>0?`Moves: ${t.moves.join(", ")}.`:"Moves: none named."),i.join(`
+import{relative as S}from"node:path";import{CAMERA_DEFAULTS as F,SOLVE_DEFAULTS as b,fieldOfView as y,topObjects as w}from"@allyhub/scenery";import{ruleOf as j}from"@allyhub/scenery-host";export const plural=(e,t)=>`${String(e)} ${t}${e===1?"":"s"}`,shown=(e,t)=>{const s=S(e,t);return s===""||s.startsWith("..")?t:s};const c=e=>e.toFixed(2),l=e=>`(${c(e[0])}, ${c(e[1])}, ${c(e[2])})`,f=e=>e>=1e6?`${(e/1e6).toFixed(2)} M`:e>=1e4?`${(e/1e3).toFixed(1)} k`:String(e),k=e=>e>=1e9?`${(e/1e9).toFixed(2)} GB`:e>=1e6?`${(e/1e6).toFixed(1)} MB`:`${(e/1e3).toFixed(0)} kB`;export function facing(e){const[t,s,o]=e;if(Math.abs(s)>.99)return s>0?"faces up":"faces down";const n=Math.atan2(t,o)*180/Math.PI,i=[[0,"+Z"],[90,"+X"],[180,"−Z"],[-180,"−Z"],[-90,"−X"]].find(([r])=>Math.abs(n-Number(r))<.05);return i?`faces ${String(i[1])}`:`faces yaw ${n.toFixed(1)}°`}const x=200;export function objectLine(e){const t=[`${"  ".repeat(e.depth)}${e.path}`,e.type];return e.visible||t.push("hidden"),t.push(`at ${l(e.position)} m`,facing(e.front)),e.upright&&e.box?(t.push(`size ${c(e.upright.length)} × ${c(e.upright.width)} × ${c(e.upright.height)} m upright (along ${e.upright.angle.toFixed(1)}°)`,`box ${l(e.box.min)} to ${l(e.box.max)}`),e.own&&t.push(`own ${c(e.own.size[0])} × ${c(e.own.size[1])} × ${c(e.own.size[2])} m`)):t.push("draws nothing"),e.triangles>0&&t.push(`${f(e.triangles)} tris in ${String(e.meshes)} ${e.meshes===1?"mesh":"meshes"}`),e.materials.length>0&&t.push(e.materials.join(", ")),t.join(" | ")}export function cameraLine(e,t){const s=t.target===void 0?t.direction?`along ${l(t.direction)}`:`yaw ${String(t.yaw??0)}° pitch ${String(t.pitch??0)}°`:typeof t.target=="string"?`→ ${t.target}`:`→ ${l(t.target)}`,o=t.fov!==void 0?`fov ${String(t.fov)}°`:`${String(t.lens??F.lens)} mm`;return`  ${e}: at ${l(t.position)} ${s}, ${o}`}export function inventoryText(e,t,s){const o=t.totals,n=t.objects.filter($=>$.name!=="").length,i=[`${e} at ${t.t.toFixed(2)} s. Y up, metres; a camera looks down −Z, a glTF model faces +Z. Positions and sizes in world space.`,`Drawn by ${t.renderer.gl||"an unknown renderer"}, three.js r${t.renderer.three} (${t.renderer.kind}).`,`${plural(o.objects,"object")} (${String(n)} named, ${String(t.unnamed)} unnamed), ${String(o.meshes)} meshes, ${f(o.triangles)} triangles, ${plural(o.drawCalls,"draw call")}, ${plural(o.textures,"texture")} (${k(o.textureBytes)} with mipmaps); a ${String(o.frameSize[0])} × ${String(o.frameSize[1])} frame drew in ${o.frameMs.toFixed(0)} ms${o.transmission?`, ${o.transmission.withoutMs.toFixed(0)} ms without its ${plural(o.transmission.objects.length,"transmissive object")} (${o.transmission.objects.join(", ")}), for which three.js draws the scene once more`:""}.`],r=Object.entries(t.repeated);r.length>0&&i.push(`Names given to more than one object (a camera, move or measurement cannot use them): ${r.map(([$,u])=>`${$} (${String(u)})`).join(", ")}.`),i.push("","Objects:");const a=s?t.objects:w(t.objects);for(const $ of a.slice(0,x))i.push(objectLine($));a.length>x&&i.push(`… ${String(a.length-x)} more, in --json.`);const h=s?0:t.objects.length-w(t.objects).length;h>0&&i.push(`(${plural(h,"object")} inside models and groups not listed: --nested lists them.)`),i.push("",t.lights.length>0?"Lights:":"Lights: none.");for(const $ of t.lights){const u=$.type==="DirectionalLight"?"lx":$.type==="PointLight"||$.type==="SpotLight"?"cd":"";i.push(`  ${$.path} | ${$.type} | at ${l($.position)}${$.target?` → ${l($.target)}`:""} | ${$.color} ${String($.intensity)}${u?` ${u}`:""}${$.castShadow?` | shadows ${String($.shadowMap??"")}`:""}${$.angle!==void 0?` | cone ${String($.angle)}°`:""}${$.distance!==void 0?` | reach ${String($.distance)} m`:""}`)}const g=Object.entries(t.cameras);i.push("",g.length>0?"Cameras:":"Cameras: none named.");for(const[$,u]of g)i.push(cameraLine($,u));return i.push(t.moves.length>0?`Moves: ${t.moves.join(", ")}.`:"Moves: none named."),i.join(`
 `)}export function cameraText(e){const t=e.target?`→ ${e.targetName!==void 0?`${e.targetName} `:""}${l(e.target)}`:`along ${l(e.forward)}`;return`at ${l(e.position)} ${t}, yaw ${e.yaw.toFixed(1)}° pitch ${e.pitch.toFixed(1)}° roll ${e.roll.toFixed(1)}°, ${e.lens.toFixed(1)} mm (${e.fov.horizontal.toFixed(1)}° × ${e.fov.vertical.toFixed(1)}°, ${e.fov.diagonal.toFixed(1)}° diagonal), near ${String(e.near)} m`}export function viewText(e,t,s){const o=[`${e}: ${String(t.width)} × ${String(t.height)} px, ${plural(t.tiles.length,"picture")} in ${plural(t.columns,"column")}.`];return t.tiles.forEach((n,i)=>{if(o.push(`${String(i+1)}. ${n.label} at ${n.t.toFixed(2)} s: ${cameraText(n.camera)}.`),s){const r=(n.seen??[]).filter(h=>h.pixels>0);r.length===0&&o.push("   No named object in view.");for(const h of r)o.push(`   ${h.path}: ${(h.share*100).toFixed(1)}% of the frame, ${(h.hidden*100).toFixed(1)}% of it hidden, its pixels centred at (${h.centroid?`${h.centroid[0].toFixed(0)}, ${h.centroid[1].toFixed(0)}`:"-"}) px`);const a=(n.seen??[]).filter(h=>h.pixels===0).map(h=>h.name);a.length>0&&o.push(`   Not in view: ${a.join(", ")}.`)}}),o.join(`
 `)}const p=e=>`${(e*100).toFixed(1)}%`,d=e=>Math.abs(e)<.1?`${(e*1e3).toFixed(1)} mm`:`${e.toFixed(3)} m`;export function contactText(e){const t=`${e.a} and ${e.b}`;if(e.missing!==void 0)return`${t}: not measured: ${e.missing}`;if(!e.crossing&&!e.within)return e.area!==void 0?`${t}: touching, faces in one plane sharing ${e.area.toFixed(4)} m²`:e.gap!==void 0?`${t}: ${d(e.gap)} apart${e.touching?" (touching, within the tolerance)":""}`:`${t}: touching`;const s=[e.crossing&&e.curve?`crossing along ${d(e.curve.length)} (${String(e.curve.segments)} segments) between ${l(e.curve.min)} and ${l(e.curve.max)}`:`${e.within==="a in b"?e.a:e.b} is inside ${e.within==="a in b"?e.b:e.a}, their surfaces not crossing`],o=(n,i)=>n===void 0||n.includes("not a closed solid")?`${i} has no inside`:n;if(e.depth){const n=e.depth.aInB!==void 0?`${d(e.depth.aInB)} of ${e.a} is in ${e.b}`:void 0,i=e.depth.bInA!==void 0?`${d(e.depth.bInA)} of ${e.b} in ${e.a}`:void 0;(n||i)&&s.push(`at least ${[n,i].filter(Boolean).join(", ")} (the deepest of ${String(e.depth.samples)} surface samples and every vertex: a lower bound)`);const r=[n?"":o(e.depth.aInBMissing,e.b),i?"":o(e.depth.bInAMissing,e.a)].filter(Boolean);r.length>0&&s.push(`depth not measured: ${[...new Set(r)].join(", ")}`)}if(e.lift){const[n,i]=e.lift.b<e.lift.a?[[e.b,e.lift.b],[e.a,e.lift.a]]:[[e.a,e.lift.a],[e.b,e.lift.b]];s.push(`moving ${n[0]} ${d(n[1])} along ${l(e.lift.direction)} (or ${i[0]} ${d(i[1])}) clears them`)}return e.volume!==void 0?s.push(`they share ${e.volume.toExponential(3)} m³`):e.volumeMissing&&!e.volumeMissing.includes("not a closed solid")&&s.push(`shared volume not measured: ${e.volumeMissing}`),`${t}: ${s.join("; ")}`}export function supportText(e){if(e.columns===0)return`${e.path}: no column met its surface from above`;const t=e.columns+(e.feet??0),s=`${plural(t,"column")}: ${String(e.columns)} across its footprint, ${String(e.feet??0)} at its lowest points`;if(e.gap===null)return`${e.path}: nothing below it in ${s} (its lowest point y ${c(e.bottom)})`;const n=[`on ${e.on.map(i=>`${i.path} (${p(i.share)} of the columns, least gap ${d(i.gap)})`).join(", ")} (${s})`,e.gap<0?`sunk ${d(-e.gap)}`:`gap ${d(e.gap)}`,`${p(e.footprintShare)} of its footprint within the tolerance`];return e.angle!==void 0&&n.push(`its faces at up to ${e.angle.toFixed(2)}° to those below where they touch`),e.contactArea!==void 0&&n.push(`about ${e.contactArea.toFixed(3)} m² in contact`),e.margin!==void 0&&n.push(e.margin>=0?`its centre of mass ${d(e.margin)} inside the contact's hull`:`its centre of mass ${d(-e.margin)} outside the contact's hull`),e.nothingBelow>0&&n.push(`nothing below in ${plural(e.nothingBelow,"column")}`),`${e.path}: ${n.join("; ")}`}export function measureText(e,t,s){const o=[`${e} at ${t.t.toFixed(2)} s: ${plural(t.objects.length,"named object")} measured; touching within ${d(s.tolerance)}, pairs closer than ${d(s.near)}${s.all?" (every pair: --all)":""}.`,"","Surfaces (closed: no open or non-manifold edges; only a closed surface whose faces turn out has an inside):"];for(const n of t.health){const i=[n.openEdges?`${String(n.openEdges)} open edges`:"",n.nonManifoldEdges?`${String(n.nonManifoldEdges)} non-manifold edges`:"",n.degenerate?`${String(n.degenerate)} triangles without area`:"",n.selfIntersections===null?"self-intersections not counted (too many triangles)":n.selfIntersections>0?`${n.selfIntersectionsAtLeast?"at least ":""}${String(n.selfIntersections)} self-intersecting triangle pairs`:""].filter(Boolean);o.push(`  ${n.path}: ${n.closed?(n.volume??0)<0?"closed, its faces turned in (it encloses space: not a solid)":"closed":"open"}, ${f(n.triangles)} triangles${i.length?`; ${i.join(", ")}`:""}`)}o.push("",t.contacts.length>0?"Pairs:":"Pairs: none touching, crossing or closer than the distance asked.");for(const n of t.contacts)o.push(`  ${contactText(n)}`);o.push("","Support (columns down through each object's footprint):");for(const n of t.support)o.push(`  ${supportText(n)}`);if(t.sight){const n=t.sight.blockedBy.map(i=>`${i.path} ${p(i.share)}`).join(", ");o.push("",`Line of sight ${t.sight.a} to ${t.sight.b}: ${p(t.sight.clear)} of ${String(t.sight.rays)} rays clear${n?`; stopped by ${n}`:""}.`)}if(t.clear){const n=t.clear;o.push("",n.least===void 0?`Ahead of ${n.path} (its +Z ${l(n.front)}): nothing within ${String(n.far)} m on any of ${String(n.rays)} rays.`:`Ahead of ${n.path} (its +Z ${l(n.front)}): clear for ${d(n.least)} at least, ${d(n.median??0)} on the median ray, ${d(n.most??0)} at most; ${String(n.open)} of ${String(n.rays)} rays meet nothing within ${String(n.far)} m.`)}if(t.floor){const n=t.floor,i=n.reach.map(r=>`${r.path} ${r.reached?"reached":"not reached"}`).join(", ");o.push("",`Floor ${n.floor} (cells of ${String(n.cell)} m; free a radius ${String(n.radius)} m from anything standing below ${String(n.height)} m): ${n.floorArea.toFixed(2)} m² of floor, ${n.freeArea.toFixed(2)} m² free, ${n.connected.toFixed(2)} m² connected${n.from?` to ${n.from}`:" (the largest free area)"}.${i?` ${i}.`:""}`)}return o.join(`
 `)}const m=(e,t)=>`${e.peak.toFixed(3)} ${t} at ${e.at.toFixed(2)} s (mean ${e.mean.toFixed(3)})`;export function motionText(e,t){const s=[`Motion of ${e} from ${t.from.toFixed(2)} to ${t.to.toFixed(2)} s, ${String(t.samples)} samples at ${String(t.fps)} a second, ${t.length.toFixed(3)} m travelled. Peaks in the camera's own frame:`,`  truck ${m(t.truck,"m/s")}; pedestal ${m(t.pedestal,"m/s")}; dolly ${m(t.dolly,"m/s")}`,`  pan ${m(t.pan,"°/s")}; tilt ${m(t.tilt,"°/s")}; roll ${m(t.roll,"°/s")}`,`  zoom ${m(t.zoom,"stops/s")}${t.arc?`; arc about its target ${m(t.arc,"°/s")}`:""}`,`  speed ${m(t.speed,"m/s")}; view turning ${m(t.turn,"°/s")}`,`  acceleration ${m(t.acceleration,"m/s²")}; jerk ${m(t.jerk,"m/s³")}; smoothness (log dimensionless jerk) ${t.smoothness===null?"not measured: it does not move":t.smoothness.toFixed(3)}`,`  largest step between samples ${d(t.step.distance)} and ${t.step.angle.toFixed(3)}° at ${t.step.at.toFixed(2)} s`];t.clearance&&s.push(`  nearest surface over the move: ${t.clearance.path} ${d(t.clearance.distance)} at ${t.clearance.at.toFixed(2)} s (ten checks a second)`);for(const o of t.objects)s.push(`  ${o.path} on the frame: up to ${o.screen.peak.toFixed(1)} px a sample at ${o.screen.at.toFixed(2)} s (mean ${o.screen.mean.toFixed(1)}); its size changing up to ${p(o.growth.peak)} a second; in view in ${p(o.inView)} of the samples`);return s.join(`

package/dist/commands/scenery.js

@@ -1,5 +1,5 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{mkdir as R,readFile as K,writeFile as M}from"node:fs/promises";import{dirname as U,join as S,resolve as A}from"node:path";import{z as t}from"zod";import{startBrowser as X}from"@allyhub-next/browser";import{WORK_DIR as Q}from"@allyhub-next/formats";import{EXIT as y}from"@allyhub-next/protocol";import{FLOOR_DEFAULTS as C,INVENTORY_FRAME as ee,MAP_DEFAULTS as te,MAP_VIEWS as B,MEASURE_DEFAULTS as re,MOTION_DEFAULTS as se,SIDES as ae,SOLVE_DEFAULTS as N,SOLVE_PARAMS as oe}from"@allyhub-next/scenery";import{SceneryCallError as V,SceneryStage as ne,bakeStatus as ie,keepBake as ce,readBakeIndex as me,solveSceneryCamera as le,solvedPicture as de}from"@allyhub-next/stage";import{ProjectError as fe,findScenery as he,sceneryTimesFromVideo as ue}from"@allyhub-next/project";import{commandError as be}from"../version.js";import{CommandError as p,defineCommand as j}from"../command.js";import{projectRoot as we}from"../project.js";import{parameters as ye}from"../parameters.js";import{LENS_FRAME as pe,NAMED_FIELDS as I,ONE_CAMERA_FIELDS as ve,SCENERY_FIELDS as v,cameraOf as ge,momentsOf as xe,pairOf as Y,sizeOf as D,sourcesOf as P,timesOf as je}from"./scenery-input.js";import{bakeLine as ke,bakeText as Te,inventoryText as Oe,mapText as Ee,measureText as Se,motionText as $e,problemLines as De,seeText as Fe,shown as F,solveText as ze,viewText as Ae}from"./scenery-text.js";const W=`${Q}/scenery`,H="540x960",T=e=>e===void 0?{}:{times:e};async function k(e,r,m,d={}){const n=await we(r.cwd,e.dir),s=await he(n,r.cwd,e.item),i=je(e.times).times,a=await X({signal:r.signal}),c=async f=>{r.progress(`Reading the scenery times of ${f??"the video that draws it"}…`);const h=await ue({root:n,file:s.entry,browser:a,...f===void 0?{}:{piece:f}}),o=Object.entries(h.times).map(([l,b])=>`${l} ${b.toFixed(3)}`).join(", ");return r.progress(`Scenery times from ${h.piece}: ${o||"no anchors"}`),{...h.times,...i}};let u;try{const f=e.piece===void 0?i:await c(e.piece);r.progress(`Building ${s.entry}…`),u=await ne.ofProject({browser:a,root:n,file:s.entry,...d.unbaked?{unbaked:!0}:{}});const h={root:n,item:s.place,file:s.entry,stage:u,browser:a,stem:s.place.replaceAll("/","-")};try{return await m({...h,times:f})}catch(o){if(!(o instanceof V)||o.needsTime===void 0||e.times!==void 0||e.piece!==void 0)throw o;let l;try{l=await c(void 0)}catch(b){throw b instanceof fe?new p("needs-time",`${o.rule}: ${o.message} ${b.message}`,{exit:y.usage,hint:b.code==="several-videos"?`Name the one whose times to take with --piece, or give it: --times ${o.needsTime}=<seconds>.`:`Give the scenery time it is at: --times ${o.needsTime}=<seconds>.`}):b}return await m({...h,times:l})}}catch(f){throw Ie(f)}finally{await u?.close(),await a.close()}}function Ie(e){return e instanceof V?e.needsTime!==void 0?new p("needs-time",`${e.rule}: ${e.message}`,{exit:y.usage,hint:`Give the scenery time it is at: --times ${e.needsTime}=<seconds>.`}):new p(`scenery-${e.kind}`,`${e.rule}: ${e.message}`):be(e)}async function O(e){const r=await e.call("problems");return{problems:r,exit:r.some(m=>m.level==="error")?y.failed:y.ok}}const E=(e,r)=>r.length>0?`${e}
+import{mkdir as R,readFile as K,writeFile as M}from"node:fs/promises";import{dirname as U,join as S,resolve as A}from"node:path";import{z as t}from"zod";import{startBrowser as X}from"@allyhub/browser";import{WORK_DIR as Q}from"@allyhub/formats";import{EXIT as y}from"@allyhub/protocol";import{FLOOR_DEFAULTS as C,INVENTORY_FRAME as ee,MAP_DEFAULTS as te,MAP_VIEWS as B,MEASURE_DEFAULTS as re,MOTION_DEFAULTS as se,SIDES as ae,SOLVE_DEFAULTS as N,SOLVE_PARAMS as oe}from"@allyhub/scenery";import{SceneryCallError as V,SceneryStage as ne,bakeStatus as ie,keepBake as ce,readBakeIndex as me,solveSceneryCamera as le,solvedPicture as de}from"@allyhub/stage";import{ProjectError as fe,findScenery as he,sceneryTimesFromVideo as ue}from"@allyhub/project";import{commandError as be}from"../version.js";import{CommandError as p,defineCommand as j}from"../command.js";import{projectRoot as we}from"../project.js";import{parameters as ye}from"../parameters.js";import{LENS_FRAME as pe,NAMED_FIELDS as I,ONE_CAMERA_FIELDS as ve,SCENERY_FIELDS as v,cameraOf as ge,momentsOf as xe,pairOf as Y,sizeOf as D,sourcesOf as P,timesOf as je}from"./scenery-input.js";import{bakeLine as ke,bakeText as Te,inventoryText as Oe,mapText as Ee,measureText as Se,motionText as $e,problemLines as De,seeText as Fe,shown as F,solveText as ze,viewText as Ae}from"./scenery-text.js";const W=`${Q}/scenery`,H="540x960",T=e=>e===void 0?{}:{times:e};async function k(e,r,m,d={}){const n=await we(r.cwd,e.dir),s=await he(n,r.cwd,e.item),i=je(e.times).times,a=await X({signal:r.signal}),c=async f=>{r.progress(`Reading the scenery times of ${f??"the video that draws it"}…`);const h=await ue({root:n,file:s.entry,browser:a,...f===void 0?{}:{piece:f}}),o=Object.entries(h.times).map(([l,b])=>`${l} ${b.toFixed(3)}`).join(", ");return r.progress(`Scenery times from ${h.piece}: ${o||"no anchors"}`),{...h.times,...i}};let u;try{const f=e.piece===void 0?i:await c(e.piece);r.progress(`Building ${s.entry}…`),u=await ne.ofProject({browser:a,root:n,file:s.entry,...d.unbaked?{unbaked:!0}:{}});const h={root:n,item:s.place,file:s.entry,stage:u,browser:a,stem:s.place.replaceAll("/","-")};try{return await m({...h,times:f})}catch(o){if(!(o instanceof V)||o.needsTime===void 0||e.times!==void 0||e.piece!==void 0)throw o;let l;try{l=await c(void 0)}catch(b){throw b instanceof fe?new p("needs-time",`${o.rule}: ${o.message} ${b.message}`,{exit:y.usage,hint:b.code==="several-videos"?`Name the one whose times to take with --piece, or give it: --times ${o.needsTime}=<seconds>.`:`Give the scenery time it is at: --times ${o.needsTime}=<seconds>.`}):b}return await m({...h,times:l})}}catch(f){throw Ie(f)}finally{await u?.close(),await a.close()}}function Ie(e){return e instanceof V?e.needsTime!==void 0?new p("needs-time",`${e.rule}: ${e.message}`,{exit:y.usage,hint:`Give the scenery time it is at: --times ${e.needsTime}=<seconds>.`}):new p(`scenery-${e.kind}`,`${e.rule}: ${e.message}`):be(e)}async function O(e){const r=await e.call("problems");return{problems:r,exit:r.some(m=>m.level==="error")?y.failed:y.ok}}const E=(e,r)=>r.length>0?`${e}
 ${De(r).join(`
 `)}`:e;async function J(e,r){return await R(U(e),{recursive:!0}),await M(e,Buffer.from(r.replace(/^data:image\/[a-z]+;base64,/u,""),"base64")),e}async function q(e,r){const m=await e.value(e.call("info")),d=Object.keys(m.cameras)[0];if(d===void 0)throw new p("no-camera",`${r} names no camera, and none was given.`,{exit:y.usage,hint:`Give one: --camera '{"position":[x,y,z],"target":"<object>"}', --move, or --around <object> (scenery view); or name cameras in defineScenery({ cameras }).`});return d}const _=t.array(t.string()).optional().describe("The only objects drawn, by name (with what is under them)"),L=t.boolean().default(!1).describe("Also each named object inside a model or group (default: only those with no named object above them, each with all it holds)");export const scenery=j({name:"scenery",summary:"A 3D scenery's objects with their places, sizes and costs, its lights, cameras, moves and bake",input:t.strictObject({...v,at:t.number().default(0).describe("Scenery time to pose it at, s"),nested:L}),positional:["item"],output:t.looseObject({file:t.string(),objects:t.array(t.unknown()),cameras:t.record(t.string(),t.unknown()),moves:t.array(t.string()),bake:t.unknown(),problems:t.array(t.unknown())}),examples:["allyhub scenery room","allyhub scenery room --nested --json"]},async(e,r)=>k(e,r,async({root:m,item:d,file:n,stage:s,times:i})=>{const a=await s.value(s.call("inventory",e.at,ee,i)),c=await s.value(s.call("info")),u=ie(c.bake,await me(m),n),f=Oe(n,a,e.nested).split(`
 `);f.splice(2,0,ke(d,u,c.renderer.gl,c.bake.laid??void 0));const{problems:h,exit:o}=await O(s);return{value:{file:n,...a,bake:u,problems:h},text:E(f.join(`

package/dist/commands/sheet.js

@@ -1,8 +1,8 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{mkdir as ie,readFile as H,stat as X,writeFile as ce}from"node:fs/promises";import{basename as k,dirname as N,extname as A,join as S,relative as B,resolve as D}from"node:path";import{z as d}from"zod";import{readSheetSource as he,sheetRoot as de,workbookFiles as fe}from"@allyhub-next/build";import{ITEM_KINDS as me,ZIP_LIMITS as ue}from"@allyhub-next/formats";import{EXIT as $}from"@allyhub-next/protocol";import{CellError as we,DIFF_DEFAULTS as pe,FormulaCell as O,Matrix as be,PROFILE_TOP as $e,SharedFormula as ge,cellName as M,checkWorkbook as q,dataValue as _,diffWorkbooks as ye,importRows as xe,profileTable as ve,rangeName as G,readAddress as ke,readArea as Se,scenarioNames as K,shownValue as j}from"@allyhub-next/sheet";import{CAPABILITIES as Y}from"@allyhub-next/sheet/api";import{COMPARE_TOLERANCE as je,importXlsx as Z}from"@allyhub-next/sheet/xlsx";import{CommandError as g,defineCommand as E}from"../command.js";import{projectRoot as T}from"../project.js";import{dir as C}from"../fields.js";const x=me.sheet.entries[0];export const CALC_ROWS=50,TRACE_CELLS=50;export async function findSheet(e,o,s){const t=D(o,s);for(const n of[k(t)===x?t:S(t,x),S(e,s,x),S(e,"content",s,x)])if((await X(n).catch(()=>{}))?.isFile())return n}export const sheetFolderName=(e,o)=>B(e,N(o)).replace(/^content\//u,"");export async function sheetAt(e,o,s){const t=await findSheet(e,o,s);if(t!==void 0)return t;throw new g("not-found",`There is no sheet ${s}.`,{exit:$.notFound,hint:"Name it by its folder (research/leads, a folder under content/ with or without content/) or its sheet.yaml."})}export async function sourceOfSheet(e,o){const s=de(e,N(o)),t=await he(s.root,s.dir);return{...s,source:t,files:fe(s.root,t)}}export async function openSheet(e,o,s,t){const n=await sheetAt(e,o,s),{source:a,files:r}=await sourceOfSheet(e,n),{workbook:c,calc:i,problems:l}=q(r,{scenario:t});if(!c||!i)throw new g("bad-file",`${B(e,n)} cannot be read: ${l.map(m=>`${m.line===void 0?"":`line ${String(m.line)}: `}${m.message}`).join("; ")}`,{exit:$.usage,hint:"allyhub check lists what is wrong."});return{file:B(e,n),workbook:c,calc:i,problems:l.length+a.problems.length}}function Ee(e,o){const s=K(e);if(!s.includes(o))throw new g("not-found",`There is no scenario ${o}.`,{exit:$.notFound,hint:s.length>0?`It has ${s.join(", ")}.`:"sheet.yaml's scenarios holds none."})}const u=e=>e.toLocaleString("en-US"),I=e=>e.toLocaleString("en-US",{maximumFractionDigits:4}),P=e=>e>0?["",`The workbook has ${String(e)} problem${e===1?"":"s"}: allyhub check lists them.`]:[];function Oe(e,o){const s=[`${u(e.empty)} empty`,`${u(e.distinct)} distinct`];e.errors>0&&s.push(`${u(e.errors)} errors`),e.min!==void 0&&e.max!==void 0&&s.push(`${I(e.min)} to ${I(e.max)}`),e.sum!==void 0&&s.push(`sum ${I(e.sum)}`),e.mean!==void 0&&s.push(`mean ${I(e.mean)}`),e.shortest!==void 0&&e.longest!==void 0&&s.push(`${String(e.shortest)} to ${String(e.longest)} characters`);const t=[`${e.name.padEnd(o)}  ${s.join(", ")}`];return e.formula!==void 0&&t.push(`${"".padEnd(o)}  ${e.formula}`),e.top.some(n=>n.count>1)&&t.push(`${"".padEnd(o)}  most: ${e.top.map(n=>`${JSON.stringify(n.value.length>40?`${n.value.slice(0,39)}…`:n.value)} ${u(n.count)}`).join(", ")}`),t}export const sheet=E({name:"sheet",summary:"Each table of a sheet measured: its columns' counts, empty, distinct, ranges and frequent values",input:d.strictObject({sheet:d.string().describe("The sheet, by its folder or its sheet.yaml"),dir:C}),positional:["sheet"],output:d.looseObject({}),examples:["allyhub sheet research/leads"]},async(e,o)=>{const s=await T(o.cwd,e.dir),{file:t,workbook:n,calc:a,problems:r}=await openSheet(s,o.cwd,e.sheet),c=n.tables.map(l=>({name:l.name,rows:l.rows,columns:ve(a,l)})),i=c.flatMap(l=>{const m=Math.min(24,Math.max(4,...l.columns.map(w=>w.name.length)));return["",`${l.name}: ${u(l.rows)} rows, ${String(l.columns.length)} columns; each column's ${String($e)} most frequent values`,...l.columns.flatMap(w=>Oe(w,m))]});return{value:{file:t,tables:c,problems:r},text:[`${t}: ${String(n.sheets.length)} sheet${n.sheets.length===1?"":"s"}, ${String(c.length)} table${c.length===1?"":"s"}`,...i,...P(r)].join(`
-`)}});const Q=e=>{const o=e.sheets[0];if(!o)throw new g("bad-file","The workbook has no sheets.",{exit:$.usage});return o};function ee(e,o){const s=o.lastIndexOf("!");if(s<0)return{sheet:Q(e),address:o};const t=o.slice(0,s).replace(/^'|'$/gu,"").replaceAll("''","'"),n=e.sheet(t);if(!n)throw new g("not-found",`There is no sheet ${t}.`,{exit:$.notFound,hint:`It has ${e.sheets.map(a=>a.name).join(", ")}.`});return{sheet:n,address:o.slice(s+1)}}function R(e,o,s,t){const n=[];for(let a=o.top;a<=o.bottom;a++){const r=[];for(let c=o.left;c<=o.right;c++){const i=t.value(e,a,c),l=e.lookAt(a,c).format,m=e.at(a,c);r.push({address:M({row:a,col:c}),value:_(i,l),shown:j(i,l),...m instanceof O?{formula:m.text}:{}})}n.push(r)}return{sheet:e.name,what:s,area:G(o),rows:n}}function Te(e,o,s){const t=a=>({address:"",value:_(a,void 0),shown:j(a)});if(!(s instanceof be))return{sheet:e.name,what:o,rows:[[t(s)]]};const n=[];for(let a=0;a<s.rows;a++){const r=[];for(let c=0;c<s.cols;c++)r.push(t(s.at(a,c)));n.push(r)}return{sheet:e.name,what:o,rows:n}}function te(e,o){const{wb:s}=e;if(o===void 0)return s.sheets.flatMap(l=>{const m=l.used;return m?[R(l,m,l.name,e)]:[]});const t=s.table(o);if(t)return[R(t.sheet,t.area,o,e)];const n=s.name(o);if(n){const l=new ge(n.formula?.text??`=${o}`,0,0,{file:""}),m=Q(s);return[Te(m,o,e.evaluate(l,m))]}const a=s.sheet(o);if(a){const l=a.used;return[l?R(a,l,o,e):{sheet:a.name,what:o,rows:[]}]}const{sheet:r,address:c}=ee(s,o),i=Se(c);if(!i)throw new g("not-found",`${o} is not a sheet, a table, a name or a range of this workbook.`,{exit:$.notFound,hint:[`Sheets: ${s.sheets.map(l=>l.name).join(", ")}.`,s.tables.length>0?`Tables: ${s.tables.map(l=>l.name).join(", ")}.`:"",s.names.size>0?`Names: ${[...s.names.values()].map(l=>l.name).join(", ")}.`:"","A range is Summary!B3:D3, or B3 on the first sheet."].filter(Boolean).join(" ")});return[R(r,i,o,e)]}function W(e){const o=[];for(const s of e)s.forEach((t,n)=>{o[n]=Math.max(o[n]??0,t.length)});return e.map(s=>s.map((t,n)=>n===s.length-1?t:t.padEnd(o[n]??0)).join("  ").trimEnd())}function Ce(e,o){const s=e.area===void 0?e.what:`${e.sheet}!${e.area}`,t=e.rows.slice(0,o),n=e.area!==void 0,a=t.map(c=>[...n?[/\d+$/u.exec(c[0]?.address??"")?.[0]??""]:[],...c.map(i=>i.shown)]),r=(e.rows[0]??[]).map(c=>c.address.replace(/\d+$/u,""));return[s,...W(n?[["",...r],...a]:a),...e.rows.length>t.length?[`… ${u(e.rows.length-t.length)} more rows (--all)`]:[]]}export const sheetCalc=E({name:"sheet calc",summary:"What a sheet computes, without opening anything: a sheet, a range, a table, a name, or every sheet, as an aligned table",input:d.strictObject({sheet:d.string().describe("The sheet, by its folder or its sheet.yaml"),what:d.string().optional().describe("A sheet (its used range), a range (Summary!B3:D3, or B3 on the first sheet), a table or a name; default every sheet"),all:d.boolean().default(!1).describe(`Every row, not the first ${String(CALC_ROWS)}`),scenario:d.string().optional().describe("Compute it with this scenario's inputs (sheet.yaml's scenarios); nothing is written"),scenarios:d.boolean().default(!1).describe("Compare the base case and every scenario: what is names, cells or ranges, apart by commas, a row each; default the names no scenario sets"),dir:C}),positional:["sheet","what"],output:d.looseObject({}),examples:["allyhub sheet calc finance/budget","allyhub sheet calc finance/budget Summary","allyhub sheet calc finance/budget orders","allyhub sheet calc finance/budget 'Summary!B3:M3' --json","allyhub sheet calc finance/budget revenue --scenario high","allyhub sheet calc finance/budget 'revenue,Summary!B4' --scenarios"]},async(e,o)=>{const s=await T(o.cwd,e.dir);if(e.scenarios)return Ae(s,o.cwd,e.sheet,e.what);const{file:t,calc:n,problems:a,workbook:r}=await openSheet(s,o.cwd,e.sheet,e.scenario);e.scenario!==void 0&&Ee(r,e.scenario);const c=te(n,e.what),i=e.all?1/0:CALC_ROWS;return{value:{file:t,grids:c,problems:a},text:[...c.flatMap((l,m)=>[...m>0?[""]:[],...Ce(l,i)]),...P(a)].join(`
-`)}});function Fe(e,o){return te(e,o.trim()).flatMap(s=>s.rows.flat().map(t=>({...t,address:t.address===""?o.trim():`${s.sheet}!${t.address}`})))}async function Ae(e,o,s,t){const n=await openSheet(e,o,s),a=K(n.workbook);if(a.length===0)throw new g("not-found",`${n.file} has no scenarios.`,{exit:$.notFound,hint:"sheet.yaml's scenarios: { high: { growth: 0.2 } } names some."});const r=new Set(a.flatMap(h=>Object.keys(n.workbook.file.scenarios?.[h]??{}).map(b=>b.toLowerCase()))),c=t?.split(",")??[...n.workbook.names.values()].map(h=>h.name).filter(h=>!r.has(h.toLowerCase()));if(c.length===0)throw new g("bad-input","Say what to compare: names, cells or ranges, apart by commas.",{exit:$.usage});const i=["Base case",...a],l=[n,...await Promise.all(a.map(h=>openSheet(e,o,s,h)))],w=c.map(h=>l.map(b=>Fe(b.calc,h))).flatMap(h=>(h[0]??[]).map((b,p)=>({output:b.address,values:Object.fromEntries(i.map((v,y)=>[v,h[y]?.[p]?.value??null])),shown:Object.fromEntries(i.map((v,y)=>[v,h[y]?.[p]?.shown??""]))})));return{value:{file:n.file,scenarios:i,outputs:w},text:[...W([["",...i],...w.map(h=>[h.output,...i.map(b=>h.shown[b]??"")])]),...P(n.problems)].join(`
-`)}}const Me=(e,o)=>`${e.sheet===o?"":`${e.sheet.name}!`}${G({top:e.top,left:e.left,bottom:Math.min(e.bottom,Math.max(e.top,e.sheet.lastRow)),right:e.right})}`;export const sheetTrace=E({name:"sheet trace",summary:"What a cell depends on and what depends on it: its formula, where it is written, the places it reads and the cells that read it",input:d.strictObject({sheet:d.string().describe("The sheet, by its folder or its sheet.yaml"),cell:d.string().describe("The cell: Summary!B5, or B5 on the first sheet"),all:d.boolean().default(!1).describe(`Every cell that reads it, not the first ${String(TRACE_CELLS)}`),dir:C}),positional:["sheet","cell"],output:d.looseObject({}),examples:["allyhub sheet trace finance/budget 'Summary!B1'"]},async(e,o)=>{const s=await T(o.cwd,e.dir),{file:t,workbook:n,calc:a}=await openSheet(s,o.cwd,e.sheet),{sheet:r,address:c}=ee(n,e.cell),i=ke(c);if(!i)throw new g("bad-input",`${e.cell} is not a cell.`,{exit:$.usage});const{row:l,col:m}=i,w=a.value(r,l,m),h=r.lookAt(l,m).format,b=r.at(l,m),p=n.sourceOf(r,l,m),v=b instanceof O?a.precedents(b).map(f=>{const le=f.single?j(a.value(f.sheet,f.top,f.left),f.sheet.lookAt(f.top,f.left).format):`${u(f.cols)} × ${u(Math.max(0,Math.min(f.bottom,f.sheet.lastRow)-f.top+1))}`,V=f.single?f.sheet.at(f.top,f.left):void 0,J=V instanceof O?V.text:void 0;return{address:Me(f,r),shown:le,...J===void 0?{}:{formula:J}}}):[],y=a.readers(r,l,m),L=e.all?y:y.slice(0,TRACE_CELLS),U=L.map(f=>({address:`${f.sheet===r?"":`${f.sheet.name}!`}${M(f)}`,shown:j(f.value,f.sheet.lookAt(f.row,f.col).format),formula:f.text})),z=f=>[`  ${f.address}`,f.shown,f.formula].filter(Boolean).join("  "),F=p===void 0?void 0:p.line===void 0?p.file:`${p.file}:${String(p.line)}`;return{value:{file:t,cell:`${r.name}!${M(i)}`,value:_(w,h),shown:j(w,h),...w instanceof we?{error:w.code}:{},...b instanceof O?{formula:b.text}:{},...F===void 0?{}:{written:F},reads:v,readBy:U,readers:y.length},text:[`${r.name}!${M(i)}  ${j(w,h)}`,...b instanceof O?[`  ${b.text}`]:[],...F===void 0?[]:[`  written in ${F}`],...v.length>0?["reads:",...v.map(z)]:[],...y.length>0?[`read by ${u(y.length)}:`,...U.map(z),...y.length>L.length?[`  … ${u(y.length-L.length)} more (--all)`]:[]]:["read by nothing"]].join(`
-`)}}),sheetCapabilities=E({name:"sheet capabilities",summary:"What @allyhub/sdk/sheets holds of openpyxl's (its classes), how it differs and what it adds, and the worksheet functions, as JSON",input:d.strictObject({}),output:d.looseObject({}),examples:["allyhub sheet capabilities"]},()=>Promise.resolve({value:{...Y},text:JSON.stringify(Y,null,2)}));const se=new Set([".xlsx",".xlsm",".xltx",".xltm"]);export const DIFF_ROWS=50;const oe={value:"Value changed, formula the same",formula:"Formula changed, value the same",both:"Formula and value changed",added:"Added",removed:"Removed"},Ie=e=>{const o=(e.now??e.was)?.cell??"",s=e.table===void 0?o:`${e.table}[${e.key??o}]`,t=e.column===void 0?"":` ${e.column}`;return`${e.sheet}!${s}${t}`},Re=e=>{const o=e.was?.formula??"",s=e.now?.formula??"";return[Ie(e),e.was?.shown??"","→",e.now?.shown??"",e.kind==="value"?s:e.kind==="formula"||e.kind==="both"?`${o} → ${s}`:s===""?o:s]};function Le(e,o){const s=[];for(const t of e.sheets)s.push(`Sheet ${t.name} ${t.added?"added":"removed"}`);for(const t of e.tables){const n=[t.rowsAdded.length>0?`rows added: ${t.rowsAdded.slice(0,20).join(", ")}`:"",t.rowsRemoved.length>0?`rows removed: ${t.rowsRemoved.slice(0,20).join(", ")}`:"",t.columnsAdded.length>0?`columns added: ${t.columnsAdded.join(", ")}`:"",t.columnsRemoved.length>0?`columns removed: ${t.columnsRemoved.join(", ")}`:""].filter(Boolean);s.push(`Table ${t.name}, rows lined up by ${t.by==="key"?t.key??"its key":"their place"}${n.length>0?`: ${n.join("; ")}`:""}`)}for(const t of e.names)s.push(`Name ${t.name}: ${t.was??"(none)"} → ${t.now??"(none)"}`);for(const t of e.parts)s.push(`${t.sheet??"Workbook"} ${t.part}${t.key===void 0?"":` ${t.key}`}: ${t.was??"(none)"} → ${t.now??"(none)"}`);for(const t of e.charts)s.push(`Charts of ${t} changed`);for(const t of Object.keys(oe)){const n=e.cells.filter(r=>r.kind===t);if(n.length===0)continue;const a=o?n:n.slice(0,DIFF_ROWS);s.push("",`${oe[t]}: ${u(n.length)}`,...W(a.map(Re)).map(r=>`  ${r}`),...n.length>a.length?[`  … ${u(n.length-a.length)} more (--all)`]:[])}return s}async function ne(e,o,s){const t=D(o,s);if(se.has(A(t).toLowerCase())){const r=await H(t).catch(()=>{throw new g("not-found",`There is no file ${t}.`,{exit:$.notFound})}),c=Z(new Uint8Array(r),{name:k(t,A(t))}),{calc:i}=q({text:c.files.get(x)??"",read:l=>c.files.get(l)});if(!i)throw new g("bad-file",`${s} cannot be read.`,{exit:$.usage});return{calc:i,file:s}}const{calc:n,file:a}=await openSheet(e,o,s);return{calc:n,file:a}}export const sheetDiff=E({name:"sheet diff",summary:"Two versions of a workbook compared, by value and by formula: two folders, or a folder and an .xlsx. Cells whose formula changed and value did not are apart from those whose value changed; rows of a table line up by its key, else by their place",input:d.strictObject({was:d.string().describe("The version before: a sheet's folder or an .xlsx"),now:d.string().describe("The version after: a sheet's folder or an .xlsx"),tolerance:d.number().min(0).default(pe.tolerance).describe("How far apart two numbers may be, as a share of the larger, and be the same"),all:d.boolean().default(!1).describe(`Every cell, not the first ${String(DIFF_ROWS)} of each kind`),dir:C}),positional:["was","now"],output:d.looseObject({}),examples:["allyhub sheet diff finance/budget finance/budget-v2","allyhub sheet diff finance/budget ~/Downloads/budget.xlsx --json"]},async(e,o)=>{const s=await T(o.cwd,e.dir),t=await ne(s,o.cwd,e.was),n=await ne(s,o.cwd,e.now),a=ye(t.calc,n.calc,{tolerance:e.tolerance}),{counts:r}=a,c=a.cells.length;return{value:{was:t.file,now:n.file,...a},text:[`${t.file} → ${n.file}: ${u(c)} cell${c===1?"":"s"} differ (${u(r.value)} value, ${u(r.formula)} formula, ${u(r.both)} both, ${u(r.added)} added, ${u(r.removed)} removed); ${u(a.names.length+a.parts.length)} other thing${a.names.length+a.parts.length===1?"":"s"} differ${a.names.length+a.parts.length===1?"s":""}`,...Le(a,e.all)].join(`
-`)}});const Ne=d.string().transform(e=>e.replace(/^\/+|\/+$/gu,"")).refine(e=>e!==""&&!e.split("/").some(o=>o===""||o==="."||o===".."),{message:"a folder from the project's root, such as research/leads"});export const IMPORT_DIFFERENCES=50;const ae=e=>e===null?"empty":typeof e=="string"?JSON.stringify(e):String(e);function Be(e,o){const{formulas:s,same:t,uncached:n,moving:a,differences:r}=e,c=[`${u(t)} of ${u(s)} formulas compute what the file holds`,...a>0?[`${u(a)} read the clock or a random number, not compared`]:[],...n>0?[`${u(n)} have no value in the file`]:[]],i=o?r:r.slice(0,IMPORT_DIFFERENCES);return[`Computed here against the file: ${c.join("; ")}.`,...r.length>0?[`${u(r.length)} differ${r.length===1?"s":""}:`,...i.map(l=>`  ${l.sheet}!${l.cell}  ${l.formula}  file ${ae(l.file)}  here ${ae(l.engine)}`),...r.length>i.length?[`  … ${u(r.length-i.length)} more (--all)`]:[]]:[]]}async function re(e,o){for(const[s,t]of o){const n=S(e,s);await ie(N(n),{recursive:!0}),await ce(n,t,{flag:"wx"})}}export const sheetImport=E({name:"sheet import",summary:"Makes a sheet of an Excel, CSV or TSV file: its sheets, tables, formulas, names and looks as sheet.yaml and CSV files, said what could not be carried over, each formula computed here and compared with the value the file holds; never over a place that is taken",input:d.strictObject({file:d.string().describe("The file to make a sheet of: .xlsx, .xlsm, .csv or .tsv"),to:Ne.optional().describe("The sheet's folder, from the project's root (default the file's name)"),maxUnzipped:d.number().positive().default(ue.bytes/1024/1024).describe("MB the file may unzip to, a file past it refused"),tolerance:d.number().min(0).default(je).describe("How far apart a computed number and the file's may be, as a share of the larger, and count as the same; 0 lists every difference"),all:d.boolean().default(!1).describe(`Every difference, not the first ${String(IMPORT_DIFFERENCES)}`),dir:C}),positional:["file"],output:d.looseObject({}),examples:["allyhub sheet import ~/Downloads/forecast.xlsx --to finance/forecast","allyhub sheet import ~/Downloads/leads.csv --to research/leads"]},async(e,o)=>{const s=await T(o.cwd,e.dir),t=D(o.cwd,e.file),n=A(t).toLowerCase(),a=se.has(n);if(n===".xls"||n===".xlsb")throw new g("bad-file",`${k(t)} is Excel's binary format.`,{exit:$.usage,hint:"Save it as .xlsx, then import that."});if(!a&&n!==".csv"&&n!==".tsv")throw new g("bad-file",`${k(t)} is not an .xlsx, .xlsm, .csv or .tsv file.`,{exit:$.usage});const r=await H(t).catch(()=>{throw new g("not-found",`There is no file ${t}.`,{exit:$.notFound})}),c=k(t,A(t)),i=e.to??c;if(await X(S(s,i)).catch(()=>{}))throw new g("place-taken",`${i} is already there.`,{exit:$.conflict,hint:"Name another place with --to."});const l=S(s,i),m=e.to===void 0?c:k(e.to);if(a){let h;try{h=Z(new Uint8Array(r),{name:m,tolerance:e.tolerance,zip:{bytes:e.maxUnzipped*1024*1024}})}catch(p){throw new g("bad-file",`${k(t)} cannot be read: ${p.message}`,{exit:$.usage})}await re(l,new Map([...h.files,...h.assets]));const b=[...h.files.keys(),...h.assets.keys()];return{value:{place:i,files:b.map(p=>`${i}/${p}`),sheets:h.sheets,tables:h.tables,lost:h.lost,problems:h.problems,compared:h.compared},text:[`Made ${i}/: ${b.join(", ")}`,...h.lost.length>0?["Not carried over:",...h.lost.map(p=>`  ${p}`)]:["Nothing was left out."],...Be(h.compared,e.all),...h.problems.length>0?["Problems:",...h.problems.map(p=>`  ${p.file}${p.line===void 0?"":`:${String(p.line)}`}: ${p.message}`)]:[],`allyhub sheet calc ${i}, then allyhub frames ${i}, to see it.`].join(`
-`)}}let w;try{w=xe(m,r.toString("utf8"),n===".tsv"?"	":",")}catch(h){throw new g("bad-file",h.message,{exit:$.usage})}return await re(l,new Map([[x,w.text],[w.path,w.csv]])),{value:{place:i,files:[`${i}/${x}`,`${i}/${w.path}`],rows:w.rows,lost:[]},text:`Made ${i}/${x} and ${i}/${w.path}: ${u(w.rows)} row${w.rows===1?"":"s"}`}});
+import{mkdir as ie,readFile as H,stat as X,writeFile as ce}from"node:fs/promises";import{basename as v,dirname as N,extname as A,join as E,relative as B,resolve as D}from"node:path";import{z as d}from"zod";import{readSheetSource as he,sheetRoot as de,workbookFiles as fe}from"@allyhub/build";import{ITEM_KINDS as me,ZIP_LIMITS as ue}from"@allyhub/formats";import{EXIT as $}from"@allyhub/protocol";import{CellError as we,DIFF_DEFAULTS as pe,FormulaCell as O,Matrix as be,PROFILE_TOP as $e,SharedFormula as ge,cellName as M,checkWorkbook as q,dataValue as _,diffWorkbooks as ye,importRows as xe,profileTable as ve,rangeName as G,readAddress as ke,readArea as Se,scenarioNames as K,shownValue as S}from"@allyhub/sheet";import{CAPABILITIES as Y}from"@allyhub/sheet/api";import{COMPARE_TOLERANCE as je,importXlsx as Z}from"@allyhub/sheet/xlsx";import{CommandError as g,defineCommand as j}from"../command.js";import{projectRoot as T}from"../project.js";import{dir as C}from"../fields.js";const k=me.sheet.entries[0];export const CALC_ROWS=50,TRACE_CELLS=50;export async function findSheet(e,o,s){const t=D(o,s);for(const n of[v(t)===k?t:E(t,k),E(e,s,k)])if((await X(n).catch(()=>{}))?.isFile())return n}export const sheetFolderName=(e,o)=>B(e,N(o));export async function sheetAt(e,o,s){const t=await findSheet(e,o,s);if(t!==void 0)return t;throw new g("not-found",`There is no sheet ${s}.`,{exit:$.notFound,hint:"Name it by its folder (research/leads) or its sheet.yaml."})}export async function sourceOfSheet(e,o){const s=de(e,N(o)),t=await he(s.root,s.dir);return{...s,source:t,files:fe(s.root,t)}}export async function openSheet(e,o,s,t){const n=await sheetAt(e,o,s),{source:a,files:r}=await sourceOfSheet(e,n),{workbook:c,calc:i,problems:l}=q(r,{scenario:t});if(!c||!i)throw new g("bad-file",`${B(e,n)} cannot be read: ${l.map(m=>`${m.line===void 0?"":`line ${String(m.line)}: `}${m.message}`).join("; ")}`,{exit:$.usage,hint:"allyhub check lists what is wrong."});return{file:B(e,n),workbook:c,calc:i,problems:l.length+a.problems.length}}function Ee(e,o){const s=K(e);if(!s.includes(o))throw new g("not-found",`There is no scenario ${o}.`,{exit:$.notFound,hint:s.length>0?`It has ${s.join(", ")}.`:"sheet.yaml's scenarios holds none."})}const u=e=>e.toLocaleString("en-US"),I=e=>e.toLocaleString("en-US",{maximumFractionDigits:4}),P=e=>e>0?["",`The workbook has ${String(e)} problem${e===1?"":"s"}: allyhub check lists them.`]:[];function Oe(e,o){const s=[`${u(e.empty)} empty`,`${u(e.distinct)} distinct`];e.errors>0&&s.push(`${u(e.errors)} errors`),e.min!==void 0&&e.max!==void 0&&s.push(`${I(e.min)} to ${I(e.max)}`),e.sum!==void 0&&s.push(`sum ${I(e.sum)}`),e.mean!==void 0&&s.push(`mean ${I(e.mean)}`),e.shortest!==void 0&&e.longest!==void 0&&s.push(`${String(e.shortest)} to ${String(e.longest)} characters`);const t=[`${e.name.padEnd(o)}  ${s.join(", ")}`];return e.formula!==void 0&&t.push(`${"".padEnd(o)}  ${e.formula}`),e.top.some(n=>n.count>1)&&t.push(`${"".padEnd(o)}  most: ${e.top.map(n=>`${JSON.stringify(n.value.length>40?`${n.value.slice(0,39)}…`:n.value)} ${u(n.count)}`).join(", ")}`),t}export const sheet=j({name:"sheet",summary:"Each table of a sheet measured: its columns' counts, empty, distinct, ranges and frequent values",input:d.strictObject({sheet:d.string().describe("The sheet, by its folder or its sheet.yaml"),dir:C}),positional:["sheet"],output:d.looseObject({}),examples:["allyhub sheet research/leads"]},async(e,o)=>{const s=await T(o.cwd,e.dir),{file:t,workbook:n,calc:a,problems:r}=await openSheet(s,o.cwd,e.sheet),c=n.tables.map(l=>({name:l.name,rows:l.rows,columns:ve(a,l)})),i=c.flatMap(l=>{const m=Math.min(24,Math.max(4,...l.columns.map(w=>w.name.length)));return["",`${l.name}: ${u(l.rows)} rows, ${String(l.columns.length)} columns; each column's ${String($e)} most frequent values`,...l.columns.flatMap(w=>Oe(w,m))]});return{value:{file:t,tables:c,problems:r},text:[`${t}: ${String(n.sheets.length)} sheet${n.sheets.length===1?"":"s"}, ${String(c.length)} table${c.length===1?"":"s"}`,...i,...P(r)].join(`
+`)}});const Q=e=>{const o=e.sheets[0];if(!o)throw new g("bad-file","The workbook has no sheets.",{exit:$.usage});return o};function ee(e,o){const s=o.lastIndexOf("!");if(s<0)return{sheet:Q(e),address:o};const t=o.slice(0,s).replace(/^'|'$/gu,"").replaceAll("''","'"),n=e.sheet(t);if(!n)throw new g("not-found",`There is no sheet ${t}.`,{exit:$.notFound,hint:`It has ${e.sheets.map(a=>a.name).join(", ")}.`});return{sheet:n,address:o.slice(s+1)}}function R(e,o,s,t){const n=[];for(let a=o.top;a<=o.bottom;a++){const r=[];for(let c=o.left;c<=o.right;c++){const i=t.value(e,a,c),l=e.lookAt(a,c).format,m=e.at(a,c);r.push({address:M({row:a,col:c}),value:_(i,l),shown:S(i,l),...m instanceof O?{formula:m.text}:{}})}n.push(r)}return{sheet:e.name,what:s,area:G(o),rows:n}}function Te(e,o,s){const t=a=>({address:"",value:_(a,void 0),shown:S(a)});if(!(s instanceof be))return{sheet:e.name,what:o,rows:[[t(s)]]};const n=[];for(let a=0;a<s.rows;a++){const r=[];for(let c=0;c<s.cols;c++)r.push(t(s.at(a,c)));n.push(r)}return{sheet:e.name,what:o,rows:n}}function te(e,o){const{wb:s}=e;if(o===void 0)return s.sheets.flatMap(l=>{const m=l.used;return m?[R(l,m,l.name,e)]:[]});const t=s.table(o);if(t)return[R(t.sheet,t.area,o,e)];const n=s.name(o);if(n){const l=new ge(n.formula?.text??`=${o}`,0,0,{file:""}),m=Q(s);return[Te(m,o,e.evaluate(l,m))]}const a=s.sheet(o);if(a){const l=a.used;return[l?R(a,l,o,e):{sheet:a.name,what:o,rows:[]}]}const{sheet:r,address:c}=ee(s,o),i=Se(c);if(!i)throw new g("not-found",`${o} is not a sheet, a table, a name or a range of this workbook.`,{exit:$.notFound,hint:[`Sheets: ${s.sheets.map(l=>l.name).join(", ")}.`,s.tables.length>0?`Tables: ${s.tables.map(l=>l.name).join(", ")}.`:"",s.names.size>0?`Names: ${[...s.names.values()].map(l=>l.name).join(", ")}.`:"","A range is Summary!B3:D3, or B3 on the first sheet."].filter(Boolean).join(" ")});return[R(r,i,o,e)]}function W(e){const o=[];for(const s of e)s.forEach((t,n)=>{o[n]=Math.max(o[n]??0,t.length)});return e.map(s=>s.map((t,n)=>n===s.length-1?t:t.padEnd(o[n]??0)).join("  ").trimEnd())}function Ce(e,o){const s=e.area===void 0?e.what:`${e.sheet}!${e.area}`,t=e.rows.slice(0,o),n=e.area!==void 0,a=t.map(c=>[...n?[/\d+$/u.exec(c[0]?.address??"")?.[0]??""]:[],...c.map(i=>i.shown)]),r=(e.rows[0]??[]).map(c=>c.address.replace(/\d+$/u,""));return[s,...W(n?[["",...r],...a]:a),...e.rows.length>t.length?[`… ${u(e.rows.length-t.length)} more rows (--all)`]:[]]}export const sheetCalc=j({name:"sheet calc",summary:"What a sheet computes, without opening anything: a sheet, a range, a table, a name, or every sheet, as an aligned table",input:d.strictObject({sheet:d.string().describe("The sheet, by its folder or its sheet.yaml"),what:d.string().optional().describe("A sheet (its used range), a range (Summary!B3:D3, or B3 on the first sheet), a table or a name; default every sheet"),all:d.boolean().default(!1).describe(`Every row, not the first ${String(CALC_ROWS)}`),scenario:d.string().optional().describe("Compute it with this scenario's inputs (sheet.yaml's scenarios); nothing is written"),scenarios:d.boolean().default(!1).describe("Compare the base case and every scenario: what is names, cells or ranges, apart by commas, a row each; default the names no scenario sets"),dir:C}),positional:["sheet","what"],output:d.looseObject({}),examples:["allyhub sheet calc finance/budget","allyhub sheet calc finance/budget Summary","allyhub sheet calc finance/budget orders","allyhub sheet calc finance/budget 'Summary!B3:M3' --json","allyhub sheet calc finance/budget revenue --scenario high","allyhub sheet calc finance/budget 'revenue,Summary!B4' --scenarios"]},async(e,o)=>{const s=await T(o.cwd,e.dir);if(e.scenarios)return Ae(s,o.cwd,e.sheet,e.what);const{file:t,calc:n,problems:a,workbook:r}=await openSheet(s,o.cwd,e.sheet,e.scenario);e.scenario!==void 0&&Ee(r,e.scenario);const c=te(n,e.what),i=e.all?1/0:CALC_ROWS;return{value:{file:t,grids:c,problems:a},text:[...c.flatMap((l,m)=>[...m>0?[""]:[],...Ce(l,i)]),...P(a)].join(`
+`)}});function Fe(e,o){return te(e,o.trim()).flatMap(s=>s.rows.flat().map(t=>({...t,address:t.address===""?o.trim():`${s.sheet}!${t.address}`})))}async function Ae(e,o,s,t){const n=await openSheet(e,o,s),a=K(n.workbook);if(a.length===0)throw new g("not-found",`${n.file} has no scenarios.`,{exit:$.notFound,hint:"sheet.yaml's scenarios: { high: { growth: 0.2 } } names some."});const r=new Set(a.flatMap(h=>Object.keys(n.workbook.file.scenarios?.[h]??{}).map(b=>b.toLowerCase()))),c=t?.split(",")??[...n.workbook.names.values()].map(h=>h.name).filter(h=>!r.has(h.toLowerCase()));if(c.length===0)throw new g("bad-input","Say what to compare: names, cells or ranges, apart by commas.",{exit:$.usage});const i=["Base case",...a],l=[n,...await Promise.all(a.map(h=>openSheet(e,o,s,h)))],w=c.map(h=>l.map(b=>Fe(b.calc,h))).flatMap(h=>(h[0]??[]).map((b,p)=>({output:b.address,values:Object.fromEntries(i.map((x,y)=>[x,h[y]?.[p]?.value??null])),shown:Object.fromEntries(i.map((x,y)=>[x,h[y]?.[p]?.shown??""]))})));return{value:{file:n.file,scenarios:i,outputs:w},text:[...W([["",...i],...w.map(h=>[h.output,...i.map(b=>h.shown[b]??"")])]),...P(n.problems)].join(`
+`)}}const Me=(e,o)=>`${e.sheet===o?"":`${e.sheet.name}!`}${G({top:e.top,left:e.left,bottom:Math.min(e.bottom,Math.max(e.top,e.sheet.lastRow)),right:e.right})}`;export const sheetTrace=j({name:"sheet trace",summary:"What a cell depends on and what depends on it: its formula, where it is written, the places it reads and the cells that read it",input:d.strictObject({sheet:d.string().describe("The sheet, by its folder or its sheet.yaml"),cell:d.string().describe("The cell: Summary!B5, or B5 on the first sheet"),all:d.boolean().default(!1).describe(`Every cell that reads it, not the first ${String(TRACE_CELLS)}`),dir:C}),positional:["sheet","cell"],output:d.looseObject({}),examples:["allyhub sheet trace finance/budget 'Summary!B1'"]},async(e,o)=>{const s=await T(o.cwd,e.dir),{file:t,workbook:n,calc:a}=await openSheet(s,o.cwd,e.sheet),{sheet:r,address:c}=ee(n,e.cell),i=ke(c);if(!i)throw new g("bad-input",`${e.cell} is not a cell.`,{exit:$.usage});const{row:l,col:m}=i,w=a.value(r,l,m),h=r.lookAt(l,m).format,b=r.at(l,m),p=n.sourceOf(r,l,m),x=b instanceof O?a.precedents(b).map(f=>{const le=f.single?S(a.value(f.sheet,f.top,f.left),f.sheet.lookAt(f.top,f.left).format):`${u(f.cols)} × ${u(Math.max(0,Math.min(f.bottom,f.sheet.lastRow)-f.top+1))}`,V=f.single?f.sheet.at(f.top,f.left):void 0,J=V instanceof O?V.text:void 0;return{address:Me(f,r),shown:le,...J===void 0?{}:{formula:J}}}):[],y=a.readers(r,l,m),L=e.all?y:y.slice(0,TRACE_CELLS),U=L.map(f=>({address:`${f.sheet===r?"":`${f.sheet.name}!`}${M(f)}`,shown:S(f.value,f.sheet.lookAt(f.row,f.col).format),formula:f.text})),z=f=>[`  ${f.address}`,f.shown,f.formula].filter(Boolean).join("  "),F=p===void 0?void 0:p.line===void 0?p.file:`${p.file}:${String(p.line)}`;return{value:{file:t,cell:`${r.name}!${M(i)}`,value:_(w,h),shown:S(w,h),...w instanceof we?{error:w.code}:{},...b instanceof O?{formula:b.text}:{},...F===void 0?{}:{written:F},reads:x,readBy:U,readers:y.length},text:[`${r.name}!${M(i)}  ${S(w,h)}`,...b instanceof O?[`  ${b.text}`]:[],...F===void 0?[]:[`  written in ${F}`],...x.length>0?["reads:",...x.map(z)]:[],...y.length>0?[`read by ${u(y.length)}:`,...U.map(z),...y.length>L.length?[`  … ${u(y.length-L.length)} more (--all)`]:[]]:["read by nothing"]].join(`
+`)}}),sheetCapabilities=j({name:"sheet capabilities",summary:"What @allyhub/sdk/sheets holds of openpyxl's (its classes), how it differs and what it adds, and the worksheet functions, as JSON",input:d.strictObject({}),output:d.looseObject({}),examples:["allyhub sheet capabilities"]},()=>Promise.resolve({value:{...Y},text:JSON.stringify(Y,null,2)}));const se=new Set([".xlsx",".xlsm",".xltx",".xltm"]);export const DIFF_ROWS=50;const oe={value:"Value changed, formula the same",formula:"Formula changed, value the same",both:"Formula and value changed",added:"Added",removed:"Removed"},Ie=e=>{const o=(e.now??e.was)?.cell??"",s=e.table===void 0?o:`${e.table}[${e.key??o}]`,t=e.column===void 0?"":` ${e.column}`;return`${e.sheet}!${s}${t}`},Re=e=>{const o=e.was?.formula??"",s=e.now?.formula??"";return[Ie(e),e.was?.shown??"","→",e.now?.shown??"",e.kind==="value"?s:e.kind==="formula"||e.kind==="both"?`${o} → ${s}`:s===""?o:s]};function Le(e,o){const s=[];for(const t of e.sheets)s.push(`Sheet ${t.name} ${t.added?"added":"removed"}`);for(const t of e.tables){const n=[t.rowsAdded.length>0?`rows added: ${t.rowsAdded.slice(0,20).join(", ")}`:"",t.rowsRemoved.length>0?`rows removed: ${t.rowsRemoved.slice(0,20).join(", ")}`:"",t.columnsAdded.length>0?`columns added: ${t.columnsAdded.join(", ")}`:"",t.columnsRemoved.length>0?`columns removed: ${t.columnsRemoved.join(", ")}`:""].filter(Boolean);s.push(`Table ${t.name}, rows lined up by ${t.by==="key"?t.key??"its key":"their place"}${n.length>0?`: ${n.join("; ")}`:""}`)}for(const t of e.names)s.push(`Name ${t.name}: ${t.was??"(none)"} → ${t.now??"(none)"}`);for(const t of e.parts)s.push(`${t.sheet??"Workbook"} ${t.part}${t.key===void 0?"":` ${t.key}`}: ${t.was??"(none)"} → ${t.now??"(none)"}`);for(const t of e.charts)s.push(`Charts of ${t} changed`);for(const t of Object.keys(oe)){const n=e.cells.filter(r=>r.kind===t);if(n.length===0)continue;const a=o?n:n.slice(0,DIFF_ROWS);s.push("",`${oe[t]}: ${u(n.length)}`,...W(a.map(Re)).map(r=>`  ${r}`),...n.length>a.length?[`  … ${u(n.length-a.length)} more (--all)`]:[])}return s}async function ne(e,o,s){const t=D(o,s);if(se.has(A(t).toLowerCase())){const r=await H(t).catch(()=>{throw new g("not-found",`There is no file ${t}.`,{exit:$.notFound})}),c=Z(new Uint8Array(r),{name:v(t,A(t))}),{calc:i}=q({text:c.files.get(k)??"",read:l=>c.files.get(l)});if(!i)throw new g("bad-file",`${s} cannot be read.`,{exit:$.usage});return{calc:i,file:s}}const{calc:n,file:a}=await openSheet(e,o,s);return{calc:n,file:a}}export const sheetDiff=j({name:"sheet diff",summary:"Two versions of a workbook compared, by value and by formula: two folders, or a folder and an .xlsx. Cells whose formula changed and value did not are apart from those whose value changed; rows of a table line up by its key, else by their place",input:d.strictObject({was:d.string().describe("The version before: a sheet's folder or an .xlsx"),now:d.string().describe("The version after: a sheet's folder or an .xlsx"),tolerance:d.number().min(0).default(pe.tolerance).describe("How far apart two numbers may be, as a share of the larger, and be the same"),all:d.boolean().default(!1).describe(`Every cell, not the first ${String(DIFF_ROWS)} of each kind`),dir:C}),positional:["was","now"],output:d.looseObject({}),examples:["allyhub sheet diff finance/budget finance/budget-v2","allyhub sheet diff finance/budget ~/Downloads/budget.xlsx --json"]},async(e,o)=>{const s=await T(o.cwd,e.dir),t=await ne(s,o.cwd,e.was),n=await ne(s,o.cwd,e.now),a=ye(t.calc,n.calc,{tolerance:e.tolerance}),{counts:r}=a,c=a.cells.length;return{value:{was:t.file,now:n.file,...a},text:[`${t.file} → ${n.file}: ${u(c)} cell${c===1?"":"s"} differ (${u(r.value)} value, ${u(r.formula)} formula, ${u(r.both)} both, ${u(r.added)} added, ${u(r.removed)} removed); ${u(a.names.length+a.parts.length)} other thing${a.names.length+a.parts.length===1?"":"s"} differ${a.names.length+a.parts.length===1?"s":""}`,...Le(a,e.all)].join(`
+`)}});const Ne=d.string().transform(e=>e.replace(/^\/+|\/+$/gu,"")).refine(e=>e!==""&&!e.split("/").some(o=>o===""||o==="."||o===".."),{message:"a folder from the project's root, such as research/leads"});export const IMPORT_DIFFERENCES=50;const ae=e=>e===null?"empty":typeof e=="string"?JSON.stringify(e):String(e);function Be(e,o){const{formulas:s,same:t,uncached:n,moving:a,differences:r}=e,c=[`${u(t)} of ${u(s)} formulas compute what the file holds`,...a>0?[`${u(a)} read the clock or a random number, not compared`]:[],...n>0?[`${u(n)} have no value in the file`]:[]],i=o?r:r.slice(0,IMPORT_DIFFERENCES);return[`Computed here against the file: ${c.join("; ")}.`,...r.length>0?[`${u(r.length)} differ${r.length===1?"s":""}:`,...i.map(l=>`  ${l.sheet}!${l.cell}  ${l.formula}  file ${ae(l.file)}  here ${ae(l.engine)}`),...r.length>i.length?[`  … ${u(r.length-i.length)} more (--all)`]:[]]:[]]}async function re(e,o){for(const[s,t]of o){const n=E(e,s);await ie(N(n),{recursive:!0}),await ce(n,t,{flag:"wx"})}}export const sheetImport=j({name:"sheet import",summary:"Makes a sheet of an Excel, CSV or TSV file: its sheets, tables, formulas, names and looks as sheet.yaml and CSV files, said what could not be carried over, each formula computed here and compared with the value the file holds; never over a place that is taken",input:d.strictObject({file:d.string().describe("The file to make a sheet of: .xlsx, .xlsm, .csv or .tsv"),to:Ne.optional().describe("The sheet's folder, from the project's root (default the file's name)"),maxUnzipped:d.number().positive().default(ue.bytes/1024/1024).describe("MB the file may unzip to, a file past it refused"),tolerance:d.number().min(0).default(je).describe("How far apart a computed number and the file's may be, as a share of the larger, and count as the same; 0 lists every difference"),all:d.boolean().default(!1).describe(`Every difference, not the first ${String(IMPORT_DIFFERENCES)}`),dir:C}),positional:["file"],output:d.looseObject({}),examples:["allyhub sheet import ~/Downloads/forecast.xlsx --to finance/forecast","allyhub sheet import ~/Downloads/leads.csv --to research/leads"]},async(e,o)=>{const s=await T(o.cwd,e.dir),t=D(o.cwd,e.file),n=A(t).toLowerCase(),a=se.has(n);if(n===".xls"||n===".xlsb")throw new g("bad-file",`${v(t)} is Excel's binary format.`,{exit:$.usage,hint:"Save it as .xlsx, then import that."});if(!a&&n!==".csv"&&n!==".tsv")throw new g("bad-file",`${v(t)} is not an .xlsx, .xlsm, .csv or .tsv file.`,{exit:$.usage});const r=await H(t).catch(()=>{throw new g("not-found",`There is no file ${t}.`,{exit:$.notFound})}),c=v(t,A(t)),i=e.to??c;if(await X(E(s,i)).catch(()=>{}))throw new g("place-taken",`${i} is already there.`,{exit:$.conflict,hint:"Name another place with --to."});const l=E(s,i),m=e.to===void 0?c:v(e.to);if(a){let h;try{h=Z(new Uint8Array(r),{name:m,tolerance:e.tolerance,zip:{bytes:e.maxUnzipped*1024*1024}})}catch(p){throw new g("bad-file",`${v(t)} cannot be read: ${p.message}`,{exit:$.usage})}await re(l,new Map([...h.files,...h.assets]));const b=[...h.files.keys(),...h.assets.keys()];return{value:{place:i,files:b.map(p=>`${i}/${p}`),sheets:h.sheets,tables:h.tables,lost:h.lost,problems:h.problems,compared:h.compared},text:[`Made ${i}/: ${b.join(", ")}`,...h.lost.length>0?["Not carried over:",...h.lost.map(p=>`  ${p}`)]:["Nothing was left out."],...Be(h.compared,e.all),...h.problems.length>0?["Problems:",...h.problems.map(p=>`  ${p.file}${p.line===void 0?"":`:${String(p.line)}`}: ${p.message}`)]:[],`allyhub sheet calc ${i}, then allyhub frames ${i}, to see it.`].join(`
+`)}}let w;try{w=xe(m,r.toString("utf8"),n===".tsv"?"	":",")}catch(h){throw new g("bad-file",h.message,{exit:$.usage})}return await re(l,new Map([[k,w.text],[w.path,w.csv]])),{value:{place:i,files:[`${i}/${k}`,`${i}/${w.path}`],rows:w.rows,lost:[]},text:`Made ${i}/${k} and ${i}/${w.path}: ${u(w.rows)} row${w.rows===1?"":"s"}`}});

package/dist/commands/site.js

@@ -1,4 +1,4 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{basename as w,join as d}from"node:path";import{z as e}from"zod";import{listFiles as g}from"@allyhub-next/build";import{Hashes as j,goLive as $,siteDetail as O}from"@allyhub-next/cloud";import{CACHE_DIR as k,scanItems as x}from"@allyhub-next/formats";import{EXIT as u}from"@allyhub-next/protocol";import{WebsiteProblem as W,deployWebsite as A,readWebsite as T}from"@allyhub-next/website";import{CommandError as m,defineCommand as c}from"../command.js";import{dir as h}from"../fields.js";import{projectRoot as N}from"../project.js";import{cloudOf as f,cloudWork as b,plural as S}from"./cloud.js";const C=s=>b(s).catch(i=>{throw i instanceof W?new m("website-invalid",i.message,{exit:u.usage,...i.hint===void 0?{}:{hint:i.hint}}):i}),p=e.string().optional().describe("The website: its folder, or its name when several are in the project. Left out, the project's one website");async function v(s,i){const r=await N(s.cwd,i.dir),{items:a}=x(await g(r)),t=a.filter(n=>n.kind==="website"),o=i.item,l=o===void 0?t.length===1?t[0]:void 0:t.find(n=>n.dir===o||n.dir.endsWith(`/${o}`)||w(n.dir)===o);if(l!==void 0)return{root:r,found:l};throw new m("no-item",t.length===0?"This project has no website: an item is a folder with a website.json.":o===void 0?`This project has ${String(t.length)} websites; say which: ${t.map(n=>n.dir).join(", ")}.`:`No website ${o} in the project: ${t.map(n=>n.dir).join(", ")}.`,{exit:u.notFound})}async function y(s,i){const{site:r}=await T(d(s,i.dir));if(r===void 0)throw new m("no-site",`${i.dir} is not hosted yet.`,{exit:u.notFound,hint:"allyhub site deploy"});return r}const D=e.looseObject({id:e.string(),live:e.boolean(),note:e.string().nullable(),files:e.number(),createdAt:e.string()});export const siteDeploy=c({name:"site deploy",summary:"Build a website here and upload it to AllyHub as a new version of its site, sending only the files AllyHub lacks; private until --live",input:e.strictObject({item:p,slug:e.string().optional().describe("The site's address, <slug>.allyhub.site, the first time; default from the website's folder"),note:e.string().optional().describe("What this version changes"),live:e.boolean().optional().describe("Make this version what the site's address serves"),built:e.boolean().optional().describe("Upload the output folder as it is, with no build"),dir:h}),positional:["item"],output:e.looseObject({site:e.looseObject({id:e.string(),url:e.string()}),version:e.string(),live:e.boolean(),confirm:e.string().optional(),files:e.number(),sent:e.number()}),examples:["allyhub site deploy","allyhub site deploy website --slug acme --live",'allyhub site deploy --note "New pricing" --live']},async(s,i)=>{const{root:r,found:a}=await v(i,s);return await C(async()=>{const t=await A(f(i),{dir:d(r,a.dir),name:w(a.dir),hashes:new j(d(r,k,"site-hashes.json")),env:{...i.env},onProgress:o=>{i.progress(o)},...s.slug===void 0?{}:{slug:s.slug},...s.note===void 0?{}:{note:s.note},...s.live===void 0?{}:{live:s.live},...s.built===!0?{build:!1}:{}});return{value:{site:t.site,version:t.deployment.id,live:t.live,...t.confirm===void 0?{}:{confirm:t.confirm},files:t.deployment.files,sent:t.sent},text:[`Version ${t.deployment.id}: ${S(t.deployment.files,"file")}, ${String(t.sent)} sent.`,t.live?`Live at ${t.site.url} within about a minute.`:t.confirm===void 0?`Not live. allyhub site live ${t.deployment.id} makes it what ${t.site.url} serves.`:`Not live: going public is the person's to say. Give them this page, or ask them to press Update in Studio: ${t.confirm}`].join(`
-`)}})}),siteStatus=c({name:"site status",summary:"A website's address and its versions, the live one marked",input:e.strictObject({item:p,dir:h}),positional:["item"],output:e.looseObject({site:e.looseObject({url:e.string()}),versions:e.array(D)}),examples:["allyhub site status"]},async(s,i)=>{const{root:r,found:a}=await v(i,s),t=await y(r,a);return await b(async()=>{const{site:o,deployments:l}=await O(f(i),t);return{value:{site:o,versions:l},text:[`${o.url}${o.liveDeployment===null?" (nothing live)":""}`,...l.map(n=>`${n.live?"*":" "} ${n.id}  ${n.createdAt}${n.note===null?"":`  ${n.note}`}`)].join(`
-`)}})}),siteLive=c({name:"site live",summary:"Make a version of a website what its address serves, an earlier one or one not live yet; nothing is built",input:e.strictObject({version:e.string().describe("The version, from allyhub site status"),item:p,dir:h}),positional:["version","item"],output:e.looseObject({site:e.looseObject({url:e.string()}),live:e.boolean(),confirm:e.string().optional()}),examples:["allyhub site live 0e1f…"]},async(s,i)=>{const{root:r,found:a}=await v(i,s),t=await y(r,a);return await b(async()=>{const o=await $(f(i),t,s.version);return{value:o,text:o.live?`${s.version} goes live at ${o.site.url} within about a minute.`:`Not live: that is the person's to say. Give them this page, or ask them to press Update in Studio: ${o.confirm??""}`}})});
+import{basename as w,join as d}from"node:path";import{z as e}from"zod";import{listFiles as g}from"@allyhub/build";import{Hashes as j,goLive as $,siteDetail as O}from"@allyhub/cloud";import{CACHE_DIR as k,scanItems as x}from"@allyhub/formats";import{EXIT as u}from"@allyhub/protocol";import{WebsiteProblem as W,deployWebsite as A,readWebsite as T}from"@allyhub/website";import{CommandError as m,defineCommand as h}from"../command.js";import{dir as c}from"../fields.js";import{projectRoot as D}from"../project.js";import{cloudOf as b,cloudWork as f,plural as N}from"./cloud.js";const S=s=>f(s).catch(i=>{throw i instanceof W?new m("website-invalid",i.message,{exit:u.usage,...i.hint===void 0?{}:{hint:i.hint}}):i}),p=e.string().optional().describe("The website: its folder, or its name when several are in the project. Left out, the project's one website");async function v(s,i){const r=await D(s.cwd,i.dir),{items:a}=x(await g(r)),t=a.filter(n=>n.kind==="website"),o=i.item,l=o===void 0?t.length===1?t[0]:void 0:t.find(n=>n.dir===o||n.dir.endsWith(`/${o}`)||w(n.dir)===o);if(l!==void 0)return{root:r,found:l};throw new m("no-item",t.length===0?"This project has no website: an item is a folder with a website.json.":o===void 0?`This project has ${String(t.length)} websites; say which: ${t.map(n=>n.dir).join(", ")}.`:`No website ${o} in the project: ${t.map(n=>n.dir).join(", ")}.`,{exit:u.notFound})}async function y(s,i){const{site:r}=await T(d(s,i.dir));if(r===void 0)throw new m("no-site",`${i.dir} is not hosted yet.`,{exit:u.notFound,hint:"allyhub site deploy"});return r}const C=e.looseObject({id:e.string(),live:e.boolean(),note:e.string().nullable(),files:e.number(),createdAt:e.string()});export const siteDeploy=h({name:"site deploy",summary:"Build a website here and upload it to AllyHub as a new version of its site, sending only the files AllyHub lacks; private until --live",input:e.strictObject({item:p,slug:e.string().optional().describe("The site's address, <slug>.allyhub.site, the first time; default from the website's folder"),note:e.string().optional().describe("What this version changes"),live:e.boolean().optional().describe("Make this version what the site's address serves"),built:e.boolean().optional().describe("Upload the output folder as it is, with no build"),new:e.boolean().optional().describe("Make a site of this team's for the folder, though website.json names another team's (theirs stays as it is)"),dir:c}),positional:["item"],output:e.looseObject({site:e.looseObject({id:e.string(),url:e.string()}),version:e.string(),live:e.boolean(),confirm:e.string().optional(),files:e.number(),sent:e.number()}),examples:["allyhub site deploy","allyhub site deploy website --slug acme --live",'allyhub site deploy --note "New pricing" --live']},async(s,i)=>{const{root:r,found:a}=await v(i,s);return await S(async()=>{const t=await A(b(i),{dir:d(r,a.dir),name:w(a.dir),hashes:new j(d(r,k,"site-hashes.json")),env:{...i.env},onProgress:o=>{i.progress(o)},...s.slug===void 0?{}:{slug:s.slug},...s.note===void 0?{}:{note:s.note},...s.live===void 0?{}:{live:s.live},...s.built===!0?{build:!1}:{},...s.new===!0?{anew:!0}:{}});return{value:{site:t.site,version:t.deployment.id,live:t.live,...t.confirm===void 0?{}:{confirm:t.confirm},files:t.deployment.files,sent:t.sent},text:[`Version ${t.deployment.id}: ${N(t.deployment.files,"file")}, ${String(t.sent)} sent.`,t.live?`Live at ${t.site.url} within about a minute.`:t.confirm===void 0?`Not live. allyhub site live ${t.deployment.id} makes it what ${t.site.url} serves.`:`Not live: going public is the person's to say. Give them this page, or ask them to press ${t.site.liveDeployment===null?"Publish":"Update"} in Studio: ${t.confirm}`].join(`
+`)}})}),siteStatus=h({name:"site status",summary:"A website's address and its versions, the live one marked",input:e.strictObject({item:p,dir:c}),positional:["item"],output:e.looseObject({site:e.looseObject({url:e.string()}),versions:e.array(C)}),examples:["allyhub site status"]},async(s,i)=>{const{root:r,found:a}=await v(i,s),t=await y(r,a);return await f(async()=>{const{site:o,deployments:l}=await O(b(i),t);return{value:{site:o,versions:l},text:[`${o.url}${o.liveDeployment===null?" (nothing live)":""}`,...l.map(n=>`${n.live?"*":" "} ${n.id}  ${n.createdAt}${n.note===null?"":`  ${n.note}`}`)].join(`
+`)}})}),siteLive=h({name:"site live",summary:"Make a version of a website what its address serves, an earlier one or one not live yet; nothing is built",input:e.strictObject({version:e.string().describe("The version, from allyhub site status"),item:p,dir:c}),positional:["version","item"],output:e.looseObject({site:e.looseObject({url:e.string()}),live:e.boolean(),confirm:e.string().optional()}),examples:["allyhub site live 0e1f…"]},async(s,i)=>{const{root:r,found:a}=await v(i,s),t=await y(r,a);return await f(async()=>{const o=await $(b(i),t,s.version);return{value:o,text:o.live?`${s.version} goes live at ${o.site.url} within about a minute.`:`Not live: that is the person's to say. Give them this page, or ask them to make this version live in the website's settings in Studio: ${o.confirm??""}`}})});

package/dist/commands/skills.js

@@ -1,4 +1,4 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{z as r}from"zod";import{EXIT as m}from"@allyhub-next/protocol";import{RegistryError as b}from"@allyhub-next/registry";import{workSkills as y}from"@allyhub-next/scaffold";import{CommandError as d,defineCommand as f}from"../command.js";import{resourcesIndex as w}from"../resources.js";const k="Check the connection and run the same command again.";function p(i){if(i.index===void 0)throw new d("no-registry",`AllyHub's skills could not be read from ${i.source.name}.`,{exit:m.platform,hint:k})}export const skills=f({name:"skills",summary:"Lists AllyHub's work skills, each how to make one kind of work, with what it is for: allyhub skills show <name> prints one, allyhub add skill/<name> puts it in the project",input:r.strictObject({}),output:r.looseObject({}),examples:["allyhub skills","allyhub skills show web-product-demos"]},async(i,c)=>{const s=await w(c);p(s);const a=y(s.index.items).map(t=>{const o=s.index.items.find(h=>h.name===t.name)?.version;return{...t,...o===void 0?{}:{version:o}}}),e=s.from==="stale",l=Math.max(0,...a.map(t=>t.name.length));return{value:{skills:a,stale:e},text:[`AllyHub's work skills (allyhub skills show <name> prints one; allyhub add skill/<name> puts it in the project, in .agents/skills)${e?", as last read (the registry cannot be read now)":""}:`,...a.length===0?["  none"]:a.map(t=>`  ${t.name.padEnd(l)}  ${t.description}`)].join(`
+import{z as r}from"zod";import{EXIT as m}from"@allyhub/protocol";import{RegistryError as b}from"@allyhub/registry";import{workSkills as y}from"@allyhub/scaffold";import{CommandError as d,defineCommand as f}from"../command.js";import{resourcesIndex as w}from"../resources.js";const k="Check the connection and run the same command again.";function p(i){if(i.index===void 0)throw new d("no-registry",`AllyHub's skills could not be read from ${i.source.name}.`,{exit:m.platform,hint:k})}export const skills=f({name:"skills",summary:"Lists AllyHub's work skills, each how to make one kind of work, with what it is for: allyhub skills show <name> prints one, allyhub add skill/<name> puts it in the project",input:r.strictObject({}),output:r.looseObject({}),examples:["allyhub skills","allyhub skills show web-product-demos"]},async(i,c)=>{const s=await w(c);p(s);const a=y(s.index.items).map(t=>{const o=s.index.items.find(h=>h.name===t.name)?.version;return{...t,...o===void 0?{}:{version:o}}}),e=s.from==="stale",l=Math.max(0,...a.map(t=>t.name.length));return{value:{skills:a,stale:e},text:[`AllyHub's work skills (allyhub skills show <name> prints one; allyhub add skill/<name> puts it in the project, in .agents/skills)${e?", as last read (the registry cannot be read now)":""}:`,...a.length===0?["  none"]:a.map(t=>`  ${t.name.padEnd(l)}  ${t.description}`)].join(`
 `)}}),skillsShow=f({name:"skills show",summary:"Prints one of AllyHub's skills in full, its SKILL.md and the names of its other files, without adding it to the project",input:r.strictObject({name:r.string().min(1).describe("The skill, as allyhub skills lists it (web-product-demos)")}),positional:["name"],output:r.looseObject({}),examples:["allyhub skills show web-product-demos"]},async(i,c)=>{const s=await w(c);if(p(s),s.index.items.find(e=>e.name===i.name)?.type!=="allyhub:skill")throw new d("no-item",`AllyHub has no skill ${i.name}.`,{exit:m.notFound,hint:"allyhub skills lists them."});try{const e=await s.source.item(i.name);if(!e)throw new d("no-item",`AllyHub has no skill ${i.name}.`,{exit:m.notFound,hint:"allyhub skills lists them."});const l=`.agents/skills/${e.name}/`,t=n=>n.startsWith(l)?n.slice(l.length):n,o=e.files.find(n=>t(n.target)==="SKILL.md");if(!o)throw new d("bad-registry",`The registry's ${e.name} has no SKILL.md.`);const h=o.content??new TextDecoder().decode(await s.source.file(o.path)),u=e.files.map(n=>t(n.target)).filter(n=>n!=="SKILL.md");return{value:{name:e.name,...e.version===void 0?{}:{version:e.version},skill:h,files:u},text:[h.trimEnd(),"",u.length===0?`It has no other files. allyhub add skill/${e.name} puts it in ${l}.`:`Its other files, which allyhub add skill/${e.name} puts beside it in ${l}: ${u.join(", ")}.`].join(`
 `)}}catch(e){throw e instanceof b?new d(e.code,e.message,{exit:e.code==="no-registry"?m.platform:m.failed,hint:e.hint??k}):e}});

package/dist/commands/slides.js

@@ -1,3 +1,3 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{mkdir as y,readFile as $,stat as x,writeFile as k}from"node:fs/promises";import{basename as f,dirname as j,join as h,resolve as v}from"node:path";import{z as o}from"zod";import{ZIP_LIMITS as I}from"@allyhub-next/formats";import{EXIT as n}from"@allyhub-next/protocol";import{CAPABILITIES as u}from"@allyhub-next/slides-core";import{groupReport as O}from"@allyhub-next/ooxml";import{importDeck as P,nameOf as S,readPptx as z}from"@allyhub-next/slides-pptx";import{CommandError as l,defineCommand as w}from"../command.js";import{dir as T}from"../fields.js";import{projectRoot as N}from"../project.js";export const slidesCapabilities=w({name:"slides capabilities",summary:"What a deck's API holds of python-pptx's (its classes and enums), how it differs and what it adds, as JSON",input:o.strictObject({}),output:o.looseObject({}),examples:["allyhub slides capabilities"]},()=>Promise.resolve({value:{...u},text:JSON.stringify(u,null,2)}));const A=o.string().transform(e=>e.replace(/^\/+|\/+$/gu,"")).refine(e=>e!==""&&!e.split("/").some(t=>t===""||t==="."||t===".."),{message:"a folder from the project's root, such as launch/deck"});export const slidesImport=w({name:"slides import",summary:"Makes a deck of a PowerPoint file: its masters and layouts as slides.ts, its slides as slides.yaml, its words and notes as the script, its pictures and videos in media/; says what it could not hold; never over a place that is taken",input:o.strictObject({file:o.string().describe("The .pptx to make a deck of"),to:A.optional().describe("The deck's folder, from the project's root (default the file's name)"),maxUnzipped:o.number().positive().default(I.bytes/1024/1024).describe("MB the file may unzip to, a file past it refused"),lang:o.string().regex(/^[a-z]{2,3}(-[a-z0-9]+)*$/u).default("en").describe("The language of its words: the script is script.<lang>.yaml"),dir:T}),positional:["file"],output:o.looseObject({}),examples:["allyhub slides import ~/Downloads/q3-review.pptx --to reviews/q3","allyhub slides import 培训.pptx --to training --lang zh-cn"]},async(e,t)=>{const d=await N(t.cwd,e.dir),r=v(t.cwd,e.file),b=await $(r).catch(()=>{throw new l("not-found",`There is no file ${r}.`,{exit:n.notFound})}),i=e.to??S(f(r).replace(/\.pptx$/iu,""),new Set,"deck");if(await x(h(d,i)).catch(()=>{}))throw new l("place-taken",`${i} is already there.`,{exit:n.conflict,hint:"Name another place with --to."});let a;try{a=P(z(new Uint8Array(b),{bytes:e.maxUnzipped*1024*1024}),{lang:e.lang,source:f(r)})}catch(s){throw new l("bad-file",`${r} is not a PowerPoint file this can read: ${s.message}`,{exit:n.usage})}for(const[s,g]of a.files){const m=h(d,i,s);await y(j(m),{recursive:!0}),await k(m,g,{flag:"wx"})}const p=[...a.files.keys()],c=O(a.report);return{value:{place:i,files:p.map(s=>`${i}/${s}`),report:a.report,skipped:Object.fromEntries(a.reasons)},text:[`Made ${i}/: ${p.join(", ")}`,...c.length>0?[`Not carried over as it is (${String(a.report.length)}, grouped; all with --json):`,...c.map(D)]:[],`allyhub check, then allyhub frames ${i}, to see it.`].join(`
+import{mkdir as y,readFile as $,stat as x,writeFile as k}from"node:fs/promises";import{basename as f,dirname as j,join as h,resolve as v}from"node:path";import{z as o}from"zod";import{ZIP_LIMITS as I}from"@allyhub/formats";import{EXIT as n}from"@allyhub/protocol";import{CAPABILITIES as u}from"@allyhub/slides-core";import{groupReport as O}from"@allyhub/ooxml";import{importDeck as P,nameOf as S,readPptx as z}from"@allyhub/slides-pptx";import{CommandError as l,defineCommand as w}from"../command.js";import{dir as T}from"../fields.js";import{projectRoot as N}from"../project.js";export const slidesCapabilities=w({name:"slides capabilities",summary:"What a deck's API holds of python-pptx's (its classes and enums), how it differs and what it adds, as JSON",input:o.strictObject({}),output:o.looseObject({}),examples:["allyhub slides capabilities"]},()=>Promise.resolve({value:{...u},text:JSON.stringify(u,null,2)}));const A=o.string().transform(e=>e.replace(/^\/+|\/+$/gu,"")).refine(e=>e!==""&&!e.split("/").some(t=>t===""||t==="."||t===".."),{message:"a folder from the project's root, such as launch/deck"});export const slidesImport=w({name:"slides import",summary:"Makes a deck of a PowerPoint file: its masters and layouts as slides.ts, its slides as slides.yaml, its words and notes as the script, its pictures and videos in media/; says what it could not hold; never over a place that is taken",input:o.strictObject({file:o.string().describe("The .pptx to make a deck of"),to:A.optional().describe("The deck's folder, from the project's root (default the file's name)"),maxUnzipped:o.number().positive().default(I.bytes/1024/1024).describe("MB the file may unzip to, a file past it refused"),lang:o.string().regex(/^[a-z]{2,3}(-[a-z0-9]+)*$/u).default("en").describe("The language of its words: the script is script.<lang>.yaml"),dir:T}),positional:["file"],output:o.looseObject({}),examples:["allyhub slides import ~/Downloads/q3-review.pptx --to reviews/q3","allyhub slides import 培训.pptx --to training --lang zh-cn"]},async(e,t)=>{const d=await N(t.cwd,e.dir),r=v(t.cwd,e.file),b=await $(r).catch(()=>{throw new l("not-found",`There is no file ${r}.`,{exit:n.notFound})}),i=e.to??S(f(r).replace(/\.pptx$/iu,""),new Set,"deck");if(await x(h(d,i)).catch(()=>{}))throw new l("place-taken",`${i} is already there.`,{exit:n.conflict,hint:"Name another place with --to."});let a;try{a=P(z(new Uint8Array(b),{bytes:e.maxUnzipped*1024*1024}),{lang:e.lang,source:f(r)})}catch(s){throw new l("bad-file",`${r} is not a PowerPoint file this can read: ${s.message}`,{exit:n.usage})}for(const[s,g]of a.files){const m=h(d,i,s);await y(j(m),{recursive:!0}),await k(m,g,{flag:"wx"})}const p=[...a.files.keys()],c=O(a.report);return{value:{place:i,files:p.map(s=>`${i}/${s}`),report:a.report,skipped:Object.fromEntries(a.reasons)},text:[`Made ${i}/: ${p.join(", ")}`,...c.length>0?[`Not carried over as it is (${String(a.report.length)}, grouped; all with --json):`,...c.map(D)]:[],`allyhub check, then allyhub frames ${i}, to see it.`].join(`
 `)}});const C={unread:"not read",extension:"an extension not read",part:"a part not read","cannot-hold":"cannot hold",approximated:"approximated",missing:"missing"};function D(e){const t=e.where.length>3?`${e.where.slice(0,3).join("; ")} and ${String(e.where.length-3)} more`:e.where.join("; ");return`  ${C[e.kind]}: ${e.what}${e.detail===void 0?"":` (${e.detail})`}${e.count>1?` ×${String(e.count)}`:""} at ${t}`}

package/dist/commands/voice.js

@@ -1,3 +1,3 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{z as t}from"zod";import{projectSays as h}from"@allyhub-next/project";import{makeSay as u}from"@allyhub-next/cloud";import{EXIT as y}from"@allyhub-next/protocol";import{CommandError as g,defineCommand as $}from"../command.js";import{projectRoot as b}from"../project.js";import{cloudOf as v,cloudWork as w,plural as d}from"./cloud.js";import{dir as j}from"../fields.js";const p=o=>Math.round(o*1e6)/1e6;export const voice=$({name:"voice",summary:"Make the voice files a project's say(text) parts need, with their cloud voice tool, one per say that has none (assets/media/gen/say/<hash>, its words and its record)",input:t.strictObject({item:t.string().optional().describe("Only this item's says: its id, a path into it, or a folder of items"),dir:j}),positional:["item"],output:t.looseObject({says:t.number(),made:t.array(t.looseObject({part:t.string(),file:t.string()})).optional(),credits:t.number().optional()}),examples:["allyhub voice","allyhub voice launch/film"]},async(o,r)=>{const a=await b(r.cwd,o.dir),s=await h(a,o.item===void 0?{}:{piece:o.item});if(o.item!==void 0&&s.pieces.length===0)throw new g("no-item",`No video ${o.item} in the project.`,{exit:y.notFound});const l=s.says.filter(n=>n.file===void 0),f=`Every say has its file (${d(s.says.length,"say")}). Nothing to make.`;return await w(async()=>{const n=v(r),i=[];for(const e of l){r.progress(`${e.piece} · ${e.part}: ${e.tool}…`);const c=await u(n,a,e,{base:a,signal:r.signal});i.push({piece:e.piece,part:e.part,...c})}const m=p(i.reduce((e,c)=>e+c.credits,0));return{value:{says:s.says.length,made:i,kept:s.says.length-l.length,credits:m},text:i.length===0?f:[`Made ${d(i.length,"file")}:`,...i.map(e=>`  ${e.file} (${e.piece} · ${e.part}, ${String(p(e.seconds))} s)`),`Credits used: ${String(m)}.`].join(`
+import{z as t}from"zod";import{projectSays as h}from"@allyhub/project";import{makeSay as u}from"@allyhub/cloud";import{EXIT as y}from"@allyhub/protocol";import{CommandError as g,defineCommand as $}from"../command.js";import{projectRoot as b}from"../project.js";import{cloudOf as v,cloudWork as w,plural as d}from"./cloud.js";import{dir as j}from"../fields.js";const p=o=>Math.round(o*1e6)/1e6;export const voice=$({name:"voice",summary:"Make the voice files a project's say(text) parts need, with their cloud voice tool, one per say that has none (assets/media/gen/say/<hash>, its words and its record)",input:t.strictObject({item:t.string().optional().describe("Only this item's says: its id, a path into it, or a folder of items"),dir:j}),positional:["item"],output:t.looseObject({says:t.number(),made:t.array(t.looseObject({part:t.string(),file:t.string()})).optional(),credits:t.number().optional()}),examples:["allyhub voice","allyhub voice launch/film"]},async(o,r)=>{const a=await b(r.cwd,o.dir),s=await h(a,o.item===void 0?{}:{piece:o.item});if(o.item!==void 0&&s.pieces.length===0)throw new g("no-item",`No video ${o.item} in the project.`,{exit:y.notFound});const l=s.says.filter(n=>n.file===void 0),f=`Every say has its file (${d(s.says.length,"say")}). Nothing to make.`;return await w(async()=>{const n=v(r),i=[];for(const e of l){r.progress(`${e.piece} · ${e.part}: ${e.tool}…`);const c=await u(n,a,e,{base:a,signal:r.signal});i.push({piece:e.piece,part:e.part,...c})}const m=p(i.reduce((e,c)=>e+c.credits,0));return{value:{says:s.says.length,made:i,kept:s.says.length-l.length,credits:m},text:i.length===0?f:[`Made ${d(i.length,"file")}:`,...i.map(e=>`  ${e.file} (${e.piece} · ${e.part}, ${String(p(e.seconds))} s)`),`Credits used: ${String(m)}.`].join(`
 `)}})});

package/dist/commands/words-text.js

@@ -1,5 +1,5 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{PARAGRAPH_GAP as u,ROOM_MATCH as S,packTranscript as b}from"@allyhub-next/video-core";export const CONFIDENCE_MEANS="the lowest probability Parakeet gave any of the word's letter tokens (greedy decoding), 0 to 1";const o=e=>e.toFixed(2),h=e=>e>=0?`+${e.toFixed(1)}`:`−${(-e).toFixed(1)}`,p=(e,d)=>`${String(e)} ${d}${e===1?"":"s"}`,l=e=>`#${String(e.from)}-#${String(e.to)} [${o(e.start)}-${o(e.end)}] ${e.text}`;export function hearingText(e,d){const s=i=>`    ${i.i===void 0?"":`#${String(i.i).padEnd(4)} `}${o(i.start)}-${o(i.end)}  ${i.confidence===null?"    —":i.confidence.toFixed(3)}  ${i.text}${i.padding?"  (padding)":""}`,a=i=>i?`"${i}"`:"nothing",t=i=>{const c=i.findIndex(f=>!f.padding);if(c<0)return[...i];let g=c;return i.forEach((f,w)=>{f.padding||(g=w)}),i.slice(Math.max(0,c-1),g+2)},{from:$,to:n}=e.asked,r=[`${d} from ${o($)} to ${o(n)} s, heard again ${p(e.hearings.length,"time")} (${e.model}; the recognizer's times; nothing written). Confidence: ${e.confidence.means??"none given"}.`,...e.hearings.map(i=>`  ${String(i.pad)} s of padding (${o(i.heard.from)}-${o(i.heard.to)}): ${a(i.text)}`),e.wordsFile?`  the words file: ${a(e.wordsFile.text)}`:"  no words file to compare with"];for(const i of e.hearings)r.push(`Heard with ${String(i.pad)} s of padding${i.words.length?":":": no words."}`,...t(i.words).map(s));return e.wordsFile&&r.push(`${e.wordsFile.path} there${e.wordsFile.words.length?":":": no words."}`,...t(e.wordsFile.words).map(s)),r.join(`
+import{PARAGRAPH_GAP as u,ROOM_MATCH as S,packTranscript as b}from"@allyhub/video-core";export const CONFIDENCE_MEANS="the lowest probability Parakeet gave any of the word's letter tokens (greedy decoding), 0 to 1";const o=e=>e.toFixed(2),h=e=>e>=0?`+${e.toFixed(1)}`:`−${(-e).toFixed(1)}`,p=(e,d)=>`${String(e)} ${d}${e===1?"":"s"}`,l=e=>`#${String(e.from)}-#${String(e.to)} [${o(e.start)}-${o(e.end)}] ${e.text}`;export function hearingText(e,d){const s=i=>`    ${i.i===void 0?"":`#${String(i.i).padEnd(4)} `}${o(i.start)}-${o(i.end)}  ${i.confidence===null?"    —":i.confidence.toFixed(3)}  ${i.text}${i.padding?"  (padding)":""}`,a=i=>i?`"${i}"`:"nothing",t=i=>{const c=i.findIndex(f=>!f.padding);if(c<0)return[...i];let g=c;return i.forEach((f,w)=>{f.padding||(g=w)}),i.slice(Math.max(0,c-1),g+2)},{from:$,to:n}=e.asked,r=[`${d} from ${o($)} to ${o(n)} s, heard again ${p(e.hearings.length,"time")} (${e.model}; the recognizer's times; nothing written). Confidence: ${e.confidence.means??"none given"}.`,...e.hearings.map(i=>`  ${String(i.pad)} s of padding (${o(i.heard.from)}-${o(i.heard.to)}): ${a(i.text)}`),e.wordsFile?`  the words file: ${a(e.wordsFile.text)}`:"  no words file to compare with"];for(const i of e.hearings)r.push(`Heard with ${String(i.pad)} s of padding${i.words.length?":":": no words."}`,...t(i.words).map(s));return e.wordsFile&&r.push(`${e.wordsFile.path} there${e.wordsFile.words.length?":":": no words."}`,...t(e.wordsFile.words).map(s)),r.join(`
 `)}function m(e,d){const s=d[e.i],a=e.expected===null||e.ratio===null||e.excess===null?"no expected length":`expected ${o(e.expected)} s (×${e.ratio.toFixed(1)})`,t=e.voicedRuns.length?`voiced ${e.voicedRuns.map(n=>`${o(n.start)}–${o(n.end)}`).join(", ")}`:"no voiced stretch",$=e.dips.length?`; dips ${e.dips.map(n=>`${o(n.start)}–${o(n.end)} −${String(n.depth)} dB`).join(", ")}`:"";return`  #${String(e.i)} "${s?.text??""}" [${o(s?.start??0)}-${o(s?.end??0)}] ${o(e.dur)} s, ${a}; ${t}${$}`}export function transcriptText(e,d){const s=[];if(e.made&&s.push(`Heard ${p(e.count,"word")} with ${e.made.model??"the recognizer"}${e.made.tightened?`, ${String(e.made.tightened)} tightened to the sound`:""}; wrote ${e.wordsFile}.`),e.matches){for(const n of e.matches)s.push(`"${n.phrase}" is said ${p(n.at.length,"time")}${n.at.length?":":"."}`,...n.at.map(r=>`  ${l(r)}`));return s.join(`
 `)}const a=e.levels,t=e.soundOptions;s.push(`${d.file}: ${p(e.count,"word")}, ${o(e.duration)} s; `+(a?`speech ${h(a.words??a.speech)} dBFS, floor ${h(a.floor)} dBFS; ${p(e.sounds.length,"sound")} between words${t?` (at most ${String(t.within)} dB under the speech, ${String(t.aboveFloor)} dB over the floor, ${o(t.shortest)} s long; a frame voiced from ${String(t.voiced)}${d.all?"":"; --all lists every stretch"})`:""}`:"levels unknown (its sound could not be read)")+".",`#i is a word index; a new line at each pause of ${String(u)} s or more; (sound start–end length peak-vs-speech voicing) a stretch of the file${e.rate?"; (long length ×ratio) a word that lasts that many times what its letters take":""}${e.script?"; {…} in no script line":""}.`,"",...b(d.words,{from:e.range.from,to:e.range.to,sounds:e.sounds,long:new Map(d.shapes.filter(n=>e.long.includes(n.i)).map(n=>[n.i,n])),...e.script?{unscripted:new Set(e.script.unscripted.flatMap(n=>Array.from({length:n.to-n.from+1},(r,i)=>n.from+i)))}:{}}));const $=d.shapes.filter(n=>e.long.includes(n.i));if(d.frames&&s.push("",e.rate?`Long words (${String($.length)}): at least ×${String(e.longOptions.ratio)} and ${o(e.longOptions.excess)} s over ${e.rate.base.toFixed(3)} s + ${e.rate.perLetter.toFixed(3)} s a letter; a dip is ${String(e.longOptions.dip)} dB under each side; long is not a filler${d.all?"":" (--all lists every word's inside)"}${$.length?":":"."}`:`Words are not compared with a speaking rate: ${e.rateWhy??"none"}.`,...$.map(n=>m(n,d.words)),...d.all?["Every word's inside:",...d.shapes.map(n=>m(n,d.words))]:[]),e.stretches&&e.levels&&s.push("",`Every stretch between words above the noise floor (${String(e.stretches.length)}):`,...e.stretches.map(n=>`  after #${String(n.after)} ${o(n.start)}–${o(n.end)} peak ${h(n.peak)} mean ${h(n.mean)} dB vs speech, ${h(n.aboveFloor)} dB over the floor, v${n.voiced.toFixed(2)}  ${n.passes?"reported":"left out"}`)),e.script){const n=e.script;s.push("",n.unscripted.length?`Words with less than ${String(n.options.match)} of their letters in a script line (${String(n.unscripted.length)}):`:"Every word matches the script.",...n.unscripted.map(r=>`  ${l(r)}`)),n.repeated.length&&s.push(`Script lines said more than once (where ${String(n.options.lineMatch)} of a line's letters match):`,...n.repeated.map(r=>`  "${r.text}": ${r.matches.map(l).join("; ")}`)),d.all&&s.push("Every script line, the share of its letters matched, and where it is said:",...n.lines.map(r=>`  ${String(r.line).padStart(3)}. ${r.share.toFixed(2)} "${r.text}": ${r.matches.length?r.matches.map(l).join("; "):"nowhere"}`))}return s.join(`
 `)}export function cutText(e,d){const s=[`The edits file on words #${String(e.from)}-#${String(e.to)}: ${o(e.seconds.before)} s → ${o(e.seconds.after)} s (${o(e.seconds.removed)} s removed), ${String(e.kept.length)} kept stretch${e.kept.length===1?"":"es"}. Padding ${o(e.pad.before)} s before each cut and ${o(e.pad.after)} s after (${e.padGiven?"the edits file's":"the defaults"}).`,"Kept:",...e.kept.map(t=>`  ${o(t.from)}-${o(t.to)} (${o(t.to-t.from)} s)`)];e.removed.length&&s.push("Words removed:",...e.removed.map(t=>`  ${l(t)}`)),e.sounds.length&&s.push("Sounds removed:",...e.sounds.map(t=>`  ${o(t.from)}-${o(t.to)}`)),e.soundsUnused.length&&s.push("Sounds listed but not between two kept words here (nothing cut):",...e.soundsUnused.map(t=>`  ${o(t.from)}-${o(t.to)}`)),e.inWord.length&&s.push("Cut inside kept words, as placed:",...e.inWord.map(t=>`  ${o(t.from)}-${o(t.to)}${t.words.length?` in ${t.words.map($=>`#${String($)} "${d[$]?.text??""}"`).join(", ")}`:" (between words)"}`)),e.inWordUnplaced.length&&s.push("inWord stretches that cut nothing here:",...e.inWordUnplaced.map(t=>`  ${o(t.from)}-${o(t.to)}`)),e.pauses.length&&s.push(`Pauses shortened: ${e.pauses.map(t=>`after #${String(t.after)} (${o(t.was)} s)`).join(", ")}.`),e.lost.length&&s.push("Ranges the take no longer says (AK-T005):",...e.lost.map(t=>`  ${String(t.from)}-${String(t.to)} ${t.text??""}`));const a=e.roomTone;if(a){const t=n=>n===null?"not measured":`${h(n)} dBFS`,$=(n,r)=>`  ${n} #${String(r.word)}: ${o(r.pad)} s of its own room, floor ${t(r.floor)}; a fill beside it plays at ${h(r.gainDb)} dB${r.from==="unmeasured"?" (as recorded: too little room to measure)":r.limited?` (held at ${String(S.limitDb)} dB)`:""}`;s.push(`Room tone: ${o(a.from)}-${o(a.to)} of the file, floor ${t(a.level)}:`,$("before",a.lead),$("after",a.tail))}return e.joins.length&&s.push(...F(e)),s.join(`

package/dist/commands/words.js

@@ -1,2 +1,2 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{readFile as k}from"node:fs/promises";import{relative as Y,resolve as q}from"node:path";import{z as f}from"zod";import{parameters as V}from"../parameters.js";import{parse as X}from"yaml";import{makeWords as B,takeVoice as x}from"@allyhub-next/build";import{cloudHearing as L}from"../cloud-hearing.js";import{readDataFile as K,wordsFileFor as A}from"@allyhub-next/formats";import{HEAR_PADS as Q,hearAgain as Z,requireLanguage as ee}from"@allyhub-next/media";import{EXIT as F}from"@allyhub-next/protocol";import{LONG_WORD_DEFAULTS as se,PARAGRAPH_GAP as re,WORD_SHAPE_DEFAULTS as te,cutReport as oe,longWords as ne,paragraphs as ae,parseEditList as ie,parseScript as de,saidOf as le,scriptDiff as fe,searchWords as ce,takeLevels as he,unheardSounds as we,wordLevels as me,wordShapes as ue}from"@allyhub-next/video-core";import{CommandError as p,defineCommand as M}from"../command.js";import{existingFile as $,fromMedia as pe,media as N,progressLines as P}from"../media.js";import{projectOfFile as R}from"../project.js";import{fresh as ge}from"../fields.js";const D=f.string().optional().describe("The project whose media index keeps the recording's sound (default the nearest above the file, else the current folder's)");import{CONFIDENCE_MEANS as _,cutText as be,hearingText as ye,transcriptText as ve}from"./words-text.js";const H=f.number().nonnegative(),Fe={fps:f.number().positive().default(30).describe("The frame grid cuts are placed on")},I=f.string().describe("The recording: an audio or video file"),$e=f.strictObject({file:I,lang:f.string().optional().describe("The language spoken (en, es, fr, de…); left out, the model tells. On this computer, one of Parakeet's 25 European languages"),fresh:ge.describe("Hear the whole file again and write its words file; with --from and --to, only that stretch, writing nothing"),from:H.optional().describe("Show the words of the file from this second on"),to:H.optional().describe("Show the words of the file up to this second"),search:f.array(f.string()).optional().describe("Where these words or phrases are said (case and punctuation ignored; a phrase's last word may be a prefix), instead of the transcript"),script:f.string().optional().describe("A script to compare with: a script.<locale>.yaml (what its parts say) or a text file; marks words it does not have, {like this}, and lines said more than once"),all:f.boolean().default(!1).describe("Also list what the thresholds leave out: every stretch between words above the noise floor, every word's inside, and every script line"),dir:D}),C=(e,s)=>new p("usage",e,{exit:F.usage,...s===void 0?{}:{hint:s}});function ke(e,s,t){const n=e.flatMap((c,a)=>(s===void 0||c.end>s)&&(t===void 0||c.start<t)?[a]:[]),r=n[0],o=n.at(-1);if(r===void 0||o===void 0)throw new p("no-words",`No word is said between ${(s??0).toFixed(2)} s and ${t===void 0?"the end":`${t.toFixed(2)} s`} of the file.`,{exit:F.notFound});return{from:r,to:o}}const g=(e,s)=>{const t=Y(e,s);return t===""||t.startsWith("..")?s:t};async function O(e){const s=await k(e,"utf8").catch(()=>{});if(s===void 0)return;let t;try{t=JSON.parse(s)}catch(r){return`not JSON: ${r.message}`}const n=K("words",t);return n.ok?n.value.words.map(({confidence:r,...o})=>r===void 0?o:{...o,confidence:r}):n.problems.map(r=>r.path?`${r.path}: ${r.message}`:r.message).join("; ")}async function Ae(e,s){const t=await $(e,s);let n;try{n=JSON.parse(await k(t,"utf8"))}catch(o){throw new p("bad-edits",`${s} is not JSON: ${o.message}`)}const r=ie(n);if(typeof r=="string")throw new p("bad-edits",`${s}: ${r}.`);return r}async function Oe(e,s){const t=await k(await $(e,s),"utf8"),n=c=>c.split(/(?<=[.!?。！？])\s+|\n+/u).map(a=>a.trim()).filter(a=>a!=="");if(!/\.ya?ml$/iu.test(s))return n(t);let r;try{r=X(t)}catch(c){throw new p("bad-script",`${s} is not YAML: ${c.message}`)}const o=de(r);if("problems"in o)throw new p("bad-script",`${s}: ${o.problems[0]??""}`);return o.script.parts.flatMap(c=>{if(c.say===void 0)return[];const a=le(c.say).value;return n(typeof a=="string"?a:"speak"in a?a.speak:Object.values(a.match).join(" "))})}async function je(e,s,t,n,r){const o=await N(()=>Z(s,{from:n,to:r},Q,{cloud:L(t,t.cwd),...e.lang===void 0?{}:{lang:e.lang},onProgress:P(t),signal:t.signal})),c=Math.min(...o.hearings.map(i=>i.heard.from)),a=Math.max(...o.hearings.map(i=>i.heard.to)),l=A(s),h=await O(l),w=Array.isArray(h)?h.map((i,m)=>({i:m,w:i})).filter(({w:i})=>i.end>c&&i.start<a).map(({i,w:m})=>({i,text:m.text,start:m.start,end:m.end,confidence:m.confidence??null,padding:m.end<=n||m.start>=r})):void 0,b={file:s,asked:{from:n,to:r},model:o.model,confidence:o.confidence?{means:_}:{means:null,missing:"The recognizer gave no token probabilities."},hearings:o.hearings,wordsFile:w?{path:l,words:w,text:w.filter(i=>!i.padding).map(i=>i.text).join(" ")}:null};return{value:b,text:ye(b,g(t.cwd,s))}}export const words=M({name:"words",summary:"A recording's words: heard on this computer when it has none (or --fresh), printed by word index with the sounds between them; a stretch by seconds, heard again with --fresh",input:$e,positional:["file"],output:f.looseObject({file:f.string(),wordsFile:f.unknown()}),examples:["allyhub words talk/host.mp4","allyhub words host.mp4 --from 23 --to 25","allyhub words host.mp4 --from 23 --to 25 --fresh",'allyhub words host.mp4 --search "you know,um"']},async(e,s)=>{const t=await $(s.cwd,e.file);try{ee(e.lang)}catch(d){throw pe(d)}const n=e.from!==void 0||e.to!==void 0;if(e.from!==void 0&&e.to!==void 0&&e.to<=e.from)throw C("--to is a second after --from.");if(n&&e.fresh){if(e.from===void 0||e.to===void 0)throw C("A stretch to hear again needs --from and --to, seconds of the file.",`allyhub words ${e.file} --from 23 --to 25 --fresh`);return je(e,t,s,e.from,e.to)}const r=await R(e.file,s.cwd,e.dir);r.warning!==void 0&&s.progress(r.warning);const o=A(t);let c,a=e.fresh?void 0:await O(o);if(typeof a=="string")throw new p("bad-words",`${g(s.cwd,o)} is not a words file: ${a}.`,{hint:"Fix it, or pass --fresh to hear the recording again."});if(a===void 0){const d=await N(()=>B(t,{root:r.root,cloud:L(s,r.root),...e.lang===void 0?{}:{lang:e.lang},onProgress:P(s),signal:s.signal}));a=d.file.words.map(({confidence:y,...u})=>y===void 0?u:{...u,confidence:y}),c={tightened:d.tightened,model:d.file.model}}const l=a,h=await x(t,r.root,{signal:s.signal}),{from:w,to:b}=n?ke(l,e.from,e.to):{from:0,to:Math.max(0,l.length-1)},i=h&&l.length>0?we(l,h,{all:e.all}):void 0,m=d=>d.after>=w-1&&d.after<=b,J=h?me(l,h):void 0,v=h?ue(l,h):void 0,j=(v?.words??[]).filter(d=>d.i>=w&&d.i<=b),z=ne(j),S=e.script===void 0?void 0:await Oe(s.cwd,e.script),E=S?fe(l,S):void 0,W=l.filter(d=>d.confidence===void 0).length,G=g(s.cwd,o),T={file:t,wordsFile:G,project:r.root,...c?{made:c}:{},count:l.length,duration:h?Math.round(h.db.length*h.hop*100)/100:l.at(-1)?.end??0,levels:h?{...he(h),...i?{words:i.speech,soundFloor:i.floor}:{}}:null,...i?{soundOptions:i.options}:{},range:{from:w,to:b},words:l.slice(w,b+1).map((d,y)=>{const u=v?.words[w+y];return{i:w+y,text:d.text,start:d.start,end:d.end,confidence:d.confidence??null,...J?.[w+y]??{},...u?{letters:u.letters,expected:u.expected,ratio:u.ratio,excess:u.excess,voicedRuns:u.voicedRuns,dips:u.dips}:{}}}),rate:v?.rate??null,...v?.rateWhy===void 0?{}:{rateWhy:v.rateWhy},long:z.map(d=>d.i),longOptions:{...se,dip:te.dip},confidence:{means:W<l.length||l.length===0?_:null,missing:W},paragraphs:ae(l,re,w,b),sounds:i?.sounds.filter(m)??[],...e.all&&i?.stretches?{stretches:i.stretches.filter(m)}:{},...e.search?{matches:e.search.map(d=>({phrase:d,at:ce(l,d)}))}:{},...E?{script:E}:{}},U=ve(T,{file:g(s.cwd,t),words:l,frames:h!==void 0,shapes:j,all:e.all});return{value:T,text:U}});const Se=f.strictObject({file:I,edits:f.string().describe("The edits file: the cut list (words, sounds, stretches inside words, pauses) to report on"),dir:D,params:V(Fe)});export const wordsEdits=M({name:"words edits",summary:"What a cut list keeps of a recording: the stretches kept, every word and sound removed, the room tone at its ends, and every join measured on both sides",input:Se,positional:["file","edits"],output:f.looseObject({file:f.string(),wordsFile:f.string(),cut:f.unknown()}),examples:["allyhub words edits talk/host.mp4 talk/edits/host.json","allyhub words edits host.mp4 edits.json --param fps=25"]},async(e,s)=>{const t=await $(s.cwd,e.file),n=await R(e.file,s.cwd,e.dir);n.warning!==void 0&&s.progress(n.warning);const r=A(t),o=await O(r);if(o===void 0)throw new p("no-words",`${g(s.cwd,t)} has no words file yet.`,{exit:F.notFound,hint:`allyhub words ${e.file} hears its words and writes ${g(s.cwd,r)}.`});if(typeof o=="string")throw new p("bad-words",`${g(s.cwd,r)} is not a words file: ${o}.`,{hint:"Fix it, or hear the recording again: allyhub words --fresh."});if(o.length===0)throw new p("no-words",`${g(s.cwd,r)} has no words: there is nothing to cut.`,{exit:F.notFound});const c=await Ae(s.cwd,e.edits),a=await x(t,n.root,{signal:s.signal}),l=oe(o,c,a,{fps:e.params.fps,...a?{duration:a.db.length*a.hop}:{}});return{value:{file:t,wordsFile:g(s.cwd,r),edits:g(s.cwd,q(s.cwd,e.edits)),project:n.root,count:o.length,cut:l},text:be(l,o)}});
+import{readFile as k}from"node:fs/promises";import{relative as Y,resolve as q}from"node:path";import{z as f}from"zod";import{parameters as V}from"../parameters.js";import{parse as X}from"yaml";import{makeWords as B,takeVoice as x}from"@allyhub/build";import{cloudHearing as L}from"../cloud-hearing.js";import{readDataFile as K,wordsFileFor as A}from"@allyhub/formats";import{HEAR_PADS as Q,hearAgain as Z,requireLanguage as ee}from"@allyhub/media";import{EXIT as F}from"@allyhub/protocol";import{LONG_WORD_DEFAULTS as se,PARAGRAPH_GAP as re,WORD_SHAPE_DEFAULTS as te,cutReport as oe,longWords as ne,paragraphs as ae,parseEditList as ie,parseScript as de,saidOf as le,scriptDiff as fe,searchWords as ce,takeLevels as he,unheardSounds as we,wordLevels as me,wordShapes as ue}from"@allyhub/video-core";import{CommandError as p,defineCommand as M}from"../command.js";import{existingFile as $,fromMedia as pe,media as N,progressLines as P}from"../media.js";import{projectOfFile as R}from"../project.js";import{fresh as ge}from"../fields.js";const D=f.string().optional().describe("The project whose media index keeps the recording's sound (default the nearest above the file, else the current folder's)");import{CONFIDENCE_MEANS as _,cutText as be,hearingText as ye,transcriptText as ve}from"./words-text.js";const H=f.number().nonnegative(),Fe={fps:f.number().positive().default(30).describe("The frame grid cuts are placed on")},I=f.string().describe("The recording: an audio or video file"),$e=f.strictObject({file:I,lang:f.string().optional().describe("The language spoken (en, es, fr, de…); left out, the model tells. On this computer, one of Parakeet's 25 European languages"),fresh:ge.describe("Hear the whole file again and write its words file; with --from and --to, only that stretch, writing nothing"),from:H.optional().describe("Show the words of the file from this second on"),to:H.optional().describe("Show the words of the file up to this second"),search:f.array(f.string()).optional().describe("Where these words or phrases are said (case and punctuation ignored; a phrase's last word may be a prefix), instead of the transcript"),script:f.string().optional().describe("A script to compare with: a script.<locale>.yaml (what its parts say) or a text file; marks words it does not have, {like this}, and lines said more than once"),all:f.boolean().default(!1).describe("Also list what the thresholds leave out: every stretch between words above the noise floor, every word's inside, and every script line"),dir:D}),C=(e,s)=>new p("usage",e,{exit:F.usage,...s===void 0?{}:{hint:s}});function ke(e,s,t){const n=e.flatMap((c,a)=>(s===void 0||c.end>s)&&(t===void 0||c.start<t)?[a]:[]),r=n[0],o=n.at(-1);if(r===void 0||o===void 0)throw new p("no-words",`No word is said between ${(s??0).toFixed(2)} s and ${t===void 0?"the end":`${t.toFixed(2)} s`} of the file.`,{exit:F.notFound});return{from:r,to:o}}const g=(e,s)=>{const t=Y(e,s);return t===""||t.startsWith("..")?s:t};async function O(e){const s=await k(e,"utf8").catch(()=>{});if(s===void 0)return;let t;try{t=JSON.parse(s)}catch(r){return`not JSON: ${r.message}`}const n=K("words",t);return n.ok?n.value.words.map(({confidence:r,...o})=>r===void 0?o:{...o,confidence:r}):n.problems.map(r=>r.path?`${r.path}: ${r.message}`:r.message).join("; ")}async function Ae(e,s){const t=await $(e,s);let n;try{n=JSON.parse(await k(t,"utf8"))}catch(o){throw new p("bad-edits",`${s} is not JSON: ${o.message}`)}const r=ie(n);if(typeof r=="string")throw new p("bad-edits",`${s}: ${r}.`);return r}async function Oe(e,s){const t=await k(await $(e,s),"utf8"),n=c=>c.split(/(?<=[.!?。！？])\s+|\n+/u).map(a=>a.trim()).filter(a=>a!=="");if(!/\.ya?ml$/iu.test(s))return n(t);let r;try{r=X(t)}catch(c){throw new p("bad-script",`${s} is not YAML: ${c.message}`)}const o=de(r);if("problems"in o)throw new p("bad-script",`${s}: ${o.problems[0]??""}`);return o.script.parts.flatMap(c=>{if(c.say===void 0)return[];const a=le(c.say).value;return n(typeof a=="string"?a:"speak"in a?a.speak:Object.values(a.match).join(" "))})}async function je(e,s,t,n,r){const o=await N(()=>Z(s,{from:n,to:r},Q,{cloud:L(t,t.cwd),...e.lang===void 0?{}:{lang:e.lang},onProgress:P(t),signal:t.signal})),c=Math.min(...o.hearings.map(i=>i.heard.from)),a=Math.max(...o.hearings.map(i=>i.heard.to)),l=A(s),h=await O(l),w=Array.isArray(h)?h.map((i,m)=>({i:m,w:i})).filter(({w:i})=>i.end>c&&i.start<a).map(({i,w:m})=>({i,text:m.text,start:m.start,end:m.end,confidence:m.confidence??null,padding:m.end<=n||m.start>=r})):void 0,b={file:s,asked:{from:n,to:r},model:o.model,confidence:o.confidence?{means:_}:{means:null,missing:"The recognizer gave no token probabilities."},hearings:o.hearings,wordsFile:w?{path:l,words:w,text:w.filter(i=>!i.padding).map(i=>i.text).join(" ")}:null};return{value:b,text:ye(b,g(t.cwd,s))}}export const words=M({name:"words",summary:"A recording's words: heard on this computer when it has none (or --fresh), printed by word index with the sounds between them; a stretch by seconds, heard again with --fresh",input:$e,positional:["file"],output:f.looseObject({file:f.string(),wordsFile:f.unknown()}),examples:["allyhub words talk/host.mp4","allyhub words host.mp4 --from 23 --to 25","allyhub words host.mp4 --from 23 --to 25 --fresh",'allyhub words host.mp4 --search "you know,um"']},async(e,s)=>{const t=await $(s.cwd,e.file);try{ee(e.lang)}catch(d){throw pe(d)}const n=e.from!==void 0||e.to!==void 0;if(e.from!==void 0&&e.to!==void 0&&e.to<=e.from)throw C("--to is a second after --from.");if(n&&e.fresh){if(e.from===void 0||e.to===void 0)throw C("A stretch to hear again needs --from and --to, seconds of the file.",`allyhub words ${e.file} --from 23 --to 25 --fresh`);return je(e,t,s,e.from,e.to)}const r=await R(e.file,s.cwd,e.dir);r.warning!==void 0&&s.progress(r.warning);const o=A(t);let c,a=e.fresh?void 0:await O(o);if(typeof a=="string")throw new p("bad-words",`${g(s.cwd,o)} is not a words file: ${a}.`,{hint:"Fix it, or pass --fresh to hear the recording again."});if(a===void 0){const d=await N(()=>B(t,{root:r.root,cloud:L(s,r.root),...e.lang===void 0?{}:{lang:e.lang},onProgress:P(s),signal:s.signal}));a=d.file.words.map(({confidence:y,...u})=>y===void 0?u:{...u,confidence:y}),c={tightened:d.tightened,model:d.file.model}}const l=a,h=await x(t,r.root,{signal:s.signal}),{from:w,to:b}=n?ke(l,e.from,e.to):{from:0,to:Math.max(0,l.length-1)},i=h&&l.length>0?we(l,h,{all:e.all}):void 0,m=d=>d.after>=w-1&&d.after<=b,J=h?me(l,h):void 0,v=h?ue(l,h):void 0,j=(v?.words??[]).filter(d=>d.i>=w&&d.i<=b),z=ne(j),S=e.script===void 0?void 0:await Oe(s.cwd,e.script),E=S?fe(l,S):void 0,W=l.filter(d=>d.confidence===void 0).length,G=g(s.cwd,o),T={file:t,wordsFile:G,project:r.root,...c?{made:c}:{},count:l.length,duration:h?Math.round(h.db.length*h.hop*100)/100:l.at(-1)?.end??0,levels:h?{...he(h),...i?{words:i.speech,soundFloor:i.floor}:{}}:null,...i?{soundOptions:i.options}:{},range:{from:w,to:b},words:l.slice(w,b+1).map((d,y)=>{const u=v?.words[w+y];return{i:w+y,text:d.text,start:d.start,end:d.end,confidence:d.confidence??null,...J?.[w+y]??{},...u?{letters:u.letters,expected:u.expected,ratio:u.ratio,excess:u.excess,voicedRuns:u.voicedRuns,dips:u.dips}:{}}}),rate:v?.rate??null,...v?.rateWhy===void 0?{}:{rateWhy:v.rateWhy},long:z.map(d=>d.i),longOptions:{...se,dip:te.dip},confidence:{means:W<l.length||l.length===0?_:null,missing:W},paragraphs:ae(l,re,w,b),sounds:i?.sounds.filter(m)??[],...e.all&&i?.stretches?{stretches:i.stretches.filter(m)}:{},...e.search?{matches:e.search.map(d=>({phrase:d,at:ce(l,d)}))}:{},...E?{script:E}:{}},U=ve(T,{file:g(s.cwd,t),words:l,frames:h!==void 0,shapes:j,all:e.all});return{value:T,text:U}});const Se=f.strictObject({file:I,edits:f.string().describe("The edits file: the cut list (words, sounds, stretches inside words, pauses) to report on"),dir:D,params:V(Fe)});export const wordsEdits=M({name:"words edits",summary:"What a cut list keeps of a recording: the stretches kept, every word and sound removed, the room tone at its ends, and every join measured on both sides",input:Se,positional:["file","edits"],output:f.looseObject({file:f.string(),wordsFile:f.string(),cut:f.unknown()}),examples:["allyhub words edits talk/host.mp4 talk/edits/host.json","allyhub words edits host.mp4 edits.json --param fps=25"]},async(e,s)=>{const t=await $(s.cwd,e.file),n=await R(e.file,s.cwd,e.dir);n.warning!==void 0&&s.progress(n.warning);const r=A(t),o=await O(r);if(o===void 0)throw new p("no-words",`${g(s.cwd,t)} has no words file yet.`,{exit:F.notFound,hint:`allyhub words ${e.file} hears its words and writes ${g(s.cwd,r)}.`});if(typeof o=="string")throw new p("bad-words",`${g(s.cwd,r)} is not a words file: ${o}.`,{hint:"Fix it, or hear the recording again: allyhub words --fresh."});if(o.length===0)throw new p("no-words",`${g(s.cwd,r)} has no words: there is nothing to cut.`,{exit:F.notFound});const c=await Ae(s.cwd,e.edits),a=await x(t,n.root,{signal:s.signal}),l=oe(o,c,a,{fps:e.params.fps,...a?{duration:a.db.length*a.hop}:{}});return{value:{file:t,wordsFile:g(s.cwd,r),edits:g(s.cwd,q(s.cwd,e.edits)),project:n.root,count:o.length,cut:l},text:be(l,o)}});

package/dist/help.js

@@ -1,5 +1,6 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{join as j}from"node:path";import{z as y}from"zod";import{optionName as $,paramsOf as O,shapeOf as u}from"./args.js";import{GLOBAL as E,isGlobal as w,isHidden as M}from"./fields.js";import{WORKS as k,cloudNouns as D,workTitle as S}from"./works.js";const g=e=>e.description??"";function b(e,p){const a=u(p);return a.kind==="boolean"&&!a.list?`--${$(e)}`:`--${$(e)} <${a.kind==="number"?"n":"value"}${a.list?",…":""}>`}function v(e){return e===void 0?["The SDK's docs: none here. This project declares the SDK and has not installed it: run npm install.",""]:[`The SDK's docs, for the version this project builds with (read the ones a piece needs before writing it; README.md lists them): ${e}`,""]}export function listHelp(e,p,a,h){const r=["allyhub: check, render, measure and look at a project's content.","",...v(h),"Works (allyhub help <work> lists a work's commands in the order it uses them):"],d=Math.max(...k.map(n=>n.name.length));for(const n of k)r.push(`  ${n.name.padEnd(d)}  ${S(n,a)}`);r.push("","Commands:");const i=[...e.map(n=>({noun:n.name.split(" ")[0]??"",name:n.name,summary:n.summary})),...p.flatMap(n=>n.entries.map(s=>({noun:"<made>",...s}))),...(a??[]).map(n=>({noun:"<nouns>",...n}))],l=Math.max(...i.map(n=>n.name.length));let o="";for(const n of i)o!==""&&n.noun!==o&&r.push(""),o=n.noun,r.push(`  ${n.name.padEnd(l)}  ${n.summary}`);r.push("","Global options (each command lists those it takes):");const t=Object.entries(E).map(([n,s])=>[b(n,s),s.description??""]);t.push(["--json","Print the result as JSON (any command)"]);const m=Math.max(...t.map(([n])=>n.length));for(const[n,s]of t)r.push(`  ${n.padEnd(m)}  ${s}`);return r.push("","Environment:","  ALLYHUB_GPU=0|1      Draw on the CPU (the same pixels on every computer) or the GPU; default the GPU on a Mac","  ALLYHUB_NO_INDEX=1   Do not make face tracks and person mattes first: those layers are drawn their fallback way","","allyhub help <command> says what one does and every option it takes."),r.join(`
-`)}export function workHelp(e,p,a=[],h,r){const d=Math.max(...e.commands.map(l=>l.length)),i=[`${e.title}: the commands, in the order the work uses them.`,""];if(e.cloud!==void 0){const l=r===void 0?[]:D(e,r);if(r===void 0)i.push("The cloud catalog could not be read: its works are not listed.");else if(l.length===0)i.push("The cloud catalog has no tools for this work yet.");else{const o=Math.max(...l.map(t=>t.name.length));i.push("The cloud catalog's works for it (allyhub <work> lists one's tools):");for(const t of l)i.push(`  ${t.name.padEnd(o)}  ${t.summary}`)}i.push("")}e.docs!==void 0&&e.docs.length>0&&i.push(h===void 0?`How it is written: the SDK's ${e.docs.join(", ")} (no SDK docs for this project: it declares the SDK and has not installed it; run npm install).`:`How it is written, read before writing it: ${e.docs.map(l=>j(h,l)).join(", ")}`,"");for(const l of e.commands){const o=p.find(t=>t.name===l)??a.flatMap(t=>t.entries).find(t=>t.name===l);i.push(`  ${l.padEnd(d)}  ${o?.summary??""}`)}return i.push("","allyhub help <command> says what one does and every option it takes."),i.join(`
-`)}export function commandHelp(e,p=[]){const a=e.input.shape,h=[...e.positional??[]],r=h.map(t=>{const m=u(a[t]??y.string()),n=a[t]?.safeParse(void 0).success??!1,s=`<${t}>${m.list?"…":""}`;return n?`[${s}]`:s}),d=O(a.params),i=Object.entries(a).filter(([t,m])=>!h.includes(t)&&!(d&&t==="params")&&!w(m)&&!M(m)),l=Object.entries(a).filter(([,t])=>w(t)).map(([t,m])=>b(t,m).split(" ")[0]??""),o=[`allyhub ${[e.name,...r,i.length>0?"[options]":""].filter(Boolean).join(" ")}`,"",e.summary];if(p.length>0&&o.push("",...p),h.length>0){o.push("","Arguments:");for(const t of h)o.push(`  <${t}>  ${g(a[t]??y.string())}`)}if(i.length>0){o.push("","Options:");const t=i.map(([n,s])=>{const c=u(s),f=b(n,s),x=c.fallback===void 0||c.fallback===!1?"":` (default ${JSON.stringify(c.fallback)})`;return[f,`${g(s)}${x}`]}),m=Math.max(...t.map(([n])=>n.length));for(const[n,s]of t)o.push(`  ${n.padEnd(m)}  ${s}`)}if(d){o.push("","Parameters (--param name=value):");const t=Object.entries(d).map(([n,s])=>{const c=u(s),f=c.fallback===void 0?"":` (default ${JSON.stringify(c.fallback)})`;return[$(n),`${g(s)}${f}`]}),m=Math.max(...t.map(([n])=>n.length));for(const[n,s]of t)o.push(`  ${n.padEnd(m)}  ${s}`)}if(l.length>0&&o.push("",`Global options: ${l.join(", ")} (allyhub help)`),e.examples&&e.examples.length>0){o.push("","Examples:");for(const t of e.examples)o.push(`  ${t}`)}return o.join(`
+import{join as j}from"node:path";import{z as y}from"zod";import{optionName as $,paramsOf as O,shapeOf as c}from"./args.js";import{GLOBAL as E,isGlobal as w,isHidden as M}from"./fields.js";import{WORKS as k,cloudNouns as D,workTitle as S}from"./works.js";const g=e=>e.description??"";function b(e,p){const a=c(p);return a.kind==="boolean"&&!a.list?`--${$(e)}`:`--${$(e)} <${a.kind==="number"?"n":"value"}${a.list?",…":""}>`}function v(e){return e===void 0?["The SDK's docs: none here. This project declares the SDK and has not installed it: run npm install.",""]:[`The SDK's docs, for the version this project builds with (read the ones a piece needs before writing it; README.md lists them): ${e}`,""]}export function listHelp(e,p,a,r){const m=["allyhub: check, render, measure and look at a project's content.","",...v(r),"Works (allyhub help <work> lists a work's commands in the order it uses them):"],d=Math.max(...k.map(n=>n.name.length));for(const n of k)m.push(`  ${n.name.padEnd(d)}  ${S(n,a)}`);m.push("","Commands:");const i=[...e.map(n=>({noun:n.name.split(" ")[0]??"",name:n.name,summary:n.summary})),...p.flatMap(n=>n.entries.map(o=>({noun:"<made>",...o}))),...(a??[]).map(n=>({noun:"<nouns>",...n}))],l=Math.max(...i.map(n=>n.name.length));let s="";for(const n of i)s!==""&&n.noun!==s&&m.push(""),s=n.noun,m.push(`  ${n.name.padEnd(l)}  ${n.summary}`);m.push("","Global options (each command lists those it takes):");const t=Object.entries(E).map(([n,o])=>[b(n,o),o.description??""]);t.push(["--json","Print the result as JSON (any command)"]);const h=Math.max(...t.map(([n])=>n.length));for(const[n,o]of t)m.push(`  ${n.padEnd(h)}  ${o}`);return m.push("","Environment:","  ALLYHUB_GPU=0|1      Draw on the CPU (the same pixels on every computer) or the GPU; default the GPU on a Mac","  ALLYHUB_NO_INDEX=1   Do not make face tracks and person mattes first: those layers are drawn their fallback way","","allyhub help <command> says what one does and every option it takes."),m.join(`
+`)}export function groupHelp(e,p){const a=Math.max(...p.map(r=>r.name.length));return[`allyhub ${e}:`,"",...p.map(r=>`  ${r.name.padEnd(a)}  ${r.summary}`),"","allyhub help <command> says what one does and every option it takes."].join(`
+`)}export function workHelp(e,p,a=[],r,m){const d=Math.max(...e.commands.map(l=>l.length)),i=[`${e.title}: the commands, in the order the work uses them.`,""];if(e.cloud!==void 0){const l=m===void 0?[]:D(e,m);if(m===void 0)i.push("The cloud catalog could not be read: its works are not listed.");else if(l.length===0)i.push("The cloud catalog has no tools for this work yet.");else{const s=Math.max(...l.map(t=>t.name.length));i.push("The cloud catalog's works for it (allyhub <work> lists one's tools):");for(const t of l)i.push(`  ${t.name.padEnd(s)}  ${t.summary}`)}i.push("")}e.docs!==void 0&&e.docs.length>0&&i.push(r===void 0?`How it is written: the SDK's ${e.docs.join(", ")} (no SDK docs for this project: it declares the SDK and has not installed it; run npm install).`:`How it is written, read before writing it: ${e.docs.map(l=>j(r,l)).join(", ")}`,"");for(const l of e.commands){const s=p.find(t=>t.name===l)??a.flatMap(t=>t.entries).find(t=>t.name===l);i.push(`  ${l.padEnd(d)}  ${s?.summary??""}`)}return i.push("","allyhub help <command> says what one does and every option it takes."),i.join(`
+`)}export function commandHelp(e,p=[]){const a=e.input.shape,r=[...e.positional??[]],m=r.map(t=>{const h=c(a[t]??y.string()),n=a[t]?.safeParse(void 0).success??!1,o=`<${t}>${h.list?"…":""}`;return n?`[${o}]`:o}),d=O(a.params),i=Object.entries(a).filter(([t,h])=>!r.includes(t)&&!(d&&t==="params")&&!w(h)&&!M(h)),l=Object.entries(a).filter(([,t])=>w(t)).map(([t,h])=>b(t,h).split(" ")[0]??""),s=[`allyhub ${[e.name,...m,i.length>0?"[options]":""].filter(Boolean).join(" ")}`,"",e.summary];if(p.length>0&&s.push("",...p),r.length>0){s.push("","Arguments:");for(const t of r)s.push(`  <${t}>  ${g(a[t]??y.string())}`)}if(i.length>0){s.push("","Options:");const t=i.map(([n,o])=>{const u=c(o),f=b(n,o),x=u.fallback===void 0||u.fallback===!1?"":` (default ${JSON.stringify(u.fallback)})`;return[f,`${g(o)}${x}`]}),h=Math.max(...t.map(([n])=>n.length));for(const[n,o]of t)s.push(`  ${n.padEnd(h)}  ${o}`)}if(d){s.push("","Parameters (--param name=value):");const t=Object.entries(d).map(([n,o])=>{const u=c(o),f=u.fallback===void 0?"":` (default ${JSON.stringify(u.fallback)})`;return[$(n),`${g(o)}${f}`]}),h=Math.max(...t.map(([n])=>n.length));for(const[n,o]of t)s.push(`  ${n.padEnd(h)}  ${o}`)}if(l.length>0&&s.push("",`Global options: ${l.join(", ")} (allyhub help)`),e.examples&&e.examples.length>0){s.push("","Examples:");for(const t of e.examples)s.push(`  ${t}`)}return s.join(`
 `)}

package/dist/lent/model-three.d.ts

@@ -1,2 +1,2 @@
-// The types of @allyhub-next/model/three, which allyhub's build lends a project by that name.
-export * from "../node_modules/@allyhub-next/model/dist/three.js";
+// The types of @allyhub/model/three, which allyhub's build lends a project by that name.
+export * from "../node_modules/@allyhub/model/dist/three.js";

package/dist/lent/model.d.ts

@@ -1,2 +1,2 @@
-// The types of @allyhub-next/model, which allyhub's build lends a project by that name.
-export * from "../node_modules/@allyhub-next/model/dist/index.js";
+// The types of @allyhub/model, which allyhub's build lends a project by that name.
+export * from "../node_modules/@allyhub/model/dist/index.js";

package/dist/lent/scenery-host-layer.d.ts

@@ -1,2 +1,2 @@
-// The types of @allyhub-next/scenery-host/layer, which allyhub's build lends a project by that name.
-export * from "../node_modules/@allyhub-next/scenery-host/dist/layer/index.js";
+// The types of @allyhub/scenery-host/layer, which allyhub's build lends a project by that name.
+export * from "../node_modules/@allyhub/scenery-host/dist/layer/index.js";

package/dist/main.js

@@ -1,8 +1,8 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{EXIT as m,describeCommand as M}from"@allyhub-next/protocol";import{readArgs as T}from"./args.js";import{CLI_VERSION as N}from"./cli-version.js";import{CommandError as w}from"./command.js";import{COMMAND_SOURCES as E,COMMANDS as C}from"./commands/index.js";import{commandHelp as j,listHelp as H,workHelp as R}from"./help.js";import{sdkDocs as W}from"./sdk-docs.js";import{WORKS as G,cloudNouns as J,workNamed as _,workTitle as A}from"./works.js";const K={stdout:e=>process.stdout.write(e),stderr:e=>process.stderr.write(e),cwd:process.cwd(),env:process.env};export function findCommand(e,s=C){let i;for(const c of s){const l=c.spec.name.split(" ");l.every((o,a)=>e[a]===o)&&l.length>(i?.length??0)&&(i={command:c,length:l.length})}return i?{command:i.command,rest:e.slice(i.length)}:{rest:[...e]}}export async function resolveCommand(e,s,i=C,c=E){const l=findCommand(e,i);if(l.command)return l;for(const o of c){const a=await o.resolve(e,s);if(a)return a}return l}const D=e=>({...M(e.spec),...e.about?.value});export async function main(e,s=K,i=C,c=E){const l=e.includes("--json"),o=e.filter(n=>n!=="--json"),a=(n,t)=>{s.stdout(l?`${JSON.stringify(n,null,2)}
+import{EXIT as u,describeCommand as N}from"@allyhub/protocol";import{readArgs as W}from"./args.js";import{CLI_VERSION as C}from"./cli-version.js";import{CommandError as w}from"./command.js";import{COMMAND_SOURCES as A,COMMANDS as I}from"./commands/index.js";import{commandHelp as D,groupHelp as R,listHelp as G,workHelp as J}from"./help.js";import{sdkDocs as _}from"./sdk-docs.js";import{WORKS as K,cloudNouns as L,workNamed as P,workTitle as H}from"./works.js";const U={stdout:r=>process.stdout.write(r),stderr:r=>process.stderr.write(r),cwd:process.cwd(),env:process.env};export function findCommand(r,c=I){let a;for(const l of c){const m=l.spec.name.split(" ");m.every((e,s)=>r[s]===e)&&m.length>(a?.length??0)&&(a={command:l,length:m.length})}return a?{command:a.command,rest:r.slice(a.length)}:{rest:[...r]}}export async function resolveCommand(r,c,a=I,l=A){const m=findCommand(r,a);if(m.command)return m;for(const e of l){const s=await e.resolve(r,c);if(s)return s}return m}const T=r=>({...N(r.spec),...r.about?.value});export async function main(r,c=U,a=I,l=A){const m=r.includes("--json"),e=r.filter(n=>n!=="--json"),s=(n,t)=>{c.stdout(m?`${JSON.stringify(n,null,2)}
 `:`${t}
-`)},b=i.map(n=>n.spec),x=new AbortController,y={cwd:s.cwd,env:s.env,progress:n=>{s.stderr(`${n}
-`)},signal:x.signal};if(o[0]==="--version"||o[0]==="-v")return a({version:N},N),m.ok;if(o.length===0||o[0]==="help"||o[0]==="--help"||o[0]==="-h"){const n=o.slice(1).findIndex(r=>r.startsWith("-")),t=n<0?o.slice(1):o.slice(1,n+1),f=await W(s.cwd).catch(()=>{}),p=async()=>{const r=await Promise.all(c.map(u=>u.nouns(y).catch(()=>{})));return r.some(u=>u===void 0)?void 0:r.flatMap(u=>u??[])};if(t.length===0){const r=await p();return a({version:N,docs:f?.dir,works:G.map(u=>({...u,title:A(u,r)})),commands:b.map(M),made:[...c.flatMap(u=>u.entries),...r??[]]},H(b,c,r,f?.dir)),m.ok}const d=t.length===1?_(t[0]??""):void 0;if(d){const r=d.cloud===void 0?[]:await p();return a({...d,title:A(d,r),...d.cloud===void 0?{}:{cloudWorks:r&&J(d,r)},docsDir:f?.dir},R(d,b,c,f?.dir,r)),m.ok}let S;try{S=await resolveCommand(t,y,i,c)}catch(r){return k(r)}const{command:h,rest:O}=S;return h&&S.list===!0?await $(h,O):!h||O.length>0?k(new w("unknown-command",`allyhub has no command "${t.join(" ")}".`,{exit:m.usage,hint:"allyhub help lists them and the works."})):(a(D(h),j(h.spec,h.about?.lines)),m.ok)}let I;try{I=await resolveCommand(o,y,i,c)}catch(n){return k(n)}const{command:g,rest:v}=I;if(!g)return k(new w("unknown-command",`allyhub has no command "${o[0]??""}".`,{exit:m.usage,hint:"allyhub help lists them."}));if(v.includes("--help")||v.includes("-h"))return a(D(g),j(g.spec,g.about?.lines)),m.ok;return await $(g,v);async function $(n,t){const f=()=>{x.abort(new w("interrupted","Stopped.",{exit:m.interrupted}))};process.once("SIGINT",f);try{const p=T(n.spec,t),d=await n.run(p,y);return a(d.value,d.text),d.exit??m.ok}catch(p){return k(p)}finally{process.off("SIGINT",f)}}function k(n){const t=n instanceof w?n:x.signal.aborted?new w("interrupted","Stopped.",{exit:m.interrupted}):new w("failed",n instanceof Error?n.message:String(n));return l?s.stdout(`${JSON.stringify({error:{code:t.code,message:t.message,...t.hint?{hint:t.hint}:{}}},null,2)}
-`):s.stderr(`${t.message}${t.hint?`
+`)},y=a.map(n=>n.spec),j=n=>y.filter(t=>n.length>0&&t.name.startsWith(`${n.join(" ")} `)),x=new AbortController,b={cwd:c.cwd,env:c.env,progress:n=>{c.stderr(`${n}
+`)},signal:x.signal};if(e[0]==="--version"||e[0]==="-v")return s({version:C},C),u.ok;if(e.length===0||e[0]==="help"||e[0]==="--help"||e[0]==="-h"){const n=e.slice(1).findIndex(o=>o.startsWith("-")),t=(n<0?e.slice(1):e.slice(1,n+1)).flatMap(o=>o.split(" ").filter(i=>i!=="")),p=await _(c.cwd).catch(()=>{}),h=async()=>{const o=await Promise.all(l.map(i=>i.nouns(b).catch(()=>{})));return o.some(i=>i===void 0)?void 0:o.flatMap(i=>i??[])};if(t.length===0){const o=await h();return s({version:C,docs:p?.dir,works:K.map(i=>({...i,title:H(i,o)})),commands:y.map(N),made:[...l.flatMap(i=>i.entries),...o??[]]},G(y,l,o,p?.dir)),u.ok}const d=t.length===1?P(t[0]??""):void 0;if(d){const o=d.cloud===void 0?[]:await h();return s({...d,title:H(d,o),...d.cloud===void 0?{}:{cloudWorks:o&&L(d,o)},docsDir:p?.dir},J(d,y,l,p?.dir,o)),u.ok}let S;try{S=await resolveCommand(t,b,a,l)}catch(o){return k(o)}const{command:f,rest:E}=S;if(f&&S.list===!0)return await M(f,E);const $=j(t);return!f&&$.length>0?(s({commands:$.map(N)},R(t.join(" "),$)),u.ok):!f||E.length>0?k(new w("unknown-command",`allyhub has no command "${t.join(" ")}".`,{exit:u.usage,hint:"allyhub help lists them and the works."})):(s(T(f),D(f.spec,f.about?.lines)),u.ok)}let O;try{O=await resolveCommand(e,b,a,l)}catch(n){return k(n)}const{command:g,rest:v}=O;if(!g){const n=j(e.slice(0,1));return k(new w("unknown-command",`allyhub has no command "${e.join(" ")}".`,{exit:u.usage,hint:n.length>0?`${e[0]??""} has these: ${n.map(t=>t.name).join(", ")}.`:"allyhub help lists them."}))}if(v.includes("--help")||v.includes("-h"))return s(T(g),D(g.spec,g.about?.lines)),u.ok;return await M(g,v);async function M(n,t){const p=()=>{x.abort(new w("interrupted","Stopped.",{exit:u.interrupted}))};process.once("SIGINT",p);try{const h=W(n.spec,t),d=await n.run(h,b);return s(d.value,d.text),d.exit??u.ok}catch(h){return k(h)}finally{process.off("SIGINT",p)}}function k(n){const t=n instanceof w?n:x.signal.aborted?new w("interrupted","Stopped.",{exit:u.interrupted}):new w("failed",n instanceof Error?n.message:String(n));return m?c.stdout(`${JSON.stringify({error:{code:t.code,message:t.message,...t.hint?{hint:t.hint}:{}}},null,2)}
+`):c.stderr(`${t.message}${t.hint?`
 ${t.hint}`:""}
 `),t.exit}}

package/dist/media.js

@@ -1,2 +1,2 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{stat as s}from"node:fs/promises";import{resolve as u}from"node:path";import{MediaError as d,formatBytes as a}from"@allyhub-next/media";import{EXIT as n}from"@allyhub-next/protocol";import{CommandError as f}from"./command.js";const l={not_found:n.notFound,no_audio:n.usage,no_video:n.usage,unsupported_language:n.usage,ffmpeg:n.platform,unsupported_platform:n.platform,install:n.platform,decode:n.platform,fetch:n.failed,cancelled:n.interrupted};export function fromMedia(e){return e instanceof d?new f(e.code.replaceAll("_","-"),e.message,{exit:l[e.code],...e.hint===void 0?{}:{hint:e.hint},cause:e}):e}export async function media(e){try{return await e()}catch(o){throw fromMedia(o)}}export function progressLines(e){let o="",i=-1;return t=>{if(t.done!==void 0&&t.done>0&&t.total!==void 0&&t.total>0){const r=Math.floor(t.done/t.total*10)*10;if(r===i)return;i=r,e.progress(`  ${String(r)}%${t.unit==="frames"?"":` (${a(t.done)} of ${a(t.total)})`}`);return}t.message!==o&&(o=t.message,e.progress(t.message))}}export async function existingFile(e,o){const i=u(e,o);if(!(await s(i).catch(()=>{}))?.isFile())throw new f("not-found",`There is no file ${i}.`,{exit:n.notFound});return i}
+import{stat as s}from"node:fs/promises";import{resolve as u}from"node:path";import{MediaError as d,formatBytes as a}from"@allyhub/media";import{EXIT as n}from"@allyhub/protocol";import{CommandError as f}from"./command.js";const l={not_found:n.notFound,no_audio:n.usage,no_video:n.usage,unsupported_language:n.usage,ffmpeg:n.platform,unsupported_platform:n.platform,install:n.platform,decode:n.platform,fetch:n.failed,cancelled:n.interrupted};export function fromMedia(e){return e instanceof d?new f(e.code.replaceAll("_","-"),e.message,{exit:l[e.code],...e.hint===void 0?{}:{hint:e.hint},cause:e}):e}export async function media(e){try{return await e()}catch(o){throw fromMedia(o)}}export function progressLines(e){let o="",i=-1;return t=>{if(t.done!==void 0&&t.done>0&&t.total!==void 0&&t.total>0){const r=Math.floor(t.done/t.total*10)*10;if(r===i)return;i=r,e.progress(`  ${String(r)}%${t.unit==="frames"?"":` (${a(t.done)} of ${a(t.total)})`}`);return}t.message!==o&&(o=t.message,e.progress(t.message))}}export async function existingFile(e,o){const i=u(e,o);if(!(await s(i).catch(()=>{}))?.isFile())throw new f("not-found",`There is no file ${i}.`,{exit:n.notFound});return i}

package/dist/node_modules/@allyhub/audio/dist/node/ffmpeg.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{spawn as d}from"node:child_process";import{createRuntimes as m}from"@allyhub/runtimes";export class AudioError extends Error{code;constructor(r,o,f){super(o,f),this.name="AudioError",this.code=r}}let s;export function ffmpegOf(e={}){if(e.ffmpeg!==void 0)return Promise.resolve(e.ffmpeg);const r=s??m().bin("ffmpeg","ffmpeg").catch(o=>{throw s=void 0,o});return s=r,r}export const FFMPEG_LOG=2e5;export function runFfmpeg(e,r,o=!1,f=FFMPEG_LOG){return new Promise((u,p)=>{const i=d(e,r,{stdio:["ignore",o?"pipe":"ignore","pipe"]}),c=[];let t="";i.stdout?.on("data",n=>c.push(n)),i.stderr?.on("data",n=>{t+=n.toString(),t.length>f&&(t=t.slice(-f/2))}),i.on("error",p),i.on("close",n=>{n===0?u({out:Buffer.concat(c),err:t}):p(new AudioError("ffmpeg",`ffmpeg failed (${String(n)}): ${t.slice(-2e3)}`))})})}export function floats(e){return new Float32Array(e.buffer.slice(e.byteOffset,e.byteOffset+e.byteLength-e.byteLength%4))}

package/dist/node_modules/@allyhub/audio/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "@allyhub/audio",
+  "version": "0.8.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./node": {
+      "types": "./dist/node/index.d.ts",
+      "default": "./dist/node/index.js"
+    }
+  },
+  "private": true,
+  "license": "SEE LICENSE IN LICENSE.md"
+}

package/dist/node_modules/@allyhub/browser/dist/browser.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{createRuntimes as o}from"@allyhub/runtimes";import{chromeFlags as l,gpuByDefault as u}from"./flags.js";import{launchChrome as g}from"./launch.js";export async function startBrowser(r={}){const e=r.env??process.env,a=r.platform??process.platform,s=r.gpu??u(e,a),n=r.beginFrame??!1;if(n&&a!=="linux")throw new Error("Chrome draws frames on request only on Linux.");const t=r.htmlInCanvas??e.ALLYHUB_HTML_IN_CANVAS!=="0",m=await(r.runtimes??o({env:e})).bin("chrome","chrome",{signal:r.signal}),c=await g({executable:m,args:[...l({gpu:s,beginFrame:n,htmlInCanvas:t,platform:a}),...r.args??[]],env:e,signal:r.signal});return Object.assign(c,{gpu:s,beginFrame:n,htmlInCanvas:t})}

package/dist/node_modules/@allyhub/browser/package.json

@@ -0,0 +1,13 @@
+{
+  "name": "@allyhub/browser",
+  "version": "0.8.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "private": true,
+  "license": "SEE LICENSE IN LICENSE.md"
+}

package/dist/node_modules/@allyhub/build/dist/code.d.ts

@@ -0,0 +1,26 @@
+import { type Prepared, type StageItem } from "./prepare.js";
+export interface PieceCode {
+    file: string;
+    files: string[];
+    bundle: string;
+    vendor: string;
+    components: {
+        name: string;
+        file: string;
+    }[];
+    stage: string[];
+    messages: {
+        locales: string[];
+        messages: Prepared["messages"]["messages"];
+    };
+    data: Record<string, {
+        sha256: string;
+    }>;
+}
+/**
+ * A piece's code. `stage` names what every stage draws with (the runtime's
+ * bundle, the SDK's and runtime's versions, the project's fonts' digest):
+ * the host that serves the stage knows them.
+ */
+export declare function codeOf(prepared: Prepared, item: StageItem, stage: readonly string[]): Promise<PieceCode>;
+//# sourceMappingURL=code.d.ts.map

package/dist/node_modules/@allyhub/build/dist/code.js

@@ -0,0 +1,4 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{createHash as y}from"node:crypto";import{readFile as m}from"node:fs/promises";import{isAbsolute as f,join as $,relative as v,sep as w}from"node:path";import{stageId as g,stageName as E}from"./prepare.js";const i=t=>y("sha256").update(t).digest("hex");export async function codeOf(t,c,p){const o=t.bundle;if(!o)throw new Error("The project was not bundled for the stage.");const l=o.chunks.entries[E(g(c))];if(!l)throw new Error(`${g(c)} was not bundled for the stage.`);const n=[],u=s=>{if(!n.includes(s)){n.push(s);for(const e of o.chunks.chunks[s]?.imports??[])u(e)}};u(l.file);const d=new Set,h=[],b=t.root;for(const s of n)for(const e of o.chunks.chunks[s]?.modules??[]){const a=e.replace(/[?#].*$/u,"");if(a.startsWith("\0")||!f(a))continue;const r=v(b,a);r.split(w).includes("node_modules")||r.startsWith("..")||f(r)?h.push(a):d.add(r.split(w).join("/"))}const j=await Promise.all(n.sort().map(async s=>`${s}\0${i(await m($(o.dir,s)))}`)),k=await Promise.all([...new Set(h)].sort().map(async s=>`${s}\0${i(await m(s).catch(()=>new Uint8Array))}`));return{file:c.file,files:[...d].sort(),bundle:i(j.join(`
+`)),vendor:i(k.join(`
+`)),components:t.components,stage:[...p],messages:{locales:t.messages.locales,messages:t.messages.messages},data:Object.fromEntries(Object.entries(t.data).map(([s,e])=>[s,{sha256:e.sha256}]))}}