@warpgogol/forge 5.1.3 → 5.2.0

package/dist/os/rfc/handlers/pipeline-status.js.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline-status.js","sourceRoot":"","sources":["../../../../os/rfc/handlers/pipeline-status.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"pipeline-status.js","sourceRoot":"","sources":["../../../../os/rfc/handlers/pipeline-status.ts"],"names":[],"mappings":"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"}

package/dist/src/pipeline-status.d.ts

@@ -0,0 +1,62 @@
+export type PipelineStage = "audit" | "enhance" | "plan" | "implement";
+export interface RfcPipelineStageInfo {
+    stage: PipelineStage;
+    done: boolean;
+    /** File or marker that confirms completion, when applicable. */
+    evidence?: string;
+}
+export declare const TERMINAL_STATUSES: ReadonlySet<string>;
+export interface ParsedDocument {
+    frontmatter: Record<string, unknown>;
+    body: string;
+}
+export declare function parseFrontmatter(source: string): ParsedDocument;
+export declare function findAuditFile(workspaceRoot: string, docId: string): Promise<string | undefined>;
+export declare function findPlanFile(workspaceRoot: string, docId: string): Promise<string | undefined>;
+export type QueueDocumentKind = "rfc" | "adr";
+export interface ResolvedDocument {
+    id: string;
+    kind: QueueDocumentKind;
+    /** Workspace-relative path to the document file. */
+    file: string;
+    frontmatter: Record<string, unknown>;
+}
+/**
+ * Resolve an RFC-XXXX or ADR-XXXX id to its document file and parsed
+ * frontmatter. Scans the active dir and archive subdirectories recursively.
+ * Returns undefined when the id is malformed or no file matches.
+ */
+export declare function resolveDocument(workspaceRoot: string, docId: string): Promise<ResolvedDocument | undefined>;
+export interface RfcStageInput {
+    status: string;
+    enhancedAt?: string;
+    implementedAt?: string;
+    auditFile?: string;
+    planFile?: string;
+}
+/** Compute the four pipeline stages for an RFC from frontmatter + artifacts. */
+export declare function computeRfcPipelineStages(input: RfcStageInput): RfcPipelineStageInfo[];
+/** First incomplete stage for a non-terminal RFC, or null when terminal. */
+export declare function nextPipelineStep(status: string, stages: RfcPipelineStageInfo[]): PipelineStage | null;
+export type QueueItemStatus = "pending" | "in-progress" | "implemented" | "skipped";
+export interface QueueItemReport {
+    id: string;
+    status: QueueItemStatus;
+    /** First incomplete pipeline stage — present only when in-progress. */
+    pipelineStep?: PipelineStage;
+}
+/**
+ * Derive the queue status of a single document per the RFC-1140 matrix:
+ * implemented → implemented; rejected/superseded → skipped; RFC accepted or
+ * plan file → in-progress/implement; enhancedAt → in-progress/plan; audit
+ * file → in-progress/enhance; otherwise pending. ADR non-terminal → pending.
+ */
+export declare function deriveQueueItemStatus(workspaceRoot: string, docId: string): Promise<QueueItemReport | undefined>;
+export interface QueueReport {
+    items: QueueItemReport[];
+    /** First item whose derived status is pending or in-progress; null when fully terminal. */
+    next: string | null;
+}
+/** Derive the full queue report, preserving manifest order. */
+export declare function deriveQueueReport(workspaceRoot: string, itemIds: string[]): Promise<QueueReport>;
+//# sourceMappingURL=pipeline-status.d.ts.map

package/dist/src/pipeline-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-status.d.ts","sourceRoot":"","sources":["../../src/pipeline-status.ts"],"names":[],"mappings":"AAmCA,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,WAAW,CAAC;AAEvE,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,aAAa,CAAC;IACrB,IAAI,EAAE,OAAO,CAAC;IACd,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,MAAM,CAIhD,CAAC;AAMH,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAS/D;AAMD,wBAAsB,aAAa,CACjC,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAU7B;AAED,wBAAsB,YAAY,CAChC,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAU7B;AAMD,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG,KAAK,CAAC;AAE9C,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,iBAAiB,CAAC;IACxB,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AA+BD;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAuBvC;AAMD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,gFAAgF;AAChF,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,aAAa,GAAG,oBAAoB,EAAE,CAerF;AAED,4EAA4E;AAC5E,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,oBAAoB,EAAE,GAC7B,aAAa,GAAG,IAAI,CAMtB;AAMD,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,aAAa,GAAG,aAAa,GAAG,SAAS,CAAC;AAEpF,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,eAAe,CAAC;IACxB,uEAAuE;IACvE,YAAY,CAAC,EAAE,aAAa,CAAC;CAC9B;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CAoDtC;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,2FAA2F;IAC3F,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED,+DAA+D;AAC/D,wBAAsB,iBAAiB,CACrC,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,EAAE,GAChB,OAAO,CAAC,WAAW,CAAC,CAUtB"}

package/dist/src/pipeline-status.js

@@ -0,0 +1,220 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Shared pipeline-status resolver (RFC-1140) — derives per-document
+pipeline progress (audit, enhance, plan, implement) from document frontmatter
+and pipeline artifacts. Single source of truth consumed by rfc.pipeline.status,
+queue.validate, and the orchestrator's resume detection. Portable layer: no
+os/ or kernel imports.</purpose>
+<non-goals>
+  <item>Do not validate RFC/ADR content — use rfc.validate / adr.validate.</item>
+  <item>Do not mutate any files — derivation is read-only.</item>
+  <item>Do not store progress state — status is derived at read time, never persisted.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-1140: initial shared resolver — artifact conventions (audit-*.md,
+  plan-*.md, enhancedAt, implementedAt) extracted from
+  os/rfc/handlers/pipeline-status.ts; QueueItemStatus derivation matrix added
+  for queue.validate.</item>
+  <item>RFC-1140: steps 1-4 — shared resolver, queue module, registration
+
+Extract pipeline-status derivation into packages/forge/src/pipeline-status.ts, refactor rfc.pipeline.status onto it, add os/queue module with queue.validate command, register in WORKSHOP_MODULE_MAP.forge + bin/cli.ts + package.json exports.</item>
+  <item>RFC-1140: step 6 — cover shared resolver and queue.validate
+
+Add pipeline-status.test.ts (derivation matrix, order, next selection, ADR, skipped) and queue-validate.test.ts (schema errors, unknown/dup ids, id-filename mismatch, empty items, dependsOn warning, JSON shape). Fix queue derivation: pipelineStep is the stage after the last completed stage, not first incomplete — handles non-contiguous artifacts.</item>
+</CHANGE_SUMMARY>
+*/
+import fs from "node:fs/promises";
+import path from "node:path";
+import YAML from "yaml";
+export const TERMINAL_STATUSES = new Set([
+    "implemented",
+    "rejected",
+    "superseded",
+]);
+export function parseFrontmatter(source) {
+    const match = source.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/);
+    if (!match) {
+        return { frontmatter: {}, body: source };
+    }
+    return {
+        frontmatter: (YAML.parse(match[1]) ?? {}),
+        body: match[2] ?? "",
+    };
+}
+// ---------------------------------------------------------------------------
+// Artifact finders — the canonical conventions
+// ---------------------------------------------------------------------------
+export async function findAuditFile(workspaceRoot, docId) {
+    const auditsDir = path.join(workspaceRoot, "docs/audits");
+    try {
+        const entries = await fs.readdir(auditsDir);
+        const prefix = `audit-${docId.toLowerCase()}`;
+        const match = entries.find((e) => e.toLowerCase().startsWith(prefix) && e.endsWith(".md"));
+        return match ? path.join("docs/audits", match) : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+export async function findPlanFile(workspaceRoot, docId) {
+    const plansDir = path.join(workspaceRoot, "docs/plans");
+    try {
+        const entries = await fs.readdir(plansDir);
+        const prefix = `plan-${docId.toLowerCase()}`;
+        const match = entries.find((e) => e.toLowerCase().startsWith(prefix) && e.endsWith(".md"));
+        return match ? path.join("docs/plans", match) : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+const DOC_ID_PATTERN = /^(RFC|ADR)-\d{4}$/i;
+async function scanForDocument(dirPath, relativePrefix, idLower) {
+    let entries;
+    try {
+        entries = await fs.readdir(dirPath, { withFileTypes: true });
+    }
+    catch {
+        return undefined;
+    }
+    for (const entry of entries) {
+        const relativePath = relativePrefix ? `${relativePrefix}/${entry.name}` : entry.name;
+        if (entry.isDirectory()) {
+            const found = await scanForDocument(path.join(dirPath, entry.name), relativePath, idLower);
+            if (found)
+                return found;
+        }
+        else if (entry.isFile() &&
+            entry.name.endsWith(".md") &&
+            entry.name.toLowerCase().startsWith(idLower)) {
+            return relativePath;
+        }
+    }
+    return undefined;
+}
+/**
+ * Resolve an RFC-XXXX or ADR-XXXX id to its document file and parsed
+ * frontmatter. Scans the active dir and archive subdirectories recursively.
+ * Returns undefined when the id is malformed or no file matches.
+ */
+export async function resolveDocument(workspaceRoot, docId) {
+    const idMatch = DOC_ID_PATTERN.exec(docId.trim());
+    if (!idMatch)
+        return undefined;
+    const kind = idMatch[1].toUpperCase() === "ADR" ? "adr" : "rfc";
+    const baseDir = kind === "adr" ? "docs/adrs" : "docs/rfcs";
+    const idLower = docId.toLowerCase();
+    const found = await scanForDocument(path.join(workspaceRoot, baseDir), "", idLower);
+    if (!found)
+        return undefined;
+    let source;
+    try {
+        source = await fs.readFile(path.join(workspaceRoot, baseDir, found), "utf-8");
+    }
+    catch {
+        return undefined;
+    }
+    const parsed = parseFrontmatter(source);
+    return {
+        id: docId.toUpperCase(),
+        kind,
+        file: path.join(baseDir, found),
+        frontmatter: parsed.frontmatter,
+    };
+}
+/** Compute the four pipeline stages for an RFC from frontmatter + artifacts. */
+export function computeRfcPipelineStages(input) {
+    return [
+        { stage: "audit", done: !!input.auditFile, evidence: input.auditFile },
+        {
+            stage: "enhance",
+            done: !!input.enhancedAt,
+            evidence: input.enhancedAt ? `enhancedAt: ${input.enhancedAt}` : undefined,
+        },
+        { stage: "plan", done: !!input.planFile, evidence: input.planFile },
+        {
+            stage: "implement",
+            done: input.status === "implemented" || !!input.implementedAt,
+            evidence: input.implementedAt ? `implementedAt: ${input.implementedAt}` : undefined,
+        },
+    ];
+}
+/** First incomplete stage for a non-terminal RFC, or null when terminal. */
+export function nextPipelineStep(status, stages) {
+    if (TERMINAL_STATUSES.has(status))
+        return null;
+    for (const s of stages) {
+        if (!s.done)
+            return s.stage;
+    }
+    return null;
+}
+/**
+ * Derive the queue status of a single document per the RFC-1140 matrix:
+ * implemented → implemented; rejected/superseded → skipped; RFC accepted or
+ * plan file → in-progress/implement; enhancedAt → in-progress/plan; audit
+ * file → in-progress/enhance; otherwise pending. ADR non-terminal → pending.
+ */
+export async function deriveQueueItemStatus(workspaceRoot, docId) {
+    const doc = await resolveDocument(workspaceRoot, docId);
+    if (!doc)
+        return undefined;
+    const fm = doc.frontmatter;
+    const status = String(fm["status"] ?? "");
+    const implementedAt = fm["implementedAt"] ? String(fm["implementedAt"]) : undefined;
+    if (status === "implemented" || implementedAt) {
+        return { id: doc.id, status: "implemented" };
+    }
+    if (status === "rejected" || status === "superseded") {
+        return { id: doc.id, status: "skipped" };
+    }
+    // ADR pipeline is create → implement — no intermediate artifacts exist.
+    if (doc.kind === "adr") {
+        return { id: doc.id, status: "pending" };
+    }
+    // RFC accepted means the plan step is done by definition.
+    if (status === "accepted") {
+        return { id: doc.id, status: "in-progress", pipelineStep: "implement" };
+    }
+    const enhancedAt = fm["enhancedAt"] ? String(fm["enhancedAt"]) : undefined;
+    const auditFile = await findAuditFile(workspaceRoot, doc.id);
+    const planFile = await findPlanFile(workspaceRoot, doc.id);
+    const stages = computeRfcPipelineStages({
+        status,
+        enhancedAt,
+        implementedAt,
+        auditFile,
+        planFile,
+    });
+    // Queue semantics: the actionable step is the stage AFTER the last completed
+    // one — artifacts may be non-contiguous (e.g. enhancedAt without an audit
+    // file), where "first incomplete stage" would wrongly report audit.
+    let lastDone = -1;
+    for (let i = 0; i < stages.length; i++) {
+        if (stages[i].done)
+            lastDone = i;
+    }
+    if (lastDone === -1) {
+        return { id: doc.id, status: "pending" };
+    }
+    const nextStage = stages[lastDone + 1];
+    if (!nextStage) {
+        return { id: doc.id, status: "pending" };
+    }
+    return { id: doc.id, status: "in-progress", pipelineStep: nextStage.stage };
+}
+/** Derive the full queue report, preserving manifest order. */
+export async function deriveQueueReport(workspaceRoot, itemIds) {
+    const items = [];
+    for (const id of itemIds) {
+        const report = await deriveQueueItemStatus(workspaceRoot, id);
+        // Unresolvable ids are reported by the manifest validator; the resolver
+        // skips them here so a partial report stays usable.
+        if (report)
+            items.push(report);
+    }
+    const nextItem = items.find((i) => i.status === "pending" || i.status === "in-progress");
+    return { items, next: nextItem?.id ?? null };
+}
+//# sourceMappingURL=pipeline-status.js.map

package/dist/src/pipeline-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-status.js","sourceRoot":"","sources":["../../src/pipeline-status.ts"],"names":[],"mappings":"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"}

package/os/queue/handlers/queue-validate.ts

@@ -0,0 +1,83 @@
+/*
+<MODULE_CONTRACT>
+<purpose>queue.validate command handler (RFC-1140) — validates a queue
+manifest and reports derived per-item pipeline status plus the next
+actionable item. Read-only; the orchestrator runs this before a queued batch.</purpose>
+<non-goals>
+  <item>Do not execute the queue — this command validates and previews only.</item>
+  <item>Do not mutate any files.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-1140: initial queue.validate handler.</item>
+  <item>RFC-1140: steps 1-4 — shared resolver, queue module, registration
+
+Extract pipeline-status derivation into packages/forge/src/pipeline-status.ts, refactor rfc.pipeline.status onto it, add os/queue module with queue.validate command, register in WORKSHOP_MODULE_MAP.forge + bin/cli.ts + package.json exports.</item>
+</CHANGE_SUMMARY>
+*/
+
+import type {
+  ForgeCommandInput,
+  ForgeCommandResult,
+  ForgeRuntimeContext,
+} from "../../../src/types.ts";
+import { deriveQueueReport } from "../../../src/pipeline-status.ts";
+import { loadQueueManifest } from "../manifest.ts";
+import type { QueueValidateResult } from "../types.ts";
+
+export async function runQueueValidate(
+  input: ForgeCommandInput,
+  context: ForgeRuntimeContext,
+): Promise<ForgeCommandResult<QueueValidateResult>> {
+  const { workspaceRoot, logger, outputFormat } = context;
+
+  const file = input.flags["file"] as string | undefined;
+  if (!file) {
+    throw new Error("queue.validate requires --file <path-to-manifest.yaml>");
+  }
+
+  const { manifest, errors, warnings } = await loadQueueManifest(workspaceRoot, file);
+
+  const report =
+    errors.length === 0
+      ? await deriveQueueReport(
+          workspaceRoot,
+          manifest.items.map((i) => i.id),
+        )
+      : { items: [], next: null };
+
+  const status = errors.length === 0 ? "pass" : "fail";
+
+  if (outputFormat === "pretty") {
+    logger.section(`Queue: ${manifest.id || file}`);
+    for (const item of report.items) {
+      const step = item.pipelineStep ? ` (${item.pipelineStep})` : "";
+      logger.info(`  ${item.id}: ${item.status}${step}`);
+    }
+    logger.info(`next: ${report.next ?? "—"}`);
+    for (const w of warnings) {
+      logger.warn(`  ${w.ruleId}: ${w.message}`);
+    }
+    for (const e of errors) {
+      logger.error(`  ${e.ruleId}: ${e.message}`);
+    }
+  }
+
+  return {
+    data: {
+      command: "queue.validate",
+      status,
+      queue: manifest.id,
+      file,
+      items: report.items,
+      next: report.next,
+      errors,
+      warnings,
+    },
+    summary:
+      status === "pass"
+        ? `Queue "${manifest.id}": ${report.items.length} item(s), next: ${report.next ?? "none"}`
+        : `Queue manifest invalid: ${errors.length} error(s)`,
+    exitCode: status === "pass" ? 0 : 1,
+  };
+}

package/os/queue/index.ts

@@ -0,0 +1,19 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Barrel export for the forge queue module (RFC-1140).</purpose>
+<non-goals>
+  <item>Do not add logic here — re-exports only.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-1140: initial barrel export.</item>
+  <item>RFC-1140: steps 1-4 — shared resolver, queue module, registration
+
+Extract pipeline-status derivation into packages/forge/src/pipeline-status.ts, refactor rfc.pipeline.status onto it, add os/queue module with queue.validate command, register in WORKSHOP_MODULE_MAP.forge + bin/cli.ts + package.json exports.</item>
+</CHANGE_SUMMARY>
+*/
+
+export { createForgeQueueModule } from "./queue.module.ts";
+export { loadQueueManifest } from "./manifest.ts";
+export { queueManifestSchema, QUEUE_ITEM_ID_PATTERN } from "./types.ts";
+export type { QueueManifest, QueueValidateResult } from "./types.ts";

package/os/queue/manifest.ts

@@ -0,0 +1,183 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Queue manifest loading and validation (RFC-1140) — YAML parse, zod
+schema, id↔filename stem check, item id pattern, document resolution across
+active and archive dirs, duplicate detection, and dependsOn order warnings.</purpose>
+<non-goals>
+  <item>Do not derive item status — that is src/pipeline-status.ts.</item>
+  <item>Do not mutate the manifest file.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-1140: initial manifest loader and validator.</item>
+  <item>RFC-1140: steps 1-4 — shared resolver, queue module, registration
+
+Extract pipeline-status derivation into packages/forge/src/pipeline-status.ts, refactor rfc.pipeline.status onto it, add os/queue module with queue.validate command, register in WORKSHOP_MODULE_MAP.forge + bin/cli.ts + package.json exports.</item>
+</CHANGE_SUMMARY>
+*/
+
+import fs from "node:fs/promises";
+import path from "node:path";
+import YAML from "yaml";
+
+import type { Diagnostic } from "../../src/types.ts";
+import { resolveDocument } from "../../src/pipeline-status.ts";
+import { QUEUE_ITEM_ID_PATTERN, queueManifestSchema } from "./types.ts";
+import type { QueueManifest } from "./types.ts";
+
+export interface LoadedQueueManifest {
+  manifest: QueueManifest;
+  errors: Diagnostic[];
+  warnings: Diagnostic[];
+}
+
+function diag(
+  ruleId: string,
+  severity: "error" | "warning",
+  message: string,
+  file?: string,
+): Diagnostic {
+  return { ruleId, severity, message, file };
+}
+
+/**
+ * Load and validate a queue manifest. Blocking errors: unreadable/invalid
+ * YAML, schema violations, id↔filename mismatch, malformed or unresolvable
+ * item ids, duplicates. Non-blocking: dependsOn order violations.
+ */
+export async function loadQueueManifest(
+  workspaceRoot: string,
+  filePath: string,
+): Promise<LoadedQueueManifest> {
+  const errors: Diagnostic[] = [];
+  const warnings: Diagnostic[] = [];
+  const absolutePath = path.isAbsolute(filePath)
+    ? filePath
+    : path.join(workspaceRoot, filePath);
+  const displayPath = path.isAbsolute(filePath)
+    ? path.relative(workspaceRoot, filePath)
+    : filePath;
+
+  let source: string;
+  try {
+    source = await fs.readFile(absolutePath, "utf-8");
+  } catch (e) {
+    errors.push(
+      diag(
+        "QUEUE-01",
+        "error",
+        `Cannot read queue manifest: ${e instanceof Error ? e.message : String(e)}`,
+        displayPath,
+      ),
+    );
+    return { manifest: { id: "", createdAt: "", items: [] }, errors, warnings };
+  }
+
+  let raw: unknown;
+  try {
+    raw = YAML.parse(source);
+  } catch (e) {
+    errors.push(
+      diag(
+        "QUEUE-01",
+        "error",
+        `YAML parse error: ${e instanceof Error ? e.message : String(e)}`,
+        displayPath,
+      ),
+    );
+    return { manifest: { id: "", createdAt: "", items: [] }, errors, warnings };
+  }
+
+  const parsed = queueManifestSchema.safeParse(raw);
+  if (!parsed.success) {
+    for (const issue of parsed.error.issues) {
+      errors.push(
+        diag(
+          "QUEUE-01",
+          "error",
+          `Manifest schema violation at ${issue.path.join(".") || "<root>"}: ${issue.message}`,
+          displayPath,
+        ),
+      );
+    }
+    return { manifest: { id: "", createdAt: "", items: [] }, errors, warnings };
+  }
+
+  const manifest = parsed.data;
+
+  // QUEUE-02: manifest id must equal the filename stem.
+  const stem = path.basename(absolutePath).replace(/\.(ya?ml)$/i, "");
+  if (manifest.id !== stem) {
+    errors.push(
+      diag(
+        "QUEUE-02",
+        "error",
+        `Manifest id "${manifest.id}" does not match filename stem "${stem}"`,
+        displayPath,
+      ),
+    );
+  }
+
+  // QUEUE-03/04/05: item id pattern, resolution, duplicates.
+  const seen = new Set<string>();
+  const resolvedDependsOn = new Map<string, string[]>();
+  for (const item of manifest.items) {
+    const id = item.id.trim();
+    if (!QUEUE_ITEM_ID_PATTERN.test(id)) {
+      errors.push(
+        diag("QUEUE-03", "error", `Item id "${item.id}" does not match ^(RFC|ADR)-\\d{4}$`, displayPath),
+      );
+      continue;
+    }
+    const upper = id.toUpperCase();
+    if (seen.has(upper)) {
+      errors.push(diag("QUEUE-05", "error", `Duplicate item id "${upper}"`, displayPath));
+      continue;
+    }
+    seen.add(upper);
+
+    const doc = await resolveDocument(workspaceRoot, upper);
+    if (!doc) {
+      errors.push(
+        diag(
+          "QUEUE-04",
+          "error",
+          `Item "${upper}" does not resolve to a document in docs/rfcs/ or docs/adrs/ (incl. archive)`,
+          displayPath,
+        ),
+      );
+      continue;
+    }
+
+    const dependsOn = doc.frontmatter["dependsOn"];
+    if (Array.isArray(dependsOn)) {
+      resolvedDependsOn.set(
+        upper,
+        dependsOn.map((d) => String(d).toUpperCase()),
+      );
+    }
+  }
+
+  // QUEUE-06: dependsOn order — an item must not precede its in-queue dependency.
+  const order = new Map<string, number>();
+  manifest.items.forEach((item, index) => order.set(item.id.trim().toUpperCase(), index));
+  for (const [itemId, deps] of resolvedDependsOn) {
+    const itemIndex = order.get(itemId);
+    if (itemIndex === undefined) continue;
+    for (const dep of deps) {
+      const depIndex = order.get(dep);
+      if (depIndex !== undefined && depIndex > itemIndex) {
+        warnings.push(
+          diag(
+            "QUEUE-06",
+            "warning",
+            `Item "${itemId}" (position ${itemIndex + 1}) precedes its dependsOn dependency "${dep}" (position ${depIndex + 1})`,
+            displayPath,
+          ),
+        );
+      }
+    }
+  }
+
+  return { manifest, errors, warnings };
+}