Add purpose and demand model extension

src/info_tech_canon/generation.py

@@ -9,7 +9,17 @@ import yaml
 
 
 GENERATED_NOTICE = "<!-- GENERATED by info_tech_canon; do not edit by hand. -->"
-RETRIEVAL_ARTIFACT_KINDS = {"kernel", "model", "standard", "profile"}
+RETRIEVAL_ARTIFACT_KINDS = {
+    "concept-catalog",
+    "example",
+    "kernel",
+    "mapping",
+    "model",
+    "model-extension",
+    "pattern",
+    "profile",
+    "standard",
+}
 CONSUMER_BRIEF_IDS = ("user-engine", "railiance-fabric", "repo-scoping")
 COMMON_DISTINCTIONS = [
     {
@@ -45,10 +55,11 @@ COMMON_DISTINCTIONS = [
     {
         "id": "intent-scope-purpose",
         "title": "Intent vs Scope vs Purpose",
-        "summary": "Intent captures why an actor wants something, scope bounds what is included, and purpose captures consumer demand or use case pressure on the repo.",
+        "summary": "Intent captures why a producer or consumer exists, scope bounds producer ownership and promises, and purpose captures consumer demand anchored in consumer intent.",
         "source_artifacts": [
             "kernel/itc-core",
-            "model/governance",
+            "model/purpose-demand-extension",
+            "pattern/intent-scope-purposes",
             "profile/small-saas",
         ],
     },
@@ -634,7 +645,14 @@ def interface_card_template() -> dict[str, Any]:
             "owner": "",
             "intent": "",
             "scope": "",
-            "purposes": [],
+            "purposes": [
+                {
+                    "id": "",
+                    "use_case": "",
+                    "consumer_need": "",
+                    "demand_signals": [],
+                }
+            ],
         },
         "canon_surfaces": {
             "implemented_profiles": [],
@@ -649,6 +667,12 @@ def interface_card_template() -> dict[str, Any]:
             "evidence_required": [],
             "known_gaps": [],
         },
+        "purpose_fit": {
+            "state": "",
+            "matched_capabilities": [],
+            "scope_pressure": "",
+            "recommended_disposition": "",
+        },
         "consumer_needs": {
             "current": [],
             "requested_extensions": [],
@@ -674,6 +698,8 @@ def _render_consumer_brief_template() -> str:
         "- Intent:",
         "- Scope:",
         "- Purposes:",
+        "- Use cases:",
+        "- Demand signals:",
         "",
         "## Canon Surfaces",
         "",
@@ -687,6 +713,13 @@ def _render_consumer_brief_template() -> str:
         "- Commands:",
         "- Evidence:",
         "- Known gaps:",
+        "",
+        "## Purpose Fit",
+        "",
+        "- State:",
+        "- Matched producer capabilities:",
+        "- Scope pressure:",
+        "- Requested evolution:",
     ]
     return "\n".join(lines).rstrip() + "\n"
 
@@ -721,6 +754,9 @@ def _render_consumer_brief(consumer_id: str) -> str:
         "",
         "- `agent/retrieval-index.md`",
         "- `agent/templates/canon-interface-card.template.yaml`",
+        "- `models/governance/InfoTechCanonPurposeDemandExtension.md`",
+        "- `patterns/intent-scope-purposes.md`",
+        "- `examples/consumer-purpose-portfolio.yaml`",
         "- `profiles/small-saas/profile.yaml`",
         "- `views/by-concept.md`",
         "",
@@ -788,6 +824,16 @@ def _safe_id(value: str) -> str:
 def _summary_for_artifact(artifact: Any) -> str:
     if artifact.kind == "profile-artifact":
         return f"Example artifact for the {artifact.provenance.get('profile', 'unknown')} profile: {artifact.title}."
+    if artifact.kind == "concept-catalog":
+        return f"Structured candidate concept catalog: {artifact.title}."
+    if artifact.kind == "example":
+        return f"Canon-side example artifact: {artifact.title}."
+    if artifact.kind == "mapping":
+        return f"Mapping artifact connecting canon surfaces: {artifact.title}."
+    if artifact.kind == "model-extension":
+        return f"Candidate extension to an existing canon model: {artifact.title}."
+    if artifact.kind == "pattern":
+        return f"Reusable canon pattern: {artifact.title}."
     if artifact.kind == "profile":
         return f"Profile that constrains canon artifacts for a practical implementation slice: {artifact.title}."
     if artifact.kind == "kernel":