overengineeringstudio / overengineeringstudio/effect-utils

Track Notion DB Markdown Sync ratification residuals

Open
#797 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
TypeScript
Stars
82
Forks
2
Avg merge
1d 8h
Merged PRs (30d)
121

Description

Context

During ratification of context/notion-db-markdown-sync/decisions/proposed/, the old 0012-tracked-phase-followups.md record was not graduated into the VRS decision log because it was a follow-up ledger, not a durable architecture decision.

The ratified VRS decisions absorb or supersede several items from that ledger, but a few residuals should remain explicitly tracked outside the VRS decision directory.

Residuals to audit

  • Dry-run coverage for object/attachment storage and bodies-on .nmd materialization where the mechanism exists but fixtures do not yet falsifiably prove it.
  • Settlement-proof production wiring currently described by TODO(settlement-wiring) if any dormant path remains.
  • Transactional createReplicaSchema creation so schema and CDC triggers cannot be observed half-installed.
  • Matrix scenarios still declared from docs/vrs/spec.md instead of concrete executable tests, especially daemon-timing, fixture, and live-lane cases.
  • Any remaining comments that say a gap is tracked by the removed proposed ledger should point to this issue or to a concrete follow-up issue.

Acceptance

  • Each remaining residual is either closed, linked to a concrete issue, or intentionally documented as out of scope.
  • Traceability comments do not reference decisions/proposed or deleted proposed decision numbers.
  • Scenario metadata points to executable tests where behavior is genuinely proven.
Posted on behalf of @schickling
field value
agent_name 🪈 co3-bamboo
agent_session_id 9da5ad15-1bd0-45db-9c57-4019b40f4b3e
agent_tool Codex CLI
agent_tool_version 0.139.0
agent_runtime Codex CLI 0.139.0
agent_model unknown
runtime_profile /nix/store/vbrylslg57mvx748zfp3isciclxgcdpr-coding-agent-runtime-profile/share/coding-agents/profile.json
skills_manifest /nix/store/fvv30n06w09dxnsd5s6blb6dxzpmk8x4-agent-skills-corpus/share/agent-skills/manifest.json
worktree effect-utils/schickling/2026-06-10-756
machine dev3
tooling_profile dotfiles@d0b580e

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by auditing context/notion-db-markdown-sync/decisions/proposed/ and docs/vrs/spec.md, then search for TODO(settlement-wiring), removed proposed decision references, and scenario metadata that lacks executable tests. Check each listed residual against the repository and classify it as closed, linked, or out of scope. Done means traceability is current and scenario metadata points to genuinely proven tests.

Written by the indexing model from the issue text.

Assessment

Tech stack
typescript
Domain
backend, documentation, testing
Issue type
Refactor
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.