@kody-ade/kody-engine 0.4.520 → 0.4.522

package/dist/bin/kody.js

@@ -15,7 +15,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "@kody-ade/kody-engine",
-      version: "0.4.520",
+      version: "0.4.522",
       description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative implementation profiles.",
       license: "MIT",
       type: "module",
@@ -4638,7 +4638,8 @@ function normalizeWorkflowDefinition(value) {
   }
   const workflow = parseCapabilityWorkflow({
     steps: raw.steps,
-    startAt: raw.startAt
+    startAt: raw.startAt,
+    report: raw.report
   });
   const steps = workflow?.steps;
   const capabilities = steps ? steps.map((step) => step.capability) : normalizeWorkflowCapabilities(raw.capabilities);
@@ -4650,6 +4651,7 @@ function normalizeWorkflowDefinition(value) {
     ...raw.runWithoutApproval === true ? { runWithoutApproval: true } : {},
     ...steps ? { steps } : {},
     ...workflow?.startAt ? { startAt: workflow.startAt } : {},
+    ...workflow?.report ? { report: workflow.report } : {},
     ...typeof raw.createdAt === "string" ? { createdAt: raw.createdAt } : {},
     ...typeof raw.updatedAt === "string" ? { updatedAt: raw.updatedAt } : {}
   };
@@ -4702,7 +4704,8 @@ function normalizeWorkflowCapabilities(value) {
 function workflowDefinitionToConfig(workflow) {
   return {
     steps: workflow.steps ?? workflow.capabilities.map((capability) => ({ capability })),
-    ...workflow.startAt ? { startAt: workflow.startAt } : {}
+    ...workflow.startAt ? { startAt: workflow.startAt } : {},
+    ...workflow.report ? { report: workflow.report } : {}
   };
 }
 function parseWorkflowDefinition(content) {
@@ -17881,27 +17884,171 @@ var init_promoteQaGoal = __esm({
 
 // src/scripts/publishReport.ts
 function buildRuntimeReportMarkdown(input) {
-  return [
-    "---",
-    `generatedAt: ${yamlString(input.generatedAt)}`,
-    `reportType: ${input.reportType}`,
-    `reportTypeVersion: ${input.reportTypeVersion}`,
-    "producer:",
-    `  model: ${input.owner}`,
-    `  capability: ${input.capability}`,
-    ...input.reviewStatus ? [`reviewStatus: ${input.reviewStatus}`] : [],
-    ...input.reviewArea ? [`reviewArea: ${input.reviewArea}`] : [],
-    "---",
+  const lines = [
     `# ${input.title}`,
     "",
     input.summary,
     "",
-    "## Report data",
-    "```json",
-    JSON.stringify(input.data, null, 2),
-    "```",
-    ""
-  ].join("\n");
+    "## About",
+    markdownField("Type", input.reportType),
+    markdownField("Version", input.reportTypeVersion),
+    markdownField("Generated", input.generatedAt),
+    markdownField("Owner", input.owner),
+    markdownField("Capability", input.capability),
+    ...input.reviewStatus ? [markdownField("Review status", input.reviewStatus)] : [],
+    ...input.reviewArea ? [markdownField("Review area", input.reviewArea)] : [],
+    "",
+    ...renderReportData(input.data)
+  ];
+  return `${lines.join("\n").trimEnd()}
+`;
+}
+function renderReportData(data) {
+  const lines = [];
+  const workflow = recordField4(data.workflow);
+  const finding = recordField4(data.finding);
+  const observation = recordField4(data.observation);
+  const learning = recordField4(data.learning);
+  if (workflow) lines.push(...renderWorkflow(workflow));
+  if (finding) lines.push(...renderFinding(finding));
+  if (observation) lines.push(...renderObservation(observation));
+  if (learning) lines.push(...renderLearning(learning));
+  const rest = omitKeys(data, ["workflow", "finding", "observation", "learning"]);
+  if (Object.keys(rest).length > 0) {
+    lines.push("## Results", ...renderObjectFields(rest, 3), "");
+  }
+  return lines;
+}
+function renderWorkflow(workflow) {
+  const lines = ["## Run"];
+  pushField(lines, "Status", workflow.status);
+  pushField(lines, "Blocker", workflow.blocker);
+  const completed = stringArray3(workflow.completedStepIds);
+  if (completed.length > 0) {
+    lines.push("", "## Completed checks", ...completed.map((step) => `- ${humanize(step)}`));
+  }
+  const facts = recordField4(workflow.facts) ?? {};
+  const finding = recordField4(facts.finding);
+  const observation = recordField4(facts.observation);
+  if (finding) lines.push("", ...renderFinding(finding));
+  if (observation) lines.push("", ...renderObservation(observation));
+  const remainingFacts = omitKeys(facts, ["finding", "observation"]);
+  if (Object.keys(remainingFacts).length > 0) {
+    lines.push("", "## Results", ...renderObjectFields(remainingFacts, 3));
+  }
+  const artifacts = Array.isArray(workflow.artifacts) ? workflow.artifacts : [];
+  const evidence = renderEvidence(artifacts);
+  if (evidence.length > 0) lines.push("", "## Evidence", ...evidence);
+  lines.push("");
+  return lines;
+}
+function renderFinding(finding) {
+  const lines = ["## Finding"];
+  for (const [label, key] of [
+    ["ID", "id"],
+    ["Status", "status"],
+    ["Severity", "severity"],
+    ["Observer", "observerId"],
+    ["Subject", "subject"],
+    ["Expected", "expectation"],
+    ["Actual", "actual"],
+    ["Observation ID", "observationId"],
+    ["Observed", "observedAt"],
+    ["Operator activity", "operatorActivityAt"]
+  ]) {
+    pushField(lines, label, finding[key]);
+  }
+  lines.push("");
+  return lines;
+}
+function renderObservation(observation) {
+  const lines = ["## Observation"];
+  for (const [label, key] of [
+    ["ID", "id"],
+    ["Status", "status"],
+    ["Summary", "summary"],
+    ["Observer", "observerId"],
+    ["Capability", "capability"],
+    ["Subject", "subject"],
+    ["Observed", "observedAt"]
+  ]) {
+    pushField(lines, label, observation[key]);
+  }
+  const evidence = renderEvidence(Array.isArray(observation.evidence) ? observation.evidence : []);
+  if (evidence.length > 0) lines.push("", "### Evidence", ...evidence);
+  lines.push("");
+  return lines;
+}
+function renderLearning(learning) {
+  const lines = ["## Learning"];
+  for (const [label, key] of [
+    ["ID", "id"],
+    ["Finding ID", "findingId"],
+    ["Summary", "summary"],
+    ["Change", "change"],
+    ["Evidence", "evidence"]
+  ]) {
+    pushField(lines, label, learning[key]);
+  }
+  lines.push("");
+  return lines;
+}
+function renderObjectFields(value, headingLevel) {
+  const lines = [];
+  for (const [key, item] of Object.entries(value)) {
+    const label = humanize(key);
+    if (isScalar(item)) {
+      lines.push(markdownField(label, item));
+      continue;
+    }
+    if (Array.isArray(item)) {
+      if (item.length === 0) continue;
+      lines.push(`${"#".repeat(Math.min(headingLevel, 6))} ${label}`);
+      for (const entry of item) {
+        if (isScalar(entry)) lines.push(`- ${markdownValue(entry)}`);
+        else if (recordField4(entry)) lines.push(...renderObjectFields(recordField4(entry), headingLevel + 1));
+      }
+      continue;
+    }
+    const record2 = recordField4(item);
+    if (!record2 || Object.keys(record2).length === 0) continue;
+    lines.push(`${"#".repeat(Math.min(headingLevel, 6))} ${label}`, ...renderObjectFields(record2, headingLevel + 1));
+  }
+  return lines;
+}
+function renderEvidence(items) {
+  return items.flatMap((item) => {
+    const record2 = recordField4(item);
+    if (!record2) return [];
+    const label = stringValue5(record2.label) ?? stringValue5(record2.kind) ?? "Evidence";
+    const url = stringValue5(record2.url);
+    const status = stringValue5(record2.status);
+    const suffix = status ? ` \u2014 ${humanize(status)}` : "";
+    return [`- ${url ? `[${label}](${url})` : label}${suffix}`];
+  });
+}
+function omitKeys(value, keys) {
+  const omitted = new Set(keys);
+  return Object.fromEntries(Object.entries(value).filter(([key]) => !omitted.has(key)));
+}
+function stringArray3(value) {
+  return Array.isArray(value) ? value.filter((item) => typeof item === "string") : [];
+}
+function isScalar(value) {
+  return value === null || value === void 0 || ["string", "number", "boolean"].includes(typeof value);
+}
+function pushField(lines, label, value) {
+  if (isScalar(value) && value !== void 0 && value !== null && value !== "") {
+    lines.push(markdownField(label, value));
+  }
+}
+function markdownField(label, value) {
+  return `- **${label}:** ${markdownValue(value)}`;
+}
+function markdownValue(value) {
+  if (value === null || value === void 0) return "None";
+  if (typeof value === "boolean") return value ? "Yes" : "No";
+  return String(value).replace(/\r?\n/g, " ").trim();
 }
 async function publishWorkflowReport(input) {
   const slug = input.publication.slug;
@@ -17983,10 +18130,7 @@ function stringValue5(value) {
   return typeof value === "string" && value.trim() ? value.trim() : null;
 }
 function humanize(value) {
-  return value.split(/[-_]+/).filter(Boolean).map((part) => part[0].toUpperCase() + part.slice(1)).join(" ");
-}
-function yamlString(value) {
-  return JSON.stringify(value);
+  return value.replace(/([a-z0-9])([A-Z])/g, "$1 $2").split(/[-_]+/).filter(Boolean).map((part) => part[0].toUpperCase() + part.slice(1)).join(" ");
 }
 var SAFE_SLUG, publishReport;
 var init_publishReport = __esm({
@@ -19702,7 +19846,7 @@ function validateOneModel(rawModel, files, label, strictSingleModel, failures, e
   const slug = stringField5(model.slug);
   if (!isSlug(slug)) failures.push(`${label}.slug must be a lowercase slug`);
   if (isModelKind(kind)) {
-    const docsUsed = stringArray3(model.docsUsed);
+    const docsUsed = stringArray4(model.docsUsed);
     for (const doc of REQUIRED_DOCS[kind]) {
       if (!docsUsed.includes(doc)) failures.push(`${label} docsUsed missing ${doc}`);
     }
@@ -19800,12 +19944,12 @@ function validateModelShape(kind, model, files, slug, failures) {
     if (!isFiniteNumber(intent?.priority)) failures.push("intent file must declare numeric priority");
     if (!hasScope(model.scope)) failures.push("intent model scope must include a repo or area");
     if (!hasScope(intent?.scope)) failures.push("intent file scope must include a repo or area");
-    if (stringArray3(model.principles).length === 0) failures.push("intent model principles must be non-empty");
-    if (stringArray3(intent?.principles).length === 0) failures.push("intent file principles must be non-empty");
-    if (stringArray3(model.successMeasures).length === 0) {
+    if (stringArray4(model.principles).length === 0) failures.push("intent model principles must be non-empty");
+    if (stringArray4(intent?.principles).length === 0) failures.push("intent file principles must be non-empty");
+    if (stringArray4(model.successMeasures).length === 0) {
       failures.push("intent model successMeasures must be non-empty");
     }
-    if (stringArray3(intent?.metrics).length === 0) failures.push("intent file metrics must be non-empty");
+    if (stringArray4(intent?.metrics).length === 0) failures.push("intent file metrics must be non-empty");
     if (!recordField5(model.policy)) failures.push("intent model must declare policy");
     if (!recordField5(intent?.policy)) failures.push("intent file must declare policy");
     if (stringField5(model.status) !== "paused" || stringField5(intent?.status) !== "paused") {
@@ -19820,10 +19964,10 @@ function validateModelShape(kind, model, files, slug, failures) {
     const operation = parseJsonFile(files, `operations/${slug}/operation.json`, failures);
     if (!stringField5(model.responsibility)) failures.push("operation model must declare responsibility");
     if (!stringField5(operation?.responsibility)) failures.push("operation file must declare responsibility");
-    if (stringArray3(model.intentIds).length === 0) failures.push("operation model intentIds must be non-empty");
-    if (stringArray3(operation?.intentIds).length === 0) failures.push("operation file intentIds must be non-empty");
-    if (stringArray3(model.doesNotOwn).length === 0) failures.push("operation model doesNotOwn must be non-empty");
-    if (stringArray3(operation?.doesNotOwn).length === 0) failures.push("operation file doesNotOwn must be non-empty");
+    if (stringArray4(model.intentIds).length === 0) failures.push("operation model intentIds must be non-empty");
+    if (stringArray4(operation?.intentIds).length === 0) failures.push("operation file intentIds must be non-empty");
+    if (stringArray4(model.doesNotOwn).length === 0) failures.push("operation model doesNotOwn must be non-empty");
+    if (stringArray4(operation?.doesNotOwn).length === 0) failures.push("operation file doesNotOwn must be non-empty");
     if (stringField5(model.status) !== "proposed" || stringField5(operation?.status) !== "proposed") {
       failures.push("operation proposal status must be proposed");
     }
@@ -19832,7 +19976,7 @@ function validateModelShape(kind, model, files, slug, failures) {
   }
   if (kind === "agent") {
     const agentFile = textFile(files, `agents/${slug}.md`);
-    if (!stringArray3(model.owns).includes("identity") && !containsWord(agentFile, "identity")) {
+    if (!stringArray4(model.owns).includes("identity") && !containsWord(agentFile, "identity")) {
       failures.push("agent owns must include identity");
     }
     requireStringArrayIncludes(model.doesNotOwn, "tasks", "agent doesNotOwn", failures);
@@ -19875,7 +20019,7 @@ function validateModelShape(kind, model, files, slug, failures) {
   }
 }
 function capabilityRefs(value) {
-  return [...stringArray3(value?.capabilities), ...stringArray3(value?.allowedCapabilities)];
+  return [...stringArray4(value?.capabilities), ...stringArray4(value?.allowedCapabilities)];
 }
 function evidenceRefs(value) {
   if (!value) return [];
@@ -19947,7 +20091,7 @@ function normalizeBundlePath(filePath) {
 function stringField5(value) {
   return typeof value === "string" ? value.trim() : "";
 }
-function stringArray3(value) {
+function stringArray4(value) {
   if (!Array.isArray(value)) return [];
   return value.filter((item) => typeof item === "string").map((item) => item.trim()).filter(Boolean);
 }
@@ -19959,10 +20103,10 @@ function isFiniteNumber(value) {
 }
 function hasScope(value) {
   const scope = recordField5(value);
-  return stringArray3(scope?.repos).length > 0 || stringArray3(scope?.areas).length > 0;
+  return stringArray4(scope?.repos).length > 0 || stringArray4(scope?.areas).length > 0;
 }
 function requireStringArrayIncludes(value, expected, label, failures) {
-  if (!stringArray3(value).includes(expected)) failures.push(`${label} must include ${expected}`);
+  if (!stringArray4(value).includes(expected)) failures.push(`${label} must include ${expected}`);
 }
 function isSlug(value) {
   return /^[a-z][a-z0-9-]{0,63}$/.test(value);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kody-ade/kody-engine",
-  "version": "0.4.520",
+  "version": "0.4.522",
   "description": "kody — autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative implementation profiles.",
   "license": "MIT",
   "type": "module",