harnessed 3.4.0 → 3.4.2

package/README.md

@@ -1,6 +1,6 @@
 # harnessed
 
-**English** | [中文](./README-cn.md)
+**English** | [简体中文](./README-cn.md) | [繁體中文](./README-tw.md) | [日本語](./README-ja.md) | [한국어](./README-ko.md) | [Português (Brasil)](./README-pt-BR.md) | [Türkçe](./README-tr.md) | [Русский](./README-ru.md) | [Tiếng Việt](./README-vi.md) | [ไทย](./README-th.md)
 
 > AI coding harness package manager + composition orchestrator
 > Machine-executes the three-layer-stack collaboration methodology (gstack governance + GSD project manager + superpowers senior engineer + karpathy principles + mattpocock moves) as a runnable engine
@@ -15,7 +15,7 @@
 
 ## ✨ TL;DR
 
-Assembles the best open-source Claude Code ecosystem components, weaving them into a unified workflow via opinionated composition skills; does not vendor upstream code — manifests describe install/check, and composition skills orchestrate multi-upstream collaboration.
+**Best-practice orchestration for Harness Engineering on Claude Code** — assembles the best open-source Claude Code ecosystem components, weaving them into a unified workflow via opinionated composition skills; does not vendor upstream code — manifests describe install/check, and composition skills orchestrate multi-upstream collaboration.
 
 ---
 

package/dist/cli.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { execSync, spawnSync, spawn } from 'child_process';
-import { existsSync, mkdirSync, renameSync, writeFileSync, readFileSync, appendFileSync, readdirSync } from 'fs';
+import { existsSync, mkdirSync, renameSync, writeFileSync, readFileSync, readdirSync, appendFileSync } from 'fs';
 import { join, resolve, dirname, relative } from 'path';
 import { homedir } from 'os';
 import { Type } from '@sinclair/typebox';
@@ -847,7 +847,7 @@ var init_resume = __esm({
 
 // package.json
 var package_default = {
-  version: "3.4.0"};
+  version: "3.4.2"};
 
 // src/manifest/errors.ts
 function instancePathToKeyPath(instancePath) {
@@ -5020,6 +5020,182 @@ async function atomicWrite2(path, content) {
     return `write ${path} failed: ${err2.message}`;
   }
 }
+function readInstalledPlugins(homedirOverride) {
+  const home = homedir();
+  const path = join(home, ".claude", "plugins", "installed_plugins.json");
+  let raw;
+  try {
+    raw = readFileSync(path, "utf8");
+  } catch {
+    return /* @__PURE__ */ new Set();
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
+    return /* @__PURE__ */ new Set();
+  }
+  if (!parsed || typeof parsed !== "object") return /* @__PURE__ */ new Set();
+  const plugins = parsed.plugins;
+  if (!plugins || typeof plugins !== "object") return /* @__PURE__ */ new Set();
+  const out = /* @__PURE__ */ new Set();
+  for (const key of Object.keys(plugins)) {
+    const at = key.indexOf("@");
+    if (at <= 0) continue;
+    out.add(key.slice(0, at));
+  }
+  return out;
+}
+function readInstalledUserSkills(homedirOverride) {
+  const home = homedir();
+  const skillsRoot = join(home, ".claude", "skills");
+  try {
+    const entries = readdirSync(skillsRoot, { withFileTypes: true });
+    const out = /* @__PURE__ */ new Set();
+    for (const e of entries) if (e.isDirectory()) out.add(e.name);
+    return out;
+  } catch {
+    return /* @__PURE__ */ new Set();
+  }
+}
+function resolveCapabilityCmd(capability, installedPlugins, installedUserSkills) {
+  const { cmd, install_type, plugin_id, skill_dir } = capability;
+  if (!install_type) return { renderedCmd: cmd };
+  const types = Array.isArray(install_type) ? install_type : [install_type];
+  const uniqueTypes = [...new Set(types)];
+  const missingHints = [];
+  let anyDetected = false;
+  for (const t2 of uniqueTypes) {
+    if (t2 === "plugin") {
+      if (!plugin_id) {
+        missingHints.push(
+          `install_type=plugin declared but no plugin_id (capabilities.yaml schema bug)`
+        );
+        continue;
+      }
+      if (installedPlugins.has(plugin_id)) {
+        anyDetected = true;
+        break;
+      }
+      missingHints.push(`plugin '${plugin_id}' (\`claude plugin install ${plugin_id}\`)`);
+    } else {
+      if (!skill_dir) {
+        missingHints.push(
+          `install_type=user-skill declared but no skill_dir (capabilities.yaml schema bug)`
+        );
+        continue;
+      }
+      if (installedUserSkills.has(skill_dir)) {
+        anyDetected = true;
+        break;
+      }
+      missingHints.push(
+        `user-skill '${skill_dir}' under ~/.claude/skills/ (git clone the official repo; e.g. gstack: \`git clone https://github.com/garrytan/gstack.git ~/.claude/skills/gstack && cd ~/.claude/skills/gstack && ./setup\`)`
+      );
+    }
+  }
+  if (anyDetected) return { renderedCmd: cmd };
+  const prefix = uniqueTypes.length > 1 ? "[multi]" : `[${uniqueTypes[0]}]`;
+  const joined = missingHints.join(" OR ");
+  return {
+    renderedCmd: cmd,
+    warning: `${prefix} '${cmd}' backing missing \u2014 install either: ${joined}.`
+  };
+}
+var CAPABILITY_CMD_TEMPLATE = /\{\{\s*capabilities\.([a-zA-Z0-9_-]+)\.cmd\s*\}\}/g;
+function renderSkillBody(body, capabilities, installedPlugins, installedUserSkills) {
+  const warningsSet = /* @__PURE__ */ new Set();
+  const out = body.replace(CAPABILITY_CMD_TEMPLATE, (match2, name) => {
+    const cap = capabilities[name];
+    if (!cap) {
+      warningsSet.add(
+        `capability '${name}' referenced in SKILL.md but not defined in capabilities.yaml`
+      );
+      return match2;
+    }
+    const { renderedCmd, warning } = resolveCapabilityCmd(
+      cap,
+      installedPlugins,
+      installedUserSkills
+    );
+    if (warning) warningsSet.add(warning);
+    return renderedCmd;
+  });
+  return { body: out, warnings: [...warningsSet] };
+}
+
+// src/cli/lib/renderSkillTemplates.ts
+async function loadCapabilities(workflowsDir) {
+  const path = join(workflowsDir, "capabilities.yaml");
+  const raw = await readFile(path, "utf8");
+  const doc = parse(raw);
+  return doc?.capabilities ?? {};
+}
+async function renderSkillFile(skillName, skillsBase, capabilities, installedPlugins, installedUserSkills) {
+  const skillPath = join(skillsBase, skillName, "SKILL.md");
+  const result = {
+    name: skillName,
+    skillPath,
+    rendered: false,
+    warnings: []
+  };
+  let body;
+  try {
+    body = await readFile(skillPath, "utf8");
+  } catch (e) {
+    result.error = `read failed: ${e.message}`;
+    return result;
+  }
+  const rendered = renderSkillBody(body, capabilities, installedPlugins, installedUserSkills);
+  if (rendered.body === body) {
+    result.warnings = rendered.warnings;
+    return result;
+  }
+  try {
+    await writeFile(skillPath, rendered.body, "utf8");
+    result.rendered = true;
+    result.warnings = rendered.warnings;
+  } catch (e) {
+    result.error = `write failed: ${e.message}`;
+  }
+  return result;
+}
+async function renderAllSkills(skillNames, skillsBase, workflowsDir, homedirOverride) {
+  let capabilities = {};
+  try {
+    capabilities = await loadCapabilities(workflowsDir);
+  } catch (e) {
+    return {
+      results: skillNames.map((name) => ({
+        name,
+        skillPath: join(skillsBase, name, "SKILL.md"),
+        rendered: false,
+        warnings: [],
+        error: `capabilities.yaml load failed: ${e.message}`
+      })),
+      aggregatedWarnings: [
+        `capabilities.yaml unreadable \u2014 SKILL.md placeholders left verbatim (${e.message})`
+      ]
+    };
+  }
+  const installedPlugins = readInstalledPlugins();
+  const installedUserSkills = readInstalledUserSkills();
+  const results = [];
+  const warningSet = /* @__PURE__ */ new Set();
+  for (const name of skillNames) {
+    const r = await renderSkillFile(
+      name,
+      skillsBase,
+      capabilities,
+      installedPlugins,
+      installedUserSkills
+    );
+    results.push(r);
+    for (const w of r.warnings) warningSet.add(w);
+    if (r.error) warningSet.add(`${name}: ${r.error}`);
+  }
+  return { results, aggregatedWarnings: [...warningSet] };
+}
 init_checkAgentTeams();
 var FLAT_LEGACY_DEPRECATED = /* @__PURE__ */ new Set(["plan-feature", "execute-task", "verify-work"]);
 var FLAT_LEGACY_KEEP = /* @__PURE__ */ new Set(["research", "retro", "auto"]);
@@ -5240,6 +5416,21 @@ function registerSetup(program2) {
       }
     }
     console.log(t("setup.step_a_complete", { count: skillsInstalled, path: skillsBase }));
+    const skillNames = toInstall.map((wf) => wf.name);
+    const rendered = await renderAllSkills(skillNames, skillsBase, workflowsDir);
+    const renderedCount = rendered.results.filter((r) => r.rendered).length;
+    console.log(
+      t("setup.step_a_render.complete", {
+        count: renderedCount,
+        total: skillsInstalled
+      })
+    );
+    if (rendered.aggregatedWarnings.length > 0) {
+      console.warn(t("setup.step_a_render.warnings_header"));
+      for (const w of rendered.aggregatedWarnings) {
+        console.warn(`    - ${w}`);
+      }
+    }
     const cResult = await enableAgentTeamsInSettings();
     if (cResult.status === "created") {
       console.log(t("setup.step_c.created", { path: cResult.path }));