guardian-framework 0.1.141 → 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.141", 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.141", 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.141",
+	"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,9 +13,17 @@ 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 the bounded contexts implemented in this phase
-- `### Dependencies` lists phase prerequisites
+- `## 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")
+- `### Dependencies` lists upstream phases AND the modules they provide (keep these
+  references — implementation agents use them)
 - `### Database Migrations` lists SQL migration files
 - `### Acceptance Criteria` lists verifiable checkboxes
 

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

@@ -1586,6 +1586,34 @@ export default function (pi: ExtensionAPI) {
 					if (chunks.length > 0) servicesCatalog = chunks.join("\n\n");
 				} catch { /* leave fallback text */ }
 
+				// Dependency context for the roadmap phase: keep the references (they are
+				// useful) and hand the agent the graph so it can order phases without
+				// duplicating a module across Modules tables.
+				let dependencyContext = "(no dependency sections found)";
+				try {
+					const depRaw = JSON.parse(fs.readFileSync(sRawPath, "utf-8")) as Record<string, unknown>;
+					const lines: string[] = [];
+					for (const f of moduleFiles) {
+						const doc = fs.readFileSync(path.join(modulesDir, f), "utf-8");
+						// Accept both formats: "### Depends On" (list of module names/links) and
+						// "**Depends On**". Keep the raw bullets — maximum context for the agent
+						// (references are useful), not just parsed names.
+						const m = doc.match(/(?:###\s*Depends On|\**Depends On\**)\s*\n([\s\S]*?)(?=\n\s*(?:###\s*Used By|\**Used By\**|###\s|##\s)|$)/i);
+						if (!m) continue;
+						const bullets = m[1].split("\n").map((l) => l.trim()).filter((l) => l.startsWith("-")).join("\n");
+						if (bullets) lines.push("### " + f + "\n" + bullets);
+					}
+					const edges = Array.isArray(depRaw.contextMap) ? (depRaw.contextMap as Record<string, unknown>[]) : [];
+					if (edges.length > 0) {
+						lines.push("");
+						lines.push("Context-map relationships (context → context):");
+						for (const e of edges) {
+							lines.push("- " + String(e.from ?? "") + " → " + String(e.to ?? "") + " (" + String(e.relationship ?? "") + ")" + (e.note ? " — " + String(e.note) : ""));
+						}
+					}
+					if (lines.length > 0) dependencyContext = lines.join("\n");
+				} catch { /* leave fallback text */ }
+
 				const enrichPrompt = [
 					"## Task: Complete Architecture Package",
 					"",
@@ -1602,6 +1630,14 @@ export default function (pi: ExtensionAPI) {
 					"",
 					servicesCatalog,
 					"",
+					"### Module dependency references (CONTEXT for phase ordering — keep these, they are useful)",
+					"",
+					"Order phases so a module's dependencies are built first. These are REFERENCES: if a",
+					"later phase uses a module, list it under that phase's `### Dependencies` (with what it",
+					"provides) — never again in its `### Modules` table.",
+					"",
+					dependencyContext,
+					"",
 					"**YOU MUST FOLLOW THESE 3 STEPS IN ORDER. Do not skip steps or reorder them.**",
 					"",
 					"### Source Data",
@@ -1705,16 +1741,38 @@ export default function (pi: ExtensionAPI) {
 					"",
 					"**After all module docs are enriched, generate the implementation roadmap.**",
 					"",
-					"Read each module doc's dependency section and create `.pi/architecture/implementation-roadmap.md`",
-					"with `## Phase N: Name (Days N-N)` sections, each having:",
-					"- Goal, Modules table, Dependencies, Database Migrations, Acceptance Criteria",
+					"Read each module doc's dependency section and the dependency references above; create",
+					"`.pi/architecture/implementation-roadmap.md` with `## Phase N: Name (Days N-N)` sections,",
+					"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 `### 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 (no upstream deps)",
-					"- Phase 1: Core services depending on Phase 0",
-					"- Phase 2+: Following the dependency chain",
+					"- 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, Effort Estimates table, Key Milestones",
+					"Also add: Dependency Graph (phase arrows + which modules cross phase boundaries),",
+					"Effort Estimates table, Key Milestones",
 					"",
 					"### STEP 5: Fill Architecture CHANGELOG",
 					"",

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:29:02Z",
+  "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",