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

package/dist/spec/types.js

@@ -1,209 +1 @@
-/**
- * ClintProjectSpec — the in-memory shape that describes a ph-clint
- * implementation project. Persisted at
- * `{impl-project}/.ph/ph-clint-cli/project-spec.json` and consumed by
- * the code generator (src/codegen/).
- *
- * Intentionally minimal. Richer structure (services, skills, agents,
- * triggers, document-models) gets added in later phases as each
- * generator step actually needs it.
- */
-import { z } from 'zod';
-/**
- * Ordered Powerhouse integration level. Higher levels imply all lower ones:
- *   Disabled → Reactor → Switchboard → Connect
- */
-export const POWERHOUSE_LEVELS = [
-    'Disabled',
-    'Reactor',
-    'Switchboard',
-    'Connect',
-];
-export const powerhouseLevelSchema = z
-    .enum(POWERHOUSE_LEVELS)
-    .default('Disabled');
-/** Check whether `level` is at least `threshold` in the ordered enum. */
-export function phAtLeast(level, threshold) {
-    return (POWERHOUSE_LEVELS.indexOf(level) >= POWERHOUSE_LEVELS.indexOf(threshold));
-}
-export const agentModelSchema = z.object({
-    id: z.string(),
-    isDefault: z.boolean(),
-});
-export const agentProfileSchema = z.object({
-    id: z.string(),
-    title: z.string(),
-    content: z.string(),
-});
-const mastraCommonSchema = z.object({
-    enableChat: z.boolean().default(false),
-});
-const mastraFeatureSchema = z.object({
-    enabled: z.boolean().default(false),
-    agentId: z.string().nullable().default(null),
-    agentName: z.string().nullable().default(null),
-    agentDescription: z.string().nullable().default(null),
-    agentImage: z.string().nullable().default(null),
-    models: z.array(agentModelSchema).default([]),
-    profiles: z.array(agentProfileSchema).default([]),
-    common: mastraCommonSchema.default({ enableChat: false }),
-});
-const routineFeatureSchema = z.object({
-    enabled: z.boolean().default(false),
-});
-const DEFAULT_MASTRA = {
-    enabled: false,
-    agentId: null,
-    agentName: null,
-    agentDescription: null,
-    agentImage: null,
-    models: [],
-    profiles: [],
-    common: { enableChat: false },
-};
-const DEFAULT_ROUTINE = { enabled: false };
-export const powerhousePackageSchema = z.object({
-    id: z.string(),
-    packageName: z.string(),
-    documentTypes: z.array(z.string()).default([]),
-    version: z.string().nullable().default(null),
-});
-export const externalSkillSchema = z.object({
-    id: z.string(),
-    name: z.string(),
-    githubUrl: z.string(),
-});
-export const clintProjectSpecSchema = z.object({
-    name: z
-        .string()
-        .regex(/^[a-z0-9][a-z0-9-]*-cli$/, 'must end with -cli, lowercase letters, digits, hyphens only'),
-    scope: z
-        .string()
-        .regex(/^@[a-z0-9][a-z0-9-]*$/, 'must start with @, lowercase letters, digits, hyphens only')
-        .optional(),
-    version: z.string().default('0.0.1-dev.0'),
-    description: z.string().default(''),
-    features: z
-        .object({
-        powerhouse: powerhouseLevelSchema,
-        mastra: mastraFeatureSchema.default(DEFAULT_MASTRA),
-        routine: routineFeatureSchema.default(DEFAULT_ROUTINE),
-    })
-        .default({
-        powerhouse: 'Disabled',
-        mastra: DEFAULT_MASTRA,
-        routine: DEFAULT_ROUTINE,
-    }),
-    /**
-     * Reactor packages and their document types. Each entry groups a package
-     * name with the document type IDs it provides. The app package (project's
-     * own reactor package) uses a `file:` dependency; external packages become
-     * versioned npm dependencies. Drives codegen of `framework.gen.ts`,
-     * `app/index.ts`, and `cli/package.json`.
-     */
-    packages: z.array(powerhousePackageSchema).default([]),
-    /**
-     * External skills from the skills.sh ecosystem. Each skill has a name
-     * (kebab-case) and a GitHub URL for installation.
-     */
-    externalSkills: z.array(externalSkillSchema).default([]),
-    deployment: z.object({
-        proxyEnabled: z.boolean().default(false),
-        supportedResources: z.array(z.string()).default([]),
-    }).default({ proxyEnabled: false, supportedResources: [] }),
-    /** ID of the source specification document (if backed by a Powerhouse document). */
-    documentId: z.string().optional(),
-    /** Document type of the source specification document. */
-    documentType: z.string().optional(),
-});
-/** npm package name (e.g. `@scope/my-tool-cli` or `my-tool-cli`). */
-export function getPackageName(spec) {
-    return spec.scope ? `${spec.scope}/${spec.name}` : spec.name;
-}
-/** bin name (strips -cli suffix, e.g. `my-tool-cli` → `my-tool`). */
-export function getBinName(spec) {
-    return spec.name.replace(/-cli$/, '');
-}
-/**
- * Name of the CLI sub-folder when the project is split (Powerhouse enabled).
- * For flat projects this is irrelevant — callers use the project root directly.
- */
-export function getCliFolderName(spec) {
-    return spec.name;
-}
-/**
- * Name of the reactor-package sub-folder when the project is split.
- */
-export function getAppFolderName(spec) {
-    return spec.name.replace(/-cli$/, '-app');
-}
-/**
- * Flat list of all document types across all packages. Convenience for
- * codegen that needs to iterate every registered document type regardless
- * of which package provides it.
- */
-export function getAllDocumentTypes(spec) {
-    return spec.packages.flatMap((p) => p.documentTypes);
-}
-/**
- * The app npm package name (`@scope/my-tool-app` or `my-tool-app`).
- * Matches what the document model reducer stores in `packages[].packageName`.
- */
-export function getAppPackageName(spec) {
-    const base = getAppFolderName(spec);
-    return spec.scope ? `${spec.scope}/${base}` : base;
-}
-/** Directory name for the app package (e.g. `my-tool-app`, no scope prefix). */
-export function getAppDirName(spec) {
-    return getAppFolderName(spec);
-}
-/**
- * Folder slug for a documentType ID. The slug is the portion after the last
- * `/` (e.g. `powerhouse/ph-clint-project` → `ph-clint-project`). Matches the
- * convention used by Powerhouse's reactor-package codegen — each document
- * model lives at `document-models/<slug>/`.
- */
-export function getDocumentTypeSlug(documentType) {
-    const lastSlash = documentType.lastIndexOf('/');
-    return lastSlash >= 0 ? documentType.slice(lastSlash + 1) : documentType;
-}
-/**
- * PascalCase export name for a documentType ID. Powerhouse's module
- * generator exports each module as `PascalCase(<slug>)` (e.g.
- * `powerhouse/ph-clint-project` → `PhClintProject`). The top-level reactor
- * package re-exports these names, so this helper gives codegen the string
- * it needs both for the import and the `defineRegistry` entry.
- */
-export function getDocumentTypeModuleName(documentType) {
-    const slug = getDocumentTypeSlug(documentType);
-    return slug
-        .split(/[-_]/)
-        .filter((s) => s.length > 0)
-        .map((s) => s[0].toUpperCase() + s.slice(1))
-        .join('');
-}
-/**
- * Returns true when a documentType entry contains glob wildcards (`*`).
- * Glob entries like `*​/*`, `powerhouse/*`, or `powerhouse/doc-*` are spec
- * shorthand meaning "all matching document types from this package" and
- * must be resolved at runtime rather than emitted as static imports.
- */
-export function isDocTypeGlob(documentType) {
-    return documentType.includes('*');
-}
-/**
- * Convert a documentType glob pattern to a regex source string suitable
- * for embedding in a `/pattern/` literal.  Each `*` matches any non-`/`
- * characters. Forward slashes are escaped so the output is safe inside
- * `/.../`.
- *
- * Examples:
- *   `*​/*`            → `^[^\/]*\/[^\/]*$`   (any org, any name)
- *   `powerhouse/*`   → `^powerhouse\/[^\/]*$`
- *   `powerhouse/doc-*` → `^powerhouse\/doc-[^\/]*$`
- */
-export function docTypeGlobToRegex(pattern) {
-    const escaped = pattern.replace(/[.+?^${}()|[\]\\\/]/g, '\\$&');
-    const withWildcards = escaped.replace(/\*/g, '[^\\/]*');
-    return `^${withWildcards}$`;
-}
+export { POWERHOUSE_LEVELS, powerhouseLevelSchema, phAtLeast, agentModelSchema, agentProfileSchema, powerhousePackageSchema, externalSkillSchema, clintProjectSpecSchema, getPackageName, getBinName, getCliFolderName, getAppFolderName, getAllDocumentTypes, getAppPackageName, getAppDirName, getDocumentTypeSlug, getDocumentTypeModuleName, isDocTypeGlob, docTypeGlobToRegex, } from '@powerhousedao/ph-clint-dev/spec';

package/dist/triggers/publish-trigger.js

@@ -104,7 +104,7 @@ export const publishTrigger = createDocumentChangeTrigger({
                         try {
                             stdout(`${TAG} invoking clint-project-publish --tag ${cliTag}\n`);
                             const { clintProjectPublish } = await import('../commands/clint-project-publish.js');
-                            const result = await clintProjectPublish.execute({ tag: cliTag, dryRun: false, skipBuild: false, skipGitCheck: true, verbose: false }, ctx.commandContext);
+                            const result = await clintProjectPublish.execute({ tag: cliTag, dir: workdir, dryRun: false, skipBuild: false, skipGitCheck: true, verbose: false }, ctx.commandContext);
                             success = !result.text.includes('failed');
                         }
                         catch (err) {

package/dist/triggers/spec-change.js

@@ -19,7 +19,7 @@ import path from 'node:path';
 import { scanProjects, getProjectMapping } from '@powerhousedao/ph-clint';
 import { createDocumentChangeTrigger } from '../framework.js';
 import { generateProject } from '../codegen/index.js';
-import { runPostGenActions } from '../codegen/actions.js';
+import { runPostGenActions } from '@powerhousedao/ph-clint-dev/codegen/actions';
 import { specFromDocumentState } from '../spec/from-document.js';
 import { readProjectSpec, writeProjectSpec } from '../spec/file.js';
 import { ensureSpecDocument } from '../spec/ensure-document.js';
@@ -105,12 +105,18 @@ export function specToImportInput(spec) {
             name: s.name,
             githubUrl: s.githubUrl,
         })),
+        agentDescription: spec.features.mastra.agentDescription ?? null,
+        agentImage: spec.features.mastra.agentImage ?? null,
+        enableChat: spec.features.mastra.common.enableChat,
+        proxyEnabled: spec.deployment.proxyEnabled,
+        supportedResources: spec.deployment.supportedResources,
     };
 }
 export const specChangeTrigger = createDocumentChangeTrigger({
     id: 'spec-change',
     documentType: DOCUMENT_TYPE,
     // No documentId → watches ALL ph-clint-project docs
+    callOnEmpty: true, // bootstrap from disk when no documents exist yet
     async onChange(docs, ctx) {
         const log = ctx.context.log;
         const folders = ctx.context.folders;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@powerhousedao/ph-clint-cli",
-  "version": "0.1.0-dev.52",
+  "version": "0.1.0-dev.54",
   "publishConfig": {
     "access": "public"
   },
@@ -17,7 +17,7 @@
     "build": "pnpm build:skills && tsc",
     "dev": "tsx src/main.ts",
     "start": "node dist/main.js",
-    "test": "NODE_OPTIONS='--experimental-vm-modules' jest --detectOpenHandles",
+    "test": "NODE_OPTIONS='--experimental-vm-modules' jest --detectOpenHandles --coverage",
     "test:e2e": "NODE_OPTIONS='--experimental-vm-modules' jest --detectOpenHandles --testPathPatterns 'tests/(e2e|codegen-e2e)/' --testPathIgnorePatterns '/node_modules/'",
     "lint": "eslint src",
     "mastra:dev": "mastra dev",
@@ -29,13 +29,13 @@
     "@mastra/core": "^1.22.0",
     "@mastra/libsql": "^1.7.4",
     "@mastra/memory": "^1.13.1",
-    "@powerhousedao/ph-clint": "^0.1.0-dev.52",
-    "@powerhousedao/ph-clint-app": "^0.1.0-dev.52",
-    "@powerhousedao/ph-clint-dev": "^0.1.0-dev.52",
-    "@powerhousedao/reactor": "6.0.0-dev.170",
-    "@powerhousedao/reactor-api": "6.0.0-dev.170",
-    "@powerhousedao/shared": "6.0.0-dev.170",
-    "document-model": "6.0.0-dev.170",
+    "@powerhousedao/ph-clint": "^0.1.0-dev.54",
+    "@powerhousedao/ph-clint-app": "^0.1.0-dev.54",
+    "@powerhousedao/ph-clint-dev": "^0.1.0-dev.54",
+    "@powerhousedao/reactor": "6.0.0-dev.216",
+    "@powerhousedao/reactor-api": "6.0.0-dev.216",
+    "@powerhousedao/shared": "6.0.0-dev.216",
+    "document-model": "6.0.0-dev.216",
     "kysely": "^0.27.0",
     "kysely-pglite-dialect": "^1.3.0",
     "zod": "^4.3.6"