guardian-framework 0.1.69 → 0.1.71

package/dist/cli.js

@@ -3197,7 +3197,7 @@ __export(exports_package, {
   bin: () => bin,
   author: () => author
 });
-var name = "guardian-framework", version = "0.1.69", 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.71", 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

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

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

@@ -7,11 +7,16 @@ export function generateIssueMarkdown(
 	slice: ArchitectureSlice,
 	issueIndex: number,
 	totalIssues: number,
+	tdd?: boolean,
 ): string {
 	const moduleId = slice.module.replace(/^module-/, "");
 	const componentName = component.name.toLowerCase().replace(/\s+/g, "-");
 	const issueId = `ISSUE-${moduleId.toUpperCase()}-${issueIndex + 1}`;
 
+	const testLine = tdd
+		? `    - "update: tests/unit/${moduleId}/${componentName}/ (failing tests already generated — make them pass)"`
+		: `    - "create: tests/unit/${moduleId}/${componentName}/"`;
+
 	return `---
 guardian_issue:
   id: "${issueId}"
@@ -70,7 +75,7 @@ ${component.dependencies.map((d) => `    - "${d}"`).join("\n")}
     - "modify: src/${moduleId}/application/"
     - "modify: src/${moduleId}/infrastructure/"
     - "modify: src/${moduleId}/interfaces/"
-    - "create: tests/unit/${moduleId}/${componentName}/"
+    - ${testLine}
     - "create: tests/integration/${moduleId}/${componentName}/"
 ---
 

package/templates/pi/extensions/architect.ts

@@ -147,6 +147,14 @@ class EpicManager {
 
 		ctx.ui.setStatus("architect", `Planning epic: ${name}`);
 
+		// Ensure git repo is initialized before any remote operations
+		const gitCheck = runScript(this.cwd, "git rev-parse --git-dir 2>/dev/null");
+		if (gitCheck.exitCode !== 0) {
+			runScript(this.cwd, "git init");
+			runScript(this.cwd, "git add .");
+			runScript(this.cwd, 'git commit -m "Initial Guardian scaffold"');
+		}
+
 		const repoTool = readRepoTool(this.cwd);
 		const repository = readRepository(this.cwd);
 		const targetRepo = repository || slice.module;
@@ -159,18 +167,11 @@ class EpicManager {
 				repoTool === "glab" ? "glab auth status 2>/dev/null" : "gh auth status 2>/dev/null",
 			);
 			if (authCheck.exitCode === 0) {
-				// Verify project-level access, not just global auth
-				const projectAccessCheck = repository ? runScript(
-					this.cwd,
-					repoTool === "glab"
-						? `glab api "projects/${repository}" --method GET 2>/dev/null | jq -r '.id // empty'`
-						: `gh api "repos/${repository}" --method GET 2>/dev/null | jq -r '.id // empty'`,
-				) : { exitCode: 0, stdout: "" };
-
-				if (projectAccessCheck.exitCode === 0 && projectAccessCheck.stdout.trim().length > 0) {
-					remoteRepo = ensureRemoteRepo(this.cwd, targetRepo, name, repoTool);
-					hasRemote = remoteRepo.length > 0;
-				}
+				// Try to ensure remote repo — ensureRemoteRepo handles both:
+				// - existing repos: configures local origin
+				// - nonexistent repos: creates remote repo via gh/glab CLI
+				remoteRepo = ensureRemoteRepo(this.cwd, targetRepo, name, repoTool);
+				hasRemote = remoteRepo.length > 0;
 			}
 		}
 
@@ -250,7 +251,7 @@ class EpicManager {
 				status: "planned" as string,
 				remoteIssueId: null as string | null,
 			};
-			const md = generateIssueMarkdown(comp, slice, i, slice.nextLogicalSlice.length);
+			const md = generateIssueMarkdown(comp, slice, i, slice.nextLogicalSlice.length, tdd);
 			writeFileSync(join(issuesDir, `${id}.md`), md);
 			if (hasRemote && remoteRepo) {
 				const result = createRemoteIssue(this.cwd, entry.title, join(issuesDir, `${id}.md`), "epic,implementation", remoteRepo);
@@ -757,15 +758,7 @@ export default function (pi: ExtensionAPI) {
 					return;
 				}
 
-				// Initialize git if needed
-				try {
-					const gitCheck = runScript(ctx.cwd, "git rev-parse --git-dir 2>/dev/null");
-					if (gitCheck.exitCode !== 0) {
-						runScript(ctx.cwd, "git init");
-						runScript(ctx.cwd, "git add .");
-						runScript(ctx.cwd, 'git commit -m "Initial Guardian scaffold"');
-					}
-				} catch { /* ignore */ }
+
 
 				// Remove stale pipeline state so the new one takes effect
 				try {

package/templates/pi/extensions/pipeline.ts

@@ -20,7 +20,7 @@
  *   /pipeline abort               Kill pipeline
  */
 
-import { execSync } from "node:child_process";
+import { execFileSync, execSync } from "node:child_process";
 import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 import {
@@ -863,14 +863,71 @@ export default function (pi: ExtensionAPI) {
 			const prevItemIndex = state.currentItemIndex;
 			const prevStepIndex = state.currentStepIndex;
 			const stepName = (params.stepName as string) || state.steps[prevStepIndex]?.name;
+
+			// Verify current step before advancing (unless user explicitly provides the step name,
+			// which counts as manual confirmation)
+			if (!params.stepName) {
+				const verification = manager.verifyCurrentStep();
+				if (!verification.verified) {
+					return {
+						content: [{ type: "text" as const, text: `Cannot advance: ${verification.reason}` }],
+					};
+				}
+			}
+
 			manager.markStepPassed(stepName);
 			manager.advanceStep();
 
 			// Re-read state after advance
 			const updatedState = manager.getState()!;
 
+			// Non-blocking: sync progress to tracking issue if one exists
+			try {
+				const trackingStatePath = join(ctx.cwd, ".pi/.guardian-epic-state.json");
+				if (existsSync(trackingStatePath)) {
+					const trackingState = JSON.parse(readFileSync(trackingStatePath, "utf-8")) as {
+						trackingIssueId?: string | null;
+						issues?: { id: string; title: string; status: string }[];
+					};
+					if (trackingState.trackingIssueId && !trackingState.trackingIssueId.startsWith("local:")) {
+						const stepNote = stepName
+							? `✓ Step "${stepName}" complete for item "${updatedState.items[prevItemIndex]}"`
+							: `✓ Advanced to item ${updatedState.currentItemIndex + 1}/${updatedState.items.length}: "${updatedState.items[updatedState.currentItemIndex]}"`;
+						const updateScript = join(ctx.cwd, ".pi/scripts/git/update-tracking-issue.sh");
+						if (existsSync(updateScript)) {
+							execFileSync("bash", [updateScript, "--id", trackingState.trackingIssueId, "--comment", stepNote], {
+								cwd: ctx.cwd,
+								timeout: 30_000,
+								encoding: "utf-8",
+								stdio: "ignore",
+							});
+						}
+					}
+				}
+			} catch { /* non-blocking — don't fail the pipeline */ }
+
 			// Pipeline complete
 			if (updatedState.currentItemIndex >= updatedState.items.length) {
+				// Non-blocking: close tracking issue and epic on pipeline completion
+				try {
+					const epicStatePath = join(ctx.cwd, ".pi/.guardian-epic-state.json");
+					if (existsSync(epicStatePath)) {
+						const epicState = JSON.parse(readFileSync(epicStatePath, "utf-8")) as {
+							trackingIssueId?: string | null;
+							epicId?: string | null;
+						};
+						if (epicState.trackingIssueId && !epicState.trackingIssueId.startsWith("local:")) {
+							const closeEpicScript = join(ctx.cwd, ".pi/scripts/git/close-epic.sh");
+							if (existsSync(closeEpicScript)) {
+								const args: string[] = [closeEpicScript, "--tracking-id", epicState.trackingIssueId];
+								if (epicState.epicId) args.push("--epic-id", epicState.epicId);
+								execFileSync("bash", args, {
+									cwd: ctx.cwd, timeout: 30_000, encoding: "utf-8", stdio: "ignore",
+								});
+							}
+						}
+					}
+				} catch { /* non-blocking */ }
 				return {
 					content: [{
 						type: "text" as const,
@@ -884,6 +941,30 @@ export default function (pi: ExtensionAPI) {
 			const movedToNextItem = updatedState.currentItemIndex !== prevItemIndex;
 
 			// If we moved to a new item (completed all steps of previous item),
+			// close its remote issue
+			if (movedToNextItem) {
+				// Close remote issue for the completed item
+				try {
+					const epicStatePath = join(ctx.cwd, ".pi/.guardian-epic-state.json");
+					if (existsSync(epicStatePath)) {
+						const epicState = JSON.parse(readFileSync(epicStatePath, "utf-8")) as {
+							issues?: { id: string; remoteIssueId?: string | null }[];
+						};
+						const prevItemId = updatedState.items[prevItemIndex];
+						const prevIssue = epicState.issues?.find((i) => i.id === prevItemId);
+						if (prevIssue?.remoteIssueId) {
+							const closeScript = join(ctx.cwd, ".pi/scripts/git/close-issue.sh");
+							if (existsSync(closeScript)) {
+								execFileSync("bash", [closeScript, "--id", prevIssue.remoteIssueId], {
+									cwd: ctx.cwd, timeout: 30_000, encoding: "utf-8", stdio: "ignore",
+								});
+							}
+						}
+					}
+				} catch { /* non-blocking */ }
+			}
+
+			// If we moved to a new item and the next step is implement,
 			// inject the full next-task prompt with issue context
 			if (movedToNextItem && currentStep?.name === "implement") {
 				// Find the remote issue ID from epic state

package/templates/pi/preflight_report.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2026-07-12T15:32:11Z",
+  "timestamp": "2026-07-13T11:15:40Z",
   "mode": "all",
   "stages_run": [],
   "summary": {

package/templates/pi/scripts/create-mr.sh

@@ -56,7 +56,7 @@ if [[ "$PLATFORM" == "none" ]]; then
 fi
 
 # Determine branch name from issue ID
-BRANCH_NAME="feature/${ISSUE_ID}"
+BRANCH_NAME="feat/${ISSUE_ID}"
 
 # Ensure we're on the main branch before creating feature branch
 git checkout -b "$BRANCH_NAME" 2>/dev/null || git checkout "$BRANCH_NAME" 2>/dev/null || true

package/templates/pi/scripts/merge-mr.sh

@@ -36,7 +36,7 @@ while [[ $# -gt 0 ]]; do
 done
 
 PLATFORM=$(detect_platform)
-BRANCH_NAME="feature/${ISSUE_ID}"
+BRANCH_NAME="feat/${ISSUE_ID}"
 
 if [[ "$PLATFORM" == "none" ]]; then
     echo "No git platform detected. Cannot merge without gh/glab CLI."