guardian-framework 0.1.73 → 0.1.75

package/dist/cli.js

@@ -3197,7 +3197,7 @@ __export(exports_package, {
   bin: () => bin,
   author: () => author
 });
-var name = "guardian-framework", version = "0.1.73", 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.75", 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.73", 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.75", 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.73",
+	"version": "0.1.75",
 	"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 ──
 
@@ -105,6 +106,48 @@ export function createRemoteIssue(
 	return { success: false, issueNumber: null, error: "Could not parse issue number" };
 }
 
+// Create a real GitLab Epic via the glab CLI.
+// Returns the epic IID (string) on success, null on failure.
+export function createGitlabEpic(
+	cwd: string,
+	repository: string,
+	title: string,
+	description: string,
+): string | null {
+	// Derive group from repository path: "group/subgroup/project" -> "group/subgroup"
+	const parts = repository.split("/");
+	if (parts.length < 2) return null;
+	const group = parts.slice(0, -1).join("/");
+
+	// Build description from markdown content (strip YAML frontmatter)
+	const desc = description.replace(/^---[\s\S]*?---\n*/, "").trim();
+
+	// Create epic via glab CLI
+	const result = runScript(
+		cwd,
+		`glab epic create --group "${group}" --title "${title}" --description "${desc.slice(0, 5000)}" 2>&1`,
+	);
+
+	if (result.exitCode !== 0) {
+		// 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/${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}`);
+			return null;
+		}
+		return apiResult.stdout.trim();
+	}
+
+	// Parse epic IID from output: "https://gitlab.com/groups/.../-/epics/42"
+	const epicMatch = result.stdout.match(/epics\/(\d+)/);
+	return epicMatch ? epicMatch[1] : null;
+}
+
 // Ensure the GitHub/GitLab repository exists and local git remote is configured.
 // Returns the repository slug if remote is ready, empty string if not available.
 export function ensureRemoteRepo(
@@ -156,15 +199,28 @@ 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`,
+			);
+
 	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}`);

package/templates/pi/extensions/architect.ts

@@ -28,6 +28,7 @@ import {
 	readRepoTool,
 	runScript,
 	saveRoadmapState,
+	createGitlabEpic,
 } from "./architect-lib/helpers";
 import {
 	generateArchitectureReadinessMarkdown,
@@ -175,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 });
@@ -302,29 +313,52 @@ class EpicManager {
 		issues.push(readinessEntry);
 
 		// ── TDD test generation ──
-		let tddTestFiles: string[] = [];
+		const tddTestFiles: string[] = [];
 		if (tdd) {
 			const language = readLanguage(this.cwd);
 			if (isTddSupported(language)) {
-				tddTestFiles = generateEpicTestFiles({
+				tddTestFiles.push(...generateEpicTestFiles({
 					components: slice.nextLogicalSlice,
 					moduleId: slice.module,
 					cwd: this.cwd,
 					language,
-				});
+				}));
+			}
+		}
+
+		// ── GitLab Epic creation (only for GitLab repos with remote access) ──
+		let effectiveEpicId: string | null = null;
+		if (repoTool === "glab" && hasRemote && remoteRepo) {
+			const epicTitle = `Epic: ${name} — ${slice.module}`;
+			const epicDesc = [
+				`# ${epicTitle}`,
+				"",
+				`**Module:** ${slice.module}`,
+				`**Components:** ${slice.nextLogicalSlice.length}`,
+				"",
+				"## Issues",
+				...issues.map((i) => `- ${i.title}${i.remoteIssueId ? ` (#${i.remoteIssueId})` : ""}`),
+				"",
+				"---",
+				"Auto-generated by Guardian Architect",
+			].join("\n");
+			effectiveEpicId = createGitlabEpic(this.cwd, remoteRepo, epicTitle, epicDesc);
+			if (effectiveEpicId) {
+				console.warn(`Created GitLab epic #${effectiveEpicId}`);
 			}
 		}
 
 		const state: EpicState = {
 			name,
 			trackingIssueId: effectiveTrackingId,
-			epicId: null,
+			epicId: effectiveEpicId,
 			slices: [slice],
 			issues,
 			status: "planning",
 			currentIssueIndex: 0,
 			createdAt: new Date().toISOString(),
 			tdd,
+			tddTestFiles,
 		};
 
 		this.state = state;

package/templates/pi/preflight_report.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2026-07-13T11:44:15Z",
+  "timestamp": "2026-07-13T12:43:57Z",
   "mode": "all",
   "stages_run": [],
   "summary": {

package/templates/pi/scripts/git/create-tracking-issue.sh

@@ -163,7 +163,7 @@ case "$PLATFORM" in
 
         # Try to add labels separately (non-fatal)
         if [[ -n "$LABELS" && -n "$ISSUE_NUMBER" ]]; then
-            glab issue update "$ISSUE_NUMBER" --label "$LABELS" 2>/dev/null || true
+            glab issue update "$ISSUE_NUMBER" --label "$LABELS" ${REPO:+--repo "$REPO"} 2>/dev/null || true
         fi
 
         echo "TRACKING_ID=$ISSUE_NUMBER"

package/templates/pi/scripts/git/link-issue-to-epic.sh

@@ -57,7 +57,7 @@ Relates to #$EPIC_ID" 2>/dev/null
         # API: POST /groups/:group/epics/:epic_iid/issues/:issue_iid
         # Derive group from repository path: "group/subgroup/project" -> "group/subgroup"
         if [[ -n "$REPO" ]]; then
-            local group_path=$(echo "$REPO" | rev | cut -d'/' -f2- | rev)
+            group_path=$(echo "$REPO" | rev | cut -d'/' -f2- | rev)
             if [[ -n "$group_path" ]]; then
                 glab api --method POST "groups/$group_path/epics/$EPIC_ID/issues/$ISSUE_ID" 2>/dev/null && {
                     echo "Linked GitLab issue #$ISSUE_ID to epic #$EPIC_ID"