ddr-docs 0.2.1

CLI-first FileMaker DDR extraction and analysis toolkit

FM2WEB_CLI

Standalone CLI-first extraction of the ddr-docs toolkit from the broader FM2Web repo.

This repo is meant to be the first private-repo candidate Marcus can own separately. It keeps the Python CLI, extraction pipeline, SQLite ingestion, and analyzer-backed analysis flows. It intentionally drops the desktop/Tauri app, Streamlit UI, and other non-CLI project baggage.

What this repo includes

• ddr_docs/, the CLI and DDR extraction pipeline
• analyzer/, the SQLite-backed ingestion and analysis services used by CLI analysis commands
• scripts/, extractor and rendering scripts invoked by the pipeline
• tests/, CLI, extractor, ingestion, pipeline, and smoke tests
• docs/, architecture and schema notes still relevant to the CLI/analyzer workflow

What this repo intentionally excludes

• desktop/Tauri app code
• Streamlit UI
• export2web prompt packs and workflow assets
• playgrounds, bundled build artifacts, temp outputs, and egg metadata
• analyzer API server and DAG workflow runtime from the original monorepo

Package identity

• Repository name: FM2WEB_CLI
• Python package name: ddr-docs
• Console command: ddr-docs

Keeping the package name avoids unnecessary churn for the CLI while making the repo identity clearly standalone.

Install

From a local checkout

python -m pip install -e .
# or with analyzer extras
python -m pip install -e '.[analyzer,dev]'

Quick start

Generate extracted docs from a DDR XML file

ddr-docs generate /path/to/file.ddr.xml -o ./out/ddr-run

Run the full analyzer-backed flow

ddr-docs analyze full-analysis \
  --input /path/to/file.ddr.xml \
  --output-dir ./out/full-analysis \
  --sqlite-path ./out/full-analysis/fm2web.sqlite3

Common commands

ddr-docs --help
ddr-docs generate --help
ddr-docs analyze --help
ddr-docs analyze full-analysis --help

Development

Run a focused validation pass:

python -m pytest \
  tests/test_cli_full_analysis.py \
  tests/test_cli_optional_deps.py \
  tests/test_pipeline.py \
  tests/test_ingestion_idempotency.py \
  tests/test_ingestion_offline_policy.py \
  tests/test_smoke.py

Build package artifacts:

python -m build

Notes on extraction scope

This repo was extracted from FM2Web as a practical first standalone candidate, not a full architectural rewrite. A few internals still reflect the original FM2Web naming and workspace assumptions.

The biggest known coupling is that the pipeline still depends on top-level scripts/ helpers at runtime, so source-checkout usage is the most trustworthy path for now.

License

MIT