workstate-protocol 0.1.6__tar.gz → 0.1.7__tar.gz

{workstate_protocol-0.1.6 → workstate_protocol-0.1.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: workstate-protocol
-Version: 0.1.6
+Version: 0.1.7
 Summary: Typed cross-repo contracts for the Workstate system: handoff state, MCP I/O, hook events, skill manifests, bootstrap install manifest.
 License: MIT
 Project-URL: Homepage, https://github.com/darce/workstate
@@ -17,7 +17,7 @@ Requires-Dist: pytest>=8; extra == "dev"
 
 Single source of truth for cross-repo contracts in the Workstate system. Pydantic v2 is canonical; JSON Schema artifacts under `schemas/` are generated from the models so non-Python consumers (hook scripts, future TS/JS tooling) can validate without importing Python.
 
-## Schemas (rolled out incrementally per founding plan 0001)
+## Schemas (rolled out incrementally per founding implementation note)
 
 | Status | Module | Schema |
 | --- | --- | --- |

{workstate_protocol-0.1.6 → workstate_protocol-0.1.7}/README.md

@@ -2,7 +2,7 @@
 
 Single source of truth for cross-repo contracts in the Workstate system. Pydantic v2 is canonical; JSON Schema artifacts under `schemas/` are generated from the models so non-Python consumers (hook scripts, future TS/JS tooling) can validate without importing Python.
 
-## Schemas (rolled out incrementally per founding plan 0001)
+## Schemas (rolled out incrementally per founding implementation note)
 
 | Status | Module | Schema |
 | --- | --- | --- |

{workstate_protocol-0.1.6 → workstate_protocol-0.1.7}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "workstate-protocol"
-version = "0.1.6"
+version = "0.1.7"
 description = "Typed cross-repo contracts for the Workstate system: handoff state, MCP I/O, hook events, skill manifests, bootstrap install manifest."
 readme = "README.md"
 requires-python = ">=3.11"

{workstate_protocol-0.1.6 → workstate_protocol-0.1.7}/src/workstate_protocol/__init__.py

@@ -37,10 +37,7 @@ from .paths import (
     DOCS_MIRROR_DIR,
     HARNESS_CONTRACT_RELPATH,
     INSTRUCTIONS_RELPATH,
-    LEGACY_DOCS_MIRROR_DIR,
-    LEGACY_RUNTIME_ROOT_DIRNAME,
     RULES_DIR,
-    RUNTIME_PATH_RENAMES,
     RUNTIME_ROOT_DIRNAME,
     docs_mirror_path,
     runtime_root_path,
@@ -59,14 +56,11 @@ __all__ = [
     "HandoffState",
     "HandoffStatus",
     "INSTRUCTIONS_RELPATH",
-    "LEGACY_DOCS_MIRROR_DIR",
-    "LEGACY_RUNTIME_ROOT_DIRNAME",
     "OverlayConfigEntry",
     "OverlaySurface",
     "PostToolUseEvent",
     "PreToolUseEvent",
     "RULES_DIR",
-    "RUNTIME_PATH_RENAMES",
     "RUNTIME_ROOT_DIRNAME",
     "SessionStartEvent",
     "SkillManifest",

{workstate_protocol-0.1.6 → workstate_protocol-0.1.7}/src/workstate_protocol/bootstrap.py

@@ -1,4 +1,4 @@
-"""Bootstrap install manifest schema (Schema #5 from founding plan 0001).
+"""Bootstrap install manifest schema (Schema #5 from founding implementation note).
 
 The wire shape ``workstate-bootstrap`` writes to
 ``<target>/.workstate-overlay.json``. Captures the contract between
@@ -27,14 +27,16 @@ class OverlaySurface(BaseModel):
 
     model_config = ConfigDict(extra="allow")
 
-    path: str = Field(description="Repo-relative surface path (e.g. '.claude/skills/handoff-lifecycle').")
+    path: str = Field(
+        description="Repo-relative surface path (e.g. '.claude/skills/handoff-lifecycle')."
+    )
     source: Literal["shared", "local", "overlapping", "generated", "lifecycle"] = Field(
         description=(
             "Origin tier: 'shared' (symlinked from workstate-system), "
             "'local' (target-owned), 'overlapping' (target overrides shared), "
             "'generated' (per-agent surface produced by generate_agent_workflows.py "
-            "during install — Plan 0002 step 1), "
-            "'lifecycle' (Plan 0009 hoisted Make fragment + runner package "
+            "during install — implementation note step 1), "
+            "'lifecycle' (implementation note hoisted Make fragment + runner package "
             "— copied, not symlinked, so the consumer can run `make context` "
             "without the workstate-system packaging tree)."
         ),
@@ -112,7 +114,9 @@ class PluginOverrideManifest(BaseModel):
 
     schema_version: Literal[1] = 1
     plugin: PluginComponentName
-    components: PluginOverrideComponents = Field(default_factory=PluginOverrideComponents)
+    components: PluginOverrideComponents = Field(
+        default_factory=PluginOverrideComponents
+    )
 
 
 class ReplaceCommandOp(BaseModel):
@@ -240,10 +244,24 @@ class BootstrapManifest(BaseModel):
     model_config = ConfigDict(extra="allow")
 
     schema_version: int = Field(ge=1, description="Manifest schema version.")
-    remote_url: str = Field(min_length=1)
-    remote_ref: str = Field(min_length=1)
-    remote_sha: Sha40 = Field(
-        description="Resolved 40-char git SHA at install time.",
+    source_kind: Literal["git_overlay", "package"] = Field(
+        default="git_overlay",
+        description=(
+            "Overlay delivery source: 'git_overlay' (a clone checked out at "
+            "remote_ref) or 'package' (an installed workstate-system "
+            "distribution). Defaults to 'git_overlay' so manifests written "
+            "before WS-PKG-DELIVERY-01 validate unchanged."
+        ),
+    )
+    remote_url: str | None = Field(default=None, min_length=1)
+    remote_ref: str | None = Field(default=None, min_length=1)
+    remote_sha: Sha40 | None = Field(
+        default=None,
+        description="Resolved 40-char git SHA at install time (git_overlay source).",
+    )
+    package_version: str | None = Field(
+        default=None,
+        description="Installed workstate-system distribution version (package source).",
     )
     surfaces: list[OverlaySurface] = Field(default_factory=list)
     configs: list[OverlayConfigEntry] = Field(default_factory=list)
@@ -261,7 +279,27 @@ class BootstrapManifest(BaseModel):
         default=None,
         description=(
             "Optional explicit plugin override root recorded by bootstrap so "
-            "later doctor/update/repair runs can reuse a non-default APD-03 "
+            "later doctor/update/repair runs can reuse a non-default WORKSTATE-REF-03 "
             "override location."
         ),
     )
+
+    @model_validator(mode="after")
+    def _check_source_provenance(self) -> "BootstrapManifest":
+        """Each delivery source requires its own provenance fields.
+
+        ``git_overlay`` (the default, so pre-WS-PKG-DELIVERY-01 manifests keep
+        validating) requires the git ``remote_*`` triple; ``package`` requires
+        the installed distribution ``package_version``.
+        """
+        if self.source_kind == "git_overlay":
+            missing = [
+                name
+                for name in ("remote_url", "remote_ref", "remote_sha")
+                if not getattr(self, name)
+            ]
+            if missing:
+                raise ValueError("git_overlay manifest requires " + ", ".join(missing))
+        elif self.source_kind == "package" and not self.package_version:
+            raise ValueError("package manifest requires package_version")
+        return self

{workstate_protocol-0.1.6 → workstate_protocol-0.1.7}/src/workstate_protocol/branch_naming.py

@@ -4,13 +4,13 @@ This module is the SOLE owner of ``TASK_REF_RE``,
 ``derive_task_ref_candidates`` and ``format_suggested_branch_name``.
 Every gate (post-checkout warn, PreToolUse block, pre-commit hard gate,
 pre-push mirror) imports from here. ``workstate_handoff_mcp`` re-exports
-the same objects without redefinition. See plan 0006 for context.
+the same objects without redefinition. See implementation note for context.
 
 Case convention
 ---------------
 
-Branches are lowercase (``feature/ahmcp-37-foo``). Task refs in the
-Workstate handoff task table are uppercase (``AHMCP-37``).
+Branches are lowercase (``feature/WORKSTATE-37-foo``). Task refs in the
+Workstate handoff task table are uppercase (``WORKSTATE-REF-37``).
 ``derive_task_ref_candidates`` returns lowercase candidates; callers
 ``.upper()`` each candidate before intersecting against the live task
 table. ``format_suggested_branch_name`` accepts task refs in either
@@ -26,7 +26,7 @@ from dataclasses import dataclass, field
 
 __all__ = [
     "BRANCH_GRAMMAR_REGISTRY",
-    "BranchClassification",
+    "BranWORKSTATElassification",
     "BranchGrammarEntry",
     "TASK_REF_RE",
     "__protocol_version__",
@@ -51,7 +51,7 @@ TASK_REF_RE: re.Pattern[str] = re.compile(
     # >=2 hyphen-separated lowercase / digit segments; each segment is
     # non-empty. The alternation enforces a `<prefix>-<rest>` shape so
     # single-word branches like ``feature/foo`` are rejected and
-    # conventional task refs (``feature/ahmcp-37``,
+    # conventional task refs (``feature/WORKSTATE-37``,
     # ``feature/maint-dirty-br-01``) still match.
     r"(?P<task_ref>[a-z0-9]+(?:-[a-z0-9]+)+)"
     r"$"
@@ -69,8 +69,8 @@ def derive_task_ref_candidates(branch_name: str) -> list[str]:
 
     Examples
     --------
-    >>> derive_task_ref_candidates("feature/ahmcp-37-branch-naming-enforcement")
-    ['ahmcp-37-branch-naming-enforcement', 'ahmcp-37']
+    >>> derive_task_ref_candidates("feature/WORKSTATE-37-branch-naming-enforcement")
+    ['WORKSTATE-37-branch-naming-enforcement', 'WORKSTATE-37']
     >>> derive_task_ref_candidates("feature/maint-dirty-br-01")
     ['maint-dirty-br-01', 'maint-dirty-br']
     >>> derive_task_ref_candidates("fix/foo")
@@ -107,7 +107,7 @@ def select_task_ref_candidate(
       when both the base and the follow-up are registered. When the
       registry is non-empty but no candidate intersects, returns
       ``None`` — the strict invariant is that we never name a candidate
-      that is absent from a populated registry (AHMCP65-BR-02).
+      that is absent from a populated registry (WORKSTATE65-BR-02).
     - If ``known_task_refs`` is empty or ``None`` (no registry context
       available at all), falls back to the shortest digit-bearing
       prefix. This is the no-context degradation path that keeps
@@ -152,7 +152,7 @@ def _has_digit(value: str) -> bool:
 
 
 # ---------------------------------------------------------------------------
-# Branch grammar registry (Plan 0010 Slice 6)
+# Branch grammar registry (implementation note implementation note)
 # ---------------------------------------------------------------------------
 #
 # Canonical pattern (``feature/<task-ref>``) plus each documented
@@ -170,7 +170,7 @@ class BranchGrammarEntry:
 
 
 @dataclass(frozen=True)
-class BranchClassification:
+class BranWORKSTATElassification:
     kind: str
     branch: str
 
@@ -193,8 +193,8 @@ BRANCH_GRAMMAR_REGISTRY: tuple[BranchGrammarEntry, ...] = (
 )
 
 
-def classify_branch(name: str) -> BranchClassification | None:
-    """Return the :class:`BranchClassification` for ``name`` or ``None``.
+def classify_branch(name: str) -> BranWORKSTATElassification | None:
+    """Return the :class:`BranWORKSTATElassification` for ``name`` or ``None``.
 
     Unknown patterns return ``None`` (fail-closed); each consumer
     decides whether unknown means warn or block.
@@ -202,7 +202,7 @@ def classify_branch(name: str) -> BranchClassification | None:
 
     for entry in BRANCH_GRAMMAR_REGISTRY:
         if entry.regex.match(name):
-            return BranchClassification(kind=entry.kind, branch=name)
+            return BranWORKSTATElassification(kind=entry.kind, branch=name)
     return None
 
 

{workstate_protocol-0.1.6 → workstate_protocol-0.1.7}/src/workstate_protocol/handoff.py

@@ -1,4 +1,4 @@
-"""Handoff state schemas (Schema #1 from founding plan 0001).
+"""Handoff state schemas (Schema #1 from founding implementation note).
 
 These are the cross-repo contract types for handoff state. They model
 the wire shape that ``mcp-workstate-handoff`` exposes to MCP clients and
@@ -23,13 +23,13 @@ from pydantic import BaseModel, ConfigDict, Field, StringConstraints
 # Primitive identifiers and enums
 # ---------------------------------------------------------------------------
 
-# A task_ref is a short identifier like "E17-14" or "MAINT-7" or "AAA-1".
+# A task_ref is a short identifier like "WORKSTATE-REF-17-14" or "WORKSTATE-REF-7" or "AAA-1".
 # We require non-empty string with a permissive character class so domain
 # tools can introduce new prefixes without re-releasing the protocol.
 TaskRef = Annotated[
     str,
     StringConstraints(strip_whitespace=True, min_length=1, max_length=128),
-    Field(description="Short task identifier, e.g. 'E17-14' or 'MAINT-7'."),
+    Field(description="Short task identifier, e.g. 'WORKSTATE-REF-17-14' or 'WORKSTATE-REF-7'."),
 ]
 
 

{workstate_protocol-0.1.6 → workstate_protocol-0.1.7}/src/workstate_protocol/hooks.py

@@ -1,4 +1,4 @@
-"""Hook event payload schemas (Schema #3 from founding plan 0001).
+"""Hook event payload schemas (Schema #3 from founding implementation note).
 
 Models the JSON Claude Code delivers to hook scripts on stdin. Each
 event type is modeled separately rather than as a discriminated union

{workstate_protocol-0.1.6 → workstate_protocol-0.1.7}/src/workstate_protocol/paths.py

@@ -1,13 +1,9 @@
 """Canonical Workstate runtime + doc-mirror path roots — single source of truth.
 
-The runtime install directory and the mirrored docs/contracts path were renamed
-from the legacy ``.agentic/`` / ``docs/agentic/`` to ``.workstate/`` /
-``docs/workstate/`` (Plan 0013 Slice D, completing Plan 0011 §11 items #3/#4).
-
-Every package resolves these through this module so the names live in exactly
-one place: a future path change is a one-line flip here, not a repo-wide sweep.
-The ``LEGACY_*`` names and :data:`RUNTIME_PATH_RENAMES` exist so bootstrap can
-detect and migrate an old checkout forward for one release.
+The runtime install directory is ``.workstate/`` and the mirrored docs/contracts
+path is ``docs/workstate/``. Every package resolves these through this module so
+the names live in exactly one place: a future path change is a one-line flip
+here, not a repo-wide sweep.
 """
 
 from __future__ import annotations
@@ -17,18 +13,10 @@ from pathlib import Path
 # Runtime install root — bootstrap materializes overlay surfaces and the remote
 # clone under ``<target>/.workstate/``.
 RUNTIME_ROOT_DIRNAME = ".workstate"
-LEGACY_RUNTIME_ROOT_DIRNAME = ".agentic"
 
 # Mirrored docs / contracts path — the SHARED_SURFACES consumed at install time
 # (rules, contracts, templates) live under ``docs/workstate/``.
 DOCS_MIRROR_DIR = "docs/workstate"
-LEGACY_DOCS_MIRROR_DIR = "docs/agentic"
-
-# Ordered (legacy -> canonical) pairs for migration / detection sweeps.
-RUNTIME_PATH_RENAMES: tuple[tuple[str, str], ...] = (
-    (LEGACY_RUNTIME_ROOT_DIRNAME, RUNTIME_ROOT_DIRNAME),
-    (LEGACY_DOCS_MIRROR_DIR, DOCS_MIRROR_DIR),
-)
 
 # Common derived locations under the canonical docs mirror.
 CONTRACTS_DIR = f"{DOCS_MIRROR_DIR}/contracts"
@@ -41,10 +29,7 @@ __all__ = [
     "DOCS_MIRROR_DIR",
     "HARNESS_CONTRACT_RELPATH",
     "INSTRUCTIONS_RELPATH",
-    "LEGACY_DOCS_MIRROR_DIR",
-    "LEGACY_RUNTIME_ROOT_DIRNAME",
     "RULES_DIR",
-    "RUNTIME_PATH_RENAMES",
     "RUNTIME_ROOT_DIRNAME",
     "docs_mirror_path",
     "runtime_root_path",

{workstate_protocol-0.1.6 → workstate_protocol-0.1.7}/src/workstate_protocol/skills.py

@@ -1,7 +1,7 @@
-"""Skill manifest schema (Schema #4 from founding plan 0001).
+"""Skill manifest schema (Schema #4 from founding implementation note).
 
 Structured contract for the canonical neutral skill layout
-``skills/<slug>/skill.yaml`` (Plan 0002 step 1). The pre-Plan-0002
+``skills/<slug>/skill.yaml`` (implementation note step 1). The pre-Plan-0002
 ``.claude/skills/<slug>/SKILL.md`` frontmatter is now a *generated*
 artifact in target repos and is no longer a source-of-truth surface.
 Enforces the Tier 1 / Tier 2 / Tier 3 portability boundary by

{workstate_protocol-0.1.6 → workstate_protocol-0.1.7}/src/workstate_protocol.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: workstate-protocol
-Version: 0.1.6
+Version: 0.1.7
 Summary: Typed cross-repo contracts for the Workstate system: handoff state, MCP I/O, hook events, skill manifests, bootstrap install manifest.
 License: MIT
 Project-URL: Homepage, https://github.com/darce/workstate
@@ -17,7 +17,7 @@ Requires-Dist: pytest>=8; extra == "dev"
 
 Single source of truth for cross-repo contracts in the Workstate system. Pydantic v2 is canonical; JSON Schema artifacts under `schemas/` are generated from the models so non-Python consumers (hook scripts, future TS/JS tooling) can validate without importing Python.
 
-## Schemas (rolled out incrementally per founding plan 0001)
+## Schemas (rolled out incrementally per founding implementation note)
 
 | Status | Module | Schema |
 | --- | --- | --- |

{workstate_protocol-0.1.6 → workstate_protocol-0.1.7}/tests/test_bootstrap_manifest.py

@@ -1,6 +1,6 @@
 """Schema tests for BootstrapManifest mcp_servers field.
 
-AHMCP-50 slice 1b adds a ``mcp_servers: list[str]`` field to the manifest
+WORKSTATE-REF-50 implementation note adds a ``mcp_servers: list[str]`` field to the manifest
 so the bootstrap ledger can carry the previously-managed server names.
 ``sync_mcp_configs(prune_removed_managed=True)`` reads this list to
 distinguish managed launchers (subject to prune) from third-party ones

{workstate_protocol-0.1.6 → workstate_protocol-0.1.7}/tests/test_branch_grammar_registry.py

@@ -1,4 +1,4 @@
-"""Plan 0010 Slice 6 — branch-grammar registry."""
+"""implementation note implementation note — branch-grammar registry."""
 
 from __future__ import annotations
 
@@ -16,11 +16,11 @@ def test_registry_includes_documented_exception_kinds() -> None:
 @pytest.mark.parametrize(
     "branch,expected_kind",
     [
-        ("feature/ahmcp-37-branch-naming-enforcement", "feature"),
+        ("feature/WORKSTATE-37-branch-naming-enforcement", "feature"),
         ("release/0.9.1", "release"),
-        ("hotfix/ahmcp-99-fix-bug", "hotfix"),
+        ("hotfix/WORKSTATE-99-fix-bug", "hotfix"),
         ("maint/cleanup-stale-rows", "maint"),
-        ("revert/ahmcp-12-bad-merge", "revert"),
+        ("revert/WORKSTATE-12-bad-merge", "revert"),
     ],
 )
 def test_classify_branch_returns_correct_kind(branch: str, expected_kind: str) -> None:
@@ -34,11 +34,11 @@ def test_classify_branch_returns_correct_kind(branch: str, expected_kind: str) -
 @pytest.mark.parametrize(
     "branch",
     [
-        "feature/ahmcp-37-branch-naming-enforcement",
+        "feature/WORKSTATE-37-branch-naming-enforcement",
         "release/0.9.1",
-        "hotfix/ahmcp-99-fix-bug",
+        "hotfix/WORKSTATE-99-fix-bug",
         "maint/cleanup-stale-rows",
-        "revert/ahmcp-12-bad-merge",
+        "revert/WORKSTATE-12-bad-merge",
     ],
 )
 def test_is_allowed_branch_passes_for_documented_patterns(branch: str) -> None:

{workstate_protocol-0.1.6 → workstate_protocol-0.1.7}/tests/test_branch_naming.py

@@ -1,6 +1,6 @@
 """Tests for the canonical branch-naming rule.
 
-Plan 0006 Slice 1: ``workstate_protocol.branch_naming`` exposes
+implementation note implementation note: ``workstate_protocol.branch_naming`` exposes
 ``TASK_REF_RE``, ``derive_task_ref_candidates``,
 ``format_suggested_branch_name``, and ``__protocol_version__`` as the
 single source of truth for branch-naming validation across every gate.
@@ -23,8 +23,8 @@ from workstate_protocol.branch_naming import (
 
 
 POSITIVE_CORPUS = (
-    "feature/ahmcp-35",
-    "feature/ahmcp-37-branch-naming-enforcement",
+    "feature/WORKSTATE-35",
+    "feature/WORKSTATE-37-branch-naming-enforcement",
     "feature/maint-dirty-br-01",
     "feature/maint-archive-stale-20260502",
     "feature/plan-0006",
@@ -43,11 +43,11 @@ NEGATIVE_CORPUS = (
     "feature/no-digits-here",
     "hotfix/x",
     "release/v1",
-    "feature/AHMCP-37",  # uppercase
+    "feature/WORKSTATE-REF-37",  # uppercase
     "feature/-x",  # leading hyphen
     "feature/123-foo",  # leading digit segment
     "feature/",  # empty task ref
-    "FEATURE/ahmcp-37",  # uppercase prefix
+    "FEATURE/WORKSTATE-37",  # uppercase prefix
     "",
 )
 
@@ -74,15 +74,15 @@ def test_protocol_version_marker_is_string() -> None:
 @pytest.mark.parametrize(
     "branch,expected",
     [
-        # Walk every digit-bearing prefix from longest to shortest. ``ahmcp`` is
+        # Walk every digit-bearing prefix from longest to shortest. ``WORKSTATE`` is
         # dropped because it has no digit.
-        ("feature/ahmcp-37-branch-naming-enforcement", [
-            "ahmcp-37-branch-naming-enforcement",
-            "ahmcp-37-branch-naming",
-            "ahmcp-37-branch",
-            "ahmcp-37",
+        ("feature/WORKSTATE-37-branch-naming-enforcement", [
+            "WORKSTATE-37-branch-naming-enforcement",
+            "WORKSTATE-37-branch-naming",
+            "WORKSTATE-37-branch",
+            "WORKSTATE-37",
         ]),
-        ("feature/ahmcp-37", ["ahmcp-37"]),
+        ("feature/WORKSTATE-37", ["WORKSTATE-37"]),
         # Only the full ref carries a digit; shorter prefixes are digit-less.
         ("feature/maint-dirty-br-01", ["maint-dirty-br-01"]),
         ("feature/plan-0006", ["plan-0006"]),
@@ -105,7 +105,7 @@ def test_derive_returns_lowercase_for_conforming() -> None:
     The derivation MUST stay lowercase so that intersection logic owns the
     case conversion rather than guessing it here."""
     candidates = derive_task_ref_candidates(
-        "feature/ahmcp-37-branch-naming-enforcement"
+        "feature/WORKSTATE-37-branch-naming-enforcement"
     )
     assert all(c == c.lower() for c in candidates)
 
@@ -113,11 +113,11 @@ def test_derive_returns_lowercase_for_conforming() -> None:
 @pytest.mark.parametrize(
     "task_ref,slug,expected",
     [
-        ("AHMCP-37", None, "feature/ahmcp-37"),
-        ("ahmcp-37", None, "feature/ahmcp-37"),
-        ("AHMCP-37", "branch-naming-enforcement",
-         "feature/ahmcp-37-branch-naming-enforcement"),
-        ("MAINT-DIRTY-BR-01", None, "feature/maint-dirty-br-01"),
+        ("WORKSTATE-REF-37", None, "feature/WORKSTATE-37"),
+        ("WORKSTATE-37", None, "feature/WORKSTATE-37"),
+        ("WORKSTATE-REF-37", "branch-naming-enforcement",
+         "feature/WORKSTATE-37-branch-naming-enforcement"),
+        ("WORKSTATE-REF-DIRTY-BR-01", None, "feature/maint-dirty-br-01"),
         ("PLAN-0006", "rollout", "feature/plan-0006-rollout"),
     ],
 )
@@ -145,61 +145,61 @@ def test_select_task_ref_candidate_no_registry_returns_shortest_prefix() -> None
     """
     assert (
         select_task_ref_candidate(
-            "feature/ahmcp-63-fu-tighten-compaction-defaults", known_task_refs=None
+            "feature/WORKSTATE-63-fu-tighten-compaction-defaults", known_task_refs=None
         )
-        == "AHMCP-63"
+        == "WORKSTATE-REF-63"
     )
     assert (
         select_task_ref_candidate(
-            "feature/ahmcp-63-fu-tighten-compaction-defaults", known_task_refs=()
+            "feature/WORKSTATE-63-fu-tighten-compaction-defaults", known_task_refs=()
         )
-        == "AHMCP-63"
+        == "WORKSTATE-REF-63"
     )
     assert (
         select_task_ref_candidate(
-            "feature/ahmcp-37-branch-naming-enforcement", known_task_refs=set()
+            "feature/WORKSTATE-37-branch-naming-enforcement", known_task_refs=set()
         )
-        == "AHMCP-37"
+        == "WORKSTATE-REF-37"
     )
     assert (
         select_task_ref_candidate("feature/maint-dirty-br-01", known_task_refs=None)
-        == "MAINT-DIRTY-BR-01"
+        == "WORKSTATE-REF-DIRTY-BR-01"
     )
 
 
 def test_select_task_ref_candidate_longest_registered_wins() -> None:
     """With both the base and a follow-up registered, the longer registered
-    candidate wins. This is the AHMCP-63 vs AHMCP-63-FU-... case that
+    candidate wins. This is the WORKSTATE-REF-63 vs WORKSTATE-REF-63-FU-... case that
     motivated the selector.
     """
-    branch = "feature/ahmcp-63-fu-tighten-compaction-defaults"
-    known = {"AHMCP-63", "AHMCP-63-FU-TIGHTEN-COMPACTION-DEFAULTS"}
+    branch = "feature/WORKSTATE-63-fu-tighten-compaction-defaults"
+    known = {"WORKSTATE-REF-63", "WORKSTATE-REF-63-FU-TIGHTEN-COMTASKCTION-DEFAULTS"}
     assert (
         select_task_ref_candidate(branch, known_task_refs=known)
-        == "AHMCP-63-FU-TIGHTEN-COMPACTION-DEFAULTS"
+        == "WORKSTATE-REF-63-FU-TIGHTEN-COMTASKCTION-DEFAULTS"
     )
 
 
 def test_select_task_ref_candidate_only_base_registered_picks_base() -> None:
     """When only the base ref is registered, no longer candidate intersects
     and the base wins (it is itself a registered candidate)."""
-    branch = "feature/ahmcp-63-fu-tighten-compaction-defaults"
+    branch = "feature/WORKSTATE-63-fu-tighten-compaction-defaults"
     assert (
-        select_task_ref_candidate(branch, known_task_refs={"AHMCP-63"})
-        == "AHMCP-63"
+        select_task_ref_candidate(branch, known_task_refs={"WORKSTATE-REF-63"})
+        == "WORKSTATE-REF-63"
     )
 
 
 def test_select_task_ref_candidate_no_intersection_returns_none() -> None:
     """If ``known_task_refs`` is non-empty but no candidate intersects, the
     selector returns ``None`` rather than naming a candidate absent from a
-    populated registry (AHMCP65-BR-02 invariant: "no resolver path should
+    populated registry (WORKSTATE65-BR-02 invariant: "no resolver path should
     return a candidate absent from a non-empty registry"). The no-context
     shortest-prefix fallback applies only when the registry is genuinely
     empty / unavailable, not when it answered with unrelated rows."""
-    branch = "feature/ahmcp-63-fu-tighten-compaction-defaults"
+    branch = "feature/WORKSTATE-63-fu-tighten-compaction-defaults"
     assert (
-        select_task_ref_candidate(branch, known_task_refs={"DCMCP-02", "AHMCP-99"})
+        select_task_ref_candidate(branch, known_task_refs={"WORKSTATE-REF-02", "WORKSTATE-REF-99"})
         is None
     )
 
@@ -208,14 +208,14 @@ def test_select_task_ref_candidate_case_insensitive_intersection() -> None:
     """``derive_task_ref_candidates`` returns lowercase; registry refs are
     canonically uppercase. The selector normalizes both sides so a
     lowercase or mixed-case registry still resolves correctly."""
-    branch = "feature/ahmcp-63-fu-example"
+    branch = "feature/WORKSTATE-63-fu-example"
     assert (
-        select_task_ref_candidate(branch, known_task_refs={"ahmcp-63-fu-example"})
-        == "AHMCP-63-FU-EXAMPLE"
+        select_task_ref_candidate(branch, known_task_refs={"WORKSTATE-63-fu-example"})
+        == "WORKSTATE-REF-63-FU-EXAMPLE"
     )
     assert (
-        select_task_ref_candidate(branch, known_task_refs={"Ahmcp-63-Fu-Example"})
-        == "AHMCP-63-FU-EXAMPLE"
+        select_task_ref_candidate(branch, known_task_refs={"WORKSTATE-63-Fu-Example"})
+        == "WORKSTATE-REF-63-FU-EXAMPLE"
     )
 
 
@@ -227,22 +227,22 @@ def test_select_task_ref_candidate_non_conforming_branch_returns_none() -> None:
     assert select_task_ref_candidate("main") is None
     assert select_task_ref_candidate("") is None
     assert (
-        select_task_ref_candidate("fix/foo", known_task_refs={"AHMCP-1"}) is None
+        select_task_ref_candidate("fix/foo", known_task_refs={"WORKSTATE-REF-1"}) is None
     )
 
 
 def test_select_task_ref_candidate_single_segment_unchanged() -> None:
-    """Single-segment refs like ``MAINT-DIRTY-BR-01`` (one task ref, no
+    """Single-segment refs like ``WORKSTATE-REF-DIRTY-BR-01`` (one task ref, no
     follow-up suffix possible) resolve identically with or without
     registry context."""
     branch = "feature/maint-dirty-br-01"
     assert (
-        select_task_ref_candidate(branch, known_task_refs={"MAINT-DIRTY-BR-01"})
-        == "MAINT-DIRTY-BR-01"
+        select_task_ref_candidate(branch, known_task_refs={"WORKSTATE-REF-DIRTY-BR-01"})
+        == "WORKSTATE-REF-DIRTY-BR-01"
     )
     assert (
         select_task_ref_candidate(branch, known_task_refs=None)
-        == "MAINT-DIRTY-BR-01"
+        == "WORKSTATE-REF-DIRTY-BR-01"
     )
 
 

{workstate_protocol-0.1.6 → workstate_protocol-0.1.7}/tests/test_handoff_schema.py

@@ -16,18 +16,18 @@ from workstate_protocol import (
 
 
 def test_active_task_minimal_roundtrip() -> None:
-    a = ActiveTask(task_ref="E17-14", objective="probe")
+    a = ActiveTask(task_ref="WORKSTATE-REF-17-14", objective="probe")
     assert a.status is HandoffStatus.in_progress
     assert a.task_plan_path is None
     assert a.task_plan() is None
     dumped = a.model_dump()
-    assert dumped["task_ref"] == "E17-14"
+    assert dumped["task_ref"] == "WORKSTATE-REF-17-14"
     assert dumped["status"] == "in_progress"
 
 
 def test_active_task_with_plan_metadata() -> None:
     a = ActiveTask(
-        task_ref="E17-14",
+        task_ref="WORKSTATE-REF-17-14",
         objective="probe",
         target_branch="feature/e17-14",
         target_worktree_path="/tmp/worktree",
@@ -48,7 +48,7 @@ def test_active_task_allows_extra_fields_for_passthrough() -> None:
     # The handoff DB row has columns we don't model yet; they must
     # round-trip rather than blow up.
     raw = {
-        "task_ref": "E17-14",
+        "task_ref": "WORKSTATE-REF-17-14",
         "objective": "probe",
         "revision": 3,
         "updated_at": "2026-04-25T12:00:00Z",
@@ -135,12 +135,12 @@ def test_handoff_status_is_constrained() -> None:
 
 def test_turn_range_and_structured_summary_roundtrip() -> None:
     summary = StructuredSummary(
-        compaction_id="C-AHMCP-34-0001",
+        compaction_id="C-WORKSTATE-REF-34-0001",
         session_id="session-123",
         harness="codex",
-        task_ref="AHMCP-34",
+        task_ref="WORKSTATE-REF-34",
         turn_range=TurnRange(start_turn=1, end_turn=42),
-        decisions=[{"decision_id": "scope_intake_AHMCP-34_trigger_choice", "slug": "trigger-choice"}],
+        decisions=[{"decision_id": "scope_intake_WORKSTATE-34_trigger_choice", "slug": "trigger-choice"}],
         findings_fixed=["F-1"],
         findings_opened=["F-2"],
         tests_verified=["pytest tests/test_schema_migrations.py -q"],
@@ -154,7 +154,7 @@ def test_turn_range_and_structured_summary_roundtrip() -> None:
     assert dumped["harness"] == "codex"
     restored = StructuredSummary.model_validate(dumped)
     assert restored.turn_range.end_turn == 42
-    assert restored.decisions[0].decision_id == "scope_intake_AHMCP-34_trigger_choice"
+    assert restored.decisions[0].decision_id == "scope_intake_WORKSTATE-34_trigger_choice"
 
 
 def test_compaction_summary_schema_artifact_exists() -> None:

{workstate_protocol-0.1.6 → workstate_protocol-0.1.7}/tests/test_skill_manifest_real_skills.py

@@ -1,7 +1,7 @@
 """Loads real harness skills from workstate-system to confirm the
 SkillManifest contract matches what is actually shipped.
 
-After plan 0002 step 1, the canonical layout is
+After implementation note step 1, the canonical layout is
 ``packages/workstate-system/skills/<slug>/{skill.yaml, body.md}``.
 The Claude-namespaced ``.claude/skills/<slug>/SKILL.md`` is a generated
 artifact in target repos, not source. This test reads the neutral