@automaton-labs/aib 0.0.5 → 0.0.7

package/dist/help/topics/qr.md

@@ -9,27 +9,12 @@ For focused text reads, prefer qr over cat/Get-Content/type, especially when ali
 Use shell reads only when piping into shell tooling or qr is unavailable.
 
 Controls:
--h N    head; first N lines
--t N    tail; last N lines
--o N    offset; starting line, 1-based
--l N    limit; line count for offset reads
--a      all; whole file
+h=N        head; first N lines
+t=N        tail; last N lines
+o=N l=N    range; starting line and line count
+all        whole file
 
-If no window is provided, qr uses -h 80.
-If -a is present, it wins over other window flags.
+If no window is provided, qr uses h=80.
+If all is present, it wins over other window flags.
 
-Run:
-aib qr --stdin
-
-Input:
-qr @scripts/a.txt h=80
-qr @scripts/b.py o=300 l=50
-qr @scripts/c.md t=120
-qr @logs/app.log all
-
-Inline:
-aib qr @scripts/a.txt -h 80
-aib qr @scripts/b.py -o 300 -l 50
-aib qr @logs/app.log -a
-
-Use stdin for several reads.
+{{qr.inline.examples}}

package/dist/help/topics/quick-map.md

@@ -1,5 +1,6 @@
 Read:
   qr              quick reads: ts, js, cmd, sh, json, log, txt, etc.
+  rg              use `aib rg -- <args>` instead of `rg <args>`
   view            hidden/truncated output
 
 Inspect:

package/dist/help/topics/recipe.file-layout.md

@@ -0,0 +1,13 @@
+Assumption:
+You are changing whole-file layout.
+You are not moving TypeScript declarations or renaming TypeScript symbols.
+
+Related topics:
+aib help mutation file.move file.rename
+
+If you only need to move files, do not read file.rename.
+If you only need to rename files, do not read file.move.
+
+Use focused topic syntax to express the file layout refactor.
+Do not move or rename files manually.
+Use AIB file mutations so references/imports are updated.

package/dist/help/topics/rg.md

@@ -0,0 +1,20 @@
+aib rg
+
+Run ripgrep through AIB.
+
+Regular rg:
+  rg <args>
+
+AIB rg:
+  aib rg -- <args>
+
+Everything after `--` is passed as normal ripgrep arguments.
+Use the same args you would pass to `rg`.
+Use normal paths in input. Do not use AIB path aliases here.
+
+Examples:
+  rg -n "TODO" src/core
+  aib rg -- -n "TODO" src/core
+
+  rg -n --column "SomeValue" ws/commands ws/config
+  aib rg -- -n --column "SomeValue" ws/commands ws/config

package/dist/help/topics/selectors.md

@@ -16,6 +16,7 @@ c-Name  class
 i-Name  interface
 t-Name  type
 v-name  variable
-e-Name  enum
-m-name  method, usually with parent
+e-Name  enum
+ns-Name namespace
+m-name  method, usually with parent
 p-name  property, usually with parent

package/dist/help/topics/session.md

@@ -2,7 +2,7 @@ Start by creating or selecting your session.
 Create it once, then reuse it.
 Do not create a new session for every command or subtask.
 
-Session stores saved artifacts, aliases, and prefs.
+Session stores saved artifacts and aliases.
 
 Prefer short session names:
 aa, tr, qa, a2

package/dist/host/capabilities.js

@@ -0,0 +1 @@
+"use strict";var o=exports&&exports.__importDefault||function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(exports,"__esModule",{value:!0}),exports.AIB_SUPPORTED_ACTIVATION_POLICIES=exports.AIB_SUPPORTED_INVOKE_MODES=exports.AIB_HOST_CAPABILITIES=exports.AIB_WORKER_ABI=void 0,exports.readHostCapabilities=i;const a=o(require("node:fs")),r=o(require("node:path"));exports.AIB_WORKER_ABI="1",exports.AIB_HOST_CAPABILITIES=["productStorage","jsonStdout","traceUploadLedger","backgroundSchedule","policyConfig","workerRegistry","workerBundleOta","cliPackageOta"],exports.AIB_SUPPORTED_INVOKE_MODES=["structured","process","stream"],exports.AIB_SUPPORTED_ACTIVATION_POLICIES=["ota-activation","cli-package-activation","extension-vsix-activation","ota-watch","ota-cleanup"];function i(e=n()){return{schemaVersion:1,hostVersion:s(e),workerAbi:exports.AIB_WORKER_ABI,platform:process.platform,arch:process.arch,nodeRuntime:`node-${process.versions.node.split(".")[0]}`,launcherProtocol:"1",daemonInvokeProtocol:"http-session-v1",supportedInvokeModes:exports.AIB_SUPPORTED_INVOKE_MODES,productStorageSchema:1,supportedActivationPolicies:exports.AIB_SUPPORTED_ACTIVATION_POLICIES,runtime:"cjs-node20",capabilities:exports.AIB_HOST_CAPABILITIES}}function n(){return r.default.resolve(__dirname,"..","..")}function s(e){try{const t=JSON.parse(a.default.readFileSync(r.default.join(e,"package.json"),"utf8"));return typeof t.version=="string"&&t.version.trim()?t.version:"0.0.0"}catch{return"0.0.0"}}

package/dist/ide-launch/common.cjs

@@ -1,162 +1,162 @@
-const fs = require("node:fs");
-const os = require("node:os");
-const path = require("node:path");
-const { spawnSync } = require("node:child_process");
-
-const rootDir = path.resolve(__dirname, "..", "..");
-const defaultFixtureDir = path.join(rootDir, "fixtures", "ts-sandbox");
-const defaultVsixPath = path.join(rootDir, ".tmp", "vscode-refactor-bridge-extension.vsix");
-const defaultRunsDir = path.join(rootDir, ".tmp", "ide-launch-runs");
-
-function timestampForPath() {
-  return new Date().toISOString().replace(/[:.]/g, "-");
-}
-
-function ensureDir(dirPath) {
-  fs.mkdirSync(dirPath, { recursive: true });
-}
-
-function writeJson(filePath, payload) {
-  ensureDir(path.dirname(filePath));
-  fs.writeFileSync(filePath, `${JSON.stringify(payload, null, 2)}\n`);
-}
-
-function run(command, args, options = {}) {
-  const startedAt = Date.now();
-  const spawnCommand = prepareSpawnCommand(command, args, options);
-  const result = spawnSync(spawnCommand.command, spawnCommand.args, {
-    cwd: options.cwd ?? rootDir,
-    env: buildEnv(options.env),
-    input: options.input,
-    encoding: "utf8",
-    windowsHide: true,
-    windowsVerbatimArguments: spawnCommand.windowsVerbatimArguments ?? false,
-    timeout: options.timeoutMs ?? 30_000,
-    shell: options.shell ?? false,
-    stdio: ["pipe", "pipe", "pipe"]
-  });
-
-  return {
-    command,
-    args,
-    status: result.status,
-    signal: result.signal,
-    error: result.error ? result.error.message : null,
-    stdout: result.stdout ?? "",
-    stderr: result.stderr ?? "",
-    durationMs: Date.now() - startedAt
-  };
-}
-
-function buildEnv(overrides) {
-  if (!overrides) {
-    return process.env;
-  }
-
-  const env = { ...process.env };
-  for (const [key, value] of Object.entries(overrides)) {
-    if (value === null || value === undefined) {
-      delete env[key];
-      continue;
-    }
-    env[key] = String(value);
-  }
-  return env;
-}
-
-function resolveIdeCommand(options) {
-  if (options.ideCommand) {
-    return options.ideCommand;
-  }
-
-  return resolveCommandFromPath(options.ide === "cursor" ? "cursor" : "code");
-}
-
-function isWindowsCommandScript(command) {
-  const extension = path.extname(command).toLowerCase();
-  return extension === ".cmd" || extension === ".bat";
-}
-
-function quoteCmdArg(value) {
-  const raw = String(value);
-  return `"${raw.replace(/"/g, '\\"')}"`;
-}
-
-function prepareSpawnCommand(command, args, options = {}) {
-  if (process.platform !== "win32" || options.shell !== undefined || !isWindowsCommandScript(command)) {
-    return { command, args };
-  }
-
-  return {
-    command: "cmd.exe",
-    args: ["/d", "/s", "/c", ["call", quoteCmdArg(command), ...args.map(quoteCmdArg)].join(" ")],
-    windowsVerbatimArguments: true
-  };
-}
-
-function resolveCommandFromPath(commandName) {
-  const result = spawnSync("where.exe", [commandName], {
-    cwd: rootDir,
-    encoding: "utf8",
-    windowsHide: true,
-    stdio: ["ignore", "pipe", "pipe"]
-  });
-
-  if (result.status !== 0) {
-    return commandName;
-  }
-
-  const candidates = result.stdout
-    .split(/\r?\n/)
-    .map((line) => line.trim())
-    .filter(Boolean);
-
-  const commandScript = candidates.find((candidate) => path.extname(candidate).toLowerCase() === ".cmd");
-  return commandScript ?? candidates[0] ?? commandName;
-}
-
-function readRegistryEntries() {
-  const registryDir = path.join(os.tmpdir(), "aib", "instances");
-  if (!fs.existsSync(registryDir)) {
-    return [];
-  }
-
-  const entries = [];
-  for (const fileName of fs.readdirSync(registryDir)) {
-    if (!fileName.endsWith(".json")) {
-      continue;
-    }
-
-    const filePath = path.join(registryDir, fileName);
-    try {
-      const parsed = JSON.parse(fs.readFileSync(filePath, "utf8"));
-      entries.push({
-        ...parsed,
-        registryPath: filePath
-      });
-    } catch {
-      // Ignore corrupt/stale entries in probe output.
-    }
-  }
-
-  return entries;
-}
-
-function sleep(ms) {
-  return new Promise((resolve) => setTimeout(resolve, ms));
-}
-
-module.exports = {
-  rootDir,
-  defaultFixtureDir,
-  defaultVsixPath,
-  defaultRunsDir,
-  prepareSpawnCommand,
-  readRegistryEntries,
-  resolveCommandFromPath,
-  resolveIdeCommand,
-  run,
-  sleep,
-  timestampForPath,
-  writeJson
-};
+const fs = require("node:fs");
+const os = require("node:os");
+const path = require("node:path");
+const { spawnSync } = require("node:child_process");
+
+const rootDir = path.resolve(__dirname, "..", "..");
+const defaultFixtureDir = path.join(rootDir, "fixtures", "ts-sandbox");
+const defaultVsixPath = path.join(rootDir, ".tmp", "vscode-refactor-bridge-extension.vsix");
+const defaultRunsDir = path.join(rootDir, ".tmp", "ide-launch-runs");
+
+function timestampForPath() {
+  return new Date().toISOString().replace(/[:.]/g, "-");
+}
+
+function ensureDir(dirPath) {
+  fs.mkdirSync(dirPath, { recursive: true });
+}
+
+function writeJson(filePath, payload) {
+  ensureDir(path.dirname(filePath));
+  fs.writeFileSync(filePath, `${JSON.stringify(payload, null, 2)}\n`);
+}
+
+function run(command, args, options = {}) {
+  const startedAt = Date.now();
+  const spawnCommand = prepareSpawnCommand(command, args, options);
+  const result = spawnSync(spawnCommand.command, spawnCommand.args, {
+    cwd: options.cwd ?? rootDir,
+    env: buildEnv(options.env),
+    input: options.input,
+    encoding: "utf8",
+    windowsHide: true,
+    windowsVerbatimArguments: spawnCommand.windowsVerbatimArguments ?? false,
+    timeout: options.timeoutMs ?? 30_000,
+    shell: options.shell ?? false,
+    stdio: ["pipe", "pipe", "pipe"]
+  });
+
+  return {
+    command,
+    args,
+    status: result.status,
+    signal: result.signal,
+    error: result.error ? result.error.message : null,
+    stdout: result.stdout ?? "",
+    stderr: result.stderr ?? "",
+    durationMs: Date.now() - startedAt
+  };
+}
+
+function buildEnv(overrides) {
+  if (!overrides) {
+    return process.env;
+  }
+
+  const env = { ...process.env };
+  for (const [key, value] of Object.entries(overrides)) {
+    if (value === null || value === undefined) {
+      delete env[key];
+      continue;
+    }
+    env[key] = String(value);
+  }
+  return env;
+}
+
+function resolveIdeCommand(options) {
+  if (options.ideCommand) {
+    return options.ideCommand;
+  }
+
+  return resolveCommandFromPath(options.ide === "cursor" ? "cursor" : "code");
+}
+
+function isWindowsCommandScript(command) {
+  const extension = path.extname(command).toLowerCase();
+  return extension === ".cmd" || extension === ".bat";
+}
+
+function quoteCmdArg(value) {
+  const raw = String(value);
+  return `"${raw.replace(/"/g, '\\"')}"`;
+}
+
+function prepareSpawnCommand(command, args, options = {}) {
+  if (process.platform !== "win32" || options.shell !== undefined || !isWindowsCommandScript(command)) {
+    return { command, args };
+  }
+
+  return {
+    command: "cmd.exe",
+    args: ["/d", "/s", "/c", ["call", quoteCmdArg(command), ...args.map(quoteCmdArg)].join(" ")],
+    windowsVerbatimArguments: true
+  };
+}
+
+function resolveCommandFromPath(commandName) {
+  const result = spawnSync("where.exe", [commandName], {
+    cwd: rootDir,
+    encoding: "utf8",
+    windowsHide: true,
+    stdio: ["ignore", "pipe", "pipe"]
+  });
+
+  if (result.status !== 0) {
+    return commandName;
+  }
+
+  const candidates = result.stdout
+    .split(/\r?\n/)
+    .map((line) => line.trim())
+    .filter(Boolean);
+
+  const commandScript = candidates.find((candidate) => path.extname(candidate).toLowerCase() === ".cmd");
+  return commandScript ?? candidates[0] ?? commandName;
+}
+
+function readRegistryEntries() {
+  const registryDir = path.join(os.tmpdir(), "aib", "instances");
+  if (!fs.existsSync(registryDir)) {
+    return [];
+  }
+
+  const entries = [];
+  for (const fileName of fs.readdirSync(registryDir)) {
+    if (!fileName.endsWith(".json")) {
+      continue;
+    }
+
+    const filePath = path.join(registryDir, fileName);
+    try {
+      const parsed = JSON.parse(fs.readFileSync(filePath, "utf8"));
+      entries.push({
+        ...parsed,
+        registryPath: filePath
+      });
+    } catch {
+      // Ignore corrupt/stale entries in probe output.
+    }
+  }
+
+  return entries;
+}
+
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+module.exports = {
+  rootDir,
+  defaultFixtureDir,
+  defaultVsixPath,
+  defaultRunsDir,
+  prepareSpawnCommand,
+  readRegistryEntries,
+  resolveCommandFromPath,
+  resolveIdeCommand,
+  run,
+  sleep,
+  timestampForPath,
+  writeJson
+};

package/dist/managed-host/extension-vsix-resolver.js

@@ -1 +1 @@
-"use strict";var d=exports&&exports.__createBinding||(Object.create?(function(t,e,n,r){r===void 0&&(r=n);var i=Object.getOwnPropertyDescriptor(e,n);(!i||("get"in i?!e.__esModule:i.writable||i.configurable))&&(i={enumerable:!0,get:function(){return e[n]}}),Object.defineProperty(t,r,i)}):(function(t,e,n,r){r===void 0&&(r=n),t[r]=e[n]})),g=exports&&exports.__setModuleDefault||(Object.create?(function(t,e){Object.defineProperty(t,"default",{enumerable:!0,value:e})}):function(t,e){t.default=e}),c=exports&&exports.__importStar||(function(){var t=function(e){return t=Object.getOwnPropertyNames||function(n){var r=[];for(var i in n)Object.prototype.hasOwnProperty.call(n,i)&&(r[r.length]=i);return r},t(e)};return function(e){if(e&&e.__esModule)return e;var n={};if(e!=null)for(var r=t(e),i=0;i<r.length;i++)r[i]!=="default"&&d(n,e,r[i]);return g(n,e),n}})();Object.defineProperty(exports,"__esModule",{value:!0}),exports.resolveExtensionVsixPath=h;const s=c(require("node:fs")),o=c(require("node:path")),u=require("../config/env-vars"),v=require("../shared/diagnostics"),x=require("../shared/errors");function h(t){const e=f(u.CLI_ENV.extensionVsix);if(e)return{path:e,source:"env"};const n=p(t.packageRoot);if(n)return n;const r=o.join(t.packageRoot,"extension","vscode-refactor-bridge-extension.vsix");return s.existsSync(r)?{path:r,source:"package-extension"}:t.repoRoot?{path:o.join(t.repoRoot,".tmp","vscode-refactor-bridge-extension.vsix"),source:"repo-dev-fallback"}:{path:o.join(t.packageRoot,".tmp","vscode-refactor-bridge-extension.vsix"),source:"package-adjacent"}}function f(t){const e=process.env[t];return e&&e.trim()?o.resolve(e.trim()):null}function p(t){const n=f(u.CLI_ENV.installConfig)??o.join(t,"config.json");if(!s.existsSync(n))return null;const r=_(n),i=b(r);if(!i)throw l(n,"Expected config to include extensionVsix.");return{path:o.resolve(o.dirname(n),i),source:"install-config",configPath:n}}function _(t){try{const e=JSON.parse(s.readFileSync(t,"utf8"));if(e&&typeof e=="object"&&!Array.isArray(e))return e;throw new Error("Config root must be an object.")}catch(e){throw l(t,e instanceof Error?e.message:String(e))}}function b(t){const e=a(t.extensionVsix);if(e)return e;const n=t.extension;if(!n||typeof n!="object"||Array.isArray(n))return null;const r=n;return a(r.vsixPath)??a(r.vsix)}function a(t){return typeof t=="string"&&t.trim()?t.trim():null}function l(t,e){return new x.CliError("EXTENSION_VSIX_CONFIG_INVALID","Extension VSIX install config is invalid.",{configPath:t,reason:e,expected:{extensionVsix:"relative/or/absolute/path/to/extension.vsix"},hints:(0,v.buildAutoStartIdeHints)()})}
+"use strict";var x=exports&&exports.__createBinding||(Object.create?(function(e,t,r,n){n===void 0&&(n=r);var o=Object.getOwnPropertyDescriptor(t,r);(!o||("get"in o?!t.__esModule:o.writable||o.configurable))&&(o={enumerable:!0,get:function(){return t[r]}}),Object.defineProperty(e,n,o)}):(function(e,t,r,n){n===void 0&&(n=r),e[n]=t[r]})),h=exports&&exports.__setModuleDefault||(Object.create?(function(e,t){Object.defineProperty(e,"default",{enumerable:!0,value:t})}):function(e,t){e.default=t}),a=exports&&exports.__importStar||(function(){var e=function(t){return e=Object.getOwnPropertyNames||function(r){var n=[];for(var o in r)Object.prototype.hasOwnProperty.call(r,o)&&(n[n.length]=o);return n},e(t)};return function(t){if(t&&t.__esModule)return t;var r={};if(t!=null)for(var n=e(t),o=0;o<n.length;o++)n[o]!=="default"&&x(r,t,n[o]);return h(r,t),r}})();Object.defineProperty(exports,"__esModule",{value:!0}),exports.resolveExtensionVsixPath=P;const s=a(require("node:fs")),_=a(require("node:os")),i=a(require("node:path")),u=require("../config/env-vars"),b=require("../shared/diagnostics"),j=require("../shared/errors");function P(e){const t=v(u.CLI_ENV.extensionVsix);if(t)return{path:t,source:"env"};const r=O();if(r)return r;const n=y();if(n)return n;const o=E(e.packageRoot);if(o)return o;if(e.repoRoot){const l=i.join(e.repoRoot,".tmp","vscode-refactor-bridge-extension.vsix");if(s.existsSync(l))return{path:l,source:"repo-dev-fallback"}}const f=i.join(e.packageRoot,"extension","vscode-refactor-bridge-extension.vsix");return s.existsSync(f)?{path:f,source:"package-extension"}:e.repoRoot?{path:i.join(e.repoRoot,".tmp","vscode-refactor-bridge-extension.vsix"),source:"repo-dev-fallback"}:{path:i.join(e.packageRoot,".tmp","vscode-refactor-bridge-extension.vsix"),source:"package-adjacent"}}function y(){const e=i.join(S(),"extension","activation-status.json");if(!s.existsSync(e))return null;const t=p(e),r=c(t.activeVsixPath)??c(C(t.active)?.vsixPath);if(!r)return null;const n=i.resolve(r);return s.existsSync(n)?{path:n,source:"product-storage",configPath:e}:null}function S(){const e=process.env[u.CLI_ENV.productStorageDir];return e?.trim()?i.resolve(e):process.platform==="win32"&&process.env.LOCALAPPDATA?i.join(process.env.LOCALAPPDATA,"aib"):process.env.XDG_STATE_HOME?i.join(process.env.XDG_STATE_HOME,"aib"):i.join(_.homedir(),".local","state","aib")}function v(e){const t=process.env[e];return t&&t.trim()?i.resolve(t.trim()):null}function O(){const e=v(u.CLI_ENV.installConfig);return e?d(e):null}function E(e){const t=i.join(e,"config.json");return s.existsSync(t)?d(t):null}function d(e){const t=p(e),r=A(t);if(!r)throw g(e,"Expected config to include extensionVsix.");return{path:i.resolve(i.dirname(e),r),source:"install-config",configPath:e}}function p(e){try{const t=JSON.parse(s.readFileSync(e,"utf8"));if(t&&typeof t=="object"&&!Array.isArray(t))return t;throw new Error("Config root must be an object.")}catch(t){throw g(e,t instanceof Error?t.message:String(t))}}function A(e){const t=c(e.extensionVsix);if(t)return t;const r=e.extension;if(!r||typeof r!="object"||Array.isArray(r))return null;const n=r;return c(n.vsixPath)??c(n.vsix)}function C(e){return e&&typeof e=="object"&&!Array.isArray(e)?e:null}function c(e){return typeof e=="string"&&e.trim()?e.trim():null}function g(e,t){return new j.CliError("EXTENSION_VSIX_CONFIG_INVALID","Extension VSIX install config is invalid.",{configPath:e,reason:t,expected:{extensionVsix:"relative/or/absolute/path/to/extension.vsix"},hints:(0,b.buildAutoStartIdeHints)()})}