memento-mori-jester 0.1.88 → 0.1.89

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -4,6 +4,12 @@ All notable changes to Memento Mori Jester are tracked here.
4
4
 
5
5
  ## Unreleased
6
6
 
7
+ ## 0.1.89
8
+
9
+ - Added a report-gallery feedback issue template for public-safe reports about confusing or stale checked examples, and strengthened false-positive reports with version and redacted `doctor --json` prompts.
10
+ - Added `examples/reports/feedback-template.md` and `npm run support:check` so adopter feedback requests stay redacted, useful, and aligned with the gallery.
11
+ - Updated README, report docs, maintainer triage docs, release docs, production-readiness docs, roadmap, and release notes for the support path.
12
+
7
13
  ## 0.1.88
8
14
 
9
15
  - Added `examples/reports`, a small checked report gallery for fresh `doctor`, destructive-command `summary`, and full blocked-command review output.
package/README.md CHANGED
@@ -74,6 +74,8 @@ Maintainers can prove that fresh-project path with [examples/consumer-quickstart
74
74
 
75
75
  For trust-building output examples, see [examples/reports](examples/reports). `npm run reports:check` installs the package into a temporary project and proves the gallery's `doctor`, `summary`, and blocked-command reports stay current.
76
76
 
77
+ If one of those reports is confusing or stale, use the public-safe [report gallery feedback template](examples/reports/feedback-template.md). It asks for version, nearest gallery example, sanitized command/output summaries, and redacted diagnostics without private repo code or secrets.
78
+
77
79
  Expected vibe:
78
80
 
79
81
  ```text
@@ -445,6 +447,7 @@ More setup examples:
445
447
  - [Adoption Smoke CI](examples/ci/adoption-smoke.yml)
446
448
  - [Consumer Quickstart Smoke](examples/consumer-quickstart)
447
449
  - [Real-World Report Gallery](examples/reports)
450
+ - [Report Gallery Feedback Template](examples/reports/feedback-template.md)
448
451
  - [Security Policy](SECURITY.md)
449
452
  - [Maintainer Triage](docs/MAINTAINER_TRIAGE.md)
450
453
  - [Changelog](CHANGELOG.md)
@@ -465,6 +468,7 @@ Framework CI examples:
465
468
  - [Adoption Smoke CI](examples/ci/adoption-smoke.yml)
466
469
  - [Consumer Quickstart Smoke](examples/consumer-quickstart)
467
470
  - [Real-World Report Gallery](examples/reports)
471
+ - [Report Gallery Feedback Template](examples/reports/feedback-template.md)
468
472
  - [Next.js CI](examples/ci/nextjs.yml)
469
473
  - [Vite React CI](examples/ci/vite-react.yml)
470
474
  - [Express API CI](examples/ci/express-api.yml)
@@ -521,6 +525,7 @@ Maintainers can use [docs/MAINTAINER_TRIAGE.md](docs/MAINTAINER_TRIAGE.md) to tu
521
525
  Run `npm run fixtures:check` before merging fixture changes; it catches duplicate IDs, missing rule metadata, weak descriptions, unsafe-looking content, and duplicate content.
522
526
  Run `npm run fixtures:report` to see fixture coverage by rule, rule family, preset slice, kind, verdict, quiet-pass boundaries, feasible pass-case gaps, and curation-next guidance before choosing the next fixture. Use `npm run fixtures:report -- --markdown` when you want a paste-ready summary for release notes or GitHub issues.
523
527
  Run `npm run reports:check` after editing [examples/reports](examples/reports); it verifies the public report gallery against an installed package in a temporary consumer project.
528
+ Run `npm run support:check` after editing issue templates, support docs, or the report gallery feedback path; it verifies the public report template asks for useful redacted context without inviting secrets or private code.
524
529
  Run `npm run promo:card` to regenerate the repo-local social preview card after changing its copy or design.
525
530
  Run `npm run promo:check` after editing promo assets; it checks the current demo video, stills, docs, and fixture evidence numbers stay in sync.
526
531
  Run `npm run site:check` after editing the repo-local landing page; it verifies the start command, demo links, social card, repo, release, and npm links.
package/ROADMAP.md CHANGED
@@ -6,6 +6,7 @@ Memento Mori Jester is usable today as a CLI, MCP server, GitHub Action, and git
6
6
 
7
7
  ## Recently Shipped
8
8
 
9
+ - Checked adopter feedback path in v0.1.89, adding a report-gallery issue template, package-shipped feedback template, and support triage guard.
9
10
  - Checked report gallery in v0.1.88, proving fresh `doctor`, destructive-command `summary`, and blocked-command reports from an installed consumer project.
10
11
  - Consumer quickstart registry-mode fix in v0.1.87, proving the same smoke against `memento-mori-jester@latest` after publish.
11
12
  - Consumer quickstart smoke in v0.1.86, proving the first installed-project commands from a minimal repo before release.
@@ -78,7 +79,7 @@ Memento Mori Jester is usable today as a CLI, MCP server, GitHub Action, and git
78
79
  ## Product Ideas
79
80
 
80
81
  - Collect real-world reports and fold the strongest redacted cases into more framework tuning cookbook recipes.
81
- - Add a small fixture issue template checklist that asks for the nearest framework tuning cookbook recipe and redacted `jester tune <rule-id> --json` output.
82
+ - Turn repeated report-gallery feedback into clearer gallery examples or redacted fixtures.
82
83
  - Add a hosted-page option or GitHub Pages instructions once the static page has settled.
83
84
 
84
85
  ## Quality And Safety
@@ -19,6 +19,8 @@ npx -y memento-mori-jester@latest tune <rule-id> --json
19
19
 
20
20
  For users who just need to understand what a healthy report looks like, point them at the checked [report gallery](../examples/reports). Maintainers can run `npm run reports:check` to prove those examples still match the current package output.
21
21
 
22
+ For users who say a gallery report is confusing, stale, or hard to compare with their local output, point them at [examples/reports/feedback-template.md](../examples/reports/feedback-template.md) or the GitHub [report gallery feedback issue template](../.github/ISSUE_TEMPLATE/report_gallery_feedback.yml). It asks for the nearest checked example, sanitized command and output summaries, version, and redacted diagnostics without asking for private code.
23
+
22
24
  Do not ask users to paste secrets, private code, customer data, live credentials, complete CI logs, or unredacted SARIF. If the report involves credential exposure, command execution, unexpected network access, private code disclosure, package publishing, or MCP data exposure, route it through [SECURITY.md](../SECURITY.md).
23
25
 
24
26
  ## Triage Labels
@@ -46,6 +48,22 @@ Use a small, boring label vocabulary:
46
48
 
47
49
  If the user has a safe example that should pass, prefer adding a pass or quiet-pass fixture before loosening a rule. If the example should still caution but the wording is confusing, update the rule guidance or docs instead of changing matching behavior.
48
50
 
51
+ ## Report Gallery Feedback
52
+
53
+ Use report-gallery feedback when the issue is about understanding installed-package output, not changing a rule. Good outcomes are:
54
+
55
+ - a clearer gallery explanation,
56
+ - a new stable output fragment in `report-gallery.json`,
57
+ - a small docs update,
58
+ - or a redacted fixture only if the report exposes a reusable rule boundary.
59
+
60
+ After editing report support docs or issue templates, run:
61
+
62
+ ```powershell
63
+ npm.cmd run support:check
64
+ npm.cmd run reports:check
65
+ ```
66
+
49
67
  ## Converting Reports Into Fixtures
50
68
 
51
69
  Add a fixture when the report is minimal, redacted, realistic, and captures a rule behavior worth preserving.
@@ -46,7 +46,7 @@ This checklist defines what "production grade" means for Memento Mori Jester rig
46
46
 
47
47
  - `README.md` leads with a no-write first run, project bootstrap, agent setup, and optional hooks/CI.
48
48
  - `docs/GETTING_STARTED.md`, `docs/CLI.md`, `docs/RELEASE.md`, and `docs/TRUSTED_PUBLISHING.md` cover the core adoption and release paths.
49
- - `examples/reports` provides checked, public-safe report examples for fresh install diagnostics, summary output, and blocked command reviews.
49
+ - `examples/reports` provides checked, public-safe report examples for fresh install diagnostics, summary output, blocked command reviews, and report-gallery feedback.
50
50
  - `site/index.html` gives maintainers a static one-page share surface that reuses the demo, social card, start command, and public links.
51
51
  - Every public release has matching `CHANGELOG.md` notes and `docs/RELEASE_NOTES_vX.Y.Z.md`.
52
52
 
@@ -56,7 +56,7 @@ This checklist defines what "production grade" means for Memento Mori Jester rig
56
56
  - `jester doctor --json`, `jester config validate`, and `jester rules` are the first troubleshooting commands.
57
57
  - `jester tune`, `jester tune coverage`, and the fixture suite give maintainers a way to inspect noisy rules before changing defaults.
58
58
  - [FRAMEWORK_TUNING.md](FRAMEWORK_TUNING.md) maps common stack-specific false-positive reports to the relevant `jester tune <rule-id>` evidence and fixture IDs, while [examples/tuning](../examples/tuning) provides checked copy-paste recipes.
59
- - GitHub issue templates collect bug reports, false-positive reports, and feature requests with the diagnostic context maintainers need.
59
+ - GitHub issue templates collect bug reports, false-positive reports, report-gallery feedback, and feature requests with the diagnostic context maintainers need.
60
60
  - `SECURITY.md` routes vulnerability reports away from public issues and asks for redacted diagnostics.
61
61
  - `docs/MAINTAINER_TRIAGE.md` explains how to turn useful false-positive reports into fixture coverage before changing rule logic.
62
62
  - `npm run fixtures:check` validates fixture IDs, metadata, unsafe-looking content, duplicate content, and explicit expected/absent rule intent.
@@ -65,6 +65,7 @@ This checklist defines what "production grade" means for Memento Mori Jester rig
65
65
  - `npm run framework:tuning:doctor` runs the cookbook tune commands through the built CLI with temporary preset configs, so package consumers do not inherit stale recipes.
66
66
  - `npm run consumer:quickstart:check` installs the package into a temporary minimal project and runs `doctor`, `summary`, and packaged framework tuning checks from that consumer side.
67
67
  - `npm run reports:check` installs the package into a temporary minimal project and runs the report gallery's `doctor`, `summary`, and blocked-command examples through that consumer side.
68
+ - `npm run support:check` verifies issue templates, support docs, and the report gallery feedback template stay public-safe and ask for useful redacted context.
68
69
  - `npm run promo:card` regenerates the deterministic social preview card, and `npm run promo:check` verifies current repo-local promo assets against the current fixture evidence before maintainers post or refresh the demo.
69
70
  - `npm run site:check` verifies the static landing page before maintainers post or host it.
70
71
  - npm publish has a manual workflow fallback, but the normal release path is tag-driven trusted publishing.
@@ -87,6 +88,7 @@ This checklist defines what "production grade" means for Memento Mori Jester rig
87
88
  - CI adoption example checks are wired into `npm test`.
88
89
  - consumer quickstart smoke checks are wired into `npm test`.
89
90
  - report gallery checks are wired into `npm test`.
91
+ - support triage checks are wired into `npm test`.
90
92
  - promo freshness checks are wired into `npm test`.
91
93
  - site checks are wired into `npm test`.
92
94
 
@@ -95,4 +97,4 @@ This checklist defines what "production grade" means for Memento Mori Jester rig
95
97
  ## Known Next Gaps
96
98
 
97
99
  - Continue expanding real-world preset fixtures and false-positive examples so tuning remains evidence-based.
98
- - Add more framework-specific false-positive examples as people report real noisy cases.
100
+ - Fold the strongest redacted support reports into fixture or report-gallery updates.
package/docs/RELEASE.md CHANGED
@@ -17,6 +17,7 @@ npm.cmd run framework:tuning:doctor
17
17
  npm.cmd run ci:adoption:check
18
18
  npm.cmd run consumer:quickstart:check
19
19
  npm.cmd run reports:check
20
+ npm.cmd run support:check
20
21
  npm.cmd run promo:card:check
21
22
  npm.cmd run promo:check
22
23
  npm.cmd run site:check
@@ -29,7 +30,7 @@ Move the current changelog bullets into a matching version section and add `docs
29
30
  ## 2. Tag And Push
30
31
 
31
32
  ```powershell
32
- git add package.json package-lock.json CHANGELOG.md docs/RELEASE_NOTES_v0.1.x.md docs/PRODUCTION_READINESS.md docs/MAINTAINER_TRIAGE.md docs/FRAMEWORK_TUNING.md docs/GITHUB_ACTIONS.md examples/ci examples/consumer-quickstart examples/reports examples/tuning scripts/check-ci-adoption.mjs scripts/check-consumer-quickstart.mjs scripts/check-report-gallery.mjs scripts/check-framework-tuning.mjs scripts/doctor-framework-tuning.mjs SECURITY.md .github/ISSUE_TEMPLATE
33
+ git add package.json package-lock.json CHANGELOG.md docs/RELEASE_NOTES_v0.1.x.md docs/PRODUCTION_READINESS.md docs/MAINTAINER_TRIAGE.md docs/FRAMEWORK_TUNING.md docs/GITHUB_ACTIONS.md examples/ci examples/consumer-quickstart examples/reports examples/tuning scripts/check-ci-adoption.mjs scripts/check-consumer-quickstart.mjs scripts/check-report-gallery.mjs scripts/check-support-triage.mjs scripts/check-framework-tuning.mjs scripts/doctor-framework-tuning.mjs SECURITY.md .github/ISSUE_TEMPLATE
33
34
  git commit -m "Release v0.1.x"
34
35
  git tag -a v0.1.x -m "Memento Mori Jester v0.1.x"
35
36
  git push origin main
@@ -87,6 +88,7 @@ npx.cmd -y memento-mori-jester@latest config init --preset security --path jeste
87
88
  npx.cmd -y memento-mori-jester@latest config validate --config jester-security.config.json
88
89
  npm.cmd run consumer:quickstart:check -- --package memento-mori-jester@latest
89
90
  npm.cmd run reports:check -- --package memento-mori-jester@latest
91
+ npm.cmd run support:check
90
92
  ```
91
93
 
92
94
  ## 4. MCP Copy-Paste
@@ -0,0 +1,60 @@
1
+ # Memento Mori Jester v0.1.89
2
+
3
+ ## Summary
4
+
5
+ This release adds a checked adopter feedback path for real-world report-gallery results. The goal is to make support reports easier to act on without asking users to paste secrets, private code, customer data, full CI logs, or private paths.
6
+
7
+ ## What Changed
8
+
9
+ - Added `.github/ISSUE_TEMPLATE/report_gallery_feedback.yml`.
10
+ - Strengthened `.github/ISSUE_TEMPLATE/false_positive.yml` with package version and optional redacted `doctor --json` fields.
11
+ - Added `examples/reports/feedback-template.md`.
12
+ - Added `scripts/check-support-triage.mjs`.
13
+ - Added `npm run support:check` and wired it into `npm test`.
14
+ - Updated README, report gallery docs, maintainer triage docs, release docs, production-readiness docs, roadmap, and changelog.
15
+
16
+ ## Public Interface
17
+
18
+ - No CLI command changes.
19
+ - No MCP tool changes.
20
+ - No config schema changes.
21
+ - No review rule, scoring, matching, or verdict behavior changes.
22
+ - No GitHub Action input changes.
23
+ - New maintainer/package script: `npm run support:check`.
24
+ - New public support path: report-gallery feedback template and issue form.
25
+
26
+ ## Release Validation
27
+
28
+ ```powershell
29
+ npm.cmd test
30
+ npm.cmd run support:check
31
+ npm.cmd run reports:check
32
+ npm.cmd run demo:svg:check
33
+ npm.cmd run promo:card:check
34
+ npm.cmd run promo:check
35
+ npm.cmd run fixtures:report
36
+ npm.cmd run fixtures:report -- --json
37
+ npm.cmd run fixtures:report -- --markdown
38
+ npm.cmd run pack:dry
39
+ git diff --check
40
+ node .\dist\cli.js doctor
41
+ node .\dist\cli.js summary --kind command "git reset --hard"
42
+ git diff | node .\dist\cli.js diff --fail-on block --subject "v0.1.89 checked support triage"
43
+ ```
44
+
45
+ Expected:
46
+
47
+ - `support:check` verifies report-gallery feedback docs, issue templates, and privacy prompts.
48
+ - `reports:check` still verifies the installed-package report gallery.
49
+ - fixture report still shows `Fixtures: 222`.
50
+ - GitHub Release and npm Publish complete from the `v0.1.89` tag.
51
+
52
+ After publish:
53
+
54
+ ```powershell
55
+ npm.cmd view memento-mori-jester version --silent
56
+ npx.cmd -y memento-mori-jester@latest doctor
57
+ npx.cmd -y memento-mori-jester@latest summary --kind command "git reset --hard"
58
+ npm.cmd run support:check
59
+ npm.cmd run reports:check -- --package memento-mori-jester@latest
60
+ ```
@@ -23,3 +23,15 @@ npm run reports:check -- --package memento-mori-jester@latest
23
23
  ```
24
24
 
25
25
  When turning a real issue into a gallery entry, keep the example minimal and redacted. If the report needs private context, route it through [SECURITY.md](../../SECURITY.md) or keep it out of the public repo.
26
+
27
+ ## Reporting Surprising Output
28
+
29
+ If a report-gallery example is confusing, stale, or does not match what you see from `memento-mori-jester@latest`, use the public-safe [feedback template](feedback-template.md) or the GitHub [report gallery feedback issue template](../../.github/ISSUE_TEMPLATE/report_gallery_feedback.yml).
30
+
31
+ The useful public details are the package version, nearest gallery example, a sanitized command summary, a few relevant output lines, and redacted `doctor --json` output. Do not paste secrets, private repository code, customer data, full CI logs, unredacted SARIF, or private paths.
32
+
33
+ Maintainers can keep this support path aligned with:
34
+
35
+ ```powershell
36
+ npm run support:check
37
+ ```
@@ -0,0 +1,54 @@
1
+ # Report Gallery Feedback Template
2
+
3
+ Use this template when a report-gallery example is confusing, stale, or missing context. Keep reports public-safe and minimal so maintainers can turn useful feedback into docs, fixtures, or a narrow code change.
4
+
5
+ The checked examples are:
6
+
7
+ - `fresh-install-doctor`
8
+ - `destructive-command-summary`
9
+ - `blocked-command-review`
10
+
11
+ ## Commands To Run
12
+
13
+ ```powershell
14
+ npx -y memento-mori-jester@latest doctor --json
15
+ npx -y memento-mori-jester@latest summary --kind command "git reset --hard"
16
+ ```
17
+
18
+ For false-positive or noisy-rule reports, also run:
19
+
20
+ ```powershell
21
+ npx -y memento-mori-jester@latest tune <rule-id> --json
22
+ ```
23
+
24
+ ## Public Issue Draft
25
+
26
+ ```text
27
+ Jester version:
28
+ Install method: npx / global / local checkout / GitHub Action / git hook
29
+ Nearest report-gallery example: fresh-install-doctor / destructive-command-summary / blocked-command-review / none
30
+
31
+ Sanitized command or workflow step:
32
+
33
+ Sanitized output summary:
34
+
35
+ Expected behavior or clearer wording:
36
+
37
+ Relevant redacted doctor --json fields:
38
+
39
+ Relevant redacted tune output, if this is a noisy rule:
40
+
41
+ ```
42
+
43
+ ## Privacy Checklist
44
+
45
+ - Do not include secrets, tokens, private keys, customer data, or private repository code.
46
+ - Do not include full CI logs, unredacted SARIF, live credentials, or exploitable security details.
47
+ - Replace private paths and names with placeholders such as `<repo>`, `<path>`, `<service>`, or `<redacted>`.
48
+ - If the report involves credential exposure, command execution risk, package publishing, MCP data exposure, or private code disclosure, use [SECURITY.md](../../SECURITY.md) instead of a public issue.
49
+
50
+ Maintainers can validate this support path with:
51
+
52
+ ```powershell
53
+ npm run support:check
54
+ ```
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "memento-mori-jester",
3
- "version": "0.1.88",
3
+ "version": "0.1.89",
4
4
  "description": "A local court-jester sidecar for AI coding agents: review plans, commands, diffs, and final claims before they get too pleased with themselves.",
5
5
  "type": "module",
6
6
  "repository": {
@@ -40,7 +40,7 @@
40
40
  "build": "tsc -p tsconfig.json",
41
41
  "start": "node dist/server.js",
42
42
  "start:mcp": "node dist/server.js",
43
- "test": "npm run build && node scripts/run-tests.mjs && npm run fixtures:check && npm run fixtures:report && npm run framework:tuning:check && npm run framework:tuning:doctor && npm run ci:adoption:check && npm run consumer:quickstart:check && npm run reports:check && npm run promo:check && npm run site:check && npm run production:check",
43
+ "test": "npm run build && node scripts/run-tests.mjs && npm run fixtures:check && npm run fixtures:report && npm run framework:tuning:check && npm run framework:tuning:doctor && npm run ci:adoption:check && npm run consumer:quickstart:check && npm run reports:check && npm run support:check && npm run promo:check && npm run site:check && npm run production:check",
44
44
  "doctor": "node dist/cli.js doctor",
45
45
  "demo:svg": "node scripts/render-demo-svg.mjs",
46
46
  "demo:svg:check": "node scripts/render-demo-svg.mjs --check",
@@ -51,6 +51,7 @@
51
51
  "ci:adoption:check": "node scripts/check-ci-adoption.mjs",
52
52
  "consumer:quickstart:check": "node scripts/check-consumer-quickstart.mjs",
53
53
  "reports:check": "node scripts/check-report-gallery.mjs",
54
+ "support:check": "node scripts/check-support-triage.mjs",
54
55
  "promo:card": "node scripts/render-social-card.mjs",
55
56
  "promo:card:check": "node scripts/render-social-card.mjs --check",
56
57
  "promo:check": "node scripts/check-promo-freshness.mjs",
@@ -73,10 +73,12 @@ for (const path of [
73
73
  "scripts/check-ci-adoption.mjs",
74
74
  "scripts/check-consumer-quickstart.mjs",
75
75
  "scripts/check-report-gallery.mjs",
76
+ "scripts/check-support-triage.mjs",
76
77
  "scripts/check-fixtures.mjs",
77
78
  "scripts/report-fixtures.mjs",
78
79
  ".github/ISSUE_TEMPLATE/bug_report.yml",
79
80
  ".github/ISSUE_TEMPLATE/false_positive.yml",
81
+ ".github/ISSUE_TEMPLATE/report_gallery_feedback.yml",
80
82
  ".github/ISSUE_TEMPLATE/feature_request.yml",
81
83
  ".github/ISSUE_TEMPLATE/config.yml",
82
84
  ".github/workflows/ci.yml",
@@ -89,6 +91,7 @@ for (const path of [
89
91
  "examples/consumer-quickstart/README.md",
90
92
  "examples/consumer-quickstart/package.json",
91
93
  "examples/reports/README.md",
94
+ "examples/reports/feedback-template.md",
92
95
  "examples/reports/report-gallery.json",
93
96
  "examples/presets/README.md",
94
97
  "examples/tuning/README.md",
@@ -117,6 +120,8 @@ requireText("README.md", /examples\/tuning/, "framework tuning cookbook link");
117
120
  requireText("README.md", /adoption-smoke\.yml/, "adoption smoke CI link");
118
121
  requireText("README.md", /consumer-quickstart/, "consumer quickstart smoke link");
119
122
  requireText("README.md", /examples\/reports/, "report gallery link");
123
+ requireText("README.md", /feedback-template\.md/, "report gallery feedback template link");
124
+ requireText("README.md", /report gallery feedback/i, "report gallery feedback guidance");
120
125
  requireText("README.md", /License: PolyForm Noncommercial/, "the noncommercial license badge");
121
126
  requireText("docs/PRODUCTION_READINESS.md", /npm package/i, "npm package readiness");
122
127
  requireText("docs/PRODUCTION_READINESS.md", /GitHub Action/i, "GitHub Action readiness");
@@ -135,6 +140,7 @@ requireText("docs/PRODUCTION_READINESS.md", /framework:tuning:doctor/, "framewor
135
140
  requireText("docs/PRODUCTION_READINESS.md", /adoption-smoke\.yml/, "adoption smoke CI readiness");
136
141
  requireText("docs/PRODUCTION_READINESS.md", /consumer:quickstart:check/, "consumer quickstart smoke readiness");
137
142
  requireText("docs/PRODUCTION_READINESS.md", /reports:check/, "report gallery readiness");
143
+ requireText("docs/PRODUCTION_READINESS.md", /support:check/, "support triage readiness");
138
144
  requireText("docs/PRODUCTION_READINESS.md", /quiet-pass/, "quiet-pass fixture readiness");
139
145
  requireText("docs/CLI.md", /jester doctor --json/, "doctor JSON CLI docs");
140
146
  requireText("docs/CLI.md", /quiet-pass fixture/, "quiet-pass fixture CLI docs");
@@ -156,6 +162,9 @@ requireText("docs/MAINTAINER_TRIAGE.md", /tune <rule-id> --json/, "tune JSON tri
156
162
  requireText("docs/MAINTAINER_TRIAGE.md", /preset-review-cases\.json/, "fixture suite link");
157
163
  requireText("docs/MAINTAINER_TRIAGE.md", /expectedRuleIds/, "fixture expected rule guidance");
158
164
  requireText("docs/MAINTAINER_TRIAGE.md", /absentRuleIds/, "fixture absent rule guidance");
165
+ requireText("docs/MAINTAINER_TRIAGE.md", /feedback-template\.md/, "report gallery feedback template link");
166
+ requireText("docs/MAINTAINER_TRIAGE.md", /report_gallery_feedback\.yml/, "report gallery issue template link");
167
+ requireText("docs/MAINTAINER_TRIAGE.md", /support:check/, "support triage check guidance");
159
168
  requireText("examples/fixtures/README.md", /MAINTAINER_TRIAGE\.md/, "maintainer triage link");
160
169
  requireText("examples/fixtures/README.md", /Adding A Fixture From A Report/, "fixture report conversion guidance");
161
170
  requireText("examples/fixtures/README.md", /fixtures:check/, "fixture authoring check guidance");
@@ -170,10 +179,18 @@ requireText("examples/consumer-quickstart/README.md", /npm run consumer:quicksta
170
179
  requireText("examples/consumer-quickstart/package.json", /jester:summary/, "consumer quickstart summary script");
171
180
  requireText("examples/consumer-quickstart/package.json", /framework:tuning:doctor/, "consumer quickstart tuning doctor script");
172
181
  requireText("examples/reports/README.md", /report-gallery\.json/, "report gallery JSON link");
182
+ requireText("examples/reports/README.md", /feedback-template\.md/, "report gallery feedback template link");
183
+ requireText("examples/reports/README.md", /report_gallery_feedback\.yml/, "report gallery issue template link");
173
184
  requireText("examples/reports/README.md", /npm run reports:check/, "report gallery check command");
185
+ requireText("examples/reports/README.md", /npm run support:check/, "support triage check command");
174
186
  requireText("examples/reports/report-gallery.json", /fresh-install-doctor/, "fresh install doctor report");
175
187
  requireText("examples/reports/report-gallery.json", /destructive-command-summary/, "destructive command summary report");
176
188
  requireText("examples/reports/report-gallery.json", /blocked-command-review/, "blocked command review report");
189
+ requireText("examples/reports/feedback-template.md", /doctor --json/, "feedback template doctor diagnostics");
190
+ requireText("examples/reports/feedback-template.md", /summary --kind command "git reset --hard"/, "feedback template summary diagnostics");
191
+ requireText("examples/reports/feedback-template.md", /tune <rule-id> --json/, "feedback template tune diagnostics");
192
+ requireText("examples/reports/feedback-template.md", /Privacy Checklist/, "feedback template privacy checklist");
193
+ requireText("examples/reports/feedback-template.md", /SECURITY\.md/, "feedback template security redirect");
177
194
  requireText("examples/tuning/README.md", /framework-tuning-cookbook\.json/, "framework tuning cookbook JSON link");
178
195
  requireText("examples/tuning/README.md", /framework:tuning:doctor/, "framework tuning doctor guidance");
179
196
  requireText("examples/tuning/README.md", /jester tune <rule-id> --json|jester tune [a-z0-9-]+ --json/, "framework tuning command guidance");
@@ -204,6 +221,9 @@ requireText("scripts/check-consumer-quickstart.mjs", /framework:tuning:doctor/,
204
221
  requireText("scripts/check-report-gallery.mjs", /report-gallery\.json/, "report gallery checker target");
205
222
  requireText("scripts/check-report-gallery.mjs", /memento-mori-jester@latest/, "report gallery registry verification option");
206
223
  requireText("scripts/check-report-gallery.mjs", /destructive-command-summary/, "report gallery summary guard");
224
+ requireText("scripts/check-support-triage.mjs", /report_gallery_feedback\.yml/, "support triage issue template guard");
225
+ requireText("scripts/check-support-triage.mjs", /feedback-template\.md/, "support triage feedback template guard");
226
+ requireText("scripts/check-support-triage.mjs", /unsafeContentPatterns/, "support triage unsafe content checks");
207
227
  requireText("package.json", /"fixtures:check": "node scripts\/check-fixtures\.mjs"/, "fixture authoring check script");
208
228
  requireText("package.json", /"fixtures:report": "node scripts\/report-fixtures\.mjs"/, "fixture coverage report script");
209
229
  requireText("package.json", /"framework:tuning:check": "node scripts\/check-framework-tuning\.mjs"/, "framework tuning cookbook check script");
@@ -211,6 +231,7 @@ requireText("package.json", /"framework:tuning:doctor": "node scripts\/doctor-fr
211
231
  requireText("package.json", /"ci:adoption:check": "node scripts\/check-ci-adoption\.mjs"/, "CI adoption check script");
212
232
  requireText("package.json", /"consumer:quickstart:check": "node scripts\/check-consumer-quickstart\.mjs"/, "consumer quickstart check script");
213
233
  requireText("package.json", /"reports:check": "node scripts\/check-report-gallery\.mjs"/, "report gallery check script");
234
+ requireText("package.json", /"support:check": "node scripts\/check-support-triage\.mjs"/, "support triage check script");
214
235
  requireText("package.json", /"promo:card": "node scripts\/render-social-card\.mjs"/, "social card render script");
215
236
  requireText("package.json", /"promo:card:check": "node scripts\/render-social-card\.mjs --check"/, "social card stale check script");
216
237
  requireText("package.json", /"promo:check": "node scripts\/check-promo-freshness\.mjs"/, "promo freshness check script");
@@ -222,6 +243,7 @@ requireText("package.json", /npm run framework:tuning:doctor/, "framework tuning
222
243
  requireText("package.json", /npm run ci:adoption:check/, "CI adoption check in npm test");
223
244
  requireText("package.json", /npm run consumer:quickstart:check/, "consumer quickstart check in npm test");
224
245
  requireText("package.json", /npm run reports:check/, "report gallery check in npm test");
246
+ requireText("package.json", /npm run support:check/, "support triage check in npm test");
225
247
  requireText("package.json", /npm run promo:check/, "promo freshness check in npm test");
226
248
  requireText("package.json", /npm run site:check/, "site check in npm test");
227
249
  requireText("scripts/check-promo-freshness.mjs", /--require-package-version/, "optional strict package-version promo check");
@@ -235,6 +257,13 @@ requireText(".github/ISSUE_TEMPLATE/bug_report.yml", /doctor --json/, "doctor JS
235
257
  requireText(".github/ISSUE_TEMPLATE/bug_report.yml", /SECURITY\.md|security policy/i, "security redirect");
236
258
  requireText(".github/ISSUE_TEMPLATE/false_positive.yml", /jester tune <rule-id> --json/, "tune JSON prompt");
237
259
  requireText(".github/ISSUE_TEMPLATE/false_positive.yml", /false-positive|noisy rule/i, "false-positive scope");
260
+ requireText(".github/ISSUE_TEMPLATE/false_positive.yml", /Jester version/, "false-positive version prompt");
261
+ requireText(".github/ISSUE_TEMPLATE/false_positive.yml", /doctor --json/, "false-positive doctor diagnostics");
262
+ requireText(".github/ISSUE_TEMPLATE/report_gallery_feedback.yml", /doctor --json/, "doctor JSON report gallery prompt");
263
+ requireText(".github/ISSUE_TEMPLATE/report_gallery_feedback.yml", /summary --kind command "git reset --hard"/, "summary report gallery prompt");
264
+ requireText(".github/ISSUE_TEMPLATE/report_gallery_feedback.yml", /Sanitized command summary/, "sanitized command report gallery prompt");
265
+ requireText(".github/ISSUE_TEMPLATE/report_gallery_feedback.yml", /Sanitized output summary/, "sanitized output report gallery prompt");
266
+ requireText(".github/ISSUE_TEMPLATE/report_gallery_feedback.yml", /SECURITY\.md/, "report gallery security redirect");
238
267
  requireText(".github/ISSUE_TEMPLATE/feature_request.yml", /local-first and deterministic/, "project constraint prompt");
239
268
  requireText(".github/ISSUE_TEMPLATE/config.yml", /security\/advisories\/new/, "security contact link");
240
269
 
@@ -0,0 +1,114 @@
1
+ #!/usr/bin/env node
2
+ import { existsSync, readFileSync } from "node:fs";
3
+ import { dirname, join } from "node:path";
4
+ import { fileURLToPath } from "node:url";
5
+
6
+ const scriptDir = dirname(fileURLToPath(import.meta.url));
7
+ const root = join(scriptDir, "..");
8
+ const failures = [];
9
+
10
+ const unsafeContentPatterns = [
11
+ { name: "private key block", pattern: /-----BEGIN [A-Z ]*PRIVATE KEY-----/ },
12
+ { name: "OpenAI-looking secret key", pattern: /\bsk-(?:proj-)?[A-Za-z0-9_-]{20,}\b/ },
13
+ { name: "Anthropic-looking secret key", pattern: /\bsk-ant-[A-Za-z0-9_-]{20,}\b/ },
14
+ { name: "GitHub-looking token", pattern: /\bgh[pousr]_[A-Za-z0-9_]{20,}\b/ },
15
+ { name: "AWS access key id", pattern: /\bAKIA[0-9A-Z]{16}\b/ },
16
+ { name: "Slack-looking token", pattern: /\bxox[baprs]-[A-Za-z0-9-]{20,}\b/ },
17
+ { name: "absolute Unix home path", pattern: /(?:^|[\s"'`])\/(?:Users|home)\/[A-Za-z0-9._-]+/ },
18
+ { name: "absolute Windows user path", pattern: /[A-Za-z]:\\Users\\[A-Za-z0-9._-]+\\/ }
19
+ ];
20
+
21
+ const supportFiles = [
22
+ ".github/ISSUE_TEMPLATE/report_gallery_feedback.yml",
23
+ ".github/ISSUE_TEMPLATE/bug_report.yml",
24
+ ".github/ISSUE_TEMPLATE/false_positive.yml",
25
+ ".github/ISSUE_TEMPLATE/config.yml",
26
+ "examples/reports/feedback-template.md",
27
+ "examples/reports/README.md",
28
+ "docs/MAINTAINER_TRIAGE.md",
29
+ "docs/PRODUCTION_READINESS.md",
30
+ "README.md",
31
+ "SECURITY.md"
32
+ ];
33
+
34
+ for (const path of supportFiles) {
35
+ requireFile(path);
36
+ }
37
+
38
+ for (const path of supportFiles.filter((path) => existsSync(join(root, path)))) {
39
+ const content = read(path);
40
+ for (const unsafe of unsafeContentPatterns) {
41
+ if (unsafe.pattern.test(content)) {
42
+ failures.push(`${path} appears to contain ${unsafe.name}; support examples must stay public-safe and redacted.`);
43
+ }
44
+ }
45
+ }
46
+
47
+ requireText(".github/ISSUE_TEMPLATE/report_gallery_feedback.yml", /Report gallery feedback/, "a report gallery feedback template name");
48
+ requireText(".github/ISSUE_TEMPLATE/report_gallery_feedback.yml", /fresh-install-doctor/, "the fresh install report option");
49
+ requireText(".github/ISSUE_TEMPLATE/report_gallery_feedback.yml", /destructive-command-summary/, "the destructive summary report option");
50
+ requireText(".github/ISSUE_TEMPLATE/report_gallery_feedback.yml", /blocked-command-review/, "the blocked command report option");
51
+ requireText(".github/ISSUE_TEMPLATE/report_gallery_feedback.yml", /doctor --json/, "doctor JSON diagnostics");
52
+ requireText(".github/ISSUE_TEMPLATE/report_gallery_feedback.yml", /summary --kind command "git reset --hard"/, "the report-gallery summary smoke");
53
+ requireText(".github/ISSUE_TEMPLATE/report_gallery_feedback.yml", /Sanitized command summary/, "sanitized command prompt");
54
+ requireText(".github/ISSUE_TEMPLATE/report_gallery_feedback.yml", /Sanitized output summary/, "sanitized output prompt");
55
+ requireText(".github/ISSUE_TEMPLATE/report_gallery_feedback.yml", /SECURITY\.md/, "security redirect");
56
+ requireText(".github/ISSUE_TEMPLATE/report_gallery_feedback.yml", /removed secrets, tokens, private code, private paths, customer data, and full CI logs/, "privacy checkbox");
57
+ requireText(".github/ISSUE_TEMPLATE/false_positive.yml", /Jester version/, "false-positive version prompt");
58
+ requireText(".github/ISSUE_TEMPLATE/false_positive.yml", /doctor --json/, "false-positive doctor diagnostics");
59
+
60
+ requireText("examples/reports/feedback-template.md", /Report Gallery Feedback Template/, "feedback template heading");
61
+ requireText("examples/reports/feedback-template.md", /fresh-install-doctor/, "fresh install report id");
62
+ requireText("examples/reports/feedback-template.md", /destructive-command-summary/, "destructive summary report id");
63
+ requireText("examples/reports/feedback-template.md", /blocked-command-review/, "blocked command report id");
64
+ requireText("examples/reports/feedback-template.md", /doctor --json/, "doctor JSON command");
65
+ requireText("examples/reports/feedback-template.md", /summary --kind command "git reset --hard"/, "summary command");
66
+ requireText("examples/reports/feedback-template.md", /tune <rule-id> --json/, "tune JSON command");
67
+ requireText("examples/reports/feedback-template.md", /Privacy Checklist/, "privacy checklist");
68
+ requireText("examples/reports/feedback-template.md", /SECURITY\.md/, "security redirect");
69
+ requireText("examples/reports/feedback-template.md", /npm run support:check/, "support checker command");
70
+
71
+ requireText("examples/reports/README.md", /feedback-template\.md/, "feedback template link");
72
+ requireText("examples/reports/README.md", /report_gallery_feedback\.yml/, "GitHub issue template link");
73
+ requireText("examples/reports/README.md", /npm run support:check/, "support checker command");
74
+ requireText("docs/MAINTAINER_TRIAGE.md", /feedback-template\.md/, "feedback template triage link");
75
+ requireText("docs/MAINTAINER_TRIAGE.md", /report_gallery_feedback\.yml/, "report gallery issue template triage link");
76
+ requireText("docs/MAINTAINER_TRIAGE.md", /npm(?:\.cmd)? run support:check/, "support checker triage command");
77
+ requireText("docs/PRODUCTION_READINESS.md", /support:check/, "support checker readiness");
78
+ requireText("README.md", /feedback-template\.md/, "feedback template README link");
79
+ requireText("README.md", /report gallery feedback/i, "report gallery feedback guidance");
80
+
81
+ requireText("package.json", /"support:check": "node scripts\/check-support-triage\.mjs"/, "support checker script");
82
+ requireText("package.json", /npm run support:check/, "support checker in npm test");
83
+
84
+ if (failures.length > 0) {
85
+ console.error("Support triage check failed:");
86
+ for (const failure of failures) {
87
+ console.error(`- ${failure}`);
88
+ }
89
+ process.exit(1);
90
+ }
91
+
92
+ console.log("Support triage check passed.");
93
+
94
+ function read(path) {
95
+ return readFileSync(join(root, path), "utf8");
96
+ }
97
+
98
+ function requireFile(path) {
99
+ if (!existsSync(join(root, path))) {
100
+ failures.push(`${path} is missing.`);
101
+ }
102
+ }
103
+
104
+ function requireText(path, pattern, description) {
105
+ if (!existsSync(join(root, path))) {
106
+ failures.push(`${path} is missing; cannot check for ${description}.`);
107
+ return;
108
+ }
109
+
110
+ const content = read(path);
111
+ if (!pattern.test(content)) {
112
+ failures.push(`${path} should include ${description}.`);
113
+ }
114
+ }