ally-demo-python 0.1.0__tar.gz

ally_demo_python-0.1.0/LICENSE

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

ally_demo_python-0.1.0/PKG-INFO

@@ -0,0 +1,135 @@
+Metadata-Version: 2.4
+Name: ally-demo-python
+Version: 0.1.0
+Summary: Reference integration for Ally (a11y-assist, a11y-lint, a11y-ci)
+Author-email: mcp-tool-shop <64996768+mcp-tool-shop@users.noreply.github.com>
+License: MIT
+Project-URL: Homepage, https://github.com/mcp-tool-shop/ally-demo-python
+Project-URL: Repository, https://github.com/mcp-tool-shop/ally-demo-python
+Project-URL: Issues, https://github.com/mcp-tool-shop/ally-demo-python/issues
+Keywords: a11y,accessibility,cli,demo,reference,ally,error-messages,assistive-technology
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Quality Assurance
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: a11y-assist; extra == "dev"
+Requires-Dist: a11y-lint; extra == "dev"
+Dynamic: license-file
+
+# Ally Demo (Python)
+
+A minimal Python CLI that emits **cli.error.v0.1** (ground truth) and demonstrates the full Ally pipeline:
+
+- `a11y-assist` (profiles: lowvision, cognitive-load, screen-reader, dyslexia, plain-language)
+- `a11y-lint` (validate + scan)
+- `a11y-ci` (gate)
+
+This repo is intentionally small and boring. It's a reference integration.
+
+## Quickstart
+
+```bash
+python -m venv .venv
+# Windows: .venv\Scripts\activate
+# macOS/Linux: source .venv/bin/activate
+
+pip install -e .
+pip install a11y-assist a11y-lint
+```
+
+Run a failing command that emits structured JSON:
+
+```bash
+demo-cli network-timeout --json-out /tmp/cli_error.json || true
+```
+
+Explain the same error using different profiles:
+
+```bash
+a11y-assist explain --json /tmp/cli_error.json --profile lowvision
+a11y-assist explain --json /tmp/cli_error.json --profile cognitive-load
+a11y-assist explain --json /tmp/cli_error.json --profile screen-reader
+a11y-assist explain --json /tmp/cli_error.json --profile dyslexia
+a11y-assist explain --json /tmp/cli_error.json --profile plain-language
+```
+
+Validate the message contract:
+
+```bash
+a11y-lint validate /tmp/cli_error.json
+```
+
+## Available Error Scenarios
+
+The demo CLI includes several error scenarios to demonstrate different patterns:
+
+| Command | Error ID | Description |
+|---------|----------|-------------|
+| `demo-cli network-timeout` | DEMO.NETWORK.TIMEOUT | HTTP request timeout |
+| `demo-cli config-missing` | DEMO.CONFIG.MISSING | Missing config file |
+| `demo-cli auth-failed` | DEMO.AUTH.INVALID_TOKEN | Authentication failure |
+| `demo-cli permission-denied` | DEMO.FS.PERMISSION_DENIED | File permission error |
+| `demo-cli validation-error` | DEMO.VALIDATION.SCHEMA | Schema validation failure |
+
+Each command:
+- Prints human-readable output to stdout
+- Writes JSON to the specified `--json-out` path
+- Emits JSON to stderr for machine capture
+
+## What "good" looks like
+
+The CLI prints a human-readable message in a predictable structure:
+
+```
+[ERROR] Title (ID: ...)
+
+What:
+  Description of what happened.
+
+Why:
+  Explanation of why it happened.
+
+Fix:
+  Steps to resolve the issue.
+  Re-run: command --dry-run
+```
+
+The CLI also emits valid `cli.error.v0.1` JSON for machine capture.
+
+- `a11y-assist` never rewrites the original output; it adds an ASSIST block.
+- SAFE-only commands are suggested (and only when present in the input).
+
+## Design notes
+
+This demo intentionally emits:
+
+- A stable `id` namespace (DEMO.*)
+- Fix lines that include a `Re-run:` command containing `--dry-run` (SAFE)
+
+That makes it easy to test the whole pipeline end-to-end.
+
+## Adopt Ally in 10 minutes (for tool authors)
+
+1. Emit `cli.error.v0.1` JSON on failure (machine output)
+2. Print the same content in a predictable text structure (human output)
+3. Add CI:
+   - `a11y-lint validate <message.json>`
+   - `a11y-ci gate` for scorecards if you lint text output
+4. Tell users:
+   - `a11y-assist explain --json <file>`
+   - or wrapper-first: `assist-run <command>` then `a11y-assist last`
+
+## License
+
+MIT

ally_demo_python-0.1.0/README.md

@@ -0,0 +1,106 @@
+# Ally Demo (Python)
+
+A minimal Python CLI that emits **cli.error.v0.1** (ground truth) and demonstrates the full Ally pipeline:
+
+- `a11y-assist` (profiles: lowvision, cognitive-load, screen-reader, dyslexia, plain-language)
+- `a11y-lint` (validate + scan)
+- `a11y-ci` (gate)
+
+This repo is intentionally small and boring. It's a reference integration.
+
+## Quickstart
+
+```bash
+python -m venv .venv
+# Windows: .venv\Scripts\activate
+# macOS/Linux: source .venv/bin/activate
+
+pip install -e .
+pip install a11y-assist a11y-lint
+```
+
+Run a failing command that emits structured JSON:
+
+```bash
+demo-cli network-timeout --json-out /tmp/cli_error.json || true
+```
+
+Explain the same error using different profiles:
+
+```bash
+a11y-assist explain --json /tmp/cli_error.json --profile lowvision
+a11y-assist explain --json /tmp/cli_error.json --profile cognitive-load
+a11y-assist explain --json /tmp/cli_error.json --profile screen-reader
+a11y-assist explain --json /tmp/cli_error.json --profile dyslexia
+a11y-assist explain --json /tmp/cli_error.json --profile plain-language
+```
+
+Validate the message contract:
+
+```bash
+a11y-lint validate /tmp/cli_error.json
+```
+
+## Available Error Scenarios
+
+The demo CLI includes several error scenarios to demonstrate different patterns:
+
+| Command | Error ID | Description |
+|---------|----------|-------------|
+| `demo-cli network-timeout` | DEMO.NETWORK.TIMEOUT | HTTP request timeout |
+| `demo-cli config-missing` | DEMO.CONFIG.MISSING | Missing config file |
+| `demo-cli auth-failed` | DEMO.AUTH.INVALID_TOKEN | Authentication failure |
+| `demo-cli permission-denied` | DEMO.FS.PERMISSION_DENIED | File permission error |
+| `demo-cli validation-error` | DEMO.VALIDATION.SCHEMA | Schema validation failure |
+
+Each command:
+- Prints human-readable output to stdout
+- Writes JSON to the specified `--json-out` path
+- Emits JSON to stderr for machine capture
+
+## What "good" looks like
+
+The CLI prints a human-readable message in a predictable structure:
+
+```
+[ERROR] Title (ID: ...)
+
+What:
+  Description of what happened.
+
+Why:
+  Explanation of why it happened.
+
+Fix:
+  Steps to resolve the issue.
+  Re-run: command --dry-run
+```
+
+The CLI also emits valid `cli.error.v0.1` JSON for machine capture.
+
+- `a11y-assist` never rewrites the original output; it adds an ASSIST block.
+- SAFE-only commands are suggested (and only when present in the input).
+
+## Design notes
+
+This demo intentionally emits:
+
+- A stable `id` namespace (DEMO.*)
+- Fix lines that include a `Re-run:` command containing `--dry-run` (SAFE)
+
+That makes it easy to test the whole pipeline end-to-end.
+
+## Adopt Ally in 10 minutes (for tool authors)
+
+1. Emit `cli.error.v0.1` JSON on failure (machine output)
+2. Print the same content in a predictable text structure (human output)
+3. Add CI:
+   - `a11y-lint validate <message.json>`
+   - `a11y-ci gate` for scorecards if you lint text output
+4. Tell users:
+   - `a11y-assist explain --json <file>`
+   - or wrapper-first: `assist-run <command>` then `a11y-assist last`
+
+## License
+
+MIT

ally_demo_python-0.1.0/ally_demo_python.egg-info/PKG-INFO

@@ -0,0 +1,135 @@
+Metadata-Version: 2.4
+Name: ally-demo-python
+Version: 0.1.0
+Summary: Reference integration for Ally (a11y-assist, a11y-lint, a11y-ci)
+Author-email: mcp-tool-shop <64996768+mcp-tool-shop@users.noreply.github.com>
+License: MIT
+Project-URL: Homepage, https://github.com/mcp-tool-shop/ally-demo-python
+Project-URL: Repository, https://github.com/mcp-tool-shop/ally-demo-python
+Project-URL: Issues, https://github.com/mcp-tool-shop/ally-demo-python/issues
+Keywords: a11y,accessibility,cli,demo,reference,ally,error-messages,assistive-technology
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Quality Assurance
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: a11y-assist; extra == "dev"
+Requires-Dist: a11y-lint; extra == "dev"
+Dynamic: license-file
+
+# Ally Demo (Python)
+
+A minimal Python CLI that emits **cli.error.v0.1** (ground truth) and demonstrates the full Ally pipeline:
+
+- `a11y-assist` (profiles: lowvision, cognitive-load, screen-reader, dyslexia, plain-language)
+- `a11y-lint` (validate + scan)
+- `a11y-ci` (gate)
+
+This repo is intentionally small and boring. It's a reference integration.
+
+## Quickstart
+
+```bash
+python -m venv .venv
+# Windows: .venv\Scripts\activate
+# macOS/Linux: source .venv/bin/activate
+
+pip install -e .
+pip install a11y-assist a11y-lint
+```
+
+Run a failing command that emits structured JSON:
+
+```bash
+demo-cli network-timeout --json-out /tmp/cli_error.json || true
+```
+
+Explain the same error using different profiles:
+
+```bash
+a11y-assist explain --json /tmp/cli_error.json --profile lowvision
+a11y-assist explain --json /tmp/cli_error.json --profile cognitive-load
+a11y-assist explain --json /tmp/cli_error.json --profile screen-reader
+a11y-assist explain --json /tmp/cli_error.json --profile dyslexia
+a11y-assist explain --json /tmp/cli_error.json --profile plain-language
+```
+
+Validate the message contract:
+
+```bash
+a11y-lint validate /tmp/cli_error.json
+```
+
+## Available Error Scenarios
+
+The demo CLI includes several error scenarios to demonstrate different patterns:
+
+| Command | Error ID | Description |
+|---------|----------|-------------|
+| `demo-cli network-timeout` | DEMO.NETWORK.TIMEOUT | HTTP request timeout |
+| `demo-cli config-missing` | DEMO.CONFIG.MISSING | Missing config file |
+| `demo-cli auth-failed` | DEMO.AUTH.INVALID_TOKEN | Authentication failure |
+| `demo-cli permission-denied` | DEMO.FS.PERMISSION_DENIED | File permission error |
+| `demo-cli validation-error` | DEMO.VALIDATION.SCHEMA | Schema validation failure |
+
+Each command:
+- Prints human-readable output to stdout
+- Writes JSON to the specified `--json-out` path
+- Emits JSON to stderr for machine capture
+
+## What "good" looks like
+
+The CLI prints a human-readable message in a predictable structure:
+
+```
+[ERROR] Title (ID: ...)
+
+What:
+  Description of what happened.
+
+Why:
+  Explanation of why it happened.
+
+Fix:
+  Steps to resolve the issue.
+  Re-run: command --dry-run
+```
+
+The CLI also emits valid `cli.error.v0.1` JSON for machine capture.
+
+- `a11y-assist` never rewrites the original output; it adds an ASSIST block.
+- SAFE-only commands are suggested (and only when present in the input).
+
+## Design notes
+
+This demo intentionally emits:
+
+- A stable `id` namespace (DEMO.*)
+- Fix lines that include a `Re-run:` command containing `--dry-run` (SAFE)
+
+That makes it easy to test the whole pipeline end-to-end.
+
+## Adopt Ally in 10 minutes (for tool authors)
+
+1. Emit `cli.error.v0.1` JSON on failure (machine output)
+2. Print the same content in a predictable text structure (human output)
+3. Add CI:
+   - `a11y-lint validate <message.json>`
+   - `a11y-ci gate` for scorecards if you lint text output
+4. Tell users:
+   - `a11y-assist explain --json <file>`
+   - or wrapper-first: `assist-run <command>` then `a11y-assist last`
+
+## License
+
+MIT

ally_demo_python-0.1.0/ally_demo_python.egg-info/SOURCES.txt

@@ -0,0 +1,13 @@
+LICENSE
+README.md
+pyproject.toml
+ally_demo_python.egg-info/PKG-INFO
+ally_demo_python.egg-info/SOURCES.txt
+ally_demo_python.egg-info/dependency_links.txt
+ally_demo_python.egg-info/entry_points.txt
+ally_demo_python.egg-info/requires.txt
+ally_demo_python.egg-info/top_level.txt
+demo_cli/__init__.py
+demo_cli/cli.py
+demo_cli/errors.py
+tests/test_errors.py

ally_demo_python-0.1.0/ally_demo_python.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

ally_demo_python-0.1.0/ally_demo_python.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+demo-cli = demo_cli.cli:main

ally_demo_python-0.1.0/ally_demo_python.egg-info/requires.txt

@@ -0,0 +1,6 @@
+click>=8.0
+
+[dev]
+pytest>=7.0
+a11y-assist
+a11y-lint

ally_demo_python-0.1.0/ally_demo_python.egg-info/top_level.txt

@@ -0,0 +1 @@
+demo_cli

ally_demo_python-0.1.0/demo_cli/__init__.py

@@ -0,0 +1,3 @@
+"""Demo CLI that emits cli.error.v0.1 for Ally integration."""
+
+__version__ = "0.1.0"

ally_demo_python-0.1.0/demo_cli/cli.py

@@ -0,0 +1,182 @@
+"""Demo CLI with multiple failure scenarios.
+
+Each command demonstrates a different error pattern while emitting valid
+cli.error.v0.1 JSON for machine capture.
+"""
+
+import sys
+from pathlib import Path
+
+import click
+
+from .errors import CliErrorV01, emit_cli_error
+
+
+def print_human_error(err: CliErrorV01) -> None:
+    """Print error in predictable human-readable structure.
+
+    This is the pattern a11y-lint expects for high accessibility scores.
+    """
+    click.echo(f"[{err.level}] {err.title} (ID: {err.id})")
+    click.echo("")
+    click.echo("What:")
+    for line in err.what:
+        click.echo(f"  {line}")
+    click.echo("")
+    click.echo("Why:")
+    for line in err.why:
+        click.echo(f"  {line}")
+    click.echo("")
+    click.echo("Fix:")
+    for line in err.fix:
+        click.echo(f"  {line}")
+
+
+def emit_and_exit(err: CliErrorV01, json_out: str | None) -> None:
+    """Emit error to human output, optional file, and stderr JSON."""
+    # Human-readable output (stdout)
+    print_human_error(err)
+
+    # Machine-readable JSON
+    payload = emit_cli_error(err)
+
+    # Optional file output
+    if json_out:
+        Path(json_out).write_text(payload, encoding="utf-8")
+        click.echo(f"\nJSON written to: {json_out}", err=True)
+
+    # Always emit JSON to stderr for machine capture
+    print(payload, file=sys.stderr)
+
+    raise SystemExit(1)
+
+
+@click.group()
+def main() -> None:
+    """Demo CLI for Ally integration.
+
+    Run any subcommand to see a structured error message.
+    Use --json-out to capture cli.error.v0.1 JSON.
+    """
+    pass
+
+
+@main.command()
+@click.option("--json-out", type=click.Path(dir_okay=False), help="Write JSON to file")
+def network_timeout(json_out: str | None) -> None:
+    """Simulate a network timeout error."""
+    err = CliErrorV01(
+        level="ERROR",
+        code="DEM001",
+        id="DEMO.NETWORK.TIMEOUT",
+        title="Request timed out",
+        what=["The HTTP request did not complete within 30 seconds."],
+        why=[
+            "The server did not respond before the timeout limit.",
+            "This may indicate network congestion or server overload.",
+        ],
+        fix=[
+            "Check your network connection.",
+            "Verify the server is reachable: ping api.example.com",
+            "Re-run with increased timeout: demo-cli network-timeout --timeout 60 --dry-run",
+        ],
+    )
+    emit_and_exit(err, json_out)
+
+
+@main.command()
+@click.option("--json-out", type=click.Path(dir_okay=False), help="Write JSON to file")
+def config_missing(json_out: str | None) -> None:
+    """Simulate a missing config file error."""
+    err = CliErrorV01(
+        level="ERROR",
+        code="DEM002",
+        id="DEMO.CONFIG.MISSING",
+        title="Config file not found",
+        what=["The configuration file 'config.json' was not found."],
+        why=[
+            "The tool requires a config file to know which project to use.",
+            "The file may have been deleted or never created.",
+        ],
+        fix=[
+            "Create config.json in the current directory.",
+            "Copy the template: cp config.example.json config.json",
+            "Re-run: demo-cli config-missing --dry-run",
+        ],
+    )
+    emit_and_exit(err, json_out)
+
+
+@main.command()
+@click.option("--json-out", type=click.Path(dir_okay=False), help="Write JSON to file")
+def auth_failed(json_out: str | None) -> None:
+    """Simulate an authentication failure."""
+    err = CliErrorV01(
+        level="ERROR",
+        code="DEM003",
+        id="DEMO.AUTH.INVALID_TOKEN",
+        title="Authentication failed",
+        what=["The API token was rejected by the server."],
+        why=[
+            "The token may have expired.",
+            "The token may lack required permissions.",
+        ],
+        fix=[
+            "Generate a new token at https://example.com/settings/tokens",
+            "Set the token: export DEMO_API_TOKEN=<new-token>",
+            "Re-run: demo-cli auth-failed --dry-run",
+        ],
+    )
+    emit_and_exit(err, json_out)
+
+
+@main.command()
+@click.option("--json-out", type=click.Path(dir_okay=False), help="Write JSON to file")
+def permission_denied(json_out: str | None) -> None:
+    """Simulate a file permission error."""
+    err = CliErrorV01(
+        level="ERROR",
+        code="DEM004",
+        id="DEMO.FS.PERMISSION_DENIED",
+        title="Permission denied",
+        what=["Cannot write to '/var/log/demo.log'."],
+        why=[
+            "The current user does not have write permission.",
+            "The directory may be owned by root.",
+        ],
+        fix=[
+            "Check permissions: ls -la /var/log/demo.log",
+            "Run with appropriate permissions or change the log path.",
+            "Re-run: demo-cli permission-denied --log-path ./demo.log --dry-run",
+        ],
+    )
+    emit_and_exit(err, json_out)
+
+
+@main.command()
+@click.option("--json-out", type=click.Path(dir_okay=False), help="Write JSON to file")
+def validation_error(json_out: str | None) -> None:
+    """Simulate a data validation error."""
+    err = CliErrorV01(
+        level="ERROR",
+        code="DEM005",
+        id="DEMO.VALIDATION.SCHEMA",
+        title="Schema validation failed",
+        what=[
+            "The input file 'data.json' does not match the expected schema.",
+            "Field 'email' is required but missing.",
+        ],
+        why=[
+            "The schema requires all user records to have an email field.",
+            "Record at index 3 is missing this field.",
+        ],
+        fix=[
+            "Add the missing 'email' field to record 3.",
+            "Validate locally: demo-cli validate data.json --dry-run",
+        ],
+    )
+    emit_and_exit(err, json_out)
+
+
+if __name__ == "__main__":
+    main()

ally_demo_python-0.1.0/demo_cli/errors.py

@@ -0,0 +1,52 @@
+"""cli.error.v0.1 schema helpers.
+
+This module provides a dataclass and helper for emitting valid cli.error.v0.1 JSON.
+Copy this pattern into your own CLIs.
+"""
+
+from dataclasses import asdict, dataclass
+import json
+import re
+
+
+@dataclass(frozen=True)
+class CliErrorV01:
+    """Ground truth error message following cli.error.v0.1 schema.
+
+    Attributes:
+        level: OK, WARN, or ERROR (required)
+        code: Error code matching pattern ^[A-Z][A-Z0-9]{1,3}[0-9]{3}$ (e.g., "DEM001")
+        id: Alternate dot-namespaced identifier (e.g., "DEMO.NETWORK.TIMEOUT")
+        title: Short human-readable summary
+        what: List of sentences describing what happened (required)
+        why: List of sentences explaining why it happened (required for ERROR)
+        fix: List of actionable steps (required for ERROR, include SAFE commands)
+    """
+
+    level: str
+    code: str
+    id: str
+    title: str
+    what: list[str]
+    why: list[str]
+    fix: list[str]
+
+    def __post_init__(self) -> None:
+        """Validate fields."""
+        if self.level not in ("OK", "WARN", "ERROR"):
+            raise ValueError(f"Invalid level: {self.level}")
+        # Code pattern: ^[A-Z][A-Z0-9]{1,3}[0-9]{3}$
+        if not re.match(r"^[A-Z][A-Z0-9]{1,3}[0-9]{3}$", self.code):
+            raise ValueError(f"Invalid code format: {self.code} (expected e.g., DEM001)")
+
+
+def emit_cli_error(err: CliErrorV01) -> str:
+    """Serialize a CliErrorV01 to JSON string.
+
+    Args:
+        err: The error to serialize.
+
+    Returns:
+        JSON string with 2-space indent.
+    """
+    return json.dumps(asdict(err), indent=2, ensure_ascii=False)

ally_demo_python-0.1.0/pyproject.toml

@@ -0,0 +1,56 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "ally-demo-python"
+version = "0.1.0"
+description = "Reference integration for Ally (a11y-assist, a11y-lint, a11y-ci)"
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.10"
+authors = [
+    {name = "mcp-tool-shop", email = "64996768+mcp-tool-shop@users.noreply.github.com"}
+]
+keywords = [
+    "a11y",
+    "accessibility",
+    "cli",
+    "demo",
+    "reference",
+    "ally",
+    "error-messages",
+    "assistive-technology",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Quality Assurance",
+]
+dependencies = [
+    "click>=8.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0",
+    "a11y-assist",
+    "a11y-lint",
+]
+
+[project.scripts]
+demo-cli = "demo_cli.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/mcp-tool-shop/ally-demo-python"
+Repository = "https://github.com/mcp-tool-shop/ally-demo-python"
+Issues = "https://github.com/mcp-tool-shop/ally-demo-python/issues"
+
+[tool.setuptools.packages.find]
+include = ["demo_cli*"]

ally_demo_python-0.1.0/setup.cfg

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

ally_demo_python-0.1.0/tests/test_errors.py

@@ -0,0 +1,137 @@
+"""Tests for cli.error.v0.1 emission."""
+
+import json
+
+import pytest
+
+from demo_cli.errors import CliErrorV01, emit_cli_error
+
+
+def test_cli_error_v01_valid():
+    """Valid CliErrorV01 should serialize correctly."""
+    err = CliErrorV01(
+        level="ERROR",
+        code="TST001",
+        id="TEST.ERROR.001",
+        title="Test error",
+        what=["Something happened."],
+        why=["Because of reasons."],
+        fix=["Do this.", "Re-run: test --dry-run"],
+    )
+    payload = emit_cli_error(err)
+    parsed = json.loads(payload)
+
+    assert parsed["level"] == "ERROR"
+    assert parsed["code"] == "TST001"
+    assert parsed["id"] == "TEST.ERROR.001"
+    assert parsed["title"] == "Test error"
+    assert len(parsed["what"]) == 1
+    assert len(parsed["why"]) == 1
+    assert len(parsed["fix"]) == 2
+
+
+def test_cli_error_v01_invalid_level():
+    """Invalid level should raise ValueError."""
+    with pytest.raises(ValueError, match="Invalid level"):
+        CliErrorV01(
+            level="FAILURE",
+            code="TST001",
+            id="TEST.001",
+            title="Test",
+            what=["X"],
+            why=["Y"],
+            fix=["Z"],
+        )
+
+
+def test_cli_error_v01_invalid_code_format():
+    """Invalid code format should raise ValueError."""
+    with pytest.raises(ValueError, match="Invalid code format"):
+        CliErrorV01(
+            level="ERROR",
+            code="invalid",
+            id="TEST.001",
+            title="Test",
+            what=["X"],
+            why=["Y"],
+            fix=["Z"],
+        )
+
+
+def test_cli_error_v01_valid_code_patterns():
+    """Various valid code patterns should work."""
+    # Short code: AB001 (2 chars + 3 digits)
+    err1 = CliErrorV01(
+        level="ERROR",
+        code="AB001",
+        id="TEST.001",
+        title="Test",
+        what=["X"],
+        why=["Y"],
+        fix=["Z"],
+    )
+    assert err1.code == "AB001"
+
+    # Long code: DEMO001 (4 chars + 3 digits)
+    err2 = CliErrorV01(
+        level="ERROR",
+        code="DEMO001",
+        id="TEST.001",
+        title="Test",
+        what=["X"],
+        why=["Y"],
+        fix=["Z"],
+    )
+    assert err2.code == "DEMO001"
+
+    # Medium code: DEM001 (3 chars + 3 digits)
+    err3 = CliErrorV01(
+        level="ERROR",
+        code="DEM001",
+        id="TEST.001",
+        title="Test",
+        what=["X"],
+        why=["Y"],
+        fix=["Z"],
+    )
+    assert err3.code == "DEM001"
+
+
+def test_emit_cli_error_json_format():
+    """Emitted JSON should be properly formatted."""
+    err = CliErrorV01(
+        level="WARN",
+        code="TST002",
+        id="TEST.WARN.001",
+        title="Warning",
+        what=["Minor issue."],
+        why=["Expected behavior."],
+        fix=["No action needed."],
+    )
+    payload = emit_cli_error(err)
+
+    # Should be valid JSON
+    parsed = json.loads(payload)
+    assert parsed["level"] == "WARN"
+
+    # Should have indentation (pretty-printed)
+    assert "\n" in payload
+    assert "  " in payload
+
+
+def test_emit_cli_error_unicode():
+    """Emitted JSON should handle unicode correctly."""
+    err = CliErrorV01(
+        level="ERROR",
+        code="TST003",
+        id="TEST.UNICODE.001",
+        title="Unicode test: \u2713 \u2717",
+        what=["Contains unicode: \u00e9\u00e8\u00ea"],
+        why=["Multi-language support."],
+        fix=["No changes needed."],
+    )
+    payload = emit_cli_error(err)
+    parsed = json.loads(payload)
+
+    assert "\u2713" in parsed["title"]
+    assert "\u00e9" in parsed["what"][0]