gitdone-agent 0.1.2 → 0.1.3

package/index.js

@@ -3,10 +3,31 @@
 // Usage: bun index.js --key=gdo_xxx --name=my-repo --path=/path/to/repo [--install]
 
 import { execSync, spawn } from 'node:child_process'
-import { existsSync, writeFileSync, unlinkSync } from 'node:fs'
+import { existsSync, writeFileSync, unlinkSync, mkdirSync, copyFileSync, appendFileSync } from 'node:fs'
 import { resolve, join } from 'node:path'
 import { homedir } from 'node:os'
 
+// ─── Stable agent dir + logging ────────────────────────────────────────────────
+// Everything persistent lives here: a stable copy of the agent script (so
+// autostart never points at a purged npx temp dir) and a per-repo log file
+// (so failures are visible even when the agent runs in a hidden window).
+
+const AGENT_DIR = join(homedir(), '.gitdone-agent')
+
+function ensureAgentDir() {
+  if (!existsSync(AGENT_DIR)) mkdirSync(AGENT_DIR, { recursive: true })
+}
+
+let LOG_PATH = null
+
+function log(msg) {
+  const line = `[${new Date().toISOString()}] ${msg}`
+  console.log(line)
+  if (LOG_PATH) {
+    try { appendFileSync(LOG_PATH, line + '\n') } catch { /* best-effort */ }
+  }
+}
+
 // ─── Arg parsing ─────────────────────────────────────────────────────────────
 
 function parseArgs() {
@@ -27,17 +48,18 @@ function parseArgs() {
   const url = (args.url ?? 'https://gitdone.eu').replace(/\/$/, '')
   const install = 'install' in args
   const uninstall = 'uninstall' in args
+  const doctor = 'doctor' in args
 
-  if (!key && !uninstall) {
+  if (!key && !uninstall && !doctor) {
     console.error('Error: --key is required (e.g. --key=gdo_xxx)')
     process.exit(1)
   }
-  if (!existsSync(repoPath) && !uninstall) {
+  if (!existsSync(repoPath) && !uninstall && !doctor) {
     console.error(`Error: path does not exist: ${repoPath}`)
     process.exit(1)
   }
 
-  return { key, path: repoPath, name, projectId, interval, url, install, uninstall }
+  return { key, path: repoPath, name, projectId, interval, url, install, uninstall, doctor }
 }
 
 // ─── Windows auto-start ───────────────────────────────────────────────────────
@@ -53,8 +75,19 @@ function getNodePath() {
 }
 
 function installStartup({ name, key, path: repoPath, url, interval, projectId }) {
+  ensureAgentDir()
   const nodePath = getNodePath()
-  const agentPath = resolve(process.argv[1])
+
+  // Copy this script to a stable location. process.argv[1] may point inside an
+  // npx cache dir that gets purged later — referencing it from autostart would
+  // silently break on the next login. A stable copy survives.
+  const stableAgent = join(AGENT_DIR, 'agent.mjs')
+  try {
+    copyFileSync(resolve(process.argv[1]), stableAgent)
+  } catch (err) {
+    console.error(`Warning: could not copy agent to ${stableAgent}: ${err.message}`)
+  }
+  const agentPath = existsSync(stableAgent) ? stableAgent : resolve(process.argv[1])
   const startupDir = getStartupDir()
 
   const argLine = [
@@ -76,9 +109,11 @@ function installStartup({ name, key, path: repoPath, url, interval, projectId })
   writeFileSync(vbsPath, vbs, 'utf8')
 
   console.log(`✓ Инсталиран! При следващото влизане в Windows агентът ще стартира автоматично.`)
-  console.log(`  Файл: ${vbsPath}`)
-  console.log(`  Repo : ${repoPath}`)
-  console.log(`  Name : ${name}`)
+  console.log(`  Файл  : ${vbsPath}`)
+  console.log(`  Агент : ${agentPath}`)
+  console.log(`  Repo  : ${repoPath}`)
+  console.log(`  Name  : ${name}`)
+  console.log(`  Лог   : ${join(AGENT_DIR, `${name}.log`)}`)
   console.log()
 }
 
@@ -92,6 +127,20 @@ function uninstallStartup(name) {
   }
 }
 
+// ─── Doctor: print where things are so "offline" is debuggable ─────────────────
+
+function runDoctor(name) {
+  const vbsPath = join(getStartupDir(), `gitdone-${name}.vbs`)
+  const stableAgent = join(AGENT_DIR, 'agent.mjs')
+  const logPath = join(AGENT_DIR, `${name}.log`)
+  console.log('gitdone-agent doctor')
+  console.log(`  node          : ${getNodePath()}`)
+  console.log(`  agent dir     : ${AGENT_DIR} ${existsSync(AGENT_DIR) ? '(ok)' : '(MISSING)'}`)
+  console.log(`  stable agent  : ${stableAgent} ${existsSync(stableAgent) ? '(ok)' : '(not installed)'}`)
+  console.log(`  autostart vbs : ${vbsPath} ${existsSync(vbsPath) ? '(ok)' : '(not installed)'}`)
+  console.log(`  log file      : ${logPath} ${existsSync(logPath) ? '(ok)' : '(none yet)'}`)
+}
+
 // ─── Git helpers ─────────────────────────────────────────────────────────────
 
 function git(cmd, cwd) {
@@ -174,11 +223,11 @@ async function executeCommand(cmd, repoPath, url, key) {
       const out = git('git pull', repoPath)
       result = out || 'pulled'
     }
-    console.log(`[${new Date().toLocaleTimeString()}] ✓ ${cmd.type}: ${result}`)
+    log(`✓ ${cmd.type}: ${result}`)
   } catch (err) {
     status = 'error'
     result = err.message
-    console.error(`[${new Date().toLocaleTimeString()}] ✗ ${cmd.type} failed: ${result}`)
+    log(`✗ ${cmd.type} failed: ${result}`)
   }
   await reportCommandResult(url, key, cmd.id, status, result)
 }
@@ -203,7 +252,19 @@ async function push({ url, key, name, projectId, repoPath, snapshot }) {
 
 async function main() {
   const config = parseArgs()
-  const { key, path: repoPath, name, projectId, interval, url, install, uninstall } = config
+  const { key, path: repoPath, name, projectId, interval, url, install, uninstall, doctor } = config
+
+  if (doctor) {
+    runDoctor(name)
+    process.exit(0)
+  }
+
+  // Route all runtime logs to a per-repo file too, so a silently-running
+  // (hidden-window) agent still leaves a trail to debug "why is it offline".
+  if (!uninstall) {
+    ensureAgentDir()
+    LOG_PATH = join(AGENT_DIR, `${name}.log`)
+  }
 
   if (uninstall) {
     uninstallStartup(name)
@@ -243,9 +304,9 @@ async function main() {
       const snapshot = getSnapshot(repoPath)
       await push({ url, key, name, projectId, repoPath, snapshot })
       const changed = snapshot.modified.length + snapshot.staged.length
-      console.log(`[${new Date().toLocaleTimeString()}] ✓ pushed — branch: ${snapshot.branch}, changes: ${changed}`)
+      log(`✓ pushed — branch: ${snapshot.branch}, changes: ${changed}`)
     } catch (err) {
-      console.error(`[${new Date().toLocaleTimeString()}] ✗ error: ${err.message}`)
+      log(`✗ error: ${err.message}`)
     }
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name":  "gitdone-agent",
-    "version":  "0.1.2",
+    "version":  "0.1.3",
     "description":  "Local git agent for gitdone — watches a local repo and sends snapshots to gitdone.eu",
     "type":  "module",
     "bin":  {