chore(linkedin-studio): release v4.0.0 — counts, three-doc, CHANGELOG (clears [skip-docs] debt)

Step 21 (remediation Wave 4 / S6, SOLO): finalize the audit-remediation as
v4.0.0. Version 3.1.0 -> 4.0.0 across all current-version declarations; counts
reconciled to the ls-derived source of truth (19 agents / 27 commands / 6 skills
/ 9 hooks / 25 reference docs / 16 newsletter phases — Step 20 confirmed NO
TRIM); three-doc sync (plugin README + plugin CLAUDE.md + root README) clears the
[skip-docs] debt accumulated across Wave 1-4; CHANGELOG v4.0.0 entry summarizing
Steps 1-20.

Scope additions beyond the plan's literal Files list, all version-sync or
[skip-docs]-debt in nature (flagged, not feature creep):
- ../../CLAUDE.md (root marketplace): linkedin-studio entry v3.1.0 -> v4.0.0
  (the version-sync invariant mandates updating every version reference; leaving
  it stale is a real inconsistency).
- scripts/test-runner.sh: added the version-consistency grep the file's own
  Step-1 comment promised ("added in Step 21") — plugin.json version must match
  the README badge, the CLAUDE.md header, and the CHANGELOG top entry — and
  folded the Wave 2 lint gap (plugin.json now covered by the stat-consistency
  scan). 66/0/0, exit 0.
- plugin README: added the missing /linkedin:firsthour command row (Step 16
  [skip-docs] debt) and the 25th reference doc (longform-quality-rules.md) to
  the knowledge-base table; fixed body counts ("All 26 commands" -> 27, "24
  reference documents" -> 25); badges + intro 26 -> 27 commands, 24 -> 25 refs.
- root README + marketplace.json: dropped the unpublishable model brand/date
  ("360Brew" / "January 2026") the algorithm-signal reconciliation already
  removed everywhere inside the plugin.

Surviving "3.1.0" strings are intentional history, not stale declarations: the
README version-history table row, the "vX added Y" attributions in
plugin.json/CLAUDE.md, and the headless-review reload caveat are all
changelog-genre. Every current-version declaration (plugin.json version, README
badge, CLAUDE.md header, root README marker, marketplace.json) reads 4.0.0.

The major bump reflects the remediation's scope plus the reinstall/reload the
newly-wired agents need to register, and consolidates — does not repeat — the
v3.0.0 identity break; it is not a fresh breaking API change (locked operator
decision).

Pre-existing and out of scope (flagged, untouched): a duplicate /linkedin:setup
row in the README command tables.

Verify: bash scripts/test-runner.sh exit 0 (66/0/0); plugin.json + marketplace.json
parse; counts consistent README == CLAUDE.md == root README; stale-count sweep
clean. NO push — /trekreview (S7) is the release gate.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

plugins/linkedin-studio/scripts/test-runner.sh

@@ -9,8 +9,8 @@
 # the registration guard that gates the remediation plan's later steps.
 #
 # The stat-consistency grep (one magnitude per algorithm effect across the
-# tree) is added in remediation Step 3, after reconciliation makes it pass.
-# The version-consistency grep is added in Step 21.
+# tree) was added in remediation Step 3; the version-consistency grep in
+# Step 21. Both are live below (Sections 8 and 9).
 #
 # Usage: bash scripts/test-runner.sh
 # bash 3.2-safe: plain arrays only, no `declare -A`, no `mapfile`/`readarray`.
@@ -188,7 +188,7 @@ echo "--- Algorithm-Stat Consistency ---"
 # reappear anywhere else (cite the reference, do not restate). This enforces
 # "one value per effect" by forbidding the known competing values from returning.
 STALE_STATS='40-50%|25-40%|6\.6%|1\.92%|15x more reach|-40-60%|360Brew|January 2026'
-STAT_HITS=$(grep -rnE "$STALE_STATS" references/ commands/ skills/ hooks/prompts/ CLAUDE.md README.md 2>/dev/null | grep -v 'algorithm-signals-reference' || true)
+STAT_HITS=$(grep -rnE "$STALE_STATS" references/ commands/ skills/ hooks/prompts/ CLAUDE.md README.md .claude-plugin/plugin.json 2>/dev/null | grep -v 'algorithm-signals-reference' || true)
 if [ -z "$STAT_HITS" ]; then
   pass "no stale algorithm magnitudes / model brand outside the canonical reference"
 else
@@ -198,6 +198,38 @@ fi
 
 echo ""
 
+# --- Section 9: Version Consistency ---
+echo "--- Version Consistency ---"
+
+# Single source of truth for the plugin version: .claude-plugin/plugin.json.
+# Its value must be declared identically in the README badge, the CLAUDE.md
+# header, and the CHANGELOG top entry. Historical references to older versions
+# (CHANGELOG history, the README version-history table, "vX added Y" prose) are
+# NOT checked here — only the current-version DECLARATIONS must agree.
+VERSION=$(python3 -c "import json; print(json.load(open('.claude-plugin/plugin.json'))['version'])" 2>/dev/null)
+if [ -z "$VERSION" ]; then
+  fail "could not read version from plugin.json"
+else
+  pass "plugin.json version: $VERSION"
+  if grep -q "version-${VERSION}-blue" README.md; then
+    pass "README badge declares v$VERSION"
+  else
+    fail "README badge does not declare v$VERSION (expected version-${VERSION}-blue)"
+  fi
+  if grep -q "LinkedIn Studio Plugin (v${VERSION})" CLAUDE.md; then
+    pass "CLAUDE.md header declares v$VERSION"
+  else
+    fail "CLAUDE.md header does not declare (v$VERSION)"
+  fi
+  if grep -q "^## \[${VERSION}\]" CHANGELOG.md; then
+    pass "CHANGELOG has a [$VERSION] entry"
+  else
+    fail "CHANGELOG missing a [$VERSION] entry"
+  fi
+fi
+
+echo ""
+
 # --- Summary ---
 echo "================================================"
 echo "RESULTS"