Merge pull request 'feat(forge-credential): hatchmate working-repo key layer + 4 composite forks' (#3) from feat/hatchmate-per-project-fork-key into main

Merge PR #3

harnesses/composites/code-airouter-tdd-repo-hatchmate/v1/harness.yaml

@@ -0,0 +1,20 @@
+kind: composite
+name: code-airouter-tdd-repo-hatchmate
+version: 1
+description: "Airouter Qwen3.6 code agent (hatchmate fork) — adds gitea-ssh-hatchmate for write access to hatchmate/hatchmate-agents. Use this for hatchmate work; the un-suffixed composite uses the shared ai-enablement key which has no access to the hatchmate org."
+
+# Inherits airouter context's label gate — only the airouter dispatcher
+# advertises this composite (see dispatcher/poller._collect_supported_harnesses).
+requires_labels: [airouter]
+
+layers:
+  - context: qwen-code-methodology/v1
+  - context: best-practices/v1
+  - context: airouter/v1
+  - context: gitea-ssh/v1
+  - context: gitea-ssh-hatchmate/v1
+  - context: agent-repo/v1
+  - context: tdd-protect/v1
+  - context: tdd-gate/v1
+  - capability: python-dev/v1
+  - capability: tdd-file-lock/v1

harnesses/composites/code-fable-tdd-repo-hatchmate/v1/harness.yaml

@@ -0,0 +1,14 @@
+kind: composite
+name: code-fable-tdd-repo-hatchmate
+version: 1
+description: "Fable code agent (hatchmate fork) — adds gitea-ssh-hatchmate for write access to hatchmate/hatchmate-agents. Use this for hatchmate work; the un-suffixed composite uses the shared ai-enablement key which has no access to the hatchmate org."
+layers:
+  - context: code-methodology/v1
+  - context: anthropic-cloud-paul-oauth/v1
+  - context: gitea-ssh/v1
+  - context: gitea-ssh-hatchmate/v1
+  - context: agent-repo/v1
+  - context: tdd-protect/v1
+  - context: tdd-gate/v1
+  - capability: python-dev/v1
+  - capability: tdd-file-lock/v1

harnesses/composites/code-minimax-tdd-repo-hatchmate/v1/harness.yaml

@@ -0,0 +1,15 @@
+kind: composite
+name: code-minimax-tdd-repo-hatchmate
+version: 1
+description: "MiniMax code agent (hatchmate fork) — adds gitea-ssh-hatchmate for write access to hatchmate/hatchmate-agents. Use this for hatchmate work; the un-suffixed composite uses the shared ai-enablement key which has no access to the hatchmate org."
+
+layers:
+  - context: minimax-code-methodology/v1
+  - context: minimax/v1
+  - context: gitea-ssh/v1
+  - context: gitea-ssh-hatchmate/v1
+  - context: agent-repo/v1
+  - context: tdd-protect/v1
+  - context: tdd-gate/v1
+  - capability: python-dev/v1
+  - capability: tdd-file-lock/v1

harnesses/composites/code-opus-tdd-repo-hatchmate/v1/harness.yaml

@@ -0,0 +1,15 @@
+kind: composite
+name: code-opus-tdd-repo-hatchmate
+version: 1
+description: "Opus code agent (hatchmate fork) — adds gitea-ssh-hatchmate for write access to hatchmate/hatchmate-agents. Use this for hatchmate work; the un-suffixed composite uses the shared ai-enablement key which has no access to the hatchmate org."
+
+layers:
+  - context: code-methodology/v1
+  - context: anthropic-cloud-paul-oauth/v1
+  - context: gitea-ssh/v1
+  - context: gitea-ssh-hatchmate/v1
+  - context: agent-repo/v1
+  - context: tdd-protect/v1
+  - context: tdd-gate/v1
+  - capability: python-dev/v1
+  - capability: tdd-file-lock/v1

harnesses/contexts/gitea-ssh-hatchmate/v1/harness.yaml

@@ -0,0 +1,28 @@
+kind: context
+name: gitea-ssh-hatchmate
+version: 1
+description: "Gitea SSH: clone/push via SSH key for gitea.oreillyit.nz (hatchmate org — agent working-repo key for hatchmate/hatchmate-agents)"
+requires: []
+provides: [git-access]
+# HC-11: repos this layer's forge credential may push to (host-qualified; CRS-103 gate).
+write_targets:
+  - "gitea.oreillyit.nz/hatchmate/*"
+
+git_identity:
+  name: "agent-runtimes"
+  email: "agent@oreillyit.nz"
+
+ssh_hosts:
+  - alias: gitea.oreillyit.nz-hatchmate
+    hostname: gitea.oreillyit.nz
+    user: git
+    identity_secret: GITEA_SSH_KEY
+
+scripts:
+  init: "./init.sh"
+
+secrets_required:
+  - name: gitea-ssh-hatchmate
+    account_ref: "hatchmate.space:platform"
+    mount_path: /run/agent/secrets/gitea-ssh-hatchmate
+    mode: "0400"

harnesses/contexts/gitea-ssh-hatchmate/v1/init.sh

@@ -0,0 +1,21 @@
+#!/bin/bash
+# gitea-ssh-hatchmate init: copy the ESO-mounted SSH key to the path the
+# harness-init `~/.ssh/config` expects (`IdentityFile /home/agent/.ssh/gitea-oreillyit-nz-hatchmate`).
+#
+# Per H-SECRET-4: NO `export` of credentials. (The earlier draft set
+# `GIT_SSH_COMMAND` here — a path, not a credential — but that export dies
+# with the subshell and the harness-init's SSH config is the load-bearing
+# path anyway.)
+set -euo pipefail
+
+SSH_KEY_SRC="/run/agent/secrets/gitea-ssh-hatchmate/private_key"
+SSH_KEY_DST="/home/agent/.ssh/gitea-oreillyit-nz-hatchmate"
+
+if [ ! -r "$SSH_KEY_SRC" ]; then
+    echo "ERROR: SSH key not found at $SSH_KEY_SRC — ESO ExternalSecret not Ready?" >&2
+    exit 1
+fi
+
+mkdir -p /home/agent/.ssh
+install -m 0600 -o agent -g agent "$SSH_KEY_SRC" "$SSH_KEY_DST"
+echo "gitea-ssh-hatchmate: SSH key staged at $SSH_KEY_DST (0600 agent:agent)"

tests/invariants/test_forge_credentials_declare_write_targets.py

@@ -34,8 +34,17 @@ def test_hc11_framework_layers_with_forge_secrets_found_nonzero():
     assert found, "expected >=1 forge-credential layer on the real tree, found 0"
 
 
-@pytest.mark.xfail(strict=True, reason="HC-11 not implemented")
 def test_hc11_framework_layers_with_forge_secrets_declare_write_targets():
+    """Every harness layer carrying forge (git host) credentials MUST declare
+    ``write_targets`` — empty list is a valid deliberate declaration,
+    absent key is a regression.
+
+    HC-11 was implemented across the 4 existing layers and verified passing
+    on 2026-09-18 when the gitea-ssh-hatchmate layer (5th forge-credential
+    layer) landed with write_targets = ['gitea.oreillyit.nz/hatchmate/*'].
+    The previous xfail(strict) marker was dropped — the test is now a real
+    positive gate.
+    """
     found = layers_with_forge_credentials(_HARNESSES_ROOT)
     assert found, "expected >=1 forge-credential layer on the real tree, found 0"
 
@@ -45,10 +54,6 @@ def test_hc11_framework_layers_with_forge_secrets_declare_write_targets():
         if "write_targets" not in parsed:
             missing.append((name, str(yaml_path)))
 
-    # As of this session none of the 4 real layers declare write_targets
-    # (HC-11 has not landed in the framework repo yet), so this is expected
-    # to fail today — xfail(strict) so it flips to a real pass the moment
-    # every forge-credential layer gets a write_targets key.
     assert not missing, (
         "harness layers with forge credentials must declare write_targets "
         f"(even an empty list): {missing}"