@roarpeng/graphflow 1.9.4 → 1.9.12

package/dist/learning/skill-consolidate.js

@@ -0,0 +1,353 @@
+"use strict";
+/**
+ * QM-inspired skill consolidation: explicit, auditable actions only.
+ * Heuristic planner — no LLM required. Apply is opt-in and safe (skips unknown ids).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeSkillNameKey = normalizeSkillNameKey;
+exports.toConsolidateResult = toConsolidateResult;
+exports.planSkillConsolidation = planSkillConsolidation;
+exports.applySkillConsolidation = applySkillConsolidation;
+exports.planFromRequest = planFromRequest;
+const canary_gate_1 = require("./canary-gate");
+const skill_store_1 = require("./skill-store");
+const DEFAULT_VERY_LOW_SCORE = -10;
+/** Normalize skill names for near-duplicate detection (lowercase + hyphen). */
+function normalizeSkillNameKey(name) {
+    return (0, skill_store_1.sanitizeAtom)(name.trim().toLowerCase()).replace(/^-+|-+$/g, "");
+}
+function summarizeActions(actions) {
+    const summary = { updates: 0, deletes: 0, adds: 0, none: 0 };
+    for (const action of actions) {
+        if (action.action === "UPDATE")
+            summary.updates += 1;
+        else if (action.action === "DELETE")
+            summary.deletes += 1;
+        else if (action.action === "ADD")
+            summary.adds += 1;
+        else
+            summary.none += 1;
+    }
+    return summary;
+}
+function toConsolidateResult(actions) {
+    return { actions, summary: summarizeActions(actions) };
+}
+function pickSurvivor(group) {
+    return [...group].sort((a, b) => {
+        const provenBias = (s) => (s.outcomeKind === "proven" ? 1 : 0);
+        return (b.uses - a.uses ||
+            b.score - a.score ||
+            provenBias(b) - provenBias(a) ||
+            a.id.localeCompare(b.id));
+    })[0];
+}
+function mergeGuidance(...parts) {
+    const seen = new Set();
+    const lines = [];
+    for (const part of parts) {
+        const trimmed = part?.trim();
+        if (!trimmed)
+            continue;
+        const key = trimmed.toLowerCase();
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        lines.push(trimmed);
+    }
+    return lines.length > 0 ? lines.join("\n") : undefined;
+}
+/**
+ * Plan consolidation actions for a skill inventory.
+ * Prefer UPDATE (merge / refresh) over DELETE+ADD. Anti-pattern hard-delete
+ * follows {@link shouldHardDeleteAntiPattern} (currently always false — soft isolation).
+ */
+function planSkillConsolidation(skills, options) {
+    const veryLowScore = options?.veryLowScore ?? DEFAULT_VERY_LOW_SCORE;
+    const actions = [];
+    const consumed = new Set();
+    // 1) MERGE near-duplicate names → UPDATE survivor + DELETE duplicates
+    const byKey = new Map();
+    for (const skill of skills) {
+        const key = normalizeSkillNameKey(skill.name);
+        if (!key)
+            continue;
+        const group = byKey.get(key) ?? [];
+        group.push(skill);
+        byKey.set(key, group);
+    }
+    for (const [, group] of byKey) {
+        if (group.length < 2)
+            continue;
+        const survivor = pickSurvivor(group);
+        const duplicates = group.filter((s) => s.id !== survivor.id);
+        const mergedUses = group.reduce((sum, s) => sum + s.uses, 0);
+        const mergedScore = Math.max(...group.map((s) => s.score));
+        const mergedGuidance = mergeGuidance(survivor.guidance, ...duplicates.map((d) => d.guidance));
+        const outcomeKind = group.find((s) => s.outcomeKind === "proven")?.outcomeKind ??
+            survivor.outcomeKind ??
+            group.find((s) => s.outcomeKind)?.outcomeKind;
+        actions.push({
+            action: "UPDATE",
+            skillId: survivor.id,
+            name: survivor.name,
+            patch: {
+                name: survivor.name,
+                score: mergedScore,
+                uses: mergedUses,
+                ...(mergedGuidance ? { guidance: mergedGuidance } : {}),
+                ...(outcomeKind ? { outcomeKind } : {}),
+            },
+            reason: `merge ${duplicates.length} near-duplicate name(s) into survivor`,
+            relatedIds: duplicates.map((d) => d.id),
+        });
+        consumed.add(survivor.id);
+        for (const dup of duplicates) {
+            actions.push({
+                action: "DELETE",
+                skillId: dup.id,
+                name: dup.name,
+                reason: `duplicate of ${survivor.id} after name normalize`,
+                relatedIds: [survivor.id],
+            });
+            consumed.add(dup.id);
+        }
+    }
+    // 2) DELETE: anti-pattern when policy allows, or unused very-low score
+    const hardDeleteAnti = (0, canary_gate_1.shouldHardDeleteAntiPattern)();
+    for (const skill of skills) {
+        if (consumed.has(skill.id))
+            continue;
+        if (skill.outcomeKind === "anti-pattern" && hardDeleteAnti) {
+            actions.push({
+                action: "DELETE",
+                skillId: skill.id,
+                name: skill.name,
+                reason: "anti-pattern eligible for hard-delete per canary policy",
+            });
+            consumed.add(skill.id);
+            continue;
+        }
+        if (skill.uses === 0 && skill.score <= veryLowScore) {
+            actions.push({
+                action: "DELETE",
+                skillId: skill.id,
+                name: skill.name,
+                reason: `unused skill with very low score (<= ${veryLowScore})`,
+            });
+            consumed.add(skill.id);
+        }
+    }
+    // 3) ADD candidates (prefer UPDATE when normalized name already exists)
+    const existingByKey = new Map();
+    for (const skill of skills) {
+        if (consumed.has(skill.id) && !actions.some((a) => a.action === "UPDATE" && a.skillId === skill.id)) {
+            // deleted — do not treat as existing for ADD match
+            continue;
+        }
+        const key = normalizeSkillNameKey(skill.name);
+        if (!key)
+            continue;
+        // Prefer survivor / highest-uses entry for the key
+        const prev = existingByKey.get(key);
+        if (!prev || skill.uses > prev.uses || (skill.uses === prev.uses && skill.score > prev.score)) {
+            // Skip if this id was deleted in this plan
+            if (actions.some((a) => a.action === "DELETE" && a.skillId === skill.id))
+                continue;
+            existingByKey.set(key, skill);
+        }
+    }
+    // Re-seed from UPDATE survivors so candidate matching prefers them
+    for (const action of actions) {
+        if (action.action !== "UPDATE" || !action.skillId)
+            continue;
+        const key = normalizeSkillNameKey(action.name ?? action.patch?.name ?? "");
+        if (!key)
+            continue;
+        const base = skills.find((s) => s.id === action.skillId);
+        if (!base)
+            continue;
+        existingByKey.set(key, {
+            ...base,
+            score: action.patch?.score ?? base.score,
+            uses: action.patch?.uses ?? base.uses,
+            ...(action.patch?.guidance !== undefined ? { guidance: action.patch.guidance } : {}),
+            ...(action.patch?.outcomeKind !== undefined ? { outcomeKind: action.patch.outcomeKind } : {}),
+        });
+    }
+    for (const candidate of options?.candidates ?? []) {
+        const key = normalizeSkillNameKey(candidate.name);
+        if (!key)
+            continue;
+        const existing = existingByKey.get(key);
+        if (existing) {
+            // Prefer UPDATE over DELETE+ADD
+            const alreadyUpdated = actions.some((a) => a.action === "UPDATE" && a.skillId === existing.id);
+            if (alreadyUpdated) {
+                const update = actions.find((a) => a.action === "UPDATE" && a.skillId === existing.id);
+                const foldedGuidance = candidate.guidance
+                    ? mergeGuidance(update.patch?.guidance, candidate.guidance)
+                    : undefined;
+                update.patch = {
+                    name: update.patch?.name ?? existing.name,
+                    score: candidate.score !== undefined
+                        ? Math.max(update.patch?.score ?? existing.score, candidate.score)
+                        : (update.patch?.score ?? existing.score),
+                    uses: update.patch?.uses ?? existing.uses,
+                    ...(foldedGuidance ? { guidance: foldedGuidance } : update.patch?.guidance ? { guidance: update.patch.guidance } : {}),
+                    ...(candidate.outcomeKind
+                        ? { outcomeKind: candidate.outcomeKind }
+                        : update.patch?.outcomeKind
+                            ? { outcomeKind: update.patch.outcomeKind }
+                            : {}),
+                };
+                update.reason = `${update.reason}; fold candidate "${candidate.name}" into UPDATE`;
+                continue;
+            }
+            const mergedGuidance = mergeGuidance(existing.guidance, candidate.guidance);
+            const mergedOutcome = candidate.outcomeKind ?? existing.outcomeKind;
+            actions.push({
+                action: "UPDATE",
+                skillId: existing.id,
+                name: existing.name,
+                patch: {
+                    name: existing.name,
+                    score: Math.max(existing.score, candidate.score ?? existing.score),
+                    uses: Math.max(existing.uses, candidate.uses ?? existing.uses),
+                    ...(mergedGuidance ? { guidance: mergedGuidance } : {}),
+                    ...(mergedOutcome ? { outcomeKind: mergedOutcome } : {}),
+                },
+                reason: `prefer UPDATE over ADD for candidate matching "${existing.name}"`,
+            });
+            continue;
+        }
+        const id = (0, skill_store_1.skillNodeId)(candidate.name);
+        actions.push({
+            action: "ADD",
+            skillId: id,
+            name: candidate.name,
+            patch: {
+                name: candidate.name,
+                score: candidate.score ?? 0,
+                uses: candidate.uses ?? 0,
+                ...(candidate.guidance ? { guidance: candidate.guidance } : {}),
+                ...(candidate.outcomeKind ? { outcomeKind: candidate.outcomeKind } : {}),
+            },
+            reason: "candidate not present in skill inventory",
+        });
+    }
+    return actions;
+}
+async function listSkillNodes(client) {
+    if (client.readSnapshot) {
+        return client.readSnapshot().nodes.filter((node) => node.type === "Skill");
+    }
+    const hits = await client.queryByKeyword("skill");
+    return hits.filter((node) => node.type === "Skill");
+}
+/**
+ * Apply UPDATE / DELETE (and ADD) actions to Skill nodes.
+ * Unknown ids are skipped. DELETE falls back to soft-hide when deleteNode is missing.
+ */
+async function applySkillConsolidation(graphClient, actions) {
+    const applied = [];
+    const skipped = [];
+    const nodes = await listSkillNodes(graphClient);
+    const byId = new Map(nodes.map((n) => [n.id, n]));
+    for (const action of actions) {
+        if (action.action === "NONE") {
+            skipped.push({ action, reason: "NONE is a no-op" });
+            continue;
+        }
+        if (action.action === "ADD") {
+            const name = action.patch?.name ?? action.name;
+            if (!name?.trim()) {
+                skipped.push({ action, reason: "ADD missing name" });
+                continue;
+            }
+            const id = action.skillId ?? (0, skill_store_1.skillNodeId)(name);
+            if (byId.has(id)) {
+                skipped.push({ action, reason: `skill already exists: ${id}` });
+                continue;
+            }
+            const state = {
+                id,
+                name,
+                score: action.patch?.score ?? 0,
+                uses: action.patch?.uses ?? 0,
+                lastOutcome: "pass",
+                updatedAt: Date.now(),
+                ...(action.patch?.guidance ? { guidance: action.patch.guidance } : {}),
+                ...(action.patch?.outcomeKind ? { outcomeKind: action.patch.outcomeKind } : {}),
+            };
+            await graphClient.upsertNodes([{ id, type: "Skill", content: (0, skill_store_1.serializeAtomic)(state) }]);
+            byId.set(id, { id, type: "Skill", content: (0, skill_store_1.serializeAtomic)(state) });
+            applied.push(action);
+            continue;
+        }
+        const id = action.skillId;
+        if (!id) {
+            skipped.push({ action, reason: "missing skillId" });
+            continue;
+        }
+        const node = byId.get(id);
+        if (!node) {
+            skipped.push({ action, reason: `unknown skill id: ${id}` });
+            continue;
+        }
+        if (action.action === "DELETE") {
+            if (graphClient.deleteNode) {
+                await graphClient.deleteNode(id);
+                byId.delete(id);
+            }
+            else {
+                const atomic = (0, skill_store_1.parseSkillState)(node.content);
+                if (!atomic) {
+                    skipped.push({ action, reason: `unparseable skill for soft-hide: ${id}` });
+                    continue;
+                }
+                const hidden = {
+                    ...atomic,
+                    hidden: true,
+                    updatedAt: Date.now(),
+                };
+                await graphClient.upsertNodes([{ id, type: "Skill", content: (0, skill_store_1.serializeAtomic)(hidden) }]);
+                byId.set(id, { id, type: "Skill", content: (0, skill_store_1.serializeAtomic)(hidden) });
+            }
+            applied.push(action);
+            continue;
+        }
+        // UPDATE
+        const atomic = (0, skill_store_1.parseSkillState)(node.content);
+        if (!atomic) {
+            skipped.push({ action, reason: `unparseable skill for UPDATE: ${id}` });
+            continue;
+        }
+        const next = {
+            ...atomic,
+            name: action.patch?.name ?? atomic.name,
+            score: action.patch?.score ?? atomic.score,
+            uses: action.patch?.uses ?? atomic.uses,
+            updatedAt: Date.now(),
+            ...(action.patch?.guidance !== undefined
+                ? { guidance: action.patch.guidance }
+                : atomic.guidance
+                    ? { guidance: atomic.guidance }
+                    : {}),
+            ...(action.patch?.outcomeKind !== undefined
+                ? { outcomeKind: action.patch.outcomeKind }
+                : atomic.outcomeKind
+                    ? { outcomeKind: atomic.outcomeKind }
+                    : {}),
+        };
+        await graphClient.upsertNodes([{ id, type: "Skill", content: (0, skill_store_1.serializeAtomic)(next) }]);
+        byId.set(id, { id, type: "Skill", content: (0, skill_store_1.serializeAtomic)(next) });
+        applied.push(action);
+    }
+    return { applied, skipped };
+}
+/** Convenience: plan from a ConsolidateRequest. */
+function planFromRequest(request) {
+    return toConsolidateResult(planSkillConsolidation(request.skills, request.options));
+}
+//# sourceMappingURL=skill-consolidate.js.map

package/dist/learning/skill-consolidate.js.map

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

package/dist/learning/skill-flywheel.d.ts

@@ -3,6 +3,8 @@ import type { GraphClient } from "../graph/client-factory";
 import type { SkillState, SkillOutcomeKind } from "./skill-types";
 export type { SkillState, CompositeSkillState } from "./skill-types";
 export { composeSkillId, loadCompositeSkill } from "./skill-store";
+export { canaryPassed, gateSkillPromotion, DEFAULT_CANARY_LOCAL_SUCCESSES, shouldHardDeleteAntiPattern, } from "./canary-gate";
+export { planSkillConsolidation, applySkillConsolidation, planFromRequest, toConsolidateResult, normalizeSkillNameKey, type ConsolidateAction, type ConsolidateActionKind, type ConsolidateRequest, type ConsolidateResult, type ConsolidateSkillInput, type ConsolidateCandidate, type PlanSkillConsolidationOptions, type ApplySkillConsolidationResult, } from "./skill-consolidate";
 /** True when the text references at least one project-specific symbol. */
 export declare function hasProjectSymbolEvidence(text: string): boolean;
 /** Extract project-symbol-shaped tokens from the text (for diagnostics/tests). */
@@ -26,6 +28,8 @@ export interface SkillLearningOptions {
  * - proven:       >= 2 uses or a linked successful outcome — the ONLY class
  *                 that accrues positive score. Curated seed skills count as
  *                 proven by design (baseline, never sinkable to negative).
+ *                 External (sync/import) skills additionally require canary
+ *                 (N local successes or canaryValidated) before proven.
  * - correctable:  symbol evidence present, not yet proven. Score stays put.
  */
 export declare function classifySkillOutcome(options: {
@@ -33,7 +37,16 @@ export declare function classifySkillOutcome(options: {
     failStreak: number;
     linkedSuccess: boolean;
     seeded?: boolean;
+    provenance?: SkillState["provenance"];
+    canaryValidated?: boolean;
+    /** Successful local applications for canary (defaults to uses). */
+    localSuccesses?: number;
 }): SkillOutcomeKind;
+/**
+ * Explicit canary validate hook: mark an atomic skill as canary-validated and
+ * re-run promotion classification (external skills may become proven immediately).
+ */
+export declare function markSkillCanaryValidated(client: GraphClient, skillId: string): Promise<SkillState | undefined>;
 export interface PruneFailedSkillsOptions {
     /** Soft-hide when score is at or below this (default -5). */
     scoreThreshold?: number;
@@ -49,6 +62,7 @@ export interface PruneFailedSkillsResult {
 /**
  * Soft-hide chronically failing low-score atomic skills so they stop polluting
  * insights and hint ranking. Prefer hide over delete (Decision history stays).
+ * Anti-patterns stay isolated for audit — never hard-deleted (canary policy).
  */
 export declare function pruneFailedSkills(client: GraphClient, options?: PruneFailedSkillsOptions): Promise<PruneFailedSkillsResult>;
 export interface CleanupNoiseSkillsResult {
@@ -67,6 +81,18 @@ export interface CleanupNoiseSkillsResult {
  */
 export declare function cleanupNoiseSkills(client: GraphClient): Promise<CleanupNoiseSkillsResult>;
 export declare function applySkillLearning(client: GraphClient, task: string, run: TaskRunResult, lessons?: string[], options?: SkillLearningOptions): Promise<number>;
+/** Structured skill conditioning for plan DAG nodes / agent-bridge prompts. */
+export interface SkillConditionHints {
+    /** Proven / correctable skill names to apply while executing steps. */
+    skillRefs: string[];
+    /** Anti-pattern skill names the agent should avoid. */
+    avoidPatterns: string[];
+}
+/**
+ * Skill-conditioned DAG helper: returns proven/correctable refs plus anti-patterns
+ * to avoid, without bumping composite use counters (read-only for plan packaging).
+ */
+export declare function suggestSkillConditionHints(client: GraphClient, task: string, maxHints: number): Promise<SkillConditionHints>;
 export declare function suggestSkillHints(client: GraphClient, task: string, maxHints: number): Promise<string[]>;
 export interface SkillDecayResult {
     total: number;

package/dist/learning/skill-flywheel.d.ts.map

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