roster-cli 0.3.0 → 0.3.1

package/README.md

@@ -155,10 +155,10 @@ Once installed:
   (`ROSTER_DRIFT_DISABLE=1` to opt out). By default it watches
   `.claude/agents` plus, in a plugin-layout repo (one with a top-level
   `.claude-plugin/plugin.json`), the root `agents/` dir; override with
-  `ROSTER_DRIFT_DIR` (colon-separated dir list). The advisory goes to both
-  Claude's session context (so it can offer an audit proactively) and
-  stderr (so you see it in the terminal). Advisory only — never blocks a
-  session.
+  `ROSTER_DRIFT_DIR` (colon-separated dir list). The advisory is injected
+  into Claude's session context along with a relay directive, so Claude
+  surfaces it to you in its first response of the session. Advisory only —
+  never blocks a session.
 
 ## Contributing
 

package/dist/sources/plugin-cache.js

@@ -145,7 +145,8 @@ export const pluginCacheSource = {
             const sourceLabel = `plugin:${plugin.name}@${plugin.version}`;
             return Promise.all(files.map(async (filePath) => {
                 const raw = await readFile(filePath, 'utf8');
-                return parseAgentMarkdown(raw, filePath, sourceLabel);
+                const agent = parseAgentMarkdown(raw, filePath, sourceLabel);
+                return { ...agent, pluginName: plugin.name };
             }));
         }));
         return agentLists.flat();

package/dist/usage.js

@@ -64,13 +64,24 @@ function parseArgs(argv) {
 }
 /**
  * Pure join between observed invocation counts and a roster's agent names.
- * - unused: in the roster, but zero observed invocations.
- * - ghosts: observed invocations for a subagent_type that isn't in the roster.
+ * - unused: in the roster, but zero observed invocations (directly, or via an
+ *   alias key such as the `<plugin>:<name>` form transcripts record for
+ *   plugin-sourced subagents).
+ * - ghosts: observed invocations for a subagent_type that isn't in the roster
+ *   and isn't a known alias of a roster name.
+ *
+ * `aliases` maps an observed count key (e.g. `sshworld:implementor`) to the
+ * canonical bare roster name (e.g. `implementor`). Omitting it preserves the
+ * prior exact-match-only behavior.
  */
-export function computeJoin(counts, rosterNames) {
+export function computeJoin(counts, rosterNames, aliases = {}) {
     const rosterSet = new Set(rosterNames);
-    const unused = rosterNames.filter((name) => !counts[name]);
-    const ghosts = Object.keys(counts).filter((name) => !rosterSet.has(name));
+    const unused = rosterNames.filter((name) => {
+        if (counts[name])
+            return false;
+        return !Object.keys(counts).some((key) => aliases[key] === name);
+    });
+    const ghosts = Object.keys(counts).filter((name) => !rosterSet.has(name) && !(name in aliases && rosterSet.has(aliases[name])));
     return { unused, ghosts };
 }
 async function findJsonlFiles(root) {
@@ -148,6 +159,7 @@ async function countAgentInvocations(filePath, cutoff, counts) {
 }
 async function loadRosterNames(user, plugin) {
     const names = new Set();
+    const aliases = {};
     if (user) {
         const agents = await sources.user.load();
         for (const agent of agents)
@@ -155,10 +167,14 @@ async function loadRosterNames(user, plugin) {
     }
     if (plugin) {
         const agents = await sources['plugin-cache'].load();
-        for (const agent of agents)
+        for (const agent of agents) {
             names.add(agent.name);
+            if (agent.pluginName) {
+                aliases[`${agent.pluginName}:${agent.name}`] = agent.name;
+            }
+        }
     }
-    return [...names];
+    return { names: [...names], aliases };
 }
 function renderHuman(days, counts, unused, ghosts) {
     const lines = [];
@@ -209,8 +225,8 @@ export async function run(argv) {
     let unused = [];
     let ghosts = [];
     if (parsed.user || parsed.plugin) {
-        const rosterNames = await loadRosterNames(parsed.user, parsed.plugin);
-        const joined = computeJoin(counts, rosterNames);
+        const { names: rosterNames, aliases } = await loadRosterNames(parsed.user, parsed.plugin);
+        const joined = computeJoin(counts, rosterNames, aliases);
         unused = joined.unused;
         ghosts = joined.ghosts;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "roster-cli",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Zero-runtime-dep static auditor for Claude Code agent rosters \u2014 overlap, harness gaps, routing, cost.",
   "type": "module",
   "bin": {