handler-scaffold-gen
HandlerScaffoldGen
Scaffold a TypeScript handler for concept $ARGUMENTS with typed actions, storage patterns, and a conformance test.
When to use: Use when implementing a concept handler in TypeScript. Generates a .handler.ts handler with register(), typed action methods, input extraction, storage patterns, and a conformance test file.
Design Principles
- One Handler per Action: Each action in the concept spec maps to exactly one async method in the handler.
- Variant Completeness: Every return variant declared in the spec must have a corresponding code path — no missing branches.
- Storage Sovereignty: Each concept owns its storage exclusively — no shared databases, no cross-concept state access.
- Input Extraction: Extract inputs with
ascasts at the top of each method. Validate required fields before processing.
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
10project-scaffold
Initialize new Clef projects with the standard directory structure , example concept specs , and configuration files
1suite-scaffold-gen
Generate suite manifest ( suite . yaml ) scaffolds and directory structures for new Clef suites from provided configuration
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