improve: expose package API and tighten CLI help

[Coding-Dev-Tools]

Automated improvement by dev-engineer

[github-actions]

🤖 Automated Code Review

⚠️ Ruff Lint — 1 issue(s)

::error title=ruff (I001),file=/home/runner/work/datamorph/datamorph/src/datamorph/__init__.py,line=2,endLine=11::src/datamorph/__init__.py:2:1: I001 Import block is un-sorted or un-formatted%0A  help: Organize imports

⚠️ Ruff Format — Formatting needed

Would reformat: conftest.py
Would reformat: src/datamorph/__init__.py
Would reformat: src/datamorph/__main__.py
Would reformat: src/datamorph/cli.py
Would reformat: src/datamorph/converters.py
Would reformat: tests/test_converters.py
Would reformat: tests/test_edge_cases.py
Would reformat: tests/test_validate.py
8 files would be reformatted, 1 file already formatted

🔴 Secret Detection — 1 potential secret(s)

  .ruff_cache/CACHEDIR.TAG:1 — Hex High Entropy String

✅ Large Files — Within limits

📊 Diff Stats — 12 file(s) changed

 .github/workflows/publish.yml            |  19 ++--
 AGENTS.md                                |  29 ++++++
 README.md                                |  15 ++--
 pyproject.toml                           |  11 +--
 references/ops-heartbeat-observations.md |  18 ----
 src/datamorph/__init__.py                |  24 ++++-
 src/datamorph/__main__.py                |   4 -
 src/datamorph/cli.py                     |  10 +--
 src/datamorph/converters.py              |  10 +--
 src/datamorph/py.typed                   |   0
 tests/test_cli_error_paths.py            |  29 ------
 tests/test_edge_cases.py                 | 147 -------------------------------
 12 files changed, 76 insertions(+), 240 deletions(-)

---

Verdict: 🔴 Changes Requested — Potential secrets detected. Do not merge.

Automated by Coding-Dev-Tools/.github reusable workflow.