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

package/bundle/references/adapters/product-v1-reset.yaml

@@ -0,0 +1,101 @@
+schema_version: agentera.productV1ResetInventory.v1
+status: product_v1_eol
+policy:
+  trigger: any_declared_product_v1_generation_evidence
+  schema_identifier_suffix_is_evidence: false
+  discovery: declared_roots_only
+  preserve_unlisted_state: true
+
+source_authorities:
+  retired_resources: references/adapters/runtime-retired-resources.yaml
+  package_inventory: references/adapters/package-registry.yaml
+  runtime_lifecycle: references/adapters/runtime-lifecycle-authority.yaml
+
+trigger_evidence:
+  project_artifacts:
+    - id: project.progress_markdown
+      generation: product_v1
+      triggers_reset: true
+      path: .agentera/PROGRESS.md
+      current_path: .agentera/progress.yaml
+    - id: project.plan_markdown
+      generation: product_v1
+      triggers_reset: true
+      path: .agentera/PLAN.md
+      current_path: .agentera/plan.yaml
+    - id: project.decisions_markdown
+      generation: product_v1
+      triggers_reset: true
+      path: .agentera/DECISIONS.md
+      current_path: .agentera/decisions.yaml
+    - id: project.health_markdown
+      generation: product_v1
+      triggers_reset: true
+      path: .agentera/HEALTH.md
+      current_path: .agentera/health.yaml
+    - id: project.docs_markdown
+      generation: product_v1
+      triggers_reset: true
+      path: .agentera/DOCS.md
+      current_path: .agentera/docs.yaml
+    - id: project.design_markdown
+      generation: product_v1
+      triggers_reset: true
+      path: .agentera/DESIGN.md
+      current_path: .agentera/design.yaml
+    - id: project.vision_markdown
+      generation: product_v1
+      triggers_reset: false
+      path: VISION.md
+      current_path: .agentera/vision.yaml
+  installation_package:
+    id: installation.package-major-1
+    generation: product_v1
+    triggers_reset: true
+    authority: references/adapters/package-registry.yaml
+    manifest: registry.json
+    selector: skills[0].version
+    predicate: semver_major_equals_1
+  runtime_resources:
+    authority: references/adapters/runtime-retired-resources.yaml
+    role: reset_scope_only
+    reason: Runtime identities also existed in supported v2, so identity or content alone cannot prove product v1.
+
+scope_inventory:
+  - id: project.state
+    action: delete
+    owner: project_state_reset
+    bounded_root: project
+    targets: [.agentera, TODO.md, VISION.md]
+  - id: profile.state
+    action: delete
+    owner: profile_state_reset
+    bounded_root: profile_root
+    targets: [.]
+  - id: installation.state
+    action: delete
+    owner: installation_state_reset
+    bounded_root: install_root
+    targets: [.]
+  - id: runtime.resources
+    action: delete
+    owner: runtime_retired_resource_reset
+    bounded_root: runtime_declared_roots
+    targets:
+      - "references/adapters/runtime-retired-resources.yaml#diagnostic_inventory"
+      - "references/adapters/runtime-retired-resources.yaml#configuration_inventory"
+  - id: project.fresh-v3
+    action: recreate
+    owner: canonical_fresh_v3_initializer
+    bounded_root: project
+    targets: [.agentera]
+  - id: installation.current-package
+    action: recreate
+    owner: package_inventory_installer
+    bounded_root: install_root
+    targets: ["references/adapters/package-registry.yaml#records[agentera].bundle_surfaces"]
+  - id: runtime.canonical-skill
+    action: recreate
+    owner: runtime_lifecycle_installer
+    bounded_root: runtime_declared_roots
+    targets: ["references/adapters/runtime-lifecycle-authority.yaml#canonical_skill"]

package/bundle/references/artifacts/glossary-entry-contract.yaml

@@ -59,6 +59,17 @@ term_occurrence:
 
 personal_mining_authority:
   status: active_partial
+  design_proposal_reconciliation:
+    proposal: docs/notes/personal-glossary-mining-design.md
+    proposal_authority: non_authoritative_external_note_not_tracked_in_this_checkout
+    implementation_status: shipped_with_inferred_admission_deferred
+    shipped:
+      - consented_refresh_produces_generation_bound_candidate_projection
+      - fixed_key_aggregate_candidate_and_abstention_explanations
+      - profile_full_preserves_existing_glossary_before_authorized_publication
+    deferred:
+      - inferred_automatic_admission
+    canonical_status: this_contract
   implementation_boundary: >-
      This section settles personal glossary mining identity, evidence provenance,
       consent, privacy, lifecycle, bounded explicit-discovery, public receipt construction,
@@ -67,7 +78,9 @@ personal_mining_authority:
        validation of host semantic evidence, explicit authorized personal
        publication, and Profile Full integration. It does not perform host
        semantic classification, project or public-state candidate reads, or
-       project glossary integration.
+       project glossary integration. The consented refresh command is the shipped
+       projection producer. Inferred candidates remain review-required or abstain;
+       they are not automatically admitted.
   preserved_decisions: [prmnztjytv, mcsmqqitnm, zyvgyvjnsv]
   replacement:
     shared_primitive: shared_primitive
@@ -544,10 +557,25 @@ personal_mining_authority:
         outcomes: ordinary_permissions_and_io
         same_user_path_manipulation: outside_agentera_threat_model
         symlink_confinement: not_claimed
+        malformed_candidate_projection_replacement_exception:
+          scope: malformed_candidate_projection_replacement_only
+          authorization: explicit_consented_refresh_only
+          precondition: existing_owned_regular_file_is_malformed
+          target: exact_configured_candidate_projection_file
+          inspection: lstat_exact_target_without_following_symlinks
+          required_type: regular_file
+          reject: [symlink, non_regular_file, configured_path_mismatch, path_escape]
+          operation: atomic_regular_file_replacement
+          outside_scope: configured_path_use_as_provided
         rule: >-
           Agentera uses the configured profile path as provided. The host
           filesystem owns permissions, symlink behavior, and same-user path
-          manipulation. Agentera does not add realpath or no-follow confinement.
+          manipulation. Agentera does not add realpath or no-follow confinement
+          except when an explicit consented refresh replaces its malformed
+          candidate projection. That operation inspects only the exact configured
+          target without following a final symlink, requires a regular file, and
+          rejects symlinks, non-files, target mismatches, and path escapes. All
+          other operations keep the configured-path behavior above.
       rule: >-
         Agentera deliberately selects only the configured user profile path for
         mining records. It never selects .agentera, TODO.md, progress, the
@@ -719,7 +747,71 @@ personal_mining_authority:
        candidate_retrieval operation. It does not add project or public-state
        candidate reads, host classification, CLI admission, review-disposition
        writes, profile publication, project-glossary access, or project-state
-       effects.
+        effects.
+    refresh_production:
+      status: active
+      runtime: packages/cli/src/analytics/personalGlossaryRefreshProjection.ts#produceCurrentPersonalGlossaryProjection
+      trigger: explicit_consented_evidence_refresh_success
+      projection:
+        count: exactly_one
+        generation_binding: exact_published_evidence_generation
+        policy_binding: exact_personal_mining_policy_version
+      concurrency:
+        serialization: profile_local_exclusive_refresh_commit
+        lock_lifetime: before_evidence_publication_through_projection_binding_verification
+        ownership:
+          record: exact_regular_file_with_pid_random_token_and_creation_time
+          publication: prewritten_record_hard_linked_to_exclusive_canonical_path
+          inspection: no_follow_regular_file_with_stable_filesystem_identity
+          liveness: only_esrch_proves_owner_death
+          pid_reuse: live_or_indeterminate_pid_fails_closed
+          reclaim: one_exclusive_identity_checked_claim_replaces_only_a_proven_dead_owner
+          release: matching_token_record_and_filesystem_identity_only
+          unsafe: [malformed, foreign, symlink, non_file, changed_identity, indeterminate_owner]
+          recovery: inspect_exact_profile_local_lock_and_remove_only_after_verifying_no_refresh_owns_it_then_rerun_consented_refresh
+        contender:
+          refresh_outcome: failure
+          process_exit: nonzero
+          local_history_read: false
+          tier_write: false
+          projection_status: failed
+          projection_write: false
+          evidence_status: current_generation_remains_readable
+          recovery: npx -y agentera@next report refresh --consent local-history
+      partial_failure:
+        refresh_outcome: failure
+        process_exit: nonzero
+        evidence_status: published
+        projection_status: failed
+        tier_write_reporting: evidence_published_projection_not_written
+        current_generation: published_evidence_remains_current
+      safe_replacement:
+        authorization: explicit_consented_refresh_only
+        target: exact_configured_candidate_projection_file
+        precondition: existing_owned_regular_file_is_malformed
+        operation: atomic_regular_file_replacement
+        reject: [symlink, non_regular_file, configured_path_mismatch, path_escape]
+        filesystem_exception: personal_mining_authority.privacy.storage.filesystem.malformed_candidate_projection_replacement_exception
+        replaceable_state: [candidate_projection]
+        preserved_state:
+          - current_evidence_generation
+          - review_records
+          - personal_profile
+          - project_state
+          - project_glossary
+      rule: >-
+        A successful consented evidence refresh requires one projection bound to
+        that exact published generation and mining policy. Projection failure is
+        a nonzero refresh result but does not roll back the published evidence.
+        Authorized refreshes serialize evidence and projection commit; a
+        contender fails without reading history or writing evidence or projection.
+        The documented consented refresh reclaims a valid orphan only after owner
+        death is proven. Unknown ownership fails closed, and release removes only
+        the caller's unchanged token and filesystem identity.
+        A retry may replace only the exact configured owned regular projection
+        file; it rejects symlinks, non-files, path mismatches, and path escapes.
+        The refresh runtime mines and publishes this projection after evidence
+        publication succeeds.
     selection:
       candidates_max: 50
       project_ids_max_per_candidate: 100
@@ -742,7 +834,68 @@ personal_mining_authority:
         Each selection round prefers the represented source family with the
         fewest retained candidates, then the candidate whose represented project
         has the fewest retained candidates. A capped or uncovered family or
-        project reports degraded coverage with retained and dropped counts.
+         project reports degraded coverage with retained and dropped counts.
+    mining_summary:
+      schema_version: agentera.personalGlossaryMiningSummary.v1
+      location: report.mining_summary
+      family_fields: [candidate_count, abstention_count, abstentions_by_reason]
+      explicit_abstention_keys:
+        - attributed_quotation
+        - ambiguous_reference
+        - conflicting_meaning
+        - empty_meaning
+        - empty_term
+        - example_context
+        - hypothetical_definition
+        - malformed_span
+        - meaning_bound_exceeded
+        - negated_definition
+        - indirect_question
+        - future_definition
+        - project_only_scope
+        - question_definition
+        - retracted_definition
+        - sarcasm_marker
+        - stale_anchor
+        - structural_fragment
+        - term_bound_exceeded
+        - unsafe_syntax
+        - uncertain_scope
+        - unresolved_anchor
+        - provenance_incomplete
+        - user_authorship_required
+      recurring_abstention_keys:
+        - agent_only_evidence
+        - copied_content
+        - provenance_missing
+        - insufficient_independent_origins
+        - insufficient_projects
+        - insufficient_sessions
+        - conversation_evidence_incomplete
+        - conversation_evidence_bound_exceeded
+        - project_only_scope
+        - noise_term
+        - too_many_qualifying_origins
+        - user_authorship_required
+      reconciliation:
+        fixed_keys: all_keys_present_as_nonnegative_integers
+        family_abstentions: abstention_count_equals_sum_of_reason_counts
+        total_candidates: total_equals_explicit_plus_recurring_candidate_counts
+        total_abstentions: total_equals_explicit_plus_recurring_abstention_counts
+        projection_input: report_input_count_equals_total_candidate_count
+      forbidden_content:
+        - terms
+        - source_ids
+        - evidence_anchors
+        - project_ids
+        - project_keys
+        - paths
+        - excerpts
+      rule: >-
+        Persist the fixed explicit and recurring keys even when their count is
+        zero. Reconcile family and total counts before publication. This summary
+        contains counts only and never retains candidate, source, project, path,
+        anchor, or content identity.
     excerpts:
       source_max_utf8_bytes: 4096
       max_per_candidate: 1
@@ -823,9 +976,10 @@ personal_mining_authority:
         meaning, project label, project key, raw evidence identity, excerpt text,
         or a per-row expanded command.
       abstentions: >-
-        Upstream mining abstentions are not retained in a candidate projection and
-        are never reconstructed. This read reports only bounded projection-local
-        candidate-selection and safe-context omission counts.
+        The projection retains only the reconciled fixed-key aggregate mining
+        summary from candidate_projection.mining_summary. It never retains or
+        reconstructs individual upstream abstentions. Reads may return those
+        counts with projection-local selection and safe-context omission counts.
       coverage: >-
         Coverage remains the validated current projection report and is not
         recomputed from a list filter or page.
@@ -1834,8 +1988,8 @@ ownership_contracts:
         collision, or malformed existing state is a conflict and must never be
         repaired or overwritten implicitly.
     confirmed_variant_guard:
-      owner: packages/cli/src/validate/v1LegacyCruft.ts#scanPost30CruftViolations
-      validation_surface: packages/cli/test/cli/v1LegacyCruft.test.ts
+      owner: packages/cli/src/validate/glossaryVariantGuard.ts#scanConfirmedVariantViolations
+      validation_surface: packages/cli/test/cli/glossaryVariantGuard.test.ts
       loader: packages/cli/src/state/write/glossaryPublication.ts#loadProjectGlossaryDocument
       source_rule: >-
         Resolve the glossary through the canonical artifact registry and consume

package/bundle/references/artifacts/state-storage-authority.yaml

@@ -1279,11 +1279,6 @@ entity_migration:
       phase_filters: >-
         Every --only apply is invalid during a v2-to-v3 boundary. Read-only
         filtered preview may remain available.
-      legacy_projection: >-
-        Canonical v2 YAML and already-resolved v1 conversions are inventoried
-        directly. A pending v1 Markdown conversion is not projected through a
-        prerequisite write during planning and therefore blocks the composed
-        apply before effects.
       lifecycle_normalization: >-
         Deterministic legacy plan lifecycle normalization is part of entity
         projection during cutover. Upgrade retains the original legacy YAML as

package/bundle/references/cli/update-channels.yaml

@@ -135,7 +135,7 @@ consumers:
       - development
   prime:
     owns:
-      - channel-aware v1 migration and app-home gate command strings.
+      - channel-aware app-home gate command strings.
     may_resolve_channels:
       - stable
       - development

package/bundle/references/cli/vocabulary-index.yaml

@@ -35,7 +35,7 @@ normalization_rules:
     avoid: Calling host coding agents peers or extension hosts of Agentera; implying Agentera is a module loaded into the host.
   - rule: /agentera is the main invocation.
     use: /agentera, $agentera for Codex-specific docs
-    avoid: /hej except as a legacy bridge.
+    avoid: /hej.
   - rule: The CLI source and rendered dashboard are different.
     use: agentera prime source data, status dashboard rendered briefing
     avoid: Treating raw CLI labels as the user-facing dashboard.
@@ -72,7 +72,7 @@ plain_language:
       avoid: Bare freshness checkpoint
     - use: Agentera app files need repair
       avoid: bundle freshness gap in user-facing diagnostics
-    - use: v1 migration check
+    - use: product-v1 state requires an explicit reset
       avoid: Bare upgrade guard in onboarding or recovery text
     - use: checkpoint commit
       avoid: Bare checkpoint

package/bundle/references/cli/vocabulary.md

@@ -147,7 +147,6 @@ authoritative recovery command.
 | Delegate                     | Orchestrate assigns approved plan work to a worker capability during an explicitly orchestrated flow.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
 | Spawn                        | Build or Optimize asks the coding host to launch an isolated worker when the host provides that facility.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
 | Worker mechanism             | A host-provided worker facility. Agentera ships no host-specific worker descriptor, adapter, plugin, hook, or package.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
-| Legacy bridge                | Temporary v1 entry points, especially `/hej`, that guide users to `/agentera` and the v2 upgrade path.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
 
 CLI-visible `agentera prime` labels are source labels. Preserve them in CLI tests
 and parsing code, but transform them before presenting a user dashboard:
@@ -503,7 +502,7 @@ High-risk diagnostic rewrites:
 | `bundle freshness guard failed` | `install status check failed`                                         |
 | `bundle refresh required`       | `repair Agentera app files`                                           |
 | `app refresh required`          | `Agentera app files need repair` or `Agentera app files are outdated` |
-| `upgrade guard triggered`       | `v1 migration check found legacy files`                               |
+| `upgrade guard triggered`       | `product-v1 state requires an explicit reset`                         |
 | `stale marker`                  | `missing or outdated version marker`                                  |
 | `artifact freshness failed`     | `artifact is stale` or `artifact needs sync`                          |
 
@@ -513,7 +512,7 @@ High-signal source surfaces for this vocabulary:
 
 | Source                                                        | Vocabulary surface                                                                                                                                                                        |
 | ------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `skills/agentera/SKILL.md`                                    | Routing entry, routing layers, CLI-first access, installed-app status check, and v1 migration check.                                                                                      |
+| `skills/agentera/SKILL.md`                                    | Routing entry, routing layers, CLI-first access, installed-app status check, and product-v1 reset boundary.                                                                               |
 | `skills/agentera/protocol.yaml`                               | Protocol primitives, glyphs, phases, visual tokens, exit signals.                                                                                                                         |
 | `skills/agentera/capability_schema_contract.yaml`             | Schema groups, priorities, stable IDs, primitive-reference fields.                                                                                                                        |
 | `packages/cli/src/capabilities/*/instructions.ts`             | Workflow grammar, capability roles, safety rails, exit marker forms. Loaded as a default-exported string constant; pre-cutover runtime serves it via `npx -y agentera@next prime --context <name> --format json`. |

package/bundle/references/meta/retained-reference-authority.yaml

@@ -14,6 +14,11 @@ inventory:
     production_owner: { module: packages/cli/src/registries/packageRegistry.ts, symbol: loadRegistry }
     consumers:
       - { kind: runtime, module: packages/cli/src/registries/packageRegistry.ts, symbol: loadRegistry, consumption: loads }
+  - path: references/adapters/product-v1-reset.yaml
+    classification: current
+    production_owner: { module: packages/cli/src/upgrade/productV1ResetAuthority.ts, symbol: loadProductV1ResetAuthority }
+    consumers:
+      - { kind: runtime, module: packages/cli/src/upgrade/productV1ResetAuthority.ts, symbol: loadProductV1ResetAuthority, consumption: loads }
   - path: references/analysis/evidence-tier-authority.yaml
     classification: current
     production_owner: { module: packages/cli/src/registries/evidenceTierContract.ts, symbol: loadEvidenceTierContract }

package/bundle/skills/agentera/schemas/artifacts/decisions.yaml

@@ -5,26 +5,7 @@
 # for context on why choices were made.
 #
 # The active authority uses writer-owned decision, revision, and satisfaction
-# entity files. The numbered projection model below is retained only as an exact
-# legacy migration input schema; it is not an ordinary post-cutover contract.
-#
-# ── Field-by-field mapping: v1 DECISIONS.md → v2 decisions.yaml ──
-#
-# v1 Field                              v2 Field               v2 ID
-# ─────────────────────────────────────────────────────────────────────
-# ## Decision N · date                  DECISION.number        DC1
-# (date from heading)                   DECISION.date          DC2
-# **Question**: <text>                  DECISION.question      DC3
-# **Context**: <text>                   DECISION.context       DC4
-# **Alternatives**: (list)              ALTERNATIVE entry      DA1
-# (named alt, e.g. "[Foo], chosen")     ALTERNATIVE.name       DA2
-# (chosen/rejected status)              ALTERNATIVE.status     DA3
-# **Choice**: <text>                    DECISION.choice        DC5
-# **Reasoning**: <text>                 DECISION.reasoning     DC6
-# **Confidence**: <label>               DECISION.confidence    DC7
-# **Feeds into**: <text>               DECISION.feeds_into     DC8
-# ## Archived Decisions                 (implicit section)     —
-# - Decision N (date): [Choice] — ...  ARCHIVE.summary        DR1
+# entity files.
 #
 # Protocol references:
 #   confidence: DL1-DL3 (protocol.yaml DECISION_LABELS)

package/bundle/skills/agentera/schemas/artifacts/docs.yaml

@@ -10,37 +10,6 @@
 # Structural pattern: UPPER_CASE groups with numbered entries and stable IDs,
 # following capability_schema_contract.yaml and protocol.yaml conventions.
 #
-# ── Field-by-field mapping: v1 DOCS.md → v2 docs.yaml ──
-#
-# v1 Field                              v2 Field               v2 ID
-# ─────────────────────────────────────────────────────────────────────
-# <!-- Last audit: date (label) -->      HEADER.last_audit      DH1
-# ## Conventions / doc_root             CONVENTIONS.doc_root   DC1
-# ## Conventions / style                CONVENTIONS.style      DC2
-# ## Conventions / auto_gen             CONVENTIONS.auto_gen   DC3
-# ## Conventions / version_files        CONVENTIONS.version_files DC4
-# ## Conventions / semver_policy        CONVENTIONS.semver_policy DC5
-# ## Artifact Mapping / table row       MAPPING.entry          DM1
-# (Artifact column)                     MAPPING.artifact       DM2
-# (Path column)                         MAPPING.path           DM3
-# (Producers column)                    MAPPING.producers      DM4
-# ## Index / table row                  INDEX.entry            DI1
-# (Document column)                     INDEX.document         DI2
-# (Path column)                         INDEX.path             DI3
-# (Last Updated column)                 INDEX.last_updated     DI4
-# (Status column)                       INDEX.status           DI5
-# ## Coverage / Documented              COVERAGE.documented    DV1
-# ## Coverage / Undocumented            COVERAGE.undocumented  DV2
-# ## Coverage / Stale                   COVERAGE.stale         DV3
-# ## Coverage / Tests                   COVERAGE.tests         DV4
-# ## Audit Log / ### date (label)       AUDIT_LOG.entry        DA1
-# (audit date from heading)             AUDIT_LOG.date         DA2
-# (audit label from heading)            AUDIT_LOG.label        DA3
-# - [finding_type] description          FINDING.type           DF1
-# (severity from context)               FINDING.severity       DF2
-# (description text)                    FINDING.description    DF3
-# (resolution: fixed/deferred)          FINDING.resolution     DF4
-#
 # Protocol references:
 #   visual tokens: VT1 (protocol.yaml VISUAL_TOKENS, status: current)
 #   severity: SF1-SF3 (protocol.yaml SEVERITY_FINDING)

package/bundle/skills/agentera/schemas/artifacts/experiments.yaml

@@ -7,31 +7,6 @@
 # Structural pattern: UPPER_CASE groups with numbered entries and stable IDs,
 # following capability_schema_contract.yaml and protocol.yaml conventions.
 #
-# ── Field-by-field mapping: v1 EXPERIMENTS.md → v2 experiments.yaml ──
-#
-# v1 Field                              v2 Field               v2 ID
-# ─────────────────────────────────────────────────────────────────────
-# ## Experiment N · date · label        EXPERIMENT.number      EX1
-# (date from heading)                   EXPERIMENT.date        EX2
-# (label from heading)                  EXPERIMENT.label       EX3
-# **Hypothesis**: <text>                EXPERIMENT.hypothesis  EX4
-# **Method**: <text>                    EXPERIMENT.method      EX5
-# **Change**: <text>                    EXPERIMENT.change      EX6
-# **Metric**: <text> + tables           EXPERIMENT.metric      EX7
-# **Regression**: <text>                EXPERIMENT.regression  EX8
-# **Status**: kept/discarded/baseline   EXPERIMENT.status      EX9
-# **Conclusion**: <text>                EXPERIMENT.conclusion  EX10
-# **Next**: <text>                      EXPERIMENT.next        EX11
-# **Escalation**: <text>                EXPERIMENT.escalation  EX12
-# **Target progress**: <text>           EXPERIMENT.target_progress EX13
-# **Brainstorm iteration log**          EXPERIMENT.iteration_log EX14
-# ## Closure · date                     CLOSURE.date           EC1
-# **Final value**: <value>              CLOSURE.final_value    EC2
-# **Target**: <target>                  CLOSURE.target         EC3
-# **Reason**: <text>                    CLOSURE.reason         EC4
-# ## Archived Experiments               (implicit section)     —
-# - EXP-N: result summary              ARCHIVE.summary        EA1
-#
 # Protocol references:
 #   status visual tokens: VT1-VT3 (protocol.yaml VISUAL_TOKENS)
 #   trend tokens: VT12-VT13 (protocol.yaml VISUAL_TOKENS)

package/bundle/skills/agentera/schemas/artifacts/glossary.yaml

@@ -83,5 +83,5 @@ ADVICE_RESOLUTION:
 CONFIRMED_VARIANT_GUARD:
   authority: references/artifacts/glossary-entry-contract.yaml#ownership_contracts.project.confirmed_variant_guard
   implementation: active
-  validation_surface: packages/cli/test/cli/v1LegacyCruft.test.ts
+  validation_surface: packages/cli/test/cli/glossaryVariantGuard.test.ts
   consumer_lookup: forbidden

package/bundle/skills/agentera/schemas/artifacts/health.yaml

@@ -6,42 +6,7 @@
 # counts), overall trajectory, per-dimension grades (A-F), per-dimension
 # findings with confidence, and trend analysis against the prior audit.
 #
-# The active authority is one health_audit entity per writer-owned file. The
-# numbered projection model below is retained only as an exact legacy migration
-# input schema; it is not an ordinary read or write contract after cutover.
-#
-# ── Field-by-field mapping: v1 HEALTH.md → v2 health.yaml ──
-#
-# v1 Field                              v2 Field               v2 ID
-# ─────────────────────────────────────────────────────────────────────
-# ## Audit N · date                     AUDIT.number           HA1
-# (date from heading)                   AUDIT.date             HA2
-# (CLI append time)                     AUDIT.appended_at      HA7
-# **Dimensions assessed**: <list>       AUDIT.dimensions       HA3
-# **Findings**: N crit, N warn, N info  AUDIT.findings_summary HA4
-# **Overall trajectory**: <text>        AUDIT.trajectory       HA5
-# **Grades**: Dim [X] | Dim [Y]        AUDIT.grades           HA6
-# ### Dimension: grade                  DIMENSION.name         HD1
-# (grade from heading)                  DIMENSION.grade        HD2
-# #### finding text                     FINDING.heading        HF1
-# - **Location**: <text>               FINDING.location       HF2
-# - **Evidence**: <text>               FINDING.evidence       HF3
-# - **Impact**: <text>                 FINDING.impact         HF4
-# - **Suggested action**: <text>       FINDING.suggested_action HF5
-# (severity glyph from prefix)         FINDING.severity       HF6
-# (confidence from parenthetical)      FINDING.confidence     HF7
-# ### Trends vs Audit N                 TRENDS.entry           HT1
-# - **Improved**: <text>               TRENDS.improved        HT2
-# - **Degraded**: <text>               TRENDS.degraded        HT3
-# - **Stable**: <text>                 TRENDS.stable          HT4
-# - **New findings**: <text>           TRENDS.new_findings    HT5
-# - **Resolved**: <text>              TRENDS.resolved         HT6
-# - **Carried forward**: <text>       TRENDS.carried_forward  HT7
-# ### Patterns Observed                 PATTERNS.heading       HP1
-# - Pattern text                       PATTERNS.entry         HP2
-# ## Archived Audits                    (implicit section)     —
-# ### Audit N · date (summary)         ARCHIVE.summary        HR1
-#
+# The active authority is one health_audit entity per writer-owned file.
 # Protocol references:
 #   severity: SF1-SF3 (protocol.yaml SEVERITY_FINDING)
 #   confidence: CS1-CS5 (protocol.yaml CONFIDENCE_SCALE)

package/bundle/skills/agentera/schemas/artifacts/objective.yaml

@@ -7,37 +7,6 @@
 # Structural pattern: UPPER_CASE groups with numbered entries and stable IDs,
 # following capability_schema_contract.yaml and protocol.yaml conventions.
 #
-# ── Field-by-field mapping: v1 OBJECTIVE.md → v2 objective.yaml ──
-#
-# v1 Field                              v2 Field               v2 ID
-# ─────────────────────────────────────────────────────────────────────
-# # <title>                              HEADER.title           OB1
-# **Status**: <status>                   HEADER.status          OB2
-# **Closed at**: <timestamp>             HEADER.closed_at       OB3
-# **Final value**: <value>               HEADER.final_value     OB4
-# **Target**: <target>                   HEADER.target_ref      OB5
-# **Reason**: <text>                     HEADER.reason          OB6
-# ## Objective / description             OBJECTIVE.description  OJ1
-# ### Two-tier metric (or single)        OBJECTIVE.metric_type  OJ2
-# **Tier 1 (primary metric)**: <text>    METRIC.description     OM1
-# Direction/Unit/Variance                METRIC.direction       OM2
-# METRIC.unit                            OM3
-# METRIC.variance                        OM4
-# **Tier 2 (behavioral)**: <text>        VALIDATION.description OV1
-# **Keep gate**: <text>                  VALIDATION.keep_gate   OV2
-# **Discard gate**: <text>               VALIDATION.discard_gate OV3
-# ### Why two tiers                      OBJECTIVE.rationale    OJ3
-# ## Why this matters                    OBJECTIVE.why          OJ4
-# ## Measurement                         OBJECTIVE.measurement  OJ5
-# ## Gates                               GATES.description      OG1
-# **Causal**: <text>                     GATES.causal           OG2
-# **Structural**: <text>                 GATES.structural       OG3
-# **Regression**: <text>                 GATES.regression       OG4
-# ## Constraints                         OBJECTIVE.constraints  OJ6
-# ## Scope / In scope                    SCOPE.included         OS1
-# ## Scope / Out of scope                SCOPE.excluded         OS2
-# ## Baseline                            BASELINE.description   OB7
-# ## Measurement model                   BASELINE.model_notes   OB8
 #
 # Protocol references:
 #   exit signals: EX1-EX4 (protocol.yaml EXIT_SIGNALS)