bonecode 1.0.0 → 1.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 BoneCode Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,71 +1,85 @@
 # BoneCode
 
-**BoneCode** is a production-grade fork of [OpenCode](https://github.com/sst/opencode) — an open-source AI coding agent.
+[![npm version](https://img.shields.io/npm/v/bonecode)](https://www.npmjs.com/package/bonecode)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
 
-The core backend has been redesigned using [BoneScript](../BoneScript%20example/) as the declarative backbone, replacing the original Bun + Hono + SQLite stack with a BoneScript-generated Node.js + PostgreSQL backend featuring:
+**BoneCode** is a production-grade fork of [OpenCode](https://github.com/sst/opencode) — an open-source AI coding agent built on a BoneScript-generated Node.js + PostgreSQL backend with pgvector RAG.
 
-- **Declarative domain models** for all agent/session/RAG entities
-- **State machines** for session and agent lifecycles
-- **Saga flows** with compensation for complex agent workflows
-- **Durable events** with transactional outbox for long-running tasks
-- **Realtime WebSocket channels** with causal ordering for live session updates
-- **Production-grade pgvector RAG** for codebase indexing and long-term agent memory
-- **Full backward compatibility** with existing TUI (Go), Desktop (Electron), and VS Code clients
+## Install
 
-## Quick Start
+```bash
+npm install -g bonecode
+```
+
+Then just run it from any project directory:
 
 ```bash
-# 1. Compile the BoneScript domain models
-cd bone
-npx bonec compile bonecode.bone --target express
+bonecode
+```
+
+## Database modes
+
+BoneCode automatically detects what's available and picks the best option:
+
+| Mode | Setup required | Features |
+|------|---------------|----------|
+| **PostgreSQL** (full) | Docker | Sessions + agents + **pgvector RAG** + hybrid search + durable events |
+| **SQLite** (basic) | Nothing | Sessions + agents only — no RAG, no vector search |
+
+**No Docker?** BoneCode falls back to SQLite automatically. You get a fully working AI coding agent — just without the codebase indexing and RAG features.
 
-# 2. Start dependencies
-cd bone/output
-docker compose up -d
+**Want the full experience?** Install Docker, then run `bonecode` — it starts the Postgres container for you automatically on first run.
 
-# 3. Install and migrate
-npm install
-npm run migrate
+> Install Docker: https://docs.docker.com/get-docker/
 
-# 4. Start the server
-npm run dev
+## Configuration
+
+Copy `.env.example` to `.env` and set your LLM provider:
+
+```bash
+cp .env.example .env
+```
+
+Minimum config for a local model (LM Studio / Ollama):
+
+```env
+DEFAULT_PROVIDER=openai_compatible
+DEFAULT_MODEL=your-model-name
+OPENAI_BASE_URL=http://localhost:1234/v1
+OPENAI_API_KEY=not-needed
+MODEL_SUPPORTS_TOOLS=false
 ```
 
-The server exposes the same HTTP + WebSocket API as OpenCode, so all existing clients work without changes.
+For cloud providers (Anthropic, OpenAI, Google) just set the API key — no base URL needed.
+
+## What's different from OpenCode
+
+- **BoneScript backend** — all domain models (sessions, agents, RAG, workspaces) are declared in `.bone` files and compiled to a full Node.js + Express backend with state machines, saga flows, and durable events
+- **pgvector RAG** — codebase indexing with hybrid search (vector + BM25 full-text + RRF fusion). Works without an embedding model using structural context (git recency, import graph, FTS)
+- **Single command** — `bonecode` starts everything in one process, no separate server terminal needed
+- **SQLite fallback** — works out of the box without Docker for users who just want the agent
 
 ## Architecture
 
 See [ARCHITECTURE.md](./ARCHITECTURE.md) for the full design.
-See [MIGRATION.md](./MIGRATION.md) for the migration guide from OpenCode.
 
-## Folder Structure
+## Folder structure
 
 ```
 BoneCode/
-├── bone/                        # BoneScript source files (the declarative backbone)
-│   ├── bonecode.bone            # Main system definition (imports all modules)
-│   ├── session.bone             # Session, Message, Part, Project entities
-│   ├── agent.bone               # AgentInstance, Task, Plan, BuildStep, ToolCall
-│   ├── rag.bone                 # RAG: KnowledgeBase, CodeFile, CodeChunk (pgvector)
-│   ├── workspace.bone           # Workspace, Codebase, Snapshot entities
-│   └── output/                  # BoneScript compiler output (generated, do not edit)
-│       ├── src/
-│       ├── migrations/
-│       ├── openapi.yaml
-│       └── ...
-├── extensions/                  # Custom TypeScript extension points
-│   ├── llm_provider.ts          # LLM provider integration (Anthropic, OpenAI, etc.)
-│   ├── tool_executor.ts         # Tool execution (bash, read, write, edit, grep)
-│   ├── mcp_bridge.ts            # MCP server bridge
-│   ├── embedding_provider.ts    # Embedding provider (OpenAI, Ollama, Voyage)
-│   ├── chunker.ts               # Code chunking logic
-│   └── snapshot.ts              # Git-based snapshot/revert
-├── compat/                      # Compatibility layer for existing clients
-│   └── opencode_adapter.ts      # Maps OpenCode v2 API → BoneCode API
-├── clients/                     # Unchanged client packages (TUI, Desktop, VS Code)
-│   ├── tui/                     # Go TUI (unchanged)
-│   ├── desktop/                 # Electron desktop (unchanged)
-│   └── vscode/                  # VS Code extension (unchanged)
-├── ARCHITECTURE.md
-└── MIGRATION.md
+├── bone/               # BoneScript domain specs (.bone files)
+│   ├── session.bone    # Session, Message, Part, Project
+│   ├── agent.bone      # AgentInstance, Task, Plan, ToolCall
+│   ├── rag.bone        # KnowledgeBase, CodeFile, CodeChunk (pgvector)
+│   ├── workspace.bone  # Workspace, Codebase, Snapshot
+│   └── output/         # Generated backend (do not edit)
+├── src/
+│   ├── cli.ts          # bonecode CLI entry point
+│   ├── tui.ts          # Interactive terminal UI
+│   ├── server.ts       # Express server (auto Postgres/SQLite)
+│   ├── db_adapter.ts   # Database detection + SQLite shim
+│   └── engine/         # Agent loop, tools, context builder
+├── compat/
+│   └── opencode_adapter.ts  # OpenCode v2 API compatibility layer
+└── extensions/         # Custom extension points (embeddings, chunking, etc.)
 ```

package/bin/bonecode

@@ -1,62 +1,67 @@
 #!/usr/bin/env node
-// BoneCode CLI entry point
-// Resolves and runs the CLI via ts-node (dev) or compiled JS (prod).
+"use strict";
 
 const path = require("path");
 const { spawnSync } = require("child_process");
 const fs = require("fs");
-const os = require("os");
 
-const isWindows = os.platform() === "win32";
-
-// Resolve the package root (two levels up from bin/)
-const scriptPath = fs.realpathSync(__filename);
-const pkgRoot = path.dirname(path.dirname(scriptPath));
+// Resolve package root (one level up from bin/)
+const pkgRoot = path.dirname(path.dirname(fs.realpathSync(__filename)));
 
+// Prefer compiled JS — always built by `npm run build`
 const cliJs = path.join(pkgRoot, "dist", "src", "cli.js");
-const cliTs = path.join(pkgRoot, "src", "cli.ts");
+if (fs.existsSync(cliJs)) {
+  const result = spawnSync(process.execPath, [cliJs, ...process.argv.slice(2)], {
+    stdio: "inherit",
+    cwd: process.cwd(),
+    env: process.env,
+  });
+  process.exit(result.status ?? 0);
+}
 
-function findTsNode() {
-  // Try local node_modules first
-  const local = path.join(pkgRoot, "node_modules", ".bin", isWindows ? "ts-node.cmd" : "ts-node");
-  if (fs.existsSync(local)) return local;
-  // Fall back to global ts-node
-  return isWindows ? "ts-node.cmd" : "ts-node";
+// Dev fallback: try tsx (works without compilation, no .cmd issues)
+const cliTs = path.join(pkgRoot, "src", "cli.ts");
+if (!fs.existsSync(cliTs)) {
+  console.error("BoneCode: CLI entry point not found.");
+  console.error("  Run `npm run build` inside the BoneCode directory first.");
+  process.exit(1);
 }
 
-function run(cmd, args) {
-  const result = spawnSync(cmd, args, {
+// Find tsx in local node_modules
+const tsxLocal = path.join(pkgRoot, "node_modules", ".bin", "tsx");
+const tsxLocalCmd = tsxLocal + (process.platform === "win32" ? ".cmd" : "");
+
+if (fs.existsSync(tsxLocalCmd)) {
+  const result = spawnSync(tsxLocalCmd, [cliTs, ...process.argv.slice(2)], {
     stdio: "inherit",
     cwd: process.cwd(),
     env: process.env,
-    shell: false,
+    shell: process.platform === "win32",
   });
-
-  if (result.error) {
-    // If the command failed (e.g. .cmd not found), try with shell: true
-    const result2 = spawnSync(cmd, args, {
-      stdio: "inherit",
-      cwd: process.cwd(),
-      env: process.env,
-      shell: true,
-    });
-    process.exit(result2.status ?? 0);
-    return;
-  }
-
   process.exit(result.status ?? 0);
 }
 
-if (fs.existsSync(cliJs)) {
-  // Production: use compiled JS
-  run(process.execPath, [cliJs, ...process.argv.slice(2)]);
-} else if (fs.existsSync(cliTs)) {
-  // Development: use ts-node
-  const tsNode = findTsNode();
-  const tsconfig = path.join(pkgRoot, "tsconfig.json");
-  run(tsNode, ["--project", tsconfig, cliTs, ...process.argv.slice(2)]);
-} else {
-  console.error("BoneCode: could not find CLI entry point.");
-  console.error("  Run `npm run build` to compile, or ensure ts-node is installed.");
+// Last resort: npx tsx (downloads on first run)
+console.error("BoneCode: compiled JS not found. Building now...");
+const build = spawnSync(
+  process.platform === "win32" ? "npm.cmd" : "npm",
+  ["run", "build"],
+  { stdio: "inherit", cwd: pkgRoot, shell: process.platform === "win32" }
+);
+if (build.status !== 0) {
+  console.error("Build failed. Run `npm run build` manually in the BoneCode directory.");
   process.exit(1);
 }
+
+// Retry with compiled JS
+if (fs.existsSync(cliJs)) {
+  const result = spawnSync(process.execPath, [cliJs, ...process.argv.slice(2)], {
+    stdio: "inherit",
+    cwd: process.cwd(),
+    env: process.env,
+  });
+  process.exit(result.status ?? 0);
+}
+
+console.error("Build succeeded but CLI not found at:", cliJs);
+process.exit(1);

package/bone/output/agent/.dockerignore

@@ -1,7 +1,7 @@
-node_modules
-dist
-.env
-*.log
-.git
-*.bone
-*.bone.map
+node_modules
+dist
+.env
+*.log
+.git
+*.bone
+*.bone.map

package/bone/output/agent/.env.example

@@ -1,36 +1,36 @@
-# AgentDomain Environment Variables
-# Copy this file to .env and fill in real values. Never commit .env to source control.
-
-# --- Required in production ---
-# Generate with: node -e "console.log(require('crypto').randomBytes(48).toString('hex'))"
-JWT_SECRET=
-
-# --- Database ---
-DATABASE_URL=postgresql://postgres:postgres@localhost:5432/agent_domain
-
-# --- Redis (optional, used by some domain templates) ---
-REDIS_URL=redis://localhost:6379
-
-# --- Server ---
-PORT=3000
-NODE_ENV=development
-
-# --- CORS ---
-# Comma-separated list of allowed origins. Leave empty to disallow all cross-origin requests.
-# Example: ALLOWED_ORIGINS=https://app.example.com,https://admin.example.com
-ALLOWED_ORIGINS=
-
-# --- Event delivery mode ---
-# in_process: in-memory, fast, no durability guarantees (default for development)
-# durable: Postgres-backed transactional outbox (recommended for production)
-EVENT_MODE=in_process
-EVENT_WORKER_INTERVAL_MS=1000
-
-# --- Request timeout ---
-REQUEST_TIMEOUT_MS=30000
-
-# --- Notifications ---
-# NOTIFY_PROVIDER=log|resend|sendgrid (default: log)
-NOTIFY_PROVIDER=log
-NOTIFY_API_KEY=
-NOTIFY_FROM_EMAIL=noreply@example.com
+# AgentDomain Environment Variables
+# Copy this file to .env and fill in real values. Never commit .env to source control.
+
+# --- Required in production ---
+# Generate with: node -e "console.log(require('crypto').randomBytes(48).toString('hex'))"
+JWT_SECRET=
+
+# --- Database ---
+DATABASE_URL=postgresql://postgres:postgres@localhost:5432/agent_domain
+
+# --- Redis (optional, used by some domain templates) ---
+REDIS_URL=redis://localhost:6379
+
+# --- Server ---
+PORT=3000
+NODE_ENV=development
+
+# --- CORS ---
+# Comma-separated list of allowed origins. Leave empty to disallow all cross-origin requests.
+# Example: ALLOWED_ORIGINS=https://app.example.com,https://admin.example.com
+ALLOWED_ORIGINS=
+
+# --- Event delivery mode ---
+# in_process: in-memory, fast, no durability guarantees (default for development)
+# durable: Postgres-backed transactional outbox (recommended for production)
+EVENT_MODE=in_process
+EVENT_WORKER_INTERVAL_MS=1000
+
+# --- Request timeout ---
+REQUEST_TIMEOUT_MS=30000
+
+# --- Notifications ---
+# NOTIFY_PROVIDER=log|resend|sendgrid (default: log)
+NOTIFY_PROVIDER=log
+NOTIFY_API_KEY=
+NOTIFY_FROM_EMAIL=noreply@example.com

package/bone/output/agent/.github/workflows/ci.yaml

@@ -1,58 +1,58 @@
-# Generated by BoneScript compiler.
-name: CI/CD
-
-on:
-  push:
-    branches: [main]
-  pull_request:
-    branches: [main]
-
-jobs:
-  test:
-    runs-on: ubuntu-latest
-    services:
-      postgres:
-        image: postgres:16
-        env:
-          POSTGRES_DB: agent_domain_test
-          POSTGRES_USER: postgres
-          POSTGRES_PASSWORD: postgres
-        ports:
-          - 5432:5432
-        options: --health-cmd pg_isready --health-interval 10s --health-timeout 5s --health-retries 5
-
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: 20
-          cache: npm
-
-      - name: Install dependencies
-        run: npm ci
-
-      - name: Type check
-        run: npx tsc --noEmit
-
-      - name: Run migrations
-        run: npm run migrate
-        env:
-          DATABASE_URL: postgresql://postgres:postgres@localhost:5432/agent_domain_test
-
-      - name: Run tests
-        run: npx ts-node src/tests.ts
-        env:
-          DATABASE_URL: postgresql://postgres:postgres@localhost:5432/agent_domain_test
-          JWT_SECRET: test-secret
-          TEST_BASE_URL: http://localhost:3000
-
-  build:
-    needs: test
-    runs-on: ubuntu-latest
-    if: github.ref == 'refs/heads/main'
-    steps:
-      - uses: actions/checkout@v4
-      - name: Build Docker image
-        run: docker build -t agent-domain:${{ github.sha }} .
-      - name: Tag as latest
-        run: docker tag agent-domain:${{ github.sha }} agent-domain:latest
+# Generated by BoneScript compiler.
+name: CI/CD
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    services:
+      postgres:
+        image: postgres:16
+        env:
+          POSTGRES_DB: agent_domain_test
+          POSTGRES_USER: postgres
+          POSTGRES_PASSWORD: postgres
+        ports:
+          - 5432:5432
+        options: --health-cmd pg_isready --health-interval 10s --health-timeout 5s --health-retries 5
+
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Type check
+        run: npx tsc --noEmit
+
+      - name: Run migrations
+        run: npm run migrate
+        env:
+          DATABASE_URL: postgresql://postgres:postgres@localhost:5432/agent_domain_test
+
+      - name: Run tests
+        run: npx ts-node src/tests.ts
+        env:
+          DATABASE_URL: postgresql://postgres:postgres@localhost:5432/agent_domain_test
+          JWT_SECRET: test-secret
+          TEST_BASE_URL: http://localhost:3000
+
+  build:
+    needs: test
+    runs-on: ubuntu-latest
+    if: github.ref == 'refs/heads/main'
+    steps:
+      - uses: actions/checkout@v4
+      - name: Build Docker image
+        run: docker build -t agent-domain:${{ github.sha }} .
+      - name: Tag as latest
+        run: docker tag agent-domain:${{ github.sha }} agent-domain:latest