@enfocussw/switch-scripting-context 25.11.1-beta.2 → 25.11.1-beta.3

package/CHANGELOG.md

@@ -5,6 +5,16 @@ All notable changes to this package are documented here. Format follows
 
 ## [Unreleased]
 
+## [25.11.1-beta.3] - 2026-09-17
+
+### Added
+
+- `init` now records the version that produced the docs on the first line of
+  `switch-scripting.md`, as an HTML comment reading `switch-scripting-context <version>`. A tool
+  that installs the docs can read it to tell which version a project has, including a checkout
+  someone else set up. Re-running `init` rewrites the line, and `--dry-run` prints it without
+  writing.
+
 ## [25.11.1-beta.2] - 2026-09-17
 
 ### Added

package/README.md

@@ -4,7 +4,7 @@ AI coding assistant context for [Enfocus Switch](https://www.enfocus.com/en/swit
 
 Installs curated API reference docs and generates config files for 8 AI coding agents (Claude Code, GitHub Copilot, Cursor, Codex CLI/OpenCode, Gemini CLI, Windsurf, Zed, and Cline) so AI assistants understand the Switch scripting API out of the box.
 
-See [CHANGELOG.md](https://cdn.jsdelivr.net/npm/@enfocussw/switch-scripting-context@25.11.1-beta.2/CHANGELOG.md) (also included in this package) for what's changed between versions.
+See [CHANGELOG.md](https://cdn.jsdelivr.net/npm/@enfocussw/switch-scripting-context@25.11.1-beta.3/CHANGELOG.md) (also included in this package) for what's changed between versions.
 
 ## Usage
 
@@ -84,7 +84,7 @@ A few things this gets you without asking for them by name:
   properties (app path/licence) are off-limits and left to SwitchScripter's GUI instead.
 
 Re-run `init` after upgrading this package so the copied docs and generated config files catch up.
-See [CHANGELOG.md](https://cdn.jsdelivr.net/npm/@enfocussw/switch-scripting-context@25.11.1-beta.2/CHANGELOG.md) for what changed.
+See [CHANGELOG.md](https://cdn.jsdelivr.net/npm/@enfocussw/switch-scripting-context@25.11.1-beta.3/CHANGELOG.md) for what changed.
 
 ## Options
 

package/dist/init.d.ts

@@ -31,4 +31,8 @@ export declare function generateZedRules(docsDir: string): string;
 export declare function generateClineRules(docsDir: string): string;
 export declare function buildIdMap(registry: ToolDefinition[]): Map<string, string>;
 export declare function findMarkerRange(content: string): [number, number] | null;
+/** The running package's own version, so a git-clone install stamps what actually ran. */
+export declare function packageVersion(root?: string): string;
+/** The comment init writes as the first line of the copied hub file. */
+export declare function versionStamp(version: string): string;
 export declare function run(argv?: string[]): Promise<void>;

package/dist/init.js

@@ -42,6 +42,8 @@ exports.generateZedRules = generateZedRules;
 exports.generateClineRules = generateClineRules;
 exports.buildIdMap = buildIdMap;
 exports.findMarkerRange = findMarkerRange;
+exports.packageVersion = packageVersion;
+exports.versionStamp = versionStamp;
 exports.run = run;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
@@ -365,6 +367,34 @@ function copyDocs(packageRoot, destDir, dryRun) {
     });
     console.log(`  docs → ${path.relative(process.cwd(), destDir)}/`);
 }
+// ─── Version stamp ───────────────────────────────────────────────────────────
+/** The hub file in the copied docs folder that carries the version stamp. */
+const HUB_FILE = 'switch-scripting.md';
+/** The running package's own version, so a git-clone install stamps what actually ran. */
+function packageVersion(root = packageRoot()) {
+    return JSON.parse(fs.readFileSync(path.join(root, 'package.json'), 'utf8')).version;
+}
+/** The comment init writes as the first line of the copied hub file. */
+function versionStamp(version) {
+    return `<!-- switch-scripting-context ${version} -->`;
+}
+/**
+ * Records which version produced the copied docs, so a consumer can tell what is installed
+ * without having recorded it at install time. Only the copy is stamped: the repo's own
+ * docs/switch-scripting.md is generated output and a stamp there would fight the generator.
+ * copyDocs wipes destDir on every run, so there is never a stale stamp to remove.
+ */
+function stampDocsVersion(packageRoot, destDir, dryRun) {
+    const stamp = versionStamp(packageVersion(packageRoot));
+    const hubPath = path.join(destDir, HUB_FILE);
+    const rel = path.relative(process.cwd(), hubPath);
+    if (dryRun) {
+        console.log(`  [dry-run] ${rel} → first line ${stamp}`);
+        return;
+    }
+    fs.writeFileSync(hubPath, `${stamp}\n${fs.readFileSync(hubPath, 'utf8')}`, 'utf8');
+    console.log(`  ${rel} → stamped ${stamp}`);
+}
 // ─── .gitignore update ───────────────────────────────────────────────────────
 function updateGitignore(targetRoot, docsDir, dryRun) {
     const gitignorePath = path.join(targetRoot, '.gitignore');
@@ -511,6 +541,7 @@ function init(options) {
     // 1. Copy docs
     console.log('Copying docs...');
     copyDocs(packageRoot, docsDestDir, options.dryRun);
+    stampDocsVersion(packageRoot, docsDestDir, options.dryRun);
     // 2. Generate AI config files
     const toolActions = [];
     for (const toolDef of TOOL_REGISTRY) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@enfocussw/switch-scripting-context",
-  "version": "25.11.1-beta.2",
+  "version": "25.11.1-beta.3",
   "description": "AI coding assistant context for Enfocus Switch scripting (Node.js/TypeScript)",
   "keywords": [
     "switch",