@enfocussw/switch-scripting-context 25.11.1-beta.0 → 25.11.1-beta.1

package/CHANGELOG.md

@@ -5,6 +5,21 @@ All notable changes to this package are documented here. Format follows
 
 ## [Unreleased]
 
+## [25.11.1-beta.1] - 2026-09-17
+
+### Added
+
+- `remove --tools <list>` removes the Switch section only from the named tools' AI config files.
+  The docs folder, the `.gitignore` entry and other tools' config stay in place. Without
+  `--tools`, or with every tool listed, `remove` still removes everything.
+
+### Fixed
+
+- `remove` now deletes the Cursor rule file and the scoped GitHub Copilot instructions file,
+  plus their folders if nothing else is in them. Before, it left both files behind containing
+  only their frontmatter. A file whose frontmatter you edited or wrote yourself is kept, with only
+  the Switch section removed.
+
 ## [25.11.1-beta.0] - 2026-09-15
 
 ### 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.0/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.1/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.0/CHANGELOG.md) for what changed.
+See [CHANGELOG.md](https://cdn.jsdelivr.net/npm/@enfocussw/switch-scripting-context@25.11.1-beta.1/CHANGELOG.md) for what changed.
 
 ## Options
 
@@ -118,6 +118,21 @@ npx switch-scripting-context init --dry-run
 npx switch-scripting-context init --docs-dir ai-context
 ```
 
+To undo `init`, run `remove`. By default it deletes the docs folder, the Switch section in every AI config file, and the `.gitignore` entry. With `--tools`, it only removes those tools' config sections and leaves the docs folder and other tools in place. Listing every tool is the same as a plain `remove`:
+
+```
+npx switch-scripting-context remove [options]
+
+  --tools <list>    Only remove these tools' config. Default: remove everything
+  --docs-dir <dir>  Docs folder to remove. Default: switch-docs
+  --dry-run         Print what would happen without writing any files
+```
+
+```bash
+# Stop configuring Cursor, keep everything else
+npx switch-scripting-context remove --tools cursor
+```
+
 ## TypeScript types
 
 This package does not bundle `@types/switch-scripting`. Add the type declarations to your project manually:

package/dist/init.js

@@ -381,20 +381,46 @@ function updateGitignore(targetRoot, docsDir, dryRun) {
     fs.appendFileSync(gitignorePath, entry, 'utf8');
     console.log(`  .gitignore → appended ${docsDir}/ entry`);
 }
-/** All AI config file paths that init may have created. */
-function aiConfigPaths(targetRoot, docsDir) {
-    return TOOL_REGISTRY.flatMap(t => t.files.map(f => f.targetPath(targetRoot, docsDir)));
+/** AI config files that init may have created, for all tools or only the given tool ids. */
+function aiConfigFiles(targetRoot, docsDir, tools) {
+    return TOOL_REGISTRY
+        .filter(t => !tools || tools.includes(t.id))
+        .flatMap(t => t.files.map(file => ({ filePath: file.targetPath(targetRoot, docsDir), file })));
 }
-function removeAiConfig(filePath, dryRun) {
+/** The frontmatter a generator writes above the marker, trimmed; empty if it writes none. */
+function generatedFrontmatter(file, docsDir) {
+    const generated = file.generate(docsDir);
+    return generated.slice(0, generated.indexOf(MARKER_BEGIN)).trim();
+}
+/** Deletes now-empty folders from dir upwards, stopping at targetRoot. */
+function removeEmptyDirs(dir, targetRoot) {
+    while (dir !== targetRoot && dir.startsWith(targetRoot + path.sep) && fs.readdirSync(dir).length === 0) {
+        fs.rmdirSync(dir);
+        dir = path.dirname(dir);
+    }
+}
+function removeAiConfig(filePath, file, docsDir, targetRoot, dryRun) {
     if (!fs.existsSync(filePath))
         return;
-    const content = fs.readFileSync(filePath, 'utf8');
+    const raw = fs.readFileSync(filePath, 'utf8');
+    const eol = raw.includes('\r\n') ? '\r\n' : '\n';
+    const content = raw.replace(/\r\n/g, '\n');
     const range = findMarkerRange(content);
     if (!range)
         return; // nothing from us in this file
     const rel = path.relative(process.cwd(), filePath);
-    const before = content.slice(0, range[0]).trim();
+    let before = content.slice(0, range[0]).trim();
     const after = content.slice(range[1]).trim();
+    // Copilot scoped instructions and Cursor .mdc put frontmatter above the marker. Only an exact
+    // copy of what the generator writes counts as ours; edited or user-written frontmatter stays.
+    const ours = generatedFrontmatter(file, docsDir);
+    if (ours && before === ours) {
+        before = '';
+    }
+    else if (ours && before.endsWith('\n' + ours)) {
+        // init appended our block, frontmatter included, below the user's own content
+        before = before.slice(0, -ours.length).trim();
+    }
     if (!before && !after) {
         // File is entirely our content — delete it
         if (dryRun) {
@@ -402,6 +428,7 @@ function removeAiConfig(filePath, dryRun) {
             return;
         }
         fs.unlinkSync(filePath);
+        removeEmptyDirs(path.dirname(filePath), targetRoot);
         console.log(`  ${rel} → deleted`);
     }
     else {
@@ -411,7 +438,7 @@ function removeAiConfig(filePath, dryRun) {
             console.log(`  [dry-run] ${rel} → removed Switch section`);
             return;
         }
-        fs.writeFileSync(filePath, stripped, 'utf8');
+        fs.writeFileSync(filePath, stripped.replace(/\n/g, eol), 'utf8');
         console.log(`  ${rel} → removed Switch section`);
     }
 }
@@ -438,6 +465,18 @@ function remove(options) {
     const docsDestDir = path.join(targetRoot, options.docsDir);
     if (options.dryRun)
         console.log('\nDry run — no files will be written.\n');
+    const tools = options.tools;
+    const partial = tools && !TOOL_REGISTRY.every(t => tools.includes(t.id));
+    if (partial) {
+        // Removing some tools leaves the rest configured, and they still reference the docs folder.
+        // Listing every tool leaves nothing referencing it, so that falls through to a full remove.
+        console.log('Cleaning AI config files...');
+        for (const { filePath, file } of aiConfigFiles(targetRoot, options.docsDir, options.tools)) {
+            removeAiConfig(filePath, file, options.docsDir, targetRoot, options.dryRun);
+        }
+        console.log('\nDone.\n');
+        return;
+    }
     // 1. Remove docs dir
     console.log('Removing docs...');
     if (fs.existsSync(docsDestDir)) {
@@ -454,8 +493,8 @@ function remove(options) {
     }
     // 2. Remove AI config sections / files
     console.log('\nCleaning AI config files...');
-    for (const filePath of aiConfigPaths(targetRoot, options.docsDir)) {
-        removeAiConfig(filePath, options.dryRun);
+    for (const { filePath, file } of aiConfigFiles(targetRoot, options.docsDir)) {
+        removeAiConfig(filePath, file, options.docsDir, targetRoot, options.dryRun);
     }
     // 3. Update .gitignore
     console.log('\nUpdating .gitignore...');
@@ -530,6 +569,7 @@ function parseArgs(argv) {
                 process.exit(1);
             }
             initOptions.tools = raw.map(t => idMap.get(t));
+            removeOptions.tools = initOptions.tools;
             toolsExplicit = true;
         }
         else if (arg === '--docs-dir' && args[i + 1]) {
@@ -580,7 +620,7 @@ Usage: switch-scripting-context <command> [options]
 
 Commands:
   init      Copy docs and generate AI context config files
-  remove    Remove all files and config added by init
+  remove    Remove files and config added by init (all of it, or only some tools' config)
 
 Options (init):
   --tools <list>    Comma-separated tools to configure
@@ -593,6 +633,8 @@ Options (init):
   --help            Show this help message
 
 Options (remove):
+  --tools <list>    Only remove these tools' config; keeps the docs folder and other tools
+                    Default: remove everything, same as listing every tool
   --docs-dir <dir>  Docs folder to remove (default: switch-docs)
   --dry-run         Print what would happen without writing any files
 
@@ -602,6 +644,7 @@ Examples:
   npx switch-scripting-context init --docs-dir ai-docs --dry-run
   npx switch-scripting-context remove
   npx switch-scripting-context remove --dry-run
+  npx switch-scripting-context remove --tools cursor
 `);
 }
 // ─── Entry point ─────────────────────────────────────────────────────────────

package/package.json

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