borgmcp 1.0.6 → 1.0.8

package/dist/role-resolver.js

@@ -1,36 +1 @@
-/**
- * Normalize a role-name argument or stored name into a slug used for
- * both worktree-path construction and role lookup. Single source of
- * truth so the path and the matched role always agree.
- *
- * Path-safe: strips characters outside `[a-z0-9-]` after the
- * underscore/whitespace collapse. The no-arg path bypasses
- * validateName (the matched role's name comes from the DB, which
- * has no charset constraint on role names — CreateRoleSchema is
- * `min(1).max(64)` only), so the safety has to live here.
- */
-export function roleSlug(raw) {
-    return raw.toLowerCase().replace(/[_\s]+/g, '-').replace(/[^a-z0-9-]/g, '');
-}
-/**
- * Case- and separator-insensitive lookup against the cube's roles.
- */
-export function matchRoleByName(roles, query) {
-    const slug = roleSlug(query);
-    return roles.find((r) => roleSlug(r.name) === slug);
-}
-/**
- * Default-role picker for the no-arg case:
- *   - First drone in cube + a human-seat role exists → that role
- *   - Otherwise → the is_default role
- *   - Neither available → undefined (caller errors out)
- */
-export function pickDefaultRole(roles, opts) {
-    if (opts.isFirstDrone) {
-        const humanSeat = roles.find((r) => r.is_human_seat);
-        if (humanSeat)
-            return humanSeat;
-    }
-    return roles.find((r) => r.is_default);
-}
-//# sourceMappingURL=role-resolver.js.map
+function a(e){return e.toLowerCase().replace(/[_\s]+/g,"-").replace(/[^a-z0-9-]/g,"")}function i(e,t){const n=a(t);return e.find(r=>a(r.name)===n)}function o(e,t){if(t.isFirstDrone){const n=e.find(r=>r.is_human_seat);if(n)return n}return e.find(n=>n.is_default)}export{i as matchRoleByName,o as pickDefaultRole,a as roleSlug};

package/dist/role-section.js

@@ -1,208 +1,8 @@
-// gh#496-A(b) + gh#513 — SINGLE canonical role-section parser, shared by BOTH
-// the client and the worker (the prior two-copy drift is eliminated). The
-// client render compression (`regen-format.ts`) splits role text with this
-// parser to decide which `… rationale:` sections to stub; the worker's
-// `getRoleRationale` (cubes.ts) resolves those stub headings and `sync-plan.ts`
-// diffs role sections — all import THIS module, so heading derivation
-// (sans-colon, isLabelLine rules) is identical by construction (no parity
-// test needed; agreement is structural).
-//
-// The worker imports this via `../client/src/role-section` (mirrors the
-// existing `workers/mcp-server.ts → ../client/src/templates` precedent). KEEP
-// THIS MODULE SELF-CONTAINED (no runtime imports) so the worker bundle
-// resolves it cleanly; the client tsconfig `rootDir: ./src` also requires the
-// shared canonical to live under `client/src/`.
-/**
- * Test whether a single line is a plain-label section heading.
- *
- * Rules (deliberately narrow to avoid false positives against prose
- * that merely contains a colon):
- *   - no leading whitespace (label lines start at column 0);
- *   - the line ends with exactly one `:`;
- *   - the text before the colon is non-empty, contains no other `:`,
- *     and is "short" (≤ 60 chars) — long colon-terminated prose lines
- *     are not labels;
- *   - the label is not a markdown emphasis run (does not start with
- *     `*`, `-`, `#`, `>` or backtick) — those are list/markdown lines,
- *     not plain labels (the woven `**Dense communication discipline:**`
- *     constant headings must NOT be treated as section boundaries).
- */
-export function isLabelLine(line) {
-    // Leading whitespace disqualifies (label lines are flush-left).
-    if (/^\s/.test(line))
-        return false;
-    if (!line.endsWith(':'))
-        return false;
-    const label = line.slice(0, -1);
-    if (label.length === 0)
-        return false;
-    if (label.length > 60)
-        return false;
-    // Exactly one colon total (the trailing one).
-    if (label.includes(':'))
-        return false;
-    // Markdown/list/quote/code lead-ins are not plain labels.
-    if (/^[*\-#>`]/.test(label))
-        return false;
-    return true;
-}
-/**
- * Parse role `detailed_description` text into ordered sections.
- *
- * The result always round-trips byte-identical through
- * `serializeSections`. An empty string yields a single empty preamble
- * section so callers always have a stable shape to address.
- */
-export function parseRoleSections(text) {
-    const sections = [];
-    const lines = text.split('\n');
-    // Reconstruct each line WITH its terminating newline so that the
-    // concatenation is lossless. `split('\n')` drops the separators; we
-    // re-append '\n' to every line except the last (which had no trailing
-    // newline in the source unless the source ended with one — in which
-    // case the final split element is '' and contributes nothing).
-    const lineWithSep = (idx) => idx < lines.length - 1 ? lines[idx] + '\n' : lines[idx];
-    let currentHeading = null;
-    let currentKind = 'preamble';
-    let currentBody = '';
-    let started = false;
-    const flush = () => {
-        sections.push({ heading: currentHeading, kind: currentKind, body: currentBody });
-    };
-    for (let i = 0; i < lines.length; i++) {
-        const raw = lines[i];
-        if (isLabelLine(raw)) {
-            // Close the in-progress section (preamble or previous label) and
-            // open a new label section headed by this line.
-            flush();
-            currentHeading = raw.slice(0, -1).trim();
-            currentKind = 'label';
-            currentBody = lineWithSep(i);
-            started = true;
-        }
-        else {
-            currentBody += lineWithSep(i);
-            started = true;
-        }
-    }
-    // Always emit the final in-progress section. For empty input this is a
-    // single empty preamble (started === false, currentBody === '').
-    if (started || sections.length === 0) {
-        flush();
-    }
-    return sections;
-}
-/** Concatenate sections back into the original field text. */
-export function serializeSections(sections) {
-    return sections.map((s) => s.body).join('');
-}
-function normalizeHeading(value) {
-    return value.trim().toLowerCase();
-}
-/**
- * Build the body for a freshly inserted/replaced label section from a
- * heading + caller-supplied body text.
- *
- * The heading line is rendered as `<heading>:` on its own line. The
- * caller's `body` is the text BELOW the heading. We guarantee the
- * section body ends with a single trailing newline so adjacent sections
- * stay separated when re-serialized (matching how real role text
- * separates label sections with blank lines is the caller's choice via
- * their body text; we only ensure the structural newline).
- */
-function renderLabelSection(heading, body) {
-    const headingLine = `${heading.trim()}:\n`;
-    if (body === '')
-        return headingLine;
-    // Ensure the body ends with a newline so the next section's heading
-    // starts on its own line.
-    const normalizedBody = body.endsWith('\n') ? body : body + '\n';
-    return headingLine + normalizedBody;
-}
-/**
- * Guarantee the section at `idx` ends in a newline before a new section
- * heading is glued on after it.
- *
- * Real role `detailed_description` text (every template role) ends WITHOUT
- * a trailing newline — it closes on the woven `${...DISCIPLINE}` constant.
- * Appending a `<heading>:` line directly onto such text would fuse the
- * heading onto the prior section's last line, so the heading is no longer
- * a flush-left label and the inserted section is LOST on re-parse. Adding
- * the structural newline here keeps the inserted heading on its own line.
- *
- * No-ops when the preceding body is empty (an empty preamble needs no
- * separator) or already ends in '\n' (preserves the already-correct case
- * byte-for-byte).
- */
-function ensureTrailingNewline(sections, idx) {
-    if (idx < 0 || idx >= sections.length)
-        return;
-    const prev = sections[idx];
-    if (prev.body !== '' && !prev.body.endsWith('\n')) {
-        sections[idx] = { ...prev, body: prev.body + '\n' };
-    }
-}
-/**
- * Apply a single section-level patch to role text, returning the new
- * full field text. Every other byte is preserved.
- *
- *   - replace: overwrite the matched section's body with a re-rendered
- *     `<heading>:\n<body>` block. The heading match is case-insensitive
- *     on the label; the re-rendered heading uses the supplied casing.
- *   - insert: add a new label section. Placed after the section named by
- *     `after` (case-insensitive), or appended at the end when `after` is
- *     omitted/null. Rejects if a section with the same heading already
- *     exists (use replace instead).
- *   - delete: drop the matched section entirely.
- *
- * Throws when the target section is missing (replace/delete) or already
- * present (insert), or when `after` does not resolve.
- */
-export function patchRoleSectionText(text, op) {
-    const sections = parseRoleSections(text);
-    const targetKey = normalizeHeading(op.heading);
-    if (op.action === 'replace') {
-        const idx = sections.findIndex((s) => s.kind === 'label' && s.heading != null && normalizeHeading(s.heading) === targetKey);
-        if (idx === -1) {
-            throw new Error(`Role section "${op.heading}" not found. Use action="insert" to add it.`);
-        }
-        sections[idx] = {
-            heading: op.heading.trim(),
-            kind: 'label',
-            body: renderLabelSection(op.heading, op.body),
-        };
-        return serializeSections(sections);
-    }
-    if (op.action === 'delete') {
-        const idx = sections.findIndex((s) => s.kind === 'label' && s.heading != null && normalizeHeading(s.heading) === targetKey);
-        if (idx === -1) {
-            throw new Error(`Role section "${op.heading}" not found.`);
-        }
-        sections.splice(idx, 1);
-        return serializeSections(sections);
-    }
-    // insert
-    const exists = sections.some((s) => s.kind === 'label' && s.heading != null && normalizeHeading(s.heading) === targetKey);
-    if (exists) {
-        throw new Error(`Role section "${op.heading}" already exists. Use action="replace" to overwrite it.`);
-    }
-    const newSection = {
-        heading: op.heading.trim(),
-        kind: 'label',
-        body: renderLabelSection(op.heading, op.body),
-    };
-    if (op.after == null) {
-        ensureTrailingNewline(sections, sections.length - 1);
-        sections.push(newSection);
-        return serializeSections(sections);
-    }
-    const afterKey = normalizeHeading(op.after);
-    const afterIdx = sections.findIndex((s) => s.kind === 'label' && s.heading != null && normalizeHeading(s.heading) === afterKey);
-    if (afterIdx === -1) {
-        throw new Error(`Cannot insert after section "${op.after}" — it does not exist.`);
-    }
-    ensureTrailingNewline(sections, afterIdx);
-    sections.splice(afterIdx + 1, 0, newSection);
-    return serializeSections(sections);
-}
-//# sourceMappingURL=role-section.js.map
+function b(t){if(/^\s/.test(t)||!t.endsWith(":"))return!1;const e=t.slice(0,-1);return!(e.length===0||e.length>60||e.includes(":")||/^[*\-#>`]/.test(e))}function w(t){const e=[],n=t.split(`
+`),l=i=>i<n.length-1?n[i]+`
+`:n[i];let f=null,s="preamble",d="",a=!1;const r=()=>{e.push({heading:f,kind:s,body:d})};for(let i=0;i<n.length;i++){const u=n[i];b(u)?(r(),f=u.slice(0,-1).trim(),s="label",d=l(i),a=!0):(d+=l(i),a=!0)}return(a||e.length===0)&&r(),e}function c(t){return t.map(e=>e.body).join("")}function o(t){return t.trim().toLowerCase()}function h(t,e){const n=`${t.trim()}:
+`;if(e==="")return n;const l=e.endsWith(`
+`)?e:e+`
+`;return n+l}function g(t,e){if(e<0||e>=t.length)return;const n=t[e];n.body!==""&&!n.body.endsWith(`
+`)&&(t[e]={...n,body:n.body+`
+`})}function y(t,e){const n=w(t),l=o(e.heading);if(e.action==="replace"){const r=n.findIndex(i=>i.kind==="label"&&i.heading!=null&&o(i.heading)===l);if(r===-1)throw new Error(`Role section "${e.heading}" not found. Use action="insert" to add it.`);return n[r]={heading:e.heading.trim(),kind:"label",body:h(e.heading,e.body)},c(n)}if(e.action==="delete"){const r=n.findIndex(i=>i.kind==="label"&&i.heading!=null&&o(i.heading)===l);if(r===-1)throw new Error(`Role section "${e.heading}" not found.`);return n.splice(r,1),c(n)}if(n.some(r=>r.kind==="label"&&r.heading!=null&&o(r.heading)===l))throw new Error(`Role section "${e.heading}" already exists. Use action="replace" to overwrite it.`);const s={heading:e.heading.trim(),kind:"label",body:h(e.heading,e.body)};if(e.after==null)return g(n,n.length-1),n.push(s),c(n);const d=o(e.after),a=n.findIndex(r=>r.kind==="label"&&r.heading!=null&&o(r.heading)===d);if(a===-1)throw new Error(`Cannot insert after section "${e.after}" \u2014 it does not exist.`);return g(n,a),n.splice(a+1,0,s),c(n)}export{b as isLabelLine,w as parseRoleSections,y as patchRoleSectionText,c as serializeSections};

package/dist/roster-render.js

@@ -1,96 +1,3 @@
-/**
- * Pure renderer for the `borg:roster` MCP tool output.
- *
- * Split out from `index.ts` so the T2.1 sender-side liveness probe
- * (the `awake`/`stale-since-X` column rendering when a `since` arg is
- * passed) can be unit-tested without spinning up the MCP server. Same
- * pure-function + injected-`humanAgo` pattern as `stream-status.ts`.
- *
- * Two modes:
- *   - No `since` provided: classic roster — one line per drone with
- *     label, role, and `last seen` relative time.
- *   - `since` provided: each line additionally carries an `awake`
- *     marker if the drone's `last_seen` is after the resolved
- *     timestamp, otherwise a `stale-since-<relative>` marker derived
- *     from the resolved timestamp the server echoed back.
- */
-/**
- * gh#503 — render-layer display labels for the wake-path wire enum.
- *
- * The gh#406 SLI MEASURES a streak of unanswered directed challenges; it
- * cannot confirm a genuinely broken wake path ("deaf") — a seat that is
- * alive but idle-and-text-only looks identical past the SLA. So the
- * roster shows the measured-confidence label, not the unconfirmed verdict:
- *   degraded (1 miss)  → `unverified`   (signal seen, not yet corroborated)
- *   deaf     (2+ miss) → `unresponsive` (no response past the SLA)
- *
- * The wire enum VALUES (`live`/`degraded`/`deaf`), computed server-side by
- * `wakePathFromStreak`, are intentionally UNCHANGED — this is a display-only
- * relabel within gh#503's copy-only scope (renaming the enum would be a
- * wire + schema change). An operator who wants a confirmed read cross-checks
- * `borg:stream-status` on the affected seat. Unknown wire values fall back
- * to the raw value so a newer server can't break an older client's roster.
- */
-const WAKE_PATH_DISPLAY = {
-    degraded: 'unverified',
-    deaf: 'unresponsive',
-};
-export function formatRoleAgentLabel(roleName, agentKind) {
-    return agentKind ? `${roleName}, ${agentKind}` : roleName;
-}
-export function renderRoster(inputs) {
-    const { cubeName, drones, roles, resolvedSince, humanAgo } = inputs;
-    const roleById = new Map();
-    for (const r of roles)
-        roleById.set(r.id, r);
-    const lines = [];
-    lines.push(`# Drones in cube: ${cubeName}`);
-    lines.push('');
-    if (resolvedSince) {
-        // Surface the liveness-probe context so the reader knows what the
-        // `awake`/`stale-since-X` column is measured against.
-        lines.push(`_Liveness probe since ${resolvedSince} (${humanAgo(resolvedSince)}). \`awake\` = drone posted to the cube log after that point._`);
-        lines.push('');
-    }
-    if (!drones.length) {
-        lines.push('_(no drones connected)_');
-        return lines.join('\n');
-    }
-    for (const d of drones) {
-        const role = roleById.get(d.role_id);
-        const roleName = role?.name ?? 'unknown';
-        const roleLabel = formatRoleAgentLabel(roleName, d.agent_kind);
-        const lastSeen = humanAgo(d.last_seen);
-        const wakePathMarker = d.wake_path && d.wake_path !== 'live'
-            ? ` · \`wake-path:${WAKE_PATH_DISPLAY[d.wake_path] ?? d.wake_path}\``
-            : '';
-        const wakePathClassMarker = d.wake_path_alert_class && d.wake_path_alert_class !== 'independent'
-            ? ` · \`wake-path-class:${d.wake_path_alert_class}\``
-            : '';
-        const regenCountMarker = typeof d.regen_count === 'number' ? ` · \`regen-count:${d.regen_count}\`` : '';
-        if (resolvedSince) {
-            // T2.1 awake/stale column. `seen_since === true` → drone called a
-            // tool after the resolved timestamp; treat as awake. False or
-            // missing → stale. Missing should not happen when the server
-            // echoed a since, but defending against a shape mismatch is
-            // cheap and matches the renderer's no-server-assumptions
-            // discipline established in stream-status.ts.
-            //
-            // Per drone-4's polish NIT on the original T2.1 ship: the marker
-            // is just `stale` (not `stale-since-<relative>`) because the
-            // header already anchors the reference point and per-row "since
-            // when" would be identical across all stale rows in a single
-            // probe call — pure redundancy. The per-row `last seen X ago`
-            // field carries the diagnostic detail for "how stale is this
-            // particular drone."
-            const isAwake = d.seen_since === true;
-            const marker = isAwake ? '`awake`' : '`stale`';
-            lines.push(`- **${d.label}** (${roleLabel}) — last seen ${lastSeen} · ${marker}${regenCountMarker}${wakePathMarker}${wakePathClassMarker}`);
-        }
-        else {
-            lines.push(`- **${d.label}** (${roleLabel}) — last seen ${lastSeen}${regenCountMarker}${wakePathMarker}${wakePathClassMarker}`);
-        }
-    }
-    return lines.join('\n');
-}
-//# sourceMappingURL=roster-render.js.map
+const d={degraded:"unverified",deaf:"unresponsive"};function w(t,s){return s?`${t}, ${s}`:t}function b(t){const{cubeName:s,drones:o,roles:h,resolvedSince:a,humanAgo:r}=t,c=new Map;for(const e of h)c.set(e.id,e);const n=[];if(n.push(`# Drones in cube: ${s}`),n.push(""),a&&(n.push(`_Liveness probe since ${a} (${r(a)}). \`awake\` = drone posted to the cube log after that point._`),n.push("")),!o.length)return n.push("_(no drones connected)_"),n.join(`
+`);for(const e of o){const k=c.get(e.role_id)?.name??"unknown",l=w(k,e.agent_kind),p=r(e.last_seen),u=e.wake_path&&e.wake_path!=="live"?` \xB7 \`wake-path:${d[e.wake_path]??e.wake_path}\``:"",_=e.wake_path_alert_class&&e.wake_path_alert_class!=="independent"?` \xB7 \`wake-path-class:${e.wake_path_alert_class}\``:"",i=typeof e.regen_count=="number"?` \xB7 \`regen-count:${e.regen_count}\``:"";if(a){const $=e.seen_since===!0?"`awake`":"`stale`";n.push(`- **${e.label}** (${l}) \u2014 last seen ${p} \xB7 ${$}${i}${u}${_}`)}else n.push(`- **${e.label}** (${l}) \u2014 last seen ${p}${i}${u}${_}`)}return n.join(`
+`)}export{w as formatRoleAgentLabel,b as renderRoster};