mirror of
https://github.com/johannesjo/super-productivity.git
synced 2026-07-25 08:53:50 +00:00
42e6626b76
Collapse the sprawling, partly-stale docs/sync-and-op-log/ tree into a
small authoritative set and make the sync-correctness invariant
partly lint-enforced instead of convention-only.
Docs:
- Delete superseded/duplicate/provably-stale design, plan, and
background-research docs (quick-reference, the architecture-diagrams
monolith, the "Hybrid Manifest" docs describing code that does not
exist, completed long-term plans, LLM-synthesis analyses).
- Salvage load-bearing decision history into the surviving docs before
deletion: rejected-alternatives rationale -> operation-log-architecture
("Why this architecture"); vector-clock pruning incident history ->
vector-clocks.md; archive-payload optimization -> architecture E.7.
- Add contributor-sync-model.md as the single-invariant entry point
(one user intent = one op; replayed/remote ops must not re-trigger
effects), with a decision table mapping to the enforcing linters.
- Repoint external/internal cross-refs; add CONTRIBUTING.md + CLAUDE.md
pointers; record the migration in a dated docs/plans/ design doc.
Enforcement (new eslint-local-rules):
- no-actions-in-effects (error): effects must inject LOCAL_ACTIONS /
ALL_ACTIONS, never the raw @ngrx/effects Actions stream.
- no-multi-entity-effect (warn, heuristic): flags a literal returned
array of >=2 action-creator calls; docstring + valid-case specs pin
exactly which shapes are and are not detected.
- run-specs.js runner wired into `npm run lint` via test:lint-rules;
refuses to run under test-framework globals and counts RuleTester.run
invocations so a spec that asserts nothing fails instead of passing.
- Correct the ALL_ACTIONS JSDoc in local-actions.token.ts to match
reality (archive-operation-handler uses LOCAL_ACTIONS).
Reviewed via parallel multi-agent review; findings W1/W2/W4 and a
dangling doc anchor addressed.
|
||
|---|---|---|
| .. | ||
| android-background-sync-improvements.md | ||
| caldav-vevent-expansion-design.md | ||
| calendar-two-way-sync-technical-analysis.md | ||
| e2e-encryption-architecture-diagrams.md | ||
| e2e-encryption-CRITICAL-ISSUES.md | ||
| e2e-encryption-device-keys-DRAFT.md | ||
| electron-upgrade-to-v40.md | ||
| google-calendar-integration-concept.md | ||
| google-calendar-provider-design.md | ||
| ios-dropbox-sync-reliability.md | ||
| jwt-derived-encryption.md | ||
| location-based-reminders.md | ||
| multi-client-file-sync-reliability.md | ||
| plugin-view-adapter-api.md | ||
| secure-storage.md | ||
| server-side-entity-versioning.md | ||
| supersync-encryption-at-rest.md | ||
| sync-core-extraction-plan.md | ||
| sync-core-simplification-roadmap.md | ||
| sync-provider-plugins.md | ||