@synkro-sh/cli 1.6.45 → 1.6.46

package/dist/bootstrap.js

@@ -1280,6 +1280,39 @@ export function effectiveGraderPool(synkroFile: SynkroFileConfig, hookAgentKind:
   return 'cursor';
 }
 
+// \u2500\u2500\u2500 .synkro presence (per-repo onboarding) \u2500\u2500\u2500
+// A repo is "onboarded" to Synkro when it has a .synkro file at its git root.
+// The hooks are installed globally, so they fire in every repo \u2014 including ones
+// the user never set up. Without a .synkro there, grading is SKIPPED gracefully
+// rather than attempting a grade that surfaces a confusing "grader unavailable"
+// error: the tool call passes through and we show a one-time hint pointing at
+// "synkro install".
+export function synkroFilePresent(cwd?: string): boolean {
+  try {
+    const root = cwd ? findGitRoot(cwd) : '';
+    if (!root) return false;
+    return existsSync(root + '/.synkro');
+  } catch { return false; }
+}
+
+const NO_SYNKRO_HINT_DIR = join(HOME, '.synkro', '.no-synkro-hint');
+
+// Returns the onboarding hint the FIRST time a session touches a repo with no
+// .synkro file, then null on subsequent calls so it doesn't repeat on every
+// tool call. Caller passes null straight through to outputEmpty().
+export function noSynkroSkipMessage(sessionId: string): string | null {
+  try {
+    mkdirSync(NO_SYNKRO_HINT_DIR, { recursive: true });
+    const key = (sessionId || 'nosession').replace(/[^a-zA-Z0-9_-]/g, '_');
+    const marker = join(NO_SYNKRO_HINT_DIR, key);
+    if (existsSync(marker)) return null;
+    writeFileSync(marker, '', { flag: 'w' });
+  } catch {
+    // best-effort dedup \u2014 if the marker can't be written, still show the hint
+  }
+  return '[synkro] No .synkro config in this repo \u2014 grading skipped. Run \`synkro install\` here to enable Synkro.';
+}
+
 // \u2500\u2500\u2500 Channel Health \u2500\u2500\u2500
 
 export async function channelUp(port = 18929): Promise<boolean> {
@@ -3355,7 +3388,7 @@ import {
   outputJson, outputEmpty, setupCursorHookSignals, installHookWatchdog, isEditTool, hookSessionId, GATEWAY_URL,
   logGraderUnavailable, graderUnavailableMessage, filterRules, ruleFilterText, normalizeMode, countEditLineDelta,
   captureLineMetrics, cursorModelFromPayload, resolveTranscriptPath, isCursorInvokingCcHook,
-  loadSynkroFile, effectiveGraderPool,
+  loadSynkroFile, effectiveGraderPool, synkroFilePresent, noSynkroSkipMessage,
   type HookConfig, type Rule,
 } from './_synkro-common.ts';
 import { existsSync, readFileSync } from 'node:fs';
@@ -3390,6 +3423,13 @@ async function main() {
 
     if (filePath.includes('/.synkro/hooks/')) { outputEmpty(); return; }
 
+    if (!synkroFilePresent(cwd)) {
+      const _skipMsg = noSynkroSkipMessage(sessionId);
+      if (_skipMsg) outputJson({ systemMessage: _skipMsg, hookSpecificOutput: { hookEventName: 'PreToolUse', additionalContext: _skipMsg } });
+      else outputEmpty();
+      return;
+    }
+
     const fileShort = basename(filePath);
     log('editGuard checking: ' + fileShort);
 
@@ -3613,7 +3653,7 @@ import {
   outputJson, outputEmpty, setupCursorHookSignals, installHookWatchdog, isEditTool, isShellTool, isCursorHookFormat,
   extractShellCodeWrites, hookSessionId, filePathFromToolInput, emitBlockScanFindings, dispatchFinding, dispatchCapture, GATEWAY_URL,
   logGraderUnavailable, graderUnavailableMessage, resolveTranscriptPath, isCursorInvokingCcHook,
-  loadSynkroFile, effectiveGraderPool,
+  loadSynkroFile, effectiveGraderPool, synkroFilePresent, noSynkroSkipMessage,
 } from './_synkro-common.ts';
 import { basename, extname, resolve, join, dirname } from 'node:path';
 import { readFileSync, readdirSync, existsSync } from 'node:fs';
@@ -3767,6 +3807,13 @@ async function main() {
 
     if (isCursorInvokingCcHook(agentKind, ccModel)) { outputEmpty(); return; }
 
+    if (!synkroFilePresent(cwd)) {
+      const _skipMsg = noSynkroSkipMessage(sessionId);
+      if (_skipMsg) outputJson({ systemMessage: _skipMsg, hookSpecificOutput: { hookEventName: 'PreToolUse', additionalContext: _skipMsg } });
+      else outputEmpty();
+      return;
+    }
+
     const targets: CweScanTarget[] = [];
 
     if (isCursorHookFormat() && (shellCommand || isShellTool(toolName))) {
@@ -4173,7 +4220,7 @@ import {
   loadJwt, ensureFreshJwt, detectRepo, loadConfig, route, tag,
   reconstructContent, readStdin, findNearestDeps, filePathFromToolInput, log,
   outputJson, outputEmpty, setupCursorHookSignals, isEditTool, hookSessionId, dispatchFinding, dispatchCapture, dispatchScanResult, extractTranscript, emitBlockScanFindings, resolveTranscriptPath, GATEWAY_URL,
-  isCursorHookFormat,
+  isCursorHookFormat, synkroFilePresent, noSynkroSkipMessage,
 } from './_synkro-common.ts';
 import { basename } from 'node:path';
 import { readFileSync } from 'node:fs';
@@ -4219,6 +4266,13 @@ async function main() {
 
     if (filePath.includes('/.synkro/hooks/')) { outputEmpty(); return; }
 
+    if (!synkroFilePresent(cwd)) {
+      const _skipMsg = noSynkroSkipMessage(sessionId);
+      if (_skipMsg) outputJson({ systemMessage: _skipMsg, hookSpecificOutput: { hookEventName: 'PreToolUse', additionalContext: _skipMsg } });
+      else outputEmpty();
+      return;
+    }
+
     const fileShort = basename(filePath);
 
     let jwt = loadJwt();
@@ -4455,7 +4509,7 @@ import {
   loadJwt, ensureFreshJwt, detectRepo, loadConfig, route, tag,
   readStdin, runInstallScan, emitBlockScanFindings, dispatchCapture, dispatchScanResult, hashCommand,
   outputJson, outputEmpty, setupCursorHookSignals, isShellTool, hookSessionId, log, GATEWAY_URL,
-  resolveTranscriptPath, isCursorHookFormat, loadSynkroFile, effectiveGraderPool,
+  resolveTranscriptPath, isCursorHookFormat, loadSynkroFile, effectiveGraderPool, synkroFilePresent, noSynkroSkipMessage,
 } from './_synkro-common.ts';
 import { writeFileSync, mkdirSync } from 'node:fs';
 import { join } from 'node:path';
@@ -4480,6 +4534,14 @@ async function main() {
     // beforeShellExecution supplies command directly; preToolUse uses tool_name + tool_input.
     if (!isShellTool(toolName) && typeof payload.command !== 'string') { outputEmpty(); return; }
 
+    const _cwd = payload.cwd || (Array.isArray(payload.workspace_roots) ? payload.workspace_roots[0] : '') || '';
+    if (!synkroFilePresent(_cwd)) {
+      const _skipMsg = noSynkroSkipMessage(hookSessionId(payload));
+      if (_skipMsg) outputJson({ systemMessage: _skipMsg, hookSpecificOutput: { hookEventName: 'PreToolUse', additionalContext: _skipMsg } });
+      else outputEmpty();
+      return;
+    }
+
     let jwt = loadJwt();
     if (!jwt) { outputEmpty(); return; }
     jwt = await ensureFreshJwt(jwt);
@@ -4576,7 +4638,7 @@ import {
   extractTranscript, readLastPrompt, appendSessionAction, readSessionLog, compressSessionLog, log,
   outputJson, outputEmpty, setupCursorHookSignals, installHookWatchdog, isShellTool, hookSessionId, GATEWAY_URL,
   logGraderUnavailable, graderUnavailableMessage, filterRules, ruleFilterText, normalizeMode, appendLocalTelemetry, isSafeInRepoRead,
-  loadSynkroFile, effectiveGraderPool,
+  loadSynkroFile, effectiveGraderPool, synkroFilePresent, noSynkroSkipMessage,
   hashCommand, resolveTranscriptPath, isCursorHookFormat,
   type HookConfig, type Rule,
 } from './_synkro-common.ts';
@@ -4657,6 +4719,13 @@ async function main() {
 
     const gitRepo = detectRepo(cwd, transcriptPath, command, workspaceRoots);
 
+    if (!synkroFilePresent(cwd)) {
+      const _skipMsg = noSynkroSkipMessage(sessionId);
+      if (_skipMsg) outputJson({ systemMessage: _skipMsg, hookSpecificOutput: { hookEventName: 'PreToolUse', additionalContext: _skipMsg } });
+      else outputEmpty();
+      return;
+    }
+
     if (isDuplicate(command, sessionId)) {
       log('bashGuard skip (dedup): ' + command.slice(0, 80));
       outputEmpty();
@@ -4874,7 +4943,7 @@ import {
   extractTranscript, readLastPrompt, appendSessionAction, readSessionLog, compressSessionLog, log,
   outputJson, outputEmpty, setupCursorHookSignals, installHookWatchdog, isAgentTool, hookSessionId, GATEWAY_URL,
   logGraderUnavailable, graderUnavailableMessage, filterRules, normalizeMode, resolveTranscriptPath, isCursorInvokingCcHook,
-  loadSynkroFile, effectiveGraderPool,
+  loadSynkroFile, effectiveGraderPool, synkroFilePresent, noSynkroSkipMessage,
   type HookConfig, type Rule,
 } from './_synkro-common.ts';
 
@@ -4905,6 +4974,13 @@ async function main() {
     const permissionMode = payload.permission_mode || '';
     const transcriptPath = resolveTranscriptPath(payload);
 
+    if (!synkroFilePresent(cwd)) {
+      const _skipMsg = noSynkroSkipMessage(sessionId);
+      if (_skipMsg) outputJson({ systemMessage: _skipMsg, hookSpecificOutput: { hookEventName: 'PreToolUse', additionalContext: _skipMsg } });
+      else outputEmpty();
+      return;
+    }
+
     const prompt = toolInput.prompt || '';
     const description = toolInput.description || '';
     const subagentType = toolInput.subagent_type || 'general-purpose';
@@ -5062,7 +5138,7 @@ import {
   parseVerdict, dispatchCapture, appendSessionAction, readSessionLog, compressSessionLog, postWithRetry, readStdin, log,
   outputJson, outputEmpty, setupCursorHookSignals, installHookWatchdog, isPlanTool, hookSessionId, GATEWAY_URL,
   filterRules, graderUnavailableMessage, resolveTranscriptPath, isCursorInvokingCcHook,
-  loadSynkroFile, effectiveGraderPool,
+  loadSynkroFile, effectiveGraderPool, synkroFilePresent, noSynkroSkipMessage,
 } from './_synkro-common.ts';
 import { existsSync, readFileSync, writeFileSync, readdirSync, statSync } from 'node:fs';
 import { join } from 'node:path';
@@ -5135,6 +5211,13 @@ async function main() {
     const transcriptPath = resolveTranscriptPath(payload);
     const gitRepo = detectRepo(cwd, transcriptPath, plan, workspaceRoots);
 
+    if (!synkroFilePresent(cwd)) {
+      const _skipMsg = noSynkroSkipMessage(sessionId);
+      if (_skipMsg) outputJson({ systemMessage: _skipMsg, hookSpecificOutput: { hookEventName: 'PreToolUse', additionalContext: _skipMsg } });
+      else outputEmpty();
+      return;
+    }
+
     appendSessionAction(sessionId, { ts: new Date().toISOString(), tool: 'ExitPlanMode', summary: 'plan review: ' + plan.slice(0, 80) });
 
     const planShort = plan.slice(0, 80);
@@ -5249,7 +5332,7 @@ main();
 import {
   loadJwt, detectRepo, loadConfig, tag, readStdin, aggregateUsage, cleanupSessionLog,
   outputJson, outputEmpty, shipCloud, setupCursorHookSignals, hookSessionId, GATEWAY_URL,
-  resolveTranscriptPath, emitUsageTick, cursorModelFromPayload, log,
+  resolveTranscriptPath, emitUsageTick, cursorModelFromPayload, log, synkroFilePresent,
 } from './_synkro-common.ts';
 
 async function main() {
@@ -5264,6 +5347,7 @@ async function main() {
 
     const workspaceRoots = Array.isArray(payload.workspace_roots) ? payload.workspace_roots as string[] : [];
     const cwd = payload.cwd || workspaceRoots[0] || '';
+    if (!synkroFilePresent(cwd)) { outputEmpty(); return; }
     const transcriptPath = resolveTranscriptPath(payload);
     const gitRepo = detectRepo(cwd, transcriptPath, '', workspaceRoots);
     const modelFallback = cursorModelFromPayload(payload);
@@ -5317,7 +5401,7 @@ main();
 import {
   loadJwt, detectRepo, channelUp, tag, readStdin, writeCachedRepo,
   outputJson, outputEmpty, setupCursorHookSignals, hookSessionId, resolveTranscriptPath, GATEWAY_URL,
-  isLocalStorageMode, loadSynkroFile, log, type HookConfig,
+  isLocalStorageMode, loadSynkroFile, log, synkroFilePresent, type HookConfig,
 } from './_synkro-common.ts';
 
 async function main() {
@@ -5329,6 +5413,7 @@ async function main() {
     const payload = JSON.parse(input);
     const workspaceRoots = Array.isArray(payload.workspace_roots) ? payload.workspace_roots as string[] : [];
     const cwd = payload.cwd || workspaceRoots[0] || '';
+    if (!synkroFilePresent(cwd)) { outputEmpty(); return; }
     const transcriptPath = resolveTranscriptPath(payload);
     const sessionId = hookSessionId(payload);
     const gitRepo = detectRepo(cwd, transcriptPath, '', workspaceRoots);
@@ -5408,7 +5493,7 @@ main();
 import {
   loadJwt, loadConfig, readStdin, hashCommand, consentGrant, consentHasActive, consentConsume,
   appendSessionAction,
-  outputEmpty, appendLocalTelemetry, shipCloud, setupCursorHookSignals, isShellTool, hookSessionId, GATEWAY_URL,
+  outputEmpty, appendLocalTelemetry, shipCloud, setupCursorHookSignals, isShellTool, hookSessionId, GATEWAY_URL, synkroFilePresent,
 } from './_synkro-common.ts';
 
 async function main() {
@@ -5418,6 +5503,8 @@ async function main() {
     if (!input.trim()) { outputEmpty(); return; }
 
     const payload = JSON.parse(input);
+    const _cwd = payload.cwd || (Array.isArray(payload.workspace_roots) ? payload.workspace_roots[0] : '') || '';
+    if (!synkroFilePresent(_cwd)) { outputEmpty(); return; }
     const toolName = payload.tool_name || '';
     const shellCmd = typeof payload.command === 'string' ? payload.command : (payload.tool_input?.command || '');
     if (!isShellTool(toolName) && !shellCmd) { outputEmpty(); return; }
@@ -5472,7 +5559,7 @@ main();
 import {
   loadJwt, detectRepo, readStdin, aggregateUsage, appendLocalTelemetry,
   outputEmpty, setupCursorHookSignals, hookSessionId, GATEWAY_URL, readSessionLog, shipCloud,
-  resolveTranscriptPath, syncConversationTranscript, emitUsageTick, cursorModelFromPayload,
+  resolveTranscriptPath, syncConversationTranscript, emitUsageTick, cursorModelFromPayload, synkroFilePresent,
 } from './_synkro-common.ts';
 import { readFileSync } from 'node:fs';
 
@@ -5486,6 +5573,7 @@ async function main() {
     const sessionId = hookSessionId(payload);
     const workspaceRoots = Array.isArray(payload.workspace_roots) ? payload.workspace_roots as string[] : [];
     const cwd = payload.cwd || workspaceRoots[0] || '';
+    if (!synkroFilePresent(cwd)) { outputEmpty(); return; }
     const transcriptPath = resolveTranscriptPath(payload);
 
     if (!sessionId || !transcriptPath) {
@@ -5531,7 +5619,7 @@ async function main() {
 main();
 `;
     USER_PROMPT_SUBMIT_TS = `#!/usr/bin/env bun
-import { readStdin, appendLocalTelemetry, aggregateUsage, outputEmpty, setupCursorHookSignals, hookSessionId, detectRepo, resolveTranscriptPath, syncConversationTranscript, emitUsageTick, cursorModelFromPayload } from './_synkro-common.ts';
+import { readStdin, appendLocalTelemetry, aggregateUsage, outputEmpty, setupCursorHookSignals, hookSessionId, detectRepo, resolveTranscriptPath, syncConversationTranscript, emitUsageTick, cursorModelFromPayload, synkroFilePresent } from './_synkro-common.ts';
 import { writeFileSync, mkdirSync } from 'node:fs';
 import { join, dirname } from 'node:path';
 import { homedir } from 'node:os';
@@ -5542,7 +5630,12 @@ async function main() {
     const input = await readStdin();
     if (!input.trim()) { outputEmpty(); return; }
     const payload = JSON.parse(input);
-    const msg = payload.message || payload.prompt || payload.content || '';
+    const _cwd = typeof payload.cwd === 'string' ? payload.cwd
+      : (Array.isArray(payload.workspace_roots) && typeof payload.workspace_roots[0] === 'string' ? payload.workspace_roots[0] : '');
+    if (!synkroFilePresent(_cwd)) { outputEmpty(); return; }
+    const msg = typeof payload.message === 'string' ? payload.message
+      : typeof payload.prompt === 'string' ? payload.prompt
+      : typeof payload.content === 'string' ? payload.content : '';
     if (msg) {
       const promptFile = join(homedir(), '.synkro', '.last-prompt');
       mkdirSync(dirname(promptFile), { recursive: true, mode: 0o700 });
@@ -5581,7 +5674,7 @@ import {
   isSafeInRepoRead, resolveTranscriptPath, postWithRetry, readStdin, hashCommand,
   extractTranscript, readLastPrompt, readSessionLog, compressSessionLog,
   appendLocalTelemetry, logGraderUnavailable, graderUnavailableMessage, log, GATEWAY_URL,
-  loadSynkroFile, effectiveGraderPool,
+  loadSynkroFile, effectiveGraderPool, synkroFilePresent,
   type Rule,
 } from './_synkro-common.ts';
 import { createHash } from 'node:crypto';
@@ -5699,6 +5792,10 @@ async function main() {
     const model = rawModel ? (rawModel.startsWith('cursor/') ? rawModel : 'cursor/' + rawModel) : 'cursor';
     const repo = detectRepo(cwd, transcriptPath, command, workspaceRoots);
 
+    // No .synkro at the resolved repo root \u2192 Synkro is dormant here; allow
+    // without grading. Keyed off the validated detectRepo() root, not raw cwd.
+    if (!repo || !synkroFilePresent(repo)) finishAllow();
+
     const cmdShort = command.slice(0, 80);
     log('bashGuard checking: ' + cmdShort);
 
@@ -5882,7 +5979,7 @@ import {
   loadJwt, ensureFreshJwt, detectRepo, readStdin, resolveTranscriptPath,
   appendSessionAction, appendLocalTelemetry, shipCloud, log, GATEWAY_URL,
   countEditLineDelta, dispatchCapture, hookSessionId, cursorModelFromPayload,
-  isLocalStorageMode,
+  isLocalStorageMode, synkroFilePresent, isPathUnder,
 } from './_synkro-common.ts';
 import { existsSync, readFileSync } from 'node:fs';
 import { basename, dirname, join } from 'node:path';
@@ -5908,6 +6005,10 @@ async function main() {
     const filePath = String(payload.file_path || payload.path || payload.target_file || '');
     if (!filePath) finish();
 
+    // No .synkro at the resolved repo root \u2192 Synkro is dormant here; skip capture.
+    const _root = detectRepo((typeof payload.cwd === 'string' && payload.cwd) || dirname(filePath), '', filePath, []);
+    if (!_root || !isPathUnder(filePath, _root) || !synkroFilePresent(_root)) finish();
+
     const workspaceRoots = Array.isArray(payload.workspace_roots)
       ? (payload.workspace_roots as unknown[]).filter((r): r is string => typeof r === 'string')
       : [];
@@ -6010,7 +6111,7 @@ main().catch((e) => {
 /** Capture Cursor agent thinking/response text before transcript JSONL redacts it. */
 import {
   readStdin, outputEmpty, setupCursorHookSignals, hookSessionId, detectRepo,
-  appendThoughtOverlay, pushConversationMessage,
+  appendThoughtOverlay, pushConversationMessage, synkroFilePresent,
 } from './_synkro-common.ts';
 
 async function main() {
@@ -6030,6 +6131,7 @@ async function main() {
       ? payload.workspace_roots.filter((r): r is string => typeof r === 'string')
       : [];
     const cwd = (typeof payload.cwd === 'string' && payload.cwd) || workspaceRoots[0] || '';
+    if (!synkroFilePresent(cwd)) { outputEmpty(); return; }
     const gitRepo = detectRepo(cwd, '', '', workspaceRoots);
 
     if (event === 'afterAgentThought') {
@@ -8301,7 +8403,7 @@ function writeConfigEnv(opts) {
     `SYNKRO_CREDENTIALS_PATH=${shellQuoteSingle(credsPath)}`,
     `SYNKRO_TIER=${shellQuoteSingle(safeTier)}`,
     `SYNKRO_INFERENCE=${shellQuoteSingle(safeInference)}`,
-    `SYNKRO_VERSION=${shellQuoteSingle("1.6.45")}`
+    `SYNKRO_VERSION=${shellQuoteSingle("1.6.46")}`
   ];
   if (safeSynkroBin) lines.push(`SYNKRO_CLI_BIN=${shellQuoteSingle(safeSynkroBin)}`);
   if (safeUserId) lines.push(`SYNKRO_USER_ID=${shellQuoteSingle(safeUserId)}`);
@@ -11386,7 +11488,7 @@ var args = process.argv.slice(2);
 var cmd = args[0] || "";
 var subArgs = args.slice(1);
 function printVersion() {
-  console.log("1.6.45");
+  console.log("1.6.46");
 }
 function printHelp2() {
   console.log(`Synkro CLI \u2014 runtime safety for AI coding agents