ralphctl 0.17.0 → 0.17.1

package/dist/{cli-CCNZ2VKB.mjs → cli-WTLOGLWF.mjs}

@@ -6024,7 +6024,7 @@ var createNpmVersionChecker = (deps) => {
 // package.json
 var package_default = {
   name: "ralphctl",
-  version: "0.17.0",
+  version: "0.17.1",
   description: "Agent harness for long-running AI coding tasks \u2014 orchestrates Claude Code, GitHub Copilot, and OpenAI Codex across repositories",
   homepage: "https://github.com/lukas-grigis/ralphctl",
   type: "module",
@@ -15319,7 +15319,7 @@ var validateSignalsFile = async (outputDir, contract) => {
   }
   const wrapper = current;
   const inner = wrapper.signals;
-  const defaulted = defaultMissingTimestamps(inner);
+  const defaulted = renameNarrativeBodyToText(defaultMissingTimestamps(inner));
   const parsed = contract.signalsSchema.safeParse(defaulted);
   if (!parsed.success) {
     return Result.error(
@@ -15337,6 +15337,18 @@ var describeJsonError = (cause) => {
   if (cause instanceof Error) return cause.message;
   return String(cause);
 };
+var NARRATIVE_SIGNAL_KINDS = /* @__PURE__ */ new Set(["learning", "note", "decision"]);
+var renameNarrativeBodyToText = (inner) => {
+  if (!Array.isArray(inner)) return inner;
+  return inner.map((sig) => {
+    if (typeof sig !== "object" || sig === null) return sig;
+    const s = sig;
+    if (typeof s.type !== "string" || !NARRATIVE_SIGNAL_KINDS.has(s.type)) return sig;
+    if (typeof s.text === "string" || typeof s.body !== "string") return sig;
+    const { body, ...rest } = s;
+    return { ...rest, text: body };
+  });
+};
 var defaultMissingTimestamps = (inner) => {
   if (!Array.isArray(inner)) return inner;
   const now = (/* @__PURE__ */ new Date()).toISOString();
@@ -15427,6 +15439,16 @@ var refineExampleSignals = [
     type: "decision",
     text: "Scoped export to CSV only for v1; XLSX deferred to a follow-up ticket.",
     timestamp: EXAMPLE_TS
+  },
+  {
+    type: "learning",
+    text: "The export path already streams; the ticket must not assume an in-memory buffer.",
+    timestamp: EXAMPLE_TS
+  },
+  {
+    type: "note",
+    text: "The user ruled column ordering out of scope \u2014 captured as a deferred item rather than an AC.",
+    timestamp: EXAMPLE_TS
   }
 ];
 var refineOutputContract = {
@@ -16840,6 +16862,21 @@ var planExampleSignals = [
     type: "task-plan",
     tasksJson: '[{"name":"Wire export endpoint","ticketRef":"<ticket-uuid>","projectPath":"/abs/repo","steps":["..."],"verificationCriteria":["..."]}]',
     timestamp: EXAMPLE_TS2
+  },
+  {
+    type: "decision",
+    text: "Split the export work into endpoint + serializer tasks so the shared file is owned by exactly one task.",
+    timestamp: EXAMPLE_TS2
+  },
+  {
+    type: "learning",
+    text: "The repo runs its integration suite from a separate config; the root test command does not cover it.",
+    timestamp: EXAMPLE_TS2
+  },
+  {
+    type: "note",
+    text: "Two approved tickets touch the same route file; sequenced them via blockedBy rather than splitting the file.",
+    timestamp: EXAMPLE_TS2
   }
 ];
 var planOutputContract = {
@@ -18770,6 +18807,16 @@ var generatorExampleSignals = [
     appliesTo: "config / io layer",
     timestamp: EXAMPLE_TS3
   },
+  {
+    type: "decision",
+    text: "Centralised the parse in one helper rather than patching both call sites, to avoid future drift.",
+    timestamp: EXAMPLE_TS3
+  },
+  {
+    type: "note",
+    text: "Left the unrelated typo at src/baz.ts:8 alone \u2014 out of scope for this task.",
+    timestamp: EXAMPLE_TS3
+  },
   { type: "task-verified", output: "$ <project test command>\n... 42 passed", timestamp: EXAMPLE_TS3 },
   {
     type: COMMIT_MESSAGE_KIND,
@@ -20454,6 +20501,16 @@ var evaluatorExampleSignals = [
     ],
     critique: "Correctness: add edge-case handling for empty input at src/foo.ts:23.",
     timestamp: EXAMPLE_TS4
+  },
+  {
+    type: "learning",
+    text: "The suite needs a built fixture; a cold checkout fails the C1 command for reasons unrelated to the task.",
+    timestamp: EXAMPLE_TS4
+  },
+  {
+    type: "note",
+    text: "C2 was checked by reading the call site \u2014 the criterion is manual, so no command was run.",
+    timestamp: EXAMPLE_TS4
   }
 ];
 var evaluatorOutputContract = {
@@ -28020,7 +28077,17 @@ var readinessExampleSignals = [
     content: "# Verify\n\nRun `<verify command>` (typecheck + lint + test).",
     timestamp: EXAMPLE_TS6
   },
-  { type: "skill-suggestions", names: ["typescript-strict", "code-style-conventions"], timestamp: EXAMPLE_TS6 }
+  { type: "skill-suggestions", names: ["typescript-strict", "code-style-conventions"], timestamp: EXAMPLE_TS6 },
+  {
+    type: "learning",
+    text: "The verify command lives in a workspace package script, not the repo root manifest.",
+    timestamp: EXAMPLE_TS6
+  },
+  {
+    type: "note",
+    text: "No lint config found, so the proposed verify skill covers typecheck + test only.",
+    timestamp: EXAMPLE_TS6
+  }
 ];
 var readinessOutputContract = {
   schemaVersion: 1,
@@ -29632,6 +29699,21 @@ var ideateExampleSignals = [
     type: "ideated-tickets",
     outputJson: '{"requirements":"# Export CSV\\n\\n## Problem\\n\u2026","tasks":[{"name":"Wire endpoint","projectPath":"/abs/repo","steps":["\u2026"],"verificationCriteria":["\u2026"]}]}',
     timestamp: EXAMPLE_TS9
+  },
+  {
+    type: "decision",
+    text: "Scoped export to CSV only for v1; XLSX deferred to a follow-up ticket.",
+    timestamp: EXAMPLE_TS9
+  },
+  {
+    type: "learning",
+    text: "The repo runs its integration suite from a separate config; the root test command does not cover it.",
+    timestamp: EXAMPLE_TS9
+  },
+  {
+    type: "note",
+    text: "The user ruled out changing the existing download endpoint, so the new route is additive.",
+    timestamp: EXAMPLE_TS9
   }
 ];
 var ideateOutputContract = {

package/dist/cli.mjs

@@ -2,5 +2,5 @@
 
 // src/index.ts
 process.env.NODE_ENV ??= "production";
-var { runCli } = await import("./cli-CCNZ2VKB.mjs");
+var { runCli } = await import("./cli-WTLOGLWF.mjs");
 await runCli(process.argv);

package/dist/manifest.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
-  "packageVersion": "0.17.0",
-  "generatedAt": "2026-07-27T15:30:39.020Z",
+  "packageVersion": "0.17.1",
+  "generatedAt": "2026-07-28T04:40:58.689Z",
   "assets": [
     "agent-definitions/ralphctl-evaluator.md",
     "agent-definitions/ralphctl-generator.md",

package/dist/prompts/ideate/template.md

@@ -258,11 +258,12 @@ The `outputJson` field is a JSON-encoded string. When decoded it has exactly two
 
 **Required signals:** exactly one `ideated-tickets`.
 
-**Optional signals** (emit when relevant):
+**Optional signals** (emit when relevant). Each carries its prose in a `text` field — never
+`body`; the output contract below shows the exact shape:
 
 - `note` — for status updates or observations worth surfacing.
 - `learning` — for non-obvious repo facts discovered during exploration.
-- `decision` — for architectural choices made during planning (body capped at 500 chars).
+- `decision` — for architectural choices made during planning.
 
 Emit nothing else. No prose responses, no explanatory comments outside the signals file.
 

package/dist/prompts/plan/template.md

@@ -437,10 +437,11 @@ Once the user has answered "Approved, write it" in Step 4 AND every checklist it
 satisfied, write the `task-plan` signal into `signals.json` per the output contract below.
 The task array goes into the signal's `tasksJson` field as a JSON-encoded string.
 
-**Optional signals** (emit when relevant):
+**Optional signals** (emit when relevant). Each carries its prose in a `text` field — never
+`body`; the output contract below shows the exact shape:
 
 - `note` — for status updates or observations worth surfacing.
 - `learning` — for non-obvious repo facts discovered during exploration.
-- `decision` — for architectural choices made during planning (body capped at 500 chars).
+- `decision` — for architectural choices made during planning.
 
 {{OUTPUT_CONTRACT_SECTION}}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ralphctl",
-  "version": "0.17.0",
+  "version": "0.17.1",
   "description": "Agent harness for long-running AI coding tasks — orchestrates Claude Code, GitHub Copilot, and OpenAI Codex across repositories",
   "homepage": "https://github.com/lukas-grigis/ralphctl",
   "type": "module",