Support aggregate and state-machine spec examples

[slusset]

Summary

• support annotated feature journey references in traceability validation
• accept aggregate, catalog, shared value object, and lifecycle shorthand model forms
• add example specs covering lifecycle, aggregate, catalog, and bundle-style model documents

Validation

• node tools/validate-models.js --files specs/models/account.lifecycle.yaml specs/models/trade-show-onboarding.aggregate.model.yaml specs/models/trade-show-signup.catalog.model.yaml specs/models/shared-value-objects.model.yaml
• node tools/validate-traceability.js --files specs/features/mobile-signup.feature specs/models/trade-show-onboarding.aggregate.model.yaml specs/models/trade-show-signup.catalog.model.yaml specs/models/shared-value-objects.model.yaml
• node tools/validate-traceability.js specs
• node tools/validate-models.js specs (passes with existing warnings in specs/models/account.model.yaml)

Closes #23

[github-actions]

IDD Compliance Review

Check	Status	Errors	Warnings
Traceability	✅	0	0
Front-Matter	✅	0	0
Capability Scope	✅	0	0
Fixtures	✅	0	0
Models	✅	0	3
Journey Maps	✅	0	0
OpenAPI Lint	✅	0	—
Gherkin Lint	✅	0	—

✅ Traceability

Info

• Found 1 persona file(s)
• Checked 1 journey file(s)
• Checked 2 story file(s)
• Checked 1 feature file(s)
• Checked 2 API operation(s) across 1 contract file(s)
• Checked 1 fixture file(s)
• Checked 1 journey map(s)
• Checked 4 model file(s)

✅ Front-Matter

Info

• Checked 13 spec file(s): 13 passed, 0 with issues

✅ Capability Scope

Info

• Found 1 capability file(s): trade-show-signup
• Scope coverage: 9/9 files covered

✅ Fixtures

Info

• specs/fixtures/mobile-signup.fixture.yaml: valid
• Validated 1 fixture file(s)

✅ Models

Warnings

• specs/models/account.model.yaml: Entity should have a description
• specs/models/account.model.yaml: Entity should define identity field
• specs/models/account.model.yaml: Rule "account-activates-on-signup" should have a description

Info

• specs/models/account.lifecycle.yaml: valid
• specs/models/shared-value-objects.model.yaml: valid
• specs/models/trade-show-onboarding.aggregate.model.yaml: valid
• specs/models/trade-show-signup.catalog.model.yaml: valid
• Validated 5 model file(s)

✅ Journey Maps

Info

• specs/journey-maps/trade-show-signup.journey-map.yaml: valid
• Validated 1 journey map file(s)

✅ OpenAPI Lint

No results with a severity of 'error' found!

---

Total: 0 error(s), 3 warning(s)

Automated by IDD Toolkit