@varveai/adit-core 0.2.1

package/dist/types/events.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Event types for the ADIT unified timeline.
+ *
+ * Every code change, prompt, tool call, and system action is an event.
+ * Events form a tree via parentEventId for nested execution tracking.
+ */
+/** All possible event types in the timeline */
+export type EventType = "prompt_submit" | "assistant_response" | "user_edit" | "tool_call" | "subagent_call" | "skill_call" | "mcp_call" | "checkpoint" | "revert" | "env_snapshot" | "env_drift" | "plan_update" | "task_completed" | "notification" | "subagent_start" | "subagent_stop";
+/** Who performed the action */
+export type Actor = "assistant" | "user" | "tool" | "system";
+/** Lifecycle status of an event */
+export type EventStatus = "running" | "success" | "error" | "timeout" | "cancelled";
+/** Classification of errors for filtering and analysis */
+export type ErrorCategory = "tool_failure" | "timeout" | "permission_denied" | "not_found" | "validation" | "unknown";
+/** File change statistics within a checkpoint */
+export interface FileStat {
+    path: string;
+    status: "M" | "A" | "D" | "R" | "??";
+    additions?: number;
+    deletions?: number;
+}
+/** Error details attached to failed events */
+export interface EventError {
+    category: ErrorCategory;
+    message: string;
+    stack?: string;
+}
+/** The core event record — every timeline entry is one of these */
+export interface AditEvent {
+    /** ULID — globally unique, time-sortable */
+    id: string;
+    /** Session this event belongs to */
+    sessionId: string;
+    /** Parent event for tree structure (null = root) */
+    parentEventId: string | null;
+    /** Monotonic sequence within session */
+    sequence: number;
+    /** What kind of event */
+    eventType: EventType;
+    /** Who performed it */
+    actor: Actor;
+    /** User's prompt text (when eventType=prompt_submit) */
+    promptText: string | null;
+    /** Chain of thought from the model (when eventType=assistant_response) */
+    cotText: string | null;
+    /** Summary of assistant's response */
+    responseText: string | null;
+    /** Tool/command name */
+    toolName: string | null;
+    /** Serialized tool input */
+    toolInputJson: string | null;
+    /** Serialized tool output */
+    toolOutputJson: string | null;
+    /** Git commit SHA for this checkpoint */
+    checkpointSha: string | null;
+    /** Ref path: refs/adit/checkpoints/<id> */
+    checkpointRef: string | null;
+    /** Per-file change stats */
+    diffStatJson: string | null;
+    /** Active git branch at time of event */
+    gitBranch: string | null;
+    /** HEAD SHA at time of event */
+    gitHeadSha: string | null;
+    /** FK to env_snapshots table */
+    envSnapshotId: string | null;
+    startedAt: string;
+    endedAt: string | null;
+    status: EventStatus;
+    /** Serialized EventError */
+    errorJson: string | null;
+    /** User-assigned labels */
+    labelsJson: string | null;
+    /** FK to plans table for SpecFlow task linking */
+    planTaskId: string | null;
+    /** Client that created this event (for multi-client provenance) */
+    clientId: string | null;
+    /** Vector clock for conflict resolution */
+    vclockJson: string;
+    /** Soft delete timestamp */
+    deletedAt: string | null;
+}
+/** Parsed labels from labelsJson */
+export declare function parseLabels(labelsJson: string | null): string[];
+/** Parsed diff stats from diffStatJson */
+export declare function parseDiffStats(diffStatJson: string | null): FileStat[];
+/** Parsed error from errorJson */
+export declare function parseError(errorJson: string | null): EventError | null;
+//# sourceMappingURL=events.d.ts.map

package/dist/types/events.d.ts.map

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

package/dist/types/events.js

@@ -0,0 +1,40 @@
+/**
+ * Event types for the ADIT unified timeline.
+ *
+ * Every code change, prompt, tool call, and system action is an event.
+ * Events form a tree via parentEventId for nested execution tracking.
+ */
+/** Parsed labels from labelsJson */
+export function parseLabels(labelsJson) {
+    if (!labelsJson)
+        return [];
+    try {
+        return JSON.parse(labelsJson);
+    }
+    catch {
+        return [];
+    }
+}
+/** Parsed diff stats from diffStatJson */
+export function parseDiffStats(diffStatJson) {
+    if (!diffStatJson)
+        return [];
+    try {
+        return JSON.parse(diffStatJson);
+    }
+    catch {
+        return [];
+    }
+}
+/** Parsed error from errorJson */
+export function parseError(errorJson) {
+    if (!errorJson)
+        return null;
+    try {
+        return JSON.parse(errorJson);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=events.js.map

package/dist/types/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/types/events.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA2HH,oCAAoC;AACpC,MAAM,UAAU,WAAW,CAAC,UAAyB;IACnD,IAAI,CAAC,UAAU;QAAE,OAAO,EAAE,CAAC;IAC3B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,cAAc,CAAC,YAA2B;IACxD,IAAI,CAAC,YAAY;QAAE,OAAO,EAAE,CAAC;IAC7B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,kCAAkC;AAClC,MAAM,UAAU,UAAU,CAAC,SAAwB;IACjD,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IAC5B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,6 @@
+export type { EventType, Actor, EventStatus, ErrorCategory, FileStat, EventError, AditEvent, } from "./events.js";
+export { parseLabels, parseDiffStats, parseError } from "./events.js";
+export type { SessionStatus, Platform, SessionType, SessionMetadata, AditSession, } from "./session.js";
+export type { PlanType, PlanStatus, AditPlan, } from "./plan.js";
+export type { EnvSnapshot, EnvDiff, EnvChange } from "./environment.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,SAAS,EACT,KAAK,EACL,WAAW,EACX,aAAa,EACb,QAAQ,EACR,UAAU,EACV,SAAS,GACV,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEtE,YAAY,EACV,aAAa,EACb,QAAQ,EACR,WAAW,EACX,eAAe,EACf,WAAW,GACZ,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,QAAQ,EACR,UAAU,EACV,QAAQ,GACT,MAAM,WAAW,CAAC;AAEnB,YAAY,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,2 @@
+export { parseLabels, parseDiffStats, parseError } from "./events.js";
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC"}

package/dist/types/plan.d.ts

@@ -0,0 +1,30 @@
+/**
+ * SpecFlow-inspired plan types.
+ *
+ * Plans follow a hierarchy: Intent → Roadmap → Tasks
+ * Sessions and events can be linked to specific tasks.
+ */
+export type PlanType = "intent" | "roadmap" | "task";
+export type PlanStatus = "draft" | "active" | "completed" | "abandoned";
+/** A plan artifact (intent doc, roadmap, or task) */
+export interface AditPlan {
+    /** ULID */
+    id: string;
+    /** Project this plan belongs to */
+    projectId: string;
+    /** 'intent' | 'roadmap' | 'task' */
+    planType: PlanType;
+    /** Parent plan (roadmap→intent, task→roadmap) */
+    parentPlanId: string | null;
+    title: string;
+    /** Markdown content */
+    contentMd: string;
+    status: PlanStatus;
+    createdAt: string;
+    updatedAt: string | null;
+    /** Vector clock for sync */
+    vclockJson: string;
+    /** Soft delete */
+    deletedAt: string | null;
+}
+//# sourceMappingURL=plan.d.ts.map

package/dist/types/plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/types/plan.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;AAErD,MAAM,MAAM,UAAU,GAClB,OAAO,GACP,QAAQ,GACR,WAAW,GACX,WAAW,CAAC;AAEhB,qDAAqD;AACrD,MAAM,WAAW,QAAQ;IACvB,WAAW;IACX,EAAE,EAAE,MAAM,CAAC;IACX,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,QAAQ,EAAE,QAAQ,CAAC;IACnB,iDAAiD;IACjD,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,UAAU,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B"}

package/dist/types/plan.js

@@ -0,0 +1,8 @@
+/**
+ * SpecFlow-inspired plan types.
+ *
+ * Plans follow a hierarchy: Intent → Roadmap → Tasks
+ * Sessions and events can be linked to specific tasks.
+ */
+export {};
+//# sourceMappingURL=plan.js.map

package/dist/types/plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.js","sourceRoot":"","sources":["../../src/types/plan.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/types/session.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Session types for ADIT.
+ *
+ * A session represents a continuous AI-assisted development interaction.
+ * Multiple sessions can exist for the same project (multi-client support).
+ */
+/** Session lifecycle status */
+export type SessionStatus = "active" | "completed" | "error" | "cancelled";
+/** Which AI platform is driving this session */
+export type Platform = "claude-code" | "cursor" | "copilot" | "opencode" | "codex" | "other";
+/** Session type */
+export type SessionType = "interactive" | "headless";
+/** Session metadata captured at start */
+export interface SessionMetadata {
+    gitBranch: string;
+    gitRemoteUrl?: string;
+    workingDirectory: string;
+    nodeVersion?: string;
+    pythonVersion?: string;
+    osInfo?: string;
+}
+/** The session record */
+export interface AditSession {
+    /** ULID — globally unique, time-sortable */
+    id: string;
+    /** Project identifier: hash(remote_url + repo_root) */
+    projectId: string;
+    /** Unique per machine/installation */
+    clientId: string;
+    sessionType: SessionType;
+    platform: Platform;
+    startedAt: string;
+    endedAt: string | null;
+    status: SessionStatus;
+    /** Serialized SessionMetadata */
+    metadataJson: string | null;
+    /** Vector clock for sync */
+    vclockJson: string;
+    /** Platform-provided session ID (e.g., Claude Code session_id) */
+    platformSessionId?: string | null;
+    /** Soft delete timestamp */
+    deletedAt: string | null;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/types/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/types/session.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,+BAA+B;AAC/B,MAAM,MAAM,aAAa,GACrB,QAAQ,GACR,WAAW,GACX,OAAO,GACP,WAAW,CAAC;AAEhB,gDAAgD;AAChD,MAAM,MAAM,QAAQ,GAChB,aAAa,GACb,QAAQ,GACR,SAAS,GACT,UAAU,GACV,OAAO,GACP,OAAO,CAAC;AAEZ,mBAAmB;AACnB,MAAM,MAAM,WAAW,GAAG,aAAa,GAAG,UAAU,CAAC;AAErD,yCAAyC;AACzC,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,yBAAyB;AACzB,MAAM,WAAW,WAAW;IAC1B,4CAA4C;IAC5C,EAAE,EAAE,MAAM,CAAC;IACX,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,WAAW,CAAC;IACzB,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,aAAa,CAAC;IACtB,iCAAiC;IACjC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,4BAA4B;IAC5B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B"}

package/dist/types/session.js

@@ -0,0 +1,8 @@
+/**
+ * Session types for ADIT.
+ *
+ * A session represents a continuous AI-assisted development interaction.
+ * Multiple sessions can exist for the same project (multi-client support).
+ */
+export {};
+//# sourceMappingURL=session.js.map

package/dist/types/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/types/session.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@varveai/adit-core",
+  "version": "0.2.1",
+  "description": "Core types, database, and sync primitives for ADIT",
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "better-sqlite3": "^12.6.2",
+    "ulid": "^2.3.0"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "typescript": "^5.7.2"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit"
+  }
+}