@bli-cockpit/cli 0.2.279 → 0.2.280

package/dist/commands/ai-skills.js

@@ -0,0 +1,40 @@
+import { askAgentDoor, emitAgentDoor, failAgentDoor, openAgentDoor } from "./agent-door.js";
+import { writeLine } from "./cli-io.js";
+const TAG = "[ai-skills cli]";
+const READ_DEADLINE_MS = 55_000;
+/** The door's own query: only what the person asked for, so the door's defaults stay the door's. */
+export function aiSkillsQuery(command) {
+    const query = new URLSearchParams();
+    if (command.who)
+        query.set("who", command.who);
+    if (command.weeks !== undefined)
+        query.set("weeks", String(command.weeks));
+    if (command.week)
+        query.set("week", command.week);
+    return query.toString();
+}
+export async function runAiSkills(command, io) {
+    let door;
+    try {
+        door = await openAgentDoor("ai-skills", command, io);
+    }
+    catch (error) {
+        const detail = error instanceof Error ? error.message : "this machine is not paired with Tower";
+        writeLine(io.stderr, `${TAG} refused ${JSON.stringify({ reason: "not_paired" })}`);
+        if (command.json)
+            writeLine(io.stdout, JSON.stringify({ ok: false, error: "not_paired", detail }));
+        else
+            writeLine(io.stderr, detail);
+        return 1;
+    }
+    const asked = aiSkillsQuery(command);
+    const answer = await askAgentDoor(door, { path: asked ? `/api/ai-skills?${asked}` : "/api/ai-skills", method: "GET", label: "ai-skills read", timeoutMs: READ_DEADLINE_MS });
+    if (!answer.ok)
+        return failAgentDoor(door, TAG, answer.reason, answer.detail);
+    const body = answer.body;
+    writeLine(io.stderr, `${TAG} read answered ${JSON.stringify({ scope: body.scope, people: body.people.length, weeks: body.people[0]?.weeks.length ?? 0, sessions: body.sessions?.length ?? null })}`);
+    if (command.json)
+        return emitAgentDoor(door, body);
+    writeLine(io.stdout, body.text);
+    return 0;
+}

package/dist/commands/local-args-tower-ai-skills.js

@@ -0,0 +1,36 @@
+/**
+ * `cockpit ai-skills` argument parsing (BLI-23364).
+ *
+ *   cockpit ai-skills [--who <me|team|email|user-id>] [--weeks <n>] [--week <YYYY-MM-DD>] [--json]
+ *
+ * The six AI-skill scores per week over `GET /api/ai-skills` with this machine's device token. Who may see what is the
+ * database's rule and the door's refusal, not this parser's.
+ */
+import { optionalNonEmpty, optionalPositiveInteger, optionalUrl, parseNamedArgs } from "./local-arg-values.js";
+export function parseAiSkillsArgs(args) {
+    const values = parseNamedArgs(args, {
+        allowedFlags: ["--who", "--weeks", "--week", "--home", "--dashboard-url", "--json"],
+        valueFlags: ["--who", "--weeks", "--week", "--home", "--dashboard-url"],
+    });
+    if (values.positionals.length > 0) {
+        throw new Error("ai-skills takes no verb. Example: `cockpit ai-skills`, `cockpit ai-skills --weeks 12` or `cockpit ai-skills --who team`.");
+    }
+    const weeks = optionalPositiveInteger(values.flags.get("--weeks"), "--weeks");
+    if (weeks !== undefined && weeks > 26)
+        throw new Error("--weeks must be 26 or fewer.");
+    const week = optionalNonEmpty(values.flags.get("--week"));
+    if (week !== undefined && !/^\d{4}-\d{2}-\d{2}$/.test(week))
+        throw new Error("--week wants a Monday as YYYY-MM-DD (weeks run Monday to Sunday in UTC).");
+    const who = optionalNonEmpty(values.flags.get("--who"))?.trim();
+    if (week !== undefined && who === "team")
+        throw new Error("--week reads one person's sessions: use --who me or --who <email>.");
+    return {
+        kind: "ai-skills",
+        dashboardUrl: optionalUrl(values.flags.get("--dashboard-url")),
+        homeDir: optionalNonEmpty(values.flags.get("--home")),
+        json: values.booleans.has("--json"),
+        ...(who ? { who } : {}),
+        ...(weeks !== undefined ? { weeks } : {}),
+        ...(week !== undefined ? { week } : {}),
+    };
+}

package/dist/commands/local-args-tower.js

@@ -44,6 +44,7 @@ export { parseUsageArgs } from "./local-args-tower-usage.js";
 export { parseLogsArgs } from "./local-args-tower-logs.js";
 export { parseBrainArgs } from "./local-args-tower-brain.js";
 export { parseHitsArgs } from "./local-args-tower-hits.js";
+export { parseAiSkillsArgs } from "./local-args-tower-ai-skills.js";
 export { parseIntentionsArgs } from "./local-args-tower-intentions.js";
 export { parseWhoArgs } from "./local-args-tower-who.js";
 export { parsePeopleArgs } from "./local-args-tower-people.js";
@@ -54,6 +55,7 @@ export { parseImageArgs } from "./local-args-tower-image.js";
 export { parseCareersArgs } from './local-args-tower-careers.js';
 export { parseRenameArgs } from './local-args-tower-rename.js';
 export { parseGlossaryArgs } from "./glossary.js";
+export { parseSkillsArgs } from "./skills.js";
 export { parseSpendArgs } from "./spend.js";
 export { parsePushArgs } from "./push.js";
 export { parseCiArgs } from "./ci.js";

package/dist/commands/local-args.js

@@ -16,6 +16,7 @@
  * verbatim, no logic change.
  */
 import { parseGlossaryArgs } from "./glossary.js";
+import { parseSkillsArgs } from "./skills.js";
 import { parseSpendArgs } from "./spend.js";
 import { parsePushArgs } from "./push.js";
 import { parseRootsArgs } from "./roots.js";
@@ -23,7 +24,7 @@ import { parseSlackPrivacyArgs } from "./slack-privacy-args.js";
 import { parseMilestoneArgs } from "./local-args-tower-milestone.js";
 import { SURFACE_ALIASES } from "./local-help.js";
 import { parseAgentRulesArgs, parseAnalyzeArgs, parseAutostartArgs, parseBackfillArgs, parseCleanArgs, parseDoctorArgs, parseInstallArgs, parseLoginArgs, parseMemoryArgs, parseLogoutArgs, parseOnboardArgs, parseReleaseArgs, parseServeArgs, parseSessionsArgs, parseSourcesArgs, parseStartArgs, parseStatusArgs, parseSyncArgs, parseUpdateArgs, } from "./local-args-collector.js";
-import { parseCiArgs, parseDeliveryArgs, parsePrOutputArgs, parseAiSpendArgs, parseBriefArgs, parseCorrectArgs, parseDocsArgs, parseIssueArgs, parseJarvisArgs, parseMailArgs, parseCalArgs, parseModelArgs, parseMsgArgs, parseNotesArgs, parseOpsArgs, parseProjectArgs, parseModelsArgs, parseScoutArgs, parseGithubArgs, parseSearchArgs, parseSettingsArgs, parseSlackArgs, parseTeamArgs, parseWorkbookArgs, parseUsageArgs, parseSetupArgs, parseSpeedArgs, parseLogsArgs, parseBrainArgs, parseHitsArgs, parseIntentionsArgs, parseWhoArgs, parsePeopleArgs, parseApprovalsArgs, parseDrillsArgs, parseManagerArgs, parseImageArgs, parseCareersArgs, parseRenameArgs, } from "./local-args-tower.js";
+import { parseCiArgs, parseDeliveryArgs, parsePrOutputArgs, parseAiSpendArgs, parseBriefArgs, parseCorrectArgs, parseDocsArgs, parseIssueArgs, parseJarvisArgs, parseMailArgs, parseCalArgs, parseModelArgs, parseMsgArgs, parseNotesArgs, parseOpsArgs, parseProjectArgs, parseModelsArgs, parseScoutArgs, parseGithubArgs, parseSearchArgs, parseSettingsArgs, parseSlackArgs, parseTeamArgs, parseWorkbookArgs, parseUsageArgs, parseSetupArgs, parseSpeedArgs, parseLogsArgs, parseBrainArgs, parseHitsArgs, parseAiSkillsArgs, parseIntentionsArgs, parseWhoArgs, parsePeopleArgs, parseApprovalsArgs, parseDrillsArgs, parseManagerArgs, parseImageArgs, parseCareersArgs, parseRenameArgs, } from "./local-args-tower.js";
 // `normalizeUrl` has always been part of this module's surface — `local.ts` and
 // `local-auth.ts` import it from here — so it stays exported from this address
 // even though it now lives next door. The same goes for the four names the
@@ -88,6 +89,7 @@ const COMMAND_PARSERS = new Map([
     ["clean", (_command, rest) => parseCleanArgs(rest)],
     ["sources", (_command, rest) => parseSourcesArgs(rest)],
     ["glossary", (_command, rest) => parseGlossaryArgs(rest)],
+    ["skills", (_command, rest) => parseSkillsArgs(rest)], // BLI-23364 D: the Skill Library
     ["spend", (_command, rest) => parseSpendArgs(rest)],
     ["push", (_command, rest) => parsePushArgs(rest)],
     ["docs", (_command, rest) => parseDocsArgs(rest)],
@@ -108,6 +110,7 @@ const COMMAND_PARSERS = new Map([
     ["logs", (_command, rest) => parseLogsArgs(rest)],
     ["brain", (_command, rest) => parseBrainArgs(rest)],
     ["hits", (_command, rest) => parseHitsArgs(rest)],
+    ["ai-skills", (_command, rest) => parseAiSkillsArgs(rest)],
     ["intentions", (_command, rest) => parseIntentionsArgs(rest)],
     ["who", (_command, rest) => parseWhoArgs(rest)],
     ["people", (_command, rest) => parsePeopleArgs(rest)],

package/dist/commands/local-command-shapes-ai-skills.js

@@ -0,0 +1,5 @@
+/**
+ * `cockpit ai-skills` command shape (BLI-23364), beside `local-command-shapes-hits.ts` for the same reason:
+ * `local-command-shapes.ts` sits at the readability ceiling.
+ */
+export {};

package/dist/commands/local-help-commands.js

@@ -23,6 +23,7 @@ import { TOWER_OPS_COMMAND_HELP } from "./local-help-commands-tower-ops.js";
 /** One manual per collector command; the Tower nouns are spread in from their own file. */
 const COMMAND_HELP = new Map([
     ["glossary", ["Usage: cockpit glossary list|add <wrong> --to <name>|remove <wrong> [--json]", "Quote phrases. Removing a form prevents future corrections of it."]],
+    ["skills", ["Usage: cockpit skills library [--weeks <1-52>] [--json] | cockpit skills refresh [--weeks <1-104>] [--json]", "The Skill Library: every agent skill and command our GitHub repos define (name, description, repo, path, versions) with weekly use by person, from the sessions Tower already collects. Uses that match no scanned skill are listed as unmatched, never dropped. The first line is the coverage: repos scanned, skills, invocations matched of total. A member sees their own usage; a super_admin sees everyone's except an owner's. refresh scans the repos and recomputes the weekly totals now (super_admin only; a stale library also refreshes itself when read). MCP twins: skills_library, skills_refresh. Web: TEAM > Skills."]],
     ["push", ["Usage: cockpit push status | test [--dashboard-url <url>] [--json]", "Phone notifications. status lists your saved devices and whether the server has its push keys; test sends a test push to every saved device. Turn a phone on from Settings on the phone."]],
     ["spend", ["Usage: cockpit spend memory [--days 1|7|30] [--dashboard-url <url>] [--json]", "Spend by memory operation (write, recall, dream, update_forget, backfill, label, exam, predictor, people, who, intentions, salience, chat, other), ranked top first with list and real dollars, share, trend against the previous window, and how much of the real OpenAI bill the ledger explains. What it does not explain is shown as untagged. A super_admin reads it."]],
     ["roots", ["Usage: cockpit roots add <dir> [--allow-home-root] [--json]", "Approves a work directory, saves an approval receipt, and adds it to collection. Run cockpit doctor afterward."]],
@@ -275,6 +276,25 @@ const COMMAND_HELP = new Map([
     // BLI-10445: JARVIS, models, Scout and ops live in `local-help-commands-tower-ops.ts`;
     // slack, workbook, brief, notes and memory joined `local-help-commands-tower.ts`.
     ...TOWER_OPS_COMMAND_HELP,
+    [
+        "ai-skills",
+        [
+            "Usage: cockpit ai-skills [--who <me|team|email|user-id>] [--weeks <n>] [--week <YYYY-MM-DD>] [--dashboard-url <url>] [--json]",
+            "",
+            "The six AI-skill scores. Planning, Verification, Context, Parallelization, Collaboration and Ownership, each 0 to 10, judged",
+            "per session from your own turns and what the session achieved (checks that ran and passed, failures fixed, pull requests), then averaged",
+            "per week over the sessions that had evidence for that dimension. Every week prints its coverage (\"3 of 7 sessions scored this week\") and",
+            "each score its bucket: below 4 needs work, 4 to under 7 acceptable, 7 and above expert. A dimension with no evidence prints \"not enough",
+            "evidence\" and never a number. Weeks run Monday to Sunday in UTC, by the day each session started.",
+            "--weeks <n>   how many weeks, newest first (default 8, at most 26).",
+            "--week <date> a Monday: add that week's judged sessions with the verbatim quotes of your own turns behind each score (one person).",
+            "--who <w>     me (default), team, or one person's exact email or user id. A member reads only their own; team and other people are admin only,",
+            "              and an owner's scores are visible to that owner alone (asking for them answers an empty list).",
+            "--json writes one object to stdout: the door's whole answer (people, weeks, dimensions with score, sessions, bucket, note, thresholds) and a text field;",
+            "a refusal is { ok: false, error, detail } and exits 1 (admin_only, invalid_weeks, unknown_person, not_paired, ...).",
+            "Teaching: docs/architecture/ai-skill-scores.md. The bli-tower MCP server has the twin: ai_skills_read.",
+        ],
+    ],
     [
         "correct",
         [

package/dist/commands/local-help.js

@@ -75,6 +75,7 @@ export const rootCommandNames = new Set([
     "clean",
     "sources",
     "glossary",
+    "skills",
     "spend",
     "push",
     "docs",
@@ -95,6 +96,7 @@ export const rootCommandNames = new Set([
     "logs",
     "brain",
     "hits",
+    "ai-skills",
     "intentions",
     "who",
     "people",
@@ -162,6 +164,7 @@ const COMMAND_SUMMARY_LINES = [
     "  cockpit release [--dry-run] [--skip-checks] [--no-floor] [--tag <tag>] [--access <public|restricted>] [--otp <code>]",
     "  cockpit careers [list|show <id>|rescreen <id>|send-takehome <id>|decide <id> --decision <passed_on|archived|reopen>|followup <id> [--record-sent-at <iso>]|interview <id> <--at <iso>|--clear>|grade <id> [--now]|resume <id> [--out <path>]|takehome show <role>|takehome set <role> --body-file <path>|settings show|settings set --enabled <true|false> --followup-enabled <true|false> --followup-after-days <n> --takehome-window-hours <n>] [--role <slug>] [--min-score <n>] [--since <date>] [--stage <s>] [--force] [--json]",
     "  cockpit glossary list|add <wrong> --to <name>|remove <wrong> [--dashboard-url <url>] [--json]",
+    "  cockpit skills library [--weeks <1-52>] | refresh [--weeks <1-104>] [--dashboard-url <url>] [--json]",
     "  cockpit spend memory [--days 1|7|30] [--dashboard-url <url>] [--json]",
     "  cockpit push status|test [--dashboard-url <url>] [--json]",
     "  cockpit rename [list|resolve <id> --scope <page|everywhere|undo>] [--dashboard-url <url>] [--json]",
@@ -175,6 +178,7 @@ const COMMAND_SUMMARY_LINES = [
     "  cockpit hits timeline [--weeks <n>] [--dashboard-url <url>] [--json]",
     "  cockpit hits coach [--dashboard-url <url>] [--json]",
     "  cockpit hits approve --scope <team|agents|project:<id>> [--version <n>] [--dashboard-url <url>] [--json]",
+    "  cockpit ai-skills [--who <me|team|email|user-id>] [--weeks <n>] [--week <YYYY-MM-DD>] [--dashboard-url <url>] [--json]",
     "  cockpit approvals [list|show <id>|create|approve <id> [--edit]|edit <id> [--approve]|reject <id>|rules [--active true|false]|rules create <card-id> [--any-audience] [--label <text>]|rules revoke <rule-id> [--reason <text>]] [--status <s>] [--limit <n>] [--before <cursor>] [--dashboard-url <url>] [--json]",
     "  cockpit drills [list|start|answer --confidence <1-5> [--text <words>] [--attempt <id>]|theme|theme set <theme> [--play <t>] [--watch <t>] [--train <t>]|review] [--dashboard-url <url>] [--json]",
     "  cockpit manager <clients|client <client>|run <run-id>|list <client>|queue <client>|show <id>|add <client> --title <t>|edit <id> --version <v>|done|reopen|link|approve|dismiss|proposal|archive|unarchive> [--timeline] [--dashboard-url <url>] [--json]",

package/dist/commands/local.js

@@ -136,6 +136,7 @@ async function runTowerCommand(command, io) {
         case "correct": return await (await import("./correct.js")).runCorrect(command, io);
         case "notes": return await (await import("./notes.js")).runNotes(command, io);
         case "glossary": return await (await import("./glossary.js")).runGlossary(command, io);
+        case "skills": return await (await import("./skills.js")).runSkills(command, io);
         case "sessions-forget": return await (await import("./sessions-forget.js")).runSessionsForget(command, io);
         case "spend": return await (await import("./spend.js")).runSpend(command, io);
         case "push": return await (await import("./push.js")).runPush(command, io);
@@ -155,6 +156,7 @@ async function runTowerCommand(command, io) {
         case "logs": return await (await import("./logs.js")).runLogs(command, io);
         case "brain": return await (await import("./brain.js")).runBrain(command, io);
         case "hits": return await (await import("./hits.js")).runHits(command, io);
+        case "ai-skills": return await (await import("./ai-skills.js")).runAiSkills(command, io);
         case "intentions": return await (await import("./intentions.js")).runIntentions(command, io);
         case "who": return await (await import("./who.js")).runWho(command, io);
         case "people": return await (await import("./people.js")).runPeople(command, io);

package/dist/commands/public-root.js

@@ -21,7 +21,7 @@ export async function runCockpitCli(argv, io) {
   }
 
   if (command === "--version" || command === "-V" || command === "version") {
-    writeLine(io?.stdout ?? process.stdout, "0.2.279");
+    writeLine(io?.stdout ?? process.stdout, "0.2.280");
     return 0;
   }
 

package/dist/commands/skills.js

@@ -0,0 +1,38 @@
+import { askAgentDoor, emitAgentDoor, failAgentDoor, openAgentDoor } from "./agent-door.js";
+import { writeLine } from "./cli-io.js";
+import { optionalNonEmpty, optionalUrl, parseNamedArgs } from "./local-arg-values.js";
+export const SKILLS_USAGE = "Usage: cockpit skills library [--weeks <1-52>] [--json] | cockpit skills refresh [--weeks <1-104>] [--json]";
+export function parseSkillsArgs(args) {
+    const values = parseNamedArgs(args, { allowedFlags: ["--weeks", "--json", "--home", "--dashboard-url"], valueFlags: ["--weeks", "--home", "--dashboard-url"] });
+    const [action, ...rest] = values.positionals;
+    if ((action !== "library" && action !== "refresh") || rest.length > 0)
+        throw new Error(SKILLS_USAGE);
+    const raw = values.flags.get("--weeks");
+    const max = action === "library" ? 52 : 104;
+    const weeks = raw === undefined ? undefined : Number(raw);
+    if (weeks !== undefined && (!Number.isInteger(weeks) || weeks < 1 || weeks > max))
+        throw new Error(SKILLS_USAGE);
+    return { kind: "skills", action, weeks, json: values.booleans.has("--json"), homeDir: optionalNonEmpty(values.flags.get("--home")), dashboardUrl: optionalUrl(values.flags.get("--dashboard-url")) };
+}
+export async function runSkills(command, io) {
+    const door = await openAgentDoor("skills", command, io);
+    if (command.action === "refresh") {
+        const answer = await askAgentDoor(door, { path: "/api/skills/library/refresh", method: "POST", label: "skills refresh", timeoutMs: 300_000, body: command.weeks === undefined ? {} : { weeks: command.weeks } });
+        if (!answer.ok)
+            return failAgentDoor(door, "[skills cli]", answer.reason, answer.detail);
+        if (command.json)
+            return emitAgentDoor(door, answer.body);
+        const body = answer.body;
+        const t = body.totals ?? {};
+        writeLine(io.stdout, `Skill Library refresh ${body.status ?? "finished"}${body.reason ? ` (${body.reason})` : ""}: ${t["repos_scanned"] ?? 0} repos scanned, ${t["files_seen"] ?? 0} skill files, ${t["versions_added"] ?? 0} new versions, ${t["weekly_rows"] ?? 0} weekly usage rows over ${t["weeks"] ?? "?"} weeks.`);
+        return body.ok === false ? 1 : 0;
+    }
+    const answer = await askAgentDoor(door, { path: `/api/skills/library${command.weeks === undefined ? "" : `?weeks=${command.weeks}`}`, method: "GET", label: "skills library", timeoutMs: 30_000 });
+    if (!answer.ok)
+        return failAgentDoor(door, "[skills cli]", answer.reason, answer.detail);
+    if (command.json)
+        return emitAgentDoor(door, answer.body);
+    for (const line of answer.body.lines)
+        writeLine(io.stdout, line);
+    return 0;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bli-cockpit/cli",
-  "version": "0.2.279",
+  "version": "0.2.280",
   "private": false,
   "type": "module",
   "bin": {
@@ -27,9 +27,9 @@
     "test": "node dist/cli.js --help && node ../../scripts/assert-public-cli-routing.mjs && node ../../scripts/assert-public-cli-verb-help.mjs && node ../../scripts/assert-public-cli-surface-doors.mjs && node ../../scripts/assert-public-cli-runtime-files.mjs && node ../../scripts/assert-public-cli-exit-contract.mjs && node ../../scripts/assert-public-cli-no-fleet-posts.mjs && node ../../scripts/assert-public-cli-doctor-json.mjs && node ../../scripts/assert-public-package-pack.mjs --workspace=@bli-cockpit/cli"
   },
   "dependencies": {
-    "@bli-cockpit/memory-mcp": "0.1.86",
-    "@bli-cockpit/mcp": "0.1.170",
-    "@bli-cockpit/telemetry-core": "0.1.93",
+    "@bli-cockpit/memory-mcp": "0.1.87",
+    "@bli-cockpit/mcp": "0.1.171",
+    "@bli-cockpit/telemetry-core": "0.1.94",
     "unpdf": "1.8.1"
   },
   "repository": {