@mandible-ai/mandible 0.2.0

package/dist/examples/code-pipeline/with-providers.d.ts

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

package/dist/examples/code-pipeline/with-providers.d.ts.map

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

package/dist/examples/code-pipeline/with-providers.js

@@ -0,0 +1,246 @@
+#!/usr/bin/env tsx
+// ============================================================
+// Code Pipeline Demo — With Real LLM Providers
+// ============================================================
+// Same pipeline as index.ts, but using action providers
+// instead of simulated work functions.
+//
+// Shaper:  withClaudeCode (Claude Code SDK) — full coding agent
+// Critic:  withStructuredOutput (Anthropic) — structured review
+// Keeper:  withBash — git merge
+//
+// Prerequisites:
+//   npm install @anthropic-ai/sdk @anthropic-ai/claude-agent-sdk
+//   export ANTHROPIC_API_KEY=sk-ant-...
+//
+// Run:
+//   npx tsx examples/code-pipeline/with-providers.ts
+// ============================================================
+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';
+import { withClaudeCode } from '../../src/providers/claude-code.js';
+import { withStructuredOutput } from '../../src/providers/structured-output.js';
+import { withBash } from '../../src/providers/bash.js';
+import { assembleContext } from '../../src/providers/context.js';
+const ENV_ROOT = resolve('/tmp/stigmergy-demo-providers');
+const WORKSPACE = resolve('/tmp/stigmergy-workspace');
+async function setup() {
+    await rm(ENV_ROOT, { recursive: true, force: true });
+    await rm(WORKSPACE, { recursive: true, force: true });
+    await mkdir(ENV_ROOT, { recursive: true });
+    await mkdir(WORKSPACE, { recursive: true });
+    console.log(`\n🌿 Environment: ${ENV_ROOT}`);
+    console.log(`📁 Workspace:   ${WORKSPACE}\n`);
+}
+// ----------------------------------------------------------
+// Colony definitions using real providers
+// ----------------------------------------------------------
+function defineColonies(env) {
+    // ── SHAPER — Full coding agent via Claude Code SDK ─────
+    const shaperDef = colony('shaper')
+        .in(env)
+        .sense('task:ready', { unclaimed: true, minConcentration: 0.1 })
+        .do('shape-code', withClaudeCode({
+        model: 'claude-sonnet-4-5-20250929',
+        systemPrompt: [
+            'You are a senior TypeScript engineer in a coding colony.',
+            'You receive task specifications and implement them as clean, well-typed code.',
+            'Create the implementation in the working directory.',
+            'Include basic tests. Follow existing code conventions.',
+            'Be concise — implement exactly what is asked, nothing more.',
+        ].join('\n'),
+        prompt: async (signal) => {
+            // Assemble context from signal lineage
+            const context = await assembleContext(signal, env, {
+                includeLineage: true,
+                includeRelated: ['review:changes-needed'],
+            });
+            return [
+                `## Task: ${signal.payload.name}`,
+                `**Description:** ${signal.payload.description}`,
+                `**Priority:** ${signal.payload.priority}`,
+                '',
+                'Implement this as a TypeScript module with tests.',
+                '',
+                context,
+            ].join('\n');
+        },
+        tools: ['file_edit', 'bash'],
+        workingDirectory: (signal) => resolve(WORKSPACE, String(signal.payload.name)),
+        maxTokens: 4096,
+        output: {
+            type: 'artifact:shaped',
+            tags: ['needs-review'],
+        },
+    }))
+        .concurrency(2)
+        .claim('lease', 120_000) // 2 min lease for agent work
+        .poll(2000)
+        .build();
+    // ── CRITIC — Structured output via Anthropic SDK ───────
+    const criticDef = colony('critic')
+        .in(env)
+        .sense('artifact:shaped', { unclaimed: true, minConcentration: 0.1 })
+        .do('review-code', withStructuredOutput({
+        model: 'claude-sonnet-4-5-20250929',
+        provider: 'anthropic',
+        systemPrompt: [
+            'You are a code reviewer in a critic colony.',
+            'Review the code artifact and provide structured feedback.',
+            'Be constructive but rigorous. Focus on correctness,',
+            'error handling, type safety, and test coverage.',
+        ].join('\n'),
+        prompt: async (signal) => {
+            const context = await assembleContext(signal, env, {
+                includeLineage: true,
+                lineageDepth: 2,
+            });
+            return [
+                '## Code Review Request',
+                '',
+                `**Task:** ${signal.payload.task ?? signal.payload.text ?? 'unknown'}`,
+                '',
+                '### Artifact',
+                '```',
+                JSON.stringify(signal.payload, null, 2),
+                '```',
+                '',
+                context,
+                '',
+                'Review this artifact and provide your assessment.',
+            ].join('\n');
+        },
+        // Schema would be a Zod object in real usage:
+        // schema: z.object({
+        //   approved: z.boolean(),
+        //   feedback: z.string(),
+        //   severity: z.enum(['minor', 'major', 'blocking']),
+        //   suggestions: z.array(z.string()).optional(),
+        // }),
+        route: (result, signal) => {
+            if (result.approved) {
+                return {
+                    type: 'review:approved',
+                    payload: { ...result, artifact: signal.payload },
+                    tags: ['ready-to-merge'],
+                };
+            }
+            return {
+                type: 'review:changes-needed',
+                payload: { ...result, artifact: signal.payload },
+                tags: ['needs-rework'],
+                ttl: 120_000,
+            };
+        },
+    }))
+        .concurrency(2)
+        .claim('lease', 60_000)
+        .poll(2000)
+        .build();
+    // ── KEEPER — Bash commands for mechanical merge ────────
+    const keeperDef = colony('keeper')
+        .in(env)
+        .sense('review:approved', { unclaimed: true, minConcentration: 0.1 })
+        .do('merge-artifact', withBash({
+        command: (signal) => {
+            const artifact = signal.payload.artifact ?? {};
+            const task = artifact.task ?? artifact.name ?? 'unknown';
+            // In a real setup this would be:
+            //   git merge feature/${task} --no-ff -m "Merge: ${task}"
+            // For the demo, we just echo success
+            return `echo "Merged artifact: ${task}" && date`;
+        },
+        cwd: WORKSPACE,
+        timeout: 30_000,
+        output: (result, signal) => {
+            const artifact = signal.payload.artifact ?? {};
+            if (result.exitCode === 0) {
+                return {
+                    type: 'artifact:merged',
+                    payload: {
+                        task: artifact.task ?? artifact.name,
+                        stdout: result.stdout.trim(),
+                        durationMs: result.durationMs,
+                    },
+                    tags: ['complete'],
+                };
+            }
+            return {
+                type: 'merge:failed',
+                payload: {
+                    task: artifact.task ?? artifact.name,
+                    stderr: result.stderr,
+                    exitCode: result.exitCode,
+                },
+                tags: ['needs-attention'],
+            };
+        },
+    }))
+        .concurrency(1)
+        .claim('exclusive')
+        .poll(2000)
+        .build();
+    return { shaperDef, criticDef, keeperDef };
+}
+// ----------------------------------------------------------
+// Main
+// ----------------------------------------------------------
+async function main() {
+    await setup();
+    const env = new FilesystemEnvironment({ root: ENV_ROOT, name: 'code-pipeline' });
+    const { shaperDef, criticDef, keeperDef } = defineColonies(env);
+    const shaperRuntime = createRuntime(shaperDef, { rate: 0.002, interval: 15_000 });
+    const criticRuntime = createRuntime(criticDef, { rate: 0.002, interval: 15_000 });
+    const keeperRuntime = createRuntime(keeperDef, { rate: 0.002, interval: 15_000 });
+    console.log('🚀 Starting colonies with LLM providers...\n');
+    await Promise.all([
+        shaperRuntime.start(),
+        criticRuntime.start(),
+        keeperRuntime.start(),
+    ]);
+    // Seed tasks
+    console.log('📋 Seeding tasks...\n');
+    const tasks = [
+        { name: 'auth-middleware', priority: 'high', description: 'Add JWT authentication middleware for Express' },
+        { name: 'rate-limiter', priority: 'medium', description: 'Implement sliding window rate limiter' },
+    ];
+    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 self-organizing with real LLM providers.');
+    console.log('   Shaper: Claude Code SDK | Critic: Anthropic | Keeper: Bash');
+    console.log('─'.repeat(60) + '\n');
+    // Let colonies work
+    await sleep(60_000);
+    // Report
+    console.log('\n' + '═'.repeat(60));
+    const snapshot = await env.snapshot();
+    console.log(`\n   Active signals: ${snapshot.length}`);
+    for (const s of snapshot) {
+        console.log(`     [${s.type}] ${JSON.stringify(s.payload).slice(0, 80)}`);
+    }
+    console.log('\n   Colony stats:');
+    console.log(`     Shaper:  ${shaperRuntime.stats.signalsProcessed} processed`);
+    console.log(`     Critic:  ${criticRuntime.stats.signalsProcessed} processed`);
+    console.log(`     Keeper:  ${keeperRuntime.stats.signalsProcessed} processed`);
+    await Promise.all([
+        shaperRuntime.stop(),
+        criticRuntime.stop(),
+        keeperRuntime.stop(),
+    ]);
+    console.log('\n✅ Done.\n');
+}
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+main().catch(console.error);
+//# sourceMappingURL=with-providers.js.map

package/dist/examples/code-pipeline/with-providers.js.map

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

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

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

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

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

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

@@ -0,0 +1,235 @@
+#!/usr/bin/env tsx
+// ============================================================
+// Docker Pipeline — Colonies Running in Containers
+// ============================================================
+// Deploys colonies as Docker containers via the Mandible Cloud API.
+// Each colony runs in its own container, connected to the signal
+// server over WebSocket. The dashboard shows real-time coordination.
+//
+// Prerequisites:
+//   1. Docker running
+//   2. Build the colony image:
+//        cd mandible-cloud && ./scripts/build-colony-dev.sh
+//   3. Start the signal server + cloud API:
+//        cd mandible-cloud
+//        PORT=9090 MANDIBLE_ADMIN_KEY=your-admin-key go run ./cmd/signalserver &
+//        PORT=9091 MANDIBLE_SIGNAL_SERVER_URL=ws://host.docker.internal:9090/v1/signals \
+//          MANDIBLE_SIGNAL_SERVER_ADMIN_URL=http://localhost:9090 \
+//          MANDIBLE_ZONE_MODE=docker MANDIBLE_ADMIN_KEY=your-admin-key \
+//          go run ./cmd/cloudapi &
+//
+// Then run:
+//   npx tsx examples/docker-pipeline/index.ts
+// ============================================================
+import { RemoteEnvironment } from '../../src/environments/remote/index.js';
+import { startDevServer } from '../../src/cli/server.js';
+import { colony } from '../../src/dsl/index.js';
+const CLOUD_API = process.env.MANDIBLE_CLOUD_API ?? 'http://localhost:9091';
+const SIGNAL_SERVER = process.env.MANDIBLE_SIGNAL_SERVER ?? 'ws://localhost:9090/v1/signals';
+const ADMIN_KEY = process.env.MANDIBLE_ADMIN_KEY ?? 'replace-with-your-admin-key';
+const COLONY_IMAGE = process.env.MANDIBLE_COLONY_IMAGE ?? 'mandible-colony:latest';
+const DASHBOARD_PORT = parseInt(process.env.DASHBOARD_PORT ?? '4042', 10);
+function sleep(ms) { return new Promise(r => setTimeout(r, ms)); }
+async function api(method, path, body) {
+    const res = await fetch(`${CLOUD_API}${path}`, {
+        method,
+        headers: {
+            'Authorization': `Bearer ${ADMIN_KEY}`,
+            'Content-Type': 'application/json',
+        },
+        body: body ? JSON.stringify(body) : undefined,
+    });
+    if (!res.ok) {
+        const err = await res.text();
+        throw new Error(`API ${method} ${path} failed (${res.status}): ${err}`);
+    }
+    if (res.status === 204)
+        return null;
+    return res.json();
+}
+async function waitForZones(projectId, expected, timeoutMs = 30_000) {
+    const start = Date.now();
+    while (Date.now() - start < timeoutMs) {
+        const zones = await api('GET', `/v1/projects/${projectId}/zones`);
+        const running = zones.filter((z) => z.state === 'running');
+        if (running.length >= expected)
+            return zones;
+        process.stdout.write('.');
+        await sleep(1000);
+    }
+    throw new Error(`timed out waiting for ${expected} zones to reach running state`);
+}
+// ── Simulated work (used by the local dashboard colonies) ───
+async function simulateShaping(task) {
+    await sleep(500 + Math.random() * 1500);
+    return {
+        code: `function ${task.name}() { return true; }`,
+        linesChanged: Math.floor(Math.random() * 100) + 10,
+        task: task.name,
+    };
+}
+async function simulateReview(artifact) {
+    await sleep(300 + Math.random() * 1000);
+    const approved = Math.random() > 0.2;
+    return {
+        approved,
+        feedback: approved
+            ? `Code for "${artifact.task}" looks good.`
+            : `Code for "${artifact.task}" needs error handling.`,
+    };
+}
+async function simulateMerge(artifact) {
+    await sleep(200 + Math.random() * 500);
+    return { merged: true, task: artifact.task, commitHash: Math.random().toString(36).slice(2, 10) };
+}
+// ── Main ────────────────────────────────────────────────────
+async function main() {
+    console.log('\n  mandible docker pipeline');
+    console.log(`  cloud API:      ${CLOUD_API}`);
+    console.log(`  signal server:  ${SIGNAL_SERVER}`);
+    console.log(`  colony image:   ${COLONY_IMAGE}\n`);
+    // 1. Create project via Cloud API
+    console.log('  creating project...');
+    const project = await api('POST', '/v1/projects', { name: `docker-demo-${Date.now()}` });
+    const projectId = project.id;
+    console.log(`  project: ${projectId}\n`);
+    // 2. Deploy 3 colonies as Docker containers
+    console.log('  deploying colonies as Docker containers...');
+    const deployResult = await api('POST', `/v1/projects/${projectId}/deploy`, {
+        colonies: [
+            {
+                name: 'shaper',
+                image: COLONY_IMAGE,
+                concurrency: 2,
+                claimStrategy: 'lease',
+                sensors: [{ query: { type: 'task:ready' }, pollInterval: 2000 }],
+            },
+            {
+                name: 'critic',
+                image: COLONY_IMAGE,
+                concurrency: 2,
+                claimStrategy: 'lease',
+                sensors: [{ query: { type: 'artifact:shaped' }, pollInterval: 2000 }],
+            },
+            {
+                name: 'keeper',
+                image: COLONY_IMAGE,
+                concurrency: 1,
+                claimStrategy: 'exclusive',
+                sensors: [{ query: { type: 'review:approved' }, pollInterval: 2000 }],
+            },
+        ],
+    });
+    console.log(`  deployed ${deployResult.colonies.length} colonies:`);
+    for (const c of deployResult.colonies) {
+        console.log(`    + ${c.name} (zone: ${c.zoneId})`);
+    }
+    // 3. Wait for all zones to reach running state
+    process.stdout.write('\n  waiting for containers');
+    const zones = await waitForZones(projectId, 3);
+    console.log(` done!`);
+    for (const z of zones) {
+        console.log(`    ${z.colony}: ${z.state} (uptime: ${z.uptimeSeconds}s)`);
+    }
+    // 4. Connect to signal server for dashboard + seeding
+    const env = new RemoteEnvironment({
+        url: SIGNAL_SERVER,
+        apiKey: ADMIN_KEY,
+        project: projectId,
+        name: 'dashboard',
+        connectTimeout: 5_000,
+    });
+    await env.connect();
+    // 5. Start local dashboard (connects to same signal server for event relay)
+    // Define local "ghost" colonies for the dashboard to track names
+    // (these don't actually run — the real colonies are in Docker)
+    const ghostShaper = colony('shaper').in(env)
+        .sense('task:ready', { unclaimed: true })
+        .do('shape', async (s, ctx) => {
+        ctx.log(`Shaping: ${s.payload.name}`);
+        const artifact = await simulateShaping(s.payload);
+        await ctx.deposit('artifact:shaped', artifact, { causedBy: [s.id], tags: ['needs-review'] });
+        await ctx.withdraw(s.id);
+    })
+        .concurrency(2).claim('lease', 30_000).poll(1500).build();
+    const ghostCritic = colony('critic').in(env)
+        .sense('artifact:shaped', { unclaimed: true })
+        .do('review', async (s, ctx) => {
+        ctx.log(`Reviewing: ${s.payload.task}`);
+        const review = await simulateReview(s.payload);
+        if (review.approved) {
+            await ctx.deposit('review:approved', { artifact: s.payload, feedback: review.feedback }, { causedBy: [s.id], tags: ['ready-to-merge'] });
+        }
+        else {
+            await ctx.deposit('review:rejected', { artifact: s.payload, feedback: review.feedback }, { causedBy: [s.id], tags: ['needs-rework'], ttl: 60_000 });
+        }
+        await ctx.withdraw(s.id);
+    })
+        .concurrency(2).claim('lease', 30_000).poll(1500).build();
+    const ghostKeeper = colony('keeper').in(env)
+        .sense('review:approved', { unclaimed: true })
+        .do('merge', async (s, ctx) => {
+        const artifact = s.payload.artifact ?? {};
+        ctx.log(`Merging: ${artifact.task}`);
+        const result = await simulateMerge(artifact);
+        await ctx.deposit('task:complete', result, { causedBy: [s.id], tags: ['complete'] });
+        await ctx.withdraw(s.id);
+    })
+        .concurrency(1).claim('exclusive').poll(1500).build();
+    await startDevServer({
+        environment: env,
+        colonies: [ghostShaper, ghostCritic, ghostKeeper],
+        dashboard: { port: DASHBOARD_PORT, open: true },
+    }, { port: DASHBOARD_PORT, open: true });
+    // 6. Seed tasks
+    console.log('\n  seeding tasks...\n');
+    await sleep(2000);
+    const tasks = [
+        { name: 'auth-middleware', priority: 'high', description: 'Add JWT authentication' },
+        { name: 'rate-limiter', priority: 'medium', description: 'API rate limiting' },
+        { name: 'health-check', priority: 'low', description: 'Add /health endpoint' },
+        { name: 'error-handler', priority: 'high', description: 'Global error handling' },
+        { name: 'request-logger', priority: 'medium', description: 'Structured logging' },
+    ];
+    for (const task of tasks) {
+        await env.deposit({
+            type: 'task:ready',
+            payload: task,
+            meta: { deposited_by: 'seed', tags: [task.priority] },
+        });
+        console.log(`    seeded: task:ready "${task.name}"`);
+    }
+    console.log(`\n  dashboard: http://localhost:${DASHBOARD_PORT}`);
+    console.log('  colonies are running in Docker containers');
+    console.log('  signals flow: seed -> shaper(container) -> critic(container) -> keeper(container)');
+    console.log('  press Ctrl+C to stop\n');
+    // Graceful shutdown: teardown zones on exit
+    const shutdown = async () => {
+        console.log('\n  tearing down...');
+        try {
+            const zoneList = await api('GET', `/v1/projects/${projectId}/zones`);
+            for (const z of zoneList) {
+                if (z.state !== 'destroyed' && z.state !== 'destroying') {
+                    await api('DELETE', `/v1/projects/${projectId}/colonies/${z.colony}`);
+                    console.log(`    destroyed: ${z.colony}`);
+                }
+            }
+        }
+        catch (err) {
+            console.error(`    teardown error: ${err.message}`);
+        }
+    };
+    process.on('SIGINT', async () => {
+        await shutdown();
+        process.exit(0);
+    });
+    process.on('SIGTERM', async () => {
+        await shutdown();
+        process.exit(0);
+    });
+}
+main().catch((err) => {
+    console.error(err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

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

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

package/dist/examples/github-colony/mandible.config.d.ts

@@ -0,0 +1,11 @@
+import { GitHubEnvironment } from '../../src/environments/github/index.js';
+declare const _default: {
+    environment: GitHubEnvironment;
+    colonies: import("../../src/index.js").ColonyDefinition<Record<string, unknown>>[];
+    dashboard: {
+        port: number;
+        open: boolean;
+    };
+};
+export default _default;
+//# sourceMappingURL=mandible.config.d.ts.map

package/dist/examples/github-colony/mandible.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mandible.config.d.ts","sourceRoot":"","sources":["../../../examples/github-colony/mandible.config.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;;;;;;;;;AAkE3E,wBAIE"}

package/dist/examples/github-colony/mandible.config.js

@@ -0,0 +1,63 @@
+// PURPOSE: Dashboard config for GitHub colony — Golem tablets as stigmergy signals
+// PURPOSE: Run: GITHUB_TOKEN=ghp_... npx tsx src/cli/index.ts dev examples/github-colony/mandible.config.ts
+import { GitHubEnvironment } from '../../src/environments/github/index.js';
+import { colony } from '../../src/dsl/index.js';
+// ----------------------------------------------------------
+// Config from environment variables
+// ----------------------------------------------------------
+const OWNER = process.env.GITHUB_OWNER ?? 'your-org';
+const REPO = process.env.GITHUB_REPO ?? 'your-repo';
+const POLL_INTERVAL = 30_000;
+if (!process.env.GITHUB_TOKEN) {
+    console.error('\n  GITHUB_TOKEN is required.');
+    console.error('  Usage: GITHUB_TOKEN=ghp_... npx tsx src/cli/index.ts dev examples/github-colony/mandible.config.ts\n');
+    process.exit(1);
+}
+// ----------------------------------------------------------
+// Environment — GitHub IS the stigmergy substrate
+// ----------------------------------------------------------
+const env = new GitHubEnvironment({
+    owner: OWNER,
+    repo: REPO,
+    pollInterval: POLL_INTERVAL,
+    labels: ['golem'],
+    allowWithdraw: false,
+    decayRate: 0.001,
+});
+// ----------------------------------------------------------
+// Colonies
+// ----------------------------------------------------------
+// Observer colony — senses golem tablets, logs them
+// In a real setup this would be replaced with a triage/planning colony
+const observer = colony('golem')
+    .in(env)
+    .sense('golem:*', { minConcentration: 0.05 })
+    .do('log-tablet', async (signal, ctx) => {
+    const payload = signal.payload;
+    ctx.log(`[${signal.meta.concentration.toFixed(2)}] #${payload.number} ${payload.title}`);
+})
+    .concurrency(1)
+    .claim('none')
+    .poll(POLL_INTERVAL)
+    .build();
+// Watcher colony — senses all issue types for dashboard visibility
+const watcher = colony('issue-watcher')
+    .in(env)
+    .sense('issue:*', { minConcentration: 0.05 })
+    .do('log-issue', async (signal, ctx) => {
+    const payload = signal.payload;
+    ctx.log(`[${signal.meta.concentration.toFixed(2)}] #${payload.number} ${payload.title}`);
+})
+    .concurrency(1)
+    .claim('none')
+    .poll(POLL_INTERVAL)
+    .build();
+// ----------------------------------------------------------
+// Export config for mandible dev
+// ----------------------------------------------------------
+export default {
+    environment: env,
+    colonies: [observer, watcher],
+    dashboard: { port: 4040, open: true },
+};
+//# sourceMappingURL=mandible.config.js.map

package/dist/examples/github-colony/mandible.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mandible.config.js","sourceRoot":"","sources":["../../../examples/github-colony/mandible.config.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,4GAA4G;AAE5G,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAC3E,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAGhD,6DAA6D;AAC7D,oCAAoC;AACpC,6DAA6D;AAE7D,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,UAAU,CAAC;AACrD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,WAAW,CAAC;AACpD,MAAM,aAAa,GAAG,MAAM,CAAC;AAE7B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC;IAC9B,OAAO,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;IAC/C,OAAO,CAAC,KAAK,CAAC,wGAAwG,CAAC,CAAC;IACxH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,6DAA6D;AAC7D,kDAAkD;AAClD,6DAA6D;AAE7D,MAAM,GAAG,GAAG,IAAI,iBAAiB,CAAC;IAChC,KAAK,EAAE,KAAK;IACZ,IAAI,EAAE,IAAI;IACV,YAAY,EAAE,aAAa;IAC3B,MAAM,EAAE,CAAC,OAAO,CAAC;IACjB,aAAa,EAAE,KAAK;IACpB,SAAS,EAAE,KAAK;CACjB,CAAC,CAAC;AAEH,6DAA6D;AAC7D,WAAW;AACX,6DAA6D;AAE7D,oDAAoD;AACpD,uEAAuE;AACvE,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC;KAC7B,EAAE,CAAC,GAAG,CAAC;KACP,KAAK,CAAC,SAAS,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC;KAC5C,EAAE,CAAC,YAAY,EAAE,KAAK,EAAE,MAAc,EAAE,GAAkB,EAAE,EAAE;IAC7D,MAAM,OAAO,GAAG,MAAM,CAAC,OAAkC,CAAC;IAC1D,GAAG,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;AAC3F,CAAC,CAAC;KACD,WAAW,CAAC,CAAC,CAAC;KACd,KAAK,CAAC,MAAM,CAAC;KACb,IAAI,CAAC,aAAa,CAAC;KACnB,KAAK,EAAE,CAAC;AAEX,mEAAmE;AACnE,MAAM,OAAO,GAAG,MAAM,CAAC,eAAe,CAAC;KACpC,EAAE,CAAC,GAAG,CAAC;KACP,KAAK,CAAC,SAAS,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC;KAC5C,EAAE,CAAC,WAAW,EAAE,KAAK,EAAE,MAAc,EAAE,GAAkB,EAAE,EAAE;IAC5D,MAAM,OAAO,GAAG,MAAM,CAAC,OAAkC,CAAC;IAC1D,GAAG,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;AAC3F,CAAC,CAAC;KACD,WAAW,CAAC,CAAC,CAAC;KACd,KAAK,CAAC,MAAM,CAAC;KACb,IAAI,CAAC,aAAa,CAAC;KACnB,KAAK,EAAE,CAAC;AAEX,6DAA6D;AAC7D,iCAAiC;AACjC,6DAA6D;AAE7D,eAAe;IACb,WAAW,EAAE,GAAG;IAChB,QAAQ,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC7B,SAAS,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE;CACtC,CAAC"}

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

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

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

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