@spinabot/brigade 0.1.2 → 1.0.1

package/dist/agents/skills/org-access.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Org-hierarchy skill visibility (Primitive #5 × the virtual-office layer).
+ *
+ * Resolves which OTHER agents' workspace skills a given agent may see, by
+ * walking the org graph's `reportsTo` relationships. Off unless
+ * `skills.orgAccess.enabled` is set. Uses the POLICY graph (`deriveOrgGraph`),
+ * so an `org.a2a.mode: "explicit"` install — where the operator opted into the
+ * flat allow-matrix instead of graph edges — turns this off, exactly like A2A.
+ *
+ * The agent's OWN skills never come through here (they're discovered from its
+ * workspace root directly); this is purely the cross-agent surface.
+ */
+import type { BrigadeConfig, BrigadeSkillsOrgAccessConfig } from "../../config/io.js";
+/**
+ * The set of other agent ids whose workspace skills `agentId` may see.
+ *
+ *   - `down` (default): agents that report to `agentId` (its subordinates).
+ *     Direct reports only unless `transitive` (then the whole sub-tree).
+ *   - `up`: `agentId`'s manager chain (direct manager only unless `transitive`).
+ *   - `both`: union of the two.
+ *
+ * Returns `[]` when the feature is off, no policy graph exists (legacy /
+ * explicit mode), the agent isn't an org member, or it has no eligible peers.
+ * The agent's own id is never included.
+ */
+export declare function resolveOrgVisibleSkillAgents(config: BrigadeConfig, agentId: string | undefined, access: BrigadeSkillsOrgAccessConfig | undefined): string[];
+//# sourceMappingURL=org-access.d.ts.map

package/dist/agents/skills/org-access.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"org-access.d.ts","sourceRoot":"","sources":["../../../src/agents/skills/org-access.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAC;AAQtF;;;;;;;;;;;GAWG;AACH,wBAAgB,4BAA4B,CAC3C,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,MAAM,EAAE,4BAA4B,GAAG,SAAS,GAC9C,MAAM,EAAE,CAqCV"}

package/dist/agents/skills/org-access.js

@@ -0,0 +1,87 @@
+/**
+ * Org-hierarchy skill visibility (Primitive #5 × the virtual-office layer).
+ *
+ * Resolves which OTHER agents' workspace skills a given agent may see, by
+ * walking the org graph's `reportsTo` relationships. Off unless
+ * `skills.orgAccess.enabled` is set. Uses the POLICY graph (`deriveOrgGraph`),
+ * so an `org.a2a.mode: "explicit"` install — where the operator opted into the
+ * flat allow-matrix instead of graph edges — turns this off, exactly like A2A.
+ *
+ * The agent's OWN skills never come through here (they're discovered from its
+ * workspace root directly); this is purely the cross-agent surface.
+ */
+import { deriveOrgGraph } from "../org/derive-graph.js";
+const CHAIN_GUARD_MAX = 64;
+/**
+ * The set of other agent ids whose workspace skills `agentId` may see.
+ *
+ *   - `down` (default): agents that report to `agentId` (its subordinates).
+ *     Direct reports only unless `transitive` (then the whole sub-tree).
+ *   - `up`: `agentId`'s manager chain (direct manager only unless `transitive`).
+ *   - `both`: union of the two.
+ *
+ * Returns `[]` when the feature is off, no policy graph exists (legacy /
+ * explicit mode), the agent isn't an org member, or it has no eligible peers.
+ * The agent's own id is never included.
+ */
+export function resolveOrgVisibleSkillAgents(config, agentId, access) {
+    if (!access?.enabled)
+        return [];
+    const id = (agentId ?? "").trim();
+    if (!id)
+        return [];
+    const graph = deriveOrgGraph(config);
+    if (!graph)
+        return [];
+    const members = graph.members;
+    if (!members[id])
+        return []; // the agent isn't part of the org
+    const direction = access.direction ?? "down";
+    const transitive = access.transitive === true;
+    const visible = new Set();
+    if (direction === "down" || direction === "both") {
+        for (const candidate of Object.keys(members)) {
+            if (candidate === id)
+                continue;
+            if (reportsToReaches(members, candidate, id, transitive))
+                visible.add(candidate);
+        }
+    }
+    if (direction === "up" || direction === "both") {
+        // Walk the agent's own manager chain upward.
+        const guard = new Set([id]);
+        let cursor = members[id]?.reportsTo ?? null;
+        let steps = 0;
+        while (cursor && !guard.has(cursor) && steps < CHAIN_GUARD_MAX) {
+            if (members[cursor])
+                visible.add(cursor);
+            guard.add(cursor);
+            if (!transitive)
+                break; // direct manager only
+            cursor = members[cursor]?.reportsTo ?? null;
+            steps += 1;
+        }
+    }
+    visible.delete(id);
+    return [...visible].sort();
+}
+/** True when `candidate`'s reportsTo chain reaches `target` (one hop unless transitive). */
+function reportsToReaches(members, candidate, target, transitive) {
+    const direct = members[candidate]?.reportsTo ?? null;
+    if (direct === target)
+        return true;
+    if (!transitive)
+        return false;
+    const guard = new Set([candidate]);
+    let cursor = direct;
+    let steps = 0;
+    while (cursor && !guard.has(cursor) && steps < CHAIN_GUARD_MAX) {
+        if (cursor === target)
+            return true;
+        guard.add(cursor);
+        cursor = members[cursor]?.reportsTo ?? null;
+        steps += 1;
+    }
+    return false;
+}
+//# sourceMappingURL=org-access.js.map

package/dist/agents/skills/org-access.js.map

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

package/dist/agents/skills/skill-consolidate.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Skill consolidation — the UMBRELLA-BUILDING half of skill self-improvement
+ * (the LLM consolidation pass, and the skill
+ * analogue of memory `consolidate.ts`). The aging curator (skill-curator.ts)
+ * prunes UNUSED skills; this merges OVERLAPPING ones, so the auto-learned library
+ * stays a small set of class-level skills instead of a sprawl of near-duplicate
+ * one-session entries.
+ *
+ * Shape (mirrors memory consolidate.ts): ONE LLM call over the agent's
+ * agent-created skills (name + body excerpt) → a structured plan of MERGES (fold
+ * sibling skills into a keeper, appending a labeled section) and PRUNES (archive
+ * an obsolete skill). Apply reuses the Inc-4 `appendSkillSection` (merge) + Inc-2
+ * `archiveSkill` (sibling/prune) primitives — REVERSIBLE, never deletes.
+ * Owner-workspace only; throttled by the same window as memory consolidation.
+ *
+ * SAFETY: only agent-created, non-pinned, non-archived skills are touched; a
+ * keeper MUST exist among them and SURVIVES (hallucinated keepers rejected); a
+ * name is touched at most once (no keeper-also-folded); never archives the last
+ * skill. Discovery reads the local FS (authoritative both modes), so a merge/
+ * archive takes effect on the agent's next turn. (NOTE: the convex skills-TABLE
+ * mirror isn't updated on archive/merge — shared follow-up with the curator;
+ * discovery is unaffected since it's local-FS-authoritative.)
+ */
+import { type MakeExtractionLlmArgs } from "../memory/extract.js";
+export declare const SKILL_CONSOLIDATION_PROMPT = "You are a skill-library curator for a personal AI assistant.\nBelow are the assistant's AUTO-LEARNED skills, each with its name and a body excerpt.\nGoal: keep the library a SMALL set of CLASS-LEVEL skills, not a sprawl of near-duplicate one-session entries.\n\nFind skills that OVERLAP \u2014 same class of task, redundant, or one is a narrow special case of another.\nFor each overlapping cluster pick the BROADEST, best skill as the KEEPER and FOLD the others into it.\n\nBe CONSERVATIVE. Only merge skills that genuinely cover the SAME class of task; distinct tasks stay separate.\nNEVER merge everything into one. When in doubt, leave them alone.\n\nReturn STRICT JSON only \u2014 no prose, no fences:\n{\"merges\":[{\"keeper\":\"<existing skill name>\",\"fold\":[\"<name>\", ...],\"section\":\"## <heading>\\n\\n<1-3 lines capturing what the folded skills add that the keeper lacks>\"}],\"prunes\":[\"<name of a clearly obsolete/empty skill to archive>\", ...]}\n- \"keeper\" MUST be one of the skills listed (never invent a name); it survives.\n- \"fold\" skills are archived after their essence is appended to the keeper via \"section\".\n- A skill may appear in at most ONE merge, and never as both keeper and fold.\n- Use {\"merges\":[],\"prunes\":[]} if nothing should change.";
+export interface SkillMerge {
+    keeper: string;
+    fold: string[];
+    section: string;
+}
+export interface SkillConsolidationPlan {
+    merges: SkillMerge[];
+    prunes: string[];
+}
+/** Parse the consolidation reply. Never throws; malformed → empty plan. Scans every
+ *  top-level balanced `{...}` and uses the FIRST that carries a `merges` or `prunes`
+ *  array — robust to prose-wrapped JSON + a leading stray object (mirrors how
+ *  `parseConsolidationArchive` / `parseExtractionReply` were hardened; a greedy
+ *  first-to-last brace match would span unrelated brace groups and silently no-op). */
+export declare function parseSkillConsolidation(text: string): SkillConsolidationPlan;
+export type SkillConsolidationLlm = (skillsBlock: string) => Promise<string>;
+export interface SkillConsolidationResult {
+    ran: boolean;
+    /** When true, the plan was computed + reported but NOT applied (preview). */
+    dryRun: boolean;
+    merged: number;
+    pruned: number;
+    considered: number;
+    /** Applied merges (keeper ← folded names) — the rename-map for "where did my skill go". */
+    appliedMerges: Array<{
+        keeper: string;
+        folded: string[];
+    }>;
+    /** Names archived as obsolete prunes. */
+    appliedPrunes: string[];
+    /** Full-library snapshot taken before applying (rollback point); undefined for a no-op/dry-run. */
+    snapshotPath?: string;
+    /** The LLM plan (surfaced for dry-run preview + the run report). */
+    plan: SkillConsolidationPlan;
+}
+/**
+ * Run one consolidation pass over an agent's skills root. No-op below `minSkills`.
+ * Validates the LLM plan hard (keeper exists + survives; each name touched once;
+ * never archives the last skill) before applying. Best-effort.
+ */
+export declare function runSkillConsolidation(args: {
+    skillsRoot: string;
+    llm: SkillConsolidationLlm;
+    minSkills?: number;
+    now?: number;
+    /** Preview only — compute + report the plan, apply nothing (no snapshot, no mutation). */
+    dryRun?: boolean;
+}): Promise<SkillConsolidationResult>;
+/** The consolidation distiller — `makeIsolatedLlm` with the prompt pinned. */
+export declare function makeSkillConsolidationLlm(args: MakeExtractionLlmArgs): SkillConsolidationLlm;
+//# sourceMappingURL=skill-consolidate.d.ts.map

package/dist/agents/skills/skill-consolidate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-consolidate.d.ts","sourceRoot":"","sources":["../../../src/agents/skills/skill-consolidate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAMH,OAAO,EAAoC,KAAK,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAWpG,eAAO,MAAM,0BAA0B,4wCAemB,CAAC;AAE3D,MAAM,WAAW,UAAU;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CAChB;AACD,MAAM,WAAW,sBAAsB;IACtC,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,MAAM,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;;uFAIuF;AACvF,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,sBAAsB,CA+B5E;AAED,MAAM,MAAM,qBAAqB,GAAG,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAE7E,MAAM,WAAW,wBAAwB;IACxC,GAAG,EAAE,OAAO,CAAC;IACb,6EAA6E;IAC7E,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,2FAA2F;IAC3F,aAAa,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IAC3D,yCAAyC;IACzC,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,mGAAmG;IACnG,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oEAAoE;IACpE,IAAI,EAAE,sBAAsB,CAAC;CAC7B;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IACjD,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,qBAAqB,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,0FAA0F;IAC1F,MAAM,CAAC,EAAE,OAAO,CAAC;CACjB,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAgJpC;AA0BD,8EAA8E;AAC9E,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,qBAAqB,GAAG,qBAAqB,CAE5F"}

package/dist/agents/skills/skill-consolidate.js

@@ -0,0 +1,264 @@
+/**
+ * Skill consolidation — the UMBRELLA-BUILDING half of skill self-improvement
+ * (the LLM consolidation pass, and the skill
+ * analogue of memory `consolidate.ts`). The aging curator (skill-curator.ts)
+ * prunes UNUSED skills; this merges OVERLAPPING ones, so the auto-learned library
+ * stays a small set of class-level skills instead of a sprawl of near-duplicate
+ * one-session entries.
+ *
+ * Shape (mirrors memory consolidate.ts): ONE LLM call over the agent's
+ * agent-created skills (name + body excerpt) → a structured plan of MERGES (fold
+ * sibling skills into a keeper, appending a labeled section) and PRUNES (archive
+ * an obsolete skill). Apply reuses the Inc-4 `appendSkillSection` (merge) + Inc-2
+ * `archiveSkill` (sibling/prune) primitives — REVERSIBLE, never deletes.
+ * Owner-workspace only; throttled by the same window as memory consolidation.
+ *
+ * SAFETY: only agent-created, non-pinned, non-archived skills are touched; a
+ * keeper MUST exist among them and SURVIVES (hallucinated keepers rejected); a
+ * name is touched at most once (no keeper-also-folded); never archives the last
+ * skill. Discovery reads the local FS (authoritative both modes), so a merge/
+ * archive takes effect on the agent's next turn. (NOTE: the convex skills-TABLE
+ * mirror isn't updated on archive/merge — shared follow-up with the curator;
+ * discovery is unaffected since it's local-FS-authoritative.)
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { createSubsystemLogger } from "../../logging/subsystem-logger.js";
+import { balancedObjects, makeIsolatedLlm } from "../memory/extract.js";
+import { appendSkillSection } from "../tools/manage-skill-tool.js";
+import { archiveSkill, skillsSnapshotsRoot, snapshotSkillsRoot } from "./skill-curator.js";
+import { listCurationCandidates, recordSkillPatched } from "./skill-usage.js";
+const log = createSubsystemLogger("skills/consolidate");
+/** Below this many candidates there's nothing worth an LLM call. */
+const MIN_SKILLS_TO_CONSOLIDATE = 4;
+const BODY_EXCERPT_CHARS = 400;
+export const SKILL_CONSOLIDATION_PROMPT = `You are a skill-library curator for a personal AI assistant.
+Below are the assistant's AUTO-LEARNED skills, each with its name and a body excerpt.
+Goal: keep the library a SMALL set of CLASS-LEVEL skills, not a sprawl of near-duplicate one-session entries.
+
+Find skills that OVERLAP — same class of task, redundant, or one is a narrow special case of another.
+For each overlapping cluster pick the BROADEST, best skill as the KEEPER and FOLD the others into it.
+
+Be CONSERVATIVE. Only merge skills that genuinely cover the SAME class of task; distinct tasks stay separate.
+NEVER merge everything into one. When in doubt, leave them alone.
+
+Return STRICT JSON only — no prose, no fences:
+{"merges":[{"keeper":"<existing skill name>","fold":["<name>", ...],"section":"## <heading>\\n\\n<1-3 lines capturing what the folded skills add that the keeper lacks>"}],"prunes":["<name of a clearly obsolete/empty skill to archive>", ...]}
+- "keeper" MUST be one of the skills listed (never invent a name); it survives.
+- "fold" skills are archived after their essence is appended to the keeper via "section".
+- A skill may appear in at most ONE merge, and never as both keeper and fold.
+- Use {"merges":[],"prunes":[]} if nothing should change.`;
+/** Parse the consolidation reply. Never throws; malformed → empty plan. Scans every
+ *  top-level balanced `{...}` and uses the FIRST that carries a `merges` or `prunes`
+ *  array — robust to prose-wrapped JSON + a leading stray object (mirrors how
+ *  `parseConsolidationArchive` / `parseExtractionReply` were hardened; a greedy
+ *  first-to-last brace match would span unrelated brace groups and silently no-op). */
+export function parseSkillConsolidation(text) {
+    const empty = { merges: [], prunes: [] };
+    if (!text)
+        return empty;
+    for (const block of balancedObjects(text)) {
+        let parsed;
+        try {
+            parsed = JSON.parse(block);
+        }
+        catch {
+            continue;
+        }
+        if (!Array.isArray(parsed.merges) && !Array.isArray(parsed.prunes))
+            continue;
+        const merges = [];
+        if (Array.isArray(parsed.merges)) {
+            for (const m of parsed.merges) {
+                if (!m || typeof m !== "object")
+                    continue;
+                const mm = m;
+                if (typeof mm.keeper !== "string" || !mm.keeper.trim())
+                    continue;
+                if (typeof mm.section !== "string" || !mm.section.trim())
+                    continue;
+                const fold = Array.isArray(mm.fold)
+                    ? mm.fold.filter((x) => typeof x === "string" && x.trim().length > 0).map((s) => s.trim())
+                    : [];
+                if (fold.length === 0)
+                    continue;
+                merges.push({ keeper: mm.keeper.trim(), fold, section: mm.section });
+            }
+        }
+        const prunes = Array.isArray(parsed.prunes)
+            ? parsed.prunes.filter((x) => typeof x === "string" && x.trim().length > 0).map((s) => s.trim())
+            : [];
+        return { merges, prunes };
+    }
+    return empty;
+}
+/**
+ * Run one consolidation pass over an agent's skills root. No-op below `minSkills`.
+ * Validates the LLM plan hard (keeper exists + survives; each name touched once;
+ * never archives the last skill) before applying. Best-effort.
+ */
+export async function runSkillConsolidation(args) {
+    const now = args.now ?? Date.now();
+    const dryRun = args.dryRun === true;
+    const emptyPlan = { merges: [], prunes: [] };
+    const notRun = (considered) => ({
+        ran: false,
+        dryRun,
+        merged: 0,
+        pruned: 0,
+        considered,
+        appliedMerges: [],
+        appliedPrunes: [],
+        plan: emptyPlan,
+    });
+    const candidates = listCurationCandidates(args.skillsRoot, now).filter((c) => !c.record.pinned && c.record.state !== "archived");
+    const min = args.minSkills ?? MIN_SKILLS_TO_CONSOLIDATE;
+    if (candidates.length < min) {
+        return notRun(candidates.length);
+    }
+    const block = candidates
+        .map((c) => {
+        const file = path.join(args.skillsRoot, c.name, "SKILL.md");
+        let excerpt = "";
+        try {
+            excerpt = fs
+                .readFileSync(file, "utf8")
+                .replace(/^---[\s\S]*?\n---\n/, "") // drop frontmatter
+                .trim()
+                .slice(0, BODY_EXCERPT_CHARS);
+        }
+        catch {
+            /* unreadable → name only */
+        }
+        return `### ${c.name}\n${excerpt}`;
+    })
+        .join("\n\n");
+    let reply = "";
+    try {
+        reply = await args.llm(block);
+    }
+    catch (err) {
+        log.warn("skill consolidation llm failed", { error: err instanceof Error ? err.message : String(err) });
+        return notRun(candidates.length);
+    }
+    const plan = parseSkillConsolidation(reply);
+    // DRY RUN — surface the plan + write a report, change NOTHING (no snapshot, no
+    // mutation). Lets an operator preview a pass before trusting it live.
+    if (dryRun) {
+        writeConsolidationReport(args.skillsRoot, now, {
+            dryRun: true,
+            considered: candidates.length,
+            plan,
+            appliedMerges: [],
+            appliedPrunes: [],
+        });
+        return { ran: true, dryRun: true, merged: 0, pruned: 0, considered: candidates.length, appliedMerges: [], appliedPrunes: [], plan };
+    }
+    const names = new Set(candidates.map((c) => c.name));
+    const touched = new Set(); // a name is merged/pruned at most once
+    const appliedMerges = [];
+    const appliedPrunes = [];
+    let merged = 0;
+    let pruned = 0;
+    // SNAPSHOT before any mutation — a keeper's appended section is NOT per-skill
+    // reversible (archiveSkill only undoes the folds), so take a full-library
+    // rollback point first. Best-effort: a snapshot failure degrades to the
+    // per-fold archive reversibility, it does not block the pass.
+    let snapshotPath;
+    if (plan.merges.length > 0 || plan.prunes.length > 0) {
+        const snap = snapshotSkillsRoot(args.skillsRoot, now);
+        if (snap.ok)
+            snapshotPath = snap.path;
+        else
+            log.warn("skill consolidation snapshot failed; proceeding without a rollback point", { message: snap.message });
+    }
+    // Per-pass DESTRUCTION CAP — a single bad/hallucinated LLM reply must not gut the
+    // library in one pass (consolidation is reversible, but mass-archival is still
+    // disruptive). Generous floor so a small library can still fully umbrella-ify
+    // (e.g. 4→1), bounded fraction so a large library can't collapse in one pass.
+    const maxArchivable = Math.max(3, Math.floor(candidates.length * 0.6));
+    // MERGES — keeper must exist + be free; fold members must exist, differ from
+    // the keeper, and be free; never archive every candidate; respect the pass cap.
+    for (const m of plan.merges) {
+        if (!names.has(m.keeper) || touched.has(m.keeper))
+            continue;
+        const fold = m.fold.filter((f) => names.has(f) && f !== m.keeper && !touched.has(f));
+        if (fold.length === 0)
+            continue;
+        if (touched.size + fold.length + 1 > candidates.length)
+            continue; // never archive all
+        if (merged + pruned + fold.length > maxArchivable)
+            continue; // would exceed the pass cap
+        const keeperFile = path.join(args.skillsRoot, m.keeper, "SKILL.md");
+        const res = appendSkillSection(keeperFile, m.section);
+        if (!res.ok)
+            continue; // dedup / size-cap / missing → skip this merge
+        recordSkillPatched(args.skillsRoot, m.keeper, now);
+        touched.add(m.keeper);
+        const folded = [];
+        for (const f of fold) {
+            if (archiveSkill(args.skillsRoot, f, now).ok) {
+                touched.add(f);
+                merged += 1;
+                folded.push(f);
+            }
+        }
+        if (folded.length > 0)
+            appliedMerges.push({ keeper: m.keeper, folded });
+    }
+    // PRUNES — archive an obsolete skill; never a keeper / already-touched; never
+    // the last remaining skill.
+    for (const p of plan.prunes) {
+        if (merged + pruned >= maxArchivable)
+            break; // per-pass destruction cap
+        if (!names.has(p) || touched.has(p))
+            continue;
+        if (touched.size + 1 >= candidates.length)
+            break;
+        if (archiveSkill(args.skillsRoot, p, now).ok) {
+            touched.add(p);
+            pruned += 1;
+            appliedPrunes.push(p);
+        }
+    }
+    if (merged || pruned) {
+        log.info("skill consolidation", { merged, pruned, considered: candidates.length, snapshotPath });
+        writeConsolidationReport(args.skillsRoot, now, {
+            dryRun: false,
+            considered: candidates.length,
+            plan,
+            appliedMerges,
+            appliedPrunes,
+            ...(snapshotPath ? { snapshotPath } : {}),
+        });
+    }
+    return {
+        ran: true,
+        dryRun: false,
+        merged,
+        pruned,
+        considered: candidates.length,
+        appliedMerges,
+        appliedPrunes,
+        ...(snapshotPath ? { snapshotPath } : {}),
+        plan,
+    };
+}
+/** Persist a per-run consolidation report (JSON) under the snapshots root so an
+ *  operator can see what changed (or, for a dry-run, what WOULD change) and which
+ *  snapshot to roll back to. Best-effort — a report failure never blocks the pass. */
+function writeConsolidationReport(skillsRoot, now, report) {
+    try {
+        const root = skillsSnapshotsRoot(skillsRoot);
+        fs.mkdirSync(root, { recursive: true });
+        fs.writeFileSync(path.join(root, `report-${now}.json`), `${JSON.stringify({ at: now, ...report }, null, 2)}\n`, "utf8");
+    }
+    catch {
+        /* best-effort report */
+    }
+}
+/** The consolidation distiller — `makeIsolatedLlm` with the prompt pinned. */
+export function makeSkillConsolidationLlm(args) {
+    return makeIsolatedLlm(SKILL_CONSOLIDATION_PROMPT, args);
+}
+//# sourceMappingURL=skill-consolidate.js.map

package/dist/agents/skills/skill-consolidate.js.map

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

package/dist/agents/skills/skill-curator.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Skill curator — the maintenance half of skill self-improvement (Brigade-native
+ * via an automatic-transitions aging pass). Pure, no-LLM aging of
+ * AGENT-CREATED skills so the auto-learned library doesn't bloat:
+ *   active → stale    (no use for staleAfterDays)
+ *   stale  → archived (no use for archiveAfterDays; the dir is moved aside)
+ *   stale  → active   (used again → reactivated)
+ * Pinned skills are exempt; hand-authored skills (no agent record) are never
+ * touched. Archival is REVERSIBLE — the skill dir is moved to a sibling archive
+ * root, never deleted; `restoreSkill` moves it back.
+ *
+ * The use-signal is gathered OFF the hot path: `detectAndRecordSkillUses` scans a
+ * session's raw messages for a read of a skill's SKILL.md (Brigade's equivalent
+ * of a skill-view → use-bump flow — Brigade has no skill-view tool, so the
+ * model reads the body via the generic `read` tool and the path lands in the
+ * transcript).
+ */
+export declare const DEFAULT_STALE_AFTER_DAYS = 30;
+export declare const DEFAULT_ARCHIVE_AFTER_DAYS = 90;
+export interface CuratorCounts {
+    checked: number;
+    markedStale: number;
+    archived: number;
+    reactivated: number;
+}
+export interface RunSkillCuratorArgs {
+    skillsRoot: string;
+    staleAfterDays?: number;
+    archiveAfterDays?: number;
+    now?: number;
+}
+/**
+ * One pure aging pass over a skills root — the
+ * apply_automatic_transitions: anchor on lastUsedAt ?? createdAt; archive when
+ * the anchor predates archiveAfterDays; else mark stale at staleAfterDays; else
+ * reactivate a stale skill whose anchor is now fresh (it was used again). Pinned
+ * + hand-authored skills are never touched.
+ */
+export declare function runSkillCurator(args: RunSkillCuratorArgs): CuratorCounts;
+/** Sibling archive root — OUTSIDE the skills root, so discovery (which scans only
+ *  `<ws>/skills`) never surfaces an archived skill regardless of Pi's scan depth. */
+export declare function skillsArchiveRoot(skillsRoot: string): string;
+export interface ArchiveResult {
+    ok: boolean;
+    message: string;
+    dest?: string;
+}
+/**
+ * Move a skill directory aside to the sibling archive root and mark it archived.
+ * Reversible via {@link restoreSkill}; never deletes. A name collision in the
+ * archive gets a numeric suffix.
+ */
+export declare function archiveSkill(skillsRoot: string, name: string, now?: number): ArchiveResult;
+/** Move an archived skill back to the live root. Refuses if a live skill of that
+ *  name already exists (no silent clobber). */
+export declare function restoreSkill(skillsRoot: string, name: string, now?: number): ArchiveResult;
+/** Sibling snapshots root (parallel to `skills-archive/`). */
+export declare function skillsSnapshotsRoot(skillsRoot: string): string;
+/**
+ * Copy the ENTIRE skills root to a timestamped snapshot. Per-skill archive/restore
+ * can't undo a keeper's appended section (the merge writes into the keeper's
+ * SKILL.md), so a consolidation pass takes a full snapshot first for true
+ * reversibility. Best-effort; prunes to the last {@link MAX_SKILL_SNAPSHOTS}.
+ */
+export declare function snapshotSkillsRoot(skillsRoot: string, now?: number): {
+    ok: boolean;
+    path?: string;
+    message: string;
+};
+/**
+ * Roll the skills root back to a snapshot. Snapshots the CURRENT state FIRST so
+ * the rollback is itself undoable (matching the per-skill archive's reversibility
+ * posture), then replaces the live root with the snapshot's contents.
+ */
+export declare function restoreSkillsSnapshot(skillsRoot: string, snapshotPath: string, now?: number): {
+    ok: boolean;
+    message: string;
+};
+/**
+ * Detect which agent-created skills were USED in a session's messages and bump
+ * their use telemetry. "Used" = the model read the skill's `SKILL.md` (its path
+ * appears in the raw messages — read tool call/result). Off-hot-path: called
+ * from the gateway sweep with the same messages extraction sees. Path separators
+ * (incl. JSON-escaped Windows backslashes) are normalised so the match is
+ * platform-independent; the trailing `/SKILL.md` keeps a bare skill name in chat
+ * from counting as a use, and prevents one skill name prefixing another.
+ *
+ * Returns the skill names whose use was recorded.
+ */
+export declare function detectAndRecordSkillUses(skillsRoot: string, messages: unknown[], now?: number): string[];
+//# sourceMappingURL=skill-curator.d.ts.map

package/dist/agents/skills/skill-curator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-curator.d.ts","sourceRoot":"","sources":["../../../src/agents/skills/skill-curator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAmBH,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAC3C,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAE7C,MAAM,WAAW,aAAa;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;CACb;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,mBAAmB,GAAG,aAAa,CAsCxE;AAED;qFACqF;AACrF,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED,MAAM,WAAW,aAAa;IAC7B,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,MAAmB,GAAG,aAAa,CAgBtG;AAED;+CAC+C;AAC/C,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,MAAmB,GAAG,aAAa,CAiCtG;AAED,8DAA8D;AAC9D,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE9D;AAID;;;;;GAKG;AACH,wBAAgB,kBAAkB,CACjC,UAAU,EAAE,MAAM,EAClB,GAAG,GAAE,MAAmB,GACtB;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAuBjD;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACpC,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,GAAG,GAAE,MAAmB,GACtB;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAUlC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,GAAG,GAAE,MAAmB,GAAG,MAAM,EAAE,CAqBpH"}