@iflow-mcp/jkheadley-instar 0.26.2

package/dist/core/PatternAnalyzer.js

@@ -0,0 +1,388 @@
+/**
+ * PatternAnalyzer — Cross-execution pattern detection for Living Skills (PROP-229).
+ *
+ * Reads execution journals across runs and detects:
+ * - Consistent additions: steps appearing in ≥60% of runs but not in definition
+ * - Consistent omissions: defined steps skipped in ≥50% of runs
+ * - Novel additions: steps appearing for the first time
+ * - Duration drift: execution time trending significantly up/down
+ * - Gate effectiveness: whether gate commands consistently pass or fail
+ *
+ * Outputs a PatternReport with scored findings and optional EvolutionManager proposals.
+ */
+// ─── Defaults ────────────────────────────────────────────────────────────────
+const DEFAULT_MIN_RUNS = 3;
+const DEFAULT_ADDITION_THRESHOLD = 0.6;
+const DEFAULT_OMISSION_THRESHOLD = 0.5;
+const DEFAULT_DRIFT_MULTIPLIER = 2.0;
+const DEFAULT_DAYS = 30;
+const DEFAULT_AGENT_ID = 'default';
+// ─── Analyzer ────────────────────────────────────────────────────────────────
+export class PatternAnalyzer {
+    journal;
+    constructor(journal) {
+        this.journal = journal;
+    }
+    /**
+     * Analyze execution records for a job and detect patterns.
+     */
+    analyze(jobSlug, opts) {
+        const minRuns = opts?.minRuns ?? DEFAULT_MIN_RUNS;
+        const additionThreshold = opts?.additionThreshold ?? DEFAULT_ADDITION_THRESHOLD;
+        const omissionThreshold = opts?.omissionThreshold ?? DEFAULT_OMISSION_THRESHOLD;
+        const driftMultiplier = opts?.durationDriftMultiplier ?? DEFAULT_DRIFT_MULTIPLIER;
+        const days = opts?.days ?? DEFAULT_DAYS;
+        const agentId = opts?.agentId ?? DEFAULT_AGENT_ID;
+        const records = this.journal.read(jobSlug, { agentId, days });
+        const patterns = [];
+        // Collect all unique step names and defined steps across runs
+        const stepOccurrences = new Map();
+        const definedStepSet = new Set();
+        const allUniqueSteps = new Set();
+        for (const record of records) {
+            // Track defined steps (union across all runs — definitions may evolve)
+            for (const ds of record.definedSteps) {
+                definedStepSet.add(ds);
+            }
+            // Track actual step occurrences
+            for (const step of record.actualSteps) {
+                allUniqueSteps.add(step.step);
+                stepOccurrences.set(step.step, (stepOccurrences.get(step.step) || 0) + 1);
+            }
+        }
+        const totalRuns = records.length;
+        if (totalRuns >= minRuns) {
+            // Detect consistent additions
+            patterns.push(...this.detectConsistentAdditions(stepOccurrences, definedStepSet, totalRuns, additionThreshold));
+            // Detect consistent omissions
+            patterns.push(...this.detectConsistentOmissions(records, definedStepSet, totalRuns, omissionThreshold));
+            // Detect duration drift
+            const durationPattern = this.detectDurationDrift(records, driftMultiplier);
+            if (durationPattern)
+                patterns.push(durationPattern);
+            // Detect gate ineffectiveness
+            const gatePattern = this.detectGateIneffective(records);
+            if (gatePattern)
+                patterns.push(gatePattern);
+        }
+        // Always detect novel additions (even with fewer runs)
+        if (totalRuns >= 1) {
+            patterns.push(...this.detectNovelAdditions(records, definedStepSet));
+        }
+        // Sort: high confidence first, then by rate descending
+        const confidenceOrder = { high: 0, medium: 1, low: 2 };
+        patterns.sort((a, b) => {
+            const cDiff = confidenceOrder[a.confidence] - confidenceOrder[b.confidence];
+            if (cDiff !== 0)
+                return cDiff;
+            return b.rate - a.rate;
+        });
+        // Compute summary
+        const durations = records
+            .map(r => r.durationMinutes)
+            .filter((d) => d != null);
+        const avgDuration = durations.length > 0
+            ? Math.round((durations.reduce((a, b) => a + b, 0) / durations.length) * 10) / 10
+            : null;
+        return {
+            jobSlug,
+            agentId,
+            runsAnalyzed: totalRuns,
+            days,
+            patterns,
+            summary: {
+                uniqueSteps: allUniqueSteps.size,
+                definedSteps: definedStepSet.size,
+                avgDurationMinutes: avgDuration,
+                durationTrend: this.computeDurationTrend(records),
+                successRate: totalRuns > 0
+                    ? Math.round((records.filter(r => r.outcome === 'success').length / totalRuns) * 100) / 100
+                    : 0,
+            },
+            analyzedAt: new Date().toISOString(),
+        };
+    }
+    /**
+     * Analyze all jobs and return reports.
+     */
+    analyzeAll(opts) {
+        const agentId = opts?.agentId ?? DEFAULT_AGENT_ID;
+        const jobs = this.journal.listJobs(agentId);
+        return jobs.map(slug => this.analyze(slug, opts));
+    }
+    /**
+     * Generate evolution proposals from a pattern report.
+     * Returns proposal-ready objects (caller is responsible for submitting to EvolutionManager).
+     */
+    toProposals(report) {
+        const proposals = [];
+        for (const pattern of report.patterns) {
+            // Only generate proposals for high/medium confidence patterns
+            if (pattern.confidence === 'low')
+                continue;
+            const proposal = this.patternToProposal(report.jobSlug, pattern);
+            if (proposal)
+                proposals.push(proposal);
+        }
+        return proposals;
+    }
+    // ─── Private: Pattern Detection ──────────────────────────────────────────
+    /**
+     * Steps appearing in ≥threshold of runs but not in the job definition.
+     */
+    detectConsistentAdditions(stepOccurrences, definedSteps, totalRuns, threshold) {
+        const patterns = [];
+        for (const [step, count] of stepOccurrences) {
+            if (definedSteps.has(step))
+                continue;
+            const rate = count / totalRuns;
+            if (rate >= threshold) {
+                patterns.push({
+                    type: 'consistent-addition',
+                    description: `Step "${step}" appears in ${count}/${totalRuns} runs (${Math.round(rate * 100)}%) but is not in the job definition`,
+                    confidence: rate >= 0.8 ? 'high' : 'medium',
+                    step,
+                    occurrences: count,
+                    totalRuns,
+                    rate,
+                    suggestion: `Consider adding "${step}" to the job's definedSteps`,
+                });
+            }
+        }
+        return patterns;
+    }
+    /**
+     * Defined steps that are skipped in ≥threshold of runs.
+     */
+    detectConsistentOmissions(records, definedSteps, totalRuns, threshold) {
+        const patterns = [];
+        // Count how many times each defined step is actually executed
+        const executedCounts = new Map();
+        for (const ds of definedSteps) {
+            executedCounts.set(ds, 0);
+        }
+        for (const record of records) {
+            const actualStepNames = new Set(record.actualSteps.map(s => s.step));
+            for (const ds of definedSteps) {
+                if (actualStepNames.has(ds)) {
+                    executedCounts.set(ds, (executedCounts.get(ds) || 0) + 1);
+                }
+            }
+        }
+        for (const [step, executedCount] of executedCounts) {
+            const omittedCount = totalRuns - executedCount;
+            const omissionRate = omittedCount / totalRuns;
+            if (omissionRate >= threshold) {
+                patterns.push({
+                    type: 'consistent-omission',
+                    description: `Defined step "${step}" was skipped in ${omittedCount}/${totalRuns} runs (${Math.round(omissionRate * 100)}%)`,
+                    confidence: omissionRate >= 0.8 ? 'high' : 'medium',
+                    step,
+                    occurrences: omittedCount,
+                    totalRuns,
+                    rate: omissionRate,
+                    suggestion: `Consider removing "${step}" from the job's definedSteps — it may no longer be relevant`,
+                });
+            }
+        }
+        return patterns;
+    }
+    /**
+     * Steps appearing for the first time (only in the most recent run).
+     */
+    detectNovelAdditions(records, definedSteps) {
+        if (records.length === 0)
+            return [];
+        const patterns = [];
+        // records are newest-first from journal.read()
+        const latestRun = records[0];
+        const olderRuns = records.slice(1);
+        // Collect all steps from older runs
+        const previousSteps = new Set();
+        for (const record of olderRuns) {
+            for (const step of record.actualSteps) {
+                previousSteps.add(step.step);
+            }
+        }
+        // Check latest run for novel steps
+        for (const step of latestRun.actualSteps) {
+            if (!previousSteps.has(step.step) && !definedSteps.has(step.step)) {
+                // First time seeing this step AND it's not in definition
+                patterns.push({
+                    type: 'novel-addition',
+                    description: `New step "${step.step}" appeared for the first time in the latest run`,
+                    confidence: 'low',
+                    step: step.step,
+                    occurrences: 1,
+                    totalRuns: records.length,
+                    rate: 1 / records.length,
+                    suggestion: `Monitor "${step.step}" — if it recurs, it may become a consistent addition`,
+                });
+            }
+        }
+        return patterns;
+    }
+    /**
+     * Duration trending significantly above historical average.
+     * Uses linear regression on the last N runs to detect trend direction.
+     */
+    detectDurationDrift(records, driftMultiplier) {
+        const durations = records
+            .filter(r => r.durationMinutes != null)
+            .map(r => ({ timestamp: r.timestamp, duration: r.durationMinutes }));
+        if (durations.length < 3)
+            return null;
+        // Sort oldest to newest for trend analysis
+        durations.sort((a, b) => a.timestamp.localeCompare(b.timestamp));
+        const avg = durations.reduce((s, d) => s + d.duration, 0) / durations.length;
+        // Compare first half average to second half average
+        const mid = Math.floor(durations.length / 2);
+        const firstHalf = durations.slice(0, mid);
+        const secondHalf = durations.slice(mid);
+        const firstAvg = firstHalf.reduce((s, d) => s + d.duration, 0) / firstHalf.length;
+        const secondAvg = secondHalf.reduce((s, d) => s + d.duration, 0) / secondHalf.length;
+        // Check if the second half is significantly different from first half
+        if (firstAvg === 0)
+            return null;
+        const ratio = secondAvg / firstAvg;
+        if (ratio >= driftMultiplier) {
+            return {
+                type: 'duration-drift',
+                description: `Duration trending up: recent average ${Math.round(secondAvg * 10) / 10}min vs earlier ${Math.round(firstAvg * 10) / 10}min (${Math.round(ratio * 10) / 10}x increase)`,
+                confidence: ratio >= 3 ? 'high' : 'medium',
+                step: null,
+                occurrences: secondHalf.length,
+                totalRuns: durations.length,
+                rate: ratio,
+                suggestion: 'Investigate why execution time is increasing — may indicate scope creep or environmental issues',
+                evidence: {
+                    firstHalfAvg: Math.round(firstAvg * 10) / 10,
+                    secondHalfAvg: Math.round(secondAvg * 10) / 10,
+                    ratio: Math.round(ratio * 10) / 10,
+                    overallAvg: Math.round(avg * 10) / 10,
+                },
+            };
+        }
+        if (ratio <= 1 / driftMultiplier) {
+            return {
+                type: 'duration-drift',
+                description: `Duration trending down: recent average ${Math.round(secondAvg * 10) / 10}min vs earlier ${Math.round(firstAvg * 10) / 10}min (${Math.round((1 / ratio) * 10) / 10}x decrease)`,
+                confidence: 'medium',
+                step: null,
+                occurrences: secondHalf.length,
+                totalRuns: durations.length,
+                rate: ratio,
+                suggestion: 'Duration has decreased significantly — the job may have become more efficient or may be skipping steps',
+                evidence: {
+                    firstHalfAvg: Math.round(firstAvg * 10) / 10,
+                    secondHalfAvg: Math.round(secondAvg * 10) / 10,
+                    ratio: Math.round(ratio * 10) / 10,
+                    overallAvg: Math.round(avg * 10) / 10,
+                },
+            };
+        }
+        return null;
+    }
+    /**
+     * Detect if gate commands are consistently finding nothing to do.
+     * If a job consistently runs but has 0 actual steps, the gate may be ineffective.
+     */
+    detectGateIneffective(records) {
+        const emptyRuns = records.filter(r => r.actualSteps.length === 0);
+        if (emptyRuns.length === 0)
+            return null;
+        const rate = emptyRuns.length / records.length;
+        if (rate >= 0.5) {
+            return {
+                type: 'gate-ineffective',
+                description: `${emptyRuns.length}/${records.length} runs (${Math.round(rate * 100)}%) completed with zero steps — the gate may not be filtering effectively`,
+                confidence: rate >= 0.8 ? 'high' : 'medium',
+                step: null,
+                occurrences: emptyRuns.length,
+                totalRuns: records.length,
+                rate,
+                suggestion: 'Review the job\'s gate command — it may be passing too easily, causing unnecessary executions',
+            };
+        }
+        return null;
+    }
+    // ─── Private: Duration Trend ─────────────────────────────────────────────
+    computeDurationTrend(records) {
+        const durations = records
+            .filter(r => r.durationMinutes != null)
+            .map(r => ({ timestamp: r.timestamp, duration: r.durationMinutes }));
+        if (durations.length < 3)
+            return 'insufficient-data';
+        // Sort oldest to newest
+        durations.sort((a, b) => a.timestamp.localeCompare(b.timestamp));
+        const mid = Math.floor(durations.length / 2);
+        const firstAvg = durations.slice(0, mid).reduce((s, d) => s + d.duration, 0) / mid;
+        const secondAvg = durations.slice(mid).reduce((s, d) => s + d.duration, 0) / (durations.length - mid);
+        if (firstAvg === 0)
+            return 'stable';
+        const ratio = secondAvg / firstAvg;
+        if (ratio >= 1.5)
+            return 'increasing';
+        if (ratio <= 0.67)
+            return 'decreasing';
+        return 'stable';
+    }
+    // ─── Private: Pattern → Proposal Mapping ─────────────────────────────────
+    patternToProposal(jobSlug, pattern) {
+        const source = `living-skills:${jobSlug}`;
+        const proposedBy = 'living-skills-analyzer';
+        const tags = ['living-skills', jobSlug, pattern.type];
+        switch (pattern.type) {
+            case 'consistent-addition':
+                return {
+                    title: `Add "${pattern.step}" to ${jobSlug} definition`,
+                    source,
+                    description: `${pattern.description}. ${pattern.suggestion}`,
+                    type: 'workflow',
+                    impact: pattern.confidence === 'high' ? 'medium' : 'low',
+                    effort: 'low',
+                    proposedBy,
+                    tags,
+                };
+            case 'consistent-omission':
+                return {
+                    title: `Remove "${pattern.step}" from ${jobSlug} definition`,
+                    source,
+                    description: `${pattern.description}. ${pattern.suggestion}`,
+                    type: 'workflow',
+                    impact: 'low',
+                    effort: 'low',
+                    proposedBy,
+                    tags,
+                };
+            case 'duration-drift':
+                return {
+                    title: `Investigate duration drift in ${jobSlug}`,
+                    source,
+                    description: `${pattern.description}. ${pattern.suggestion}`,
+                    type: 'performance',
+                    impact: 'medium',
+                    effort: 'medium',
+                    proposedBy,
+                    tags,
+                };
+            case 'gate-ineffective':
+                return {
+                    title: `Review gate effectiveness for ${jobSlug}`,
+                    source,
+                    description: `${pattern.description}. ${pattern.suggestion}`,
+                    type: 'infrastructure',
+                    impact: 'medium',
+                    effort: 'medium',
+                    proposedBy,
+                    tags,
+                };
+            case 'novel-addition':
+                // Novel additions are informational — no proposal needed
+                return null;
+            default:
+                return null;
+        }
+    }
+}
+//# sourceMappingURL=PatternAnalyzer.js.map

package/dist/core/PatternAnalyzer.js.map

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

package/dist/core/PlatformActivityRegistry.d.ts

@@ -0,0 +1,163 @@
+/**
+ * PlatformActivityRegistry — Durable, file-based record of external platform actions.
+ *
+ * Born from a blindspot in Dawn's Portal project: activity caches (x-activity.json, etc.)
+ * were incomplete because recording was manual and ephemeral sessions could skip it.
+ * The fix was an append-only JSONL event log that survives session death, with query
+ * methods for duplicate detection and session injection.
+ *
+ * This module gives every Instar agent the same capability:
+ *   1. Append-only JSONL log (`platform-activity.jsonl`) — survives crashes and session death
+ *   2. Query by platform, time window, session, action type
+ *   3. Duplicate detection — "was this already posted?" before publishing
+ *   4. Compact summary generation for session context injection
+ *
+ * File locking: Uses proper-lockfile for concurrent safety when multiple sessions
+ * may record actions simultaneously.
+ *
+ * Integration: Optionally links to CanonicalState to auto-update quick-facts
+ * about recent platform activity.
+ *
+ * Storage: {stateDir}/platform-activity.jsonl
+ */
+import type { CanonicalState } from './CanonicalState.js';
+export type PlatformActionType = 'post' | 'reply' | 'comment' | 'email' | 'dm';
+export type PlatformActionStatus = 'posted' | 'failed' | 'pending';
+export interface PlatformAction {
+    /** ISO timestamp of the action */
+    timestamp: string;
+    /** Platform identifier (e.g., 'x', 'reddit', 'moltbook', 'ghost', 'email') */
+    platform: string;
+    /** What kind of action */
+    type: PlatformActionType;
+    /** Human-readable summary of the content */
+    summary: string;
+    /** Session that performed the action */
+    sessionId: string;
+    /** Platform-specific content ID (tweet ID, post ID, etc.) */
+    contentId?: string;
+    /** URL to the published content */
+    url?: string;
+    /** Action outcome */
+    status: PlatformActionStatus;
+    /** Arbitrary platform-specific metadata */
+    metadata?: Record<string, unknown>;
+}
+export interface PlatformActivityQuery {
+    /** Filter by platform */
+    platform?: string;
+    /** Only actions after this ISO timestamp */
+    since?: string;
+    /** Only actions before this ISO timestamp */
+    before?: string;
+    /** Filter by action type */
+    type?: PlatformActionType;
+    /** Filter by session */
+    sessionId?: string;
+    /** Filter by status */
+    status?: PlatformActionStatus;
+    /** Maximum entries to return (most recent first) */
+    limit?: number;
+}
+export interface PlatformActivitySummary {
+    /** Total actions recorded */
+    totalActions: number;
+    /** Actions in the last 24 hours */
+    last24h: number;
+    /** Breakdown by platform */
+    byPlatform: Record<string, number>;
+    /** Breakdown by type */
+    byType: Record<string, number>;
+    /** Most recent action per platform */
+    latestByPlatform: Record<string, {
+        timestamp: string;
+        summary: string;
+    }>;
+    /** Compact text suitable for session injection */
+    text: string;
+}
+export interface PlatformActivityRegistryConfig {
+    /** Instar state directory (e.g., .instar) */
+    stateDir: string;
+    /** Optional CanonicalState instance for auto-updating quick-facts */
+    canonicalState?: CanonicalState;
+    /** Maximum age (in hours) for log rotation. Default: no rotation. */
+    rotateAfterHours?: number;
+}
+export declare class PlatformActivityRegistry {
+    private stateDir;
+    private activityFile;
+    private canonicalState?;
+    private rotateAfterHours?;
+    constructor(config: PlatformActivityRegistryConfig);
+    /**
+     * Record a platform action to the append-only JSONL log.
+     *
+     * Uses file locking for concurrent safety. If the lock cannot be acquired,
+     * falls back to direct append (append is atomic on most filesystems for
+     * small writes).
+     *
+     * Optionally updates CanonicalState quick-facts with latest activity summary.
+     */
+    record(action: Omit<PlatformAction, 'timestamp'> & {
+        timestamp?: string;
+    }): Promise<PlatformAction>;
+    /**
+     * Record a platform action synchronously.
+     *
+     * For use in sync contexts (hooks, CLI commands). No file locking —
+     * relies on appendFileSync atomicity for small writes.
+     */
+    recordSync(action: Omit<PlatformAction, 'timestamp'> & {
+        timestamp?: string;
+    }): PlatformAction;
+    /**
+     * Query platform actions with filters.
+     *
+     * Returns entries sorted most-recent-first. All filters are AND-combined.
+     */
+    query(opts?: PlatformActivityQuery): PlatformAction[];
+    /**
+     * Check if similar content was already posted to a platform within a time window.
+     *
+     * Uses case-insensitive substring matching on the summary field. This catches
+     * exact duplicates and near-duplicates where the summary is reused.
+     *
+     * @param platform - Platform to check (e.g., 'x', 'reddit')
+     * @param contentSummary - Summary text to check for duplicates
+     * @param windowHours - How far back to look (default: 48 hours)
+     * @returns The matching action if found, or null
+     */
+    wasAlreadyPosted(platform: string, contentSummary: string, windowHours?: number): PlatformAction | null;
+    /**
+     * Generate a compact summary of recent platform activity.
+     *
+     * Designed for session context injection — gives a new session instant
+     * awareness of what has been posted recently without loading the full log.
+     */
+    getRecentSummary(windowHours?: number): PlatformActivitySummary;
+    /**
+     * Get the total count of recorded actions.
+     */
+    count(opts?: {
+        platform?: string;
+        status?: PlatformActionStatus;
+    }): number;
+    /**
+     * Get the path to the activity log file.
+     */
+    get filePath(): string;
+    /**
+     * Read all entries from the JSONL file.
+     * Gracefully handles corrupt lines by skipping them.
+     */
+    private readLines;
+    /**
+     * Update CanonicalState with latest platform activity summary.
+     *
+     * Sets a quick-fact answering "What has been posted recently?" so that
+     * sessions can check canonical state instead of loading the full log.
+     */
+    private updateCanonicalState;
+}
+//# sourceMappingURL=PlatformActivityRegistry.d.ts.map

package/dist/core/PlatformActivityRegistry.d.ts.map

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