# Pending Decisions ## PD-0001: Forgejo transport for the development machine - Status: resolved for HTTP push; SSH remains unavailable - Current value: `ssh://git@localhost:18086/YokiiroBW/AstrBot-Desktop.git` - Push URL: `http://192.168.31.210:18085/YokiiroBW/AstrBot-Desktop.git` - Observation: the authenticated Forgejo API confirmed `YokiiroBW/AstrBot-Desktop` existed, was empty, used `main`, and granted push permission before initialization. - SSH observation: `localhost:18086` refuses connections. `192.168.31.210:18086` answers but rejects the available SSH key. - Push observation: Git Credential Manager was cleared and reauthenticated without placing a secret in the repository or chat. The approved non-forced HTTP push succeeded and remote `main` now points to `0d12b94`. - Decision: retain the SSH URL as the fetch URL for future key repair and use the explicitly approved HTTP URL as the push URL for this workflow. - Safety impact: no force push or history overwrite occurred; `feat/p00-bootstrap` was created from the pushed baseline. ## PD-0002: P00 branch naming - Status: resolved for this predevelopment workflow - Decision: use `feat/p00-bootstrap` as explicitly required by the workflow and current user request. - Follow-up: subsequent stages use the branch names in `AGENTS.md`. ## PD-0003: Node.js release line - Status: monitor during bootstrap - Current environment: Node.js 24. - Decision: use the installed version initially; pin package-manager and dependency versions in the repository and record any Tauri/Vite incompatibility found by actual builds. ## PD-0004: P00 source layout - Status: resolved for P00 - Observation: the architecture document illustrates an `apps/desktop` monorepo, while the predevelopment workflow recommends root-level `src` and `src-tauri` directories. - Decision: keep the single desktop application at the repository root during P00 and use Cargo workspace crates for protocol and Mock Gateway isolation. - Reason: there is only one application, and the workflow explicitly recommends the root layout; this avoids an extra package layer without preventing a later move if a second application appears. ## PD-0005: Source cleanup in the NAS Spike - Status: resolved for P00 - Conflict: the implementation task mentions cleanup after verification, while the workflow and safety rules require source preservation and prohibit irreversible tests. - Decision: P00 always preserves source files and tests cleanup policy only as a non-executed plan field. - Follow-up: reversible recycle-bin behavior requires a later explicitly authorized Spike. ## PD-0006: Provisional desktop gateway contract - Status: resolved for P00 - Decision: define a provisional `desktop-v1alpha1` contract and Mock Gateway without claiming compatibility with an unavailable real AstrBot Gateway. - Follow-up: authentication fields, error codes, event retention, ACK timing, and capability names require a later real-gateway contract review. ## PD-0007: Repository-local Git author identity - Status: resolved - Decision: the user explicitly approved `YokiiroBW `. - Implementation: the identity is configured only in this repository. - Result: two Conventional Commit baseline commits were created on `main`, pushed normally, and followed by scoped feature-branch commits. - Safety impact: no global Git identity was changed. ## PD-0008: Profile CRUD stage ownership - Status: resolved; option A selected by the project owner on 2026-07-18 - Conflict: `docs/01_Architecture_Design.md` lists Profile CRUD in stage 1, while `docs/02_Codex_Implementation_Tasks.md` lists ConnectionProfile CRUD in Batch 2. - Decision: implement basic non-sensitive Profile metadata CRUD in P01. - P01 scope: Profile list, create, update, and delete; SQLite schema v2; bounded Tauri IPC; strict frontend Schema; basic management UI. - P02 scope: companion/operations slot assignment, active connection state, auto-connect validation, switching protection, and `server_instance_id` conflict detection. - Secret boundary: P01 commands accept no Token, password, API Key, Cookie, Authorization header, or NAS credential fields. SQLite stores only non-sensitive metadata and future opaque credential references. - Rationale: AGENTS.md gives the architecture document higher priority, and the selected split keeps runtime connection behavior out of P01. - ADR: `ADR-0004-profile-lifecycle-and-secret-boundary.md`.