@crewhaus/event-log 0.2.3 → 0.3.0

package/dist/index.d.ts

@@ -1,5 +1,40 @@
 export declare const DEFAULT_ROOT_DIR = ".crewhaus/sessions";
-export type EventKind = "user_message" | "assistant_message" | "tool_use" | "tool_result" | "error" | "compaction" | "sub_agent_start" | "sub_agent_end" | "role_start" | "role_end" | "handoff" | "a2a_message" | "a2a_turn_start" | "a2a_turn_end" | "crew_done" | "cost_accrual" | "user_feedback" | "recovery" | "tool_stats" | "permission" | "model_meta" | "mcp_stats" | "model_route";
+export type EventKind = "user_message" | "assistant_message" | "tool_use" | "tool_result" | "error" | "run_failed" | "context_evicted" | "compaction" | "sub_agent_start" | "sub_agent_end" | "role_start" | "role_end" | "handoff" | "a2a_message" | "a2a_turn_start" | "a2a_turn_end" | "crew_done" | "cost_accrual" | "user_feedback" | "recovery" | "tool_stats" | "permission" | "model_meta" | "mcp_stats" | "model_route" | "wiki_write" | "plan_update" | "goal_update" | "action_proof" | "dream_run";
+/**
+ * Payload for the `wiki_write` event kind (0.3.0 design §9): which article
+ * was mutated, at what version, and how. `action` distinguishes a body
+ * upsert (`"write"`), a reflection-pass signals change (`"set_signals"`),
+ * and the standalone `log_knowledge_gap` fallback (`"gap"`).
+ */
+export type WikiWriteEventPayload = {
+    readonly slug: string;
+    readonly version: number;
+    readonly action: "write" | "set_signals" | "gap";
+    /** thredz-parity `editMessage`, when the model supplied one. */
+    readonly editMessage?: string;
+};
+/**
+ * Payload for the `dream_run` event kind (0.3.0 design §6): proof one
+ * scheduled-consolidation run happened, with what outcome, and — when the
+ * model phase ran — which tool calls it left behind as evidence. The counts
+ * object mirrors dream-engine's `DreamPhase1Counts` (kept structural here so
+ * event-log stays dependency-free).
+ */
+export type DreamRunEventPayload = {
+    readonly specName: string;
+    /** What fired the run: `cli` verb, `boot` catch-up, or a daemon `janitor` tick. */
+    readonly trigger: string;
+    /** `deterministic` | `full` | `model_refused_unpriced` | `model_failed`. */
+    readonly outcome: string;
+    /** The idempotency window this run consumed (`dream:<spec>:<windowIndex>`). */
+    readonly windowKey: string;
+    readonly phase1Counts: Readonly<Record<string, number>>;
+    /** The dream model session, when the model phase ran. */
+    readonly sessionId?: string;
+    readonly spentUsd?: number;
+    /** Successful toolUseIds from the model phase — the §6.2 evidence trail. */
+    readonly evidence?: readonly string[];
+};
 export type Event = {
     readonly ts: number;
     readonly version: 1;
@@ -26,3 +61,40 @@ export interface EventLog {
  * sees a consistent snapshot of the bytes already on disk.
  */
 export declare function openEventLog(sessionId: string, opts?: OpenEventLogOptions): Promise<EventLog>;
+/** Payload of a `plan_update` event — one plan mutation (creation, a new
+ *  step, a ladder-status move up to `claimed`, the active-plan pointer, or
+ *  the machine-checked `prove_step` transition recorded alongside its
+ *  `action_proof` events). */
+export type PlanUpdateEventPayload = {
+    readonly planId: string;
+    readonly action: "create" | "add_step" | "set_step_status" | "set_active" | "prove_step";
+    readonly step?: number;
+    readonly status?: string;
+    readonly title?: string;
+    /** v0.3.0 §7.1 — `formatAgentIdentity` of the acting run context when one
+     *  is set (e.g. `subagent=researcher` for a plan mutation made from inside
+     *  a sub-agent). Absent for top-level runs. */
+    readonly agentIdentity?: string;
+};
+/** Payload of a `goal_update` event — one goal creation or mutation. */
+export type GoalUpdateEventPayload = {
+    readonly goalId: string;
+    readonly action: "create" | "update";
+    readonly status?: string;
+    readonly title?: string;
+    /** See `PlanUpdateEventPayload.agentIdentity`. */
+    readonly agentIdentity?: string;
+};
+/** Payload of an `action_proof` event — one evidence reference checked
+ *  during a `proven` transition. `verified` means the cited `tool_use` /
+ *  `tool_result` pair resolved in a session log (parent or child) with
+ *  `isError` false; `missing` and `error_result` record rejected attempts so
+ *  the audit trail shows proof pressure, not just successes. */
+export type ActionProofEventPayload = {
+    readonly planId: string;
+    readonly step: number;
+    readonly toolUseId: string;
+    readonly verdict: "verified" | "missing" | "error_result";
+    /** See `PlanUpdateEventPayload.agentIdentity`. */
+    readonly agentIdentity?: string;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crewhaus/event-log",
-  "version": "0.2.3",
+  "version": "0.3.0",
   "type": "module",
   "description": "Append-only JSONL transcript log per session",
   "main": "dist/index.js",
@@ -15,8 +15,8 @@
     "test": "bun test src"
   },
   "dependencies": {
-    "@crewhaus/errors": "0.2.3",
-    "@crewhaus/tenancy": "0.2.3"
+    "@crewhaus/errors": "0.3.0",
+    "@crewhaus/tenancy": "0.3.0"
   },
   "license": "Apache-2.0",
   "author": {