wyrm-mcp 3.7.2 → 4.0.0

package/dist/failure-patterns.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Failure Patterns — Counter-pattern detection.
+ *
+ * Records edits / commands / prompts that failed so the predictive push
+ * can BLOCK the same suggestion mid-stream the next time it surfaces.
+ * Most "memory" tools only learn from success; Wyrm learns from failure too.
+ *
+ * Keyed on `(signature, scope)` so semantically-identical failures
+ * coalesce — re-recording the same failure increments `occurrences`
+ * rather than creating a new row.
+ *
+ * @copyright 2026 Ghost Protocol (Pvt) Ltd. All Rights Reserved.
+ * @license Proprietary
+ */
+import type Database from 'better-sqlite3';
+export type FailureScope = 'file' | 'symbol' | 'command' | 'prompt' | 'edit';
+export type FailureSeverity = 'low' | 'medium' | 'high' | 'critical';
+export interface FailurePattern {
+    id: number;
+    project_id: number | null;
+    signature: string;
+    scope: FailureScope;
+    target: string;
+    description: string;
+    why_failed: string | null;
+    occurrences: number;
+    first_seen: string;
+    last_seen: string;
+    severity: FailureSeverity;
+    resolved: 0 | 1;
+    resolution_note: string | null;
+}
+export interface RecordInput {
+    project_id?: number | null;
+    scope: FailureScope;
+    target: string;
+    description: string;
+    why_failed?: string;
+    severity?: FailureSeverity;
+}
+export declare class FailurePatterns {
+    private db;
+    constructor(db: Database.Database);
+    /** Build a stable signature from scope+target+description, so repeated
+     * identical failures coalesce instead of creating new rows. */
+    static signature(scope: string, target: string, description: string): string;
+    /** Record (or increment) a failure. Returns the (new or updated) row. */
+    record(input: RecordInput): FailurePattern;
+    get(id: number): FailurePattern | null;
+    /** Check whether a proposed action matches any unresolved failure.
+     * Returns the matching patterns, ranked by recency × occurrences. */
+    check(scope: FailureScope, target: string, description: string, projectId?: number | null): FailurePattern[];
+    /** List unresolved failures in a project, most-recent-first. */
+    list(projectId?: number | null, limit?: number): FailurePattern[];
+    /** Mark a failure as resolved (the underlying issue was fixed). */
+    resolve(id: number, note?: string): FailurePattern | null;
+    /** Permanently delete a failure (use sparingly — resolve() is preferred). */
+    delete(id: number): boolean;
+}
+//# sourceMappingURL=failure-patterns.d.ts.map

package/dist/failure-patterns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure-patterns.d.ts","sourceRoot":"","sources":["../src/failure-patterns.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAG3C,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;AAC7E,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;AAErE,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,YAAY,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,eAAe,CAAC;IAC1B,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC;IAChB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,YAAY,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B;AAED,qBAAa,eAAe;IACd,OAAO,CAAC,EAAE;gBAAF,EAAE,EAAE,QAAQ,CAAC,QAAQ;IAEzC;mEAC+D;IAC/D,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM;IAO5E,yEAAyE;IACzE,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,cAAc;IA4C1C,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAOtC;yEACqE;IACrE,KAAK,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,cAAc,EAAE;IA+B5G,gEAAgE;IAChE,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,SAAK,GAAG,cAAc,EAAE;IAc7D,mEAAmE;IACnE,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IASzD,6EAA6E;IAC7E,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;CAM5B"}

package/dist/failure-patterns.js

@@ -0,0 +1,117 @@
+/**
+ * Failure Patterns — Counter-pattern detection.
+ *
+ * Records edits / commands / prompts that failed so the predictive push
+ * can BLOCK the same suggestion mid-stream the next time it surfaces.
+ * Most "memory" tools only learn from success; Wyrm learns from failure too.
+ *
+ * Keyed on `(signature, scope)` so semantically-identical failures
+ * coalesce — re-recording the same failure increments `occurrences`
+ * rather than creating a new row.
+ *
+ * @copyright 2026 Ghost Protocol (Pvt) Ltd. All Rights Reserved.
+ * @license Proprietary
+ */
+import { sanitizeFtsQuery } from './security.js';
+export class FailurePatterns {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    /** Build a stable signature from scope+target+description, so repeated
+     * identical failures coalesce instead of creating new rows. */
+    static signature(scope, target, description) {
+        // Normalize: lowercase, strip whitespace runs, trim
+        const norm = (s) => s.toLowerCase().replace(/\s+/g, ' ').trim().slice(0, 200);
+        return `${scope}:${norm(target)}:${norm(description).slice(0, 80)}`;
+    }
+    /** Record (or increment) a failure. Returns the (new or updated) row. */
+    record(input) {
+        const signature = FailurePatterns.signature(input.scope, input.target, input.description);
+        const projectId = input.project_id ?? null;
+        const existing = this.db.prepare(`
+      SELECT * FROM failure_patterns
+      WHERE signature = ? AND (project_id IS ? OR project_id = ?)
+    `).get(signature, projectId, projectId);
+        if (existing) {
+            this.db.prepare(`
+        UPDATE failure_patterns
+        SET occurrences = occurrences + 1,
+            last_seen = datetime('now'),
+            why_failed = COALESCE(?, why_failed),
+            severity = ?,
+            resolved = 0
+        WHERE id = ?
+      `).run(input.why_failed ?? null, input.severity ?? existing.severity, existing.id);
+            return this.get(existing.id);
+        }
+        const info = this.db.prepare(`
+      INSERT INTO failure_patterns
+        (project_id, signature, scope, target, description, why_failed, severity)
+      VALUES (?, ?, ?, ?, ?, ?, ?)
+    `).run(projectId, signature, input.scope, input.target, input.description, input.why_failed ?? null, input.severity ?? 'medium');
+        return this.get(info.lastInsertRowid);
+    }
+    get(id) {
+        const row = this.db.prepare('SELECT * FROM failure_patterns WHERE id = ?').get(id);
+        return row ?? null;
+    }
+    /** Check whether a proposed action matches any unresolved failure.
+     * Returns the matching patterns, ranked by recency × occurrences. */
+    check(scope, target, description, projectId) {
+        const signature = FailurePatterns.signature(scope, target, description);
+        const exact = this.db.prepare(`
+      SELECT * FROM failure_patterns
+      WHERE resolved = 0 AND signature = ?
+        AND (project_id IS ? OR project_id = ? OR project_id IS NULL)
+      ORDER BY occurrences DESC, last_seen DESC
+      LIMIT 5
+    `).all(signature, projectId ?? null, projectId ?? null);
+        if (exact.length > 0)
+            return exact;
+        // Fuzzy fallback: FTS over description + target
+        const q = sanitizeFtsQuery(`${target} ${description}`.slice(0, 100));
+        if (!q)
+            return [];
+        try {
+            return this.db.prepare(`
+        SELECT fp.* FROM failure_patterns fp
+        JOIN failure_patterns_fts fts ON fts.rowid = fp.id
+        WHERE failure_patterns_fts MATCH ?
+          AND fp.resolved = 0
+          AND (fp.project_id IS ? OR fp.project_id = ? OR fp.project_id IS NULL)
+          AND fp.scope = ?
+        ORDER BY fp.occurrences DESC, fp.last_seen DESC
+        LIMIT 5
+      `).all(q, projectId ?? null, projectId ?? null, scope);
+        }
+        catch {
+            return [];
+        }
+    }
+    /** List unresolved failures in a project, most-recent-first. */
+    list(projectId, limit = 20) {
+        if (projectId == null) {
+            return this.db.prepare(`SELECT * FROM failure_patterns WHERE resolved = 0
+         ORDER BY last_seen DESC LIMIT ?`).all(limit);
+        }
+        return this.db.prepare(`SELECT * FROM failure_patterns
+       WHERE resolved = 0 AND project_id = ?
+       ORDER BY last_seen DESC LIMIT ?`).all(projectId, limit);
+    }
+    /** Mark a failure as resolved (the underlying issue was fixed). */
+    resolve(id, note) {
+        this.db.prepare(`
+      UPDATE failure_patterns
+      SET resolved = 1, resolution_note = ?
+      WHERE id = ?
+    `).run(note ?? null, id);
+        return this.get(id);
+    }
+    /** Permanently delete a failure (use sparingly — resolve() is preferred). */
+    delete(id) {
+        const info = this.db.prepare('DELETE FROM failure_patterns WHERE id = ?').run(id);
+        return info.changes > 0;
+    }
+}
+//# sourceMappingURL=failure-patterns.js.map

package/dist/failure-patterns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure-patterns.js","sourceRoot":"","sources":["../src/failure-patterns.ts"],"names":[],"mappings":"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"}

package/dist/federation.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Federated team Wyrm (Tier 2.8).
+ *
+ * Each operator runs a local Wyrm; opt-in tagged data syncs to a shared
+ * "team Wyrm" instance. PII never leaves the local box unless explicitly
+ * shared (per-row `is_shared=1` flag — set when the operator marks a
+ * truth/quest/artifact as team-visible).
+ *
+ * Sync surface:
+ *   POST /sync/push   pushes is_shared=1 local rows changed since cursor
+ *   GET  /sync/pull   pulls remote rows changed since cursor
+ *
+ * Conflict policy: if a remote push lands on top of a local edit whose
+ * `updated_at` is newer, we DO NOT silently overwrite. Instead we record
+ * the conflict in `sync_conflicts` and mint a quest for the operator to
+ * resolve. Last-write-wins is the failure mode of every team sync tool;
+ * Wyrm refuses to silently lose work.
+ *
+ * @copyright 2026 Ghost Protocol (Pvt) Ltd. All Rights Reserved.
+ * @license Proprietary
+ */
+import type Database from 'better-sqlite3';
+export type SyncableKind = 'session' | 'quest' | 'truth' | 'artifact' | 'edge';
+export interface SyncableRow {
+    kind: SyncableKind;
+    id: number;
+    project_id?: number | null;
+    payload: Record<string, unknown>;
+    updated_at: string;
+}
+export interface SyncPushResult {
+    pushed: number;
+    conflicts: number;
+    new_cursor: string;
+    conflict_ids: number[];
+}
+export interface SyncPullResult {
+    pulled: number;
+    new_cursor: string;
+    by_kind: Record<string, number>;
+}
+export declare class Federation {
+    private db;
+    constructor(db: Database.Database);
+    /** Mark a row as shared (will be picked up on next push). */
+    share(kind: SyncableKind, id: number): boolean;
+    /** Unshare (revoke from team visibility). Local row stays. */
+    unshare(kind: SyncableKind, id: number): boolean;
+    /** Collect rows to push: is_shared=1 AND ts > since_cursor. */
+    collectForPush(since_cursor?: string, limit?: number): SyncableRow[];
+    /** Apply a remote row locally. Returns:
+     *   { kind: 'inserted' } — fresh row, no conflict
+     *   { kind: 'overwritten' } — local row was older, remote wins
+     *   { kind: 'conflict', conflict_id } — local row newer, conflict recorded
+     * Idempotent — applying the same payload twice is a no-op.
+     *
+     * Conflict policy: if local updated_at > remote updated_at, the remote
+     * is REJECTED into sync_conflicts; a quest is minted. The local row stays.
+     */
+    applyRemote(row: SyncableRow, remoteOrigin: string): {
+        kind: 'inserted' | 'overwritten' | 'conflict' | 'skipped';
+        conflict_id?: number;
+    };
+    /** Bulk push — record one sync_log row, return summary. Caller does HTTP. */
+    recordPush(rows: SyncableRow[], remoteOrigin: string, duration_ms: number, since_cursor?: string): SyncPushResult;
+    /** Bulk pull — apply each remote row, record sync_log, return summary. */
+    applyPull(rows: SyncableRow[], remoteOrigin: string, duration_ms: number, since_cursor?: string): SyncPullResult;
+    /** Get the latest cursor from a previous sync. */
+    latestCursor(direction: 'push' | 'pull', remoteOrigin: string): string | null;
+    /** List unresolved sync conflicts. */
+    unresolvedConflicts(limit?: number): Array<{
+        id: number;
+        local_kind: string;
+        local_id: number;
+        remote_origin: string | null;
+        detected_at: string;
+        quest_id: number | null;
+    }>;
+    /** Resolve a conflict. mode: 'kept_local' | 'kept_remote' | 'merged'. */
+    resolveConflict(conflict_id: number, mode: 'kept_local' | 'kept_remote' | 'merged', merged_payload?: Record<string, unknown>): boolean;
+}
+//# sourceMappingURL=federation.d.ts.map

package/dist/federation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"federation.d.ts","sourceRoot":"","sources":["../src/federation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,CAAC;AAE/E,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,YAAY,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAUD,qBAAa,UAAU;IACT,OAAO,CAAC,EAAE;gBAAF,EAAE,EAAE,QAAQ,CAAC,QAAQ;IAEzC,6DAA6D;IAC7D,KAAK,CAAC,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO;IAS9C,8DAA8D;IAC9D,OAAO,CAAC,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO;IAShD,+DAA+D;IAC/D,cAAc,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,KAAK,SAAM,GAAG,WAAW,EAAE;IA2BjE;;;;;;;;OAQG;IACH,WAAW,CAAC,GAAG,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,UAAU,GAAG,aAAa,GAAG,UAAU,GAAG,SAAS,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE;IAsExI,6EAA6E;IAC7E,UAAU,CAAC,IAAI,EAAE,WAAW,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,cAAc;IAgBjH,0EAA0E;IAC1E,SAAS,CAAC,IAAI,EAAE,WAAW,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,cAAc;IAoBhH,kDAAkD;IAClD,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAS7E,sCAAsC;IACtC,mBAAmB,CAAC,KAAK,SAAK,GAAG,KAAK,CAAC;QACrC,EAAE,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QACjD,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;KAC5E,CAAC;IAYF,yEAAyE;IACzE,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,aAAa,GAAG,QAAQ,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;CAmCvI"}

package/dist/federation.js

@@ -0,0 +1,220 @@
+/**
+ * Federated team Wyrm (Tier 2.8).
+ *
+ * Each operator runs a local Wyrm; opt-in tagged data syncs to a shared
+ * "team Wyrm" instance. PII never leaves the local box unless explicitly
+ * shared (per-row `is_shared=1` flag — set when the operator marks a
+ * truth/quest/artifact as team-visible).
+ *
+ * Sync surface:
+ *   POST /sync/push   pushes is_shared=1 local rows changed since cursor
+ *   GET  /sync/pull   pulls remote rows changed since cursor
+ *
+ * Conflict policy: if a remote push lands on top of a local edit whose
+ * `updated_at` is newer, we DO NOT silently overwrite. Instead we record
+ * the conflict in `sync_conflicts` and mint a quest for the operator to
+ * resolve. Last-write-wins is the failure mode of every team sync tool;
+ * Wyrm refuses to silently lose work.
+ *
+ * @copyright 2026 Ghost Protocol (Pvt) Ltd. All Rights Reserved.
+ * @license Proprietary
+ */
+const KIND_TO_TABLE = {
+    session: { table: 'sessions', ts: 'created_at' },
+    quest: { table: 'quests', ts: 'created_at' },
+    truth: { table: 'ground_truths', ts: 'updated_at' },
+    artifact: { table: 'memory_artifacts', ts: 'last_accessed_at' },
+    edge: { table: 'decision_edges', ts: 'created_at' },
+};
+export class Federation {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    /** Mark a row as shared (will be picked up on next push). */
+    share(kind, id) {
+        const t = KIND_TO_TABLE[kind];
+        if (!t)
+            return false;
+        const info = this.db.prepare(`UPDATE ${t.table} SET is_shared = 1 WHERE id = ?`).run(id);
+        return info.changes > 0;
+    }
+    /** Unshare (revoke from team visibility). Local row stays. */
+    unshare(kind, id) {
+        const t = KIND_TO_TABLE[kind];
+        if (!t)
+            return false;
+        const info = this.db.prepare(`UPDATE ${t.table} SET is_shared = 0 WHERE id = ?`).run(id);
+        return info.changes > 0;
+    }
+    /** Collect rows to push: is_shared=1 AND ts > since_cursor. */
+    collectForPush(since_cursor, limit = 500) {
+        const cursor = since_cursor ?? '1970-01-01';
+        const out = [];
+        for (const [kindStr, t] of Object.entries(KIND_TO_TABLE)) {
+            if (out.length >= limit)
+                break;
+            const kind = kindStr;
+            const rows = this.db.prepare(`SELECT * FROM ${t.table}
+         WHERE is_shared = 1 AND ${t.ts} > ?
+         ORDER BY ${t.ts} ASC
+         LIMIT ?`).all(cursor, Math.max(1, limit - out.length));
+            for (const r of rows) {
+                out.push({
+                    kind,
+                    id: r.id,
+                    project_id: (r.project_id ?? null),
+                    payload: r,
+                    updated_at: r[t.ts] || new Date().toISOString(),
+                });
+            }
+        }
+        return out;
+    }
+    /** Apply a remote row locally. Returns:
+     *   { kind: 'inserted' } — fresh row, no conflict
+     *   { kind: 'overwritten' } — local row was older, remote wins
+     *   { kind: 'conflict', conflict_id } — local row newer, conflict recorded
+     * Idempotent — applying the same payload twice is a no-op.
+     *
+     * Conflict policy: if local updated_at > remote updated_at, the remote
+     * is REJECTED into sync_conflicts; a quest is minted. The local row stays.
+     */
+    applyRemote(row, remoteOrigin) {
+        const t = KIND_TO_TABLE[row.kind];
+        if (!t)
+            return { kind: 'skipped' };
+        const localTs = this.db.prepare(`SELECT ${t.ts} as ts FROM ${t.table} WHERE id = ?`).get(row.id);
+        if (!localTs) {
+            // Fresh insert. Build columns from payload, skipping id (auto-incremented)
+            // — but we want to preserve the same id so future syncs are stable.
+            // SQLite allows explicit id insert.
+            const cols = Object.keys(row.payload).filter(c => c !== 'rowid');
+            const placeholders = cols.map(() => '?').join(',');
+            const values = cols.map(c => row.payload[c]);
+            try {
+                this.db.prepare(`INSERT OR IGNORE INTO ${t.table} (${cols.join(',')}) VALUES (${placeholders})`).run(...values);
+                return { kind: 'inserted' };
+            }
+            catch {
+                return { kind: 'skipped' };
+            }
+        }
+        // Existing row — compare timestamps.
+        const localNewer = localTs.ts > row.updated_at;
+        if (localNewer) {
+            // Conflict — record it and mint a quest if this row has a project_id.
+            const conflictInfo = this.db.prepare(`
+        INSERT INTO sync_conflicts
+          (local_kind, local_id, remote_payload, remote_origin)
+        VALUES (?, ?, ?, ?)
+      `).run(row.kind, row.id, JSON.stringify(row.payload), remoteOrigin);
+            const conflict_id = conflictInfo.lastInsertRowid;
+            // Best-effort: mint a quest so the operator sees it on next session
+            if (row.project_id != null) {
+                try {
+                    this.db.prepare(`
+            INSERT INTO quests (project_id, title, description, priority, status, tags)
+            VALUES (?, ?, ?, 'high', 'pending', 'sync-conflict')
+          `).run(row.project_id, `[sync] Resolve conflict on ${row.kind} #${row.id}`, `A remote ${remoteOrigin} pushed a ${row.kind} that conflicts with a newer local edit. ` +
+                        `See sync_conflicts row #${conflict_id} for the remote payload. ` +
+                        `Resolve with wyrm_sync_resolve (kept_local | kept_remote | merged).`);
+                }
+                catch { /* best-effort */ }
+            }
+            return { kind: 'conflict', conflict_id };
+        }
+        // Local is older — accept remote overwrite.
+        const cols = Object.keys(row.payload).filter(c => c !== 'id');
+        const setClause = cols.map(c => `${c} = ?`).join(', ');
+        const values = cols.map(c => row.payload[c]);
+        try {
+            this.db.prepare(`UPDATE ${t.table} SET ${setClause} WHERE id = ?`).run(...values, row.id);
+            return { kind: 'overwritten' };
+        }
+        catch {
+            return { kind: 'skipped' };
+        }
+    }
+    /** Bulk push — record one sync_log row, return summary. Caller does HTTP. */
+    recordPush(rows, remoteOrigin, duration_ms, since_cursor) {
+        const newCursor = new Date().toISOString();
+        this.db.prepare(`
+      INSERT INTO sync_log
+        (direction, remote_origin, kind, count, since_cursor, new_cursor, duration_ms)
+      VALUES ('push', ?, 'mixed', ?, ?, ?, ?)
+    `).run(remoteOrigin, rows.length, since_cursor ?? null, newCursor, duration_ms);
+        return {
+            pushed: rows.length,
+            conflicts: 0,
+            new_cursor: newCursor,
+            conflict_ids: [],
+        };
+    }
+    /** Bulk pull — apply each remote row, record sync_log, return summary. */
+    applyPull(rows, remoteOrigin, duration_ms, since_cursor) {
+        const byKind = {};
+        let pulled = 0;
+        for (const row of rows) {
+            const result = this.applyRemote(row, remoteOrigin);
+            if (result.kind === 'inserted' || result.kind === 'overwritten') {
+                pulled++;
+                byKind[row.kind] = (byKind[row.kind] ?? 0) + 1;
+            }
+        }
+        const newCursor = new Date().toISOString();
+        this.db.prepare(`
+      INSERT INTO sync_log
+        (direction, remote_origin, kind, count, since_cursor, new_cursor, duration_ms)
+      VALUES ('pull', ?, 'mixed', ?, ?, ?, ?)
+    `).run(remoteOrigin, pulled, since_cursor ?? null, newCursor, duration_ms);
+        return { pulled, new_cursor: newCursor, by_kind: byKind };
+    }
+    /** Get the latest cursor from a previous sync. */
+    latestCursor(direction, remoteOrigin) {
+        const row = this.db.prepare(`
+      SELECT new_cursor FROM sync_log
+      WHERE direction = ? AND remote_origin = ?
+      ORDER BY id DESC LIMIT 1
+    `).get(direction, remoteOrigin);
+        return row?.new_cursor ?? null;
+    }
+    /** List unresolved sync conflicts. */
+    unresolvedConflicts(limit = 50) {
+        return this.db.prepare(`
+      SELECT id, local_kind, local_id, remote_origin, detected_at, quest_id
+      FROM sync_conflicts
+      WHERE resolved_at IS NULL
+      ORDER BY detected_at DESC LIMIT ?
+    `).all(limit);
+    }
+    /** Resolve a conflict. mode: 'kept_local' | 'kept_remote' | 'merged'. */
+    resolveConflict(conflict_id, mode, merged_payload) {
+        const conflict = this.db.prepare('SELECT * FROM sync_conflicts WHERE id = ? AND resolved_at IS NULL').get(conflict_id);
+        if (!conflict)
+            return false;
+        if (mode === 'kept_remote' || mode === 'merged') {
+            const t = KIND_TO_TABLE[conflict.local_kind];
+            if (t) {
+                const payload = mode === 'merged' && merged_payload
+                    ? merged_payload
+                    : JSON.parse(conflict.remote_payload);
+                const cols = Object.keys(payload).filter(c => c !== 'id');
+                const setClause = cols.map(c => `${c} = ?`).join(', ');
+                const values = cols.map(c => payload[c]);
+                try {
+                    this.db.prepare(`UPDATE ${t.table} SET ${setClause} WHERE id = ?`).run(...values, conflict.local_id);
+                }
+                catch { /* best-effort */ }
+            }
+        }
+        // 'kept_local' = no row mutation needed.
+        this.db.prepare(`
+      UPDATE sync_conflicts
+      SET resolved_at = datetime('now'), resolution = ?
+      WHERE id = ?
+    `).run(mode, conflict_id);
+        return true;
+    }
+}
+//# sourceMappingURL=federation.js.map

package/dist/federation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"federation.js","sourceRoot":"","sources":["../src/federation.ts"],"names":[],"mappings":"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"}

package/dist/hours.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Hour Ledger + Invoice Generator.
+ *
+ * Sessions already record start/end timestamps. This module derives:
+ *  - hours per project / per client / per date range
+ *  - markdown invoices with per-session line items
+ *
+ * Solo founders / freelancers use Wyrm for memory; this turns it into
+ * their time tracker too — no separate Toggl/Harvest needed.
+ *
+ * Session duration falls back to a configurable default (e.g. 60 min)
+ * when the session has no explicit end_time — common for "I started
+ * a session and forgot to close it". The fallback is exposed in the
+ * report so the operator can review and correct.
+ *
+ * @copyright 2026 Ghost Protocol (Pvt) Ltd. All Rights Reserved.
+ * @license Proprietary
+ */
+import type Database from 'better-sqlite3';
+export interface SessionRow {
+    id: number;
+    project_id: number;
+    date: string;
+    objectives: string | null;
+    completed: string | null;
+    notes: string | null;
+    summary: string | null;
+    created_at: string;
+}
+export interface HourReportEntry {
+    session_id: number;
+    project_id: number;
+    project_name: string;
+    date: string;
+    hours: number;
+    is_estimated: boolean;
+    summary: string | null;
+}
+export interface HourReport {
+    range: {
+        start: string;
+        end: string;
+    };
+    total_hours: number;
+    estimated_sessions: number;
+    by_project: Array<{
+        project_id: number;
+        project_name: string;
+        hours: number;
+        session_count: number;
+    }>;
+    entries: HourReportEntry[];
+}
+export interface InvoiceInput {
+    client_name: string;
+    client_address?: string;
+    business_name?: string;
+    business_address?: string;
+    business_contact?: string;
+    invoice_number?: string;
+    hourly_rate_usd: number;
+    range_start: string;
+    range_end: string;
+    project_id?: number;
+    default_session_hours?: number;
+    currency?: string;
+    notes?: string;
+}
+export declare class HourLedger {
+    private db;
+    constructor(db: Database.Database);
+    /** Hours report for a date range, optionally scoped to a project. */
+    report(opts: {
+        range_start: string;
+        range_end: string;
+        project_id?: number;
+        default_session_hours?: number;
+    }): HourReport;
+    /** Generate a markdown invoice from an hour report. */
+    invoice(input: InvoiceInput): string;
+}
+//# sourceMappingURL=hours.d.ts.map

package/dist/hours.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hours.d.ts","sourceRoot":"","sources":["../src/hours.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,OAAO,CAAC;IACtB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtG,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,UAAU;IACT,OAAO,CAAC,EAAE;gBAAF,EAAE,EAAE,QAAQ,CAAC,QAAQ;IAEzC,qEAAqE;IACrE,MAAM,CAAC,IAAI,EAAE;QACX,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,qBAAqB,CAAC,EAAE,MAAM,CAAC;KAChC,GAAG,UAAU;IA8Ed,uDAAuD;IACvD,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM;CAsErC"}