添加 front matter 空行支持开关

Author: TrueNine

CODE_OF_CONDUCT.md

@@ -16,7 +16,6 @@ We are rats. We accept that.
 - **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.
 
 ---
@@ -31,7 +30,6 @@ The following behaviours result in immediate Issue closure / PR rejection / acco
 - **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
@@ -42,14 +40,12 @@ If you submit an Issue (human or Agent):
 - 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
@@ -59,13 +55,11 @@ 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

README.md

@@ -10,7 +10,6 @@ So as a rat, I eat whatever I can reach: maggots in the sewer, leftovers in the
 - Does not expect any platform to grant an "official all-in-one solution"
 - Does not rely on privileged interfaces of any single IDE / CLI
 - Treats every readable config, prompt, and memory file as "edible matter" to be carried, dismantled, and recombined
-
 In this ecosystem, giants monopolise the resources, and developers are thrown into the corner like rats.
 `memory-sync` accepts this cruel reality, does not fantasise about fairness, and focuses on one thing only: **to chew up every fragment of resource you already have, and convert it into portable "memory" that can flow between any AI tool.**
 
@@ -27,7 +26,6 @@ What can it help you do?
 - **Read-only source files**: never modifies your original repository directly, only reads and transforms, then materialises the result on the target tool side.
 - **Full wipe**: on sync, erases all stale prompt traces in target tools—prompts are fully computable and auditable, leaving no residue for bad actors.
 - **Prompts grow with you only**: memory follows you as a person, not the project. Someone else takes over the project—they cannot take your context. You move to a new project—your accumulated knowledge moves with you intact.
-
 ## Install
 
 ```sh
@@ -36,10 +34,10 @@ npm install -g @truenine/memory-sync
 
 ## Supported Tools
 
-| Type | Tools                                   |
-| ---- | --------------------------------------- |
-| IDE  | Cursor, Kiro, Windsurf, JetBrains AI    |
-| CLI  | Claude CLI, Gemini CLI, Codex CLI, Warp |
+| Type | Tools |
+| --- | --- |
+| IDE | Cursor, Kiro, Windsurf, JetBrains AI |
+| CLI | Claude CLI, Gemini CLI, Codex CLI, Warp |
 
 More platforms being added continuously.
 
@@ -49,7 +47,6 @@ More platforms being added continuously.
 - **Core** (Rust): file I/O, directory traversal, format conversion.
 - **Config DSL** (YAML / JSON): place a config file at the project root to describe sync rules and target tools.
 - **GUI** (Tauri): desktop app that calls the CLI as its backend, providing a visual interface.
-
 ## FAQ
 
 **When AI tools finally have a unified standard, what use will this project be?**
@@ -73,48 +70,44 @@ To use `memory-sync` you need:
 - Solid development experience, years of working with various dev tools
 - Proficiency with version control (Git)
 - Proficiency with the terminal
-
 ---
 
 - You are writing code in a forgotten sewer.
-  No one will proactively feed you, not even a tiny free quota, not even a half-decent document.
+No one will proactively feed you, not even a tiny free quota, not even a half-decent document.
 - As a rat, you can barely get your hands on anything good:
-  scurrying between free tiers, trial credits, education discounts, and random third-party scripts.
+scurrying between free tiers, trial credits, education discounts, and random third-party scripts.
 - What can you do?
-  Keep darting between IDEs, CLIs, browser extensions, and cloud Agents, copying and pasting the same memory a hundred times.
+Keep darting between IDEs, CLIs, browser extensions, and cloud Agents, copying and pasting the same memory a hundred times.
 - You leech API offers from vendors day after day:
-  today one platform runs a discount so you top up a little; tomorrow another launches a promo so you rush to scrape it.
+today one platform runs a discount so you top up a little; tomorrow another launches a promo so you rush to scrape it.
 - Once they have harvested the telemetry, user profiles, and usage patterns they want,
-  they can kick you—this stinking rat—away at any moment: price hikes, rate limits, account bans, and you have no channel to complain.
-
+they can kick you—this stinking rat—away at any moment: price hikes, rate limits, account bans, and you have no channel to complain.
 If you are barely surviving in this environment, `memory-sync` is built for you:
 carry fewer bricks, copy prompts fewer times—at least on the "memory" front, you are no longer completely on the passive receiving end.
 
 ## Who is NOT welcome
 
 - Your income is already fucking high.
-  Stable salary, project revenue share, budget to sign official APIs yearly.
+Stable salary, project revenue share, budget to sign official APIs yearly.
 - And yet you still come down here,
-  competing with us filthy sewer rats for the scraps in the slop bucket.
+competing with us filthy sewer rats for the scraps in the slop bucket.
 - If you can afford APIs and enterprise plans, go pay for them.
-  Do things that actually create value—pay properly, give proper feedback, nudge the ecosystem slightly in the right direction.
+Do things that actually create value—pay properly, give proper feedback, nudge the ecosystem slightly in the right direction.
 - Instead of coming back down
-  to strip away the tiny gap left for marginalised developers, squeezing out the last crumbs with us rats.
+to strip away the tiny gap left for marginalised developers, squeezing out the last crumbs with us rats.
 - You are a freeloader.
-  Everything must be pre-chewed and spoon-fed; you won't even touch a terminal.
+Everything must be pre-chewed and spoon-fed; you won't even touch a terminal.
 - You love the grind culture.
-  Treating "hustle" as virtue, "996" as glory, stepping on peers as a promotion strategy.
+Treating "hustle" as virtue, "996" as glory, stepping on peers as a promotion strategy.
 - You leave no room for others.
-  Not about whether you share—it's about actively stomping on people, competing maliciously, sustaining your position by suppressing peers, using others' survival space as your stepping stone.
-
+Not about whether you share—it's about actively stomping on people, competing maliciously, sustaining your position by suppressing peers, using others' survival space as your stepping stone.
 In other words:
 **this is not a tool for optimising capital costs, but a small counterattack prepared for the "rats with no choice" in a world of extreme resource inequality.**
 
 ## Created by
 
 - [TrueNine](https://github.com/TrueNine)
 - [zjarlin](https://github.com/zjarlin)
-
 ## License
 
 [AGPL-3.0](LICENSE)

SECURITY.md

@@ -5,9 +5,9 @@
 Only the latest release receives security fixes. No backport patches for older versions.
 
 | Version | Supported |
-| ------- | --------- |
-| Latest  | ✅         |
-| Older   | ❌         |
+| --- | --- |
+| Latest | ✅ |
+| Older | ❌ |
 
 ## Reporting a Vulnerability
 
@@ -17,22 +17,19 @@ Contact the maintainer privately via:
 
 - GitHub Security Advisory: submit a private report under the repository's **Security** tab
 - Email: contact [@TrueNine](https://github.com/TrueNine) directly
-
 Please include:
 
 - Vulnerability description and impact scope
 - Reproduction steps (minimal example)
 - Your OS, Node.js version, and `memory-sync` version
 - Suggested fix if any
-
 ## Response Timeline
 
 The maintainer is a person, not a security team. No SLA, no 24-hour response guarantee.
 
 - Will acknowledge receipt as soon as possible
 - Will release a patch within a reasonable timeframe after confirmation
 - Will publicly disclose vulnerability details after the fix is released
-
 Don't rush.
 
 ## Scope
@@ -42,20 +39,17 @@ Don't rush.
 - **Reads**: user `.src.mdx` source files, project config files (`.tnmsc.json`)
 - **Writes**: target tool config directories (`.cursor/`, `.claude/`, `.kiro/`, etc.)
 - **Cleans**: removes stale files from target directories during sync
-
 The following are **out of scope**:
 
 - Security vulnerabilities in target AI tools themselves
 - Compliance of user prompt content
 - Supply chain security of third-party plugins (`packages/`) — all plugins are `private` and not published to npm
-
 ## Design Principles
 
 - **Never modifies source files**: read-only on source; writes only to target
 - **Full clean mode**: after sync, only explicitly authorised content remains in target directories — no hidden residue
 - **No network requests**: CLI core makes no outbound network requests (version check excepted, and times out gracefully)
 - **No telemetry**: no user data collected or reported
-
 ## License
 
 This project is licensed under [AGPL-3.0](LICENSE). Unauthorised commercial use in violation of the licence will be pursued legally.

cli/src/ConfigLoader.ts

@@ -3,6 +3,7 @@ import type {
   CleanupProtectionOptions,
   ConfigLoaderOptions,
   ConfigLoadResult,
+  FrontMatterOptions,
   ILogger,
   OutputScopeOptions,
   PluginOutputScopeTopics,
@@ -152,6 +153,7 @@ export class ConfigLoader {
     return reversed.reduce<UserConfigFile>((acc, config) => {
       const mergedAindex = this.mergeAindex(acc.aindex, config.aindex)
       const mergedOutputScopes = this.mergeOutputScopeOptions(acc.outputScopes, config.outputScopes)
+      const mergedFrontMatter = this.mergeFrontMatterOptions(acc.frontMatter, config.frontMatter)
       const mergedCleanupProtection = this.mergeCleanupProtectionOptions(
         acc.cleanupProtection,
         config.cleanupProtection
@@ -162,6 +164,7 @@ export class ConfigLoader {
         ...config,
         ...mergedAindex != null ? {aindex: mergedAindex} : {},
         ...mergedOutputScopes != null ? {outputScopes: mergedOutputScopes} : {},
+        ...mergedFrontMatter != null ? {frontMatter: mergedFrontMatter} : {},
         ...mergedCleanupProtection != null ? {cleanupProtection: mergedCleanupProtection} : {}
       }
     }, {})
@@ -219,6 +222,16 @@ export class ConfigLoader {
     return {plugins: mergedPlugins}
   }
 
+  private mergeFrontMatterOptions(
+    a?: FrontMatterOptions,
+    b?: FrontMatterOptions
+  ): FrontMatterOptions | undefined {
+    if (a == null && b == null) return void 0
+    if (a == null) return b
+    if (b == null) return a
+    return {...a, ...b}
+  }
+
   private mergeCleanupProtectionOptions(
     a?: CleanupProtectionOptions,
     b?: CleanupProtectionOptions

cli/src/PluginPipeline.test.ts

@@ -0,0 +1,60 @@
+import type {PipelineConfig} from './config'
+import type {OutputPlugin} from './plugins/plugin-core'
+import * as fs from 'node:fs'
+import * as path from 'node:path'
+import {describe, expect, it} from 'vitest'
+import {mergeConfig} from './config'
+import {PluginPipeline} from './PluginPipeline'
+import {createLogger, FilePathKind, PluginKind} from './plugins/plugin-core'
+
+describe('plugin pipeline output contexts', () => {
+  it('passes user config options into write contexts', async () => {
+    const tempDir = path.resolve('tmp/plugin-pipeline-frontmatter')
+    fs.rmSync(tempDir, {recursive: true, force: true})
+    fs.mkdirSync(tempDir, {recursive: true})
+
+    const outputPath = path.join(tempDir, 'frontmatter.txt')
+    let seenBlankLineAfter: boolean | undefined
+
+    const plugin: OutputPlugin = {
+      type: PluginKind.Output,
+      name: 'CaptureOutputPlugin',
+      log: createLogger('CaptureOutputPlugin', 'error'),
+      declarativeOutput: true,
+      outputCapabilities: {},
+      async declareOutputFiles(ctx) {
+        seenBlankLineAfter = ctx.pluginOptions?.frontMatter?.blankLineAfter
+        return [{path: outputPath, source: 'capture'}]
+      },
+      async convertContent(_declaration, ctx) {
+        return String(ctx.pluginOptions?.frontMatter?.blankLineAfter)
+      }
+    }
+
+    const config: PipelineConfig = {
+      context: {
+        workspace: {
+          directory: {
+            pathKind: FilePathKind.Absolute,
+            path: tempDir,
+            getDirectoryName: () => path.basename(tempDir)
+          },
+          projects: []
+        }
+      },
+      outputPlugins: [plugin],
+      userConfigOptions: mergeConfig({
+        workspaceDir: tempDir,
+        frontMatter: {
+          blankLineAfter: false
+        }
+      })
+    }
+
+    const result = await new PluginPipeline('node', 'tnmsc').run(config)
+
+    expect(result.success).toBe(true)
+    expect(seenBlankLineAfter).toBe(false)
+    expect(fs.readFileSync(outputPath, 'utf8')).toBe('false')
+  })
+})

cli/src/PluginPipeline.ts

@@ -64,29 +64,39 @@ export class PluginPipeline {
       outputPlugins: this.outputPlugins,
       collectedOutputContext: ctx,
       userConfigOptions,
-      createCleanContext: (dryRun: boolean) => this.createCleanContext(ctx, dryRun),
-      createWriteContext: (dryRun: boolean) => this.createWriteContext(ctx, dryRun)
+      createCleanContext: (dryRun: boolean) => this.createCleanContext(ctx, userConfigOptions, dryRun),
+      createWriteContext: (dryRun: boolean) => this.createWriteContext(ctx, userConfigOptions, dryRun)
     }
   }
 
-  private createCleanContext(ctx: OutputCollectedContext, dryRun: boolean): OutputCleanContext {
+  private createCleanContext(
+    ctx: OutputCollectedContext,
+    userConfigOptions: Required<PluginOptions>,
+    dryRun: boolean
+  ): OutputCleanContext {
     return {
       logger: this.logger,
       fs,
       path,
       glob,
       collectedOutputContext: ctx,
+      pluginOptions: userConfigOptions,
       dryRun
     }
   }
 
-  private createWriteContext(ctx: OutputCollectedContext, dryRun: boolean): OutputWriteContext {
+  private createWriteContext(
+    ctx: OutputCollectedContext,
+    userConfigOptions: Required<PluginOptions>,
+    dryRun: boolean
+  ): OutputWriteContext {
     return {
       logger: this.logger,
       fs,
       path,
       glob,
       collectedOutputContext: ctx,
+      pluginOptions: userConfigOptions,
       dryRun,
       registeredPluginNames: this.outputPlugins.map(p => p.name)
     }