@yemi33/minions 0.1.1867 → 0.1.1868

package/CHANGELOG.md

@@ -1,14 +1,13 @@
 # Changelog
 
-## 0.1.1867 (2026-05-11)
+## 0.1.1868 (2026-05-11)
 
-### Fixes
-- harden PRD filename uniqueness against TOCTOU collisions (#2346)
+### Other
+- docs(shared): JSDoc + tests for getCanonicalPrId (#2339)
+
+## 0.1.1866 (2026-05-11)
 
 ### Other
-- test(consolidation): add unit tests for archiveInboxFiles, buildConsolidationPrompt, consolidateInbox state-flag handling (#2348)
-- test(cooldown): add unit tests for normalizePrHeadForCooldown, getPrReviewHead, getPrReviewCooldownBase, clearLegacyPrReviewCooldown, clearCooldown (#2347)
-- test(meeting): add unit tests for meeting pure helpers (round/content/artifact) (#2343)
 - test(scheduler): add unit tests for writeScheduleRunEntry, createScheduledWorkItem, recordScheduleRun (#2341)
 
 ## 0.1.1865 (2026-05-11)

package/engine/shared.js

@@ -2751,6 +2751,34 @@ function isPrCompatibleWithProject(project, prRef, url = '') {
   return !getPrProjectScopeMismatch(project, prRef, url);
 }
 
+/**
+ * Build a canonical, repository-scoped PR identifier.
+ *
+ * Disambiguates PR numbers across hosts/repos by prefixing with the host scope
+ * derived from `url` (if it parses as a known host PR URL) or otherwise from
+ * the `project` config. The `url` always wins when present so that a PR
+ * record carrying a foreign-host URL is not mis-scoped to its current
+ * project.
+ *
+ * Output shapes:
+ *   - GitHub project: `github:<owner>/<repo>#<prNumber>`        (e.g. `github:yemi33/minions#1234`)
+ *   - ADO project:    `ado:<org>/<adoProject>/<repo>#<prNumber>` (e.g. `ado:office/office/Office#5134010`)
+ *   - No usable scope but numeric prRef: `PR-<prNumber>` (legacy fallback)
+ *   - Unparseable: returns the raw id string (may be empty)
+ *
+ * @param {object|null} project - Project config; uses `repoHost`, `adoOrg`,
+ *   `adoProject`, `repoName`, and `prUrlBase` to derive the scope. May be null
+ *   when only `url` provides scope.
+ *   .
+ * @param {number|string|object} prRef - PR reference. Accepts a numeric id,
+ *   a numeric string, an existing canonical id (`github:owner/repo#42`),
+ *   a host PR URL, or a PR-record object with `id`/`url`/`prNumber` fields.
+ * @param {string} [url=''] - Full PR URL used for host disambiguation
+ *   (primary signal for ADO vs GitHub when `prRef` is bare-numeric and the
+ *   project config disagrees with the URL host).
+ * @returns {string} Canonical PR id string (see shapes above), or the raw id
+ *   when no scope and no number can be derived.
+ */
 function getCanonicalPrId(project, prRef, url = '') {
   const isObjectRef = !!prRef && typeof prRef === 'object';
   const rawId = isObjectRef ? (prRef.id || '') : String(prRef || '');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yemi33/minions",
-  "version": "0.1.1867",
+  "version": "0.1.1868",
   "description": "Multi-agent AI dev team that runs from ~/.minions/ — five autonomous agents share a single engine, dashboard, and knowledge base",
   "bin": {
     "minions": "bin/minions.js"