@ngockhoale/ukit 1.5.23 → 1.6.0

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 All notable changes to UKit are documented here.
 
+## 1.5.24 - 2026-06-10
+
+### Fixed
+
+- Register `command-handoff-fullstack` in `manifests/platform.full.yaml` so `ukit install` now copies `handoff-fullstack.md` to target projects. Previously the template existed but was missing from the manifest.
+
 ## 1.5.23 - 2026-06-10
 
 ### Added

package/manifests/platform.full.yaml

@@ -879,6 +879,18 @@ items:
     packs:
       - core
 
+  - id: command-handoff-fullstack
+    type: command
+    sourceTemplate: .claude/commands/ukit/handoff-fullstack.md
+    targetPath: .claude/commands/ukit/handoff-fullstack.md
+    requires:
+      - command-handoff-create
+    mergeStrategy: overwrite_with_backup
+    variables: []
+    enabledByDefault: true
+    packs:
+      - core
+
   - id: provider-compat-config
     type: config
     sourceTemplate: .claude/config/providers.md

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ngockhoale/ukit",
-  "version": "1.5.23",
+  "version": "1.6.0",
   "description": "Install/update an index-first AI workspace for Claude Code, Antigravity, OpenAI Codex, and OpenCode.",
   "license": "MIT",
   "type": "module",

package/src/core/compact/threshold.js

@@ -6,8 +6,9 @@ import { compactContextBlock } from './index.js';
 const DEFAULT_MAX_PROMPT_ENTRIES = 12;
 const DEFAULT_MAX_OUTPUT_ENTRIES = 12;
 const DEFAULT_HISTORY_LAYER_COUNT = 2;
-const SOFT_RELEASE_RATIO = 0.9;
+const SOFT_RELEASE_RATIO = 0.6;
 const HARD_RELEASE_RATIO = 0.92;
+const COMPACT_RELEASE_TARGET = 30_000;
 const PHASE_COOLDOWN_MS = {
   soft: 5 * 60 * 1000,
   hard: 10 * 60 * 1000,
@@ -414,15 +415,20 @@ function computeEstimatedTotalTokens({
   recentOutputs = [],
   estimatedContextTokens = 0,
   baselineTokens = 0,
+  sessionTokens = 0,
 }) {
   const promptTokens = recentPrompts.reduce((sum, entry) => sum + finiteNumber(entry.tokens, 0), 0);
   const outputTokens = recentOutputs.reduce((sum, entry) => sum + finiteNumber(entry.tokensBefore ?? entry.tokens, 0), 0);
-  return baselineTokens + estimatedContextTokens + promptTokens + outputTokens;
+  const windowTokens = promptTokens + outputTokens;
+  // sessionTokens accumulates across all prompts/outputs (beyond the recent window)
+  // include only the excess over the recent window to avoid double-counting
+  const sessionExcess = Math.max(0, finiteNumber(sessionTokens, 0) - windowTokens);
+  return baselineTokens + estimatedContextTokens + windowTokens + sessionExcess;
 }
 
 export function buildCompactThresholds(config = {}) {
-  const softThreshold = Math.max(1, finiteNumber(config?.compact?.tokenThreshold, 100_000));
-  const hardThreshold = Math.max(softThreshold + 1, Math.round(softThreshold * 1.2));
+  const softThreshold = Math.max(1, finiteNumber(config?.compact?.tokenThreshold, 50_000));
+  const hardThreshold = Math.max(softThreshold + 1, Math.round(softThreshold * 1.6));
   const baselineTokens = Math.max(120, Math.min(18_000, Math.round(softThreshold * 0.18)));
 
   return {
@@ -551,7 +557,7 @@ export function buildCompactPressureState(rawState = null, config = {}) {
     thresholds.softThreshold = rawSoftThreshold;
     thresholds.hardThreshold = rawHardThreshold > rawSoftThreshold
       ? rawHardThreshold
-      : Math.max(rawSoftThreshold + 1, Math.round(rawSoftThreshold * 1.2));
+      : Math.max(rawSoftThreshold + 1, Math.round(rawSoftThreshold * 1.6));
     thresholds.baselineTokens = Math.max(120, Math.min(18_000, Math.round(thresholds.softThreshold * 0.18)));
   }
   const recentPrompts = (Array.isArray(rawState?.recentPrompts) ? rawState.recentPrompts : [])
@@ -565,6 +571,7 @@ export function buildCompactPressureState(rawState = null, config = {}) {
     .sort((left, right) => (right.timestamp ?? 0) - (left.timestamp ?? 0))
     .slice(0, DEFAULT_MAX_OUTPUT_ENTRIES);
   const estimatedContextTokens = computeEstimatedContextTokens(rawState);
+  const sessionTokens = Math.max(0, finiteNumber(rawState?.sessionTokens, 0));
   const estimatedTotalTokens = finiteNumber(
     rawState?.estimatedTotalTokens,
     computeEstimatedTotalTokens({
@@ -572,6 +579,7 @@ export function buildCompactPressureState(rawState = null, config = {}) {
       recentOutputs,
       estimatedContextTokens,
       baselineTokens: thresholds.baselineTokens,
+      sessionTokens,
     }),
   );
   const releaseThresholds = buildReleaseThresholds(thresholds);
@@ -589,6 +597,7 @@ export function buildCompactPressureState(rawState = null, config = {}) {
     hardReleaseThreshold: releaseThresholds.hardReleaseThreshold,
     baselineTokens: thresholds.baselineTokens,
     estimatedContextTokens,
+    sessionTokens,
     estimatedTotalTokens,
     phase: resolveCompactPhase(estimatedTotalTokens, thresholds, rawState),
     taskMode,
@@ -617,9 +626,10 @@ export function registerPromptPressure(state, {
     return current;
   }
 
+  const promptTokenCount = estimateTokenCount(normalizedPrompt);
   const entry = normalizePromptEntry({
     timestamp,
-    tokens: estimateTokenCount(normalizedPrompt),
+    tokens: promptTokenCount,
     summary: summarizePromptText(normalizedPrompt, routingContext),
     targetFile: routingContext?.targetFile ?? null,
     taskType: routingContext?.taskType ?? null,
@@ -636,6 +646,7 @@ export function registerPromptPressure(state, {
     updatedAt: timestamp,
     routingContext,
     recentPrompts,
+    sessionTokens: current.sessionTokens + promptTokenCount,
     estimatedTotalTokens: undefined,
     estimatedContextTokens: estimateTokenCount([
       routeSummary?.line ?? '',
@@ -666,12 +677,13 @@ export function registerOutputPressure(state, {
     return current;
   }
 
+  const normalizedTokensBefore = Math.max(1, finiteNumber(tokensBefore, estimateTokenCount(summary || normalizedSummary)));
   const entry = normalizeOutputEntry({
     timestamp,
     command,
     profile,
     exitCode,
-    tokensBefore: Math.max(1, finiteNumber(tokensBefore, estimateTokenCount(summary || normalizedSummary))),
+    tokensBefore: normalizedTokensBefore,
     tokensAfter: Math.max(1, finiteNumber(tokensAfter, estimateTokenCount(normalizedSummary))),
     savedTokens: Math.max(0, finiteNumber(savedTokens, 0)),
     summary: normalizedSummary,
@@ -685,6 +697,7 @@ export function registerOutputPressure(state, {
     ...current,
     updatedAt: timestamp,
     recentOutputs,
+    sessionTokens: current.sessionTokens + normalizedTokensBefore,
     estimatedTotalTokens: undefined,
     taskMode: deriveTaskMode({
       routingContext: current.routingContext ?? {},
@@ -755,9 +768,19 @@ export function registerThresholdCompactPlan(state, plan, config = {}) {
     stats.softHits += 1;
   }
 
+  // Decay sessionTokens on hard compact plan: cap at COMPACT_RELEASE_TARGET for large sessions,
+  // or fall back to recent-window tokens when already below the release target
+  const windowTokens = current.recentPrompts.reduce((sum, entry) => sum + finiteNumber(entry.tokens, 0), 0)
+    + current.recentOutputs.reduce((sum, entry) => sum + finiteNumber(entry.tokensBefore ?? entry.tokens, 0), 0);
+  const decayTarget = current.sessionTokens > COMPACT_RELEASE_TARGET ? COMPACT_RELEASE_TARGET : windowTokens;
+  const decayedSessionTokens = normalizePhase(plan.phase) === 'hard'
+    ? Math.min(current.sessionTokens, decayTarget)
+    : current.sessionTokens;
+
   return buildCompactPressureState({
     ...current,
     updatedAt: now,
+    sessionTokens: decayedSessionTokens,
     cooldownUntil: now + resolvePhaseCooldownMs(plan.phase),
     historyLayers: uniqueStrings(plan.layers ?? []).slice(0, DEFAULT_HISTORY_LAYER_COUNT),
     latestPlan: {

package/src/core/runtimeConfig.js

@@ -58,7 +58,7 @@ export function buildDefaultRuntimeConfig(overrides = {}) {
     },
     compact: {
       enabled: true,
-      tokenThreshold: 100_000,
+      tokenThreshold: 50_000,
       contextRotDetection: true,
       askBeforeDrop: true,
       agentContext: {

package/templates/.claude/ukit/runtime/compact-threshold.mjs

@@ -13,8 +13,9 @@ import {
 const DEFAULT_MAX_PROMPT_ENTRIES = 12;
 const DEFAULT_MAX_OUTPUT_ENTRIES = 12;
 const DEFAULT_HISTORY_LAYER_COUNT = 2;
-const SOFT_RELEASE_RATIO = 0.9;
+const SOFT_RELEASE_RATIO = 0.6;
 const HARD_RELEASE_RATIO = 0.92;
+const COMPACT_RELEASE_TARGET = 30_000;
 const PHASE_COOLDOWN_MS = {
   soft: 5 * 60 * 1000,
   hard: 10 * 60 * 1000,
@@ -421,15 +422,20 @@ function computeEstimatedTotalTokens({
   recentOutputs = [],
   estimatedContextTokens = 0,
   baselineTokens = 0,
+  sessionTokens = 0,
 }) {
   const promptTokens = recentPrompts.reduce((sum, entry) => sum + finiteNumber(entry.tokens, 0), 0);
   const outputTokens = recentOutputs.reduce((sum, entry) => sum + finiteNumber(entry.tokensBefore ?? entry.tokens, 0), 0);
-  return baselineTokens + estimatedContextTokens + promptTokens + outputTokens;
+  const windowTokens = promptTokens + outputTokens;
+  // sessionTokens accumulates across all prompts/outputs (beyond the recent window)
+  // include only the excess over the recent window to avoid double-counting
+  const sessionExcess = Math.max(0, finiteNumber(sessionTokens, 0) - windowTokens);
+  return baselineTokens + estimatedContextTokens + windowTokens + sessionExcess;
 }
 
 export function buildCompactThresholds(config = {}) {
-  const softThreshold = Math.max(1, finiteNumber(config?.compact?.tokenThreshold, 100_000));
-  const hardThreshold = Math.max(softThreshold + 1, Math.round(softThreshold * 1.2));
+  const softThreshold = Math.max(1, finiteNumber(config?.compact?.tokenThreshold, 50_000));
+  const hardThreshold = Math.max(softThreshold + 1, Math.round(softThreshold * 1.6));
   const baselineTokens = Math.max(120, Math.min(18_000, Math.round(softThreshold * 0.18)));
 
   return {
@@ -558,7 +564,7 @@ export function buildCompactPressureState(rawState = null, config = {}) {
     thresholds.softThreshold = rawSoftThreshold;
     thresholds.hardThreshold = rawHardThreshold > rawSoftThreshold
       ? rawHardThreshold
-      : Math.max(rawSoftThreshold + 1, Math.round(rawSoftThreshold * 1.2));
+      : Math.max(rawSoftThreshold + 1, Math.round(rawSoftThreshold * 1.6));
     thresholds.baselineTokens = Math.max(120, Math.min(18_000, Math.round(thresholds.softThreshold * 0.18)));
   }
   const recentPrompts = (Array.isArray(rawState?.recentPrompts) ? rawState.recentPrompts : [])
@@ -572,6 +578,7 @@ export function buildCompactPressureState(rawState = null, config = {}) {
     .sort((left, right) => (right.timestamp ?? 0) - (left.timestamp ?? 0))
     .slice(0, DEFAULT_MAX_OUTPUT_ENTRIES);
   const estimatedContextTokens = computeEstimatedContextTokens(rawState);
+  const sessionTokens = Math.max(0, finiteNumber(rawState?.sessionTokens, 0));
   const estimatedTotalTokens = finiteNumber(
     rawState?.estimatedTotalTokens,
     computeEstimatedTotalTokens({
@@ -579,6 +586,7 @@ export function buildCompactPressureState(rawState = null, config = {}) {
       recentOutputs,
       estimatedContextTokens,
       baselineTokens: thresholds.baselineTokens,
+      sessionTokens,
     }),
   );
   const releaseThresholds = buildReleaseThresholds(thresholds);
@@ -596,6 +604,7 @@ export function buildCompactPressureState(rawState = null, config = {}) {
     hardReleaseThreshold: releaseThresholds.hardReleaseThreshold,
     baselineTokens: thresholds.baselineTokens,
     estimatedContextTokens,
+    sessionTokens,
     estimatedTotalTokens,
     phase: resolveCompactPhase(estimatedTotalTokens, thresholds, rawState),
     taskMode,
@@ -624,9 +633,10 @@ export function registerPromptPressure(state, {
     return current;
   }
 
+  const promptTokenCount = estimateTokenCount(normalizedPrompt);
   const entry = normalizePromptEntry({
     timestamp,
-    tokens: estimateTokenCount(normalizedPrompt),
+    tokens: promptTokenCount,
     summary: summarizePromptText(normalizedPrompt, routingContext),
     targetFile: routingContext?.targetFile ?? null,
     taskType: routingContext?.taskType ?? null,
@@ -643,6 +653,7 @@ export function registerPromptPressure(state, {
     updatedAt: timestamp,
     routingContext,
     recentPrompts,
+    sessionTokens: current.sessionTokens + promptTokenCount,
     estimatedTotalTokens: undefined,
     estimatedContextTokens: estimateTokenCount([
       routeSummary?.line ?? '',
@@ -673,12 +684,13 @@ export function registerOutputPressure(state, {
     return current;
   }
 
+  const normalizedTokensBefore = Math.max(1, finiteNumber(tokensBefore, estimateTokenCount(summary || normalizedSummary)));
   const entry = normalizeOutputEntry({
     timestamp,
     command,
     profile,
     exitCode,
-    tokensBefore: Math.max(1, finiteNumber(tokensBefore, estimateTokenCount(summary || normalizedSummary))),
+    tokensBefore: normalizedTokensBefore,
     tokensAfter: Math.max(1, finiteNumber(tokensAfter, estimateTokenCount(normalizedSummary))),
     savedTokens: Math.max(0, finiteNumber(savedTokens, 0)),
     summary: normalizedSummary,
@@ -692,6 +704,7 @@ export function registerOutputPressure(state, {
     ...current,
     updatedAt: timestamp,
     recentOutputs,
+    sessionTokens: current.sessionTokens + normalizedTokensBefore,
     estimatedTotalTokens: undefined,
     taskMode: deriveTaskMode({
       routingContext: current.routingContext ?? {},
@@ -762,9 +775,19 @@ export function registerThresholdCompactPlan(state, plan, config = {}) {
     stats.softHits += 1;
   }
 
+  // Decay sessionTokens on hard compact plan: cap at COMPACT_RELEASE_TARGET for large sessions,
+  // or fall back to recent-window tokens when already below the release target
+  const windowTokens = current.recentPrompts.reduce((sum, entry) => sum + finiteNumber(entry.tokens, 0), 0)
+    + current.recentOutputs.reduce((sum, entry) => sum + finiteNumber(entry.tokensBefore ?? entry.tokens, 0), 0);
+  const decayTarget = current.sessionTokens > COMPACT_RELEASE_TARGET ? COMPACT_RELEASE_TARGET : windowTokens;
+  const decayedSessionTokens = normalizePhase(plan.phase) === 'hard'
+    ? Math.min(current.sessionTokens, decayTarget)
+    : current.sessionTokens;
+
   return buildCompactPressureState({
     ...current,
     updatedAt: now,
+    sessionTokens: decayedSessionTokens,
     cooldownUntil: now + resolvePhaseCooldownMs(plan.phase),
     historyLayers: uniqueStrings(plan.layers ?? []).slice(0, DEFAULT_HISTORY_LAYER_COUNT),
     latestPlan: {

package/templates/ukit/storage/config.json

@@ -8,7 +8,7 @@
   },
   "compact": {
     "enabled": true,
-    "tokenThreshold": 100000,
+    "tokenThreshold": 50000,
     "contextRotDetection": true,
     "askBeforeDrop": true,
     "codexContext": {