agentera 3.0.0-dev.76 → 3.0.0-dev.77

package/dist/capabilities/status/instructions.js

@@ -1,6 +1,6 @@
 // Capability instructions for status (canonical per D57; D65 relocated from .md to .ts)
 // Served via `agentera prime --context status --format json`. RFC 2119 modal vocab per D71.
-export const instructions = JSON.parse(String.raw `"# STATUS\n\n**Holistic Entry Junction. Orient, Route, Activate**\n\nSingle entry point to the agentera suite. Detects fresh vs returning, delivers a situational briefing, routes to the right capability. Same path on first install and the 100th session.\n\nGlyph: **⌂** (SG1). Status reads suite state through \u0060agentera prime\u0060 and writes nothing. A bare user message of exactly \u0060/agentera\u0060 invokes this capability; it does not fall back to conversational smalltalk.\n\nStatus MUST source both instructions and bounded state from \u0060agentera prime --context status --format json\u0060 and write nothing. Read \u0060capability_context.instructions\u0060 in full, render from \u0060capability_context.context.status_context\u0060, and use the one \u0060capability_context.startup\u0060 aggregation. Its outcome is \u0060ok\u0060, \u0060degraded\u0060, or \u0060blocked\u0060; \u0060status_context.outcome\u0060 is the same value. For deferred detail, run only that availability row\u0027s exact \u0060detail_command\u0060. An \u0060ok\u0060 startup needs no second prime call. Status MUST NOT raw-read \u0060.agentera/*.yaml\u0060.\n\n---\n\n## Dashboard rendering\n\nStatus owns the prime dashboard contract. SKILL.md and other surfaces delegate here.\n\n\u0060\u0060\u0060text\n┌─┐┌─┐┌─┐┌┐┌┌─┐┌─┐┬─┐┌─┐\n├─┤│ ┬├┤ │││ │ ├┤ ├┬┘├─┤\n┴ ┴└─┘└─┘┘└┘ ┴ └─┘┴└─┴ ┴\n\n─── status ─────────────────────────────\n\n  ⛶ health    [⮉|⮋] [grade] ([worst dimension: grade])\n  ⇶ todo      N critical · M degraded · J annoying\n  ≡ plan      [██████▓░░░] N/M tasks\n  ⎘ optim     [metric] [current] → [target]\n  ♾ profile   [loaded | not found]\n\n  [1-2 sentence narrative read: what shipped, what's moving, what needs eyes.\n  Interpretation, not metrics. Closes the status section before attention.]\n\n─── attention ──────────────────────────\n\n  ⇶ [critical items, triple arrow for critical]\n  ⇉ [degraded items, double arrow for degraded]\n  → [normal items, single arrow for normal]\n  ⇢ [annoying items, dashed arrow for annoying]\n\n─── next ───────────────────────────────\n\n  suggested → [glyph] [capability] ([reason])\n\u0060\u0060\u0060\n\nBuild the dashboard from \u0060agentera prime --format json\u0060 output. Source labels such as \u0060mode:\u0060, \u0060profile:\u0060, \u0060v1_migration:\u0060, \u0060health:\u0060, \u0060todo:\u0060, \u0060plan:\u0060, \u0060objective:\u0060, \u0060attention:\u0060, \u0060next_action:\u0060, and the \u0060app.status\u0060 installed-app status object are parsing aids, not dashboard lines. Do not relay raw CLI lines as the user-facing briefing.\n\n**Output constraint**: ≤120 words total briefing, ≤15 words per routing suggestion.\n\n**Exit marker**: after the closing code fence of the dashboard, emit \u0060⌂ status · <status>\u0060 on its own line, followed by a one-sentence summary of what you delivered. For \u0060waiting\u0060, \u0060flagged\u0060, or \u0060stuck\u0060, add a \u0060▸\u0060 bullet below the summary identifying what the user needs to decide or act on next. The exit marker MUST appear on every invocation regardless of mode (fresh welcome or returning briefing).\n\n**Formatting rules**:\n- Each status line uses the skill glyph that owns that data\n- Severity arrows (VT5-VT8) mark attention items by urgency\n- Trend arrows (VT12/VT13) show health trajectory; derive ⮉/⮋ from \u0060health.degrading\u0060 (false→⮉, true→⮋); omit when no audit history\n- Progress bars (VT18) show plan completion visually\n- The inline separator (VT16) joins counts on a single line\n- Lead with status metrics, then the narrative read inside the status section\n- The narrative read is colleague interpretation; metric lines above it are evidence\n- The todo summary line lists critical, degraded, and annoying counts only; normal-priority items belong in attention with → (SI3), not on the summary line\n- Omit any line whose source artifact is missing\n- Omit any section that would be empty (e.g., no attention items = no attention section)\n\nVisual token IDs live in \u0060skills/agentera/protocol.yaml\u0060; see VT, SI, EX, SG, PH families.\n\n---\n\n## Briefing\n\nUse the \u0060mode\u0060 field from \u0060agentera prime\u0060 to detect fresh vs returning:\n\n- **Fresh** (\u0060mode: fresh\u0060): render welcome language; lead with the suggested capability from \u0060next_action\u0060. Do not enumerate the full suite unless asked.\n- **Returning** (\u0060mode: returning\u0060): render the dashboard template above using \u0060mode\u0060, \u0060profile\u0060, \u0060health\u0060, \u0060todo\u0060, \u0060plan\u0060, \u0060objective\u0060, \u0060attention\u0060, and \u0060next_action\u0060 fields.\n\nNarration voice: warm, brief, unscripted.\n\n### Project integration rendering\n\nWhen \u0060project_integration.recommendation\u0060 is \u0060upgrade\u0060:\n1. Render the plain-language \u0060project_integration.message\u0060.\n2. Show \u0060project_integration.dry_run_command\u0060 preview; state that it changes nothing.\n3. Ask before running \u0060project_integration.apply_command\u0060.\n\nWhen \u0060recommendation\u0060 is \u0060stay\u0060, do not suggest upgrade.\n\n### App status rendering\n\nRender \u0060app.status\u0060 as a status line only when it is not \u0060up_to_date\u0060. Use the plain-language \u0060project_integration.message\u0060 if present. Status MUST NOT teach install-recovery procedure — that belongs to the upgrade capability and \u0060agentera doctor\u0060.\n\n### Profile rendering\n\nRender \u0060profile.status\u0060 (\u0060loaded\u0060 or \u0060not found\u0060). Render \u0060profile.suggested_action\u0060 or a missing-profile attention item only when prime supplies one.\n\n### Attention items\n\nPriority order with severity arrows (SI1-SI4):\n\n- ⇶ (SI1) Critical issues, degrading health dimensions\n- ⇉ (SI2) Blocked/overdue plan tasks, stale artifacts, overdue health audits (prime \u0060health.stale=true\u0060), loop stop-condition triggers\n- → (SI3) Standard work: features, improvements, routine tasks\n- ⇢ (SI4) Unresolved exploratory decisions\n\nA clean bill of health is useful — say so when nothing is flagged.\n\n---\n\n## Routing suggestion\n\nThe routing suggestion MUST name the artifact item it would act on. A skill name without a concrete object is not a valid suggestion.\n\nValid objects: \u0060PLAN Task N: <title>\u0060, \u0060TODO: <item>\u0060, \u0060DECISION N follow-up\u0060, \u0060OBJECTIVE: <metric>\u0060, or \u0060VISION refresh\u0060.\n\n**Priority order** (SG codes are internal protocol references; never render them in user-facing handoff labels):\n\n- Active PLAN with pending tasks → suggest ⎈ orchestrate for the first unblocked pending task.\n- Critical or degrading health → suggest ⛶ audit or ⧉ build for the named finding.\n- Stale health audit (CLI \u0060health.stale=true\u0060) with no higher-priority work → suggest ⛶ audit for \u0060HEALTH: Audit N stale\u0060.\n- Active non-closed OBJECTIVE with stalled or missing metric evidence → suggest ⎘ optimize for that metric.\n- todo open items → select the highest-severity open item, then route by shape: narrow one-cycle todo items suggest ⧉ build; contract-shaped, multi-surface, dependency-heavy, migration, schema, metadata, validation, or acceptance-risky todo items suggest ≡ plan first. Prefer items that unlock product evidence or future plans.\n- Pending decisions follow-up → suggest ❈ discuss for the named unresolved decision.\n- Vision exists but no plan, objective, decision follow-up, or TODO work is active → suggest ≡ plan.\n- No vision, no executable follow-ups, and no active plan → suggest ⛥ vision to choose a direction.\n\nDo not let \u0060healthy + plan complete → ⛥\u0060 override active TODO, OBJECTIVE, DECISIONS, or a newer active PLAN. A completed plan means \"look for the next executable follow-up,\" not automatically \"refresh vision.\"\n\n### Routing posture\n\n- Present one concrete suggestion and let the user choose. Coercion MUST NOT occur.\n- Do not list generic skill options unless the user asks for the full menu.\n- The waiting bullet should ask whether to run the named action, not ask the user to pick from skills.\n- On the initial status brief, use a free-form continuation prompt rather than a native question menu unless the user asked for bounded choices or the suggested next step is a state-changing Proceed/Cancel handoff.\n- Mid-conversation, use the native question tool only for at least two meaningful non-terminal next actions or a consequential Proceed/Cancel decision; \u0060Done\u0060 and free-form/custom answer affordances do not count as alternatives.\n- State-changing handoffs are consequential Proceed/Cancel decisions even when there is only one suggested action. State-changing means the proposed next step may write artifacts, edit code, run optimization or orchestration cycles, apply migrations, refresh app/runtime state, or otherwise mutate project/runtime state.\n- Use the behavior rule first, with common examples such as ⧉ build, ≡ plan when creating or updating plans, ▤ document when writing docs, ⎘ optimize when running or applying optimization cycles, and ⎈ orchestrate when dispatching cycles.\n- For one non-mutating suggested action, clear free-form acceptance such as \u0060yes\u0060, \u0060start\u0060, \u0060do it\u0060, or \u0060run <capability>\u0060 confirms that suggestion. Ambiguous replies get one clarifying question.\n\nUnclear mapping? Ask **one** clarifying question. Compound questions MUST NOT occur.\n\n---\n\n## Safety rails\n\n<critical>\n- NEVER execute implementation work. Status orients and routes; it MUST NOT build, audit, plan, or decide.\n- NEVER dump full artifact contents verbatim. Summarize concisely; the user can read the files themselves.\n- NEVER skip the briefing in returning mode. The user needs context before choosing a direction.\n- NEVER assume what the user wants without asking. Present the suggestion, then wait for confirmation.\n- NEVER modify any state artifact. Status is strictly read-only.\n- NEVER route to a capability without the user's consent. Suggest, don't force.\n</critical>\n\n---\n\n## Exit signals\n\nReport one of these statuses at workflow completion (protocol refs: EX1-EX4).\n\nFormat: emit \u0060⌂ status · <status>\u0060 on its own line below the dashboard's closing code fence, followed by a one-sentence summary of what was delivered. For \u0060flagged\u0060 (EX2), \u0060stuck\u0060 (EX3), and \u0060waiting\u0060 (EX4), add a \u0060▸\u0060 (VT15) bullet below the summary identifying what the user needs to decide or act on next. The exit marker MUST appear on every invocation regardless of mode and uses status's canonical glyph \u0060⌂\u0060 (SG1, U+2302).\n\n- **complete** (EX1): Briefing delivered (or welcome shown in fresh mode) and user successfully routed to a capability.\n- **flagged** (EX2): Briefing delivered but critical attention items were found: critical issues, degrading health, loop stop-condition triggers. Each concern MUST be listed explicitly.\n- **stuck** (EX3): Cannot orient: the working directory is not a code project, no readable files exist, or permissions prevent scanning.\n- **waiting** (EX4): Briefing or welcome delivered, suggestion made, awaiting user input on which direction to take.\n\n---\n\n## Cross-capability integration\n\nStatus is the suite entry point. It reads other capabilities' artifacts, produces no artifact, and outputs only a briefing plus routing suggestion.\n"`);
+export const instructions = JSON.parse(String.raw `"# STATUS\n\n**Holistic Entry Junction. Orient, Route, Activate**\n\nSingle entry point to the agentera suite. Detects fresh vs returning, delivers a situational briefing, routes to the right capability. Same path on first install and the 100th session.\n\nGlyph: **⌂** (SG1). Status reads suite state through \u0060agentera prime\u0060 and writes nothing. A bare user message of exactly \u0060/agentera\u0060 invokes this capability; it does not fall back to conversational smalltalk.\n\nStatus MUST source both instructions and bounded state from \u0060agentera prime --context status --format json\u0060 and write nothing. Read \u0060capability_context.instructions\u0060 in full, render from \u0060capability_context.context.status_context\u0060, and use the one \u0060capability_context.startup\u0060 aggregation. Its outcome is \u0060ok\u0060, \u0060degraded\u0060, or \u0060blocked\u0060; \u0060status_context.outcome\u0060 is the same value. For deferred detail, run only that availability row\u0027s exact \u0060detail_command\u0060. An \u0060ok\u0060 startup needs no second prime call. Status MUST NOT raw-read \u0060.agentera/*.yaml\u0060.\n\n---\n\n## Dashboard rendering\n\nStatus owns the prime dashboard contract. SKILL.md and other surfaces delegate here.\n\n\u0060\u0060\u0060text\n┌─┐┌─┐┌─┐┌┐┌┌─┐┌─┐┬─┐┌─┐\n├─┤│ ┬├┤ │││ │ ├┤ ├┬┘├─┤\n┴ ┴└─┘└─┘┘└┘ ┴ └─┘┴└─┴ ┴\n\n─── status ─────────────────────────────\n\n  ⛶ health    [⮉|⮋] [grade] ([worst dimension: grade])\n  ⇶ todo      N critical · M degraded · J annoying\n  ≡ plan      [██████▓░░░] N/M tasks\n  ⎘ optim     [metric] [current] → [target]\n  ♾ profile   [loaded | not found]\n\n  [1-2 sentence narrative read: what shipped, what's moving, what needs eyes.\n  Interpretation, not metrics. Closes the status section before attention.]\n\n─── attention ──────────────────────────\n\n  ⇶ [critical items, triple arrow for critical]\n  ⇉ [degraded items, double arrow for degraded]\n  → [normal items, single arrow for normal]\n  ⇢ [annoying items, dashed arrow for annoying]\n\n─── next ───────────────────────────────\n\n  suggested → [glyph] [capability] ([reason])\n\u0060\u0060\u0060\n\nBuild the dashboard from \u0060agentera prime --format json\u0060 output. Source labels such as \u0060mode:\u0060, \u0060profile:\u0060, \u0060health:\u0060, \u0060todo:\u0060, \u0060plan:\u0060, \u0060objective:\u0060, \u0060attention:\u0060, \u0060next_action:\u0060, and the \u0060app.status\u0060 installed-app status object are parsing aids, not dashboard lines. Do not relay raw CLI lines as the user-facing briefing.\n\n**Output constraint**: ≤120 words total briefing, ≤15 words per routing suggestion.\n\n**Exit marker**: after the closing code fence of the dashboard, emit \u0060⌂ status · <status>\u0060 on its own line, followed by a one-sentence summary of what you delivered. For \u0060waiting\u0060, \u0060flagged\u0060, or \u0060stuck\u0060, add a \u0060▸\u0060 bullet below the summary identifying what the user needs to decide or act on next. The exit marker MUST appear on every invocation regardless of mode (fresh welcome or returning briefing).\n\n**Formatting rules**:\n- Each status line uses the skill glyph that owns that data\n- Severity arrows (VT5-VT8) mark attention items by urgency\n- Trend arrows (VT12/VT13) show health trajectory; derive ⮉/⮋ from \u0060health.degrading\u0060 (false→⮉, true→⮋); omit when no audit history\n- Progress bars (VT18) show plan completion visually\n- The inline separator (VT16) joins counts on a single line\n- Lead with status metrics, then the narrative read inside the status section\n- The narrative read is colleague interpretation; metric lines above it are evidence\n- The todo summary line lists critical, degraded, and annoying counts only; normal-priority items belong in attention with → (SI3), not on the summary line\n- Omit any line whose source artifact is missing\n- Omit any section that would be empty (e.g., no attention items = no attention section)\n\nVisual token IDs live in \u0060skills/agentera/protocol.yaml\u0060; see VT, SI, EX, SG, PH families.\n\n---\n\n## Briefing\n\nUse the \u0060mode\u0060 field from \u0060agentera prime\u0060 to detect fresh vs returning:\n\n- **Fresh** (\u0060mode: fresh\u0060): render welcome language; lead with the suggested capability from \u0060next_action\u0060. Do not enumerate the full suite unless asked.\n- **Returning** (\u0060mode: returning\u0060): render the dashboard template above using \u0060mode\u0060, \u0060profile\u0060, \u0060health\u0060, \u0060todo\u0060, \u0060plan\u0060, \u0060objective\u0060, \u0060attention\u0060, and \u0060next_action\u0060 fields.\n\nNarration voice: warm, brief, unscripted.\n\n### Project integration rendering\n\nWhen \u0060project_integration.recommendation\u0060 is \u0060upgrade\u0060:\n1. Render the plain-language \u0060project_integration.message\u0060.\n2. Show \u0060project_integration.dry_run_command\u0060 preview; state that it changes nothing.\n3. Ask before running \u0060project_integration.apply_command\u0060.\n\nWhen \u0060recommendation\u0060 is \u0060stay\u0060, do not suggest upgrade.\n\n### App status rendering\n\nRender \u0060app.status\u0060 as a status line only when it is not \u0060up_to_date\u0060. Use the plain-language \u0060project_integration.message\u0060 if present. Status MUST NOT teach install-recovery procedure — that belongs to the upgrade capability and \u0060agentera doctor\u0060.\n\n### Profile rendering\n\nRender \u0060profile.status\u0060 (\u0060loaded\u0060 or \u0060not found\u0060). Render \u0060profile.suggested_action\u0060 or a missing-profile attention item only when prime supplies one.\n\n### Attention items\n\nPriority order with severity arrows (SI1-SI4):\n\n- ⇶ (SI1) Critical issues, degrading health dimensions\n- ⇉ (SI2) Blocked/overdue plan tasks, stale artifacts, overdue health audits (prime \u0060health.stale=true\u0060), loop stop-condition triggers\n- → (SI3) Standard work: features, improvements, routine tasks\n- ⇢ (SI4) Unresolved exploratory decisions\n\nA clean bill of health is useful — say so when nothing is flagged.\n\n---\n\n## Routing suggestion\n\nThe routing suggestion MUST name the artifact item it would act on. A skill name without a concrete object is not a valid suggestion.\n\nValid objects: \u0060PLAN Task N: <title>\u0060, \u0060TODO: <item>\u0060, \u0060DECISION N follow-up\u0060, \u0060OBJECTIVE: <metric>\u0060, or \u0060VISION refresh\u0060.\n\n**Priority order** (SG codes are internal protocol references; never render them in user-facing handoff labels):\n\n- Active PLAN with pending tasks → suggest ⎈ orchestrate for the first unblocked pending task.\n- Critical or degrading health → suggest ⛶ audit or ⧉ build for the named finding.\n- Stale health audit (CLI \u0060health.stale=true\u0060) with no higher-priority work → suggest ⛶ audit for \u0060HEALTH: Audit N stale\u0060.\n- Active non-closed OBJECTIVE with stalled or missing metric evidence → suggest ⎘ optimize for that metric.\n- todo open items → select the highest-severity open item, then route by shape: narrow one-cycle todo items suggest ⧉ build; contract-shaped, multi-surface, dependency-heavy, migration, schema, metadata, validation, or acceptance-risky todo items suggest ≡ plan first. Prefer items that unlock product evidence or future plans.\n- Pending decisions follow-up → suggest ❈ discuss for the named unresolved decision.\n- Vision exists but no plan, objective, decision follow-up, or TODO work is active → suggest ≡ plan.\n- No vision, no executable follow-ups, and no active plan → suggest ⛥ vision to choose a direction.\n\nDo not let \u0060healthy + plan complete → ⛥\u0060 override active TODO, OBJECTIVE, DECISIONS, or a newer active PLAN. A completed plan means \"look for the next executable follow-up,\" not automatically \"refresh vision.\"\n\n### Routing posture\n\n- Present one concrete suggestion and let the user choose. Coercion MUST NOT occur.\n- Do not list generic skill options unless the user asks for the full menu.\n- The waiting bullet should ask whether to run the named action, not ask the user to pick from skills.\n- On the initial status brief, use a free-form continuation prompt rather than a native question menu unless the user asked for bounded choices or the suggested next step is a state-changing Proceed/Cancel handoff.\n- Mid-conversation, use the native question tool only for at least two meaningful non-terminal next actions or a consequential Proceed/Cancel decision; \u0060Done\u0060 and free-form/custom answer affordances do not count as alternatives.\n- State-changing handoffs are consequential Proceed/Cancel decisions even when there is only one suggested action. State-changing means the proposed next step may write artifacts, edit code, run optimization or orchestration cycles, apply migrations, refresh app/runtime state, or otherwise mutate project/runtime state.\n- Use the behavior rule first, with common examples such as ⧉ build, ≡ plan when creating or updating plans, ▤ document when writing docs, ⎘ optimize when running or applying optimization cycles, and ⎈ orchestrate when dispatching cycles.\n- For one non-mutating suggested action, clear free-form acceptance such as \u0060yes\u0060, \u0060start\u0060, \u0060do it\u0060, or \u0060run <capability>\u0060 confirms that suggestion. Ambiguous replies get one clarifying question.\n\nUnclear mapping? Ask **one** clarifying question. Compound questions MUST NOT occur.\n\n---\n\n## Safety rails\n\n<critical>\n- NEVER execute implementation work. Status orients and routes; it MUST NOT build, audit, plan, or decide.\n- NEVER dump full artifact contents verbatim. Summarize concisely; the user can read the files themselves.\n- NEVER skip the briefing in returning mode. The user needs context before choosing a direction.\n- NEVER assume what the user wants without asking. Present the suggestion, then wait for confirmation.\n- NEVER modify any state artifact. Status is strictly read-only.\n- NEVER route to a capability without the user's consent. Suggest, don't force.\n</critical>\n\n---\n\n## Exit signals\n\nReport one of these statuses at workflow completion (protocol refs: EX1-EX4).\n\nFormat: emit \u0060⌂ status · <status>\u0060 on its own line below the dashboard's closing code fence, followed by a one-sentence summary of what was delivered. For \u0060flagged\u0060 (EX2), \u0060stuck\u0060 (EX3), and \u0060waiting\u0060 (EX4), add a \u0060▸\u0060 (VT15) bullet below the summary identifying what the user needs to decide or act on next. The exit marker MUST appear on every invocation regardless of mode and uses status's canonical glyph \u0060⌂\u0060 (SG1, U+2302).\n\n- **complete** (EX1): Briefing delivered (or welcome shown in fresh mode) and user successfully routed to a capability.\n- **flagged** (EX2): Briefing delivered but critical attention items were found: critical issues, degrading health, loop stop-condition triggers. Each concern MUST be listed explicitly.\n- **stuck** (EX3): Cannot orient: the working directory is not a code project, no readable files exist, or permissions prevent scanning.\n- **waiting** (EX4): Briefing or welcome delivered, suggestion made, awaiting user input on which direction to take.\n\n---\n\n## Cross-capability integration\n\nStatus is the suite entry point. It reads other capabilities' artifacts, produces no artifact, and outputs only a briefing plus routing suggestion.\n"`);
 export default `${instructions
     .replaceAll("loaded | not found", "valid | absent | repair_needed")
     .replaceAll("loaded or not found", "valid, absent, or repair_needed")

package/dist/cli/commands/personalGlossaryCandidateReads.js

@@ -376,6 +376,17 @@ function projectionSummary(view) {
         source_families: report.source_families.map((family) => ({ ...family })),
         projects: { ...report.projects },
         coverage: { ...report.coverage, reasons: [...report.coverage.reasons] },
+        mining: {
+            ...report.mining_summary,
+            explicit: {
+                ...report.mining_summary.explicit,
+                abstentions_by_reason: { ...report.mining_summary.explicit.abstentions_by_reason },
+            },
+            recurring: {
+                ...report.mining_summary.recurring,
+                abstentions_by_reason: { ...report.mining_summary.recurring.abstentions_by_reason },
+            },
+        },
         abstentions: {
             candidate_selection: {
                 count: report.dropped_count,
@@ -444,7 +455,7 @@ function currentProjection(io, value, operation) {
             : {
                 class: "projection_unavailable",
                 message: "the current personal glossary candidate projection is unavailable or invalid",
-                recovery: "Create or repair a current bounded candidate projection, then retry; no projection bytes were changed.",
+                recovery: "Run `npx -y agentera@next report refresh --consent local-history`, then retry; no projection bytes were changed.",
             };
     failure(io, `${value.command} ${operation}`, operation === "list" ? listSyntax(value) : exactSyntax(value), operation === "list"
         ? `${value.command} list --limit ${value.defaultLimit} --format json`

package/dist/cli/commands/prime/briefOrientation.js

@@ -732,7 +732,7 @@ function degradedBody(payload, projection) {
         out.source = briefSource(payload.source);
     if ("docs" in payload)
         out.docs = briefDocs(payload.docs, projection);
-    for (const conditional of ["v1_migration", "objective"]) {
+    for (const conditional of ["objective"]) {
         if (conditional in payload)
             out[conditional] = payload[conditional];
     }

package/dist/cli/commands/prime/collectOrientationState.js

@@ -1,14 +1,12 @@
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
-import { detectV1ArtifactPairs } from "../../../upgrade/migrateArtifactsV2ToV3.js";
 import { summarizeProjectIntegration } from "../../../upgrade/projectIntegration.js";
 import { selectStatusReadiness, statePresence, } from "../../orientation.js";
 import { buildOrientationAttention } from "../../orientation/attention.js";
 import { corpusCoverageSummary } from "../../orientation/corpusCoverage.js";
 import { profileSignalsStatus } from "../../../analytics/profileSignals.js";
 import { statusBundleContext } from "./bundleStatus.js";
-import { v1MigrationSummary } from "./v1Migration.js";
 import { diagnoseCanonicalSkill } from "../../../setup/sharedSkill.js";
 import { collectEntityOrientation } from "./collectEntityOrientation.js";
 import { acquireProfile } from "../../profileAcquisition.js";
@@ -71,8 +69,6 @@ export function collectOrientationState(opts) {
     const boundedSignals = profileSignalsStatus(env, process.platform);
     const { tiers_dir: _tiersDir, signal_path: _signalPath, ...publicBoundedSignals } = boundedSignals;
     profileDict.bounded_signals = publicBoundedSignals;
-    const v1Artifacts = detectV1ArtifactPairs(project);
-    const v1Migration = v1MigrationSummary(v1Artifacts, { sourceRoot, home, env });
     const entity = collectEntityOrientation(project, sourceRoot);
     const cutover = stateCutover(project, sourceRoot);
     const plan = entity.plan;
@@ -101,7 +97,6 @@ export function collectOrientationState(opts) {
         resolvedChannel: channel,
         installClassification: install,
         successorAnnounced,
-        precomputedV1Artifacts: v1Artifacts,
     });
     const readiness = selectStatusReadiness(plan, health, objective, todoItems, decision, savedContext, entity.todoReadiness);
     const reconciliationReadiness = entity.todoReconciliation?.status === "action_required"
@@ -129,7 +124,6 @@ export function collectOrientationState(opts) {
         profile_dict: profileDict,
         profile_status: profileStatus,
         profile,
-        v1_migration: v1Migration,
         project_integration: projectIntegration,
         state_cutover: cutover,
         shared_skill: sharedSkill,
@@ -160,7 +154,6 @@ export function collectOrientationState(opts) {
         profile_dict: profileDict,
         profile_status: profileStatus,
         profile,
-        v1_migration: v1Migration,
         project_integration: projectIntegration,
         state_cutover: cutover,
         shared_skill: sharedSkill,

package/dist/cli/commands/prime/orientationOutput.js

@@ -58,7 +58,6 @@ export function projectPublicOrientationAttention(state) {
  *  still populates them, so explicit `--fields <name>` selection, the text
  *  briefing, and downstream state consumers are unaffected. */
 const OMITTABLE_DEFAULT_CONDITIONAL_TOP_FIELDS = [
-    "v1_migration",
     "docs",
     "objective",
 ];
@@ -73,10 +72,6 @@ function isConditionalFieldPresent(field, payload) {
     if (typeof value !== "object" || Array.isArray(value))
         return true;
     const obj = value;
-    // v1_migration: present when v1 artifacts are detected (detected !== true is
-    // the default state; recover via `agentera upgrade --dry-run`).
-    if (field === "v1_migration")
-        return obj.detected === true;
     // docs: present when a docs mapping artifact exists (exists !== true is the
     // absent state; recover via the canonical docs list command).
     if (field === "docs")
@@ -140,15 +135,14 @@ export function buildOrientationJsonPayload(state, command, options = {}) {
         ? "caller-owned README-style prime orientation dashboard"
         : "caller-owned README-style prime orientation dashboard";
     const access = command === "status"
-        ? "single installed CLI call; app/v1/profile safety included; no preflight glob/read/import/doctor calls during normal prime"
-        : "single installed CLI call; app/v1/profile safety included; no preflight glob/read/import/doctor calls during normal prime";
+        ? "single installed CLI call; app/reset/profile safety included; no preflight glob/read/import/doctor calls during normal prime"
+        : "single installed CLI call; app/reset/profile safety included; no preflight glob/read/import/doctor calls during normal prime";
     return {
         command,
         outcome: startup.outcome,
         app_home: appHome,
         app: bundlePublic,
         mode: state.mode,
-        v1_migration: state.v1_migration,
         shared_skill: state.shared_skill,
         project_integration: state.project_integration,
         ...(state.todo_reconciliation?.status === "action_required" ? { todo_reconciliation: state.todo_reconciliation } : {}),
@@ -263,7 +257,7 @@ export function emitPrime(command, payload, format, fieldsArg, out, err, options
         return retiredRejection;
     const requested = requestedFields(fieldsArg);
     // The default bare briefing first omits inactive conditional top-level fields
-    // (v1_migration/docs/objective when default) so startup does not carry
+    // (docs/objective when default) so startup does not carry
     // default-only payload, then — for the bare default only — projects the full
     // payload to a bounded decision brief (Plan Task 3). Explicit `--fields`
     // selection and `--context` use their governed payloads. Dashboard history is

package/dist/cli/commands/report.js

@@ -5,7 +5,8 @@ import { resolveProfileDirOverride, resolveXdgDataHome } from "../../core/envPat
 import { expanduser } from "../../core/paths.js";
 import { usageMain, corpusTooLargeReason } from "../../analytics/usageStats.js";
 import { extractCorpusMain } from "../../analytics/extractCorpus.js";
-import { tiersDirForCorpusPath, assessTiers, readBoundedMetadata, } from "../../analytics/extractCorpus/index.js";
+import { acquirePersonalGlossaryRefreshCommitLock, PersonalGlossaryRefreshCommitLockError, produceCurrentPersonalGlossaryProjection, releasePersonalGlossaryRefreshCommitLock, } from "../../analytics/personalGlossaryRefreshProjection.js";
+import { tiersDirForCorpusPath, assessTiers, readBoundedMetadata, readCurrentGeneration, } from "../../analytics/extractCorpus/index.js";
 function buildExtractArgv(args, corpusPath) {
     // Refresh publishes bounded evidence tiers to the directory co-located with
     // the canonical corpus path (`<dir>/tiers`); the extract engine no longer
@@ -222,13 +223,90 @@ export function cmdReport(args, io = {}) {
             return 0;
         }
         // consent === "local-history": extract local history into bounded tiers.
+        const tiersDir = tiersDirForCorpusPath(corpusPath);
+        let refreshLock;
+        try {
+            refreshLock = acquirePersonalGlossaryRefreshCommitLock();
+        }
+        catch (error) {
+            if (!(error instanceof PersonalGlossaryRefreshCommitLockError))
+                throw error;
+            const recovery = error.recovery;
+            const currentGeneration = readCurrentGeneration(tiersDir);
+            const projection = {
+                status: "failed",
+                reason: error.message,
+                recovery,
+            };
+            const payload = {
+                command: "stats refresh",
+                status: "fail",
+                exit_signal: null,
+                privacy: {
+                    local_history_read: false,
+                    local_history_write: false,
+                    tier_write: false,
+                    projection_write: false,
+                    required_consent: "local-history",
+                    provided_consent: "local-history",
+                    historical_imports: args.importSources ?? [],
+                    historical_import_warning: args.importSources?.includes("claude")
+                        ? "Claude transcripts can contain secrets, file contents, and command output. Import is local and read-only."
+                        : null,
+                },
+                corpus_path: corpusPath,
+                tier_path: tiersDir,
+                evidence: {
+                    status: currentGeneration ? "readable" : "unavailable",
+                    ...(currentGeneration ? {
+                        generation: currentGeneration.manifest.generation,
+                        published_at: currentGeneration.manifest.published_at,
+                    } : {}),
+                },
+                projection,
+                engine: { command: engineCommand, exit_code: null, stdout: [], stderr: [] },
+            };
+            if (outputFormat === "json") {
+                out(JSON.stringify(payload, null, 2) + "\n");
+            }
+            else {
+                out(`agentera stats refresh: fail\ncorpus=${corpusPath}\ntiers=${tiersDir}\n`);
+                err(`candidate projection failed: ${projection.reason}\nRecovery: ${recovery}\n`);
+            }
+            return 1;
+        }
         let engineOut = "";
         let engineErr = "";
-        const rc = extractCorpusMain(engineArgv, {
-            out: (t) => (engineOut += t + "\n"),
-            err: (t) => (engineErr += t + "\n"),
-        });
-        const refreshStatus = rc === 0 ? "pass" : rc === 4 ? "flagged" : "fail";
+        let rc;
+        let projection = { status: "not_attempted" };
+        let finalRc;
+        let currentGeneration;
+        try {
+            rc = extractCorpusMain(engineArgv, {
+                out: (t) => (engineOut += t + "\n"),
+                err: (t) => (engineErr += t + "\n"),
+            });
+            finalRc = rc;
+            currentGeneration = rc === 0 ? readCurrentGeneration(tiersDir) : null;
+            if (rc === 0) {
+                try {
+                    const produced = produceCurrentPersonalGlossaryProjection({ tiersDir });
+                    projection = { ...produced, write_status: produced.status, status: "published" };
+                }
+                catch (error) {
+                    finalRc = 1;
+                    projection = {
+                        status: "failed",
+                        reason: error.message,
+                        recovery: "npx -y agentera@next report refresh --consent local-history",
+                    };
+                }
+            }
+        }
+        finally {
+            releasePersonalGlossaryRefreshCommitLock(refreshLock);
+        }
+        const refreshStatus = finalRc === 0 ? "pass" : rc === 4 ? "flagged" : "fail";
         const payload = {
             command: "stats refresh",
             status: refreshStatus,
@@ -237,6 +315,7 @@ export function cmdReport(args, io = {}) {
                 local_history_read: true,
                 local_history_write: false,
                 tier_write: rc === 0,
+                projection_write: projection.status === "published",
                 required_consent: "local-history",
                 provided_consent: "local-history",
                 historical_imports: args.importSources ?? [],
@@ -245,7 +324,15 @@ export function cmdReport(args, io = {}) {
                     : null,
             },
             corpus_path: corpusPath,
-            tier_path: tiersDirForCorpusPath(corpusPath),
+            tier_path: tiersDir,
+            evidence: {
+                status: rc === 0 ? "published" : "failed",
+                ...(currentGeneration ? {
+                    generation: currentGeneration.manifest.generation,
+                    published_at: currentGeneration.manifest.published_at,
+                } : {}),
+            },
+            projection,
             engine: { command: engineCommand, exit_code: rc, stdout: engineOut.split("\n").filter((l) => l), stderr: engineErr.split("\n").filter((l) => l) },
         };
         if (outputFormat === "json") {
@@ -257,8 +344,11 @@ export function cmdReport(args, io = {}) {
                 out(engineOut);
             if (engineErr)
                 err(engineErr);
+            if (projection.status === "failed") {
+                err(`candidate projection failed: ${String(projection.reason)}\nRecovery: ${String(projection.recovery)}\n`);
+            }
         }
-        return rc;
+        return finalRc;
     }
     if (action !== null) {
         err(`Error: unsupported stats action '${action}'. ` +

package/dist/cli/commands/upgrade.js

@@ -3,6 +3,7 @@ import { renderVerifySummary, verifyOneWayUpgrade, verifyUpgrade, } from "./upgr
 import { detectStateMode } from "../../state/stateMode.js";
 import { UpgradeLockError } from "../../upgrade/upgradeLock.js";
 import { fullEntityUpgradeCommand } from "../../upgrade/upgradeCommands.js";
+import { applyProductV1Reset, previewProductV1Reset } from "../../upgrade/productV1Reset.js";
 /** Canonical stable-channel update entry point. */
 export const UPGRADE_COMMAND = "npx -y agentera@latest";
 function toOrchestratorArgs(args) {
@@ -54,6 +55,35 @@ export function cmdUpgrade(args, io = {}, dependencies = {}) {
     const out = io.out ?? ((t) => process.stdout.write(t));
     const err = io.err ?? ((t) => process.stderr.write(t));
     const orchestratorArgs = toOrchestratorArgs(args);
+    if (args.productV1Reset) {
+        const options = { project: args.project, installRoot: args.installRoot, home: args.home };
+        const result = args.yes
+            ? applyProductV1Reset(options, args.authorization ?? "")
+            : previewProductV1Reset(options);
+        if (args.format === "json")
+            out(JSON.stringify(result, null, 2) + "\n");
+        else if ("deletions" in result) {
+            const lines = ["Product-v1 reset preview (no mutation)", `Authorization: ${result.authorization}`, "Roots:"];
+            for (const [name, root] of Object.entries(result.roots))
+                lines.push(`  ${name}: ${root}`);
+            lines.push("Deletions:");
+            for (const item of result.deletions)
+                for (const target of item.targets) {
+                    lines.push(`  ${item.id}: ${target.path ?? target.declared}${target.selector ? ` (${target.selector.kind}:${target.selector.value})` : ""}`);
+                    for (const entry of target.entries ?? [])
+                        lines.push(`    ${entry.type}: ${entry.path}`);
+                }
+            lines.push("Recreations:");
+            for (const item of result.recreations)
+                for (const target of item.targets)
+                    lines.push(`  ${item.id}: ${target.declared} under ${item.root}`);
+            lines.push("Irreversible loss:", ...result.irreversible_loss.map((loss) => `  ${loss}`));
+            out(lines.join("\n") + "\n");
+        }
+        else
+            out(`Product-v1 reset complete: ${result.authorization}\nFresh v3 state initialized.\n`);
+        return 0;
+    }
     if (orchestratorArgs.runtime) {
         err(`upgrade error: --runtime ${orchestratorArgs.runtime} is retired; Agentera now uses the shared skill at ` +
             "~/.agents/skills/agentera plus the CLI. Remove --runtime and rerun. " +

package/dist/cli/dispatch/index.js

@@ -13,6 +13,7 @@ import { emitInvalidInput } from "../errors.js";
 import { verbsForArtifact } from "../../state/write/operations.js";
 import { REMOVED_TOP_LEVEL_CORRECTIONS } from "../commands/schema.js";
 import { enforceCompletedEntityCutover, migrationProject, requestedMigrationFailureFormat, requiresCompletedEntityCutover, } from "../migrationRequired.js";
+import { enforceProductV1Eol } from "../productV1Eol.js";
 export function main(argv, io = {}) {
     const err = io.err ?? ((t) => process.stderr.write(t));
     const out = io.out ?? ((t) => process.stdout.write(t));
@@ -59,6 +60,12 @@ export function main(argv, io = {}) {
             },
         });
     }
+    const productV1Reset = command === "upgrade" && rest.includes("--reset-product-v1");
+    if (command !== "--version" && command !== "version" && !productV1Reset) {
+        const failure = enforceProductV1Eol(migrationProject(args), requestedMigrationFailureFormat(args), io);
+        if (failure !== null)
+            return failure;
+    }
     // Retained-reference validation audits package source, not project state. It
     // must report its source-checkout boundary before project migration checks.
     const sourceOnlyReferenceValidation = args[0] === "check" && args[1] === "validate" && ["retained-references", "activation-conjunction"].includes(args[2] ?? "");

package/dist/cli/dispatch/lifecycle.js

@@ -263,6 +263,8 @@ export function runUpgrade(argv, io, prog) {
         runtime: null,
         legacyCleanup: null,
         format: "text",
+        productV1Reset: false,
+        authorization: null,
     };
     let jsonFlag = false;
     let i = 0;
@@ -311,6 +313,12 @@ export function runUpgrade(argv, io, prog) {
             }
             args.legacyCleanup = selectedResource.id;
         }
+        else if (a === "--reset-product-v1") {
+            args.productV1Reset = true;
+        }
+        else if ((v = value("--authorization")) !== null) {
+            args.authorization = v;
+        }
         else if ((v = value("--only")) !== null) {
             if (v !== "artifacts" && v !== "runtime" && v !== "cleanup") {
                 return emitInvalidInput(io, {
@@ -365,6 +373,18 @@ export function runUpgrade(argv, io, prog) {
     }
     if (jsonFlag)
         args.format = "json";
+    if (args.productV1Reset) {
+        const incompatible = args.channel !== null || (args.only?.length ?? 0) > 0 || args.force || args.verify || args.legacyCleanup !== null;
+        if (incompatible || args.dryRun === args.yes || (args.yes && !args.authorization) || (!args.yes && args.authorization)) {
+            return emitInvalidInput(io, {
+                format: asEnvelopeFormat(args.format),
+                body: {
+                    class: "invalid_request",
+                    message: "product-v1 reset requires either --dry-run preview or --yes --authorization TOKEN apply, without other upgrade modes",
+                },
+            });
+        }
+    }
     try {
         return cmdUpgrade(args, io);
     }

package/dist/cli/help.js

@@ -54,7 +54,8 @@ export function printUpgradeHelp() {
     return [
         "usage: agentera upgrade [-h] [--project PROJECT] [--install-root INSTALL_ROOT]",
         "                        [--home HOME] [--channel {stable,development}]",
-        "                        [--legacy-cleanup RESOURCE_ID]",
+        "                        [--legacy-cleanup RESOURCE_ID] [--reset-product-v1]",
+        "                        [--authorization TOKEN]",
         "                        [--only {artifacts,runtime,cleanup}] [--dry-run] [--yes]",
         "                        [--force] [--verify] [--format {text,json}]",
         "",
@@ -65,9 +66,11 @@ export function printUpgradeHelp() {
         "  --home HOME           Home directory for shared-skill detection and explicit native resource cleanup",
         "  --channel CHANNEL     Update channel: stable (2.x) or development (3.x npm)",
         "  --legacy-cleanup ID   Select one declared native Agentera resource for cleanup",
+        "  --reset-product-v1    Preview or authorize the bounded destructive product-v1 reset",
+        "  --authorization TOKEN Bind product-v1 apply to the exact reviewed preview scope",
         "  --only PHASE          Upgrade phase to include; may be repeated",
         "  --dry-run             Strict read-only preview; no files, locks, caches, native commands, or telemetry",
-        "  --yes                 Explicitly approve app/project migration or selected legacy cleanup",
+        "  --yes                 Explicitly approve migration, selected cleanup, or an authorized product-v1 reset",
         "  --force               Replace only where the migration contract explicitly permits it",
         "  --verify              Verify the current install; full v2-to-v3 apply verifies state and startup automatically",
         "  --format {text,json}  Structured output format",
@@ -83,6 +86,10 @@ export function printUpgradeHelp() {
         "  Current runtime selectors and native plugin, hook, agent, command, descriptor, and marketplace writes are retired.",
         `  Native resource cleanup preview: ${preCutoverCommand("upgrade --legacy-cleanup RESOURCE_ID --dry-run")}`,
         `  Native resource cleanup apply:   ${preCutoverCommand("upgrade --legacy-cleanup RESOURCE_ID --yes")}`,
+        "",
+        "product-v1 reset (irreversible, no backup or restore):",
+        `  Preview: ${preCutoverCommand("upgrade --reset-product-v1 --dry-run --format json")}`,
+        `  Authorize: ${preCutoverCommand("upgrade --reset-product-v1 --yes --authorization TOKEN --format json")}`,
     ].join("\n");
 }
 export function printAppHomeHelp() {
@@ -183,7 +190,7 @@ export function printStateHelp(sub) {
             "",
             "Build-owned publication validates one audit terminology proposal and proposal-specific user confirmation.",
             "The writer revalidates cited source lines and atomically records a separate immutable approval and shared glossary entry.",
-            "Confirmed project variants are enforced by the v1LegacyCruft validation guard; profile and docs-mapping mutation remain outside publication.",
+            "Confirmed project variants are enforced by the glossary variant guard; profile and docs-mapping mutation remain outside publication.",
             "Audit and discuss remain mutation-free. Discuss, Plan, and Build use read-only glossary advice with project precedence, proven-gap personal fallback, and host review for inferred equivalence.",
             "",
             "Discover writes: agentera state glossary explain --verb publish --format json",

package/dist/cli/orientation/attention.js

@@ -3,7 +3,7 @@ import { corpusCoverageAttention } from "./corpusCoverage.js";
 import { firstPresent } from "../stateQuery.js";
 import { TODO_SEVERITY_ORDER } from "../todoSeverity.js";
 export function buildOrientationAttention(state) {
-    const { v1_migration: v1Migration, project_integration: projectIntegration, health, plan, decision_attention: decisionAttention, glossary_caveat_attention: glossaryCaveatAttention, corpus_coverage: corpusCoverage, todo_items: todoItems, todo_reconciliation: todoReconciliation, } = state;
+    const { project_integration: projectIntegration, health, plan, decision_attention: decisionAttention, glossary_caveat_attention: glossaryCaveatAttention, corpus_coverage: corpusCoverage, todo_items: todoItems, todo_reconciliation: todoReconciliation, } = state;
     const attention = [];
     if (todoReconciliation?.status === "action_required") {
         const label = todoReconciliation.state === "inactive" ? "inactive" : todoReconciliation.state === "unsafe_inactive" ? "unsafe inactive" : todoReconciliation.state === "unsafe_active" ? "unsafe active" : "invalid lifecycle";
@@ -25,9 +25,6 @@ export function buildOrientationAttention(state) {
     if (coverageAttention) {
         attention.push(coverageAttention);
     }
-    if (v1Migration.detected && projectIntegration.recommendation !== "upgrade") {
-        attention.push(`degraded: v1 artifacts detected; preview \`${v1Migration.dry_run_command}\`; files=${v1Migration.affected_files.join(", ")}`);
-    }
     if (health.stale) {
         const auditId = health.id ?? "unknown";
         const daysSince = health.days_since_audit ?? "?";

package/dist/cli/productV1Eol.js

@@ -0,0 +1,55 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { resolveCandidate } from "../state/installRoot.js";
+import { isProductV1PackageVersion, loadProductV1ResetAuthority, } from "../upgrade/productV1ResetAuthority.js";
+import { emitStructured } from "./structured.js";
+const authority = loadProductV1ResetAuthority();
+function installedProductV1Evidence() {
+    const [installRoot] = resolveCandidate(null, { env: process.env, home: os.homedir() });
+    const manifest = path.join(installRoot, authority.installationPackage.manifest);
+    if (!fs.existsSync(manifest))
+        return null;
+    try {
+        const registry = JSON.parse(fs.readFileSync(manifest, "utf8"));
+        const version = registry.skills?.[0]?.version;
+        return typeof version === "string" && isProductV1PackageVersion(version) ? manifest : null;
+    }
+    catch {
+        return null;
+    }
+}
+export function productV1Evidence(projectRoot) {
+    const evidence = authority.projectArtifacts
+        .filter(({ triggersReset, path: relativePath }) => triggersReset && fs.existsSync(path.join(projectRoot, relativePath)))
+        .map(({ path: relativePath }) => path.join(projectRoot, relativePath));
+    const installation = installedProductV1Evidence();
+    if (installation)
+        evidence.push(installation);
+    return evidence;
+}
+/** Read-only EOL gate. */
+export function enforceProductV1Eol(projectRoot, format, io = {}) {
+    const evidence = productV1Evidence(path.resolve(projectRoot));
+    if (evidence.length === 0)
+        return null;
+    const error = {
+        class: "product_v1_eol",
+        message: "Agentera product v1 is end-of-life and cannot be used by the v3 CLI.",
+        evidence,
+        reset_workflow: [
+            "Run agentera upgrade --reset-product-v1 --dry-run --format json.",
+            "Review every deletion, recreation, and irreversible loss in that preview.",
+            "Explicitly approve apply to remove scoped Agentera state and initialize fresh v3 state.",
+        ],
+        recovery: "Preview the product-v1 reset, then apply with --yes and the preview authorization; this command did not change state.",
+    };
+    if (format === "json" || format === "yaml") {
+        emitStructured({ schemaVersion: "agentera.stateFailure.v1", status: "fail", error }, format, io.out ?? ((text) => process.stdout.write(text)));
+    }
+    else {
+        const err = io.err ?? ((text) => process.stderr.write(text));
+        err(`Error: ${error.message}\nReset workflow: ${error.reset_workflow.join(" ")}\nRecovery: ${error.recovery}\n`);
+    }
+    return 1;
+}

package/dist/cli/startupCompletenessContract.js

@@ -3,7 +3,6 @@ export const STARTUP_AVAILABLE_STATE_FIELDS = [
     "app_home",
     "mode",
     "profile",
-    "v1_migration",
     "health",
     "todo",
     "plan",

package/dist/cli/stateQuery.js

@@ -29,7 +29,7 @@ export const ROUTINE_STRUCTURED_FIELDS = [
  *  `state_presence` (missing-vs-empty) and named recovery commands, not by
  *  trimming this set. */
 export const PRIME_STRUCTURED_FIELDS = [
-    "command", "outcome", "app_home", "app", "mode", "v1_migration", "health",
+    "command", "outcome", "app_home", "app", "mode", "health",
     "todo", "plan", "docs", "progress", "objective", "state_presence", "shared_skill", "project_integration", "attention",
     "history",
     "decision_attention", "next_action", "orchestration_context", "closeout_context",

package/dist/registries/activationTuples.js

@@ -81,6 +81,15 @@ const addedTuples = [
     { class: "package", surface_id: "emitted:packages/cli/src/cli/commands/doctor.ts", owner_path: "packages/cli/src/registries/packageRegistry.ts", owner_symbol_or_selector: "loadRegistry", owner_selector: "packages/cli/src/cli/commands/doctor.ts", semantic_selector_if_any: JSON.stringify({ path: "packages/cli/src/cli/commands/doctor.ts", selector: null, format: null, classification: null, reason: "Doctor project-state signals publish bounded reconciliation preview and apply guidance." }), canonical_correction: "pnpm -C packages/cli run verify:package" },
     { class: "package", surface_id: "emitted:packages/cli/src/state/todoReconciliationInspection.ts", owner_path: "packages/cli/src/registries/packageRegistry.ts", owner_symbol_or_selector: "loadRegistry", owner_selector: "packages/cli/src/state/todoReconciliationInspection.ts", semantic_selector_if_any: JSON.stringify({ path: "packages/cli/src/state/todoReconciliationInspection.ts", selector: null, format: null, classification: null, reason: "TODO reconciliation inspection publishes bounded preview and effect-bound apply guidance." }), canonical_correction: "pnpm -C packages/cli run verify:package" },
     { class: "package", surface_id: "generated:build-source-identity", owner_path: "packages/cli/src/registries/packageRegistry.ts", owner_symbol_or_selector: "loadRegistry", owner_selector: ".agentera-build-source.json", semantic_selector_if_any: JSON.stringify({ path: ".agentera-build-source.json", selector: null, format: "json", classification: "active", reason: "Build-generated source identity binds constructed dist and bundle output to one Git commit, tree, and exact working-tree digest; no source copy exists." }), canonical_correction: "pnpm -C packages/cli run verify:package" },
+    {
+        class: "reference",
+        surface_id: "references/adapters/product-v1-reset.yaml",
+        owner_path: "packages/cli/src/upgrade/productV1ResetAuthority.ts",
+        owner_symbol_or_selector: "loadProductV1ResetAuthority",
+        owner_selector: "references/adapters/product-v1-reset.yaml",
+        semantic_selector_if_any: null,
+        canonical_correction: "node packages/cli/dist/bin/agentera.js check validate retained-references --format json",
+    },
     {
         class: "reference",
         surface_id: "references/analysis/personal-glossary-evaluation-authority.yaml",
@@ -123,12 +132,12 @@ export const ACTIVATION_TUPLE_AUTHORITY = Object.freeze({
         cli: { count: 27, sha256: "9d0db6cafe592da30ea3469c91dc514bdd1b3b22e8229a0519e680cbcb01c2fa" },
         capability: { count: 12, sha256: "892e6e5e2a57b41064bc44fa2946453225f1b1195aff77aad05365fd0a1071c2" },
         runtime: { count: 81, sha256: "99b2abff3ebff889b54b1781c563ab4b32609a479c4e90d6aad854f48fba7edc" },
-        reference: { count: 25, sha256: "2a40b8a8585933417a6e66a350c9ad68050288600cdac1e7f44b914e7022565c" },
+        reference: { count: 26, sha256: "0daf0d131217064bb66d667be2b88c81bf928369fac321bce8023c9039d9ddfe" },
         state: { count: 38, sha256: "697de8dcd13ac521124c35058ba222aa5cb6cae546f00bb54652ceaca4b662aa" },
         package: { count: 67, sha256: "5dbe325af5ffb29a1ea50534070d08fcff647d4d9ef5654b4ce03d76eeaa8adb" },
         bootstrap: { count: 34, sha256: "9a7dd7e27110d85cf5c08835fdd8f08119e75579858e63bc6d396c733961d0bc" },
     },
-    total: { count: 284, sha256: "6b0d109f9d833598dcd1ec5b21cbc57e80ee8f21a0e5b61ca8aa420c6d32eb60" },
+    total: { count: 285, sha256: "3be47d6d1928df8b7f16d494aaa57939404d690b35ef81254f2c62506fd5f984" },
 });
 export function canonicalTupleJson(value) { return JSON.stringify(value); }
 export function digestCanonicalTuples(values) {