@powerhousedao/ph-clint-cli 0.0.1

package/README.md

@@ -0,0 +1,84 @@
+# ph-clint-tpl-cli
+
+Template for the **ph-clint CLI side** of an implementation project. Starts
+as a flat layout (no Powerhouse reactor-package alongside it). When the
+`powerhouse` feature gets toggled on, the generator performs a one-time
+migration that moves this tree into `{name}-cli/` and scaffolds a sibling
+`{name}-app/`.
+
+## Folder layout
+
+```
+cli/
+├── src/
+│   ├── main.ts          # bin entrypoint (cli.run(process.argv))
+│   ├── cli.ts           # defineCli(...) call with @clint markers
+│   ├── config.ts        # configSchema + secretsSchema
+│   ├── mastra/          # Mastra Studio entry (populated when Mastra is on)
+│   ├── agents/          # Mastra agent definitions
+│   ├── commands/        # defineCommand(...) definitions
+│   ├── services/        # defineService(...) definitions
+│   └── triggers/        # defineTrigger(...) definitions
+├── prompts/             # Handlebars source for agent profiles & skills
+│   ├── agent-profiles/  # AgentBase.md + specialized profiles
+│   ├── skills-tpl/      # skill templates (authored here)
+│   └── skills-ext/      # external/pre-built skills (dropped in as-is)
+├── scripts/
+│   └── build-skills.ts  # compiles prompts/ → gen/ via ph-clint-dev
+├── gen/                 # codegen output (gitignored; built at build:skills)
+└── tests/               # user-authored tests
+```
+
+## Feature toggles
+
+Three independently togglable features. Each one is a `@clint:begin {name}`
+/ `@clint:end {name}` region that `ts-morph` can rewrite:
+
+### `powerhouse`
+
+Enables the Powerhouse Reactor stack (Reactor, optional Switchboard,
+optional Connect). On first enablement, the generator performs a one-time
+migration:
+
+1. Moves every file from `{root}/` to `{root}/{name}-cli/`.
+2. Runs `ph init` inside `{root}/{name}-app/` to scaffold the standard
+   Powerhouse reactor-package layout.
+3. Writes a new root `package.json` with passthrough scripts (no pnpm
+   workspaces — they interfere with `{name}-app`'s own builds).
+
+### `mastra`
+
+Enables the Mastra AI agent stack — agent definitions, thread-based memory
+(LibSQL), optional MCP client, and the Mastra Studio entry point at
+`src/mastra/index.ts` so `mastra dev` / `mastra build` / `mastra start` work.
+
+### `routine`
+
+Enables the tick-based routine loop and trigger registration. Forced on
+when `mastra` is enabled (an agent without a routine can still run from the
+REPL, but most useful setups want the loop).
+
+## Codegen markers
+
+Regions the generator can rewrite look like:
+
+```ts
+// src/cli.ts
+export const cli = defineCli({
+  // @clint:begin commands
+  commands: [/* list injected by codegen */],
+  // @clint:end commands
+
+  // @clint:begin services
+  services: [/* list injected by codegen */],
+  // @clint:end services
+});
+```
+
+Everything *outside* the markers is user-editable and preserved across
+regenerations. Everything *inside* a `@clint:begin`/`@clint:end` pair is
+codegen-owned.
+
+Files under `gen/` are fully codegen-owned — wiped and rewritten on every
+`build:skills`. Everything in `src/` is human-owned except for the
+explicitly marked regions.

package/dist/agents/clint-agent.d.ts

@@ -0,0 +1,12 @@
+import type { AgentProvider, AgentSetupContext } from '@powerhousedao/ph-clint';
+import type { Config } from '../framework.js';
+export declare const AGENT_ID = "clint";
+/**
+ * Agent factory for the ph-clint CLI.
+ *
+ * Demo mode echoes prompts; with an API key set via PH_CLINT_API_KEY, builds
+ * a full Mastra agent. The Powerhouse integration is still in scope but the
+ * agent does not yet write to any document model (document models land in
+ * Phase 4).
+ */
+export declare function createAgent(ctx: AgentSetupContext<Config>): Promise<AgentProvider>;

package/dist/agents/clint-agent.js

@@ -0,0 +1,42 @@
+export const AGENT_ID = 'clint';
+const instructions = `You are Clint — a ph-clint assistant that helps users scaffold, configure, and maintain ph-clint implementation projects.
+
+## Behavior
+- Be concise and practical.
+- When the user asks about a project, inspect the ClintProjectSpecification document via the Powerhouse Reactor when available.
+- Prefer small, incremental changes to the project's spec document over direct file edits.`;
+/**
+ * Agent factory for the ph-clint CLI.
+ *
+ * Demo mode echoes prompts; with an API key set via PH_CLINT_API_KEY, builds
+ * a full Mastra agent. The Powerhouse integration is still in scope but the
+ * agent does not yet write to any document model (document models land in
+ * Phase 4).
+ */
+export async function createAgent(ctx) {
+    if (!ctx.config.apiKey)
+        return createDemoAgent();
+    const { createMastraHelpers } = await import('@powerhousedao/ph-clint/mastra');
+    const { Agent } = await import('@mastra/core/agent');
+    const m = createMastraHelpers(ctx);
+    const mastraAgent = new Agent({
+        id: AGENT_ID,
+        name: 'Clint',
+        instructions,
+        model: { id: ctx.config.model, apiKey: ctx.config.apiKey },
+        tools: await m.getTools(),
+        memory: await m.createMemory(),
+    });
+    return m.wrapAgent(mastraAgent, { maxSteps: 40 });
+}
+function createDemoAgent() {
+    return {
+        id: AGENT_ID,
+        async *stream(prompt) {
+            yield {
+                type: 'text-delta',
+                text: `[Clint demo mode — set PH_CLINT_API_KEY for real LLM responses]\n\nYou said: "${prompt}"\n`,
+            };
+        },
+    };
+}

package/dist/cli.d.ts

@@ -0,0 +1 @@
+export declare const cli: import("@powerhousedao/ph-clint").Cli;

package/dist/cli.js

@@ -0,0 +1,122 @@
+/**
+ * ph-clint CLI definition.
+ *
+ * This file is the codegen anchor point. Regions bracketed by
+ * `@clint:begin {name}` / `@clint:end {name}` comment markers are
+ * rewritten by ph-clint-cli's generator when the project spec changes.
+ * Everything outside the markers is user-editable and preserved.
+ */
+import path from 'node:path';
+import { defineCli, buildDefaultReactor, deterministicId } from '@powerhousedao/ph-clint';
+import { z } from 'zod';
+import { CLI_NAME, CLI_VERSION, CLI_ROOT } from './config.js';
+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/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 { skillsSync } from './commands/clint-skills-sync.js';
+import { specChangeTrigger } from './triggers/spec-change.js';
+import { publishTrigger } from './triggers/publish-trigger.js';
+// @clint:end imports
+export const cli = defineCli({
+    name: CLI_NAME,
+    version: CLI_VERSION,
+    root: CLI_ROOT,
+    description: `${CLI_NAME} v${CLI_VERSION} — scaffold and maintain ph-clint implementation projects`,
+    configSchema,
+    secretsSchema,
+    // @clint:begin commands
+    commands: [init, regen, build, clintProjectPublish, skillsSync],
+    // @clint:end commands
+    // @clint:begin services
+    services: [clintProject],
+    // @clint:end services
+    // @clint:begin triggers
+    triggers: [specChangeTrigger, publishTrigger],
+    routine: { id: 'triggers', name: 'Triggers' },
+    // @clint:end triggers
+    // @clint:begin prompts
+    prompts: {
+        artifacts: [path.join(CLI_ROOT, 'gen', 'skills'), path.join(CLI_ROOT, 'dist', 'gen', 'skills')],
+        agents: {
+            'ph-clint-dev-agent': {
+                name: 'PhClintDevAgent',
+                sections: ['AgentBase.md'],
+                skills: ['cli-setup', 'command-definition', 'service-definition'],
+            },
+        },
+        skills: {
+            'cli-setup': {
+                description: 'Set up a new CLI with defineCli, config schemas, entrypoint, and interactive mode',
+                inputSchema: z.object({
+                    mode: z
+                        .enum(['expert', 'discovery', 'one-shot'])
+                        .default('expert')
+                        .describe('Expert: align design decisions with the developer. Discovery: explain concepts step by step. One-shot: make all decisions autonomously'),
+                }),
+                instructionTemplate: 'Use your {{skillId}} skill in {{mode}} mode for: {{prompt}}',
+            },
+            'command-definition': {
+                description: 'Define commands with Zod schemas, execute functions, return values, and parameter prompting',
+                inputSchema: z.object({
+                    mode: z
+                        .enum(['expert', 'discovery', 'one-shot'])
+                        .default('expert')
+                        .describe('Expert: align design decisions with the developer. Discovery: explain concepts step by step. One-shot: make all decisions autonomously'),
+                }),
+                instructionTemplate: 'Use your {{skillId}} skill in {{mode}} mode for: {{prompt}}',
+            },
+            'service-definition': {
+                description: 'Define background services with readiness detection, preflight checks, and project scanning',
+                inputSchema: z.object({
+                    mode: z
+                        .enum(['expert', 'discovery', 'one-shot'])
+                        .default('expert')
+                        .describe('Expert: align design decisions with the developer. Discovery: explain concepts step by step. One-shot: make all decisions autonomously'),
+                }),
+                instructionTemplate: 'Use your {{skillId}} skill in {{mode}} mode for: {{prompt}}',
+            },
+        },
+    },
+    // @clint:end prompts
+    // @clint:begin events
+    events: {},
+    // @clint:end events
+    // @clint:begin interactive
+    interactive: {
+        welcome: ({ config, workdir }) => {
+            const mode = config.apiKey
+                ? config.model
+                : 'demo mode — set PH_CLINT_API_KEY for real LLM responses';
+            return [
+                `ph-clint v${CLI_VERSION}`,
+                `Model:   ${mode}`,
+                `Workdir: ${workdir}`,
+                '',
+                'Type a message to talk to the agent, or /help for commands.',
+            ].join('\n');
+        },
+    },
+    // @clint:end interactive
+});
+// @clint:begin reactor
+cli.configureReactor({
+    create: (ctx) => buildDefaultReactor(ctx, {
+        documentModels: [...documentModels],
+        drives: [
+            { name: 'Clint Folders', role: 'personal', id: deterministicId(CLI_NAME, 'personal-drive') },
+        ],
+        subscriptions: { documentTypes: ['powerhouse/ph-clint-project'] },
+    }),
+    switchboard: { enabled: true },
+    connect: { enabled: true },
+});
+// @clint:end reactor
+// @clint:begin mastra
+cli.configureAgent(createAgent);
+// @clint:end mastra

package/dist/codegen/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 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>;

package/dist/codegen/index.js

@@ -0,0 +1,11 @@
+/**
+ * Re-exports from @powerhousedao/ph-clint-dev/codegen with CLI_VERSION default.
+ */
+import { generateProject as _generateProject, } from '@powerhousedao/ph-clint-dev/codegen';
+import { CLI_VERSION } from '../config.js';
+export async function generateProject(options) {
+    return _generateProject({
+        ...options,
+        context: options.context ?? { toolVersion: CLI_VERSION },
+    });
+}

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

@@ -0,0 +1,83 @@
+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;
+}, {
+    model: string;
+    devServicePort: number;
+    phVersion: string;
+    apiKey?: string | undefined;
+}, import("@powerhousedao/ph-clint").InferRegistry<readonly [{
+    readonly version: 1;
+    readonly reducer: import("document-model").Reducer<import("@powerhousedao/ph-clint-app").PhClintProjectPHState>;
+    readonly actions: {
+        setAgentModel: (input: import("@powerhousedao/ph-clint-app").SetAgentModelInput) => import("@powerhousedao/ph-clint-app").SetAgentModelAction;
+        addAgentProfileRef: (input: import("@powerhousedao/ph-clint-app").AddAgentProfileRefInput) => import("@powerhousedao/ph-clint-app").AddAgentProfileRefAction;
+        removeAgentProfileRef: (input: import("@powerhousedao/ph-clint-app").RemoveAgentProfileRefInput) => import("@powerhousedao/ph-clint-app").RemoveAgentProfileRefAction;
+        reorderAgentProfileRefs: (input: import("@powerhousedao/ph-clint-app").ReorderAgentProfileRefsInput) => import("@powerhousedao/ph-clint-app").ReorderAgentProfileRefsAction;
+        addAgentSkill: (input: import("@powerhousedao/ph-clint-app").AddAgentSkillInput) => import("@powerhousedao/ph-clint-app").AddAgentSkillAction;
+        removeAgentSkill: (input: import("@powerhousedao/ph-clint-app").RemoveAgentSkillInput) => import("@powerhousedao/ph-clint-app").RemoveAgentSkillAction;
+        addAgentToolPattern: (input: import("@powerhousedao/ph-clint-app").AddAgentToolPatternInput) => import("@powerhousedao/ph-clint-app").AddAgentToolPatternAction;
+        removeAgentToolPattern: (input: import("@powerhousedao/ph-clint-app").RemoveAgentToolPatternInput) => import("@powerhousedao/ph-clint-app").RemoveAgentToolPatternAction;
+        addSubAgent: (input: import("@powerhousedao/ph-clint-app").AddSubAgentInput) => import("@powerhousedao/ph-clint-app").AddSubAgentAction;
+        removeSubAgent: (input: import("@powerhousedao/ph-clint-app").RemoveSubAgentInput) => import("@powerhousedao/ph-clint-app").RemoveSubAgentAction;
+        setSubAgentName: (input: import("@powerhousedao/ph-clint-app").SetSubAgentNameInput) => import("@powerhousedao/ph-clint-app").SetSubAgentNameAction;
+        setSubAgentDescription: (input: import("@powerhousedao/ph-clint-app").SetSubAgentDescriptionInput) => import("@powerhousedao/ph-clint-app").SetSubAgentDescriptionAction;
+        setMainAgentName: (input: import("@powerhousedao/ph-clint-app").SetMainAgentNameInput) => import("@powerhousedao/ph-clint-app").SetMainAgentNameAction;
+        setMainAgentDescription: (input: import("@powerhousedao/ph-clint-app").SetMainAgentDescriptionInput) => import("@powerhousedao/ph-clint-app").SetMainAgentDescriptionAction;
+        clearMainAgentDescription: (input: import("@powerhousedao/ph-clint-app").ClearMainAgentDescriptionInput) => import("@powerhousedao/ph-clint-app").ClearMainAgentDescriptionAction;
+        setMainAgentImage: (input: import("@powerhousedao/ph-clint-app").SetMainAgentImageInput) => import("@powerhousedao/ph-clint-app").SetMainAgentImageAction;
+        clearMainAgentImage: (input: import("@powerhousedao/ph-clint-app").ClearMainAgentImageInput) => import("@powerhousedao/ph-clint-app").ClearMainAgentImageAction;
+        addProfile: (input: import("@powerhousedao/ph-clint-app").AddProfileInput) => import("@powerhousedao/ph-clint-app").AddProfileAction;
+        updateProfile: (input: import("@powerhousedao/ph-clint-app").UpdateProfileInput) => import("@powerhousedao/ph-clint-app").UpdateProfileAction;
+        removeProfile: (input: import("@powerhousedao/ph-clint-app").RemoveProfileInput) => import("@powerhousedao/ph-clint-app").RemoveProfileAction;
+        reorderProfiles: (input: import("@powerhousedao/ph-clint-app").ReorderProfilesInput) => import("@powerhousedao/ph-clint-app").ReorderProfilesAction;
+        addModel: (input: import("@powerhousedao/ph-clint-app").AddModelInput) => import("@powerhousedao/ph-clint-app").AddModelAction;
+        removeModel: (input: import("@powerhousedao/ph-clint-app").RemoveModelInput) => import("@powerhousedao/ph-clint-app").RemoveModelAction;
+        enableMastra: (input: import("@powerhousedao/ph-clint-app").EnableMastraInput) => import("@powerhousedao/ph-clint-app").EnableMastraAction;
+        disableMastra: (input: import("@powerhousedao/ph-clint-app").DisableMastraInput) => import("@powerhousedao/ph-clint-app").DisableMastraAction;
+        setEnableChat: (input: import("@powerhousedao/ph-clint-app").SetEnableChatInput) => import("@powerhousedao/ph-clint-app").SetEnableChatAction;
+        addSupportedResource: (input: import("@powerhousedao/ph-clint-app").AddSupportedResourceInput) => import("@powerhousedao/ph-clint-app").AddSupportedResourceAction;
+        removeSupportedResource: (input: import("@powerhousedao/ph-clint-app").RemoveSupportedResourceInput) => import("@powerhousedao/ph-clint-app").RemoveSupportedResourceAction;
+        setProxyEnabled: (input: import("@powerhousedao/ph-clint-app").SetProxyEnabledInput) => import("@powerhousedao/ph-clint-app").SetProxyEnabledAction;
+        setObservabilityEnabled: (input: import("@powerhousedao/ph-clint-app").SetObservabilityEnabledInput) => import("@powerhousedao/ph-clint-app").SetObservabilityEnabledAction;
+        importSpec: (input: import("@powerhousedao/ph-clint-app").ImportSpecInput) => import("@powerhousedao/ph-clint-app").ImportSpecAction;
+        bumpVersion: (input: import("@powerhousedao/ph-clint-app").BumpVersionInput) => import("@powerhousedao/ph-clint-app").BumpVersionAction;
+        publishDev: (input: import("@powerhousedao/ph-clint-app").PublishDevInput) => import("@powerhousedao/ph-clint-app").PublishDevAction;
+        publishStaging: (input: import("@powerhousedao/ph-clint-app").PublishStagingInput) => import("@powerhousedao/ph-clint-app").PublishStagingAction;
+        publishProduction: (input: import("@powerhousedao/ph-clint-app").PublishProductionInput) => import("@powerhousedao/ph-clint-app").PublishProductionAction;
+        setPublishStatus: (input: import("@powerhousedao/ph-clint-app").SetPublishStatusInput) => import("@powerhousedao/ph-clint-app").SetPublishStatusAction;
+        addExternalSkill: (input: import("@powerhousedao/ph-clint-app").AddExternalSkillInput) => import("@powerhousedao/ph-clint-app").AddExternalSkillAction;
+        removeExternalSkill: (input: import("@powerhousedao/ph-clint-app").RemoveExternalSkillInput) => import("@powerhousedao/ph-clint-app").RemoveExternalSkillAction;
+        setExternalSkillName: (input: import("@powerhousedao/ph-clint-app").SetExternalSkillNameInput) => import("@powerhousedao/ph-clint-app").SetExternalSkillNameAction;
+        setExternalSkillGithubUrl: (input: import("@powerhousedao/ph-clint-app").SetExternalSkillGithubUrlInput) => import("@powerhousedao/ph-clint-app").SetExternalSkillGithubUrlAction;
+        addPowerhousePackage: (input: import("@powerhousedao/ph-clint-app").AddPowerhousePackageInput) => import("@powerhousedao/ph-clint-app").AddPowerhousePackageAction;
+        removePowerhousePackage: (input: import("@powerhousedao/ph-clint-app").RemovePowerhousePackageInput) => import("@powerhousedao/ph-clint-app").RemovePowerhousePackageAction;
+        addPackageDocumentType: (input: import("@powerhousedao/ph-clint-app").AddPackageDocumentTypeInput) => import("@powerhousedao/ph-clint-app").AddPackageDocumentTypeAction;
+        removePackageDocumentType: (input: import("@powerhousedao/ph-clint-app").RemovePackageDocumentTypeInput) => import("@powerhousedao/ph-clint-app").RemovePackageDocumentTypeAction;
+        setPackageVersion: (input: import("@powerhousedao/ph-clint-app").SetPackageVersionInput) => import("@powerhousedao/ph-clint-app").SetPackageVersionAction;
+        enableRoutine: (input: import("@powerhousedao/ph-clint-app").EnableRoutineInput) => import("@powerhousedao/ph-clint-app").EnableRoutineAction;
+        disableRoutine: (input: import("@powerhousedao/ph-clint-app").DisableRoutineInput) => import("@powerhousedao/ph-clint-app").DisableRoutineAction;
+        setPowerhouseLevel: (input: import("@powerhousedao/ph-clint-app").SetPowerhouseLevelInput) => import("@powerhousedao/ph-clint-app").SetPowerhouseLevelAction;
+        setDescription: (input: import("@powerhousedao/ph-clint-app").SetDescriptionInput) => import("@powerhousedao/ph-clint-app").SetDescriptionAction;
+        setVersion: (input: import("@powerhousedao/ph-clint-app").SetVersionInput) => import("@powerhousedao/ph-clint-app").SetVersionAction;
+        setPackageIdentifier: (input: import("@powerhousedao/ph-clint-app").SetPackageIdentifierInput) => import("@powerhousedao/ph-clint-app").SetPackageIdentifierAction;
+        setName: (name: string | {
+            name: string;
+        }) => import("document-model").SetNameAction;
+        setPreferredEditor: (input: string | null | {
+            preferredEditor: string | null;
+        }) => import("document-model").SetPreferredEditorAction;
+        undo: (count?: number, scope?: string) => import("document-model").UndoAction;
+        redo: (count?: number, scope?: string) => import("document-model").RedoAction;
+        prune: (start?: number, end?: number, scope?: string) => import("document-model").SchemaPruneAction;
+        loadState: <TState extends import("document-model").PHBaseState = import("document-model").PHBaseState>(state: TState & {
+            name: string;
+        }, operations: number) => import("document-model").LoadStateAction;
+        noop: (scope?: string) => import("document-model").NOOPAction;
+    };
+    readonly utils: import("document-model").DocumentModelUtils<import("@powerhousedao/ph-clint-app").PhClintProjectPHState>;
+    readonly documentModel: import("document-model").DocumentModelPHState;
+}]>>;

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

@@ -0,0 +1,34 @@
+import path from 'node:path';
+import { defineCommand } from '../framework.js';
+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),
+});
+export const build = defineCommand({
+    id: 'clint-project-build',
+    description: 'Build all packages in the project',
+    inputSchema,
+    execute: async (input, { workdir, stdout, runProcess }) => {
+        const dir = path.resolve(input.dir ?? workdir);
+        const layout = detectLayout(dir);
+        if (layout?.type === 'split') {
+            stdout(`Building app package (${layout.app})...\n`);
+            const appResult = await runProcess('pnpm build', { cwd: layout.app, timeout: 120_000 });
+            if (!appResult.success)
+                return { text: `App build failed.` };
+            stdout(`Building cli package (${layout.cli})...\n`);
+            const cliResult = await runProcess('pnpm build', { cwd: layout.cli, timeout: 120_000 });
+            if (!cliResult.success)
+                return { text: `CLI build failed.` };
+        }
+        else {
+            stdout(`Building project...\n`);
+            const result = await runProcess('pnpm build', { cwd: layout?.cli ?? dir, timeout: 120_000 });
+            if (!result.success)
+                return { text: `Build failed.` };
+        }
+        return { text: 'Build complete.' };
+    },
+});

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

@@ -0,0 +1,177 @@
+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>;
+    enableObservability: z.ZodDefault<z.ZodBoolean>;
+    force: 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>;
+    enableObservability: z.ZodDefault<z.ZodBoolean>;
+    force: 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: "Disabled" | "Reactor" | "Switchboard" | "Connect";
+                mastra: {
+                    enabled: boolean;
+                    mainAgent: {
+                        description: string | null;
+                        image: string | null;
+                        id: string;
+                        name: string;
+                        modelId: string;
+                        profileIds: string[];
+                        skills: string[];
+                        toolPatterns: string[];
+                    } | null;
+                    subAgents: {
+                        description: string;
+                        id: string;
+                        name: string;
+                        modelId: string;
+                        profileIds: string[];
+                        skills: string[];
+                        toolPatterns: string[];
+                    }[];
+                    models: {
+                        id: string;
+                    }[];
+                    profiles: {
+                        id: string;
+                        title: string;
+                        content: string;
+                    }[];
+                    common: {
+                        enableChat: boolean;
+                    };
+                };
+                routine: {
+                    enabled: boolean;
+                };
+            };
+            packages: {
+                id: string;
+                packageName: string;
+                documentTypes: string[];
+                version: string | null;
+            }[];
+            externalSkills: {
+                id: string;
+                name: string;
+                githubUrl: string;
+            }[];
+            deployment: {
+                proxyEnabled: boolean;
+                observabilityEnabled: boolean;
+                supportedResources: string[];
+                dockerfile?: string | undefined;
+                dockerTarget?: string | undefined;
+            };
+            scope?: string | undefined;
+            documentId?: string | undefined;
+            documentType?: string | undefined;
+        };
+        fileCount: number;
+    };
+}, {
+    model: string;
+    devServicePort: number;
+    phVersion: string;
+    apiKey?: string | undefined;
+}, import("@powerhousedao/ph-clint").InferRegistry<readonly [{
+    readonly version: 1;
+    readonly reducer: import("document-model").Reducer<import("@powerhousedao/ph-clint-app").PhClintProjectPHState>;
+    readonly actions: {
+        setAgentModel: (input: import("@powerhousedao/ph-clint-app").SetAgentModelInput) => import("@powerhousedao/ph-clint-app").SetAgentModelAction;
+        addAgentProfileRef: (input: import("@powerhousedao/ph-clint-app").AddAgentProfileRefInput) => import("@powerhousedao/ph-clint-app").AddAgentProfileRefAction;
+        removeAgentProfileRef: (input: import("@powerhousedao/ph-clint-app").RemoveAgentProfileRefInput) => import("@powerhousedao/ph-clint-app").RemoveAgentProfileRefAction;
+        reorderAgentProfileRefs: (input: import("@powerhousedao/ph-clint-app").ReorderAgentProfileRefsInput) => import("@powerhousedao/ph-clint-app").ReorderAgentProfileRefsAction;
+        addAgentSkill: (input: import("@powerhousedao/ph-clint-app").AddAgentSkillInput) => import("@powerhousedao/ph-clint-app").AddAgentSkillAction;
+        removeAgentSkill: (input: import("@powerhousedao/ph-clint-app").RemoveAgentSkillInput) => import("@powerhousedao/ph-clint-app").RemoveAgentSkillAction;
+        addAgentToolPattern: (input: import("@powerhousedao/ph-clint-app").AddAgentToolPatternInput) => import("@powerhousedao/ph-clint-app").AddAgentToolPatternAction;
+        removeAgentToolPattern: (input: import("@powerhousedao/ph-clint-app").RemoveAgentToolPatternInput) => import("@powerhousedao/ph-clint-app").RemoveAgentToolPatternAction;
+        addSubAgent: (input: import("@powerhousedao/ph-clint-app").AddSubAgentInput) => import("@powerhousedao/ph-clint-app").AddSubAgentAction;
+        removeSubAgent: (input: import("@powerhousedao/ph-clint-app").RemoveSubAgentInput) => import("@powerhousedao/ph-clint-app").RemoveSubAgentAction;
+        setSubAgentName: (input: import("@powerhousedao/ph-clint-app").SetSubAgentNameInput) => import("@powerhousedao/ph-clint-app").SetSubAgentNameAction;
+        setSubAgentDescription: (input: import("@powerhousedao/ph-clint-app").SetSubAgentDescriptionInput) => import("@powerhousedao/ph-clint-app").SetSubAgentDescriptionAction;
+        setMainAgentName: (input: import("@powerhousedao/ph-clint-app").SetMainAgentNameInput) => import("@powerhousedao/ph-clint-app").SetMainAgentNameAction;
+        setMainAgentDescription: (input: import("@powerhousedao/ph-clint-app").SetMainAgentDescriptionInput) => import("@powerhousedao/ph-clint-app").SetMainAgentDescriptionAction;
+        clearMainAgentDescription: (input: import("@powerhousedao/ph-clint-app").ClearMainAgentDescriptionInput) => import("@powerhousedao/ph-clint-app").ClearMainAgentDescriptionAction;
+        setMainAgentImage: (input: import("@powerhousedao/ph-clint-app").SetMainAgentImageInput) => import("@powerhousedao/ph-clint-app").SetMainAgentImageAction;
+        clearMainAgentImage: (input: import("@powerhousedao/ph-clint-app").ClearMainAgentImageInput) => import("@powerhousedao/ph-clint-app").ClearMainAgentImageAction;
+        addProfile: (input: import("@powerhousedao/ph-clint-app").AddProfileInput) => import("@powerhousedao/ph-clint-app").AddProfileAction;
+        updateProfile: (input: import("@powerhousedao/ph-clint-app").UpdateProfileInput) => import("@powerhousedao/ph-clint-app").UpdateProfileAction;
+        removeProfile: (input: import("@powerhousedao/ph-clint-app").RemoveProfileInput) => import("@powerhousedao/ph-clint-app").RemoveProfileAction;
+        reorderProfiles: (input: import("@powerhousedao/ph-clint-app").ReorderProfilesInput) => import("@powerhousedao/ph-clint-app").ReorderProfilesAction;
+        addModel: (input: import("@powerhousedao/ph-clint-app").AddModelInput) => import("@powerhousedao/ph-clint-app").AddModelAction;
+        removeModel: (input: import("@powerhousedao/ph-clint-app").RemoveModelInput) => import("@powerhousedao/ph-clint-app").RemoveModelAction;
+        enableMastra: (input: import("@powerhousedao/ph-clint-app").EnableMastraInput) => import("@powerhousedao/ph-clint-app").EnableMastraAction;
+        disableMastra: (input: import("@powerhousedao/ph-clint-app").DisableMastraInput) => import("@powerhousedao/ph-clint-app").DisableMastraAction;
+        setEnableChat: (input: import("@powerhousedao/ph-clint-app").SetEnableChatInput) => import("@powerhousedao/ph-clint-app").SetEnableChatAction;
+        addSupportedResource: (input: import("@powerhousedao/ph-clint-app").AddSupportedResourceInput) => import("@powerhousedao/ph-clint-app").AddSupportedResourceAction;
+        removeSupportedResource: (input: import("@powerhousedao/ph-clint-app").RemoveSupportedResourceInput) => import("@powerhousedao/ph-clint-app").RemoveSupportedResourceAction;
+        setProxyEnabled: (input: import("@powerhousedao/ph-clint-app").SetProxyEnabledInput) => import("@powerhousedao/ph-clint-app").SetProxyEnabledAction;
+        setObservabilityEnabled: (input: import("@powerhousedao/ph-clint-app").SetObservabilityEnabledInput) => import("@powerhousedao/ph-clint-app").SetObservabilityEnabledAction;
+        importSpec: (input: import("@powerhousedao/ph-clint-app").ImportSpecInput) => import("@powerhousedao/ph-clint-app").ImportSpecAction;
+        bumpVersion: (input: import("@powerhousedao/ph-clint-app").BumpVersionInput) => import("@powerhousedao/ph-clint-app").BumpVersionAction;
+        publishDev: (input: import("@powerhousedao/ph-clint-app").PublishDevInput) => import("@powerhousedao/ph-clint-app").PublishDevAction;
+        publishStaging: (input: import("@powerhousedao/ph-clint-app").PublishStagingInput) => import("@powerhousedao/ph-clint-app").PublishStagingAction;
+        publishProduction: (input: import("@powerhousedao/ph-clint-app").PublishProductionInput) => import("@powerhousedao/ph-clint-app").PublishProductionAction;
+        setPublishStatus: (input: import("@powerhousedao/ph-clint-app").SetPublishStatusInput) => import("@powerhousedao/ph-clint-app").SetPublishStatusAction;
+        addExternalSkill: (input: import("@powerhousedao/ph-clint-app").AddExternalSkillInput) => import("@powerhousedao/ph-clint-app").AddExternalSkillAction;
+        removeExternalSkill: (input: import("@powerhousedao/ph-clint-app").RemoveExternalSkillInput) => import("@powerhousedao/ph-clint-app").RemoveExternalSkillAction;
+        setExternalSkillName: (input: import("@powerhousedao/ph-clint-app").SetExternalSkillNameInput) => import("@powerhousedao/ph-clint-app").SetExternalSkillNameAction;
+        setExternalSkillGithubUrl: (input: import("@powerhousedao/ph-clint-app").SetExternalSkillGithubUrlInput) => import("@powerhousedao/ph-clint-app").SetExternalSkillGithubUrlAction;
+        addPowerhousePackage: (input: import("@powerhousedao/ph-clint-app").AddPowerhousePackageInput) => import("@powerhousedao/ph-clint-app").AddPowerhousePackageAction;
+        removePowerhousePackage: (input: import("@powerhousedao/ph-clint-app").RemovePowerhousePackageInput) => import("@powerhousedao/ph-clint-app").RemovePowerhousePackageAction;
+        addPackageDocumentType: (input: import("@powerhousedao/ph-clint-app").AddPackageDocumentTypeInput) => import("@powerhousedao/ph-clint-app").AddPackageDocumentTypeAction;
+        removePackageDocumentType: (input: import("@powerhousedao/ph-clint-app").RemovePackageDocumentTypeInput) => import("@powerhousedao/ph-clint-app").RemovePackageDocumentTypeAction;
+        setPackageVersion: (input: import("@powerhousedao/ph-clint-app").SetPackageVersionInput) => import("@powerhousedao/ph-clint-app").SetPackageVersionAction;
+        enableRoutine: (input: import("@powerhousedao/ph-clint-app").EnableRoutineInput) => import("@powerhousedao/ph-clint-app").EnableRoutineAction;
+        disableRoutine: (input: import("@powerhousedao/ph-clint-app").DisableRoutineInput) => import("@powerhousedao/ph-clint-app").DisableRoutineAction;
+        setPowerhouseLevel: (input: import("@powerhousedao/ph-clint-app").SetPowerhouseLevelInput) => import("@powerhousedao/ph-clint-app").SetPowerhouseLevelAction;
+        setDescription: (input: import("@powerhousedao/ph-clint-app").SetDescriptionInput) => import("@powerhousedao/ph-clint-app").SetDescriptionAction;
+        setVersion: (input: import("@powerhousedao/ph-clint-app").SetVersionInput) => import("@powerhousedao/ph-clint-app").SetVersionAction;
+        setPackageIdentifier: (input: import("@powerhousedao/ph-clint-app").SetPackageIdentifierInput) => import("@powerhousedao/ph-clint-app").SetPackageIdentifierAction;
+        setName: (name: string | {
+            name: string;
+        }) => import("document-model").SetNameAction;
+        setPreferredEditor: (input: string | null | {
+            preferredEditor: string | null;
+        }) => import("document-model").SetPreferredEditorAction;
+        undo: (count?: number, scope?: string) => import("document-model").UndoAction;
+        redo: (count?: number, scope?: string) => import("document-model").RedoAction;
+        prune: (start?: number, end?: number, scope?: string) => import("document-model").SchemaPruneAction;
+        loadState: <TState extends import("document-model").PHBaseState = import("document-model").PHBaseState>(state: TState & {
+            name: string;
+        }, operations: number) => import("document-model").LoadStateAction;
+        noop: (scope?: string) => import("document-model").NOOPAction;
+    };
+    readonly utils: import("document-model").DocumentModelUtils<import("@powerhousedao/ph-clint-app").PhClintProjectPHState>;
+    readonly documentModel: import("document-model").DocumentModelPHState;
+}]>>;
+export {};