Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 6 additions & 6 deletions DOCUMENTATION_INDEX.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

---

Expand Down Expand Up @@ -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. |
Expand All @@ -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. |
Expand All @@ -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`.
7 changes: 7 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -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.
Expand All @@ -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
Expand Down
22 changes: 22 additions & 0 deletions RELEASING.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
11 changes: 11 additions & 0 deletions SYSTEM_CONTEXT_DIAGRAM.md
Original file line number Diff line number Diff line change
@@ -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
Expand All @@ -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
Expand Down
Loading