chainlesschain 0.166.16 → 0.166.18

package/src/commands/evolution.js

@@ -1,10 +1,10 @@
 /**
- * Self-Evolving System commands
- * chainlesschain evolution assess|learn|diagnose|repair|predict|growth|stats|export
+ * Evolution metrics and governance-record commands
+ * chainlesschain evolution assess|record-model-metrics|diagnose|repair|predict|growth|stats|export
  */
 
 import chalk from "chalk";
-import { intArg, floatArg } from "../lib/cli-arg.js";
+import { intArg } from "../lib/cli-arg.js";
 import { numericOption } from "../lib/cli-numeric.js";
 import ora from "ora";
 import { logger } from "../lib/logger.js";
@@ -12,7 +12,7 @@ import { parseJsonOption } from "../lib/parse-json-option.js";
 import { bootstrap, shutdown } from "../runtime/bootstrap.js";
 import {
   assessCapability,
-  trainIncremental,
+  recordIncrementalModelMetrics,
   selfDiagnose,
   selfRepair,
   predictBehavior,
@@ -26,10 +26,9 @@ import {
   REPAIR_STRATEGY,
   GROWTH_MILESTONE,
   assessCapabilityV2,
-  getCapabilityV2,
   listCapabilitiesV2,
-  trainIncrementalV2,
-  listTrainingLogV2,
+  recordTrainingMetricsV2,
+  listTrainingMetricRecordsV2,
   selfDiagnoseV2,
   getDiagnosisV2,
   listDiagnosesV2,
@@ -45,7 +44,9 @@ import {
 export function registerEvolutionCommand(program) {
   const evolution = program
     .command("evolution")
-    .description("Self-evolving AI system — capabilities, learning, diagnosis");
+    .description(
+      "Evolution metrics and governance records — not model training or active Skill promotion",
+    );
 
   // evolution assess <name> <score>
   evolution
@@ -95,12 +96,12 @@ export function registerEvolutionCommand(program) {
       }
     });
 
-  // evolution learn <model-id>
+  // evolution record-model-metrics <model-id>
   evolution
-    .command("learn")
-    .description("Train a model with incremental data")
-    .argument("<model-id>", "Model ID to train")
-    .option("--data <json>", "Training data as JSON array")
+    .command("record-model-metrics")
+    .description("Record a synthetic model metric estimate (no training)")
+    .argument("<model-id>", "Model record ID")
+    .option("--data <json>", "Observed data as JSON array")
     .option(
       "--type <type>",
       "Model type (classification|regression)",
@@ -115,30 +116,33 @@ export function registerEvolutionCommand(program) {
           process.exit(1);
         }
         const db = ctx.db.getDatabase();
-        const spinner = ora(`Training model: ${modelId}...`).start();
+        const spinner = ora(`Recording model metrics: ${modelId}...`).start();
 
         let data = [{ sample: true }];
         if (options.data) {
           try {
             data = JSON.parse(options.data);
-          } catch (_err) {
+          } catch {
             // Use data string as single data point
             data = [options.data];
           }
         }
 
-        const result = trainIncremental(db, modelId, data, {
+        const result = recordIncrementalModelMetrics(db, modelId, data, {
           type: options.type,
         });
-        spinner.succeed("Model trained");
+        spinner.succeed("Model metrics recorded");
 
         if (options.json) {
           console.log(JSON.stringify(result, null, 2));
         } else {
           logger.log(chalk.bold(`Model: ${result.name}`));
           logger.log(`  Type:       ${result.type}`);
-          logger.log(`  Accuracy:   ${chalk.cyan(result.accuracy.toFixed(4))}`);
+          logger.log(
+            `  Formula Estimate: ${chalk.cyan(result.accuracy.toFixed(4))}`,
+          );
           logger.log(`  Data Points: ${result.dataPoints}`);
+          logger.log(`  Training Performed: ${result.performedTraining}`);
         }
 
         await shutdown();
@@ -151,7 +155,7 @@ export function registerEvolutionCommand(program) {
   // evolution diagnose
   evolution
     .command("diagnose")
-    .description("Run self-diagnosis on the system")
+    .description("Diagnose recorded evolution metrics")
     .option("--json", "Output as JSON")
     .action(async (options) => {
       try {
@@ -207,7 +211,7 @@ export function registerEvolutionCommand(program) {
   // evolution repair <issue>
   evolution
     .command("repair")
-    .description("Self-repair a diagnosed issue")
+    .description("Apply a maintenance strategy to a recorded diagnosis")
     .argument("<issue>", "Issue type (high-memory|stale-cache|degraded-model)")
     .option("--json", "Output as JSON")
     .action(async (issue, options) => {
@@ -387,7 +391,7 @@ export function registerEvolutionCommand(program) {
   // evolution export <model-id>
   evolution
     .command("export")
-    .description("Export a model for portability")
+    .description("Export a model metric record for portability")
     .argument("<model-id>", "Model ID to export")
     .option("--json", "Output as JSON")
     .action(async (modelId, options) => {
@@ -510,32 +514,42 @@ export function registerEvolutionCommand(program) {
     });
 
   evolution
-    .command("train-v2")
-    .description("Record V2 incremental training run")
+    .command("record-training-metrics-v2")
+    .description("Record caller-supplied loss metrics (no training)")
     .requiredOption(
       "-s, --strategy <s>",
       "replay|elastic-weight|knowledge-distill",
     )
     .requiredOption("--data-size <n>", "Data size")
-    .requiredOption("--loss-before <n>", "Loss before training")
-    .requiredOption("--loss-after <n>", "Loss after training")
+    .requiredOption("--loss-before <n>", "Caller-reported loss before")
+    .requiredOption("--loss-after <n>", "Caller-reported loss after")
     .option("--duration-ms <n>", "Duration in ms", "0")
     .option("--json", "Output as JSON")
     .action((options) => {
       try {
-        const r = trainIncrementalV2({
+        const r = recordTrainingMetricsV2({
           strategy: options.strategy,
-          dataSize: numericOption(options.dataSize, { name: "--data-size", min: 0 }),
-          lossBefore: numericOption(options.lossBefore, { name: "--loss-before" }),
+          dataSize: numericOption(options.dataSize, {
+            name: "--data-size",
+            min: 0,
+          }),
+          lossBefore: numericOption(options.lossBefore, {
+            name: "--loss-before",
+          }),
           lossAfter: numericOption(options.lossAfter, { name: "--loss-after" }),
-          durationMs: numericOption(options.durationMs, { name: "--duration-ms", min: 0, fallback: 0 }),
+          durationMs: numericOption(options.durationMs, {
+            name: "--duration-ms",
+            min: 0,
+            fallback: 0,
+          }),
         });
         if (options.json) console.log(JSON.stringify(r, null, 2));
         else {
-          logger.log(chalk.bold(`Training ${r.id}`));
+          logger.log(chalk.bold(`Metric Record ${r.id}`));
           logger.log(`  Strategy:          ${r.strategy}`);
           logger.log(`  KnowledgeRetention ${r.knowledgeRetention.toFixed(4)}`);
-          logger.log(`  Status:            ${r.status}`);
+          logger.log(`  Assessment:        ${r.retentionAssessment}`);
+          logger.log(`  Training Performed: ${r.performedTraining}`);
         }
       } catch (err) {
         logger.error(`Failed: ${err.message}`);
@@ -544,20 +558,23 @@ export function registerEvolutionCommand(program) {
     });
 
   evolution
-    .command("training-log-v2")
-    .description("List V2 training runs")
+    .command("training-metrics-v2")
+    .description("List V2 training metric records")
     .option("-s, --strategy <s>", "Filter by strategy")
     .option("-l, --limit <n>", "Limit")
     .option("--json", "Output as JSON")
     .action((options) => {
       const limit = options.limit ? parseInt(options.limit, 10) : undefined;
-      const list = listTrainingLogV2({ strategy: options.strategy, limit });
+      const list = listTrainingMetricRecordsV2({
+        strategy: options.strategy,
+        limit,
+      });
       if (options.json) console.log(JSON.stringify(list, null, 2));
       else {
-        if (list.length === 0) logger.log("(no training log)");
+        if (list.length === 0) logger.log("(no metric records)");
         for (const t of list) {
           logger.log(
-            `${new Date(t.createdAt).toISOString()} ${t.strategy.padEnd(20)} retention=${t.knowledgeRetention.toFixed(3)} status=${t.status}`,
+            `${new Date(t.createdAt).toISOString()} ${t.strategy.padEnd(20)} retention=${t.knowledgeRetention.toFixed(3)} assessment=${t.retentionAssessment}`,
           );
         }
       }
@@ -565,7 +582,7 @@ export function registerEvolutionCommand(program) {
 
   evolution
     .command("diagnose-v2")
-    .description("Run V2 self-diagnosis")
+    .description("Diagnose recorded V2 evolution metrics")
     .option("--scope <s>", "Scope", "system")
     .option("--depth <d>", "Depth", "shallow")
     .option("--json", "Output as JSON")
@@ -623,7 +640,7 @@ export function registerEvolutionCommand(program) {
 
   evolution
     .command("repair-v2")
-    .description("Apply V2 self-repair to a diagnosis")
+    .description("Record a V2 maintenance strategy for a diagnosis")
     .argument("<diagnosis-id>", "Diagnosis ID")
     .requiredOption(
       "-s, --strategy <s>",
@@ -647,7 +664,7 @@ export function registerEvolutionCommand(program) {
 
   evolution
     .command("predict-v2")
-    .description("V2 behavior prediction")
+    .description("Project behavior from recorded V2 metrics")
     .option("--horizon-ms <n>", "Time horizon in ms")
     .option("--json", "Output as JSON")
     .action((options) => {
@@ -705,8 +722,10 @@ export function registerEvolutionCommand(program) {
     .option("--json", "Output as JSON")
     .action((options) => {
       const period = {};
-      if (options.from) period.fromMs = numericOption(options.from, { name: "--from", min: 0 });
-      if (options.to) period.toMs = numericOption(options.to, { name: "--to", min: 0 });
+      if (options.from)
+        period.fromMs = numericOption(options.from, { name: "--from", min: 0 });
+      if (options.to)
+        period.toMs = numericOption(options.to, { name: "--to", min: 0 });
       const list = getGrowthLogV2({
         milestoneType: options.type,
         period: Object.keys(period).length ? period : undefined,
@@ -772,7 +791,7 @@ export function registerEvolutionCommand(program) {
       else {
         logger.log(chalk.bold("Evolution Stats V2"));
         logger.log(`  Capabilities: ${s.capabilityCount}`);
-        logger.log(`  TrainingRuns: ${s.trainingRuns}`);
+        logger.log(`  TrainingMetricRecords: ${s.trainingMetricRecords}`);
         logger.log(
           `  Diagnoses:    ${s.diagnoses.total} (${Object.entries(
             s.diagnoses.bySeverity,

package/src/commands/learning.js

@@ -62,7 +62,7 @@ export function registerLearningCommand(program) {
   const learning = program
     .command("learning")
     .description(
-      "Autonomous learning loop — trajectories, reflection, skill synthesis",
+      "Learning records — trajectories, reflection, and governed candidate attempts",
     );
 
   // learning stats
@@ -162,7 +162,9 @@ export function registerLearningCommand(program) {
   // learning export — §8.3 cross-device backup: full dump of learning_trajectories
   learning
     .command("export")
-    .description("Export all learning trajectories as JSON (module 101 §8.3 backup)")
+    .description(
+      "Export all learning trajectories as JSON (module 101 §8.3 backup)",
+    )
     .option("--output <file>", "Write JSON array to file (default: stdout)")
     .option("--json", "Output JSON ({ok,count} with --output; array otherwise)")
     .action(async (options) => {
@@ -172,15 +174,24 @@ export function registerLearningCommand(program) {
           logger.error("Database not available");
           process.exit(1);
         }
-        const { exportTrajectories } = await import("../lib/learning/learning-tables.js");
+        const { exportTrajectories } =
+          await import("../lib/learning/learning-tables.js");
         const rows = exportTrajectories(ctx.db.getDatabase());
         if (options.output) {
           const fs = await import("fs");
           fs.writeFileSync(options.output, JSON.stringify(rows), "utf-8");
           if (options.json) {
-            console.log(JSON.stringify({ ok: true, count: rows.length, output: options.output }));
+            console.log(
+              JSON.stringify({
+                ok: true,
+                count: rows.length,
+                output: options.output,
+              }),
+            );
           } else {
-            logger.log(`exported ${rows.length} trajectories → ${options.output}`);
+            logger.log(
+              `exported ${rows.length} trajectories → ${options.output}`,
+            );
           }
         } else {
           console.log(JSON.stringify(rows));
@@ -195,7 +206,9 @@ export function registerLearningCommand(program) {
   // learning import — §8.3 restore: idempotent upsert by id from a JSON-array file
   learning
     .command("import")
-    .description("Import learning trajectories from a JSON array file (idempotent upsert by id; §8.3)")
+    .description(
+      "Import learning trajectories from a JSON array file (idempotent upsert by id; §8.3)",
+    )
     .requiredOption("--input <file>", "JSON array of trajectories to import")
     .option("--json", "Output JSON result")
     .action(async (options) => {
@@ -210,7 +223,8 @@ export function registerLearningCommand(program) {
           logger.error("Database not available");
           process.exit(1);
         }
-        const { importTrajectories } = await import("../lib/learning/learning-tables.js");
+        const { importTrajectories } =
+          await import("../lib/learning/learning-tables.js");
         const result = importTrajectories(ctx.db.getDatabase(), rows);
         if (options.json) {
           console.log(JSON.stringify(result));
@@ -302,7 +316,9 @@ export function registerLearningCommand(program) {
   // learning synthesize
   learning
     .command("synthesize")
-    .description("Synthesize new skills from eligible trajectories")
+    .description(
+      "Attempt a governed Skill candidate from eligible trajectories",
+    )
     .option("--json", "Output as JSON")
     .action(async (options) => {
       try {

package/src/commands/serve.js

@@ -7,7 +7,9 @@ import { logger } from "../lib/logger.js";
 import { createAgentRuntimeFactory } from "../runtime/runtime-factory.js";
 import path from "node:path";
 
-export function registerServeCommand(program) {
+export function registerServeCommand(program, dependencies = {}) {
+  const evolutionCompositionFactory =
+    dependencies.evolutionCompositionFactory ?? null;
   const serve = program
     .command("serve")
     .description("Start WebSocket server for remote CLI access")
@@ -126,6 +128,7 @@ export function registerServeCommand(program) {
               maxConnections: parseInt(opts.maxConnections, 10),
               store,
               kernelFactory: () => new CliAgentKernelAdapter({ cwd }),
+              evolutionCompositionFactory,
               maxQueuedRequests,
             });
             const info = await host.start();
@@ -155,6 +158,7 @@ export function registerServeCommand(program) {
             await runStdioAppServer({
               store,
               kernel: new CliAgentKernelAdapter({ cwd }),
+              evolutionCompositionFactory,
               maxQueuedRequests,
             });
           } finally {
@@ -162,7 +166,12 @@ export function registerServeCommand(program) {
           }
           return;
         }
-        const runtime = createAgentRuntimeFactory().createServerRuntime({
+        const runtime = createAgentRuntimeFactory({
+          deps:
+            evolutionCompositionFactory === null
+              ? {}
+              : { evolutionCompositionFactory },
+        }).createServerRuntime({
           port: parseInt(opts.port, 10),
           host: opts.host,
           token: opts.token,

package/src/data/changelog.json

@@ -1,6 +1,19 @@
 {
   "source": "CHANGELOG.md",
   "releases": [
+    {
+      "productVersion": null,
+      "cliVersion": "0.166.18",
+      "cliVersions": ["0.3.9", "0.166.17", "0.166.18"],
+      "date": "2026-09-03",
+      "title": "",
+      "sections": [
+        {
+          "heading": "Added - cc CLI 0.166.18 and Session Core 0.3.9: governed Skill evolution",
+          "body": "> `chainlesschain` **0.166.17 -> 0.166.18** and\n> `@chainlesschain/session-core` **0.3.8 -> 0.3.9** (release candidate,\n> 2026-09-03).\n\n- **Evaluated promotion**: Skill candidates must carry target-matrix evidence,\n  current-revision bindings, durable promotion receipts, and revocation-aware\n  attestations before an active revision can change.\n- **Crash-safe lifecycle**: tenant-scoped candidate and release registries,\n  lease/CAS promotion, last-known-good tracking, and rollback keep concurrent\n  or interrupted mutations fail closed.\n- **Bounded improvement pilot**: the CLI can propose constrained Skill\n  improvements and wiki-informed candidates without directly rewriting or\n  activating installed Skills.\n- **Cross-runtime evidence**: CLI, Desktop, and Graph adapters share the new\n  Session Core `EvolutionRun` and Skill-invocation receipt contracts, keeping\n  evidence identity consistent across runtimes.\n- **Deterministic async hooks**: tool execution now skips `async:true`\n  `PostToolUse` hooks when no supervisor/dispatcher is available, preventing a\n  hidden background command and a Windows timing race.\n- **Release boundary**: publication requires this exact candidate commit to\n  pass every configured Linux, Windows, and macOS job in `CLI CI` and\n  `CLI Strict Sandbox`; a local test result or an older green run is not\n  release authorization."
+        }
+      ]
+    },
     {
       "productVersion": null,
       "cliVersion": "0.166.16",

package/src/gateways/ws/session-protocol.js

@@ -647,6 +647,7 @@ async function ensureSessionHandler(
         db: server.sessionManager.db,
         sessionHostLease,
         sessionBudgetRoot,
+        evolutionCompositionFactory: server.evolutionCompositionFactory,
       });
       sessionHostLease = null;
       sessionBudgetRoot = null;

package/src/gateways/ws/ws-agent-handler.js

@@ -11,7 +11,7 @@
  * adapter.
  */
 
-import { randomUUID } from "node:crypto";
+import { createHash, randomUUID } from "node:crypto";
 import { agentLoop, formatToolArgs } from "../../runtime/agent-core.js";
 import { classifyToolSideEffect } from "../../lib/side-effect-ledger.js";
 import { DiffReviewFollowUpTracker } from "../../lib/diff-review-follow-up.js";
@@ -81,6 +81,7 @@ import {
   rejectSessionBudgetUsageUnknown,
 } from "../../lib/session-budget-usage.js";
 import { HostResourceBudget } from "../../lib/host-resource-budget.js";
+import { captureAgentEvolutionRuntimeComposition } from "../../lib/evolution/agent-evolution-runtime-composition-brand.js";
 
 const CANONICAL_WS_TURN_QUEUES = new Map();
 const CANONICAL_WS_CLAIM_CAS_ATTEMPTS = 4;
@@ -176,6 +177,7 @@ export class WSAgentHandler {
     sessionHostLease = null,
     sessionBudgetRoot = null,
     hostResourceBudget = null,
+    evolutionCompositionFactory = null,
   }) {
     this.session = session;
     this.interaction = interaction;
@@ -243,6 +245,13 @@ export class WSAgentHandler {
     this._mcpRecoveryRevision = null;
     this._mcpRecoveryClient = null;
     this._agentLoop = runAgentLoop || agentLoop;
+    if (
+      evolutionCompositionFactory !== null &&
+      typeof evolutionCompositionFactory !== "function"
+    ) {
+      throw new TypeError("evolutionCompositionFactory must be a function");
+    }
+    this._evolutionCompositionFactory = evolutionCompositionFactory;
     this._compactionLlmQuery = compactionLlmQuery || null;
     this._compactionSettlementBlock = null;
     this._compactionChatFn =
@@ -297,6 +306,46 @@ export class WSAgentHandler {
       : Object.freeze(hostSystemPrefix);
   }
 
+  async _prepareEvolutionTurn(requestId) {
+    if (!this._evolutionCompositionFactory) return null;
+    const sessionId = String(this.session.id);
+    const stableRequestId =
+      typeof requestId === "string" && requestId.trim()
+        ? requestId.trim()
+        : randomUUID();
+    const runId = `ws-run-${createHash("sha256")
+      .update(`${sessionId}\0${stableRequestId}`, "utf8")
+      .digest("hex")}`;
+    try {
+      const composition = captureAgentEvolutionRuntimeComposition(
+        await this._evolutionCompositionFactory(
+          Object.freeze({
+            mode: "legacy-websocket",
+            runId,
+            sessionId,
+            requestId: stableRequestId,
+            cwd: this.session.projectRoot,
+          }),
+        ),
+      );
+      if (composition.runId !== runId) {
+        throw new TypeError(
+          "Agent evolution composition belongs to another WebSocket turn",
+        );
+      }
+      await composition.evolutionIngress.start();
+      return composition;
+    } catch (cause) {
+      if (cause?.code === "CC_AGENT_EVOLUTION_INGRESS_FAILED") throw cause;
+      const error = new Error(
+        `WebSocket evolution ingress failed: ${cause?.message || String(cause)}`,
+        { cause },
+      );
+      error.code = "CC_AGENT_EVOLUTION_INGRESS_FAILED";
+      throw error;
+    }
+  }
+
   attachInteraction(interaction) {
     if (!interaction || interaction === this.interaction) return false;
     const previous = this.interaction;
@@ -1277,6 +1326,7 @@ export class WSAgentHandler {
     let runRecorded = false;
     let canonicalTurn = null;
     let strictUsageTelemetry = false;
+    let evolutionComposition = null;
 
     try {
       const { session } = this;
@@ -1335,7 +1385,19 @@ export class WSAgentHandler {
           });
           return;
         }
-      } else {
+      }
+      if (this._evolutionCompositionFactory !== null) {
+        evolutionComposition = await this._prepareEvolutionTurn(requestId);
+      }
+      if (evolutionComposition !== null) {
+        await evolutionComposition.evolutionIngress.ingestUserPrompt({
+          content: userMessage,
+          sessionId: session.id,
+          requestId: requestId || null,
+          source: "legacy-websocket",
+        });
+      }
+      if (session.canonicalJsonlSession !== true) {
         session.messages.push({ role: "user", content: userMessage });
       }
       this._recordSessionState("run.started", {
@@ -1520,6 +1582,9 @@ export class WSAgentHandler {
           session.messages,
           loopOptions,
         )) {
+          if (evolutionComposition !== null) {
+            await evolutionComposition.evolutionIngress.ingestAgentEvent(event);
+          }
           switch (event.type) {
             case "slot-filling":
               this.interaction.emit("slot-filling", {
@@ -1710,6 +1775,9 @@ export class WSAgentHandler {
               break;
 
             case "response-complete":
+              if (evolutionComposition !== null) {
+                await evolutionComposition.evolutionIngress.complete();
+              }
               if (session.canonicalJsonlSession === true) {
                 const settled = this._settleCanonicalSuccess(
                   canonicalTurn,

package/src/gateways/ws/ws-server.js

@@ -322,6 +322,14 @@ export class ChainlessChainWSServer extends EventEmitter {
       LEGACY_WS_FLOW_DEFAULTS.maxCommandOutputBytes,
     );
     this._spawnProcess = options.spawn || _deps.spawn;
+    if (
+      options.evolutionCompositionFactory != null &&
+      typeof options.evolutionCompositionFactory !== "function"
+    ) {
+      throw new TypeError("evolutionCompositionFactory must be a function");
+    }
+    this.evolutionCompositionFactory =
+      options.evolutionCompositionFactory || null;
 
     /** Optional Phase-5 envelope bus for fan-out to hosted HTTP SSE. */
     this.envelopeBus = options.envelopeBus || null;

package/src/lib/app-server/cli-agent-kernel-adapter.js

@@ -196,6 +196,10 @@ export class CliAgentKernelAdapter {
         interactiveApprovals: true,
         includePartialMessages: true,
         ephemeral: false,
+        evolutionIngress:
+          turnOptions.evolutionIngress ??
+          this.sessionOptions.evolutionIngress ??
+          null,
       },
       {
         ...this.dependencies,