classDiagram
 note "【Current Architecture】\nTight coupling with Single Provider & Single API Key"
 class ProviderConfig {
 +string activeProfile
 +string apiKey
 +getActiveConfig()
 }
 note for ProviderConfig "- Strictly expects OPENAI_API_KEY as final fallback\n- Incapable of maintaining multiple concurrent provider sessions"
 %% ==========================================
 note "【Proposed Target Architecture】\nSeparation of Registry & Credentials (Loose Coupling)"
 class CredentialStore {
 <<interface>>
 +get(providerId: string) Credential
 +set(providerId: string, cred: Credential) void
 }
 
 class ProviderRegistry {
 <<interface>>
 +Map~string, ProviderConfig~ providers
 +resolve(model: string) ProviderConfig
 }
 class Credential {
 +string apiKey
 +string baseUrl
 +string authType
 }
 class TargetProviderConfig {
 +string providerId
 +string defaultModel
 +validate() bool
 }
 ProviderRegistry "1" *-- "many" TargetProviderConfig : Manages
 ProviderRegistry ..> CredentialStore : Resolves credentials
 TargetProviderConfig ..> Credential : Applies

sequenceDiagram
 autonumber
 
 box RGBA(255, 0, 0, 0.1) Current Broken Flow (Defective process.cwd Dependency)
 actor User as User Agent
 participant Shell as Shell.ts (AsyncLocal)
 participant Hook as toolHooks.ts
 participant Spawn as bashProvider.ts (spawn)
 end
 User->>Shell: cd subdir
 Note over Shell: Only mutates AsyncLocalStorage state override.<br/>The actual OS-level process.cwd() remains unmutated.
 Shell-->>User: Command execution ack
 
 User->>Spawn: spawn("ls")
 Spawn->>Hook: Fetch execution context (CWD fallback)
 Hook-->>Spawn: Returns unmutated process.cwd() (Root directory)
 Note over Spawn: Executes command inside original root directory,<br/>violating user's mental model and context.
 Spawn-->>User: Returns file list of root instead of subdir (Critical Bug)
 %% ==========================================
 box RGBA(0, 255, 0, 0.1) Proposed Flow (Stateful VirtualCWD Synchronization)
 actor User2 as User Agent
 participant Session as SessionManager
 participant Spawn2 as bashProvider.ts (spawn)
 participant Node as OS Process Base
 end
 User2->>Session: cd subdir
 Note over Session: Directly mutates stateful session.virtualCwd
 Session->>Node: Synchronizes environment via process.chdir(subdir)
 Node-->>Session: Execution ack
 Session-->>User2: Command execution ack
 User2->>Spawn2: spawn("ls")
 Note over Spawn2: Explicitly injects session.virtualCwd<br/>into target options.cwd allocation
 Spawn2->>Node: Spawns sub-process inside resolved target subdir
 Node-->>Spawn2: Expected execution stdout/stderr
 Spawn2-->>User2: Returns correct subdir file list (Expected Behavior)

stateDiagram-v2
 state "【Current Design】\nAbsolute Path String Hash Dependency (Brittle)" as CurrentSession {
 [*] --> Init : process.cwd() = /home/user/project
 Init --> Transform : Execution of sanitizePath()
 Transform --> KeyGeneration : Yields rigid key "home-user-project-v1-hash"
 KeyGeneration --> HardcodedBinding : Persisted directly under ~/.openclaude/projects/
 HardcodedBinding --> EnvironmentShift : External mv / symlink / bind mount action
 EnvironmentShift --> HistorialDataLoss : Path string deviation causes complete failure to resolve legacy session
 }
 %% ==========================================
 state "【Proposed Target Design】\n3-Tier Identification Topology (Highly Portable)" as ProposedSession {
 [*] --> Resolution : Triggered via specific sessionId or Recursive Git Root Search
 Resolution --> StructuralIdentity : Detects immutable "projectId" bound to Git Repository Root
 StructuralIdentity --> ContextSync : Fully restores agent execution context using sessionId metadata index
 ContextSync --> WorkspaceNavigation : Local path modifications strictly update "virtualCwd" state metadata only
 WorkspaceNavigation --> ContinuousPersistence : Seamlessly persists session states across path/machine migrations via stable IDs
 }

flowchart LR
 subgraph BlastRadius [Blast Radius Matrix / Systemic Dependencies]
 direction TB
 
 P1["Proposal1: Legacy Provider Management<br/>(Single API Key Constraint)"]
 P2["Proposal 2: Flawed CWD Virtualization<br/>(Pseudo 'cd' Layer)"]
 P3["Proposal 3: Brittle Absolute Path Dependency<br/>(Fragile Resume Index)"]
 
 config["config/profile<br/>(Profile Management)"]
 API["API Client Layer"]
 shell["shell/spawn<br/>(Process Orchestration)"]
 fileOps["File System Operations"]
 session["Session Persistence<br/>(Storage Engine)"]
 resume["Session Resume Trigger"]
 vscode["VSCode Extension Context"]
 
 P1 --> config
 P1 --> API
 
 P2 --> shell
 P2 --> fileOps
 
 P3 --> session
 P3 --> resume
 P3 --> vscode
 end
 
 style P1 fill:#ff9999,stroke:#333,stroke-width:2px,color:#000
 style P2 fill:#ff9999,stroke:#333,stroke-width:2px,color:#000
 style P3 fill:#ff9999,stroke:#333,stroke-width:2px,color:#000