@femtomc/mu-core 0.1.0

package/README.md

@@ -0,0 +1,50 @@
+# @femtomc/mu-core
+
+Core types and utilities shared across mu packages: JSONL store abstractions, event logging, DAG helpers, and spec schemas.
+
+## Install
+
+After publishing:
+
+```bash
+npm install @femtomc/mu-core
+# or: bun add @femtomc/mu-core
+```
+
+From this repo:
+
+```bash
+cd mu
+bun install
+bun run build
+```
+
+## Usage
+
+```ts
+import { EventLog, InMemoryJsonlStore, JsonlEventSink, newRunId, runContext } from "@femtomc/mu-core/node";
+
+const jsonl = new InMemoryJsonlStore();
+const events = new EventLog(new JsonlEventSink(jsonl));
+
+await runContext({ runId: newRunId() }, async () => {
+	await events.emit("demo.event", { source: "readme", payload: { ok: true } });
+});
+
+console.log(await jsonl.read());
+```
+
+## Tests / Typecheck
+
+From the `mu/` repo root:
+
+```bash
+bun test packages/core
+bun run typecheck
+```
+
+## Runtime
+
+- `@femtomc/mu-core` is runtime-agnostic (no Node builtins).
+- `@femtomc/mu-core/node` is **Node-only** (`node:fs`, `node:async_hooks`).
+- `@femtomc/mu-core/browser` is **browser-only** (IndexedDB/localStorage).

package/dist/browser/idb.d.ts

@@ -0,0 +1,14 @@
+import type { JsonlStore } from "../persistence.js";
+export type IndexedDbJsonlStoreOpts = {
+    dbName: string;
+    storeName: string;
+    ensureStores?: readonly string[];
+};
+export declare class IndexedDbJsonlStore<T = unknown> implements JsonlStore<T> {
+    #private;
+    constructor(opts: IndexedDbJsonlStoreOpts);
+    read(): Promise<T[]>;
+    write(rows: readonly T[]): Promise<void>;
+    append(row: T): Promise<void>;
+}
+//# sourceMappingURL=idb.d.ts.map

package/dist/browser/idb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idb.d.ts","sourceRoot":"","sources":["../../src/browser/idb.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAmGpD,MAAM,MAAM,uBAAuB,GAAG;IAErC,MAAM,EAAE,MAAM,CAAC;IAGf,SAAS,EAAE,MAAM,CAAC;IAIlB,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACjC,CAAC;AAEF,qBAAa,mBAAmB,CAAC,CAAC,GAAG,OAAO,CAAE,YAAW,UAAU,CAAC,CAAC,CAAC;;gBAMlD,IAAI,EAAE,uBAAuB;IAoBnC,IAAI,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC;IAepB,KAAK,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBxC,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAa1C"}

package/dist/browser/idb.js

@@ -0,0 +1,158 @@
+function invariant(cond, msg) {
+    if (!cond) {
+        throw new Error(msg);
+    }
+}
+function getIndexedDb() {
+    return globalThis.indexedDB ?? null;
+}
+function requestToPromise(req) {
+    return new Promise((resolve, reject) => {
+        req.onsuccess = () => resolve(req.result);
+        req.onerror = () => reject(req.error ?? new Error("indexeddb request failed"));
+    });
+}
+function transactionDone(tx) {
+    return new Promise((resolve, reject) => {
+        tx.oncomplete = () => resolve();
+        tx.onabort = () => reject(tx.error ?? new Error("indexeddb transaction aborted"));
+        tx.onerror = () => reject(tx.error ?? new Error("indexeddb transaction failed"));
+    });
+}
+function hasObjectStore(db, name) {
+    const names = db.objectStoreNames;
+    if (names && typeof names.contains === "function") {
+        return names.contains(name);
+    }
+    // Fallback for older DOMStringList implementations.
+    try {
+        for (const n of names) {
+            if (n === name) {
+                return true;
+            }
+        }
+    }
+    catch { }
+    return false;
+}
+async function ensureDb(opts) {
+    const idb = getIndexedDb();
+    invariant(idb, "IndexedDB is not available in this environment");
+    // First open creates a v1 DB when missing; ensure object stores exist on create.
+    {
+        const req = idb.open(opts.dbName);
+        req.onupgradeneeded = () => {
+            const db = req.result;
+            for (const store of opts.stores) {
+                if (!hasObjectStore(db, store)) {
+                    db.createObjectStore(store, { autoIncrement: true });
+                }
+            }
+        };
+        const db = await requestToPromise(req);
+        const missing = opts.stores.filter((s) => !hasObjectStore(db, s));
+        if (missing.length === 0) {
+            return db;
+        }
+        // Upgrade by one and create missing stores.
+        const nextVersion = Math.max(1, Math.trunc(db.version ?? 1)) + 1;
+        db.close();
+        const upgradeReq = idb.open(opts.dbName, nextVersion);
+        upgradeReq.onupgradeneeded = () => {
+            const db2 = upgradeReq.result;
+            for (const store of opts.stores) {
+                if (!hasObjectStore(db2, store)) {
+                    db2.createObjectStore(store, { autoIncrement: true });
+                }
+            }
+        };
+        return await requestToPromise(upgradeReq);
+    }
+}
+async function readAllFromStore(store) {
+    const out = [];
+    return await new Promise((resolve, reject) => {
+        const req = store.openCursor();
+        req.onerror = () => reject(req.error ?? new Error("indexeddb cursor failed"));
+        req.onsuccess = () => {
+            const cursor = req.result;
+            if (!cursor) {
+                resolve(out);
+                return;
+            }
+            out.push(cursor.value);
+            cursor.continue();
+        };
+    });
+}
+export class IndexedDbJsonlStore {
+    #dbName;
+    #storeName;
+    #stores;
+    #lock = Promise.resolve();
+    constructor(opts) {
+        this.#dbName = opts.dbName;
+        this.#storeName = opts.storeName;
+        this.#stores = opts.ensureStores ?? [opts.storeName];
+    }
+    async #withLock(fn) {
+        const start = this.#lock;
+        let release = () => { };
+        this.#lock = new Promise((resolve) => {
+            release = resolve;
+        });
+        await start;
+        try {
+            return await fn();
+        }
+        finally {
+            release();
+        }
+    }
+    async read() {
+        return await this.#withLock(async () => {
+            const db = await ensureDb({ dbName: this.#dbName, stores: this.#stores });
+            try {
+                const tx = db.transaction(this.#storeName, "readonly");
+                const store = tx.objectStore(this.#storeName);
+                const rows = await readAllFromStore(store);
+                await transactionDone(tx);
+                return rows;
+            }
+            finally {
+                db.close();
+            }
+        });
+    }
+    async write(rows) {
+        await this.#withLock(async () => {
+            const db = await ensureDb({ dbName: this.#dbName, stores: this.#stores });
+            try {
+                const tx = db.transaction(this.#storeName, "readwrite");
+                const store = tx.objectStore(this.#storeName);
+                store.clear();
+                for (const row of rows) {
+                    store.add(row);
+                }
+                await transactionDone(tx);
+            }
+            finally {
+                db.close();
+            }
+        });
+    }
+    async append(row) {
+        await this.#withLock(async () => {
+            const db = await ensureDb({ dbName: this.#dbName, stores: this.#stores });
+            try {
+                const tx = db.transaction(this.#storeName, "readwrite");
+                const store = tx.objectStore(this.#storeName);
+                store.add(row);
+                await transactionDone(tx);
+            }
+            finally {
+                db.close();
+            }
+        });
+    }
+}

package/dist/browser/index.d.ts

@@ -0,0 +1,5 @@
+export type { IndexedDbJsonlStoreOpts } from "./idb.js";
+export { IndexedDbJsonlStore } from "./idb.js";
+export type { LocalStorageJsonlStoreOpts } from "./local_storage.js";
+export { LocalStorageJsonlStore } from "./local_storage.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/browser/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAC/C,YAAY,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/browser/index.js

@@ -0,0 +1,2 @@
+export { IndexedDbJsonlStore } from "./idb.js";
+export { LocalStorageJsonlStore } from "./local_storage.js";

package/dist/browser/local_storage.d.ts

@@ -0,0 +1,12 @@
+import type { JsonlStore } from "../persistence.js";
+export type LocalStorageJsonlStoreOpts = {
+    key: string;
+};
+export declare class LocalStorageJsonlStore<T = unknown> implements JsonlStore<T> {
+    #private;
+    constructor(opts: LocalStorageJsonlStoreOpts);
+    read(): Promise<T[]>;
+    write(rows: readonly T[]): Promise<void>;
+    append(row: T): Promise<void>;
+}
+//# sourceMappingURL=local_storage.d.ts.map

package/dist/browser/local_storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local_storage.d.ts","sourceRoot":"","sources":["../../src/browser/local_storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAYpD,MAAM,MAAM,0BAA0B,GAAG;IACxC,GAAG,EAAE,MAAM,CAAC;CACZ,CAAC;AAEF,qBAAa,sBAAsB,CAAC,CAAC,GAAG,OAAO,CAAE,YAAW,UAAU,CAAC,CAAC,CAAC;;gBAGrD,IAAI,EAAE,0BAA0B;IAUtC,IAAI,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC;IAYpB,KAAK,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxC,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAK1C"}

package/dist/browser/local_storage.js

@@ -0,0 +1,38 @@
+function invariant(cond, msg) {
+    if (!cond) {
+        throw new Error(msg);
+    }
+}
+function getLocalStorage() {
+    return globalThis.localStorage ?? null;
+}
+export class LocalStorageJsonlStore {
+    #key;
+    constructor(opts) {
+        this.#key = opts.key;
+    }
+    #ls() {
+        const ls = getLocalStorage();
+        invariant(ls, "localStorage is not available in this environment");
+        return ls;
+    }
+    async read() {
+        const raw = this.#ls().getItem(this.#key);
+        if (!raw) {
+            return [];
+        }
+        const parsed = JSON.parse(raw);
+        if (!Array.isArray(parsed)) {
+            throw new Error(`localStorage key ${JSON.stringify(this.#key)} did not contain an array`);
+        }
+        return parsed;
+    }
+    async write(rows) {
+        this.#ls().setItem(this.#key, JSON.stringify(rows));
+    }
+    async append(row) {
+        const rows = await this.read();
+        rows.push(row);
+        await this.write(rows);
+    }
+}

package/dist/dag.d.ts

@@ -0,0 +1,13 @@
+import type { Issue } from "./spec.js";
+export type ValidationResult = {
+    is_final: boolean;
+    reason: string;
+};
+export declare function subtreeIds(issues: readonly Issue[], rootId: string): string[];
+export declare function readyLeaves(issues: readonly Issue[], opts?: {
+    root_id?: string;
+    tags?: readonly string[];
+}): Issue[];
+export declare function collapsible(issues: readonly Issue[], rootId: string): Issue[];
+export declare function validateDag(issues: readonly Issue[], rootId: string): ValidationResult;
+//# sourceMappingURL=dag.d.ts.map

package/dist/dag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dag.d.ts","sourceRoot":"","sources":["../src/dag.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAEvC,MAAM,MAAM,gBAAgB,GAAG;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CACf,CAAC;AAiBF,wBAAgB,UAAU,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAuB7E;AAED,wBAAgB,WAAW,CAC1B,MAAM,EAAE,SAAS,KAAK,EAAE,EACxB,IAAI,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAO,GACvD,KAAK,EAAE,CAuCT;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,KAAK,EAAE,CA2B7E;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAqDtF"}

package/dist/dag.js

@@ -0,0 +1,140 @@
+function childrenByParent(issues) {
+    const byParent = new Map();
+    for (const issue of issues) {
+        for (const dep of issue.deps) {
+            if (dep.type !== "parent") {
+                continue;
+            }
+            const list = byParent.get(dep.target) ?? [];
+            list.push(issue);
+            byParent.set(dep.target, list);
+        }
+    }
+    return byParent;
+}
+export function subtreeIds(issues, rootId) {
+    const children = childrenByParent(issues);
+    const result = [];
+    const q = [rootId];
+    const seen = new Set();
+    while (q.length > 0) {
+        const nodeId = q.shift();
+        if (!nodeId) {
+            continue;
+        }
+        if (seen.has(nodeId)) {
+            continue;
+        }
+        seen.add(nodeId);
+        result.push(nodeId);
+        for (const child of children.get(nodeId) ?? []) {
+            q.push(child.id);
+        }
+    }
+    return result;
+}
+export function readyLeaves(issues, opts = {}) {
+    const byId = new Map(issues.map((i) => [i.id, i]));
+    const idsInScope = new Set(opts.root_id ? subtreeIds(issues, opts.root_id) : byId.keys());
+    const blocked = new Set();
+    for (const issue of issues) {
+        for (const dep of issue.deps) {
+            if (dep.type !== "blocks") {
+                continue;
+            }
+            if (issue.status !== "closed" || issue.outcome === "expanded") {
+                blocked.add(dep.target);
+            }
+        }
+    }
+    const children = childrenByParent(issues);
+    const result = [];
+    for (const issueId of idsInScope) {
+        const issue = byId.get(issueId);
+        if (!issue || issue.status !== "open") {
+            continue;
+        }
+        if (blocked.has(issueId)) {
+            continue;
+        }
+        const kids = children.get(issueId) ?? [];
+        if (kids.some((kid) => kid.status !== "closed")) {
+            continue;
+        }
+        if (opts.tags && !opts.tags.every((tag) => issue.tags.includes(tag))) {
+            continue;
+        }
+        result.push(issue);
+    }
+    result.sort((a, b) => (a.priority ?? 3) - (b.priority ?? 3));
+    return result;
+}
+export function collapsible(issues, rootId) {
+    const byId = new Map(issues.map((i) => [i.id, i]));
+    const idsInScope = new Set(subtreeIds(issues, rootId));
+    const children = childrenByParent(issues);
+    const terminalOutcomes = new Set(["success", "skipped"]);
+    const result = [];
+    for (const issueId of idsInScope) {
+        const node = byId.get(issueId);
+        if (!node) {
+            continue;
+        }
+        if (node.status !== "closed" || node.outcome !== "expanded") {
+            continue;
+        }
+        const kids = children.get(issueId) ?? [];
+        if (kids.length === 0) {
+            continue;
+        }
+        if (kids.every((kid) => kid.status === "closed" && kid.outcome != null && terminalOutcomes.has(kid.outcome))) {
+            result.push(node);
+        }
+    }
+    result.sort((a, b) => a.id.localeCompare(b.id));
+    return result;
+}
+export function validateDag(issues, rootId) {
+    const byId = new Map(issues.map((i) => [i.id, i]));
+    const ids = new Set(subtreeIds(issues, rootId));
+    const root = byId.get(rootId);
+    if (!root) {
+        return { is_final: true, reason: "root not found" };
+    }
+    const children = childrenByParent(issues);
+    const needsReorch = [...ids]
+        .filter((issueId) => {
+        const issue = byId.get(issueId);
+        return issue?.status === "closed" && (issue.outcome === "failure" || issue.outcome === "needs_work");
+    })
+        .sort();
+    if (needsReorch.length > 0) {
+        return { is_final: false, reason: `needs work: ${needsReorch.join(",")}` };
+    }
+    const badExpanded = [...ids]
+        .filter((issueId) => {
+        const issue = byId.get(issueId);
+        return (issue?.status === "closed" && issue.outcome === "expanded" && (children.get(issueId)?.length ?? 0) === 0);
+    })
+        .sort();
+    if (badExpanded.length > 0) {
+        return { is_final: false, reason: `expanded without children: ${badExpanded.join(",")}` };
+    }
+    const pending = [...ids].filter((issueId) => {
+        const issue = byId.get(issueId);
+        if (!issue) {
+            return false;
+        }
+        if (issue.status === "closed" && issue.outcome === "expanded") {
+            return false;
+        }
+        return issue.status !== "closed";
+    });
+    if (pending.length === 0) {
+        return { is_final: true, reason: "all work completed" };
+    }
+    if (pending.length === 1 && pending[0] === rootId && ids.size > 1) {
+        return { is_final: false, reason: "all children closed, root still open" };
+    }
+    return { is_final: false, reason: "in progress" };
+}

package/dist/events.d.ts

@@ -0,0 +1,44 @@
+import type { JsonlStore } from "./persistence.js";
+export declare const EVENT_VERSION = 1;
+export type EventEnvelope = {
+    v: number;
+    ts_ms: number;
+    type: string;
+    source: string;
+    payload: Record<string, unknown>;
+    run_id?: string;
+    issue_id?: string;
+};
+export type RunIdProvider = () => string | null;
+export type EventSink = {
+    emit(event: EventEnvelope): Promise<void>;
+};
+export declare class NullEventSink implements EventSink {
+    emit(_event: EventEnvelope): Promise<void>;
+}
+export declare class JsonlEventSink implements EventSink {
+    #private;
+    constructor(store: Pick<JsonlStore<EventEnvelope>, "append">);
+    emit(event: EventEnvelope): Promise<void>;
+}
+export declare function currentRunId(): string | null;
+export declare function runContext<T>(opts: {
+    runId: string | null;
+}, fn: () => T): T;
+export declare function runContext<T>(opts: {
+    runId: string | null;
+}, fn: () => Promise<T>): Promise<T>;
+export declare class EventLog {
+    #private;
+    constructor(sink: EventSink, opts?: {
+        runIdProvider?: RunIdProvider;
+    });
+    emit(eventType: string, opts: {
+        source: string;
+        payload?: Record<string, unknown>;
+        issueId?: string;
+        runId?: string | null;
+        tsMs?: number;
+    }): Promise<EventEnvelope>;
+}
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,eAAO,MAAM,aAAa,IAAI,CAAC;AAE/B,MAAM,MAAM,aAAa,GAAG;IAC3B,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,MAAM,MAAM,GAAG,IAAI,CAAC;AAEhD,MAAM,MAAM,SAAS,GAAG;IACvB,IAAI,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1C,CAAC;AAEF,qBAAa,aAAc,YAAW,SAAS;IACjC,IAAI,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;CACvD;AAED,qBAAa,cAAe,YAAW,SAAS;;gBAG5B,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,QAAQ,CAAC;IAItD,IAAI,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;CAGtD;AAID,wBAAgB,YAAY,IAAI,MAAM,GAAG,IAAI,CAK5C;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;AAC9E,wBAAgB,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAwBhG,qBAAa,QAAQ;;gBAID,IAAI,EAAE,SAAS,EAAE,IAAI,GAAE;QAAE,aAAa,CAAC,EAAE,aAAa,CAAA;KAAO;IAKnE,IAAI,CAChB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE;QACL,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClC,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,EAAE,MAAM,CAAC;KACd,GACC,OAAO,CAAC,aAAa,CAAC;CAwBzB"}

package/dist/events.js

@@ -0,0 +1,72 @@
+export const EVENT_VERSION = 1;
+export class NullEventSink {
+    async emit(_event) { }
+}
+export class JsonlEventSink {
+    #store;
+    constructor(store) {
+        this.#store = store;
+    }
+    async emit(event) {
+        await this.#store.append(event);
+    }
+}
+const runIdStack = [];
+export function currentRunId() {
+    if (runIdStack.length === 0) {
+        return null;
+    }
+    return runIdStack[runIdStack.length - 1] ?? null;
+}
+export function runContext(opts, fn) {
+    runIdStack.push(opts.runId);
+    let popped = false;
+    const pop = () => {
+        if (!popped) {
+            popped = true;
+            runIdStack.pop();
+        }
+    };
+    try {
+        const out = fn();
+        if (out && typeof out.then === "function") {
+            return out.finally(pop);
+        }
+        pop();
+        return out;
+    }
+    catch (err) {
+        pop();
+        throw err;
+    }
+}
+export class EventLog {
+    #sink;
+    #runIdProvider;
+    constructor(sink, opts = {}) {
+        this.#sink = sink;
+        this.#runIdProvider = opts.runIdProvider ?? currentRunId;
+    }
+    async emit(eventType, opts) {
+        const payload = opts.payload ?? {};
+        if (typeof payload !== "object" || payload === null || Array.isArray(payload)) {
+            throw new TypeError("payload must be an object");
+        }
+        const resolvedRunId = opts.runId != null ? opts.runId : this.#runIdProvider();
+        const event = {
+            v: EVENT_VERSION,
+            ts_ms: Math.trunc(opts.tsMs ?? Date.now()),
+            type: eventType,
+            source: opts.source,
+            payload,
+        };
+        if (resolvedRunId != null) {
+            event.run_id = resolvedRunId;
+        }
+        if (opts.issueId != null) {
+            event.issue_id = opts.issueId;
+        }
+        await this.#sink.emit(event);
+        return event;
+    }
+}

package/dist/ids.d.ts

@@ -0,0 +1,6 @@
+export declare function randomHex(bytes: number): string;
+export declare function shortId(): string;
+export declare function newRunId(): string;
+export declare function nowTs(): number;
+export declare function nowTsMs(): number;
+//# sourceMappingURL=ids.d.ts.map

package/dist/ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../src/ids.ts"],"names":[],"mappings":"AAmBA,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,wBAAgB,OAAO,IAAI,MAAM,CAGhC;AAED,wBAAgB,QAAQ,IAAI,MAAM,CAGjC;AAED,wBAAgB,KAAK,IAAI,MAAM,CAG9B;AAED,wBAAgB,OAAO,IAAI,MAAM,CAGhC"}

package/dist/ids.js

@@ -0,0 +1,34 @@
+function hexByte(n) {
+    return n.toString(16).padStart(2, "0");
+}
+function randomBytes(len) {
+    const out = new Uint8Array(len);
+    const c = globalThis.crypto;
+    if (c?.getRandomValues) {
+        c.getRandomValues(out);
+        return out;
+    }
+    for (let i = 0; i < out.length; i++) {
+        out[i] = Math.floor(Math.random() * 256);
+    }
+    return out;
+}
+export function randomHex(bytes) {
+    return [...randomBytes(bytes)].map(hexByte).join("");
+}
+export function shortId() {
+    // 8 hex chars for compact, human-scannable IDs.
+    return randomHex(4);
+}
+export function newRunId() {
+    // Python uses uuid4().hex (32 hex chars, no dashes).
+    return randomHex(16);
+}
+export function nowTs() {
+    // Seconds since Unix epoch.
+    return Math.floor(Date.now() / 1000);
+}
+export function nowTsMs() {
+    // Milliseconds since Unix epoch.
+    return Date.now();
+}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./dag.js";
+export * from "./events.js";
+export * from "./ids.js";
+export * from "./persistence.js";
+export * from "./spec.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export * from "./dag.js";
+export * from "./events.js";
+export * from "./ids.js";
+export * from "./persistence.js";
+export * from "./spec.js";

package/dist/node/index.d.ts

@@ -0,0 +1,14 @@
+export { appendJsonl, FsJsonlStore, readJsonl, streamJsonl, writeJsonl } from "./jsonl.js";
+export { currentRunId, runContext } from "./run_context.js";
+export { executionSpecFromDict } from "./spec.js";
+export type { StorePaths } from "./store.js";
+export { findRepoRoot, getStorePaths } from "./store.js";
+import { EventLog } from "../events.js";
+export declare function fsEventLog(path: string): EventLog;
+export declare function fsEventLogFromRepoRoot(repoRoot: string): EventLog;
+export * from "../dag.js";
+export { EVENT_VERSION, type EventEnvelope, EventLog, type EventSink, JsonlEventSink, NullEventSink, type RunIdProvider, } from "../events.js";
+export { newRunId, nowTs, nowTsMs, randomHex, shortId } from "../ids.js";
+export { InMemoryJsonlStore, type JsonlStore } from "../persistence.js";
+export * from "../spec.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/node/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/node/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC3F,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAClD,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEzD,OAAO,EAAE,QAAQ,EAAkB,MAAM,cAAc,CAAC;AAKxD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAEjD;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAEjE;AAED,cAAc,WAAW,CAAC;AAE1B,OAAO,EACN,aAAa,EACb,KAAK,aAAa,EAClB,QAAQ,EACR,KAAK,SAAS,EACd,cAAc,EACd,aAAa,EACb,KAAK,aAAa,GAClB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACxE,cAAc,YAAY,CAAC"}

package/dist/node/index.js

@@ -0,0 +1,20 @@
+export { appendJsonl, FsJsonlStore, readJsonl, streamJsonl, writeJsonl } from "./jsonl.js";
+export { currentRunId, runContext } from "./run_context.js";
+export { executionSpecFromDict } from "./spec.js";
+export { findRepoRoot, getStorePaths } from "./store.js";
+import { EventLog, JsonlEventSink } from "../events.js";
+import { FsJsonlStore } from "./jsonl.js";
+import { currentRunId } from "./run_context.js";
+import { getStorePaths } from "./store.js";
+export function fsEventLog(path) {
+    return new EventLog(new JsonlEventSink(new FsJsonlStore(path)), { runIdProvider: currentRunId });
+}
+export function fsEventLogFromRepoRoot(repoRoot) {
+    return fsEventLog(getStorePaths(repoRoot).eventsPath);
+}
+export * from "../dag.js";
+// Re-export the node-free surface so node code can import from a single place.
+export { EVENT_VERSION, EventLog, JsonlEventSink, NullEventSink, } from "../events.js";
+export { newRunId, nowTs, nowTsMs, randomHex, shortId } from "../ids.js";
+export { InMemoryJsonlStore } from "../persistence.js";
+export * from "../spec.js";

package/dist/node/jsonl.d.ts

@@ -0,0 +1,13 @@
+import type { JsonlStore } from "../persistence.js";
+export declare function streamJsonl(path: string): AsyncGenerator<unknown>;
+export declare function readJsonl(path: string): Promise<unknown[]>;
+export declare function writeJsonl(path: string, rows: readonly unknown[]): Promise<void>;
+export declare function appendJsonl(path: string, row: unknown): Promise<void>;
+export declare class FsJsonlStore<T = unknown> implements JsonlStore<T> {
+    readonly path: string;
+    constructor(path: string);
+    read(): Promise<T[]>;
+    write(rows: readonly T[]): Promise<void>;
+    append(row: T): Promise<void>;
+}
+//# sourceMappingURL=jsonl.d.ts.map

package/dist/node/jsonl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonl.d.ts","sourceRoot":"","sources":["../../src/node/jsonl.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAmBpD,wBAAuB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAAC,OAAO,CAAC,CAmBxE;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAMhE;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAOtF;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAU3E;AAED,qBAAa,YAAY,CAAC,CAAC,GAAG,OAAO,CAAE,YAAW,UAAU,CAAC,CAAC,CAAC;IAC9D,SAAgB,IAAI,EAAE,MAAM,CAAC;gBAEV,IAAI,EAAE,MAAM;IAIlB,IAAI,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC;IAIpB,KAAK,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxC,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAG1C"}

package/dist/node/jsonl.js

@@ -0,0 +1,80 @@
+import { createReadStream } from "node:fs";
+import { mkdir, open, rename, stat, writeFile } from "node:fs/promises";
+import { dirname, join, parse as parsePath } from "node:path";
+import { createInterface } from "node:readline";
+function tmpPathFor(path) {
+    const parsed = parsePath(path);
+    return join(parsed.dir, `${parsed.name}.tmp`);
+}
+async function exists(path) {
+    try {
+        await stat(path);
+        return true;
+    }
+    catch (err) {
+        if (err instanceof Error && "code" in err && err.code === "ENOENT") {
+            return false;
+        }
+        throw err;
+    }
+}
+export async function* streamJsonl(path) {
+    if (!(await exists(path))) {
+        return;
+    }
+    const file = createReadStream(path, { encoding: "utf8" });
+    const rl = createInterface({ input: file, crlfDelay: Number.POSITIVE_INFINITY });
+    try {
+        for await (const line of rl) {
+            const trimmed = line.trim();
+            if (trimmed.length === 0) {
+                continue;
+            }
+            yield JSON.parse(trimmed);
+        }
+    }
+    finally {
+        rl.close();
+        file.close();
+    }
+}
+export async function readJsonl(path) {
+    const rows = [];
+    for await (const row of streamJsonl(path)) {
+        rows.push(row);
+    }
+    return rows;
+}
+export async function writeJsonl(path, rows) {
+    await mkdir(dirname(path), { recursive: true });
+    const tmp = tmpPathFor(path);
+    const out = rows.map((row) => `${JSON.stringify(row)}\n`).join("");
+    await writeFile(tmp, out, "utf8");
+    await rename(tmp, path);
+}
+export async function appendJsonl(path, row) {
+    await mkdir(dirname(path), { recursive: true });
+    const line = `${JSON.stringify(row)}\n`;
+    const fh = await open(path, "a");
+    try {
+        await fh.writeFile(line, { encoding: "utf8" });
+    }
+    finally {
+        await fh.close();
+    }
+}
+export class FsJsonlStore {
+    path;
+    constructor(path) {
+        this.path = path;
+    }
+    async read() {
+        return (await readJsonl(this.path));
+    }
+    async write(rows) {
+        await writeJsonl(this.path, rows);
+    }
+    async append(row) {
+        await appendJsonl(this.path, row);
+    }
+}

package/dist/node/run_context.d.ts

@@ -0,0 +1,5 @@
+export declare function currentRunId(): string | null;
+export declare function runContext<T>(opts: {
+    runId: string | null;
+}, fn: () => T): T;
+//# sourceMappingURL=run_context.d.ts.map

package/dist/node/run_context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run_context.d.ts","sourceRoot":"","sources":["../../src/node/run_context.ts"],"names":[],"mappings":"AAIA,wBAAgB,YAAY,IAAI,MAAM,GAAG,IAAI,CAE5C;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAE5E"}

package/dist/node/run_context.js

@@ -0,0 +1,8 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+const runIdStore = new AsyncLocalStorage();
+export function currentRunId() {
+    return runIdStore.getStore() ?? null;
+}
+export function runContext(opts, fn) {
+    return runIdStore.run(opts.runId, fn);
+}

package/dist/node/spec.d.ts

@@ -0,0 +1,3 @@
+import type { ExecutionSpec } from "../spec.js";
+export declare function executionSpecFromDict(d: Record<string, unknown>, repoRoot?: string): ExecutionSpec;
+//# sourceMappingURL=spec.d.ts.map

package/dist/node/spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.d.ts","sourceRoot":"","sources":["../../src/node/spec.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAMhD,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,aAAa,CAwBlG"}

package/dist/node/spec.js

@@ -0,0 +1,27 @@
+import { existsSync } from "node:fs";
+import { isAbsolute, join } from "node:path";
+function emptyStringToNull(value) {
+    return typeof value === "string" && value.length > 0 ? value : null;
+}
+export function executionSpecFromDict(d, repoRoot) {
+    let prompt_path = emptyStringToNull(d.prompt_path);
+    const role = emptyStringToNull(d.role);
+    // Auto-resolve prompt_path from role name
+    if (!prompt_path && role && repoRoot) {
+        const candidate = join(repoRoot, ".mu", "roles", `${role}.md`);
+        if (existsSync(candidate)) {
+            prompt_path = candidate;
+        }
+    }
+    // Resolve relative prompt_path against repoRoot
+    if (repoRoot && prompt_path && !isAbsolute(prompt_path)) {
+        prompt_path = join(repoRoot, prompt_path);
+    }
+    return {
+        role,
+        prompt_path,
+        cli: emptyStringToNull(d.cli),
+        model: emptyStringToNull(d.model),
+        reasoning: emptyStringToNull(d.reasoning),
+    };
+}

package/dist/node/store.d.ts

@@ -0,0 +1,13 @@
+export type StorePaths = {
+    repoRoot: string;
+    storeDir: string;
+    issuesPath: string;
+    forumPath: string;
+    eventsPath: string;
+    logsDir: string;
+    rolesDir: string;
+    orchestratorPath: string;
+};
+export declare function findRepoRoot(start?: string): string;
+export declare function getStorePaths(repoRoot: string): StorePaths;
+//# sourceMappingURL=store.d.ts.map

package/dist/node/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/node/store.ts"],"names":[],"mappings":"AAwBA,MAAM,MAAM,UAAU,GAAG;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,wBAAgB,YAAY,CAAC,KAAK,GAAE,MAAsB,GAAG,MAAM,CAgBlE;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CAY1D"}

package/dist/node/store.js

@@ -0,0 +1,51 @@
+import { statSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+function isDirectory(path) {
+    try {
+        return statSync(path).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+function toDirectory(path) {
+    try {
+        const st = statSync(path);
+        if (st.isDirectory()) {
+            return path;
+        }
+        return dirname(path);
+    }
+    catch {
+        // If the path doesn't exist, treat it as a directory-like string.
+        return path;
+    }
+}
+export function findRepoRoot(start = process.cwd()) {
+    const startDir = resolve(toDirectory(start));
+    let current = startDir;
+    while (true) {
+        const storeDir = join(current, ".mu");
+        if (isDirectory(storeDir)) {
+            return current;
+        }
+        const parent = dirname(current);
+        if (parent === current) {
+            return startDir;
+        }
+        current = parent;
+    }
+}
+export function getStorePaths(repoRoot) {
+    const storeDir = join(repoRoot, ".mu");
+    return {
+        repoRoot,
+        storeDir,
+        issuesPath: join(storeDir, "issues.jsonl"),
+        forumPath: join(storeDir, "forum.jsonl"),
+        eventsPath: join(storeDir, "events.jsonl"),
+        logsDir: join(storeDir, "logs"),
+        rolesDir: join(storeDir, "roles"),
+        orchestratorPath: join(storeDir, "orchestrator.md"),
+    };
+}

package/dist/persistence.d.ts

@@ -0,0 +1,13 @@
+export type JsonlStore<T = unknown> = {
+    read(): Promise<T[]>;
+    write(rows: readonly T[]): Promise<void>;
+    append(row: T): Promise<void>;
+};
+export declare class InMemoryJsonlStore<T = unknown> implements JsonlStore<T> {
+    #private;
+    constructor(initial?: readonly T[]);
+    read(): Promise<T[]>;
+    write(rows: readonly T[]): Promise<void>;
+    append(row: T): Promise<void>;
+}
+//# sourceMappingURL=persistence.d.ts.map

package/dist/persistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.d.ts","sourceRoot":"","sources":["../src/persistence.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,CAAC,CAAC,GAAG,OAAO,IAAI;IACrC,IAAI,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IACrB,KAAK,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B,CAAC;AAEF,qBAAa,kBAAkB,CAAC,CAAC,GAAG,OAAO,CAAE,YAAW,UAAU,CAAC,CAAC,CAAC;;gBAGjD,OAAO,GAAE,SAAS,CAAC,EAAO;IAIhC,IAAI,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC;IAIpB,KAAK,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxC,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAG1C"}

package/dist/persistence.js

@@ -0,0 +1,15 @@
+export class InMemoryJsonlStore {
+    #rows;
+    constructor(initial = []) {
+        this.#rows = [...initial];
+    }
+    async read() {
+        return [...this.#rows];
+    }
+    async write(rows) {
+        this.#rows = [...rows];
+    }
+    async append(row) {
+        this.#rows.push(row);
+    }
+}

package/dist/spec.d.ts

@@ -0,0 +1,49 @@
+import { z } from "zod";
+export type ExecutionSpec = {
+    role: string | null;
+    prompt_path: string | null;
+    cli: string | null;
+    model: string | null;
+    reasoning: string | null;
+};
+export declare const DepSchema: z.ZodObject<{
+    type: z.ZodString;
+    target: z.ZodString;
+}, z.core.$loose>;
+export type Dep = z.infer<typeof DepSchema>;
+export declare const IssueSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    body: z.ZodString;
+    status: z.ZodEnum<{
+        open: "open";
+        in_progress: "in_progress";
+        closed: "closed";
+    }>;
+    outcome: z.ZodNullable<z.ZodString>;
+    tags: z.ZodArray<z.ZodString>;
+    deps: z.ZodArray<z.ZodObject<{
+        type: z.ZodString;
+        target: z.ZodString;
+    }, z.core.$loose>>;
+    execution_spec: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    priority: z.ZodNumber;
+    created_at: z.ZodNumber;
+    updated_at: z.ZodNumber;
+}, z.core.$loose>;
+export type Issue = z.infer<typeof IssueSchema>;
+export declare const ForumMessageSchema: z.ZodObject<{
+    topic: z.ZodString;
+    body: z.ZodString;
+    author: z.ZodString;
+    created_at: z.ZodNumber;
+}, z.core.$loose>;
+export type ForumMessage = z.infer<typeof ForumMessageSchema>;
+export declare const PromptFrontmatterSchema: z.ZodObject<{
+    cli: z.ZodOptional<z.ZodString>;
+    model: z.ZodOptional<z.ZodString>;
+    reasoning: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+export type PromptFrontmatter = z.infer<typeof PromptFrontmatterSchema>;
+//# sourceMappingURL=spec.d.ts.map

package/dist/spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.d.ts","sourceRoot":"","sources":["../src/spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,MAAM,aAAa,GAAG;IAC3B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB,CAAC;AAEF,eAAO,MAAM,SAAS;;;iBAKP,CAAC;AAChB,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAE5C,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;iBAcT,CAAC;AAChB,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEhD,eAAO,MAAM,kBAAkB;;;;;iBAOhB,CAAC;AAChB,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,uBAAuB;;;;;iBAOrB,CAAC;AAChB,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC"}

package/dist/spec.js

@@ -0,0 +1,38 @@
+import { z } from "zod";
+export const DepSchema = z
+    .object({
+    type: z.string().min(1),
+    target: z.string().min(1),
+})
+    .passthrough();
+export const IssueSchema = z
+    .object({
+    id: z.string().min(1),
+    title: z.string(),
+    body: z.string(),
+    status: z.enum(["open", "in_progress", "closed"]),
+    outcome: z.string().nullable(),
+    tags: z.array(z.string()),
+    deps: z.array(DepSchema),
+    execution_spec: z.record(z.string(), z.unknown()).nullable(),
+    priority: z.number().int(),
+    created_at: z.number().int(),
+    updated_at: z.number().int(),
+})
+    .passthrough();
+export const ForumMessageSchema = z
+    .object({
+    topic: z.string().min(1),
+    body: z.string(),
+    author: z.string().min(1),
+    created_at: z.number().int(),
+})
+    .passthrough();
+export const PromptFrontmatterSchema = z
+    .object({
+    cli: z.string().optional(),
+    model: z.string().optional(),
+    reasoning: z.string().optional(),
+    description: z.string().optional(),
+})
+    .passthrough();

package/package.json

@@ -0,0 +1,25 @@
+{
+	"name": "@femtomc/mu-core",
+	"version": "0.1.0",
+	"type": "module",
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"default": "./dist/index.js"
+		},
+		"./browser": {
+			"types": "./dist/browser/index.d.ts",
+			"default": "./dist/browser/index.js"
+		},
+		"./node": {
+			"types": "./dist/node/index.d.ts",
+			"default": "./dist/node/index.js"
+		}
+	},
+	"files": ["dist/**"],
+	"dependencies": {
+		"zod": "^4.1.9"
+	}
+}