@maintainabilityai/research-runner 0.1.17 → 0.1.19

package/dist/llm/llm-router.js

@@ -67,17 +67,24 @@ async function callAnthropicTier(opts, tierModels) {
     };
 }
 /**
- * GitHub Models returns 401 / 403 / 404 when the token can't reach the
- * requested model (typically the workflow bot token hitting a "custom"-
- * tier model like gpt-5-chat). These are recoverable via fallback;
- * everything else (timeouts, 5xx, 413 cap, parse errors) should
- * propagate.
+ * GitHub Models returns these statuses when the token can't reach the
+ * requested model or is being throttled. All recoverable via the
+ * github-models→github-models fallback (custom-tier → low-tier).
+ *
+ *   401 / 403 — token lacks `models:read` or hasn't been enrolled in
+ *               the custom tier (workflow bot vs Copilot PAT)
+ *   404      — model id not visible to this token tier
+ *   429      — rate limited on the primary tier; the low-tier model
+ *              has its own bucket so the fallback often succeeds
+ *
+ * Everything else (timeouts, 5xx, 413 token cap, parse errors)
+ * propagates — those are not "wrong model" problems.
  */
 function isModelAccessError(err) {
     if (!(err instanceof Error)) {
         return false;
     }
-    return /GitHub Models returned 40[134]:/.test(err.message);
+    return /GitHub Models returned (?:401|403|404|429):/.test(err.message);
 }
 async function callGitHubModelsTier(opts, tierModels) {
     if (!opts.githubToken) {

package/dist/runner/nodes/format-for-human.js

@@ -154,15 +154,13 @@ function formatForHuman(opts) {
     lines.push('Assign this issue to `@github-copilot` (or another agent) to produce the synthesis. The assignee should:');
     lines.push('');
     lines.push('1. **Read every source** above. The `S[N]` ids are how you cite them.');
-    lines.push('2. **Open a PR** with a new file under `research/` containing the synthesis markdown.');
-    lines.push('3. **Follow the canonical structure** — see `.caterpillar/prompts/research/synthesis.md` in this mesh. The synthesis must have:');
-    lines.push('   - 10 H2 sections in the order: `Executive Summary`, `Cross-Source Analysis`, `Jobs-to-be-Done Analysis`, `Whitespace Analysis`, `Patent Landscape`, `Community Signal`, `Academic Foundation`, `Conclusions`, `Recommendations`, `Open Questions`.');
-    lines.push('   - Every claim cites at least one `S[N]`.');
-    lines.push('   - Every Conclusion `C[N]` cites ≥2 sources (≥1 if confidence is LOW).');
-    lines.push('   - Every Recommendation references at least one `C[N]`.');
+    lines.push('2. **Read the synthesis spec FIRST**: `.caterpillar/prompts/research/synthesis.md` in this mesh is the canonical structure. **Do NOT use any section names, ordering, or formatting other than what that file specifies.** The list of sections, the per-finding scaffolding, the citation rules, and the heading drift constraints all live there — follow them exactly.');
+    lines.push('3. **Open a PR** with a new file under `research/<run-id>/synthesis.md` containing the synthesis markdown.');
     lines.push('4. **PR labels** to apply: `research-synthesis`, `ai-assisted`.');
     lines.push('5. **Once merged**, the PRD agent will read your synthesis + the mesh + impacted code repos to produce per-repo landing issues.');
     lines.push('');
+    lines.push('> ⚠ Earlier iterations of this comment listed sections inline, which let agents skip the spec file. The spec at `.caterpillar/prompts/research/synthesis.md` is now the **single source of truth** for sections, ordering, citation rules, and per-finding format. The downstream PRD agent parses on exact heading strings — drift breaks the pipeline.');
+    lines.push('');
     lines.push('---');
     lines.push('');
     lines.push(`🤖 Generated by \`research-runner archeologist\`. Run id: \`${runId}\` (see the Hatter's Tag for agent version + audit chain).`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maintainabilityai/research-runner",
-  "version": "0.1.17",
+  "version": "0.1.19",
   "description": "Research + PRD agent runner — orchestrates the Archeologist and PRD pipelines for the MaintainabilityAI governance mesh",
   "license": "MIT",
   "author": "MaintainabilityAI",