Skip to content

feat(milestone-4): distribute Orinoco Lite downstream sites - #5

Merged
leej3 merged 65 commits into
mainfrom
codex/milestone-4
Aug 13, 2026
Merged

feat(milestone-4): distribute Orinoco Lite downstream sites#5
leej3 merged 65 commits into
mainfrom
codex/milestone-4

Conversation

@leej3

@leej3 leej3 commented Aug 13, 2026

Copy link
Copy Markdown
Collaborator

AI-generated draft — not reviewed by John

Summary

  • release the content-neutral Orinoco Lite engine and deterministic runtime
  • publish a versioned Copier/GitHub template with explicit ownership and review-only updates
  • migrate the complete accepted CON content and test contract into an ordinary downstream repository
  • document the current three-layer architecture and prioritized human-review queue
  • adopt the project license matrix and retire automatic legacy preview deployment

Accepted Milestone 4 boundary

John accepted the single-repository distribution architecture in HR-001. Original Orinoco Lite engine/template software is MIT; original documentation and editorial prose are CC BY 4.0; factual metadata and machine-readable factual projections are CC0 1.0; upstream licenses remain intact; and media, logos, and branding remain item-specific.

HR-004 retains the Milestone 3 branch and deployment history as frozen evidence while making any engineering preview explicitly dispatched. The complete downstream consumer remains the supported integration and publication surface.

The public test consumer has exercised the corrected compatibility update, a later template-maintenance update, a site-owned presentation change, and reviewed default-branch project Pages. The accepted snapshot remains complete rather than representative.

The real-site repository was not modified. Milestone 4 acceptance does not approve production content or authorize a production cutover. Atomic P1 decisions in docs/human-review-decisions.md remain before real-site graduation.

Evidence

See README.md for the architecture, docs/human-review-decisions.md for accepted P0 and open P1/P2 decisions, docs/milestone-4-acceptance.md for exact evidence, and LICENSES.md for the license matrix.

leej3 and others added 30 commits August 6, 2026 10:10
Co-Authored-By: Codex CLI 0.143.0 / GPT 5.6-sol <codex@openai.com>
Co-Authored-By: Codex CLI 0.143.0 / GPT 5.6-sol <codex@openai.com>
Co-Authored-By: Codex CLI 0.143.0 / GPT 5.6-sol <codex@openai.com>
Co-Authored-By: Codex CLI 0.143.0 / GPT 5.6-sol <codex@openai.com>
Co-Authored-By: Codex CLI 0.143.0 / GPT 5.6-sol <codex@openai.com>
Use the tracked upstream pool UI deployment branch with local Dump Things, real seeded pool records, generated schema assets, and a git-annex-backed p2p endpoint. Add Pixi tasks, contract checks, and provenance documenting the local curation semantics.

Co-Authored-By: Codex CLI 0.143.0 / GPT 5.6-sol <codex@openai.com>
Mirror the upstream dependency set under leej3, preserve dump-research-info on con as the migration input, and update nested submodule URLs and provenance.

Co-Authored-By: Codex CLI 0.143.0 / GPT 5.6-sol <codex@openai.com>
Run the recursive checkout, snapshot preparation, Hugo and pool UI builds as Pixi dependencies, then supervise Dump Things, seeding, git-annex, SHACL Vue, and the generated site from one command. Keep the individual service tasks and a static-only preview for debugging.

Co-Authored-By: Codex CLI 0.143.0 / GPT 5.6-sol <codex@openai.com>
Document the user's preference for Conventional Commits and approximately 80-column wrapping for commit messages, logs, and documentation prose.

Co-Authored-By: Codex CLI 0.143.0 / GPT 5.6-sol <codex@openai.com>
Limit the 80-column preference to commit messages and record the Snapper pre-commit hook for documentation formatting.

Co-Authored-By: Codex CLI 0.143.0 / GPT 5.6-sol <codex@openai.com>
Pin Snapper and pre-commit in Pixi, provide a local semantic-line hook, and add commands to install and check formatting.

Co-Authored-By: Codex CLI 0.143.0 / GPT 5.6-sol <codex@openai.com>
Apply semantic line breaks to the existing Markdown corpus so future prose edits produce focused diffs.

Co-Authored-By: Codex CLI 0.143.0 / GPT 5.6-sol <codex@openai.com>
Install Dump Things in the locked Pixi environment with exact LinkML,
LinkML Runtime, Pydantic, and RDFLib selections.

Make the development checkout unshallow and verify every recursive
submodule at its recorded gitlink, while preserving the targeted shallow
static builder.

Co-Authored-By: Codex CLI 0.143.0 / GPT 5.6-sol <codex@openai.com>
Document the verified source-schema path where explicit dlthings CURIEs
pass native relationship and identifier round trips.

Record that full-URI designators and the vendored resolved schema remain
unsupported, and exclude the experimental LinkML and schema candidate
work.

Co-Authored-By: Codex CLI 0.143.0 / GPT 5.6-sol <codex@openai.com>
Make clean migration the active local effort and confine direct
upstream ancestry to the two-commit site branch.

Document the profile boundaries, four isolated collections, CURIE
contract, acceptance gates, deferred work, and exact rebase drill.

Co-Authored-By: Codex CLI 0.143.0 / GPT 5.6-sol <codex@openai.com>
Render the reviewed CON metadata through the pinned source schema and
upstream presentation code. Verify native CURIE round trips, component
pins, assets, graph closure, and byte-identical static output before
accepting the committed snapshot.

Preserve the German upstream build as an explicit reference interface
and keep its annex hydration local and temporary.

Co-Authored-By: Codex CLI 0.143.0 / GPT 5.6-sol <codex@openai.com>
Run separate public and protected collection pairs for the cached German
snapshot and the clean CON slice. Give the editor write access only to
the CON incoming boundary and keep projection reads on CON public.

Seed and audit all four collections deterministically, reject obsolete
stores, and supervise the local services with reliable signal cleanup.

Co-Authored-By: Codex CLI 0.143.0 / GPT 5.6-sol <codex@openai.com>
Select the locally accepted two-commit CON site overlay at its reviewed
upstream ancestry. Keep every legacy CON ref and the sibling upstream
reference checkout unchanged.

Co-Authored-By: Codex CLI 0.143.0 / GPT 5.6-sol <codex@openai.com>
Freeze the accepted clean-migration checkpoint and make the local-only
full-content successor the active effort.

Document canonical content authority, reviewable batches, generated snapshot
policy, acceptance, and upstream synchronization.

Co-Authored-By: Codex CLI 0.143.0 / GPT 5.6-sol <codex@openai.com>
Derive projection, graph, asset, presentation, and local-stack contracts.

Pin the cross-platform runtime and add fail-closed deterministic acceptance.

Co-Authored-By: Codex CLI 0.143.0 / GPT 5.6-sol <codex@openai.com>
Point the coordinator at the reviewed terminal full-site snapshot.

Co-Authored-By: Codex CLI 0.143.0 / GPT 5.6-sol <codex@openai.com>
Accept the reviewed Milestone 2 checkpoints and define the publication,
Pages preview, static editing, dependency, and human-decision boundaries
for Milestone 3.

Co-Authored-By: Codex CLI 0.143.0 / GPT 5.6-sol <codex@openai.com>
Pin the audited pool UI dependency refresh and credential-free static review
bundle export used by the Pages preview.

Co-Authored-By: Codex CLI 0.143.0 / GPT 5.6-sol <codex@openai.com>
Build and audit a deterministic GitHub Pages project artifact with the
credential-free SHACL Vue editor and locally validated review bundles.

Exercise the published edit path in Chromium without a backend write and keep
pull-request workflows outside the deployment permission boundary.

Co-Authored-By: Codex CLI 0.143.0 / GPT 5.6-sol <codex@openai.com>
Pin the deterministic public Zotero API capture, reviewed publication export,
and fail-closed migration-boundary hardening used by the Milestone 3 site.

Co-Authored-By: Codex CLI 0.143.0 / GPT 5.6-sol <codex@openai.com>
Clear token state in credential-free mode, bind build labels to committed
identity instead of local branch state, and compile the editor twice before
accepting two deterministic Pages artifacts.

Co-Authored-By: Codex CLI 0.143.0 / GPT 5.6-sol <codex@openai.com>
Point the coordinating repository at the reviewed publication and static
preview snapshot after deterministic projection regeneration.

Co-Authored-By: Codex CLI 0.143.0 / GPT 5.6-sol <codex@openai.com>
Canonicalize RDF blank nodes and sort the N-Triples subset before
packaging the static editor. This makes repeated builds byte-identical
without changing the RDF graph consumed by SHACL Vue.

Co-Authored-By: Codex CLI 0.143.0 / GPT 5.6-sol <codex@openai.com>
Prefix the exact setup-pixi version with v as required by the pinned\naction while retaining the locked 0.73.0 runtime.

Co-Authored-By: Codex CLI 0.143.0 / GPT 5.6-sol <codex@openai.com>
Pin the wrapper fix that removes generated runtime plugins before each build so fresh and repeated Pages editor bundles are byte-identical.

Add the fresh-checkout regression contract and record the reviewed wrapper commit.

Co-Authored-By: Codex CLI 0.143.0 / GPT 5.6-sol <codex@openai.com>
leej3 and others added 28 commits August 11, 2026 22:42
Advance the reviewed site gitlink to the profile-local layout overrides and
refreshed terminal assembly digest. The site now avoids platform-specific Hugo
image derivatives while preserving the upstream presentation history.

Co-Authored-By: Codex CLI 0.143.0 / GPT 5.6-sol <codex@openai.com>
Pin the platform-independent site snapshot and record the final local editor,
Pages, graph, and payload reproducibility evidence for human review.

Co-Authored-By: Codex CLI 0.143.0 / GPT 5.6-sol <codex@openai.com>
Include the base-path-aware artwork shortcode in the isolated layout closure and
the platform-dependent image transformation ban.

Co-Authored-By: Codex CLI 0.143.0 / GPT 5.6-sol <codex@openai.com>
Keep full-resolution editorial artwork click-driven by failing the static
artifact audit whenever Quicklink remains in built HTML or JavaScript.

Co-Authored-By: Codex CLI 0.143.0 / GPT 5.6-sol <codex@openai.com>
Advance the reviewed site pin after disabling speculative link prefetches
and preserving full-resolution Engage artwork behind lightweight previews.

Co-Authored-By: Codex CLI 0.143.0 / GPT 5.6-sol <codex@openai.com>
Update the accepted site pin, reproducible artifact digests, and network
contract after making full-resolution Engage artwork explicitly click-driven.

Co-Authored-By: Codex CLI 0.143.0 / GPT 5.6-sol <codex@openai.com>
Record the reviewed canonical-content, parent-gitlink, and public editor
catalog decisions across the Milestone 3 contract and acceptance notes.

Co-Authored-By: Codex CLI 0.143.0 / GPT 5.6-sol <codex@openai.com>
Adopt the complete-content single-repository contract, record ownership and
release boundaries, and make the real CON site explicitly read-only.

Co-Authored-By: Codex CLI 0.143.0 / GPT 5.6-sol <codex@openai.com>
Add the location-independent engine, deterministic runtime assembly,
semantic projection validation, static editor v2, asset hydration, and
release/reusable workflows for flattened downstream sites.

Co-Authored-By: Codex CLI 0.143.0 / GPT 5.6-sol <codex@openai.com>
Pin the package, Python, Node, and npm build toolchain. Force stable
Git author and committer metadata for copied editor sources, and compare
two independently built editor shells before accepting runtime bytes.

Co-Authored-By: Codex CLI 0.143.0 / GPT 5.6-sol <codex@openai.com>
Install the exact YAML parser before reading the reviewed runtime spec and
running the release assembler. Advance the first publishable engine and
runtime coordinate to 0.1.1 without moving the preserved v0.1.0 tag.

Co-Authored-By: Codex CLI 0.143.0 / GPT 5.6-sol <codex@openai.com>
Write checksum entries using release-asset basenames so a downloaded
candidate verifies directly. Advance the preserved candidate coordinate to
0.1.2 without moving either earlier evidence tag.

Co-Authored-By: Codex CLI 0.143.0 / GPT 5.6-sol <codex@openai.com>
Validate the manifest's PEP 440 Hugo range and Extended variant before build outputs are replaced.

Add hermetic compatibility tests and the v0.1.3 runtime specification.

Co-Authored-By: Codex CLI 0.143.0 / GPT 5.6-sol <codex@openai.com>
Prefix the exact Pixi release with v so setup-pixi accepts consumer and Pages workflow inputs.

Co-Authored-By: Codex CLI 0.143.0 / GPT 5.6-sol <codex@openai.com>
Treat only root Dump Things control markers as non-record metadata.

Reopen the flattened verified runtime cache and preserve the configured
site identity while normalizing workspace paths.

Co-Authored-By: Codex CLI 0.143.0 / GPT 5.6-sol <codex@openai.com>
Disable Python bytecode writes for every released runtime driver.

Prove repeated imports preserve the exact verified inventory, even when a
caller attempts to override the safety boundary.

Co-Authored-By: Codex CLI 0.143.0 / GPT 5.6-sol <codex@openai.com>
Document the released check task and the explicit reviewed-coordinate update command.

Co-Authored-By: Codex CLI 0.143.0 / GPT 5.6-sol <codex@openai.com>
Keep the root projection .gitattributes file byte-exact across updates.

Exclude only that control sidecar from deterministic projection comparison;
continue rejecting every arbitrary generated sidecar.

Co-Authored-By: Codex CLI 0.143.0 / GPT 5.6-sol <codex@openai.com>
Recognize the optional conda-forge revision segment while retaining the
exact supported version range and Extended-edition requirement.

Cover macOS and Linux release output plus strict malformed and incompatible
variants, and record the compatibility-only v0.1.7 runtime source.

Co-Authored-By: Codex CLI 0.143.0 / GPT 5.6-sol <codex@openai.com>
Inject one deterministic, PID-bound editor link when a downstream
layout override omits the upstream footer link. Audit the generated
artifact so missing, duplicate, malformed, or mismatched links fail
closed.

Co-Authored-By: Codex CLI 0.143.0 / GPT 5.6-sol <codex@openai.com>
Include each catalog PID in the static editor checkbox accessibility
name while preserving visible RDF identity and review-bundle semantics.
Apply the source overlay fail-closed during deterministic editor builds.

Co-Authored-By: Codex CLI 0.143.0 / GPT 5.6-sol <codex@openai.com>
Record immutable engine and template releases, the full-content consumer update, dual-platform validation, offline operation, editor application, and exact rollback evidence.

Keep acceptance pending human review, merge, default-branch validation, Pages deployment, and public project-path verification.

Co-Authored-By: Codex CLI 0.143.0 / GPT 5.6-sol <codex@openai.com>
Prevent engineering review synchronizations from recursively checking out the legacy site through the Milestone 3 Pages preview workflow.

Record the cancelled read-only preview run and its no-deployment result in the acceptance evidence.

Co-Authored-By: Codex CLI 0.143.0 / GPT 5.6-sol <codex@openai.com>
Contain recursive Pydantic model construction behind a locked temporary recursion limit that restores caller state.

Accept root-relative build and editor URLs while preserving absolute Pages output and the pinned schema contract.

Co-Authored-By: Codex CLI 0.143.0 / GPT 5.6-sol <codex@openai.com>
Supersede the earlier runtime, template, and consumer coordinates with the releases that contain the recursive-model boundary, host-neutral local output, and ordinary framework payloads.

Record the exact local, offline, Linux hosted, and still-queued macOS evidence without crossing the human merge or Pages publication boundary.

Co-Authored-By: Codex CLI 0.143.0 / GPT 5.6-sol <codex@openai.com>
Add a prioritized, source-crosswalked decision queue and refresh the engineering, engine, milestone, and historical documentation around the current single-repository architecture.

Separate technical distribution acceptance from licensing, production content, governance, presentation, and real-site graduation decisions.

Co-Authored-By: Codex Desktop 26.803.61601 (runtime codex-cli 0.147.0-alpha.6.5) / gpt-5.6-sol <codex@openai.com>

Codex-Reasoning-Effort: ultra
Record HR-004 as an accepted policy retaining frozen legacy preview evidence while disabling automatic downstream manifestation.

Define synthetic, production-shaped, and complete-consumer validation layers for candidate engineering previews.

Co-Authored-By: Codex Desktop 26.803.61601 (runtime codex-cli 0.147.0-alpha.6.5) / luna <codex@openai.com>

Codex-Reasoning-Effort: medium
License original software and template code under MIT, factual metadata under CC0 1.0, and original prose under CC BY 4.0 while preserving upstream and item-specific media terms.

Accept Milestone 4, retain production graduation as a separate review, and make the historical engineering preview explicitly dispatched only.

Co-Authored-By: Codex Desktop 26.803.61601 (runtime codex-cli 0.147.0-alpha.6.5) / gpt-5.6-sol <codex@openai.com>

Codex-Reasoning-Effort: low
@leej3
leej3 marked this pull request as ready for review August 13, 2026 19:20
@leej3
leej3 merged commit 2b18701 into main Aug 13, 2026
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