@uzysjung/agent-harness 26.115.0 → 26.117.0

package/dist/index.js

@@ -14,17 +14,20 @@ import {
   assetCliSupport,
   assetReachesCli,
   assetTrustTier,
+  buildManifest,
   experimentalOptInCandidates,
   filterApplicableAssets,
-  hasDevTrack,
+  formatResidentCostLine,
   hasUiTrack,
   init_esm_shims,
   isAssetSelected,
   isCliBase,
   isInstallScope,
   isTrack,
-  resolveScope
-} from "./chunk-P6YR3FBR.js";
+  residentCost,
+  resolveScope,
+  summarizeContextCost
+} from "./chunk-2VII24JD.js";
 
 // node_modules/sisteransi/src/index.js
 var require_src = __commonJS({
@@ -709,7 +712,7 @@ var cac = (name = "") => new CAC(name);
 // package.json
 var package_default = {
   name: "@uzysjung/agent-harness",
-  version: "26.115.0",
+  version: "26.117.0",
   description: "Curate vetted AI-coding skills & plugins by your tech stack \u2014 install only what you need, across Claude Code, Codex, OpenCode & Antigravity",
   type: "module",
   publishConfig: {
@@ -740,7 +743,8 @@ var package_default = {
     "lint:fix": "biome check --write src tests",
     format: "biome format --write src tests",
     ci: "npm run typecheck && npm run lint && npm run test:coverage && npm run build",
-    prepare: "[ -d dist ] || npm run build"
+    prepare: "[ -d dist ] || npm run build",
+    "cost:report": "npm run build && node scripts/context-cost-report.mjs"
   },
   dependencies: {
     "@clack/prompts": "^1.3.0",
@@ -763,8 +767,8 @@ var package_default = {
 
 // src/commands/install.ts
 init_esm_shims();
-import { resolve as resolve3 } from "path";
-import { fileURLToPath as fileURLToPath2 } from "url";
+import { resolve as resolve2 } from "path";
+import { fileURLToPath } from "url";
 
 // src/cli-targets.ts
 init_esm_shims();
@@ -1795,258 +1799,6 @@ function installLogPath(projectDir) {
   return join8(projectDir, ".claude", INSTALL_LOG_FILENAME);
 }
 
-// src/manifest.ts
-init_esm_shims();
-var all = () => true;
-var dev = (s) => hasDevTrack(s.tracks);
-var ui = (s) => hasUiTrack(s.tracks);
-var onTracks = (pattern) => (s) => anyTrack(s.tracks, pattern);
-var COMMON_RULES = ["git-policy", "change-management", "gates-taxonomy", "doc-governance"];
-var DEV_RULES = ["test-policy", "ship-checklist", "code-style", "error-handling"];
-var UI_RULES = ["design-workflow", "playwright-launch", "benchmark-parity"];
-var TRACK_RULES = {
-  "csr-supabase": ["shadcn", "api-contract"],
-  "csr-fastify": ["shadcn", "api-contract", "database"],
-  "csr-fastapi": ["shadcn", "api-contract", "database"],
-  "ssr-htmx": ["htmx"],
-  "ssr-nextjs": ["nextjs", "shadcn"],
-  data: ["pyside6", "data-analysis"],
-  executive: [],
-  tooling: ["cli-development"],
-  full: [
-    "shadcn",
-    "api-contract",
-    "database",
-    "htmx",
-    "nextjs",
-    "pyside6",
-    "data-analysis",
-    "cli-development"
-  ],
-  // v0.5.0 — executive-style baselines (no dev rules; common rules only).
-  "project-management": [],
-  "growth-marketing": []
-};
-function resolveRules(spec) {
-  const set = new Set(COMMON_RULES);
-  if (hasDevTrack(spec.tracks)) {
-    for (const r of DEV_RULES) {
-      set.add(r);
-    }
-  }
-  if (spec.withTauri && anyTrack(spec.tracks, "csr-*|full")) {
-    set.add("tauri");
-  }
-  if (hasUiTrack(spec.tracks)) {
-    for (const r of UI_RULES) {
-      set.add(r);
-    }
-  }
-  for (const t of spec.tracks) {
-    for (const r of TRACK_RULES[t]) {
-      set.add(r);
-    }
-  }
-  return [...set].sort();
-}
-var CORE_AGENTS = ["reviewer", "data-analyst", "strategist"];
-var CORE_AGENTS_ECC = ["code-reviewer", "security-reviewer"];
-var DEV_AGENTS = ["plan-checker"];
-var DEV_AGENTS_ECC = ["silent-failure-hunter", "build-error-resolver"];
-var ALWAYS_HOOKS = [
-  "session-start.sh",
-  "protect-files.sh",
-  "mcp-pre-exec.sh",
-  "spec-drift-check.sh",
-  "checkpoint-snapshot.sh"
-];
-var COMMON_SKILL_DIRS = ["north-star", "gh-issue-workflow"];
-var COMMON_SKILL_DIRS_ECC = ["strategic-compact"];
-var MODIFIED_COMMON_SKILL_DIRS = ["continuous-learning-v2", "deep-research"];
-var DEV_SKILL_DIRS = [];
-var DEV_SKILL_DIRS_ECC = ["agent-introspection-debugging"];
-var MODIFIED_DEV_SKILL_DIRS = ["verification-loop", "eval-harness"];
-var MODIFIED_ECC_SKILL_DIRS = [...MODIFIED_COMMON_SKILL_DIRS, ...MODIFIED_DEV_SKILL_DIRS];
-var UI_SKILL_DIRS = ["ui-visual-review"];
-var UI_SKILL_DIRS_ECC = ["e2e-testing"];
-var PYTHON_SKILL_DIRS_ECC = ["python-patterns", "python-testing"];
-function buildManifest(spec) {
-  const m = [];
-  for (const r of resolveRules(spec)) {
-    m.push({
-      source: `rules/${r}.md`,
-      target: `.claude/rules/${r}.md`,
-      type: "file",
-      applies: all
-    });
-  }
-  m.push({
-    source: "commands/ecc",
-    target: ".claude/commands/ecc",
-    type: "dir",
-    applies: (s) => !s.withEcc
-  });
-  m.push({
-    source: "CLAUDE.md",
-    target: ".claude/CLAUDE.md",
-    type: "file",
-    applies: all
-  });
-  for (const a of CORE_AGENTS) {
-    m.push({
-      source: `agents/${a}.md`,
-      target: `.claude/agents/${a}.md`,
-      type: "file",
-      applies: all
-    });
-  }
-  for (const a of DEV_AGENTS) {
-    m.push({
-      source: `agents/${a}.md`,
-      target: `.claude/agents/${a}.md`,
-      type: "file",
-      applies: dev
-    });
-  }
-  for (const a of CORE_AGENTS_ECC) {
-    m.push({
-      source: `agents/${a}.md`,
-      target: `.claude/agents/${a}.md`,
-      type: "file",
-      applies: (s) => !s.withEcc
-    });
-  }
-  for (const a of DEV_AGENTS_ECC) {
-    m.push({
-      source: `agents/${a}.md`,
-      target: `.claude/agents/${a}.md`,
-      type: "file",
-      applies: (s) => !s.withEcc && hasDevTrack(s.tracks)
-    });
-  }
-  for (const sd of COMMON_SKILL_DIRS) {
-    m.push({
-      source: `skills/${sd}`,
-      target: `.claude/skills/${sd}`,
-      type: "dir",
-      applies: all
-    });
-  }
-  for (const sd of COMMON_SKILL_DIRS_ECC) {
-    m.push({
-      source: `skills/${sd}`,
-      target: `.claude/skills/${sd}`,
-      type: "dir",
-      applies: (s) => !s.withEcc
-    });
-  }
-  for (const sd of MODIFIED_COMMON_SKILL_DIRS) {
-    m.push({
-      source: `skills/${sd}`,
-      target: `.claude/skills/${sd}`,
-      type: "dir",
-      applies: all
-    });
-  }
-  m.push({
-    source: "skills/spec-scaling/SKILL.md",
-    target: ".claude/skills/spec-scaling/SKILL.md",
-    type: "file",
-    applies: all
-  });
-  m.push({
-    source: "skills/market-research",
-    target: ".claude/skills/market-research",
-    type: "dir",
-    applies: onTracks("executive|full")
-  });
-  for (const sd of ["investor-materials", "investor-outreach"]) {
-    m.push({
-      source: `skills/${sd}`,
-      target: `.claude/skills/${sd}`,
-      type: "dir",
-      applies: onTracks("executive|full")
-    });
-  }
-  m.push({
-    source: "skills/nextjs-turbopack",
-    target: ".claude/skills/nextjs-turbopack",
-    type: "dir",
-    applies: onTracks("ssr-nextjs|full")
-  });
-  for (const sd of INTERNAL_BUNDLED_SKILL_IDS) {
-    m.push({
-      source: `skills/${sd}`,
-      target: `.claude/skills/${sd}`,
-      type: "dir",
-      applies: (s) => (s.selectedInternalSkills ?? []).includes(sd)
-    });
-  }
-  for (const sd of PYTHON_SKILL_DIRS_ECC) {
-    m.push({
-      source: `skills/${sd}`,
-      target: `.claude/skills/${sd}`,
-      type: "dir",
-      applies: (s) => !s.withEcc && anyTrack(s.tracks, "data|csr-fastapi|full")
-    });
-  }
-  for (const sd of DEV_SKILL_DIRS) {
-    m.push({
-      source: `skills/${sd}`,
-      target: `.claude/skills/${sd}`,
-      type: "dir",
-      applies: dev
-    });
-  }
-  for (const sd of DEV_SKILL_DIRS_ECC) {
-    m.push({
-      source: `skills/${sd}`,
-      target: `.claude/skills/${sd}`,
-      type: "dir",
-      applies: (s) => !s.withEcc && hasDevTrack(s.tracks)
-    });
-  }
-  for (const sd of MODIFIED_DEV_SKILL_DIRS) {
-    m.push({
-      source: `skills/${sd}`,
-      target: `.claude/skills/${sd}`,
-      type: "dir",
-      applies: dev
-    });
-  }
-  for (const sd of UI_SKILL_DIRS) {
-    m.push({
-      source: `skills/${sd}`,
-      target: `.claude/skills/${sd}`,
-      type: "dir",
-      applies: ui
-    });
-  }
-  for (const sd of UI_SKILL_DIRS_ECC) {
-    m.push({
-      source: `skills/${sd}`,
-      target: `.claude/skills/${sd}`,
-      type: "dir",
-      applies: (s) => !s.withEcc && hasUiTrack(s.tracks)
-    });
-  }
-  for (const h2 of ALWAYS_HOOKS) {
-    m.push({
-      source: `hooks/${h2}`,
-      target: `.claude/hooks/${h2}`,
-      type: "file",
-      applies: all
-    });
-  }
-  m.push({
-    source: "settings.json",
-    target: ".claude/settings.json",
-    type: "file",
-    applies: all
-  });
-  return m;
-}
-
 // src/mcp-merge.ts
 init_esm_shims();
 import { existsSync as existsSync9, readFileSync as readFileSync8, writeFileSync as writeFileSync6 } from "fs";
@@ -2774,54 +2526,6 @@ function listHookFiles(hookDir) {
 // src/commands/install-render.ts
 init_esm_shims();
 
-// src/context-cost.ts
-init_esm_shims();
-import { existsSync as existsSync13, readFileSync as readFileSync12 } from "fs";
-import { join as join12, resolve as resolve2 } from "path";
-import { fileURLToPath } from "url";
-var CHARS_PER_TOKEN = 4;
-function estimateTokens(chars) {
-  return Math.ceil(chars / CHARS_PER_TOKEN);
-}
-function resolveBundleRoot() {
-  return resolve2(fileURLToPath(new URL(".", import.meta.url)), "..");
-}
-function extractFrontmatter(content) {
-  const m = content.match(/^?---\r?\n([\s\S]*?)\r?\n---/);
-  return m?.[1] ?? null;
-}
-function assetDescriptorTokens(assetId, root = resolveBundleRoot()) {
-  const asset = EXTERNAL_ASSETS.find((a) => a.id === assetId);
-  if (!asset || asset.method.kind !== "internal") return null;
-  const skillMd = join12(root, "templates", "skills", asset.method.key, "SKILL.md");
-  if (!existsSync13(skillMd)) return null;
-  const fm = extractFrontmatter(readFileSync12(skillMd, "utf8"));
-  return fm === null ? null : estimateTokens(fm.length);
-}
-function summarizeContextCost(assetIds, root = resolveBundleRoot()) {
-  let measuredTokens = 0;
-  let measuredCount = 0;
-  let unmeasuredCount = 0;
-  for (const id of assetIds) {
-    const tokens = assetDescriptorTokens(id, root);
-    if (tokens === null) unmeasuredCount += 1;
-    else {
-      measuredTokens += tokens;
-      measuredCount += 1;
-    }
-  }
-  return { measuredTokens, measuredCount, unmeasuredCount };
-}
-function formatContextCostLine(s) {
-  if (s.measuredCount === 0 && s.unmeasuredCount === 0) return null;
-  if (s.measuredCount === 0) {
-    return `session-start context cost: unmeasured (${s.unmeasuredCount} external asset${s.unmeasuredCount === 1 ? "" : "s"})`;
-  }
-  const skills = `${s.measuredCount} bundled skill${s.measuredCount === 1 ? "" : "s"} measured`;
-  const external = s.unmeasuredCount > 0 ? ` \xB7 ${s.unmeasuredCount} external unmeasured` : "";
-  return `session-start context cost: ~${s.measuredTokens} tokens (${skills}${external})`;
-}
-
 // src/preset-recommend.ts
 init_esm_shims();
 function recommendedExternalAssets(presets) {
@@ -2886,7 +2590,10 @@ function renderInstallHeader(log, spec, mode) {
     for (const [cat, ids] of groupAssetsByCategory(finalAssets)) {
       log(`              ${c.dim(`\xB7 ${cat}:`)} ${ids.join(", ")}`);
     }
-    const cost = formatContextCostLine(summarizeContextCost(finalAssets));
+    const cost = formatResidentCostLine(
+      residentCost(buildManifest(spec).filter((e2) => e2.applies(spec))),
+      summarizeContextCost(finalAssets).unmeasuredCount
+    );
     if (cost) log(`              ${c.dim(`\xB7 ${cost}`)}`);
   }
   log("");
@@ -3361,7 +3068,7 @@ function installAction(options, deps = {}) {
       withKarpathyHook: options.withKarpathyHook === true
     },
     cli: validated.cli,
-    projectDir: resolve3(options.projectDir ?? process.cwd()),
+    projectDir: resolve2(options.projectDir ?? process.cwd()),
     scope: resolveScopeOption(options.scope, err)
   };
   executeSpec(spec, {
@@ -3430,7 +3137,7 @@ function defaultRunPipeline(spec, harnessRoot, mode, callbacks) {
   return runInstall(ctx);
 }
 function defaultHarnessRoot() {
-  return resolve3(fileURLToPath2(new URL(".", import.meta.url)), "..");
+  return resolve2(fileURLToPath(new URL(".", import.meta.url)), "..");
 }
 function registerInstallCommand(cli2) {
   cli2.command("install", "Install harness assets into a project").option("--track <name>", "[Track] Track to install (repeatable)", { type: [String] }).option(
@@ -3465,15 +3172,15 @@ function registerInstallCommand(cli2) {
 // src/commands/uninstall.ts
 init_esm_shims();
 import { spawnSync as spawnSync2 } from "child_process";
-import { existsSync as existsSync14, readFileSync as readFileSync13, rmSync } from "fs";
-import { join as join13, resolve as resolve4 } from "path";
+import { existsSync as existsSync13, readFileSync as readFileSync12, rmSync } from "fs";
+import { join as join12, resolve as resolve3 } from "path";
 function uninstallAction(options, deps = {}) {
   const log = deps.log ?? console.log;
   const err = deps.err ?? console.error;
   const exit = deps.exit ?? ((code) => process.exit(code));
   const spawn = deps.spawn ?? defaultSpawn2;
   const rm = deps.rm ?? defaultRm;
-  const projectDir = resolve4(options.projectDir ?? process.cwd());
+  const projectDir = resolve3(options.projectDir ?? process.cwd());
   const installLog = readInstallLog(projectDir);
   if (!installLog) {
     err(status.failure(c.red(`ERROR: install log not found at ${installLogPath(projectDir)}`)));
@@ -3638,22 +3345,22 @@ function buildGlobalAdvisoryCmd(asset) {
   }
 }
 function removeTemplates(log, projectDir, rm) {
-  rm(join13(projectDir, log.templates.claudeDir));
-  if (log.templates.codexDir) rm(join13(projectDir, log.templates.codexDir));
-  if (log.templates.opencodeDir) rm(join13(projectDir, log.templates.opencodeDir));
+  rm(join12(projectDir, log.templates.claudeDir));
+  if (log.templates.codexDir) rm(join12(projectDir, log.templates.codexDir));
+  if (log.templates.opencodeDir) rm(join12(projectDir, log.templates.opencodeDir));
   const rootMd = log.templates.rootClaudeMd;
   if (rootMd) {
     if (rootClaudeMdModified(log, projectDir)) return { rootClaudeMdKept: true };
-    rm(join13(projectDir, rootMd.path));
+    rm(join12(projectDir, rootMd.path));
   }
   return { rootClaudeMdKept: false };
 }
 function rootClaudeMdModified(log, projectDir) {
   const rootMd = log.templates.rootClaudeMd;
   if (!rootMd) return false;
-  const path = join13(projectDir, rootMd.path);
-  if (!existsSync14(path)) return false;
-  return hashContent(readFileSync13(path, "utf8")) !== rootMd.sha256;
+  const path = join12(projectDir, rootMd.path);
+  if (!existsSync13(path)) return false;
+  return hashContent(readFileSync12(path, "utf8")) !== rootMd.sha256;
 }
 function formatTemplateList(log) {
   const items = [log.templates.claudeDir];
@@ -3665,7 +3372,7 @@ function defaultSpawn2(cmd, args) {
   return spawnSync2(cmd, [...args], { encoding: "utf8", stdio: "pipe", timeout: 12e4 });
 }
 function defaultRm(path) {
-  if (existsSync14(path)) {
+  if (existsSync13(path)) {
     rmSync(path, { recursive: true, force: true });
   }
 }
@@ -4959,8 +4666,8 @@ Proceed?`,
 
 // src/state.ts
 init_esm_shims();
-import { existsSync as existsSync15, readFileSync as readFileSync14 } from "fs";
-import { join as join14 } from "path";
+import { existsSync as existsSync14, readFileSync as readFileSync13 } from "fs";
+import { join as join13 } from "path";
 var META_FILE = ".claude/.installed-tracks";
 var LEGACY_SIGNATURES = [
   { rule: "htmx.md", track: "ssr-htmx" },
@@ -4970,13 +4677,13 @@ var LEGACY_SIGNATURES = [
   { rule: "cli-development.md", track: "tooling" }
 ];
 function detectInstallState(projectDir) {
-  const claudeDir = join14(projectDir, ".claude");
-  const hasClaudeDir = existsSync15(claudeDir);
+  const claudeDir = join13(projectDir, ".claude");
+  const hasClaudeDir = existsSync14(claudeDir);
   if (!hasClaudeDir) {
     return { state: "new", tracks: [], source: "none", hasClaudeDir: false };
   }
-  const metaPath = join14(projectDir, META_FILE);
-  if (existsSync15(metaPath)) {
+  const metaPath = join13(projectDir, META_FILE);
+  if (existsSync14(metaPath)) {
     const tracks2 = readMetafile(metaPath);
     return { state: "existing", tracks: tracks2, source: "metafile", hasClaudeDir: true };
   }
@@ -4984,7 +4691,7 @@ function detectInstallState(projectDir) {
   return { state: "existing", tracks, source: "legacy", hasClaudeDir: true };
 }
 function readMetafile(path) {
-  const raw = readFileSync14(path, "utf8");
+  const raw = readFileSync13(path, "utf8");
   const seen = /* @__PURE__ */ new Set();
   for (const line of raw.split(/\s+/)) {
     const trimmed = line.trim();
@@ -4995,13 +4702,13 @@ function readMetafile(path) {
   return [...seen].sort();
 }
 function inferFromLegacySignatures(projectDir) {
-  const rulesDir = join14(projectDir, ".claude/rules");
-  if (!existsSync15(rulesDir)) {
+  const rulesDir = join13(projectDir, ".claude/rules");
+  if (!existsSync14(rulesDir)) {
     return [];
   }
   const found = /* @__PURE__ */ new Set();
   for (const sig of LEGACY_SIGNATURES) {
-    if (existsSync15(join14(rulesDir, sig.rule))) {
+    if (existsSync14(join13(rulesDir, sig.rule))) {
       found.add(sig.track);
     }
   }
@@ -5214,7 +4921,10 @@ function formatSummary(spec) {
     for (const [cat, ids] of groupAssetsByCategory(finalAssets)) {
       lines.push(`  \xB7 ${cat}: ${ids.join(", ")}`);
     }
-    const cost = formatContextCostLine(summarizeContextCost(finalAssets));
+    const cost = formatResidentCostLine(
+      residentCost(buildManifest(spec).filter((e2) => e2.applies(spec))),
+      summarizeContextCost(finalAssets).unmeasuredCount
+    );
     if (cost) lines.push(`  \xB7 ${cost}`);
   }
   if (spec.userOverride) {