@alan512/experienceengine 0.3.1 → 0.3.3

package/dist/runtime/task-finalization-service.d.ts

@@ -0,0 +1,36 @@
+import type { InputRecordRepository } from "../store/sqlite/repositories/input-record-repo.js";
+import type { OutcomeRecordRepository } from "../store/sqlite/repositories/outcome-record-repo.js";
+import type { ScopeRepository } from "../store/sqlite/repositories/scope-repo.js";
+import type { StatsRepository } from "../store/sqlite/repositories/stats-repo.js";
+import type { TaskRunRepository } from "../store/sqlite/repositories/task-run-repo.js";
+import type { ExperienceInput, ExperienceInputRecord, TaskRun, ToolEvent } from "../types/domain.js";
+import type { HostPromptContext } from "../types/plugin.js";
+export type TaskFinalizationSessionState = {
+    context?: HostPromptContext;
+    toolEvents: ToolEvent[];
+    injectedNodeIds: string[];
+};
+export type TaskFinalizationServiceOptions = {
+    scopeRepo: ScopeRepository;
+    inputRepo: InputRecordRepository;
+    taskRunRepo: TaskRunRepository;
+    outcomeRepo: OutcomeRecordRepository;
+    statsRepo: StatsRepository;
+};
+export declare const mergeContext: (existing: HostPromptContext | undefined, incoming: HostPromptContext) => HostPromptContext;
+export declare class TaskFinalizationService {
+    private readonly options;
+    constructor(options: TaskFinalizationServiceOptions);
+    buildFinalizedInput(context: HostPromptContext, session: TaskFinalizationSessionState): ExperienceInput;
+    persistFinalizedRun(input: {
+        experienceInput: ExperienceInput;
+        sessionId: string;
+        session: TaskFinalizationSessionState;
+        episodeId?: string;
+        context: HostPromptContext;
+        cwd?: string;
+    }): {
+        record: ExperienceInputRecord;
+        taskRun: TaskRun;
+    };
+}

package/dist/runtime/task-finalization-service.js

@@ -0,0 +1,97 @@
+import { buildCandidateSignals } from "../analyzer/candidate-signals.js";
+import { createEmptyStats, updateStats } from "../feedback/stats-updater.js";
+import { buildExperienceInput } from "../input/input-adapter.js";
+import { resolveScope } from "../input/scope-resolver.js";
+import { nowIso } from "../utils/clock.js";
+import { createId, stableId } from "../utils/ids.js";
+export const mergeContext = (existing, incoming) => ({
+    host: incoming.host ?? existing?.host,
+    sessionId: incoming.sessionId ?? existing?.sessionId,
+    cwd: incoming.cwd ?? existing?.cwd,
+    userMessage: incoming.userMessage || existing?.userMessage || "",
+    taskSummary: incoming.taskSummary ?? existing?.taskSummary,
+    contextSummary: incoming.contextSummary ?? existing?.contextSummary,
+    injectedNodeIds: incoming.injectedNodeIds ?? existing?.injectedNodeIds
+});
+const toEvidence = (input) => input.tool_events.map((event) => [event.tool_name, event.status, event.error_signature ?? event.output_summary]
+    .filter(Boolean)
+    .join(": "));
+const toInputRecord = (input, sessionId, episodeId) => ({
+    record_id: createId("input"),
+    episode_id: episodeId,
+    scope_id: input.scope_id,
+    session_id: sessionId,
+    task_type: input.task_type,
+    task_summary: input.task_summary,
+    outcome_signal: input.outcome_signal,
+    context_summary: input.context_summary,
+    evidence: toEvidence(input),
+    injected_node_ids: input.injected_node_ids,
+    created_at: nowIso()
+});
+const toTaskRun = (input, sessionId, context, episodeId) => {
+    const timestamp = nowIso();
+    const signals = buildCandidateSignals(input);
+    return {
+        id: stableId("taskrun", `${sessionId}:${input.task_summary}:${timestamp}`),
+        episode_id: episodeId,
+        host: context.host ?? "openclaw",
+        scope_id: input.scope_id,
+        session_id: sessionId,
+        task_type: input.task_type,
+        task_summary: input.task_summary,
+        prompt_excerpt: context.userMessage,
+        context_summary: input.context_summary,
+        started_at: timestamp,
+        ended_at: timestamp,
+        final_status: input.outcome_signal === "success" ? "success" : input.outcome_signal === "failure" ? "failure" : "unknown",
+        failure_signature: signals.failure_signature,
+        learning_status: undefined,
+        learning_reason: undefined,
+        created_at: timestamp,
+        updated_at: timestamp
+    };
+};
+const toOutcomeRecord = (taskRun, input, episodeId) => ({
+    id: createId("outcome"),
+    episode_id: episodeId,
+    task_run_id: taskRun.id,
+    outcome_signal: input.outcome_signal,
+    failure_signature: taskRun.failure_signature,
+    summary: input.task_summary,
+    created_at: nowIso()
+});
+export class TaskFinalizationService {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    buildFinalizedInput(context, session) {
+        const mergedContext = mergeContext(session.context, context);
+        const injectedNodeIds = session.injectedNodeIds.length > 0 ? session.injectedNodeIds : mergedContext.injectedNodeIds ?? [];
+        return buildExperienceInput({
+            ...mergedContext,
+            injectedNodeIds
+        }, session.toolEvents);
+    }
+    persistFinalizedRun(input) {
+        const resolvedScope = resolveScope(input.cwd ?? input.session.context?.cwd);
+        const existingScope = this.options.scopeRepo.getById(resolvedScope.scope_id);
+        this.options.scopeRepo.upsert({
+            ...resolvedScope,
+            is_disabled: existingScope?.is_disabled ?? resolvedScope.is_disabled
+        });
+        const record = toInputRecord(input.experienceInput, input.sessionId, input.episodeId);
+        this.options.inputRepo.upsert(record);
+        if (input.experienceInput.task_type !== "unknown") {
+            const currentStats = this.options.statsRepo.get(input.experienceInput.scope_id, input.experienceInput.task_type) ??
+                createEmptyStats(input.experienceInput.scope_id, input.experienceInput.task_type);
+            this.options.statsRepo.upsert(updateStats(currentStats, input.experienceInput.outcome_signal, input.experienceInput.injected_node_ids.length > 0));
+        }
+        const taskRun = toTaskRun(input.experienceInput, input.sessionId, input.context, input.episodeId);
+        this.options.taskRunRepo.upsert(taskRun);
+        this.options.outcomeRepo.upsert(toOutcomeRecord(taskRun, input.experienceInput, input.episodeId));
+        return { record, taskRun };
+    }
+}
+//# sourceMappingURL=task-finalization-service.js.map

package/dist/runtime/task-finalization-service.js.map

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

package/dist/types/domain.d.ts

@@ -28,6 +28,7 @@ export type MatchScorecard = {
 };
 export type InterventionConfidence = "low" | "medium" | "high";
 export type InterventionBudgetClass = "none" | "single_hint" | "multi_hint";
+export type SkipReasonCode = "scope_disabled" | "repo_policy_blocked_or_circuit_open" | "holdout_suppressed" | "shadow_suppressed" | "no_candidate" | "candidate_not_mature" | "delivery_state_shadow_only" | "recent_harm_or_quarantined" | "semantic_match_policy_rejected" | "task_family_mismatch" | "low_confidence_or_score_margin" | "record_only_diagnostic_candidate";
 export type SyncSecondOpinionDecision = "allow" | "allow_conservative" | "skip";
 export type SyncSecondOpinionTrigger = "conservative_delivery_state" | "harm_history" | "close_score_margin" | "expectation_correction";
 export type EvaluationMode = "live" | "shadow" | "holdout";
@@ -358,6 +359,9 @@ export type InterventionRejectedCandidate = {
 };
 export type InterventionDecisionDiagnostics = {
     interventionStrength?: InterventionStrength;
+    renderingPolicyReason?: string;
+    skipReasonCode?: SkipReasonCode;
+    skipReasonExplanation?: string;
     recordOnlyDiagnosticCandidateIds?: string[];
     retrievalPolicyDiagnostics?: RetrievalPolicyDiagnostics;
     topCandidates: InjectionScorecardCandidate[];
@@ -387,6 +391,9 @@ export type InjectionScorecard = {
     taskSummary: string;
     mode: InjectionMode;
     interventionStrength?: InterventionStrength;
+    renderingPolicyReason?: string;
+    skipReasonCode?: SkipReasonCode;
+    skipReasonExplanation?: string;
     riskLevel: InjectionRiskLevel;
     recommendation: string;
     reasons: string[];

package/docs/releases/v0.3.2.md

@@ -0,0 +1,20 @@
+# ExperienceEngine v0.3.2
+
+Release date: 2026-05-13
+
+## Summary
+
+v0.3.2 is a Codex App hook compatibility patch for Windows projects that previously used inline `node -e` hook commands.
+
+## Included
+
+- Changed Windows Codex project hook registration to call the generated `.codex/experienceengine-codex-hook.cmd` launcher instead of relying on `node` being available on the Codex App process `PATH`.
+- Kept POSIX / WSL Codex CLI hook registration on the existing cross-runtime command path so working CLI setups are not forced onto the Windows launcher.
+- Updated `ee install codex` and `ee repair codex` to pass the resolved runtime target into project hook generation.
+- Added repair coverage for stale inline `node -e ... codex-hook` entries so existing projects are migrated to the stable launcher command.
+
+## Upgrade Notes
+
+- Existing Codex App users should update to `@alan512/experienceengine@0.3.2`, then run `ee repair codex` in each Codex-enabled repo.
+- If repairing a Windows Codex App project from WSL, run `EXPERIENCE_ENGINE_CODEX_RUNTIME_TARGET=windows ee repair codex`.
+- Reopen the Codex App project window, run `/hooks`, and approve ExperienceEngine's `UserPromptSubmit`, `PostToolUse`, and `Stop` hooks again because the hook command hash changed.

package/docs/releases/v0.3.3.md

@@ -0,0 +1,18 @@
+# ExperienceEngine v0.3.3
+
+Release date: 2026-05-14
+
+## Summary
+
+v0.3.3 is an OpenClaw packaging metadata patch that keeps the packaged plugin manifest version aligned with the npm package version.
+
+## Included
+
+- Updated the OpenClaw plugin manifest version for the v0.3.3 package.
+- Made the OpenClaw install tarball generator write `openclaw.plugin.json` with the same version as `package.json`.
+- Added package verification coverage so future OpenClaw install artifacts cannot drift between package and plugin manifest versions.
+
+## Upgrade Notes
+
+- Existing OpenClaw users should update to `@alan512/experienceengine@0.3.3`, then run `ee upgrade openclaw` or `ee repair openclaw` in the OpenClaw host environment.
+- If OpenClaw is installed inside WSL, run the command from that WSL distribution so the plugin is installed into the correct host config and extension directories.

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "experienceengine",
   "name": "ExperienceEngine",
-  "version": "0.3.0",
+  "version": "0.3.3",
   "description": "Context-aware experience intervention controller for coding and debugging tasks.",
   "configSchema": {
     "type": "object",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alan512/experienceengine",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "type": "module",
   "description": "Experience governance for coding agents: learn from real task outcomes, inject reusable hints, and retire low-value guidance.",
   "license": "MIT",