guardian-framework 0.1.148 → 0.1.150

package/README.md

@@ -41,15 +41,24 @@ Enrich Module Docs     ←─ agent fills DDD content from exploration
 ADRs, Diagrams, Specs  ←─ you challenge decisions, finalize
     │
     ▼
-Roadmap Plan           ←─ you adopt phases, set priorities
+Roadmap Plan           ←─ one module per phase (Phase 0 = bootstrap)
     │
     ▼
-Epic Execution         ─── agents implement, you review PRs
+Epic Execution         ─── one branch + one PR per epic, local CI per issue
+    │                  └─ parallel epics: isolated worktrees, contract-freeze gate
+    ▼
+Wiring Check           ─── every module must be INSTALLED in the app shell
     │
     ▼
 Enforcement Pipeline   ─── CI blocks merges on violation
 ```
 
+> New since 0.1.128: exploration is terminal and self-driving, stubs follow the
+> detected language, epics ship as one PR, parallel epics are gated on frozen
+> contracts, and five enforcement controls make "can this actually block a
+> merge?" a machine-readable answer. See
+> [manual §30–39](docs/USER_MANUAL.md#30-exploration--roadmap--epic-the-current-pipeline).
+
 ---
 
 ## Walkthrough: From Intent to Enforcement
@@ -207,30 +216,42 @@ If someone (or an AI) adds a dependency from the domain layer to infrastructure,
 ## Quick Start
 
 ```bash
-# 1. Scaffold
+# 1. Init (installs .pi/ — prompts, extensions, validators)
 cd your-project
 npx guardian-framework init
 
-# 2. Explore (iterative — review, refine, repeat)
-/domain --explore "your business intent"   # agent classifies core/supporting/generic — YOU gate it
-/domain --validate <session-id>            # structural + UL + ADR-008 depth rules
-
-# 3. Generate architecture from exploration (module docs gain Modeling Depth + invariants)
-/domain --architect-scaffold <session-id>
+# 2. Explore — the agent classifies core/supporting/generic; YOU gate the depth.
+#    Delivers the full protocol in one message, then STOPS. Resume with --resume.
+/domain --explore "your business intent"
 
-# 4. Enrich module docs with full DDD content
-/domain --enrich <session-id>
+# 3. Validate the analysis against the files that were written (drift gate)
+guardian domain validate <session-id>
 
-# 5. Review and refine (ADRs, diagrams, modules — human-in-the-loop)
+# 4. Create module docs — never overwrites existing ones
+guardian domain scaffold --session <session-id>
+guardian domain enrich   --session <session-id>   # full DDD content, session-scoped
 
-# 6. Adopt the roadmap
+# 5. Roadmap — ONE module per phase, Phase 0 is Project Bootstrap
 /architect --roadmap
-/architect --adopt-roadmap
 
-# 6. Execute
-/architect --phase "Phase 0"
+# 6. Execute — epic mode is the default: one branch, local CI per issue, one PR
+/architect --epic "Policy Engine"
+
+#    ...or run several in parallel (gated on frozen contracts)
+bash .pi/scripts/epic-registry.sh freeze "Policy Engine" --frozen
+bash .pi/scripts/epic-parallel.sh "Policy Engine"     # isolated worktree
+
+# 7. Prove it is actually wired, not just implemented
+bash .pi/scripts/check_composition_root.sh
+bash .pi/scripts/validate-wiring-claims.sh
+
+# 8. See what can block a merge
+bash .pi/scripts/validate-guards.sh --list
 ```
 
+Minimal project bootstrap is the default (shared kernel only). Add bounded-context
+folders with `--withContexts`, or let the roadmap phases create them.
+
 ---
 
 ## What This Means
@@ -248,6 +269,8 @@ Guardian was proven on [Rigorix](https://github.com/arman-jalili/rigorix-oss): 1
 | | |
 |---|---|
 | **User Manual** | [docs/USER_MANUAL.md](docs/USER_MANUAL.md) — every workflow, command, and extension |
+| **Pipeline (0.1.148)** | [manual §30–39](docs/USER_MANUAL.md#30-exploration--roadmap--epic-the-current-pipeline) — explore → roadmap → epic → wiring → controls |
+| **Design note** | [docs/design/exploration-and-roadmap-pipeline.md](docs/design/exploration-and-roadmap-pipeline.md) |
 | **Proven on** | [Rigorix](https://github.com/arman-jalili/rigorix-oss) — 146K LOC Rust, 30 modules |
 | **Source** | [github.com/arman-jalili/guardian-framework](https://github.com/arman-jalili/guardian-framework) |
 | **License** | MIT |

package/dist/cli.js

@@ -3206,7 +3206,7 @@ __export(exports_package, {
   bin: () => bin,
   author: () => author
 });
-var name = "guardian-framework", version = "0.1.148", 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.150", 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.148", 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.150", 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.148",
+	"version": "0.1.150",
 	"description": "Token-optimized agentic framework scaffolder with pi-first architecture",
 	"type": "module",
 	"main": "dist/exports.js",

package/templates/pi/extensions/architect-lib/types.ts

@@ -157,5 +157,12 @@ export type EpicState = {
 	createdAt: string;
 	tdd: boolean;
 	tddTestFiles: string[];
+	// ── Orchestration (optional: added 0.1.150) ──────────────────────────
+	// These are written by /architect before the epic starts (--pr-per,
+	// --parallel/--worktree) and MUST survive startEpic's state save, which
+	// otherwise builds a fresh literal and drops them.
+	prStrategy?: "epic" | "issue";
+	parallel?: boolean;
+	worktree?: string;
 };
 

package/templates/pi/extensions/architect.ts

@@ -434,7 +434,18 @@ class EpicManager {
 			}
 		}
 
+		// Carry over orchestration decided BEFORE the epic started (--pr-per,
+		// --parallel/--worktree). This literal is written over the file, so
+		// anything not carried here is silently lost — which is exactly what
+		// happened to prStrategy/parallel/worktree before 0.1.150.
+		const priorState = loadEpicState(this.cwd);
+		const carried: Pick<EpicState, "prStrategy" | "parallel" | "worktree"> = {};
+		if (priorState?.prStrategy) carried.prStrategy = priorState.prStrategy;
+		if (priorState?.parallel) carried.parallel = priorState.parallel;
+		if (priorState?.worktree) carried.worktree = priorState.worktree;
+
 		const state: EpicState = {
+			...carried,
 			name,
 			trackingIssueId: effectiveTrackingId,
 			epicId: effectiveEpicId,
@@ -879,13 +890,19 @@ export default function architectExtension(pi: ExtensionAPI) {
 			const tddEnabled = tokens.includes("--tdd");
 
 			if (!epicName) {
-				ctx.ui.notify('Usage: /architect --epic "Epic Name" [--tracking-issue N] [--tdd]', "error");
+				ctx.ui.notify(
+					'Usage: /architect --epic "Epic Name" [--tracking-issue N] [--tdd] [--pr-per epic|issue] [--parallel|--worktree]',
+					"error",
+				);
 				return;
 			}
 
 			try {
 				if (!epicName || epicName.trim() === "") {
-					ctx.ui.notify('Usage: /architect --epic "Epic Name" [--tracking-issue N] [--tdd]', "error");
+					ctx.ui.notify(
+					'Usage: /architect --epic "Epic Name" [--tracking-issue N] [--tdd] [--pr-per epic|issue] [--parallel|--worktree]',
+					"error",
+				);
 					return;
 				}
 

package/templates/pi/preflight_report.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2026-11-07T14:10:40Z",
+  "timestamp": "2026-11-13T15:22:46Z",
   "mode": "all",
   "stages_run": [],
   "summary": {