@windyroad/itil 0.47.13 → 0.47.14
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/package.json
CHANGED
|
@@ -48,14 +48,14 @@ The preamble check is a one-shot; the `.intake-scaffold-done` and `.intake-scaff
|
|
|
48
48
|
2. When the user explicitly confirms ("it's fixed", "verified", "working"): `git mv` from `.verifying.md` to `.closed.md`, update the Status field to "Closed", and reference the problem in the commit message (e.g., "Closes P008").
|
|
49
49
|
3. Never assume the fix works — always wait for explicit user confirmation before closing.
|
|
50
50
|
|
|
51
|
-
The `.verifying.md` suffix distinguishes "fix released, awaiting user verification" from "root cause
|
|
51
|
+
The `.verifying.md` suffix distinguishes "fix released, awaiting user verification" from "root cause identified AND workaround documented; fix not yet proposed" (the Known Error meaning per ADR-022 corrected semantics, 2026-06-08 amendment; the fix proposal happens AFTER Known Error and produces the RFC per ADR-072). See ADR-022 for rationale.
|
|
52
52
|
|
|
53
53
|
## Problem Lifecycle
|
|
54
54
|
|
|
55
55
|
| Status | File suffix | Meaning | Entry criteria |
|
|
56
56
|
|--------|-----------|---------|----------------|
|
|
57
57
|
| **Open** | `.open.md` | Reported, under investigation | New problem identified |
|
|
58
|
-
| **Known Error** | `.known-error.md` | Root cause
|
|
58
|
+
| **Known Error** | `.known-error.md` | Root cause identified AND workaround documented; **fix not yet proposed** (fix proposal produces the RFC per ADR-072) | Root cause documented, reproduction test exists, workaround in place |
|
|
59
59
|
| **Verification Pending** | `.verifying.md` | Fix released, awaiting user verification (ADR-022) | Fix shipped; `## Fix Released` section written; user action remaining |
|
|
60
60
|
| **Parked** | `.parked.md` | Blocked on upstream or suspended by user decision | Upstream blocker identified, or user explicitly suspends; reason and un-park trigger documented |
|
|
61
61
|
| **Closed** | `.closed.md` | Fix verified in production OR ticket determined no longer relevant via evidence | (a) User explicitly confirms the released fix works (canonical Verifying → Closed path), OR (b) auto-closed by `/wr-itil:review-problems` Step 4.6 relevance-close pass per ADR-079 Phase 1 + Phase 2 evidence shapes — `file-no-longer-exists` / `ADR-shipped-confirmed` / `named-skill-or-feature-exists` / `self-marker-in-body` / `driver-child-ticket-closed` (cumulative; multi-shape matches emit comma-joined) with `## Closed as no longer relevant` audit section per ADR-026 grounding (extends ADR-022 lifecycle: Open\|Known Error → Closed bypasses Verifying when no fix was released). Partial-scope umbrellas emit `CLOSE-CANDIDATE-WITH-CAVEAT` and ride the maintainer's `AskUserQuestion` surface-batch-confirm path. |
|
|
@@ -82,7 +82,7 @@ Problems are ranked using Weighted Shortest Job First (WSJF):
|
|
|
82
82
|
|
|
83
83
|
**Severity** = Impact × Likelihood (1-25) from `RISK-POLICY.md`. Read the impact levels, likelihood levels, and risk matrix from the policy — do not hardcode them here.
|
|
84
84
|
|
|
85
|
-
**Status Multiplier** (known-errors have
|
|
85
|
+
**Status Multiplier** (known-errors have identified root cause AND documented workaround — ready for fix proposal; higher value per unit of work because the diagnostic uncertainty is resolved):
|
|
86
86
|
|
|
87
87
|
| Status | Multiplier |
|
|
88
88
|
|--------|-----------|
|
|
@@ -167,7 +167,7 @@ What "work" means depends on the problem's status:
|
|
|
167
167
|
7. **Transition to Known Error immediately** — once root cause and workaround are documented, `git mv` the file to `.known-error.md` and update the Status field. Do not wait for a separate review.
|
|
168
168
|
8. If the fix is small enough, continue straight to implementing it (becoming a Known Error → Closed flow in one session)
|
|
169
169
|
|
|
170
|
-
**Known Error (root cause
|
|
170
|
+
**Known Error (root cause identified AND workaround documented; ready for fix proposal):**
|
|
171
171
|
|
|
172
172
|
**Substance-confirm-before-build guard (ADR-074 — propose-fix surface, ADR-060 I13).** BEFORE implementing any fix step below, check whether the fix builds on a genuine decision whose **substance is unconfirmed**. This closes P315 (dependent work built on a born-`proposed` decision the user later rejects):
|
|
173
173
|
|
|
@@ -664,7 +664,7 @@ If the edit touched only `## Root Cause Analysis`, `## Symptoms`, `## Workaround
|
|
|
664
664
|
|
|
665
665
|
**Open → Known Error** (rename file, update content):
|
|
666
666
|
|
|
667
|
-
Known Error means "root cause
|
|
667
|
+
Known Error means "root cause identified AND workaround documented; fix not yet proposed" (per ADR-022 corrected semantics, 2026-06-08 amendment). The fix is proposed AFTER Known Error and produces the RFC (per ADR-072). Releasing the fix is a separate Known Error → Verification Pending transition — do NOT stay on `.known-error.md` after the fix ships.
|
|
668
668
|
|
|
669
669
|
Pre-flight checks before allowing transition:
|
|
670
670
|
- [ ] Root cause is documented (not just "Preliminary Hypothesis")
|
|
@@ -16,7 +16,7 @@ The deprecated `/wr-itil:manage-problem <NNN> known-error` subcommand route rema
|
|
|
16
16
|
|
|
17
17
|
- `<NNN>` — the ticket ID (data parameter, e.g. `042`). Required.
|
|
18
18
|
- `<status>` — the destination status. One of:
|
|
19
|
-
- `known-error` — Open → Known Error (root cause
|
|
19
|
+
- `known-error` — Open → Known Error (root cause identified AND workaround documented; fix not yet proposed — per ADR-022 corrected semantics, fix proposal produces the RFC per ADR-072).
|
|
20
20
|
- `verifying` — Known Error → Verification Pending (fix released, awaiting user verification per ADR-022).
|
|
21
21
|
- `close` — Verification Pending → Closed (user has confirmed the fix works in production).
|
|
22
22
|
|