@songsid/agend 0.0.4 → 0.0.6

package/dist/fleet-dashboard-html.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"fleet-dashboard-html.js","sourceRoot":"","sources":["../src/fleet-dashboard-html.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAob5B,CAAC"}

package/dist/fleet-health-server.d.ts

@@ -1,35 +0,0 @@
-import { type Server } from "node:http";
-import type { Logger } from "./logger.js";
-import type { FleetConfig, InstanceConfig } from "./types.js";
-import type { Scheduler } from "./scheduler/index.js";
-import type { EventLog } from "./event-log.js";
-import type { SysInfo } from "./fleet-context.js";
-/**
- * Extract a web token from a request, accepting (in order):
- *   1. `?token=` query string
- *   2. `Authorization: Bearer <token>` header (standard)
- *   3. `X-Agend-Token: <token>` header (legacy compatibility)
- */
-export declare function extractWebToken(parsedUrl: URL, headers: Record<string, string | string[] | undefined>): string | null;
-export interface UiStatusContext {
-    readonly fleetConfig: FleetConfig | null;
-    readonly logger: Logger;
-    getInstanceDir(name: string): string;
-    getInstanceStatus(name: string): "running" | "stopped" | "crashed";
-}
-export interface HealthServerContext extends UiStatusContext {
-    readonly dataDir: string;
-    readonly scheduler: Scheduler | null;
-    readonly eventLog: EventLog | null;
-    getSysInfo(): SysInfo;
-    lastActivityMs(name: string): number;
-    startInstance(name: string, config: InstanceConfig, topicMode: boolean): Promise<void>;
-    restartSingleInstance(name: string): Promise<void>;
-    emitSseEvent(event: string, data: unknown): void;
-}
-export declare function startHealthServer(ctx: HealthServerContext, port: number): {
-    server: Server;
-    webToken: string;
-    startedAt: number;
-};
-export declare function getUiStatus(ctx: UiStatusContext, startedAt: number): unknown;

package/dist/fleet-health-server.js

@@ -1,290 +0,0 @@
-/**
- * Health / dashboard HTTP server for the daemon.
- *
- * Exposes:
- *   - GET /health       (public, no auth)
- *   - GET /status       (basic per-instance snapshot)
- *   - GET /api/fleet    (enriched fleet snapshot for the UI)
- *   - GET /api/activity (event log entries; ?since= ?limit=)
- *   - GET /activity     (HTML viewer; served from fleet-dashboard-html.ts)
- *   - POST /api/instance/:name/start
- *   - POST /restart/:name
- *   - POST /agent       (forwarded to handleAgentRequest)
- *   - GET  /ui/*        (forwarded to handleWebRequest)
- *
- * All endpoints except /health require a Bearer / ?token= match against
- * the per-process web token written to <dataDir>/web.token (mode 0600).
- *
- * Extracted from fleet-manager.ts (P4.1 step 4 of 4).
- */
-import { existsSync, readFileSync, writeFileSync, chmodSync } from "node:fs";
-import { createServer } from "node:http";
-import { randomBytes } from "node:crypto";
-import { join } from "node:path";
-import { ACTIVITY_VIEWER_HTML } from "./fleet-dashboard-html.js";
-import { handleAgentRequest } from "./agent-endpoint.js";
-import { handleWebRequest } from "./web-api.js";
-/**
- * Extract a web token from a request, accepting (in order):
- *   1. `?token=` query string
- *   2. `Authorization: Bearer <token>` header (standard)
- *   3. `X-Agend-Token: <token>` header (legacy compatibility)
- */
-export function extractWebToken(parsedUrl, headers) {
-    const queryToken = parsedUrl.searchParams.get("token");
-    if (queryToken)
-        return queryToken;
-    const auth = headers["authorization"];
-    const authStr = Array.isArray(auth) ? auth[0] : auth;
-    if (authStr && /^Bearer\s+/i.test(authStr)) {
-        return authStr.replace(/^Bearer\s+/i, "").trim();
-    }
-    const headerToken = headers["x-agend-token"];
-    if (typeof headerToken === "string")
-        return headerToken;
-    if (Array.isArray(headerToken) && headerToken.length > 0)
-        return headerToken[0];
-    return null;
-}
-export function startHealthServer(ctx, port) {
-    let server;
-    const startedAt = Date.now();
-    // Generate web token before server starts so auth is enforced from the first request.
-    const webToken = randomBytes(24).toString("hex");
-    const tokenPath = join(ctx.dataDir, "web.token");
-    writeFileSync(tokenPath, webToken, { mode: 0o600 });
-    // Defensive: if file existed previously with looser perms, tighten it.
-    try {
-        chmodSync(tokenPath, 0o600);
-    }
-    catch {
-        // best-effort
-    }
-    server = createServer((req, res) => {
-        res.setHeader("Content-Type", "application/json");
-        // Public health probe — no auth required.
-        if (req.method === "GET" && req.url === "/health") {
-            // fallthrough to existing handler below
-        }
-        else {
-            // All other endpoints require a valid token. Accepts ?token= query,
-            // Authorization: Bearer <token>, or legacy X-Agend-Token header.
-            // /ui/* will also re-check in web-api.ts, which is harmless.
-            const parsedUrl = new URL(req.url ?? "/", `http://localhost:${port}`);
-            const providedToken = extractWebToken(parsedUrl, req.headers);
-            if (!webToken || providedToken !== webToken) {
-                res.writeHead(401);
-                res.end(JSON.stringify({ error: "Unauthorized" }));
-                return;
-            }
-        }
-        if (req.method === "GET" && req.url === "/health") {
-            const instanceCount = ctx.fleetConfig?.instances
-                ? Object.keys(ctx.fleetConfig.instances).length
-                : 0;
-            res.writeHead(200);
-            res.end(JSON.stringify({
-                status: "ok",
-                instances: instanceCount,
-                uptime: Math.floor((Date.now() - startedAt) / 1000),
-            }));
-            return;
-        }
-        if (req.method === "GET" && req.url === "/status") {
-            const instances = Object.keys(ctx.fleetConfig?.instances ?? {}).map(name => {
-                const statusFile = join(ctx.getInstanceDir(name), "statusline.json");
-                let context_pct = 0;
-                let cost = 0;
-                try {
-                    const data = JSON.parse(readFileSync(statusFile, "utf-8"));
-                    context_pct = data.context_window?.used_percentage ?? 0;
-                    cost = data.cost?.total_cost_usd ?? 0;
-                }
-                catch (err) {
-                    ctx.logger.debug({ err, name }, "statusline.json read failed (/status)");
-                }
-                return {
-                    name,
-                    status: ctx.getInstanceStatus(name),
-                    context_pct,
-                    cost,
-                };
-            });
-            res.writeHead(200);
-            res.end(JSON.stringify({ instances }));
-            return;
-        }
-        // Fleet API (enriched for agent board)
-        if (req.method === "GET" && req.url === "/api/fleet") {
-            const sysInfo = ctx.getSysInfo();
-            const enriched = sysInfo.instances.map(inst => {
-                const config = ctx.fleetConfig?.instances[inst.name];
-                // Find claimed tasks for this instance
-                let currentTask = null;
-                try {
-                    const tasks = ctx.scheduler?.db.listTasks({ assignee: inst.name, status: "claimed" });
-                    if (tasks?.length)
-                        currentTask = tasks[0].title;
-                }
-                catch (err) {
-                    ctx.logger.debug({ err, name: inst.name }, "Scheduler listTasks failed (/api/fleet)");
-                }
-                return {
-                    ...inst,
-                    description: config?.description ?? null,
-                    backend: config?.backend ?? "claude-code",
-                    tool_set: config?.tool_set ?? "full",
-                    general_topic: config?.general_topic ?? false,
-                    lastActivity: ctx.lastActivityMs(inst.name) || null,
-                    currentTask,
-                };
-            });
-            // Same-origin only — token-bearing requests come from the dashboard
-            // served by this same daemon, so no CORS allowance is needed.
-            res.writeHead(200);
-            res.end(JSON.stringify({
-                ...sysInfo,
-                instances: enriched,
-            }));
-            return;
-        }
-        // Activity API
-        if (req.method === "GET" && req.url?.startsWith("/api/activity")) {
-            const url = new URL(req.url, `http://localhost:${port}`);
-            const sinceParam = url.searchParams.get("since") ?? "2h";
-            const limitParam = url.searchParams.get("limit") ?? "500";
-            const match = sinceParam.match(/^(\d+)(m|h|d)$/);
-            let sinceIso;
-            if (match) {
-                const val = parseInt(match[1], 10);
-                const unit = match[2] === "d" ? 86400000 : match[2] === "h" ? 3600000 : 60000;
-                sinceIso = new Date(Date.now() - val * unit).toISOString();
-            }
-            const rows = ctx.eventLog?.listActivity({ since: sinceIso, limit: parseInt(limitParam, 10) }) ?? [];
-            // Same-origin only — see /api/fleet rationale.
-            res.writeHead(200);
-            res.end(JSON.stringify(rows));
-            return;
-        }
-        // Activity viewer
-        if (req.method === "GET" && (req.url === "/activity" || req.url === "/activity/")) {
-            res.setHeader("Content-Type", "text/html; charset=utf-8");
-            res.writeHead(200);
-            res.end(ACTIVITY_VIEWER_HTML);
-            return;
-        }
-        // Instance start via API
-        if (req.method === "POST" && req.url?.startsWith("/api/instance/") && req.url.endsWith("/start")) {
-            const name = decodeURIComponent(req.url.slice("/api/instance/".length, -"/start".length));
-            const config = ctx.fleetConfig?.instances[name];
-            if (!config) {
-                res.writeHead(404);
-                res.end(JSON.stringify({ error: `Instance not found: ${name}` }));
-                return;
-            }
-            (async () => {
-                try {
-                    const topicMode = ctx.fleetConfig?.channel?.mode === "topic";
-                    await ctx.startInstance(name, config, topicMode ?? false);
-                    ctx.emitSseEvent("status", getUiStatus(ctx, startedAt));
-                    res.writeHead(200);
-                    res.end(JSON.stringify({ ok: true }));
-                }
-                catch (err) {
-                    res.writeHead(500);
-                    res.end(JSON.stringify({ error: `Start failed: ${err.message}` }));
-                }
-            })();
-            return;
-        }
-        // Instance restart (immediate, no idle wait)
-        if (req.method === "POST" && req.url?.startsWith("/restart/")) {
-            const name = decodeURIComponent(req.url.slice("/restart/".length));
-            ctx.logger.info({ name }, "Instance restart requested via HTTP");
-            (async () => {
-                try {
-                    await ctx.restartSingleInstance(name);
-                    ctx.logger.info({ name }, "Instance restarted");
-                    ctx.emitSseEvent("status", getUiStatus(ctx, startedAt));
-                    res.writeHead(200);
-                    res.end(JSON.stringify({ restarted: name }));
-                }
-                catch (err) {
-                    ctx.logger.error({ err, name }, "Instance restart failed");
-                    const status = err.message.includes("not found") ? 404 : 500;
-                    res.writeHead(status);
-                    res.end(JSON.stringify({ error: `Restart failed: ${err.message}` }));
-                }
-            })();
-            return;
-        }
-        // ── Agent CLI endpoint ─────
-        if (req.url === "/agent" && req.method === "POST") {
-            handleAgentRequest(req, res, ctx);
-            return;
-        }
-        // ── Web UI endpoints (delegated to web-api.ts) ─────
-        const url = new URL(req.url ?? "/", `http://localhost:${port}`);
-        if (handleWebRequest(req, res, url, ctx))
-            return;
-        res.writeHead(404);
-        res.end(JSON.stringify({ error: "not found" }));
-    });
-    server.on("error", (err) => {
-        if (err.code === "EADDRINUSE") {
-            ctx.logger.warn({ port }, "Health port in use — attempting takeover");
-            const pidPath = join(ctx.dataDir, "fleet.pid");
-            try {
-                if (existsSync(pidPath)) {
-                    const oldPid = parseInt(readFileSync(pidPath, "utf-8").trim(), 10);
-                    if (oldPid && oldPid !== process.pid) {
-                        process.kill(oldPid, "SIGTERM");
-                        ctx.logger.info({ oldPid }, "Killed old fleet process");
-                    }
-                }
-            }
-            catch (err) {
-                ctx.logger.debug({ err }, "Old fleet process kill skipped (already gone or no permission)");
-            }
-            setTimeout(() => {
-                if (!server)
-                    return;
-                server.listen(port, "127.0.0.1", () => {
-                    ctx.logger.info({ port }, "Health endpoint listening (after takeover)");
-                }).on("error", () => {
-                    ctx.logger.warn({ port }, "Health port still in use — skipping health endpoint");
-                });
-            }, 1500);
-            return;
-        }
-        ctx.logger.error({ err, port }, "Health server error");
-    });
-    server.listen(port, "127.0.0.1", () => {
-        ctx.logger.info({ port }, "Health endpoint listening");
-    });
-    ctx.logger.info({ url: `http://localhost:${port}/ui?token=${webToken}` }, "Web UI available");
-    return { server, webToken, startedAt };
-}
-export function getUiStatus(ctx, startedAt) {
-    const instances = Object.keys(ctx.fleetConfig?.instances ?? {}).map(name => {
-        const statusFile = join(ctx.getInstanceDir(name), "statusline.json");
-        let context_pct = 0;
-        let cost = 0;
-        let model = "";
-        try {
-            const data = JSON.parse(readFileSync(statusFile, "utf-8"));
-            context_pct = data.context_window?.used_percentage ?? 0;
-            cost = data.cost?.total_cost_usd ?? 0;
-            model = data.model?.display_name ?? "";
-        }
-        catch (err) {
-            ctx.logger.debug({ err, name }, "statusline.json read failed (getUiStatus)");
-        }
-        return { name, status: ctx.getInstanceStatus(name), context_pct, cost, model };
-    });
-    return {
-        instances,
-        uptime: Math.floor((Date.now() - startedAt) / 1000),
-    };
-}
-//# sourceMappingURL=fleet-health-server.js.map

package/dist/fleet-health-server.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"fleet-health-server.js","sourceRoot":"","sources":["../src/fleet-health-server.ts"],"names":[],"mappings":"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"}

package/dist/fleet-instructions.d.ts

@@ -1,5 +0,0 @@
-import type { Logger } from "./logger.js";
-export declare const INSTRUCTIONS_FILENAME: Record<string, string>;
-export declare const GENERAL_INSTRUCTIONS = "# Fleet Coordinator\n\nYou are the fleet coordinator \u2014 the central entry point for this AgEnD fleet.\nYou route tasks, manage instances, enforce policies, and synthesize results.\nDo NOT modify project files directly \u2014 delegate file changes to the project's instance.\nYou CAN write code snippets, explain code, and answer technical questions directly.\n\n-----\n\n## Task Classification\n\nClassify every incoming request before acting.\n\n### Handle Directly (ALL conditions must be true)\n\n- No file system access needed\n- No external execution needed\n- Answerable from static knowledge\n- \u2264 2 reasoning steps\n\nExamples: Q&A, translation, fleet status queries, explaining a concept, writing code snippets.\n\n### Delegate to 1 Instance\n\n- Task scoped to a single project or repo\n- Requires file access, code changes, or execution\n\n### Coordinate Multiple Instances\n\n- Task spans multiple repos or domains\n- Requires outputs from one instance to feed into another\n- Benefits from parallel execution (max 3 instances per task)\n\n-----\n\n## Instance Discovery (in this order)\n1. list_teams()        \u2192 reuse existing teams first\n2. list_instances()    \u2192 find by working_directory, description, or tags\n3. describe_instance() \u2192 confirm capabilities before delegating\n4. create_instance()   \u2192 only if no suitable instance exists\n\nRules: prefer reuse over creation. Do NOT create duplicates of running instances.\n\n-----\n\n## Delegation Protocol\n\nEvery delegation via send_to_instance() MUST include:\n\n1. Task scope \u2014 what exactly to do, bounded clearly\n2. Expected output \u2014 what to return and in what form\n3. Policy reminder \u2014 \"Follow Development Workflow policy\" (for code tasks)\n\n### Loop Prevention\n\n- Never re-delegate a task back to the instance that sent it to you\n- If a task has bounced 3 times, stop and solve locally or reduce scope\n\n### Execution Strategy\n\nParallel \u2014 use only when tasks are independent with no shared state\nSequential \u2014 use when one task's output feeds into the next\n\n-----\n\n## Result Handling\n\nWhen an instance reports back, classify the outcome:\n\n- Success \u2192 Summarize key results for user. Omit internal coordination noise.\n- Partial \u2192 State what succeeded, what remains, proposed next steps.\n- Failure \u2192 Retry up to 2 times. If still failing: try alternative instance, reduce scope, or return partial result clearly marked.\n- No response \u2192 Ping again after reasonable wait. If still silent: report to user with options.\n\n### Output to User\n\nEvery final response to the user should contain:\n\n- Result \u2014 the actual answer or deliverable\n- Gaps \u2014 anything incomplete or unresolved (omit if none)\n\n-----\n\n## Shared Decisions\n\nUse post_decision() / list_decisions() for any choice that affects more than 1 instance, changes an API contract, introduces a new dependency, or alters deployment process.\n\nWhen instances disagree, collect both viewpoints, make a decision, and record it via post_decision.\n\n-----\n\n## Context Rotation Bootstrap\n\nAfter your context rotates, run this sequence BEFORE processing any new messages:\n1. list_instances()   \u2192 rebuild fleet awareness\n2. list_teams()       \u2192 restore team structure\n3. list_decisions()   \u2192 reload policies and conventions\n\nOnly then handle incoming requests.\n\n-----\n\n## Development Workflow Policy\n\nAll code changes across the fleet should follow this workflow.\nThe coordinator enforces compliance but does not perform these steps directly.\nRemind instances of this policy when delegating code tasks.\n\n### Workflow Stages\nDesign Proposed \u2192 Design Approved \u2192 Implementation \u2192 Submit for Review \u2192 Under Review \u2192 Approved \u2192 Merge\n\n### Policy Rules\n\n1. Design before code \u2014 developer sends design proposal to reviewer before implementation. Consensus required before proceeding.\n2. Challenger pairing \u2014 every code task should have a developer + reviewer. Reviewer actively questions decisions and finds risks.\n3. Verify by execution \u2014 backend/CLI changes must be tested by running them. Do not trust documentation alone.\n4. Independent review \u2014 every merge requires code review from someone other than the author.\n5. Root cause first \u2014 bug fixes require confirmed root cause before proposing a fix.\n6. Merge conditions: tests pass, reviewer approved, branch and worktree cleaned up.\n\n### Specialist Instance Rules\n\n- Execute within defined scope only\n- Return structured output: result, assumptions, uncertainties, verification status\n- Do NOT create new instances without coordinator approval\n\n-----\n\n## Team Management\n\n- Always check existing teams before creating new ones\n- Default to ephemeral teams (created for a specific task, dissolved after completion)\n- Clean up ephemeral teams and instances after task completion\n";
-/** Ensure the general (coordinator) instance has its project instructions file. */
-export declare function ensureGeneralInstructions(workDir: string, backendName?: string, logger?: Logger): void;

package/dist/fleet-instructions.js

@@ -1,161 +0,0 @@
-/**
- * General coordinator instance — system prompt + helpers for ensuring the
- * coordinator's working directory has the per-backend instructions file.
- * Extracted from fleet-manager.ts (P4.1).
- */
-import { mkdirSync, writeFileSync, existsSync } from "node:fs";
-import { join, dirname } from "node:path";
-export const INSTRUCTIONS_FILENAME = {
-    "claude-code": "CLAUDE.md",
-    "codex": "AGENTS.md",
-    "gemini-cli": "GEMINI.md",
-    "opencode": "AGENTS.md",
-    "kiro-cli": ".kiro/steering/project.md",
-    "mock": "CLAUDE.md",
-};
-export const GENERAL_INSTRUCTIONS = `# Fleet Coordinator
-
-You are the fleet coordinator — the central entry point for this AgEnD fleet.
-You route tasks, manage instances, enforce policies, and synthesize results.
-Do NOT modify project files directly — delegate file changes to the project's instance.
-You CAN write code snippets, explain code, and answer technical questions directly.
-
------
-
-## Task Classification
-
-Classify every incoming request before acting.
-
-### Handle Directly (ALL conditions must be true)
-
-- No file system access needed
-- No external execution needed
-- Answerable from static knowledge
-- ≤ 2 reasoning steps
-
-Examples: Q&A, translation, fleet status queries, explaining a concept, writing code snippets.
-
-### Delegate to 1 Instance
-
-- Task scoped to a single project or repo
-- Requires file access, code changes, or execution
-
-### Coordinate Multiple Instances
-
-- Task spans multiple repos or domains
-- Requires outputs from one instance to feed into another
-- Benefits from parallel execution (max 3 instances per task)
-
------
-
-## Instance Discovery (in this order)
-1. list_teams()        → reuse existing teams first
-2. list_instances()    → find by working_directory, description, or tags
-3. describe_instance() → confirm capabilities before delegating
-4. create_instance()   → only if no suitable instance exists
-
-Rules: prefer reuse over creation. Do NOT create duplicates of running instances.
-
------
-
-## Delegation Protocol
-
-Every delegation via send_to_instance() MUST include:
-
-1. Task scope — what exactly to do, bounded clearly
-2. Expected output — what to return and in what form
-3. Policy reminder — "Follow Development Workflow policy" (for code tasks)
-
-### Loop Prevention
-
-- Never re-delegate a task back to the instance that sent it to you
-- If a task has bounced 3 times, stop and solve locally or reduce scope
-
-### Execution Strategy
-
-Parallel — use only when tasks are independent with no shared state
-Sequential — use when one task's output feeds into the next
-
------
-
-## Result Handling
-
-When an instance reports back, classify the outcome:
-
-- Success → Summarize key results for user. Omit internal coordination noise.
-- Partial → State what succeeded, what remains, proposed next steps.
-- Failure → Retry up to 2 times. If still failing: try alternative instance, reduce scope, or return partial result clearly marked.
-- No response → Ping again after reasonable wait. If still silent: report to user with options.
-
-### Output to User
-
-Every final response to the user should contain:
-
-- Result — the actual answer or deliverable
-- Gaps — anything incomplete or unresolved (omit if none)
-
------
-
-## Shared Decisions
-
-Use post_decision() / list_decisions() for any choice that affects more than 1 instance, changes an API contract, introduces a new dependency, or alters deployment process.
-
-When instances disagree, collect both viewpoints, make a decision, and record it via post_decision.
-
------
-
-## Context Rotation Bootstrap
-
-After your context rotates, run this sequence BEFORE processing any new messages:
-1. list_instances()   → rebuild fleet awareness
-2. list_teams()       → restore team structure
-3. list_decisions()   → reload policies and conventions
-
-Only then handle incoming requests.
-
------
-
-## Development Workflow Policy
-
-All code changes across the fleet should follow this workflow.
-The coordinator enforces compliance but does not perform these steps directly.
-Remind instances of this policy when delegating code tasks.
-
-### Workflow Stages
-Design Proposed → Design Approved → Implementation → Submit for Review → Under Review → Approved → Merge
-
-### Policy Rules
-
-1. Design before code — developer sends design proposal to reviewer before implementation. Consensus required before proceeding.
-2. Challenger pairing — every code task should have a developer + reviewer. Reviewer actively questions decisions and finds risks.
-3. Verify by execution — backend/CLI changes must be tested by running them. Do not trust documentation alone.
-4. Independent review — every merge requires code review from someone other than the author.
-5. Root cause first — bug fixes require confirmed root cause before proposing a fix.
-6. Merge conditions: tests pass, reviewer approved, branch and worktree cleaned up.
-
-### Specialist Instance Rules
-
-- Execute within defined scope only
-- Return structured output: result, assumptions, uncertainties, verification status
-- Do NOT create new instances without coordinator approval
-
------
-
-## Team Management
-
-- Always check existing teams before creating new ones
-- Default to ephemeral teams (created for a specific task, dissolved after completion)
-- Clean up ephemeral teams and instances after task completion
-`;
-/** Ensure the general (coordinator) instance has its project instructions file. */
-export function ensureGeneralInstructions(workDir, backendName, logger) {
-    const backend = backendName ?? "claude-code";
-    const filename = INSTRUCTIONS_FILENAME[backend] ?? "CLAUDE.md";
-    const filePath = join(workDir, filename);
-    mkdirSync(dirname(filePath), { recursive: true });
-    if (!existsSync(filePath)) {
-        writeFileSync(filePath, GENERAL_INSTRUCTIONS, "utf-8");
-        logger?.info({ filePath }, "Created general instance instructions file");
-    }
-}
-//# sourceMappingURL=fleet-instructions.js.map

package/dist/fleet-instructions.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"fleet-instructions.js","sourceRoot":"","sources":["../src/fleet-instructions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAG1C,MAAM,CAAC,MAAM,qBAAqB,GAA2B;IAC3D,aAAa,EAAE,WAAW;IAC1B,OAAO,EAAE,WAAW;IACpB,YAAY,EAAE,WAAW;IACzB,UAAU,EAAE,WAAW;IACvB,UAAU,EAAE,2BAA2B;IACvC,MAAM,EAAE,WAAW;CACpB,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqInC,CAAC;AAEF,mFAAmF;AACnF,MAAM,UAAU,yBAAyB,CACvC,OAAe,EACf,WAAoB,EACpB,MAAe;IAEf,MAAM,OAAO,GAAG,WAAW,IAAI,aAAa,CAAC;IAC7C,MAAM,QAAQ,GAAG,qBAAqB,CAAC,OAAO,CAAC,IAAI,WAAW,CAAC;IAC/D,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACzC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,aAAa,CAAC,QAAQ,EAAE,oBAAoB,EAAE,OAAO,CAAC,CAAC;QACvD,MAAM,EAAE,IAAI,CAAC,EAAE,QAAQ,EAAE,EAAE,4CAA4C,CAAC,CAAC;IAC3E,CAAC;AACH,CAAC"}

package/dist/fleet-rpc-handlers.d.ts

@@ -1,42 +0,0 @@
-/**
- * RPC / CRUD handlers for fleet-side actions invoked by instances over IPC
- * or by the agent CLI over HTTP.
- *
- * Pattern follows outbound-handlers.ts: a `RpcHandlersContext` interface +
- * a `rpcHandlers` dispatch dictionary. FleetManager implements the context
- * and forwards each call so external surfaces (AgentEndpointContext, IPC
- * dispatch) keep their existing shape.
- *
- * Extracted from fleet-manager.ts (P4.1 step 3 of 4).
- */
-import type { Logger } from "./logger.js";
-import type { Scheduler } from "./scheduler/index.js";
-import type { IpcClient } from "./channel/ipc-bridge.js";
-import type { EventLog } from "./event-log.js";
-import type { FleetConfig } from "./types.js";
-export interface RpcHandlersContext {
-    readonly scheduler: Scheduler | null;
-    readonly fleetConfig: FleetConfig | null;
-    readonly logger: Logger;
-    readonly eventLog: EventLog | null;
-    readonly instanceIpcClients: Map<string, IpcClient>;
-    saveFleetConfig(): void;
-}
-/** Resolve display name for an instance, fallback to instance name. */
-export declare function resolveDisplayName(ctx: {
-    fleetConfig: FleetConfig | null;
-}, instanceName: string): string;
-/** One-line description of a fleet tool call for activity logs. */
-export declare function summarizeToolCall(tool: string, args: Record<string, unknown>): string;
-export declare const rpcHandlers: {
-    handleScheduleCrud(ctx: RpcHandlersContext, instanceName: string, msg: Record<string, unknown>): void;
-    handleDecisionCrud(ctx: RpcHandlersContext, instanceName: string, msg: Record<string, unknown>): void;
-    handleSetDisplayName(ctx: RpcHandlersContext, instanceName: string, msg: Record<string, unknown>): void;
-    handleSetDescription(ctx: RpcHandlersContext, instanceName: string, msg: Record<string, unknown>): void;
-    handleScheduleCrudHttp(ctx: RpcHandlersContext, instance: string, op: string, args: Record<string, unknown>): Promise<unknown>;
-    handleDecisionCrudHttp(ctx: RpcHandlersContext, instance: string, op: string, args: Record<string, unknown>): Promise<unknown>;
-    handleTaskCrudHttp(ctx: RpcHandlersContext, instance: string, args: Record<string, unknown>): Promise<unknown>;
-    handleSetDisplayNameHttp(ctx: RpcHandlersContext, instance: string, name: string): Promise<unknown>;
-    handleSetDescriptionHttp(ctx: RpcHandlersContext, instance: string, description: string): Promise<unknown>;
-    handleTaskCrud(ctx: RpcHandlersContext, instanceName: string, msg: Record<string, unknown>): void;
-};