@livestore/cli 0.0.0-snapshot-2ac5fd340c97c9e07fe4c5dc6d31d5132aa6557c.0

package/dist/commands/mcp.js

@@ -0,0 +1,67 @@
+import { Effect, Layer, Logger, McpServer } from '@livestore/utils/effect';
+import { Cli, PlatformNode } from '@livestore/utils/node';
+import { architectureContent } from "../mcp-content/architecture.js";
+import { featuresContent } from "../mcp-content/features.js";
+import { gettingStartedContent } from "../mcp-content/getting-started.js";
+// Content imports
+import { overviewContent } from "../mcp-content/overview.js";
+import { blogSchemaContent } from "../mcp-content/schemas/blog.js";
+import { ecommerceSchemaContent } from "../mcp-content/schemas/ecommerce.js";
+import { socialSchemaContent } from "../mcp-content/schemas/social.js";
+import { todoSchemaContent } from "../mcp-content/schemas/todo.js";
+// Tools imports
+import { livestoreToolkit, toolHandlers } from "./mcp-tools.js";
+const LivestoreResources = Layer.mergeAll(McpServer.resource({
+    uri: 'livestore://overview',
+    name: 'LiveStore Overview',
+    description: 'Overview of LiveStore - the local-first data platform',
+    content: Effect.succeed(overviewContent),
+}), McpServer.resource({
+    uri: 'livestore://features',
+    name: 'LiveStore Features',
+    description: 'Core features and capabilities of LiveStore',
+    content: Effect.succeed(featuresContent),
+}), McpServer.resource({
+    uri: 'livestore://getting-started',
+    name: 'Getting Started with LiveStore',
+    description: 'Quick start guide for LiveStore development',
+    content: Effect.succeed(gettingStartedContent),
+}), McpServer.resource({
+    uri: 'livestore://architecture',
+    name: 'LiveStore Architecture',
+    description: 'Technical architecture and design principles of LiveStore',
+    content: Effect.succeed(architectureContent),
+}), McpServer.resource({
+    uri: 'livestore://schemas/todo',
+    name: 'Todo App Schema',
+    description: 'Complete LiveStore schema for a todo application with tags',
+    content: Effect.succeed(todoSchemaContent),
+}), McpServer.resource({
+    uri: 'livestore://schemas/blog',
+    name: 'Blog Platform Schema',
+    description: 'LiveStore schema for a blog platform with posts and comments',
+    content: Effect.succeed(blogSchemaContent),
+}), McpServer.resource({
+    uri: 'livestore://schemas/social',
+    name: 'Social Media Schema',
+    description: 'LiveStore schema for a social media platform with users, posts, and interactions',
+    content: Effect.succeed(socialSchemaContent),
+}), McpServer.resource({
+    uri: 'livestore://schemas/ecommerce',
+    name: 'E-commerce Schema',
+    description: 'LiveStore schema for an e-commerce platform with products, orders, and categories',
+    content: Effect.succeed(ecommerceSchemaContent),
+}));
+const LivestoreTools = McpServer.toolkit(livestoreToolkit).pipe(Layer.provide(livestoreToolkit.toLayer(toolHandlers)));
+const mcpServerCommand = Cli.Command.make('server', {}, Effect.fn(function* () {
+    yield* Effect.log('🚀 Starting LiveStore MCP Server...');
+    // Following Tim Smart's exact pattern from main.ts
+    return yield* McpServer.layerStdio({
+        name: 'livestore-mcp',
+        version: '0.1.0',
+        stdin: PlatformNode.NodeStream.stdin,
+        stdout: PlatformNode.NodeSink.stdout,
+    }).pipe(Layer.provide(LivestoreResources), Layer.provide(LivestoreTools), Layer.provide(Logger.add(Logger.prettyLogger({ stderr: true }))), Layer.launch);
+}));
+export const mcpCommand = Cli.Command.make('mcp').pipe(Cli.Command.withSubcommands([mcpServerCommand]));
+//# sourceMappingURL=mcp.js.map

package/dist/commands/mcp.js.map

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

package/dist/commands/new-project.d.ts

@@ -0,0 +1,34 @@
+import { HttpClient, Option, Schema } from '@livestore/utils/effect';
+import { Cli } from '@livestore/utils/node';
+declare const ExampleNotFoundError_base: Schema.TaggedErrorClass<ExampleNotFoundError, "ExampleNotFoundError", {
+    readonly _tag: Schema.tag<"ExampleNotFoundError">;
+} & {
+    exampleName: typeof Schema.String;
+    availableExamples: Schema.Array$<typeof Schema.String>;
+    message: typeof Schema.String;
+}>;
+export declare class ExampleNotFoundError extends ExampleNotFoundError_base {
+}
+declare const NetworkError_base: Schema.TaggedErrorClass<NetworkError, "NetworkError", {
+    readonly _tag: Schema.tag<"NetworkError">;
+} & {
+    cause: typeof Schema.Unknown;
+    message: typeof Schema.String;
+}>;
+export declare class NetworkError extends NetworkError_base {
+}
+declare const DirectoryExistsError_base: Schema.TaggedErrorClass<DirectoryExistsError, "DirectoryExistsError", {
+    readonly _tag: Schema.tag<"DirectoryExistsError">;
+} & {
+    path: typeof Schema.String;
+    message: typeof Schema.String;
+}>;
+export declare class DirectoryExistsError extends DirectoryExistsError_base {
+}
+export declare const newProjectCommand: Cli.Command.Command<"new-project", HttpClient.HttpClient | Cli.Prompt.Prompt.Environment | import("@effect/platform/CommandExecutor").CommandExecutor, Error | import("@effect/platform/HttpClientError").ResponseError | import("@effect/platform/Error").PlatformError, {
+    readonly example: Option.Option<string>;
+    readonly branch: string;
+    readonly path: Option.Option<string>;
+}>;
+export {};
+//# sourceMappingURL=new-project.d.ts.map

package/dist/commands/new-project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"new-project.d.ts","sourceRoot":"","sources":["../../src/commands/new-project.ts"],"names":[],"mappings":"AAEA,OAAO,EAKL,UAAU,EAEV,MAAM,EACN,MAAM,EACP,MAAM,yBAAyB,CAAA;AAChC,OAAO,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAA;;;;;;;;AAa3C,qBAAa,oBAAqB,SAAQ,yBAIxC;CAAG;;;;;;;AAEL,qBAAa,YAAa,SAAQ,iBAGhC;CAAG;;;;;;;AAEL,qBAAa,oBAAqB,SAAQ,yBAGxC;CAAG;AA2JL,eAAO,MAAM,iBAAiB;;;;EAoE7B,CAAA"}

package/dist/commands/new-project.js

@@ -0,0 +1,163 @@
+import * as os from 'node:os';
+import * as nodePath from 'node:path';
+import { Command, Console, Effect, FileSystem, HttpClient, HttpClientRequest, Option, Schema, } from '@livestore/utils/effect';
+import { Cli } from '@livestore/utils/node';
+// Schema for GitHub API response
+const GitHubContentSchema = Schema.Struct({
+    name: Schema.String,
+    type: Schema.Literal('dir', 'file'),
+    path: Schema.String,
+    download_url: Schema.NullOr(Schema.String),
+});
+const GitHubContentsResponseSchema = Schema.Array(GitHubContentSchema);
+// Error types
+export class ExampleNotFoundError extends Schema.TaggedError()('ExampleNotFoundError', {
+    exampleName: Schema.String,
+    availableExamples: Schema.Array(Schema.String),
+    message: Schema.String,
+}) {
+}
+export class NetworkError extends Schema.TaggedError()('NetworkError', {
+    cause: Schema.Unknown,
+    message: Schema.String,
+}) {
+}
+export class DirectoryExistsError extends Schema.TaggedError()('DirectoryExistsError', {
+    path: Schema.String,
+    message: Schema.String,
+}) {
+}
+// Fetch available examples from GitHub
+const fetchExamples = (branch) => Effect.gen(function* () {
+    const url = `https://api.github.com/repos/livestorejs/livestore/contents/examples?ref=${branch}`;
+    yield* Effect.log(`Fetching examples from branch: ${branch}`);
+    const request = HttpClientRequest.get(url);
+    const response = yield* HttpClient.execute(request).pipe(Effect.scoped, Effect.catchAll((error) => new NetworkError({
+        cause: error,
+        message: `Failed to fetch examples from GitHub: ${error}`,
+    })));
+    const responseText = yield* response.text;
+    const examples = yield* Schema.decodeUnknown(GitHubContentsResponseSchema)(JSON.parse(responseText)).pipe(Effect.catchAll((error) => new NetworkError({
+        cause: error,
+        message: `Failed to parse GitHub API response: ${error}`,
+    })));
+    const exampleNames = examples
+        .filter((item) => item.type === 'dir')
+        .map((item) => item.name)
+        .sort();
+    yield* Effect.log(`Found ${exampleNames.length} examples: ${exampleNames.join(', ')}`);
+    return exampleNames;
+});
+// Interactive example selection
+const selectExample = (examples) => Effect.gen(function* () {
+    if (examples.length === 0) {
+        return yield* Effect.fail(new Error('No examples available'));
+    }
+    const prompt = Cli.Prompt.select({
+        message: '📦 Select a LiveStore example to create:',
+        choices: examples.map((example) => ({
+            title: example,
+            value: example,
+            description: `Create a new project using the ${example} example`,
+        })),
+    });
+    return yield* Cli.Prompt.run(prompt);
+});
+// Download and extract example using tiged approach
+const downloadExample = (exampleName, branch, destinationPath) => Effect.gen(function* () {
+    yield* Console.log(`📥 Downloading example "${exampleName}" from branch "${branch}"...`);
+    const tempDir = yield* Effect.sync(() => os.tmpdir());
+    const tarballPath = nodePath.join(tempDir, `livestore-${branch}-${Date.now()}.tar.gz`);
+    const tarballUrl = `https://api.github.com/repos/livestorejs/livestore/tarball/${branch}`;
+    // Download tarball directly
+    const request = HttpClientRequest.get(tarballUrl);
+    const response = yield* HttpClient.execute(request).pipe(Effect.scoped, Effect.catchAll((error) => new NetworkError({
+        cause: error,
+        message: `Failed to download tarball: ${error}`,
+    })));
+    const fs = yield* FileSystem.FileSystem;
+    // Write tarball to temp file
+    const tarballBuffer = yield* response.arrayBuffer;
+    yield* fs.writeFile(tarballPath, new Uint8Array(tarballBuffer));
+    // Create destination directory
+    yield* fs.makeDirectory(destinationPath, { recursive: true });
+    // Extract the tarball to a temporary directory first
+    const extractDir = nodePath.join(tempDir, `extract-${Date.now()}`);
+    yield* fs.makeDirectory(extractDir, { recursive: true });
+    // Extract tarball using Effect Command
+    yield* Command.make('tar', '-xzf', tarballPath, '-C', extractDir).pipe(Command.exitCode, Effect.catchAll((error) => new NetworkError({
+        cause: error,
+        message: `Failed to extract tarball: ${error}`,
+    })));
+    // Find the extracted directory (it will be named like livestorejs-livestore-{hash})
+    const extractedDirs = yield* fs.readDirectory(extractDir);
+    if (extractedDirs.length === 0) {
+        return yield* new NetworkError({
+            cause: 'No extracted directory found',
+            message: 'Failed to find extracted repository directory',
+        });
+    }
+    const repoDir = nodePath.join(extractDir, extractedDirs[0]);
+    const exampleSourcePath = nodePath.join(repoDir, 'examples', exampleName);
+    // Check if the example exists
+    const exampleExists = yield* fs.exists(exampleSourcePath);
+    if (!exampleExists) {
+        return yield* new ExampleNotFoundError({
+            exampleName,
+            availableExamples: [],
+            message: `Example "${exampleName}" not found in the extracted repository`,
+        });
+    }
+    // Copy the example directory contents to the destination using Effect Command
+    yield* Command.make('cp', '-r', `${exampleSourcePath}/.`, destinationPath).pipe(Command.exitCode, Effect.catchAll((error) => new NetworkError({
+        cause: error,
+        message: `Failed to copy example files: ${error}`,
+    })));
+    // Clean up extract directory
+    yield* fs.remove(extractDir, { recursive: true }).pipe(Effect.catchAll(() => Effect.void));
+    // Clean up tarball
+    yield* fs.remove(tarballPath).pipe(Effect.catchAll(() => Effect.void));
+    yield* Console.log(`✅ Example "${exampleName}" created successfully at: ${destinationPath}`);
+});
+export const newProjectCommand = Cli.Command.make('new-project', {
+    example: Cli.Options.text('example').pipe(Cli.Options.optional, Cli.Options.withDescription('Example name to create (bypasses interactive selection)')),
+    branch: Cli.Options.text('branch').pipe(Cli.Options.withDefault('dev'), Cli.Options.withDescription('Branch to fetch examples from')),
+    path: Cli.Args.text({ name: 'path' }).pipe(Cli.Args.optional, Cli.Args.withDescription('Destination path for the new project')),
+}, Effect.fn(function* ({ example, branch, path, }) {
+    yield* Effect.log('🚀 Creating new LiveStore project...');
+    // Fetch available examples
+    const examples = yield* fetchExamples(branch);
+    if (examples.length === 0) {
+        yield* Console.log('❌ No examples found in the repository');
+        return yield* new ExampleNotFoundError({
+            exampleName: '',
+            availableExamples: [],
+            message: 'No examples available',
+        });
+    }
+    // Select example (from CLI option or interactive prompt)
+    const selectedExample = Option.isSome(example) ? example.value : yield* selectExample(examples);
+    // Validate selected example exists
+    if (!examples.includes(selectedExample)) {
+        yield* Console.log(`❌ Example "${selectedExample}" not found`);
+        yield* Console.log(`Available examples: ${examples.join(', ')}`);
+        return yield* new ExampleNotFoundError({
+            exampleName: selectedExample,
+            availableExamples: examples,
+            message: `Example "${selectedExample}" not found`,
+        });
+    }
+    // Determine destination path
+    const destinationPath = Option.isSome(path) ? nodePath.resolve(path.value) : nodePath.resolve(selectedExample);
+    // Download and extract the example
+    yield* downloadExample(selectedExample, branch, destinationPath);
+    // Success message
+    yield* Console.log('\n🎉 Project created successfully!');
+    yield* Console.log(`📁 Location: ${destinationPath}`);
+    yield* Console.log('\n📋 Next steps:');
+    yield* Console.log(`   cd ${nodePath.basename(destinationPath)}`);
+    yield* Console.log('   pnpm install    # Install dependencies');
+    yield* Console.log('   pnpm dev        # Start development server');
+    yield* Console.log('\n💡 Tip: Run `git init` if you want to initialize version control');
+}));
+//# sourceMappingURL=new-project.js.map

package/dist/commands/new-project.js.map

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

package/dist/mcp-content/architecture.d.ts

@@ -0,0 +1,2 @@
+export declare const architectureContent = "# LiveStore Architecture: Local-First Data Management\n\nLiveStore implements distributed systems principles from Martin Kleppmann's research on local-first software, ensuring data consistency, availability, and partition tolerance in collaborative applications.\n\n## Core Architectural Principles\n\n### 1. Local-First Data Storage\n- **Immediate Response**: All operations execute against local SQLite database first\n- **Offline Capability**: Full application functionality without network connectivity\n- **Data Ownership**: Users maintain complete control over their data\n- **Performance**: Sub-millisecond query responses from local storage\n\n### 2. Event Sourcing & CRDT-Inspired Conflict Resolution\n- **Immutable Event Log**: All changes recorded as immutable events\n- **Deterministic Replay**: State reconstruction from event sequence\n- **Conflict-Free Operations**: Events designed for commutative application\n- **Causal Ordering**: Lamport timestamps ensure causally consistent ordering\n\n### 3. Eventually Consistent Synchronization\n- **Asynchronous Replication**: Events sync when network available\n- **Convergence Guarantee**: All replicas converge to same state\n- **Conflict Resolution**: Last-write-wins with semantic merging strategies\n- **Incremental Sync**: Only transmit events since last synchronization\n\n## System Components\n\n### \uD83D\uDDC4\uFE0F State Layer (SQLite + Materializers)\n```typescript\n// Materialized views from event log\nconst materializers = State.SQLite.materializers(events, {\n  'TodoCreated': ({ id, text, createdAt }) => \n    tables.todos.insert({ id, text, completed: false, createdAt }),\n  'TodoCompleted': ({ id }) => \n    tables.todos.update({ completed: true }).where({ id })\n})\n```\n\n**Responsibilities:**\n- Maintain denormalized query-optimized state\n- Apply events to update materialized views\n- Support efficient reactive queries\n- Handle schema migrations\n\n### \uD83D\uDCDD Event System (Append-Only Log)\n```typescript\nconst events = {\n  todoCompleted: Events.synced({\n    name: 'v1.TodoCompleted',\n    schema: Schema.Struct({ \n      id: Schema.String,\n      completedAt: Schema.Date // For conflict resolution\n    })\n  })\n}\n```\n\n**Characteristics:**\n- Immutable event log (append-only)\n- Cryptographically signed events for integrity\n- Causal dependencies tracked via vector clocks\n- Schema versioning for backward compatibility\n\n### \uD83D\uDD04 Synchronization Engine\n```typescript\n// Conflict resolution during sync\nconst mergeResult = SyncState.merge({\n  syncState: currentState,\n  payload: incomingEvents,\n  isEqualEvent: (a, b) => a.id === b.id && a.type === b.type\n})\n```\n\n**Merge Strategies:**\n- **Advance**: New events extend current state\n- **Rebase**: Rollback conflicting events, apply remote, replay local\n- **Reject**: Ignore events that violate invariants\n\n### \uD83C\uDF10 Network Layer & Adapters\n```typescript\n// Platform-specific sync adapters\nexport const WebAdapter = {\n  storage: OPFSSQLiteStorage, // Origin Private File System\n  transport: WebSocketSync,\n  worker: SharedWorker        // Cross-tab synchronization\n}\n```\n\n**Adapter Implementations:**\n- **Web**: OPFS storage, SharedWorker coordination, WebSocket sync\n- **Node**: File system storage, cluster coordination, HTTP/WebSocket\n- **Mobile**: Native SQLite, background sync, push notifications\n\n## Distributed Systems Properties\n\n### CAP Theorem Considerations\n- **Consistency**: Eventually consistent (not strongly consistent)\n- **Availability**: Always available for reads/writes (local-first)\n- **Partition Tolerance**: Continues operation during network partitions\n\n*Trade-off: Chooses Availability + Partition Tolerance over strong Consistency*\n\n### ACID Properties (Local Transactions)\n- **Atomicity**: Event application is atomic within SQLite transaction\n- **Consistency**: Materializers maintain data integrity constraints\n- **Isolation**: Concurrent operations isolated via SQLite WAL mode\n- **Durability**: Events persisted to disk before acknowledgment\n\n### Conflict Resolution Strategies\n\n1. **Semantic Conflict Resolution**\n   - Application-specific merge logic\n   - E.g., text editing uses operational transforms\n\n2. **Last-Write-Wins (LWW)**\n   - Timestamps determine winner\n   - Simple but can lose data\n\n3. **Multi-Value Registers**\n   - Preserve all conflicting values\n   - User or application resolves\n\n4. **Commutative Operations**\n   - Operations designed to commute\n   - E.g., increment/decrement counters\n\n## Performance & Scalability\n\n### Query Performance\n- **Reactive Queries**: Automatically update UI on data changes\n- **Indexed Access**: SQLite B-tree indexes for fast lookups\n- **Prepared Statements**: Query compilation cached for reuse\n- **Batch Operations**: Multiple events applied in single transaction\n\n### Memory Management\n- **Incremental Loading**: Large datasets loaded on-demand\n- **Query Result Caching**: Expensive query results cached\n- **Event Log Compaction**: Periodic snapshotting and log truncation\n- **Connection Pooling**: Database connections reused across operations\n\n### Network Optimization\n- **Delta Synchronization**: Only sync events since last checkpoint\n- **Compression**: Event payloads compressed for network transfer\n- **Batching**: Multiple events transmitted in single round-trip\n- **Exponential Backoff**: Retry failed sync with increasing delays\n\n## Security Model\n\n### Data Integrity\n- **Event Signatures**: Cryptographic signatures prevent tampering\n- **Merkle Trees**: Efficient verification of event log integrity\n- **Schema Validation**: All events validated against defined schemas\n\n### Access Control\n- **Client-Side Authorization**: Fine-grained permissions in local database\n- **Sync Filtering**: Server filters events based on user permissions\n- **Encryption**: End-to-end encryption for sensitive data\n\n## Observability\n\n### Distributed Tracing\n- **Event Causality**: Trace event propagation across replicas\n- **Sync Performance**: Monitor replication lag and throughput\n- **Conflict Metrics**: Track merge conflicts and resolution strategies\n\n### Health Monitoring\n- **Storage Usage**: Local database size and growth rate\n- **Network Health**: Connection quality and sync success rates\n- **Error Tracking**: Failed operations and their root causes\n\nThis architecture enables applications that work seamlessly offline, sync reliably when online, and provide immediate feedback to users while maintaining data consistency across all replicas.";
+//# sourceMappingURL=architecture.d.ts.map

package/dist/mcp-content/architecture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"architecture.d.ts","sourceRoot":"","sources":["../../src/mcp-content/architecture.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,29MAyKgK,CAAA"}

package/dist/mcp-content/architecture.js

@@ -0,0 +1,171 @@
+export const architectureContent = `# LiveStore Architecture: Local-First Data Management
+
+LiveStore implements distributed systems principles from Martin Kleppmann's research on local-first software, ensuring data consistency, availability, and partition tolerance in collaborative applications.
+
+## Core Architectural Principles
+
+### 1. Local-First Data Storage
+- **Immediate Response**: All operations execute against local SQLite database first
+- **Offline Capability**: Full application functionality without network connectivity
+- **Data Ownership**: Users maintain complete control over their data
+- **Performance**: Sub-millisecond query responses from local storage
+
+### 2. Event Sourcing & CRDT-Inspired Conflict Resolution
+- **Immutable Event Log**: All changes recorded as immutable events
+- **Deterministic Replay**: State reconstruction from event sequence
+- **Conflict-Free Operations**: Events designed for commutative application
+- **Causal Ordering**: Lamport timestamps ensure causally consistent ordering
+
+### 3. Eventually Consistent Synchronization
+- **Asynchronous Replication**: Events sync when network available
+- **Convergence Guarantee**: All replicas converge to same state
+- **Conflict Resolution**: Last-write-wins with semantic merging strategies
+- **Incremental Sync**: Only transmit events since last synchronization
+
+## System Components
+
+### 🗄️ State Layer (SQLite + Materializers)
+\`\`\`typescript
+// Materialized views from event log
+const materializers = State.SQLite.materializers(events, {
+  'TodoCreated': ({ id, text, createdAt }) => 
+    tables.todos.insert({ id, text, completed: false, createdAt }),
+  'TodoCompleted': ({ id }) => 
+    tables.todos.update({ completed: true }).where({ id })
+})
+\`\`\`
+
+**Responsibilities:**
+- Maintain denormalized query-optimized state
+- Apply events to update materialized views
+- Support efficient reactive queries
+- Handle schema migrations
+
+### 📝 Event System (Append-Only Log)
+\`\`\`typescript
+const events = {
+  todoCompleted: Events.synced({
+    name: 'v1.TodoCompleted',
+    schema: Schema.Struct({ 
+      id: Schema.String,
+      completedAt: Schema.Date // For conflict resolution
+    })
+  })
+}
+\`\`\`
+
+**Characteristics:**
+- Immutable event log (append-only)
+- Cryptographically signed events for integrity
+- Causal dependencies tracked via vector clocks
+- Schema versioning for backward compatibility
+
+### 🔄 Synchronization Engine
+\`\`\`typescript
+// Conflict resolution during sync
+const mergeResult = SyncState.merge({
+  syncState: currentState,
+  payload: incomingEvents,
+  isEqualEvent: (a, b) => a.id === b.id && a.type === b.type
+})
+\`\`\`
+
+**Merge Strategies:**
+- **Advance**: New events extend current state
+- **Rebase**: Rollback conflicting events, apply remote, replay local
+- **Reject**: Ignore events that violate invariants
+
+### 🌐 Network Layer & Adapters
+\`\`\`typescript
+// Platform-specific sync adapters
+export const WebAdapter = {
+  storage: OPFSSQLiteStorage, // Origin Private File System
+  transport: WebSocketSync,
+  worker: SharedWorker        // Cross-tab synchronization
+}
+\`\`\`
+
+**Adapter Implementations:**
+- **Web**: OPFS storage, SharedWorker coordination, WebSocket sync
+- **Node**: File system storage, cluster coordination, HTTP/WebSocket
+- **Mobile**: Native SQLite, background sync, push notifications
+
+## Distributed Systems Properties
+
+### CAP Theorem Considerations
+- **Consistency**: Eventually consistent (not strongly consistent)
+- **Availability**: Always available for reads/writes (local-first)
+- **Partition Tolerance**: Continues operation during network partitions
+
+*Trade-off: Chooses Availability + Partition Tolerance over strong Consistency*
+
+### ACID Properties (Local Transactions)
+- **Atomicity**: Event application is atomic within SQLite transaction
+- **Consistency**: Materializers maintain data integrity constraints
+- **Isolation**: Concurrent operations isolated via SQLite WAL mode
+- **Durability**: Events persisted to disk before acknowledgment
+
+### Conflict Resolution Strategies
+
+1. **Semantic Conflict Resolution**
+   - Application-specific merge logic
+   - E.g., text editing uses operational transforms
+
+2. **Last-Write-Wins (LWW)**
+   - Timestamps determine winner
+   - Simple but can lose data
+
+3. **Multi-Value Registers**
+   - Preserve all conflicting values
+   - User or application resolves
+
+4. **Commutative Operations**
+   - Operations designed to commute
+   - E.g., increment/decrement counters
+
+## Performance & Scalability
+
+### Query Performance
+- **Reactive Queries**: Automatically update UI on data changes
+- **Indexed Access**: SQLite B-tree indexes for fast lookups
+- **Prepared Statements**: Query compilation cached for reuse
+- **Batch Operations**: Multiple events applied in single transaction
+
+### Memory Management
+- **Incremental Loading**: Large datasets loaded on-demand
+- **Query Result Caching**: Expensive query results cached
+- **Event Log Compaction**: Periodic snapshotting and log truncation
+- **Connection Pooling**: Database connections reused across operations
+
+### Network Optimization
+- **Delta Synchronization**: Only sync events since last checkpoint
+- **Compression**: Event payloads compressed for network transfer
+- **Batching**: Multiple events transmitted in single round-trip
+- **Exponential Backoff**: Retry failed sync with increasing delays
+
+## Security Model
+
+### Data Integrity
+- **Event Signatures**: Cryptographic signatures prevent tampering
+- **Merkle Trees**: Efficient verification of event log integrity
+- **Schema Validation**: All events validated against defined schemas
+
+### Access Control
+- **Client-Side Authorization**: Fine-grained permissions in local database
+- **Sync Filtering**: Server filters events based on user permissions
+- **Encryption**: End-to-end encryption for sensitive data
+
+## Observability
+
+### Distributed Tracing
+- **Event Causality**: Trace event propagation across replicas
+- **Sync Performance**: Monitor replication lag and throughput
+- **Conflict Metrics**: Track merge conflicts and resolution strategies
+
+### Health Monitoring
+- **Storage Usage**: Local database size and growth rate
+- **Network Health**: Connection quality and sync success rates
+- **Error Tracking**: Failed operations and their root causes
+
+This architecture enables applications that work seamlessly offline, sync reliably when online, and provide immediate feedback to users while maintaining data consistency across all replicas.`;
+//# sourceMappingURL=architecture.js.map

package/dist/mcp-content/architecture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"architecture.js","sourceRoot":"","sources":["../../src/mcp-content/architecture.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gMAyK6J,CAAA"}

package/dist/mcp-content/features.d.ts

@@ -0,0 +1,2 @@
+export declare const featuresContent = "# LiveStore Features: Production-Ready Local-First Data\n\nLiveStore provides battle-tested primitives for building collaborative, offline-capable applications with the reliability and performance of modern distributed systems.\n\n## \uD83C\uDFE0 Local-First Architecture\n\n### Offline-First Operation\n- **Zero Latency**: All operations execute against local SQLite database\n- **Offline Capable**: Full application functionality without network connectivity\n- **Network Resilient**: Graceful degradation during connectivity issues\n- **Background Sync**: Automatic synchronization when network becomes available\n\n### Immediate Consistency\n- **Optimistic Updates**: UI updates immediately on user action\n- **Rollback on Conflict**: Automatic rollback and retry on merge conflicts\n- **Causal Consistency**: Operations maintain causal ordering across replicas\n\n## \uD83D\uDD04 Event-Driven Synchronization\n\n### Conflict-Free Event Model\n```typescript\n// Events designed for conflict-free merging\nconst events = {\n  todoCreated: Events.synced({\n    name: 'v1.TodoCreated',\n    schema: Schema.Struct({\n      id: Schema.String,      // Deterministic ordering\n      createdAt: Schema.Date, // Timestamp for LWW resolution\n      position: Schema.Number // Fractional indexing for reordering\n    })\n  })\n}\n```\n\n### Sophisticated Merge Strategies\n- **Last-Write-Wins**: Timestamp-based conflict resolution\n- **Semantic Merging**: Application-specific merge logic\n- **Operational Transform**: Real-time collaborative text editing\n- **CRDT Integration**: Conflict-free replicated data types\n\n### Incremental Synchronization\n- **Delta Sync**: Only transmit changes since last synchronization\n- **Vector Clocks**: Efficient causal dependency tracking\n- **Merkle Trees**: Efficient integrity verification\n- **Batch Optimization**: Multiple events in single network round-trip\n\n## \uD83D\uDCCA Reactive Query Engine\n\n### Real-Time Reactivity\n```typescript\n// Queries automatically update when underlying data changes\nconst activeTodos$ = queryDb(\n  tables.todos\n    .select()\n    .where({ completed: false, deletedAt: null })\n    .orderBy('position'),\n  { label: 'activeTodos' }\n)\n```\n\n### Advanced Query Capabilities\n- **Joins & Aggregations**: Full SQL expressiveness\n- **Reactive Subscriptions**: Automatic UI updates on data changes\n- **Query Optimization**: SQLite query planner with B-tree indexes\n- **Prepared Statements**: Cached query compilation for performance\n\n### Framework Integrations\n- **React**: `useLiveQuery()` hook for reactive components\n- **Vue**: Composables for reactive data binding\n- **Solid**: Reactive primitives integration\n- **Svelte**: Store-based reactive updates\n\n## \uD83D\uDD10 End-to-End Type Safety\n\n### Schema-First Development\n```typescript\n// Type safety from database to UI\nconst todoSchema = State.SQLite.table({\n  name: 'todos',\n  columns: {\n    id: State.SQLite.text({ primaryKey: true }),\n    title: State.SQLite.text(),\n    completed: State.SQLite.boolean()\n  }\n})\n\n// Fully typed queries\ntype Todo = typeof todoSchema.select.Type // { id: string, title: string, completed: boolean }\n```\n\n### Runtime Validation\n- **Schema Validation**: All events validated against Effect schemas\n- **Migration Safety**: Type-safe schema evolution\n- **Parse Don't Validate**: Schema types flow through entire application\n\n## \uD83C\uDF10 Multi-Platform Support\n\n### Web Platform\n- **Origin Private File System**: Persistent storage in modern browsers\n- **SharedWorker**: Cross-tab synchronization and resource sharing\n- **IndexedDB Fallback**: Compatibility with older browsers\n- **Service Worker**: Background synchronization\n\n### Node.js Platform\n- **File System Storage**: Native SQLite database files\n- **Cluster Coordination**: Multi-process synchronization\n- **HTTP/WebSocket Sync**: Flexible transport protocols\n- **Background Jobs**: Scheduled synchronization tasks\n\n### Mobile Platforms (Expo/React Native)\n- **Native SQLite**: Platform-optimized database performance\n- **Background Sync**: Synchronization during app backgrounding\n- **Push Notifications**: Real-time update notifications\n- **Secure Storage**: Encrypted local data storage\n\n## \uD83D\uDE80 Performance & Scalability\n\n### Query Performance\n- **Sub-millisecond Queries**: Local SQLite performance\n- **Efficient Indexing**: Automatic index recommendations\n- **Result Set Streaming**: Large datasets loaded incrementally\n- **Query Result Caching**: Expensive computations cached\n\n### Memory Management\n- **Lazy Loading**: Data loaded on-demand\n- **Connection Pooling**: Database connections efficiently reused\n- **Event Log Compaction**: Periodic snapshots prevent unbounded growth\n- **Garbage Collection**: Automatic cleanup of obsolete data\n\n### Network Optimization\n- **Compression**: Event payloads compressed for transmission\n- **Request Batching**: Multiple operations in single request\n- **Connection Pooling**: HTTP/WebSocket connections reused\n- **Exponential Backoff**: Intelligent retry strategies\n\n## \uD83C\uDFD7\uFE0F Developer Experience\n\n### Testing & Debugging\n```typescript\n// Built-in testing utilities\nconst testStore = createTestStore(schema)\n\n// Deterministic event replay for testing\nawait testStore.replay([\n  events.todoCreated({ id: '1', title: 'Test todo' }),\n  events.todoCompleted({ id: '1' })\n])\n```\n\n### Developer Tools\n- **Event Inspector**: Real-time event log visualization\n- **Query Profiler**: Performance analysis for slow queries  \n- **Sync Monitor**: Network synchronization health dashboard\n- **Schema Explorer**: Interactive database schema browsing\n\n### Production Monitoring\n- **Distributed Tracing**: Event propagation across replicas\n- **Performance Metrics**: Query latency and throughput monitoring\n- **Error Tracking**: Comprehensive error reporting and alerting\n- **Health Checks**: Automated system health verification\n\n## \uD83D\uDD12 Security & Privacy\n\n### Data Protection\n- **End-to-End Encryption**: Client-side encryption before transmission\n- **Event Signatures**: Cryptographic integrity verification\n- **Access Control**: Fine-grained permission system\n- **Audit Logging**: Comprehensive security event logging\n\n### Privacy by Design\n- **Local Data Control**: Users maintain complete data ownership\n- **Selective Sync**: Fine-grained control over data sharing\n- **Data Minimization**: Only sync necessary data\n- **GDPR Compliance**: Built-in privacy compliance features\n\nLiveStore combines the reliability of traditional databases with the performance and user experience of local-first applications, enabling you to build applications that users love while maintaining the technical rigor of distributed systems.";
+//# sourceMappingURL=features.d.ts.map

package/dist/mcp-content/features.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"features.d.ts","sourceRoot":"","sources":["../../src/mcp-content/features.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe,grNA+KuN,CAAA"}