p-dev-harness 0.3.0

package/templates/.env.example

@@ -0,0 +1,37 @@
+# Operator local setup — copy to .env.local via: npm run harness:operator:init
+# Do not commit .env.local (gitignored).
+
+# --- Local private harness config (local only) ---
+# Points at your structured target-repo config file.
+# Edit .harness/config.local.json after init; keep this path unchanged.
+HARNESS_CONFIG_PATH=.harness/config.local.json
+
+# --- GitHub Actions only (cloud runs) — do NOT put in .env.local ---
+# HARNESS_CONFIG_JSON_B64 replaces the whole harness config for that run.
+# It is NOT an overlay with committed harness.config.json.
+# Base64-encode your full .harness/config.local.json and set it as a
+# GitHub Actions secret on the harness repo. Include every repo you want
+# the harness to manage in repos[] and allowedTargetRepos[].
+
+# --- Live automation API keys (local CLI) ---
+# Fill these in .env.local for local doctor and harness runs.
+LINEAR_API_KEY=
+CURSOR_API_KEY=
+
+# Local CLI name for GitHub API access (doctor merge profile, handoff, merge).
+# In GitHub Actions the secret is named HARNESS_GITHUB_TOKEN (workflow maps it
+# to runtime GITHUB_TOKEN). Do not use HARNESS_GITHUB_TOKEN in .env.local.
+GITHUB_TOKEN=
+
+# --- GitHub Actions only — configure in repo Settings → Secrets, not .env.local ---
+# HARNESS_GITHUB_TOKEN=           # PAT with access to harness target repos
+# HARNESS_CONFIG_JSON_B64=        # base64 of full private harness config JSON
+
+# --- Vercel webhook bridge only (Milestone 8) — not used by local harness CLI ---
+# See docs/security.md for token scope and rotation policy
+# LINEAR_WEBHOOK_SECRET=
+# GITHUB_DISPATCH_TOKEN=          # Fine-grained: Contents: write on harness repo only
+# GITHUB_DISPATCH_REPOSITORY=     # optional; default owner/agentic-product-development-harness
+# GITHUB_DISPATCH_EVENT_TYPE=     # optional; default linear_issue_status_changed
+# LINEAR_WEBHOOK_TIMESTAMP_TOLERANCE_MS=  # optional; default 60000
+# HARNESS_TEAM_KEY=WES              # required in production Vercel

package/templates/.harness/config.example.json

@@ -0,0 +1,83 @@
+{
+  "version": 1,
+  "orchestratorMarker": "harness-orchestrator-v1",
+  "logDirectory": "runs",
+  "agentProvider": {
+    "id": "cursor",
+    "model": { "id": "composer-2.5" }
+  },
+  "defaultModel": { "id": "composer-2.5" },
+  "linear": {
+    "teamKey": "TEAM",
+    "eligibleStatuses": {
+      "planning": ["Ready for Planning"],
+      "implementation": ["Ready for Build"],
+      "handoff": ["PR Open"],
+      "revision": ["Needs Revision"],
+      "merge": ["Ready to Merge"]
+    },
+    "transitionalStatuses": {
+      "planningInProgress": "Planning",
+      "buildingInProgress": "Building",
+      "prOpen": "PR Open",
+      "pmReview": "PM Review",
+      "blocked": "Blocked",
+      "readyForBuild": "Ready for Build",
+      "needsRevision": "Needs Revision",
+      "revisingInProgress": "Revising",
+      "readyToMerge": "Ready to Merge",
+      "mergingInProgress": "Merging",
+      "mergedToDev": "Merged to Dev",
+      "mergedDeployed": "Merged / Deployed"
+    }
+  },
+  "planning": {
+    "timeoutSeconds": 1800
+  },
+  "implementation": {
+    "timeoutSeconds": 3600,
+    "branchPrefix": "cursor"
+  },
+  "handoff": {
+    "allowPmReviewWithoutPreview": true,
+    "previewRequiredForSuccess": false
+  },
+  "revision": {
+    "timeoutSeconds": 3600
+  },
+  "merge": {
+    "mergeMethod": "squash",
+    "deleteBranchAfterMerge": false,
+    "allowPendingChecks": false,
+    "allowUnknownChecks": false,
+    "allowNeutralChecks": true,
+    "deploymentRequiredForSuccess": false,
+    "deploymentPollTimeoutSeconds": 300,
+    "deploymentPollIntervalSeconds": 15,
+    "checkPollTimeoutSeconds": 120
+  },
+  "preview": {
+    "pollTimeoutSeconds": 300,
+    "pollIntervalSeconds": 15
+  },
+  "repos": [
+    {
+      "id": "target-app",
+      "linearProjects": ["Example Target App"],
+      "targetRepo": "https://github.com/owner/example-target-app",
+      "baseBranch": "dev",
+      "productionBranch": "main",
+      "previewProvider": "vercel",
+      "integrationSuccessStatus": "Merged to Dev",
+      "productionSuccessStatus": "Merged / Deployed",
+      "productionUrl": "https://www.example.com",
+      "integrationPreviewUrl": "https://staging.example.com",
+      "validation": {
+        "commands": ["npm run lint", "npm run build"]
+      }
+    }
+  ],
+  "allowedTargetRepos": [
+    "https://github.com/owner/example-target-app"
+  ]
+}