nosedive 2026.9.3 → 2026.9.4

package/COMMANDS.md

@@ -18,7 +18,7 @@ Invoked directly by humans, or indirectly via agents.
 #### [Add repo to feat](kb/16b4fee2-cc6c-5c29-9327-fde39a35b0a8.md)
 
 ```sh
-npx -y nosedive@2026.9.3 add-repo.feat --help
+npx -y nosedive@2026.9.4 add-repo.feat --help
 ```
 ```md
 Usage: nosedive add-repo.feat <repo-id-or-name> [--ref <ref>] [--work-branch <branch>]
@@ -31,7 +31,7 @@ More: nosedive render 16b4fee2-cc6c-5c29-9327-fde39a35b0a8
 #### [Append log](kb/f29ec670-caea-5b77-ba51-c7dba1468b0b.md)
 
 ```sh
-npx -y nosedive@2026.9.3 append-log.dive --help
+npx -y nosedive@2026.9.4 append-log.dive --help
 ```
 ```md
 Usage: nosedive append-log.dive [--label <text>] [--gist <line>] < body
@@ -44,7 +44,7 @@ More: nosedive render f29ec670-caea-5b77-ba51-c7dba1468b0b
 #### [Bail](kb/337b18d6-1cca-57b5-8d26-bb6aef1f50e9.md)
 
 ```sh
-npx -y nosedive@2026.9.3 bail --help
+npx -y nosedive@2026.9.4 bail --help
 ```
 ```md
 Usage: nosedive bail --reason "<why>"
@@ -57,7 +57,7 @@ More: nosedive render 337b18d6-1cca-57b5-8d26-bb6aef1f50e9
 #### [Dehydrate repo](kb/32123800-a61d-5ea1-8b85-98c288b127b3.md)
 
 ```sh
-npx -y nosedive@2026.9.3 dehydrate-repo.workspace --help
+npx -y nosedive@2026.9.4 dehydrate-repo.workspace --help
 ```
 ```md
 Usage: nosedive dehydrate-repo.workspace <repo-id-or-name-or-workspace-path> [--force]
@@ -70,7 +70,7 @@ More: nosedive render 32123800-a61d-5ea1-8b85-98c288b127b3
 #### [Dump backlog](kb/cf4c3d4b-5b5c-5e5d-98e5-af659f591aa1.md)
 
 ```sh
-npx -y nosedive@2026.9.3 dump-backlog --help
+npx -y nosedive@2026.9.4 dump-backlog --help
 ```
 ```md
 Usage: nosedive dump-backlog
@@ -83,12 +83,12 @@ More: nosedive render cf4c3d4b-5b5c-5e5d-98e5-af659f591aa1
 #### [Find](kb/2e5cd9a9-769a-5eda-8617-868c70f13757.md)
 
 ```sh
-npx -y nosedive@2026.9.3 find --help
+npx -y nosedive@2026.9.4 find --help
 ```
 ```md
-Usage: nosedive find <role> [<term>] [--scope <repo>] [--min-age <duration>] [--max-age <duration>]
+Usage: nosedive find <role> [<term>] [--kind <slug>] [--scope <repo>] [--min-age <duration>] [--max-age <duration>]
 
-List backlog-reachable documents by role, optionally filtering by term, scope and age.
+List backlog-reachable documents by role, optionally filtering by term, kind, scope and age.
 
 More: nosedive render 2e5cd9a9-769a-5eda-8617-868c70f13757
 ```
@@ -96,7 +96,7 @@ More: nosedive render 2e5cd9a9-769a-5eda-8617-868c70f13757
 #### [Hydrate repo](kb/c4e93002-2925-58bd-9b70-d917017a9fc7.md)
 
 ```sh
-npx -y nosedive@2026.9.3 hydrate-repo.workspace --help
+npx -y nosedive@2026.9.4 hydrate-repo.workspace --help
 ```
 ```md
 Usage: nosedive hydrate-repo.workspace <repo-id-or-name> [--at <ref>] [--read-only]
@@ -109,7 +109,7 @@ More: nosedive render c4e93002-2925-58bd-9b70-d917017a9fc7
 #### [Jump](kb/f2373f5f-d30d-5d5d-967c-bef56346bbb9.md)
 
 ```sh
-npx -y nosedive@2026.9.3 jump --help
+npx -y nosedive@2026.9.4 jump --help
 ```
 ```md
 Usage: nosedive jump [<dive-ref>]
@@ -122,7 +122,7 @@ More: nosedive render f2373f5f-d30d-5d5d-967c-bef56346bbb9
 #### [Land](kb/587d3f73-2534-5179-b111-ce6c83d6814d.md)
 
 ```sh
-npx -y nosedive@2026.9.3 land --help
+npx -y nosedive@2026.9.4 land --help
 ```
 ```md
 Usage: nosedive land [--hard]
@@ -135,7 +135,7 @@ More: nosedive render 587d3f73-2534-5179-b111-ce6c83d6814d
 #### [List dives](kb/116ff634-3742-51ba-977f-44fc5b21e9e4.md)
 
 ```sh
-npx -y nosedive@2026.9.3 list-dives --help
+npx -y nosedive@2026.9.4 list-dives --help
 ```
 ```md
 Usage: nosedive list-dives [<feat-or-deck>] [--include-historical] [--json]
@@ -148,7 +148,7 @@ More: nosedive render 116ff634-3742-51ba-977f-44fc5b21e9e4
 #### [Mint](kb/e8909eff-aee5-54f2-9ce2-85c2582e39f0.md)
 
 ```sh
-npx -y nosedive@2026.9.3 mint --help
+npx -y nosedive@2026.9.4 mint --help
 ```
 ```md
 Usage: nosedive mint [count] [--ms <utcmillis>] [--ts <iso8601>]
@@ -161,7 +161,7 @@ More: nosedive render e8909eff-aee5-54f2-9ce2-85c2582e39f0
 #### [Note](kb/6274f51e-664f-5b93-a828-52f699161e9a.md)
 
 ```sh
-npx -y nosedive@2026.9.3 note --help
+npx -y nosedive@2026.9.4 note --help
 ```
 ```md
 Usage: nosedive note [<kind>:] <gist words...> [--scope <repo>]... [--title <text>] [--body -]
@@ -174,7 +174,7 @@ More: nosedive render 6274f51e-664f-5b93-a828-52f699161e9a
 #### [Nuke](kb/3570e756-f8e7-5e95-b911-09d7d116cd23.md)
 
 ```sh
-npx -y nosedive@2026.9.3 nuke --help
+npx -y nosedive@2026.9.4 nuke --help
 ```
 ```md
 Usage: nosedive nuke --config|--workspace
@@ -187,7 +187,7 @@ More: nosedive render 3570e756-f8e7-5e95-b911-09d7d116cd23
 #### [Pack](kb/9e28155b-b018-5e00-a3a1-707593167e1e.md)
 
 ```sh
-npx -y nosedive@2026.9.3 pack --help
+npx -y nosedive@2026.9.4 pack --help
 ```
 ```md
 Usage: nosedive pack
@@ -200,7 +200,7 @@ More: nosedive render 9e28155b-b018-5e00-a3a1-707593167e1e
 #### [Plan](kb/162068fe-62ff-5f56-945a-76b24ffeb439.md)
 
 ```sh
-npx -y nosedive@2026.9.3 plan --help
+npx -y nosedive@2026.9.4 plan --help
 ```
 ```md
 Usage: nosedive plan [<context>]
@@ -213,7 +213,7 @@ More: nosedive render 162068fe-62ff-5f56-945a-76b24ffeb439
 #### [Preflight](kb/67187c8d-2e4e-5fc5-b8fd-d0805acd0f2e.md)
 
 ```sh
-npx -y nosedive@2026.9.3 preflight --help
+npx -y nosedive@2026.9.4 preflight --help
 ```
 ```md
 Usage: nosedive preflight
@@ -226,7 +226,7 @@ More: nosedive render 67187c8d-2e4e-5fc5-b8fd-d0805acd0f2e
 #### [Record a dive](kb/c583519a-95c3-59e8-90fd-0d3003b4b8d1.md)
 
 ```sh
-npx -y nosedive@2026.9.3 record.dive --help
+npx -y nosedive@2026.9.4 record.dive --help
 ```
 ```md
 Usage: nosedive record.dive [<dive>] [--ref <dive-ref>] [--feat <feat-ref>] [--effort <feat-ref>] [--gist <gist>] [--title <title>] [--brief <brief>] [--diver <email>] [--takeover] [--packer] [--clear-scopes] [--upscope <repo-ref>]... [--unscope <repo-ref>]... [--work-branch <branch>] [--repin [<ref>]] [--scope <repo-ref>] [--free]
@@ -239,7 +239,7 @@ More: nosedive render c583519a-95c3-59e8-90fd-0d3003b4b8d1
 #### [Record a feat](kb/fb3d90e6-9dbf-5f1c-9919-6653d12fe085.md)
 
 ```sh
-npx -y nosedive@2026.9.3 record.feat --help
+npx -y nosedive@2026.9.4 record.feat --help
 ```
 ```md
 Usage: nosedive record.feat [<feat>] [--gist <gist>] [--name <slug>] [--parent <feat>] [--no-parent] [--scope <repo-ref>]...
@@ -252,7 +252,7 @@ More: nosedive render fb3d90e6-9dbf-5f1c-9919-6653d12fe085
 #### [Record a gate](kb/2c678acb-b4b8-5623-a900-12939da5d472.md)
 
 ```sh
-npx -y nosedive@2026.9.3 record.gate --help
+npx -y nosedive@2026.9.4 record.gate --help
 ```
 ```md
 Usage: nosedive record.gate [<gate>] [--gist <gist>] [--feat <feat-ref>] [--repo <repo-ref>] [--name <slug>] [--height <n>] [--flaky] [--no-flaky] [--note <text>] [--no-note] [--action <test|land>]
@@ -265,7 +265,7 @@ More: nosedive render 2c678acb-b4b8-5623-a900-12939da5d472
 #### [Record a repo](kb/6640f6d5-567d-51bd-b2ba-6239a7a58707.md)
 
 ```sh
-npx -y nosedive@2026.9.3 record.repo --help
+npx -y nosedive@2026.9.4 record.repo --help
 ```
 ```md
 Usage: nosedive record.repo [<repo>] [--remote <clone-url-or-local-path>] [--url <page-url>] [--name <slug>] [--base-branch <branch>]
@@ -278,7 +278,7 @@ More: nosedive render 6640f6d5-567d-51bd-b2ba-6239a7a58707
 #### [Render](kb/9b0241b2-f03f-5594-a537-60a3b4372ee9.md)
 
 ```sh
-npx -y nosedive@2026.9.3 render --help
+npx -y nosedive@2026.9.4 render --help
 ```
 ```md
 Usage: nosedive render <uuid> [--gist]
@@ -291,7 +291,7 @@ More: nosedive render 9b0241b2-f03f-5594-a537-60a3b4372ee9
 #### [Scan](kb/88bf4e10-3fd7-58c0-a247-f2dae9c886e3.md)
 
 ```sh
-npx -y nosedive@2026.9.3 scan --help
+npx -y nosedive@2026.9.4 scan --help
 ```
 ```md
 Usage: nosedive scan --repo <repo-id-or-name>
@@ -304,7 +304,7 @@ More: nosedive render 88bf4e10-3fd7-58c0-a247-f2dae9c886e3
 #### [Seed](kb/34c8e9fb-9629-5767-9a81-914f78c63b68.md)
 
 ```sh
-npx -y nosedive@2026.9.3 seed --help
+npx -y nosedive@2026.9.4 seed --help
 ```
 ```md
 Usage: nosedive seed [--file <path>]... [--headless] [--no-push]
@@ -317,7 +317,7 @@ More: nosedive render 34c8e9fb-9629-5767-9a81-914f78c63b68
 #### [Test](kb/1e62a79d-4e06-552d-be5a-4c59c85f86bf.md)
 
 ```sh
-npx -y nosedive@2026.9.3 test --help
+npx -y nosedive@2026.9.4 test --help
 ```
 ```md
 Usage: nosedive test [--full] [--via <doc-ref>] [<gate-ref>...]
@@ -330,7 +330,7 @@ More: nosedive render 1e62a79d-4e06-552d-be5a-4c59c85f86bf
 #### [Update backlog](kb/f5a5a431-dca3-5e3c-ae84-feb8cd64e96b.md)
 
 ```sh
-npx -y nosedive@2026.9.3 update-backlog --help
+npx -y nosedive@2026.9.4 update-backlog --help
 ```
 ```md
 Usage: nosedive update-backlog [--inject <ref>]...
@@ -343,7 +343,7 @@ More: nosedive render f5a5a431-dca3-5e3c-ae84-feb8cd64e96b
 #### [Whoami](kb/a40303c1-1362-523f-b095-49178354f878.md)
 
 ```sh
-npx -y nosedive@2026.9.3 whoami --help
+npx -y nosedive@2026.9.4 whoami --help
 ```
 ```md
 Usage: nosedive whoami

package/dist/{chunk-4KAAM7JN.js → chunk-NWZNRCX6.js}

@@ -694,8 +694,7 @@ function posixRelPath(from, to) {
   return relative2(from, to).replaceAll("\\", "/");
 }
 function featDocTitle(doc, leafSlug2) {
-  const body = parseMarkdownDoc(readFileSync2(doc.path, "utf8"), formatPath(doc.path)).body;
-  return firstMarkdownHeading(body, titleFromSlug(leafSlug2));
+  return doc.h1 ?? titleFromSlug(leafSlug2);
 }
 function backlogDocTitle(doc) {
   return featDocTitle(doc, doc.name.split(".").filter(Boolean)[0] ?? doc.id);
@@ -1084,11 +1083,12 @@ function readKbDoc(path, bridgeDir) {
     // `featRef` below, so every `doc.kind === "feat"` check downstream (dive
     // ownership, gate feats, repo-feat scoping) works with bridges that still
     // spell it the old way.
-    kind: fm.scalars.kind === "effort" ? "feat" : fm.scalars.kind,
+    kind: fm.scalars.kind === "effort" ? "feat" : fm.scalars.kind ?? "unclassified",
     // A doc with no `gist:` has no gist, not the string `undefined`:
     // the field is typed as present, so every reader would
     // otherwise have to guard a value the type says cannot happen.
     gist: fm.scalars.gist ?? "",
+    h1: /^#\s+(.+?)\s*$/m.exec(text)?.[1]?.trim() || void 0,
     hasBrief: DIVE_BRIEF_HEADING_PATTERN.test(text),
     lastLog: latestLoggedSection(text),
     repoPath: kbMetaPath(fm.nested.meta?.path),
@@ -9317,12 +9317,13 @@ function parseFindArgs(args, io) {
   let minAgeMs;
   let maxAgeMs;
   const scopes = [];
+  const kinds = [];
   const positional = [];
   for (let index = 0; index < args.length; index += 1) {
     const arg = args[index];
     if (arg === "-h" || arg === "--help") {
       printCommandHelp("find", io);
-      return { help: true, scopes };
+      return { help: true, scopes, kinds };
     }
     if (arg === "--min-age") {
       minAgeMs = parseAge(arg, args[++index]);
@@ -9338,6 +9339,12 @@ function parseFindArgs(args, io) {
       scopes.push(value);
       continue;
     }
+    if (arg === "--kind") {
+      const value = args[++index];
+      if (!value) throw new Error("find --kind requires a kind");
+      kinds.push(assertSlug(value, "find --kind"));
+      continue;
+    }
     if (arg.startsWith("--")) throw new Error(`unknown find option: ${arg}`);
     positional.push(arg);
   }
@@ -9348,7 +9355,7 @@ function parseFindArgs(args, io) {
     throw new Error(`unsupported find role: ${role} (expected dive, feat, gate, repo, or note)`);
   if (minAgeMs !== void 0 && maxAgeMs !== void 0 && minAgeMs >= maxAgeMs)
     throw new Error("find --min-age must be shorter than --max-age");
-  return { role, term, minAgeMs, maxAgeMs, scopes, help: false };
+  return { role, term, minAgeMs, maxAgeMs, scopes, kinds, help: false };
 }
 function ageMs(bridgeDir, doc) {
   const path = toPosixPath(relative22(bridgeDir, doc.path));
@@ -9401,8 +9408,8 @@ function findDocs(root, docs, role, term, bridgeDir, options) {
   }
   const normalized = term ? slugFromGist(term, Number.MAX_SAFE_INTEGER) : void 0;
   if (term && !normalized) return [];
-  return [...selected.entries()].map(([id, declaredBy]) => ({ doc: byId.get(id), declaredBy })).filter(
-    ({ doc }) => !normalized || doc.name.includes(normalized) || Boolean(slugFromGist(doc.gist, Number.MAX_SAFE_INTEGER)?.includes(normalized))
+  return [...selected.entries()].map(([id, declaredBy]) => ({ doc: byId.get(id), declaredBy })).filter(({ doc }) => options.kinds.length === 0 || options.kinds.includes(doc.kind)).filter(
+    ({ doc }) => !normalized || doc.name.includes(normalized) || Boolean(slugFromGist(doc.gist, Number.MAX_SAFE_INTEGER)?.includes(normalized)) || Boolean(slugFromGist(doc.h1 ?? "", Number.MAX_SAFE_INTEGER)?.includes(normalized))
   ).filter(
     ({ doc, declaredBy }) => scopeIds.size === 0 || effectiveScopes(doc, declaredBy).some((scope) => scopeIds.has(scope.repoId))
   ).map(({ doc }) => doc).filter((doc) => {
@@ -9416,12 +9423,19 @@ function renderFindResults(role, docs) {
   const heading = `${role.slice(0, 1).toUpperCase()}${role.slice(1)}s`;
   const lines = [`## ${heading}`, ""];
   if (docs.length === 0) lines.push("No matches.");
-  else
-    lines.push(
-      ...docs.map(
-        (doc) => `- [${backlogDocTitle(doc)}](${doc.relPath})${doc.gist ? `: ${doc.gist}` : ""}`
-      )
-    );
+  else {
+    const byKind = /* @__PURE__ */ new Map();
+    for (const doc of docs) byKind.set(doc.kind, [...byKind.get(doc.kind) ?? [], doc]);
+    for (const [index, kind] of [...byKind.keys()].sort((left, right) => left.localeCompare(right)).entries()) {
+      if (index > 0) lines.push("");
+      lines.push(`### ${kind}`, "");
+      lines.push(
+        ...(byKind.get(kind) ?? []).map(
+          (doc) => `- [${backlogDocTitle(doc)}](${doc.relPath})${doc.gist ? `: ${doc.gist}` : ""}`
+        )
+      );
+    }
+  }
   return lines;
 }
 
@@ -9440,7 +9454,8 @@ function run33(args, _runtime) {
     const found = findDocs(root, docs, options.role, options.term, rc.bridgeDir, {
       minAgeMs: options.minAgeMs,
       maxAgeMs: options.maxAgeMs,
-      scopeIds: resolveFindScopes(docs, options.scopes)
+      scopeIds: resolveFindScopes(docs, options.scopes),
+      kinds: options.kinds
     });
     for (const line of renderFindResults(options.role, found)) io.log(line);
   }, args);

package/dist/cli.js

@@ -4,7 +4,7 @@ import {
   renderPackageKbGist,
   runCli,
   uuidLike
-} from "./chunk-4KAAM7JN.js";
+} from "./chunk-NWZNRCX6.js";
 
 // src/cli.ts
 runCli().catch((err) => {

package/dist/nosedive.js

@@ -15,7 +15,7 @@ import {
   reconcileDocLink,
   renderedSurfaceDigest,
   runCli
-} from "./chunk-4KAAM7JN.js";
+} from "./chunk-NWZNRCX6.js";
 export {
   collectDiveGates,
   collectFeatGates,

package/kb/2e5cd9a9-769a-5eda-8617-868c70f13757.md

@@ -2,10 +2,10 @@
 kind: command
 id: 2e5cd9a9-769a-5eda-8617-868c70f13757
 name: find@2
-gist: "List backlog-reachable documents by role, optionally filtering by term, scope and age."
+gist: "List backlog-reachable documents by role, optionally filtering by term, kind, scope and age."
 scopes: []
 meta:
-  usage: nosedive find <role> [<term>] [--scope <repo>] [--min-age <duration>] [--max-age <duration>]
+  usage: nosedive find <role> [<term>] [--kind <slug>] [--scope <repo>] [--min-age <duration>] [--max-age <duration>]
   adapter: kb/artifacts/2e5cd9a9-769a-5eda-8617-868c70f13757.mjs
   entrypoint: L2__find
 ---
@@ -17,9 +17,16 @@ whose relation ends in the requested role. The backlog's scoped repos are
 walked too, so the notes and gates a repo carries are reachable, and they are
 themselves what `find repo` lists -- a repo is named by the backlog's `scopes:`,
 never by a link, so no relation could ever select one. Duplicate targets print
-once. With a term, keep documents whose name or slugified gist contains the
-slugified term. Matches render as backlog entries do: a markdown
-link titled by the document's H1, or by its name where it has none.
+once. With a term, keep documents whose name, slugified gist, or H1 contains
+the slugified term. Matches group under their kind, alphabetically, with the
+existing path order kept within each group. Each match renders as a markdown
+link titled by the document's H1, or by its name where it has none. A document
+without `kind:` is grouped as `unclassified`; legacy `kind: effort` documents
+remain `feat` documents when read.
+
+`--kind <slug>` may be repeated and keeps documents whose own `kind:` matches
+any supplied slug. Kinds are open-ended, so a valid kind not present in the
+selected role simply prints `No matches.` rather than guessing a closed list.
 
 `--scope <repo>` takes a repo name or id, may be repeated, and keeps a document
 that scopes any of the named repos. It also limits which repos are walked.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "nosedive",
-	"version": "2026.9.3",
+	"version": "2026.9.4",
 	"description": "Turns a plain notes repo into a bridge: one repo that holds the plan and drives agentic work across your other repos.",
 	"keywords": [
 		"cli",