@alphazede/bearing-lite 0.1.11 → 0.2.0

package/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
   "name": "bearing-lite",
-  "version": "0.1.11",
+  "version": "0.2.0",
   "description": "Skills-first portable plugin that routes repository work through the smallest valid planning stages and agent roles, using project Markdown as the only task record.",
   "author": {
     "name": "William Rumph / AlphaZede",

package/schemas/authority.schema.json

@@ -0,0 +1,75 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/alphazede/bearing-lite/schemas/authority.schema.json",
+  "title": "Bearing Lite authority.json",
+  "description": "Current machine-enforced authority envelope. Lineup or route selection is not a grant. CONTRACT-EMV-009 envelope fields are required. Canonical keys are granting_owner_decisions (array) and expiry_conditions (array of strings). effective is boolean only. Extra lifecycle metadata is allowed.",
+  "type": "object",
+  "additionalProperties": true,
+  "required": [
+    "schema_version",
+    "schema",
+    "id",
+    "state",
+    "subject",
+    "repositories",
+    "baseline",
+    "granting_owner_decisions",
+    "allowed",
+    "prohibited",
+    "role_grants",
+    "effective",
+    "expiry_conditions",
+    "supersedes",
+    "approval_receipt"
+  ],
+  "properties": {
+    "schema_version": { "type": "string", "minLength": 1 },
+    "schema": { "type": "string", "minLength": 1, "description": "Envelope schema identity" },
+    "id": { "type": "string", "minLength": 1, "description": "Authority envelope ID" },
+    "state": { "type": "string", "minLength": 1 },
+    "subject": { "type": "object", "minProperties": 1, "additionalProperties": true },
+    "repositories": {
+      "type": "array",
+      "items": { "type": "object", "additionalProperties": true }
+    },
+    "baseline": { "type": "object", "minProperties": 1, "additionalProperties": true },
+    "granting_owner_decisions": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "allowed": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["scope", "actions", "paths"],
+      "properties": {
+        "scope": { "type": "array", "items": { "type": "string" } },
+        "actions": { "type": "array", "items": { "type": "string" } },
+        "paths": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "prohibited": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["scope", "actions", "paths"],
+      "properties": {
+        "scope": { "type": "array", "items": { "type": "string" } },
+        "actions": { "type": "array", "items": { "type": "string" } },
+        "paths": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "role_grants": {
+      "type": "array",
+      "items": { "type": "object", "additionalProperties": true }
+    },
+    "effective": { "type": "boolean", "description": "Machine-enforced effectiveness. Boolean only: a string is not an effectiveness decision." },
+    "expiry_conditions": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "supersedes": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "approval_receipt": { "type": "object", "additionalProperties": true }
+  }
+}

package/schemas/implementation.schema.json

@@ -0,0 +1,127 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/alphazede/bearing-lite/schemas/implementation.schema.json",
+  "title": "Bearing Lite implementation.json",
+  "description": "Nested execution authority. XLSX is never authority. Owner-configured n, k, and c have no assistant default integers. Every slice requires CONTRACT-EMV-008 fields including reasoning_level (object), not a sibling reasoning string. human_decision may be a string, object, or null. authority_id is a nonempty string on dispatchable slices and may be null only when dispatchable is false or slice_status is publication-blocked. Extra lifecycle metadata is allowed.",
+  "type": "object",
+  "additionalProperties": true,
+  "required": [
+    "schema_version",
+    "artifact",
+    "source_baseline",
+    "journey_settings",
+    "lineup_freeze",
+    "waves",
+    "dependencies",
+    "slices",
+    "traceability"
+  ],
+  "$defs": {
+    "contentfulObject": {
+      "type": "object",
+      "minProperties": 1,
+      "additionalProperties": true
+    },
+    "stringList": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "slice": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": [
+        "role",
+        "goal",
+        "type",
+        "requirement_ids",
+        "design_ids",
+        "seit_proof_rows",
+        "design_lenses",
+        "model_route",
+        "reasoning_level",
+        "review_path",
+        "write_set",
+        "command_ids",
+        "stop_condition",
+        "human_decision",
+        "authority_id"
+      ],
+      "properties": {
+        "id": { "type": "string" },
+        "role": { "type": "string", "minLength": 1 },
+        "goal": { "type": "string", "minLength": 1, "maxLength": 512 },
+        "type": { "type": "string", "minLength": 1 },
+        "requirement_ids": { "$ref": "#/$defs/stringList" },
+        "design_ids": { "$ref": "#/$defs/stringList" },
+        "seit_proof_rows": { "$ref": "#/$defs/stringList" },
+        "design_lenses": { "$ref": "#/$defs/stringList" },
+        "model_route": { "$ref": "#/$defs/contentfulObject" },
+        "reasoning_level": { "$ref": "#/$defs/contentfulObject" },
+        "review_path": { "$ref": "#/$defs/contentfulObject" },
+        "write_set": { "$ref": "#/$defs/stringList" },
+        "command_ids": { "$ref": "#/$defs/stringList" },
+        "stop_condition": { "type": "string", "minLength": 1 },
+        "human_decision": { "type": ["string", "object", "null"] },
+        "authority_id": { "type": ["string", "null"] },
+        "dispatchable": { "type": "boolean" },
+        "slice_status": { "type": "string" }
+      },
+      "if": {
+        "not": {
+          "anyOf": [
+            {
+              "properties": { "dispatchable": { "const": false } },
+              "required": ["dispatchable"]
+            },
+            {
+              "properties": { "slice_status": { "const": "publication-blocked" } },
+              "required": ["slice_status"]
+            }
+          ]
+        }
+      },
+      "then": {
+        "properties": {
+          "authority_id": { "type": "string", "minLength": 1 }
+        }
+      }
+    }
+  },
+  "properties": {
+    "schema_version": { "type": "string", "minLength": 1 },
+    "artifact": { "$ref": "#/$defs/contentfulObject" },
+    "source_baseline": { "$ref": "#/$defs/contentfulObject" },
+    "journey_settings": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["review_cardinality"],
+      "properties": {
+        "review_cardinality": {
+          "type": "object",
+          "additionalProperties": true,
+          "description": "Owner-configured reviewer count n, repair bound k, and confirmation count c. No default integers.",
+          "required": ["n", "k", "c"],
+          "properties": {
+            "n": { "type": "integer", "minimum": 0 },
+            "k": { "type": "integer", "minimum": 0 },
+            "c": { "type": "integer", "minimum": 0 }
+          }
+        }
+      }
+    },
+    "lineup_freeze": { "$ref": "#/$defs/contentfulObject" },
+    "waves": {
+      "type": "array",
+      "items": { "type": "object", "additionalProperties": true }
+    },
+    "dependencies": {
+      "type": "array",
+      "items": { "type": "object", "additionalProperties": true }
+    },
+    "slices": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/slice" }
+    },
+    "traceability": { "$ref": "#/$defs/contentfulObject" }
+  }
+}

package/schemas/journey.schema.json

@@ -0,0 +1,88 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/alphazede/bearing-lite/schemas/journey.schema.json",
+  "title": "Bearing Lite journey.json",
+  "description": "Append-only decisions and authority-event history plus the generation-bound checkout lease. The full mutable file digest is not the stable SEIT execution baseline. Extra lifecycle metadata is allowed at the document root. Lease identity fields stay closed.",
+  "type": "object",
+  "additionalProperties": true,
+  "required": [
+    "schema_version",
+    "journey",
+    "checkout_lease",
+    "decisions",
+    "open_decisions",
+    "planning_receipts",
+    "lineup_selection"
+  ],
+  "properties": {
+    "schema_version": { "type": "string", "minLength": 1 },
+    "journey": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["id", "title", "status", "planning_repository"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "title": { "type": "string", "minLength": 1 },
+        "status": { "type": "string", "minLength": 1 },
+        "planning_repository": { "type": "string", "minLength": 1 }
+      }
+    },
+    "checkout_lease": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "journey",
+        "controller",
+        "repository",
+        "checkout",
+        "branch",
+        "candidate_revision",
+        "acquired_at",
+        "generation",
+        "state"
+      ],
+      "properties": {
+        "journey": { "type": "string", "minLength": 1 },
+        "controller": { "type": "string", "minLength": 1 },
+        "repository": { "type": "string", "minLength": 1 },
+        "checkout": { "type": "string", "minLength": 1 },
+        "branch": { "type": "string", "minLength": 1 },
+        "candidate_revision": { "type": "string", "minLength": 1 },
+        "acquired_at": { "type": "string", "minLength": 1 },
+        "generation": { "type": "integer", "minimum": 1 },
+        "state": { "enum": ["active", "released"] }
+      }
+    },
+    "history": {
+      "type": "object",
+      "additionalProperties": true,
+      "description": "Optional append-only Journey history wrapper",
+      "properties": {
+        "decisions": { "type": "array", "items": { "type": "object", "additionalProperties": true } },
+        "authority_events": { "type": "array", "items": { "type": "object", "additionalProperties": true } }
+      }
+    },
+    "decisions": {
+      "type": "array",
+      "description": "Append-only confirmed owner decisions",
+      "items": { "type": "object", "additionalProperties": true }
+    },
+    "authority_events": {
+      "type": "array",
+      "description": "Append-only authority grant, amend, revoke, or supersede events",
+      "items": { "type": "object", "additionalProperties": true }
+    },
+    "open_decisions": {
+      "type": "array",
+      "items": { "type": "object", "additionalProperties": true }
+    },
+    "planning_receipts": {
+      "type": "array",
+      "items": { "type": "object", "additionalProperties": true }
+    },
+    "lineup_selection": {
+      "type": "object",
+      "additionalProperties": true
+    }
+  }
+}

package/schemas/lineups.schema.json

@@ -0,0 +1,145 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/alphazede/bearing-lite/schemas/lineups.schema.json",
+  "title": "Bearing Lite lineups.json",
+  "description": "User-owned named lineup catalog. Packaged bytes stay an empty catalog with no defaults. Selection is not an authority grant.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "lineups"
+  ],
+  "properties": {
+    "schema_version": {
+      "type": "integer",
+      "const": 1,
+      "description": "Integer 1. The string \"1\" used by Journey artifacts is invalid here."
+    },
+    "lineups": {
+      "type": "object",
+      "description": "Named profiles. Empty object is valid. Unlimited keys; no maxProperties.",
+      "propertyNames": {
+        "type": "string",
+        "pattern": "^[A-Za-z][A-Za-z0-9_-]*$"
+      },
+      "additionalProperties": {
+        "$ref": "#/$defs/profile"
+      }
+    },
+    "defaults": {
+      "type": "object",
+      "description": "Optional user-owned recommendations. Not a grant.",
+      "additionalProperties": false,
+      "properties": {
+        "planning": {
+          "type": "string",
+          "minLength": 1
+        },
+        "implementation": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    }
+  },
+  "$defs": {
+    "identity": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "harness",
+        "model",
+        "reasoning"
+      ],
+      "properties": {
+        "harness": {
+          "type": "string",
+          "minLength": 1
+        },
+        "model": {
+          "type": "string",
+          "minLength": 1
+        },
+        "reasoning": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "fallback": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "condition",
+        "harness",
+        "model",
+        "reasoning"
+      ],
+      "properties": {
+        "condition": {
+          "type": "string",
+          "minLength": 1
+        },
+        "harness": {
+          "type": "string",
+          "minLength": 1
+        },
+        "model": {
+          "type": "string",
+          "minLength": 1
+        },
+        "reasoning": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "assignment": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "role",
+        "primary",
+        "ordered_fallbacks"
+      ],
+      "properties": {
+        "role": {
+          "type": "string",
+          "minLength": 1
+        },
+        "primary": {
+          "$ref": "#/$defs/identity"
+        },
+        "ordered_fallbacks": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/fallback"
+          }
+        }
+      }
+    },
+    "phase": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "$ref": "#/$defs/assignment"
+      }
+    },
+    "profile": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "planned_planning_assignments",
+        "implementation_assignments"
+      ],
+      "properties": {
+        "planned_planning_assignments": {
+          "$ref": "#/$defs/phase"
+        },
+        "implementation_assignments": {
+          "$ref": "#/$defs/phase"
+        }
+      }
+    }
+  }
+}

package/schemas/seit.schema.json

@@ -0,0 +1,108 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/alphazede/bearing-lite/schemas/seit.schema.json",
+  "title": "Bearing Lite seit.json",
+  "description": "Canonical JSON Schema-validated tailored V&V plan. CONTRACT-EMV-007 always-on sections must appear as named objects or lists with content, not as a labels-only always_on_sections array: scope/baseline; responsibility/change authority; applicable documents/precedence; requirements flowdown/architecture context; V&V methods; verification and validation matrices; levels/integration sequence; environments/fixtures/data/simulations/support; procedures/commands; evidence/pass-fail; anomaly/corrective/closure. System fields only where applicable. Proof cases require the full canonical field set including observable_evidence and pass_fail_rule. Extra lifecycle metadata is allowed.",
+  "type": "object",
+  "additionalProperties": true,
+  "required": [
+    "schema_version",
+    "source_baseline",
+    "decision_baseline",
+    "responsibility_and_change_authority",
+    "applicable_documents_and_precedence",
+    "system_description_and_requirements_flowdown",
+    "vv_methods",
+    "levels",
+    "environments_fixtures_data_simulations_support",
+    "procedures_and_commands",
+    "evidence_and_pass_fail",
+    "anomaly_corrective_closure",
+    "integration_vv_sequence",
+    "proof_cases"
+  ],
+  "$defs": {
+    "contentfulObject": {
+      "type": "object",
+      "minProperties": 1,
+      "additionalProperties": true
+    },
+    "contentfulArray": {
+      "type": "array",
+      "minItems": 1
+    },
+    "contentfulString": {
+      "type": "string",
+      "minLength": 1
+    },
+    "proofCase": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": [
+        "id",
+        "kind",
+        "requirement_id",
+        "design_id",
+        "command_id",
+        "method",
+        "preconditions",
+        "stimulus_or_procedure",
+        "expected_result",
+        "observable_evidence",
+        "pass_fail_rule",
+        "method_fields",
+        "negative_or_failure_case"
+      ],
+      "properties": {
+        "id": { "$ref": "#/$defs/contentfulString" },
+        "kind": { "$ref": "#/$defs/contentfulString" },
+        "requirement_id": { "$ref": "#/$defs/contentfulString" },
+        "design_id": { "$ref": "#/$defs/contentfulString" },
+        "command_id": { "$ref": "#/$defs/contentfulString" },
+        "method": { "$ref": "#/$defs/contentfulString" },
+        "preconditions": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "stimulus_or_procedure": { "$ref": "#/$defs/contentfulString" },
+        "expected_result": { "$ref": "#/$defs/contentfulString" },
+        "observable_evidence": { "$ref": "#/$defs/contentfulString" },
+        "pass_fail_rule": { "$ref": "#/$defs/contentfulString" },
+        "method_fields": { "$ref": "#/$defs/contentfulObject" },
+        "negative_or_failure_case": { "$ref": "#/$defs/contentfulString" }
+      }
+    }
+  },
+  "properties": {
+    "schema_version": { "$ref": "#/$defs/contentfulString" },
+    "artifact": { "$ref": "#/$defs/contentfulObject" },
+    "source_baseline": { "$ref": "#/$defs/contentfulObject" },
+    "decision_baseline": {
+      "type": "object",
+      "minProperties": 1,
+      "additionalProperties": true,
+      "description": "Stable decision-baseline projection of confirmed decision identities and open-item statuses. Not the whole-file journey.json digest.",
+      "properties": {
+        "kind": { "type": "string" },
+        "confirmed_decisions": { "type": "object", "additionalProperties": true },
+        "open_items": { "type": "array", "items": { "type": "object", "additionalProperties": true } }
+      }
+    },
+    "responsibility_and_change_authority": { "$ref": "#/$defs/contentfulObject" },
+    "applicable_documents_and_precedence": { "$ref": "#/$defs/contentfulObject" },
+    "system_description_and_requirements_flowdown": { "$ref": "#/$defs/contentfulObject" },
+    "vv_methods": { "$ref": "#/$defs/contentfulObject" },
+    "levels": { "$ref": "#/$defs/contentfulArray" },
+    "environments_fixtures_data_simulations_support": { "$ref": "#/$defs/contentfulObject" },
+    "procedures_and_commands": { "$ref": "#/$defs/contentfulArray" },
+    "evidence_and_pass_fail": { "$ref": "#/$defs/contentfulObject" },
+    "anomaly_corrective_closure": { "$ref": "#/$defs/contentfulObject" },
+    "integration_vv_sequence": { "$ref": "#/$defs/contentfulArray" },
+    "proof_cases": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "$ref": "#/$defs/proofCase" }
+    }
+  }
+}

package/skills/bearing-lite/SKILL.md

@@ -10,37 +10,37 @@ planning nodes return owner questions. Plugin hosts are partial; skill-copy is s
    planning or dispatch. A live same-checkout competitor returns `WAITING_ON` with sanitized identity.
 2. Resume the next incomplete stage in the same generation; refresh `candidate_revision`.
    Never replay accepted stages or duplicate dispatch. Invalid leases fail closed.
-3. If `~/.agents/bearing-lite/default-role-lineup.md` is absent, create a proposed copy
-   from `templates/default-role-lineup.md`;
-   never infer identity values. The recorded snapshot is authoritative for this Journey.
+3. If `~/.agents/bearing-lite/default-role-lineup.md` is absent, create a
+   proposed copy; never infer identity values. The recorded snapshot is authoritative for this Journey.
    Later edits to
    `~/.agents/bearing-lite/default-role-lineup.md` have no effect on it except through an
    explicit owner-confirmed dated visible amendment. Dispatch uses lineup identity from the recorded snapshot.
 4. Run Repository Fit → Set Bearings → Gather Supplies; unresolved material intent blocks Map the Route.
 5. Invoke Map the Route after settled intent. Do not ask for lineup or route
    before it; carry owner-supplied lineup and `review_cadence: at-end` as proposals.
-6. On `PLAN_REVIEW_READY`, enforce `references/review-policy.md`: one candidate,
-   unique independent slots, one round and aggregated repair, deterministic PASS,
-   no rereview. Journey snapshots bind slots; validation never dispatches. Show one integrated
+   Follow `references/lineups.md` for catalog selection and save.
+6. Enforce `references/review-policy.md`. Show one integrated
    approval-or-change gate for outcome, design, route, lineup, role states,
    reasoning, cadence, and plan. Record the approved Journey type and snapshot; regenerate changes.
    Never add a staged lineup or route-review gate.
    Dispatch only after approval.
-7. Dispatch from the snapshot. Crewmate and Explorer may continue in-wave unchanged.
-   Validate the lease at wave start, after drift, and before commit; use the visible wave receipt
-   and update implementation and review once per wave.
+7. Crewmate and Explorer may continue in-wave.
+   Use the visible wave receipt and update implementation and review once per wave.
 
-Return `READY`, `WAITING_ON`, `OWNER_DECISION_REQUIRED`, or `COMPLETE`. Three
-evidence-changing corrections outside assurance.
-`max_assurance_rounds` is 1 per Journey; Direct route checks `assurance_rounds`, never
+Return `READY`, `WAITING_ON`, `OWNER_DECISION_REQUIRED`, or `COMPLETE`.
+`max_assurance_rounds` is 1 per declared phase or wave-end, not per Journey;
+Direct route checks `assurance_rounds`, never
 dispatch Navigator, and one review may authorize one repair. Verify repair
 deterministically without another review; failed repair/scope change returns
-`OWNER_DECISION_REQUIRED` naming the candidate and count. Only a separately scoped,
-materially changed new Journey resets review allowance. `COMPLETE` ends Bearing assurance.
-Authorized deployment keeps checks without reopening review.
+`OWNER_DECISION_REQUIRED` naming the candidate and count. `COMPLETE` ends Bearing assurance.
+Authorized deployment without reopening review.
 Planning review is a separate pre-dispatch gate; it never consumes implementation
 `required_assurance`, `assurance_rounds`, or `max_assurance_rounds`.
 Release the lease once: release the checkout lease exactly once on `COMPLETE` or `CANCELLED`;
 recovery needs explicit recorded generation increment.
 Recovery cannot steal a live lease.
+Selected or required capabilities activate. Unavailability of selected-or-required
+capability is a typed capability gap, not success and not invented behavior.
+Selected-only missing and required-only missing are typed gaps. Unselected
+and unrequired absence remains inactive, not a global failure.
 Never implement, self-assure, select models, or publish.