logigo-core

LogiGo runtime library for checkpoint-based debugging and live code visualization.

Installation

``bash
npm install logigo-core
`

Usage

$3

`javascript
import { checkpoint } from 'logigo-core';

function bubbleSort(arr) {
checkpoint('sort_start', { arr });

for (let i = 0; i < arr.length; i++) {
checkpoint('outer_loop', { i });

for (let j = 0; j < arr.length - i - 1; j++) {
if (arr[j] > arr[j + 1]) {
[arr[j], arr[j + 1]] = [arr[j + 1], arr[j]];
checkpoint('swap', { i, j, arr: [...arr] });
}
}
}

checkpoint('sort_end', { arr });
return arr;
}
`

$3

`javascript
import { checkpointAsync, LogiGoRuntime } from 'logigo-core';

const runtime = new LogiGoRuntime({ manifestHash: 'abc123' });
runtime.setBreakpoint('critical_point', true);

async function processData(data) {
await checkpointAsync('critical_point', { data });
// Execution pauses here until runtime.resume() is called
}
``

API

$3

Synchronously records a checkpoint with optional variable capture.

$3

Records a checkpoint that can pause execution at breakpoints.

$3

Full runtime class with session management, breakpoints, and queue control.

$3

Generates lightweight JSON for LLM consumption from flowchart data.

Features

- Deferred serialization for performance
- Queue overflow protection (5000 limit)
- Breakpoint support for debugging
- Session management for HMR sync
- Grounding layer for AI integration

License

MIT