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.
30 lines
1.2 KiB
Markdown
30 lines
1.2 KiB
Markdown
---
|
||
id: 130
|
||
title: Graphify Commit-Based Staleness
|
||
group: v1.41.0 Features
|
||
---
|
||
|
||
**Purpose:** Surface whether the architecture graph was built from the current commit or an older one, complementing the existing mtime-based stale signal.
|
||
|
||
**Command:** `/msd-graphify status`
|
||
|
||
**New fields returned (graphify v0.7+ graphs):**
|
||
|
||
| Field | Type | Description |
|
||
|-------|------|-------------|
|
||
| `built_at_commit` | string | Commit SHA the graph was built from |
|
||
| `current_commit` | string | Current `git HEAD` |
|
||
| `commits_behind` | number | How many commits behind HEAD the graph is |
|
||
| `commit_stale` | boolean \| null | `true`=stale, `false`=current, `null`=unavailable (pre-v0.7, non-git) |
|
||
|
||
**Rendered output (when signal is available):**
|
||
```
|
||
Source commit: abc1234 (3 commits behind HEAD)
|
||
```
|
||
|
||
**Security:** `built_at_commit` validated as 4–40 hex chars before reaching `git` — a hostile `graph.json` cannot inject dashed options into argv.
|
||
|
||
**Fallback:** pre-v0.7 graphs and non-git checkouts return `commit_stale: null`; callers fall back to the existing mtime-based `stale` flag. No behavior change for existing users.
|
||
|
||
**Reference issue:** [#3170](https://github.com/open-gsd/gsd-core/issues/3170)
|