@soleri/forge 0.0.1 → 4.0.0

package/src/templates/vitest-config.ts

@@ -0,0 +1,26 @@
+export function generateVitestConfig(): string {
+  return `import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  test: {
+    environment: 'node',
+    pool: 'forks',
+    poolOptions: {
+      forks: {
+        singleFork: true,
+        maxForks: 2,
+        minForks: 1,
+      },
+    },
+    testTimeout: 30_000,
+    hookTimeout: 10_000,
+    teardownTimeout: 5_000,
+    coverage: {
+      provider: 'v8',
+      include: ['src/**/*.ts'],
+      exclude: ['src/**/*.test.ts', 'src/__tests__/**', 'src/index.ts'],
+    },
+  },
+});
+`;
+}

package/src/types.ts

@@ -0,0 +1,68 @@
+import { z } from 'zod';
+
+/** Agent configuration — everything needed to scaffold */
+export const AgentConfigSchema = z.object({
+  /** Agent identifier (kebab-case, used for directory and package name) */
+  id: z.string().regex(/^[a-z][a-z0-9-]*$/, 'Must be kebab-case (e.g., "gaudi", "my-agent")'),
+  /** Human-readable display name */
+  name: z.string().min(1).max(50),
+  /** One-line role description */
+  role: z.string().min(1).max(100),
+  /** Longer description of what this agent does */
+  description: z.string().min(10).max(500),
+  /** Knowledge domains this agent covers */
+  domains: z.array(z.string().min(1)).min(1).max(20),
+  /** Core principles the agent follows (3-7 recommended) */
+  principles: z.array(z.string()).min(1).max(10),
+  /** Greeting message when agent introduces itself */
+  greeting: z.string().min(10).max(300),
+  /** Output directory (parent — agent dir will be created inside) */
+  outputDir: z.string().min(1),
+});
+
+export type AgentConfig = z.infer<typeof AgentConfigSchema>;
+
+/** Result of scaffolding */
+export interface ScaffoldResult {
+  success: boolean;
+  agentDir: string;
+  filesCreated: string[];
+  domains: string[];
+  summary: string;
+}
+
+/** Agent info for listing */
+export interface AgentInfo {
+  id: string;
+  name: string;
+  role: string;
+  path: string;
+  domains: string[];
+  hasNodeModules: boolean;
+  hasDistDir: boolean;
+}
+
+/** Preview of what will be created */
+export interface ScaffoldPreview {
+  agentDir: string;
+  files: Array<{ path: string; description: string }>;
+  facades: Array<{ name: string; ops: string[] }>;
+  domains: string[];
+  persona: { name: string; role: string };
+}
+
+/** Result of installing knowledge packs into an existing agent */
+export interface InstallKnowledgeResult {
+  success: boolean;
+  agentPath: string;
+  agentId: string;
+  bundlesInstalled: number;
+  entriesTotal: number;
+  domainsAdded: string[];
+  domainsUpdated: string[];
+  facadesGenerated: string[];
+  sourceFilesPatched: string[];
+  buildOutput: string;
+  warnings: string[];
+  summary: string;
+}

package/tsconfig.json

@@ -0,0 +1,21 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "lib": ["ES2022"],
+    "outDir": "dist",
+    "rootDir": "src",
+    "strict": true,
+    "esModuleInterop": true,
+    "resolveJsonModule": true,
+    "declaration": true,
+    "sourceMap": true,
+    "forceConsistentCasingInFileNames": true,
+    "skipLibCheck": true,
+    "noEmitOnError": true,
+    "composite": true
+  },
+  "include": ["src/**/*.ts"],
+  "exclude": ["node_modules", "dist", "src/**/*.test.ts", "src/__tests__/**"]
+}

package/vitest.config.ts

@@ -0,0 +1,15 @@
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  test: {
+    environment: 'node',
+    pool: 'forks',
+    poolOptions: { forks: { singleFork: true } },
+    testTimeout: 30_000,
+    coverage: {
+      provider: 'v8',
+      include: ['src/**/*.ts'],
+      exclude: ['src/**/*.test.ts', 'src/__tests__/**', 'src/index.ts'],
+    },
+  },
+});