guardian-framework 0.1.140 → 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.140", 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.140", 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.140",
+	"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",
 					"",
@@ -1823,21 +1870,35 @@ export default function (pi: ExtensionAPI) {
 								}
 								const docText = fs.readFileSync(path.join(modulesDir, docFile), "utf-8");
 								const catNames = svcByCtx.get(ctx)!;
+								// Scope to the Application/Service Layer section — module docs
+								// legitimately title it "### Application Layer (`application/`)"
+								// or "### Service Layer (application)".
+								const secMatch = docText.match(/###\s+(?:Application|Service)\s+Layer[^\n]*\n([\s\S]*?)(?=\n##\s|$)/i);
+								const section = secMatch ? secMatch[1] : docText;
+								// Catalog rows: markdown table rows whose FIRST cell is the service
+								// name. This is the real invariant (the service is presented as a
+								// row in the catalog table) — not a specific header wording.
+								const rowServices = new Set<string>();
+								for (const line of section.split("\n")) {
+									if (!line.trim().startsWith("|")) continue;
+									const first = (line.split("|")[1] ?? "").trim().replace(/^`|`$/g, "");
+									if (first && !/^-+$/.test(first)) rowServices.add(first);
+								}
 								let miss = 0;
-								for (const nm of catNames) if (!docText.includes(nm)) miss++;
-								if (miss > 0) { checks.push("  FAIL " + docFile + " missing " + miss + " catalog service name(s): " + catNames.filter((n) => !docText.includes(n)).join(", ")); issues += miss; }
-								if (!docText.includes("Service (canonical)")) {
-									checks.push("  FAIL " + docFile + " has no Application Layer catalog block (header 'Service (canonical)') for " + catNames.length + " catalog services");
-									issues++;
+								for (const nm of catNames) {
+									if (!rowServices.has(nm)) {
+										checks.push("  FAIL " + docFile + ": catalog service " + nm + " is not presented as a row in the Application Layer catalog section" +
+											(docText.includes(nm) ? " (the name appears in the doc, but not as a catalog row)" : ""));
+										miss++;
+									}
 								}
-								// Parse catalog table rows: | `Service` | use case | fr | Status | Delivered by |
-								const block = docText.slice(docText.indexOf("### Application Layer") >= 0 ? docText.indexOf("### Application Layer") : 0);
-								for (const line of block.split("\n")) {
+								issues += miss;
+								// Implemented-seam / planned-pointer checks apply only to WIDE
+								// catalog rows (5-column: Service | use case | FR | Status |
+								// Delivered by). A 3-column catalog is accepted as-is.
+								for (const line of section.split("\n")) {
 									if (!line.trim().startsWith("|")) continue;
 									const cells = line.split("|").map((c) => c.trim());
-									// Locate the mapsToFr column (FR-00x[, FR-00y]*) — use-case
-									// text may contain escaped pipes (\|) which naive split
-									// fragments, so fixed indexes are unreliable.
 									const frIdx = cells.findIndex((c, i) => i >= 2 && /^((FR|NFR)-\d[\d, ]*)(,\s*(FR|NFR)-\d[\d, ]*)*$/.test(c));
 									if (cells.length < 6 || frIdx < 0) continue;
 									const svcName = cells[1].replace(/^`|`$/g, "");
@@ -1865,7 +1926,8 @@ export default function (pi: ExtensionAPI) {
 									}
 								}
 							}
-							checks.push(issues === 0
+							
+checks.push(issues === 0
 								? "  PASS Catalog blocks + seams verified for all " + svcV.length + " application services"
 								: "  FAIL " + issues + " catalog/seam issue(s)");
 							if (issues > 0) allPassed = false;

package/templates/pi/preflight_report.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2026-09-25T17:27:31Z",
+  "timestamp": "2026-09-25T19:38:51Z",
   "mode": "all",
   "stages_run": [],
   "summary": {
@@ -8,7 +8,7 @@
     "failed": 1,
     "skipped": 12
   },
-  "duration_seconds": 0,
+  "duration_seconds": 1,
   "results": [
   {
     "name": "check_mr_traceability.sh",