patchwork-os 0.2.0-alpha.9 → 0.2.0-beta.1

package/dist/automationSuggestions.js

@@ -0,0 +1,150 @@
+/**
+ * automationSuggestions — pattern-mine the activity log + run history to
+ * surface "you've been doing X by hand; want to make a recipe?" hints.
+ *
+ * From docs/strategic/2026-05-02/memory-ecosystem-report.md §6. Three of
+ * the four query-catalog patterns ship here; the fourth ("repeated
+ * manual workflow" via PrefixSpan-lite sequence mining) is deferred to
+ * a follow-up — the agent flagged it as the only entry in the catalog
+ * that requires a new ~50-line primitive (`mineSequences`), and shipping
+ * it without dashboard rendering would be premature.
+ *
+ *   1. **Co-occurring pairs** — tools that often run within W minutes of
+ *      each other but don't already appear together in any successful
+ *      recipe → "create a recipe?" suggestion.
+ *   2. **Installed but unused** — tools registered with the bridge but
+ *      never called → "review your installed tool list" suggestion.
+ *   3. **Recipe trust graduation** — recipes with ≥ 10 runs all status
+ *      "done" → "consider auto-approving" suggestion (does NOT auto-
+ *      change policy; this is purely a hint).
+ *
+ * Pure function over (ActivityLog, RecipeRunLog, ToolRegistry). No I/O
+ * of its own; tested in isolation by feeding mock instances. The CLI
+ * `patchwork suggest` is a thin printer over this output.
+ */
+import { computeCoOccurrence } from "./fp/activityAnalytics.js";
+import { listTools } from "./recipes/toolRegistry.js";
+const DEFAULT_CO_OCCURRENCE_WINDOW_MS = 5 * 60 * 1000;
+const DEFAULT_CO_OCCURRENCE_MIN_COUNT = 5;
+const DEFAULT_ACTIVITY_SINCE_MS = 7 * 24 * 60 * 60 * 1000;
+const DEFAULT_TRUST_GRADUATION_MIN_RUNS = 10;
+/**
+ * Compute the full suggestion set. Returns at most 30 suggestions
+ * (10 of each kind) sorted by salience within each bucket.
+ */
+export function computeAutomationSuggestions(deps) {
+    const window = deps.coOccurrenceWindowMs ?? DEFAULT_CO_OCCURRENCE_WINDOW_MS;
+    const minCount = deps.coOccurrenceMinCount ?? DEFAULT_CO_OCCURRENCE_MIN_COUNT;
+    const sinceLookback = deps.activitySinceMs ?? DEFAULT_ACTIVITY_SINCE_MS;
+    const minRuns = deps.trustGraduationMinRuns ?? DEFAULT_TRUST_GRADUATION_MIN_RUNS;
+    const sinceMs = Date.now() - sinceLookback;
+    const recent = deps.activityLog.queryAll({ sinceMs });
+    const suggestions = [];
+    // (1) Co-occurring tool pairs that aren't already in a recipe.
+    // The agent's filter `!pairAlreadyInRecipe(p, runs)` requires us to
+    // know which (tool, tool) pairs ever appeared together inside a single
+    // recipe run. We synthesize that set from RecipeRun.stepResults.
+    const pairsInRecipes = deps.recipeRunLog
+        ? buildRecipePairSet(deps.recipeRunLog)
+        : new Set();
+    const coOccurringPairs = computeCoOccurrence(recent, window, 50)
+        .filter((p) => p.count >= minCount)
+        .filter((p) => !pairsInRecipes.has(p.pair));
+    for (const { pair, count } of coOccurringPairs.slice(0, 10)) {
+        const [a, b] = pair.split("|");
+        suggestions.push({
+            kind: "co_occurring_pair",
+            label: `You called ${a} and ${b} together ${count} times in the last 7 days. Create a recipe?`,
+            details: { pair: [a, b], count },
+        });
+    }
+    // (2) Installed but never used (in the lookback window).
+    const listToolNames = deps.listToolNamesFn ?? defaultListToolNames;
+    const installed = listToolNames();
+    if (installed.length > 0) {
+        const usedSet = new Set();
+        for (const e of recent) {
+            if (e.tool)
+                usedSet.add(e.tool);
+        }
+        const unused = installed.filter((t) => !usedSet.has(t));
+        if (unused.length > 0) {
+            // Single rolled-up suggestion with the count + a few examples;
+            // listing every unused tool would flood the output for fresh
+            // installs where ~150 of 170 tools have never been called.
+            const examples = unused.slice(0, 5);
+            const more = unused.length > 5 ? `, … (+${unused.length - 5} more)` : "";
+            suggestions.push({
+                kind: "installed_but_unused",
+                label: `${unused.length} installed tools haven't been used in the last 7 days. Examples: ${examples.join(", ")}${more}.`,
+                details: { unusedTools: unused.slice(0, 50) },
+            });
+        }
+    }
+    // (3) Recipe trust graduation — recipes with ≥ minRuns successful runs.
+    if (deps.recipeRunLog) {
+        const byRecipe = groupRunsByRecipe(deps.recipeRunLog);
+        const graduates = [...byRecipe.entries()]
+            .filter(([, runs]) => runs.length >= minRuns)
+            .filter(([, runs]) => runs.every((r) => r.status === "done"))
+            .sort((a, b) => b[1].length - a[1].length)
+            .slice(0, 10);
+        for (const [recipeName, runs] of graduates) {
+            suggestions.push({
+                kind: "recipe_trust_graduation",
+                label: `Recipe \`${recipeName}\` has succeeded ${runs.length}/${runs.length} times — consider trust graduation.`,
+                details: { recipeName, runCount: runs.length },
+            });
+        }
+    }
+    return suggestions;
+}
+function defaultListToolNames() {
+    return listTools().map((t) => t.id);
+}
+/**
+ * Build the set of (toolA, toolB) pairs that ever appeared together
+ * inside a single recipe run. Pairs are alphabetized to match
+ * `computeCoOccurrence`'s key shape ("a|b" with a < b).
+ *
+ * We pull from the most recent 500 runs (the default in-memory cap) —
+ * older runs are evicted from RAM and we don't pay for the disk scan
+ * here; if a tool pair only ever appeared in a 6-month-old run, the
+ * suggestion will fire as if the pair is new, which is a fine UX
+ * (the user has time to re-promote it).
+ */
+function buildRecipePairSet(runLog) {
+    const pairs = new Set();
+    const runs = runLog.query({ limit: 500 });
+    for (const run of runs) {
+        if (!run.stepResults || run.stepResults.length < 2)
+            continue;
+        const tools = run.stepResults
+            .map((s) => s.tool)
+            .filter((t) => typeof t === "string" && t.length > 0);
+        for (let i = 0; i < tools.length; i++) {
+            for (let j = i + 1; j < tools.length; j++) {
+                const a = tools[i];
+                const b = tools[j];
+                if (!a || !b || a === b)
+                    continue;
+                const key = a < b ? `${a}|${b}` : `${b}|${a}`;
+                pairs.add(key);
+            }
+        }
+    }
+    return pairs;
+}
+function groupRunsByRecipe(runLog) {
+    const grouped = new Map();
+    // We pull more than the default 100 since we're computing aggregate
+    // stats — 500 is the in-memory cap and matches the typical buffer.
+    const runs = runLog.query({ limit: 500 });
+    for (const run of runs) {
+        const list = grouped.get(run.recipeName) ?? [];
+        list.push(run);
+        grouped.set(run.recipeName, list);
+    }
+    return grouped;
+}
+//# sourceMappingURL=automationSuggestions.js.map

package/dist/automationSuggestions.js.map

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

package/dist/bridge.d.ts

@@ -39,8 +39,10 @@ export declare class Bridge {
     private pluginTools;
     private pluginWatcher;
     private automationHooks;
+    private recipeOrchestration;
     private recipeScheduler;
     private recipeRunLog;
+    private recipeOrchestrator;
     private commitIssueLinkLog;
     private decisionTraceLog;
     /** Pre-computed digest of recent decisions, refreshed on each session connect. */
@@ -56,6 +58,7 @@ export declare class Bridge {
     /** ISO timestamp of last getProjectContext cache write — drives status-bar "context X min ago". */
     private _lastContextCachedAt;
     private wsHeartbeatInterval;
+    private tokenUsageTracker;
     constructor(config: Config);
     /** Push live bridge state to the extension for status-bar display. */
     private _emitLiveState;