geopilot 0.0.0-stage → 0.0.1-bootstrap.0

package/dist/cli/commands/insights.js

@@ -0,0 +1,143 @@
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { EXIT, usage } from "../../core/errors.js";
+import { canonicalJson } from "../../core/hash.js";
+import { loadRun } from "../../cache/runs.js";
+import { statusLabel, validateReferences, validateSchema } from "../../insights/validate.js";
+import { renderMarkdown, sortedFindings } from "../../report/render.js";
+import { renderPretty, renderJson, FORMATS } from "../../report/render.js";
+import { GLOBAL_FLAGS, INSIGHTS_FLAGS, parseArgs } from "../args.js";
+import { cacheFor, gitRoot, loadFor, resolveCwd } from "../context.js";
+function readJson(path) {
+    if (!existsSync(path))
+        throw usage(`${path} does not exist`);
+    try {
+        return JSON.parse(readFileSync(path, 'utf8'));
+    }
+    catch (e) {
+        throw usage(`${path} is not valid JSON: ${e.message}`);
+    }
+}
+function validateFile(file, runId, cwd, deps, p) {
+    const { doc, errors } = validateSchema(readJson(file));
+    if (!doc)
+        return { doc: null, result: { schemaErrors: errors, results: [], evidenceAvailable: false }, run: null };
+    const loaded = loadFor(cwd, p, deps.env);
+    const root = gitRoot(cwd);
+    const cache = cacheFor(root, cwd, loaded, deps.env);
+    const id = runId ?? doc.basedOn.runId;
+    let run = null;
+    try {
+        run = loadRun(cache, id);
+    }
+    catch {
+        run = null;
+    }
+    return { doc, result: validateReferences(doc, run, root), run };
+}
+export async function insightsCommand(argv, deps) {
+    const p = parseArgs(argv, [...GLOBAL_FLAGS, ...INSIGHTS_FLAGS]);
+    if (p.positionals[0] !== 'validate')
+        throw usage('insights takes validate <file> [--run <id>]');
+    const file = p.positionals[1];
+    if (!file)
+        throw usage('insights validate needs a file, usually .geo/insights.json');
+    const cwd = resolveCwd(p, deps);
+    const { result } = validateFile(resolve(cwd, file), p.str.get('run'), cwd, deps, p);
+    const json = (p.multi.get('format') ?? []).includes('json');
+    if (json)
+        deps.io.out(canonicalJson(result));
+    else {
+        if (result.schemaErrors.length > 0)
+            deps.io.out(`L1 schema: invalid\n  ${result.schemaErrors.join('\n  ')}\n`);
+        else {
+            deps.io.out('L1 schema: valid\n');
+            if (!result.evidenceAvailable)
+                deps.io.out('L2 references: no retained run evidence (was the scan run with --no-cache?). URL and finding references are unchecked.\n');
+            for (const r of result.results)
+                deps.io.out(`  ${r.id.padEnd(16)} ${r.kind.padEnd(14)} ${statusLabel(r.status)}${r.reasons.length ? `: ${r.reasons.join('; ')}` : ''}\n`);
+            deps.io.out('L3 semantic quality is a human/model evaluation; it never affects readiness or gates.\n');
+        }
+    }
+    if (result.schemaErrors.length > 0 || result.results.some((r) => r.status === 'reference_invalid'))
+        return EXIT.gate;
+    if (!result.evidenceAvailable || result.results.some((r) => r.status === 'unchecked'))
+        return EXIT.incomplete;
+    return EXIT.ok;
+}
+function renderMerged(m) {
+    const lines = [renderMarkdown(m.report), '## Agent recommendations', ''];
+    const status = new Map(m.validation?.results.map((r) => [r.id, r]) ?? []);
+    const show = (kind) => {
+        const items = (m.insights?.insights ?? []).filter((i) => i.kind === kind && status.get(i.id)?.status !== 'stale' && status.get(i.id)?.status !== 'duplicate_exact');
+        if (items.length === 0)
+            lines.push('None.');
+        for (const i of items)
+            lines.push(`- **${i.title}** (${i.confidence} confidence; ${statusLabel(status.get(i.id)?.status ?? 'unchecked')}): ${i.description} — _${i.suggestedAction}_`);
+        lines.push('');
+    };
+    show('recommendation');
+    lines.push('## Hypotheses to validate', '');
+    show('hypothesis');
+    lines.push('_Agent output is not an engine result. "Evidence resolved" means the cited files and URLs exist as cited, not that the recommendation is correct._', '');
+    return lines.join('\n');
+}
+export async function reportCommand(argv, deps) {
+    const p = parseArgs(argv, [...GLOBAL_FLAGS, ...INSIGHTS_FLAGS]);
+    const sub = p.positionals[0];
+    const cwd = resolveCwd(p, deps);
+    const output = (p.multi.get('output') ?? [])[0];
+    const format = ((p.multi.get('format') ?? [])[0] ?? (output?.endsWith('.json') ? 'json' : 'markdown'));
+    if (!FORMATS.includes(format))
+        throw usage(`unknown --format ${format}`);
+    const write = (text) => {
+        if (output)
+            writeFileSync(resolve(cwd, output), text);
+        else
+            deps.io.out(text);
+    };
+    if (sub === 'convert') {
+        const file = p.positionals[1];
+        if (!file)
+            throw usage('report convert needs a saved report.json');
+        const report = readJson(resolve(cwd, file));
+        if (report.schemaVersion !== 'geo-report/v1')
+            throw usage(`${file} is not a geo-report/v1 document`);
+        write(format === 'json' ? renderJson(report) : format === 'markdown' ? renderMarkdown(report) : renderPretty(report, deps.io.color));
+        return EXIT.ok;
+    }
+    if (sub === 'merge') {
+        const reportFile = p.positionals[1];
+        const insightsFile = p.positionals[2];
+        if (!reportFile)
+            throw usage('report merge needs <report.json> [insights.json]');
+        const report = readJson(resolve(cwd, reportFile));
+        if (report.schemaVersion !== 'geo-report/v1')
+            throw usage(`${reportFile} is not a geo-report/v1 document`);
+        let doc = null;
+        let validation = null;
+        if (insightsFile) {
+            const v = validateFile(resolve(cwd, insightsFile), p.str.get('run') ?? report.run.id, cwd, deps, p);
+            doc = v.doc;
+            validation = v.result;
+            if (!doc)
+                throw usage(`${insightsFile} fails L1 schema validation: ${v.result.schemaErrors[0]}`);
+        }
+        const merged = {
+            schemaVersion: 'geo-merged/v1',
+            report,
+            insights: doc,
+            validation,
+            sections: {
+                verifiedEngineFindings: sortedFindings(report).filter((x) => x.finding.evidenceQuality !== 'inferred').map((x) => x.finding.fingerprint),
+                agentRecommendations: (doc?.insights ?? []).filter((i) => i.kind === 'recommendation').map((i) => i.id),
+                hypothesesToValidate: (doc?.insights ?? []).filter((i) => i.kind === 'hypothesis').map((i) => i.id),
+            },
+            disclaimer: report.disclaimer,
+        };
+        write(format === 'json' ? canonicalJson(merged) : renderMerged(merged));
+        return EXIT.ok;
+    }
+    throw usage('report takes merge or convert');
+}
+//# sourceMappingURL=insights.js.map

package/dist/cli/commands/insights.js.map

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

package/dist/cli/commands/rules.d.ts

@@ -0,0 +1,5 @@
+import { type RuleMeta } from '../../rules/catalogue.ts';
+import type { Deps } from '../context.ts';
+export declare function explainText(meta: RuleMeta, p: Deps['io']['color']): string;
+export declare function explainCommand(argv: readonly string[], deps: Deps): Promise<number>;
+export declare function rulesCommand(argv: readonly string[], deps: Deps): Promise<number>;

package/dist/cli/commands/rules.js

@@ -0,0 +1,86 @@
+import { EXIT, usage } from "../../core/errors.js";
+import { canonicalJson } from "../../core/hash.js";
+import { findRule, RETIRED, RULES, ruleDocsUrl } from "../../rules/catalogue.js";
+import { VARIANTS } from "../../fix/plan.js";
+import { GLOBAL_FLAGS, parseArgs, RULES_FLAGS } from "../args.js";
+export function explainText(meta, p) {
+    const lines = [];
+    lines.push(`${p.brand(p.bold(meta.id))}  ${p.bold(meta.title)}`);
+    lines.push('');
+    lines.push(meta.purpose);
+    lines.push('');
+    lines.push(`${p.dim('Evidence class')}  ${meta.evidenceClass}${meta.scored ? `   ${p.dim('weight')} ${meta.weight}` : `   ${p.dim('unscored')}`}   ${p.dim('scope')} ${meta.scope}   ${p.dim('subject')} ${meta.subject === 'site' ? 'site' : 'route group'}`);
+    lines.push(`${p.dim('Default severity')} ${meta.severity}   ${p.dim('lifecycle')} ${meta.lifecycle}`);
+    if (meta.subChecks.length > 0) {
+        lines.push('');
+        lines.push(p.dim('Sub-checks (a rule never passes on a partial set of these)'));
+        for (const s of meta.subChecks)
+            lines.push(`  ${s.id.padEnd(20)} ${p.dim(`[${s.scope}]`.padEnd(7))} ${s.description}`);
+    }
+    if (meta.preconditions.length > 0) {
+        lines.push('');
+        lines.push(p.dim('Preconditions'));
+        for (const x of meta.preconditions)
+            lines.push(`  · ${x}`);
+    }
+    lines.push('');
+    lines.push(`${p.dim('Fix class')}  ${meta.fixClass}`);
+    for (const v of meta.fixVariants) {
+        const spec = VARIANTS[v];
+        lines.push(spec ? `  ${v}  ${spec.title} (${spec.class}, requires ${spec.required})` : `  ${v}  Phase 2`);
+    }
+    lines.push('');
+    lines.push(`${p.dim('Remediation')}  ${meta.remediation}`);
+    if (meta.falsePositives.length > 0) {
+        lines.push('');
+        lines.push(p.dim('Known false positives'));
+        for (const x of meta.falsePositives)
+            lines.push(`  · ${x}`);
+    }
+    if (meta.blockerCap)
+        lines.push(`\n${p.dim('Readiness cap')}  capped at 40 when direct evidence shows: ${meta.blockerCap}`);
+    lines.push('');
+    lines.push(p.dim('References'));
+    for (const r of meta.references)
+        lines.push(`  · ${r.title} (${r.kind}) ${p.dim(r.url)}`);
+    lines.push('');
+    lines.push(`${p.dim('Docs')}  ${ruleDocsUrl(meta.id)}`);
+    return `${lines.join('\n')}\n`;
+}
+export async function explainCommand(argv, deps) {
+    const p = parseArgs(argv, GLOBAL_FLAGS);
+    const id = p.positionals[0];
+    if (!id)
+        throw usage('explain needs a rule id, e.g. geopilot explain GEO-012');
+    const meta = findRule(id);
+    if (!meta) {
+        const retired = RETIRED.find((r) => r.id === id.toUpperCase());
+        if (retired) {
+            deps.io.out(`${retired.id} (${retired.title}) is retired. GEO does not score content-format mandates; an agent may still raise grounded content insights.\n`);
+            return EXIT.ok;
+        }
+        throw usage(`unknown rule ${id}`, 'Run geopilot rules for the catalogue.');
+    }
+    if ((p.multi.get('format') ?? []).includes('json'))
+        deps.io.out(canonicalJson(meta));
+    else
+        deps.io.out(explainText(meta, deps.io.color));
+    return EXIT.ok;
+}
+export async function rulesCommand(argv, deps) {
+    const p = parseArgs(argv, [...GLOBAL_FLAGS, ...RULES_FLAGS]);
+    const list = p.bool.has('all') ? RULES : RULES.filter((r) => r.lifecycle !== 'informational');
+    if (p.bool.has('json') || (p.multi.get('format') ?? []).includes('json')) {
+        deps.io.out(canonicalJson({ rules: list, retired: p.bool.has('all') ? RETIRED : [] }));
+        return EXIT.ok;
+    }
+    const c = deps.io.color;
+    for (const r of list) {
+        deps.io.out(`${c.brand(r.id)}  ${r.evidenceClass}  ${r.scored ? `w${r.weight}` : '  '}  ${r.title}  ${c.dim(r.scope)}\n`);
+    }
+    if (p.bool.has('all'))
+        for (const r of RETIRED)
+            deps.io.out(`${c.dim(`${r.id}  retired  ${r.title}`)}\n`);
+    return EXIT.ok;
+}
+//# sourceMappingURL=rules.js.map

package/dist/cli/commands/rules.js.map

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

package/dist/cli/commands/scan.d.ts

@@ -0,0 +1,14 @@
+import { type GeoConfig } from '../../config/config.ts';
+import { type ScanResult } from '../../scan.ts';
+import { type Parsed } from '../args.ts';
+import { type Deps } from '../context.ts';
+export interface ScanInvocation {
+    readonly result: ScanResult;
+    readonly cache: string | null;
+    readonly cwd: string;
+    readonly repoPath: string | null;
+    readonly config: GeoConfig;
+}
+/** Shared by `scan` and `fix`: resolve targets, load config, run, cache. */
+export declare function runScan(p: Parsed, deps: Deps, forceRepo?: boolean): Promise<ScanInvocation>;
+export declare function scanCommand(argv: readonly string[], deps: Deps): Promise<number>;

package/dist/cli/commands/scan.js

@@ -0,0 +1,127 @@
+import { existsSync, statSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { EXIT, usage } from "../../core/errors.js";
+import { printableConfig } from "../../config/config.js";
+import { saveRun } from "../../cache/runs.js";
+import { findRule } from "../../rules/catalogue.js";
+import { scan } from "../../scan.js";
+import { intFlag, parseArgs, GLOBAL_FLAGS, SCAN_FLAGS } from "../args.js";
+import { cacheFor, emit, loadFor, resolveCwd } from "../context.js";
+const SEVERITY_RANK = { high: 3, medium: 2, low: 1, info: 0 };
+function ruleList(values, flag) {
+    if (!values)
+        return undefined;
+    return values.flatMap((v) => v.split(',')).map((id) => {
+        const meta = findRule(id.trim());
+        if (!meta)
+            throw usage(`--${flag} ${id}: unknown rule id`, 'Run geopilot rules for the catalogue.');
+        return meta.id;
+    });
+}
+function normaliseUrlArg(u) {
+    try {
+        const url = new URL(u);
+        if (url.protocol !== 'http:' && url.protocol !== 'https:')
+            throw new Error('scheme');
+        return url.href;
+    }
+    catch {
+        throw usage(`${u} is not an http(s) URL`);
+    }
+}
+/** Shared by `scan` and `fix`: resolve targets, load config, run, cache. */
+export async function runScan(p, deps, forceRepo = false) {
+    const cwd = resolveCwd(p, deps);
+    const positional = p.positionals[0];
+    const urls = [...(p.multi.get('url') ?? [])].map(normaliseUrlArg);
+    let repoPath = null;
+    if (positional && /^https?:\/\//i.test(positional))
+        urls.unshift(normaliseUrlArg(positional));
+    else if (positional) {
+        repoPath = resolve(cwd, positional);
+        if (!existsSync(repoPath) || !statSync(repoPath).isDirectory())
+            throw usage(`${positional} is not a directory or an http(s) URL`);
+    }
+    else if (urls.length === 0 || forceRepo)
+        repoPath = cwd;
+    if (p.positionals.length > 1)
+        throw usage('scan takes one path or URL; pass more URLs with --url');
+    if (p.bool.has('ignore-robots') && urls.length === 0)
+        throw usage('--ignore-robots only applies to an explicitly named URL target');
+    const loaded = loadFor(repoPath ?? cwd, p, deps.env);
+    let config = loaded.config;
+    const render = p.str.get('render');
+    if (render !== undefined) {
+        if (!['auto', 'always', 'never'].includes(render))
+            throw usage('--render must be auto, always or never');
+        config = { ...config, crawl: { ...config.crawl, render: render } };
+    }
+    const routes = p.multi.get('routes');
+    if (routes)
+        config = { ...config, routes: { ...config.routes, include: routes.flatMap((r) => r.split(',')) } };
+    if (p.str.has('baseline'))
+        throw usage('--baseline is not available in this release', 'Baselines ship in Phase 3.');
+    const result = await scan({
+        repoPath,
+        urls,
+        config,
+        configHash: loaded.hash,
+        ...(intFlag(p, 'max-pages', 1, 200) === undefined ? {} : { maxPages: intFlag(p, 'max-pages', 1, 200) }),
+        ...(intFlag(p, 'max-depth', 0, 10) === undefined ? {} : { maxDepth: intFlag(p, 'max-depth', 0, 10) }),
+        followExternal: p.bool.has('follow-external'),
+        ignoreRobots: p.bool.has('ignore-robots'),
+        ...(ruleList(p.multi.get('rule'), 'rule') ? { only: ruleList(p.multi.get('rule'), 'rule') } : {}),
+        ...(ruleList(p.multi.get('skip-rule'), 'skip-rule') ? { skip: ruleList(p.multi.get('skip-rule'), 'skip-rule') } : {}),
+        ...(deps.fetcher ? { fetcher: deps.fetcher } : {}),
+        ...(deps.now ? { now: deps.now } : {}),
+    });
+    let cache = null;
+    if (!p.bool.has('no-cache')) {
+        cache = cacheFor(repoPath, cwd, loaded, deps.env);
+        saveRun(cache, result.report, result.snapshots);
+    }
+    return { result, cache, cwd, repoPath, config };
+}
+export async function scanCommand(argv, deps) {
+    const p = parseArgs(argv, [...GLOBAL_FLAGS, ...SCAN_FLAGS]);
+    if (p.bool.has('print-config')) {
+        const cwd = resolveCwd(p, deps);
+        deps.io.out(printableConfig(loadFor(cwd, p, deps.env).config));
+        return EXIT.ok;
+    }
+    const failOn = p.str.get('fail-on');
+    if (failOn !== undefined && !(failOn in SEVERITY_RANK))
+        throw usage('--fail-on must be high, medium, low or info');
+    const minReadiness = intFlag(p, 'min-readiness', 0, 100);
+    const { result, cache, cwd, config } = await runScan(p, deps);
+    const r = result.report;
+    emit(r, p, deps, cwd);
+    if (cache && !p.bool.has('quiet'))
+        deps.io.err(deps.io.errColor.dim(`run ${r.run.id} cached in ${cache}\n`));
+    const gateFailOn = failOn ?? config.thresholds.failOn;
+    const gateMin = minReadiness ?? config.thresholds.minReadiness;
+    let code = EXIT.ok;
+    if (gateFailOn) {
+        const hits = r.evaluations.flatMap((e) => e.findings).filter((f) => f.evidenceQuality !== 'inferred' && SEVERITY_RANK[f.severity] >= SEVERITY_RANK[gateFailOn]);
+        if (hits.length > 0) {
+            deps.io.err(`gate: ${hits.length} finding(s) at or above ${gateFailOn}\n`);
+            code = EXIT.gate;
+        }
+    }
+    if (gateMin !== null && gateMin !== undefined) {
+        if (r.readiness.value === null || r.readiness.display === 'insufficient_evidence') {
+            deps.io.err(`gate: readiness is unavailable (insufficient evidence), so --min-readiness ${gateMin} cannot pass\n`);
+            code = EXIT.gate;
+        }
+        else if (r.readiness.value < gateMin) {
+            deps.io.err(`gate: readiness ${Math.round(r.readiness.value)} is below ${gateMin}\n`);
+            code = EXIT.gate;
+        }
+    }
+    if (code === EXIT.ok && p.bool.has('fail-on-incomplete') && (r.assessmentScope.assessment === 'incomplete' || r.coverage < config.thresholds.minCoverage)) {
+        deps.io.err(`gate: assessment is ${r.assessmentScope.assessment} with ${Math.round(r.coverage)}% coverage (minimum ${config.thresholds.minCoverage}%)\n`);
+        code = EXIT.incomplete;
+    }
+    return code;
+}
+//# sourceMappingURL=scan.js.map

package/dist/cli/commands/scan.js.map

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

package/dist/cli/commands-list.d.ts

@@ -0,0 +1,6 @@
+export declare const COMMANDS: readonly {
+    readonly name: string;
+    readonly summary: string;
+    readonly usage: string;
+    readonly phase?: string;
+}[];

package/dist/cli/commands-list.js

@@ -0,0 +1,15 @@
+// The command table, shared by --help and the documentation site.
+export const COMMANDS = [
+    { name: 'scan', summary: 'Audit a URL, a repository, or both', usage: 'scan [path|url] [--url <u>...] [--max-pages n] [--max-depth n] [--render auto|always|never] [--rule id] [--skip-rule id] [--fail-on sev] [--min-readiness n] [--fail-on-incomplete] [--ignore-robots] [--follow-external]' },
+    { name: 'explain', summary: 'Explain one rule: evidence, sub-checks, fixes, references', usage: 'explain <ruleId>' },
+    { name: 'rules', summary: 'List the rule catalogue', usage: 'rules [--all] [--json]' },
+    { name: 'fix', summary: 'Dry-run, apply, verify or roll back closed-list fixes', usage: 'fix [path] [--rule id] [--apply [--approve <fixId>...]] [--verify <runId>] [--rollback <runId>] [--verify-cmd "<cmd>"] [--serve] [--allow-dirty] [--url <u>]' },
+    { name: 'init', summary: 'Preview and write geo.config.json', usage: 'init [--origin <url>] [--language <tag>] [--yes] [--force]' },
+    { name: 'agent', summary: 'Install or check the portable agent skill', usage: 'agent install --host claude-code [--yes] | agent install --host agents-md --write-agents-md | agent status' },
+    { name: 'insights', summary: 'Validate an agent insights file (L1 schema, L2 references)', usage: 'insights validate <file> [--run <id>]' },
+    { name: 'report', summary: 'Merge insights into a report, or convert a saved report', usage: 'report merge <report.json> [insights.json] [--output f] | report convert <report.json> --format markdown' },
+    { name: 'review', summary: 'Diff-aware assessment', usage: 'review [--base <ref>|--staged|--pre-push]', phase: 'Phase 3' },
+    { name: 'baseline', summary: 'Fingerprint baselines', usage: 'baseline create|update|show', phase: 'Phase 3' },
+    { name: 'hook', summary: 'Opt-in pre-push hook', usage: 'hook install|uninstall|status', phase: 'Phase 3' },
+];
+//# sourceMappingURL=commands-list.js.map

package/dist/cli/commands-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands-list.js","sourceRoot":"","sources":["../../src/cli/commands-list.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,MAAM,CAAC,MAAM,QAAQ,GAAoH;IACvI,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,oCAAoC,EAAE,KAAK,EAAE,2NAA2N,EAAE;IACnS,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,2DAA2D,EAAE,KAAK,EAAE,kBAAkB,EAAE;IACpH,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,yBAAyB,EAAE,KAAK,EAAE,wBAAwB,EAAE;IACtF,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,uDAAuD,EAAE,KAAK,EAAE,8JAA8J,EAAE;IACxP,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,mCAAmC,EAAE,KAAK,EAAE,4DAA4D,EAAE;IACnI,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,2CAA2C,EAAE,KAAK,EAAE,4GAA4G,EAAE;IAC5L,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,4DAA4D,EAAE,KAAK,EAAE,uCAAuC,EAAE;IAC3I,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,yDAAyD,EAAE,KAAK,EAAE,0GAA0G,EAAE;IACzM,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,uBAAuB,EAAE,KAAK,EAAE,2CAA2C,EAAE,KAAK,EAAE,SAAS,EAAE;IAC1H,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,uBAAuB,EAAE,KAAK,EAAE,6BAA6B,EAAE,KAAK,EAAE,SAAS,EAAE;IAC9G,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,sBAAsB,EAAE,KAAK,EAAE,+BAA+B,EAAE,KAAK,EAAE,SAAS,EAAE;CAC5G,CAAC"}

package/dist/cli/context.d.ts

@@ -0,0 +1,26 @@
+import { type LoadedConfig } from '../config/config.ts';
+import type { Fetcher } from '../collect/crawl.ts';
+import { type Format } from '../report/render.ts';
+import type { Report } from '../types.ts';
+import type { Io } from './io.ts';
+import type { Parsed } from './args.ts';
+export interface Deps {
+    readonly io: Io;
+    readonly cwd: string;
+    readonly env: NodeJS.ProcessEnv;
+    readonly fetcher?: Fetcher;
+    readonly now?: () => Date;
+}
+export declare function gitRoot(dir: string): string | null;
+export declare function currentBranch(dir: string): string | null;
+export declare function defaultBranch(dir: string): string | null;
+export declare function dirtyFiles(dir: string, files: readonly string[]): string[];
+export declare function resolveCwd(p: Parsed, deps: Deps): string;
+export declare function loadFor(dir: string, p: Parsed, env: NodeJS.ProcessEnv): LoadedConfig;
+export declare function cacheFor(repoPath: string | null, cwd: string, loaded: LoadedConfig, env: NodeJS.ProcessEnv): string;
+export declare function parseFormats(p: Parsed): {
+    format: Format;
+    output: string | null;
+}[];
+export declare function emit(report: Report, p: Parsed, deps: Deps, cwd: string): void;
+export declare function requireRepo(dir: string): void;

package/dist/cli/context.js

@@ -0,0 +1,108 @@
+import { execFileSync } from 'node:child_process';
+import { existsSync, statSync, writeFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { loadConfig } from "../config/config.js";
+import { GeoError, usage } from "../core/errors.js";
+import { cacheRoot } from "../cache/runs.js";
+import { FORMATS, render } from "../report/render.js";
+export function gitRoot(dir) {
+    try {
+        return execFileSync('git', ['rev-parse', '--show-toplevel'], { cwd: dir, encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] }).trim() || null;
+    }
+    catch {
+        return null;
+    }
+}
+export function currentBranch(dir) {
+    try {
+        return execFileSync('git', ['branch', '--show-current'], { cwd: dir, encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] }).trim() || null;
+    }
+    catch {
+        return null;
+    }
+}
+export function defaultBranch(dir) {
+    try {
+        const ref = execFileSync('git', ['symbolic-ref', '--quiet', 'refs/remotes/origin/HEAD'], { cwd: dir, encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] }).trim();
+        return ref.replace(/^refs\/remotes\/origin\//, '') || null;
+    }
+    catch {
+        return null;
+    }
+}
+export function dirtyFiles(dir, files) {
+    if (files.length === 0)
+        return [];
+    try {
+        const out = execFileSync('git', ['status', '--porcelain', '--', ...files], { cwd: dir, encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] });
+        return out.split('\n').filter(Boolean).map((l) => l.slice(3));
+    }
+    catch {
+        return [];
+    }
+}
+export function resolveCwd(p, deps) {
+    const c = p.str.get('cwd');
+    const dir = c ? resolve(deps.cwd, c) : deps.cwd;
+    if (!existsSync(dir) || !statSync(dir).isDirectory())
+        throw usage(`--cwd ${dir} is not a directory`);
+    return dir;
+}
+export function loadFor(dir, p, env) {
+    return loadConfig(dir, gitRoot(dir), p.str.get('config') ?? null, env);
+}
+export function cacheFor(repoPath, cwd, loaded, env) {
+    if (repoPath)
+        return cacheRoot(gitRoot(repoPath) ?? repoPath, env);
+    if (loaded.files.length > 0 || gitRoot(cwd))
+        return cacheRoot(gitRoot(cwd) ?? cwd, env);
+    return cacheRoot(null, env);
+}
+function formatFromPath(path) {
+    if (path.endsWith('.json'))
+        return 'json';
+    if (path.endsWith('.md') || path.endsWith('.markdown'))
+        return 'markdown';
+    if (path.endsWith('.txt'))
+        return 'pretty';
+    return null;
+}
+export function parseFormats(p) {
+    const formats = p.multi.get('format') ?? [];
+    const outputs = p.multi.get('output') ?? [];
+    for (const f of formats) {
+        if (f === 'sarif' || f === 'github')
+            throw usage(`--format ${f} is not available in this release`, 'SARIF and GitHub annotations ship with the Phase 3 GitHub Action. Use json, markdown or pretty.');
+        if (!FORMATS.includes(f))
+            throw usage(`unknown --format ${f}`, `Use one of ${FORMATS.join(', ')}.`);
+    }
+    const pairs = [];
+    const n = Math.max(formats.length, outputs.length);
+    for (let i = 0; i < n; i++) {
+        const output = outputs[i] ?? null;
+        const format = formats[i] ?? (output ? formatFromPath(output) : null) ?? 'pretty';
+        pairs.push({ format, output });
+    }
+    if (pairs.length === 0)
+        pairs.push({ format: 'pretty', output: null });
+    if (pairs.filter((x) => x.output === null).length > 1)
+        throw usage('only one format can go to stdout; pair the others with --output');
+    return pairs;
+}
+export function emit(report, p, deps, cwd) {
+    for (const { format, output } of parseFormats(p)) {
+        const text = render(report, format, deps.io.color);
+        if (output) {
+            writeFileSync(resolve(cwd, output), format === 'pretty' ? render(report, 'pretty', { brand: (s) => s, red: (s) => s, green: (s) => s, yellow: (s) => s, dim: (s) => s, bold: (s) => s }) : text);
+            if (!p.bool.has('quiet'))
+                deps.io.err(`wrote ${format} report to ${output}\n`);
+        }
+        else if (!p.bool.has('quiet') || format !== 'pretty')
+            deps.io.out(text);
+    }
+}
+export function requireRepo(dir) {
+    if (!existsSync(dir))
+        throw new GeoError('usage', `${dir} does not exist`);
+}
+//# sourceMappingURL=context.js.map

package/dist/cli/context.js.map

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

package/dist/cli/io.d.ts

@@ -0,0 +1,16 @@
+import { type Palette } from '../core/tty.ts';
+export interface Io {
+    out(text: string): void;
+    err(text: string): void;
+    readonly interactive: boolean;
+    readonly color: Palette;
+    readonly errColor: Palette;
+    confirm(question: string): Promise<boolean>;
+    ask(question: string): Promise<string>;
+    readonly env: NodeJS.ProcessEnv;
+}
+export declare function isCi(env: NodeJS.ProcessEnv): boolean;
+export declare function processIo(opts: {
+    nonInteractive: boolean;
+    noColor: boolean;
+}, env?: NodeJS.ProcessEnv): Io;