@bpmnkit/docspack 0.0.4 → 0.0.5

package/.llms/manifest.json

@@ -1,7 +1,7 @@
 {
 	"$schema": "https://docspack.dev/schema/v1.json",
 	"name": "@bpmnkit/docspack",
-	"version": "0.0.4",
+	"version": "0.0.5",
 	"documents": [
 		"@bpmnkit/core",
 		"@bpmnkit/canvas",

package/README.md

@@ -125,6 +125,7 @@ Options: `--limit <n>`, `--max-tokens <n>`, `--pack <name>`, `--cwd <dir>`.
 | [`@bpmnkit/plugins`](https://www.npmjs.com/package/@bpmnkit/plugins) | 22 composable canvas plugins |
 | [`@bpmnkit/api`](https://www.npmjs.com/package/@bpmnkit/api) | Camunda 8 REST API TypeScript client |
 | [`@bpmnkit/ascii`](https://www.npmjs.com/package/@bpmnkit/ascii) | Render BPMN diagrams as Unicode ASCII art |
+| [`@bpmnkit/camunda-docspack`](https://www.npmjs.com/package/@bpmnkit/camunda-docspack) | Camunda 8 docs as an offline docspack package for AI agents |
 | [`@bpmnkit/ui`](https://www.npmjs.com/package/@bpmnkit/ui) | Shared design tokens and UI components |
 | [`@bpmnkit/profiles`](https://www.npmjs.com/package/@bpmnkit/profiles) | Shared auth, profile storage, and client factories for CLI & proxy |
 | [`@bpmnkit/operate`](https://www.npmjs.com/package/@bpmnkit/operate) | Monitoring & operations frontend for Camunda clusters |

package/dist/chunk.js

@@ -25,7 +25,7 @@ export function chunkDocument(doc, options = {}) {
             if (text === "")
                 continue;
             const directives = readDirectives(part.lines);
-            const chunkTitle = part.heading === "" ? title : `${title} — ${part.heading}`;
+            const chunkTitle = joinHeadings(title, part.heading);
             const source = options.siteUrl ? `\n\n---\nSource: ${options.siteUrl}/${doc.slug}` : "";
             const bodyText = `# ${chunkTitle}\n\n${stripDirectives(text)}${source}\n`;
             chunks.push({
@@ -116,8 +116,7 @@ function subdivide(section, maxTokens) {
         return [section];
     const parts = [];
     for (const sub of splitByHeading(section.lines.join("\n"), 3)) {
-        const heading = sub.heading === "" ? section.heading : `${section.heading} — ${sub.heading}`;
-        parts.push(...byParagraph({ heading, lines: sub.lines }, maxTokens));
+        parts.push(...byParagraph({ heading: joinHeadings(section.heading, sub.heading), lines: sub.lines }, maxTokens));
     }
     return parts.length > 0 ? parts : [section];
 }
@@ -132,7 +131,7 @@ function byParagraph(section, maxTokens) {
         if (current.join("").trim() === "")
             return;
         const suffix = parts.length === 0 ? "" : ` (${parts.length + 1})`;
-        parts.push({ heading: `${section.heading}${suffix}`, lines: current });
+        parts.push({ heading: `${section.heading}${suffix}`.trim(), lines: current });
         current = [];
     };
     for (const line of section.lines) {
@@ -177,6 +176,17 @@ function stripDirectives(text) {
         .join("\n")
         .trim();
 }
+/**
+ * Join a chunk's heading trail, dropping the levels that have no heading of their own.
+ *
+ * A document whose text before the first `##` is shorter than `minTokens` is merged into the
+ * section after it, and the merged section keeps the preamble's empty heading. Composing that
+ * blindly produced a hole in the middle of the trail — `Naming BPMN elements —  — Naming
+ * gateways` — which is what a reader sees at the top of the chunk and what an answer cites.
+ */
+function joinHeadings(...parts) {
+    return parts.filter((part) => part.trim() !== "").join(" — ");
+}
 /** Heading words carry the topic; function words carry nothing worth weighting 3x. */
 function headingTags(heading) {
     return tokenize(heading).filter((word) => word.length > 2 && !STOP_WORDS.has(word));

package/llms.txt

@@ -2,7 +2,7 @@
 
 > BPMN Kit documentation as an offline, version-locked docspack package with a built-in search CLI for AI agents
 
-Version 0.0.4. 191 chunks documenting @bpmnkit/core, @bpmnkit/canvas, @bpmnkit/editor, @bpmnkit/engine, @bpmnkit/feel, @bpmnkit/plugins, @bpmnkit/api, @bpmnkit/ascii, @bpmnkit/connector-gen, @bpmnkit/connectors, @bpmnkit/patterns, @bpmnkit/worker-client, @bpmnkit/cli.
+Version 0.0.5. 191 chunks documenting @bpmnkit/core, @bpmnkit/canvas, @bpmnkit/editor, @bpmnkit/engine, @bpmnkit/feel, @bpmnkit/plugins, @bpmnkit/api, @bpmnkit/ascii, @bpmnkit/connector-gen, @bpmnkit/connectors, @bpmnkit/patterns, @bpmnkit/worker-client, @bpmnkit/cli.
 
 ```sh
 npm i -D @bpmnkit/docspack

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bpmnkit/docspack",
-  "version": "0.0.4",
+  "version": "0.0.5",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",