doc-detective 4.0.1 → 4.0.2-dev.10

package/dist/agents/adapters/qwen-code.d.ts

@@ -0,0 +1,30 @@
+import type { AgentAdapter, DetectionResult, InstallOptions, InstallReport, InstallState, Scope } from "../types.js";
+export interface RunResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+}
+export interface QwenCodeDeps {
+    run: (cmd: string, args: string[]) => Promise<RunResult>;
+    existsSync: (p: string) => boolean;
+    readFileSync: (p: string, encoding?: BufferEncoding) => string;
+    homedir: () => string;
+    fetchLatestVersion: () => Promise<string | undefined>;
+}
+export declare function defaultQwenCodeDeps(): QwenCodeDeps;
+export declare class QwenCodeAdapter implements AgentAdapter {
+    readonly id = "qwen";
+    readonly displayName = "Qwen Code";
+    private deps;
+    constructor(deps?: QwenCodeDeps);
+    supportsScopes(): Scope[];
+    detect(): Promise<DetectionResult>;
+    getInstallState(_scope: Scope): Promise<InstallState>;
+    private canonicalSkillPath;
+    private manifestPath;
+    private queryLocalInstallState;
+    private enrichWithLatest;
+    install(opts: InstallOptions): Promise<InstallReport>;
+}
+export declare const qwenCodeAdapter: AgentAdapter;
+//# sourceMappingURL=qwen-code.d.ts.map

package/dist/agents/adapters/qwen-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qwen-code.d.ts","sourceRoot":"","sources":["../../../src/agents/adapters/qwen-code.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,YAAY,EACZ,eAAe,EACf,cAAc,EACd,aAAa,EACb,YAAY,EACZ,KAAK,EACN,MAAM,aAAa,CAAC;AAIrB,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;IACzD,UAAU,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;IACnC,YAAY,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,cAAc,KAAK,MAAM,CAAC;IAC/D,OAAO,EAAE,MAAM,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CACvD;AAOD,wBAAgB,mBAAmB,IAAI,YAAY,CAclD;AAED,qBAAa,eAAgB,YAAW,YAAY;IAClD,QAAQ,CAAC,EAAE,UAAU;IACrB,QAAQ,CAAC,WAAW,eAAe;IACnC,OAAO,CAAC,IAAI,CAAe;gBAEf,IAAI,GAAE,YAAoC;IAItD,cAAc,IAAI,KAAK,EAAE;IAKnB,MAAM,IAAI,OAAO,CAAC,eAAe,CAAC;IAgClC,eAAe,CAAC,MAAM,EAAE,KAAK,GAAG,OAAO,CAAC,YAAY,CAAC;IAM3D,OAAO,CAAC,kBAAkB;IAc1B,OAAO,CAAC,YAAY;IAcpB,OAAO,CAAC,sBAAsB;YA2BhB,gBAAgB;IAiBxB,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;CA4F5D;AAED,eAAO,MAAM,eAAe,EAAE,YAAoC,CAAC"}

package/dist/agents/adapters/qwen-code.js

@@ -0,0 +1,212 @@
+import path from "node:path";
+import os from "node:os";
+import fs from "node:fs";
+import axios from "axios";
+import { safeSpawn } from "../spawn-helper.js";
+import { parseMetadataVersion } from "./codex.js";
+const EXTENSION_NAME = "doc-detective";
+const GIT_SOURCE = "https://github.com/doc-detective/agent-tools";
+const LATEST_SKILL_URL = "https://raw.githubusercontent.com/doc-detective/agent-tools/main/skills/doc-detective-init/SKILL.md";
+export function defaultQwenCodeDeps() {
+    return {
+        run: (cmd, args) => safeSpawn(cmd, args),
+        existsSync: fs.existsSync,
+        readFileSync: (p, enc = "utf8") => fs.readFileSync(p, enc),
+        homedir: os.homedir,
+        fetchLatestVersion: async () => {
+            const response = await axios.get(LATEST_SKILL_URL, {
+                timeout: 5000,
+                responseType: "text",
+            });
+            return parseMetadataVersion(String(response?.data ?? ""));
+        },
+    };
+}
+export class QwenCodeAdapter {
+    id = "qwen";
+    displayName = "Qwen Code";
+    deps;
+    constructor(deps = defaultQwenCodeDeps()) {
+        this.deps = deps;
+    }
+    supportsScopes() {
+        // Qwen's `extensions install` has no --scope flag; extensions live in ~/.qwen.
+        return ["global"];
+    }
+    async detect() {
+        const qwenHome = path.join(this.deps.homedir(), ".qwen");
+        let onPath = false;
+        let version;
+        try {
+            const result = await this.deps.run("qwen", ["--version"]);
+            if (result.exitCode === 0 && result.stdout.trim()) {
+                onPath = true;
+                version = result.stdout.trim();
+            }
+        }
+        catch {
+            // Binary absent — silent.
+        }
+        const configPaths = {};
+        if (this.deps.existsSync(qwenHome))
+            configPaths.global = qwenHome;
+        const present = onPath || !!configPaths.global;
+        const notes = [];
+        if (!onPath && configPaths.global) {
+            notes.push("`qwen` not on PATH; install requires the binary — `npm install -g @qwen-code/qwen-code`.");
+        }
+        return {
+            present,
+            onPath,
+            version,
+            configPaths,
+            notes: notes.length ? notes : undefined,
+        };
+    }
+    async getInstallState(_scope) {
+        const base = this.queryLocalInstallState();
+        if (!base.installed)
+            return base;
+        return this.enrichWithLatest(base);
+    }
+    canonicalSkillPath() {
+        // Canonical skill file used as an authoritative version source when it's
+        // present. Not always copied on install — see manifestPath() fallback.
+        return path.join(this.deps.homedir(), ".qwen", "extensions", EXTENSION_NAME, "skills", "doc-detective-init", "SKILL.md");
+    }
+    manifestPath() {
+        // Qwen writes this manifest on every successful install, regardless of
+        // whether Claude-plugin conversion copied the skills/ subtree. Anchoring
+        // "is installed?" on manifest existence keeps detection robust even when
+        // QwenLM/qwen-code#1737 suppresses the skills copy.
+        return path.join(this.deps.homedir(), ".qwen", "extensions", EXTENSION_NAME, "qwen-extension.json");
+    }
+    queryLocalInstallState() {
+        // Prefer SKILL.md's metadata.version when available — it's authoritative.
+        const canonical = this.canonicalSkillPath();
+        if (this.deps.existsSync(canonical)) {
+            try {
+                const raw = this.deps.readFileSync(canonical, "utf8");
+                const version = parseMetadataVersion(raw);
+                return { installed: true, installedVersion: version };
+            }
+            catch {
+                // Fall through to the manifest-only detection.
+            }
+        }
+        // Fall back to the manifest for the install marker. Its `version` may be
+        // undefined due to bug #1737 but presence still means "installed".
+        const manifest = this.manifestPath();
+        if (this.deps.existsSync(manifest)) {
+            try {
+                const parsed = JSON.parse(this.deps.readFileSync(manifest, "utf8"));
+                const version = typeof parsed?.version === "string" ? parsed.version : undefined;
+                return { installed: true, installedVersion: version };
+            }
+            catch {
+                return { installed: true };
+            }
+        }
+        return { installed: false };
+    }
+    async enrichWithLatest(state) {
+        let latestVersion;
+        try {
+            latestVersion = await this.deps.fetchLatestVersion();
+        }
+        catch {
+            latestVersion = undefined;
+        }
+        if (!latestVersion) {
+            return { ...state, latestVersion: undefined, upToDate: undefined };
+        }
+        const upToDate = state.installedVersion !== undefined
+            ? state.installedVersion === latestVersion
+            : undefined;
+        return { ...state, latestVersion, upToDate };
+    }
+    async install(opts) {
+        const base = this.queryLocalInstallState();
+        // Fresh install uses the documented `<url>:<plugin>` colon syntax so
+        // Qwen's marketplace-adapter picks the plugin directly instead of
+        // showing an interactive "Select a plugin to install" prompt — a prompt
+        // that `--consent` doesn't suppress. With stdio closed in CI the prompt
+        // would EOF and exit 0 without installing anything.
+        const installArg = `${GIT_SOURCE}:${EXTENSION_NAME}`;
+        const commands = base.installed
+            ? [["qwen", "extensions", "update", EXTENSION_NAME]]
+            : [["qwen", "extensions", "install", installArg, "--auto-update", "--consent"]];
+        // Short-circuit dry-run BEFORE touching the network: dry-run is a
+        // side-effect-free preview and shouldn't block on (or fail due to) a
+        // GitHub request. Pick the install-vs-update command from local state
+        // alone and skip the latest-version enrichment entirely.
+        if (opts.dryRun) {
+            for (const cmd of commands) {
+                opts.logger(`[dry-run] would run: ${cmd.join(" ")}`, "info");
+            }
+            return {
+                adapterId: this.id,
+                scope: opts.scope,
+                action: "dry-run",
+                installedVersion: base.installedVersion,
+            };
+        }
+        // Always enrich — even on fresh install — so `latestVersion` is populated
+        // for the post-install report. Qwen's local manifest often omits a
+        // version (bug #1737), so the network-fetched latest is our best signal
+        // for the installed version after a successful run.
+        const enriched = await this.enrichWithLatest(base);
+        const isInstalled = enriched.installed;
+        const isUpToDate = enriched.upToDate === true;
+        if (isInstalled && isUpToDate && !opts.force) {
+            return {
+                adapterId: this.id,
+                scope: opts.scope,
+                action: "already-up-to-date",
+                installedVersion: enriched.installedVersion,
+            };
+        }
+        for (const [cmd, ...args] of commands) {
+            opts.logger(`Running: ${cmd} ${args.join(" ")}`, "debug");
+            let result;
+            try {
+                result = await this.deps.run(cmd, args);
+            }
+            catch (err) {
+                const code = err?.code;
+                if (code === "ENOENT") {
+                    throw new Error("Qwen Code is not installed or not on PATH. Run `npm install -g @qwen-code/qwen-code` and re-run install-agents.");
+                }
+                throw err;
+            }
+            if (result.stdout)
+                opts.logger(result.stdout, "debug");
+            if (result.exitCode !== 0) {
+                throw new Error(`\`${cmd} ${args.join(" ")}\` exited with code ${result.exitCode}` +
+                    (result.stderr ? `: ${result.stderr}` : ""));
+            }
+        }
+        // Prefer the network-fetched latest version (authoritative post-install);
+        // fall back to a fresh on-disk SKILL.md read, then to the pre-install
+        // state. This matters on a fresh install where `fetchLatestVersion()`
+        // failed — we still surface the installed version rather than undefined.
+        const installedVersion = enriched.latestVersion ??
+            this.queryLocalInstallState().installedVersion ??
+            enriched.installedVersion;
+        let action;
+        if (opts.force && isInstalled && isUpToDate)
+            action = "forced";
+        else if (isInstalled)
+            action = "updated";
+        else
+            action = "installed";
+        return {
+            adapterId: this.id,
+            scope: opts.scope,
+            action,
+            installedVersion,
+        };
+    }
+}
+export const qwenCodeAdapter = new QwenCodeAdapter();
+//# sourceMappingURL=qwen-code.js.map

package/dist/agents/adapters/qwen-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qwen-code.js","sourceRoot":"","sources":["../../../src/agents/adapters/qwen-code.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,KAAK,MAAM,OAAO,CAAC;AAS1B,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAgBlD,MAAM,cAAc,GAAG,eAAe,CAAC;AACvC,MAAM,UAAU,GAAG,8CAA8C,CAAC;AAClE,MAAM,gBAAgB,GACpB,qGAAqG,CAAC;AAExG,MAAM,UAAU,mBAAmB;IACjC,OAAO;QACL,GAAG,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC;QACxC,UAAU,EAAE,EAAE,CAAC,UAAU;QACzB,YAAY,EAAE,CAAC,CAAC,EAAE,GAAG,GAAG,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,GAAG,CAAC;QAC1D,OAAO,EAAE,EAAE,CAAC,OAAO;QACnB,kBAAkB,EAAE,KAAK,IAAI,EAAE;YAC7B,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,gBAAgB,EAAE;gBACjD,OAAO,EAAE,IAAI;gBACb,YAAY,EAAE,MAAM;aACrB,CAAC,CAAC;YACH,OAAO,oBAAoB,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;QAC5D,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,eAAe;IACjB,EAAE,GAAG,MAAM,CAAC;IACZ,WAAW,GAAG,WAAW,CAAC;IAC3B,IAAI,CAAe;IAE3B,YAAY,OAAqB,mBAAmB,EAAE;QACpD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,cAAc;QACZ,+EAA+E;QAC/E,OAAO,CAAC,QAAQ,CAAC,CAAC;IACpB,CAAC;IAED,KAAK,CAAC,MAAM;QACV,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;QAEzD,IAAI,MAAM,GAAG,KAAK,CAAC;QACnB,IAAI,OAA2B,CAAC;QAChC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;YAC1D,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;gBAClD,MAAM,GAAG,IAAI,CAAC;gBACd,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YACjC,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,0BAA0B;QAC5B,CAAC;QAED,MAAM,WAAW,GAA0C,EAAE,CAAC;QAC9D,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;YAAE,WAAW,CAAC,MAAM,GAAG,QAAQ,CAAC;QAElE,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC;QAC/C,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,IAAI,CAAC,MAAM,IAAI,WAAW,CAAC,MAAM,EAAE,CAAC;YAClC,KAAK,CAAC,IAAI,CAAC,0FAA0F,CAAC,CAAC;QACzG,CAAC;QACD,OAAO;YACL,OAAO;YACP,MAAM;YACN,OAAO;YACP,WAAW;YACX,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;SACxC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,MAAa;QACjC,MAAM,IAAI,GAAG,IAAI,CAAC,sBAAsB,EAAE,CAAC;QAC3C,IAAI,CAAC,IAAI,CAAC,SAAS;YAAE,OAAO,IAAI,CAAC;QACjC,OAAO,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IAEO,kBAAkB;QACxB,yEAAyE;QACzE,uEAAuE;QACvE,OAAO,IAAI,CAAC,IAAI,CACd,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EACnB,OAAO,EACP,YAAY,EACZ,cAAc,EACd,QAAQ,EACR,oBAAoB,EACpB,UAAU,CACX,CAAC;IACJ,CAAC;IAEO,YAAY;QAClB,uEAAuE;QACvE,yEAAyE;QACzE,yEAAyE;QACzE,oDAAoD;QACpD,OAAO,IAAI,CAAC,IAAI,CACd,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EACnB,OAAO,EACP,YAAY,EACZ,cAAc,EACd,qBAAqB,CACtB,CAAC;IACJ,CAAC;IAEO,sBAAsB;QAC5B,0EAA0E;QAC1E,MAAM,SAAS,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC5C,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YACpC,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;gBACtD,MAAM,OAAO,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAC;gBAC1C,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,CAAC;YACxD,CAAC;YAAC,MAAM,CAAC;gBACP,+CAA+C;YACjD,CAAC;QACH,CAAC;QACD,yEAAyE;QACzE,mEAAmE;QACnE,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QACrC,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACnC,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;gBACpE,MAAM,OAAO,GAAG,OAAO,MAAM,EAAE,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;gBACjF,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,CAAC;YACxD,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;YAC7B,CAAC;QACH,CAAC;QACD,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IAC9B,CAAC;IAEO,KAAK,CAAC,gBAAgB,CAAC,KAAmB;QAChD,IAAI,aAAiC,CAAC;QACtC,IAAI,CAAC;YACH,aAAa,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACvD,CAAC;QAAC,MAAM,CAAC;YACP,aAAa,GAAG,SAAS,CAAC;QAC5B,CAAC;QACD,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,OAAO,EAAE,GAAG,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;QACrE,CAAC;QACD,MAAM,QAAQ,GACZ,KAAK,CAAC,gBAAgB,KAAK,SAAS;YAClC,CAAC,CAAC,KAAK,CAAC,gBAAgB,KAAK,aAAa;YAC1C,CAAC,CAAC,SAAS,CAAC;QAChB,OAAO,EAAE,GAAG,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAoB;QAChC,MAAM,IAAI,GAAG,IAAI,CAAC,sBAAsB,EAAE,CAAC;QAE3C,qEAAqE;QACrE,kEAAkE;QAClE,wEAAwE;QACxE,wEAAwE;QACxE,oDAAoD;QACpD,MAAM,UAAU,GAAG,GAAG,UAAU,IAAI,cAAc,EAAE,CAAC;QAErD,MAAM,QAAQ,GAAU,IAAI,CAAC,SAAS;YACpC,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC;YACpD,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,eAAe,EAAE,WAAW,CAAC,CAAC,CAAC;QAElF,kEAAkE;QAClE,qEAAqE;QACrE,sEAAsE;QACtE,yDAAyD;QACzD,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;gBAC3B,IAAI,CAAC,MAAM,CAAC,wBAAwB,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;YAC/D,CAAC;YACD,OAAO;gBACL,SAAS,EAAE,IAAI,CAAC,EAAE;gBAClB,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,MAAM,EAAE,SAAS;gBACjB,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;aACxC,CAAC;QACJ,CAAC;QAED,0EAA0E;QAC1E,mEAAmE;QACnE,wEAAwE;QACxE,oDAAoD;QACpD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;QAEnD,MAAM,WAAW,GAAG,QAAQ,CAAC,SAAS,CAAC;QACvC,MAAM,UAAU,GAAG,QAAQ,CAAC,QAAQ,KAAK,IAAI,CAAC;QAE9C,IAAI,WAAW,IAAI,UAAU,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAC7C,OAAO;gBACL,SAAS,EAAE,IAAI,CAAC,EAAE;gBAClB,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,MAAM,EAAE,oBAAoB;gBAC5B,gBAAgB,EAAE,QAAQ,CAAC,gBAAgB;aAC5C,CAAC;QACJ,CAAC;QAED,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,IAAI,QAAQ,EAAE,CAAC;YACtC,IAAI,CAAC,MAAM,CAAC,YAAY,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;YAC1D,IAAI,MAAiB,CAAC;YACtB,IAAI,CAAC;gBACH,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAC1C,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,IAAI,GAAI,GAAyC,EAAE,IAAI,CAAC;gBAC9D,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;oBACtB,MAAM,IAAI,KAAK,CACb,iHAAiH,CAClH,CAAC;gBACJ,CAAC;gBACD,MAAM,GAAG,CAAC;YACZ,CAAC;YACD,IAAI,MAAM,CAAC,MAAM;gBAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YACvD,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;gBAC1B,MAAM,IAAI,KAAK,CACb,KAAK,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,uBAAuB,MAAM,CAAC,QAAQ,EAAE;oBAChE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAC9C,CAAC;YACJ,CAAC;QACH,CAAC;QAED,0EAA0E;QAC1E,sEAAsE;QACtE,sEAAsE;QACtE,yEAAyE;QACzE,MAAM,gBAAgB,GACpB,QAAQ,CAAC,aAAa;YACtB,IAAI,CAAC,sBAAsB,EAAE,CAAC,gBAAgB;YAC9C,QAAQ,CAAC,gBAAgB,CAAC;QAE5B,IAAI,MAA+B,CAAC;QACpC,IAAI,IAAI,CAAC,KAAK,IAAI,WAAW,IAAI,UAAU;YAAE,MAAM,GAAG,QAAQ,CAAC;aAC1D,IAAI,WAAW;YAAE,MAAM,GAAG,SAAS,CAAC;;YACpC,MAAM,GAAG,WAAW,CAAC;QAE1B,OAAO;YACL,SAAS,EAAE,IAAI,CAAC,EAAE;YAClB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,MAAM;YACN,gBAAgB;SACjB,CAAC;IACJ,CAAC;CACF;AAED,MAAM,CAAC,MAAM,eAAe,GAAiB,IAAI,eAAe,EAAE,CAAC"}

package/dist/agents/command.d.ts

@@ -0,0 +1,11 @@
+import type { CommandModule } from "yargs";
+export interface InstallAgentsArgv {
+    agent?: string[];
+    scope?: "project" | "global";
+    force: boolean;
+    yes: boolean;
+    "dry-run": boolean;
+    dryRun?: boolean;
+}
+export declare const installAgentsCommand: CommandModule<{}, InstallAgentsArgv>;
+//# sourceMappingURL=command.d.ts.map

package/dist/agents/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/agents/command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAE3C,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,OAAO,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,eAAO,MAAM,oBAAoB,EAAE,aAAa,CAAC,EAAE,EAAE,iBAAiB,CA2CrE,CAAC"}

package/dist/agents/command.js

@@ -0,0 +1,41 @@
+export const installAgentsCommand = {
+    command: "install-agents",
+    describe: "Install or update the doc-detective agent tools for detected AI coding agents (e.g., Claude Code).",
+    builder: (yargs) => yargs
+        .option("agent", {
+        alias: "a",
+        type: "string",
+        array: true,
+        describe: "Agent id to install into (repeatable). Skips the interactive picker. Example: --agent claude",
+    })
+        .option("scope", {
+        alias: "s",
+        type: "string",
+        choices: ["project", "global"],
+        describe: "Where to install: 'project' (current repo) or 'global' (user home). Each adapter resolves the exact path. Prompted if omitted.",
+    })
+        .option("force", {
+        alias: "f",
+        type: "boolean",
+        default: false,
+        describe: "Reinstall/overwrite even if already installed and up to date.",
+    })
+        .option("yes", {
+        alias: "y",
+        type: "boolean",
+        default: false,
+        describe: "Skip all prompts. Requires --agent and --scope.",
+    })
+        .option("dry-run", {
+        type: "boolean",
+        default: false,
+        describe: "Print the actions that would be taken without executing them.",
+    }),
+    handler: async (argv) => {
+        // Lazy-load so unrelated subcommands don't pay the import cost.
+        const { runInstallAgents } = await import("./runner.js");
+        const { createPrompts } = await import("./prompts.js");
+        await runInstallAgents(argv, { prompts: createPrompts() });
+    },
+};
+//# sourceMappingURL=command.js.map

package/dist/agents/command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../src/agents/command.ts"],"names":[],"mappings":"AAWA,MAAM,CAAC,MAAM,oBAAoB,GAAyC;IACxE,OAAO,EAAE,gBAAgB;IACzB,QAAQ,EACN,oGAAoG;IACtG,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CACjB,KAAK;SACF,MAAM,CAAC,OAAO,EAAE;QACf,KAAK,EAAE,GAAG;QACV,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,IAAI;QACX,QAAQ,EACN,8FAA8F;KACjG,CAAC;SACD,MAAM,CAAC,OAAO,EAAE;QACf,KAAK,EAAE,GAAG;QACV,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAU;QACvC,QAAQ,EACN,gIAAgI;KACnI,CAAC;SACD,MAAM,CAAC,OAAO,EAAE;QACf,KAAK,EAAE,GAAG;QACV,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,KAAK;QACd,QAAQ,EAAE,+DAA+D;KAC1E,CAAC;SACD,MAAM,CAAC,KAAK,EAAE;QACb,KAAK,EAAE,GAAG;QACV,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,KAAK;QACd,QAAQ,EAAE,iDAAiD;KAC5D,CAAC;SACD,MAAM,CAAC,SAAS,EAAE;QACjB,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,KAAK;QACd,QAAQ,EAAE,+DAA+D;KAC1E,CAAuD;IAC5D,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACtB,gEAAgE;QAChE,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;QACzD,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,CAAC;QACvD,MAAM,gBAAgB,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,aAAa,EAAE,EAAE,CAAC,CAAC;IAC7D,CAAC;CACF,CAAC"}

package/dist/agents/fetcher.d.ts

@@ -0,0 +1,30 @@
+export interface FetchResult {
+    /** Absolute path to the extracted tree. The caller is responsible for deleting it. */
+    tempDir: string;
+    /** Git ref that was fetched. */
+    ref: string;
+    /**
+     * True if the caller owns the tempDir and should delete it after use. False
+     * when a test (or other caller) points at a pre-existing directory they'll
+     * clean up themselves. Defaults to true when the real fetcher ran.
+     */
+    owned: boolean;
+}
+export interface FetchDeps {
+    /** HTTP GET. Injected so tests can return in-memory zip buffers. */
+    get?: (url: string, config: {
+        responseType: "arraybuffer";
+        timeout?: number;
+        maxContentLength?: number;
+    }) => Promise<{
+        data: Buffer | ArrayBuffer;
+    }>;
+    /** Filesystem access (mostly for tests that want to isolate temp dirs). */
+    mkdtempSync?: (prefix: string) => string;
+}
+/**
+ * Download and extract the agent-tools repo at the given ref, stripping the
+ * top-level `agent-tools-<ref>/` wrapper dir that GitHub adds to codeload zips.
+ */
+export declare function fetchAgentToolsZip(ref?: string, deps?: FetchDeps): Promise<FetchResult>;
+//# sourceMappingURL=fetcher.d.ts.map

package/dist/agents/fetcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetcher.d.ts","sourceRoot":"","sources":["../../src/agents/fetcher.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,WAAW;IAC1B,sFAAsF;IACtF,OAAO,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ;;;;OAIG;IACH,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,oEAAoE;IACpE,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE;QAAE,YAAY,EAAE,aAAa,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAA;KAAE,CAAC,CAAC;IACrJ,2EAA2E;IAC3E,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;CAC1C;AAcD;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,GAAE,MAAe,EACpB,IAAI,GAAE,SAAc,GACnB,OAAO,CAAC,WAAW,CAAC,CAgFtB"}

package/dist/agents/fetcher.js

@@ -0,0 +1,112 @@
+import path from "node:path";
+import os from "node:os";
+import fs from "node:fs";
+import axios from "axios";
+import AdmZip from "adm-zip";
+const REPO_SLUG = "doc-detective/agent-tools";
+const MAX_ZIP_BYTES = 50 * 1024 * 1024;
+/**
+ * Build the codeload archive URL for a given ref. GitHub's codeload endpoint
+ * accepts `<ref>` directly (branches, tags, and full commit SHAs all resolve),
+ * so we don't hard-code `refs/heads/…` and we support tags like `v1.3.0`.
+ */
+function codeloadUrl(ref) {
+    return `https://codeload.github.com/${REPO_SLUG}/zip/${ref}`;
+}
+/**
+ * Download and extract the agent-tools repo at the given ref, stripping the
+ * top-level `agent-tools-<ref>/` wrapper dir that GitHub adds to codeload zips.
+ */
+export async function fetchAgentToolsZip(ref = "main", deps = {}) {
+    const get = deps.get ?? ((url, config) => axios.get(url, config));
+    const mkdtempSync = deps.mkdtempSync ?? ((prefix) => fs.mkdtempSync(prefix));
+    const tempDir = mkdtempSync(path.join(os.tmpdir(), "doc-detective-agent-tools-"));
+    try {
+        const response = await get(codeloadUrl(ref), {
+            responseType: "arraybuffer",
+            timeout: 30000,
+            maxContentLength: MAX_ZIP_BYTES,
+        });
+        const buf = Buffer.isBuffer(response.data)
+            ? response.data
+            : Buffer.from(response.data);
+        const zip = new AdmZip(buf);
+        const entries = zip.getEntries();
+        // Detect the GitHub wrapper directory (e.g. "agent-tools-main/"). It's the
+        // common prefix of every entry in a codeload zip.
+        const prefix = commonTopLevelPrefix(entries.map((e) => e.entryName));
+        const resolvedBase = path.resolve(tempDir);
+        for (const entry of entries) {
+            const rel = entry.entryName.startsWith(prefix)
+                ? entry.entryName.slice(prefix.length)
+                : entry.entryName;
+            if (!rel)
+                continue; // skip the wrapper dir itself
+            // Belt-and-suspenders zip-slip guards. The first checks the *entry name*
+            // before any path computation, satisfying CodeQL's taint tracker that
+            // `rel` is sanitized before it reaches `path.resolve`. The second
+            // verifies (via `path.relative`) that the fully-resolved destination
+            // stays inside the extraction root — this catches anything the first
+            // guard misses (e.g., symlink-like canonicalization edge cases).
+            if (path.isAbsolute(rel) ||
+                rel.split(/[\\/]/).some((seg) => seg === "..") ||
+                /^[a-zA-Z]:[\\/]/.test(rel)) {
+                throw new Error(`Refusing to extract zip entry with traversal path: ${entry.entryName}`);
+            }
+            const resolvedDest = path.resolve(resolvedBase, rel);
+            const relativeFromBase = path.relative(resolvedBase, resolvedDest);
+            if (relativeFromBase.startsWith("..") ||
+                path.isAbsolute(relativeFromBase)) {
+                throw new Error(`Refusing to extract zip entry outside extraction root: ${entry.entryName}`);
+            }
+            if (entry.isDirectory) {
+                fs.mkdirSync(resolvedDest, { recursive: true });
+            }
+            else {
+                fs.mkdirSync(path.dirname(resolvedDest), { recursive: true });
+                fs.writeFileSync(resolvedDest, entry.getData());
+                // Preserve the unix permission bits the zip carries. GitHub codeload
+                // zips store file modes in the high 16 bits of the external-attributes
+                // field (adm-zip exposes this as `entry.attr`). Without this, shell
+                // scripts committed as 0755 in the source repo land on disk with
+                // default permissions and refuse to execute at runtime.
+                const unixMode = (entry.attr >>> 16) & 0o777;
+                if (unixMode !== 0) {
+                    try {
+                        fs.chmodSync(resolvedDest, unixMode);
+                    }
+                    catch { }
+                }
+            }
+        }
+        return { tempDir, ref, owned: true };
+    }
+    catch (err) {
+        // Best-effort cleanup; propagate the original error.
+        try {
+            fs.rmSync(tempDir, { recursive: true, force: true });
+        }
+        catch { }
+        const reason = err instanceof Error ? err.message : String(err);
+        throw new Error(`Failed to download agent-tools@${ref} from GitHub: ${reason}`);
+    }
+}
+/**
+ * Return the common top-level directory prefix across all entry names. Returns
+ * "" if the entries have no shared root (treat as already-stripped).
+ */
+function commonTopLevelPrefix(names) {
+    if (names.length === 0)
+        return "";
+    const first = names[0];
+    const slash = first.indexOf("/");
+    if (slash === -1)
+        return "";
+    const candidate = first.slice(0, slash + 1);
+    for (const n of names) {
+        if (!n.startsWith(candidate))
+            return "";
+    }
+    return candidate;
+}
+//# sourceMappingURL=fetcher.js.map

package/dist/agents/fetcher.js.map

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

package/dist/agents/prompts.d.ts

@@ -0,0 +1,24 @@
+import type { AgentAdapter, Scope } from "./types.js";
+/**
+ * Ask the user which detected agents to install into. Pre-selects all of them
+ * since, by assumption, the caller already filtered to agents that were
+ * actually detected on the machine.
+ */
+export declare function pickAgents(available: AgentAdapter[]): Promise<string[]>;
+/**
+ * Ask the user which install scope to use. If only one is supported, skip the
+ * prompt and return it directly.
+ */
+export declare function pickScope(supported: Scope[]): Promise<Scope>;
+export declare function confirmForce(modifiedFiles: string[]): Promise<boolean>;
+/**
+ * Factory to hand into {@link runInstallAgents} as its `prompts` dep. The
+ * `install-agents` command already imports this module lazily (dynamic
+ * `import("./prompts.js")` from the yargs handler) so other subcommands
+ * don't pay the inquirer load cost.
+ */
+export declare function createPrompts(): {
+    pickAgents: typeof pickAgents;
+    pickScope: typeof pickScope;
+};
+//# sourceMappingURL=prompts.d.ts.map

package/dist/agents/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/agents/prompts.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEtD;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,SAAS,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAY7E;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAAC,SAAS,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,CASlE;AAED,wBAAsB,YAAY,CAAC,aAAa,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAY5E;AAED;;;;;GAKG;AACH,wBAAgB,aAAa;;;EAE5B"}

package/dist/agents/prompts.js

@@ -0,0 +1,74 @@
+import { checkbox, select, confirm } from "@inquirer/prompts";
+/**
+ * Ask the user which detected agents to install into. Pre-selects all of them
+ * since, by assumption, the caller already filtered to agents that were
+ * actually detected on the machine.
+ */
+export async function pickAgents(available) {
+    assertTTY();
+    if (available.length === 0)
+        return [];
+    return checkbox({
+        message: "Which agents should receive the doc-detective tools?",
+        choices: available.map((a) => ({
+            name: a.displayName,
+            value: a.id,
+            checked: true,
+        })),
+        required: false,
+    });
+}
+/**
+ * Ask the user which install scope to use. If only one is supported, skip the
+ * prompt and return it directly.
+ */
+export async function pickScope(supported) {
+    assertTTY();
+    if (supported.length === 1)
+        return supported[0];
+    const chosen = await select({
+        message: "Install scope?",
+        choices: buildScopeChoices(supported),
+        default: supported.includes("project") ? "project" : supported[0],
+    });
+    return chosen;
+}
+export async function confirmForce(modifiedFiles) {
+    assertTTY();
+    if (modifiedFiles.length > 0) {
+        console.log("Locally modified files detected:\n" +
+            modifiedFiles.map((f) => "  " + f).join("\n"));
+    }
+    return confirm({
+        message: "Overwrite them? (equivalent to --force)",
+        default: false,
+    });
+}
+/**
+ * Factory to hand into {@link runInstallAgents} as its `prompts` dep. The
+ * `install-agents` command already imports this module lazily (dynamic
+ * `import("./prompts.js")` from the yargs handler) so other subcommands
+ * don't pay the inquirer load cost.
+ */
+export function createPrompts() {
+    return { pickAgents, pickScope };
+}
+function assertTTY() {
+    if (!process.stdin.isTTY) {
+        throw new Error("No TTY detected; run interactively or pass --agent and --scope with --yes.");
+    }
+}
+function buildScopeChoices(supported) {
+    const labels = {
+        project: {
+            name: "Project — applies to this repo only",
+            description: "Installs into the current project directory.",
+        },
+        global: {
+            name: "User-global — applies to every project for this user",
+            description: "Installs into your user home directory.",
+        },
+    };
+    return supported.map((s) => ({ name: labels[s].name, value: s, description: labels[s].description }));
+}
+//# sourceMappingURL=prompts.js.map

package/dist/agents/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../src/agents/prompts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAG9D;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,SAAyB;IACxD,SAAS,EAAE,CAAC;IACZ,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACtC,OAAO,QAAQ,CAAC;QACd,OAAO,EAAE,sDAAsD;QAC/D,OAAO,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC7B,IAAI,EAAE,CAAC,CAAC,WAAW;YACnB,KAAK,EAAE,CAAC,CAAC,EAAE;YACX,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;QACH,QAAQ,EAAE,KAAK;KAChB,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,SAAkB;IAChD,SAAS,EAAE,CAAC;IACZ,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC;IAChD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAQ;QACjC,OAAO,EAAE,gBAAgB;QACzB,OAAO,EAAE,iBAAiB,CAAC,SAAS,CAAC;QACrC,OAAO,EAAE,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;KAClE,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,aAAuB;IACxD,SAAS,EAAE,CAAC;IACZ,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,OAAO,CAAC,GAAG,CACT,oCAAoC;YAClC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAChD,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC;QACb,OAAO,EAAE,yCAAyC;QAClD,OAAO,EAAE,KAAK;KACf,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC;AACnC,CAAC;AAED,SAAS,SAAS;IAChB,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CACb,4EAA4E,CAC7E,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CAAC,SAAkB;IAC3C,MAAM,MAAM,GAAyD;QACnE,OAAO,EAAE;YACP,IAAI,EAAE,qCAAqC;YAC3C,WAAW,EAAE,8CAA8C;SAC5D;QACD,MAAM,EAAE;YACN,IAAI,EAAE,sDAAsD;YAC5D,WAAW,EAAE,yCAAyC;SACvD;KACF,CAAC;IACF,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;AACxG,CAAC"}

package/dist/agents/registry.d.ts

@@ -0,0 +1,4 @@
+import type { AgentAdapter } from "./types.js";
+export declare function listAdapters(): AgentAdapter[];
+export declare function getAdapter(id: string): AgentAdapter;
+//# sourceMappingURL=registry.d.ts.map

package/dist/agents/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/agents/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAiB/C,wBAAgB,YAAY,IAAI,YAAY,EAAE,CAE7C;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,CAQnD"}

package/dist/agents/registry.js

@@ -0,0 +1,25 @@
+import { claudeCodeAdapter } from "./adapters/claude-code.js";
+import { copilotCliAdapter } from "./adapters/copilot-cli.js";
+import { geminiCliAdapter } from "./adapters/gemini-cli.js";
+import { codexAdapter } from "./adapters/codex.js";
+import { qwenCodeAdapter } from "./adapters/qwen-code.js";
+import { opencodeAdapter } from "./adapters/opencode.js";
+const adapters = [
+    claudeCodeAdapter,
+    copilotCliAdapter,
+    geminiCliAdapter,
+    codexAdapter,
+    qwenCodeAdapter,
+    opencodeAdapter,
+];
+export function listAdapters() {
+    return adapters.slice();
+}
+export function getAdapter(id) {
+    const adapter = adapters.find((a) => a.id === id);
+    if (!adapter) {
+        throw new Error(`Unknown agent adapter: '${id}'. Available: ${adapters.map((a) => a.id).join(", ")}`);
+    }
+    return adapter;
+}
+//# sourceMappingURL=registry.js.map

package/dist/agents/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/agents/registry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,MAAM,QAAQ,GAAmB;IAC/B,iBAAiB;IACjB,iBAAiB;IACjB,gBAAgB;IAChB,YAAY;IACZ,eAAe;IACf,eAAe;CAChB,CAAC;AAEF,MAAM,UAAU,YAAY;IAC1B,OAAO,QAAQ,CAAC,KAAK,EAAE,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,EAAU;IACnC,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAClD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,2BAA2B,EAAE,iBAAiB,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACrF,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/agents/runner.d.ts

@@ -0,0 +1,13 @@
+import type { AgentAdapter, InstallReport, LogLevel, Scope } from "./types.js";
+import type { InstallAgentsArgv } from "./command.js";
+export interface RunnerDeps {
+    adapters?: AgentAdapter[];
+    prompts?: {
+        pickAgents: (available: AgentAdapter[]) => Promise<string[]>;
+        pickScope: (supported: Scope[]) => Promise<Scope>;
+    };
+    logger?: (message: string, level?: LogLevel) => void;
+    isTTY?: () => boolean;
+}
+export declare function runInstallAgents(argv: InstallAgentsArgv, deps?: RunnerDeps): Promise<InstallReport[]>;
+//# sourceMappingURL=runner.d.ts.map