scry-parse 1.2.0__tar.gz → 1.2.1__tar.gz

{scry_parse-1.2.0 → scry_parse-1.2.1}/CHANGELOG.md

@@ -5,6 +5,29 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.2.1] - 2026-09-21
+
+### Fixed
+
+- **`kind: goal` added to `BASELINE_KINDS`** (scry-spec v1.2.0 FR8).
+  v1.2.0 added `goal` to the spec's baseline kind enumeration but
+  `consts.py` was not updated. `validate_marker` now correctly
+  recognizes `kind: goal` without emitting a "not in baseline kinds"
+  warning.
+
+- **INV-GOAL-COMPLETION enforced in `validate_marker`** (scry-spec
+  v1.2.0). `status: met` on a `kind: goal` marker now produces
+  `valid=False` with an explicit `INV-GOAL-COMPLETION` error.
+  Met-ness is computed from the deliverable set, never declared.
+  The redundant "status 'met' not in baseline statuses" warning is
+  suppressed when the INV error fires.
+
+- **Module docstrings** updated from v1.0/v1.1 to v1.2 in `consts.py`
+  and `validate.py`.
+
+- **122/122 tests pass** (4 new tests for goal kind and
+  INV-GOAL-COMPLETION).
+
 ## [1.2.0] - 2026-09-21
 
 ### Added

{scry_parse-1.2.0 → scry_parse-1.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: scry-parse
-Version: 1.2.0
+Version: 1.2.1
 Summary: Python parser for scry-spec v1.2 markers
 Project-URL: Repository, https://github.com/prmichaelsen/scry-parse-py
 License: MIT License

{scry_parse-1.2.0 → scry_parse-1.2.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "scry-parse"
-version = "1.2.0"
+version = "1.2.1"
 description = "Python parser for scry-spec v1.2 markers"
 readme = "README.md"
 license = {file = "LICENSE"}
@@ -22,3 +22,10 @@ packages = ["src/scry_parse"]
 
 [tool.pytest.ini_options]
 testpaths = ["tests"]
+
+[dependency-groups]
+dev = [
+    "anyio>=4.15.1",
+    "pytest>=9.0.3",
+    "pytest-asyncio>=1.4.0",
+]

{scry_parse-1.2.0 → scry_parse-1.2.1}/src/scry_parse/__init__.py

@@ -47,4 +47,4 @@ __all__ = [
     "BASELINE_STATUSES",
 ]
 
-__version__ = "1.2.0"
+__version__ = "1.2.1"

{scry_parse-1.2.0 → scry_parse-1.2.1}/src/scry_parse/consts.py

@@ -1,4 +1,4 @@
-"""Constants for scry-spec v1.0: baseline kinds, statuses, and ID regexes."""
+"""Constants for scry-spec v1.2: baseline kinds, statuses, and ID regexes."""
 import re
 
 BASELINE_KINDS = (
@@ -6,6 +6,7 @@ BASELINE_KINDS = (
     "task", "milestone",
     "report", "audit", "research",
     "code",
+    "goal",  # scry-spec v1.2.0 FR8 — declares an objective
 )
 
 BASELINE_STATUSES = ("draft", "active", "deprecated")

{scry_parse-1.2.0 → scry_parse-1.2.1}/src/scry_parse/validate.py

@@ -1,4 +1,4 @@
-"""Validation for parsed scry markers per scry-spec v1.1."""
+"""Validation for parsed scry markers per scry-spec v1.2."""
 from __future__ import annotations
 
 from dataclasses import dataclass
@@ -67,10 +67,27 @@ def _validate_entry(marker: EntryMarker) -> ValidationResult:
     if not marker.summary or not marker.summary.strip():
         errors.append("summary must be non-empty")
 
+    # INV-GOAL-COMPLETION (scry-spec v1.2.0): status: met MUST NOT be hand-set
+    # on kind: goal markers.  Met-ness is computed from the deliverable set;
+    # "abandoned" is the only valid terminal status an author may write on a
+    # goal marker.  Validators MUST reject any marker with kind=goal +
+    # status=met.
+    if marker.kind == "goal" and marker.status == "met":
+        errors.append(
+            "INV-GOAL-COMPLETION (scry-spec v1.2.0): status 'met' must not "
+            "be set on a kind=goal marker — met-ness is computed from the "
+            "deliverable set, never declared. Use 'abandoned' to close a goal."
+        )
+
     # status must be non-empty; warn if not in BASELINE_STATUSES
     if not marker.status or not marker.status.strip():
         errors.append("status must be a non-empty string")
-    elif marker.status not in BASELINE_STATUSES:
+    elif marker.status not in BASELINE_STATUSES and not (
+        marker.kind == "goal" and marker.status == "met"
+    ):
+        # status:met on kind:goal is already an error (INV-GOAL-COMPLETION
+        # above); suppress the redundant "not in baseline statuses" warning
+        # to keep diagnostic output clean.
         warnings.append(
             f"status {marker.status!r} is not in the baseline statuses list; "
             f"expected one of: {', '.join(BASELINE_STATUSES)}"

{scry_parse-1.2.0 → scry_parse-1.2.1}/tests/test_parse.py

@@ -717,10 +717,12 @@ def test_validate_binding_empty_ref():
 # consts tests
 # ---------------------------------------------------------------------------
 
-def test_baseline_kinds_contains_all_v1_kinds():
+def test_baseline_kinds_contains_all_v12_kinds():
+    """BASELINE_KINDS must contain all scry-spec v1.2 kinds (v1.0 set + goal)."""
     expected = {
         "design", "pattern", "spec", "lesson", "internal",
-        "task", "milestone", "report", "audit", "research", "code"
+        "task", "milestone", "report", "audit", "research", "code",
+        "goal",  # scry-spec v1.2.0 FR8
     }
     assert set(BASELINE_KINDS) == expected
 
@@ -2257,3 +2259,107 @@ summary: Test
     assert len(result.entries) == 1
     e = result.entries[0]
     assert e.satisfies == []
+
+
+# ---------------------------------------------------------------------------
+# scry-spec v1.2.0 — kind=goal baseline recognition + INV-GOAL-COMPLETION
+# ---------------------------------------------------------------------------
+
+def test_goal_kind_is_baseline_kind():
+    """kind=goal is a scry-spec v1.2.0 baseline kind — validator MUST NOT warn."""
+    content = """\
+<!-- @scry.entry
+id: goal.reduce-churn~abcd1234
+kind: goal
+summary: Reduce monthly churn to below 2% by end of Q4.
+status: active
+weight: 0.8
+@scry.entry.end -->
+"""
+    result = parse_markers(content)
+    assert len(result.entries) == 1
+    e = result.entries[0]
+    assert e.kind == "goal"
+    vr = validate_marker(e)
+    assert vr.valid is True
+    kind_warnings = [w for w in vr.warnings if "kind" in w.lower() and "goal" in w.lower()]
+    assert not kind_warnings, (
+        f"validate_marker emitted unexpected kind warning for kind=goal: {kind_warnings}"
+    )
+
+
+def test_inv_goal_completion_met_is_error():
+    """INV-GOAL-COMPLETION: status=met on kind=goal MUST be rejected as an error."""
+    content = """\
+<!-- @scry.entry
+id: goal.reduce-churn~abcd1234
+kind: goal
+summary: Reduce monthly churn to below 2% by end of Q4.
+status: met
+weight: 0.8
+@scry.entry.end -->
+"""
+    result = parse_markers(content)
+    assert len(result.entries) == 1, "Entry should still parse (parse != validate)"
+    e = result.entries[0]
+    assert e.kind == "goal"
+    assert e.status == "met"
+    vr = validate_marker(e)
+    assert vr.valid is False, (
+        "validate_marker should return valid=False for kind=goal status=met "
+        "(INV-GOAL-COMPLETION)"
+    )
+    inv_errors = [err for err in vr.errors if "INV-GOAL-COMPLETION" in err]
+    assert inv_errors, (
+        f"Expected an INV-GOAL-COMPLETION error; got errors: {vr.errors}"
+    )
+    # The redundant "status 'met' not in baseline" warning should be suppressed
+    redundant_warnings = [w for w in vr.warnings if "met" in w and "baseline" in w]
+    assert not redundant_warnings, (
+        f"Redundant 'met not in baseline' warning should be suppressed when "
+        f"INV-GOAL-COMPLETION fires; got: {redundant_warnings}"
+    )
+
+
+def test_inv_goal_completion_abandoned_is_ok():
+    """status=abandoned on kind=goal is valid — only terminal author-writable status."""
+    content = """\
+<!-- @scry.entry
+id: goal.reduce-churn~abcd1234
+kind: goal
+summary: Reduce monthly churn.
+status: active
+weight: 0.5
+@scry.entry.end -->
+"""
+    result = parse_markers(content)
+    e = result.entries[0]
+    vr = validate_marker(e)
+    assert vr.valid is True
+    assert not any("INV-GOAL-COMPLETION" in w for w in vr.errors)
+
+
+def test_inv_goal_completion_only_fires_on_goal_kind():
+    """status=met on a non-goal kind is a warning (unknown status), not INV error."""
+    content = """\
+<!-- @scry.entry
+id: design.foo~abcd1234
+kind: design
+summary: Some design doc.
+status: met
+weight: 0.5
+@scry.entry.end -->
+"""
+    result = parse_markers(content)
+    e = result.entries[0]
+    vr = validate_marker(e)
+    # No INV-GOAL-COMPLETION error (kind != goal)
+    inv_errors = [err for err in vr.errors if "INV-GOAL-COMPLETION" in err]
+    assert not inv_errors, (
+        f"INV-GOAL-COMPLETION should only fire on kind=goal; got: {inv_errors}"
+    )
+    # But status=met IS an unknown status warning for non-goal kinds
+    status_warnings = [w for w in vr.warnings if "met" in w]
+    assert status_warnings, (
+        "Expected a 'met not in baseline statuses' warning for kind=design status=met"
+    )

{scry_parse-1.2.0 → scry_parse-1.2.1}/uv.lock

@@ -2,6 +2,19 @@ version = 1
 revision = 3
 requires-python = ">=3.11"
 
+[[package]]
+name = "anyio"
+version = "4.15.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "idna" },
+    { name = "typing-extensions", marker = "python_full_version < '3.15'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/a9/d2/f4d173e22df740bc37b1db102b386ba719b66e95b0f0d751f556b387e6d2/anyio-4.15.1.tar.gz", hash = "sha256:9f28306018cbd6d329e64a36d58256edff76dd996fe423bc957326e578b82a94", size = 276966, upload-time = "2026-09-05T10:42:39.44Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/12/b8/4bd346e22b28902df4d651910f5242c28d84e4a5c2435ca5c3f797ed7e2e/anyio-4.15.1-py3-none-any.whl", hash = "sha256:6152fdbbf9a77fdec97731721bebf7c4c44f7c29b424b0065826173efc7ed101", size = 132079, upload-time = "2026-09-05T10:42:37.923Z" },
+]
+
 [[package]]
 name = "colorama"
 version = "0.4.6"
@@ -11,6 +24,15 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/d1/d6/3965ed04c63042e047cb6a3e6ed1a63a35087b6a609aa3a15ed8ac56c221/colorama-0.4.6-py2.py3-none-any.whl", hash = "sha256:4f1d9991f5acc0ca119f9d443620b77f9d6b33703e51011c16baf57afb285fc6", size = 25335, upload-time = "2022-10-25T02:36:20.889Z" },
 ]
 
+[[package]]
+name = "idna"
+version = "3.20"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/f5/08/8eea9d4b8302028f3abb2c0813953f7aec26d33b7a8960ed760e65ff29fa/idna-3.20.tar.gz", hash = "sha256:a7db850025b95ded1eae8a46181a1a6c56c92c96f0e2b005d9ff8dc0210cab44", size = 216463, upload-time = "2026-09-17T14:11:04.752Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/58/a2/bb081bab032533a855d44de1d56f8e8426114ff1ba5d1f07a438a0a654f8/idna-3.20-py3-none-any.whl", hash = "sha256:ab7ae7122974553370f0bdb919e1a960b2cd1bc1ef0276416d896db81c14582c", size = 69583, upload-time = "2026-09-17T14:11:03.168Z" },
+]
+
 [[package]]
 name = "iniconfig"
 version = "2.3.0"
@@ -63,6 +85,19 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/d4/24/a372aaf5c9b7208e7112038812994107bc65a84cd00e0354a88c2c77a617/pytest-9.0.3-py3-none-any.whl", hash = "sha256:2c5efc453d45394fdd706ade797c0a81091eccd1d6e4bccfcd476e2b8e0ab5d9", size = 375249, upload-time = "2026-04-07T17:16:16.13Z" },
 ]
 
+[[package]]
+name = "pytest-asyncio"
+version = "1.4.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "pytest" },
+    { name = "typing-extensions", marker = "python_full_version < '3.13'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/43/7c/d36d04db312ecf4298932ef77e6e4a9e8ad017906e24e34f0b0c361a2473/pytest_asyncio-1.4.0.tar.gz", hash = "sha256:c6c0d2259945122819f171a32ecea2c349ead889ee28176caaf492143424be42", size = 58514, upload-time = "2026-05-26T09:56:04.083Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/03/e2/08a497ef684b88559c9cc5f4ad53a37e7b99e727094a86d6ea32536d5d3c/pytest_asyncio-1.4.0-py3-none-any.whl", hash = "sha256:933ca923a23075a87fb7070c0ec272a6848489824d887c85c812670932835aa1", size = 16930, upload-time = "2026-05-26T09:56:02.576Z" },
+]
+
 [[package]]
 name = "pyyaml"
 version = "6.0.3"
@@ -120,7 +155,7 @@ wheels = [
 
 [[package]]
 name = "scry-parse"
-version = "1.2.0"
+version = "1.2.1"
 source = { editable = "." }
 dependencies = [
     { name = "pyyaml" },
@@ -131,9 +166,32 @@ dev = [
     { name = "pytest" },
 ]
 
+[package.dev-dependencies]
+dev = [
+    { name = "anyio" },
+    { name = "pytest" },
+    { name = "pytest-asyncio" },
+]
+
 [package.metadata]
 requires-dist = [
     { name = "pytest", marker = "extra == 'dev'", specifier = ">=7.0" },
     { name = "pyyaml", specifier = ">=6.0" },
 ]
 provides-extras = ["dev"]
+
+[package.metadata.requires-dev]
+dev = [
+    { name = "anyio", specifier = ">=4.15.1" },
+    { name = "pytest", specifier = ">=9.0.3" },
+    { name = "pytest-asyncio", specifier = ">=1.4.0" },
+]
+
+[[package]]
+name = "typing-extensions"
+version = "4.16.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/f6/cc/6253133b5bb138fc3306cebfbda2c520f545d36b5be2c7255cc528bb45d6/typing_extensions-4.16.0.tar.gz", hash = "sha256:dc983d19a509c94dba722ee6abd33940f7c05a89e243c47e907eb4db6f1a43e5", size = 113555, upload-time = "2026-07-02T08:40:05.92Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/49/d3/b8441a820a491ddfc024b0b0cf0393375b75ea13866d9c66727e54c2fc80/typing_extensions-4.16.0-py3-none-any.whl", hash = "sha256:481caa481374e813c1b176ada14e97f1f67a4539ce9cfeb3f350d78d6370c2e8", size = 45571, upload-time = "2026-07-02T08:40:04.659Z" },
+]