guardian-framework 0.1.73 → 0.1.74

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.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 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.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 init_package = __esm(() => {
   exports = {
     ".": {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "guardian-framework",
-	"version": "0.1.73",
+	"version": "0.1.74",
 	"description": "Token-optimized agentic framework scaffolder with pi-first architecture",
 	"type": "module",
 	"main": "dist/exports.js",

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

@@ -105,6 +105,47 @@ 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
+		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'`,
+		);
+		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(

package/templates/pi/extensions/architect.ts

@@ -28,6 +28,7 @@ import {
 	readRepoTool,
 	runScript,
 	saveRoadmapState,
+	createGitlabEpic,
 } from "./architect-lib/helpers";
 import {
 	generateArchitectureReadinessMarkdown,
@@ -306,25 +307,48 @@ class EpicManager {
 		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-13T11:51:20Z",
   "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"