p-dev-harness 0.3.1 → 0.4.0

package/gui/.next/types/validator.ts

@@ -47,6 +47,15 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
 }
 
 
+// Validate ../../app/operations/page.tsx
+{
+  type __IsExpected<Specific extends AppPageConfig<"/operations">> = Specific
+  const handler = {} as typeof import("../../app/operations/page.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
 // Validate ../../app/page.tsx
 {
   type __IsExpected<Specific extends AppPageConfig<"/">> = Specific
@@ -56,6 +65,69 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __Unused = __Check
 }
 
+// Validate ../../app/settings/(console)/connections/page.tsx
+{
+  type __IsExpected<Specific extends AppPageConfig<"/settings/connections">> = Specific
+  const handler = {} as typeof import("../../app/settings/(console)/connections/page.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/settings/(console)/data-sharing/page.tsx
+{
+  type __IsExpected<Specific extends AppPageConfig<"/settings/data-sharing">> = Specific
+  const handler = {} as typeof import("../../app/settings/(console)/data-sharing/page.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/settings/(console)/deployments/page.tsx
+{
+  type __IsExpected<Specific extends AppPageConfig<"/settings/deployments">> = Specific
+  const handler = {} as typeof import("../../app/settings/(console)/deployments/page.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/settings/(console)/linear/page.tsx
+{
+  type __IsExpected<Specific extends AppPageConfig<"/settings/linear">> = Specific
+  const handler = {} as typeof import("../../app/settings/(console)/linear/page.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/settings/(console)/models/page.tsx
+{
+  type __IsExpected<Specific extends AppPageConfig<"/settings/models">> = Specific
+  const handler = {} as typeof import("../../app/settings/(console)/models/page.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/settings/(console)/page.tsx
+{
+  type __IsExpected<Specific extends AppPageConfig<"/settings">> = Specific
+  const handler = {} as typeof import("../../app/settings/(console)/page.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/settings/(console)/repositories/page.tsx
+{
+  type __IsExpected<Specific extends AppPageConfig<"/settings/repositories">> = Specific
+  const handler = {} as typeof import("../../app/settings/(console)/repositories/page.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
 // Validate ../../app/settings/configure/page.tsx
 {
   type __IsExpected<Specific extends AppPageConfig<"/settings/configure">> = Specific
@@ -65,6 +137,69 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __Unused = __Check
 }
 
+// Validate ../../app/workflow/page.tsx
+{
+  type __IsExpected<Specific extends AppPageConfig<"/workflow">> = Specific
+  const handler = {} as typeof import("../../app/workflow/page.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/observability/event/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/observability/event">> = Specific
+  const handler = {} as typeof import("../../app/api/observability/event/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/observability/preferences/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/observability/preferences">> = Specific
+  const handler = {} as typeof import("../../app/api/observability/preferences/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/operations/bootstrap/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/operations/bootstrap">> = Specific
+  const handler = {} as typeof import("../../app/api/operations/bootstrap/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/operations/draft/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/operations/draft">> = Specific
+  const handler = {} as typeof import("../../app/api/operations/draft/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/settings/apply-config-patch/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/settings/apply-config-patch">> = Specific
+  const handler = {} as typeof import("../../app/api/settings/apply-config-patch/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/settings/preview-config-patch/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/settings/preview-config-patch">> = Specific
+  const handler = {} as typeof import("../../app/api/settings/preview-config-patch/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
 // Validate ../../app/api/setup/apply-connect-services/route.ts
 {
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/setup/apply-connect-services">> = Specific
@@ -101,6 +236,15 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __Unused = __Check
 }
 
+// Validate ../../app/api/setup/apply-linear-workspace/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/setup/apply-linear-workspace">> = Specific
+  const handler = {} as typeof import("../../app/api/setup/apply-linear-workspace/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
 // Validate ../../app/api/setup/apply-local-files/route.ts
 {
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/setup/apply-local-files">> = Specific
@@ -110,6 +254,24 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __Unused = __Check
 }
 
+// Validate ../../app/api/setup/apply-runner-upgrade/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/setup/apply-runner-upgrade">> = Specific
+  const handler = {} as typeof import("../../app/api/setup/apply-runner-upgrade/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/setup/apply-target-repo-provisioning/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/setup/apply-target-repo-provisioning">> = Specific
+  const handler = {} as typeof import("../../app/api/setup/apply-target-repo-provisioning/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
 // Validate ../../app/api/setup/apply-target-workflow/route.ts
 {
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/setup/apply-target-workflow">> = Specific
@@ -128,6 +290,15 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __Unused = __Check
 }
 
+// Validate ../../app/api/setup/complete-initial-setup/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/setup/complete-initial-setup">> = Specific
+  const handler = {} as typeof import("../../app/api/setup/complete-initial-setup/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
 // Validate ../../app/api/setup/finalize-target-workflow/route.ts
 {
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/setup/finalize-target-workflow">> = Specific
@@ -137,6 +308,15 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __Unused = __Check
 }
 
+// Validate ../../app/api/setup/harness-provisioning-progress/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/setup/harness-provisioning-progress">> = Specific
+  const handler = {} as typeof import("../../app/api/setup/harness-provisioning-progress/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
 // Validate ../../app/api/setup/harness-provisioning-summary/route.ts
 {
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/setup/harness-provisioning-summary">> = Specific
@@ -155,6 +335,15 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __Unused = __Check
 }
 
+// Validate ../../app/api/setup/linear-setup-progress/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/setup/linear-setup-progress">> = Specific
+  const handler = {} as typeof import("../../app/api/setup/linear-setup-progress/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
 // Validate ../../app/api/setup/linear-summary/route.ts
 {
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/setup/linear-summary">> = Specific
@@ -164,6 +353,15 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __Unused = __Check
 }
 
+// Validate ../../app/api/setup/linear-workspace-editor-state/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/setup/linear-workspace-editor-state">> = Specific
+  const handler = {} as typeof import("../../app/api/setup/linear-workspace-editor-state/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
 // Validate ../../app/api/setup/local-readiness/route.ts
 {
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/setup/local-readiness">> = Specific
@@ -218,6 +416,15 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __Unused = __Check
 }
 
+// Validate ../../app/api/setup/preview-linear-workspace/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/setup/preview-linear-workspace">> = Specific
+  const handler = {} as typeof import("../../app/api/setup/preview-linear-workspace/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
 // Validate ../../app/api/setup/preview-local-files/route.ts
 {
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/setup/preview-local-files">> = Specific
@@ -227,6 +434,24 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __Unused = __Check
 }
 
+// Validate ../../app/api/setup/preview-runner-upgrade/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/setup/preview-runner-upgrade">> = Specific
+  const handler = {} as typeof import("../../app/api/setup/preview-runner-upgrade/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/setup/preview-target-repo-provisioning/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/setup/preview-target-repo-provisioning">> = Specific
+  const handler = {} as typeof import("../../app/api/setup/preview-target-repo-provisioning/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
 // Validate ../../app/api/setup/preview-target-workflow/route.ts
 {
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/setup/preview-target-workflow">> = Specific
@@ -254,6 +479,24 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __Unused = __Check
 }
 
+// Validate ../../app/api/setup/runner-upgrade-progress/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/setup/runner-upgrade-progress">> = Specific
+  const handler = {} as typeof import("../../app/api/setup/runner-upgrade-progress/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/setup/runner-upgrade-status/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/setup/runner-upgrade-status">> = Specific
+  const handler = {} as typeof import("../../app/api/setup/runner-upgrade-status/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
 // Validate ../../app/api/setup/summary/route.ts
 {
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/setup/summary">> = Specific
@@ -317,6 +560,24 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __Unused = __Check
 }
 
+// Validate ../../app/api/workflow/bootstrap/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/workflow/bootstrap">> = Specific
+  const handler = {} as typeof import("../../app/api/workflow/bootstrap/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/workflow/models/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/workflow/models">> = Specific
+  const handler = {} as typeof import("../../app/api/workflow/models/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
 
 
 
@@ -329,3 +590,12 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   // @ts-ignore
   type __Unused = __Check
 }
+
+// Validate ../../app/settings/(console)/layout.tsx
+{
+  type __IsExpected<Specific extends LayoutConfig<"/settings">> = Specific
+  const handler = {} as typeof import("../../app/settings/(console)/layout.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}

package/observability.public.json

@@ -0,0 +1,6 @@
+{
+  "observabilitySchemaVersion": 1,
+  "sentryPublicDsn": "https://07411796c702eb5c5965e77c7a1e4501@o4510627843407872.ingest.us.sentry.io/4511740568338432",
+  "posthogProjectToken": "phc_t8dFikTMnKyjvnKV7jRKVZMGUu7zXSwoRzaanSQ6qC2n",
+  "posthogIngestionHost": "https://us.i.posthog.com"
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "p-dev-harness",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "type": "module",
   "description": "Launch the Product Development Harness guided Configure GUI without cloning the source repository.",
   "license": "MIT",
@@ -16,6 +16,7 @@
     "gui",
     "templates",
     "workspace-snapshot",
+    "observability.public.json",
     "README.md",
     "LICENSE"
   ],
@@ -43,6 +44,9 @@
   "dependencies": {
     "@cursor/sdk": "^1.0.23",
     "@linear/sdk": "^40.0.0",
+    "posthog-node": "^5.26.1",
+    "@sentry/node": "^9.47.1",
+    "@radix-ui/react-dropdown-menu": "^2.1.16",
     "@radix-ui/react-slot": "^1.2.3",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",

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

@@ -9,6 +9,7 @@
   "defaultModel": { "id": "composer-2.5" },
   "linear": {
     "teamKey": "TEAM",
+    "teamId": "00000000-0000-0000-0000-000000000000",
     "eligibleStatuses": {
       "planning": ["Ready for Planning"],
       "implementation": ["Ready for Build"],

package/workspace-snapshot/files/.agents/skills/implementation/SKILL.md

@@ -18,6 +18,10 @@ Execute exactly one approved implementation unit at a time, validate it, and rep
 - Merge-owned **integration repair** is required on an existing PR branch
 - The operator wants scoped implementation with objective validation reporting
 
+## Uninitialized product guardrail
+
+Do not run initial-build implementation when the target product marker on the development branch is `uninitialized` unless the runner has explicitly routed a foundation slice. If the product is uninitialized, stop and report that foundation planning must complete first.
+
 ## Skill boundaries
 
 ### Must do

package/workspace-snapshot/files/.agents/skills/issue-intake/SKILL.md

@@ -59,6 +59,7 @@ Recommend **Linear status** (not a description section):
 | Structurally incomplete | Backlog |
 | Narrow + low-risk (task ≤240 chars, AC ≤7) | Ready for Build only after operator confirms |
 | Broad, ambiguous, cross-cutting, or high-risk | Ready for Planning or Backlog |
+| Uninitialized product (metadata or marker) | Ready for Planning only |
 | Default | Backlog |
 
 **Never** recommend Ready for Build for broad or ambiguous work.
@@ -74,10 +75,21 @@ Read Linear project description for:
 ```text
 Harness metadata:
 Target repo: owner/repo
+Product initialization: uninitialized | initialized
 ```
 
 Copy derived repo into `## Target repo` in the issue description.
 
+### Uninitialized products
+
+When project metadata reports `Product initialization: uninitialized` (or the target repo marker on the development branch is uninitialized):
+
+- Recommend **Ready for Planning** for the first foundation issue.
+- **Never** recommend Ready for Build until the product is initialized.
+- For foundation planning issues, include optional `## Product foundation` with at least:
+  - `Platform runtime: ...`
+  - `Language framework: ...`
+
 ## Narrow-issue thresholds (build-direct)
 
 Direct implementation without a prior planning run requires:
@@ -115,7 +127,7 @@ Required sections (level-2 headers, case-insensitive):
 - `## Acceptance criteria` — at least one `-` bullet
 - `## Out of scope` — at least one `-` bullet
 
-Optional: `## Validation expectations`, `## Context and links`, `## User / job story`, `## Eval hints`, `## Definition of ready`
+Optional: `## Validation expectations`, `## Context and links`, `## Product foundation`, `## User / job story`, `## Eval hints`, `## Definition of ready`
 
 Authoritative copy: [`prompts/issue-intake-chatgpt.md`](../../../prompts/issue-intake-chatgpt.md)
 

package/workspace-snapshot/files/.agents/skills/planner/SKILL.md

@@ -56,8 +56,18 @@ If no mode is specified:
 
 - Linear issue / feature request → `feature-planning`
 - Audit report / finding IDs → `audit-remediation-planning`
+- Uninitialized product foundation issue → `feature-planning` with product foundation emphasis
 - Explicit request to split work → infer `feature-planning` or `audit-remediation-planning` from the source, then apply PR slicing rules
 
+## Uninitialized product foundation mode
+
+When the target repo marker on the development branch is `uninitialized`, or the issue includes `## Product foundation`:
+
+- Plan the approved architecture and foundation PR only — do not plan feature delivery beyond initialization.
+- Capture platform runtime, language/framework, repository structure, testing strategy, and CI strategy in the plan.
+- The foundation PR must update `.p-dev/product.json` with `approvedArchitecture` and remain technology-neutral in deployment assumptions.
+- Do not assume Vercel, npm, or any stack unless the issue or operator provides it.
+
 ## Shared capability: PR slicing
 
 PR slicing is **not** a standalone planner mode. Apply it inside feature planning or audit-remediation planning when the work is too large for one reviewable PR.

package/workspace-snapshot/files/.github/workflows/harness-auto-runner.yml

@@ -52,6 +52,7 @@ jobs:
       LINEAR_API_KEY: ${{ secrets.LINEAR_API_KEY }}
       GITHUB_TOKEN: ${{ secrets.HARNESS_GITHUB_TOKEN }}
       HARNESS_CONFIG_JSON_B64: ${{ secrets.HARNESS_CONFIG_JSON_B64 }}
+      HARNESS_CONFIG_FINGERPRINT: ${{ vars.HARNESS_CONFIG_FINGERPRINT }}
 
     steps:
       - name: Resolve inputs
@@ -180,6 +181,7 @@ jobs:
       CURSOR_API_KEY: ${{ secrets.CURSOR_API_KEY }}
       GITHUB_TOKEN: ${{ secrets.HARNESS_GITHUB_TOKEN }}
       HARNESS_CONFIG_JSON_B64: ${{ secrets.HARNESS_CONFIG_JSON_B64 }}
+      HARNESS_CONFIG_FINGERPRINT: ${{ vars.HARNESS_CONFIG_FINGERPRINT }}
 
     steps:
       - name: Checkout harness repo
@@ -231,15 +233,26 @@ jobs:
           if [ "$FORCE_FLAG_INPUT" = "true" ]; then
             FORCE_FLAG="--force"
           fi
-          npm run harness:run -- --issue "$ISSUE_KEY" --phase "$PHASE" $FORCE_FLAG --json 2>&1 \
-            | tee harness-raw-output.txt
-          EXIT_CODE=${PIPESTATUS[0]}
-          npm run harness:redact-output < harness-raw-output.txt > harness-run-output.json
-          rm -f harness-raw-output.txt
-          echo "Redacted harness output written to harness-run-output.json"
+          npm run harness:run -- --issue "$ISSUE_KEY" --phase "$PHASE" $FORCE_FLAG --json-out harness-run-output.json
+          EXIT_CODE=$?
           echo "exit_code=$EXIT_CODE" >> "$GITHUB_OUTPUT"
           exit $EXIT_CODE
 
+      - name: Finalize harness run
+        if: always()
+        env:
+          ISSUE_KEY: ${{ needs.gate.outputs.issue_key }}
+          EXIT_CODE: ${{ steps.harness.outputs.exit_code }}
+          LINEAR_DELIVERY_ID: ${{ needs.gate.outputs.linear_delivery_id }}
+          LINEAR_API_KEY: ${{ secrets.LINEAR_API_KEY }}
+          HARNESS_CONFIG_JSON_B64: ${{ secrets.HARNESS_CONFIG_JSON_B64 }}
+          HARNESS_CONFIG_FINGERPRINT: ${{ vars.HARNESS_CONFIG_FINGERPRINT }}
+        run: |
+          npx tsx src/workflow/finalize-harness-run.ts \
+            --issue "$ISSUE_KEY" \
+            --json-out harness-run-output.json \
+            --exit-code "${EXIT_CODE:-1}"
+
       - name: Write step summary
         if: always()
         env:
@@ -294,6 +307,7 @@ jobs:
       CURSOR_API_KEY: ${{ secrets.CURSOR_API_KEY }}
       GITHUB_TOKEN: ${{ secrets.HARNESS_GITHUB_TOKEN }}
       HARNESS_CONFIG_JSON_B64: ${{ secrets.HARNESS_CONFIG_JSON_B64 }}
+      HARNESS_CONFIG_FINGERPRINT: ${{ vars.HARNESS_CONFIG_FINGERPRINT }}
 
     steps:
       - name: Checkout harness repo
@@ -340,15 +354,27 @@ jobs:
           if [ "$FORCE_FLAG_INPUT" = "true" ]; then
             FORCE_FLAG="--force"
           fi
-          npm run harness:run -- --issue "$ISSUE_KEY" --phase merge $FORCE_FLAG --json 2>&1 \
-            | tee harness-raw-output.txt
-          EXIT_CODE=${PIPESTATUS[0]}
-          npm run harness:redact-output < harness-raw-output.txt > harness-run-output.json
-          rm -f harness-raw-output.txt
+          npm run harness:run -- --issue "$ISSUE_KEY" --phase merge $FORCE_FLAG --json-out harness-run-output.json
+          EXIT_CODE=$?
           echo "Redacted harness output written to harness-run-output.json"
           echo "exit_code=$EXIT_CODE" >> "$GITHUB_OUTPUT"
           exit $EXIT_CODE
 
+      - name: Finalize merge run
+        if: always()
+        env:
+          ISSUE_KEY: ${{ needs.gate.outputs.issue_key }}
+          EXIT_CODE: ${{ steps.merge.outputs.exit_code }}
+          LINEAR_DELIVERY_ID: ${{ needs.gate.outputs.linear_delivery_id }}
+          LINEAR_API_KEY: ${{ secrets.LINEAR_API_KEY }}
+          HARNESS_CONFIG_JSON_B64: ${{ secrets.HARNESS_CONFIG_JSON_B64 }}
+          HARNESS_CONFIG_FINGERPRINT: ${{ vars.HARNESS_CONFIG_FINGERPRINT }}
+        run: |
+          npx tsx src/workflow/finalize-harness-run.ts \
+            --issue "$ISSUE_KEY" \
+            --json-out harness-run-output.json \
+            --exit-code "${EXIT_CODE:-1}"
+
       - name: Write step summary
         if: always()
         env:
@@ -397,6 +423,7 @@ jobs:
       LINEAR_API_KEY: ${{ secrets.LINEAR_API_KEY }}
       GITHUB_TOKEN: ${{ secrets.HARNESS_GITHUB_TOKEN }}
       HARNESS_CONFIG_JSON_B64: ${{ secrets.HARNESS_CONFIG_JSON_B64 }}
+      HARNESS_CONFIG_FINGERPRINT: ${{ vars.HARNESS_CONFIG_FINGERPRINT }}
 
     steps:
       - name: Resolve sync inputs

package/workspace-snapshot/files/.github/workflows/p-dev-runner-config-canary.yml

@@ -0,0 +1,24 @@
+name: PDev runner config canary
+run-name: PDev runner config canary ${{ inputs.canary_operation_id }}
+on:
+  workflow_dispatch:
+    inputs:
+      canary_operation_id:
+        description: Unique operation id used to locate this canary run after dispatch 204
+        required: true
+        type: string
+jobs:
+  canary:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "22"
+      - run: npm ci
+      - name: Run config canary
+        env:
+          HARNESS_CONFIG_JSON_B64: ${{ secrets.HARNESS_CONFIG_JSON_B64 }}
+          HARNESS_CONFIG_FINGERPRINT: ${{ vars.HARNESS_CONFIG_FINGERPRINT }}
+          GITHUB_ACTIONS: "true"
+        run: npm run harness:canary-runner-config

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

@@ -9,6 +9,7 @@
   "defaultModel": { "id": "composer-2.5" },
   "linear": {
     "teamKey": "TEAM",
+    "teamId": "00000000-0000-0000-0000-000000000000",
     "eligibleStatuses": {
       "planning": ["Ready for Planning"],
       "implementation": ["Ready for Build"],

package/workspace-snapshot/files/AGENTS.md

@@ -4,7 +4,7 @@ Instructions for AI agents working in **agentic-product-development-harness**. R
 
 ## What this repo is
 
-v0.3.1 harness repo: SDK runners (M1–M8), templates, eval contracts, event-driven Linear auto-run, guided Configure GUI, and public `p-dev-harness` npm package. Read this before making changes.
+v0.4.0 harness repo: SDK runners (M1–M8), templates, eval contracts, event-driven Linear auto-run, guided Configure GUI, and public `p-dev-harness` npm package. Read this before making changes.
 
 The harness has **M1–M8 SDK runners and tooling** (planning through merge, issue intake validation, and event-driven auto-run via Linear webhook + GitHub Actions).
 
@@ -108,7 +108,7 @@ These are distinct artifacts. Do not conflate them in docs or reports.
 ## File map
 
 ```text
-README.md           → Public overview and v0.3.1 release positioning
+README.md           → Public overview and v0.4.0 release positioning
 docs/p-dev.md       → Canonical p-dev end-user guide
 ROADMAP.md          → Phased delivery plan
 docs/releases/      → Release contract and tag/release process
@@ -128,3 +128,14 @@ examples/           → Example runs
 ## Tone
 
 Write for hiring managers and technical reviewers: clear, honest, structured. Early-stage is a feature—do not dress v0.3 up as production-grade SaaS.
+
+## Cursor Cloud specific instructions
+
+Standard dev commands are documented in [`README.md`](README.md) and [`docs/getting-started.md`](docs/getting-started.md) (`npm ci`, `npm run build`, `npm test`, `npm run harness:configure`). Non-obvious caveats:
+
+- **Node 22+ ESM/TypeScript project.** The CLI runs TS directly via `tsx`. `npm run build` runs `tsc` plus the Configure GUI build.
+- **No repo-level lint tooling.** There is no ESLint/Prettier/Biome config at the root and no `npm run lint` script for this repo (the `lint` command in `harness.config.json` runs against *target* repos, not here). The effective static check for this repo is the TypeScript typecheck run as part of `npm run build`.
+- **Configure GUI:** `npm run harness:configure:stable` pins to `http://localhost:3000/settings/configure` and cleans `apps/gui/.next` on start; `npm run harness:configure` auto-selects a free port instead. If the page renders unstyled, stop and re-run the `:stable` command.
+- **Tests and the GUI run fully offline.** The vitest suite uses fixtures/mocks and needs no credentials. `LINEAR_API_KEY`, `CURSOR_API_KEY`, and `GITHUB_TOKEN` are only needed for *live* harness runs; `npm run harness:doctor` reporting them as missing is expected offline.
+- **Exercise the orchestrator offline** with a dry run: `npm run harness:run -- --issue WES-FIXTURE --dry-run --fixture tests/fixtures/issues/valid-target-app.md` (writes to the gitignored `runs/` dir).
+- **Slow tests:** `tests/p-dev/installed-tarball-loopback.test.ts` and `tests/p-dev/package-packed-artifact.test.ts` pack and install the `p-dev` package, so a full `npm test` can take about a minute.