guardian-framework 0.1.74 → 0.1.76

package/dist/cli.js

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

package/templates/pi/extensions/architect-lib/forge-adapter.ts

@@ -72,6 +72,15 @@ export function readLanguage(cwd: string): string {
 	return "typescript";
 }
 
+/**
+ * URL-encode a GitLab project/group path for API calls.
+ * GitLab API requires nested paths to be URL-encoded:
+ *   "group/subgroup/project" -> "group%2Fsubgroup%2Fproject"
+ */
+export function glabEncodePath(rawPath: string): string {
+	return encodeURIComponent(rawPath);
+}
+
 /**
  * Get forge base URL. For GitLab, detects self-hosted instances via glab config.
  */
@@ -142,10 +151,11 @@ export function verifyForgeAccess(cwd: string): { authenticated: boolean; projec
 
 	// Verify project-level access
 	if (repository) {
+		const encodedRepo = repoTool === "glab" ? glabEncodePath(repository) : repository;
 		const projectCheck = runScript(
 			cwd,
 			repoTool === "glab"
-				? `glab api "projects/${repository}" --method GET 2>/dev/null | jq -r '.id // empty'`
+				? `glab api "projects/${encodedRepo}" --method GET 2>/dev/null | jq -r '.id // empty'`
 				: `gh api "repos/${repository}" --method GET 2>/dev/null | jq -r '.id // empty'`,
 		);
 		if (projectCheck.exitCode === 0 && projectCheck.stdout.trim().length > 0) {

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

@@ -10,6 +10,7 @@ import {
 	commandExists as adapterCommandExists,
 	runScript as adapterRunScript,
 	verifyForgeAccess,
+	glabEncodePath,
 } from "./forge-adapter.ts";
 // ── Constants ──
 
@@ -42,16 +43,17 @@ function execSyncWithRetry(
 	cwd: string,
 	opts: { timeout?: number; maxRetries?: number; delayMs?: number } = {},
 ): { exitCode: number; stdout: string } {
-	const maxRetries = opts.maxRetries ?? 2;
-	const delayMs = opts.delayMs ?? 2000;
+	const maxRetries = opts.maxRetries ?? 4;
+	const delayMs = opts.delayMs ?? 5000;
 	let lastError = "";
 
 	for (let attempt = 0; attempt <= maxRetries; attempt++) {
 		if (attempt > 0) {
-			const wait = delayMs * Math.pow(2, attempt - 1);
-			const waitSec = Math.ceil(wait / 1000);
+			const wait = delayMs * Math.pow(1.5, attempt - 1);
+			const waitMs = Math.min(wait, 30_000);
+			const waitSec = Math.ceil(waitMs / 1000);
 			try {
-				execFileSync("sleep", [String(waitSec)], { cwd, timeout: 30_000, encoding: "utf-8" });
+				execFileSync("sleep", [String(waitSec)], { cwd, timeout: 60_000, encoding: "utf-8" });
 			} catch { /* ignore */ }
 		}
 		try {
@@ -128,11 +130,12 @@ export function createGitlabEpic(
 	);
 
 	if (result.exitCode !== 0) {
-		// Fallback: try the API directly
+		// Fallback: try the API directly (URL-encode nested group paths)
+		const encodedGroup = glabEncodePath(group);
 		const body = JSON.stringify({ title, description: desc.slice(0, 5000) });
 		const apiResult = runScript(
 			cwd,
-			`glab api --method POST "groups/${group}/epics" --body '${body}' 2>/dev/null | jq -r '.iid // empty'`,
+			`glab api --method POST "groups/${encodedGroup}/epics" --body '${body}' 2>/dev/null | jq -r '.iid // empty'`,
 		);
 		if (apiResult.exitCode !== 0 || !apiResult.stdout.trim()) {
 			console.warn(`Failed to create GitLab epic: ${result.stdout || apiResult.stdout}`);
@@ -197,22 +200,60 @@ export function ensureRemoteRepo(
 
 	// GitLab path — detect self-hosted base URL from glab config
 	const glabBaseUrl = getGitBaseUrl("glab");
-	const createResult = runScript(
-		cwd,
-		`glab repo create "${repository}" --private --description "Epic: ${epicName}" 2>&1`,
-	);
+
+	// Split repository path into group + project name for glab CLI
+	const parts = repository.split("/");
+	const projectName = parts.pop()!;
+	const group = parts.join("/");
+
+	const createResult = group
+		? runScript(
+				cwd,
+				`glab repo create "${projectName}" --group "${group}" --private --description "Epic: ${epicName}" 2>&1`,
+			)
+		: runScript(
+				cwd,
+				`glab repo create "${repository}" --private --description "Epic: ${epicName}" 2>&1`,
+			);
+
+	let projectId = "";
 	if (createResult.exitCode !== 0) {
 		// Repo may already exist — verify via API before giving up
+		const encodedPath = glabEncodePath(repository);
 		const viewResult = runScript(
 			cwd,
-			`glab api "projects/${repository}" --method GET 2>/dev/null | jq -r '.id // empty'`,
+			`glab api "projects/${encodedPath}" --method GET 2>/dev/null | jq -r '.id // empty'`,
 		);
 		if (viewResult.exitCode !== 0 || !viewResult.stdout.trim()) {
 			console.warn(`Failed to create or find GitLab project: ${createResult.stdout}`);
 			return "";
 		}
-		console.warn(`GitLab project already exists, connecting to it.`);
+		projectId = viewResult.stdout.trim();
+		console.warn(`GitLab project already exists (id=${projectId}), connecting to it.`);
+	} else {
+		// Project was just created — wait for GitLab to provision it
+		// (new projects can take 10-30s before accepting issues)
+		const encodedPath = glabEncodePath(repository);
+		console.warn(`Waiting for GitLab project to be ready...`);
+		for (let attempt = 0; attempt < 12; attempt++) {
+			const checkResult = runScript(
+				cwd,
+				`glab api "projects/${encodedPath}" --method GET 2>/dev/null | jq -r '.id // empty'`,
+			);
+			if (checkResult.exitCode === 0 && checkResult.stdout.trim()) {
+				projectId = checkResult.stdout.trim();
+				console.warn(`GitLab project ready (id=${projectId})`);
+				break;
+			}
+			if (attempt < 11) {
+				try { execFileSync("sleep", ["5"], { cwd, timeout: 30_000 }); } catch { /* ignore */ }
+			}
+		}
+		if (!projectId) {
+			console.warn(`GitLab project not ready after 60s, continuing anyway.`);
+		}
 	}
+
 	runScript(cwd, "git remote remove origin 2>/dev/null");
 	const httpsUrl = `${glabBaseUrl}/${repository}.git`;
 	runScript(cwd, `git remote add origin "${httpsUrl}"`);

package/templates/pi/extensions/architect.ts

@@ -176,6 +176,16 @@ class EpicManager {
 			}
 		}
 
+		// Loud warning if GitLab remote setup failed
+		if (repoTool === "glab" && !hasRemote) {
+			console.warn(
+				"⚠️  GitLab remote repo setup failed. Pipeline will run LOCAL-ONLY."
+				+ " Issues will be created as local .md files, not on GitLab."
+				+ " Check that the repository path in guardian-manifest.json exists"
+				+ " and your GitLab token has 'write_repository' scope.",
+			);
+		}
+
 		const issues: { id: string; title: string; status: string; remoteIssueId?: string | null }[] = [];
 		const issuesDir = join(this.cwd, ".pi/issues");
 		if (!existsSync(issuesDir)) mkdirSync(issuesDir, { recursive: true });
@@ -303,7 +313,7 @@ class EpicManager {
 		issues.push(readinessEntry);
 
 		// ── TDD test generation ──
-		let tddTestFiles: string[] = [];
+		const tddTestFiles: string[] = [];
 		if (tdd) {
 			const language = readLanguage(this.cwd);
 			if (isTddSupported(language)) {

package/templates/pi/preflight_report.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2026-07-13T11:51:20Z",
+  "timestamp": "2026-07-13T12:58:14Z",
   "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",