@goondocks/myco 0.6.5 → 0.9.0

package/skills/myco/references/vault-status.md

@@ -88,7 +88,7 @@ Read the last line of `<vault>/digest/trace.jsonl`. Each line is a JSON object w
 - `cycleId` — short identifier for the cycle
 - `timestamp` — ISO timestamp of when the cycle ran
 - `tiersGenerated` — which tiers were written
-- `substrateCount` — number of vault notes processed as input
+- `substrateCount` — number of records processed as input
 - `durationMs` — how long the cycle took
 
 **Metabolism config:**
@@ -127,7 +127,7 @@ Check for these problems when assessing vault health:
 | **Stale buffers** | `.jsonl` files in `<vault>/buffer/` older than 24 hours | Events were captured but never processed — LLM may have been unavailable |
 | **Missing index** | `<vault>/index.db` does not exist | FTS search will not work; suggest `node ${CLAUDE_PLUGIN_ROOT}/dist/src/cli.js rebuild` |
 | **Missing vectors** | `<vault>/vectors.db` does not exist | Semantic search disabled; embeddings may be unconfigured |
-| **Old config version** | `version` in `myco.yaml` is less than `2` | Vault may need migration; suggest running `/myco-setup` |
+| **Old config version** | `version` in `myco.yaml` is less than `2` | Vault may need migration; suggest running `myco init` |
 
 Report all issues found, or "None found." if the vault is clean.
 
@@ -221,4 +221,4 @@ Lineage tracks parent-child relationships between sessions. A high count of `sem
 | Stale buffers | Check if LLM provider was down during those sessions; events will process on next daemon start |
 | Missing index | Run `node ${CLAUDE_PLUGIN_ROOT}/dist/src/cli.js rebuild` to regenerate FTS and vector indexes |
 | Provider unreachable | Ensure the provider is running (e.g., `ollama serve`); verify model name in `myco.yaml`; reconfigure with CLI commands |
-| Config version < 2 | Run `/myco-setup` to migrate the vault configuration |
+| Config version < 2 | Run `myco init` to migrate the vault configuration |

package/skills/myco/references/wisdom.md

@@ -2,19 +2,19 @@
 
 When you notice patterns in vault spores — recurring themes, conflicting advice, outdated observations — use these tools to keep the vault clean and its knowledge sharp.
 
-## Automatic Curation
+## Automatic Intelligence
 
 Myco automatically checks for supersession every time a new spore is written. After the spore is saved and embedded, a fire-and-forget pipeline searches for semantically similar active spores of the same observation type and asks the LLM whether any are now outdated. If so, they're marked superseded automatically. This means most vault hygiene happens without manual intervention.
 
 For vault-wide cleanup (e.g., after a large refactor), use the CLI:
 ```sh
-node ${CLAUDE_PLUGIN_ROOT}/dist/src/cli.js curate --dry-run  # preview
-node ${CLAUDE_PLUGIN_ROOT}/dist/src/cli.js curate             # execute
+node ${CLAUDE_PLUGIN_ROOT}/dist/src/cli.js agent --dry-run  # preview
+node ${CLAUDE_PLUGIN_ROOT}/dist/src/cli.js agent             # execute
 ```
 
 ## Supersede
 
-Use `myco_supersede` for manual supersession when you spot a stale spore that automatic curation missed.
+Use `myco_supersede` for manual supersession when you spot a stale spore that automatic intelligence missed.
 
 **Signals:**
 - A decision was reversed in a later session

package/skills/myco-curate/SKILL.md

@@ -0,0 +1,86 @@
+---
+name: myco-curate
+description: >-
+  Trigger the Myco intelligence agent to process unprocessed session data,
+  extract observations, and maintain the vault knowledge graph
+user-invocable: true
+allowed-tools: Bash
+---
+
+# Myco Curate — Run the Intelligence Agent
+
+This skill triggers an intelligence agent run via the daemon API. The intelligence agent processes unprocessed prompt batches, extracts observations (spores), and maintains the vault's knowledge graph.
+
+## Arguments
+
+The user may provide:
+- **task name** — which intelligence task to run (e.g., "full-intelligence", "extraction-only")
+- **instruction** — free-text instruction to guide the agent's focus
+
+Parse the user's message for these. Both are optional.
+
+## Step 1: Resolve Daemon Port
+
+Read the daemon.json file to find the running daemon's port:
+
+```bash
+cat "$(node ${CLAUDE_PLUGIN_ROOT}/dist/src/cli.js stats 2>/dev/null | grep -oP 'path: \K.*' || echo ~/.myco/vaults/myco)/daemon.json" 2>/dev/null
+```
+
+If that fails, use the vault directory from the environment. The daemon.json contains `{ "pid": ..., "port": ... }`. Extract the `port` value.
+
+If the daemon is not running, tell the user:
+
+> "The Myco daemon is not running. Start a new session or run `node ${CLAUDE_PLUGIN_ROOT}/dist/src/cli.js restart` to start it."
+
+## Step 2: Trigger Agent Run
+
+Send a POST request to the daemon API:
+
+```bash
+curl -s -X POST http://localhost:<port>/api/agent/run \
+  -H 'Content-Type: application/json' \
+  -d '{"task": "<task-name-or-null>", "instruction": "<instruction-or-null>"}'
+```
+
+Omit `task` and `instruction` fields from the JSON body if they were not provided by the user.
+
+Report the response to the user. The response will be `{ "ok": true, "message": "Intelligence agent started" }`.
+
+## Step 3: Check Run Status
+
+The intelligence agent runs in the background. To check its progress, poll the runs endpoint:
+
+```bash
+curl -s http://localhost:<port>/api/agent/runs?limit=1
+```
+
+This returns the most recent run. Show the user:
+- **Run ID** — the unique identifier
+- **Status** — pending, running, completed, failed, or skipped
+- **Task** — which task was executed
+- **Tokens used** — total tokens consumed (if completed)
+- **Cost** — USD cost (if completed)
+- **Error** — error message (if failed)
+
+If the run is still `running`, tell the user they can check again later or wait.
+
+## Step 4: Show Reports (if completed)
+
+If the run completed, fetch the decision reports:
+
+```bash
+curl -s http://localhost:<port>/api/agent/runs/<run-id>/reports
+```
+
+Summarize the reports for the user:
+- How many actions were taken
+- What types of actions (extraction, consolidation, supersession, etc.)
+- Key observations or decisions made
+
+## Constraints
+
+- Always use the daemon API, never call the executor directly from the skill.
+- The intelligence agent runs asynchronously — the POST returns immediately.
+- If the user asks for a specific task, pass it in the `task` field.
+- If the user provides natural language guidance, pass it in the `instruction` field.

package/dist/chunk-4B5RO2YV.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/hooks/client.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\nimport { spawn } from 'node:child_process';\nimport { DAEMON_CLIENT_TIMEOUT_MS, DAEMON_HEALTH_CHECK_TIMEOUT_MS, DAEMON_HEALTH_RETRY_DELAYS, DAEMON_STALE_GRACE_PERIOD_MS } from '../constants.js';\nimport { AgentRegistry } from '../agents/registry.js';\nimport { getPluginVersion } from '../version.js';\n\ninterface DaemonInfo {\n  pid: number;\n  port: number;\n}\n\ninterface HealthResponse {\n  myco: boolean;\n  version?: string;\n}\n\ninterface ClientResult {\n  ok: boolean;\n  data?: any;\n}\n\nexport class DaemonClient {\n  private vaultDir: string;\n\n  constructor(vaultDir: string) {\n    this.vaultDir = vaultDir;\n  }\n\n  async post(endpoint: string, body: unknown): Promise<ClientResult> {\n    try {\n      const info = this.readDaemonJson();\n      if (!info) return { ok: false };\n\n      const res = await fetch(`http://127.0.0.1:${info.port}${endpoint}`, {\n        method: 'POST',\n        headers: { 'Content-Type': 'application/json' },\n        body: JSON.stringify(body),\n        signal: AbortSignal.timeout(DAEMON_CLIENT_TIMEOUT_MS),\n      });\n\n      if (!res.ok) return { ok: false };\n      const data = await res.json();\n      return { ok: true, data };\n    } catch {\n      return { ok: false };\n    }\n  }\n\n  async get(endpoint: string): Promise<ClientResult> {\n    try {\n      const info = this.readDaemonJson();\n      if (!info) return { ok: false };\n\n      const res = await fetch(`http://127.0.0.1:${info.port}${endpoint}`, {\n        signal: AbortSignal.timeout(DAEMON_CLIENT_TIMEOUT_MS),\n      });\n\n      if (!res.ok) return { ok: false };\n      const data = await res.json();\n      return { ok: true, data };\n    } catch {\n      return { ok: false };\n    }\n  }\n\n  async isHealthy(): Promise<boolean> {\n    try {\n      const info = this.readDaemonJson();\n      if (!info) return false;\n\n      const res = await fetch(`http://127.0.0.1:${info.port}/health`, {\n        signal: AbortSignal.timeout(DAEMON_HEALTH_CHECK_TIMEOUT_MS),\n      });\n      if (!res.ok) return false;\n      const data = await res.json() as HealthResponse;\n      return data.myco === true;\n    } catch {\n      return false;\n    }\n  }\n\n  /**\n   * Check if the daemon is running a stale version.\n   * Returns true if the daemon's version doesn't match the current plugin version.\n   * Skips the check if daemon.json was written recently (grace period) to prevent\n   * rapid restart loops from concurrent hooks or session reloads.\n   */\n  private async isStale(): Promise<boolean> {\n    try {\n      const jsonPath = path.join(this.vaultDir, 'daemon.json');\n      const stat = fs.statSync(jsonPath);\n      if (Date.now() - stat.mtimeMs < DAEMON_STALE_GRACE_PERIOD_MS) {\n        return false;\n      }\n\n      const info = this.readDaemonJson();\n      if (!info) return false;\n\n      const res = await fetch(`http://127.0.0.1:${info.port}/health`, {\n        signal: AbortSignal.timeout(DAEMON_HEALTH_CHECK_TIMEOUT_MS),\n      });\n      if (!res.ok) return false;\n      const data = await res.json() as HealthResponse;\n      if (!data.myco) return false;\n\n      // No version in response = old daemon that predates this check\n      if (!data.version) return true;\n\n      return data.version !== getPluginVersion();\n    } catch {\n      return false;\n    }\n  }\n\n  /**\n   * Kill the running daemon process.\n   */\n  private killDaemon(): void {\n    try {\n      const info = this.readDaemonJson();\n      if (!info) return;\n      process.kill(info.pid, 'SIGTERM');\n    } catch { /* already dead */ }\n    try {\n      fs.unlinkSync(path.join(this.vaultDir, 'daemon.json'));\n    } catch { /* already gone */ }\n  }\n\n  /**\n   * Ensure the daemon is running. Spawns it if unhealthy.\n   * When checkStale is true (default), also restarts a healthy daemon if its\n   * version doesn't match the current plugin version. Use checkStale: false\n   * for hooks that just need the daemon alive (e.g., stop) without triggering\n   * version-driven restarts.\n   */\n  async ensureRunning(opts?: { checkStale?: boolean }): Promise<boolean> {\n    const checkStale = opts?.checkStale ?? true;\n\n    if (checkStale && await this.isStale()) {\n      this.killDaemon();\n      // Brief pause for port release\n      await new Promise((r) => setTimeout(r, 200));\n    } else if (await this.isHealthy()) {\n      return true;\n    }\n\n    this.spawnDaemon();\n\n    for (const delay of DAEMON_HEALTH_RETRY_DELAYS) {\n      await new Promise((r) => setTimeout(r, delay));\n      if (await this.isHealthy()) return true;\n    }\n    return false;\n  }\n\n  spawnDaemon(): void {\n    const daemonScript = this.resolveDaemonScript();\n    if (!daemonScript || !fs.existsSync(daemonScript)) return;\n\n    const child = spawn('node', [daemonScript, '--vault', this.vaultDir], {\n      detached: true,\n      stdio: 'ignore',\n    });\n    child.unref();\n  }\n\n  /**\n   * Resolve the daemon entry script path.\n   * Priority:\n   * 1. Plugin root env var (set by the agent host) → dist/src/daemon/main.js\n   * 2. Walk up from the current file to find the dist/ directory containing\n   *    the daemon entry. This handles both chunk files (dist/chunk-*.js) and\n   *    thin entry points (dist/src/hooks/*.js) after bundling.\n   */\n  private resolveDaemonScript(): string | undefined {\n    const pluginRoot = new AgentRegistry().resolvePluginRoot();\n    if (pluginRoot) {\n      return path.join(pluginRoot, 'dist', 'src', 'daemon', 'main.js');\n    }\n\n    // Walk up from import.meta.dirname looking for the daemon entry\n    let dir = import.meta.dirname;\n    for (let i = 0; i < 5; i++) {\n      const candidate = path.join(dir, 'dist', 'src', 'daemon', 'main.js');\n      if (fs.existsSync(candidate)) return candidate;\n      // Also check if we're already inside dist/\n      const inDist = path.join(dir, 'src', 'daemon', 'main.js');\n      if (fs.existsSync(inDist)) return inDist;\n      dir = path.dirname(dir);\n    }\n    return undefined;\n  }\n\n  private readDaemonJson(): DaemonInfo | null {\n    try {\n      const jsonPath = path.join(this.vaultDir, 'daemon.json');\n      const content = fs.readFileSync(jsonPath, 'utf-8');\n      const info = JSON.parse(content);\n      if (typeof info.port !== 'number') return null;\n      return info as DaemonInfo;\n    } catch {\n      return null;\n    }\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-4RMSHZE4.js

@@ -1,107 +0,0 @@
-import { createRequire as __cr } from 'node:module'; const require = __cr(import.meta.url);
-
-// src/index/vectors.ts
-import Database from "better-sqlite3";
-import * as sqliteVec from "sqlite-vec";
-var VectorIndex = class {
-  db;
-  dimensions;
-  constructor(dbPath, dimensions) {
-    this.dimensions = dimensions;
-    this.db = new Database(dbPath);
-    sqliteVec.load(this.db);
-    this.init();
-  }
-  init() {
-    this.db.exec(`
-      CREATE TABLE IF NOT EXISTS vec_metadata (
-        id TEXT PRIMARY KEY,
-        type TEXT NOT NULL DEFAULT '',
-        importance TEXT NOT NULL DEFAULT '',
-        session_id TEXT NOT NULL DEFAULT '',
-        file_path TEXT NOT NULL DEFAULT '',
-        branch TEXT NOT NULL DEFAULT '',
-        created TEXT NOT NULL DEFAULT (datetime('now'))
-      );
-      CREATE VIRTUAL TABLE IF NOT EXISTS vec_embeddings USING vec0(
-        id TEXT PRIMARY KEY,
-        embedding float[${this.dimensions}]
-      );
-    `);
-  }
-  upsert(id, embedding, metadata = {}) {
-    this.db.prepare("DELETE FROM vec_metadata WHERE id = ?").run(id);
-    this.db.prepare("DELETE FROM vec_embeddings WHERE id = ?").run(id);
-    this.db.prepare(
-      "INSERT INTO vec_metadata (id, type, importance, session_id, file_path, branch) VALUES (?, ?, ?, ?, ?, ?)"
-    ).run(id, metadata.type ?? "", metadata.importance ?? "", metadata.session_id ?? "", metadata.file_path ?? "", metadata.branch ?? "");
-    this.db.prepare("INSERT INTO vec_embeddings (id, embedding) VALUES (?, ?)").run(id, new Float32Array(embedding));
-  }
-  search(query, options = {}) {
-    const limit = options.limit ?? 10;
-    const knnParams = [new Float32Array(query), limit * 4];
-    const knnRows = this.db.prepare(`
-      SELECT id, distance
-      FROM vec_embeddings
-      WHERE embedding MATCH ?
-      ORDER BY distance
-      LIMIT ?
-    `).all(...knnParams);
-    if (knnRows.length === 0) return [];
-    const metaConditions = ["id IN (" + knnRows.map(() => "?").join(",") + ")"];
-    const metaParams = knnRows.map((r) => r.id);
-    if (options.type) {
-      metaConditions.push("type = ?");
-      metaParams.push(options.type);
-    }
-    if (options.importance) {
-      metaConditions.push("importance = ?");
-      metaParams.push(options.importance);
-    }
-    const metaRows = this.db.prepare(`
-      SELECT id, type, importance, session_id, file_path, branch
-      FROM vec_metadata
-      WHERE ${metaConditions.join(" AND ")}
-    `).all(...metaParams);
-    const metaMap = new Map(metaRows.map((m) => [m.id, m]));
-    const scored = knnRows.filter((r) => metaMap.has(r.id)).map((r) => {
-      const m = metaMap.get(r.id);
-      return {
-        id: r.id,
-        similarity: 1 - r.distance,
-        metadata: { type: m.type, importance: m.importance, session_id: m.session_id, file_path: m.file_path, branch: m.branch }
-      };
-    });
-    if (scored.length === 0) return [];
-    const topScore = scored[0].similarity;
-    const threshold = options.relativeThreshold ?? 0.5;
-    const floor = topScore * threshold;
-    return scored.filter((r) => r.similarity >= floor).slice(0, limit);
-  }
-  /** Retrieve the stored embedding for a given ID, or null if not found. */
-  getEmbedding(id) {
-    const row = this.db.prepare("SELECT embedding FROM vec_embeddings WHERE id = ?").get(id);
-    if (!row) return null;
-    return Array.from(new Float32Array(row.embedding.buffer, row.embedding.byteOffset, row.embedding.byteLength / 4));
-  }
-  /** Check whether an embedding exists for the given ID. */
-  has(id) {
-    const row = this.db.prepare("SELECT 1 FROM vec_metadata WHERE id = ?").get(id);
-    return row !== void 0;
-  }
-  delete(id) {
-    this.db.prepare("DELETE FROM vec_metadata WHERE id = ?").run(id);
-    this.db.prepare("DELETE FROM vec_embeddings WHERE id = ?").run(id);
-  }
-  count() {
-    return this.db.prepare("SELECT COUNT(*) as c FROM vec_metadata").get().c;
-  }
-  close() {
-    this.db.close();
-  }
-};
-
-export {
-  VectorIndex
-};
-//# sourceMappingURL=chunk-4RMSHZE4.js.map

package/dist/chunk-4RMSHZE4.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/index/vectors.ts"],"sourcesContent":["import Database from 'better-sqlite3';\nimport * as sqliteVec from 'sqlite-vec';\n\nexport interface VectorSearchResult {\n  id: string;\n  similarity: number;\n  metadata: Record<string, string>;\n}\n\nexport interface VectorSearchOptions {\n  limit?: number;\n  /** Drop results below this fraction of the top result's score (0-1). Default 0.5. */\n  relativeThreshold?: number;\n  type?: string;\n  importance?: string;\n}\n\nexport class VectorIndex {\n  private db: Database.Database;\n  private dimensions: number;\n\n  constructor(dbPath: string, dimensions: number) {\n    this.dimensions = dimensions;\n    this.db = new Database(dbPath);\n    sqliteVec.load(this.db);\n    this.init();\n  }\n\n  private init(): void {\n    this.db.exec(`\n      CREATE TABLE IF NOT EXISTS vec_metadata (\n        id TEXT PRIMARY KEY,\n        type TEXT NOT NULL DEFAULT '',\n        importance TEXT NOT NULL DEFAULT '',\n        session_id TEXT NOT NULL DEFAULT '',\n        file_path TEXT NOT NULL DEFAULT '',\n        branch TEXT NOT NULL DEFAULT '',\n        created TEXT NOT NULL DEFAULT (datetime('now'))\n      );\n      CREATE VIRTUAL TABLE IF NOT EXISTS vec_embeddings USING vec0(\n        id TEXT PRIMARY KEY,\n        embedding float[${this.dimensions}]\n      );\n    `);\n  }\n\n  upsert(id: string, embedding: number[], metadata: Record<string, string> = {}): void {\n    this.db.prepare('DELETE FROM vec_metadata WHERE id = ?').run(id);\n    this.db.prepare('DELETE FROM vec_embeddings WHERE id = ?').run(id);\n\n    this.db.prepare(\n      'INSERT INTO vec_metadata (id, type, importance, session_id, file_path, branch) VALUES (?, ?, ?, ?, ?, ?)',\n    ).run(id, metadata.type ?? '', metadata.importance ?? '', metadata.session_id ?? '', metadata.file_path ?? '', metadata.branch ?? '');\n\n    this.db.prepare('INSERT INTO vec_embeddings (id, embedding) VALUES (?, ?)').run(id, new Float32Array(embedding));\n  }\n\n  search(query: number[], options: VectorSearchOptions = {}): VectorSearchResult[] {\n    const limit = options.limit ?? 10;\n\n    // vec0 KNN queries require LIMIT to be a direct constraint on the virtual table.\n    // JOINs with additional WHERE filters confuse the query planner, so we use a\n    // subquery to get KNN candidates first, then filter by metadata in the outer query.\n    const knnParams: unknown[] = [new Float32Array(query), limit * 4];\n    const knnRows = this.db.prepare(`\n      SELECT id, distance\n      FROM vec_embeddings\n      WHERE embedding MATCH ?\n      ORDER BY distance\n      LIMIT ?\n    `).all(...knnParams) as Array<{ id: string; distance: number }>;\n\n    if (knnRows.length === 0) return [];\n\n    // Now fetch metadata for the candidates and apply optional filters\n    const metaConditions: string[] = ['id IN (' + knnRows.map(() => '?').join(',') + ')'];\n    const metaParams: unknown[] = knnRows.map((r) => r.id);\n\n    if (options.type) { metaConditions.push('type = ?'); metaParams.push(options.type); }\n    if (options.importance) { metaConditions.push('importance = ?'); metaParams.push(options.importance); }\n\n    const metaRows = this.db.prepare(`\n      SELECT id, type, importance, session_id, file_path, branch\n      FROM vec_metadata\n      WHERE ${metaConditions.join(' AND ')}\n    `).all(...metaParams) as Array<{ id: string; type: string; importance: string; session_id: string; file_path: string; branch: string }>;\n\n    const metaMap = new Map(metaRows.map((m) => [m.id, m]));\n\n    const scored = knnRows\n      .filter((r) => metaMap.has(r.id))\n      .map((r) => {\n        const m = metaMap.get(r.id)!;\n        return {\n          id: r.id,\n          similarity: 1 - r.distance,\n          metadata: { type: m.type, importance: m.importance, session_id: m.session_id, file_path: m.file_path, branch: m.branch },\n        };\n      });\n\n    if (scored.length === 0) return [];\n\n    // Relative threshold: drop results below a fraction of the best score.\n    // Adapts automatically to any embedding model's score distribution.\n    const topScore = scored[0].similarity;\n    const threshold = options.relativeThreshold ?? 0.5;\n    const floor = topScore * threshold;\n\n    return scored\n      .filter((r) => r.similarity >= floor)\n      .slice(0, limit);\n  }\n\n  /** Retrieve the stored embedding for a given ID, or null if not found. */\n  getEmbedding(id: string): number[] | null {\n    const row = this.db.prepare('SELECT embedding FROM vec_embeddings WHERE id = ?').get(id) as { embedding: Buffer } | undefined;\n    if (!row) return null;\n    return Array.from(new Float32Array(row.embedding.buffer, row.embedding.byteOffset, row.embedding.byteLength / 4));\n  }\n\n  /** Check whether an embedding exists for the given ID. */\n  has(id: string): boolean {\n    const row = this.db.prepare('SELECT 1 FROM vec_metadata WHERE id = ?').get(id);\n    return row !== undefined;\n  }\n\n  delete(id: string): void {\n    this.db.prepare('DELETE FROM vec_metadata WHERE id = ?').run(id);\n    this.db.prepare('DELETE FROM vec_embeddings WHERE id = ?').run(id);\n  }\n\n  count(): number {\n    return (this.db.prepare('SELECT COUNT(*) as c FROM vec_metadata').get() as { c: number }).c;\n  }\n\n  close(): void { this.db.close(); }\n}\n"],"mappings":"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","names":[]}