@ztothez/design-engineering 2.0.0

package/knowledge-base/benchmarks/portfolio-corpus/product-task-profile.schema.yaml

@@ -0,0 +1,105 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: https://ztothez.dev/schemas/product-task-profile-1.1.schema.json
+title: ZtotheZ Design Engineering Product Task Profile
+type: object
+additionalProperties: false
+required: [archetype, interface, qualityDimensions, tasks, evidencePolicy, comparison]
+properties:
+  archetype:
+    enum: [operational-dashboard, ai-workspace, content-site, utility, full-stack-workflow]
+  interface: { enum: [browser, desktop, source-only] }
+  qualityDimensions:
+    type: array
+    minItems: 7
+    maxItems: 7
+    items: { $ref: "#/$defs/qualityDimension" }
+  tasks:
+    type: array
+    minItems: 1
+    maxItems: 50
+    items: { $ref: "#/$defs/task" }
+  evidencePolicy:
+    type: object
+    additionalProperties: false
+    required: [missingEvidence, failedBehavior, unsupportedCapability]
+    properties:
+      missingEvidence: { const: unverified }
+      failedBehavior: { const: failed }
+      unsupportedCapability: { const: limitation }
+  comparison:
+    type: object
+    additionalProperties: false
+    required: [taskContractId, crossContractRanking]
+    properties:
+      taskContractId: { $ref: "#/$defs/id" }
+      crossContractRanking: { const: false }
+$defs:
+  id:
+    type: string
+    pattern: "^[a-z0-9][a-z0-9-]{0,63}$"
+  text:
+    type: string
+    minLength: 1
+    maxLength: 1024
+  state:
+    type: object
+    additionalProperties: false
+    required: [stateMachine, state, observable]
+    properties:
+      stateMachine: { $ref: "#/$defs/id" }
+      state: { $ref: "#/$defs/id" }
+      observable: { $ref: "#/$defs/text" }
+  qualityDimension:
+    type: object
+    additionalProperties: false
+    required: [id, status, reason]
+    properties:
+      id:
+        enum: [truthful-disclosure, information-design, visual-system, accessibility, responsive-structure, state-integrity, maintainability]
+      status: { enum: [required, not-applicable] }
+      reason: { type: string, minLength: 1, maxLength: 512 }
+  task:
+    type: object
+    additionalProperties: false
+    required: [id, primary, actor, mode, intent, start, success, recovery]
+    properties:
+      id: { $ref: "#/$defs/id" }
+      primary: { type: boolean }
+      actor: { $ref: "#/$defs/id" }
+      mode: { $ref: "#/$defs/id" }
+      intent: { $ref: "#/$defs/text" }
+      start: { $ref: "#/$defs/state" }
+      success:
+        type: object
+        additionalProperties: false
+        required: [stateMachine, state, observable, evidence]
+        properties:
+          stateMachine: { $ref: "#/$defs/id" }
+          state: { $ref: "#/$defs/id" }
+          observable: { $ref: "#/$defs/text" }
+          evidence:
+            type: array
+            minItems: 1
+            items: { enum: [contract, runtime, network, export, manual-review] }
+      recovery:
+        type: object
+        additionalProperties: false
+        required: [required, failure, observable]
+        properties:
+          required: { type: boolean }
+          failure: { $ref: "#/$defs/state" }
+          observable: { $ref: "#/$defs/text" }
+      journey:
+        type: object
+        additionalProperties: false
+        required: [profile, journey]
+        properties:
+          profile: { $ref: "#/$defs/id" }
+          journey: { $ref: "#/$defs/id" }
+      browser:
+        type: object
+        additionalProperties: false
+        required: [route, narrowViewport]
+        properties:
+          route: { type: string, pattern: "^/(?!/)", maxLength: 1024 }
+          narrowViewport: { type: string, minLength: 1, maxLength: 128 }

package/knowledge-base/benchmarks/portfolio-corpus/registry.schema.yaml

@@ -0,0 +1,188 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: https://ztothez.dev/schemas/portfolio-registry-1.0.schema.json
+title: ZtotheZ Design Engineering Local Portfolio Registry
+type: object
+additionalProperties: false
+required: [version, id, description, roots, projects]
+properties:
+  version: { const: "1.0" }
+  id: { $ref: "#/$defs/id" }
+  description: { type: string, minLength: 1, maxLength: 1024 }
+  roots:
+    type: array
+    minItems: 1
+    maxItems: 20
+    items: { $ref: "#/$defs/root" }
+  projects:
+    type: array
+    maxItems: 500
+    items: { $ref: "#/$defs/project" }
+$defs:
+  id:
+    type: string
+    pattern: "^[a-z0-9][a-z0-9-]{0,63}$"
+  text:
+    type: string
+    minLength: 1
+    maxLength: 1024
+  relativePattern:
+    type: string
+    minLength: 1
+    maxLength: 1024
+    pattern: "^(?!/)(?![A-Za-z]:[\\\\/])(?!.*(?:^|[\\\\/])\\.\\.(?:[\\\\/]|$))[^\\u0000]+$"
+  publication:
+    type: object
+    additionalProperties: false
+    required: [sourceExcerpts, screenshots, machineReports, aggregateMetrics]
+    properties:
+      sourceExcerpts: { type: boolean }
+      screenshots: { type: boolean }
+      machineReports: { type: boolean }
+      aggregateMetrics: { type: boolean }
+  root:
+    type: object
+    additionalProperties: false
+    required: [id, class, path]
+    properties:
+      id: { $ref: "#/$defs/id" }
+      class:
+        enum: [studio-clients, studio-fullstack, studio-personal, studio-portfolio, ai, apps]
+      path: { type: string, minLength: 1, maxLength: 4096 }
+      discoveryDepth: { type: integer, minimum: 1, maximum: 12, default: 4 }
+      excludes:
+        type: array
+        maxItems: 100
+        default: []
+        items: { $ref: "#/$defs/relativePattern" }
+  capability:
+    type: object
+    additionalProperties: false
+    required: [stage, status, reason]
+    properties:
+      stage:
+        enum: [source-audit, typecheck, lint, unit-test, production-build, local-fixture-server, browser-journeys, export-verification]
+      status: { enum: [supported, unsupported, not-applicable] }
+      reason: { type: string, minLength: 1, maxLength: 512 }
+  adapterCommand:
+    type: object
+    additionalProperties: false
+    required: [stage, command]
+    properties:
+      stage:
+        enum: [source-audit, typecheck, lint, unit-test, production-build, local-fixture-server, browser-journeys, export-verification]
+      command:
+        type: string
+        pattern: "^[A-Za-z0-9][A-Za-z0-9._+-]{0,127}$"
+      arguments:
+        type: array
+        maxItems: 50
+        default: []
+        items: { type: string, minLength: 1, maxLength: 512 }
+      cwd: { allOf: [{ $ref: "#/$defs/relativePattern" }], default: "." }
+      timeoutMs: { type: integer, minimum: 100, maximum: 1800000, default: 120000 }
+      maxOutputBytes: { type: integer, minimum: 1024, maximum: 33554432, default: 2097152 }
+      allowDependencyNetwork: { type: boolean, default: false }
+  project:
+    type: object
+    additionalProperties: false
+    required: [id, root, path, enabled, ownership, confidentiality, cohort, publication, product, technology, capabilities, execution, paths, source]
+    properties:
+      id: { $ref: "#/$defs/id" }
+      root: { $ref: "#/$defs/id" }
+      path: { $ref: "#/$defs/relativePattern" }
+      enabled: { type: boolean }
+      ownership: { enum: [first-party, client-authorized, third-party-reference, unknown] }
+      authorizationEvidence: { type: string, minLength: 1, maxLength: 1024 }
+      confidentiality: { enum: [public, private-local, restricted] }
+      cohort: { enum: [development, holdout, excluded] }
+      publication: { $ref: "#/$defs/publication" }
+      product:
+        type: object
+        additionalProperties: false
+        required: [domain, archetype, intendedUsers, primaryTasks]
+        properties:
+          domain: { type: string, minLength: 1, maxLength: 128 }
+          archetype: { enum: [operational-dashboard, ai-workspace, content-site, utility, full-stack-workflow, other] }
+          intendedUsers:
+            type: array
+            minItems: 1
+            maxItems: 20
+            items: { type: string, minLength: 1, maxLength: 256 }
+          primaryTasks:
+            type: array
+            minItems: 1
+            maxItems: 20
+            items: { type: string, minLength: 1, maxLength: 512 }
+      technology:
+        type: object
+        additionalProperties: false
+        required: [framework, packageManager, entrypoint]
+        properties:
+          framework: { type: string, minLength: 1, maxLength: 128 }
+          packageManager: { enum: [npm, pnpm, yarn, bun, pip, poetry, none, other] }
+          entrypoint: { $ref: "#/$defs/relativePattern" }
+          adapter: { enum: [react-vite, nextjs, angular, static-web, node-python-fullstack, python-source] }
+      capabilities:
+        type: array
+        minItems: 1
+        maxItems: 8
+        items: { $ref: "#/$defs/capability" }
+      execution:
+        type: object
+        additionalProperties: false
+        required: [fixtureMode, networkPolicy, lifecycleScripts]
+        properties:
+          fixtureMode: { enum: [local-fixture, disconnected, not-applicable] }
+          networkPolicy: { enum: [denied, dependency-install-only] }
+          lifecycleScripts: { type: boolean }
+          allowedEnvironmentVariables:
+            type: array
+            maxItems: 50
+            default: []
+            items: { type: string, pattern: "^[A-Z][A-Z0-9_]{0,127}$" }
+          localPorts:
+            type: array
+            maxItems: 20
+            default: []
+            items: { type: integer, minimum: 1, maximum: 65535 }
+          commands:
+            type: array
+            maxItems: 8
+            default: []
+            items: { $ref: "#/$defs/adapterCommand" }
+      verification:
+        type: object
+        additionalProperties: false
+        required: [serveDirectory, port, contractPath, profile]
+        properties:
+          serveDirectory: { $ref: "#/$defs/relativePattern" }
+          port: { type: integer, minimum: 1, maximum: 65535 }
+          route: { type: string, pattern: "^/[^/].*|^/$", maxLength: 2048, default: "/" }
+          readinessPath: { type: string, pattern: "^/[^/].*|^/$", maxLength: 2048, default: "/" }
+          contractPath: { $ref: "#/$defs/relativePattern" }
+          profile: { $ref: "#/$defs/id" }
+          attestationsPath: { $ref: "#/$defs/relativePattern" }
+          heuristicReviewPath: { $ref: "#/$defs/relativePattern" }
+          settleMs: { type: integer, minimum: 0, maximum: 30000, default: 500 }
+      paths:
+        type: object
+        additionalProperties: false
+        required: [include]
+        properties:
+          include:
+            type: array
+            minItems: 1
+            maxItems: 100
+            items: { $ref: "#/$defs/relativePattern" }
+          exclude:
+            type: array
+            maxItems: 200
+            default: []
+            items: { $ref: "#/$defs/relativePattern" }
+      source:
+        type: object
+        additionalProperties: false
+        required: [revisionPolicy, canonicalizationKey]
+        properties:
+          revisionPolicy: { enum: [capture-current, require-clean] }
+          canonicalizationKey: { $ref: "#/$defs/id" }

package/knowledge-base/benchmarks/portfolio-corpus/registry.template.yaml

@@ -0,0 +1,63 @@
+version: "1.0"
+id: local-product-portfolio
+description: Local-only project registry for non-destructive design-engineering benchmarks.
+
+roots:
+  - id: studio-portfolio
+    class: studio-portfolio
+    path: /absolute/path/to/Studio/portfolio
+    discoveryDepth: 4
+    excludes: [captures, captures/**, backups, backups/**]
+
+projects:
+  - id: example-product
+    root: studio-portfolio
+    path: example-product
+    enabled: false
+    ownership: first-party
+    confidentiality: private-local
+    cohort: excluded
+    publication:
+      sourceExcerpts: false
+      screenshots: false
+      machineReports: false
+      aggregateMetrics: true
+    product:
+      domain: Example product domain
+      archetype: operational-dashboard
+      intendedUsers: [Primary operator]
+      primaryTasks: [Complete the primary product workflow]
+    technology:
+      framework: React
+      packageManager: npm
+      entrypoint: package.json
+      adapter: react-vite
+    capabilities:
+      - stage: source-audit
+        status: supported
+        reason: Source files are available for read-only inspection.
+      - stage: browser-journeys
+        status: unsupported
+        reason: No local fixture route has been declared yet.
+    execution:
+      fixtureMode: disconnected
+      networkPolicy: denied
+      lifecycleScripts: false
+      allowedEnvironmentVariables: []
+      localPorts: []
+      commands: []
+    # Enable only when the snapshot contains a safe static fixture and product contract.
+    # verification:
+    #   serveDirectory: dist
+    #   port: 4173
+    #   route: /
+    #   readinessPath: /
+    #   contractPath: benchmark/product-contract.yaml
+    #   profile: responsive-overview
+    #   settleMs: 500
+    paths:
+      include: ["**"]
+      exclude: []
+    source:
+      revisionPolicy: capture-current
+      canonicalizationKey: example-product

package/knowledge-base/benchmarks/portfolio-corpus/rule-fixtures/component-size-abstention.json

@@ -0,0 +1,10 @@
+{
+  "version": "1.0.0",
+  "ruleId": "ZTDE-ARCH-001",
+  "expected": "abstained",
+  "applicable": false,
+  "fileName": "calculation.ts",
+  "prefix": ["export function calculate() {"],
+  "repeat": { "line": "  // Non-rendering calculation step.", "count": 410 },
+  "suffix": ["  return 1;", "}"]
+}

package/knowledge-base/benchmarks/portfolio-corpus/rule-fixtures/component-size-negative.json

@@ -0,0 +1,10 @@
+{
+  "version": "1.0.0",
+  "ruleId": "ZTDE-ARCH-001",
+  "expected": "detected",
+  "applicable": true,
+  "fileName": "LargePanel.tsx",
+  "prefix": ["export function LargePanel() {", "  return (", "    <section>"],
+  "repeat": { "line": "      <span>Repeated responsibility</span>", "count": 401 },
+  "suffix": ["    </section>", "  );", "}"]
+}

package/knowledge-base/benchmarks/portfolio-corpus/rule-fixtures/component-size-positive.json

@@ -0,0 +1,10 @@
+{
+  "version": "1.0.0",
+  "ruleId": "ZTDE-ARCH-001",
+  "expected": "accepted",
+  "applicable": true,
+  "fileName": "Panel.tsx",
+  "prefix": ["export function Panel() {", "  return <section>Focused panel</section>;"],
+  "repeat": { "line": "", "count": 0 },
+  "suffix": ["}"]
+}

package/knowledge-base/benchmarks/portfolio-corpus/rule-fixtures/interactive-integrity-abstention.json

@@ -0,0 +1,10 @@
+{
+  "version": "1.0.0",
+  "ruleId": "ZTDE-SLOP-003",
+  "expected": "abstained",
+  "applicable": false,
+  "fileName": "Action.test.tsx",
+  "prefix": ["export function TestFixture() {", "  return <button type=\"button\">Test-only control</button>;"],
+  "repeat": { "line": "", "count": 0 },
+  "suffix": ["}"]
+}

package/knowledge-base/benchmarks/portfolio-corpus/rule-fixtures/interactive-integrity-negative.json

@@ -0,0 +1,10 @@
+{
+  "version": "1.0.0",
+  "ruleId": "ZTDE-SLOP-003",
+  "expected": "detected",
+  "applicable": true,
+  "fileName": "Action.tsx",
+  "prefix": ["export function Action() {", "  return <button type=\"button\">Run</button>;"],
+  "repeat": { "line": "", "count": 0 },
+  "suffix": ["}"]
+}

package/knowledge-base/benchmarks/portfolio-corpus/rule-fixtures/interactive-integrity-positive.json

@@ -0,0 +1,10 @@
+{
+  "version": "1.0.0",
+  "ruleId": "ZTDE-SLOP-003",
+  "expected": "accepted",
+  "applicable": true,
+  "fileName": "Action.tsx",
+  "prefix": ["export function Action() {", "  return <button type=\"button\" onClick={() => undefined}>Run</button>;"],
+  "repeat": { "line": "", "count": 0 },
+  "suffix": ["}"]
+}

package/knowledge-base/benchmarks/portfolio-corpus/rule-fixtures/raw-design-values-abstention.json

@@ -0,0 +1,10 @@
+{
+  "version": "1.0.0",
+  "ruleId": "ZTDE-DESIGN-001",
+  "expected": "abstained",
+  "applicable": false,
+  "fileName": "generated-chart.ts",
+  "prefix": ["export function draw(ctx: CanvasRenderingContext2D) {", "  ctx.fillStyle = '#ff0000';", "  ctx.strokeStyle = '#00ff00';", "  ctx.fillRect(0, 0, 24, 24);"],
+  "repeat": { "line": "", "count": 0 },
+  "suffix": ["}"]
+}

package/knowledge-base/benchmarks/portfolio-corpus/rule-fixtures/raw-design-values-negative.json

@@ -0,0 +1,10 @@
+{
+  "version": "1.0.0",
+  "ruleId": "ZTDE-DESIGN-001",
+  "expected": "detected",
+  "applicable": true,
+  "fileName": "panel.css",
+  "prefix": [".panel {", "  color: #121212;", "  padding: 24px;", "  border-radius: 8px;"],
+  "repeat": { "line": "", "count": 0 },
+  "suffix": ["}"]
+}

package/knowledge-base/benchmarks/portfolio-corpus/rule-fixtures/raw-design-values-positive.json

@@ -0,0 +1,10 @@
+{
+  "version": "1.0.0",
+  "ruleId": "ZTDE-DESIGN-001",
+  "expected": "accepted",
+  "applicable": true,
+  "fileName": "tokens.css",
+  "prefix": [":root {", "  --surface: #ffffff;", "  --space-panel: 24px;", "  --radius-panel: 8px;"],
+  "repeat": { "line": "", "count": 0 },
+  "suffix": ["}"]
+}

package/knowledge-base/benchmarks/portfolio-corpus/rule-holdout-evaluation.template.json

@@ -0,0 +1,14 @@
+{
+  "version": "1.0.0",
+  "candidateId": "replace-candidate",
+  "projectId": "replace-holdout-project",
+  "reportCode": "REPLACE_REPORT_CODE",
+  "holdoutRunId": "replace-holdout-run",
+  "sourceDigest": "0000000000000000000000000000000000000000000000000000000000000000",
+  "ruleExecuted": false,
+  "applicable": false,
+  "status": "abstained",
+  "findingIds": [],
+  "regressionGatesPassed": false,
+  "reason": "Replace with the candidate-specific holdout result and retained evidence boundary."
+}

package/knowledge-base/benchmarks/portfolio-corpus/rule-promotion-evidence.template.json

@@ -0,0 +1,24 @@
+{
+  "version": "1.0.0",
+  "fixtures": {
+    "positive": { "path": "replace/positive-fixture", "sha256": "0000000000000000000000000000000000000000000000000000000000000000", "outcome": "accepted" },
+    "negative": { "path": "replace/negative-fixture", "sha256": "0000000000000000000000000000000000000000000000000000000000000000", "outcome": "detected" },
+    "abstention": { "path": "replace/abstention-fixture", "sha256": "0000000000000000000000000000000000000000000000000000000000000000", "outcome": "abstained" }
+  },
+  "existingGates": [
+    { "id": "v1-v2", "passed": false, "evidence": { "path": "replace/v1-v2-report", "sha256": "0000000000000000000000000000000000000000000000000000000000000000" } },
+    { "id": "retrieval", "passed": false, "evidence": { "path": "replace/retrieval-report", "sha256": "0000000000000000000000000000000000000000000000000000000000000000" } },
+    { "id": "corpus", "passed": false, "evidence": { "path": "replace/corpus-report", "sha256": "0000000000000000000000000000000000000000000000000000000000000000" } },
+    { "id": "mcp", "passed": false, "evidence": { "path": "replace/mcp-report", "sha256": "0000000000000000000000000000000000000000000000000000000000000000" } },
+    { "id": "package", "passed": false, "evidence": { "path": "replace/package-report", "sha256": "0000000000000000000000000000000000000000000000000000000000000000" } },
+    { "id": "independence", "passed": false, "evidence": { "path": "replace/independence-report", "sha256": "0000000000000000000000000000000000000000000000000000000000000000" } }
+  ],
+  "holdoutEvaluations": [
+    { "projectId": "replace-holdout-project", "status": "abstained", "evidence": { "path": "replace/holdout-evaluation-report", "sha256": "0000000000000000000000000000000000000000000000000000000000000000" } }
+  ],
+  "promotedArtifacts": {
+    "documentation": { "path": "replace/rule-documentation", "sha256": "0000000000000000000000000000000000000000000000000000000000000000" },
+    "test": { "path": "replace/rule-test", "sha256": "0000000000000000000000000000000000000000000000000000000000000000" },
+    "migrationGuidance": "Replace with independently authored migration guidance."
+  }
+}

package/knowledge-base/benchmarks/portfolio-corpus/v3-command-evidence.template.json

@@ -0,0 +1,17 @@
+{
+  "version": "1.0.0",
+  "id": "replace-command-evidence-id",
+  "command": ["replace-command", "replace-argument"],
+  "startedAt": "1970-01-01T00:00:00.000Z",
+  "completedAt": "1970-01-01T00:00:00.000Z",
+  "exitCode": 1,
+  "passed": false,
+  "stdout": {
+    "path": "replace/stdout.log",
+    "sha256": "0000000000000000000000000000000000000000000000000000000000000000"
+  },
+  "stderr": {
+    "path": "replace/stderr.log",
+    "sha256": "0000000000000000000000000000000000000000000000000000000000000000"
+  }
+}

package/knowledge-base/benchmarks/portfolio-corpus/v3-qualification-evidence.template.json

@@ -0,0 +1,29 @@
+{
+  "version": "1.0.0",
+  "ciFixtures": {
+    "registryViolations": { "passed": false, "evidence": { "path": "replace/registry-fixture-report", "sha256": "0000000000000000000000000000000000000000000000000000000000000000" } },
+    "snapshotViolations": { "passed": false, "evidence": { "path": "replace/snapshot-fixture-report", "sha256": "0000000000000000000000000000000000000000000000000000000000000000" } },
+    "adapterCases": { "passed": false, "evidence": { "path": "replace/adapter-fixture-report", "sha256": "0000000000000000000000000000000000000000000000000000000000000000" } },
+    "comparisonSafety": { "passed": false, "evidence": { "path": "replace/comparison-fixture-report", "sha256": "0000000000000000000000000000000000000000000000000000000000000000" } },
+    "privacyBoundaries": { "passed": false, "evidence": { "path": "replace/privacy-fixture-report", "sha256": "0000000000000000000000000000000000000000000000000000000000000000" } },
+    "rulePromotionPaths": { "passed": false, "evidence": { "path": "replace/promotion-fixture-report", "sha256": "0000000000000000000000000000000000000000000000000000000000000000" } }
+  },
+  "releaseGates": {
+    "build": { "passed": false, "evidence": { "path": "replace/build-report", "sha256": "0000000000000000000000000000000000000000000000000000000000000000" } },
+    "typecheck": { "passed": false, "evidence": { "path": "replace/typecheck-report", "sha256": "0000000000000000000000000000000000000000000000000000000000000000" } },
+    "tests": { "passed": false, "evidence": { "path": "replace/tests-report", "sha256": "0000000000000000000000000000000000000000000000000000000000000000" } },
+    "packageCheck": { "passed": false, "evidence": { "path": "replace/package-check-report", "sha256": "0000000000000000000000000000000000000000000000000000000000000000" } },
+    "packageSmoke": { "passed": false, "evidence": { "path": "replace/package-smoke-report", "sha256": "0000000000000000000000000000000000000000000000000000000000000000" } },
+    "independence": { "passed": false, "evidence": { "path": "replace/independence-report", "sha256": "0000000000000000000000000000000000000000000000000000000000000000" } },
+    "corpus": { "passed": false, "evidence": { "path": "replace/corpus-report", "sha256": "0000000000000000000000000000000000000000000000000000000000000000" } },
+    "offlineRelease": { "passed": false, "evidence": { "path": "replace/offline-release-report", "sha256": "0000000000000000000000000000000000000000000000000000000000000000" } },
+    "archiveRemoval": { "passed": false, "evidence": { "path": "replace/archive-removal-report", "sha256": "0000000000000000000000000000000000000000000000000000000000000000" } }
+  },
+  "benchmarkPaths": {
+    "browserOnly": { "passed": false, "evidence": { "path": "replace/browser-only-report", "sha256": "0000000000000000000000000000000000000000000000000000000000000000" } },
+    "fullStack": { "passed": false, "evidence": { "path": "replace/full-stack-report", "sha256": "0000000000000000000000000000000000000000000000000000000000000000" } }
+  },
+  "promotionReports": [],
+  "privateLeakageScan": { "passed": false, "evidence": { "path": "replace/private-leakage-report", "sha256": "0000000000000000000000000000000000000000000000000000000000000000" } },
+  "claims": []
+}

package/knowledge-base/benchmarks/scenestart/CALIBRATION.md

@@ -0,0 +1,95 @@
+# SceneStart Benchmark Calibration
+
+## Calibration Context
+
+- Date: 2026-08-27
+- Application: `/home/ztothez/Studio/portfolio/scenestart`
+- Runtime: local TanStack Start development server at `http://127.0.0.1:4173`
+- Browser: Chromium 151 connected through a loopback CDP endpoint
+- Contract viewports: 320, 390, 768, 1024, and 1440 CSS pixels
+- Human attestations: `local-first-boundary` passed by ZtotheZ, product owner and maintainer
+
+## Final Profile Results
+
+| Profile | Journey | Runtime | Acceptance | Gate |
+|---|---:|---:|---:|---:|
+| `studio-export` | 1 of 1 passed | 0 errors, 1 warning | 6 passed | Pass |
+| `guided-workshop` | 1 of 1 passed | 0 errors, 0 warnings | 6 passed | Pass |
+| `learning-persistence` | 1 of 1 passed | 0 errors, 0 warnings | 4 passed | Pass |
+| `release-provenance` | 1 of 1 passed | 0 errors, 0 warnings | 5 passed | Pass |
+
+Every profile captured five base-route and five completed-journey screenshots. All four
+journeys completed, including their state assertions and retained download evidence where
+required.
+
+The remaining Studio warning is a single early canvas sample without pixel variation. The
+completed journey screenshots contain the rendered production, so this is retained as a timing
+warning rather than suppressed or promoted to a product failure.
+
+The aggregate release gate passes all four required profiles and all 10 acceptance criteria with
+zero failed or unverified criteria. The `local-first-boundary` result uses the attributable
+ZtotheZ review in `human-review.md` and `attestations.yaml`; the remaining criteria use contract,
+runtime, accessibility, screenshot, network, and export evidence.
+
+## Remediated Product Findings
+
+- Demo Studio now initializes from local storage before the first client render. The completed
+  Workshop project therefore arrives in Studio with the same handle and project state.
+- A storage round-trip regression test covers the Workshop-to-Studio transfer.
+- Home actions, footer links, shared support navigation, Studio controls, release actions, and
+  release checklist labels now expose stable touch targets.
+- Studio and remix sliders use a 44 CSS pixel interaction area.
+- The visually hidden Studio file input has an explicit accessible name.
+- Release-provenance checkboxes use a 24 CSS pixel control inside a 44 CSS pixel label target.
+- Fixed-height release controls were replaced with growable minimum heights so labels remain
+  readable at 200 percent text size.
+- The Studio metadata section is named `Project details`, avoiding an unsupported operational
+  status interpretation of the previous `Production` heading.
+- The three interactive Core Demo Craft lessons now expose `CHECK GOAL AND COMPLETE`. An unmet
+  goal reveals actionable guidance; a satisfied goal completes only after learner confirmation.
+- The learning journey completes all nine lessons, verifies `PATH COMPLETE`, navigates away, and
+  confirms that `9/9 DONE` persists when the route is reopened.
+
+## Verifier Correction
+
+The 200 percent text-resize rule previously reported a normal single-line input value as clipped
+when the native control exposed horizontal value scrolling. The rule now evaluates text nodes
+and genuinely constrained buttons while leaving native editable-value scrolling intact. The
+runtime regression fixture contains a long editable value and proves that it is not reported as
+lost content; the existing clipped-text fixture remains detected.
+
+Managed environments may start Chromium separately and set
+`ZTOTHEZ_DESIGN_CHROMIUM_CDP_URL` to a loopback HTTP origin such as
+`http://127.0.0.1:9222`. The runtime policy rejects non-loopback hosts, WebSocket URLs,
+credentials, paths, queries, and fragments. Direct Playwright launch remains the default.
+
+## Retained Evidence
+
+- `evidence/interface-quality/scenestart/studio-export/`
+- `evidence/interface-quality/scenestart/guided-workshop/`
+- `evidence/interface-quality/scenestart/learning-persistence/`
+- `evidence/interface-quality/scenestart/release-provenance/`
+- `evidence/interface-quality/scenestart/release/`
+
+The Studio profile retained the versioned project JSON and standalone HTML production. The
+Workshop profile retained its standalone HTML production. The release profile retained its
+generated `readme.txt`. Blob-based downloads are captured through the verifier's CSP-compatible
+evidence path without weakening SceneStart's CSP.
+
+## Verification Results
+
+- SceneStart tests: 21 files and 229 tests passed.
+- SceneStart production build: passed.
+- ZtotheZ regression suite: 65 tests passed, including the runtime verifier through the loopback
+  CDP path and the SceneStart contract, profiles, and clean-room authority checks.
+- ZtotheZ TypeScript typecheck, production build, package check, installed-package smoke,
+  independence check, archive-removal smoke, release pack, and offline release verification:
+  passed.
+- SceneStart lint remains affected by the existing workspace formatting baseline and was not
+  treated as evidence produced by this remediation.
+
+## Review Boundary
+
+The SceneStart benchmark is complete under its declared maintainer-review evidence model. This
+does not create representative-user evidence or independent comparative validation. Those claims
+remain governed by V2 Item 8 and require their own supplied sessions.