overengineeringstudio / overengineeringstudio/effect-utils

Unify notion db command descriptors to prevent parser/help drift

Open
#729 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

The notion db cleanup removed the remaining public migrate/repair leaves and aligned docs/tests, but the command surface is still described in multiple places: the import-safe Effect CLI descriptor, the handwritten Node parser/help text, and the Nix wrapper dispatch list.\n\nFollow-up: define a single internal command descriptor or add a focused drift test that proves parser-accepted commands, help/completions, and Nix dispatch stay aligned.\n\nThis is not blocking the current clean-break CLI surface, but it would reduce future redundancy and accidental public-surface drift.

Posted on behalf of @schickling
field value
agent_name 🗿 co2-scarp
agent_session_id c857a188-a4d1-4bbf-ab7b-b196254c5ec3
agent_tool Codex CLI
agent_tool_version 0.131.0
agent_runtime Codex CLI 0.131.0
agent_model unknown
worktree effect-utils/schickling/2026-05-25-notion-md-db
machine dev3
tooling_profile dotfiles@unknown-dirty

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 locating the import-safe Effect CLI descriptor, the handwritten Node parser/help text, and the Nix wrapper dispatch list. Compare their accepted commands, help/completions, and dispatch behavior; done means a shared descriptor or focused drift test keeps these surfaces aligned.

Written by the indexing model from the issue text.

Assessment

Tech stack
typescript
Domain
cli
Issue type
Refactor
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
48/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.