guardian-framework 0.1.123 → 0.1.125

package/dist/cli.js

@@ -3202,7 +3202,7 @@ __export(exports_package, {
   bin: () => bin,
   author: () => author
 });
-var name = "guardian-framework", version = "0.1.123", description = "Token-optimized agentic framework scaffolder with pi-first architecture", type = "module", main = "dist/exports.js", exports, types = "dist/exports.d.ts", bin, files, engines, scripts, publishConfig, pi, repository, homepage = "https://github.com/arman-jalili/guardian-framework#readme", bugs, dependencies, devDependencies, keywords, author = "Arman Wolkensteiner-Jalili", license = "MIT", package_default;
+var name = "guardian-framework", version = "0.1.125", description = "Token-optimized agentic framework scaffolder with pi-first architecture", type = "module", main = "dist/exports.js", exports, types = "dist/exports.d.ts", bin, files, engines, scripts, publishConfig, pi, repository, homepage = "https://github.com/arman-jalili/guardian-framework#readme", bugs, dependencies, devDependencies, keywords, author = "Arman Wolkensteiner-Jalili", license = "MIT", package_default;
 var init_package = __esm(() => {
   exports = {
     ".": {

package/dist/exports.js

@@ -1987,7 +1987,7 @@ __export(exports_package, {
   bin: () => bin,
   author: () => author
 });
-var name = "guardian-framework", version = "0.1.123", description = "Token-optimized agentic framework scaffolder with pi-first architecture", type = "module", main = "dist/exports.js", exports, types = "dist/exports.d.ts", bin, files, engines, scripts, publishConfig, pi, repository, homepage = "https://github.com/arman-jalili/guardian-framework#readme", bugs, dependencies, devDependencies, keywords, author = "Arman Wolkensteiner-Jalili", license = "MIT", package_default;
+var name = "guardian-framework", version = "0.1.125", description = "Token-optimized agentic framework scaffolder with pi-first architecture", type = "module", main = "dist/exports.js", exports, types = "dist/exports.d.ts", bin, files, engines, scripts, publishConfig, pi, repository, homepage = "https://github.com/arman-jalili/guardian-framework#readme", bugs, dependencies, devDependencies, keywords, author = "Arman Wolkensteiner-Jalili", license = "MIT", package_default;
 var init_package = __esm(() => {
   exports = {
     ".": {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "guardian-framework",
-	"version": "0.1.123",
+	"version": "0.1.125",
 	"description": "Token-optimized agentic framework scaffolder with pi-first architecture",
 	"type": "module",
 	"main": "dist/exports.js",

package/templates/pi/extensions/domain-explorer.ts

@@ -193,6 +193,7 @@ function mergeRawJson(existing: Record<string, unknown>, incoming: Record<string
 	mergeArr("functionalRequirements", ["id"]);
 	mergeArr("nonFunctionalRequirements", ["id"]);
 	mergeArr("assumptions", ["assumption"]);
+	mergeArr("applicationServices", ["name", "context"]);
 	mergeArr("domainEvents", ["name", "context"]);
 	mergeArr("ubiquitousLanguage", ["term", "boundedContext"]);
 	// entities dedupe by (context, name)
@@ -484,6 +485,7 @@ export default function (pi: ExtensionAPI) {
 			const ents = toRow(parsedJson.entities as unknown[], ["name", "context", "type", "description"]);
 			const evts = toRow(parsedJson.domainEvents as unknown[], ["name", "context", "description", "triggeredBy"]);
 			const ul = toRow(parsedJson.ubiquitousLanguage as unknown[], ["term", "definition", "boundedContext", "aliases"]);
+			const ucs = toRow(parsedJson.applicationServices as unknown[], ["name", "context", "useCase", "commands"]);
 			const oq = String(parsedJson.openQuestions ?? "None");
 			const ar = String(parsedJson.aggregateRoots ?? "None");
 
@@ -509,6 +511,8 @@ export default function (pi: ExtensionAPI) {
 				"", "| Event | Context | Description | Triggered By |", "|-------|---------|-------------|-------------|", evts,
 				"", "---", "", "## Ubiquitous Language",
 				"", "| Term | Definition | Bounded Context | Aliases/Synonyms |", "|------|-----------|----------------|-----------------|", ul,
+				"", "---", "", "## Use Cases (Application Services)",
+				"", "| Use Case | Context | Description | Commands / Collaborators |", "|-----------|---------|-------------|---------------------------|", ucs,
 				"", "---", "", "## Open Questions", "", oq,
 				"", "---", "", "## Aggregate Roots", "", ar,
 			].join("\n");
@@ -659,6 +663,7 @@ export default function (pi: ExtensionAPI) {
 						["entities", "entities", "per-context pass (step 2)"],
 						["domainEvents", "domain events", "per-context pass (step 2)"],
 						["ubiquitousLanguage", "ubiquitous-language terms", "per-context pass (step 2)"],
+						["applicationServices", "use cases / application services", "use-cases pass (step 1c)"],
 					];
 					const empty = sections.filter(([key]) => !Array.isArray(raw[key]) || (raw[key] as unknown[]).length === 0);
 					if (empty.length > 0) {
@@ -915,6 +920,17 @@ export default function (pi: ExtensionAPI) {
 					'}',
 					'```',
 					"",
+					"1c. USE-CASES PASS (next message): reply with ONLY this JSON for ALL core contexts, then call",
+					"domain_save_result (merge is by name+context):",
+					'```json',
+					'{',
+					'  "applicationServices": [',
+					'    { "name": "ApproveRequest", "context": "ApprovalWorkflow", "useCase": "what this application service orchestrates",',
+					'      "commands": ["verify intent", "consume"], "aggregates": ["ApprovalTicket"], "mapsToFr": "FR-00x" }',
+					'  ]',
+					'}',
+					'```',
+					"",
 					"2. PER-CONTEXT PASS (repeat for EACH core/tactical bounded context, one context per message):",
 					"reply with ONLY this JSON for one context, then call domain_save_result again:",
 					'```json',
@@ -1332,6 +1348,15 @@ export default function (pi: ExtensionAPI) {
 					"8. **Ubiquitous Language** — Terms for this context from `.pi/domain/ubiquitous-language.md`",
 					"9. **Dependencies** — Depends On + Used By",
 					"10. **Implementation Sequence** — Ordered build list",
+					"11. **Patterns & OOP Mapping** — for every tactical aggregate and application",
+					"    service, state the design pattern(s) it uses + a one-line rationale:",
+					"    Strategy (when a rule/algorithm has 2+ variants — fee/tax/gate policies),",
+					"    Factory (ONLY for complex aggregate creation), Specification (combinable",
+					"    business rules), Observer/domain events (cross-aggregate flows), record/DTO",
+					"    & value objects (immutables, @Embeddable). OOP: no anemic aggregates, no",
+					"    setters on roots, tell-don't-ask, CQS. Do NOT abstract speculatively — only",
+					"    introduce an interface/strategy when 2+ variants are known (curriculum rule).",
+					"    Ensure code stubs reflect the chosen patterns.",
 					"",
 					"### STEP 4: Generate Implementation Roadmap",
 					"",

package/templates/pi/preflight_report.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2026-09-05T07:57:08Z",
+  "timestamp": "2026-09-05T10:50:53Z",
   "mode": "all",
   "stages_run": [],
   "summary": {

package/templates/pi/skills/agents/architecture-validator.md

@@ -92,6 +92,12 @@ commands are per-language; hard gates (deterministic) live in
   service with no production caller outside its own module and outside tests
   is dead code: report it and require the Runtime-Integration issue. Evidence:
   `grep -rn "<ServiceName>" <src> | grep -v tests` per language.
+- **R6 patterns & OOP appropriateness** — for each implemented aggregate/application
+  service, confirm the chosen pattern is justified: if/switch on type in
+  app/domain suggests Strategy (only when ≥2 known variants), complex creation
+  without a Factory, anemic aggregates (no behavior methods), setters on roots,
+  tell-don't-ask/CQS violations. Warn on speculative abstraction too (single
+  variant behind an interface). Evidence: `file:line` + the pattern rationale.
 
 ## Output
 Use format from `.pi/context/output-formats.md` → "Validation Report"