@ngockhoale/ukit 1.6.8 → 2.0.2

package/templates/.claude/ukit/runtime/reinject-context.mjs

@@ -14,6 +14,8 @@ import {
 import {
   buildThresholdCompactPlan,
   readCompactPressureState,
+  resetCompactPressureState,
+  writeCompactPressureState,
   writeThresholdCompactPlan,
 } from './compact-threshold.mjs';
 
@@ -62,6 +64,14 @@ async function main() {
   const rawBodyLines = [...rawStaticLines, ...dynamicLines];
   const bodyLines = [...staticLines, ...dynamicLines];
   const pressureState = await readCompactPressureState(projectRoot, config);
+
+  // Reset the hard-cap tracker as early as possible: this hook fires on every real
+  // compaction, and it is the only signal that context actually shrank. It must happen
+  // before the promptCache early-return below, otherwise a cache hit would skip it and
+  // leave context-hardcap-gate.sh permanently tripped. Downstream writes
+  // (writeThresholdCompactPlan) re-read from disk, so they build on the zeroed state and
+  // keep their own stats increments intact.
+  await writeCompactPressureState(projectRoot, resetCompactPressureState(pressureState, config), config);
   const anchorLines = dynamicLines.filter((line) => (
     line.startsWith('- Recent routed lane:')
     || line.startsWith('- Current approach:')
@@ -93,7 +103,10 @@ async function main() {
     activeSkills: Array.isArray(state?.activeSkills) ? state.activeSkills.map((item) => getActiveSkillPath(item)) : [],
     bodyLines: thresholdPlan.active ? thresholdPlan.lines : bodyLines,
     thresholdPhase: thresholdPlan.active ? thresholdPlan.phase : 'monitor',
-    estimatedTotalTokens: thresholdPlan.active ? thresholdPlan.estimatedTotalTokens : pressureState.estimatedTotalTokens,
+    // Only key on the token count when the threshold plan is active — that is the only case
+    // where it changes the rendered output. Keying on the live pressure value while inactive
+    // would miss the cache on every run, since the reset above zeroes it between runs.
+    estimatedTotalTokens: thresholdPlan.active ? thresholdPlan.estimatedTotalTokens : 0,
   });
 
   if (config.tokenPipeline?.promptCache) {

package/templates/CLAUDE.md

@@ -66,6 +66,10 @@ For clearly non-code specialist lanes (docs-only, status, task queue), skip the
 - **Do not ask normal contributors to run internal helper commands**; run them yourself or tell them to rerun `ukit install`.
 - Do not ask normal contributors to memorize `ukit doctor`, `ukit diff`, `ukit uninstall`, or `ukit index ...` unless they explicitly need maintainer/debug help.
 
+## Skill Quality (maintainer-only)
+
+- When editing a template skill/agent under `templates/.claude/`, read `.claude/skills/skill-quality/SKILL.md` before shipping the change.
+
 ## UKit v{{ukit.version}} Shared Runtime
 
 - Shared runtime state lives in `.ukit/storage/`.

package/templates/ukit/storage/config.json

@@ -9,6 +9,8 @@
   "compact": {
     "enabled": true,
     "tokenThreshold": 50000,
+    "hardCapTokens": 220000,
+    "hardCapBlock": true,
     "contextRotDetection": true,
     "askBeforeDrop": true,
     "codexContext": {
@@ -367,6 +369,8 @@
     "compact": {
       "enabled": "Bật/tắt toàn bộ helper compact của UKit.",
       "tokenThreshold": "Ngưỡng token chung cho runtime compact dùng chung.",
+      "hardCapTokens": "Ngưỡng cứng tuyệt đối (mặc định 220000 token ước lượng). Chạm/vượt ngưỡng này thì context coi như quá dài — không phải gợi ý nữa, là bắt buộc.",
+      "hardCapBlock": "Nếu true, hook context-hardcap-gate chặn cứng Edit/Write/Bash (exit 2) khi vượt hardCapTokens, cho tới khi có compact thật (PreCompact) reset lại bộ đếm. Không có ngoại lệ.",
       "contextRotDetection": "Phát hiện context quá dài/dễ mục để giữ lại state quan trọng trước khi AI nhớ sai.",
       "askBeforeDrop": "Giữ thái độ thận trọng trước khi bỏ context quan trọng. Nếu rủi ro thì hand back cho main model.",
       "agentContext": {

package/src/core/memory/index.js

@@ -1,2 +0,0 @@
-export { detectConflict, runHygiene } from './hygiene.js';
-export { expand, getContextInjection, search } from './retrieval.js';

package/src/core/router/index.js

@@ -1,2 +0,0 @@
-export { askAdvisor, shouldEscalate } from './advisor.js';
-export { classifyTask, detectComplexity, selectModel } from './router.js';

package/src/core/validation/index.js

@@ -1,2 +0,0 @@
-export { scoreConfidence } from './confidence.js';
-export { validateOutput } from './validator.js';