motionloom 2.1.0 → 2.2.0

package/docs/releases/npm-publish-from-workstation.md

@@ -1,6 +1,6 @@
 # Publish MotionLoom to npm from your workstation
 
-This guide publishes the prepared `motionloom@2.1.0` package from your own computer. The npm password, authenticator code and access token must stay on your computer; never paste them into chat, GitHub issues or repository files.
+This guide publishes the prepared `motionloom@2.2.0` package from your own computer. The npm password, authenticator code and access token must stay on your computer; never paste them into chat, GitHub issues or repository files.
 
 ## 1. Install prerequisites
 
@@ -48,7 +48,7 @@ npm pack --dry-run --json --ignore-scripts
 npm publish --dry-run --access public
 ```
 
-The dry-run should report `motionloom@2.1.0`, public access, and the current package file list. Do not hard-code a historical file count: inspect the JSON output and compare it with the checked-in package allowlist. The prepack hook removes generated Python bytecode before packaging. Do not publish if the dry-run shows private keys, `.env` files, `artifacts/`, `dev-lab/` or `__pycache__/` entries.
+The dry-run should report `motionloom@2.2.0`, public access, and the current package file list. Do not hard-code a historical file count: inspect the JSON output and compare it with the checked-in package allowlist. The prepack hook removes generated Python bytecode before packaging. Do not publish if the dry-run shows private keys, `.env` files, `artifacts/`, `dev-lab/` or `__pycache__/` entries.
 
 ## 5. Publish the package
 
@@ -58,15 +58,15 @@ When the dry-run is correct and `npm whoami` shows the intended account, publish
 npm publish --access public
 ```
 
-The version `2.1.0` becomes immutable on npm after a successful publish. If npm reports that the version already exists, stop and verify the registry instead of trying to overwrite it.
+The version `2.2.0` becomes immutable on npm after a successful publish. If npm reports that the version already exists, stop and verify the registry instead of trying to overwrite it.
 
 ## 6. Verify the registry publication
 
-Run the following commands and confirm that they return `2.1.0` and a tarball URL:
+Run the following commands and confirm that they return `2.2.0` and a tarball URL:
 
 ```bash
 npm view motionloom version --registry=https://registry.npmjs.org/
-npm view motionloom@2.1.0 name version license dist.tarball dist.shasum --json \
+npm view motionloom@2.2.0 name version license dist.tarball dist.shasum --json \
   --registry=https://registry.npmjs.org/
 ```
 
@@ -76,7 +76,7 @@ Then test installation in a clean temporary directory:
 TMP_DIR="$(mktemp -d)"
 cd "$TMP_DIR"
 npm init --yes
-npm install motionloom@2.1.0
+npm install motionloom@2.2.0
 motionloom --help
 motionloom doctor
 ```

package/examples/agent-consumer/README.md

@@ -0,0 +1,18 @@
+# Agent consumer fixtures
+
+This example set is a small, machine-readable map of how an Agent should consume MotionLoom. It is intentionally not a fake demo application and it does not claim user approval. Each case points to a repository artifact or a real runtime harness and states its evidence level.
+
+Run the offline contract checks first:
+
+```text
+motionloom discovery check --root . --json
+python3 tests/scripts/test_consumer_fixtures.py
+```
+
+For the browser-backed runtime cases, install the repository dependencies and run:
+
+```text
+npm run runtime:test
+```
+
+The real runtime harness emits deterministic scrub points at 0/50/100% for Rive, GSAP and Framer Motion. The Lottie and dotLottie cases are asset/package contracts; they must not be described as runtime-verified unless corresponding runtime evidence exists in the task bundle. The body-rig and continuity cases exercise structure and cross-scene semantics.

package/examples/agent-consumer/fixture-manifest.json

@@ -0,0 +1,82 @@
+{
+  "schema_version": "1.0",
+  "fixture_set": "agent-consumer-smoke",
+  "purpose": "Show Agents how to select an animation capability, locate evidence and preserve review boundaries.",
+  "repository_root": "..",
+  "cases": [
+    {
+      "id": "lottie-json-source-bound",
+      "framework": "lottie",
+      "category": "asset-runtime",
+      "source": "src/output/browser-review-smoke/animation.json",
+      "manifest": "src/output/browser-review-smoke/manifest.json",
+      "verification": "python3 scripts/validate-lottie.py src/output/browser-review-smoke/animation.json",
+      "evidence_level": "asset-contract",
+      "expected": "source_binding and Lottie structural validation; runtime acceptance still requires runtime evidence"
+    },
+    {
+      "id": "dotlottie-package",
+      "framework": "dotlottie",
+      "category": "asset-package",
+      "source": "src/output/browser-review-smoke/animation.json",
+      "manifest": "src/output/browser-review-smoke/manifest.json",
+      "verification": "node scripts/to-dotlottie.mjs --scene-dir src/output/browser-review-smoke --output <temporary-output>/animation.lottie",
+      "evidence_level": "package-contract",
+      "expected": "manifest.json selects the initial animation and the archive validates without system zip"
+    },
+    {
+      "id": "rive-runtime",
+      "framework": "rive",
+      "category": "browser-runtime",
+      "source": "tests/runtime-harness/main.jsx",
+      "evidence": "artifacts/runtime-adapters/rive/runtime-evidence.json",
+      "verification": "RUNTIME_FRAMEWORKS=rive npm run runtime:test",
+      "evidence_level": "runtime-verified-fixture",
+      "expected": "real browser adapter, ready=true, runtime state and 0/50/100 snapshots"
+    },
+    {
+      "id": "gsap-runtime",
+      "framework": "gsap",
+      "category": "browser-runtime",
+      "source": "tests/runtime-harness/main.jsx",
+      "evidence": "artifacts/runtime-adapters/gsap/runtime-evidence.json",
+      "verification": "RUNTIME_FRAMEWORKS=gsap npm run runtime:test",
+      "evidence_level": "runtime-verified-fixture",
+      "expected": "real browser adapter, ready=true, runtime state and 0/50/100 snapshots"
+    },
+    {
+      "id": "framer-motion-runtime",
+      "framework": "framer-motion",
+      "category": "browser-runtime",
+      "source": "tests/runtime-harness/main.jsx",
+      "evidence": "artifacts/runtime-adapters/framer-motion/runtime-evidence.json",
+      "verification": "RUNTIME_FRAMEWORKS=framer-motion npm run runtime:test",
+      "evidence_level": "runtime-verified-fixture",
+      "expected": "real browser adapter, ready=true, runtime state and 0/50/100 snapshots"
+    },
+    {
+      "id": "body-rig",
+      "framework": "svg-cutout-rig",
+      "category": "body-animation",
+      "source": "assets/library/avatar-base.svg",
+      "verification": "python3 src/rig/cutout_rig.py build --input assets/library/avatar-base.svg --output <temporary-output>/rigged.svg",
+      "evidence_level": "structure-verified-fixture",
+      "expected": "named anatomy, pivot markers and parent-first hierarchy remain inspectable"
+    },
+    {
+      "id": "continuity-multiscene",
+      "framework": "framework-neutral",
+      "category": "continuity",
+      "source": "tests/fixtures/continuity-multiscene",
+      "evidence": "tests/fixtures/continuity-multiscene/continuity-report.json",
+      "verification": "python3 scripts/intelligence.py continuity validate --report tests/fixtures/continuity-multiscene/continuity-report.json",
+      "evidence_level": "semantic-structure-fixture",
+      "expected": "scene-01 and scene-02 share continuity while scene-02-drift remains an explicit negative case"
+    }
+  ],
+  "review_boundary": {
+    "approval": false,
+    "user_review_required": true,
+    "pr_side_effects": "explicit-confirmation"
+  }
+}

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "motionloom",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "type": "module",
   "packageManager": "pnpm@11.20.0",
-  "description": "MotionLoom: project-aware animation Skill with graph, provenance, Motion IR, runtime telemetry, DSSE-compatible signed attestation, external evidence verification and Dev Lab review.",
+  "description": "MotionLoom: project-aware animation Skill with Agent interoperability, graph, provenance, Motion IR, runtime telemetry, Visual Truth, Remediation Learning, DSSE-compatible signed attestation, external evidence verification and Dev Lab review.",
   "author": "lenhonbp",
   "bin": {
     "motionloom": "bin/motionloom.mjs"
@@ -32,7 +32,12 @@
     "tests/evals",
     "tests/scripts/run_tests.py",
     "tests/scripts/test_attestation.py",
-    "tests/scripts/test_project_memory.py"
+    "tests/scripts/test_project_memory.py",
+    ".agents",
+    ".claude",
+    ".codex",
+    "AGENTS.md",
+    "agent-surfaces.json"
   ],
   "keywords": [
     "animation",
@@ -50,7 +55,10 @@
     "provenance",
     "attestation",
     "browser-review",
-    "dev-lab"
+    "dev-lab",
+    "visual-truth",
+    "remediation-learning",
+    "agent-interoperability"
   ],
   "repository": {
     "type": "git",
@@ -70,7 +78,7 @@
   "scripts": {
     "prepack": "node scripts/prepack-clean.mjs",
     "test": "node bin/motionloom.mjs test",
-    "validate": "node bin/motionloom.mjs quality-gate --all",
+    "validate": "npm run quality:attestation",
     "doctor": "node bin/motionloom.mjs doctor --json",
     "docs:check": "python3 scripts/docs-audit.py",
     "eval:projects": "python3 scripts/eval-projects.py --allow-insufficient",
@@ -99,9 +107,16 @@
     "attestation:policy": "node bin/motionloom.mjs attestation validate-policy",
     "attestation:keygen": "node bin/motionloom.mjs attestation-keygen",
     "quality:telemetry": "node bin/motionloom.mjs quality-gate --scene browser-review-smoke --context artifacts/browser-review-smoke-task/project-context.json --task-dir artifacts/browser-review-smoke-task --require-browser-review --require-intelligence --require-p1 --require-benchmark --require-telemetry",
-    "quality:attestation": "node bin/motionloom.mjs quality-gate --scene browser-review-smoke --context artifacts/browser-review-smoke-task/project-context.json --task-dir artifacts/browser-review-smoke-task --require-browser-review --require-intelligence --require-p1 --require-benchmark --require-telemetry --require-attestation",
+    "quality:attestation": "node bin/motionloom.mjs quality-gate --scene browser-review-smoke --context artifacts/browser-review-smoke-task/project-context.json --task-dir artifacts/browser-review-smoke-task --require-browser-review --require-intelligence --require-p1 --require-benchmark --require-telemetry --require-attestation --require-visual-truth",
     "pack:dotlottie": "node scripts/to-dotlottie.mjs",
-    "runtime:test": "node scripts/runtime-adapters.mjs"
+    "runtime:test": "node scripts/runtime-adapters.mjs",
+    "visual-truth:build": "node bin/motionloom.mjs visual-truth build",
+    "visual-truth:check": "node bin/motionloom.mjs visual-truth validate --root . --input src/output/browser-review-smoke/visual-truth.json",
+    "remediation:validate": "node bin/motionloom.mjs remediation-learning validate --history artifacts/remediation-history.jsonl --json",
+    "remediation:summary": "node bin/motionloom.mjs remediation-learning summary --history artifacts/remediation-history.jsonl --output artifacts/remediation-summary.json --json",
+    "discovery:check": "node bin/motionloom.mjs discovery check --root . --json",
+    "discovery:show": "node bin/motionloom.mjs discovery show --root . --json",
+    "install:matrix": "node bin/motionloom.mjs discovery install-matrix --root . --json"
   },
   "dependencies": {
     "@lottiefiles/dotlottie-web": "^0.79.0",

package/references/agent-interoperability.md

@@ -0,0 +1,29 @@
+# Agent interoperability reference
+
+Read this reference when installing MotionLoom into a new Agent environment or when adding a new discovery surface.
+
+## Contract hierarchy
+
+1. `SKILL.md` is the canonical workflow and must stay below the skill context budget.
+2. `agent-card.json` is the machine-readable capability and side-effect contract.
+3. `agent-surfaces.json` is the discovery/install/compatibility contract.
+4. `.agents/skills`, `.claude`, `.codex` and `AGENTS.md` are short routers that point to the canonical sources.
+5. `docs/AGENT-INTEGRATION.md` is user-facing installation and troubleshooting documentation.
+
+Do not put divergent workflow rules into an Agent-specific file. Add reusable domain detail to `references/` or `docs/`, then update the canonical Skill navigation.
+
+## Discovery check output
+
+The JSON result contains `status`, `source`, `surface_count`, `installation_count`, `errors` and `warnings`. `status=pass` means the local package has the expected files and contract values. It does not assert that the host project has been analyzed, that runtime dependencies are installed, that a candidate rendered correctly or that a user approved a change.
+
+## Adding a new Agent surface
+
+Add one manifest entry with a safe relative path, a supported agent identifier, `canonical: SKILL.md` and either `load_mode: alias` or `load_mode: router`. Create a short file at that path. Add or update the installation/discovery test and run `motionloom discovery check --root . --json`, `python3 scripts/docs-audit.py` and the full test suite. Never silently overwrite an existing surface with a copied version of `SKILL.md`.
+
+## Source and version binding
+
+When a user reports a discovery issue, capture the package version, source kind, resolved path, Git remote/commit where available and the discovery JSON. Treat a version mismatch as a structural problem, not as a runtime animation failure. Do not use network access in the check command; registry/Git availability belongs to the installation step.
+
+## Approval boundary
+
+Discovery is deliberately orthogonal to approval. The discovery command can only tell an Agent how to load MotionLoom. It cannot transition an animation task to `ready_for_pr` or `confirmed`, and it cannot change `approval` from `false` to `true`.

package/references/intelligence-core.md

@@ -15,6 +15,8 @@ Use this reference when an Agent needs to understand or extend MotionLoom's task
 | `semantic-lint-benchmark.json` | `python3 scripts/intelligence.py semantic-lint benchmark --task-dir <task>` | Measures in-process semantic-lint execution, rule coverage and p95 against a deterministic threshold; it is a performance contract, not visual approval. |
 | `runtime-telemetry.json` | `motionloom runtime-telemetry <scene> artifacts/<task-id>` | Records deterministic scrub-point observations, RAF timing, runtime state hashes and source/manifest/Motion IR bindings from the real adapter harness. The npm CLI is the cross-platform entrypoint; the legacy `.sh` wrapper remains for Unix compatibility. |
 | `evidence-verifier-report.json` | `python3 scripts/evidence-verifier.py --scene-dir <scene-dir> --task-dir <task> --runtime-evidence <path>` | Read-only external verification result for task/scene/path/hash/age integrity; `approval` is always `false`. |
+| `visual-truth.json` | `motionloom visual-truth build|validate` | Baseline/candidate PNG hashes, dimensions, deterministic comparison signal, region-level review explanation and source/runtime/Motion IR provenance; `approval` is always `false`. |
+| `remediation-history.jsonl` | `motionloom remediation-learning record-outcome|record-benchmark|summary` | Append-only, hash-chained user-confirmed corrections and deterministic benchmark runs; first-pass metrics guide future work but `approval` is always `false`. |
 | `attestation-statement.json` | `python3 scripts/attestation.py statement --scene-dir <scene-dir> --task-dir <task> --context <context>` | Derives canonical task/scene/source/manifest/Motion IR/evidence hash bindings before signing. |
 | `attestation.json` | `python3 scripts/attestation.py build --statement <statement> --private-key <key> --key-id <id>` | DSSE-compatible Ed25519 envelope over the versioned statement; `approval` is always `false`. |
 | `trust-policy.json` | `python3 scripts/attestation.py validate-policy --path <policy>` | Declares trusted keys, validity, rotation and fail-closed revocation behavior. |
@@ -71,6 +73,8 @@ python3 scripts/quality-gate.py \
   --context <project-context.json> \
   --task-dir artifacts/<task-id> \
   --require-browser-review --require-intelligence --require-p1 --require-benchmark --require-telemetry --require-attestation
+python3 scripts/remediation-learning.py validate --history artifacts/remediation-history.jsonl --json
+python3 scripts/remediation-learning.py summary --history artifacts/remediation-history.jsonl --output artifacts/remediation-summary.json --json
 python3 scripts/eval-intelligence.py
 ```
 

package/schemas/agent-surfaces.schema.json

@@ -0,0 +1,78 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://motionloom.dev/schemas/agent-surfaces.schema.json",
+  "title": "MotionLoom Agent Surfaces",
+  "type": "object",
+  "required": ["schema_version", "name", "version", "canonical", "surfaces", "installations", "compatibility", "rules"],
+  "properties": {
+    "schema_version": {"const": "1.0"},
+    "name": {"const": "motionloom"},
+    "version": {"type": "string", "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$"},
+    "canonical": {
+      "type": "object",
+      "required": ["skill", "agent_card", "cli"],
+      "properties": {
+        "skill": {"const": "SKILL.md"},
+        "agent_card": {"const": "agent-card.json"},
+        "cli": {"const": "bin/motionloom.mjs"}
+      },
+      "additionalProperties": false
+    },
+    "surfaces": {
+      "type": "array",
+      "minItems": 4,
+      "items": {
+        "type": "object",
+        "required": ["id", "kind", "path", "canonical", "load_mode", "agents"],
+        "properties": {
+          "id": {"type": "string", "pattern": "^[a-z0-9-]+$"},
+          "kind": {"type": "string", "enum": ["agent-skill", "agent-instructions", "repository-guide"]},
+          "path": {"type": "string", "pattern": "^(?!/)(?!.*(?:^|/)\\.\\.(?:/|$)).+$"},
+          "canonical": {"const": "SKILL.md"},
+          "load_mode": {"type": "string", "enum": ["alias", "router"]},
+          "agents": {"type": "array", "minItems": 1, "items": {"type": "string"}}
+        },
+        "additionalProperties": false
+      }
+    },
+    "installations": {
+      "type": "array",
+      "minItems": 3,
+      "items": {
+        "type": "object",
+        "required": ["id", "source_kind", "command", "verification", "provenance"],
+        "properties": {
+          "id": {"type": "string"},
+          "source_kind": {"type": "string", "enum": ["npm", "git", "local"]},
+          "command": {"type": "string"},
+          "verification": {"type": "string"},
+          "provenance": {"type": "string"}
+        },
+        "additionalProperties": false
+      }
+    },
+    "compatibility": {
+      "type": "object",
+      "required": ["operating_systems", "node", "python", "agents"],
+      "properties": {
+        "operating_systems": {"type": "array", "items": {"type": "string"}},
+        "node": {"type": "string"},
+        "python": {"type": "string"},
+        "agents": {"type": "array", "items": {"type": "string"}}
+      },
+      "additionalProperties": false
+    },
+    "rules": {
+      "type": "object",
+      "required": ["canonical_instruction_source", "no_surface_copy", "no_network_required_for_check", "approval_is_never_inferred"],
+      "properties": {
+        "canonical_instruction_source": {"const": "SKILL.md"},
+        "no_surface_copy": {"const": true},
+        "no_network_required_for_check": {"const": true},
+        "approval_is_never_inferred": {"const": true}
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/remediation-history.schema.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/lenhonbp/MotionLoom/blob/main/schemas/remediation-history.schema.json",
+  "title": "MotionLoom remediation and benchmark history event",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["schema_version", "event_id", "event_type", "recorded_at", "previous_event_sha256", "event_sha256"],
+  "properties": {
+    "schema_version": {"const": "0.1"},
+    "event_id": {"type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{2,127}$"},
+    "event_type": {"type": "string", "enum": ["remediation_outcome", "benchmark_run"]},
+    "recorded_at": {"type": "string", "format": "date-time"},
+    "previous_event_sha256": {"type": ["string", "null"], "pattern": "^[a-f0-9]{64}$"},
+    "event_sha256": {"type": "string", "pattern": "^[a-f0-9]{64}$"},
+    "user_confirmed": {"type": "boolean"},
+    "first_pass_accepted": {"type": "boolean"},
+    "correction_count": {"type": "integer", "minimum": 0},
+    "result": {"type": "string", "enum": ["pass", "fail", "partial", "unknown"]},
+    "status": {"type": "string", "enum": ["pass", "fail"]},
+    "p95_ms": {"type": "number", "minimum": 0},
+    "threshold_ms": {"type": "number", "exclusiveMinimum": 0}
+  }
+}

package/schemas/scene-manifest.schema.json

@@ -11,6 +11,7 @@
     "category": {"type": "string", "minLength": 1},
     "file": {"type": "string", "minLength": 1, "pattern": "^(?!/)(?!.*\\.\\.).+$"},
     "runtime_evidence": {"type": "string", "minLength": 1, "pattern": "^(?!/)(?!.*\\.\\.).+$"},
+    "visual_truth": {"type": "string", "minLength": 1, "pattern": "^(?!/)(?!.*\\.\\.).+$"},
     "source_binding": {
       "type": "object",
       "required": ["kind", "source_path", "authority", "license", "sha256"],

package/schemas/visual-truth.schema.json

@@ -0,0 +1,80 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/lenhonbp/MotionLoom/blob/main/schemas/visual-truth.schema.json",
+  "title": "MotionLoom Visual Truth Contract",
+  "type": "object",
+  "required": ["schema_version", "contract", "status", "scene", "frames", "comparison", "provenance", "review_boundary"],
+  "properties": {
+    "schema_version": {"const": "1.0"},
+    "contract": {"const": "motionloom-visual-truth"},
+    "status": {"enum": ["pass", "review_required"]},
+    "scene": {"type": "string", "minLength": 1},
+    "task_id": {"type": ["string", "null"]},
+    "frames": {
+      "type": "object",
+      "required": ["baseline", "candidate"],
+      "properties": {
+        "baseline": {"$ref": "#/$defs/frame"},
+        "candidate": {"$ref": "#/$defs/frame"}
+      },
+      "additionalProperties": false
+    },
+    "comparison": {
+      "type": "object",
+      "required": ["metric", "same_dimensions", "byte_identical", "changed", "interpretation"],
+      "properties": {
+        "metric": {"type": "string"},
+        "same_dimensions": {"type": "boolean"},
+        "byte_identical": {"type": "boolean"},
+        "changed": {"type": "boolean"},
+        "distance": {"type": "number", "minimum": 0},
+        "threshold": {"type": "number", "minimum": 0},
+        "interpretation": {"enum": ["equal", "review_required"]}
+      },
+      "additionalProperties": true
+    },
+    "regions": {"type": "array"},
+    "provenance": {
+      "type": "object",
+      "required": ["source_path", "source_sha256", "manifest_path", "manifest_sha256"],
+      "properties": {
+        "source_path": {"type": "string", "pattern": "^(?!/)(?!.*\\.\\.).+$"},
+        "source_sha256": {"type": "string", "pattern": "^[a-f0-9]{64}$"},
+        "manifest_path": {"type": "string", "pattern": "^(?!/)(?!.*\\.\\.).+$"},
+        "manifest_sha256": {"type": "string", "pattern": "^[a-f0-9]{64}$"},
+        "runtime_evidence_path": {"type": ["string", "null"]},
+        "runtime_evidence_sha256": {"type": ["string", "null"]},
+        "motion_ir_path": {"type": ["string", "null"]},
+        "motion_ir_sha256": {"type": ["string", "null"]}
+      },
+      "additionalProperties": true
+    },
+    "review_boundary": {
+      "type": "object",
+      "required": ["approval", "user_review_required", "decision"],
+      "properties": {
+        "approval": {"const": false},
+        "user_review_required": {"const": true},
+        "decision": {"const": "pending"}
+      },
+      "additionalProperties": true
+    }
+  },
+  "$defs": {
+    "frame": {
+      "type": "object",
+      "required": ["role", "percent", "path", "sha256", "bytes", "width", "height"],
+      "properties": {
+        "role": {"enum": ["baseline", "candidate"]},
+        "percent": {"type": "integer", "minimum": 0, "maximum": 100},
+        "path": {"type": "string", "pattern": "^(?!/)(?!.*\\.\\.).+$"},
+        "sha256": {"type": "string", "pattern": "^[a-f0-9]{64}$"},
+        "bytes": {"type": "integer", "minimum": 1},
+        "width": {"type": "integer", "minimum": 1},
+        "height": {"type": "integer", "minimum": 1}
+      },
+      "additionalProperties": true
+    }
+  },
+  "additionalProperties": true
+}

package/scripts/devlab.py

@@ -19,7 +19,7 @@ TASK_ARTIFACTS = (
     "issue-register.json", "decision-log.jsonl", "project-memory.json",
     "project-graph.json", "provenance.json", "capability-registry.json",
     "motion-ir.json", "replay-bundle.json", "semantic-lint-report.json",
-    "continuity-report.json", "fix-plan.json", "browser-observation.md",
+    "continuity-report.json", "fix-plan.json", "visual-truth.json", "browser-observation.md",
 )