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

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

@@ -1,110 +0,0 @@
-export function buildCliTs(spec) {
-    const { mastra, routine, powerhouse } = spec.features;
-    const lines = [];
-    lines.push('/**');
-    lines.push(' * CLI definition.');
-    lines.push(' *');
-    lines.push(' * Generated by ph-clint. Regions bracketed by @clint:begin/@clint:end');
-    lines.push(' * markers are rewritten by ph-clint when the project spec changes.');
-    lines.push(' * Everything outside the markers is user-editable and preserved.');
-    lines.push(' */');
-    if (powerhouse.enabled) {
-        lines.push(`import path from 'node:path';`);
-        lines.push(`import { fileURLToPath } from 'node:url';`);
-        lines.push(`import { defineCli, buildDefaultReactor } from '@powerhousedao/ph-clint';`);
-    }
-    else {
-        lines.push(`import { defineCli } from '@powerhousedao/ph-clint';`);
-    }
-    lines.push(`import { CLI_NAME, CLI_VERSION } from './config.js';`);
-    lines.push(`import { configSchema, secretsSchema } from './framework.js';`);
-    lines.push('');
-    lines.push('// @clint:begin imports');
-    if (powerhouse.enabled) {
-        lines.push(`import { documentModels } from '${spec.name}-app';`);
-    }
-    if (mastra.enabled) {
-        lines.push(`import { createAgent } from './agents/agent.js';`);
-    }
-    lines.push('// @clint:end imports');
-    lines.push('');
-    if (powerhouse.enabled) {
-        lines.push(`const __dirname = path.dirname(fileURLToPath(import.meta.url));`);
-        lines.push(`const appDir = path.resolve(__dirname, '../../${spec.name}-app');`);
-        lines.push('');
-    }
-    lines.push('export const cli = defineCli({');
-    lines.push('  name: CLI_NAME,');
-    lines.push('  version: CLI_VERSION,');
-    lines.push('  description: `${CLI_NAME} v${CLI_VERSION}`,');
-    lines.push('  configSchema,');
-    lines.push('  secretsSchema,');
-    lines.push('');
-    lines.push('  // @clint:begin commands');
-    lines.push('  commands: [],');
-    lines.push('  // @clint:end commands');
-    lines.push('');
-    lines.push('  // @clint:begin services');
-    lines.push('  services: [],');
-    lines.push('  // @clint:end services');
-    lines.push('');
-    lines.push('  // @clint:begin triggers');
-    if (routine.enabled) {
-        lines.push('  triggers: [],');
-    }
-    else {
-        lines.push('  triggers: [],');
-    }
-    lines.push('  // @clint:end triggers');
-    lines.push('');
-    lines.push('  // @clint:begin prompts');
-    lines.push('  prompts: {');
-    lines.push('    sources: [],');
-    lines.push('    agents: {},');
-    lines.push('    skills: {},');
-    lines.push('  },');
-    lines.push('  // @clint:end prompts');
-    lines.push('');
-    lines.push('  // @clint:begin events');
-    lines.push('  events: {},');
-    lines.push('  // @clint:end events');
-    lines.push('');
-    lines.push('  // @clint:begin interactive');
-    lines.push('  interactive: {');
-    lines.push(`    welcome: ({ workdir }) =>`);
-    lines.push('      [');
-    lines.push('        `${CLI_NAME} v${CLI_VERSION}`,');
-    lines.push('        `Workdir: ${workdir}`,');
-    lines.push("        '',");
-    if (mastra.enabled) {
-        lines.push("        'Type a message to talk to the agent, or /help for commands.',");
-    }
-    else {
-        lines.push("        'Type /help for commands.',");
-    }
-    lines.push("      ].join('\\n'),");
-    lines.push('  },');
-    lines.push('  // @clint:end interactive');
-    lines.push('});');
-    lines.push('');
-    lines.push('// @clint:begin reactor');
-    if (powerhouse.enabled) {
-        lines.push('cli.configureReactor({');
-        lines.push('  create: (ctx) =>');
-        lines.push('    buildDefaultReactor(ctx, {');
-        lines.push('      documentModels,');
-        lines.push(`      drive: { name: '${spec.name}' },`);
-        lines.push('    }),');
-        lines.push(`  switchboard: { enabled: ${String(powerhouse.switchboard)} },`);
-        lines.push(`  connect: { enabled: ${String(powerhouse.connect)}, workdir: appDir },`);
-        lines.push('});');
-    }
-    lines.push('// @clint:end reactor');
-    lines.push('');
-    lines.push('// @clint:begin mastra');
-    if (mastra.enabled) {
-        lines.push('cli.configureAgent(createAgent);');
-    }
-    lines.push('// @clint:end mastra');
-    return lines.join('\n') + '\n';
-}

package/dist/codegen/builders/config-ts.d.ts

@@ -1,8 +0,0 @@
-/**
- * Builds `src/config.ts` — CLI identity constants (name, version, project
- * root path). The Zod `configSchema` / `secretsSchema` are emitted by
- * `buildFrameworkTs` into `src/framework.ts` (user-owned, init-only) so users
- * can extend them without fighting the generator.
- */
-import { type ClintProjectSpec } from '../../spec/types.js';
-export declare function buildConfigTs(spec: ClintProjectSpec): string;

package/dist/codegen/builders/config-ts.js

@@ -1,21 +0,0 @@
-/**
- * Builds `src/config.ts` — CLI identity constants (name, version, project
- * root path). The Zod `configSchema` / `secretsSchema` are emitted by
- * `buildFrameworkTs` into `src/framework.ts` (user-owned, init-only) so users
- * can extend them without fighting the generator.
- */
-import { getBinName, } from '../../spec/types.js';
-export function buildConfigTs(spec) {
-    const cliName = getBinName(spec);
-    const lines = [];
-    lines.push(`import path from 'node:path';`);
-    lines.push(`import { fileURLToPath } from 'node:url';`);
-    lines.push('');
-    lines.push('/** CLI name — used for config resolution, env var prefixing, and .ph/ paths. */');
-    lines.push(`export const CLI_NAME = '${cliName}';`);
-    lines.push(`export const CLI_VERSION = '${spec.version}';`);
-    lines.push('');
-    lines.push('/** Project root — resolved from this file location. */');
-    lines.push('export const PROJECT_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), \'..\');');
-    return lines.join('\n') + '\n';
-}

package/dist/codegen/builders/eslint-config-js.d.ts

@@ -1,4 +0,0 @@
-/**
- * Builds `eslint.config.js` for the CLI — placeholder flat config.
- */
-export declare function buildEslintConfigJs(): string;

package/dist/codegen/builders/eslint-config-js.js

@@ -1,13 +0,0 @@
-/**
- * Builds `eslint.config.js` for the CLI — placeholder flat config.
- */
-export function buildEslintConfigJs() {
-    return [
-        '// @clint:begin eslint',
-        '// Placeholder ESLint flat config — replaced by codegen when the',
-        "// project's lint stack is configured.",
-        'export default [];',
-        '// @clint:end eslint',
-        '',
-    ].join('\n');
-}

package/dist/codegen/builders/framework-gen-ts.d.ts

@@ -1,20 +0,0 @@
-/**
- * Builds `src/framework.gen.ts` — the fully machine-owned half of the
- * typed-binding split. Regenerated on every `init` and `update`; holds the
- * `defineRegistry([...] as const)` call that describes which document models
- * are bound into `framework.ts`'s typed factories.
- *
- * Kept deliberately small: this file exports only `registry` and the
- * `Registry` type. The `createTypes` call lives in `framework.ts` (the
- * user-owned half) so `configSchema` edits stay local and we avoid an import
- * cycle between the two files.
- *
- * Emitted only when Powerhouse is enabled — flat-layout impls have no
- * reactor package to import modules from and bind `createTypes` directly in
- * `framework.ts`. When Powerhouse is on but no `documentTypes` are declared,
- * we still emit this file with an empty `defineRegistry([])` so impl code's
- * `import { registry } from './framework.gen.js'` keeps resolving across
- * regens.
- */
-import { type ClintProjectSpec } from '../../spec/types.js';
-export declare function buildFrameworkGenTs(spec: ClintProjectSpec): string | null;

package/dist/codegen/builders/framework-gen-ts.js

@@ -1,62 +0,0 @@
-/**
- * Builds `src/framework.gen.ts` — the fully machine-owned half of the
- * typed-binding split. Regenerated on every `init` and `update`; holds the
- * `defineRegistry([...] as const)` call that describes which document models
- * are bound into `framework.ts`'s typed factories.
- *
- * Kept deliberately small: this file exports only `registry` and the
- * `Registry` type. The `createTypes` call lives in `framework.ts` (the
- * user-owned half) so `configSchema` edits stay local and we avoid an import
- * cycle between the two files.
- *
- * Emitted only when Powerhouse is enabled — flat-layout impls have no
- * reactor package to import modules from and bind `createTypes` directly in
- * `framework.ts`. When Powerhouse is on but no `documentTypes` are declared,
- * we still emit this file with an empty `defineRegistry([])` so impl code's
- * `import { registry } from './framework.gen.js'` keeps resolving across
- * regens.
- */
-import { getDocumentTypeModuleName, } from '../../spec/types.js';
-/** Local package name of the reactor package for this project. */
-function appPackageName(spec) {
-    return `${spec.name}-app`;
-}
-export function buildFrameworkGenTs(spec) {
-    if (!spec.features.powerhouse.enabled)
-        return null;
-    const pkg = appPackageName(spec);
-    const entries = spec.documentTypes.map((docType) => ({
-        docType,
-        name: getDocumentTypeModuleName(docType),
-    }));
-    const lines = [];
-    lines.push('/**');
-    lines.push(' * THIS FILE IS GENERATED BY ph-clint-cli. DO NOT EDIT.');
-    lines.push(' *');
-    lines.push(' * Regenerated on every `ph-clint regen` and on every spec-change');
-    lines.push(' * tick. Put custom bindings in `framework.ts`, not here — edits to');
-    lines.push(' * this file will be overwritten.');
-    lines.push(' */');
-    lines.push(`import { defineRegistry } from '@powerhousedao/ph-clint';`);
-    for (const e of entries) {
-        lines.push(`import { ${e.name} } from '${pkg}';`);
-    }
-    lines.push('');
-    lines.push('/**');
-    lines.push(' * Typed document registry derived from the reactor package\'s document models.');
-    lines.push(' * Regenerated whenever the spec\'s `documentTypes` list changes.');
-    lines.push(' */');
-    if (entries.length === 0) {
-        lines.push('export const registry = defineRegistry([] as const);');
-    }
-    else {
-        lines.push('export const registry = defineRegistry([');
-        for (const e of entries) {
-            lines.push(`  ${e.name},`);
-        }
-        lines.push('] as const);');
-    }
-    lines.push('');
-    lines.push('export type Registry = typeof registry;');
-    return lines.join('\n') + '\n';
-}

package/dist/codegen/builders/framework-ts.d.ts

@@ -1,21 +0,0 @@
-/**
- * Builds `src/framework.ts` — the user-owned half of the typed-binding split.
- *
- * Emitted **only on create**. Once the file exists, codegen never overwrites
- * it: users are expected to extend `configSchema` and `secretsSchema` here,
- * and those edits must survive regens.
- *
- * Behavior differs by layout:
- *
- * - **Powerhouse enabled** — this file declares `configSchema`/`secretsSchema`
- *   and re-exports `registry`, `defineCommand`, `defineTrigger`,
- *   `defineService`, and `createDocumentChangeTrigger` from the companion
- *   `framework.gen.ts`. Adding a document type to the spec regenerates
- *   `framework.gen.ts`; this file keeps resolving its re-exports unchanged.
- *
- * - **Powerhouse disabled** — no reactor package exists to register modules
- *   against, so this file binds `createTypes({ configSchema })` directly and
- *   exports the typed factories from here. No `framework.gen.ts` is emitted.
- */
-import { type ClintProjectSpec } from '../../spec/types.js';
-export declare function buildFrameworkTs(spec: ClintProjectSpec): string;

package/dist/codegen/builders/framework-ts.js

@@ -1,74 +0,0 @@
-export function buildFrameworkTs(spec) {
-    const { mastra, powerhouse } = spec.features;
-    const hasGen = powerhouse.enabled;
-    const lines = [];
-    lines.push('/**');
-    lines.push(' * Per-CLI typed framework binding.');
-    lines.push(' *');
-    lines.push(' * This file is USER-OWNED. ph-clint-cli emits it once at project');
-    lines.push(' * creation and never overwrites it afterwards — edit `configSchema`');
-    lines.push(' * and `secretsSchema` freely.');
-    if (hasGen) {
-        lines.push(' *');
-        lines.push(' * Typed factories (`defineCommand`, `defineTrigger`, ...) and the');
-        lines.push(' * document `registry` come from `framework.gen.ts`, which IS');
-        lines.push(' * regenerated whenever the spec\'s `documentTypes` list changes.');
-    }
-    lines.push(' */');
-    lines.push(`import { z } from 'zod';`);
-    lines.push(`import { createTypes } from '@powerhousedao/ph-clint';`);
-    if (hasGen) {
-        lines.push(`import { registry } from './framework.gen.js';`);
-    }
-    lines.push('');
-    lines.push('export const configSchema = z.object({');
-    if (mastra.enabled) {
-        lines.push("  model: z.string().default('anthropic/claude-haiku-4-5').describe('LLM model to use'),");
-    }
-    // Ports are derived from CLI name by resolveReactorDefaults() — no config fields needed.
-    // Override via switchboard.port / connect.port in configureReactor() if required.
-    lines.push('  // Add your own config fields here — this file survives regens.');
-    lines.push('});');
-    lines.push('');
-    lines.push('export const secretsSchema = z.object({');
-    if (mastra.enabled) {
-        lines.push("  apiKey: z.string().optional().describe('LLM API key'),");
-    }
-    lines.push('});');
-    lines.push('');
-    lines.push('export type Config = z.infer<typeof configSchema> &');
-    lines.push('  z.infer<typeof secretsSchema>;');
-    lines.push('');
-    lines.push('const fullConfigSchema = configSchema.merge(secretsSchema);');
-    lines.push('');
-    if (hasGen) {
-        lines.push('export const {');
-        lines.push('  defineCommand,');
-        lines.push('  defineTrigger,');
-        lines.push('  defineService,');
-        lines.push('  createDocumentChangeTrigger,');
-        lines.push('} = createTypes({');
-        lines.push('  configSchema: fullConfigSchema,');
-        lines.push('  registry,');
-        lines.push('});');
-        lines.push('');
-        lines.push(`export { registry } from './framework.gen.js';`);
-        lines.push(`export type { Registry } from './framework.gen.js';`);
-    }
-    else {
-        lines.push('/**');
-        lines.push(' * No reactor package — bind `createTypes` directly so');
-        lines.push(' * `defineCommand` / `defineTrigger` / `defineService` still pick up');
-        lines.push(' * the typed config. Enable `features.powerhouse` in the project spec');
-        lines.push(' * and codegen will switch these exports to a registry-backed');
-        lines.push(' * `framework.gen.ts`.');
-        lines.push(' */');
-        lines.push('export const {');
-        lines.push('  defineCommand,');
-        lines.push('  defineTrigger,');
-        lines.push('  defineService,');
-        lines.push('  createDocumentChangeTrigger,');
-        lines.push('} = createTypes({ configSchema: fullConfigSchema });');
-    }
-    return lines.join('\n') + '\n';
-}

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

@@ -1,4 +0,0 @@
-/**
- * Builds `.gitignore` for the CLI.
- */
-export declare function buildGitignore(): string;

package/dist/codegen/builders/gitignore.js

@@ -1,18 +0,0 @@
-/**
- * Builds `.gitignore` for the CLI.
- */
-export function buildGitignore() {
-    return [
-        'node_modules/',
-        'dist/',
-        'gen/',
-        '.mastra/',
-        '.ph/',
-        'coverage/',
-        '*.tsbuildinfo',
-        '*.db',
-        '*.db-shm',
-        '*.db-wal',
-        '',
-    ].join('\n');
-}

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

@@ -1,43 +0,0 @@
-/**
- * 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 { buildFrameworkGenTs } from './framework-gen-ts.js';
-import { buildFrameworkTs } from './framework-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;
-}
-export declare const CLI_FILE_BUILDERS: FileBuilder[];
-export { buildCliPackageJson, buildCliTs, buildConfigTs, buildMainTs, buildTsconfigJson, buildJestConfigJs, buildEslintConfigJs, buildGitignore, buildMastraIndexTs, buildBuildSkillsScript, buildAgentBaseMd, buildAgentTs, buildFrameworkGenTs, buildFrameworkTs, };
-export { buildRootPackageJson } from './root-package-json.js';
-export { buildReadme } from './readme-md.js';
-export { buildAppIndexTs } from './app-index-ts.js';

package/dist/codegen/builders/index.js

@@ -1,60 +0,0 @@
-/**
- * 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 { buildFrameworkGenTs } from './framework-gen-ts.js';
-import { buildFrameworkTs } from './framework-ts.js';
-export const CLI_FILE_BUILDERS = [
-    { 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; init-only. Holds `configSchema` + `secretsSchema` edits.
-    { relativePath: 'src/framework.ts', build: buildFrameworkTs, initOnly: true },
-    // 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: buildAgentBaseMd },
-    {
-        relativePath: 'src/agents/agent.ts',
-        build: (spec) => (spec.features.mastra.enabled ? buildAgentTs(spec) : null),
-    },
-    // 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/.gitkeep', build: () => '' },
-];
-export { buildCliPackageJson, buildCliTs, buildConfigTs, buildMainTs, buildTsconfigJson, buildJestConfigJs, buildEslintConfigJs, buildGitignore, buildMastraIndexTs, buildBuildSkillsScript, buildAgentBaseMd, buildAgentTs, buildFrameworkGenTs, buildFrameworkTs, };
-export { buildRootPackageJson } from './root-package-json.js';
-export { buildReadme } from './readme-md.js';
-export { buildAppIndexTs } from './app-index-ts.js';

package/dist/codegen/builders/jest-config-js.d.ts

@@ -1,4 +0,0 @@
-/**
- * Builds `jest.config.js` for the CLI.
- */
-export declare function buildJestConfigJs(): string;

package/dist/codegen/builders/jest-config-js.js

@@ -1,19 +0,0 @@
-/**
- * Builds `jest.config.js` for the CLI.
- */
-export function buildJestConfigJs() {
-    return [
-        "/** @type {import('jest').Config} */",
-        'export default {',
-        "  extensionsToTreatAsEsm: ['.ts'],",
-        '  transform: {',
-        "    '^.+\\\\.ts$': ['ts-jest', { useESM: true }],",
-        '  },',
-        '  moduleNameMapper: {',
-        "    '^(\\\\.{1,2}/.*)\\\\.js$': '$1',",
-        '  },',
-        "  testMatch: ['**/tests/**/*.test.ts'],",
-        '};',
-        '',
-    ].join('\n');
-}

package/dist/codegen/builders/main-ts.d.ts

@@ -1,5 +0,0 @@
-/**
- * Builds `src/main.ts` — the bin entry point. Always identical regardless
- * of feature toggles.
- */
-export declare function buildMainTs(): string;

package/dist/codegen/builders/main-ts.js

@@ -1,13 +0,0 @@
-/**
- * Builds `src/main.ts` — the bin entry point. Always identical regardless
- * of feature toggles.
- */
-export function buildMainTs() {
-    return [
-        '#!/usr/bin/env node',
-        "import { cli } from './cli.js';",
-        '',
-        'cli.run(process.argv);',
-        '',
-    ].join('\n');
-}

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

@@ -1,8 +0,0 @@
-/**
- * Builds `src/mastra/index.ts` — Mastra Studio entry point.
- *
- * When Mastra is off, emit a no-op placeholder so the directory still exists
- * and `mastra dev` fails predictably rather than importing partial code.
- */
-import { type ClintProjectSpec } from '../../spec/types.js';
-export declare function buildMastraIndexTs(spec: ClintProjectSpec): string;

package/dist/codegen/builders/mastra-index-ts.js

@@ -1,30 +0,0 @@
-export function buildMastraIndexTs(spec) {
-    const { mastra } = spec.features;
-    if (!mastra.enabled) {
-        return [
-            '/**',
-            ' * Mastra Studio entry point — placeholder. Enable the `mastra` feature to',
-            ' * populate this file. Until then `mastra:*` scripts are effectively no-ops.',
-            ' */',
-            '// @clint:begin mastra-index',
-            'export {};',
-            '// @clint:end mastra-index',
-            '',
-        ].join('\n');
-    }
-    // When Mastra is enabled but we still emit the demo `AgentProvider` shim
-    // (not a real `@mastra/core` Agent), there is no `mastra` export yet —
-    // `mastra dev` will surface a helpful message once you wire a real Agent.
-    return [
-        '/**',
-        ' * Mastra Studio entry point for `mastra dev` / `mastra build` / `mastra start`.',
-        ' *',
-        " * Re-export a configured `@mastra/core` Mastra instance from here once you",
-        " * replace the demo createAgent shim with a real Mastra Agent.",
-        ' */',
-        '// @clint:begin mastra-index',
-        'export {};',
-        '// @clint:end mastra-index',
-        '',
-    ].join('\n');
-}

package/dist/codegen/builders/readme-md.d.ts

@@ -1,5 +0,0 @@
-/**
- * Builds the project README for a freshly-generated ph-clint project.
- */
-import { type ClintProjectSpec } from '../../spec/types.js';
-export declare function buildReadme(spec: ClintProjectSpec): string;

package/dist/codegen/builders/readme-md.js

@@ -1,44 +0,0 @@
-/**
- * Builds the project README for a freshly-generated ph-clint project.
- */
-import { getPackageName, } from '../../spec/types.js';
-export function buildReadme(spec) {
-    const { mastra, routine, powerhouse } = spec.features;
-    const title = getPackageName(spec);
-    const lines = [];
-    lines.push(`# ${title}`);
-    lines.push('');
-    lines.push(spec.description || 'A ph-clint-based project.');
-    lines.push('');
-    lines.push('## Getting started');
-    lines.push('');
-    lines.push('```sh');
-    lines.push('pnpm install');
-    lines.push('pnpm dev');
-    lines.push('```');
-    lines.push('');
-    lines.push('## Enabled features');
-    lines.push('');
-    lines.push(`- **Powerhouse**: ${powerhouse.enabled ? 'on' : 'off'}`);
-    if (powerhouse.enabled) {
-        lines.push(`  - Switchboard: ${powerhouse.switchboard ? 'on' : 'off'}`);
-        lines.push(`  - Connect: ${powerhouse.connect ? 'on' : 'off'}`);
-    }
-    lines.push(`- **Mastra agent**: ${mastra.enabled ? 'on' : 'off'}`);
-    lines.push(`- **Routine loop**: ${routine.enabled ? 'on' : 'off'}`);
-    lines.push('');
-    lines.push('## Regenerate');
-    lines.push('');
-    lines.push('Toggle features or update metadata in `.ph/ph-clint-cli/project-spec.json`,');
-    lines.push('then re-run `ph-clint` to regenerate.');
-    lines.push('');
-    if (powerhouse.enabled) {
-        lines.push('## Split layout');
-        lines.push('');
-        lines.push(`This project is split into \`${spec.name}-cli/\` (the CLI) and \`${spec.name}-app/\` (the Powerhouse reactor package).`);
-        lines.push('');
-        lines.push(`Run \`ph init\` inside \`${spec.name}-app/\` to scaffold the reactor package layout (document-models, editors, manifest, etc.).`);
-        lines.push('');
-    }
-    return lines.join('\n');
-}

package/dist/codegen/builders/root-package-json.d.ts

@@ -1,7 +0,0 @@
-/**
- * Builds the *root* `package.json` for split-layout projects (Powerhouse
- * enabled). A plain passthrough — deliberately no pnpm workspaces because
- * they interfere with `{name}-app`'s own `pnpm build`.
- */
-import { type ClintProjectSpec } from '../../spec/types.js';
-export declare function buildRootPackageJson(spec: ClintProjectSpec): string;

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

@@ -1,27 +0,0 @@
-/**
- * Builds the *root* `package.json` for split-layout projects (Powerhouse
- * enabled). A plain passthrough — deliberately no pnpm workspaces because
- * they interfere with `{name}-app`'s own `pnpm build`.
- */
-import { getPackageName, } from '../../spec/types.js';
-export function buildRootPackageJson(spec) {
-    const cli = `${spec.name}-cli`;
-    const app = `${spec.name}-app`;
-    const pkg = {
-        name: getPackageName(spec),
-        version: spec.version,
-        private: true,
-        ...(spec.description ? { description: spec.description } : {}),
-        scripts: {
-            install: `cd ${app} && pnpm install && cd ../${cli} && pnpm install`,
-            build: `cd ${app} && pnpm build && cd ../${cli} && pnpm build`,
-            dev: `cd ${cli} && pnpm dev`,
-            start: `cd ${cli} && pnpm start`,
-            test: `cd ${app} && pnpm test && cd ../${cli} && pnpm test`,
-            lint: `cd ${cli} && pnpm lint`,
-            'app:dev': `cd ${app} && pnpm dev`,
-            'cli:dev': `cd ${cli} && pnpm dev`,
-        },
-    };
-    return JSON.stringify(pkg, null, 2) + '\n';
-}