guardian-framework 0.1.10 → 0.1.12

package/dist/cli.js

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

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

package/templates/pi/INDEX.md

@@ -85,6 +85,7 @@ DO NOT EDIT DIRECTLY - Modify source in .pi/
 │   └── output-formats.md      # Report templates
 │
 ├── skills/
+│   ├── rust-enterprise-codegen.md
 │   ├── agents/
 │   │   ├── architecture-coordinator.md
 │   │   ├── architecture-validator.md
@@ -415,6 +416,7 @@ When running `guardian-framework generate`, `.pi/` files are transformed:
 | `AGENTS.md` | `.github/copilot-instructions.md` | YAML frontmatter + canonical header |
 | `architecture/modules/*.md` | `.claude/architecture/*.md` | Direct copy + canonical header |
 | `architecture/CHANGELOG.md` | `.claude/architecture/CHANGELOG.md` | Direct copy |
+| `skills/rust-enterprise-codegen.md` | `.pi/skills/rust-enterprise-codegen.md` | Direct copy — full reference patterns |
 | `skills/agents/*.md` | `.claude/agents/*.md`, `.github/agents/*.agent.md` | Direct copy + YAML frontmatter |
 | `skills/validators/*.md` | `.opencode/prompts/*.txt` | Convert to .txt, compress |
 | `context/*.md` | `.claude/context/*.md`, `.opencode/context/*.md` | Direct copy + canonical header |

package/templates/pi/extensions/architect-lib/generators.ts

@@ -7,6 +7,7 @@ export function generateIssueMarkdown(
 	slice: ArchitectureSlice,
 	issueIndex: number,
 	totalIssues: number,
+	codegenSkill?: string,
 ): string {
 	const moduleId = slice.module.replace(/^module-/, "");
 	const componentName = component.name.toLowerCase().replace(/\s+/g, "-");
@@ -64,6 +65,7 @@ ${component.dependencies.map((d) => `    - "${d}"`).join("\n")}
 
   implementation_notes: |
     ${component.description || "Implement this component according to the architecture module."}
+    ${codegenSkill ? `Follow: .pi/skills/agents/${codegenSkill}.md` : ""}
 
   file_changes:
     - "create: src/${moduleId}/${componentName}/"

package/templates/pi/extensions/architect-lib/helpers.ts

@@ -221,6 +221,27 @@ export function readGroupId(cwd: string): string {
     return "com.example";
 }
 
+export function readLanguage(cwd: string): string {
+    const manifestPath = join(cwd, "guardian-manifest.json");
+    try {
+        const raw = readFileSync(manifestPath, "utf-8");
+        const manifest = JSON.parse(raw) as { language?: string };
+        if (manifest.language) return manifest.language;
+    } catch {}
+    return "typescript";
+}
+
+export function codegenSkillName(language: string): string {
+    const map: Record<string, string> = {
+        "rust": "rust-codegen",
+        "go": "go-codegen",
+        "python": "python-codegen",
+        "typescript": "typescript-codegen",
+        "java": "java-codegen",
+    };
+    return map[language] || "typescript-codegen";
+}
+
 export function findModuleByName(cwd: string, name: string): string | null {
     const files = discoverModules(cwd);
     const nameLower = name.toLowerCase().replace(/[^a-z0-9]/g, "");

package/templates/pi/extensions/architect.ts

@@ -180,6 +180,29 @@ function readRepository(cwd: string): string | null {
 	return null;
 }
 
+function readLanguage(cwd: string): string {
+	const manifestPath = join(cwd, "guardian-manifest.json");
+	try {
+		if (existsSync(manifestPath)) {
+			const raw = readFileSync(manifestPath, "utf-8");
+			const manifest = JSON.parse(raw) as { language?: string };
+			if (manifest.language) return manifest.language;
+		}
+	} catch {}
+	return "typescript";
+}
+
+function codegenSkillName(language: string): string {
+	const map: Record<string, string> = {
+		rust: "rust-codegen",
+		go: "go-codegen",
+		python: "python-codegen",
+		typescript: "typescript-codegen",
+		java: "java-codegen",
+	};
+	return map[language] || "typescript-codegen";
+}
+
 /**
  * Get Git platform base URL. For GitLab, tries to detect self-hosted instances.
  */
@@ -693,6 +716,7 @@ function generateIssueMarkdown(
 	slice: ArchitectureSlice,
 	issueIndex: number,
 	totalIssues: number,
+	codegenSkill?: string,
 ): string {
 	const moduleId = slice.module.replace(/^module-/, "");
 	const componentName = component.name.toLowerCase().replace(/\s+/g, "-");
@@ -750,6 +774,7 @@ ${component.dependencies.map((d) => `    - "${d}"`).join("\n")}
 
   implementation_notes: |
     ${component.description || "Implement this component according to the architecture module."}
+    ${codegenSkill ? `Follow: .pi/skills/agents/${codegenSkill}.md` : ""}
 
   file_changes:
     - "create: src/${moduleId}/${componentName}/"
@@ -1275,6 +1300,8 @@ class EpicManager {
 		name: string,
 		trackingIssueId?: string,
 	): Promise<EpicState> {
+		const lang = readLanguage(this.cwd);
+		const skillName = codegenSkillName(lang);
 		const moduleFiles = discoverModules(this.cwd);
 		if (moduleFiles.length === 0) {
 			throw new Error("No architecture modules found in .pi/architecture/modules/.");
@@ -1411,7 +1438,7 @@ class EpicManager {
 				status: "planned" as string,
 				remoteIssueId: null as string | null,
 			};
-			const md = generateIssueMarkdown(comp, slice, i, slice.nextLogicalSlice.length);
+			const md = generateIssueMarkdown(comp, slice, i, slice.nextLogicalSlice.length, skillName);
 			writeFileSync(join(issuesDir, `${id}.md`), md);
 			if (hasRemote && remoteRepo) {
 				const result = createRemoteIssue(this.cwd, entry.title, join(issuesDir, `${id}.md`), "epic,implementation", remoteRepo);

package/templates/pi/preflight_report.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2026-07-03T04:04:20Z",
+  "timestamp": "2026-07-03T05:15:47Z",
   "mode": "all",
   "stages_run": [],
   "summary": {

package/templates/pi/skills/agents/go-codegen.md

@@ -0,0 +1,42 @@
+---
+name: go-codegen
+description: Minimal skill for Go code generation with DDD + Clean Architecture. References full patterns on demand — never loads inline. Use when implementing Go modules following enterprise patterns.
+model: inherit
+tools: [Read, Grep]
+---
+
+# Go Code Generation — DDD + Clean Architecture Patterns
+
+> Do NOT load the full reference document. Read specific sections when needed.
+> Full reference: `.pi/skills/go-enterprise-codegen.md`
+
+## Quick Reference
+
+| When you need... | Read this section |
+|-----------------|-------------------|
+| Module structure | Section 1 — 4-layer DDD layout + dependency direction |
+| Domain entities | Section 2 — entity.go, value.go, repository interface |
+| Error handling | Section 3 — *DomainError, ErrorCode, sentinel errors |
+| Application services | Section 4 — Service interface + implementation |
+| Repository impl | Section 5 — GORM/sql implementation pattern |
+| HTTP handlers | Section 6 — Handler → Service → Domain flow |
+| Configuration | Section 7 — envconfig/viper pattern |
+| Testing | Section 8 — unit tests, repository tests |
+| Anti-patterns | Section 9 — what NOT to do |
+| Project structure | Section 10 — cmd/ internal/ pkg/ layout |
+
+## DDD Layer Contract
+
+| Layer | Purpose | Dependencies |
+|-------|---------|-------------|
+| `domain/` | Pure business logic | None (stdlib only) |
+| `application/` | Use case orchestration | `domain/` |
+| `infrastructure/` | External adapters | `domain/` + `application/` |
+| `interfaces/` | API contracts | `application/` |
+
+## Rules
+- NEVER read full reference — read specific sections
+- Use `grep` + `Read offset/limit` to target sections
+- Follow the DDD layer structure — no `contracts/` wrapper
+- Always define repository interfaces in `domain/`, implement in `infrastructure/`
+- Always use typed `*DomainError`, never bare strings

package/templates/pi/skills/agents/java-codegen.md

@@ -0,0 +1,42 @@
+---
+name: java-codegen
+description: Minimal skill for Java/Spring Boot code generation with DDD + Clean Architecture. References full patterns on demand — never loads inline. Use when implementing Java modules following enterprise patterns.
+model: inherit
+tools: [Read, Grep]
+---
+
+# Java/Spring Boot Code Generation — DDD + Clean Architecture Patterns
+
+> Do NOT load the full reference document. Read specific sections when needed.
+> Full reference: `.pi/skills/java-spring-enterprise-codegen.md`
+
+## Quick Reference
+
+| When you need... | Read this section |
+|-----------------|-------------------|
+| Module structure | Section 1 — 4-layer DDD layout + dependency direction |
+| Domain entities | Section 2 — Entity.java, Value Object record, Repository interface |
+| Error handling | Section 3 — DomainError, ErrorCode enum |
+| Application services | Section 4 — @Service, interface + impl pattern |
+| Repository impl | Section 5 — JPA EntityManager repository |
+| REST controllers | Section 6 — @RestController, @ExceptionHandler |
+| Testing | Section 7 — MockMvc, @SpringBootTest |
+| Anti-patterns | Section 8 — what NOT to do |
+| Project structure | Section 9 — Maven/Gradle module layout |
+
+## DDD Layer Contract
+
+| Layer | Purpose | Dependencies |
+|-------|---------|-------------|
+| `domain/` | Pure business logic | None (pure Java, no Spring) |
+| `application/` | Use case orchestration | `domain/` |
+| `infrastructure/` | External adapters | `domain/` + `application/` |
+| `interfaces/` | API contracts | `application/` |
+
+## Rules
+- NEVER read full reference — read specific sections
+- Use `grep` + `Read offset/limit` to target sections
+- Follow the DDD layer structure — no `contracts/` wrapper
+- Domain layer has ZERO Spring annotations
+- Use constructor injection, NEVER field injection
+- Use `record` for value objects (Java 16+)

package/templates/pi/skills/agents/python-codegen.md

@@ -0,0 +1,41 @@
+---
+name: python-codegen
+description: Minimal skill for Python code generation with DDD + Clean Architecture. References full patterns on demand — never loads inline. Use when implementing Python modules following enterprise patterns.
+model: inherit
+tools: [Read, Grep]
+---
+
+# Python Code Generation — DDD + Clean Architecture Patterns
+
+> Do NOT load the full reference document. Read specific sections when needed.
+> Full reference: `.pi/skills/python-enterprise-codegen.md`
+
+## Quick Reference
+
+| When you need... | Read this section |
+|-----------------|-------------------|
+| Module structure | Section 1 — 4-layer DDD layout + dependency direction |
+| Domain entities | Section 2 — entity.py, value.py, repository ABC |
+| Error handling | Section 3 — DomainError, ErrorCode enum |
+| Application services | Section 4 — Service class |
+| Repository impl | Section 5 — SQLAlchemy implementation pattern |
+| API controllers | Section 6 — FastAPI route handlers, error mapping |
+| Testing | Section 7 — pytest unit tests |
+| Anti-patterns | Section 8 — what NOT to do |
+| Project structure | Section 9 — src/ module layout |
+
+## DDD Layer Contract
+
+| Layer | Purpose | Dependencies |
+|-------|---------|-------------|
+| `domain/` | Pure business logic | None (stdlib only) |
+| `application/` | Use case orchestration | `domain/` |
+| `infrastructure/` | External adapters | `domain/` + `application/` |
+| `interfaces/` | API contracts | `application/` |
+
+## Rules
+- NEVER read full reference — read specific sections
+- Use `grep` + `Read offset/limit` to target sections
+- Follow the DDD layer structure — no `contracts/` wrapper
+- Use `@dataclass(frozen=True)` for value objects
+- Use `ABC` for repository interfaces

package/templates/pi/skills/agents/rust-codegen.md

@@ -0,0 +1,70 @@
+---
+name: rust-codegen
+description: Minimal skill for Rust code generation with DDD + Clean Architecture. References full patterns on demand — never loads inline. Use when implementing Rust modules following enterprise patterns.
+model: inherit
+tools: [Read, Grep]
+---
+
+# Rust Code Generation — DDD + Clean Architecture Patterns
+
+> Do NOT load the full reference document. Read specific sections below when needed.
+> Full reference: `.pi/skills/rust-enterprise-codegen.md`
+
+## Quick Reference
+
+When implementing, read ONLY the section you need:
+
+| When you need... | Read this section from the reference |
+|-----------------|--------------------------------------|
+| Module structure | Section 1 — Clean Architecture 4-layer layout + header template + dependency direction |
+| Aggregate root | Section 2 — DDD aggregate root with command methods, entity encapsulation |
+| Value objects | Section 2 — Immutable value objects with self-validation |
+| Repository pattern | Section 2 — Interface + implementation separation, collection semantics |
+| Domain events | Section 2 (tactical) + Section 8 — Tagged union, serde, correlation IDs |
+| Error types | Section 3 — thiserror enums, root error aggregation, is_retriable(), #[source] |
+| Secret handling | Section 4 — Secret value object with redacted Display |
+| State machines | Section 5 — Typed enum with is_terminal(), transition methods, tracking entity |
+| RAII guards | Section 6 — Budget reservation with Drop auto-release |
+| Async patterns | Section 7 — JoinSet, CancellationToken, select!, bounded channels |
+| Configuration | Section 9 — Multi-source merging (flags > env > file > defaults) |
+| Atomic file ops | Section 10 — write-tmp → fsync → rename pattern |
+| Complex builders | Section 11 — Builder pattern + named constructors |
+| Retry/backoff | Section 12 — BackoffStrategy enum |
+| EventBus | Section 13 — broadcast channel, in-memory log, drain() |
+| Tests | Section 14 — AAA pattern, serde round-trip, proptest, concurrency |
+| Documentation | Section 15 — Module header template, @canonical refs, public API docs |
+| Anti-patterns | Section 16 — what NOT to do (anyhow, unwrap, sync Mutex across await, etc.) |
+| Dependencies | Section 17 — Cargo.toml conventions |
+
+## Command
+
+```
+# Read the section you need (use the Read tool with limit parameter):
+Read file_path=".pi/skills/rust-enterprise-codegen.md" limit=60
+# Or grep for a specific section header:
+Grep pattern="## 7\. Async" path=".pi/skills/rust-enterprise-codegen.md"
+# Then Read with offset/limit targeting the lines you need
+```
+
+## DDD Layer Contract
+
+Each module follows this strict 4-layer structure:
+
+| Layer | Purpose | Dependencies | Contains |
+|-------|---------|-------------|----------|
+| `domain/` | Pure business logic | None (serde, chrono, uuid only) | Entities, value objects, aggregates, domain events, repository traits |
+| `application/` | Use case orchestration | `domain/` | Service traits, DTOs, factory interfaces |
+| `infrastructure/` | External adapters | `application/` + `domain/` | Repository implementations, DB clients, HTTP clients |
+| `interfaces/` | API contracts | `application/` | HTTP routes, request/response DTOs, event consumers |
+
+**Dependency Rule:** Inner layers never depend on outer layers. `domain/` depends on nothing. `application/` depends on `domain/`. `infrastructure/` depends on `application/`. `interfaces/` depends on `application/`.
+
+## Rules
+
+- NEVER read the full reference document into context — read specific sections
+- Target reads with `grep` + line numbers instead
+- Each agent loads only the patterns it needs for its current task
+- ALWAYS follow the 4-layer DDD structure — no `contracts/` wrapper
+- ALWAYS define repository traits in `domain/`, implement in `infrastructure/`
+- ALWAYS use typed error enums (thiserror), never String errors
+- ALWAYS encapsulate aggregate state behind methods

package/templates/pi/skills/agents/typescript-codegen.md

@@ -0,0 +1,40 @@
+---
+name: typescript-codegen
+description: Minimal skill for TypeScript/Node.js code generation with DDD + Clean Architecture. References full patterns on demand — never loads inline. Use when implementing TypeScript modules following enterprise patterns.
+model: inherit
+tools: [Read, Grep]
+---
+
+# TypeScript Code Generation — DDD + Clean Architecture Patterns
+
+> Do NOT load the full reference document. Read specific sections when needed.
+> Full reference: `.pi/skills/typescript-enterprise-codegen.md`
+
+## Quick Reference
+
+| When you need... | Read this section |
+|-----------------|-------------------|
+| Module structure | Section 1 — 4-layer DDD layout + dependency direction |
+| Domain entities | Section 2 — entity.ts, value.ts, repository interface |
+| Error handling | Section 3 — ErrorCode enum, DomainError class |
+| Application services | Section 4 — Service interface + implementation |
+| Repository impl | Section 5 — TypeORM implementation pattern |
+| HTTP controllers | Section 6 — Express/Fastify router, error mapping |
+| Testing | Section 7 — unit tests, integration tests |
+| Anti-patterns | Section 8 — what NOT to do |
+| Project structure | Section 9 — src/ module layout |
+
+## DDD Layer Contract
+
+| Layer | Purpose | Dependencies |
+|-------|---------|-------------|
+| `domain/` | Pure business logic | None (TS stdlib only) |
+| `application/` | Use case orchestration | `domain/` |
+| `infrastructure/` | External adapters | `domain/` + `application/` |
+| `interfaces/` | API contracts | `application/` |
+
+## Rules
+- NEVER read full reference — read specific sections
+- Use `grep` + `Read offset/limit` to target sections
+- Follow the DDD layer structure — no `contracts/` wrapper
+- Use readonly/mapped types for value objects (Omit, Partial, Readonly)