Skip to content

toolchain-center.md

Latest commit

 

History

History
65 lines (49 loc) · 3.87 KB

toolchain-center.md

File metadata and controls

65 lines (49 loc) · 3.87 KB

Toolchain Center

Summary

Epic #14 adds a first-class Toolchain Center for Codex, Claude Code, and GitHub Copilot. The slice gives the operator one desktop surface to inspect installation state, version visibility, authentication readiness, connection diagnostics, provider configuration, and background polling before a live session starts.

Scope

In Scope

  • Toolchain Center shell and detail surface for issue #33
  • Codex readiness, version, auth, and operator actions for issue #34
  • Claude Code readiness, version, auth, and operator actions for issue #35
  • GitHub Copilot readiness, CLI or SDK prerequisite visibility, and operator actions for issue #36
  • Connection-test and health-diagnostic modeling for issue #37
  • Secrets and environment configuration modeling for issue #38
  • Background polling summaries and stale-state surfacing for issue #39

Out Of Scope

  • live provider session execution
  • remote version feeds or package-manager-driven auto-update workflows
  • secure secret storage beyond current environment and local configuration visibility
  • local model runtimes outside the external provider toolchain path

Flow

flowchart LR
  Settings["Settings shell"]
  Center["Toolchain Center"]
  Providers["Codex / Claude Code / GitHub Copilot"]
  Diagnostics["Launch + auth + tool access + connection + resume diagnostics"]
  Config["Secrets + environment + resolved CLI path"]
  Polling["Background polling summary"]
  Operator["Operator action list"]

  Settings --> Center
  Center --> Providers
  Providers --> Diagnostics
  Providers --> Config
  Providers --> Polling
  Providers --> Operator
Loading

Contract Notes

  • DotPilot.Core/Features/ToolchainCenter owns the provider-agnostic contracts for readiness state, version status, auth state, health state, diagnostics, configuration entries, actions, workstreams, and polling summaries.
  • DotPilot.Runtime/Features/ToolchainCenter owns provider profile definitions and side-effect-bounded CLI probing. The slice reads local executable metadata and environment signals only; it does not start real provider sessions.
  • The Toolchain Center is the default settings category so provider readiness is visible without extra drilling after the operator enters settings.
  • Provider configuration must stay visible without leaking secrets. Secret entries show status only, while non-secret entries can show the current resolved value.
  • Background polling is represented as operator-facing state, not a hidden implementation detail. The UI must tell the operator when readiness was checked and when the next refresh will run.
  • Missing or incomplete provider readiness is a surfaced state, not a fallback path. The app keeps blocked, warning, and action-required states explicit.

Verification

  • dotnet build DotPilot.slnx -warnaserror -m:1 -p:BuildInParallel=false
  • dotnet test DotPilot.Tests/DotPilot.Tests.csproj
  • dotnet test DotPilot.UITests/DotPilot.UITests.csproj
  • dotnet test DotPilot.slnx

Dependencies