@powerhousedao/ph-clint-cli 0.1.0-dev.86 → 0.1.0-dev.87

package/dist/codegen/write.js

@@ -0,0 +1,32 @@
+/**
+ * Low-level file-writing helpers for the code generator.
+ */
+import fs from 'node:fs/promises';
+import path from 'node:path';
+export async function writeFileEnsuringDir(filePath, content) {
+    await fs.mkdir(path.dirname(filePath), { recursive: true });
+    await fs.writeFile(filePath, content, 'utf8');
+}
+function isEnoent(err) {
+    return (!!err &&
+        typeof err === 'object' &&
+        'code' in err &&
+        err.code === 'ENOENT');
+}
+/**
+ * Returns true if the directory doesn't exist or only contains ignorable
+ * entries (`.git`, `.DS_Store`, `.ph/ph-clint-cli/project-spec.json`).
+ */
+export async function isDirEmptyEnough(dir) {
+    let entries;
+    try {
+        entries = await fs.readdir(dir);
+    }
+    catch (err) {
+        if (isEnoent(err))
+            return true;
+        throw err;
+    }
+    const ignorable = new Set(['.git', '.DS_Store', '.ph']);
+    return entries.every((entry) => ignorable.has(entry));
+}

package/dist/commands/clint-project-init.d.ts

@@ -88,6 +88,8 @@ export declare const init: import("@powerhousedao/ph-clint").Command<z.ZodObject
                 proxyEnabled: boolean;
                 observabilityEnabled: boolean;
                 supportedResources: string[];
+                dockerfile?: string | undefined;
+                dockerTarget?: string | undefined;
             };
             scope?: string | undefined;
             documentId?: string | undefined;

package/dist/skills/sync.d.ts

@@ -0,0 +1,40 @@
+import type { ExternalSkill } from '../spec/types.js';
+/** On-disk manifest entry (what is currently installed). */
+export interface ManifestEntry {
+    name: string;
+    githubUrl: string;
+}
+/** Persisted manifest — a simple JSON array. */
+export type SkillsManifest = ManifestEntry[];
+export interface SyncResult {
+    added: string[];
+    removed: string[];
+    unchanged: string[];
+}
+export interface SyncOptions {
+    /** Project root (CLI sub-tree when split layout). */
+    targetDir: string;
+    /** Desired state from the spec. */
+    desired: ExternalSkill[];
+    /** Optional log callback. */
+    log?: (msg: string) => void;
+}
+export declare function readManifest(targetDir: string): Promise<SkillsManifest>;
+/**
+ * Compute the diff between desired (spec) and current (manifest) skills.
+ *
+ * Pure function — no I/O.
+ */
+export declare function diffSkills(desired: ExternalSkill[], current: SkillsManifest): {
+    toAdd: ExternalSkill[];
+    toRemove: ManifestEntry[];
+    unchanged: string[];
+};
+/**
+ * Synchronise external skills on disk to match the spec.
+ *
+ * - Clones missing skills via `git clone --depth 1`.
+ * - Removes skills no longer in the spec.
+ * - Updates the `.skills-manifest.json`.
+ */
+export declare function syncExternalSkills(opts: SyncOptions): Promise<SyncResult>;

package/dist/skills/sync.js

@@ -0,0 +1,119 @@
+/**
+ * External skills synchronisation.
+ *
+ * Reads the desired external skills from a `ClintProjectSpec`, diffs them
+ * against a `.skills-manifest.json` on disk, and runs `git clone` / `rm -rf`
+ * to reconcile.  Each external skill ends up as a subdirectory of
+ * `prompts/skills-ext/<name>/` so the build-skills pipeline picks it up.
+ */
+import { spawn } from 'node:child_process';
+import fs from 'node:fs/promises';
+import path from 'node:path';
+const MANIFEST_FILE = '.skills-manifest.json';
+const SKILLS_DIR = path.join('prompts', 'skills-ext');
+function manifestPath(targetDir) {
+    return path.join(targetDir, SKILLS_DIR, MANIFEST_FILE);
+}
+export async function readManifest(targetDir) {
+    try {
+        const raw = await fs.readFile(manifestPath(targetDir), 'utf8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return [];
+    }
+}
+async function writeManifest(targetDir, manifest) {
+    const file = manifestPath(targetDir);
+    await fs.mkdir(path.dirname(file), { recursive: true });
+    await fs.writeFile(file, JSON.stringify(manifest, null, 2) + '\n', 'utf8');
+}
+function execGit(args, cwd) {
+    return new Promise((resolve, reject) => {
+        const proc = spawn('git', args, { cwd, stdio: ['ignore', 'pipe', 'pipe'] });
+        let stderr = '';
+        if (proc.stderr) {
+            proc.stderr.on('data', (d) => {
+                stderr += d.toString();
+            });
+        }
+        proc.on('close', (code) => resolve({ code: code ?? 1, stderr }));
+        proc.on('error', (err) => reject(err));
+    });
+}
+/**
+ * Compute the diff between desired (spec) and current (manifest) skills.
+ *
+ * Pure function — no I/O.
+ */
+export function diffSkills(desired, current) {
+    const desiredMap = new Map(desired.map((s) => [s.name, s]));
+    const currentMap = new Map(current.map((s) => [s.name, s]));
+    const toAdd = [];
+    const toRemove = [];
+    const unchanged = [];
+    for (const [name, skill] of desiredMap) {
+        const existing = currentMap.get(name);
+        if (!existing) {
+            toAdd.push(skill);
+        }
+        else if (existing.githubUrl !== skill.githubUrl) {
+            // URL changed — remove old, add new.
+            toRemove.push(existing);
+            toAdd.push(skill);
+        }
+        else {
+            unchanged.push(name);
+        }
+    }
+    for (const [name, entry] of currentMap) {
+        if (!desiredMap.has(name)) {
+            toRemove.push(entry);
+        }
+    }
+    return { toAdd, toRemove, unchanged };
+}
+/**
+ * Synchronise external skills on disk to match the spec.
+ *
+ * - Clones missing skills via `git clone --depth 1`.
+ * - Removes skills no longer in the spec.
+ * - Updates the `.skills-manifest.json`.
+ */
+export async function syncExternalSkills(opts) {
+    const { targetDir, desired, log } = opts;
+    const skillsDir = path.join(targetDir, SKILLS_DIR);
+    await fs.mkdir(skillsDir, { recursive: true });
+    const current = await readManifest(targetDir);
+    const { toAdd, toRemove, unchanged } = diffSkills(desired, current);
+    const result = { added: [], removed: [], unchanged };
+    // Remove skills.
+    for (const entry of toRemove) {
+        const dir = path.join(skillsDir, entry.name);
+        log?.(`Removing skill "${entry.name}"…`);
+        await fs.rm(dir, { recursive: true, force: true });
+        result.removed.push(entry.name);
+    }
+    // Add skills.
+    for (const skill of toAdd) {
+        const dir = path.join(skillsDir, skill.name);
+        log?.(`Cloning skill "${skill.name}" from ${skill.githubUrl}…`);
+        // Ensure the target doesn't exist (re-add after URL change).
+        await fs.rm(dir, { recursive: true, force: true });
+        const { code, stderr } = await execGit(['clone', '--depth', '1', skill.githubUrl, skill.name], skillsDir);
+        if (code !== 0) {
+            log?.(`Warning: git clone failed for "${skill.name}": ${stderr.trim()}`);
+            continue;
+        }
+        // Remove .git dir — we don't want a nested repo.
+        await fs.rm(path.join(dir, '.git'), { recursive: true, force: true });
+        result.added.push(skill.name);
+    }
+    // Write updated manifest.
+    const newManifest = desired.map((s) => ({
+        name: s.name,
+        githubUrl: s.githubUrl,
+    }));
+    await writeManifest(targetDir, newManifest);
+    return result;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@powerhousedao/ph-clint-cli",
-  "version": "0.1.0-dev.86",
+  "version": "0.1.0-dev.87",
   "publishConfig": {
     "access": "public"
   },
@@ -12,21 +12,33 @@
   "files": [
     "dist"
   ],
+  "scripts": {
+    "build:skills": "tsx scripts/build-skills.ts",
+    "build": "pnpm build:skills && tsc",
+    "dev": "tsx src/main.ts",
+    "start": "node dist/main.js",
+    "test": "NODE_OPTIONS='--experimental-vm-modules' jest --detectOpenHandles --coverage",
+    "test:e2e": "NODE_OPTIONS='--experimental-vm-modules' jest --detectOpenHandles --testPathPatterns 'tests/(e2e|codegen-e2e)/' --testPathIgnorePatterns '/node_modules/'",
+    "lint": "eslint src",
+    "mastra:dev": "mastra dev",
+    "mastra:build": "mastra build",
+    "mastra:start": "mastra start"
+  },
   "dependencies": {
     "@electric-sql/pglite": "0.3.15",
-    "@mastra/core": "^1.41.0",
-    "@mastra/libsql": "^1.12.1",
-    "@mastra/memory": "^1.20.2",
+    "@mastra/core": "1.41.0",
+    "@mastra/libsql": "1.12.1",
+    "@mastra/memory": "1.20.2",
+    "@powerhousedao/ph-clint": "0.1.0-dev.87",
+    "@powerhousedao/ph-clint-app": "0.1.0-dev.87",
+    "@powerhousedao/ph-clint-dev": "0.1.0-dev.87",
     "@powerhousedao/reactor": "6.0.0-dev.257",
     "@powerhousedao/reactor-api": "6.0.0-dev.257",
     "@powerhousedao/shared": "6.0.0-dev.257",
     "document-model": "6.0.0-dev.257",
     "kysely": "^0.27.0",
     "kysely-pglite-dialect": "^1.3.0",
-    "zod": "4.3.6",
-    "@powerhousedao/ph-clint": "0.1.0-dev.86",
-    "@powerhousedao/ph-clint-dev": "0.1.0-dev.86",
-    "@powerhousedao/ph-clint-app": "0.1.0-dev.86"
+    "zod": "4.3.6"
   },
   "devDependencies": {
     "@jest/globals": "^30.2.0",
@@ -38,17 +50,5 @@
   },
   "engines": {
     "node": ">=22.13.0"
-  },
-  "scripts": {
-    "build:skills": "tsx scripts/build-skills.ts",
-    "build": "pnpm build:skills && tsc",
-    "dev": "tsx src/main.ts",
-    "start": "node dist/main.js",
-    "test": "NODE_OPTIONS='--experimental-vm-modules' jest --detectOpenHandles --coverage",
-    "test:e2e": "NODE_OPTIONS='--experimental-vm-modules' jest --detectOpenHandles --testPathPatterns 'tests/(e2e|codegen-e2e)/' --testPathIgnorePatterns '/node_modules/'",
-    "lint": "eslint src",
-    "mastra:dev": "mastra dev",
-    "mastra:build": "mastra build",
-    "mastra:start": "mastra start"
   }
-}
+}