ai-agent-context 0.1.0

package/dist/cli.js

@@ -0,0 +1,263 @@
+/**
+ * `agent-context` CLI — argument parsing and dispatch.
+ *
+ * The CLI contains no analysis logic: every command builds an AgentContext and
+ * prints a projection of the result. It is fully testable without spawning a
+ * process because {@link runCli} receives its I/O as parameters.
+ */
+import { AgentContext, toDiagnosticPayload, isAgentContextError } from '@ai-agent-context/core';
+import { ConsoleOutput } from "./ui/console.js";
+import { runInitCommand } from "./commands/init.js";
+import { runScanCommand } from "./commands/scan.js";
+import { runDiffCommand } from "./commands/diff.js";
+import { runStatusCommand } from "./commands/status.js";
+import { runExplainCommand } from "./commands/explain.js";
+import { runCleanCommand } from "./commands/clean.js";
+import { runSearchCommand } from "./commands/search.js";
+import { runContextCommand } from "./commands/context.js";
+export const CLI_NAME = 'agent-context';
+export const CLI_VERSION = '0.1.0';
+/** Flags that take a value when written as `--flag value`. */
+const VALUED_FLAGS = new Set([
+    'root',
+    'config',
+    'include',
+    'exclude',
+    'ignore',
+    'language',
+    'languages',
+    'limit',
+    'types',
+    'max-files',
+]);
+const KNOWN_FLAGS = new Set([
+    'help',
+    'version',
+    'json',
+    'quiet',
+    'verbose',
+    'force',
+    'yes',
+    'color',
+    'cache',
+    'all',
+    'root',
+    'config',
+    'include',
+    'exclude',
+    'ignore',
+    'language',
+    'languages',
+    'limit',
+    'types',
+    'max-files',
+]);
+function appendFlag(flags, name, value) {
+    const existing = flags.get(name);
+    if (typeof existing === 'string' && existing.length > 0)
+        flags.set(name, `${existing},${value}`);
+    else
+        flags.set(name, value);
+}
+/**
+ * Parses CLI arguments.
+ *
+ * Supported forms: `--flag`, `--no-flag`, `--key=value`, `--key value`, `-h`.
+ * Repeated value flags are joined with commas, so
+ * `--include a --include b` behaves like `--include a,b`.
+ */
+export function parseArguments(argv) {
+    const flags = new Map();
+    const positional = [];
+    const unknownFlags = [];
+    let command = null;
+    for (let index = 0; index < argv.length; index += 1) {
+        const argument = argv[index];
+        if (argument.startsWith('--')) {
+            const body = argument.slice(2);
+            if (body.length === 0)
+                continue;
+            const equals = body.indexOf('=');
+            if (equals !== -1) {
+                appendFlag(flags, body.slice(0, equals), body.slice(equals + 1));
+                continue;
+            }
+            if (body.startsWith('no-')) {
+                flags.set(body.slice(3), false);
+                continue;
+            }
+            const next = argv[index + 1];
+            if (VALUED_FLAGS.has(body) && next !== undefined && !next.startsWith('-')) {
+                appendFlag(flags, body, next);
+                index += 1;
+                continue;
+            }
+            flags.set(body, true);
+            if (!KNOWN_FLAGS.has(body))
+                unknownFlags.push(body);
+            continue;
+        }
+        if (argument.startsWith('-') && argument.length > 1) {
+            const short = argument.slice(1);
+            if (short === 'h')
+                flags.set('help', true);
+            else if (short === 'v')
+                flags.set('version', true);
+            else
+                unknownFlags.push(short);
+            continue;
+        }
+        if (command === null)
+            command = argument;
+        else
+            positional.push(argument);
+    }
+    return { command, positional, flags, unknownFlags };
+}
+export function flagString(parsed, name) {
+    const value = parsed.flags.get(name);
+    return typeof value === 'string' ? value : undefined;
+}
+export function flagList(parsed, name) {
+    const value = flagString(parsed, name);
+    if (value === undefined)
+        return undefined;
+    const items = value
+        .split(',')
+        .map((item) => item.trim())
+        .filter((item) => item.length > 0);
+    return items.length > 0 ? items : undefined;
+}
+export function flagBoolean(parsed, name) {
+    return parsed.flags.get(name) === true;
+}
+/** Builds the {@link AgentContextOptions} implied by global CLI flags. */
+export function contextOptions(parsed, io) {
+    const include = flagList(parsed, 'include');
+    const exclude = flagList(parsed, 'exclude');
+    const ignore = flagList(parsed, 'ignore');
+    const languages = flagList(parsed, 'languages') ?? flagList(parsed, 'language');
+    const root = flagString(parsed, 'root') ?? io.cwd;
+    const options = {
+        root,
+        config: {
+            ...(include === undefined ? {} : { include }),
+            ...(exclude === undefined ? {} : { exclude }),
+            ...(ignore === undefined ? {} : { ignore }),
+            ...(languages === undefined ? {} : { languages }),
+        },
+    };
+    const configPath = flagString(parsed, 'config');
+    if (configPath !== undefined)
+        options.configPath = configPath;
+    return options;
+}
+const HELP_TEXT = `Git-native context layer for AI coding agents
+
+Usage:
+  agent-context <command> [options]
+
+Commands:
+  init                 Create .agent/ and .agent/config.json (idempotent)
+  scan                 Analyze the repository and update .agent/
+  diff                 Show repository context changes since the last scan
+  status               Show whether the context is up to date
+  explain <path>       Explain a module (or the module owning a file)
+  search <query>       Deterministic lexical search over the context
+  context              Compact repository context summary
+  clean                Remove generated context and caches
+
+Options:
+  --root <path>        Repository root (default: current directory)
+  --config <path>      Alternative configuration file
+  --include <glob>     Override include patterns (repeatable, comma separated)
+  --exclude <glob>     Override exclude patterns
+  --ignore <glob>      Additional ignore patterns
+  --language <name>    Restrict language analysis (repeatable)
+  --force              init: overwrite config · scan: ignore the local state
+  --json               Machine readable output on stdout
+  --quiet              Suppress progress output
+  --verbose            Verbose diagnostics on stderr
+  --no-color           Disable colours
+  -h, --help           Show this help
+  -v, --version        Show the version
+
+Exit codes:
+  0 success · 1 analysis error · 2 usage error
+`;
+/** Runs the CLI and returns the process exit code. */
+export async function runCli(argv, ioOverrides = {}) {
+    const io = {
+        stdout: ioOverrides.stdout ?? ((line) => process.stdout.write(`${line}\n`)),
+        stderr: ioOverrides.stderr ?? ((line) => process.stderr.write(`${line}\n`)),
+        cwd: ioOverrides.cwd ?? process.cwd(),
+        env: ioOverrides.env ?? process.env,
+    };
+    const parsed = parseArguments(argv);
+    const color = io.color ??
+        (io.env['NO_COLOR'] === undefined && parsed.flags.get('color') !== false && process.stdout.isTTY === true);
+    const output = new ConsoleOutput({
+        stdout: io.stdout,
+        stderr: io.stderr,
+        color,
+        quiet: flagBoolean(parsed, 'quiet'),
+        verbose: flagBoolean(parsed, 'verbose'),
+    });
+    if (flagBoolean(parsed, 'version')) {
+        output.print(CLI_VERSION);
+        return 0;
+    }
+    if (flagBoolean(parsed, 'help')) {
+        output.print(HELP_TEXT);
+        return 0;
+    }
+    if (parsed.command === null || parsed.command === 'help') {
+        output.print(HELP_TEXT);
+        return argv.length > 0 && parsed.command === null ? 2 : 0;
+    }
+    if (parsed.unknownFlags.length > 0) {
+        output.error(`unknown option(s): ${parsed.unknownFlags.join(', ')}`);
+        output.note('Run: agent-context --help');
+        return 2;
+    }
+    const dependencies = {
+        createContext: async (options) => AgentContext.load(options),
+    };
+    const commandContext = { parsed, output, io, json: flagBoolean(parsed, 'json') };
+    try {
+        switch (parsed.command) {
+            case 'init':
+                return await runInitCommand(commandContext, dependencies);
+            case 'scan':
+                return await runScanCommand(commandContext, dependencies);
+            case 'diff':
+                return await runDiffCommand(commandContext, dependencies);
+            case 'status':
+                return await runStatusCommand(commandContext, dependencies);
+            case 'explain':
+                return await runExplainCommand(commandContext, dependencies);
+            case 'search':
+                return await runSearchCommand(commandContext, dependencies);
+            case 'context':
+                return await runContextCommand(commandContext, dependencies);
+            case 'clean':
+                return await runCleanCommand(commandContext, dependencies);
+            default:
+                output.error(`unknown command: ${parsed.command}`);
+                output.note('Run: agent-context --help');
+                return 2;
+        }
+    }
+    catch (error) {
+        const payload = toDiagnosticPayload(error);
+        output.error(payload.message);
+        if (isAgentContextError(error)) {
+            for (const hint of error.hints)
+                output.note(`  ${hint}`);
+        }
+        if (output.verbose && error instanceof Error && error.stack !== undefined)
+            output.note(error.stack);
+        return 1;
+    }
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/commands/clean.d.ts

@@ -0,0 +1,3 @@
+import type { CliCommandContext, CliDependencies } from '../cli.ts';
+export declare function runCleanCommand(context: CliCommandContext, dependencies: CliDependencies): Promise<number>;
+//# sourceMappingURL=clean.d.ts.map

package/dist/commands/clean.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clean.d.ts","sourceRoot":"","sources":["../../src/commands/clean.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAGpE,wBAAsB,eAAe,CAAC,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CA0ChH"}

package/dist/commands/clean.js

@@ -0,0 +1,53 @@
+/**
+ * `agent-context clean` — remove generated context and local caches.
+ *
+ * Safety rules:
+ * - only ever touches paths inside `.agent/`: source code is never a candidate;
+ * - destructive operations require explicit confirmation (`--yes`);
+ * - `--cache` is the narrow option: it clears only the local parse cache.
+ */
+import { existsSync } from 'node:fs';
+import path from 'node:path';
+import { AGENT_DIR, ParseCache, removeContextDirectory } from '@ai-agent-context/core';
+import { flagBoolean, contextOptions } from "../cli.js";
+export async function runCleanCommand(context, dependencies) {
+    const { output, parsed, io } = context;
+    const agentContext = await dependencies.createContext(contextOptions(parsed, io));
+    const root = agentContext.root;
+    const cacheOnly = flagBoolean(parsed, 'cache');
+    const confirmed = flagBoolean(parsed, 'yes');
+    const removeConfig = flagBoolean(parsed, 'all');
+    if (!existsSync(path.join(root, AGENT_DIR))) {
+        output.print('Nothing to clean: .agent/ does not exist.');
+        return 0;
+    }
+    if (!cacheOnly && !confirmed) {
+        output.warn('This removes the generated context inside .agent/. Source code is never touched.');
+        output.note('Confirm with --yes, or clear only the local cache with --cache.');
+        output.print('');
+        output.print('Usage: agent-context clean [--cache] [--all] [--yes]');
+        return 2;
+    }
+    const removed = [];
+    if (cacheOnly) {
+        await new ParseCache(root).clear();
+        removed.push('.agent/.local/cache/');
+    }
+    else {
+        removed.push(...(await removeContextDirectory(root, { keepConfig: !removeConfig })));
+    }
+    removed.sort();
+    if (context.json) {
+        output.print(JSON.stringify({ root, removed, cacheOnly, removedConfig: !cacheOnly && removeConfig }, null, 2));
+        return 0;
+    }
+    output.success(`Removed ${removed.length} path(s) inside .agent/:`);
+    output.list(removed);
+    if (!cacheOnly) {
+        output.blank();
+        output.print('Run:');
+        output.print('  agent-context scan      # regenerate the context');
+    }
+    return 0;
+}
+//# sourceMappingURL=clean.js.map

package/dist/commands/clean.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clean.js","sourceRoot":"","sources":["../../src/commands/clean.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAEvF,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAExD,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAA0B,EAAE,YAA6B;IAC7F,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC;IACvC,MAAM,YAAY,GAAG,MAAM,YAAY,CAAC,aAAa,CAAC,cAAc,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC;IAClF,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC;IAC/B,MAAM,SAAS,GAAG,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/C,MAAM,SAAS,GAAG,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC7C,MAAM,YAAY,GAAG,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAEhD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC;QAC5C,MAAM,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAC1D,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,CAAC,SAAS,IAAI,CAAC,SAAS,EAAE,CAAC;QAC7B,MAAM,CAAC,IAAI,CAAC,kFAAkF,CAAC,CAAC;QAChG,MAAM,CAAC,IAAI,CAAC,iEAAiE,CAAC,CAAC;QAC/E,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACjB,MAAM,CAAC,KAAK,CAAC,sDAAsD,CAAC,CAAC;QACrE,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;QACnC,OAAO,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IACvC,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,sBAAsB,CAAC,IAAI,EAAE,EAAE,UAAU,EAAE,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,CAAC;IACvF,CAAC;IACD,OAAO,CAAC,IAAI,EAAE,CAAC;IAEf,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC,SAAS,IAAI,YAAY,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC/G,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,CAAC,OAAO,CAAC,WAAW,OAAO,CAAC,MAAM,0BAA0B,CAAC,CAAC;IACpE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACrB,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACrB,MAAM,CAAC,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/commands/context.d.ts

@@ -0,0 +1,4 @@
+/** `agent-context context` — compact repository context for agents and humans. */
+import type { CliCommandContext, CliDependencies } from '../cli.ts';
+export declare function runContextCommand(context: CliCommandContext, dependencies: CliDependencies): Promise<number>;
+//# sourceMappingURL=context.d.ts.map

package/dist/commands/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/commands/context.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAIpE,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAYlH"}

package/dist/commands/context.js

@@ -0,0 +1,15 @@
+import { contextOptions } from "../cli.js";
+import { renderRepositoryContext } from "../ui/format.js";
+export async function runContextCommand(context, dependencies) {
+    const { output, parsed, io } = context;
+    const agentContext = await dependencies.createContext(contextOptions(parsed, io));
+    const repositoryContext = await agentContext.getRepositoryContext();
+    if (context.json) {
+        output.print(JSON.stringify(repositoryContext, null, 2));
+        return 0;
+    }
+    for (const line of renderRepositoryContext(repositoryContext))
+        output.print(line);
+    return 0;
+}
+//# sourceMappingURL=context.js.map

package/dist/commands/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/commands/context.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAA0B,EAAE,YAA6B;IAC/F,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC;IACvC,MAAM,YAAY,GAAG,MAAM,YAAY,CAAC,aAAa,CAAC,cAAc,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC;IAClF,MAAM,iBAAiB,GAAG,MAAM,YAAY,CAAC,oBAAoB,EAAE,CAAC;IAEpE,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,iBAAiB,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACzD,OAAO,CAAC,CAAC;IACX,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,uBAAuB,CAAC,iBAAiB,CAAC;QAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClF,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/commands/diff.d.ts

@@ -0,0 +1,4 @@
+/** `agent-context diff` — repository context changes since the persisted scan. */
+import type { CliCommandContext, CliDependencies } from '../cli.ts';
+export declare function runDiffCommand(context: CliCommandContext, dependencies: CliDependencies): Promise<number>;
+//# sourceMappingURL=diff.d.ts.map

package/dist/commands/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../src/commands/diff.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAIpE,wBAAsB,cAAc,CAAC,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAoB/G"}

package/dist/commands/diff.js

@@ -0,0 +1,24 @@
+import { contextOptions } from "../cli.js";
+import { renderDiff } from "../ui/format.js";
+export async function runDiffCommand(context, dependencies) {
+    const { output, parsed, io } = context;
+    const agentContext = await dependencies.createContext(contextOptions(parsed, io));
+    const diff = await agentContext.diff();
+    if (context.json) {
+        output.print(JSON.stringify(diff, null, 2));
+        return 0;
+    }
+    for (const line of renderDiff(diff))
+        output.print(line);
+    output.blank();
+    if (diff.hasChanges) {
+        output.note(`Baseline: ${diff.baseline ?? 'no local state (first run)'}`);
+        output.print('Run:');
+        output.print('  agent-context scan      # persist the new context');
+    }
+    else {
+        output.print('Context matches the working tree.');
+    }
+    return 0;
+}
+//# sourceMappingURL=diff.js.map

package/dist/commands/diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.js","sourceRoot":"","sources":["../../src/commands/diff.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAA0B,EAAE,YAA6B;IAC5F,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC;IACvC,MAAM,YAAY,GAAG,MAAM,YAAY,CAAC,aAAa,CAAC,cAAc,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC;IAClF,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,IAAI,EAAE,CAAC;IAEvC,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC5C,OAAO,CAAC,CAAC;IACX,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,UAAU,CAAC,IAAI,CAAC;QAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACxD,MAAM,CAAC,KAAK,EAAE,CAAC;IACf,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QACpB,MAAM,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,QAAQ,IAAI,4BAA4B,EAAE,CAAC,CAAC;QAC1E,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACrB,MAAM,CAAC,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACtE,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/commands/explain.d.ts

@@ -0,0 +1,4 @@
+/** `agent-context explain <path>` — structured module context. */
+import type { CliCommandContext, CliDependencies } from '../cli.ts';
+export declare function runExplainCommand(context: CliCommandContext, dependencies: CliDependencies): Promise<number>;
+//# sourceMappingURL=explain.d.ts.map

package/dist/commands/explain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain.d.ts","sourceRoot":"","sources":["../../src/commands/explain.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAIpE,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAuClH"}

package/dist/commands/explain.js

@@ -0,0 +1,43 @@
+import { contextOptions } from "../cli.js";
+import { renderExplain, renderRepositoryContext } from "../ui/format.js";
+export async function runExplainCommand(context, dependencies) {
+    const { output, parsed, io } = context;
+    const agentContext = await dependencies.createContext(contextOptions(parsed, io));
+    const target = parsed.positional[0];
+    if (target === undefined) {
+        const repositoryContext = await agentContext.getRepositoryContext();
+        if (context.json) {
+            output.print(JSON.stringify(repositoryContext, null, 2));
+            return 0;
+        }
+        for (const line of renderRepositoryContext(repositoryContext))
+            output.print(line);
+        return 0;
+    }
+    const explanation = await agentContext.explain(target);
+    if (explanation === null) {
+        output.error(`cannot explain "${target}": no module or file matched.`);
+        const modules = await agentContext.getModules();
+        const suggestions = modules
+            .filter((module) => module.id.includes(target) || module.path.includes(target))
+            .slice(0, 5)
+            .map((module) => module.id);
+        if (suggestions.length > 0) {
+            output.note('Did you mean one of these?');
+            for (const suggestion of suggestions)
+                output.note(`  ${suggestion}`);
+        }
+        else {
+            output.note('Run: agent-context context   # list the detected modules');
+        }
+        return 1;
+    }
+    if (context.json) {
+        output.print(JSON.stringify(explanation, null, 2));
+        return 0;
+    }
+    for (const line of renderExplain(explanation))
+        output.print(line);
+    return 0;
+}
+//# sourceMappingURL=explain.js.map

package/dist/commands/explain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain.js","sourceRoot":"","sources":["../../src/commands/explain.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAEzE,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAA0B,EAAE,YAA6B;IAC/F,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC;IACvC,MAAM,YAAY,GAAG,MAAM,YAAY,CAAC,aAAa,CAAC,cAAc,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC;IAClF,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAEpC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,iBAAiB,GAAG,MAAM,YAAY,CAAC,oBAAoB,EAAE,CAAC;QACpE,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,iBAAiB,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YACzD,OAAO,CAAC,CAAC;QACX,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,uBAAuB,CAAC,iBAAiB,CAAC;YAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClF,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,WAAW,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACvD,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;QACzB,MAAM,CAAC,KAAK,CAAC,mBAAmB,MAAM,+BAA+B,CAAC,CAAC;QACvE,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,UAAU,EAAE,CAAC;QAChD,MAAM,WAAW,GAAG,OAAO;aACxB,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;aAC9E,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;aACX,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC9B,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,MAAM,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;YAC1C,KAAK,MAAM,UAAU,IAAI,WAAW;gBAAE,MAAM,CAAC,IAAI,CAAC,KAAK,UAAU,EAAE,CAAC,CAAC;QACvE,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CAAC,0DAA0D,CAAC,CAAC;QAC1E,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACnD,OAAO,CAAC,CAAC;IACX,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,aAAa,CAAC,WAAW,CAAC;QAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClE,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/commands/init.d.ts

@@ -0,0 +1,4 @@
+/** `agent-context init` — create `.agent/` and `.agent/config.json` (idempotent). */
+import { type CliCommandContext, type CliDependencies } from '../cli.ts';
+export declare function runInitCommand(context: CliCommandContext, dependencies: CliDependencies): Promise<number>;
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,OAAO,EAAe,KAAK,iBAAiB,EAAE,KAAK,eAAe,EAAE,MAAM,WAAW,CAAC;AAGtF,wBAAsB,cAAc,CAAC,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAwB/G"}

package/dist/commands/init.js

@@ -0,0 +1,28 @@
+/** `agent-context init` — create `.agent/` and `.agent/config.json` (idempotent). */
+import { flagBoolean } from "../cli.js";
+import { contextOptions } from "../cli.js";
+export async function runInitCommand(context, dependencies) {
+    const { output, parsed, io } = context;
+    const force = flagBoolean(parsed, 'force');
+    const agentContext = await dependencies.createContext(contextOptions(parsed, io));
+    const result = await agentContext.init({ force });
+    if (context.json) {
+        output.print(JSON.stringify(result, null, 2));
+        return 0;
+    }
+    if (result.created.length > 0) {
+        output.success('Created:');
+        output.list(result.created);
+    }
+    if (result.overwritten)
+        output.note('Existing configuration overwritten (--force).');
+    if (result.created.length === 0 && !result.overwritten) {
+        output.print(`Configuration already exists: ${agentContext.configFile ?? '.agent/config.json'}`);
+        output.note('Use --force to overwrite it.');
+    }
+    output.blank();
+    output.print('Next:');
+    output.print('  agent-context scan');
+    return 0;
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,OAAO,EAAE,WAAW,EAAgD,MAAM,WAAW,CAAC;AACtF,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAE3C,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAA0B,EAAE,YAA6B;IAC5F,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC;IACvC,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,MAAM,YAAY,GAAG,MAAM,YAAY,CAAC,aAAa,CAAC,cAAc,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC;IAClF,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAElD,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC9C,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAC3B,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IACD,IAAI,MAAM,CAAC,WAAW;QAAE,MAAM,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC;IACrF,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;QACvD,MAAM,CAAC,KAAK,CAAC,iCAAiC,YAAY,CAAC,UAAU,IAAI,oBAAoB,EAAE,CAAC,CAAC;QACjG,MAAM,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;IAC9C,CAAC;IACD,MAAM,CAAC,KAAK,EAAE,CAAC;IACf,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACtB,MAAM,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;IACrC,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/commands/scan.d.ts

@@ -0,0 +1,4 @@
+/** `agent-context scan` — analyze the repository and update `.agent/`. */
+import { type CliCommandContext, type CliDependencies } from '../cli.ts';
+export declare function runScanCommand(context: CliCommandContext, dependencies: CliDependencies): Promise<number>;
+//# sourceMappingURL=scan.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scan.d.ts","sourceRoot":"","sources":["../../src/commands/scan.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,OAAO,EAAe,KAAK,iBAAiB,EAAE,KAAK,eAAe,EAAE,MAAM,WAAW,CAAC;AAKtF,wBAAsB,cAAc,CAAC,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CA6B/G"}

package/dist/commands/scan.js

@@ -0,0 +1,35 @@
+/** `agent-context scan` — analyze the repository and update `.agent/`. */
+import { flagBoolean } from "../cli.js";
+import { contextOptions } from "../cli.js";
+import { renderScanSummary } from "../ui/format.js";
+import { Logger } from '@ai-agent-context/core';
+export async function runScanCommand(context, dependencies) {
+    const { output, parsed, io } = context;
+    const options = contextOptions(parsed, io);
+    options.logger = new Logger({
+        level: output.verbose ? 'verbose' : output.quiet ? 'silent' : 'info',
+        sink: (line) => output.note(line),
+    });
+    if (!output.quiet && !context.json)
+        options.progress = (event) => output.note(event.message);
+    const agentContext = await dependencies.createContext(options);
+    const report = await agentContext.scan({ force: flagBoolean(parsed, 'force') });
+    if (context.json) {
+        output.print(JSON.stringify(report, null, 2));
+        return report.files.failed > 0 && report.files.total === 0 ? 1 : 0;
+    }
+    output.success(`Analyzed ${report.files.total} files.`);
+    for (const line of renderScanSummary(report))
+        output.print(line);
+    output.blank();
+    output.print('Context updated:');
+    output.list(['.agent/index.json', '.agent/architecture.json', '.agent/dependencies.json', '.agent/conventions.md', '.agent/decisions.json']);
+    if (!output.quiet) {
+        output.blank();
+        output.print('Next:');
+        output.print('  agent-context diff      # review the context changes');
+        output.print('  agent-context explain <path>');
+    }
+    return 0;
+}
+//# sourceMappingURL=scan.js.map

package/dist/commands/scan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan.js","sourceRoot":"","sources":["../../src/commands/scan.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,OAAO,EAAE,WAAW,EAAgD,MAAM,WAAW,CAAC;AACtF,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAEhD,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAA0B,EAAE,YAA6B;IAC5F,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC;IACvC,MAAM,OAAO,GAAG,cAAc,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC3C,OAAO,CAAC,MAAM,GAAG,IAAI,MAAM,CAAC;QAC1B,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM;QACpE,IAAI,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;KAC1C,CAAC,CAAC;IACH,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,IAAI;QAAE,OAAO,CAAC,QAAQ,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAE7F,MAAM,YAAY,GAAG,MAAM,YAAY,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IAC/D,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;IAEhF,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC9C,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrE,CAAC;IAED,MAAM,CAAC,OAAO,CAAC,YAAY,MAAM,CAAC,KAAK,CAAC,KAAK,SAAS,CAAC,CAAC;IACxD,KAAK,MAAM,IAAI,IAAI,iBAAiB,CAAC,MAAM,CAAC;QAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACjE,MAAM,CAAC,KAAK,EAAE,CAAC;IACf,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;IACjC,MAAM,CAAC,IAAI,CAAC,CAAC,mBAAmB,EAAE,0BAA0B,EAAE,0BAA0B,EAAE,uBAAuB,EAAE,uBAAuB,CAAC,CAAC,CAAC;IAC7I,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,CAAC,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACtB,MAAM,CAAC,KAAK,CAAC,wDAAwD,CAAC,CAAC;QACvE,MAAM,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/commands/search.d.ts

@@ -0,0 +1,9 @@
+/**
+ * `agent-context search <query>` — deterministic lexical search.
+ *
+ * The default backend is BM25 over the knowledge graph; no embeddings, no LLM and
+ * no network access are involved.
+ */
+import type { CliCommandContext, CliDependencies } from '../cli.ts';
+export declare function runSearchCommand(context: CliCommandContext, dependencies: CliDependencies): Promise<number>;
+//# sourceMappingURL=search.d.ts.map

package/dist/commands/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/commands/search.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAKpE,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAgCjH"}

package/dist/commands/search.js

@@ -0,0 +1,34 @@
+import { contextOptions, flagList, flagString } from "../cli.js";
+import { renderSearchResults } from "../ui/format.js";
+export async function runSearchCommand(context, dependencies) {
+    const { output, parsed, io } = context;
+    const query = parsed.positional.join(' ').trim();
+    if (query.length === 0) {
+        output.error('search requires a query, for example: agent-context search "payment idempotency"');
+        return 2;
+    }
+    const limitValue = flagString(parsed, 'limit');
+    const limit = limitValue === undefined ? 10 : Number.parseInt(limitValue, 10);
+    if (Number.isNaN(limit) || limit <= 0) {
+        output.error(`--limit must be a positive integer (received: ${limitValue ?? ''})`);
+        return 2;
+    }
+    const types = flagList(parsed, 'types');
+    const searchOptions = { limit };
+    if (types !== undefined)
+        searchOptions.types = types;
+    const agentContext = await dependencies.createContext(contextOptions(parsed, io));
+    const results = await agentContext.search(query, searchOptions);
+    if (context.json) {
+        output.print(JSON.stringify({ query, backend: 'bm25', results }, null, 2));
+        return results.length === 0 ? 1 : 0;
+    }
+    output.heading(`Search: ${query}`);
+    output.blank();
+    for (const line of renderSearchResults(results))
+        output.print(line);
+    output.blank();
+    output.note(`backend: bm25 (deterministic lexical search, local only) · ${results.length} result(s)`);
+    return results.length === 0 ? 1 : 0;
+}
+//# sourceMappingURL=search.js.map

package/dist/commands/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/commands/search.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAGtD,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAA0B,EAAE,YAA6B;IAC9F,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC;IACvC,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACjD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,CAAC,KAAK,CAAC,kFAAkF,CAAC,CAAC;QACjG,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,UAAU,GAAG,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/C,MAAM,KAAK,GAAG,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC9E,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QACtC,MAAM,CAAC,KAAK,CAAC,iDAAiD,UAAU,IAAI,EAAE,GAAG,CAAC,CAAC;QACnF,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,MAAM,aAAa,GAAsD,EAAE,KAAK,EAAE,CAAC;IACnF,IAAI,KAAK,KAAK,SAAS;QAAE,aAAa,CAAC,KAAK,GAAG,KAA+B,CAAC;IAE/E,MAAM,YAAY,GAAG,MAAM,YAAY,CAAC,aAAa,CAAC,cAAc,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC;IAClF,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;IAEhE,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC3E,OAAO,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACtC,CAAC;IAED,MAAM,CAAC,OAAO,CAAC,WAAW,KAAK,EAAE,CAAC,CAAC;IACnC,MAAM,CAAC,KAAK,EAAE,CAAC;IACf,KAAK,MAAM,IAAI,IAAI,mBAAmB,CAAC,OAAO,CAAC;QAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACpE,MAAM,CAAC,KAAK,EAAE,CAAC;IACf,MAAM,CAAC,IAAI,CAAC,8DAA8D,OAAO,CAAC,MAAM,YAAY,CAAC,CAAC;IACtG,OAAO,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACtC,CAAC"}

package/dist/commands/status.d.ts

@@ -0,0 +1,4 @@
+/** `agent-context status` — is the context up to date? */
+import type { CliCommandContext, CliDependencies } from '../cli.ts';
+export declare function runStatusCommand(context: CliCommandContext, dependencies: CliDependencies): Promise<number>;
+//# sourceMappingURL=status.d.ts.map

package/dist/commands/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAIpE,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAYjH"}