@powerhousedao/ph-clint-cli 0.1.0-dev.52 → 0.1.0-dev.54

package/dist/codegen/builders/cli-package-json.js

@@ -1,128 +1 @@
-/**
- * Builds the CLI-side `package.json` (the ph-clint CLI itself).
- *
- * When `features.powerhouse.enabled`, this file lives at
- * `{root}/{name}-cli/package.json`. Otherwise at `{root}/package.json`.
- */
-import { getAppDirName, getAppPackageName, getBinName, getPackageName, phAtLeast, } from '../../spec/types.js';
-import { CLI_VERSION } from '../../config.js';
-import { getPhVersion } from '../scaffold.js';
-/**
- * Derive a semver range from the running ph-clint-cli version that respects
- * the dev / staging / production channel boundary. This is the version range
- * emitted into *scaffolded* projects' package.json for @powerhousedao/ph-clint
- * and @powerhousedao/ph-clint-dev dependencies.
- *
- * CLI_VERSION is the version of ph-clint-cli itself (read from its own
- * package.json at startup). Since all framework packages share a lockstep
- * version, this is also the correct base for the dependency range.
- *
- * Examples:
- *   "0.1.0"            → "^0.1.0"            (production — stable only)
- *   "0.1.0-staging.2"  → "^0.1.0-staging.0"  (staging + stable)
- *   "0.1.0-dev.4"      → "^0.1.0-dev.0"      (dev + staging + stable)
- *
- * This works because semver orders prereleases alphabetically:
- * dev.N < staging.N < release. A caret range starting at dev.0 naturally
- * upgrades through staging to production.
- */
-function phClintRange(version) {
-    const match = /^(\d+\.\d+\.\d+)(?:-([a-z]+)\.\d+)?/.exec(version);
-    if (!match)
-        return `^${version}`;
-    const base = match[1];
-    const channel = match[2]; // "dev", "staging", or undefined
-    // For prerelease channels, pin exact version. Caret ranges like ^0.1.0-dev.0
-    // resolve to `latest` dist-tag (0.1.0-dev.0) instead of the highest match,
-    // causing "export not found" errors when the scaffolding CLI is newer.
-    return channel ? version : `^${base}`;
-}
-/** Version range for @powerhousedao/ph-clint{,-dev} deps in scaffolded projects. */
-const PH_CLINT_VERSION = phClintRange(CLI_VERSION);
-const POWERHOUSE_VERSION_FALLBACK = '6.0.0-dev.170';
-let _powerhouseVersion;
-function getPowerhouseVersion() {
-    if (_powerhouseVersion === undefined) {
-        _powerhouseVersion = getPhVersion('ph') ?? POWERHOUSE_VERSION_FALLBACK;
-    }
-    return _powerhouseVersion;
-}
-export function buildCliPackageJson(spec) {
-    const { mastra, powerhouse } = spec.features;
-    const pkgName = getPackageName(spec);
-    const bin = getBinName(spec);
-    const dependencies = {
-        '@powerhousedao/ph-clint': PH_CLINT_VERSION,
-        zod: '^4.3.6',
-    };
-    if (mastra.enabled) {
-        dependencies['@mastra/core'] = '^1.22.0';
-        dependencies['@mastra/libsql'] = '^1.7.4';
-        dependencies['@mastra/mcp'] = '^1.4.1';
-        dependencies['@mastra/memory'] = '^1.13.1';
-    }
-    if (phAtLeast(powerhouse, 'Reactor')) {
-        const appPkg = getAppPackageName(spec);
-        const appDir = getAppDirName(spec);
-        dependencies[appPkg] = `file:../${appDir}`;
-        dependencies['@powerhousedao/reactor'] = getPowerhouseVersion();
-        dependencies['@powerhousedao/reactor-api'] = getPowerhouseVersion();
-        dependencies['@powerhousedao/shared'] = getPowerhouseVersion();
-        dependencies['document-model'] = getPowerhouseVersion();
-        // External reactor packages (non-app) as versioned dependencies.
-        // Compare bare names (without scope) so that a spec entry with
-        // packageName "foo-app" still matches the scoped "@scope/foo-app".
-        const appBare = appPkg.replace(/^@[^/]+\//, '');
-        for (const pkg of spec.packages) {
-            const pkgBare = pkg.packageName.replace(/^@[^/]+\//, '');
-            if (pkgBare === appBare)
-                continue;
-            dependencies[pkg.packageName] = 'latest';
-        }
-    }
-    const scripts = {
-        'build:skills': 'tsx scripts/build-skills.ts',
-        'build:manifest': 'build-manifest',
-        build: 'pnpm build:skills && tsc && pnpm build:manifest',
-        dev: 'tsx src/main.ts',
-        start: 'node dist/main.js',
-        test: "NODE_OPTIONS='--experimental-vm-modules' jest --detectOpenHandles",
-        lint: 'eslint src',
-    };
-    if (mastra.enabled) {
-        scripts['mastra:dev'] = 'mastra dev';
-        scripts['mastra:build'] = 'mastra build';
-        scripts['mastra:start'] = 'mastra start';
-    }
-    // Single-layout: publish scripts live in the CLI package.json (which IS the
-    // root). Split-layout gets these from root-package-json.ts instead.
-    if (!phAtLeast(powerhouse, 'Reactor')) {
-        scripts['publish:dev'] = 'ph-publish dev -c ./publish.config.js';
-        scripts['publish:staging'] = 'ph-publish staging -c ./publish.config.js';
-        scripts['publish:production'] = 'ph-publish production -c ./publish.config.js';
-    }
-    const pkg = {
-        name: pkgName,
-        version: spec.version,
-        publishConfig: { access: 'public' },
-        type: 'module',
-    };
-    if (spec.description)
-        pkg.description = spec.description;
-    pkg.bin = { [bin]: './dist/main.js' };
-    pkg.files = ['dist'];
-    pkg.scripts = scripts;
-    pkg.dependencies = dependencies;
-    pkg.devDependencies = {
-        '@jest/globals': '^30.2.0',
-        '@types/node': '^25.5.2',
-        jest: '^30.2.0',
-        '@powerhousedao/ph-clint-dev': PH_CLINT_VERSION,
-        'ts-jest': '^29.4.6',
-        tsx: '^4.19.0',
-        typescript: '^6.0.2',
-        'typescript-eslint': '^8.33.0',
-    };
-    pkg.engines = { node: '>=22.13.0' };
-    return JSON.stringify(pkg, null, 2) + '\n';
-}
+export { buildCliPackageJson } from '@powerhousedao/ph-clint-dev/codegen/builders';

package/dist/codegen/builders/index.d.ts

@@ -1,51 +1 @@
-/**
- * Registry of file builders. Each entry knows its own relative path (within
- * the CLI sub-tree) and a function that builds its content from the spec.
- *
- * Orchestrated by `codegen/index.ts` — it walks this registry, adjusts paths
- * for flat vs split layouts, and writes the files.
- */
-import { buildCliPackageJson } from './cli-package-json.js';
-import { buildCliTs } from './cli-ts.js';
-import { buildConfigTs } from './config-ts.js';
-import { buildMainTs } from './main-ts.js';
-import { buildTsconfigJson } from './tsconfig-json.js';
-import { buildJestConfigJs } from './jest-config-js.js';
-import { buildEslintConfigJs } from './eslint-config-js.js';
-import { buildGitignore } from './gitignore.js';
-import { buildMastraIndexTs } from './mastra-index-ts.js';
-import { buildBuildSkillsScript } from './build-skills-ts.js';
-import { buildAgentBaseMd } from './agent-base-md.js';
-import { buildAgentTs } from './agent-ts.js';
-import { buildDemoAgentTs } from './demo-agent-ts.js';
-import { buildFrameworkGenTs } from './framework-gen-ts.js';
-import { buildFrameworkTs } from './framework-ts.js';
-import { buildManifestJson } from './manifest-json.js';
-import { buildSmokeTestTs } from './smoke-test-ts.js';
-import { type ClintProjectSpec } from '../../spec/types.js';
-/**
- * A spec-driven file builder. Returns `null` from `build` to indicate the
- * file should not be emitted for the given spec.
- */
-export interface FileBuilder {
-    /** Path relative to the CLI root (flat or `{name}-cli/`). */
-    relativePath: string;
-    build(spec: ClintProjectSpec): string | null;
-    /**
-     * When true, this file is only emitted on `mode: 'create'`. In `update`
-     * mode the planner ignores the builder entirely, leaving any on-disk
-     * version untouched regardless of hash state. Used for files that carry
-     * user-owned hand edits (e.g. `src/framework.ts`'s `configSchema`).
-     */
-    initOnly?: boolean;
-}
-/**
- * Generate dynamic file builders for agent profile markdown files.
- * One file per profile in `prompts/agent-profiles/{id}.md`.
- */
-export declare function getProfileFileBuilders(spec: ClintProjectSpec): FileBuilder[];
-export declare const CLI_FILE_BUILDERS: FileBuilder[];
-export { buildCliPackageJson, buildCliTs, buildConfigTs, buildMainTs, buildTsconfigJson, buildJestConfigJs, buildEslintConfigJs, buildGitignore, buildMastraIndexTs, buildBuildSkillsScript, buildAgentBaseMd, buildAgentTs, buildDemoAgentTs, buildFrameworkGenTs, buildFrameworkTs, buildManifestJson, buildSmokeTestTs, };
-export { buildRootPackageJson } from './root-package-json.js';
-export { buildPublishConfigJs } from './publish-config-js.js';
-export { buildReadme } from './readme-md.js';
+export { type FileBuilder, CLI_FILE_BUILDERS, getProfileFileBuilders, buildCliPackageJson, buildCliTs, buildConfigTs, buildMainTs, buildTsconfigJson, buildJestConfigJs, buildEslintConfigJs, buildGitignore, buildMastraIndexTs, buildBuildSkillsScript, buildAgentBaseMd, buildAgentTs, buildDemoAgentTs, buildFrameworkGenTs, buildFrameworkTs, buildManifestJson, buildSmokeTestTs, buildRootPackageJson, buildPublishConfigJs, buildReadme, buildAppIndexTs, } from '@powerhousedao/ph-clint-dev/codegen/builders';

package/dist/codegen/builders/index.js

@@ -1,84 +1 @@
-/**
- * Registry of file builders. Each entry knows its own relative path (within
- * the CLI sub-tree) and a function that builds its content from the spec.
- *
- * Orchestrated by `codegen/index.ts` — it walks this registry, adjusts paths
- * for flat vs split layouts, and writes the files.
- */
-import { buildCliPackageJson } from './cli-package-json.js';
-import { buildCliTs } from './cli-ts.js';
-import { buildConfigTs } from './config-ts.js';
-import { buildMainTs } from './main-ts.js';
-import { buildTsconfigJson } from './tsconfig-json.js';
-import { buildJestConfigJs } from './jest-config-js.js';
-import { buildEslintConfigJs } from './eslint-config-js.js';
-import { buildGitignore } from './gitignore.js';
-import { buildMastraIndexTs } from './mastra-index-ts.js';
-import { buildBuildSkillsScript } from './build-skills-ts.js';
-import { buildAgentBaseMd } from './agent-base-md.js';
-import { buildAgentTs } from './agent-ts.js';
-import { buildDemoAgentTs } from './demo-agent-ts.js';
-import { buildFrameworkGenTs } from './framework-gen-ts.js';
-import { buildFrameworkTs } from './framework-ts.js';
-import { buildManifestJson } from './manifest-json.js';
-import { buildSmokeTestTs } from './smoke-test-ts.js';
-/**
- * Generate dynamic file builders for agent profile markdown files.
- * One file per profile in `prompts/agent-profiles/{id}.md`.
- */
-export function getProfileFileBuilders(spec) {
-    const { mastra } = spec.features;
-    if (!mastra.enabled || mastra.profiles.length === 0)
-        return [];
-    return mastra.profiles.map((profile) => ({
-        relativePath: `prompts/agent-profiles/${profile.id}.md`,
-        build: () => profile.content + '\n',
-    }));
-}
-export const CLI_FILE_BUILDERS = [
-    { relativePath: 'powerhouse.manifest.json', build: buildManifestJson },
-    { relativePath: 'package.json', build: buildCliPackageJson },
-    { relativePath: 'tsconfig.json', build: () => buildTsconfigJson() },
-    { relativePath: 'jest.config.js', build: () => buildJestConfigJs() },
-    { relativePath: 'eslint.config.js', build: () => buildEslintConfigJs() },
-    { relativePath: '.gitignore', build: () => buildGitignore() },
-    { relativePath: 'src/main.ts', build: () => buildMainTs() },
-    { relativePath: 'src/cli.ts', build: buildCliTs },
-    { relativePath: 'src/config.ts', build: buildConfigTs },
-    // User-owned outside markers; generated config/secrets inside markers.
-    { relativePath: 'src/framework.ts', build: buildFrameworkTs },
-    // Machine-owned; regenerated on every run. Null when no document types.
-    { relativePath: 'src/framework.gen.ts', build: buildFrameworkGenTs },
-    { relativePath: 'src/mastra/index.ts', build: buildMastraIndexTs },
-    { relativePath: 'scripts/build-skills.ts', build: () => buildBuildSkillsScript() },
-    {
-        relativePath: 'prompts/agent-profiles/AgentBase.md',
-        build: (spec) => (spec.features.mastra.profiles.length > 0 ? null : buildAgentBaseMd(spec)),
-    },
-    {
-        relativePath: 'src/agents/agent.ts',
-        build: (spec) => (spec.features.mastra.enabled ? buildAgentTs(spec) : null),
-    },
-    {
-        relativePath: 'src/agents/demo-agent.ts',
-        build: buildDemoAgentTs,
-    },
-    // Gitkeep placeholders so directories are tracked in git when otherwise empty.
-    { relativePath: 'src/commands/.gitkeep', build: () => '' },
-    { relativePath: 'src/services/.gitkeep', build: () => '' },
-    {
-        relativePath: 'src/triggers/.gitkeep',
-        build: (spec) => (spec.features.routine.enabled ? '' : ''),
-    },
-    {
-        relativePath: 'src/agents/.gitkeep',
-        build: (spec) => (spec.features.mastra.enabled ? null : ''),
-    },
-    { relativePath: 'prompts/skills-tpl/.gitkeep', build: () => '' },
-    { relativePath: 'prompts/skills-ext/.gitkeep', build: () => '' },
-    { relativePath: 'tests/smoke.test.ts', build: buildSmokeTestTs, initOnly: true },
-];
-export { buildCliPackageJson, buildCliTs, buildConfigTs, buildMainTs, buildTsconfigJson, buildJestConfigJs, buildEslintConfigJs, buildGitignore, buildMastraIndexTs, buildBuildSkillsScript, buildAgentBaseMd, buildAgentTs, buildDemoAgentTs, buildFrameworkGenTs, buildFrameworkTs, buildManifestJson, buildSmokeTestTs, };
-export { buildRootPackageJson } from './root-package-json.js';
-export { buildPublishConfigJs } from './publish-config-js.js';
-export { buildReadme } from './readme-md.js';
+export { CLI_FILE_BUILDERS, getProfileFileBuilders, buildCliPackageJson, buildCliTs, buildConfigTs, buildMainTs, buildTsconfigJson, buildJestConfigJs, buildEslintConfigJs, buildGitignore, buildMastraIndexTs, buildBuildSkillsScript, buildAgentBaseMd, buildAgentTs, buildDemoAgentTs, buildFrameworkGenTs, buildFrameworkTs, buildManifestJson, buildSmokeTestTs, buildRootPackageJson, buildPublishConfigJs, buildReadme, buildAppIndexTs, } from '@powerhousedao/ph-clint-dev/codegen/builders';

package/dist/codegen/exec.d.ts

@@ -1,2 +1 @@
-/** Returns true if `command` is on PATH. */
-export declare function hasCommandOnPath(command: string): Promise<boolean>;
+export { hasCommandOnPath, getPhVersion, } from '@powerhousedao/ph-clint-dev/codegen/exec';

package/dist/codegen/exec.js

@@ -1,14 +1 @@
-/**
- * Small helpers for invoking external commands during code generation.
- */
-import { spawn } from 'node:child_process';
-/** Returns true if `command` is on PATH. */
-export async function hasCommandOnPath(command) {
-    return new Promise((resolve) => {
-        const child = spawn(process.platform === 'win32' ? 'where' : 'which', [command], {
-            stdio: 'ignore',
-        });
-        child.once('error', () => resolve(false));
-        child.once('close', (code) => resolve(code === 0));
-    });
-}
+export { hasCommandOnPath, getPhVersion, } from '@powerhousedao/ph-clint-dev/codegen/exec';

package/dist/codegen/generated.d.ts

@@ -1,17 +1 @@
-import { type ClintProjectSpec } from '../spec/types.js';
-export interface GeneratedState {
-    name: string;
-    scope: string | undefined;
-    cliFolderName: string;
-    appFolderName: string;
-    /** True once `ph init` has run successfully in the app dir. */
-    appInitialized: boolean;
-}
-export declare function getGeneratedPath(targetDir: string): string;
-export declare function readGeneratedState(targetDir: string): Promise<GeneratedState | null>;
-export declare function writeGeneratedState(targetDir: string, state: GeneratedState): Promise<void>;
-/**
- * Derive a `GeneratedState` from a spec. The `appInitialized` flag must be
- * supplied by the caller (it depends on filesystem state, not the spec).
- */
-export declare function generatedStateFromSpec(spec: ClintProjectSpec, appInitialized: boolean): GeneratedState;
+export { type GeneratedState, getGeneratedPath, readGeneratedState, writeGeneratedState, generatedStateFromSpec, } from '@powerhousedao/ph-clint-dev/codegen/generated';

package/dist/codegen/generated.js

@@ -1,49 +1 @@
-/**
- * Tracks the derived state from the last successful code generation.
- *
- * Stored at `{targetDir}/.ph/ph-clint-cli/generated.json`. Used to detect
- * folder renames (name/scope changes) and re-apply patches that depend on
- * the project identity.
- */
-import fs from 'node:fs/promises';
-import path from 'node:path';
-import { getAppFolderName, getCliFolderName, } from '../spec/types.js';
-const GEN_DIR = path.join('.ph', 'ph-clint-cli');
-const GEN_FILE = 'generated.json';
-export function getGeneratedPath(targetDir) {
-    return path.join(targetDir, GEN_DIR, GEN_FILE);
-}
-export async function readGeneratedState(targetDir) {
-    try {
-        const raw = await fs.readFile(getGeneratedPath(targetDir), 'utf8');
-        return JSON.parse(raw);
-    }
-    catch (err) {
-        if (err &&
-            typeof err === 'object' &&
-            'code' in err &&
-            err.code === 'ENOENT') {
-            return null;
-        }
-        throw err;
-    }
-}
-export async function writeGeneratedState(targetDir, state) {
-    const file = getGeneratedPath(targetDir);
-    await fs.mkdir(path.dirname(file), { recursive: true });
-    await fs.writeFile(file, JSON.stringify(state, null, 2) + '\n', 'utf8');
-}
-/**
- * Derive a `GeneratedState` from a spec. The `appInitialized` flag must be
- * supplied by the caller (it depends on filesystem state, not the spec).
- */
-export function generatedStateFromSpec(spec, appInitialized) {
-    const split = spec.features.powerhouse !== 'Disabled';
-    return {
-        name: spec.name,
-        scope: spec.scope,
-        cliFolderName: split ? getCliFolderName(spec) : '',
-        appFolderName: split ? getAppFolderName(spec) : '',
-        appInitialized,
-    };
-}
+export { getGeneratedPath, readGeneratedState, writeGeneratedState, generatedStateFromSpec, } from '@powerhousedao/ph-clint-dev/codegen/generated';

package/dist/codegen/hashes.d.ts

@@ -1,6 +1 @@
-export type HashRecord = Record<string, string>;
-export declare function getHashesPath(targetDir: string): string;
-export declare function hashContent(content: string): string;
-export declare function hashFile(filePath: string): Promise<string | null>;
-export declare function readHashes(targetDir: string): Promise<HashRecord>;
-export declare function writeHashes(targetDir: string, hashes: HashRecord): Promise<void>;
+export { type HashRecord, getHashesPath, hashContent, hashFile, readHashes, writeHashes, } from '@powerhousedao/ph-clint-dev/codegen/hashes';

package/dist/codegen/hashes.js

@@ -1,60 +1 @@
-/**
- * Per-file content hashes written by the generator so subsequent runs can
- * detect whether a previously-generated file has been hand-edited.
- *
- * Stored at `{targetDir}/.ph/ph-clint-cli/.hashes.json` alongside the project
- * spec. Keys are paths relative to the project root.
- */
-import crypto from 'node:crypto';
-import fs from 'node:fs/promises';
-import path from 'node:path';
-const HASHES_DIR = path.join('.ph', 'ph-clint-cli');
-const HASHES_FILE = '.hashes.json';
-export function getHashesPath(targetDir) {
-    return path.join(targetDir, HASHES_DIR, HASHES_FILE);
-}
-export function hashContent(content) {
-    return crypto.createHash('sha256').update(content, 'utf8').digest('hex');
-}
-function isEnoent(err) {
-    return (!!err &&
-        typeof err === 'object' &&
-        'code' in err &&
-        err.code === 'ENOENT');
-}
-export async function hashFile(filePath) {
-    try {
-        const content = await fs.readFile(filePath, 'utf8');
-        return hashContent(content);
-    }
-    catch (err) {
-        if (isEnoent(err))
-            return null;
-        throw err;
-    }
-}
-export async function readHashes(targetDir) {
-    try {
-        const raw = await fs.readFile(getHashesPath(targetDir), 'utf8');
-        const parsed = JSON.parse(raw);
-        if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
-            return parsed;
-        }
-        return {};
-    }
-    catch (err) {
-        if (isEnoent(err))
-            return {};
-        throw err;
-    }
-}
-export async function writeHashes(targetDir, hashes) {
-    const file = getHashesPath(targetDir);
-    await fs.mkdir(path.dirname(file), { recursive: true });
-    // Sort keys for stable output across runs.
-    const sorted = {};
-    for (const key of Object.keys(hashes).sort()) {
-        sorted[key] = hashes[key];
-    }
-    await fs.writeFile(file, JSON.stringify(sorted, null, 2) + '\n', 'utf8');
-}
+export { getHashesPath, hashContent, hashFile, readHashes, writeHashes, } from '@powerhousedao/ph-clint-dev/codegen/hashes';

package/dist/codegen/index.d.ts

@@ -1,42 +1,11 @@
-import { type ClintProjectSpec } from '../spec/types.js';
-import { type PostGenAction } from './actions.js';
-export type GenerateMode = 'create' | 'update' | 'auto';
-export interface GenerateProjectOptions {
-    /** Absolute path to the project root. */
-    targetDir: string;
-    spec: ClintProjectSpec;
-    /** Defaults to `'auto'` — create if no persisted spec, else update. */
-    mode?: GenerateMode;
-    /** Create mode: allow writing into a non-empty directory. */
-    allowNonEmpty?: boolean;
-    /**
-     * Update mode: overwrite user-edited files (hash-mismatch) anyway.
-     * Also relaxes the git-dirty guard on flat → split migration.
-     */
-    force?: boolean;
-    /** Optional warning sink (diagnostics, not errors). */
-    onWarn?: (msg: string) => void;
-}
-export interface GeneratedFile {
-    absolutePath: string;
-    relativePath: string;
-}
-export interface GenerateProjectResult {
-    mode: 'create' | 'update';
-    /** Files newly written or rewritten. */
-    files: GeneratedFile[];
-    /** Files skipped because the user had edited them. */
-    skipped: GeneratedFile[];
-    /** Files removed because the new spec no longer emits them. */
-    deleted: GeneratedFile[];
-    /** True if a flat → split migration ran. */
-    migrated: boolean;
-    cliDir: string;
-    appDir: string | null;
-    /** Pending post-generation actions derived from what changed. */
-    pendingActions: PostGenAction[];
-}
 /**
- * Generate / reconcile a project at `targetDir` from the given spec.
+ * Re-exports from @powerhousedao/ph-clint-dev/codegen with CLI_VERSION default.
  */
+import { type GenerateProjectOptions as DevGenerateProjectOptions, type GenerateProjectResult, type GenerateMode, type GeneratedFile } from '@powerhousedao/ph-clint-dev/codegen';
+import type { CodegenContext } from '@powerhousedao/ph-clint-dev/codegen/types';
+export type { GenerateProjectResult, GenerateMode, GeneratedFile, CodegenContext };
+export interface GenerateProjectOptions extends Omit<DevGenerateProjectOptions, 'context'> {
+    /** Codegen context; defaults to CLI_VERSION when omitted. */
+    context?: CodegenContext;
+}
 export declare function generateProject(options: GenerateProjectOptions): Promise<GenerateProjectResult>;