@pourkit/cli 0.0.0-next-20260607184355 → 0.0.0-next-20260607223610

package/dist/cli.js

@@ -2867,8 +2867,9 @@ function parseConflictResolutionArtifact(output) {
 import { existsSync as existsSync5, readdirSync as readdirSync2, readFileSync as readFileSync5 } from "fs";
 import { dirname as dirname3, isAbsolute, join as join6, relative } from "path";
 import { z as z2 } from "zod";
+var PRD_REF_FOUR_DIGIT = /^PRD-\d{4,}$/;
 var PlanningArtifactManifestSchema = z2.object({
-  prdRef: z2.string().regex(/^PRD-\d+$/),
+  prdRef: z2.string().regex(PRD_REF_FOUR_DIGIT),
   parentIssue: z2.object({
     number: z2.number().int().positive(),
     url: z2.string().url(),
@@ -2927,7 +2928,15 @@ function readPlanningArtifactManifest(repoRoot2, prdRef) {
   if (!parsed.ok) {
     return parsed;
   }
-  return validatePlanningArtifactManifestReadiness(parsed.manifest);
+  const readiness = validatePlanningArtifactManifestReadiness(parsed.manifest);
+  if (!readiness.ok) {
+    return readiness;
+  }
+  return {
+    ok: true,
+    manifest: readiness.manifest,
+    ...location.locationDiagnostics?.length ? { warnings: location.locationDiagnostics } : {}
+  };
 }
 function validatePlanningArtifactManifestAtPath(repoRoot2, manifestPath) {
   let content;
@@ -2984,6 +2993,10 @@ function validatePlanningArtifactManifestReadiness(manifest) {
   }
   return { ok: true, manifest: schemaResult.data };
 }
+function deriveOldFormatRef(prdRef) {
+  const match = prdRef.match(/^PRD-0(\d{3})$/);
+  return match ? `PRD-${match[1]}` : null;
+}
 function findPlanningArtifactManifestLocation(repoRoot2, prdRef) {
   const initiativesRoot = join6(
     repoRoot2,
@@ -3010,26 +3023,35 @@ function findPlanningArtifactManifestLocation(repoRoot2, prdRef) {
   }).filter((entry) => entry.isDirectory()).map((entry) => join6(initiativesRoot, entry.name)).sort();
   const diagnostics = [];
   const collatedOffendingPaths = [];
+  const oldFormatRef = deriveOldFormatRef(prdRef);
   for (const initiativeDir of initiativeDirs) {
     const indexPath = join6(initiativeDir, "INDEX.md");
     if (!existsSync5(indexPath)) continue;
     const indexContent = readFileSync5(indexPath, "utf-8");
-    const manifestLine = indexContent.split(/\r?\n/).find(
+    const lines = indexContent.split(/\r?\n/);
+    const fourDigitLine = lines.find(
       (line) => line.includes(prdRef) && line.includes("planning-manifest.md")
     );
+    const threeDigitLine = oldFormatRef ? lines.find(
+      (line) => line.includes(oldFormatRef) && line.includes("planning-manifest.md")
+    ) : null;
+    const manifestLine = fourDigitLine ?? threeDigitLine;
     if (!manifestLine) continue;
     const manifestPath = extractBacktickedPath(manifestLine);
     if (!manifestPath) {
       diagnostics.push(
-        `INDEX.md matched ${prdRef} but did not expose a manifest path: ${toRepoRelativePath(repoRoot2, indexPath)}`
+        `INDEX.md matched ${prdRef}${oldFormatRef ? ` (or ${oldFormatRef})` : ""} but did not expose a manifest path: ${toRepoRelativePath(repoRoot2, indexPath)}`
       );
       collatedOffendingPaths.push(toRepoRelativePath(repoRoot2, indexPath));
       continue;
     }
-    const expectedPattern = new RegExp(
+    const expectedFourDigitPattern = new RegExp(
       `^prds/${prdRef}-[^/]+/planning-manifest\\.md$`
     );
-    if (!expectedPattern.test(manifestPath)) {
+    const expectedThreeDigitPattern = oldFormatRef ? new RegExp(`^prds/${oldFormatRef}-[^/]+/planning-manifest\\.md$`) : null;
+    const matchedFourDigit = expectedFourDigitPattern.test(manifestPath);
+    const matchedThreeDigit = expectedThreeDigitPattern?.test(manifestPath) ?? false;
+    if (!matchedFourDigit && !matchedThreeDigit) {
       diagnostics.push(
         `INDEX.md path does not match expected pattern prds/${prdRef}-<slug>/planning-manifest.md. Found: ${manifestPath} (${toRepoRelativePath(repoRoot2, indexPath)})`
       );
@@ -3049,7 +3071,16 @@ function findPlanningArtifactManifestLocation(repoRoot2, prdRef) {
       );
       continue;
     }
-    return { ok: true, manifestPath: absoluteManifestPath };
+    if (!matchedFourDigit && matchedThreeDigit) {
+      diagnostics.push(
+        `Old-format PRD ref ${oldFormatRef} found in INDEX.md at ${toRepoRelativePath(repoRoot2, indexPath)} for PRD ${prdRef}; should be migrated to ${prdRef}`
+      );
+    }
+    return {
+      ok: true,
+      manifestPath: absoluteManifestPath,
+      ...diagnostics.length > 0 ? { locationDiagnostics: [...diagnostics] } : {}
+    };
   }
   if (diagnostics.length > 0) {
     return {
@@ -3464,10 +3495,10 @@ function normalizePrdRunRef(ref) {
   const match = trimmed.match(/^(?:PRD-)?(\d+)$/);
   if (!match) {
     throw new Error(
-      `Invalid PRD ref "${ref}". Expected format: PRD-<number> (e.g., PRD-043)`
+      `Invalid PRD ref "${ref}". Expected format: PRD-<number> (e.g., PRD-0043)`
     );
   }
-  return `PRD-${match[1].padStart(3, "0")}`;
+  return `PRD-${match[1].padStart(4, "0")}`;
 }
 function normalizeRepoPath(pathValue) {
   return pathValue.split("\\").join("/");
@@ -3867,8 +3898,8 @@ function validateLocalPrepare(prdPath, issuePaths, options) {
     return { ...triageResult, gate: "triage_consistency" };
   }
   const protectedBranchNames = ["dev", "next", "main"];
-  const barePrdPattern = /^PRD-\d{3}$/;
-  const localPrdBranchPattern = /^local\/PRD-\d{3}$/;
+  const barePrdPattern = /^PRD-\d{4}$/;
+  const localPrdBranchPattern = /^local\/PRD-\d{4}$/;
   const dirtyRaw = tryExecSync("git status --porcelain", options?.repoRoot);
   if (dirtyRaw !== null && dirtyRaw.length > 0) {
     return {
@@ -3903,7 +3934,7 @@ function validateLocalPrepare(prdPath, issuePaths, options) {
       ok: false,
       gate: "branch_safety",
       failureCode: "branch_unsafe",
-      message: `PRD localPrdBranch "${localPrdBranch}" matches bare PRD-00N pattern without local/ prefix`
+      message: `PRD localPrdBranch "${localPrdBranch}" matches bare PRD-0000N pattern without local/ prefix`
     };
   }
   if (!localPrdBranchPattern.test(localPrdBranch)) {
@@ -3911,7 +3942,7 @@ function validateLocalPrepare(prdPath, issuePaths, options) {
       ok: false,
       gate: "branch_safety",
       failureCode: "branch_unsafe",
-      message: `PRD localPrdBranch "${localPrdBranch}" must match local/PRD-00N pattern`
+      message: `PRD localPrdBranch "${localPrdBranch}" must match local/PRD-0000N pattern`
     };
   }
   const branchExists = tryExecSync(
@@ -3965,7 +3996,7 @@ function validateLocalPrepare(prdPath, issuePaths, options) {
         gate: "branch_safety",
         failureCode: "branch_unsafe",
         offendingPath: issuePath,
-        message: `Issue branch "${branchName}" matches bare PRD-00N pattern without local/ prefix`
+        message: `Issue branch "${branchName}" matches bare PRD-0000N pattern without local/ prefix`
       };
     }
   }
@@ -4409,12 +4440,12 @@ function validateLocalIssue(path9) {
       message: "id must be a non-empty string"
     };
   }
-  if (typeof data.parentPrdId !== "string" || !/^PRD-\d{3}$/.test(data.parentPrdId.trim())) {
+  if (typeof data.parentPrdId !== "string" || !/^PRD-\d{4}$/.test(data.parentPrdId.trim())) {
     return {
       ok: false,
       failureCode: "invalid_issue_artifact",
       offendingPath: path9,
-      message: "parentPrdId must match PRD-00N format"
+      message: "parentPrdId must match PRD-0000N format"
     };
   }
   if (typeof data.title !== "string" || data.title.trim() === "") {
@@ -4507,12 +4538,12 @@ function validateLocalIssue(path9) {
       message: "dependencyIssueIds must be an array"
     };
   }
-  if (typeof data.branchName !== "string" || !/^local\/PRD-\d{3}\/I-\d{2}-[a-z0-9-]+$/.test(data.branchName)) {
+  if (typeof data.branchName !== "string" || !/^local\/PRD-\d{4}\/I-\d{2}-[a-z0-9-]+$/.test(data.branchName)) {
     return {
       ok: false,
       failureCode: "invalid_issue_artifact",
       offendingPath: path9,
-      message: "branchName must match local/PRD-00N/I-0N-slug pattern"
+      message: "branchName must match local/PRD-0000N/I-0N-slug pattern"
     };
   }
   if (!(data.blockedReason === null || typeof data.blockedReason === "string")) {
@@ -4628,7 +4659,7 @@ function validateLocalIssue(path9) {
   }
   return { ok: true };
 }
-var PRD_REF_PATTERN = /^PRD-\d+$/;
+var PRD_REF_PATTERN = /^PRD-\d{4}$/;
 var EVIDENCE_HASH_PATTERN = /^[0-9a-f]{64}$/;
 var RECONCILIATION_TMP_PATH_PREFIX = ".pourkit/.tmp/reconciliation/";
 function validateReconciliationArtifact(artifact) {
@@ -4639,7 +4670,7 @@ function validateReconciliationArtifact(artifact) {
   const a = artifact;
   if (typeof a.prdRef !== "string" || !PRD_REF_PATTERN.test(a.prdRef)) {
     errors.push(
-      `prdRef must match PRD-00N format, got ${JSON.stringify(a.prdRef)}`
+      `prdRef must match PRD-0000N format, got ${JSON.stringify(a.prdRef)}`
     );
   }
   if (a.stage !== "prdReconciliation") {
@@ -4651,7 +4682,7 @@ function validateReconciliationArtifact(artifact) {
     errors.push("checkoutBase must be a non-empty string");
   } else if (!PRD_REF_PATTERN.test(a.checkoutBase.trim())) {
     errors.push(
-      `checkoutBase must match active PRD branch format PRD-00N, got ${JSON.stringify(a.checkoutBase)}`
+      `checkoutBase must match active PRD branch format PRD-0000N, got ${JSON.stringify(a.checkoutBase)}`
     );
   }
   if (typeof a.mergeBase !== "string" || a.mergeBase.trim() === "") {
@@ -4680,6 +4711,19 @@ function validateReconciliationArtifact(artifact) {
       );
     }
   }
+  if (a.result === "no_changes_needed") {
+    const paths = a.changedPlanningPaths ?? [];
+    if (Array.isArray(paths) && paths.length > 0) {
+      errors.push(
+        `Reconciliation artifact result is "no_changes_needed" but changedPlanningPaths is not empty (${paths.length} paths).`
+      );
+    }
+    if (!a.noChangeRationale || typeof a.noChangeRationale !== "string") {
+      errors.push(
+        'Reconciliation artifact result is "no_changes_needed" but noChangeRationale is missing or not a string.'
+      );
+    }
+  }
   if (!Array.isArray(a.completionArtifactPaths) || !a.completionArtifactPaths.every((p) => typeof p === "string")) {
     errors.push("completionArtifactPaths must be an array of strings");
   }
@@ -6379,7 +6423,8 @@ function parseAffectedCodePaths(body) {
   return Array.from(paths);
 }
 function normalizeParentRef(ref) {
-  return ref?.trim().toUpperCase();
+  if (!ref) return void 0;
+  return ref.trim().toUpperCase().replace(/^(PRD-)(\d+)$/, (_, p, n) => `${p}${n.padStart(4, "0")}`);
 }
 function looksLikeRepoPath(value) {
   return /[./][A-Za-z0-9_-]/.test(value) && !value.includes(":");
@@ -7761,7 +7806,10 @@ import { join as join14 } from "path";
 import { z as z3 } from "zod";
 var PRD_RUN_STATE_DIR = ".pourkit/prd-runs";
 var PrdRunRecordSchema = z3.object({
-  prdRef: z3.string().regex(/^PRD-\d+$/),
+  prdRef: z3.string().regex(
+    /^PRD-\d{4}$/,
+    "PRD ref must use four-digit format (e.g., PRD-0052)"
+  ),
   status: z3.enum([
     "blocked",
     "preparing",
@@ -7890,10 +7938,10 @@ function normalizePrdRunRef2(ref) {
   const match = trimmed.match(/^(?:PRD-)?(\d+)$/);
   if (!match) {
     throw new Error(
-      `Invalid PRD ref "${ref}". Expected format: PRD-<number> (e.g., PRD-043)`
+      `Invalid PRD ref "${ref}". Expected format: PRD-<number> (e.g., PRD-0043)`
     );
   }
-  return `PRD-${match[1].padStart(3, "0")}`;
+  return `PRD-${match[1].padStart(4, "0")}`;
 }
 function readPrdRun(repoRoot2, prdRef) {
   const normalized = normalizePrdRunRef2(prdRef);
@@ -7954,7 +8002,7 @@ function writePrdRunRecord(repoRoot2, record) {
 }
 var LOCAL_PRD_RUN_STATE_DIR = ".pourkit/local-prd-runs";
 var LocalPrdRunRecordSchema = z3.object({
-  prdId: z3.string().regex(/^PRD-\d+$/),
+  prdId: z3.string().regex(/^PRD-\d{4}$/, "PRD id must use four-digit format (e.g., PRD-0052)"),
   createdAt: z3.string().min(1),
   receipts: z3.object({
     prepare: z3.object({
@@ -8582,7 +8630,7 @@ function getLocalPrdBranchName(prdId) {
   return `local/${prdId}`;
 }
 var PROTECTED_BRANCHES = /* @__PURE__ */ new Set(["dev", "next", "main"]);
-var LOCAL_BRANCH_PATTERN = /^local\/PRD-\d{3}(\/(I-\d{2}(-[a-z0-9-]+)?)?)?$/;
+var LOCAL_BRANCH_PATTERN = /^local\/PRD-\d{4}(\/(I-\d{2}(-[a-z0-9-]+)?)?)?$/;
 function validateLocalBranchName(name) {
   if (!name || name.length === 0) {
     return {
@@ -8611,7 +8659,7 @@ function isProtectedBranch(name) {
   return PROTECTED_BRANCHES.has(name);
 }
 function hasRemoteBackedCollision(localName, repoRoot2) {
-  const match = localName.match(/^local\/(PRD-\d{3})/);
+  const match = localName.match(/^local\/(PRD-\d{4})/);
   if (!match) {
     return Promise.resolve({
       ok: false,
@@ -13099,10 +13147,10 @@ function validateReconciliationArtifact2(artifact, context) {
   }
   return { ok: true };
 }
-var PRD_047_PRD_MIRROR_PATH = ".pourkit/architecture/initiatives/prd-run-lifecycle-and-integration-gate/prds/PRD-047-prd-reconciliation-run/PRD.md";
-var PRD_047_CHILD_ISSUE_DIR = ".pourkit/architecture/initiatives/prd-run-lifecycle-and-integration-gate/prds/PRD-047-prd-reconciliation-run/issues/";
+var PRD_047_PRD_MIRROR_PATH = ".pourkit/architecture/initiatives/prd-run-lifecycle-and-integration-gate/prds/PRD-0047-prd-reconciliation-run/PRD.md";
+var PRD_047_CHILD_ISSUE_DIR = ".pourkit/architecture/initiatives/prd-run-lifecycle-and-integration-gate/prds/PRD-0047-prd-reconciliation-run/issues/";
 var PRD_047_ESCAPE_HATCH_PATH = ".pourkit/architecture/initiatives/prd-run-lifecycle-and-integration-gate/completions/006-prd-047-prd-reconciliation-run-status.md";
-var PRD_047_MANIFEST_PATH = ".pourkit/architecture/initiatives/prd-run-lifecycle-and-integration-gate/prds/PRD-047-prd-reconciliation-run/planning-manifest.md";
+var PRD_047_MANIFEST_PATH = ".pourkit/architecture/initiatives/prd-run-lifecycle-and-integration-gate/prds/PRD-0047-prd-reconciliation-run/planning-manifest.md";
 function auditPrd047Implementation(repoRoot2, prdRef) {
   const normalizedRef = normalizePrdRunRef2(prdRef);
   const blockerBugs = [];
@@ -13123,7 +13171,7 @@ function auditPrd047Implementation(repoRoot2, prdRef) {
   const prdMirrorExists = existsSync16(prdMirrorPath);
   if (!prdMirrorExists) {
     nonBlockers.push(
-      `PRD-047 PRD mirror not found at ${PRD_047_PRD_MIRROR_PATH}. Cannot verify scope alignment from published mirrors.`
+      `PRD-0047 PRD mirror not found at ${PRD_047_PRD_MIRROR_PATH}. Cannot verify scope alignment from published mirrors.`
     );
   }
   if (prdMirrorExists) {
@@ -13132,12 +13180,12 @@ function auditPrd047Implementation(repoRoot2, prdRef) {
     const hasEscapeHatch = mirrorContent.includes("escape hatch");
     if (!hasReconcileCommand) {
       blockerBugs.push(
-        "PRD-047 PRD mirror does not reference prd-run reconcile command."
+        "PRD-0047 PRD mirror does not reference prd-run reconcile command."
       );
     }
     if (!hasEscapeHatch) {
       nonBlockers.push(
-        "PRD-047 PRD mirror does not reference escape hatch mechanism."
+        "PRD-0047 PRD mirror does not reference escape hatch mechanism."
       );
     }
   }
@@ -13145,7 +13193,7 @@ function auditPrd047Implementation(repoRoot2, prdRef) {
   const childIssuesExist = existsSync16(childIssueDir);
   if (!childIssuesExist) {
     nonBlockers.push(
-      `PRD-047 child Issue mirrors not found at ${PRD_047_CHILD_ISSUE_DIR}.`
+      `PRD-0047 child Issue mirrors not found at ${PRD_047_CHILD_ISSUE_DIR}.`
     );
   }
   const manifestPath = join19(repoRoot2, PRD_047_MANIFEST_PATH);
@@ -13216,16 +13264,16 @@ function auditPrd047Implementation(repoRoot2, prdRef) {
   }
   if (!prdMirrorExists && !childIssuesExist && !prdRunRecord.record) {
     nonBlockers.push(
-      "Insufficient evidence to verify PRD-047 scope alignment: mirrors and PRD Run record are missing."
+      "Insufficient evidence to verify PRD-0047 scope alignment: mirrors and PRD Run record are missing."
     );
   }
   if (escapeHatchPresent) {
     blockersFixed.push(
-      "PRD-047 escape-hatch lifecycle violation record confirmed present."
+      "PRD-0047 escape-hatch lifecycle violation record confirmed present."
     );
   } else {
     nonBlockers.push(
-      "PRD-047 escape-hatch lifecycle violation record is missing. Expected at " + PRD_047_ESCAPE_HATCH_PATH + "."
+      "PRD-0047 escape-hatch lifecycle violation record is missing. Expected at " + PRD_047_ESCAPE_HATCH_PATH + "."
     );
   }
   return {
@@ -18957,10 +19005,13 @@ function normalizePrdRef(ref) {
   const normalized = ref.trim().toUpperCase();
   if (!/^PRD-\d+$/.test(normalized)) {
     throw new Error(
-      `Invalid PRD ref "${ref}". Expected format: PRD-<number> (e.g., PRD-021)`
+      `Invalid PRD ref "${ref}". Expected format: PRD-<number> (e.g., PRD-0021)`
     );
   }
-  return normalized;
+  return normalized.replace(
+    /^(PRD-)(\d+)$/,
+    (_, p, n) => `${p}${n.padStart(4, "0")}`
+  );
 }
 function buildPrCreateArgs(options) {
   const args = ["--target", options.target, "--title", options.title];
@@ -19790,11 +19841,11 @@ function createCliProgram(version) {
   return program;
 }
 async function resolveCliVersion() {
-  if (isPackageVersion("0.0.0-next-20260607184355")) {
-    return "0.0.0-next-20260607184355";
+  if (isPackageVersion("0.0.0-next-20260607223610")) {
+    return "0.0.0-next-20260607223610";
   }
-  if (isReleaseVersion("0.0.0-next-20260607184355")) {
-    return "0.0.0-next-20260607184355";
+  if (isReleaseVersion("0.0.0-next-20260607223610")) {
+    return "0.0.0-next-20260607223610";
   }
   try {
     const root = repoRoot();