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 +6 -0
- package/README.md +5 -0
- package/ROADMAP.md +2 -1
- package/docs/MAINTAINER_TRIAGE.md +18 -0
- package/docs/PRODUCTION_READINESS.md +5 -3
- package/docs/RELEASE.md +3 -1
- package/docs/RELEASE_NOTES_v0.1.89.md +60 -0
- package/examples/reports/README.md +12 -0
- package/examples/reports/feedback-template.md +54 -0
- package/package.json +3 -2
- package/scripts/check-production-readiness.mjs +29 -0
- package/scripts/check-support-triage.mjs +114 -0
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
|
-
-
|
|
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,
|
|
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
|
-
-
|
|
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.
|
|
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
|
+
}
|