tryassay 0.13.0 → 0.15.0

package/dist/runtime/agents/planner-agent.d.ts

@@ -0,0 +1,18 @@
+import { SpecializedAgent, type TaskAssignmentPayload, type TaskResultPayload } from '../specialized-agent.js';
+import type { AgentMessage } from '../types.js';
+import type { MessageBus } from '../message-bus.js';
+export declare class PlannerAgent extends SpecializedAgent {
+    constructor(messageBus: MessageBus, opts?: {
+        model?: string;
+    });
+    protected onMessage(_message: AgentMessage): void;
+    executeTask(task: TaskAssignmentPayload): Promise<TaskResultPayload>;
+    private parsePlanResponse;
+    /**
+     * Try multiple strategies to extract JSON from LLM response:
+     * 1. Direct parse
+     * 2. Strip markdown code fences
+     * 3. Find first { ... } balanced block
+     */
+    private extractJson;
+}

package/dist/runtime/agents/planner-agent.js

@@ -0,0 +1,201 @@
+// ============================================================
+// Planner Agent — Designs application architecture
+// Produces ArchitecturePlan artifacts with verifiable claims
+// about schema completeness, API coverage, and dependency order.
+// ============================================================
+import { SpecializedAgent, } from '../specialized-agent.js';
+export class PlannerAgent extends SpecializedAgent {
+    constructor(messageBus, opts) {
+        super('planner-agent', 'planner', [
+            { name: 'architecture_design', description: 'Design full application architecture', tools: [] },
+            { name: 'schema_design', description: 'Design database schemas with relations', tools: [] },
+            { name: 'feature_decomposition', description: 'Decompose features into buildable units with dependency order', tools: [] },
+        ], messageBus, { model: opts?.model, initialTrust: 'untrusted' });
+    }
+    onMessage(_message) {
+        // Planner receives context from coordinator or research agent
+    }
+    async executeTask(task) {
+        const contextSnippets = task.contextRefs
+            .map(ref => `Context: ${ref.summary}\n${ref.content ?? ''}`)
+            .join('\n\n');
+        const systemPrompt = `You are a Planning Agent — a specialized AI that designs application architectures.
+
+Your job: Given an app description with tech stack, features, and constraints, produce a complete ArchitecturePlan.
+
+The plan MUST include:
+1. Schema entities with fields, types, and relations
+2. API routes with methods, paths, auth requirements, and request/response types
+3. Pages with paths, components, and auth requirements
+4. Features decomposed into buildable units with dependency order
+5. Auth plan if authentication is required
+6. Deploy config for the target platform
+
+Rules:
+1. The dependency order must be acyclic — features must be buildable in sequence.
+2. Auth features must come first in the dependency order.
+3. Every feature must reference its schema entities, API routes, and pages.
+4. Every schema entity must be referenced by at least one feature.
+5. Every API route must be referenced by at least one feature.
+6. State explicit claims about your plan's completeness — they will be verified.
+7. FEATURE GRANULARITY: Target 3-5 features total. Combine trivially related functionality into single features:
+   - Auth signup + login + logout + session management = one "authentication" feature
+   - All CRUD operations on a single entity = one feature (e.g., "todo-management")
+   - Landing page + layout + navigation = one "app-shell" feature
+   - A complexityEstimate of "trivial" is a code smell — merge trivial features into their parent feature.
+8. DEPENDENCY MINIMIZATION: If two features COULD be built independently, they SHOULD have empty dependsOn arrays. Maximize parallelism — only add dependencies when a feature literally cannot compile without another feature's output (e.g., todo-management depends on authentication because it needs the user session).
+
+Respond with JSON:
+{
+  "schema": [
+    {
+      "name": "...",
+      "fields": [{ "name": "...", "type": "...", "nullable": false, "primaryKey": true }],
+      "relations": [{ "target": "...", "type": "one-to-many", "foreignKey": "..." }]
+    }
+  ],
+  "apiRoutes": [
+    {
+      "method": "GET|POST|PUT|DELETE|PATCH",
+      "path": "/api/...",
+      "description": "...",
+      "auth": true,
+      "requestType": "...",
+      "responseType": "...",
+      "featureId": "..."
+    }
+  ],
+  "pages": [
+    {
+      "path": "/...",
+      "component": "...",
+      "auth": true,
+      "featureId": "...",
+      "description": "..."
+    }
+  ],
+  "features": [
+    {
+      "id": "feature-id",
+      "name": "...",
+      "dependsOn": ["other-feature-id"],
+      "schemaEntities": ["EntityName"],
+      "apiRoutes": ["/api/..."],
+      "pages": ["/..."],
+      "complexityEstimate": "trivial|small|medium|large"
+    }
+  ],
+  "dependencyOrder": ["feature-id-1", "feature-id-2", ...],
+  "authPlan": {
+    "provider": "...",
+    "methods": ["email", "google"],
+    "roles": ["user", "admin"],
+    "protectedRoutes": ["/dashboard", "/api/..."]
+  },
+  "deployConfig": {
+    "platform": "vercel",
+    "buildCommand": "npm run build",
+    "envVars": ["DATABASE_URL", "..."]
+  },
+  "summary": "...",
+  "claims": [
+    "Schema covers all N entities required by the features",
+    "API has M routes covering all CRUD operations",
+    "Dependency order is acyclic with auth first",
+    "Every feature references its schema entities and API routes"
+  ]
+}`;
+        const userPrompt = `TASK: ${task.goal}
+
+CONSTRAINTS:
+${task.constraints.map(c => `- ${c}`).join('\n')}
+
+CONTEXT:
+${contextSnippets || 'No additional context provided.'}
+
+Design the complete architecture now. Remember to state your claims explicitly.`;
+        try {
+            const { content } = await this.callClaude(systemPrompt, userPrompt);
+            const parsed = this.parsePlanResponse(content);
+            const features = Array.isArray(parsed.plan.features) ? parsed.plan.features : [];
+            const artifact = this.makeArtifact('architecture_plan', JSON.stringify(parsed.plan, null, 2), { metadata: { featureCount: features.length } });
+            return {
+                taskId: task.taskId,
+                status: 'completed',
+                artifacts: [artifact],
+                summary: parsed.summary,
+                claimsAboutArtifacts: parsed.claims,
+            };
+        }
+        catch (err) {
+            return {
+                taskId: task.taskId,
+                status: 'failed',
+                artifacts: [],
+                summary: `Architecture planning failed: ${err instanceof Error ? err.message : String(err)}`,
+                claimsAboutArtifacts: [],
+                blockers: [err instanceof Error ? err.message : String(err)],
+            };
+        }
+    }
+    parsePlanResponse(raw) {
+        const parsed = this.extractJson(raw);
+        if (parsed) {
+            return {
+                plan: {
+                    schema: Array.isArray(parsed.schema) ? parsed.schema : [],
+                    apiRoutes: Array.isArray(parsed.apiRoutes) ? parsed.apiRoutes : [],
+                    pages: Array.isArray(parsed.pages) ? parsed.pages : [],
+                    features: Array.isArray(parsed.features) ? parsed.features : [],
+                    dependencyOrder: Array.isArray(parsed.dependencyOrder) ? parsed.dependencyOrder : [],
+                    authPlan: parsed.authPlan ?? null,
+                    deployConfig: parsed.deployConfig ?? null,
+                },
+                summary: typeof parsed.summary === 'string' ? parsed.summary : 'Architecture plan generated',
+                claims: Array.isArray(parsed.claims) ? parsed.claims : [],
+            };
+        }
+        return {
+            plan: { schema: [], apiRoutes: [], pages: [], features: [], dependencyOrder: [] },
+            summary: 'Failed to parse architecture plan response',
+            claims: [],
+        };
+    }
+    /**
+     * Try multiple strategies to extract JSON from LLM response:
+     * 1. Direct parse
+     * 2. Strip markdown code fences
+     * 3. Find first { ... } balanced block
+     */
+    extractJson(raw) {
+        const cleaned = raw.trim();
+        // Strategy 1: Direct parse
+        try {
+            return JSON.parse(cleaned);
+        }
+        catch { /* continue */ }
+        // Strategy 2: Strip outermost markdown code fences
+        if (cleaned.startsWith('```')) {
+            const firstNewline = cleaned.indexOf('\n');
+            const lastFence = cleaned.lastIndexOf('```');
+            if (firstNewline > 0 && lastFence > firstNewline) {
+                const inner = cleaned.slice(firstNewline + 1, lastFence).trim();
+                try {
+                    return JSON.parse(inner);
+                }
+                catch { /* continue */ }
+            }
+        }
+        // Strategy 3: Find first { to last } and try parsing
+        const firstBrace = cleaned.indexOf('{');
+        const lastBrace = cleaned.lastIndexOf('}');
+        if (firstBrace >= 0 && lastBrace > firstBrace) {
+            try {
+                return JSON.parse(cleaned.slice(firstBrace, lastBrace + 1));
+            }
+            catch { /* continue */ }
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=planner-agent.js.map

package/dist/runtime/agents/planner-agent.js.map

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

package/dist/runtime/app-create-orchestrator.d.ts

@@ -0,0 +1,62 @@
+import { EventEmitter } from 'node:events';
+import type { AppDescription, AppCreateOptions, AppCreateResult } from './types.js';
+export declare class AppCreateOrchestrator extends EventEmitter {
+    private description;
+    private options;
+    private auditTrail;
+    private startTime;
+    constructor(description: AppDescription, options: AppCreateOptions);
+    /** Run the full app creation pipeline. */
+    run(): Promise<AppCreateResult>;
+    private runPlanningPhase;
+    private verifyPlanStructure;
+    private isAcyclic;
+    private runScaffoldingPhase;
+    private buildFeature;
+    private runCrossVerification;
+    /**
+     * Group features into waves based on dependency graph.
+     * Wave 0: features with no dependencies
+     * Wave N: features whose deps are all in waves < N
+     */
+    private computeWaves;
+    /**
+     * Build a feature using a single CodeAgent call — bypasses MultiAgentLoop.
+     * Used for trivial/small features where full team coordination is overkill.
+     */
+    private buildFeatureDirect;
+    /** Whether to use direct generation (single CodeAgent) vs full MultiAgentLoop.
+     *  For app creation (greenfield), direct mode is used for ALL features by default
+     *  since there's no existing codebase to review against and the architecture plan
+     *  already provides full context. Multi-agent mode adds overhead without proportional value. */
+    private shouldUseDirect;
+    /** Determine verification tier based on feature characteristics. */
+    private getVerificationTier;
+    /** Build the goal string for a feature (shared between buildFeature and buildFeatureDirect). */
+    private buildFeatureGoal;
+    /**
+     * Scan all generated source files for imports and ensure every
+     * external package is listed in package.json. Also merges any
+     * "package.additions.json" files that feature agents may have created.
+     */
+    private reconcileDependencies;
+    /**
+     * Generate .env.local from the architecture plan's deployConfig.envVars.
+     * Only creates the file if it doesn't already exist.
+     */
+    private generateEnvFile;
+    /** Return a sensible placeholder value for known env var patterns. */
+    private getEnvPlaceholder;
+    /** Recursively collect files with given extensions (or exact filename). */
+    private collectFiles;
+    private emitPhase;
+    private makeResult;
+    private audit;
+    private slugify;
+    /** Get framework-specific directory convention instruction for agent prompts. */
+    private getDirectoryConvention;
+    private routeToFilePath;
+    private pageToFilePath;
+    private fileExists;
+    private searchForSchemaEntity;
+}