@monoes/monomindcli 2.16.1 → 2.16.3

package/dist/src/decision/catalogs.js

@@ -1,16 +1,99 @@
 /**
  * Candidate catalogs for the Jev picker. Registry agents and skills come from
- * the shared helper so the hook and the CLI read them identically.
+ * the shared helper (.claude/helpers/jev-catalog.cjs) so the hook and the CLI
+ * read them identically; both indexes are refreshed first when stale.
  */
+import { existsSync, readFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { buildUnifiedRegistry, computeAgentRoots, } from '../agents/registry-builder.js';
+import { ensureRegistry, findProjectRoot, registryPath } from '../agents/registry-freshness.js';
 import { verifyEntry } from '../catalog/digest.js';
 import { buildSnapshot, eligible } from '../catalog/snapshot.js';
-import { listSkills } from '../orgrt/skill-library.js';
+import { bundledSkillsDir, listSkills } from '../orgrt/skill-library.js';
 import { jevModule } from './jev.js';
+/**
+ * Where `cwd`'s agents come from. Inside a project (walking up, never $HOME)
+ * the project's .monomind/registry.json, refreshed first when stale. Outside
+ * one the registry is built in memory and nothing is written, so a run from
+ * $HOME or a plain folder never creates a `.monomind` there.
+ */
+function agentSource(cwd) {
+    const project = findProjectRoot(cwd);
+    if (project) {
+        ensureRegistry(project);
+        return { root: project };
+    }
+    return {
+        root: cwd,
+        registry: buildUnifiedRegistry(computeAgentRoots(cwd), undefined, { base: cwd }),
+    };
+}
+/** Registry agents (see agentSource). */
 export function agentCatalog(root) {
-    return jevModule()?.loadAgentCatalog(root) ?? [];
+    const src = agentSource(root);
+    return (jevModule()?.loadAgentCatalog(src.root, src.registry ? { registry: src.registry } : undefined) ?? []);
+}
+/** Every spawnable agent name (frontmatter `name`, the Task subagent_type) in
+ *  the registry. Deprecated agents are included: picks hide them, but a Task
+ *  call naming one still works. */
+export function agentNames(root) {
+    const src = agentSource(root);
+    try {
+        const reg = (src.registry ?? JSON.parse(readFileSync(registryPath(src.root), 'utf8')));
+        return new Set((reg.agents ?? [])
+            .map((a) => a.name ?? a.slug)
+            .filter((n) => typeof n === 'string' && n.length > 0));
+    }
+    catch {
+        return new Set();
+    }
+}
+const HERE = dirname(fileURLToPath(import.meta.url));
+/** src/decision → ../.. is the package root; dist/src/decision → ../../.. */
+const BUILDER_CANDIDATES = [
+    join(HERE, '..', '..', '.claude', 'helpers', 'build-skill-registry.cjs'),
+    join(HERE, '..', '..', '..', '.claude', 'helpers', 'build-skill-registry.cjs'),
+];
+function skillIndexBuilder() {
+    const file = BUILDER_CANDIDATES.find((p) => existsSync(p));
+    return file ? createRequire(import.meta.url)(file) : undefined;
+}
+/** True when .claude/helpers/skill-registry.json is missing or older than a
+ *  source; undefined when the builder is unavailable. */
+export function skillIndexIsStale(root) {
+    try {
+        return skillIndexBuilder()?.isStale(root, { bundledDir: bundledSkillsDir() });
+    }
+    catch {
+        return undefined;
+    }
 }
-export function skillCatalog(root) {
-    return jevModule()?.loadSkillCatalog(root) ?? [];
+/**
+ * The skill index for `root` (platform skills + Org library), with the
+ * bundled builder. Inside a project (findProjectRoot) with a `.claude` dir,
+ * the project's .claude/helpers/skill-registry.json is refreshed when a source
+ * is newer (the hook reads that file); anywhere else — $HOME included — the
+ * index is built in memory only. `user: false` leaves ~/.claude/skills out and
+ * always indexes in memory.
+ */
+export function skillIndex(root, opts = {}) {
+    try {
+        const builder = skillIndexBuilder();
+        if (!builder)
+            return undefined;
+        const bundledDir = bundledSkillsDir();
+        if (opts.user === false)
+            return builder.build(root, { bundledDir, user: false });
+        const project = findProjectRoot(root);
+        return project && existsSync(join(project, '.claude'))
+            ? builder.ensure(project, { bundledDir })
+            : builder.build(project ?? root, { bundledDir });
+    }
+    catch {
+        return undefined;
+    }
 }
 /** Catalog skills leave the machine only with the `jev` target; legacy skills
  *  are unchanged. Without a root no catalog skill is sent. */
@@ -37,6 +120,18 @@ export function orgSkillCatalog(root, names) {
         .filter((s) => !allow || allow.has(s.name))
         .map((s) => ({ id: s.name, description: s.description, text: s.tags.join(' ') }));
 }
+/** Every skill a task can use, as one index: platform skills first (they are
+ *  directly invokable), then Org-library skills that are not a platform skill
+ *  or an agent by another name. Org skills are read with the org_skill_show
+ *  MCP tool. The same loader the prompt hook uses, over the same index. */
+export function taskSkillCatalog(root) {
+    const src = agentSource(root);
+    const index = skillIndex(src.root);
+    return (jevModule()?.loadSkillCatalog(src.root, {
+        ...(index ? { index } : {}),
+        ...(src.registry ? { registry: src.registry } : {}),
+    }) ?? []);
+}
 export function roleCatalog(roles) {
     return roles.map((r) => ({
         id: r.id,
@@ -44,21 +139,4 @@ export function roleCatalog(roles) {
         description: [r.title, ...(r.responsibilities ?? [])].filter(Boolean).join('; '),
     }));
 }
-/** @monoes/routing routes, one entry per agent slug. */
-export function routeCatalog(routes) {
-    const seen = new Set();
-    const out = [];
-    for (const r of routes) {
-        if (seen.has(r.agentSlug))
-            continue;
-        seen.add(r.agentSlug);
-        out.push({
-            id: r.agentSlug,
-            name: r.name,
-            description: r.description ?? r.name,
-            text: (r.utterances ?? []).join(' '),
-        });
-    }
-    return out;
-}
 //# sourceMappingURL=catalogs.js.map

package/dist/src/decision/catalogs.js.map

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

package/dist/src/decision/jev.d.ts

@@ -5,6 +5,11 @@ export interface CatalogItem {
     description?: string;
     text?: string;
     invoke?: string;
+    /** Skill pool: `platform` (.claude/skills) or `org` (the Org skill library). */
+    source?: 'platform' | 'org';
+    /** `low`: an admin/meta skill (`pick: low` frontmatter) that keyword
+     *  ranking places below equally matching entries. */
+    pick?: 'low';
 }
 export interface RankedOption {
     id: string;
@@ -51,6 +56,8 @@ export interface JevPickerModule {
     resolveProviders(env?: NodeJS.ProcessEnv): JevProvider[];
     resolveTimeoutMs(env?: NodeJS.ProcessEnv): number;
     resolveHookTimeoutMs(env?: NodeJS.ProcessEnv): number;
+    resolveMinConfidence(env?: NodeJS.ProcessEnv): number;
+    resolvePickMinConfidence(env?: NodeJS.ProcessEnv): number;
     redactSecrets(text: string): string;
     shortlist<T extends CatalogItem>(query: string, items: T[], limit: number, include?: string[]): (T & {
         score: number;
@@ -59,14 +66,20 @@ export interface JevPickerModule {
         agents?: CatalogItem[];
         skills?: CatalogItem[];
     }, opts?: PickOptions): Promise<JevPick | null>;
-    acceptAgent(answer: JevAnswer | undefined, env?: NodeJS.ProcessEnv): string | null;
-    acceptSkills(answer: JevAnswer | undefined, env?: NodeJS.ProcessEnv, max?: number): string[];
+    acceptAgent(answer: JevAnswer | undefined, env?: NodeJS.ProcessEnv, minConfidence?: number): string | null;
+    acceptSkills(answer: JevAnswer | undefined, env?: NodeJS.ProcessEnv, max?: number, minConfidence?: number): string[];
     probe(provider: JevProvider, opts?: {
         env?: NodeJS.ProcessEnv;
         fetchImpl?: typeof fetch;
     }): Promise<number>;
-    loadAgentCatalog(root: string): CatalogItem[];
-    loadSkillCatalog(root: string): CatalogItem[];
+    /** opts.registry: an in-memory agent registry used instead of .monomind/registry.json. */
+    loadAgentCatalog(root: string, opts?: {
+        registry?: unknown;
+    }): CatalogItem[];
+    loadSkillCatalog(root: string, opts?: {
+        index?: unknown;
+        registry?: unknown;
+    }): CatalogItem[];
 }
 export declare function jevModule(): JevPickerModule | null;
 /** Why the helper exists but failed to load; undefined when it is just missing. */
@@ -76,8 +89,15 @@ export declare function pickWithJev(task: string, catalogs: {
     agents?: CatalogItem[];
     skills?: CatalogItem[];
 }, opts?: PickOptions): Promise<JevPick | null>;
-export declare function acceptAgent(answer: JevAnswer | undefined, env?: NodeJS.ProcessEnv): string | null;
-export declare function acceptSkills(answer: JevAnswer | undefined, env?: NodeJS.ProcessEnv, max?: number): string[];
+/** The floor automatic decisions (hook injection, org auto-assign) act above
+ *  (MONOMIND_JEV_MIN_CONFIDENCE, default 0.6). */
+export declare function automaticMinConfidence(env?: NodeJS.ProcessEnv): number;
+/** The floor for rankings a person reads (MONOMIND_JEV_PICK_MIN_CONFIDENCE,
+ *  default 0.25); between it and the automatic floor an answer is low-confidence. */
+export declare function pickMinConfidence(env?: NodeJS.ProcessEnv): number;
+/** `minConfidence` overrides the automatic floor for this call. */
+export declare function acceptAgent(answer: JevAnswer | undefined, env?: NodeJS.ProcessEnv, minConfidence?: number): string | null;
+export declare function acceptSkills(answer: JevAnswer | undefined, env?: NodeJS.ProcessEnv, max?: number, minConfidence?: number): string[];
 /** Keyword ranking (the no-model fallback): only items with some overlap. */
 export declare function keywordRank<T extends CatalogItem>(query: string, items: T[], limit: number): (T & {
     score: number;

package/dist/src/decision/jev.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jev.d.ts","sourceRoot":"","sources":["../../../src/decision/jev.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,YAAY,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,OAAO;IACtB,QAAQ,EAAE,QAAQ,GAAG,UAAU,CAAC;IAChC,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,GAAG,UAAU,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,QAAS,SAAQ,KAAK;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,QAAQ,KAAK,IAAI,CAAC;IAClC,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IACnD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,OAAO,CAAC;IAC7C,gBAAgB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAChD,gBAAgB,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,WAAW,EAAE,CAAC;IACzD,gBAAgB,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC;IAClD,oBAAoB,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC;IACtD,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACpC,SAAS,CAAC,CAAC,SAAS,WAAW,EAC7B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,CAAC,EAAE,EACV,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,MAAM,EAAE,GACjB,CAAC,CAAC,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,CAAC;IAC7B,IAAI,CACF,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,EAAE,CAAA;KAAE,EAC5D,IAAI,CAAC,EAAE,WAAW,GACjB,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAC3B,WAAW,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,GAAG,IAAI,CAAC;IACnF,YAAY,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC7F,KAAK,CACH,QAAQ,EAAE,WAAW,EACrB,IAAI,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;KAAE,GAC3D,OAAO,CAAC,MAAM,CAAC,CAAC;IACnB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE,CAAC;IAC9C,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE,CAAC;CAC/C;AAYD,wBAAgB,SAAS,IAAI,eAAe,GAAG,IAAI,CAUlD;AAED,mFAAmF;AACnF,wBAAgB,YAAY,IAAI,KAAK,GAAG,SAAS,CAGhD;AAED,wBAAgB,uBAAuB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAErF;AAED,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE;IAAE,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,EAAE,CAAA;CAAE,EAC5D,IAAI,GAAE,WAAgB,GACrB,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAgBzB;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,GAAG,IAAI,CAEjG;AAED,wBAAgB,YAAY,CAC1B,MAAM,EAAE,SAAS,GAAG,SAAS,EAC7B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,EACvB,GAAG,CAAC,EAAE,MAAM,GACX,MAAM,EAAE,CAEV;AAED,6EAA6E;AAC7E,wBAAgB,WAAW,CAAC,CAAC,SAAS,WAAW,EAC/C,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,CAAC,EAAE,EACV,KAAK,EAAE,MAAM,GACZ,CAAC,CAAC,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,EAAE,CAG3B"}
+{"version":3,"file":"jev.d.ts","sourceRoot":"","sources":["../../../src/decision/jev.ts"],"names":[],"mappings":"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"}

package/dist/src/decision/jev.js

@@ -58,11 +58,22 @@ export async function pickWithJev(task, catalogs, opts = {}) {
         return null;
     }
 }
-export function acceptAgent(answer, env) {
-    return jevModule()?.acceptAgent(answer, env) ?? null;
+/** The floor automatic decisions (hook injection, org auto-assign) act above
+ *  (MONOMIND_JEV_MIN_CONFIDENCE, default 0.6). */
+export function automaticMinConfidence(env) {
+    return jevModule()?.resolveMinConfidence(env) ?? 0.6;
 }
-export function acceptSkills(answer, env, max) {
-    return jevModule()?.acceptSkills(answer, env, max) ?? [];
+/** The floor for rankings a person reads (MONOMIND_JEV_PICK_MIN_CONFIDENCE,
+ *  default 0.25); between it and the automatic floor an answer is low-confidence. */
+export function pickMinConfidence(env) {
+    return jevModule()?.resolvePickMinConfidence(env) ?? 0.25;
+}
+/** `minConfidence` overrides the automatic floor for this call. */
+export function acceptAgent(answer, env, minConfidence) {
+    return jevModule()?.acceptAgent(answer, env, minConfidence) ?? null;
+}
+export function acceptSkills(answer, env, max, minConfidence) {
+    return jevModule()?.acceptSkills(answer, env, max, minConfidence) ?? [];
 }
 /** Keyword ranking (the no-model fallback): only items with some overlap. */
 export function keywordRank(query, items, limit) {

package/dist/src/decision/jev.js.map

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

package/dist/src/decision/pick-eval.d.ts

@@ -0,0 +1,67 @@
+import { type CatalogItem } from './jev.js';
+export type EvalKind = 'agents' | 'skills';
+/** One task. `agents` / `skills` list EVERY acceptable id; an empty list
+ *  means "no expectation" and the task is not scored for that kind. */
+export interface EvalTask {
+    id: number;
+    task: string;
+    domain?: string;
+    agents: string[];
+    skills: string[];
+}
+export interface EvalCatalogs {
+    agents: CatalogItem[];
+    skills: CatalogItem[];
+}
+export interface EvalMiss {
+    id: number;
+    task: string;
+    expected: string[];
+    got: string[];
+    /** 1-based position of the first acceptable id within the ranked list, or
+     *  null when none was ranked. */
+    rank: number | null;
+}
+export interface KindScore {
+    /** Tasks scored for this kind (those with at least one expected id). */
+    n: number;
+    top1: number;
+    top3: number;
+    /** Tasks whose top-1 was not acceptable. */
+    misses: EvalMiss[];
+}
+export interface EvalReport {
+    tasks: number;
+    agents: KindScore;
+    skills: KindScore;
+}
+/** Ranked ids per kind for one task (at least the top 3). */
+export interface TaskPicks {
+    agents: string[];
+    skills: string[];
+}
+export declare const EVAL_TOP = 3;
+export declare function evalDir(root: string): string;
+/** dataset.json + holdout.json under tests/pick-eval, or null outside a
+ *  checkout that carries the eval set. */
+export declare function readEvalTasks(root: string, sets?: string[]): EvalTask[] | null;
+/** The frozen catalog snapshot (catalog-snapshot.json), or null. */
+export declare function readEvalSnapshot(root: string): EvalCatalogs | null;
+/**
+ * The project's live catalogs as the picker sees them, minus the user's
+ * personal ~/.claude/skills so a score means the same on every machine.
+ */
+export declare function projectCatalogs(root: string): EvalCatalogs;
+/** Score ranked picks against the tasks' acceptable ids. */
+export declare function scorePicks(tasks: EvalTask[], picks: TaskPicks[]): EvalReport;
+/** Keyword-only picks for every task (in-process, no network). */
+export declare function keywordPicks(tasks: EvalTask[], catalogs: EvalCatalogs): TaskPicks[];
+export declare function keywordEval(tasks: EvalTask[], catalogs: EvalCatalogs): EvalReport;
+/** Expected ids a catalog does not contain (a stale expectation). */
+export declare function unknownExpectations(tasks: EvalTask[], catalogs: EvalCatalogs): {
+    id: number;
+    kind: EvalKind;
+    missing: string[];
+}[];
+export declare function formatScore(s: KindScore): string;
+//# sourceMappingURL=pick-eval.d.ts.map

package/dist/src/decision/pick-eval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pick-eval.d.ts","sourceRoot":"","sources":["../../../src/decision/pick-eval.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,KAAK,WAAW,EAA0B,MAAM,UAAU,CAAC;AAEpE,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE3C;uEACuE;AACvE,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,GAAG,EAAE,MAAM,EAAE,CAAC;IACd;qCACiC;IACjC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,wEAAwE;IACxE,CAAC,EAAE,MAAM,CAAC;IACV,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,MAAM,EAAE,QAAQ,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,SAAS,CAAC;CACnB;AAED,6DAA6D;AAC7D,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,eAAO,MAAM,QAAQ,IAAI,CAAC;AAE1B,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5C;AAUD;0CAC0C;AAC1C,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,MAAM,EAA2B,GACtC,QAAQ,EAAE,GAAG,IAAI,CASnB;AAED,oEAAoE;AACpE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAKlE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAK1D;AAED,4DAA4D;AAC5D,wBAAgB,UAAU,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,UAAU,CAwB5E;AAED,kEAAkE;AAClE,wBAAgB,YAAY,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,QAAQ,EAAE,YAAY,GAAG,SAAS,EAAE,CAKnF;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,QAAQ,EAAE,YAAY,GAAG,UAAU,CAEjF;AAED,qEAAqE;AACrE,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,QAAQ,EAAE,EACjB,QAAQ,EAAE,YAAY,GACrB;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,EAAE,CAYrD;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,SAAS,GAAG,MAAM,CAEhD"}

package/dist/src/decision/pick-eval.js

@@ -0,0 +1,113 @@
+/**
+ * Offline evaluation of agent/skill picking: tasks with every acceptable
+ * agent and skill id, scored as top-1 / top-3 hits. The eval set lives in a
+ * source checkout under tests/pick-eval/ (dataset.json, holdout.json and a
+ * frozen catalog snapshot); `pnpm run pick:eval` (scripts/pick-eval.mjs), the
+ * tests/pick-eval regression guard and `monomind doctor -c pick` all score
+ * through this module.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { agentCatalog, skillIndex } from './catalogs.js';
+import { jevModule, keywordRank } from './jev.js';
+export const EVAL_TOP = 3;
+export function evalDir(root) {
+    return join(root, 'tests', 'pick-eval');
+}
+function readJson(file) {
+    try {
+        return JSON.parse(readFileSync(file, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+/** dataset.json + holdout.json under tests/pick-eval, or null outside a
+ *  checkout that carries the eval set. */
+export function readEvalTasks(root, sets = ['dataset', 'holdout']) {
+    const dir = evalDir(root);
+    const out = [];
+    for (const set of sets) {
+        const list = readJson(join(dir, `${set}.json`));
+        if (!Array.isArray(list))
+            return null;
+        out.push(...list);
+    }
+    return out;
+}
+/** The frozen catalog snapshot (catalog-snapshot.json), or null. */
+export function readEvalSnapshot(root) {
+    const file = join(evalDir(root), 'catalog-snapshot.json');
+    if (!existsSync(file))
+        return null;
+    const snap = readJson(file);
+    return snap && Array.isArray(snap.agents) && Array.isArray(snap.skills) ? snap : null;
+}
+/**
+ * The project's live catalogs as the picker sees them, minus the user's
+ * personal ~/.claude/skills so a score means the same on every machine.
+ */
+export function projectCatalogs(root) {
+    const agents = agentCatalog(root);
+    const index = skillIndex(root, { user: false });
+    const skills = jevModule()?.loadSkillCatalog(root, index ? { index } : undefined) ?? [];
+    return { agents, skills };
+}
+/** Score ranked picks against the tasks' acceptable ids. */
+export function scorePicks(tasks, picks) {
+    const kind = (k) => {
+        const score = { n: 0, top1: 0, top3: 0, misses: [] };
+        tasks.forEach((t, i) => {
+            const expected = t[k];
+            if (!expected.length)
+                return;
+            score.n++;
+            const ok = new Set(expected);
+            const got = (picks[i]?.[k] ?? []).slice(0, EVAL_TOP);
+            const at = got.findIndex((id) => ok.has(id));
+            if (at === 0)
+                score.top1++;
+            if (at !== -1)
+                score.top3++;
+            if (at !== 0)
+                score.misses.push({
+                    id: t.id,
+                    task: t.task,
+                    expected,
+                    got,
+                    rank: at === -1 ? null : at + 1,
+                });
+        });
+        return score;
+    };
+    return { tasks: tasks.length, agents: kind('agents'), skills: kind('skills') };
+}
+/** Keyword-only picks for every task (in-process, no network). */
+export function keywordPicks(tasks, catalogs) {
+    return tasks.map((t) => ({
+        agents: keywordRank(t.task, catalogs.agents, EVAL_TOP).map((i) => i.id),
+        skills: keywordRank(t.task, catalogs.skills, EVAL_TOP).map((i) => i.id),
+    }));
+}
+export function keywordEval(tasks, catalogs) {
+    return scorePicks(tasks, keywordPicks(tasks, catalogs));
+}
+/** Expected ids a catalog does not contain (a stale expectation). */
+export function unknownExpectations(tasks, catalogs) {
+    const known = {
+        agents: new Set(catalogs.agents.map((a) => a.id)),
+        skills: new Set(catalogs.skills.map((s) => s.id)),
+    };
+    const out = [];
+    for (const t of tasks)
+        for (const kind of ['agents', 'skills']) {
+            const missing = t[kind].filter((id) => !known[kind].has(id));
+            if (missing.length)
+                out.push({ id: t.id, kind, missing });
+        }
+    return out;
+}
+export function formatScore(s) {
+    return `top1 ${s.top1}/${s.n}, top3 ${s.top3}/${s.n}`;
+}
+//# sourceMappingURL=pick-eval.js.map

package/dist/src/decision/pick-eval.js.map

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

package/dist/src/decision/pick-stats.d.ts

@@ -0,0 +1,49 @@
+export interface AgentPickStats {
+    name: string;
+    /** Shown as the [PICK] agent. */
+    recommended: number;
+    /** A Task spawn used the recommended agent. */
+    followed: number;
+    /** A Task spawn used another agent than the recommended one. */
+    overridden: number;
+    /** Spawned instead of a different recommended agent. */
+    chosen: number;
+    /** SubagentStop outcomes of this agent. */
+    success: number;
+    failure: number;
+}
+export interface PickStatsSummary {
+    /** Prompts routed (route-outcomes records). */
+    routes: number;
+    /** Routes that printed a [PICK] line. */
+    shown: number;
+    /** Task/Agent spawns observed (pick-adherence records). */
+    spawns: number;
+    /** followed / (followed + overridden); null without a recommended spawn. */
+    adherenceRate: number | null;
+    /** Subagent success rate when the pick was followed; null without data. */
+    followedSuccessRate: number | null;
+    /** Subagent success rate when the pick was overridden; null without data. */
+    notFollowedSuccessRate: number | null;
+    /** At most 10, most observations first; `prior` is the ranking factor. */
+    topAgents: (AgentPickStats & {
+        successRate: number | null;
+        prior: number;
+    })[];
+    updatedAt: string | null;
+}
+/** Pick learning summary for `root`, folded up to the latest hook lines
+ *  without writing pick-stats.json. Never throws. */
+export declare function readPickStats(root: string): PickStatsSummary;
+/** Re-rank keyword-scored agents by the stored outcome prior of `root`.
+ *  Entries gain `baseScore` (keyword relevance) and `prior` (the factor);
+ *  without the helper they come back unchanged with prior 1. */
+export declare function applyAgentPriors<T extends {
+    id: string;
+    name?: string;
+    score: number;
+}>(root: string, ranked: T[]): (T & {
+    baseScore: number;
+    prior: number;
+})[];
+//# sourceMappingURL=pick-stats.d.ts.map

package/dist/src/decision/pick-stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pick-stats.d.ts","sourceRoot":"","sources":["../../../src/decision/pick-stats.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,UAAU,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,2EAA2E;IAC3E,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,6EAA6E;IAC7E,sBAAsB,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,0EAA0E;IAC1E,SAAS,EAAE,CAAC,cAAc,GAAG;QAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,CAAC;IAC9E,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AA+CD;qDACqD;AACrD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAQ5D;AAED;;gEAEgE;AAChE,wBAAgB,gBAAgB,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EACrF,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,CAAC,EAAE,GACV,CAAC,CAAC,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,EAAE,CAU9C"}

package/dist/src/decision/pick-stats.js

@@ -0,0 +1,68 @@
+/**
+ * Typed door into .claude/helpers/pick-stats.cjs, the pick learning loop the
+ * hooks feed (SubagentStop, SessionEnd): adherence and outcomes aggregated into
+ * .monomind/pick-stats.json, and the bounded prior that re-ranks keyword agent
+ * picks. Safe when the helper is missing: an empty summary and no prior.
+ */
+import { existsSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const HERE = dirname(fileURLToPath(import.meta.url));
+/** src/decision → ../.. is the package root; dist/src/decision → ../../.. */
+const HELPER_CANDIDATES = [
+    join(HERE, '..', '..', '.claude', 'helpers', 'pick-stats.cjs'),
+    join(HERE, '..', '..', '..', '.claude', 'helpers', 'pick-stats.cjs'),
+];
+let loaded;
+function pickStatsModule() {
+    if (loaded !== undefined)
+        return loaded;
+    const file = HELPER_CANDIDATES.find((p) => existsSync(p));
+    try {
+        loaded = file ? createRequire(import.meta.url)(file) : null;
+    }
+    catch {
+        loaded = null;
+    }
+    return loaded;
+}
+const EMPTY = {
+    routes: 0,
+    shown: 0,
+    spawns: 0,
+    adherenceRate: null,
+    followedSuccessRate: null,
+    notFollowedSuccessRate: null,
+    topAgents: [],
+    updatedAt: null,
+};
+/** Pick learning summary for `root`, folded up to the latest hook lines
+ *  without writing pick-stats.json. Never throws. */
+export function readPickStats(root) {
+    const mod = pickStatsModule();
+    if (!mod)
+        return { ...EMPTY };
+    try {
+        return mod.summarize(mod.update(root, { persist: false }));
+    }
+    catch {
+        return { ...EMPTY };
+    }
+}
+/** Re-rank keyword-scored agents by the stored outcome prior of `root`.
+ *  Entries gain `baseScore` (keyword relevance) and `prior` (the factor);
+ *  without the helper they come back unchanged with prior 1. */
+export function applyAgentPriors(root, ranked) {
+    const mod = pickStatsModule();
+    if (mod) {
+        try {
+            return mod.applyPriors(ranked, mod.load(root));
+        }
+        catch {
+            /* fall through: keyword order */
+        }
+    }
+    return ranked.map((r) => ({ ...r, baseScore: r.score, prior: 1 }));
+}
+//# sourceMappingURL=pick-stats.js.map

package/dist/src/decision/pick-stats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pick-stats.js","sourceRoot":"","sources":["../../../src/decision/pick-stats.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAiDzC,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACrD,6EAA6E;AAC7E,MAAM,iBAAiB,GAAG;IACxB,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,gBAAgB,CAAC;IAC9D,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,gBAAgB,CAAC;CACrE,CAAC;AAEF,IAAI,MAA0C,CAAC;AAE/C,SAAS,eAAe;IACtB,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IACxC,MAAM,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1D,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,CAAC,CAAE,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAqB,CAAC,CAAC,CAAC,IAAI,CAAC;IACnF,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,GAAG,IAAI,CAAC;IAChB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,KAAK,GAAqB;IAC9B,MAAM,EAAE,CAAC;IACT,KAAK,EAAE,CAAC;IACR,MAAM,EAAE,CAAC;IACT,aAAa,EAAE,IAAI;IACnB,mBAAmB,EAAE,IAAI;IACzB,sBAAsB,EAAE,IAAI;IAC5B,SAAS,EAAE,EAAE;IACb,SAAS,EAAE,IAAI;CAChB,CAAC;AAEF;qDACqD;AACrD,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,GAAG,GAAG,eAAe,EAAE,CAAC;IAC9B,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,GAAG,KAAK,EAAE,CAAC;IAC9B,IAAI,CAAC;QACH,OAAO,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IAC7D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,GAAG,KAAK,EAAE,CAAC;IACtB,CAAC;AACH,CAAC;AAED;;gEAEgE;AAChE,MAAM,UAAU,gBAAgB,CAC9B,IAAY,EACZ,MAAW;IAEX,MAAM,GAAG,GAAG,eAAe,EAAE,CAAC;IAC9B,IAAI,GAAG,EAAE,CAAC;QACR,IAAI,CAAC;YACH,OAAO,GAAG,CAAC,WAAW,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACjD,CAAC;QAAC,MAAM,CAAC;YACP,iCAAiC;QACnC,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AACrE,CAAC"}