handyman-harness 3.0.0

package/dist/toolbox_acceptance.js

@@ -0,0 +1,77 @@
+import { createRequire } from 'node:module'; const require = createRequire(import.meta.url);
+
+// ../packages/toolbox-core/dist/llm.js
+var LlmError = class extends Error {
+  code;
+  constructor(code, message) {
+    super(message);
+    this.name = "LlmError";
+    this.code = code;
+  }
+};
+
+// ../packages/toolbox-core/dist/acceptance.js
+var ACCEPTANCE_SPEC_MAX_CHARS = 6e4;
+function composeAcceptanceSystem() {
+  return [
+    "Redactas los criterios de aceptacion de una feature para un harness Handyman.",
+    "",
+    "Salida: una lista markdown de balas, nada mas. Sin preambulo ni cierre.",
+    "",
+    "Reglas duras:",
+    "- Cada bala debe ser OBSERVABLE y TESTEABLE: usa verbos verificables",
+    "  (corre, sale con exit 0, grepea, devuelve, responde 400, escribe el archivo X).",
+    "- PROHIBIDO lo vago: nada de 'deberia funcionar', 'esta bien integrado',",
+    "  'es robusto', 'mejora la experiencia'. Si no se puede verificar desde",
+    "  afuera, no es un criterio de aceptacion.",
+    "- Cada bala nombra el artefacto concreto (ruta, comando, archivo, endpoint).",
+    "- La ULTIMA bala debe ser siempre el gate verde, exactamente:",
+    "  'bash tests/run_tests.sh passes y ./init.sh exits 0.'",
+    "- Si el material no alcanza para justificar un criterio, no lo inventes:",
+    "  di que falta evidencia para esa parte."
+  ].join("\n");
+}
+function composeAcceptancePrompt(source, content, truncated) {
+  const header = source === "diff" ? "---- diff de trabajo (git diff HEAD): deduce que cambio y que se puede observar" : "---- especificacion / issue crudo: deduce los criterios observables que la cumplen";
+  const body = content.length > 0 ? content : source === "diff" ? "(diff vacio o el root no es un repo git)" : "(especificacion vacia)";
+  const parts = [header, body];
+  if (truncated) {
+    parts.push("");
+    parts.push("[el material fue truncado por tamano: no afirmes nada sobre lo que no viste]");
+  }
+  return parts.join("\n");
+}
+function lastBulletIsGreenGate(md) {
+  const bullets = md.split("\n").map((line) => line.trim()).filter((line) => /^[-*+]\s+/.test(line) || /^\d+[.)]\s+/.test(line));
+  const last = bullets[bullets.length - 1];
+  if (!last) {
+    return false;
+  }
+  return last.includes("./init.sh") || last.includes("tests/run_tests.sh");
+}
+async function relayAcceptance(options) {
+  const { system, prompt, draft, source, truncated, onDelta, onResult, onError } = options;
+  try {
+    const result = await draft({ prompt, system }, onDelta);
+    onResult({
+      acceptance_md: result.text,
+      model: result.model,
+      source,
+      gate_last: lastBulletIsGreenGate(result.text),
+      diff_truncated: truncated
+    });
+  } catch (error) {
+    if (error instanceof LlmError) {
+      onError(error);
+      return;
+    }
+    onError(new LlmError("provider_error", error instanceof Error ? error.message : String(error)));
+  }
+}
+export {
+  ACCEPTANCE_SPEC_MAX_CHARS,
+  composeAcceptancePrompt,
+  composeAcceptanceSystem,
+  lastBulletIsGreenGate,
+  relayAcceptance
+};

package/dist/toolbox_assets.js

@@ -0,0 +1,119 @@
+import { createRequire } from 'node:module'; const require = createRequire(import.meta.url);
+
+// src/toolbox_assets.ts
+import { createRequire } from "node:module";
+import { dirname, join as join3, sep as sep2 } from "node:path";
+
+// ../packages/toolbox-core/dist/registry.js
+import { mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+function registryPath(hroot) {
+  return join(hroot, "registry.json");
+}
+function loadRegistry(hroot) {
+  const empty = { version: 1, harnesses: [] };
+  const path = registryPath(hroot);
+  let raw;
+  try {
+    raw = readFileSync(path, "utf-8");
+  } catch {
+    return [empty, null];
+  }
+  let data;
+  try {
+    data = JSON.parse(raw);
+  } catch {
+    return [empty, `registry does not parse: ${path}`];
+  }
+  if (!data || typeof data !== "object" || Array.isArray(data) || !Array.isArray(data.harnesses)) {
+    return [empty, `registry has no 'harnesses' array: ${path}`];
+  }
+  const record = data;
+  const harnesses = record.harnesses.filter((e) => !!e && typeof e === "object" && !Array.isArray(e)).map((e) => ({
+    project_root: String(e.project_root ?? ""),
+    registered: String(e.registered ?? "")
+  }));
+  return [{ version: Number(record.version ?? 1), harnesses }, null];
+}
+
+// ../packages/toolbox-core/dist/state.js
+import { readdirSync, readFileSync as readFileSync2, statSync as statSync2 } from "node:fs";
+import { join as join2, resolve as resolve2, sep } from "node:path";
+var INTAKE_MAX_BYTES = 256 * 1024;
+var CSP_HEADER = "default-src 'self'; script-src 'self' 'unsafe-inline'; style-src 'self' 'unsafe-inline'; img-src 'self' data:; connect-src 'self'";
+var HTML_CSP_HEADER = CSP_HEADER.replace("img-src 'self' data:", "img-src 'self' data: https://picsum.photos");
+function readText(path) {
+  try {
+    return readFileSync2(path, "utf-8");
+  } catch {
+    return null;
+  }
+}
+var MD_TOKEN_PATHS = {
+  current: (workspace) => join2(workspace, "progress", "current.md"),
+  history: (workspace) => join2(workspace, "progress", "history.md"),
+  index: (workspace) => join2(workspace, "index.md"),
+  checkpoints: (_workspace, root) => join2(root, "CHECKPOINTS.md")
+};
+var MD_TOKENS = Object.keys(MD_TOKEN_PATHS);
+
+// src/toolbox_assets.ts
+var require2 = createRequire(import.meta.url);
+var vendorFiles = {
+  "vis-network.js": ["vis-network", "standalone/umd/vis-network.min.js"]
+};
+function packageRoot(pkg) {
+  try {
+    return dirname(require2.resolve(`${pkg}/package.json`));
+  } catch {
+    try {
+      const entry = require2.resolve(pkg);
+      const marker = `${sep2}node_modules${sep2}${pkg}${sep2}`;
+      const idx = entry.lastIndexOf(marker);
+      return idx === -1 ? null : entry.slice(0, idx + marker.length - 1);
+    } catch {
+      return null;
+    }
+  }
+}
+function vendorText(name) {
+  const spec = vendorFiles[name];
+  if (!spec) {
+    return null;
+  }
+  const root = packageRoot(spec[0]);
+  return root === null ? null : readText(join3(root, spec[1]));
+}
+function graphFile(hroot, wanted, kind) {
+  const [registry] = loadRegistry(hroot);
+  const entry = registry.harnesses.find((e) => {
+    const raw = readText(join3(e.project_root, "harness.config.json"));
+    let name = e.project_root.split("/").pop() ?? e.project_root;
+    if (raw) {
+      try {
+        name = String(JSON.parse(raw).project_name ?? name);
+      } catch {
+      }
+    }
+    return name === wanted;
+  });
+  if (!entry) {
+    return { status: "unknown_harness" };
+  }
+  let text = readText(join3(entry.project_root, "graphify-out", `graph.${kind}`));
+  if (text === null) {
+    return { status: "no_export" };
+  }
+  if (kind === "html") {
+    text = text.replace(
+      /<script\s+src="https:\/\/unpkg\.com\/vis-network@[^"]*"[^>]*><\/script>/,
+      '<script src="/vendor/vis-network.js"></script>'
+    );
+  }
+  const type = kind === "html" ? "text/html; charset=utf-8" : "application/json; charset=utf-8";
+  return { status: "ok", text, type };
+}
+export {
+  graphFile,
+  vendorText
+};