Phase 00 Delivery: Planning Freeze, Scaffold, and 002B1 Contract

.github/ISSUE_TEMPLATE/implementation-scaffold.yml

@@ -0,0 +1,19 @@
+name: "Implementation scaffold"
+description: "Track repository scaffold and toolchain readiness work"
+title: "[Implementation] VID-IMPL-P00-001 scaffold"
+labels:
+  - "area:infrastructure"
+  - "scope:phase00"
+body:
+  - type: textarea
+    id: status
+    attributes:
+      label: Implementation issue status
+      description: "Update completed scope and evidence artifact path."
+    validations:
+      required: true
+  - type: textarea
+    id: assumptions
+    attributes:
+      label: Version and environment assumptions
+      description: "List toolchain pins, runtime assumptions, and gating dependencies."

.github/PULL_REQUEST_TEMPLATE/vid-impl-p00-001.md

@@ -0,0 +1,22 @@
+## VID-IMPL-P00-001 Scaffold Summary
+
+### Repository Scaffold
+
+- Directory layout
+- Toolchain pins
+- CI/test templates
+
+### Evidence
+
+- Build report: `specifications/evidence/PHASE-00-IMPLEMENTATION/VID-IMPL-P00-001/scaffold-build-report.json`
+- Test report: `specifications/evidence/PHASE-00-IMPLEMENTATION/VID-IMPL-P00-001/scaffold-test-report.json`
+
+### Scope Check
+
+- No product logic (media, subtitles, playback, or export)
+- No later milestone scope
+- No secrets or publication/release artifacts
+
+### Gate Readiness
+
+- Check results attached or linked

.github/workflows/vid-impl-p00-001-scaffold.yml

@@ -0,0 +1,30 @@
+name: VID-IMPL-P00-001 Scaffold
+
+on:
+  pull_request:
+    paths:
+      - "Video Localization/**"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  scaffold-validation:
+    runs-on: windows-latest
+    defaults:
+      run:
+        working-directory: "Video Localization"
+        shell: pwsh
+    steps:
+      - uses: actions/checkout@v4
+      - name: Capture exact toolchain versions
+        run: pwsh ./eng/print-versions.ps1
+      - name: Verify exact toolchain pins
+        run: pwsh ./eng/verify-toolchain.ps1
+      - name: Build scaffold check
+        run: |
+          pwsh ./eng/build.ps1
+      - name: Test scaffold check
+        run: |
+          pwsh ./eng/test.ps1

.gitignore

@@ -10,6 +10,7 @@
 .vscode/
 bin/
 obj/
+**/target/
 build/
 dist/
 out/

Directory.Build.props

@@ -0,0 +1,12 @@
+<Project>
+  <PropertyGroup>
+    <LangVersion>latest</LangVersion>
+    <Nullable>enable</Nullable>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <CheckForOverflowUnderflow>true</CheckForOverflowUnderflow>
+    <TreatWarningsAsErrors>true</TreatWarningsAsErrors>
+    <WarningsAsErrors>CS8600;CS8602;CS8603;CS8618</WarningsAsErrors>
+    <Deterministic>true</Deterministic>
+    <RestorePackagesWithLockFile>true</RestorePackagesWithLockFile>
+  </PropertyGroup>
+</Project>

Directory.Packages.props

@@ -0,0 +1,12 @@
+<Project>
+  <PropertyGroup>
+    <ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally>
+    <RestorePackagesWithLockFile>true</RestorePackagesWithLockFile>
+  </PropertyGroup>
+  <ItemGroup>
+    <PackageVersion Include="Microsoft.WindowsAppSDK" Version="2.3.1" />
+    <PackageVersion Include="Microsoft.Data.Sqlite" Version="10.0.10" />
+    <PackageVersion Include="Google.Protobuf" Version="3.35.1" />
+    <PackageVersion Include="Grpc.Tools" Version="2.83.0" />
+  </ItemGroup>
+</Project>

VideoLocalization.sln

@@ -0,0 +1,30 @@
+Microsoft Visual Studio Solution File, Format Version 12.00
+# Visual Studio Version 17.12.12345.0
+VisualStudioVersion = 17.12.12345.0
+MinimumVisualStudioVersion = 10.0.40219.1
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "VideoLocalization.Core", "src\\VideoLocalization.Core\\VideoLocalization.Core.csproj", "{D1C7D6C4-5D95-4B95-8A7A-4F4E6A89E7F1}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "VideoLocalization.Shared", "src\\VideoLocalization.Shared\\VideoLocalization.Shared.csproj", "{A2B0E3D1-2B1C-4F7D-9C5A-6D7E3D3B1E54}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "VideoLocalization.App", "src\\VideoLocalization.App\\VideoLocalization.App.csproj", "{B3C6E4A8-8ED3-4D11-A2CC-4D95E8F7A7AB}"
+EndProject
+Global
+	GlobalSection(SolutionConfigurationPlatforms) = preSolution
+		Debug|Any CPU = Debug|Any CPU
+		Release|Any CPU = Release|Any CPU
+	EndGlobalSection
+	GlobalSection(ProjectConfigurationPlatforms) = postSolution
+		{D1C7D6C4-5D95-4B95-8A7A-4F4E6A89E7F1}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{D1C7D6C4-5D95-4B95-8A7A-4F4E6A89E7F1}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{D1C7D6C4-5D95-4B95-8A7A-4F4E6A89E7F1}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{D1C7D6C4-5D95-4B95-8A7A-4F4E6A89E7F1}.Release|Any CPU.Build.0 = Release|Any CPU
+		{A2B0E3D1-2B1C-4F7D-9C5A-6D7E3D3B1E54}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{A2B0E3D1-2B1C-4F7D-9C5A-6D7E3D3B1E54}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{A2B0E3D1-2B1C-4F7D-9C5A-6D7E3D3B1E54}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{A2B0E3D1-2B1C-4F7D-9C5A-6D7E3D3B1E54}.Release|Any CPU.Build.0 = Release|Any CPU
+		{B3C6E4A8-8ED3-4D11-A2CC-4D95E8F7A7AB}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{B3C6E4A8-8ED3-4D11-A2CC-4D95E8F7A7AB}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{B3C6E4A8-8ED3-4D11-A2CC-4D95E8F7A7AB}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{B3C6E4A8-8ED3-4D11-A2CC-4D95E8F7A7AB}.Release|Any CPU.Build.0 = Release|Any CPU
+	EndGlobalSection
+EndGlobal

contracts/VID-IMPL-P00-002B1/fixtures/disposition-mapping.json

@@ -0,0 +1,134 @@
+[
+  {
+    "video_disposition": "VID-INGEST-UNSUPPORTED",
+    "shared_terminal_state": "Failed",
+    "error_category": "Unsupported",
+    "retry_class": "non-retryable",
+    "operation_stage": "validation",
+    "safe_recovery": "select a promoted profile or convert externally",
+    "identity_refs": [
+      "job_id",
+      "attempt_id",
+      "dispatch_id",
+      "worker_id"
+    ]
+  },
+  {
+    "video_disposition": "VID-INGEST-MALFORMED",
+    "shared_terminal_state": "Failed",
+    "error_category": "MalformedInput",
+    "retry_class": "non-retryable",
+    "operation_stage": "validation",
+    "safe_recovery": "inspect details or use another source",
+    "identity_refs": [
+      "job_id",
+      "attempt_id",
+      "dispatch_id",
+      "worker_id",
+      "publication_id"
+    ]
+  },
+  {
+    "video_disposition": "VID-INGEST-LIMIT",
+    "shared_terminal_state": "TimedOut",
+    "error_category": "ResourceLimit",
+    "retry_class": "non-retryable",
+    "operation_stage": "containment",
+    "safe_recovery": "use a reviewed lower-cost operation profile",
+    "identity_refs": [
+      "attempt_id",
+      "dispatch_id",
+      "worker_id",
+      "publication_id"
+    ]
+  },
+  {
+    "video_disposition": "VID-INGEST-PROTECTED",
+    "shared_terminal_state": "Failed",
+    "error_category": "ProtectionOrRights",
+    "retry_class": "non-retryable",
+    "operation_stage": "validation",
+    "safe_recovery": "provide a lawful unprotected source",
+    "identity_refs": [
+      "job_id",
+      "attempt_id",
+      "dispatch_id",
+      "worker_id"
+    ]
+  },
+  {
+    "video_disposition": "VID-INGEST-QUARANTINED",
+    "shared_terminal_state": "Failed",
+    "error_category": "UnsafeOutput",
+    "retry_class": "non-retryable",
+    "operation_stage": "output-validation",
+    "safe_recovery": "review evidence; never open automatically",
+    "identity_refs": [
+      "job_id",
+      "attempt_id",
+      "dispatch_id",
+      "publication_id",
+      "worker_id"
+    ]
+  },
+  {
+    "video_disposition": "VID-INGEST-CANCELLED",
+    "shared_terminal_state": "Cancelled",
+    "error_category": "Cancelled",
+    "retry_class": "manual",
+    "operation_stage": "execution",
+    "safe_recovery": "retry explicitly",
+    "identity_refs": [
+      "job_id",
+      "attempt_id",
+      "dispatch_id",
+      "worker_id",
+      "publication_id"
+    ]
+  },
+  {
+    "video_disposition": "VID-INGEST-WORKER-FAILED",
+    "shared_terminal_state": "Failed",
+    "error_category": "WorkerFailure",
+    "retry_class": "conditional",
+    "operation_stage": "execution",
+    "safe_recovery": "retry only when transient failure is verified",
+    "identity_refs": [
+      "job_id",
+      "attempt_id",
+      "dispatch_id",
+      "worker_id",
+      "publication_id"
+    ]
+  },
+  {
+    "video_disposition": "VID-INGEST-IDENTITY-MISMATCH",
+    "shared_terminal_state": "Failed",
+    "error_category": "IdentityMismatch",
+    "retry_class": "non-retryable",
+    "operation_stage": "prelaunch",
+    "safe_recovery": "re-probe the current source",
+    "identity_refs": [
+      "job_id",
+      "attempt_id",
+      "dispatch_id",
+      "worker_id",
+      "publication_id"
+    ]
+  },
+  {
+    "video_disposition": "VID-INGEST-REVIEW",
+    "shared_terminal_state": "Failed",
+    "error_category": "ManualReview",
+    "retry_class": "manual",
+    "operation_stage": "validation",
+    "safe_recovery": "owner or operator approves a registered profile",
+    "identity_refs": [
+      "job_id",
+      "attempt_id",
+      "dispatch_id",
+      "worker_id",
+      "publication_id"
+    ]
+  }
+]

contracts/VID-IMPL-P00-002B1/fixtures/operation-descriptor.json

@@ -0,0 +1,39 @@
+{
+  "operation_id": "submark.video-localization.media.probe",
+  "operation_version": "1.0.0-p00",
+  "implementation_id": "VID-IMPL-P00-002B1",
+  "implementation_profile_id": "VID-PROBE-P00-001",
+  "input_schema_id": "VID-IMPL-P00-002B1-INPUT",
+  "normalized_observation_schema_id": "VID-IMPL-P00-002B1-NORMALIZED-OBSERVATION",
+  "parameter_schema_id": "VID-IMPL-P00-002B1-PARAMETER",
+  "structured_error_schema_id": "VID-IMPL-P00-002B1-STRUCTURED-ERROR",
+  "resource_schema_id": "VID-IMPL-P00-002B1-RESOURCE",
+  "policy_schema_id": "VID-IMPL-P00-002B1-POLICY",
+  "output_contract_schema_id": "VID-IMPL-P00-002B1-OUTPUT-CONTRACT",
+  "supported_capabilities": [
+    "cancellation",
+    "deadline"
+  ],
+  "unsupported_capabilities": [
+    "progress",
+    "checkpoint",
+    "pause-resume",
+    "partial-success",
+    "degraded-output",
+    "acceleration",
+    "auto-fallback",
+    "network"
+  ],
+  "transport": "local-staged-file",
+  "control_protocol_min": "1.0.0",
+  "control_protocol_max": "1.0.0",
+  "schema_reference_ids": [
+    "VID-IMPL-P00-002B1-INPUT",
+    "VID-IMPL-P00-002B1-NORMALIZED-OBSERVATION",
+    "VID-IMPL-P00-002B1-PARAMETER",
+    "VID-IMPL-P00-002B1-STRUCTURED-ERROR",
+    "VID-IMPL-P00-002B1-RESOURCE",
+    "VID-IMPL-P00-002B1-POLICY",
+    "VID-IMPL-P00-002B1-OUTPUT-CONTRACT"
+  ]
+}

contracts/VID-IMPL-P00-002B1/fixtures/publication-fixture.json

@@ -0,0 +1,66 @@
+{
+  "artifact_id": "artifact-vid-impl-002b1-probe-observation-v1",
+  "artifact_version": "1.0.0-p00",
+  "artifact_type": "probe_observation",
+  "output_schema_id": "VID-IMPL-P00-002B1-NORMALIZED-OBSERVATION",
+  "completeness": "complete",
+  "integrity": {
+    "algorithm": "sha-256",
+    "value": "4be3e3f4f6ccf8ed1c3bf7d4c2a4b8a5d2f1e3b5c6a7f8d9e0a1b2c3d4e5f6ab"
+  },
+  "size_bytes": 2048,
+  "component_inventory": [
+    "probe-observation-observer",
+    "control-manifest"
+  ],
+  "producing": {
+    "job_ref": "job:vid-impl-002b1-job-a1",
+    "attempt_ref": "attempt:vid-impl-002b1-attempt-a1",
+    "dispatch_ref": "dispatch:vid-impl-002b1-dispatch-a1",
+    "worker_ref": "worker:vid-impl-002b1-worker-a1",
+    "operation_id": "submark.video-localization.media.probe",
+    "operation_version": "1.0.0-p00",
+    "implementation_id": "VID-IMPL-P00-002B1",
+    "implementation_profile_id": "VID-PROBE-P00-001"
+  },
+  "input_digests": {
+    "staged_copy_hash": "ab12cd34ef56ab12cd34ef56ab12cd34ef56ab12cd34ef56ab12cd34ef56ab12cd",
+    "manifest_digest": "0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0",
+    "logical_source_ref": "src:vid-impl-002b1-source-a"
+  },
+  "parameter_digests": {
+    "argv": "a1b2c3d4e5f60718293a4b5c6d7e8f90123456789abcdef0123456789abcdef01",
+    "limits": "111111111111111111111111111111111111111111111111111111111111111111"
+  },
+  "resource_digests": {
+    "resource": "222222222222222222222222222222222222222222222222222222222222222222",
+    "schema": "333333333333333333333333333333333333333333333333333333333333333333"
+  },
+  "policy_digests": {
+    "policy": "444444444444444444444444444444444444444444444444444444444444444444",
+    "schema": "555555555555555555555555555555555555555555555555555555555555555555"
+  },
+  "cache_digests": {
+    "schema_bundle": "666666666666666666666666666666666666666666666666666666666666666666",
+    "control_protocol": "777777777777777777777777777777777777777777777777777777777777777777"
+  },
+  "output_port": "probe-observation-output-port",
+  "staging": {
+    "state": "staged-private",
+    "path": "C:/Temp/vid-impl-002b1-staging",
+    "delete_on_stale": true,
+    "quarantine_on_failure": true
+  },
+  "lineage": {
+    "job_ref": "job:vid-impl-002b1-job-a1",
+    "attempt_ref": "attempt:vid-impl-002b1-attempt-a1",
+    "dispatch_ref": "dispatch:vid-impl-002b1-dispatch-a1",
+    "worker_ref": "worker:vid-impl-002b1-worker-a1",
+    "publication_ref": "pub-vid-impl-002b1-probe-observation-v1"
+  },
+  "publication_id": "pub-vid-impl-002b1-probe-observation-v1",
+  "fencing": {
+    "required": true,
+    "active_token": "fence-vid-impl-002b1-v1"
+  }
+}