@uzysjung/agent-harness 26.101.0 → 26.103.0

package/dist/index.js

@@ -2,20 +2,29 @@
 import {
   CATEGORIES,
   CATEGORY_TITLES,
+  CLI_BASES,
+  DEFAULT_OPTIONS,
   DEV_METHOD_SKILL_IDS,
   EXTERNAL_ASSETS,
   INTERNAL_BUNDLED_SKILL_IDS,
+  TRACKS,
   __commonJS,
   __toESM,
   anyTrack,
+  assetCliSupport,
+  assetReachesCli,
   assetTrustTier,
   experimentalOptInCandidates,
   filterApplicableAssets,
   hasDevTrack,
   hasUiTrack,
   init_esm_shims,
-  isAssetSelected
-} from "./chunk-S3SQJRYD.js";
+  isAssetSelected,
+  isCliBase,
+  isInstallScope,
+  isTrack,
+  resolveScope
+} from "./chunk-4QB5UQDP.js";
 
 // node_modules/sisteransi/src/index.js
 var require_src = __commonJS({
@@ -700,7 +709,7 @@ var cac = (name = "") => new CAC(name);
 // package.json
 var package_default = {
   name: "@uzysjung/agent-harness",
-  version: "26.101.0",
+  version: "26.103.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: {
@@ -754,47 +763,11 @@ var package_default = {
 
 // src/commands/install.ts
 init_esm_shims();
-import { resolve as resolve2 } from "path";
+import { resolve as resolve3 } from "path";
+import { fileURLToPath as fileURLToPath2 } from "url";
 
 // src/cli-targets.ts
 init_esm_shims();
-
-// src/types.ts
-init_esm_shims();
-var TRACKS = [
-  "tooling",
-  "csr-supabase",
-  "csr-fastify",
-  "csr-fastapi",
-  "ssr-htmx",
-  "ssr-nextjs",
-  "data",
-  "executive",
-  "full",
-  "project-management",
-  "growth-marketing"
-];
-function isTrack(value) {
-  return typeof value === "string" && TRACKS.includes(value);
-}
-var CLI_BASES = ["claude", "codex", "opencode", "antigravity"];
-function isCliBase(value) {
-  return typeof value === "string" && CLI_BASES.includes(value);
-}
-var INSTALL_SCOPES = ["project", "global"];
-function isInstallScope(value) {
-  return typeof value === "string" && INSTALL_SCOPES.includes(value);
-}
-function resolveScope(scope) {
-  return scope ?? "project";
-}
-var DEFAULT_OPTIONS = {
-  withPrune: false,
-  withCodexTrust: false,
-  withKarpathyHook: false
-};
-
-// src/cli-targets.ts
 var CLI_BASE_SORT_ORDER = {
   claude: 0,
   codex: 1,
@@ -1497,6 +1470,15 @@ import { existsSync as existsSync6, readdirSync, readFileSync as readFileSync6 }
 import { homedir as homedir2 } from "os";
 import { join as join6 } from "path";
 var DEFAULT_SPAWN_TIMEOUT_MS = 12e4;
+function selectExternalTargets(assets, ctx) {
+  const conditionPassed = filterApplicableAssets(assets, ctx).filter(
+    (a) => a.method.kind !== "internal"
+  );
+  return {
+    targets: conditionPassed.filter((a) => assetReachesCli(a, ctx.cli)),
+    excludedByCli: conditionPassed.filter((a) => !assetReachesCli(a, ctx.cli))
+  };
+}
 function runExternalInstall(ctx, deps = {}) {
   const log = deps.log ?? console.log;
   const warn = deps.warn ?? console.error;
@@ -1504,9 +1486,7 @@ function runExternalInstall(ctx, deps = {}) {
   const assets = deps.assets ?? EXTERNAL_ASSETS;
   const harnessRoot = deps.harnessRoot ?? process.cwd();
   const projectDir = ctx.projectDir ?? process.cwd();
-  const applicable = filterApplicableAssets(assets, ctx).filter(
-    (a) => a.method.kind !== "internal"
-  );
+  const { targets: applicable, excludedByCli } = selectExternalTargets(assets, ctx);
   const sorted = [...applicable].sort((a, b2) => {
     const ai = CATEGORIES.indexOf(a.category);
     const bi = CATEGORIES.indexOf(b2.category);
@@ -1533,7 +1513,8 @@ function runExternalInstall(ctx, deps = {}) {
   return {
     attempted,
     succeeded: attempted.filter((r) => r.ok).length,
-    skipped: attempted.filter((r) => !r.ok).length
+    skipped: attempted.filter((r) => !r.ok).length,
+    excludedByCli
   };
 }
 function installOne(asset, ctx) {
@@ -2612,7 +2593,10 @@ function runExternalPhase(ctx) {
     options: spec.options,
     ...spec.userOverride ? { userOverride: spec.userOverride } : {}
   };
-  const applicableCount = filterApplicableAssets(EXTERNAL_ASSETS, filterCtx).length;
+  const applicableCount = selectExternalTargets(EXTERNAL_ASSETS, {
+    ...filterCtx,
+    cli: spec.cli
+  }).targets.length;
   ctx.onProgress?.({ type: "external-start", assetCount: applicableCount });
   const external = runExt(
     { ...filterCtx, cli: spec.cli, projectDir, ...spec.scope ? { scope: spec.scope } : {} },
@@ -2736,6 +2720,54 @@ function listHookFiles(hookDir) {
 // src/commands/install-render.ts
 init_esm_shims();
 
+// src/context-cost.ts
+init_esm_shims();
+import { existsSync as existsSync12, readFileSync as readFileSync12 } from "fs";
+import { join as join11, 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 = join11(root, "templates", "skills", asset.method.key, "SKILL.md");
+  if (!existsSync12(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) {
@@ -2791,10 +2823,17 @@ function renderInstallHeader(log, spec, mode) {
   log(infoRow("OPTIONS", formatOptions(spec)));
   const finalAssets = finalSelectedAssets(spec.tracks, spec.userOverride);
   if (finalAssets.length > 0) {
-    log(infoRow("ASSETS", `${finalAssets.length} selected`));
+    const unreachable = finalAssets.filter((id) => {
+      const asset = EXTERNAL_ASSETS.find((a) => a.id === id);
+      return asset ? !assetReachesCli(asset, spec.cli) : false;
+    });
+    const label = unreachable.length > 0 ? `${finalAssets.length} selected (${unreachable.length} outside [${spec.cli.join(", ")}] reach \u2014 not installed)` : `${finalAssets.length} selected`;
+    log(infoRow("ASSETS", label));
     for (const [cat, ids] of groupAssetsByCategory(finalAssets)) {
       log(`              ${c.dim(`\xB7 ${cat}:`)} ${ids.join(", ")}`);
     }
+    const cost = formatContextCostLine(summarizeContextCost(finalAssets));
+    if (cost) log(`              ${c.dim(`\xB7 ${cost}`)}`);
   }
   log("");
 }
@@ -2804,12 +2843,32 @@ function createInstallRenderer(log, spec, verbose) {
   const callbacks = {
     onProgress: (event) => {
       if (event.type === "baseline-complete") {
-        const eccSelected = isAssetSelected("ecc-plugin", spec) || spec.options.withPrune === true;
-        renderPhase1Rows(log, event.baseline, verbose, eccSelected);
+        const claudeSelected = targetsInclude(spec.cli, "claude");
+        const eccWillInstall = claudeSelected && (isAssetSelected("ecc-plugin", spec) || spec.options.withPrune === true);
+        renderPhase1Rows(log, event.baseline, verbose, eccWillInstall, claudeSelected);
       } else if (event.type === "external-start" && event.assetCount > 0) {
         log(unifiedSection(`External assets (${event.assetCount})`));
         log("");
         phase2HeaderPrinted = true;
+      } else if (event.type === "external-complete") {
+        const excluded = event.report.excludedByCli;
+        if (excluded.length > 0) {
+          if (!phase2HeaderPrinted) {
+            log(unifiedSection("External assets (0)"));
+            phase2HeaderPrinted = true;
+          }
+          const bySupport = /* @__PURE__ */ new Map();
+          for (const a of excluded) {
+            const key = assetCliSupport(a).join("/");
+            bySupport.set(key, [...bySupport.get(key) ?? [], a.id]);
+          }
+          log("");
+          for (const [support, ids] of bySupport) {
+            log(
+              `  ${c.dim(`\xB7 ${ids.length} asset(s) not installed \u2014 requires ${support}, selected [${spec.cli.join(", ")}]: ${ids.join(", ")}`)}`
+            );
+          }
+        }
       }
     },
     externalDeps: {
@@ -2917,22 +2976,17 @@ function renderFinalSummary(log, spec, report, fromWizard) {
       )
     );
   }
-  const nonClaudeCli = spec.cli.filter((b2) => b2 !== "claude");
-  if (nonClaudeCli.length > 0) {
-    const claudeOnlyPlugins = EXTERNAL_ASSETS.filter(
-      (a) => a.method.kind === "plugin" && isAssetSelected(a.id, spec)
-    );
-    if (claudeOnlyPlugins.length > 0) {
-      log("");
-      log(
-        infoRow(
-          "NOTE",
-          c.dim(
-            `${claudeOnlyPlugins.length} plugin asset${claudeOnlyPlugins.length > 1 ? "s" : ""} are Claude Code-only \u2014 not installed for ${nonClaudeCli.map((b2) => CLI_SUMMARY_LABELS[b2]).join("/")}: ${claudeOnlyPlugins.map((a) => a.id).join(", ")}`
-          )
+  if (report.external && report.external.excludedByCli.length > 0) {
+    const excluded = report.external.excludedByCli;
+    log("");
+    log(
+      infoRow(
+        "EXCLUDED",
+        c.dim(
+          `${excluded.length} asset${excluded.length > 1 ? "s" : ""} not installed \u2014 outside [${spec.cli.join(", ")}] reach: ${excluded.map((a) => a.id).join(", ")}`
         )
-      );
-    }
+      )
+    );
   }
   if (!fromWizard) {
     const optIn = experimentalOptInCandidates(spec);
@@ -2992,7 +3046,7 @@ function formatAssetMeta(asset, version) {
       return `internal \xB7 templates (${m.key})`;
   }
 }
-function renderPhase1Rows(log, baseline, verbose = false, withEcc = false) {
+function renderPhase1Rows(log, baseline, verbose = false, withEcc = false, claudeSelected = true) {
   if (baseline.updateMode) {
     if (baseline.backup) {
       log(assetRow("success", "backup", shortenPath(baseline.backup)));
@@ -3115,7 +3169,9 @@ function renderPhase1Rows(log, baseline, verbose = false, withEcc = false) {
     log(
       `  ${c.dim("\xB7")} ${c.dim("ECC plugin not selected \u2014 cherry-pick fallback active (up to 4 agents + 8 skills + 3 commands)")}`
     );
-    log(`  ${c.dim("\xB7")} ${c.dim("Use --with ecc-plugin to install ECC plugin instead")}`);
+    if (claudeSelected) {
+      log(`  ${c.dim("\xB7")} ${c.dim("Use --with ecc-plugin to install ECC plugin instead")}`);
+    }
   }
   if (baseline.envFiles.envExampleCreated) {
     log(assetRow("success", ".env.example", "Supabase token guide"));
@@ -3243,7 +3299,7 @@ function installAction(options, deps = {}) {
       withKarpathyHook: options.withKarpathyHook === true
     },
     cli: validated.cli,
-    projectDir: resolve2(options.projectDir ?? process.cwd()),
+    projectDir: resolve3(options.projectDir ?? process.cwd()),
     scope: resolveScopeOption(options.scope, err)
   };
   executeSpec(spec, {
@@ -3312,7 +3368,7 @@ function defaultRunPipeline(spec, harnessRoot, mode, callbacks) {
   return runInstall(ctx);
 }
 function defaultHarnessRoot() {
-  return resolve2(new URL(".", import.meta.url).pathname, "..");
+  return resolve3(fileURLToPath2(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(
@@ -3347,15 +3403,15 @@ function registerInstallCommand(cli2) {
 // src/commands/uninstall.ts
 init_esm_shims();
 import { spawnSync as spawnSync2 } from "child_process";
-import { existsSync as existsSync12, readFileSync as readFileSync12, rmSync } from "fs";
-import { join as join11, resolve as resolve3 } from "path";
+import { existsSync as existsSync13, readFileSync as readFileSync13, rmSync } from "fs";
+import { join as join12, resolve as resolve4 } 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 = resolve3(options.projectDir ?? process.cwd());
+  const projectDir = resolve4(options.projectDir ?? process.cwd());
   const installLog = readInstallLog(projectDir);
   if (!installLog) {
     err(status.failure(c.red(`ERROR: install log not found at ${installLogPath(projectDir)}`)));
@@ -3520,22 +3576,22 @@ function buildGlobalAdvisoryCmd(asset) {
   }
 }
 function removeTemplates(log, projectDir, rm) {
-  rm(join11(projectDir, log.templates.claudeDir));
-  if (log.templates.codexDir) rm(join11(projectDir, log.templates.codexDir));
-  if (log.templates.opencodeDir) rm(join11(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(join11(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 = join11(projectDir, rootMd.path);
-  if (!existsSync12(path)) return false;
-  return hashContent(readFileSync12(path, "utf8")) !== rootMd.sha256;
+  const path = join12(projectDir, rootMd.path);
+  if (!existsSync13(path)) return false;
+  return hashContent(readFileSync13(path, "utf8")) !== rootMd.sha256;
 }
 function formatTemplateList(log) {
   const items = [log.templates.claudeDir];
@@ -3547,7 +3603,7 @@ function defaultSpawn2(cmd, args) {
   return spawnSync2(cmd, [...args], { encoding: "utf8", stdio: "pipe", timeout: 12e4 });
 }
 function defaultRm(path) {
-  if (existsSync12(path)) {
+  if (existsSync13(path)) {
     rmSync(path, { recursive: true, force: true });
   }
 }
@@ -4841,8 +4897,8 @@ Proceed?`,
 
 // src/state.ts
 init_esm_shims();
-import { existsSync as existsSync13, readFileSync as readFileSync13 } from "fs";
-import { join as join12 } from "path";
+import { existsSync as existsSync14, readFileSync as readFileSync14 } from "fs";
+import { join as join13 } from "path";
 var META_FILE = ".claude/.installed-tracks";
 var LEGACY_SIGNATURES = [
   { rule: "htmx.md", track: "ssr-htmx" },
@@ -4852,13 +4908,13 @@ var LEGACY_SIGNATURES = [
   { rule: "cli-development.md", track: "tooling" }
 ];
 function detectInstallState(projectDir) {
-  const claudeDir = join12(projectDir, ".claude");
-  const hasClaudeDir = existsSync13(claudeDir);
+  const claudeDir = join13(projectDir, ".claude");
+  const hasClaudeDir = existsSync14(claudeDir);
   if (!hasClaudeDir) {
     return { state: "new", tracks: [], source: "none", hasClaudeDir: false };
   }
-  const metaPath = join12(projectDir, META_FILE);
-  if (existsSync13(metaPath)) {
+  const metaPath = join13(projectDir, META_FILE);
+  if (existsSync14(metaPath)) {
     const tracks2 = readMetafile(metaPath);
     return { state: "existing", tracks: tracks2, source: "metafile", hasClaudeDir: true };
   }
@@ -4866,7 +4922,7 @@ function detectInstallState(projectDir) {
   return { state: "existing", tracks, source: "legacy", hasClaudeDir: true };
 }
 function readMetafile(path) {
-  const raw = readFileSync13(path, "utf8");
+  const raw = readFileSync14(path, "utf8");
   const seen = /* @__PURE__ */ new Set();
   for (const line of raw.split(/\s+/)) {
     const trimmed = line.trim();
@@ -4877,13 +4933,13 @@ function readMetafile(path) {
   return [...seen].sort();
 }
 function inferFromLegacySignatures(projectDir) {
-  const rulesDir = join12(projectDir, ".claude/rules");
-  if (!existsSync13(rulesDir)) {
+  const rulesDir = join13(projectDir, ".claude/rules");
+  if (!existsSync14(rulesDir)) {
     return [];
   }
   const found = /* @__PURE__ */ new Set();
   for (const sig of LEGACY_SIGNATURES) {
-    if (existsSync13(join12(rulesDir, sig.rule))) {
+    if (existsSync14(join13(rulesDir, sig.rule))) {
       found.add(sig.track);
     }
   }
@@ -5086,10 +5142,18 @@ function formatSummary(spec) {
   ];
   const finalAssets = finalSelectedAssets(spec.tracks, spec.userOverride);
   if (finalAssets.length > 0) {
-    lines.push(`Assets:    ${finalAssets.length} selected`);
+    const unreachable = finalAssets.filter((id) => {
+      const asset = EXTERNAL_ASSETS.find((a) => a.id === id);
+      return asset ? !assetReachesCli(asset, spec.cli) : false;
+    });
+    lines.push(
+      unreachable.length > 0 ? `Assets:    ${finalAssets.length} selected (${unreachable.length} outside [${spec.cli.join(", ")}] reach \u2014 not installed)` : `Assets:    ${finalAssets.length} selected`
+    );
     for (const [cat, ids] of groupAssetsByCategory(finalAssets)) {
       lines.push(`  \xB7 ${cat}: ${ids.join(", ")}`);
     }
+    const cost = formatContextCostLine(summarizeContextCost(finalAssets));
+    if (cost) lines.push(`  \xB7 ${cost}`);
   }
   if (spec.userOverride) {
     if (spec.userOverride.forceInclude.length > 0) {