@mandible-ai/mandible 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Mandible
+
+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

@@ -0,0 +1,391 @@
+# Mandible
+
+![CI](https://github.com/mandible-ai/mandible/actions/workflows/ci.yml/badge.svg)
+![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)
+![Node](https://img.shields.io/badge/Node-%3E%3D20-brightgreen.svg)
+
+A universal stigmergy framework for autonomous agent coordination.
+
+Instead of wiring agents together with message passing, Mandible agents coordinate by depositing and sensing **signals** in a shared **environment** — the same way ant colonies self-organize through pheromone trails. No orchestrator. No message routing. Complex behavior emerges from simple rules.
+
+[mandible.dev](https://mandible.dev)
+
+## Why stigmergy over message passing?
+
+Most multi-agent frameworks coordinate agents through direct messaging. This reimplements distributed systems problems — service discovery, routing, consensus, backpressure — but for LLMs.
+
+Stigmergy sidesteps all of that. The environment carries the state. Agents are stateless reactive workers. You never need to answer "who should I tell about this?" — you just modify the environment, and whoever cares will notice.
+
+**What you get:**
+
+- **Observability for free** — the environment *is* the log. `ls` the signals directory and see the full system state.
+- **Fault tolerance** — an agent dies, the signal remains, another agent picks it up. No lost messages.
+- **Zero coupling** — add or remove colony types without touching any existing colony's configuration.
+- **Natural load balancing** — spin up more instances of any colony type. They self-organize around available work.
+- **Provenance built in** — every signal is signed by the colony that produced it. Bridges attest transfers. Trust is verifiable.
+
+## Quick start
+
+```bash
+npm install mandible
+```
+
+```typescript
+import { colony, createRuntime, FilesystemEnvironment, withClaudeCode } from 'mandible';
+
+const env = new FilesystemEnvironment({ root: './.mandible/signals' });
+
+const shaper = colony('shaper')
+  .in(env)
+  .sense('task:ready', { unclaimed: true })
+  .do(withClaudeCode({
+    systemPrompt: 'You are a code shaper. Given a task, write the implementation.',
+    allowedTools: ['Read', 'Write', 'Bash'],
+  }))
+  .concurrency(2)
+  .claim('lease', 30_000)
+  .build();
+
+const critic = colony('critic')
+  .in(env)
+  .sense('task:shaped', { unclaimed: true })
+  .do(withClaudeCode({
+    systemPrompt: 'You are a code critic. Review the implementation for correctness and style.',
+    allowedTools: ['Read'],
+  }))
+  .claim('exclusive')
+  .build();
+
+// Start them — they self-organize from here
+const shaperRuntime = createRuntime(shaper);
+const criticRuntime = createRuntime(critic);
+await shaperRuntime.start();
+await criticRuntime.start();
+```
+
+No colony references any other colony. They coordinate entirely through signals in the environment.
+
+### Run with the dashboard
+
+The fastest way to see colonies in action is the CLI:
+
+```bash
+mandible dev examples/repo-maintenance/mandible.config.ts
+```
+
+This starts all colonies and opens the live dashboard at `localhost:4040`. See the [Dashboard](#dashboard) section for details.
+
+A ready-made demo is available:
+
+```bash
+npm run demo:repo-maintenance
+```
+
+## Dashboard
+
+`mandible dev <config>` runs your colonies and opens a live dashboard in the browser.
+
+- Real-time signal flow — watch signals appear, get claimed, and cascade through colonies
+- Colony status cards — running state, concurrency, claim counts, heartbeat health
+- WebSocket streaming — updates push instantly, no polling
+
+```bash
+mandible dev mandible.config.ts              # default: localhost:4040
+mandible dev mandible.config.ts --port 8080  # custom port
+mandible dev mandible.config.ts --no-open    # skip auto-opening browser
+```
+
+*Dashboard GIF coming soon*
+
+## Architecture
+
+![Mandible architecture](docs/mandible-architecture.png)
+
+## Core concepts
+
+Every concept maps to a biological analogy:
+
+| Mandible | Biology | Description |
+|----------|---------|-------------|
+| **Signal** | Pheromone | A typed marker deposited in the environment with a payload, concentration, and TTL. |
+| **Environment** | Substrate | The shared medium agents read from and write to. Filesystem, GitHub, Remote, Dolt. |
+| **Colony** | Ant caste | A group of identical agents with shared sensors, rules, and claim strategy. |
+| **Sensor** | Antennae | How a colony perceives signals. A query pattern like `task:ready` or `review:*`. |
+| **Rule** | Instinct | A stimulus→response mapping: "when I sense X, do Y and deposit Z." |
+| **Concentration** | Pheromone strength | Signal priority (1.0 → 0.0). Agents prioritize stronger signals. |
+| **Decay** | Evaporation | Signals weaken over time, preventing stale work from accumulating. |
+| **Colony Identity** | Colony scent | Ed25519 keypair. Every signal is signed by the colony that produced it. |
+| **Attestation** | Trail markers | Bridges sign transfers, creating a verifiable chain of custody across environments. |
+| **Sentinel** | Guard ant | Monitors an environment for signals that fail provenance verification. |
+
+## The stigmergy loop
+
+Every colony runtime executes the same loop:
+
+```
+sense → match rules → claim → execute action → deposit → (others sense)
+```
+
+1. **Sense** — poll or watch the environment for signals matching the colony's sensor queries.
+2. **Match** — evaluate rules against sensed signals, ordered by priority.
+3. **Claim** — attempt to claim the signal (prevents duplicate work across concurrent agents).
+4. **Act** — execute the matched rule's action (LLM call, shell command, custom function).
+5. **Deposit** — leave new signed signals in the environment as output.
+
+Other colonies sense those deposited signals and the cycle continues. Complex workflows emerge from simple local rules.
+
+## Colony DSL
+
+```typescript
+colony('name')
+  .in(env)                                        // which environment
+  .sense('type:pattern', { unclaimed: true })     // what to watch for
+  .when(signal => signal.payload.priority > 0)    // optional guard
+  .do(withClaudeCode({ allowedTools: ['Read', 'Write'] }))  // action provider
+  .concurrency(3)                                 // max parallel agents
+  .claim('lease', 30_000)                         // claim strategy
+  .poll(2000)                                     // sensor poll interval (ms)
+  .heartbeat(10_000)                              // periodic alive signals
+  .autoWithdraw()                                 // auto-remove processed signals
+  .timeout(60_000)                                // action timeout
+  .retry(3, 1000)                                 // retry with backoff
+  .build();
+```
+
+**Claim strategies:**
+
+| Strategy | Behavior |
+|----------|----------|
+| `exclusive` | Strict claim-before-work. Only one agent processes each signal. |
+| `lease` | Claim with TTL. Auto-releases if the agent dies or times out. |
+| `optimistic` | Let multiple agents start, reconcile after. |
+| `none` | No claiming. Multiple agents may process the same signal. |
+
+## Action providers
+
+Action providers wrap external capabilities into a standard interface for colony rules.
+
+| Provider | Use case | Backed by |
+|----------|----------|-----------|
+| `withClaudeCode` | Coding agents, complex reasoning | Claude Code SDK (live) |
+| `withStructuredOutput` | Classification, review, decisions | Anthropic, OpenAI, Vercel AI SDK |
+| `withBash` | Build commands, test runners, linters | Shell execution |
+
+`withClaudeCode` is fully wired to the Claude Code SDK — colonies spawn real agent sessions that read files, write code, and run commands. It supports **AWS Bedrock routing** via the `bedrock` config option for enterprise deployments.
+
+The provider assembles context by walking signal lineage (`caused_by` chains), giving the agent full awareness of the work pipeline state.
+
+## Signal types
+
+Signal types use a `domain:state` convention and support glob patterns for sensing:
+
+```typescript
+'task:ready'        // exact match
+'task:*'            // any task signal
+'*:ready'           // anything in the ready state
+'review:*'          // any review signal
+```
+
+## Trust and attestation
+
+Mandible provides cryptographic provenance for signals using `@noble/ed25519`:
+
+- **Colony signing** — each colony generates an Ed25519 keypair and signs every signal it deposits. Signatures cover the semantic content (type, payload, lineage) but not mutable state (concentration, timestamps).
+- **Bridge attestation** — when a signal crosses environments via a bridge, the bridge appends a signed attestation. Each attestation signs over the previous, creating a linked chain of custody.
+- **Trust levels** — signals are classified as `verified` (valid signature + chain), `attested` (bridge chain valid, origin unsigned), `unverified` (no provenance), or `rejected` (verification failed).
+- **Sentinel colonies** — monitor an environment for trust violations and deposit report signals that other colonies can react to.
+
+## Environment adapters
+
+Any shared substrate that supports observe/deposit/withdraw/claim/watch can be a Mandible environment.
+
+### Filesystem (implemented)
+
+Signals are JSON files. Claims use atomic file operations. History lives in a `withdrawn/` directory.
+
+```typescript
+import { FilesystemEnvironment } from 'mandible';
+
+const env = new FilesystemEnvironment({
+  root: './.mandible/signals',
+  name: 'local',
+});
+```
+
+### GitHub (implemented)
+
+Issues, pull requests, comments, and labels mapped as signals. Colonies can sense repository activity and deposit responses.
+
+```typescript
+import { GitHubEnvironment } from 'mandible';
+
+const env = new GitHubEnvironment({
+  owner: 'mandible-ai',
+  repo: 'mandible',
+  token: process.env.GITHUB_TOKEN,
+});
+```
+
+### Remote (implemented)
+
+WebSocket-based environment for distributed deployments. Multiple machines share a single signal namespace over the network.
+
+```typescript
+import { RemoteEnvironment } from 'mandible';
+
+const env = new RemoteEnvironment({
+  url: 'ws://coordinator:4041',
+  apiKey: process.env.MANDIBLE_API_KEY,
+  project: 'my-project',
+  name: 'distributed',
+});
+```
+
+### Dolt (stubbed)
+
+[Dolt](https://www.dolthub.com/) is a SQL database with Git-like versioning. Signals become rows, branching enables parallel work, and `dolt_history` provides queryable time travel for the full signal history.
+
+### Writing your own
+
+Implement the `Environment` interface:
+
+```typescript
+interface Environment {
+  name: string;
+  observe(query: SignalQuery): Promise<Signal[]>;
+  deposit(signal): Promise<Signal>;
+  withdraw(signalId: string): Promise<void>;
+  claim(signalId: string, claimant: string, leaseDuration?: number): Promise<boolean>;
+  release(signalId: string): Promise<void>;
+  watch(query: SignalQuery, callback: (signal: Signal) => void): Subscription;
+  history(query: SignalQuery): Promise<Signal[]>;
+  decay(): Promise<DecayResult>;
+  snapshot(): Promise<Signal[]>;
+}
+```
+
+## Patterns
+
+Reusable coordination patterns built on top of the core primitives.
+
+### SignalBridge
+
+Cross-environment signal mirroring with attestation chains. Bridges watch for signals in one environment and mirror them to another, appending a signed attestation to preserve provenance across boundaries.
+
+```typescript
+import { createBridge } from 'mandible';
+
+const bridge = createBridge({
+  name: 'local-to-github',
+  identity: bridgeIdentity,
+  source: localEnv,
+  target: githubEnv,
+  signalTypes: ['fix:proposed'],
+});
+await bridge.start();
+```
+
+### Sentinel
+
+Trust monitoring colony that watches an environment for signals with invalid or missing provenance. When violations are detected, the sentinel deposits `trust:violation` report signals that other colonies can react to.
+
+```typescript
+import { createSentinel } from 'mandible';
+
+const sentinel = createSentinel({
+  name: 'trust-guard',
+  environment: env,
+  policy: { name: 'strict', defaultTrust: 'unverified', minimumTrust: 'verified' },
+});
+await sentinel.start();
+```
+
+## Project structure
+
+```
+src/
+  cli/
+    index.ts            CLI entry point — `mandible dev`
+    server.ts           Dashboard HTTP + WebSocket server
+    dashboard.html      Live dashboard UI
+  cloud/
+    index.ts            Cloud client for hosted observability
+  core/
+    types.ts            Core type system (Signal, Environment, Colony, Trust)
+    signal.ts           Signal creation, matching, decay, priority sorting
+    runtime.ts          Colony runtime — the stigmergy loop engine
+    attestation.ts      Ed25519 signing & verification (@noble/ed25519)
+  dsl/
+    builder.ts          Fluent colony definition DSL
+  environments/
+    filesystem/         Filesystem adapter (JSON files + atomic claims)
+    github/             GitHub adapter (issues, PRs, comments, labels as signals)
+    remote/             Remote adapter (WebSocket-based distributed environments)
+    dolt/               Dolt adapter (stub)
+  providers/
+    claude-code.ts      withClaudeCode — Claude Code SDK (live)
+    structured-output.ts withStructuredOutput — multi-model
+    bash.ts             withBash — shell commands
+    context.ts          Context assembly from signal lineage
+  patterns/
+    bridge.ts           SignalBridge — cross-environment mirroring with attestation
+    sentinel.ts         Sentinel — trust monitoring and violation reporting
+
+tests/
+  core/                 Signal, runtime, attestation tests
+  environments/         Filesystem, GitHub, remote adapter tests
+  providers/            Agent, structured output, bash provider tests
+  colonies/             Integration tests for colony workflows
+
+examples/
+  code-pipeline/        Shaper → Critic → Keeper pipeline demo
+  repo-maintenance/     Scout + Fixer repo maintenance demo
+```
+
+## Examples
+
+### Code pipeline
+
+The included demo seeds 5 coding tasks into a filesystem environment. Three colonies self-organize to process them:
+
+- **Shaper** (concurrency: 2) — picks up `task:ready` signals, produces `task:shaped` signals
+- **Critic** (concurrency: 2) — reviews shaped artifacts, deposits `review:approved` or `review:rejected`
+- **Keeper** (concurrency: 1) — commits approved work, deposits `task:complete`
+
+No orchestrator. No message broker. No routing logic. The colonies discover work through the environment and coordinate through signals.
+
+```bash
+npm run demo
+```
+
+### Repo maintenance
+
+Scout + Fixer colony pair that maintain a repository. Run it against any repo:
+
+- **Scout** — scans the repository for issues, deposits `issue:detected` signals (one per finding, categorized by severity)
+- **Fixer** — claims `issue:detected` signals, applies fixes, deposits `fix:proposed` or `fix:failed`
+
+```bash
+npm run demo:repo-maintenance
+```
+
+Both colonies are wired to real Claude agents via `withClaudeCode`. The dashboard shows signal flow in real time.
+
+## Roadmap
+
+- [x] `mandible dev` CLI + live dashboard
+- [x] `withClaudeCode` wired to Claude Code SDK
+- [x] Test suite (371 tests, 95%+ coverage)
+- [x] GitHub environment adapter
+- [x] Remote environment adapter
+- [ ] `create-mandible` starter template
+- [ ] Dashboard GIF + landing page
+- [ ] Dolt full implementation
+- [ ] CloudEvents bridge adapter
+- [ ] Colony scaler
+- [ ] Trust enforcement
+- [ ] Hosted observability platform
+
+## License
+
+MIT

package/dist/examples/code-pipeline/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env tsx
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/examples/code-pipeline/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../examples/code-pipeline/index.ts"],"names":[],"mappings":""}

package/dist/examples/code-pipeline/index.js

@@ -0,0 +1,239 @@
+#!/usr/bin/env tsx
+// ============================================================
+// Code Pipeline Demo — Stigmergy in Action
+// ============================================================
+// Three colonies coordinate through a shared filesystem:
+//
+//   1. SHAPER — watches for task:ready signals, "writes code",
+//      deposits artifact:shaped signals
+//
+//   2. CRITIC — watches for artifact:shaped signals, "reviews code",
+//      deposits review:approved or review:changes-needed signals
+//
+//   3. KEEPER — watches for review:approved signals,
+//      "merges" the artifact and deposits artifact:merged signals
+//
+// No colony knows about any other colony.
+// They only interact through signals in the environment.
+//
+// To run:
+//   npx tsx examples/code-pipeline/index.ts
+//
+// Then watch the signals/ directory to see stigmergy happen:
+//   watch -n 0.5 'ls -la /tmp/stigmergy-demo/signals/'
+// ============================================================
+import { resolve } from 'node:path';
+import { rm, mkdir } from 'node:fs/promises';
+import { FilesystemEnvironment } from '../../src/environments/filesystem/index.js';
+import { colony } from '../../src/dsl/index.js';
+import { createRuntime } from '../../src/core/runtime.js';
+// ----------------------------------------------------------
+// Environment setup
+// ----------------------------------------------------------
+const ENV_ROOT = resolve('/tmp/stigmergy-demo');
+async function setup() {
+    // Clean slate
+    await rm(ENV_ROOT, { recursive: true, force: true });
+    await mkdir(ENV_ROOT, { recursive: true });
+    console.log(`\n🌿 Environment root: ${ENV_ROOT}`);
+    console.log(`   Watch signals: watch -n 0.5 'ls /tmp/stigmergy-demo/signals/'\n`);
+}
+// ----------------------------------------------------------
+// Simulated work functions (replace with real LLM calls)
+// ----------------------------------------------------------
+async function simulateShaping(task) {
+    const duration = 500 + Math.random() * 1500;
+    await sleep(duration);
+    return {
+        code: `function ${task.name}() { /* shaped by colony */ return true; }`,
+        linesChanged: Math.floor(Math.random() * 100) + 10,
+        task: task.name,
+    };
+}
+async function simulateReview(artifact) {
+    const duration = 300 + Math.random() * 1000;
+    await sleep(duration);
+    // 80% approval rate
+    const approved = Math.random() > 0.2;
+    return {
+        approved,
+        feedback: approved
+            ? `Code for "${artifact.task}" looks good. Clean implementation.`
+            : `Code for "${artifact.task}" needs work: missing error handling.`,
+    };
+}
+async function simulateMerge(artifact) {
+    const duration = 200 + Math.random() * 500;
+    await sleep(duration);
+    return {
+        merged: true,
+        task: artifact.task,
+        commitHash: Math.random().toString(36).slice(2, 10),
+    };
+}
+// ----------------------------------------------------------
+// Colony definitions
+// ----------------------------------------------------------
+function defineColonies(env) {
+    // ── SHAPER COLONY ──────────────────────────────────────
+    const shaperDef = colony('shaper')
+        .in(env)
+        .sense('task:ready', { unclaimed: true, minConcentration: 0.1 })
+        .do('shape-code', async (signal, ctx) => {
+        ctx.log(`Picking up task: ${signal.payload.name}`);
+        const artifact = await simulateShaping(signal.payload);
+        // Deposit the shaped artifact — this is the pheromone trail
+        await ctx.deposit('artifact:shaped', artifact, {
+            causedBy: [signal.id],
+            tags: ['needs-review'],
+        });
+        // Withdraw the task signal — it's been handled
+        await ctx.withdraw(signal.id);
+        ctx.log(`Shaped "${signal.payload.name}" (${artifact.linesChanged} lines)`);
+    })
+        .concurrency(2)
+        .claim('lease', 30_000)
+        .poll(1000)
+        .build();
+    // ── CRITIC COLONY ──────────────────────────────────────
+    const criticDef = colony('critic')
+        .in(env)
+        .sense('artifact:shaped', { unclaimed: true, minConcentration: 0.1 })
+        .do('review-code', async (signal, ctx) => {
+        ctx.log(`Reviewing artifact for task: ${signal.payload.task}`);
+        const review = await simulateReview(signal.payload);
+        if (review.approved) {
+            await ctx.deposit('review:approved', {
+                artifact: signal.payload,
+                feedback: review.feedback,
+            }, {
+                causedBy: [signal.id],
+                tags: ['ready-to-merge'],
+            });
+            ctx.log(`✓ Approved: ${review.feedback}`);
+        }
+        else {
+            await ctx.deposit('review:changes-needed', {
+                artifact: signal.payload,
+                feedback: review.feedback,
+            }, {
+                causedBy: [signal.id],
+                tags: ['needs-rework'],
+                ttl: 60_000, // expires after 1 minute if nobody picks it up
+            });
+            ctx.log(`✗ Changes needed: ${review.feedback}`);
+        }
+        // Withdraw the shaped artifact signal
+        await ctx.withdraw(signal.id);
+    })
+        .concurrency(2)
+        .claim('lease', 30_000)
+        .poll(1000)
+        .build();
+    // ── KEEPER COLONY ──────────────────────────────────────
+    const keeperDef = colony('keeper')
+        .in(env)
+        .sense('review:approved', { unclaimed: true, minConcentration: 0.1 })
+        .do('merge-artifact', async (signal, ctx) => {
+        const artifact = signal.payload.artifact ?? {};
+        ctx.log(`Merging approved artifact: ${artifact.task}`);
+        const result = await simulateMerge(artifact);
+        await ctx.deposit('artifact:merged', result, {
+            causedBy: [signal.id],
+            tags: ['complete'],
+        });
+        await ctx.withdraw(signal.id);
+        ctx.log(`Merged → commit ${result.commitHash}`);
+    })
+        .concurrency(1) // single keeper for serialized merges
+        .claim('exclusive')
+        .poll(1000)
+        .build();
+    return { shaperDef, criticDef, keeperDef };
+}
+// ----------------------------------------------------------
+// Orchestration (just seeds tasks — no coordination logic!)
+// ----------------------------------------------------------
+async function seedTasks(env) {
+    const tasks = [
+        { name: 'auth-middleware', priority: 'high', description: 'Add JWT authentication' },
+        { name: 'rate-limiter', priority: 'medium', description: 'Implement API rate limiting' },
+        { name: 'health-check', priority: 'low', description: 'Add /health endpoint' },
+        { name: 'error-handler', priority: 'high', description: 'Global error handling middleware' },
+        { name: 'request-logger', priority: 'medium', description: 'Structured request logging' },
+    ];
+    console.log('📋 Seeding tasks into environment...\n');
+    for (const task of tasks) {
+        const signal = await env.deposit({
+            type: 'task:ready',
+            payload: task,
+            meta: { deposited_by: 'orchestrator', tags: [task.priority] },
+        });
+        console.log(`   → task:ready  "${task.name}" (${signal.id})`);
+    }
+    console.log('\n' + '─'.repeat(60));
+    console.log('   Colonies are now self-organizing. No further coordination.');
+    console.log('─'.repeat(60) + '\n');
+}
+// ----------------------------------------------------------
+// Main
+// ----------------------------------------------------------
+async function main() {
+    await setup();
+    const env = new FilesystemEnvironment({ root: ENV_ROOT, name: 'code-pipeline' });
+    const { shaperDef, criticDef, keeperDef } = defineColonies(env);
+    // Create runtimes
+    const shaperRuntime = createRuntime(shaperDef, { rate: 0.005, interval: 10_000 });
+    const criticRuntime = createRuntime(criticDef, { rate: 0.005, interval: 10_000 });
+    const keeperRuntime = createRuntime(keeperDef, { rate: 0.005, interval: 10_000 });
+    // Wire up observability
+    for (const [name, rt] of [['shaper', shaperRuntime], ['critic', criticRuntime], ['keeper', keeperRuntime]]) {
+        rt.on('action:completed', (signal) => {
+            // Just for demo visibility
+        });
+        rt.on('signal:claim_failed', (signal) => {
+            console.log(`   ⚡ Claim conflict in ${name}: ${signal.type}`);
+        });
+    }
+    // Start all colonies
+    console.log('🚀 Starting colonies...\n');
+    await Promise.all([
+        shaperRuntime.start(),
+        criticRuntime.start(),
+        keeperRuntime.start(),
+    ]);
+    // Seed tasks into the environment
+    await sleep(500);
+    await seedTasks(env);
+    // Let the colonies work for 20 seconds
+    await sleep(20_000);
+    // Print final state
+    console.log('\n' + '═'.repeat(60));
+    console.log('   FINAL STATE');
+    console.log('═'.repeat(60));
+    const snapshot = await env.snapshot();
+    const history = await env.history({ includeWithdrawn: true });
+    console.log(`\n   Active signals: ${snapshot.length}`);
+    console.log(`   Total signals processed: ${history.length}`);
+    console.log(`\n   Active signals:`);
+    for (const s of snapshot) {
+        console.log(`     [${s.type}] ${s.payload.task ?? s.payload.name ?? '?'} (conc: ${s.meta.concentration.toFixed(2)})`);
+    }
+    console.log(`\n   Colony stats:`);
+    console.log(`     Shaper:  ${shaperRuntime.stats.signalsProcessed} processed, ${shaperRuntime.stats.signalsDeposited} deposited, ${shaperRuntime.stats.claimConflicts} conflicts`);
+    console.log(`     Critic:  ${criticRuntime.stats.signalsProcessed} processed, ${criticRuntime.stats.signalsDeposited} deposited, ${criticRuntime.stats.claimConflicts} conflicts`);
+    console.log(`     Keeper:  ${keeperRuntime.stats.signalsProcessed} processed, ${keeperRuntime.stats.signalsDeposited} deposited, ${keeperRuntime.stats.claimConflicts} conflicts`);
+    // Graceful shutdown
+    console.log('\n🛑 Stopping colonies...');
+    await Promise.all([
+        shaperRuntime.stop(),
+        criticRuntime.stop(),
+        keeperRuntime.stop(),
+    ]);
+    console.log('✅ Done.\n');
+}
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+main().catch(console.error);
+//# sourceMappingURL=index.js.map

package/dist/examples/code-pipeline/index.js.map

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