ralph-hero-mcp-server 2.5.113 → 2.5.116

package/dist/lib/activity.js

@@ -69,7 +69,20 @@ export function readActivity(config) {
     events.sort((a, b) => a.ts.localeCompare(b.ts));
     const limited = events.slice(0, config.limit);
     const cursor = limited.length > 0 ? limited[limited.length - 1].ts : null;
-    return { events: limited, cursor_advanced_to: cursor, skipped_lines: skipped };
+    const out = config.compact
+        ? limited.map((e) => {
+            const projected = { ts: e.ts, kind: e.kind };
+            const toolName = e.target && typeof e.target === "object" && "tool" in e.target
+                ? e.target.tool
+                : undefined;
+            if (typeof toolName === "string")
+                projected.tool = toolName;
+            if (e.project)
+                projected.project = e.project;
+            return projected;
+        })
+        : limited;
+    return { events: out, cursor_advanced_to: cursor, skipped_lines: skipped };
 }
 function safeReadDir(dir) {
     try {

package/dist/lib/directions.js

@@ -68,6 +68,13 @@ const PR_REVIEW_REQUIRED_BOOST = -200;
  * waiting for the human's attention.
  */
 const HUMAN_NEEDED_UNBLOCK_BOOST = -150;
+/**
+ * Penalty applied to Backlog / null-state items that surface only via the
+ * `audience === "agent"` fallback. Large positive value ensures Backlog
+ * fallback items always rank below any actionable-phase item — Backlog
+ * surfaces only when the actionable pool is empty.
+ */
+const AGENT_BACKLOG_FALLBACK_PENALTY = 100;
 /**
  * Per-estimate penalty applied when audience === "agent". Larger items
  * cost more (positive score), pushing them down the ranking so agent
@@ -528,6 +535,28 @@ export function rankDirections(items, openPRs, config) {
         const { score, kind, tags, signals } = scoreIssue(item, items, config);
         scored.push({ item, score, kind, tags, signals });
     }
+    // 1b. Phase fallback for autonomous audience: when no items passed the
+    //     standard phase filter, widen the candidate set to include items in
+    //     `Backlog` and items with a null `workflowState`. This restores
+    //     autopilot's ability to clear a Backlog-heavy board. Fallback items
+    //     get +AGENT_BACKLOG_FALLBACK_PENALTY so they always rank below any
+    //     actionable-phase item — they surface only when the actionable pool
+    //     is empty. Mirrors the blocker fallback in step 2.
+    if (config.audience === "agent" && scored.length === 0) {
+        for (const item of items) {
+            if (item.workflowState !== "Backlog" && item.workflowState !== null) {
+                continue;
+            }
+            const { score, kind, tags, signals } = scoreIssue(item, items, config);
+            scored.push({
+                item,
+                score: score + AGENT_BACKLOG_FALLBACK_PENALTY,
+                kind,
+                tags,
+                signals,
+            });
+        }
+    }
     // 2. Drop blocked items unless that would empty the candidate set.
     const unblocked = scored.filter((s) => !hasOpenBlockers(s.item));
     let candidates;

package/dist/tools/activity-tools.js

@@ -13,7 +13,8 @@ export function registerActivityTools(server) {
         kinds: z.array(z.string()).nullable().default(null).describe("Filter by event kind (e.g., ['pr_opened','issue_advanced'])"),
         category: z.enum(["work", "meta", "all"]).default("work").describe("Filter by category; default 'work' excludes meta noise"),
         project: z.string().nullable().default(null).describe("Filter by project name"),
-        limit: z.number().int().min(1).default(100).describe("Max events to return"),
+        limit: z.number().int().min(1).default(50).describe("Max events to return (default 50; was 100 before 2.5.x)"),
+        compact: z.boolean().default(false).describe("When true, project each event to {ts, kind, tool, project}; drops actor/session_id/category/wrapper-target. Use for narrative synthesis."),
     }, async (params) => {
         try {
             const result = readActivity({
@@ -23,7 +24,8 @@ export function registerActivityTools(server) {
                 kinds: params.kinds ?? null,
                 category: (params.category ?? "work"),
                 project: params.project ?? null,
-                limit: params.limit ?? 100,
+                limit: params.limit ?? 50,
+                compact: params.compact ?? false,
                 now: new Date(),
             });
             return toolSuccess(result);

package/dist/tools/directions-tools.js

@@ -294,7 +294,7 @@ export function registerDirectionsTools(server, client, fieldCache) {
     }, async (args) => {
         return await runDirections({ ...args, audience: "human" });
     });
-    server.tool("ralph_hero__next_actions", "Compute up to N deterministic 'directions' (next actions) with one flagged `recommended: true`. Used by the /hello skill picker (interactive) and by headless orchestrators (auto-select recommended). Open PRs must be passed in as a parameter. Each direction includes a structured signals object (staleDays, staleThresholdDays, tiedAtScore, estimateWeight, parentChainNote) for skills to synthesize prose. The legacy 'reason' string is @deprecated and removed in 2.7.0.", {
+    server.tool("ralph_hero__next_actions", "Compute up to N deterministic 'directions' (next actions) with one flagged `recommended: true`. Used by the /hello skill picker (interactive) and by headless orchestrators (auto-select recommended). Open PRs must be passed in as a parameter. Each direction includes a structured signals object (staleDays, staleThresholdDays, tiedAtScore, estimateWeight, parentChainNote) for skills to synthesize prose. The legacy 'reason' string is @deprecated and removed in 2.7.0. When `audience='agent'` and no items are in actionable phases (Plan in Review, In Review, Ready for Plan, Research Needed) or otherwise surfacing (lock-stale, unblock-requested), the picker falls back to Backlog and null-state items so autopilot can drive triage. Fallback items receive a fixed score penalty so they never outrank actionable items when those exist; the fallback never fires for `audience='human'`.", {
         owner: z
             .string()
             .optional()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ralph-hero-mcp-server",
-  "version": "2.5.113",
+  "version": "2.5.116",
   "description": "MCP server for GitHub Projects V2 - Ralph workflow automation",
   "type": "module",
   "main": "dist/index.js",