@xenos1996/usa 2.15.0 → 2.16.0

package/dist/cli-args.d.ts

@@ -0,0 +1,25 @@
+import type { Depth, Maturity, Severity } from './types.js';
+/** Shared CLI plumbing: install paths, version, and argument accessors. */
+export declare const HERE: string;
+export declare const DEFAULT_RULES_DIR: string;
+export declare const VERSION: string;
+export declare const SEVERITY_ORDER: Severity[];
+export declare const DEPTHS: Depth[];
+export declare const MATURITIES: Maturity[];
+export interface Args {
+    _: string[];
+    [k: string]: string | boolean | string[] | undefined;
+}
+export declare function parseArgs(argv: string[]): Args;
+export declare function str(args: Args, key: string, fallback?: string): string | undefined;
+export declare function bool(args: Args, key: string): boolean;
+/**
+ * CLI-003: every command that writes files honors --dry-run. Call after pure
+ * argument validation with the resolved paths that WOULD be written: it
+ * prints one line per path and returns false, and the caller exits 0 before
+ * doing any work — no audit run, no model calls, no disk writes. With an
+ * empty list it says so explicitly rather than silently succeeding.
+ */
+export declare function dryRunWrites(args: Args, files: string[]): boolean;
+export declare function list(args: Args, key: string): string[];
+//# sourceMappingURL=cli-args.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli-args.d.ts","sourceRoot":"","sources":["../src/cli-args.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE5D,2EAA2E;AAC3E,eAAO,MAAM,IAAI,QAA+C,CAAC;AACjE,eAAO,MAAM,iBAAiB,QAAoC,CAAC;AACnE,eAAO,MAAM,OAAO,QAAgB,CAAC;AAErC,eAAO,MAAM,cAAc,EAAE,QAAQ,EAAoD,CAAC;AAC1F,eAAO,MAAM,MAAM,EAAE,KAAK,EAAkC,CAAC;AAC7D,eAAO,MAAM,UAAU,EAAE,QAAQ,EAAyD,CAAC;AAI3F,MAAM,WAAW,IAAI;IACnB,CAAC,EAAE,MAAM,EAAE,CAAC;IACZ,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC;CACtD;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAuB9C;AAED,wBAAgB,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGlF;AACD,wBAAgB,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAQjE;AACD,wBAAgB,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAStD"}

package/dist/cli-args.js

@@ -0,0 +1,90 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+/** Shared CLI plumbing: install paths, version, and argument accessors. */
+export const HERE = path.dirname(fileURLToPath(import.meta.url));
+export const DEFAULT_RULES_DIR = path.resolve(HERE, '..', 'rules');
+export const VERSION = readVersion();
+export const SEVERITY_ORDER = ['CRITICAL', 'HIGH', 'MEDIUM', 'LOW', 'FUTURE'];
+export const DEPTHS = ['quick', 'standard', 'deep'];
+export const MATURITIES = ['prototype', 'mvp', 'beta', 'production', 'legacy'];
+export function parseArgs(argv) {
+    const args = { _: [] };
+    for (let i = 0; i < argv.length; i++) {
+        const tok = argv[i];
+        if (!tok.startsWith('--')) {
+            args._.push(tok);
+            continue;
+        }
+        const body = tok.slice(2);
+        if (body.includes('=')) {
+            const [k, ...rest] = body.split('=');
+            args[k] = rest.join('=');
+            continue;
+        }
+        const next = argv[i + 1];
+        if (next === undefined || next.startsWith('--')) {
+            args[body] = true;
+        }
+        else {
+            args[body] = next;
+            i++;
+        }
+    }
+    return args;
+}
+export function str(args, key, fallback) {
+    const v = args[key];
+    return typeof v === 'string' ? v : fallback;
+}
+export function bool(args, key) {
+    return args[key] === true || args[key] === 'true';
+}
+/**
+ * CLI-003: every command that writes files honors --dry-run. Call after pure
+ * argument validation with the resolved paths that WOULD be written: it
+ * prints one line per path and returns false, and the caller exits 0 before
+ * doing any work — no audit run, no model calls, no disk writes. With an
+ * empty list it says so explicitly rather than silently succeeding.
+ */
+export function dryRunWrites(args, files) {
+    if (!bool(args, 'dry-run'))
+        return true;
+    if (files.length === 0) {
+        console.log('dry-run: nothing would be written');
+        return false;
+    }
+    for (const f of files)
+        console.log(`dry-run: would write ${path.resolve(f)}`);
+    return false;
+}
+export function list(args, key) {
+    const v = args[key];
+    if (Array.isArray(v))
+        return v;
+    if (typeof v === 'string')
+        return v
+            .split(',')
+            .map((s) => s.trim())
+            .filter(Boolean);
+    return [];
+}
+/* ------------------------------------------------------------------ utils -- */
+function readVersion() {
+    const candidates = [
+        path.resolve(HERE, '..', 'package.json'),
+        path.resolve(HERE, '..', '..', 'package.json'),
+    ];
+    for (const c of candidates) {
+        try {
+            const pkg = JSON.parse(fs.readFileSync(c, 'utf8'));
+            if (pkg.version)
+                return pkg.version;
+        }
+        catch {
+            /* fall through */
+        }
+    }
+    return '0.0.0';
+}
+//# sourceMappingURL=cli-args.js.map

package/dist/cli-args.js.map

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

package/dist/cli-audit.d.ts

@@ -0,0 +1,3 @@
+import { type Args } from './cli-args.js';
+export declare function cmdAudit(args: Args): number;
+//# sourceMappingURL=cli-audit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli-audit.d.ts","sourceRoot":"","sources":["../src/cli-audit.ts"],"names":[],"mappings":"AAYA,OAAO,EAUL,KAAK,IAAI,EACV,MAAM,eAAe,CAAC;AAoEvB,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CA2D3C"}

package/dist/cli-audit.js

@@ -0,0 +1,180 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { runAudit } from './engine/audit.js';
+import { loadConfig } from './config.js';
+import { renderMarkdown, parseTrailer } from './report/markdown.js';
+import { renderJson } from './report/json.js';
+import { renderSarif } from './report/sarif.js';
+import { renderNarrative } from './report/narrative.js';
+import { renderHtml } from './report/html.js';
+import { evaluateGate, evaluateNewCodeGate, parseBaselineTrailer } from './engine/gate.js';
+import { VERSION, DEFAULT_RULES_DIR, DEPTHS, MATURITIES, SEVERITY_ORDER, bool, dryRunWrites, list, str, } from './cli-args.js';
+import { writeTextFile } from './util/files.js';
+const FORMATS = ['md', 'json', 'sarif', 'narrative', 'html'];
+/** Resolves the report format from an explicit flag, else the --out suffix. */
+function resolveFormat(flag, out) {
+    if (flag)
+        return flag.toLowerCase();
+    const ext = path.extname(out).toLowerCase();
+    if (ext === '.json')
+        return 'json';
+    if (ext === '.sarif')
+        return 'sarif';
+    if (ext === '.html' || ext === '.htm')
+        return 'html';
+    return 'md';
+}
+function parseCountFlag(v) {
+    if (v === undefined)
+        return undefined;
+    const n = Number(v);
+    return Number.isFinite(n) ? n : NaN;
+}
+function readAuditOptions(args) {
+    const out = str(args, 'out', 'AUDIT.md') ?? 'AUDIT.md';
+    return {
+        target: args._[1] ?? '.',
+        rulesDir: path.resolve(str(args, 'rules-dir', DEFAULT_RULES_DIR) ?? DEFAULT_RULES_DIR),
+        depth: str(args, 'depth', 'standard') ?? 'standard',
+        profileArg: str(args, 'profile', 'auto') ?? 'auto',
+        out,
+        format: resolveFormat(str(args, 'format'), out),
+        failOn: (str(args, 'fail-on', 'none') ?? 'none').toLowerCase(),
+        baseline: str(args, 'baseline'),
+        quiet: bool(args, 'quiet'),
+        maxFiles: parseCountFlag(str(args, 'max-files')),
+        maxBytes: parseCountFlag(str(args, 'max-bytes')),
+    };
+}
+function validateAuditOptions(o) {
+    if (!DEPTHS.includes(o.depth))
+        return `--depth must be one of ${DEPTHS.join('|')}`;
+    if (o.profileArg !== 'auto' && !MATURITIES.includes(o.profileArg)) {
+        return `--profile must be auto or one of ${MATURITIES.join('|')}`;
+    }
+    if (!FORMATS.includes(o.format))
+        return `--format must be one of ${FORMATS.join('|')}`;
+    if (o.maxFiles !== undefined && !(o.maxFiles > 0))
+        return '--max-files must be a positive number';
+    if (o.maxBytes !== undefined && !(o.maxBytes > 0))
+        return '--max-bytes must be a positive number';
+    return null;
+}
+export function cmdAudit(args) {
+    const o = readAuditOptions(args);
+    const invalid = validateAuditOptions(o);
+    if (invalid) {
+        console.error(invalid);
+        return 2;
+    }
+    if (!fs.existsSync(o.target)) {
+        console.error(`Target path does not exist: ${o.target}`);
+        return 2;
+    }
+    // CLI-003: preview the write before the (expensive) audit runs.
+    if (!dryRunWrites(args, [o.out]))
+        return 0;
+    let config;
+    try {
+        config = loadConfig(o.target, str(args, 'config'));
+    }
+    catch (err) {
+        console.error(err.message);
+        return 2;
+    }
+    if (config.facts)
+        config.facts = [...config.facts, ...list(args, 'fact')];
+    const { report, warnings, profile } = runAudit({
+        target: o.target,
+        rulesDir: o.rulesDir,
+        depth: o.depth,
+        profile: o.profileArg,
+        config,
+        allowCommands: bool(args, 'allow-commands'),
+        usaVersion: VERSION,
+        includePacks: list(args, 'include'),
+        excludePacks: list(args, 'exclude'),
+        maxFiles: o.maxFiles,
+        maxBytes: o.maxBytes,
+    });
+    for (const w of warnings)
+        console.error(`warning: ${w}`);
+    const rendered = renderReport(report, profile, o.format);
+    try {
+        writeTextFile(o.out, rendered);
+    }
+    catch (err) {
+        // CLI-004: an unwritable --out is a usage error (exit 2), not a crash.
+        console.error(err.message);
+        return 2;
+    }
+    if (!o.quiet) {
+        console.log(summaryLine(report));
+        console.log(`  report → ${o.out}`);
+    }
+    // Without --baseline the absolute gate below is byte-identical to before:
+    // same function, same arguments, same exit codes.
+    if (!o.baseline)
+        return evaluateGate(report, o.failOn, o.quiet);
+    return runBaselineGate(report, o.baseline, o.failOn, o.quiet, args);
+}
+/**
+ * New-code gate: fail only on findings this change introduced or regressed,
+ * compared against a previous report's trailer. Every baseline failure mode
+ * exits 2 loudly — a gate that cannot read its baseline must never pass.
+ */
+function runBaselineGate(report, baselinePath, failOn, quiet, args) {
+    let text;
+    try {
+        text = fs.readFileSync(baselinePath, 'utf8');
+    }
+    catch {
+        console.error(`--baseline file not found or unreadable: ${baselinePath}`);
+        return 2;
+    }
+    // Tolerate a raw YAML trailer file, mirroring `usa diff`.
+    const trailerYaml = parseTrailer(text) ?? text;
+    if (!trailerYaml.trim()) {
+        console.error(`--baseline has no report trailer and no YAML content: ${baselinePath}`);
+        return 2;
+    }
+    try {
+        const baseline = parseBaselineTrailer(trailerYaml);
+        // An explicit --fail-on (even none) wins; otherwise the new-code gate
+        // defaults to HIGH so legacy MEDIUM/LOW debt never blocks adoption.
+        const threshold = failOn === 'none' && args['baseline'] !== undefined && args['fail-on'] === undefined
+            ? 'high'
+            : failOn;
+        return evaluateNewCodeGate(report, baseline, threshold, quiet);
+    }
+    catch (err) {
+        console.error(`--baseline is malformed (${baselinePath}): ${err.message}`);
+        return 2;
+    }
+}
+function renderReport(report, profile, format) {
+    switch (format) {
+        case 'json':
+            return renderJson(report);
+        case 'sarif':
+            return renderSarif(report);
+        case 'narrative':
+            return renderNarrative(report, profile);
+        case 'html':
+            return renderHtml(report, profile);
+        default:
+            return renderMarkdown(report, profile);
+    }
+}
+function summaryLine(report) {
+    const s = report.score.severityCounts;
+    const parts = SEVERITY_ORDER.filter((k) => s[k] > 0)
+        .map((k) => `${k.toLowerCase()} ${s[k]}`)
+        .join(' · ');
+    return (`usa ${report.score.overall}/100 (${report.detection.maturity}) — ` +
+        `${report.score.counts.PASS} passed, ` +
+        (parts ? `open: ${parts}` : 'no open findings') +
+        `, ${report.score.counts.UNKNOWN} to review` +
+        ` (${report.score.automationCoverage}% verified automatically)`);
+}
+//# sourceMappingURL=cli-audit.js.map

package/dist/cli-audit.js.map

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

package/dist/cli-evolve.d.ts

@@ -0,0 +1,4 @@
+import { type Args } from './cli-args.js';
+/** The `evolve` loop driver: audit → gap → candidate → release, with reporting. */
+export declare function cmdEvolve(args: Args): number;
+//# sourceMappingURL=cli-evolve.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli-evolve.d.ts","sourceRoot":"","sources":["../src/cli-evolve.ts"],"names":[],"mappings":"AAaA,OAAO,EAAuD,KAAK,IAAI,EAAE,MAAM,eAAe,CAAC;AAE/F,mFAAmF;AAGnF,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAsC5C"}

package/dist/cli-evolve.js

@@ -0,0 +1,182 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { Store } from './store/index.js';
+import { runEvolutionCycle } from './evolution/run.js';
+import { loadPackFile } from './engine/loader.js';
+import { capabilityFromPack } from './evolution/capability.js';
+import { VERSION, DEFAULT_RULES_DIR, bool, dryRunWrites, str } from './cli-args.js';
+/** The `evolve` loop driver: audit → gap → candidate → release, with reporting. */
+/* ----------------------------------------------------------------- evolve -- */
+export function cmdEvolve(args) {
+    const target = args._[1] ?? '.';
+    const rulesDir = path.resolve(str(args, 'rules-dir', DEFAULT_RULES_DIR) ?? DEFAULT_RULES_DIR);
+    if (!fs.existsSync(target)) {
+        console.error(`Target path does not exist: ${target}`);
+        return 2;
+    }
+    const storeDir = str(args, 'store');
+    // CLI-003: preview before the cycle runs (or the store dir is created).
+    if (!dryRunWrites(args, storeDir ? [path.join(storeDir, 'objects')] : []))
+        return 0;
+    const store = storeDir ? new Store(storeDir) : undefined;
+    const candidateCapability = loadEvolveCandidate(args);
+    const cases = loadEvolveCases(args, candidateCapability);
+    const learnReportPath = loadEvolveLearn(args);
+    const proposeFromGaps = bool(args, 'propose') && !candidateCapability && !learnReportPath;
+    const allGaps = bool(args, 'all-gaps');
+    const result = runEvolutionCycle({
+        target,
+        rulesDir,
+        engineVersion: VERSION,
+        candidateCapability,
+        benchmarkCases: cases,
+        store,
+        learnReportPath,
+        learnMinSeverity: str(args, 'min-severity', 'MEDIUM'),
+        proposeFromGaps,
+        allGaps,
+        onUnproposable: (gap, reason) => {
+            console.error(`warning: ${gap.id} not proposable (${reason})`);
+        },
+    });
+    printEvolutionResult(result);
+    return 0;
+}
+/** Resolve `--learn <report.md>` to an existing path, or undefined. */
+function loadEvolveLearn(args) {
+    const reportPath = str(args, 'learn');
+    if (!reportPath)
+        return undefined;
+    if (!fs.existsSync(reportPath)) {
+        console.error(`warning: learn report not found (${reportPath}) — ignoring --learn`);
+        return undefined;
+    }
+    return reportPath;
+}
+function loadEvolveCandidate(args) {
+    const candidateFile = str(args, 'candidate');
+    if (!candidateFile)
+        return undefined;
+    const { pack, warnings } = loadPackFile(candidateFile);
+    for (const w of warnings)
+        console.error(`warning: ${w}`);
+    if (!pack) {
+        console.error(`Could not load candidate pack: ${candidateFile}`);
+        return undefined;
+    }
+    return capabilityFromPack(pack, { createdBy: 'cli' });
+}
+function loadEvolveCases(args, candidateCapability) {
+    const benchDir = str(args, 'bench-dir');
+    const cases = benchDir ? loadBenchCases(benchDir) : [];
+    if (candidateCapability && cases.length === 0) {
+        console.error('warning: no benchmark cases supplied (--bench-dir). The release decision will be vacuous.');
+    }
+    return cases;
+}
+function loadBenchCases(dir) {
+    if (!fs.existsSync(dir))
+        return [];
+    const cases = [];
+    for (const entry of fs.readdirSync(dir)) {
+        if (!entry.endsWith('.json'))
+            continue;
+        try {
+            const raw = JSON.parse(fs.readFileSync(path.join(dir, entry), 'utf8'));
+            if (raw && raw.id && Array.isArray(raw.expected) && raw.fixture)
+                cases.push(raw);
+        }
+        catch {
+            console.error(`warning: could not read benchmark case ${entry}`);
+        }
+    }
+    return cases;
+}
+function printEvolutionResult(result) {
+    console.log(`# Evolution: ${result.snapshot.root}`);
+    console.log();
+    console.log(`snapshot        : ${result.snapshot.id}`);
+    printCoverage('before', result.before.coverage);
+    printGaps(result.before.gaps);
+    if (!result.candidate) {
+        console.log();
+        if (result.proposed.length > 0) {
+            console.log(`proposed        : ${result.proposed.length} candidate(s) (none benchmarked)`);
+            printProposed(result.proposed);
+        }
+        else {
+            console.log('No candidate capability supplied (--candidate <pack.yaml>).');
+            console.log('This was the deterministic BEFORE half of the loop only.');
+            console.log('Pass --propose to auto-propose a candidate from the gaps.');
+        }
+        printQueue(result.queue);
+        printSchedule(result.schedule);
+        return;
+    }
+    const release = result.candidate.release;
+    console.log();
+    console.log(`candidate       : ${result.candidate.capabilityId} (gaps: ${result.candidate.gapIds.join(', ')})`);
+    if (result.proposed.length > 0)
+        printProposed(result.proposed);
+    if (result.learnedSuggestions !== undefined) {
+        console.log(`learned       : ${result.learnedSuggestions} suggestion(s) from report`);
+    }
+    if (release) {
+        console.log(`release decision: ${release.decision}`);
+        console.log(`  precision ${release.precision.toFixed(3)} · recall ${release.recall.toFixed(3)} · regressions ${release.regressions}`);
+        for (const r of release.reasons)
+            console.log(`  - ${r}`);
+    }
+    if (result.after) {
+        console.log();
+        printCoverage('after', result.after.coverage);
+        const d = result.after.delta;
+        console.log(`delta           : coverage +${d.coverageDelta}pt · ${d.findingsAdded.length} finding(s) added · gap reduced: ${d.gapReduced}`);
+        if (d.findingsAdded.length)
+            console.log(`  new findings: ${d.findingsAdded.join(', ')}`);
+    }
+    if (result.queue) {
+        console.log(`queue           : ${result.queue.open} open · ${result.queue.closed} closed · ${result.queue.total} total`);
+    }
+    printSchedule(result.schedule);
+}
+function printSchedule(schedule) {
+    if (!schedule)
+        return;
+    for (const c of schedule.candidates) {
+        const blocked = c.blockedReason ? ` · blocked: ${c.blockedReason}` : '';
+        console.log(`schedule        : ${c.capabilityId} → ${c.outcome} ` +
+            `(precision ${c.release.precision.toFixed(3)} · recall ${c.release.recall.toFixed(3)} · ` +
+            `regressions ${c.release.regressions}, closed: ${c.closedGapIds.length} gap(s))${blocked}`);
+    }
+    console.log(`schedule        : ${schedule.attempted} attempted · ${schedule.released} released · ${schedule.rejected} rejected`);
+}
+function printQueue(queue) {
+    if (!queue)
+        return;
+    console.log(`queue           : ${queue.open} open · ${queue.closed} closed · ${queue.total} total`);
+}
+function printCoverage(label, cov) {
+    console.log(`${label.padEnd(16)}: language coverage ${cov.languageCoverage}% · automation ${cov.automationCoverage}%`);
+    if (cov.unsupportedLanguages.length) {
+        console.log(`  unsupported : ${cov.unsupportedLanguages.join(', ')}`);
+    }
+}
+function printGaps(gaps) {
+    if (gaps.length === 0) {
+        console.log('gaps           : none');
+        return;
+    }
+    console.log(`gaps           : ${gaps.length}`);
+    for (const g of gaps)
+        console.log(`  - ${g.id} [${g.priority}] ${g.requiredCapability}`);
+}
+function printProposed(proposed) {
+    for (const c of proposed) {
+        const langs = c.capability.languages?.join(', ') ?? 'unknown';
+        const rules = c.capability.pack?.rules.length ?? 0;
+        console.log(`  proposed      : ${c.id} (${rules} rule(s), langs: ${langs}) → gap ${c.gapIds.join(', ')} [${c.status}]`);
+    }
+    console.log('  review required — proposals are unreviewed bootstrap packs, never registered.');
+}
+//# sourceMappingURL=cli-evolve.js.map

package/dist/cli-evolve.js.map

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

package/dist/cli-help.d.ts

@@ -0,0 +1,6 @@
+/** Help texts and scaffold templates (pure data — no imports). Generated docs embed the help. */
+export declare const MODELS_HELP_TEXT: string;
+export declare const LIVE_HELP_TEXT: string;
+export declare const HELP: string;
+export declare const WORKFLOW_TEMPLATE = "# USA \u2014 Universal Software Auditor\n# Runs on every PR and pushes a Markdown summary you can read in the Actions UI.\nname: USA Audit\n\non:\n  pull_request:\n  push:\n    branches: [master]\n  workflow_dispatch:\n    inputs:\n      depth:\n        description: Audit depth\n        required: false\n        default: standard\n        type: choice\n        options: [quick, standard, deep]\n\npermissions:\n  contents: read\n";
+//# sourceMappingURL=cli-help.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli-help.d.ts","sourceRoot":"","sources":["../src/cli-help.ts"],"names":[],"mappings":"AAAA,iGAAiG;AAEjG,eAAO,MAAM,gBAAgB,QAOrB,CAAC;AAET,eAAO,MAAM,cAAc,QAcnB,CAAC;AAET,eAAO,MAAM,IAAI,QAoGT,CAAC;AAET,eAAO,MAAM,iBAAiB,mbAmB7B,CAAC"}