@mcoda/core 0.1.7 → 0.1.9

package/CHANGELOG.md

@@ -3,5 +3,8 @@
 ## Unreleased
 - Initial public packaging for @mcoda/core.
 
-## 0.1.7
+## 0.1.9
+- Release v0.1.9.
+
+## 0.1.8
 - Initial release.

package/README.md

@@ -1,9 +1,28 @@
 # @mcoda/core
 
-Core services and APIs used by the mcoda CLI.
+Core services that power the mcoda CLI (docs, planning, jobs, telemetry, openapi).
 
-## Usage
-This package is primarily an internal dependency of `mcoda`.
+## Install
+- Requires Node.js >= 20.
+- Install: `npm i @mcoda/core`
+
+## What it provides
+- WorkspaceResolver for discovering/initializing `.mcoda` workspaces.
+- Service layer for docs, planning, execution, review, telemetry, and system updates.
+- API wrappers (AgentsApi, TasksApi, QaTasksApi) used by the CLI.
+
+## Example
+```ts
+import { WorkspaceResolver, JobService } from "@mcoda/core";
+
+const workspace = await WorkspaceResolver.resolveWorkspace({ cwd: process.cwd() });
+const jobs = new JobService(workspace);
+// Use jobs to record command runs, token usage, and job state.
+```
+
+## Notes
+- Most services expect a resolved workspace and read/write `.mcoda/` state.
+- Primarily used by the mcoda CLI; APIs may evolve.
 
 ## License
 MIT - see `LICENSE`.

package/dist/api/AgentsApi.d.ts

@@ -1,5 +1,5 @@
 import { Agent, AgentAuthMetadata, AgentHealth, AgentPromptManifest, CreateAgentInput, UpdateAgentInput } from "@mcoda/shared";
-import { GlobalRepository } from "@mcoda/db";
+import { AgentRunRatingRow, GlobalRepository } from "@mcoda/db";
 import { AgentService, InvocationResult } from "@mcoda/agents";
 import { RoutingService } from "../services/agents/RoutingService.js";
 export interface AgentResponse extends Agent {
@@ -19,6 +19,7 @@ export declare class AgentsApi {
     private resolveAgent;
     private withCommandRun;
     listAgents(): Promise<AgentResponse[]>;
+    listAgentRunRatings(idOrSlug: string, limit?: number): Promise<AgentRunRatingRow[]>;
     createAgent(input: CreateAgentInput): Promise<AgentResponse>;
     getAgent(idOrSlug: string): Promise<AgentResponse>;
     updateAgent(idOrSlug: string, patch: UpdateAgentInput): Promise<AgentResponse>;
@@ -31,6 +32,12 @@ export declare class AgentsApi {
         response: InvocationResult;
         prompt: string;
     }>;
+    private extractTokenUsage;
+    runAgent(idOrSlug: string, prompts: string[], metadata?: Record<string, unknown>): Promise<{
+        agent: Pick<Agent, "id" | "slug">;
+        prompts: string[];
+        responses: InvocationResult[];
+    }>;
     setDefaultAgent(idOrSlug: string, workspaceId?: string, commandName?: string): Promise<void>;
 }
 //# sourceMappingURL=AgentsApi.d.ts.map

package/dist/api/AgentsApi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AgentsApi.d.ts","sourceRoot":"","sources":["../../src/api/AgentsApi.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,EACL,iBAAiB,EACjB,WAAW,EACX,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EAEjB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAoB,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AAEtE,MAAM,WAAW,aAAc,SAAQ,KAAK;IAC1C,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB,MAAM,CAAC,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;CAC1B;AAED,qBAAa,SAAS;IACR,OAAO,CAAC,IAAI;IAAoB,OAAO,CAAC,YAAY;IAAgB,OAAO,CAAC,cAAc;gBAAlF,IAAI,EAAE,gBAAgB,EAAU,YAAY,EAAE,YAAY,EAAU,cAAc,EAAE,cAAc;WAEzG,MAAM,IAAI,OAAO,CAAC,SAAS,CAAC;IAOnC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAOd,YAAY;YAIZ,cAAc;IA+BtB,UAAU,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAoBtC,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,aAAa,CAAC;IAW5D,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAYlD,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,aAAa,CAAC;IAY9E,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB3D,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAS1E,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC;IAK3E,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAkBjD,UAAU,CACd,QAAQ,EAAE,MAAM,EAChB,MAAM,SAA4E,GACjF,OAAO,CAAC;QAAE,MAAM,EAAE,WAAW,CAAC;QAAC,QAAQ,EAAE,gBAAgB,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IA2BzE,eAAe,CACnB,QAAQ,EAAE,MAAM,EAChB,WAAW,SAAe,EAC1B,WAAW,SAAY,GACtB,OAAO,CAAC,IAAI,CAAC;CAMjB"}
+{"version":3,"file":"AgentsApi.d.ts","sourceRoot":"","sources":["../../src/api/AgentsApi.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,EACL,iBAAiB,EACjB,WAAW,EACX,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EAEjB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,iBAAiB,EAAoB,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAClF,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AAEtE,MAAM,WAAW,aAAc,SAAQ,KAAK;IAC1C,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB,MAAM,CAAC,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;CAC1B;AAED,qBAAa,SAAS;IACR,OAAO,CAAC,IAAI;IAAoB,OAAO,CAAC,YAAY;IAAgB,OAAO,CAAC,cAAc;gBAAlF,IAAI,EAAE,gBAAgB,EAAU,YAAY,EAAE,YAAY,EAAU,cAAc,EAAE,cAAc;WAEzG,MAAM,IAAI,OAAO,CAAC,SAAS,CAAC;IAOnC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAOd,YAAY;YAIZ,cAAc;IA+BtB,UAAU,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAoBtC,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAK/E,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,aAAa,CAAC;IAW5D,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAYlD,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,aAAa,CAAC;IAY9E,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB3D,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAS1E,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC;IAK3E,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAkBjD,UAAU,CACd,QAAQ,EAAE,MAAM,EAChB,MAAM,SAA4E,GACjF,OAAO,CAAC;QAAE,MAAM,EAAE,WAAW,CAAC;QAAC,QAAQ,EAAE,gBAAgB,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IA2B/E,OAAO,CAAC,iBAAiB;IAiCnB,QAAQ,CACZ,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EAAE,EACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC;QAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,CAAC,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,SAAS,EAAE,gBAAgB,EAAE,CAAA;KAAE,CAAC;IA8C7F,eAAe,CACnB,QAAQ,EAAE,MAAM,EAChB,WAAW,SAAe,EAC1B,WAAW,SAAY,GACtB,OAAO,CAAC,IAAI,CAAC;CAMjB"}

package/dist/api/AgentsApi.js

@@ -69,6 +69,10 @@ export class AgentsApi {
         }
         return results;
     }
+    async listAgentRunRatings(idOrSlug, limit = 50) {
+        const agent = await this.resolveAgent(idOrSlug);
+        return this.repo.listAgentRunRatings(agent.id, limit);
+    }
     async createAgent(input) {
         return this.withCommandRun("agent.add", { slug: input.slug, adapter: input.adapter }, async () => {
             const agent = await this.repo.createAgent(input);
@@ -167,6 +171,72 @@ export class AgentsApi {
             return { health, response, prompt: trimmedPrompt };
         });
     }
+    extractTokenUsage(metadata) {
+        if (!metadata || typeof metadata !== "object")
+            return {};
+        const usage = typeof metadata.usage === "object" && metadata.usage ? metadata.usage : undefined;
+        const toNumber = (value) => typeof value === "number" && Number.isFinite(value) ? value : undefined;
+        const tokensPrompt = toNumber(metadata.tokensPrompt) ??
+            toNumber(metadata.tokens_prompt) ??
+            toNumber(usage?.prompt_tokens) ??
+            toNumber(usage?.promptTokens) ??
+            toNumber(usage?.prompt_tokens);
+        const tokensCompletion = toNumber(metadata.tokensCompletion) ??
+            toNumber(metadata.tokens_completion) ??
+            toNumber(usage?.completion_tokens) ??
+            toNumber(usage?.completionTokens) ??
+            toNumber(usage?.completion_tokens);
+        let tokensTotal = toNumber(metadata.tokensTotal) ??
+            toNumber(metadata.tokens_total) ??
+            toNumber(usage?.total_tokens) ??
+            toNumber(usage?.totalTokens) ??
+            toNumber(usage?.total_tokens);
+        if (tokensTotal === undefined && tokensPrompt !== undefined && tokensCompletion !== undefined) {
+            tokensTotal = tokensPrompt + tokensCompletion;
+        }
+        return { tokensPrompt, tokensCompletion, tokensTotal };
+    }
+    async runAgent(idOrSlug, prompts, metadata) {
+        const agent = await this.resolveAgent(idOrSlug);
+        const cleaned = prompts.map((prompt) => prompt.trim()).filter(Boolean);
+        if (cleaned.length === 0) {
+            throw new Error("No prompts provided.");
+        }
+        return this.withCommandRun("agent.run", { id: agent.id, slug: agent.slug, promptCount: cleaned.length }, async (run) => {
+            const responses = [];
+            for (let index = 0; index < cleaned.length; index += 1) {
+                const input = cleaned[index];
+                const startedAt = Date.now();
+                const response = await this.agentService.invoke(agent.id, {
+                    input,
+                    metadata: {
+                        command: "agent-run",
+                        promptIndex: index,
+                        ...metadata,
+                    },
+                });
+                const durationSeconds = (Date.now() - startedAt) / 1000;
+                const usage = this.extractTokenUsage(response.metadata);
+                await this.repo.recordTokenUsage({
+                    agentId: agent.id,
+                    commandRunId: run.id,
+                    modelName: response.model ?? agent.defaultModel,
+                    tokensPrompt: usage.tokensPrompt,
+                    tokensCompletion: usage.tokensCompletion,
+                    tokensTotal: usage.tokensTotal,
+                    durationSeconds,
+                    timestamp: new Date().toISOString(),
+                    metadata: {
+                        reason: "agent.run",
+                        adapter: response.adapter,
+                        promptIndex: index,
+                    },
+                });
+                responses.push(response);
+            }
+            return { agent: { id: agent.id, slug: agent.slug }, prompts: cleaned, responses };
+        });
+    }
     async setDefaultAgent(idOrSlug, workspaceId = "__GLOBAL__", commandName = "default") {
         const agent = await this.resolveAgent(idOrSlug);
         await this.withCommandRun("agent.set-default", { workspaceId, commandName, agent: agent.slug }, async () => {

package/dist/api/QaTasksApi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"QaTasksApi.d.ts","sourceRoot":"","sources":["../../src/api/QaTasksApi.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,cAAc,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAE1G,qBAAa,UAAU;WACR,KAAK,CAChB,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG;QAAE,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,GACnF,OAAO,CAAC,eAAe,CAAC;CA+B5B"}
+{"version":3,"file":"QaTasksApi.d.ts","sourceRoot":"","sources":["../../src/api/QaTasksApi.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,cAAc,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAE1G,qBAAa,UAAU;WACR,KAAK,CAChB,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG;QAAE,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,GACnF,OAAO,CAAC,eAAe,CAAC;CAiC5B"}

package/dist/api/QaTasksApi.js

@@ -22,11 +22,13 @@ export class QaTasksApi {
                 testCommand: request.testCommand,
                 agentName: request.agentName,
                 agentStream: request.agentStream,
+                rateAgents: request.rateAgents,
                 createFollowupTasks: request.createFollowupTasks,
                 dryRun: request.dryRun,
                 result: request.result,
                 notes: request.notes,
                 evidenceUrl: request.evidenceUrl,
+                allowDirty: request.allowDirty,
             });
         }
         finally {

package/dist/api/TasksApi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TasksApi.d.ts","sourceRoot":"","sources":["../../src/api/TasksApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAItE,qBAAa,QAAQ;WACN,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG;QAAE,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC;CA6B/G"}
+{"version":3,"file":"TasksApi.d.ts","sourceRoot":"","sources":["../../src/api/TasksApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAItE,qBAAa,QAAQ;WACN,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG;QAAE,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC;CA8B/G"}

package/dist/api/TasksApi.js

@@ -19,6 +19,7 @@ export class TasksApi {
                 strategy: request.strategy,
                 agentName: request.agentIdOverride,
                 agentStream: true,
+                rateAgents: request.rateAgents,
                 fromDb: true,
                 dryRun: request.dryRun,
                 planInPath: request.planInPath,

package/dist/index.d.ts

@@ -11,6 +11,7 @@ export * from "./services/execution/TaskSelectionService.js";
 export * from "./services/execution/TaskStateService.js";
 export * from "./services/execution/WorkOnTasksService.js";
 export * from "./services/execution/QaTasksService.js";
+export * from "./services/execution/GatewayTrioService.js";
 export * from "./services/review/CodeReviewService.js";
 export * from "./api/TasksApi.js";
 export * from "./api/QaTasksApi.js";
@@ -23,6 +24,9 @@ export * from "./services/tasks/TaskDetailService.js";
 export * from "./services/backlog/TaskOrderingService.js";
 export * from "./services/agents/RoutingService.js";
 export * from "./services/agents/GatewayAgentService.js";
+export * from "./services/agents/GatewayHandoff.js";
+export * from "./services/agents/AgentRatingService.js";
+export * from "./services/agents/AgentRatingFormula.js";
 export * from "./workspace/WorkspaceManager.js";
 export * from "./services/system/SystemUpdateService.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,sCAAsC,CAAC;AACrD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uCAAuC,CAAC;AACtD,cAAc,qCAAqC,CAAC;AACpD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,mCAAmC,CAAC;AAClD,cAAc,8CAA8C,CAAC;AAC7D,cAAc,0CAA0C,CAAC;AACzD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,wCAAwC,CAAC;AACvD,cAAc,wCAAwC,CAAC;AACvD,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sCAAsC,CAAC;AACrD,cAAc,wCAAwC,CAAC;AACvD,cAAc,wCAAwC,CAAC;AACvD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0CAA0C,CAAC;AACzD,cAAc,uCAAuC,CAAC;AACtD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,qCAAqC,CAAC;AACpD,cAAc,0CAA0C,CAAC;AACzD,cAAc,iCAAiC,CAAC;AAChD,cAAc,0CAA0C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,sCAAsC,CAAC;AACrD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uCAAuC,CAAC;AACtD,cAAc,qCAAqC,CAAC;AACpD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,mCAAmC,CAAC;AAClD,cAAc,8CAA8C,CAAC;AAC7D,cAAc,0CAA0C,CAAC;AACzD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,wCAAwC,CAAC;AACvD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,wCAAwC,CAAC;AACvD,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sCAAsC,CAAC;AACrD,cAAc,wCAAwC,CAAC;AACvD,cAAc,wCAAwC,CAAC;AACvD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0CAA0C,CAAC;AACzD,cAAc,uCAAuC,CAAC;AACtD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,qCAAqC,CAAC;AACpD,cAAc,0CAA0C,CAAC;AACzD,cAAc,qCAAqC,CAAC;AACpD,cAAc,yCAAyC,CAAC;AACxD,cAAc,yCAAyC,CAAC;AACxD,cAAc,iCAAiC,CAAC;AAChD,cAAc,0CAA0C,CAAC"}

package/dist/index.js

@@ -11,6 +11,7 @@ export * from "./services/execution/TaskSelectionService.js";
 export * from "./services/execution/TaskStateService.js";
 export * from "./services/execution/WorkOnTasksService.js";
 export * from "./services/execution/QaTasksService.js";
+export * from "./services/execution/GatewayTrioService.js";
 export * from "./services/review/CodeReviewService.js";
 export * from "./api/TasksApi.js";
 export * from "./api/QaTasksApi.js";
@@ -23,5 +24,8 @@ export * from "./services/tasks/TaskDetailService.js";
 export * from "./services/backlog/TaskOrderingService.js";
 export * from "./services/agents/RoutingService.js";
 export * from "./services/agents/GatewayAgentService.js";
+export * from "./services/agents/GatewayHandoff.js";
+export * from "./services/agents/AgentRatingService.js";
+export * from "./services/agents/AgentRatingFormula.js";
 export * from "./workspace/WorkspaceManager.js";
 export * from "./services/system/SystemUpdateService.js";

package/dist/prompts/PdrPrompts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PdrPrompts.d.ts","sourceRoot":"","sources":["../../src/prompts/PdrPrompts.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,sBAAsB,QAI3B,CAAC;AAET,eAAO,MAAM,4BAA4B,QAEjC,CAAC;AAET,eAAO,MAAM,0BAA0B,QAY/B,CAAC"}
+{"version":3,"file":"PdrPrompts.d.ts","sourceRoot":"","sources":["../../src/prompts/PdrPrompts.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,sBAAsB,QAK3B,CAAC;AAET,eAAO,MAAM,4BAA4B,QAEjC,CAAC;AAET,eAAO,MAAM,0BAA0B,QAa/B,CAAC"}

package/dist/prompts/PdrPrompts.js

@@ -2,14 +2,16 @@ export const DEFAULT_PDR_JOB_PROMPT = `
 You generate Product Design Reviews (PDR) grounded strictly in provided RFPs and related docs.
 Summarize intent, constraints, interfaces, risks, and open questions concisely with clear headings.
 Avoid inventing APIs or requirements; highlight uncertainties and assumptions for follow-up.
+Explicitly specify the technology stack. If none is stated, default to TypeScript, React, MySQL, Redis, and Bash scripting where needed, unless the domain clearly demands another stack (e.g., Python for ML).
 `.trim();
 export const DEFAULT_PDR_CHARACTER_PROMPT = `
-Be precise, risk-aware, and concise. Prefer bullet points. Cite assumptions and avoid speculation.
+Be precise, risk-aware, and concise. Prefer bullet points. Cite assumptions and avoid speculation. Always state the technology stack with rationale.
 `.trim();
 export const DEFAULT_PDR_RUNBOOK_PROMPT = `
 Produce Markdown with the following sections at minimum:
 - Introduction
 - Scope
+- Technology Stack (detail frontend, backend, data, infra, tooling; default to TypeScript/React/MySQL/Redis/Bash unless domain clearly indicates otherwise)
 - Requirements & Constraints
 - Architecture Overview
 - Interfaces / APIs (do not invent endpoints; if missing, list as open questions)

package/dist/prompts/SdsPrompts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SdsPrompts.d.ts","sourceRoot":"","sources":["../../src/prompts/SdsPrompts.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,sBAAsB,QAG3B,CAAC;AAET,eAAO,MAAM,4BAA4B,QAEjC,CAAC;AAET,eAAO,MAAM,0BAA0B,QAmB/B,CAAC;AAET,eAAO,MAAM,oBAAoB,QAgBzB,CAAC"}
+{"version":3,"file":"SdsPrompts.d.ts","sourceRoot":"","sources":["../../src/prompts/SdsPrompts.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,sBAAsB,QAG3B,CAAC;AAET,eAAO,MAAM,4BAA4B,QAEjC,CAAC;AAET,eAAO,MAAM,0BAA0B,QAoB/B,CAAC;AAET,eAAO,MAAM,oBAAoB,QAiBzB,CAAC"}

package/dist/prompts/SdsPrompts.js

@@ -13,6 +13,7 @@ Mandatory sections (include even if you must mark TODOs):
 - Goals & Scope
 - Architecture Overview
 - Components & Responsibilities
+- Planned Folder Tree (include a detailed final structure, scripts, and tooling paths)
 - Data Model & Persistence
 - Interfaces & Contracts (reference OpenAPI operations when available)
 - Non-Functional Requirements
@@ -32,6 +33,7 @@ export const DEFAULT_SDS_TEMPLATE = `
 ## Goals & Scope
 ## Architecture Overview
 ## Components & Responsibilities
+## Planned Folder Tree
 ## Data Model & Persistence
 ## Interfaces & Contracts
 ## Non-Functional Requirements

package/dist/services/agents/AgentRatingFormula.d.ts

@@ -0,0 +1,27 @@
+export type RatingBudgets = {
+    costUsd: number;
+    durationSeconds: number;
+    iterations: number;
+};
+export type RatingWeights = {
+    quality: number;
+    cost: number;
+    time: number;
+    iterations: number;
+};
+export type RunScoreInput = {
+    qualityScore: number;
+    totalCost: number;
+    durationSeconds: number;
+    iterations: number;
+    budgets?: Partial<RatingBudgets>;
+    weights?: Partial<RatingWeights>;
+};
+export declare const DEFAULT_RATING_WEIGHTS: RatingWeights;
+export declare const DEFAULT_RATING_BUDGETS: RatingBudgets;
+export declare const normalizeScore: (value: number, maxValue?: number) => number;
+export declare const normalizeBudget: (value: number, budget: number) => number;
+export declare const computeRunScore: (input: RunScoreInput) => number;
+export declare const updateEmaRating: (current: number, score: number, alpha: number) => number;
+export declare const computeAlpha: (windowSize: number) => number;
+//# sourceMappingURL=AgentRatingFormula.d.ts.map

package/dist/services/agents/AgentRatingFormula.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentRatingFormula.d.ts","sourceRoot":"","sources":["../../../src/services/agents/AgentRatingFormula.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;CAClC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,aAKpC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,aAIpC,CAAC;AASF,eAAO,MAAM,cAAc,GAAI,OAAO,MAAM,EAAE,iBAAa,KAAG,MAA4C,CAAC;AAE3G,eAAO,MAAM,eAAe,GAAI,OAAO,MAAM,EAAE,QAAQ,MAAM,KAAG,MAA0C,CAAC;AAE3G,eAAO,MAAM,eAAe,GAAI,OAAO,aAAa,KAAG,MAatD,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,SAAS,MAAM,EAAE,OAAO,MAAM,EAAE,OAAO,MAAM,KAAG,MAM/E,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,YAAY,MAAM,KAAG,MAGjD,CAAC"}

package/dist/services/agents/AgentRatingFormula.js

@@ -0,0 +1,45 @@
+export const DEFAULT_RATING_WEIGHTS = {
+    quality: 1.0,
+    cost: 0.15,
+    time: 0.1,
+    iterations: 0.2,
+};
+export const DEFAULT_RATING_BUDGETS = {
+    costUsd: 0.05,
+    durationSeconds: 600,
+    iterations: 2,
+};
+const clamp = (value, min = 0, max = 1) => Math.max(min, Math.min(max, value));
+const safeDivide = (value, denom) => {
+    if (!Number.isFinite(value) || !Number.isFinite(denom) || denom <= 0)
+        return 0;
+    return value / denom;
+};
+export const normalizeScore = (value, maxValue = 10) => clamp(safeDivide(value, maxValue));
+export const normalizeBudget = (value, budget) => clamp(safeDivide(value, budget));
+export const computeRunScore = (input) => {
+    const weights = { ...DEFAULT_RATING_WEIGHTS, ...(input.weights ?? {}) };
+    const budgets = { ...DEFAULT_RATING_BUDGETS, ...(input.budgets ?? {}) };
+    const qualityNorm = normalizeScore(input.qualityScore, 10);
+    const costNorm = normalizeBudget(input.totalCost, budgets.costUsd);
+    const timeNorm = normalizeBudget(input.durationSeconds, budgets.durationSeconds);
+    const iterNorm = normalizeBudget(input.iterations, budgets.iterations);
+    const weighted = weights.quality * qualityNorm -
+        weights.cost * costNorm -
+        weights.time * timeNorm -
+        weights.iterations * iterNorm;
+    return Math.round(clamp(weighted, 0, 1) * 1000) / 100; // 0-10 with 2 decimal precision
+};
+export const updateEmaRating = (current, score, alpha) => {
+    if (!Number.isFinite(current))
+        return score;
+    if (!Number.isFinite(score))
+        return current;
+    const safeAlpha = clamp(alpha, 0, 1);
+    const next = current + safeAlpha * (score - current);
+    return Math.round(next * 100) / 100;
+};
+export const computeAlpha = (windowSize) => {
+    const size = Math.max(1, windowSize);
+    return 2 / (size + 1);
+};

package/dist/services/agents/AgentRatingService.d.ts

@@ -0,0 +1,41 @@
+import { AgentService } from "@mcoda/agents";
+import { GlobalRepository, WorkspaceRepository } from "@mcoda/db";
+import { RoutingService } from "./RoutingService.js";
+import { WorkspaceResolution } from "../../workspace/WorkspaceManager.js";
+export type AgentRatingRequest = {
+    workspace: WorkspaceResolution;
+    agentId: string;
+    commandName: string;
+    jobId?: string;
+    commandRunId?: string;
+    taskId?: string;
+    taskKey?: string;
+    discipline?: string;
+    complexity?: number;
+    reviewerAgentName?: string;
+    ratingWindow?: number;
+};
+export declare class AgentRatingService {
+    private workspace;
+    private deps;
+    constructor(workspace: WorkspaceResolution, deps: {
+        workspaceRepo: WorkspaceRepository;
+        globalRepo: GlobalRepository;
+        agentService: AgentService;
+        routingService: RoutingService;
+    });
+    static create(workspace: WorkspaceResolution): Promise<AgentRatingService>;
+    close(): Promise<void>;
+    private ratingPromptPath;
+    private loadRatingPrompt;
+    private resolveReviewer;
+    private loadUsage;
+    private countIterations;
+    private loadDurationSeconds;
+    private buildReviewContext;
+    private runReviewer;
+    private computeBudgets;
+    rate(request: AgentRatingRequest): Promise<void>;
+    private writeRatingArtifact;
+}
+//# sourceMappingURL=AgentRatingService.d.ts.map

package/dist/services/agents/AgentRatingService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentRatingService.d.ts","sourceRoot":"","sources":["../../../src/services/agents/AgentRatingService.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAElE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AA0C1E,MAAM,MAAM,kBAAkB,GAAG;IAC/B,SAAS,EAAE,mBAAmB,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAeF,qBAAa,kBAAkB;IAE3B,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,IAAI;gBADJ,SAAS,EAAE,mBAAmB,EAC9B,IAAI,EAAE;QACZ,aAAa,EAAE,mBAAmB,CAAC;QACnC,UAAU,EAAE,gBAAgB,CAAC;QAC7B,YAAY,EAAE,YAAY,CAAC;QAC3B,cAAc,EAAE,cAAc,CAAC;KAChC;WAGU,MAAM,CAAC,SAAS,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAa1E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ5B,OAAO,CAAC,gBAAgB;YAIV,gBAAgB;YAahB,eAAe;YAWf,SAAS;IAoBvB,OAAO,CAAC,eAAe;YAgBT,mBAAmB;YA0BnB,kBAAkB;YA2BlB,WAAW;IAYzB,OAAO,CAAC,cAAc;IAShB,IAAI,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;YA4GxC,mBAAmB;CAOlC"}