Skip to content

feat(core,cli): norms capture with lookback window consensus #47

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
aridyckovsky wants to merge 7 commits into
base: main
Choose a base branch
from
Open

feat(core,cli): norms capture with lookback window consensus #47

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
5da1cf5
feat(core): add norms schemas and error types
aridyckovsky Nov 9, 2025
000c84a
feat(core): implement pure norm detection algorithm
aridyckovsky Nov 9, 2025
ef7fda1
feat(core): add DirectorySummarizer service
aridyckovsky Nov 9, 2025
4649cad
feat(cli): add norms capture command
aridyckovsky Nov 9, 2025
5d9cbf4
feat(core,cli): wire up norms feature exports
aridyckovsky Nov 9, 2025
b76853e
docs: add norms capture planning and PR draft
aridyckovsky Nov 9, 2025
97cb2b3
chore: add changesets for norms capture feature
aridyckovsky Nov 9, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions .changeset/easy-peas-fry.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
"@effect-migrate/cli": minor
---

Add norms capture command for analyzing migration checkpoint history and detecting established norms. New command effect-migrate norms capture provides prepare-only mode (default) for preview without writes, with options for status filtering (migrated/in-progress/all), directory filtering, lookback window customization (default: 5), min-files threshold, and overwrite control. Outputs JSON summaries to .amp/effect-migrate/norms/ using Schema.encodeSync for proper DateTimeUtc serialization. Includes user guidance for AGENTS.md documentation workflow. Supports --json flag and --amp-out directory configuration. Includes 15 new CLI integration tests covering all options and error paths.
5 changes: 5 additions & 0 deletions .changeset/wise-steaks-wave.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
"@effect-migrate/core": minor
---

Add norms capture feature for detecting established migration norms from checkpoint history. New DirectorySummarizer service analyzes audit checkpoints using lookback window consensus algorithm (default K=5) to identify rules that went to zero and stayed there. Exports DirectoryStatus, Norm, and DirectorySummary schemas with comprehensive JSDoc, along with tagged errors (NoCheckpointsError, InvalidDirectoryError, NormDetectionError, SummaryWriteError). Pure functions (detectExtinctNorms, computeDirectoryStats, determineStatus, findCleanTimestamp) enable testability with 100% coverage. Reuses existing Severity and CheckpointSummary schemas for consistency. Includes 38 new tests with realistic checkpoint fixtures.
Loading