Skip to content

feat(schema): panll-harness/v2 binary_star architecture-declaration fields#26

Merged
hyperpolymath merged 1 commit intomainfrom
feat/harness-schema-binary-star-fields
May 11, 2026
Merged

feat(schema): panll-harness/v2 binary_star architecture-declaration fields#26
hyperpolymath merged 1 commit intomainfrom
feat/harness-schema-binary-star-fields

Conversation

@hyperpolymath
Copy link
Copy Markdown
Owner

Summary

Panels relate to the Binary Star architecture (panes A/L/N/W) by flow and viewing perspective, not single-pane membership. The v2 schema had no fields to express this, blocking downstream consumers (hypatia#197, hypatia#177).

Adds an optional binary_star object to panll-harness/v2:

[binary_star]
spans = ["L", "N"]                  # panes the panel inhabits
flow = ["L", "N", "W"]              # ordered data/control movement
surfaces_in = ["W"]                 # where outputs become visible
perspective = "meta-observer"       # vantage point

Pane letters constrained to enum [A, L, N, W]. perspective is a free string with documented canonical values (observer, meta-observer, actor, sensor, transformer).

Backward compatible — all fields optional; existing valid v2 manifests remain valid. Schema $id and $schema const unchanged.

Unblocks

  • hyperpolymath/hypatia#197 — declare Hypatia panel's flow/perspective
  • hyperpolymath/hypatia#177 (parent design discussion, per #197 reference)

Test plan

  • JSON schema validates as well-formed (python -c "import json; json.load(...)")
  • Run any panll schema validation tests in CI
  • After merge, hypatia harness PR can land its [binary_star] declaration

…claration

Panels relate to the Binary Star architecture (panes A/L/N/W) by flow and
viewing perspective, not single-pane membership. v2 had no schema fields
to express this, blocking work on consumers (hypatia#197, hypatia#177).

Adds an optional `binary_star` object to panll-harness/v2 with four
optional sub-fields:

- spans       — panes the panel inhabits (primary state or computation)
- flow        — ordered sequence of pane letters describing data/control
                movement; order matters, repeats allowed
- surfaces_in — panes where outputs become visible to other panels
- perspective — vantage point within the architecture; canonical values:
                "observer", "meta-observer", "actor", "sensor",
                "transformer"

Pane letters constrained to enum [A, L, N, W] for spans/flow/surfaces_in.

Backward compatible: all fields optional; existing valid v2 manifests
remain valid. Schema $id and $schema const unchanged — still v2.

Example (Hypatia):

    [binary_star]
    spans = ["L", "N"]
    flow = ["L", "N", "W"]
    surfaces_in = ["W"]
    perspective = "meta-observer"

CHANGELOG entry added.

Unblocks hyperpolymath/hypatia#197.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@chatgpt-codex-connector
Copy link
Copy Markdown

Codex usage limits have been reached for code reviews. Please check with the admins of this repo to increase the limits by adding credits.
Credits must be used to enable repository wide code reviews.

@sonarqubecloud
Copy link
Copy Markdown

@hyperpolymath hyperpolymath merged commit 777c89b into main May 11, 2026
16 of 23 checks passed
@hyperpolymath hyperpolymath deleted the feat/harness-schema-binary-star-fields branch May 11, 2026 02:02
hyperpolymath added a commit to hyperpolymath/hypatia that referenced this pull request May 11, 2026
…211)

## Summary

Adds the `[binary_star]` section to
`src/ui/gossamer/panll.harness.toml`:

```toml
[binary_star]
spans = ["L", "N"]
flow = ["L", "N", "W"]
surfaces_in = ["W"]
perspective = "meta-observer"
```

**Rationale** (from #197): Hypatia spans Pane-L (rules engine, safety
triangle, error catalog) and Pane-N (5 neural networks: Graph of Trust,
Mixture of Experts, LSM, ESN, RBF) as a meta-observer of repo state,
with findings/dispatches surfacing in Pane-W. The `clade` field records
topical taxonomy but not architectural relationship; this declaration
fills that gap.

`src/ui/gossamer/README.adoc` updated to point at the `[binary_star]`
section as the concrete declaration, replacing the "tracked as a
follow-up" stub.

## ⚠️ Blocked by

**`hyperpolymath/panll#26`** — the `binary_star` schema fields must
merge in panll before this harness file validates cleanly. Do not merge
this PR before panll#26.

## Closes
- Closes #197

## Test plan
- [ ] After panll#26 merges, validate this harness file against the
updated schema
- [ ] Confirm Gossamer minter accepts the manifest at panel registration
time
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