feat(convert): add task 05 sqlite converter with variant B keys" -m "- convert: convert_sqlite.py builds tribo.db (composite PKs, enforced FKs, Q1-Q7 indexes, track_summary)

- tools: common/track_summary.py fixes the cross-engine steady-state algorithm
- rules: db-sql-schema records the FK enforcement decision and track_summary definition
- specs: 05 aligned with data-naming-units, simtra_profiles added
- docs: FK key-schema study added under docs/research/, README updated
- replace manual CSV reading with CorpusReader for better data handling
- streamline argument parsing and dependency checks using common pipeline functions
- enhance marker writing for task completion tracking
- remove unused regex and validation error classes for cleaner code

make_process_flow.py

@@ -8,16 +8,20 @@ the laboratory workflow: ./out/report/process_flow.md plus one standalone
 
 from __future__ import annotations
 
-import argparse
 import logging
 import sys
 from pathlib import Path
 
-import yaml
+from common.pipeline import (
+	check_dependencies,
+	load_lab_config,
+	parse_task_args,
+	remove_stale_marker,
+	write_marker,
+)
 
 logger = logging.getLogger(__name__)
 
-REPO_ROOT = Path(__file__).resolve().parent
 TASK_ID = "02"
 DEPENDS_ON = ["01"]
 
@@ -190,13 +194,6 @@ def build_diagrams(cfg: dict) -> list[tuple[str, str, str, str]]:
 	]
 
 
-def check_dependencies(out_root: Path) -> None:
-	for dep in DEPENDS_ON:
-		marker = out_root / ".done" / f"{dep}.ok"
-		if not marker.exists():
-			raise FileNotFoundError(f"dependency marker missing: {marker} - run task {dep} first")
-
-
 def validate_diagram(stem: str, text: str) -> None:
 	first = text.splitlines()[0].strip() if text.strip() else ""
 	if not first.startswith(DIAGRAM_TYPES):
@@ -235,42 +232,20 @@ def write_outputs(cfg: dict, out_root: Path) -> tuple[Path, int, int]:
 	return md_path, len(md_text.encode("utf-8")), total_diagram_bytes
 
 
-def write_marker(marker_path: Path, md_path: Path, md_bytes: int, diagram_bytes: int) -> None:
-	lines = [
-		f"task: '{TASK_ID}'",
-		"status: ok",
-		f"process_flow_file: {md_path.as_posix()}",
-		f"process_flow_bytes: {md_bytes}",
-		"diagrams: 6",
-		f"diagram_bytes: {diagram_bytes}",
-	]
-	marker_path.parent.mkdir(parents=True, exist_ok=True)
-	with open(marker_path, "w", encoding="utf-8", newline="\n") as fh:
-		fh.write("\n".join(lines) + "\n")
-
-
 def main() -> int:
-	parser = argparse.ArgumentParser(description="Task 02: write process flow diagrams")
-	parser.add_argument("--log-level", default="INFO", choices=["DEBUG", "INFO", "WARNING", "ERROR"])
-	parser.add_argument("--out-root", type=Path, default=REPO_ROOT / "out", help="artifact tree root (default: ./out)")
-	args = parser.parse_args()
-	logging.basicConfig(
-		level=args.log_level,
-		stream=sys.stderr,
-		format="%(asctime)s %(levelname)-7s %(name)s: %(message)s",
-	)
-
+	args = parse_task_args("Task 02: write process flow diagrams")
 	out_root: Path = args.out_root
-	marker_path = out_root / ".done" / f"{TASK_ID}.ok"
 	try:
-		check_dependencies(out_root)
-		if marker_path.exists():
-			logger.info("re-run: removing stale marker %s", marker_path)
-			marker_path.unlink()
-		with open(out_root / "config" / "lab_config.yaml", encoding="utf-8") as fh:
-			cfg = yaml.safe_load(fh)
+		check_dependencies(out_root, DEPENDS_ON)
+		remove_stale_marker(out_root, TASK_ID)
+		cfg = load_lab_config(out_root)
 		md_path, md_bytes, diagram_bytes = write_outputs(cfg, out_root)
-		write_marker(marker_path, md_path, md_bytes, diagram_bytes)
+		marker_path = write_marker(out_root, TASK_ID, {
+			"process_flow_file": md_path.as_posix(),
+			"process_flow_bytes": md_bytes,
+			"diagrams": 6,
+			"diagram_bytes": diagram_bytes,
+		})
 	except Exception:
 		logger.critical("task %s failed", TASK_ID, exc_info=True)
 		return 1