@zosmaai/pi-llm-wiki 0.11.4 → 0.11.5

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 (48) hide show
  1. package/README.de.md +8 -0
  2. package/README.es.md +8 -0
  3. package/README.fr.md +8 -0
  4. package/README.hi.md +8 -0
  5. package/README.ja.md +8 -0
  6. package/README.ko.md +8 -0
  7. package/README.md +8 -0
  8. package/README.pt.md +8 -0
  9. package/README.ru.md +8 -0
  10. package/README.zh.md +8 -0
  11. package/assets/wiki-dashboard.png +0 -0
  12. package/commands/wiki-ingest.md +1 -0
  13. package/commands/wiki-req.md +1 -0
  14. package/commands/wiki-retro.md +1 -0
  15. package/dist/extensions/llm-wiki/lib/dashboard-command.js +86 -0
  16. package/dist/extensions/llm-wiki/lib/dashboard.js +175 -0
  17. package/dist/extensions/llm-wiki/lib/guardrails.js +30 -1
  18. package/dist/extensions/llm-wiki/lib/host.js +21 -1
  19. package/dist/extensions/llm-wiki/lib/ingest-worker.js +2 -1
  20. package/dist/extensions/llm-wiki/lib/knowledge-document.js +20 -2
  21. package/dist/extensions/llm-wiki/lib/knowledge-links.js +6 -3
  22. package/dist/extensions/llm-wiki/lib/metadata.js +1 -1
  23. package/dist/extensions/llm-wiki/lib/observation.js +22 -3
  24. package/dist/extensions/llm-wiki/lib/settings-command.js +377 -0
  25. package/dist/extensions/llm-wiki/lib/task-config.js +78 -1
  26. package/docs/api.md +24 -1
  27. package/docs/commands.md +6 -1
  28. package/docs/configuration.md +10 -0
  29. package/docs/superpowers/plans/2026-08-09-qmd-retrieval-phase-1-quality-baseline-and-compatibility.md +1520 -0
  30. package/docs/superpowers/roadmaps/2026-08-09-qmd-retrieval-roadmap.md +448 -0
  31. package/docs/superpowers/specs/2026-08-08-qmd-retrieval-design.md +806 -0
  32. package/extensions/llm-wiki/index.ts +4 -0
  33. package/extensions/llm-wiki/lib/dashboard-command.ts +106 -0
  34. package/extensions/llm-wiki/lib/dashboard.ts +210 -0
  35. package/extensions/llm-wiki/lib/guardrails.ts +26 -1
  36. package/extensions/llm-wiki/lib/host.ts +21 -1
  37. package/extensions/llm-wiki/lib/ingest-worker.ts +4 -0
  38. package/extensions/llm-wiki/lib/knowledge-document.ts +20 -2
  39. package/extensions/llm-wiki/lib/knowledge-links.ts +7 -3
  40. package/extensions/llm-wiki/lib/metadata.ts +1 -1
  41. package/extensions/llm-wiki/lib/observation.ts +23 -3
  42. package/extensions/llm-wiki/lib/settings-command.ts +483 -0
  43. package/extensions/llm-wiki/lib/task-config.ts +102 -0
  44. package/package.json +4 -4
  45. package/prompts/wiki-ingest.md +1 -0
  46. package/prompts/wiki-req.md +1 -0
  47. package/prompts/wiki-retro.md +1 -0
  48. package/skills/llm-wiki/SKILL.md +11 -1
package/docs/commands.md CHANGED
@@ -17,10 +17,13 @@
17
17
  | `/wiki-trajectories` | Enable/disable agent working-memory (`on`/`off`, opt-in) |
18
18
  | `/wiki-record` | Capture the completed task's trajectory (requires trajectories enabled) |
19
19
  | `/wiki-skills` | Search distilled skills + past cases (requires trajectories enabled) |
20
+ | `/wiki-req` | Decompose a concept into atomic requirement pages |
21
+ | `/wiki-settings` | Browse or change all `llm-wiki` settings (project or global scope) |
22
+ | `/wiki-dashboard` | Read-only vault health: pages, freshness, activity, ingest queue, backlinks, embeddings |
20
23
 
21
24
  ## Extension Tools
22
25
 
23
- The extension always registers 13 tools the LLM can call directly. The 3 agent-trajectory
26
+ The extension always registers 14 tools the LLM can call directly. The 3 agent-trajectory
24
27
  tools (`wiki_capture_trajectory`, `wiki_distill_skills`, `wiki_recall_skill`) are **opt-in,
25
28
  off by default** (issue #80) — registered only when `llm-wiki.trajectories` is enabled
26
29
  (`/wiki-trajectories on`).
@@ -36,7 +39,9 @@ off by default** (issue #80) — registered only when `llm-wiki.trajectories` is
36
39
  | `wiki_search` | Search the wiki registry |
37
40
  | `wiki_lint` | Health check with auto-fix |
38
41
  | `wiki_status` | Instant stats |
42
+ | `wiki_observe` | Record a timestamped observation from the current session |
39
43
  | `wiki_rebuild_meta` | Force metadata rebuild |
44
+ | `wiki_reindex_embeddings` | Refresh semantic embeddings (no-op when no embedding provider) |
40
45
  | `wiki_log_event` | Record custom event |
41
46
  | `wiki_watch` | Schedule auto-updates |
42
47
  | `wiki_capture_trajectory` | Capture the completed task's tool-call trajectory |
@@ -53,12 +53,22 @@ config directory already exists (host-native first, created if neither is
53
53
  present). A hand-authored `config.yml` is read but never rewritten.
54
54
 
55
55
  | Setting | Default | Description |
56
+ All of the above are viewable and editable in the `/wiki-settings` TUI (persists to project or global settings).
56
57
  | ---------------------- | ---------- | ------------------------------------------------------------ |
57
58
  | `taskModel` | — | Model for background tasks (`{ provider: "openai", id: "gpt-4o" }`) |
58
59
  | `synthesisLanguage` | — | BCP 47 language tag for ingest synthesis (e.g. `"ru"`, `"fr"`). When unset, synthesis defaults to English. |
60
+ | `synthesisMaxTokens` | 16384 | Max output tokens for ingest/synthesis runs (stored as a plain number) |
59
61
  | `trajectories` | false | Enable agent-trajectory working-memory |
60
62
  | `notices` | true | Show wiki activity notices in chat |
61
63
  | `ambientPersonalVault` | host-dependent | Let the personal vault act as the ambient vault in projects that have no wiki. `true` under pi, `false` under oh-my-pi — see below. |
64
+ | `semanticWeight` | 0.5 | Weight of the semantic sub-score in hybrid recall (clamped 0–1) |
65
+ | `recallLinksThreshold` | 50 | Page-count gate for two-stage links-first recall (0 = always links-first, issue #68) |
66
+ | `recallSkillInlineMax` | 1600 | Max chars of a skill/case body inlined into recall output (0 = links only) |
67
+ | `embeddingProvider` | — | Embedding provider (e.g. `openai`); embeddings stay off until this is set |
68
+ | `embeddingModel` | — | Embedding model name (provider-specific) |
69
+ | `embeddingBaseUrl` | — | Optional API base URL override for the embedding provider |
70
+ | `embeddingApiKey` | — | API key literal — prefer `embeddingApiKeyEnv` so no secret lands in settings |
71
+ | `embeddingApiKeyEnv` | — | Name of the environment variable holding the embedding API key |
62
72
 
63
73
  Example:
64
74