Skip to content

Add @AutoContext future hooks parsing infrastructure#71

Merged
SoundBlaster merged 3 commits intomainfrom
claude/execute-startup-commands-01H2oJ7ffZxhJVpvTcEReSTE
Nov 17, 2025
Merged

Add @AutoContext future hooks parsing infrastructure#71
SoundBlaster merged 3 commits intomainfrom
claude/execute-startup-commands-01H2oJ7ffZxhJVpvTcEReSTE

Conversation

@SoundBlaster
Copy link
Owner

Implement argument parsing infrastructure for the @autocontext macro to support
future enhancement flags (environment, infer, custom provider types). This prepares
the macro for graceful evolution as Swift's macro capabilities expand.

Changes:

  • Added argument parsing to AutoContextMacro with enum-based classification
  • Implemented diagnostic system with informative warnings for planned features
  • Added 5 comprehensive test cases validating argument parsing and diagnostics
  • Updated documentation to reflect infrastructure completion
  • Maintained backward compatibility with existing @autocontext usage

The macro now recognizes and parses future flags while emitting appropriate
diagnostics, creating a smooth migration path for future implementations.

Closes P1 task: AutoContext Future Hooks

Implement argument parsing infrastructure for the @autocontext macro to support
future enhancement flags (environment, infer, custom provider types). This prepares
the macro for graceful evolution as Swift's macro capabilities expand.

Changes:
- Added argument parsing to AutoContextMacro with enum-based classification
- Implemented diagnostic system with informative warnings for planned features
- Added 5 comprehensive test cases validating argument parsing and diagnostics
- Updated documentation to reflect infrastructure completion
- Maintained backward compatibility with existing @autocontext usage

The macro now recognizes and parses future flags while emitting appropriate
diagnostics, creating a smooth migration path for future implementations.

Closes P1 task: AutoContext Future Hooks
Add comprehensive roadmap document outlining SpecificationKit's development
path, planned features, and timeline. Update README with roadmap section
linking to the detailed document.

ROADMAP.md includes:
- Current version status (v3.0.0 released)
- Short/mid/long-term feature plans
- @autocontext enhancements with infrastructure status
- Performance optimization roadmap
- Platform enhancement plans
- Community contribution guidelines
- Progress tracking references

README.md updates:
- Added Roadmap to Table of Contents
- Added Roadmap section with highlights before Contributing
- Links to comprehensive ROADMAP.md document
Add comprehensive SpecificationCore documentation to ROADMAP.md. This
major v4.0.0 initiative will extract platform-independent core logic
into a separate Swift Package for improved modularity and cross-platform
support.

Changes:
- Added detailed "SpecificationCore: Platform-Independent Foundation" section
- Documented 6-week implementation timeline with 4 phases
- Listed what moves to Core vs what stays in Kit
- Added success metrics: 20% compile time improvement, <5K LOC, all platforms
- Updated v4.0.0 Version Planning with SpecificationCore details
- Referenced complete planning docs in AGENTS_DOCS/SpecificationCore_PRD/

Key benefits:
- True cross-platform support (Linux, Windows, all Apple platforms)
- Zero platform-specific dependencies in core
- Faster builds for core-only users
- Better testing isolation
- Standalone usage option

Documentation references:
- PRD: AGENTS_DOCS/SpecificationCore_PRD/PRD.md
- Workplan: AGENTS_DOCS/SpecificationCore_PRD/Workplan.md
- TODO: AGENTS_DOCS/SpecificationCore_PRD/TODO.md
@SoundBlaster SoundBlaster merged commit 738d269 into main Nov 17, 2025
3 checks passed
@SoundBlaster SoundBlaster deleted the claude/execute-startup-commands-01H2oJ7ffZxhJVpvTcEReSTE branch November 17, 2025 05:48
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