harnessed 3.4.0 → 3.4.1

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

@@ -847,7 +847,7 @@ var init_resume = __esm({
 
 // package.json
 var package_default = {
-  version: "3.4.0"};
+  version: "3.4.1"};
 
 // src/manifest/errors.ts
 function instancePathToKeyPath(instancePath) {
@@ -5020,6 +5020,129 @@ 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 resolveCapabilityCmd(capability, installedPlugins) {
+  const { cmd, plugin_namespace } = capability;
+  if (!plugin_namespace) return { renderedCmd: cmd };
+  if (cmd.includes(":")) return { renderedCmd: cmd };
+  if (!cmd.startsWith("/")) return { renderedCmd: cmd };
+  if (!installedPlugins.has(plugin_namespace)) {
+    return {
+      renderedCmd: cmd,
+      warning: `plugin '${plugin_namespace}' not installed \u2014 '${cmd}' will not resolve via Claude Code. install: 'claude plugin install ${plugin_namespace}' or see plugin docs.`
+    };
+  }
+  const bare = cmd.slice(1);
+  return { renderedCmd: `/${plugin_namespace}:${bare}` };
+}
+var CAPABILITY_CMD_TEMPLATE = /\{\{\s*capabilities\.([a-zA-Z0-9_-]+)\.cmd\s*\}\}/g;
+function renderSkillBody(body, capabilities, installedPlugins) {
+  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);
+    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) {
+  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);
+  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 results = [];
+  const warningSet = /* @__PURE__ */ new Set();
+  for (const name of skillNames) {
+    const r = await renderSkillFile(name, skillsBase, capabilities, installedPlugins);
+    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 +5363,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 }));