light-heart-labs--dreamserver/ods/docs/OSS-LAUNCH-CHECKLIST.md

ODS OSS Launch Checklist

Date: 2026-03-02 Scope: /home/user/ods (Strix Halo variant)

Completed This Session

• Fix FLUX background download shell block in install.sh (robust env/quoting for nohup bash -c).
• Fix Phase C test parser error in tests/test-phase-c-p1.sh (quote-safe regex).
• Add installer capability profile contract and loader wiring:
  • config/capability-profile.schema.json
  • scripts/build-capability-profile.sh
  • CAPABILITY-PROFILE.md
• Add capability-aware preflight and machine-readable reporting:
  • scripts/preflight-engine.sh
  • PREFLIGHT-ENGINE.md
• Add backend runtime contracts and loader:
  • config/backends/
  • scripts/load-backend-contract.sh
  • BACKEND-CONTRACT.md
• Upgrade Windows/macOS installer stubs to MVP flows:
  • installers/windows.ps1 (WSL delegation)
  • installers/macos.sh (doctor/preflight)
• Add ODS Doctor diagnostics report:
  • scripts/ods-doctor.sh
  • ODS-DOCTOR.md
• Add one-command installer simulation harness:
  • scripts/simulate-installers.sh
  • Outputs: artifacts/installer-sim/summary.json, artifacts/installer-sim/SUMMARY.md
• Add launch-claim truth table:
  • PLATFORM-TRUTH-TABLE.md

P0: Must Fix Before OSS Launch

1. Unify compose expectations across tests/scripts/docs ✅ Completed (2026-03-02)

• Why: This repo uses docker-compose.base.yml + GPU overlays, but some tests/scripts had stale fallbacks.
• Evidence:
  • tests/integration-test.sh:92
  • tests/test-bootstrap-mode.sh:27
  • scripts/upgrade-model.sh:202
• Owner: Core Maintainer
• Effort: M (0.5-1.5 days)
• Exit criteria: CI/test scripts pass against Strix compose or support both compose files.

2. Add and validate .env.example for reproducible installs ✅ Completed (2026-03-02)

• Why: Tests expect it; migration script references it; file is currently missing.
• Evidence:
  • tests/integration-test.sh:297
  • scripts/migrate-config.sh:116
• Owner: Core Maintainer
• Effort: S (1-3 hours)
• Exit criteria: .env.example committed and referenced variables validated by tests.

3. Fix stale/missing doc links and path references ✅ Completed (2026-03-03)

• Why: README/Quickstart had stale workflow references.
• Owner: Docs Maintainer
• Effort: S (1-2 hours)
• Exit criteria: no broken local links in top-level docs.

4. Add license file in this publishable repo root ✅ Completed (2026-03-02)

• Why: README advertises Apache 2.0, but /home/user/ods has no LICENSE.
• Owner: Maintainer/Legal
• Effort: S (<1 hour)
• Exit criteria: LICENSE present and matches stated license.

5. Run launch smoke tests on a machine with Docker available

• Why: current environment has no Docker CLI/daemon, so runtime readiness is unverified.
• Evidence:
  • scripts/ods-preflight.sh reports Docker not running.
  • scripts/ods-test.sh --quick fails early (docker not installed).
• Owner: Release Engineer
• Effort: S-M (2-4 hours)
• Exit criteria: preflight + quick test pass on target host.

P1: Strongly Recommended Before/Right After Launch

1. Split NVIDIA vs Strix docs or add clear command matrix

• Why: mixed instructions (legacy llama-server and current llama-server:8080) create operator confusion.
• Evidence:
  • README.md, FAQ.md, TROUBLESHOOTING.md
• Owner: Docs Maintainer
• Effort: M (0.5-1 day)

2. Modernize old docker-compose command style in docs

• Why: docs mix docker-compose and docker compose; standardizing reduces support friction.
• Evidence:
  • PROFILES.md
• Owner: Docs Maintainer
• Effort: S (1-2 hours)

3. Refactor tests to mode-aware compose selection

• Why: tests are currently tuned for legacy docker-compose.yml layouts.
• Evidence:
  • tests/integration-test.sh
  • tests/test-bootstrap-mode.sh
• Owner: QA/Infra
• Effort: M-L (1-2 days)

4. Add CI workflow for shell lint + test script syntax

• Why: catches regressions like quoting/parser breaks pre-merge.
• Owner: QA/Infra
• Effort: M (0.5-1 day)

Suggested Launch Gate

Ship only after all P0 items are complete and the following command set is green on target hardware:

./scripts/ods-preflight.sh
./scripts/ods-doctor.sh
./scripts/ods-test.sh --quick
bash tests/test-phase-c-p1.sh