@evo-dev/core 0.0.1-alpha.15 → 0.0.1-alpha.17

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@evo-dev/core",
-  "version": "0.0.1-alpha.15",
+  "version": "0.0.1-alpha.17",
   "type": "module",
   "repository": {
     "type": "git",

package/src/config/settings.ts

@@ -15,14 +15,25 @@ export interface PluginSettings {
 }
 
 export interface MemorySettings {
-  autoAccept: boolean;
+  reviewKnowledgeUpdates: boolean;
   runtimeInjection: boolean;
   staleReview: boolean;
   lexicalIndex: boolean;
   sessionMemory: SessionMemoryPolicySnapshot;
 }
 
+type LegacyMemorySettingsInput = Partial<MemorySettings> & {
+  /**
+   * Deprecated compatibility input. This flag was never connected to OKF activation and is
+   * intentionally omitted from canonical settings output.
+   */
+  autoAccept?: boolean;
+};
+
 export interface EvolutionSettings {
+  schedule: {
+    dailyTime: string;
+  };
   automation: {
     knowledge: boolean;
     semanticKnowledge: boolean;
@@ -70,8 +81,9 @@ export type SettingsInput = Partial<{
   doctor: Partial<EvoDevSettings["doctor"]>;
   hooks: unknown;
   teamRuntime: Partial<TeamRuntimeSettings>;
-  memory: Partial<MemorySettings>;
+  memory: LegacyMemorySettingsInput;
   evolution: Partial<{
+    schedule: Partial<EvolutionSettings["schedule"]>;
     automation: Partial<EvolutionSettings["automation"]>;
   }>;
 }>;
@@ -130,7 +142,7 @@ export function createDefaultTeamRuntimeSettings(): TeamRuntimeSettings {
 
 export function createDefaultMemorySettings(): MemorySettings {
   return {
-    autoAccept: true,
+    reviewKnowledgeUpdates: true,
     runtimeInjection: true,
     staleReview: true,
     lexicalIndex: true,
@@ -140,6 +152,9 @@ export function createDefaultMemorySettings(): MemorySettings {
 
 export function createDefaultEvolutionSettings(): EvolutionSettings {
   return {
+    schedule: {
+      dailyTime: "02:00",
+    },
     automation: {
       knowledge: true,
       semanticKnowledge: false,
@@ -195,6 +210,10 @@ export function mergeSettings(
     evolution: {
       ...defaults.evolution,
       ...existing.evolution,
+      schedule: {
+        ...defaults.evolution.schedule,
+        ...existing.evolution?.schedule,
+      },
       automation: {
         ...defaults.evolution.automation,
         ...existing.evolution?.automation,
@@ -272,8 +291,15 @@ export function parseSettings(value: unknown): EvoDevSettings {
 function parseEvolutionSettings(value: unknown, path: string): EvolutionSettings {
   const input = expectRecord(value, path);
   const defaults = createDefaultEvolutionSettings();
+  const schedule = expectRecord(input.schedule ?? defaults.schedule, `${path}.schedule`);
   const automation = expectRecord(input.automation ?? defaults.automation, `${path}.automation`);
   return {
+    schedule: {
+      dailyTime: parseDailyTime(
+        schedule.dailyTime ?? defaults.schedule.dailyTime,
+        `${path}.schedule.dailyTime`,
+      ),
+    },
     automation: {
       knowledge:
         automation.knowledge === undefined
@@ -291,14 +317,26 @@ function parseEvolutionSettings(value: unknown, path: string): EvolutionSettings
   };
 }
 
+function parseDailyTime(value: unknown, path: string): string {
+  const dailyTime = expectString(value, path);
+  const match = /^(\d{2}):(\d{2})$/u.exec(dailyTime);
+  if (match === null || Number(match[1]) > 23 || Number(match[2]) > 59) {
+    throw new EvoDevConfigError(`Invalid ${path}; expected a 24-hour HH:MM time`);
+  }
+  return dailyTime;
+}
+
 function parseMemorySettings(value: unknown, path: string): MemorySettings {
   const input = expectRecord(value, path);
   const defaults = createDefaultMemorySettings();
+  if (input.autoAccept !== undefined) {
+    expectBoolean(input.autoAccept, `${path}.autoAccept`);
+  }
   return {
-    autoAccept:
-      input.autoAccept === undefined
-        ? defaults.autoAccept
-        : expectBoolean(input.autoAccept, `${path}.autoAccept`),
+    reviewKnowledgeUpdates:
+      input.reviewKnowledgeUpdates === undefined
+        ? defaults.reviewKnowledgeUpdates
+        : expectBoolean(input.reviewKnowledgeUpdates, `${path}.reviewKnowledgeUpdates`),
     runtimeInjection:
       input.runtimeInjection === undefined
         ? defaults.runtimeInjection

package/src/evolution/candidates/index.ts

@@ -437,6 +437,56 @@ export async function updateEvolutionRepoProposalReviewState(input: {
   );
 }
 
+export async function supersedeEvolutionRepoProposal(input: {
+  homeDir: string;
+  proposalId: string;
+  projectKey?: string;
+  expectedReviewState?: EvolutionRepoProposal["reviewState"];
+  reason: string;
+  now?: string | Date;
+}): Promise<{ path: string; record: EvolutionRepoProposal; changed: boolean }> {
+  return await withEvolutionReviewDecisionLock(
+    { homeDir: input.homeDir, kind: "repo-proposal", itemId: input.proposalId },
+    async () => {
+      const record = await readEvolutionRepoProposalById(input);
+      const paths = resolveEvolutionPaths({
+        homeDir: input.homeDir,
+        projectKey: record.projectKey,
+        runId: record.provenance.runId,
+      });
+      const path = join(paths.repoProposalsDir, `${record.id}.json`);
+      if (record.reviewState === "superseded") return { path, record, changed: false };
+      if (
+        input.expectedReviewState !== undefined &&
+        record.reviewState !== input.expectedReviewState
+      ) {
+        throw new Error("Repo proposal review state changed before supersession was applied.");
+      }
+      if (record.reviewState !== "pending" && record.reviewState !== "deferred") {
+        throw new Error("Only pending or deferred repo proposals can be superseded.");
+      }
+      const reason = input.reason.trim();
+      if (reason === "" || reason.length > 500) {
+        throw new Error("Repo proposal supersession reason must be 1-500 characters.");
+      }
+      const changedAt = normalizeTimestamp(input.now);
+      const next: EvolutionRepoProposal = {
+        ...record,
+        reviewState: "superseded",
+        reviewStateChangedAt: changedAt,
+        supersession: {
+          policy: "session-proposal-v2",
+          reason: sanitizeText(reason),
+          supersededAt: changedAt,
+        },
+      };
+      validateEvolutionRepoProposal(next);
+      await writeRepoProposalAndIndex({ homeDir: input.homeDir, proposal: next, changedAt });
+      return { path, record: next, changed: true };
+    },
+  );
+}
+
 export async function updateEvolutionRepoProposalImprovementEval(input: {
   homeDir: string;
   proposalId: string;

package/src/evolution/evidence/session-memory/retention.ts

@@ -312,7 +312,8 @@ function hasPendingDerivedReview(
       (proposal) =>
         proposal.provenance.runId === runId &&
         proposal.reviewState !== "rejected" &&
-        proposal.reviewState !== "applied",
+        proposal.reviewState !== "applied" &&
+        proposal.reviewState !== "superseded",
     )
   ) {
     return true;