docspack 1.1.0 → 1.3.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.
Files changed (77) hide show
  1. package/README.md +25 -1
  2. package/dist/build.d.ts +5 -0
  3. package/dist/build.d.ts.map +1 -1
  4. package/dist/build.js +68 -5
  5. package/dist/build.js.map +1 -1
  6. package/dist/cli-spec.d.ts +3 -0
  7. package/dist/cli-spec.d.ts.map +1 -0
  8. package/dist/cli-spec.js +667 -0
  9. package/dist/cli-spec.js.map +1 -0
  10. package/dist/cli.d.ts +146 -1
  11. package/dist/cli.d.ts.map +1 -1
  12. package/dist/cli.js +80 -14
  13. package/dist/cli.js.map +1 -1
  14. package/dist/cmdspec.json +1219 -0
  15. package/dist/commands.d.ts +78 -0
  16. package/dist/commands.d.ts.map +1 -0
  17. package/dist/commands.js +231 -0
  18. package/dist/commands.js.map +1 -0
  19. package/dist/config.d.ts +1 -0
  20. package/dist/config.d.ts.map +1 -1
  21. package/dist/config.js +2 -0
  22. package/dist/config.js.map +1 -1
  23. package/dist/db.d.ts +6 -1
  24. package/dist/db.d.ts.map +1 -1
  25. package/dist/db.js +7 -1
  26. package/dist/db.js.map +1 -1
  27. package/dist/discovery.d.ts +22 -3
  28. package/dist/discovery.d.ts.map +1 -1
  29. package/dist/discovery.js +91 -12
  30. package/dist/discovery.js.map +1 -1
  31. package/dist/doctor.d.ts.map +1 -1
  32. package/dist/doctor.js +66 -1
  33. package/dist/doctor.js.map +1 -1
  34. package/dist/help.d.ts +10 -6
  35. package/dist/help.d.ts.map +1 -1
  36. package/dist/help.js +118 -371
  37. package/dist/help.js.map +1 -1
  38. package/dist/index.d.ts +1 -1
  39. package/dist/index.d.ts.map +1 -1
  40. package/dist/index.js +1 -1
  41. package/dist/index.js.map +1 -1
  42. package/dist/init/plan.js +4 -3
  43. package/dist/init/plan.js.map +1 -1
  44. package/dist/init/templates.d.ts.map +1 -1
  45. package/dist/init/templates.js +4 -2
  46. package/dist/init/templates.js.map +1 -1
  47. package/dist/preview.d.ts.map +1 -1
  48. package/dist/preview.js +12 -6
  49. package/dist/preview.js.map +1 -1
  50. package/dist/search.d.ts +2 -0
  51. package/dist/search.d.ts.map +1 -1
  52. package/dist/search.js +66 -22
  53. package/dist/search.js.map +1 -1
  54. package/dist/spec.d.ts +21 -1
  55. package/dist/spec.d.ts.map +1 -1
  56. package/dist/spec.js +24 -2
  57. package/dist/spec.js.map +1 -1
  58. package/dist/sync.d.ts.map +1 -1
  59. package/dist/sync.js +99 -1
  60. package/dist/sync.js.map +1 -1
  61. package/package.json +8 -5
  62. package/src/build.ts +86 -7
  63. package/src/cli-spec.ts +688 -0
  64. package/src/cli.ts +90 -17
  65. package/src/commands.ts +298 -0
  66. package/src/config.ts +4 -1
  67. package/src/db.ts +9 -2
  68. package/src/discovery.ts +113 -12
  69. package/src/doctor.ts +67 -0
  70. package/src/help.ts +138 -380
  71. package/src/index.ts +1 -0
  72. package/src/init/plan.ts +4 -3
  73. package/src/init/templates.ts +4 -2
  74. package/src/preview.ts +14 -13
  75. package/src/search.ts +79 -22
  76. package/src/spec.ts +28 -2
  77. package/src/sync.ts +120 -1
package/dist/help.js CHANGED
@@ -1,393 +1,139 @@
1
+ import { commandPath, commandSummary, resolveDocument, synopsis, } from "@docspack/cmdspec";
2
+ import { CLI } from "./cli-spec.js";
1
3
  import { AGENTS_SNIPPET, FEEDBACK_SNIPPET } from "./snippet.js";
2
- const LIMIT = 3;
3
- const MAX_TOKENS = 3000;
4
- const QUERY_OPTIONS = [
5
- ["-p, --package <s>", "only packages whose name contains this text"],
6
- ["--limit <n>", `maximum chunks to return (default ${LIMIT})`],
7
- ["--max-tokens <n>", `token ceiling for the result set (default ${MAX_TOKENS})`],
8
- ["--all", "search the whole store, not just this project"],
9
- ];
10
- export const COMMANDS = [
11
- {
12
- name: "sync",
13
- summary: "Index the docs packages this project depends on",
14
- group: "core",
15
- usage: "docspack sync [options]",
16
- options: [
17
- ["--force", "re-index packages already in the store"],
18
- ["--no-artifacts", "skip the declarations derived from installed libraries"],
19
- ],
20
- detail: [
21
- "Reads node_modules and indexes every @vendor/docspack and @docspack-community/<name>",
22
- "package this project declares. Makes no network requests.",
23
- "",
24
- "It also reads each installed library's own type declarations and indexes one entry per",
25
- "exported name. Half of a well-documented library's exports are mentioned in no",
26
- "documentation anyone published, and those declarations are the only local answer for",
27
- "them. They are looked up by name, never ranked against prose, so they cannot crowd out",
28
- "the documentation that does exist.",
29
- ],
30
- examples: ["docspack sync", "docspack sync --force", "docspack sync --no-artifacts"],
31
- },
32
- {
33
- name: "ask",
34
- summary: "Answer from the local index — the command to give an agent",
35
- group: "core",
36
- usage: 'docspack ask "<question>"',
37
- options: QUERY_OPTIONS,
38
- detail: [
39
- "Answers from the installed versions, in the Markdown an agent should read. Exits 0 when",
40
- "chunks were returned, 3 when a docs package is installed but not indexed, and 4 when",
41
- "everything installed is indexed and nothing matched.",
42
- "",
43
- "When the question names something an installed library exports and no documentation",
44
- "mentions, the answer leads with that name's declaration from the installed build and says",
45
- "the documentation does not cover it. Ranking alone cannot tell that apart from a match.",
46
- ],
47
- examples: [
48
- 'docspack ask "how do I verify a webhook signature"',
49
- 'docspack ask "webhook signature" --package stripe --limit 5',
50
- ],
51
- },
52
- {
53
- name: "index",
54
- summary: "Index this project's own sources, so an agent can ask them instead of reading them",
55
- group: "core",
56
- usage: "docspack index [--from <dir>] [--from-json <file|->]",
57
- options: [
58
- ["--from <dir>", "directory of Markdown to index"],
59
- ["--from-json <f>", "JSON records to index, or `-` for standard input"],
60
- ["--name <s>", "name for the corpus (default: derived from the source)"],
61
- ["--force", "re-index even when no source has changed"],
62
- ],
63
- detail: [
64
- "For a corpus this project already has rather than one somebody published: notes, an",
65
- "export, rows out of a query. The payload is built in a temporary directory and thrown",
66
- "away; what is kept is the index, in `.docspack/local.db`, which is a plaintext copy of",
67
- "whatever was indexed and is gitignored on the tool's behalf.",
68
- "",
69
- "Records arrive as JSON so no database driver is needed: `sqlite3 -json … | docspack index",
70
- "--from-json -`. A record with an `id` becomes one chunk under that id, because a row's",
71
- "identity is its key.",
72
- "",
73
- "What was indexed is recorded with each source's size, mtime and hash, so a re-run does",
74
- "nothing when nothing has changed and `recall` can say when an answer may be superseded.",
75
- ],
76
- examples: [
77
- "docspack index --from ./notes",
78
- "sqlite3 -json shop.db 'select id, title, body as text from posts' | docspack index --from-json -",
79
- ],
80
- },
81
- {
82
- name: "recall",
83
- summary: "Answer from this project's indexed corpus, not from its dependencies",
84
- group: "core",
85
- usage: 'docspack recall "<question>"',
86
- options: [
87
- ["--limit <n>", `maximum chunks to return (default ${LIMIT})`],
88
- ["--max-tokens <n>", `token ceiling for the result set (default ${MAX_TOKENS})`],
89
- ],
90
- detail: [
91
- "Separate from `ask` on purpose. `ask` answers from the versions this project installed,",
92
- "and a working corpus is never one of them — so a corpus cannot reach an answer about a",
93
- "dependency, and a dependency cannot reach an answer about your notes.",
94
- "",
95
- "An answer leads with a warning when a source has changed since it was indexed. Exits 1",
96
- "when nothing matched.",
97
- ],
98
- examples: ['docspack recall "what did we decide about retries"'],
99
- },
100
- {
101
- name: "search",
102
- summary: "Same index, formatted for a human reading the terminal",
103
- group: "core",
104
- usage: "docspack search <query>",
105
- options: QUERY_OPTIONS,
106
- detail: ["The same index and ranking as `ask`, printed as a list of hits with a preview."],
107
- examples: ["docspack search webhook signature"],
108
- },
109
- {
110
- name: "list",
111
- summary: "Show this project's docs packages and their index state",
112
- group: "core",
113
- usage: "docspack list [options]",
114
- options: [["--coverage", "how much of each documented library's exports the prose mentions"]],
115
- detail: [
116
- "Coverage is mechanical: the exported names a library declares, against the names its",
117
- "documentation mentions anywhere. It is reported, never gated on — a page listing every",
118
- "export and explaining none would score full marks.",
119
- ],
120
- examples: ["docspack list", "docspack list --coverage", "docspack list --json"],
121
- },
122
- {
123
- name: "agent",
124
- summary: "Wire docspack into the agent tooling this project already uses",
125
- group: "core",
126
- usage: "docspack agent <install|check> [options]",
127
- options: [
128
- ["--feedback", "also include recording documentation problems"],
129
- ["--hooks", "add a SessionStart hook that keeps the index in step"],
130
- ["--mcp", "add the MCP server to .mcp.json"],
131
- ["--dry-run", "print what would be written and write nothing"],
132
- ],
133
- detail: [
134
- "`install` writes a marked block into AGENTS.md or CLAUDE.md — whichever the project",
135
- "already has — and a skill into .claude/skills/docspack/ when the project uses Claude",
136
- "Code. Everything outside the markers is left alone, and re-running rewrites the block",
137
- "rather than appending a second copy.",
138
- "",
139
- "`check` writes nothing and exits non-zero when the wiring is missing or out of date, so",
140
- "CI notices a pasted instruction that has drifted from what the tool now does.",
141
- ],
142
- examples: [
143
- "docspack agent install",
144
- "docspack agent install --feedback --hooks",
145
- "docspack agent check",
146
- ],
147
- },
148
- {
149
- name: "changed",
150
- summary: "What a library's exports gained and lost between two versions",
151
- group: "core",
152
- usage: "docspack changed <library>[@version]",
153
- options: [],
154
- detail: [
155
- "Compares two versions already in the global store, which is shared by every project on",
156
- "this machine, so nothing is fetched. Without a version it compares what is installed here",
157
- "against the most recently indexed other version.",
158
- "",
159
- "Upgrades are overwhelmingly additive: the useful answer is what exists now that an older",
160
- "release did not have, and which of those names no documentation here mentions — the ones",
161
- "a model can know from neither its training data nor the vendor's pages.",
162
- ],
163
- examples: ["docspack changed hono", "docspack changed hono@4.0.0"],
164
- },
165
- {
166
- name: "verify",
167
- summary: "Check the docs still describe the code you installed",
168
- group: "core",
169
- usage: "docspack verify [options]",
170
- options: [["--package-dir <d>", "verify one package directory instead of what is installed"]],
171
- detail: [
172
- "Compares the identifiers the chunks name against what the documented libraries declare,",
173
- "read from their .d.ts files. Nothing you depend on is imported or executed. The libraries",
174
- 'come from the manifest\'s "documents", or from the docspack key when the manifest has none.',
175
- "Exits 1 when anything was reported.",
176
- ],
177
- examples: ["docspack verify", "docspack verify --json"],
178
- },
179
- {
180
- name: "feedback",
181
- summary: "Record documentation problems: add, list, submit, remove",
182
- group: "core",
183
- usage: "docspack feedback <add|list|submit|remove> [options]",
184
- options: [
185
- ["--chunk <id>", "add: the chunk the problem is in"],
186
- ["--kind <k>", "add: drift, incorrect or missing"],
187
- ["--evidence <text>", "add: the claim, in one line"],
188
- ["--expected <text>", "add: what the documentation led you to expect"],
189
- ["--actual <text>", "add: what happened instead"],
190
- ["--repro <code>", "add: code that demonstrates it"],
191
- ["-p, --package <s>", "submit: only findings from packages matching this text"],
192
- ["--all", "remove: every recorded finding"],
193
- ],
194
- detail: [
195
- "Writes to .docspack/feedback.jsonl in this project. Nothing is transmitted: docspack",
196
- "contains no code that can send a report anywhere.",
197
- "",
198
- "`drift` must name the identifier that drifted. `incorrect` and `missing` must carry",
199
- "--expected, --actual and --repro, so a claim that cannot show its work cannot be",
200
- "recorded. `submit` prints a prefilled GitHub issue URL for a human to open and file.",
201
- ],
202
- examples: [
203
- 'docspack feedback add --chunk @acme/docspack@1.4.0/api-auth --kind drift --evidence "client.setKey is not exported; setApiKey is"',
204
- "docspack feedback list",
205
- "docspack feedback submit",
206
- "docspack feedback remove <fingerprint>",
207
- ],
208
- },
209
- {
210
- name: "mcp",
211
- summary: "Serve the index over MCP instead, as a long-lived process",
212
- group: "core",
213
- usage: "docspack mcp",
214
- options: [],
215
- detail: [
216
- "Serves the same index over the Model Context Protocol, for clients that prefer a tool",
217
- "definition to a shell command. `query_local_docs` returns exactly what `ask` prints.",
218
- "stdout is the protocol channel, so nothing else is written to it.",
219
- ],
220
- examples: ["docspack mcp"],
221
- },
222
- {
223
- name: "sources",
224
- summary: "List curated sources that `docspack build` can fetch",
225
- group: "core",
226
- usage: "docspack sources",
227
- options: [],
228
- examples: ["docspack sources", "docspack build hono --name @docspack-community/hono"],
229
- },
230
- {
231
- name: "init",
232
- summary: "Scaffold a documentation package, then build and check it",
233
- group: "authoring",
234
- usage: "docspack init [name] [options]",
235
- options: [
236
- ["-y, --yes", "skip the prompts and use flags plus detected defaults"],
237
- ["--dry-run", "print the file tree and write nothing"],
238
- ["--mirror <id|url>", "bootstrap from a published llms.txt"],
239
- ["--community", "scaffold under @docspack-community"],
240
- ["--template <t>", "full (default) or minimal"],
241
- ["--mode <m>", "standalone or in-repo"],
242
- ["--no-workflow", "skip the release workflow"],
243
- ["--no-build", "scaffold only"],
244
- ["--name <name>", "package name, e.g. @acme/docspack"],
245
- ["--pkg-version <v>", "package version"],
246
- ["--from <dir>", "directory of Markdown to package"],
247
- ["--openapi <file>", "OpenAPI JSON to package"],
248
- ["--out <dir>", "where to scaffold (default: ./docspack)"],
249
- ["--force", "overwrite files that already exist"],
250
- ],
251
- detail: [
252
- "Reads the surrounding project first — name, version, a docs directory, an OpenAPI",
253
- "document, the git remote, the license — and proposes a package built from what it found.",
254
- ],
255
- examples: [
256
- "docspack init",
257
- "docspack init --name @acme/docspack --from ./docs --yes",
258
- "docspack init --mirror hono --community --yes",
259
- ],
260
- },
261
- {
262
- name: "build",
263
- summary: "Generate the .llms/ payload for publishing",
264
- group: "authoring",
265
- usage: "docspack build [source] [options]",
266
- options: [
267
- ["--from <dir>", "directory of Markdown to package"],
268
- ["--openapi <file>", "OpenAPI 3 document (JSON or YAML), one chunk per operation"],
269
- ["--name <name>", "package name, e.g. @acme/docspack"],
270
- ["--pkg-version <v>", "package version"],
271
- ["--out <dir>", "output directory (default: the current directory)"],
272
- ["--pages <n>", "maximum documents to fetch from a remote source"],
273
- ["--max-chunk-tokens <n>", "split a section above this size (default 800)"],
274
- ["--min-chunk-tokens <n>", "pack adjacent sections up to this size before splitting"],
275
- ["--documents <p>", "library this package documents, repeatable: acme@1.4.0"],
276
- ],
277
- detail: [
278
- "Splits each document at ## headings, then ###, then paragraphs, until every chunk fits",
279
- "the budget. --min-chunk-tokens packs the other way first, merging adjacent sections up to",
280
- "the budget: use it for generated reference, where a heading is a field name and one chunk",
281
- "per heading is hundreds of chunks too small to answer anything.",
282
- "",
283
- "--openapi writes one chunk per operation: the base URL, the credential, the inputs with",
284
- "their types, the response, the failures and a runnable curl call, in LAPIS notation. Each",
285
- "chunk answers to both `POST /v1/charges` and the operationId, so `docspack ask` can be",
286
- "given either. Combine it with --from to publish prose and an API in one package.",
287
- "",
288
- "With no flags, settings are read from the docspack key of the package.json in --out.",
289
- ],
290
- examples: [
291
- "docspack build",
292
- "docspack build --from ./docs --name @acme/docspack --pkg-version 1.4.0",
293
- "docspack build --from ./reference --min-chunk-tokens 400 --max-chunk-tokens 900",
294
- "docspack build --openapi ./openapi.json",
295
- "docspack build --from ./docs --openapi ./openapi.json",
296
- ],
297
- },
298
- {
299
- name: "doctor",
300
- summary: "Check a package the way the indexer and a reviewer would",
301
- group: "authoring",
302
- usage: "docspack doctor [options]",
303
- options: [
304
- ["--strict", "treat structural warnings as failures"],
305
- ["--pedantic", "--strict, and fail on prose style as well"],
306
- ["--package-dir <d>", "the package to inspect (default: .)"],
307
- ],
308
- detail: [
309
- "Errors are packages that will not index. Warnings are packages that will index and",
310
- "retrieve badly. Prose style is a note unless --pedantic, because writing by hand is not a",
311
- "reason to block a first publish. Exits 1 when the package is not ready to publish.",
312
- ],
313
- examples: ["docspack doctor", "docspack doctor --strict", "docspack doctor --json"],
314
- },
315
- {
316
- name: "preview",
317
- summary: "Answer a query from the local package, as an agent would",
318
- group: "authoring",
319
- usage: "docspack preview <query> [options]",
320
- options: [
321
- ["--package-dir <d>", "the package to read (default: .)"],
322
- ["--limit <n>", `maximum chunks to return (default ${LIMIT})`],
323
- ["--max-tokens <n>", `token ceiling for the result set (default ${MAX_TOKENS})`],
324
- ],
325
- detail: [
326
- "Indexes the package in memory and answers through the same ranking and token budget an",
327
- "agent gets. Nothing is published, installed, or written to the global store.",
328
- ],
329
- examples: ['docspack preview "how do I authenticate"'],
330
- },
331
- {
332
- name: "eval",
333
- summary: "Measure retrieval against a set of questions",
334
- group: "authoring",
335
- usage: "docspack eval <queries.json> [options]",
336
- options: [
337
- ["--package-dir <d>", "the package to read (default: .)"],
338
- ["--limit <n>", `chunks per answer, the window a hit must fall in (default ${LIMIT})`],
339
- ["--max-tokens <n>", `token ceiling for each answer (default ${MAX_TOKENS})`],
340
- ["--min-hit-rate <n>", "exit 1 below this percentage of questions answered"],
341
- ],
342
- detail: [
343
- "The evaluation set is a JSON array of questions and the chunk ids that would answer them:",
344
- "",
345
- ' [{ "query": "how do I verify a webhook signature", "expect": "webhooks-signing" },',
346
- ' { "query": "rate limits", "expect": ["rate-limits", "errors"] }]',
347
- "",
348
- "Reports hit rate, top-1 rate and mean answer size — the numbers that settle the chunk",
349
- "budget, which no structural check can see. With --min-hit-rate it gates a publish on",
350
- "retrieval quality the way `doctor --strict` gates it on structure.",
351
- ],
352
- examples: [
353
- "docspack eval ./eval/queries.json",
354
- "docspack eval ./eval/queries.json --min-hit-rate 90",
355
- "docspack eval ./eval/queries.json --limit 1 --json",
356
- ],
357
- },
358
- ];
359
- const GLOBAL_OPTIONS = [
360
- ["--store <path>", "Use a different index"],
361
- ["--cwd <dir>", "Run in a different directory"],
362
- ["--json", "Machine-readable output"],
363
- ["-q, --quiet", "Only print errors"],
364
- ["-h, --help", "Show this help, or a command's help"],
365
- ["-v, --version", "Show the version"],
366
- ];
4
+ const WIDTH = 21;
5
+ /** The width prose is wrapped to, which is what the hand-written help used. */
6
+ const TEXT_WIDTH = 92;
7
+ const RESOLVED = resolveDocument(CLI);
8
+ /** The program's commands as a caller types them, in the order the document declares them. */
9
+ export const COMMANDS = RESOLVED.commands
10
+ .filter((command) => command.path.length === 2 && !command.hidden)
11
+ .map(toHelp);
12
+ const ROOT = RESOLVED.commands[0];
13
+ /** Every option the root declares — the inherited ones every command takes, and its own. */
14
+ const GLOBAL_OPTIONS = ROOT.options.map(optionRow);
367
15
  export function findCommandHelp(name) {
368
16
  return COMMANDS.find((command) => command.name === name);
369
17
  }
370
- const WIDTH = 21;
18
+ /** The document this help is rendered from, for `docspack --cmdspec`. */
19
+ export function cliDocument(version) {
20
+ return { ...CLI, info: { ...CLI.info, version } };
21
+ }
371
22
  function row([flag, description]) {
372
- return ` ${flag.padEnd(WIDTH)} ${description}`;
23
+ return description.length === 0 ? ` ${flag}` : ` ${flag.padEnd(WIDTH)} ${description}`;
373
24
  }
374
25
  /** The page one command prints for `docspack <command> --help`. */
375
26
  export function commandHelpText(command) {
27
+ const resolved = RESOLVED.commands.find((candidate) => commandPath(candidate) === `docspack ${command.name}`);
376
28
  const blocks = [
377
29
  `docspack ${command.name} — ${command.summary}`,
378
30
  "",
379
31
  "Usage",
380
32
  ` ${command.usage}`,
381
33
  ];
34
+ for (const sub of subcommandsOf(resolved))
35
+ blocks.push(` ${synopsis(sub)}`);
382
36
  if (command.detail !== undefined) {
383
37
  blocks.push("", ...command.detail.map((line) => (line.length === 0 ? "" : ` ${line}`)));
384
38
  }
385
39
  if (command.options.length > 0) {
386
40
  blocks.push("", "Options", ...command.options.map(row));
387
41
  }
42
+ for (const sub of subcommandsOf(resolved)) {
43
+ const rows = sub.options.filter((option) => option.hidden !== true).map(optionRow);
44
+ blocks.push("", `${commandPath(sub)} — ${commandSummary(sub) ?? ""}`);
45
+ if (rows.length > 0)
46
+ blocks.push(...rows.map(row));
47
+ }
48
+ const exits = exitRows(resolved);
49
+ if (exits.length > 0)
50
+ blocks.push("", "Exit status", ...exits.map(row));
388
51
  blocks.push("", "Global options", ...GLOBAL_OPTIONS.map(row), "", "Examples", ...command.examples.map((example) => ` ${example}`), "");
389
52
  return blocks.join("\n");
390
53
  }
54
+ function toHelp(command) {
55
+ const description = command.declared.description;
56
+ return {
57
+ name: command.path[1],
58
+ summary: commandSummary(command) ?? "",
59
+ group: command.declared.group === "authoring" ? "authoring" : "core",
60
+ usage: synopsis(command),
61
+ options: command.options.filter((option) => option.hidden !== true).map(optionRow),
62
+ ...(description === undefined ? {} : { detail: wrap(description) }),
63
+ examples: [command, ...subcommandsOf(command)]
64
+ .flatMap((each) => (each.declared.examples ?? []).map((example) => example.run))
65
+ .filter((run, index, all) => all.indexOf(run) === index),
66
+ };
67
+ }
68
+ function subcommandsOf(command) {
69
+ if (command === undefined)
70
+ return [];
71
+ return RESOLVED.commands.filter((candidate) => !candidate.hidden &&
72
+ candidate.path.length === command.path.length + 1 &&
73
+ commandPath(candidate).startsWith(`${commandPath(command)} `));
74
+ }
75
+ /** One option as a help row: its spellings and value, then what it does and its default. */
76
+ function optionRow(option) {
77
+ const spellings = [option.name, ...(option.aliases ?? [])]
78
+ .sort((a, b) => a.length - b.length)
79
+ .join(", ");
80
+ const negation = option.negation === undefined ? "" : `, ${option.negation.join(", ")}`;
81
+ const placeholder = option.value === undefined ? "" : ` <${option.value.name ?? "value"}>`;
82
+ const value = option.value;
83
+ const notes = [
84
+ value?.enum === undefined ? undefined : value.enum.join(", "),
85
+ value?.default !== undefined
86
+ ? `default ${String(value.default)}`
87
+ : value?.defaultDescription === undefined
88
+ ? undefined
89
+ : `default: ${value.defaultDescription}`,
90
+ option.repeat === "list" ? "repeatable" : undefined,
91
+ option.required === true ? "required" : undefined,
92
+ option.env === undefined ? undefined : `env ${option.env.join(", ")}`,
93
+ ].filter((note) => note !== undefined);
94
+ const summary = option.summary ?? "";
95
+ const text = notes.length === 0
96
+ ? summary
97
+ : `${summary}${summary.length > 0 ? " " : ""}(${notes.join("; ")})`;
98
+ return [`${spellings}${placeholder}${negation}`, text];
99
+ }
100
+ /** The statuses a command adds to the program's 0, 1 and 2, with its subcommands'. */
101
+ function exitRows(command) {
102
+ if (command === undefined)
103
+ return [];
104
+ const rows = [];
105
+ for (const each of [command, ...subcommandsOf(command)]) {
106
+ for (const [code, exit] of Object.entries(each.declared.exits ?? {})) {
107
+ const who = each === command ? "" : ` (${each.path.slice(2).join(" ")})`;
108
+ rows.push([code, `${exit.meaning}${who}`]);
109
+ }
110
+ }
111
+ return rows;
112
+ }
113
+ /** A description as help lines: paragraphs wrapped, indented blocks kept as written. */
114
+ function wrap(text) {
115
+ const lines = [];
116
+ for (const paragraph of text.split("\n\n")) {
117
+ if (lines.length > 0)
118
+ lines.push("");
119
+ if (paragraph.startsWith(" ")) {
120
+ lines.push(...paragraph.split("\n").map((line) => line.slice(2)));
121
+ continue;
122
+ }
123
+ let current = "";
124
+ for (const word of paragraph.replace(/\s+/g, " ").trim().split(" ")) {
125
+ if (current.length > 0 && current.length + 1 + word.length > TEXT_WIDTH) {
126
+ lines.push(current);
127
+ current = word;
128
+ }
129
+ else
130
+ current = current.length === 0 ? word : `${current} ${word}`;
131
+ }
132
+ if (current.length > 0)
133
+ lines.push(current);
134
+ }
135
+ return lines;
136
+ }
391
137
  /**
392
138
  * The global page. It lists the commands and the options that apply to all of them, and points
393
139
  * at the per-command pages for the rest — one list of every flag of every command was what made
@@ -410,10 +156,11 @@ Authoring
410
156
  ${group("authoring")}
411
157
 
412
158
  How it works
413
- Documentation ships as npm packages named @vendor/docspack or
414
- @docspack-community/<name>. Add them to package.json, run \`docspack sync\`, and
415
- every chunk is indexed into a shared SQLite database with FTS5. Agents query
416
- that index locally: no network, no scraping, always the installed version.
159
+ Documentation ships as npm packages named @vendor/docspack,
160
+ @vendor/<name>-docspack or @docspack-community/<name>. Add them to
161
+ package.json, run \`docspack sync\`, and every chunk is indexed into a shared
162
+ SQLite database with FTS5. Agents query that index locally: no network, no
163
+ scraping, always the installed version.
417
164
 
418
165
  Giving an agent access
419
166
  Any agent with a shell can run \`docspack ask\`, so one line in AGENTS.md or
package/dist/help.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"help.js","sourceRoot":"","sources":["../src/help.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"help.js","sourceRoot":"","sources":["../src/help.ts"],"names":[],"mappings":"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"}
package/dist/index.d.ts CHANGED
@@ -25,7 +25,7 @@ export { type PreviewOptions, type PreviewResult, previewPackage } from "./previ
25
25
  export { type Choice, defaultStreams, Prompter, type PromptStreams } from "./prompt.js";
26
26
  export { DEFAULT_LIMIT, DEFAULT_MAX_TOKENS, type QueryHit, type QueryOptions, type QueryResult, queryDocs, renderAnswer, splitPackageId, } from "./search.js";
27
27
  export { AGENTS_SNIPPET, FEEDBACK_SNIPPET } from "./snippet.js";
28
- export { CHUNKS_DIR, type ChunkSpec, chunkId, type DocumentedLibrary, estimateTokens, formatDocumentedLibrary, isCommunityPackage, isDocsPackage, isVendorPackage, LLMS_DIR, MANIFEST_FILE, type PackageManifest, packageId, parseDocumentedLibrary, parseManifest, resolveChunkFile, SCHEMA_URL, SPEC_URL, serializeManifest, } from "./spec.js";
28
+ export { CHUNKS_DIR, type ChunkSpec, chunkId, DISCOVERABLE_NAMES, type DocumentedLibrary, estimateTokens, formatDocumentedLibrary, isCommunityPackage, isDocsPackage, isVendorPackage, LLMS_DIR, MANIFEST_FILE, type PackageManifest, packageId, parseDocumentedLibrary, parseManifest, resolveChunkFile, SCHEMA_URL, SPEC_URL, serializeManifest, } from "./spec.js";
29
29
  export { STOPWORDS } from "./stopwords.js";
30
30
  export { type BlockedFinding, type BlockedReason, issueUrl, prepareSubmission, type RoutedFinding, renderBody, type SubmitOptions, type SubmitReport, } from "./submit.js";
31
31
  export { declarationOf, type ExportedSymbol, hasJsdoc, type PublicSurface, readPublicSurface, } from "./surface.js";
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
package/dist/index.js CHANGED
@@ -25,7 +25,7 @@ export { previewPackage } from "./preview.js";
25
25
  export { defaultStreams, Prompter } from "./prompt.js";
26
26
  export { DEFAULT_LIMIT, DEFAULT_MAX_TOKENS, queryDocs, renderAnswer, splitPackageId, } from "./search.js";
27
27
  export { AGENTS_SNIPPET, FEEDBACK_SNIPPET } from "./snippet.js";
28
- export { CHUNKS_DIR, chunkId, estimateTokens, formatDocumentedLibrary, isCommunityPackage, isDocsPackage, isVendorPackage, LLMS_DIR, MANIFEST_FILE, packageId, parseDocumentedLibrary, parseManifest, resolveChunkFile, SCHEMA_URL, SPEC_URL, serializeManifest, } from "./spec.js";
28
+ export { CHUNKS_DIR, chunkId, DISCOVERABLE_NAMES, estimateTokens, formatDocumentedLibrary, isCommunityPackage, isDocsPackage, isVendorPackage, LLMS_DIR, MANIFEST_FILE, packageId, parseDocumentedLibrary, parseManifest, resolveChunkFile, SCHEMA_URL, SPEC_URL, serializeManifest, } from "./spec.js";
29
29
  export { STOPWORDS } from "./stopwords.js";
30
30
  export { issueUrl, prepareSubmission, renderBody, } from "./submit.js";
31
31
  export { declarationOf, hasJsdoc, readPublicSurface, } from "./surface.js";