guardian-framework 0.1.155 → 0.1.156

package/dist/cli.js

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

package/templates/pi/preflight_report.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2026-11-13T17:15:30Z",
+  "timestamp": "2026-11-13T17:26:44Z",
   "mode": "all",
   "stages_run": [],
   "summary": {

package/templates/pi/scripts/epic-fanout.sh

@@ -58,6 +58,16 @@ RUNNER="$ROOT/.pi/scripts/epic-runner.mjs"
 [ -f "$RUNNER" ] || { echo "missing $RUNNER — run guardian update" >&2; exit 1; }
 
 # The runner is a Node script; bun also executes it.
+# The project directory is the one that owns .pi/ (this script lives in
+# <project>/.pi/scripts). It is NOT necessarily the git top level: a monorepo
+# often keeps the app in <repo>/backend with .pi/ inside it. Agents must run in
+# the project dir, otherwise pi finds no extensions and /architect is not a
+# command at all.
+PROJECT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+GIT_TOP="$(git -C "$PROJECT_DIR" rev-parse --show-toplevel 2>/dev/null || echo "$PROJECT_DIR")"
+PROJECT_REL="${PROJECT_DIR#"$GIT_TOP"}"
+PROJECT_REL="${PROJECT_REL#/}"
+
 NODE_BIN="$(command -v node || command -v bun || true)"
 if [ -z "$NODE_BIN" ]; then
 	echo "neither node nor bun found — required to spawn headless agents" >&2
@@ -158,6 +168,17 @@ while IFS= read -r modline; do
 	[ -n "$modline" ] && MODULES+=("$modline")
 done <<<"$SELECTED"
 
+# ── Pre-flight: the spawned agents inherit THIS project's .pi/ ──────────────
+# Without extensions, /architect is not a command: the prompt falls through to
+# the model, which then improvises (expensive and wrong). Fail before spawning.
+if [ "$NO_SPAWN" -eq 0 ] && [ "$DRY_RUN" -eq 0 ]; then
+	if [ ! -d "$PROJECT_DIR/.pi/extensions" ]; then
+		echo "⛔ $PROJECT_DIR/.pi/extensions is missing — the agent would have no /architect command." >&2
+		echo "   Run guardian update in $PROJECT_DIR, or use --no-spawn." >&2
+		exit 1
+	fi
+fi
+
 echo "============================================"
 echo "  Parallel epic fan-out"
 echo "============================================"
@@ -388,15 +409,23 @@ for m in ${MODULES[@]+"${MODULES[@]}"}; do
 	echo "  ✓ worktree $WT"
 
 	if [ "$NO_SPAWN" -eq 1 ]; then
-		echo "  → run:  cd \"$WT\" && /architect --epic \"$m\"$( [ "$TDD" -eq 1 ] && echo " --tdd")"
+		echo "  → run:  cd \"$WT${PROJECT_REL:+/$PROJECT_REL}\" && /architect --epic \"$m\"$( [ "$TDD" -eq 1 ] && echo " --tdd")"
 		STARTED+=("$m")
 		continue
 	fi
 
 	# 3. spawn one headless agent in the worktree (RPC mode dispatches the command)
+	#    cwd must be the PROJECT dir inside the worktree (where .pi/ lives).
+	SPAWN_CWD="$WT"
+	[ -n "$PROJECT_REL" ] && SPAWN_CWD="$WT/$PROJECT_REL"
+	if [ ! -d "$SPAWN_CWD/.pi/extensions" ]; then
+		echo "  ✗ $SPAWN_CWD/.pi/extensions missing — refusing to spawn a blind agent"
+		FAILED+=("$m")
+		continue
+	fi
 	"$NODE_BIN" "$RUNNER" \
 		"/architect --epic \"$m\"$( [ "$TDD" -eq 1 ] && echo " --tdd")" \
-		--cwd "$WT" --log "$log" ${TIMEOUT_MS:+--timeout-ms "$TIMEOUT_MS"} \
+		--cwd "$SPAWN_CWD" --log "$log" ${TIMEOUT_MS:+--timeout-ms "$TIMEOUT_MS"} \
 		>/dev/null 2>&1 &
 	PID=$!
 	bash "$REGISTRY" set "$m" "pid=$PID" "log=$log" "spawnedAt=$(date -u +%Y-%m-%dT%H:%M:%SZ)" >/dev/null 2>&1

package/templates/pi/scripts/epic-runner.mjs

@@ -115,9 +115,32 @@ function handleLine(line) {
 	// The prompt was accepted by an extension command?
 	if (msg.type === "response" && msg.command === "prompt" && msg.success === true) {
 		const d = msg.data?.disposition;
-		if (d === "handled") handled = true;
-		else if (d === "started" || d === "queued") handled = true;
-		if (handled) armGrace();
+		// "handled" = an extension command consumed it (what we need).
+		// "started"/"queued" = it went to the MODEL. For a /command that means
+		// the extension was not loaded (wrong cwd, missing .pi/extensions) — the
+		// model then improvises the workflow, which looks like success and burns
+		// tokens. Treat that as a hard error.
+		const isCommand = opts.command.startsWith("/");
+		if (d === "handled") {
+			handled = true;
+			armGrace();
+		} else if (isCommand) {
+			emit(
+				JSON.stringify({
+					type: "runner_error",
+					reason: "command_not_dispatched",
+					detail:
+						`'${opts.command.split(/\s+/)[0]}' was routed to the model ` +
+						`(disposition "${d}") — the extension is not loaded in ${opts.cwd}. ` +
+						"Check that .pi/extensions exists in that directory.",
+				}),
+			);
+			failed = true;
+			finish(3);
+		} else {
+			handled = true;
+			armGrace();
+		}
 	}
 	if (msg.type === "response" && msg.command === "prompt" && msg.success === false) {
 		emit(JSON.stringify({ type: "runner_error", reason: "prompt rejected" }));