@vyuhlabs/dxkit 2.4.8 → 2.5.1

package/dist/ship-installers.js

@@ -0,0 +1,530 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectDefaultBranch = detectDefaultBranch;
+exports.installHooks = installHooks;
+exports.installDevcontainer = installDevcontainer;
+exports.installCiGuardrails = installCiGuardrails;
+exports.installCiBaselineRefresh = installCiBaselineRefresh;
+exports.installPrReview = installPrReview;
+exports.installIgnoreFiles = installIgnoreFiles;
+exports.installHooksPostinstall = installHooksPostinstall;
+/**
+ * Phase Ship installers — additive copy of dxkit's guardrail templates
+ * into a consumer repo. Wired into `vyuh-dxkit init` via the
+ * `--with-hooks` / `--with-devcontainer` / `--with-ci` /
+ * `--with-baseline-refresh` flags (or `--full` which implies all).
+ *
+ * Each installer is additive by default: existing consumer files are
+ * never overwritten. When a conflict is detected, the installer
+ * writes a sidecar (`.dxkit`-suffixed) reference file and emits a
+ * note with merge instructions. `force: true` bypasses the sidecar
+ * fallback and overwrites in place.
+ */
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
+const files_1 = require("./files");
+const detect_1 = require("./detect");
+const languages_1 = require("./languages");
+/**
+ * Detect the consumer repo's default branch so workflow templates
+ * that fire on pushes to "the main branch" point at the right name.
+ * The resolution order is intentionally lenient — we'd rather
+ * substitute *some* sensible branch and let the consumer edit the
+ * workflow than refuse to install when git state is incomplete.
+ *
+ *   1. `git symbolic-ref refs/remotes/origin/HEAD` (set whenever the
+ *      repo was cloned from a remote with a default-branch HEAD)
+ *   2. `git rev-parse --verify <name>` against `main` / `master` /
+ *      `trunk` / `develop` — the four conventions that cover ~all
+ *      real repos
+ *   3. The current branch (`git branch --show-current`) — the best
+ *      guess in a freshly-`git init`'d repo that hasn't been pushed
+ *   4. Fallback to `'main'` — the GitHub default-branch default
+ */
+function detectDefaultBranch(cwd) {
+    try {
+        const ref = (0, child_process_1.execFileSync)('git', ['symbolic-ref', 'refs/remotes/origin/HEAD'], {
+            cwd,
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+        }).trim();
+        const match = ref.match(/^refs\/remotes\/origin\/(.+)$/);
+        if (match && match[1])
+            return match[1];
+    }
+    catch {
+        /* fall through */
+    }
+    for (const candidate of ['main', 'master', 'trunk', 'develop']) {
+        try {
+            (0, child_process_1.execFileSync)('git', ['rev-parse', '--verify', '--quiet', candidate], {
+                cwd,
+                stdio: 'ignore',
+            });
+            return candidate;
+        }
+        catch {
+            /* try next */
+        }
+    }
+    try {
+        const current = (0, child_process_1.execFileSync)('git', ['branch', '--show-current'], {
+            cwd,
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+        }).trim();
+        if (current)
+            return current;
+    }
+    catch {
+        /* fall through */
+    }
+    return 'main';
+}
+function emptyResult() {
+    return { installed: [], skipped: [], sidecars: [], notes: [] };
+}
+function templatesDir() {
+    return path.join(__dirname, '..', 'templates');
+}
+/**
+ * Copy a single source file to a destination, handling the
+ * additive-vs-force decision. Returns the (relative) path that was
+ * written + which bucket it lands in.
+ */
+function copyAdditive(srcAbs, destAbs, cwd, opts, result, options = {}) {
+    const relDest = path.relative(cwd, destAbs);
+    const exists = fs.existsSync(destAbs);
+    if (exists && !opts.force) {
+        const suffix = options.sidecarSuffix ?? '.dxkit';
+        const sidecarAbs = destAbs + suffix;
+        const relSidecar = path.relative(cwd, sidecarAbs);
+        fs.mkdirSync(path.dirname(sidecarAbs), { recursive: true });
+        fs.copyFileSync(srcAbs, sidecarAbs);
+        if (options.executable)
+            (0, files_1.makeExecutable)(sidecarAbs);
+        result.sidecars.push(relSidecar);
+        return;
+    }
+    fs.mkdirSync(path.dirname(destAbs), { recursive: true });
+    fs.copyFileSync(srcAbs, destAbs);
+    if (options.executable)
+        (0, files_1.makeExecutable)(destAbs);
+    if (exists) {
+        result.installed.push(relDest);
+    }
+    else {
+        result.installed.push(relDest);
+    }
+}
+/**
+ * Hooks installer. Writes `.githooks/pre-push` by default;
+ * additionally writes `.githooks/pre-commit` when
+ * `opts.withPrecommit === true`. When the consumer already has a
+ * matching hook (via .githooks/ or .husky/), emits a `.dxkit`
+ * sidecar instead and prints merge instructions.
+ *
+ * Customer still needs to run `git config core.hooksPath .githooks`
+ * to activate. We don't run it for them — that's a global git config
+ * mutation outside dxkit's purview.
+ *
+ * Why pre-commit is opt-in: see `InstallerOpts.withPrecommit`.
+ */
+function installHooks(cwd, opts = {}) {
+    const result = emptyResult();
+    const tmplDir = path.join(templatesDir(), '.githooks');
+    const destDir = path.join(cwd, '.githooks');
+    // Husky users have hooks at `.husky/<name>`. We treat either an
+    // existing `.githooks/<name>` *or* `.husky/<name>` as a conflict —
+    // both routes mean the consumer already has an active hook, even
+    // though only the .githooks/ path is the destination we write to.
+    //
+    // pre-commit is opt-in (slow on large repos until incremental
+    // scanning lands); pre-push always installs (acceptable cost).
+    const hookNames = opts.withPrecommit
+        ? [{ name: 'pre-commit' }, { name: 'pre-push' }]
+        : [{ name: 'pre-push' }];
+    let anyConflict = false;
+    for (const { name } of hookNames) {
+        const destAbs = path.join(destDir, name);
+        const huskyAbs = path.join(cwd, '.husky', name);
+        const conflict = fs.existsSync(destAbs) || fs.existsSync(huskyAbs);
+        if (conflict)
+            anyConflict = true;
+        const srcAbs = path.join(tmplDir, name);
+        if (conflict && !opts.force) {
+            // Always land the dxkit hook at .githooks/<name>.dxkit when
+            // there's a conflict, even when the conflict is at a different
+            // path (husky). The sidecar is the same regardless of where the
+            // existing hook lives, and the merge note tells the consumer
+            // how to chain them.
+            const sidecarAbs = destAbs + '.dxkit';
+            fs.mkdirSync(path.dirname(sidecarAbs), { recursive: true });
+            fs.copyFileSync(srcAbs, sidecarAbs);
+            (0, files_1.makeExecutable)(sidecarAbs);
+            result.sidecars.push(path.relative(cwd, sidecarAbs));
+        }
+        else {
+            fs.mkdirSync(path.dirname(destAbs), { recursive: true });
+            fs.copyFileSync(srcAbs, destAbs);
+            (0, files_1.makeExecutable)(destAbs);
+            result.installed.push(path.relative(cwd, destAbs));
+        }
+    }
+    if (anyConflict) {
+        result.notes.push('Detected an existing pre-commit/pre-push hook. The dxkit hooks were ' +
+            'written as `.dxkit` sidecars next to your existing hooks; add a ' +
+            '`sh .githooks/<name>.dxkit` line to each existing hook to chain them.');
+    }
+    result.notes.push('Activate the hooks: `git config core.hooksPath .githooks` (one-time, per clone).');
+    if (!opts.withPrecommit) {
+        result.notes.push('pre-commit hook NOT installed (default). The full guardrail re-runs every analyzer ' +
+            'and is slow on large repos. Pre-push catches the same regressions before code leaves ' +
+            'the machine. Re-run init with `--with-precommit-hook` to enable commit-time gating.');
+    }
+    return result;
+}
+/**
+ * Render the per-stack features block as a properly-indented JSON
+ * fragment slotted into the template's `"features": __PLACEHOLDER__`
+ * line. The first line stays flush; continuation lines get the
+ * template's two-space outer indent so the resulting object reads
+ * naturally inside the surrounding JSONC.
+ */
+function renderFeaturesBlock(features) {
+    const raw = JSON.stringify(features, null, 2);
+    return raw
+        .split('\n')
+        .map((line, i) => (i === 0 ? line : '  ' + line))
+        .join('\n');
+}
+/**
+ * Read the devcontainer.json template, substitute the
+ * `__DXKIT_DEVCONTAINER_FEATURES__` placeholder with the detected
+ * stack's features block, and return the rendered text. Pure-ish:
+ * one filesystem read, no writes.
+ */
+function renderDevcontainerJson(tmplDir, cwd) {
+    const srcAbs = path.join(tmplDir, 'devcontainer.json');
+    const template = fs.readFileSync(srcAbs, 'utf8');
+    const stack = (0, detect_1.detect)(cwd);
+    const features = (0, languages_1.buildDevcontainerFeatures)(stack.languages);
+    return template.replace('__DXKIT_DEVCONTAINER_FEATURES__', renderFeaturesBlock(features));
+}
+/**
+ * Devcontainer installer. Writes the dxkit lightweight devcontainer
+ * (devcontainer.json + post-create.sh + install-agent-clis.sh) into
+ * `.devcontainer/`. If the consumer already has a devcontainer.json,
+ * writes the entire dxkit set into `.devcontainer/.dxkit-reference/`
+ * for manual merge.
+ *
+ * devcontainer.json is rendered per-detected-stack: only active
+ * packs' features land in the output. Always-on entries (Node +
+ * GitHub CLI) ship regardless so the post-create script can run on
+ * a non-Node project.
+ */
+function installDevcontainer(cwd, opts = {}) {
+    const result = emptyResult();
+    const tmplDir = path.join(templatesDir(), '.devcontainer');
+    const destDir = path.join(cwd, '.devcontainer');
+    const filesToCopyVerbatim = [
+        { name: 'post-create.sh', executable: true },
+        { name: 'install-agent-clis.sh', executable: true },
+    ];
+    const hasExistingDevcontainer = fs.existsSync(path.join(destDir, 'devcontainer.json'));
+    if (hasExistingDevcontainer && !opts.force) {
+        // Stash the whole dxkit set under a reference dir so the
+        // consumer can read it without it interfering with their own.
+        // The reference devcontainer.json is rendered with the
+        // per-stack features so the customer sees the same shape as
+        // a fresh install — they can lift the features block directly.
+        const refDir = path.join(destDir, '.dxkit-reference');
+        fs.mkdirSync(refDir, { recursive: true });
+        const renderedJson = renderDevcontainerJson(tmplDir, cwd);
+        fs.writeFileSync(path.join(refDir, 'devcontainer.json'), renderedJson, 'utf8');
+        result.sidecars.push(path.relative(cwd, path.join(refDir, 'devcontainer.json')));
+        for (const f of filesToCopyVerbatim) {
+            const srcAbs = path.join(tmplDir, f.name);
+            const destAbs = path.join(refDir, f.name);
+            fs.copyFileSync(srcAbs, destAbs);
+            if (f.executable)
+                (0, files_1.makeExecutable)(destAbs);
+            result.sidecars.push(path.relative(cwd, destAbs));
+        }
+        result.notes.push('Existing devcontainer.json detected — dxkit pieces stashed in ' +
+            '`.devcontainer/.dxkit-reference/`. To enable dxkit guardrails in ' +
+            'your container: (1) merge the `features` block from the reference ' +
+            'devcontainer.json into yours, (2) add `bash .devcontainer/post-create.sh` ' +
+            'to your `postCreateCommand`, (3) copy `post-create.sh` and ' +
+            '`install-agent-clis.sh` into `.devcontainer/`.');
+        return result;
+    }
+    // devcontainer.json gets rendered (per-stack features substitution),
+    // the rest are flat copies.
+    fs.mkdirSync(destDir, { recursive: true });
+    const renderedJson = renderDevcontainerJson(tmplDir, cwd);
+    const destDevcontainerJson = path.join(destDir, 'devcontainer.json');
+    fs.writeFileSync(destDevcontainerJson, renderedJson, 'utf8');
+    result.installed.push(path.relative(cwd, destDevcontainerJson));
+    for (const f of filesToCopyVerbatim) {
+        copyAdditive(path.join(tmplDir, f.name), path.join(destDir, f.name), cwd, { force: true }, result, { executable: f.executable });
+    }
+    return result;
+}
+/**
+ * Generic workflow installer used by both --with-ci (PR-gate) and
+ * --with-baseline-refresh (post-merge auto-regen). Both targets are
+ * uniquely-named workflow files; conflict only happens on a re-run
+ * against an existing dxkit install, which we skip with a note.
+ *
+ * `substitutions` lets a workflow template carry placeholders the
+ * installer fills in at write time. The baseline-refresh workflow
+ * uses this for the consumer's default branch name; the PR-gate
+ * workflow ships verbatim.
+ */
+function installWorkflow(cwd, fileName, opts, substitutions = {}) {
+    const result = emptyResult();
+    const srcAbs = path.join(templatesDir(), '.github', 'workflows', fileName);
+    const destAbs = path.join(cwd, '.github', 'workflows', fileName);
+    if (fs.existsSync(destAbs) && !opts.force) {
+        result.skipped.push(path.relative(cwd, destAbs));
+        return result;
+    }
+    fs.mkdirSync(path.dirname(destAbs), { recursive: true });
+    if (Object.keys(substitutions).length === 0) {
+        fs.copyFileSync(srcAbs, destAbs);
+    }
+    else {
+        let content = fs.readFileSync(srcAbs, 'utf8');
+        for (const [key, value] of Object.entries(substitutions)) {
+            content = content.split(key).join(value);
+        }
+        fs.writeFileSync(destAbs, content, 'utf8');
+    }
+    result.installed.push(path.relative(cwd, destAbs));
+    return result;
+}
+function installCiGuardrails(cwd, opts = {}) {
+    return installWorkflow(cwd, 'dxkit-guardrails.yml', opts);
+}
+function installCiBaselineRefresh(cwd, opts = {}) {
+    const defaultBranch = detectDefaultBranch(cwd);
+    const result = installWorkflow(cwd, 'dxkit-baseline-refresh.yml', opts, {
+        __DXKIT_DEFAULT_BRANCH__: defaultBranch,
+    });
+    if (result.installed.length > 0 && defaultBranch !== 'main') {
+        result.notes.push(`baseline-refresh workflow targets the '${defaultBranch}' branch (detected from your repo). ` +
+            `Edit the workflow's \`branches:\` trigger if you want a different one.`);
+    }
+    return result;
+}
+/**
+ * AI PR-review workflow installer. Writes
+ * `.github/workflows/pr-review.yml` — a workflow that runs Claude
+ * Code over a PR's diff and posts a review comment.
+ *
+ * Opt-in (via `--with-pr-review`) because the workflow needs an
+ * `ANTHROPIC_API_KEY` repo secret AND a flipped `ENABLE_AI_REVIEW`
+ * repo variable to actually run anything; without both, the
+ * workflow file just sits inert in the repo and clutters the
+ * Actions tab. Customers who want this should opt in explicitly
+ * with the flag (and configure the repo secret + variable
+ * separately).
+ */
+function installPrReview(cwd, opts = {}) {
+    const result = installWorkflow(cwd, 'pr-review.yml', opts);
+    if (result.installed.length > 0) {
+        result.notes.push('pr-review.yml is dormant until you configure both: ' +
+            '(1) `ANTHROPIC_API_KEY` repo secret, and ' +
+            '(2) `ENABLE_AI_REVIEW=true` repo variable.');
+    }
+    return result;
+}
+const GITIGNORE_HEADER = '# dxkit — runtime outputs (analyzer reports + dashboard)';
+const GITIGNORE_ENTRIES = [
+    '.dxkit/reports/',
+    '.dxkit/dashboard.html',
+    '.dxkit/cache/',
+    'graphify-out/',
+];
+/**
+ * Seed `.gitignore` with dxkit's runtime-output paths and write a
+ * starter `.dxkit-ignore` template explaining the optional dxkit-
+ * specific scan-exclusion file.
+ *
+ * Concerns the seeded files address:
+ *   - `.gitignore`: stops customers from accidentally committing
+ *     `.dxkit/reports/*.md` and `.dxkit/dashboard.html` (which
+ *     churn on every analyzer run). Selectively keeps
+ *     `.dxkit/baselines/` tracked — it IS the guardrail anchor.
+ *   - `.dxkit-ignore`: dxkit's own scan-exclusion file. Loaded by
+ *     `loadExclusions()` if present; never created by dxkit before
+ *     this commit. Seeding a documented template makes the feature
+ *     discoverable.
+ *
+ * Both are additive: existing `.gitignore` entries are preserved
+ * (dedup against current contents); existing `.dxkit-ignore` is
+ * never overwritten.
+ */
+function installIgnoreFiles(cwd, opts = {}) {
+    const result = emptyResult();
+    // .gitignore: append runtime-output entries
+    const gitignorePath = path.join(cwd, '.gitignore');
+    let existing = '';
+    if (fs.existsSync(gitignorePath)) {
+        existing = fs.readFileSync(gitignorePath, 'utf-8');
+        if (existing.includes(GITIGNORE_HEADER)) {
+            result.skipped.push('.gitignore');
+        }
+        else {
+            const existingLines = new Set(existing.split('\n').map((l) => l.trim()));
+            const newEntries = GITIGNORE_ENTRIES.filter((e) => !existingLines.has(e));
+            if (newEntries.length > 0) {
+                const block = '\n' + GITIGNORE_HEADER + '\n' + newEntries.join('\n') + '\n';
+                fs.appendFileSync(gitignorePath, block, 'utf-8');
+                result.installed.push('.gitignore');
+            }
+            else {
+                result.skipped.push('.gitignore');
+            }
+        }
+    }
+    else {
+        const content = GITIGNORE_HEADER + '\n' + GITIGNORE_ENTRIES.join('\n') + '\n';
+        fs.writeFileSync(gitignorePath, content, 'utf-8');
+        result.installed.push('.gitignore');
+    }
+    // .dxkit-ignore: write starter template (never overwrite)
+    const dxkitIgnorePath = path.join(cwd, '.dxkit-ignore');
+    if (fs.existsSync(dxkitIgnorePath) && !opts.force) {
+        result.skipped.push('.dxkit-ignore');
+    }
+    else {
+        fs.writeFileSync(dxkitIgnorePath, DXKIT_IGNORE_TEMPLATE, 'utf-8');
+        result.installed.push('.dxkit-ignore');
+    }
+    return result;
+}
+/**
+ * Wire `vyuh-dxkit hooks activate` into the consumer's `package.json`
+ * postinstall script so cloning + `npm install` auto-activates the
+ * dxkit hook directory. Closes the per-clone "run this one git config
+ * command" friction step that today's installHooks emits as a note.
+ *
+ * Conflict policy (mirrors the rest of the ship surface):
+ *   - No package.json → skip cleanly (Python-only / Go-only / etc.
+ *     repos use the existing manual-activation path).
+ *   - scripts.postinstall absent → write ours.
+ *   - scripts.postinstall already mentions `vyuh-dxkit hooks activate`
+ *     → skip (idempotent re-runs).
+ *   - scripts.postinstall is set to something else → leave it alone
+ *     and emit a note asking the consumer to chain. Auto-chaining
+ *     risks breaking their existing script's exit-code semantics.
+ */
+const POSTINSTALL_CMD = 'vyuh-dxkit hooks activate';
+function installHooksPostinstall(cwd, _opts = {}) {
+    const result = emptyResult();
+    const pkgPath = path.join(cwd, 'package.json');
+    if (!fs.existsSync(pkgPath)) {
+        // Non-Node repos (Python-only, Go-only, .NET-only, etc.) — no
+        // postinstall surface to wire into. Fall back to the existing
+        // manual note emitted by `installHooks`.
+        return result;
+    }
+    let raw;
+    try {
+        raw = fs.readFileSync(pkgPath, 'utf-8');
+    }
+    catch {
+        return result;
+    }
+    let pkg;
+    try {
+        pkg = JSON.parse(raw);
+    }
+    catch {
+        // Malformed package.json — bail rather than risk corrupting it.
+        result.notes.push(`Skipped postinstall hooks-activation wire-up: ${path.relative(cwd, pkgPath)} is not valid JSON.`);
+        return result;
+    }
+    const existing = pkg.scripts?.postinstall;
+    if (existing && existing.includes(POSTINSTALL_CMD)) {
+        result.skipped.push('package.json (postinstall)');
+        return result;
+    }
+    if (existing && existing.trim().length > 0) {
+        // Don't auto-chain — too risky. Surface a clear note instead.
+        result.notes.push(`Existing package.json scripts.postinstall preserved. To auto-activate dxkit hooks on every clone, ` +
+            `chain by hand: \`"postinstall": "${existing} && ${POSTINSTALL_CMD}"\`.`);
+        return result;
+    }
+    pkg.scripts = { ...(pkg.scripts ?? {}), postinstall: POSTINSTALL_CMD };
+    // Preserve trailing newline if the original had one — many editors
+    // and linters expect it.
+    const trailingNewline = raw.endsWith('\n') ? '\n' : '';
+    fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + trailingNewline, 'utf-8');
+    result.installed.push('package.json (postinstall)');
+    result.notes.push('Wired `vyuh-dxkit hooks activate` into package.json postinstall — every clone + `npm install` ' +
+        'will activate `core.hooksPath = .githooks` automatically. (Manual one-time activation no longer needed.)');
+    return result;
+}
+const DXKIT_IGNORE_TEMPLATE = `# .dxkit-ignore — extra paths dxkit's analyzers should skip.
+#
+# Format: same as .gitignore (directory/, file-glob, multi-segment).
+# Union'd on top of:
+#   - dxkit's bundled defaults (node_modules/, dist/, .git/, build/, ...)
+#   - this repo's .gitignore
+#
+# Use this file for dxkit-specific exclusions that you don't want in
+# .gitignore (e.g. vendored code you DO commit but DON'T want dxkit
+# to analyze for quality / coverage / security findings).
+#
+# Common examples (uncomment + adjust to your project):
+#
+# vendor/                    # vendored third-party code committed to git
+# third_party/
+# generated/                 # generated code (protobuf, GraphQL types, ORM)
+# *.generated.ts
+# *.designer.cs
+# legacy/                    # pre-existing code you don't want to track findings against
+# fixtures/large/            # test fixtures that inflate metrics
+#
+# After editing, the next \`vyuh-dxkit baseline create\` will pick up the
+# changes. Note: changes to this file invalidate cached baselines
+# (the file's content hash lands in the baseline envelope).
+`;
+//# sourceMappingURL=ship-installers.js.map

package/dist/ship-installers.js.map

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

package/dist/tools-cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools-cli.d.ts","sourceRoot":"","sources":["../src/tools-cli.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAWxC,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,aAAa,CAAC,WAAW,CAAC,EACrC,OAAO,GAAE,mBAAwB,GAChC,MAAM,EAAE,CAQV;AAoQD,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,IAAI,CAAC,CAYf"}
+{"version":3,"file":"tools-cli.d.ts","sourceRoot":"","sources":["../src/tools-cli.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAWxC,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,aAAa,CAAC,WAAW,CAAC,EACrC,OAAO,GAAE,mBAAwB,GAChC,MAAM,EAAE,CAQV;AA8SD,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,IAAI,CAAC,CAYf"}

package/dist/tools-cli.js

@@ -98,20 +98,26 @@ function sortByLayer(statuses) {
     });
 }
 function formatStatusLine(s) {
-    const icon = s.available ? '\x1b[32m✓\x1b[0m' : '\x1b[31m✗\x1b[0m';
     const name = s.name.padEnd(16);
     const layer = LAYER_LABEL[s.requirement.layer] || s.requirement.layer;
     const forStack = s.requirement.for.padEnd(7);
     if (s.available) {
         const src = s.source === 'path' ? '' : ` (${s.source})`;
-        return `  ${icon} ${name}  ${layer}  ${forStack}  ${logger.bold('found')}${src}`;
+        return `  \x1b[32m✓\x1b[0m ${name}  ${layer}  ${forStack}  ${logger.bold('found')}${src}`;
+    }
+    // N/A tools (applicability gate fired): show a distinct icon + the
+    // reason so users see "not for this stack" rather than "missing".
+    // These intentionally do NOT count toward the missing tally.
+    if (s.source === 'n/a') {
+        const reason = s.notApplicableReason ? ` \x1b[2m(${s.notApplicableReason})\x1b[0m` : '';
+        return `  \x1b[2m−\x1b[0m ${name}  ${layer}  ${forStack}  \x1b[2mn/a${reason ? '' : ' for this stack'}\x1b[0m${reason}`;
     }
     // Project-local tools (F-UX-3): annotate so users don't confuse a
     // missing dev-dep with a missing system tool.
     const scopeNote = s.requirement.installScope === 'project-local'
         ? ' \x1b[2m(project-local — `npm ci`)\x1b[0m'
         : '';
-    return `  ${icon} ${name}  ${layer}  ${forStack}  \x1b[2mmissing\x1b[0m${scopeNote}`;
+    return `  \x1b[31m✗\x1b[0m ${name}  ${layer}  ${forStack}  \x1b[2mmissing\x1b[0m${scopeNote}`;
 }
 /** Show tool status for the repo's detected stack. */
 function showStatus(targetPath) {
@@ -134,14 +140,27 @@ function showStatus(targetPath) {
             logger.dim(`    path: ${s.path}`);
         }
     }
-    const missing = statuses.filter((s) => !s.available);
+    // Split the unavailable set: truly missing (actionable) vs n/a
+    // (informational — the applicability gate excluded the tool from
+    // this stack). Missing-count math must not include n/a entries or
+    // customers see false "1/14 missing" alarms on repos that
+    // legitimately don't use the tool.
+    const missing = statuses.filter((s) => !s.available && s.source !== 'n/a');
+    const notApplicable = statuses.filter((s) => s.source === 'n/a');
     const total = statuses.length;
+    const applicable = total - notApplicable.length;
     console.log('');
     if (missing.length === 0) {
-        logger.success(`All ${total} required tools available.`);
+        if (notApplicable.length === 0) {
+            logger.success(`All ${total} required tools available.`);
+        }
+        else {
+            logger.success(`All ${applicable} applicable tools available (${notApplicable.length} n/a for this stack).`);
+        }
     }
     else {
-        logger.warn(`${missing.length}/${total} tools missing.`);
+        const naSuffix = notApplicable.length > 0 ? `, ${notApplicable.length} n/a` : '';
+        logger.warn(`${missing.length}/${applicable} applicable tools missing${naSuffix}.`);
         console.log('');
         // F-UX-3: partition missing by install scope so the hint matches
         // where each tool actually lives. Project-local tools (eslint,
@@ -212,13 +231,29 @@ async function runInstall(targetPath, autoYes, options = {}) {
         statuses = showStatus(targetPath);
         modeLabel = 'Install missing tools';
     }
-    const missing = statuses.filter((s) => !s.available);
+    // Exclude n/a entries — applicability gate already determined the
+    // tool doesn't apply to this stack, so attempting an install would
+    // either no-op or pull in dead weight.
+    const missing = statuses.filter((s) => !s.available && s.source !== 'n/a');
+    const notApplicable = statuses.filter((s) => s.source === 'n/a');
+    // Targeted single-tool install hitting an n/a tool: surface the
+    // reason and exit cleanly rather than silently skipping. Users who
+    // explicitly typed the name deserve a direct answer.
+    if (options.toolName && notApplicable.length === 1 && missing.length === 0) {
+        const reason = notApplicable[0].notApplicableReason ?? 'not applicable to this stack';
+        logger.info(`${options.toolName} is not applicable here: ${reason}.`);
+        return;
+    }
     if (missing.length === 0) {
         if (options.toolName) {
             logger.success(`${options.toolName} is already installed.`);
         }
         else if (options.all) {
-            logger.success(`All ${statuses.length} known tools already installed.`);
+            const naSuffix = notApplicable.length > 0 ? ` (${notApplicable.length} n/a for this stack — skipped)` : '';
+            logger.success(`All ${statuses.length - notApplicable.length} applicable tools already installed.${naSuffix}`);
+        }
+        else if (notApplicable.length > 0) {
+            logger.success(`All applicable tools available (${notApplicable.length} n/a for this stack — skipped).`);
         }
         return;
     }
@@ -290,7 +325,8 @@ async function runInstall(targetPath, autoYes, options = {}) {
     const installed = results.filter((r) => r.status === 'installed').length;
     const skipped = results.filter((r) => r.status === 'skipped').length;
     const failed = results.filter((r) => r.status === 'failed').length;
-    logger.info(`${installed} installed, ${skipped} skipped, ${failed} failed`);
+    const naSuffix = notApplicable.length > 0 ? `, ${notApplicable.length} n/a` : '';
+    logger.info(`${installed} installed, ${skipped} skipped, ${failed} failed${naSuffix}`);
     if (failed > 0) {
         console.log('');
         logger.dim('Failed installs:');