@event4u/agent-config 9.8.0 → 9.9.0

package/dist/install/agentSwitchDetection.js

@@ -0,0 +1,75 @@
+/**
+ * agent-switch detection — passive wizard recommendation (S0.1 honest-null
+ * council verdict, 2026-07-28: PASSIVE ROW ONLY, never a proactive card).
+ *
+ * agent-switch (https://github.com/event4u-app/agent-switch,
+ * `@event4u/agent-switch` on npm) isolates multiple agent accounts into
+ * per-account profiles (`CLAUDE_CONFIG_DIR`) so switching accounts never
+ * requires a re-login. Unlike rtk, the install command is npm-global and
+ * identical on every OS — no per-OS command map, no name collision to
+ * disambiguate.
+ *
+ * Two independent installed-signals, either is sufficient:
+ *   - the `agent-switch` binary is resolvable on PATH (the documented
+ *     npm-global install), OR
+ *   - `~/.agent-switch/` exists — a user who installed it another way must
+ *     never be told to install it again.
+ *
+ * Version is only probed when the binary is on PATH (the directory-only
+ * signal carries no version information — reported as `null`). There is
+ * deliberately NO version-currency check and NO network call here — the
+ * wizard only ever answers "installed or not", never "up to date" (roadmap
+ * acceptance criterion: this module does not report on agent-switch's
+ * version currency).
+ */
+import { spawnSync } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { resolveBinaryOnPath } from './rtkDetection.js';
+export const AGENT_SWITCH_REPO = 'event4u-app/agent-switch';
+export const AGENT_SWITCH_NPM = '@event4u/agent-switch';
+export const AGENT_SWITCH_INSTALL_COMMAND = 'npm install -g @event4u/agent-switch';
+const PROBE_TIMEOUT_MS = 2000;
+/** First dotted-number token in `output`, or `null` when none is present. */
+export function parseVersionOutput(output) {
+    const m = /(\d+\.\d+(?:\.\d+)?)/.exec(output);
+    return m?.[1] ?? null;
+}
+function defaultProbeVersion(bin) {
+    try {
+        const res = spawnSync(bin, ['--version'], {
+            timeout: PROBE_TIMEOUT_MS,
+            encoding: 'utf-8',
+            windowsHide: true,
+        });
+        if (res.error !== undefined || res.signal !== null)
+            return null;
+        return parseVersionOutput(`${res.stdout ?? ''}\n${res.stderr ?? ''}`);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Detect agent-switch installation. Never throws — every failure mode
+ * (spawn error, timeout, unparsable output) collapses to `version: null`.
+ */
+export function detectAgentSwitch(options = {}) {
+    const binPath = resolveBinaryOnPath('agent-switch', options.pathEnv);
+    if (binPath !== null) {
+        const probe = options.probeVersion ?? defaultProbeVersion;
+        let version;
+        try {
+            version = probe(binPath);
+        }
+        catch {
+            version = null;
+        }
+        return { installed: true, version };
+    }
+    const home = options.home ?? homedir();
+    const dirInstalled = existsSync(join(home, '.agent-switch'));
+    return { installed: dirInstalled, version: null };
+}
+//# sourceMappingURL=agentSwitchDetection.js.map

package/dist/install/agentSwitchDetection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentSwitchDetection.js","sourceRoot":"","sources":["../../src/install/agentSwitchDetection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExD,MAAM,CAAC,MAAM,iBAAiB,GAAG,0BAA0B,CAAC;AAC5D,MAAM,CAAC,MAAM,gBAAgB,GAAG,uBAAuB,CAAC;AACxD,MAAM,CAAC,MAAM,4BAA4B,GAAG,sCAAsC,CAAC;AAgBnF,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAE9B,6EAA6E;AAC7E,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC7C,MAAM,CAAC,GAAG,sBAAsB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9C,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AAC1B,CAAC;AAED,SAAS,mBAAmB,CAAC,GAAW;IACpC,IAAI,CAAC;QACD,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,EAAE;YACtC,OAAO,EAAE,gBAAgB;YACzB,QAAQ,EAAE,OAAO;YACjB,WAAW,EAAE,IAAI;SACpB,CAAC,CAAC;QACH,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS,IAAI,GAAG,CAAC,MAAM,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAChE,OAAO,kBAAkB,CAAC,GAAG,GAAG,CAAC,MAAM,IAAI,EAAE,KAAK,GAAG,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC,CAAC;IAC1E,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,IAAI,CAAC;IAChB,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,UAAoC,EAAE;IACpE,MAAM,OAAO,GAAG,mBAAmB,CAAC,cAAc,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IACrE,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACnB,MAAM,KAAK,GAAG,OAAO,CAAC,YAAY,IAAI,mBAAmB,CAAC;QAC1D,IAAI,OAAsB,CAAC;QAC3B,IAAI,CAAC;YACD,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;QAC7B,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,GAAG,IAAI,CAAC;QACnB,CAAC;QACD,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IACxC,CAAC;IACD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,EAAE,CAAC;IACvC,MAAM,YAAY,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC;IAC7D,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AACtD,CAAC"}

package/dist/install/agentSwitchProfile.js

@@ -0,0 +1,117 @@
+/**
+ * Detect whether AC is currently running under an agent-switch (AS)
+ * profile (`road-to-reciprocal-ecosystem.md` Phase 2 — correctness
+ * work, not the Phase 1 promotion card).
+ *
+ * Pure and injectable: reads only the supplied environment map, no
+ * filesystem I/O. Detection is deliberately topology-free — it never
+ * needs to understand AS's on-disk share model (that lives in
+ * `sharedWriteCheck.ts`, which DOES touch disk via `lstat`).
+ *
+ * AS root resolution mirrors `agent-switch/src/profiles.ts:11`:
+ * `AGENT_SWITCH_HOME` env override, else `~/.agent-switch`. Profile
+ * config dirs live at `<ROOT>/<provider>/<name>/config` (profiles.ts
+ * :143-145). Provider env vars mirror `agent-switch/src/providers.ts`:
+ * claude → `CLAUDE_CONFIG_DIR`, codex → `CODEX_HOME`. `HOME`
+ * (antigravity's provider var) is deliberately NOT checked here — it
+ * is set on every process, so treating it as an AS signal would
+ * false-positive constantly; antigravity profile detection is left to
+ * a future, more specific probe.
+ */
+import { homedir } from 'node:os';
+import * as path from 'node:path';
+const INACTIVE = { active: false, provider: null, profile: null };
+/** Provider env vars checked, in priority order (claude wins on a tie). */
+const PROVIDER_ENV_VARS = ['CLAUDE_CONFIG_DIR', 'CODEX_HOME'];
+/** Expand a leading `~` the way a shell would, for env values set programmatically. */
+function expandTilde(p) {
+    if (p === '~')
+        return homedir();
+    if (p.startsWith('~/') || (process.platform === 'win32' && p.startsWith('~\\'))) {
+        return path.join(homedir(), p.slice(2));
+    }
+    return p;
+}
+function normalize(p) {
+    return path.resolve(expandTilde(p));
+}
+function nonEmpty(v) {
+    return typeof v === 'string' && v.trim() !== '';
+}
+/**
+ * Find the first provider env var whose (normalized) value lies
+ * inside the AS root, and return the root + the path segments below
+ * it. Shared by `detectAgentSwitchProfile` and `resolveAgentSwitchRoot`
+ * so both stay in lockstep with a single matching rule.
+ */
+function resolveMatch(env) {
+    const overrideRaw = env['AGENT_SWITCH_HOME'];
+    const overrideRoot = nonEmpty(overrideRaw) ? normalize(overrideRaw) : null;
+    for (const varName of PROVIDER_ENV_VARS) {
+        const raw = env[varName];
+        if (!nonEmpty(raw))
+            continue;
+        const candidate = normalize(raw);
+        let root = null;
+        if (overrideRoot !== null) {
+            if (candidate === overrideRoot || candidate.startsWith(overrideRoot + path.sep)) {
+                root = overrideRoot;
+            }
+        }
+        else {
+            const bareMarker = `${path.sep}.agent-switch`;
+            const nestedMarker = `${bareMarker}${path.sep}`;
+            if (candidate.endsWith(bareMarker)) {
+                root = candidate;
+            }
+            else {
+                const idx = candidate.indexOf(nestedMarker);
+                if (idx !== -1)
+                    root = candidate.slice(0, idx + bareMarker.length);
+            }
+        }
+        if (root === null)
+            continue;
+        const rest = candidate === root ? '' : candidate.slice(root.length + 1);
+        const afterRoot = rest === '' ? [] : rest.split(path.sep).filter((s) => s.length > 0);
+        return { root, afterRoot };
+    }
+    return null;
+}
+/**
+ * Detect the active AS profile (if any) from the current environment.
+ *
+ * - Not inside `.agent-switch` at all → `{ active: false, ... }`.
+ * - Inside the AS root, but the env var points AT the root itself
+ *   (no `<provider>/<profile>` segments below it) → treated as
+ *   inactive; an env var pointing at the bare root is not a profile
+ *   directory.
+ * - Inside the AS root with only one segment below it (a provider dir
+ *   with no profile name) → active, but unparseable (`provider`/
+ *   `profile` both `null`).
+ * - Inside the AS root with `<provider>/<profile>/...` below it →
+ *   active, with `provider`/`profile` parsed from the first two
+ *   segments.
+ */
+export function detectAgentSwitchProfile(env = process.env) {
+    const match = resolveMatch(env);
+    if (match === null)
+        return INACTIVE;
+    if (match.afterRoot.length === 0)
+        return INACTIVE;
+    if (match.afterRoot.length < 2)
+        return { active: true, provider: null, profile: null };
+    // `length >= 2` guaranteed above — `??` only satisfies noUncheckedIndexedAccess.
+    return { active: true, provider: match.afterRoot[0] ?? null, profile: match.afterRoot[1] ?? null };
+}
+/**
+ * Resolve the AS root directory implied by the environment (the same
+ * matching rule `detectAgentSwitchProfile` uses), for callers that
+ * need a boundary to stop an upward filesystem walk at — see
+ * `sharedWriteCheck.ts`. Returns `null` when no provider env var
+ * resolves inside an AS tree.
+ */
+export function resolveAgentSwitchRoot(env = process.env) {
+    return resolveMatch(env)?.root ?? null;
+}
+//# sourceMappingURL=agentSwitchProfile.js.map

package/dist/install/agentSwitchProfile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentSwitchProfile.js","sourceRoot":"","sources":["../../src/install/agentSwitchProfile.ts"],"names":[],"mappings":"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"}

package/dist/install/atomic.js

@@ -2,7 +2,7 @@
  * Atomic file writer — Phase A4 primitive.
  *
  * 1:1 port of the `tempfile.mkstemp` + `os.replace` pattern used across
- * `scripts/install.py` (see `_write_consumer_bridge_marker` ~line 3036).
+ * the retired Python installer's `_write_consumer_bridge_marker` (ADR-200).
  *
  * Contract:
  *   1. Open a sibling `.tmp.<rand>` file in the destination directory

package/dist/install/detect.js

@@ -22,7 +22,7 @@ import { join, resolve } from 'node:path';
 /**
  * Settings-file name used as the strongest project-scope signal.
  *
- * Matches `SETTINGS_FILE` in `scripts/install.py`. Presence in `cwd`
+ * Matches `SETTINGS_FILE` in the retired Python installer (ADR-200). Presence in `cwd`
  * short-circuits scope detection to `'project'` without consulting
  * the manifest / AI-tool lists.
  */