@open-agent-toolkit/cli 0.3.10 → 0.3.11

package/assets/skills/recon/scripts/render-packet.mjs

@@ -6,6 +6,12 @@ import { join, resolve } from 'node:path';
 
 import { hashFile } from './lib/canonical-json.mjs';
 import { isDirectExecution } from './lib/cli-entry.mjs';
+import {
+  affirmingDispositionByReviewKind,
+  classifyUnresolvedIssue,
+  requiredReviewKinds,
+  unresolvedIssuesBlockClaim,
+} from './lib/contracts.mjs';
 import {
   assertSafeExistingPath,
   assertSafeOutputPath,
@@ -99,7 +105,7 @@ function intendedRoutingSection(manifest, routing) {
     '',
     `- **Manifest routing version:** ${routing.sourceSchemaVersion}`,
     `- **Approved authority:** ${escapeInline(routing.authority)}`,
-    `- **Approved limits:** ${routing.waves.length} waves; ${routing.waves.reduce((count, wave) => count + wave.lanes.length, 0)} lanes; concurrency ${routing.maxConcurrency}; deadline ${routing.deadlineSeconds}s; retries ${routing.retryLimit}`,
+    `- **Approved limits:** ${routing.waves.length} waves; ${routing.waves.reduce((count, wave) => count + wave.lanes.length, 0)} lanes; concurrency ${routing.maxConcurrency}; deadline ${routing.deadlineSeconds}s; pre-acceptance admission retries per lane ${routing.retryLimit}`,
     '- **Evidence boundary:** These are normalized approved intended targets and root-recorded condition dispositions. They are not launcher receipts or observations of native runtime identity, usage, cost, or conclusion correctness.',
     '',
     '### Waves',
@@ -115,6 +121,88 @@ function intendedRoutingSection(manifest, routing) {
   ];
 }
 
+// The required reviews that gave `claimId` no disposition at all. Such a
+// claim stays below `verified`, like an uncertain one, and is listed as not
+// reviewed.
+function omittedReviews(claimId, reviews) {
+  return requiredReviewKinds
+    .map((kind) => reviews.find((review) => review.reviewKind === kind))
+    .filter(
+      (review) =>
+        review &&
+        !(review.dispositions ?? []).some((item) => item.claimId === claimId),
+    );
+}
+
+function issueText(entry) {
+  return typeof entry === 'string' ? entry : (entry?.text ?? '');
+}
+
+// Every claim an incorporated review kept below `verified` (an unresolved
+// issue that applies to it, a coverage finding that names it, a
+// non-affirming disposition, or a required review that left it without a
+// disposition), with the review's own words. Key-claim status
+// alone would let a `complete` packet hide a downgraded non-key claim.
+function reviewDowngradeLines(validatedRun) {
+  const { ledger, artifacts, assuranceReviewIds } = validatedRun;
+  const assurance = new Set(assuranceReviewIds);
+  const reviews = artifacts
+    .map(({ value }) => value)
+    .filter(
+      (value) =>
+        value.kind === 'recon.review-result' && assurance.has(value.id),
+    );
+  const lines = [];
+  for (const claim of ledger.claims) {
+    if (claim.status === 'verified') continue;
+    const reasons = [];
+    for (const review of reviews) {
+      const disposition = (review.dispositions ?? []).find(
+        (item) => item.claimId === claim.id,
+      );
+      if (!disposition) continue;
+      if (
+        disposition.disposition !==
+        affirmingDispositionByReviewKind[review.reviewKind]
+      ) {
+        reasons.push(`${review.reviewKind} review: ${disposition.disposition}`);
+      }
+      if (unresolvedIssuesBlockClaim(review, claim.id)) {
+        for (const entry of review.unresolvedIssues) {
+          const classification = classifyUnresolvedIssue(entry);
+          if (
+            classification.scope === 'claims' &&
+            !classification.claimIds.includes(claim.id)
+          ) {
+            continue;
+          }
+          const scope =
+            classification.scope === 'claims' ? 'issue' : 'global issue';
+          reasons.push(`${review.reviewKind} ${scope}: ${issueText(entry)}`);
+        }
+      }
+    }
+    for (const review of omittedReviews(claim.id, reviews)) {
+      reasons.push(
+        `${review.reviewKind} review: not reviewed (no disposition)`,
+      );
+    }
+    for (const review of reviews) {
+      for (const finding of review.coverageFindings ?? []) {
+        if (!finding.claimIds.includes(claim.id)) continue;
+        reasons.push(
+          `${finding.material ? 'material ' : ''}coverage finding ${finding.code}: ${finding.message}`,
+        );
+      }
+    }
+    if (reasons.length === 0) continue;
+    lines.push(
+      `**${escapeInline(claim.id)}** (${escapeInline(claim.status)}): ${escapeInline(claim.statement)} — ${reasons.map(escapeInline).join('; ')}`,
+    );
+  }
+  return lines;
+}
+
 export function renderPacketDocument(validatedRun) {
   const { manifest, ledger, routing } = assertValidatedRun(validatedRun);
   const evidenceById = new Map(
@@ -186,6 +274,10 @@ export function renderPacketDocument(validatedRun) {
       ),
     ),
     '',
+    '## Review Downgrades',
+    '',
+    ...bulletLines(reviewDowngradeLines(validatedRun)),
+    '',
     '## Unresolved Questions',
     '',
     ...bulletLines(

package/assets/skills/recon/scripts/validate-packet.mjs

@@ -3,15 +3,20 @@
 import { readFile, rm } from 'node:fs/promises';
 import { join, resolve } from 'node:path';
 
+import { createReviewBrief } from './create-review-brief.mjs';
 import { hashCanonicalJson, hashFile, sha256 } from './lib/canonical-json.mjs';
 import { isDirectExecution } from './lib/cli-entry.mjs';
 import {
+  affirmingDispositionByReviewKind,
   isDigest,
   isObject,
   issue,
   profiles,
+  requiredReviewKinds,
+  unresolvedIssuesBlockClaim,
   validateArtifactShape,
 } from './lib/contracts.mjs';
+import { reviewBriefEntries } from './lib/review-binding.mjs';
 import { normalizeManifestRouting } from './lib/routing.mjs';
 import {
   assertCanonicalRoot,
@@ -1318,44 +1323,69 @@ function resolveTerminalReconciliation(
   };
 }
 
-function reviewBriefBindsClaim(brief, reviewKind, claim, ledger, manifest) {
-  const projected =
-    reviewKind === 'semantic' || reviewKind === 'redundant-verification'
-      ? brief?.claims?.find((item) => item.id === claim.id)
-      : reviewKind === 'adversarial' ||
-          reviewKind === 'contradiction-resolution'
-        ? brief?.provisionalStatements?.find((item) => item.id === claim.id)
-        : brief?.claims?.find((item) => item.id === claim.id);
-  if (!projected || projected.statement !== claim.statement) return false;
-  if (reviewKind !== 'semantic' && reviewKind !== 'redundant-verification') {
-    return Object.keys(projected).sort().join(',') === 'id,statement';
-  }
-  const evidenceById = new Map(ledger.evidence.map((item) => [item.id, item]));
-  const expectedEvidence = claim.evidence.map((link) => {
-    const evidence = evidenceById.get(link.evidenceId);
-    return evidence
-      ? {
-          id: evidence.id,
-          sourceId: evidence.sourceId,
-          displayExcerpt: evidence.displayExcerpt,
-          locator: evidence.locator,
-        }
-      : null;
-  });
-  if (
-    expectedEvidence.some((item) => !item) ||
-    hashCanonicalJson(projected.evidence) !==
-      hashCanonicalJson(expectedEvidence)
-  ) {
-    return false;
-  }
-  const sourceIds = new Set(expectedEvidence.map((item) => item.sourceId));
-  const expectedSources = manifest.sources.filter((source) =>
-    sourceIds.has(source.id),
-  );
-  return (
-    hashCanonicalJson(brief.sources) === hashCanonicalJson(expectedSources)
+// Brief integrity is one check: rebuild the brief with the production
+// generator from the prior ledger and the manifest, for the claim IDs it
+// lists, and require identical canonical JSON. Any edited, injected,
+// duplicated, or unprojected field differs, so no field-by-field binding is
+// needed. Briefs stay blind because the generator is the only projection.
+function checkReviewBrief(
+  brief,
+  reviewKind,
+  { manifest, ledger, rebuildReviewBrief = createReviewBrief },
+) {
+  const entryIds = reviewBriefEntries(brief, reviewKind).map(
+    (entry) => entry?.id,
   );
+  let rebuilt;
+  try {
+    rebuilt = rebuildReviewBrief({
+      id: brief.id,
+      mode: brief.mode,
+      createdAt: brief.createdAt,
+      manifest,
+      ledger,
+      claimIds: entryIds,
+    });
+  } catch (error) {
+    return {
+      ok: false,
+      entryIds,
+      reason: `rebuild failed: ${error instanceof Error ? error.message : error}`,
+    };
+  }
+  if (hashCanonicalJson(rebuilt) === hashCanonicalJson(brief)) {
+    return { ok: true, entryIds };
+  }
+  const keys = [...new Set([...Object.keys(brief), ...Object.keys(rebuilt)])]
+    .sort()
+    .filter(
+      (key) =>
+        !Object.hasOwn(brief, key) ||
+        !Object.hasOwn(rebuilt, key) ||
+        hashCanonicalJson(brief[key]) !== hashCanonicalJson(rebuilt[key]),
+    );
+  return { ok: false, entryIds, reason: `differs at ${keys[0]}` };
+}
+
+// One rebuild per distinct brief per validation pass. The key is the exact
+// artifact reference (path and digest) plus the review kind that selects the
+// brief's entries; the cache lives only as long as this pass's checker.
+function createBriefChecker({ manifest, ledger, rebuildReviewBrief }) {
+  const results = new Map();
+  return (briefEntry, reviewKind) => {
+    const key = `${briefEntry.reference?.path}\u0000${briefEntry.reference?.digest}\u0000${reviewKind}`;
+    if (!results.has(key)) {
+      results.set(
+        key,
+        checkReviewBrief(briefEntry.value, reviewKind, {
+          manifest,
+          ledger,
+          rebuildReviewBrief,
+        }),
+      );
+    }
+    return results.get(key);
+  };
 }
 
 function validateReviewBindings(
@@ -1365,6 +1395,7 @@ function validateReviewBindings(
   artifactsByPath,
   reconciliationContext,
   errors,
+  checkBrief,
 ) {
   const claims = new Map(ledger.claims.map((claim) => [claim.id, claim]));
   const priorLedger = reconciliationContext.priorLedger;
@@ -1378,11 +1409,12 @@ function validateReviewBindings(
     ) {
       continue;
     }
-    const brief = [...artifactsByPath.values()].find(
+    const briefEntry = [...artifactsByPath.values()].find(
       ({ reference, value }) =>
         sameReference(reference, result.brief) &&
         value.kind === 'recon.review-brief',
-    )?.value;
+    );
+    const brief = briefEntry?.value;
     const expectedMode =
       result.reviewKind === 'semantic' ||
       result.reviewKind === 'redundant-verification'
@@ -1401,27 +1433,26 @@ function validateReviewBindings(
       );
       continue;
     }
+    const check = checkBrief(briefEntry, result.reviewKind);
+    if (!check.ok) {
+      errors.push(
+        issue(
+          'REVIEW_BRIEF_MISMATCH',
+          `Review ${result.id} brief is not the production brief rebuilt from the prior ledger and manifest (${check.reason})`,
+          result.id,
+        ),
+      );
+    }
     const seen = new Set();
     for (const disposition of result.dispositions) {
-      const currentClaim = claims.get(disposition.claimId);
-      const priorClaim = priorClaims.get(disposition.claimId);
-      const claim = priorClaim ?? currentClaim;
-      const bindingLedger = priorClaim ? priorLedger : ledger;
       if (
-        !claim ||
         seen.has(disposition.claimId) ||
-        !reviewBriefBindsClaim(
-          brief,
-          result.reviewKind,
-          claim,
-          bindingLedger,
-          manifest,
-        )
+        !check.entryIds.includes(disposition.claimId)
       ) {
         errors.push(
           issue(
             'REVIEW_BRIEF_MISMATCH',
-            `Review ${result.id} dispositions must exactly match claim-bearing brief projections`,
+            `Review ${result.id} dispositions must be unique members of its brief's claims`,
             result.id,
           ),
         );
@@ -1869,16 +1900,13 @@ function validateReconciliation(
         );
       }
       if (disposition?.disposition === 'accepted-gap') {
+        // A material finding forces every named claim below `verified`, the
+        // same downgrade the reconciler applies. The reviewer's per-statement
+        // disposition may stay `covered`: a question omission is not a
+        // statement defect.
         for (const claimId of finding.claimIds) {
           const claim = currentClaims.get(claimId);
-          const coverageDisposition = coverage.dispositions.find(
-            (item) => item.claimId === claimId,
-          );
-          if (
-            finding.material === true &&
-            (claim?.status === 'verified' ||
-              coverageDisposition?.disposition !== 'gap')
-          ) {
+          if (finding.material === true && claim?.status === 'verified') {
             errors.push(
               issue(
                 'MATERIAL_COVERAGE_ASSURANCE_EXCEEDED',
@@ -1969,7 +1997,7 @@ function validateDerivedSourceGaps(manifest, ledger, errors) {
   }
 }
 
-function validateAssurance(validatedRun, errors) {
+function validateAssurance(validatedRun, errors, checkBrief) {
   const { manifest, ledger, achievedProfile } = validatedRun;
   const exactEvidence = new Set(validatedRun.exactEvidenceIds);
   const assuranceReviewIds = new Set(validatedRun.assuranceReviewIds);
@@ -1979,9 +2007,6 @@ function validateAssurance(validatedRun, errors) {
   const evidenceById = new Map(
     (ledger.evidence ?? []).map((item) => [item.id, item]),
   );
-  const priorClaims = new Map(
-    (validatedRun.priorLedger?.claims ?? []).map((claim) => [claim.id, claim]),
-  );
   const claimIds = new Set((ledger.claims ?? []).map((claim) => claim.id));
   for (const claimId of ledger.synthesis?.keyClaimIds ?? []) {
     if (!claimIds.has(claimId)) {
@@ -2056,14 +2081,12 @@ function validateAssurance(validatedRun, errors) {
           ),
         );
       }
-      const required = new Map([
-        ['semantic', 'affirmed'],
-        ['adversarial', 'unchallenged'],
-        ['coverage', 'covered'],
-      ]);
-      if (achievedProfile === 'thorough') {
-        required.set('redundant-verification', 'affirmed');
-      }
+      const required = new Map(
+        [
+          ...requiredReviewKinds,
+          ...(achievedProfile === 'thorough' ? ['redundant-verification'] : []),
+        ].map((kind) => [kind, affirmingDispositionByReviewKind[kind]]),
+      );
       const satisfied = new Set();
       const reviewerLanes = new Set();
       for (const reviewId of new Set(claim.reviewIds ?? [])) {
@@ -2128,11 +2151,12 @@ function validateAssurance(validatedRun, errors) {
           );
         }
         reviewerLanes.add(artifact.reviewerLane);
-        const brief = [...artifactsById.values()].find(
+        const briefEntry = [...artifactsById.values()].find(
           ({ reference, value }) =>
             sameReference(reference, artifact.brief) &&
             value.kind === 'recon.review-brief',
-        )?.value;
+        );
+        const brief = briefEntry?.value;
         const expectedMode =
           artifact.reviewKind === 'semantic' ||
           artifact.reviewKind === 'redundant-verification'
@@ -2141,17 +2165,15 @@ function validateAssurance(validatedRun, errors) {
                 artifact.reviewKind === 'contradiction-resolution'
               ? 'adversary'
               : 'coverage';
+        const briefCheck = brief
+          ? checkBrief(briefEntry, artifact.reviewKind)
+          : null;
         if (
           !brief ||
           brief.runId !== ledger.runId ||
           brief.mode !== expectedMode ||
-          !reviewBriefBindsClaim(
-            brief,
-            artifact.reviewKind,
-            priorClaims.get(claim.id) ?? claim,
-            priorClaims.has(claim.id) ? validatedRun.priorLedger : ledger,
-            manifest,
-          ) ||
+          !briefCheck.ok ||
+          !briefCheck.entryIds.includes(claim.id) ||
           !artifact.permittedInputs?.some((reference) =>
             sameReference(reference, artifact.brief),
           )
@@ -2168,9 +2190,7 @@ function validateAssurance(validatedRun, errors) {
           (item) => item.claimId === claim.id,
         );
         const expectedDisposition =
-          artifact.reviewKind === 'contradiction-resolution'
-            ? 'resolved'
-            : required.get(artifact.reviewKind);
+          affirmingDispositionByReviewKind[artifact.reviewKind];
         if (
           dispositions.length !== 1 ||
           dispositions[0].disposition !== expectedDisposition
@@ -2183,11 +2203,11 @@ function validateAssurance(validatedRun, errors) {
             ),
           );
         }
-        if ((artifact.unresolvedIssues ?? []).length > 0) {
+        if (unresolvedIssuesBlockClaim(artifact, claim.id)) {
           errors.push(
             issue(
               'REVIEW_DISPOSITION_MISMATCH',
-              `Review ${reviewId} retains unresolved issues`,
+              `Review ${reviewId} retains an unresolved issue that applies to this claim`,
               claim.id,
             ),
           );
@@ -2280,7 +2300,12 @@ function validateAssurance(validatedRun, errors) {
   }
 }
 
-export async function compileValidatedRun(packetDirectory) {
+// `rebuildReviewBrief` is a test seam for counting brief rebuilds; production
+// callers use the default generator.
+export async function compileValidatedRun(
+  packetDirectory,
+  { rebuildReviewBrief = createReviewBrief } = {},
+) {
   const packetRoot = resolve(packetDirectory);
   const errors = [];
   const warnings = [];
@@ -2532,6 +2557,11 @@ export async function compileValidatedRun(packetDirectory) {
         errors,
       );
     }
+    const checkBrief = createBriefChecker({
+      manifest,
+      ledger: reconciliationContext.priorLedger ?? ledger,
+      rebuildReviewBrief,
+    });
     validateReviewBindings(
       manifest,
       ledger,
@@ -2539,6 +2569,7 @@ export async function compileValidatedRun(packetDirectory) {
       artifactsByPath,
       reconciliationContext,
       errors,
+      checkBrief,
     );
     validateReconciliation(
       manifest,
@@ -2586,7 +2617,7 @@ export async function compileValidatedRun(packetDirectory) {
         assuranceReviewIds,
         reconciliationContext,
       });
-      validateAssurance(validatedRun, errors);
+      validateAssurance(validatedRun, errors, checkBrief);
     }
 
     const valid = errors.length === 0;

package/assets/templates/state.md

@@ -54,6 +54,7 @@ oat_workflow_origin: native # native | imported
 #   implementation_fingerprint: null # new generations use sha256:effective-delta-v2:<digest>; stored v1 values keep v1 semantics
 #   freshness_head: null # rolling accepted tree checkpoint
 #   freshness_fingerprint: null # full effective delta at freshness_head
+#   waivers: [] # append-only operator waivers {waived_by, reason, from_commit, to_commit, covered_fingerprint, waived_at}; never self-issued, never under OAT_AUTONOMOUS=1
 #   launch_state: not_started # not_started | intent_persisted | accepted | result_persisted | not_accepted
 #   launch_attempt_id: null
 #   launch_started_at: null

package/dist/commands/backlog/new.d.ts

@@ -1,4 +1,4 @@
-import { type PjmTemplateTier } from '../pjm/template-source.js';
+import { type TemplateTier } from '../shared/template-source.js';
 import { initializeBacklog } from './init.js';
 import { regenerateBacklogIndex, type RegenerateBacklogIndexResult } from './regenerate-index.js';
 export interface CreateBacklogItemOptions {
@@ -20,7 +20,7 @@ export interface CreateBacklogItemResult {
     backlogRoot: string;
     filePath: string;
     templatePath: string;
-    templateTier: PjmTemplateTier;
+    templateTier: TemplateTier;
     index: RegenerateBacklogIndexResult;
 }
 export interface CreateBacklogItemDependencies {

package/dist/commands/backlog/new.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"new.d.ts","sourceRoot":"","sources":["../../../src/commands/backlog/new.ts"],"names":[],"mappings":"AAQA,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,+BAA+B,CAAC;AAIvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAC3C,OAAO,EACL,sBAAsB,EACtB,KAAK,4BAA4B,EAClC,MAAM,oBAAoB,CAAC;AAS5B,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,eAAe,CAAC;IAC9B,KAAK,EAAE,4BAA4B,CAAC;CACrC;AAED,MAAM,WAAW,6BAA6B;IAC5C,iBAAiB,EAAE,OAAO,iBAAiB,CAAC;IAC5C,sBAAsB,EAAE,OAAO,sBAAsB,CAAC;CACvD;AAgKD,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,wBAAwB,EACjC,SAAS,GAAE,OAAO,CAAC,6BAA6B,CAAM,GACrD,OAAO,CAAC,uBAAuB,CAAC,CAwDlC"}
+{"version":3,"file":"new.d.ts","sourceRoot":"","sources":["../../../src/commands/backlog/new.ts"],"names":[],"mappings":"AASA,OAAO,EAEL,KAAK,YAAY,EAClB,MAAM,kCAAkC,CAAC;AAG1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAC3C,OAAO,EACL,sBAAsB,EACtB,KAAK,4BAA4B,EAClC,MAAM,oBAAoB,CAAC;AAS5B,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,YAAY,CAAC;IAC3B,KAAK,EAAE,4BAA4B,CAAC;CACrC;AAED,MAAM,WAAW,6BAA6B;IAC5C,iBAAiB,EAAE,OAAO,iBAAiB,CAAC;IAC5C,sBAAsB,EAAE,OAAO,sBAAsB,CAAC;CACvD;AAgKD,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,wBAAwB,EACjC,SAAS,GAAE,OAAO,CAAC,6BAA6B,CAAM,GACrD,OAAO,CAAC,uBAAuB,CAAC,CAwDlC"}

package/dist/commands/backlog/new.js

@@ -1,8 +1,8 @@
 import { access, readFile, rm, writeFile } from 'node:fs/promises';
 import { join } from 'node:path';
 import { parseAssociatedIssues, serializeAssociatedIssues, } from '../pjm/remote/association.js';
-import { resolvePjmTemplate, } from '../pjm/template-source.js';
 import { stripTemplateFrontmatter } from '../shared/strip-template-frontmatter.js';
+import { resolveTemplate, } from '../shared/template-source.js';
 import YAML from 'yaml';
 import { initializeBacklog } from './init.js';
 import { regenerateBacklogIndex, } from './regenerate-index.js';
@@ -106,7 +106,7 @@ export async function createBacklogItem(options, overrides = {}) {
     if ((await pathExists(filePath)) || (await pathExists(archivedPath))) {
         throw new Error(`Backlog item ${id} already exists. Use a more specific title to disambiguate.`);
     }
-    const template = await resolvePjmTemplate({
+    const template = await resolveTemplate({
         name: 'backlog-item.md',
         assetsRoot: options.assetsRoot,
         templatesRoot: options.templatesRoot,

package/dist/commands/decision/new.d.ts

@@ -1,4 +1,4 @@
-import { type PjmTemplateTier } from '../pjm/template-source.js';
+import { type TemplateTier } from '../shared/template-source.js';
 export interface CreateDecisionRecordOptions {
     decisionsRoot: string;
     assetsRoot: string;
@@ -16,7 +16,7 @@ export interface CreateDecisionRecordResult {
     decisionsRoot: string;
     filePath: string;
     templatePath: string;
-    templateTier: PjmTemplateTier;
+    templateTier: TemplateTier;
 }
 export declare function createDecisionRecord(options: CreateDecisionRecordOptions): Promise<CreateDecisionRecordResult>;
 //# sourceMappingURL=new.d.ts.map

package/dist/commands/decision/new.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"new.d.ts","sourceRoot":"","sources":["../../../src/commands/decision/new.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,+BAA+B,CAAC;AAUvC,MAAM,WAAW,2BAA2B;IAC1C,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,0BAA0B;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,eAAe,CAAC;CAC/B;AAkFD,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,0BAA0B,CAAC,CAoDrC"}
+{"version":3,"file":"new.d.ts","sourceRoot":"","sources":["../../../src/commands/decision/new.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,KAAK,YAAY,EAClB,MAAM,kCAAkC,CAAC;AAS1C,MAAM,WAAW,2BAA2B;IAC1C,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,0BAA0B;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,YAAY,CAAC;CAC5B;AAkFD,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,0BAA0B,CAAC,CAoDrC"}

package/dist/commands/decision/new.js

@@ -1,7 +1,7 @@
 import { access, mkdir, rm, writeFile } from 'node:fs/promises';
 import { dirname, join } from 'node:path';
-import { resolvePjmTemplate, } from '../pjm/template-source.js';
 import { stripTemplateFrontmatter } from '../shared/strip-template-frontmatter.js';
+import { resolveTemplate, } from '../shared/template-source.js';
 import YAML from 'yaml';
 import { assertDecisionIndexScaffold, regenerateDecisionIndex, } from './regenerate-index.js';
 import { generateDecisionId } from './shared/generate-id.js';
@@ -62,7 +62,7 @@ export async function createDecisionRecord(options) {
     if (await pathExists(filePath)) {
         throw new Error(`Decision record ${id} already exists. Use a more specific title to disambiguate.`);
     }
-    const template = await resolvePjmTemplate({
+    const template = await resolveTemplate({
         name: 'decision.md',
         assetsRoot: options.assetsRoot,
         templatesRoot: options.templatesRoot,

package/dist/commands/docs/nav/contents.d.ts

@@ -9,6 +9,15 @@ interface BuildDocsNavTreeOptions {
     dirRelativePath?: string;
     visitedDirectories?: Set<string>;
 }
+export declare function resolveEntryTarget(docsRoot: string, directoryPath: string, dirRelativePath: string, entry: DocsContentsEntry, 
+/**
+ * Page extensions a Contents link may target. MkDocs renders only `.md`;
+ * Fumadocs also renders `.mdx` pages.
+ */
+pageExtensions?: readonly string[]): Promise<{
+    kind: 'page' | 'section';
+    path: string;
+}>;
 export declare function buildDocsNavTree(options: BuildDocsNavTreeOptions): Promise<DocsNavTree>;
 export {};
 //# sourceMappingURL=contents.d.ts.map

package/dist/commands/docs/nav/contents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contents.d.ts","sourceRoot":"","sources":["../../../../src/commands/docs/nav/contents.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,UAAU,SAAa,GACtB,iBAAiB,EAAE,CAqCrB;AAED,MAAM,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC;AAE/E,UAAU,uBAAuB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kBAAkB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAClC;AAgFD,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,WAAW,CAAC,CA8DtB"}
+{"version":3,"file":"contents.d.ts","sourceRoot":"","sources":["../../../../src/commands/docs/nav/contents.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,UAAU,SAAa,GACtB,iBAAiB,EAAE,CAqCrB;AAED,MAAM,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC;AAE/E,UAAU,uBAAuB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kBAAkB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAClC;AAMD,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EACrB,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE,iBAAiB;AACxB;;;GAGG;AACH,cAAc,GAAE,SAAS,MAAM,EAAY,GAC1C,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAmErD;AAED,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,WAAW,CAAC,CA8DtB"}

package/dist/commands/docs/nav/contents.js

@@ -30,7 +30,12 @@ export function parseIndexContents(markdown, sourcePath = 'index.md') {
 function toPosixPath(path) {
     return path.replaceAll('\\', '/');
 }
-async function resolveEntryTarget(docsRoot, directoryPath, dirRelativePath, entry) {
+export async function resolveEntryTarget(docsRoot, directoryPath, dirRelativePath, entry, 
+/**
+ * Page extensions a Contents link may target. MkDocs renders only `.md`;
+ * Fumadocs also renders `.mdx` pages.
+ */
+pageExtensions = ['.md']) {
     const href = entry.href.split('#', 1)[0]?.trim() ?? '';
     if (!href) {
         throw new Error(`Invalid contents link "${entry.href}" in ${join(docsRoot, dirRelativePath, 'index.md')}`);
@@ -51,7 +56,7 @@ async function resolveEntryTarget(docsRoot, directoryPath, dirRelativePath, entr
     if (!(await fileExists(targetPath))) {
         throw new Error(`Contents link "${entry.href}" in ${join(docsRoot, dirRelativePath, 'index.md')} does not resolve to a Markdown file`);
     }
-    if (extname(targetPath) !== '.md') {
+    if (!pageExtensions.includes(extname(targetPath))) {
         throw new Error(`Contents link "${entry.href}" in ${join(docsRoot, dirRelativePath, 'index.md')} must point to a Markdown file or directory index`);
     }
     if (basename(targetPath) === 'index.md') {

package/dist/commands/docs/nav/fumadocs.d.ts

@@ -0,0 +1,51 @@
+/**
+ * The `meta.json` keys nav sync owns. Every other key (`icon`, `defaultOpen`,
+ * `description`, ...) is left as the author wrote it.
+ */
+export interface FumadocsMeta {
+    title?: string;
+    pages: string[];
+}
+export interface FumadocsMetaFile {
+    /** Docs-relative POSIX path of the `meta.json` file. */
+    path: string;
+    meta: FumadocsMeta;
+    changed: boolean;
+}
+export interface SyncFumadocsNavigationResult {
+    metaFiles: FumadocsMetaFile[];
+    /** Docs-relative paths of the `meta.json` files this run wrote. */
+    written: string[];
+    /**
+     * Docs-relative paths of the `meta.json` files that were missing or differed
+     * by meaning before this run. Equal to `written` unless `check` was set.
+     */
+    stale: string[];
+    /**
+     * Docs-relative paths no Contents map places in the page tree. A folder is
+     * reported once as `folder/` instead of once per page inside it.
+     */
+    unlisted: string[];
+}
+/**
+ * Reduce a Markdown heading to the plain text a sidebar shows: images and
+ * links keep their text, code spans keep their content, and emphasis and
+ * strikethrough markers are dropped.
+ */
+export declare function stripInlineMarkdown(text: string): string;
+/** Folder title: frontmatter `title`, else the first H1 outside code fences. */
+export declare function resolveFolderTitle(markdown: string): string | undefined;
+/**
+ * Write one strict `meta.json` per docs directory that has an index.md,
+ * derived from that index's Contents map, and report every page the
+ * resulting page tree leaves out.
+ *
+ * Existing files are compared by meaning (parsed and deep-equal), so a run
+ * with no doc changes writes nothing even after a formatter rewrites them.
+ */
+export declare function syncFumadocsNavigation(options: {
+    docsRoot: string;
+    /** Compute and compare only; never write. */
+    check?: boolean;
+}): Promise<SyncFumadocsNavigationResult>;
+//# sourceMappingURL=fumadocs.d.ts.map