guardian-framework 0.1.11 → 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.11", 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.11", 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.11",
+	"version": "0.1.12",
 	"description": "Token-optimized agentic framework scaffolder with pi-first architecture",
 	"type": "module",
 	"main": "dist/exports.js",

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:44:32Z",
+  "timestamp": "2026-07-03T05:15:47Z",
   "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",

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/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)