guardian-framework 0.1.0 → 0.1.1

package/README.md

@@ -92,10 +92,19 @@ During that build:
 ## Installation
 
 ```bash
-npx guardian-framework init     # Scaffold in current directory
+# CLI tool — scaffold in any project
+npx guardian-framework init
 npm install -g guardian-framework
 ```
 
+**Pi package** — load extensions, skills, and prompts directly into a [pi](https://github.com/badlogic/pi-mono) session:
+
+```bash
+pi install npm:guardian-framework
+```
+
+This makes all Guardian slash commands (`/architect`, `/pipeline`, `/goal`, `/domain`, etc.) available inside pi without running `guardian init` first. Run `/guardian-status` after install to check availability.
+
 **Prerequisites:** [Bun](https://bun.sh) >= 1.0.0
 
 ---

package/dist/cli.js

@@ -1317,6 +1317,8 @@ __export(exports_package, {
   type: () => type,
   scripts: () => scripts,
   repository: () => repository,
+  publishConfig: () => publishConfig,
+  pi: () => pi,
   name: () => name,
   main: () => main,
   license: () => license,
@@ -1333,7 +1335,7 @@ __export(exports_package, {
   bin: () => bin,
   author: () => author
 });
-var name = "guardian-framework", version = "0.1.0", 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, 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.1", 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 = {
     ".": {
@@ -1344,7 +1346,7 @@ var init_package = __esm(() => {
   bin = {
     "guardian-framework": "./dist/cli.js"
   };
-  files = ["dist/", "templates/"];
+  files = ["dist/", "templates/", "pi-package/"];
   engines = {
     bun: ">=1.0.0"
   };
@@ -1358,6 +1360,14 @@ var init_package = __esm(() => {
     typecheck: "tsc --noEmit",
     dev: "bun run src/cli.ts"
   };
+  publishConfig = {
+    access: "public"
+  };
+  pi = {
+    extensions: ["./pi-package/extensions"],
+    skills: ["./pi-package/skills"],
+    prompts: ["./pi-package/prompts"]
+  };
   repository = {
     type: "git",
     url: "https://github.com/arman-jalili/guardian-framework"
@@ -1366,13 +1376,13 @@ var init_package = __esm(() => {
     url: "https://github.com/arman-jalili/guardian-framework/issues"
   };
   dependencies = {
-    "@clack/prompts": "^0.7.0",
+    "@clack/prompts": "^1.6.0",
     yaml: "^2.9.0"
   };
   devDependencies = {
     "@biomejs/biome": "^1.9.0",
     "@types/bun": "latest",
-    typescript: "^5.0.0"
+    typescript: "^6.0.3"
   };
   keywords = [
     "cli",
@@ -1383,7 +1393,8 @@ var init_package = __esm(() => {
     "pi-first",
     "token-optimized",
     "claude-code",
-    "github-copilot"
+    "github-copilot",
+    "pi-package"
   ];
   package_default = {
     name,
@@ -1397,6 +1408,8 @@ var init_package = __esm(() => {
     files,
     engines,
     scripts,
+    publishConfig,
+    pi,
     repository,
     homepage,
     bugs,
@@ -10916,9 +10929,9 @@ async function runInitPrompts() {
     message: "What is your project name?",
     placeholder: "my-project",
     validate: (value) => {
-      if (!value.trim())
+      if (!value?.trim())
         return "Project name is required";
-      if (value.includes(" "))
+      if (value?.includes(" "))
         return "Use dashes instead of spaces";
       return;
     }

package/dist/exports.js

@@ -977,6 +977,8 @@ __export(exports_package, {
   type: () => type,
   scripts: () => scripts,
   repository: () => repository,
+  publishConfig: () => publishConfig,
+  pi: () => pi,
   name: () => name,
   main: () => main,
   license: () => license,
@@ -993,7 +995,7 @@ __export(exports_package, {
   bin: () => bin,
   author: () => author
 });
-var name = "guardian-framework", version = "0.1.0", 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, 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.1", 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 = {
     ".": {
@@ -1004,7 +1006,7 @@ var init_package = __esm(() => {
   bin = {
     "guardian-framework": "./dist/cli.js"
   };
-  files = ["dist/", "templates/"];
+  files = ["dist/", "templates/", "pi-package/"];
   engines = {
     bun: ">=1.0.0"
   };
@@ -1018,6 +1020,14 @@ var init_package = __esm(() => {
     typecheck: "tsc --noEmit",
     dev: "bun run src/cli.ts"
   };
+  publishConfig = {
+    access: "public"
+  };
+  pi = {
+    extensions: ["./pi-package/extensions"],
+    skills: ["./pi-package/skills"],
+    prompts: ["./pi-package/prompts"]
+  };
   repository = {
     type: "git",
     url: "https://github.com/arman-jalili/guardian-framework"
@@ -1026,13 +1036,13 @@ var init_package = __esm(() => {
     url: "https://github.com/arman-jalili/guardian-framework/issues"
   };
   dependencies = {
-    "@clack/prompts": "^0.7.0",
+    "@clack/prompts": "^1.6.0",
     yaml: "^2.9.0"
   };
   devDependencies = {
     "@biomejs/biome": "^1.9.0",
     "@types/bun": "latest",
-    typescript: "^5.0.0"
+    typescript: "^6.0.3"
   };
   keywords = [
     "cli",
@@ -1043,7 +1053,8 @@ var init_package = __esm(() => {
     "pi-first",
     "token-optimized",
     "claude-code",
-    "github-copilot"
+    "github-copilot",
+    "pi-package"
   ];
   package_default = {
     name,
@@ -1057,6 +1068,8 @@ var init_package = __esm(() => {
     files,
     engines,
     scripts,
+    publishConfig,
+    pi,
     repository,
     homepage,
     bugs,
@@ -9679,9 +9692,9 @@ async function runInitPrompts() {
     message: "What is your project name?",
     placeholder: "my-project",
     validate: (value) => {
-      if (!value.trim())
+      if (!value?.trim())
         return "Project name is required";
-      if (value.includes(" "))
+      if (value?.includes(" "))
         return "Use dashes instead of spaces";
       return;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "guardian-framework",
-	"version": "0.1.0",
+	"version": "0.1.1",
 	"description": "Token-optimized agentic framework scaffolder with pi-first architecture",
 	"type": "module",
 	"main": "dist/exports.js",
@@ -14,7 +14,7 @@
 	"bin": {
 		"guardian-framework": "./dist/cli.js"
 	},
-	"files": ["dist/", "templates/"],
+	"files": ["dist/", "templates/", "pi-package/"],
 	"engines": {
 		"bun": ">=1.0.0"
 	},
@@ -28,6 +28,14 @@
 		"typecheck": "tsc --noEmit",
 		"dev": "bun run src/cli.ts"
 	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"pi": {
+		"extensions": ["./pi-package/extensions"],
+		"skills": ["./pi-package/skills"],
+		"prompts": ["./pi-package/prompts"]
+	},
 	"repository": {
 		"type": "git",
 		"url": "https://github.com/arman-jalili/guardian-framework"
@@ -37,13 +45,13 @@
 		"url": "https://github.com/arman-jalili/guardian-framework/issues"
 	},
 	"dependencies": {
-		"@clack/prompts": "^0.7.0",
+		"@clack/prompts": "^1.6.0",
 		"yaml": "^2.9.0"
 	},
 	"devDependencies": {
 		"@biomejs/biome": "^1.9.0",
 		"@types/bun": "latest",
-		"typescript": "^5.0.0"
+		"typescript": "^6.0.3"
 	},
 	"keywords": [
 		"cli",
@@ -54,7 +62,8 @@
 		"pi-first",
 		"token-optimized",
 		"claude-code",
-		"github-copilot"
+		"github-copilot",
+		"pi-package"
 	],
 	"author": "Arman Wolkensteiner-Jalili",
 	"license": "MIT"

package/pi-package/extensions/guardian-bootstrap.ts

@@ -0,0 +1,113 @@
+/**
+ * Guardian Framework — Pi Package Bootstrap
+ *
+ * Onboards users who install guardian-framework as a pi package.
+ * Checks if the project is scaffolded and guides them through setup.
+ */
+
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { execSync } from "node:child_process";
+
+const PI_DIR = ".pi";
+const PACKAGE_VERSION = "0.1.0";
+
+export default function (pi: any) {
+	pi.on("session_start", async (_event: any, ctx: any) => {
+		const piDir = join(ctx.cwd, PI_DIR);
+		const isScaffolded = existsSync(piDir);
+
+		if (!isScaffolded) {
+			ctx.ui.notify(
+				"Guardian Framework: project not scaffolded. Run `guardian-framework init` or use /guardian-init to get started.",
+				"info",
+			);
+		} else {
+			ctx.ui.notify(
+				`Guardian Framework v${PACKAGE_VERSION} loaded. ${isScaffolded ? "Project scaffolded." : ""}`,
+				"info",
+			);
+		}
+	});
+
+	pi.registerCommand("guardian-init", {
+		description:
+			"Scaffold Guardian framework (.pi/ + exports for AI tools)",
+		handler: async (_args: string, ctx: any) => {
+			const piDir = join(ctx.cwd, PI_DIR);
+			if (existsSync(piDir)) {
+				ctx.ui.notify("Guardian already scaffolded in this project.", "warn");
+				return;
+			}
+
+			ctx.ui.notify("Scaffolding Guardian framework...", "info");
+			try {
+				const result = execSync("npx guardian-framework init --nonInteractive --lang typescript", {
+					cwd: ctx.cwd,
+					encoding: "utf-8",
+					timeout: 60000,
+					stdio: ["pipe", "pipe", "pipe"],
+				});
+				ctx.ui.notify("Guardian scaffolded successfully!", "success");
+				return result.trim();
+			} catch (e: any) {
+				ctx.ui.notify(
+					`Scaffolding failed. Run 'npx guardian-framework init' manually.\nError: ${e.message?.slice(0, 200) || e}`,
+					"error",
+				);
+			}
+		},
+	});
+
+	pi.registerCommand("guardian-status", {
+		description:
+			"Check Guardian framework status — installed resources + scaffold state",
+		handler: async (_args: string, ctx: any) => {
+			const piDir = join(ctx.cwd, PI_DIR);
+			const isScaffolded = existsSync(piDir);
+
+			const lines = [
+				"## Guardian Framework Status",
+				"",
+				`Version: ${PACKAGE_VERSION}`,
+				`Project scaffolded: ${isScaffolded ? "Yes" : "No"}`,
+				"",
+			];
+
+			if (isScaffolded) {
+				lines.push("### Resources Available");
+				lines.push("");
+				lines.push("- 19 TypeScript extensions (via package + .pi/extensions/)");
+				lines.push("- 27 agent skill definitions");
+				lines.push("- 10 validator skill definitions");
+				lines.push("- 22 workflow prompt templates");
+				lines.push("- 50+ validation shell scripts");
+				lines.push("");
+				lines.push("### Commands");
+				lines.push("");
+				lines.push("- /architect --epic <name>   — Start epic from architecture");
+				lines.push("- /pipeline <name> --items=... --steps=...  — Multi-step workflow");
+				lines.push("- /goal <text>               — Persistent objective");
+				lines.push("- /kanban create|list|status — Task board");
+				lines.push("- /domain --explore <desc>   — DDD exploration");
+				lines.push("- /project create --lang ... — Source scaffolding");
+				lines.push("- /validate                  — Run validators");
+				lines.push("- /curator review            — Skill lifecycle");
+				lines.push("- /plan | /plan-apply        — Queue edits for review");
+				lines.push("- /snippet list|add|remove   — Token expansion");
+			} else {
+				lines.push("### Getting Started");
+				lines.push("");
+				lines.push("Run one of:");
+				lines.push("- `/guardian-init` — interactive scaffold");
+				lines.push("- `npx guardian-framework init` — interactive CLI");
+				lines.push("");
+				lines.push("Or for detailed docs:");
+				lines.push("- `npx guardian-framework --help`");
+				lines.push("- https://github.com/arman-jalili/guardian-framework");
+			}
+
+			return lines.join("\n");
+		},
+	});
+}

package/templates/pi/preflight_report.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2026-06-29T22:16:25Z",
+  "timestamp": "2026-07-01T06:22:13Z",
   "mode": "all",
   "stages_run": [],
   "summary": {