agentera 3.0.0-dev.2 → 3.0.0-dev.21

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

@@ -1,6 +1,6 @@
 # Changelog Artifact Schema
 #
-# Release history maintained by realisera. Tracks versioned releases with
+# Release history maintained by build. Tracks versioned releases with
 # categorized changes (Added, Changed, Fixed, Removed).
 #
 # Note: CHANGELOG.md is a human-facing Markdown artifact. It remains at the
@@ -11,12 +11,12 @@ meta:
   name: changelog
   version: "1.0.0"
   description: >-
-    Release history. Produced by realisera. Consumed by users and agents
+    Release history. Produced by build. Consumed by users and agents
     for version context. Human-facing: remains Markdown at project root.
   artifact_type: human_facing
   path: "CHANGELOG.md"
-  producer: realisera
-  consumers: [hej, all_skills]
+  producer: build
+  consumers: [status, all_skills]
   format: markdown
 
 GROUP_PREFIXES:

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

@@ -1,7 +1,7 @@
 # Decisions Artifact Schema
 #
-# Reasoning trail maintained by resonera. Each deliberation session appends
-# one entry. Decisions are referenced by realisera, optimera, and profilera
+# Reasoning trail maintained by discuss. Each deliberation session appends
+# one entry. Decisions are referenced by build, optimize, and profile
 # for context on why choices were made.
 #
 # Structural pattern: UPPER_CASE groups with numbered entries and stable IDs,
@@ -32,14 +32,14 @@ meta:
   name: decisions
   version: "1.0.0"
   description: >-
-    Reasoning trail maintained by resonera. Each deliberation session
-    appends one entry. Decisions are referenced by realisera, optimera,
-    profilera, planera, inspektera, hej, dokumentera, visionera, resonera,
-    and orkestrera for context on why choices were made.
+    Reasoning trail maintained by discuss. Each deliberation session
+    appends one entry. Decisions are referenced by build, optimize,
+    profile, plan, audit, status, document, vision, discuss,
+    and orchestrate for context on why choices were made.
   artifact_type: agent_facing
   path: ".agentera/decisions.yaml"
-  producer: resonera
-  consumers: [dokumentera, hej, inspektera, optimera, orkestrera, planera, profilera, realisera, resonera, visionera]
+  producer: discuss
+  consumers: [document, status, audit, optimize, orchestrate, plan, profile, build, discuss, vision]
   format: yaml
 
 GROUP_PREFIXES:
@@ -55,7 +55,7 @@ BUDGET:
   1:
     id: DB1
     scope: per_decision_entry
-    max_words: 200
+    max_words: 1000
     description: >-
       Maximum words per decision entry. Budgets are guidelines, not hard
       blockers.
@@ -69,10 +69,10 @@ BUDGET:
 COMPACTION:
   1:
     id: DX1
-    rule: uniform_10_40_50
+    rule: lossless_projection
     description: >-
-      Growing artifacts follow a uniform 10/40/50 rule: 10 full-detail
-      entries, 40 one-line archive entries, drop beyond 50 total.
+      The 10/40/50 values are current projection defaults, not deletion limits.
+      Numbered archive records remain complete and unlimited.
   2:
     id: DX2
     full_detail:
@@ -93,21 +93,26 @@ COMPACTION:
       the archive section. Compact summaries preserve decision number, date,
       and chosen alternative; structured compact fields preserve outcome and
       explicit feeds_into references when present so CLI downstream references
-      remain non-inferential.
+      remain non-inferential. Entries beyond the summary default are represented
+      by omission metadata while their numbered archive records remain available.
   4:
     id: DX4
-    dropped:
-      threshold: 50
-      action: "Removed entirely"
+    omission:
+      fields: [omitted, omitted_count, omission_reason, retrieval]
+      reason: projection_capacity_or_byte_budget
     description: >-
-      Decisions older than 50 are dropped entirely.
+      Omitted projection detail is never silently deleted or truncated. The
+      numbered archive is the complete historical source and retrieval points
+      use the direct state get contract.
   5:
     id: DX5
-    trigger: "When resonera writes a new decision"
+    trigger: "When discuss writes a new decision"
     description: >-
       Compaction runs when the producing skill writes a new entry.
-      If >10 full-detail entries exist, collapse the oldest to one-line.
-      If >40 one-line entries exist, drop the oldest.
+      If >10 full-detail entries exist and their numbered archives verify,
+      collapse the oldest to one-line. If >40 summary entries exist, omit the
+      oldest from this bounded projection with metadata; never delete its
+      numbered archive record. Unresolved review entries do not block storage.
   6:
     id: DX6
     archive_section:

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

@@ -1,6 +1,6 @@
 # Design Artifact Schema
 #
-# Visual identity system maintained by visualisera. Defines design tokens,
+# Visual identity system maintained by design. Defines design tokens,
 # palette, typography, spacing, and component styling rules.
 #
 # Note: DESIGN.md is a human-facing Markdown artifact. It remains at the
@@ -11,12 +11,12 @@ meta:
   name: design
   version: "1.0.0"
   description: >-
-    Visual identity system. Produced by visualisera. Consumed by capabilities
+    Visual identity system. Produced by design. Consumed by capabilities
     that need visual identity context. Human-facing: remains Markdown at root.
   artifact_type: human_facing
   path: "DESIGN.md"
-  producer: visualisera
-  consumers: [dokumentera, hej, inspektera, realisera, visionera, visualisera]
+  producer: design
+  consumers: [document, status, audit, build, vision, design]
   format: markdown
 
 GROUP_PREFIXES:

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

@@ -1,6 +1,6 @@
 # Docs Artifact Schema
 #
-# Documentation contract maintained by dokumentera. Tracks project doc
+# Documentation contract maintained by document. Tracks project doc
 # conventions, artifact path overrides, document index with status, coverage
 # metrics, and timestamped audit findings.
 #
@@ -47,11 +47,11 @@ meta:
   name: docs
   version: "1.0.0"
   description: >-
-    Documentation contract. Produced by dokumentera. Consumed by all skills
+    Documentation contract. Produced by document. Consumed by all skills
     for artifact path resolution and doc status tracking.
   artifact_type: agent_facing
   path: ".agentera/docs.yaml"
-  producer: dokumentera
+  producer: document
   consumers: [all_skills]
   format: yaml
 
@@ -123,7 +123,7 @@ CONVENTIONS:
     required: true
     description: >-
       Files whose content changes indicate a version bump is needed.
-      Tracked by planera, inspektera, and realisera for bump discipline.
+      Tracked by plan, audit, and build for bump discipline.
     validation:
       - "At least one entry required"
   5:
@@ -177,8 +177,9 @@ MAPPING:
     required: true
     description: >-
       File path for this artifact. May be absolute or relative.
-      Environment variable references (e.g., $PROFILERA_PROFILE_DIR)
-      are resolved at read time.
+      Environment variable references (e.g., $AGENTERA_PROFILE_DIR or
+      the deprecated $PROFILERA_PROFILE_DIR alias) are resolved at read
+      time with AGENTERA_PROFILE_DIR taking precedence.
     validation:
       - "Non-empty string"
   4:
@@ -288,7 +289,7 @@ AUDIT_LOG:
     type: map
     required: false
     description: >-
-      Each audit log entry. Timestamped findings from dokumentera audits.
+      Each audit log entry. Timestamped findings from document audits.
       Appended when an audit is performed.
   2:
     id: DA2

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

@@ -1,8 +1,8 @@
 # Experiments Artifact Schema
 #
-# Experiment log maintained by optimera. Each experiment records hypothesis,
+# Experiment log maintained by optimize. Each experiment records hypothesis,
 # method, metric results, kept/discarded status, and conclusions. Lives
-# alongside OBJECTIVE.md in .agentera/optimera/<name>/.
+# alongside OBJECTIVE.md in .agentera/optimize/<name>/.
 #
 # Structural pattern: UPPER_CASE groups with numbered entries and stable IDs,
 # following capability_schema_contract.yaml and protocol.yaml conventions.
@@ -40,12 +40,12 @@ meta:
   name: experiments
   version: "1.0.0"
   description: >-
-    Experiment log for optimera objectives. Produced and consumed by optimera.
-    Lives in .agentera/optimera/<name>/ alongside the objective.
+    Experiment log for optimize objectives. Produced and consumed by optimize.
+    Lives in .agentera/optimize/<name>/ alongside the objective.
   artifact_type: agent_facing
-  path: ".agentera/optimera/<name>/experiments.yaml"
-  producer: optimera
-  consumers: [hej, optimera]
+  path: ".agentera/optimize/<name>/experiments.yaml"
+  producer: optimize
+  consumers: [status, optimize]
   format: yaml
 
 GROUP_PREFIXES:
@@ -54,6 +54,8 @@ GROUP_PREFIXES:
   EXPERIMENT: EX
   CLOSURE: EC
   ARCHIVE: EA
+  PUBLICATION: EP
+  RETRIEVAL: ER
   VALIDATION: EV
 
 BUDGET:
@@ -108,7 +110,7 @@ COMPACTION:
       Experiments older than 50 are dropped entirely.
   5:
     id: EX_CMP5
-    trigger: "When optimera writes a new experiment"
+    trigger: "When optimize writes a new experiment"
     description: >-
       Compaction runs when the producing skill writes a new entry.
       If >10 full-detail entries exist, collapse the oldest to one-line.
@@ -133,6 +135,7 @@ EXPERIMENT:
     validation:
       - "Must be a non-negative integer"
       - "Must be unique across active and archived entries"
+      - "Identity is <objective-id>/experiment:<number>"
   2:
     id: EX2
     field: date
@@ -267,6 +270,94 @@ EXPERIMENT:
       Harness refinement log for baseline experiments. Each entry
       records a run number, issue encountered, and fix applied.
 
+PUBLICATION:
+  1:
+    id: EP1
+    operation: publish
+    command: >-
+      agentera state experiments publish --objective OBJECTIVE_ID --number N
+      --input EXPERIMENT.yaml --format json
+    description: >-
+      The typed state writer is the mutation authority. It validates the
+      objective, identity, caller entry, existing projection, and final bytes
+      before assigning number and atomically publishing one experiment.
+  2:
+    id: EP2
+    identity: '<objective-id>/experiment:<non-negative-integer>'
+    cli_owned_fields: [number]
+    retry: byte_equivalent_identity_is_idempotent
+    collision: same_identity_with_different_content_fails
+    description: >-
+      Retry never duplicates an experiment. Invalid identity, collisions, and
+      pre-publication failures preserve active and archive projection bytes.
+  3:
+    id: EP3
+    projection: uniform_10_40_50
+    durable_archive: objective_scoped_immutable_full_detail
+    description: >-
+      Publication validates and durably publishes the full experiment under
+      the objective directory before replacing the compacted projection. The
+      projection still retains 10 full entries and 40 one-line summaries.
+  4:
+    id: EP4
+    archive_path: '.agentera/<objective-root>/<objective>/archive/experiments/<experiment-number>.yaml'
+    canonical_objective_root: optimize
+    readable_legacy_objective_roots: [optimera]
+    envelope_schema: agentera.experimentArchive.v1
+    required_fields:
+      - schemaVersion
+      - stable_id
+      - objective_id
+      - experiment_number
+      - record
+      - record_sha256
+      - provenance
+    provenance_fields: [authority, objective_id, experiment_id, storage_scope, publication_order]
+    retry: byte_equivalent_envelope_is_idempotent
+    collision: same_identity_with_different_bytes_fails
+    description: >-
+      Archive identity binds stable objective and experiment identity to the
+      immutable full record. Legacy projection entries remain readable without
+      fabricating archive history that predates this publication contract.
+  5:
+    id: EP5
+    directory_durability: fsync_each_new_child_parent_before_advancing
+    exact_full_replay: reconstruct_missing_archive_before_success
+    summary_only_replay: never_reconstruct_without_full_detail
+    description: >-
+      First publication durably records every new archive directory entry.
+      Replay may recover only the exact full record still present in the
+      projection; compacted summaries and dropped rows are not fabricated.
+
+RETRIEVAL:
+  1:
+    id: ER1
+    list: >-
+      agentera state experiments list --objective OBJECTIVE_ID [--limit N]
+      [--cursor TOKEN] --format json
+    get: >-
+      agentera state experiments get --objective OBJECTIVE_ID --number N
+      --format json
+    description: >-
+      List returns newest-first objective-scoped identities from the bounded
+      projection and immutable archive. Get returns one exact identity.
+  2:
+    id: ER2
+    cursor: opaque_snapshot_cursor
+    cursor_binding: [collection, objective, order, snapshot]
+    detail_availability: [full, summary, unavailable]
+    description: >-
+      Cursor tokens are copied, never parsed or constructed. List and get retain
+      compatibility and provenance when legacy detail is summary-only or absent.
+  3:
+    id: ER3
+    maximum_limit: 100
+    max_serialized_utf8_bytes: 32768
+    omission_fields: [omitted, omitted_count, omission_reason, retrieval]
+    description: >-
+      Structured pages omit whole entries rather than truncating scalar values;
+      every addressable omission has continuation or exact-get recovery.
+
 CLOSURE:
   1:
     id: EC1
@@ -371,3 +462,43 @@ VALIDATION:
       and serve as the reference measurement.
     checks:
       - "Experiment 0 has status 'baseline'"
+  6:
+    id: EV6
+    rule: identity_compatibility
+    severity: error
+    description: >-
+      Experiment identity is objective-scoped. Reads retain legacy entries with
+      missing or duplicate numbers as unaddressable data with explicit caveats;
+      a new publication must reject ambiguous objective or experiment identity
+      before changing objective, experiment, or archive bytes.
+    checks:
+      - "Objective identity is stable across title and directory rename"
+      - "Experiment 0 and later non-negative numbers are addressable"
+      - "Duplicate or missing experiment numbers remain visible but unaddressable"
+      - "Publication rejects ambiguity before effects"
+  7:
+    id: EV7
+    rule: validated_publication
+    severity: error
+    description: >-
+      New experiments are published only through the typed writer after pure
+      identity and schema preflight, with atomic replacement and idempotent retry.
+    checks:
+      - "Caller input omits the CLI-owned number field"
+      - "Objective and experiment identity validate before staging"
+      - "Final experiments.yaml bytes validate before atomic replacement"
+      - "A byte-equivalent retry returns the existing experiment without duplication"
+  8:
+    id: EV8
+    rule: durable_archive_before_projection
+    severity: error
+    description: >-
+      Newly published full detail must be validated, immutably archived, and
+      directory-synced before the compacted projection is replaced.
+    checks:
+      - "Archive envelope identity and provenance validate before publication"
+      - "Every newly created archive directory entry is parent-synced in order"
+      - "Archive publication succeeds before projection replacement"
+      - "Exact full replay reconstructs a missing archive before success"
+      - "Conflicting immutable archive bytes preserve archive and projection"
+      - "Retry after archive or projection interruption does not duplicate detail"

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

@@ -1,6 +1,6 @@
 # Health Artifact Schema
 #
-# Audit log maintained by inspektera. Each audit entry records assessed
+# Audit log maintained by audit. Each audit entry records assessed
 # dimensions, findings (critical/warning/info counts), overall trajectory,
 # per-dimension grades (A-F), per-dimension findings with confidence, and
 # trend analysis against the prior audit.
@@ -49,12 +49,12 @@ meta:
   name: health
   version: "1.0.0"
   description: >-
-    Audit log maintained by inspektera. Consumed by capabilities that need
+    Audit log maintained by audit. Consumed by capabilities that need
     codebase health context.
   artifact_type: agent_facing
   path: ".agentera/health.yaml"
-  producer: inspektera
-  consumers: [dokumentera, hej, inspektera, orkestrera, planera, realisera, visionera]
+  producer: audit
+  consumers: [document, status, audit, orchestrate, plan, build, vision]
   format: yaml
 
 GROUP_PREFIXES:
@@ -87,10 +87,10 @@ BUDGET:
 COMPACTION:
   1:
     id: HX1
-    rule: uniform_10_40_50
+    rule: lossless_projection
     description: >-
-      Growing artifacts follow a uniform 10/40/50 rule: 10 full-detail
-      entries, 40 one-line archive entries, drop beyond 50 total.
+      The 10/40/50 values are current projection defaults, not deletion limits.
+      Numbered archive records remain complete and unlimited.
   2:
     id: HX2
     full_detail:
@@ -109,21 +109,27 @@ COMPACTION:
     description: >-
       Audits 11 through 50 are collapsed to one-line format under the
       archive section. One-line summaries preserve audit number, date,
-      overall grade, and trajectory.
+      overall grade, and trajectory. Entries beyond the summary default are
+      represented by omission metadata while their numbered archive records
+      remain available.
   4:
     id: HX4
-    dropped:
-      threshold: 50
-      action: "Removed entirely"
+    omission:
+      fields: [omitted, omitted_count, omission_reason, retrieval]
+      reason: projection_capacity_or_byte_budget
     description: >-
-      Audits older than 50 are dropped entirely.
+      Omitted projection detail is never silently deleted or truncated. The
+      numbered archive is the complete historical source and retrieval points
+      use the direct state get contract.
   5:
     id: HX5
-    trigger: "When inspektera writes a new audit"
+    trigger: "When audit writes a new audit"
     description: >-
       Compaction runs when the producing skill writes a new entry.
-      If >10 full-detail entries exist, collapse the oldest to one-line.
-      If >40 one-line entries exist, drop the oldest.
+      If >10 full-detail entries exist and their numbered archives verify,
+      collapse the oldest to one-line. If >40 summary entries exist, omit the
+      oldest from this bounded projection with metadata; never delete its
+      numbered archive record. Unverified entries remain full for recovery.
   6:
     id: HX6
     archive_section:

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

@@ -1,7 +1,7 @@
 # Objective Artifact Schema
 #
-# Optimization objective maintained by optimera. Each objective lives in its
-# own subdirectory under .agentera/optimera/<name>/ and captures the metric,
+# Optimization objective maintained by optimize. Each objective lives in its
+# own subdirectory under .agentera/optimize/<name>/ and captures the metric,
 # target, baseline, constraints, measurement method, gates, and scope.
 #
 # Structural pattern: UPPER_CASE groups with numbered entries and stable IDs,
@@ -47,12 +47,12 @@ meta:
   name: objective
   version: "1.0.0"
   description: >-
-    Optimization objective. Produced by optimera and resonera. Each objective
-    lives in its own subdirectory under .agentera/optimera/<name>/.
+    Optimization objective. Produced by optimize and discuss. Each objective
+    lives in its own subdirectory under .agentera/optimize/<name>/.
   artifact_type: agent_facing
-  path: ".agentera/optimera/<name>/objective.yaml"
-  producer: [optimera, resonera]
-  consumers: [hej, optimera, resonera]
+  path: ".agentera/optimize/<name>/objective.yaml"
+  producer: [optimize, discuss]
+  consumers: [status, optimize, discuss]
   format: yaml
 
 GROUP_PREFIXES:
@@ -78,6 +78,19 @@ BUDGET:
       bounded by the measurement description's inherent complexity.
 
 HEADER:
+  0:
+    id: OB_HDR0
+    field: id
+    type: string
+    required: true
+    description: >-
+      Stable objective identity in objective:<lowercase RFC 9562 UUID> form.
+      It is assigned when a new objective is published and remains unchanged
+      when the title or containing directory is renamed. Legacy objectives
+      without this field remain read-compatible through a derived identity and
+      an explicit compatibility caveat; reads never rewrite legacy bytes.
+    validation:
+      - "Matches objective:<lowercase-rfc9562-uuid>"
   1:
     id: OB_HDR1
     field: title
@@ -360,10 +373,11 @@ VALIDATION_RULES:
     rule: required_fields
     severity: error
     description: >-
-      The objective must have: title, status, description, why,
+      A newly published objective must have: stable id, title, status, description, why,
       measurement, metric (description, direction, unit), baseline,
       and scope (included, excluded).
     checks:
+      - "id is present and matches objective:<lowercase-rfc9562-uuid>"
       - "title is present and non-empty"
       - "status is present and is 'open' or 'closed'"
       - "description is present and non-empty"