tac-validate 0.1.0__tar.gz

tac_validate-0.1.0/.gitignore

@@ -0,0 +1,188 @@
+# =============================================================================
+# METAR → IWXXM monorepo — apps/, packages/, vendor/
+# =============================================================================
+
+# --- Secrets & local operator env (never commit) ---
+.env
+.env.*
+!.env.example
+prod.env
+.envrc
+
+# Per-workspace env overrides (apps/* and packages/*)
+apps/**/.env
+apps/**/.env.*
+!apps/**/.env.example
+packages/**/.env
+packages/**/.env.*
+!packages/**/.env.example
+
+# Legacy env paths (pre-migration; remove after cutover)
+backend/.env
+auth/.env
+frontend/.env
+
+# --- Python (uv workspace: apps/backend, packages/*) ---
+__pycache__/
+*.py[codz]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+*.manifest
+*.spec
+pip-log.txt
+pip-delete-this-directory.txt
+__pypackages__/
+*.sage.py
+.venv/
+venv/
+env/
+ENV/
+env.bak/
+venv.bak/
+.pdm-python
+.pdm-build/
+.pixi
+
+# --- Node / pnpm workspace (apps/*, packages/*) ---
+**/node_modules/
+.pnp
+.pnp.js
+.pnpm-store/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+.eslintcache
+*.tsbuildinfo
+
+# --- Build & bundle outputs ---
+**/dist/
+**/dist-ssr/
+**/build/
+**/.vite/
+**/.turbo/
+**/.next/
+**/.nuxt/
+**/.output/
+**/.svelte-kit/
+
+# --- Test & coverage ---
+.tox/
+.nox/
+.coverage
+.coverage.*
+.coverage-baseline.json
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py.cover
+htmlcov/
+htmlcov_ann/
+cover/
+.hypothesis/
+.pytest_cache/
+.nyc_output
+**/coverage/
+
+# Playwright (apps/e2e and legacy frontend/)
+**/test-results/
+**/playwright-report/
+**/blob-report/
+**/.playwright/
+**/playwright/.cache/
+
+# --- Typecheck & lint caches ---
+.mypy_cache/
+.dmypy.json
+dmypy.json
+.pyre/
+.pytype/
+.ruff_cache/
+cython_debug/
+
+# --- IDE & OS ---
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+Thumbs.db
+
+# --- Docs site builds ---
+docs/_build/
+/site
+
+# --- Local tooling binaries / artifacts ---
+.tools/
+.local/
+
+# --- Cursor (local indexing prefs only; .cursorignore is tracked) ---
+.cursorindexingignore
+
+# --- Misc generated ---
+*.log
+*.db
+*.local
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+instance/
+.webassets-cache
+.scrapy
+.ipynb_checkpoints
+profile_default/
+ipython_config.py
+celerybeat-schedule
+celerybeat.pid
+.abstra/
+.pypirc
+marimo/_static/
+marimo/_lsp/
+__marimo__/
+
+# --- Legacy submodule / pre-migration paths (remove after M7 cutover) ---
+# Vendor snapshots live under vendor/schemas/ once migrated (tracked, not ignored).
+GIFTs/.venv/
+GIFTs/.gifts/
+GIFTs/build/
+GIFTs/dist/
+GIFTs/data/
+GIFTs/.coverage
+GIFTs/.pytest_cache/
+GIFTs/.mypy_cache/
+GIFTs/sfstns.db
+GIFTs/driver.py
+GIFTs/wiki/
+
+# --- Rust / maturin (tac2iwxxm / iwxxm-validate PyO3) ---
+packages/tac2iwxxm/rust/target/
+packages/iwxxm-validate/rust/target/
+
+# E10-34 — synced runtime schema subset (generated; MANIFEST.json is tracked)
+packages/iwxxm-validate/src/iwxxm_validate/schemas/iwxxm/
+packages/iwxxm-validate/src/iwxxm_validate/schemas/iwxxm-us/
+packages/iwxxm-validate/src/iwxxm_validate/schemas/LAST_SYNC.json
+
+# ADR-027 — xsdata pydantic trees are committed (T3.7); ignore only bytecode
+packages/shared/src/metar_shared/iwxxm_xsd/**/__pycache__/
+

tac_validate-0.1.0/PKG-INFO

@@ -0,0 +1,47 @@
+Metadata-Version: 2.4
+Name: tac-validate
+Version: 0.1.0
+Summary: TAC parse gate and business-rule pack (F6 lint)
+License: MIT
+Requires-Python: >=3.12
+Requires-Dist: msgspec>=0.19
+Description-Content-Type: text/markdown
+
+# tac-validate
+
+TAC parse gate and shared business-rule pack for F6 products. MIT licensed.
+
+## Install
+
+```bash
+pip install tac-validate==0.1.0
+# or from the monorepo workspace:
+uv sync --package tac-validate
+```
+
+## Library
+
+```python
+from tac_validate import lint
+
+report = lint("METAR KJFK ...=", product="METAR")
+if not report.ok:
+    for issue in report.issues:
+        print(issue.code, issue.message)
+    for fix in report.fixes:
+        print(fix.code, fix.replacement)
+```
+
+## CLI
+
+```bash
+tac-validate --product METAR path/to/report.tac
+tac-validate --product METAR --json path/to/report.tac
+```
+
+Exit code `0` when lint `ok`; `1` when error-severity issues are present (or the file cannot be read).
+
+Rule depth (E10-21): METAR/SPECI/TAF full checklist; SIGMET/AIRMET/VAA/TCA template+gates.
+Citations live in `docs/domain/TAC_VALIDATION.md` — no Annex prose in the wheel.
+
+See ADR-015 / ADR-016. No FastAPI/Supabase imports; HTTP maps msgspec → pydantic.

tac_validate-0.1.0/README.md

@@ -0,0 +1,38 @@
+# tac-validate
+
+TAC parse gate and shared business-rule pack for F6 products. MIT licensed.
+
+## Install
+
+```bash
+pip install tac-validate==0.1.0
+# or from the monorepo workspace:
+uv sync --package tac-validate
+```
+
+## Library
+
+```python
+from tac_validate import lint
+
+report = lint("METAR KJFK ...=", product="METAR")
+if not report.ok:
+    for issue in report.issues:
+        print(issue.code, issue.message)
+    for fix in report.fixes:
+        print(fix.code, fix.replacement)
+```
+
+## CLI
+
+```bash
+tac-validate --product METAR path/to/report.tac
+tac-validate --product METAR --json path/to/report.tac
+```
+
+Exit code `0` when lint `ok`; `1` when error-severity issues are present (or the file cannot be read).
+
+Rule depth (E10-21): METAR/SPECI/TAF full checklist; SIGMET/AIRMET/VAA/TCA template+gates.
+Citations live in `docs/domain/TAC_VALIDATION.md` — no Annex prose in the wheel.
+
+See ADR-015 / ADR-016. No FastAPI/Supabase imports; HTTP maps msgspec → pydantic.

tac_validate-0.1.0/pyproject.toml

@@ -0,0 +1,42 @@
+[project]
+name = "tac-validate"
+version = "0.1.0"
+description = "TAC parse gate and business-rule pack (F6 lint)"
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.12"
+dependencies = [
+  "msgspec>=0.19",
+]
+
+[project.scripts]
+tac-validate = "tac_validate.cli:main"
+
+[build-system]
+requires = ["hatchling>=1.25"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/tac_validate"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]
+markers = [
+  "slow: longer local/CI smokes (clean-venv wheel installs)",
+]
+
+[tool.coverage.run]
+branch = true
+source = ["src/tac_validate"]
+
+[tool.coverage.report]
+fail_under = 95
+show_missing = true
+
+[tool.ruff]
+line-length = 120
+
+[tool.ruff.lint]
+select = ["E", "W", "F", "I"]
+ignore = ["E501"]

tac_validate-0.1.0/src/tac_validate/__init__.py

@@ -0,0 +1,11 @@
+"""TAC parse gate and business-rule pack (F6 lint)."""
+
+from __future__ import annotations
+
+from tac_validate.api import lint
+from tac_validate.models import Fix, Issue, LintReport
+from tac_validate.products import PRODUCTS
+
+__version__ = "0.1.0"
+
+__all__ = ["PRODUCTS", "Fix", "Issue", "LintReport", "__version__", "lint"]

tac_validate-0.1.0/src/tac_validate/api.py

@@ -0,0 +1,35 @@
+"""Public ``lint()`` entrypoint for TAC parse gate + rule pack."""
+
+from __future__ import annotations
+
+from tac_validate.models import LintReport
+from tac_validate.products import PRODUCTS
+from tac_validate.rules import check_parse_gate, check_product_rules
+
+
+def lint(tac_text: str, *, product: str = "METAR") -> LintReport:
+    """
+    Lint TAC text for ``product`` using the shared rule-pack skeleton.
+
+    Parameters
+    ----------
+    tac_text :
+        TAC report or fragment.
+    product :
+        One of AIRMET, METAR, SIGMET, SPECI, TAF, VAA, TCA.
+
+    Returns
+    -------
+    LintReport
+        ``ok`` is ``False`` when any error-severity issue is present.
+        Optional ``fixes`` may suggest repairs (Q9=C).
+    """
+    issues, fixes = check_parse_gate(tac_text, product)
+    if not any(i.severity == "error" for i in issues):
+        issues.extend(check_product_rules(tac_text, product))
+
+    ok = not any(i.severity == "error" for i in issues)
+    return LintReport(ok=ok, product=product, issues=issues, fixes=fixes)
+
+
+__all__ = ["PRODUCTS", "lint"]

tac_validate-0.1.0/src/tac_validate/cli.py

@@ -0,0 +1,79 @@
+"""Command-line interface for ``tac-validate`` (F12)."""
+
+from __future__ import annotations
+
+import argparse
+import sys
+from pathlib import Path
+from typing import Sequence
+
+from tac_validate.api import lint
+from tac_validate.codec import json_encoder
+from tac_validate.products import PRODUCTS
+
+
+def _build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(
+        prog="tac-validate",
+        description="Lint TAC text for F6 products (parse-gate + checklist/template gates).",
+    )
+    parser.add_argument(
+        "path",
+        type=Path,
+        help="Path to a TAC text file",
+    )
+    parser.add_argument(
+        "--product",
+        required=True,
+        choices=list(PRODUCTS),
+        help="F6 product id",
+    )
+    parser.add_argument(
+        "--json",
+        action="store_true",
+        help="Emit LintReport as JSON on stdout",
+    )
+    return parser
+
+
+def main(argv: Sequence[str] | None = None) -> int:
+    """
+    Run ``tac-validate`` CLI.
+
+    Parameters
+    ----------
+    argv :
+        Argument vector (defaults to ``sys.argv[1:]``).
+
+    Returns
+    -------
+    int
+        ``0`` when ``report.ok``; ``1`` on lint errors or I/O failure.
+    """
+    parser = _build_parser()
+    args = parser.parse_args(list(argv) if argv is not None else None)
+    path: Path = args.path
+    try:
+        text = path.read_text(encoding="utf-8")
+    except OSError as exc:
+        print(f"error: cannot read {path}: {exc}", file=sys.stderr)
+        return 1
+
+    report = lint(text, product=args.product)
+    if args.json:
+        sys.stdout.write(json_encoder.encode(report).decode("utf-8"))
+        sys.stdout.write("\n")
+    else:
+        status = "ok" if report.ok else "fail"
+        print(f"{status} product={report.product} issues={len(report.issues)}")
+        for issue in report.issues:
+            span = ""
+            if issue.start is not None and issue.end is not None:
+                span = f" [{issue.start}:{issue.end}]"
+            print(f"  {issue.severity}:{issue.code}{span} {issue.message}")
+
+    return 0 if report.ok else 1
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

tac_validate-0.1.0/src/tac_validate/codec.py

@@ -0,0 +1,12 @@
+"""Reusable msgspec JSON codec for LintReport (ADR-016)."""
+
+from __future__ import annotations
+
+import msgspec
+
+from tac_validate.models import LintReport
+
+json_encoder = msgspec.json.Encoder()
+json_decoder = msgspec.json.Decoder(LintReport)
+
+__all__ = ["json_decoder", "json_encoder"]

tac_validate-0.1.0/src/tac_validate/models.py

@@ -0,0 +1,77 @@
+"""msgspec models for TAC lint issues and fixes (ADR-016 / Q9=C)."""
+
+from __future__ import annotations
+
+import msgspec
+
+
+class Issue(msgspec.Struct, frozen=True):
+    """
+    Structured TAC lint finding.
+
+    Parameters
+    ----------
+    severity :
+        ``error``, ``warning``, or ``info``.
+    code :
+        Machine-readable rule id.
+    message :
+        Human-readable description.
+    location :
+        Optional token / field hint (e.g. ``wind``).
+    start :
+        Optional inclusive character offset into the TAC string.
+    end :
+        Optional exclusive character offset into the TAC string.
+    """
+
+    severity: str
+    code: str
+    message: str
+    location: str | None = None
+    start: int | None = None
+    end: int | None = None
+
+
+class Fix(msgspec.Struct, frozen=True):
+    """
+    Optional repair suggestion for a lint finding.
+
+    Parameters
+    ----------
+    code :
+        Fix identifier (e.g. ``add_terminator``).
+    message :
+        Human-readable description.
+    replacement :
+        Suggested replacement fragment or full TAC.
+    """
+
+    code: str
+    message: str
+    replacement: str
+
+
+class LintReport(msgspec.Struct, frozen=True):
+    """
+    Result of ``lint()``.
+
+    Parameters
+    ----------
+    ok :
+        ``True`` when no error-severity issues.
+    product :
+        Product id used for rule selection.
+    issues :
+        Structured findings.
+    fixes :
+        Optional repair suggestions.
+    """
+
+    ok: bool
+    product: str
+    issues: list[Issue]
+    fixes: list[Fix] = msgspec.field(default_factory=list)
+
+
+__all__ = ["Fix", "Issue", "LintReport"]