fix: python 3.12+

Author: davidlee

.spec-driver/memory/mem.concept.spec-driver.requirement-lifecycle.md

@@ -4,8 +4,8 @@ name: Requirement Lifecycle Guidance
 kind: memory
 status: active
 memory_type: concept
-updated: "2026-03-05"
-verified: "2026-03-05"
+updated: "2026-03-18"
+verified: "2026-03-18"
 tags: [spec-driver, lifecycle, requirements, coverage]
 summary: "Agent-facing model for requirement lifecycle, coverage statuses, and traceability grounded in current implementation."
 scope:
@@ -39,6 +39,21 @@ provenance:
 - Coverage status and requirement status are distinct enums; do not mix them.
 - See `supekku/about/lifecycle.md` for code-truth details.
 
+## Recognised Requirement Syntax
+
+Sync extracts requirements from spec body lines matching these formats:
+
+- **Bullet (primary):** `- **FR-001**: Title` or `- **SPEC-100.FR-001**: Title`
+- **Heading (backlog dotted):** `### FR-016.001: Title`
+
+The label inside `**bold**` must be bare — ID only, no description or em-dash
+title. For example, `**FR-001 — Workspace resolution**:` will **not** match.
+
+Optional inline category and tags are supported after the label:
+`- **FR-001**(category)[tag1, tag2]: Title`
+
+The separator after the label/bold may be `:`, `-`, `–`, or `—`.
+
 ## Canonical Status Sets
 
 - Requirement lifecycle: `pending`, `in-progress`, `active`, `retired`.

VERSION

@@ -1 +1 @@
-0.8.0
+0.8.1

pyproject.toml

@@ -8,7 +8,7 @@ authors = [
 readme = "README.md"
 long_description_content_type = "text/markdown"
 license = { text = "MIT" }
-requires-python = ">=3.10"
+requires-python = ">=3.12"
 dependencies = [
     "jinja2>=3.1.0",
     "pyyaml>=6.0.3",

supekku/scripts/lib/requirements/registry.py

@@ -541,7 +541,9 @@ def _validate_extraction(
       if len(extracted) == 0:
         print(
           f"WARNING: Spec {spec.id} ({spec.kind}) has 0 extracted requirements. "
-          f"Check requirement format in {spec.path.name}",
+          f"Expected format: '- **FR-001**: Title' or '- **SPEC-100.FR-001**: Title' "
+          f"(label inside **bold** must be bare — no description). "
+          f"Check {spec.path.name}",
           file=sys.stderr,
         )
         logger.warning(
@@ -1254,7 +1256,9 @@ def _records_from_content(
     if requirement_like_lines and extracted_count == 0:
       logger.warning(
         "Spec %s at %s: Found %d requirement-like lines but extracted 0. "
-        "First line: %s",
+        "Expected format: '- **FR-001**: Title' or '- **SPEC-100.FR-001**: Title'. "
+        "The label inside **bold** must be bare (no description). "
+        "First unmatched line: %s",
         spec_id,
         spec_path.name,
         len(requirement_like_lines),