memento-mori-jester 0.1.99 → 0.1.101

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,18 @@ All notable changes to Memento Mori Jester are tracked here.
4
4
 
5
5
  ## Unreleased
6
6
 
7
+ ## 0.1.101
8
+
9
+ - Added a checked public-safe support examples index so maintainers can choose between the lifecycle map, blank worksheet, and filled synthetic example.
10
+ - Added `support-examples-index.json` plus `npm run support:check` and production-readiness coverage so use-cases, public-safe markers, stage path, and required checks stay aligned.
11
+ - Updated README, maintainer triage docs, support examples, production-readiness docs, roadmap, and release notes for the support examples manifest.
12
+
13
+ ## 0.1.100
14
+
15
+ - Added a checked synthetic filled support lifecycle worksheet example showing one `docs-example` report through report, triage, response, closeout, prioritization, backlog record, and backlog review.
16
+ - Added `support-lifecycle-filled-example.json` plus `npm run support:check` and production-readiness coverage so the completed example stays public-safe, deterministic, and aligned with the blank worksheet.
17
+ - Updated README, maintainer triage docs, support examples, production-readiness docs, roadmap, and release notes for the filled worksheet example.
18
+
7
19
  ## 0.1.99
8
20
 
9
21
  - Added a checked public-safe support lifecycle worksheet for reviewing one report across report, triage, response, closeout, prioritization, backlog record, and backlog review stages.
package/README.md CHANGED
@@ -76,7 +76,7 @@ For trust-building output examples, see [examples/reports](examples/reports). `n
76
76
 
77
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
78
 
79
- Maintainers can use the checked [support lifecycle map](examples/support/support-lifecycle-map.md), [support lifecycle worksheet](examples/support/support-lifecycle-worksheet.md), [support lifecycle overview](examples/support/support-lifecycle.md), [outcome prioritization guide](examples/support/outcome-prioritization.md), [support backlog records](examples/support/backlog-records.md), [support backlog review](examples/support/backlog-review.md), [support triage playbook](examples/support), [response snippets](examples/support/response-snippets.md), and [support closeout checklist](examples/support/closeout-checklist.md) to turn sanitized reports into a docs example, fixture backlog item, or rule-review candidate without changing behavior first.
79
+ Maintainers can use the checked [support examples index](examples/support/support-examples-index.md), [support lifecycle map](examples/support/support-lifecycle-map.md), [support lifecycle worksheet](examples/support/support-lifecycle-worksheet.md), synthetic [filled worksheet example](examples/support/support-lifecycle-filled-example.md), [support lifecycle overview](examples/support/support-lifecycle.md), [outcome prioritization guide](examples/support/outcome-prioritization.md), [support backlog records](examples/support/backlog-records.md), [support backlog review](examples/support/backlog-review.md), [support triage playbook](examples/support), [response snippets](examples/support/response-snippets.md), and [support closeout checklist](examples/support/closeout-checklist.md) to turn sanitized reports into a docs example, fixture backlog item, or rule-review candidate without changing behavior first.
80
80
 
81
81
  Expected vibe:
82
82
 
@@ -450,8 +450,10 @@ More setup examples:
450
450
  - [Consumer Quickstart Smoke](examples/consumer-quickstart)
451
451
  - [Real-World Report Gallery](examples/reports)
452
452
  - [Report Gallery Feedback Template](examples/reports/feedback-template.md)
453
+ - [Support Examples Index](examples/support/support-examples-index.md)
453
454
  - [Support Lifecycle Map](examples/support/support-lifecycle-map.md)
454
455
  - [Support Lifecycle Worksheet](examples/support/support-lifecycle-worksheet.md)
456
+ - [Filled Support Lifecycle Worksheet Example](examples/support/support-lifecycle-filled-example.md)
455
457
  - [Support Lifecycle Overview](examples/support/support-lifecycle.md)
456
458
  - [Support Outcome Prioritization](examples/support/outcome-prioritization.md)
457
459
  - [Support Backlog Records](examples/support/backlog-records.md)
@@ -480,8 +482,10 @@ Framework CI examples:
480
482
  - [Consumer Quickstart Smoke](examples/consumer-quickstart)
481
483
  - [Real-World Report Gallery](examples/reports)
482
484
  - [Report Gallery Feedback Template](examples/reports/feedback-template.md)
485
+ - [Support Examples Index](examples/support/support-examples-index.md)
483
486
  - [Support Lifecycle Map](examples/support/support-lifecycle-map.md)
484
487
  - [Support Lifecycle Worksheet](examples/support/support-lifecycle-worksheet.md)
488
+ - [Filled Support Lifecycle Worksheet Example](examples/support/support-lifecycle-filled-example.md)
485
489
  - [Support Lifecycle Overview](examples/support/support-lifecycle.md)
486
490
  - [Support Outcome Prioritization](examples/support/outcome-prioritization.md)
487
491
  - [Support Backlog Records](examples/support/backlog-records.md)
@@ -545,7 +549,7 @@ Maintainers can use [docs/MAINTAINER_TRIAGE.md](docs/MAINTAINER_TRIAGE.md) to tu
545
549
  Run `npm run fixtures:check` before merging fixture changes; it catches duplicate IDs, missing rule metadata, weak descriptions, unsafe-looking content, and duplicate content.
546
550
  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.
547
551
  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.
548
- Run `npm run support:check` after editing issue templates, support docs, the report gallery feedback path, the [support lifecycle map](examples/support/support-lifecycle-map.md), [support lifecycle worksheet](examples/support/support-lifecycle-worksheet.md), [support lifecycle overview](examples/support/support-lifecycle.md), [outcome prioritization guide](examples/support/outcome-prioritization.md), [support backlog records](examples/support/backlog-records.md), [support backlog review](examples/support/backlog-review.md), [support triage playbook](examples/support), [response snippets](examples/support/response-snippets.md), or [support closeout checklist](examples/support/closeout-checklist.md); it verifies the public templates ask for useful redacted context without inviting secrets or private code.
552
+ Run `npm run support:check` after editing issue templates, support docs, the report gallery feedback path, the [support examples index](examples/support/support-examples-index.md), [support lifecycle map](examples/support/support-lifecycle-map.md), [support lifecycle worksheet](examples/support/support-lifecycle-worksheet.md), [filled worksheet example](examples/support/support-lifecycle-filled-example.md), [support lifecycle overview](examples/support/support-lifecycle.md), [outcome prioritization guide](examples/support/outcome-prioritization.md), [support backlog records](examples/support/backlog-records.md), [support backlog review](examples/support/backlog-review.md), [support triage playbook](examples/support), [response snippets](examples/support/response-snippets.md), or [support closeout checklist](examples/support/closeout-checklist.md); it verifies the public templates ask for useful redacted context without inviting secrets or private code.
549
553
  Run `npm run promo:card` to regenerate the repo-local social preview card after changing its copy or design.
550
554
  Run `npm run promo:check` after editing promo assets; it checks the current demo video, stills, docs, and fixture evidence numbers stay in sync.
551
555
  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,8 @@ 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 support examples index in v0.1.101, telling maintainers when to use the lifecycle map, blank worksheet, and filled synthetic example.
10
+ - Checked filled support lifecycle worksheet example in v0.1.100, showing a synthetic `docs-example` report through report, triage, response, closeout, prioritization, backlog record, and backlog review.
9
11
  - Checked support lifecycle worksheet in v0.1.99, turning the compact map into an active-review checklist with stage checks, record fields, and stop conditions.
10
12
  - Compact checked support lifecycle map in v0.1.98, giving maintainers a quick scan of report, triage, response, closeout, prioritization, backlog record, and backlog review.
11
13
  - Full checked support lifecycle overview in v0.1.97, extending the index from report, triage, response, and closeout through prioritization, backlog records, and backlog review.
@@ -89,9 +91,10 @@ Memento Mori Jester is usable today as a CLI, MCP server, GitHub Action, and git
89
91
  ## Product Ideas
90
92
 
91
93
  - Collect real-world reports and fold the strongest redacted cases into more framework tuning cookbook recipes.
94
+ - Add a tiny generated support artifact status summary if the checked support examples index grows beyond the current map, worksheet, and filled example.
92
95
  - Add a small checked maintainer dashboard or report that summarizes open support backlog review states from public-safe JSON.
93
96
  - Add a generated support lifecycle status summary if backlog review records grow beyond the compact map.
94
- - Add a checked anonymized example of a completed lifecycle worksheet once support reports accumulate.
97
+ - Add synthetic filled worksheet examples for `fixture-backlog` and `rule-review-candidate` if maintainers need more public-safe training cases.
95
98
  - Use support backlog record counts to choose the next docs, fixture, report-gallery, or rule-guidance batch.
96
99
  - Use repeated prioritized support outcomes to choose the next redacted fixture, report-gallery update, or rule-guidance review.
97
100
  - Add a hosted-page option or GitHub Pages instructions once the static page has settled.
@@ -21,7 +21,7 @@ For users who just need to understand what a healthy report looks like, point th
21
21
 
22
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
23
 
24
- When a report has enough public-safe detail to triage, start with the checked [support lifecycle map](../examples/support/support-lifecycle-map.md) for a quick scan of the path, then use the checked [support lifecycle worksheet](../examples/support/support-lifecycle-worksheet.md) to record each stage during active review. Use the full [support lifecycle overview](../examples/support/support-lifecycle.md) to see the whole path from report to backlog review. Then compare it with the checked [support triage playbook](../examples/support). The playbook walks sanitized report-gallery and false-positive reports through first response, classification, and a follow-up outcome. Use [response-snippets.md](../examples/support/response-snippets.md) to reply consistently after choosing the outcome, then use [closeout-checklist.md](../examples/support/closeout-checklist.md) to record whether the docs clarification shipped or queued, fixture backlog was created, or rule-review candidate was opened. Use [outcome-prioritization.md](../examples/support/outcome-prioritization.md) after closeout to decide whether the follow-up work is low-priority docs, medium-priority fixture backlog, or high-priority rule review. Use [backlog-records.md](../examples/support/backlog-records.md) when that prioritized follow-up needs a public-safe backlog artifact, then use [backlog-review.md](../examples/support/backlog-review.md) to revisit whether that artifact remains active or closes with no action.
24
+ When a report has enough public-safe detail to triage, start with the checked [support examples index](../examples/support/support-examples-index.md) to choose the right support artifact. Use the checked [support lifecycle map](../examples/support/support-lifecycle-map.md) for a quick scan of the path, then use the checked [support lifecycle worksheet](../examples/support/support-lifecycle-worksheet.md) to record each stage during active review. Use the synthetic [filled lifecycle worksheet example](../examples/support/support-lifecycle-filled-example.md) when you need to compare a real public-safe report against one completed `docs-example` path. Use the full [support lifecycle overview](../examples/support/support-lifecycle.md) to see the whole path from report to backlog review. Then compare it with the checked [support triage playbook](../examples/support). The playbook walks sanitized report-gallery and false-positive reports through first response, classification, and a follow-up outcome. Use [response-snippets.md](../examples/support/response-snippets.md) to reply consistently after choosing the outcome, then use [closeout-checklist.md](../examples/support/closeout-checklist.md) to record whether the docs clarification shipped or queued, fixture backlog was created, or rule-review candidate was opened. Use [outcome-prioritization.md](../examples/support/outcome-prioritization.md) after closeout to decide whether the follow-up work is low-priority docs, medium-priority fixture backlog, or high-priority rule review. Use [backlog-records.md](../examples/support/backlog-records.md) when that prioritized follow-up needs a public-safe backlog artifact, then use [backlog-review.md](../examples/support/backlog-review.md) to revisit whether that artifact remains active or closes with no action.
25
25
 
26
26
  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).
27
27
 
@@ -47,7 +47,7 @@ This checklist defines what "production grade" means for Memento Mori Jester rig
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
49
  - `examples/reports` provides checked, public-safe report examples for fresh install diagnostics, summary output, blocked command reviews, and report-gallery feedback.
50
- - `examples/support` provides a compact checked support lifecycle map, an active-review worksheet, and a full support lifecycle overview covering report, triage, response, closeout, prioritization, backlog record, and backlog review, plus the supporting outcome prioritization guide, backlog records, backlog review checklist, maintainer triage playbook, response snippets, and closeout checklist.
50
+ - `examples/support` provides a checked support examples index, compact support lifecycle map, active-review worksheet, synthetic filled worksheet example, and full support lifecycle overview covering report, triage, response, closeout, prioritization, backlog record, and backlog review, plus the supporting outcome prioritization guide, backlog records, backlog review checklist, maintainer triage playbook, response snippets, and closeout checklist.
51
51
  - `site/index.html` gives maintainers a static one-page share surface that reuses the demo, social card, start command, and public links.
52
52
  - Every public release has matching `CHANGELOG.md` notes and `docs/RELEASE_NOTES_vX.Y.Z.md`.
53
53
 
@@ -60,14 +60,14 @@ This checklist defines what "production grade" means for Memento Mori Jester rig
60
60
  - GitHub issue templates collect bug reports, false-positive reports, report-gallery feedback, and feature requests with the diagnostic context maintainers need.
61
61
  - `SECURITY.md` routes vulnerability reports away from public issues and asks for redacted diagnostics.
62
62
  - `docs/MAINTAINER_TRIAGE.md` explains how to turn useful false-positive reports into fixture coverage before changing rule logic.
63
- - `examples/support` shows maintainers how to scan the support lifecycle map, use the support lifecycle worksheet during active review, audit the full lifecycle overview, classify sanitized reports as a docs example, fixture backlog item, or rule-review candidate before changing behavior, then reply with public-safe response snippets, record the closeout, prioritize follow-up work, create a public-safe backlog record, and review aging records for keep-or-close decisions.
63
+ - `examples/support` shows maintainers how to choose the right support artifact from the examples index, scan the support lifecycle map, use the support lifecycle worksheet during active review, compare against a synthetic filled worksheet example, audit the full lifecycle overview, classify sanitized reports as a docs example, fixture backlog item, or rule-review candidate before changing behavior, then reply with public-safe response snippets, record the closeout, prioritize follow-up work, create a public-safe backlog record, and review aging records for keep-or-close decisions.
64
64
  - `npm run fixtures:check` validates fixture IDs, metadata, unsafe-looking content, duplicate content, and explicit expected/absent rule intent.
65
65
  - `npm run fixtures:report` shows fixture coverage by rule, rule family, preset slice, kind, verdict, quiet-pass rule boundaries, and feasible pass-case gaps so maintainers can pick the next fixture target; `npm run fixtures:report -- --markdown` produces a paste-ready maintainer snapshot.
66
66
  - `npm run framework:tuning:check` keeps the framework tuning guide, cookbook JSON, cookbook README, and fixture IDs aligned.
67
67
  - `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.
68
68
  - `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.
69
69
  - `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.
70
- - `npm run support:check` verifies issue templates, support docs, the report gallery feedback template, the support lifecycle map, support lifecycle worksheet, support lifecycle overview, outcome prioritization guide, backlog records, backlog review checklist, maintainer triage playbook, response snippets, and closeout checklist stay public-safe and ask for useful redacted context.
70
+ - `npm run support:check` verifies issue templates, support docs, the report gallery feedback template, support examples index, support lifecycle map, support lifecycle worksheet, filled worksheet example, support lifecycle overview, outcome prioritization guide, backlog records, backlog review checklist, maintainer triage playbook, response snippets, and closeout checklist stay public-safe and ask for useful redacted context.
71
71
  - `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.
72
72
  - `npm run site:check` verifies the static landing page before maintainers post or host it.
73
73
  - npm publish has a manual workflow fallback, but the normal release path is tag-driven trusted publishing.
@@ -0,0 +1,45 @@
1
+ # Memento Mori Jester v0.1.100
2
+
3
+ ## Summary
4
+
5
+ This release adds a checked synthetic filled support lifecycle worksheet example so maintainers can see one public-safe `docs-example` report move through the whole support chain.
6
+
7
+ ## Changes
8
+
9
+ - Added `examples/support/support-lifecycle-filled-example.md` with a completed synthetic support case for:
10
+ `report -> triage -> response -> closeout -> prioritization -> backlog-record -> backlog-review`.
11
+ - Added `examples/support/support-lifecycle-filled-example.json` as the deterministic source for the filled example fields, stage checks, privacy review notes, required checks, and synthetic guardrail.
12
+ - Extended `npm run support:check` and `npm run production:check` so the filled example stays aligned with the support lifecycle worksheet, map, and overview.
13
+ - Updated README, maintainer triage docs, support examples, production-readiness docs, roadmap, and changelog.
14
+
15
+ ## Public Interface Changes
16
+
17
+ - No CLI, MCP, config schema, rule, scoring, GitHub Action, or release automation changes.
18
+ - New package docs/examples only:
19
+ - `examples/support/support-lifecycle-filled-example.md`
20
+ - `examples/support/support-lifecycle-filled-example.json`
21
+
22
+ ## Release Validation
23
+
24
+ ```powershell
25
+ npm.cmd test
26
+ npm.cmd run demo:svg:check
27
+ npm.cmd run promo:card:check
28
+ npm.cmd run promo:check
29
+ npm.cmd run support:check
30
+ npm.cmd run production:check
31
+ npm.cmd run pack:dry
32
+ git diff --check
33
+ node .\dist\cli.js doctor
34
+ node .\dist\cli.js summary --kind command "git reset --hard"
35
+ git diff | node .\dist\cli.js diff --fail-on block --subject "v0.1.100 filled support lifecycle worksheet"
36
+ ```
37
+
38
+ ## Post-Publish Smoke
39
+
40
+ ```powershell
41
+ npm.cmd view memento-mori-jester version --silent
42
+ npx.cmd -y memento-mori-jester@latest doctor
43
+ npx.cmd -y memento-mori-jester@latest summary --kind command "git reset --hard"
44
+ npm.cmd run support:check
45
+ ```
@@ -0,0 +1,47 @@
1
+ # Memento Mori Jester v0.1.101
2
+
3
+ ## Summary
4
+
5
+ This release adds a checked public-safe support examples index so maintainers can quickly choose between the lifecycle map, blank worksheet, and filled synthetic example.
6
+
7
+ ## Changes
8
+
9
+ - Added `examples/support/support-examples-index.md` with:
10
+ - artifact use-cases for the lifecycle map, blank worksheet, and filled synthetic example,
11
+ - required public-safe markers for each artifact,
12
+ - a quick maintainer path for report, triage, response, closeout, prioritization, backlog record, and backlog review.
13
+ - Added `examples/support/support-examples-index.json` as the deterministic manifest for artifact links, use-cases, markers, stage records, privacy guardrails, and required checks.
14
+ - Extended `npm run support:check` and `npm run production:check` so the index stays aligned with the support lifecycle artifacts.
15
+ - Updated README, maintainer triage docs, support examples, production-readiness docs, roadmap, and changelog.
16
+
17
+ ## Public Interface Changes
18
+
19
+ - No CLI, MCP, config schema, rule, scoring, GitHub Action, or release automation changes.
20
+ - New package docs/examples only:
21
+ - `examples/support/support-examples-index.md`
22
+ - `examples/support/support-examples-index.json`
23
+
24
+ ## Release Validation
25
+
26
+ ```powershell
27
+ npm.cmd test
28
+ npm.cmd run demo:svg:check
29
+ npm.cmd run promo:card:check
30
+ npm.cmd run promo:check
31
+ npm.cmd run support:check
32
+ npm.cmd run production:check
33
+ npm.cmd run pack:dry
34
+ git diff --check
35
+ node .\dist\cli.js doctor
36
+ node .\dist\cli.js summary --kind command "git reset --hard"
37
+ git diff | node .\dist\cli.js diff --fail-on block --subject "v0.1.101 support examples index"
38
+ ```
39
+
40
+ ## Post-Publish Smoke
41
+
42
+ ```powershell
43
+ npm.cmd view memento-mori-jester version --silent
44
+ npx.cmd -y memento-mori-jester@latest doctor
45
+ npx.cmd -y memento-mori-jester@latest summary --kind command "git reset --hard"
46
+ npm.cmd run support:check
47
+ ```
@@ -2,7 +2,7 @@
2
2
 
3
3
  This playbook shows how to handle sanitized adopter reports without turning every surprise into an immediate rule change. It pairs with [docs/MAINTAINER_TRIAGE.md](../../docs/MAINTAINER_TRIAGE.md), the [report gallery feedback template](../reports/feedback-template.md), and the GitHub issue templates.
4
4
 
5
- Start with the compact checked [support lifecycle map](support-lifecycle-map.md) when you need a quick scan of the path: report, triage, response, closeout, prioritization, backlog record, and backlog review. Use the checked [support lifecycle worksheet](support-lifecycle-worksheet.md) during an active review so every stage has concrete checks and record fields. Use the full checked [support lifecycle overview](support-lifecycle.md) when you need the outcome table in one place. The lifecycle sources are [support-lifecycle-map.json](support-lifecycle-map.json), [support-lifecycle-worksheet.json](support-lifecycle-worksheet.json), and [support-lifecycle.json](support-lifecycle.json). Use [outcome-prioritization.md](outcome-prioritization.md) after closeout to decide whether follow-up work should become docs, fixture backlog, or rule-review work. Use [backlog-records.md](backlog-records.md) to turn that decision into a public-safe backlog artifact, then use [backlog-review.md](backlog-review.md) to decide whether the item stays active or closes with no action.
5
+ Start with the checked [support examples index](support-examples-index.md) when you need to choose the right artifact. Use the compact checked [support lifecycle map](support-lifecycle-map.md) when you need a quick scan of the path: report, triage, response, closeout, prioritization, backlog record, and backlog review. Use the checked [support lifecycle worksheet](support-lifecycle-worksheet.md) during an active review so every stage has concrete checks and record fields, and compare against the synthetic [filled worksheet example](support-lifecycle-filled-example.md) when you need to see one completed `docs-example` path. Use the full checked [support lifecycle overview](support-lifecycle.md) when you need the outcome table in one place. The lifecycle sources are [support-examples-index.json](support-examples-index.json), [support-lifecycle-map.json](support-lifecycle-map.json), [support-lifecycle-worksheet.json](support-lifecycle-worksheet.json), [support-lifecycle-filled-example.json](support-lifecycle-filled-example.json), and [support-lifecycle.json](support-lifecycle.json). Use [outcome-prioritization.md](outcome-prioritization.md) after closeout to decide whether follow-up work should become docs, fixture backlog, or rule-review work. Use [backlog-records.md](backlog-records.md) to turn that decision into a public-safe backlog artifact, then use [backlog-review.md](backlog-review.md) to decide whether the item stays active or closes with no action.
6
6
 
7
7
  The checked source is [triage-playbook.json](triage-playbook.json). Use [response-snippets.md](response-snippets.md) for copy-paste replies after a report is classified. The snippet source is [response-snippets.json](response-snippets.json). Use [closeout-checklist.md](closeout-checklist.md) to record what happened after the response. The closeout source is [closeout-checklist.json](closeout-checklist.json). The backlog source is [backlog-records.json](backlog-records.json). The review source is [backlog-review.json](backlog-review.json).
8
8
 
@@ -0,0 +1,106 @@
1
+ {
2
+ "title": "Support Examples Index",
3
+ "artifacts": [
4
+ {
5
+ "id": "lifecycle-map",
6
+ "label": "Support Lifecycle Map",
7
+ "file": "examples/support/support-lifecycle-map.md",
8
+ "source": "examples/support/support-lifecycle-map.json",
9
+ "useWhen": "Use when you need the shortest scan of the support path before reading detailed checklists.",
10
+ "requiredMarkers": [
11
+ "report -> triage -> response -> closeout -> prioritization -> backlog-record -> backlog-review",
12
+ "SECURITY.md",
13
+ "npm run support:check"
14
+ ],
15
+ "publicSafe": true,
16
+ "synthetic": false
17
+ },
18
+ {
19
+ "id": "blank-worksheet",
20
+ "label": "Support Lifecycle Worksheet",
21
+ "file": "examples/support/support-lifecycle-worksheet.md",
22
+ "source": "examples/support/support-lifecycle-worksheet.json",
23
+ "useWhen": "Use during an active review of one public support report when each stage needs concrete fields to record.",
24
+ "requiredMarkers": [
25
+ "stage checklist",
26
+ "record fields",
27
+ "stop conditions",
28
+ "SECURITY.md",
29
+ "npm run support:check"
30
+ ],
31
+ "publicSafe": true,
32
+ "synthetic": false
33
+ },
34
+ {
35
+ "id": "filled-synthetic-example",
36
+ "label": "Filled Support Lifecycle Worksheet Example",
37
+ "file": "examples/support/support-lifecycle-filled-example.md",
38
+ "source": "examples/support/support-lifecycle-filled-example.json",
39
+ "useWhen": "Use when comparing an active report with one completed synthetic docs-example path from report through backlog review.",
40
+ "requiredMarkers": [
41
+ "synthetic-report-gallery-docs-example",
42
+ "placeholder links",
43
+ "privacy review notes",
44
+ "SECURITY.md",
45
+ "npm run support:check"
46
+ ],
47
+ "publicSafe": true,
48
+ "synthetic": true
49
+ }
50
+ ],
51
+ "quickPath": [
52
+ {
53
+ "stage": "report",
54
+ "artifact": "examples/reports/feedback-template.md",
55
+ "maintainerQuestion": "Is the report redacted, minimal, and safe to discuss publicly?",
56
+ "record": ["source issue", "package version", "sanitized summary", "safe to discuss publicly"]
57
+ },
58
+ {
59
+ "stage": "triage",
60
+ "artifact": "examples/support/triage-playbook.json",
61
+ "maintainerQuestion": "Is this expected docs behavior, fixture backlog, or rule-review work?",
62
+ "record": ["selected outcome", "rule id or report id", "why the outcome fits"]
63
+ },
64
+ {
65
+ "stage": "response",
66
+ "artifact": "examples/support/response-snippets.json",
67
+ "maintainerQuestion": "Which checked public-safe reply should go back to the reporter?",
68
+ "record": ["snippet id", "next command", "public-safe follow-up link"]
69
+ },
70
+ {
71
+ "stage": "closeout",
72
+ "artifact": "examples/support/closeout-checklist.json",
73
+ "maintainerQuestion": "Did the immediate support decision ship, queue, or open follow-up?",
74
+ "record": ["closeout id", "decision status", "follow-up link placeholder"]
75
+ },
76
+ {
77
+ "stage": "prioritization",
78
+ "artifact": "examples/support/outcome-prioritization.json",
79
+ "maintainerQuestion": "Is the follow-up low-priority docs, medium fixture work, or high rule review?",
80
+ "record": ["priority", "minimum evidence", "not enough evidence guardrail"]
81
+ },
82
+ {
83
+ "stage": "backlog-record",
84
+ "artifact": "examples/support/backlog-records.json",
85
+ "maintainerQuestion": "Is there a public-safe backlog artifact with evidence and checks?",
86
+ "record": ["backlog record id", "backlog type", "next action", "required checks"]
87
+ },
88
+ {
89
+ "stage": "backlog-review",
90
+ "artifact": "examples/support/backlog-review.json",
91
+ "maintainerQuestion": "Does the item remain active, or should it close with no action?",
92
+ "record": ["review decision", "review cadence", "next action", "checks run"]
93
+ }
94
+ ],
95
+ "requiredPublicSafeMarkers": [
96
+ "synthetic examples are labelled synthetic",
97
+ "placeholder links are used for public issue and follow-up links",
98
+ "SECURITY.md redirects sensitive reports away from public issues",
99
+ "no secrets, private code, private paths, customer data, full logs, unredacted SARIF, package publishing credentials, MCP data exposure, or exploitable security details"
100
+ ],
101
+ "requiredChecks": [
102
+ "npm run support:check",
103
+ "npm run production:check"
104
+ ],
105
+ "privacyGuardrail": "Keep support examples public-safe: label synthetic material, use placeholders, avoid secrets and private details, and route credential exposure, package publishing compromise, MCP data exposure, command execution risk, or exploitable security details through SECURITY.md."
106
+ }
@@ -0,0 +1,42 @@
1
+ # Support Examples Index
2
+
3
+ This public-safe index tells maintainers which checked support artifact to use during a report review. It keeps the compact map, blank worksheet, and filled synthetic example together so a support issue can move from first report to backlog review without guessing.
4
+
5
+ The checked source is [support-examples-index.json](support-examples-index.json). It points at the [support lifecycle map](support-lifecycle-map.md), [support lifecycle worksheet](support-lifecycle-worksheet.md), and [filled lifecycle worksheet example](support-lifecycle-filled-example.md).
6
+
7
+ ## Which Artifact To Use
8
+
9
+ | Artifact | Use when | Required public-safe markers |
10
+ | --- | --- | --- |
11
+ | [support-lifecycle-map.md](support-lifecycle-map.md) | You need the shortest scan of the support path before reading details. | Stage order, outcome scan, `SECURITY.md`, and `npm run support:check`. |
12
+ | [support-lifecycle-worksheet.md](support-lifecycle-worksheet.md) | You are actively reviewing one public support report and need fields to record. | Stage checklist, record fields, stop conditions, `SECURITY.md`, and `npm run support:check`. |
13
+ | [support-lifecycle-filled-example.md](support-lifecycle-filled-example.md) | You want to compare the active report with one completed synthetic `docs-example` path. | `synthetic-report-gallery-docs-example`, placeholder links, privacy review notes, `SECURITY.md`, and `npm run support:check`. |
14
+
15
+ ## Quick Maintainer Path
16
+
17
+ | Stage | Maintainer question | Use this artifact | Record |
18
+ | --- | --- | --- | --- |
19
+ | `report` | Is the report redacted, minimal, and safe to discuss publicly? | [feedback-template.md](../reports/feedback-template.md) | source issue, package version, sanitized summary, safe to discuss publicly |
20
+ | `triage` | Is this expected docs behavior, fixture backlog, or rule-review work? | [triage-playbook.json](triage-playbook.json) | selected outcome, rule id or report id, why the outcome fits |
21
+ | `response` | Which checked public-safe reply should go back to the reporter? | [response-snippets.md](response-snippets.md) | snippet id, next command, public-safe follow-up link |
22
+ | `closeout` | Did the immediate support decision ship, queue, or open follow-up? | [closeout-checklist.md](closeout-checklist.md) | closeout id, decision status, follow-up link placeholder |
23
+ | `prioritization` | Is the follow-up low-priority docs, medium fixture work, or high rule review? | [outcome-prioritization.md](outcome-prioritization.md) | priority, minimum evidence, not enough evidence guardrail |
24
+ | `backlog-record` | Is there a public-safe backlog artifact with evidence and checks? | [backlog-records.md](backlog-records.md) | backlog record id, backlog type, next action, required checks |
25
+ | `backlog-review` | Does the item remain active, or should it close with no action? | [backlog-review.md](backlog-review.md) | review decision, review cadence, next action, checks run |
26
+
27
+ ## Public-Safe Markers
28
+
29
+ Keep every public support artifact aligned with these markers:
30
+
31
+ - say when an example is synthetic,
32
+ - use placeholders for issue links and follow-up links,
33
+ - include the `SECURITY.md` redirect for sensitive reports,
34
+ - avoid secrets, private code, private paths, customer data, full logs, unredacted SARIF, package publishing credentials, MCP data exposure, or exploitable security details,
35
+ - keep rule behavior unchanged unless a separate checked rule-review change exists.
36
+
37
+ ## Checks
38
+
39
+ ```powershell
40
+ npm run support:check
41
+ npm run production:check
42
+ ```
@@ -0,0 +1,160 @@
1
+ {
2
+ "title": "Filled Support Lifecycle Worksheet Example",
3
+ "sourceWorksheet": "examples/support/support-lifecycle-worksheet.json",
4
+ "synthetic": true,
5
+ "caseId": "synthetic-report-gallery-docs-example",
6
+ "outcome": "docs-example",
7
+ "flow": [
8
+ "report",
9
+ "triage",
10
+ "response",
11
+ "closeout",
12
+ "prioritization",
13
+ "backlog-record",
14
+ "backlog-review"
15
+ ],
16
+ "stages": [
17
+ {
18
+ "id": "report",
19
+ "artifact": "examples/reports/feedback-template.md",
20
+ "fields": {
21
+ "sourceIssue": "<public-issue-url>",
22
+ "packageVersion": "0.1.100",
23
+ "sanitizedSummary": "A reporter says the checked destructive-command-summary gallery item is useful but unclear about whether the block is expected.",
24
+ "safeToDiscussPublicly": true
25
+ },
26
+ "checks": [
27
+ "Confirmed the report references the checked destructive-command-summary gallery item instead of a private repository command.",
28
+ "Confirmed the report includes only a sanitized command summary and redacted doctor --json fragments.",
29
+ "Confirmed there are no secrets, private code, private paths, customer data, full logs, unredacted SARIF, or exploitable details."
30
+ ],
31
+ "privacyReview": [
32
+ "The issue link is a placeholder rather than a real user report.",
33
+ "The command is a public demo command already used in docs.",
34
+ "Security-sensitive details would be redirected to SECURITY.md."
35
+ ]
36
+ },
37
+ {
38
+ "id": "triage",
39
+ "artifact": "examples/support/triage-playbook.json",
40
+ "fields": {
41
+ "selectedOutcome": "docs-example",
42
+ "ruleIdOrReportId": "destructive-command-summary",
43
+ "whyOutcomeFits": "The block is expected behavior for destructive git history changes, but the report-gallery wording can be clearer."
44
+ },
45
+ "checks": [
46
+ "Reproduced the checked report-gallery summary with the published command shape.",
47
+ "Compared the output to the existing report-gallery expected fragments.",
48
+ "Chose docs-example because no rule behavior, fixture boundary, or scoring change is needed."
49
+ ],
50
+ "privacyReview": [
51
+ "The reproduction uses only the public demo command.",
52
+ "The triage note does not include private repository output.",
53
+ "No secret material or exploit detail is needed to classify the report."
54
+ ]
55
+ },
56
+ {
57
+ "id": "response",
58
+ "artifact": "examples/support/response-snippets.json",
59
+ "fields": {
60
+ "snippetId": "docs-example-response",
61
+ "nextCommand": "npx -y memento-mori-jester@latest summary --kind command \"git reset --hard\"",
62
+ "publicSafeFollowUpLink": "<docs-follow-up-url>"
63
+ },
64
+ "checks": [
65
+ "Used the checked docs-example response snippet rather than writing a one-off reply.",
66
+ "Asked only for redacted diagnostics if local output still differs from the gallery.",
67
+ "Gave the reporter one command to compare with the checked report."
68
+ ],
69
+ "privacyReview": [
70
+ "The response asks for redacted diagnostics only.",
71
+ "The follow-up link is a placeholder until a public docs issue or pull request exists.",
72
+ "Any credential exposure, private code, or command execution concern belongs in SECURITY.md."
73
+ ]
74
+ },
75
+ {
76
+ "id": "closeout",
77
+ "artifact": "examples/support/closeout-checklist.json",
78
+ "fields": {
79
+ "closeoutId": "docs-clarification-closeout",
80
+ "decisionStatus": "shipped-or-queued",
81
+ "followUpLinkPlaceholder": "<docs-pr-url-or-issue>"
82
+ },
83
+ "checks": [
84
+ "Recorded that the immediate support decision is a docs clarification.",
85
+ "Linked only a placeholder public follow-up artifact.",
86
+ "Kept rule behavior, matching, scoring, and CLI policy unchanged."
87
+ ],
88
+ "privacyReview": [
89
+ "The closeout can be explained using only public docs and report-gallery context.",
90
+ "No private code or user-specific terminal output is required.",
91
+ "Security-sensitive follow-up is explicitly out of scope for the public closeout."
92
+ ]
93
+ },
94
+ {
95
+ "id": "prioritization",
96
+ "artifact": "examples/support/outcome-prioritization.json",
97
+ "fields": {
98
+ "priority": "low",
99
+ "minimumEvidence": "Nearest checked report, observed output, and no rule behavior change.",
100
+ "notEnoughEvidenceGuardrail": "Do not open fixture or rule-review work from a docs-only confusion report."
101
+ },
102
+ "checks": [
103
+ "Used the outcome prioritization guide for the docs-example path.",
104
+ "Confirmed the minimum evidence threshold is met by the existing checked gallery item.",
105
+ "Confirmed there is enough public-safe evidence to queue a docs clarification."
106
+ ],
107
+ "privacyReview": [
108
+ "The priority does not depend on private reports.",
109
+ "The evidence is already public and synthetic.",
110
+ "No secrets, private paths, or full logs are needed."
111
+ ]
112
+ },
113
+ {
114
+ "id": "backlog-record",
115
+ "artifact": "examples/support/backlog-records.json",
116
+ "fields": {
117
+ "backlogRecordId": "docs-clarification-backlog-record",
118
+ "backlogType": "docs clarification",
119
+ "nextAction": "Update the report-gallery wording so the destructive command summary clearly says the block is expected and shows the next comparison command.",
120
+ "requiredChecks": ["npm run reports:check", "npm run support:check"]
121
+ },
122
+ "checks": [
123
+ "Created a public-safe backlog record from the closeout and prioritization decision.",
124
+ "Included a public title, public summary, next action, and required checks.",
125
+ "Verified the backlog item does not ask for rule behavior changes."
126
+ ],
127
+ "privacyReview": [
128
+ "The backlog item references only checked docs and placeholder links.",
129
+ "The public summary is redacted and synthetic.",
130
+ "Any real private report detail would be removed before publishing."
131
+ ]
132
+ },
133
+ {
134
+ "id": "backlog-review",
135
+ "artifact": "examples/support/backlog-review.json",
136
+ "fields": {
137
+ "reviewDecision": "remains-docs-clarification",
138
+ "reviewCadence": "next monthly support review",
139
+ "nextAction": "Keep the docs clarification open until the gallery wording or docs example lands.",
140
+ "checksRun": ["npm run reports:check", "npm run support:check"]
141
+ },
142
+ "checks": [
143
+ "Revisited whether the item still belongs in the docs clarification lane.",
144
+ "Confirmed the report has not become a fixture backlog or rule-review candidate.",
145
+ "Confirmed the current public checks still pass before keeping it active."
146
+ ],
147
+ "privacyReview": [
148
+ "The review does not include private user names, repositories, paths, or logs.",
149
+ "The review can close as closed-no-action later if evidence becomes stale or duplicated.",
150
+ "Security-sensitive evidence would be removed from the public lifecycle and routed through SECURITY.md."
151
+ ]
152
+ }
153
+ ],
154
+ "requiredChecks": [
155
+ "npm run reports:check",
156
+ "npm run support:check",
157
+ "npm run production:check"
158
+ ],
159
+ "privacyGuardrail": "This filled worksheet is synthetic. Do not add secrets, private code, private paths, customer data, full logs, unredacted SARIF, package publishing credentials, MCP data exposure, or exploitable security details; route those through SECURITY.md."
160
+ }