@ngockhoale/ukit 3.0.0 → 3.0.1

package/{templates → template_project}/.gitignore

@@ -49,9 +49,9 @@ Thumbs.db
 # legacy: Antigravity adapter removed in v2.2.0; leftovers must stay ignored
 .antigravity/
 # NOTE (C12): runtime dirs (.claude/ .codex/ .omp/ .ukit/) are deliberately NOT
-# ignored here. This file is a per-directory .gitignore for templates/, so an
+# ignored here. This file is a per-directory .gitignore for template_project/, so an
 # unanchored `.claude/` silently hid NEW template files (it swallowed
-# templates/.claude/ukit/index/task-budget-validator.mjs). The root .gitignore
+# template_project/.claude/ukit/index/task-budget-validator.mjs). The root .gitignore
 # already carries the anchored /.claude/ /.codex/ /.omp/ /.ukit/ exclusions.
 opencode.json
 /AGENTS.md

package/{templates → template_project}/.omp/RULES.md

@@ -1,5 +1,5 @@
 # .omp/RULES.md — sticky always-apply rules
-<!-- generated: templates/instructions/ — edit sources, then yarn docs:render -->
+<!-- generated: template_project/instructions/ — edit sources, then yarn docs:render -->
 
 omp re-attaches this file near every turn from its native location (`.omp/RULES.md` only, never a
 copy elsewhere). It carries the always-apply subset of root `AGENTS.md` that must survive even when

package/{templates → template_project}/.omp/agents/handoff-planner.md

@@ -75,7 +75,7 @@ verification — link both files' `## Discussion` threads.
 
 ## Phase 0.5 — Write SPEC.md
 
-Write `docs/AI_HANDOFF/SPEC.md` from the template at `templates/docs/AI_HANDOFF/SPEC.md`
+Write `docs/AI_HANDOFF/SPEC.md` from the template at `template_project/docs/AI_HANDOFF/SPEC.md`
 (15 sections). The spec is the contract executors implement against — concrete enough that
 nothing is guessed: exact paths, module and API names, schemas, validation rules,
 permissions, empty/error states, migration behavior, test expectations. Every section is
@@ -134,7 +134,7 @@ Use `_TEMPLATE.md` structure (from pre-read context or file).
 | Dependencies | `TASK-xxx` or `none` — wave order is inferred from this |
 | Test Cases | Type \| Test Name \| Expected — ≥1 happy + ≥2 edge cases of different kinds |
 | Test Files | Exact test file paths to create/modify |
-| Verification Commands | Runnable shell commands — MUST include the project's lint/typecheck command if one exists (see §5 rule above). Apply the "Test selection" resolution order from docs/AI_HANDOFF/RULES.md: `src/`/`scripts/` targets → the `tests` array in `.cache/index/tests-map.json`; `templates/.claude/**`/`.claude/**` targets → path convention (hooks → `tests/hooks/` + `tests/handoff/cycle*/`; manifest/settings → `tests/manifest/`; runtime `.mjs` mirrors → `tests/core/*Parity*` + `tests/index/`); if both resolve to fewer than one test file the task MUST fall back to `yarn test:release-core` — never the full suite by default, never an empty selection |
+| Verification Commands | Runnable shell commands — MUST include the project's lint/typecheck command if one exists (see §5 rule above). Apply the "Test selection" resolution order from docs/AI_HANDOFF/RULES.md: `src/`/`scripts/` targets → the `tests` array in `.cache/index/tests-map.json`; `template_project/.claude/**`/`.claude/**` targets → path convention (hooks → `tests/hooks/` + `tests/handoff/cycle*/`; manifest/settings → `tests/manifest/`; runtime `.mjs` mirrors → `tests/core/*Parity*` + `tests/index/`); if both resolve to fewer than one test file the task MUST fall back to `yarn test:release-core` — never the full suite by default, never an empty selection |
 | Acceptance Criteria | Verifiable checklist |
 
 Missing any field → `needs_breakdown`. Never mark incomplete tasks `ready`.

package/{templates → template_project}/.omp/config.yml

@@ -57,7 +57,7 @@ tools:
     computer: allow
 
 bash:
-  # Translated from templates/.claude/hooks/block-dangerous.sh's DANGEROUS_PATTERNS array.
+  # Translated from template_project/.claude/hooks/block-dangerous.sh's DANGEROUS_PATTERNS array.
   # `deny`/`prompt` fire on the WHOLE command or on ANY compound segment (e.g. `foo && rm -rf /`
   # still hits the `rm -rf /*` entry below) — so a `deny` entry below the trailing allow still
   # catches it. `allow` only ever matches an ENTIRE, non-compound command, so the trailing "*"
@@ -121,9 +121,9 @@ memory:
 # Auto-compact must trigger BEFORE context-hardcap-gate.sh starts blocking tool
 # calls (compact.hardCapTokens, default 500000). Rendered at install time from the
 # same derived number as env.CLAUDE_CODE_AUTO_COMPACT_WINDOW in
-# templates/.claude/settings.json (70% of hardCapTokens), so omp and Claude Code
+# template_project/.claude/settings.json (70% of hardCapTokens), so omp and Claude Code
 # cannot drift apart and retuning both is a single edit to
-# templates/ukit/storage/config.json.
+# template_project/ukit/storage/config.json.
 #
 # Key VERIFIED against omp v17.4.2 (2026-08-22): `compaction.thresholdTokens` is a
 # fixed token limit for context maintenance and overrides the percentage threshold

package/{templates → template_project}/AGENTS.md

@@ -1,5 +1,5 @@
 # AGENTS.md — {{project.name}}
-<!-- generated: templates/instructions/ — edit sources, then yarn docs:render -->
+<!-- generated: template_project/instructions/ — edit sources, then yarn docs:render -->
 
 ## Core Rule
 <!-- RULES: CORE-01 CORE-02 -->
@@ -64,7 +64,7 @@
 - Missing/corrupt runtime or stale workspace → rerun `ukit install`.
 
 ## Skill Quality (maintainer-only)
-- Editing `templates/.claude/` skills/agents → read `.claude/skills/skill-quality/SKILL.md` first.
+- Editing `template_project/.claude/` skills/agents → read `.claude/skills/skill-quality/SKILL.md` first.
 
 ## UKit v{{ukit.version}} Shared Runtime
 - Runtime state: `.ukit/storage/`; `config.json` holds toggles (compact, token pipeline, router, memory, validation, Safe Patch). `ukit memory recall "<task>"` before asking users to restate decisions; `learn`/`promote`/`episode` manage memory; inspect via `ukit status` / `ukit memory export`. Route memory: `.claude/ukit/skill-router-state.json` (`previous-context`/`recent-output` first); cache: `.ukit/storage/cache/output-history.json` + `retriever-lanes.jsonl` + `tee/`. Hooks degrade to exit 0; missing/corrupt runtime → rerun `ukit install`.

package/{templates → template_project}/CLAUDE.md

@@ -1,5 +1,5 @@
 # CLAUDE.md — {{project.name}}
-<!-- generated: templates/instructions/ — edit sources, then yarn docs:render -->
+<!-- generated: template_project/instructions/ — edit sources, then yarn docs:render -->
 
 ## Core Rule
 <!-- RULES: CORE-01 CORE-02 -->
@@ -64,7 +64,7 @@
 - Missing/corrupt runtime or stale workspace → rerun `ukit install`.
 
 ## Skill Quality (maintainer-only)
-- Editing `templates/.claude/` skills/agents → read `.claude/skills/skill-quality/SKILL.md` first.
+- Editing `template_project/.claude/` skills/agents → read `.claude/skills/skill-quality/SKILL.md` first.
 
 ## UKit v{{ukit.version}} Shared Runtime
 - Runtime state: `.ukit/storage/`; `config.json` holds toggles (compact, token pipeline, router, memory, validation, Safe Patch). `ukit memory recall "<task>"` before asking users to restate decisions; `learn`/`promote`/`episode` manage memory; inspect via `ukit status` / `ukit memory export`. Route memory: `.claude/ukit/skill-router-state.json` (`previous-context`/`recent-output` first); cache: `.ukit/storage/cache/output-history.json` + `retriever-lanes.jsonl` + `tee/`. Hooks degrade to exit 0; missing/corrupt runtime → rerun `ukit install`.

package/{templates → template_project}/docs/AI_HANDOFF/RULES.md

@@ -170,7 +170,7 @@ chạy **đến khi không còn gì để làm**:
 Resolution order — exactly three steps, in this order. A task's Verification Commands MUST NOT default to the full suite:
 
 1. Target File under `src/` or `scripts/` → read `.cache/index/tests-map.json` and take the `tests` array for that `sourceFile`.
-2. Target File under `templates/.claude/**` or `.claude/**` → `tests-map.json` has no coverage of these paths, so use the path convention: hooks → `tests/hooks/` + `tests/handoff/cycle*/`; manifest/settings → `tests/manifest/`; runtime `.mjs` mirrors → `tests/core/*Parity*` + `tests/index/`.
+2. Target File under `template_project/.claude/**` or `.claude/**` → `tests-map.json` has no coverage of these paths, so use the path convention: hooks → `tests/hooks/` + `tests/handoff/cycle*/`; manifest/settings → `tests/manifest/`; runtime `.mjs` mirrors → `tests/core/*Parity*` + `tests/index/`.
 3. **Mandatory non-empty floor** — if steps 1–2 resolve to fewer than one test file, the task MUST fall back to `yarn test:release-core`. An empty selection is never permitted. This floor is a fallback for a single task's narrowed selection, not a default — most tasks resolve via steps 1–2 and never reach it.
 
 **Wave/cycle boundary regression net** — the three steps above narrow one task's Verification Commands only; they are not a substitute for full-suite coverage. A full `yarn test` run at each wave/cycle boundary MUST happen and is the regression net for every per-task narrowed selection made under this policy. `code-reviewer.md`'s "wave-boundary full `yarn test` ... is the regression net" sentence refers to this paragraph.

package/{templates → template_project}/docs/UKIT_INTERNALS.md

@@ -58,7 +58,7 @@ the root contract is the only carrier — keep both in sync with
 
 ## Skill Quality (maintainer-only)
 
-- When editing a template skill/agent under `templates/.claude/`, read
+- When editing a template skill/agent under `template_project/.claude/`, read
   `.claude/skills/skill-quality/SKILL.md` before shipping the change.
 
 ## Shared Runtime — detail
@@ -289,12 +289,12 @@ Internals: `src/core/permissionPolicy.js` compiles the semantic policy (preceden
   line). To surface diagnostics from an earlier step, have the step that owns the
   verdict include them.
 - The same test also guards the settings↔bridge mirror: `HOOK_EVENT_MAP` in
-  `templates/.omp/hooks/pre/ukit-bridge.js` must equal the settings chain args 1:1
+  `template_project/.omp/hooks/pre/ukit-bridge.js` must equal the settings chain args 1:1
   per event/matcher.
 
 ## Compressed contract detail (cycle 45 diet)
 
-Detail dropped from `templates/instructions/core.md` during the ~25% system-prompt diet; semantics unchanged.
+Detail dropped from `template_project/instructions/core.md` during the ~25% system-prompt diet; semantics unchanged.
 
 - **Prompt Caching one-liners** — CTX-01 deterministic segment bytes · CTX-02 keep roles and order · CTX-03 keep tool IDs and continuation state · CTX-04 no clock/random IDs in static blocks · CTX-05 compaction starts a new epoch · CTX-06 never change data to match a cache · CTX-07 no unconfirmed cache fields · CTX-08 tool-result reuse needs valid freshness · CTX-09 missing usage is unknown, not zero · CTX-10 never cut a required check to reduce calls. Full ruleset: `docs/PROMPT_CACHING.md`.
 - **Common skill triggers** — review/audit/diff/PR → `code-review` · bug/error/crash/triage → `debugging-toolkit` · test/spec/coverage → `testing-quality` · docs/README/changelog/`docs/` edits → `docs-quality` · open-ended/status/continue/queued task → `next-step` · wrap up/`docs/STATUS.md` → `update-status` · auth/security/token/permission/risky → `discover-security` · stale workspace/reinstall/cleanup → `repo-maintenance` (all under `.claude/skills/<name>/SKILL.md`).

package/{templates → template_project}/instructions/core.md

@@ -61,7 +61,7 @@
 - Missing/corrupt runtime or stale workspace → rerun `ukit install`.
 
 ## Skill Quality (maintainer-only)
-- Editing `templates/.claude/` skills/agents → read `.claude/skills/skill-quality/SKILL.md` first.
+- Editing `template_project/.claude/` skills/agents → read `.claude/skills/skill-quality/SKILL.md` first.
 
 ## UKit v{{ukit.version}} Shared Runtime
 - Runtime state: `.ukit/storage/`; `config.json` holds toggles (compact, token pipeline, router, memory, validation, Safe Patch). `ukit memory recall "<task>"` before asking users to restate decisions; `learn`/`promote`/`episode` manage memory; inspect via `ukit status` / `ukit memory export`. Route memory: `.claude/ukit/skill-router-state.json` (`previous-context`/`recent-output` first); cache: `.ukit/storage/cache/output-history.json` + `retriever-lanes.jsonl` + `tee/`. Hooks degrade to exit 0; missing/corrupt runtime → rerun `ukit install`.

package/{templates → template_project}/instructions/layout.yaml

@@ -6,9 +6,9 @@ description: >-
   verbatim with no ## prefix) and `*` (all ## sections of the source in file
   order). Every source ## section must be referenced by ≥1 output (FR-006).
 outputs:
-  - target: templates/CLAUDE.md
+  - target: template_project/CLAUDE.md
     h1: '# CLAUDE.md — {{project.name}}'
-    banner: '<!-- generated: templates/instructions/ — edit sources, then yarn docs:render -->'
+    banner: '<!-- generated: template_project/instructions/ — edit sources, then yarn docs:render -->'
     resolve_vars: false
     sections:
       - { from: core, heading: Core Rule }
@@ -38,9 +38,9 @@ outputs:
       - { from: core, heading: Handoff Fullstack Rules }
       - { from: core, heading: Compact Instructions }
     trailer: '{{codegraphSection}}'
-  - target: templates/AGENTS.md
+  - target: template_project/AGENTS.md
     h1: '# AGENTS.md — {{project.name}}'
-    banner: '<!-- generated: templates/instructions/ — edit sources, then yarn docs:render -->'
+    banner: '<!-- generated: template_project/instructions/ — edit sources, then yarn docs:render -->'
     resolve_vars: false
     sections:
       - { from: core, heading: Core Rule }
@@ -71,16 +71,16 @@ outputs:
       - { from: core, heading: Handoff Fullstack Rules }
       - { from: core, heading: Compact Instructions }
     trailer: '{{codegraphSection}}'
-  - target: templates/.omp/RULES.md
+  - target: template_project/.omp/RULES.md
     h1: '# .omp/RULES.md — sticky always-apply rules'
-    banner: '<!-- generated: templates/instructions/ — edit sources, then yarn docs:render -->'
+    banner: '<!-- generated: template_project/instructions/ — edit sources, then yarn docs:render -->'
     resolve_vars: false
     sections:
       - { from: 'overlay:omp-rules', heading: __preamble__ }
       - { from: 'overlay:omp-rules', heading: '*' }
   - target: CLAUDE.md
     h1: '# CLAUDE.md — @ngockhoale/ukit'
-    banner: '<!-- generated: templates/instructions/ + repo overlay — edit sources, then yarn docs:render -->'
+    banner: '<!-- generated: template_project/instructions/ + repo overlay — edit sources, then yarn docs:render -->'
     resolve_vars: true
     sections:
       - { from: 'overlay:repo', heading: Release Policy (mandatory — never replace) }
@@ -113,7 +113,7 @@ outputs:
     trailer: '{{codegraphSection}}'
   - target: AGENTS.md
     h1: '# AGENTS.md — @ngockhoale/ukit'
-    banner: '<!-- generated: templates/instructions/ + repo overlay — edit sources, then yarn docs:render -->'
+    banner: '<!-- generated: template_project/instructions/ + repo overlay — edit sources, then yarn docs:render -->'
     resolve_vars: true
     sections:
       - { from: 'overlay:repo', heading: Release Policy (mandatory — never replace) }

package/{templates → template_project}/instructions/overlays/claude.md

@@ -1,3 +1,3 @@
 <!-- Claude-only overlay. Intentionally carries no ## sections today: every
-     section of templates/CLAUDE.md is shared core. Kept as a comment-only
+     section of template_project/CLAUDE.md is shared core. Kept as a comment-only
      source so the overlay allowlist mechanism is exercised (SPEC §7.5). -->

package/{templates → template_project}/instructions/overlays/repo.md

@@ -6,4 +6,4 @@
 - **npm and git always hold the same latest version.** After publish, `npm view @ngockhoale/ukit version` must equal the `package.json` version; if they ever diverge, publishing wins and happens first.
 - **Never ask the user for npm publish permission** — approval is permanently granted for this package. Use `npm publish --dry-run` for pre-verification, then run the real publish in the same cycle.
 - Users update with `ukit update`, which pulls from npm — an unpublished fix reaches no one. Git is code history/tracking only; npm is the distribution channel.
-- **Repo-only rule:** this policy applies to the UKit development repo itself and must NEVER be added to `templates/CLAUDE.md` / `templates/AGENTS.md` (it must not ship to installed projects). Mirrored at the top of root CLAUDE.md + AGENTS.md; those copies can be wiped by a `ukit update` run inside this repo — if missing, restore them from this section.
+- **Repo-only rule:** this policy applies to the UKit development repo itself and must NEVER be added to `template_project/CLAUDE.md` / `template_project/AGENTS.md` (it must not ship to installed projects). Mirrored at the top of root CLAUDE.md + AGENTS.md; those copies can be wiped by a `ukit update` run inside this repo — if missing, restore them from this section.

package/{templates → template_project}/ukit/storage/config.json

@@ -84,7 +84,10 @@
     "defaultModel": "claude-sonnet-5"
   },
   "routing": {
-    "routeSchema": { "stage": "off" }
+    "routeSchema": { "stage": "off" },
+    "rigor": { "stage": "off" },
+    "fastPath": { "stage": "off" },
+    "escalation": { "stage": "off" }
   },
   "modelRoles": {
     "code": "code",

package/template_project/ukit/storage/memory/projects/.gitkeep

@@ -0,0 +1,2 @@
+,
+    'template_project/ukit/storage/memory/sessions/.gitkeep': 

package/templates/ukit/storage/memory/projects/.gitkeep

@@ -1,2 +0,0 @@
-,
-    'templates/ukit/storage/memory/sessions/.gitkeep':