@automaton-labs/aib 0.0.7 → 0.0.8

package/README.md

@@ -1,19 +1,16 @@
 # aib CLI
 
-CLI для подключения к живому `aib` extension instance.
+Node-native CLI для анализа и изменения TypeScript/JavaScript workspace.
 
 Текущая цель пакета:
 
-- discovery instance по локальному registry;
-- session runtime, который переиспользуется между вызовами;
-- базовые debug-команды;
-- semantic operations поверх extension runtime.
+- локальная session/workspace модель;
+- standalone inspect/import/mutation workers;
+- execution journal и восстановление owned workers;
+- Node-only packaging без IDE, VSIX и браузера.
 
 ## Current Commands
 
-- `aib listInstances`
-- `aib ping`
-- `aib runtimeInfo`
 - `aib printConfig`
 - `aib init-skill-usage`
 - `aib inspect file <file> [--ranges] [--local-only]`
@@ -23,46 +20,27 @@ CLI для подключения к живому `aib` extension instance.
 - `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 mutate preview --stdin`
+- `aib mutate apply <previewId>`
+- `aib mutate execute --stdin`
 - `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.
+- `--cwd <path>`: выбрать корень workspace.
 - `--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.
@@ -77,7 +55,7 @@ Enable it for a trial session:
 
 ```powershell
 $env:AIB_TRACE_DIR = ".aib-trace"
-aib move toFile preview --stdin
+aib mutate preview --stdin
 ```
 
 Enable it for the current project so it survives new shells:
@@ -264,250 +242,51 @@ Batch reads avoid repeated CLI calls:
 '@ | 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:
+## Mutate
+
+Use `mutate` for semantic and file mutations. `preview` validates intent and returns a preview id, `apply` applies that preview id, and `execute` performs the same mutation directly from input:
 
 ```powershell
 @'
 {
-  "file": "src/service.ts",
-  "op": "modulePlan",
-  "facade": "src/service.ts",
-  "modules": [
-    {
-      "target": "src/core/types.ts",
-      "symbols": ["i-ServiceOptions", "t-ServiceMode"]
-    },
+  "segments": [
     {
-      "target": "src/core/service.ts",
-      "symbols": ["c-Service", "f-createService"]
+      "kind": "modulePlan",
+      "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"]
+        }
+      ]
     }
   ]
 }
-'@ | 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
+'@ | aib mutate preview --stdin
 ```
 
-After apply, run a compact generated-module validation:
+Apply the preview if it matches intent:
 
 ```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"
-}
+aib mutate apply mutate_abc123
 ```
 
-Revise a blocked plan without resending the full module JSON:
+Or execute directly:
 
 ```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"
-}
+@source src/service.ts
+module src/core/types.ts: i-ServiceOptions t-ServiceMode
+module src/core/service.ts: c-Service f-createService
+'@ | aib mutate execute --stdin
 ```
 
-`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.
+The mutation response keeps a per-row result model so the caller can distinguish completed, partial, blocked, and failed outcomes without relying on legacy `plan_*` or `batch_*` command ids.
 
 Inspect output intentionally avoids IDE/debug-only details in the agent-facing path:
 

package/config/agent-dx-policy.default.json

@@ -0,0 +1,31 @@
+{
+  "schemaVersion": 1,
+  "storage": {
+    "observationWindowMs": 900000,
+    "observationMaxCount": 200
+  },
+  "signals": {
+    "repeatedQrBatch": {
+      "enabled": true,
+      "windowMs": 3000,
+      "minCount": 3,
+      "cooldownMs": 600000,
+      "maxExampleItems": 3,
+      "maxExampleChars": 240
+    },
+    "qrOveruseTsJs": {
+      "enabled": true,
+      "windowMs": 600000,
+      "targetMinCount": 6,
+      "cooldownMs": 900000
+    },
+    "inspectDslNudge": {
+      "enabled": true,
+      "windowMs": 30000,
+      "minCount": 3,
+      "cooldownMs": 600000,
+      "maxExampleItems": 3,
+      "maxExampleChars": 320
+    }
+  }
+}

package/config/control-plane-client.default.json

@@ -0,0 +1,3 @@
+{
+  "schemaVersion": 1
+}