guardian-framework 0.1.143 → 0.1.144

package/dist/cli.js

@@ -3206,7 +3206,7 @@ __export(exports_package, {
   bin: () => bin,
   author: () => author
 });
-var name = "guardian-framework", version = "0.1.143", 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.144", 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 = {
     ".": {
@@ -11625,6 +11625,117 @@ import * as path3 from "path";
 import * as crypto from "crypto";
 import * as fs from "fs";
 import * as path2 from "path";
+
+// src/lib/language-stubs.ts
+var FENCE = {
+  typescript: "typescript",
+  nextjs: "typescript",
+  angular: "typescript",
+  rust: "rust",
+  python: "python",
+  go: "go",
+  java: "java"
+};
+function normalizeStubLanguage(language) {
+  const l2 = (language ?? "").trim().toLowerCase();
+  if (l2 === "nextjs" || l2 === "angular" || l2 === "typescript")
+    return "typescript";
+  if (l2 === "rust" || l2 === "python" || l2 === "go" || l2 === "java")
+    return l2;
+  return "neutral";
+}
+function renderRepositoryInterface(language, aggregateName) {
+  const lang = normalizeStubLanguage(language);
+  const fence = FENCE[lang] ?? "text";
+  const id = `${aggregateName}Id`;
+  if (lang === "rust") {
+    return [
+      `\`\`\`${fence}`,
+      `pub trait ${aggregateName}Repository: Send + Sync {`,
+      `    async fn find_by_id(&self, id: &${id}) -> Result<Option<${aggregateName}>, DomainError>;`,
+      `    async fn save(&self, ${lowerFirst(aggregateName)}: &${aggregateName}) -> Result<(), DomainError>;`,
+      `    async fn delete(&self, id: &${id}) -> Result<(), DomainError>;`,
+      "}",
+      "```"
+    ].join(`
+`);
+  }
+  if (lang === "python") {
+    return [
+      `\`\`\`${fence}`,
+      "from abc import ABC, abstractmethod",
+      "",
+      "",
+      `class ${aggregateName}Repository(ABC):`,
+      `    """Persistence port for the ${aggregateName} aggregate (implemented in infrastructure)."""`,
+      "",
+      "    @abstractmethod",
+      `    async def find_by_id(self, id_: ${id}) -> ${aggregateName} | None: ...`,
+      "",
+      "    @abstractmethod",
+      `    async def save(self, ${snake(aggregateName)}: ${aggregateName}) -> None: ...`,
+      "",
+      "    @abstractmethod",
+      `    async def delete(self, id_: ${id}) -> None: ...`,
+      "```"
+    ].join(`
+`);
+  }
+  if (lang === "java") {
+    return [
+      `\`\`\`${fence}`,
+      `public interface ${aggregateName}Repository {`,
+      `    Optional<${aggregateName}> findById(${id} id);`,
+      `    void save(${aggregateName} ${lowerFirst(aggregateName)});`,
+      `    void delete(${id} id);`,
+      "}",
+      "```"
+    ].join(`
+`);
+  }
+  if (lang === "go") {
+    return [
+      `\`\`\`${fence}`,
+      `// ${aggregateName}Repository is the persistence port for the ${aggregateName} aggregate.`,
+      `type ${aggregateName}Repository interface {`,
+      `	FindByID(ctx context.Context, id ${id}) (*${aggregateName}, error)`,
+      `	Save(ctx context.Context, ${lowerFirst(aggregateName)} *${aggregateName}) error`,
+      `	Delete(ctx context.Context, id ${id}) error`,
+      "}",
+      "```"
+    ].join(`
+`);
+  }
+  if (lang === "typescript") {
+    return [
+      `\`\`\`${fence}`,
+      `export interface ${aggregateName}Repository {`,
+      `  findById(id: ${id}): Promise<${aggregateName} | null>;`,
+      `  save(${lowerFirst(aggregateName)}: ${aggregateName}): Promise<void>;`,
+      `  delete(id: ${id}): Promise<void>;`,
+      "}",
+      "```"
+    ].join(`
+`);
+  }
+  return [
+    `\`\`\`${fence}`,
+    `${aggregateName}Repository (persistence port)`,
+    `  findById(id: ${id}) -> ${aggregateName} | null`,
+    `  save(${aggregateName}) -> void`,
+    `  delete(id: ${id}) -> void`,
+    "```"
+  ].join(`
+`);
+}
+function lowerFirst(s) {
+  return s.length > 0 ? s.charAt(0).toLowerCase() + s.slice(1) : s;
+}
+function snake(s) {
+  return s.replace(/([a-z0-9])([A-Z])/g, "$1_$2").replace(/[\s-]+/g, "_").toLowerCase();
+}
+
+// src/lib/domain-explorer.ts
 var __dirname = "/Users/arman/project/guardian-framework/src/lib", __filename = "/Users/arman/project/guardian-framework/src/lib/domain-explorer.ts";
 var MAX_BUSINESS_CONTEXT_LENGTH = 5000;
 function sanitizeBusinessContext(context) {
@@ -12793,23 +12904,11 @@ ${bc.description}
             content += `
 `;
           }
-          const arVarName = ar.name.charAt(0).toLowerCase() + ar.name.slice(1);
           content += `**Repository Interface:**
 `;
           content += `
 `;
-          content += "```rust\n";
-          content += `pub trait ${ar.name}Repository: Send + Sync {
-`;
-          content += `    async fn find_by_id(&self, id: &${ar.name}Id) -> Result<Option<${ar.name}>, DomainError>;
-`;
-          content += `    async fn save(&self, ${arVarName}: &${ar.name}) -> Result<(), DomainError>;
-`;
-          content += `    async fn delete(&self, id: &${ar.name}Id) -> Result<(), DomainError>;
-`;
-          content += `}
-`;
-          content += "```";
+          content += renderRepositoryInterface(lang, ar.name);
           content += `
 `;
           if (ownedEntities.length > 0 || ownedVOs.length > 0 || invariants.length > 0) {

package/dist/exports.js

@@ -1991,7 +1991,7 @@ __export(exports_package, {
   bin: () => bin,
   author: () => author
 });
-var name = "guardian-framework", version = "0.1.143", 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.144", 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 = {
     ".": {
@@ -11948,6 +11948,117 @@ import * as path12 from "node:path";
 import * as crypto4 from "node:crypto";
 import * as fs12 from "node:fs";
 import * as path11 from "node:path";
+
+// src/lib/language-stubs.ts
+var FENCE = {
+  typescript: "typescript",
+  nextjs: "typescript",
+  angular: "typescript",
+  rust: "rust",
+  python: "python",
+  go: "go",
+  java: "java"
+};
+function normalizeStubLanguage(language) {
+  const l2 = (language ?? "").trim().toLowerCase();
+  if (l2 === "nextjs" || l2 === "angular" || l2 === "typescript")
+    return "typescript";
+  if (l2 === "rust" || l2 === "python" || l2 === "go" || l2 === "java")
+    return l2;
+  return "neutral";
+}
+function renderRepositoryInterface(language, aggregateName) {
+  const lang = normalizeStubLanguage(language);
+  const fence = FENCE[lang] ?? "text";
+  const id = `${aggregateName}Id`;
+  if (lang === "rust") {
+    return [
+      `\`\`\`${fence}`,
+      `pub trait ${aggregateName}Repository: Send + Sync {`,
+      `    async fn find_by_id(&self, id: &${id}) -> Result<Option<${aggregateName}>, DomainError>;`,
+      `    async fn save(&self, ${lowerFirst(aggregateName)}: &${aggregateName}) -> Result<(), DomainError>;`,
+      `    async fn delete(&self, id: &${id}) -> Result<(), DomainError>;`,
+      "}",
+      "```"
+    ].join(`
+`);
+  }
+  if (lang === "python") {
+    return [
+      `\`\`\`${fence}`,
+      "from abc import ABC, abstractmethod",
+      "",
+      "",
+      `class ${aggregateName}Repository(ABC):`,
+      `    """Persistence port for the ${aggregateName} aggregate (implemented in infrastructure)."""`,
+      "",
+      "    @abstractmethod",
+      `    async def find_by_id(self, id_: ${id}) -> ${aggregateName} | None: ...`,
+      "",
+      "    @abstractmethod",
+      `    async def save(self, ${snake(aggregateName)}: ${aggregateName}) -> None: ...`,
+      "",
+      "    @abstractmethod",
+      `    async def delete(self, id_: ${id}) -> None: ...`,
+      "```"
+    ].join(`
+`);
+  }
+  if (lang === "java") {
+    return [
+      `\`\`\`${fence}`,
+      `public interface ${aggregateName}Repository {`,
+      `    Optional<${aggregateName}> findById(${id} id);`,
+      `    void save(${aggregateName} ${lowerFirst(aggregateName)});`,
+      `    void delete(${id} id);`,
+      "}",
+      "```"
+    ].join(`
+`);
+  }
+  if (lang === "go") {
+    return [
+      `\`\`\`${fence}`,
+      `// ${aggregateName}Repository is the persistence port for the ${aggregateName} aggregate.`,
+      `type ${aggregateName}Repository interface {`,
+      `	FindByID(ctx context.Context, id ${id}) (*${aggregateName}, error)`,
+      `	Save(ctx context.Context, ${lowerFirst(aggregateName)} *${aggregateName}) error`,
+      `	Delete(ctx context.Context, id ${id}) error`,
+      "}",
+      "```"
+    ].join(`
+`);
+  }
+  if (lang === "typescript") {
+    return [
+      `\`\`\`${fence}`,
+      `export interface ${aggregateName}Repository {`,
+      `  findById(id: ${id}): Promise<${aggregateName} | null>;`,
+      `  save(${lowerFirst(aggregateName)}: ${aggregateName}): Promise<void>;`,
+      `  delete(id: ${id}): Promise<void>;`,
+      "}",
+      "```"
+    ].join(`
+`);
+  }
+  return [
+    `\`\`\`${fence}`,
+    `${aggregateName}Repository (persistence port)`,
+    `  findById(id: ${id}) -> ${aggregateName} | null`,
+    `  save(${aggregateName}) -> void`,
+    `  delete(id: ${id}) -> void`,
+    "```"
+  ].join(`
+`);
+}
+function lowerFirst(s) {
+  return s.length > 0 ? s.charAt(0).toLowerCase() + s.slice(1) : s;
+}
+function snake(s) {
+  return s.replace(/([a-z0-9])([A-Z])/g, "$1_$2").replace(/[\s-]+/g, "_").toLowerCase();
+}
+
+// src/lib/domain-explorer.ts
 var __dirname = "/Users/arman/project/guardian-framework/src/lib", __filename = "/Users/arman/project/guardian-framework/src/lib/domain-explorer.ts";
 var MAX_BUSINESS_CONTEXT_LENGTH = 5000;
 function sanitizeBusinessContext(context) {
@@ -13116,23 +13227,11 @@ ${bc.description}
             content += `
 `;
           }
-          const arVarName = ar.name.charAt(0).toLowerCase() + ar.name.slice(1);
           content += `**Repository Interface:**
 `;
           content += `
 `;
-          content += "```rust\n";
-          content += `pub trait ${ar.name}Repository: Send + Sync {
-`;
-          content += `    async fn find_by_id(&self, id: &${ar.name}Id) -> Result<Option<${ar.name}>, DomainError>;
-`;
-          content += `    async fn save(&self, ${arVarName}: &${ar.name}) -> Result<(), DomainError>;
-`;
-          content += `    async fn delete(&self, id: &${ar.name}Id) -> Result<(), DomainError>;
-`;
-          content += `}
-`;
-          content += "```";
+          content += renderRepositoryInterface(lang, ar.name);
           content += `
 `;
           if (ownedEntities.length > 0 || ownedVOs.length > 0 || invariants.length > 0) {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "guardian-framework",
-	"version": "0.1.143",
+	"version": "0.1.144",
 	"description": "Token-optimized agentic framework scaffolder with pi-first architecture",
 	"type": "module",
 	"main": "dist/exports.js",

package/templates/pi/preflight_report.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2026-09-25T19:59:49Z",
+  "timestamp": "2026-11-07T13:11:23Z",
   "mode": "all",
   "stages_run": [],
   "summary": {

package/templates/pi/scripts/check_language_consistency.sh

@@ -0,0 +1,122 @@
+#!/usr/bin/env bash
+# ============================================================================
+# check_language_consistency.sh — architecture docs must use the project language
+# ============================================================================
+# Catches two failure modes:
+#   1. Scaffold emitting stubs in the wrong language (historically Rust in every
+#      project, regardless of manifest language).
+#   2. An enrichment/codegen agent copying a foreign-language sample.
+#
+# Fences for "infrastructure" languages that are legitimately language-agnostic
+# (json, yaml, toml, bash, sql, mermaid, text, dockerfile, http, diff, ini) are
+# always allowed; markdown is allowed too.
+#
+# Usage: bash .pi/scripts/check_language_consistency.sh [--strict]
+#   --strict  also treat other framework languages (angular/nextjs) as foreign
+# ============================================================================
+set -uo pipefail
+
+RED='\033[0;31m'; GREEN='\033[0;32m'; YELLOW='\033[1;33m'; NC='\033[0m'
+PASS=0; FAIL=0; WARN=0
+pass() { echo -e "${GREEN}✅ PASS${NC} $1"; PASS=$((PASS+1)); }
+fail() { echo -e "${RED}❌ FAIL${NC} $1"; FAIL=$((FAIL+1)); }
+warn() { echo -e "${YELLOW}⚠️  WARN${NC} $1"; WARN=$((WARN+1)); }
+
+STRICT=0
+[ "${1:-}" = "--strict" ] && STRICT=1
+
+echo "============================================"
+echo "  Language Consistency (architecture docs)"
+echo "============================================"
+
+# ── Resolve project language ────────────────────────────────────────────────
+LANG_NAME=""
+if [ -f "guardian-manifest.json" ]; then
+	LANG_NAME=$(python3 -c "import json;print(json.load(open('guardian-manifest.json')).get('language',''))" 2>/dev/null || true)
+fi
+if [ -z "$LANG_NAME" ] && [ -f ".pi/guardian-manifest.json" ]; then
+	LANG_NAME=$(python3 -c "import json;print(json.load(open('.pi/guardian-manifest.json')).get('language',''))" 2>/dev/null || true)
+fi
+if [ -z "$LANG_NAME" ]; then
+	echo "no manifest language — skipping"
+	exit 0
+fi
+echo "Project language: $LANG_NAME"
+echo ""
+
+case "$LANG_NAME" in
+	typescript|nextjs|angular) EXPECTED="typescript|tsx|ts|javascript|jsx|js" ;;
+	python)                    EXPECTED="python|py" ;;
+	rust)                      EXPECTED="rust" ;;
+	go)                        EXPECTED="go" ;;
+	java)                      EXPECTED="java" ;;
+	*)                         EXPECTED="" ;;
+esac
+
+if [ -z "$EXPECTED" ]; then
+	echo "unsupported language '$LANG_NAME' — skipping"
+	exit 0
+fi
+
+ALL_FENCES="typescript|tsx|ts|javascript|jsx|js|python|py|rust|go|java|kotlin|kt|csharp|cs|ruby|rb|php|swift|cpp|c\+\+|c|scala|elixir|dart"
+ALLOWED_NEUTRAL="json|jsonc|yaml|yml|toml|bash|sh|shell|zsh|sql|mermaid|text|txt|plaintext|dockerfile|docker|http|diff|ini|properties|xml|html|css|scss|makefile|cmake|gradle|protobuf|proto|csv|regex|"
+
+is_expected() {
+	local f="$1"
+	[ -z "$f" ] && return 1                       # bare ``` with no language
+	case "$EXPECTED" in
+		*"|$f|"*|"$f|"*) return 0 ;;
+	esac
+	# substring match for multi-alias lists
+	echo "$EXPECTED" | tr '|' '\n' | grep -qx "$f" && return 0
+	return 1
+}
+
+is_neutral() {
+	local f="$1"
+	[ -z "$f" ] && return 0
+	echo "$ALLOWED_NEUTRAL" | tr '|' '\n' | grep -qx "$f"
+}
+
+ROOT=".pi/architecture"
+[ -d "$ROOT" ] || { echo "no $ROOT — nothing to check"; exit 0; }
+
+FILES=$(find "$ROOT" -name "*.md" -type f 2>/dev/null | grep -v "/modules/module-template.md$")
+MISMATCHES=0
+CHECKED=0
+for doc in $FILES; do
+	CHECKED=$((CHECKED+1))
+	# Collect fenced block languages
+	fences=$(grep -oE '^```[a-zA-Z0-9_+-]*' "$doc" 2>/dev/null | sed 's/^```//' | sort -u)
+	[ -z "$fences" ] && continue
+	bad=""
+	for f in $fences; do
+		lower=$(echo "$f" | tr '[:upper:]' '[:lower:]')
+		if is_neutral "$lower"; then continue; fi
+		if is_expected "$lower"; then continue; fi
+		# A fence that is a known programming language but not this project's
+		if echo "$lower" | grep -qE "^($ALL_FENCES)$"; then
+			bad="$bad $lower"
+		elif [ "$STRICT" = "1" ]; then
+			bad="$bad $lower"
+		fi
+	done
+	if [ -n "$bad" ]; then
+		fail "$doc uses foreign code fence(s):$(echo "$bad" | tr ' ' '\n' | sed '/^$/d' | sort -u | sed 's/^/ /' | tr '\n' ',' | sed 's/,$//')  (project: $LANG_NAME)"
+		MISMATCHES=$((MISMATCHES+1))
+	fi
+done
+
+if [ "$MISMATCHES" -eq 0 ]; then
+	pass "$CHECKED architecture doc(s) use $LANG_NAME (no foreign code fences)"
+else
+	fail "$MISMATCHES of $CHECKED architecture doc(s) contain foreign-language code samples"
+fi
+
+echo ""
+echo "============================================"
+echo "  Summary"
+echo "============================================"
+echo "  Passed: $PASS  Failed: $FAIL  Warnings: $WARN"
+[ "$FAIL" -eq 0 ] && exit 0
+exit 1

package/templates/pi/scripts/validate-architecture.sh

@@ -13,10 +13,28 @@ detect_language() {
 
 LANG=$(detect_language)
 LANG_SCRIPT="${SCRIPT_DIR}/languages/${LANG}/validate-architecture.sh"
+CONSISTENCY_SCRIPT="${SCRIPT_DIR}/check_language_consistency.sh"
+
+# Language consistency runs for EVERY language (architecture docs must use the
+# project language — catches scaffold stubs emitted in the wrong language).
+run_consistency() {
+    if [ -f "$CONSISTENCY_SCRIPT" ]; then
+        bash "$CONSISTENCY_SCRIPT" || CONSISTENCY_RC=1
+        echo ""
+    fi
+}
 
 if [ -f "$LANG_SCRIPT" ]; then
-    exec bash "$LANG_SCRIPT" "$@"
+    bash "$LANG_SCRIPT" "$@"
+    LANG_RC=$?
+    CONSISTENCY_RC=0
+    run_consistency
+    [ "$LANG_RC" -ne 0 ] && exit "$LANG_RC"
+    [ "${CONSISTENCY_RC:-0}" -ne 0 ] && exit 1
+    exit 0
 else
     echo "No architecture validator for language: $LANG"
-    exit 0
+    CONSISTENCY_RC=0
+    run_consistency
+    exit "${CONSISTENCY_RC:-0}"
 fi