synctax 2.0.0 → 2.0.1

package/CHANGELOG.md

@@ -7,6 +7,21 @@ Versioning follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ---
 
+## [2.0.1] — 2026-04-05
+
+### Fixed
+
+- **TUI data loader**: Invalid `source` in config now correctly falls back to the default adapter instead of remaining set to the invalid value, preventing downstream TUI failures
+- **TUI data loader**: Theme fallback now uses `"rebel"` to match the schema default in `src/types.ts` (was `"synctax"`, causing inconsistent defaults)
+- **TUI entrypoint**: `NODE_ENV` is now restored in the `finally` block after `waitUntilExit()`, ensuring it is always restored even if `render()` throws, and that it doesn't affect code running during the TUI lifetime
+- **Atomic writes**: Temp file now uses a unique name (`pid-timestamp-random` suffix) instead of a deterministic `.synctax-tmp` suffix, preventing stale file collisions from crashed writes under concurrent access
+- **Lock errors**: Error messages now interpolate the actual computed `lockPath` instead of hardcoding `~/.synctax/sync.lock`, which was misleading when `SYNCTAX_HOME` is set (e.g., in tests)
+- **ESLint config**: `.tsx` files (Ink/React TUI components) are now covered by the ESLint config alongside `.ts` files
+- **Module entry**: `index.ts` no longer emits an unconditional `console.log` side effect on import; replaced with `export {}`
+- **`synctax add`**: Scope flag resolution for `agent` and `skill` now mirrors MCP: `--global` → `"global"`, `--local` → `"local"`, neither → `"global"` (was: `agent`/`skill` ignored `--local` and defaulted to `"local"`, inconsistent with MCP)
+
+---
+
 ## [2.0.0] — 2026-04-05
 
 ### Initial Release

package/README.md

@@ -7,9 +7,9 @@
 
 <p align="center">
   <a href="https://github.com/Kaos599/Synctax/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/Kaos599/Synctax/actions/workflows/ci.yml/badge.svg" /></a>
-  <img alt="version" src="https://img.shields.io/github/package-json/v/Kaos599/Synctax?color=brightgreen" />
+  <a href="https://www.npmjs.com/package/synctax"><img alt="npm" src="https://img.shields.io/npm/v/synctax?color=brightgreen" /></a>
   <img alt="license" src="https://img.shields.io/github/license/Kaos599/Synctax?color=blue" />
-  <img alt="runtime" src="https://img.shields.io/badge/runtime-bun-orange" />
+  <img alt="runtime" src="https://img.shields.io/badge/node-%E2%89%A518-brightgreen" />
   <img alt="clients" src="https://img.shields.io/badge/clients-9%20supported-lightgrey" />
 </p>
 
@@ -29,21 +29,24 @@ Synctax eliminates this. One master config at `~/.synctax/config.json`. One comm
 
 ## Install
 
-**Prerequisites:** [Bun](https://bun.sh) v1.0+
+```bash
+npm install -g synctax
+```
+
+Works with npm, pnpm, yarn, or Bun:
 
 ```bash
-git clone https://github.com/Kaos599/synctax.git
-cd synctax
-bun install
-bun ./bin/synctax.ts init
-bun ./bin/synctax.ts sync
+pnpm add -g synctax
+yarn global add synctax
+bun add -g synctax
 ```
 
-After `init` completes its optional PATH setup, you can use the short form everywhere:
+**Requires Node.js ≥18.** No other runtime needed — Synctax is a self-contained bundle.
+
+Then initialize:
 
 ```bash
 synctax init
-synctax sync
 ```
 
 ---
@@ -138,10 +141,10 @@ synctax sync --interactive    # Select which resources to sync
 |--------|-----|--------|--------|-------------|
 | Claude Code | ✅ | ✅ | ✅ | `CLAUDE.md` |
 | Cursor | ✅ | ✅ | ✅ | `.cursorrules` |
-| GitHub Copilot | ✅ | ✅ | ✅ | `.github/copilot-instructions.md` |
-| GitHub Copilot CLI | ✅ | ✅ | ✅ | `.github/copilot-instructions.md` |
 | OpenCode | ✅ | ✅ | ✅ | `AGENTS.md` |
 | Antigravity | ✅ | ✅ | ✅ | `.antigravityrules` |
+| GitHub Copilot (VS Code) | ✅ | — | — | `.github/copilot-instructions.md` |
+| GitHub Copilot CLI | — | — | ✅ | `.github/copilot-instructions.md` |
 | Cline | ✅ | — | — | `.clinerules` |
 | Zed | ✅ | — | — | `.rules` |
 | Gemini CLI | — | — | — | `.geminirules` |
@@ -238,7 +241,16 @@ synctax profile diff personal
 
 ## Development
 
+**Prerequisites for contributing:** [Bun](https://bun.sh) v1.0+
+
 ```bash
+git clone https://github.com/Kaos599/synctax.git
+cd synctax
+bun install
+
+# Run the CLI directly from source
+bun ./bin/synctax.ts <command>
+
 # Run all tests
 bun run test
 
@@ -251,8 +263,8 @@ bun run lint
 # Run a single test file
 bunx vitest run tests/adapters.test.ts
 
-# Run the CLI directly
-bun ./bin/synctax.ts <command>
+# Build the Node.js bundle (what gets published to npm)
+bun run build
 ```
 
 ---

package/dist/synctax.js

@@ -16175,7 +16175,8 @@ import path from "path";
 async function atomicWriteFile(targetPath, content, mode) {
   const dir = path.dirname(targetPath);
   await fs.mkdir(dir, { recursive: true }).catch(() => {});
-  const tempPath = targetPath + ".synctax-tmp";
+  const tmpSuffix = `${process.pid}-${Date.now()}-${Math.random().toString(36).slice(2)}`;
+  const tempPath = `${targetPath}.synctax-tmp-${tmpSuffix}`;
   await fs.writeFile(tempPath, content, {
     encoding: "utf-8",
     mode: mode ?? 420
@@ -24252,7 +24253,7 @@ var init_adapters = __esm(() => {
 
 // src/version.ts
 function getVersion() {
-  return "2.0.0";
+  return "2.0.1";
 }
 
 // node_modules/@inquirer/core/dist/lib/key.js
@@ -26945,7 +26946,7 @@ async function acquireLock(command = "unknown") {
         try {
           await tryWrite();
         } catch {
-          throw new Error("Another synctax process is running. If this is incorrect, delete ~/.synctax/sync.lock");
+          throw new Error(`Another synctax process is running. If this is incorrect, delete ${lockPath}`);
         }
       } else {
         let holder = "unknown";
@@ -26954,7 +26955,7 @@ async function acquireLock(command = "unknown") {
           const info2 = JSON.parse(content);
           holder = `PID ${info2.pid} (${info2.command})`;
         } catch {}
-        throw new Error(`Another synctax process is running (${holder}). Wait for it to finish or delete ~/.synctax/sync.lock`);
+        throw new Error(`Another synctax process is running (${holder}). Wait for it to finish or delete ${lockPath}`);
       }
     } else {
       throw err;
@@ -29203,7 +29204,7 @@ async function addCommand(domain2, name, options) {
       prompt: options.prompt || "",
       model: options.model,
       tools: options.tools ? options.tools.split(",") : undefined,
-      scope: options.global ? "global" : "local"
+      scope: options.global ? "global" : options.local ? "local" : "global"
     };
   } else if (domain2 === "skill") {
     config2.resources.skills[name] = {
@@ -29211,7 +29212,7 @@ async function addCommand(domain2, name, options) {
       description: options.description,
       trigger: options.trigger,
       content: options.content || "",
-      scope: options.global ? "global" : "local"
+      scope: options.global ? "global" : options.local ? "local" : "global"
     };
   } else {
     error48(`Unsupported domain for add: ${domain2}`);
@@ -61530,9 +61531,9 @@ async function runInkTui(options) {
       exitOnCtrlC: false,
       patchConsole: false
     });
-    process.env.NODE_ENV = prevEnv;
     await instance.waitUntilExit();
   } finally {
+    process.env.NODE_ENV = prevEnv;
     process.stdout.write("\x1B[?25h");
     process.stdout.write("\x1B[?1049l");
   }
@@ -61563,6 +61564,7 @@ async function loadTuiFrameData() {
   let source = normalizedSource || fallbackSource;
   if (normalizedSource && !Object.hasOwn(adapters, normalizedSource)) {
     warnings.push(`Configured source '${normalizedSource}' is not a valid adapter.`);
+    source = fallbackSource;
   }
   const enabledClients = Object.entries(config2.clients).filter(([id, client]) => Object.hasOwn(adapters, id) && client?.enabled).length;
   if (enabledClients === 0) {
@@ -61572,7 +61574,7 @@ async function loadTuiFrameData() {
     version: getVersion(),
     profile: config2.activeProfile || "default",
     source,
-    theme: config2.theme || "synctax",
+    theme: config2.theme ?? "rebel",
     health: warnings.length > 0 ? "WARN" : "OK",
     enabledClients,
     totalClients: adapterIds.length,
@@ -61648,7 +61650,7 @@ init_commands();
 
 // src/version.ts
 function getVersion2() {
-  return "2.0.0";
+  return "2.0.1";
 }
 
 // bin/synctax.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "synctax",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "description": "Universal config sync for the agentic developer stack — sync MCP servers, agents, skills, and permissions across 9 AI clients from a single source of truth.",
   "type": "module",
   "license": "MIT",