@evo-dev/core 0.0.1-alpha.1 → 0.0.1-alpha.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@evo-dev/core",
-  "version": "0.0.1-alpha.1",
+  "version": "0.0.1-alpha.10",
   "type": "module",
   "repository": {
     "type": "git",
@@ -10,18 +10,22 @@
   "exports": {
     ".": {
       "types": "./src/index.ts",
+      "bun": "./src/index.ts",
       "import": "./dist/index.js"
     },
     "./assets": {
       "types": "./src/assets/index.ts",
+      "bun": "./src/assets/index.ts",
       "import": "./dist/assets/index.js"
     },
     "./config": {
       "types": "./src/config/index.ts",
+      "bun": "./src/config/index.ts",
       "import": "./dist/config/index.js"
     },
     "./plugins": {
       "types": "./src/plugins/index.ts",
+      "bun": "./src/plugins/index.ts",
       "import": "./dist/plugins/index.js"
     }
   },

package/src/agents/index.ts

@@ -1,15 +1,11 @@
 import { readFile } from "node:fs/promises";
-import type { TaskContract, TaskExecutionMode } from "../task/index.ts";
+import {
+  type ScopedKnowledgeContextPack,
+  createScopedKnowledgeContextPack,
+  formatScopedKnowledgePromptBlock,
+} from "../evolution/knowledge/index.ts";
 
 export type AgentPersistence = "named" | "dynamic";
-export type AgentLens =
-  | "review"
-  | "qa"
-  | "security"
-  | "release"
-  | "architecture"
-  | "migration"
-  | "test";
 export type AgentOutputSchemaId =
   | "review-findings-v1"
   | "verification-summary-v1"
@@ -56,34 +52,6 @@ export interface AgentProfile {
   };
 }
 
-export interface AgentPlannedInvocation {
-  profile: AgentProfile;
-  lens: AgentLens;
-  reason: string;
-  plannedOnly: true;
-}
-
-export interface AgentMergePlan {
-  strategy: "none" | "single-output" | "dedupe-preserve-conflicts";
-  outputSchema: AgentOutputSchemaId | null;
-  dedupeBy: string[];
-  conflictPolicy: string[];
-  advisoryCategories: string[];
-}
-
-export interface AgentComposeDryRunPlan {
-  ok: boolean;
-  taskId: string;
-  mode: TaskExecutionMode | null;
-  workflowId: string | null;
-  agents: AgentPlannedInvocation[];
-  permissions: AgentPermissions;
-  mergePlan: AgentMergePlan;
-  warnings: string[];
-  advisories: string[];
-  rationale: string;
-}
-
 export interface AgentContextDryRunBundle {
   profile: AgentProfile;
   context: {
@@ -96,6 +64,15 @@ export interface AgentContextDryRunBundle {
   advisories: string[];
 }
 
+export interface AgentLoadedContextBundle {
+  profile: AgentProfile;
+  contextPack: ScopedKnowledgeContextPack | null;
+  promptBlock: string | null;
+  warnings: string[];
+  advisories: string[];
+  rawContentStored: false;
+}
+
 export interface ReviewFindingOutput {
   summary: string;
   findings: Array<{
@@ -124,17 +101,6 @@ const DEFAULT_AGENT_PERMISSIONS: AgentPermissions = {
 };
 const FORBIDDEN_INPUTS = ["rawPrompts", "secrets", "rawCommandLogs", "sourceCorpus"];
 const SAFE_AGENT_ID_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._-]{0,99}$/;
-const PRIVACY_ADVISORY_PATTERN =
-  /raw prompt|rawprompt|source corpus|sourcecorpus|secret|\.env|raw command|raw log|internal url|private url|network|write files|run commands|spawn agents|write memory/i;
-const LENS_TO_EXPERTISE: Record<AgentLens, string[]> = {
-  review: ["code-review"],
-  qa: ["qa", "verification"],
-  security: ["security", "privacy"],
-  release: ["release", "packaging"],
-  architecture: ["architecture"],
-  migration: ["migration", "impact-analysis"],
-  test: ["testing"],
-};
 
 export function createDefaultAgentPermissions(): AgentPermissions {
   return { ...DEFAULT_AGENT_PERMISSIONS };
@@ -188,67 +154,6 @@ export async function readAgentProfile(path: string): Promise<AgentProfile> {
   return parseAgentProfile(JSON.parse(await readFile(path, "utf8")));
 }
 
-export function composeAgentDryRun(input: {
-  contract: TaskContract;
-  workflowId?: string;
-  lenses?: AgentLens[];
-}): AgentComposeDryRunPlan {
-  const mode = input.contract.route.mode;
-  const workflowId = input.workflowId ?? input.contract.route.workflowId;
-  const warnings: string[] = [];
-  const permissions = createDefaultAgentPermissions();
-  const requestedLenses = dedupeLenses(input.lenses ?? []);
-  const advisories = collectPrivacyBoundaryAdvisories(input.contract, requestedLenses, workflowId);
-
-  if (mode === "minimal") {
-    return {
-      ok: advisories.length === 0,
-      taskId: input.contract.taskId,
-      mode,
-      workflowId,
-      agents: [],
-      permissions,
-      mergePlan: createMergePlan([]),
-      warnings,
-      advisories,
-      rationale: "Minimal mode does not force dynamic agents by default.",
-    };
-  }
-
-  const selectedLenses = selectLenses(
-    mode,
-    requestedLenses,
-    workflowId,
-    input.contract.route.requiredReview,
-  );
-  const agents = selectedLenses.map((lens) => ({
-    profile: createDynamicProfile(lens, input.contract, permissions),
-    lens,
-    reason: createLensReason(lens, mode, workflowId),
-    plannedOnly: true as const,
-  }));
-
-  if (mode === "standard" && agents.length > 1) {
-    warnings.push("Standard mode advisory selected more than one reviewer/triager.");
-  }
-
-  return {
-    ok: advisories.length === 0,
-    taskId: input.contract.taskId,
-    mode,
-    workflowId,
-    agents,
-    permissions,
-    mergePlan: createMergePlan(agents),
-    warnings,
-    advisories,
-    rationale:
-      agents.length === 0
-        ? "No dynamic agents selected; deterministic verification may be sufficient."
-        : `Selected ${agents.length} planned-only agent(s) based on mode/workflow/lenses.`,
-  };
-}
-
 export function loadAgentContextDryRun(profile: AgentProfile): AgentContextDryRunBundle {
   const parsed = parseAgentProfile(profile);
   return {
@@ -271,6 +176,48 @@ export function loadAgentContextDryRun(profile: AgentProfile): AgentContextDryRu
   };
 }
 
+export async function loadAgentContext(input: {
+  homeDir: string;
+  profile: AgentProfile;
+  projectKey?: string;
+  roleId?: string;
+  workflowId?: string;
+  paths?: string[];
+  queryText?: string;
+  limit?: number;
+}): Promise<AgentLoadedContextBundle> {
+  const parsed = parseAgentProfile(input.profile);
+  const pack = await createScopedKnowledgeContextPack({
+    homeDir: input.homeDir,
+    projectKey: input.projectKey,
+    roleId: input.roleId ?? parsed.id,
+    workflowId: input.workflowId,
+    paths: input.paths,
+    queryText: input.queryText,
+    limit: input.limit,
+  });
+  return {
+    profile: parsed,
+    contextPack: pack,
+    promptBlock: pack === null ? null : formatScopedKnowledgePromptBlock(pack),
+    warnings: pack?.warnings ?? [],
+    advisories: [],
+    rawContentStored: false,
+  };
+}
+
+export function formatAgentLoadedContextPromptBlock(bundle: AgentLoadedContextBundle): string {
+  if (bundle.promptBlock !== null) return bundle.promptBlock;
+  return [
+    "EvoDev Scoped Knowledge Context",
+    `Agent: ${bundle.profile.id}`,
+    "Raw content stored: false",
+    "",
+    "Applicable items:",
+    "- none",
+  ].join("\n");
+}
+
 export function validateAgentOutput(
   schema: AgentOutputSchemaId,
   output: unknown,
@@ -320,47 +267,6 @@ export function mergeReviewFindings(outputs: ReviewFindingOutput[]): {
   return { acceptedFindings: [...byKey.values()], unresolvedConflicts: conflicts };
 }
 
-export function formatAgentComposeDryRun(plan: AgentComposeDryRunPlan): string {
-  return [
-    "EvoDev agent compose dry-run",
-    "",
-    `Task: ${plan.taskId}`,
-    `Mode: ${plan.mode ?? "not routed"}`,
-    `Workflow: ${plan.workflowId ?? "none"}`,
-    `Rationale: ${plan.rationale}`,
-    "No-write/no-spawn: true",
-    "Privacy: local-private, metadata-only, raw prompts/source/secrets/logs forbidden",
-    "Agents:",
-    ...(plan.agents.length === 0
-      ? ["  - none"]
-      : plan.agents.map(
-          (agent) =>
-            `  - ${agent.profile.id} [${agent.lens}] traits=${agent.profile.traits.expertise.join(",")} schema=${agent.profile.output.schema} plannedOnly=${agent.plannedOnly}`,
-        )),
-    "Inputs:",
-    ...(plan.agents.length === 0
-      ? ["  - none"]
-      : [
-          `  - required: ${plan.agents[0].profile.inputs.required.join(",")}`,
-          `  - optional: ${plan.agents[0].profile.inputs.optional.join(",")}`,
-          `  - forbidden: ${plan.agents[0].profile.inputs.forbidden.join(",")}`,
-        ]),
-    "Permissions:",
-    ...Object.entries(plan.permissions).map(([key, value]) => `  - ${key}: ${value}`),
-    "Merge plan:",
-    `  - strategy: ${plan.mergePlan.strategy}`,
-    `  - outputSchema: ${plan.mergePlan.outputSchema ?? "none"}`,
-    "Warnings:",
-    ...(plan.warnings.length === 0
-      ? ["  - none"]
-      : plan.warnings.map((warning) => `  - ${warning}`)),
-    "Advisories:",
-    ...(plan.advisories.length === 0
-      ? ["  - none"]
-      : plan.advisories.map((advisory) => `  - ${advisory}`)),
-  ].join("\n");
-}
-
 export function formatAgentContextDryRun(bundle: AgentContextDryRunBundle): string {
   return [
     "EvoDev agent load-context dry-run",
@@ -380,116 +286,6 @@ export function formatAgentContextDryRun(bundle: AgentContextDryRunBundle): stri
   ].join("\n");
 }
 
-function createDynamicProfile(
-  lens: AgentLens,
-  contract: TaskContract,
-  permissions: AgentPermissions,
-): AgentProfile {
-  return {
-    version: 1,
-    id: `dynamic-${lens}-${contract.taskId}`.slice(0, 100),
-    name: `Dynamic ${lens} reviewer`,
-    persistence: "dynamic",
-    description: `Task-scoped ${lens} profile for metadata-only dry-run planning.`,
-    traits: {
-      expertise: LENS_TO_EXPERTISE[lens],
-      stance: ["skeptical-reviewer"],
-      approach: ["evidence-first", "advisory"],
-      domain: ["software-rd"],
-    },
-    inputs: {
-      required: ["taskContract", "scope", "evidenceSummary"],
-      optional: ["workflowPlan"],
-      forbidden: FORBIDDEN_INPUTS,
-    },
-    permissions,
-    output: {
-      schema: "review-findings-v1",
-      requiredFields: ["summary", "findings", "confidence", "evidenceRefs"],
-    },
-    privacy: {
-      classification: "local-private",
-      metadataOnly: true,
-      rawPromptStored: false,
-      sourceContentStored: false,
-    },
-  };
-}
-
-function selectLenses(
-  mode: TaskExecutionMode | null,
-  requested: AgentLens[],
-  workflowId: string | null,
-  requiredReview: string[],
-): AgentLens[] {
-  if (requested.length > 0) return mode === "standard" ? requested.slice(0, 1) : requested;
-  if (mode === "standard") return requiredReview.length > 0 ? ["review"] : [];
-  if (mode === "rigorous") {
-    if (workflowId?.includes("security")) return ["security", "review"];
-    if (workflowId?.includes("release")) return ["release", "security"];
-    if (workflowId?.includes("migration")) return ["migration", "architecture"];
-    if (workflowId?.includes("architecture")) return ["architecture", "review"];
-    return requiredReview.length > 0 ? ["review", "qa"] : [];
-  }
-  return [];
-}
-
-function createMergePlan(agents: AgentPlannedInvocation[]): AgentMergePlan {
-  if (agents.length === 0)
-    return {
-      strategy: "none",
-      outputSchema: null,
-      dedupeBy: [],
-      conflictPolicy: [],
-      advisoryCategories: [],
-    };
-  if (agents.length === 1)
-    return {
-      strategy: "single-output",
-      outputSchema: agents[0].profile.output.schema,
-      dedupeBy: [],
-      conflictPolicy: [],
-      advisoryCategories: [],
-    };
-  return {
-    strategy: "dedupe-preserve-conflicts",
-    outputSchema: "review-findings-v1",
-    dedupeBy: ["category", "path", "line", "title"],
-    conflictPolicy: ["preserve dissent", "keep higher severity unless evidence refutes"],
-    advisoryCategories: ["security", "privacy", "release"],
-  };
-}
-
-function createLensReason(
-  lens: AgentLens,
-  mode: TaskExecutionMode | null,
-  workflowId: string | null,
-): string {
-  return `${lens} lens selected for ${mode ?? "unrouted"} mode${workflowId ? ` and workflow ${workflowId}` : ""}.`;
-}
-
-function collectPrivacyBoundaryAdvisories(
-  contract: TaskContract,
-  lenses: AgentLens[],
-  workflowId: string | null,
-): string[] {
-  const text = [
-    contract.source.summary,
-    contract.currentState.summary,
-    contract.targetState.summary,
-    contract.route.rationale,
-    workflowId ?? "",
-    ...contract.scope.allowedOperations,
-    ...contract.scope.requiresUserConfirmation,
-    ...lenses,
-  ].join(" ");
-  return PRIVACY_ADVISORY_PATTERN.test(text)
-    ? [
-        "Agent planning detected privacy/risky context requiring raw data, writes, commands, network, spawning, or memory.",
-      ]
-    : [];
-}
-
 function validateRequiredObject(
   output: unknown,
   fields: string[],
@@ -513,10 +309,6 @@ function isKnownOutputSchema(value: unknown): value is AgentOutputSchemaId {
   );
 }
 
-function dedupeLenses(lenses: AgentLens[]): AgentLens[] {
-  return [...new Set(lenses)];
-}
-
 function severityRank(severity: AgentFindingSeverity): number {
   return { info: 0, low: 1, medium: 2, high: 3, critical: 4 }[severity];
 }