wicked-brain 0.17.0 → 0.17.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wicked-brain",
-  "version": "0.17.0",
+  "version": "0.17.2",
   "type": "module",
   "description": "Digital brain as skills for AI coding CLIs — no vector DB, no embeddings, no infrastructure",
   "keywords": [

package/server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wicked-brain-server",
-  "version": "0.17.0",
+  "version": "0.17.2",
   "type": "module",
   "description": "SQLite FTS5 search server for wicked-brain digital knowledge bases",
   "keywords": [

package/skills/wicked-brain-agent/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: wicked-brain:agent
+name: wicked-brain-agent
 description: |
   This skill should be used when the user says "list brain agents",
   "dispatch the consolidation agent", "run brain context assembly",

package/skills/wicked-brain-batch/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: wicked-brain:batch
+name: wicked-brain-batch
 description: |
   Pattern for batch operations that would otherwise fill context with repetitive
   tool calls. Detects the available runtime (Node, Python, shell), writes a

package/skills/wicked-brain-compile/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: wicked-brain:compile
+name: wicked-brain-compile
 description: |
   Synthesize wiki articles from brain chunks. Dispatches a compile subagent
   that identifies concept clusters in chunks and writes structured wiki

package/skills/wicked-brain-configure/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: wicked-brain:configure
+name: wicked-brain-configure
 description: |
   This skill should be used when the user says "configure brain CLI",
   "update CLAUDE.md from brain", "write brain orientation", or

package/skills/wicked-brain-confirm/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: wicked-brain:confirm
+name: wicked-brain-confirm
 description: |
   Confirm or contradict a brain link, adjusting its confidence score.
   Increases confidence when a link is confirmed by evidence, decreases it

package/skills/wicked-brain-dlq/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: wicked-brain:dlq
+name: wicked-brain-dlq
 description: |
   Inspect, replay, or drop dead-lettered events from wicked-brain's bus
   subscriber. The auto-memorize subscriber consumes `wicked.fact.extracted`

package/skills/wicked-brain-enhance/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: wicked-brain:enhance
+name: wicked-brain-enhance
 description: |
   Fill gaps in brain knowledge. Dispatches an enhance subagent that identifies
   thin areas and writes inferred chunks to expand coverage.

package/skills/wicked-brain-forget/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: wicked-brain:forget
+name: wicked-brain-forget
 description: |
   Archive or delete a memory (or any indexed document) by id or path.
   Removes the document from the FTS index and renames the file with an

package/skills/wicked-brain-graph/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: wicked-brain:graph
+name: wicked-brain-graph
 description: |
   Code-relationship graph queries — blast radius, callers, and lineage — backed
   by a codegraph static graph the brain owns. Answers "what breaks if I change X",

package/skills/wicked-brain-ingest/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: wicked-brain:ingest
+name: wicked-brain-ingest
 description: |
   Ingest source files into the brain as structured chunks. Handles text files
   (md, txt, csv, html) deterministically and binary files (pdf, docx, pptx,
@@ -134,11 +134,17 @@ from the path you are already taking:
 - `llm-vision` — the BINARY path above (content extracted by the model viewing
   the document/image).
 
-Use one of the controlled values: `deterministic-parse`, `llm-vision`,
-`llm-synthesis` (model-generated/inferred content), or `manual` (hand-authored).
-The value is plain frontmatter — it is stored and returned verbatim by the
-server with no schema migration. If omitted, downstream lint treats the chunk
-as `method: unknown`; prefer to set it explicitly.
+Use one of the shared controlled values (the same vocabulary across
+`wicked-brain:ingest`, `wicked-brain:memory`, and `wicked-brain:lint`):
+`deterministic-parse`, `llm-vision`, `llm-synthesis`, `session-capture`,
+`manual`, `unknown`. For ingested chunks you will almost always use
+`deterministic-parse` (text) or `llm-vision` (binary); `llm-synthesis` covers
+model-generated/inferred content and `manual` covers hand-authored content.
+`session-capture` applies to memories (see `wicked-brain:memory`), and `unknown`
+is the lint-applied fallback for content written before this field existed. The
+value is plain frontmatter — it is stored and returned verbatim by the server
+with no schema migration. If omitted, downstream lint stamps the chunk as
+`method: unknown`; prefer to set it explicitly.
 
 ## Tag Expansion
 

package/skills/wicked-brain-init/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: wicked-brain:init
+name: wicked-brain-init
 description: |
   Initialize a new digital brain. Creates the directory structure, brain.json,
   and config. Auto-triggered on first use of any brain skill when no config exists.

package/skills/wicked-brain-lint/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: wicked-brain:lint
+name: wicked-brain-lint
 description: |
   Check brain health and fix issues. Dispatches a lint subagent that runs
   deterministic checks (broken links, orphans, stale entries) and semantic
@@ -82,15 +82,18 @@ For each wiki article with source_hashes in frontmatter:
 ### Missing frontmatter
 Check each chunk has required frontmatter fields (source, chunk_id, confidence, indexed_at).
 
-Also check the **provenance** field `method` (how the chunk/memory was obtained:
-`deterministic-parse`, `llm-vision`, `llm-synthesis`, `manual`, or
-`session-capture` for memories). `method` is **optional** — it was added after
-some content was written, so a chunk/memory without it is still valid. When it
-is missing, auto-fix by stamping `method: unknown` and report the fix as `info`
-severity, type `missing_field` (do NOT raise it to a warning/error — that would
-invalidate pre-existing content). Surfacing `method: unknown` lets a reviewer
-distinguish facts with known provenance from those whose origin was never
-recorded.
+Also check the **provenance** field `method` (how the chunk/memory was
+obtained). The shared controlled vocabulary — the same set documented by
+`wicked-brain:ingest` and `wicked-brain:memory` — is: `deterministic-parse`,
+`llm-vision`, `llm-synthesis`, `session-capture`, `manual`, `unknown`. In
+practice `deterministic-parse`/`llm-vision` come from ingested chunks,
+`session-capture` from memories, and `llm-synthesis`/`manual` from either.
+`method` is **optional** — it was added after some content was written, so a
+chunk/memory without it is still valid. When it is missing, auto-fix by
+stamping `method: unknown` and report the fix as `info` severity, type
+`missing_field` (do NOT raise it to a warning/error — that would invalidate
+pre-existing content). Surfacing `method: unknown` lets a reviewer distinguish
+facts with known provenance from those whose origin was never recorded.
 
 Lightweight provenance check (the "no source ⇒ assumption" rule): if a chunk has
 no `source`/`source_path` and its `method` is not one of the inferred kinds

package/skills/wicked-brain-lsp/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: wicked-brain:lsp
+name: wicked-brain-lsp
 description: |
   Universal code intelligence via LSP. Queries language servers for definitions,
   references, symbols, call hierarchies, hover info, and diagnostics. Auto-installs

package/skills/wicked-brain-memory/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: wicked-brain:memory
+name: wicked-brain-memory
 description: |
   Store and recall experiential learnings (decisions, patterns, preferences,
   gotchas, discoveries) in the brain's memory system.
@@ -129,9 +129,17 @@ chunks. Set it from how the memory came to be:
 - `manual` — explicitly stated by the user ("we decided X", interview-style).
 - `llm-synthesis` — inferred/derived by the agent rather than directly observed.
 
+These three are the values you will use for memories. They are drawn from the
+shared controlled vocabulary used across `wicked-brain:ingest`,
+`wicked-brain:memory`, and `wicked-brain:lint`: `deterministic-parse`,
+`llm-vision`, `llm-synthesis`, `session-capture`, `manual`, `unknown`. The
+remaining values (`deterministic-parse`, `llm-vision`) describe ingested
+chunks rather than memories, and `unknown` is the lint-applied fallback for
+content written before this field existed.
+
 Default to `session-capture` when unsure. The value is plain frontmatter,
 stored and returned verbatim by the server (no schema migration). If omitted,
-lint treats the memory as `method: unknown` — prefer to set it explicitly.
+lint stamps the memory as `method: unknown` — prefer to set it explicitly.
 
 #### Tier definitions
 

package/skills/wicked-brain-migrate/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: wicked-brain:migrate
+name: wicked-brain-migrate
 description: |
   Migrate a flat brain at ~/.wicked-brain/ into the per-project layout at
   ~/.wicked-brain/projects/{name}/. Safe to run on already-migrated brains

package/skills/wicked-brain-query/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: wicked-brain:query
+name: wicked-brain-query
 description: |
   Answer questions by searching and synthesizing brain content. Dispatches a
   query subagent that searches, reads, follows links, and produces a cited answer.

package/skills/wicked-brain-read/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: wicked-brain:read
+name: wicked-brain-read
 description: |
   Read a chunk or wiki article from the brain with progressive loading.
   Depth 0: frontmatter + stats. Depth 1: + summary + headings. Depth 2: full content.

package/skills/wicked-brain-retag/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: wicked-brain:retag
+name: wicked-brain-retag
 description: |
   Backfill synonym-expanded tags on chunks and memories that have fewer than
   5 tags. Run periodically or as part of consolidation.

package/skills/wicked-brain-review/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: wicked-brain:review
+name: wicked-brain-review
 description: |
   Browse stored memories with filters on type, tier, and recency. Read-only —
   use wicked-brain:forget to archive or wicked-brain:agent dispatch consolidate

package/skills/wicked-brain-search/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: wicked-brain:search
+name: wicked-brain-search
 description: |
   Search the digital brain for relevant content. A single CLI call for the
   common single-brain case; fans out to linked brains only when they exist.

package/skills/wicked-brain-server/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: wicked-brain:server
+name: wicked-brain-server
 description: |
   Manages the wicked-brain background server. Most callers should use
   `wicked-brain-call` directly — it auto-starts the server. This skill is

package/skills/wicked-brain-status/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: wicked-brain:status
+name: wicked-brain-status
 description: |
   Show brain health, stats, and orientation with progressive loading.
   Depth 0: summary. Depth 1: + topic distribution. Depth 2: full orientation.

package/skills/wicked-brain-synonyms/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: wicked-brain:synonyms
+name: wicked-brain-synonyms
 description: |
   Manage the brain's synonym map for search expansion. Add, remove, or review
   synonym mappings. Can also auto-suggest synonyms from search miss data and

package/skills/wicked-brain-ui/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: wicked-brain:ui
+name: wicked-brain-ui
 description: |
   Open the read-only brain viewer (Material-styled search + wiki browser) in
   the default web browser. Use when the user says "open the brain viewer",

package/skills/wicked-brain-update/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: wicked-brain:update
+name: wicked-brain-update
 description: |
   Check for and install wicked-brain updates. Compares installed version against
   npm registry, updates skills across all detected CLIs, and updates the server.