Harness Proposal

.devcontainer/devcontainer.json

@@ -1,5 +1,8 @@
 {
     "name": "eclipse-s-core",
     "image": "ghcr.io/eclipse-score/devcontainer:v1.2.0",
-    "updateContentCommand": "bazel run //:ide_support"
+    "updateContentCommand": "bazel run //:ide_support",
+    "mounts": [
+    "source=${localEnv:HOME}/.agents,target=/root/.agents,type=bind,consistency=cached"
+  ]
 }

.github/copilot-instructions.md

@@ -0,0 +1,7 @@
+# SCORE Copilot Overlay
+
+- Follow `AGENTS.md` as the primary behavior contract for planning and execution.
+- Keep changes minimal, scoped, and traceable to the active issue.
+- Place generated evidence and intermediate artifacts under `.stage/ISSUE-<number>/...`.
+- Prefer reproducible commands and include validation steps for touched files.
+- When uncertain, prioritize repository conventions and existing automation.

.github/references/agent-card.schema.json

@@ -0,0 +1,155 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://score.dev/schemas/agent-card.schema.json",
+  "title": "SCORE Agent Card",
+  "description": "Structured handoff artifact exchanged between agents and tools for one issue-scoped work item.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "version",
+    "issue_id",
+    "repository",
+    "goal",
+    "status",
+    "summary",
+    "validation",
+    "next_action"
+  ],
+  "properties": {
+    "version": {
+      "const": 1
+    },
+    "issue_id": {
+      "type": "string",
+      "pattern": "^(ISSUE-[0-9]+|POC-[0-9]{8}-[0-9]{4})$"
+    },
+    "repository": {
+      "type": "string",
+      "minLength": 1
+    },
+    "branch": {
+      "type": "string",
+      "minLength": 1
+    },
+    "goal": {
+      "type": "string",
+      "minLength": 1
+    },
+    "status": {
+      "type": "string",
+      "enum": [
+        "in_progress",
+        "blocked",
+        "ready_for_handoff",
+        "completed"
+      ]
+    },
+    "summary": {
+      "type": "string",
+      "minLength": 1
+    },
+    "findings": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/note"
+      },
+      "default": []
+    },
+    "open_questions": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      },
+      "default": []
+    },
+    "touched_files": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      },
+      "uniqueItems": true,
+      "default": []
+    },
+    "validation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "status"
+      ],
+      "properties": {
+        "status": {
+          "type": "string",
+          "enum": [
+            "not_run",
+            "passed",
+            "failed"
+          ]
+        },
+        "commands": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/commandResult"
+          },
+          "default": []
+        }
+      }
+    },
+    "trajectory": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/note"
+      },
+      "default": []
+    },
+    "next_action": {
+      "type": "string",
+      "minLength": 1
+    }
+  },
+  "$defs": {
+    "note": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "title",
+        "detail"
+      ],
+      "properties": {
+        "title": {
+          "type": "string",
+          "minLength": 1
+        },
+        "detail": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "commandResult": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "command",
+        "status"
+      ],
+      "properties": {
+        "command": {
+          "type": "string",
+          "minLength": 1
+        },
+        "status": {
+          "type": "string",
+          "enum": [
+            "passed",
+            "failed"
+          ]
+        },
+        "detail": {
+          "type": "string"
+        }
+      }
+    }
+  }
+}

.github/references/repo-manifest.schema.json

@@ -0,0 +1,152 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://score.dev/schemas/repo-manifest.schema.json",
+  "title": "SCORE Repo Manifest",
+  "description": "Minimal federated harness contract for a SCORE repository.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "version",
+    "repository",
+    "bootstrap",
+    "execution",
+    "mcp"
+  ],
+  "properties": {
+    "version": {
+      "const": 1
+    },
+    "repository": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "name",
+        "language",
+        "visibility"
+      ],
+      "properties": {
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "language": {
+          "type": "string",
+          "enum": [
+            "python",
+            "go",
+            "rust",
+            "cpp",
+            "typescript",
+            "mixed",
+            "other"
+          ]
+        },
+        "visibility": {
+          "type": "string",
+          "enum": [
+            "public",
+            "internal",
+            "private"
+          ]
+        },
+        "tags": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          },
+          "uniqueItems": true,
+          "default": []
+        }
+      }
+    },
+    "bootstrap": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "contract_version"
+      ],
+      "properties": {
+        "contract_version": {
+          "type": "string",
+          "pattern": "^v[0-9]+\\.[0-9]+\\.[0-9]+$"
+        },
+        "template_version": {
+          "type": "string",
+          "pattern": "^v[0-9]+\\.[0-9]+\\.[0-9]+$"
+        }
+      }
+    },
+    "execution": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "build",
+        "test",
+        "lint"
+      ],
+      "properties": {
+        "build": {
+          "$ref": "#/$defs/commandSpec"
+        },
+        "test": {
+          "$ref": "#/$defs/commandSpec"
+        },
+        "lint": {
+          "$ref": "#/$defs/commandSpec"
+        },
+        "typecheck": {
+          "$ref": "#/$defs/commandSpec"
+        }
+      }
+    },
+    "mcp": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "server_name",
+        "tools"
+      ],
+      "properties": {
+        "server_name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "tools": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "build",
+              "test",
+              "lint",
+              "typecheck",
+              "search"
+            ]
+          },
+          "uniqueItems": true,
+          "minItems": 1
+        }
+      }
+    }
+  },
+  "$defs": {
+    "commandSpec": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "command"
+      ],
+      "properties": {
+        "command": {
+          "type": "string",
+          "minLength": 1
+        },
+        "working_directory": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    }
+  }
+}

.github/score/.copier-answers.yml

@@ -0,0 +1,9 @@
+_src_path: gh:eclipse-score/.github
+_commit: cccecdc7c915d4d3df2e747b7fee97accc1ba812
+repo_name: docs-as-code
+repo_language: Python
+repo_visibility: public
+build_command: bazel build //...
+test_command: bazel test //...
+lint_command: bazel test //...
+assistant_instructions_file: copilot-instructions.md

.github/score/repo-manifest.json

@@ -0,0 +1,23 @@
+{
+  "version": 1,
+  "repository": {
+    "name": "docs-as-code",
+    "language": "python",
+    "visibility": "public",
+    "tags": ["docs", "traceability", "iso26262"]
+  },
+  "bootstrap": {
+    "contract_version": "v0.1.0",
+    "template_version": "v0.1.0"
+  },
+  "execution": {
+    "build": { "command": "bazel build //..." },
+    "test": { "command": "bazel test //..." },
+    "lint": { "command": "bazel test //..." },
+    "typecheck": { "command": "bazel test //..." }
+  },
+  "mcp": {
+    "server_name": "score-repo-tools",
+    "tools": ["build", "test", "lint", "typecheck"]
+  }
+}

.gitignore

@@ -1,4 +1,7 @@
 # Commonly used for local settings and secrets
+# ╓                                                          ╖
+# ║ Some portions generated by Github Copilot                ║
+# ╙                                                          ╜
 .env
 
 # Bazel
@@ -26,3 +29,10 @@ __pycache__/
 
 # bug: This file is created in repo root on test discovery.
 /consumer_test.log
+.clwb
+
+# Harness execution history (local only)
+score_harness/runs/
+
+# Temporary issue drafts (already created in GitHub)
+.tmp_issue_updates/