{"id":50708488,"url":"https://github.com/fraware/conicshield","last_synced_at":"2026-06-09T13:31:54.508Z","repository":{"id":350268568,"uuid":"1202663259","full_name":"fraware/conicshield","owner":"fraware","description":null,"archived":false,"fork":false,"pushed_at":"2026-05-26T06:20:01.000Z","size":759,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-26T06:28:06.160Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fraware.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":"docs/ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-06T09:09:55.000Z","updated_at":"2026-05-26T06:20:05.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/fraware/conicshield","commit_stats":null,"previous_names":["fraware/conicshield"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/fraware/conicshield","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fraware%2Fconicshield","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fraware%2Fconicshield/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fraware%2Fconicshield/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fraware%2Fconicshield/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fraware","download_url":"https://codeload.github.com/fraware/conicshield/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fraware%2Fconicshield/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34110011,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-09T02:00:06.510Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-06-09T13:31:53.622Z","updated_at":"2026-06-09T13:31:54.501Z","avatar_url":"https://github.com/fraware.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n\u003cpre\u003e\n###############################################################################################\n#                     ____            _      ____  _     _      _     _                       #\n#                    / ___|___  _ __ (_) ___/ ___|| |__ (_) ___| | __| |                      #\n#                   | |   / _ \\| '_ \\| |/ __\\___ \\| '_ \\| |/ _ \\ |/ _` |                      #\n#                   | |__| (_) | | | | | (__ ___) | | | | |  __/ | (_| |                      #\n#                    \\____\\___/|_| |_|_|\\___|____/|_| |_|_|\\___|_|\\__,_|                      #\n#                                                                                             #\n###############################################################################################\n\u003c/pre\u003e\n\n[![Python 3.11+](https://img.shields.io/badge/python-3.11%2B-3776AB?logo=python\u0026logoColor=white)](https://www.python.org/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n\n**Runtime safety through convex projection — with evidence you can replay, validate, and cite.**\n\n\u003c/div\u003e\n\nA policy proposes an action. ConicShield solves a constrained optimization problem to find the **nearest admissible** action under explicit safety constraints. The environment sees the **corrected** action. Each step can be recorded as structured, hash-verified benchmark evidence.\n\n---\n\n## Start here (community)\n\n\u003e **Product homepage:** [`docs/COMMUNITY_LAYER.md`](docs/COMMUNITY_LAYER.md)  \n\u003e **v1 release:** [`docs/V1_REFERENCE_RELEASE.md`](docs/V1_REFERENCE_RELEASE.md)  \n\u003e **After install, run:** `make onboard`\n\n| Link | Purpose |\n|------|---------|\n| [Community layer](docs/COMMUNITY_LAYER.md) | Quickstarts, API, examples, public claims |\n| [Published-runs API](docs/PUBLISHED_RUNS_API.md) | Frozen v1 Python + CLI (`list`, `current`, `verify`, …) |\n| [Examples](examples/README.md) | Runnable scripts (researcher + integrator) |\n| [CONTRIBUTING.md](CONTRIBUTING.md) | PR workflow and maintainer targets |\n\nAll public docs: [`docs/README.md`](docs/README.md).\n\n### Try it in about a minute\n\nFrom the repository root (Linux, macOS, or WSL recommended):\n\n```bash\npython3 -m venv .venv\nsource .venv/bin/activate          # Windows: .venv\\Scripts\\activate\npython -m pip install -U pip\npython -m pip install -e \".[dev]\"\nmake onboard\npython examples/load_published_runs_api.py\n```\n\n`make onboard` runs community tests, verifies the flagship bundle integrity, and prints a v1 status snapshot.\n\n---\n\n## How it works\n\n```mermaid\nflowchart LR\n    Q[Scores / Q-values] --\u003e S[ConicShield]\n    S --\u003e A[Corrected action]\n    S --\u003e E[Evidence and metadata]\n    A --\u003e R[Environment]\n```\n\n---\n\n## v1 reference artifact (flagship)\n\n| Item | Value |\n|------|--------|\n| Flagship run | [`host-realistic-20260525`](benchmarks/published_runs/host-realistic-20260525/) |\n| Family | `conicshield-transition-bank-v1` |\n| Evidence tier | `vendor_native`, `real_projector` |\n| Export | `live_upstream_dump` (host-realistic **fork** topology) |\n| Machine status | [`benchmarks/reports/reference_system_status.json`](benchmarks/reports/reference_system_status.json) |\n\n**Read first:** [`COMMUNITY_METADATA.json`](benchmarks/published_runs/host-realistic-20260525/COMMUNITY_METADATA.json) before `summary.json`.\n\n| Artifact | Path |\n|----------|------|\n| Integrity index | [`benchmarks/PUBLISHED_RUN_INDEX.json`](benchmarks/PUBLISHED_RUN_INDEX.json) |\n| Family current | [`benchmarks/releases/conicshield-transition-bank-v1/CURRENT.json`](benchmarks/releases/conicshield-transition-bank-v1/CURRENT.json) |\n| Upstream export | [`benchmarks/external_evidence/offline_graph_export_upstream.json`](benchmarks/external_evidence/offline_graph_export_upstream.json) |\n\n**Scope (honest bounds):** host-realistic **fork** topology only (does not prove full upstream navigation export). Batch narrative is **viability-only** (does not claim throughput wins). Differentiation is **validation-only** (not a public autograd product). Details: [`docs/PUBLIC_CLAIMS.md`](docs/PUBLIC_CLAIMS.md), [`docs/SOLVER_PATHS_AND_BATCHING.md`](docs/SOLVER_PATHS_AND_BATCHING.md), [`docs/DIFFERENTIATION_PUBLIC_STANCE.md`](docs/DIFFERENTIATION_PUBLIC_STANCE.md).\n\n**Constraints in v1:** `simplex`, `turn_feasibility`, `box`, `rate` — not `progress` / `clearance`.\n\n### Consumer API (stable v1)\n\n```python\nfrom conicshield.published_runs import get_current_run, verify_run, load_summary\n\nverify_run(\"host-realistic-20260525\")\nbundle = get_current_run(\"conicshield-transition-bank-v1\")\nprint(bundle.run_id, bundle.community.known_limitations)\n```\n\nCLI: `python -m conicshield.published_runs.cli verify host-realistic-20260525`  \nCanonical walkthrough: [`examples/load_published_runs_api.py`](examples/load_published_runs_api.py)\n\n---\n\n## Installation\n\n### Default (public CI — no vendor secrets)\n\nUse a **virtual environment** on Linux/WSL ([`docs/DEVENV.md`](docs/DEVENV.md)):\n\n```bash\npython -m pip install -e \".[dev]\"\nmake onboard\n```\n\n### Vendor Moreau (optional — native compiled path)\n\nLinux/WSL2 + [Moreau license](https://docs.moreau.so/installation.html). Do not commit tokens or `.env` secrets.\n\n```bash\nexport MOREAU_EXTRA_INDEX_URL=\"https://\u003cTOKEN\u003e:@pypi.fury.io/optimalintellect/\"\nexport MOREAU_LICENSE_KEY=\"\u003cYOUR_MOREAU_LICENSE_KEY\u003e\"\nbash scripts/bootstrap_moreau.sh\npython -m moreau check\n```\n\nLive vendor tests: `python scripts/run_live_vendor_tests.py` ([`tests/live/README.md`](tests/live/README.md)).\n\n---\n\n## Verify before you trust\n\n| Command | Who | What it checks |\n|---------|-----|----------------|\n| `make onboard` | Everyone | Community API, examples smoke, flagship integrity |\n| `make verify-v1-lock-quick` | Auditors | Index, cadence, bundle profile, public claims |\n| `make verify-v1-lock` | Maintainers | Full gate before a public “locked” announcement |\n\n```bash\nmake verify-v1-lock-quick\npython scripts/verify_v1_lock.py --json\n```\n\n---\n\n## Development\n\n| | |\n|:---|:---|\n| **Python** | 3.11+ (CI: 3.11, 3.12) |\n| **Default tests** | `make test` (excludes vendor-only / slow markers) |\n| **Lint / types** | `make lint` · `make typecheck` |\n| **CI overview** | [`docs/DEVENV.md`](docs/DEVENV.md) |\n\nMaintainer publish/refresh: `make verify-reference-system`, `make host-realistic-refresh-cycle-licensed` — see [`CONTRIBUTING.md`](CONTRIBUTING.md).\n\n---\n\n## Repository layout\n\n```text\nconicshield/          # library: core, specs, governance, published_runs API\nbenchmarks/           # published_runs/, releases/, reports/\nexamples/             # public runnable scripts\ndocs/                 # start at COMMUNITY_LAYER.md\nscripts/              # maintainer and verification CLIs\ntests/                # pytest\nschemas/              # bundle JSON Schema\n```\n\n---\n\n## Design principles\n\n1. **Formal intent, operational enforcement** — constraints are not decorative.\n2. **Minimal intervention** — project only as far as safety requires.\n3. **Evidence by default** — shield steps are recordable and indexable.\n4. **Reproducible bundles** — benchmarks are artifacts, not ad hoc logs.\n5. **Parity before trust** — native paths must match the governed reference stream.\n6. **Families, not silent overwrites** — semantic changes fork benchmark families.\n\n---\n\n## License\n\nMIT — see [LICENSE](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffraware%2Fconicshield","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffraware%2Fconicshield","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffraware%2Fconicshield/lists"}