diff --git a/DOCUMENTATION_INDEX.md b/DOCUMENTATION_INDEX.md index 69e9284..825b9a2 100644 --- a/DOCUMENTATION_INDEX.md +++ b/DOCUMENTATION_INDEX.md @@ -5,9 +5,9 @@ Rule**: every project maintains exactly three core docs — an overview (README) context diagram, and this index linking everything together. The Product Design Document is the canonical authority spec on top of those. -- **Repo:** `/Users/ernestprovo/dev/conclave/` -- **Version:** 1.2.0 · **License:** MIT -- **Last updated:** 2026-07-19 +- **Repo:** `~/dev/conclave/` +- **Version:** 1.3.0 · **License:** MIT +- **Last updated:** 2026-11-06 --- @@ -98,7 +98,7 @@ Run: `pytest` (config in `pyproject.toml`, `asyncio_mode = "auto"`). | File | Path | Purpose | |------|------|---------| | Packaging | [`pyproject.toml`](pyproject.toml) | hatchling build, deps (httpx, pydantic, rich, typer, pyyaml — no LLM SDK), dev extras, console script, pytest config. License: MIT. **PyPI distribution name `conclave-cli`** (the name `conclave` is an unrelated project); command + import stay `conclave`. | -| Release runbook | [`RELEASING.md`](RELEASING.md) | Operator runbook: one-time PyPI OIDC Trusted-Publisher setup for `conclave-cli`, cut-a-release checklist (bump→tag→publish Release), post-release verification (Sigstore bundle, PEP 740 attestations), rollback/yank. | +| Release runbook | [`RELEASING.md`](RELEASING.md) | Operator runbook: TheDataExperts ownership and preserved company publisher, next-release upload/provenance proof, PyPI OIDC Trusted-Publisher setup for `conclave-cli`, cut-a-release checklist (bump→tag→publish Release), post-release verification (Sigstore bundle, PEP 740 attestations), rollback/yank. | | Changelog | [`CHANGELOG.md`](CHANGELOG.md) | Keep-a-Changelog history through v1.2.0. | | Dev lockfile | [`requirements-dev.lock`](requirements-dev.lock) | Hash-pinned dev + runtime tree for reproducible installs/CI. Regenerate via `uv pip compile --universal --generate-hashes --python-version 3.11 --extra dev pyproject.toml -o requirements-dev.lock`. | | License | [`LICENSE`](LICENSE) | MIT License. Copyright (c) 2026 Ernest Provo. Matches the `pyproject.toml` license field. | @@ -118,6 +118,7 @@ Run: `pytest` (config in `pyproject.toml`, `asyncio_mode = "auto"`). | Date | Change | |------|--------| +| 2026-11-06 | Recorded TheDataExperts PyPI ownership and Active billing; preserved the existing company-repository publisher with blank environment. No upload today; published 1.3.0 unchanged and next normal release upload/provenance proof outstanding. | | 2026-07-19 | Reconciled the decision-quality roadmap to released v1.2.0 and active H1 pilot preparation. Recorded the 12-cell paid correctness smoke, isolated three-provider connectivity check, synthetic-pack evidence boundary, and two-human-grader calibration plan. Decision quality and efficiency remain unvalidated. | | 2026-07-18 | Released v1.2.0: Elite, constrained-choice vote, every-mode manifest hardening, the capped paid-exploratory evaluation runner, strict OpenAI-compatible verdict extraction, and org-repository release identities. The live lane remains correctness-only; no quality or efficiency claim. | | 2026-07-18 | Implemented the sequential paid exploratory runner: default dry-run, exact USD 10.00 execute approval, reservation-before-call, one in-flight call, and no-repeat resume. The 24-task fixture remains offline/open-book and is not the paid smoke corpus; the smoke is correctness-only and not decision eligible. | @@ -141,8 +142,7 @@ Run: `pytest` (config in `pyproject.toml`, `asyncio_mode = "auto"`). - Exactly **3 core docs** (README, System Context Diagram, this index); the PDD is the authority spec layered on top. -- Each doc stays **under 500 lines**; overflow is archived to dated/topic files and linked - from here. +- Keep docs current and navigable; archive stale material, never solely to meet a line count. - Prefer **editing existing docs** over creating new ones. Check this index before adding any new document. - The **PDD is canonical**; on any conflict, defer to `docs/PRODUCT_DESIGN_DOCUMENT.md`. diff --git a/README.md b/README.md index 0e547d2..22284c0 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,7 @@ # conclave +Last updated: 2026-11-06 + A bring-your-own-keys **multi-model council** — a CLI and Python library that fans a prompt out to several foundation models concurrently (each via *your own* API keys) and merges their answers into one consolidated response. @@ -18,6 +20,11 @@ logged. Published v1.2 ships six modes: **synthesize** (merge answers into one), (quality-first independent answers → claim audits → revisions → verdict). conclave is intentionally lightweight — a small council primitive, not an agent framework. +`conclave-cli` is owned by the [TheDataExperts PyPI organization](https://pypi.org/org/TheDataExperts/). +The existing company-repository Trusted Publisher was preserved on 2026-11-06; +no upload occurred and PyPI remains at 1.3.0. The next normal release must still +prove OIDC upload and provenance; see [publishing status](RELEASING.md#ownership-and-publishing-status--2026-11-06). + **The v1.1 wedge — the execution-traceable council.** Decision/review synthesis runs can yield **a multi-model council verdict you can inspect — structured, scored for agreement, and execution-traceable**: a diff --git a/RELEASING.md b/RELEASING.md index 5c157be..3ca54c8 100644 --- a/RELEASING.md +++ b/RELEASING.md @@ -41,6 +41,28 @@ a token upload. --- +### Ownership and publishing status — 2026-11-06 + +Both `conclave-cli` and `mcp-warden-cli` now belong to the +[TheDataExperts PyPI organization](https://pypi.org/org/TheDataExperts/), +transferred from `z3usalmighte` direct ownership. Organization billing is Active; +Ernest (`z3usalmighte`) remains its sole human owner. Both projects have a normal +Trusted Publisher for their respective `DataScience-EngineeringExperts` repository, +`release.yml`, with a blank environment matching the workflows. No pending +publishers remain in the inspected account. + +The existing Conclave company-repository publisher was preserved during the +ownership transfer. No upload or release was performed on 2026-11-06; the published +version remains **1.3.0**. Current publisher configuration and ownership are not +proof of a new upload: the next normal release must pass OIDC publication and the +post-release provenance checks in section 2. + +The account-wide upload token was revoked. The retained project-scoped manual +fallback is for `mcp-warden-cli` only; it does not authorize Conclave uploads. +Conclave's release workflow continues to use OIDC without a token fallback. + +--- + ## 1. Cut a release Do this on a clean checkout of `main` with all intended release changes merged. diff --git a/SYSTEM_CONTEXT_DIAGRAM.md b/SYSTEM_CONTEXT_DIAGRAM.md index 7384d58..8364282 100644 --- a/SYSTEM_CONTEXT_DIAGRAM.md +++ b/SYSTEM_CONTEXT_DIAGRAM.md @@ -1,5 +1,7 @@ # conclave — System Context Diagram +Last updated: 2026-11-06 + This is one of conclave's three core docs (per the 3-Core Documentation Rule). It shows the system context: how a user (or a downstream consumer) drives conclave, how config and environment-variable keys feed in, how requests reach the nine first-class providers through @@ -15,6 +17,15 @@ The DSE-708 edge includes offline replay plus an opt-in, capped paid exploratory --- +## Distribution boundary + +`release.yml` publishes `conclave-cli` from `DataScience-EngineeringExperts/conclave` +via its normal PyPI Trusted Publisher (blank environment). The package now belongs +to the [TheDataExperts PyPI organization](https://pypi.org/org/TheDataExperts/); +the existing publisher was preserved on 2026-11-06. No upload occurred and PyPI +remains at 1.3.0. The next normal release must establish fresh upload/provenance +proof; see [`RELEASING.md`](RELEASING.md). + ## System context ```mermaid