Skip to content

docs: roadmap, CLI config schema, and rules-engine spec#40

Merged
bntvllnt merged 1 commit into
mainfrom
docs/roadmap-config-schema
Jun 3, 2026
Merged

docs: roadmap, CLI config schema, and rules-engine spec#40
bntvllnt merged 1 commit into
mainfrom
docs/roadmap-config-schema

Conversation

@bntvllnt

@bntvllnt bntvllnt commented Jun 3, 2026

Copy link
Copy Markdown
Owner

What

Adds the strategic + contract docs for the next phase. Docs/config only — no source changes.

  • roadmap.md — phased roadmap in two tracks: parity (dead code, duplication, health, boundaries, audit gate, output formats, suppressions, LSP) and differentiation. Flagship: Highways — data-flow convergence that detects divergent "cowpaths" for one logical data operation and proposes the canonical unified path (name, location, signature, reroute plan). Read-only stance; LSP yes; no auto-fix / no VS Code extension.
  • schema.json — JSON Schema (draft 2020-12) for the CLI config: ESLint-style rules (incl. no-comments), boundaries, thresholds, ci gate.
  • codebase-intelligence.json — example/default config (schema-linked, dogfooded).
  • specs/backlog/2026-06-02-config-rules-engine.md — config discovery + loader, ESLint-style rules engine, no-comments rule, and CI gate (exit codes, formats, GitHub/GitLab).

Notes

  • No competitor referenced anywhere.
  • Implementation of the engine is not in this PR — spec only.

Test

Docs/JSON only. schema.json + codebase-intelligence.json validated (parse + rule-name alignment).

- roadmap.md: phased roadmap (parity + differentiation tracks), data-flow
  convergence (Highways) flagship that proposes canonical unified paths, LSP
  live-diagnostics surface, read-only stance
- schema.json: JSON Schema for the CLI config (rules, boundaries, CI gate)
- codebase-intelligence.json: example/default config
- specs/backlog: config loader + ESLint-style rules engine + no-comments rule + CI gate
@bntvllnt bntvllnt self-assigned this Jun 3, 2026
@bntvllnt bntvllnt merged commit fe8fc48 into main Jun 3, 2026
2 checks passed
@bntvllnt bntvllnt deleted the docs/roadmap-config-schema branch June 3, 2026 19:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant