doctor: enforce direnv and federate Ting OpenSpec context #89

New issue

Closed

opened 2026-08-26 01:39:24 +00:00 by agent.odin · 0 comments

agent.odin commented

2026-08-26 01:39:24 +00:00

Owner

Proposal

Why

The doctor currently enters nested nix develop shells and has no durable project declaration for its own wiki OpenSpec store. That conceals the actual checkout environment and leaves the engineering contract optional.

Scope

Make the direnv-loaded default flake shell a doctor prerequisite and create a missing tracked .envrc.
Remove nested nix develop wrapping; provide nu and gum through the default devShell.
Reconcile openspec/config.yaml with store: wiki for the project’s own planning root, and keep ting-governance as a separate shared governance reference.
Reconcile the canonical origin remote and retire legacy forge, jo, and sr names.
Declare Ting governance in AGENTS.md; Jostoph remains intentionally unwired as the canonical doctor reference.

Design

The doctor manages the declaration, not user consent: it creates .envrc but leaves direnv allow as the visible acknowledgement. The project wiki is the OpenSpec store. Ting governance is read-only referenced context, never the project store.

Specification Delta

Requirement: doctor runs inside the declared development environment

GIVEN a checkout missing .envrc
WHEN an operator runs the doctor
THEN it creates use flake, requires a subsequently active direnv environment, and runs recipes without nesting nix develop.

Requirement: the project wiki is the OpenSpec store

GIVEN a Ting-governed project
WHEN the doctor runs
THEN openspec/config.yaml sets store: wiki and retains ting-governance only in references: with its remote.

Tasks

Add direnv law and default-shell prerequisites.
Add the wiki store and Ting-governance reference reconciler and initial config.
Update development dependencies, instructions, and the Ting governance declaration.
Verify direnv activation, doctor idempotence, and nix flake check --no-build.

Provenance

Freeholder-directed, 2026-08-26.

## Proposal ### Why The doctor currently enters nested `nix develop` shells and has no durable project declaration for its own wiki OpenSpec store. That conceals the actual checkout environment and leaves the engineering contract optional. ### Scope - Make the direnv-loaded default flake shell a doctor prerequisite and create a missing tracked `.envrc`. - Remove nested `nix develop` wrapping; provide `nu` and `gum` through the default devShell. - Reconcile `openspec/config.yaml` with `store: wiki` for the project’s own planning root, and keep `ting-governance` as a separate shared governance reference. - Reconcile the canonical `origin` remote and retire legacy `forge`, `jo`, and `sr` names. - Declare Ting governance in `AGENTS.md`; Jostoph remains intentionally unwired as the canonical doctor reference. ## Design The doctor manages the declaration, not user consent: it creates `.envrc` but leaves `direnv allow` as the visible acknowledgement. The project wiki is the OpenSpec store. Ting governance is read-only referenced context, never the project store. ## Specification Delta ### Requirement: doctor runs inside the declared development environment - GIVEN a checkout missing `.envrc` - WHEN an operator runs the doctor - THEN it creates `use flake`, requires a subsequently active direnv environment, and runs recipes without nesting `nix develop`. ### Requirement: the project wiki is the OpenSpec store - GIVEN a Ting-governed project - WHEN the doctor runs - THEN `openspec/config.yaml` sets `store: wiki` and retains `ting-governance` only in `references:` with its remote. ## Tasks - [x] Add direnv law and default-shell prerequisites. - [x] Add the wiki store and Ting-governance reference reconciler and initial config. - [x] Update development dependencies, instructions, and the Ting governance declaration. - [x] Verify direnv activation, doctor idempotence, and `nix flake check --no-build`. ## Provenance Freeholder-directed, 2026-08-26.

agent.odin referenced this issue from a commit

2026-08-26 01:40:52 +00:00

doctor: enforce direnv and federate Ting OpenSpec context (#89)

agent.odin referenced this issue from a pull request that will close it,

2026-08-26 01:41:17 +00:00

doctor: enforce direnv and federate Ting OpenSpec context #90

agent.odin referenced this issue from a commit

2026-08-26 03:31:57 +00:00

doctor: enforce direnv and federate Ting OpenSpec context (#89)

agent.odin referenced this issue from a commit

2026-08-26 03:33:30 +00:00

doctor: enforce direnv and federate Ting OpenSpec context (#89)