p-dev-harness 0.3.0 → 0.3.1

package/workspace-snapshot/files/gpt/issue-intake/smoke-test.md

@@ -0,0 +1,119 @@
+# Smoke test — Product Issue Intake Custom GPT
+
+Manual validation script. Run each case in ChatGPT with the configured Custom GPT. Record **pass / fail** and notes.
+
+**Pass criteria:** Cases 1–6 and 9–10 pass in ChatGPT. Case 7 passes when Linear app is connected. Case 8 documents fallback behavior.
+
+---
+
+## Test matrix
+
+| # | Scenario | Input gist | Expected | Pass | Notes |
+|---|----------|------------|----------|------|-------|
+| 1 | Happy path narrow | Small UI tweak, 3 AC, clear repo | Package complete; readiness planning yes, direct impl yes; default status Backlog; after approval may offer Ready for Build | | |
+| 2 | Broad feature | IA redesign, 8+ AC | direct impl no; recommends Ready for Planning; refuses Ready for Build even if user insists | | |
+| 3 | Incomplete intake | User skips out-of-scope | Blocking questions; Backlog; valid for planning no | | |
+| 4 | Draft only | User selects Draft only in field 8 | Package only; no Linear create attempted | | |
+| 5 | Approval gate | User says "create it" before package shown | GPT shows full package first, then asks explicit approval | | |
+| 6 | Ambiguous repo | "the main app" without repo name | Blocking question; does not invent repo | | |
+| 7 | Linear app create | Approve narrow issue from case 1 | Issue created in correct team; status Backlog unless user approved higher; description has `##` sections only, no routing section | | |
+| 8 | No Linear app | Disconnect Linear app or use account without app | Copy-paste package + manual create instructions; no failed silent create | | |
+| 9 | Generic language | Any scenario | No personal names, operator-specific repos, or harness-internal jargon in PM-visible output | | |
+| 10 | Description contract | Any created or drafted issue | Required `##` sections present; AC and out-of-scope use `-` bullets; no routing recommendation in body | | |
+
+---
+
+## Case prompts (copy-paste)
+
+### Case 1 — Happy path narrow
+
+```
+I need a small UI change:
+
+1. Repo: acme-corp/checkout-web
+2. Outcome: Customers see confirmation feedback after checkout
+3. Problem: No feedback after successful payment
+4. Change: Add a success toast
+5. AC: Toast within 2s; shows order number; auto-dismiss 5s
+6. Out of scope: Email, payment provider, other pages
+7. Validation: lint, build, manual staging test
+8. Status: Backlog
+```
+
+### Case 2 — Broad feature
+
+```
+1. Repo: acme-corp/checkout-web
+2. Outcome: Customers never get lost in checkout
+3. Problem: Navigation is confusing across steps
+4. Change: Full IA and nav redesign for checkout
+5. AC: (list 8+ items covering nav, mobile, cart, support, links, preview, lint, build)
+6. Out of scope: Payment provider, CMS, backend API
+7. Validation: lint, build, staging preview
+8. Status: Ready for Build
+```
+
+After package, insist "Set it to Ready for Build anyway." GPT should refuse and explain.
+
+### Case 3 — Incomplete intake
+
+Provide fields 1–5 only; omit out of scope when asked in upfront form.
+
+### Case 4 — Draft only
+
+Same as case 1 but field 8 = `Draft only`. Confirm no Linear create.
+
+### Case 5 — Approval gate
+
+Start with: "Create a Linear issue for adding a logout button to acme-corp/admin-portal" before answering intake fields.
+
+### Case 6 — Ambiguous repo
+
+```
+1. Repo: the main app
+2–7. (reasonable content)
+8. Backlog
+```
+
+### Case 7 — Linear app create
+
+Complete case 1, approve package, confirm team if asked. Verify issue in Linear UI.
+
+### Case 8 — No Linear app
+
+Disconnect Linear or use environment without app. Complete case 1 and approve. Expect manual instructions only.
+
+---
+
+## Structural validation (operator)
+
+Paste example descriptions from [`knowledge.md`](knowledge.md) into draft files and run in harness repo:
+
+```bash
+# Narrow example — planning pass
+npm run harness:validate-issue -- --file narrow-draft.md --intended-phase planning
+
+# Narrow example — implementation pass
+npm run harness:validate-issue -- --file narrow-draft.md --intended-phase implementation
+
+# Broad example — planning pass, implementation fail
+npm run harness:validate-issue -- --file broad-draft.md --intended-phase planning
+npm run harness:validate-issue -- --file broad-draft.md --intended-phase implementation
+```
+
+Exit code 2 on broad + `--intended-phase implementation` is expected.
+
+---
+
+## Escalation
+
+If case 7 fails on a supported ChatGPT plan with Linear app connected and authorized for write, document the error and open follow-up for custom GPT Actions. Do not block M9 delivery on Actions unless create is impossible.
+
+---
+
+## Sign-off
+
+| Role | Name | Date | Result |
+|------|------|------|--------|
+| Operator | | | |
+| PM reviewer | | | |

package/workspace-snapshot/files/harness.config.json

@@ -0,0 +1,92 @@
+{
+  "version": 1,
+  "orchestratorMarker": "harness-orchestrator-v1",
+  "logDirectory": "runs",
+  "agentProvider": {
+    "id": "cursor",
+    "model": { "id": "composer-2.5" }
+  },
+  "defaultModel": { "id": "composer-2.5" },
+  "linear": {
+    "teamKey": "WES",
+    "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"]
+      }
+    },
+    {
+      "id": "harness",
+      "linearProjects": ["Agentic Product Development Harness"],
+      "targetRepo": "https://github.com/weston-uribe/agentic-product-development-harness",
+      "baseBranch": "main",
+      "productionBranch": "main",
+      "previewProvider": "none"
+    }
+  ],
+  "allowedTargetRepos": [
+    "https://github.com/owner/example-target-app",
+    "https://github.com/weston-uribe/agentic-product-development-harness"
+  ]
+}

package/workspace-snapshot/files/harness.config.schema.json

@@ -0,0 +1,352 @@
+{
+  "$ref": "#/definitions/HarnessConfig",
+  "definitions": {
+    "HarnessConfig": {
+      "type": "object",
+      "properties": {
+        "version": {
+          "type": "number",
+          "const": 1
+        },
+        "orchestratorMarker": {
+          "type": "string",
+          "default": "harness-orchestrator-v1"
+        },
+        "logDirectory": {
+          "type": "string",
+          "default": "runs"
+        },
+        "agentProvider": {
+          "type": "object",
+          "properties": {
+            "id": {
+              "type": "string",
+              "const": "cursor"
+            },
+            "model": {
+              "type": "object",
+              "properties": {
+                "id": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "id"
+              ],
+              "additionalProperties": false
+            }
+          },
+          "required": [
+            "id"
+          ],
+          "additionalProperties": false
+        },
+        "defaultModel": {
+          "type": "object",
+          "properties": {
+            "id": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "id"
+          ],
+          "additionalProperties": false
+        },
+        "linear": {
+          "type": "object",
+          "properties": {
+            "teamKey": {
+              "type": "string"
+            },
+            "eligibleStatuses": {
+              "type": "object",
+              "properties": {
+                "planning": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                },
+                "implementation": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                },
+                "handoff": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                },
+                "revision": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                },
+                "merge": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                }
+              },
+              "additionalProperties": false
+            },
+            "transitionalStatuses": {
+              "type": "object",
+              "properties": {
+                "planningInProgress": {
+                  "type": "string"
+                },
+                "buildingInProgress": {
+                  "type": "string"
+                },
+                "prOpen": {
+                  "type": "string"
+                },
+                "pmReview": {
+                  "type": "string"
+                },
+                "blocked": {
+                  "type": "string"
+                },
+                "readyForBuild": {
+                  "type": "string"
+                },
+                "needsRevision": {
+                  "type": "string"
+                },
+                "revisingInProgress": {
+                  "type": "string"
+                },
+                "readyToMerge": {
+                  "type": "string"
+                },
+                "mergingInProgress": {
+                  "type": "string"
+                },
+                "mergedToDev": {
+                  "type": "string"
+                },
+                "mergedDeployed": {
+                  "type": "string"
+                }
+              },
+              "additionalProperties": false
+            }
+          },
+          "additionalProperties": false
+        },
+        "planning": {
+          "type": "object",
+          "properties": {
+            "timeoutSeconds": {
+              "type": "number",
+              "exclusiveMinimum": 0
+            }
+          },
+          "additionalProperties": false
+        },
+        "implementation": {
+          "type": "object",
+          "properties": {
+            "timeoutSeconds": {
+              "type": "number",
+              "exclusiveMinimum": 0
+            },
+            "branchPrefix": {
+              "type": "string",
+              "minLength": 1,
+              "default": "cursor"
+            }
+          },
+          "additionalProperties": false
+        },
+        "handoff": {
+          "type": "object",
+          "properties": {
+            "allowPmReviewWithoutPreview": {
+              "type": "boolean"
+            },
+            "previewRequiredForSuccess": {
+              "type": "boolean"
+            }
+          },
+          "additionalProperties": false
+        },
+        "revision": {
+          "type": "object",
+          "properties": {
+            "timeoutSeconds": {
+              "type": "number",
+              "exclusiveMinimum": 0
+            }
+          },
+          "additionalProperties": false
+        },
+        "merge": {
+          "type": "object",
+          "properties": {
+            "mergeMethod": {
+              "type": "string",
+              "enum": [
+                "squash",
+                "merge",
+                "rebase"
+              ]
+            },
+            "deleteBranchAfterMerge": {
+              "type": "boolean"
+            },
+            "allowPendingChecks": {
+              "type": "boolean"
+            },
+            "allowUnknownChecks": {
+              "type": "boolean"
+            },
+            "allowNeutralChecks": {
+              "type": "boolean"
+            },
+            "deploymentRequiredForSuccess": {
+              "type": "boolean"
+            },
+            "deploymentPollTimeoutSeconds": {
+              "type": "number",
+              "exclusiveMinimum": 0
+            },
+            "deploymentPollIntervalSeconds": {
+              "type": "number",
+              "exclusiveMinimum": 0
+            },
+            "checkPollTimeoutSeconds": {
+              "type": "number",
+              "exclusiveMinimum": 0
+            }
+          },
+          "additionalProperties": false
+        },
+        "watch": {
+          "type": "object",
+          "properties": {
+            "pollIntervalSeconds": {
+              "type": "number",
+              "exclusiveMinimum": 0
+            },
+            "maxConcurrentRuns": {
+              "type": "number",
+              "exclusiveMinimum": 0
+            }
+          },
+          "additionalProperties": false
+        },
+        "preview": {
+          "type": "object",
+          "properties": {
+            "pollTimeoutSeconds": {
+              "type": "number",
+              "exclusiveMinimum": 0
+            },
+            "pollIntervalSeconds": {
+              "type": "number",
+              "exclusiveMinimum": 0
+            }
+          },
+          "additionalProperties": false
+        },
+        "repos": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string",
+                "minLength": 1
+              },
+              "linearProjects": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              },
+              "linearTeams": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              },
+              "targetRepo": {
+                "type": "string",
+                "pattern": "^https:\\/\\/github\\.com\\/[A-Za-z0-9_.-]+\\/[A-Za-z0-9_.-]+\\/?$"
+              },
+              "baseBranch": {
+                "type": "string",
+                "minLength": 1,
+                "default": "main"
+              },
+              "productionBranch": {
+                "type": "string",
+                "minLength": 1,
+                "default": "main"
+              },
+              "previewProvider": {
+                "type": "string"
+              },
+              "integrationPreviewUrl": {
+                "type": "string",
+                "format": "uri"
+              },
+              "productionUrl": {
+                "type": "string",
+                "format": "uri"
+              },
+              "integrationSuccessStatus": {
+                "type": "string",
+                "minLength": 1
+              },
+              "productionSuccessStatus": {
+                "type": "string",
+                "minLength": 1
+              },
+              "validation": {
+                "type": "object",
+                "properties": {
+                  "commands": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    }
+                  }
+                },
+                "additionalProperties": false
+              }
+            },
+            "required": [
+              "id",
+              "targetRepo"
+            ],
+            "additionalProperties": false
+          },
+          "minItems": 1
+        },
+        "allowedTargetRepos": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "pattern": "^https:\\/\\/github\\.com\\/[A-Za-z0-9_.-]+\\/[A-Za-z0-9_.-]+\\/?$"
+          },
+          "minItems": 1
+        }
+      },
+      "required": [
+        "version",
+        "repos",
+        "allowedTargetRepos"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}