dotmd-parser 0.1.0__tar.gz

dotmd_parser-0.1.0/LICENSE

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

dotmd_parser-0.1.0/PKG-INFO

@@ -0,0 +1,121 @@
+Metadata-Version: 2.4
+Name: dotmd-parser
+Version: 0.1.0
+Summary: Dependency graph parser for .md skill files — parse @include/@delegate directives, build graphs, and resolve templates for AI agent prompt engineering
+Author: dotmd-projects
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/dotmd-projects/dotmd-parser
+Project-URL: Repository, https://github.com/dotmd-projects/dotmd-parser
+Project-URL: Issues, https://github.com/dotmd-projects/dotmd-parser/issues
+Keywords: claude-code,ai-agent,skill-management,prompt-engineering,dependency-graph,SKILL.md,markdown,parser,dotmd,llm
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Topic :: Text Processing :: Markup :: Markdown
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# dotmd-parser
+
+Dependency graph parser for `.md` skill files. Parses `@include` / `@delegate` directives and `Read` references, then builds a file dependency graph.
+
+Designed for AI agent prompt engineering workflows — manage modular prompt skills with dependency tracking, template resolution, and impact analysis.
+
+## Installation
+
+```bash
+pip install dotmd-parser
+```
+
+For development:
+
+```bash
+git clone https://github.com/dotmd-projects/dotmd-parser.git
+cd dotmd-parser
+pip install -e .
+```
+
+## Quick Start
+
+```python
+from dotmd_parser import build_graph, resolve, dependents_of, summary
+```
+
+### build_graph — Build a dependency graph
+
+```python
+graph = build_graph("./my-skill/")
+# or
+graph = build_graph("./my-skill/SKILL.md")
+```
+
+Returns:
+```json
+{
+  "nodes": [{"id": "...", "type": "skill", "missing": false, "placeholders": []}],
+  "edges": [{"from": "...", "to": "...", "type": "include", "parallel": false}],
+  "warnings": []
+}
+```
+
+### resolve — Expand @include directives
+
+```python
+result = resolve("./prompts/main.md", variables={"name": "Alice"})
+print(result["content"])       # Fully expanded text
+print(result["placeholders"])  # Unresolved {{variable}} list
+```
+
+### dependents_of — Reverse dependency query
+
+```python
+# Find all files affected by changes to shared/role.md
+affected = dependents_of(graph, "/abs/path/to/shared/role.md")
+```
+
+### summary — Print graph overview
+
+```python
+print(summary(graph))
+# Nodes: 5  (agent:1, shared:2, skill:1, reference:1)
+# Edges: 4  (include:3, read-ref:1)
+# Warnings: 0
+```
+
+## Directives
+
+| Directive | Description |
+|---|---|
+| `@include path/to/file.md` | Inline expansion of the referenced file |
+| `@delegate path/to/agent.md` | Delegate to an agent (no expansion) |
+| `@delegate path/to/agent.md --parallel` | Delegate with parallel execution flag |
+| `Read \`path/to/file.md\`` | Runtime reference (no expansion, recorded in graph) |
+
+## CLI
+
+```bash
+dotmd-parser ./my-skill/
+# or
+python -m dotmd_parser.parser ./my-skill/
+```
+
+## Testing
+
+```bash
+pip install pytest
+pytest tests/ -v
+```
+
+## License
+
+MIT

dotmd_parser-0.1.0/README.md

@@ -0,0 +1,94 @@
+# dotmd-parser
+
+Dependency graph parser for `.md` skill files. Parses `@include` / `@delegate` directives and `Read` references, then builds a file dependency graph.
+
+Designed for AI agent prompt engineering workflows — manage modular prompt skills with dependency tracking, template resolution, and impact analysis.
+
+## Installation
+
+```bash
+pip install dotmd-parser
+```
+
+For development:
+
+```bash
+git clone https://github.com/dotmd-projects/dotmd-parser.git
+cd dotmd-parser
+pip install -e .
+```
+
+## Quick Start
+
+```python
+from dotmd_parser import build_graph, resolve, dependents_of, summary
+```
+
+### build_graph — Build a dependency graph
+
+```python
+graph = build_graph("./my-skill/")
+# or
+graph = build_graph("./my-skill/SKILL.md")
+```
+
+Returns:
+```json
+{
+  "nodes": [{"id": "...", "type": "skill", "missing": false, "placeholders": []}],
+  "edges": [{"from": "...", "to": "...", "type": "include", "parallel": false}],
+  "warnings": []
+}
+```
+
+### resolve — Expand @include directives
+
+```python
+result = resolve("./prompts/main.md", variables={"name": "Alice"})
+print(result["content"])       # Fully expanded text
+print(result["placeholders"])  # Unresolved {{variable}} list
+```
+
+### dependents_of — Reverse dependency query
+
+```python
+# Find all files affected by changes to shared/role.md
+affected = dependents_of(graph, "/abs/path/to/shared/role.md")
+```
+
+### summary — Print graph overview
+
+```python
+print(summary(graph))
+# Nodes: 5  (agent:1, shared:2, skill:1, reference:1)
+# Edges: 4  (include:3, read-ref:1)
+# Warnings: 0
+```
+
+## Directives
+
+| Directive | Description |
+|---|---|
+| `@include path/to/file.md` | Inline expansion of the referenced file |
+| `@delegate path/to/agent.md` | Delegate to an agent (no expansion) |
+| `@delegate path/to/agent.md --parallel` | Delegate with parallel execution flag |
+| `Read \`path/to/file.md\`` | Runtime reference (no expansion, recorded in graph) |
+
+## CLI
+
+```bash
+dotmd-parser ./my-skill/
+# or
+python -m dotmd_parser.parser ./my-skill/
+```
+
+## Testing
+
+```bash
+pip install pytest
+pytest tests/ -v
+```
+
+## License
+
+MIT

dotmd_parser-0.1.0/pyproject.toml

@@ -0,0 +1,54 @@
+[project]
+name = "dotmd-parser"
+version = "0.1.0"
+description = "Dependency graph parser for .md skill files — parse @include/@delegate directives, build graphs, and resolve templates for AI agent prompt engineering"
+requires-python = ">=3.10"
+license = "MIT"
+readme = "README.md"
+authors = [
+    { name = "dotmd-projects" },
+]
+keywords = [
+    "claude-code",
+    "ai-agent",
+    "skill-management",
+    "prompt-engineering",
+    "dependency-graph",
+    "SKILL.md",
+    "markdown",
+    "parser",
+    "dotmd",
+    "llm",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Software Development :: Code Generators",
+    "Topic :: Text Processing :: Markup :: Markdown",
+    "Typing :: Typed",
+]
+
+[project.urls]
+Homepage = "https://github.com/dotmd-projects/dotmd-parser"
+Repository = "https://github.com/dotmd-projects/dotmd-parser"
+Issues = "https://github.com/dotmd-projects/dotmd-parser/issues"
+
+[project.scripts]
+dotmd-parser = "dotmd_parser.parser:main"
+
+[build-system]
+requires = ["setuptools>=68.0"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

dotmd_parser-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

dotmd_parser-0.1.0/src/dotmd_parser/__init__.py

@@ -0,0 +1,33 @@
+"""
+dotmd-parser — Dependency graph parser for .md skill files.
+
+Parse @include/@delegate directives, build dependency graphs,
+and resolve templates for AI agent prompt engineering.
+
+API:
+    from dotmd_parser import build_graph, resolve, dependents_of, summary
+"""
+
+__version__ = "0.1.0"
+
+from dotmd_parser.parser import (
+    build_graph,
+    resolve,
+    dependents_of,
+    parse_directives,
+    parse_read_refs,
+    parse_placeholders,
+    parse_deps_yml,
+    summary,
+)
+
+__all__ = [
+    "build_graph",
+    "resolve",
+    "dependents_of",
+    "parse_directives",
+    "parse_read_refs",
+    "parse_placeholders",
+    "parse_deps_yml",
+    "summary",
+]