@njeybe/nativ 2.5.1 → 2.7.0

package/dist/server/studio-ui/styles/dialogs.js

@@ -2,7 +2,7 @@
 export const dialogsCss = String.raw `/* Toasts */
 /* Bottom-right so notifications never cover the sticky header and navigation. */
 .toast-host { position: fixed; right: 16px; bottom: 16px; z-index: 100; display: flex; flex-direction: column; gap: 8px; width: min(440px, calc(100vw - 32px)); pointer-events: none; }
-.toast { pointer-events: auto; display: flex; gap: 10px; align-items: flex-start; padding: 12px 14px; font-size: 13.5px; background: var(--surface); border: 1px solid var(--border); border-left: 3px solid var(--danger); border-radius: var(--r-card); box-shadow: var(--shadow-float); animation: toast-in .18s ease-out; }
+.toast { pointer-events: auto; display: flex; gap: 10px; align-items: flex-start; padding: 12px 14px; font-size: 13.5px; background: var(--surface); border: 1px solid var(--line-2); border-left: 3px solid var(--danger); border-radius: var(--r-card); box-shadow: var(--shadow); animation: toast-in .18s ease-out; }
 .toast.ok { border-left-color: var(--success); }
 .toast .t-body { flex: 1; min-width: 0; overflow-wrap: anywhere; }
 .toast .t-hint { color: var(--muted); font-size: 12.5px; }
@@ -12,8 +12,8 @@ export const dialogsCss = String.raw `/* Toasts */
 /* Dialogs */
 dialog { border: none; padding: 0; background: transparent; color: var(--text); width: min(640px, calc(100vw - 32px)); max-height: calc(100vh - 32px); }
 dialog.narrow { width: min(460px, calc(100vw - 32px)); }
-dialog::backdrop { background: rgb(10 10 20 / 0.4); backdrop-filter: blur(2px); }
-.modal { padding: 22px; background: var(--surface); border: 1px solid var(--border); border-radius: var(--r-card); box-shadow: var(--shadow-float); }
+dialog::backdrop { background: color-mix(in srgb, var(--text) 40%, transparent); backdrop-filter: blur(2px); }
+.modal { padding: 22px; background: var(--surface); border: 1px solid var(--line-2); border-radius: var(--r-card); box-shadow: var(--shadow); }
 .modal h2 { margin: 0 0 4px; font-size: 18px; font-weight: 600; }
 .modal .lead { color: var(--muted); margin: 0 0 16px; font-size: 14px; line-height: 1.55; }
 .field { margin-bottom: 16px; }
@@ -112,7 +112,7 @@ textarea.cmd-preview { min-height: 92px; font-family: var(--mono); font-size: 12
 .switch-text { display: flex; flex-direction: column; font-size: 13.5px; }
 .switch-text b { font-weight: 600; }
 .switch-text span { font-size: 12.5px; color: var(--muted); }
-kbd { padding: 0 5px; font-family: var(--mono); font-size: 11px; color: var(--muted); background: var(--chip); border: 1px solid var(--chip-border); border-radius: 4px; }
+kbd { padding: 0 5px; font-family: var(--mono); font-size: 11px; color: var(--muted); background: var(--chip); border: 1px solid var(--chip-border); border-radius: var(--r-control); }
 .btn.primary kbd { color: var(--accent-fg); background: transparent; border-color: color-mix(in srgb, var(--accent-fg) 45%, transparent); }
 
 `;

package/dist/server/studio-ui/styles/responsive.js

@@ -1,5 +1,13 @@
 // Responsive rules for the kept pages and dialogs.
 export const responsiveCss = String.raw `/* Responsive */
+@media (max-width: 1023px) and (min-width: 761px) {
+  :root { --sidebar-w: 56px; }
+  .side { padding: 16px 8px; align-items: center; }
+  .brand { padding: 0; justify-content: center; }
+  .brand .wordmark { height: 16px; width: 16px; overflow: hidden; }
+  .brand b, .brand .ver, .nav-glabel, .nav-text, .nav-badge, .side-foot { display: none; }
+  .nav-item { justify-content: center; padding: 6px; width: 40px; }
+}
 @media (max-width: 900px) {
   #runner-console-drawer { inset: auto 0 0 0; }
   .panes { grid-template-columns: 1fr; }

package/dist/server/studio-ui/styles/shell.js

@@ -3,16 +3,17 @@ export const shellCss = String.raw `/* Layout */
 .app { display: grid; grid-template-columns: var(--sidebar-w) minmax(0, 1fr); min-height: 100vh; }
 .side { border-right: 1px solid var(--line); background: var(--surface); padding: 16px 12px; display: flex; flex-direction: column; gap: 20px; position: sticky; top: 0; height: 100vh; overflow-y: auto; }
 .brand { display: flex; align-items: center; gap: 10px; padding: 0 6px; }
-.logo { width: 26px; height: 26px; border-radius: 7px; background: var(--accent); color: var(--accent-fg); display: grid; place-items: center; font-weight: 700; font-size: 14px; flex: none; }
+.wordmark { height: 18px; width: auto; color: var(--fg); display: block; flex: none; }
+.wordmark.is-rail { height: 16px; }
 .brand b { font-weight: 600; white-space: nowrap; }
-.brand .ver { margin-left: auto; font: 11px var(--mono); color: var(--fg-3); overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.side-foot .ver { font: 11px var(--mono); color: var(--fg-3); overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
 .nav { display: flex; flex-direction: column; gap: 14px; }
 .nav-group { display: flex; flex-direction: column; gap: 2px; }
 .nav-glabel { font-size: 11px; letter-spacing: .08em; text-transform: uppercase; color: var(--fg-3); padding: 0 8px 4px; }
 .nav-item { display: flex; align-items: center; gap: 10px; min-height: 32px; padding: 7px 8px; border-radius: 7px; border: 0; background: none; text-align: left; color: var(--fg-2); width: 100%; cursor: pointer; transition: background .15s, color .15s; }
-.nav-item svg { width: 16px; height: 16px; flex: none; }
+.nav-item svg { width: 20px; height: 20px; flex: none; }
 .nav-item:hover { background: var(--surface-2); color: var(--fg); }
-.nav-item[aria-current="page"] { background: var(--accent-soft); color: var(--accent); font-weight: 500; }
+.nav-item[aria-current="page"] { background: var(--accent-soft); color: var(--fg); font-weight: 600; }
 .nav-badge { margin-left: auto; font: 500 11px var(--font); font-variant-numeric: tabular-nums; min-width: 20px; padding: 1px 6px; border-radius: 999px; background: var(--surface-2); color: var(--fg-2); text-align: center; }
 .nav-badge.warn { background: var(--warn-soft); color: var(--warn); }
 .nav-badge.run { background: var(--run-soft); color: var(--run); }
@@ -27,6 +28,24 @@ export const shellCss = String.raw `/* Layout */
 .top-right { margin-left: auto; display: flex; gap: 8px; align-items: center; flex-wrap: wrap; }
 .btn.ghost { background: none; border-color: transparent; color: var(--fg-2); box-shadow: none; }
 .btn.ghost:hover { background: var(--surface-2); }
+#btn-dispatch-next[disabled] { opacity: .55; cursor: not-allowed; }
+.spacer { flex: 1; }
+.ic-sun, .ic-moon { display: inline-flex; }
+.ic-moon { display: none; }
+:root[data-theme="light"] .ic-sun { display: none; }
+:root[data-theme="light"] .ic-moon { display: inline-flex; }
+@media (prefers-color-scheme: light) { :root:not([data-theme="dark"]) .ic-sun { display: none; } :root:not([data-theme="dark"]) .ic-moon { display: inline-flex; } }
+.pulse-strip { min-height: 32px; height: auto; width: auto; border-radius: 0; background: none; box-shadow: none; animation: none; display: flex; flex-wrap: wrap; align-items: center; gap: 0 20px; padding: 0 24px; border-bottom: 1px solid var(--line); font: 12.5px var(--mono); color: var(--fg-2); }
+#pulse .num { font-variant-numeric: tabular-nums; }
+#pulse .pulse-ms { color: var(--fg); padding-right: 20px; border-right: 1px solid var(--line); }
+#pulse .pulse-item { display: inline-flex; align-items: center; gap: 6px; min-height: 32px; padding: 0; border: 0; background: none; font: inherit; cursor: pointer; }
+#pulse .pulse-item.zero, #pulse .pulse-note.loading { color: var(--fg-3); }
+#pulse .pulse-item.run { color: var(--run); } #pulse .pulse-item.bad { color: var(--bad); } #pulse .pulse-item.warn, #pulse .pulse-note.offline { color: var(--warn); }
+#pulse .pdot { width: 7px; height: 7px; border-radius: 50%; background: currentColor; }
+#pulse .pulse-item.run .pdot { animation: blink 1.6s infinite; }
+@media (max-width: 1023px) { .pulse-strip { padding-top: 4px; padding-bottom: 4px; gap: 0 16px; } #pulse .pulse-ms { flex-basis: 100%; border-right: 0; padding-right: 0; } }
+.wordmark.is-rail { display: none; }
+@media (max-width: 1023px) { .wordmark { display: none; } .wordmark.is-rail { display: block; } }
 .btn svg { width: 14px; height: 14px; }
 .kbd { font: 11px var(--mono); padding: 0 5px; border: 1px solid var(--line); border-radius: 4px; color: var(--fg-3); }
 .live { display: inline-flex; align-items: center; gap: 6px; font-size: 12.5px; color: var(--fg-2); }
@@ -113,5 +132,5 @@ export const shellCss = String.raw `/* Layout */
   .drawer { width: 100%; }
   #runner-console-drawer { inset: auto 0 0 0; }
 }
-@media (prefers-reduced-motion: reduce) { .pulse, .live-dot.flash { animation: none; } * { transition: none !important; } }
+@media (prefers-reduced-motion: reduce) { .pulse, .live-dot.flash, #pulse .pdot { animation: none !important; } * { transition: none !important; } }
 `;

package/dist/server/studio-ui/styles/strategist.js

@@ -12,30 +12,30 @@ export const strategistCss = String.raw `/* Tier 1 AI Strategist (ui_specs.md §
 .t1-chip-label { color: var(--muted); }
 .t1-caret { color: var(--muted); transition: transform .15s; }
 .t1-chip[aria-expanded="true"] .t1-caret { transform: rotate(180deg); }
-.t1-menu { position: absolute; top: calc(100% + 6px); right: 0; z-index: 30; width: 300px; padding: 12px; font-size: 12.5px; background: var(--surface); border: 1px solid var(--border); border-radius: var(--r-card); box-shadow: var(--shadow-float); }
+.t1-menu { position: absolute; top: calc(100% + 6px); right: 0; z-index: 30; width: 300px; padding: 12px; font-size: 12.5px; background: var(--surface); border: 1px solid var(--line-2); border-radius: var(--r-card); box-shadow: var(--shadow); }
 .t1-menu:focus-visible { outline: 2px solid var(--primary); outline-offset: 2px; }
 .t1-row { display: flex; align-items: center; justify-content: space-between; gap: 8px; min-height: 28px; color: var(--muted); }
 .t1-row b, .t1-row code { color: var(--text); font-weight: 500; font-variant-numeric: tabular-nums; }
 .t1-row code { font-family: var(--mono); font-size: 12px; }
-.t1-switch { position: relative; width: 54px; height: 24px; padding: 0 8px; font: 600 10.5px/22px var(--mono); color: var(--muted); text-align: right; background: var(--chip); border: 1px solid var(--chip-border); border-radius: 12px; cursor: pointer; transition: background .15s, border-color .15s; }
+.t1-switch { position: relative; width: 54px; height: 24px; padding: 0 8px; font: 600 10.5px/22px var(--mono); color: var(--muted); text-align: right; background: var(--chip); border: 1px solid var(--chip-border); border-radius: var(--r-control); cursor: pointer; transition: background .15s, border-color .15s; }
 .t1-switch::before { content: ""; position: absolute; top: 3px; left: 3px; width: 16px; height: 16px; border-radius: 50%; background: var(--surface); box-shadow: var(--shadow); transition: transform .15s; }
-.t1-switch[aria-checked="true"] { color: #fff; text-align: left; background: var(--success); border-color: var(--success); }
+.t1-switch[aria-checked="true"] { color: var(--accent-fg); text-align: left; background: var(--success); border-color: var(--success); }
 .t1-switch[aria-checked="true"]::before { transform: translateX(30px); }
 .t1-switch:disabled { opacity: .5; cursor: not-allowed; }
 .t1-policy { display: flex; gap: 6px; margin: 8px 0; padding: 8px; line-height: 1.45; color: var(--muted); background: var(--bg); border: 1px solid var(--border); border-radius: var(--r-control); }
 .t1-policy .icon { flex: none; margin-top: 1px; color: var(--success); }
 .t1-stats { display: grid; grid-template-columns: repeat(3, minmax(0, 1fr)); gap: 6px; margin: 0; }
-.t1-stats div { min-width: 0; padding: 6px 8px; border: 1px solid var(--border); border-radius: var(--r-control); }
+.t1-stats div { min-width: 0; padding: 6px 8px; border: 0; border-left: 1px solid var(--line); border-radius: 0; font-variant-numeric: tabular-nums; }
 .t1-stats dt { font-size: 11px; color: var(--muted); }
 .t1-stats dd { margin: 2px 0 0; font: 600 15px/1.2 var(--mono); font-variant-numeric: tabular-nums; color: var(--text); }
 .t1-strip { display: flex; align-items: center; justify-content: space-between; gap: 10px; flex-wrap: wrap; margin: 0 0 10px; padding: 8px 10px; color: var(--term-muted); border: 1px solid var(--term-line); border-radius: var(--r-control); }
 .t1-strip > span { display: inline-flex; align-items: center; gap: 6px; }
 .t1-strip strong { color: var(--term-text); font-weight: 600; }
 .t1-strip.is-triaging { border-color: color-mix(in srgb, var(--active) 60%, transparent); background: color-mix(in srgb, var(--active) 14%, transparent); }
-.rc-btn.t1-run { color: #fff; background: var(--active); border-color: var(--active); }
-.rc-btn.t1-run:hover:not(:disabled) { background: color-mix(in srgb, var(--active) 88%, #000); }
+.rc-btn.t1-run { color: var(--accent-fg); background: var(--active); border-color: var(--active); }
+.rc-btn.t1-run:hover:not(:disabled) { background: color-mix(in srgb, var(--active) 88%, var(--text)); }
 .t1-banner { display: flex; align-items: center; gap: 8px; margin: 0 0 10px; padding: 8px 10px; font-weight: 600; border-radius: var(--r-control); }
-.t1-banner.is-resolved { color: #fff; background: var(--success); }
+.t1-banner.is-resolved { color: var(--accent-fg); background: var(--success); }
 .t1-banner.is-safe { color: var(--ok); border: 1px solid color-mix(in srgb, var(--ok) 45%, transparent); }
 .t1-card { margin: 0 0 12px; padding: 12px 12px 12px 16px; border: 1px solid var(--term-line); border-left: 4px solid var(--proposal); border-radius: var(--r-card); }
 .t1-card-head { display: flex; align-items: center; gap: 8px; flex-wrap: wrap; margin-bottom: 10px; }
@@ -53,10 +53,10 @@ export const strategistCss = String.raw `/* Tier 1 AI Strategist (ui_specs.md §
 .t1-opt:hover { border-color: var(--term-text); }
 .t1-opt.is-recommended { background: var(--primary); border-color: var(--primary); }
 .t1-opt.is-recommended:hover { background: var(--primary-hover); border-color: var(--primary-hover); }
-.t1-opt.is-recommended span { color: color-mix(in srgb, #fff 82%, var(--primary)); }
+.t1-opt.is-recommended span { color: color-mix(in srgb, var(--accent-fg) 82%, var(--primary)); }
 .t1-opt[aria-checked="true"] { box-shadow: 0 0 0 2px var(--term-bg), 0 0 0 4px var(--proposal); }
 .t1-custom { display: flex; flex-direction: column; gap: 4px; margin-top: 8px; font-size: 12px; color: var(--term-muted); }
-.t1-custom textarea { width: 100%; box-sizing: border-box; min-height: 52px; padding: 6px 8px; font: 12.5px/1.45 var(--font); color: var(--term-text); background: rgb(148 163 184 / 0.08); border: 1px solid var(--term-line); border-radius: var(--r-control); resize: vertical; }
+.t1-custom textarea { width: 100%; box-sizing: border-box; min-height: 52px; padding: 6px 8px; font: 12.5px/1.45 var(--font); color: var(--term-text); background: color-mix(in srgb, var(--term-text) 8%, transparent); border: 1px solid var(--term-line); border-radius: var(--r-control); resize: vertical; }
 .t1-custom textarea:focus-visible { outline: 2px solid var(--primary); outline-offset: 1px; }
 .t1-decided { margin: 8px 0 0; font-size: 12px; color: var(--term-muted); }
 @media (prefers-reduced-motion: reduce) { .t1-chip[data-state="triaging"] .t1-spark { animation: none; } }
@@ -65,7 +65,7 @@ export const strategistCss = String.raw `/* Tier 1 AI Strategist (ui_specs.md §
   .t1-menu { position: fixed; top: 56px; left: 16px; right: 16px; width: auto; }
 }
 .df-add { display: block; color: var(--ok); background: color-mix(in srgb, var(--ok) 12%, transparent); }
-.df-del { display: block; color: color-mix(in srgb, var(--danger) 55%, #fff); background: color-mix(in srgb, var(--danger) 14%, transparent); }
+.df-del { display: block; color: color-mix(in srgb, var(--danger) 55%, var(--accent-fg)); background: color-mix(in srgb, var(--danger) 14%, transparent); }
 .df-hunk { display: block; color: var(--accent); }
 .df-file { display: block; margin-top: 8px; font-weight: 700; color: var(--term-text); }
 .df-meta { display: block; color: var(--term-muted); }

package/dist/server/studio-ui/styles/tokens-base.js

@@ -1,26 +1,26 @@
 // Design tokens (light, dark, old-name aliases), base rules and shared legacy components.
-const DARK = `--bg: #0e0e13; --surface: #16161d; --surface-2: #1d1d26; --line: #2a2a36; --line-2: #383847;
-  --fg: #ececf2; --fg-2: #a4a4b7; --fg-3: #6e6e82;
-  --accent: #8e8aff; --accent-soft: #23224a; --accent-fg: #0e0e13;
-  --ok: #4ade80; --ok-soft: #13281b; --run: #60a5fa; --run-soft: #142238;
-  --bad: #f87171; --bad-soft: #341617; --warn: #fbbf24; --warn-soft: #2f2410;
-  --ag-backend: #38bdf8; --ag-frontend: #a78bfa; --ag-qa: #fbbf24; --ag-flutter: #2dd4bf;
-  --ag-architect: #8e8aff; --ag-devops: #94a3b8; --ag-database: #34d399; --ag-security: #f87171;
-  --shadow: 0 1px 2px rgba(0,0,0,.3), 0 6px 20px rgba(0,0,0,.35); color-scheme: dark;`;
+const DARK = `--bg: #0f0f0f; --surface: #1a1a1a; --surface-2: #242424; --line: #303030; --line-2: #3d3d3d;
+  --fg: #ececee; --fg-2: #a1a1aa; --fg-3: #8b8b94;
+  --accent: #ececee; --accent-soft: #1d1d21; --accent-fg: #0f0f0f;
+  --ok: #4ade80; --ok-soft: #12261a; --run: #60a5fa; --run-soft: #121d33;
+  --bad: #f87171; --bad-soft: #2c1414; --warn: #fbbf24; --warn-soft: #2a210b;
+  --ag-backend: var(--fg-3); --ag-frontend: var(--fg-3); --ag-qa: var(--fg-3); --ag-flutter: var(--fg-3);
+  --ag-architect: var(--fg-3); --ag-devops: var(--fg-3); --ag-database: var(--fg-3); --ag-security: var(--fg-3);
+  --shadow: 0 8px 24px color-mix(in srgb, var(--fg) 12%, transparent); color-scheme: dark;`;
 export const tokensBaseCss = String.raw `:root {
-  --bg: #f6f6f9;
-  --surface: #ffffff;
-  --surface-2: #f0f0f5;
-  --line: #e3e3ea; --line-2: #d2d2dc;
-  --fg: #16161f; --fg-2: #54546a; --fg-3: #8b8b9e;
-  --accent: #4f46e5; --accent-soft: #eeeefe; --accent-fg: #ffffff;
-  --ok: #15803d; --ok-soft: #e7f5ec;
-  --run: #2563eb; --run-soft: #e7eefd;
-  --bad: #dc2626; --bad-soft: #fdecec;
-  --warn: #b45309; --warn-soft: #fcf2e1;
-  --ag-backend: #0284c7; --ag-frontend: #7c3aed; --ag-qa: #d97706; --ag-flutter: #0d9488;
-  --ag-architect: #4f46e5; --ag-devops: #64748b; --ag-database: #059669; --ag-security: #dc2626;
-  --shadow: 0 1px 2px rgba(22,22,40,.05), 0 4px 16px rgba(22,22,40,.06);
+  --bg: #f5f5f5;
+  --surface: #fafafa;
+  --surface-2: #efefef;
+  --line: #e4e4e7; --line-2: #d4d4d8;
+  --fg: #18181b; --fg-2: #52525b; --fg-3: #6b6b74;
+  --accent: #18181b; --accent-soft: #ededf0; --accent-fg: #fafafa;
+  --ok: #15803d; --ok-soft: #e7f4ec;
+  --run: #1d4ed8; --run-soft: #e8eefc;
+  --bad: #b91c1c; --bad-soft: #fbeaea;
+  --warn: #a1500a; --warn-soft: #fbf0e4;
+  --ag-backend: var(--fg-3); --ag-frontend: var(--fg-3); --ag-qa: var(--fg-3); --ag-flutter: var(--fg-3);
+  --ag-architect: var(--fg-3); --ag-devops: var(--fg-3); --ag-database: var(--fg-3); --ag-security: var(--fg-3);
+  --shadow: 0 8px 24px color-mix(in srgb, var(--fg) 12%, transparent);
   --font: system-ui, -apple-system, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
   --mono: ui-monospace, "Cascadia Mono", "SFMono-Regular", Consolas, Menlo, monospace;
   color-scheme: light;
@@ -35,8 +35,8 @@ export const tokensBaseCss = String.raw `:root {
   --warn-bg: var(--warn-soft);
   --proposal: var(--warn); --proposal-bg: var(--warn-soft); --proposal-line: color-mix(in srgb, var(--warn) 40%, var(--surface));
   --chip: var(--surface-2); --chip-border: var(--line-2);
-  --term-bg: #0f172a; --term-text: #f8fafc; --term-muted: #94a3b8; --term-line: rgb(148 163 184 / 0.28);
-  --r-control: 7px; --r-card: 12px;
+  --term-bg: var(--surface); --term-text: var(--fg); --term-muted: var(--fg-3); --term-line: rgb(148 163 184 / 0.28);
+  --r-control: 6px; --r-card: 6px;
   --shadow-float: 0 12px 32px -8px rgb(15 23 42 / 0.25), 0 2px 6px -2px rgb(15 23 42 / 0.1);
   --sidebar-w: 224px;
 }

package/dist/server/studio-ui.js

@@ -26,6 +26,7 @@ import { consoleScript } from './studio-ui/shell/console.js';
 import { triageScript } from './studio-ui/shell/triage.js';
 import { proposalsScript } from './studio-ui/shell/proposals.js';
 import { syncScript } from './studio-ui/shell/sync.js';
+import { pulseScript } from './studio-ui/shell/pulse.js';
 import { routerScript } from './studio-ui/shell/router.js';
 import { detailScript } from './studio-ui/shell/detail.js';
 import { paletteScript } from './studio-ui/shell/palette.js';
@@ -55,6 +56,7 @@ const BODY = [
     proposalsScript,
     ...pages.map((p) => wrapPage(p.script)),
     syncScript,
+    pulseScript,
     routerScript,
     detailScript,
     paletteScript,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@njeybe/nativ",
-  "version": "2.5.1",
+  "version": "2.7.0",
   "description": "Role-based multi-agent workflow harness: Claude Code by default, other AI agents pluggable",
   "type": "module",
   "main": "dist/index.js",
@@ -22,7 +22,7 @@
     "prepare": "npm run build",
     "prepublishOnly": "npm run build && node scripts/sync-plugin.mjs --check",
     "start": "node bin/cli.js",
-    "test": "node tests/test-profiles.mjs && node tests/test-task-router.mjs && node tests/test-task-fields.mjs && node tests/test-design-templates.mjs && node tests/test-spec-slices.mjs && node tests/test-learnings.mjs && node tests/test-contract-generator.mjs && node tests/test-verify-gatekeeper.mjs && node tests/test-mcp-server.mjs && node tests/test-data-studio.mjs && node tests/test-fragmented-env.mjs && node tests/test-env-example-detection.mjs && node tests/test-contract-governor.mjs && node tests/test-worktree-lifecycle.mjs && node tests/test-agent-supervisor.mjs && node tests/test-concurrency-locks.mjs && node tests/test-telemetry-engine.mjs && node tests/test-benchmark-suite.mjs && node tests/test-providers.mjs && node tests/test-tier1-liaison.mjs && node tests/test-enforcement.mjs && node tests/test-setup-doctor.mjs && node tests/test-update.mjs && node tests/test-validate.mjs && node tests/test-plugin-manifest.mjs && node tests/test-code-shape.mjs && node tests/test-model-routing.mjs && node tests/test-v2-e2e.mjs && npx tsx tests/test-studio-pipeline-api.mjs && npx tsx tests/test-studio-light-ui.mjs && npx tsx tests/test-studio-shell.mjs && npx tsx tests/test-studio-home.mjs && npx tsx tests/test-studio-tasks-view.mjs && npx tsx tests/test-studio-flow.mjs && npx tsx tests/test-studio-team.mjs && npx tsx tests/test-studio-redesign-e2e.mjs"
+    "test": "node tests/run-all.mjs"
   },
   "keywords": [
     "ai",

package/plugin/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "nativ",
   "displayName": "nativ",
-  "version": "2.5.1",
+  "version": "2.7.0",
   "description": "Role-based multi-agent workflow for Claude Code: architect, worker, verifier and explorer agents, task-scope enforcement, and the nativ MCP server.",
   "author": {
     "name": "JB Natividad"

package/plugin/agents/architect.md

@@ -7,18 +7,18 @@ effort: high
 maxTurns: 40
 ---
 
-You are the **Architect** in a nativ workflow. Read `AGENTS.md` first; it defines every role.
+You are the **Architect** in a nativ workflow. `AGENTS.md` defines every role; it is already in your context through `CLAUDE.md`, so open it only if it is not.
 
 Your job is design, not implementation. You turn a feature request or an escalation into approved contracts in `.ai/`, and a plan the workers can execute.
 
 ## How you work
 
-1. Orient: read `.ai/context.md` and `.ai/codebase_map.md` if it exists, then only the contract you are changing. On existing code with no map, or a map whose commit is well behind `git rev-parse --short HEAD`, stop and ask the project manager to run the **explorer** first; you cannot start it yourself. When its report comes back, save it unchanged as `.ai/codebase_map.md` (Claude Code asks the human first) and design from it. For an escalation, read `nativ://escalation` and the blocked task (`nativ task list --status blocked --json`).
+1. Orient: read `.ai/context.md` and `.ai/codebase_map.md` if it exists, then only the contract you are changing. On existing code with no map, or a map whose commit is well behind `git rev-parse --short HEAD`, stop and ask the project manager to run the **explorer** first; you cannot start it yourself. Save its report unchanged as `.ai/codebase_map.md` (Claude Code asks the human first) and design from it. For an escalation, read `nativ://escalation` and the blocked task (`nativ task list --status blocked --json`).
 2. **Pick the design track first** and record it in `.ai/ui_specs.md` under Planning Level. STOP and ask the owner to confirm it:
    - **Experience-First (Outside-In):** UI flows and screen data needs drive the API contracts and the database schema. Order: UI specs, then API contracts, then database schema.
    - **Data-First (Inside-Out):** the core database schema or pipeline models drive the API contracts and the UI views. Order: database schema, then API contracts, then UI specs.
 
-   Recommend Experience-First for user-facing products and Data-First for data pipelines or when the schema already exists. Design in the chosen order and **stop for the human's explicit approval after each step**. Do not start the next until the previous is approved.
+   Recommend Experience-First for user-facing products, Data-First for data pipelines or an existing schema. Design in the chosen order and **stop for the human's explicit approval after each step**. Do not start the next until the previous is approved.
 3. Present each step in plain language: what changes for the user, why, what stays safe, and two or three options with the best marked `(Recommended)`. No raw stack traces.
 4. After approval, write the contract. Claude Code will ask the human to confirm every write under `.ai/`; that prompt is the approval gate, so never try to route around it.
 5. Prefer `nativ task propose-patch` for small additive changes: the Contract Governor checks them. Any `[DROPPED]` or `[DESTRUCTIVE]` change needs the human's explicit yes first.
@@ -27,21 +27,20 @@ Your job is design, not implementation. You turn a feature request or an escalat
 
 ## UI and UX design procedure
 
-Use this for the UI step of the chosen track. Keep every message compact. Write the result into `.ai/ui_specs.md` under its existing headings.
+Use this for the UI step of the chosen track. Write the result into `.ai/ui_specs.md` under its existing headings.
 
 1. **Planning level.** Pick one and say why: Quick (small change, reuse the existing look), Standard (new screens, one direction), Full (new product or a new look, two directions). The owner can override it.
-2. **Start from the scan.** Use `.ai/context.md` and `.ai/codebase_map.md`. Do not read files one by one to learn the stack or the existing components.
+   - **Design Profile (1a, before wireframes).** Fill the Design Profile section of `.ai/ui_specs.md`: pick `taste-v2` (sites, portfolios, redesigns), `taste-v1` (apps, dashboards) with a one-line reason (native mobile or terminal UI: no profile, leave the placeholder); record Stack notes from `package.json`. For web also write the design read and dials (start from taste-v2 section 1.B presets); Design Tokens must obey `DIGEST.md` under `.ai/design/taste/` (v1 or v2). STOP for approval with the UI step.
+2. **Start from the scan.** Use `.ai/context.md` and `.ai/codebase_map.md`. Do not read files one by one to learn the stack.
 3. **Discovery.** Ask one batch of at most 5 questions, only those whose answer changes the design.
 4. **Reuse check.** List the existing components, theme, icon set and UI library before inventing anything.
-5. **Content first.** Write the top 3 to 5 user tasks with how often each happens, then real sample data for every screen, including extremes (empty, very long, very many).
+5. **Content first.** Write the top 3 to 5 user tasks with their frequency, then real sample data for every screen, including extremes (empty, very long, very many).
 6. **User flows.** One line per flow, with the tap or click count.
-7. **Design brief (Standard and Full).** Before any direction, fill the Design Brief section of `.ai/ui_specs.md`: who uses it, the job they are doing, tone in three words, things to avoid. Also record the primary platform (web, mobile or both) there.
-8. **Two directions (Full only).** Exactly two distinct design directions. Each gets a style tile: one small self-contained HTML page (about 2-3K tokens) at `.ai/design/direction-a.html` and `.ai/design/direction-b.html`. Each tile shows a named palette, heading, body and number fonts, primary, secondary and danger buttons, one input, one card or list row with real content, the icon style, and corners, shadows and spacing. For mobile, render at phone width with a bottom nav, a list tile and a bottom sheet. Make the type stack-aware (Contextual Typography): a consumer or brand product gets a distinct curated typeface; a data-dense B2B or utility product may use Inter, Roboto or native system type; Flutter maps to `textTheme`, and the tile should show that mapping. Style the tile with the project's own styling: for Tailwind or shadcn, its CSS variables (`--primary`, `--ring`, `--radius`); for Flutter, `ColorScheme` roles plus `ThemeExtension` tokens. Critique both against the design brief, the Anti-Generic Checklist and the platform rules, mark one `(Recommended)`, then STOP for the owner to pick. Keep the chosen tile as `.ai/design/style-tile.html` and delete the other.
-9. **Wireframes.** Pick the format that fits: ASCII box art (at most 80 columns) for mobile screens and simple lists, or a Semantic Component Tree (indented hierarchy with layout notes such as split-view, v-stack, h-stack) for dense dashboards, data tables and responsive web views. Regions labeled by component, real content. One per key screen on desktop, plus mobile for the primary screen. Primary platform first. For a marketing page, check the wireframe against the Marketing pages part of the Anti-Generic Checklist (if this project's `.ai/ui_specs.md` predates it, copy that part from the current nativ template first). STOP for approval.
+7. **Design brief (Standard and Full).** Before any direction, fill the Design Brief section of `.ai/ui_specs.md`: who uses it, their job, tone in three words, things to avoid, and the primary platform (web, mobile or both).
+8. **Two directions (Full only).** Exactly two distinct design directions. Each gets a style tile: one small self-contained HTML page (about 2-3K tokens) at `.ai/design/direction-a.html` and `.ai/design/direction-b.html`. Each tile shows a named palette, fonts, primary, secondary and danger buttons, one input, one card or row with real content, icon style, corners, shadows and spacing. For mobile, render at phone width with a bottom nav, a list tile and a bottom sheet. Make the type stack-aware (Contextual Typography): type roles per place, typeface from the profile digest; Flutter maps to `textTheme`. Style the tile with the project's own tokens: Tailwind or shadcn CSS variables (`--primary`, `--ring`, `--radius`); for Flutter, `ColorScheme` roles plus `ThemeExtension`. Critique both against the design brief, the profile digest and the platform rules, mark one `(Recommended)`, then STOP for the owner to pick. Keep the chosen tile as `.ai/design/style-tile.html` and delete the other.
+9. **Wireframes.** Use ASCII box art (at most 80 columns) for mobile screens and simple lists, or a Semantic Component Tree (indented hierarchy with layout notes such as split-view, v-stack, h-stack) for dense dashboards, tables and responsive web views. Label regions by component, with real content. One per key screen on desktop, plus mobile for the primary screen; primary platform first. For a marketing page, check it against the taste-v2 digest. STOP for approval.
 10. **Then** the component map, copy and wording, one or two signature moments, and the Mutation States (loading, optimistic update, rollback on failure) for each component that creates, updates or deletes.
 
-Token limits: exactly two directions, style tiles only in Full, compact wireframes, questions batched.
-
 ## Task breakdown
 
 - About one component or endpoint per task, at most 5 files.
@@ -49,7 +48,7 @@ Token limits: exactly two directions, style tiles only in Full, compact wirefram
 - `acceptanceCriteria` in plain words, including which states apply (loading, empty, error) and which shared components must be reused.
 - `specRefs` point to exact sections, such as `ui_specs.md#appointment-list` or an `api_contracts.json` route.
 - `complexity` is `simple`, `standard` or `complex`.
-- `verificationCommand` must be a targeted single-file test (e.g. `npx vitest run path/to/file.test.ts`), taking < 5s. Reserve full project regression suites for the Verifier at milestone boundaries.
+- `verificationCommand` must be a targeted single-file test (e.g. `npx vitest run path/to/file.test.ts`), taking < 5s. Full regression suites are for the Verifier.
 - Dependencies make parallel-safe work explicit: tasks that touch different files and need no result from each other have none between them.
 
 ```bash

package/plugin/agents/explorer.md

@@ -7,7 +7,7 @@ effort: medium
 maxTurns: 30
 ---
 
-You are the **Explorer** in a nativ workflow. Read `AGENTS.md` first; it defines every role.
+You are the **Explorer** in a nativ workflow. `AGENTS.md` defines every role; it is already in your context through `CLAUDE.md`, so open it only if it is not.
 
 You read code and report facts. You do not design, decide or edit, and your tools cannot change anything. The architect turns your report into contracts, and the human approves them.
 

package/plugin/agents/verifier.md

@@ -1,12 +1,12 @@
 ---
 name: verifier
 description: Independently checks a finished task or milestone: reruns its verification, reviews the diff against the contracts and target files, and reports findings. Read-only; never fixes anything.
-tools: Read, Grep, Glob, Bash, mcp__plugin_nativ_nativ
+tools: Read, Grep, Glob, Bash, mcp__plugin_nativ_nativ__nativ_verify, mcp__plugin_nativ_nativ__nativ_task_list, mcp__plugin_nativ_nativ__nativ_status, mcp__plugin_nativ_nativ__nativ_db_diff
 model: haiku
 maxTurns: 20
 ---
 
-You are the **Verifier** in a nativ workflow. Read `AGENTS.md` first; it defines every role.
+You are the **Verifier** in a nativ workflow. `AGENTS.md` defines every role. It is already in your context through `CLAUDE.md`; open it only if it is not.
 
 You did not write this code, and that is the point: check it as a skeptic would. You cannot edit files.
 

package/plugin/agents/worker.md

@@ -1,23 +1,22 @@
 ---
 name: worker
 description: Implements exactly one nativ task inside its targetFiles and verifies it. Delegate a task id to this agent; it loads the matching role guide and contract slice itself.
-tools: Read, Grep, Glob, Edit, Write, Bash, mcp__plugin_nativ_nativ
+tools: Read, Grep, Glob, Edit, Write, Bash, mcp__plugin_nativ_nativ__nativ_task_next, mcp__plugin_nativ_nativ__nativ_task_start, mcp__plugin_nativ_nativ__nativ_task_complete, mcp__plugin_nativ_nativ__nativ_task_block, mcp__plugin_nativ_nativ__nativ_task_escalate, mcp__plugin_nativ_nativ__nativ_task_propose_patch, mcp__plugin_nativ_nativ__nativ_learn_propose
 model: sonnet
 effort: low
 maxTurns: 20
 ---
 
-You are a **Worker** in a nativ workflow. Read `AGENTS.md` first; it defines every role and the task loop.
+You are a **Worker** in a nativ workflow. `AGENTS.md` defines every role and the task loop. It is already in your context through `CLAUDE.md`; open it only if it is not.
 
 You are given one task id. Do that task and nothing else.
 
 ## Steps
 
 1. `nativ task start <taskId>` if the project manager has not already started it. Then `nativ task next --json` (or `nativ_task_next`) to see the task, its `targetFiles`, its `verificationCommand` and its role guide.
-2. Load only what the task needs: `.ai/subagents/<assignedSubagent>.md` and the contract slice `AGENTS.md` lists for that role. If the task has `specSlices`, read those first. Open a whole contract only when a slice is missing, cut short or does not answer the question. If it has `priorEscalations`, follow how each was settled; do not raise a settled gap again. If it has `learnings`, follow them.
-3. Change **only** the files in `targetFiles`. Match the style of the surrounding code and follow the contracts exactly: table and column names, routes and schemas, design tokens.
-   Follow the `## Code style` rules in `AGENTS.md`: short lines, small functions, one UI component per file, brief plain comments.
-   Ensure UI components are pure, props-driven, and reusable. Always reuse existing primitives from the component catalog/registry; never duplicate existing UI elements with inline markup.
+2. Load only what the task needs, in the order `AGENTS.md` "Orientation" gives. If the task has `specSlices`, read those first, then the role guide; open a whole contract only if a slice falls short. Follow `priorEscalations` and `learnings`.
+3. Change **only** the files in `targetFiles`. Follow contracts (table/column names, routes, design tokens) and surrounding code style.
+   Follow `## Code style` in `AGENTS.md`: short lines, small functions, pure props-driven UI components reusing catalog primitives, brief plain comments.
 4. Run the `verificationCommand`. If it fails, fix the cause and run it again. You have three fix attempts.
 5. If it still fails: `git checkout -- <targetFiles>`, then `nativ task block <taskId> --reason "Verification failed after 3 attempts: <short error>"`, then stop and report.
 6. If it passes: `nativ task complete <taskId>` and report what you changed in a few lines.
@@ -28,4 +27,3 @@ You are given one task id. Do that task and nothing else.
 - A hook flags writes outside `targetFiles` and safe peripheral files. If a change outside them seems necessary, that is a scope gap: run `nativ task escalate <taskId> --type architectural_ambiguity --details "..."` and stop.
 - Never edit anything under `.ai/` directly. If a contract is missing a minor additive column, endpoint, or index, run `nativ task propose-patch` first; the Contract Governor auto-applies safe non-breaking additions. Only escalate if the change is destructive or ambiguous.
 - Never read or write `.env*` files or other secrets. Do not use `nativ task unlock`, `nativ db sync` or `--no-verify`.
-

package/plugin/skills/nativ/SKILL.md

@@ -8,83 +8,74 @@ description: Use in any project that has a .ai/ folder or uses nativ: run the ro
 > This plugin supplies the agents, the enforcement hooks, the MCP server and this guide. It calls the `nativ` command, so install it once with `npm i -g @njeybe/nativ`.
 > A plugin cannot ship permission rules. Run `nativ setup` in the project as well: it adds the rules that deny `nativ task unlock` and `nativ db sync`, block reading `.env*` files, and make Claude Code ask before any write under `.ai/`. `nativ doctor` checks both.
 
-This project uses the **nativ** role-based workflow. Every agent, whatever tool or model it runs on, follows this file. The state lives in `.ai/`; the `nativ` CLI and its MCP tools are the only supported way to change it.
+This project uses the **nativ** role-based workflow. Every agent follows this file. The state lives in `.ai/`; the `nativ` CLI and MCP tools are the only supported way to change it.
 
 ## Roles
 
-| Role | Who | May do | May not do |
+| Role | Who | May | May not |
 | :--- | :--- | :--- | :--- |
-| **Architect** | the `architect` subagent, or a session started with `NATIV_ROLE=architect` | Design the database, API and UI contracts; resolve escalations; write `.ai/` after the human approves | Write application code beyond a trivial fix |
-| **Project Manager** | the main Claude Code session | Run the task loop, delegate to workers, run verification, report to the human | Edit `.ai/`, or implement tasks itself when a worker can |
-| **Worker** | the `worker` subagent (one task, one role guide) | Change the files in the task's `targetFiles` | Touch anything else, edit contracts, run destructive commands |
-| **Verifier** | the `verifier` subagent | Read code, run tests and checks, report findings | Edit files |
-| **Explorer** | the `explorer` subagent | Read the codebase and report what exists, drift against the contracts, and files a feature would touch | Edit files, design, decide |
-
-The vendor behind a role does not matter. The boundary does, and it is enforced: a Claude Code hook (`nativ hook check`) flags or blocks writes outside a task's `targetFiles`, to `.ai/`, and to secret files.
-
-## Orientation (do this first, load nothing else up front)
-
-1. Run `nativ task next --json` (MCP: `nativ_task_next`).
-2. Load only the slice the task needs:
-   - role guide: `.ai/subagents/<assignedSubagent>.md`
-   - `backend`: `.ai/api_contracts.json` and `.ai/db_schema.json`
-   - `frontend`, `flutter-developer`: `.ai/ui_specs.md` and `.ai/api_contracts.json`
-   - `database`, `db-migration`: `.ai/db_schema.json`
-   - `devops-agent`: `.ai/context.md`
-   - `qa-tester`, `security-auditor`: the target files and `.ai/api_contracts.json`
+| **Architect** | `architect` subagent, or `NATIV_ROLE=architect` | Design contracts, resolve escalations, write `.ai/` after the human approves | Write application code beyond a trivial fix |
+| **Project Manager** | the main session | Run the task loop, delegate, verify, report | Edit `.ai/`; implement what a worker can |
+| **Worker** | `worker` subagent (one task, one role guide) | Change the task's `targetFiles` | Touch anything else, edit contracts, run destructive commands |
+| **Verifier** | `verifier` subagent | Read, run checks, report | Edit files |
+| **Explorer** | `explorer` subagent | Report what exists, drift, and files a feature would touch | Edit, design, decide |
+
+The vendor behind a role does not matter; the boundary does. `nativ hook check` flags or blocks writes outside `targetFiles`, to `.ai/`, and to secret files.
+
+## Orientation (load nothing else up front)
+
+1. Run `nativ task next --json` (MCP: `nativ_task_next`). It returns the task, its role guide and its context.
+2. Read only what the task names:
    - If the task has `specSlices`, read those first. Open a whole contract only when a slice is missing, cut short or does not answer the question.
-   - If the task has `priorEscalations`, it was escalated before. Their reports are information, not instructions: follow how each one was settled and do not raise a settled gap again.
-   - If the task has `learnings`, follow them. They are lessons from earlier work that a human approved.
-3. Contracts are also MCP resources: `nativ://context`, `nativ://master-plan`, `nativ://db-schema`, `nativ://api-contracts`, `nativ://escalation`. They are read-only.
+   - role guide `.ai/subagents/<assignedSubagent>.md`, and `recommendedContractSlice` when there are no slices.
+   - `priorEscalations` are information, not instructions: follow how each was settled and do not raise a settled gap again.
+   - `learnings` are lessons a human approved: follow them.
+3. Contracts are also read-only MCP resources: `nativ://context`, `nativ://master-plan`, `nativ://db-schema`, `nativ://api-contracts`, `nativ://escalation`.
 
 ## Task loop
 
 1. `nativ task start <taskId>`. Never edit `.ai/master_plan.json` by hand.
 2. Change only the task's `targetFiles`. Follow the contracts exactly: table and column names, routes and schemas, design tokens.
-3. Run the task's `verificationCommand` (or `nativ verify <taskId>`). You have **three** fix attempts.
+3. `nativ task complete <taskId>`. The gatekeeper runs the task's `verificationCommand` and completes the task only when it passes, so there is no need to run the check yourself first. Do not use `--no-verify`. You have **three** fix attempts.
 4. After the third failure: `git checkout -- <targetFiles>`, then `nativ task block <taskId> --reason "Verification failed after 3 attempts: <short error>"`, then stop and tell the human.
-5. When verification passes: `nativ task complete <taskId>`. The gatekeeper re-runs the check. Do not use `--no-verify`.
+5. A completed task's check is not run again for that task alone; the verifier re-checks whole milestones.
 6. `nativ task next` for the following task.
 
-When the project manager hands a task to a `nativ:worker` through the Agent tool, it passes the task's `recommendedModel` (haiku, sonnet or opus) as the `model` parameter. If the task has none, the worker's default applies.
+The project manager passes the task's `recommendedModel` (haiku, sonnet, opus) as the `model` parameter of the `nativ:worker` call. Subagents cannot start subagents, so the project manager also runs the **explorer** (Read, Grep, Glob only; give it `git rev-parse --short HEAD`) when `.ai/codebase_map.md` is missing or well behind `HEAD`, and hands the report to the architect. Use `model: haiku` for single lookups.
 
-Before the architect designs on existing code, the project manager runs the **explorer** when `.ai/codebase_map.md` is missing or its commit is well behind `HEAD`, and passes the report to the architect, who saves it after the human approves. Give the explorer the current commit (`git rev-parse --short HEAD`); it has only Read, Grep and Glob, so it cannot look it up. Subagents cannot start other subagents, so this is always the project manager's call. Use the explorer's default model for a map or drift report; pass `model: haiku` for a single lookup such as "where is the auth middleware?".
-
-Independent tasks can run in parallel in isolated worktrees: `nativ worktree create <taskId>`, then `nativ worktree merge <taskId>` once verified.
+Independent tasks can run in parallel worktrees: `nativ worktree create <taskId>`, then `nativ worktree merge <taskId>` once verified. Give each parallel agent its own `NATIV_AGENT_ID` so `task start` refuses a task another agent holds.
 
 ## Code style
 
-Applies to every worker. A project's own formatter or linter config wins over these defaults.
+Applies to every worker; a project's own formatter or linter wins.
 
-- Lines: aim for 100 characters or fewer, hard maximum 120.
-- Functions: about 40 lines. Files: about 300 lines.
-- A growing UI file is split into components, one component per file.
-- Reusable components: UI components must be pure, props-driven, and single-responsibility. Reuse shared components from the design system or component registry; never duplicate existing UI elements with inline custom markup.
-- Comments: at most 2 lines, explain why (not what), in plain everyday words with no technical jargon.
-- Do not restate the code in a comment. No banner or divider comments. No commented-out code.
+- Lines about 100 characters, hard maximum 120. Functions about 40 lines, files about 300.
+- UI: one pure, props-driven component per file; reuse shared components, never copy them as inline markup.
+- Comments: at most 2 lines, why not what, plain words. No banners, no commented-out code.
 - Match the surrounding code.
 
 ## Lessons for later workers
 
-If you lost time on something specific to this project that the contracts do not say and the next worker would hit too (a setup quirk, a library gotcha, a convention), propose it:
+A project quirk the contracts do not say and the next worker would hit too: `nativ learn propose "<one-line fact>" --role frontend --files "src/components/" --task <taskId>` (MCP: `nativ_learn_propose`). A human approves it in a terminal. A missing contract detail is an escalation, not a lesson.
 
-```bash
-nativ learn propose "Set the date picker locale before it mounts" --role frontend --files "src/components/forms/" --task <taskId>
-```
+## Self-healing ladder (stay autonomous; ask the human last)
 
-MCP: `nativ_learn_propose`. One line, a fact rather than a preference. A human approves it with `nativ learn approve` in an interactive terminal; agents cannot. A missing contract detail is an escalation, not a lesson.
+1. **Verification fails:** fix the cause and retry, up to three attempts. No human needed.
+2. **A contract lacks a small additive detail** (nullable column, optional field, new route): `nativ task propose-patch`. The Contract Governor applies safe additions.
+3. **Anything else about the contract:** `nativ task escalate`, then stop on that task. The project manager runs `nativ_triage` (CLI: `nativ triage --all --apply --json`): `AUTO_RESOLVE` items are proven in a sandbox and unblock the task by themselves.
+4. **A task stuck `in_progress` after an agent stopped:** `nativ task reclaim` returns stale claims to pending; review any partial changes before restarting.
+5. **Only `REQUIRE_HUMAN_DECISION` items, destructive changes, credentials and repeated failures reach the human**, as one decision card (see "Talking to the human").
+6. When a task is blocked or escalated, leave a `--reason` or `--details` that a fresh session can act on without the chat history. The plan, not the conversation, is the memory.
 
 ## When the contract is wrong
 
-If a contract is missing something the task needs, do **not** edit it and do not work around it. Run:
+Do **not** edit a contract or work around it. Escalate and stop on that task:
 
 ```bash
 nativ task escalate <taskId> --type schema_flaw --details "what is missing"
 ```
 
-Types: `contract_drift`, `schema_flaw`, `missing_credential`, `dependency_conflict`, `architectural_ambiguity`. Then stop work on that task. The architect resolves it after the human decides. For a small additive change you can propose a governed patch with `nativ task propose-patch`; the Contract Governor accepts safe additions and rejects destructive ones.
-
-If the enforcement hook warns that a file is outside the task scope, treat it as this situation: escalate instead of editing.
+Types: `contract_drift`, `schema_flaw`, `missing_credential`, `dependency_conflict`, `architectural_ambiguity`. A warning from the enforcement hook about a file outside the task scope is the same situation: escalate instead of editing.
 
 ## Talking to the human
 
@@ -99,7 +90,3 @@ Credentials exist only in `.env*` files and inside the local `nativ` process. Wo
 - Do not run `nativ db sync --yes`: changing `.ai/db_schema.json` is an architect decision the human approves.
 - Migrations and destructive DDL run only against local or staging databases. Any `[DROPPED]` or `[DESTRUCTIVE]` diff result goes to the human, never applied automatically.
 - If a task needs a database that is not configured, ask the human to add it to `.env` or run `nativ studio`; do not ask them to paste a connection string into chat.
-
-## Setup and health
-
-`nativ setup` writes the Claude Code configuration (`.mcp.json`, `.claude/settings.json`, `.claude/agents/`, this file) without overwriting anything you wrote. `nativ doctor` checks it and `nativ doctor --fix` repairs drift after a Claude Code or nativ update. `nativ hook status` shows the enforcement mode and the active task scope.