scry-parse 1.0.0__tar.gz

scry_parse-1.0.0/.gitignore

@@ -0,0 +1,4 @@
+__pycache__/
+*.pyc
+.venv/
+*.egg-info/

scry_parse-1.0.0/CHANGELOG.md

@@ -0,0 +1,21 @@
+# Changelog
+
+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.0.0] - 2026-05-14
+
+### Added
+
+- Initial release: Python parser for scry-spec v1.0 marker format
+- `parse_markers(content, language)` — parses EntryMarker, AnchorMarker, and BindingMarker from any host-language comment style
+- `validate_marker(marker)` — validates parsed markers against spec rules, returns errors and warnings
+- `mint_id(kind, name, content)` — generates spec-conformant marker IDs with deterministic (content-based) or random hashes
+- `BASELINE_KINDS` and `BASELINE_STATUSES` constants per scry-spec v1.0
+- Support for HTML/markdown, Python, TypeScript/JS, SQL, and Lisp comment styles
+- FR3 positional exclusion: bind markers inside entry/anchor bodies are not indexed
+- FR2 multi-anchor expansion: comma-separated loose anchors expand to N BindingMarker records
+- Block form and single-line binding marker support
+- 19 spec compliance tests plus additional edge case coverage

scry_parse-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 reflection
+
+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.

scry_parse-1.0.0/PKG-INFO

@@ -0,0 +1,86 @@
+Metadata-Version: 2.4
+Name: scry-parse
+Version: 1.0.0
+Summary: Python parser for scry-spec v1.0 markers
+Project-URL: Repository, https://github.com/prmichaelsen/scry-spec
+License: MIT License
+        
+        Copyright (c) 2026 reflection
+        
+        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.
+License-File: LICENSE
+Requires-Python: >=3.11
+Requires-Dist: pyyaml>=6.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# scry-parse
+
+Python parser for the [scry-spec v1.0](https://github.com/prmichaelsen/scry-spec) marker format.
+
+## Install
+
+```bash
+uv pip install scry-parse
+# or:
+pip install scry-parse
+```
+
+## Usage
+
+```python
+from scry_parse import parse_markers, validate_marker, mint_id, BASELINE_KINDS, BASELINE_STATUSES
+
+# Parse markers from file content
+with open("my_file.md") as f:
+    content = f.read()
+
+result = parse_markers(content)
+
+for entry in result.entries:
+    print(entry.id, entry.kind, entry.summary)
+
+for anchor in result.anchors:
+    print(anchor.name, anchor.description)
+
+for binding in result.bindings:
+    print(binding.local_id, binding.ref)
+
+# Validate a parsed marker
+vr = validate_marker(result.entries[0])
+if not vr.valid:
+    print(vr.errors)
+
+# Generate a new marker ID
+entry_id = mint_id("design", "auth-flow")          # random hash
+entry_id = mint_id("design", "auth-flow", content)  # deterministic hash
+```
+
+## Supported comment styles
+
+- HTML/Markdown: `<!-- @scry.entry ... @scry.entry.end -->`
+- Python/Shell: `# @scry.entry ... # @scry.entry.end`
+- TypeScript/JS: `// @scry.entry ... // @scry.entry.end`
+- SQL: `-- @scry.entry ... -- @scry.entry.end`
+- Lisp: `;; @scry.entry ... ;; @scry.entry.end`
+
+## License
+
+MIT — see [LICENSE](LICENSE).

scry_parse-1.0.0/README.md

@@ -0,0 +1,53 @@
+# scry-parse
+
+Python parser for the [scry-spec v1.0](https://github.com/prmichaelsen/scry-spec) marker format.
+
+## Install
+
+```bash
+uv pip install scry-parse
+# or:
+pip install scry-parse
+```
+
+## Usage
+
+```python
+from scry_parse import parse_markers, validate_marker, mint_id, BASELINE_KINDS, BASELINE_STATUSES
+
+# Parse markers from file content
+with open("my_file.md") as f:
+    content = f.read()
+
+result = parse_markers(content)
+
+for entry in result.entries:
+    print(entry.id, entry.kind, entry.summary)
+
+for anchor in result.anchors:
+    print(anchor.name, anchor.description)
+
+for binding in result.bindings:
+    print(binding.local_id, binding.ref)
+
+# Validate a parsed marker
+vr = validate_marker(result.entries[0])
+if not vr.valid:
+    print(vr.errors)
+
+# Generate a new marker ID
+entry_id = mint_id("design", "auth-flow")          # random hash
+entry_id = mint_id("design", "auth-flow", content)  # deterministic hash
+```
+
+## Supported comment styles
+
+- HTML/Markdown: `<!-- @scry.entry ... @scry.entry.end -->`
+- Python/Shell: `# @scry.entry ... # @scry.entry.end`
+- TypeScript/JS: `// @scry.entry ... // @scry.entry.end`
+- SQL: `-- @scry.entry ... -- @scry.entry.end`
+- Lisp: `;; @scry.entry ... ;; @scry.entry.end`
+
+## License
+
+MIT — see [LICENSE](LICENSE).

scry_parse-1.0.0/agent/runtime/orchestrators/a0c8751b93f5.path

@@ -0,0 +1 @@
+/home/prmichaelsen/.acp/projects/reflection

scry_parse-1.0.0/pyproject.toml

@@ -0,0 +1,24 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "scry-parse"
+version = "1.0.0"
+description = "Python parser for scry-spec v1.0 markers"
+readme = "README.md"
+license = {file = "LICENSE"}
+requires-python = ">=3.11"
+dependencies = ["pyyaml>=6.0"]
+
+[project.optional-dependencies]
+dev = ["pytest>=7.0"]
+
+[project.urls]
+Repository = "https://github.com/prmichaelsen/scry-spec"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/scry_parse"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

scry_parse-1.0.0/src/scry_parse/__init__.py

@@ -0,0 +1,42 @@
+"""scry-parse: Python parser for scry-spec v1.0 markers.
+
+Public API:
+    parse_markers(content, language=None, file="") -> ParseResult
+    validate_marker(marker) -> ValidationResult
+    mint_id(kind, name, content=None) -> str
+    BASELINE_KINDS
+    BASELINE_STATUSES
+
+Dataclasses:
+    EntryMarker
+    AnchorMarker
+    BindingMarker
+    ParseResult
+    ValidationResult
+"""
+
+from scry_parse.markers import (
+    parse_markers,
+    EntryMarker,
+    AnchorMarker,
+    BindingMarker,
+    ParseResult,
+)
+from scry_parse.validate import validate_marker, ValidationResult
+from scry_parse.mint import mint_id
+from scry_parse.consts import BASELINE_KINDS, BASELINE_STATUSES
+
+__all__ = [
+    "parse_markers",
+    "EntryMarker",
+    "AnchorMarker",
+    "BindingMarker",
+    "ParseResult",
+    "validate_marker",
+    "ValidationResult",
+    "mint_id",
+    "BASELINE_KINDS",
+    "BASELINE_STATUSES",
+]
+
+__version__ = "1.0.0"

scry_parse-1.0.0/src/scry_parse/consts.py

@@ -0,0 +1,19 @@
+"""Constants for scry-spec v1.0: baseline kinds, statuses, and ID regexes."""
+import re
+
+BASELINE_KINDS = (
+    "design", "pattern", "spec", "lesson", "internal",
+    "task", "milestone",
+    "report", "audit", "research",
+    "code",
+)
+
+BASELINE_STATUSES = ("draft", "active", "deprecated")
+
+# ID validation regexes per scry-spec v1.0
+# Entry/doc IDs: kind.name~8hexchars
+ID_REGEX = re.compile(r'^[a-z]+\.[a-z0-9-]+~[a-f0-9]{8}$')
+# Anchor/impl/test IDs: name~8hexchars (no dot)
+ANCHOR_ID_REGEX = re.compile(r'^[a-z0-9-]+~[a-f0-9]{8}$')
+# Loose anchor IDs used in refs: uppercase letters followed by digits (e.g. FR3, UT1)
+LOOSE_ANCHOR_REGEX = re.compile(r'^[A-Z]+[0-9]+$')