@shardworks/nexus-core 0.1.16 → 0.1.18

package/dist/clockworks.d.ts

@@ -0,0 +1,54 @@
+import type { GuildEvent } from './engine.ts';
+/**
+ * Callback for launching anima sessions. Provided by the CLI layer since
+ * the core package cannot depend on the CLI or engine-manifest directly.
+ *
+ * The Clockworks runner calls this when processing a `summon` standing order.
+ * The callback should: resolve the role to an anima, manifest it, launch
+ * a claude session, wait for exit, and return the result.
+ *
+ * If no handler is registered, summon orders are recorded but skipped.
+ */
+export type SummonHandler = (home: string, event: GuildEvent, roleName: string, noticeType: 'summon' | 'brief') => Promise<{
+    animaName: string;
+    exitCode: number;
+}>;
+/**
+ * Register a summon handler. Called once at CLI startup to wire in the
+ * session launcher without creating a circular dependency.
+ */
+export declare function registerSummonHandler(handler: SummonHandler): void;
+/** Result of processing a single event. */
+export interface TickResult {
+    eventId: number;
+    eventName: string;
+    dispatches: DispatchSummary[];
+}
+/** Summary of one standing order execution. */
+export interface DispatchSummary {
+    handlerType: 'engine' | 'anima';
+    handlerName: string;
+    status: 'success' | 'error' | 'skipped';
+    error?: string;
+}
+/** Result of a full clock run. */
+export interface ClockRunResult {
+    processed: TickResult[];
+    totalEvents: number;
+}
+/**
+ * Process the next pending event (or a specific event by id).
+ *
+ * @param home - Guild root path.
+ * @param eventId - Specific event id to process, or undefined for next pending.
+ * @returns Processing result, or null if no events to process.
+ */
+export declare function clockTick(home: string, eventId?: number): Promise<TickResult | null>;
+/**
+ * Process all pending events until the queue is empty.
+ *
+ * @param home - Guild root path.
+ * @returns Summary of all processing.
+ */
+export declare function clockRun(home: string): Promise<ClockRunResult>;
+//# sourceMappingURL=clockworks.d.ts.map

package/dist/clockworks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clockworks.d.ts","sourceRoot":"","sources":["../src/clockworks.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAI9C;;;;;;;;;GASG;AACH,MAAM,MAAM,aAAa,GAAG,CAC1B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,QAAQ,GAAG,OAAO,KAC3B,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAItD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAElE;AAED,2CAA2C;AAC3C,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,eAAe,EAAE,CAAC;CAC/B;AAED,+CAA+C;AAC/C,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,QAAQ,GAAG,OAAO,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,kCAAkC;AAClC,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,UAAU,EAAE,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;CACrB;AAwOD;;;;;;GAMG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAa1F;AAED;;;;;GAKG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAkBpE"}

package/dist/clockworks.js

@@ -0,0 +1,264 @@
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+/**
+ * Clockworks runner — processes the event queue by matching pending events
+ * to standing orders in guild.json and executing them.
+ *
+ * This is the core of Pillar 5. It reads unprocessed events from the Ledger,
+ * finds matching standing orders, and dispatches them (run engines, or
+ * summon/brief animas). Each event is marked as processed after all its
+ * standing orders have been dispatched.
+ */
+import path from 'node:path';
+import Database from 'better-sqlite3';
+import { readGuildConfig } from "./guild-config.js";
+import { readPendingEvents, readEvent, markEventProcessed, recordDispatch, signalEvent, } from "./events.js";
+import { isClockworkEngine } from "./engine.js";
+import { ledgerPath } from "./nexus-home.js";
+import { updateCommissionStatus } from "./commission.js";
+let _summonHandler = null;
+/**
+ * Register a summon handler. Called once at CLI startup to wire in the
+ * session launcher without creating a circular dependency.
+ */
+export function registerSummonHandler(handler) {
+    _summonHandler = handler;
+}
+/**
+ * Process a single event: find matching standing orders and execute them.
+ *
+ * @param home - Absolute path to the guild root.
+ * @param event - The event to process.
+ * @returns Summary of what was dispatched.
+ */
+async function processEvent(home, event) {
+    const config = readGuildConfig(home);
+    const standingOrders = config.clockworks?.standingOrders ?? [];
+    const matching = standingOrders.filter(so => so.on === event.name);
+    const dispatches = [];
+    // Check loop guard: don't process standing-order.failed events triggered
+    // by other standing-order.failed events.
+    const isFailureEvent = event.name === 'standing-order.failed';
+    const isNestedFailure = isFailureEvent &&
+        typeof event.payload === 'object' &&
+        event.payload !== null &&
+        'triggeringEvent' in event.payload &&
+        typeof event.payload.triggeringEvent === 'object' &&
+        event.payload.triggeringEvent !== null &&
+        event.payload.triggeringEvent.name === 'standing-order.failed';
+    if (isNestedFailure) {
+        // Loop guard: skip processing to prevent cascade.
+        markEventProcessed(home, event.id);
+        return { eventId: event.id, eventName: event.name, dispatches: [] };
+    }
+    for (const order of matching) {
+        if ('run' in order && order.run) {
+            const summary = await executeEngineOrder(home, event, order.run, config);
+            dispatches.push(summary);
+            // On failure, signal standing-order.failed
+            if (summary.status === 'error') {
+                signalStandingOrderFailed(home, order, event, summary.error);
+            }
+        }
+        else if ('summon' in order && order.summon) {
+            const summary = await executeAnimaOrder(home, event, order.summon, 'summon');
+            dispatches.push(summary);
+            if (summary.status === 'error') {
+                signalStandingOrderFailed(home, order, event, summary.error);
+            }
+        }
+        else if ('brief' in order && order.brief) {
+            const summary = await executeAnimaOrder(home, event, order.brief, 'brief');
+            dispatches.push(summary);
+            if (summary.status === 'error') {
+                signalStandingOrderFailed(home, order, event, summary.error);
+            }
+        }
+    }
+    markEventProcessed(home, event.id);
+    return { eventId: event.id, eventName: event.name, dispatches };
+}
+/**
+ * Execute a `run:` standing order — load and call a clockwork engine.
+ */
+async function executeEngineOrder(home, event, engineName, config) {
+    const startedAt = new Date().toISOString();
+    try {
+        // Resolve engine entry point from guild.json
+        const engineEntry = config.engines?.[engineName];
+        if (!engineEntry) {
+            throw new Error(`Engine "${engineName}" not found in guild.json engines registry.`);
+        }
+        // Resolve the engine module path
+        const enginePkg = engineEntry.package;
+        if (!enginePkg) {
+            throw new Error(`Engine "${engineName}" has no package field — cannot resolve module.`);
+        }
+        // Import the engine module
+        const mod = await import(__rewriteRelativeImportExtension(enginePkg));
+        const engineDef = mod.default;
+        if (!isClockworkEngine(engineDef)) {
+            throw new Error(`Engine "${engineName}" does not export a clockwork engine (engine() factory). ` +
+                `Only clockwork engines can be used in "run:" standing orders.`);
+        }
+        await engineDef.handler(event, { home });
+        const endedAt = new Date().toISOString();
+        recordDispatch(home, {
+            eventId: event.id,
+            handlerType: 'engine',
+            handlerName: engineName,
+            startedAt,
+            endedAt,
+            status: 'success',
+        });
+        return { handlerType: 'engine', handlerName: engineName, status: 'success' };
+    }
+    catch (err) {
+        const endedAt = new Date().toISOString();
+        const errorMsg = err instanceof Error ? err.message : String(err);
+        recordDispatch(home, {
+            eventId: event.id,
+            handlerType: 'engine',
+            handlerName: engineName,
+            startedAt,
+            endedAt,
+            status: 'error',
+            error: errorMsg,
+        });
+        return { handlerType: 'engine', handlerName: engineName, status: 'error', error: errorMsg };
+    }
+}
+/**
+ * Execute a `summon:` or `brief:` standing order.
+ *
+ * If a summon handler is registered (by the CLI layer), delegates to it
+ * for full session lifecycle: resolve anima, manifest, launch claude,
+ * wait for exit, signal session ended.
+ *
+ * If no handler is registered, records the dispatch as skipped.
+ */
+async function executeAnimaOrder(home, event, roleName, noticeType) {
+    const startedAt = new Date().toISOString();
+    if (!_summonHandler) {
+        // No handler registered — record intent but skip execution.
+        const endedAt = new Date().toISOString();
+        recordDispatch(home, {
+            eventId: event.id,
+            handlerType: 'anima',
+            handlerName: `(role: ${roleName})`,
+            targetRole: roleName,
+            noticeType,
+            startedAt,
+            endedAt,
+            status: 'success',
+        });
+        return {
+            handlerType: 'anima',
+            handlerName: `(role: ${roleName})`,
+            status: 'skipped',
+            error: 'No summon handler registered — anima session not launched.',
+        };
+    }
+    try {
+        const result = await _summonHandler(home, event, roleName, noticeType);
+        const endedAt = new Date().toISOString();
+        recordDispatch(home, {
+            eventId: event.id,
+            handlerType: 'anima',
+            handlerName: result.animaName,
+            targetRole: roleName,
+            noticeType,
+            startedAt,
+            endedAt,
+            status: 'success',
+        });
+        return {
+            handlerType: 'anima',
+            handlerName: result.animaName,
+            status: 'success',
+        };
+    }
+    catch (err) {
+        const endedAt = new Date().toISOString();
+        const errorMsg = err instanceof Error ? err.message : String(err);
+        recordDispatch(home, {
+            eventId: event.id,
+            handlerType: 'anima',
+            handlerName: `(role: ${roleName})`,
+            targetRole: roleName,
+            noticeType,
+            startedAt,
+            endedAt,
+            status: 'error',
+            error: errorMsg,
+        });
+        return {
+            handlerType: 'anima',
+            handlerName: `(role: ${roleName})`,
+            status: 'error',
+            error: errorMsg,
+        };
+    }
+}
+/**
+ * Signal standing-order.failed when a standing order execution fails.
+ */
+function signalStandingOrderFailed(home, order, triggeringEvent, error) {
+    signalEvent(home, 'standing-order.failed', {
+        standingOrder: order,
+        triggeringEvent: {
+            id: triggeringEvent.id,
+            name: triggeringEvent.name,
+        },
+        error,
+    }, 'framework');
+}
+/**
+ * Process the next pending event (or a specific event by id).
+ *
+ * @param home - Guild root path.
+ * @param eventId - Specific event id to process, or undefined for next pending.
+ * @returns Processing result, or null if no events to process.
+ */
+export async function clockTick(home, eventId) {
+    if (eventId != null) {
+        const event = readEvent(home, eventId);
+        if (!event) {
+            throw new Error(`Event #${eventId} not found.`);
+        }
+        return processEvent(home, event);
+    }
+    const pending = readPendingEvents(home);
+    if (pending.length === 0)
+        return null;
+    return processEvent(home, pending[0]);
+}
+/**
+ * Process all pending events until the queue is empty.
+ *
+ * @param home - Guild root path.
+ * @returns Summary of all processing.
+ */
+export async function clockRun(home) {
+    const processed = [];
+    let totalEvents = 0;
+    // Process in a loop because standing order failures may generate new events
+    while (true) {
+        const pending = readPendingEvents(home);
+        if (pending.length === 0)
+            break;
+        totalEvents += pending.length;
+        for (const event of pending) {
+            const result = await processEvent(home, event);
+            processed.push(result);
+        }
+    }
+    return { processed, totalEvents };
+}
+//# sourceMappingURL=clockworks.js.map

package/dist/clockworks.js.map

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

package/dist/commission.d.ts

@@ -0,0 +1,35 @@
+export interface CommissionOptions {
+    /** Absolute path to the guild root. */
+    home: string;
+    /** Commission specification — what needs to be done. */
+    spec: string;
+    /** Target workshop for the commission. */
+    workshop: string;
+}
+export interface CommissionResult {
+    /** The ID of the created commission. */
+    commissionId: number;
+}
+/**
+ * Update a commission's status and reason in the Ledger.
+ */
+export declare function updateCommissionStatus(home: string, commissionId: number, status: string, reason: string): void;
+/**
+ * Read a commission record from the Ledger.
+ */
+export declare function readCommission(home: string, commissionId: number): {
+    id: number;
+    content: string;
+    status: string;
+    workshop: string;
+    statusReason: string | null;
+} | null;
+/**
+ * Post a commission to the guild.
+ *
+ * Creates a commission in the Ledger with status "posted" and signals
+ * commission.posted for the Clockworks to pick up. Everything downstream
+ * is driven by standing orders.
+ */
+export declare function commission(opts: CommissionOptions): CommissionResult;
+//# sourceMappingURL=commission.d.ts.map

package/dist/commission.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commission.d.ts","sourceRoot":"","sources":["../src/commission.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,iBAAiB;IAChC,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,wCAAwC;IACxC,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,IAAI,CAWN;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,GACnB;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,IAAI,CA2BvG;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,iBAAiB,GAAG,gBAAgB,CA2CpE"}

package/dist/commission.js

@@ -0,0 +1,80 @@
+/**
+ * commission — core logic for posting commissions to the guild.
+ *
+ * Creates a commission record in the Ledger and signals commission.posted
+ * for the Clockworks. Everything downstream (worktree setup, anima summoning,
+ * post-session merge) is handled by standing orders.
+ */
+import Database from 'better-sqlite3';
+import { ledgerPath } from "./nexus-home.js";
+import { readGuildConfig } from "./guild-config.js";
+import { signalEvent } from "./events.js";
+/**
+ * Update a commission's status and reason in the Ledger.
+ */
+export function updateCommissionStatus(home, commissionId, status, reason) {
+    const db = new Database(ledgerPath(home));
+    db.pragma('foreign_keys = ON');
+    try {
+        db.prepare(`UPDATE commissions SET status = ?, status_reason = ?, updated_at = datetime('now') WHERE id = ?`).run(status, reason, commissionId);
+    }
+    finally {
+        db.close();
+    }
+}
+/**
+ * Read a commission record from the Ledger.
+ */
+export function readCommission(home, commissionId) {
+    const db = new Database(ledgerPath(home));
+    db.pragma('foreign_keys = ON');
+    try {
+        const row = db.prepare(`SELECT id, content, status, workshop, status_reason FROM commissions WHERE id = ?`).get(commissionId);
+        if (!row)
+            return null;
+        return {
+            id: row.id,
+            content: row.content,
+            status: row.status,
+            workshop: row.workshop,
+            statusReason: row.status_reason,
+        };
+    }
+    finally {
+        db.close();
+    }
+}
+/**
+ * Post a commission to the guild.
+ *
+ * Creates a commission in the Ledger with status "posted" and signals
+ * commission.posted for the Clockworks to pick up. Everything downstream
+ * is driven by standing orders.
+ */
+export function commission(opts) {
+    const { home, spec, workshop } = opts;
+    // Validate workshop exists in guild.json
+    const config = readGuildConfig(home);
+    if (!(workshop in config.workshops)) {
+        const available = Object.keys(config.workshops).join(', ') || '(none)';
+        throw new Error(`Workshop "${workshop}" not found in guild.json. Available workshops: ${available}`);
+    }
+    const db = new Database(ledgerPath(home));
+    db.pragma('foreign_keys = ON');
+    try {
+        const statusReason = 'posted by patron';
+        // Create commission
+        const insertCommission = db.prepare(`INSERT INTO commissions (content, status, status_reason, workshop) VALUES (?, ?, ?, ?)`);
+        const commissionResult = insertCommission.run(spec, 'posted', statusReason, workshop);
+        const commissionId = Number(commissionResult.lastInsertRowid);
+        // Audit log
+        db.prepare(`INSERT INTO audit_log (actor, action, target_type, target_id, detail) VALUES (?, ?, ?, ?, ?)`).run('patron', 'commission_posted', 'commission', commissionId, JSON.stringify({ workshop }));
+        // Signal for Clockworks
+        signalEvent(home, 'commission.posted', { commissionId, workshop }, 'framework');
+        return { commissionId };
+    }
+    finally {
+        db.close();
+    }
+}
+//# sourceMappingURL=commission.js.map

package/dist/commission.js.map

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

package/dist/engine.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Engine SDK — the authoring interface for clockwork engines.
+ *
+ * Use `engine()` to define a clockwork engine that responds to guild events.
+ * The returned definition is what the Clockworks runner imports and calls.
+ * Static engines (manifest, ledger-migrate, etc.) do NOT use this factory —
+ * they have bespoke APIs and are called directly by framework code.
+ *
+ * @example
+ * ```typescript
+ * import { engine } from '@shardworks/nexus-core';
+ *
+ * export default engine({
+ *   handler: async (event, { home }) => {
+ *     // event is the triggering GuildEvent when invoked by a standing order
+ *     // event is null when invoked directly (CLI, import)
+ *     if (event) {
+ *       console.log(`Handling ${event.name}`, event.payload);
+ *     }
+ *   }
+ * });
+ * ```
+ */
+/** An immutable fact from the event log — the input to clockwork engines. */
+export interface GuildEvent {
+    id: number;
+    name: string;
+    payload: unknown;
+    emitter: string;
+    firedAt: string;
+}
+/** Framework-provided context injected into every engine handler call. */
+export interface EngineContext {
+    /** Absolute path to the guild root. */
+    home: string;
+}
+/**
+ * A fully-defined clockwork engine — the return type of `engine()`.
+ *
+ * The Clockworks runner calls `.handler(event, { home })` when a standing
+ * order fires. The `__clockwork` brand is used at load time to distinguish
+ * clockwork engines from static engines.
+ */
+export interface EngineDefinition {
+    readonly __clockwork: true;
+    readonly handler: (event: GuildEvent | null, ctx: EngineContext) => Promise<void>;
+}
+/**
+ * Define a clockwork engine.
+ *
+ * This is the SDK entry point for event-driven engines. Pass a handler
+ * function that receives a GuildEvent (or null for direct invocation)
+ * and an EngineContext.
+ */
+export declare function engine(def: {
+    handler: (event: GuildEvent | null, ctx: EngineContext) => Promise<void>;
+}): EngineDefinition;
+/** Type guard: is this module export a clockwork engine? */
+export declare function isClockworkEngine(obj: unknown): obj is EngineDefinition;
+//# sourceMappingURL=engine.d.ts.map

package/dist/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,6EAA6E;AAC7E,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,0EAA0E;AAC1E,MAAM,WAAW,aAAa;IAC5B,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,EAAE,GAAG,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACnF;AAED;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE;IAC1B,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,EAAE,GAAG,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1E,GAAG,gBAAgB,CAKnB;AAED,4DAA4D;AAC5D,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,gBAAgB,CAQvE"}

package/dist/engine.js

@@ -0,0 +1,45 @@
+/**
+ * Engine SDK — the authoring interface for clockwork engines.
+ *
+ * Use `engine()` to define a clockwork engine that responds to guild events.
+ * The returned definition is what the Clockworks runner imports and calls.
+ * Static engines (manifest, ledger-migrate, etc.) do NOT use this factory —
+ * they have bespoke APIs and are called directly by framework code.
+ *
+ * @example
+ * ```typescript
+ * import { engine } from '@shardworks/nexus-core';
+ *
+ * export default engine({
+ *   handler: async (event, { home }) => {
+ *     // event is the triggering GuildEvent when invoked by a standing order
+ *     // event is null when invoked directly (CLI, import)
+ *     if (event) {
+ *       console.log(`Handling ${event.name}`, event.payload);
+ *     }
+ *   }
+ * });
+ * ```
+ */
+/**
+ * Define a clockwork engine.
+ *
+ * This is the SDK entry point for event-driven engines. Pass a handler
+ * function that receives a GuildEvent (or null for direct invocation)
+ * and an EngineContext.
+ */
+export function engine(def) {
+    return {
+        __clockwork: true,
+        handler: def.handler,
+    };
+}
+/** Type guard: is this module export a clockwork engine? */
+export function isClockworkEngine(obj) {
+    return (typeof obj === 'object' &&
+        obj !== null &&
+        '__clockwork' in obj &&
+        obj.__clockwork === true &&
+        typeof obj.handler === 'function');
+}
+//# sourceMappingURL=engine.js.map

package/dist/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AA6BH;;;;;;GAMG;AACH,MAAM,UAAU,MAAM,CAAC,GAEtB;IACC,OAAO;QACL,WAAW,EAAE,IAAI;QACjB,OAAO,EAAE,GAAG,CAAC,OAAO;KACrB,CAAC;AACJ,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,iBAAiB,CAAC,GAAY;IAC5C,OAAO,CACL,OAAO,GAAG,KAAK,QAAQ;QACvB,GAAG,KAAK,IAAI;QACZ,aAAa,IAAI,GAAG;QACnB,GAAwB,CAAC,WAAW,KAAK,IAAI;QAC9C,OAAQ,GAAwB,CAAC,OAAO,KAAK,UAAU,CACxD,CAAC;AACJ,CAAC"}

package/dist/events.d.ts

@@ -0,0 +1,49 @@
+import type { GuildEvent } from './engine.ts';
+/**
+ * Check if an event name is in a reserved framework namespace.
+ */
+export declare function isFrameworkEvent(name: string): boolean;
+/**
+ * Validate that a custom event name is declared in guild.json clockworks.events.
+ * Throws if the name is in a reserved namespace or not declared.
+ */
+export declare function validateCustomEvent(home: string, name: string): void;
+/**
+ * Signal an event — persist it to the Ledger's events table.
+ *
+ * Does not process the event. The Clockworks runner processes separately.
+ *
+ * @param home - Absolute path to the guild root.
+ * @param name - Event name (e.g. "commission.sealed", "code.reviewed").
+ * @param payload - Event-specific data (JSON-serializable).
+ * @param emitter - Who signaled it: anima name, engine name, or "framework".
+ * @returns The event id.
+ */
+export declare function signalEvent(home: string, name: string, payload: unknown, emitter: string): number;
+/**
+ * Read pending (unprocessed) events from the Ledger, ordered by fired_at.
+ */
+export declare function readPendingEvents(home: string): GuildEvent[];
+/**
+ * Read a single event by id.
+ */
+export declare function readEvent(home: string, id: number): GuildEvent | null;
+/**
+ * Mark an event as processed.
+ */
+export declare function markEventProcessed(home: string, eventId: number): void;
+/**
+ * Record an event dispatch in the event_dispatches table.
+ */
+export declare function recordDispatch(home: string, opts: {
+    eventId: number;
+    handlerType: 'engine' | 'anima';
+    handlerName: string;
+    targetRole?: string;
+    noticeType?: 'summon' | 'brief';
+    startedAt: string;
+    endedAt: string;
+    status: 'success' | 'error';
+    error?: string;
+}): void;
+//# 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":"AAUA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAY9C;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAiBpE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,MAAM,GACd,MAAM,CAaR;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,EAAE,CAmB5D;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAqBrE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAStE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE;IACJ,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,QAAQ,GAAG,OAAO,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GACA,IAAI,CAsBN"}