guardian-framework 0.1.141 → 0.1.142

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.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 init_package = __esm(() => {
   exports = {
     ".": {

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.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 init_package = __esm(() => {
   exports = {
     ".": {

package/package.json

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

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

@@ -14,8 +14,12 @@ 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
+- `### Modules` table lists ONLY the bounded contexts built in this phase
+- **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,27 @@ 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:",
+					"- 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.",
+					"- 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: Foundation — contexts with no upstream dependencies",
+					"- Phase 1: contexts whose dependencies were built in Phase 0, 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/preflight_report.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2026-09-25T19:29:02Z",
+  "timestamp": "2026-09-25T19:38:51Z",
   "mode": "all",
   "stages_run": [],
   "summary": {