a9a7a328e6
Mechanical rename produced by scripts/msd-rename.cjs: gsd/Gsd/GSD -> msd/Msd/MSD across contents and paths, upstream package/repo coordinates -> @golem15/msd-core and golem15com/msd-core. Deep links into upstream history, sibling upstream packages, the GSD-2 import feature, CHANGELOG.md and .changeset/ are kept as-is. Hand edits on top: MSD block-letter banner and logos, LICENSE copyright line, package/plugin identity, regenerated lockfile, install-tree fixtures, derived registries and benchmark baseline; migration checksum baseline re-locked (MSD keeps its own install state, so no install had applied the old sums); sort-order and regex-escaped expectations in tests adjusted.
17 lines
1.1 KiB
Markdown
17 lines
1.1 KiB
Markdown
---
|
|
id: 124
|
|
title: Context-Window Utilization Guard
|
|
group: v1.40.0 Features
|
|
---
|
|
|
|
**Command:** `/msd-health --context`
|
|
|
|
**Purpose:** Quality guard against context-window saturation. Two thresholds: 60 % utilization warns ("consider `/msd-thread`"), 70 % is critical ("reasoning quality may degrade"; matches the fracture-point per recent context-attention research).
|
|
|
|
**Requirements:**
|
|
- REQ-CTX-GUARD-01: `/msd-health --context` prints a structured status line with current utilization, threshold tier (`ok` / `warn` / `critical`), and a remediation suggestion.
|
|
- REQ-CTX-GUARD-02: The same triage is exposed as `msd-tools.cjs validate context --tokens-used <int> --context-window <int>` — a structured envelope for status-line and hook callers (#125). Both flags are required; the handler returns the same `{ percent, state }` envelope as the pure classifier in REQ-CTX-GUARD-03.
|
|
- REQ-CTX-GUARD-03: The classifier (`bin/lib/context-utilization.cjs`) is pure: input `(tokensUsed, contextWindow)`, output `{ percent, state }`. Easy to unit-test, easy to reuse from any caller.
|
|
|
|
**Reference issue:** [#2792](https://github.com/open-gsd/gsd-core/issues/2792)
|