ralph-hero-mcp-server 2.5.117 → 2.5.118

package/dist/lib/dashboard.js

@@ -512,7 +512,7 @@ export function buildDashboard(items, config = DEFAULT_HEALTH_CONFIG, now = Date
     const iterationSection = buildIterationSection(items);
     return {
         generatedAt: new Date(now).toISOString(),
-        totalIssues: items.length,
+        boardItems: items.length,
         phases,
         health: {
             ok: warnings.length === 0,
@@ -536,7 +536,7 @@ export function formatMarkdown(data, issuesPerPhase = 10) {
     lines.push(`# Pipeline Status`);
     lines.push(`_Generated: ${data.generatedAt}_`);
     lines.push("");
-    lines.push(`**Total issues**: ${data.totalIssues}`);
+    lines.push(`**Board items**: ${data.boardItems}`);
     lines.push("");
     // Phase table
     lines.push("| Phase | Count | Points | Issues |");

package/dist/lib/hygiene.js

@@ -262,7 +262,7 @@ export function buildHygieneReport(items, config = DEFAULT_HYGIENE_CONFIG, now =
     }
     return {
         generatedAt: new Date(now).toISOString(),
-        totalItems: items.length,
+        boardItems: items.length,
         archiveCandidates,
         staleItems,
         orphanedItems,
@@ -294,7 +294,7 @@ export function formatHygieneMarkdown(report) {
     lines.push("# Project Hygiene Report");
     lines.push(`_Generated: ${report.generatedAt}_`);
     lines.push("");
-    lines.push(`**Total items**: ${report.totalItems}`);
+    lines.push(`**Board items**: ${report.boardItems}`);
     lines.push("");
     // Summary
     lines.push("## Summary");

package/dist/tools/dashboard-tools.js

@@ -20,7 +20,7 @@ export { DASHBOARD_ITEMS_QUERY, toDashboardItems };
 // Register dashboard tools
 // ---------------------------------------------------------------------------
 export function registerDashboardTools(server, client, fieldCache) {
-    server.tool("ralph_hero__pipeline_dashboard", "Generate pipeline status dashboard with issue counts per workflow phase, health indicators, and formatted output. Returns structured data with optional markdown or ASCII rendering.", {
+    server.tool("ralph_hero__pipeline_dashboard", "Generate pipeline status dashboard with issue counts per workflow phase, health indicators, and formatted output. Returns structured data with optional markdown or ASCII rendering. Top-level `boardItems` is the raw count of all project items including PRs (uniform across discovery tools — next_actions, pipeline_dashboard, project_hygiene). Per-phase `count` values reflect that phase's bucket; for `Done` and `Canceled`, the count is bounded by `doneWindowDays` (default 7) and may be smaller than the actual phase membership. Per-iteration `totalIssues` is a distinct concept (iteration-scoped count).", {
         owner: z
             .string()
             .optional()

package/dist/tools/directions-tools.js

@@ -20,7 +20,7 @@
  *   5. Build a `RankConfig` from the args + defaults (with injected `now`).
  *   6. Compute each PR's `ageHours` at the boundary and call
  *      `rankDirections(allItems, enrichedPRs, config)`.
- *   7. Return `{ directions, fetchedAt, totalCandidates }`.
+ *   7. Return `{ directions, fetchedAt, boardItems }`.
  *
  * Determinism: `fetchedAt` is the only time-varying field. Two consecutive
  * calls on the same board state produce byte-identical `directions[]`
@@ -295,7 +295,11 @@ export function makeRunDirections(client, fieldCache) {
             return toolSuccess({
                 directions,
                 fetchedAt: now.toISOString(),
-                totalCandidates: allItems.length,
+                // `boardItems` is the raw count of items on the project board pre-filter
+                // (sum across all configured project numbers). Uniform across discovery
+                // tools (next_actions, pipeline_dashboard, project_hygiene). The number
+                // of returned `directions` is bounded by `limit` and may be much smaller.
+                boardItems: allItems.length,
             });
         }
         catch (error) {
@@ -309,7 +313,7 @@ export function makeRunDirections(client, fieldCache) {
 // ---------------------------------------------------------------------------
 export function registerDirectionsTools(server, client, fieldCache) {
     const runDirections = makeRunDirections(client, fieldCache);
-    server.tool("ralph_hero__hello_directions", "[DEPRECATED — use ralph_hero__next_actions instead. Removed in 2.7.0.] Compute up to N deterministic 'directions' for the hello skill's session briefing. Open PRs are fetched internally via the configured GitHub token's `repo` scope (one `is:pr is:open repo:owner/name` GraphQL search per unique repo represented in the project items). 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__hello_directions", "[DEPRECATED — use ralph_hero__next_actions instead. Removed in 2.7.0.] Compute up to N deterministic 'directions' for the hello skill's session briefing. Open PRs are fetched internally via the configured GitHub token's `repo` scope (one `is:pr is:open repo:owner/name` GraphQL search per unique repo represented in the project items). 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. Returns `{ directions, fetchedAt, boardItems }` where `boardItems` is the raw count of items on the project board pre-filter (uniform across discovery tools); the returned `directions` array is bounded by `limit`.", {
         owner: z
             .string()
             .optional()
@@ -352,7 +356,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 are fetched internally via the configured GitHub token's `repo` scope (one `is:pr is:open repo:owner/name` GraphQL search per unique repo represented in the project items) — callers no longer pass an `openPRs` argument. 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'`.", {
+    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 are fetched internally via the configured GitHub token's `repo` scope (one `is:pr is:open repo:owner/name` GraphQL search per unique repo represented in the project items) — callers no longer pass an `openPRs` argument. 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'`. Returns `{ directions, fetchedAt, boardItems }` where `boardItems` is the raw count of items on the project board pre-filter (uniform across discovery tools); the returned `directions` array is bounded by `limit`.", {
         owner: z
             .string()
             .optional()

package/dist/tools/hygiene-tools.js

@@ -14,7 +14,7 @@ import { toolSuccess, toolError, resolveProjectOwner, resolveProjectNumbers, } f
 // Register hygiene tools
 // ---------------------------------------------------------------------------
 export function registerHygieneTools(server, client, fieldCache) {
-    server.tool("ralph_hero__project_hygiene", "Generate a project board hygiene report. Identifies archive candidates, stale items, orphaned backlog entries, missing fields, WIP violations, and duplicate candidates. Returns: report with 7 sections + summary stats.", {
+    server.tool("ralph_hero__project_hygiene", "Generate a project board hygiene report. Identifies archive candidates, stale items, orphaned backlog entries, missing fields, WIP violations, and duplicate candidates. Returns: report with 7 sections + summary stats. Top-level `boardItems` is the raw count of items on the project board pre-filter (uniform across discovery tools — next_actions, pipeline_dashboard, project_hygiene). Per-category counts in `summary` (archiveCandidateCount, staleCount, orphanCount, fieldCoveragePercent, wipViolationCount, duplicateCandidateCount) are post-filter and represent distinct buckets.", {
         owner: z
             .string()
             .optional()

package/package.json

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