@any-nav/cli 0.1.0 → 0.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +16 -0
- package/dist/cli.js +10 -11
- package/dist/cli.js.map +1 -1
- package/dist/help-topics/config.d.ts +7 -8
- package/dist/help-topics/config.js +28 -29
- package/dist/help-topics/config.js.map +1 -1
- package/dist/help-topics/telling-agents.d.ts +5 -5
- package/dist/help-topics/telling-agents.js +7 -6
- package/dist/help-topics/telling-agents.js.map +1 -1
- package/dist/help-topics.js +2 -2
- package/package.json +10 -4
- package/dist/guide-content/config.d.ts +0 -9
- package/dist/guide-content/config.js +0 -94
- package/dist/guide-content/config.js.map +0 -1
- package/dist/guide-content/modes.d.ts +0 -7
- package/dist/guide-content/modes.js +0 -40
- package/dist/guide-content/modes.js.map +0 -1
- package/dist/guide-content/quickstart.d.ts +0 -7
- package/dist/guide-content/quickstart.js +0 -43
- package/dist/guide-content/quickstart.js.map +0 -1
- package/dist/guide-content/workflow.d.ts +0 -5
- package/dist/guide-content/workflow.js +0 -40
- package/dist/guide-content/workflow.js.map +0 -1
- package/dist/guide.d.ts +0 -4
- package/dist/guide.js +0 -30
- package/dist/guide.js.map +0 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,21 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 0.2.0 — 2026-10-31
|
|
4
|
+
|
|
5
|
+
- The `config` topic's `[scan]` section opens with the ignore mapping:
|
|
6
|
+
the excludes a reader looks for live here (`excludeDirs` /
|
|
7
|
+
`excludeFiles` / `excludeDotEntries`); the rest — `respectGitignore` /
|
|
8
|
+
`boundaryExempt` / `maxFiles` — is traversal-boundary policy, not
|
|
9
|
+
more excludes. Key names unchanged; the page keeps its 100-line cap
|
|
10
|
+
(three in-page reflows pay for the teaching sentences).
|
|
11
|
+
- The folder-row teaching follows the scan carrier swap: `list --help`,
|
|
12
|
+
the `config` topic, and the `telling-agents` topic now describe a
|
|
13
|
+
folder row as reading the directory's `package.json` /
|
|
14
|
+
`manifest.yml` description, else its README.
|
|
15
|
+
- Rides the lockstep train on the `@any-nav/core` 0.2.0 bump: lazy
|
|
16
|
+
fast-bm25 load, representative-README locators on folder rows, and the
|
|
17
|
+
scan 0.2.0 face flowing through the re-export.
|
|
18
|
+
|
|
3
19
|
## 0.1.0 — 2026-10-21
|
|
4
20
|
|
|
5
21
|
First registry release.
|
package/dist/cli.js
CHANGED
|
@@ -1,7 +1,6 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* any-nav CLI — integration adapter A1 (L0).
|
|
3
|
-
*
|
|
4
|
-
* the unified list model (framework decision 9) sets the roster: init /
|
|
2
|
+
* any-nav CLI — integration adapter A1 (L0). The unified list model sets
|
|
3
|
+
* the roster: init /
|
|
5
4
|
* list / help — generate retired into list's --write form, so the write
|
|
6
5
|
* is the very payload the listing prints, spliced between markers.
|
|
7
6
|
*
|
|
@@ -59,10 +58,10 @@ export async function run(argv, io = process) {
|
|
|
59
58
|
program
|
|
60
59
|
.name('any-nav')
|
|
61
60
|
.description('Agent navigation for any Markdown folder — query the live tree.')
|
|
62
|
-
// Long-only version flag: -v/-V stay unassigned (
|
|
61
|
+
// Long-only version flag: -v/-V stay unassigned (clig.dev route)
|
|
63
62
|
.version(VERSION, '--version', 'output the version number')
|
|
64
63
|
.exitOverride()
|
|
65
|
-
//
|
|
64
|
+
// Reference content rides the help subsystem as non-command
|
|
66
65
|
// topics (gh's HELP TOPICS expression; roster in help-topics.ts). The
|
|
67
66
|
// help command is ours, not commander's builtin: pseudo-topic dispatch
|
|
68
67
|
// needs one place that knows commands, topics, and itself (gh's
|
|
@@ -93,7 +92,7 @@ export async function run(argv, io = process) {
|
|
|
93
92
|
// JSON and the write artifact are two packagings of one projection;
|
|
94
93
|
// asking for both is a usage error, not a precedence call.
|
|
95
94
|
new Option('--json', 'print the same view as machine-readable JSON (stdout stays pure JSON)').conflicts('write'))
|
|
96
|
-
.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
|
|
95
|
+
.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) => {
|
|
97
96
|
result = await cmdList(path, opts, io);
|
|
98
97
|
});
|
|
99
98
|
// search is unexposed (framework decision 9, owner ruling 2026-10-06:
|
|
@@ -132,7 +131,7 @@ export async function run(argv, io = process) {
|
|
|
132
131
|
}
|
|
133
132
|
catch (err) {
|
|
134
133
|
if (err instanceof CommanderError) {
|
|
135
|
-
// Typed routing
|
|
134
|
+
// Typed routing: commander declares its own exit intent —
|
|
136
135
|
// help/version carry exitCode 0 (including the builtin `help` command,
|
|
137
136
|
// code 'commander.help'); usage errors carry 1 and are remapped to 2.
|
|
138
137
|
return err.exitCode === 0 ? 0 : 2;
|
|
@@ -149,7 +148,7 @@ async function cmdInit(opts, io) {
|
|
|
149
148
|
`schema: 'any-nav help config'\n`);
|
|
150
149
|
return 1;
|
|
151
150
|
}
|
|
152
|
-
//
|
|
151
|
+
// Minimal config + pointer line — the template is a
|
|
153
152
|
// config, not a documentation carrier; the schema lives in 'help config'.
|
|
154
153
|
// A comment-only file is a complete config: the opt-in and the boundary.
|
|
155
154
|
const text = `# full schema: any-nav help config\n` +
|
|
@@ -165,13 +164,13 @@ async function cmdInit(opts, io) {
|
|
|
165
164
|
return 0;
|
|
166
165
|
}
|
|
167
166
|
const execAsync = promisify(exec);
|
|
168
|
-
// Execution fuses
|
|
167
|
+
// Execution fuses: a tool that hangs or
|
|
169
168
|
// floods must not hang or flood the listing — timeout, char cap, and a
|
|
170
169
|
// pointer past a head instead of a mid-body truncation.
|
|
171
170
|
const TOOL_TIMEOUT_MS = 10_000;
|
|
172
171
|
const TOOL_MAX_CHARS = 10_000;
|
|
173
172
|
const TOOL_HEAD_CHARS = 2_000;
|
|
174
|
-
// Trust gate
|
|
173
|
+
// Trust gate: opt-out switch — set to skip tool
|
|
175
174
|
// execution entirely and render the declaration rows instead. The gate
|
|
176
175
|
// lives here (adapter layer); core never reads the environment.
|
|
177
176
|
const NO_TOOLS_ENV = 'ANY_NAV_NO_TOOLS';
|
|
@@ -209,7 +208,7 @@ async function shellCommandRunner(command, ctx) {
|
|
|
209
208
|
* Rows are THE interactive format regardless of governance (packaging axis:
|
|
210
209
|
* write, not toml, decides the markdown envelope). Tool blocks declared by
|
|
211
210
|
* the governing toml frame here in the presentation layer from ToolSection
|
|
212
|
-
* data
|
|
211
|
+
* data — view.lines keeps its pure row contract. A
|
|
213
212
|
* leading corridor note rides the payload when the curated view actually omitted
|
|
214
213
|
* content — reader knowledge, not a warning, so --no-warnings never hides
|
|
215
214
|
* it (the sentence is canonical in core; only the '# ' sigil is ours).
|
package/dist/cli.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,11 +1,10 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* help topic text — config: the one-time setup knowledge for any-nav.toml
|
|
3
|
-
*
|
|
4
|
-
*
|
|
5
|
-
*
|
|
6
|
-
*
|
|
7
|
-
*
|
|
8
|
-
* page light: SG-10.
|
|
2
|
+
* help topic text — config: the one-time setup knowledge for any-nav.toml.
|
|
3
|
+
* The schema's canonical home is @any-nav/core parseConfig (core/src/config.ts);
|
|
4
|
+
* this copy restates it and is kept from drifting by guards (example blocks
|
|
5
|
+
* must parse, every accepted key must appear). Four keys total: scan bounds,
|
|
6
|
+
* local curates, budget guards, commands declares. Burden rules keep the
|
|
7
|
+
* page light.
|
|
9
8
|
*/
|
|
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. \"
|
|
9
|
+
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";
|
|
11
10
|
export default _default;
|
|
@@ -1,11 +1,10 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* help topic text — config: the one-time setup knowledge for any-nav.toml
|
|
3
|
-
*
|
|
4
|
-
*
|
|
5
|
-
*
|
|
6
|
-
*
|
|
7
|
-
*
|
|
8
|
-
* page light: SG-10.
|
|
2
|
+
* help topic text — config: the one-time setup knowledge for any-nav.toml.
|
|
3
|
+
* The schema's canonical home is @any-nav/core parseConfig (core/src/config.ts);
|
|
4
|
+
* this copy restates it and is kept from drifting by guards (example blocks
|
|
5
|
+
* must parse, every accepted key must appear). Four keys total: scan bounds,
|
|
6
|
+
* local curates, budget guards, commands declares. Burden rules keep the
|
|
7
|
+
* page light.
|
|
9
8
|
*/
|
|
10
9
|
export default `any-nav config — the any-nav.toml schema
|
|
11
10
|
|
|
@@ -21,7 +20,7 @@ Top-level keys:
|
|
|
21
20
|
(config-relative paths)
|
|
22
21
|
budget optional table — write-face token guard
|
|
23
22
|
scan optional table — traversal boundary policy
|
|
24
|
-
commands optional array — tool declarations, e.g. "
|
|
23
|
+
commands optional array — tool declarations, e.g. "mytool
|
|
25
24
|
instructions": output renders into the listing ahead of
|
|
26
25
|
the files (capture-only; 10s timeout; 10,000-char cap; skip
|
|
27
26
|
note if unavailable; ANY_NAV_NO_TOOLS=1 gates execution).
|
|
@@ -36,10 +35,9 @@ local (default: no expansion — depth-0 everywhere):
|
|
|
36
35
|
one query (the escape hatch).
|
|
37
36
|
|
|
38
37
|
[budget]:
|
|
39
|
-
share optional, number fraction of the assumed
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
0.02; 0 < share <= 1)
|
|
38
|
+
share optional, number fraction of the assumed 100,000-token
|
|
39
|
+
context window the fragment may
|
|
40
|
+
occupy (default 0.02; 0 < share <= 1)
|
|
43
41
|
maxTokens optional, integer hard cap in estimated tokens
|
|
44
42
|
(default: none — share rules; share
|
|
45
43
|
0.02 of 100,000 = 2000 tokens)
|
|
@@ -50,20 +48,22 @@ section, never a silent cut. The rows face is never collapsed by
|
|
|
50
48
|
budget; its own guard is the flat 100-row cut.
|
|
51
49
|
|
|
52
50
|
[scan]:
|
|
53
|
-
excludeDirs
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
51
|
+
The ignore you are looking for lives here: excludeDirs, excludeFiles,
|
|
52
|
+
excludeDotEntries. The rest — respectGitignore, boundaryExempt,
|
|
53
|
+
maxFiles — is traversal boundary policy, not more excludes.
|
|
54
|
+
excludeDirs optional, strings directory names skipped; appends
|
|
55
|
+
to the always-on floor (.git .hg .svn
|
|
56
|
+
node_modules .pnpm dist build lib out)
|
|
57
|
+
— never removes a default
|
|
59
58
|
excludeFiles optional, strings markdown file names additionally
|
|
60
|
-
excluded
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
59
|
+
excluded (case-insensitive);
|
|
60
|
+
appends to (AGENTS.md, CLAUDE.md)
|
|
61
|
+
excludeDotEntries optional, boolean skip dot-prefixed names (default true)
|
|
62
|
+
respectGitignore optional, boolean respects .gitignore files (default true)
|
|
63
|
+
boundaryExempt optional, strings subtree patterns (gitignore-style,
|
|
64
|
+
view-root anchored, e.g. "repo/")
|
|
65
|
+
whose own nested .git no longer cuts
|
|
66
|
+
them; deeper embedded repos still cut
|
|
67
67
|
maxFiles optional, integer markdown files examined per source
|
|
68
68
|
walk (default 2000); past the cap
|
|
69
69
|
entries go unexamined with a
|
|
@@ -88,18 +88,17 @@ local = [
|
|
|
88
88
|
"docs/handbooks",
|
|
89
89
|
]
|
|
90
90
|
|
|
91
|
-
commands = ["
|
|
91
|
+
commands = ["mytool entry --kind standard"]
|
|
92
92
|
\`\`\`
|
|
93
93
|
|
|
94
94
|
Key boundaries:
|
|
95
95
|
- '--config <path>' pins a specific toml (paths outside its root then
|
|
96
96
|
error). 'list --write' needs a toml and anchors to the nearest
|
|
97
|
-
any-nav.toml at or above the listed folder (the section key's
|
|
98
|
-
config root).
|
|
97
|
+
any-nav.toml at or above the listed folder (the section key's config root).
|
|
99
98
|
- The file is optional; comment-only is complete.
|
|
100
99
|
- list prints \`path | description\` rows; descriptions are the files'
|
|
101
100
|
own — front-matter 'description:' or its first substantive line; a
|
|
102
|
-
folder row carries its
|
|
101
|
+
folder row carries its package.json / manifest.yml description's, else its README's.
|
|
103
102
|
- 'list --write <file>' wraps the same view as a self-describing
|
|
104
103
|
markdown section. The written target is ordinary navigable content —
|
|
105
104
|
give it a front-matter 'description:' (or gitignore / excludeFiles
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/help-topics/config.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/help-topics/config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoGd,CAAC"}
|
|
@@ -1,13 +1,13 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* help topic text — telling-agents: the context-file entry
|
|
3
|
-
*
|
|
2
|
+
* help topic text — telling-agents: the context-file entry. The entry is
|
|
3
|
+
* two lines — a capability line + a one-shot procedural line: knowing the
|
|
4
4
|
* entry is not using it, so the entry itself schedules one pull per
|
|
5
5
|
* session, restoring what a hand-written navigation section used to
|
|
6
|
-
* guarantee. Two-line cap, derivation-free, never stale
|
|
6
|
+
* guarantee. Two-line cap, derivation-free, never stale. The
|
|
7
7
|
* materialized section is not taught here: '--write' is a list flag and
|
|
8
8
|
* its teaching stays with 'any-nav help list' (an exception for
|
|
9
9
|
* consumers without command access, not day-one knowledge). Burden
|
|
10
|
-
* rules
|
|
10
|
+
* rules keep the page light.
|
|
11
11
|
*/
|
|
12
|
-
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
|
|
12
|
+
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";
|
|
13
13
|
export default _default;
|
|
@@ -1,13 +1,13 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* help topic text — telling-agents: the context-file entry
|
|
3
|
-
*
|
|
2
|
+
* help topic text — telling-agents: the context-file entry. The entry is
|
|
3
|
+
* two lines — a capability line + a one-shot procedural line: knowing the
|
|
4
4
|
* entry is not using it, so the entry itself schedules one pull per
|
|
5
5
|
* session, restoring what a hand-written navigation section used to
|
|
6
|
-
* guarantee. Two-line cap, derivation-free, never stale
|
|
6
|
+
* guarantee. Two-line cap, derivation-free, never stale. The
|
|
7
7
|
* materialized section is not taught here: '--write' is a list flag and
|
|
8
8
|
* its teaching stays with 'any-nav help list' (an exception for
|
|
9
9
|
* consumers without command access, not day-one knowledge). Burden
|
|
10
|
-
* rules
|
|
10
|
+
* rules keep the page light.
|
|
11
11
|
*/
|
|
12
12
|
export default `any-nav telling-agents — the AGENTS.md entry
|
|
13
13
|
|
|
@@ -24,13 +24,14 @@ guarantee a hand-written navigation section used to carry: the map
|
|
|
24
24
|
is consumed once per session — pulled fresh instead of injected.
|
|
25
25
|
|
|
26
26
|
The rows are only as good as each file's own description: front-matter
|
|
27
|
-
'description:' or the first substantive line (folders: their
|
|
27
|
+
'description:' or the first substantive line (folders: their
|
|
28
|
+
package.json / manifest.yml description, else their README).
|
|
28
29
|
Docs that matter deserve a real one — 'any-nav help config' has the
|
|
29
30
|
sourcing rules.
|
|
30
31
|
|
|
31
32
|
Notes:
|
|
32
33
|
- Keep the entry to the two lines. Agents get the rest from
|
|
33
|
-
|
|
34
|
+
any-nav --help themselves; anything longer only goes stale.
|
|
34
35
|
- Default expansion, excludes, budget: 'any-nav help config'. No
|
|
35
36
|
config is needed to start.
|
|
36
37
|
`;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"telling-agents.js","sourceRoot":"","sources":["../../src/help-topics/telling-agents.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,eAAe
|
|
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.js
CHANGED
|
@@ -1,13 +1,13 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* help topics — non-command reference pages rendered through the help
|
|
3
|
-
* subsystem (
|
|
3
|
+
* subsystem (gh-anchored expression).
|
|
4
4
|
*
|
|
5
5
|
* A topic is not a command: `any-nav help config` and `any-nav help
|
|
6
6
|
* <command>` share one verb, `help` (no arguments) lists topics alongside
|
|
7
7
|
* commands, and unknown help targets list both. Topic texts are static
|
|
8
8
|
* string modules under help-topics/ (product documentation, not
|
|
9
9
|
* navigation-fact text). The config topic restates the schema parsed by
|
|
10
|
-
* @any-nav/core;
|
|
10
|
+
* @any-nav/core; guards keep that copy from drifting.
|
|
11
11
|
*/
|
|
12
12
|
import config from './help-topics/config.js';
|
|
13
13
|
import tellingAgents from './help-topics/telling-agents.js';
|
package/package.json
CHANGED
|
@@ -1,8 +1,12 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@any-nav/cli",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.2.0",
|
|
4
4
|
"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.",
|
|
5
5
|
"license": "MIT",
|
|
6
|
+
"repository": {
|
|
7
|
+
"type": "git",
|
|
8
|
+
"url": "git+https://github.com/CatheadOwl/any-nav.git"
|
|
9
|
+
},
|
|
6
10
|
"type": "module",
|
|
7
11
|
"bin": {
|
|
8
12
|
"any-nav": "./dist/main.js"
|
|
@@ -12,10 +16,11 @@
|
|
|
12
16
|
"CHANGELOG.md"
|
|
13
17
|
],
|
|
14
18
|
"publishConfig": {
|
|
15
|
-
"access": "public"
|
|
19
|
+
"access": "public",
|
|
20
|
+
"provenance": false
|
|
16
21
|
},
|
|
17
22
|
"dependencies": {
|
|
18
|
-
"@any-nav/core": "0.
|
|
23
|
+
"@any-nav/core": "0.2.0",
|
|
19
24
|
"commander": "^15.0.0"
|
|
20
25
|
},
|
|
21
26
|
"scripts": {
|
|
@@ -23,6 +28,7 @@
|
|
|
23
28
|
"typecheck": "tsc --noEmit",
|
|
24
29
|
"test": "node --test \"test/*.test.ts\"",
|
|
25
30
|
"pretest": "pnpm --filter @any-nav/core run build",
|
|
26
|
-
"pretypecheck": "pnpm --filter @any-nav/core run build"
|
|
31
|
+
"pretypecheck": "pnpm --filter @any-nav/core run build",
|
|
32
|
+
"expose-skill": "node scripts/expose-skill.mjs"
|
|
27
33
|
}
|
|
28
34
|
}
|
|
@@ -1,9 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* guide topic text — config (reference quadrant, Diataxis).
|
|
3
|
-
* The schema's canonical home is @any-nav/core parseConfig
|
|
4
|
-
* (core/src/config.ts); this copy restates it for humans and is kept
|
|
5
|
-
* from drifting by the SG-6/SG-7 guards (example blocks must parse,
|
|
6
|
-
* every accepted key and mode value must appear).
|
|
7
|
-
*/
|
|
8
|
-
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";
|
|
9
|
-
export default _default;
|
|
@@ -1,94 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* guide topic text — config (reference quadrant, Diataxis).
|
|
3
|
-
* The schema's canonical home is @any-nav/core parseConfig
|
|
4
|
-
* (core/src/config.ts); this copy restates it for humans and is kept
|
|
5
|
-
* from drifting by the SG-6/SG-7 guards (example blocks must parse,
|
|
6
|
-
* every accepted key and mode value must appear).
|
|
7
|
-
*/
|
|
8
|
-
export default `any-nav config — the any-nav.toml schema
|
|
9
|
-
|
|
10
|
-
Goal: the complete key set with defaults. The file states only exceptions:
|
|
11
|
-
an absent key means automatic behavior, and unknown keys are rejected
|
|
12
|
-
with an error.
|
|
13
|
-
|
|
14
|
-
Top-level tables:
|
|
15
|
-
nav required, non-empty array — one [[nav]] entry per source folder
|
|
16
|
-
budget optional — token budget for auto mode sizing
|
|
17
|
-
('any-nav guide modes')
|
|
18
|
-
scan optional — traversal boundary policy
|
|
19
|
-
|
|
20
|
-
[[nav]] entries:
|
|
21
|
-
path required, string folder to navigate, relative to the
|
|
22
|
-
config file location
|
|
23
|
-
mode optional auto | inject | drill | recall
|
|
24
|
-
(default auto — see 'any-nav guide
|
|
25
|
-
modes')
|
|
26
|
-
bind optional, v2 push bindings — parsed, no effect
|
|
27
|
-
today
|
|
28
|
-
|
|
29
|
-
[budget]:
|
|
30
|
-
share optional, number fraction of the assumed context
|
|
31
|
-
window (100,000 tokens) that
|
|
32
|
-
injected sections may occupy,
|
|
33
|
-
0 < share <= 1 (default 0.02)
|
|
34
|
-
maxTokens optional, integer hard cap in estimated tokens
|
|
35
|
-
(default: none — share rules)
|
|
36
|
-
|
|
37
|
-
[scan]:
|
|
38
|
-
excludeDirs optional, strings directory names skipped in
|
|
39
|
-
traversal (default: .git, .hg, .svn,
|
|
40
|
-
node_modules, .pnpm, dist, build,
|
|
41
|
-
lib, out)
|
|
42
|
-
excludeFiles optional, strings markdown file names excluded,
|
|
43
|
-
case-insensitive
|
|
44
|
-
(default: AGENTS.md, CLAUDE.md)
|
|
45
|
-
excludeDotEntries optional, boolean skip entries whose name starts
|
|
46
|
-
with '.' (default true)
|
|
47
|
-
respectGitignore optional, boolean traversal respects .gitignore
|
|
48
|
-
files (default true)
|
|
49
|
-
maxFiles optional, integer markdown files read per source
|
|
50
|
-
(default 2000); past the cap files are
|
|
51
|
-
skipped with a diagnostic, never silently
|
|
52
|
-
|
|
53
|
-
Minimal example:
|
|
54
|
-
|
|
55
|
-
\`\`\`toml
|
|
56
|
-
[[nav]]
|
|
57
|
-
path = "docs"
|
|
58
|
-
\`\`\`
|
|
59
|
-
|
|
60
|
-
Full example (every key, values illustrative):
|
|
61
|
-
|
|
62
|
-
\`\`\`toml
|
|
63
|
-
[[nav]]
|
|
64
|
-
path = "docs"
|
|
65
|
-
mode = "auto"
|
|
66
|
-
|
|
67
|
-
[[nav]]
|
|
68
|
-
path = "TODO"
|
|
69
|
-
|
|
70
|
-
[budget]
|
|
71
|
-
share = 0.1
|
|
72
|
-
maxTokens = 4000
|
|
73
|
-
|
|
74
|
-
[scan]
|
|
75
|
-
excludeDirs = ["node_modules", "dist"]
|
|
76
|
-
excludeFiles = ["AGENTS.md"]
|
|
77
|
-
excludeDotEntries = true
|
|
78
|
-
respectGitignore = true
|
|
79
|
-
maxFiles = 500
|
|
80
|
-
\`\`\`
|
|
81
|
-
|
|
82
|
-
Key boundaries:
|
|
83
|
-
- Discovery: any-nav searches for any-nav.toml upward from the current
|
|
84
|
-
directory; '--config <path>' overrides.
|
|
85
|
-
- Mode semantics (what auto picks, what an explicit mode freezes):
|
|
86
|
-
'any-nav guide modes'.
|
|
87
|
-
- A key is only real if this page lists it; the example blocks above are
|
|
88
|
-
checked against the live parser by the test suite.
|
|
89
|
-
|
|
90
|
-
Remember:
|
|
91
|
-
- First config without writing one: 'any-nav init <path...>'.
|
|
92
|
-
- Budget and chain semantics: 'any-nav guide modes'.
|
|
93
|
-
`;
|
|
94
|
-
//# sourceMappingURL=config.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/guide-content/config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqFd,CAAC"}
|
|
@@ -1,7 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* guide topic text — modes (explanation quadrant, Diataxis).
|
|
3
|
-
* Semantics restated from docs/specs/mode.md (the living spec); this copy
|
|
4
|
-
* teaches, the spec rules.
|
|
5
|
-
*/
|
|
6
|
-
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";
|
|
7
|
-
export default _default;
|
|
@@ -1,40 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* guide topic text — modes (explanation quadrant, Diataxis).
|
|
3
|
-
* Semantics restated from docs/specs/mode.md (the living spec); this copy
|
|
4
|
-
* teaches, the spec rules.
|
|
5
|
-
*/
|
|
6
|
-
export default `any-nav modes — exposure modes and the budget chain
|
|
7
|
-
|
|
8
|
-
Goal: understand what any-nav injects and why a large source sometimes
|
|
9
|
-
injects less than the whole tree.
|
|
10
|
-
|
|
11
|
-
The chain (auto only):
|
|
12
|
-
inject-full the whole navigation injected
|
|
13
|
-
inject-top top level plus an "omitted below" pointer
|
|
14
|
-
recall a stub pointing at search/read
|
|
15
|
-
With mode absent (auto), any-nav walks this chain and picks the cheapest
|
|
16
|
-
form that fits the budget: [budget] share / maxTokens bound the estimated
|
|
17
|
-
tokens the section may occupy.
|
|
18
|
-
|
|
19
|
-
Explicit mode = hard constraint:
|
|
20
|
-
inject full injection, never degraded for budget
|
|
21
|
-
drill top level plus a drill-down pointer, never collapses to recall
|
|
22
|
-
recall recall stub only, never upgrades because the source is small
|
|
23
|
-
Over budget with an explicit mode, any-nav warns and ships the declared
|
|
24
|
-
form anyway; the warning is expected, not a failure.
|
|
25
|
-
|
|
26
|
-
Declaration ↔ chain form: inject = inject-full, drill = inject-top,
|
|
27
|
-
recall = recall. Declaring a mode freezes the auto chain at that form;
|
|
28
|
-
the chain-level names are what generate reports.
|
|
29
|
-
|
|
30
|
-
Key boundaries:
|
|
31
|
-
- Omission notices belong to auto only: an auto degradation explains
|
|
32
|
-
itself and how to recover (list / search). Explicit modes never degrade,
|
|
33
|
-
so they never explain omissions.
|
|
34
|
-
- The budget bounds the injected map only. list / search / read always
|
|
35
|
-
answer over the full tree.
|
|
36
|
-
|
|
37
|
-
Remember:
|
|
38
|
-
- Modes are declared per source in any-nav.toml ('any-nav guide config').
|
|
39
|
-
`;
|
|
40
|
-
//# sourceMappingURL=modes.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"modes.js","sourceRoot":"","sources":["../../src/guide-content/modes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiCd,CAAC"}
|
|
@@ -1,7 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* guide topic text — quickstart (tutorial quadrant, Diataxis).
|
|
3
|
-
* Teaching home per ADR-0013: this is product documentation, not
|
|
4
|
-
* navigation-fact text, so it lives in the CLI package as static copy.
|
|
5
|
-
*/
|
|
6
|
-
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";
|
|
7
|
-
export default _default;
|
|
@@ -1,43 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* guide topic text — quickstart (tutorial quadrant, Diataxis).
|
|
3
|
-
* Teaching home per ADR-0013: this is product documentation, not
|
|
4
|
-
* navigation-fact text, so it lives in the CLI package as static copy.
|
|
5
|
-
*/
|
|
6
|
-
export default `any-nav quickstart — first navigation from any Markdown folder
|
|
7
|
-
|
|
8
|
-
Goal: point any-nav at Markdown folders and get a generated navigation
|
|
9
|
-
section that agents can list, search, and read.
|
|
10
|
-
|
|
11
|
-
Fast path:
|
|
12
|
-
1. Create the config
|
|
13
|
-
any-nav init docs
|
|
14
|
-
Writes any-nav.toml with one [[nav]] entry per path. Already have a
|
|
15
|
-
config? Skip this step. Full schema: 'any-nav guide config'.
|
|
16
|
-
|
|
17
|
-
2. Generate the navigation section
|
|
18
|
-
any-nav generate
|
|
19
|
-
Scans the configured sources and writes a marked section between
|
|
20
|
-
'<!-- any-nav:...:begin -->' and '<!-- any-nav:...:end -->' markers in
|
|
21
|
-
each target file (default format generic-markdown: any-nav/<source>.md;
|
|
22
|
-
--format agents-md writes into AGENTS.md).
|
|
23
|
-
|
|
24
|
-
3. Use it
|
|
25
|
-
any-nav list top-level map of the first source
|
|
26
|
-
any-nav list --source docs --depth 1 drill one level
|
|
27
|
-
any-nav search <keywords> no result is not an error
|
|
28
|
-
(exit 0)
|
|
29
|
-
any-nav read <locator> locator = path relative to a
|
|
30
|
-
source root, e.g. sub/deploy.md
|
|
31
|
-
|
|
32
|
-
Key boundaries:
|
|
33
|
-
- Map, not territory: marked sections are generated. Never hand-edit
|
|
34
|
-
between the markers — edit the source documents and regenerate.
|
|
35
|
-
- Only exceptions go in the config; absent keys fall back to defaults.
|
|
36
|
-
- After adding or renaming documents, rerun 'any-nav generate'.
|
|
37
|
-
|
|
38
|
-
Remember:
|
|
39
|
-
- 'any-nav guide config' for the complete any-nav.toml schema.
|
|
40
|
-
- 'any-nav guide workflow' for the edit-regenerate loop.
|
|
41
|
-
- 'any-nav guide modes' when a section comes out smaller than the folder.
|
|
42
|
-
`;
|
|
43
|
-
//# sourceMappingURL=quickstart.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"quickstart.js","sourceRoot":"","sources":["../../src/guide-content/quickstart.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoCd,CAAC"}
|
|
@@ -1,5 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* guide topic text — workflow (how-to quadrant, Diataxis).
|
|
3
|
-
*/
|
|
4
|
-
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";
|
|
5
|
-
export default _default;
|
|
@@ -1,40 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* guide topic text — workflow (how-to quadrant, Diataxis).
|
|
3
|
-
*/
|
|
4
|
-
export default `any-nav workflow — the edit-regenerate loop
|
|
5
|
-
|
|
6
|
-
Goal: keep the generated navigation in step with the documents it maps.
|
|
7
|
-
|
|
8
|
-
How-to:
|
|
9
|
-
1. Add or rename documents in a configured source
|
|
10
|
-
Just edit files. Nothing registers — the scan discovers Markdown by
|
|
11
|
-
traversal under the [scan] policy ('any-nav guide config').
|
|
12
|
-
|
|
13
|
-
2. Regenerate
|
|
14
|
-
any-nav generate rewrite marked sections in place
|
|
15
|
-
any-nav generate -n dry-run: report targets and sizes only
|
|
16
|
-
any-nav generate --format agents-md write into AGENTS.md
|
|
17
|
-
|
|
18
|
-
3. Add or remove a source folder
|
|
19
|
-
Edit the [[nav]] entries in any-nav.toml (or run 'any-nav init' where no
|
|
20
|
-
config exists yet), then regenerate.
|
|
21
|
-
|
|
22
|
-
4. Check what the consumer sees
|
|
23
|
-
any-nav list [--source <path>] [--prefix <sub>] [--depth n]
|
|
24
|
-
any-nav search <keywords>
|
|
25
|
-
any-nav read <locator>
|
|
26
|
-
|
|
27
|
-
Key boundaries:
|
|
28
|
-
- Marked sections are generated: everything between
|
|
29
|
-
'<!-- any-nav:...:begin -->' and '<!-- any-nav:...:end -->' is rewritten
|
|
30
|
-
by the next generate. Hand edits there are lost by design.
|
|
31
|
-
- Descriptions come from each file's front matter 'description:'; files
|
|
32
|
-
without one render as Undocumented placeholders and warn on generate.
|
|
33
|
-
- Generate is idempotent: rerunning without document changes rewrites
|
|
34
|
-
identical content.
|
|
35
|
-
|
|
36
|
-
Remember:
|
|
37
|
-
- 'any-nav guide quickstart' for the first-run path.
|
|
38
|
-
- 'any-nav guide modes' when a section comes out smaller than expected.
|
|
39
|
-
`;
|
|
40
|
-
//# sourceMappingURL=workflow.js.map
|
|
@@ -1 +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
DELETED
package/dist/guide.js
DELETED
|
@@ -1,30 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* guide — the in-CLI teaching home (ADR-0013).
|
|
3
|
-
*
|
|
4
|
-
* Topic texts are static string modules under guide-content/ (product
|
|
5
|
-
* documentation, not navigation-fact text, so they live in the CLI package
|
|
6
|
-
* rather than core). GUIDE_TOPICS is the single source of the roster: the
|
|
7
|
-
* topic list, guide's own help, and the root-help "Start here" line all
|
|
8
|
-
* render from it. The config topic restates the schema parsed by
|
|
9
|
-
* @any-nav/core; the SG-6/SG-7 guards keep that copy from drifting.
|
|
10
|
-
*/
|
|
11
|
-
import quickstart from './guide-content/quickstart.js';
|
|
12
|
-
import config from './guide-content/config.js';
|
|
13
|
-
import workflow from './guide-content/workflow.js';
|
|
14
|
-
import modes from './guide-content/modes.js';
|
|
15
|
-
export const GUIDE_TOPICS = [
|
|
16
|
-
['quickstart', 'first run: init a config, generate the navigation section, use list/search/read'],
|
|
17
|
-
['config', 'the complete any-nav.toml schema with defaults; absent keys mean automatic'],
|
|
18
|
-
['workflow', 'the edit-regenerate loop: sources, markers, descriptions, idempotency'],
|
|
19
|
-
['modes', 'exposure modes and the budget chain: auto degrades, explicit modes are hard constraints'],
|
|
20
|
-
];
|
|
21
|
-
const TEXTS = { quickstart, config, workflow, modes };
|
|
22
|
-
export const topicNames = () => GUIDE_TOPICS.map(([topic]) => topic);
|
|
23
|
-
export function renderGuideList() {
|
|
24
|
-
const rows = GUIDE_TOPICS.map(([topic, summary]) => ` ${topic.padEnd(12)} ${summary}`);
|
|
25
|
-
return ['Guides:', ...rows, '', `Run 'any-nav guide <topic>' to read one.`].join('\n');
|
|
26
|
-
}
|
|
27
|
-
export function renderGuide(topic) {
|
|
28
|
-
return TEXTS[topic] ?? null;
|
|
29
|
-
}
|
|
30
|
-
//# sourceMappingURL=guide.js.map
|
package/dist/guide.js.map
DELETED
|
@@ -1 +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"}
|