@kody-ade/kody-engine 0.4.368 → 0.4.369

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.368",
+      version: "0.4.369",
       description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative implementation profiles.",
       license: "MIT",
       type: "module",
@@ -1989,6 +1989,7 @@ function parseWorkflowStep(value) {
   const target = stringField(raw.target);
   const targetFact = stringField(raw.targetFact ?? raw.target_fact);
   const cliArgs = raw.cliArgs;
+  const report = parseReportPublication(raw.report);
   return {
     capability,
     ...action && isSafeSlug(action) ? { action } : {},
@@ -2001,7 +2002,35 @@ function parseWorkflowStep(value) {
     ...cliArgs && typeof cliArgs === "object" && !Array.isArray(cliArgs) ? { cliArgs } : {},
     ...isPlainObject(raw.runWhen) ? { runWhen: raw.runWhen } : {},
     ...stringList(raw.continueOn ?? raw.continue_on).length > 0 ? { continueOn: stringList(raw.continueOn ?? raw.continue_on) } : {},
-    ...raw.saveReport === true ? { saveReport: true } : {}
+    ...raw.saveReport === true ? { saveReport: true } : {},
+    ...report ? { report } : {}
+  };
+}
+function parseReportPublication(value) {
+  if (!isPlainObject(value)) return void 0;
+  const type = stringField(value.type);
+  const owner = stringField(value.owner);
+  if (!type || !/^[a-z0-9][a-z0-9_-]{0,79}$/.test(type) || !owner || !isSafeSlug(owner)) return void 0;
+  const version = typeof value.version === "number" && Number.isInteger(value.version) && value.version > 0 ? value.version : void 0;
+  const slug = stringField(value.slug);
+  const slugFact = stringField(value.slugFact);
+  const title = stringField(value.title);
+  const titleFact = stringField(value.titleFact);
+  const publishWhenFact = stringField(value.publishWhenFact);
+  const reviewStatus = stringField(value.reviewStatus);
+  const reviewArea = stringField(value.reviewArea);
+  if (!slug && !slugFact) return void 0;
+  return {
+    type,
+    ...version ? { version } : {},
+    owner,
+    ...slug ? { slug } : {},
+    ...slugFact ? { slugFact } : {},
+    ...title ? { title } : {},
+    ...titleFact ? { titleFact } : {},
+    ...publishWhenFact ? { publishWhenFact } : {},
+    ...reviewStatus ? { reviewStatus } : {},
+    ...reviewArea ? { reviewArea } : {}
   };
 }
 function isPlainObject(value) {
@@ -15873,6 +15902,106 @@ var init_parseJobStateFromAgentResult = __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}`] : [],
+    "---",
+    `# ${input.title}`,
+    "",
+    input.summary,
+    "",
+    "## Report data",
+    "```json",
+    JSON.stringify(input.data, null, 2),
+    "```",
+    ""
+  ].join("\n");
+}
+function parsePublication(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return null;
+  const raw = value;
+  if (typeof raw.type !== "string" || !SAFE_SLUG.test(raw.type)) return null;
+  if (typeof raw.owner !== "string" || !SAFE_SLUG.test(raw.owner)) return null;
+  return raw;
+}
+function latestResult(raw, agentResult) {
+  const results = [];
+  if (Array.isArray(raw)) {
+    for (const item of raw) {
+      const parsed = parseCapabilityResult(item);
+      if (parsed) results.push(parsed);
+    }
+  }
+  if (agentResult?.finalText) results.push(...parseCapabilityResultsFromText(agentResult.finalText));
+  return results.at(-1) ?? null;
+}
+function recordField6(value) {
+  return value && typeof value === "object" && !Array.isArray(value) ? value : null;
+}
+function resolveDotted(root, path51) {
+  if (!path51) return void 0;
+  return path51.split(".").reduce((value, key) => recordField6(value)?.[key], root);
+}
+function stringValue4(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);
+}
+var SAFE_SLUG, publishReport;
+var init_publishReport = __esm({
+  "src/scripts/publishReport.ts"() {
+    "use strict";
+    init_capabilityResult();
+    init_stateRepo();
+    SAFE_SLUG = /^[a-z0-9][a-z0-9_-]{0,79}$/;
+    publishReport = async (ctx, _profile, agentResult) => {
+      const publication = parsePublication(ctx.data.reportPublication);
+      if (!publication) return;
+      const result = latestResult(ctx.data.capabilityResults, agentResult);
+      const stateData = recordField6(recordField6(ctx.data.nextJobState)?.data) ?? {};
+      const data = { ...stateData, ...result?.facts ?? {} };
+      if (publication.publishWhenFact && resolveDotted(data, publication.publishWhenFact) === void 0) return;
+      const slug = publication.slug ?? stringValue4(resolveDotted(data, publication.slugFact));
+      if (!slug || !SAFE_SLUG.test(slug)) return;
+      const title = publication.title ?? stringValue4(resolveDotted(data, publication.titleFact)) ?? humanize(slug);
+      const generatedAt = (/* @__PURE__ */ new Date()).toISOString();
+      const markdown = buildRuntimeReportMarkdown({
+        generatedAt,
+        reportType: publication.type,
+        reportTypeVersion: publication.version ?? 1,
+        owner: publication.owner,
+        capability: stringValue4(ctx.data.jobCapability) ?? stringValue4(ctx.data.capabilitySlug) ?? "unknown",
+        title,
+        summary: result?.summary ?? title,
+        data,
+        ...publication.reviewStatus ? { reviewStatus: publication.reviewStatus } : {},
+        ...publication.reviewArea ? { reviewArea: publication.reviewArea } : {}
+      });
+      const runId = generatedAt.replace(/\.\d{3}Z$/, "Z").replace(/:/g, "-");
+      writeStateText(
+        ctx.config,
+        ctx.cwd,
+        `reports/${slug}/runs/${runId}.md`,
+        markdown,
+        `chore(reports): add ${slug} run`
+      );
+    };
+  }
+});
+
 // src/scripts/parseReproOutput.ts
 function extractTestPath(text) {
   const m = text.match(/^[\s>*_#`~-]*TEST_PATH[\s>*_#`~-]*\s*:\s*(.+?)\s*$/im);
@@ -19292,6 +19421,7 @@ var init_scripts = __esm({
     init_parseAgentResult();
     init_parseIssueStateFromAgentResult();
     init_parseJobStateFromAgentResult();
+    init_publishReport();
     init_parseReproOutput();
     init_persistArtifacts();
     init_persistFlowState();
@@ -19420,6 +19550,7 @@ var init_scripts = __esm({
       advanceFlow,
       persistFlowState,
       applyCapabilityReports,
+      publishReport,
       recordClassification,
       dispatchClassified,
       notifyTerminal,
@@ -20552,6 +20683,7 @@ var init_executor = __esm({
       "commitAndPush",
       "ensurePr",
       "applyCapabilityReports",
+      "publishReport",
       "openAgentFactoryStatePr"
     ]);
     MAX_CHAIN_HOPS = 60;
@@ -20608,9 +20740,16 @@ function validateJob(input) {
     flavor: j.flavor,
     force: j.force === true,
     saveReport: j.saveReport === true,
+    report: parseReportPublication2(j.report),
     resultTarget: parseCapabilityResultTarget(j.resultTarget)
   };
 }
+function parseReportPublication2(raw) {
+  if (!raw || typeof raw !== "object" || Array.isArray(raw)) return void 0;
+  const report = raw;
+  if (typeof report.type !== "string" || typeof report.owner !== "string") return void 0;
+  return raw;
+}
 function parseCapabilityResultTarget(raw) {
   if (!raw || typeof raw !== "object" || Array.isArray(raw)) return void 0;
   const target = raw;
@@ -20686,6 +20825,7 @@ async function runCapabilityImplementationStep(valid, profileName, capabilityIde
   preloadedData.selectedImplementation = profileName;
   if (valid.schedule !== void 0 && valid.schedule.length > 0) preloadedData.jobSchedule = valid.schedule;
   if (valid.saveReport === true) preloadedData.jobSaveReport = true;
+  if (valid.report) preloadedData.reportPublication = valid.report;
   if (valid.force === true) preloadedData.jobForce = true;
   if (valid.evidence) preloadedData.capabilityEvidence = { evidence: valid.evidence };
   if (valid.resultTarget) preloadedData.capabilityResultTarget = valid.resultTarget;
@@ -20841,6 +20981,7 @@ function workflowStepToJob(step, parent, chainData) {
     flavor: parent.flavor,
     force: parent.force,
     saveReport: step.saveReport === true || parent.saveReport === true,
+    ...step.report ? { report: step.report } : {},
     ...parent.resultTarget ? { resultTarget: parent.resultTarget } : {}
   };
 }

package/dist/implementations/types.ts

@@ -500,6 +500,19 @@ export type AnyScript = PreflightScript | PostflightScript
 
 export type JobFlavor = "instant" | "scheduled"
 
+export interface ReportPublicationConfig {
+  type: string
+  version?: number
+  owner: string
+  slug?: string
+  slugFact?: string
+  title?: string
+  titleFact?: string
+  publishWhenFact?: string
+  reviewStatus?: string
+  reviewArea?: string
+}
+
 export interface Job {
   /** Public action the user/operator invoked. Mirrors the capability action. */
   action?: string
@@ -530,6 +543,8 @@ export interface Job {
   force?: boolean
   /** Ask the owning goal/loop to write a report run after its persisted decision. */
   saveReport?: boolean
+  /** Workflow-owned request for the runtime to publish typed capability output. */
+  report?: ReportPublicationConfig
   /** Internal parent context used by postflights to attach neutral capability output. */
   resultTarget?: CapabilityResultTarget
 }

package/package.json

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