handyman-harness 3.0.0 → 3.1.0

package/assets/feature-request.template.md

@@ -31,10 +31,10 @@ request before you start.
 # - The green gate (./init.sh | bash tests/run_tests.sh) is ALWAYS the last Acceptance bullet.
 # - Choose an archetype: [Research] leaves a plan in docs/ ; [Implementation] changes code + tests.
 # - Fill the CORE always; delete the OPTIONAL sections that do not apply (no placeholders).
-# - Only name, title, description, and acceptance become the feature_list.json entry (via node dist/feature.js add);
+# - Only name, title, description, and acceptance become the feature_list.json entry (via npx handyman-harness@3 feature add);
 #   Verification, Considerations, Tools, and Post-feature are guidance for the leader and the human.
 # - Tools: skills come from discovery.skills and agents from discovery.agents (harness.config.json);
-#   verify both are installed with node dist/tools_discovery.js check. See references/discovery.md.
+#   verify both are installed with npx handyman-harness@3 tools_discovery check. See references/discovery.md.
 
 ## ───── CORE (fill always) ─────
 
@@ -58,7 +58,7 @@ request before you start.
 
 ## Tools
 - skills: <handyman, ...>
-- agents (optional): <implementer, reviewer, explorer>   # from discovery.agents; verify with node dist/tools_discovery.js check
+- agents (optional): <implementer, reviewer, explorer>   # from discovery.agents; verify with npx handyman-harness@3 tools_discovery check
 
 ## ───── OPTIONAL (fill only if it applies; otherwise delete the section) ─────
 
@@ -69,7 +69,7 @@ request before you start.
 ## Verification (extension)
 - Functional check: <which request/action and the expected result>
 - Description trigger (skill-authoring only): if this change edits the skill's `description`,
-  re-measure the trigger with `node dist/evals.js measure` and refresh `evals/.last-measured`
+  re-measure the trigger with `npx handyman-harness@3 evals measure` and refresh `evals/.last-measured`
   (the size cap alone does not prove it still triggers — see references/evals.md).
 
 ## Considerations
@@ -101,7 +101,7 @@ Two requests grounded in this repo's own history — one per archetype.
 
 ## Context
 Several harness mutations (backlog entries, current.md, history.md) are done by hand
-with no deterministic script, unlike feature_list.json (covered by node dist/feature.js). Map
+with no deterministic script, unlike feature_list.json (covered by npx handyman-harness@3 feature). Map
 the gap before building anything.
 
 ## Scope
@@ -130,22 +130,22 @@ the gap before building anything.
 
 ## Context
 backlog/ entries (impl_/review_/explore_) are written by hand with per-type
-frontmatter; there is no generator, unlike node dist/feature.js for state. Implements Plan A of
+frontmatter; there is no generator, unlike npx handyman-harness@3 feature for state. Implements Plan A of
 docs/analisis-acciones-deterministas-por-capa.md.
 
 ## Scope
 - Includes: src/backlog.ts, assets/backlog-*.template.md, references (anatomy/templates/workflow), tests/test_backlog.sh
 
 ## Acceptance criteria (observable and testable)
-- node dist/backlog.js impl <feature> creates impl_<feature>.md with implementer frontmatter
-- node dist/backlog.js review <feature> [--status approved|changes_requested] creates a coherent review_<feature>.md
+- npx handyman-harness@3 backlog impl <feature> creates impl_<feature>.md with implementer frontmatter
+- npx handyman-harness@3 backlog review <feature> [--status approved|changes_requested] creates a coherent review_<feature>.md
 - it never overwrites an existing entry (idempotent)
 - tests/test_backlog.sh covers each subcommand and is wired into run_tests.sh
 - bash tests/run_tests.sh passes
 
 ## Verification
 - Gate that must stay green: ./init.sh
-- Functional check: run node dist/backlog.js impl demo_feature and see the file with correct frontmatter
+- Functional check: run npx handyman-harness@3 backlog impl demo_feature and see the file with correct frontmatter
 
 ## Considerations
 - ponytail: the smallest change that satisfies the Acceptance

package/assets/init.template.sh

@@ -183,7 +183,7 @@ run_test() {
 # --- Advisory checks (non-blocking) -----------------------------------------
 # A harness with no version stamp predates harness versioning; flag it so the
 # user can seal and update it. A sealed harness stays silent here - explicit
-# drift detection is node dist/upgrade_harness.js --check. Never changes EXIT_CODE.
+# drift detection is npx handyman-harness@3 upgrade_harness --check. Never changes EXIT_CODE.
 check_harness_version() {
   ver=""
   if [ -f "$PROJECT_ROOT/harness.config.json" ]; then
@@ -194,7 +194,7 @@ check_harness_version() {
   fi
   if [ -z "$ver" ]; then
     echo "NOTE: harness has no version stamp - created before harness versioning." >&2
-    echo "      run node dist/upgrade_harness.js --check (or re-scaffold) to seal and update it." >&2
+    echo "      run npx handyman-harness@3 upgrade_harness --check (or re-scaffold) to seal and update it." >&2
   fi
 }
 
@@ -259,14 +259,14 @@ check_evals() {
   count="$(_json "$eval_set" len 2>/dev/null)"
   if [ "${count:-0}" -eq 0 ]; then
     echo "NOTE: evals/trigger-eval.json has no labeled queries - the description trigger is unmeasured." >&2
-    echo "      add positive and negative queries, then run node dist/evals.js measure (see references/evals.md)." >&2
+    echo "      add positive and negative queries, then run npx handyman-harness@3 evals measure (see references/evals.md)." >&2
     return 0
   fi
   marker="$PROJECT_ROOT/evals/.last-measured"
   desc="$PROJECT_ROOT/SKILL.md"
   if [ -f "$desc" ] && { [ ! -f "$marker" ] || [ "$desc" -nt "$marker" ]; }; then
     echo "NOTE: SKILL.md changed since the last trigger measurement (or it was never measured)." >&2
-    echo "      re-run node dist/evals.js measure and refresh evals/.last-measured (see references/evals.md)." >&2
+    echo "      re-run npx handyman-harness@3 evals measure and refresh evals/.last-measured (see references/evals.md)." >&2
   fi
 }
 

package/assets/sprint.template.md

@@ -11,7 +11,7 @@ tags: [handyman/sprint]
 
 > Closed work period. Every section except the two marked manual is derived at
 > close time from `feature_list.json`, `progress/history.md`, and `backlog/`
-> frontmatter by `node dist/sprint.js close`; regenerate rather than hand-edit.
+> frontmatter by `npx handyman-harness@3 sprint close`; regenerate rather than hand-edit.
 
 ## Identity
 

package/dist/cli.js

@@ -25,6 +25,7 @@ verbs:
 ${list}
 
 Each verb accepts --help for its own options.
+handyman --version prints the toolchain version.
 `;
 }
 var [verb, ...rest] = process.argv.slice(2);
@@ -32,6 +33,15 @@ if (!verb || verb === "--help" || verb === "-h") {
   process.stdout.write(usage());
   process.exit(verb ? 0 : 2);
 }
+if (verb === "--version" || verb === "-v") {
+  const { readFileSync } = await import("node:fs");
+  const pkg = JSON.parse(
+    readFileSync(new URL("../package.json", import.meta.url), "utf8")
+  );
+  process.stdout.write(`${pkg.version}
+`);
+  process.exit(0);
+}
 if (!VERBS.includes(verb)) {
   process.stderr.write(`error: unknown verb '${verb}'
 

package/dist/toolbox.js

@@ -8038,6 +8038,7 @@ import { basename as basename2, dirname, join as join8, resolve as resolve6 } fr
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 var ASSETS = fileURLToPath2(new URL("../assets", import.meta.url));
 var SKILL_MD = fileURLToPath2(new URL("../SKILL.md", import.meta.url));
+var PKG_JSON = fileURLToPath2(new URL("../package.json", import.meta.url));
 var MIGRATIONS = [
   {
     version: "1.6.0",
@@ -8149,14 +8150,19 @@ function truthyString(value) {
   return null;
 }
 function currentSkillVersion() {
-  let text;
   try {
-    text = readTextUniversal(SKILL_MD);
+    const match = /^\s+version:\s*(.+)$/m.exec(readTextUniversal(SKILL_MD));
+    if (match) {
+      return match[1].trim();
+    }
+  } catch {
+  }
+  try {
+    const version = JSON.parse(readTextUniversal(PKG_JSON)).version;
+    return typeof version === "string" ? version : "";
   } catch {
     return "";
   }
-  const match = /^\s+version:\s*(.+)$/m.exec(text);
-  return match ? match[1].trim() : "";
 }
 function readInstalledVersion(root, workspace) {
   const configPath = join8(root, "harness.config.json");

package/dist/toolbox_state.js

@@ -8190,6 +8190,7 @@ import { basename as basename2, dirname as dirname2, join as join10, resolve as
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 var ASSETS = fileURLToPath2(new URL("../assets", import.meta.url));
 var SKILL_MD = fileURLToPath2(new URL("../SKILL.md", import.meta.url));
+var PKG_JSON = fileURLToPath2(new URL("../package.json", import.meta.url));
 var MIGRATIONS = [
   {
     version: "1.6.0",
@@ -8301,14 +8302,19 @@ function truthyString(value) {
   return null;
 }
 function currentSkillVersion() {
-  let text;
   try {
-    text = readTextUniversal(SKILL_MD);
+    const match = /^\s+version:\s*(.+)$/m.exec(readTextUniversal(SKILL_MD));
+    if (match) {
+      return match[1].trim();
+    }
+  } catch {
+  }
+  try {
+    const version = JSON.parse(readTextUniversal(PKG_JSON)).version;
+    return typeof version === "string" ? version : "";
   } catch {
     return "";
   }
-  const match = /^\s+version:\s*(.+)$/m.exec(text);
-  return match ? match[1].trim() : "";
 }
 function readInstalledVersion(root, workspace) {
   const configPath = join10(root, "harness.config.json");

package/dist/upgrade_harness.js

@@ -6910,6 +6910,7 @@ function resolveWorkspace(root) {
 // src/upgrade_harness.ts
 var ASSETS = fileURLToPath2(new URL("../assets", import.meta.url));
 var SKILL_MD = fileURLToPath2(new URL("../SKILL.md", import.meta.url));
+var PKG_JSON = fileURLToPath2(new URL("../package.json", import.meta.url));
 var MIGRATIONS = [
   {
     version: "1.6.0",
@@ -7021,14 +7022,19 @@ function truthyString(value) {
   return null;
 }
 function currentSkillVersion() {
-  let text;
   try {
-    text = readTextUniversal(SKILL_MD);
+    const match = /^\s+version:\s*(.+)$/m.exec(readTextUniversal(SKILL_MD));
+    if (match) {
+      return match[1].trim();
+    }
+  } catch {
+  }
+  try {
+    const version = JSON.parse(readTextUniversal(PKG_JSON)).version;
+    return typeof version === "string" ? version : "";
   } catch {
     return "";
   }
-  const match = /^\s+version:\s*(.+)$/m.exec(text);
-  return match ? match[1].trim() : "";
 }
 function readInstalledVersion(root, workspace) {
   const configPath = join2(root, "harness.config.json");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "handyman-harness",
-  "version": "3.0.0",
+  "version": "3.1.0",
   "description": "Handyman agent-harness toolchain (TypeScript/Node).",
   "author": "Rodrigo Mardones",
   "license": "MIT",