chore: sync template lineage support

Author: codegraphtheory

.github/template-source.yml

@@ -1,7 +1,7 @@
 template:
   name: codegraphtheory/hermes-profile-template
   url: https://github.com/codegraphtheory/hermes-profile-template
-  commit: e731d0e
+  commit: d0a6aa4
   relationship: rebuilt-from-template
 notes:
   - ChainForge preserves its original git history.

distribution.yaml

@@ -8,7 +8,7 @@ license: MIT
 template_source:
   name: codegraphtheory/hermes-profile-template
   url: https://github.com/codegraphtheory/hermes-profile-template
-  commit: e731d0e
+  commit: d0a6aa4
   relationship: rebuilt-from-template
 env_requires:
 - name: OPENROUTER_API_KEY

scripts/generate_profile.py

@@ -62,27 +62,36 @@ def render_distribution(params: dict[str, Any], slug: str, description: str) ->
     env_requires = params.get("env_requires") or []
     if not isinstance(env_requires, list):
         raise ValueError("env_requires must be a list")
-    manifest = {
+    manifest: dict[str, Any] = {
         "name": slug,
         "version": str(params.get("version") or "0.1.0"),
         "description": description,
         "hermes_requires": str(params.get("hermes_requires") or ">=0.12.0"),
         "author": str(params.get("author") or "Hermes profile author"),
         "license": str(params.get("license") or "MIT"),
-        "env_requires": env_requires,
-        "distribution_owned": [
-            "SOUL.md",
-            "config.yaml",
-            "mcp.json",
-            "skills/",
-            "templates/",
-            "scripts/",
-            "distribution.yaml",
-            "README.md",
-            "AGENTS.md",
-            ".env.EXAMPLE",
-        ],
     }
+    template_source = params.get("template_source")
+    if template_source:
+        if not isinstance(template_source, dict):
+            raise ValueError("template_source must be a mapping")
+        manifest["template_source"] = template_source
+    manifest.update(
+        {
+            "env_requires": env_requires,
+            "distribution_owned": [
+                "SOUL.md",
+                "config.yaml",
+                "mcp.json",
+                "skills/",
+                "templates/",
+                "scripts/",
+                "distribution.yaml",
+                "README.md",
+                "AGENTS.md",
+                ".env.EXAMPLE",
+            ],
+        }
+    )
     return yaml.safe_dump(manifest, sort_keys=False, default_flow_style=False)
 
 
@@ -127,7 +136,6 @@ def render_config(params: dict[str, Any]) -> str:
             "memory": {"memory_enabled": True, "user_profile_enabled": True},
             "security": {"redact_secrets": True},
             "approvals": {"mode": "manual"},
-            "toolsets": toolsets,
         },
         sort_keys=False,
     )
@@ -229,10 +237,16 @@ def render_agents(display_name: str) -> str:
 
 
 def render_readme(params: dict[str, Any], slug: str, display_name: str, description: str) -> str:
+    template_source = params.get("template_source")
+    lineage = ""
+    if isinstance(template_source, dict) and template_source.get("url"):
+        template_name = str(template_source.get("name") or "profile template")
+        template_url = str(template_source["url"])
+        lineage = f"\nTemplate lineage: built from [{template_name}]({template_url}).\n"
     return f"""# {display_name}
 
 {description}
-
+{lineage}
 This is a Hermes Agent profile distribution. It can be installed with `hermes profile install` and updated from git.
 
 ## Install
@@ -274,6 +288,22 @@ def render_readme(params: dict[str, Any], slug: str, display_name: str, descript
 """
 
 
+def render_template_source_file(params: dict[str, Any]) -> str | None:
+    template_source = params.get("template_source")
+    if not template_source:
+        return None
+    if not isinstance(template_source, dict):
+        raise ValueError("template_source must be a mapping")
+    data = {
+        "template": template_source,
+        "notes": [
+            "GitHub native generated-from-template linkage is only available when a repository is created through GitHub's template flow.",
+            "This file records template lineage explicitly for humans and automation.",
+        ],
+    }
+    return yaml.safe_dump(data, sort_keys=False, default_flow_style=False)
+
+
 def render_params_example(slug: str, display_name: str, description: str, author: str) -> str:
     data = {
         "name": slug,
@@ -284,6 +314,11 @@ def render_params_example(slug: str, display_name: str, description: str, author
         "license": "MIT",
         "model_provider": "openrouter",
         "model_default": "anthropic/claude-sonnet-4",
+        "template_source": {
+            "name": "codegraphtheory/hermes-profile-template",
+            "url": "https://github.com/codegraphtheory/hermes-profile-template",
+            "relationship": "generated-from-template",
+        },
         "toolsets": ["file", "terminal", "skills", "web", "session_search", "clarify"],
         "env_requires": [],
         "principles": [
@@ -343,6 +378,9 @@ def generate(params: dict[str, Any], output: Path, force: bool, template_root: P
     write(output / "mcp.json", "{\n  \"mcpServers\": {}\n}")
     write(output / "templates" / "profile.params.yaml", render_params_example(slug, display_name, description, author))
     copy_support_files(template_root, output)
+    template_source_file = render_template_source_file(params)
+    if template_source_file:
+        write(output / ".github" / "template-source.yml", template_source_file)
 
     result = subprocess.run(
         ["python3", str(output / "scripts" / "validate_profile.py"), str(output)],

scripts/new_profile.py

@@ -29,6 +29,11 @@ def main() -> int:
         "license": "MIT",
         "model_provider": "openrouter",
         "model_default": "anthropic/claude-sonnet-4",
+        "template_source": {
+            "name": "codegraphtheory/hermes-profile-template",
+            "url": "https://github.com/codegraphtheory/hermes-profile-template",
+            "relationship": "generated-from-template",
+        },
         "toolsets": ["file", "terminal", "skills", "web", "session_search", "clarify"],
         "env_requires": [],
     }

scripts/validate_profile.py

@@ -76,6 +76,19 @@ def check_manifest(root: Path, errors: list[str]) -> None:
     if name and not re.fullmatch(r"[a-z0-9][a-z0-9-]{0,62}", name):
         fail(errors, "distribution.yaml name must be lowercase kebab case")
     env_requires = data.get("env_requires", [])
+    template_source = data.get("template_source")
+    if template_source is not None:
+        if not isinstance(template_source, dict):
+            fail(errors, "distribution.yaml template_source must be a mapping")
+        elif template_source.get("url") and not str(template_source["url"]).startswith("https://github.com/"):
+            fail(errors, "distribution.yaml template_source.url should be a GitHub HTTPS URL")
+    lineage_file = root / ".github" / "template-source.yml"
+    if template_source and not lineage_file.exists():
+        fail(errors, "template_source is declared but .github/template-source.yml is missing")
+    if lineage_file.exists():
+        lineage = load_yaml(lineage_file, errors)
+        if isinstance(lineage, dict) and not isinstance(lineage.get("template"), dict):
+            fail(errors, ".github/template-source.yml must contain a template mapping")
     if env_requires and not isinstance(env_requires, list):
         fail(errors, "distribution.yaml env_requires must be a list")
     owned = data.get("distribution_owned", [])

templates/profile.params.yaml

@@ -7,6 +7,11 @@ license: MIT
 hermes_requires: ">=0.12.0"
 model_provider: openrouter
 model_default: anthropic/claude-sonnet-4
+template_source:
+  name: codegraphtheory/hermes-profile-template
+  url: https://github.com/codegraphtheory/hermes-profile-template
+  commit: d0a6aa4
+  relationship: rebuilt-from-template
 
 toolsets:
   - file