@goondocks/myco 0.27.18 → 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.
- package/dist/ui/assets/{index-Dri_UAax.js → index-GRKrkWAI.js} +2 -2
- package/dist/ui/index.html +1 -1
- package/package.json +6 -6
- package/skills/myco/SKILL.md +29 -18
- package/skills/myco/references/cli-usage.md +43 -88
- package/skills/myco/references/reconfiguration.md +47 -59
- package/skills/myco/references/vault-status.md +21 -40
- package/skills/myco/references/wisdom.md +2 -2
|
@@ -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
|
|
5
|
+
**Primary data source:** `node .agents/myco-cli.cjs stats`
|
|
6
6
|
|
|
7
|
-
Supplement with `logs` for recent daemon activity and
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
-
|
|
75
|
+
Use `myco_cortex` to request the tier you care about:
|
|
76
76
|
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
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
|
-
-
|
|
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
|
|
88
|
+
Test connectivity to the configured embedding provider:
|
|
108
89
|
|
|
109
90
|
```sh
|
|
110
|
-
node
|
|
91
|
+
node .agents/myco-cli.cjs verify
|
|
111
92
|
```
|
|
112
93
|
|
|
113
|
-
This reports whether the
|
|
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
|
|
117
|
-
- Re-run configuration with
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
12
|
-
node
|
|
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
|