synergyspec-selfevolving 2.1.0 → 2.1.1

package/dist/core/self-evolution/episode-orchestrator.js

@@ -80,14 +80,30 @@ export async function captureMainArm(opts) {
  * Whether the episode SKIPS the rollback decision + 演进智能体 EVOLVING AGENT:
  * the judge 弃权 abstained (no nameable gap), found no gaps, OR returned the
  * ⑤ `insufficient-signal` verdict (within the A/A noise floor, or a blocked
- * tamper). All three mean "do not evolve on this episode".
+ * tamper). These mean "do not evolve on this episode".
+ *
+ * EXCEPTION (cold-start bootstrap): `insufficient-signal` is honored ONLY as a
+ * genuine can't-tell — a within-noise-floor result (the baseline ran) or a blocked
+ * tamper. On a baseline-skipped episode (policyVersions.baseline === null) there is
+ * no comparison to be uncertain about, so a stray `insufficient-signal` emitted
+ * alongside real gaps (and no tamper) must NOT block: the first v0→v1 evolution has
+ * to be reachable from absolute signal, or a fresh target stays at v0 forever. This
+ * is defense-in-depth behind {@link deriveSingleSampleVerdict}, which already drops
+ * a volunteered verdict to `undefined` on a baseline skip.
  */
 function shouldSkipEvolution(diagnosis) {
     if (diagnosis === null)
         return true;
-    return (diagnosis.abstained ||
-        diagnosis.gaps.length === 0 ||
-        diagnosis.verdict === 'insufficient-signal');
+    if (diagnosis.abstained || diagnosis.gaps.length === 0)
+        return true;
+    if (diagnosis.verdict === 'insufficient-signal') {
+        const baselineSkipped = diagnosis.policyVersions?.baseline === null;
+        const tamper = diagnosis.integrity?.testTamperSuspected ?? false;
+        if (baselineSkipped && !tamper)
+            return false;
+        return true;
+    }
+    return false;
 }
 /**
  * Count the consecutive trailing rolled-back episodes in the 版本账本 ledger.

package/dist/core/self-evolution/reward-agent.js

@@ -154,6 +154,11 @@ export function assembleRewardAgentPrompt(input) {
                 '(no prior policy version in the 版本账本 ledger, or skipped by policy).',
                 'NO comparison is possible: set "rewardBaseline" to null and "advantage" to',
                 'null. Score ONLY the main arm and diagnose against the artifacts below.',
+                'A comparative verdict is impossible with one arm: do NOT emit "main-better",',
+                '"baseline-better", "tie", or "insufficient-signal" (insufficient-signal means',
+                'a genuine can\'t-tell, NOT "no baseline ran"). OMIT "verdict" entirely when you',
+                'can still name a real gap (keep "abstained": false with a "textualGradient");',
+                'use "no-gap" ONLY if the main arm is already clean with nothing to improve.',
                 '',
             ];
         }
@@ -849,12 +854,21 @@ export async function runRewardAgent(opts) {
  * A/A noise floor.
  */
 export function deriveSingleSampleVerdict(parsed) {
+    // A comparative/insufficient verdict is meaningless without a baseline arm. On a
+    // baseline skip (advantage === null — a cold-start episode) IGNORE any verdict the
+    // judge volunteered and return `undefined` (or 'no-gap' if it truly abstained), so
+    // a real diagnosis (named gaps + a textual gradient) is NOT mis-read as the
+    // 'insufficient-signal' abstain that shouldSkipEvolution honors — which would
+    // strand a fresh target at v0 forever. This mirrors the aggregated path
+    // (advantageMean === null ⇒ verdict undefined). A genuine within-noise-floor or
+    // tamper-block 'insufficient-signal' is produced with a baseline present (or
+    // re-forced downstream), so it is unaffected.
+    if (parsed.advantage === null)
+        return parsed.abstained ? 'no-gap' : undefined;
     if (parsed.verdict !== undefined)
         return parsed.verdict;
     if (parsed.abstained)
         return 'no-gap';
-    if (parsed.advantage === null)
-        return undefined;
     if (parsed.advantage > 1e-9)
         return 'main-better';
     if (parsed.advantage < -1e-9)

package/dist/ui/ascii-patterns.d.ts

@@ -1,13 +1,12 @@
 /**
  * ASCII art animation patterns for the welcome screen.
- * SynergySpec-SelfEvolving logo animation - diamond/rhombus shape with hollow center "O".
- */
-/**
- * Welcome animation frames - SynergySpec-SelfEvolving logo building from center
- * 7 rows × 6 columns diamond with hollow center "O"
- * Center bar is 2 cols × 3 rows (rows 3,4,5 cols 3,4)
- * Each frame is an array of strings (lines of ASCII art)
- * Grid: 6 cols × 2 chars = 12 chars wide
+ *
+ * SynergySpec-SelfEvolving theme: a DNA double-helix that "evolves" across
+ * policy versions — the policy version climbs v01 → v08 while a reward bar
+ * fills, so the art itself tells the in-context-RL story (the design template
+ * 策略/POLICY — the main agent's "weights" — maturing as reward accrues each
+ * episode). The final frame is the fully-evolved helix at policy v08 with a
+ * maxed reward readout.
  */
 export declare const WELCOME_ANIMATION: {
     interval: number;

package/dist/ui/ascii-patterns.js

@@ -1,133 +1,67 @@
 /**
  * ASCII art animation patterns for the welcome screen.
- * SynergySpec-SelfEvolving logo animation - diamond/rhombus shape with hollow center "O".
+ *
+ * SynergySpec-SelfEvolving theme: a DNA double-helix that "evolves" across
+ * policy versions — the policy version climbs v01 → v08 while a reward bar
+ * fills, so the art itself tells the in-context-RL story (the design template
+ * 策略/POLICY — the main agent's "weights" — maturing as reward accrues each
+ * episode). The final frame is the fully-evolved helix at policy v08 with a
+ * maxed reward readout.
  */
 // Detect if full Unicode is supported
 const supportsUnicode = process.platform !== 'win32' ||
     !!process.env.WT_SESSION || // Windows Terminal
     !!process.env.TERM_PROGRAM; // Modern terminal
-// Character set based on Unicode support
-// Block characters for pixel-art aesthetic
-const CHARS = supportsUnicode
-    ? { full: '██', dim: '░░', empty: '  ' }
-    : { full: '##', dim: '++', empty: '  ' };
-const _ = CHARS.empty;
-const F = CHARS.full;
-const D = CHARS.dim;
+// Strand node + reward-bar glyphs (ASCII fallback keeps the `o` node so the
+// helix still reads, and stays within the right-column width budget).
+const NODE = supportsUnicode ? '●' : 'o';
+const LINK = supportsUnicode ? '─' : '-';
+const BAR_FULL = supportsUnicode ? '█' : '#';
+const BAR_EMPTY = supportsUnicode ? '░' : '.';
+const TOTAL_VERSIONS = 8;
+const REWARD_BAR_WIDTH = 8;
+function pad2(n) {
+    return n < 10 ? `0${n}` : String(n);
+}
+function rewardBar(version) {
+    const filled = Math.round((version / TOTAL_VERSIONS) * REWARD_BAR_WIDTH);
+    return BAR_FULL.repeat(filled) + BAR_EMPTY.repeat(REWARD_BAR_WIDTH - filled);
+}
 /**
- * Welcome animation frames - SynergySpec-SelfEvolving logo building from center
- * 7 rows × 6 columns diamond with hollow center "O"
- * Center bar is 2 cols × 3 rows (rows 3,4,5 cols 3,4)
- * Each frame is an array of strings (lines of ASCII art)
- * Grid: 6 cols × 2 chars = 12 chars wide
+ * One animation frame: the double-helix (constant height so the cursor-redraw
+ * invariant holds) plus a `policy vNN` header and a `reward ▓▓░░` footer that
+ * advance with the policy version. The twist phase shifts each version so the
+ * strands appear to rotate as the policy evolves.
  */
+function helixFrame(version) {
+    // Two strands crossing over a fixed 7-char span; the cross point walks across
+    // the span by version so successive frames read as a rotating helix.
+    const span = 7;
+    const phase = (version - 1) % span;
+    const strandRow = (offset) => {
+        const a = (phase + offset) % span;
+        const b = (span - 1 - ((phase + offset) % span));
+        const cells = Array.from({ length: span }, () => ' ');
+        cells[a] = NODE;
+        cells[b] = cells[b] === NODE ? NODE : LINK;
+        if (a === b)
+            cells[a] = NODE;
+        return ` ${cells.join('')}`;
+    };
+    return [
+        `  policy v${pad2(version)}`,
+        '',
+        strandRow(0),
+        strandRow(1),
+        strandRow(2),
+        strandRow(3),
+        strandRow(4),
+        '',
+        `  reward ${rewardBar(version)}`,
+    ];
+}
 export const WELCOME_ANIMATION = {
     interval: 120,
-    frames: [
-        // Frame 1: Empty
-        [
-            `${_}${_}${_}${_}${_}${_}${_}${_}`, // padding row 1
-            `${_}${_}${_}${_}${_}${_}${_}${_}`, // padding row 2
-            `${_}${_}${_}${_}${_}${_}${_}${_}`, // padding row 3
-            `${_}${_}${_}${_}${_}${_}${_}${_}`,
-            `${_}${_}${_}${_}${_}${_}${_}${_}`,
-            `${_}${_}${_}${_}${_}${_}${_}${_}`,
-            `${_}${_}${_}${_}${_}${_}${_}${_}`,
-            `${_}${_}${_}${_}${_}${_}${_}${_}`,
-            `${_}${_}${_}${_}${_}${_}${_}${_}`,
-            `${_}${_}${_}${_}${_}${_}${_}${_}`,
-        ],
-        // Frame 2: Center blocks appear (dim) - 2x3 center bar
-        [
-            `${_}${_}${_}${_}${_}${_}${_}${_}`, // padding row 1
-            `${_}${_}${_}${_}${_}${_}${_}${_}`, // padding row 2
-            `${_}${_}${_}${_}${_}${_}${_}${_}`, // padding row 3
-            `${_}${_}${_}${_}${_}${_}${_}${_}`,
-            `${_}${_}${_}${_}${_}${_}${_}${_}`,
-            `${_}${_}${_}${_}${D}${D}${_}${_}`,
-            `${_}${_}${_}${_}${D}${D}${_}${_}`,
-            `${_}${_}${_}${_}${D}${D}${_}${_}`,
-            `${_}${_}${_}${_}${_}${_}${_}${_}`,
-            `${_}${_}${_}${_}${_}${_}${_}${_}`,
-        ],
-        // Frame 3: Center blocks solidify
-        [
-            `${_}${_}${_}${_}${_}${_}${_}${_}`, // padding row 1
-            `${_}${_}${_}${_}${_}${_}${_}${_}`, // padding row 2
-            `${_}${_}${_}${_}${_}${_}${_}${_}`, // padding row 3
-            `${_}${_}${_}${_}${_}${_}${_}${_}`,
-            `${_}${_}${_}${_}${_}${_}${_}${_}`,
-            `${_}${_}${_}${_}${F}${F}${_}${_}`,
-            `${_}${_}${_}${_}${F}${F}${_}${_}`,
-            `${_}${_}${_}${_}${F}${F}${_}${_}`,
-            `${_}${_}${_}${_}${_}${_}${_}${_}`,
-            `${_}${_}${_}${_}${_}${_}${_}${_}`,
-        ],
-        // Frame 4: Top and bottom points appear
-        [
-            `${_}${_}${_}${_}${_}${_}${_}${_}`, // padding row 1
-            `${_}${_}${_}${_}${_}${_}${_}${_}`, // padding row 2
-            `${_}${_}${_}${_}${_}${_}${_}${_}`, // padding row 3
-            `${_}${_}${_}${_}${D}${D}${_}${_}`,
-            `${_}${_}${_}${_}${_}${_}${_}${_}`,
-            `${_}${_}${_}${_}${F}${F}${_}${_}`,
-            `${_}${_}${_}${_}${F}${F}${_}${_}`,
-            `${_}${_}${_}${_}${F}${F}${_}${_}`,
-            `${_}${_}${_}${_}${_}${_}${_}${_}`,
-            `${_}${_}${_}${_}${D}${D}${_}${_}`,
-        ],
-        // Frame 5: Inner ring forming
-        [
-            `${_}${_}${_}${_}${_}${_}${_}${_}`, // padding row 1
-            `${_}${_}${_}${_}${_}${_}${_}${_}`, // padding row 2
-            `${_}${_}${_}${_}${_}${_}${_}${_}`, // padding row 3
-            `${_}${_}${_}${_}${F}${F}${_}${_}`,
-            `${_}${_}${_}${D}${_}${_}${D}${_}`,
-            `${_}${_}${_}${_}${F}${F}${_}${_}`,
-            `${_}${_}${_}${_}${F}${F}${_}${_}`,
-            `${_}${_}${_}${_}${F}${F}${_}${_}`,
-            `${_}${_}${_}${D}${_}${_}${D}${_}`,
-            `${_}${_}${_}${_}${F}${F}${_}${_}`,
-        ],
-        // Frame 6: Outer ring appearing
-        [
-            `${_}${_}${_}${_}${_}${_}${_}${_}`, // padding row 1
-            `${_}${_}${_}${_}${_}${_}${_}${_}`, // padding row 2
-            `${_}${_}${_}${_}${_}${_}${_}${_}`, // padding row 3
-            `${_}${_}${_}${_}${F}${F}${_}${_}`,
-            `${_}${_}${_}${F}${_}${_}${F}${_}`,
-            `${_}${_}${D}${_}${F}${F}${_}${D}`,
-            `${_}${_}${D}${_}${F}${F}${_}${D}`,
-            `${_}${_}${D}${_}${F}${F}${_}${D}`,
-            `${_}${_}${_}${F}${_}${_}${F}${_}`,
-            `${_}${_}${_}${_}${F}${F}${_}${_}`,
-        ],
-        // Frame 7: Full logo
-        [
-            `${_}${_}${_}${_}${_}${_}${_}${_}`, // padding row 1
-            `${_}${_}${_}${_}${_}${_}${_}${_}`, // padding row 2
-            `${_}${_}${_}${_}${_}${_}${_}${_}`, // padding row 3
-            `${_}${_}${_}${_}${F}${F}${_}${_}`,
-            `${_}${_}${_}${F}${_}${_}${F}${_}`,
-            `${_}${_}${F}${_}${F}${F}${_}${F}`,
-            `${_}${_}${F}${_}${F}${F}${_}${F}`,
-            `${_}${_}${F}${_}${F}${F}${_}${F}`,
-            `${_}${_}${_}${F}${_}${_}${F}${_}`,
-            `${_}${_}${_}${_}${F}${F}${_}${_}`,
-        ],
-        // Frame 8: Hold complete logo
-        [
-            `${_}${_}${_}${_}${_}${_}${_}${_}`, // padding row 1
-            `${_}${_}${_}${_}${_}${_}${_}${_}`, // padding row 2
-            `${_}${_}${_}${_}${_}${_}${_}${_}`, // padding row 3
-            `${_}${_}${_}${_}${F}${F}${_}${_}`,
-            `${_}${_}${_}${F}${_}${_}${F}${_}`,
-            `${_}${_}${F}${_}${F}${F}${_}${F}`,
-            `${_}${_}${F}${_}${F}${F}${_}${F}`,
-            `${_}${_}${F}${_}${F}${F}${_}${F}`,
-            `${_}${_}${_}${F}${_}${_}${F}${_}`,
-            `${_}${_}${_}${_}${F}${F}${_}${_}`,
-        ],
-    ],
+    frames: Array.from({ length: TOTAL_VERSIONS }, (_v, i) => helixFrame(i + 1)),
 };
 //# sourceMappingURL=ascii-patterns.js.map

package/dist/ui/welcome-screen.d.ts

@@ -2,6 +2,14 @@
  * Animated welcome screen for the experimental artifact workflow setup.
  * Shows side-by-side layout with animated ASCII art on left and welcome text on right.
  */
+/**
+ * Welcome text content (right column)
+ */
+export declare function getWelcomeText(): string[];
+/**
+ * Renders a single frame with side-by-side layout
+ */
+export declare function renderFrame(artLines: string[], textLines: string[]): string;
 /**
  * Shows the animated welcome screen.
  * Returns when user presses Enter.

package/dist/ui/welcome-screen.js

@@ -11,7 +11,7 @@ const ART_COLUMN_WIDTH = 24;
 /**
  * Welcome text content (right column)
  */
-function getWelcomeText() {
+export function getWelcomeText() {
     return [
         chalk.white.bold('Welcome to SynergySpec-SelfEvolving'),
         chalk.dim('A lightweight spec-driven framework'),
@@ -31,7 +31,7 @@ function getWelcomeText() {
 /**
  * Renders a single frame with side-by-side layout
  */
-function renderFrame(artLines, textLines) {
+export function renderFrame(artLines, textLines) {
     const maxLines = Math.max(artLines.length, textLines.length);
     const lines = [];
     for (let i = 0; i < maxLines; i++) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "synergyspec-selfevolving",
-  "version": "2.1.0",
+  "version": "2.1.1",
   "description": "AI-native system for spec-driven development",
   "keywords": [
     "synergyspec-selfevolving",