@mandible-ai/mandible 0.2.0

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

@@ -0,0 +1,154 @@
+#!/usr/bin/env tsx
+// ============================================================
+// Remote Pipeline Integration Test
+// ============================================================
+// Runs the code-pipeline demo against a remote signal server
+// instead of the local filesystem. Proves Vertical Slice 1:
+//
+//   1. Start the Go signal server (must be running separately)
+//   2. Colonies connect via RemoteEnvironment (WebSocket)
+//   3. Dashboard shows real-time events
+//   4. Signals flow through the network, not the filesystem
+//
+// Prerequisites:
+//   cd /path/to/mandible-cloud
+//   MANDIBLE_DEV_API_KEY=your-api-key MANDIBLE_DEV_PROJECT=demo go run ./cmd/signalserver
+//
+// Then run this:
+//   npx tsx examples/remote-pipeline/index.ts
+// ============================================================
+import { RemoteEnvironment } from '../../src/environments/remote/index.js';
+import { colony } from '../../src/dsl/index.js';
+import { startDevServer } from '../../src/cli/server.js';
+const SIGNAL_SERVER_URL = process.env.MANDIBLE_SIGNAL_SERVER ?? 'wss://api.mandible.dev/v1/signals';
+const API_KEY = process.env.MANDIBLE_API_KEY ?? '';
+const PROJECT = process.env.MANDIBLE_PROJECT ?? '';
+const DASHBOARD_PORT = parseInt(process.env.DASHBOARD_PORT ?? '4040', 10);
+function sleep(ms) { return new Promise(r => setTimeout(r, ms)); }
+// ── Simulated work ──────────────────────────────────────────
+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 remote pipeline test');
+    console.log(`  signal server: ${SIGNAL_SERVER_URL}`);
+    console.log(`  project: ${PROJECT}\n`);
+    // Create the remote environment
+    const env = new RemoteEnvironment({
+        url: SIGNAL_SERVER_URL,
+        apiKey: API_KEY,
+        project: PROJECT,
+        name: 'remote-demo',
+        connectTimeout: 5_000,
+    });
+    // Connect and verify
+    try {
+        await env.connect();
+        console.log('  connected to signal server\n');
+    }
+    catch (err) {
+        console.error(`  failed to connect: ${err.message}`);
+        console.error('  make sure the signal server is running:');
+        console.error('    MANDIBLE_DEV_API_KEY=your-api-key MANDIBLE_DEV_PROJECT=demo go run ./cmd/signalserver\n');
+        process.exit(1);
+    }
+    // Define colonies against the remote environment
+    const shaper = colony('shaper')
+        .in(env)
+        .sense('task:ready', { unclaimed: true, minConcentration: 0.1 })
+        .do('shape-code', async (signal, ctx) => {
+        ctx.log(`Shaping: ${signal.payload.name}`);
+        const artifact = await simulateShaping(signal.payload);
+        await ctx.deposit('artifact:shaped', artifact, { causedBy: [signal.id], tags: ['needs-review'] });
+        await ctx.withdraw(signal.id);
+    })
+        .concurrency(2)
+        .claim('lease', 30_000)
+        .poll(1500)
+        .build();
+    const critic = colony('critic')
+        .in(env)
+        .sense('artifact:shaped', { unclaimed: true, minConcentration: 0.1 })
+        .do('review-code', async (signal, ctx) => {
+        ctx.log(`Reviewing: ${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'] });
+        }
+        else {
+            await ctx.deposit('review:rejected', { artifact: signal.payload, feedback: review.feedback }, { causedBy: [signal.id], tags: ['needs-rework'], ttl: 60_000 });
+        }
+        await ctx.withdraw(signal.id);
+    })
+        .concurrency(2)
+        .claim('lease', 30_000)
+        .poll(1500)
+        .build();
+    const keeper = 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: ${artifact.task}`);
+        const result = await simulateMerge(artifact);
+        await ctx.deposit('task:complete', result, { causedBy: [signal.id], tags: ['complete'] });
+        await ctx.withdraw(signal.id);
+    })
+        .concurrency(1)
+        .claim('exclusive')
+        .poll(1500)
+        .build();
+    // Start the dashboard pointing at the remote environment
+    const config = {
+        environment: env,
+        colonies: [shaper, critic, keeper],
+        dashboard: { port: DASHBOARD_PORT, open: true },
+    };
+    await startDevServer(config, { port: DASHBOARD_PORT, open: true });
+    // Seed tasks after colonies are running
+    console.log('  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('  watching colonies coordinate over the network...');
+    console.log('  press Ctrl+C to stop\n');
+}
+main().catch((err) => {
+    console.error(err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

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

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

package/dist/examples/repo-maintenance/fixer.d.ts

@@ -0,0 +1,80 @@
+import type { Environment } from '../../src/core/types.js';
+import type { BedrockConfig } from '../../src/providers/types.js';
+/** Input: what the Fixer senses (from Scout or GitHub) */
+export interface IssuePayload {
+    category: string;
+    severity: string;
+    title: string;
+    description: string;
+    files: string[];
+    suggested_fix?: string;
+    previous_feedback?: string;
+}
+/** Output: what the Fixer deposits on success */
+export interface FixProposedPayload {
+    issue_title: string;
+    branch: string;
+    diff_summary: string;
+    files_changed: string[];
+    tests_passed: boolean;
+    confidence: 'high' | 'medium' | 'low';
+}
+/** Output: what the Fixer deposits on failure */
+export interface FixFailedPayload {
+    issue_title: string;
+    reason: string;
+    attempted_approach?: string;
+}
+export interface FixerColonyOptions {
+    /** Signal types to sense. Defaults to ['issue:detected']. */
+    senseTypes?: string | string[];
+    /** Colony name. Defaults to 'fixer'. */
+    name?: string;
+    /** Model to use. Defaults to 'claude-sonnet-4-5-20250929'. */
+    model?: string;
+    /** Max budget per fix in USD. Defaults to 3.00. */
+    maxBudgetUsd?: number;
+    /** Max conversation turns. Defaults to 80. */
+    maxTurns?: number;
+    /** Allowed tools. Defaults to write-capable tools. */
+    allowedTools?: string[];
+    /** Disallowed tools. Defaults to []. */
+    disallowedTools?: string[];
+    /** Max concurrent fix attempts. Defaults to 2. */
+    concurrency?: number;
+    /** Claim lease duration in ms. Defaults to 600_000 (10 min). */
+    claimLeaseDuration?: number;
+    /** Route through AWS Bedrock instead of direct Anthropic API. */
+    bedrock?: BedrockConfig;
+}
+export declare function createFixerColony(env: Environment, repoRoot: string, options?: FixerColonyOptions): import("../../src/index.js").ColonyDefinition<Record<string, unknown>>;
+interface ParsedFixerSuccess {
+    status: 'success';
+    issue_title: string;
+    branch: string;
+    diff_summary: string;
+    files_changed: string[];
+    tests_passed: boolean;
+    confidence: 'high' | 'medium' | 'low';
+    reason?: undefined;
+    attempted_approach?: undefined;
+}
+interface ParsedFixerFailure {
+    status: 'failure';
+    issue_title: string;
+    reason: string;
+    attempted_approach?: string;
+    branch?: undefined;
+    diff_summary?: undefined;
+    files_changed?: undefined;
+    tests_passed?: undefined;
+    confidence?: undefined;
+}
+export type ParsedFixerOutput = ParsedFixerSuccess | ParsedFixerFailure;
+/**
+ * Extracts JSON result from the agent's markdown-formatted output.
+ * Looks for a ```json code block, parses it, and validates the shape.
+ */
+export declare function parseFixerOutput(text: string): ParsedFixerOutput;
+export {};
+//# sourceMappingURL=fixer.d.ts.map

package/dist/examples/repo-maintenance/fixer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixer.d.ts","sourceRoot":"","sources":["../../../examples/repo-maintenance/fixer.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAU,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAA8B,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAQ9F,0DAA0D;AAC1D,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,iDAAiD;AACjD,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,EAAE,OAAO,CAAC;IACtB,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;CACvC;AAED,iDAAiD;AACjD,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAMD,MAAM,WAAW,kBAAkB;IACjC,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC/B,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,wCAAwC;IACxC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gEAAgE;IAChE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iEAAiE;IACjE,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAMD,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,WAAW,EAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,kBAAuB,0EAgKjC;AAMD,UAAU,kBAAkB;IAC1B,MAAM,EAAE,SAAS,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,EAAE,OAAO,CAAC;IACtB,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACtC,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,kBAAkB,CAAC,EAAE,SAAS,CAAC;CAChC;AAED,UAAU,kBAAkB;IAC1B,MAAM,EAAE,SAAS,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,aAAa,CAAC,EAAE,SAAS,CAAC;IAC1B,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,UAAU,CAAC,EAAE,SAAS,CAAC;CACxB;AAED,MAAM,MAAM,iBAAiB,GAAG,kBAAkB,GAAG,kBAAkB,CAAC;AAExE;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CA0EhE"}

package/dist/examples/repo-maintenance/fixer.js

@@ -0,0 +1,217 @@
+// PURPOSE: Fixer colony — claims issue:detected signals and attempts to fix them using a Claude agent.
+// PURPOSE: Deposits fix:proposed on success or fix:failed on failure.
+import { colony } from '../../src/dsl/builder.js';
+import { withClaudeCode } from '../../src/providers/claude-code.js';
+// ----------------------------------------------------------
+// Fixer colony factory
+// ----------------------------------------------------------
+export function createFixerColony(env, repoRoot, options = {}) {
+    const { senseTypes = 'issue:detected', name = 'fixer', model = 'claude-sonnet-4-5-20250929', maxBudgetUsd = 3.00, maxTurns = 80, allowedTools = ['Read', 'Edit', 'Write', 'Bash', 'Glob', 'Grep'], disallowedTools = [], concurrency = 2, claimLeaseDuration = 600_000, bedrock, } = options;
+    const types = Array.isArray(senseTypes) ? senseTypes : [senseTypes];
+    let builder = colony(name).in(env);
+    for (const t of types) {
+        builder = builder.sense(t, { unclaimed: true });
+    }
+    const def = builder
+        .do('fix-issue', withClaudeCode({
+        model,
+        systemPrompt: [
+            'You are a Fixer agent in a repo-maintenance colony.',
+            'Your job is to claim a detected issue and produce a minimal, correct fix.',
+            '',
+            'Workflow:',
+            '1. Create a branch named `mandible/fix-{category}-{short-hash}` from the current HEAD.',
+            '   Use the first 6 chars of a random hex string for the short hash.',
+            '2. Analyze the issue description and affected files.',
+            '3. Make the MINIMAL change needed to resolve the issue.',
+            '4. Run tests (`npm test` or `npx vitest run`) to verify the fix does not break anything.',
+            '5. Output a JSON result block (see below).',
+            '',
+            'Constraints:',
+            '- Do NOT merge to main. Only work on the fix branch.',
+            '- Do NOT make changes beyond what is needed for this specific issue.',
+            '- If a previous_feedback field is present, it means a prior fix attempt was rejected.',
+            '  Use that feedback to improve your approach.',
+            '- If you cannot fix the issue, output a failure result instead.',
+            '',
+            'Output format — wrap in a ```json code block:',
+            '```json',
+            '{',
+            '  "status": "success",',
+            '  "issue_title": "Short title of the issue",',
+            '  "branch": "mandible/fix-category-abc123",',
+            '  "diff_summary": "What changed and why",',
+            '  "files_changed": ["file1.ts", "file2.ts"],',
+            '  "tests_passed": true,',
+            '  "confidence": "high"',
+            '}',
+            '```',
+            '',
+            'On failure:',
+            '```json',
+            '{',
+            '  "status": "failure",',
+            '  "issue_title": "Short title of the issue",',
+            '  "reason": "Why the fix could not be applied",',
+            '  "attempted_approach": "What was tried"',
+            '}',
+            '```',
+        ].join('\n'),
+        prompt: (signal) => {
+            const p = signal.payload;
+            const lines = [
+                '## Fix Request',
+                '',
+                `**Category:** ${p.category ?? 'unknown'}`,
+                `**Severity:** ${p.severity ?? 'medium'}`,
+                `**Title:** ${p.title ?? 'Untitled issue'}`,
+                '',
+                '### Description',
+                String(p.description ?? 'No description provided.'),
+                '',
+            ];
+            const files = p.files;
+            if (files && files.length > 0) {
+                lines.push('### Affected Files');
+                for (const f of files) {
+                    lines.push(`- ${f}`);
+                }
+                lines.push('');
+            }
+            if (p.suggested_fix) {
+                lines.push('### Suggested Fix');
+                lines.push(String(p.suggested_fix));
+                lines.push('');
+            }
+            if (p.previous_feedback) {
+                lines.push('### Previous Feedback (from rejected attempt)');
+                lines.push(String(p.previous_feedback));
+                lines.push('');
+                lines.push('Use this feedback to improve your fix approach.');
+                lines.push('');
+            }
+            lines.push('Apply the fix, run tests, and output the JSON result block.');
+            return lines.join('\n');
+        },
+        allowedTools,
+        disallowedTools,
+        workingDirectory: repoRoot,
+        maxBudgetUsd,
+        maxTurns,
+        bedrock,
+        output: (result, signal) => {
+            const parsed = parseFixerOutput(result.text);
+            const issuePayload = signal.payload;
+            const issueTitle = String(issuePayload.title ?? 'Unknown issue');
+            if (parsed.status === 'failure') {
+                return [{
+                        type: 'fix:failed',
+                        payload: {
+                            issue_title: parsed.issue_title || issueTitle,
+                            reason: parsed.reason || 'Agent did not produce a valid result',
+                            attempted_approach: parsed.attempted_approach,
+                            costUsd: result.costUsd,
+                            durationMs: result.durationMs,
+                        },
+                        tags: ['failure'],
+                    }];
+            }
+            return [{
+                    type: 'fix:proposed',
+                    payload: {
+                        issue_title: parsed.issue_title || issueTitle,
+                        branch: parsed.branch || 'unknown',
+                        diff_summary: parsed.diff_summary || '',
+                        files_changed: parsed.files_changed || [],
+                        tests_passed: parsed.tests_passed ?? false,
+                        confidence: parsed.confidence || 'low',
+                        costUsd: result.costUsd,
+                        durationMs: result.durationMs,
+                    },
+                    tags: [parsed.confidence || 'low', parsed.tests_passed ? 'tests-pass' : 'tests-fail'],
+                }];
+        },
+        autoWithdraw: true,
+    }))
+        .concurrency(concurrency)
+        .claim('lease', claimLeaseDuration)
+        .poll(3000)
+        .build();
+    return def;
+}
+/**
+ * Extracts JSON result from the agent's markdown-formatted output.
+ * Looks for a ```json code block, parses it, and validates the shape.
+ */
+export function parseFixerOutput(text) {
+    if (!text) {
+        return {
+            status: 'failure',
+            issue_title: '',
+            reason: 'Empty agent output',
+        };
+    }
+    // Try to find a JSON code block
+    const codeBlockMatch = text.match(/```(?:json)?\s*\n?([\s\S]*?)\n?```/);
+    const jsonStr = codeBlockMatch ? codeBlockMatch[1].trim() : text.trim();
+    let parsed;
+    try {
+        parsed = JSON.parse(jsonStr);
+    }
+    catch {
+        // Try to find an object in the text
+        const objectMatch = jsonStr.match(/\{[\s\S]*\}/);
+        if (objectMatch) {
+            try {
+                parsed = JSON.parse(objectMatch[0]);
+            }
+            catch {
+                return {
+                    status: 'failure',
+                    issue_title: '',
+                    reason: 'Could not parse agent output as JSON',
+                };
+            }
+        }
+        else {
+            return {
+                status: 'failure',
+                issue_title: '',
+                reason: 'Could not parse agent output as JSON',
+            };
+        }
+    }
+    if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+        return {
+            status: 'failure',
+            issue_title: '',
+            reason: 'Agent output is not a JSON object',
+        };
+    }
+    const obj = parsed;
+    // Check for explicit failure
+    if (obj.status === 'failure') {
+        return {
+            status: 'failure',
+            issue_title: typeof obj.issue_title === 'string' ? obj.issue_title : '',
+            reason: typeof obj.reason === 'string' ? obj.reason : 'Unknown failure',
+            ...(typeof obj.attempted_approach === 'string' ? { attempted_approach: obj.attempted_approach } : {}),
+        };
+    }
+    // Treat as success — validate and normalize
+    const validConfidences = new Set(['high', 'medium', 'low']);
+    return {
+        status: 'success',
+        issue_title: typeof obj.issue_title === 'string' ? obj.issue_title : '',
+        branch: typeof obj.branch === 'string' ? obj.branch : '',
+        diff_summary: typeof obj.diff_summary === 'string' ? obj.diff_summary : '',
+        files_changed: Array.isArray(obj.files_changed)
+            ? obj.files_changed.filter((f) => typeof f === 'string')
+            : [],
+        tests_passed: typeof obj.tests_passed === 'boolean' ? obj.tests_passed : false,
+        confidence: validConfidences.has(obj.confidence)
+            ? obj.confidence
+            : 'low',
+    };
+}
+//# sourceMappingURL=fixer.js.map

package/dist/examples/repo-maintenance/fixer.js.map

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

package/dist/examples/repo-maintenance/mandible.config.d.ts

@@ -0,0 +1,11 @@
+import { FilesystemEnvironment } from '../../src/environments/filesystem/index.js';
+declare const _default: {
+    environment: FilesystemEnvironment;
+    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/repo-maintenance/mandible.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mandible.config.d.ts","sourceRoot":"","sources":["../../../examples/repo-maintenance/mandible.config.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,qBAAqB,EAAE,MAAM,4CAA4C,CAAC;;;;;;;;;AAiCnF,wBAIE"}

package/dist/examples/repo-maintenance/mandible.config.js

@@ -0,0 +1,34 @@
+// PURPOSE: Dashboard config for repo-maintenance colonies (Scout + Fixer).
+// PURPOSE: Run: npx tsx src/cli/index.ts dev examples/repo-maintenance/mandible.config.ts
+import { resolve } from 'node:path';
+import { rm, mkdir } from 'node:fs/promises';
+import { FilesystemEnvironment } from '../../src/environments/filesystem/index.js';
+import { createScoutColony } from './scout.js';
+import { createFixerColony } from './fixer.js';
+const ENV_ROOT = resolve('/tmp/mandible-repo-maintenance');
+const TARGET_REPO = resolve(process.env.TARGET_REPO ?? process.cwd());
+// Clean slate on startup
+await rm(ENV_ROOT, { recursive: true, force: true });
+await mkdir(ENV_ROOT, { recursive: true });
+const env = new FilesystemEnvironment({ root: ENV_ROOT, name: 'repo-maintenance' });
+// ── Colonies ────────────────────────────────────────────────
+const scout = createScoutColony(env, TARGET_REPO);
+const fixer = createFixerColony(env, TARGET_REPO);
+// ── Seed scan trigger after a short delay ───────────────────
+setTimeout(async () => {
+    await env.deposit({
+        type: 'scan:trigger',
+        payload: {
+            scope: 'full',
+            triggered_by: 'dashboard',
+        },
+        meta: { deposited_by: 'seed', ttl: 10 * 60_000 },
+    });
+}, 2000);
+// ── Export config for mandible dev ──────────────────────────
+export default {
+    environment: env,
+    colonies: [scout, fixer],
+    dashboard: { port: 4040, open: true },
+};
+//# sourceMappingURL=mandible.config.js.map

package/dist/examples/repo-maintenance/mandible.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mandible.config.js","sourceRoot":"","sources":["../../../examples/repo-maintenance/mandible.config.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,0FAA0F;AAE1F,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,4CAA4C,CAAC;AACnF,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,QAAQ,GAAG,OAAO,CAAC,gCAAgC,CAAC,CAAC;AAC3D,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;AAEtE,yBAAyB;AACzB,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AACrD,MAAM,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAE3C,MAAM,GAAG,GAAG,IAAI,qBAAqB,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC,CAAC;AAEpF,+DAA+D;AAE/D,MAAM,KAAK,GAAG,iBAAiB,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;AAClD,MAAM,KAAK,GAAG,iBAAiB,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;AAElD,+DAA+D;AAE/D,UAAU,CAAC,KAAK,IAAI,EAAE;IACpB,MAAM,GAAG,CAAC,OAAO,CAAC;QAChB,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE;YACP,KAAK,EAAE,MAAM;YACb,YAAY,EAAE,WAAW;SAC1B;QACD,IAAI,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,GAAG,MAAM,EAAE;KACjD,CAAC,CAAC;AACL,CAAC,EAAE,IAAI,CAAC,CAAC;AAET,+DAA+D;AAE/D,eAAe;IACb,WAAW,EAAE,GAAG;IAChB,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC;IACxB,SAAS,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE;CACtC,CAAC"}

package/dist/examples/repo-maintenance/scout.d.ts

@@ -0,0 +1,39 @@
+import type { Environment } from '../../src/core/types.js';
+import type { BedrockConfig } from '../../src/providers/types.js';
+export interface ScanTriggerPayload {
+    scope: 'full' | 'incremental';
+    triggered_by: string;
+}
+export interface IssueDetectedPayload {
+    category: 'dependency' | 'dead-code' | 'test-coverage' | 'security' | 'style' | 'stale-todo' | 'other';
+    severity: 'low' | 'medium' | 'high' | 'critical';
+    title: string;
+    description: string;
+    files: string[];
+    suggested_fix?: string;
+}
+export interface ScoutColonyOptions {
+    /** Signal types to sense. Defaults to ['scan:trigger']. */
+    senseTypes?: string | string[];
+    /** Colony name. Defaults to 'scout'. */
+    name?: string;
+    /** Model to use. Defaults to 'claude-sonnet-4-5-20250929'. */
+    model?: string;
+    /** Max budget per scan in USD. Defaults to 0.50. */
+    maxBudgetUsd?: number;
+    /** Max conversation turns. Defaults to 50. */
+    maxTurns?: number;
+    /** Allowed tools. Defaults to read-only tools. */
+    allowedTools?: string[];
+    /** Disallowed tools. Defaults to ['Edit', 'Write']. */
+    disallowedTools?: string[];
+    /** Route through AWS Bedrock instead of direct Anthropic API. */
+    bedrock?: BedrockConfig;
+}
+export declare function createScoutColony(env: Environment, repoRoot: string, options?: ScoutColonyOptions): import("../../src/index.js").ColonyDefinition<Record<string, unknown>>;
+/**
+ * Extracts JSON issue array from the agent's markdown-formatted output.
+ * Looks for a ```json code block, parses it, and validates the shape.
+ */
+export declare function parseScoutOutput(text: string): IssueDetectedPayload[];
+//# sourceMappingURL=scout.d.ts.map

package/dist/examples/repo-maintenance/scout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scout.d.ts","sourceRoot":"","sources":["../../../examples/repo-maintenance/scout.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAU,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAA8B,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAQ9F,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,GAAG,aAAa,CAAC;IAC9B,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,YAAY,GAAG,WAAW,GAAG,eAAe,GAAG,UAAU,GAAG,OAAO,GAAG,YAAY,GAAG,OAAO,CAAC;IACvG,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAMD,MAAM,WAAW,kBAAkB;IACjC,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC/B,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,uDAAuD;IACvD,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,iEAAiE;IACjE,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAMD,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,WAAW,EAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,kBAAuB,0EAuHjC;AAMD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,oBAAoB,EAAE,CAkDrE"}