agentera 3.0.0-dev.22 → 3.0.0-dev.25

package/bundle/references/cli/agent-ready-state-contract.yaml

@@ -62,7 +62,7 @@ slash_route_aliases:
     Decision 43 aliases are exact `/agentera <alias>` routes, not CLI state
     commands. Teaching `status`, `build`, `audit`, or `document` as CLI commands
     would blur route vocabulary with state access; the shared word `plan` keeps
-    separate meanings as `/agentera plan` routing and `agentera plan` state.
+     separate meanings as `/agentera plan` routing and `agentera state plan` state.
 doctor:
   status: implemented_hard_rename
   command: doctor
@@ -170,7 +170,7 @@ structured_output:
             - summary_fields
             - entry_fields
           complete_semantics: >-
-            When `complete_for_plan_artifact` is true, `agentera plan --format
+            When `complete_for_plan_artifact` is true, `agentera state plan --format
             json` includes plan summary metadata, tasks, dependencies, acceptance
             criteria, evidence, overall acceptance, surprises, and previous-plan
             archive references needed for normal read-only startup/evaluation
@@ -222,7 +222,8 @@ structured_output:
       fields:
         - command
         - status
-        - bundle
+        - app_home
+        - app
         - mode
         - profile
         - v1_migration
@@ -233,7 +234,10 @@ structured_output:
         - progress
         - objective
         - state_presence
+        - project_integration
         - attention
+        - history
+        - runtime_lifecycle
         - decision_attention
         - next_action
         - orchestration_context
@@ -328,7 +332,7 @@ structured_output:
             derives from the same `_decision_context_entry` and
              `_decision_satisfaction_context` semantics as bounded `agentera state
              decisions list --limit 20 --format json` plus exact `state decisions
-             get --number N`, never infers satisfaction, never mutates `.agentera/decisions.yaml`,
+             get --id ID`, never infers satisfaction, never mutates decision entities,
             keeps top-level attention bounded, and must not change `next_action`
             routing priority.
           evidence_context_target_contract: evidence_context_target_contract
@@ -359,7 +363,7 @@ startup_completeness:
     before any raw artifact read. Complete startup state must never require raw
     artifact reads for normal capability startup.
   current_cli_fallback:
-    - agentera plan --format json
+     - agentera state plan --format json
   state_families_added:
     - plan task details, dependencies, acceptance criteria, and evidence summaries
     - docs artifact mapping and source-contract completeness metadata
@@ -406,7 +410,7 @@ evidence_context_target_contract:
         caveats:
           - profile-derived state is stale and must not trigger profile refresh
           - orchestration_context is incomplete for missing decisions, vision, and profile state
-      - command: agentera plan --format json
+      - command: agentera state plan --format json
         included_state:
           - active plan header and summary
           - task dependencies
@@ -416,7 +420,7 @@ evidence_context_target_contract:
           - previous_plan_archived pointer
         missing_state: []
         raw_artifact_reads_required: false
-      - command: agentera docs --format json
+      - command: agentera state docs --format json
         included_state:
           - artifact mapping
           - version files
@@ -424,7 +428,7 @@ evidence_context_target_contract:
           - indexed document freshness
         missing_state: []
         raw_artifact_reads_required: false
-      - command: agentera todo --format json
+      - command: agentera state todo --format json
         included_state:
           - open 2.3.10 evidence-context TODO
           - deferred 2.3.11 and 2.3.12 source-contract TODOs
@@ -481,22 +485,22 @@ evidence_context_target_contract:
     required_for_normal_task_evaluation:
       - family: evaluation_target
         source: plan/orchestration CLI state
-        fallback: agentera plan --format json
+        fallback: agentera state plan --format json
       - family: plan_criteria
-        source: agentera plan --format json entries.acceptance
+        source: agentera state plan --format json entries.acceptance
         fallback: none when complete_for_plan_artifact is true
       - family: progress_verification
         source: agentera state progress list --limit 20 --format json latest verification
-        fallback: agentera state progress get --number N --format json
+        fallback: agentera state progress get --id ID --format json
       - family: docs_state
-        source: agentera docs --format json summary and entries
-        fallback: agentera docs --format json
+        source: agentera state docs --format json summary and entries
+        fallback: agentera state docs --format json
       - family: health_state
         source: agentera state health list --limit 20 --format json latest audit
-        fallback: agentera state health get --number N --format json
+        fallback: agentera state health get --id ID --format json
       - family: todo_state
-        source: agentera todo --format json known issues and source-contract TODOs
-        fallback: agentera todo --format json
+        source: agentera state todo --format json known issues and source-contract TODOs
+        fallback: agentera state todo --format json
       - family: source_contract
         source: evidence_context.source_contract
         fallback: listed existing CLI commands before raw reads
@@ -556,7 +560,8 @@ field_selection:
       fields:
         - command
         - status
-        - bundle
+        - app_home
+        - app
         - mode
         - profile
         - v1_migration
@@ -567,7 +572,10 @@ field_selection:
         - progress
         - objective
         - state_presence
+        - project_integration
         - attention
+        - history
+        - runtime_lifecycle
         - decision_attention
         - next_action
         - orchestration_context