@neonwatty/limner 0.1.3 → 0.1.5

package/dist/core/agent-comparison-profiles.js

@@ -8,12 +8,21 @@ export function getAgentComparisonProfile(name) {
             instruction: 'Focus on changes to the HTML/CSS mockup that will make the next screenshot closer to the ideal.',
         };
     }
+    if (name === 'mockup-to-implementation') {
+        return {
+            name,
+            expectedRole: 'approved HTML mockup screenshot',
+            actualRole: 'implementation screenshot',
+            editableSurface: 'implementation',
+            instruction: 'Treat the mockup as canonical and focus on implementation changes that will match it.',
+        };
+    }
     return {
         name,
-        expectedRole: 'approved HTML mockup screenshot',
+        expectedRole: 'ideal image',
         actualRole: 'implementation screenshot',
         editableSurface: 'implementation',
-        instruction: 'Treat the mockup as canonical and focus on implementation changes that will match it.',
+        instruction: 'Treat the source image as canonical and focus on implementation changes that will match it without an approved mockup bridge.',
     };
 }
 //# sourceMappingURL=agent-comparison-profiles.js.map

package/dist/core/agent-comparison-profiles.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-comparison-profiles.js","sourceRoot":"","sources":["../../src/core/agent-comparison-profiles.ts"],"names":[],"mappings":"AAUA,MAAM,UAAU,yBAAyB,CAAC,IAAgC;IACxE,IAAI,IAAI,KAAK,iBAAiB,EAAE,CAAC;QAC/B,OAAO;YACL,IAAI;YACJ,YAAY,EAAE,aAAa;YAC3B,UAAU,EAAE,wBAAwB;YACpC,eAAe,EAAE,QAAQ;YACzB,WAAW,EAAE,iGAAiG;SAC/G,CAAC;IACJ,CAAC;IACD,OAAO;QACL,IAAI;QACJ,YAAY,EAAE,iCAAiC;QAC/C,UAAU,EAAE,2BAA2B;QACvC,eAAe,EAAE,gBAAgB;QACjC,WAAW,EAAE,uFAAuF;KACrG,CAAC;AACJ,CAAC"}
+{"version":3,"file":"agent-comparison-profiles.js","sourceRoot":"","sources":["../../src/core/agent-comparison-profiles.ts"],"names":[],"mappings":"AAUA,MAAM,UAAU,yBAAyB,CAAC,IAAgC;IACxE,IAAI,IAAI,KAAK,iBAAiB,EAAE,CAAC;QAC/B,OAAO;YACL,IAAI;YACJ,YAAY,EAAE,aAAa;YAC3B,UAAU,EAAE,wBAAwB;YACpC,eAAe,EAAE,QAAQ;YACzB,WAAW,EAAE,iGAAiG;SAC/G,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,KAAK,0BAA0B,EAAE,CAAC;QACxC,OAAO;YACL,IAAI;YACJ,YAAY,EAAE,iCAAiC;YAC/C,UAAU,EAAE,2BAA2B;YACvC,eAAe,EAAE,gBAAgB;YACjC,WAAW,EAAE,uFAAuF;SACrG,CAAC;IACJ,CAAC;IACD,OAAO;QACL,IAAI;QACJ,YAAY,EAAE,aAAa;QAC3B,UAAU,EAAE,2BAA2B;QACvC,eAAe,EAAE,gBAAgB;QACjC,WAAW,EAAE,+HAA+H;KAC7I,CAAC;AACJ,CAAC"}

package/dist/core/ledger-db.d.ts

@@ -0,0 +1,6 @@
+import Database from 'better-sqlite3';
+export type LedgerDatabaseInput = {
+    databasePath: string;
+};
+export type LedgerDatabase = Database.Database;
+export declare function openLedgerDatabase(input: LedgerDatabaseInput): LedgerDatabase;

package/dist/core/ledger-db.js

@@ -0,0 +1,106 @@
+import Database from 'better-sqlite3';
+import { mkdirSync } from 'node:fs';
+import path from 'node:path';
+const schemaVersion = 1;
+export function openLedgerDatabase(input) {
+    mkdirSync(path.dirname(input.databasePath), { recursive: true });
+    const db = new Database(input.databasePath);
+    db.pragma('foreign_keys = ON');
+    migrate(db);
+    return db;
+}
+function migrate(db) {
+    db.exec(`
+    create table if not exists schema_meta (
+      key text primary key,
+      value text not null
+    );
+
+    create table if not exists trajectories (
+      trajectory_id text primary key,
+      human_id text not null,
+      mode text not null,
+      project_root text not null,
+      workspace_root text not null,
+      target text not null,
+      status text not null,
+      max_iterations integer,
+      active_iteration_id text,
+      context_json text not null,
+      instructions_json text not null,
+      created_at text not null,
+      updated_at text not null
+    );
+
+    create table if not exists iterations (
+      iteration_id text not null,
+      trajectory_id text not null references trajectories(trajectory_id) on delete cascade,
+      sequence integer not null,
+      focus text,
+      status text not null,
+      instructions_json text not null,
+      created_at text not null,
+      closed_at text,
+      primary key (trajectory_id, iteration_id)
+    );
+
+    create table if not exists runs (
+      run_id text primary key,
+      trajectory_id text not null references trajectories(trajectory_id) on delete cascade,
+      iteration_id text not null,
+      command text not null,
+      status text not null,
+      started_at text not null,
+      completed_at text
+    );
+
+    create table if not exists artifacts (
+      artifact_id text primary key,
+      trajectory_id text not null references trajectories(trajectory_id) on delete cascade,
+      iteration_id text,
+      run_id text,
+      kind text not null,
+      path text not null,
+      hash text,
+      snapshot_path text,
+      created_at text not null
+    );
+
+    create table if not exists instruction_versions (
+      version_id text primary key,
+      trajectory_id text not null references trajectories(trajectory_id) on delete cascade,
+      iteration_id text,
+      instructions_json text not null,
+      created_at text not null
+    );
+
+    create table if not exists notes (
+      note_id text primary key,
+      trajectory_id text not null references trajectories(trajectory_id) on delete cascade,
+      iteration_id text,
+      body text not null,
+      created_at text not null
+    );
+
+    create table if not exists ledger_events (
+      event_id text primary key,
+      trajectory_id text,
+      iteration_id text,
+      run_id text,
+      event_type text not null,
+      actor text not null,
+      command text,
+      inputs_summary text,
+      result_status text,
+      artifact_refs_json text not null,
+      agent_feedback text,
+      notes text,
+      created_at text not null
+    );
+
+    insert into schema_meta (key, value)
+    values ('schemaVersion', '${schemaVersion}')
+    on conflict(key) do update set value = excluded.value;
+  `);
+}
+//# sourceMappingURL=ledger-db.js.map

package/dist/core/ledger-db.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ledger-db.js","sourceRoot":"","sources":["../../src/core/ledger-db.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,aAAa,GAAG,CAAC,CAAC;AAQxB,MAAM,UAAU,kBAAkB,CAAC,KAA0B;IAC3D,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACjE,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAC5C,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,CAAC,CAAC;IACZ,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,OAAO,CAAC,EAAkB;IACjC,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAyFsB,aAAa;;GAE1C,CAAC,CAAC;AACL,CAAC"}

package/dist/core/ledger-events.d.ts

@@ -0,0 +1,3 @@
+import type { LedgerDatabase } from './ledger-db.js';
+import type { AppendEventInput } from './ledger-store.js';
+export declare function insertLedgerEvent(db: LedgerDatabase, input: AppendEventInput, now: string): void;

package/dist/core/ledger-events.js

@@ -0,0 +1,23 @@
+import { agentFeedbackSchema } from '../schemas/ledger.js';
+import { createLedgerId } from './ledger-ids.js';
+export function insertLedgerEvent(db, input, now) {
+    const feedback = agentFeedbackSchema.parse(input.agentFeedback);
+    db.prepare(`
+    insert into ledger_events (
+      event_id, trajectory_id, iteration_id, run_id, event_type, actor, command,
+      inputs_summary, result_status, artifact_refs_json, agent_feedback, notes, created_at
+    ) values (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+  `).run(createLedgerId('evt'), input.trajectoryId ?? null, input.iterationId ?? null, input.runId ?? null, input.eventType, input.actor ?? 'cli', input.command ?? null, input.inputsSummary ?? null, input.resultStatus ?? null, JSON.stringify(input.artifactRefs ?? []), feedback ?? null, input.notes ?? null, now);
+    if (input.trajectoryId) {
+        for (const artifactPath of input.artifactRefs ?? []) {
+            if (typeof artifactPath !== 'string')
+                continue;
+            db.prepare(`
+        insert into artifacts (
+          artifact_id, trajectory_id, iteration_id, run_id, kind, path, hash, snapshot_path, created_at
+        ) values (?, ?, ?, ?, 'event-artifact', ?, null, null, ?)
+      `).run(createLedgerId('art'), input.trajectoryId, input.iterationId ?? null, input.runId ?? null, artifactPath, now);
+        }
+    }
+}
+//# sourceMappingURL=ledger-events.js.map

package/dist/core/ledger-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ledger-events.js","sourceRoot":"","sources":["../../src/core/ledger-events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAG3D,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,MAAM,UAAU,iBAAiB,CAAC,EAAkB,EAAE,KAAuB,EAAE,GAAW;IACxF,MAAM,QAAQ,GAAG,mBAAmB,CAAC,KAAK,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IAChE,EAAE,CAAC,OAAO,CAAC;;;;;GAKV,CAAC,CAAC,GAAG,CACJ,cAAc,CAAC,KAAK,CAAC,EACrB,KAAK,CAAC,YAAY,IAAI,IAAI,EAC1B,KAAK,CAAC,WAAW,IAAI,IAAI,EACzB,KAAK,CAAC,KAAK,IAAI,IAAI,EACnB,KAAK,CAAC,SAAS,EACf,KAAK,CAAC,KAAK,IAAI,KAAK,EACpB,KAAK,CAAC,OAAO,IAAI,IAAI,EACrB,KAAK,CAAC,aAAa,IAAI,IAAI,EAC3B,KAAK,CAAC,YAAY,IAAI,IAAI,EAC1B,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,YAAY,IAAI,EAAE,CAAC,EACxC,QAAQ,IAAI,IAAI,EAChB,KAAK,CAAC,KAAK,IAAI,IAAI,EACnB,GAAG,CACJ,CAAC;IACF,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;QACvB,KAAK,MAAM,YAAY,IAAI,KAAK,CAAC,YAAY,IAAI,EAAE,EAAE,CAAC;YACpD,IAAI,OAAO,YAAY,KAAK,QAAQ;gBAAE,SAAS;YAC/C,EAAE,CAAC,OAAO,CAAC;;;;OAIV,CAAC,CAAC,GAAG,CACJ,cAAc,CAAC,KAAK,CAAC,EACrB,KAAK,CAAC,YAAY,EAClB,KAAK,CAAC,WAAW,IAAI,IAAI,EACzB,KAAK,CAAC,KAAK,IAAI,IAAI,EACnB,YAAY,EACZ,GAAG,CACJ,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/core/ledger-ids.d.ts

@@ -0,0 +1,3 @@
+import type { StartTrajectoryInput } from './ledger-store.js';
+export declare function createTrajectoryId(input: StartTrajectoryInput): string;
+export declare function createLedgerId(prefix: string): string;

package/dist/core/ledger-ids.js

@@ -0,0 +1,12 @@
+import { createHash, randomUUID } from 'node:crypto';
+export function createTrajectoryId(input) {
+    const hash = createHash('sha256')
+        .update([input.projectRoot, input.workspaceRoot, input.target, input.mode, input.name, new Date().toISOString(), randomUUID()].join('\0'))
+        .digest('hex')
+        .slice(0, 16);
+    return `traj_${hash}`;
+}
+export function createLedgerId(prefix) {
+    return `${prefix}_${randomUUID().replace(/-/g, '').slice(0, 16)}`;
+}
+//# sourceMappingURL=ledger-ids.js.map

package/dist/core/ledger-ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ledger-ids.js","sourceRoot":"","sources":["../../src/core/ledger-ids.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAIrD,MAAM,UAAU,kBAAkB,CAAC,KAA2B;IAC5D,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC;SAC9B,MAAM,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,aAAa,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;SACzI,MAAM,CAAC,KAAK,CAAC;SACb,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAChB,OAAO,QAAQ,IAAI,EAAE,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,OAAO,GAAG,MAAM,IAAI,UAAU,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;AACpE,CAAC"}

package/dist/core/ledger-markdown.d.ts

@@ -0,0 +1,31 @@
+type ExportedTrajectory = {
+    trajectory: {
+        trajectoryId: string;
+        humanId: string;
+        mode: string;
+        status: string;
+        target?: string;
+    };
+    iterations: Array<{
+        iterationId?: string;
+        sequence?: number;
+        status?: string;
+    }>;
+    events: Array<{
+        eventType: string;
+        actor?: string;
+        command?: string;
+        resultStatus?: string;
+        artifactRefsJson?: string;
+        agentFeedback?: string;
+        notes?: string;
+        createdAt?: string;
+    }>;
+    artifacts: Array<{
+        kind: string;
+        path: string;
+        snapshotPath?: string | null;
+    }>;
+};
+export declare function formatLedgerMarkdown(exported: ExportedTrajectory): string;
+export {};

package/dist/core/ledger-markdown.js

@@ -0,0 +1,46 @@
+export function formatLedgerMarkdown(exported) {
+    const lines = [
+        '# Limner Trajectory',
+        '',
+        `Trajectory: ${exported.trajectory.trajectoryId}`,
+        `Name: ${exported.trajectory.humanId}`,
+        `Mode: ${exported.trajectory.mode}`,
+        `Target: ${exported.trajectory.target ?? 'unknown'}`,
+        `Status: ${exported.trajectory.status}`,
+        `Iterations: ${exported.iterations.length}`,
+        `Events: ${exported.events.length}`,
+        `Artifacts: ${exported.artifacts.length}`,
+        '',
+        '## Timeline',
+        '',
+        ...exported.events.flatMap(formatEvent),
+        '## Artifacts',
+        '',
+        ...(exported.artifacts.length > 0 ? exported.artifacts.map((artifact) => `- ${artifact.kind}: ${artifact.path}`) : ['- None recorded']),
+        '',
+    ];
+    return lines.join('\n');
+}
+function formatEvent(event) {
+    const refs = parseRefs(event.artifactRefsJson);
+    return [
+        `- ${event.createdAt ?? 'unknown'} ${event.eventType} (${event.resultStatus ?? 'unknown'})`,
+        `  - actor: ${event.actor ?? 'unknown'}`,
+        `  - command: ${event.command ?? 'unknown'}`,
+        ...(event.agentFeedback ? [`  - feedback: ${event.agentFeedback}`] : []),
+        ...(event.notes ? [`  - notes: ${event.notes}`] : []),
+        ...refs.map((ref) => `  - artifact: ${ref}`),
+    ];
+}
+function parseRefs(raw) {
+    if (!raw)
+        return [];
+    try {
+        const parsed = JSON.parse(raw);
+        return Array.isArray(parsed) ? parsed.filter((value) => typeof value === 'string') : [];
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=ledger-markdown.js.map

package/dist/core/ledger-markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ledger-markdown.js","sourceRoot":"","sources":["../../src/core/ledger-markdown.ts"],"names":[],"mappings":"AAgBA,MAAM,UAAU,oBAAoB,CAAC,QAA4B;IAC/D,MAAM,KAAK,GAAG;QACZ,qBAAqB;QACrB,EAAE;QACF,eAAe,QAAQ,CAAC,UAAU,CAAC,YAAY,EAAE;QACjD,SAAS,QAAQ,CAAC,UAAU,CAAC,OAAO,EAAE;QACtC,SAAS,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE;QACnC,WAAW,QAAQ,CAAC,UAAU,CAAC,MAAM,IAAI,SAAS,EAAE;QACpD,WAAW,QAAQ,CAAC,UAAU,CAAC,MAAM,EAAE;QACvC,eAAe,QAAQ,CAAC,UAAU,CAAC,MAAM,EAAE;QAC3C,WAAW,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE;QACnC,cAAc,QAAQ,CAAC,SAAS,CAAC,MAAM,EAAE;QACzC,EAAE;QACF,aAAa;QACb,EAAE;QACF,GAAG,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC;QACvC,cAAc;QACd,EAAE;QACF,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,KAAK,QAAQ,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC;QACvI,EAAE;KACH,CAAC;IACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,WAAW,CAAC,KAA2C;IAC9D,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;IAC/C,OAAO;QACL,KAAK,KAAK,CAAC,SAAS,IAAI,SAAS,IAAI,KAAK,CAAC,SAAS,KAAK,KAAK,CAAC,YAAY,IAAI,SAAS,GAAG;QAC3F,cAAc,KAAK,CAAC,KAAK,IAAI,SAAS,EAAE;QACxC,gBAAgB,KAAK,CAAC,OAAO,IAAI,SAAS,EAAE;QAC5C,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,iBAAiB,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACxE,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,cAAc,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACrD,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,iBAAiB,GAAG,EAAE,CAAC;KAC7C,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,GAAuB;IACxC,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC;QAC1C,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3G,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/core/ledger-paths.d.ts

@@ -0,0 +1,9 @@
+export type LedgerPaths = {
+    homeDir: string;
+    databasePath: string;
+    snapshotsDir: string;
+};
+type LedgerPathEnv = Partial<Pick<NodeJS.ProcessEnv, 'LIMNER_LEDGER_HOME'>>;
+export declare function resolveLedgerHome(env?: LedgerPathEnv): string;
+export declare function resolveLedgerPaths(env?: LedgerPathEnv): LedgerPaths;
+export {};

package/dist/core/ledger-paths.js

@@ -0,0 +1,14 @@
+import os from 'node:os';
+import path from 'node:path';
+export function resolveLedgerHome(env = process.env) {
+    return path.resolve(env.LIMNER_LEDGER_HOME ?? path.join(os.homedir(), '.limner'));
+}
+export function resolveLedgerPaths(env = process.env) {
+    const homeDir = resolveLedgerHome(env);
+    return {
+        homeDir,
+        databasePath: path.join(homeDir, 'ledger.sqlite'),
+        snapshotsDir: path.join(homeDir, 'snapshots'),
+    };
+}
+//# sourceMappingURL=ledger-paths.js.map

package/dist/core/ledger-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ledger-paths.js","sourceRoot":"","sources":["../../src/core/ledger-paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAU7B,MAAM,UAAU,iBAAiB,CAAC,MAAqB,OAAO,CAAC,GAAG;IAChE,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC;AACpF,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAqB,OAAO,CAAC,GAAG;IACjE,MAAM,OAAO,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;IACvC,OAAO;QACL,OAAO;QACP,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC;QACjD,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC;KAC9C,CAAC;AACJ,CAAC"}

package/dist/core/ledger-queries.d.ts

@@ -0,0 +1,13 @@
+import type { LedgerDatabase } from './ledger-db.js';
+import type { ResolveTrajectoryInput, TrajectorySummary } from './ledger-store.js';
+export declare function queryTrajectories(db: LedgerDatabase, input: ResolveTrajectoryInput): TrajectorySummary[];
+export declare function getTrajectory(db: LedgerDatabase, trajectoryId: string): TrajectorySummary | undefined;
+export declare function getIterations(db: LedgerDatabase, trajectoryId: string): unknown[];
+export declare function exportTrajectoryRows(db: LedgerDatabase, trajectory: TrajectorySummary): {
+    trajectory: TrajectorySummary;
+    iterations: unknown[];
+    events: unknown[];
+    instructionVersions: unknown[];
+    notes: unknown[];
+    artifacts: unknown[];
+};

package/dist/core/ledger-queries.js

@@ -0,0 +1,47 @@
+export function queryTrajectories(db, input) {
+    const conditions = [];
+    const params = [];
+    for (const [column, value] of [
+        ['trajectory_id', input.trajectoryId],
+        ['target', input.target],
+        ['mode', input.mode],
+        ['project_root', input.projectRoot],
+        ['status', input.status ?? (input.trajectoryId ? undefined : 'active')],
+    ]) {
+        if (value) {
+            conditions.push(`${column} = ?`);
+            params.push(value);
+        }
+    }
+    const where = conditions.length > 0 ? `where ${conditions.join(' and ')}` : '';
+    return db.prepare(`select ${trajectoryColumns} from trajectories ${where} order by created_at, human_id`).all(...params);
+}
+export function getTrajectory(db, trajectoryId) {
+    return db.prepare(`select ${trajectoryColumns} from trajectories where trajectory_id = ?`).get(trajectoryId);
+}
+export function getIterations(db, trajectoryId) {
+    return db.prepare('select iteration_id as iterationId, sequence, status from iterations where trajectory_id = ? order by sequence').all(trajectoryId);
+}
+export function exportTrajectoryRows(db, trajectory) {
+    const trajectoryId = trajectory.trajectoryId;
+    return {
+        trajectory,
+        iterations: getIterations(db, trajectoryId),
+        events: db.prepare(`select event_type as eventType, actor, command, result_status as resultStatus,
+      artifact_refs_json as artifactRefsJson, agent_feedback as agentFeedback, notes, created_at as createdAt
+      from ledger_events where trajectory_id = ? order by rowid`).all(trajectoryId),
+        instructionVersions: db.prepare('select version_id as versionId, instructions_json as instructionsJson from instruction_versions where trajectory_id = ? order by rowid').all(trajectoryId),
+        notes: db.prepare('select note_id as noteId, body from notes where trajectory_id = ? order by rowid').all(trajectoryId),
+        artifacts: db.prepare('select artifact_id as artifactId, kind, path, hash, snapshot_path as snapshotPath from artifacts where trajectory_id = ? order by rowid').all(trajectoryId),
+    };
+}
+const trajectoryColumns = `
+  trajectory_id as trajectoryId,
+  human_id as humanId,
+  mode,
+  target,
+  status,
+  active_iteration_id as activeIterationId,
+  max_iterations as maxIterations
+`;
+//# sourceMappingURL=ledger-queries.js.map

package/dist/core/ledger-queries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ledger-queries.js","sourceRoot":"","sources":["../../src/core/ledger-queries.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,iBAAiB,CAAC,EAAkB,EAAE,KAA6B;IACjF,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,MAAM,MAAM,GAAc,EAAE,CAAC;IAC7B,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI;QAC5B,CAAC,eAAe,EAAE,KAAK,CAAC,YAAY,CAAC;QACrC,CAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC;QACxB,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC;QACpB,CAAC,cAAc,EAAE,KAAK,CAAC,WAAW,CAAC;QACnC,CAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;KAC/D,EAAE,CAAC;QACX,IAAI,KAAK,EAAE,CAAC;YACV,UAAU,CAAC,IAAI,CAAC,GAAG,MAAM,MAAM,CAAC,CAAC;YACjC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IACD,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/E,OAAO,EAAE,CAAC,OAAO,CAAC,UAAU,iBAAiB,sBAAsB,KAAK,gCAAgC,CAAC,CAAC,GAAG,CAAC,GAAG,MAAM,CAAwB,CAAC;AAClJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,EAAkB,EAAE,YAAoB;IACpE,OAAO,EAAE,CAAC,OAAO,CAAC,UAAU,iBAAiB,4CAA4C,CAAC,CAAC,GAAG,CAAC,YAAY,CAAkC,CAAC;AAChJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,EAAkB,EAAE,YAAoB;IACpE,OAAO,EAAE,CAAC,OAAO,CAAC,gHAAgH,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;AACxJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,EAAkB,EAAE,UAA6B;IACpF,MAAM,YAAY,GAAG,UAAU,CAAC,YAAY,CAAC;IAC7C,OAAO;QACL,UAAU;QACV,UAAU,EAAE,aAAa,CAAC,EAAE,EAAE,YAAY,CAAC;QAC3C,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC;;gEAEyC,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC;QAC/E,mBAAmB,EAAE,EAAE,CAAC,OAAO,CAAC,wIAAwI,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC;QAC3L,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,kFAAkF,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC;QACvH,SAAS,EAAE,EAAE,CAAC,OAAO,CAAC,yIAAyI,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC;KACnL,CAAC;AACJ,CAAC;AAED,MAAM,iBAAiB,GAAG;;;;;;;;CAQzB,CAAC"}

package/dist/core/ledger-store.d.ts

@@ -0,0 +1,64 @@
+import { type LedgerEventActor, type LedgerMode } from '../schemas/ledger.js';
+import type { LedgerDatabase } from './ledger-db.js';
+export type StartTrajectoryInput = {
+    mode: LedgerMode;
+    target: string;
+    name: string;
+    projectRoot: string;
+    workspaceRoot: string;
+    maxIterations?: number;
+    context?: Record<string, unknown>;
+    instructions?: Record<string, unknown>;
+};
+export type TrajectorySummary = {
+    trajectoryId: string;
+    humanId: string;
+    mode: LedgerMode;
+    target: string;
+    status: 'active' | 'closed';
+    activeIterationId: string | null;
+    maxIterations: number | null;
+};
+export type AppendEventInput = {
+    trajectoryId?: string;
+    iterationId?: string;
+    runId?: string;
+    eventType: string;
+    actor?: LedgerEventActor;
+    command?: string;
+    inputsSummary?: string;
+    resultStatus?: string;
+    artifactRefs?: unknown[];
+    agentFeedback?: string;
+    notes?: string;
+};
+export type ResolveTrajectoryInput = {
+    trajectoryId?: string;
+    target?: string;
+    mode?: LedgerMode;
+    projectRoot?: string;
+    status?: 'active' | 'closed';
+};
+export declare class LedgerAmbiguityError extends Error {
+    readonly candidates: TrajectorySummary[];
+    constructor(candidates: TrajectorySummary[]);
+}
+export declare function createLedgerStore(db: LedgerDatabase): {
+    startTrajectory(input: StartTrajectoryInput): TrajectorySummary;
+    appendEvent(input: AppendEventInput): {
+        eventId: unknown;
+    };
+    resolveTrajectory(input: ResolveTrajectoryInput): TrajectorySummary;
+    advanceIteration(trajectoryId: string): {
+        iterationId: string;
+    };
+    closeTrajectory(trajectoryId: string): TrajectorySummary;
+    exportTrajectoryJson(trajectoryId: string): {
+        trajectory: TrajectorySummary;
+        iterations: unknown[];
+        events: unknown[];
+        instructionVersions: unknown[];
+        notes: unknown[];
+        artifacts: unknown[];
+    };
+};

package/dist/core/ledger-store.js

@@ -0,0 +1,134 @@
+import { ledgerModeSchema } from '../schemas/ledger.js';
+import { insertLedgerEvent } from './ledger-events.js';
+import { createLedgerId, createTrajectoryId } from './ledger-ids.js';
+import { exportTrajectoryRows, getIterations, getTrajectory, queryTrajectories } from './ledger-queries.js';
+export class LedgerAmbiguityError extends Error {
+    candidates;
+    constructor(candidates) {
+        super(`Multiple trajectories matched: ${candidates.map((candidate) => candidate.trajectoryId).join(', ')}`);
+        this.candidates = candidates;
+    }
+}
+class LedgerNotFoundError extends Error {
+    constructor(message) {
+        super(message);
+    }
+}
+export function createLedgerStore(db) {
+    return {
+        startTrajectory(input) {
+            const mode = ledgerModeSchema.parse(input.mode);
+            const now = new Date().toISOString();
+            const trajectoryId = createTrajectoryId(input);
+            const iterationId = 'iter_001';
+            const instructions = input.instructions ?? {};
+            const context = input.context ?? {};
+            const transaction = db.transaction(() => {
+                db.prepare(`
+          insert into trajectories (
+            trajectory_id, human_id, mode, project_root, workspace_root, target, status,
+            max_iterations, active_iteration_id, context_json, instructions_json, created_at, updated_at
+          ) values (?, ?, ?, ?, ?, ?, 'active', ?, ?, ?, ?, ?, ?)
+        `).run(trajectoryId, input.name, mode, input.projectRoot, input.workspaceRoot, input.target, input.maxIterations ?? null, iterationId, json(context), json(instructions), now, now);
+                db.prepare(`
+          insert into iterations (
+            iteration_id, trajectory_id, sequence, focus, status, instructions_json, created_at
+          ) values (?, ?, 1, null, 'active', ?, ?)
+        `).run(iterationId, trajectoryId, json(instructions), now);
+                db.prepare(`
+          insert into instruction_versions (version_id, trajectory_id, iteration_id, instructions_json, created_at)
+          values (?, ?, ?, ?, ?)
+        `).run(createLedgerId('instr'), trajectoryId, iterationId, json(instructions), now);
+                insertLedgerEvent(db, {
+                    trajectoryId,
+                    iterationId,
+                    eventType: 'loop.started',
+                    actor: 'cli',
+                    command: 'loop start',
+                    resultStatus: 'ok',
+                }, now);
+            });
+            transaction();
+            return mustGetTrajectory(db, trajectoryId);
+        },
+        appendEvent(input) {
+            const now = new Date().toISOString();
+            insertLedgerEvent(db, input, now);
+            return { eventId: db.prepare('select event_id as eventId from ledger_events order by rowid desc limit 1').get() };
+        },
+        resolveTrajectory(input) {
+            const candidates = queryTrajectories(db, input);
+            if (candidates.length === 0)
+                throw new LedgerNotFoundError('No matching trajectory found');
+            if (candidates.length > 1)
+                throw new LedgerAmbiguityError(candidates);
+            return candidates[0];
+        },
+        advanceIteration(trajectoryId) {
+            const trajectory = mustGetTrajectory(db, trajectoryId);
+            const rows = getIterations(db, trajectoryId);
+            const nextSequence = rows.length + 1;
+            const nextIterationId = `iter_${String(nextSequence).padStart(3, '0')}`;
+            const now = new Date().toISOString();
+            const source = db.prepare('select instructions_json from trajectories where trajectory_id = ?').get(trajectoryId);
+            const transaction = db.transaction(() => {
+                if (trajectory.activeIterationId) {
+                    db.prepare("update iterations set status = 'closed', closed_at = ? where trajectory_id = ? and iteration_id = ?")
+                        .run(now, trajectoryId, trajectory.activeIterationId);
+                }
+                db.prepare(`
+          insert into iterations (iteration_id, trajectory_id, sequence, focus, status, instructions_json, created_at)
+          values (?, ?, ?, null, 'active', ?, ?)
+        `).run(nextIterationId, trajectoryId, nextSequence, source.instructions_json, now);
+                db.prepare('update trajectories set active_iteration_id = ?, updated_at = ? where trajectory_id = ?')
+                    .run(nextIterationId, now, trajectoryId);
+                insertLedgerEvent(db, {
+                    trajectoryId,
+                    iterationId: nextIterationId,
+                    eventType: 'loop.next.started',
+                    actor: 'cli',
+                    command: 'loop next',
+                    resultStatus: 'ok',
+                }, now);
+            });
+            transaction();
+            return { iterationId: nextIterationId };
+        },
+        closeTrajectory(trajectoryId) {
+            const trajectory = mustGetTrajectory(db, trajectoryId);
+            const now = new Date().toISOString();
+            const transaction = db.transaction(() => {
+                if (trajectory.activeIterationId) {
+                    db.prepare("update iterations set status = 'closed', closed_at = ? where trajectory_id = ? and iteration_id = ?")
+                        .run(now, trajectoryId, trajectory.activeIterationId);
+                }
+                db.prepare("update trajectories set status = 'closed', active_iteration_id = null, updated_at = ? where trajectory_id = ?")
+                    .run(now, trajectoryId);
+                insertLedgerEvent(db, {
+                    trajectoryId,
+                    iterationId: trajectory.activeIterationId ?? undefined,
+                    eventType: 'loop.iteration.closed',
+                    actor: 'cli',
+                    command: 'loop close',
+                    resultStatus: 'ok',
+                }, now);
+            });
+            transaction();
+            return mustGetTrajectory(db, trajectoryId);
+        },
+        exportTrajectoryJson(trajectoryId) {
+            const trajectory = mustGetTrajectory(db, trajectoryId);
+            return exportTrajectoryRows(db, trajectory);
+        },
+    };
+}
+function mustGetTrajectory(db, trajectoryId) {
+    const row = getTrajectory(db, trajectoryId);
+    if (!row)
+        throw new LedgerNotFoundError(`Trajectory not found: ${trajectoryId}`);
+    return row;
+}
+function json(value) {
+    return JSON.stringify(value);
+}
+//# sourceMappingURL=ledger-store.js.map

package/dist/core/ledger-store.js.map

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

package/dist/core/loop-instructions.d.ts

@@ -0,0 +1,2 @@
+import type { LedgerMode } from '../schemas/ledger.js';
+export declare function defaultLoopInstructions(mode: LedgerMode): Record<string, unknown>;

package/dist/core/loop-instructions.js

@@ -0,0 +1,8 @@
+export function defaultLoopInstructions(mode) {
+    if (mode === 'image-mockup')
+        return { editableSurface: 'mockup', editInstructions: ['Edit the Limner reference mockup.'] };
+    if (mode === 'mockup-implementation')
+        return { editableSurface: 'implementation', editInstructions: ['Edit the implementation to match the approved mockup.'] };
+    return { editableSurface: 'implementation', editInstructions: ['Edit the implementation to match the source image.'] };
+}
+//# sourceMappingURL=loop-instructions.js.map

package/dist/core/loop-instructions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop-instructions.js","sourceRoot":"","sources":["../../src/core/loop-instructions.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,uBAAuB,CAAC,IAAgB;IACtD,IAAI,IAAI,KAAK,cAAc;QAAE,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,gBAAgB,EAAE,CAAC,mCAAmC,CAAC,EAAE,CAAC;IAC3H,IAAI,IAAI,KAAK,uBAAuB;QAAE,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,CAAC,uDAAuD,CAAC,EAAE,CAAC;IAChK,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,CAAC,oDAAoD,CAAC,EAAE,CAAC;AACzH,CAAC"}

package/dist/index.d.ts

@@ -6,9 +6,13 @@ export { visualSpecBundleSchema, visualSpecDiffSchema, visualSpecSchema, createV
 export type { VisualSpec, VisualSpecBundle, VisualSpecDiff } from './schemas/visual-spec.js';
 export { agentComparisonBundleSchema, imageComparisonSchema, structureComparisonSchema, createAgentComparisonBundleExample, createAgentComparisonJsonSchema, } from './schemas/comparison.js';
 export type { AgentComparisonBundle, ImageComparison, StructureComparison } from './schemas/comparison.js';
+export { agentFeedbackSchema, iterationStatusSchema, ledgerEventActorSchema, ledgerModeSchema, trajectoryStatusSchema, } from './schemas/ledger.js';
+export type { AgentFeedback, IterationStatus, LedgerEventActor, LedgerMode, TrajectoryStatus } from './schemas/ledger.js';
 export { initTarget } from './commands/init.js';
 export { captureReference } from './commands/capture.js';
 export { compareImageReference, compareReferenceImplementation } from './commands/compare.js';
+export { exportLedger, getLedgerNext, getLedgerStatus, listLedger, showLedger } from './commands/ledger.js';
+export { advanceLoop, closeLoop, compareLoop, getLoopStatus, startLoop } from './commands/loop.js';
 export { createRunId, createRunLogger } from './core/run-logger.js';
 export { resolveWorkspace, validateTargetName } from './core/workspace.js';
 export { collectReferenceDomFacts } from './core/reference-dom-facts.js';