archctx 0.9.4 → 0.10.0

package/bin/archctx.mjs

@@ -1961,6 +1961,450 @@ var init_projection = __esm(() => {
   ISO_INSTANT = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{1,3})?Z$/;
 });
 
+// packages/contracts/src/projection-manifest.ts
+function isRuntimeTopologyTargetType(type) {
+  return typeof type === "string" && RUNTIME_TOPOLOGY_TARGET_TYPES.includes(type);
+}
+function architectureDocsProjectionManifestIssues(value) {
+  const issues = [];
+  const manifest = record2(value);
+  if (!manifest)
+    return ["manifest must be an object"];
+  issues.push(...exactKeys(manifest, ["schemaVersion", "rendererVersion", "profile", "layoutVersion", "generatedFrom", "semanticBaseline", "targets"], ["minimumRendererVersion", "minimumProtocolVersion"], "manifest"));
+  if (manifest.schemaVersion !== ARCHITECTURE_DOCS_PROJECTION_MANIFEST_SCHEMA_VERSION)
+    issues.push("manifest.schemaVersion is unsupported");
+  if (!isNonEmptyString(manifest.rendererVersion))
+    issues.push("manifest.rendererVersion must be a non-empty string");
+  for (const [key, family] of [["minimumRendererVersion", "archcontext.docs-renderer/v"], ["minimumProtocolVersion", "archcontext.projection-request/v"]]) {
+    if (Object.hasOwn(manifest, key) && versionNumber(manifest[key], family) === undefined)
+      issues.push(`manifest.${key} must name a supported version family`);
+  }
+  if (!ARCHITECTURE_DOCS_PROJECTION_PROFILES.includes(manifest.profile))
+    issues.push("manifest.profile is unsupported");
+  if (manifest.layoutVersion !== ARCHITECTURE_DOCS_LAYOUT_VERSION_V1)
+    issues.push("manifest.layoutVersion is unsupported");
+  issues.push(...generatedFromIssues(manifest.generatedFrom, "manifest.generatedFrom"));
+  const baseline = record2(manifest.semanticBaseline);
+  if (!baseline)
+    issues.push("manifest.semanticBaseline must be an object");
+  else {
+    issues.push(...exactKeys(baseline, ["modelDigest", "capabilities"], [], "manifest.semanticBaseline"));
+    if (!isDigest(baseline.modelDigest))
+      issues.push("manifest.semanticBaseline.modelDigest must be a SHA-256 digest");
+    issues.push(...capabilityEntriesIssues(baseline.capabilities, "manifest.semanticBaseline.capabilities", true));
+  }
+  const targets = record2(manifest.targets);
+  if (!targets) {
+    issues.push("manifest.targets must be an object keyed by targetId");
+    return issues;
+  }
+  const paths = new Set;
+  const stampOwners = new Map;
+  let topologyStamps;
+  for (const [targetId, row] of Object.entries(targets)) {
+    const prefix = `manifest.targets[${JSON.stringify(targetId)}]`;
+    if (!isNonEmptyString(targetId))
+      issues.push("manifest.targets keys must be non-empty targetIds");
+    issues.push(...manifestTargetIssues(row, prefix));
+    const path = record2(row)?.path;
+    if (typeof path === "string") {
+      if (paths.has(path))
+        issues.push(`${prefix}.path is recorded by another target`);
+      paths.add(path);
+    }
+    const stamps = record2(record2(row)?.sourceStamps) ?? {};
+    if (isRuntimeTopologyTargetType(record2(row)?.type)) {
+      const serialized = JSON.stringify(Object.keys(stamps).sort(compareStrings).map((nodeId) => [nodeId, stamps[nodeId]]));
+      if (topologyStamps === undefined)
+        topologyStamps = { targetId, stamps: serialized };
+      else if (topologyStamps.stamps !== serialized)
+        issues.push(`${prefix}.sourceStamps must equal the sourceStamps of ${topologyStamps.targetId}`);
+      for (const nodeId of Object.keys(stamps)) {
+        const owner = stampOwners.get(nodeId);
+        if (owner !== undefined && !isRuntimeTopologyTargetType(record2(targets[owner])?.type))
+          issues.push(`${prefix}.sourceStamps.${nodeId} is already stamped on ${owner}`);
+        else if (owner === undefined)
+          stampOwners.set(nodeId, targetId);
+      }
+      continue;
+    }
+    for (const nodeId of Object.keys(stamps)) {
+      const owner = stampOwners.get(nodeId);
+      if (owner !== undefined)
+        issues.push(`${prefix}.sourceStamps.${nodeId} is already stamped on ${owner}`);
+      else
+        stampOwners.set(nodeId, targetId);
+    }
+  }
+  return issues;
+}
+function architectureDocsProjectionManifestSchemaVersion(body) {
+  let parsed;
+  try {
+    parsed = JSON.parse(body);
+  } catch {
+    return;
+  }
+  const schemaVersion = record2(parsed)?.schemaVersion;
+  return typeof schemaVersion === "string" ? schemaVersion : undefined;
+}
+function isSupersededArchitectureDocsProjectionManifestSchemaVersion(schemaVersion) {
+  return SUPERSEDED_ARCHITECTURE_DOCS_PROJECTION_MANIFEST_SCHEMA_VERSIONS.includes(schemaVersion);
+}
+function serializeArchitectureDocsProjectionManifest(manifest) {
+  const capabilities = [...manifest.semanticBaseline.capabilities].sort((left, right) => compareStrings(left.capabilityId, right.capabilityId)).map(canonicalCapability);
+  const capabilityBlock = JSON.stringify(capabilities, null, 2).split(`
+`).map((line, index) => index === 0 ? line : `    ${line}`).join(`
+`);
+  const targetIds = Object.keys(manifest.targets).sort(compareStrings);
+  const targetLines = targetIds.length === 0 ? ['  "targets": {}'] : [
+    '  "targets": {',
+    ...targetIds.flatMap((targetId, index) => [
+      `    ${JSON.stringify(targetId)}:`,
+      `      ${JSON.stringify(canonicalTargetRow(manifest.targets[targetId]))}${index === targetIds.length - 1 ? "" : ","}`
+    ]),
+    "  }"
+  ];
+  return [
+    "{",
+    `  "schemaVersion": ${JSON.stringify(manifest.schemaVersion)},`,
+    `  "rendererVersion": ${JSON.stringify(manifest.rendererVersion)},`,
+    ...manifest.minimumRendererVersion === undefined ? [] : [`  "minimumRendererVersion": ${JSON.stringify(manifest.minimumRendererVersion)},`],
+    ...manifest.minimumProtocolVersion === undefined ? [] : [`  "minimumProtocolVersion": ${JSON.stringify(manifest.minimumProtocolVersion)},`],
+    `  "profile": ${JSON.stringify(manifest.profile)},`,
+    `  "layoutVersion": ${JSON.stringify(manifest.layoutVersion)},`,
+    `  "generatedFrom": ${JSON.stringify({ codeGraphPackage: manifest.generatedFrom.codeGraphPackage, codeGraphVersion: manifest.generatedFrom.codeGraphVersion })},`,
+    '  "semanticBaseline": {',
+    `    "modelDigest": ${JSON.stringify(manifest.semanticBaseline.modelDigest)},`,
+    `    "capabilities": ${capabilityBlock}`,
+    "  },",
+    ...targetLines,
+    "}",
+    ""
+  ].join(`
+`);
+}
+function architectureDocsProjectionManifestSemanticState(manifest) {
+  return architectureSemanticStateFromCapabilities(manifest.semanticBaseline.capabilities.map(({ selectorEvidenceDigest: _selectorEvidenceDigest, ...capability }) => capability));
+}
+function architectureSemanticStateFromCapabilities(capabilities) {
+  const sorted = [...capabilities].sort((left, right) => compareStrings(left.capabilityId, right.capabilityId));
+  return {
+    schemaVersion: ARCHITECTURE_SEMANTIC_STATE_SCHEMA_VERSION,
+    capabilities: sorted,
+    semanticFingerprint: digestJson(sorted.map(({ capabilityId, semanticFingerprint }) => ({ capabilityId, semanticFingerprint }))),
+    flowProofFingerprint: digestJson(sorted.map(({ capabilityId, flowProofFingerprint }) => ({ capabilityId, flowProofFingerprint })))
+  };
+}
+function architectureDocsProjectionManifestSourceStamps(manifest) {
+  const stamps = {};
+  for (const row of Object.values(manifest.targets))
+    Object.assign(stamps, row.sourceStamps ?? {});
+  return stamps;
+}
+function architectureDocsProjectionManifestProofEvidence(manifest) {
+  return {
+    rendererVersion: manifest.rendererVersion,
+    selectorEvidenceDigests: Object.fromEntries(manifest.semanticBaseline.capabilities.map((capability) => [capability.capabilityId, capability.selectorEvidenceDigest])),
+    sourceStamps: architectureDocsProjectionManifestSourceStamps(manifest)
+  };
+}
+function architectureSourceStampsDigest(stamps) {
+  return digestJson({
+    schemaVersion: "archcontext.architecture-source-stamps/v1",
+    stamps: Object.keys(stamps).sort(compareStrings).map((nodeId) => ({ nodeId, digest: stamps[nodeId] }))
+  });
+}
+function architectureProjectionOutputsDigest(input) {
+  return digestJson({
+    schemaVersion: "archcontext.architecture-projection-outputs/v1",
+    rendererVersion: input.rendererVersion,
+    profile: input.profile,
+    outputs: Object.keys(input.outputDigests).sort(compareStrings).map((targetId) => ({ targetId, outputDigest: input.outputDigests[targetId] }))
+  });
+}
+function architectureDocsProjectionManifestDigests(manifest) {
+  return {
+    modelDigest: manifest.semanticBaseline.modelDigest,
+    sourceTreeDigest: architectureSourceStampsDigest(architectureDocsProjectionManifestSourceStamps(manifest)),
+    flowProofDigest: architectureDocsProjectionManifestSemanticState(manifest).flowProofFingerprint,
+    projectionDigest: architectureProjectionOutputsDigest({
+      rendererVersion: manifest.rendererVersion,
+      profile: manifest.profile,
+      outputDigests: Object.fromEntries(Object.entries(manifest.targets).map(([targetId, row]) => [targetId, row.outputDigest]))
+    })
+  };
+}
+function architectureDocsProjectionProvenanceIssues(value, prefix = "provenance") {
+  const provenance = record2(value);
+  if (!provenance)
+    return [`${prefix} must be an object`];
+  const issues = exactKeys(provenance, ["schemaVersion", "sourceTreeDigest", "modelDigest", "projectionInputDigest", "rendererVersion", "layoutVersion", "generatedFrom"], [], prefix);
+  if (provenance.schemaVersion !== ARCHITECTURE_DOCS_PROJECTION_PROVENANCE_SCHEMA_VERSION)
+    issues.push(`${prefix}.schemaVersion is unsupported`);
+  for (const field of ["sourceTreeDigest", "modelDigest", "projectionInputDigest"]) {
+    if (!isDigest(provenance[field]))
+      issues.push(`${prefix}.${field} must be a SHA-256 digest`);
+  }
+  if (provenance.rendererVersion !== ARCHITECTURE_DOCS_RENDERER_VERSION)
+    issues.push(`${prefix}.rendererVersion must be ${ARCHITECTURE_DOCS_RENDERER_VERSION}`);
+  if (provenance.layoutVersion !== ARCHITECTURE_DOCS_LAYOUT_VERSION_V1)
+    issues.push(`${prefix}.layoutVersion is unsupported`);
+  issues.push(...generatedFromIssues(provenance.generatedFrom, `${prefix}.generatedFrom`));
+  return issues;
+}
+function capabilityEntriesIssues(value, prefix, withSelectorEvidence) {
+  if (!Array.isArray(value))
+    return [`${prefix} must be an array`];
+  const issues = [];
+  const ids = value.map((entry) => record2(entry)?.capabilityId);
+  if (!isSortedUniqueStrings(ids))
+    issues.push(`${prefix} must be sorted and unique by capabilityId`);
+  value.forEach((entry, index) => {
+    const entryPrefix = `${prefix}[${index}]`;
+    const capability = record2(entry);
+    if (!capability) {
+      issues.push(`${entryPrefix} must be an object`);
+      return;
+    }
+    const required = ["capabilityId", "memberNodeIds", "semanticFingerprint", "flowProofFingerprint", "proofStatus", "facets", ...withSelectorEvidence ? ["selectorEvidenceDigest"] : []];
+    issues.push(...exactKeys(capability, required, [], entryPrefix));
+    if (!isNonEmptyString(capability.capabilityId))
+      issues.push(`${entryPrefix}.capabilityId must be a non-empty string`);
+    if (!Array.isArray(capability.memberNodeIds) || !isSortedUniqueStrings(capability.memberNodeIds))
+      issues.push(`${entryPrefix}.memberNodeIds must be sorted and unique`);
+    if (!isDigest(capability.semanticFingerprint))
+      issues.push(`${entryPrefix}.semanticFingerprint must be a SHA-256 digest`);
+    if (!isDigest(capability.flowProofFingerprint))
+      issues.push(`${entryPrefix}.flowProofFingerprint must be a SHA-256 digest`);
+    if (withSelectorEvidence && !isDigest(capability.selectorEvidenceDigest))
+      issues.push(`${entryPrefix}.selectorEvidenceDigest must be a SHA-256 digest`);
+    if (!isArchitectureCapabilityProofStatus(capability.proofStatus))
+      issues.push(`${entryPrefix}.proofStatus must be a P1/P2 proof status`);
+    const facets = record2(capability.facets);
+    if (!facets)
+      issues.push(`${entryPrefix}.facets must be an object`);
+    else {
+      issues.push(...exactKeys(facets, [...ARCHITECTURE_SEMANTIC_FACETS], [], `${entryPrefix}.facets`));
+      for (const facet of ARCHITECTURE_SEMANTIC_FACETS) {
+        if (!isDigest(facets[facet]))
+          issues.push(`${entryPrefix}.facets.${facet} must be a SHA-256 digest`);
+      }
+    }
+  });
+  return issues;
+}
+function generatedFromIssues(value, prefix) {
+  const generatedFrom = record2(value);
+  if (!generatedFrom)
+    return [`${prefix} must be an object`];
+  const issues = exactKeys(generatedFrom, ["codeGraphPackage", "codeGraphVersion"], [], prefix);
+  for (const field of ["codeGraphPackage", "codeGraphVersion"]) {
+    if (!isNonEmptyString(generatedFrom[field]))
+      issues.push(`${prefix}.${field} must be a non-empty string`);
+  }
+  return issues;
+}
+function canonicalCapability(capability) {
+  return {
+    capabilityId: capability.capabilityId,
+    memberNodeIds: [...capability.memberNodeIds],
+    semanticFingerprint: capability.semanticFingerprint,
+    flowProofFingerprint: capability.flowProofFingerprint,
+    proofStatus: { p1: capability.proofStatus.p1, p2: capability.proofStatus.p2 },
+    facets: Object.fromEntries(Object.keys(capability.facets).sort(compareStrings).map((facet) => [facet, capability.facets[facet]])),
+    selectorEvidenceDigest: capability.selectorEvidenceDigest
+  };
+}
+function canonicalTargetRow(row) {
+  return {
+    type: row.type,
+    scope: {
+      kind: row.scope.kind,
+      ...row.scope.id !== undefined ? { id: row.scope.id } : {},
+      ...row.scope.entityKind !== undefined ? { entityKind: row.scope.entityKind } : {}
+    },
+    path: row.path,
+    ownership: row.ownership,
+    format: row.format,
+    outputDigest: row.outputDigest,
+    ...row.sourceStamps !== undefined ? { sourceStamps: Object.fromEntries(Object.keys(row.sourceStamps).sort(compareStrings).map((nodeId) => [nodeId, row.sourceStamps[nodeId]])) } : {},
+    ...row.scale !== undefined ? {
+      scale: {
+        fileCountBucket: { lower: row.scale.fileCountBucket.lower, upper: row.scale.fileCountBucket.upper },
+        lineCountBucket: { lower: row.scale.lineCountBucket.lower, upper: row.scale.lineCountBucket.upper }
+      }
+    } : {}
+  };
+}
+function isArchitectureScaleBucket(value) {
+  const bucket = record2(value);
+  if (!bucket || Object.keys(bucket).length !== 2)
+    return false;
+  const { lower, upper } = bucket;
+  if (typeof lower !== "number" || typeof upper !== "number" || !Number.isSafeInteger(lower) || !Number.isSafeInteger(upper))
+    return false;
+  if (lower === 0)
+    return upper === 1;
+  let magnitude = 1;
+  while (magnitude * 10 <= lower)
+    magnitude *= 10;
+  const mantissa = lower / magnitude;
+  if (mantissa === 1)
+    return upper === 2 * magnitude;
+  if (mantissa === 2)
+    return upper === 5 * magnitude;
+  if (mantissa === 5)
+    return upper === 10 * magnitude;
+  return false;
+}
+function manifestTargetIssues(value, prefix) {
+  const target = record2(value);
+  if (!target)
+    return [`${prefix} must be an object`];
+  const issues = exactKeys(target, ["type", "scope", "path", "ownership", "format", "outputDigest"], ["sourceStamps", "scale"], prefix);
+  if (typeof target.type !== "string" || !Object.hasOwn(TARGET_TYPES, target.type))
+    issues.push(`${prefix}.type is unsupported`);
+  const scope = record2(target.scope);
+  if (!scope || typeof scope.kind !== "string" || !Object.hasOwn(SCOPE_KINDS, scope.kind))
+    issues.push(`${prefix}.scope.kind is unsupported`);
+  else {
+    issues.push(...exactKeys(scope, ["kind"], ["id", "entityKind"], `${prefix}.scope`));
+    for (const field of ["id", "entityKind"]) {
+      if (scope[field] !== undefined && typeof scope[field] !== "string")
+        issues.push(`${prefix}.scope.${field} must be a string`);
+    }
+  }
+  if (typeof target.path !== "string" || !isRepoRelativePosixPath(target.path))
+    issues.push(`${prefix}.path must be a repository-relative POSIX path`);
+  if (typeof target.ownership !== "string" || !Object.hasOwn(OWNERSHIPS, target.ownership))
+    issues.push(`${prefix}.ownership is unsupported`);
+  if (typeof target.format !== "string" || !Object.hasOwn(FORMATS, target.format))
+    issues.push(`${prefix}.format is unsupported`);
+  if (!isDigest(target.outputDigest))
+    issues.push(`${prefix}.outputDigest must be a SHA-256 digest`);
+  if (target.sourceStamps !== undefined && target.type !== "entity-summary" && !isRuntimeTopologyTargetType(target.type)) {
+    issues.push(`${prefix}.sourceStamps are only allowed on entity-summary and runtime topology targets`);
+  }
+  if (target.scale !== undefined && target.type !== "entity-summary")
+    issues.push(`${prefix}.scale is only allowed on entity-summary targets`);
+  if (target.sourceStamps !== undefined) {
+    const stamps = record2(target.sourceStamps);
+    if (!stamps || Object.keys(stamps).length === 0)
+      issues.push(`${prefix}.sourceStamps must be a non-empty object keyed by node id`);
+    else {
+      for (const [nodeId, digest] of Object.entries(stamps)) {
+        if (!isNonEmptyString(nodeId))
+          issues.push(`${prefix}.sourceStamps keys must be non-empty node ids`);
+        if (!isDigest(digest))
+          issues.push(`${prefix}.sourceStamps.${nodeId} must be a SHA-256 digest`);
+      }
+    }
+  }
+  const ownNodeId = scope?.id;
+  const stampsOwnNode = typeof ownNodeId === "string" && record2(target.sourceStamps) !== undefined && Object.hasOwn(record2(target.sourceStamps), ownNodeId);
+  if (stampsOwnNode !== (target.scale !== undefined))
+    issues.push(`${prefix}.scale must be present exactly when sourceStamps stamps the target's own node`);
+  if (target.scale !== undefined) {
+    const scale = record2(target.scale);
+    if (!scale)
+      issues.push(`${prefix}.scale must be an object`);
+    else {
+      issues.push(...exactKeys(scale, ["fileCountBucket", "lineCountBucket"], [], `${prefix}.scale`));
+      for (const field of ["fileCountBucket", "lineCountBucket"]) {
+        if (!isArchitectureScaleBucket(scale[field]))
+          issues.push(`${prefix}.scale.${field} must be a 1-2-5 magnitude bucket`);
+      }
+    }
+  }
+  return issues;
+}
+function record2(value) {
+  return value && typeof value === "object" && !Array.isArray(value) ? value : undefined;
+}
+function exactKeys(value, required, optional, prefix) {
+  const issues = required.filter((key) => !(key in value)).map((key) => `${prefix}.${key} is required`);
+  const allowed = new Set([...required, ...optional]);
+  for (const key of Object.keys(value))
+    if (!allowed.has(key))
+      issues.push(`${prefix}.${key} is not allowed`);
+  return issues;
+}
+function isDigest(value) {
+  return typeof value === "string" && SHA256.test(value);
+}
+function isNonEmptyString(value) {
+  return typeof value === "string" && value.trim() !== "";
+}
+function isSortedUniqueStrings(values) {
+  return values.every((value, index) => typeof value === "string" && (index === 0 || values[index - 1] < value));
+}
+function compareStrings(left, right) {
+  return left < right ? -1 : left > right ? 1 : 0;
+}
+function versionNumber(value, family) {
+  if (typeof value !== "string" || !value.startsWith(family))
+    return;
+  const suffix = value.slice(family.length);
+  if (!/^[1-9][0-9]*$/.test(suffix))
+    return;
+  const version = Number(suffix);
+  return Number.isSafeInteger(version) ? version : undefined;
+}
+function architectureDocsProjectionCompatibilityIssues(value, engine = {
+  rendererVersion: ARCHITECTURE_DOCS_RENDERER_VERSION,
+  protocolVersion: PROJECTION_REQUEST_SCHEMA_VERSION
+}) {
+  const manifest = record2(value);
+  if (!manifest)
+    return [];
+  const issues = [];
+  if (["minimumRendererVersion", "minimumProtocolVersion"].some((key) => Object.hasOwn(manifest, key)) && manifest.schemaVersion !== ARCHITECTURE_DOCS_PROJECTION_MANIFEST_SCHEMA_VERSION)
+    issues.push("projection manifest floors require the current schema");
+  if (typeof manifest.schemaVersion === "string" && manifest.schemaVersion !== ARCHITECTURE_DOCS_PROJECTION_MANIFEST_SCHEMA_VERSION && !isSupersededArchitectureDocsProjectionManifestSchemaVersion(manifest.schemaVersion))
+    issues.push("projection manifest schema is unsupported by this engine");
+  for (const [key, family, current] of [
+    ["minimumRendererVersion", "archcontext.docs-renderer/v", engine.rendererVersion],
+    ["minimumProtocolVersion", "archcontext.projection-request/v", engine.protocolVersion]
+  ]) {
+    if (!Object.hasOwn(manifest, key))
+      continue;
+    const required = versionNumber(manifest[key], family);
+    const supported = versionNumber(current, family);
+    if (required === undefined || supported === undefined || supported < required)
+      issues.push(`projection manifest ${key} is unsupported by this engine`);
+  }
+  return issues;
+}
+var ARCHITECTURE_DOCS_PROJECTION_MANIFEST_SCHEMA_VERSION = "archcontext.architecture-docs-projection-manifest/v3", SUPERSEDED_ARCHITECTURE_DOCS_PROJECTION_MANIFEST_SCHEMA_VERSIONS, ARCHITECTURE_DOCS_PROJECTION_MANIFEST_UPGRADE_COMMAND = "archctx docs apply --approved --profile <default|repo-harness/v1>", ARCHITECTURE_DOCS_PROJECTION_MANIFEST_MIGRATION_GUIDE = "docs/runbooks/architecture-documentation-projections.md", PROJECTION_MANIFEST_UPGRADE_REQUIRED = "projection-manifest-upgrade-required", PROJECTION_MANIFEST_INVALID = "projection-manifest-invalid", PROJECTION_FOOTPRINT_UNCOVERED = "projection-footprint-uncovered", ARCHITECTURE_DOCS_PROJECTION_PROVENANCE_SCHEMA_VERSION = "archcontext.architecture-docs-projection-provenance/v3", ARCHITECTURE_DOCS_LAYOUT_VERSION_V1 = "archcontext.docs-layout/v1", ARCHITECTURE_SEMANTIC_STATE_SCHEMA_VERSION = "archcontext.architecture-semantic-state/v1", ARCHITECTURE_DOCS_PROJECTION_PROFILES, SHA256, TARGET_TYPES, RUNTIME_TOPOLOGY_TARGET_TYPES, SCOPE_KINDS, OWNERSHIPS, FORMATS;
+var init_projection_manifest = __esm(() => {
+  init_projection();
+  init_schema();
+  SUPERSEDED_ARCHITECTURE_DOCS_PROJECTION_MANIFEST_SCHEMA_VERSIONS = [
+    "archcontext.architecture-docs-projection-manifest/v1",
+    "archcontext.architecture-docs-projection-manifest/v2"
+  ];
+  ARCHITECTURE_DOCS_PROJECTION_PROFILES = ["default", "repo-harness/v1"];
+  SHA256 = /^sha256:[a-f0-9]{64}$/;
+  TARGET_TYPES = {
+    "architecture-index": true,
+    "entity-summary": true,
+    "relation-summary": true,
+    "decision-index": true,
+    "architecture-changelog": true,
+    "diagram-mermaid": true,
+    "diagram-structurizr": true,
+    "diagram-likec4": true,
+    "diagram-runtime-topology": true,
+    "runtime-topology-summary": true,
+    "agent-context": true
+  };
+  RUNTIME_TOPOLOGY_TARGET_TYPES = ["diagram-runtime-topology", "runtime-topology-summary"];
+  SCOPE_KINDS = { repository: true, entity: true, relation: true, decision: true, diagram: true, changelog: true };
+  OWNERSHIPS = { generated: true, mixed: true };
+  FORMATS = { markdown: true, mermaid: true, "structurizr-json": true, likec4: true };
+});
+
 // packages/contracts/src/projection-recovery.ts
 function jsonDataCopy(input, maximum) {
   let measured = 0;
@@ -2085,7 +2529,7 @@ var init_projection_recovery = __esm(() => {
 // packages/contracts/src/failure.ts
 import { isNativeError } from "node:util/types";
 function ownData(input, key) {
-  if (!record2(input))
+  if (!record3(input))
     throw new Error("Failure metadata must be an object");
   const descriptor = Object.getOwnPropertyDescriptor(input, key);
   if (!descriptor) {
@@ -2133,7 +2577,7 @@ function detailsFor(policy, input) {
   if (policy.facts)
     return localFactsFor(policy.facts, input);
   const result = {};
-  if (!record2(input))
+  if (!record3(input))
     throw new Error("Failure details must be an object");
   let omitted = 0;
   for (const [key, descriptor] of Object.entries(Object.getOwnPropertyDescriptors(input))) {
@@ -2159,7 +2603,7 @@ function detailsFor(policy, input) {
   return result;
 }
 function dataRecord(value) {
-  if (!record2(value))
+  if (!record3(value))
     throw new Error("Facts must be a plain record");
   const proto = Object.getPrototypeOf(value), keys = Reflect.ownKeys(value);
   if (proto !== Object.prototype && proto !== null || keys.length > 16 || Object.keys(value).length !== keys.length || keys.some((key) => typeof key !== "string"))
@@ -2284,7 +2728,7 @@ function nativeFactsFor(policy, input) {
   let omitted = 0, characters = 0;
   const omit = (value) => {
     omitted++;
-    const strings = (v) => typeof v === "string" ? v.length : Array.isArray(v) ? v.reduce((n, item) => n + strings(item), 0) : record2(v) ? Object.values(v).reduce((n, item) => n + strings(item), 0) : 0;
+    const strings = (v) => typeof v === "string" ? v.length : Array.isArray(v) ? v.reduce((n, item) => n + strings(item), 0) : record3(v) ? Object.values(v).reduce((n, item) => n + strings(item), 0) : 0;
     characters += strings(value);
   };
   const text = (value) => {
@@ -2423,7 +2867,7 @@ function budgetIssues(value, depth = 0, maxStringBytes = 256) {
     return Number.isFinite(value) ? [] : ["detail number is not finite"];
   if (Array.isArray(value))
     return value.length <= 32 ? value.flatMap((item) => budgetIssues(item, depth + 1, maxStringBytes)) : ["detail list exceeds 32"];
-  if (record2(value))
+  if (record3(value))
     return Object.keys(value).length <= 16 ? Object.values(value).flatMap((item) => budgetIssues(item, depth + 1, maxStringBytes)) : ["detail object exceeds 16 fields"];
   return value === null || typeof value === "boolean" ? [] : ["detail value is not JSON"];
 }
@@ -2498,7 +2942,7 @@ function toEnvelope(requestId, error, stage) {
   }
 }
 function normalizeFailureResult(result, stage, requestId = "failure") {
-  if (!record2(result))
+  if (!record3(result))
     return result;
   try {
     if (ownData(result, "ok") !== false)
@@ -2528,7 +2972,7 @@ function jsonDataSnapshot(value, depth = 0, maxStringBytes = 256) {
       return jsonDataSnapshot(descriptor.value, depth + 1, maxStringBytes);
     });
   }
-  if (record2(value)) {
+  if (record3(value)) {
     const prototype = Object.getPrototypeOf(value);
     const keys = Reflect.ownKeys(value);
     if (prototype !== Object.prototype && prototype !== null || keys.length > 16 || Object.keys(value).length !== keys.length || keys.some((key) => typeof key !== "string"))
@@ -2539,7 +2983,7 @@ function jsonDataSnapshot(value, depth = 0, maxStringBytes = 256) {
 }
 function failureIssues(value) {
   try {
-    if (!record2(value))
+    if (!record3(value))
       return ["failure must be an object"];
     const fields = ["code", "message", "severity", "retryable", "action", "reasonCode", "details"];
     const keys = Reflect.ownKeys(value);
@@ -2558,10 +3002,12 @@ function failureIssues(value) {
     return ["failure violates its registered contract or budget"];
   }
 }
-var FAILURE_STAGES, ERROR_CLASSES, CODE_FACTS_ISSUE_MESSAGES, policies, FAILURE_POLICIES, catalogDefaults, actions, bytes = (value) => new TextEncoder().encode(value).byteLength, record2 = (value) => value !== null && typeof value === "object" && !Array.isArray(value), finiteNonnegative = (value) => typeof value === "number" && Number.isFinite(value) && value >= 0, criticalKey = (key) => /id$|digest|receipt|binding|readback|lookupkey/i.test(key), localEnums, nativeEnums, nativeDiagnosticKinds, FailureError;
+var FAILURE_STAGES, ERROR_CLASSES, CODE_FACTS_ISSUE_MESSAGES, policies, FAILURE_POLICIES, catalogDefaults, actions, bytes = (value) => new TextEncoder().encode(value).byteLength, record3 = (value) => value !== null && typeof value === "object" && !Array.isArray(value), finiteNonnegative = (value) => typeof value === "number" && Number.isFinite(value) && value >= 0, criticalKey = (key) => /id$|digest|receipt|binding|readback|lookupkey/i.test(key), localEnums, nativeEnums, nativeDiagnosticKinds, FailureError;
 var init_failure = __esm(() => {
   init_changeset_recovery();
   init_ports();
+  init_projection();
+  init_projection_manifest();
   init_projection_recovery();
   init_schema();
   FAILURE_STAGES = Object.freeze(["debt", "complete", "practice-checkpoint", "cli", "mcp", "hook-checkpoint", "failure-metadata", "public-operation", "native-export", "docs-anchors", "flows-check"]);
@@ -2589,7 +3035,7 @@ var init_failure = __esm(() => {
     "model-missing": { code: "AC_MODEL_ADOPTION_REQUIRED", message: "Architecture debt requires an adopted model.", fields: ["checks"] },
     "changed-path-invalid": { code: "AC_SCHEMA_INVALID", message: "Changed paths must be an array of repository-relative POSIX paths.", fields: ["checks"] },
     "debt-report-invalid": { code: "AC_SCHEMA_INVALID", message: "Architecture debt evidence violates its contract.", fields: ["checks"] },
-    "projection-manifest-upgrade-required": { code: "AC_PRECONDITION_FAILED", message: "The committed projection manifest requires supported re-baselining. First restore the original model if missing; the manifest digest cannot recover it. With the reviewed model available, follow docs/runbooks/architecture-documentation-projections.md before running archctx docs apply --approved --profile <default|repo-harness/v1>." },
+    "projection-manifest-upgrade-required": { code: "AC_PRECONDITION_FAILED", message: `The committed projection manifest requires supported re-baselining. First restore the original model if missing; the manifest digest cannot recover it. With the reviewed model available, follow ${ARCHITECTURE_DOCS_PROJECTION_MANIFEST_MIGRATION_GUIDE} before running ${ARCHITECTURE_DOCS_PROJECTION_MANIFEST_UPGRADE_COMMAND}.`, facts: { manifestPath: "optional:projectionManifestPath", foundSchemaVersion: "optional:projectionManifestSchemaVersion", supportedSchemaVersion: "optional:projectionManifestSchemaVersion", upgradeCommand: "optional:projectionManifestUpgradeCommand", migrationGuide: "optional:projectionManifestMigrationGuide" } },
     "projection-manifest-invalid": { code: "AC_PRECONDITION_FAILED", message: "The committed projection manifest violates its contract." },
     "architecture-model-ignored": { code: "AC_PRECONDITION_FAILED", action: "commit-architecture-model", message: "Git ignore rules exclude architecture model paths, so the model cannot be committed and a manifest digest cannot rebuild it. Remove or narrow the rule, commit the model, then retry adoption. The diagnostic command prints each deciding rule.", facts: { pathCount: "uint", paths: "optional:diagnosticPaths", commands: "optional:diagnosticCommands", omittedPathCount: "uint" } },
     "projection-footprint-uncovered": { code: "AC_PRECONDITION_FAILED", message: "Declared source footprints lack a projection target." },
@@ -2850,6 +3296,10 @@ var init_failure = __esm(() => {
     upgradeAction: ["upgrade-archctx-runtime"],
     upgradeCommand: ["archctx daemon upgrade"],
     ownershipAction: ["remove-whole-file-outputs-and-reapply"],
+    projectionManifestPath: [ARCHITECTURE_DOCS_PROJECTION_MANIFEST_PATH],
+    projectionManifestSchemaVersion: [...SUPERSEDED_ARCHITECTURE_DOCS_PROJECTION_MANIFEST_SCHEMA_VERSIONS, ARCHITECTURE_DOCS_PROJECTION_MANIFEST_SCHEMA_VERSION],
+    projectionManifestUpgradeCommand: [ARCHITECTURE_DOCS_PROJECTION_MANIFEST_UPGRADE_COMMAND],
+    projectionManifestMigrationGuide: [ARCHITECTURE_DOCS_PROJECTION_MANIFEST_MIGRATION_GUIDE],
     ledgerModeField: ["rolloutMode", "readMode", "writeMode"],
     depsField: ["from", "into", "importNodeLimit", "edgeLimit"],
     depsIssue: ["unknown-node", "invalid-limit", "missing-value"],
@@ -3566,450 +4016,6 @@ var PRACTICE_SCHEMA_VERSION = "archcontext.practice/v1", PRACTICE_PROFILE_SCHEMA
 var PROJECTION_PUBLISH_RUN_SCHEMA_VERSION = "archcontext.projection-publish-run/v1", PROJECTION_PUBLISH_STATUS_SCHEMA_VERSION = "archcontext.projection-publish-status/v1", PROJECTION_PR_VERIFICATION_SCHEMA_VERSION = "archcontext.projection-pr-verification/v1", PROJECTION_WRITER_BRANCH_PREFIX = "archctx/", PROJECTION_WRITER_DEFAULT_BRANCH = "archctx/projection";
 var init_projection_writer = () => {};
 
-// packages/contracts/src/projection-manifest.ts
-function isRuntimeTopologyTargetType(type) {
-  return typeof type === "string" && RUNTIME_TOPOLOGY_TARGET_TYPES.includes(type);
-}
-function architectureDocsProjectionManifestIssues(value) {
-  const issues = [];
-  const manifest = record3(value);
-  if (!manifest)
-    return ["manifest must be an object"];
-  issues.push(...exactKeys(manifest, ["schemaVersion", "rendererVersion", "profile", "layoutVersion", "generatedFrom", "semanticBaseline", "targets"], ["minimumRendererVersion", "minimumProtocolVersion"], "manifest"));
-  if (manifest.schemaVersion !== ARCHITECTURE_DOCS_PROJECTION_MANIFEST_SCHEMA_VERSION)
-    issues.push("manifest.schemaVersion is unsupported");
-  if (!isNonEmptyString(manifest.rendererVersion))
-    issues.push("manifest.rendererVersion must be a non-empty string");
-  for (const [key, family] of [["minimumRendererVersion", "archcontext.docs-renderer/v"], ["minimumProtocolVersion", "archcontext.projection-request/v"]]) {
-    if (Object.hasOwn(manifest, key) && versionNumber(manifest[key], family) === undefined)
-      issues.push(`manifest.${key} must name a supported version family`);
-  }
-  if (!ARCHITECTURE_DOCS_PROJECTION_PROFILES.includes(manifest.profile))
-    issues.push("manifest.profile is unsupported");
-  if (manifest.layoutVersion !== ARCHITECTURE_DOCS_LAYOUT_VERSION_V1)
-    issues.push("manifest.layoutVersion is unsupported");
-  issues.push(...generatedFromIssues(manifest.generatedFrom, "manifest.generatedFrom"));
-  const baseline = record3(manifest.semanticBaseline);
-  if (!baseline)
-    issues.push("manifest.semanticBaseline must be an object");
-  else {
-    issues.push(...exactKeys(baseline, ["modelDigest", "capabilities"], [], "manifest.semanticBaseline"));
-    if (!isDigest(baseline.modelDigest))
-      issues.push("manifest.semanticBaseline.modelDigest must be a SHA-256 digest");
-    issues.push(...capabilityEntriesIssues(baseline.capabilities, "manifest.semanticBaseline.capabilities", true));
-  }
-  const targets = record3(manifest.targets);
-  if (!targets) {
-    issues.push("manifest.targets must be an object keyed by targetId");
-    return issues;
-  }
-  const paths = new Set;
-  const stampOwners = new Map;
-  let topologyStamps;
-  for (const [targetId, row] of Object.entries(targets)) {
-    const prefix = `manifest.targets[${JSON.stringify(targetId)}]`;
-    if (!isNonEmptyString(targetId))
-      issues.push("manifest.targets keys must be non-empty targetIds");
-    issues.push(...manifestTargetIssues(row, prefix));
-    const path = record3(row)?.path;
-    if (typeof path === "string") {
-      if (paths.has(path))
-        issues.push(`${prefix}.path is recorded by another target`);
-      paths.add(path);
-    }
-    const stamps = record3(record3(row)?.sourceStamps) ?? {};
-    if (isRuntimeTopologyTargetType(record3(row)?.type)) {
-      const serialized = JSON.stringify(Object.keys(stamps).sort(compareStrings).map((nodeId) => [nodeId, stamps[nodeId]]));
-      if (topologyStamps === undefined)
-        topologyStamps = { targetId, stamps: serialized };
-      else if (topologyStamps.stamps !== serialized)
-        issues.push(`${prefix}.sourceStamps must equal the sourceStamps of ${topologyStamps.targetId}`);
-      for (const nodeId of Object.keys(stamps)) {
-        const owner = stampOwners.get(nodeId);
-        if (owner !== undefined && !isRuntimeTopologyTargetType(record3(targets[owner])?.type))
-          issues.push(`${prefix}.sourceStamps.${nodeId} is already stamped on ${owner}`);
-        else if (owner === undefined)
-          stampOwners.set(nodeId, targetId);
-      }
-      continue;
-    }
-    for (const nodeId of Object.keys(stamps)) {
-      const owner = stampOwners.get(nodeId);
-      if (owner !== undefined)
-        issues.push(`${prefix}.sourceStamps.${nodeId} is already stamped on ${owner}`);
-      else
-        stampOwners.set(nodeId, targetId);
-    }
-  }
-  return issues;
-}
-function architectureDocsProjectionManifestSchemaVersion(body) {
-  let parsed;
-  try {
-    parsed = JSON.parse(body);
-  } catch {
-    return;
-  }
-  const schemaVersion = record3(parsed)?.schemaVersion;
-  return typeof schemaVersion === "string" ? schemaVersion : undefined;
-}
-function isSupersededArchitectureDocsProjectionManifestSchemaVersion(schemaVersion) {
-  return SUPERSEDED_ARCHITECTURE_DOCS_PROJECTION_MANIFEST_SCHEMA_VERSIONS.includes(schemaVersion);
-}
-function serializeArchitectureDocsProjectionManifest(manifest) {
-  const capabilities = [...manifest.semanticBaseline.capabilities].sort((left, right) => compareStrings(left.capabilityId, right.capabilityId)).map(canonicalCapability);
-  const capabilityBlock = JSON.stringify(capabilities, null, 2).split(`
-`).map((line, index) => index === 0 ? line : `    ${line}`).join(`
-`);
-  const targetIds = Object.keys(manifest.targets).sort(compareStrings);
-  const targetLines = targetIds.length === 0 ? ['  "targets": {}'] : [
-    '  "targets": {',
-    ...targetIds.flatMap((targetId, index) => [
-      `    ${JSON.stringify(targetId)}:`,
-      `      ${JSON.stringify(canonicalTargetRow(manifest.targets[targetId]))}${index === targetIds.length - 1 ? "" : ","}`
-    ]),
-    "  }"
-  ];
-  return [
-    "{",
-    `  "schemaVersion": ${JSON.stringify(manifest.schemaVersion)},`,
-    `  "rendererVersion": ${JSON.stringify(manifest.rendererVersion)},`,
-    ...manifest.minimumRendererVersion === undefined ? [] : [`  "minimumRendererVersion": ${JSON.stringify(manifest.minimumRendererVersion)},`],
-    ...manifest.minimumProtocolVersion === undefined ? [] : [`  "minimumProtocolVersion": ${JSON.stringify(manifest.minimumProtocolVersion)},`],
-    `  "profile": ${JSON.stringify(manifest.profile)},`,
-    `  "layoutVersion": ${JSON.stringify(manifest.layoutVersion)},`,
-    `  "generatedFrom": ${JSON.stringify({ codeGraphPackage: manifest.generatedFrom.codeGraphPackage, codeGraphVersion: manifest.generatedFrom.codeGraphVersion })},`,
-    '  "semanticBaseline": {',
-    `    "modelDigest": ${JSON.stringify(manifest.semanticBaseline.modelDigest)},`,
-    `    "capabilities": ${capabilityBlock}`,
-    "  },",
-    ...targetLines,
-    "}",
-    ""
-  ].join(`
-`);
-}
-function architectureDocsProjectionManifestSemanticState(manifest) {
-  return architectureSemanticStateFromCapabilities(manifest.semanticBaseline.capabilities.map(({ selectorEvidenceDigest: _selectorEvidenceDigest, ...capability }) => capability));
-}
-function architectureSemanticStateFromCapabilities(capabilities) {
-  const sorted = [...capabilities].sort((left, right) => compareStrings(left.capabilityId, right.capabilityId));
-  return {
-    schemaVersion: ARCHITECTURE_SEMANTIC_STATE_SCHEMA_VERSION,
-    capabilities: sorted,
-    semanticFingerprint: digestJson(sorted.map(({ capabilityId, semanticFingerprint }) => ({ capabilityId, semanticFingerprint }))),
-    flowProofFingerprint: digestJson(sorted.map(({ capabilityId, flowProofFingerprint }) => ({ capabilityId, flowProofFingerprint })))
-  };
-}
-function architectureDocsProjectionManifestSourceStamps(manifest) {
-  const stamps = {};
-  for (const row of Object.values(manifest.targets))
-    Object.assign(stamps, row.sourceStamps ?? {});
-  return stamps;
-}
-function architectureDocsProjectionManifestProofEvidence(manifest) {
-  return {
-    rendererVersion: manifest.rendererVersion,
-    selectorEvidenceDigests: Object.fromEntries(manifest.semanticBaseline.capabilities.map((capability) => [capability.capabilityId, capability.selectorEvidenceDigest])),
-    sourceStamps: architectureDocsProjectionManifestSourceStamps(manifest)
-  };
-}
-function architectureSourceStampsDigest(stamps) {
-  return digestJson({
-    schemaVersion: "archcontext.architecture-source-stamps/v1",
-    stamps: Object.keys(stamps).sort(compareStrings).map((nodeId) => ({ nodeId, digest: stamps[nodeId] }))
-  });
-}
-function architectureProjectionOutputsDigest(input) {
-  return digestJson({
-    schemaVersion: "archcontext.architecture-projection-outputs/v1",
-    rendererVersion: input.rendererVersion,
-    profile: input.profile,
-    outputs: Object.keys(input.outputDigests).sort(compareStrings).map((targetId) => ({ targetId, outputDigest: input.outputDigests[targetId] }))
-  });
-}
-function architectureDocsProjectionManifestDigests(manifest) {
-  return {
-    modelDigest: manifest.semanticBaseline.modelDigest,
-    sourceTreeDigest: architectureSourceStampsDigest(architectureDocsProjectionManifestSourceStamps(manifest)),
-    flowProofDigest: architectureDocsProjectionManifestSemanticState(manifest).flowProofFingerprint,
-    projectionDigest: architectureProjectionOutputsDigest({
-      rendererVersion: manifest.rendererVersion,
-      profile: manifest.profile,
-      outputDigests: Object.fromEntries(Object.entries(manifest.targets).map(([targetId, row]) => [targetId, row.outputDigest]))
-    })
-  };
-}
-function architectureDocsProjectionProvenanceIssues(value, prefix = "provenance") {
-  const provenance = record3(value);
-  if (!provenance)
-    return [`${prefix} must be an object`];
-  const issues = exactKeys(provenance, ["schemaVersion", "sourceTreeDigest", "modelDigest", "projectionInputDigest", "rendererVersion", "layoutVersion", "generatedFrom"], [], prefix);
-  if (provenance.schemaVersion !== ARCHITECTURE_DOCS_PROJECTION_PROVENANCE_SCHEMA_VERSION)
-    issues.push(`${prefix}.schemaVersion is unsupported`);
-  for (const field of ["sourceTreeDigest", "modelDigest", "projectionInputDigest"]) {
-    if (!isDigest(provenance[field]))
-      issues.push(`${prefix}.${field} must be a SHA-256 digest`);
-  }
-  if (provenance.rendererVersion !== ARCHITECTURE_DOCS_RENDERER_VERSION)
-    issues.push(`${prefix}.rendererVersion must be ${ARCHITECTURE_DOCS_RENDERER_VERSION}`);
-  if (provenance.layoutVersion !== ARCHITECTURE_DOCS_LAYOUT_VERSION_V1)
-    issues.push(`${prefix}.layoutVersion is unsupported`);
-  issues.push(...generatedFromIssues(provenance.generatedFrom, `${prefix}.generatedFrom`));
-  return issues;
-}
-function capabilityEntriesIssues(value, prefix, withSelectorEvidence) {
-  if (!Array.isArray(value))
-    return [`${prefix} must be an array`];
-  const issues = [];
-  const ids = value.map((entry) => record3(entry)?.capabilityId);
-  if (!isSortedUniqueStrings(ids))
-    issues.push(`${prefix} must be sorted and unique by capabilityId`);
-  value.forEach((entry, index) => {
-    const entryPrefix = `${prefix}[${index}]`;
-    const capability = record3(entry);
-    if (!capability) {
-      issues.push(`${entryPrefix} must be an object`);
-      return;
-    }
-    const required = ["capabilityId", "memberNodeIds", "semanticFingerprint", "flowProofFingerprint", "proofStatus", "facets", ...withSelectorEvidence ? ["selectorEvidenceDigest"] : []];
-    issues.push(...exactKeys(capability, required, [], entryPrefix));
-    if (!isNonEmptyString(capability.capabilityId))
-      issues.push(`${entryPrefix}.capabilityId must be a non-empty string`);
-    if (!Array.isArray(capability.memberNodeIds) || !isSortedUniqueStrings(capability.memberNodeIds))
-      issues.push(`${entryPrefix}.memberNodeIds must be sorted and unique`);
-    if (!isDigest(capability.semanticFingerprint))
-      issues.push(`${entryPrefix}.semanticFingerprint must be a SHA-256 digest`);
-    if (!isDigest(capability.flowProofFingerprint))
-      issues.push(`${entryPrefix}.flowProofFingerprint must be a SHA-256 digest`);
-    if (withSelectorEvidence && !isDigest(capability.selectorEvidenceDigest))
-      issues.push(`${entryPrefix}.selectorEvidenceDigest must be a SHA-256 digest`);
-    if (!isArchitectureCapabilityProofStatus(capability.proofStatus))
-      issues.push(`${entryPrefix}.proofStatus must be a P1/P2 proof status`);
-    const facets = record3(capability.facets);
-    if (!facets)
-      issues.push(`${entryPrefix}.facets must be an object`);
-    else {
-      issues.push(...exactKeys(facets, [...ARCHITECTURE_SEMANTIC_FACETS], [], `${entryPrefix}.facets`));
-      for (const facet of ARCHITECTURE_SEMANTIC_FACETS) {
-        if (!isDigest(facets[facet]))
-          issues.push(`${entryPrefix}.facets.${facet} must be a SHA-256 digest`);
-      }
-    }
-  });
-  return issues;
-}
-function generatedFromIssues(value, prefix) {
-  const generatedFrom = record3(value);
-  if (!generatedFrom)
-    return [`${prefix} must be an object`];
-  const issues = exactKeys(generatedFrom, ["codeGraphPackage", "codeGraphVersion"], [], prefix);
-  for (const field of ["codeGraphPackage", "codeGraphVersion"]) {
-    if (!isNonEmptyString(generatedFrom[field]))
-      issues.push(`${prefix}.${field} must be a non-empty string`);
-  }
-  return issues;
-}
-function canonicalCapability(capability) {
-  return {
-    capabilityId: capability.capabilityId,
-    memberNodeIds: [...capability.memberNodeIds],
-    semanticFingerprint: capability.semanticFingerprint,
-    flowProofFingerprint: capability.flowProofFingerprint,
-    proofStatus: { p1: capability.proofStatus.p1, p2: capability.proofStatus.p2 },
-    facets: Object.fromEntries(Object.keys(capability.facets).sort(compareStrings).map((facet) => [facet, capability.facets[facet]])),
-    selectorEvidenceDigest: capability.selectorEvidenceDigest
-  };
-}
-function canonicalTargetRow(row) {
-  return {
-    type: row.type,
-    scope: {
-      kind: row.scope.kind,
-      ...row.scope.id !== undefined ? { id: row.scope.id } : {},
-      ...row.scope.entityKind !== undefined ? { entityKind: row.scope.entityKind } : {}
-    },
-    path: row.path,
-    ownership: row.ownership,
-    format: row.format,
-    outputDigest: row.outputDigest,
-    ...row.sourceStamps !== undefined ? { sourceStamps: Object.fromEntries(Object.keys(row.sourceStamps).sort(compareStrings).map((nodeId) => [nodeId, row.sourceStamps[nodeId]])) } : {},
-    ...row.scale !== undefined ? {
-      scale: {
-        fileCountBucket: { lower: row.scale.fileCountBucket.lower, upper: row.scale.fileCountBucket.upper },
-        lineCountBucket: { lower: row.scale.lineCountBucket.lower, upper: row.scale.lineCountBucket.upper }
-      }
-    } : {}
-  };
-}
-function isArchitectureScaleBucket(value) {
-  const bucket = record3(value);
-  if (!bucket || Object.keys(bucket).length !== 2)
-    return false;
-  const { lower, upper } = bucket;
-  if (typeof lower !== "number" || typeof upper !== "number" || !Number.isSafeInteger(lower) || !Number.isSafeInteger(upper))
-    return false;
-  if (lower === 0)
-    return upper === 1;
-  let magnitude = 1;
-  while (magnitude * 10 <= lower)
-    magnitude *= 10;
-  const mantissa = lower / magnitude;
-  if (mantissa === 1)
-    return upper === 2 * magnitude;
-  if (mantissa === 2)
-    return upper === 5 * magnitude;
-  if (mantissa === 5)
-    return upper === 10 * magnitude;
-  return false;
-}
-function manifestTargetIssues(value, prefix) {
-  const target = record3(value);
-  if (!target)
-    return [`${prefix} must be an object`];
-  const issues = exactKeys(target, ["type", "scope", "path", "ownership", "format", "outputDigest"], ["sourceStamps", "scale"], prefix);
-  if (typeof target.type !== "string" || !Object.hasOwn(TARGET_TYPES, target.type))
-    issues.push(`${prefix}.type is unsupported`);
-  const scope = record3(target.scope);
-  if (!scope || typeof scope.kind !== "string" || !Object.hasOwn(SCOPE_KINDS, scope.kind))
-    issues.push(`${prefix}.scope.kind is unsupported`);
-  else {
-    issues.push(...exactKeys(scope, ["kind"], ["id", "entityKind"], `${prefix}.scope`));
-    for (const field of ["id", "entityKind"]) {
-      if (scope[field] !== undefined && typeof scope[field] !== "string")
-        issues.push(`${prefix}.scope.${field} must be a string`);
-    }
-  }
-  if (typeof target.path !== "string" || !isRepoRelativePosixPath(target.path))
-    issues.push(`${prefix}.path must be a repository-relative POSIX path`);
-  if (typeof target.ownership !== "string" || !Object.hasOwn(OWNERSHIPS, target.ownership))
-    issues.push(`${prefix}.ownership is unsupported`);
-  if (typeof target.format !== "string" || !Object.hasOwn(FORMATS, target.format))
-    issues.push(`${prefix}.format is unsupported`);
-  if (!isDigest(target.outputDigest))
-    issues.push(`${prefix}.outputDigest must be a SHA-256 digest`);
-  if (target.sourceStamps !== undefined && target.type !== "entity-summary" && !isRuntimeTopologyTargetType(target.type)) {
-    issues.push(`${prefix}.sourceStamps are only allowed on entity-summary and runtime topology targets`);
-  }
-  if (target.scale !== undefined && target.type !== "entity-summary")
-    issues.push(`${prefix}.scale is only allowed on entity-summary targets`);
-  if (target.sourceStamps !== undefined) {
-    const stamps = record3(target.sourceStamps);
-    if (!stamps || Object.keys(stamps).length === 0)
-      issues.push(`${prefix}.sourceStamps must be a non-empty object keyed by node id`);
-    else {
-      for (const [nodeId, digest] of Object.entries(stamps)) {
-        if (!isNonEmptyString(nodeId))
-          issues.push(`${prefix}.sourceStamps keys must be non-empty node ids`);
-        if (!isDigest(digest))
-          issues.push(`${prefix}.sourceStamps.${nodeId} must be a SHA-256 digest`);
-      }
-    }
-  }
-  const ownNodeId = scope?.id;
-  const stampsOwnNode = typeof ownNodeId === "string" && record3(target.sourceStamps) !== undefined && Object.hasOwn(record3(target.sourceStamps), ownNodeId);
-  if (stampsOwnNode !== (target.scale !== undefined))
-    issues.push(`${prefix}.scale must be present exactly when sourceStamps stamps the target's own node`);
-  if (target.scale !== undefined) {
-    const scale = record3(target.scale);
-    if (!scale)
-      issues.push(`${prefix}.scale must be an object`);
-    else {
-      issues.push(...exactKeys(scale, ["fileCountBucket", "lineCountBucket"], [], `${prefix}.scale`));
-      for (const field of ["fileCountBucket", "lineCountBucket"]) {
-        if (!isArchitectureScaleBucket(scale[field]))
-          issues.push(`${prefix}.scale.${field} must be a 1-2-5 magnitude bucket`);
-      }
-    }
-  }
-  return issues;
-}
-function record3(value) {
-  return value && typeof value === "object" && !Array.isArray(value) ? value : undefined;
-}
-function exactKeys(value, required, optional, prefix) {
-  const issues = required.filter((key) => !(key in value)).map((key) => `${prefix}.${key} is required`);
-  const allowed = new Set([...required, ...optional]);
-  for (const key of Object.keys(value))
-    if (!allowed.has(key))
-      issues.push(`${prefix}.${key} is not allowed`);
-  return issues;
-}
-function isDigest(value) {
-  return typeof value === "string" && SHA256.test(value);
-}
-function isNonEmptyString(value) {
-  return typeof value === "string" && value.trim() !== "";
-}
-function isSortedUniqueStrings(values) {
-  return values.every((value, index) => typeof value === "string" && (index === 0 || values[index - 1] < value));
-}
-function compareStrings(left, right) {
-  return left < right ? -1 : left > right ? 1 : 0;
-}
-function versionNumber(value, family) {
-  if (typeof value !== "string" || !value.startsWith(family))
-    return;
-  const suffix = value.slice(family.length);
-  if (!/^[1-9][0-9]*$/.test(suffix))
-    return;
-  const version = Number(suffix);
-  return Number.isSafeInteger(version) ? version : undefined;
-}
-function architectureDocsProjectionCompatibilityIssues(value, engine = {
-  rendererVersion: ARCHITECTURE_DOCS_RENDERER_VERSION,
-  protocolVersion: PROJECTION_REQUEST_SCHEMA_VERSION
-}) {
-  const manifest = record3(value);
-  if (!manifest)
-    return [];
-  const issues = [];
-  if (["minimumRendererVersion", "minimumProtocolVersion"].some((key) => Object.hasOwn(manifest, key)) && manifest.schemaVersion !== ARCHITECTURE_DOCS_PROJECTION_MANIFEST_SCHEMA_VERSION)
-    issues.push("projection manifest floors require the current schema");
-  if (typeof manifest.schemaVersion === "string" && manifest.schemaVersion !== ARCHITECTURE_DOCS_PROJECTION_MANIFEST_SCHEMA_VERSION && !isSupersededArchitectureDocsProjectionManifestSchemaVersion(manifest.schemaVersion))
-    issues.push("projection manifest schema is unsupported by this engine");
-  for (const [key, family, current] of [
-    ["minimumRendererVersion", "archcontext.docs-renderer/v", engine.rendererVersion],
-    ["minimumProtocolVersion", "archcontext.projection-request/v", engine.protocolVersion]
-  ]) {
-    if (!Object.hasOwn(manifest, key))
-      continue;
-    const required = versionNumber(manifest[key], family);
-    const supported = versionNumber(current, family);
-    if (required === undefined || supported === undefined || supported < required)
-      issues.push(`projection manifest ${key} is unsupported by this engine`);
-  }
-  return issues;
-}
-var ARCHITECTURE_DOCS_PROJECTION_MANIFEST_SCHEMA_VERSION = "archcontext.architecture-docs-projection-manifest/v3", SUPERSEDED_ARCHITECTURE_DOCS_PROJECTION_MANIFEST_SCHEMA_VERSIONS, PROJECTION_MANIFEST_UPGRADE_REQUIRED = "projection-manifest-upgrade-required", PROJECTION_MANIFEST_INVALID = "projection-manifest-invalid", PROJECTION_FOOTPRINT_UNCOVERED = "projection-footprint-uncovered", ARCHITECTURE_DOCS_PROJECTION_PROVENANCE_SCHEMA_VERSION = "archcontext.architecture-docs-projection-provenance/v3", ARCHITECTURE_DOCS_LAYOUT_VERSION_V1 = "archcontext.docs-layout/v1", ARCHITECTURE_SEMANTIC_STATE_SCHEMA_VERSION = "archcontext.architecture-semantic-state/v1", ARCHITECTURE_DOCS_PROJECTION_PROFILES, SHA256, TARGET_TYPES, RUNTIME_TOPOLOGY_TARGET_TYPES, SCOPE_KINDS, OWNERSHIPS, FORMATS;
-var init_projection_manifest = __esm(() => {
-  init_projection();
-  init_schema();
-  SUPERSEDED_ARCHITECTURE_DOCS_PROJECTION_MANIFEST_SCHEMA_VERSIONS = [
-    "archcontext.architecture-docs-projection-manifest/v1",
-    "archcontext.architecture-docs-projection-manifest/v2"
-  ];
-  ARCHITECTURE_DOCS_PROJECTION_PROFILES = ["default", "repo-harness/v1"];
-  SHA256 = /^sha256:[a-f0-9]{64}$/;
-  TARGET_TYPES = {
-    "architecture-index": true,
-    "entity-summary": true,
-    "relation-summary": true,
-    "decision-index": true,
-    "architecture-changelog": true,
-    "diagram-mermaid": true,
-    "diagram-structurizr": true,
-    "diagram-likec4": true,
-    "diagram-runtime-topology": true,
-    "runtime-topology-summary": true,
-    "agent-context": true
-  };
-  RUNTIME_TOPOLOGY_TARGET_TYPES = ["diagram-runtime-topology", "runtime-topology-summary"];
-  SCOPE_KINDS = { repository: true, entity: true, relation: true, decision: true, diagram: true, changelog: true };
-  OWNERSHIPS = { generated: true, mixed: true };
-  FORMATS = { markdown: true, mermaid: true, "structurizr-json": true, likec4: true };
-});
-
 // packages/contracts/src/product-version.ts
 function productVersionManifest() {
   return {
@@ -4095,7 +4101,7 @@ function compareVersionTriples(left, right) {
   }
   return 0;
 }
-var ARCHCONTEXT_PRODUCT_NAME = "archctx", ARCHCONTEXT_PRODUCT_VERSION = "0.9.4", ARCHCONTEXT_PACKAGE_MANAGER = "bun@1.4.3", ARCHCONTEXT_NODE_RANGE = ">=22.22 <26", LOCAL_RUNTIME_RPC_SCHEMA_VERSION = "archcontext.runtime-rpc/v2", ARCHCONTEXT_SCHEMA_SET_VERSION = "2026-07-11.explorer-view-v2";
+var ARCHCONTEXT_PRODUCT_NAME = "archctx", ARCHCONTEXT_PRODUCT_VERSION = "0.10.0", ARCHCONTEXT_PACKAGE_MANAGER = "bun@1.4.3", ARCHCONTEXT_NODE_RANGE = ">=22.22 <26", LOCAL_RUNTIME_RPC_SCHEMA_VERSION = "archcontext.runtime-rpc/v2", ARCHCONTEXT_SCHEMA_SET_VERSION = "2026-07-11.explorer-view-v2";
 
 // packages/contracts/src/refactor.ts
 function refactorNamespaceIssues(value, label = "product.id") {
@@ -18071,12 +18077,13 @@ function resolveArchitectureDocumentationLayout(input) {
   });
   const relationTargets = (profile === REPO_HARNESS_PROJECTION_PROFILE ? [] : input.relations).map((relation) => layoutTarget(`projection_target.relation.${stableId(relation.id)}`, "relation-summary", { kind: "relation", id: relation.id }, `docs/architecture/relations/${pathSegment(relation.id)}.md`, "mixed", "markdown"));
   const topologyTargets = hasRuntimeTopologyNodes(input.nodes) ? RUNTIME_TOPOLOGY_TARGETS : [];
-  const targets = [FIXED_TARGETS[0], ...entityTargets, ...relationTargets, ...FIXED_TARGETS.slice(1), ...topologyTargets].map((target) => ({ ...target, path: requiredPath(target.path, target.targetId) }));
+  const targets = (profile === REPO_HARNESS_PROJECTION_PROFILE ? [...entityTargets, ...topologyTargets] : [FIXED_TARGETS[0], ...entityTargets, ...relationTargets, ...FIXED_TARGETS.slice(1), ...topologyTargets]).map((target) => ({ ...target, path: requiredPath(target.path, target.targetId) }));
   assertUniqueTargets(targets);
   return {
     profile,
     targets,
     expectedPaths: [...new Set([...targets.map((target) => target.path), "docs/architecture/.projection-manifest.json"])].sort(),
+    retiredTargetPaths: profile === REPO_HARNESS_PROJECTION_PROFILE ? FIXED_TARGETS.map((target) => target.path) : [],
     orphanRoots: ["docs/architecture/modules", "docs/architecture/relations"],
     entityPathByNodeId: new Map(entityTargets.map((target, index) => [targetNodes[index].id, target.path]))
   };
@@ -18124,7 +18131,10 @@ function loadArchitectureFilesForLayout(root, layout) {
   }
   if (paths.has(ARCHITECTURE_DOCS_PROJECTION_MANIFEST_PATH)) {
     const manifest = readProjectionOwnedFile(resolve5(root, ARCHITECTURE_DOCS_PROJECTION_MANIFEST_PATH), ARCHITECTURE_DOCS_PROJECTION_MANIFEST_PATH);
-    for (const output of committedGeneratedOutputs(currentFormatManifest(manifest.body))) {
+    const retired = new Set(layout.retiredTargetPaths);
+    for (const output of committedProjectionOutputs(currentFormatManifest(manifest.body))) {
+      if (output.ownership !== "generated" && !retired.has(output.path))
+        continue;
       if (resolveSafeRegularPath(root, output.path, false))
         paths.add(output.path);
     }
@@ -18132,17 +18142,20 @@ function loadArchitectureFilesForLayout(root, layout) {
   return [...paths].sort().map((path) => readProjectionOwnedFile(resolve5(root, path), path));
 }
 var OUTPUT_DIGEST_PATTERN = /^sha256:[a-f0-9]{64}$/;
-function committedGeneratedOutputs(manifest) {
+function committedProjectionOutputs(manifest) {
   if (manifest === undefined)
     return [];
   const outputs = [];
   for (const [targetId, row] of Object.entries(manifest.targets)) {
-    if (row.ownership !== "generated" || !OUTPUT_DIGEST_PATTERN.test(row.outputDigest) || !isRepoRelativePosixPath(row.path) || !row.path.startsWith("docs/architecture/") || row.path === ARCHITECTURE_DOCS_PROJECTION_MANIFEST_PATH)
+    if (!OUTPUT_DIGEST_PATTERN.test(row.outputDigest) || !isRepoRelativePosixPath(row.path) || !row.path.startsWith("docs/architecture/") || row.path === ARCHITECTURE_DOCS_PROJECTION_MANIFEST_PATH)
       continue;
-    outputs.push({ targetId, path: row.path, outputDigest: row.outputDigest });
+    outputs.push({ targetId, path: row.path, ownership: row.ownership, outputDigest: row.outputDigest });
   }
   return outputs;
 }
+function committedGeneratedOutputs(manifest) {
+  return committedProjectionOutputs(manifest).filter((output) => output.ownership === "generated").map(({ targetId, path, outputDigest }) => ({ targetId, path, outputDigest }));
+}
 function currentFormatManifest(body) {
   let parsed;
   try {
@@ -20034,9 +20047,17 @@ class ProjectionPreconditionError extends Error {
 class ProjectionManifestUpgradeRequiredError extends ProjectionPreconditionError {
   schemaVersion;
   reasonCode = PROJECTION_MANIFEST_UPGRADE_REQUIRED;
+  details;
   constructor(schemaVersion) {
-    super(`${PROJECTION_MANIFEST_UPGRADE_REQUIRED}: ${ARCHITECTURE_DOCS_PROJECTION_MANIFEST_PATH} is ${schemaVersion}, and this archctx reads only ${ARCHITECTURE_DOCS_PROJECTION_MANIFEST_SCHEMA_VERSION}; reach a clean projection on the earlier release first, then re-baseline once with archctx docs apply --approved --profile <default|repo-harness/v1>; if that apply names whole-file outputs the earlier release wrote, remove them with git rm and run it again`);
+    super(`${PROJECTION_MANIFEST_UPGRADE_REQUIRED}: ${ARCHITECTURE_DOCS_PROJECTION_MANIFEST_PATH} is ${schemaVersion}, and this archctx reads only ${ARCHITECTURE_DOCS_PROJECTION_MANIFEST_SCHEMA_VERSION}; reach a clean projection on the earlier release first, then re-baseline once with ${ARCHITECTURE_DOCS_PROJECTION_MANIFEST_UPGRADE_COMMAND}; if that apply names whole-file outputs the earlier release wrote, remove them with git rm and run it again; ${ARCHITECTURE_DOCS_PROJECTION_MANIFEST_MIGRATION_GUIDE} lists the model and release preconditions`);
     this.schemaVersion = schemaVersion;
+    this.details = isSupersededArchitectureDocsProjectionManifestSchemaVersion(schemaVersion) ? {
+      manifestPath: ARCHITECTURE_DOCS_PROJECTION_MANIFEST_PATH,
+      foundSchemaVersion: schemaVersion,
+      supportedSchemaVersion: ARCHITECTURE_DOCS_PROJECTION_MANIFEST_SCHEMA_VERSION,
+      upgradeCommand: ARCHITECTURE_DOCS_PROJECTION_MANIFEST_UPGRADE_COMMAND,
+      migrationGuide: ARCHITECTURE_DOCS_PROJECTION_MANIFEST_MIGRATION_GUIDE
+    } : {};
   }
 }
 
@@ -25459,6 +25480,8 @@ function architectureDeltaTask(git) {
 var CODEGRAPH_IMPORT_NODE_READ_LIMIT = 50000;
 var CODEGRAPH_IMPORT_NODE_OUTPUT_BYTES = 4 * 1024;
 function prepareArchitectureDocumentationProjectionSnapshot(root, model, options = {}) {
+  if (codeGraphIndexAvailable(root))
+    assertRepositoryCodeFactsReady(root, options.binary ? { binary: options.binary } : {});
   const baseHeadSha = readProjectionHeadSha(root);
   const sourceFiles = listGitVisibleFiles(root);
   const worktreeDigest = architectureDocumentationProjectionWorktreeDigest(root, model, sourceFiles);
@@ -25603,7 +25626,33 @@ function prepareProjectionCodeFacts(root, model, options) {
     }
   };
 }
+
+class CodeGraphIndexBuildInProgressError extends Error {
+  constructor() {
+    super("CodeGraph index build is in progress");
+    this.name = "CodeGraphIndexBuildInProgressError";
+  }
+}
+function codeGraphIndexBuildInProgress(workspaceRoot) {
+  let raw;
+  try {
+    raw = readFileSync7(join3(workspaceRoot, ".codegraph", "codegraph.lock"), "utf8").trim();
+  } catch {
+    return false;
+  }
+  const pid = Number.parseInt(raw, 10);
+  if (!Number.isSafeInteger(pid) || pid <= 0 || String(pid) !== raw)
+    return false;
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch (error) {
+    return error.code === "EPERM";
+  }
+}
 function readProjectionCodeGraphStatus(invocation, root, timeout, envOverrides) {
+  if (codeGraphIndexBuildInProgress(root))
+    throw new CodeGraphIndexBuildInProgressError;
   const output = runProjectionCodeGraph(invocation, root, ["status", "-j", root], timeout, envOverrides);
   try {
     return JSON.parse(output);
@@ -25922,8 +25971,9 @@ function mirrorCodeGraphInputs(root, gitDir, commonDir, destination) {
 var CODEGRAPH_NO_DOWNLOAD_ENV = { CODEGRAPH_NO_DOWNLOAD: "1" };
 function inspectRepositoryCodeFacts(root, options = {}) {
   const schemaVersion = "archcontext.repository-code-facts/v1";
-  let codeGraphVersion;
+  let codeGraphVersion = "";
   let status;
+  let indexBuildInProgress = false;
   const indexPresent = codeGraphIndexAvailable(root);
   try {
     const invocation = options.binary ? codeGraphCliInvocation(options.binary, root, "") : packagedCodeGraphCliInvocation();
@@ -25931,18 +25981,37 @@ function inspectRepositoryCodeFacts(root, options = {}) {
     if (indexPresent)
       status = readProjectionCodeGraphStatus(invocation, root, options.timeouts?.statusMs ?? 1e4, CODEGRAPH_NO_DOWNLOAD_ENV);
   } catch (error) {
-    return {
-      schemaVersion,
-      state: "unavailable",
-      requiredVersion: REQUIRED_CODEGRAPH_VERSION,
-      reasonCode: "codegraph-unavailable",
-      message: (error instanceof Error ? error.message : String(error)).replace(/\s+/g, " ").trim().slice(0, 400)
-    };
+    if (!(error instanceof CodeGraphIndexBuildInProgressError)) {
+      return {
+        schemaVersion,
+        state: "unavailable",
+        requiredVersion: REQUIRED_CODEGRAPH_VERSION,
+        reasonCode: "codegraph-unavailable",
+        message: (error instanceof Error ? error.message : String(error)).replace(/\s+/g, " ").trim().slice(0, 400)
+      };
+    }
+    indexBuildInProgress = true;
   }
   const versionIssues = codeGraphVersion === REQUIRED_CODEGRAPH_VERSION ? [] : [{ code: "version-mismatch", message: CODE_FACTS_ISSUE_MESSAGES["version-mismatch"] }];
   if (!indexPresent) {
     return { schemaVersion, state: "index-missing", indexPresent: false, requiredVersion: REQUIRED_CODEGRAPH_VERSION, codeGraphVersion, issues: versionIssues };
   }
+  if (indexBuildInProgress) {
+    return {
+      schemaVersion,
+      state: "not-ready",
+      indexPresent: true,
+      requiredVersion: REQUIRED_CODEGRAPH_VERSION,
+      codeGraphVersion,
+      indexBuiltWithVersion: null,
+      extractionVersion: { builtWith: null, current: null },
+      indexState: null,
+      reindexRecommended: null,
+      pendingRefs: null,
+      pendingChanges: null,
+      issues: [...versionIssues, { code: "index-incomplete", message: CODE_FACTS_ISSUE_MESSAGES["index-incomplete"] }]
+    };
+  }
   if (typeof status !== "object" || status === null || Array.isArray(status)) {
     return {
       schemaVersion,
@@ -26329,6 +26398,8 @@ function selectedProducerFailure(error, stage) {
       const details = stage === "docs-anchors" || stage === "flows-check" ? {} : { checks: ["ownership", "anchors"] };
       return new FailureError(selectedProducerData(error, "code"), selectedProducerData(error, "reasonCode"), details);
     }
+    if (error instanceof ProjectionManifestUpgradeRequiredError)
+      return new FailureError("AC_PRECONDITION_FAILED", selectedProducerData(error, "reasonCode"), selectedProducerData(error, "details"));
     if (error instanceof ProjectionPreconditionError)
       return new FailureError("AC_PRECONDITION_FAILED", selectedProducerData(error, "reasonCode"));
     if (error instanceof ProjectionCodeFactsUnavailableError)
@@ -34030,6 +34101,8 @@ function publicOperationFailure(error) {
         failure = toEnvelope("public.operation", undefined, "public-operation").error;
     } else if (error instanceof GitVisibleFilesUnavailableError)
       failure = knownFailure(own2(error, "code"), own2(error, "reasonCode"));
+    else if (error instanceof ProjectionManifestUpgradeRequiredError)
+      failure = knownFailure("AC_PRECONDITION_FAILED", own2(error, "reasonCode"), own2(error, "details"));
     else if (error instanceof ProjectionPreconditionError)
       failure = knownFailure("AC_PRECONDITION_FAILED", own2(error, "reasonCode"));
     else if (error instanceof ProjectionCodeFactsUnavailableError)
@@ -41603,7 +41676,7 @@ function rpcRequiredBoolean(params, index, context, label) {
 function rpcOptionalString(params, index, context, label) {
   const value = params[index];
   if (value === undefined || value === null)
-    return value;
+    return;
   if (typeof value !== "string")
     throw rpcInputInvalid(context, `${label} must be a string`);
   return value;
@@ -41611,7 +41684,7 @@ function rpcOptionalString(params, index, context, label) {
 function rpcOptionalNumber(params, index, context, label) {
   const value = params[index];
   if (value === undefined || value === null)
-    return value;
+    return;
   if (typeof value !== "number" || !Number.isFinite(value))
     throw rpcInputInvalid(context, `${label} must be a number`);
   return value;
@@ -41619,7 +41692,7 @@ function rpcOptionalNumber(params, index, context, label) {
 function rpcOptionalStringArray(params, index, context, label) {
   const value = params[index];
   if (value === undefined || value === null)
-    return value;
+    return;
   if (!Array.isArray(value) || value.some((entry) => typeof entry !== "string"))
     throw rpcInputInvalid(context, `${label} must be an array of strings`);
   return value;
@@ -41636,7 +41709,7 @@ function rpcRequiredObject(params, index, context, label) {
 function rpcOptionalObject(params, index, context, label) {
   const value = params[index];
   if (value === undefined || value === null)
-    return value;
+    return;
   if (!isPlainRpcObject(value))
     throw rpcInputInvalid(context, `${label} must be an object`);
   return value;
@@ -61940,7 +62013,32 @@ function readFilePrefix2(path, length) {
   }
 }
 var CODEGRAPH_IMPORT_NODE_OUTPUT_BYTES2 = 4 * 1024;
+class CodeGraphIndexBuildInProgressError2 extends Error {
+  constructor() {
+    super("CodeGraph index build is in progress");
+    this.name = "CodeGraphIndexBuildInProgressError";
+  }
+}
+function codeGraphIndexBuildInProgress2(workspaceRoot) {
+  let raw;
+  try {
+    raw = readFileSync32(join26(workspaceRoot, ".codegraph", "codegraph.lock"), "utf8").trim();
+  } catch {
+    return false;
+  }
+  const pid = Number.parseInt(raw, 10);
+  if (!Number.isSafeInteger(pid) || pid <= 0 || String(pid) !== raw)
+    return false;
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch (error) {
+    return error.code === "EPERM";
+  }
+}
 function readProjectionCodeGraphStatus2(invocation, root, timeout, envOverrides) {
+  if (codeGraphIndexBuildInProgress2(root))
+    throw new CodeGraphIndexBuildInProgressError2;
   const output = runProjectionCodeGraph2(invocation, root, ["status", "-j", root], timeout, envOverrides);
   try {
     return JSON.parse(output);
@@ -62011,8 +62109,9 @@ var CODEGRAPH_SNAPSHOT_MAX_BYTES2 = 512 * 1024 * 1024;
 var CODEGRAPH_NO_DOWNLOAD_ENV2 = { CODEGRAPH_NO_DOWNLOAD: "1" };
 function inspectRepositoryCodeFacts2(root, options = {}) {
   const schemaVersion = "archcontext.repository-code-facts/v1";
-  let codeGraphVersion;
+  let codeGraphVersion = "";
   let status;
+  let indexBuildInProgress = false;
   const indexPresent = codeGraphIndexAvailable2(root);
   try {
     const invocation = options.binary ? codeGraphCliInvocation2(options.binary, root, "") : packagedCodeGraphCliInvocation2();
@@ -62020,18 +62119,37 @@ function inspectRepositoryCodeFacts2(root, options = {}) {
     if (indexPresent)
       status = readProjectionCodeGraphStatus2(invocation, root, options.timeouts?.statusMs ?? 1e4, CODEGRAPH_NO_DOWNLOAD_ENV2);
   } catch (error) {
-    return {
-      schemaVersion,
-      state: "unavailable",
-      requiredVersion: REQUIRED_CODEGRAPH_VERSION2,
-      reasonCode: "codegraph-unavailable",
-      message: (error instanceof Error ? error.message : String(error)).replace(/\s+/g, " ").trim().slice(0, 400)
-    };
+    if (!(error instanceof CodeGraphIndexBuildInProgressError2)) {
+      return {
+        schemaVersion,
+        state: "unavailable",
+        requiredVersion: REQUIRED_CODEGRAPH_VERSION2,
+        reasonCode: "codegraph-unavailable",
+        message: (error instanceof Error ? error.message : String(error)).replace(/\s+/g, " ").trim().slice(0, 400)
+      };
+    }
+    indexBuildInProgress = true;
   }
   const versionIssues = codeGraphVersion === REQUIRED_CODEGRAPH_VERSION2 ? [] : [{ code: "version-mismatch", message: CODE_FACTS_ISSUE_MESSAGES["version-mismatch"] }];
   if (!indexPresent) {
     return { schemaVersion, state: "index-missing", indexPresent: false, requiredVersion: REQUIRED_CODEGRAPH_VERSION2, codeGraphVersion, issues: versionIssues };
   }
+  if (indexBuildInProgress) {
+    return {
+      schemaVersion,
+      state: "not-ready",
+      indexPresent: true,
+      requiredVersion: REQUIRED_CODEGRAPH_VERSION2,
+      codeGraphVersion,
+      indexBuiltWithVersion: null,
+      extractionVersion: { builtWith: null, current: null },
+      indexState: null,
+      reindexRecommended: null,
+      pendingRefs: null,
+      pendingChanges: null,
+      issues: [...versionIssues, { code: "index-incomplete", message: CODE_FACTS_ISSUE_MESSAGES["index-incomplete"] }]
+    };
+  }
   if (typeof status !== "object" || status === null || Array.isArray(status)) {
     return {
       schemaVersion,