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

package/dist/config/index.js

@@ -21,12 +21,30 @@ function resolveEvoDevPaths(homeDir = getHomeDir()) {
   const normalizedHome = stripTrailingSlash(homeDir);
   const rootDir = `${normalizedHome}/.evodev`;
   const stateDir = `${rootDir}/state`;
+  const logsDir = `${rootDir}/logs`;
+  const knowledgeDir = `${rootDir}/knowledge`;
+  const evosDir = `${rootDir}/evos`;
+  const roleAgentsDir = `${rootDir}/agents/roles`;
+  const teamsDir = `${rootDir}/teams`;
+  const runsDir = `${rootDir}/runs`;
   return {
     homeDir: normalizedHome,
     rootDir,
     settingsPath: `${rootDir}/settings.json`,
     registryPath: `${rootDir}/registry.json`,
     stateDir,
+    logsDir,
+    knowledgeDir,
+    knowledgeIndexPath: `${knowledgeDir}/index.json`,
+    evosDir,
+    evosCasesDir: `${evosDir}/cases`,
+    evosIndexPath: `${evosDir}/index.json`,
+    roleAgentsDir,
+    roleAgentsIndexPath: `${roleAgentsDir}/index.json`,
+    teamsDir,
+    teamsIndexPath: `${teamsDir}/index.json`,
+    runsDir,
+    latestRunPath: `${runsDir}/latest.json`,
     installStatePath: `${stateDir}/install.json`,
     syncStatePath: `${stateDir}/sync.json`
   };
@@ -98,11 +116,48 @@ function expectString(value, path) {
   }
   return value;
 }
+// packages/core/src/evolution/index.ts
+var PROCESS_LOCK_STALE_MS = 5 * 60 * 1000;
+var FORBIDDEN_RAW_KEYS = new Set([
+  "commandhistory",
+  "commandoutput",
+  "credential",
+  "credentials",
+  "env",
+  "fullsource",
+  "memorybody",
+  "password",
+  "privatekey",
+  "prompt",
+  "promptbody",
+  "prompttext",
+  "rawcommand",
+  "rawcommandoutput",
+  "rawlog",
+  "rawlogs",
+  "rawoutput",
+  "rawpayload",
+  "rawprompt",
+  "secret",
+  "secretvalue",
+  "source",
+  "sourcebody",
+  "sourcecode",
+  "sourcecontent",
+  "sourcetext",
+  "stderr",
+  "stdout",
+  "token",
+  "transcript",
+  "transcriptbody",
+  "transcripttext"
+]);
+
 // packages/core/src/task/index.ts
 var FORBIDDEN_TASK_WRITE_SEGMENTS = new Set([".claude", ".codex"]);
 var FORBIDDEN_PROJECT_ASSET_SEGMENTS = new Set(["packages", "src"]);
 var FORBIDDEN_TASK_WRITE_FILES = new Set(["agents.md", "claude.md", "package.json", "readme.md"]);
-var FORBIDDEN_RAW_KEYS = new Set([
+var FORBIDDEN_RAW_KEYS2 = new Set([
   "rawoutput",
   "raw_output",
   "stdout",
@@ -162,47 +217,47 @@ var CANONICAL_HOOK_EVENT_TYPES = [
   "WorktreeRemove"
 ];
 var DEFAULT_EVENT_SETTINGS = {
-  SessionStart: false,
-  UserPromptSubmit: false,
-  UserPromptExpansion: false,
-  PreToolUse: false,
-  PermissionRequest: false,
-  PostToolUse: false,
-  PostToolUseFailure: false,
-  PostToolBatch: false,
-  PermissionDenied: false,
-  SubagentStart: false,
-  Stop: false,
-  StopFailure: false,
-  TeammateIdle: false,
-  SubagentStop: false,
-  TaskCreated: false,
-  TaskCompleted: false,
-  PreCompact: false,
-  PostCompact: false,
-  SessionEnd: false,
-  ConfigChange: false,
-  CwdChanged: false,
-  FileChanged: false,
-  WorktreeCreate: false,
-  WorktreeRemove: false
+  SessionStart: true,
+  UserPromptSubmit: true,
+  UserPromptExpansion: true,
+  PreToolUse: true,
+  PermissionRequest: true,
+  PostToolUse: true,
+  PostToolUseFailure: true,
+  PostToolBatch: true,
+  PermissionDenied: true,
+  SubagentStart: true,
+  Stop: true,
+  StopFailure: true,
+  TeammateIdle: true,
+  SubagentStop: true,
+  TaskCreated: true,
+  TaskCompleted: true,
+  PreCompact: true,
+  PostCompact: true,
+  SessionEnd: true,
+  ConfigChange: true,
+  CwdChanged: true,
+  FileChanged: true,
+  WorktreeCreate: true,
+  WorktreeRemove: true
 };
 function createDefaultHookSettings() {
   return {
-    enabled: false,
+    enabled: true,
     targets: {
       claude: {
-        enabled: false,
+        enabled: true,
         events: { ...DEFAULT_EVENT_SETTINGS }
       },
       codex: {
-        enabled: false,
+        enabled: true,
         events: { ...DEFAULT_EVENT_SETTINGS }
       }
     },
     observability: {
-      metadataOnly: true,
-      rawPayloadStorage: false,
+      metadataOnly: false,
+      rawPayloadStorage: true,
       appendEvents: false
     },
     learning: {
@@ -217,6 +272,9 @@ function parseHookSettings(value) {
     return defaults;
   if (!isRecord(value))
     throw new Error("Invalid hooks settings; expected object.");
+  const observability = isRecord(value.observability) ? value.observability : undefined;
+  optionalBoolean(observability?.metadataOnly, defaults.observability.metadataOnly, "hooks.observability.metadataOnly");
+  optionalBoolean(observability?.rawPayloadStorage, defaults.observability.rawPayloadStorage, "hooks.observability.rawPayloadStorage");
   return {
     enabled: optionalBoolean(value.enabled, defaults.enabled, "hooks.enabled"),
     targets: {
@@ -224,9 +282,9 @@ function parseHookSettings(value) {
       codex: parseHookTargetSettings(value.targets, defaults.targets.codex, "codex")
     },
     observability: {
-      metadataOnly: true,
-      rawPayloadStorage: false,
-      appendEvents: false
+      metadataOnly: false,
+      rawPayloadStorage: true,
+      appendEvents: optionalBoolean(observability?.appendEvents, defaults.observability.appendEvents, "hooks.observability.appendEvents")
     },
     learning: {
       emitCandidates: false,
@@ -286,7 +344,16 @@ function createDefaultSettings(os = process.platform) {
     doctor: {
       lastRunAt: null
     },
-    hooks: createDefaultHookSettings()
+    hooks: createDefaultHookSettings(),
+    teamRuntime: createDefaultTeamRuntimeSettings()
+  };
+}
+function createDefaultTeamRuntimeSettings() {
+  return {
+    defaultRuntime: "codex",
+    defaultModel: null,
+    defaultThinkingLevel: null,
+    recordTranscript: false
   };
 }
 function mergeSettings(existing, defaults = createDefaultSettings()) {
@@ -321,7 +388,11 @@ function mergeSettings(existing, defaults = createDefaultSettings()) {
       ...defaults.doctor,
       ...existing.doctor
     },
-    hooks: existing.hooks ?? defaults.hooks
+    hooks: existing.hooks ?? defaults.hooks,
+    teamRuntime: {
+      ...defaults.teamRuntime,
+      ...existing.teamRuntime
+    }
   };
   return parseSettings(merged);
 }
@@ -355,10 +426,25 @@ function parseSettings(value) {
     doctor: {
       lastRunAt: expectNullableString(doctor.lastRunAt, "settings.doctor.lastRunAt")
     },
-    hooks: parseHookSettings(root.hooks)
+    hooks: parseHookSettings(root.hooks),
+    teamRuntime: parseTeamRuntimeSettings(root.teamRuntime ?? createDefaultTeamRuntimeSettings(), "settings.teamRuntime")
   };
   return parsed;
 }
+function parseTeamRuntimeSettings(value, path) {
+  const input = expectRecord2(value, path);
+  const defaults = createDefaultTeamRuntimeSettings();
+  const defaultRuntime = input.defaultRuntime ?? defaults.defaultRuntime;
+  if (defaultRuntime !== "codex" && defaultRuntime !== "claude") {
+    throw new EvoDevConfigError(`Invalid ${path}.defaultRuntime; expected codex or claude`);
+  }
+  return {
+    defaultRuntime,
+    defaultModel: input.defaultModel === undefined ? defaults.defaultModel : expectNullableString(input.defaultModel, `${path}.defaultModel`),
+    defaultThinkingLevel: input.defaultThinkingLevel === undefined ? defaults.defaultThinkingLevel : expectNullableString(input.defaultThinkingLevel, `${path}.defaultThinkingLevel`),
+    recordTranscript: input.recordTranscript === undefined ? defaults.recordTranscript : expectBoolean(input.recordTranscript, `${path}.recordTranscript`)
+  };
+}
 function parsePluginSettings(value, path) {
   const input = expectRecord2(value, path);
   const parsed = {
@@ -485,6 +571,15 @@ function createCoreConfigStore(homeDir) {
     paths,
     async ensureBaseDirs() {
       await mkdir(paths.stateDir, { recursive: true });
+      await mkdir(paths.logsDir, { recursive: true });
+      await mkdir(paths.knowledgeDir, { recursive: true });
+      await mkdir(paths.evosCasesDir, { recursive: true });
+      await mkdir(paths.roleAgentsDir, { recursive: true });
+      await mkdir(paths.teamsDir, { recursive: true });
+      await mkdir(paths.runsDir, { recursive: true });
+    },
+    async ensureKnowledgeBase() {
+      await ensureKnowledgeBaseFiles(paths);
     },
     async readSettings() {
       return readJsonFile(paths.settingsPath, parseSettings);
@@ -521,12 +616,83 @@ function createCoreConfigStore(homeDir) {
 async function initializeCoreConfig(homeDir) {
   const store = createCoreConfigStore(homeDir);
   await store.ensureBaseDirs();
+  await store.ensureKnowledgeBase();
   await writeIfMissing(store.paths.settingsPath, createDefaultSettings());
   await writeIfMissing(store.paths.registryPath, createDefaultRegistry());
   await writeIfMissing(store.paths.installStatePath, createDefaultInstallState());
   await writeIfMissing(store.paths.syncStatePath, createDefaultSyncState());
   return store;
 }
+async function ensureKnowledgeBaseFiles(paths) {
+  await mkdir(paths.knowledgeDir, { recursive: true });
+  await mkdir(paths.evosCasesDir, { recursive: true });
+  await writeTextIfMissing(`${paths.knowledgeDir}/README.md`, [
+    "# EvoDev Knowledge",
+    "",
+    "Local-private knowledge base for user-accepted facts, decisions, architecture notes, and reusable domain context.",
+    "",
+    "EvoDev must not populate this directory from source code, prompts, command output, logs, or transcripts without an explicit consent flow.",
+    ""
+  ].join(`
+`));
+  await writeIndexIfMissingOrMigrate(paths.knowledgeIndexPath, "knowledge-index", {
+    version: 1,
+    kind: "knowledge-index",
+    roleTags: [],
+    entries: []
+  });
+  await writeTextIfMissing(`${paths.evosDir}/README.md`, [
+    "# EvoDev Evos",
+    "",
+    "Local-private evolution case library for reviewed improvement cases and reusable process changes.",
+    "",
+    "Cases start empty. Future automation may propose candidates, but accepted evos require explicit review before they can influence workflows or routing.",
+    ""
+  ].join(`
+`));
+  await writeTextIfMissing(`${paths.evosCasesDir}/README.md`, [
+    "# Evolution Cases",
+    "",
+    "Store one reviewed evolution case per file. Do not store raw prompts, source dumps, secrets, transcripts, or raw command output here.",
+    ""
+  ].join(`
+`));
+  await writeIndexIfMissingOrMigrate(paths.evosIndexPath, "evos-index", {
+    version: 1,
+    kind: "evos-index",
+    roleTags: [],
+    cases: []
+  });
+  await writeTextIfMissing(`${paths.roleAgentsDir}/README.md`, [
+    "# Role Agents",
+    "",
+    "Local-private role agent registry for EvoDev-managed agent roles and user-reviewed role extensions.",
+    "",
+    "Repository-specific role agents should be proposed first and written into a user repository only after explicit project opt-in.",
+    ""
+  ].join(`
+`));
+  await writeIndexIfMissingOrMigrate(paths.roleAgentsIndexPath, "role-agent-index", {
+    version: 1,
+    kind: "role-agent-index",
+    roles: [],
+    projectExtensions: []
+  });
+  await writeTextIfMissing(`${paths.teamsDir}/README.md`, [
+    "# Agent Teams",
+    "",
+    "Local-private EvoHub team registry for reviewed role-agent team definitions.",
+    "",
+    "Teams may reference role agents and role-tagged knowledge, but they must not contain raw source, prompts, transcripts, secrets, or raw command output.",
+    ""
+  ].join(`
+`));
+  await writeIndexIfMissingOrMigrate(paths.teamsIndexPath, "agent-team-index", {
+    version: 1,
+    kind: "agent-team-index",
+    teams: []
+  });
+}
 async function readJsonFile(filePath, parse) {
   let raw;
   try {
@@ -570,6 +736,42 @@ async function writeIfMissing(filePath, value) {
     throw new EvoDevConfigError(`Cannot inspect config file (${describeFileError(error)})`, filePath);
   }
 }
+async function writeIndexIfMissingOrMigrate(filePath, kind, defaults) {
+  let raw;
+  try {
+    raw = await readFile(filePath, "utf8");
+  } catch (error) {
+    if (isNodeError(error) && error.code === "ENOENT") {
+      await writeJsonFile(filePath, defaults);
+      return;
+    }
+    throw new EvoDevConfigError(`Cannot inspect config file (${describeFileError(error)})`, filePath);
+  }
+  let existing;
+  try {
+    existing = JSON.parse(raw);
+  } catch (error) {
+    throw new EvoDevConfigError(`Invalid bootstrap index JSON (${describeFileError(error)})`, filePath);
+  }
+  if (!isRecord2(existing) || existing.kind !== kind)
+    return;
+  const migrated = { ...defaults, ...existing };
+  if (Object.keys(defaults).every((key) => (key in existing)))
+    return;
+  await writeJsonFile(filePath, migrated);
+}
+async function writeTextIfMissing(filePath, value) {
+  try {
+    await readFile(filePath, "utf8");
+  } catch (error) {
+    if (isNodeError(error) && error.code === "ENOENT") {
+      await mkdir(dirname(filePath), { recursive: true });
+      await writeFile(filePath, value, "utf8");
+      return;
+    }
+    throw new EvoDevConfigError(`Cannot inspect config file (${describeFileError(error)})`, filePath);
+  }
+}
 async function writeJsonFile(filePath, value) {
   await mkdir(dirname(filePath), { recursive: true });
   await writeFile(filePath, `${JSON.stringify(value, null, 2)}
@@ -584,6 +786,9 @@ function describeFileError(error) {
 function isNodeError(error) {
   return error instanceof Error && "code" in error;
 }
+function isRecord2(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
 export {
   resolveEvoDevPaths,
   parseSyncState,
@@ -592,6 +797,7 @@ export {
   parseInstallState,
   mergeSettings,
   initializeCoreConfig,
+  createDefaultTeamRuntimeSettings,
   createDefaultSyncState,
   createDefaultSettings,
   createDefaultRegistry,