@neonwatty/limner 0.1.2 → 0.1.4

package/README.md

@@ -54,9 +54,13 @@ npm run check
 limner init ./ideal.png --target replay-boundaries
 limner preview --target replay-boundaries
 limner capture reference --target replay-boundaries
+limner loop start --mode image-mockup --target replay-boundaries --name replay-boundaries-polish --max-iterations 5
+limner loop compare --trajectory traj_...
+limner loop status --trajectory traj_...
 limner compare image-reference --target replay-boundaries
 limner compare reference-implementation --target replay-boundaries --url http://localhost:3152/internal/optimization-lab/wedding-envelope#replay-boundaries --storage-state ./e2e/.auth/user.json
 limner report --target replay-boundaries
+limner ledger export traj_... --format markdown
 limner runs list
 ```
 
@@ -81,6 +85,37 @@ limner-workspace/
 
 ## Modes
 
+### Loop Ledger
+
+Use `limner loop` for Ralph Loop-style polishing. Loop work is tracked in a global local-only SQLite ledger at `~/.limner/ledger.sqlite`; no telemetry is sent.
+
+```bash
+limner loop start --mode image-mockup --target replay-boundaries --name replay-boundaries-polish --max-iterations 5
+limner loop compare --trajectory traj_...
+limner loop status --trajectory traj_... --feedback "Prompt should mention button contrast."
+limner loop next --trajectory traj_...
+limner loop close --trajectory traj_...
+```
+
+Loop modes:
+
+- `image-mockup`: source image to editable HTML mockup.
+- `mockup-implementation`: approved mockup to real implementation.
+- `image-implementation`: source image directly to real implementation.
+
+Every meaningful loop interaction writes a ledger event. `agentFeedback` is an optional 255-character field for short process-improvement notes; longer comments belong in notes or project artifacts.
+
+Use `limner ledger` to query and export trajectories:
+
+```bash
+limner ledger list --active
+limner ledger status --trajectory traj_...
+limner ledger show traj_...
+limner ledger next --trajectory traj_...
+limner ledger export traj_... --format json
+limner ledger export traj_... --format markdown
+```
+
 ### Image To Reference
 
 Use this while recreating the ideal image as a standalone HTML/CSS mockup. This mode uses the `ideal-to-mockup` agent comparison profile.

package/dist/cli.js

@@ -1,21 +1,27 @@
 #!/usr/bin/env node
+import { readFileSync } from 'node:fs';
 import { Command } from 'commander';
 import { registerCaptureCommand } from './commands/capture.js';
 import { registerCompareCommand } from './commands/compare.js';
 import { registerInitCommand } from './commands/init.js';
+import { registerLedgerCommand } from './commands/ledger.js';
+import { registerLoopCommand } from './commands/loop-cli.js';
 import { registerPreviewCommand } from './commands/preview.js';
 import { registerReportCommand } from './commands/report.js';
 import { registerRunsCommand } from './commands/runs.js';
+const packageJson = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'));
 const program = new Command();
 program
     .name('limner')
     .description('Agent-guided visual fidelity workbench')
-    .version('0.1.1')
+    .version(packageJson.version)
     .option('-w, --workspace <path>', 'Limner workspace root', process.cwd());
 registerInitCommand(program);
 registerPreviewCommand(program);
 registerCaptureCommand(program);
 registerCompareCommand(program);
+registerLoopCommand(program);
+registerLedgerCommand(program);
 registerReportCommand(program);
 registerRunsCommand(program);
 program.parseAsync(process.argv).catch((error) => {

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,QAAQ,CAAC;KACd,WAAW,CAAC,wCAAwC,CAAC;KACrD,OAAO,CAAC,OAAO,CAAC;KAChB,MAAM,CAAC,wBAAwB,EAAE,uBAAuB,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;AAE5E,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAC7B,sBAAsB,CAAC,OAAO,CAAC,CAAC;AAChC,sBAAsB,CAAC,OAAO,CAAC,CAAC;AAChC,sBAAsB,CAAC,OAAO,CAAC,CAAC;AAChC,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAE7B,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IACxD,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO,CAAC,KAAK,CAAC,WAAW,OAAO,EAAE,CAAC,CAAC;IACpC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAC5B,YAAY,CAAC,IAAI,GAAG,CAAC,iBAAiB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAC3C,CAAC;AAEzB,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,QAAQ,CAAC;KACd,WAAW,CAAC,wCAAwC,CAAC;KACrD,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC;KAC5B,MAAM,CAAC,wBAAwB,EAAE,uBAAuB,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;AAE5E,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAC7B,sBAAsB,CAAC,OAAO,CAAC,CAAC;AAChC,sBAAsB,CAAC,OAAO,CAAC,CAAC;AAChC,sBAAsB,CAAC,OAAO,CAAC,CAAC;AAChC,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAC7B,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAE7B,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IACxD,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO,CAAC,KAAK,CAAC,WAAW,OAAO,EAAE,CAAC,CAAC;IACpC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}

package/dist/commands/ledger.d.ts

@@ -0,0 +1,43 @@
+import type { Command } from 'commander';
+import type { LedgerMode } from '../schemas/ledger.js';
+type LedgerEnv = Partial<Pick<NodeJS.ProcessEnv, 'LIMNER_LEDGER_HOME'>>;
+export declare function listLedger(input: {
+    ledgerEnv?: LedgerEnv;
+    active?: boolean;
+    projectRoot?: string;
+    mode?: LedgerMode;
+}): {
+    lines: string[];
+};
+export declare function getLedgerStatus(input: {
+    ledgerEnv?: LedgerEnv;
+    trajectoryId: string;
+}): {
+    lines: string[];
+};
+export declare function showLedger(input: {
+    ledgerEnv?: LedgerEnv;
+    trajectoryId: string;
+}): {
+    json: {
+        trajectory: import("../core/ledger-store.js").TrajectorySummary;
+        iterations: unknown[];
+        events: unknown[];
+        instructionVersions: unknown[];
+        notes: unknown[];
+        artifacts: unknown[];
+    };
+};
+export declare function getLedgerNext(input: {
+    ledgerEnv?: LedgerEnv;
+    trajectoryId: string;
+}): {
+    line: string;
+};
+export declare function exportLedger(input: {
+    ledgerEnv?: LedgerEnv;
+    trajectoryId: string;
+    format: 'json' | 'markdown';
+}): string;
+export declare function registerLedgerCommand(program: Command): void;
+export {};

package/dist/commands/ledger.js

@@ -0,0 +1,102 @@
+import { openLedgerDatabase } from '../core/ledger-db.js';
+import { resolveLedgerPaths } from '../core/ledger-paths.js';
+import { createLedgerStore } from '../core/ledger-store.js';
+export function listLedger(input) {
+    return withDb(input.ledgerEnv, (db) => {
+        const conditions = [];
+        const params = [];
+        if (input.active) {
+            conditions.push("status = 'active'");
+        }
+        if (input.projectRoot) {
+            conditions.push('project_root = ?');
+            params.push(input.projectRoot);
+        }
+        if (input.mode) {
+            conditions.push('mode = ?');
+            params.push(input.mode);
+        }
+        const where = conditions.length > 0 ? `where ${conditions.join(' and ')}` : '';
+        const rows = db.prepare(`select trajectory_id as trajectoryId, human_id as humanId, mode, target, status from trajectories ${where} order by updated_at desc`).all(...params);
+        return { lines: rows.map(formatRow) };
+    });
+}
+export function getLedgerStatus(input) {
+    return withStore(input.ledgerEnv, (store) => {
+        const trajectory = store.resolveTrajectory({ trajectoryId: input.trajectoryId });
+        store.appendEvent({ trajectoryId: trajectory.trajectoryId, eventType: 'ledger.status.viewed', actor: 'cli', command: 'ledger status', resultStatus: 'ok' });
+        const exported = store.exportTrajectoryJson(trajectory.trajectoryId);
+        return {
+            lines: [
+                `Trajectory: ${trajectory.trajectoryId}`,
+                `Name: ${trajectory.humanId}`,
+                `Mode: ${trajectory.mode}`,
+                `Target: ${trajectory.target}`,
+                `Status: ${trajectory.status}`,
+                `Iterations: ${exported.iterations.length}`,
+                `Events: ${exported.events.length}`,
+            ],
+        };
+    });
+}
+export function showLedger(input) {
+    return withStore(input.ledgerEnv, (store) => {
+        store.appendEvent({ trajectoryId: input.trajectoryId, eventType: 'ledger.show.viewed', actor: 'cli', command: 'ledger show', resultStatus: 'ok' });
+        return { json: store.exportTrajectoryJson(input.trajectoryId) };
+    });
+}
+export function getLedgerNext(input) {
+    return withStore(input.ledgerEnv, (store) => {
+        const trajectory = store.resolveTrajectory({ trajectoryId: input.trajectoryId });
+        store.appendEvent({ trajectoryId: trajectory.trajectoryId, eventType: 'ledger.next.viewed', actor: 'cli', command: 'ledger next', resultStatus: 'ok' });
+        return { line: `Next: run limner loop compare --trajectory ${trajectory.trajectoryId}` };
+    });
+}
+export function exportLedger(input) {
+    return withStore(input.ledgerEnv, (store) => {
+        store.appendEvent({ trajectoryId: input.trajectoryId, eventType: 'ledger.exported', actor: 'cli', command: 'ledger export', resultStatus: 'ok' });
+        const exported = store.exportTrajectoryJson(input.trajectoryId);
+        if (input.format === 'json')
+            return JSON.stringify(exported, null, 2) + '\n';
+        return [
+            '# Limner Trajectory',
+            '',
+            `Trajectory: ${exported.trajectory.trajectoryId}`,
+            `Name: ${exported.trajectory.humanId}`,
+            `Mode: ${exported.trajectory.mode}`,
+            `Status: ${exported.trajectory.status}`,
+            `Iterations: ${exported.iterations.length}`,
+            `Events: ${exported.events.length}`,
+            '',
+        ].join('\n');
+    });
+}
+export function registerLedgerCommand(program) {
+    const ledger = program.command('ledger').description('Query the global Limner loop ledger');
+    ledger.command('list').option('--active', 'only active trajectories').option('--project <path>', 'project root').option('--mode <mode>', 'loop mode')
+        .action((options) => console.log(listLedger({ active: options.active, projectRoot: options.project, mode: options.mode }).lines.join('\n')));
+    ledger.command('status').requiredOption('--trajectory <id>', 'trajectory id')
+        .action((options) => console.log(getLedgerStatus({ trajectoryId: options.trajectory }).lines.join('\n')));
+    ledger.command('show').argument('<id>', 'trajectory id')
+        .action((id) => console.log(JSON.stringify(showLedger({ trajectoryId: id }).json, null, 2)));
+    ledger.command('next').requiredOption('--trajectory <id>', 'trajectory id')
+        .action((options) => console.log(getLedgerNext({ trajectoryId: options.trajectory }).line));
+    ledger.command('export').argument('<id>', 'trajectory id').option('--format <format>', 'json or markdown', 'json')
+        .action((id, options) => console.log(exportLedger({ trajectoryId: id, format: options.format })));
+}
+function withStore(env, callback) {
+    return withDb(env, (db) => callback(createLedgerStore(db)));
+}
+function withDb(env, callback) {
+    const db = openLedgerDatabase({ databasePath: resolveLedgerPaths(env).databasePath });
+    try {
+        return callback(db);
+    }
+    finally {
+        db.close();
+    }
+}
+function formatRow(row) {
+    return `${row.trajectoryId} ${row.mode} ${row.target} ${row.status} ${row.humanId}`;
+}
+//# sourceMappingURL=ledger.js.map

package/dist/commands/ledger.js.map

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

package/dist/commands/loop-cli.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from 'commander';
+export declare function registerLoopCommand(program: Command): void;

package/dist/commands/loop-cli.js

@@ -0,0 +1,71 @@
+import { advanceLoop, closeLoop, compareLoop, getLoopStatus, startLoop } from './loop.js';
+export function registerLoopCommand(program) {
+    const loop = program.command('loop').description('Manage Limner comparison loops');
+    loop
+        .command('start')
+        .requiredOption('--mode <mode>', 'loop mode')
+        .requiredOption('-t, --target <name>', 'target name')
+        .option('--name <name>', 'human-readable trajectory name')
+        .option('--max-iterations <count>', 'maximum planned iterations')
+        .option('-u, --url <url>', 'implementation URL for implementation modes')
+        .option('--storage-state <path>', 'Playwright storageState JSON')
+        .option('--full-page', 'capture the full scrollable page')
+        .action((options, command) => {
+        const globals = command.optsWithGlobals();
+        const result = startLoop({
+            workspaceRoot: globals.workspace,
+            target: options.target,
+            mode: options.mode,
+            name: options.name,
+            maxIterations: options.maxIterations ? Number(options.maxIterations) : undefined,
+            url: options.url,
+            storageState: options.storageState,
+            fullPage: options.fullPage,
+        });
+        console.log(`Trajectory: ${result.trajectoryId}`);
+        console.log(`Active iteration: ${result.iterationId}`);
+    });
+    loop
+        .command('status')
+        .option('--trajectory <id>', 'trajectory id')
+        .option('-t, --target <name>', 'target name')
+        .option('--mode <mode>', 'loop mode')
+        .option('--feedback <text>', 'short agent feedback, max 255 characters')
+        .action((options) => {
+        console.log(getLoopStatus({ trajectoryId: options.trajectory, target: options.target, mode: options.mode, feedback: options.feedback }).lines.join('\n'));
+    });
+    loop.command('next').option('--trajectory <id>', 'trajectory id').action((options) => {
+        console.log(`Active iteration: ${advanceLoop({ trajectoryId: options.trajectory }).iterationId}`);
+    });
+    loop.command('close').option('--trajectory <id>', 'trajectory id').action((options) => {
+        console.log(`Status: ${closeLoop({ trajectoryId: options.trajectory }).status}`);
+    });
+    loop
+        .command('compare')
+        .option('--trajectory <id>', 'trajectory id')
+        .option('-t, --target <name>', 'target name')
+        .option('--mode <mode>', 'loop mode')
+        .option('-u, --url <url>', 'implementation URL')
+        .option('--storage-state <path>', 'Playwright storageState JSON')
+        .option('--headed', 'show browser while capturing')
+        .option('--full-page', 'capture the full scrollable page')
+        .action(async (options, command) => {
+        const globals = command.optsWithGlobals();
+        const result = await compareLoop({
+            workspaceRoot: globals.workspace,
+            trajectoryId: options.trajectory,
+            target: options.target,
+            mode: options.mode,
+            url: options.url,
+            storageState: options.storageState,
+            headed: options.headed,
+            fullPage: options.fullPage,
+        });
+        console.log(`Side-by-side: ${result.sideBySidePath}`);
+        if (result.reportPath)
+            console.log(`Report: ${result.reportPath}`);
+        if (result.agentComparison)
+            console.log(`Agent comparison status: ${result.agentComparison.status}`);
+    });
+}
+//# sourceMappingURL=loop-cli.js.map

package/dist/commands/loop-cli.js.map

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

package/dist/commands/loop-comparison-adapters.d.ts

@@ -0,0 +1,17 @@
+import { type AgentComparisonPackResult } from '../core/agent-comparison-pack.js';
+import type { LedgerMode } from '../schemas/ledger.js';
+export type LoopCompareInput = {
+    workspaceRoot: string;
+    target: string;
+    mode: LedgerMode;
+    url?: string;
+    storageState?: string;
+    headed?: boolean;
+    fullPage?: boolean;
+};
+export type LoopCompareResult = {
+    sideBySidePath: string;
+    reportPath?: string;
+    agentComparison?: AgentComparisonPackResult;
+};
+export declare function runLoopComparison(input: LoopCompareInput): Promise<LoopCompareResult>;

package/dist/commands/loop-comparison-adapters.js

@@ -0,0 +1,85 @@
+import { mkdir, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { writeAgentComparisonPack } from '../core/agent-comparison-pack.js';
+import { loadRegionContract } from '../core/dom-metrics.js';
+import { capturePage } from '../core/playwright-capture.js';
+import { createRunLogger } from '../core/run-logger.js';
+import { createSideBySideImage } from '../core/side-by-side.js';
+import { resolveTargetWithSource, resolveWorkspace } from '../core/workspace.js';
+import { compareImageReference, compareReferenceImplementation } from './compare.js';
+export async function runLoopComparison(input) {
+    if (input.mode === 'image-mockup') {
+        return compareImageReference({ workspaceRoot: input.workspaceRoot, target: input.target, headed: input.headed, fullPage: input.fullPage });
+    }
+    if (input.mode === 'mockup-implementation') {
+        if (!input.url)
+            throw new Error('mockup-implementation requires an implementation URL.');
+        return compareReferenceImplementation({
+            workspaceRoot: input.workspaceRoot,
+            target: input.target,
+            url: input.url,
+            headed: input.headed,
+            storageState: input.storageState,
+            fullPage: input.fullPage,
+        });
+    }
+    return compareImageImplementation(input);
+}
+async function compareImageImplementation(input) {
+    if (!input.url)
+        throw new Error('image-implementation requires an implementation URL.');
+    const workspace = resolveWorkspace(input.workspaceRoot);
+    const target = await resolveTargetWithSource(input.workspaceRoot, input.target);
+    const logger = await createRunLogger(workspace, { command: 'loop compare', target: input.target, mode: 'image-implementation' });
+    const captureDir = path.join(target.capturesDir, 'image-implementation');
+    const implementationPath = path.join(captureDir, 'implementation.png');
+    const sideBySidePath = path.join(captureDir, 'side-by-side.png');
+    const reportPath = path.join(target.reportsDir, 'image-implementation.md');
+    try {
+        await logger.event({ type: 'command.started' });
+        await mkdir(captureDir, { recursive: true });
+        const contract = await loadRegionContract(target.regionsPath);
+        await capturePage({
+            url: input.url,
+            outputPath: implementationPath,
+            contract,
+            side: 'app',
+            headed: input.headed,
+            storageState: input.storageState,
+            fullPage: input.fullPage,
+        });
+        await createSideBySideImage({ leftPath: target.sourceImagePath, rightPath: implementationPath, outputPath: sideBySidePath });
+        const agentComparison = await writeAgentComparisonPack({
+            workspaceRoot: input.workspaceRoot,
+            captureDir,
+            mode: 'image-implementation',
+            profile: 'ideal-to-implementation',
+            imageInputs: {
+                expectedImagePath: target.sourceImagePath,
+                actualImagePath: implementationPath,
+            },
+        });
+        await writeFile(reportPath, [
+            '# Image To Implementation Comparison',
+            '',
+            `Source image: ${target.sourceImagePath}`,
+            `Implementation: ${implementationPath}`,
+            `Side-by-side: ${sideBySidePath}`,
+            `Agent comparison: ${agentComparison.responsePath}`,
+            '',
+        ].join('\n'));
+        await logger.artifact(implementationPath, 'screenshot');
+        await logger.artifact(sideBySidePath, 'side-by-side');
+        await logger.artifact(agentComparison.promptPath, 'agent-comparison-prompt');
+        await logger.artifact(agentComparison.schemaPath, 'agent-comparison-schema');
+        await logger.artifact(reportPath, 'report');
+        await logger.complete('ok');
+        return { sideBySidePath, reportPath, agentComparison };
+    }
+    catch (error) {
+        await logger.event({ type: 'command.failed', status: 'failed', message: error instanceof Error ? error.message : String(error) });
+        await logger.complete('failed');
+        throw error;
+    }
+}
+//# sourceMappingURL=loop-comparison-adapters.js.map

package/dist/commands/loop-comparison-adapters.js.map

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

package/dist/commands/loop.d.ts

@@ -0,0 +1,41 @@
+import { type LedgerMode } from '../schemas/ledger.js';
+type LedgerEnv = Partial<Pick<NodeJS.ProcessEnv, 'LIMNER_LEDGER_HOME'>>;
+export type StartLoopInput = {
+    ledgerEnv?: LedgerEnv;
+    workspaceRoot: string;
+    target: string;
+    mode: LedgerMode;
+    name?: string;
+    maxIterations?: number;
+    url?: string;
+    storageState?: string;
+    fullPage?: boolean;
+};
+export type TrajectorySelector = {
+    ledgerEnv?: LedgerEnv;
+    trajectoryId?: string;
+    target?: string;
+    mode?: LedgerMode;
+    feedback?: string;
+};
+export type CompareLoopInput = TrajectorySelector & {
+    workspaceRoot: string;
+    url?: string;
+    storageState?: string;
+    headed?: boolean;
+    fullPage?: boolean;
+};
+export declare function startLoop(input: StartLoopInput): {
+    trajectoryId: string;
+    iterationId: string | null;
+};
+export declare function getLoopStatus(input: TrajectorySelector): {
+    trajectory: import("../core/ledger-store.js").TrajectorySummary;
+    lines: string[];
+};
+export declare function advanceLoop(input: TrajectorySelector): {
+    iterationId: string;
+};
+export declare function closeLoop(input: TrajectorySelector): import("../core/ledger-store.js").TrajectorySummary;
+export declare function compareLoop(input: CompareLoopInput): Promise<import("./loop-comparison-adapters.js").LoopCompareResult>;
+export {};

package/dist/commands/loop.js

@@ -0,0 +1,151 @@
+import { ledgerModeSchema } from '../schemas/ledger.js';
+import { openLedgerDatabase } from '../core/ledger-db.js';
+import { defaultLoopInstructions } from '../core/loop-instructions.js';
+import { resolveLedgerPaths } from '../core/ledger-paths.js';
+import { createLedgerStore } from '../core/ledger-store.js';
+import { runLoopComparison } from './loop-comparison-adapters.js';
+export function startLoop(input) {
+    return withStore(input.ledgerEnv, (store) => {
+        const mode = ledgerModeSchema.parse(input.mode);
+        const trajectory = store.startTrajectory({
+            mode,
+            target: input.target,
+            name: input.name ?? input.target,
+            projectRoot: input.workspaceRoot,
+            workspaceRoot: input.workspaceRoot,
+            maxIterations: input.maxIterations,
+            context: {
+                url: input.url,
+                storageState: input.storageState,
+                fullPage: input.fullPage,
+            },
+            instructions: defaultLoopInstructions(mode),
+        });
+        return { trajectoryId: trajectory.trajectoryId, iterationId: trajectory.activeIterationId };
+    });
+}
+export function getLoopStatus(input) {
+    return withStore(input.ledgerEnv, (store) => {
+        const trajectory = store.resolveTrajectory(selector(input));
+        if (input.feedback) {
+            store.appendEvent({
+                trajectoryId: trajectory.trajectoryId,
+                iterationId: trajectory.activeIterationId ?? undefined,
+                eventType: 'loop.status.viewed',
+                actor: 'agent',
+                command: 'loop status',
+                resultStatus: 'ok',
+                agentFeedback: input.feedback,
+            });
+        }
+        else {
+            store.appendEvent({
+                trajectoryId: trajectory.trajectoryId,
+                iterationId: trajectory.activeIterationId ?? undefined,
+                eventType: 'loop.status.viewed',
+                actor: 'cli',
+                command: 'loop status',
+                resultStatus: 'ok',
+            });
+        }
+        const exported = store.exportTrajectoryJson(trajectory.trajectoryId);
+        return {
+            trajectory,
+            lines: [
+                `Trajectory: ${trajectory.trajectoryId}`,
+                `Name: ${trajectory.humanId}`,
+                `Mode: ${trajectory.mode}`,
+                `Target: ${trajectory.target}`,
+                `Status: ${trajectory.status}`,
+                `Active iteration: ${trajectory.activeIterationId ?? 'none'}`,
+                `Iterations: ${exported.iterations.length}`,
+                `Max iterations: ${trajectory.maxIterations ?? 'none'}`,
+            ],
+        };
+    });
+}
+export function advanceLoop(input) {
+    return withStore(input.ledgerEnv, (store) => {
+        const trajectory = store.resolveTrajectory(selector(input));
+        return store.advanceIteration(trajectory.trajectoryId);
+    });
+}
+export function closeLoop(input) {
+    return withStore(input.ledgerEnv, (store) => {
+        const trajectory = store.resolveTrajectory(selector(input));
+        return store.closeTrajectory(trajectory.trajectoryId);
+    });
+}
+export async function compareLoop(input) {
+    return withStoreAsync(input.ledgerEnv, async (store) => {
+        const trajectory = store.resolveTrajectory(selector(input));
+        store.appendEvent({
+            trajectoryId: trajectory.trajectoryId,
+            iterationId: trajectory.activeIterationId ?? undefined,
+            eventType: 'loop.compare.started',
+            actor: 'cli',
+            command: 'loop compare',
+            resultStatus: 'running',
+        });
+        try {
+            const result = await runLoopComparison({
+                workspaceRoot: input.workspaceRoot,
+                target: trajectory.target,
+                mode: trajectory.mode,
+                url: input.url,
+                storageState: input.storageState,
+                headed: input.headed,
+                fullPage: input.fullPage,
+            });
+            const eventType = result.agentComparison?.status === 'validated' ? 'loop.compare.validated' : 'loop.compare.awaiting_agent';
+            store.appendEvent({
+                trajectoryId: trajectory.trajectoryId,
+                iterationId: trajectory.activeIterationId ?? undefined,
+                eventType,
+                actor: 'cli',
+                command: 'loop compare',
+                resultStatus: result.agentComparison?.status ?? 'ok',
+                artifactRefs: [result.sideBySidePath, result.reportPath, result.agentComparison?.responsePath].filter(Boolean),
+            });
+            return result;
+        }
+        catch (error) {
+            store.appendEvent({
+                trajectoryId: trajectory.trajectoryId,
+                iterationId: trajectory.activeIterationId ?? undefined,
+                eventType: 'loop.compare.failed',
+                actor: 'cli',
+                command: 'loop compare',
+                resultStatus: 'failed',
+                notes: error instanceof Error ? error.message : String(error),
+            });
+            throw error;
+        }
+    });
+}
+function withStore(env, callback) {
+    const db = openLedgerDatabase({ databasePath: resolveLedgerPaths(env).databasePath });
+    try {
+        return callback(createLedgerStore(db));
+    }
+    finally {
+        db.close();
+    }
+}
+async function withStoreAsync(env, callback) {
+    const db = openLedgerDatabase({ databasePath: resolveLedgerPaths(env).databasePath });
+    try {
+        return await callback(createLedgerStore(db));
+    }
+    finally {
+        db.close();
+    }
+}
+function selector(input) {
+    return {
+        trajectoryId: input.trajectoryId,
+        target: input.target,
+        mode: input.mode,
+    };
+}
+//# sourceMappingURL=loop.js.map

package/dist/commands/loop.js.map

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