@any-nav/cli 0.0.0-stage → 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,17 @@
+# Changelog
+
+## 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,332 @@
+/**
+ * any-nav CLI — integration adapter A1 (L0). Surface design and every
+ * 【权衡】 ruling live in the project's ADR-0007 (cli-dev walkthrough);
+ * the unified list model (framework decision 9) 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 (ADR-0007 §3, clig.dev route)
+        .version(VERSION, '--version', 'output the version number')
+        .exitOverride()
+        // ADR-0016: 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 README or a _category_.yml/.yaml/.json sidecar\n(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. \"coggit 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 (ADR-0007 §7): 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;
+    }
+    // ADR-0016 option C: 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 (ADR-0018 ruling 13, CC-parity): 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 (ADR-0018 ruling 12): 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 (ADR-0018 ruling 10) — 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/guide-content/config.d.ts

@@ -0,0 +1,9 @@
+/**
+ * guide topic text — config (reference quadrant, Diataxis).
+ * The schema's canonical home is @any-nav/core parseConfig
+ * (core/src/config.ts); this copy restates it for humans and is kept
+ * from drifting by the SG-6/SG-7 guards (example blocks must parse,
+ * every accepted key and mode value must appear).
+ */
+declare const _default = "any-nav config \u2014 the any-nav.toml schema\n\nGoal: the complete key set with defaults. The file states only exceptions:\nan absent key means automatic behavior, and unknown keys are rejected\nwith an error.\n\nTop-level tables:\n  nav     required, non-empty array \u2014 one [[nav]] entry per source folder\n  budget  optional \u2014 token budget for auto mode sizing\n          ('any-nav guide modes')\n  scan    optional \u2014 traversal boundary policy\n\n[[nav]] entries:\n  path              required, string   folder to navigate, relative to the\n                                        config file location\n  mode              optional            auto | inject | drill | recall\n                                        (default auto \u2014 see 'any-nav guide\n                                        modes')\n  bind              optional, v2        push bindings \u2014 parsed, no effect\n                                        today\n\n[budget]:\n  share             optional, number    fraction of the assumed context\n                                        window (100,000 tokens) that\n                                        injected sections may occupy,\n                                        0 < share <= 1 (default 0.02)\n  maxTokens         optional, integer   hard cap in estimated tokens\n                                        (default: none \u2014 share rules)\n\n[scan]:\n  excludeDirs       optional, strings   directory names skipped in\n                                        traversal (default: .git, .hg, .svn,\n                                        node_modules, .pnpm, dist, build,\n                                        lib, out)\n  excludeFiles      optional, strings   markdown file names excluded,\n                                        case-insensitive\n                                        (default: AGENTS.md, CLAUDE.md)\n  excludeDotEntries optional, boolean   skip entries whose name starts\n                                        with '.' (default true)\n  respectGitignore  optional, boolean   traversal respects .gitignore\n                                        files (default true)\n  maxFiles          optional, integer   markdown files read per source\n                                        (default 2000); past the cap files are\n                                        skipped with a diagnostic, never silently\n\nMinimal example:\n\n```toml\n[[nav]]\npath = \"docs\"\n```\n\nFull example (every key, values illustrative):\n\n```toml\n[[nav]]\npath = \"docs\"\nmode = \"auto\"\n\n[[nav]]\npath = \"TODO\"\n\n[budget]\nshare = 0.1\nmaxTokens = 4000\n\n[scan]\nexcludeDirs = [\"node_modules\", \"dist\"]\nexcludeFiles = [\"AGENTS.md\"]\nexcludeDotEntries = true\nrespectGitignore = true\nmaxFiles = 500\n```\n\nKey boundaries:\n- Discovery: any-nav searches for any-nav.toml upward from the current\n  directory; '--config <path>' overrides.\n- Mode semantics (what auto picks, what an explicit mode freezes):\n  'any-nav guide modes'.\n- A key is only real if this page lists it; the example blocks above are\n  checked against the live parser by the test suite.\n\nRemember:\n- First config without writing one: 'any-nav init <path...>'.\n- Budget and chain semantics: 'any-nav guide modes'.\n";
+export default _default;

package/dist/guide-content/config.js

@@ -0,0 +1,94 @@
+/**
+ * guide topic text — config (reference quadrant, Diataxis).
+ * The schema's canonical home is @any-nav/core parseConfig
+ * (core/src/config.ts); this copy restates it for humans and is kept
+ * from drifting by the SG-6/SG-7 guards (example blocks must parse,
+ * every accepted key and mode value must appear).
+ */
+export default `any-nav config — the any-nav.toml schema
+
+Goal: the complete key set with defaults. The file states only exceptions:
+an absent key means automatic behavior, and unknown keys are rejected
+with an error.
+
+Top-level tables:
+  nav     required, non-empty array — one [[nav]] entry per source folder
+  budget  optional — token budget for auto mode sizing
+          ('any-nav guide modes')
+  scan    optional — traversal boundary policy
+
+[[nav]] entries:
+  path              required, string   folder to navigate, relative to the
+                                        config file location
+  mode              optional            auto | inject | drill | recall
+                                        (default auto — see 'any-nav guide
+                                        modes')
+  bind              optional, v2        push bindings — parsed, no effect
+                                        today
+
+[budget]:
+  share             optional, number    fraction of the assumed context
+                                        window (100,000 tokens) that
+                                        injected sections may occupy,
+                                        0 < share <= 1 (default 0.02)
+  maxTokens         optional, integer   hard cap in estimated tokens
+                                        (default: none — share rules)
+
+[scan]:
+  excludeDirs       optional, strings   directory names skipped in
+                                        traversal (default: .git, .hg, .svn,
+                                        node_modules, .pnpm, dist, build,
+                                        lib, out)
+  excludeFiles      optional, strings   markdown file names excluded,
+                                        case-insensitive
+                                        (default: AGENTS.md, CLAUDE.md)
+  excludeDotEntries optional, boolean   skip entries whose name starts
+                                        with '.' (default true)
+  respectGitignore  optional, boolean   traversal respects .gitignore
+                                        files (default true)
+  maxFiles          optional, integer   markdown files read per source
+                                        (default 2000); past the cap files are
+                                        skipped with a diagnostic, never silently
+
+Minimal example:
+
+\`\`\`toml
+[[nav]]
+path = "docs"
+\`\`\`
+
+Full example (every key, values illustrative):
+
+\`\`\`toml
+[[nav]]
+path = "docs"
+mode = "auto"
+
+[[nav]]
+path = "TODO"
+
+[budget]
+share = 0.1
+maxTokens = 4000
+
+[scan]
+excludeDirs = ["node_modules", "dist"]
+excludeFiles = ["AGENTS.md"]
+excludeDotEntries = true
+respectGitignore = true
+maxFiles = 500
+\`\`\`
+
+Key boundaries:
+- Discovery: any-nav searches for any-nav.toml upward from the current
+  directory; '--config <path>' overrides.
+- Mode semantics (what auto picks, what an explicit mode freezes):
+  'any-nav guide modes'.
+- A key is only real if this page lists it; the example blocks above are
+  checked against the live parser by the test suite.
+
+Remember:
+- First config without writing one: 'any-nav init <path...>'.
+- Budget and chain semantics: 'any-nav guide modes'.
+`;
+//# sourceMappingURL=config.js.map

package/dist/guide-content/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/guide-content/config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqFd,CAAC"}

package/dist/guide-content/modes.d.ts

@@ -0,0 +1,7 @@
+/**
+ * guide topic text — modes (explanation quadrant, Diataxis).
+ * Semantics restated from docs/specs/mode.md (the living spec); this copy
+ * teaches, the spec rules.
+ */
+declare const _default = "any-nav modes \u2014 exposure modes and the budget chain\n\nGoal: understand what any-nav injects and why a large source sometimes\ninjects less than the whole tree.\n\nThe chain (auto only):\n  inject-full   the whole navigation injected\n  inject-top    top level plus an \"omitted below\" pointer\n  recall        a stub pointing at search/read\nWith mode absent (auto), any-nav walks this chain and picks the cheapest\nform that fits the budget: [budget] share / maxTokens bound the estimated\ntokens the section may occupy.\n\nExplicit mode = hard constraint:\n  inject   full injection, never degraded for budget\n  drill    top level plus a drill-down pointer, never collapses to recall\n  recall   recall stub only, never upgrades because the source is small\nOver budget with an explicit mode, any-nav warns and ships the declared\nform anyway; the warning is expected, not a failure.\n\nDeclaration \u2194 chain form: inject = inject-full, drill = inject-top,\nrecall = recall. Declaring a mode freezes the auto chain at that form;\nthe chain-level names are what generate reports.\n\nKey boundaries:\n- Omission notices belong to auto only: an auto degradation explains\n  itself and how to recover (list / search). Explicit modes never degrade,\n  so they never explain omissions.\n- The budget bounds the injected map only. list / search / read always\n  answer over the full tree.\n\nRemember:\n- Modes are declared per source in any-nav.toml ('any-nav guide config').\n";
+export default _default;

package/dist/guide-content/modes.js

@@ -0,0 +1,40 @@
+/**
+ * guide topic text — modes (explanation quadrant, Diataxis).
+ * Semantics restated from docs/specs/mode.md (the living spec); this copy
+ * teaches, the spec rules.
+ */
+export default `any-nav modes — exposure modes and the budget chain
+
+Goal: understand what any-nav injects and why a large source sometimes
+injects less than the whole tree.
+
+The chain (auto only):
+  inject-full   the whole navigation injected
+  inject-top    top level plus an "omitted below" pointer
+  recall        a stub pointing at search/read
+With mode absent (auto), any-nav walks this chain and picks the cheapest
+form that fits the budget: [budget] share / maxTokens bound the estimated
+tokens the section may occupy.
+
+Explicit mode = hard constraint:
+  inject   full injection, never degraded for budget
+  drill    top level plus a drill-down pointer, never collapses to recall
+  recall   recall stub only, never upgrades because the source is small
+Over budget with an explicit mode, any-nav warns and ships the declared
+form anyway; the warning is expected, not a failure.
+
+Declaration ↔ chain form: inject = inject-full, drill = inject-top,
+recall = recall. Declaring a mode freezes the auto chain at that form;
+the chain-level names are what generate reports.
+
+Key boundaries:
+- Omission notices belong to auto only: an auto degradation explains
+  itself and how to recover (list / search). Explicit modes never degrade,
+  so they never explain omissions.
+- The budget bounds the injected map only. list / search / read always
+  answer over the full tree.
+
+Remember:
+- Modes are declared per source in any-nav.toml ('any-nav guide config').
+`;
+//# sourceMappingURL=modes.js.map

package/dist/guide-content/modes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"modes.js","sourceRoot":"","sources":["../../src/guide-content/modes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiCd,CAAC"}

package/dist/guide-content/quickstart.d.ts

@@ -0,0 +1,7 @@
+/**
+ * guide topic text — quickstart (tutorial quadrant, Diataxis).
+ * Teaching home per ADR-0013: this is product documentation, not
+ * navigation-fact text, so it lives in the CLI package as static copy.
+ */
+declare const _default = "any-nav quickstart \u2014 first navigation from any Markdown folder\n\nGoal: point any-nav at Markdown folders and get a generated navigation\nsection that agents can list, search, and read.\n\nFast path:\n1. Create the config\n   any-nav init docs\n   Writes any-nav.toml with one [[nav]] entry per path. Already have a\n   config? Skip this step. Full schema: 'any-nav guide config'.\n\n2. Generate the navigation section\n   any-nav generate\n   Scans the configured sources and writes a marked section between\n   '<!-- any-nav:...:begin -->' and '<!-- any-nav:...:end -->' markers in\n   each target file (default format generic-markdown: any-nav/<source>.md;\n   --format agents-md writes into AGENTS.md).\n\n3. Use it\n   any-nav list                            top-level map of the first source\n   any-nav list --source docs --depth 1    drill one level\n   any-nav search <keywords>               no result is not an error\n                                           (exit 0)\n   any-nav read <locator>                  locator = path relative to a\n                                           source root, e.g. sub/deploy.md\n\nKey boundaries:\n- Map, not territory: marked sections are generated. Never hand-edit\n  between the markers \u2014 edit the source documents and regenerate.\n- Only exceptions go in the config; absent keys fall back to defaults.\n- After adding or renaming documents, rerun 'any-nav generate'.\n\nRemember:\n- 'any-nav guide config' for the complete any-nav.toml schema.\n- 'any-nav guide workflow' for the edit-regenerate loop.\n- 'any-nav guide modes' when a section comes out smaller than the folder.\n";
+export default _default;

package/dist/guide-content/quickstart.js

@@ -0,0 +1,43 @@
+/**
+ * guide topic text — quickstart (tutorial quadrant, Diataxis).
+ * Teaching home per ADR-0013: this is product documentation, not
+ * navigation-fact text, so it lives in the CLI package as static copy.
+ */
+export default `any-nav quickstart — first navigation from any Markdown folder
+
+Goal: point any-nav at Markdown folders and get a generated navigation
+section that agents can list, search, and read.
+
+Fast path:
+1. Create the config
+   any-nav init docs
+   Writes any-nav.toml with one [[nav]] entry per path. Already have a
+   config? Skip this step. Full schema: 'any-nav guide config'.
+
+2. Generate the navigation section
+   any-nav generate
+   Scans the configured sources and writes a marked section between
+   '<!-- any-nav:...:begin -->' and '<!-- any-nav:...:end -->' markers in
+   each target file (default format generic-markdown: any-nav/<source>.md;
+   --format agents-md writes into AGENTS.md).
+
+3. Use it
+   any-nav list                            top-level map of the first source
+   any-nav list --source docs --depth 1    drill one level
+   any-nav search <keywords>               no result is not an error
+                                           (exit 0)
+   any-nav read <locator>                  locator = path relative to a
+                                           source root, e.g. sub/deploy.md
+
+Key boundaries:
+- Map, not territory: marked sections are generated. Never hand-edit
+  between the markers — edit the source documents and regenerate.
+- Only exceptions go in the config; absent keys fall back to defaults.
+- After adding or renaming documents, rerun 'any-nav generate'.
+
+Remember:
+- 'any-nav guide config' for the complete any-nav.toml schema.
+- 'any-nav guide workflow' for the edit-regenerate loop.
+- 'any-nav guide modes' when a section comes out smaller than the folder.
+`;
+//# sourceMappingURL=quickstart.js.map

package/dist/guide-content/quickstart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quickstart.js","sourceRoot":"","sources":["../../src/guide-content/quickstart.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoCd,CAAC"}

package/dist/guide-content/workflow.d.ts

@@ -0,0 +1,5 @@
+/**
+ * guide topic text — workflow (how-to quadrant, Diataxis).
+ */
+declare const _default = "any-nav workflow \u2014 the edit-regenerate loop\n\nGoal: keep the generated navigation in step with the documents it maps.\n\nHow-to:\n1. Add or rename documents in a configured source\n   Just edit files. Nothing registers \u2014 the scan discovers Markdown by\n   traversal under the [scan] policy ('any-nav guide config').\n\n2. Regenerate\n   any-nav generate                    rewrite marked sections in place\n   any-nav generate -n                 dry-run: report targets and sizes only\n   any-nav generate --format agents-md write into AGENTS.md\n\n3. Add or remove a source folder\n   Edit the [[nav]] entries in any-nav.toml (or run 'any-nav init' where no\n   config exists yet), then regenerate.\n\n4. Check what the consumer sees\n   any-nav list [--source <path>] [--prefix <sub>] [--depth n]\n   any-nav search <keywords>\n   any-nav read <locator>\n\nKey boundaries:\n- Marked sections are generated: everything between\n  '<!-- any-nav:...:begin -->' and '<!-- any-nav:...:end -->' is rewritten\n  by the next generate. Hand edits there are lost by design.\n- Descriptions come from each file's front matter 'description:'; files\n  without one render as Undocumented placeholders and warn on generate.\n- Generate is idempotent: rerunning without document changes rewrites\n  identical content.\n\nRemember:\n- 'any-nav guide quickstart' for the first-run path.\n- 'any-nav guide modes' when a section comes out smaller than expected.\n";
+export default _default;

package/dist/guide-content/workflow.js

@@ -0,0 +1,40 @@
+/**
+ * guide topic text — workflow (how-to quadrant, Diataxis).
+ */
+export default `any-nav workflow — the edit-regenerate loop
+
+Goal: keep the generated navigation in step with the documents it maps.
+
+How-to:
+1. Add or rename documents in a configured source
+   Just edit files. Nothing registers — the scan discovers Markdown by
+   traversal under the [scan] policy ('any-nav guide config').
+
+2. Regenerate
+   any-nav generate                    rewrite marked sections in place
+   any-nav generate -n                 dry-run: report targets and sizes only
+   any-nav generate --format agents-md write into AGENTS.md
+
+3. Add or remove a source folder
+   Edit the [[nav]] entries in any-nav.toml (or run 'any-nav init' where no
+   config exists yet), then regenerate.
+
+4. Check what the consumer sees
+   any-nav list [--source <path>] [--prefix <sub>] [--depth n]
+   any-nav search <keywords>
+   any-nav read <locator>
+
+Key boundaries:
+- Marked sections are generated: everything between
+  '<!-- any-nav:...:begin -->' and '<!-- any-nav:...:end -->' is rewritten
+  by the next generate. Hand edits there are lost by design.
+- Descriptions come from each file's front matter 'description:'; files
+  without one render as Undocumented placeholders and warn on generate.
+- Generate is idempotent: rerunning without document changes rewrites
+  identical content.
+
+Remember:
+- 'any-nav guide quickstart' for the first-run path.
+- 'any-nav guide modes' when a section comes out smaller than expected.
+`;
+//# sourceMappingURL=workflow.js.map

package/dist/guide-content/workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.js","sourceRoot":"","sources":["../../src/guide-content/workflow.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmCd,CAAC"}

package/dist/guide.d.ts

@@ -0,0 +1,4 @@
+export declare const GUIDE_TOPICS: ReadonlyArray<readonly [topic: string, summary: string]>;
+export declare const topicNames: () => string[];
+export declare function renderGuideList(): string;
+export declare function renderGuide(topic: string): string | null;

package/dist/guide.js

@@ -0,0 +1,30 @@
+/**
+ * guide — the in-CLI teaching home (ADR-0013).
+ *
+ * Topic texts are static string modules under guide-content/ (product
+ * documentation, not navigation-fact text, so they live in the CLI package
+ * rather than core). GUIDE_TOPICS is the single source of the roster: the
+ * topic list, guide's own help, and the root-help "Start here" line all
+ * render from it. The config topic restates the schema parsed by
+ * @any-nav/core; the SG-6/SG-7 guards keep that copy from drifting.
+ */
+import quickstart from './guide-content/quickstart.js';
+import config from './guide-content/config.js';
+import workflow from './guide-content/workflow.js';
+import modes from './guide-content/modes.js';
+export const GUIDE_TOPICS = [
+    ['quickstart', 'first run: init a config, generate the navigation section, use list/search/read'],
+    ['config', 'the complete any-nav.toml schema with defaults; absent keys mean automatic'],
+    ['workflow', 'the edit-regenerate loop: sources, markers, descriptions, idempotency'],
+    ['modes', 'exposure modes and the budget chain: auto degrades, explicit modes are hard constraints'],
+];
+const TEXTS = { quickstart, config, workflow, modes };
+export const topicNames = () => GUIDE_TOPICS.map(([topic]) => topic);
+export function renderGuideList() {
+    const rows = GUIDE_TOPICS.map(([topic, summary]) => `  ${topic.padEnd(12)} ${summary}`);
+    return ['Guides:', ...rows, '', `Run 'any-nav guide <topic>' to read one.`].join('\n');
+}
+export function renderGuide(topic) {
+    return TEXTS[topic] ?? null;
+}
+//# sourceMappingURL=guide.js.map

package/dist/guide.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guide.js","sourceRoot":"","sources":["../src/guide.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,UAAU,MAAM,+BAA+B,CAAC;AACvD,OAAO,MAAM,MAAM,2BAA2B,CAAC;AAC/C,OAAO,QAAQ,MAAM,6BAA6B,CAAC;AACnD,OAAO,KAAK,MAAM,0BAA0B,CAAC;AAE7C,MAAM,CAAC,MAAM,YAAY,GAA6D;IACpF,CAAC,YAAY,EAAE,iFAAiF,CAAC;IACjG,CAAC,QAAQ,EAAE,4EAA4E,CAAC;IACxF,CAAC,UAAU,EAAE,uEAAuE,CAAC;IACrF,CAAC,OAAO,EAAE,yFAAyF,CAAC;CACrG,CAAC;AAEF,MAAM,KAAK,GAAqC,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AAExF,MAAM,CAAC,MAAM,UAAU,GAAG,GAAa,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC;AAE/E,MAAM,UAAU,eAAe;IAC7B,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,OAAO,EAAE,CAAC,CAAC;IACxF,OAAO,CAAC,SAAS,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE,0CAA0C,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzF,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC;AAC9B,CAAC"}

package/dist/help-topics/config.d.ts

@@ -0,0 +1,11 @@
+/**
+ * help topic text — config: the one-time setup knowledge for any-nav.toml
+ * (ADR-0016). The schema's canonical home is @any-nav/core parseConfig
+ * (core/src/config.ts); this copy restates it and is kept from drifting by
+ * the SG-6/SG-7 guards (example blocks must parse, every accepted key must
+ * appear). Four keys total: scan bounds, local curates, budget guards,
+ * commands declares. Burden rules SB-1/SB-2 (specs/surface.md) keep the
+ * page light: SG-10.
+ */
+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. \"coggit\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\n                                        100,000-token context window\n                                        the fragment may occupy (default\n                                        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  excludeDirs       optional, strings   directory names additionally\n                                        skipped in traversal. Appends to\n                                        the always-on built-in list (.git,\n                                        .hg, .svn, node_modules, .pnpm,\n                                        dist, build, lib, out) \u2014 stating\n                                        the key never removes a default.\n  excludeFiles      optional, strings   markdown file names additionally\n                                        excluded, case-insensitive.\n                                        Appends to the built-in list\n                                        (AGENTS.md, CLAUDE.md).\n  excludeDotEntries optional, boolean   skip entries whose name starts\n                                        with '.' (default true)\n  respectGitignore  optional, boolean   traversal respects .gitignore\n                                        files (default true)\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 = [\"coggit 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\n  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 README's (or a `_category_` sidecar'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,111 @@
+/**
+ * help topic text — config: the one-time setup knowledge for any-nav.toml
+ * (ADR-0016). The schema's canonical home is @any-nav/core parseConfig
+ * (core/src/config.ts); this copy restates it and is kept from drifting by
+ * the SG-6/SG-7 guards (example blocks must parse, every accepted key must
+ * appear). Four keys total: scan bounds, local curates, budget guards,
+ * commands declares. Burden rules SB-1/SB-2 (specs/surface.md) keep the
+ * page light: SG-10.
+ */
+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. "coggit
+           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]:
+  excludeDirs       optional, strings   directory names additionally
+                                        skipped in traversal. Appends to
+                                        the always-on built-in list (.git,
+                                        .hg, .svn, node_modules, .pnpm,
+                                        dist, build, lib, out) — stating
+                                        the key never removes a default.
+  excludeFiles      optional, strings   markdown file names additionally
+                                        excluded, case-insensitive.
+                                        Appends to the built-in list
+                                        (AGENTS.md, CLAUDE.md).
+  excludeDotEntries optional, boolean   skip entries whose name starts
+                                        with '.' (default true)
+  respectGitignore  optional, boolean   traversal respects .gitignore
+                                        files (default true)
+  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 = ["coggit 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 README's (or a \`_category_\` sidecar'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;;;;;;;;GAQG;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 (2026-10-08;
+ * v2 2026-10-09: capability line + 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 — SB-3). 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 SB-1/SB-2 (specs/surface.md): SG-10.
+ */
+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 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,37 @@
+/**
+ * help topic text — telling-agents: the context-file entry (2026-10-08;
+ * v2 2026-10-09: capability line + 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 — SB-3). 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 SB-1/SB-2 (specs/surface.md): SG-10.
+ */
+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 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;;;;;;;;;;;;;;;;;;;;;;;;CAwBd,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 (ADR-0016, gh-anchored expression; see the gh-cli handbook).
+ *
+ * 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; SG-6/SG-7 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,28 @@
 {
   "name": "@any-nav/cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.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",
+  "type": "module",
+  "bin": {
+    "any-nav": "./dist/main.js"
+  },
+  "files": [
+    "dist",
+    "CHANGELOG.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@any-nav/core": "0.1.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"
+  }
 }