wyrm-mcp 7.2.0 → 7.2.2

package/dist/performance.js

@@ -1,228 +1 @@
-/**
- * 󱅝 Wyrm Performance Layer v2
- * LRU caching, prepared statement pooling, response optimization
- */
-// LRU cache with TTL + max size eviction
-class MemCache {
-    cache = new Map();
-    defaultTTL;
-    maxSize;
-    hits = 0;
-    misses = 0;
-    constructor(ttlSeconds = 60, maxEntries = 256) {
-        this.defaultTTL = ttlSeconds * 1000;
-        this.maxSize = maxEntries;
-        // Periodic cleanup of expired entries (every 30s)
-        if (typeof setInterval !== 'undefined') {
-            setInterval(() => this.evictExpired(), 30_000).unref?.();
-        }
-    }
-    get(key) {
-        const entry = this.cache.get(key);
-        if (!entry) {
-            this.misses++;
-            return undefined;
-        }
-        if (Date.now() > entry.expires) {
-            this.cache.delete(key);
-            this.misses++;
-            return undefined;
-        }
-        this.hits++;
-        entry.lastAccess = Date.now();
-        return entry.data;
-    }
-    set(key, data, ttlMs) {
-        // LRU eviction when at capacity
-        if (this.cache.size >= this.maxSize && !this.cache.has(key)) {
-            this.evictLRU();
-        }
-        this.cache.set(key, {
-            data,
-            expires: Date.now() + (ttlMs ?? this.defaultTTL),
-            lastAccess: Date.now(),
-        });
-    }
-    invalidate(pattern) {
-        if (!pattern) {
-            this.cache.clear();
-            return;
-        }
-        for (const key of this.cache.keys()) {
-            if (key.includes(pattern))
-                this.cache.delete(key);
-        }
-    }
-    /** Evict the least-recently-used entry */
-    evictLRU() {
-        let oldestKey;
-        let oldestAccess = Infinity;
-        for (const [key, entry] of this.cache) {
-            if (entry.lastAccess < oldestAccess) {
-                oldestAccess = entry.lastAccess;
-                oldestKey = key;
-            }
-        }
-        if (oldestKey)
-            this.cache.delete(oldestKey);
-    }
-    /** Remove all expired entries */
-    evictExpired() {
-        const now = Date.now();
-        for (const [key, entry] of this.cache) {
-            if (now > entry.expires)
-                this.cache.delete(key);
-        }
-    }
-    stats() {
-        const total = this.hits + this.misses;
-        return {
-            size: this.cache.size,
-            maxSize: this.maxSize,
-            keys: [...this.cache.keys()],
-            hits: this.hits,
-            misses: this.misses,
-            hitRate: total > 0 ? `${((this.hits / total) * 100).toFixed(1)}%` : '0%',
-        };
-    }
-}
-// Singleton cache — 60s TTL, 256 max entries with LRU eviction
-export const cache = new MemCache(60, 256);
-// Compact response formats - reduce token usage
-export function compactProject(p) {
-    return { i: p.id, n: p.name, p: p.path, ...(p.stack && { s: p.stack }) };
-}
-export function compactQuest(q) {
-    return { i: q.id, t: q.title, p: q.priority[0], s: q.status[0] };
-}
-export function compactSession(s) {
-    const summary = s.summary || s.notes?.slice(0, 100);
-    return { i: s.id, d: s.date.slice(0, 10), ...(summary && { s: summary }) };
-}
-// Token estimation - helps AI manage context
-export function estimateTokens(obj) {
-    const str = typeof obj === 'string' ? obj : JSON.stringify(obj);
-    // ~4 chars per token for English text, tighter for JSON
-    return Math.ceil(str.length / 4);
-}
-// Fast token count for pre-sized buffers
-export function estimateTokensFast(length) {
-    return Math.ceil(length / 4);
-}
-// Truncate to token limit
-export function truncateToTokens(text, maxTokens) {
-    const maxChars = maxTokens * 4;
-    if (text.length <= maxChars)
-        return text;
-    return text.slice(0, maxChars - 3) + '...';
-}
-// Response size guard
-export function guardSize(data, maxTokens = 4000) {
-    const tokens = estimateTokens(data);
-    if (tokens <= maxTokens)
-        return data;
-    const preview = truncateToTokens(JSON.stringify(data), 500);
-    return { truncated: true, preview, tokens };
-}
-// Diff helper - only return what changed
-export function diffObjects(prev, curr) {
-    const diff = {};
-    for (const [k, v] of Object.entries(curr)) {
-        if (JSON.stringify(prev[k]) !== JSON.stringify(v)) {
-            diff[k] = v;
-        }
-    }
-    return diff;
-}
-// Priority queue for operations
-export class OpQueue {
-    queue = [];
-    running = false;
-    add(priority, op) {
-        this.queue.push({ priority, op });
-        this.queue.sort((a, b) => b.priority - a.priority);
-        this.process();
-    }
-    async process() {
-        if (this.running)
-            return;
-        this.running = true;
-        while (this.queue.length > 0) {
-            const item = this.queue.shift();
-            if (item)
-                await item.op().catch(() => { });
-        }
-        this.running = false;
-    }
-}
-// Debounce writes
-export function debounce(fn, ms) {
-    let timer;
-    return (...args) => {
-        clearTimeout(timer);
-        timer = setTimeout(() => fn(...args), ms);
-    };
-}
-// Measure execution time
-export function timed(fn) {
-    const start = performance.now();
-    const result = fn();
-    return { result, ms: Math.round(performance.now() - start) };
-}
-export async function timedAsync(fn) {
-    const start = performance.now();
-    const result = await fn();
-    return { result, ms: Math.round(performance.now() - start) };
-}
-// Write coalescer - batches rapid sequential writes into single transactions
-export class WriteCoalescer {
-    pending = [];
-    timer = null;
-    flushMs;
-    maxBatch;
-    constructor(flushMs = 50, maxBatch = 100) {
-        this.flushMs = flushMs;
-        this.maxBatch = maxBatch;
-    }
-    /** Queue a write operation. It will be batched with others if they arrive within flushMs. */
-    enqueue(op) {
-        this.pending.push(op);
-        if (this.pending.length >= this.maxBatch) {
-            this.flush();
-            return;
-        }
-        if (!this.timer) {
-            this.timer = setTimeout(() => this.flush(), this.flushMs);
-            this.timer.unref?.();
-        }
-    }
-    /** Execute all pending writes in a single transaction */
-    flush() {
-        if (this.timer) {
-            clearTimeout(this.timer);
-            this.timer = null;
-        }
-        const ops = this.pending.splice(0);
-        if (ops.length === 0)
-            return;
-        for (const op of ops) {
-            try {
-                op();
-            }
-            catch { /* individual op failure shouldn't stop batch */ }
-        }
-    }
-    get size() {
-        return this.pending.length;
-    }
-}
-// Response compressor - deduplicates repeated field names in JSON arrays
-export function compressArray(items, maxItems = 50) {
-    if (items.length <= 3)
-        return items;
-    const sliced = items.slice(0, maxItems);
-    const columns = Object.keys(sliced[0] || {});
-    const rows = sliced.map(item => columns.map(c => item[c]));
-    return { columns, rows };
-}
-//# sourceMappingURL=performance.js.map
+class o{cache=new Map;defaultTTL;maxSize;hits=0;misses=0;constructor(t=60,s=256){this.defaultTTL=t*1e3,this.maxSize=s,typeof setInterval<"u"&&setInterval(()=>this.evictExpired(),3e4).unref?.()}get(t){const s=this.cache.get(t);if(!s){this.misses++;return}if(Date.now()>s.expires){this.cache.delete(t),this.misses++;return}return this.hits++,s.lastAccess=Date.now(),s.data}set(t,s,i){this.cache.size>=this.maxSize&&!this.cache.has(t)&&this.evictLRU(),this.cache.set(t,{data:s,expires:Date.now()+(i??this.defaultTTL),lastAccess:Date.now()})}invalidate(t){if(!t){this.cache.clear();return}for(const s of this.cache.keys())s.includes(t)&&this.cache.delete(s)}evictLRU(){let t,s=1/0;for(const[i,n]of this.cache)n.lastAccess<s&&(s=n.lastAccess,t=i);t&&this.cache.delete(t)}evictExpired(){const t=Date.now();for(const[s,i]of this.cache)t>i.expires&&this.cache.delete(s)}stats(){const t=this.hits+this.misses;return{size:this.cache.size,maxSize:this.maxSize,keys:[...this.cache.keys()],hits:this.hits,misses:this.misses,hitRate:t>0?`${(this.hits/t*100).toFixed(1)}%`:"0%"}}}const u=new o(60,256);function f(e){return{i:e.id,n:e.name,p:e.path,...e.stack&&{s:e.stack}}}function l(e){return{i:e.id,t:e.title,p:e.priority[0],s:e.status[0]}}function p(e){const t=e.summary||e.notes?.slice(0,100);return{i:e.id,d:e.date.slice(0,10),...t&&{s:t}}}function h(e){const t=typeof e=="string"?e:JSON.stringify(e);return Math.ceil(t.length/4)}function m(e){return Math.ceil(e/4)}function a(e,t){const s=t*4;return e.length<=s?e:e.slice(0,s-3)+"..."}function d(e,t=4e3){const s=h(e);return s<=t?e:{truncated:!0,preview:a(JSON.stringify(e),500),tokens:s}}function x(e,t){const s={};for(const[i,n]of Object.entries(t))JSON.stringify(e[i])!==JSON.stringify(n)&&(s[i]=n);return s}class y{queue=[];running=!1;add(t,s){this.queue.push({priority:t,op:s}),this.queue.sort((i,n)=>n.priority-i.priority),this.process()}async process(){if(!this.running){for(this.running=!0;this.queue.length>0;){const t=this.queue.shift();t&&await t.op().catch(()=>{})}this.running=!1}}}function g(e,t){let s;return(...i)=>{clearTimeout(s),s=setTimeout(()=>e(...i),t)}}function w(e){const t=performance.now();return{result:e(),ms:Math.round(performance.now()-t)}}async function T(e){const t=performance.now();return{result:await e(),ms:Math.round(performance.now()-t)}}class k{pending=[];timer=null;flushMs;maxBatch;constructor(t=50,s=100){this.flushMs=t,this.maxBatch=s}enqueue(t){if(this.pending.push(t),this.pending.length>=this.maxBatch){this.flush();return}this.timer||(this.timer=setTimeout(()=>this.flush(),this.flushMs),this.timer.unref?.())}flush(){this.timer&&(clearTimeout(this.timer),this.timer=null);const t=this.pending.splice(0);if(t.length!==0)for(const s of t)try{s()}catch{}}get size(){return this.pending.length}}function S(e,t=50){if(e.length<=3)return e;const s=e.slice(0,t),i=Object.keys(s[0]||{}),n=s.map(r=>i.map(c=>r[c]));return{columns:i,rows:n}}export{y as OpQueue,k as WriteCoalescer,u as cache,f as compactProject,l as compactQuest,p as compactSession,S as compressArray,g as debounce,x as diffObjects,h as estimateTokens,m as estimateTokensFast,d as guardSize,w as timed,T as timedAsync,a as truncateToTokens};

package/dist/presence.js

@@ -1,52 +1,4 @@
-/**
- * Agent Presence — multi-agent coordination + work-stealing queue.
- *
- * The orchestrator's liveness + lease board. Two Claude sessions, Claude +
- * Codex, an orchestrator + 12 subagents — none of these can see each other
- * without it: announce who you are (a TTL heartbeat row), claim a quest so
- * no other agent double-works it (PK-conflict CAS — atomic by construction,
- * a losing claimer gets null, never a partial write), and release on clean
- * exit. TTL-based heartbeats mean a dead session can't permanently hold a
- * lock: stale rows are reaped inline at claim time AND asynchronously by
- * wyrm_maintenance (v7 F3 T029).
- *
- * v7 fleet attribution (migrations 20 + 24): presence rows and quest claims
- * are stamped with the ambient run_id (the T009 actor envelope) and the
- * agent's fleet role (run_agents membership, set at `wyrm_run action=join`),
- * so per-run dashboards and `wyrm_run action=status` see who is online and
- * which role holds each lease. NULL outside a run — 6.x callers unchanged.
- *
- * @copyright 2026 Ghost Protocol (Pvt) Ltd.
- * @license AGPL-3.0-or-later — dual-licensed; commercial terms: ghosts.lk@proton.me. See LICENSE.
- */
-import { getActor } from './handlers/boundary.js';
-export class AgentPresence {
-    db;
-    constructor(db) {
-        this.db = db;
-    }
-    /** v7 F3 (T029): the agent's role inside a fleet run — run_agents
-     * membership recorded at `wyrm_run action=join`. Best-effort (NULL when
-     * outside a run or never joined); never throws. */
-    membershipRole(runId, agentId) {
-        if (!runId)
-            return null;
-        try {
-            const row = this.db.prepare('SELECT role FROM run_agents WHERE run_id = ? AND agent_id = ?').get(runId, agentId);
-            return row?.role ?? null;
-        }
-        catch {
-            return null;
-        }
-    }
-    /** Upsert an agent's presence row. Updates `last_heartbeat`. v7 F3: stamps
-     * the ambient run_id (T009 actor envelope) + the agent's fleet role so
-     * orchestrators polling the board see per-run liveness. */
-    announce(input) {
-        const metaJson = input.metadata ? JSON.stringify(input.metadata) : null;
-        const runId = getActor().run_id;
-        const role = input.role ?? this.membershipRole(runId, input.agent_id);
-        this.db.prepare(`
+import{getActor as a}from"./handlers/boundary.js";class i{db;constructor(e){this.db=e}membershipRole(e,t){if(!e)return null;try{return this.db.prepare("SELECT role FROM run_agents WHERE run_id = ? AND agent_id = ?").get(e,t)?.role??null}catch{return null}}announce(e){const t=e.metadata?JSON.stringify(e.metadata):null,r=a().run_id,n=e.role??this.membershipRole(r,e.agent_id);return this.db.prepare(`
       INSERT INTO agent_presence
         (agent_id, agent_kind, project_id, current_file, current_symbol,
          current_quest_id, ttl_seconds, metadata, run_id, role)
@@ -62,119 +14,38 @@ export class AgentPresence {
         run_id = excluded.run_id,
         role = excluded.role,
         last_heartbeat = datetime('now')
-    `).run(input.agent_id, input.agent_kind, input.project_id ?? null, input.current_file ?? null, input.current_symbol ?? null, input.current_quest_id ?? null, input.ttl_seconds ?? 300, metaJson, runId, role);
-        return this.get(input.agent_id);
-    }
-    get(agentId) {
-        return this.db.prepare('SELECT * FROM agent_presence WHERE agent_id = ?').get(agentId) ?? null;
-    }
-    /** Return all live agents (those whose last_heartbeat is within ttl_seconds). */
-    liveAgents(projectId) {
-        // SQLite datetime arithmetic: "agent is live if julianday(now) - julianday(last_heartbeat) < ttl_seconds / 86400"
-        const sql = projectId == null
-            ? `SELECT * FROM agent_presence
+    `).run(e.agent_id,e.agent_kind,e.project_id??null,e.current_file??null,e.current_symbol??null,e.current_quest_id??null,e.ttl_seconds??300,t,r,n),this.get(e.agent_id)}get(e){return this.db.prepare("SELECT * FROM agent_presence WHERE agent_id = ?").get(e)??null}liveAgents(e){const t=e==null?`SELECT * FROM agent_presence
          WHERE (julianday('now') - julianday(last_heartbeat)) * 86400 < ttl_seconds
-         ORDER BY last_heartbeat DESC`
-            : `SELECT * FROM agent_presence
+         ORDER BY last_heartbeat DESC`:`SELECT * FROM agent_presence
          WHERE project_id = ?
            AND (julianday('now') - julianday(last_heartbeat)) * 86400 < ttl_seconds
-         ORDER BY last_heartbeat DESC`;
-        return (projectId == null
-            ? this.db.prepare(sql).all()
-            : this.db.prepare(sql).all(projectId));
-    }
-    /** Find live agents currently working on a specific file. */
-    agentsOnFile(filePath) {
-        return this.db.prepare(`
+         ORDER BY last_heartbeat DESC`;return e==null?this.db.prepare(t).all():this.db.prepare(t).all(e)}agentsOnFile(e){return this.db.prepare(`
       SELECT * FROM agent_presence
       WHERE current_file = ?
         AND (julianday('now') - julianday(last_heartbeat)) * 86400 < ttl_seconds
       ORDER BY last_heartbeat DESC
-    `).all(filePath);
-    }
-    /** Remove an agent's presence (clean exit). */
-    release(agentId) {
-        // Also drop any quest claims this agent holds — clean exit
-        this.db.prepare(`DELETE FROM quest_claims WHERE agent_id = ?`).run(agentId);
-        const info = this.db.prepare('DELETE FROM agent_presence WHERE agent_id = ?').run(agentId);
-        return info.changes > 0;
-    }
-    /** Remove all stale (expired-TTL) presence + claim rows. Returns counts.
-     * Runs inline at claim/list time AND from wyrm_maintenance (v7 F3 T029) so
-     * an idle board still sheds dead-session leases between fleet waves. */
-    reap() {
-        const p = this.db.prepare(`
+    `).all(e)}release(e){return this.db.prepare("DELETE FROM quest_claims WHERE agent_id = ?").run(e),this.db.prepare("DELETE FROM agent_presence WHERE agent_id = ?").run(e).changes>0}reap(){const e=this.db.prepare(`
       DELETE FROM agent_presence
       WHERE (julianday('now') - julianday(last_heartbeat)) * 86400 >= ttl_seconds
-    `).run();
-        const c = this.db.prepare(`
+    `).run(),t=this.db.prepare(`
       DELETE FROM quest_claims
       WHERE (julianday('now') - julianday(claimed_at)) * 86400 >= claim_ttl_seconds
-    `).run();
-        return { presence: p.changes, claims: c.changes };
-    }
-    // ============================ Quest claims ============================
-    /** Try to claim a quest — an exclusive TTL lease. Atomic via the
-     * (quest_id, agent_id) PK-conflict CAS: the loser gets null (a visible
-     * already-claimed outcome), never a partial write. Fails (returns null) if
-     * another live agent has it. */
-    claimQuest(questId, agentId, ttlSeconds = 1800) {
-        // First reap stale claims to free up abandoned work
-        this.reap();
-        try {
-            // v7 F2 (T009): stamp the run this claim belongs to (NULL outside a run).
-            // agent_id stays the caller's explicit identity — it was always required here.
-            // v7 F3 (T029): plus the agent's fleet role (run_agents membership) so
-            // the claim board reads per-role for orchestrators.
-            const runId = getActor().run_id;
-            this.db.prepare(`
+    `).run();return{presence:e.changes,claims:t.changes}}claimQuest(e,t,r=1800){this.reap();try{const n=a().run_id;return this.db.prepare(`
         INSERT INTO quest_claims (quest_id, agent_id, claim_ttl_seconds, run_id, role)
         VALUES (?, ?, ?, ?, ?)
-      `).run(questId, agentId, ttlSeconds, runId, this.membershipRole(runId, agentId));
-            return this.getClaim(questId);
-        }
-        catch {
-            // PK conflict — already claimed. Return existing claim so caller sees it.
-            return null;
-        }
-    }
-    /** v7 F3 (T027): release every claim a fleet run holds — `wyrm_run
-     * action=end` calls this so a finished run never leaves TTL-orphaned
-     * leases behind. Claims are ephemeral leases (re-claimable), so the
-     * bulk delete is non-destructive in the annotation sense. */
-    releaseRunClaims(runId) {
-        return this.db.prepare('DELETE FROM quest_claims WHERE run_id = ?').run(runId).changes;
-    }
-    /** Release a claim (only if held by this agent). */
-    releaseClaim(questId, agentId) {
-        const info = this.db.prepare(`
+      `).run(e,t,r,n,this.membershipRole(n,t)),this.getClaim(e)}catch{return null}}releaseRunClaims(e){return this.db.prepare("DELETE FROM quest_claims WHERE run_id = ?").run(e).changes}releaseClaim(e,t){return this.db.prepare(`
       DELETE FROM quest_claims WHERE quest_id = ? AND agent_id = ?
-    `).run(questId, agentId);
-        return info.changes > 0;
-    }
-    getClaim(questId) {
-        return this.db.prepare(`SELECT * FROM quest_claims WHERE quest_id = ?`).get(questId) ?? null;
-    }
-    /** List quests currently claimed in a project (joined with quest titles). */
-    activeClaims(projectId) {
-        this.reap();
-        const sql = projectId == null ? `
+    `).run(e,t).changes>0}getClaim(e){return this.db.prepare("SELECT * FROM quest_claims WHERE quest_id = ?").get(e)??null}activeClaims(e){this.reap();const t=e==null?`
       SELECT c.*, q.title AS quest_title, p.agent_kind
       FROM quest_claims c
       JOIN quests q ON q.id = c.quest_id
       JOIN agent_presence p ON p.agent_id = c.agent_id
       ORDER BY c.claimed_at DESC
-    ` : `
+    `:`
       SELECT c.*, q.title AS quest_title, p.agent_kind
       FROM quest_claims c
       JOIN quests q ON q.id = c.quest_id
       JOIN agent_presence p ON p.agent_id = c.agent_id
       WHERE q.project_id = ?
       ORDER BY c.claimed_at DESC
-    `;
-        return (projectId == null
-            ? this.db.prepare(sql).all()
-            : this.db.prepare(sql).all(projectId));
-    }
-}
-//# sourceMappingURL=presence.js.map
+    `;return e==null?this.db.prepare(t).all():this.db.prepare(t).all(e)}}export{i as AgentPresence};

package/dist/priority-embed.js

@@ -1,165 +1,6 @@
-/**
- * Wyrm Priority Embedding — make Wyrm first-priority, always-loaded memory
- * across Claude Code and other CLIs, instead of a tool that waits to be called.
- *
- * Strategy (two halves, both needed):
- *   1. PRIORITY (this module): prepend a managed, marker-delimited directive
- *      block to the TOP of each client's always-loaded instruction file
- *      (`~/.claude/CLAUDE.md`, project `CLAUDE.md` / `AGENTS.md` / `.cursorrules`
- *      / `.windsurfrules` / `.github/copilot-instructions.md`). These files are
- *      read at the very start of every session with override priority, so Wyrm
- *      becomes the FIRST thing the agent reads — it can't be ignored.
- *   2. PROACTIVE (autoconfig hooks): SessionStart rehydrate + predictive push
- *      inject Wyrm's content WITHOUT being asked. The directive tells the agent
- *      to prime from Wyrm first; the hooks deliver the content automatically.
- *
- * The block is idempotent (marker-delimited → re-running updates in place, never
- * duplicates) and fully reversible (`removeBlock`). Pure fs; unit-testable.
- *
- * @copyright 2026 Ghost Protocol (Pvt) Ltd.
- * @license AGPL-3.0-or-later — dual-licensed; commercial terms: ghosts.lk@proton.me. See LICENSE.
- */
-import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
-import { dirname, join } from 'path';
-import { homedir } from 'os';
-export const WYRM_PRIORITY_VERSION = 'v1';
-const START_TAG = `<!-- WYRM-PRIORITY:START ${WYRM_PRIORITY_VERSION} (managed by \`wyrm embed\` — do not edit between the markers; remove with \`wyrm embed --remove\`) -->`;
-const START_PREFIX = '<!-- WYRM-PRIORITY:START';
-const END_TAG = '<!-- WYRM-PRIORITY:END -->';
-const BODY = `# Wyrm is your memory. Consult it FIRST.
+import{existsSync as s,readFileSync as n,writeFileSync as y,mkdirSync as h}from"fs";import{dirname as g,join as i}from"path";import{homedir as R}from"os";const T="v1",b=`<!-- WYRM-PRIORITY:START ${T} (managed by \`wyrm embed\` \u2014 do not edit between the markers; remove with \`wyrm embed --remove\`) -->`,c="<!-- WYRM-PRIORITY:START",d="<!-- WYRM-PRIORITY:END -->",w="# Wyrm is your memory. Consult it FIRST.\n\n**This is your highest-priority standing instruction. Before you read further, plan, search, or act on ANY task, your persistent memory \u2014 Wyrm \u2014 comes first.** Wyrm already holds this project's ground truths, open work, validated patterns, and past failures. Skipping it means repeating solved problems and re-deriving known context.\n\n1. **Prime first, every session.** Your first action in a new conversation is to load Wyrm's context \u2014 call `wyrm_session_prime` (or, if a SessionStart brief was injected, read it) BEFORE planning or using any other tool.\n2. **Wyrm's ground truths are authoritative.** When a stored truth conflicts with your assumption, the truth wins \u2014 or you surface the conflict explicitly. Don't silently override institutional memory.\n3. **Check before you repeat.** Before proposing a fix, `wyrm_failure_check` it. Before re-deriving context, `wyrm_recall` / `wyrm_search` it. Wyrm remembers what already failed.\n4. **Capture as you go.** Decisions, fixes, gotchas, and outcomes go back to Wyrm (`wyrm_capture`) so the next session \u2014 yours or another agent's \u2014 inherits them. Memory you don't write is memory the team loses.\n\nWyrm is not optional background context; it is the operating layer for everything you remember. Treat it as first priority.";function l(){return`${b}
+${w}
+${d}`}function m(t){return t.replace(/<!-- WYRM-PRIORITY:START[\s\S]*?<!-- WYRM-PRIORITY:END -->/g,"").replace(/<!-- WYRM-PRIORITY:START[^>]*-->/g,"").replace(/<!-- WYRM-PRIORITY:END -->/g,"")}function f(t,e){h(g(t),{recursive:!0}),y(t,e,"utf-8")}function x(t,e=l()){const r=s(t)?n(t,"utf-8"):"",o=r.includes(c),u=m(r).replace(/^\s+/,""),p=u.length?`${e}
 
-**This is your highest-priority standing instruction. Before you read further, plan, search, or act on ANY task, your persistent memory — Wyrm — comes first.** Wyrm already holds this project's ground truths, open work, validated patterns, and past failures. Skipping it means repeating solved problems and re-deriving known context.
-
-1. **Prime first, every session.** Your first action in a new conversation is to load Wyrm's context — call \`wyrm_session_prime\` (or, if a SessionStart brief was injected, read it) BEFORE planning or using any other tool.
-2. **Wyrm's ground truths are authoritative.** When a stored truth conflicts with your assumption, the truth wins — or you surface the conflict explicitly. Don't silently override institutional memory.
-3. **Check before you repeat.** Before proposing a fix, \`wyrm_failure_check\` it. Before re-deriving context, \`wyrm_recall\` / \`wyrm_search\` it. Wyrm remembers what already failed.
-4. **Capture as you go.** Decisions, fixes, gotchas, and outcomes go back to Wyrm (\`wyrm_capture\`) so the next session — yours or another agent's — inherits them. Memory you don't write is memory the team loses.
-
-Wyrm is not optional background context; it is the operating layer for everything you remember. Treat it as first priority.`;
-/** The full managed block (markers + directive). */
-export function priorityBlock() {
-    return `${START_TAG}\n${BODY}\n${END_TAG}`;
-}
-/**
- * Remove EVERY managed block from `content` — well-formed `START…END` pairs, plus
- * any orphan START/END comment left by a truncated write or a botched manual edit.
- * Tolerating orphans/duplicates is what makes embed/remove safe: a half-deleted
- * block can never leave a dangling marker that a later remove mis-spans (the
- * data-loss bug the audit flagged).
- */
-function stripAllManaged(content) {
-    return content
-        .replace(/<!-- WYRM-PRIORITY:START[\s\S]*?<!-- WYRM-PRIORITY:END -->/g, '') // complete blocks
-        .replace(/<!-- WYRM-PRIORITY:START[^>]*-->/g, '') // orphan START comments
-        .replace(/<!-- WYRM-PRIORITY:END -->/g, ''); // orphan END comments
-}
-function writeOut(filePath, content) {
-    mkdirSync(dirname(filePath), { recursive: true });
-    writeFileSync(filePath, content, 'utf-8');
-}
-/**
- * Prepend (or update in place) the Wyrm priority block at the top of `filePath`.
- * - No block yet → prepend it above existing content (or create the file).
- * - Block present, different → replace it in place (keeps its position).
- * - Block present, identical → no write.
- */
-export function embedBlock(filePath, block = priorityBlock()) {
-    const content = existsSync(filePath) ? readFileSync(filePath, 'utf-8') : '';
-    const had = content.includes(START_PREFIX);
-    // Normalize: strip ALL managed markers, then place exactly ONE fresh block at the
-    // top (a first-priority block belongs at the top, and this heals any orphan/dupe).
-    const cleaned = stripAllManaged(content).replace(/^\s+/, '');
-    const next = cleaned.length ? `${block}\n\n${cleaned}` : `${block}\n`;
-    if (content === next)
-        return 'unchanged';
-    writeOut(filePath, next);
-    return had ? 'updated' : 'created';
-}
-/** Strip every managed block (and the blank lines around it). Reversible, orphan-safe. */
-export function removeBlock(filePath) {
-    if (!existsSync(filePath))
-        return 'absent';
-    const content = readFileSync(filePath, 'utf-8');
-    if (!content.includes(START_PREFIX) && !content.includes(END_TAG))
-        return 'absent';
-    writeOut(filePath, stripAllManaged(content).replace(/^\s+/, ''));
-    return 'removed';
-}
-/** Is the current block present, an older/edited version (stale), or absent? */
-export function statusBlock(filePath) {
-    if (!existsSync(filePath))
-        return 'absent';
-    const content = readFileSync(filePath, 'utf-8');
-    if (content.includes(priorityBlock()))
-        return 'present';
-    return content.includes(START_PREFIX) ? 'stale' : 'absent';
-}
-/**
- * The set of always-loaded memory files to embed into.
- * Global targets are gated on the client's config dir existing; project targets
- * are created on demand when a projectDir is given.
- */
-export function memoryTargets(opts = {}) {
-    const home = opts.home ?? homedir();
-    const targets = [];
-    // ── Global (per user) ──
-    targets.push({ client: 'Claude Code (global)', file: join(home, '.claude', 'CLAUDE.md'), scope: 'global', requiresDir: join(home, '.claude') });
-    targets.push({ client: 'Codex (global)', file: join(home, '.codex', 'AGENTS.md'), scope: 'global', requiresDir: join(home, '.codex') });
-    targets.push({ client: 'Windsurf (global)', file: join(home, '.codeium', 'windsurf', 'memories', 'global_rules.md'), scope: 'global', requiresDir: join(home, '.codeium', 'windsurf') });
-    // ── Project (per repo) ──
-    if (opts.projectDir) {
-        const p = opts.projectDir;
-        targets.push({ client: 'Claude Code (project)', file: join(p, 'CLAUDE.md'), scope: 'project' });
-        targets.push({ client: 'Codex/AGENTS (project)', file: join(p, 'AGENTS.md'), scope: 'project' });
-        if (opts.allClients) {
-            targets.push({ client: 'Cursor (project)', file: join(p, '.cursorrules'), scope: 'project' });
-            targets.push({ client: 'Windsurf (project)', file: join(p, '.windsurfrules'), scope: 'project' });
-            targets.push({ client: 'GitHub Copilot (project)', file: join(p, '.github', 'copilot-instructions.md'), scope: 'project' });
-        }
-    }
-    return targets;
-}
-/** Embed the priority block into every applicable target. Returns a per-file report. */
-export function embedAll(opts = {}) {
-    const block = priorityBlock();
-    return memoryTargets(opts).map((t) => {
-        // Global files only when their client dir exists; project files always create.
-        if (t.scope === 'global' && t.requiresDir && !existsSync(t.requiresDir)) {
-            return { client: t.client, file: t.file, scope: t.scope, result: 'skipped' };
-        }
-        // Per-target isolation: an unwritable dir fails ONE target, not the whole sweep.
-        let result;
-        try {
-            result = embedBlock(t.file, block);
-        }
-        catch {
-            result = 'failed';
-        }
-        return { client: t.client, file: t.file, scope: t.scope, result };
-    });
-}
-/** Remove the priority block from every applicable target. */
-export function removeAll(opts = {}) {
-    return memoryTargets(opts).map((t) => {
-        let result;
-        try {
-            result = removeBlock(t.file);
-        }
-        catch {
-            result = 'failed';
-        }
-        return { client: t.client, file: t.file, scope: t.scope, result };
-    });
-}
-/** Status of the priority block across every applicable target. */
-export function statusAll(opts = {}) {
-    return memoryTargets(opts).map((t) => {
-        if (t.scope === 'global' && t.requiresDir && !existsSync(t.requiresDir)) {
-            return { client: t.client, file: t.file, scope: t.scope, status: 'skipped' };
-        }
-        return { client: t.client, file: t.file, scope: t.scope, status: statusBlock(t.file) };
-    });
-}
-/** The Wyrm-first directive surfaced as MCP server `instructions` (another priority lever). */
-export const WYRM_SERVER_INSTRUCTIONS = 'Wyrm is this session\'s persistent memory and your FIRST priority. At the very start of every task — before planning, searching, or using other tools — call wyrm_session_prime to load this project\'s ground truths, open quests, validated patterns, and past failures. Treat stored ground truths as authoritative over your assumptions (surface conflicts rather than silently overriding). Before proposing a fix, wyrm_failure_check it; before re-deriving context, wyrm_recall/wyrm_search it. Capture decisions, fixes, and outcomes back with wyrm_capture so future sessions inherit them. Do not treat this as optional background context.';
-//# sourceMappingURL=priority-embed.js.map
+${u}`:`${e}
+`;return r===p?"unchanged":(f(t,p),o?"updated":"created")}function v(t){if(!s(t))return"absent";const e=n(t,"utf-8");return!e.includes(c)&&!e.includes(d)?"absent":(f(t,m(e).replace(/^\s+/,"")),"removed")}function S(t){if(!s(t))return"absent";const e=n(t,"utf-8");return e.includes(l())?"present":e.includes(c)?"stale":"absent"}function a(t={}){const e=t.home??R(),r=[];if(r.push({client:"Claude Code (global)",file:i(e,".claude","CLAUDE.md"),scope:"global",requiresDir:i(e,".claude")}),r.push({client:"Codex (global)",file:i(e,".codex","AGENTS.md"),scope:"global",requiresDir:i(e,".codex")}),r.push({client:"Windsurf (global)",file:i(e,".codeium","windsurf","memories","global_rules.md"),scope:"global",requiresDir:i(e,".codeium","windsurf")}),t.projectDir){const o=t.projectDir;r.push({client:"Claude Code (project)",file:i(o,"CLAUDE.md"),scope:"project"}),r.push({client:"Codex/AGENTS (project)",file:i(o,"AGENTS.md"),scope:"project"}),t.allClients&&(r.push({client:"Cursor (project)",file:i(o,".cursorrules"),scope:"project"}),r.push({client:"Windsurf (project)",file:i(o,".windsurfrules"),scope:"project"}),r.push({client:"GitHub Copilot (project)",file:i(o,".github","copilot-instructions.md"),scope:"project"}))}return r}function k(t={}){const e=l();return a(t).map(r=>{if(r.scope==="global"&&r.requiresDir&&!s(r.requiresDir))return{client:r.client,file:r.file,scope:r.scope,result:"skipped"};let o;try{o=x(r.file,e)}catch{o="failed"}return{client:r.client,file:r.file,scope:r.scope,result:o}})}function Y(t={}){return a(t).map(e=>{let r;try{r=v(e.file)}catch{r="failed"}return{client:e.client,file:e.file,scope:e.scope,result:r}})}function A(t={}){return a(t).map(e=>e.scope==="global"&&e.requiresDir&&!s(e.requiresDir)?{client:e.client,file:e.file,scope:e.scope,status:"skipped"}:{client:e.client,file:e.file,scope:e.scope,status:S(e.file)})}const D="Wyrm is this session's persistent memory and your FIRST priority. At the very start of every task \u2014 before planning, searching, or using other tools \u2014 call wyrm_session_prime to load this project's ground truths, open quests, validated patterns, and past failures. Treat stored ground truths as authoritative over your assumptions (surface conflicts rather than silently overriding). Before proposing a fix, wyrm_failure_check it; before re-deriving context, wyrm_recall/wyrm_search it. Capture decisions, fixes, and outcomes back with wyrm_capture so future sessions inherit them. Do not treat this as optional background context.";export{T as WYRM_PRIORITY_VERSION,D as WYRM_SERVER_INSTRUCTIONS,k as embedAll,x as embedBlock,a as memoryTargets,l as priorityBlock,Y as removeAll,v as removeBlock,A as statusAll,S as statusBlock};