@automaton-labs/aib 0.0.1

package/README.md

@@ -0,0 +1,578 @@
+# aib CLI
+
+CLI для подключения к живому `aib` extension instance.
+
+Текущая цель пакета:
+
+- discovery instance по локальному registry;
+- session runtime, который переиспользуется между вызовами;
+- базовые debug-команды;
+- semantic operations поверх extension runtime.
+
+## Current Commands
+
+- `aib listInstances`
+- `aib ping`
+- `aib runtimeInfo`
+- `aib printConfig`
+- `aib init-skill-usage`
+- `aib inspect file <file> [--ranges] [--local-only]`
+- `aib inspect exports <file> [--ranges]`
+- `aib inspect exports <file> --resolve-star`
+- `aib inspect members <file> <entity> [--ranges] [--offset <n>] [--limit <n>] [--all]`
+- `aib inspect code <file> <entity> [--parent <entity>] [--ranges] [--max-lines <n>] [--to-file <path>]`
+- `aib inspect dependencies <file> <entity> [--ranges]`
+- `aib inspect slice <file> <entity> [--max-lines <n>] [--to-file <path>]`
+- `aib modulePlan preview --stdin [--details]`
+- `aib modulePlan preview --from-json <plan.json> [--details]`
+- `aib inspect graph <file-or-directory> [--depth 0|1|2] [--exclude <glob>] [--exclude-from <file>]`
+- `aib inspect graph --from-file <graph.json> --focus <file> [--symbols] [--symbol-usage]`
+- `aib inspect --stdin`
+- `aib imports importers <file-or-directory>`
+- `aib imports unused <file>`
+- `aib move toFile preview --stdin`
+- `aib rename preview --stdin`
+- `aib modulePlan apply --stdin`
+- `aib modulePlan apply --from-json <plan.json>`
+- `aib modulePlan apply <planId>`
+- `aib modulePlan validate --plan <planId>`
+- `aib trace status|set|clear`
+- `aib session init|status|where|read|write|clear`
+- `aib session start|stop`
+
+## Global Flags
+
+- `--cwd <path>`: resolve the target IDE instance for this workspace path.
+- `--instance <id>`: target a specific registry instance. This never auto-starts another IDE host.
+- `--transport http|websocket`: choose the extension transport for the request.
+- `--metrics`: include opt-in timing spans.
+- `--auto-start-ide`: if no live IDE matches `--cwd`, start or reuse a managed Windows VS Code `serve-web + headless client` host.
+- `--no-auto-start-ide`: disable auto-start for one command, even if the environment enables it.
+
+Environment:
+
+- `AIB_AUTO_START_IDE=1` enables the same opt-in managed IDE startup as `--auto-start-ide`.
+- `AIB_EXTENSION_VSIX=<path>` points managed startup at a packaged extension VSIX.
+- `AIB_INSTALL_CONFIG=<path>` points managed startup at an install config JSON with `extensionVsix`.
+- `AIB_TRACE_DIR=<path>` enables opt-in CLI trace capture for every command in that environment.
+
+Auto-start is conservative for now:
+
+- it is off by default;
+- it is Windows VS Code `serve-web` only;
+- canonical commands are the validated path;
+- workspace alias settings in managed serve-web mode still need separate verification.
+
+## Trace Capture
+
+Trace capture is off by default.
+
+Enable it for one command:
+
+```powershell
+aib --trace-dir .aib-trace doctor
+```
+
+Enable it for a trial session:
+
+```powershell
+$env:AIB_TRACE_DIR = ".aib-trace"
+aib move toFile preview --stdin
+```
+
+Enable it for the current project so it survives new shells:
+
+```powershell
+aib trace set .aib-trace
+aib trace status
+```
+
+Clear the project trace setting without deleting existing trace files:
+
+```powershell
+aib trace clear
+```
+
+Priority is `--trace-dir`, then `AIB_TRACE_DIR`, then the project trace setting.
+Relative trace paths are resolved against the CLI `cwd`. Trace output includes `trace.jsonl` plus per-call request/response/meta artifacts under `calls/`.
+
+## Inspect / Progressive Disclosure
+
+Use `inspect` when an agent needs a compact semantic map before refactoring.
+
+```powershell
+aib inspect file src/service.ts
+aib inspect exports src/service.ts
+aib inspect members src/service.ts c-Service
+aib inspect members src/service.ts c-Service --offset 20 --limit 20
+aib inspect members src/service.ts c-Service --all
+aib inspect code src/service.ts m-save --parent c-Service
+aib inspect code src/service.ts v-LARGE_TABLE --to-file .aib-slices/large-table.ts
+aib inspect dependencies src/service.ts c-Service
+aib inspect slice src/service.ts c-Service --to-file .aib-slices/service.ts
+aib inspect exports src/index.ts --resolve-star
+aib inspect file src/service.ts --ranges
+aib inspect file src/index.ts --local-only
+```
+
+Batch inspect requests:
+
+```powershell
+@'
+{
+  "file": "src/service.ts",
+  "requests": [
+    { "op": "file" },
+    { "op": "exports" },
+    { "op": "members", "entity": "c-Service" },
+    { "op": "code", "entity": "m-save", "parent": "c-Service" },
+    { "op": "slice", "entity": "c-Service", "toFile": ".aib-slices/service.ts" }
+  ]
+}
+'@ | aib inspect --stdin
+```
+
+Uniform batch requests can avoid repeating both `file` and `op`:
+
+```powershell
+@'
+{
+  "file": "src/service.ts",
+  "op": "dependencies",
+  "entities": [
+    "f-createService",
+    "c-Service"
+  ]
+}
+'@ | aib inspect --stdin
+```
+
+Uniform `dependencies` and `members` batches return grouped compact output keyed by entity selector.
+
+`dependencies` output is grouped by usage:
+
+```json
+{
+	"typeOnly": ["i-CartLine", "t-CurrencyCode"],
+	"value": ["f-createMoney", "v-TIER_DISCOUNT"]
+}
+```
+
+`unclassified` is shown only when nonempty. It means the inspect layer found a local dependency but could not safely classify the usage position with the current syntax heuristic.
+
+Default inspect output is compact and uses fixed selector aliases (`c-`, `i-`, `t-`, `f-`, `v-`, `e-`, `m-`, `p-`). Workspace selector alias overrides are intentionally ignored.
+
+`inspect file --local-only` answers the physical-file question. It reports local declarations and re-export modules without resolving `export *` through a facade:
+
+```json
+{
+	"file": "src/index.ts",
+	"results": [
+		{
+			"op": "file",
+			"mode": "local",
+			"summary": "facade only; 3 re-exports; 0 local declarations",
+			"symbols": [],
+			"reexports": ["./core/types.js", "./core/service.js", "./core/index.js"]
+		}
+	]
+}
+```
+
+Use `inspect exports <file> --resolve-star` for the public API visible through a facade.
+
+`inspect graph` gives a compact local file relationship map. It is local CLI logic and does not require an IDE runtime:
+
+```powershell
+aib inspect graph src/main --depth 1
+aib inspect graph src/main --depth 1 --exclude "**/* copy.ts"
+aib inspect graph src/main --depth 1 --exclude-from .aib-graph-ignore
+```
+
+Graph excludes can also be configured in `.aib.json`, `.aib.json`, or `.vscode/settings.json`:
+
+```json
+{
+	"inspect": {
+		"graph": {
+			"exclude": ["**/* copy.ts", "src/generated/**"]
+		}
+	}
+}
+```
+
+Excludes are applied before the graph model is built, so excluded files do not affect counts, hubs, leaves, edges, or saved graph files.
+
+`members` is compact by default: it returns the first page of members plus a hidden-count marker when more members exist. Use `--all` for the full list or `--offset <n> --limit <n>` to page through a large class/interface without printing every member.
+
+`code --to-file <path>` writes exact selected code to disk without printing it to stdout. Use it for large declarations that an agent needs to mechanically move or inspect without polluting context.
+
+`inspect --stdin` supports per-request `toFile` / `outputFile` for `code` and `slice` rows. This lets an agent extract several selected declarations in one CLI call while stdout only reports compact `writtenTo` paths.
+
+With a session workspace, use `save` to write selected code/slices and keep stdout compact:
+
+```powershell
+aib session init --dir .tmp/aib
+@'
+{
+  "file": "src/service.ts",
+  "parent": "c-Service",
+  "requests": [
+    { "op": "code", "entity": "m-save", "save": "service-save-method" },
+    { "op": "slice", "entity": "c-Service", "parent": null, "save": "service-class" }
+  ]
+}
+'@ | aib inspect --stdin
+```
+
+Use `bundleSave` when several inspect rows form one reusable context packet. Per-request `save` still works:
+
+```powershell
+@'
+{
+  "file": "src/service.ts",
+  "parent": "c-Service",
+  "bundleSave": "service-context",
+  "requests": [
+    { "op": "members", "entity": "c-Service" },
+    { "op": "code", "entity": "m-save", "save": "service-save-method" },
+    { "op": "slice", "entity": "c-Service", "parent": null, "save": "service-class" }
+  ]
+}
+'@ | aib inspect --stdin
+```
+
+The bundle is saved as `aib:inspect:service-context` and can be read with `session read`.
+
+Read saved artifacts back into context by handle:
+
+```powershell
+aib session read aib:code:service-save-method
+aib session read aib:slice:service-class --head 80
+```
+
+Batch reads avoid repeated CLI calls:
+
+```powershell
+@'
+{
+  "reads": [
+    { "handle": "aib:code:service-save-method" },
+    { "handle": "aib:slice:service-class", "offset": 30, "limit": 50 }
+  ]
+}
+'@ | aib session read --stdin
+```
+
+`modulePlan` validates an agent-proposed module split without editing source files. It reports compact per-target summaries with exported symbols, private symbols, type-only imports, runtime imports, unassigned dependencies, runtime cycles, and facade export suggestions:
+
+```powershell
+@'
+{
+  "file": "src/service.ts",
+  "op": "modulePlan",
+  "facade": "src/service.ts",
+  "modules": [
+    {
+      "target": "src/core/types.ts",
+      "symbols": ["i-ServiceOptions", "t-ServiceMode"]
+    },
+    {
+      "target": "src/core/service.ts",
+      "symbols": ["c-Service", "f-createService"]
+    }
+  ]
+}
+'@ | aib modulePlan preview --stdin
+```
+
+For large plans, write the same JSON to a temporary file and edit that file with normal file tools instead of repeatedly printing long heredocs:
+
+```powershell
+aib modulePlan preview --from-json .aib-plan/module-plan.json
+```
+
+Add `"previewFiles": true` to write read-only preview artifacts without changing source files:
+
+```json
+{
+	"file": "src/service.ts",
+	"op": "modulePlan",
+	"facade": "src/service.ts",
+	"previewFiles": true,
+	"previewDir": ".aib-preview/service-split",
+	"modules": [
+		{
+			"target": "src/core/types.ts",
+			"symbols": ["i-ServiceOptions", "t-ServiceMode"]
+		},
+		{
+			"target": "src/core/service.ts",
+			"symbols": ["c-Service", "f-createService"]
+		}
+	]
+}
+```
+
+The response stays compact and points to generated artifacts:
+
+```json
+{
+	"planId": "plan_abc123",
+	"planHash": "sha256:...",
+	"next": "Run modulePlan apply plan_abc123 if the plan matches intent.",
+	"preview": {
+		"dir": ".aib-plan-cache/previews/plan_abc123",
+		"summary": "2 files; facade 2l; patch 120l; cycles none",
+		"files": {
+			"src/core/service.ts": {
+				"file": ".aib-plan-cache/previews/plan_abc123/files/core/service.ts",
+				"lines": 80
+			}
+		},
+		"facade": {
+			"file": ".aib-preview/service-split/facade/service.ts",
+			"lines": 2
+		},
+		"patch": {
+			"file": ".aib-preview/service-split/module-plan.preview.patch",
+			"lines": 120
+		},
+		"next": ["check summary/api/cycles/imports", "read targeted preview artifacts only if a warning/check points there", "use top-level next for apply/revise action"]
+	}
+}
+```
+
+Default `modulePlan` output uses compact `targets[].summary` rows, for example `exports c-Service; private f-normalize; imports type src/core/types.ts: i-Options; run src/core/helpers.ts: f-createHelper`. Add `--details` only when an agent needs the full module ownership/import map in stdout.
+
+When `modulePlan preview` includes preview files, the plan is cached under `.aib-plan-cache/` and can be applied without resending the module JSON if it is executable:
+
+```powershell
+aib modulePlan apply plan_abc123
+```
+
+After apply, run a compact generated-module validation:
+
+```powershell
+aib modulePlan validate --plan plan_abc123
+```
+
+It checks that expected generated files exist, generated relative import/export specifiers use `.js`, generated modules do not import back from the facade, and the cached facade/API expectation is still visible.
+
+`modulePlan` also reports public API preservation when a facade is requested:
+
+```json
+{
+	"api": {
+		"status": "preserved",
+		"before": 44,
+		"after": 44
+	}
+}
+```
+
+If a generated module would import a symbol from another generated module that is not exported there, `modulePlan` returns a compact diagnostic-first response. The plan is cached as non-executable, so it can be revised by id but cannot be applied:
+
+```json
+{
+	"ok": false,
+	"planId": "plan_blocked123",
+	"executable": false,
+	"blocking": [
+		{
+			"from": "src/commerce/pricing.ts",
+			"source": "src/commerce/customer.ts",
+			"usage": "value",
+			"symbols": ["v-TIER_DISCOUNT"],
+			"suggestedFixes": [{ "kind": "moveSymbol", "symbol": "v-TIER_DISCOUNT", "to": "src/commerce/pricing.ts" }],
+			"hint": "Move the symbol into the importing module, move the dependent symbol into the owner module, or intentionally export it before applying."
+		}
+	],
+	"next": "Revise with: aib modulePlan revise --plan plan_blocked123 --stdin"
+}
+```
+
+Revise a blocked plan without resending the full module JSON:
+
+```powershell
+@'
+{
+  "applySuggestedFixes": [0]
+}
+'@ | aib modulePlan revise --plan plan_blocked123 --stdin
+```
+
+Or move a symbol explicitly:
+
+```powershell
+@'
+{
+  "moves": [
+    { "symbol": "v-TIER_DISCOUNT", "to": "src/commerce/pricing.ts" }
+  ]
+}
+'@ | aib modulePlan revise --plan plan_blocked123 --stdin
+```
+
+When generated preview artifacts are large, the response adds a compact `large` list and changes the first `next` hint so agents do not read large files or patches by default:
+
+```json
+{
+	"preview": {
+		"summary": "11 files; facade 11l; patch 2687l; cycles none",
+		"large": ["src/commerce/workflow.ts 1336l", "patch 2687l"],
+		"next": ["check summary/imports/exports before reading large preview artifacts", "copy preview if acceptable", "run project checks"]
+	}
+}
+```
+
+If runtime cycles are detected, the preview response warns and points the next action back at the plan instead of applying files.
+
+Preview artifacts are intentionally read-only planning outputs. They do not remove declarations from the source file or apply edits.
+
+`modulePlan apply` is the apply gate for a validated module plan. Its preview accepts the same layout shape as `modulePlan preview`, writes cached preview artifacts, and returns a compact apply summary instead of repeating the full module map:
+
+```powershell
+@'
+{
+  "sourceFile": "src/service.ts",
+  "facadeFile": "src/service.ts",
+  "modules": [
+    {
+      "targetFile": "src/core/types.ts",
+      "symbols": ["i-ServiceOptions", "t-ServiceMode"]
+    },
+    {
+      "targetFile": "src/core/service.ts",
+      "symbols": ["c-Service", "f-createService"]
+    }
+  ],
+  "execute": false
+}
+'@ | aib modulePlan apply --stdin
+```
+
+Compact preview:
+
+```json
+{
+	"operation": "modulePlan.apply",
+	"execute": false,
+	"planId": "plan_abc123",
+	"summary": "2 files; facade 2l; patch 120l; cycles none; public API preserved",
+	"targets": [
+		{
+			"file": "src/core/types.ts",
+			"summary": "exports i-ServiceOptions, t-ServiceMode"
+		},
+		{
+			"file": "src/core/service.ts",
+			"summary": "exports c-Service, f-createService; imports type ./types.js: i-ServiceOptions, t-ServiceMode"
+		}
+	],
+	"api": {
+		"status": "preserved",
+		"before": 4,
+		"after": 4,
+		"removed": [],
+		"added": []
+	},
+	"integrity": "2 declarations moved unchanged; 1 imports generated; facade exports 2",
+	"writes": ["src/core/types.ts", "src/core/service.ts", "src/service.ts"],
+	"warnings": [],
+	"next": "Run modulePlan apply plan_abc123 if the summary matches intent."
+}
+```
+
+Apply:
+
+```powershell
+aib modulePlan apply plan_abc123
+```
+
+Apply echoes the validation signals that matter after mutation:
+
+```json
+{
+	"operation": "modulePlan.apply",
+	"execute": true,
+	"applied": true,
+	"planId": "plan_abc123",
+	"api": { "status": "preserved", "before": 4, "after": 4 },
+	"cycles": "none",
+	"facade": { "file": "src/service.ts", "exports": 2 },
+	"integrity": "2 declarations moved unchanged; 1 imports generated; facade exports 2",
+	"filesWritten": ["src/core/types.ts", "src/core/service.ts", "src/service.ts"],
+	"summary": "3 files written"
+}
+```
+
+`integrity` summarizes the current module-plan mutation strategy: selected declarations are moved unchanged from original source ranges, while imports and facade exports are generated around those declarations.
+
+Inspect output intentionally avoids IDE/debug-only details in the agent-facing path:
+
+- file paths are relative to the CLI `cwd` when possible;
+- a shared file path is emitted once at response level instead of repeated on every result;
+- successful results omit noisy `ok: true` wrappers;
+- `--ranges` emits compact line metadata such as `l19 1260..1278`;
+- character offsets and `selectionRange` stay out of stdout; use trace/debug artifacts if exact IDE ranges are needed.
+
+Line metadata is 1-based and inclusive for human/agent navigation. Add `--ranges` only when line/range navigation is needed.
+
+## Workspace Config And Aliases
+
+Agent-facing command and selector aliases are fixed product defaults. The CLI ignores workspace-level selector alias overrides so agents can rely on one selector contract across repositories.
+
+CLI также умеет генерировать agent-facing usage instructions на основе effective config:
+
+```powershell
+aib --cwd D:\dev\agent-ide\fixtures\ts-sandbox init-skill-usage
+aib --cwd D:\dev\agent-ide\fixtures\ts-sandbox init-skill-usage --cli-name myagentcli
+```
+
+## Local Development
+
+Из корня workspace:
+
+```powershell
+cd D:\dev\agent-ide
+npm run cli:typecheck
+npm run cli:build
+npm run cli:link
+```
+
+После `npm link` команда доступна как:
+
+```powershell
+aib ping
+```
+
+## Local Tarball / npx-Oriented Flow
+
+Собрать локальный tarball:
+
+```powershell
+cd D:\dev\agent-ide
+npm run cli:pack
+```
+
+Tarball появится в:
+
+- `D:\dev\agent-ide\.tmp\aib-<version>.tgz`
+
+Дальше можно запускать CLI не через `npm link`, а через временную установку tarball.
+
+Пример:
+
+```powershell
+npx --yes --package D:\dev\agent-ide\.tmp\aib-0.0.1.tgz aib ping --cwd D:\dev\agent-ide
+```
+
+Это полезно как переходный локальный шаг перед будущим publishable `npx aib ...` flow.
+
+Примеры semantic-команд через tarball:
+
+```powershell
+npx --yes --package D:\dev\agent-ide\.tmp\aib-0.0.1.tgz aib imports importers fixtures\ts-sandbox\src\utils --cwd D:\dev\agent-ide
+npx --yes --package D:\dev\agent-ide\.tmp\aib-0.0.1.tgz aib imports unused fixtures\ts-sandbox\src\services\unused-imports.ts --cwd D:\dev\agent-ide
+```

package/dist/bin/aib.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),require("./cli");

package/dist/bin/cli.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+"use strict";var O=exports&&exports.__importDefault||function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(exports,"__esModule",{value:!0});const F=O(require("node:fs")),Z=O(require("node:path")),W=require("../payloads/read-stdin-json"),ee=require("../commands/doctor"),te=require("../commands/init-workspace"),j=require("../commands/inspect"),re=require("../commands/imports-command"),ne=require("../commands/config-command"),se=require("../commands/diagnostics-command"),ie=require("../commands/execution-command"),oe=require("../commands/feedback-command"),ae=require("../commands/observability-command"),ce=require("../commands/generate-docs-command"),ue=require("../commands/help-command"),de=require("../commands/runtime-command"),le=require("../commands/result-view"),fe=require("../commands/quick-read"),q=require("../commands/captured-input"),G=require("../commands/session-workspace"),U=require("../commands/session-workspace"),$=require("../config/path-aliases"),g=require("../session/client"),pe=require("../session/server"),me=require("../commands/module-plan-cache"),H=require("../config/resolve-command-alias"),_e=require("../config/auto-start-ide"),o=require("../config/env-vars"),B=require("../client/transport-options"),v=require("../shared/errors"),C=require("../shared/metrics"),J=require("../shared/presentation"),K=require("../tracing/config"),z=require("../tracing/trace"),Q=require("../runtime/input-source");function Ce(e){return e.ok===!1}let L=null,V=Date.now();function Ie(e){const t=[];let i=process.cwd(),r,E,N=process.env[o.CLI_ENV.metrics]==="1",p=(0,B.parseExtensionTransport)(process.env[o.CLI_ENV.transport])??void 0,m,y,I;for(let l=0;l<e.length;l+=1){const f=e[l];if(f){if(f==="--cwd"){const c=e[l+1];if(!c)throw new v.CliError("MISSING_FLAG_VALUE","Expected a value after --cwd.");i=c,l+=1;continue}if(f==="--instance"){const c=e[l+1];if(!c)throw new v.CliError("MISSING_FLAG_VALUE","Expected a value after --instance.");r=c,l+=1;continue}if(f==="--session"||f==="-s"){const c=e[l+1];if(!c)throw new v.CliError("MISSING_FLAG_VALUE",`Expected a value after ${f}.`);E=c,l+=1;continue}if(f==="--metrics"){N=!0;continue}if(f==="--dsl"||f==="--force-dsl"){I="dsl";continue}if(f==="--stdin-format"){const c=e[l+1];if(c!=="auto"&&c!=="dsl")throw new v.CliError("INVALID_STDIN_FORMAT","Expected --stdin-format to be auto or dsl.");I=c,l+=1;continue}if(f==="--trace-dir"){const c=e[l+1];if(!c)throw new v.CliError("MISSING_FLAG_VALUE","Expected a value after --trace-dir.");y=c,l+=1;continue}if(f==="--auto-start-ide"){m="serve-web";continue}if(f==="--no-auto-start-ide"){m="off";continue}if(f==="--transport"){const c=e[l+1],u=(0,B.parseExtensionTransport)(c);if(!u)throw new v.CliError("INVALID_TRANSPORT","Expected --transport to be either http or websocket.");p=u,l+=1;continue}t.push(f)}}const h=process.env[o.CLI_ENV.traceDir];return{commandArgs:t,cwd:i,instanceId:r,sessionId:E,metricsEnabled:N,transport:p,autoStartIde:(0,_e.resolveAutoStartIdePolicy)(m),trace:(0,K.resolveTraceConfig)(i,{...y!==void 0?{flagTraceDir:y}:{},...h!==void 0?{envTraceDir:h}:{}}),...I!==void 0?{stdinFormat:I}:{}}}async function Ee(){V=Date.now();const e=(0,C.metricsNow)(),t=[],{commandArgs:i,cwd:r,instanceId:E,sessionId:N,metricsEnabled:p,transport:m,autoStartIde:y,trace:I,stdinFormat:h}=Ie(process.argv.slice(2));await(0,U.runWithSessionOverride)(N,async()=>{const[l,...f]=i,c=(0,W.stripStdinFormatFlags)(f),u=c.restArgs,X=(0,C.metricsNow)(),s=await(0,H.resolveCanonicalCommandAlias)(l??"ping",r,E,y);if(p&&(0,C.recordSpan)(t,"cli.aliasResolution",X),(0,H.isRemovedAgentCommand)(s))throw new v.CliError("UNKNOWN_COMMAND",`Unknown command: ${s}`,{availableCommands:["doctor","diagnostics","listInstances","ping","runtimeInfo","printConfig","init-skill-usage","init","help","generate-docs","config","qr","sync","inspect","imports","view","execution","move","rename","refactor","modulePlan","session","runtime","trace","observability","feedback","note"]});if(s==="session"&&(u[0]??"status")==="serve"){await(0,pe.runSessionServerCli)();return}if(s==="trace"){const n=(0,K.runTraceCommand)(r,u,I);d(n);return}if(s==="diagnostics"){await(0,se.runDiagnosticsCommand)(u);return}if(s==="observability"){x(r,s,u,I);const n=(0,ae.runObservabilityCommand)(r,u);d(n);return}if(s==="feedback"||s==="note"){x(r,s,u,I);const n=(0,oe.runFeedbackCommand)(r,u,s);d(n);return}if(s==="init"){const n=(0,te.runInitWorkspace)(r,u);d(n);return}if(s==="help"){const n=(0,ue.runHelpCommand)(u);d(n);return}if(s==="generate-docs"){const n=(0,ce.runGenerateDocsCommand)(r,u);d(n);return}if(s==="config"){x(r,s,u,I);const n=(0,ne.runConfigCommand)(r,u);d(n);return}if(s==="runtime"){const n=await(0,de.runRuntimeCommand)(r,u);n.ok===!1&&(process.exitCode=1),d(n);return}if(s==="qr"){x(r,s,u,I);const n=await(0,fe.runQuickReadCommand)(r,u);n.ok===!1&&(process.exitCode=1),d(n);return}const D=ye(s,u),P=D?(0,U.readEffectiveSessionPathAliases)(r):{},a=D?(0,$.expandPathAliasesInArgs)(r,u,P):u,A=await(0,Q.resolveCommandInputSource)({command:s,cwd:r,restArgs:a,readStdinInput:()=>(0,W.readStdinPayloadWithSource)({command:s,restArgs:a,...c.format!==void 0||h!==void 0?{format:c.format??h}:{}})}),_=D?(0,$.expandPathAliasesInJson)(r,A.payload,P):A.payload;if(L=(0,z.startTrace)({cwd:r,argv:process.argv.slice(2),command:s,restArgs:a,...I.absoluteTraceDir!==void 0?{traceDir:I.absoluteTraceDir}:I.traceDir!==void 0?{traceDir:I.traceDir}:{},..._!==void 0?{stdinPayload:_}:{},startedAtMs:V}),s==="session"){const n=a[0]??"status";if(n==="init"||n==="clear"||n==="where"||n==="read"||n==="write"||n==="prefs"||n==="aliases"||n==="list"||n==="use"){const S=(0,G.runSessionWorkspaceCommand)(r,a,_);d(S);return}if(n==="status"){const S=(0,G.runSessionWorkspaceCommand)(r,a,_),b=await(0,g.getSessionStatus)();d({...S,runtime:Ae(b)});return}if(n==="start"){const S=await(0,g.startSession)();d(S);return}if(n==="stop"){const S=await(0,g.stopSession)();d(S);return}throw new v.CliError("UNKNOWN_SESSION_COMMAND",`Unknown aib session command: ${n}`)}if(s==="imports"&&a[0]==="normalize"){const n=(0,q.attachCapturedInput)(r,"imports",_,await(0,re.runImportsCommand)(r,a,_,{...E!==void 0?{explicitInstanceId:E}:{},autoStartIde:y,...m!==void 0?{transport:m}:{},...p?{metricsEnabled:!0}:{}},p?t:void 0),A.source);d(n);return}if(s==="execution"){const n=(0,ie.runExecutionCommand)(r,a);d(n);return}if(s==="view"){const n=(0,le.runResultViewCommand)(r,a,_);d(n);return}if(s==="doctor"){const n=await(0,ee.runDoctor)({cwd:r,runtime:a.includes("--runtime"),verbose:a.includes("--verbose"),json:a.includes("--json")});n.ok===!1&&(process.exitCode=1),d(n);return}if(s==="inspect"&&(a[0]==="graph"||a[0]==="tree"||a[0]==="cycles")){const n=(0,C.metricsNow)(),S=a[0]==="tree"?"tree":a[0]==="cycles"?"cycles":"graph",b=(0,q.attachCapturedInput)(r,S,_,await(0,j.runInspect)(r,a,_,{...E!==void 0?{explicitInstanceId:E}:{},autoStartIde:y,...m!==void 0?{transport:m}:{},...p?{metricsEnabled:!0}:{}}),A.source);p&&((0,C.recordSpan)(t,"cli.inspectGraph",n),(0,C.recordSpan)(t,"cli.total",e)),d(p?(0,C.appendMetrics)(b,t):b,m);return}if(s==="inspect"&&a.includes("--stdin")&&Ne(_)){const n=(0,C.metricsNow)(),S=(0,q.attachCapturedInput)(r,he(_),_,await(0,j.runInspect)(r,a,_,{...E!==void 0?{explicitInstanceId:E}:{},autoStartIde:y,...m!==void 0?{transport:m}:{},...p?{metricsEnabled:!0}:{}}),A.source);p&&((0,C.recordSpan)(t,"cli.inspectLocal",n),(0,C.recordSpan)(t,"cli.total",e)),d(p?(0,C.appendMetrics)(S,t):S,m);return}if((0,Q.commandRequiresPayload)(s,a,A))throw new v.CliError("STDIN_REQUIRED",`${s} currently expects a payload on stdin or --from.`);const w={command:s,restArgs:a,cwd:r},M=we(s,a);M&&(w.modulePlanExecutionId=M),N!==void 0&&(w.sessionId=N),E!==void 0&&(w.instanceId=E),_!==void 0&&(w.stdinPayload=_),A.source!==void 0&&(w.stdinInputSource=A.source),p&&(w.metricsEnabled=!0),m&&(w.transport=m),w.autoStartIde=y.mode;const k=Se();Object.keys(k).length>0&&(w.env=k);const Y=(0,C.metricsNow)(),T=await(0,g.callSession)(w,p?t:void 0);p&&((0,C.recordSpan)(t,"cli.callSession",Y),(0,C.recordSpan)(t,"cli.total",e));const R=p?(0,C.appendMetrics)(T,t):T;Ce(R)&&(process.exitCode=1),d(R,m)})}function Se(){const e=[o.CLI_ENV.managedHostScript,o.CLI_ENV.managedHostKind,o.CLI_ENV.managedHostRunDir,o.CLI_ENV.codeServerPath,o.CLI_ENV.extensionVsix,o.CLI_ENV.ideCommand,o.CLI_ENV.chromePath,o.CLI_ENV.managedHostWaitMs,o.CLI_ENV.workspaceRoot,o.CLI_ENV.disableWatchers,o.CLI_ENV.trace,o.CLI_ENV.traceDir,o.CLI_ENV.failureSnapshots,o.CLI_ENV.productStorageDir,o.CLI_ENV.metrics,o.CLI_ENV.metricsDir,o.CLI_ENV.metricsTag,o.CLI_ENV.mutationImpactMetrics,o.CLI_ENV.mutationImpactStream,o.CLI_ENV.testPostMutationCyclesDelayMs,o.CLI_ENV.testRefactorBatchDelayMs,o.CLI_ENV.testRenameDelayMs,o.CLI_ENV.modulePlanSyncWaitMs,o.CLI_ENV.refactorBatchSyncWaitMs,o.CLI_ENV.renameSyncWaitMs],t={};for(const i of e){const r=process.env[i];r!==void 0&&(t[i]=r)}return t}function we(e,t){if(e!=="modulePlan")return null;const i=t[0]??"";return i!=="execute"&&i!=="apply"?null:ve()??(0,me.buildModulePlanExecutionId)()}function ve(){const e=process.env.AIB_MODULE_PLAN_EXECUTION_ID;return e&&/^exec_[a-z0-9_-]+$/i.test(e)?e:null}function x(e,t,i,r){L=(0,z.startTrace)({cwd:e,argv:process.argv.slice(2),command:t,restArgs:i,...r.absoluteTraceDir!==void 0?{traceDir:r.absoluteTraceDir}:r.traceDir!==void 0?{traceDir:r.traceDir}:{},startedAtMs:V})}function ye(e,t){return e==="session"||e==="execution"||e==="observability"||e==="doctor"||e==="view"||e==="imports"&&t[0]==="normalize"||e==="inspect"&&(t[0]==="graph"||t[0]==="tree"||t[0]==="cycles"||t[0]==="imports"||t.includes("--stdin"))}function Ae(e){if(e.running===!0){const t=e.session&&typeof e.session=="object"&&!Array.isArray(e.session)?e.session:{},i=typeof t.pid=="number"?` pid ${t.pid}`:"",r=typeof t.port=="number"?` port ${t.port}`:"";return`running${i}${r}`.trim()}return e.processAlive===!0&&e.healthy===!1?"unhealthy":"stopped"}function Ne(e){return!e||typeof e!="object"||Array.isArray(e)?!1:e.op==="tree"||e.op==="cycles"||e.op==="imports"?!0:Array.isArray(e.requests)&&e.requests.some(t=>t&&typeof t=="object"&&!Array.isArray(t)&&(t.op==="tree"||t.op==="cycles"||t.op==="imports"))}function he(e){if(!e||typeof e!="object"||Array.isArray(e))return"inspect";const t=Array.isArray(e.requests)?e.requests.filter(i=>i&&typeof i=="object"&&!Array.isArray(i)):[e];return t.every(i=>i.op==="cycles")?"cycles":t.every(i=>i.op==="tree")?"tree":t.every(i=>i.op==="imports")?"imports":"inspect"}Ee().catch(e=>{const t=(0,v.errorPayload)(e);d(t),process.exitCode=1});function d(e,t){const i=(0,J.createCliPresentationEnvelope)(e);L?.enabled&&L.complete({output:i.tracePayload,exitCode:e.ok===!1?1:be(process.exitCode),durationMs:Date.now()-V,...t?{transport:t}:{}});const r=process.env.AIB_CANONICAL_JSON_PATH;r&&(F.default.mkdirSync(Z.default.dirname(r),{recursive:!0}),F.default.writeFileSync(r,`${JSON.stringify(i.tracePayload,null,2)}
+`)),process.stdout.write((0,J.presentCliEnvelope)(i,process.env.AIB_FORCE_JSON==="1"?"json":"agent"))}function be(e){return typeof e=="number"?e:0}

package/dist/client/http-client.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.postJson=E;const c=require("../shared/errors"),d=require("./transport-options"),l=require("./websocket-client");async function E(e,r,n,u={}){const a=p(n,u);if((u.transport??(0,d.getPreferredTransport)())==="websocket")return(0,l.postJsonOverWebSocket)(e,r,a);const o=`http://${e.host}:${e.port}${r}`;let s;try{s=await fetch(o,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(a)})}catch(t){throw new c.CliError("TRANSPORT_ERROR",`Failed to reach ${o}`,{url:o,cause:t instanceof Error?t.message:String(t)})}const f=await s.text();let i={};try{i=JSON.parse(f)}catch{throw new c.CliError("INVALID_JSON_RESPONSE",`Instance returned non-JSON response for ${r}`,{url:o,status:s.status,responseText:f})}if(!s.ok){const t=w(i);throw t?new c.CliError(t.code,t.message,{url:o,status:s.status,details:t.details}):new c.CliError("REMOTE_ERROR",`Instance returned ${s.status} for ${r}`,{url:o,status:s.status,payload:i})}return i}function p(e,r){return r.metricsEnabled!==!0||!e||typeof e!="object"||Array.isArray(e)?e:{...e,metricsEnabled:!0}}function w(e){return e.ok!==!1||typeof e.code!="string"?null:{code:e.code,message:typeof e.error=="string"?e.error:e.code,details:e.details??R(e)}}function R(e){const r={};for(const n of["hint","hints","sourceFile","targetFile","execute","candidates","sourceConsistency","diagnostic","symbol","newName"])e[n]!==void 0&&(r[n]=e[n]);return r}

package/dist/client/transport-options.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.parseExtensionTransport=t,exports.getPreferredTransport=s,exports.setPreferredTransport=o;const n=require("../config/env-vars");let e=t(process.env[n.CLI_ENV.transport])??"http";function t(r){return r==="http"||r==="websocket"?r:null}function s(){return e}function o(r){e=r}

package/dist/client/websocket-client.js

@@ -0,0 +1 @@
+"use strict";var c=exports&&exports.__importDefault||function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(exports,"__esModule",{value:!0}),exports.postJsonOverWebSocket=f;const l=c(require("ws")),n=require("../shared/errors"),E=require("../shared/routes");async function f(e,t,u){const i=E.EXTENSION_ROUTE_OPERATIONS[t];if(!i)throw new n.CliError("UNSUPPORTED_WEBSOCKET_ROUTE",`Route is not available over WebSocket: ${t}`,{pathname:t});const o=e.transports?.websocket?.url??`ws://${e.host}:${e.port}/ws`,r=await d(o,{id:Date.now(),operation:i,body:u});if(r.payload&&typeof r.payload=="object"&&!Array.isArray(r.payload)){const s=r.payload;if(r.ok===!1||typeof r.statusCode=="number"&&r.statusCode>=400){const a=S(s);throw a?new n.CliError(a.code,a.message,{url:o,status:typeof r.statusCode=="number"?r.statusCode:null,details:a.details}):new n.CliError("REMOTE_ERROR",`Instance returned ${String(r.statusCode??"error")} for ${t}`,{url:o,status:typeof r.statusCode=="number"?r.statusCode:null,payload:s})}return s}throw new n.CliError("INVALID_WEBSOCKET_RESPONSE",`Instance returned an invalid WebSocket payload for ${t}`,{url:o,envelope:r})}function d(e,t){return new Promise((u,i)=>{const o=new l.default(e);o.once("open",()=>{o.send(JSON.stringify(t))}),o.once("message",r=>{try{u(JSON.parse(r.toString("utf8")))}catch(s){i(new n.CliError("INVALID_WEBSOCKET_RESPONSE",`Instance returned non-JSON WebSocket response for ${e}`,{url:e,cause:s instanceof Error?s.message:String(s)}))}finally{o.close()}}),o.once("error",r=>{i(new n.CliError("TRANSPORT_ERROR",`Failed to reach ${e}`,{url:e,cause:r.message}))})})}function S(e){return e.ok!==!1||typeof e.code!="string"?null:{code:e.code,message:typeof e.error=="string"?e.error:e.code,details:e.details??null}}

package/dist/commands/add-missing-imports-preview-cache.js

@@ -0,0 +1,2 @@
+"use strict";var f=exports&&exports.__createBinding||(Object.create?(function(r,e,t,i){i===void 0&&(i=t);var n=Object.getOwnPropertyDescriptor(e,t);(!n||("get"in n?!e.__esModule:n.writable||n.configurable))&&(n={enumerable:!0,get:function(){return e[t]}}),Object.defineProperty(r,i,n)}):(function(r,e,t,i){i===void 0&&(i=t),r[i]=e[t]})),d=exports&&exports.__setModuleDefault||(Object.create?(function(r,e){Object.defineProperty(r,"default",{enumerable:!0,value:e})}):function(r,e){r.default=e}),c=exports&&exports.__importStar||(function(){var r=function(e){return r=Object.getOwnPropertyNames||function(t){var i=[];for(var n in t)Object.prototype.hasOwnProperty.call(t,n)&&(i[i.length]=n);return i},r(e)};return function(e){if(e&&e.__esModule)return e;var t={};if(e!=null)for(var i=r(e),n=0;n<i.length;n++)i[n]!=="default"&&f(t,e,i[n]);return d(t,e),t}})();Object.defineProperty(exports,"__esModule",{value:!0}),exports.buildAddMissingImportsPreviewId=g,exports.buildAddMissingImportsPreviewHash=y,exports.readAddMissingImportsPreviewRecord=P,exports.writeAddMissingImportsPreviewRecord=m,exports.hashFiles=w;const l=c(require("node:crypto")),s=c(require("node:fs")),h=c(require("node:path")),p=require("../shared/errors"),_=require("./workspace-cache");function g(r){return`imports_${o(u(r)).slice(0,10)}`}function y(r,e,t){return`sha256:${o(u({normalizedPayload:r,fileHashes:e,summary:t.summary,files:t.files}))}`}function P(r,e){const t=a(r,e);if(!s.existsSync(t))throw new p.CliError("ADD_MISSING_IMPORTS_PREVIEW_NOT_FOUND",`Add missing imports preview not found: ${e}`,{previewId:e,expectedPath:t});return JSON.parse(s.readFileSync(t,"utf8"))}function m(r,e){const t=a(r,e.previewId);s.mkdirSync(h.dirname(t),{recursive:!0}),s.writeFileSync(t,`${JSON.stringify(e,null,2)}
+`)}function w(r){const e={};for(const t of r)e[t]=s.existsSync(t)?o(s.readFileSync(t)):"missing";return e}function a(r,e){return(0,_.workspaceCachePath)(r,"add-missing-imports-previews",`${b(e)}.json`)}function o(r){return l.createHash("sha256").update(r).digest("hex")}function u(r){return r===null||typeof r!="object"?JSON.stringify(r):Array.isArray(r)?`[${r.map(e=>u(e)).join(",")}]`:`{${Object.entries(r).sort(([e],[t])=>e.localeCompare(t)).map(([e,t])=>`${JSON.stringify(e)}:${u(t)}`).join(",")}}`}function b(r){return r.replace(/[^a-z0-9_-]+/gi,"-")}

package/dist/commands/add-missing-imports.js

@@ -0,0 +1,2 @@
+"use strict";var R=exports&&exports.__createBinding||(Object.create?(function(t,e,i,r){r===void 0&&(r=i);var n=Object.getOwnPropertyDescriptor(e,i);(!n||("get"in n?!e.__esModule:n.writable||n.configurable))&&(n={enumerable:!0,get:function(){return e[i]}}),Object.defineProperty(t,r,n)}):(function(t,e,i,r){r===void 0&&(r=i),t[r]=e[i]})),D=exports&&exports.__setModuleDefault||(Object.create?(function(t,e){Object.defineProperty(t,"default",{enumerable:!0,value:e})}):function(t,e){t.default=e}),x=exports&&exports.__importStar||(function(){var t=function(e){return t=Object.getOwnPropertyNames||function(i){var r=[];for(var n in i)Object.prototype.hasOwnProperty.call(i,n)&&(r[r.length]=n);return r},t(e)};return function(e){if(e&&e.__esModule)return e;var i={};if(e!=null)for(var r=t(e),n=0;n<r.length;n++)r[n]!=="default"&&R(i,e,r[n]);return D(i,e),i}})();Object.defineProperty(exports,"__esModule",{value:!0}),exports.runAddMissingImports=C;const y=x(require("node:path")),h=require("zod"),j=require("../client/http-client"),I=require("../shared/agent-text"),f=require("../shared/errors"),$=require("../shared/protocol"),F=require("../shared/routes"),M=require("./shared"),d=require("./add-missing-imports-preview-cache"),v=h.z.object({scope:h.z.string().min(1),execute:h.z.boolean().optional()});async function C(t,e,i={},r=[]){const n=r[0]??"preview";if(n==="help"||n==="--help")return{command:"imports addMissing",usage:["aib imports addMissing preview <file-or-dir>","aib imports addMissing apply <previewId>","aib imports addMissing execute <file-or-dir>"]};if(n==="apply"){const s=r[1];if(!s||s.startsWith("--"))throw new f.CliError("ADD_MISSING_IMPORTS_PREVIEW_ID_REQUIRED","imports addMissing apply expects a preview id.",{usage:"aib imports addMissing apply <previewId>"});return T(t,s,i)}const c=W(r),a=O(e??c,n==="execute");return b(t,a,i)}async function T(t,e,i){const r=(0,d.readAddMissingImportsPreviewRecord)(t,e),n=(0,d.hashFiles)(Object.keys(r.fileHashes));for(const[u,o]of Object.entries(r.fileHashes))if(n[u]!==o)throw new f.CliError("ADD_MISSING_IMPORTS_PREVIEW_FILES_CHANGED","Files changed after imports addMissing preview. Rerun preview.",{previewId:e,file:m(t,u)});const c=v.parse({...r.normalizedPayload,execute:!0}),s={...await b(t,c,i,e),operation:"imports.addMissing.apply"};return(0,I.attachAgentText)(s,A(s))}async function b(t,e,i,r){const n=await(0,M.resolveCompatibleTargetInstance)(t,$.CLI_COMMAND_IDS.addMissingImports,i),c=e.execute===!0,a=await(0,j.postJson)(n.entry,F.EXTENSION_ROUTES.addMissingImports,{scope:e.scope,execute:c},(0,M.extensionRequestOptions)(i)),s=q(t,a,c,r);if(!c&&s.ok!==!1){const u=O(e,!1),o=(0,d.buildAddMissingImportsPreviewId)(u),S=Array.isArray(s.allTouchedFiles)?s.allTouchedFiles.filter(E=>typeof E=="string"):[],_=(0,d.hashFiles)(S),w=(0,d.buildAddMissingImportsPreviewHash)(u,_,s);(0,d.writeAddMissingImportsPreviewRecord)(t,{previewId:o,previewHash:w,createdAt:new Date().toISOString(),cwd:y.resolve(t),normalizedPayload:u,fileHashes:_,previewResult:s}),s.previewId=o,s.next=`aib imports addMissing apply ${o}`}return(0,I.attachAgentText)(s,A(s))}function q(t,e,i,r){if(e.ok===!1)return e;const c=(Array.isArray(e.files)?e.files.filter(z):[]).filter(o=>l(o,"editCount")>0),a=Array.isArray(e.changedFiles)?e.changedFiles.filter(o=>typeof o=="string"):c.map(o=>typeof o.file=="string"?o.file:"").filter(Boolean),s=a.map(o=>m(t,o));return H({operation:r?"imports.addMissing.apply":i?"imports.addMissing.execute":"imports.addMissing.preview",scope:typeof e.scope=="string"?m(t,e.scope):null,summary:N(i,l(e,"changedFileCount"),l(e,"editCount"),l(e,"fileCount")),files:i?null:P(s,8),filesWritten:i?P(s,8):null,allTouchedFiles:a,fileCount:l(e,"fileCount"),changedFileCount:l(e,"changedFileCount"),editCount:l(e,"editCount"),previewId:r??null})}function N(t,e,i,r){return i===0?`${r} ${g(r,"file")} checked, no missing imports fixed`:`${t?`${e} ${g(e,"file")} written`:`${e} ${g(e,"file")} with edits`}, ${i} ${g(i,"edit")}`}function A(t){const e=[],i=typeof t.operation=="string"?t.operation:"imports.addMissing",r=typeof t.previewId=="string"&&i.endsWith(".preview")?` ${t.previewId}`:"";e.push(`${i}${r}`),typeof t.scope=="string"&&e.push(t.scope),typeof t.summary=="string"&&e.push(t.summary);const n=Array.isArray(t.filesWritten)?t.filesWritten:Array.isArray(t.files)?t.files:[];for(const c of n)typeof c=="string"&&e.push(c);return typeof t.next=="string"&&e.push(`next: ${t.next}`),e.join(`
+`)}function W(t){const e=t[0]??"preview",i=t.slice(1).find(r=>!r.startsWith("--"));return i?{scope:i,execute:e==="execute"}:void 0}function O(t,e){if(!t||typeof t!="object"||Array.isArray(t))throw new f.CliError("ADD_MISSING_IMPORTS_SCOPE_REQUIRED","imports addMissing expects a file or directory scope.");const i=t,r=p(i.scope)??p(i.file)??p(i.dir)??p(i.directory);if(!r)throw new f.CliError("ADD_MISSING_IMPORTS_SCOPE_REQUIRED","imports addMissing expects scope, file, dir, or directory.");const n=v.parse({scope:r,execute:e||i.execute===!0});return{scope:n.scope,execute:n.execute===!0}}function P(t,e){return t.length<=e?t:[...t.slice(0,e),`+ ${t.length-e} more`]}function H(t){const e={};for(const[i,r]of Object.entries(t))r!=null&&(e[i]=r);return e}function z(t){return!!t&&typeof t=="object"&&!Array.isArray(t)}function p(t){return typeof t=="string"&&t.trim()!==""?t.trim():null}function l(t,e){const i=t[e];return typeof i=="number"&&Number.isFinite(i)?i:0}function m(t,e){const i=y.relative(t,e);return i&&!i.startsWith("..")&&!y.isAbsolute(i)?i.replace(/\\/g,"/"):e.replace(/\\/g,"/")}function g(t,e){return t===1?e:`${e}s`}