guardian-framework 0.1.142 → 0.1.143

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.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 init_package = __esm(() => {
   exports = {
     ".": {
@@ -14583,7 +14583,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 +14604,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 +14640,8 @@ async function runProjectCreate(targetDir, options) {
     groupId,
     buildTool,
     dryRun,
-    defaults
+    defaults,
+    withContexts
   });
   if (dryRun) {
     console.log("  Modules:");
@@ -14653,8 +14655,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 +15579,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 +15638,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 +15748,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.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 init_package = __esm(() => {
   exports = {
     ".": {
@@ -14143,7 +14143,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 +14164,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 +14200,8 @@ async function runProjectCreate(targetDir, options) {
     groupId,
     buildTool,
     dryRun,
-    defaults
+    defaults,
+    withContexts
   });
   if (dryRun) {
     console.log("  Modules:");
@@ -14213,8 +14215,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.143",
 	"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-09-25T19:59:49Z",
   "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",