Skip to content

docs: add RSR-PHILOSOPHY.adoc — canonical 'solutions at source' doctrine#448

Merged
hyperpolymath merged 3 commits into
mainfrom
chore/doctrine-solutions-at-source
Jul 1, 2026
Merged

docs: add RSR-PHILOSOPHY.adoc — canonical 'solutions at source' doctrine#448
hyperpolymath merged 3 commits into
mainfrom
chore/doctrine-solutions-at-source

Conversation

@hyperpolymath

Copy link
Copy Markdown
Owner

Canonical estate operating-doctrine statement + licence-consistency script rework (MPL-2.0 code / CC-BY-SA-4.0 prose split) + several CI reusable-workflow fixes already landed piecemeal (#429-#442) that this branch was stacked on.

Left un-armed for auto-merge deliberately — this declares canonical estate doctrine and should be owner-ratified before merging, not auto-merged.

hyperpolymath and others added 2 commits June 29, 2026 13:13
Canonical prose home for the estate operating doctrine. States 'solutions at
source' (fix the canonical/upstream origin, never the downstream symptom; mind
every up/downstream) alongside 'holes before goals' and 'fail loudly'. The
arrival-pack projects the terse Doctrine summary into every CLAUDE.md; this is
the source of truth rsr-template-repo operationalises and manifesto voices.

Left un-armed for owner ratification (Doctrine is DRAFT-unratified).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@hyperpolymath hyperpolymath enabled auto-merge (squash) July 1, 2026 10:18
@hyperpolymath hyperpolymath disabled auto-merge July 1, 2026 10:26
@hyperpolymath hyperpolymath enabled auto-merge (squash) July 1, 2026 10:26
@hyperpolymath hyperpolymath disabled auto-merge July 1, 2026 10:26
@hyperpolymath hyperpolymath enabled auto-merge (rebase) July 1, 2026 10:26
@hyperpolymath hyperpolymath disabled auto-merge July 1, 2026 10:57
@hyperpolymath hyperpolymath enabled auto-merge (rebase) July 1, 2026 10:57
hyperpolymath added a commit that referenced this pull request Jul 1, 2026
…er (#449)

The `validate-hypatia-baseline` job in `governance-reusable.yml` never
reads `.hypatia-baseline.json`'s content — it just fails on any raw
`hypatia scan` finding with severity >= medium, full stop. The file's
only functional effect is to flip the job's `has_baseline` trigger on
via `[ -f .hypatia-baseline.json ]`. Ours was empty (`[]`) so it was
providing zero exemption value while permanently failing `main`
(confirmed: last 5+ Governance runs on main, back to 2026-06-27, all
failed here) and blocking PR #448.

Removing it unblocks PRs here now. **This is a narrow,
standards-repo-scoped fix — it does not touch `governance-reusable.yml`
itself**, which is shared estate-wide and has the same bug for every
repo that carries a real (non-empty) `.hypatia-baseline.json`. Tracking
issue for the proper estate-wide fix: (linking after filing).

Left un-armed for auto-merge for a quick look, since it touches a
security-scan gate even though it's currently non-functional.
@hyperpolymath hyperpolymath disabled auto-merge July 1, 2026 11:06
hyperpolymath added a commit to hyperpolymath/cicd-squabbler that referenced this pull request Jul 1, 2026
Closes the "no live plumbing" gap the README named as v0.1's next
step, and models a sixth move class mined from a real incident hit
while stewarding the estate's stuck-PR backlog today.

- squabble-cli fetch <owner>/<repo> <pr>: shells to `gh` to pull the
  branch ruleset's required_status_checks and the PR's
  statusCheckRollup, and emits the resulting Gate as JSON -- pipeable
  straight into `squabble diagnose`. Gate-building is a pure,
  fixture-tested function; only the two `gh` calls touch the network.

- Move::FlagNonFunctionalGate: the required check's own script fails
  unconditionally regardless of any exemption file present, so no
  PR-side change can win it. Mined from hyperpolymath/hypatia#566
  (2026-07-01): standards's validate-hypatia-baseline job never read
  .hypatia-baseline.json's content -- confirmed by main itself failing
  the same check for 5+ days independent of any PR. Not auto-appliable;
  the point is recognition + escalation instead of re-proposing
  GroundTruthCheckNames against a deadlock no ground-truthing can fix.

- diagnose_with_hints: a strict refinement of diagnose that lets a
  host with richer context (like fetch's future classifier) supply a
  known Move per required_context instead of the name-only default.
  diagnose itself is untouched -- existing callers see no behaviour
  change.

Dogfooded against a real PR (hyperpolymath/standards#448): fetch
correctly pulled the live ruleset + rollup and diagnose correctly
proposed ground-truthing the one required context with no matching
run name, unprompted.

15/15 tests pass; clippy clean; cargo fmt clean.
@hyperpolymath hyperpolymath merged commit 12ede2e into main Jul 1, 2026
16 checks passed
@hyperpolymath hyperpolymath deleted the chore/doctrine-solutions-at-source branch July 1, 2026 11:06
@sonarqubecloud

sonarqubecloud Bot commented Jul 1, 2026

Copy link
Copy Markdown

hyperpolymath added a commit to hyperpolymath/cicd-squabbler that referenced this pull request Jul 1, 2026
Closes the "no live plumbing" gap the README named as v0.1's next step,
plus a seventh move class grounded in a real incident hit today.

## What's here
- `squabble fetch <owner>/<repo> <pr>` — pulls the real branch ruleset's
required contexts + the PR's realised check runs via `gh`, emits a
`Gate` JSON pipeable straight into `squabble diagnose`. Gate-building is
pure/fixture-tested; only the two `gh` calls touch the network.
- `Move::FlagNonFunctionalGate` (Move 7, alongside the
`LicencePolicyDrift` Move 6 already on main) — models a required check
whose own script fails unconditionally regardless of any exemption file,
so no PR-side move can win it. Mined from `hyperpolymath/hypatia#566`
today. Not auto-appliable — recognition + escalation to a human, not
another guess.
- `diagnose_with_hints` — strict refinement of `diagnose` for a host
with richer classification context. `diagnose` itself is unchanged.

## Proof it works on real data
Dogfooded against `hyperpolymath/standards#448`: `fetch` pulled the live
ruleset + rollup, and `diagnose` — zero hints — correctly proposed
ground-truthing the one required context (`Hypatia Neurosymbolic
Analysis`) with no matching realised run name, unprompted.

Rebased onto current `main` (this branch was originally cut from a stale
local ref of the pre-merge `feat/squabbler-product`); resolved two clean
additive conflicts against main's own `LicencePolicyDrift` work in
`moves.rs`/`lib.rs` by keeping both. 18/18 tests pass, clippy clean,
`cargo fmt` clean.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant