@principles/core 1.73.0

package/dist/workflow-funnel-loader.d.ts

@@ -0,0 +1,143 @@
+/**
+ * WorkflowFunnelLoader — Loads and watches workflows.yaml as the SSOT
+ * for WORKFLOW_FUNNELS definition table.
+ *
+ * D-01: workflows.yaml is the single source of truth (SSOT).
+ * D-02: workflows.yaml lives in .state/ directory per workspace.
+ * D-03: Developers manually maintain workflows.yaml (no auto-registration).
+ * D-04: Code only reads YAML, never writes it.
+ */
+import type { RuntimeKind } from './runtime-v2/runtime-protocol.js';
+/**
+ * A single stage in a workflow funnel.
+ * Policy fields are optional — existing stages without policy fields remain valid.
+ */
+export interface WorkflowStage {
+    /** Stage name within the funnel (e.g., 'dreamer_completed') */
+    name: string;
+    /** Event type string (e.g., 'nocturnal_dreamer_completed') */
+    eventType: string;
+    /** Event category (e.g., 'completed', 'created', 'blocked') */
+    eventCategory: string;
+    /** Dot-path to stats field (e.g., 'evolution.nocturnalDreamerCompleted') */
+    statsField: string;
+    /** Optional per-stage timeout in milliseconds (overrides funnel-level timeout) */
+    timeoutMs?: number;
+    /** Optional success criteria expression for this stage */
+    successCriteria?: string;
+    /** When true, this stage is disabled and skipped by consumers */
+    legacyDisabled?: boolean;
+    /** Observability tags for this stage */
+    observability?: {
+        enabled?: boolean;
+        emitEvents?: string[];
+    };
+}
+/**
+ * Funnel-level policy that applies to all stages unless overridden per-stage.
+ */
+export interface FunnelPolicy {
+    /** Default timeout for all stages in this funnel (ms) */
+    timeoutMs?: number;
+    /** Stage execution order enforcement */
+    stageOrder?: 'strict' | 'relaxed';
+    /** Legacy flag — when true, funnel is superseded by a newer implementation */
+    legacyDisabled?: boolean;
+    /** Observability configuration for the entire funnel */
+    observability?: {
+        enabled?: boolean;
+        emitEvents?: string[];
+        logLevel?: 'debug' | 'info' | 'warn' | 'error';
+    };
+    /** Runtime adapter kind. Default: 'pi-ai' (D-04). */
+    runtimeKind?: RuntimeKind;
+    /** OpenClaw CLI mode — required when runtimeKind is 'openclaw-cli'. */
+    openclawMode?: 'local' | 'gateway';
+    /** LLM provider name (e.g., 'openrouter', 'anthropic'). Required for pi-ai. */
+    provider?: string;
+    /** Model ID (e.g., 'anthropic/claude-sonnet-4'). Required for pi-ai. */
+    model?: string;
+    /** Name of the environment variable containing the API key. Required for pi-ai. */
+    apiKeyEnv?: string;
+    /** Maximum retry attempts for transient LLM failures. */
+    maxRetries?: number;
+    /** Custom base URL for OpenAI-compatible providers not in pi-ai's built-in registry. */
+    baseUrl?: string;
+    /** Maximum repair attempts for structured output repair loop (PRI-271 A1). Default: 3. */
+    maxRepairAttempts?: number;
+    /** Output path strategy for structured output (PRI-271 B3). Default: 'tool_call_first'. */
+    outputPathStrategy?: 'tool_call_first' | 'json_mode_first' | 'free_form_only';
+}
+/**
+ * A workflow funnel definition.
+ */
+export interface WorkflowFunnel {
+    workflowId: string;
+    stages: WorkflowStage[];
+    /** Optional funnel-level policy applied to all stages */
+    policy?: FunnelPolicy;
+}
+/**
+ * Root of workflows.yaml schema.
+ */
+export interface WorkflowFunnelConfig {
+    version: string;
+    funnels: WorkflowFunnel[];
+}
+/**
+ * Loads and watches workflows.yaml, building an in-memory WORKFLOW_FUNNELS table.
+ *
+ * Failure semantics:
+ * - Missing file: clears in-memory funnels, uses empty Map
+ * - Malformed YAML: preserves last known-good config, logs warning
+ * - Schema-invalid YAML: same as malformed YAML
+ */
+export declare class WorkflowFunnelLoader {
+    /** In-memory WORKFLOW_FUNNELS table: workflowId -> stages */
+    private readonly funnels;
+    /** Full funnel table with policy: workflowId -> WorkflowFunnel */
+    private readonly fullFunnels;
+    private readonly configPath;
+    /** fs.watch() handle for cleanup */
+    private watchHandle?;
+    /** YAML parse warnings from last load() call */
+    private readonly warnings;
+    constructor(stateDir: string);
+    /**
+     * Load (or reload) workflows.yaml from disk.
+     * On parse/validation failure, preserves the last known-good config.
+     * On missing file, clears to empty.
+     */
+    load(): void;
+    /**
+     * Start watching workflows.yaml for changes.
+     */
+    watch(): void;
+    /** Stop watching and clean up the FSWatcher. */
+    dispose(): void;
+    /** Get all stages for a workflow. */
+    getStages(workflowId: string): WorkflowStage[];
+    /**
+     * Get the full funnel definition (including policy) for a workflow.
+     * Returns undefined if the funnel is not found.
+     * Returns a deep clone — consumer mutations do not affect internal state.
+     */
+    getFunnel(workflowId: string): WorkflowFunnel | undefined;
+    /**
+     * Get the full WORKFLOW_FUNNELS table.
+     * Returns a deep clone — consumer mutations do not affect internal state.
+     */
+    getAllFunnels(): Map<string, WorkflowStage[]>;
+    /**
+     * Get the full WORKFLOW_FUNNELS table including policy.
+     * Returns a Map of workflowId -> WorkflowFunnel (stages and policy cloned).
+     */
+    getAllFunnelsWithPolicy(): Map<string, WorkflowFunnel>;
+    /** Returns warnings from the last load() call. */
+    getWarnings(): string[];
+    /** Get the config file path. */
+    getConfigPath(): string;
+    /** Deep clone a funnel to prevent consumer mutations. */
+    private static cloneFunnel;
+}
+//# sourceMappingURL=workflow-funnel-loader.d.ts.map

package/dist/workflow-funnel-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-funnel-loader.d.ts","sourceRoot":"","sources":["../src/workflow-funnel-loader.ts"],"names":[],"mappings":"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"}

package/dist/workflow-funnel-loader.js

@@ -0,0 +1,174 @@
+/**
+ * WorkflowFunnelLoader — Loads and watches workflows.yaml as the SSOT
+ * for WORKFLOW_FUNNELS definition table.
+ *
+ * D-01: workflows.yaml is the single source of truth (SSOT).
+ * D-02: workflows.yaml lives in .state/ directory per workspace.
+ * D-03: Developers manually maintain workflows.yaml (no auto-registration).
+ * D-04: Code only reads YAML, never writes it.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import yaml from 'js-yaml';
+// ─────────────────────────────────────────────────────────────────────────────
+// WorkflowFunnelLoader
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Loads and watches workflows.yaml, building an in-memory WORKFLOW_FUNNELS table.
+ *
+ * Failure semantics:
+ * - Missing file: clears in-memory funnels, uses empty Map
+ * - Malformed YAML: preserves last known-good config, logs warning
+ * - Schema-invalid YAML: same as malformed YAML
+ */
+export class WorkflowFunnelLoader {
+    /** In-memory WORKFLOW_FUNNELS table: workflowId -> stages */
+    funnels = new Map();
+    /** Full funnel table with policy: workflowId -> WorkflowFunnel */
+    fullFunnels = new Map();
+    configPath;
+    /** fs.watch() handle for cleanup */
+    watchHandle;
+    /** YAML parse warnings from last load() call */
+    warnings = [];
+    constructor(stateDir) {
+        this.configPath = path.join(stateDir, 'workflows.yaml');
+        this.load();
+    }
+    /**
+     * Load (or reload) workflows.yaml from disk.
+     * On parse/validation failure, preserves the last known-good config.
+     * On missing file, clears to empty.
+     */
+    load() {
+        this.warnings.length = 0;
+        if (!fs.existsSync(this.configPath)) {
+            this.warnings.push('workflows.yaml file not found.');
+            this.funnels.clear();
+            this.fullFunnels.clear();
+            return;
+        }
+        try {
+            const content = fs.readFileSync(this.configPath, 'utf-8');
+            const config = yaml.load(content, { schema: yaml.DEFAULT_SCHEMA });
+            if (!config || typeof config.version !== 'string' || !Array.isArray(config.funnels)) {
+                const msg = 'workflows.yaml validation failed: missing version or funnels array. Preserving last valid config.';
+                console.warn(`[WorkflowFunnelLoader] ${msg}`);
+                this.warnings.push(msg);
+                return;
+            }
+            const newFunnels = new Map();
+            const newFullFunnels = new Map();
+            for (const funnel of config.funnels) {
+                if (funnel?.workflowId && typeof funnel.workflowId === 'string' && Array.isArray(funnel.stages)) {
+                    newFunnels.set(funnel.workflowId, funnel.stages);
+                    newFullFunnels.set(funnel.workflowId, funnel);
+                }
+                else {
+                    const msg = 'Skipping invalid funnel entry: missing workflowId or stages.';
+                    console.warn(`[WorkflowFunnelLoader] ${msg}`);
+                    this.warnings.push(msg);
+                }
+            }
+            this.funnels.clear();
+            this.fullFunnels.clear();
+            for (const [k, v] of newFunnels) {
+                this.funnels.set(k, v);
+            }
+            for (const [k, v] of newFullFunnels) {
+                this.fullFunnels.set(k, v);
+            }
+        }
+        catch (err) {
+            const msg = `Failed to parse workflows.yaml: ${String(err)}. Preserving last valid config.`;
+            console.warn(`[WorkflowFunnelLoader] ${msg}`);
+            this.warnings.push(msg);
+        }
+    }
+    /**
+     * Start watching workflows.yaml for changes.
+     */
+    watch() {
+        if (this.watchHandle)
+            return;
+        if (!fs.existsSync(this.configPath))
+            return;
+        let debounceTimer = undefined;
+        this.watchHandle = fs.watch(this.configPath, (eventType) => {
+            if (eventType !== 'change' && eventType !== 'rename')
+                return;
+            if (debounceTimer)
+                clearTimeout(debounceTimer);
+            debounceTimer = setTimeout(() => this.load(), 100);
+        });
+    }
+    /** Stop watching and clean up the FSWatcher. */
+    dispose() {
+        if (this.watchHandle) {
+            this.watchHandle.close();
+            this.watchHandle = undefined;
+        }
+    }
+    /** Get all stages for a workflow. */
+    getStages(workflowId) {
+        return this.funnels.get(workflowId) ?? [];
+    }
+    /**
+     * Get the full funnel definition (including policy) for a workflow.
+     * Returns undefined if the funnel is not found.
+     * Returns a deep clone — consumer mutations do not affect internal state.
+     */
+    getFunnel(workflowId) {
+        const funnel = this.fullFunnels.get(workflowId);
+        if (!funnel)
+            return undefined;
+        return WorkflowFunnelLoader.cloneFunnel(funnel);
+    }
+    /**
+     * Get the full WORKFLOW_FUNNELS table.
+     * Returns a deep clone — consumer mutations do not affect internal state.
+     */
+    getAllFunnels() {
+        const result = new Map();
+        for (const [k, v] of this.funnels) {
+            result.set(k, v.map(stage => ({ ...stage })));
+        }
+        return result;
+    }
+    /**
+     * Get the full WORKFLOW_FUNNELS table including policy.
+     * Returns a Map of workflowId -> WorkflowFunnel (stages and policy cloned).
+     */
+    getAllFunnelsWithPolicy() {
+        const result = new Map();
+        for (const [k, v] of this.fullFunnels) {
+            result.set(k, WorkflowFunnelLoader.cloneFunnel(v));
+        }
+        return result;
+    }
+    /** Returns warnings from the last load() call. */
+    getWarnings() {
+        return [...this.warnings];
+    }
+    /** Get the config file path. */
+    getConfigPath() {
+        return this.configPath;
+    }
+    /** Deep clone a funnel to prevent consumer mutations. */
+    static cloneFunnel(funnel) {
+        return {
+            ...funnel,
+            stages: funnel.stages.map(stage => ({ ...stage })),
+            policy: funnel.policy ? {
+                ...funnel.policy,
+                observability: funnel.policy.observability ? {
+                    ...funnel.policy.observability,
+                    emitEvents: funnel.policy.observability.emitEvents
+                        ? [...funnel.policy.observability.emitEvents]
+                        : undefined,
+                } : undefined,
+            } : undefined,
+        };
+    }
+}
+//# sourceMappingURL=workflow-funnel-loader.js.map

package/dist/workflow-funnel-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-funnel-loader.js","sourceRoot":"","sources":["../src/workflow-funnel-loader.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,100 @@
+{
+  "name": "@principles/core",
+  "version": "1.73.0",
+  "description": "Universal Evolution SDK - framework-agnostic pain signal capture and principle injection",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./pain-signal": {
+      "types": "./dist/pain-signal.d.ts",
+      "default": "./dist/pain-signal.js"
+    },
+    "./pain-signal-adapter": {
+      "types": "./dist/pain-signal-adapter.d.ts",
+      "default": "./dist/pain-signal-adapter.js"
+    },
+    "./storage-adapter": {
+      "types": "./dist/storage-adapter.d.ts",
+      "default": "./dist/storage-adapter.js"
+    },
+    "./evolution-hook": {
+      "types": "./dist/evolution-hook.d.ts",
+      "default": "./dist/evolution-hook.js"
+    },
+    "./principle-injector": {
+      "types": "./dist/principle-injector.d.ts",
+      "default": "./dist/principle-injector.js"
+    },
+    "./telemetry-event": {
+      "types": "./dist/telemetry-event.d.ts",
+      "default": "./dist/telemetry-event.js"
+    },
+    "./pain-recorder": {
+      "types": "./dist/pain-recorder.d.ts",
+      "default": "./dist/pain-recorder.js"
+    },
+    "./pain-flag-resolver": {
+      "types": "./dist/pain-flag-resolver.d.ts",
+      "default": "./dist/pain-flag-resolver.js"
+    },
+    "./io": {
+      "types": "./dist/io.d.ts",
+      "default": "./dist/io.js"
+    },
+    "./workspace-resolver": {
+      "types": "./dist/types/workspace-resolver.d.ts",
+      "default": "./dist/types/workspace-resolver.js"
+    },
+    "./trajectory-store": {
+      "types": "./dist/trajectory-store.d.ts",
+      "default": "./dist/trajectory-store.js"
+    },
+    "./prompt-builder": {
+      "types": "./dist/prompt-builder/index.d.ts",
+      "default": "./dist/prompt-builder/index.js"
+    },
+    "./evolution-store": {
+      "types": "./dist/evolution-store.d.ts",
+      "default": "./dist/evolution-store.js"
+    },
+    "./runtime-v2": {
+      "types": "./dist/runtime-v2/index.d.ts",
+      "default": "./dist/runtime-v2/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:bench": "vitest bench",
+    "lint": "eslint src/"
+  },
+  "dependencies": {
+    "@mariozechner/pi-ai": "^0.73.1",
+    "@sinclair/typebox": "^0.34.48",
+    "better-sqlite3": "^12.9.0",
+    "js-yaml": "^4.1.1"
+  },
+  "devDependencies": {
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^25.6.2",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.5"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/csuzngjh/principles.git",
+    "directory": "packages/principles-core"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}