@powerhousedao/ph-clint-cli 0.1.0-dev.1 → 0.1.0-dev.3

package/dist/cli.js

@@ -14,8 +14,11 @@ import { configSchema, secretsSchema } from './framework.js';
 // @clint:begin imports
 import { documentModels } from '@powerhousedao/ph-clint-app';
 import { createAgent } from './agents/clint-agent.js';
-import { init } from './commands/init.js';
-import { regen } from './commands/regen.js';
+import { init } from './commands/clint-project-init.js';
+import { regen } from './commands/clint-project-regen.js';
+import { build } from './commands/clint-project-build.js';
+import { clintProjectPublish } from './commands/clint-project-publish.js';
+import { clintProject } from './services/clint-project.js';
 import { specChangeTrigger } from './triggers/spec-change.js';
 // @clint:end imports
 // Connect (ph connect) must run inside the Reactor Package (ph-clint-app).
@@ -28,10 +31,10 @@ export const cli = defineCli({
     configSchema,
     secretsSchema,
     // @clint:begin commands
-    commands: [init, regen],
+    commands: [init, regen, build, clintProjectPublish],
     // @clint:end commands
     // @clint:begin services
-    services: [],
+    services: [clintProject],
     // @clint:end services
     // @clint:begin triggers
     triggers: [specChangeTrigger],

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

@@ -0,0 +1,7 @@
+import { z } from 'zod';
+export declare const build: import("@powerhousedao/ph-clint").Command<z.ZodObject<{
+    dir: z.ZodOptional<z.ZodString>;
+    verbose: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>, {
+    text: string;
+}, Record<string, unknown>>;

package/dist/commands/clint-project-build.js

@@ -0,0 +1,51 @@
+import path from 'node:path';
+import { spawn } from 'node:child_process';
+import { defineCommand } from '@powerhousedao/ph-clint';
+import { z } from 'zod';
+import { detectLayout } from '@powerhousedao/ph-clint-dev';
+const inputSchema = z.object({
+    dir: z.string().optional().describe('Project root directory (default: cwd)'),
+    verbose: z.boolean().default(false),
+});
+function execInDir(dir, cmd, verbose) {
+    return new Promise((resolve, reject) => {
+        const proc = spawn(cmd, {
+            cwd: dir,
+            shell: true,
+            stdio: verbose ? 'inherit' : 'pipe',
+        });
+        let stderr = '';
+        if (!verbose && proc.stderr) {
+            proc.stderr.on('data', (data) => {
+                stderr += data.toString();
+            });
+        }
+        proc.on('close', (code) => {
+            if (code === 0)
+                resolve();
+            else
+                reject(new Error(`Command "${cmd}" failed in ${dir} (exit ${code})${stderr ? `:\n${stderr}` : ''}`));
+        });
+        proc.on('error', (err) => reject(err));
+    });
+}
+export const build = defineCommand({
+    id: 'clint-project-build',
+    description: 'Build all packages in the project',
+    inputSchema,
+    execute: async (input, { workdir, stdout }) => {
+        const dir = path.resolve(input.dir ?? workdir);
+        const layout = detectLayout(dir);
+        if (layout?.type === 'split') {
+            stdout(`Building app package (${layout.app})...\n`);
+            await execInDir(layout.app, 'pnpm build', input.verbose);
+            stdout(`Building cli package (${layout.cli})...\n`);
+            await execInDir(layout.cli, 'pnpm build', input.verbose);
+        }
+        else {
+            stdout(`Building project...\n`);
+            await execInDir(layout?.cli ?? dir, 'pnpm build', input.verbose);
+        }
+        return { text: 'Build complete.' };
+    },
+});

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

@@ -0,0 +1,57 @@
+import { z } from 'zod';
+import { type ClintProjectSpec } from '../spec/types.js';
+declare const inputSchema: z.ZodObject<{
+    dir: z.ZodOptional<z.ZodString>;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    enablePowerhouse: z.ZodDefault<z.ZodBoolean>;
+    enableMastra: z.ZodDefault<z.ZodBoolean>;
+    enableRoutine: z.ZodDefault<z.ZodBoolean>;
+    force: z.ZodDefault<z.ZodBoolean>;
+    skipPhInit: z.ZodDefault<z.ZodBoolean>;
+    skipInstall: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+type InitInput = z.output<typeof inputSchema>;
+export declare function buildSpec(input: InitInput): ClintProjectSpec;
+export declare const init: import("@powerhousedao/ph-clint").Command<z.ZodObject<{
+    dir: z.ZodOptional<z.ZodString>;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    enablePowerhouse: z.ZodDefault<z.ZodBoolean>;
+    enableMastra: z.ZodDefault<z.ZodBoolean>;
+    enableRoutine: z.ZodDefault<z.ZodBoolean>;
+    force: z.ZodDefault<z.ZodBoolean>;
+    skipPhInit: z.ZodDefault<z.ZodBoolean>;
+    skipInstall: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>, {
+    text: string;
+    data?: undefined;
+} | {
+    text: string;
+    data: {
+        targetDir: string;
+        spec: {
+            name: string;
+            version: string;
+            description: string;
+            features: {
+                powerhouse: {
+                    enabled: boolean;
+                    switchboard: boolean;
+                    connect: boolean;
+                };
+                mastra: {
+                    enabled: boolean;
+                };
+                routine: {
+                    enabled: boolean;
+                };
+            };
+            documentTypes: string[];
+            scope?: string | undefined;
+            bin?: string | undefined;
+        };
+        fileCount: number;
+    };
+}, Record<string, unknown>>;
+export {};

package/dist/commands/clint-project-init.js

@@ -0,0 +1,168 @@
+/**
+ * `ph-clint init` — the project bootstrap wizard.
+ *
+ * Behavior:
+ *   1. Resolve target dir (positional `dir`, defaults to cwd).
+ *   2. Assert it is empty (or `--force`).
+ *   3. Collect project identity + feature toggles (prompt for missing).
+ *   4. Assemble a ClintProjectSpec and validate with Zod.
+ *   5. Write the spec + emit the generated tree via `generateProject`.
+ *   6. (Split layout) run `ph init` in `{name}-app/` unless `--skip-ph-init`.
+ *   7. Run `pnpm install` in generated sub-projects unless `--skip-install`.
+ *   8. Print next-steps guidance.
+ */
+import path from 'node:path';
+import { defineCommand } from '@powerhousedao/ph-clint';
+import { z } from 'zod';
+import { clintProjectSpecSchema, } from '../spec/types.js';
+import { generateProject } from '../codegen/index.js';
+import { isDirEmptyEnough } from '../codegen/write.js';
+import { runPhInit, runPnpmInstall } from '../codegen/scaffold.js';
+const inputSchema = z.object({
+    dir: z
+        .string()
+        .optional()
+        .describe('Target directory (defaults to the current directory)'),
+    name: z
+        .string()
+        .describe('Project name — bare, or `@scope/name`. Lowercase letters, digits, hyphens.'),
+    description: z.string().optional().describe('Short project description'),
+    enablePowerhouse: z
+        .boolean()
+        .default(false)
+        .describe('Enable Powerhouse reactor (requires split layout)'),
+    enableMastra: z
+        .boolean()
+        .default(false)
+        .describe('Enable Mastra AI agent stack'),
+    enableRoutine: z
+        .boolean()
+        .default(false)
+        .describe('Enable the tick-based routine loop'),
+    force: z
+        .boolean()
+        .default(false)
+        .describe('Overwrite files if the target directory is not empty'),
+    skipPhInit: z
+        .boolean()
+        .default(false)
+        .describe('Do not run `ph init` in the app folder after scaffolding'),
+    skipInstall: z
+        .boolean()
+        .default(false)
+        .describe('Do not run `pnpm install` after scaffolding'),
+});
+/** Parse `@scope/name` into { scope, name }. */
+function splitPackageName(raw) {
+    const match = /^@([a-z0-9][a-z0-9-]*)\/([a-z0-9][a-z0-9-]*)$/.exec(raw);
+    if (match)
+        return { scope: match[1], name: match[2] };
+    if (raw.startsWith('@')) {
+        throw new Error(`invalid package name "${raw}" — expected "@scope/name" with lowercase letters, digits, hyphens`);
+    }
+    if (!/^[a-z0-9][a-z0-9-]*$/.test(raw)) {
+        throw new Error(`invalid project name "${raw}" — expected lowercase letters, digits, hyphens`);
+    }
+    return { name: raw };
+}
+export function buildSpec(input) {
+    const { scope, name } = splitPackageName(input.name);
+    // Routine is forced on when Mastra is on — the REPL-only path works, but
+    // the agent routine loop is what most users actually want.
+    const routine = input.enableRoutine || input.enableMastra;
+    const candidate = {
+        name,
+        scope,
+        description: input.description ?? '',
+        features: {
+            powerhouse: { enabled: input.enablePowerhouse },
+            mastra: { enabled: input.enableMastra },
+            routine: { enabled: routine },
+        },
+    };
+    return clintProjectSpecSchema.parse(candidate);
+}
+export const init = defineCommand({
+    id: 'clint-project-init',
+    description: 'Initialize a new ph-clint project in the target directory',
+    inputSchema,
+    prompt: {
+        promptForDefaults: true,
+        promptOptional: ['description'],
+    },
+    execute: async (input, { workdir, stdout }) => {
+        const targetDir = path.resolve(workdir, input.dir ?? '.');
+        if (!input.force) {
+            const empty = await isDirEmptyEnough(targetDir);
+            if (!empty) {
+                return {
+                    text: `Error: ${targetDir} is not empty. Re-run with --force to initialize anyway,\n` +
+                        'or choose a different --dir.',
+                };
+            }
+        }
+        const spec = buildSpec(input);
+        const result = await generateProject({
+            targetDir,
+            spec,
+            mode: 'create',
+            allowNonEmpty: input.force,
+        });
+        stdout(`Generated ${result.files.length} files in ${targetDir}\n`);
+        const split = spec.features.powerhouse.enabled;
+        // Reactor package scaffolding (split layout only).
+        if (split && result.appDir && !input.skipPhInit) {
+            const phResult = await runPhInit({
+                targetDir,
+                appDir: result.appDir,
+                spec,
+                log: (msg) => stdout(msg + '\n'),
+            });
+            if (!phResult.ran) {
+                stdout(`Note: \`ph init\` did not run — ${phResult.reason ?? 'see above'}.\n`);
+            }
+        }
+        // Dependency installation.
+        if (!input.skipInstall) {
+            const dirs = [];
+            if (split) {
+                if (result.appDir)
+                    dirs.push(result.appDir);
+                dirs.push(result.cliDir);
+            }
+            else {
+                dirs.push(targetDir);
+            }
+            await runPnpmInstall({
+                dirs,
+                log: (msg) => stdout(msg + '\n'),
+            });
+        }
+        const next = [];
+        next.push('');
+        next.push('Next steps:');
+        const relDir = path.relative(workdir, targetDir) || '.';
+        if (split) {
+            next.push(`  cd ${relDir}`);
+            if (input.skipPhInit) {
+                next.push(`  cd ${spec.name}-app && ph init . && cd ..`);
+            }
+            if (input.skipInstall) {
+                next.push('  pnpm install');
+            }
+            next.push('  pnpm dev');
+        }
+        else {
+            next.push(`  cd ${relDir}`);
+            if (input.skipInstall)
+                next.push('  pnpm install');
+            next.push('  pnpm dev');
+        }
+        next.push('');
+        next.push('Edit the project spec and run `ph-clint regen` to regenerate.');
+        return {
+            text: next.join('\n'),
+            data: { targetDir, spec, fileCount: result.files.length },
+        };
+    },
+});

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

@@ -0,0 +1,15 @@
+import { z } from 'zod';
+export declare const clintProjectPublish: import("@powerhousedao/ph-clint").Command<z.ZodObject<{
+    tag: z.ZodEnum<{
+        dev: "dev";
+        staging: "staging";
+        production: "production";
+    }>;
+    dir: z.ZodOptional<z.ZodString>;
+    dryRun: z.ZodDefault<z.ZodBoolean>;
+    skipBuild: z.ZodDefault<z.ZodBoolean>;
+    verbose: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>, {
+    text: string;
+    data: import("@powerhousedao/ph-clint-dev/publish").PublishResult;
+}, Record<string, unknown>>;

package/dist/commands/clint-project-publish.js

@@ -0,0 +1,71 @@
+import path from 'node:path';
+import { defineCommand } from '@powerhousedao/ph-clint';
+import { z } from 'zod';
+import { resolvePublishPlan, buildPackages, publishPackages, } from '@powerhousedao/ph-clint-dev/publish';
+const inputSchema = z.object({
+    tag: z.enum(['dev', 'staging', 'production']).describe('Release channel'),
+    dir: z.string().optional().describe('Project root directory'),
+    dryRun: z.boolean().default(false).describe('Preview without publishing'),
+    skipBuild: z.boolean().default(false),
+    verbose: z.boolean().default(false),
+});
+function formatPlanPreview(plan) {
+    const lines = [];
+    const distTag = plan.tag === 'production' ? 'latest' : plan.tag;
+    lines.push(`Publish plan:`);
+    lines.push(`  Group:    ${plan.groupName}`);
+    lines.push(`  Version:  ${plan.version}`);
+    lines.push(`  Tag:      ${distTag}`);
+    lines.push(`  Registry: ${plan.registry}`);
+    lines.push(`  Packages:`);
+    for (const pkg of plan.packages) {
+        lines.push(`    - ${pkg.name}`);
+    }
+    return lines.join('\n');
+}
+export const clintProjectPublish = defineCommand({
+    id: 'clint-project-publish',
+    description: 'Publish project packages to npm',
+    inputSchema,
+    execute: async (input, { workdir, stdout }) => {
+        const dir = path.resolve(input.dir ?? workdir);
+        const logLines = [];
+        const log = (msg) => {
+            logLines.push(msg);
+            stdout(msg + '\n');
+        };
+        // 1. Resolve plan
+        const plan = await resolvePublishPlan({
+            tag: input.tag,
+            configPath: undefined, // auto-discover from dir
+            skipGitCheck: input.dryRun,
+            log,
+        });
+        // 2. Show preview
+        stdout(formatPlanPreview(plan) + '\n');
+        // 3. Build
+        if (!input.skipBuild) {
+            await buildPackages(plan, { verbose: input.verbose, log });
+        }
+        // 4. Publish (or dry-run)
+        const result = await publishPackages(plan, {
+            dryRun: input.dryRun,
+            verbose: input.verbose,
+            log,
+        });
+        if (result.success) {
+            return {
+                text: result.dryRun
+                    ? `Dry run complete — ${plan.packages.length} packages validated at ${result.version}.`
+                    : `Published ${result.published.length} packages at ${result.version}.`,
+                data: result,
+            };
+        }
+        else {
+            return {
+                text: `Publish failed. Published: ${result.published.length}, Failed: ${result.failed.length}.`,
+                data: result,
+            };
+        }
+    },
+});

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

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+export declare const regen: import("@powerhousedao/ph-clint").Command<z.ZodObject<{
+    dir: z.ZodOptional<z.ZodString>;
+    force: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>, {
+    text: string;
+    data?: undefined;
+} | {
+    text: string;
+    data: {
+        mode: "create" | "update";
+        files: string[];
+        skipped: string[];
+        deleted: string[];
+        migrated: boolean;
+        warnings: string[];
+    };
+}, Record<string, unknown>>;

package/dist/commands/clint-project-regen.js

@@ -0,0 +1,68 @@
+/**
+ * `ph-clint regen` — reconcile an existing project against its persisted
+ * spec. Equivalent to running the generator in update mode.
+ *
+ * Run inside a project directory (or pass `--dir`). If the spec has flipped
+ * `features.powerhouse.enabled` since the last run, the flat → split
+ * migration fires first.
+ */
+import path from 'node:path';
+import { defineCommand } from '@powerhousedao/ph-clint';
+import { z } from 'zod';
+import { readProjectSpec } from '../spec/file.js';
+import { generateProject } from '../codegen/index.js';
+const inputSchema = z.object({
+    dir: z
+        .string()
+        .optional()
+        .describe('Project directory (defaults to the current directory)'),
+    force: z
+        .boolean()
+        .default(false)
+        .describe('Overwrite user-edited managed files and bypass the git-dirty guard'),
+});
+export const regen = defineCommand({
+    id: 'clint-project-regen',
+    description: 'Regenerate project files from the persisted spec',
+    inputSchema,
+    execute: async (input, { workdir, stdout, log }) => {
+        const targetDir = path.resolve(workdir, input.dir ?? '.');
+        const spec = await readProjectSpec(targetDir);
+        if (!spec) {
+            return {
+                text: `Error: no spec found at ${targetDir}/.ph/ph-clint-cli/project-spec.json.\n` +
+                    'Run `ph-clint init` first to scaffold a new project.',
+            };
+        }
+        const warnings = [];
+        const result = await generateProject({
+            targetDir,
+            spec,
+            mode: 'update',
+            force: input.force,
+            onWarn: (m) => warnings.push(m),
+        });
+        const lines = [];
+        if (result.migrated)
+            lines.push('Migrated layout: flat → split.');
+        lines.push(`Wrote ${result.files.length} file(s); skipped ${result.skipped.length}; deleted ${result.deleted.length}.`);
+        for (const w of warnings) {
+            if (log)
+                log.warn(w);
+            else
+                stdout('warning: ' + w + '\n');
+        }
+        stdout(lines.join('\n') + '\n');
+        return {
+            text: lines.join('\n'),
+            data: {
+                mode: result.mode,
+                files: result.files.map((f) => f.relativePath),
+                skipped: result.skipped.map((f) => f.relativePath),
+                deleted: result.deleted.map((f) => f.relativePath),
+                migrated: result.migrated,
+                warnings,
+            },
+        };
+    },
+});

package/dist/services/clint-project.d.ts

@@ -0,0 +1 @@
+export declare const clintProject: import("@powerhousedao/ph-clint").ServiceDefinition<Record<string, unknown>>;

package/dist/services/clint-project.js

@@ -0,0 +1,47 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { defineService, checkWorkdir } from '@powerhousedao/ph-clint';
+export const clintProject = defineService({
+    id: 'clint-project',
+    name: 'Clint Project',
+    description: 'Development server for a ph-clint implementation project',
+    command: () => 'pnpm dev',
+    readiness: {
+        patterns: [{
+                name: 'cli-ready',
+                pattern: /Interactive mode started|ready/i,
+                captures: {},
+            }],
+        timeout: 30_000,
+    },
+    preflight: [
+        checkWorkdir((cwd) => {
+            const pkg = path.join(cwd, 'package.json');
+            if (!fs.existsSync(pkg))
+                return false;
+            try {
+                const json = JSON.parse(fs.readFileSync(pkg, 'utf8'));
+                return !!json.dependencies?.['@powerhousedao/ph-clint']
+                    || !!json.scripts?.dev;
+            }
+            catch {
+                return false;
+            }
+        }, 'Not a ph-clint project directory', 'Use --workdir to point to a ph-clint project root'),
+    ],
+    projectScanner: {
+        isProjectFolder: (p) => {
+            const pkg = path.join(p, 'package.json');
+            if (!fs.existsSync(pkg))
+                return false;
+            try {
+                const json = JSON.parse(fs.readFileSync(pkg, 'utf8'));
+                return !!json.dependencies?.['@powerhousedao/ph-clint'];
+            }
+            catch {
+                return false;
+            }
+        },
+    },
+    restart: { enabled: false, maxRetries: 0, delay: 0 },
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@powerhousedao/ph-clint-cli",
-  "version": "0.1.0-dev.1",
+  "version": "0.1.0-dev.3",
   "publishConfig": {
     "access": "public"
   },
@@ -22,12 +22,11 @@
     "lint": "eslint src",
     "mastra:dev": "mastra dev",
     "mastra:build": "mastra build",
-    "mastra:start": "mastra start",
-    "publish:npm": "pnpm build && pnpm publish --no-git-checks"
+    "mastra:start": "mastra start"
   },
   "dependencies": {
-    "@powerhousedao/ph-clint": "^0.1.0-dev.0",
-    "@powerhousedao/ph-clint-app": "^0.1.0-dev.1",
+    "@powerhousedao/ph-clint": "^0.1.0-dev.3",
+    "@powerhousedao/ph-clint-app": "^0.1.0-dev.3",
     "@mastra/core": "^1.22.0",
     "@mastra/libsql": "^1.7.4",
     "@mastra/memory": "^1.13.1",
@@ -49,7 +48,7 @@
     "@jest/globals": "^30.2.0",
     "@types/node": "^25.5.2",
     "jest": "^30.2.0",
-    "@powerhousedao/ph-clint-dev": "^0.1.0-dev.0",
+    "@powerhousedao/ph-clint-dev": "^0.1.0-dev.3",
     "ts-jest": "^29.4.6",
     "tsx": "^4.19.0",
     "typescript": "^6.0.2"