{
  "schema": "quasantum-workstation-storage-topology/v1",
  "id": "quasantum-workstation-storage-topology",
  "version": "2026-08-25.1",
  "status": "repository-settled-machine-actionable-contract",
  "master_index_thread": "6.4.2.6",
  "governing_sentence": "C: retains required workstation state; D: is the preferred high-capacity operational ground for reproducible scratch, build, staging, browser cache, and publication work roots.",
  "canonical_locations": {
    "machine_contract": "canon/workstation-storage-topology.v1.json",
    "public_contract": "/canon/workstation-storage-topology.v1.json",
    "atlas_exposition": "/apex/atlas/operational-topology",
    "preflight": "node tools/validate_workstation_storage_topology.js --json reports/workstation-storage-topology-preflight.json",
    "residue_classifier": "node tools/classify_operational_residue.js --json reports/operational-residue-classification.json"
  },
  "observed_trigger": {
    "classification": "publication-workspace-capacity-failure",
    "date": "2026-08-25",
    "facts": [
      "C: reached zero free bytes during an earlier Cloudflare publication corridor.",
      "C:/t accumulated multi-GB qpub work roots from reproducible publication attempts.",
      "D: had hundreds of GB free and is the preferred high-capacity publication workspace.",
      "Long D: paths exposed Git safe.directory and path-length sensitivity; short D: roots improved compatibility."
    ]
  },
  "volumes": [
    {
      "id": "C",
      "path": "C:/",
      "role": "system, installed applications, user profile, governed repositories, credentials, and required durable workstation state",
      "policy": "do not prefer for heavy reproducible publication scratch; preserve enough free space for Windows and required applications",
      "minimum_free_bytes_warning": 21474836480
    },
    {
      "id": "D",
      "path": "D:/",
      "role": "high-capacity operational scratch, build, staging, browser cache, preserved temporary evidence, and disposable publication work roots",
      "policy": "preferred for publication work roots when present, writable, and above minimum free-space threshold",
      "minimum_free_bytes_required": 21474836480
    }
  ],
  "preferred_roots": {
    "publication_runtime_root": "D:/q",
    "publication_fallback_root": "D:/qtmp",
    "legacy_compatibility_root": "C:/t",
    "preserved_temp_root": "D:/qpub-preserved-temp"
  },
  "publication_workspace_selection": {
    "ordered_candidates": [
      "D:/q",
      "D:/qtmp",
      "C:/t"
    ],
    "required_properties": [
      "root exists or can be created",
      "root is writable",
      "root free bytes meet configured threshold",
      "publication work root is a child of the selected runtime root",
      "work root path is short enough for Windows Git and tar compatibility"
    ],
    "work_root_prefix": "q",
    "git_compatibility": {
      "core_longpaths": true,
      "safe_directory_scope": "publication snapshot source directory under selected work root",
      "avoid_persistent_global_mutation": true
    }
  },
  "residue_classes": [
    {
      "id": "retained_evidence",
      "meaning": "Evidence-bearing roots or copied manifests required to reconstruct a publication corridor."
    },
    {
      "id": "reproducible_disposable",
      "meaning": "Build, staging, source snapshot, cache, or failed-attempt roots whose evidentiary identity is already copied into repository-settled records."
    },
    {
      "id": "active_or_unknown",
      "meaning": "Roots that cannot be classified without operator review and must not be removed automatically."
    }
  ],
  "commands": {
    "preflight": "node tools/validate_workstation_storage_topology.js --json reports/workstation-storage-topology-preflight.json",
    "residue_classification": "node tools/classify_operational_residue.js --json reports/operational-residue-classification.json",
    "publication_preflight": "powershell -ExecutionPolicy Bypass -File scripts/publication-bootstrap.ps1 -Preflight",
    "publication_deploy": "powershell -ExecutionPolicy Bypass -File scripts/publication-bootstrap.ps1 -Deploy -DeploymentAuthorizationId <id>"
  }
}