guardian-framework 0.1.102 → 0.1.104

package/dist/cli.js

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

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

@@ -121,15 +121,57 @@ function buildInScope(comp: ModuleComponent, primaryAcRows: AcRow[], implSteps:
 	];
 }
 
-/** Detect whether project at `cwd` is a Java project. */
-function isJavaProject(cwd?: string): boolean {
-	if (!cwd) return false;
+/** Supported project languages. */
+type ProjectLanguage = "typescript" | "java" | "python" | "go" | "rust";
+
+/** Detect project language at `cwd` by checking for build files. */
+function detectLanguage(cwd?: string): ProjectLanguage {
+	if (!cwd) return "typescript";
 	try {
-		return existsSync(join(cwd, "pom.xml")) ||
-		       existsSync(join(cwd, "build.gradle")) ||
-		       existsSync(join(cwd, "build.gradle.kts"));
+		if (existsSync(join(cwd, "pom.xml")) || existsSync(join(cwd, "build.gradle")) || existsSync(join(cwd, "build.gradle.kts")))
+			return "java";
+		if (existsSync(join(cwd, "go.mod")))
+			return "go";
+		if (existsSync(join(cwd, "Cargo.toml")))
+			return "rust";
+		if (existsSync(join(cwd, "pyproject.toml")) || existsSync(join(cwd, "setup.py")) || existsSync(join(cwd, "requirements.txt")))
+			return "python";
+		return "typescript";
 	} catch {
-		return false;
+		return "typescript";
+	}
+}
+
+/** Language-specific file extension for implementation files. */
+function implExtension(lang: ProjectLanguage): string {
+	switch (lang) {
+		case "java": return "java";
+		case "python": return "py";
+		case "go": return "go";
+		case "rust": return "rs";
+		default: return "ts";
+	}
+}
+
+/** Language-specific test directory base. */
+function testBaseDirFromLang(lang: ProjectLanguage): string {
+	switch (lang) {
+		case "java": return "src/test/java";
+		case "python": return "tests";
+		case "go": return "tests";
+		case "rust": return "tests";
+		default: return "tests/unit";
+	}
+}
+
+/** Language-specific test runner command hint. */
+function testRunnerHintFromLang(lang: ProjectLanguage): string {
+	switch (lang) {
+		case "java": return "mvn test";
+		case "python": return "pytest";
+		case "go": return "go test ./...";
+		case "rust": return "cargo test";
+		default: return "bun test";
 	}
 }
 
@@ -156,9 +198,10 @@ export function generateIssueMarkdown(
 	const inScope = buildInScope(comp, compAcs, implSteps, moduleId);
 
 	// Language-aware test paths
-	const isJava = isJavaProject(cwd);
-	const testBaseDir = isJava ? "src/test/java" : "tests/unit";
-	const testRunnerHint = isJava ? "mvn test" : "bun test";
+	const lang = detectLanguage(cwd);
+	const ext = implExtension(lang);
+	const testBaseDir = testBaseDirFromLang(lang);
+	const testRunnerHint = testRunnerHintFromLang(lang);
 
 	const testLine = tdd
 		? `    - "update: ${testBaseDir}/ (failing tests already generated — make them pass)"`
@@ -252,7 +295,7 @@ ${yamlAcs}
     All Acceptance Criteria in that file must be satisfied before this issue is closed.
     Component focus: ${comp.name}.
     CONCRETE IMPLEMENTATIONS MUST BE CREATED — interface stubs from the contract freeze
-    are not sufficient. Each domain service/aggregate needs a concrete .impl.${isJava ? "java" : "ts"} file.
+    are not sufficient. Each domain service/aggregate needs a concrete .impl.${ext} file.
 
   file_changes:
     - "create: src/${moduleId}/domain/"
@@ -307,7 +350,7 @@ ${stepsMarkdown}
 > **Agent instructions:**
 > 1. Open \`.pi/architecture/modules/${slice.module}.md\` — read the full Acceptance Criteria table
 > 2. Identify which rows are your responsibility for **${comp.name}**
-> 3. Create concrete implementation files (\`.impl.${isJava ? "java" : "ts"}\`) in \`src/${moduleId}/\` — the interface stubs from the contract freeze are NOT enough
+> 3. Create concrete implementation files (\`.impl.${ext}\`) in \`src/${moduleId}/\` — the interface stubs from the contract freeze are NOT enough
 > 4. Each domain aggregate/service must have a working implementation with business logic
 > 5. Verify each AC row is satisfied in \`src/\` before marking done
 > 6. Run validators and create MR

package/templates/pi/preflight_report.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2026-07-20T12:29:56Z",
+  "timestamp": "2026-07-20T15:54:07Z",
   "mode": "all",
   "stages_run": [],
   "summary": {

package/templates/pi/prompts/issue-template-set.md

@@ -5,6 +5,13 @@
 
 ## General Rules
 
+> **IMPORTANT — Controllers/routers are CONCRETE, no interface needed:**
+> HTTP controllers, routers, and API handlers must NOT have a separate contract
+> interface (no `IUserController`, no `UserHandlerInterface`, no `handlers.ts`
+> as a type contract). The concrete router/handler file IS the contract.
+> Domain interfaces (services, repositories) SHOULD have interfaces — but the
+> HTTP layer is an adapter, not an abstractable domain concern.
+
 Every issue must contain:
 
 - **Why** — Business or platform reason