@soleri/forge 5.14.10 → 8.0.0

package/dist/agent-schema.d.ts

@@ -0,0 +1,323 @@
+/**
+ * Soleri v7 — File-Tree Agent Schema
+ *
+ * Defines the agent.yaml format for file-tree agents.
+ * This replaces the old AgentConfigSchema that generated TypeScript projects.
+ *
+ * An agent is a folder. This schema defines agent.yaml — the single source
+ * of truth for identity and engine configuration.
+ */
+import { z } from 'zod';
+/** Communication tones */
+export declare const TONES: readonly ["precise", "mentor", "pragmatic"];
+export type Tone = (typeof TONES)[number];
+/** Where to set up client integration */
+export declare const SETUP_TARGETS: readonly ["claude", "codex", "opencode", "both", "all"];
+export type SetupTarget = (typeof SETUP_TARGETS)[number];
+/** Gate phases in a workflow */
+export declare const GATE_PHASES: readonly ["brainstorming", "pre-execution", "post-task", "completion"];
+export type GatePhase = (typeof GATE_PHASES)[number];
+/** Workflow gate definition (maps to gates.yaml) */
+export declare const WorkflowGateSchema: z.ZodObject<{
+    phase: z.ZodEnum<["brainstorming", "pre-execution", "post-task", "completion"]>;
+    requirement: z.ZodString;
+    check: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    phase: "brainstorming" | "pre-execution" | "post-task" | "completion";
+    requirement: string;
+    check: string;
+}, {
+    phase: "brainstorming" | "pre-execution" | "post-task" | "completion";
+    requirement: string;
+    check: string;
+}>;
+/** Task template ordering */
+export declare const TASK_ORDERS: readonly ["before-implementation", "after-implementation", "parallel"];
+/** Task template types */
+export declare const TASK_TYPES: readonly ["implementation", "test", "story", "documentation", "verification"];
+/** Workflow task template (injected during plan generation) */
+export declare const WorkflowTaskTemplateSchema: z.ZodObject<{
+    taskType: z.ZodEnum<["implementation", "test", "story", "documentation", "verification"]>;
+    titleTemplate: z.ZodString;
+    acceptanceCriteria: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+    tools: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+    order: z.ZodEnum<["before-implementation", "after-implementation", "parallel"]>;
+}, "strip", z.ZodTypeAny, {
+    taskType: "implementation" | "test" | "story" | "documentation" | "verification";
+    titleTemplate: string;
+    acceptanceCriteria: string[];
+    tools: string[];
+    order: "before-implementation" | "after-implementation" | "parallel";
+}, {
+    taskType: "implementation" | "test" | "story" | "documentation" | "verification";
+    titleTemplate: string;
+    order: "before-implementation" | "after-implementation" | "parallel";
+    acceptanceCriteria?: string[] | undefined;
+    tools?: string[] | undefined;
+}>;
+/** Workflow intent types */
+export declare const INTENTS: readonly ["BUILD", "FIX", "REVIEW", "PLAN", "IMPROVE", "DELIVER"];
+export type Intent = (typeof INTENTS)[number];
+/** Workflow definition (maps to workflow folder contents) */
+export declare const WorkflowDefinitionSchema: z.ZodObject<{
+    /** Unique workflow ID (derived from folder name if not specified) */
+    id: z.ZodOptional<z.ZodString>;
+    /** generic or domain tier */
+    tier: z.ZodDefault<z.ZodOptional<z.ZodEnum<["generic", "domain"]>>>;
+    /** Human-readable title */
+    title: z.ZodString;
+    /** When to activate this workflow */
+    trigger: z.ZodOptional<z.ZodString>;
+    /** What this workflow does */
+    description: z.ZodOptional<z.ZodString>;
+    /** Numbered step-by-step process (from prompt.md, parsed at runtime) */
+    steps: z.ZodOptional<z.ZodString>;
+    /** Success criteria */
+    expectedOutcome: z.ZodOptional<z.ZodString>;
+    /** ID of generic workflow this domain workflow extends */
+    extends: z.ZodOptional<z.ZodString>;
+    /** Domain filtering: skip UI playbooks for backend tasks */
+    domain: z.ZodDefault<z.ZodOptional<z.ZodEnum<["ui", "backend", "any"]>>>;
+    /** Intents that trigger this workflow */
+    matchIntents: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodEnum<["BUILD", "FIX", "REVIEW", "PLAN", "IMPROVE", "DELIVER"]>, "many">>>;
+    /** Keywords in plan text that trigger this workflow */
+    matchKeywords: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+    /** Lifecycle checkpoints */
+    gates: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+        phase: z.ZodEnum<["brainstorming", "pre-execution", "post-task", "completion"]>;
+        requirement: z.ZodString;
+        check: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        phase: "brainstorming" | "pre-execution" | "post-task" | "completion";
+        requirement: string;
+        check: string;
+    }, {
+        phase: "brainstorming" | "pre-execution" | "post-task" | "completion";
+        requirement: string;
+        check: string;
+    }>, "many">>>;
+    /** Task templates injected during plan generation */
+    taskTemplates: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+        taskType: z.ZodEnum<["implementation", "test", "story", "documentation", "verification"]>;
+        titleTemplate: z.ZodString;
+        acceptanceCriteria: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+        tools: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+        order: z.ZodEnum<["before-implementation", "after-implementation", "parallel"]>;
+    }, "strip", z.ZodTypeAny, {
+        taskType: "implementation" | "test" | "story" | "documentation" | "verification";
+        titleTemplate: string;
+        acceptanceCriteria: string[];
+        tools: string[];
+        order: "before-implementation" | "after-implementation" | "parallel";
+    }, {
+        taskType: "implementation" | "test" | "story" | "documentation" | "verification";
+        titleTemplate: string;
+        order: "before-implementation" | "after-implementation" | "parallel";
+        acceptanceCriteria?: string[] | undefined;
+        tools?: string[] | undefined;
+    }>, "many">>>;
+    /** Tools auto-added to plan's tool chain */
+    toolInjections: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+    /** Completion gate validation rules */
+    verificationCriteria: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+}, "strip", z.ZodTypeAny, {
+    domain: "ui" | "backend" | "any";
+    tier: "generic" | "domain";
+    title: string;
+    matchIntents: ("BUILD" | "FIX" | "REVIEW" | "PLAN" | "IMPROVE" | "DELIVER")[];
+    matchKeywords: string[];
+    gates: {
+        phase: "brainstorming" | "pre-execution" | "post-task" | "completion";
+        requirement: string;
+        check: string;
+    }[];
+    taskTemplates: {
+        taskType: "implementation" | "test" | "story" | "documentation" | "verification";
+        titleTemplate: string;
+        acceptanceCriteria: string[];
+        tools: string[];
+        order: "before-implementation" | "after-implementation" | "parallel";
+    }[];
+    toolInjections: string[];
+    verificationCriteria: string[];
+    id?: string | undefined;
+    trigger?: string | undefined;
+    description?: string | undefined;
+    steps?: string | undefined;
+    expectedOutcome?: string | undefined;
+    extends?: string | undefined;
+}, {
+    title: string;
+    id?: string | undefined;
+    domain?: "ui" | "backend" | "any" | undefined;
+    tier?: "generic" | "domain" | undefined;
+    trigger?: string | undefined;
+    description?: string | undefined;
+    steps?: string | undefined;
+    expectedOutcome?: string | undefined;
+    extends?: string | undefined;
+    matchIntents?: ("BUILD" | "FIX" | "REVIEW" | "PLAN" | "IMPROVE" | "DELIVER")[] | undefined;
+    matchKeywords?: string[] | undefined;
+    gates?: {
+        phase: "brainstorming" | "pre-execution" | "post-task" | "completion";
+        requirement: string;
+        check: string;
+    }[] | undefined;
+    taskTemplates?: {
+        taskType: "implementation" | "test" | "story" | "documentation" | "verification";
+        titleTemplate: string;
+        order: "before-implementation" | "after-implementation" | "parallel";
+        acceptanceCriteria?: string[] | undefined;
+        tools?: string[] | undefined;
+    }[] | undefined;
+    toolInjections?: string[] | undefined;
+    verificationCriteria?: string[] | undefined;
+}>;
+/**
+ * agent.yaml schema — the single source of truth for a file-tree agent.
+ *
+ * This is what `soleri create` generates and what the engine reads on startup.
+ */
+export declare const AgentYamlSchema: z.ZodObject<{
+    /** Agent identifier — kebab-case, used for directories and tool prefixes */
+    id: z.ZodString;
+    /** Human-readable display name */
+    name: z.ZodString;
+    /** One-line role description */
+    role: z.ZodString;
+    /** Longer description of capabilities */
+    description: z.ZodString;
+    /** Knowledge domains (1–20) */
+    domains: z.ZodArray<z.ZodString, "many">;
+    /** Core principles (1–10) */
+    principles: z.ZodArray<z.ZodString, "many">;
+    /** Communication tone */
+    tone: z.ZodDefault<z.ZodOptional<z.ZodEnum<["precise", "mentor", "pragmatic"]>>>;
+    /** Greeting message (auto-generated if omitted) */
+    greeting: z.ZodOptional<z.ZodString>;
+    /** Knowledge engine configuration */
+    engine: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+        /** Path to agent's vault SQLite database. Default: ~/.{id}/vault.db */
+        vault: z.ZodOptional<z.ZodString>;
+        /** Enable brain/learning loop. Default: true */
+        learning: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        /** Enable Cognee vector search. Default: false */
+        cognee: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    }, "strip", z.ZodTypeAny, {
+        learning: boolean;
+        cognee: boolean;
+        vault?: string | undefined;
+    }, {
+        vault?: string | undefined;
+        learning?: boolean | undefined;
+        cognee?: boolean | undefined;
+    }>>>;
+    /** Link to external vaults for shared knowledge */
+    vaults: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        /** Display name for this vault */
+        name: z.ZodString;
+        /** Absolute path to vault SQLite database */
+        path: z.ZodString;
+        /** Search priority (0–1). Higher = results ranked higher. Default: 0.5 */
+        priority: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        name: string;
+        priority: number;
+    }, {
+        path: string;
+        name: string;
+        priority?: number | undefined;
+    }>, "many">>;
+    /** LLM client integration settings */
+    setup: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+        /** Target client for MCP registration */
+        target: z.ZodDefault<z.ZodOptional<z.ZodEnum<["claude", "codex", "opencode", "both", "all"]>>>;
+        /** Primary model for the client */
+        model: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        target: "claude" | "codex" | "opencode" | "both" | "all";
+        model: string;
+    }, {
+        target?: "claude" | "codex" | "opencode" | "both" | "all" | undefined;
+        model?: string | undefined;
+    }>>>;
+    /** npm domain packs with custom ops and knowledge */
+    packs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        /** Domain name (e.g., "design", "code-review") */
+        name: z.ZodString;
+        /** npm package name (e.g., "@soleri/domain-design") */
+        package: z.ZodString;
+        /** Semver version constraint (optional) */
+        version: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        package: string;
+        version?: string | undefined;
+    }, {
+        name: string;
+        package: string;
+        version?: string | undefined;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    description: string;
+    name: string;
+    role: string;
+    domains: string[];
+    principles: string[];
+    tone: "precise" | "mentor" | "pragmatic";
+    engine: {
+        learning: boolean;
+        cognee: boolean;
+        vault?: string | undefined;
+    };
+    setup: {
+        target: "claude" | "codex" | "opencode" | "both" | "all";
+        model: string;
+    };
+    greeting?: string | undefined;
+    vaults?: {
+        path: string;
+        name: string;
+        priority: number;
+    }[] | undefined;
+    packs?: {
+        name: string;
+        package: string;
+        version?: string | undefined;
+    }[] | undefined;
+}, {
+    id: string;
+    description: string;
+    name: string;
+    role: string;
+    domains: string[];
+    principles: string[];
+    tone?: "precise" | "mentor" | "pragmatic" | undefined;
+    greeting?: string | undefined;
+    engine?: {
+        vault?: string | undefined;
+        learning?: boolean | undefined;
+        cognee?: boolean | undefined;
+    } | undefined;
+    vaults?: {
+        path: string;
+        name: string;
+        priority?: number | undefined;
+    }[] | undefined;
+    setup?: {
+        target?: "claude" | "codex" | "opencode" | "both" | "all" | undefined;
+        model?: string | undefined;
+    } | undefined;
+    packs?: {
+        name: string;
+        package: string;
+        version?: string | undefined;
+    }[] | undefined;
+}>;
+export type AgentYaml = z.infer<typeof AgentYamlSchema>;
+export type AgentYamlInput = z.input<typeof AgentYamlSchema>;
+export type WorkflowDefinition = z.infer<typeof WorkflowDefinitionSchema>;
+export type WorkflowGate = z.infer<typeof WorkflowGateSchema>;
+export type WorkflowTaskTemplate = z.infer<typeof WorkflowTaskTemplateSchema>;

package/dist/agent-schema.js

@@ -0,0 +1,151 @@
+/**
+ * Soleri v7 — File-Tree Agent Schema
+ *
+ * Defines the agent.yaml format for file-tree agents.
+ * This replaces the old AgentConfigSchema that generated TypeScript projects.
+ *
+ * An agent is a folder. This schema defines agent.yaml — the single source
+ * of truth for identity and engine configuration.
+ */
+import { z } from 'zod';
+// ─── Constants ────────────────────────────────────────────────────────
+/** Communication tones */
+export const TONES = ['precise', 'mentor', 'pragmatic'];
+/** Where to set up client integration */
+export const SETUP_TARGETS = ['claude', 'codex', 'opencode', 'both', 'all'];
+// ─── Sub-Schemas ──────────────────────────────────────────────────────
+/** External vault connection */
+const VaultConnectionSchema = z.object({
+    /** Display name for this vault */
+    name: z.string().min(1),
+    /** Absolute path to vault SQLite database */
+    path: z.string().min(1),
+    /** Search priority (0–1). Higher = results ranked higher. Default: 0.5 */
+    priority: z.number().min(0).max(1).optional().default(0.5),
+});
+/** Domain pack reference */
+const DomainPackSchema = z.object({
+    /** Domain name (e.g., "design", "code-review") */
+    name: z.string().min(1),
+    /** npm package name (e.g., "@soleri/domain-design") */
+    package: z.string().min(1),
+    /** Semver version constraint (optional) */
+    version: z.string().optional(),
+});
+/** Engine configuration */
+const EngineConfigSchema = z.object({
+    /** Path to agent's vault SQLite database. Default: ~/.{id}/vault.db */
+    vault: z.string().optional(),
+    /** Enable brain/learning loop. Default: true */
+    learning: z.boolean().optional().default(true),
+    /** Enable Cognee vector search. Default: false */
+    cognee: z.boolean().optional().default(false),
+});
+/** Client setup configuration */
+const SetupConfigSchema = z.object({
+    /** Target client for MCP registration */
+    target: z.enum(SETUP_TARGETS).optional().default('claude'),
+    /** Primary model for the client */
+    model: z.string().optional().default('claude-code-sonnet-4'),
+});
+// ─── Workflow Sub-Schemas ─────────────────────────────────────────────
+/** Gate phases in a workflow */
+export const GATE_PHASES = ['brainstorming', 'pre-execution', 'post-task', 'completion'];
+/** Workflow gate definition (maps to gates.yaml) */
+export const WorkflowGateSchema = z.object({
+    phase: z.enum(GATE_PHASES),
+    requirement: z.string().min(1),
+    check: z.string().min(1),
+});
+/** Task template ordering */
+export const TASK_ORDERS = ['before-implementation', 'after-implementation', 'parallel'];
+/** Task template types */
+export const TASK_TYPES = [
+    'implementation',
+    'test',
+    'story',
+    'documentation',
+    'verification',
+];
+/** Workflow task template (injected during plan generation) */
+export const WorkflowTaskTemplateSchema = z.object({
+    taskType: z.enum(TASK_TYPES),
+    titleTemplate: z.string().min(1),
+    acceptanceCriteria: z.array(z.string()).optional().default([]),
+    tools: z.array(z.string()).optional().default([]),
+    order: z.enum(TASK_ORDERS),
+});
+/** Workflow intent types */
+export const INTENTS = ['BUILD', 'FIX', 'REVIEW', 'PLAN', 'IMPROVE', 'DELIVER'];
+/** Workflow definition (maps to workflow folder contents) */
+export const WorkflowDefinitionSchema = z.object({
+    /** Unique workflow ID (derived from folder name if not specified) */
+    id: z.string().optional(),
+    /** generic or domain tier */
+    tier: z.enum(['generic', 'domain']).optional().default('generic'),
+    /** Human-readable title */
+    title: z.string().min(1),
+    /** When to activate this workflow */
+    trigger: z.string().optional(),
+    /** What this workflow does */
+    description: z.string().optional(),
+    /** Numbered step-by-step process (from prompt.md, parsed at runtime) */
+    steps: z.string().optional(),
+    /** Success criteria */
+    expectedOutcome: z.string().optional(),
+    /** ID of generic workflow this domain workflow extends */
+    extends: z.string().optional(),
+    /** Domain filtering: skip UI playbooks for backend tasks */
+    domain: z.enum(['ui', 'backend', 'any']).optional().default('any'),
+    /** Intents that trigger this workflow */
+    matchIntents: z.array(z.enum(INTENTS)).optional().default([]),
+    /** Keywords in plan text that trigger this workflow */
+    matchKeywords: z.array(z.string()).optional().default([]),
+    /** Lifecycle checkpoints */
+    gates: z.array(WorkflowGateSchema).optional().default([]),
+    /** Task templates injected during plan generation */
+    taskTemplates: z.array(WorkflowTaskTemplateSchema).optional().default([]),
+    /** Tools auto-added to plan's tool chain */
+    toolInjections: z.array(z.string()).optional().default([]),
+    /** Completion gate validation rules */
+    verificationCriteria: z.array(z.string()).optional().default([]),
+});
+// ─── Main Agent Schema ────────────────────────────────────────────────
+/**
+ * agent.yaml schema — the single source of truth for a file-tree agent.
+ *
+ * This is what `soleri create` generates and what the engine reads on startup.
+ */
+export const AgentYamlSchema = z.object({
+    // ─── Identity (required) ────────────────────────
+    /** Agent identifier — kebab-case, used for directories and tool prefixes */
+    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 capabilities */
+    description: z.string().min(10).max(500),
+    /** Knowledge domains (1–20) */
+    domains: z.array(z.string().min(1)).min(1).max(20),
+    /** Core principles (1–10) */
+    principles: z.array(z.string().min(1)).min(1).max(10),
+    // ─── Personality (optional) ─────────────────────
+    /** Communication tone */
+    tone: z.enum(TONES).optional().default('pragmatic'),
+    /** Greeting message (auto-generated if omitted) */
+    greeting: z.string().min(10).max(300).optional(),
+    // ─── Engine ─────────────────────────────────────
+    /** Knowledge engine configuration */
+    engine: EngineConfigSchema.optional().default({}),
+    // ─── Vault Connections ──────────────────────────
+    /** Link to external vaults for shared knowledge */
+    vaults: z.array(VaultConnectionSchema).optional(),
+    // ─── Client Setup ──────────────────────────────
+    /** LLM client integration settings */
+    setup: SetupConfigSchema.optional().default({}),
+    // ─── Domain Packs ──────────────────────────────
+    /** npm domain packs with custom ops and knowledge */
+    packs: z.array(DomainPackSchema).optional(),
+});
+//# sourceMappingURL=agent-schema.js.map

package/dist/agent-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-schema.js","sourceRoot":"","sources":["../src/agent-schema.ts"],"names":[],"mappings":"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"}

package/dist/compose-claude-md.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Soleri v7 — CLAUDE.md Composer
+ *
+ * Auto-generates CLAUDE.md from agent.yaml + instructions/ + workflows/ + skills/.
+ * This file is never manually edited. `soleri dev` watches and regenerates on change.
+ */
+export interface ComposedClaudeMd {
+    /** The full CLAUDE.md content */
+    content: string;
+    /** Files that contributed to this composition */
+    sources: string[];
+}
+export interface ToolEntry {
+    facade: string;
+    ops: string[];
+}
+/**
+ * Compose CLAUDE.md from an agent folder.
+ *
+ * @param agentDir - Path to the agent folder (containing agent.yaml)
+ * @param tools - Registered MCP tools (from engine introspection). Optional —
+ *                if not provided, generates a placeholder table.
+ */
+export declare function composeClaudeMd(agentDir: string, tools?: ToolEntry[]): ComposedClaudeMd;