<< All versions

Skill v1.0.0

currentAutomated scan100/100
sdsrss/agentsmd/agentsmd-version-cascade
──Details
PublishedNovember 5, 2026 at 01:34 AM
Content Hashsha256:f730411401a9eebd...
Git SHA26bb4bd71b07
──Files
Files (1 file, 1.9 KB)
SKILL.md1.9 KBactive
SKILL.md · 31 lines · 1.9 KB

name: agentsmd-version-cascade description: Scan README prose for stale same-major version tokens. Use before release or after a version bump. Not for structured package/plugin/spec version equality; read-only. metadata: version: "1.0.0"


agentsmd-version-cascade

Use the selected SKILL.md absolute path from the live skills list; never infer it from the process cwd. Define and call the adjacent launcher in the same shell. The launcher preserves selected bundle → manifest-owned standalone → versioned CLI identity checks and exports plugin context only for a verified selected bundle.

bash
SKILL_MD="<selected SKILL.md absolute path from the live skills list>"
agentsmd_skill_run() {
node "$(dirname "$SKILL_MD")/scripts/agentsmd-run.js" "$SKILL_MD" "$@"
}

drift.test.js gate #5 asserts the version matches across the 5 structured places (named JSON fields + the two CODEX-CODING-SPEC vX.Y.Z headers). It cannot see a version token embedded in narrative text. This scans the prose READMEs for a current-major token whose minor has drifted:

bash
agentsmd_skill_run
agentsmd_skill_run --json
  • Compares each vMAJOR.MINOR(.patch) token against hard-rules.json spec_version at minor granularity (patch-insensitive). The major-token regex is derived per run, so it keeps working after a major bump instead of going silently blind.
  • Intentional historical/example refs are allowlisted (INTENTIONAL_TOKENS in the script — the rename version, an example --ref tag). A genuinely new deliberate historical ref means a conscious addition there.
  • ok + exit 0 = no stale prose token; a stale/missing token → exit 1 with file:line — found … (expected …).

Read-only. From the repo instead of an install: node scripts/version-cascade-check.js. For the structured cross-file version check in a source checkout, run node scripts/tests/drift.test.js. Release and broad shared changes still require the full gate.

All versions