forgedock 1.1.2 → 1.1.4

package/docs/site/command-reference.md

@@ -278,6 +278,40 @@ Shows what will deploy next — diff between staging and main with issue/PR summ
 
 ---
 
+### `/deploy-pr`
+
+**PR ship orchestrator.**
+
+Ships a branch to its deploy target — detects or creates the PR, runs CI fixing via `/fix-ci`, runs the review gate via `/review-pr`, merges after both pass, and returns a structured result. Designed to be invoked by `/autopilot` as part of the autonomous deploy loop.
+
+```bash
+/deploy-pr staging                           # Ship staging → main
+/deploy-pr milestone/my-feature              # Ship milestone → staging
+/deploy-pr feat/my-branch --target staging   # Ship any branch → staging
+/deploy-pr staging --dry-run                 # Simulate without merging
+/deploy-pr staging --issue 1234              # Reference parent issue in PR body
+```
+
+**Branch routing**: `staging` → `main` (Deploy), `milestone/*` → `staging` (Ship), other → `staging` (Merge). Never force-merges. Returns `{ pr, source, target, status, ci_fixes, review_findings }`.
+
+---
+
+### `/fix-ci`
+
+**Automated CI failure resolution loop.**
+
+Diagnoses CI failures on a PR, applies targeted fixes, pushes new commits, and loops until green or max attempts reached. Invoked automatically by `/deploy-pr` as the CI gate step; can also be run directly.
+
+```bash
+/fix-ci 123                       # Fix CI on PR #123
+/fix-ci 123 --max-attempts 5      # Allow up to 5 fix iterations
+/fix-ci 123 --repo owner/repo     # Explicit repo
+```
+
+Returns `{ pr, status, attempts, fixes_applied }`.
+
+---
+
 #### `/rollback`
 
 **Revert PR creator.**
@@ -370,6 +404,21 @@ Cleans up stale labels, missing workflow state, project board gaps, dangling wor
 
 ---
 
+### `/recover-orphans`
+
+**Pipeline orphan recovery.**
+
+Scans for issues stuck in intermediate workflow states (building, investigating, in-review) where the agent died mid-pipeline. Diagnoses each orphan's actual GitHub state and applies the appropriate recovery action — re-entering the pipeline via `/work-on` or `/review-pr`.
+
+```bash
+/recover-orphans                  # Scan and recover all orphans
+/recover-orphans --dry-run        # Show orphans without recovering
+/recover-orphans --since 24       # Only orphans stalled > 24 hours
+/recover-orphans --issue 42       # Recover a specific issue
+```
+
+---
+
 #### `/pipeline-health`
 
 **Pipeline performance analyzer.**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "forgedock",
-  "version": "1.1.2",
+  "version": "1.1.4",
   "description": "Autonomous dev pipeline for Claude Code. GitHub as institutional memory — every issue, PR, and annotation survives context resets and makes the next agent smarter.",
   "bin": {
     "forgedock": "bin/forgedock.mjs"

package/packages/protocol/src/parse.js

@@ -98,6 +98,31 @@ function escapeRegExp(str) {
   return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
 }
 
+/**
+ * Reverse the HTML entity escapes applied by emit()'s sanitizeFieldValue().
+ *
+ * emit() escapes three HTML comment delimiter sequences to protect GitHub's
+ * renderer from comment injection:
+ *   1. `<!--`  → `&lt;!--`   (forge#1638)
+ *   2. `--!>`  → `--!&gt;`   (forge#1594)
+ *   3. `-->`   → `--&gt;`    (forge#1594)
+ *
+ * parse() must apply the inverse so that round-tripping through emit → parse
+ * is lossless. Unescape order: `--!&gt;` before `--&gt;` (most-specific first)
+ * to avoid the `!` being left dangling by an overly-greedy `--&gt;` pass.
+ * The `&lt;!--` unescape is independent and can run in any relative order.
+ * (forge#1662)
+ *
+ * @param {string} raw
+ * @returns {string}
+ */
+function unescapeFieldValue(raw) {
+  return raw
+    .replace(/--!&gt;/g, '--!>')
+    .replace(/--&gt;/g, '-->')
+    .replace(/&lt;!--/g, '<!--');
+}
+
 /**
  * Extract **Key**: value fields from an annotation body.
  *
@@ -109,7 +134,7 @@ function extractFields(body) {
   for (const line of body.split('\n')) {
     const m = line.trim().match(BOLD_FIELD_RE);
     if (m) {
-      fields[m[1].trim()] = m[2].trim();
+      fields[unescapeFieldValue(m[1].trim())] = unescapeFieldValue(m[2].trim());
     }
   }
   return fields;
@@ -169,7 +194,7 @@ export function parse(commentBody) {
       continue;
     }
 
-    const inlineValue = rawInlineValue;
+    const inlineValue = rawInlineValue !== null ? unescapeFieldValue(rawInlineValue) : null;
     const typeDef = typeDefForTag;
     const isControl = typeDef?.controlMarker === true;
     const isReserved = RESERVED_TYPE_NAMES.has(type);