@truenine/memory-sync-cli 2026.10105.0 → 2026.10107.0

package/README.md

@@ -0,0 +1,160 @@
+# # memory-sync-cli
+
+Cross-AI programming tool prompt synchronisation utility. One ruleset, multi-platform adaptation.
+
+## Quick Start
+
+```bash
+npx @truenine/memory-sync-cli
+```
+
+## Global Installation
+
+```bash
+pnpm add -g @truenine/memory-sync-cli
+```
+
+## Update Version
+
+```bash
+pnpm update -g @truenine/memory-sync-cli --latest
+```
+
+After installation, use the command directly:
+
+```bash
+tnmsc
+```
+
+Available features:
+
+```bash
+# Direct sync
+tnmsc
+
+# Get help
+tnmsc help
+tnmsc --help
+tnmsc -h
+
+# View version
+tnmsc version
+tnmsc --version
+tnmsc -v
+
+# Check for updates
+tnmsc outdated
+
+# Initialise directory and file structure based on config file and defaults
+tnmsc init
+
+# Preview export
+tnmsc dry-run
+
+# Clean all exports
+tnmsc clean
+
+# Preview clean targets
+tnmsc clean --dry-run
+tnmsc clean -n
+
+# Set config options
+tnmsc set key=value
+tnmsc --set key=value
+
+# Set log level
+tnmsc --trace
+tnmsc --debug
+tnmsc --info
+tnmsc --warn
+tnmsc --error
+```
+
+## CLI Configuration
+
+Configuration can be created in two locations. Example below shows default config:
+
+```text
+~/.aindex/.tnmsc.json
+cwd()/.tnmsc.json
+```
+
+> cwd() represents the current command execution directory.
+
+```json
+{
+  "workspaceDir": "~/project",
+  "shadowSourceProjectDir": "$WORKSPACE/aindex",
+  "shadowSkillSourceDir": "$SHADOW_SOURCE_PROJECT/dist/skills",
+  "shadowFastCommandDir": "$SHADOW_SOURCE_PROJECT/dist/commands",
+  "shadowSubAgentDir": "$SHADOW_SOURCE_PROJECT/dist/agents",
+  "globalMemoryFile": "$SHADOW_SOURCE_PROJECT/dist/global.md",
+  "shadowProjectsDir": "$SHADOW_SOURCE_PROJECT/dist/app",
+  "externalProjects": [],
+  "excludePatterns": {},
+  "logLevel": "info"
+}
+```
+
+### SET Available Config Options
+
+- `workspaceDir` - Workspace directory
+- `shadowSourceProjectDir` - Shadow source project directory
+- `shadowSkillSourceDir` - Skill source directory
+- `shadowFastCommandDir` - Fast command directory
+- `shadowSubAgentDir` - Sub-agent directory
+- `globalMemoryFile` - Global memory file
+- `shadowProjectsDir` - Shadow projects directory
+- `logLevel` - Log level (trace/debug/info/warn/error)
+
+Example:
+
+```bash
+tnmsc --set workspaceDir=~/my-project
+tnmsc --set logLevel=debug
+tnmsc set workspaceDir=~/workspace
+```
+
+## Supported AI Tools
+
+**IDE**
+
+- Cursor IDE
+- Kiro IDE
+- Windsurf IDE
+- Qoder IDE
+- CodeBuddy IDE
+- Antigravity IDE
+
+**CLI Tools**
+
+- Claude Code CLI
+- Codex CLI
+- Gemini CLI
+- FactoryDroid CLI
+
+**Config Files**
+
+- JetBrains IDE
+- VSCode IDE
+
+## Plugin System
+
+Uses input → transform → output pipeline architecture:
+
+- **Input Plugins**: Read source files (Aindex, Ref, WorkspaceGroup)
+- **Transform Plugins**: Process content
+- **Output Plugins**: Write to target formats (various IDE/CLI adapters)
+
+## Configuration
+
+Config file priority: `cwd()/.tnmsc.json` > `~/.aindex/.tnmsc.json`
+
+## Created by
+
+- [Truenine](https://github.com/TrueNine)
+- [zjarlin](https://github.com/zjarlin)
+
+## License
+
+UNLICENSED

package/dist/globals/index.d.mts

@@ -0,0 +1,180 @@
+//#region src/globals/index.d.ts
+/**
+ * User profile information
+ * @example {profile.name}, {profile.username}
+ */
+interface UserProfile {
+  name?: string;
+  username?: string;
+  gender?: string;
+  birthday?: string;
+  [key: string]: unknown;
+}
+/**
+ * Tool references for AI assistants
+ * @example {tool.websearch}, {tool.webfetch}, {tool.readFile}
+ */
+interface ToolReferences {
+  /** Web search tool name */
+  websearch?: string;
+  /** Web fetch tool name */
+  webfetch?: string;
+  /** Read file tool name */
+  readFile?: string;
+  /** Write file tool name */
+  writeFile?: string;
+  /** Execute command/shell tool name */
+  executeCommand?: string;
+  /** Todolist write tool name */
+  todolistWrite?: string;
+  /** Grep/search tool name */
+  grep?: string;
+  /** Allow custom tool references */
+  [key: string]: string | undefined;
+}
+/**
+ * Tool name presets for different AI tools.
+ * Each preset provides tool name mappings specific to that AI tool.
+ */
+declare const ToolPresets: {
+  /** Default tool names (snake_case) */
+  readonly default: {
+    readonly websearch: "web_search";
+    readonly webfetch: "web_fetch";
+    readonly readFile: "read_file";
+    readonly writeFile: "write_file";
+    readonly executeCommand: "execute_command";
+    readonly todolistWrite: "todolist_write";
+    readonly grep: "grep";
+  };
+  /** Claude Code CLI tool names (PascalCase) */
+  readonly claudeCode: {
+    readonly readFile: "Read";
+    readonly writeFile: "Write";
+    readonly executeCommand: "Execute";
+    readonly todolistWrite: "TodoWrite";
+  };
+  /** Kiro tool names */
+  readonly kiro: {
+    readonly websearch: "remote_web_search";
+    readonly webfetch: "webFetch";
+    readonly readFile: "readFile";
+    readonly writeFile: "fsWrite";
+    readonly executeCommand: "executeBash";
+    readonly todolistWrite: "todolistWrite";
+    readonly grep: "grepSearch";
+  };
+};
+/**
+ * Environment context
+ * @example {env.NODE_ENV}, {env.DEBUG}
+ */
+interface EnvironmentContext {
+  [key: string]: unknown;
+}
+/**
+ * Shell kind enumeration
+ */
+declare enum ShellKind {
+  Bash = "bash",
+  Zsh = "zsh",
+  Fish = "fish",
+  Sh = "sh",
+  PowerShell = "powershell",
+  Pwsh = "pwsh",
+  Cmd = "cmd",
+  Unknown = "unknown",
+}
+/**
+ * Operating system kind enumeration
+ * Simplified OS type for conditional logic in templates
+ * @example {os.kind === 'mac' ? 'macOS specific' : 'other'}
+ */
+declare enum OsKind {
+  Win = "win",
+  Mac = "mac",
+  Linux = "linux",
+  Unknown = "unknown",
+}
+/**
+ * Operating system information
+ * @example {os.platform}, {os.arch}, {os.shellKind}, {os.kind}
+ */
+interface OsInfo {
+  platform?: string;
+  arch?: string;
+  hostname?: string;
+  homedir?: string;
+  tmpdir?: string;
+  type?: string;
+  release?: string;
+  shellKind?: ShellKind;
+  kind?: OsKind;
+  [key: string]: string | ShellKind | OsKind | undefined;
+}
+/**
+ * Md component props - wrapper for conditional Markdown content
+ * @example <Md when={os.kind === 'mac'}>macOS specific content</Md>
+ */
+interface MdProps {
+  /** Condition for rendering content. If omitted, content always renders. */
+  when?: boolean;
+  /** Child content to render when condition is met */
+  children?: unknown;
+}
+/**
+ * Md.Line component props - inline conditional text
+ * @example <Md.Line when={os.kind === 'win'}>PowerShell</Md.Line>
+ */
+interface MdLineProps {
+  /** Condition for rendering content. If omitted, content always renders. */
+  when?: boolean;
+  /** Inline text content to render when condition is met */
+  children?: unknown;
+}
+/**
+ * Md component type with Line sub-component
+ */
+interface MdComponent {
+  /**
+   * Block-level conditional Markdown wrapper
+   * @param props - Component props including optional `when` condition
+   * @returns Rendered content or nothing if condition is false
+   */
+  (props: MdProps): unknown;
+  /**
+   * Inline conditional text component
+   * @param props - Component props including optional `when` condition
+   * @returns Inline text or nothing if condition is false
+   */
+  Line: (props: MdLineProps) => unknown;
+}
+/**
+ * Global scope available in MDX expressions
+ */
+interface MdxGlobalScope {
+  /** User profile information */
+  profile: UserProfile;
+  /** Tool name references for AI assistants */
+  tool: ToolReferences;
+  /** Environment variables context */
+  env: EnvironmentContext;
+  /** Operating system information */
+  os: OsInfo;
+  /** Conditional Markdown component with Line sub-component */
+  Md: MdComponent;
+}
+declare global {
+  /** User profile information */
+  const profile: UserProfile;
+  /** Tool name references for AI assistants */
+  const tool: ToolReferences;
+  /** Environment variables context */
+  const env: EnvironmentContext;
+  /** Operating system information */
+  const os: OsInfo;
+  /** Conditional Markdown component with Line sub-component */
+  const Md: MdComponent;
+}
+//#endregion
+export { EnvironmentContext, MdComponent, MdLineProps, MdProps, MdxGlobalScope, OsInfo, OsKind, ShellKind, ToolPresets, ToolReferences, UserProfile };

package/dist/globals/index.mjs

@@ -0,0 +1 @@
+const e={default:{websearch:`web_search`,webfetch:`web_fetch`,readFile:`read_file`,writeFile:`write_file`,executeCommand:`execute_command`,todolistWrite:`todolist_write`,grep:`grep`},claudeCode:{readFile:`Read`,writeFile:`Write`,executeCommand:`Execute`,todolistWrite:`TodoWrite`},kiro:{websearch:`remote_web_search`,webfetch:`webFetch`,readFile:`readFile`,writeFile:`fsWrite`,executeCommand:`executeBash`,todolistWrite:`todolistWrite`,grep:`grepSearch`}};let t=function(e){return e.Bash=`bash`,e.Zsh=`zsh`,e.Fish=`fish`,e.Sh=`sh`,e.PowerShell=`powershell`,e.Pwsh=`pwsh`,e.Cmd=`cmd`,e.Unknown=`unknown`,e}({}),n=function(e){return e.Win=`win`,e.Mac=`mac`,e.Linux=`linux`,e.Unknown=`unknown`,e}({});export{n as OsKind,t as ShellKind,e as ToolPresets};