diff --git a/CHANGELOG.md b/CHANGELOG.md index e855d08..c14f548 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -5,7 +5,7 @@ **Release status:** a protocol version merged to `main` is **not** automatically a published GitHub Release. Check [published Releases](https://github.com/opensiro/upstream/releases). At the 2026-11-16 review, v0.13.0 was the latest published release, and the [v0.16.0 consolidated candidate](docs/RELEASE_CANDIDATE_v0.16.0.md) awaits final owner approval. Individual v0.14–v0.16 history entries below remain valid intermediate main snapshots, not claims of three separate GitHub Releases. ## Unreleased -**Generic fork-local roadmap Issue template (unreleased):** Add a concise, project-neutral, evidence-first Issue skeleton for OpenSiro's own verified working forks. It ties the user's outcome to existing original code/Issues/PRs, optional VSM-derived priorities, acceptance, native alternatives, paired cost measurement and a conditional handoff, while keeping case artifacts on `opensiro/meta`. This is distinct from the existing external architecture Issue template and authorizes no public Issue, implementation or new grade. No named-fork research edited, version bump or Release. +**Generic fork-local roadmap Issue template (unreleased):** Add a concise, project-neutral, evidence-first Issue skeleton for Opensiro's own verified working forks. It ties the user's outcome to existing original code/Issues/PRs, optional VSM-derived priorities, acceptance, native alternatives, paired cost measurement and a conditional handoff, while keeping case artifacts on `opensiro/meta`. This is distinct from the existing external architecture Issue template and authorizes no public Issue, implementation or new grade. No named-fork research edited, version bump or Release. **Fork Issue → issue-local evidence → separately consented original Issue (unreleased):** Source-pinned case roadmaps, construction contracts, drafts and results belong in the verified matching fork's `opensiro/meta:.opensiro/issues//`. Public fork GitHub Issue creation and external original Issue publication each require their own exact owner approval; dedupe original issues and link rather than manufacture duplicates. Do not claim GitHub cross-owner native transfer, mirror comments/reactions, or auto-close internal Issues. Named Paperclip and Browser Harness case examples migrated to their forks; central Upstream retains generic methods and source-neutral validator fixtures. No product code, Index grade, version bump or Release. diff --git a/templates/EXTERNAL_ARCHITECTURE_ISSUE.md b/templates/EXTERNAL_ARCHITECTURE_ISSUE.md index 3fa79c1..9bc78a0 100644 --- a/templates/EXTERNAL_ARCHITECTURE_ISSUE.md +++ b/templates/EXTERNAL_ARCHITECTURE_ISSUE.md @@ -5,7 +5,7 @@ ## Context -We are developing **OpenSiro**, an open-source effort studying whether reusable organizational specifications and evidence-backed engineering methods make AI agent harnesses easier and less expensive to build, integrate, and maintain. +We are developing **Opensiro**, an open-source effort studying whether reusable organizational specifications and evidence-backed engineering methods make AI agent harnesses easier and less expensive to build, integrate, and maintain. Our current reference hypothesis is the **Viable System Model (VSM)**. We are **not** asking this project to adopt VSM, alleging it lacks six subsystems, or claiming proven cost reduction. @@ -17,7 +17,7 @@ Our current reference hypothesis is the **Viable System Model (VSM)**. We are ** - **Specific remaining integration question:** [actor → trigger → blocked output/decision] - **Closest existing project-native solution:** [the simple alternative and any advantages] -An OpenSiro assessment is a dated evidence snapshot, not today's guaranteed capability grade, product-quality or safety rating. Unmerged PRs are proposals, not shipped features. +An Opensiro assessment is a dated evidence snapshot, not today's guaranteed capability grade, product-quality or safety rating. Unmerged PRs are proposals, not shipped features. ## Optional incremental approach @@ -43,6 +43,6 @@ Would this help the project? Which existing work, architecture constraints, or m ## Attribution and AI disclosure -[OpenSiro Upstream](https://github.com/opensiro/upstream) · [Profile](https://github.com/opensiro/vsm-harness-profile) · [Skills](https://github.com/opensiro/vsm-harness-skills) · [Index](https://github.com/opensiro/vsm-harness-index) +[Opensiro Upstream](https://github.com/opensiro/upstream) · [Profile](https://github.com/opensiro/vsm-harness-profile) · [Skills](https://github.com/opensiro/vsm-harness-skills) · [Index](https://github.com/opensiro/vsm-harness-index) **AI involvement:** This research proposal and its evidence mapping were prepared with AI assistance. No independent human technical review, proven correctness, maintainer endorsement, verified cost advantage or implementation result is claimed. diff --git a/templates/FORK_CAPABILITY_ROADMAP_ISSUE.md b/templates/FORK_CAPABILITY_ROADMAP_ISSUE.md index 659d0ba..6cbf1c4 100644 --- a/templates/FORK_CAPABILITY_ROADMAP_ISSUE.md +++ b/templates/FORK_CAPABILITY_ROADMAP_ISSUE.md @@ -7,7 +7,7 @@ This is NOT the external maintainer issue template. --> ## Why this Issue exists -OpenSiro is testing whether reusable organizational specifications and a VSM-informed methodology can **standardize and reduce the cost of developing AI-agent harnesses**. This is a research hypothesis, **not** a proven cost reduction or a request to implement every VSM function. +Opensiro is testing whether reusable organizational specifications and a VSM-informed methodology can **standardize and reduce the cost of developing AI-agent harnesses**. This is a research hypothesis, **not** a proven cost reduction or a request to implement every VSM function. **User outcome we want to improve:** [Who needs to do what, and what currently prevents or complicates it?] @@ -63,6 +63,6 @@ Select **one**, not all three: **State:** `PLAN_ONLY` — [`NEEDS_EVIDENCE` / `DECISION_READY` / `NO_USEFUL_CHANGE`] (report labels only, not metadata enums). **Open question:** [What decision or evidence is needed next?] -Store detailed research, roadmap, construction contracts and external-Issue draft under the verified fork's `.opensiro/issues//`. This Issue is for **OpenSiro's fork-local discussion**, not an external request. Before contacting the original repository, dedupe existing original Issues; a new external Issue needs **separate exact approval** and is newly created, **not a cross-owner transfer**. No automatic implementation, product PR, Index regrade or internal Issue closure. +Store detailed research, roadmap, construction contracts and external-Issue draft under the verified fork's `.opensiro/issues//`. This Issue is for **Opensiro's fork-local discussion**, not an external request. Before contacting the original repository, dedupe existing original Issues; a new external Issue needs **separate exact approval** and is newly created, **not a cross-owner transfer**. No automatic implementation, product PR, Index regrade or internal Issue closure. **AI disclosure:** Draft and evidence synthesis prepared with AI assistance; no human review, shipped result or measured cost saving is claimed unless independently evidenced. diff --git a/tests/test_fork_roadmap_issue_template.py b/tests/test_fork_roadmap_issue_template.py index 3ebb924..bb861ec 100644 --- a/tests/test_fork_roadmap_issue_template.py +++ b/tests/test_fork_roadmap_issue_template.py @@ -1,4 +1,4 @@ -"""Guardrails for the reusable OpenSiro fork-local roadmap Issue template.""" +"""Guardrails for the reusable Opensiro fork-local roadmap Issue template.""" from pathlib import Path import unittest @@ -11,6 +11,8 @@ class ForkCapabilityRoadmapIssueTemplateTests(unittest.TestCase): def test_template_is_generic_and_source_driven(self): text = TEMPLATE.read_text(encoding="utf-8") self.assertTrue(text.startswith("# [PROJECT]")) + self.assertIn("Opensiro", text) + self.assertNotIn("OpenSiro", text) for part in ( "## Why this Issue exists", "## Source and evidence", @@ -57,6 +59,9 @@ def test_protocol_routes_to_correct_templates(self): self.assertIn("FORK_CAPABILITY_ROADMAP_ISSUE.md", s) self.assertIn("EXTERNAL_ARCHITECTURE_ISSUE.md", s) self.assertTrue((ROOT / "templates/EXTERNAL_ARCHITECTURE_ISSUE.md").exists()) + external = (ROOT / "templates/EXTERNAL_ARCHITECTURE_ISSUE.md").read_text(encoding="utf-8") + self.assertIn("Opensiro", external) + self.assertNotIn("OpenSiro", external) if __name__ == "__main__":