r2s 0.2.1__tar.gz

r2s-0.2.1/CHANGELOG.md

@@ -0,0 +1,101 @@
+# Changelog
+
+All notable changes to **r2s** are recorded here with **full Git commit SHAs**.
+Verify any entry:
+
+```bash
+git cat-file -t <sha>    # expect: commit
+git log -1 --oneline <sha>
+```
+
+Style: [Keep a Changelog](https://keepachangelog.com/).
+
+---
+
+## [Unreleased]
+
+## [0.2.1] — 2026-09-20
+
+### Added
+- First production PyPI publish via Trusted Publishing (`v0.2.1` GitHub Release)
+
+### Changed
+- Package version bump 0.2.0 → 0.2.1 (0.2.0 remains on TestPyPI)
+
+
+**Packaging PR #10 merge tip:** `dc824bcee62f6f9ec92ee6755f2ebe4fa8317588`
+
+### Added
+- PyPI packaging metadata (0.2.0), Trusted Publishing workflow, packaged schemas for wheel installs
+- `docs/publishing.md` Trusted Publishing checklist
+
+**main tip (after identity harden):** `4bdb13527ad0531e86fd86515f606908d267adb8`
+
+Public hardening tracked in GitHub Issues (social preview, release tags, etc.).
+
+---
+
+## [0.2.0] — 2026-09-20 — reference runtime
+
+| | SHA |
+|-|-----|
+| Tip (outcome log) | `2133fb986be9c015179f9aedb1203b0f61d13000` |
+| Merge (PR #1) | `8eb906635969c28b5d4fa8893587f4452f63a951` |
+| Runtime feature | `0f60af7911fd361bdc1549f05a63f399d84712eb` |
+| Build-artifact ignore | `72f1fb9875f4586ca0ad3ac4e59a046031d4bd75` |
+| PR | https://github.com/ao3575911/r2s/pull/1 |
+
+### Added
+- Python package `r2s` (`score`, `should_kill`, `rank`, `handoff`, `load_board` / `load_card`)
+- CLI + pytest GitHub Actions workflow
+- Cycle 1 ship outcome (`examples/outcome.runtime.example.json`)
+
+### Changed
+- Ignore egg-info build artifacts
+
+### Verified object types
+```text
+8eb906635969c28b5d4fa8893587f4452f63a951  merge
+0f60af7911fd361bdc1549f05a63f399d84712eb  feat runtime
+72f1fb9875f4586ca0ad3ac4e59a046031d4bd75  chore
+2133fb986be9c015179f9aedb1203b0f61d13000  outcome log
+```
+
+---
+
+## [0.1.0] — 2026-09-20 — spec contract
+
+| | SHA |
+|-|-----|
+| Initial spec tree | `9ca117eaa83d2abc18d2d233eb12f6ac6ce21af6` |
+| Brand / README / MIT | `a96fd16ff8a461b0fb6d43b5686edfe8a6041613` |
+| Cycle 0 outcome + cycle 1 handoff draft | `8b5e0f65c275645be0fbc699ff22a69e53167711` |
+
+### Added
+- JSON Schemas: card, board, handoff, outcome, scoring
+- `docs/SPEC.md`, examples, MIT license
+- Brand assets + professional README
+- Cycle 0 ship outcome; cycle 1 runtime handoff packet
+
+### Verified object types
+```text
+9ca117eaa83d2abc18d2d233eb12f6ac6ce21af6  initial
+a96fd16ff8a461b0fb6d43b5686edfe8a6041613  brand harden
+8b5e0f65c275645be0fbc699ff22a69e53167711  cycle 0 outcome
+```
+
+---
+
+## Identity
+
+| Field | Value |
+|-------|--------|
+| Repository | https://github.com/ao3575911/r2s |
+| Default branch | `main` |
+| Owner | [ao3575911](https://github.com/ao3575911) |
+| License | MIT |
+| Normative contract | `docs/SPEC.md` + `schemas/` |
+| Brand mark | ↻ |
+| Changelog | this file (SHA-verified) |
+| Security | `SECURITY.md` |
+

r2s-0.2.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Adam O'Connor (ao3575911)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

r2s-0.2.1/MANIFEST.in

@@ -0,0 +1,6 @@
+include LICENSE
+include README.md
+include CHANGELOG.md
+include SECURITY.md
+recursive-include src/r2s/schemas *.schema.json
+recursive-include schemas *.schema.json

r2s-0.2.1/PKG-INFO

@@ -0,0 +1,117 @@
+Metadata-Version: 2.4
+Name: r2s
+Version: 0.2.1
+Summary: Reference runtime for the r2s research-to-ship JSON Schema contract
+Author: ao3575911
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/ao3575911/r2s
+Project-URL: Repository, https://github.com/ao3575911/r2s
+Project-URL: Changelog, https://github.com/ao3575911/r2s/blob/main/CHANGELOG.md
+Project-URL: Issues, https://github.com/ao3575911/r2s/issues
+Project-URL: Documentation, https://github.com/ao3575911/r2s/blob/main/docs/SPEC.md
+Keywords: json-schema,research,handoff,ranking,specification
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: jsonschema<5,>=4.22
+Requires-Dist: referencing<1,>=0.35
+Provides-Extra: dev
+Requires-Dist: pytest<9,>=8; extra == "dev"
+Requires-Dist: build<2,>=1.2; extra == "dev"
+Requires-Dist: twine<7,>=5; extra == "dev"
+Dynamic: license-file
+
+<p align="center">
+  <img src="docs/brand/icon.png" alt="r2s" width="96" height="96" />
+</p>
+
+<h1 align="center">r2s</h1>
+
+<p align="center">
+  <strong>↻ research → rank → ship</strong><br />
+  JSON Schema contract for turning research signals into repo and library work.
+</p>
+
+<p align="center">
+  <img src="docs/brand/loop.gif" alt="sense → rank → handoff → ship" width="640" />
+</p>
+
+<p align="center">
+  <a href="docs/SPEC.md"><img src="https://img.shields.io/badge/spec-v0.1.0-5eead4?style=flat-square" alt="spec v0.1.0" /></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-0f1115?style=flat-square" alt="MIT" /></a>
+  <a href="CHANGELOG.md"><img src="https://img.shields.io/badge/changelog-SHA%20verified-5eead4?style=flat-square" alt="changelog" /></a>
+  <img src="https://img.shields.io/badge/runtime-Python%203.11%2B-8b949e?style=flat-square" alt="Python runtime" />
+</p>
+
+---
+
+## What this is
+
+**r2s** is a small, versioned contract — not an agent and not a framework.
+
+You normalize research into **cards**, **rank** them with an explicit score, emit a fixed **handoff** for whoever builds, then record an **outcome** so the next cycle is smarter.
+
+**v0.1.0** is the schema contract; **v0.2.0** adds a thin Python reference runtime. Both obey `docs/SPEC.md`. Public history with full commit SHAs: [`CHANGELOG.md`](CHANGELOG.md).
+
+## Quick start
+
+1. Read the normative rules: [`docs/SPEC.md`](docs/SPEC.md)
+2. Copy [`examples/board.example.json`](examples/board.example.json)
+3. Validate with any JSON Schema Draft 2020-12 validator against [`schemas/`](schemas/)
+
+## Loop
+
+| Stage | Artifact | Role |
+|-------|----------|------|
+| Sense | `card` | Normalize a research signal |
+| Rank | `board` + scoring rules | Order work; kill weak cards |
+| Handoff | `handoff` | 7-part ship packet for implementers |
+| Ship / learn | `outcome` | Close the loop |
+
+**Score**
+
+```text
+S = (novelty × evidence_strength × usability × dependency_fit)
+  / (hours + compute_cost + blast_radius)
+```
+
+Kill when usability or dependency fit ≈ 0, or `target_repo` is missing at design+.
+
+## Layout
+
+```text
+schemas/          card · board · handoff · outcome · scoring
+docs/SPEC.md      normative rules
+docs/brand/       icon · social · README loop GIF
+examples/         worked board + handoff (this repo as the sample)
+```
+
+## Brand
+
+| | |
+|-|-|
+| Mark | stacked cards → chevron (cyan on charcoal) |
+| Emoji | ↻ |
+| Accent | `#5eead4` on `#0f1115` |
+
+## Security
+
+Card fields are **untrusted data**. Validators must not execute claim or evidence strings. This repo holds no credentials and no network clients.
+
+## Changelog & identity
+
+Ship history is **SHA-verified** in [`CHANGELOG.md`](CHANGELOG.md). Security posture: [`SECURITY.md`](SECURITY.md).
+
+Current `main` tip at publish of this note is recorded in the changelog Unreleased/latest section after each merge.
+
+## License
+
+[MIT](LICENSE)

r2s-0.2.1/README.md

@@ -0,0 +1,86 @@
+<p align="center">
+  <img src="docs/brand/icon.png" alt="r2s" width="96" height="96" />
+</p>
+
+<h1 align="center">r2s</h1>
+
+<p align="center">
+  <strong>↻ research → rank → ship</strong><br />
+  JSON Schema contract for turning research signals into repo and library work.
+</p>
+
+<p align="center">
+  <img src="docs/brand/loop.gif" alt="sense → rank → handoff → ship" width="640" />
+</p>
+
+<p align="center">
+  <a href="docs/SPEC.md"><img src="https://img.shields.io/badge/spec-v0.1.0-5eead4?style=flat-square" alt="spec v0.1.0" /></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-0f1115?style=flat-square" alt="MIT" /></a>
+  <a href="CHANGELOG.md"><img src="https://img.shields.io/badge/changelog-SHA%20verified-5eead4?style=flat-square" alt="changelog" /></a>
+  <img src="https://img.shields.io/badge/runtime-Python%203.11%2B-8b949e?style=flat-square" alt="Python runtime" />
+</p>
+
+---
+
+## What this is
+
+**r2s** is a small, versioned contract — not an agent and not a framework.
+
+You normalize research into **cards**, **rank** them with an explicit score, emit a fixed **handoff** for whoever builds, then record an **outcome** so the next cycle is smarter.
+
+**v0.1.0** is the schema contract; **v0.2.0** adds a thin Python reference runtime. Both obey `docs/SPEC.md`. Public history with full commit SHAs: [`CHANGELOG.md`](CHANGELOG.md).
+
+## Quick start
+
+1. Read the normative rules: [`docs/SPEC.md`](docs/SPEC.md)
+2. Copy [`examples/board.example.json`](examples/board.example.json)
+3. Validate with any JSON Schema Draft 2020-12 validator against [`schemas/`](schemas/)
+
+## Loop
+
+| Stage | Artifact | Role |
+|-------|----------|------|
+| Sense | `card` | Normalize a research signal |
+| Rank | `board` + scoring rules | Order work; kill weak cards |
+| Handoff | `handoff` | 7-part ship packet for implementers |
+| Ship / learn | `outcome` | Close the loop |
+
+**Score**
+
+```text
+S = (novelty × evidence_strength × usability × dependency_fit)
+  / (hours + compute_cost + blast_radius)
+```
+
+Kill when usability or dependency fit ≈ 0, or `target_repo` is missing at design+.
+
+## Layout
+
+```text
+schemas/          card · board · handoff · outcome · scoring
+docs/SPEC.md      normative rules
+docs/brand/       icon · social · README loop GIF
+examples/         worked board + handoff (this repo as the sample)
+```
+
+## Brand
+
+| | |
+|-|-|
+| Mark | stacked cards → chevron (cyan on charcoal) |
+| Emoji | ↻ |
+| Accent | `#5eead4` on `#0f1115` |
+
+## Security
+
+Card fields are **untrusted data**. Validators must not execute claim or evidence strings. This repo holds no credentials and no network clients.
+
+## Changelog & identity
+
+Ship history is **SHA-verified** in [`CHANGELOG.md`](CHANGELOG.md). Security posture: [`SECURITY.md`](SECURITY.md).
+
+Current `main` tip at publish of this note is recorded in the changelog Unreleased/latest section after each merge.
+
+## License
+
+[MIT](LICENSE)

r2s-0.2.1/SECURITY.md

@@ -0,0 +1,19 @@
+# Security
+
+## Trust model
+
+Card fields (claim, evidence refs, notes) are **untrusted data**. Validators and the reference runtime must not execute or fetch them.
+
+## Reporting
+
+Open a private security advisory on this GitHub repository, or contact the owner via GitHub.
+
+## Supply chain
+
+- Pin runtime dependencies in `pyproject.toml`
+- Prefer Dependabot security updates once enabled (see open issues)
+- Secret scanning and push protection are enabled on the repo
+
+## Verified commits
+
+Public ship points are listed with full SHAs in [`CHANGELOG.md`](CHANGELOG.md). Confirm with `git cat-file -t <sha>`.

r2s-0.2.1/pyproject.toml

@@ -0,0 +1,50 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "r2s"
+version = "0.2.1"
+description = "Reference runtime for the r2s research-to-ship JSON Schema contract"
+readme = "README.md"
+requires-python = ">=3.11"
+license = "MIT"
+authors = [{ name = "ao3575911" }]
+keywords = ["json-schema", "research", "handoff", "ranking", "specification"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Intended Audience :: Developers",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Topic :: Software Development :: Libraries",
+  "Typing :: Typed",
+]
+dependencies = [
+  "jsonschema>=4.22,<5",
+  "referencing>=0.35,<1",
+]
+
+[project.optional-dependencies]
+dev = ["pytest>=8,<9", "build>=1.2,<2", "twine>=5,<7"]
+
+[project.urls]
+Homepage = "https://github.com/ao3575911/r2s"
+Repository = "https://github.com/ao3575911/r2s"
+Changelog = "https://github.com/ao3575911/r2s/blob/main/CHANGELOG.md"
+Issues = "https://github.com/ao3575911/r2s/issues"
+Documentation = "https://github.com/ao3575911/r2s/blob/main/docs/SPEC.md"
+
+[project.scripts]
+r2s = "r2s.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+r2s = ["schemas/*.schema.json"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]

r2s-0.2.1/schemas/board.schema.json

@@ -0,0 +1,29 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://ao3575911.github.io/r2s/schemas/board.schema.json",
+  "title": "R2S Board",
+  "description": "Hypothesis board: a set of cards plus ranking policy.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "version",
+    "cards"
+  ],
+  "properties": {
+    "version": {
+      "type": "string",
+      "const": "0.1.0"
+    },
+    "max_active_builds": {
+      "type": "integer",
+      "minimum": 1,
+      "default": 2
+    },
+    "cards": {
+      "type": "array",
+      "items": {
+        "$ref": "card.schema.json"
+      }
+    }
+  }
+}

r2s-0.2.1/schemas/card.schema.json

@@ -0,0 +1,174 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://ao3575911.github.io/r2s/schemas/card.schema.json",
+  "title": "R2S Card",
+  "description": "Normalized research signal for the research-to-ship loop.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "id",
+    "claim",
+    "evidence",
+    "novelty",
+    "evidence_strength",
+    "usability",
+    "dependency_fit",
+    "hours",
+    "compute_cost",
+    "blast_radius",
+    "status"
+  ],
+  "properties": {
+    "id": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Stable card id (slug)."
+    },
+    "claim": {
+      "type": "string",
+      "minLength": 1,
+      "description": "One sentence the eventual code must make true."
+    },
+    "evidence": {
+      "type": "array",
+      "minItems": 0,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "kind",
+          "ref"
+        ],
+        "properties": {
+          "kind": {
+            "type": "string",
+            "enum": [
+              "paper",
+              "repo",
+              "doc",
+              "spike",
+              "outcome",
+              "other"
+            ]
+          },
+          "ref": {
+            "type": "string",
+            "minLength": 1
+          },
+          "note": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "earn_path": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "who_pays": {
+          "type": "string"
+        },
+        "wedge": {
+          "type": "string"
+        },
+        "cheapest_test": {
+          "type": "string"
+        }
+      }
+    },
+    "target_repo": {
+      "type": "string",
+      "pattern": "^[^/\\s]+/[^/\\s]+$",
+      "description": "owner/name when status is design or later."
+    },
+    "novelty": {
+      "type": "number",
+      "minimum": 0,
+      "maximum": 1
+    },
+    "evidence_strength": {
+      "type": "number",
+      "minimum": 0,
+      "maximum": 1
+    },
+    "usability": {
+      "type": "number",
+      "minimum": 0,
+      "maximum": 1
+    },
+    "dependency_fit": {
+      "type": "number",
+      "minimum": 0,
+      "maximum": 1
+    },
+    "hours": {
+      "type": "number",
+      "exclusiveMinimum": 0
+    },
+    "compute_cost": {
+      "type": "number",
+      "minimum": 0
+    },
+    "blast_radius": {
+      "type": "number",
+      "minimum": 0
+    },
+    "status": {
+      "type": "string",
+      "enum": [
+        "sense",
+        "design",
+        "build",
+        "ship",
+        "learn",
+        "killed"
+      ]
+    },
+    "kill_reason": {
+      "type": "string"
+    },
+    "notes": {
+      "type": "string"
+    }
+  },
+  "allOf": [
+    {
+      "if": {
+        "properties": {
+          "status": {
+            "enum": [
+              "design",
+              "build",
+              "ship"
+            ]
+          }
+        },
+        "required": [
+          "status"
+        ]
+      },
+      "then": {
+        "required": [
+          "target_repo"
+        ]
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "status": {
+            "const": "killed"
+          }
+        },
+        "required": [
+          "status"
+        ]
+      },
+      "then": {
+        "required": [
+          "kill_reason"
+        ]
+      }
+    }
+  ]
+}

r2s-0.2.1/schemas/handoff.schema.json

@@ -0,0 +1,60 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://ao3575911.github.io/r2s/schemas/handoff.schema.json",
+  "title": "R2S Handoff Packet",
+  "description": "Fixed 7-part ship handoff for Builder (or any implementer).",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "repo",
+    "claim",
+    "api_sketch",
+    "non_goals",
+    "acceptance",
+    "security_notes",
+    "first_pr_scope"
+  ],
+  "properties": {
+    "card_id": {
+      "type": "string"
+    },
+    "repo": {
+      "type": "string",
+      "pattern": "^[^/\\s]+/[^/\\s]+$"
+    },
+    "claim": {
+      "type": "string",
+      "minLength": 1
+    },
+    "api_sketch": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Public surface the outside world sees (for a spec repo: schemas and docs paths)."
+    },
+    "non_goals": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "minItems": 1
+    },
+    "acceptance": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "minItems": 1
+    },
+    "security_notes": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "minItems": 1
+    },
+    "first_pr_scope": {
+      "type": "string",
+      "minLength": 1
+    }
+  }
+}