@cogitator-ai/cli 0.5.19 → 0.6.0

package/dist/utils/add.js

@@ -0,0 +1,151 @@
+import chalk from 'chalk';
+import { CHANNELS, CODING_AGENTS, closest, DEPLOY_TARGETS, FEATURES, MEMORIES, VECTOR_STORES, } from 'create-cogitator-app';
+import { UsageError } from './cli.js';
+function oneOf(what, value, allowed) {
+    const found = allowed.find((candidate) => candidate === value);
+    if (found)
+        return found;
+    const match = closest(value, allowed);
+    throw new UsageError(`Unknown ${what} "${value}".${match ? ` Did you mean "${match}"?` : ''} Use one of: ${allowed.join(', ')}.`);
+}
+/** Values of a repeatable flag, which also takes comma-separated lists. */
+function listOf(values) {
+    return (values ?? [])
+        .flatMap((value) => value.split(','))
+        .map((value) => value.trim())
+        .filter(Boolean);
+}
+/** The addition the command line asks for, validated against the scaffolder's catalogs. */
+export function addChangesFrom(features, flags) {
+    const changes = {
+        features: listOf(features).map((feature) => oneOf('feature', feature, FEATURES)),
+        channels: listOf(flags.channel).map((channel) => oneOf('channel', channel, CHANNELS)),
+        codingAgents: listOf(flags.agent).map((agent) => oneOf('coding agent', agent, CODING_AGENTS)),
+        ...(flags.memory && { memory: oneOf('memory', flags.memory, MEMORIES) }),
+        ...(flags.vectorStore && {
+            vectorStore: oneOf('vector store', flags.vectorStore, VECTOR_STORES),
+        }),
+        ...(flags.deploy && { deploy: oneOf('deploy target', flags.deploy, DEPLOY_TARGETS) }),
+    };
+    const empty = !changes.features?.length &&
+        !changes.channels?.length &&
+        !changes.codingAgents?.length &&
+        !changes.memory &&
+        !changes.vectorStore &&
+        !changes.deploy;
+    if (empty) {
+        throw new UsageError(`Name what to add: a feature (${FEATURES.join(', ')}), or --memory, --vector-store, --deploy, --channel, --agent`);
+    }
+    return changes;
+}
+/** A unified diff with additions in green, removals in red and hunk headers dimmed. */
+export function colorDiff(diff) {
+    return diff
+        .split('\n')
+        .map((line) => {
+        if (line.startsWith('+++') || line.startsWith('---'))
+            return chalk.bold(line);
+        if (line.startsWith('@@'))
+            return chalk.cyan(line);
+        if (line.startsWith('+'))
+            return chalk.green(line);
+        if (line.startsWith('-'))
+            return chalk.red(line);
+        return line;
+    })
+        .join('\n');
+}
+const MARKS = {
+    create: chalk.green('+'),
+    update: chalk.yellow('~'),
+    delete: chalk.red('-'),
+};
+function indentList(items) {
+    return items.map((item) => `  ${item}`);
+}
+/** What the addition does, for the terminal; with `diffs`, every file change in full. */
+export function formatAddPlan(plan, options) {
+    const out = [];
+    if (plan.upToDate)
+        return chalk.green('The project already has everything asked for, nothing to do.');
+    out.push(chalk.bold(`Adding ${plan.summary.join(', ')}`), '');
+    if (plan.changes.length > 0) {
+        out.push(chalk.bold('Files'));
+        for (const change of plan.changes) {
+            const how = change.source === 'merged' ? chalk.dim(' (merged with your edits)') : '';
+            out.push(`  ${MARKS[change.kind]} ${change.path}${how}`);
+        }
+        out.push('');
+    }
+    const deps = Object.entries({ ...plan.dependencies, ...plan.devDependencies });
+    if (deps.length > 0 || plan.removedDependencies.length > 0) {
+        out.push(chalk.bold('Dependencies'), ...indentList([
+            ...deps.map(([name, range]) => `${chalk.green('+')} ${name} ${chalk.dim(range)}`),
+            ...plan.removedDependencies.map((name) => `${chalk.red('-')} ${name}`),
+        ]), '');
+    }
+    if (plan.env.length > 0) {
+        out.push(chalk.bold('Environment'), ...indentList(plan.env.map((variable) => `${variable.name}${variable.required ? chalk.yellow(' (required)') : ''} ${chalk.dim(variable.description)}`)), '');
+    }
+    if (plan.services.length > 0) {
+        out.push(chalk.bold('Services'), ...indentList(plan.services), '');
+    }
+    for (const note of plan.notes) {
+        out.push(chalk.dim(`note: ${note.path ? `${note.path} ` : ''}${note.message}`));
+        if (options.diffs && note.diff)
+            out.push(colorDiff(note.diff));
+    }
+    for (const warning of plan.warnings)
+        out.push(chalk.yellow(`warning: ${warning}`));
+    if (options.diffs) {
+        for (const change of plan.changes)
+            if (change.diff)
+                out.push('', colorDiff(change.diff.trimEnd()));
+    }
+    return out.join('\n').trimEnd();
+}
+/** Why the addition was refused, with the change each conflicting file needs. */
+export function formatConflicts(plan) {
+    return [
+        chalk.red(`cogitator add would overwrite your changes to ${plan.conflicts.length} file${plan.conflicts.length === 1 ? '' : 's'}, so nothing was written:`),
+        ...plan.conflicts.flatMap((conflict) => [
+            '',
+            `${chalk.bold(conflict.path)}: ${conflict.reason}`,
+            colorDiff(conflict.diff.trimEnd()),
+        ]),
+        '',
+        'Apply these changes by hand, or set your edits aside and restore the generated files, then run cogitator add again.',
+    ].join('\n');
+}
+/** The plan as `--json` prints it: no file contents, diffs included. */
+export function addPlanJson(plan, result) {
+    const step = (value) => value && (value.status === 'failed' ? { status: 'failed', error: value.error.message } : value);
+    return {
+        ok: plan.conflicts.length === 0,
+        upToDate: plan.upToDate,
+        added: plan.summary,
+        spec: plan.to,
+        command: plan.command,
+        changes: plan.changes.map(({ path, kind, source, diff }) => ({ path, kind, source, diff })),
+        conflicts: plan.conflicts,
+        notes: plan.notes,
+        dependencies: plan.dependencies,
+        devDependencies: plan.devDependencies,
+        removedDependencies: plan.removedDependencies,
+        env: plan.env.map(({ name, required, secret, description }) => ({
+            name,
+            required,
+            secret,
+            description,
+        })),
+        services: plan.services,
+        warnings: plan.warnings,
+        ...(result && {
+            written: result.written,
+            deleted: result.deleted,
+            install: step(result.install),
+            format: step(result.format),
+        }),
+    };
+}
+//# sourceMappingURL=add.js.map

package/dist/utils/add.js.map

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

package/dist/utils/cli.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Exit codes every command uses: 0 when it did what was asked, 1 when it
+ * could not (a failed check, a failed deploy, a missing service), 2 when
+ * the command line itself is wrong.
+ */
+export declare const EXIT: {
+    readonly ok: 0;
+    readonly failed: 1;
+    readonly usage: 2;
+};
+export type ExitCode = (typeof EXIT)[keyof typeof EXIT];
+/** A failure a command reports to the user, with what to do about it. */
+export declare class CommandError extends Error {
+    readonly exitCode: ExitCode;
+    readonly hints: string[];
+    constructor(message: string, options?: {
+        hints?: string[];
+        exitCode?: ExitCode;
+        cause?: unknown;
+    });
+}
+/** A command line that cannot work: an unknown value, a missing argument. Exits 2. */
+export declare class UsageError extends CommandError {
+    constructor(message: string, hints?: string[]);
+}
+export declare function errorMessage(error: unknown): string;
+/** Whether `COGITATOR_DEBUG` asks for stack traces. */
+export declare function debugEnabled(env?: NodeJS.ProcessEnv): boolean;
+/** The exit code of any error a command ends with. */
+export declare function exitCodeOf(error: unknown): ExitCode;
+/**
+ * Prints how a command failed: as `{ ok: false, error }` on stdout with
+ * `--json`, otherwise as a message with its hints on stderr, with the stack
+ * when COGITATOR_DEBUG is set. Returns the exit code.
+ */
+export declare function reportFailure(error: unknown, options: {
+    json: boolean;
+    env?: NodeJS.ProcessEnv;
+}): ExitCode;
+/** The `Examples:` block of a command's help: each command with what it does. */
+export declare function examplesHelp(examples: ReadonlyArray<readonly [command: string, description: string]>): string;
+/** Prints `value` as the JSON a `--json` command answers with. */
+export declare function printJson(value: unknown): void;
+/**
+ * Ends the process with the failure, for code that cannot throw to the
+ * command: event handlers of child processes and signal handlers.
+ */
+export declare function exitWithFailure(error: unknown): never;
+//# sourceMappingURL=cli.d.ts.map

package/dist/utils/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/utils/cli.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,eAAO,MAAM,IAAI;;;;CAA0C,CAAC;AAC5D,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,IAAI,CAAC,CAAC,MAAM,OAAO,IAAI,CAAC,CAAC;AAExD,yEAAyE;AACzE,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;gBAGvB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO;CAO3E;AAED,sFAAsF;AACtF,qBAAa,UAAW,SAAQ,YAAY;gBAC9B,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,MAAM,EAAO;CAIlD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEnD;AAED,uDAAuD;AACvD,wBAAgB,YAAY,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAG1E;AAaD,sDAAsD;AACtD,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,CAOnD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,OAAO,EACd,OAAO,EAAE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;CAAE,GAClD,QAAQ,CA4BV;AAED,iFAAiF;AACjF,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,aAAa,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC,GACvE,MAAM,CASR;AAED,kEAAkE;AAClE,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAE9C;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAErD"}

package/dist/utils/cli.js

@@ -0,0 +1,106 @@
+import chalk from 'chalk';
+import { CommanderError } from 'commander';
+/**
+ * Exit codes every command uses: 0 when it did what was asked, 1 when it
+ * could not (a failed check, a failed deploy, a missing service), 2 when
+ * the command line itself is wrong.
+ */
+export const EXIT = { ok: 0, failed: 1, usage: 2 };
+/** A failure a command reports to the user, with what to do about it. */
+export class CommandError extends Error {
+    exitCode;
+    hints;
+    constructor(message, options = {}) {
+        super(message, options.cause !== undefined ? { cause: options.cause } : undefined);
+        this.name = 'CommandError';
+        this.exitCode = options.exitCode ?? EXIT.failed;
+        this.hints = options.hints ?? [];
+    }
+}
+/** A command line that cannot work: an unknown value, a missing argument. Exits 2. */
+export class UsageError extends CommandError {
+    constructor(message, hints = []) {
+        super(message, { hints, exitCode: EXIT.usage });
+        this.name = 'UsageError';
+    }
+}
+export function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+/** Whether `COGITATOR_DEBUG` asks for stack traces. */
+export function debugEnabled(env = process.env) {
+    const value = env.COGITATOR_DEBUG?.trim().toLowerCase();
+    return value !== undefined && value !== '' && value !== '0' && value !== 'false';
+}
+const USAGE_CODES = new Set([
+    'commander.unknownOption',
+    'commander.unknownCommand',
+    'commander.missingArgument',
+    'commander.missingMandatoryOptionValue',
+    'commander.optionMissingArgument',
+    'commander.invalidArgument',
+    'commander.excessArguments',
+    'commander.conflictingOption',
+]);
+/** The exit code of any error a command ends with. */
+export function exitCodeOf(error) {
+    if (error instanceof CommandError)
+        return error.exitCode;
+    if (error instanceof CommanderError) {
+        if (error.exitCode === 0)
+            return EXIT.ok;
+        return USAGE_CODES.has(error.code) ? EXIT.usage : EXIT.failed;
+    }
+    return EXIT.failed;
+}
+/**
+ * Prints how a command failed: as `{ ok: false, error }` on stdout with
+ * `--json`, otherwise as a message with its hints on stderr, with the stack
+ * when COGITATOR_DEBUG is set. Returns the exit code.
+ */
+export function reportFailure(error, options) {
+    const code = exitCodeOf(error);
+    const hints = error instanceof CommandError ? error.hints : [];
+    if (options.json) {
+        console.log(JSON.stringify({
+            ok: false,
+            error: {
+                message: errorMessage(error),
+                exitCode: code,
+                ...(hints.length > 0 && { hints }),
+            },
+        }, null, 2));
+        return code;
+    }
+    console.error(chalk.red('✗'), errorMessage(error));
+    for (const hint of hints)
+        console.error(chalk.dim(`  ${hint}`));
+    if (debugEnabled(options.env) && error instanceof Error && error.stack) {
+        console.error(chalk.dim(error.stack));
+    }
+    else if (!(error instanceof CommandError)) {
+        console.error(chalk.dim('  Set COGITATOR_DEBUG=1 for the stack trace.'));
+    }
+    return code;
+}
+/** The `Examples:` block of a command's help: each command with what it does. */
+export function examplesHelp(examples) {
+    const width = Math.max(...examples.map(([command]) => command.length));
+    return [
+        '',
+        'Examples:',
+        ...examples.map(([command, description]) => `  $ ${command.padEnd(width)}  ${chalk.dim(description)}`),
+    ].join('\n');
+}
+/** Prints `value` as the JSON a `--json` command answers with. */
+export function printJson(value) {
+    console.log(JSON.stringify(value, null, 2));
+}
+/**
+ * Ends the process with the failure, for code that cannot throw to the
+ * command: event handlers of child processes and signal handlers.
+ */
+export function exitWithFailure(error) {
+    process.exit(reportFailure(error, { json: false }));
+}
+//# sourceMappingURL=cli.js.map

package/dist/utils/cli.js.map

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

package/dist/utils/docs.d.ts

@@ -0,0 +1,39 @@
+export interface DocsLocation {
+    dir: string;
+    version: string;
+}
+export interface DocEntry {
+    /** Path inside the docs, such as `core/agents.md`. */
+    path: string;
+    title: string;
+    description: string;
+    section: string;
+}
+export interface DocsIndex extends DocsLocation {
+    entries: DocEntry[];
+}
+export interface DocHit extends DocEntry {
+    /** The heading of the part of the page that matched best. */
+    heading?: string;
+    snippet: string;
+    score: number;
+}
+/**
+ * The docs bundled with the @cogitator-ai/core a project installed, falling
+ * back to the one the CLI itself depends on.
+ */
+export declare function locateDocs(projectDir: string): DocsLocation;
+/** The catalog of pages, read from the `index.md` the docs ship with. */
+export declare function loadDocsIndex(location: DocsLocation): DocsIndex;
+/** Reads a page; `path#heading` returns only that part of the page. */
+export declare function readDoc(index: DocsIndex, reference: string): string;
+/** The anchor GitHub and Fumadocs give a heading. */
+export declare function slugOf(heading: string): string;
+/**
+ * Pages that answer `query`, best first. Titles weigh most, then the page
+ * descriptions, headings and body text; every term has to appear somewhere on
+ * a page for it to count, so `approval tool` finds the approvals guide rather
+ * than every page that mentions tools.
+ */
+export declare function searchDocs(index: DocsIndex, query: string, limit?: number): DocHit[];
+//# sourceMappingURL=docs.d.ts.map

package/dist/utils/docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/utils/docs.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,QAAQ;IACvB,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,SAAU,SAAQ,YAAY;IAC7C,OAAO,EAAE,QAAQ,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,MAAO,SAAQ,QAAQ;IACtC,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAuBD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY,CAkB3D;AAKD,yEAAyE;AACzE,wBAAgB,aAAa,CAAC,QAAQ,EAAE,YAAY,GAAG,SAAS,CAe/D;AAED,uEAAuE;AACvE,wBAAgB,OAAO,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAWnE;AAED,qDAAqD;AACrD,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAO9C;AA2ED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,MAAM,EAAE,CA0C/E"}

package/dist/utils/docs.js

@@ -0,0 +1,198 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { dirname, join, normalize, sep } from 'node:path';
+const CORE = '@cogitator-ai/core';
+function packageRoot(entry) {
+    let dir = dirname(entry);
+    for (;;) {
+        const manifest = join(dir, 'package.json');
+        if (existsSync(manifest)) {
+            const parsed = JSON.parse(readFileSync(manifest, 'utf-8'));
+            if (typeof parsed === 'object' &&
+                parsed !== null &&
+                'name' in parsed &&
+                parsed.name === CORE) {
+                return dir;
+            }
+        }
+        const parent = dirname(dir);
+        if (parent === dir)
+            return undefined;
+        dir = parent;
+    }
+}
+/**
+ * The docs bundled with the @cogitator-ai/core a project installed, falling
+ * back to the one the CLI itself depends on.
+ */
+export function locateDocs(projectDir) {
+    for (const base of [join(projectDir, 'package.json'), import.meta.url]) {
+        let entry;
+        try {
+            entry = createRequire(base).resolve(CORE);
+        }
+        catch {
+            continue;
+        }
+        const root = packageRoot(entry);
+        if (!root || !existsSync(join(root, 'docs', 'index.md')))
+            continue;
+        const manifest = JSON.parse(readFileSync(join(root, 'package.json'), 'utf-8'));
+        return { dir: join(root, 'docs'), version: manifest.version };
+    }
+    throw new Error(`No bundled docs found: install ${CORE} in the project (they ship in node_modules/${CORE}/docs)`);
+}
+const SECTION = /^## (.+)$/;
+const ENTRY = /^- \[(.+?)\]\(([^)]+\.md)\)(?::\s*(.*))?$/;
+/** The catalog of pages, read from the `index.md` the docs ship with. */
+export function loadDocsIndex(location) {
+    const entries = [];
+    let section = '';
+    for (const line of readFileSync(join(location.dir, 'index.md'), 'utf-8').split('\n')) {
+        const heading = SECTION.exec(line);
+        if (heading) {
+            section = heading[1];
+            continue;
+        }
+        const entry = ENTRY.exec(line);
+        if (entry) {
+            entries.push({ title: entry[1], path: entry[2], description: entry[3] ?? '', section });
+        }
+    }
+    return { ...location, entries };
+}
+/** Reads a page; `path#heading` returns only that part of the page. */
+export function readDoc(index, reference) {
+    const [rawPath, anchor] = reference.split('#', 2);
+    const path = normalize(rawPath.replace(/^\/+/, '')).split(sep).join('/');
+    const known = path === 'index.md' || index.entries.some((entry) => entry.path === path);
+    if (!known) {
+        throw new Error(`There is no doc page ${rawPath}: search the docs, or read index.md for the list`);
+    }
+    const text = readFileSync(join(index.dir, path), 'utf-8');
+    return anchor ? (sectionOf(text, anchor) ?? text) : text;
+}
+/** The anchor GitHub and Fumadocs give a heading. */
+export function slugOf(heading) {
+    return heading
+        .toLowerCase()
+        .replace(/[`*_~]/g, '')
+        .replace(/[^\p{L}\p{N}\s-]/gu, '')
+        .trim()
+        .replace(/\s+/g, '-');
+}
+function sectionOf(text, anchor) {
+    const lines = text.split('\n');
+    let inFence = false;
+    let start = -1;
+    let level = 0;
+    for (let i = 0; i < lines.length; i++) {
+        if (lines[i].startsWith('```'))
+            inFence = !inFence;
+        if (inFence)
+            continue;
+        const heading = /^(#{1,6})\s+(.+)$/.exec(lines[i]);
+        if (!heading)
+            continue;
+        if (start === -1 && slugOf(heading[2]) === anchor.toLowerCase()) {
+            start = i;
+            level = heading[1].length;
+        }
+        else if (start !== -1 && heading[1].length <= level) {
+            return lines.slice(start, i).join('\n').trimEnd();
+        }
+    }
+    return start === -1 ? undefined : lines.slice(start).join('\n').trimEnd();
+}
+function terms(query) {
+    return [...new Set(query.toLowerCase().match(/[\p{L}\p{N}_.-]{2,}/gu) ?? [])];
+}
+function occurrences(haystack, term) {
+    let count = 0;
+    for (let at = haystack.indexOf(term); at !== -1; at = haystack.indexOf(term, at + term.length)) {
+        count++;
+    }
+    return count;
+}
+function blocksOf(text) {
+    const blocks = [];
+    let heading;
+    let current = [];
+    const flush = () => {
+        const joined = current.join('\n').trim();
+        if (joined)
+            blocks.push({ heading, text: joined });
+        current = [];
+    };
+    for (const line of text.split('\n')) {
+        const match = /^#{2,6}\s+(.+)$/.exec(line);
+        if (match) {
+            flush();
+            heading = match[1].trim();
+        }
+        else if (line.trim() === '') {
+            flush();
+        }
+        else {
+            current.push(line);
+        }
+    }
+    flush();
+    return blocks;
+}
+function snippetOf(text, needles, width = 280) {
+    const flat = text.replace(/\s+/g, ' ').trim();
+    const lower = flat.toLowerCase();
+    const at = Math.min(...needles.map((needle) => lower.indexOf(needle)).filter((index) => index !== -1), flat.length);
+    const start = Math.max(0, Math.min(at - 60, flat.length - width));
+    const slice = flat.slice(start, start + width);
+    return `${start > 0 ? '...' : ''}${slice}${start + width < flat.length ? '...' : ''}`;
+}
+/**
+ * Pages that answer `query`, best first. Titles weigh most, then the page
+ * descriptions, headings and body text; every term has to appear somewhere on
+ * a page for it to count, so `approval tool` finds the approvals guide rather
+ * than every page that mentions tools.
+ */
+export function searchDocs(index, query, limit = 8) {
+    const needles = terms(query);
+    if (needles.length === 0)
+        return [];
+    const hits = [];
+    for (const entry of index.entries) {
+        const text = readFileSync(join(index.dir, entry.path), 'utf-8');
+        const lower = text.toLowerCase();
+        if (!needles.every((needle) => lower.includes(needle)))
+            continue;
+        const title = entry.title.toLowerCase();
+        const description = entry.description.toLowerCase();
+        let score = 0;
+        for (const needle of needles) {
+            score += (title.includes(needle) ? 12 : 0) + (description.includes(needle) ? 5 : 0);
+            score += Math.min(occurrences(lower, needle), 15);
+        }
+        const blocks = blocksOf(text);
+        let best;
+        let bestScore = 0;
+        for (const block of blocks) {
+            const blockLower = block.text.toLowerCase();
+            const headingLower = block.heading?.toLowerCase() ?? '';
+            const blockScore = needles.reduce((sum, needle) => sum +
+                Math.min(occurrences(blockLower, needle), 5) +
+                (headingLower.includes(needle) ? 4 : 0), 0);
+            if (blockScore > bestScore) {
+                best = block;
+                bestScore = blockScore;
+            }
+        }
+        score += bestScore;
+        hits.push({
+            ...entry,
+            ...(best?.heading && { heading: best.heading }),
+            snippet: snippetOf(best?.text ?? entry.description, needles),
+            score,
+        });
+    }
+    return hits.sort((a, b) => b.score - a.score).slice(0, limit);
+}
+//# sourceMappingURL=docs.js.map

package/dist/utils/docs.js.map

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

package/dist/utils/doctor.d.ts

@@ -0,0 +1,41 @@
+export type CheckStatus = 'pass' | 'warn' | 'fail';
+export interface DoctorCheck {
+    id: string;
+    label: string;
+    status: CheckStatus;
+    detail: string;
+    /** What to do about a warning or failure. */
+    fix?: string;
+}
+export interface DoctorContext {
+    projectDir: string;
+    /** The environment as the project sees it, `.env` loaded. */
+    env: Record<string, string | undefined>;
+    nodeVersion: string;
+    /** Network and service probes; off in tests that only check the project files. */
+    probe: boolean;
+    fetch?: typeof fetch;
+}
+/** Fills `env` with the variables of the project's `.env` that it does not set already. */
+export declare function loadProjectEnv(projectDir: string, env?: Record<string, string | undefined>): void;
+/** Whether `version` (like `v22.23.1`) satisfies a `>=x.y.z` range, the only form engines use here. */
+export declare function satisfiesMinimum(version: string, range: string): boolean;
+/** Variables `.env.example` lists without a leading `#`: the ones the project requires. */
+export declare function requiredVariables(projectDir: string): string[];
+/**
+ * The version of `name` the project resolves, `undefined` when it is not
+ * installed. Plug'n'Play installs are read through Yarn's own API, others the
+ * way Node looks packages up: node_modules of the project and every directory
+ * above it, so hoisted packages of a monorepo count.
+ */
+export declare function installedVersion(projectDir: string, name: string): string | undefined;
+/** Host and port of a service URL such as `redis://localhost:6379`, with the scheme's default port. */
+export declare function endpointOf(url: string, defaultPort: number): {
+    host: string;
+    port: number;
+} | undefined;
+/** Whether a TCP connection to `host:port` opens within `timeoutMs`. */
+export declare function canConnect(host: string, port: number, timeoutMs?: number): Promise<boolean>;
+/** Everything `cogitator doctor` checks, in the order it shows them. */
+export declare function runDoctor(context: DoctorContext): Promise<DoctorCheck[]>;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/utils/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/utils/doctor.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAEnD,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,kFAAkF;IAClF,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAmBD,2FAA2F;AAC3F,wBAAgB,cAAc,CAC5B,UAAU,EAAE,MAAM,EAClB,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GACpD,IAAI,CAMN;AAED,uGAAuG;AACvG,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAUxE;AAED,2FAA2F;AAC3F,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAO9D;AAwDD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAqBrF;AAmKD,uGAAuG;AACvG,wBAAgB,UAAU,CACxB,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM,GAClB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAU5C;AAED,wEAAwE;AACxE,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,SAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAWzF;AA+CD,wEAAwE;AACxE,wBAAsB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CA0B9E"}