@titan-design/brain 0.6.1 → 0.7.0

package/README.md

@@ -46,53 +46,53 @@ See [PM Quick Start](docs/pm-module/quickstart.md) for the full 5-minute guide.
 
 ### Core
 
-| Command | Description |
-|---------|-------------|
-| `brain init` | Initialize workspace and database |
-| `brain index` | Index all markdown notes |
-| `brain search "query"` | Hybrid BM25 + vector search |
-| `brain add <file>` | Add a note from file or stdin |
-| `brain quick "text"` | Zero-friction capture to inbox |
-| `brain inbox` | View/manage inbox items |
-| `brain import <paths>` | Smart import with three-tier extraction (`--dry-run`, `--tier`) |
-| `brain ingest` | Bulk-import files to inbox |
-| `brain feed` | Manage RSS feed subscriptions |
-| `brain extract` | Extract memories from notes (Ollama) |
-| `brain memories` | List, history, and stats for memories |
-| `brain context <id>` | Show context for a note (relations + memories) |
-| `brain lineage <id>` | Show memory version lineage |
-| `brain profile` | Generate agent context profile |
-| `brain tidy` | LLM-powered note cleanup suggestions |
-| `brain doctor` | System health checks (`--fix` for auto-repair) |
-| `brain install-hooks` | Set up launchd/systemd scheduled processing |
-| `brain status` | Database stats |
-| `brain stale` | Notes needing review |
-| `brain graph <id>` | Show note relations |
-| `brain template <type>` | Output frontmatter template |
-| `brain archive` | Archive expired notes |
-| `brain config` | View/set configuration |
+| Command                 | Description                                                     |
+| ----------------------- | --------------------------------------------------------------- |
+| `brain init`            | Initialize workspace and database                               |
+| `brain index`           | Index all markdown notes                                        |
+| `brain search "query"`  | Hybrid BM25 + vector search                                     |
+| `brain add <file>`      | Add a note from file or stdin                                   |
+| `brain quick "text"`    | Zero-friction capture to inbox                                  |
+| `brain inbox`           | View/manage inbox items                                         |
+| `brain import <paths>`  | Smart import with three-tier extraction (`--dry-run`, `--tier`) |
+| `brain ingest`          | Bulk-import files to inbox                                      |
+| `brain feed`            | Manage RSS feed subscriptions                                   |
+| `brain extract`         | Extract memories from notes (Ollama)                            |
+| `brain memories`        | List, history, and stats for memories                           |
+| `brain context <id>`    | Show context for a note (relations + memories)                  |
+| `brain lineage <id>`    | Show memory version lineage                                     |
+| `brain profile`         | Generate agent context profile                                  |
+| `brain tidy`            | LLM-powered note cleanup suggestions                            |
+| `brain doctor`          | System health checks (`--fix` for auto-repair)                  |
+| `brain install-hooks`   | Set up launchd/systemd scheduled processing                     |
+| `brain status`          | Database stats                                                  |
+| `brain stale`           | Notes needing review                                            |
+| `brain graph <id>`      | Show note relations                                             |
+| `brain template <type>` | Output frontmatter template                                     |
+| `brain archive`         | Archive expired notes                                           |
+| `brain config`          | View/set configuration                                          |
 
 ### Project Management (`brain pm`)
 
-| Command | Description |
-|---------|-------------|
-| `brain pm init <name> --prefix <P>` | Initialize a new project |
-| `brain pm use <prefix>` | Set active project context |
-| `brain pm list` | List all projects |
-| `brain pm status [prefix]` | Show project status |
-| `brain pm workstream add <name>` | Add a workstream |
-| `brain pm task add <name>` | Create a task |
-| `brain pm task list` | List tasks (filterable by status, workstream) |
-| `brain pm task done <id>` | Mark task done |
-| `brain pm next` | Show eligible tasks (all deps satisfied) |
-| `brain pm waves` | Topological wave grouping of remaining tasks |
-| `brain pm dispatch <id>` | Assemble context bundle for a task |
-| `brain pm complete <id>` | Mark done, run impact analysis |
-| `brain pm briefing` | Session briefing with project state overview |
-| `brain pm audit summary` | Activity log, cost tracking |
-| `brain pm check [--deep]` | Consistency check (structural + semantic analysis) |
-| `brain pm setup` | Configure PM module (paths, hooks) |
-| `brain pm install-hooks` | Install PM hooks and skills (orchestrator + sanity-check) |
+| Command                             | Description                                               |
+| ----------------------------------- | --------------------------------------------------------- |
+| `brain pm init <name> --prefix <P>` | Initialize a new project                                  |
+| `brain pm use <prefix>`             | Set active project context                                |
+| `brain pm list`                     | List all projects                                         |
+| `brain pm status [prefix]`          | Show project status                                       |
+| `brain pm workstream add <name>`    | Add a workstream                                          |
+| `brain pm task add <name>`          | Create a task                                             |
+| `brain pm task list`                | List tasks (filterable by status, workstream)             |
+| `brain pm task done <id>`           | Mark task done                                            |
+| `brain pm next`                     | Show eligible tasks (all deps satisfied)                  |
+| `brain pm waves`                    | Topological wave grouping of remaining tasks              |
+| `brain pm dispatch <id>`            | Assemble context bundle for a task                        |
+| `brain pm complete <id>`            | Mark done, run impact analysis                            |
+| `brain pm briefing`                 | Session briefing with project state overview              |
+| `brain pm audit summary`            | Activity log, cost tracking                               |
+| `brain pm check [--deep]`           | Consistency check (structural + semantic analysis)        |
+| `brain pm setup`                    | Configure PM module (paths, hooks)                        |
+| `brain pm install-hooks`            | Install PM hooks and skills (orchestrator + sanity-check) |
 
 ## Architecture
 
@@ -148,6 +148,28 @@ Brain indexes markdown files with YAML frontmatter into a SQLite database. It co
 - `slow` — permanent knowledge (decisions, patterns, research) with review intervals
 - `fast` — ephemeral (meetings, session logs) with expiry dates
 
+### Knowledge Graph
+
+Link related notes and traverse connections:
+
+1. Add `related` field to YAML frontmatter:
+   ```yaml
+   related:
+     - database-migration-patterns
+     - service-architecture-overview
+   ```
+2. Re-index after adding relations: `brain index`
+3. Traverse the graph:
+   ```bash
+   brain graph <note-id>           # Show direct relations
+   brain graph <note-id> --depth 2 # Show 2-hop connections
+   brain graph <note-id> --json    # Machine-readable output
+   ```
+4. Use `--expand` in search to include graph-connected notes:
+   ```bash
+   brain search "query" --expand
+   ```
+
 ## Testing
 
 ```bash

package/dist/{brain-service-4ETWBOIO.js → brain-service-TYFNTBT6.js}

@@ -1,9 +1,9 @@
 import {
   withBrain,
   withDb
-} from "./chunk-HNC656YT.js";
+} from "./chunk-IESQY2UZ.js";
 import "./chunk-BDNH2E2O.js";
-import "./chunk-AJKFX2TM.js";
+import "./chunk-LLAHWRO4.js";
 import "./chunk-PO3GJPIC.js";
 export {
   withBrain,

package/dist/{chunk-KSJZ7CMP.js → chunk-4GDSQB2E.js}

@@ -1,6 +1,6 @@
 import {
   addFrontmatterField
-} from "./chunk-AJKFX2TM.js";
+} from "./chunk-LLAHWRO4.js";
 
 // src/services/search.ts
 import { existsSync } from "fs";

package/dist/{chunk-HNC656YT.js → chunk-IESQY2UZ.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-BDNH2E2O.js";
 import {
   addFrontmatterField
-} from "./chunk-AJKFX2TM.js";
+} from "./chunk-LLAHWRO4.js";
 
 // src/services/config.ts
 import { readFileSync, writeFileSync, mkdirSync, existsSync, copyFileSync } from "fs";
@@ -1667,9 +1667,7 @@ var ModuleRegistry = class {
   // --- Import Hints ---
   /** Returns all note types that have importHints configured */
   getImportableNoteTypes() {
-    return this.getAllNoteTypes().filter(
-      ({ noteType }) => noteType.importHints
-    );
+    return this.getAllNoteTypes().filter(({ noteType }) => noteType.importHints);
   }
   /** Match CSV/table column headers against registered tableColumnAliases.
    *  Returns the best-matching note type if 2+ columns match, else null. */
@@ -1694,7 +1692,11 @@ var ModuleRegistry = class {
         bestMatch = { module, noteType: noteType.name, columnMapping: mapping, hits };
       }
     }
-    return bestMatch ? { module: bestMatch.module, noteType: bestMatch.noteType, columnMapping: bestMatch.columnMapping } : null;
+    return bestMatch ? {
+      module: bestMatch.module,
+      noteType: bestMatch.noteType,
+      columnMapping: bestMatch.columnMapping
+    } : null;
   }
   /** Returns archetype texts for embedding-based classification */
   getArchetypeTexts() {

package/dist/{chunk-AJKFX2TM.js → chunk-LLAHWRO4.js}

@@ -18,7 +18,8 @@ var VALID_CORE_NOTE_TYPES = [
   "research",
   "meeting",
   "session-log",
-  "guide"
+  "guide",
+  "workflow"
 ];
 var VALID_NOTE_TIERS = ["slow", "fast"];
 var VALID_NOTE_CONFIDENCES = ["high", "medium", "low", "speculative"];