@ngockhoale/ukit 2.3.14 → 2.3.17

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (29) hide show
  1. package/CHANGELOG.md +130 -0
  2. package/manifests/platform.full.yaml +26 -1
  3. package/package.json +1 -1
  4. package/src/cli/commands/doctor.js +49 -2
  5. package/src/cli/commands/install.js +5 -0
  6. package/src/core/applyPlan.js +1 -1
  7. package/src/core/diffPlan.js +80 -0
  8. package/src/core/gatewayProbe.js +441 -0
  9. package/src/core/gatewayResilienceEnv.js +292 -0
  10. package/src/core/runInstallPipeline.js +11 -0
  11. package/src/core/taskBudgetValidator.js +241 -0
  12. package/src/core/taskProgressGuard.js +157 -0
  13. package/src/manifest/validateManifest.js +1 -1
  14. package/templates/.claude/agents/feature-implementer.md +30 -0
  15. package/templates/.claude/agents/handoff-planner.md +12 -0
  16. package/templates/.claude/agents/ukit-vision-analyst.md +6 -0
  17. package/templates/.claude/commands/ukit/handoff-fullstack.md +4 -1
  18. package/templates/.claude/hooks/task-watchdog.sh +221 -0
  19. package/templates/.claude/hooks/vision-router.sh +21 -18
  20. package/templates/.claude/settings.json +10 -0
  21. package/templates/.claude/ukit/index/task-budget-validator.mjs +236 -0
  22. package/templates/.claude/ukit/runtime/task-watchdog.mjs +299 -0
  23. package/templates/.gitignore +5 -4
  24. package/templates/.omp/agents/feature-implementer.md +30 -0
  25. package/templates/.omp/agents/handoff-planner.md +12 -0
  26. package/templates/.omp/agents/ukit-vision-analyst.md +17 -13
  27. package/templates/.omp/hooks/pre/ukit-bridge.js +2 -1
  28. package/templates/docs/AI_HANDOFF/tasks/_TEMPLATE.md +17 -0
  29. package/templates/ukit/storage/config.json +8 -1
package/templates/docs/AI_HANDOFF/tasks/_TEMPLATE.md CHANGED
@@ -7,6 +7,7 @@ Mọi AI (planner / executor / reviewer) đọc và ghi vào file NÀY. Không t
7
7
  -->
8
8
 
9
9
  - Status: `ready` <!-- ready | in_progress | pending_review | changes_requested | critical_block | approved | approved_minor | blocked | done -->
10
+ - Size: `M` <!-- S | M | L — runtime budgets key off this field; defaults to M when missing -->
10
11
  - Owner: `-` <!-- tool đang giữ task -->
11
12
  - Reviewer: `-` <!-- model name reviewer dùng, set ở Phase 4 -->
12
13
  - Parent plan: `docs/AI_HANDOFF/PLAN.md` §<section>
@@ -19,6 +20,22 @@ Mọi AI (planner / executor / reviewer) đọc và ghi vào file NÀY. Không t
19
20
 
20
21
  - `<path/to/source.js>` — <what changes>
21
22
 
23
+ ## Progress
24
+
25
+ <!--
26
+ Milestone landing (mandatory): append a Progress entry every `handoff.milestoneIntervalMin`
27
+ (default 5) wall-clock minutes AND at each RED → GREEN → verify milestone. Format is fixed so
28
+ `src/core/taskProgressGuard.js` can audit it:
29
+
30
+ - <ISO-8601 local timestamp, e.g. 2026-09-12T10:30+07:00> · milestone: <name> · last-green: <what passed, e.g. tests/core/x.test.js 6/6> · files: <comma-separated paths> · drift: none|<one line why>
31
+
32
+ Each entry must re-state the files changed since the last entry. If a file appears that is NOT
33
+ under `## Target Files`, the `drift:` field MUST carry a one-line reason — otherwise the guard
34
+ reports `undeclared-drift`. The newest entry (max parsed timestamp) must be within
35
+ `2 × handoff.milestoneIntervalMin` of `now`; one minute beyond → `stale-milestone`.
36
+ A respawned executor reads this section and resumes from the last green milestone.
37
+ -->
38
+
22
39
  ## Test Cases (REQUIRED — TDD)
23
40
 
24
41
  | # | Loại | Tên test | Expected | Pre-state / Fixture |
package/templates/ukit/storage/config.json CHANGED
@@ -240,7 +240,14 @@
240
240
  "approved_minor",
241
241
  "blocked",
242
242
  "done"
243
- ]
243
+ ],
244
+ "taskBudgets": {
245
+ "S": { "softMin": 8, "hardMin": 15 },
246
+ "M": { "softMin": 15, "hardMin": 30 },
247
+ "L": { "softMin": 25, "hardMin": 45 },
248
+ "hardPolicy": "split"
249
+ },
250
+ "milestoneIntervalMin": 5
244
251
  },
245
252
  "subagents": {
246
253
  "enabled": true,