suite-scaffold-gen
SuiteScaffoldGen
Scaffold a new CLEF suite named $ARGUMENTS with a suite.yaml manifest, concept spec stubs, and sync directory structure.
When to use: Use when creating a new CLEF suite from scratch. Generates a suite.yaml manifest with concept declarations, sync tier groupings, type parameter alignment, and directory structure stubs.
Design Principles
- Convention Over Configuration: Generated suite.yaml follows the standard layout — concepts at top, syncs by tier, uses for external references. Tools work without extra configuration.
- Type Parameter Alignment: Every concept's type parameter has an
astag that enables cross-concept type alignment. Concepts sharing the sameastag share the same entity type. - Sync Tier Discipline: Required syncs protect data integrity. Recommended syncs provide useful defaults. Integration syncs wire to external suites. Never promote a recommended sync to required without justification.
Step-by-Step Process
More from itshalffull/concept-oriented-programming-framework
concept-scaffold-gen
Generate concept specification ( . concept ) file scaffolds from provided configuration including name , type parameters , state fields , actions , and invariants
10handler-scaffold-gen
Generate TypeScript concept handler ( . handler . ts ) implementation scaffolds from provided configuration including concept name , action signatures , and storage patterns . Defaults to functional ( StorageProgram ) style ; falls back to imperative style only when explicitly requested . Optionally generates a conformance test file
9project-scaffold
Initialize new Clef projects with the standard directory structure , example concept specs , and configuration files
1deploy-scaffold-gen
Generate deployment manifest ( deploy . yaml ) scaffolds from provided configuration including runtimes , concepts , and infrastructure settings
1sync-scaffold-gen
Generate synchronization rule ( . sync ) file scaffolds from provided configuration including trigger patterns , guard conditions , and effect actions
1deployment-validator
Parse and validate deployment manifests against compiled concepts and syncs . Produce deployment plans with transport assignments , runtime mappings , and sync to engine bindings
1