@alphazede/bearing-lite 0.2.2 → 1.0.0

package/schemas/journey.schema.json

@@ -2,10 +2,10 @@
   "$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.",
+  "description": "Append-only decisions and authority-event history plus the generation-bound checkout lease for a Bearing Lifecycle. 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. lineup_selection is not a live field; profile_selection is required.",
   "type": "object",
   "additionalProperties": true,
-  "required": ["schema_version", "journey", "checkout_lease", "decisions", "open_decisions", "planning_receipts", "lineup_selection"],
+  "required": ["schema_version", "journey", "checkout_lease", "decisions", "open_decisions", "planning_receipts", "profile_selection"],
   "properties": {
     "schema_version": {"type": "string", "minLength": 1},
     "journey": {
@@ -91,7 +91,7 @@
       }
     },
     "planning_receipts": {"type": "array", "items": {"type": "object", "additionalProperties": true}},
-    "lineup_selection": {"type": "object", "additionalProperties": true},
+    "profile_selection": {"type": "object", "additionalProperties": true},
     "owner_wait_tracking": {"type": "boolean", "description": "Explicit coverage marker; absence is unavailable, never zero owner wait."},
     "owner_blocked_intervals": {
       "type": "array",

package/schemas/profiles.schema.json

@@ -0,0 +1,359 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/alphazede/bearing-lite/schemas/profiles.schema.json",
+  "title": "Bearing Lite profiles.json",
+  "description": "User-owned named profile catalog. Packaged bytes stay an empty catalog with no defaults. Selection is not an authority grant. Normal runtime never reads lineups.json or default-role-lineup.md.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "profiles"
+  ],
+  "properties": {
+    "schema_version": {
+      "type": "integer",
+      "const": 1,
+      "description": "Integer 1. The string \"1\" used by Lifecycle artifacts is invalid here."
+    },
+    "profiles": {
+      "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
+        }
+      }
+    },
+    "cadence": {
+      "type": "string",
+      "enum": [
+        "slice",
+        "phase",
+        "lifecycle"
+      ]
+    },
+    "route": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "enabled",
+        "primary",
+        "ordered_fallbacks"
+      ],
+      "properties": {
+        "enabled": {
+          "type": "boolean"
+        },
+        "primary": {
+          "$ref": "#/$defs/identity"
+        },
+        "ordered_fallbacks": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/fallback"
+          }
+        }
+      }
+    },
+    "reviewerRoute": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "enabled",
+        "primary",
+        "ordered_fallbacks"
+      ],
+      "properties": {
+        "enabled": {
+          "type": "boolean"
+        },
+        "primary": {
+          "$ref": "#/$defs/identity"
+        },
+        "ordered_fallbacks": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/fallback"
+          }
+        },
+        "cadence": {
+          "$ref": "#/$defs/cadence"
+        }
+      }
+    },
+    "assuranceSession": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "enabled",
+        "primary",
+        "ordered_fallbacks"
+      ],
+      "properties": {
+        "enabled": {
+          "type": "boolean"
+        },
+        "primary": {
+          "$ref": "#/$defs/identity"
+        },
+        "ordered_fallbacks": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/fallback"
+          }
+        },
+        "cadence": {
+          "$ref": "#/$defs/cadence"
+        }
+      }
+    },
+    "sessionedRole": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "sessions"
+      ],
+      "properties": {
+        "sessions": {
+          "type": "object",
+          "minProperties": 1,
+          "additionalProperties": false,
+          "properties": {
+            "planning": {
+              "$ref": "#/$defs/route"
+            }
+          }
+        }
+      }
+    },
+    "testEngineerRole": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "sessions"
+      ],
+      "properties": {
+        "sessions": {
+          "type": "object",
+          "minProperties": 1,
+          "additionalProperties": false,
+          "properties": {
+            "planning": {
+              "$ref": "#/$defs/route"
+            },
+            "assurance": {
+              "$ref": "#/$defs/assuranceSession"
+            }
+          }
+        }
+      }
+    },
+    "integrationEngineerRole": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "sessions"
+      ],
+      "properties": {
+        "sessions": {
+          "type": "object",
+          "minProperties": 1,
+          "additionalProperties": false,
+          "properties": {
+            "planning": {
+              "$ref": "#/$defs/route"
+            },
+            "execution": {
+              "$ref": "#/$defs/assuranceSession"
+            }
+          }
+        }
+      }
+    },
+    "profile": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "roles"
+      ],
+      "properties": {
+        "roles": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "implementer": {
+              "$ref": "#/$defs/route"
+            },
+            "light_implementer": {
+              "$ref": "#/$defs/route"
+            },
+            "coordinator": {
+              "$ref": "#/$defs/route"
+            },
+            "reviewer": {
+              "$ref": "#/$defs/reviewerRoute"
+            },
+            "scribe": {
+              "$ref": "#/$defs/route"
+            },
+            "plan_integrator": {
+              "$ref": "#/$defs/route"
+            },
+            "systems_modeler": {
+              "$ref": "#/$defs/sessionedRole"
+            },
+            "test_engineer": {
+              "$ref": "#/$defs/testEngineerRole"
+            },
+            "integration_engineer": {
+              "$ref": "#/$defs/integrationEngineerRole"
+            },
+            "requirements_engineer": {
+              "$ref": "#/$defs/sessionedRole"
+            }
+          }
+        },
+        "development_strategy": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "mode"
+          ],
+          "properties": {
+            "mode": {
+              "type": "string",
+              "enum": [
+                "single_implementer",
+                "tdd"
+              ]
+            }
+          }
+        },
+        "planning_to_implementation_clean_session": {
+          "type": "boolean"
+        },
+        "concurrency": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "dispatch_ready_independent_work": {
+              "type": "boolean"
+            },
+            "preserve_order_for_dependencies_interfaces_write_overlap_and_shared_mutable_resources": {
+              "type": "boolean"
+            }
+          }
+        },
+        "holds": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": true,
+            "required": [
+              "id",
+              "effect"
+            ],
+            "properties": {
+              "id": {
+                "type": "string",
+                "minLength": 1
+              },
+              "effect": {
+                "type": "string",
+                "minLength": 1
+              }
+            }
+          }
+        },
+        "deterministic_verification": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "reverify": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "enabled"
+              ],
+              "properties": {
+                "enabled": {
+                  "type": "boolean"
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/schemas/verification.schema.json

@@ -0,0 +1,126 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/alphazede/bearing-lite/schemas/verification.schema.json",
+  "title": "Bearing Lite deterministic verification request and receipt",
+  "description": "DES-BDL-008 / AC-BDL-009. A request binds candidate, claim, backend, stage, authority, expected result, and command/configuration. A receipt binds the same candidate, claim, backend, version, command/configuration, and evidence digest. Schema validates structure only; hooks/verification.cjs enforces diagnostic-versus-assurance, independence, and gate eligibility. Extra lifecycle metadata is not allowed.",
+  "oneOf": [
+    { "$ref": "#/$defs/request" },
+    { "$ref": "#/$defs/receipt" }
+  ],
+  "$defs": {
+    "nonempty": {
+      "type": "string",
+      "minLength": 1
+    },
+    "sha256": {
+      "type": "string",
+      "pattern": "^[0-9a-f]{64}$"
+    },
+    "authority": {
+      "type": "string",
+      "enum": ["diagnostic", "assurance"]
+    },
+    "stage": {
+      "type": "string",
+      "enum": [
+        "implementation",
+        "integration",
+        "assurance",
+        "review",
+        "post_repair_closure"
+      ]
+    },
+    "status": {
+      "type": "string",
+      "enum": ["VERIFIED", "REFUTED", "INCONCLUSIVE", "ERROR"]
+    },
+    "expected_result": {
+      "type": "string",
+      "enum": ["VERIFIED", "REFUTED"]
+    },
+    "command_configuration": {
+      "type": "object",
+      "minProperties": 1,
+      "additionalProperties": true
+    },
+    "produced_by": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["role", "identity", "session"],
+      "properties": {
+        "role": { "$ref": "#/$defs/nonempty" },
+        "identity": { "$ref": "#/$defs/nonempty" },
+        "session": { "$ref": "#/$defs/nonempty" }
+      }
+    },
+    "request": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "schema_version",
+        "kind",
+        "candidate_ref",
+        "candidate_revision",
+        "claim_id",
+        "claim_type",
+        "backend",
+        "stage",
+        "authority",
+        "expected_result",
+        "command_configuration",
+        "selected",
+        "required"
+      ],
+      "properties": {
+        "schema_version": { "type": "string", "const": "1" },
+        "kind": { "type": "string", "const": "request" },
+        "candidate_ref": { "$ref": "#/$defs/nonempty" },
+        "candidate_revision": { "$ref": "#/$defs/nonempty" },
+        "candidate_digest": { "$ref": "#/$defs/sha256" },
+        "claim_id": { "$ref": "#/$defs/nonempty" },
+        "claim_type": { "$ref": "#/$defs/nonempty" },
+        "backend": { "$ref": "#/$defs/nonempty" },
+        "stage": { "$ref": "#/$defs/stage" },
+        "authority": { "$ref": "#/$defs/authority" },
+        "expected_result": { "$ref": "#/$defs/expected_result" },
+        "command_configuration": { "$ref": "#/$defs/command_configuration" },
+        "selected": { "type": "boolean" },
+        "required": { "type": "boolean" }
+      }
+    },
+    "receipt": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "schema_version",
+        "kind",
+        "status",
+        "candidate_ref",
+        "candidate_revision",
+        "claim_id",
+        "backend",
+        "backend_version",
+        "command_configuration",
+        "evidence_digest",
+        "authority",
+        "produced_by"
+      ],
+      "properties": {
+        "schema_version": { "type": "string", "const": "1" },
+        "kind": { "type": "string", "const": "receipt" },
+        "status": { "$ref": "#/$defs/status" },
+        "candidate_ref": { "$ref": "#/$defs/nonempty" },
+        "candidate_revision": { "$ref": "#/$defs/nonempty" },
+        "candidate_digest": { "$ref": "#/$defs/sha256" },
+        "claim_id": { "$ref": "#/$defs/nonempty" },
+        "backend": { "$ref": "#/$defs/nonempty" },
+        "backend_version": { "$ref": "#/$defs/nonempty" },
+        "command_configuration": { "$ref": "#/$defs/command_configuration" },
+        "evidence_digest": { "$ref": "#/$defs/sha256" },
+        "authority": { "$ref": "#/$defs/authority" },
+        "produced_by": { "$ref": "#/$defs/produced_by" },
+        "stage": { "$ref": "#/$defs/stage" }
+      }
+    }
+  }
+}

package/skills/{set-bearings → architectural-alignment}/SKILL.md

@@ -1,22 +1,22 @@
 ---
-name: set-bearings
+name: architectural-alignment
 description: >
-  Create or resume the visible Journey workspace and bounded repository map
-  after Repository Fit is confirmed. Use for Set Bearings or stale project
-  context. Do not use before fit, for owner decisions, design, implementation,
-  hidden state, or deleting historical plans.
+  Create or resume the visible Lifecycle workspace and bounded repository map
+  after Intake is confirmed. Use for Architectural Alignment or stale
+  project context. Do not use before fit, for owner decisions, design,
+  implementation, hidden state, or deleting historical plans.
 ---
 
-# Set Bearings
+# Architectural Alignment
 
-Fresh planning node. The Router announces `Setting Our Bearings in <repo>.`
+Fresh planning node. The Orchestrator announces `Aligning architecture in <repo>.`
 
 ## Inputs and match
 
-- **Inputs:** confirmed repository root, owner-confirmed plan directory, Journey
+- **Inputs:** confirmed repository root, owner-confirmed plan directory, Lifecycle
   title, visible existing artifacts, repository rules, and return schema.
-- **Match:** the workspace or repository map is missing or stale.
-- **Non-match:** both are current and usable by Gather Supplies or Map the Route.
+- **Match:** the workspace, repository map, or architecture extract is missing or stale.
+- **Non-match:** both are current and usable by Scope Definition or Planning and Design.
 
 ## Algorithm
 
@@ -30,13 +30,17 @@ Fresh planning node. The Router announces `Setting Our Bearings in <repo>.`
    root manifest, task runner, CI entrypoint, top-level instructions, and root
    test configs. Strictly prohibit discovery traversal into repo-relative
    `src/`, `lib/`, `vendor/`, and `docs/`.
-4. If bounds are exhausted before required anchors are found, return
+4. Extract existing architecture covering the affected scope. If none exists or
+   evidence does not cover it, record that gap, establish minimum system context
+   from repository facts and owner intent, and activate Systems Modeler rather
+   than inventing architecture.
+5. If bounds are exhausted before required anchors are found, return
    `NEEDS_EVIDENCE` naming the missing anchor. Never compose unobserved commands.
-5. Create missing plan directory or update `workspace.md` in place, preserving
+6. Create missing plan directory or update `workspace.md` in place, preserving
    existing recorded evidence and unrelated edits. Initialize a missing file
    from `templates/workspace.md`. Quote validation commands with source and mark
    `[observed, not run]`. Drop detail before Constraints and Unknowns.
-6. Verify written paths remain inside authority and return `WORKSPACE_READY`.
+7. Verify written paths remain inside authority and return `WORKSPACE_READY`.
 
 ## Return and recovery
 

package/skills/{set-bearings → architectural-alignment}/templates/workspace.md

@@ -1,4 +1,4 @@
-# Workspace Environment: <journey-topic>
+# Workspace Environment: <lifecycle-title>
 
 ## Repository Identity
 - Root: `<repository-root>`

package/skills/bearing-lite/SKILL.md

@@ -1,35 +1,35 @@
 ---
 name: bearing-lite
-description: Bearing Lite Router for Journeys. Not for ordinary work, assigned packets, implementation, or publication.
+description: Bearing Lite Orchestrator for Lifecycles. Not for ordinary work, assigned packets, implementation, or publication.
 ---
 
-Router alone writes Journey planning state, owns owner conversation, and owns Expedition sequencing;
-planning nodes return owner questions. Plugin hosts are partial; skill-copy is skills-only.
+Orchestrator alone writes Lifecycle planning state, owns owner conversation, and owns
+sequencing; planning nodes return owner questions. Plugin hosts are partial; skill-copy is skills-only.
 
-1. Say `Preparing this Journey.` Acquire or resume a generation-bound checkout lease before
+1. Say `Preparing this Lifecycle.` Acquire or resume a generation-bound checkout lease before
    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. Lineup comes only from `~/.agents/bearing-lite/lineups.json` per
-   `references/lineups.md`; a missing catalog returns `no_named_profiles`,
-   never a generated file; never infer identity values. The Router is observed, not selected.
-   The recorded snapshot is authoritative for this Journey. Later edits to
-   `~/.agents/bearing-lite/lineups.json` 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.
+   One host-native liveness check classifies RUNNING, COMPLETED, INACTIVE, or UNKNOWN.
+   Never replay accepted stages or duplicate dispatch.
+   UNKNOWN without owner-requested resume returns `WAITING_ON`. Invalid leases fail closed.
+3. Profile comes only from `~/.agents/bearing-lite/profiles.json` per
+   `references/profiles.md`; a missing catalog returns `no_named_profiles`,
+   never a generated file; never infer identity values. A leftover user lineup
+   returns `MIGRATION_REQUIRED`. The Orchestrator is observed, not selected.
+   The recorded snapshot is authoritative for this Lifecycle. Later edits to
+   `~/.agents/bearing-lite/profiles.json` have no effect on it except through an
+   explicit owner-confirmed dated visible amendment. Dispatch uses that snapshot.
+4. Run Intake → Architectural Alignment → Scope Definition; unresolved material intent blocks Planning and Design.
+5. Invoke Planning and Design after settled intent. Do not ask for profile or route
+   before it; carry owner-supplied profile and cadence.
 6. Enforce `references/review-policy.md` and `references/owner-stops.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.
-   Never add a staged lineup or route-review gate.
-   Dispatch only after approval.
-7. Crewmate and Explorer may continue in-wave. `work_class: light` slices go to the
-   Light Implementer; a `reclassify: judgement` return re-dispatches to the Crewmate.
-   Use visible wave receipts and update implementation and review once per wave.
+   approval-or-change gate. Record the approved Lifecycle type and snapshot.
+   Never add a staged profile or route-review gate. Dispatch only after approval.
+7. Implementer and Coordinator may continue in-wave. `work_class: light` slices go to Light
+   Implementer; `reclassify: judgement` re-dispatches to Implementer. Use visible wave receipts and update implementation and DoD Manifest once per wave.
 
 Return `READY`, `WAITING_ON`, `OWNER_DECISION_REQUIRED`, or `COMPLETE`.
-`max_assurance_rounds` is 1 per declared phase or wave-end, not per Journey;
+`max_assurance_rounds` is 1 per declared phase or wave-end, not per Lifecycle;
 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