forgeos 0.1.0-alpha.68 → 0.1.0-alpha.69

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "forgeos",
-  "version": "0.1.0-alpha.68",
+  "version": "0.1.0-alpha.69",
   "description": "Agent-native application framework and compiler for building Forge apps without a mandatory dashboard.",
   "type": "module",
   "license": "MIT",
@@ -16,6 +16,11 @@
     "docs/cair-protocol.md",
     "docs/forge-protocol.md",
     "docs/agent-fabric.md",
+    "docs/repository-analysis.md",
+    "docs/repository-context-quality.md",
+    "docs/repository-agent-benchmark.md",
+    "docs/repository-runtime-observation.md",
+    "docs/architecture/agent-fabric/REPOSITORY_MANIFEST_PLAN.md",
     "docs/architecture/agent-fabric/PORTABLE_PROJECTS_PLAN.md",
     "examples/go-billing/",
     "examples/java-billing/",
@@ -53,7 +58,8 @@
     "./vue": "./src/forge/vue/index.ts",
     "./server": "./src/forge/server.ts",
     "./policy": "./src/forge/policy.ts",
-    "./agent-fabric": "./src/forge/agent-fabric/index.ts"
+    "./agent-fabric": "./src/forge/agent-fabric/index.ts",
+    "./repository-analysis": "./src/forge/repository-analysis/index.ts"
   },
   "scripts": {
     "test": "node ./bin/forge-bun.mjs test --timeout 120000",
@@ -111,6 +117,7 @@
     "@electric-sql/pglite": "^0.2.17",
     "@openai/codex-sdk": "0.160.0",
     "@types/react": "^19.2.17",
+    "@vue/compiler-sfc": "3.5.38",
     "ai": "^6.0.205",
     "jose": "^6.2.3",
     "postgres": "^3.4.5",
@@ -120,6 +127,7 @@
     "tsx": "^4.20.6",
     "typescript": "^5.7.3",
     "vue": "^3.5.38",
+    "yaml": "2.9.1",
     "zod": "^3.25.76"
   },
   "devDependencies": {
@@ -133,6 +141,10 @@
     "react-test-renderer": "^19.2.7"
   },
   "overrides": {
+    "@ai-sdk/provider-utils": "4.0.33",
+    "fast-uri": "3.1.8",
+    "nanoid": "3.3.18",
+    "postcss": "8.5.29",
     "read-yaml-file": "^3.0.0"
   }
 }

package/schemas/forge-manifest.schema.json

@@ -1,57 +1,389 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://forgeos.dev/schemas/forge-manifest.schema.json",
-  "title": "Forge external runtime manifest",
-  "type": "object",
-  "required": ["forgeProtocol", "language", "service", "entries"],
-  "properties": {
-    "forgeProtocol": { "const": "1.0" },
-    "language": { "type": "string", "minLength": 1 },
-    "framework": { "type": "string", "minLength": 1 },
-    "service": {
-      "type": "object",
-      "required": ["name", "transport"],
-      "properties": {
-        "name": { "type": "string", "minLength": 1 },
-        "transport": { "enum": ["http", "grpc", "stdio"] },
-        "baseUrl": { "type": "string", "minLength": 1 },
-        "command": { "type": "string", "minLength": 1 },
-        "health": { "type": "string", "minLength": 1 }
-      },
-      "additionalProperties": false
-    },
-    "entries": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "required": ["name", "kind"],
-        "properties": {
-          "name": { "type": "string", "minLength": 1 },
-          "kind": { "enum": ["command", "query"] },
-          "description": { "type": "string" },
-          "path": { "type": "string", "minLength": 1 },
-          "method": { "enum": ["GET", "POST"] },
-          "inputSchema": {},
-          "outputSchema": {},
-          "policy": { "type": "string", "minLength": 1 },
-          "tenantScoped": { "type": "boolean" },
-          "transaction": {
-            "enum": ["read-only", "external-managed", "forge-managed", "saga"]
-          },
-          "risk": { "enum": ["read", "write", "destructive", "external"] },
-          "needsApproval": { "type": "boolean" },
-          "effects": {
-            "type": "array",
-            "items": { "type": "string" }
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://forgeos.dev/schemas/forge-manifest.schema.json",
+  "title": "Forge external runtime manifest",
+  "oneOf": [
+    {
+      "$ref": "#/$defs/service"
+    },
+    {
+      "$ref": "#/$defs/repository"
+    }
+  ],
+  "$defs": {
+    "service": {
+      "type": "object",
+      "required": [
+        "forgeProtocol",
+        "language",
+        "service",
+        "entries"
+      ],
+      "properties": {
+        "forgeProtocol": {
+          "const": "1.0"
+        },
+        "language": {
+          "type": "string",
+          "minLength": 1
+        },
+        "framework": {
+          "type": "string",
+          "minLength": 1
+        },
+        "service": {
+          "type": "object",
+          "required": [
+            "name",
+            "transport"
+          ],
+          "properties": {
+            "name": {
+              "type": "string",
+              "minLength": 1
+            },
+            "transport": {
+              "enum": [
+                "http",
+                "grpc",
+                "stdio"
+              ]
+            },
+            "baseUrl": {
+              "type": "string",
+              "minLength": 1
+            },
+            "command": {
+              "type": "string",
+              "minLength": 1
+            },
+            "health": {
+              "type": "string",
+              "minLength": 1
+            },
+            "commandArgs": {
+              "type": "array",
+              "minItems": 1,
+              "prefixItems": [
+                {
+                  "type": "string",
+                  "minLength": 1
+                }
+              ],
+              "items": {
+                "type": "string"
+              }
+            }
+          },
+          "additionalProperties": false
+        },
+        "entries": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": [
+              "name",
+              "kind"
+            ],
+            "properties": {
+              "name": {
+                "type": "string",
+                "minLength": 1
+              },
+              "kind": {
+                "enum": [
+                  "command",
+                  "query"
+                ]
+              },
+              "description": {
+                "type": "string"
+              },
+              "path": {
+                "type": "string",
+                "minLength": 1
+              },
+              "method": {
+                "enum": [
+                  "GET",
+                  "POST"
+                ]
+              },
+              "inputSchema": {},
+              "outputSchema": {},
+              "policy": {
+                "type": "string",
+                "minLength": 1
+              },
+              "tenantScoped": {
+                "type": "boolean"
+              },
+              "transaction": {
+                "enum": [
+                  "read-only",
+                  "external-managed",
+                  "forge-managed",
+                  "saga"
+                ]
+              },
+              "risk": {
+                "enum": [
+                  "read",
+                  "write",
+                  "destructive",
+                  "external"
+                ]
+              },
+              "needsApproval": {
+                "type": "boolean"
+              },
+              "effects": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              }
+            },
+            "additionalProperties": false
+          }
+        },
+        "schemas": {
+          "type": "object",
+          "additionalProperties": true
+        }
+      },
+      "additionalProperties": false
+    },
+    "repository": {
+      "type": "object",
+      "required": [
+        "forgeProtocol",
+        "kind",
+        "components"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "forgeProtocol": {
+          "const": "2.0"
+        },
+        "kind": {
+          "const": "repository"
+        },
+        "components": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 1000,
+          "items": {
+            "type": "object",
+            "required": [
+              "id",
+              "root",
+              "adapters"
+            ],
+            "additionalProperties": false,
+            "properties": {
+              "id": {
+                "type": "string",
+                "pattern": "^[a-zA-Z0-9][a-zA-Z0-9._-]{0,79}$"
+              },
+              "root": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 4096,
+                "pattern": "^(?!/)(?!.*[:\\u0000-\\u001f])(?!.*\\\\)(?!.*(?:^|/)\\.\\.(?:/|$)).+$"
+              },
+              "adapters": {
+                "type": "array",
+                "minItems": 1,
+                "uniqueItems": true,
+                "items": {
+                  "enum": [
+                    "typescript",
+                    "javascript",
+                    "vue",
+                    "nuxt",
+                    "java",
+                    "spring",
+                    "maven",
+                    "gradle",
+                    "docker"
+                  ]
+                }
+              },
+              "files": {
+                "type": "array",
+                "maxItems": 1000,
+                "items": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 4096,
+                  "pattern": "^(?!/)(?!.*[:\\u0000-\\u001f])(?!.*\\\\)(?!.*(?:^|/)\\.\\.(?:/|$)).+$"
+                }
+              },
+              "analysis": {
+                "type": "object",
+                "additionalProperties": false,
+                "properties": {
+                  "aliases": {
+                    "type": "object", "maxProperties": 100,
+                    "propertyNames": { "type": "string", "pattern": "^(?!__proto__$|prototype$|constructor$)(?!.*(?:^|/)\\.\\.(?:/|$))[A-Za-z_$@~][A-Za-z0-9_$@~./-]{0,127}$" },
+                    "additionalProperties": { "$ref": "#/$defs/repositoryPath" }
+                  },
+                  "nuxt": {
+                    "type": "object", "additionalProperties": false,
+                    "properties": {
+                      "rootDir": { "$ref": "#/$defs/repositoryPath" },
+                      "srcDir": { "$ref": "#/$defs/repositoryPath" },
+                      "components": { "type": "array", "maxItems": 100, "items": { "$ref": "#/$defs/repositoryPath" } },
+                      "imports": { "type": "array", "maxItems": 100, "items": { "$ref": "#/$defs/repositoryPath" } }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        },
+        "exclude": {
+          "type": "array",
+          "maxItems": 1000,
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 4096,
+            "pattern": "^(?!/)(?!.*[:\\u0000-\\u001f])(?!.*\\\\)(?!.*(?:^|/)\\.\\.(?:/|$)).+$"
+          }
+        },
+        "services": {
+          "type": "array",
+          "maxItems": 1000,
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 4096,
+            "pattern": "^(?!/)(?!.*[:\\u0000-\\u001f])(?!.*\\\\)(?!.*(?:^|/)\\.\\.(?:/|$)).+$"
+          }
+        },
+        "checks": {
+          "type": "array",
+          "maxItems": 1000,
+          "items": {
+            "type": "object",
+            "required": [
+              "id",
+              "component",
+              "argv"
+            ],
+            "additionalProperties": false,
+            "properties": {
+              "id": {
+                "type": "string",
+                "pattern": "^[a-zA-Z0-9][a-zA-Z0-9._-]{0,79}$"
+              },
+              "component": {
+                "type": "string",
+                "pattern": "^[a-zA-Z0-9][a-zA-Z0-9._-]{0,79}$"
+              },
+              "argv": {
+                "type": "array",
+                "minItems": 1,
+                "maxItems": 1000,
+                "items": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 4096
+                }
+              },
+              "cwd": { "$ref": "#/$defs/repositoryPath" },
+              "files": { "type": "array", "maxItems": 1000, "items": { "$ref": "#/$defs/repositoryPath" } },
+              "category": { "enum": ["typecheck", "test", "lint", "build", "integration", "security", "other"] },
+              "cost": { "enum": ["low", "medium", "high"] },
+              "requires": {
+                "type": "array", "maxItems": 32, "uniqueItems": true,
+                "items": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9._-]{0,79}$" }
+              }
+            }
+          }
+        },
+        "httpClients": {
+          "type": "array", "maxItems": 1000,
+          "items": {
+            "type": "object", "additionalProperties": false,
+            "required": ["id", "component"],
+            "properties": {
+              "id": { "type": "string", "pattern": "^[A-Za-z_$][A-Za-z0-9_$.-]{0,79}$" },
+              "component": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9._-]{0,79}$" },
+              "apiComponent": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9._-]{0,79}$" },
+              "files": { "type": "array", "maxItems": 1000, "items": { "$ref": "#/$defs/repositoryPath" } },
+              "basePath": { "type": "string", "maxLength": 2048, "pattern": "^/(?!/)(?!.*(?:^|/)\\.\\.(?:/|$))[A-Za-z0-9_~!()*+,;=:@./-]*$" }
+            }
           }
         },
-        "additionalProperties": false
-      }
+        "runtime": {
+          "type": "object", "additionalProperties": false, "required": ["observations"],
+          "properties": { "observations": {
+            "type": "array", "minItems": 1, "maxItems": 32,
+            "items": {
+              "type": "object", "additionalProperties": false, "required": ["id", "component", "commands", "artifacts"],
+              "properties": {
+                "id": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9._-]{0,79}$" },
+                "component": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9._-]{0,79}$" },
+                "commands": { "type": "array", "minItems": 1, "maxItems": 16, "items": {
+                  "type": "object", "additionalProperties": false, "required": ["argv"],
+                  "properties": {
+                    "argv": { "type": "array", "minItems": 1, "maxItems": 128, "items": { "type": "string", "minLength": 1, "maxLength": 4096, "pattern": "^[^\\u0000-\\u001f\\u007f]+$" } },
+                    "cwd": { "$ref": "#/$defs/repositoryPath" },
+                    "timeoutMs": { "type": "integer", "minimum": 100, "maximum": 120000 }
+                  }
+                } },
+                "artifacts": { "type": "array", "minItems": 1, "maxItems": 32, "items": {
+                  "type": "object", "additionalProperties": false, "required": ["path", "format"],
+                  "properties": {
+                    "path": { "$ref": "#/$defs/repositoryPath" },
+                    "format": { "enum": ["nuxt-components", "nuxt-imports", "spring-mappings", "spring-beans", "docker-inspect", "http-trace", "forge-runtime"] }
+                  }
+                } }
+              }
+            }
+          } }
+        },
+        "scenario": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "id": {
+              "type": "string",
+              "pattern": "^[a-zA-Z0-9][a-zA-Z0-9._-]{0,79}$"
+            },
+            "mode": {
+              "type": "string",
+              "pattern": "^[a-zA-Z0-9][a-zA-Z0-9._-]{0,79}$"
+            },
+            "profiles": {
+              "type": "array",
+              "maxItems": 1000,
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 4096
+              }
+            },
+            "composeFiles": {
+              "type": "array",
+              "maxItems": 1000,
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 4096,
+                "pattern": "^(?!/)(?!.*[:\\u0000-\\u001f])(?!.*\\\\)(?!.*(?:^|/)\\.\\.(?:/|$)).+$"
+              }
+            }
+          }
+        }
+      }
     },
-    "schemas": {
-      "type": "object",
-      "additionalProperties": true
+    "repositoryPath": {
+      "type": "string", "minLength": 1, "maxLength": 4096,
+      "pattern": "^(?!/)(?!.*[:\\u0000-\\u001f])(?!.*\\\\)(?!.*(?:^|/)\\.\\.(?:/|$)).+$"
     }
-  },
-  "additionalProperties": false
-}
+  }
+}

package/src/forge/_generated/releaseManifest.json

@@ -1 +1 @@
-{"defaultProvider":"local","diagnostics":[],"env":{"deployEnv":"FORGE_DEPLOY_ENV","deployId":"FORGE_DEPLOY_ID","publicReleaseId":"NEXT_PUBLIC_FORGE_RELEASE_ID","releaseId":"FORGE_RELEASE_ID"},"gitSha":"unknown","optionalProviders":["local","sentry-compatible","sentry","glitchtip","bugsink","otel","custom"],"packageName":"forgeos","packageVersion":"0.1.0-alpha.68","releaseId":"forgeos@0.1.0-alpha.68+unknown","schemaVersion":"0.1.0"}
+{"defaultProvider":"local","diagnostics":[],"env":{"deployEnv":"FORGE_DEPLOY_ENV","deployId":"FORGE_DEPLOY_ID","publicReleaseId":"NEXT_PUBLIC_FORGE_RELEASE_ID","releaseId":"FORGE_RELEASE_ID"},"gitSha":"unknown","optionalProviders":["local","sentry-compatible","sentry","glitchtip","bugsink","otel","custom"],"packageName":"forgeos","packageVersion":"0.1.0-alpha.69","releaseId":"forgeos@0.1.0-alpha.69+unknown","schemaVersion":"0.1.0"}

package/src/forge/_generated/releaseManifest.ts

@@ -1,4 +1,4 @@
-// @forge-generated generator=0.1.0-alpha.68 input=eb85ce79777e8854119a312edd29262099578bdd5f8be82c03b5f0caae80f391 content=146d6370b923fb349aebc9c7cab538dab545ebbadccabe2f67f16e4018c91fb9
+// @forge-generated generator=0.1.0-alpha.69 input=a62f6d9631d76e83840b1f77cac5b6c6e1f6da1acab63d41614e2fe47b9d5ca7 content=358bd274474845d7c2050f21c82cb785f59de808ecbe5c04b8c833969b3f1e10
 export const releaseManifest = {
   "defaultProvider": "local",
   "diagnostics": [],
@@ -19,7 +19,7 @@ export const releaseManifest = {
     "custom"
   ],
   "packageName": "forgeos",
-  "packageVersion": "0.1.0-alpha.68",
-  "releaseId": "forgeos@0.1.0-alpha.68+unknown",
+  "packageVersion": "0.1.0-alpha.69",
+  "releaseId": "forgeos@0.1.0-alpha.69+unknown",
   "schemaVersion": "0.1.0"
 } as const;

package/src/forge/agent-fabric/managed-run-contract.ts

@@ -23,6 +23,7 @@ export interface ManagedStep {
   usage?: { input_tokens: number; cached_input_tokens: number; output_tokens: number };
   artifact?: import("./managed-workspace.ts").ManagedArtifact;
   environment?: import("./managed-environment.ts").ManagedEnvironment;
+  repositoryContext?: import("./repository-context.ts").FabricRepositoryContextMetadata;
 }
 export interface ManagedRunState {
   schemaVersion: 1; runId: string; repositoryRoot: string; ownerPid: number; version: number;

package/src/forge/agent-fabric/managed-run-service.ts

@@ -9,6 +9,7 @@ import {
 import { ManagedRunStore } from "./managed-run-store.ts";
 import { runCodexWorker, type CodexWorkerInput, type CodexWorkerOutput, codexWorkerEnvironment } from "./codex-sdk-worker.ts";
 import { prepareManagedEnvironment } from "./managed-environment.ts";
+import { prepareFabricRepositoryContext } from "./repository-context.ts";
 import {
   captureManagedBase, prepareManagedWorkspace, captureManagedArtifact, publishManagedArtifacts,
   previewManagedArtifacts, confirmManagedPublication, confirmManagedBaseline, type ManagedArtifact,
@@ -298,9 +299,17 @@ export class ManagedRunService {
       if (this.closed || controller.signal.aborted) managedFail("AF_RUN_ABORTED", "Worker canceled during environment preparation");
       let report: ManagedStep["report"], usage: ManagedStep["usage"], threadId: string | undefined, outputDigest: string;
       if (executor.type === "codex") {
+        const repository = await prepareFabricRepositoryContext(state.repositoryRoot, prepared.directory, executor.prompt ?? state.spec.goal, executor.writeScope ?? state.spec.scope);
+        if (this.closed || controller.signal.aborted) managedFail("AF_RUN_ABORTED", "Worker canceled during repository analysis");
+        if (repository) await this.update(runId, current => {
+          const step = current.steps.find(item => item.attemptId === attemptId)!;
+          if (this.closed || controller.signal.aborted || step.status !== "running") return;
+          step.repositoryContext = repository.metadata;
+          event(current, "repository.context", `Repository maps ${repository.metadata.status} for prepared clone`, { nodeId, attemptId });
+        });
         const previous = [...state.steps].reverse().find(step => step.nodeId === nodeId && step.threadId);
         const output = await (this.options.worker ?? runCodexWorker)({ cwd: prepared.directory, role: executor.role!, model: executor.model, threadId: previous?.threadId, signal: controller.signal,
-          prompt: `${executor.prompt}\n\nTask goal: ${state.spec.goal}\nYour current checkout: ${prepared.directory}\nActual input snapshot: ${prepared.inputDigest}\nWrite scope: ${JSON.stringify(executor.writeScope ?? [])}. Do not change files outside it. Do not commit, publish, deploy, install packages or send external messages. Dependencies already applied to this checkout. Reports from dependencies: ${JSON.stringify(applicableSteps(state).filter(step => state.workflow.nodes.find(node => node.nodeId === nodeId)!.dependsOn.includes(step.nodeId)).map(step => ({ nodeId: step.nodeId, summary: step.summary, report: step.report })))}\nCoordinator instructions for this attempt: ${state.instructions.join("\n")}`,
+          prompt: `${executor.prompt}\n\nTask goal: ${state.spec.goal}\nYour current checkout: ${prepared.directory}\nActual input snapshot: ${prepared.inputDigest}\nWrite scope: ${JSON.stringify(executor.writeScope ?? [])}. Do not change files outside it. Do not commit, publish, deploy, install packages or send external messages. Dependencies already applied to this checkout. Reports from dependencies: ${JSON.stringify(applicableSteps(state).filter(step => state.workflow.nodes.find(node => node.nodeId === nodeId)!.dependsOn.includes(step.nodeId)).map(step => ({ nodeId: step.nodeId, summary: step.summary, report: step.report })))}\nCoordinator instructions for this attempt: ${state.instructions.join("\n")}${repository ? `\n\n${repository.prompt}` : ""}`,
           onEvent: async notification => {
             if (this.closed || controller.signal.aborted) return;
             await this.update(runId, current => {

package/src/forge/agent-fabric/managed-run-store.ts

@@ -48,6 +48,26 @@ function validateState(state: ManagedRunState, root: string, runId: string) {
     managedId(step.attemptId, "attemptId"); managedId(step.nodeId, "nodeId");
     assert(["running", "succeeded", "failed", "uncertain"].includes(step.status) && state.workflow.runs.some(run => run.attemptId === step.attemptId && run.nodeId === step.nodeId && run.status === step.status), "Step attempt mismatch");
     assert(step.directory === undefined || (isAbsolute(step.directory) && resolve(step.directory) === step.directory), "Invalid workspace directory");
+    if (step.repositoryContext !== undefined) {
+      const context = step.repositoryContext;
+      assert(context && Object.keys(context).every(key => ["provider", "phase", "status", "sourceRoot", "cloneRoot", "snapshotId", "diagnostics", "quality", "runtime"].includes(key)), "Invalid repository context fields");
+      assert(context.provider === "repository" && context.phase === "prepared-input" && ["ready", "unavailable"].includes(context.status) && context.sourceRoot === root && context.cloneRoot === step.directory, "Repository context belongs to another checkout");
+      assert(Array.isArray(context.diagnostics) && context.diagnostics.length <= 20 && context.diagnostics.every(message => typeof message === "string" && message.length <= 512), "Invalid repository context diagnostics");
+      assert(context.snapshotId === undefined || (typeof context.snapshotId === "string" && context.snapshotId.length <= 256 && context.snapshotId.length > 0), "Invalid repository context snapshot");
+      assert(context.status !== "ready" || context.snapshotId !== undefined, "Ready repository context requires a snapshot");
+      if (context.runtime !== undefined) {
+        const runtime = context.runtime;
+        assert(runtime && Object.keys(runtime).every(key => ["reportId", "environmentId", "phase"].includes(key))
+          && context.status === "ready" && runtime.phase === "source-observed-matching-input"
+          && typeof runtime.reportId === "string" && runtime.reportId.length > 0 && runtime.reportId.length <= 128
+          && /^[a-zA-Z0-9][a-zA-Z0-9._-]{0,79}$/.test(runtime.environmentId), "Invalid runtime repository evidence metadata");
+      }
+      if (context.quality !== undefined) {
+        const quality = context.quality, counts = ["factsReused", "unresolvedLocalImports", "unresolvedUiReferences", "dynamicHttpCalls", "httpEndpointLinks", "analysisErrors"] as const;
+        assert(quality && Object.keys(quality).every(key => ["completeness", "runtimeObserved", ...counts].includes(key))
+          && quality.completeness === "partial" && quality.runtimeObserved === false && counts.every(key => Number.isSafeInteger(quality[key]) && quality[key] >= 0 && quality[key] <= 1_000_000), "Invalid static repository quality");
+      }
+    }
   }
   assert(Number.isSafeInteger(state.cursor) && state.cursor >= 0 && Array.isArray(state.events) && state.events.length <= 10000, "Invalid event history");
   let cursor = 0; for (const event of state.events) { assert(Number.isSafeInteger(event.cursor) && event.cursor > cursor && event.cursor <= state.cursor && typeof event.summary === "string" && typeof event.type === "string" && Number.isFinite(Date.parse(event.at)), "Invalid event"); cursor = event.cursor; }