@goondocks/myco 0.27.17 → 0.27.19

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.
@@ -2,9 +2,9 @@
2
2
 
3
3
  This reference guides vault health assessment. Use it whenever you need to inspect the state of the Myco vault — whether debugging a problem, responding to a user's question about their vault, or running a routine check.
4
4
 
5
- **Primary data source:** `node ${CLAUDE_PLUGIN_ROOT}/dist/src/cli.js stats`
5
+ **Primary data source:** `node .agents/myco-cli.cjs stats`
6
6
 
7
- Supplement with `logs` for recent daemon activity and direct file checks for digest status.
7
+ Supplement with `logs` for recent daemon activity and `myco_cortex` for Cortex/digest status.
8
8
 
9
9
  ---
10
10
 
@@ -13,7 +13,7 @@ Supplement with `logs` for recent daemon activity and direct file checks for dig
13
13
  Run the stats command to get a snapshot of vault state:
14
14
 
15
15
  ```sh
16
- node ${CLAUDE_PLUGIN_ROOT}/dist/src/cli.js stats
16
+ node .agents/myco-cli.cjs stats
17
17
  ```
18
18
 
19
19
  The output includes:
@@ -55,7 +55,7 @@ The daemon runs as a background HTTP process. Its state is persisted in `<vault>
55
55
  You can also restart it manually:
56
56
 
57
57
  ```sh
58
- node ${CLAUDE_PLUGIN_ROOT}/dist/src/cli.js restart
58
+ node .agents/myco-cli.cjs restart
59
59
  ```
60
60
 
61
61
  Do not treat a stopped daemon as a vault error — it is normal between sessions. The daemon starts on demand when a session begins.
@@ -64,57 +64,38 @@ Do not treat a stopped daemon as a vault error — it is normal between sessions
64
64
 
65
65
  ## Digest Status
66
66
 
67
- The digest system synthesizes vault knowledge into pre-computed context extracts. Check its state with direct file inspection.
67
+ The digest system synthesizes vault knowledge into pre-computed context extracts served through Cortex.
68
68
 
69
69
  **Is digest enabled?**
70
70
 
71
- Read `digest.enabled` from `<vault>/myco.yaml`. If false or absent, skip digest checks.
71
+ Read scoped Cortex config through the UI or config surface. The session-start toggles are under `cortex.instructions.*` and `cortex.digest.*`.
72
72
 
73
73
  **Which extracts exist?**
74
74
 
75
- List files in `<vault>/digest/`:
75
+ Use `myco_cortex` to request the tier you care about:
76
76
 
77
- - `extract-1500.md` — ~1500 token tier
78
- - `extract-3000.md` ~3000 token tier
79
- - `extract-5000.md` ~5000 token tier
80
- - `extract-10000.md` — ~10000 token tier
81
-
82
- Report each file's size and last-modified timestamp. Missing tiers mean the digest has not yet run for that tier, or the tier is not configured.
83
-
84
- **Last digest cycle:**
85
-
86
- Read the last line of `<vault>/digest/trace.jsonl`. Each line is a JSON object with:
87
-
88
- - `cycleId` — short identifier for the cycle
89
- - `timestamp` — ISO timestamp of when the cycle ran
90
- - `tiersGenerated` — which tiers were written
91
- - `substrateCount` — number of records processed as input
92
- - `durationMs` — how long the cycle took
93
-
94
- **Metabolism config:**
95
-
96
- From `myco.yaml`, report:
77
+ ```sh
78
+ node .agents/myco-cli.cjs tool call myco_cortex --json --input '{"op":"digest","tier":1500}'
79
+ node .agents/myco-cli.cjs tool call myco_cortex --json --input '{"op":"digest","tier":5000}'
80
+ ```
97
81
 
98
- - Configured tiers (e.g., `[1500, 3000, 5000, 10000]`)
99
- - Inject tier — which tier is injected at session start
100
- - Context window size
101
- - Digest model — if `digest.intelligence.model` is set, report it; otherwise note "inherits from main LLM"
82
+ Missing or not-ready responses mean the digest has not been generated for that tier yet or Cortex is disabled for the project.
102
83
 
103
84
  ---
104
85
 
105
86
  ## Intelligence Backend Health
106
87
 
107
- Test connectivity to the configured LLM and embedding providers:
88
+ Test connectivity to the configured embedding provider:
108
89
 
109
90
  ```sh
110
- node ${CLAUDE_PLUGIN_ROOT}/dist/src/cli.js verify
91
+ node .agents/myco-cli.cjs verify
111
92
  ```
112
93
 
113
- This reports whether the LLM provider and embedding provider are reachable. If either is unreachable:
94
+ This reports whether the embedding provider is reachable. The Myco agent LLM is managed by the agent harness. If embedding verification fails:
114
95
 
115
96
  - Check that the provider process is running (Ollama, LM Studio, etc.)
116
- - Review the model name in `myco.yaml` for typos
117
- - Re-run configuration with the appropriate CLI setup command
97
+ - Review Grove-tier embedding settings with `node .agents/myco-cli.cjs setup-llm --show`
98
+ - Re-run configuration with `setup-llm`
118
99
 
119
100
  ---
120
101
 
@@ -127,7 +108,7 @@ Check for these problems when assessing vault health:
127
108
  | **Stale buffers** | `.jsonl` files in `<vault>/buffer/` older than 24 hours | Events were captured but never processed — LLM may have been unavailable |
128
109
  | **Missing vault DB** | `<vault>/myco.db` does not exist | The vault database is missing or the project is not initialized; suggest `myco init` or check vault resolution |
129
110
  | **Missing vectors** | `<vault>/vectors.db` does not exist | Semantic search disabled; embeddings may be unconfigured |
130
- | **Old config version** | `version` in `myco.yaml` is less than `2` | Vault may need migration; suggest running `myco init` |
111
+ | **Old config version** | `version` in `myco.yaml` is stale | Vault may need migration; suggest running `myco init` or `myco update` |
131
112
 
132
113
  Report all issues found, or "None found." if the vault is clean.
133
114
 
@@ -138,7 +119,7 @@ Report all issues found, or "None found." if the vault is clean.
138
119
  View recent daemon log output:
139
120
 
140
121
  ```sh
141
- node ${CLAUDE_PLUGIN_ROOT}/dist/src/cli.js logs -n 20
122
+ node .agents/myco-cli.cjs logs -n 20
142
123
  ```
143
124
 
144
125
  This shows the last 20 lines of daemon logs — useful for spotting errors, slow processing, or repeated failures.
@@ -217,8 +198,8 @@ Lineage tracks parent-child relationships between sessions. A high count of `sem
217
198
 
218
199
  | Issue | Action |
219
200
  |-------|--------|
220
- | Daemon not running | Will auto-start on next session; or run `node ${CLAUDE_PLUGIN_ROOT}/dist/src/cli.js restart` |
201
+ | Daemon not running | Will auto-start on next session; or run `node .agents/myco-cli.cjs restart` |
221
202
  | Stale buffers | Check if LLM provider was down during those sessions; events will process on next daemon start |
222
- | Missing index | Run `node ${CLAUDE_PLUGIN_ROOT}/dist/src/cli.js rebuild` to regenerate FTS and vector indexes |
203
+ | Missing index | Run `node .agents/myco-cli.cjs rebuild` to regenerate FTS and vector indexes |
223
204
  | Provider unreachable | Ensure the provider is running (e.g., `ollama serve`); verify model name in `myco.yaml`; reconfigure with CLI commands |
224
205
  | Config version < 2 | Run `myco init` to migrate the vault configuration |
@@ -8,8 +8,8 @@ Myco automatically checks for supersession every time a new spore is written. Af
8
8
 
9
9
  For vault-wide cleanup (e.g., after a large refactor), use the CLI:
10
10
  ```sh
11
- node ${CLAUDE_PLUGIN_ROOT}/dist/src/cli.js agent --dry-run # preview
12
- node ${CLAUDE_PLUGIN_ROOT}/dist/src/cli.js agent # execute
11
+ node .agents/myco-cli.cjs agent --dry-run # preview
12
+ node .agents/myco-cli.cjs agent # execute
13
13
  ```
14
14
 
15
15
  ## Supersede