@ngockhoale/ukit 1.4.1 → 1.4.3

package/CHANGELOG.md

@@ -4,6 +4,32 @@ All notable changes to UKit are documented here.
 
 ## Unreleased
 
+### Changed
+
+- Prepared the next local patch bump to `1.4.3`.
+- Tightened execute-first orchestration guidance so one clear safe path runs directly, while real user-choice or risk-confirmation moments still ask.
+- Added compact route-audit coverage and repeated write-lane rescue bias to reduce stop-and-explain loops.
+
+## 1.4.2 - 2026-05-10
+
+### Added
+
+- Added a quality-first internal orchestration ladder with seven execution layers: `tiny-fix`, `local-fix`, `local-build`, `find-cause`, `shared-edit`, `map-impact`, and `review-release`.
+- Added structured route continuity state so installed helpers and hooks can carry `completionState`, `continuationState`, and stuck-lane rescue signals across turns instead of forgetting unfinished execution debt.
+- Added orchestration/runtime config defaults and Codex adapter metadata for the internal advisor/orchestrator contract while keeping the teammate workflow centered on `ukit install`.
+
+### Fixed
+
+- Kept context routing and context-mode hints internal so UKit no longer surfaces `pull-indexed-context`, `resolve-context`, or `mode=LITE/FULL` in the main route prose for ordinary work.
+- Preserved the structured route state (`nextActionType`, `helperHint`, `contextMode`) for internal orchestration, while removing the user/model-facing leakage that was nudging sessions into micro-step stop-and-wait behavior.
+- Hardened implementation routing and installed agent guidance so explicit implement/apply/fix requests keep moving through bounded read → edit → verify flow instead of stopping after read-only inspection.
+- Escalated repeated unfinished returns with `repeatCount`, `stuckRisk`, and `rescueMode` so UKit can rescue a stuck lane instead of quietly looping the same partial milestone.
+- Fixed the installed `route-task` continuation handoff so previous route summaries are carried through correctly during rescue escalation.
+
+### Tests
+
+- Added/updated route, hook, reinject, install-pipeline, and package-artifact coverage for internal helper hiding, continuation rescue escalation, and the expanded orchestration contract.
+
 ## 1.4.1 - 2026-05-09
 
 - Completed cleanup and 1.4.1 template alignment.

package/package.json

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

package/src/core/runtimeConfig.js

@@ -49,7 +49,7 @@ export function buildDefaultRuntimeConfig(overrides = {}) {
   const safeOverrides = isPlainObject(overrides) ? overrides : {};
 
   return mergeObjects({
-    version: '1.4.1',
+    version: '1.4.3',
     agent: 'claude-code',
     autonomy: {
       level: 'balanced',
@@ -112,6 +112,59 @@ export function buildDefaultRuntimeConfig(overrides = {}) {
       advisorEnabled: true,
       maxAdvisorCalls: 3,
     },
+    orchestration: {
+      enabled: true,
+      orchestratorModel: 'claude-sonnet-4-6',
+      advisorEnabled: true,
+      contracts: {
+        'tiny-fix': {
+          maxReadPasses: 0,
+          maxContextPulls: 0,
+          verificationPolicy: 'minimal-or-targeted',
+          completionRule: 'never-claim-done-without-write',
+          delegationPolicy: 'disallow',
+        },
+        'local-fix': {
+          maxReadPasses: 1,
+          maxContextPulls: 1,
+          verificationPolicy: 'targeted-if-covered',
+          completionRule: 'require-write',
+          delegationPolicy: 'disallow',
+        },
+        'local-build': {
+          maxReadPasses: 2,
+          maxContextPulls: 1,
+          verificationPolicy: 'targeted-if-covered',
+          completionRule: 'require-write',
+          delegationPolicy: 'disallow-by-default',
+        },
+        'find-cause': {
+          maxReadPassesBeforeReassess: 3,
+          verificationPolicy: 'root-cause-then-targeted',
+          completionRule: 'never-claim-fixed-without-write-and-verification',
+          delegationPolicy: 'allow-specialized-debug-lane',
+        },
+        'shared-edit': {
+          maxReadPasses: 2,
+          maxContextPulls: 2,
+          verificationPolicy: 'targeted-then-widen-on-risk',
+          completionRule: 'require-write-and-verification',
+          delegationPolicy: 'allow-qualified-sidecar',
+        },
+        'map-impact': {
+          maxReadPasses: 3,
+          maxContextPulls: 3,
+          verificationPolicy: 'impact-first-then-targeted-then-widen-on-risk',
+          completionRule: 'require-impact-evidence-before-edit-claim',
+          delegationPolicy: 'allow-impact-sidecar',
+        },
+        'review-release': {
+          verificationPolicy: 'evidence-first',
+          completionRule: 'report-findings-not-implementation',
+          delegationPolicy: 'allow-review-sidecar',
+        },
+      },
+    },
     memory: {
       enabled: true,
       autoCapture: true,
@@ -278,6 +331,17 @@ export function validateRuntimeConfig(config) {
     pushPositiveNumberError(errors, config.router.maxAdvisorCalls, 'router.maxAdvisorCalls');
   }
 
+  if (!isPlainObject(config.orchestration)) {
+    errors.push('orchestration must be an object.');
+  } else {
+    pushBooleanError(errors, config.orchestration.enabled, 'orchestration.enabled');
+    pushNonEmptyStringError(errors, config.orchestration.orchestratorModel, 'orchestration.orchestratorModel');
+    pushBooleanError(errors, config.orchestration.advisorEnabled, 'orchestration.advisorEnabled');
+    if (!isPlainObject(config.orchestration.contracts)) {
+      errors.push('orchestration.contracts must be an object.');
+    }
+  }
+
   if (!isPlainObject(config.memory)) {
     errors.push('memory must be an object.');
   } else {