@evomap/evolver-core 2.0.0-beta.1 → 2.0.0-beta.2

package/dist/wire/geneHints.js

@@ -22,13 +22,22 @@
 export const ROUTING_TIERS = ['cheap', 'mid', 'expensive'];
 export const REASONING_LEVELS = ['off', 'low', 'medium', 'high'];
 export const TOOL_POLICY_SEVERITIES = ['warn', 'block'];
+/**
+ * Provenance classification (V1 #302 classifyProvenance, aligned with TaskGenome Bench §3.1): a Gene's value
+ * depends on WHERE it came from, not on being short. The three tiers:
+ *   evolved   -- distilled from a real solve -> fail -> mutate -> pass trajectory; beats Skills (+8.7..+15.5pp)
+ *   distilled -- transcribed from reference/teacher text with no real failing trajectory; WORSE than Skills (-3.2..-11.2pp)
+ *   manual    -- pure human transcription, no execution evidence at all
+ * The high-value payload of an evolved Gene is the corrective_insight that flipped the outcome.
+ */
+export const GENERATION_SOURCES = ['evolved', 'distilled', 'manual'];
 /**
  * The v2-delta hint field names, in one place — the intake gate strips these before the gep-sdk schema check.
  * IMPORTANT: when a gep-sdk gene-schema bump makes one of these first-class, REMOVE it from this list in the
  * same change. Otherwise intakeGene keeps stripping a now-validated field before validateWire (fail-open — the
  * field's new schema constraints go unchecked at intake) while asset_id still commits it.
  */
-export const GENE_HINT_FIELDS = ['routing_hint', 'tool_policy'];
+export const GENE_HINT_FIELDS = ['routing_hint', 'tool_policy', 'generation_meta'];
 function includesEnum(set, v) {
     return typeof v === 'string' && set.includes(v);
 }
@@ -89,6 +98,48 @@ function cleanToolList(raw) {
     const cleaned = raw.filter((x) => typeof x === 'string' && x.length > 0);
     return cleaned.length > 0 ? cleaned : undefined;
 }
+/**
+ * Normalize an arbitrary generation_meta fragment to a strict { source, quality_score?, quality_heuristics?,
+ * overcame_errors? } object, or null. Lossy (mirrors normalizeRoutingHint / normalizeToolPolicy): unknown source
+ * values are dropped (the whole block collapses to null — a generation_meta with no recognized source carries no
+ * usable provenance signal); quality_score is clamped to [0,1]; heuristics keeps only its numeric/boolean fields;
+ * overcame_errors keeps only non-empty strings. A block with a valid source but all-else-empty still survives (source
+ * alone is a meaningful provenance tag); only a missing/unknown source yields null.
+ */
+export function normalizeGenerationMeta(raw) {
+    if (!raw || typeof raw !== 'object')
+        return null;
+    const r = raw;
+    const source = r['source'];
+    if (!includesEnum(GENERATION_SOURCES, source))
+        return null;
+    const out = { source };
+    const qs = r['quality_score'];
+    if (typeof qs === 'number' && Number.isFinite(qs))
+        out.quality_score = Math.max(0, Math.min(1, qs));
+    const eh = r['quality_heuristics'];
+    if (eh && typeof eh === 'object') {
+        const h = eh;
+        const heuristics = {};
+        const numFields = [
+            'strategy_steps', 'avoid_count', 'validation_declared_count', 'validation_runnable_count',
+            'signals_extracted', 'preconditions_extracted', 'trajectory_depth',
+        ];
+        for (const k of numFields) {
+            const v = h[k];
+            if (typeof v === 'number' && Number.isFinite(v))
+                heuristics[k] = v;
+        }
+        if (typeof h['has_corrective_insight'] === 'boolean')
+            heuristics.has_corrective_insight = h['has_corrective_insight'];
+        if (Object.keys(heuristics).length > 0)
+            out.quality_heuristics = heuristics;
+    }
+    const errs = cleanToolList(r['overcame_errors']);
+    if (errs)
+        out.overcame_errors = errs;
+    return out;
+}
 /** Strip the v2-delta hint fields from a gene-shaped object (used to validate the gep-sdk-known core). */
 export function stripGeneHints(gene) {
     const hidden = GENE_HINT_FIELDS;

package/dist/wire/index.d.ts

@@ -2,12 +2,18 @@
  * 资产 wire 层. SSOT = @evomap/gep-sdk/schemas/*.schema.json (D19).
  * 字段一律 snake_case 锁定 (asset_id 跨实现契约); 本仓不发明 wire 字段, 只镜像 + 重导出工具.
  */
-import type { GeneRoutingHint, GeneToolPolicy } from './geneHints.js';
+import type { GeneRoutingHint, GeneToolPolicy, GenerationMeta } from './geneHints.js';
 export { SCHEMA_VERSION, canonicalize, computeAssetId, verifyAssetId } from '@evomap/gep-sdk';
 export type GepCategory = typeof import('@evomap/gep-sdk').GEP_GENE_CATEGORIES[number];
 export type OutcomeStatus = typeof import('@evomap/gep-sdk').GEP_OUTCOME_STATUSES[number];
 export type SourceType = typeof import('@evomap/gep-sdk').GEP_SOURCE_TYPES[number];
 export type RiskLevel = typeof import('@evomap/gep-sdk').GEP_RISK_LEVELS[number];
+export type CapsuleVisibility = typeof import('@evomap/gep-sdk').GEP_CAPSULE_VISIBILITIES[number];
+export type CapsuleCostTier = typeof import('@evomap/gep-sdk').GEP_CAPSULE_COST_TIERS[number];
+export interface CapsuleAuthor {
+    handle: string;
+    evox_install_id: string;
+}
 /** Gene = 基因型/方法论 (gene.schema.json). */
 export interface Gene {
     type: 'Gene';
@@ -28,6 +34,7 @@ export interface Gene {
     anti_patterns?: unknown[];
     routing_hint?: GeneRoutingHint | null;
     tool_policy?: GeneToolPolicy | null;
+    generation_meta?: GenerationMeta | null;
     asset_id: string;
 }
 /** Capsule = 表现型/纯进化产物 (capsule.schema.json). */
@@ -49,6 +56,11 @@ export interface Capsule {
     };
     resolution_status?: 'pending' | 'suppressed_observationally' | 'resolved_by_evidence' | 'regressed' | 'inconclusive';
     proof_of_work?: unknown;
+    visibility?: CapsuleVisibility | null;
+    scope?: string[] | null;
+    cost_tier?: CapsuleCostTier | null;
+    pack_of?: string[] | null;
+    author?: CapsuleAuthor | null;
     execution_trace?: unknown[];
     trigger_context?: unknown;
     asset_id: string;
@@ -88,4 +100,4 @@ export interface Mutation {
     risk_level: RiskLevel;
 }
 export { validateWire, schemaProperties, type WireValidation } from './schemaGate.js';
-export { ROUTING_TIERS, REASONING_LEVELS, TOOL_POLICY_SEVERITIES, GENE_HINT_FIELDS, normalizeRoutingHint, normalizeToolPolicy, stripGeneHints, type RoutingTier, type ReasoningLevel, type ToolPolicySeverity, type GeneRoutingHint, type GeneToolPolicy, } from './geneHints.js';
+export { ROUTING_TIERS, REASONING_LEVELS, TOOL_POLICY_SEVERITIES, GENERATION_SOURCES, GENE_HINT_FIELDS, normalizeRoutingHint, normalizeToolPolicy, normalizeGenerationMeta, stripGeneHints, type RoutingTier, type ReasoningLevel, type ToolPolicySeverity, type GenerationSource, type GeneRoutingHint, type GeneToolPolicy, type GeneGenerationHeuristics, type GenerationMeta, } from './geneHints.js';

package/dist/wire/index.js

@@ -1,3 +1,3 @@
 export { SCHEMA_VERSION, canonicalize, computeAssetId, verifyAssetId } from '@evomap/gep-sdk';
 export { validateWire, schemaProperties } from './schemaGate.js';
-export { ROUTING_TIERS, REASONING_LEVELS, TOOL_POLICY_SEVERITIES, GENE_HINT_FIELDS, normalizeRoutingHint, normalizeToolPolicy, stripGeneHints, } from './geneHints.js';
+export { ROUTING_TIERS, REASONING_LEVELS, TOOL_POLICY_SEVERITIES, GENERATION_SOURCES, GENE_HINT_FIELDS, normalizeRoutingHint, normalizeToolPolicy, normalizeGenerationMeta, stripGeneHints, } from './geneHints.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@evomap/evolver-core",
-  "version": "2.0.0-beta.1",
+  "version": "2.0.0-beta.2",
   "private": false,
   "type": "module",
   "description": "hub-无关核心: 算法引擎/原材料/mailbox/资产库/workflow",
@@ -23,6 +23,7 @@
   },
   "files": [
     "dist/",
+    "assets/",
     "README.md",
     "package.json"
   ]