@natjswenson/press 0.7.0 → 0.7.1

package/CHANGELOG.md

@@ -5,6 +5,31 @@ All notable changes to the **press** skill are documented here.
 The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and
 this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.7.1] - 2026-08-01
+
+### Fixed
+
+- **Declaring a new target broke every consumer's CI.** 0.7.0 added README
+  targets for the external repos without seeding the regions, so the moment a
+  consumer's pin reached 0.7.0 its `check` failed `missing`. `propagate` now
+  **seeds** a region the consumer does not have yet, in the same pull request
+  that raises the pin — the two are one change, not two. Only targets declaring
+  an `init` anchor are seedable, so a deliberately deleted region is still
+  reported rather than silently recreated.
+- **`check` now enforces the recorded version, not just the values.** In-repo
+  regions sat at `v0.1.0` through six releases with a green check, because only
+  content was compared. One version per consumer means `check` has to say so.
+- New `init.insertAfter` anchor, so a seeded README badge lands under the title
+  instead of at the bottom of the file.
+
+### Added
+
+- Version badges for the in-repo skills' READMEs (`city-report`, `resume`,
+  `ghostwriter`, `ghostwriter-x`, `devlog`), and `press` itself is now listed in
+  the monorepo's root README skill table.
+- `natejswenson` has no README target on purpose: its README is generated by
+  `build_svg.py` and a region there would be clobbered on the next build.
+
 ## [0.7.0] - 2026-08-01
 
 ### Added
@@ -294,6 +319,7 @@ source of truth and a CI drift gate.
   rasterised cards, whose eyebrow legitimately runs at `.16em`. Scoped rather
   than waived, and caught by linting the real shipped corpus.
 
+[0.7.1]: https://github.com/natejswenson/claude-skills/releases/tag/press-v0.7.1
 [0.7.0]: https://github.com/natejswenson/claude-skills/releases/tag/press-v0.7.0
 [0.6.1]: https://github.com/natejswenson/claude-skills/releases/tag/press-v0.6.1
 [0.6.0]: https://github.com/natejswenson/claude-skills/releases/tag/press-v0.6.0

package/SKILL.md

@@ -2,7 +2,7 @@
 name: press
 description: The one brand system for everything produced in Claude — design tokens, the visual laws, the run-presentation contract, and the universal voice core. Use when composing or restyling any artifact (report, résumé, card, cover, PDF, HTML page, chart), when asked about brand colors, fonts, the accent law or "the PRESS look", when adding a new skill that renders anything, or when a brand value needs to change everywhere at once. Also handles "check the brand is in sync", "why do my colors differ", and onboarding a new consumer repo.
 user_invocable: true
-version: 0.7.0
+version: 0.7.1
 ---
 
 # /press — the brand system

package/lib/check.mjs

@@ -40,10 +40,18 @@ export function checkTarget(target, root, tokens, version) {
   const expected = emitBody(tokens, target.emitter, target.params ?? {}, { version })
     .replace(/\s+$/, '');
   const actual = found.body.replace(/\s+$/, '');
-  if (expected === actual) {
-    return { target, path, status: 'ok', writtenBy: found.version };
+  if (expected !== actual) {
+    return { target, path, status: 'drift', diff: lineDiff(expected, actual), writtenBy: found.version };
   }
-  return { target, path, status: 'drift', diff: lineDiff(expected, actual), writtenBy: found.version };
+  // The values match, but the region must also record the release it belongs
+  // to. Without this the version is decoration: in-repo regions sat at v0.1.0
+  // through six releases with a green check, which is precisely the "three
+  // different version numbers and no way to read them" problem this policy
+  // exists to end. One version per consumer means check has to say so.
+  if (found.version !== version) {
+    return { target, path, status: 'stale-version', writtenBy: found.version };
+  }
+  return { target, path, status: 'ok', writtenBy: found.version };
 }
 
 export function checkAll({ tokens, targets, root, ids, version }) {
@@ -86,6 +94,7 @@ export function lineDiff(expected, actual) {
 export const EXPLAIN = {
   ok: 'in sync',
   drift: 'region content differs from what the tokens produce',
+  'stale-version': 'values are correct but the region records an older press release — re-emit',
   missing: 'file has no press region — the generated block was removed',
   absent: 'declared file does not exist at this path',
   corrupt: 'region markers are malformed',

package/lib/propagate.mjs

@@ -25,7 +25,7 @@ import { readFileSync, writeFileSync, existsSync, readdirSync } from 'node:fs';
 import { join } from 'node:path';
 
 import { emitBody } from './emit.mjs';
-import { findRegion, spliceRegion } from './region.mjs';
+import { findRegion, initRegion, spliceRegion } from './region.mjs';
 import { selectTargets, targetPath } from './targets.mjs';
 
 /** The npm reference consumers pin in CI, e.g. `@natjswenson/press@0.3.0`. */
@@ -47,7 +47,32 @@ export function propagate({ tokens, targets, root, version, dryRun = false }) {
     const before = readFileSync(path, 'utf8');
     const found = findRegion(before, target.region, target.syntax);
     if (!found) {
-      regions.push({ id: target.id, path: target.path, status: 'missing' });
+      // A newly declared target has no region in the consumer yet, and that
+      // consumer's `check` starts failing the moment its pin reaches the
+      // release that declares it. So the PR that raises the pin must also
+      // create the region — the two are one change, not two.
+      //
+      // This is not "silently creating": it lands in a reviewed pull request
+      // alongside the pin bump. A region that was deliberately DELETED is a
+      // different case, and one this cannot distinguish, which is why the
+      // target must declare an `init` anchor to be seedable at all.
+      if (!target.init) {
+        regions.push({ id: target.id, path: target.path, status: 'missing' });
+        continue;
+      }
+      const body = emitBody(tokens, target.emitter, target.params ?? {}, { version });
+      if (!dryRun) {
+        writeFileSync(path, initRegion(before, target.region, target.syntax, body, version, target.init), 'utf8');
+      }
+      regions.push({
+        id: target.id,
+        path: target.path,
+        changed: true,
+        brandChanged: false,
+        versionChanged: true,
+        status: dryRun ? 'would seed' : 'seeded',
+        wroteBy: null,
+      });
       continue;
     }
     const body = emitBody(tokens, target.emitter, target.params ?? {}, { version });

package/lib/region.mjs

@@ -153,7 +153,22 @@ export function initRegion(text, region, syntaxName, body, version, anchor = {})
     throw new RegionError(`file already has a press:${region} region — use emit without --init`);
   }
   const block = renderRegion(region, syntaxName, body, version);
-  const { replaceFrom, replaceTo } = anchor;
+  const { replaceFrom, replaceTo, insertAfter } = anchor;
+
+  // Seeding a brand-new region (a README badge) rather than taking over a
+  // hand-written block: place it after the first line matching `insertAfter`,
+  // usually the title, instead of appending to the bottom where nobody looks.
+  if (insertAfter) {
+    const lines = text.split('\n');
+    const re = new RegExp(insertAfter);
+    const at = lines.findIndex((l) => re.test(l));
+    if (at === -1) throw new RegionError(`anchor insertAfter /${insertAfter}/ matched no line`);
+    let i = at + 1;
+    while (i < lines.length && lines[i].trim() === '') i += 1;
+    lines.splice(i, 0, ...block.split('\n'), '');
+    return lines.join('\n');
+  }
+
   if (!replaceFrom) return `${text.replace(/\s+$/, '')}\n\n${block}\n`;
 
   const lines = text.split('\n');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@natjswenson/press",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "description": "One brand system — tokens, laws, run presentation and voice core — generated into every consumer with a CI drift gate",
   "license": "MIT",
   "author": "Nate Swenson",

package/targets.json

@@ -395,8 +395,7 @@
         ]
       },
       "init": {
-        "replaceFrom": "^# --- PRESS tokens",
-        "replaceTo": "^\\}$"
+        "insertAfter": "^# "
       }
     },
     {
@@ -408,6 +407,9 @@
       "emitter": "version-badge",
       "params": {
         "what": "The site's colour, type and panel tokens"
+      },
+      "init": {
+        "insertAfter": "^# "
       }
     },
     {
@@ -420,7 +422,10 @@
       "params": {
         "what": "The report's colour and type tokens"
       },
-      "github": "local-budget"
+      "github": "local-budget",
+      "init": {
+        "insertAfter": "^# "
+      }
     },
     {
       "id": "local-fitness-readme",
@@ -431,18 +436,81 @@
       "emitter": "version-badge",
       "params": {
         "what": "The brief and report-card colour and type tokens"
+      },
+      "init": {
+        "insertAfter": "^# "
       }
     },
     {
-      "id": "natejswenson-readme",
-      "repo": "natejswenson",
-      "path": "README.md",
+      "id": "city-report-readme",
+      "repo": "claude-skills",
+      "path": "skills/city-report/README.md",
+      "region": "version",
+      "syntax": "md",
+      "emitter": "version-badge",
+      "params": {
+        "what": "The report's colour and type tokens"
+      },
+      "init": {
+        "insertAfter": "^# "
+      }
+    },
+    {
+      "id": "resume-readme",
+      "repo": "claude-skills",
+      "path": "skills/resume/README.md",
+      "region": "version",
+      "syntax": "md",
+      "emitter": "version-badge",
+      "params": {
+        "what": "The résumé themes' colour and type tokens"
+      },
+      "init": {
+        "insertAfter": "^# "
+      }
+    },
+    {
+      "id": "ghostwriter-readme",
+      "repo": "claude-skills",
+      "path": "skills/ghostwriter/README.md",
       "region": "version",
       "syntax": "md",
       "emitter": "version-badge",
       "params": {
-        "what": "The profile tiles' colour tokens and vendored faces"
+        "what": "The card system's colour, type and terminal tokens"
+      },
+      "init": {
+        "insertAfter": "^# "
+      }
+    },
+    {
+      "id": "ghostwriter-x-readme",
+      "repo": "claude-skills",
+      "path": "skills/ghostwriter-x/README.md",
+      "region": "version",
+      "syntax": "md",
+      "emitter": "version-badge",
+      "params": {
+        "what": "The card system's colour, type and terminal tokens"
+      },
+      "init": {
+        "insertAfter": "^# "
+      }
+    },
+    {
+      "id": "devlog-readme",
+      "repo": "claude-skills",
+      "path": "skills/devlog/README.md",
+      "region": "version",
+      "syntax": "md",
+      "emitter": "version-badge",
+      "params": {
+        "what": "The cover-image palette"
+      },
+      "init": {
+        "insertAfter": "^# "
       }
     }
-  ]
+  ],
+  "$readme_note": "natejswenson has no README target on purpose: its README.md is generated by build_svg.py, so a region there would be clobbered on the next build. Its press version is visible in build_svg.py's own region marker instead."
 }