@automaton-labs/aib 0.0.3 → 0.0.4

package/dist/help/json/topics/patterns.md

@@ -152,10 +152,19 @@ shortestAlias  rewrite to the shortest valid alias specifier
 preferAlias:
 @shared/*      prefer one alias pattern when several aliases can resolve the same file
 
-inspect.graph.exclude skips files before graph builds the model.
-Use it for generated files, backups, local copies, or other paths that make graph output noisy.
+AIB has four config exclude fields:
+inspect.graph.exclude
+inspect.tree.files.exclude
+inspect.tree.onlyDirs.exclude
+sync.tsconfig.exclude
 
-Excluded files do not affect graph counts, hubs, entrypoints, leaves, edges, imports, importedBy, or saved graph files.
+For all of them, node_modules, .git, dist, build, out, and .tmp are skipped by default.
+
+Use config excludes for generated files, backups, local copies, nested workspaces, seed projects, or other repository-specific noise.
+
+Graph excludes affect graph counts, hubs, entrypoints, leaves, edges, imports, importedBy, and saved graph files.
+Tree excludes affect directory/file discovery output.
+Tsconfig excludes affect which TypeScript configs AIB syncs and watches.
 
 Leave feedback while working.
 

package/dist/help/topics/first-setup.md

@@ -0,0 +1,275 @@
+Use this when the user asks you to set up AIB for a repository.
+
+If you have not loaded the current bootstrap, run:
+aib help bootstrap
+
+1. Detect existing setup
+
+Run:
+
+aib config
+
+If AIB reports that no config exists, continue to initialization.
+
+If config exists:
+- verify that root is the intended repository root;
+- keep existing settings if they are still valid and useful;
+- only add missing project-specific aliases, rules, or excludes;
+- do not regenerate aib.json.
+
+If config resolves from a parent directory, verify that this is intentional.
+Do not continue setup inside a nested worktree or copied project if AIB is using the parent repository config.
+
+2. Initialize if missing
+
+From the repository root, run:
+
+aib init --session-dir .tmp/aib
+
+Use the output to check:
+- root is the intended repository root;
+- config is <root>/aib.json;
+- sessionDir is set;
+- cleanup/deletion/runtime TTLs are shown;
+- not set includes the setup sections that still need decisions.
+
+Do not create sessions yet.
+
+3. Configure repository-specific behavior
+
+Edit aib.json directly.
+
+Keep existing settings if they are still valid and useful.
+Update settings that are stale, noisy, too broad, or no longer match the repository.
+
+Use not set as the checklist for the setup sections below.
+
+4. Configure path aliases
+
+Run:
+
+aib reveal tsaliases
+
+Use this to see existing tsconfig paths and baseUrl values.
+They can reveal stable work areas, but they are not a list to copy.
+
+Add pathAliases for long paths that are likely to appear repeatedly in AIB requests.
+Prefer aliases for real work areas, package roots, or deep directories.
+
+A good alias:
+- saves meaningful path tokens;
+- points to a stable work area;
+- is easy to recognize later.
+
+A bad alias:
+- duplicates a short path like "src": "src";
+- points to a rarely used folder;
+- mirrors the directory tree without a workflow reason.
+
+Having 20-30 good aliases is fine for a large repo or monorepo.
+
+Example:
+
+"pathAliases": {
+  "wstore": "apps/web/src/shared/store",
+  "wapi": "apps/web/src/shared/api",
+  "whooks": "apps/web/src/shared/utils/hooks",
+  "pmail": "packages/email/src",
+  "putils": "packages/utils/src",
+  "arules": "docs/agent/rules"
+}
+
+5. Configure import rules
+
+Set importRules to the import style this repository should use after move/modulePlan mutations.
+
+If the repository has one style, use one broad rule:
+
+"importRules": [
+  {
+    "scope": ".",
+    "specifier": "shortest",
+    "ending": "auto",
+    "builtin": "node",
+    "unusedImports": "remove"
+  }
+]
+
+Use scoped rules only when areas differ by style, for example packages use aliases but scripts use relative imports:
+
+"importRules": [
+  {
+    "scope": "packages",
+    "specifier": "shortest",
+    "ending": "auto",
+    "builtin": "node",
+    "unusedImports": "remove"
+  },
+  {
+    "scope": "scripts",
+    "specifier": "relative",
+    "ending": "auto",
+    "builtin": "node",
+    "unusedImports": "remove"
+  }
+]
+
+Use the most specific scope that matches the real convention.
+Do not add scoped rules just because directories exist.
+
+6. Configure import normalization
+
+Add importNormalize only for cleanup commands the agent is likely to run more than once.
+
+Use it when the repo has a clear normalization target:
+
+"importNormalize": [
+  {
+    "scope": "src",
+    "to": "shortestAlias",
+    "preferAlias": "@/*",
+    "exclude": [
+      "src/generated",
+      "src/**/dist"
+    ]
+  },
+  {
+    "scope": "scripts",
+    "to": "relative",
+    "exclude": [
+      "scripts/**/*.cjs",
+      "scripts/**/*.mjs"
+    ]
+  }
+]
+
+Choose scopes from real repo conventions.
+Do not copy importRules into importNormalize automatically.
+Leave it unset if normalization is not a repeated workflow.
+
+7. Configure tree and graph excludes
+
+Add excludes for noise the repository is known to contain.
+
+Use tree excludes for what the agent should not see while mapping folders.
+Use graph excludes for files that should not affect graph counts, hubs, entrypoints, leaves, edges, or saved graph views.
+
+Built-in excludes already skip common noise such as node_modules, .git, dist, build, out, and .tmp.
+Add config excludes for repository-specific noise.
+
+For example, if the user often creates hard-copy directories or backup files before risky edits, those copies can make tree and graph output noisy.
+Exclude them explicitly:
+
+"inspect.tree.onlyDirs.exclude": [
+  "**/*copy",
+  "**/*copy/**"
+],
+"inspect.tree.files.exclude": [
+  "**/* copy.ts",
+  "**/*.generated.ts"
+],
+"inspect.graph.exclude": [
+  "**/* copy.ts",
+  "**/*.generated.ts",
+  "src/generated/**"
+]
+
+Prefer narrow patterns for known noise:
+- generated files;
+- local copy/backup folders;
+- build artifacts not already skipped by defaults;
+- vendored or checked-in output.
+
+These are common cases, not mandatory rules.
+If the repository needs one of these areas for reasoning or mutation impact checks, do not exclude it.
+
+Do not exclude broad source areas to make output smaller.
+If output is too large, use scope, depth, limit, graph view, or graph toggles first.
+
+8. Configure TypeScript config discovery
+
+Check which TypeScript configs AIB will sync and watch:
+
+aib reveal tsconfigs +all
+
+If output includes nested workspaces, seed projects, snapshots, backups, copied apps, or other non-primary projects, exclude them:
+
+"sync.tsconfig.exclude": [
+  "dev-seed/**",
+  "snapshots/**"
+]
+
+Do not exclude real package/app configs just to reduce output.
+
+After editing aib.json, run:
+
+aib sync
+
+Then check again:
+
+aib reveal tsconfigs +all
+
+Visible tsconfigs should describe the active project surface.
+Excluded tsconfigs should be things the agent should not use for setup decisions.
+
+Use +nec only when you need to compare visible configs with config-excluded configs:
+
+aib reveal tsconfigs +nec
+
+9. Sync and verify
+
+After all aib.json edits, run:
+
+aib sync
+
+If sync fails, fix aib.json and rerun sync.
+
+Check the final config summary:
+
+aib config
+
+Run one compact tree batch using important aliases:
+
+aib inspect --stdin
+
+Input:
+tree @<important-alias> depth=3 +onlyDirs limit=80
+tree @<another-important-alias> depth=3 +onlyDirs limit=80
+
+Check final TypeScript config discovery:
+
+aib reveal tsconfigs
+
+Confirm:
+- aliases resolve;
+- obvious tree noise is hidden;
+- visible tsconfigs match the active project surface;
+- config sections are set intentionally.
+
+10. Note operational constraints
+
+Before reporting back, identify any constraints the user should know.
+
+Worktrees:
+AIB resolves config from the nearest parent aib.json.
+If the repository uses nested copied projects or worktrees inside the repo root, AIB may resolve the parent config.
+Do not set up AIB inside nested worktrees that should behave as independent repositories.
+Independent worktrees should live outside the main repo root or have their own intended aib.json boundary.
+
+TTL:
+Sessions and managed runtime are cleaned up after inactivity according to aib config session.
+Tell the user if you changed these defaults or left them as-is.
+
+Watchers:
+AIB watches aib.json and visible tsconfig files after sync.
+If config changes are not reflected, run aib sync.
+
+11. Report to user
+
+Report:
+- whether AIB config already existed or was initialized;
+- which aliases were added and why;
+- which importRules/importNormalize settings were added or intentionally left unset;
+- which tree/graph/tsconfig excludes were added;
+- whether sync and verification passed;
+- any worktree, TTL, watcher, or tsconfig discovery constraints the user should know.

package/dist/help/topics/inspect.tree.md

@@ -1,20 +1,22 @@
 Use tree to list a compact directory layout.
 It is useful before focused inspect when you know the area but not the exact file.
 
-node_modules, .git, dist, build, out, and .tmp are skipped by default.
-
 Controls:
-scope, depth, minDepth, limit, include, exclude, onlyDirs
+scope, depth, minDepth, limit, only, exclude, onlyDirs, ned, nec
 
 Specific:
 depth     max nesting depth; depth=N
 minDepth  hide shallower paths; minDepth=N
 onlyDirs  show directories only; +onlyDirs
-include   only matching files/dirs; include=[...]
+only      only matching files/dirs; only=[...]
+exclude   skip matching files/dirs; exclude=[...]
+ned       no-default-exclude; ignore built-in excludes; +ned
+nec       no-config-exclude; ignore aib.json tree excludes; +nec
 
 Run:
 aib inspect --stdin
 
 Input:
-tree src depth=4 +onlyDirs limit=200
-tree @svc depth=3 include=["**/*.ts"] exclude=["**/*.test.ts","**/* copy.ts"]
+tree src depth=4 +onlyDirs limit=200 +ned +nec
+tree @svc depth=3 only=["**/*.ts"] exclude=["**/*.test.ts","**/* copy.ts"]
+tree src depth=3 only=["src/services/**"] limit=80

package/dist/help/topics/patterns.md

@@ -152,10 +152,19 @@ shortestAlias  rewrite to the shortest valid alias specifier
 preferAlias:
 @shared/*      prefer one alias pattern when several aliases can resolve the same file
 
-inspect.graph.exclude skips files before graph builds the model.
-Use it for generated files, backups, local copies, or other paths that make graph output noisy.
+AIB has four config exclude fields:
+inspect.graph.exclude
+inspect.tree.files.exclude
+inspect.tree.onlyDirs.exclude
+sync.tsconfig.exclude
 
-Excluded files do not affect graph counts, hubs, entrypoints, leaves, edges, imports, importedBy, or saved graph files.
+For all of them, node_modules, .git, dist, build, out, and .tmp are skipped by default.
+
+Use config excludes for generated files, backups, local copies, nested workspaces, seed projects, or other repository-specific noise.
+
+Graph excludes affect graph counts, hubs, entrypoints, leaves, edges, imports, importedBy, and saved graph files.
+Tree excludes affect directory/file discovery output.
+Tsconfig excludes affect which TypeScript configs AIB syncs and watches.
 
 Leave feedback while working.
 

package/dist/runtime/run-command.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.runCommand=$;const P=require("../commands/list-instances"),b=require("../commands/ping"),k=require("../commands/runtime-info"),S=require("../commands/print-config"),x=require("../commands/init-skill-usage"),R=require("../commands/init-workspace"),A=require("../commands/inspect"),c=require("../commands/captured-input"),E=require("../commands/module-plan-command"),D=require("../commands/rename-command"),N=require("../commands/move-command"),O=require("../commands/refactor-command"),U=require("../commands/imports-command"),W=require("../commands/execution-command"),T=require("../commands/observability-command"),M=require("../commands/help-command"),F=require("../commands/generate-docs-command"),j=require("../commands/feedback-command"),Q=require("../commands/doctor"),G=require("../commands/diagnostics-command"),H=require("../commands/session-workspace"),I=require("../commands/session-workspace"),v=require("../config/path-aliases"),J=require("../commands/runtime-command"),K=require("../commands/sync-command"),l=require("../client/transport-options"),m=require("../shared/errors"),p=require("./input-source"),L=require("../config/workspace-state");async function $(n){return(0,I.runWithSessionOverride)(n.sessionId,()=>z(n))}async function z(n){const{command:o,restArgs:d,cwd:r,instanceId:_,metricsSpans:g}=n,u=B(o)?(0,L.ensureWorkspaceState)(r):null,w=u?(0,I.readSessionPathAliasOverrides)(r):{},f={...u?.pathAliases??{},...w},e=(0,v.expandPathAliasesInArgs)(r,d,f),a=await(0,p.resolveCommandInputSource)({command:o,cwd:r,restArgs:e,...n.stdinPayload!==void 0?{preResolvedPayload:(0,v.expandPathAliasesInJson)(r,n.stdinPayload,f)}:{},...n.stdinInputSource!==void 0?{preResolvedSource:n.stdinInputSource}:{}}),s=a.payload,t={};_!==void 0&&(t.explicitInstanceId=_),n.autoStartIde!==void 0&&(t.autoStartIde=n.autoStartIde),n.transport!==void 0&&(t.transport=n.transport),n.metricsEnabled===!0&&(t.metricsEnabled=!0),u&&(t.importRules=u.importRules,t.mutationComments=u.mutationComments);const C=(0,l.getPreferredTransport)();n.transport&&(0,l.setPreferredTransport)(n.transport);try{switch(o){case"doctor":return(0,Q.runDoctor)({cwd:r,runtime:e.includes("--runtime"),verbose:e.includes("--verbose"),json:e.includes("--json")});case"diagnostics":return await(0,G.runDiagnosticsCommand)(e),{ok:!0,command:"diagnostics"};case"session":return(0,H.runSessionWorkspaceCommand)(r,e,s);case"init":return(0,R.runInitWorkspace)(r,d);case"help":return(0,M.runHelpCommand)(e);case"generate-docs":return(0,F.runGenerateDocsCommand)(r,d);case"sync":return(0,K.runSyncCommand)(r,e);case"observability":return(0,T.runObservabilityCommand)(r,e);case"feedback":case"note":return(0,j.runFeedbackCommand)(r,d,o);case"runtime":return(0,J.runRuntimeCommand)(r,e);case"imports":return(0,c.attachCapturedInput)(r,"imports",s,await(0,U.runImportsCommand)(r,e,s,t,g),a.source);case"listInstances":return(0,P.runListInstances)();case"ping":return(0,b.runPing)(r,t);case"runtimeInfo":return(0,k.runRuntimeInfo)(r,t);case"printConfig":return(0,S.runPrintConfig)(r,t);case"initSkillUsage":case"init-skill-usage":{const i=e.findIndex(h=>h==="--cli-name"),q=i>=0&&e[i+1]?e[i+1]:"aib",y={cwd:r,cliName:q??"aib"};return y.resolveOptions=t,(0,x.runInitSkillUsage)(y)}case"inspect":return(0,c.attachCapturedInput)(r,e[0]==="graph"?"graph":"inspect",s,await(0,A.runInspect)(r,e,s,t),a.source);case"modulePlan":return(0,c.attachCapturedInput)(r,"modulePlan",s,await(0,E.runModulePlanCommand)(r,e,s,t,n.modulePlanExecutionId?{executionId:n.modulePlanExecutionId}:{}),a.source);case"execution":return(0,W.runExecutionCommand)(r,e);case"rename":{if(!(e[0]==="apply"&&typeof e[1]=="string"&&!e[1].startsWith("--"))&&(0,p.commandRequiresPayload)(o,e,a))throw new m.CliError("STDIN_REQUIRED","rename preview/apply/validate expects a payload on stdin or --from, except preview-id apply/help.");return(0,c.attachCapturedInput)(r,"rename",s,await(0,D.runRenameCommand)(r,e,s,t),a.source)}case"move":{if(!(e[0]==="toFile"&&e[1]==="apply"&&typeof e[2]=="string"&&!e[2].startsWith("--"))&&(0,p.commandRequiresPayload)(o,e,a))throw new m.CliError("STDIN_REQUIRED","move toFile preview/apply/validate expects a payload on stdin or --from.");return(0,c.attachCapturedInput)(r,"move",s,await(0,N.runMoveCommand)(r,e,s,t),a.source)}case"refactor":{if(!(e[0]==="batch"&&e[1]==="apply"&&typeof e[2]=="string"&&!e[2].startsWith("--"))&&(0,p.commandRequiresPayload)(o,e,a))throw new m.CliError("STDIN_REQUIRED","refactor batch preview/apply/validate expects a payload on stdin or --from, except preview-id apply/help.");return(0,c.attachCapturedInput)(r,"refactor",s,await(0,O.runRefactorCommand)(r,e,s,t),a.source)}default:throw new m.CliError("UNKNOWN_COMMAND",`Unknown command: ${o}`,{availableCommands:["doctor","diagnostics","listInstances","ping","runtimeInfo","printConfig","init-skill-usage","init","help","generate-docs","sync","inspect","imports","execution","move","rename","refactor","modulePlan","session","runtime","trace","observability","feedback","note"]})}}finally{(0,l.setPreferredTransport)(C)}}function B(n){return n!=="init"&&n!=="help"&&n!=="generate-docs"&&n!=="observability"&&n!=="feedback"&&n!=="note"&&n!=="runtime"&&n!=="diagnostics"&&n!=="doctor"}
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.runCommand=z;const P=require("../commands/list-instances"),b=require("../commands/ping"),k=require("../commands/runtime-info"),S=require("../commands/print-config"),R=require("../commands/init-skill-usage"),x=require("../commands/init-workspace"),A=require("../commands/inspect"),c=require("../commands/captured-input"),E=require("../commands/module-plan-command"),D=require("../commands/rename-command"),N=require("../commands/move-command"),O=require("../commands/refactor-command"),U=require("../commands/imports-command"),W=require("../commands/execution-command"),T=require("../commands/observability-command"),M=require("../commands/help-command"),F=require("../commands/generate-docs-command"),j=require("../commands/feedback-command"),Q=require("../commands/doctor"),G=require("../commands/diagnostics-command"),H=require("../commands/session-workspace"),y=require("../commands/session-workspace"),I=require("../config/path-aliases"),J=require("../commands/runtime-command"),K=require("../commands/sync-command"),L=require("../commands/reveal-command"),p=require("../client/transport-options"),m=require("../shared/errors"),l=require("./input-source"),$=require("../config/workspace-state");async function z(n){return(0,y.runWithSessionOverride)(n.sessionId,()=>B(n))}async function B(n){const{command:o,restArgs:d,cwd:r,instanceId:_,metricsSpans:C}=n,u=V(o)?(0,$.ensureWorkspaceState)(r):null,g=u?(0,y.readSessionPathAliasOverrides)(r):{},f={...u?.pathAliases??{},...g},e=(0,I.expandPathAliasesInArgs)(r,d,f),a=await(0,l.resolveCommandInputSource)({command:o,cwd:r,restArgs:e,...n.stdinPayload!==void 0?{preResolvedPayload:(0,I.expandPathAliasesInJson)(r,n.stdinPayload,f)}:{},...n.stdinInputSource!==void 0?{preResolvedSource:n.stdinInputSource}:{}}),s=a.payload,t={};_!==void 0&&(t.explicitInstanceId=_),n.autoStartIde!==void 0&&(t.autoStartIde=n.autoStartIde),n.transport!==void 0&&(t.transport=n.transport),n.metricsEnabled===!0&&(t.metricsEnabled=!0),u&&(t.importRules=u.importRules,t.mutationComments=u.mutationComments);const w=(0,p.getPreferredTransport)();n.transport&&(0,p.setPreferredTransport)(n.transport);try{switch(o){case"doctor":return(0,Q.runDoctor)({cwd:r,runtime:e.includes("--runtime"),verbose:e.includes("--verbose"),json:e.includes("--json")});case"diagnostics":return await(0,G.runDiagnosticsCommand)(e),{ok:!0,command:"diagnostics"};case"session":return(0,H.runSessionWorkspaceCommand)(r,e,s);case"init":return(0,x.runInitWorkspace)(r,d);case"help":return(0,M.runHelpCommand)(e);case"generate-docs":return(0,F.runGenerateDocsCommand)(r,d);case"sync":return(0,K.runSyncCommand)(r,e);case"reveal":return(0,L.runRevealCommand)(r,e);case"observability":return(0,T.runObservabilityCommand)(r,e);case"feedback":case"note":return(0,j.runFeedbackCommand)(r,d,o);case"runtime":return(0,J.runRuntimeCommand)(r,e);case"imports":return(0,c.attachCapturedInput)(r,"imports",s,await(0,U.runImportsCommand)(r,e,s,t,C),a.source);case"listInstances":return(0,P.runListInstances)();case"ping":return(0,b.runPing)(r,t);case"runtimeInfo":return(0,k.runRuntimeInfo)(r,t);case"printConfig":return(0,S.runPrintConfig)(r,t);case"initSkillUsage":case"init-skill-usage":{const i=e.findIndex(h=>h==="--cli-name"),q=i>=0&&e[i+1]?e[i+1]:"aib",v={cwd:r,cliName:q??"aib"};return v.resolveOptions=t,(0,R.runInitSkillUsage)(v)}case"inspect":return(0,c.attachCapturedInput)(r,e[0]==="graph"?"graph":"inspect",s,await(0,A.runInspect)(r,e,s,t),a.source);case"modulePlan":return(0,c.attachCapturedInput)(r,"modulePlan",s,await(0,E.runModulePlanCommand)(r,e,s,t,n.modulePlanExecutionId?{executionId:n.modulePlanExecutionId}:{}),a.source);case"execution":return(0,W.runExecutionCommand)(r,e);case"rename":{if(!(e[0]==="apply"&&typeof e[1]=="string"&&!e[1].startsWith("--"))&&(0,l.commandRequiresPayload)(o,e,a))throw new m.CliError("STDIN_REQUIRED","rename preview/apply/validate expects a payload on stdin or --from, except preview-id apply/help.");return(0,c.attachCapturedInput)(r,"rename",s,await(0,D.runRenameCommand)(r,e,s,t),a.source)}case"move":{if(!(e[0]==="toFile"&&e[1]==="apply"&&typeof e[2]=="string"&&!e[2].startsWith("--"))&&(0,l.commandRequiresPayload)(o,e,a))throw new m.CliError("STDIN_REQUIRED","move toFile preview/apply/validate expects a payload on stdin or --from.");return(0,c.attachCapturedInput)(r,"move",s,await(0,N.runMoveCommand)(r,e,s,t),a.source)}case"refactor":{if(!(e[0]==="batch"&&e[1]==="apply"&&typeof e[2]=="string"&&!e[2].startsWith("--"))&&(0,l.commandRequiresPayload)(o,e,a))throw new m.CliError("STDIN_REQUIRED","refactor batch preview/apply/validate expects a payload on stdin or --from, except preview-id apply/help.");return(0,c.attachCapturedInput)(r,"refactor",s,await(0,O.runRefactorCommand)(r,e,s,t),a.source)}default:throw new m.CliError("UNKNOWN_COMMAND",`Unknown command: ${o}`,{availableCommands:["doctor","diagnostics","listInstances","ping","runtimeInfo","printConfig","init-skill-usage","init","help","generate-docs","sync","reveal","inspect","imports","execution","move","rename","refactor","modulePlan","session","runtime","trace","observability","feedback","note"]})}}finally{(0,p.setPreferredTransport)(w)}}function V(n){return n!=="init"&&n!=="help"&&n!=="generate-docs"&&n!=="observability"&&n!=="feedback"&&n!=="note"&&n!=="runtime"&&n!=="diagnostics"&&n!=="doctor"&&n!=="reveal"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@automaton-labs/aib",
-  "version": "0.0.3",
+  "version": "0.0.4",
   "description": "CLI for discovering and calling the local aib IDE extension runtime.",
   "publishConfig": {
     "access": "public"

package/scripts/install-windows-launcher.cjs

@@ -50,6 +50,7 @@ if (!npmPrefix) {
 
 fs.mkdirSync(npmPrefix, { recursive: true });
 fs.copyFileSync(launcherPath, path.join(npmPrefix, "aib.exe"));
+fs.writeFileSync(path.join(npmPrefix, "aib.node-cli.txt"), `${path.join(packageRoot, "dist", "bin", "aib.js")}\n`, "utf8");
 
 const ps1ShimPath = path.join(npmPrefix, "aib.ps1");
 const ps1BackupPath = path.join(npmPrefix, "aib.ps1.bak");

package/scripts/provision-runtime.cjs

@@ -24,6 +24,8 @@ main().catch((error) => {
 });
 
 async function main() {
+  cleanupOldTempDownloads();
+
   if (runtimeComplete()) {
     if (!options.quiet) {
       reporter.info(`aib runtime ready: ${path.relative(process.cwd(), runtimesDir) || runtimesDir}`);
@@ -57,27 +59,31 @@ async function main() {
 
   reporter.info(`aib runtime: provisioning ${platformKey}`);
   const resolution = source || url
-    ? { archivePath: source ? path.resolve(source) : await downloadRuntimeArchive(url, "runtime archive"), expectedSha256: options.sha256 ?? process.env.AIB_RUNTIME_SHA256 ?? null }
+    ? { ...(source ? { archivePath: path.resolve(source), tempDir: null } : await downloadRuntimeArchive(url, "runtime archive")), expectedSha256: options.sha256 ?? process.env.AIB_RUNTIME_SHA256 ?? null }
     : await resolveFromManifest(manifestSource, manifestUrl);
   const archivePath = resolution.archivePath;
-  if (!fs.existsSync(archivePath)) {
-    throw new Error(`Runtime archive not found: ${archivePath}`);
-  }
-  if (resolution.expectedSha256) {
-    reporter.info("aib runtime: verifying checksum");
-    assertSha256(archivePath, resolution.expectedSha256);
-  }
+  try {
+    if (!fs.existsSync(archivePath)) {
+      throw new Error(`Runtime archive not found: ${archivePath}`);
+    }
+    if (resolution.expectedSha256) {
+      reporter.info("aib runtime: verifying checksum");
+      assertSha256(archivePath, resolution.expectedSha256);
+    }
 
-  fs.mkdirSync(runtimesDir, { recursive: true });
-  reporter.info("aib runtime: extracting archive");
-  extractRuntimeArchive(archivePath);
+    fs.mkdirSync(runtimesDir, { recursive: true });
+    reporter.info("aib runtime: extracting archive");
+    extractRuntimeArchive(archivePath);
 
-  if (!runtimeComplete()) {
-    throw new Error(`Runtime archive did not provision a complete runtime under ${runtimesDir}`);
+    if (!runtimeComplete()) {
+      throw new Error(`Runtime archive did not provision a complete runtime under ${runtimesDir}`);
+    }
+  } finally {
+    cleanupOwnedTempDownload(resolution.tempDir);
   }
 
   if (!options.quiet) {
-    reporter.info(`aib runtime provisioned: ${path.relative(process.cwd(), runtimesDir) || runtimesDir}`);
+    reporter.info("aib runtime: ready");
   }
 }
 
@@ -138,21 +144,72 @@ async function resolveFromManifest(manifestSource, manifestUrl) {
   }
   const archivePath = artifact.file && manifestSource
     ? path.resolve(path.dirname(path.resolve(manifestSource)), String(artifact.file))
-    : artifact.url
-      ? await downloadRuntimeArchive(String(artifact.url))
-      : null;
-  if (!archivePath) {
+    : null;
+  const downloaded = !archivePath && artifact.url
+    ? await downloadRuntimeArchive(String(artifact.url))
+    : null;
+  const resolvedArchivePath = archivePath ?? downloaded?.archivePath ?? null;
+  const tempDir = downloaded?.tempDir ?? null;
+  if (!resolvedArchivePath) {
     throw new Error(`Runtime manifest artifact for ${platformKey} has no url or local file.`);
   }
   return {
-    archivePath,
+    archivePath: resolvedArchivePath,
+    tempDir,
     expectedSha256: typeof artifact.sha256 === "string" ? artifact.sha256 : null
   };
 }
 
 async function downloadJson(url) {
-  const filePath = await downloadRuntimeArchive(url, "runtime manifest");
-  return JSON.parse(fs.readFileSync(filePath, "utf8"));
+  const download = await downloadRuntimeArchive(url, "runtime manifest");
+  try {
+    return JSON.parse(fs.readFileSync(download.archivePath, "utf8"));
+  } finally {
+    cleanupOwnedTempDownload(download.tempDir);
+  }
+}
+
+function cleanupOldTempDownloads() {
+  const cutoffMs = Date.now() - 24 * 60 * 60 * 1000;
+  let entries = [];
+  try {
+    entries = fs.readdirSync(os.tmpdir(), { withFileTypes: true });
+  } catch {
+    return;
+  }
+  for (const entry of entries) {
+    if (!entry.isDirectory() || !entry.name.startsWith("aib-runtime-")) {
+      continue;
+    }
+    const tempDir = path.join(os.tmpdir(), entry.name);
+    try {
+      const stat = fs.statSync(tempDir);
+      if (stat.mtimeMs < cutoffMs) {
+        fs.rmSync(tempDir, { recursive: true, force: true });
+      }
+    } catch {
+      // Best-effort cleanup only.
+    }
+  }
+}
+
+function cleanupOwnedTempDownload(tempDir) {
+  if (!tempDir) {
+    return;
+  }
+  try {
+    const resolvedTemp = path.resolve(tempDir);
+    const resolvedOsTemp = path.resolve(os.tmpdir());
+    const relative = path.relative(resolvedOsTemp, resolvedTemp);
+    if (path.basename(resolvedTemp).startsWith("aib-runtime-")
+      && relative
+      && !relative.startsWith("..")
+      && !path.isAbsolute(relative)) {
+      fs.rmSync(resolvedTemp, { recursive: true, force: true });
+    }
+  } catch {
+    // Best-effort cleanup only.
+  }
 }
 
 function defaultManifestUrl() {
@@ -281,12 +338,14 @@ function downloadRuntimeArchive(url, label = "runtime archive") {
       if (response.statusCode && response.statusCode >= 300 && response.statusCode < 400 && response.headers.location) {
         file.close();
         fs.rmSync(targetPath, { force: true });
+        cleanupOwnedTempDownload(tempDir);
         downloadRuntimeArchive(new URL(response.headers.location, url).toString(), label).then(resolve, reject);
         return;
       }
       if (response.statusCode !== 200) {
         file.close();
         fs.rmSync(targetPath, { force: true });
+        cleanupOwnedTempDownload(tempDir);
         reject(new Error(`Runtime download failed with HTTP ${response.statusCode}: ${url}`));
         return;
       }
@@ -297,13 +356,14 @@ function downloadRuntimeArchive(url, label = "runtime archive") {
       file.on("finish", () => {
         file.close(() => {
           progress.done();
-          resolve(targetPath);
+          resolve({ archivePath: targetPath, tempDir });
         });
       });
     });
     request.on("error", (error) => {
       file.close();
       fs.rmSync(targetPath, { force: true });
+      cleanupOwnedTempDownload(tempDir);
       reject(error);
     });
   });
@@ -311,7 +371,6 @@ function downloadRuntimeArchive(url, label = "runtime archive") {
 
 function createReporter(enabled) {
   const stream = process.stderr;
-  const useCarriageReturn = Boolean(stream.isTTY);
   return {
     info(message) {
       if (!enabled) {
@@ -324,37 +383,36 @@ function createReporter(enabled) {
         return { add() {}, done() {} };
       }
       let downloadedBytes = 0;
-      let lastWriteMs = 0;
       let ended = false;
-      const startedMs = Date.now();
-      const minIntervalMs = useCarriageReturn ? 750 : 5000;
-      const write = (force = false) => {
-        const now = Date.now();
-        if (!force && now - lastWriteMs < minIntervalMs) {
+      let nextPercent = 10;
+      const totalKnown = Number.isFinite(totalBytes) && totalBytes > 0;
+      const showPercentProgress = totalKnown && totalBytes >= 1024 * 1024;
+      stream.write(totalKnown
+        ? `${label} ${formatBytes(totalBytes)}\n`
+        : `${label}\n`);
+      const writeProgress = () => {
+        if (!showPercentProgress) {
           return;
         }
-        lastWriteMs = now;
-        const percent = totalBytes ? Math.min(100, (downloadedBytes / totalBytes) * 100) : null;
-        const elapsedSeconds = Math.max(0.001, (now - startedMs) / 1000);
-        const rateBytes = downloadedBytes / elapsedSeconds;
-        const text = percent === null
-          ? `${label}: ${formatBytes(downloadedBytes)} downloaded (${formatBytes(rateBytes)}/s)`
-          : `${label}: ${percent.toFixed(1)}% ${formatBytes(downloadedBytes)} / ${formatBytes(totalBytes)} (${formatBytes(rateBytes)}/s)`;
-        stream.write(useCarriageReturn ? `\r${text}` : `${text}\n`);
+        const percent = Math.floor(Math.min(100, (downloadedBytes / totalBytes) * 100));
+        while (percent >= nextPercent && nextPercent <= 100) {
+          const thresholdBytes = Math.min(totalBytes, Math.round((totalBytes * nextPercent) / 100));
+          stream.write(`aib runtime: ${nextPercent}% ${formatBytes(thresholdBytes)} / ${formatBytes(totalBytes)}\n`);
+          nextPercent += 10;
+        }
       };
-      write(true);
       return {
         add(byteCount) {
           downloadedBytes += byteCount;
-          write(false);
+          writeProgress();
         },
         done() {
           if (ended) {
             return;
           }
           ended = true;
-          write(true);
-          stream.write(useCarriageReturn ? "\n" : "");
+          downloadedBytes = Math.max(downloadedBytes, totalBytes ?? downloadedBytes);
+          writeProgress();
         }
       };
     }