Skip to content

Conversation

@ricksaarge
Copy link
Collaborator

BREAKING CHANGE: Multiple breaking changes to spec format

Date handling changes:

  • Remove positional dates (bare YYYY-MM-DD after priority)
  • All dates now require key:value syntax (planned:, due:, done:)
  • Rename frontmatter field: date_format → datetime_format
  • Add bracket syntax for optional time: %d/%m/%Y[ %H:%M]

Repository reorganization:

  • Move specification from docs/ to spec/
  • Move implementation docs (compatibility, libraries) to docs/
  • Flatten tests/golden/ to tests/
  • Remove examples/ (converted to golden tests T12-T15)

New content:

  • Add golden test suite T01-T15 with full conformance coverage
  • Add TESTING.md with test harness documentation
  • Add CATALOG.md with detailed coverage matrix

Config updates:

  • Update CI, pre-commit, and release configs for new paths
  • Add docs(spec) scope rule for semantic release
  • Exclude tests/ from linting (intentional edge cases)

BREAKING CHANGE: Multiple breaking changes to spec format

Date handling changes:
- Remove positional dates (bare YYYY-MM-DD after priority)
- All dates now require key:value syntax (planned:, due:, done:)
- Rename frontmatter field: date_format → datetime_format
- Add bracket syntax for optional time: %d/%m/%Y[ %H:%M]

Repository reorganization:
- Move specification from docs/ to spec/
- Move implementation docs (compatibility, libraries) to docs/
- Flatten tests/golden/ to tests/
- Remove examples/ (converted to golden tests T12-T15)

New content:
- Add golden test suite T01-T15 with full conformance coverage
- Add TESTING.md with test harness documentation
- Add CATALOG.md with detailed coverage matrix

Config updates:
- Update CI, pre-commit, and release configs for new paths
- Add docs(spec) scope rule for semantic release
- Exclude tests/ from linting (intentional edge cases)
@ricksaarge ricksaarge force-pushed the feat/date-and-frontmatter-refactor branch from c7dd472 to 97733ca Compare December 6, 2025 22:49
@ricksaarge ricksaarge merged commit 0f986fe into main Dec 6, 2025
2 checks passed
@ricksaarge ricksaarge deleted the feat/date-and-frontmatter-refactor branch December 6, 2025 22:52
github-actions bot pushed a commit that referenced this pull request Dec 6, 2025
# [2.0.0](v1.2.0...v2.0.0) (2025-12-06)

* docs(spec)!: reorganize repository and simplify date handling ([#6](#6)) ([0f986fe](0f986fe))

### Bug Fixes

* **release:** add breaking change rule to trigger major version ([483fd52](483fd52))

### BREAKING CHANGES

* Multiple breaking changes to spec format

Date handling changes:
- Remove positional dates (bare YYYY-MM-DD after priority)
- All dates now require key:value syntax (planned:, due:, done:)
- Rename frontmatter field: date_format → datetime_format
- Add bracket syntax for optional time: %d/%m/%Y[ %H:%M]

Repository reorganization:
- Move specification from docs/ to spec/
- Move implementation docs (compatibility, libraries) to docs/
- Flatten tests/golden/ to tests/
- Remove examples/ (converted to golden tests T12-T15)

New content:
- Add golden test suite T01-T15 with full conformance coverage
- Add TESTING.md with test harness documentation
- Add CATALOG.md with detailed coverage matrix

Config updates:
- Update CI, pre-commit, and release configs for new paths
- Add docs(spec) scope rule for semantic release
- Exclude tests/ from linting (intentional edge cases)
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.

2 participants