@any-nav/cli 0.0.0-stage → 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,33 @@
+# Changelog
+
+## 0.2.0 — 2026-10-31
+
+- The `config` topic's `[scan]` section opens with the ignore mapping:
+  the excludes a reader looks for live here (`excludeDirs` /
+  `excludeFiles` / `excludeDotEntries`); the rest — `respectGitignore` /
+  `boundaryExempt` / `maxFiles` — is traversal-boundary policy, not
+  more excludes. Key names unchanged; the page keeps its 100-line cap
+  (three in-page reflows pay for the teaching sentences).
+- The folder-row teaching follows the scan carrier swap: `list --help`,
+  the `config` topic, and the `telling-agents` topic now describe a
+  folder row as reading the directory's `package.json` /
+  `manifest.yml` description, else its README.
+- Rides the lockstep train on the `@any-nav/core` 0.2.0 bump: lazy
+  fast-bm25 load, representative-README locators on folder rows, and the
+  scan 0.2.0 face flowing through the re-export.
+
+## 0.1.0 — 2026-10-21
+
+First registry release.
+
+- Command roster: `any-nav init / list [path] / help [topic]`, exit ladder
+  0 (success — including empty results and rendered help/version) / 1
+  (runtime failure) / 2 (usage error).
+- `list` answers rows by default; `--write` materializes the listing into an
+  idempotent marked section of the entry file; `--depth` bounds the walk.
+- `--json` — the machine face: the routing projection as pure JSON on
+  stdout, diagnostics triaged by audience (maintainer-class notes go to
+  stderr, never into the JSON stream).
+- Budget cuts are visible on the surface: `list` rows render ≥N floors
+  for cut folders; the `config` help topic's `maxFiles` row states the
+  same semantics.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 CatheadOwl
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,47 @@
-# Temporary Holding Version
+# @any-nav/cli
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+> Point any-nav at any Markdown folder. No more hand-maintained index files.
+
+The Any-Nav CLI integration adapter: it discovers config, answers navigation
+queries, and materializes generated listings into marked file sections. This
+package owns all disk writes and exit codes — the SDK (`@any-nav/core`) it
+wraps is read-only.
+
+## Install
+
+```sh
+npm install -g @any-nav/cli
+```
+
+## Usage
+
+```sh
+any-nav init               # scaffold an any-nav.toml in the current folder
+any-nav list [path]        # render the navigation listing for a folder
+any-nav list --depth N     # bound the walk depth
+any-nav list --write       # materialize the listing into the marked section
+any-nav list --json        # machine face: pure JSON (routing projection) on stdout
+any-nav help [command]     # command help, plus non-command help topics
+```
+
+- Empty results are legal answers (`exit 0`) — this is a data-presentation
+  tool, not a filter.
+- Exit ladder: `0` success (including rendered help/version), `1` runtime
+  failure, `2` usage error.
+- `--json` keeps stdout a pure JSON stream: maintainer-class diagnostics go
+  to stderr, consumer-facing notes ride the listing itself.
+
+## Config
+
+`any-nav.toml` — states only exceptions; every key defaults:
+
+- `local` — curation list: paths expanded into the default listing.
+- `budget` — the context-budget guard (warns, never silently collapses).
+- `scan` — scan boundary policy, additive over the engine's built-in floor.
+
+`list` walks up from the target folder for the nearest `any-nav.toml`;
+without one it lists on pure defaults.
+
+## License
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,9 @@
+export interface Io {
+    stdout: {
+        write(s: string): void;
+    };
+    stderr: {
+        write(s: string): void;
+    };
+}
+export declare function run(argv: string[], io?: Io): Promise<number>;

package/dist/cli.js

@@ -0,0 +1,331 @@
+/**
+ * any-nav CLI — integration adapter A1 (L0). The unified list model sets
+ * the roster: init /
+ * list / help — generate retired into list's --write form, so the write
+ * is the very payload the listing prints, spliced between markers.
+ *
+ * Family rules have a single implementation point here: run(argv, io)
+ * routes commander errors by typed code (helpDisplayed/version → 0,
+ * other commander.* → usage error 2, runtime → 1); data goes to stdout,
+ * diagnostics to stderr; output ends with exactly one newline.
+ */
+import { Command, CommanderError, InvalidArgumentError, Option } from 'commander';
+import { exec } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { promisify } from 'node:util';
+import { createRequire } from 'node:module';
+import { dirname, join, relative, resolve } from 'node:path';
+import { ConfigError, CURATED_OMISSION_CLAUSE, defaultMarkers, estimateTokens, listFolder, materialize, routingViewJson, toolBlockLines, } from '@any-nav/core';
+import { renderHelpTopic, renderHelpTopicsBlock, topicNames } from './help-topics.js';
+const DEFAULT_CONFIG_NAME = 'any-nav.toml';
+// src/ and dist/ sit one level below the package root, so this resolves in
+// dev, packed, and installed forms alike.
+const { version: VERSION } = createRequire(import.meta.url)('../package.json');
+function nonNegativeInt(value) {
+    const n = Number.parseInt(value, 10);
+    if (!Number.isInteger(n) || n < 0) {
+        throw new InvalidArgumentError('must be a non-negative integer');
+    }
+    return n;
+}
+/**
+ * Marker-key sanitizer — the same rule core's formats apply to source
+ * paths (fileSafeName), applied here to the listed folder's
+ * config-root-relative path so one target file can carry one idempotent
+ * section per folder ('' — the config root itself — reads as 'root').
+ */
+function markerKey(relPosix) {
+    return relPosix.replace(/[^a-zA-Z0-9-]+/g, '-').replace(/^-+|-+$/g, '') || 'root';
+}
+function emit(io, text) {
+    io.stdout.write(text.trimEnd() + '\n');
+}
+function emitDiagnostics(io, diagnostics, suppressWarnings) {
+    // no-description rides its own row as an inline marker (terminalLines);
+    // every other code keeps one stderr line each.
+    for (const diagnostic of diagnostics) {
+        if (diagnostic.code === 'no-description')
+            continue;
+        if (suppressWarnings && diagnostic.severity === 'warning')
+            continue;
+        io.stderr.write(`${diagnostic.severity}: [${diagnostic.code}] ${diagnostic.message}\n`);
+    }
+}
+export async function run(argv, io = process) {
+    let result = 0;
+    const program = new Command();
+    program
+        .name('any-nav')
+        .description('Agent navigation for any Markdown folder — query the live tree.')
+        // Long-only version flag: -v/-V stay unassigned (clig.dev route)
+        .version(VERSION, '--version', 'output the version number')
+        .exitOverride()
+        // Reference content rides the help subsystem as non-command
+        // topics (gh's HELP TOPICS expression; roster in help-topics.ts). The
+        // help command is ours, not commander's builtin: pseudo-topic dispatch
+        // needs one place that knows commands, topics, and itself (gh's
+        // 'gh help help' renders the help command's own help; the builtin
+        // cannot target itself).
+        .helpCommand(false)
+        .addHelpText('after', renderHelpTopicsBlock())
+        .configureOutput({
+        writeOut: (s) => io.stdout.write(s),
+        writeErr: (s) => io.stderr.write(s),
+    });
+    const withConfig = (cmd) => cmd.option('-c, --config <path>', 'pin a specific any-nav.toml (paths outside its root then error)');
+    program
+        .command('init')
+        .description('seed a comment-only any-nav.toml — the home for exceptions; list itself runs without one')
+        .option('-c, --config <path>', 'config path to write (default: any-nav.toml in the current directory)')
+        .action(async (opts) => {
+        result = await cmdInit(opts, io);
+    });
+    withConfig(program
+        .command('list')
+        .description('list a folder as path | description rows (default: the current directory)')
+        .argument('[path]', 'folder to list, any directory (default: the current directory)')
+        .option('--depth <n>', 'expand this many levels below the listed folder, ignoring the local list', nonNegativeInt)
+        .option('--no-warnings', 'hide [no-description] row markers and warning diagnostics')
+        .option('--write <file>', 'write the markdown rendering of the same view into <file> as an idempotent marked section')
+        .addOption(
+    // JSON and the write artifact are two packagings of one projection;
+    // asking for both is a usage error, not a precedence call.
+    new Option('--json', 'print the same view as machine-readable JSON (stdout stays pure JSON)').conflicts('write'))
+        .addHelpText('after', '\nRows are the interactive format; every row\'s path is relative to the\nfolder you listed. Rows print as "path | description"; folders at the\nboundary print as "[N below] path", with " | description" too when the\nfolder carries one — its package.json description, its manifest.yml, or\nits README (N = the folder\'s recursive .md count); a file\'s description is its own —\nfrontmatter \'description:\' or its first substantive line; a row with no\ndescription prints a trailing "  [no-description]" marker instead — off\nwith --no-warnings, and --write output never carries it. Folders on the listed folder\'s\nown local list expand by default — their children print inline and the\nfolder row itself is absorbed; deep entries need no ancestor chain —\nfolders between are transparent corridors whose own rows are omitted,\nand when that omits anything a leading \"# curated\" note says so (every\nfolder still lists by path); --depth overrides. --json prints the same\nprojection as JSON instead of rows — the machine-readable face: stdout is\npure JSON (maintainer-class diagnostics still go to stderr); entries are\nthe view\'s nodes (path, kind, description when present — absent means\nnone; truncated folders carry their exact recursive .md count), and the\nenvelope carries root, depth, routeCount, and truncation facts; row\ntext, markdown, and tool content are not part of it, so declared\ncommands are not executed. A toml\'s top-level\ncommands (tool declarations, e.g. \"mytool instructions\") render their\noutput into the listing ahead of the files — any-nav runs them\ncapture-only (10s timeout, 10,000-char cap); an unavailable tool becomes\na one-line skip note; ANY_NAV_NO_TOOLS=1 skips execution. Strict\nlocality — scan,\nexpansion, budget, and entry commands all belong to the listed folder alone: only its own\nany-nav.toml curates its view and an ancestor\'s never applies; a folder\nwith no toml of its own lists under pure defaults (built-in excludes +\n.gitignore), and nesting tomls is how curation follows directories.\nExcluded names bound the excluding view only — the folder itself stays\nlistable by path (exclusion is not access control). Listings\npast 100 rows are cut with a trailing note, never silently; a --write\nsection that would exceed the budget collapses expanded branches\nfirst, then trims lines, with a note in the section. --write <file>\nsplices the markdown rendering — preamble + tree, self-describing for a\nlife outside the terminal — between any-nav markers; reruns replace only\nthat section, and it requires an any-nav.toml (the section key anchors\nto its root).\n')).action(async (path, opts) => {
+        result = await cmdList(path, opts, io);
+    });
+    // search is unexposed (framework decision 9, owner ruling 2026-10-06:
+    // retrieval belongs to the host's tools; the core kernel stays for a
+    // future correct pattern). generate retired into list --write; retired
+    // commands exit 2 like guide/read.
+    const helpCmd = program
+        .command('help')
+        .description('display help for a command or topic')
+        .argument('[target]', 'a command name or a help topic')
+        // gh ignores trailing args after a help target ('gh help <topic> extra')
+        .allowExcessArguments(true);
+    helpCmd.action((target) => {
+        if (target === undefined) {
+            program.help(); // bare 'help' = program help (stdout, exit 0 via catch)
+            return;
+        }
+        const topic = renderHelpTopic(target);
+        if (topic !== null) {
+            emit(io, topic); // trailing extra args ignored (gh behaves the same)
+            return;
+        }
+        const command = program.commands.find((c) => c.name() === target);
+        if (command !== undefined) {
+            command.help(); // HelpRequestError → exit 0 via the catch below
+            return;
+        }
+        const knownCommands = program.commands.map((c) => c.name());
+        io.stderr.write(`error: unknown help target '${target}'. Commands: ${knownCommands.join(', ')}; ` +
+            `topics: ${topicNames().join(', ')}; run 'any-nav help' to see both.\n`);
+        result = 2;
+    });
+    try {
+        await program.parseAsync(argv, { from: 'user' });
+        return result;
+    }
+    catch (err) {
+        if (err instanceof CommanderError) {
+            // Typed routing: commander declares its own exit intent —
+            // help/version carry exitCode 0 (including the builtin `help` command,
+            // code 'commander.help'); usage errors carry 1 and are remapped to 2.
+            return err.exitCode === 0 ? 0 : 2;
+        }
+        io.stderr.write(`${err.message}\n`);
+        return 1;
+    }
+}
+async function cmdInit(opts, io) {
+    // init owns its -c flag: it names the write target, not a discovery override.
+    const configPath = resolve(opts.config ?? join(process.cwd(), DEFAULT_CONFIG_NAME));
+    if (existsSync(configPath)) {
+        io.stderr.write(`any-nav: ${configPath} already exists — edit it, or pass --config <path> to write elsewhere; ` +
+            `schema: 'any-nav help config'\n`);
+        return 1;
+    }
+    // Minimal config + pointer line — the template is a
+    // config, not a documentation carrier; the schema lives in 'help config'.
+    // A comment-only file is a complete config: the opt-in and the boundary.
+    const text = `# full schema: any-nav help config\n` +
+        `# list runs without this file (pure defaults); it exists to state exceptions —\n` +
+        `# [scan] excludes, local default-expansion, budget, commands entry-declarations.\n` +
+        `# Comment-only is complete.\n`;
+    await mkdir(dirname(configPath), { recursive: true });
+    await writeFile(configPath, text, 'utf8');
+    io.stdout.write(`${configPath} created (comment-only — the home for exceptions)\n`);
+    io.stdout.write(`next: 'any-nav list' — the navigation is queryable right away\n`);
+    io.stdout.write(`then: 'any-nav help telling-agents' — the two-line entry for AGENTS.md\n`);
+    io.stdout.write(`schema: 'any-nav help config'\n`);
+    return 0;
+}
+const execAsync = promisify(exec);
+// Execution fuses: a tool that hangs or
+// floods must not hang or flood the listing — timeout, char cap, and a
+// pointer past a head instead of a mid-body truncation.
+const TOOL_TIMEOUT_MS = 10_000;
+const TOOL_MAX_CHARS = 10_000;
+const TOOL_HEAD_CHARS = 2_000;
+// Trust gate: opt-out switch — set to skip tool
+// execution entirely and render the declaration rows instead. The gate
+// lives here (adapter layer); core never reads the environment.
+const NO_TOOLS_ENV = 'ANY_NAV_NO_TOOLS';
+/**
+ * The CLI's CommandRunner (full-render ruling, 2026-10-16): runs each
+ * declared command through the shell in the governing toml's directory,
+ * capture-only — stdout becomes nav content, a failure becomes the
+ * one-line skip note (the reason rides stderr, never the payload).
+ */
+async function shellCommandRunner(command, ctx) {
+    try {
+        const { stdout } = await execAsync(command, {
+            cwd: ctx.cwd,
+            timeout: TOOL_TIMEOUT_MS,
+            maxBuffer: TOOL_MAX_CHARS * 4,
+            windowsHide: true,
+            encoding: 'utf8',
+        });
+        const text = stdout.trim();
+        return {
+            ok: true,
+            stdout: text.length > TOOL_MAX_CHARS
+                ? `${text.slice(0, TOOL_HEAD_CHARS)}\n[capped at ${TOOL_HEAD_CHARS} of ${text.length} chars — run the command for the full output]`
+                : text,
+        };
+    }
+    catch (err) {
+        // The tool's own stderr first line says why better than Node's wrapper.
+        const e = err;
+        return { ok: false, reason: (e.stderr ?? e.message).split('\n')[0]?.trim() || 'failed' };
+    }
+}
+/**
+ * Terminal payload: the row rendering with the breadth-guard note appended.
+ * Rows are THE interactive format regardless of governance (packaging axis:
+ * write, not toml, decides the markdown envelope). Tool blocks declared by
+ * the governing toml frame here in the presentation layer from ToolSection
+ * data — view.lines keeps its pure row contract. A
+ * leading corridor note rides the payload when the curated view actually omitted
+ * content — reader knowledge, not a warning, so --no-warnings never hides
+ * it (the sentence is canonical in core; only the '# ' sigil is ours).
+ */
+function terminalLines(listed, noDescription) {
+    const lines = [
+        // Ruling 10: framed blocks come from ToolSection data here in the
+        // presentation layer — view.lines stays pure `path | description`.
+        ...(listed.tools ?? []).flatMap((section) => [...toolBlockLines(section), '']),
+        ...(listed.view.omittedByCuration !== undefined ? [`# ${CURATED_OMISSION_CLAUSE}`] : []),
+    ];
+    // A description-less file's row is exactly its path (no " | " half), so
+    // exact-line membership marks it without touching described rows.
+    lines.push(...listed.view.lines.map((line) => noDescription.has(line) ? `${line}  [no-description]` : line));
+    if (listed.view.rowsTruncated !== undefined) {
+        lines.push(`(listing truncated at ${listed.view.rowsTruncated.shown} rows, ${listed.view.rowsTruncated.omitted} omitted — narrow the path, search the folder yourself, or split the folder / nest an any-nav.toml)`);
+    }
+    return lines.length === 0 ? '(empty)' : lines.join('\n');
+}
+async function cmdList(path, opts, io) {
+    // Governance is the listed folder's business (2026-10-07 optionality
+    // ruling): nearest toml at or above it, pure defaults when none — cwd
+    // never participates. --config pins a specific config instead.
+    let listed;
+    try {
+        // Ruling 12: the opt-out gate decides at injection — a gated run
+        // renders the declaration rows (the no-runner fallback), never executes.
+        const toolsGated = ['1', 'true'].includes((process.env[NO_TOOLS_ENV] ?? '').toLowerCase());
+        // The JSON face v1 carries no tool content: declared commands neither
+        // run (no side-effectful spawns for output this face drops) nor
+        // re-express — the no-runner fallback rides `lines` only, which the
+        // JSON face does not serialize.
+        listed = await listFolder(resolve(process.cwd(), path ?? '.'), {
+            configPath: opts.config,
+            depth: opts.depth,
+            commandRunner: toolsGated || opts.json === true ? undefined : shellCommandRunner,
+        });
+    }
+    catch (err) {
+        if (err instanceof ConfigError) {
+            // E2 shape: core names the file; the CLI names the action + schema.
+            throw new Error(`any-nav: ${err.message}; fix the config or create one with 'any-nav init'; schema: 'any-nav help config'`);
+        }
+        // SG-4/5 family: prefix + recovery pointer on runtime errors.
+        throw new Error(`any-nav: ${err.message}; run 'any-nav list --help' for usage`);
+    }
+    // Warning switch (--no-warnings): hides row markers and warning-severity
+    // stderr lines. Interactive listing defaults to markers ON; --write never
+    // marks rows — a materialized section must not carry transient tree state.
+    const suppressWarnings = opts.warnings === false;
+    if (opts.json === true) {
+        // Audience triage (payload discipline): the payload carries
+        // consumer-class diagnostics — core's serialization filters them in —
+        // while maintainer diagnostics keep the stderr side-channel, so stdout
+        // stays pure JSON. `no-description` stays structural here (description
+        // absent means none); emitDiagnostics skips it as on rows.
+        const maintainer = listed.diagnostics.filter((diagnostic) => diagnostic.audience === 'maintainer' && diagnostic.face !== 'write');
+        emitDiagnostics(io, maintainer, suppressWarnings);
+        io.stdout.write(routingViewJson(listed.view) + '\n');
+        return 0;
+    }
+    // Packaging triage: write-artifact diagnostics (face 'write') report only
+    // where that artifact is produced — the --write flow. The rows answer is
+    // never touched by the budget guard, so a plain listing never hears about
+    // a section it did not ask for.
+    const surfaced = opts.write === undefined
+        ? listed.diagnostics.filter((diagnostic) => diagnostic.face !== 'write')
+        : listed.diagnostics;
+    emitDiagnostics(io, surfaced, suppressWarnings);
+    // Unavailable tools: the payload carries the canonical skip line; the
+    // reason (why it failed) is maintainer-side debugging — stderr, hideable.
+    if (!suppressWarnings) {
+        for (const section of listed.tools ?? []) {
+            if (section.output === undefined) {
+                io.stderr.write(`any-nav: tool '${section.command}' unavailable (${section.unavailableReason ?? 'no reason'})` + '\n');
+            }
+        }
+    }
+    if (opts.write === undefined) {
+        const noDescription = suppressWarnings
+            ? new Set()
+            : new Set(listed.diagnostics
+                .filter((diagnostic) => diagnostic.code === 'no-description')
+                .map((diagnostic) => diagnostic.path)
+                .filter((path) => path !== undefined));
+        emit(io, terminalLines(listed, noDescription));
+        return 0;
+    }
+    // Write form (generate's successor): the markdown rendering — preamble +
+    // tree, self-describing for a life outside the terminal — becomes a marked
+    // section in the user-named target (any path: writes are user-directed
+    // while only scanning is boundary-guarded). Markers key by the listed
+    // folder relative to the config root, so each folder owns its own
+    // idempotent section per target file — which is why the write axis keeps
+    // the toml anchor (optionality ruling, ruling 4).
+    if (listed.governingConfig === null) {
+        throw new Error(`any-nav: list --write needs an any-nav.toml to anchor the section key; ` +
+            `create one with 'any-nav init' (comment-only is enough) or pass --config <path>`);
+    }
+    const configRoot = dirname(resolve(listed.governingConfig));
+    const relPosix = relative(configRoot, listed.root).split('\\').join('/');
+    const markers = defaultMarkers(`list:${markerKey(relPosix)}`);
+    const fragment = { formatId: 'list', text: listed.markdown, targets: [], markers };
+    const target = resolve(process.cwd(), opts.write);
+    try {
+        const existing = await readFile(target, 'utf8').catch(() => null);
+        const next = materialize(existing ?? '', fragment, markers);
+        await mkdir(dirname(target), { recursive: true });
+        await writeFile(target, next, 'utf8');
+    }
+    catch (err) {
+        // SG-4/5 family: prefix + recovery pointer on runtime write errors too.
+        throw new Error(`any-nav: cannot write ${opts.write}: ${err.message}; run 'any-nav list --help' for usage`);
+    }
+    // Write mode: stdout carries only the report line — the payload's one
+    // home is the file; re-printing it would split the data face.
+    io.stdout.write(`wrote ${opts.write} (markdown, ~${estimateTokens(listed.markdown)} tokens)\n`);
+    return 0;
+}
+//# 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/help-topics/config.d.ts

@@ -0,0 +1,10 @@
+/**
+ * help topic text — config: the one-time setup knowledge for any-nav.toml.
+ * The schema's canonical home is @any-nav/core parseConfig (core/src/config.ts);
+ * this copy restates it and is kept from drifting by guards (example blocks
+ * must parse, every accepted key must appear). Four keys total: scan bounds,
+ * local curates, budget guards, commands declares. Burden rules keep the
+ * page light.
+ */
+declare const _default = "any-nav config \u2014 the any-nav.toml schema\n\nThe complete key set with defaults. The file states only exceptions: an\nabsent key means automatic behavior, and unknown keys are rejected.\nEvery key serves its own file's folder view \u2014 strict locality: a\nfolder's own toml curates its view, an ancestor's never applies, and a\nfolder with no toml of its own lists under pure defaults (built-in\nexcludes + .gitignore).\n\nTop-level keys:\n  local    optional array \u2014 folders whose rows expand by default\n           (config-relative paths)\n  budget   optional table \u2014 write-face token guard\n  scan     optional table \u2014 traversal boundary policy\n  commands optional array \u2014 tool declarations, e.g. \"mytool\n           instructions\": output renders into the listing ahead of\n           the files (capture-only; 10s timeout; 10,000-char cap; skip\n           note if unavailable; ANY_NAV_NO_TOOLS=1 gates execution).\n\nlocal (default: no expansion \u2014 depth-0 everywhere):\n  Plain folder paths relative to the config file, no globs. A listed\n  folder's row expands inline; a deep entry needs no ancestor chain \u2014\n  folders between are transparent corridors whose own rows are omitted\n  (a leading note line says so when that omits anything, and every\n  folder still lists by path). Membership says expansion, not\n  existence. 'any-nav list <folder> --depth N' overrides the list for\n  one query (the escape hatch).\n\n[budget]:\n  share             optional, number    fraction of the assumed 100,000-token\n                                        context window the fragment may\n                                        occupy (default 0.02; 0 < share <= 1)\n  maxTokens         optional, integer   hard cap in estimated tokens\n                                        (default: none \u2014 share rules; share\n                                        0.02 of 100,000 = 2000 tokens)\n\nThe budget guards the write face: an over-budget section collapses\nexpanded branches first, then trims lines \u2014 always with a note in the\nsection, never a silent cut. The rows face is never collapsed by\nbudget; its own guard is the flat 100-row cut.\n\n[scan]:\n  The ignore you are looking for lives here: excludeDirs, excludeFiles,\n  excludeDotEntries. The rest \u2014 respectGitignore, boundaryExempt,\n  maxFiles \u2014 is traversal boundary policy, not more excludes.\n  excludeDirs       optional, strings   directory names skipped; appends\n                                        to the always-on floor (.git .hg .svn\n                                        node_modules .pnpm dist build lib out)\n                                        \u2014 never removes a default\n  excludeFiles      optional, strings   markdown file names additionally\n                                        excluded (case-insensitive);\n                                        appends to (AGENTS.md, CLAUDE.md)\n  excludeDotEntries optional, boolean   skip dot-prefixed names (default true)\n  respectGitignore  optional, boolean   respects .gitignore files (default true)\n  boundaryExempt    optional, strings   subtree patterns (gitignore-style,\n                                        view-root anchored, e.g. \"repo/\")\n                                        whose own nested .git no longer cuts\n                                        them; deeper embedded repos still cut\n  maxFiles          optional, integer   markdown files examined per source\n                                        walk (default 2000); past the cap\n                                        entries go unexamined with a\n                                        diagnostic \u2014 cut rows show \u2265N\n\nThe exclude names apply at any depth of this file's own view-walk.\nAn excluded folder stays listable by path, serving its own view.\n\nMinimal example (the whole file can be just comments):\n\n```toml\n# any-nav.toml \u2014 the home for exceptions: [scan] excludes, local\n# default-expansion, budget. list runs without it (pure defaults).\n```\n\nCurated example (the handbooks shelf expands inline; docs is a\ntransparent corridor \u2014 its other children stay off this view but list\nby path):\n\n```toml\nlocal = [\n  \"docs/handbooks\",\n]\n\ncommands = [\"mytool entry --kind standard\"]\n```\n\nKey boundaries:\n- '--config <path>' pins a specific toml (paths outside its root then\n  error). 'list --write' needs a toml and anchors to the nearest\n  any-nav.toml at or above the listed folder (the section key's config root).\n- The file is optional; comment-only is complete.\n- list prints `path | description` rows; descriptions are the files'\n  own \u2014 front-matter 'description:' or its first substantive line; a\n  folder row carries its package.json / manifest.yml description's, else its README's.\n- 'list --write <file>' wraps the same view as a self-describing\n  markdown section. The written target is ordinary navigable content \u2014\n  give it a front-matter 'description:' (or gitignore / excludeFiles\n  it) or it shows up as a bare row with a warning.\n- A key is only real if this page lists it.\n\nTelling agents about the navigation: 'any-nav help telling-agents'.\n";
+export default _default;

package/dist/help-topics/config.js

@@ -0,0 +1,110 @@
+/**
+ * help topic text — config: the one-time setup knowledge for any-nav.toml.
+ * The schema's canonical home is @any-nav/core parseConfig (core/src/config.ts);
+ * this copy restates it and is kept from drifting by guards (example blocks
+ * must parse, every accepted key must appear). Four keys total: scan bounds,
+ * local curates, budget guards, commands declares. Burden rules keep the
+ * page light.
+ */
+export default `any-nav config — the any-nav.toml schema
+
+The complete key set with defaults. The file states only exceptions: an
+absent key means automatic behavior, and unknown keys are rejected.
+Every key serves its own file's folder view — strict locality: a
+folder's own toml curates its view, an ancestor's never applies, and a
+folder with no toml of its own lists under pure defaults (built-in
+excludes + .gitignore).
+
+Top-level keys:
+  local    optional array — folders whose rows expand by default
+           (config-relative paths)
+  budget   optional table — write-face token guard
+  scan     optional table — traversal boundary policy
+  commands optional array — tool declarations, e.g. "mytool
+           instructions": output renders into the listing ahead of
+           the files (capture-only; 10s timeout; 10,000-char cap; skip
+           note if unavailable; ANY_NAV_NO_TOOLS=1 gates execution).
+
+local (default: no expansion — depth-0 everywhere):
+  Plain folder paths relative to the config file, no globs. A listed
+  folder's row expands inline; a deep entry needs no ancestor chain —
+  folders between are transparent corridors whose own rows are omitted
+  (a leading note line says so when that omits anything, and every
+  folder still lists by path). Membership says expansion, not
+  existence. 'any-nav list <folder> --depth N' overrides the list for
+  one query (the escape hatch).
+
+[budget]:
+  share             optional, number    fraction of the assumed 100,000-token
+                                        context window the fragment may
+                                        occupy (default 0.02; 0 < share <= 1)
+  maxTokens         optional, integer   hard cap in estimated tokens
+                                        (default: none — share rules; share
+                                        0.02 of 100,000 = 2000 tokens)
+
+The budget guards the write face: an over-budget section collapses
+expanded branches first, then trims lines — always with a note in the
+section, never a silent cut. The rows face is never collapsed by
+budget; its own guard is the flat 100-row cut.
+
+[scan]:
+  The ignore you are looking for lives here: excludeDirs, excludeFiles,
+  excludeDotEntries. The rest — respectGitignore, boundaryExempt,
+  maxFiles — is traversal boundary policy, not more excludes.
+  excludeDirs       optional, strings   directory names skipped; appends
+                                        to the always-on floor (.git .hg .svn
+                                        node_modules .pnpm dist build lib out)
+                                        — never removes a default
+  excludeFiles      optional, strings   markdown file names additionally
+                                        excluded (case-insensitive);
+                                        appends to (AGENTS.md, CLAUDE.md)
+  excludeDotEntries optional, boolean   skip dot-prefixed names (default true)
+  respectGitignore  optional, boolean   respects .gitignore files (default true)
+  boundaryExempt    optional, strings   subtree patterns (gitignore-style,
+                                        view-root anchored, e.g. "repo/")
+                                        whose own nested .git no longer cuts
+                                        them; deeper embedded repos still cut
+  maxFiles          optional, integer   markdown files examined per source
+                                        walk (default 2000); past the cap
+                                        entries go unexamined with a
+                                        diagnostic — cut rows show ≥N
+
+The exclude names apply at any depth of this file's own view-walk.
+An excluded folder stays listable by path, serving its own view.
+
+Minimal example (the whole file can be just comments):
+
+\`\`\`toml
+# any-nav.toml — the home for exceptions: [scan] excludes, local
+# default-expansion, budget. list runs without it (pure defaults).
+\`\`\`
+
+Curated example (the handbooks shelf expands inline; docs is a
+transparent corridor — its other children stay off this view but list
+by path):
+
+\`\`\`toml
+local = [
+  "docs/handbooks",
+]
+
+commands = ["mytool entry --kind standard"]
+\`\`\`
+
+Key boundaries:
+- '--config <path>' pins a specific toml (paths outside its root then
+  error). 'list --write' needs a toml and anchors to the nearest
+  any-nav.toml at or above the listed folder (the section key's config root).
+- The file is optional; comment-only is complete.
+- list prints \`path | description\` rows; descriptions are the files'
+  own — front-matter 'description:' or its first substantive line; a
+  folder row carries its package.json / manifest.yml description's, else its README's.
+- 'list --write <file>' wraps the same view as a self-describing
+  markdown section. The written target is ordinary navigable content —
+  give it a front-matter 'description:' (or gitignore / excludeFiles
+  it) or it shows up as a bare row with a warning.
+- A key is only real if this page lists it.
+
+Telling agents about the navigation: 'any-nav help telling-agents'.
+`;
+//# sourceMappingURL=config.js.map

package/dist/help-topics/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/help-topics/config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoGd,CAAC"}

package/dist/help-topics/telling-agents.d.ts

@@ -0,0 +1,13 @@
+/**
+ * help topic text — telling-agents: the context-file entry. The entry is
+ * two lines — a capability line + a one-shot procedural line: knowing the
+ * entry is not using it, so the entry itself schedules one pull per
+ * session, restoring what a hand-written navigation section used to
+ * guarantee. Two-line cap, derivation-free, never stale. The
+ * materialized section is not taught here: '--write' is a list flag and
+ * its teaching stays with 'any-nav help list' (an exception for
+ * consumers without command access, not day-one knowledge). Burden
+ * rules keep the page light.
+ */
+declare const _default = "any-nav telling-agents \u2014 the AGENTS.md entry\n\nFirst time? Put two lines in AGENTS.md:\n\n  This repo's Markdown is dynamically indexed (name + description)\n  by 'any-nav list <any-folder>' instead of a hand-written index.\n  Run 'any-nav list' once when you start working here \u2014 it replaces\n  the navigation this file would otherwise carry.\n\nHandwritten and derivation-free, so it never goes stale. If the\nlines are already there, you are done. The second line restores the\nguarantee a hand-written navigation section used to carry: the map\nis consumed once per session \u2014 pulled fresh instead of injected.\n\nThe rows are only as good as each file's own description: front-matter\n'description:' or the first substantive line (folders: their\npackage.json / manifest.yml description, else their README).\nDocs that matter deserve a real one \u2014 'any-nav help config' has the\nsourcing rules.\n\nNotes:\n- Keep the entry to the two lines. Agents get the rest from\n  any-nav --help themselves; anything longer only goes stale.\n- Default expansion, excludes, budget: 'any-nav help config'. No\n  config is needed to start.\n";
+export default _default;

package/dist/help-topics/telling-agents.js

@@ -0,0 +1,38 @@
+/**
+ * help topic text — telling-agents: the context-file entry. The entry is
+ * two lines — a capability line + a one-shot procedural line: knowing the
+ * entry is not using it, so the entry itself schedules one pull per
+ * session, restoring what a hand-written navigation section used to
+ * guarantee. Two-line cap, derivation-free, never stale. The
+ * materialized section is not taught here: '--write' is a list flag and
+ * its teaching stays with 'any-nav help list' (an exception for
+ * consumers without command access, not day-one knowledge). Burden
+ * rules keep the page light.
+ */
+export default `any-nav telling-agents — the AGENTS.md entry
+
+First time? Put two lines in AGENTS.md:
+
+  This repo's Markdown is dynamically indexed (name + description)
+  by 'any-nav list <any-folder>' instead of a hand-written index.
+  Run 'any-nav list' once when you start working here — it replaces
+  the navigation this file would otherwise carry.
+
+Handwritten and derivation-free, so it never goes stale. If the
+lines are already there, you are done. The second line restores the
+guarantee a hand-written navigation section used to carry: the map
+is consumed once per session — pulled fresh instead of injected.
+
+The rows are only as good as each file's own description: front-matter
+'description:' or the first substantive line (folders: their
+package.json / manifest.yml description, else their README).
+Docs that matter deserve a real one — 'any-nav help config' has the
+sourcing rules.
+
+Notes:
+- Keep the entry to the two lines. Agents get the rest from
+  any-nav --help themselves; anything longer only goes stale.
+- Default expansion, excludes, budget: 'any-nav help config'. No
+  config is needed to start.
+`;
+//# sourceMappingURL=telling-agents.js.map

package/dist/help-topics/telling-agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telling-agents.js","sourceRoot":"","sources":["../../src/help-topics/telling-agents.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;CAyBd,CAAC"}

package/dist/help-topics.d.ts

@@ -0,0 +1,5 @@
+export declare const HELP_TOPICS: ReadonlyArray<readonly [topic: string, summary: string]>;
+export declare const topicNames: () => string[];
+/** HELP TOPICS block appended to root help (gh's uppercase section form). */
+export declare function renderHelpTopicsBlock(): string;
+export declare function renderHelpTopic(topic: string): string | null;

package/dist/help-topics.js

@@ -0,0 +1,28 @@
+/**
+ * help topics — non-command reference pages rendered through the help
+ * subsystem (gh-anchored expression).
+ *
+ * A topic is not a command: `any-nav help config` and `any-nav help
+ * <command>` share one verb, `help` (no arguments) lists topics alongside
+ * commands, and unknown help targets list both. Topic texts are static
+ * string modules under help-topics/ (product documentation, not
+ * navigation-fact text). The config topic restates the schema parsed by
+ * @any-nav/core; guards keep that copy from drifting.
+ */
+import config from './help-topics/config.js';
+import tellingAgents from './help-topics/telling-agents.js';
+export const HELP_TOPICS = [
+    ['config', 'the complete any-nav.toml schema: keys, defaults, the local list'],
+    ['telling-agents', "first time? the two-line AGENTS.md entry — never goes stale"],
+];
+const TEXTS = { config, 'telling-agents': tellingAgents };
+export const topicNames = () => HELP_TOPICS.map(([topic]) => topic);
+/** HELP TOPICS block appended to root help (gh's uppercase section form). */
+export function renderHelpTopicsBlock() {
+    const rows = HELP_TOPICS.map(([topic, summary]) => `  ${topic}:  ${summary}`);
+    return `\nHELP TOPICS\n${rows.join('\n')}\n`;
+}
+export function renderHelpTopic(topic) {
+    return TEXTS[topic] ?? null;
+}
+//# sourceMappingURL=help-topics.js.map

package/dist/help-topics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help-topics.js","sourceRoot":"","sources":["../src/help-topics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,MAAM,MAAM,yBAAyB,CAAC;AAC7C,OAAO,aAAa,MAAM,iCAAiC,CAAC;AAE5D,MAAM,CAAC,MAAM,WAAW,GAA6D;IACnF,CAAC,QAAQ,EAAE,kEAAkE,CAAC;IAC9E,CAAC,gBAAgB,EAAE,6DAA6D,CAAC;CAClF,CAAC;AAEF,MAAM,KAAK,GAAqC,EAAE,MAAM,EAAE,gBAAgB,EAAE,aAAa,EAAE,CAAC;AAE5F,MAAM,CAAC,MAAM,UAAU,GAAG,GAAa,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC;AAE9E,6EAA6E;AAC7E,MAAM,UAAU,qBAAqB;IACnC,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,MAAM,OAAO,EAAE,CAAC,CAAC;IAC9E,OAAO,kBAAkB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC;AAC9B,CAAC"}

package/dist/main.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/main.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+// Thin shim: all behavior lives in cli.ts (run is the single family-rule point).
+import { run } from './cli.js';
+process.exitCode = await run(process.argv.slice(2));
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";AACA,iFAAiF;AACjF,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B,OAAO,CAAC,QAAQ,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,34 @@
 {
   "name": "@any-nav/cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.0",
+  "description": "Any-Nav CLI integration adapter (L0): discovers config, materializes generated navigation fragments into agent files (AGENTS.md and other registered formats). Owns all disk writes and exit codes.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/CatheadOwl/any-nav.git"
+  },
+  "type": "module",
+  "bin": {
+    "any-nav": "./dist/main.js"
+  },
+  "files": [
+    "dist",
+    "CHANGELOG.md"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": false
+  },
+  "dependencies": {
+    "@any-nav/core": "0.2.0",
+    "commander": "^15.0.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && node scripts/check-bin.mjs",
+    "typecheck": "tsc --noEmit",
+    "test": "node --test \"test/*.test.ts\"",
+    "pretest": "pnpm --filter @any-nav/core run build",
+    "pretypecheck": "pnpm --filter @any-nav/core run build",
+    "expose-skill": "node scripts/expose-skill.mjs"
+  }
 }