guardian-framework 0.1.81 → 0.1.83

package/dist/cli.js

@@ -3197,7 +3197,7 @@ __export(exports_package, {
   bin: () => bin,
   author: () => author
 });
-var name = "guardian-framework", version = "0.1.81", 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.83", 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

@@ -1982,7 +1982,7 @@ __export(exports_package, {
   bin: () => bin,
   author: () => author
 });
-var name = "guardian-framework", version = "0.1.81", 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.83", 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.81",
+	"version": "0.1.83",
 	"description": "Token-optimized agentic framework scaffolder with pi-first architecture",
 	"type": "module",
 	"main": "dist/exports.js",

package/templates/pi/architecture/modules/module-template.md

@@ -170,6 +170,8 @@ before the implementation issue can be closed. These ACs flow into the generated
 ## Error Handling
 
 **Domain errors (domain/):**
+
+TypeScript:
 ```typescript
 class [ErrorType] extends Error {
   constructor(code: string, message: string, retriable?: boolean) {
@@ -179,6 +181,23 @@ class [ErrorType] extends Error {
 }
 ```
 
+Java:
+```java
+// domain/error/DomainException.java — abstract base
+public abstract class DomainException extends RuntimeException {
+  private final ErrorCode code;
+  protected DomainException(ErrorCode code, String message) {
+    super(message); this.code = code;
+  }
+  public ErrorCode getCode() { return code; }
+}
+
+// domain/error/DomainError.java — concrete error
+public class DomainError extends DomainException {
+  public DomainError(ErrorCode code, String message) { super(code, message); }
+}
+```
+
 **Recovery:**
 - [Error 1]: [Recovery strategy]
 - [Error 2]: [Recovery strategy]

package/templates/pi/context/patterns.md

@@ -5,27 +5,32 @@
 
 ## Error Handling
 
-{{ERROR_HANDLING_SECTION}}
+**Pattern:** {{ERROR_HANDLING_PATTERN}}
 
-**Rule:** {{ERROR_HANDLING_RULE}}
+**Rule:**
+- **Java:** Domain errors extend `DomainException` (abstract base in `domain/error/`), never `RuntimeException` directly. Use `ErrorCode` enum for machine-readable types. Catch at controller advice layer.
+- **TypeScript:** Use Result type pattern (`ok()`/`err()`) for recoverable errors. Throw typed `extends Error` classes for unrecoverable.
+- **Rust:** Use `Result<T, E>` with custom error enums implementing `std::error::Error`.
+- **Python:** Use custom exception classes inheriting from `Exception`.
+- **Go:** Use sentinel errors with `errors.Is/As`.
 
 ## Tracing
 
-{{TRACING_SECTION}}
+**Pattern:** {{TRACING_PATTERN}}
 
-**Rule:** {{TRACING_RULE}}
+**Rule:** Every handler must propagate trace context. Use correlation IDs across service boundaries.
 
 ## Cancellation
 
-{{CANCELLATION_SECTION}}
+**Pattern:** {{CANCELLATION_PATTERN}}
 
-**Rule:** {{CANCELLATION_RULE}}
+**Rule:** Every async operation must respect cancellation signals. Clean up resources on cancellation.
 
 ## Atomic Writes
 
-{{ATOMIC_WRITE_SECTION}}
+**Pattern:** {{ATOMIC_WRITE_PATTERN}}
 
-**Rule:** {{ATOMIC_WRITE_RULE}}
+**Rule:** Never write files in place. Use write-rename pattern (`.tmp` then rename) or transactional storage.
 
 ## Retry Logic
 

package/templates/pi/preflight_report.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2026-07-16T13:01:09Z",
+  "timestamp": "2026-07-16T13:07:30Z",
   "mode": "all",
   "stages_run": [],
   "summary": {
@@ -8,7 +8,7 @@
     "failed": 1,
     "skipped": 12
   },
-  "duration_seconds": 1,
+  "duration_seconds": 0,
   "results": [
   {
     "name": "check_mr_traceability.sh",
@@ -56,7 +56,7 @@
     "name": "cargo test --lib",
     "status": "fail",
     "message": "unit test failures",
-    "duration": 1
+    "duration": 0
   },
   {
     "name": "integration",

package/templates/pi/skills/java-spring-enterprise-codegen.md

@@ -29,7 +29,9 @@ module/
 │   ├── repository/             # Repository interfaces
 │   │   └── EntityRepository.java
 │   └── error/                  # Typed exception classes
-│       └── DomainError.java
+│       ├── DomainException.java   # Abstract base for all domain errors
+│       ├── DomainError.java      # Concrete domain error
+│       └── ErrorCode.java        # Machine-readable error codes
 ├── application/                # Service interfaces and DTOs
 │   ├── service/                # Service interfaces
 │   │   └── EntityService.java
@@ -177,25 +179,39 @@ public enum Status {
 ## 3. Domain Error Handling
 
 ```java
-// domain/error/DomainError.java
+// domain/error/DomainException.java
 
 package com.project.module.domain.error;
 
-public class DomainError extends RuntimeException {
-
+/**
+ * Base exception for all domain errors.
+ * Extending this (rather than RuntimeException directly) allows
+ * catching all domain-level errors in a single handler.
+ */
+public abstract class DomainException extends RuntimeException {
     private final ErrorCode code;
 
-    public DomainError(String message) {
-        super(message);
-        this.code = ErrorCode.VALIDATION;
-    }
-
-    public DomainError(ErrorCode code, String message) {
+    protected DomainException(ErrorCode code, String message) {
         super(message);
         this.code = code;
     }
 
     public ErrorCode getCode() { return code; }
+}
+
+// domain/error/DomainError.java
+
+package com.project.module.domain.error;
+
+public class DomainError extends DomainException {
+
+    public DomainError(String message) {
+        super(ErrorCode.VALIDATION, message);
+    }
+
+    public DomainError(ErrorCode code, String message) {
+        super(code, message);
+    }
 
     public static DomainError notFound(String id) {
         return new DomainError(ErrorCode.NOT_FOUND, "Resource " + id + " not found");
@@ -221,7 +237,8 @@ public enum ErrorCode {
 ```
 
 ### Rules
-- ✅ Use `RuntimeException` subclasses for domain errors
+- ✅ Use `DomainException` subclasses for domain errors (never `RuntimeException` directly)
+- ✅ Define `DomainException` as an abstract base in `domain/error/`
 - ✅ Use `ErrorCode` enum for machine-readable error types
 - ✅ Use `record` for value objects (Java 16+)
 - ❌ Don't use Spring annotations in domain layer