@nebutra/event-log 0.1.2 → 0.1.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nebutra/event-log",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Append-only event log with content-addressed snapshots",
   "private": false,
   "license": "MIT",
@@ -11,22 +11,31 @@
     "surface": "persistence",
     "summary": "Immutable event log, rollback dry-runs, and branches"
   },
-  "main": "./src/index.ts",
-  "types": "./src/index.ts",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "exports": {
-    ".": "./src/index.ts"
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@noble/hashes": "2.0.1",
-    "@nebutra/capability-kit": "0.2.2",
-    "@nebutra/content-store": "0.1.2",
-    "@nebutra/errors": "0.1.2"
+    "@nebutra/capability-kit": "workspace:*",
+    "@nebutra/content-store": "workspace:*",
+    "@nebutra/errors": "workspace:*",
+    "@noble/hashes": "2.0.1"
   },
   "devDependencies": {
-    "@types/node": "^25.9.1",
-    "tsup": "^8.5.1",
-    "typescript": "^5.9.3",
-    "vitest": "^4.1.4"
+    "@types/node": "catalog:",
+    "tsup": "catalog:",
+    "typescript": "catalog:",
+    "vitest": "catalog:"
   },
   "homepage": "https://github.com/Nebutra/Nebutra-Sailor/tree/main/packages/ai/event-log#readme",
   "repository": {
@@ -40,9 +49,10 @@
   "publishConfig": {
     "access": "public"
   },
-  "scripts": {
-    "build": "tsup",
-    "test": "vitest run",
-    "typecheck": "tsc --noEmit"
-  }
-}
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ]
+}

package/.nebutra/debug/event-log.jsonl

@@ -1,8 +0,0 @@
-{"at":"2026-05-19T05:44:37.050Z","traceId":"thread_1","kind":"tool_call","affected":["hello.md"],"snapshot":{"hello.md":"hi"},"parent":null,"id":"98448a866e126cc20a0c7fba8c687a14ffbe548b223f45d54877e100bed92087","tenantId":"tenant_a","summary":"wrote hello","objectHashes":["85052e9aab1b67b6622d94a08441b09fd5b7aca61ee360416d70de5da67d86ca"]}
-{"at":"2026-05-19T05:44:37.070Z","traceId":"t","kind":"tool_call","affected":[],"parent":null,"id":"33e13801c909cea3b507648b5153d6b63a1c32ff2f80c78c0e68bf61ec65769b","tenantId":"local","summary":"tool_call touched 0 path(s)","objectHashes":[]}
-{"at":"2026-05-19T05:47:30.443Z","traceId":"thread_1","kind":"tool_call","affected":["hello.md"],"snapshot":{"hello.md":"hi"},"parent":null,"id":"d3a5af5efbbfdcd34e07ea0b5e781fc9cb49d5ce07e8df679ac99bd86052f333","tenantId":"tenant_a","summary":"wrote hello","objectHashes":["85052e9aab1b67b6622d94a08441b09fd5b7aca61ee360416d70de5da67d86ca"]}
-{"at":"2026-05-19T05:47:30.446Z","traceId":"t","kind":"tool_call","affected":[],"parent":null,"id":"69b235a6db11d0b524d1b3b2dddf4b7cad9349fa87010681c7180bb968bddfc4","tenantId":"local","summary":"tool_call touched 0 path(s)","objectHashes":[]}
-{"at":"2026-05-30T21:06:21.198Z","traceId":"thread_1","kind":"tool_call","affected":["hello.md"],"snapshot":{"hello.md":"hi"},"parent":null,"id":"03884f8cfd0e65d3f8a2f323bb670d4eca830f52c5da33944ed3b6c0cc190a64","tenantId":"tenant_a","summary":"wrote hello","objectHashes":["85052e9aab1b67b6622d94a08441b09fd5b7aca61ee360416d70de5da67d86ca"]}
-{"at":"2026-05-30T21:06:21.209Z","traceId":"t","kind":"tool_call","affected":[],"parent":null,"id":"d45c25d4d45205fe8952c4606c2baceae705d74a5db379df35be85e7def0576c","tenantId":"local","summary":"tool_call touched 0 path(s)","objectHashes":[]}
-{"at":"2026-07-01T01:38:43.284Z","traceId":"thread_1","kind":"tool_call","affected":["hello.md"],"snapshot":{"hello.md":"hi"},"parent":null,"id":"9e6e195ea1e6edd3c71821ff3fdd694df885adcd359d28a0b74ec83bc6b6db03","tenantId":"tenant_a","summary":"wrote hello","objectHashes":["85052e9aab1b67b6622d94a08441b09fd5b7aca61ee360416d70de5da67d86ca"]}
-{"at":"2026-07-01T01:38:43.301Z","traceId":"t","kind":"tool_call","affected":[],"parent":null,"id":"28d45da6eee7f0df21606ec4213d9fd44fa456e8a417a20968566f13bd944f1a","tenantId":"local","summary":"tool_call touched 0 path(s)","objectHashes":[]}

package/.turbo/turbo-build.log

@@ -1,22 +0,0 @@
-
-> @nebutra/event-log@0.1.2 build /Users/tseka_luk/Documents/Nebutra-SaaS-Lab/Nebutra-Sailor/packages/ai/event-log
-> tsup
-
-CLI Building entry: src/cli.ts, src/index.ts
-CLI Using tsconfig: tsconfig.json
-CLI tsup v8.5.1
-CLI Using tsup config: /Users/tseka_luk/Documents/Nebutra-SaaS-Lab/Nebutra-Sailor/packages/ai/event-log/tsup.config.ts
-CLI Target: es2022
-CLI Cleaning output folder
-ESM Build start
-ESM dist/chunk-L5NN4BRT.js     3.50 KB
-ESM dist/index.js              106.00 B
-ESM dist/cli.js                890.00 B
-ESM dist/cli.js.map            1.54 KB
-ESM dist/index.js.map          71.00 B
-ESM dist/chunk-L5NN4BRT.js.map 7.63 KB
-ESM ⚡️ Build success in 46ms
-DTS Build start
-DTS ⚡️ Build success in 2447ms
-DTS dist/cli.d.ts   13.00 B
-DTS dist/index.d.ts 1.44 KB

package/.turbo/turbo-test.log

@@ -1,14 +0,0 @@
-
-> @nebutra/event-log@0.1.1 test /Users/tseka_luk/Documents/Nebutra-SaaS-Lab/Nebutra-Sailor/packages/ai/event-log
-> vitest run
-
-
- RUN  v4.1.4 /Users/tseka_luk/Documents/Nebutra-SaaS-Lab/Nebutra-Sailor/packages/ai/event-log
-
- ✓ src/index.test.ts (2 tests) 46ms
-
- Test Files  1 passed (1)
-      Tests  2 passed (2)
-   Start at  09:38:42
-   Duration  969ms (transform 106ms, setup 0ms, import 143ms, tests 46ms, environment 0ms)
-

package/.turbo/turbo-typecheck.log

@@ -1,4 +0,0 @@
-
-> @nebutra/event-log@0.1.2 typecheck /Users/tseka_luk/Documents/Nebutra-SaaS-Lab/Nebutra-Sailor/packages/ai/event-log
-> tsc --noEmit
-

package/examples/branch-from.ts

@@ -1,17 +0,0 @@
-import { mkdtemp } from "node:fs/promises";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-import { EventLog } from "../src/index";
-
-const root = await mkdtemp(join(tmpdir(), "event-log-"));
-const log = await EventLog.open(root, { tenantId: "demo" });
-const id = await log.commit({
-  traceId: "trace_1",
-  kind: "content_write",
-  affected: ["hello.md"],
-  parent: null,
-  snapshot: { "hello.md": "hi" },
-});
-
-const branch = await log.branchFrom(id, "purple-version");
-process.stdout.write(`${JSON.stringify(branch, null, 2)}\n`);

package/examples/commit-rollback.ts

@@ -1,17 +0,0 @@
-import { mkdtemp } from "node:fs/promises";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-import { EventLog } from "../src/index";
-
-const root = await mkdtemp(join(tmpdir(), "event-log-"));
-const log = await EventLog.open(root, { tenantId: "demo" });
-const id = await log.commit({
-  traceId: "trace_1",
-  kind: "tool_call",
-  affected: ["hello.md"],
-  parent: null,
-  snapshot: { "hello.md": "hi" },
-});
-
-const rollback = await log.rollbackTo(id);
-process.stdout.write(`${JSON.stringify(rollback, null, 2)}\n`);

package/examples/timeline.ts

@@ -1,12 +0,0 @@
-import { mkdtemp } from "node:fs/promises";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-import { EventLog } from "../src/index";
-
-const root = await mkdtemp(join(tmpdir(), "event-log-"));
-const log = await EventLog.open(root, { tenantId: "demo" });
-
-await log.commit({ traceId: "trace_1", kind: "llm_call", affected: [], parent: null });
-await log.commit({ traceId: "trace_1", kind: "sandbox_exec", affected: [], parent: null });
-
-process.stdout.write(`${JSON.stringify(await log.timeline(), null, 2)}\n`);

package/src/cli.ts

@@ -1,29 +0,0 @@
-import { EventLog } from "./index";
-
-const command = process.argv[2] ?? "doctor";
-const log = await EventLog.open(process.env.EVENT_LOG_ROOT ?? ".nebutra/.chronos");
-
-if (command === "doctor") {
-  const timeline = await log.timeline();
-  process.stdout.write(
-    `${JSON.stringify(
-      {
-        capability: "event-log",
-        ok: timeline.length > 0,
-        events: timeline.length,
-        ...(timeline.length === 0 && {
-          suggestion: "Run the Layer 0 demo to create the first event.",
-        }),
-      },
-      null,
-      2,
-    )}\n`,
-  );
-} else if (command === "timeline" || command === "debug") {
-  process.stdout.write(
-    `${JSON.stringify({ capability: "event-log", events: await log.timeline() }, null, 2)}\n`,
-  );
-} else {
-  process.stderr.write(`Unknown event-log command: ${command}\n`);
-  process.exitCode = 1;
-}

package/src/index.test.ts

@@ -1,40 +0,0 @@
-import { mkdtemp, rm } from "node:fs/promises";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-import { afterEach, describe, expect, it } from "vitest";
-import { EventLog } from "./index";
-
-let root: string | undefined;
-
-afterEach(async () => {
-  if (root) await rm(root, { recursive: true, force: true });
-  root = undefined;
-});
-
-describe("EventLog", () => {
-  it("commits immutable events and returns a dry-run rollback plan", async () => {
-    root = await mkdtemp(join(tmpdir(), "event-log-"));
-    const log = await EventLog.open(root, {
-      tenantId: "tenant_a",
-      summarize: async () => "wrote hello",
-    });
-    const id = await log.commit({
-      traceId: "thread_1",
-      kind: "tool_call",
-      affected: ["hello.md"],
-      snapshot: { "hello.md": "hi" },
-      parent: null,
-    });
-
-    expect((await log.timeline()).at(0)).toMatchObject({ id, summary: "wrote hello" });
-    await expect(log.rollbackTo(id)).resolves.toMatchObject({ dryRun: true, target: id });
-  });
-
-  it("branches from an existing event", async () => {
-    root = await mkdtemp(join(tmpdir(), "event-log-"));
-    const log = await EventLog.open(root);
-    const id = await log.commit({ traceId: "t", kind: "tool_call", affected: [], parent: null });
-
-    await expect(log.branchFrom(id, "purple")).resolves.toMatchObject({ name: "purple", from: id });
-  });
-});

package/src/index.ts

@@ -1,167 +0,0 @@
-import { mkdir, readFile, writeFile } from "node:fs/promises";
-import { dirname, join } from "node:path";
-import { appendCapabilityDebug } from "@nebutra/capability-kit/debug";
-import { CapabilityError } from "@nebutra/errors";
-import { blake3 } from "@noble/hashes/blake3.js";
-import { bytesToHex } from "@noble/hashes/utils.js";
-
-export type EventKind =
-  | "llm_call"
-  | "tool_call"
-  | "sub_agent_call"
-  | "content_write"
-  | "sandbox_exec";
-
-export interface EventInput {
-  readonly traceId: string;
-  readonly kind: EventKind;
-  readonly affected: readonly string[];
-  readonly parent: string | null;
-  readonly snapshot?: Record<string, string>;
-}
-
-export interface EventRecord extends EventInput {
-  readonly id: string;
-  readonly tenantId: string;
-  readonly at: string;
-  readonly summary: string;
-  readonly objectHashes: readonly string[];
-}
-
-export interface BranchRecord {
-  readonly name: string;
-  readonly from: string;
-  readonly at: string;
-}
-
-export interface RollbackPlan {
-  readonly dryRun: true;
-  readonly target: string;
-  readonly affected: readonly string[];
-  readonly suggestion: string;
-}
-
-export interface EventLogOptions {
-  readonly tenantId?: string;
-  readonly summarize?: (event: EventInput) => Promise<string>;
-}
-
-function hashContent(content: string): string {
-  return bytesToHex(blake3(new TextEncoder().encode(content)));
-}
-
-async function appendJsonl(path: string, value: unknown): Promise<void> {
-  await mkdir(dirname(path), { recursive: true });
-  await writeFile(path, `${JSON.stringify(value)}\n`, { flag: "a" });
-}
-
-async function readJsonl<T>(path: string): Promise<T[]> {
-  try {
-    const raw = await readFile(path, "utf8");
-    return raw
-      .trim()
-      .split("\n")
-      .filter(Boolean)
-      .map((line) => JSON.parse(line) as T);
-  } catch {
-    return [];
-  }
-}
-
-export class EventLog {
-  readonly #root: string;
-  readonly #tenantId: string;
-  readonly #summarize: (event: EventInput) => Promise<string>;
-
-  private constructor(
-    root: string,
-    tenantId: string,
-    summarize: (event: EventInput) => Promise<string>,
-  ) {
-    this.#root = root;
-    this.#tenantId = tenantId;
-    this.#summarize = summarize;
-  }
-
-  static async open(root: string, options: EventLogOptions = {}): Promise<EventLog> {
-    const log = new EventLog(
-      root,
-      options.tenantId ?? "local",
-      options.summarize ??
-        (async (event) => `${event.kind} touched ${event.affected.length} path(s)`),
-    );
-    await mkdir(log.objectsRoot(), { recursive: true });
-    return log;
-  }
-
-  objectsRoot(): string {
-    return join(this.#root, "objects", this.#tenantId);
-  }
-
-  eventsPath(): string {
-    return join(this.#root, "events", `${this.#tenantId}.jsonl`);
-  }
-
-  branchesPath(): string {
-    return join(this.#root, "branches", `${this.#tenantId}.jsonl`);
-  }
-
-  async commit(event: EventInput): Promise<string> {
-    const objectHashes: string[] = [];
-    for (const [path, content] of Object.entries(event.snapshot ?? {})) {
-      const hash = hashContent(content);
-      objectHashes.push(hash);
-      await writeFile(join(this.objectsRoot(), hash), content, "utf8");
-      await appendJsonl(join(this.objectsRoot(), "index.jsonl"), { hash, path });
-    }
-    const id = hashContent(
-      JSON.stringify({ event, objectHashes, tenantId: this.#tenantId, at: Date.now() }),
-    );
-    const record: EventRecord = {
-      ...event,
-      id,
-      tenantId: this.#tenantId,
-      at: new Date().toISOString(),
-      summary: await this.#summarize(event),
-      objectHashes,
-    };
-    await appendJsonl(this.eventsPath(), record);
-    await appendCapabilityDebug("event-log", { ...record });
-    return id;
-  }
-
-  async timeline(): Promise<readonly EventRecord[]> {
-    return readJsonl<EventRecord>(this.eventsPath());
-  }
-
-  async rollbackTo(id: string): Promise<RollbackPlan> {
-    const target = (await this.timeline()).find((event) => event.id === id);
-    if (!target) {
-      throw new CapabilityError("event-log", "Rollback target not found", {
-        suggestion: "Run `pnpm chronos:timeline` and choose an event id from the current tenant.",
-        metadata: { id },
-        statusCode: 404,
-      });
-    }
-    return {
-      dryRun: true,
-      target: id,
-      affected: target.affected,
-      suggestion: "Review this plan, then call an explicit apply API in a higher layer.",
-    };
-  }
-
-  async branchFrom(id: string, name: string): Promise<BranchRecord> {
-    const exists = (await this.timeline()).some((event) => event.id === id);
-    if (!exists) {
-      throw new CapabilityError("event-log", "Branch source not found", {
-        suggestion: "Run `pnpm chronos:timeline` and branch from an existing event id.",
-        metadata: { id },
-        statusCode: 404,
-      });
-    }
-    const branch = { name, from: id, at: new Date().toISOString() };
-    await appendJsonl(this.branchesPath(), branch);
-    return branch;
-  }
-}

package/tsconfig.json

@@ -1,12 +0,0 @@
-{
-  "extends": "../../../tsconfig.base.json",
-  "compilerOptions": {
-    "module": "ESNext",
-    "moduleResolution": "bundler",
-    "target": "esnext",
-    "types": ["node"],
-    "incremental": false
-  },
-  "include": ["src", "examples"],
-  "exclude": ["node_modules", "dist"]
-}

package/tsup.config.ts

@@ -1,11 +0,0 @@
-import { defineConfig } from "tsup";
-
-export default defineConfig({
-  entry: ["src/index.ts", "src/cli.ts"],
-  format: ["esm"],
-  dts: true,
-  sourcemap: true,
-  clean: true,
-  target: "es2022",
-  external: ["@nebutra/content-store", "@nebutra/errors", "@noble/hashes"],
-});