pstack

---
name: pstack
description: >-
  Project-local pstack validation router for chmonitor. Use when proving a
  dashboard, API, auth or security, PeerDB, alerts and webhooks, Helm and
  GitOps, deployment, or CLI change. Prefer CI checks and capture observable
  evidence instead of running heavy local builds.
---

# chmonitor pstack validation

A project adapter to the pstack method. The feature map is
[features/README.md](features/README.md); the inventory and CI matrix are in
[docs/knowledge/pstack-validation.md](../../../docs/knowledge/pstack-validation.md).
Provenance and the pinned upstream copy are in [README.md](README.md).

The default proof is the CI run for the commit under review. A file that
parses, a build that used to pass, or a cached proxy result proves nothing.

## Rules

- CI owns installs, lint, type checks, tests, builds, browser setup, Rust,
  Helm rendering, and deploy checks. Do not run a heavy local `pnpm`, `bun`,
  `cargo`, `helm`, `docker`, or browser command by default.
- Drive stable user entry points. An internal setter, another route, or a
  mocked response does not stand in for the mapped feature.
- A missing path-filtered job is not a pass. Name the absent workflow and
  prerequisite.
- Label each result `verified`, `verified-unreachable`, `blocked`, or
  `pending`. Never turn a skipped or non-required check into `verified`.
- Keep credentials, cookies, keys, private webhook URLs, and response bodies
  that carry them out of commands, logs, and evidence.
- Expected UI state comes from [product-design](../product-design/SKILL.md);
  cloud, auth, and per-user boundaries from
  [cloud-saas-mode](../cloud-saas-mode/SKILL.md). Do not fix a UI proof by
  editing `components/ui/`.

## Drive

1. Map changed paths to a feature file:
   `git diff --name-only origin/main...HEAD`.
2. Read the CI result for the exact commit: `gh pr checks <PR> --watch=false`.
   Check the run's job list before deciding a surface was not exercised.
3. Drive the smallest mapped path that can fail for the claimed behaviour.
4. On failure, read `gh run view <RUN_ID> --job <JOB_ID> --log-failed` and
   quote the assertion, not an environment dump.
5. After a fix, re-run the same observation.

Post-deploy smoke uses the existing harness. Name the base URL, since the
default is production. CI injects `CHM_API_KEY_SECRET` for the authenticated
half; never copy it into a local shell or transcript:

```sh
cd apps/dashboard
bun scripts/verify-deploy.ts --base-url https://preview.dash.chmonitor.dev --skip-auth
```

Health endpoints differ: `/healthz` is static liveness, `/api/health` is the
minimal public check, `/api/healthz` is ClickHouse-gated readiness and may
return `503`. See [verify-production](../verify-production/SKILL.md).

A CLI proof uses `.cursor/skills/verify-chmonitor/scripts/` (`launch.sh`,
`doctor.sh`, `drive.sh`, `cleanup.sh`, `redact-check.sh`). It builds the Rust
binary, so run it only for a requested CLI proof, never to validate docs.

## Evidence

Record per feature: commit SHA, PR, workflow, job, and check status; the
entry point driven; expected and observed state; the log or artifact
location; the result label. A passing compile, lint, or unit test is evidence
for that check only.

Do not cancel shared workflows, kill processes by name, or change a hosted
connection to make a proof pass. Clean up only scratch state you created
(never the operator's `~/.config/chm`), and keep the proof artifacts.

Update the feature map and the knowledge doc together when a route, workflow,
or verification contract changes.

• README.md 2 KB
• SKILL.md 4 KB
• features/README.md 5 KB
• features/api-auth-security.md 5 KB
• features/custom-webhooks.md 5 KB
• features/dashboard-ui.md 4 KB
• features/deploy-cli.md 5 KB
• features/helm-gitops.md 4 KB
• features/peerdb.md 7 KB
• features/query-config.md 3 KB
• upstream/CHANGES.md 86 KB
• upstream/LICENSE 1 KB
• upstream/LICENSE-cursor-team-kit 1 KB
• upstream/NOTICE-skills.md 1 KB
• upstream/NOTICE.md 8 KB
• upstream/README.md 3 KB
• upstream/SOURCE.md 4 KB
• upstream/VERSION 1 KB
• upstream/manifest.sh 1 KB
• upstream/skills/architect/SKILL.md 8 KB
• upstream/skills/architect/references/design-red-flags.md 2 KB
• upstream/skills/architect/references/rationale-template.md 3 KB
• upstream/skills/architect/references/runner-prompt.md 3 KB
• upstream/skills/arena/SKILL.md 6 KB
• upstream/skills/automate-me/SKILL.md 7 KB
• upstream/skills/babysit/SKILL.md 4 KB
• upstream/skills/blast-radius/SKILL.md 4 KB
• upstream/skills/create-verification-skill/SKILL.md 6 KB
• upstream/skills/create-verification-skill/references/feature-map-example/README.md 3 KB
• upstream/skills/create-verification-skill/references/feature-map-example/create-note.md 3 KB
• upstream/skills/create-verification-skill/references/feature-map-example/search.md 3 KB
• upstream/skills/figure-it-out/SKILL.md 4 KB
• upstream/skills/how/SKILL.md 4 KB
• upstream/skills/how/references/explainer-prompt.md 3 KB
• upstream/skills/how/references/explorer-prompt.md 3 KB
• upstream/skills/interrogate/SKILL.md 6 KB
• upstream/skills/interrogate/references/code-quality-review.md 5 KB
• upstream/skills/interrogate/references/lead-judgment.md 3 KB
• upstream/skills/interrogate/references/reviewer-prompt.md 2 KB
• upstream/skills/interrogate/references/rubric.md 5 KB
• upstream/skills/maintain-verification-skill/SKILL.md 5 KB
• upstream/skills/no-comments/SKILL.md 3 KB
• upstream/skills/poteto-mode/SKILL.md 23 KB
• upstream/skills/poteto-mode/playbooks/authoring-a-skill.md 1 KB
• upstream/skills/poteto-mode/playbooks/autonomous-run.md 2 KB
• upstream/skills/poteto-mode/playbooks/autopilot-full.md 9 KB
• upstream/skills/poteto-mode/playbooks/autopilot-stack.md 6 KB
• upstream/skills/poteto-mode/playbooks/babysit.md 8 KB
• upstream/skills/poteto-mode/playbooks/bug-fix.md 2 KB
• upstream/skills/poteto-mode/playbooks/eval.md 3 KB
• upstream/skills/poteto-mode/playbooks/feature.md 3 KB
• upstream/skills/poteto-mode/playbooks/hillclimb.md 4 KB
• upstream/skills/poteto-mode/playbooks/investigation.md 1 KB
• upstream/skills/poteto-mode/playbooks/multi-phase-plan.md 13 KB
• upstream/skills/poteto-mode/playbooks/opening-a-pr.md 5 KB
• upstream/skills/poteto-mode/playbooks/orchestrate.md 17 KB
• upstream/skills/poteto-mode/playbooks/pause-safely.md 2 KB
• upstream/skills/poteto-mode/playbooks/perf-issue.md 3 KB
• upstream/skills/poteto-mode/playbooks/prototype.md 2 KB
• upstream/skills/poteto-mode/playbooks/refactoring.md 3 KB
• upstream/skills/poteto-mode/playbooks/runtime-forensics.md 1 KB
• upstream/skills/poteto-mode/playbooks/session-pickup.md 2 KB
• upstream/skills/poteto-mode/playbooks/shipping.md 7 KB
• upstream/skills/poteto-mode/playbooks/trace-forensics.md 2 KB
• upstream/skills/poteto-mode/playbooks/visual-parity.md 1 KB
• upstream/skills/poteto-mode/playbooks/worktree-cleanup.md 3 KB
• upstream/skills/poteto-mode/references/bugbot-triage.md 9 KB
• upstream/skills/poteto-mode/references/codex-tools.md 8 KB
• upstream/skills/poteto-mode/references/merge-safety.md 5 KB
• upstream/skills/poteto-mode/references/resume-storage.md 3 KB
• upstream/skills/poteto-mode/references/agents/comment-sicko.md 2 KB
• upstream/skills/poteto-mode/references/agents/poteto-agent.md 1 KB
• upstream/skills/poteto-mode/references/licenses/LICENSE 1 KB
• upstream/skills/poteto-mode/references/licenses/LICENSE-cursor-team-kit 1 KB
• upstream/skills/poteto-mode/references/licenses/NOTICE.md 1 KB
• upstream/skills/poteto-mode/scripts/bootstrap.ts 2 KB
• upstream/skills/poteto-mode/scripts/bun.lock 7 KB
• upstream/skills/poteto-mode/scripts/check-plan.mjs 8 KB
• upstream/skills/poteto-mode/scripts/package.json 1 KB
• upstream/skills/poteto-mode/scripts/resume.mjs 6 KB
• upstream/skills/poteto-mode/scripts/tsconfig.json 1 KB
• upstream/skills/poteto-mode/scripts/worktree-audit.sh 9 KB
• upstream/skills/poteto-mode/scripts/orch/frontier.ts 9 KB
• upstream/skills/poteto-mode/scripts/orch/orch.test.ts 22 KB
• upstream/skills/poteto-mode/scripts/orch/orch.ts 15 KB
• upstream/skills/poteto-mode/scripts/orch/status.ts 6 KB
• upstream/skills/poteto-mode/scripts/orch/store.ts 25 KB
• upstream/skills/poteto-mode/scripts/orch/types.ts 5 KB
• upstream/skills/poteto-mode/scripts/watch-pr/cli.test.ts 6 KB
• upstream/skills/poteto-mode/scripts/watch-pr/cli.ts 8 KB
• upstream/skills/poteto-mode/scripts/watch-pr/deadline.ts 1 KB
• upstream/skills/poteto-mode/scripts/watch-pr/fakes.test-helper.ts 3 KB
• upstream/skills/poteto-mode/scripts/watch-pr/github.test.ts 11 KB
• upstream/skills/poteto-mode/scripts/watch-pr/github.ts 30 KB
• upstream/skills/poteto-mode/scripts/watch-pr/integrity.test.ts 10 KB
• upstream/skills/poteto-mode/scripts/watch-pr/landing.ts 2 KB
• upstream/skills/poteto-mode/scripts/watch-pr/policy.test.ts 14 KB
• upstream/skills/poteto-mode/scripts/watch-pr/policy.ts 26 KB
• upstream/skills/poteto-mode/scripts/watch-pr/render.ts 7 KB
• upstream/skills/poteto-mode/scripts/watch-pr/ship-pr 1 KB
• upstream/skills/poteto-mode/scripts/watch-pr/shipping-cli.test.ts 4 KB
• upstream/skills/poteto-mode/scripts/watch-pr/shipping-cli.ts 2 KB
• upstream/skills/poteto-mode/scripts/watch-pr/shipping.test.ts 8 KB
• upstream/skills/poteto-mode/scripts/watch-pr/shipping.ts 6 KB
• upstream/skills/poteto-mode/scripts/watch-pr/transport.test.ts 5 KB
• upstream/skills/poteto-mode/scripts/watch-pr/tsconfig.json 1 KB
• upstream/skills/poteto-mode/scripts/watch-pr/types.compile.ts 2 KB
• upstream/skills/poteto-mode/scripts/watch-pr/types.ts 13 KB
• upstream/skills/poteto-mode/scripts/watch-pr/watch-pr 1 KB
• upstream/skills/poteto-mode/scripts/watch-pr/wrapper.test.ts 1 KB
• upstream/skills/principle-attack-the-premise/SKILL.md 1 KB
• upstream/skills/principle-build-the-lever/SKILL.md 2 KB
• upstream/skills/principle-encode-lessons-in-structure/SKILL.md 2 KB
• upstream/skills/principle-exhaust-the-design-space/SKILL.md 1 KB
• upstream/skills/principle-fix-root-causes/SKILL.md 1 KB
• upstream/skills/principle-guard-the-context-window/SKILL.md 1 KB
• upstream/skills/principle-laziness-protocol/SKILL.md 1 KB
• upstream/skills/principle-make-operations-idempotent/SKILL.md 1 KB
• upstream/skills/principle-migrate-callers-then-delete-legacy-apis/SKILL.md 1 KB
• upstream/skills/principle-minimize-reader-load/SKILL.md 2 KB
• upstream/skills/principle-model-the-domain/SKILL.md 2 KB
• upstream/skills/principle-never-block-on-the-human/SKILL.md 1 KB
• upstream/skills/principle-prove-it-works/SKILL.md 2 KB
• upstream/skills/principle-redesign-from-first-principles/SKILL.md 1 KB
• upstream/skills/principle-subtract-before-you-add/SKILL.md 1 KB
• upstream/skills/principle-test-behavior-not-implementation/SKILL.md 2 KB
• upstream/skills/principle-type-system-discipline/SKILL.md 5 KB
• upstream/skills/recall/SKILL.md 6 KB
• upstream/skills/reflect/SKILL.md 7 KB
• upstream/skills/reflect/references/divergent-reviewer.md 4 KB
• upstream/skills/reflect/references/judgment-reviewer.md 3 KB
• upstream/skills/reflect/references/synthesizer.md 4 KB
• upstream/skills/reflect/references/tooling-reviewer.md 5 KB
• upstream/skills/reflect/scripts/find-transcript.mjs 3 KB
• upstream/skills/setup-pstack/SKILL.md 9 KB
• upstream/skills/show-me-your-work/SKILL.md 6 KB
• upstream/skills/show-me-your-work/references/decision-log-template.tsv 1 KB
• upstream/skills/show-me-your-work/scripts/log.sh 1 KB
• upstream/skills/swarm/SKILL.md 4 KB
• upstream/skills/teach/SKILL.md 6 KB
• upstream/skills/technical-writing/SKILL.md 10 KB
• upstream/skills/typescript-best-practices/SKILL.md 3 KB
• upstream/skills/typescript-best-practices/references/patterns.md 9 KB
• upstream/skills/unslop/SKILL.md 6 KB
• upstream/skills/why/SKILL.md 12 KB
• upstream/skills/why/references/epistemics.md 9 KB
• upstream/skills/why/references/investigator-prompt.md 7 KB
• upstream/skills/why/references/source-playbook.md 1 KB
• upstream/skills/why/references/synthesizer-prompt.md 8 KB
• upstream/skills/why/references/sources/code-archaeology.md 3 KB
• upstream/skills/why/references/sources/databricks.md 7 KB
• upstream/skills/why/references/sources/datadog.md 5 KB
• upstream/skills/why/references/sources/incident-postmortem.md 2 KB
• upstream/skills/why/references/sources/linear.md 3 KB
• upstream/skills/why/references/sources/notion.md 3 KB
• upstream/skills/why/references/sources/sentry.md 5 KB
• upstream/skills/why/references/sources/slack.md 3 KB