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
2 changes: 1 addition & 1 deletion CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -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/<case-id>/`. 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.

Expand Down
6 changes: 3 additions & 3 deletions templates/EXTERNAL_ARCHITECTURE_ISSUE.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand All @@ -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

Expand All @@ -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.
4 changes: 2 additions & 2 deletions templates/FORK_CAPABILITY_ROADMAP_ISSUE.md
Original file line number Diff line number Diff line change
Expand Up @@ -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?]

Expand Down Expand Up @@ -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/<case-id>/`. 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/<case-id>/`. 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.
7 changes: 6 additions & 1 deletion tests/test_fork_roadmap_issue_template.py
Original file line number Diff line number Diff line change
@@ -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
Expand All @@ -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",
Expand Down Expand Up @@ -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__":
Expand Down
Loading