handyman-harness 3.0.0

package/dist/toolbox_triage.js

@@ -0,0 +1,168 @@
+import { createRequire } from 'node:module'; const require = createRequire(import.meta.url);
+
+// ../packages/toolbox-core/dist/triage.js
+import { readdirSync as readdirSync2 } from "node:fs";
+import { join as join2 } from "node:path";
+
+// ../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/state.js
+import { readdirSync, readFileSync, statSync } from "node:fs";
+import { join, resolve, 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 readFileSync(path, "utf-8");
+  } catch {
+    return null;
+  }
+}
+function readFeatures(workspace) {
+  const raw = readText(join(workspace, "feature_list.json"));
+  if (raw === null) {
+    return [];
+  }
+  let data;
+  try {
+    data = JSON.parse(raw);
+  } catch {
+    return [];
+  }
+  const features = data && typeof data === "object" && !Array.isArray(data) ? data.features : [];
+  if (!Array.isArray(features)) {
+    return [];
+  }
+  return features.filter((f) => !!f && typeof f === "object" && !Array.isArray(f)).map((f) => ({
+    id: typeof f.id === "number" ? f.id : null,
+    name: String(f.name ?? ""),
+    title: String(f.title ?? f.name ?? ""),
+    status: String(f.status ?? "pending"),
+    sprint: f.sprint ? String(f.sprint) : null,
+    blocked_reason: f.blocked_reason ? String(f.blocked_reason) : null,
+    depends_on: Array.isArray(f.depends_on) ? f.depends_on.filter(Number.isInteger) : []
+  }));
+}
+var MD_TOKEN_PATHS = {
+  current: (workspace) => join(workspace, "progress", "current.md"),
+  history: (workspace) => join(workspace, "progress", "history.md"),
+  index: (workspace) => join(workspace, "index.md"),
+  checkpoints: (_workspace, root) => join(root, "CHECKPOINTS.md")
+};
+var MD_TOKENS = Object.keys(MD_TOKEN_PATHS);
+
+// ../packages/toolbox-core/dist/triage.js
+var TRIAGE_EXCERPT_CHARS = 800;
+function classify(name) {
+  for (const prefix of ["impl", "review", "explore"]) {
+    if (name.startsWith(`${prefix}_`)) {
+      return { kind: prefix, feature: name.slice(prefix.length + 1).replace(/\.md$/, "") };
+    }
+  }
+  return { kind: "other", feature: name.replace(/\.md$/, "") };
+}
+function listBacklogDocs(workspace) {
+  let names;
+  try {
+    names = readdirSync2(join2(workspace, "backlog")).filter((n) => n.endsWith(".md"));
+  } catch {
+    return [];
+  }
+  names.sort();
+  return names.map((name) => {
+    const body = readText(join2(workspace, "backlog", name)) ?? "";
+    return { id: name, ...classify(name), excerpt: body.slice(0, TRIAGE_EXCERPT_CHARS) };
+  });
+}
+function computeEvidenceDebt(workspace) {
+  const present = new Set(listBacklogDocs(workspace).filter((d) => d.kind === "review").map((d) => d.feature));
+  return readFeatures(workspace).filter((f) => f.status === "done" && f.name && !present.has(f.name)).map((f) => ({ id: f.id, name: f.name, missing: `review_${f.name}.md` }));
+}
+function composeTriageSystem() {
+  return [
+    "Eres un clasificador de backlog de un harness Handyman.",
+    "Clasificas documentos backlog/*.md y senalas posibles solapes.",
+    "",
+    "Responde SOLO un objeto JSON, sin texto alrededor y sin bloque de codigo:",
+    '{"report":[{"id":"<nombre de archivo>","categoria":"impl|review|explore|other","duplicado_de":"<id de otro doc, opcional>","confianza":<0.0-1.0>}]}',
+    "",
+    "Reglas:",
+    "- Un entry por documento recibido, usando su id exacto.",
+    "- duplicado_de solo si el solape es real y sustantivo; si dudas, omitelo.",
+    "- confianza es tu certeza en la clasificacion, no en el duplicado.",
+    "- No propongas fusionar ni borrar nada: un humano decide con mv/git.",
+    "- Si no hay evidencia suficiente para clasificar, usa categoria 'other' y confianza baja."
+  ].join("\n");
+}
+function composeTriagePrompt(docs) {
+  const body = docs.map((d) => `--- ${d.id} (prefijo: ${d.kind})
+${d.excerpt}`).join("\n\n");
+  return `Documentos del backlog (${docs.length}):
+
+${body}`;
+}
+function parseTriageReport(raw) {
+  const fenced = raw.match(/```(?:json)?\s*([\s\S]*?)```/);
+  const candidate = fenced?.[1] ?? raw;
+  const start = candidate.indexOf("{");
+  const end = candidate.lastIndexOf("}");
+  if (start === -1 || end <= start) {
+    return [];
+  }
+  let data;
+  try {
+    data = JSON.parse(candidate.slice(start, end + 1));
+  } catch {
+    return [];
+  }
+  const report = data?.report;
+  if (!Array.isArray(report)) {
+    return [];
+  }
+  return report.filter((e) => !!e && typeof e === "object" && !Array.isArray(e)).filter((e) => typeof e.id === "string" && e.id.length > 0).map((e) => {
+    const entry = {
+      id: String(e.id),
+      categoria: typeof e.categoria === "string" ? e.categoria : "other",
+      confianza: typeof e.confianza === "number" ? e.confianza : 0
+    };
+    if (typeof e.duplicado_de === "string" && e.duplicado_de.length > 0) {
+      entry.duplicado_de = e.duplicado_de;
+    }
+    return entry;
+  });
+}
+async function relayTriage(options) {
+  const { system, prompt, draft, evidenceDebt, onDelta, onResult, onError } = options;
+  try {
+    const result = await draft({ prompt, system }, onDelta);
+    onResult({
+      report: parseTriageReport(result.text),
+      evidence_debt: evidenceDebt,
+      model: result.model
+    });
+  } catch (error) {
+    if (error instanceof LlmError) {
+      onError(error);
+      return;
+    }
+    onError(new LlmError("provider_error", error instanceof Error ? error.message : String(error)));
+  }
+}
+export {
+  TRIAGE_EXCERPT_CHARS,
+  composeTriagePrompt,
+  composeTriageSystem,
+  computeEvidenceDebt,
+  listBacklogDocs,
+  parseTriageReport,
+  relayTriage
+};