@dzhechkov/keysarium-core 1.1.0 → 1.1.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dzhechko
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/memory/dream-engine.md

@@ -55,7 +55,7 @@ The `{insights-root}` defaults to `.keysarium/insights/` but can be configured.
 2. Read reward-summary.json and domain-patterns.json if they exist.
 3. Scan all reward record files recursively.
 4. Exclude expired records.
-5. Sort by reward DESC, then timestamp DESC.
+5. Sort by reward DESC, then usage_count DESC, then timestamp DESC. Records with higher usage_count carry more weight in concept graph construction.
 6. Take top 200 records.
 7. If fewer than 5 valid records, exit with status `insufficient_data`.
 

package/memory/memory-protocol.md

@@ -80,7 +80,7 @@ Call at the **start** of each pipeline stage to load relevant historical pattern
 4. **Filter expired:** Exclude records where `expires_at < current_date`.
 5. **Archive old records (v1.1):** If tier config is present, check record ages. Move records older than `tier_cold_days` to `{memory-root}/{domain}/_archive/{slug}/` in compressed format (see Record Lifecycle). Update `index.json`.
 6. **Purge ancient records (v1.1):** Delete records from `_archive/` older than `tier_cold_days * 2` (default 360 days). Update `index.json`. In v1.0 mode, delete records where `expires_at < current_date`.
-7. **Sort:** By `reward` DESC, then `timestamp` DESC.
+7. **Sort:** By `reward` DESC, then `usage_count` DESC, then `timestamp` DESC. Records with higher usage_count are more battle-tested and should be preferred when rewards are equal.
 8. **Limit:** Return top `max_results_per_query` records (default 10). HOT and WARM records are preferred; COLD records are included only if result count < limit.
 9. **Enrich:** Also load `{memory-root}/_patterns/domain-patterns.json` for matching domain patterns.
 
@@ -118,6 +118,7 @@ Call at the **start** of each pipeline stage to load relevant historical pattern
 2. If `records` is non-empty, review the top 3 records for relevant approaches
 3. If `patterns` is non-empty, apply actionable advice to current stage execution
 4. If both are empty (first run), proceed normally
+5. **Increment usage_count:** For each record actually applied (top 3), increment `usage_count` in both the record file and the index entry. Records with higher usage_count are more proven — prioritize them in future queries.
 
 ## Protocol: memory_store(result, reward)
 
@@ -160,7 +161,7 @@ Call at each **checkpoint** after the human responds, to persist the stage outco
 4. **Generate filename:** `{stage}_{ISO-timestamp}.json`.
 5. **Write file:** Write JSON to `{memory-root}/{domain}/{slug}/{filename}`.
 6. **Update index (v1.1):** If `{memory-root}/index.json` exists (or tier config is present), update it:
-   - Add record entry to `records` map with key = record id, value = `{domain, stage, slug, reward, skill, tier: "hot", file, expires_at}`
+   - Add record entry to `records` map with key = record id, value = `{domain, stage, slug, reward, skill, tier: "hot", usage_count: 0, file, expires_at}`
    - Increment `record_count`
    - Update `by_domain`, `by_phase`, `by_skill` aggregates (count, avg_reward)
    - Set `last_updated` to current timestamp
@@ -185,6 +186,7 @@ Call at each **checkpoint** after the human responds, to persist the stage outco
   "context": { ... },
   "outcome": { ... },
   "promise_tag": "{PROMISE_TAG}",
+  "usage_count": 0,
   "expires_at": "ISO-8601"
 }
 ```
@@ -259,6 +261,7 @@ The index file provides a compact catalog of all records, enabling targeted file
       "reward": 0.7,
       "skill": "{skill-name}",
       "tier": "hot|warm|cold",
+      "usage_count": 0,
       "file": "{domain}/{slug}/{stage}_{timestamp}.json",
       "expires_at": "ISO-8601"
     }
@@ -446,6 +449,7 @@ Records transition through tiers based on age, trading detail for storage effici
   "reward_label": "good",
   "skill_used": "{skill}",
   "promise_tag": "{PROMISE_TAG}",
+  "usage_count": 0,
   "summary": "{first 200 chars of reward_reason + checkpoint_response}",
   "archived_at": "ISO-8601",
   "original_timestamp": "ISO-8601"

package/memory/reward-tracker.md

@@ -82,12 +82,14 @@ Group records by `skill_used` and cross-reference with domain:
   "{skill-name}": {
     "overall_avg": 0.74,
     "total_runs": 15,
+    "total_usage_count": 42,
     "by_domain": {
-      "{domain-a}": { "avg": 0.65, "runs": 8 },
-      "{domain-b}": { "avg": 0.85, "runs": 7 }
+      "{domain-a}": { "avg": 0.65, "runs": 8, "usage_count": 18 },
+      "{domain-b}": { "avg": 0.85, "runs": 7, "usage_count": 24 }
     },
     "best_domain": "{domain}",
-    "worst_domain": "{domain}"
+    "worst_domain": "{domain}",
+    "most_reused_domain": "{domain}"
   }
 }
 ```
@@ -106,6 +108,7 @@ Analyze accumulated data to detect actionable patterns.
 | Improving Trend | Trend = "improving" for stage in domain | "{stage} quality is improving in {domain}" |
 | Degrading Trend | Trend = "degrading" for stage in domain | "{stage} quality is degrading in {domain} -- investigate" |
 | Time Overhead | Stage avg iterations > 2.0 in domain | "{domain} projects require more iterations in {stage}" |
+| High Reuse | Record usage_count >= 5 | "Pattern from {slug}/{stage} is highly reused ({count} times) — consider promoting to a rule" |
 
 **Confidence Calculation:**
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dzhechkov/keysarium-core",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "description": "Core framework for multi-agent pipelines: governance, memory, orchestration, verification, trust tiers, and multi-platform support",
   "main": "index.md",
   "files": [
@@ -34,11 +34,14 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/dzhechko/product-keysarium-2026",
-    "directory": "packages/dz-keysarium-core"
+    "url": "https://github.com/djd1m/dz-harness-hub.git",
+    "directory": "packages/@dzhechkov/keysarium-core"
   },
-  "homepage": "https://github.com/dzhechko/product-keysarium-2026#keysarium-core",
+  "homepage": "https://github.com/djd1m/dz-harness-hub/tree/main/packages/@dzhechkov/keysarium-core#readme",
   "bugs": {
     "url": "https://github.com/dzhechko/product-keysarium-2026/issues"
+  },
+  "publishConfig": {
+    "access": "public"
   }
-}
+}