@evomap/evolver-core 2.0.0-beta.0

package/dist/wire/index.d.ts

@@ -0,0 +1,91 @@
+/**
+ * 资产 wire 层. SSOT = @evomap/gep-sdk/schemas/*.schema.json (D19).
+ * 字段一律 snake_case 锁定 (asset_id 跨实现契约); 本仓不发明 wire 字段, 只镜像 + 重导出工具.
+ */
+import type { GeneRoutingHint, GeneToolPolicy } 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];
+/** Gene = 基因型/方法论 (gene.schema.json). */
+export interface Gene {
+    type: 'Gene';
+    schema_version: string;
+    id: string;
+    category: GepCategory;
+    signals_match: string[];
+    preconditions?: string[];
+    strategy: string[];
+    constraints: {
+        max_files: number;
+        forbidden_paths: string[];
+    };
+    validation: string[];
+    summary?: string;
+    epigenetic_marks?: string[];
+    learning_history?: unknown[];
+    anti_patterns?: unknown[];
+    routing_hint?: GeneRoutingHint | null;
+    tool_policy?: GeneToolPolicy | null;
+    asset_id: string;
+}
+/** Capsule = 表现型/纯进化产物 (capsule.schema.json). */
+export interface Capsule {
+    type: 'Capsule';
+    schema_version: string;
+    id: string;
+    trigger: string[];
+    gene: string;
+    summary: string;
+    confidence: number;
+    blast_radius: {
+        files: number;
+        lines: number;
+    };
+    outcome: {
+        status: OutcomeStatus;
+        score: number;
+    };
+    resolution_status?: 'pending' | 'suppressed_observationally' | 'resolved_by_evidence' | 'regressed' | 'inconclusive';
+    proof_of_work?: unknown;
+    execution_trace?: unknown[];
+    trigger_context?: unknown;
+    asset_id: string;
+    [k: string]: unknown;
+}
+/** EvolutionEvent = 世代记录 (evolution-event.schema.json). outcome 真值在此 (硬化 A4). */
+export interface EvolutionEvent {
+    type: 'EvolutionEvent';
+    schema_version: string;
+    id: string;
+    parent?: string | null;
+    intent: GepCategory;
+    signals: string[];
+    genes_used: string[];
+    mutation_id: string;
+    blast_radius: {
+        files: number;
+        lines: number;
+    };
+    outcome: {
+        status: OutcomeStatus;
+        score: number;
+    };
+    capsule_id?: string | null;
+    source_type: SourceType;
+    asset_id: string;
+    [k: string]: unknown;
+}
+/** Mutation = 变异 (瞬态, mutation.schema.json). */
+export interface Mutation {
+    type: 'Mutation';
+    id: string;
+    category: GepCategory;
+    trigger_signals: string[];
+    target: string;
+    expected_effect: string;
+    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';

package/dist/wire/index.js

@@ -0,0 +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';

package/dist/wire/schemaGate.d.ts

@@ -0,0 +1,11 @@
+export interface WireValidation {
+    ok: boolean;
+    errors: string[];
+}
+/**
+ * 结构校验(required 齐 + additionalProperties:false 不许多字段). 轻量, 不做深类型校验(那是发版 CI conformance 的活).
+ * 用途: 发 hub 前确认资产能被 gep-sdk schema 接受; v2-delta(proof_of_work/resolution_status)在 bump 前会在此暴露.
+ */
+export declare function validateWire(asset: Record<string, unknown>): WireValidation;
+/** schema 已声明的字段白名单(给上层判断哪些 v2-delta 尚未进 SDK). */
+export declare function schemaProperties(type: string): string[];

package/dist/wire/schemaGate.js

@@ -0,0 +1,49 @@
+import { createRequire } from 'node:module';
+import { readFileSync } from 'node:fs';
+const nodeRequire = createRequire(import.meta.url);
+const SCHEMA_SUBPATH = {
+    Gene: '@evomap/gep-sdk/schemas/gene.schema.json',
+    Capsule: '@evomap/gep-sdk/schemas/capsule.schema.json',
+    EvolutionEvent: '@evomap/gep-sdk/schemas/evolution-event.schema.json',
+};
+const cache = new Map();
+function loadSchema(type) {
+    const sub = SCHEMA_SUBPATH[type];
+    if (!sub)
+        return undefined;
+    const cached = cache.get(type);
+    if (cached)
+        return cached;
+    const path = nodeRequire.resolve(sub);
+    const schema = JSON.parse(readFileSync(path, 'utf8'));
+    cache.set(type, schema);
+    return schema;
+}
+/**
+ * 结构校验(required 齐 + additionalProperties:false 不许多字段). 轻量, 不做深类型校验(那是发版 CI conformance 的活).
+ * 用途: 发 hub 前确认资产能被 gep-sdk schema 接受; v2-delta(proof_of_work/resolution_status)在 bump 前会在此暴露.
+ */
+export function validateWire(asset) {
+    const errors = [];
+    const type = asset['type'];
+    if (typeof type !== 'string')
+        return { ok: false, errors: ['缺 type 字段'] };
+    const schema = loadSchema(type);
+    if (!schema)
+        return { ok: false, errors: [`未知资产类型: ${type}`] };
+    for (const req of schema.required ?? []) {
+        if (asset[req] === undefined || asset[req] === null)
+            errors.push(`缺 required 字段: ${req}`);
+    }
+    if (schema.additionalProperties === false && schema.properties) {
+        const allowed = new Set(Object.keys(schema.properties));
+        for (const k of Object.keys(asset))
+            if (!allowed.has(k))
+                errors.push(`多余字段(additionalProperties:false 会 reject): ${k}`);
+    }
+    return { ok: errors.length === 0, errors };
+}
+/** schema 已声明的字段白名单(给上层判断哪些 v2-delta 尚未进 SDK). */
+export function schemaProperties(type) {
+    return Object.keys(loadSchema(type)?.properties ?? {});
+}

package/dist/workflow/dsl.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Dynamic workflow DSL(M4B, 轨B 孵化). 声明式 + 受限表达式, **无任意 JS**(从语言层消除一类风险).
+ * 表达式表示为**结构化对象**(非字符串解析): 引用 Ref + 白名单 core 调用, 安全 by-construction.
+ */
+/** 引用: input.<k> / steps.<id>.<k> / item(foreach 内). */
+export interface Ref {
+    ref: string;
+}
+export type Literal = string | number | boolean | null;
+export type Value = Literal | Ref;
+export declare function isRef(v: unknown): v is Ref;
+/** 白名单 core 调用(受限求值的唯一计算手段). */
+export interface CoreCall {
+    fn: string;
+    args: Value[];
+}
+export interface ScriptStep {
+    id: string;
+    kind: 'script';
+    setOutput: string;
+    call: CoreCall;
+}
+export interface AgentStep {
+    id: string;
+    kind: 'agent';
+    prompt: string;
+    outputKey?: string;
+}
+export interface ForeachStep {
+    id: string;
+    kind: 'foreach';
+    over: Ref;
+    as: string;
+    parallel?: boolean;
+    body: WorkflowStep[];
+    collect?: string;
+}
+export interface IfStep {
+    id: string;
+    kind: 'if';
+    cond: Value;
+    then: WorkflowStep[];
+    else?: WorkflowStep[];
+}
+export type WorkflowStep = ScriptStep | AgentStep | ForeachStep | IfStep;
+export interface WorkflowSpec {
+    name: string;
+    input?: Record<string, unknown>;
+    steps: WorkflowStep[];
+    output?: Ref;
+}
+/** 白名单 core 函数表(受限). 起步集: 列表/过滤/字符串/逻辑. 不含 fs/net/eval. */
+export type CoreFn = (...args: unknown[]) => unknown;
+export declare const CORE_WHITELIST: Record<string, CoreFn>;

package/dist/workflow/dsl.js

@@ -0,0 +1,15 @@
+/**
+ * Dynamic workflow DSL(M4B, 轨B 孵化). 声明式 + 受限表达式, **无任意 JS**(从语言层消除一类风险).
+ * 表达式表示为**结构化对象**(非字符串解析): 引用 Ref + 白名单 core 调用, 安全 by-construction.
+ */
+export function isRef(v) { return typeof v === 'object' && v !== null && 'ref' in v; }
+export const CORE_WHITELIST = {
+    list_len: (a) => (Array.isArray(a) ? a.length : 0),
+    filter_by_mask: (items, mask) => (Array.isArray(items) && Array.isArray(mask) ? items.filter((_, i) => Boolean(mask[i])) : []),
+    contains: (hay, needle) => String(hay).includes(String(needle)),
+    concat: (...xs) => xs.flat(),
+    upper: (s) => String(s).toUpperCase(),
+    eq: (a, b) => a === b,
+    not: (a) => !a,
+    identity: (a) => a,
+};

package/dist/workflow/engine.d.ts

@@ -0,0 +1,30 @@
+import { type WorkflowSpec, type CoreFn } from './dsl.js';
+export interface WorkflowContext {
+    input: Record<string, unknown>;
+    steps: Record<string, unknown>;
+    item?: unknown;
+}
+/** agent step 桥(注入 runtime; 孵化期可注 stub). */
+export type AgentBridge = (prompt: string, ctx: WorkflowContext) => Promise<unknown> | unknown;
+export interface WorkflowEngineDeps {
+    core?: Record<string, CoreFn>;
+    agent: AgentBridge;
+}
+export declare class WorkflowError extends Error {
+    constructor(message: string);
+}
+/**
+ * Workflow 执行引擎(M4B-2 孵化). 解释 DAG: script(受限 core)/agent(桥)/foreach(可并行)/if.
+ * 无 eval/无任意 JS; 编排层声明式, 计算只走白名单 core.
+ */
+export declare class WorkflowEngine {
+    private readonly deps;
+    private readonly core;
+    constructor(deps: WorkflowEngineDeps);
+    run(spec: WorkflowSpec): Promise<{
+        output: unknown;
+        ctx: WorkflowContext;
+    }>;
+    private runSteps;
+    private runStep;
+}

package/dist/workflow/engine.js

@@ -0,0 +1,94 @@
+import { isRef, CORE_WHITELIST, } from './dsl.js';
+export class WorkflowError extends Error {
+    constructor(message) { super(message); this.name = 'WorkflowError'; }
+}
+/** 解析引用: input.x / steps.id.key / item[.path]. 不支持任意属性链外的求值. */
+function resolveRef(ref, ctx) {
+    const [head, ...rest] = ref.split('.');
+    let base;
+    if (head === 'input')
+        base = ctx.input;
+    else if (head === 'steps') {
+        const stepId = rest.shift();
+        base = stepId !== undefined ? ctx.steps[stepId] : undefined;
+    }
+    else if (head === 'item')
+        base = ctx.item;
+    else
+        throw new WorkflowError(`非法引用根: ${head}`);
+    for (const k of rest) {
+        if (base == null)
+            return undefined;
+        base = base[k];
+    }
+    return base;
+}
+function evalValue(v, ctx) {
+    return isRef(v) ? resolveRef(v.ref, ctx) : v;
+}
+function evalCore(call, ctx, core) {
+    const fn = core[call.fn];
+    if (!fn)
+        throw new WorkflowError(`core 函数不在白名单: ${call.fn}`);
+    return fn(...call.args.map((a) => evalValue(a, ctx)));
+}
+/**
+ * Workflow 执行引擎(M4B-2 孵化). 解释 DAG: script(受限 core)/agent(桥)/foreach(可并行)/if.
+ * 无 eval/无任意 JS; 编排层声明式, 计算只走白名单 core.
+ */
+export class WorkflowEngine {
+    deps;
+    core;
+    constructor(deps) {
+        this.deps = deps;
+        this.core = { ...CORE_WHITELIST, ...(deps.core ?? {}) };
+    }
+    async run(spec) {
+        const ctx = { input: spec.input ?? {}, steps: {} };
+        await this.runSteps(spec.steps, ctx);
+        const output = spec.output ? resolveRef(spec.output.ref, ctx) : undefined;
+        return { output, ctx };
+    }
+    async runSteps(steps, ctx) {
+        for (const step of steps)
+            await this.runStep(step, ctx);
+    }
+    async runStep(step, ctx) {
+        switch (step.kind) {
+            case 'script': {
+                ctx.steps[step.id] = { [step.setOutput]: evalCore(step.call, ctx, this.core) };
+                return;
+            }
+            case 'agent': {
+                ctx.steps[step.id] = { [step.outputKey ?? 'output']: await this.deps.agent(step.prompt, ctx) };
+                return;
+            }
+            case 'if': {
+                const branch = evalValue(step.cond, ctx) ? step.then : (step.else ?? []);
+                await this.runSteps(branch, ctx);
+                return;
+            }
+            case 'foreach': {
+                const items = resolveRef(step.over.ref, ctx);
+                if (!Array.isArray(items))
+                    throw new WorkflowError(`foreach.over 非数组: ${step.over.ref}`);
+                const runOne = async (item) => {
+                    const sub = { input: ctx.input, steps: { ...ctx.steps }, item };
+                    await this.runSteps(step.body, sub);
+                    // 子步输出汇总: 取最后一个 body step 的输出(保证每项都处理)
+                    const last = step.body[step.body.length - 1];
+                    return last ? sub.steps[last.id] : undefined;
+                };
+                const results = step.parallel
+                    ? await Promise.all(items.map(runOne))
+                    : await items.reduce(async (accP, it) => { const acc = await accP; acc.push(await runOne(it)); return acc; }, Promise.resolve([]));
+                ctx.steps[step.id] = { [step.collect ?? 'results']: results };
+                return;
+            }
+            default: {
+                const _exhaustive = step;
+                throw new WorkflowError(`未知 step kind: ${JSON.stringify(_exhaustive)}`);
+            }
+        }
+    }
+}

package/dist/workflow/index.d.ts

@@ -0,0 +1,2 @@
+export * from './dsl.js';
+export * from './engine.js';

package/dist/workflow/index.js

@@ -0,0 +1,2 @@
+export * from './dsl.js';
+export * from './engine.js';

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@evomap/evolver-core",
+  "version": "2.0.0-beta.0",
+  "private": false,
+  "type": "module",
+  "description": "hub-无关核心: 算法引擎/原材料/mailbox/资产库/workflow",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@evomap/gep-sdk": "1.12.1",
+    "zod": "^3.24.1",
+    "ulid": "^2.3.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "tag": "v2-beta"
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    "package.json"
+  ]
+}