{
  "schema_version": 1,
  "contract_version": 3,
  "evidence_reviewed": "2026-09-20",
  "renames": [],
  "surfaces": [
    {
      "id": "cli-profile-behavior",
      "description": "CLI flags, options, environment overrides, and profile selection for install.sh and setup.sh",
      "paths": [
        "public/sh/install.sh",
        "public/sh/setup.sh",
        "public/setup/profiles.tsv"
      ]
    },
    {
      "id": "output-status-messages",
      "description": "Installer progress messages, status banners, error diagnostics, and refusal notices",
      "paths": ["public/sh/install.sh", "public/sh/setup.sh"]
    },
    {
      "id": "zshrc-setup-entrypoint",
      "description": "Marker-delimited short .zshrc block and setup.zsh entrypoint script",
      "paths": ["public/sh/setup.sh"]
    },
    {
      "id": "companion-asset-checksum",
      "description": "Standalone install.sh companion-asset retrieval and SHA256 checksum verification contract",
      "paths": ["public/sh/install.sh", "public/checksum.txt"]
    },
    {
      "id": "plan-apply-receipts",
      "description": "Two-phase plan and apply execution lifecycle and serialized plan/receipt formats",
      "paths": ["public/sh/setup.sh"]
    },
    {
      "id": "configuration-targets",
      "description": "Managed configuration targets installed during files phase (init, pre, shell, entry, zshrc)",
      "paths": ["public/sh/setup.sh"]
    }
  ],
  "consumers": [
    {
      "repository": "z-shell/wiki",
      "path": "docs/getting_started/01_installation.mdx",
      "scope": "external",
      "evidence_status": "published",
      "evidence": "https://github.com/z-shell/wiki/blob/d4a2849d5e571bf20b170e04d356b065bb385e6f/docs/getting_started/01_installation.mdx",
      "surfaces": [
        "cli-profile-behavior",
        "output-status-messages",
        "zshrc-setup-entrypoint",
        "companion-asset-checksum",
        "configuration-targets"
      ]
    },
    {
      "repository": "z-shell/.github",
      "path": ".github/skills/zi-install/SKILL.md",
      "scope": "external",
      "evidence_status": "published",
      "evidence": "https://github.com/z-shell/.github/blob/04fabd632012e00c825b50df0fd8f621d17c9f82/.github/skills/zi-install/SKILL.md",
      "surfaces": [
        "cli-profile-behavior",
        "output-status-messages",
        "zshrc-setup-entrypoint",
        "companion-asset-checksum",
        "plan-apply-receipts",
        "configuration-targets"
      ]
    },
    {
      "repository": "z-shell/src",
      "path": ".github/skills/zi-install/SKILL.md",
      "scope": "internal",
      "evidence_status": "internal",
      "evidence": null,
      "surfaces": [
        "cli-profile-behavior",
        "output-status-messages",
        "zshrc-setup-entrypoint",
        "companion-asset-checksum",
        "plan-apply-receipts",
        "configuration-targets"
      ]
    },
    {
      "repository": "z-shell/src",
      "path": "docs/README.md",
      "scope": "internal",
      "evidence_status": "internal",
      "evidence": null,
      "surfaces": [
        "cli-profile-behavior",
        "output-status-messages",
        "zshrc-setup-entrypoint",
        "companion-asset-checksum",
        "plan-apply-receipts",
        "configuration-targets"
      ]
    },
    {
      "repository": "z-shell/src",
      "path": "public/index.html",
      "scope": "internal",
      "evidence_status": "internal",
      "evidence": null,
      "surfaces": ["cli-profile-behavior", "companion-asset-checksum"]
    },
    {
      "repository": "z-shell/zi",
      "path": "README.md",
      "scope": "external",
      "evidence_status": "published",
      "evidence": "https://github.com/z-shell/zi/blob/2fd78914149a94fe4fe12cf94c132a5736bd4506/README.md",
      "surfaces": ["cli-profile-behavior", "companion-asset-checksum"]
    }
  ]
}