130 行
7.6 KiB
Markdown
130 行
7.6 KiB
Markdown
|
|
# P00 Bootstrap Verification and PR Draft
|
||
|
|
|
||
|
|
Date: 2026-07-18
|
||
|
|
|
||
|
|
## Delivery status
|
||
|
|
|
||
|
|
Local implementation and verification are complete. Git Credential Manager reauthentication succeeded, the `main` baseline was pushed non-forced to Forgejo at `0d12b94`, and development continued on `feat/p00-bootstrap`.
|
||
|
|
|
||
|
|
Implementation, test, and CI increments are committed on the feature branch. Forgejo CI has not run because runner availability remains unverified; no CI success is claimed.
|
||
|
|
|
||
|
|
No merge to `main` has been performed.
|
||
|
|
|
||
|
|
## Environment
|
||
|
|
|
||
|
|
- Windows NT 10.0.26100.0, PowerShell 5.1.26100.7920
|
||
|
|
- Git 2.54.0.windows.1
|
||
|
|
- Node.js 24.17.0, npm 11.13.0, pnpm 11.9.0
|
||
|
|
- rustc/cargo 1.97.1
|
||
|
|
- Tauri CLI 2.11.4, Tauri crate 2.11.5
|
||
|
|
- WebView2 Runtime 131.0.2903.86
|
||
|
|
- MSVC link environment verified by debug/release and NSIS builds
|
||
|
|
|
||
|
|
## Completed scope
|
||
|
|
|
||
|
|
- Tauri 2 + React + TypeScript + Vite + Rust skeleton, tray, single-instance, CSP, and minimal capability configuration.
|
||
|
|
- Two independent companion/operations REST and SSE clients with local profile binding, state, cancellation, reconnect, Last-Event-ID, and deduplication.
|
||
|
|
- Windows Credential Manager CRUD with generated fake credentials and cleanup.
|
||
|
|
- Bounded UI Automation, selected-window in-memory PrintWindow capture, closed-window identity rejection, Event Log, process, port, foreground-window, authorized log-tail, configuration parsing, and redaction Spikes.
|
||
|
|
- Composite-key SQLite isolation.
|
||
|
|
- Recoverable plan/dry-run/copy/size+SHA-256 verify/atomic commit file transactions with ask/rename/skip and source preservation.
|
||
|
|
- Provisional desktop-v1alpha1 protocol types, TypeScript exports, ten JSON Schemas, and dual loopback Mock Gateway.
|
||
|
|
- Frontend, browser, Rust, integration, Windows-provider, soak, and Forgejo CI entry points.
|
||
|
|
- Dependency review, Spike reports, progress records, and changelog.
|
||
|
|
|
||
|
|
## Test report
|
||
|
|
|
||
|
|
| Check | Result |
|
||
|
|
| ------------------------------------------------------- | ------------------------------------------------------------------------------ |
|
||
|
|
| pnpm frozen lockfile-only validation | Passed with pnpm 11.9.0 and a local temporary store; no dependency scripts run |
|
||
|
|
| Frontend format, ESLint, TypeScript, Vitest, Vite build | Passed; 1 Vitest test |
|
||
|
|
| Playwright Chromium smoke | Passed; 1 test |
|
||
|
|
| cargo fmt --all -- --check | Passed |
|
||
|
|
| cargo check --workspace --all-targets | Passed |
|
||
|
|
| cargo clippy --workspace --all-targets -- -D warnings | Passed |
|
||
|
|
| cargo test --workspace | Passed; 40 tests, 2 explicit manual tests ignored |
|
||
|
|
| Controlled Windows UIA/PrintWindow smoke | Passed; 1 test, 0.12 seconds |
|
||
|
|
| Protocol Schema drift check | Passed |
|
||
|
|
| Corrected dual-SSE soak | Passed; 1800.02 seconds, companion 1800, operations 1801 |
|
||
|
|
| Tauri development launch | Passed; `AstrBot Desktop` window responsive and safely stopped |
|
||
|
|
| Tauri release executable | Passed |
|
||
|
|
| Tauri NSIS installer | Passed |
|
||
|
|
|
||
|
|
Soak resource samples:
|
||
|
|
|
||
|
|
- Working set: approximately 11.4-12.1 MiB.
|
||
|
|
- Private memory: approximately 2.0-2.4 MiB.
|
||
|
|
- Final pre-exit cumulative CPU: 1.38 seconds.
|
||
|
|
- No cross-routing assertion, stream stall, or failed shutdown in the corrected run.
|
||
|
|
|
||
|
|
NSIS artifact:
|
||
|
|
|
||
|
|
- File: `AstrBot Desktop_0.1.0-alpha.0_x64-setup.exe`
|
||
|
|
- Size: 3,552,257 bytes
|
||
|
|
- SHA-256: `BF87DCD13B81C18EFC9A2DB8DE6E201396FFBB9ABA0EABC579A22479C004816C`
|
||
|
|
|
||
|
|
## Security review
|
||
|
|
|
||
|
|
- Tauri window capability contains only `core:default`.
|
||
|
|
- No shell plugin or product API for PowerShell, CMD, arbitrary shell, input injection, registry write, or unrestricted filesystem execution exists.
|
||
|
|
- Credential values remain in Rust/Windows Credential Manager; React has no credential read command.
|
||
|
|
- Repository secret scan found only the documented redaction example and deliberate fake test fixtures.
|
||
|
|
- File-transaction deletion calls are limited to transaction-owned temporary destination files and generated test-fixture cleanup; P00 never deletes the source.
|
||
|
|
- No real UNC path, NAS credential, signing key, updater key, private key, or production token was used.
|
||
|
|
|
||
|
|
## Unresolved issues
|
||
|
|
|
||
|
|
1. `ssh://git@localhost:18086/...` refuses connections.
|
||
|
|
2. `ssh://git@192.168.31.210:18086/...` responds but rejects the available key; approved HTTP push is the working transport.
|
||
|
|
3. Forgejo CI has not run; runner jobs/labels could not be verified and the jobs API returned 404.
|
||
|
|
4. Real UNC/SMB behavior is not tested because no authorized disposable fixture was provided.
|
||
|
|
5. A real elevated or custom-drawn window remains a manual UIA/capture boundary test.
|
||
|
|
6. The connection layer and tray lifecycle passed separately; configured Gateway sessions are not yet wired into Tauri setup for a combined tray-hidden end-to-end run.
|
||
|
|
7. Real AstrBot Gateway protocol compatibility is unverified; desktop-v1alpha1 remains provisional.
|
||
|
|
8. Code signing, updater signing, updater endpoint, and release publication remain outside P00.
|
||
|
|
9. pnpm 11 project registration cannot create its store symlink when the project/store are on this UNC share; local temporary store plus frozen-store is the verified lockfile-only workaround.
|
||
|
|
|
||
|
|
## Commit list
|
||
|
|
|
||
|
|
Branch commit sequence:
|
||
|
|
|
||
|
|
1. `5e6e8d5 docs(project): add architecture and implementation specifications`
|
||
|
|
2. `0d12b94 chore(repo): initialize repository and ignore rules`
|
||
|
|
3. `01607c6 feat(p00): add Tauri desktop spike foundation`
|
||
|
|
4. `69b432b test(p00): add frontend browser rust and windows checks`
|
||
|
|
5. `d4af979 ci(forgejo): add portable and windows quality workflows`
|
||
|
|
6. `docs(p00): record spike results and unresolved boundaries`
|
||
|
|
|
||
|
|
## Forgejo PR title
|
||
|
|
|
||
|
|
`feat(p00): bootstrap Tauri desktop and validate high-risk spikes`
|
||
|
|
|
||
|
|
## Forgejo PR body
|
||
|
|
|
||
|
|
### Summary
|
||
|
|
|
||
|
|
- bootstrap the Tauri 2 + React + TypeScript + Rust desktop workspace;
|
||
|
|
- add isolated companion and operations REST/SSE clients and dual Mock Gateway;
|
||
|
|
- add provisional protocol Schema, Windows secure/native Spikes, SQLite isolation, and recoverable file transactions;
|
||
|
|
- add frontend, browser, Rust, Windows, soak, and Forgejo CI checks.
|
||
|
|
|
||
|
|
### Verification
|
||
|
|
|
||
|
|
- frontend quality/build and Chromium smoke pass;
|
||
|
|
- Rust fmt/check/Clippy and 40 normal tests pass;
|
||
|
|
- controlled UIA/PrintWindow smoke passes;
|
||
|
|
- corrected 30-minute dual-SSE soak passes with 1800/1801 isolated events;
|
||
|
|
- Tauri development launch, release executable, and NSIS installer build pass.
|
||
|
|
|
||
|
|
### Known boundaries
|
||
|
|
|
||
|
|
- Forgejo CI is not yet executed;
|
||
|
|
- real UNC, elevated/custom-drawn window, real AstrBot Gateway, signing, and updater verification remain pending;
|
||
|
|
- connection tasks are not yet wired into a combined real tray-hidden session test.
|
||
|
|
|
||
|
|
### Safety
|
||
|
|
|
||
|
|
- no arbitrary shell or unrestricted desktop/filesystem capability;
|
||
|
|
- no real credentials or destructive source-file operations;
|
||
|
|
- no force push and no automatic merge to `main`.
|