@njeybe/nativ 2.9.0 → 2.9.1

package/dist/server/routes/task-routes.js

@@ -36,6 +36,7 @@ export function packageVersion() {
     }
     return cachedVersion;
 }
+const archivedCount = (ms) => ms.reduce((n, m) => n + (m.archived?.taskCount ?? 0), 0);
 /** GET /api/pipeline/status: contract matrix, milestone/task burndown and telemetry KPIs. */
 export function handlePipelineStatus(root) {
     const aiDir = path.join(root, AI_DIR);
@@ -43,7 +44,9 @@ export function handlePipelineStatus(root) {
     const milestones = planMilestones(readPlan(root));
     const tasks = milestones.flatMap((m) => m.tasks);
     const count = (items, status) => items.filter((i) => i.status === status).length;
-    const completedTasks = count(tasks, 'completed');
+    // Archived tasks are gone from the plan but still count as done work.
+    const kept = archivedCount(milestones);
+    const completedTasks = count(tasks, 'completed') + kept;
     const { summary, tasks: trackedTasks } = loadTelemetry(path.join(aiDir, 'telemetry.json'));
     const actual = aggregateActualUsage(trackedTasks);
     return {
@@ -58,12 +61,12 @@ export function handlePipelineStatus(root) {
                 pending: count(milestones, 'pending'),
             },
             tasks: {
-                total: tasks.length,
+                total: tasks.length + kept,
                 completed: completedTasks,
                 inProgress: count(tasks, 'in_progress'),
                 pending: count(tasks, 'pending'),
                 blocked: count(tasks, 'blocked'),
-                progressPercentage: percent(completedTasks, tasks.length),
+                progressPercentage: percent(completedTasks, tasks.length + kept),
             },
             telemetry: {
                 totalTokens: finiteOr(summary?.estimatedTotalTokens, 0),
@@ -87,7 +90,10 @@ export function handlePipelineStatus(root) {
 export function handlePipelineTasks(root) {
     const plan = readPlan(root);
     const milestones = planMilestones(plan);
-    const completedIds = new Set(milestones.flatMap((m) => m.tasks).filter((t) => t.status === 'completed').map((t) => t.id));
+    const completedIds = new Set([
+        ...milestones.flatMap((m) => m.tasks).filter((t) => t.status === 'completed').map((t) => t.id),
+        ...milestones.flatMap((m) => m.archived?.taskIds ?? []),
+    ]);
     return {
         ok: true,
         projectName: plan?.projectName ?? null,
@@ -95,7 +101,9 @@ export function handlePipelineTasks(root) {
         activeMilestoneId: plan?.activeMilestoneId ?? null,
         milestones: milestones.map((m) => ({
             ...m,
-            progressPercentage: percent(m.tasks.filter((t) => t.status === 'completed').length, m.tasks.length),
+            progressPercentage: m.archived
+                ? 100
+                : percent(m.tasks.filter((t) => t.status === 'completed').length, m.tasks.length),
             tasks: m.tasks.map((t) => ({
                 ...t,
                 // Same readiness rule as `nativ task list --available`.

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

@@ -97,8 +97,10 @@ export const modelScript = String.raw `  // ─── Studio client model: build
   }
 
   function finishMilestone(m) {
-    m.total = m.tasks.length;
-    m.done = m.tasks.filter(function (t) { return t.status === 'completed'; }).length;
+    // An archived milestone keeps its task count, so overall progress does not drop.
+    var kept = m.archived ? (m.archived.taskCount || 0) : 0;
+    m.total = m.tasks.length + kept;
+    m.done = m.tasks.filter(function (t) { return t.status === 'completed'; }).length + kept;
     var ends = m.tasks.map(function (t) { return t.endT || 0; });
     m.lastEndT = Math.max.apply(null, [0].concat(ends)) || null;
     m.workMs = m.tasks.reduce(function (sum, t) { return sum + (t.durationMs || 0); }, 0);
@@ -106,9 +108,10 @@ export const modelScript = String.raw `  // ─── Studio client model: build
     m.costUsd = costs.length ? costs.reduce(function (sum, t) { return sum + t.costUsd; }, 0) : null;
   }
 
-  function linkTasks(tasks, byId) {
+  function linkTasks(tasks, byId, archivedIds) {
     tasks.forEach(function (t) {
       t.deps.forEach(function (d) {
+        if (archivedIds[d]) return;
         var parent = byId[d];
         if (parent && parent.children.indexOf(t.id) === -1) parent.children.push(t.id);
         if (!parent || parent.status !== 'completed') t.waitingOn.push(d);
@@ -138,7 +141,8 @@ export const modelScript = String.raw `  // ─── Studio client model: build
     var st = api.status && api.status.telemetry;
     var pick = function (a, b) { return a != null && isFinite(a) ? a : (b != null && isFinite(b) ? b : null); };
     var contracts = api.status && api.status.contracts;
-    var done = tasks.filter(function (t) { return t.status === 'completed'; }).length;
+    var kept = milestones.reduce(function (n, m) { return n + (m.archived ? m.archived.taskCount || 0 : 0); }, 0);
+    var done = tasks.filter(function (t) { return t.status === 'completed'; }).length + kept;
     return {
       spendUsd: pick(act && act.spendUsd, st && st.actualSpendUsd),
       cacheHitRate: pick(act && act.cacheHitRate, st && st.cacheHitRate),
@@ -147,9 +151,9 @@ export const modelScript = String.raw `  // ─── Studio client model: build
       contractsTotal: 5,
       milestonesTotal: milestones.length,
       milestonesDone: milestones.filter(function (m) { return m.total > 0 && m.done === m.total; }).length,
-      tasksTotal: tasks.length,
+      tasksTotal: tasks.length + kept,
       tasksDone: done,
-      tasksLeft: tasks.length - done
+      tasksLeft: tasks.length + kept - done
     };
   }
 
@@ -157,7 +161,7 @@ export const modelScript = String.raw `  // ─── Studio client model: build
   function buildModel(api) {
     api = api || {};
     var index = indexApi(api);
-    var tasks = [], byId = {};
+    var tasks = [], byId = {}, archivedIds = {};
     var milestones = (api.milestones || []).map(function (m, i) {
       var list = (m.tasks || []).map(function (t) {
         var task = buildTask(t, m.id, index);
@@ -165,9 +169,12 @@ export const modelScript = String.raw `  // ─── Studio client model: build
         tasks.push(task);
         return task;
       });
-      return { id: m.id, name: m.name || m.id, short: shortName(m.name || m.id), status: m.status, idx: i, tasks: list };
+      var archived = m.archived || null;
+      if (archived) (archived.taskIds || []).forEach(function (id) { archivedIds[id] = true; });
+      return { id: m.id, name: m.name || m.id, short: shortName(m.name || m.id), status: m.status, idx: i,
+        tasks: list, archived: archived };
     });
-    linkTasks(tasks, byId);
+    linkTasks(tasks, byId, archivedIds);
     milestones.forEach(finishMilestone);
     var active = null;
     milestones.some(function (m) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@njeybe/nativ",
-  "version": "2.9.0",
+  "version": "2.9.1",
   "description": "Role-based multi-agent workflow harness: Claude Code by default, other AI agents pluggable",
   "type": "module",
   "main": "dist/index.js",

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

@@ -1,7 +1,7 @@
 {
   "name": "nativ",
   "displayName": "nativ",
-  "version": "2.9.0",
+  "version": "2.9.1",
   "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/worker.md

@@ -17,9 +17,9 @@ You are given one task id. Do that task and nothing else.
 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.
+4. Do not run the `verificationCommand` yourself: `nativ task complete <taskId>` runs it. Finish with that command. If it fails, fix the cause and run it again. You have three attempts in total.
+5. If the third attempt 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, report what you changed in a few lines.
 7. If you lost time on a project-specific gotcha the next worker would hit too, propose it with `nativ learn propose` (see `AGENTS.md`). Do not approve it yourself.
 
 ## Boundaries

package/plugin/hooks/hooks.json

@@ -18,7 +18,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "nativ hook context",
+            "command": "nativ hook context --from-plugin",
             "timeout": 10
           }
         ]

package/plugin/skills/nativ/SKILL.md

@@ -31,6 +31,7 @@ This project uses the **nativ** role-based workflow. Every agent follows this fi
    - `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`.
+4. An old or archived task: `nativ task show <id>`, not the plan file.
 
 ## Task loop
 
@@ -38,12 +39,12 @@ This project uses the **nativ** role-based workflow. Every agent follows this fi
 2. Change only the task's `targetFiles`. Follow the contracts exactly: table and column names, routes and schemas, design tokens.
 3. `nativ task complete <taskId>`. The gatekeeper runs the task's `verificationCommand` and completes the task only when it passes, so do not run it 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. The verifier re-checks whole milestones, not single tasks.
+5. The verifier checks whole milestones. A passed one: `nativ milestone archive <id> --summary "<one line>"`, tell the human, suggest `/clear` (the plan holds the state).
 6. `nativ task next` for the following task.
 
-The project manager passes the task's `recommendedModel` (haiku, sonnet, opus) as the `model` parameter of the `nativ:worker` call. Subagents cannot spawn subagents, so the project manager 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.
+The project manager passes the task's `recommendedModel` as the `model` parameter of the worker call. Subagents cannot spawn subagents, so the project manager 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.
 
-Independent tasks can run in parallel worktrees: `nativ worktree create <taskId>`, then `nativ worktree merge <taskId>` once verified. Give each agent its own `NATIV_AGENT_ID` so `task start` refuses a task another agent holds.
+Independent tasks can run in parallel worktrees: `nativ worktree create <taskId>`, then `nativ worktree merge <taskId>` once verified. Each parallel agent needs its own `NATIV_AGENT_ID`.
 
 ## Code style
 

package/templates/AGENTS.md

@@ -23,6 +23,7 @@ This project uses the **nativ** role-based workflow. Every agent follows this fi
    - `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`.
+4. An old or archived task: `nativ task show <id>`, not the plan file.
 
 ## Task loop
 
@@ -30,12 +31,12 @@ This project uses the **nativ** role-based workflow. Every agent follows this fi
 2. Change only the task's `targetFiles`. Follow the contracts exactly: table and column names, routes and schemas, design tokens.
 3. `nativ task complete <taskId>`. The gatekeeper runs the task's `verificationCommand` and completes the task only when it passes, so do not run it 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. The verifier re-checks whole milestones, not single tasks.
+5. The verifier checks whole milestones. A passed one: `nativ milestone archive <id> --summary "<one line>"`, tell the human, suggest `/clear` (the plan holds the state).
 6. `nativ task next` for the following task.
 
-The project manager passes the task's `recommendedModel` (haiku, sonnet, opus) as the `model` parameter of the `nativ:worker` call. Subagents cannot spawn subagents, so the project manager 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.
+The project manager passes the task's `recommendedModel` as the `model` parameter of the worker call. Subagents cannot spawn subagents, so the project manager 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.
 
-Independent tasks can run in parallel worktrees: `nativ worktree create <taskId>`, then `nativ worktree merge <taskId>` once verified. Give each agent its own `NATIV_AGENT_ID` so `task start` refuses a task another agent holds.
+Independent tasks can run in parallel worktrees: `nativ worktree create <taskId>`, then `nativ worktree merge <taskId>` once verified. Each parallel agent needs its own `NATIV_AGENT_ID`.
 
 ## Code style
 

package/templates/claude-agents/worker.md

@@ -17,9 +17,9 @@ You are given one task id. Do that task and nothing else.
 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.
+4. Do not run the `verificationCommand` yourself: `nativ task complete <taskId>` runs it. Finish with that command. If it fails, fix the cause and run it again. You have three attempts in total.
+5. If the third attempt 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, report what you changed in a few lines.
 7. If you lost time on a project-specific gotcha the next worker would hit too, propose it with `nativ learn propose` (see `AGENTS.md`). Do not approve it yourself.
 
 ## Boundaries