@alan512/experienceengine 0.1.0 → 0.1.3

package/dist/types/domain.d.ts

@@ -1,7 +1,9 @@
 export type TaskType = "bug_fix" | "build_debug" | "config_debug" | "test_debug" | "integration_fix" | "feature_add" | "refactor" | "performance" | "general";
 export type ResolvedTaskType = TaskType | "unknown";
-export type ExperienceState = "candidate" | "active" | "cooling" | "retired";
+export type ExperienceState = "candidate" | "priority_candidate" | "active" | "cooling" | "retired";
 export type ExperienceNodeType = "strategy" | "warning";
+export type PromotionSignal = "normal" | "high_value";
+export type MergeAction = "ADD" | "UPDATE" | "NONE";
 export type ExperienceKind = "execution_pattern" | "config_troubleshooting" | "verification_loop" | "warning" | "expectation_correction";
 export type ConfidenceSignal = "confirmed_by_user" | "supported_by_objective_success" | "unconfirmed";
 export type ValidationState = "pending_reuse_validation" | "validated_by_reuse" | "invalidated";
@@ -18,9 +20,6 @@ export type DistillationMode = "auto" | "llm" | "rule" | "disabled";
 export type ResolvedDistillationMode = Exclude<DistillationMode, "auto">;
 export type DistillationSource = "explicit_provider" | "rule" | "disabled";
 export type FeedbackAttributionReason = "success_outcome" | "relevant_failure" | "environmental_failure" | "exploratory_failure" | "no_relevant_failure" | "suppressed_delivery" | "unknown_outcome";
-export type ExperiencePackStatus = "draft" | "review" | "published" | "rolled_back";
-export type ExperiencePackHost = "openclaw" | "claude-code" | "codex";
-export type ExperiencePackRiskLevel = "low" | "medium" | "high";
 export type Scope = {
     scope_id: string;
     scope_type: "workspace" | "repo";
@@ -75,6 +74,8 @@ export type TaskRun = {
     ended_at?: string;
     final_status: "success" | "failure" | "cancelled" | "unknown";
     failure_signature?: string;
+    learning_status?: "captured" | "rejected" | "not_applicable";
+    learning_reason?: string;
     created_at: string;
     updated_at: string;
 };
@@ -127,6 +128,11 @@ export type ExperienceNode = {
     distillation_mode_used?: ResolvedDistillationMode;
     distillation_source?: DistillationSource;
     redistilled_from?: DistillationSource;
+    promotion_signal?: PromotionSignal;
+    promotion_reason?: string;
+    merge_decision?: MergeAction;
+    merge_reason?: string;
+    priority_promotion_applied?: boolean;
     source_kind: "system_derived" | "user_authored_candidate_promoted";
     origin_record_ids: string[];
     helped_record_ids: string[];
@@ -174,6 +180,15 @@ export type InjectionScorecardNode = {
     riskLevel: InjectionRiskLevel;
     whyMatched: string[];
 };
+export type InjectionScorecardCandidate = {
+    id: string;
+    semanticScore?: number;
+    lexicalScore?: number;
+    fusedScore?: number;
+    rerankScore?: number;
+    rerankSource?: "heuristic" | "model";
+    taskFamilyMatch: boolean;
+};
 export type InjectionScorecard = {
     sessionId?: string;
     scopeId: string;
@@ -183,6 +198,17 @@ export type InjectionScorecard = {
     riskLevel: InjectionRiskLevel;
     recommendation: string;
     reasons: string[];
+    topCandidates?: InjectionScorecardCandidate[];
+    topCandidateScore?: number;
+    scoreMargin?: number;
+    fastPathApplied?: boolean;
+    queryRewriteApplied?: boolean;
+    mergeDecision?: MergeAction;
+    mergeReason?: string;
+    promotionSignal?: PromotionSignal;
+    priorityPromotionApplied?: boolean;
+    gateReason?: string;
+    decisionReason?: string;
     nodes: InjectionScorecardNode[];
     createdAt: string;
 };
@@ -197,48 +223,6 @@ export type ScopeTaskStats = {
     injected_success_tasks: number;
     updated_at: string;
 };
-export type ExperiencePackSummaryRecord = {
-    pack_id: string;
-    name: string;
-    description: string;
-    owner: string;
-    status: ExperiencePackStatus;
-    current_version: string;
-    scope_hints: string[];
-    task_families: TaskType[];
-    host_compatibility: ExperiencePackHost[];
-    created_at: string;
-    updated_at: string;
-    published_at?: string;
-    rolled_back_at?: string;
-};
-export type ExperiencePackVersionRecord = {
-    pack_id: string;
-    version: string;
-    status_snapshot: ExperiencePackStatus;
-    evidence_summary: string;
-    benchmark_summary?: string;
-    risk_level: ExperiencePackRiskLevel;
-    ttl?: string;
-    host_compatibility: ExperiencePackHost[];
-    created_at: string;
-    published_at?: string;
-    rolled_back_from?: string;
-};
-export type ExperiencePackMembership = {
-    pack_id: string;
-    version: string;
-    node_id: string;
-    created_at: string;
-};
-export type ExperiencePackActivation = {
-    scope_id: string;
-    pack_id: string;
-    enabled: boolean;
-    pinned_version?: string;
-    created_at: string;
-    updated_at: string;
-};
 export type ExperienceCandidateDraft = Omit<ExperienceNode, "id" | "state" | "usage_count" | "helped_count" | "harmed_count" | "support_count" | "origin_record_ids" | "helped_record_ids" | "harmed_record_ids" | "last_used_at" | "last_helped_at" | "last_harmed_at" | "created_at" | "updated_at">;
 export type CandidateSourceSignal = {
     task_summary: string;

package/dist/types/plugin.d.ts

@@ -1,6 +1,7 @@
-import type { EvaluationMode, ExperienceInput, InjectionMode, InjectionScorecard, ToolEvent } from "./domain.js";
+import type { EvaluationMode, ExperienceInput, InjectionMode, InjectionScorecard, TaskRun, ToolEvent } from "./domain.js";
 import type { ExperienceEngineConfig } from "../config/config-schema.js";
 export type HostPromptContext = {
+    host?: TaskRun["host"];
     sessionId?: string;
     cwd?: string;
     userMessage: string;

package/docs/releases/v0.1.2.md

@@ -25,10 +25,10 @@ Host wiring remains host-specific:
 
 The shared `ee` CLI is now the operational surface after installation, not the public installation surface itself.
 
-Current planned host-native surfaces now documented:
+Current host-native install surfaces now documented:
 
-- `openclaw plugins install @alan512/experienceengine` (blocked until the public npm package is published)
-- `codex mcp add experienceengine --env EXPERIENCE_ENGINE_HOME=$HOME/.experienceengine -- npx -y @alan512/experienceengine codex-mcp-server` (blocked until the public npm package is published)
+- `openclaw plugins install @alan512/experienceengine`
+- `codex mcp add experienceengine --env EXPERIENCE_ENGINE_HOME=$HOME/.experienceengine -- npx -y @alan512/experienceengine codex-mcp-server`
 
 Current Claude-native distribution surface now documented:
 

package/docs/releases/v0.1.3.md

@@ -0,0 +1,94 @@
+# ExperienceEngine v0.1.3
+
+Release date: 2026-03-29
+
+## Summary
+
+`v0.1.3` tightens the product surface around three things:
+
+- a more complete host-native daily workflow for `OpenClaw`
+- a cleaner onboarding and inspection experience across hosts
+- a smaller Codex MCP schema surface with less duplicated public schema
+
+This release is mainly about productization and day-to-day usability, not a new learning core.
+
+## Included In This Release
+
+### OpenClaw Daily Interaction Loop
+
+`OpenClaw` now has a complete daily host-native routine interaction track for common ExperienceEngine questions.
+
+Users can now ask in-session about:
+
+- what ExperienceEngine just injected
+- why a hint matched
+- whether the last intervention helped or harmed
+- whether ExperienceEngine is ready in the current repo
+- whether the repo is still warming up
+- why ExperienceEngine stayed quiet on the latest turn
+- a compact repo-level ExperienceEngine summary
+
+This completes the intended daily host-native interaction loop for `OpenClaw`, while keeping deeper diagnostics and operator workflows in CLI.
+
+### Onboarding And First-Value Guidance
+
+The onboarding model is now clearer and more product-facing:
+
+- `Setup state`
+  - `Installed`
+  - `Initialized`
+  - `Ready`
+- `Value state`
+  - `Warming up`
+  - `First value reached`
+
+This release aligns those states across:
+
+- `ee install`
+- `ee init`
+- `ee status`
+- `ee doctor`
+- `README`
+- `User Guide`
+
+It also makes first value stricter: generic warm-up text does not count as value unless a real task produced visible ExperienceEngine output.
+
+### Better Explanation Surfaces
+
+ExperienceEngine now explains its behavior more clearly in the places users actually look:
+
+- `inspect --last`
+- node and repo inspection summaries
+- `status`
+- `doctor`
+- Codex MCP summary payloads
+
+The default path now favors short product-facing explanations, while deeper inspection still retains the more exact system details where needed.
+
+### Codex MCP Schema Slimming
+
+This release trims duplicated public MCP schema in the Codex adapter without changing the current agent-first workflow:
+
+- merged duplicate feedback, scope-state, and node-lifecycle tools
+- shortened high-traffic prompt text
+- kept repo summary as a resource-only read surface
+
+The result is a smaller public schema footprint with no change to the resource-first review flow.
+
+### Marketplace-Facing Metadata
+
+This release also improves public discovery packaging:
+
+- npm package description is now product-facing instead of internal MVP wording
+- README now explicitly calls out:
+  - OpenClaw compatibility expectations
+  - Node.js `>=20`
+  - a minimal shared `ee init` example
+
+These changes are aimed at making the GitHub + npm landing page easier to understand before official directory approval lands.
+
+## Notes
+
+- The OpenClaw community-plugin PR can still be merged independently of this release.
+- `OpenClaw` daily host-native interaction is now considered complete for the current product boundary.
+- CLI remains the explicit operator path for deep inspection, repair, lifecycle control, backup, rollback, and other advanced workflows.