mirror of
https://github.com/NeuralNomadsAI/CodeNomad.git
synced 2026-11-01 03:20:37 +00:00
027f50947c
## Scope Implement the two repository-wide Ponytail audit lists, deduplicating overlapping recommendations. Based on current `dev@aa2776ef`, on `refactor/ponytail-cleanup`; no direct dev changes. Initial delta: **3,548 net lines removed**, two direct dependencies removed (and their unused transitive lockfile entries). ## Changes and preserved behavior - Delete superseded MVP/UI/tool-rendering/summary docs; compact the index and canonical architecture references and remove per-review/temp-path bookkeeping from runtime-transition history. Preserve security/ownership rules, technical minimum rationale, compatibility provenance and reproduction commands. - Remove confirmed-unused UI surfaces, Electron JSON storage IPC, obsolete release fetch/shell runners and dead bridge/storage/command/keyboard utilities. Keep existing native environment discovery and shared-service lifecycle untouched. - Replace the empty first-party plugin loading layer with direct built-in right-panel construction. External sandboxed extensions, consent, assets authority, activation, ordering and visibility remain intact. - Retire the unused incremental-part message mutation engine and exclusively owned pending-part buffers/budgets/types. The active native reducer still publishes bounded authoritative snapshots. Preserve optimistic send identity, pending sends, permissions, usage, pruning/revert, memory accounting and scroll restoration. Rewrite old tests using snapshots rather than removing relevant behavioral assertions. - Share speech streaming/base64 helpers, retaining playback lifecycle and cancellation in each caller; deterministic transport regression covers ordering, start-once, completion and failures. - Replace three Material icons with existing Lucide icons; remove `@suid/icons-material` and unused `ts-node` without upgrading other dependencies. - Drop the redundant Favorites implementation-shape test; behavioral store/browser regressions stay. Repair two inherited tests to current palette and lazy copy contracts, preserving image/privacy assertions. ## Validation Server/UI/Electron typechecks, UI production build, targeted core-panel/Favorites/audio/image/palette checks pass. Full local suites and focused browser/native Electron regressions are in progress. The broad server run found one existing deadline-sensitive pending-broker test; its entire 20-test file passes in isolation. Independent gatekeeper review is required on this exact committed head, findings will be corrected and re-reviewed to zero before the explicitly authorized admin merge. No user credentials/shared daemon/database were used for testing. ## Size notes Touched existing large files: `packages/ui/src/stores/message-v2/instance-store.ts` ~1,450 lines, `packages/ui/src/stores/message-v2/instance-store.test.ts` ~516 lines, `packages/ui/src/stores/conversation-speech.ts` ~432 lines. No size-only refactor; source/test coverage reduction is tied to proven-unused paths. Native application is not replaced/restarted by these isolated checks.
2.5 KiB
2.5 KiB
Documentation Index
Start with README for installation and usage, then architecture for ownership boundaries and code locations. AGENTS.md defines contribution, styling and i18n conventions.
Runtime and ownership
- OpenCode compatibility: qualification policy, consumed contracts and integration limits.
- Stable-runtime transition: technical minimum, installation/recovery, retired adapters and migration evidence.
- Worktree/session placement: native location identity and authorized conversation movement.
- Session environment: server-only execution-host snapshots and fail-closed per-send synchronization.
- Cache refresh conventions: display snapshots, invalidation and authoritative mutation reads.
History and pruning
- History queries: bounded search, counts and cleanup queries.
- History navigation: structural indexes and anchor windows.
- Pruning RPC: narrow native integration and packaging.
- Pruning safety: transactional authorization, identity and replay contracts.
UI and extensions
- Files panel: workspace editing, Git changes/history and preview lifecycle.
- Native interruptions: permissions/Forms dock, drafts and pending-request recovery.
- Provider accounts: native account selection and bounded quota/rotation policy.
- Plugin activation: explicit Global/Project controls.
- Panel extensions: distribution, trust, consent and sandbox/API boundaries.
- Palette sources: color provenance and validation.
Desktop automation and validation
- Desktop instrumentation: always-available automation and authenticated transport; no Developer Mode gate.
- Browser automation: owned native previews and targeting.
- Device emulation: touch profiles and sizing contracts.
- Tauri backports: upstream provenance, validation commands and override removal criteria.
- Build guide: packaging and platform build commands.
- Contributing: development and test workflows.