@yuaone/core 0.9.8 → 0.9.9

package/dist/trace-pattern-extractor.js

@@ -0,0 +1,321 @@
+/**
+ * @module trace-pattern-extractor
+ * @description Reads TraceRecorder JSONL files from ~/.yuan/traces/, detects repeated
+ * successful tool sequences, and produces Playbook proposals.
+ *
+ * Pattern detection rules:
+ * - A sequence = ordered list of tool names from tool_call events in a session
+ * - A pattern is a contiguous sub-sequence of 3..8 tools
+ * - Significant if: appears in 3+ distinct sessions AND success rate >= 60%
+ *   AND not already proposed (tracked by patternHash)
+ *
+ * Storage: ~/.yuan/proposals/playbook-proposals.json — array of PlaybookProposal, atomic write
+ * Events: emits on single "event" channel like all other modules
+ */
+import { createHash, randomUUID } from "crypto";
+import { EventEmitter } from "events";
+import { existsSync, mkdirSync, readdirSync, readFileSync, renameSync, writeFileSync, } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+// ─── Helpers ───
+/**
+ * Infer task type from goal text using keyword matching.
+ * Mirrors PlaybookLibrary's classifier for consistency.
+ */
+function inferTaskType(goal) {
+    const g = goal.toLowerCase();
+    if (/fix|bug|error|crash|fail/.test(g))
+        return "ts-bugfix";
+    if (/refactor|rename|reorganize|restructure|clean/.test(g))
+        return "refactor";
+    if (/add|implement|create|build|feature|new/.test(g))
+        return "feature-add";
+    if (/test|spec|coverage|jest|vitest/.test(g))
+        return "test-gen";
+    if (/security|vuln|cve|inject|xss|csrf/.test(g))
+        return "security-fix";
+    if (/doc|readme|comment|jsdoc/.test(g))
+        return "docs";
+    if (/migrat|upgrade|version|convert/.test(g))
+        return "migration";
+    if (/perf|optim|speed|slow|latency/.test(g))
+        return "performance";
+    return "general";
+}
+/**
+ * Compute a short SHA-256 hash of the tool sequence for deduplication.
+ */
+function hashSequence(seq) {
+    return createHash("sha256")
+        .update(seq.join(","))
+        .digest("hex")
+        .slice(0, 16);
+}
+/**
+ * Extract all contiguous sub-sequences of length minLen..maxLen from an array.
+ */
+function subSequences(arr, minLen, maxLen) {
+    const results = [];
+    for (let start = 0; start < arr.length; start++) {
+        for (let len = minLen; len <= maxLen && start + len <= arr.length; len++) {
+            results.push(arr.slice(start, start + len));
+        }
+    }
+    return results;
+}
+// ─── TracePatternExtractor ───
+export class TracePatternExtractor extends EventEmitter {
+    tracesDir;
+    storageDir;
+    storageFile;
+    minSessions;
+    minSuccessRate;
+    /** patternHashes of proposals already produced — prevents re-proposing */
+    proposedPatterns;
+    /** proposalIds marked as applied — excluded from getProposals() */
+    appliedProposals;
+    proposals;
+    constructor(config) {
+        super();
+        this.tracesDir =
+            config?.tracesDir ?? join(homedir(), ".yuan", "traces");
+        this.storageDir =
+            config?.storageDir ?? join(homedir(), ".yuan", "proposals");
+        this.storageFile = join(this.storageDir, "playbook-proposals.json");
+        this.minSessions = config?.minSessions ?? 3;
+        this.minSuccessRate = config?.minSuccessRate ?? 0.6;
+        this.proposedPatterns = new Set();
+        this.appliedProposals = new Set();
+        this.proposals = this._loadProposals();
+        // Seed proposedPatterns from already-stored proposals
+        for (const p of this.proposals) {
+            this.proposedPatterns.add(p.patternHash);
+        }
+        mkdirSync(this.storageDir, { recursive: true });
+    }
+    // ─── Public API ───
+    /**
+     * Main: scan all JSONL files in tracesDir, extract significant patterns,
+     * persist and return newly discovered proposals.
+     */
+    async extract() {
+        const sessions = this._parseSessions();
+        if (sessions.size === 0)
+            return [];
+        // Build sub-sequence frequency maps
+        // Map<patternHash, { seq, sessions: Set<sessionId>, successCount }>
+        const patternMap = new Map();
+        for (const [sessionId, data] of sessions.entries()) {
+            if (!data.ended)
+                continue; // skip incomplete sessions
+            const subSeqs = subSequences(data.toolCalls, 3, 8);
+            const seenInSession = new Set();
+            for (const seq of subSeqs) {
+                const hash = hashSequence(seq);
+                // Count each pattern at most once per session
+                if (seenInSession.has(hash))
+                    continue;
+                seenInSession.add(hash);
+                if (!patternMap.has(hash)) {
+                    patternMap.set(hash, { seq, sessions: new Set(), successCount: 0 });
+                }
+                const entry = patternMap.get(hash);
+                entry.sessions.add(sessionId);
+                if (data.success)
+                    entry.successCount++;
+            }
+        }
+        // Filter for significant patterns not yet proposed
+        const newProposals = [];
+        for (const [hash, entry] of patternMap.entries()) {
+            if (this.proposedPatterns.has(hash))
+                continue;
+            const sessionCount = entry.sessions.size;
+            if (sessionCount < this.minSessions)
+                continue;
+            const successRate = entry.successCount / sessionCount;
+            if (successRate < this.minSuccessRate)
+                continue;
+            // Infer task type from majority goal of source sessions
+            const taskType = this._inferDominantTaskType(entry.sessions, sessions);
+            const proposal = {
+                id: randomUUID(),
+                taskType,
+                toolSequence: entry.seq,
+                patternHash: hash,
+                sessionCount,
+                successRate,
+                sourceSessionIds: [...entry.sessions],
+                proposedAt: new Date().toISOString(),
+            };
+            newProposals.push(proposal);
+            this.proposedPatterns.add(hash);
+            // Emit event for each new proposal
+            this.emit("event", {
+                kind: "agent:playbook_learned",
+                proposalId: proposal.id,
+                taskType: proposal.taskType,
+                toolSequence: proposal.toolSequence,
+                successRate: proposal.successRate,
+                sessionCount: proposal.sessionCount,
+                timestamp: Date.now(),
+            });
+        }
+        if (newProposals.length > 0) {
+            // Merge into stored proposals and persist
+            this.proposals = [...this.proposals, ...newProposals];
+            this._saveProposals();
+        }
+        return newProposals;
+    }
+    /**
+     * Get all stored proposals, excluding applied ones.
+     */
+    getProposals() {
+        return this.proposals.filter((p) => !this.appliedProposals.has(p.id));
+    }
+    /**
+     * Mark a proposal as applied so it won't be returned by getProposals().
+     * Applied state is in-memory only — not persisted.
+     */
+    markApplied(proposalId) {
+        this.appliedProposals.add(proposalId);
+    }
+    // ─── Internal ───
+    /**
+     * Parse all JSONL files in tracesDir into per-session SessionData.
+     */
+    _parseSessions() {
+        const sessions = new Map();
+        if (!existsSync(this.tracesDir))
+            return sessions;
+        let files;
+        try {
+            files = readdirSync(this.tracesDir).filter((f) => f.endsWith(".jsonl"));
+        }
+        catch {
+            return sessions;
+        }
+        for (const file of files) {
+            const filePath = join(this.tracesDir, file);
+            let content;
+            try {
+                content = readFileSync(filePath, "utf-8");
+            }
+            catch {
+                continue;
+            }
+            const lines = content.split("\n");
+            for (const line of lines) {
+                const trimmed = line.trim();
+                if (!trimmed)
+                    continue;
+                let event;
+                try {
+                    event = JSON.parse(trimmed);
+                }
+                catch {
+                    continue; // skip malformed lines
+                }
+                if (!event.kind || !event.sessionId)
+                    continue;
+                switch (event.kind) {
+                    case "session_start": {
+                        sessions.set(event.sessionId, {
+                            sessionId: event.sessionId,
+                            goal: event.goal ?? "",
+                            toolCalls: [],
+                            success: false,
+                            ended: false,
+                        });
+                        break;
+                    }
+                    case "tool_call": {
+                        if (!event.tool)
+                            break;
+                        let session = sessions.get(event.sessionId);
+                        if (!session) {
+                            // Handle orphaned tool_call (session_start missed)
+                            session = {
+                                sessionId: event.sessionId,
+                                goal: "",
+                                toolCalls: [],
+                                success: false,
+                                ended: false,
+                            };
+                            sessions.set(event.sessionId, session);
+                        }
+                        session.toolCalls.push(event.tool);
+                        break;
+                    }
+                    case "session_end": {
+                        const sess = sessions.get(event.sessionId);
+                        if (sess) {
+                            sess.success = event.success ?? false;
+                            sess.ended = true;
+                        }
+                        break;
+                    }
+                    // tool_result: not needed for sequence extraction
+                    default:
+                        break;
+                }
+            }
+        }
+        return sessions;
+    }
+    /**
+     * Infer the most common task type across a set of session IDs.
+     * Falls back to "general" if no goals found.
+     */
+    _inferDominantTaskType(sessionIds, allSessions) {
+        const typeCounts = new Map();
+        for (const sid of sessionIds) {
+            const sess = allSessions.get(sid);
+            if (!sess || !sess.goal)
+                continue;
+            const t = inferTaskType(sess.goal);
+            typeCounts.set(t, (typeCounts.get(t) ?? 0) + 1);
+        }
+        if (typeCounts.size === 0)
+            return "general";
+        let best = "general";
+        let bestCount = 0;
+        for (const [type, count] of typeCounts.entries()) {
+            if (count > bestCount) {
+                bestCount = count;
+                best = type;
+            }
+        }
+        return best;
+    }
+    /**
+     * Load persisted proposals from disk.
+     */
+    _loadProposals() {
+        try {
+            if (!existsSync(this.storageFile))
+                return [];
+            const raw = readFileSync(this.storageFile, "utf-8");
+            return JSON.parse(raw);
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * Atomic write of proposals array to disk.
+     */
+    _saveProposals() {
+        const tmpFile = `${this.storageFile}.tmp`;
+        try {
+            mkdirSync(this.storageDir, { recursive: true });
+            writeFileSync(tmpFile, JSON.stringify(this.proposals, null, 2), "utf-8");
+            renameSync(tmpFile, this.storageFile);
+        }
+        catch {
+            // Non-fatal: storage failures should not crash the agent loop
+        }
+    }
+}
+//# sourceMappingURL=trace-pattern-extractor.js.map

package/dist/trace-pattern-extractor.js.map

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

package/dist/trace-recorder.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @module trace-recorder
+ * @description Lightweight append-only session trace recorder.
+ *
+ * Records every observable agent loop event to `.yuan/traces/<sessionId>.jsonl`.
+ * Format: one JSON object per line (JSONL), allowing step-by-step replay.
+ *
+ * Design constraints:
+ * - Never blocks the main loop (all writes are fire-and-forget)
+ * - Never throws (all errors are swallowed silently)
+ * - File handle stays open during session, closed on stop()
+ */
+import type { AgentEvent } from "./types.js";
+/** One line in a trace file */
+export interface TraceEntry {
+    /** ISO timestamp */
+    ts: string;
+    /** Sequence number within session */
+    seq: number;
+    /** The agent event payload */
+    event: AgentEvent;
+}
+export declare class TraceRecorder {
+    private readonly sessionId;
+    private stream;
+    private seq;
+    private readonly tracePath;
+    private opened;
+    constructor(sessionId: string, traceDir?: string);
+    /** Path to the trace file for this session */
+    get path(): string;
+    /** Record an agent event. Fire-and-forget — never throws. */
+    record(event: AgentEvent): void;
+    /** Close the trace file. Safe to call multiple times. */
+    stop(): void;
+    private open;
+}
+//# sourceMappingURL=trace-recorder.d.ts.map

package/dist/trace-recorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-recorder.d.ts","sourceRoot":"","sources":["../src/trace-recorder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,+BAA+B;AAC/B,MAAM,WAAW,UAAU;IACzB,oBAAoB;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,qCAAqC;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,8BAA8B;IAC9B,KAAK,EAAE,UAAU,CAAC;CACnB;AAiBD,qBAAa,aAAa;IAMZ,OAAO,CAAC,QAAQ,CAAC,SAAS;IALtC,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,GAAG,CAAK;IAChB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,MAAM,CAAS;gBAEM,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM;IAMjE,8CAA8C;IAC9C,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,6DAA6D;IAC7D,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAgB/B,yDAAyD;IACzD,IAAI,IAAI,IAAI;IAaZ,OAAO,CAAC,IAAI;CAYb"}

package/dist/trace-recorder.js

@@ -0,0 +1,94 @@
+/**
+ * @module trace-recorder
+ * @description Lightweight append-only session trace recorder.
+ *
+ * Records every observable agent loop event to `.yuan/traces/<sessionId>.jsonl`.
+ * Format: one JSON object per line (JSONL), allowing step-by-step replay.
+ *
+ * Design constraints:
+ * - Never blocks the main loop (all writes are fire-and-forget)
+ * - Never throws (all errors are swallowed silently)
+ * - File handle stays open during session, closed on stop()
+ */
+import { mkdirSync, createWriteStream } from "node:fs";
+import { join, dirname } from "node:path";
+import { homedir } from "node:os";
+/** Events worth recording — filter out noisy deltas */
+const TRACE_KINDS = new Set([
+    "agent:phase_transition",
+    "agent:tool_start",
+    "agent:tool_result",
+    "agent:file_change",
+    "agent:qa_result",
+    "agent:evidence_report",
+    "agent:iteration",
+    "agent:completed",
+    "agent:error",
+    "agent:approval_needed",
+    "agent:bg_update",
+]);
+export class TraceRecorder {
+    sessionId;
+    stream = null;
+    seq = 0;
+    tracePath;
+    opened = false;
+    constructor(sessionId, traceDir) {
+        this.sessionId = sessionId;
+        const base = traceDir ?? join(homedir(), ".yuan", "traces");
+        const date = new Date().toISOString().slice(0, 10); // YYYY-MM-DD
+        this.tracePath = join(base, `${date}-${sessionId}.jsonl`);
+    }
+    /** Path to the trace file for this session */
+    get path() {
+        return this.tracePath;
+    }
+    /** Record an agent event. Fire-and-forget — never throws. */
+    record(event) {
+        if (!TRACE_KINDS.has(event.kind))
+            return;
+        try {
+            if (!this.opened)
+                this.open();
+            if (!this.stream)
+                return;
+            const entry = {
+                ts: new Date().toISOString(),
+                seq: this.seq++,
+                event,
+            };
+            this.stream.write(JSON.stringify(entry) + "\n");
+        }
+        catch {
+            // never block the main loop
+        }
+    }
+    /** Close the trace file. Safe to call multiple times. */
+    stop() {
+        try {
+            if (this.stream) {
+                this.stream.end();
+                this.stream = null;
+                // Reset so record() can reopen if needed after dispose/restart
+                this.opened = false;
+            }
+        }
+        catch {
+            // swallow
+        }
+    }
+    open() {
+        try {
+            mkdirSync(dirname(this.tracePath), { recursive: true });
+            this.stream = createWriteStream(this.tracePath, { flags: "a", encoding: "utf8" });
+            this.stream.on("error", () => {
+                this.stream = null;
+            });
+            this.opened = true;
+        }
+        catch {
+            this.opened = true; // prevent retry storms
+        }
+    }
+}
+//# sourceMappingURL=trace-recorder.js.map

package/dist/trace-recorder.js.map

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

package/dist/trust-economics.d.ts

@@ -0,0 +1,50 @@
+/**
+ * @module trust-economics
+ * @description Trust/Approval Economics — tracks trust scores per action class.
+ * Produces trust RECOMMENDATIONS but never auto-relaxes approval thresholds.
+ *
+ * Storage: ~/.yuan/trust-scores/{projectHash}.json
+ *
+ * Safety: Trust scores are informational only. ApprovalManager thresholds
+ * are NOT modified automatically. No action class is ever auto-approved.
+ */
+import { EventEmitter } from "events";
+export type ActionClass = "file_read" | "file_write" | "file_edit" | "file_delete" | "shell_exec_safe" | "shell_exec_risky" | "git_read" | "git_write" | "network_fetch" | "mcp_call";
+export interface TrustRecord {
+    actionClass: ActionClass;
+    successCount: number;
+    failCount: number;
+    lastSuccess: string | null;
+    lastFail: string | null;
+    /** Never decremented below 0. A single high-risk failure resets to 0. */
+    trustScore: number;
+}
+export interface TrustRecommendation {
+    actionClass: ActionClass;
+    currentTrustScore: number;
+    recommendation: "auto_approve_candidate" | "require_review" | "require_explicit_approval";
+    reasoning: string;
+}
+export interface TrustEconomicsConfig {
+    projectPath?: string;
+    storageDir?: string;
+}
+export declare class TrustEconomics extends EventEmitter {
+    private readonly storageFile;
+    private records;
+    constructor(config?: TrustEconomicsConfig);
+    /** Record an action outcome. High-risk failure resets trust to 0. */
+    record(actionClass: ActionClass, success: boolean, isHighRisk?: boolean): void;
+    /**
+     * Get trust recommendations (read-only, never modifies approval thresholds).
+     * Emits agent:trust_update.
+     */
+    getRecommendations(): TrustRecommendation[];
+    /** Get trust record for a specific action class. */
+    getTrust(actionClass: ActionClass): TrustRecord | null;
+    /** Get all trust records. */
+    getAll(): TrustRecord[];
+    private _load;
+    private _save;
+}
+//# sourceMappingURL=trust-economics.d.ts.map

package/dist/trust-economics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trust-economics.d.ts","sourceRoot":"","sources":["../src/trust-economics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAKtC,MAAM,MAAM,WAAW,GACnB,WAAW,GACX,YAAY,GACZ,WAAW,GACX,aAAa,GACb,iBAAiB,GACjB,kBAAkB,GAClB,UAAU,GACV,WAAW,GACX,eAAe,GACf,UAAU,CAAC;AAEf,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,WAAW,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,yEAAyE;IACzE,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,WAAW,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,wBAAwB,GAAG,gBAAgB,GAAG,2BAA2B,CAAC;IAC1F,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAkCD,qBAAa,cAAe,SAAQ,YAAY;IAC9C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,OAAO,CAAgC;gBAEnC,MAAM,GAAE,oBAAyB;IAY7C,qEAAqE;IACrE,MAAM,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,UAAQ,GAAG,IAAI;IAsC5E;;;OAGG;IACH,kBAAkB,IAAI,mBAAmB,EAAE;IAc3C,oDAAoD;IACpD,QAAQ,CAAC,WAAW,EAAE,WAAW,GAAG,WAAW,GAAG,IAAI;IAItD,6BAA6B;IAC7B,MAAM,IAAI,WAAW,EAAE;IAMvB,OAAO,CAAC,KAAK;IAkBb,OAAO,CAAC,KAAK;CAUd"}