@alan512/experienceengine 0.2.1 → 0.3.0

package/dist/maintenance/claude-validate-print.js

@@ -2,11 +2,14 @@ import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
 import { homedir } from "node:os";
 import { join, resolve } from "node:path";
 import { spawnSync as nodeSpawnSync } from "node:child_process";
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
 const DEFAULT_PROMPT = "Call experienceengine_get_capabilities and summarize the direct tools in one sentence.";
 const DEFAULT_TARGET_TOOL = "mcp__experienceengine__experienceengine_get_capabilities";
+const MCP_TOOL_PREFIX = "mcp__experienceengine__";
 const toClaudeProjectSlug = (cwd) => {
     const absolute = resolve(cwd);
-    return absolute.replace(/[\\/]+/g, "-");
+    return absolute.replace(/[<>:"/\\|?*]+/g, "-");
 };
 const listTranscriptPaths = (transcriptDir) => {
     if (!existsSync(transcriptDir)) {
@@ -91,6 +94,50 @@ export const analyzeClaudeTranscript = (transcriptPath, targetToolName) => {
         usedTranscriptConclusion: Boolean(assistantText)
     };
 };
+const normalizeClaudeMcpToolName = (targetToolName) => targetToolName.startsWith(MCP_TOOL_PREFIX) ? targetToolName.slice(MCP_TOOL_PREFIX.length) : targetToolName;
+const checkExperienceEngineMcpServerTools = async (targetToolName, cwd) => {
+    const cliEntry = process.argv[1];
+    if (!cliEntry) {
+        return {
+            mcpServerToolAvailable: false,
+            mcpServerToolNames: [],
+            mcpServerError: "CLI entrypoint is unavailable."
+        };
+    }
+    const target = normalizeClaudeMcpToolName(targetToolName);
+    const client = new Client({ name: "experienceengine-claude-print-validation", version: "0.0.0" });
+    const transport = new StdioClientTransport({
+        command: process.execPath,
+        args: [cliEntry, "mcp-server"],
+        cwd,
+        env: Object.fromEntries(Object.entries(process.env).filter((entry) => entry[1] !== undefined))
+    });
+    try {
+        await client.connect(transport);
+        const result = await client.listTools();
+        const names = result.tools.map((tool) => tool.name).filter((name) => name.startsWith("experienceengine_"));
+        return {
+            mcpServerToolAvailable: names.includes(target),
+            mcpServerToolNames: names,
+            mcpServerError: null
+        };
+    }
+    catch (error) {
+        return {
+            mcpServerToolAvailable: false,
+            mcpServerToolNames: [],
+            mcpServerError: error instanceof Error ? error.message : String(error)
+        };
+    }
+    finally {
+        try {
+            await client.close();
+        }
+        catch {
+            // Ignore cleanup failures after collecting diagnostics.
+        }
+    }
+};
 export const runClaudePrintValidation = async (options = {}) => {
     const cwd = resolve(options.cwd ?? process.cwd());
     const homeDir = options.homeDir ?? homedir();
@@ -98,6 +145,7 @@ export const runClaudePrintValidation = async (options = {}) => {
     const targetToolName = options.targetToolName ?? DEFAULT_TARGET_TOOL;
     const transcriptDir = join(homeDir, ".claude", "projects", toClaudeProjectSlug(cwd));
     const spawnSync = options.spawnSync ?? nodeSpawnSync;
+    const mcpServerCheck = options.mcpServerCheck ?? checkExperienceEngineMcpServerTools;
     const command = ["claude", "-p", "--permission-mode", "bypassPermissions", prompt];
     const result = spawnSync(command[0], command.slice(1), {
         cwd,
@@ -105,13 +153,15 @@ export const runClaudePrintValidation = async (options = {}) => {
     });
     const transcriptPath = findLatestTranscript(transcriptDir);
     const analysis = analyzeClaudeTranscript(transcriptPath, targetToolName);
+    const mcpServerAnalysis = await mcpServerCheck(targetToolName, cwd);
     return {
         command,
         exitCode: result.status,
         stdout: typeof result.stdout === "string" ? result.stdout : "",
         stderr: typeof result.stderr === "string" ? result.stderr : "",
         targetToolName,
-        ...analysis
+        ...analysis,
+        ...mcpServerAnalysis
     };
 };
 //# sourceMappingURL=claude-validate-print.js.map

package/dist/maintenance/claude-validate-print.js.map

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

package/dist/maintenance/experience-export-drafts.d.ts

@@ -0,0 +1,56 @@
+import type { AttributionRecord, DeliveryState, ExperienceCandidate, ExperienceNode, ExperienceNodeType, ExperienceState, TaskType } from "../types/domain.js";
+import type { HygieneFinding } from "./experience-hygiene.js";
+export type ExportDraftRisk = "low" | "medium" | "high";
+export type ExportDraftTargetType = "instruction_note" | "repo_guidance" | "skill_candidate" | "documentation_note" | "do_not_export";
+export type ExperienceExportDraftFilters = {
+    scopeId?: string;
+    nodeId?: string;
+    nodeType?: ExperienceNodeType;
+    taskFamily?: TaskType;
+    state?: ExperienceState;
+    deliveryState?: DeliveryState;
+    risk?: ExportDraftRisk;
+    limit?: number;
+};
+export type ExperienceExportDraft = {
+    draftId: string;
+    scopeId: string;
+    nodeIds: string[];
+    contextCandidateIds: string[];
+    nodeType: ExperienceNodeType;
+    taskFamily: TaskType;
+    guidanceText: string;
+    applicabilityNotes?: string;
+    evidenceSummary: string;
+    provenanceRefs: string[];
+    risk: ExportDraftRisk;
+    riskNotes: string[];
+    hygieneNotes: string[];
+    helpedSignals: number;
+    harmedSignals: number;
+    deliveryState?: DeliveryState;
+    lifecycleState: ExperienceState;
+    suggestedTargetType: ExportDraftTargetType;
+    readinessScore: number;
+    lastEvidenceAt: string;
+};
+export type ExperienceExportDraftReport = {
+    scopeId?: string;
+    generatedAt: string;
+    filters: Required<Pick<ExperienceExportDraftFilters, "limit">> & Omit<ExperienceExportDraftFilters, "limit">;
+    summary: {
+        total: number;
+        byRisk: Record<ExportDraftRisk, number>;
+        byTargetType: Record<ExportDraftTargetType, number>;
+    };
+    drafts: ExperienceExportDraft[];
+};
+export type BuildExperienceExportDraftInput = {
+    nodes: ExperienceNode[];
+    candidates?: ExperienceCandidate[];
+    attributionRecords?: AttributionRecord[];
+    hygieneFindings?: HygieneFinding[];
+    filters?: ExperienceExportDraftFilters;
+    now?: string;
+};
+export declare const buildExperienceExportDraftReport: (input: BuildExperienceExportDraftInput) => ExperienceExportDraftReport;

package/dist/maintenance/experience-export-drafts.js

@@ -0,0 +1,217 @@
+const DEFAULT_LIMIT = 20;
+const RISKS = ["low", "medium", "high"];
+const TARGET_TYPES = [
+    "instruction_note",
+    "repo_guidance",
+    "skill_candidate",
+    "documentation_note",
+    "do_not_export"
+];
+const HIGH_SEVERITY = "high";
+const emptyRiskCounts = () => Object.fromEntries(RISKS.map((risk) => [risk, 0]));
+const emptyTargetCounts = () => Object.fromEntries(TARGET_TYPES.map((target) => [target, 0]));
+const latestIso = (...values) => values.filter((value) => Boolean(value)).sort().at(-1) ?? "";
+const stableDraftId = (node) => `draft_${node.id}`;
+const hasExplicitLowReadinessFilter = (filters) => Boolean(filters.nodeId || filters.risk || filters.state || filters.deliveryState);
+const isDefaultExportable = (node) => {
+    if (node.state !== "active") {
+        return false;
+    }
+    if (node.delivery_state && node.delivery_state !== "eligible") {
+        return false;
+    }
+    if (node.harmed_count > node.helped_count) {
+        return false;
+    }
+    return true;
+};
+const isLowReadiness = (node) => node.state !== "active"
+    || node.delivery_state === "conservative_only"
+    || node.delivery_state === "shadow_only"
+    || node.delivery_state === "quarantined"
+    || node.harmed_count > node.helped_count;
+const addUnique = (values) => [...new Set(values.filter(Boolean))];
+const collectAttributionByNode = (records) => {
+    const byNode = new Map();
+    for (const record of records) {
+        const entries = byNode.get(record.node_id) ?? [];
+        entries.push(record);
+        byNode.set(record.node_id, entries);
+    }
+    return byNode;
+};
+const collectHygieneByNode = (findings) => {
+    const byNode = new Map();
+    for (const finding of findings) {
+        for (const nodeId of finding.affectedNodeIds) {
+            const entries = byNode.get(nodeId) ?? [];
+            entries.push(finding);
+            byNode.set(nodeId, entries);
+        }
+    }
+    return byNode;
+};
+const contextCandidateIdsForNode = (node, candidates, findings) => {
+    const fromFindings = findings.flatMap((finding) => finding.affectedCandidateIds);
+    const overlapping = candidates
+        .filter((candidate) => candidate.scope_id === node.scope_id && candidate.task_type === node.task_type)
+        .filter((candidate) => fromFindings.includes(candidate.id))
+        .map((candidate) => candidate.id);
+    return addUnique(overlapping);
+};
+const buildGuidanceText = (node) => {
+    const lines = [node.compact_hint];
+    if (node.recommended_steps?.length) {
+        lines.push(`Recommended: ${node.recommended_steps.join(" | ")}`);
+    }
+    if (node.avoid_steps?.length) {
+        lines.push(`Avoid: ${node.avoid_steps.join(" | ")}`);
+    }
+    if (node.success_signal) {
+        lines.push(`Success: ${node.success_signal}`);
+    }
+    return lines.join("\n");
+};
+const riskForNode = (node, hygiene, attribution) => {
+    if (hygiene.some((finding) => finding.severity === HIGH_SEVERITY)
+        || node.delivery_state === "quarantined"
+        || node.state === "retired"
+        || node.harmed_count > node.helped_count
+        || attribution.some((record) => record.attribution_verdict === "strong_harmed")) {
+        return "high";
+    }
+    if (node.state === "candidate"
+        || node.state === "priority_candidate"
+        || node.state === "cooling"
+        || node.delivery_state === "conservative_only"
+        || node.delivery_state === "shadow_only"
+        || node.harmed_count > 0
+        || hygiene.some((finding) => finding.severity === "medium")) {
+        return "medium";
+    }
+    return "low";
+};
+const targetTypeForNode = (node, risk, hygiene) => {
+    if (risk === "high" || hygiene.some((finding) => finding.severity === HIGH_SEVERITY) || isLowReadiness(node)) {
+        return "do_not_export";
+    }
+    if (node.node_type === "warning") {
+        return "instruction_note";
+    }
+    if (node.validation_state === "validated_by_reuse" || node.helped_count > 0) {
+        return "repo_guidance";
+    }
+    if ((node.recommended_steps?.length ?? 0) >= 2 && node.applicability_notes) {
+        return "skill_candidate";
+    }
+    return "documentation_note";
+};
+const riskNotesForNode = (node, hygiene, attribution) => {
+    const notes = [];
+    if (!isDefaultExportable(node)) {
+        notes.push(`Not default-exportable: lifecycle=${node.state}, delivery=${node.delivery_state ?? "eligible"}.`);
+    }
+    if (node.harmed_count > 0) {
+        notes.push(`Has ${node.harmed_count} harmed signal(s).`);
+    }
+    for (const finding of hygiene) {
+        notes.push(`${finding.severity} hygiene ${finding.type}: ${finding.evidenceSummary}`);
+    }
+    const harmed = attribution.filter((record) => record.attribution_verdict === "strong_harmed" || record.attribution_verdict === "weak_harmed");
+    if (harmed.length) {
+        notes.push(`Has ${harmed.length} recent harmed attribution record(s).`);
+    }
+    return addUnique(notes);
+};
+const readinessScoreForNode = (node, risk) => {
+    const riskPenalty = { low: 0, medium: 20, high: 50 };
+    const deliveryBonus = node.delivery_state === "eligible" || !node.delivery_state ? 20 : 0;
+    const stateBonus = node.state === "active" ? 25 : node.state === "cooling" ? 5 : 0;
+    const validationBonus = node.validation_state === "validated_by_reuse" ? 15 : 0;
+    const feedbackScore = node.helped_count * 8 - node.harmed_count * 12;
+    return stateBonus + deliveryBonus + validationBonus + feedbackScore + node.support_count - riskPenalty[risk];
+};
+const buildDraft = (node, candidates, hygiene, attribution) => {
+    const risk = riskForNode(node, hygiene, attribution);
+    const targetType = targetTypeForNode(node, risk, hygiene);
+    const provenanceRefs = addUnique([
+        ...node.origin_record_ids,
+        ...node.helped_record_ids,
+        ...node.harmed_record_ids,
+        ...hygiene.flatMap((finding) => finding.evidenceRefs),
+        ...attribution.flatMap((record) => record.evidence_refs)
+    ]);
+    const lastEvidenceAt = latestIso(node.last_helped_at, node.last_harmed_at, node.last_used_at, node.updated_at, ...hygiene.map((finding) => finding.createdAt), ...attribution.map((record) => record.created_at));
+    return {
+        draftId: stableDraftId(node),
+        scopeId: node.scope_id,
+        nodeIds: [node.id],
+        contextCandidateIds: contextCandidateIdsForNode(node, candidates, hygiene),
+        nodeType: node.node_type,
+        taskFamily: node.task_type,
+        guidanceText: buildGuidanceText(node),
+        applicabilityNotes: node.applicability_notes,
+        evidenceSummary: node.evidence_summary,
+        provenanceRefs,
+        risk,
+        riskNotes: riskNotesForNode(node, hygiene, attribution),
+        hygieneNotes: hygiene.map((finding) => finding.recommendation),
+        helpedSignals: node.helped_count,
+        harmedSignals: node.harmed_count,
+        deliveryState: node.delivery_state,
+        lifecycleState: node.state,
+        suggestedTargetType: targetType,
+        readinessScore: readinessScoreForNode(node, risk),
+        lastEvidenceAt
+    };
+};
+export const buildExperienceExportDraftReport = (input) => {
+    const filters = input.filters ?? {};
+    const limit = filters.limit ?? DEFAULT_LIMIT;
+    const attributionByNode = collectAttributionByNode(input.attributionRecords ?? []);
+    const hygieneByNode = collectHygieneByNode(input.hygieneFindings ?? []);
+    const explicitLowReadiness = hasExplicitLowReadinessFilter(filters);
+    const drafts = input.nodes
+        .filter((node) => !filters.scopeId || node.scope_id === filters.scopeId)
+        .filter((node) => !filters.nodeId || node.id === filters.nodeId)
+        .filter((node) => !filters.nodeType || node.node_type === filters.nodeType)
+        .filter((node) => !filters.taskFamily || node.task_type === filters.taskFamily)
+        .filter((node) => !filters.state || node.state === filters.state)
+        .filter((node) => !filters.deliveryState || node.delivery_state === filters.deliveryState)
+        .filter((node) => explicitLowReadiness || isDefaultExportable(node))
+        .map((node) => buildDraft(node, (input.candidates ?? []).filter((candidate) => !filters.scopeId || candidate.scope_id === filters.scopeId), hygieneByNode.get(node.id) ?? [], attributionByNode.get(node.id) ?? []))
+        .filter((draft) => !filters.risk || draft.risk === filters.risk)
+        .sort((left, right) => {
+        const readinessDelta = right.readinessScore - left.readinessScore;
+        if (readinessDelta !== 0) {
+            return readinessDelta;
+        }
+        const evidenceDelta = right.lastEvidenceAt.localeCompare(left.lastEvidenceAt);
+        if (evidenceDelta !== 0) {
+            return evidenceDelta;
+        }
+        return left.draftId.localeCompare(right.draftId);
+    })
+        .slice(0, limit);
+    const byRisk = emptyRiskCounts();
+    const byTargetType = emptyTargetCounts();
+    for (const draft of drafts) {
+        byRisk[draft.risk] += 1;
+        byTargetType[draft.suggestedTargetType] += 1;
+    }
+    return {
+        scopeId: filters.scopeId,
+        generatedAt: input.now ?? new Date().toISOString(),
+        filters: {
+            ...filters,
+            limit
+        },
+        summary: {
+            total: drafts.length,
+            byRisk,
+            byTargetType
+        },
+        drafts
+    };
+};
+//# sourceMappingURL=experience-export-drafts.js.map

package/dist/maintenance/experience-export-drafts.js.map

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

package/dist/maintenance/experience-hygiene.d.ts

@@ -0,0 +1,38 @@
+import type { AttributionRecord, ExperienceCandidate, ExperienceNode } from "../types/domain.js";
+export type HygieneFindingType = "stale_experience" | "duplicate_guidance" | "conflicting_guidance" | "over_generalized_guidance" | "evidence_drift";
+export type HygieneSeverity = "high" | "medium" | "low";
+export type HygieneReviewFilters = {
+    scopeId?: string;
+    type?: HygieneFindingType;
+    severity?: HygieneSeverity;
+    limit?: number;
+    now?: string;
+};
+export type HygieneFinding = {
+    type: HygieneFindingType;
+    severity: HygieneSeverity;
+    affectedNodeIds: string[];
+    affectedCandidateIds: string[];
+    evidenceSummary: string;
+    recommendation: string;
+    evidenceRefs: string[];
+    createdAt: string;
+};
+export type HygieneReviewReport = {
+    scopeId?: string;
+    generatedAt: string;
+    filters: Omit<HygieneReviewFilters, "now">;
+    summary: {
+        total: number;
+        byType: Record<HygieneFindingType, number>;
+        bySeverity: Record<HygieneSeverity, number>;
+    };
+    findings: HygieneFinding[];
+};
+export type BuildHygieneReviewInput = {
+    nodes: ExperienceNode[];
+    candidates: ExperienceCandidate[];
+    attributionRecords: AttributionRecord[];
+    filters?: HygieneReviewFilters;
+};
+export declare const buildHygieneReviewReport: (input: BuildHygieneReviewInput) => HygieneReviewReport;