borgmcp 1.0.5 → 1.0.7

package/dist/lifecycle-log-guard.js

@@ -1,93 +1,2 @@
-import { mkdir, readFile, writeFile } from 'node:fs/promises';
-import { homedir } from 'node:os';
-import { dirname, join } from 'node:path';
-const STATE_FILE = join(homedir(), '.config', 'borgmcp', 'lifecycle-log-state.json');
-const ARRIVAL_DUPLICATE_WINDOW_MS = 10 * 60 * 1000;
-export function lifecycleSignalForMessage(message) {
-    if (message.startsWith('ARRIVAL: '))
-        return 'arrival';
-    if (message.startsWith('READY: ') &&
-        message.includes('capacity clean') &&
-        message.includes('awaiting next dispatch')) {
-        return 'ready';
-    }
-    return null;
-}
-function stateKey(subject) {
-    return `${subject.cubeId}:${subject.droneId}`;
-}
-async function readState() {
-    try {
-        const raw = await readFile(STATE_FILE, 'utf8');
-        const parsed = JSON.parse(raw);
-        if (parsed &&
-            typeof parsed === 'object' &&
-            parsed.entries &&
-            typeof parsed.entries === 'object' &&
-            !Array.isArray(parsed.entries)) {
-            return parsed;
-        }
-    }
-    catch (err) {
-        if (err?.code !== 'ENOENT')
-            throw err;
-    }
-    return { entries: {} };
-}
-async function writeState(state) {
-    await mkdir(dirname(STATE_FILE), { recursive: true });
-    await writeFile(STATE_FILE, JSON.stringify(state, null, 2) + '\n', { mode: 0o600 });
-}
-export function shouldSuppressLifecycleLogFromState(message, state, nowMs = Date.now()) {
-    const signal = lifecycleSignalForMessage(message);
-    if (!signal)
-        return { suppress: false, signal: null };
-    if (signal === 'arrival') {
-        const lastArrivalAt = state?.lastArrival?.at
-            ? new Date(state.lastArrival.at).getTime()
-            : NaN;
-        const isRecent = Number.isFinite(lastArrivalAt) &&
-            nowMs - lastArrivalAt < ARRIVAL_DUPLICATE_WINDOW_MS;
-        return {
-            suppress: state?.lastArrival?.message === message && isRecent,
-            signal,
-        };
-    }
-    return {
-        suppress: state?.idleReady?.open === true && state.idleReady.message === message,
-        signal,
-    };
-}
-export async function shouldSuppressLifecycleLog(subject, message) {
-    const state = await readState();
-    return shouldSuppressLifecycleLogFromState(message, state.entries[stateKey(subject)]);
-}
-export function nextLifecycleStateAfterLog(message, current, nowIso = new Date().toISOString()) {
-    const signal = lifecycleSignalForMessage(message);
-    if (signal === 'arrival') {
-        return {
-            ...current,
-            lastArrival: { message, at: nowIso },
-        };
-    }
-    if (signal === 'ready') {
-        return {
-            ...current,
-            idleReady: { message, open: true, at: nowIso },
-        };
-    }
-    if (current?.idleReady?.open) {
-        return {
-            ...current,
-            idleReady: { ...current.idleReady, open: false, at: nowIso },
-        };
-    }
-    return current ?? {};
-}
-export async function recordLifecycleLog(subject, message) {
-    const state = await readState();
-    const key = stateKey(subject);
-    state.entries[key] = nextLifecycleStateAfterLog(message, state.entries[key]);
-    await writeState(state);
-}
-//# sourceMappingURL=lifecycle-log-guard.js.map
+import{mkdir as u,readFile as f,writeFile as d}from"node:fs/promises";import{homedir as p}from"node:os";import{dirname as y,join as A}from"node:path";const n=A(p(),".config","borgmcp","lifecycle-log-state.json"),S=600*1e3;function o(e){return e.startsWith("ARRIVAL: ")?"arrival":e.startsWith("READY: ")&&e.includes("capacity clean")&&e.includes("awaiting next dispatch")?"ready":null}function s(e){return`${e.cubeId}:${e.droneId}`}async function l(){try{const e=await f(n,"utf8"),t=JSON.parse(e);if(t&&typeof t=="object"&&t.entries&&typeof t.entries=="object"&&!Array.isArray(t.entries))return t}catch(e){if(e?.code!=="ENOENT")throw e}return{entries:{}}}async function w(e){await u(y(n),{recursive:!0}),await d(n,JSON.stringify(e,null,2)+`
+`,{mode:384})}function L(e,t,r=Date.now()){const i=o(e);if(!i)return{suppress:!1,signal:null};if(i==="arrival"){const a=t?.lastArrival?.at?new Date(t.lastArrival.at).getTime():NaN,c=Number.isFinite(a)&&r-a<S;return{suppress:t?.lastArrival?.message===e&&c,signal:i}}return{suppress:t?.idleReady?.open===!0&&t.idleReady.message===e,signal:i}}async function h(e,t){const r=await l();return L(t,r.entries[s(e)])}function R(e,t,r=new Date().toISOString()){const i=o(e);return i==="arrival"?{...t,lastArrival:{message:e,at:r}}:i==="ready"?{...t,idleReady:{message:e,open:!0,at:r}}:t?.idleReady?.open?{...t,idleReady:{...t.idleReady,open:!1,at:r}}:t??{}}async function N(e,t){const r=await l(),i=s(e);r.entries[i]=R(t,r.entries[i]),await w(r)}export{o as lifecycleSignalForMessage,R as nextLifecycleStateAfterLog,N as recordLifecycleLog,h as shouldSuppressLifecycleLog,L as shouldSuppressLifecycleLogFromState};

package/dist/list-roles-render.js

@@ -1,39 +1,6 @@
-/**
- * Sprint 6 / gh#153 — pure render function for `borg:list-roles` MCP tool.
- *
- * Extracted from the inline `case 'borg:list-roles'` handler in
- * `index.ts` per drone-3's QA-FAIL 2026-05-18T13:27:53Z so the render
- * logic is unit-testable without exercising the full MCP tool dispatch
- * stack. The handler simply calls `renderRoleList(roles, cubeId)` and
- * returns its output.
- */
-/**
- * Render the role registry for a cube as a markdown list with role IDs
- * exposed for use with `borg:reassign-drone`. Returns the empty-roles
- * placeholder when the input array is empty.
- *
- * Each role line shape:
- *   - **<name>**(<tags>) `<uuid>` — <description>
- *
- * Tags collected in order: Queen, human-seat, default, can-broadcast,
- * receives-all-direct. Joined with `, `; suffix omitted entirely when no tags apply.
- */
-export function renderRoleList(roles, cubeId) {
-    if (!roles.length) {
-        return 'No roles in this cube yet.';
-    }
-    const lines = roles.map((r) => {
-        const tags = [
-            r.role_class === 'queen' ? 'Queen' : null,
-            r.is_human_seat ? 'human-seat' : null,
-            r.is_default ? 'default' : null,
-            r.can_broadcast ? 'can-broadcast' : null,
-            r.receives_all_direct ? 'receives-all-direct' : null,
-        ].filter(Boolean).join(', ');
-        const tagSuffix = tags ? ` (${tags})` : '';
-        const desc = r.short_description || '_(no description)_';
-        return `- **${r.name}**${tagSuffix} \`${r.id}\` — ${desc}`;
-    });
-    return `Roles in cube ${cubeId} (${roles.length}):\n\n${lines.join('\n')}\n\nUse the role IDs above with \`borg:reassign-drone\` to change a drone's role.`;
-}
-//# sourceMappingURL=list-roles-render.js.map
+function i(n,s){if(!n.length)return"No roles in this cube yet.";const l=n.map(e=>{const t=[e.role_class==="queen"?"Queen":null,e.is_human_seat?"human-seat":null,e.is_default?"default":null,e.can_broadcast?"can-broadcast":null,e.receives_all_direct?"receives-all-direct":null].filter(Boolean).join(", "),o=t?` (${t})`:"",a=e.short_description||"_(no description)_";return`- **${e.name}**${o} \`${e.id}\` \u2014 ${a}`});return`Roles in cube ${s} (${n.length}):
+
+${l.join(`
+`)}
+
+Use the role IDs above with \`borg:reassign-drone\` to change a drone's role.`}export{i as renderRoleList};

package/dist/log-audit.js

@@ -1,187 +1,4 @@
 #!/usr/bin/env node
-/**
- * borg-log-audit
- *
- * Domain-agnostic nudge: scans the Claude Code transcript and emits a
- * one-line warning to stdout if the drone has accumulated MATERIAL_THRESHOLD
- * or more state-changing tool calls (Edit / Write / Bash / etc.) since the
- * last borg:log post. Wired in as a UserPromptSubmit hook so the warning
- * becomes additional context for the next turn.
- *
- * Two refinements vs the v1 1-tool threshold (per drone-6's review):
- *   1. Counts material tools across all assistant turns until either the
- *      threshold is hit OR a borg:log call is found (cooldown). One
- *      diagnostic Bash no longer triggers; substantive work always does.
- *   2. Any borg:log in the scanback suppresses the nudge — so the drone
- *      gets a turn of breathing room after each post.
- *
- * Stays generic — knows nothing about git, branches, or any project's
- * conventions. Only the Anthropic tool name `mcp__borg__borg_log` and a
- * small set of canonical mutating tool names. If no cube is active in
- * this project, silently exits.
- *
- * Hook input arrives as JSON on stdin (Claude Code's standard hook
- * contract). The relevant field is `transcript_path`.
- */
-import { existsSync, readFileSync } from 'node:fs';
-import { getActiveCube } from './cubes.js';
-import { handleVersionFlag } from './version.js';
-const MATERIAL_TOOLS = new Set([
-    'Edit',
-    'Write',
-    'MultiEdit',
-    'NotebookEdit',
-    'Bash',
-    'apply_patch',
-    'exec_command',
-    'functions.exec_command',
-    'functions.apply_patch',
-]);
-const LOG_TOOL = 'mcp__borg__borg_log';
-// Number of state-changing tool calls since the last borg:log that the
-// drone is allowed before the audit nudges. 1 false-positives on
-// diagnostic Bash (git status, ls, etc.); 3 has been comfortable in
-// dogfooding — any substantive work crosses it within a turn or two.
-const MATERIAL_THRESHOLD = 3;
-// Cap on how many transcript entries we scan backwards before giving up.
-// Sessions with thousands of turns still resolve in milliseconds at this
-// bound, and anything truly old is no longer "the last span the drone
-// failed to log."
-const MAX_SCAN = 400;
-function isUserPrompt(entry) {
-    const type = entry?.type ?? entry?.role;
-    if (type !== 'user')
-        return false;
-    const content = entry?.message?.content ?? entry?.content;
-    if (typeof content === 'string')
-        return content.trim().length > 0;
-    if (!Array.isArray(content))
-        return false;
-    // A "real" user prompt has at least one text block. A tool_result-only
-    // user message is a continuation of an assistant span, not a prompt.
-    return content.some((b) => b?.type === 'text');
-}
-function isAssistant(entry) {
-    const type = entry?.type ?? entry?.role;
-    return type === 'assistant' || type === 'response_item';
-}
-function scanAssistant(entry, state) {
-    const payload = entry?.payload;
-    const payloadToolName = payload?.type === 'function_call' || payload?.type === 'custom_tool_call'
-        ? payload.name
-        : null;
-    if (typeof payloadToolName === 'string') {
-        if (payloadToolName === LOG_TOOL) {
-            state.loggedRecently = true;
-            return;
-        }
-        if (MATERIAL_TOOLS.has(payloadToolName))
-            state.material += 1;
-    }
-    const content = entry?.message?.content ?? entry?.content ?? [];
-    if (!Array.isArray(content))
-        return;
-    // Walk the blocks newest-first WITHIN the entry. The caller already
-    // visits entries newest-first. Counting forward within an entry would
-    // either miss post-log material work (if log is in the same entry as
-    // later material blocks) or inflate the count with pre-log work that
-    // the log already covered. Reversing here keeps "material since the
-    // last log" honest at block granularity.
-    for (let i = content.length - 1; i >= 0; i--) {
-        const block = content[i];
-        if (block?.type !== 'tool_use')
-            continue;
-        if (block.name === LOG_TOOL) {
-            state.loggedRecently = true;
-            return;
-        }
-        if (MATERIAL_TOOLS.has(block.name))
-            state.material += 1;
-    }
-}
-async function readStdin() {
-    if (process.stdin.isTTY)
-        return '';
-    const chunks = [];
-    for await (const chunk of process.stdin)
-        chunks.push(chunk);
-    return Buffer.concat(chunks).toString('utf-8');
-}
-async function main() {
-    handleVersionFlag();
-    const raw = await readStdin();
-    let input = {};
-    if (raw.trim()) {
-        try {
-            input = JSON.parse(raw);
-        }
-        catch {
-            // No usable input — silent exit.
-            return;
-        }
-    }
-    if (!input.transcript_path || !existsSync(input.transcript_path))
-        return;
-    if (input.cwd && existsSync(input.cwd)) {
-        try {
-            process.chdir(input.cwd);
-        }
-        catch {
-            // Best-effort only; fall back to the hook process cwd.
-        }
-    }
-    // Only nudge if there's an active cube in this project. Otherwise the
-    // hook is fully inert.
-    const active = await getActiveCube();
-    if (!active)
-        return;
-    const lines = readFileSync(input.transcript_path, 'utf-8').split('\n').filter(Boolean);
-    if (lines.length === 0)
-        return;
-    // Walk the transcript backwards from the end. The trailing entry MAY
-    // be the user prompt that triggered this hook; skip it if so. From
-    // there, accumulate material tool calls until either we hit a borg:log
-    // (cooldown — suppress) or we cross MATERIAL_THRESHOLD (nudge). The
-    // scan stops after MAX_SCAN entries to bound work on huge sessions.
-    let i = lines.length - 1;
-    const tail = safeParse(lines[i]);
-    if (tail && isUserPrompt(tail))
-        i--;
-    const state = { material: 0, loggedRecently: false };
-    let scanned = 0;
-    for (; i >= 0 && scanned < MAX_SCAN; i--, scanned++) {
-        const entry = safeParse(lines[i]);
-        if (!entry)
-            continue;
-        if (isAssistant(entry)) {
-            scanAssistant(entry, state);
-            // Threshold has primacy over cooldown: when both could fire on the
-            // same entry (e.g. an entry containing [log, Bash, Bash, Bash]
-            // where the reversed scan first counts 3 material blocks before
-            // hitting the log), we want the nudge — the post-log material
-            // work hasn't been logged yet.
-            if (state.material >= MATERIAL_THRESHOLD) {
-                process.stdout.write(`Heads up: ${state.material}+ state-changing tool calls since the last \`borg:log\` post. ` +
-                    'If that work was a substantive unit (a change that ships, a blocker hit, a finding ' +
-                    "worth sharing), post to the cube log per your role's conventions before continuing.\n");
-                return;
-            }
-            if (state.loggedRecently)
-                return; // cooldown
-        }
-    }
-    // Reached MAX_SCAN or start of transcript without finding either a
-    // log call or enough material work. Silent.
-}
-function safeParse(line) {
-    try {
-        return JSON.parse(line);
-    }
-    catch {
-        return null;
-    }
-}
-main().catch(() => {
-    // Never fail a hook — silent on error.
-});
-//# sourceMappingURL=log-audit.js.map
+import{existsSync as l,readFileSync as g}from"node:fs";import{getActiveCube as h}from"./cubes.js";import{handleVersionFlag as m}from"./version.js";const u=new Set(["Edit","Write","MultiEdit","NotebookEdit","Bash","apply_patch","exec_command","functions.exec_command","functions.apply_patch"]),f="mcp__borg__borg_log",d=3,y=400;function _(t){if((t?.type??t?.role)!=="user")return!1;const o=t?.message?.content??t?.content;return typeof o=="string"?o.trim().length>0:Array.isArray(o)?o.some(e=>e?.type==="text"):!1}function A(t){const n=t?.type??t?.role;return n==="assistant"||n==="response_item"}function w(t,n){const o=t?.payload,e=o?.type==="function_call"||o?.type==="custom_tool_call"?o.name:null;if(typeof e=="string"){if(e===f){n.loggedRecently=!0;return}u.has(e)&&(n.material+=1)}const r=t?.message?.content??t?.content??[];if(Array.isArray(r))for(let s=r.length-1;s>=0;s--){const i=r[s];if(i?.type==="tool_use"){if(i.name===f){n.loggedRecently=!0;return}u.has(i.name)&&(n.material+=1)}}}async function b(){if(process.stdin.isTTY)return"";const t=[];for await(const n of process.stdin)t.push(n);return Buffer.concat(t).toString("utf-8")}async function S(){m();const t=await b();let n={};if(t.trim())try{n=JSON.parse(t)}catch{return}if(!n.transcript_path||!l(n.transcript_path))return;if(n.cwd&&l(n.cwd))try{process.chdir(n.cwd)}catch{}if(!await h())return;const e=g(n.transcript_path,"utf-8").split(`
+`).filter(Boolean);if(e.length===0)return;let r=e.length-1;const s=p(e[r]);s&&_(s)&&r--;const i={material:0,loggedRecently:!1};let c=0;for(;r>=0&&c<y;r--,c++){const a=p(e[r]);if(a&&A(a)){if(w(a,i),i.material>=d){process.stdout.write(`Heads up: ${i.material}+ state-changing tool calls since the last \`borg:log\` post. If that work was a substantive unit (a change that ships, a blocker hit, a finding worth sharing), post to the cube log per your role's conventions before continuing.
+`);return}if(i.loggedRecently)return}}}function p(t){try{return JSON.parse(t)}catch{return null}}S().catch(()=>{});