Explain Cursor cleanup error

TrueNine · TrueNine · commit ad89284d7bc8 · 2026-03-13T04:00:27.000+08:00
diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md
@@ -0,0 +1,76 @@
+# Code of Conduct
+
+## Who We Are
+
+The `memory-sync` community consists of developers surviving in an environment of extreme resource inequality.
+We are not an elite club, not a big-corp-backed open-source project, nor anyone's career stepping stone.
+
+We are rats. We accept that.
+
+---
+
+## What We Welcome
+
+- **Marginal developers**: No stable income, no corporate budget, scraping by on free tiers and trial credits
+- **Solo developers**: Carrying an entire project alone — no team, no PM, no QA
+- **Students and beginners**: Genuinely willing to learn and get hands dirty, not here to beg for ready-made answers
+- **Anyone, any language, any region**: If you use this tool, you are part of the community
+- **AI Agents**: Automation pipelines, Agent workflows, LLM-driven toolchains — as long as behaviour complies with this code, Issues and PRs from Agents are treated equally
+
+We welcome Issues, PRs, discussions, rants — as long as you are serious, regardless of whether the author is human or Agent.
+
+---
+
+## What We Do Not Welcome
+
+The following behaviours result in immediate Issue closure / PR rejection / account ban — no warning, no explanation:
+
+- **Freeloaders**: Want everything ready-made, won't even touch a terminal, open with "set it up for me"
+- **Blame-shifters after freeloading**: Use the tool, hit a problem, first reaction is to lash out instead of providing repro steps
+- **Malicious competitors**: Repackage this project's code or ideas as your own commercial product, circumventing AGPL-3.0
+- **Resource predators**: Stable income, corporate budget, yet competing with marginal developers for free resources and community attention
+- **Harassment**: Personal attacks, discrimination, stalking, harassing maintainers or other contributors
+- **Hustle-culture pushers**: Glorify overwork, promote 996, or use this tool to exploit other developers
+
+---
+
+## Contributor Obligations
+
+If you submit an Issue (human or Agent):
+
+- Provide a minimal reproducible example
+- State your OS, Node.js version, and tool version
+- Agent submissions must include trigger context (call chain, input params, error stack)
+- Do not rush maintainers — they are humans, not customer support
+
+If you submit a PR (human or Agent):
+
+- Open an Issue first to discuss, avoid wasted effort
+- Follow existing code style (TypeScript strict, functional, immutable-first)
+- Do not sneak unrelated changes into a PR
+- Agent-generated PRs must declare the generation tool and prompt source in the description; do not disguise as hand-written
+
+---
+
+## Maintainer Rights
+
+Maintainers may:
+
+- Close any Issue or PR without explanation
+- Ban any account violating this code
+- Amend this code at any time
+
+Maintainers are not obligated to:
+
+- Respond to every Issue
+- Accept every PR
+- Be responsible for anyone's commercial needs
+
+---
+
+## Licence and Enforcement
+
+This project is licensed under [AGPL-3.0](LICENSE).
+Commercial use violating the licence will be subject to legal action.
+
+Enforcement of this code of conduct is at the maintainers' sole discretion; final interpretation rests with [@TrueNine](https://github.com/TrueNine).
diff --git a/cli/src/commands/CleanupUtils.test.ts b/cli/src/commands/CleanupUtils.test.ts
@@ -500,4 +500,34 @@ describe('collectDeletionTargets', () => {
       protectedPath: path.resolve(recursiveProtectedDir)
     })])
   })
+
+  it('skips delete glob matches covered by excludeScanGlobs while still deleting other sibling directories', async () => {
+    const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'tnmsc-cleanup-exclude-glob-'))
+    const skillsDir = path.join(tempDir, '.cursor', 'skills-cursor')
+    const preservedDir = path.join(skillsDir, 'create-rule')
+    const staleDir = path.join(skillsDir, 'legacy-skill')
+
+    fs.mkdirSync(preservedDir, {recursive: true})
+    fs.mkdirSync(staleDir, {recursive: true})
+    fs.writeFileSync(path.join(preservedDir, 'SKILL.md'), '# preserved', 'utf8')
+    fs.writeFileSync(path.join(staleDir, 'SKILL.md'), '# stale', 'utf8')
+
+    try {
+      const ctx = createCleanContext()
+      const plugin = createMockOutputPlugin('MockOutputPlugin', [], {
+        delete: [{kind: 'glob', path: path.join(skillsDir, '*')}],
+        protect: [{kind: 'directory', path: preservedDir}],
+        excludeScanGlobs: [preservedDir, path.join(preservedDir, '**')]
+      })
+
+      const result = await collectDeletionTargets([plugin], ctx)
+
+      expect(result.dirsToDelete).toEqual([path.resolve(staleDir)])
+      expect(result.filesToDelete).toEqual([])
+      expect(result.violations).toEqual([])
+    }
+    finally {
+      fs.rmSync(tempDir, {recursive: true, force: true})
+    }
+  })
 })
diff --git a/cli/src/inputs/input-editorconfig.ts b/cli/src/inputs/input-editorconfig.ts
@@ -1,6 +1,6 @@
-import type {InputCollectedContext} from '../plugins/plugin-core'
+import type {InputCollectedContext, InputPluginContext, ProjectIDEConfigFile} from '../plugins/plugin-core'
+import {AbstractInputPlugin, IDEKind} from '../plugins/plugin-core'
 import {readPublicIdeConfigDefinitionFile} from '../public-config-paths'
-import {AbstractInputPlugin, IDEKind, type InputPluginContext, type ProjectIDEConfigFile} from '../plugins/plugin-core'
 
 export class EditorConfigInputPlugin extends AbstractInputPlugin {
   constructor() {
diff --git a/cli/src/inputs/input-git-exclude.ts b/cli/src/inputs/input-git-exclude.ts
@@ -1,6 +1,6 @@
 import type {InputCollectedContext, InputPluginContext} from '../plugins/plugin-core'
-import {PUBLIC_GIT_EXCLUDE_TARGET_RELATIVE_PATH, resolvePublicDefinitionPath} from '../public-config-paths'
 import {AbstractInputPlugin} from '../plugins/plugin-core'
+import {PUBLIC_GIT_EXCLUDE_TARGET_RELATIVE_PATH, resolvePublicDefinitionPath} from '../public-config-paths'
 
 export class GitExcludeInputPlugin extends AbstractInputPlugin {
   constructor() {
diff --git a/cli/src/inputs/input-gitignore.ts b/cli/src/inputs/input-gitignore.ts
@@ -1,6 +1,6 @@
 import type {InputCollectedContext, InputPluginContext} from '../plugins/plugin-core'
-import {PUBLIC_GIT_IGNORE_TARGET_RELATIVE_PATH, resolvePublicDefinitionPath} from '../public-config-paths'
 import {AbstractInputPlugin} from '../plugins/plugin-core'
+import {PUBLIC_GIT_IGNORE_TARGET_RELATIVE_PATH, resolvePublicDefinitionPath} from '../public-config-paths'
 
 export class GitIgnoreInputPlugin extends AbstractInputPlugin {
   constructor() {
diff --git a/cli/src/inputs/input-jetbrains-config.ts b/cli/src/inputs/input-jetbrains-config.ts
@@ -1,6 +1,6 @@
-import type {InputCollectedContext} from '../plugins/plugin-core'
+import type {InputCollectedContext, InputPluginContext, ProjectIDEConfigFile} from '../plugins/plugin-core'
+import {AbstractInputPlugin, IDEKind} from '../plugins/plugin-core'
 import {readPublicIdeConfigDefinitionFile} from '../public-config-paths'
-import {AbstractInputPlugin, IDEKind, type InputPluginContext, type ProjectIDEConfigFile} from '../plugins/plugin-core'
 
 export class JetBrainsConfigInputPlugin extends AbstractInputPlugin {
   constructor() {
diff --git a/cli/src/inputs/input-public-config.test.ts b/cli/src/inputs/input-public-config.test.ts
@@ -54,9 +54,7 @@ describe('public config input plugins', () => {
       writePublicDefinition(tempWorkspace, '.idea/codeStyles/Project.xml', '<project />\n')
       writePublicDefinition(tempWorkspace, '.idea/codeStyles/codeStyleConfig.xml', '<component />\n')
 
-      for (const fileName of AI_AGENT_IGNORE_TARGET_RELATIVE_PATHS) {
-        writePublicDefinition(tempWorkspace, fileName, `${fileName}\n`)
-      }
+      for (const fileName of AI_AGENT_IGNORE_TARGET_RELATIVE_PATHS) writePublicDefinition(tempWorkspace, fileName, `${fileName}\n`)
 
       const ctx = createContext(tempWorkspace)
       const gitIgnore = new GitIgnoreInputPlugin().collect(ctx)
@@ -115,10 +113,10 @@ describe('public config input plugins', () => {
 
       expect(new GitIgnoreInputPlugin().collect(ctx).globalGitIgnore).toBeUndefined()
       expect(new GitExcludeInputPlugin().collect(ctx).shadowGitExclude).toBeUndefined()
-      expect((new EditorConfigInputPlugin().collect(ctx).editorConfigFiles ?? [])).toHaveLength(0)
-      expect((new VSCodeConfigInputPlugin().collect(ctx).vscodeConfigFiles ?? [])).toHaveLength(0)
-      expect((new JetBrainsConfigInputPlugin().collect(ctx).jetbrainsConfigFiles ?? [])).toHaveLength(0)
-      expect((new AIAgentIgnoreInputPlugin().collect(ctx).aiAgentIgnoreConfigFiles ?? [])).toHaveLength(0)
+      expect(new EditorConfigInputPlugin().collect(ctx).editorConfigFiles ?? []).toHaveLength(0)
+      expect(new VSCodeConfigInputPlugin().collect(ctx).vscodeConfigFiles ?? []).toHaveLength(0)
+      expect(new JetBrainsConfigInputPlugin().collect(ctx).jetbrainsConfigFiles ?? []).toHaveLength(0)
+      expect(new AIAgentIgnoreInputPlugin().collect(ctx).aiAgentIgnoreConfigFiles ?? []).toHaveLength(0)
     }
     finally {
       fs.rmSync(tempWorkspace, {recursive: true, force: true})
diff --git a/cli/src/inputs/input-shared-ignore.ts b/cli/src/inputs/input-shared-ignore.ts
@@ -1,6 +1,6 @@
 import type {AIAgentIgnoreConfigFile, InputCollectedContext, InputPluginContext} from '../plugins/plugin-core'
-import {AI_AGENT_IGNORE_TARGET_RELATIVE_PATHS, resolvePublicDefinitionPath} from '../public-config-paths'
 import {AbstractInputPlugin} from '../plugins/plugin-core'
+import {AI_AGENT_IGNORE_TARGET_RELATIVE_PATHS, resolvePublicDefinitionPath} from '../public-config-paths'
 
 export class AIAgentIgnoreInputPlugin extends AbstractInputPlugin {
   constructor() {
diff --git a/cli/src/inputs/input-vscode-config.ts b/cli/src/inputs/input-vscode-config.ts
@@ -1,6 +1,6 @@
-import type {InputCollectedContext} from '../plugins/plugin-core'
+import type {InputCollectedContext, InputPluginContext, ProjectIDEConfigFile} from '../plugins/plugin-core'
+import {AbstractInputPlugin, IDEKind} from '../plugins/plugin-core'
 import {readPublicIdeConfigDefinitionFile} from '../public-config-paths'
-import {AbstractInputPlugin, IDEKind, type InputPluginContext, type ProjectIDEConfigFile} from '../plugins/plugin-core'
 
 export class VSCodeConfigInputPlugin extends AbstractInputPlugin {
   constructor() {
diff --git a/cli/src/plugins/CursorOutputPlugin.test.ts b/cli/src/plugins/CursorOutputPlugin.test.ts
@@ -0,0 +1,79 @@
+import type {OutputCleanContext} from './plugin-core'
+import * as fs from 'node:fs'
+import * as os from 'node:os'
+import * as path from 'node:path'
+import glob from 'fast-glob'
+import {describe, expect, it} from 'vitest'
+import {CursorOutputPlugin} from './CursorOutputPlugin'
+import {FilePathKind} from './plugin-core'
+
+class TestCursorOutputPlugin extends CursorOutputPlugin {
+  constructor(private readonly testHomeDir: string) {
+    super()
+  }
+
+  protected override getHomeDir(): string {
+    return this.testHomeDir
+  }
+}
+
+function createCleanContext(): OutputCleanContext {
+  return {
+    logger: {
+      trace: () => {},
+      debug: () => {},
+      info: () => {},
+      warn: () => {},
+      error: () => {}
+    },
+    fs,
+    path,
+    glob,
+    dryRun: true,
+    collectedOutputContext: {
+      workspace: {
+        directory: {
+          pathKind: FilePathKind.Relative,
+          path: '.',
+          basePath: '.',
+          getDirectoryName: () => '.',
+          getAbsolutePath: () => path.resolve('.')
+        },
+        projects: []
+      }
+    }
+  } as OutputCleanContext
+}
+
+describe('cursorOutputPlugin cleanup', () => {
+  it('expands skills cleanup glob into explicit stale targets while preserving built-in skills', async () => {
+    const tempHomeDir = fs.mkdtempSync(path.join(os.tmpdir(), 'tnmsc-cursor-cleanup-'))
+    const skillsDir = path.join(tempHomeDir, '.cursor', 'skills-cursor')
+    const preservedDir = path.join(skillsDir, 'create-rule')
+    const staleDir = path.join(skillsDir, 'legacy-skill')
+
+    fs.mkdirSync(preservedDir, {recursive: true})
+    fs.mkdirSync(staleDir, {recursive: true})
+    fs.writeFileSync(path.join(preservedDir, 'SKILL.md'), '# preserved', 'utf8')
+    fs.writeFileSync(path.join(staleDir, 'SKILL.md'), '# stale', 'utf8')
+
+    try {
+      const plugin = new TestCursorOutputPlugin(tempHomeDir)
+      const result = await plugin.declareCleanupPaths(createCleanContext())
+      const deletePaths = result.delete?.map(target => target.path.replaceAll('\\', '/')) ?? []
+      const protectPaths = result.protect?.map(target => target.path.replaceAll('\\', '/')) ?? []
+      const normalizedCommandsDir = path.join(tempHomeDir, '.cursor', 'commands').replaceAll('\\', '/')
+      const normalizedStaleDir = staleDir.replaceAll('\\', '/')
+      const normalizedPreservedDir = preservedDir.replaceAll('\\', '/')
+
+      expect(deletePaths).toContain(normalizedCommandsDir)
+      expect(deletePaths).toContain(normalizedStaleDir)
+      expect(result.delete?.some(target => target.kind === 'glob' && target.path.includes('skills-cursor'))).toBe(false)
+      expect(deletePaths).not.toContain(normalizedPreservedDir)
+      expect(protectPaths).toContain(normalizedPreservedDir)
+    }
+    finally {
+      fs.rmSync(tempHomeDir, {recursive: true, force: true})
+    }
+  })
+})
diff --git a/cli/src/plugins/CursorOutputPlugin.ts b/cli/src/plugins/CursorOutputPlugin.ts
@@ -1,5 +1,8 @@
 import type {
   CommandPrompt,
+  OutputCleanContext,
+  OutputCleanupDeclarations,
+  OutputCleanupPathDeclaration,
   OutputFileDeclaration,
   OutputWriteContext,
   RulePrompt,
@@ -103,6 +106,14 @@ export class CursorOutputPlugin extends AbstractOutputPlugin {
     })
   }
 
+  override async declareCleanupPaths(ctx: OutputCleanContext): Promise<OutputCleanupDeclarations> {
+    const declarations = await super.declareCleanupPaths(ctx)
+    return {
+      ...declarations,
+      delete: this.expandCursorSkillCleanupTargets(ctx, declarations.delete ?? [])
+    }
+  }
+
   override async declareOutputFiles(ctx: OutputWriteContext): Promise<OutputFileDeclaration[]> {
     const declarations: OutputFileDeclaration[] = []
     const {workspace, globalMemory, commands, skills, rules, aiAgentIgnoreConfigFiles} = ctx.collectedOutputContext
@@ -300,6 +311,64 @@ export class CursorOutputPlugin extends AbstractOutputPlugin {
 
   private isPreservedSkill(name: string): boolean { return PRESERVED_SKILLS.has(name) }
 
+  private expandCursorSkillCleanupTargets(
+    ctx: OutputCleanContext,
+    declarations: readonly OutputCleanupPathDeclaration[]
+  ): OutputCleanupPathDeclaration[] {
+    const expanded: OutputCleanupPathDeclaration[] = []
+
+    for (const declaration of declarations) {
+      if (!this.isCursorSkillCleanupGlob(declaration)) {
+        expanded.push(declaration)
+        continue
+      }
+
+      for (const matchedTarget of this.listCursorSkillCleanupTargets(ctx, declaration.path)) {
+        expanded.push({
+          path: matchedTarget.path,
+          kind: matchedTarget.kind,
+          ...declaration.scope != null ? {scope: declaration.scope} : {},
+          ...declaration.label != null ? {label: declaration.label} : {}
+        })
+      }
+    }
+
+    return expanded
+  }
+
+  private isCursorSkillCleanupGlob(declaration: OutputCleanupPathDeclaration): boolean {
+    if (declaration.kind !== 'glob') return false
+
+    const skillsGlob = this.joinPath(this.getGlobalConfigDir(), SKILLS_CURSOR_SUBDIR, '*')
+      .replaceAll('\\', '/')
+
+    return declaration.path.replaceAll('\\', '/') === skillsGlob
+  }
+
+  private listCursorSkillCleanupTargets(
+    ctx: OutputCleanContext,
+    pattern: string
+  ): {path: string, kind: 'file' | 'directory'}[] {
+    const matchedPaths = ctx.glob.sync(pattern.replaceAll('\\', '/'), {
+      onlyFiles: false,
+      dot: true,
+      absolute: true,
+      followSymbolicLinks: false
+    })
+
+    return matchedPaths.flatMap((matchedPath): {path: string, kind: 'file' | 'directory'}[] => {
+      if (this.isPreservedSkill(path.basename(matchedPath))) return []
+
+      try {
+        const stat = ctx.fs.lstatSync(matchedPath)
+        return [{path: matchedPath, kind: stat.isDirectory() ? 'directory' : 'file'}]
+      }
+      catch {
+        return []
+      }
+    })
+  }
+
   protected buildRuleMdcContent(rule: RulePrompt): string {
     const fmData: Record<string, unknown> = {alwaysApply: false, globs: rule.globs.length > 0 ? rule.globs.join(', ') : ''}
     const raw = buildMarkdownWithFrontMatter(fmData, rule.content)
diff --git a/cli/src/plugins/ide-config-output.test.ts b/cli/src/plugins/ide-config-output.test.ts
@@ -2,9 +2,9 @@ import type {OutputWriteContext, Project, ProjectIDEConfigFile} from './plugin-c
 import * as fs from 'node:fs'
 import * as path from 'node:path'
 import {describe, expect, it} from 'vitest'
-import {createLogger, FilePathKind, IDEKind} from './plugin-core'
 import {EditorConfigOutputPlugin} from './EditorConfigOutputPlugin'
 import {JetBrainsIDECodeStyleConfigOutputPlugin} from './JetBrainsIDECodeStyleConfigOutputPlugin'
+import {createLogger, FilePathKind, IDEKind} from './plugin-core'
 import {VisualStudioCodeIDEConfigOutputPlugin} from './VisualStudioCodeIDEConfigOutputPlugin'
 
 function createProject(workspaceBase: string, name: string, promptSource = false): Project {
diff --git a/cli/src/public-config-paths.ts b/cli/src/public-config-paths.ts
@@ -1,7 +1,8 @@
-import * as path from 'node:path'
+import type {IDEKind} from './plugins/plugin-core/enums'
 import type {ProjectIDEConfigFile} from './plugins/plugin-core/InputTypes'
+import * as path from 'node:path'
 import {AINDEX_FILE_NAMES} from './plugins/plugin-core/AindexTypes'
-import {FilePathKind, IDEKind} from './plugins/plugin-core/enums'
+import {FilePathKind} from './plugins/plugin-core/enums'
 
 export const PUBLIC_CONFIG_DEFINITION_DIR = 'public'
 
@@ -33,9 +34,8 @@ export function resolvePublicDefinitionPath(aindexDir: string, targetRelativePat
 }
 
 export function collectKnownPublicConfigDefinitionPaths(aindexDir: string): string[] {
-  return KNOWN_PUBLIC_CONFIG_TARGET_RELATIVE_PATHS.map(targetRelativePath => (
-    resolvePublicDefinitionPath(aindexDir, targetRelativePath)
-  ))
+  return KNOWN_PUBLIC_CONFIG_TARGET_RELATIVE_PATHS.map(targetRelativePath =>
+    resolvePublicDefinitionPath(aindexDir, targetRelativePath))
 }
 
 export function readPublicIdeConfigDefinitionFile<T extends IDEKind>(
diff --git a/libraries/md-compiler/src/index.ts b/libraries/md-compiler/src/index.ts
diff --git a/libraries/md-compiler/src/mdx-to-md.ts b/libraries/md-compiler/src/mdx-to-md.ts
