vigiles 29.1.0 → 30.0.1

package/dist/test-coverage-files.js

@@ -82,19 +82,25 @@ function matchSurface(files, prefixes, leafRe) {
 }
 function discoverSkills(files, layout, repoName) {
     const out = [];
-    if (layout.skillDir) {
-        const prefixes = surfacePrefixes(layout.skillDir, layout.materializeRoot);
-        for (const path of matchSurface(files, prefixes, "[^/]+/SKILL\\.md")) {
-            const name = (0, posix_path_js_1.basename)((0, posix_path_js_1.dirname)(path));
-            const content = files[path];
-            out.push({
-                kind: "skill",
-                path,
-                name,
-                tokens: [`${layout.skillDir}/${name}`, `:${name}`],
-                ignored: content.includes(IGNORE_MARKER),
-            });
-        }
+    // 🔴 THE GATE MOVES TO THE TOP so it covers the root-`SKILL.md` case below too
+    // — the twin of this function on disk had the same hole. A layout declaring no
+    // skill surface reported a root `SKILL.md` as an untested skill, with a token
+    // reading `undefined/<name>`, lowering Tested for a repo whose harness never
+    // loads skills at all. Shape matches `discoverAgents` right below.
+    const skillDir = layout.surfaces.skill;
+    if (skillDir === undefined)
+        return out;
+    const prefixes = surfacePrefixes(skillDir, (0, layout_js_1.materializePrefix)(layout));
+    for (const path of matchSurface(files, prefixes, "[^/]+/SKILL\\.md")) {
+        const name = (0, posix_path_js_1.basename)((0, posix_path_js_1.dirname)(path));
+        const content = files[path];
+        out.push({
+            kind: "skill",
+            path,
+            name,
+            tokens: [`${skillDir}/${name}`, `:${name}`],
+            ignored: content.includes(IGNORE_MARKER),
+        });
     }
     // Single-skill-directory target: a bare `SKILL.md` at the repo root.
     //
@@ -113,7 +119,7 @@ function discoverSkills(files, layout, repoName) {
             kind: "skill",
             path: "SKILL.md",
             name,
-            tokens: [`${layout.skillDir}/${name}`, `:${name}`],
+            tokens: [`${skillDir}/${name}`, `:${name}`],
             ignored: content.includes(IGNORE_MARKER),
         });
     }
@@ -121,9 +127,10 @@ function discoverSkills(files, layout, repoName) {
 }
 function discoverAgents(files, layout) {
     const out = [];
-    if (!layout.agentDir)
+    const agentDir = layout.surfaces.agent;
+    if (agentDir === undefined)
         return out;
-    const prefixes = surfacePrefixes(layout.agentDir, layout.materializeRoot);
+    const prefixes = surfacePrefixes(agentDir, (0, layout_js_1.materializePrefix)(layout));
     // Same depth rule as the scan classifier — quoted from AGENT_FILE_LEAF_RE, not
     // respelled. This discoverer feeds the `Tested` metric; when it disagreed with
     // the classifier, `audit` printed a subagent count and an untested-surface
@@ -132,7 +139,7 @@ function discoverAgents(files, layout) {
         if (path.endsWith(".spec.ts"))
             continue;
         const content = files[path];
-        const name = (0, layout_js_1.agentSurfaceName)(path, layout.agentDir) ?? (0, posix_path_js_1.basename)(path, ".md");
+        const name = (0, layout_js_1.agentSurfaceName)(path, agentDir) ?? (0, posix_path_js_1.basename)(path, ".md");
         const dir = (0, posix_path_js_1.dirname)(path);
         out.push({
             kind: "agent",

package/dist/test-coverage.d.ts

@@ -217,7 +217,13 @@ export interface TestCoverageOptions {
      * manifest/settings paths. Defaults to Claude Code; a non-CC adapter passes its
      * own so the surface globs and hook-token expansion aren't hard-coded.
      */
-    readonly layout?: PluginLayout;
+    /**
+     * The layout to discover surfaces under. REQUIRED: it used to default to the
+     * Claude Code layout, which meant this harness-agnostic detector imported an
+     * adapter, and a caller that forgot to pass one silently graded a Codex repo
+     * with Claude Code's directories.
+     */
+    readonly layout: PluginLayout;
 }
 /**
  * Find harness surfaces (skills / agents / hooks) that no test or eval covers.
@@ -231,7 +237,7 @@ export interface TestCoverageOptions {
  * deterministic coverage, no evals" from "has neither" — two positions the single
  * count made indistinguishable.
  */
-export declare function findUntestedSurfaces(options?: TestCoverageOptions): UntestedReport;
+export declare function findUntestedSurfaces(options: TestCoverageOptions): UntestedReport;
 /** Suggested colocated test path for an untested surface (shown in the warning). */
 export declare function suggestedTestPath(surface: Surface, ext?: string): string;
 /** Tally the union tier's coverage decisions by how each was established. */
@@ -260,7 +266,7 @@ export declare function coverageEvidenceCounts(report: UntestedReport): Evidence
  * Returns `null` when the edited file isn't a skill/agent surface, or when it is
  * covered on both tiers. Never throws — a nudge must not disrupt an edit.
  */
-export declare function skillTestNudge(filePath: string, options?: TestCoverageOptions): string | null;
+export declare function skillTestNudge(filePath: string, options: TestCoverageOptions): string | null;
 /**
  * What the PAID eval tier measures for a surface of this kind — or `null` when
  * it measures nothing for it.

package/dist/test-coverage.js

@@ -76,23 +76,18 @@ const assert_never_js_1 = require("./core/assert-never.js");
 const ts_runner_caps_js_1 = require("./ts-runner-caps.js");
 const glob_1 = require("glob");
 const layout_js_1 = require("./core/layout.js");
-// 🔴 Same finding as src/scan.ts: a module listed as a harness-agnostic detector
-// importing the Claude Code adapter for a DEFAULT. Invisible to both existing
-// fences — unclassified for `boundaries/dependencies`, and `\.claude` does not
-// match `/claude-code/`. The default belongs to the caller, not the detector.
-// eslint-disable-next-line local/no-harness-names -- see above
-const layout_js_2 = require("./adapters/claude-code/layout.js");
 const coverage_evidence_js_1 = require("./coverage-evidence.js");
 const coverage_artifact_js_1 = require("./coverage-artifact.js");
 /**
  * The two on-disk locations a surface dir can occupy: the plugin-root form
  * (`skills/…`) and the materialized form (`.claude/skills/…`) — derived from the
- * layout so a non-Claude-Code harness (its own `materializeRoot` / surface dir)
- * is discovered without hard-coding `.claude`. An empty `dir` (a harness lacking
- * the surface, e.g. Codex subagents) yields no globs.
+ * layout so a non-Claude-Code harness (its own materialize prefix / surface dir)
+ * is discovered without hard-coding `.claude`. An ABSENT `dir` (a harness
+ * lacking the surface, e.g. Codex subagents) yields no globs — it used to be an
+ * empty string, which was a second spelling of the same fact.
  */
 function surfaceGlobs(dir, leaf, materializeRoot) {
-    if (!dir)
+    if (dir === undefined)
         return [];
     const matForm = materializeRoot ? `${materializeRoot}/${dir}` : dir;
     return [...new Set([`${dir}/${leaf}`, `${matForm}/${leaf}`])];
@@ -151,7 +146,17 @@ function read(path) {
 }
 function discoverSkills(basePath, ignore, layout) {
     const out = [];
-    const found = (0, glob_1.globSync)(surfaceGlobs(layout.skillDir, "*/SKILL.md", layout.materializeRoot), { cwd: basePath, ignore });
+    // 🔴 ONE GATE FOR THE WHOLE FUNCTION, and it is structural rather than
+    // repeated. A harness whose layout declares no skill surface has no skills to
+    // find — `surfaceGlobs` already returned `[]` for the nested case, but the
+    // root-`SKILL.md` case below did not ask, so a third-party layout with only
+    // agents or commands still reported an untested skill, and its token read
+    // `undefined/<name>`. Narrowing here makes that token unwritable instead of
+    // merely unwritten: `skillDir` is a `string` from this line on.
+    const skillDir = layout.surfaces.skill;
+    if (skillDir === undefined)
+        return out;
+    const found = (0, glob_1.globSync)(surfaceGlobs(skillDir, "*/SKILL.md", (0, layout_js_1.materializePrefix)(layout)), { cwd: basePath, ignore });
     for (const path of found.sort()) {
         const name = (0, node_path_1.basename)((0, node_path_1.dirname)(path));
         const content = read((0, node_path_1.join)(basePath, path));
@@ -159,7 +164,7 @@ function discoverSkills(basePath, ignore, layout) {
             kind: "skill",
             path,
             name,
-            tokens: [`${layout.skillDir}/${name}`, `:${name}`],
+            tokens: [`${skillDir}/${name}`, `:${name}`],
             ignored: content.includes(IGNORE_MARKER),
         });
     }
@@ -181,7 +186,7 @@ function discoverSkills(basePath, ignore, layout) {
             kind: "skill",
             path: "SKILL.md",
             name,
-            tokens: [`${layout.skillDir}/${name}`, `:${name}`],
+            tokens: [`${skillDir}/${name}`, `:${name}`],
             ignored: content.includes(IGNORE_MARKER),
         });
     }
@@ -204,11 +209,15 @@ function discoverAgents(basePath, ignore, layout) {
     // dialect is exactly how these two discoverers drifted from the scan
     // classifier in the first place, so only one dialect is authoritative and the
     // other is allowed to over-match.
-    const found = (0, glob_1.globSync)(surfaceGlobs(layout.agentDir, "**/*.md", layout.materializeRoot), { cwd: basePath, ignore });
-    const prefixes = layout.materializeRoot
-        ? [layout.agentDir, `${layout.materializeRoot}/${layout.agentDir}`]
-        : [layout.agentDir];
-    const isAgentFile = layout.agentDir
+    const found = (0, glob_1.globSync)(surfaceGlobs(layout.surfaces.agent, "**/*.md", (0, layout_js_1.materializePrefix)(layout)), { cwd: basePath, ignore });
+    const agentDir = layout.surfaces.agent;
+    const matPrefix = (0, layout_js_1.materializePrefix)(layout);
+    const prefixes = agentDir === undefined
+        ? []
+        : matPrefix
+            ? [agentDir, `${matPrefix}/${agentDir}`]
+            : [agentDir];
+    const isAgentFile = agentDir
         ? new RegExp(`^(?:${[...new Set(prefixes)]
             .map((p) => p.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"))
             .join("|")})/${layout_js_1.AGENT_FILE_LEAF_RE}$`)
@@ -225,7 +234,8 @@ function discoverAgents(basePath, ignore, layout) {
         if (isAgentFile && !isAgentFile.test(rel))
             continue;
         const content = read((0, node_path_1.join)(basePath, path));
-        const name = (0, layout_js_1.agentSurfaceName)(rel, layout.agentDir) ?? (0, node_path_1.basename)(rel, ".md");
+        const name = (agentDir === undefined ? null : (0, layout_js_1.agentSurfaceName)(rel, agentDir)) ??
+            (0, node_path_1.basename)(rel, ".md");
         const dir = (0, node_path_1.dirname)(path);
         out.push({
             kind: "agent",
@@ -415,9 +425,9 @@ function tierOf(considered, tests, index, tier, globs) {
  * deterministic coverage, no evals" from "has neither" — two positions the single
  * count made indistinguishable.
  */
-function findUntestedSurfaces(options = {}) {
+function findUntestedSurfaces(options) {
     const basePath = options.basePath ?? process.cwd();
-    const layout = options.layout ?? layout_js_2.claudeCodeLayout;
+    const { layout } = options;
     const ignore = [...DEFAULT_IGNORE, ...(options.exclude ?? [])];
     const globs = options.include ?? DEFAULT_TEST_GLOBS;
     const surfaces = [];
@@ -531,7 +541,7 @@ function coverageEvidenceCounts(report) {
  * Returns `null` when the edited file isn't a skill/agent surface, or when it is
  * covered on both tiers. Never throws — a nudge must not disrupt an edit.
  */
-function skillTestNudge(filePath, options = {}) {
+function skillTestNudge(filePath, options) {
     let report;
     try {
         report = findUntestedSurfaces({ ...options, hooks: false });

package/dist/verify-plugin-guards.js

@@ -573,7 +573,7 @@ function experimental_verifyPluginGuards(dir, opts = {}) {
     // A harness whose hooks are not shell processes has nothing this tier can
     // drive. Saying so is the `no-silent-skips` half — an empty `hooks` list with
     // no note is indistinguishable from "we looked and it was fine".
-    if (!adapter.capabilities.shellHooks || !adapter.hookProtocol)
+    if (!adapter.shellHooks || !adapter.hookProtocol)
         return {
             ...base,
             hooks: [],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vigiles",
-  "version": "29.1.0",
+  "version": "30.0.1",
   "description": "Audit, test and measure the harness your AI agent runs on — grade your CLAUDE.md / AGENTS.md, skills, subagents and hooks, run them against a scripted model, and measure whether they actually fire.",
   "keywords": [
     "claude-code",

package/dist/skill-reachability.d.ts

@@ -1,68 +0,0 @@
-/** The plugin id `claude plugin install` records — `<plugin>@<marketplace>`. */
-export declare const VIGILES_PLUGIN_ID = "vigiles@vigiles";
-/**
- * Where a reachable install was found. Deliberately does NOT include a project
- * `enabledPlugins` entry: that declares the plugin, it does not install it (see
- * the header). It is reported as {@link SkillReachability.declaredNotInstalled}.
- */
-export type ReachabilitySource = 
-/** `~/.claude/plugins/installed_plugins.json` — what `claude plugin install` writes. */
-"global-plugin"
-/** The skills vendored into the repo's own `.claude/skills/` (standalone config, always loaded). */
- | "repo-skills";
-/** The advisory: can the agent see vigiles's skills from this repo? */
-export interface SkillReachability {
-    /** True when at least one {@link ReachabilitySource} was found. */
-    readonly reachable: boolean;
-    /** Every source that resolved, in check order. Empty when un-wired. */
-    readonly sources: readonly ReachabilitySource[];
-    /**
-     * The repo's `.claude/settings.json` enables the plugin, but no install was
-     * found. Claude Code will prompt this collaborator to install it; until they
-     * do, it does not load. A distinct state from "nothing configured at all",
-     * because the fix belongs to the person, not the repo.
-     */
-    readonly declaredNotInstalled: boolean;
-    /**
-     * Shipped skills found under `node_modules/vigiles/skills/` while UNREACHABLE
-     * — present on disk, invisible to the agent. Empty when reachable (there is
-     * nothing stranded if they are wired) or when the package isn't installed yet.
-     */
-    readonly strandedSkills: readonly string[];
-}
-/**
- * Is `vigiles` a declared dependency of this package.json text? Pure. Any of the
- * four dependency fields counts — the question is "did this repo take vigiles
- * on", not how.
- */
-export declare function declaresVigilesDependency(pkgJson: string): boolean;
-/**
- * Does the global registry record a live install of the vigiles plugin? Pure over
- * the raw `installed_plugins.json` text. An entry with an EMPTY array is a
- * leftover record, not an install, so it does not count.
- */
-export declare function hasGlobalPluginInstall(installedPluginsJson: string): boolean;
-/**
- * Does the repo's `.claude/settings.json` explicitly enable the vigiles plugin?
- * Pure. An explicit `false` is a deliberate disable and does NOT count.
- */
-export declare function hasEnabledPlugin(settingsJson: string): boolean;
-/**
- * Best-effort, read-local reachability check for `vigiles audit`. Returns null
- * when the question does not apply — the repo has no package.json, or does not
- * depend on vigiles, or IS vigiles — so a non-consumer is never nagged. NEVER
- * throws: every read degrades to "not found".
- *
- * `opts.home` overrides `$HOME` (tests, and any caller with a relocated config).
- */
-export declare function checkSkillReachability(dir: string, opts?: {
-    readonly home?: string;
-}): SkillReachability | null;
-/**
- * The warning for an un-wired repo, or null when there is nothing to say
- * (reachable, or the check did not apply). Names the skill the user most likely
- * went looking for, says where the copies are stranded when they exist, and ends
- * on a command that fixes it.
- */
-export declare function formatSkillReachability(r: SkillReachability | null): string | null;
-//# sourceMappingURL=skill-reachability.d.ts.map

package/dist/skill-reachability.js

@@ -1,205 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.VIGILES_PLUGIN_ID = void 0;
-exports.declaresVigilesDependency = declaresVigilesDependency;
-exports.hasGlobalPluginInstall = hasGlobalPluginInstall;
-exports.hasEnabledPlugin = hasEnabledPlugin;
-exports.checkSkillReachability = checkSkillReachability;
-exports.formatSkillReachability = formatSkillReachability;
-/**
- * Are vigiles's SHIPPED SKILLS actually reachable by the agent in this repo?
- *
- * vigiles publishes six user-facing skills (`SHIPPED_SKILLS`) — the teaching
- * surface. `test-harness` alone answers "which testing tier do I want?", the
- * question this project's docs are otherwise organized around. They reach the
- * agent through the GLOBAL plugin install (`vigiles init`, or
- * `claude plugin marketplace add zernie/vigiles` + `claude plugin install
- * vigiles@vigiles`), which lands in `~/.claude/plugins/` — deliberately never
- * vendored into the repo (`docs/agent-setup.md`).
- *
- * The failure this module makes loud: `npm install vigiles` ALSO puts those
- * skills on disk, at `node_modules/vigiles/skills/` (they are in package.json's
- * `files`, because the npm tarball doubles as the plugin payload). Claude Code
- * never scans `node_modules`. So a repo that took the dependency but never ran
- * the plugin install has all six skills present, unreachable, and **silent** —
- * observed in a real consumer repo, where a full day went into re-deriving what
- * `test-harness` teaches while it sat three directories away.
- *
- * ⚠️ The part that is easy to get wrong, and did get wrong TWICE, in opposite
- * directions:
- *
- * 1. The authoritative record of a `claude plugin install` is the GLOBAL
- *    `~/.claude/plugins/installed_plugins.json`. A repo's `.claude/settings.json`
- *    carries PROJECT-level `enabledPlugins`, which a correctly-installed
- *    user-scope plugin does not appear in. Judging "is it wired?" from
- *    `settings.json` alone reports a working install as broken — the misread
- *    that made this look like an npm packaging bug.
- * 2. The converse is ALSO false: a project `enabledPlugins` entry does not make
- *    the plugin load. Per the Claude Code docs (Discover plugins → "Configure
- *    team marketplaces"), as of CC v2.1.195 — "A plugin that only the project's
- *    `.claude/settings.json` enables, and that comes from an external source
- *    such as a GitHub repository or npm package, doesn't load until the team
- *    member installs it." vigiles ships from a GitHub marketplace, so that is
- *    exactly our case. Committing `extraKnownMarketplaces` + `enabledPlugins`
- *    makes Claude Code PROMPT each collaborator to install; it does not install.
- *    Confirmed empirically: in a repo whose committed settings.json declares an
- *    external plugin project-level, the global registry had no marketplace
- *    entry, no cache dir, and no install record for it, while a plugin installed
- *    the normal way on the same machine had all three.
- *
- * So a project declaration is a THIRD state — declared, not installed — that
- * still warrants a warning, with a different fix line: the collaborator runs the
- * install, the repo cannot run it for them.
- *
- * Shape follows `src/dialect-drift.ts`: pure parsers + a best-effort local read
- * that NEVER throws + a formatter that returns null when there is nothing to
- * say, so `vigiles audit` can print it without a new verb, flag, or failure mode.
- * It is ADVISORY — it never touches the audit score, because reachability is a
- * property of the machine (is the plugin installed?), not of the repo, and a
- * score that moved between a laptop and CI for identical source would be a lie.
- */
-const node_fs_1 = require("node:fs");
-const node_os_1 = require("node:os");
-const node_path_1 = require("node:path");
-const setup_plan_js_1 = require("./setup-plan.js");
-/** The plugin id `claude plugin install` records — `<plugin>@<marketplace>`. */
-exports.VIGILES_PLUGIN_ID = "vigiles@vigiles";
-/**
- * Is `vigiles` a declared dependency of this package.json text? Pure. Any of the
- * four dependency fields counts — the question is "did this repo take vigiles
- * on", not how.
- */
-function declaresVigilesDependency(pkgJson) {
-    let pkg;
-    try {
-        pkg = JSON.parse(pkgJson);
-    }
-    catch {
-        return false;
-    }
-    // The vigiles repo itself is not a consumer — it IS the plugin.
-    if (pkg.name === "vigiles")
-        return false;
-    const fields = [
-        "dependencies",
-        "devDependencies",
-        "peerDependencies",
-        "optionalDependencies",
-    ];
-    return fields.some((f) => {
-        const deps = pkg[f];
-        return typeof deps === "object" && deps !== null && "vigiles" in deps;
-    });
-}
-/**
- * Does the global registry record a live install of the vigiles plugin? Pure over
- * the raw `installed_plugins.json` text. An entry with an EMPTY array is a
- * leftover record, not an install, so it does not count.
- */
-function hasGlobalPluginInstall(installedPluginsJson) {
-    try {
-        const parsed = JSON.parse(installedPluginsJson);
-        const entry = parsed.plugins?.[exports.VIGILES_PLUGIN_ID];
-        return Array.isArray(entry) && entry.length > 0;
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * Does the repo's `.claude/settings.json` explicitly enable the vigiles plugin?
- * Pure. An explicit `false` is a deliberate disable and does NOT count.
- */
-function hasEnabledPlugin(settingsJson) {
-    try {
-        const parsed = JSON.parse(settingsJson);
-        return parsed.enabledPlugins?.[exports.VIGILES_PLUGIN_ID] === true;
-    }
-    catch {
-        return false;
-    }
-}
-/** Directory names directly under `dir`, or [] when it isn't readable. */
-function dirNames(dir) {
-    try {
-        return (0, node_fs_1.readdirSync)(dir, { withFileTypes: true })
-            .filter((e) => e.isDirectory())
-            .map((e) => e.name);
-    }
-    catch {
-        return [];
-    }
-}
-/** Read a file, or null when it isn't there / isn't readable. Never throws. */
-function readOrNull(path) {
-    try {
-        return (0, node_fs_1.existsSync)(path) ? (0, node_fs_1.readFileSync)(path, "utf-8") : null;
-    }
-    catch {
-        return null;
-    }
-}
-/**
- * Best-effort, read-local reachability check for `vigiles audit`. Returns null
- * when the question does not apply — the repo has no package.json, or does not
- * depend on vigiles, or IS vigiles — so a non-consumer is never nagged. NEVER
- * throws: every read degrades to "not found".
- *
- * `opts.home` overrides `$HOME` (tests, and any caller with a relocated config).
- */
-function checkSkillReachability(dir, opts = {}) {
-    const pkgJson = readOrNull((0, node_path_1.join)(dir, "package.json"));
-    if (pkgJson === null || !declaresVigilesDependency(pkgJson))
-        return null;
-    const home = opts.home ?? (0, node_os_1.homedir)();
-    const sources = [];
-    const installed = readOrNull((0, node_path_1.join)(home, ".claude", "plugins", "installed_plugins.json"));
-    if (installed !== null && hasGlobalPluginInstall(installed))
-        sources.push("global-plugin");
-    // Vendored copies: only vigiles's OWN skill names count. A repo with 38
-    // unrelated skills in `.claude/skills/` is still un-wired.
-    const repoSkills = new Set(dirNames((0, node_path_1.join)(dir, ".claude", "skills")));
-    if (setup_plan_js_1.SHIPPED_SKILLS.some((s) => repoSkills.has(s)))
-        sources.push("repo-skills");
-    const reachable = sources.length > 0;
-    // A project declaration is NOT a source — it makes Claude Code prompt for an
-    // install, it does not perform one. Only meaningful while unreachable.
-    const settings = readOrNull((0, node_path_1.join)(dir, ".claude", "settings.json"));
-    const declaredNotInstalled = !reachable && settings !== null && hasEnabledPlugin(settings);
-    const vendored = new Set(dirNames((0, node_path_1.join)(dir, "node_modules", "vigiles", "skills")));
-    return {
-        reachable,
-        sources,
-        declaredNotInstalled,
-        strandedSkills: reachable
-            ? []
-            : setup_plan_js_1.SHIPPED_SKILLS.filter((s) => vendored.has(s)),
-    };
-}
-/**
- * The warning for an un-wired repo, or null when there is nothing to say
- * (reachable, or the check did not apply). Names the skill the user most likely
- * went looking for, says where the copies are stranded when they exist, and ends
- * on a command that fixes it.
- */
-function formatSkillReachability(r) {
-    if (!r || r.reachable)
-        return null;
-    const stranded = r.strandedSkills.length > 0
-        ? ` ${String(r.strandedSkills.length)} of them are sitting in ` +
-            `node_modules/vigiles/skills/, which the agent never scans.`
-        : "";
-    const why = r.declaredNotInstalled
-        ? `This repo DECLARES the vigiles plugin in .claude/settings.json, but a ` +
-            `project declaration doesn't install it — Claude Code loads an ` +
-            `external-source plugin only once each collaborator installs it on their ` +
-            `own machine.`
-        : `This repo depends on vigiles, but its plugin isn't installed.`;
-    return (`⚠ vigiles's skills are NOT reachable by your agent here. ${why} So the ` +
-        `shipped skills (${setup_plan_js_1.SHIPPED_SKILLS.join(", ")}) can't be selected — ` +
-        `including test-harness, which picks the testing tier for you.${stranded}\n` +
-        `  Fix (per machine): claude plugin marketplace add zernie/vigiles && ` +
-        `claude plugin install ${exports.VIGILES_PLUGIN_ID}\n` +
-        `  (or run \`vigiles init\`, which does both)`);
-}
-//# sourceMappingURL=skill-reachability.js.map