guardian-framework 0.1.142 → 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.142", 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) {
@@ -14583,7 +14682,8 @@ function generateProjectStructure(targetDir, options) {
   return { modules, layers, files: files2 };
 }
 function runProjectGenerator(targetDir, archDir, options) {
-  const modules = options.dryRun ? ["billing", "notifications", "shared"] : discoverModules(archDir);
+  const withContexts = options.withContexts === true;
+  const modules = options.dryRun ? withContexts ? ["billing", "notifications", "shared"] : ["shared"] : withContexts ? discoverModules(archDir) : ["shared"];
   const resolvedModules = modules.length > 0 ? modules : ["shared"];
   const layers = resolveLayers(archDir, options.language, options.defaults);
   return generateProjectStructure(targetDir, {
@@ -14603,7 +14703,7 @@ function existingProjectDetected(targetDir) {
   return fs15.existsSync(srcDir);
 }
 async function runProjectCreate(targetDir, options) {
-  const { language, buildTool, groupId, repoTool, validators, dryRun, force } = options;
+  const { language, buildTool, groupId, repoTool, validators, dryRun, force, withContexts } = options;
   if (!SUPPORTED_LANGUAGES.includes(language)) {
     showError(`Unsupported language: ${language}. Supported: ${SUPPORTED_LANGUAGES.join(", ")}`);
     return;
@@ -14639,7 +14739,8 @@ async function runProjectCreate(targetDir, options) {
     groupId,
     buildTool,
     dryRun,
-    defaults
+    defaults,
+    withContexts
   });
   if (dryRun) {
     console.log("  Modules:");
@@ -14653,8 +14754,14 @@ async function runProjectCreate(targetDir, options) {
     console.log(`  Files to create: ${structurePlan.files.length}
 `);
   } else {
-    console.log(`  \u2705 ${structurePlan.files.length} files created (${structurePlan.modules.length} modules \xD7 ${structurePlan.layers.length} layers)
+    const scope = withContexts ? `${structurePlan.modules.length} bounded contexts` : "minimal bootstrap: shared kernel";
+    console.log(`  \u2705 ${structurePlan.files.length} files created (${scope} \xD7 ${structurePlan.layers.length} layers)
 `);
+    if (!withContexts) {
+      console.log("  \u2139\uFE0F  Minimal bootstrap: bounded-context folders are created per roadmap phase.");
+      console.log(`     Pre-create every context tree with --withContexts (not recommended).
+`);
+    }
   }
   console.log(dryRun ? "\uD83D\uDCCB [DRY-RUN] Generating build configuration..." : "\uD83D\uDCC4 Generating build configuration...");
   const buildPlan = generateBuildConfig(targetDir, {
@@ -15571,6 +15678,7 @@ async function runCli() {
       workflows: { type: "string" },
       nonInteractive: { type: "boolean" },
       dryRun: { type: "boolean" },
+      withContexts: { type: "boolean" },
       groupId: { type: "string" },
       force: { type: "boolean" },
       regenerate: { type: "boolean" },
@@ -15629,6 +15737,8 @@ Project options:
   --validators <list>        Validators for CI pipeline
   --dryRun                   Show plan without writing files
   --force                    Override existing project guard
+  --withContexts             Pre-create every bounded-context tree (default: minimal
+                             bootstrap \u2014 shared kernel only; contexts come per phase)
   --workflows <list>         Workflows (comma-separated)
   --nonInteractive           Use defaults/flags, skip prompts
 
@@ -15737,7 +15847,8 @@ async function runCommand(command, args) {
           repoTool: resolvedRepoTool,
           validators: args.values.validators?.split(",") || ["ci", "tests"],
           dryRun: args.values.dryRun,
-          force: args.values.force
+          force: args.values.force,
+          withContexts: args.values.withContexts
         });
       } else {
         console.error("Usage: guardian project create [options]");

package/dist/exports.js

@@ -1991,7 +1991,7 @@ __export(exports_package, {
   bin: () => bin,
   author: () => author
 });
-var name = "guardian-framework", version = "0.1.142", 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) {
@@ -14143,7 +14242,8 @@ function generateProjectStructure(targetDir, options) {
   return { modules, layers, files: files2 };
 }
 function runProjectGenerator(targetDir, archDir, options) {
-  const modules = options.dryRun ? ["billing", "notifications", "shared"] : discoverModules(archDir);
+  const withContexts = options.withContexts === true;
+  const modules = options.dryRun ? withContexts ? ["billing", "notifications", "shared"] : ["shared"] : withContexts ? discoverModules(archDir) : ["shared"];
   const resolvedModules = modules.length > 0 ? modules : ["shared"];
   const layers = resolveLayers(archDir, options.language, options.defaults);
   return generateProjectStructure(targetDir, {
@@ -14163,7 +14263,7 @@ function existingProjectDetected(targetDir) {
   return fs17.existsSync(srcDir);
 }
 async function runProjectCreate(targetDir, options) {
-  const { language, buildTool, groupId, repoTool, validators, dryRun, force } = options;
+  const { language, buildTool, groupId, repoTool, validators, dryRun, force, withContexts } = options;
   if (!SUPPORTED_LANGUAGES.includes(language)) {
     showError(`Unsupported language: ${language}. Supported: ${SUPPORTED_LANGUAGES.join(", ")}`);
     return;
@@ -14199,7 +14299,8 @@ async function runProjectCreate(targetDir, options) {
     groupId,
     buildTool,
     dryRun,
-    defaults
+    defaults,
+    withContexts
   });
   if (dryRun) {
     console.log("  Modules:");
@@ -14213,8 +14314,14 @@ async function runProjectCreate(targetDir, options) {
     console.log(`  Files to create: ${structurePlan.files.length}
 `);
   } else {
-    console.log(`  ✅ ${structurePlan.files.length} files created (${structurePlan.modules.length} modules × ${structurePlan.layers.length} layers)
+    const scope = withContexts ? `${structurePlan.modules.length} bounded contexts` : "minimal bootstrap: shared kernel";
+    console.log(`  ✅ ${structurePlan.files.length} files created (${scope} × ${structurePlan.layers.length} layers)
 `);
+    if (!withContexts) {
+      console.log("  ℹ️  Minimal bootstrap: bounded-context folders are created per roadmap phase.");
+      console.log(`     Pre-create every context tree with --withContexts (not recommended).
+`);
+    }
   }
   console.log(dryRun ? "\uD83D\uDCCB [DRY-RUN] Generating build configuration..." : "\uD83D\uDCC4 Generating build configuration...");
   const buildPlan = generateBuildConfig(targetDir, {

package/package.json

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

package/templates/pi/architecture/implementation-roadmap.md

@@ -13,8 +13,12 @@ contexts into delivery phases with explicit dependencies, database migrations, a
 acceptance criteria.
 
 **Format conventions:**
-- Each `## Phase N` section defines one delivery phase
-- `### Modules` table lists ONLY the bounded contexts built in this phase
+- `## Phase 0: Project Bootstrap` is MINIMUM project setup (build/deps, shared kernel layout,
+  config, error envelope, migration tooling, CI + validators, test harness, entrypoint). It is
+  NOT a bounded context: no `### Modules` rows and no context folders (context folders are
+  created in each context's own build phase)
+- Each `## Phase N` (N≥1) section defines one delivery phase
+- `### Modules` table lists ONLY the bounded contexts built in this phase (contexts start Phase 1)
 - **Invariant:** each bounded context appears in exactly ONE phase's `### Modules` table
   (its build phase). Modules a phase merely uses are referenced under `### Dependencies`,
   never re-listed as Modules (no repeats, no "All")

package/templates/pi/extensions/domain-explorer.ts

@@ -1746,18 +1746,29 @@ export default function (pi: ExtensionAPI) {
 					"each having: Goal, Modules table, Dependencies, Database Migrations, Acceptance Criteria.",
 					"",
 					"HARD RULES:",
+					"- Phase 0 is ALWAYS `## Phase 0: Project Bootstrap` — MINIMUM project setup, NOT a",
+					"  bounded context. It has no `### Modules` rows (write 'Bootstrap only — no bounded",
+					"  contexts' or omit the table). Deliverables: language toolchain + dependency manifest,",
+					"  top-level package layout with the shared kernel, config/env handling, error envelope +",
+					"  logging baseline, DB migration TOOLING (no module tables), CI + architecture validators,",
+					"  test harness, entrypoint with /healthz + /readyz. Reference `/project create` in the",
+					"  Goal line. Acceptance: project builds and boots; lint/test/validators green on an empty",
+					"  suite. Do NOT create bounded-context folders — each context's folders are created in its",
+					"  own build phase.",
 					"- Each bounded context appears in EXACTLY ONE phase's `### Modules` table — the phase where",
 					"  it is built (the earliest phase whose dependencies are already satisfied). Never re-list a",
 					"  module in a later phase: no repeats, no 'All', no 'Hardening applies to all modules' row.",
 					"- Modules a phase merely USES go under `### Dependencies`, naming what they provide",
 					"  (ports/types/endpoints). Keep those references — they are useful and must not be dropped.",
-					"- Total rows across all `### Modules` tables MUST equal the number of module docs.",
+					"- Total `### Modules` rows across phases 1..N MUST equal the number of module docs",
+					"  (Phase 0 Bootstrap contributes 0 rows).",
 					"- Keep the `| Module | Deliverables | Architecture Doc |` columns; Architecture Doc links",
 					"  are the per-phase reference that implementation agents follow.",
 					"",
 					"Organize phases by dependency chain:",
-					"- Phase 0: Foundation — contexts with no upstream dependencies",
-					"- Phase 1: contexts whose dependencies were built in Phase 0, and so on",
+					"- Phase 0: Project Bootstrap — minimal setup only (no bounded contexts, no context folders)",
+					"- Phase 1: Foundation — contexts with no upstream dependencies (their folders appear here)",
+					"- Phase 2+: contexts whose dependencies were built in earlier phases, and so on",
 					"- Do not create a phase just to group later touches of an already-built module.",
 					"",
 					"Also add: Dependency Graph (phase arrows + which modules cross phase boundaries),",

package/templates/pi/extensions/project-scaffolder.ts

@@ -154,6 +154,7 @@ export default function (pi: ExtensionAPI) {
 				const validators = String(parsed.validators || "ci,tests");
 				const dryRun = parsed.dryRun === true || parsed["dry-run"] === true || parsed.d === true;
 				const force = parsed.force === true || parsed.f === true;
+				const withContexts = parsed.withContexts === true || parsed["with-contexts"] === true;
 
 				// Validate language
 				if (!lang || !SUPPORTED_LANGUAGES.includes(lang as typeof SUPPORTED_LANGUAGES[number])) {
@@ -194,6 +195,7 @@ export default function (pi: ExtensionAPI) {
 				};
 				if (dryRun) shellArgs.dryRun = true;
 				if (force) shellArgs.force = true;
+				if (withContexts) shellArgs.withContexts = true;
 
 				const fullCmd = cmd(`${guardianCmd} project create`, shellArgs);
 
@@ -232,7 +234,9 @@ export default function (pi: ExtensionAPI) {
 						"",
 						dryRun
 							? "Run without --dryRun to create the project."
-							: "Project scaffolded. Next: create architecture module docs and use /architect to plan epics.",
+							: withContexts
+								? "Project scaffolded (all context trees pre-created). Next: /architect to plan epics."
+								: "Minimal project bootstrap complete (shared kernel only; context folders are created per roadmap phase). Next: /architect to plan epics.",
 					]
 						.filter(Boolean)
 						.join("\n");
@@ -259,9 +263,10 @@ export default function (pi: ExtensionAPI) {
 				"Available /project subcommands:",
 				"",
 				"  /project create --lang <language> [options]",
-				"    Scaffold project from architecture decisions",
+				"    Minimal project bootstrap from architecture decisions (shared kernel + build/CI).",
+				"    Bounded-context folders are created per roadmap phase, not upfront.",
 				"    Required: --lang (typescript, rust, python, go, java)",
-				"    Options: --buildTool, --groupId, --validators, --dryRun, --force",
+				"    Options: --buildTool, --groupId, --validators, --dryRun, --force, --withContexts",
 				"",
 				"  /project status",
 				"    Show current scaffolding status",

package/templates/pi/preflight_report.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2026-09-25T19:38:51Z",
+  "timestamp": "2026-11-07T13:11:23Z",
   "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/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