4.7 KiB
4.7 KiB
Implementation Plan
P00 Bootstrap (completed)
Objective
Establish a reproducible Tauri 2 + React + TypeScript + Rust baseline and complete the high-risk technical Spikes required before formal feature development.
Ordered work
- Normalize repository documents and Git metadata on
main. - Verify Forgejo is empty before the first
mainpush; never overwrite remote history. - Create
feat/p00-bootstrapfrom the pushedmainbaseline. - Establish the Tauri 2 application and typed frontend-to-Rust IPC.
- Implement two independent REST/SSE clients and a dual-instance Mock Gateway.
- Verify Windows secure credential CRUD without exposing secret values to React or logs.
- Verify bounded Windows diagnostics: foreground window, UI Automation, selected-window capture, process information, event logs, ports, network targets, authorized log tails, configuration parsing, and redaction.
- Verify NAS transactions only in a dedicated generated fixture directory: dry run, temporary copy, size/hash verification, atomic commit, conflict handling, interruption recovery, and source preservation.
- Define protocol schemas and capability negotiation types.
- Add frontend, Rust, integration, and Forgejo CI checks.
- Run and record all checks, commit by independently verifiable increments, and push the feature branch without merging
main.
Safety gates
- No arbitrary command execution is exposed by product code.
- No real credential is used in fixtures, logs, snapshots, or commits.
- No NAS Spike touches an existing user file or directory.
- No remote branch is changed until
git ls-remotesucceeds and remote history is reviewed. - No test or build is marked successful without captured execution results.
Current handoff status
- Rust/MSVC/Tauri are verified and no longer block local work.
- Git Credential Manager reauthentication succeeded and the non-forced HTTP push created the remote
mainbaseline at0d12b94. - Forgejo PR #1 merged P00 into
mainatb3420e4; development now continues onfeat/p01-foundation. - The configured SSH fetch endpoint still refuses connections and the LAN SSH endpoint rejects the available key, but the approved HTTP push URL is operational.
- Forgejo runner labels/jobs remain unverified, so the committed workflow is not claimed successful.
- Real UNC execution still requires a user-authorized disposable fixture.
P01 Foundation (active)
Objective
Turn the P00 Spike skeleton into a durable application foundation. Under the project owner's option A decision, P01 includes basic non-sensitive Profile metadata CRUD while P02 retains all slot and runtime connection behavior.
Ordered work
- Initialize a persistent SQLite database in the Tauri application-data directory.
- Apply versioned, transactional, idempotent migrations and refuse unknown future schema versions.
- Validate Rust-to-TypeScript bootstrap payloads at runtime.
- Ensure tracing output passes through the shared redaction rules before it reaches a writer.
- Add SQLite schema v2 for canonical non-sensitive ConnectionProfile metadata.
- Add bounded Tauri list/create/update/delete commands that generate IDs and timestamps in Rust.
- Reject secret values, URL credentials, query-string credentials, unknown IPC fields, and implicit insecure HTTP.
- Add strict frontend Profile Schemas and a basic management UI without Token/password/API Key inputs.
- Test five saved Profiles, CRUD, persistent reopen, v1-to-v2 migration, future-version rejection, and browser fallback.
- Re-verify tray, single-instance, explicit exit, frontend, Rust, E2E, development startup, Schema export, and production build behavior.
- Record the decision in PD-0008 and ADR-0004, then commit and push the verified branch normally.
P01 boundary
- Included: durable application database, schema migration, redacted logging, validated bootstrap IPC, basic Profile metadata CRUD, basic Profile management UI, tray, single-instance, and build/test foundations.
- Excluded: slot assignment, active REST/SSE connections, auto-connect behavior, Profile switching protection, duplicate
server_instance_idhandling, and formal credential enrollment.
Verification status
- Frontend formatting, ESLint, TypeScript, 3 Vitest tests, and Vite production build passed.
- Playwright Chromium passed 1/1.
- Rust fmt, Clippy with warnings denied, tests, and check passed.
- Rust test suite passed 50 normal tests; 2 explicit manual tests remained ignored.
- Protocol Schema export completed without drift.
- Real Tauri development startup reached the Windows executable and was then deliberately terminated.
- Windows release and NSIS bundling passed.
- Forgejo CI remains unverified because a compatible runner/jobs endpoint is unavailable.