@preapexis/pi-kit 1.0.0

package/tests/extensions.test.ts

@@ -0,0 +1,49 @@
+import { describe, it, expect } from "vitest";
+import * as path from "path";
+import {
+  listFiles,
+  readFile,
+  checkTypeScriptSyntax,
+  hasDefaultExport
+} from "./helpers";
+
+describe("extensions", () => {
+  const extDir = path.resolve("extensions");
+
+  it("should have at least one extension file", async () => {
+    const files = await listFiles(extDir);
+    const tsFiles = files.filter((f) => f.endsWith(".ts"));
+    expect(tsFiles.length).toBeGreaterThan(0);
+  });
+
+  it("should export a default function", async () => {
+    const files = await listFiles(extDir);
+    const tsFiles = files.filter((f) => f.endsWith(".ts"));
+
+    for (const file of tsFiles) {
+      const source = await readFile(file);
+      expect(hasDefaultExport(source)).toBe(true);
+    }
+  });
+
+  it("should have no unexpected imports", async () => {
+    const files = await listFiles(extDir);
+    const tsFiles = files.filter((f) => f.endsWith(".ts"));
+
+    for (const file of tsFiles) {
+      const source = await readFile(file);
+      const result = checkTypeScriptSyntax(source, path.basename(file));
+      expect(result.errors).toEqual([]);
+    }
+  });
+
+  it("should not contain duplicate responsibilities (by name)", async () => {
+    const files = await listFiles(extDir);
+    const tsFiles = files.filter((f) => f.endsWith(".ts"));
+
+    // Each extension should have a unique, focused name
+    const names = tsFiles.map((f) => path.basename(f, ".ts"));
+    const uniqueNames = new Set(names);
+    expect(uniqueNames.size).toBe(names.length);
+  });
+});

package/tests/helpers.ts

@@ -0,0 +1,104 @@
+import * as fs from "fs/promises";
+import * as path from "path";
+import * as ts from "typescript";
+
+export async function readFile(filePath: string): Promise<string> {
+  return fs.readFile(filePath, "utf-8");
+}
+
+export async function listFiles(dir: string): Promise<string[]> {
+  const entries = await fs.readdir(dir, { withFileTypes: true });
+  const files: string[] = [];
+
+  for (const entry of entries) {
+    if (entry.isFile()) {
+      files.push(path.join(dir, entry.name));
+    }
+  }
+
+  return files;
+}
+
+export async function listDirectories(dir: string): Promise<string[]> {
+  const entries = await fs.readdir(dir, { withFileTypes: true });
+  return entries
+    .filter((e) => e.isDirectory())
+    .map((e) => path.join(dir, e.name));
+}
+
+export function checkTypeScriptSyntax(source: string, fileName: string): {
+  valid: boolean;
+  errors: string[];
+} {
+  const sourceFile = ts.createSourceFile(
+    fileName,
+    source,
+    ts.ScriptTarget.Latest,
+    true
+  );
+
+  const errors: string[] = [];
+
+  function visit(node: ts.Node) {
+    if (ts.isExpressionStatement(node)) {
+      const text = node.getText(sourceFile).trim();
+      if (text.startsWith("import ") || text.startsWith("export ")) {
+        // valid module statement
+      } else if (
+        text.includes("Unknown") ||
+        text.includes("undefined") // crude fallback
+      ) {
+        // ignore
+      }
+    }
+
+    if (ts.isImportDeclaration(node)) {
+      const moduleSpecifier = node.moduleSpecifier
+        .getText(sourceFile)
+        .replace(/['"]/g, "");
+
+      // Allow @earendil-works/pi-coding-agent and node built-ins
+      if (
+        moduleSpecifier.startsWith(".") ||
+        moduleSpecifier.startsWith("@earendil-works/pi-coding-agent") ||
+        moduleSpecifier.startsWith("node:") ||
+        ["fs", "fs/promises", "path", "url", "util"].includes(moduleSpecifier)
+      ) {
+        // ok
+      } else {
+        errors.push(`Unexpected import: ${moduleSpecifier}`);
+      }
+    }
+
+    ts.forEachChild(node, visit);
+  }
+
+  visit(sourceFile);
+
+  return {
+    valid: errors.length === 0,
+    errors
+  };
+}
+
+export function hasDefaultExport(source: string): boolean {
+  return /export\s+default\s+function\s*\(/.test(source);
+}
+
+export function parseFrontmatter(
+  content: string
+): { name: string; description: string } | null {
+  const match = content.match(/^---\s*\n([\s\S]*?)\n---\s*\n/);
+  if (!match) return null;
+
+  const frontmatter = match[1];
+  const nameMatch = frontmatter.match(/^name:\s*(.+)$/m);
+  const descMatch = frontmatter.match(/^description:\s*(.+)$/m);
+
+  if (!nameMatch || !descMatch) return null;
+
+  return {
+    name: nameMatch[1].trim(),
+    description: descMatch[1].trim()
+  };
+}

package/tests/package.test.ts

@@ -0,0 +1,38 @@
+import { describe, it, expect } from "vitest";
+import * as fs from "fs/promises";
+
+describe("package.json", () => {
+  it("should exist and be valid JSON", async () => {
+    const raw = await fs.readFile("package.json", "utf-8");
+    const pkg = JSON.parse(raw);
+    expect(pkg).toBeDefined();
+  });
+
+  it("should have required pi package fields", async () => {
+    const raw = await fs.readFile("package.json", "utf-8");
+    const pkg = JSON.parse(raw);
+
+    expect(pkg.name).toBe("@preapexis/pi-kit");
+    expect(pkg.pi).toBeDefined();
+    expect(Array.isArray(pkg.pi.extensions)).toBe(true);
+    expect(Array.isArray(pkg.pi.prompts)).toBe(true);
+    expect(Array.isArray(pkg.pi.skills)).toBe(true);
+    expect(Array.isArray(pkg.pi.themes)).toBe(true);
+  });
+
+  it("should declare peer dependency on pi-coding-agent", async () => {
+    const raw = await fs.readFile("package.json", "utf-8");
+    const pkg = JSON.parse(raw);
+
+    expect(pkg.peerDependencies).toBeDefined();
+    expect(pkg.peerDependencies["@earendil-works/pi-coding-agent"]).toBe("*");
+  });
+
+  it("should have test script configured", async () => {
+    const raw = await fs.readFile("package.json", "utf-8");
+    const pkg = JSON.parse(raw);
+
+    expect(pkg.scripts?.test).toBeDefined();
+    expect(pkg.scripts.test).toContain("vitest");
+  });
+});

package/tests/prompts.test.ts

@@ -0,0 +1,40 @@
+import { describe, it, expect } from "vitest";
+import * as path from "path";
+import { listFiles, readFile } from "./helpers";
+
+describe("prompts", () => {
+  const promptsDir = path.resolve("prompts");
+
+  it("should have at least one prompt file", async () => {
+    const files = await listFiles(promptsDir);
+    const mdFiles = files.filter((f) => f.endsWith(".md"));
+    expect(mdFiles.length).toBeGreaterThan(0);
+  });
+
+  it("should not include prompts.md (reserved for /prompts command)", async () => {
+    const files = await listFiles(promptsDir);
+    const names = files.map((f) => path.basename(f));
+    expect(names).not.toContain("prompts.md");
+  });
+
+  it("should be non-empty markdown files", async () => {
+    const files = await listFiles(promptsDir);
+    const mdFiles = files.filter((f) => f.endsWith(".md"));
+
+    for (const file of mdFiles) {
+      const content = await readFile(file);
+      expect(content.trim().length).toBeGreaterThan(0);
+    }
+  });
+
+  it("should have filenames that become valid slash commands", async () => {
+    const files = await listFiles(promptsDir);
+    const mdFiles = files.filter((f) => f.endsWith(".md"));
+
+    for (const file of mdFiles) {
+      const name = path.basename(file, ".md");
+      // Slash commands should be lowercase with hyphens
+      expect(name).toMatch(/^[a-z0-9-]+$/);
+    }
+  });
+});

package/tests/skills.test.ts

@@ -0,0 +1,42 @@
+import { describe, it, expect } from "vitest";
+import * as path from "path";
+import { listDirectories, readFile, parseFrontmatter } from "./helpers";
+
+describe("skills", () => {
+  const skillsDir = path.resolve("skills");
+
+  it("should have at least one skill folder", async () => {
+    const dirs = await listDirectories(skillsDir);
+    expect(dirs.length).toBeGreaterThan(0);
+  });
+
+  it("each skill folder should contain a SKILL.md", async () => {
+    const dirs = await listDirectories(skillsDir);
+
+    for (const dir of dirs) {
+      const skillFile = path.join(dir, "SKILL.md");
+      const content = await readFile(skillFile).catch(() => null);
+      expect(content).not.toBeNull();
+    }
+  });
+
+  it("each SKILL.md should have valid frontmatter with name and description", async () => {
+    const dirs = await listDirectories(skillsDir);
+
+    for (const dir of dirs) {
+      const skillFile = path.join(dir, "SKILL.md");
+      const content = await readFile(skillFile);
+      const frontmatter = parseFrontmatter(content);
+
+      expect(frontmatter).not.toBeNull();
+      expect(frontmatter!.name).toBeTruthy();
+      expect(frontmatter!.description).toBeTruthy();
+    }
+  });
+
+  it("should not have skill files directly inside skills/ (must be in subfolders)", async () => {
+    const entries = await listDirectories(skillsDir);
+    // listDirectories only returns directories, which is what we want
+    expect(entries.length).toBeGreaterThan(0);
+  });
+});

package/tests/themes.test.ts

@@ -0,0 +1,49 @@
+import { describe, it, expect } from "vitest";
+import * as path from "path";
+import { listFiles, readFile } from "./helpers";
+
+describe("themes", () => {
+  const themesDir = path.resolve("themes");
+
+  it("should have at least one theme file", async () => {
+    const files = await listFiles(themesDir);
+    const jsonFiles = files.filter((f) => f.endsWith(".json"));
+    expect(jsonFiles.length).toBeGreaterThan(0);
+  });
+
+  it("should be valid JSON", async () => {
+    const files = await listFiles(themesDir);
+    const jsonFiles = files.filter((f) => f.endsWith(".json"));
+
+    for (const file of jsonFiles) {
+      const content = await readFile(file);
+      expect(() => JSON.parse(content)).not.toThrow();
+    }
+  });
+
+  it("should have required theme fields", async () => {
+    const files = await listFiles(themesDir);
+    const jsonFiles = files.filter((f) => f.endsWith(".json"));
+
+    for (const file of jsonFiles) {
+      const content = await readFile(file);
+      const theme = JSON.parse(content);
+
+      expect(theme.name).toBeTruthy();
+      expect(theme.vars).toBeDefined();
+      expect(theme.colors).toBeDefined();
+    }
+  });
+
+  it("should reference the Pi theme schema", async () => {
+    const files = await listFiles(themesDir);
+    const jsonFiles = files.filter((f) => f.endsWith(".json"));
+
+    for (const file of jsonFiles) {
+      const content = await readFile(file);
+      const theme = JSON.parse(content);
+
+      expect(theme.$schema).toMatch(/theme-schema\.json$/);
+    }
+  });
+});

package/themes/latte-review.json

@@ -0,0 +1,77 @@
+{
+  "$schema": "https://raw.githubusercontent.com/earendil-works/pi/main/packages/coding-agent/src/modes/interactive/theme/theme-schema.json",
+  "name": "latte-review",
+  "vars": {
+    "bg": "#fafaf9",
+    "panel": "#f5f5f4",
+    "panel2": "#e7e5e4",
+    "muted": "#78716c",
+    "dim": "#a8a29e",
+    "blue": "#2563eb",
+    "cyan": "#0891b2",
+    "green": "#16a34a",
+    "red": "#dc2626",
+    "yellow": "#ca8a04",
+    "purple": "#7c3aed",
+    "orange": "#ea580c"
+  },
+  "colors": {
+    "accent": "blue",
+    "border": "panel2",
+    "borderAccent": "blue",
+    "borderMuted": "dim",
+    "success": "green",
+    "error": "red",
+    "warning": "yellow",
+    "muted": "muted",
+    "dim": "dim",
+    "text": "",
+    "thinkingText": "muted",
+
+    "selectedBg": "panel2",
+    "userMessageBg": "panel",
+    "userMessageText": "",
+    "customMessageBg": "#e0f2fe",
+    "customMessageText": "",
+    "customMessageLabel": "blue",
+    "toolPendingBg": "#eff6ff",
+    "toolSuccessBg": "#dcfce7",
+    "toolErrorBg": "#fee2e2",
+    "toolTitle": "blue",
+    "toolOutput": "",
+
+    "mdHeading": "purple",
+    "mdLink": "blue",
+    "mdLinkUrl": "muted",
+    "mdCode": "cyan",
+    "mdCodeBlock": "",
+    "mdCodeBlockBorder": "panel2",
+    "mdQuote": "muted",
+    "mdQuoteBorder": "dim",
+    "mdHr": "panel2",
+    "mdListBullet": "orange",
+
+    "toolDiffAdded": "green",
+    "toolDiffRemoved": "red",
+    "toolDiffContext": "muted",
+
+    "syntaxComment": "muted",
+    "syntaxKeyword": "purple",
+    "syntaxFunction": "blue",
+    "syntaxVariable": "orange",
+    "syntaxString": "green",
+    "syntaxNumber": "cyan",
+    "syntaxType": "blue",
+    "syntaxOperator": "purple",
+    "syntaxPunctuation": "muted",
+
+    "thinkingOff": "dim",
+    "thinkingMinimal": "blue",
+    "thinkingLow": "cyan",
+    "thinkingMedium": "yellow",
+    "thinkingHigh": "purple",
+    "thinkingXhigh": "red",
+
+    "bashMode": "orange"
+  }
+}

package/themes/neon-guardian.json

@@ -0,0 +1,77 @@
+{
+  "$schema": "https://raw.githubusercontent.com/earendil-works/pi/main/packages/coding-agent/src/modes/interactive/theme/theme-schema.json",
+  "name": "neon-guardian",
+  "vars": {
+    "bg": "#0b1020",
+    "panel": "#111827",
+    "panel2": "#172033",
+    "muted": 245,
+    "dim": 240,
+    "cyan": "#22d3ee",
+    "blue": "#38bdf8",
+    "green": "#22c55e",
+    "red": "#fb7185",
+    "yellow": "#facc15",
+    "purple": "#c084fc",
+    "pink": "#f472b6"
+  },
+  "colors": {
+    "accent": "cyan",
+    "border": "panel2",
+    "borderAccent": "cyan",
+    "borderMuted": "dim",
+    "success": "green",
+    "error": "red",
+    "warning": "yellow",
+    "muted": "muted",
+    "dim": "dim",
+    "text": "",
+    "thinkingText": "muted",
+
+    "selectedBg": "panel2",
+    "userMessageBg": "panel",
+    "userMessageText": "",
+    "customMessageBg": "#0e7490",
+    "customMessageText": "",
+    "customMessageLabel": "yellow",
+    "toolPendingBg": "#0f172a",
+    "toolSuccessBg": "#052e16",
+    "toolErrorBg": "#450a0a",
+    "toolTitle": "cyan",
+    "toolOutput": "",
+
+    "mdHeading": "purple",
+    "mdLink": "cyan",
+    "mdLinkUrl": "muted",
+    "mdCode": "pink",
+    "mdCodeBlock": "",
+    "mdCodeBlockBorder": "panel2",
+    "mdQuote": "muted",
+    "mdQuoteBorder": "cyan",
+    "mdHr": "panel2",
+    "mdListBullet": "cyan",
+
+    "toolDiffAdded": "green",
+    "toolDiffRemoved": "red",
+    "toolDiffContext": "muted",
+
+    "syntaxComment": "muted",
+    "syntaxKeyword": "purple",
+    "syntaxFunction": "blue",
+    "syntaxVariable": "yellow",
+    "syntaxString": "green",
+    "syntaxNumber": "pink",
+    "syntaxType": "cyan",
+    "syntaxOperator": "purple",
+    "syntaxPunctuation": "muted",
+
+    "thinkingOff": "dim",
+    "thinkingMinimal": "blue",
+    "thinkingLow": "cyan",
+    "thinkingMedium": "yellow",
+    "thinkingHigh": "purple",
+    "thinkingXhigh": "red",
+
+    "bashMode": "yellow"
+  }
+}

package/themes/safe-dark.json

@@ -0,0 +1,75 @@
+{
+  "$schema": "https://raw.githubusercontent.com/earendil-works/pi/main/packages/coding-agent/src/modes/interactive/theme/theme-schema.json",
+  "name": "safe-dark",
+  "vars": {
+    "bg": "#18181b",
+    "panel": "#27272a",
+    "soft": "#3f3f46",
+    "muted": 245,
+    "blue": "#38bdf8",
+    "green": "#22c55e",
+    "red": "#ef4444",
+    "yellow": "#facc15",
+    "purple": "#a78bfa",
+    "cyan": "#22d3ee"
+  },
+  "colors": {
+    "accent": "blue",
+    "border": "soft",
+    "borderAccent": "blue",
+    "borderMuted": "muted",
+    "success": "green",
+    "error": "red",
+    "warning": "yellow",
+    "muted": "muted",
+    "dim": 240,
+    "text": "",
+    "thinkingText": "muted",
+
+    "selectedBg": "panel",
+    "userMessageBg": "panel",
+    "userMessageText": "",
+    "customMessageBg": "panel",
+    "customMessageText": "",
+    "customMessageLabel": "blue",
+    "toolPendingBg": "#1e293b",
+    "toolSuccessBg": "#052e16",
+    "toolErrorBg": "#450a0a",
+    "toolTitle": "blue",
+    "toolOutput": "",
+
+    "mdHeading": "purple",
+    "mdLink": "blue",
+    "mdLinkUrl": "muted",
+    "mdCode": "cyan",
+    "mdCodeBlock": "",
+    "mdCodeBlockBorder": "soft",
+    "mdQuote": "muted",
+    "mdQuoteBorder": "soft",
+    "mdHr": "soft",
+    "mdListBullet": "cyan",
+
+    "toolDiffAdded": "green",
+    "toolDiffRemoved": "red",
+    "toolDiffContext": "muted",
+
+    "syntaxComment": "muted",
+    "syntaxKeyword": "purple",
+    "syntaxFunction": "blue",
+    "syntaxVariable": "yellow",
+    "syntaxString": "green",
+    "syntaxNumber": "cyan",
+    "syntaxType": "blue",
+    "syntaxOperator": "purple",
+    "syntaxPunctuation": "muted",
+
+    "thinkingOff": "muted",
+    "thinkingMinimal": "blue",
+    "thinkingLow": "cyan",
+    "thinkingMedium": "yellow",
+    "thinkingHigh": "purple",
+    "thinkingXhigh": "red",
+
+    "bashMode": "yellow"
+  }
+}

package/themes/tokyo-midnight.json

@@ -0,0 +1,77 @@
+{
+  "$schema": "https://raw.githubusercontent.com/earendil-works/pi/main/packages/coding-agent/src/modes/interactive/theme/theme-schema.json",
+  "name": "tokyo-midnight",
+  "vars": {
+    "bg": "#1a1b26",
+    "panel": "#24283b",
+    "panel2": "#292e42",
+    "muted": "#565f89",
+    "dim": 240,
+    "blue": "#7aa2f7",
+    "cyan": "#7dcfff",
+    "green": "#9ece6a",
+    "red": "#f7768e",
+    "yellow": "#e0af68",
+    "purple": "#bb9af7",
+    "orange": "#ff9e64"
+  },
+  "colors": {
+    "accent": "blue",
+    "border": "panel2",
+    "borderAccent": "blue",
+    "borderMuted": "muted",
+    "success": "green",
+    "error": "red",
+    "warning": "yellow",
+    "muted": "muted",
+    "dim": "dim",
+    "text": "",
+    "thinkingText": "muted",
+
+    "selectedBg": "panel2",
+    "userMessageBg": "panel",
+    "userMessageText": "",
+    "customMessageBg": "panel",
+    "customMessageText": "",
+    "customMessageLabel": "blue",
+    "toolPendingBg": "#202436",
+    "toolSuccessBg": "#1f3324",
+    "toolErrorBg": "#3b2028",
+    "toolTitle": "blue",
+    "toolOutput": "",
+
+    "mdHeading": "purple",
+    "mdLink": "blue",
+    "mdLinkUrl": "muted",
+    "mdCode": "cyan",
+    "mdCodeBlock": "",
+    "mdCodeBlockBorder": "muted",
+    "mdQuote": "muted",
+    "mdQuoteBorder": "panel2",
+    "mdHr": "panel2",
+    "mdListBullet": "orange",
+
+    "toolDiffAdded": "green",
+    "toolDiffRemoved": "red",
+    "toolDiffContext": "muted",
+
+    "syntaxComment": "muted",
+    "syntaxKeyword": "purple",
+    "syntaxFunction": "blue",
+    "syntaxVariable": "orange",
+    "syntaxString": "green",
+    "syntaxNumber": "yellow",
+    "syntaxType": "cyan",
+    "syntaxOperator": "purple",
+    "syntaxPunctuation": "muted",
+
+    "thinkingOff": "muted",
+    "thinkingMinimal": "blue",
+    "thinkingLow": "cyan",
+    "thinkingMedium": "yellow",
+    "thinkingHigh": "purple",
+    "thinkingXhigh": "red",
+
+    "bashMode": "orange"
+  }
+}

package/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "noEmit": true
+  },
+  "include": ["extensions/**/*.ts", "tests/**/*.ts", "vitest.config.ts"]
+}

package/vitest.config.ts

@@ -0,0 +1,8 @@
+import { defineConfig } from "vitest/config";
+
+export default defineConfig({
+  test: {
+    globals: true,
+    environment: "node"
+  }
+});