guardian-framework 0.1.103 → 0.1.105

package/dist/cli.js

@@ -3197,7 +3197,7 @@ __export(exports_package, {
   bin: () => bin,
   author: () => author
 });
-var name = "guardian-framework", version = "0.1.103", 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.105", 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.103", 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.105", 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.103",
+	"version": "0.1.105",
 	"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. */
+export type ProjectLanguage = "typescript" | "java" | "python" | "go" | "rust";
+
+/** Detect project language at `cwd` by checking for build files. */
+export 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. */
+export 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. */
+export 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. */
+export 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/extensions/architect-lib/tdd-generator.ts

@@ -81,7 +81,7 @@ export interface TddGenerateOptions {
 	cwd: string;
 	/** Language from manifest (default: "typescript") */
 	language: string;
-	/** Base test directory (default: "tests/unit") */
+	/** Base test directory (auto-detected from project language if not set) */
 	testBaseDir?: string;
 	/** Module name for path construction */
 	moduleName?: string;

package/templates/pi/extensions/architect.ts

@@ -34,6 +34,10 @@ import {
 	generateContractFreezeMarkdown,
 	generateIssueMarkdown,
 	generateProofingMarkdown,
+	detectLanguage,
+	testBaseDirFromLang,
+	testRunnerHintFromLang,
+	implExtension,
 } from "./architect-lib/generators";
 import {
 	generateEpicTestFiles,
@@ -870,7 +874,7 @@ export default function (pi: ExtensionAPI) {
 						"",
 						"**TDD Mode: ON**",
 						"- Failing test files were generated from architecture contracts before issues were created.",
-						"- Start each component by examining its test file in the `tests/unit/` directory.",
+						"- Start each component by examining its test file in the `" + testBaseDirFromLang(detectLanguage(ctx.cwd)) + "/` directory.",
 						"- Run tests first to see them fail, then implement to make them pass (Red→Green→Refactor).",
 						"- Tests are living artifacts — evolve them as the component grows.",
 						"- Reference `.pi/skills/tdd-practice.md` for TDD guidance.",

package/templates/pi/preflight_report.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2026-07-20T12:41:24Z",
+  "timestamp": "2026-07-20T16:02:31Z",
   "mode": "all",
   "stages_run": [],
   "summary": {

package/templates/pi/skills/tdd-practice.md

@@ -6,7 +6,9 @@ description: TDD practice guide for Guardian implementation agents. Use when TDD
 # TDD Practice — Red → Green → Refactor
 
 > This skill applies when TDD mode is enabled on the current epic (`--tdd`).
-> Pre-generated failing test files exist in `tests/unit/<module>/<component>/`.
+> Pre-generated failing test files exist in the project's test directory
+> (language-specific: `tests/unit/` for TypeScript, `src/test/java/` for Java,
+> `tests/` for Python/Go/Rust).
 > These tests were generated deterministically from architecture contracts — no LLM involvement.
 
 ## Core Principle
@@ -24,8 +26,14 @@ Do NOT treat the generated tests as rigid specs you must match exactly. Treat th
 
 ### 1. Red — See the test fail
 
-```
-bun test tests/unit/<module>/<component>/<component>.test.ts
+Run the project's test runner on the generated test file:
+
+```bash
+# TypeScript: bun test tests/unit/<module>/<component>/<component>.test.ts
+# Java:       mvn test -Dtest=<Component>Test
+# Python:     pytest tests/<module>/<component>/test_<component>.py
+# Go:         go test ./tests/<module>/<component>/
+# Rust:       cargo test --test <component>
 ```
 
 Confirm the test fails before writing any implementation code. This validates that:
@@ -41,7 +49,7 @@ Write the minimal implementation to make the failing test pass.
 - Write only enough code to pass the test
 - Do not over-engineer — YAGNI
 - Use the test's TODO comments as a guide for what the API should look like
-- The test file is in `tests/unit/`, implementation files go in `src/`
+- The test file is in the project's test directory (`tests/unit/`, `src/test/java/`, or `tests/`), implementation files go in `src/`
 - Import the implementation module into the test file
 
 If the generated test assumes an API shape that doesn't fit, **update the test first**, then implement.
@@ -107,11 +115,11 @@ The generated tests are **suggestions, not constraints**. You should modify them
 
 ## File Locations
 
-| Artifact | Path |
-|----------|------|
-| Tests | `tests/unit/<module>/<component>/<component>.test.ts` |
-| Implementation | `src/<module>/<component>.ts` (or appropriate layer) |
-| TDD guide | `.pi/skills/tdd-practice.md` |
+| Artifact | TypeScript | Java | Python | Go | Rust |
+|----------|------------|------|--------|-----|------|
+| Tests | `tests/unit/.../component.test.ts` | `src/test/java/.../ComponentTest.java` | `tests/.../test_component.py` | `tests/.../component_test.go` | `tests/.../mod.rs` |
+| Implementation | `src/<module>/` | `src/main/java/.../` | `src/<module>/` | `src/<module>/` | `src/<module>/` |
+| TDD guide | `.pi/skills/tdd-practice.md` | same | same | same | same |
 
 ## Anti-Patterns