baselineos 0.2.0-beta.1

package/LICENSE

@@ -0,0 +1,17 @@
+Apache License
+Version 2.0, January 2004
+http://www.apache.org/licenses/
+
+Copyright 2026 Baseline Protocol Foundation
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/README.md

@@ -0,0 +1,198 @@
+# baselineos
+
+Agentic Governance Engine — autonomous AI task execution with built-in governance, audit trails, and evidence bundles.
+
+**Status:** `0.2.0-beta.1`
+**License:** Apache-2.0
+
+---
+
+## Install
+
+```bash
+npm install baselineos
+```
+
+Or use directly:
+
+```bash
+npx baselineos --version
+```
+
+---
+
+## Interfaces
+
+BaselineOS provides three interfaces for different use cases:
+
+| Interface | Use Case | Entry Point |
+|-----------|----------|-------------|
+| **CLI** | Developer workflow, CI/CD | `baseline init / run / serve` |
+| **SDK** | Programmatic integration | `import { Baseline } from 'baselineos'` |
+| **API** | External system integration | REST + WebSocket on port 3141 |
+
+---
+
+## CLI Quickstart
+
+### 1. Initialize a project
+
+```bash
+npx baselineos init
+```
+
+This creates a `baseline.config.ts` in your project root with sensible defaults.
+
+### 2. Index your knowledge base
+
+```bash
+npx baselineos index
+```
+
+Indexes markdown, code, and config files from paths defined in your config.
+
+### 3. Run a governed task
+
+```bash
+npx baselineos run "Implement OAuth flow with acceptance criteria"
+```
+
+The orchestrator decomposes, executes, verifies, and reviews autonomously — producing an audit trail and evidence bundle for every task.
+
+### 4. Start the server
+
+```bash
+npx baselineos serve
+```
+
+Starts the REST API (port 3141), WebSocket stream, and MCP server.
+
+---
+
+## MCP Setup (Claude Desktop)
+
+Add to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "baselineos": {
+      "command": "npx",
+      "args": ["baselineos", "mcp"]
+    }
+  }
+}
+```
+
+**Config file location:**
+- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
+- Linux: `~/.config/Claude/claude_desktop_config.json`
+
+Restart Claude Desktop. BaselineOS tools appear in the tool picker — 16 tools across task execution, knowledge retrieval, memory, and governance.
+
+---
+
+## SDK Quickstart
+
+```typescript
+import { Baseline } from 'baselineos';
+
+const baseline = new Baseline({
+  projectRoot: process.cwd(),
+  knowledge: ['./docs', './specs'],
+});
+
+await baseline.init();
+
+// Run a governed task
+const task = await baseline.run({
+  title: 'Implement OAuth',
+  description: 'Add OAuth 2.0 authentication flow',
+});
+
+// Memory
+await baseline.remember({ key: 'preference', value: { theme: 'dark' }, scope: 'long-term' });
+const recalled = await baseline.recall({ key: 'preference', scope: 'all' });
+
+// Knowledge retrieval
+const results = await baseline.search('authentication patterns');
+const context = await baseline.getContext('oauth');
+
+// Evidence
+const evidence = await baseline.getEvidenceBundle(task.id);
+const audit = await baseline.getAuditTrail(task.id);
+```
+
+---
+
+## API Quickstart
+
+```bash
+# Create a task
+curl -X POST http://localhost:3141/api/tasks \
+  -H "Content-Type: application/json" \
+  -d '{"title":"Implement feature","description":"Add OAuth 2.0 flow"}'
+
+# List tasks
+curl http://localhost:3141/api/tasks
+
+# Get system stats
+curl http://localhost:3141/api/stats
+
+# Search knowledge
+curl -X POST http://localhost:3141/api/search \
+  -H "Content-Type: application/json" \
+  -d '{"query":"authentication","limit":10}'
+```
+
+Full API documentation: [OpenAPI Spec](../../specs/api/openapi.yaml)
+
+---
+
+## Package Exports
+
+```typescript
+import { Baseline } from 'baselineos';                    // Main engine
+import { Orchestrator } from 'baselineos/orchestrator';    // Task orchestration
+import { MemorySystem } from 'baselineos/memory';          // Multi-scope memory
+import { SemanticCache } from 'baselineos/cache';          // Semantic caching
+import { KnowledgeIndexer } from 'baselineos/indexer';     // Knowledge indexing
+import { MCPServer } from 'baselineos/mcp';                // MCP server
+import { AnthropicEngine } from 'baselineos/engine';       // Execution engine
+import { RAGEngine } from 'baselineos/rag';                // RAG retrieval
+```
+
+---
+
+## Governance
+
+Every task execution produces:
+
+- **Audit trail** — append-only log of all operations
+- **Evidence bundle** — exportable governance artifact (who approved, what policies governed, what happened)
+- **Risk assessment** — complexity/impact analysis with mitigation tracking
+- **Compliance checks** — standard-based validation (ISO 27001, NDPC, AfCFTA)
+
+Governance is structural, not advisory. Policies are enforced at execution time.
+
+---
+
+## Configuration
+
+`baseline.config.ts` controls orchestrator behavior, LLM settings, caching, agents, and governance rules. See `templates/baseline.config.ts` for the full reference.
+
+Key options:
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `orchestrator.maxAutonomousComplexity` | `'complex'` | Tasks above this require human approval |
+| `orchestrator.selfVerificationRequired` | `true` | Agent verifies own work before proceeding |
+| `orchestrator.supervisorReviewThreshold` | `0.7` | Review if confidence below 70% |
+| `governance.auditLevel` | `'basic'` | `none` / `basic` / `full` |
+
+---
+
+## License
+
+Apache-2.0 — Baseline Protocol Contributors

package/dist/__evals__/runner.d.ts

@@ -0,0 +1,2 @@
+
+export {  }