gitx.do 0.1.0 → 0.1.2

package/README.md

@@ -1,36 +1,8 @@
 # gitx.do
 
-**Git for Cloudflare Workers.** Full protocol. Edge-native. 5,600+ tests.
+Git on Cloudflare Durable Objects - A complete git reimplementation for the edge.
 
-[![npm version](https://img.shields.io/npm/v/gitx.do.svg)](https://www.npmjs.com/package/gitx.do)
-[![Tests](https://img.shields.io/badge/tests-5%2C684%20passing-brightgreen.svg)](https://github.com/dot-do/gitx)
-[![TypeScript](https://img.shields.io/badge/TypeScript-5.0-blue.svg)](https://www.typescriptlang.org/)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-
-## Why gitx?
-
-**AI agents need version control.** They generate code, iterate on files, need to track changes and roll back mistakes.
-
-**gitx is Git reimplemented for Cloudflare Workers.** Full protocol support - pack files, delta compression, smart HTTP. Not a wrapper around git CLI. A complete implementation.
-
-**Scales to millions of agents.** Each agent gets its own git repository on Cloudflare's edge network. No shared servers. No rate limits. Just fast, isolated version control at global scale.
-
-```typescript
-import git from 'gitx.do'
-
-// Initialize a repo
-await git.init('/my-project')
-
-// Stage and commit
-await git.add('/my-project', '.')
-await git.commit('/my-project', 'Initial commit')
-
-// Branch and merge
-await git.branch('/my-project', 'feature')
-await git.checkout('/my-project', 'feature')
-// ... make changes ...
-await git.merge('/my-project', 'feature')
-```
+This package provides Cloudflare Workers/Durable Objects integration for git. It depends on [@dotdo/gitx](../core) for the pure git implementation.
 
 ## Installation
 
@@ -38,346 +10,61 @@ await git.merge('/my-project', 'feature')
 npm install gitx.do
 ```
 
-## Quick Start
-
-```typescript
-import git from 'gitx.do'
-
-// Create a repository
-await git.init('/repo')
-
-// Write files and commit
-await git.add('/repo', 'README.md')
-await git.commit('/repo', 'Add readme')
-
-// View history
-const log = await git.log('/repo')
-console.log(log.commits)
-
-// Create branches
-await git.branch('/repo', 'feature/auth')
-await git.checkout('/repo', 'feature/auth')
-
-// View changes
-const diff = await git.diff('/repo', 'main', 'feature/auth')
-const status = await git.status('/repo')
-```
-
 ## Features
 
-### Full Git Protocol
-
-Complete implementation of Git internals:
-
-```typescript
-// Object model
-await git.hashObject('/repo', content, 'blob')
-await git.catFile('/repo', sha, 'blob')
-
-// Trees and commits
-const tree = await git.writeTree('/repo')
-const commit = await git.commitTree('/repo', tree, 'message', [parent])
-
-// Pack files
-await git.pack('/repo', objects)
-await git.unpack('/repo', packData)
-
-// References
-await git.updateRef('/repo', 'refs/heads/main', sha)
-const ref = await git.resolveRef('/repo', 'HEAD')
-```
-
-### Tiered Storage
-
-Hot objects in SQLite. Pack files in R2. You don't think about it.
-
-```
-┌────────────────────────────────────────────────────────┐
-│   Hot Tier (SQLite)           │   Warm Tier (R2)       │
-├───────────────────────────────┼────────────────────────┤
-│   • Recent commits            │   • Pack files         │
-│   • Active branches           │   • Full history       │
-│   • Loose objects             │   • Large blobs        │
-│   • <10ms access              │   • <100ms access      │
-└───────────────────────────────┴────────────────────────┘
-```
-
-### Pack File Engine
-
-Full packfile v2/v3 support:
-
-```typescript
-// Delta compression
-await git.repack('/repo', { deltify: true })
-
-// Verify integrity
-await git.fsck('/repo')
-
-// Garbage collection
-await git.gc('/repo')
-```
-
-- OFS_DELTA and REF_DELTA compression
-- Multi-pack indexes (MIDX)
-- CRC32 verification
-- Thin pack support for network transfer
-
-### Wire Protocol
-
-Smart HTTP protocol for git clients:
-
-```typescript
-// Serve git fetch/push
-app.all('/repo.git/*', (req) => git.serve(req))
-
-// Clone works
-// git clone https://your-worker.dev/repo.git
-```
-
-- Capability negotiation
-- Side-band progress reporting
-- Multi-ack for efficiency
-- Shallow clone support
-
-### Merge & Diff
-
-Full three-way merge with conflict detection:
-
-```typescript
-// Merge branches
-const result = await git.merge('/repo', 'feature')
-if (result.conflicts) {
-  console.log('Conflicts:', result.conflicts)
-}
-
-// View diff
-const diff = await git.diff('/repo', 'main', 'feature')
-for (const file of diff.files) {
-  console.log(file.path, file.additions, file.deletions)
-}
-```
-
-### CLI Commands
-
-Full command-line interface:
-
-```typescript
-import { cli } from 'gitx.do/cli'
-
-await cli('init /repo')
-await cli('add /repo .')
-await cli('commit /repo -m "message"')
-await cli('log /repo --oneline')
-await cli('branch /repo feature')
-await cli('checkout /repo feature')
-await cli('merge /repo main')
-await cli('status /repo')
-await cli('diff /repo')
-```
-
-### MCP Tools
-
-Model Context Protocol for AI agents:
-
-```typescript
-import { gitTools, invokeTool } from 'gitx.do/mcp'
-
-// Available tools
-// git_init, git_add, git_commit, git_log, git_diff, git_status,
-// git_branch, git_checkout, git_merge, git_show, git_blame
-
-await invokeTool('git_commit', {
-  repo: '/my-project',
-  message: 'Fix authentication bug'
-})
-
-await invokeTool('git_log', {
-  repo: '/my-project',
-  limit: 10
-})
-```
-
-## Durable Object Integration
-
-### As a Standalone DO
-
-```typescript
-import { GitDO } from 'gitx.do/do'
-
-export { GitDO }
-
-export default {
-  async fetch(request, env) {
-    const id = env.GIT.idFromName('repo-123')
-    const stub = env.GIT.get(id)
-    return stub.fetch(request)
-  }
-}
-```
+- **Durable Object Integration** - GitRepoDO for full repository management
+- **R2 Storage** - Packfile storage with tiered hot/warm/cold system
+- **MCP Integration** - Model Context Protocol for AI assistant integration
+- **Wire Protocol** - Git Smart HTTP protocol handlers
+- **Mixins** - withGit, withFs for adding git capabilities to any DO
 
-### With dotdo Framework
+## Usage
 
 ```typescript
-import { DO } from 'dotdo'
-import { withGit } from 'gitx.do/do'
+import { GitRepoDO, GitModule, withGit } from 'gitx.do'
 
-class MyAgent extends withGit(DO) {
-  async work() {
-    await this.$.git.add('.', 'src/')
-    await this.$.git.commit('.', 'Update source files')
+// Export GitRepoDO for full repository management
+export { GitRepoDO }
 
-    const log = await this.$.git.log('.')
-    return log.commits[0]
+// Or use mixins for custom DOs
+class MyDO extends withGit(DurableObject) {
+  async doSomething() {
+    await this.git.clone('https://github.com/org/repo')
+    const status = await this.git.status()
+    console.log(status)
   }
 }
 ```
 
-### As RPC Service
+## Architecture
 
-```toml
-# wrangler.toml
-[[services]]
-binding = "GITX"
-service = "gitx-worker"
 ```
-
-```typescript
-await env.GITX.commit('/repo', 'message')
+gitx.do
+├── do/           # Durable Object implementations
+│   ├── GitRepoDO     # Full git repository DO
+│   ├── GitModule     # Git capability module
+│   ├── FsModule      # Filesystem capability
+│   ├── withGit       # Git mixin
+│   └── withFs        # Fs mixin
+├── storage/      # Storage implementations
+│   ├── r2-pack       # R2 packfile storage
+│   ├── tiered        # Hot/warm/cold tiering
+│   └── object-index  # Object location tracking
+├── wire/         # Git wire protocol
+│   ├── smart-http    # HTTP handlers
+│   ├── pkt-line      # Packet line format
+│   └── capabilities  # Protocol capabilities
+└── mcp/          # MCP integration
+    ├── tools         # MCP tool definitions
+    └── adapter       # Protocol adapter
 ```
 
-## API Reference
-
-### Repository Operations
-
-| Method | Description |
-|--------|-------------|
-| `init(path)` | Initialize new repository |
-| `clone(url, path)` | Clone remote repository |
-| `status(path)` | Get working tree status |
-| `log(path, options?)` | View commit history |
-
-### Staging & Commits
-
-| Method | Description |
-|--------|-------------|
-| `add(path, files)` | Stage files |
-| `commit(path, message)` | Create commit |
-| `reset(path, ref)` | Reset to commit |
-
-### Branches & Merging
-
-| Method | Description |
-|--------|-------------|
-| `branch(path, name)` | Create branch |
-| `checkout(path, ref)` | Switch branches |
-| `merge(path, branch)` | Merge branch |
-| `rebase(path, onto)` | Rebase branch |
-
-### Diff & Blame
-
-| Method | Description |
-|--------|-------------|
-| `diff(path, a, b)` | Compare commits |
-| `blame(path, file)` | Line-by-line history |
-| `show(path, ref)` | Show commit details |
-
-### Low-Level
-
-| Method | Description |
-|--------|-------------|
-| `hashObject(path, data, type)` | Create object |
-| `catFile(path, sha, type)` | Read object |
-| `updateRef(path, ref, sha)` | Update reference |
-| `pack(path, objects)` | Create packfile |
+## Related
 
-## How It Works
-
-```
-┌─────────────────────────────────────────────────────────┐
-│                      gitx.do                            │
-├─────────────────────────────────────────────────────────┤
-│  Git Commands (add, commit, branch, merge, etc.)        │
-├─────────────────────────────────────────────────────────┤
-│  Object Model (blob, tree, commit, tag)                 │
-├─────────────────────────────────────────────────────────┤
-│  Pack Engine (delta, compression, indexes)              │
-├────────────────────┬────────────────────────────────────┤
-│   Hot Tier         │         Warm Tier                  │
-│   (SQLite)         │         (R2)                       │
-│                    │                                    │
-│   • Loose objects  │   • Pack files                     │
-│   • References     │   • Large blobs                    │
-│   • Index          │   • Archive                        │
-└────────────────────┴────────────────────────────────────┘
-```
-
-## Comparison
-
-| Feature | GitHub | GitLab | gitx.do |
-|---------|--------|--------|---------|
-| **Pricing** | $21/user/month | $29/user/month | Self-hosted |
-| **Storage** | 1GB free | 5GB free | R2 (cheap) |
-| **LFS bandwidth** | $0.0875/GB | Metered | R2 (no egress) |
-| **Full protocol** | Yes | Yes | Yes |
-| **Edge-native** | No | No | Yes |
-| **AI-native API** | No | No | Yes |
-| **Self-hosted** | Enterprise only | Complex | One-click |
-
-## Use Cases
-
-### AI Agent Version Control
-
-Each AI agent gets its own repository:
-
-```typescript
-class CodeAgent extends withGit(DO) {
-  async generateCode(spec) {
-    const code = await this.ai.generate(spec)
-
-    await this.$.fs.writeFile('src/index.ts', code)
-    await this.$.git.add('.', 'src/')
-    await this.$.git.commit('.', `Implement: ${spec}`)
-
-    return this.$.git.log('.', { limit: 1 })
-  }
-}
-```
-
-### Private Git Hosting
-
-Your repositories on your infrastructure:
-
-```typescript
-export default GitX({
-  name: 'my-repos',
-  domain: 'git.mycompany.com',
-})
-```
-
-### LFS Without Bandwidth Fees
-
-R2 has no egress charges:
-
-```typescript
-await git.lfsTrack('/repo', '*.psd')
-await git.lfsPush('/repo')
-```
-
-## Performance
-
-- **5,684 tests** covering all operations
-- **Full Git protocol** - clone, fetch, push all work
-- **<10ms** for hot tier operations
-- **Global edge** - 300+ Cloudflare locations
-- **Zero cold starts** - Durable Objects
+- [@dotdo/gitx](../core) - Pure git implementation (zero CF deps)
+- [fsx.do](https://fsx.do) - Filesystem for Workers
+- [bashx.do](https://bashx.do) - Shell execution for Workers
 
 ## License
 
 MIT
-
-## Links
-
-- [GitHub](https://github.com/dot-do/gitx)
-- [Documentation](https://gitx.do)
-- [.do](https://do.org.ai)
-- [Platform.do](https://platform.do)

package/dist/do/logger.d.ts

@@ -0,0 +1,50 @@
+/**
+ * @fileoverview Logging infrastructure for GitRepoDO.
+ *
+ * Provides structured logging with configurable levels and output.
+ *
+ * @module do/logger
+ */
+import { Logger, LogLevel, LogEntry } from './types';
+/**
+ * Options for creating a logger.
+ */
+export interface LoggerOptions {
+    /** Minimum log level to output */
+    minLevel?: LogLevel;
+    /** DO namespace for context */
+    ns?: string;
+    /** DO type for context */
+    $type?: string;
+    /** Custom log handler */
+    handler?: (entry: LogEntry) => void;
+}
+/**
+ * Create a logger instance.
+ *
+ * @param options - Logger configuration options
+ * @returns Logger instance
+ *
+ * @example
+ * ```typescript
+ * const logger = createLogger({ minLevel: LogLevel.INFO, ns: 'my-repo' })
+ * logger.info('Repository initialized', { branch: 'main' })
+ * ```
+ */
+export declare function createLogger(options?: LoggerOptions): Logger;
+/**
+ * Create a child logger with additional context.
+ *
+ * @param parent - Parent logger
+ * @param context - Additional context to include in all log entries
+ * @returns Child logger instance
+ */
+export declare function createChildLogger(parent: Logger, context: Record<string, unknown>): Logger;
+/**
+ * No-op logger that discards all messages.
+ * Useful for testing or when logging is disabled.
+ */
+export declare const noopLogger: Logger;
+export type { Logger, LogEntry };
+export { LogLevel };
+//# sourceMappingURL=logger.d.ts.map

package/dist/do/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/do/logger.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAMpD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,kCAAkC;IAClC,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,+BAA+B;IAC/B,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,0BAA0B;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,yBAAyB;IACzB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAA;CACpC;AAqCD;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,aAAkB,GAAG,MAAM,CAmDhE;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,MAAM,CAkBR;AAED;;;GAGG;AACH,eAAO,MAAM,UAAU,EAAE,MAKxB,CAAA;AAGD,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAA;AAChC,OAAO,EAAE,QAAQ,EAAE,CAAA"}

package/dist/do/logger.js

@@ -0,0 +1,122 @@
+/**
+ * @fileoverview Logging infrastructure for GitRepoDO.
+ *
+ * Provides structured logging with configurable levels and output.
+ *
+ * @module do/logger
+ */
+import { LogLevel } from './types';
+/**
+ * Default log handler that outputs to console.
+ */
+function defaultLogHandler(entry) {
+    const timestamp = new Date(entry.timestamp).toISOString();
+    const contextStr = entry.context
+        ? ` ${JSON.stringify(entry.context)}`
+        : '';
+    switch (entry.level) {
+        case LogLevel.DEBUG:
+            console.debug(`[${timestamp}] DEBUG: ${entry.message}${contextStr}`);
+            break;
+        case LogLevel.INFO:
+            console.info(`[${timestamp}] INFO: ${entry.message}${contextStr}`);
+            break;
+        case LogLevel.WARN:
+            console.warn(`[${timestamp}] WARN: ${entry.message}${contextStr}`);
+            break;
+        case LogLevel.ERROR:
+            console.error(`[${timestamp}] ERROR: ${entry.message}${contextStr}`);
+            break;
+    }
+}
+/**
+ * Log level priority for comparison.
+ */
+const LOG_LEVEL_PRIORITY = {
+    [LogLevel.DEBUG]: 0,
+    [LogLevel.INFO]: 1,
+    [LogLevel.WARN]: 2,
+    [LogLevel.ERROR]: 3,
+};
+/**
+ * Create a logger instance.
+ *
+ * @param options - Logger configuration options
+ * @returns Logger instance
+ *
+ * @example
+ * ```typescript
+ * const logger = createLogger({ minLevel: LogLevel.INFO, ns: 'my-repo' })
+ * logger.info('Repository initialized', { branch: 'main' })
+ * ```
+ */
+export function createLogger(options = {}) {
+    const { minLevel = LogLevel.INFO, ns, $type, handler = defaultLogHandler, } = options;
+    const baseContext = {
+        ...(ns && { ns }),
+        ...($type && { $type }),
+    };
+    function shouldLog(level) {
+        return LOG_LEVEL_PRIORITY[level] >= LOG_LEVEL_PRIORITY[minLevel];
+    }
+    function log(level, message, context) {
+        if (!shouldLog(level))
+            return;
+        const entry = {
+            level,
+            message,
+            timestamp: Date.now(),
+            context: context ? { ...baseContext, ...context } : baseContext,
+        };
+        handler(entry);
+    }
+    return {
+        debug(message, context) {
+            log(LogLevel.DEBUG, message, context);
+        },
+        info(message, context) {
+            log(LogLevel.INFO, message, context);
+        },
+        warn(message, context) {
+            log(LogLevel.WARN, message, context);
+        },
+        error(message, context) {
+            log(LogLevel.ERROR, message, context);
+        },
+    };
+}
+/**
+ * Create a child logger with additional context.
+ *
+ * @param parent - Parent logger
+ * @param context - Additional context to include in all log entries
+ * @returns Child logger instance
+ */
+export function createChildLogger(parent, context) {
+    return {
+        debug(message, childContext) {
+            parent.debug(message, { ...context, ...childContext });
+        },
+        info(message, childContext) {
+            parent.info(message, { ...context, ...childContext });
+        },
+        warn(message, childContext) {
+            parent.warn(message, { ...context, ...childContext });
+        },
+        error(message, childContext) {
+            parent.error(message, { ...context, ...childContext });
+        },
+    };
+}
+/**
+ * No-op logger that discards all messages.
+ * Useful for testing or when logging is disabled.
+ */
+export const noopLogger = {
+    debug: () => { },
+    info: () => { },
+    warn: () => { },
+    error: () => { },
+};
+export { LogLevel };
+//# sourceMappingURL=logger.js.map

package/dist/do/logger.js.map

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

package/dist/{durable-object → do}/schema.d.ts

@@ -16,11 +16,11 @@
  * - `git_content`: Staged file content for commits
  * - `exec`: Execution safety settings and policies for BashModule
  *
- * @module durable-object/schema
+ * @module do/schema
  *
  * @example
  * ```typescript
- * import { SchemaManager, DurableObjectStorage } from './durable-object/schema'
+ * import { SchemaManager, DurableObjectStorage } from './do/schema'
  *
  * // Initialize schema on first access
  * const schemaManager = new SchemaManager(storage)
@@ -122,7 +122,7 @@ export declare const SCHEMA_VERSION = 1;
  * - `idx_git_content_repo_path`: Fast staged file lookup
  * - `idx_exec_name`: Fast lookup by policy name
  */
-export declare const SCHEMA_SQL = "\n-- Git objects (blobs, trees, commits, tags)\nCREATE TABLE IF NOT EXISTS objects (sha TEXT PRIMARY KEY, type TEXT NOT NULL, size INTEGER NOT NULL, data BLOB NOT NULL, created_at INTEGER);\n\n-- Object location index for tiered storage\n-- Tracks object locations across storage tiers (hot/r2/parquet)\n-- pack_id and offset are used for R2 and Parquet tiers where objects are stored in packfiles\nCREATE TABLE IF NOT EXISTS object_index (sha TEXT PRIMARY KEY, tier TEXT NOT NULL DEFAULT 'hot', pack_id TEXT, offset INTEGER, size INTEGER, type TEXT, updated_at INTEGER);\n\n-- Hot objects cache\nCREATE TABLE IF NOT EXISTS hot_objects (sha TEXT PRIMARY KEY, type TEXT NOT NULL, data BLOB NOT NULL, accessed_at INTEGER, created_at INTEGER);\n\n-- Write-ahead log\nCREATE TABLE IF NOT EXISTS wal (id INTEGER PRIMARY KEY AUTOINCREMENT, operation TEXT NOT NULL, payload BLOB NOT NULL, created_at INTEGER, flushed INTEGER DEFAULT 0);\n\n-- Refs table\nCREATE TABLE IF NOT EXISTS refs (name TEXT PRIMARY KEY, target TEXT NOT NULL, type TEXT DEFAULT 'sha', updated_at INTEGER);\n\n-- Git repository bindings for GitModule integration\n-- Stores repository configuration and sync state\nCREATE TABLE IF NOT EXISTS git (\n  id INTEGER PRIMARY KEY AUTOINCREMENT,\n  repo TEXT NOT NULL UNIQUE,\n  path TEXT,\n  branch TEXT NOT NULL DEFAULT 'main',\n  commit TEXT,\n  last_sync INTEGER,\n  object_prefix TEXT DEFAULT 'git/objects',\n  created_at INTEGER,\n  updated_at INTEGER\n);\n\n-- Git branches table for tracking branch state per repository\n-- Each repository can have multiple branches tracked\nCREATE TABLE IF NOT EXISTS git_branches (\n  id INTEGER PRIMARY KEY AUTOINCREMENT,\n  repo_id INTEGER NOT NULL REFERENCES git(id) ON DELETE CASCADE,\n  name TEXT NOT NULL,\n  head TEXT,\n  upstream TEXT,\n  tracking INTEGER DEFAULT 0,\n  ahead INTEGER DEFAULT 0,\n  behind INTEGER DEFAULT 0,\n  created_at INTEGER,\n  updated_at INTEGER,\n  UNIQUE(repo_id, name)\n);\n\n-- Git content table for staged files awaiting commit\n-- Stores file references using integer rowid foreign key for efficient lookups\n-- file_id references the shared files table for unified filesystem integration\nCREATE TABLE IF NOT EXISTS git_content (\n  id INTEGER PRIMARY KEY AUTOINCREMENT,\n  repo_id INTEGER NOT NULL REFERENCES git(id) ON DELETE CASCADE,\n  file_id INTEGER REFERENCES files(id) ON DELETE SET NULL,\n  path TEXT NOT NULL,\n  content BLOB,\n  mode TEXT DEFAULT '100644',\n  status TEXT NOT NULL DEFAULT 'staged',\n  sha TEXT,\n  created_at INTEGER,\n  updated_at INTEGER,\n  UNIQUE(repo_id, path)\n);\n\n-- Exec table for BashModule execution safety settings and policies\n-- Stores blocked commands, confirmation requirements, and execution policies\nCREATE TABLE IF NOT EXISTS exec (\n  id INTEGER PRIMARY KEY AUTOINCREMENT,\n  name TEXT NOT NULL UNIQUE,\n  blocked_commands TEXT,\n  require_confirmation INTEGER DEFAULT 1,\n  default_timeout INTEGER DEFAULT 30000,\n  default_cwd TEXT DEFAULT '/',\n  allowed_patterns TEXT,\n  denied_patterns TEXT,\n  max_concurrent INTEGER DEFAULT 5,\n  enabled INTEGER DEFAULT 1,\n  created_at INTEGER,\n  updated_at INTEGER\n);\n\n-- Indexes\nCREATE INDEX IF NOT EXISTS idx_objects_type ON objects(type);\nCREATE INDEX IF NOT EXISTS idx_wal_flushed ON wal(flushed);\nCREATE INDEX IF NOT EXISTS idx_hot_objects_accessed ON hot_objects(accessed_at);\nCREATE INDEX IF NOT EXISTS idx_object_index_tier ON object_index(tier);\nCREATE INDEX IF NOT EXISTS idx_object_index_pack_id ON object_index(pack_id);\nCREATE INDEX IF NOT EXISTS idx_git_branches_repo ON git_branches(repo_id);\nCREATE INDEX IF NOT EXISTS idx_git_content_repo_path ON git_content(repo_id, path);\nCREATE INDEX IF NOT EXISTS idx_git_content_status ON git_content(status);\nCREATE INDEX IF NOT EXISTS idx_git_content_file_id ON git_content(file_id);\nCREATE INDEX IF NOT EXISTS idx_exec_name ON exec(name);\nCREATE INDEX IF NOT EXISTS idx_exec_enabled ON exec(enabled);\n";
+export declare const SCHEMA_SQL = "\n-- Git objects (blobs, trees, commits, tags)\nCREATE TABLE IF NOT EXISTS objects (sha TEXT PRIMARY KEY, type TEXT NOT NULL, size INTEGER NOT NULL, data BLOB NOT NULL, created_at INTEGER);\n\n-- Object location index for tiered storage\n-- Tracks object locations across storage tiers (hot/r2/parquet)\n-- pack_id and offset are used for R2 and Parquet tiers where objects are stored in packfiles\n-- chunked and chunk_count are used for large blobs (>=2MB) stored in 2MB chunks for DO SQLite cost optimization\nCREATE TABLE IF NOT EXISTS object_index (sha TEXT PRIMARY KEY, tier TEXT NOT NULL DEFAULT 'hot', pack_id TEXT, offset INTEGER, size INTEGER, type TEXT, updated_at INTEGER, chunked INTEGER DEFAULT 0, chunk_count INTEGER DEFAULT 0);\n\n-- Hot objects cache\nCREATE TABLE IF NOT EXISTS hot_objects (sha TEXT PRIMARY KEY, type TEXT NOT NULL, data BLOB NOT NULL, accessed_at INTEGER, created_at INTEGER);\n\n-- Write-ahead log\nCREATE TABLE IF NOT EXISTS wal (id INTEGER PRIMARY KEY AUTOINCREMENT, operation TEXT NOT NULL, payload BLOB NOT NULL, created_at INTEGER, flushed INTEGER DEFAULT 0);\n\n-- Refs table\nCREATE TABLE IF NOT EXISTS refs (name TEXT PRIMARY KEY, target TEXT NOT NULL, type TEXT DEFAULT 'sha', updated_at INTEGER);\n\n-- Git repository bindings for GitModule integration\n-- Stores repository configuration and sync state\nCREATE TABLE IF NOT EXISTS git (\n  id INTEGER PRIMARY KEY AUTOINCREMENT,\n  repo TEXT NOT NULL UNIQUE,\n  path TEXT,\n  branch TEXT NOT NULL DEFAULT 'main',\n  commit TEXT,\n  last_sync INTEGER,\n  object_prefix TEXT DEFAULT 'git/objects',\n  created_at INTEGER,\n  updated_at INTEGER\n);\n\n-- Git branches table for tracking branch state per repository\n-- Each repository can have multiple branches tracked\nCREATE TABLE IF NOT EXISTS git_branches (\n  id INTEGER PRIMARY KEY AUTOINCREMENT,\n  repo_id INTEGER NOT NULL REFERENCES git(id) ON DELETE CASCADE,\n  name TEXT NOT NULL,\n  head TEXT,\n  upstream TEXT,\n  tracking INTEGER DEFAULT 0,\n  ahead INTEGER DEFAULT 0,\n  behind INTEGER DEFAULT 0,\n  created_at INTEGER,\n  updated_at INTEGER,\n  UNIQUE(repo_id, name)\n);\n\n-- Git content table for staged files awaiting commit\n-- Stores file references using integer rowid foreign key for efficient lookups\n-- file_id references the shared files table for unified filesystem integration\nCREATE TABLE IF NOT EXISTS git_content (\n  id INTEGER PRIMARY KEY AUTOINCREMENT,\n  repo_id INTEGER NOT NULL REFERENCES git(id) ON DELETE CASCADE,\n  file_id INTEGER REFERENCES files(id) ON DELETE SET NULL,\n  path TEXT NOT NULL,\n  content BLOB,\n  mode TEXT DEFAULT '100644',\n  status TEXT NOT NULL DEFAULT 'staged',\n  sha TEXT,\n  created_at INTEGER,\n  updated_at INTEGER,\n  UNIQUE(repo_id, path)\n);\n\n-- Exec table for BashModule execution safety settings and policies\n-- Stores blocked commands, confirmation requirements, and execution policies\nCREATE TABLE IF NOT EXISTS exec (\n  id INTEGER PRIMARY KEY AUTOINCREMENT,\n  name TEXT NOT NULL UNIQUE,\n  blocked_commands TEXT,\n  require_confirmation INTEGER DEFAULT 1,\n  default_timeout INTEGER DEFAULT 30000,\n  default_cwd TEXT DEFAULT '/',\n  allowed_patterns TEXT,\n  denied_patterns TEXT,\n  max_concurrent INTEGER DEFAULT 5,\n  enabled INTEGER DEFAULT 1,\n  created_at INTEGER,\n  updated_at INTEGER\n);\n\n-- Indexes\nCREATE INDEX IF NOT EXISTS idx_objects_type ON objects(type);\nCREATE INDEX IF NOT EXISTS idx_wal_flushed ON wal(flushed);\nCREATE INDEX IF NOT EXISTS idx_hot_objects_accessed ON hot_objects(accessed_at);\nCREATE INDEX IF NOT EXISTS idx_object_index_tier ON object_index(tier);\nCREATE INDEX IF NOT EXISTS idx_object_index_pack_id ON object_index(pack_id);\nCREATE INDEX IF NOT EXISTS idx_git_branches_repo ON git_branches(repo_id);\nCREATE INDEX IF NOT EXISTS idx_git_content_repo_path ON git_content(repo_id, path);\nCREATE INDEX IF NOT EXISTS idx_git_content_status ON git_content(status);\nCREATE INDEX IF NOT EXISTS idx_git_content_file_id ON git_content(file_id);\nCREATE INDEX IF NOT EXISTS idx_exec_name ON exec(name);\nCREATE INDEX IF NOT EXISTS idx_exec_enabled ON exec(enabled);\n";
 /**
  * Manager for database schema initialization and validation.
  *

package/dist/do/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/do/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAMH;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;OAKG;IACH,GAAG,EAAE;QACH;;;;;;;;;;;;;;;WAeG;QACH,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG;YAAE,OAAO,IAAI,OAAO,EAAE,CAAA;SAAE,CAAA;KACpE,CAAA;CACF;AAMD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,cAAc,IAAI,CAAA;AAE/B;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,UAAU,0iIA+FtB,CAAA;AAeD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,qBAAa,aAAa;IAMZ,OAAO,CAAC,OAAO;IAL3B;;;;OAIG;gBACiB,OAAO,EAAE,oBAAoB;IAEjD;;;;;;;;;;;OAWG;IACG,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAIvC;;;;;;;;;;;;;;OAcG;IACG,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC;IAKzC;;;;;;;;;;;;;;;;;;OAkBG;IACG,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;CASzC"}

package/dist/{durable-object → do}/schema.js

@@ -16,11 +16,11 @@
  * - `git_content`: Staged file content for commits
  * - `exec`: Execution safety settings and policies for BashModule
  *
- * @module durable-object/schema
+ * @module do/schema
  *
  * @example
  * ```typescript
- * import { SchemaManager, DurableObjectStorage } from './durable-object/schema'
+ * import { SchemaManager, DurableObjectStorage } from './do/schema'
  *
  * // Initialize schema on first access
  * const schemaManager = new SchemaManager(storage)
@@ -84,7 +84,8 @@ CREATE TABLE IF NOT EXISTS objects (sha TEXT PRIMARY KEY, type TEXT NOT NULL, si
 -- Object location index for tiered storage
 -- Tracks object locations across storage tiers (hot/r2/parquet)
 -- pack_id and offset are used for R2 and Parquet tiers where objects are stored in packfiles
-CREATE TABLE IF NOT EXISTS object_index (sha TEXT PRIMARY KEY, tier TEXT NOT NULL DEFAULT 'hot', pack_id TEXT, offset INTEGER, size INTEGER, type TEXT, updated_at INTEGER);
+-- chunked and chunk_count are used for large blobs (>=2MB) stored in 2MB chunks for DO SQLite cost optimization
+CREATE TABLE IF NOT EXISTS object_index (sha TEXT PRIMARY KEY, tier TEXT NOT NULL DEFAULT 'hot', pack_id TEXT, offset INTEGER, size INTEGER, type TEXT, updated_at INTEGER, chunked INTEGER DEFAULT 0, chunk_count INTEGER DEFAULT 0);
 
 -- Hot objects cache
 CREATE TABLE IF NOT EXISTS hot_objects (sha TEXT PRIMARY KEY, type TEXT NOT NULL, data BLOB NOT NULL, accessed_at INTEGER, created_at INTEGER);

package/dist/do/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/do/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAqDH,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAA;AAE/B;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+FzB,CAAA;AAED;;;;;;GAMG;AACH,MAAM,eAAe,GAAG,CAAC,SAAS,EAAE,cAAc,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,CAAC,CAAA;AAE/H,+EAA+E;AAC/E,sBAAsB;AACtB,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,OAAO,aAAa;IAMJ;IALpB;;;;OAIG;IACH,YAAoB,OAA6B;QAA7B,YAAO,GAAP,OAAO,CAAsB;IAAG,CAAC;IAErD;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,gBAAgB;QACpB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;IACnC,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,KAAK,CAAC,gBAAgB;QACpB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,EAAE,CAAA;QAC3C,OAAO,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAA;IACrC,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,KAAK,CAAC,cAAc;QAClB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAClC,mDAAmD,CACpD,CAAA;QACD,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,EAAwB,CAAA;QACrD,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;QAE1C,OAAO,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAA;IACnE,CAAC;CACF"}