gitwrit 0.1.0

package/src/expansions.js

@@ -0,0 +1,18 @@
+import { readFile } from 'fs/promises';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+
+const WORDS_FILE = join(dirname(fileURLToPath(import.meta.url)), 'words.json');
+
+// picks one random entry from each of adjectives, nouns, verbs
+// and joins them with hyphens.
+// e.g. "crimson-walrus-stumbling"
+export async function generateBranchName() {
+  const raw = await readFile(WORDS_FILE, 'utf8');
+  const { adjectives, nouns, verbs } = JSON.parse(raw);
+  return [pick(adjectives), pick(nouns), pick(verbs)].join('-');
+}
+
+function pick(arr) {
+  return arr[Math.floor(Math.random() * arr.length)];
+}

package/src/git.js

@@ -0,0 +1,77 @@
+import simpleGit from 'simple-git';
+
+export async function isGitRepo(dir) {
+  try {
+    const git = simpleGit(dir);
+    await git.revparse(['--git-dir']);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+export async function hasRemote(dir) {
+  const git = simpleGit(dir);
+  const remotes = await git.getRemotes();
+  return remotes.length > 0;
+}
+
+export async function getCurrentBranch(dir) {
+  const git = simpleGit(dir);
+  const name = await git.revparse(['--abbrev-ref', 'HEAD']);
+  return name.trim();
+}
+
+export async function branchExists(dir, name) {
+  const git = simpleGit(dir);
+  const branches = await git.branchLocal();
+  return branches.all.includes(name);
+}
+
+export async function createAndCheckoutBranch(dir, name) {
+  const git = simpleGit(dir);
+  await git.checkoutLocalBranch(name);
+}
+
+export async function commitFile(dir, filepath, message) {
+  const git = simpleGit(dir);
+  await git.add(filepath);
+  const status = await git.status();
+  if (status.staged.length === 0) return false;
+  await git.commit(message);
+  return true;
+}
+
+export async function commitAll(dir, message) {
+  const git = simpleGit(dir);
+  await git.add('.');
+  const status = await git.status();
+  if (status.staged.length === 0) return 0;
+  await git.commit(message);
+  return status.staged.length;
+}
+
+export async function push(dir) {
+  const git = simpleGit(dir);
+  const branch = await getCurrentBranch(dir);
+  await git.push('origin', branch, ['--set-upstream']);
+}
+
+export async function getUnpushedCount(dir) {
+  try {
+    const git = simpleGit(dir);
+    const result = await git.log(['@{u}..HEAD']);
+    return result.total;
+  } catch {
+    return 1;
+  }
+}
+
+export async function getRepoSummary(dir) {
+  const git = simpleGit(dir);
+  const branch = await getCurrentBranch(dir);
+  const unpushed = await getUnpushedCount(dir);
+  const log = await git.log(['-1']);
+  const lastCommit = log.latest;
+  return { branch, unpushed, lastCommit };
+}

package/src/logger.js

@@ -0,0 +1,53 @@
+import { appendFile, mkdir, readFile } from 'fs/promises';
+import { GITWRIT_DIR, LOG_FILE } from './paths.js';
+
+// ─── setup ────────────────────────────────────────────────────────────────────
+
+async function ensureLogDir() {
+  await mkdir(GITWRIT_DIR, { recursive: true });
+}
+
+// ─── format ───────────────────────────────────────────────────────────────────
+
+function timestamp() {
+  return new Date().toLocaleTimeString('en-US', {
+    hour: '2-digit',
+    minute: '2-digit',
+    second: '2-digit',
+    hour12: false,
+  });
+}
+
+// ─── write ────────────────────────────────────────────────────────────────────
+
+async function write(level, message) {
+  await ensureLogDir();
+  const line = `${timestamp()}  ${level.padEnd(8)}  ${message}\n`;
+  await appendFile(LOG_FILE, line, 'utf8');
+}
+
+// ─── public api ───────────────────────────────────────────────────────────────
+
+export const logger = {
+  info:   (msg) => write('info',   msg),
+  warn:   (msg) => write('warn',   msg),
+  error:  (msg) => write('error',  msg),
+  commit: (msg) => write('commit', msg),
+  push:   (msg) => write('push',   msg),
+  pause:  (msg) => write('pause',  msg),
+  resume: (msg) => write('resume', msg),
+};
+
+// ─── tail ─────────────────────────────────────────────────────────────────────
+
+// returns the last `n` lines of the log file as an array.
+// used by `gitwrit logs`.
+export async function tailLog(n = 20) {
+  try {
+    const raw = await readFile(LOG_FILE, 'utf8');
+    const lines = raw.split('\n').filter(Boolean);
+    return lines.slice(-n);
+  } catch {
+    return []; // log doesn't exist yet
+  }
+}

package/src/paths.js

@@ -0,0 +1,27 @@
+import { homedir } from 'os';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+
+// project root (for bundled assets like expansions.txt)
+export const PROJECT_ROOT = join(dirname(fileURLToPath(import.meta.url)), '..');
+
+// user's home directory
+export const HOME_DIR = homedir();
+
+// ~/.gitwrit/ — runtime files only (pid, log, state)
+export const GITWRIT_DIR = join(HOME_DIR, '.gitwrit');
+
+// daemon PID — used by start/stop/status to track the process
+export const PID_FILE = join(GITWRIT_DIR, 'gitwrit.pid');
+
+// append-only activity log — used by `gitwrit logs`
+export const LOG_FILE = join(GITWRIT_DIR, 'gitwrit.log');
+
+// daemon state — persists paused/stopped across sessions
+export const STATE_FILE = join(GITWRIT_DIR, 'gitwrit.state');
+
+// global user config — lives at ~/.gitwritrc.json
+export const GLOBAL_CONFIG_FILE = join(HOME_DIR, '.gitwritrc.json');
+
+// local directory config — lives at <watched-dir>/.gitwrit.json
+export const LOCAL_CONFIG_FILENAME = '.gitwrit.json';

package/src/scheduler.js

@@ -0,0 +1,46 @@
+import { push, getUnpushedCount } from './git.js';
+import { logger } from './logger.js';
+import { writeState, readState } from './state.js';
+
+// ─── scheduler ────────────────────────────────────────────────────────────────
+
+// maintains a set of repos that have unpushed commits and pushes them
+// on a fixed interval. safe to call multiple times — push is idempotent.
+export function createScheduler({ interval, onPushComplete }) {
+  const pendingRepos = new Set();
+
+  async function flush() {
+    for (const dir of [...pendingRepos]) {
+      try {
+        const unpushed = await getUnpushedCount(dir);
+        if (unpushed === 0) {
+          pendingRepos.delete(dir);
+          continue;
+        }
+
+        await push(dir);
+        pendingRepos.delete(dir);
+        await logger.push(`${dir}`);
+
+        const state = await readState();
+        await writeState({ lastPushedAt: new Date().toISOString() });
+
+        if (onPushComplete) onPushComplete(dir);
+      } catch (err) {
+        await logger.error(`push failed for ${dir}: ${err.message}`);
+      }
+    }
+  }
+
+  const timer = setInterval(flush, interval);
+
+  return {
+    // call this after every successful local commit
+    queue: (dir) => pendingRepos.add(dir),
+
+    // flush immediately (e.g. on wake from sleep)
+    flushNow: () => flush(),
+
+    stop: () => clearInterval(timer),
+  };
+}

package/src/settings.js

@@ -0,0 +1,115 @@
+import { readFile, writeFile, access } from 'fs/promises';
+import { join } from 'path';
+import { GLOBAL_CONFIG_FILE, LOCAL_CONFIG_FILENAME } from './paths.js';
+
+// ─── defaults ────────────────────────────────────────────────────────────────
+
+export const DEFAULTS = {
+  fileTypes: ['.md', '.mdx'],
+  debounce: 3000,        // ms — wait after last save before committing
+  pushInterval: 300000,  // ms — time between remote pushes (5 min)
+  branchMode: 'current', // 'current' | 'autogenerated'
+  watch: [],             // array of { type: 'directory'|'repo', path: string }
+};
+
+// ─── existence checks ─────────────────────────────────────────────────────────
+
+export async function globalConfigExists() {
+  try {
+    await access(GLOBAL_CONFIG_FILE);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+export async function localConfigExists(dir) {
+  try {
+    await access(join(dir, LOCAL_CONFIG_FILENAME));
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+// ─── loaders ─────────────────────────────────────────────────────────────────
+
+export async function loadGlobalConfig() {
+  const raw = await readFile(GLOBAL_CONFIG_FILE, 'utf8');
+  return JSON.parse(raw);
+}
+
+export async function loadLocalConfig(dir) {
+  try {
+    const raw = await readFile(join(dir, LOCAL_CONFIG_FILENAME), 'utf8');
+    return JSON.parse(raw);
+  } catch {
+    return null; // null = no local overrides, follow global
+  }
+}
+
+// ─── writers ──────────────────────────────────────────────────────────────────
+
+export async function saveGlobalConfig(config) {
+  await writeFile(GLOBAL_CONFIG_FILE, JSON.stringify(config, null, 2), 'utf8');
+}
+
+export async function saveLocalConfig(dir, overrides) {
+  const localPath = join(dir, LOCAL_CONFIG_FILENAME);
+  await writeFile(localPath, JSON.stringify(overrides, null, 2), 'utf8');
+}
+
+// ─── resolver ─────────────────────────────────────────────────────────────────
+
+// merges global config with any local overrides for a given directory.
+// local keys win — unset local keys fall through to global.
+export async function resolveConfig(dir) {
+  const global = await loadGlobalConfig();
+  const local = await loadLocalConfig(dir);
+  if (!local) return { ...global, _source: 'global' };
+  return { ...global, ...local, _source: 'local' };
+}
+
+// ─── validation ───────────────────────────────────────────────────────────────
+
+export function validateConfig(config) {
+  const errors = [];
+
+  if (!Array.isArray(config.fileTypes) || config.fileTypes.length === 0) {
+    errors.push('fileTypes must be a non-empty array (e.g. [".md", ".mdx"])');
+  }
+
+  if (typeof config.debounce !== 'number' || config.debounce < 500) {
+    errors.push('debounce must be a number >= 500ms');
+  }
+
+  if (typeof config.pushInterval !== 'number' || config.pushInterval < 60000) {
+    errors.push('pushInterval must be a number >= 60000ms (1 minute)');
+  }
+
+  if (!['current', 'autogenerated'].includes(config.branchMode)) {
+    errors.push('branchMode must be "current" or "autogenerated"');
+  }
+
+  return errors;
+}
+
+// ─── watch list helpers ───────────────────────────────────────────────────────
+
+export async function addWatchPath(entry) {
+  const config = await loadGlobalConfig();
+  const already = config.watch.some(w => w.path === entry.path);
+  if (already) return false;
+  config.watch.push(entry);
+  await saveGlobalConfig(config);
+  return true;
+}
+
+export async function removeWatchPath(dirPath) {
+  const config = await loadGlobalConfig();
+  const before = config.watch.length;
+  config.watch = config.watch.filter(w => w.path !== dirPath);
+  if (config.watch.length === before) return false;
+  await saveGlobalConfig(config);
+  return true;
+}

package/src/state.js

@@ -0,0 +1,46 @@
+import { readFile, writeFile, mkdir } from 'fs/promises';
+import { GITWRIT_DIR, STATE_FILE } from './paths.js';
+
+// ─── state values ─────────────────────────────────────────────────────────────
+
+export const STATE = {
+  RUNNING: 'running',
+  PAUSED:  'paused',
+  STOPPED: 'stopped',
+};
+
+// ─── helpers ──────────────────────────────────────────────────────────────────
+
+async function ensureDir() {
+  await mkdir(GITWRIT_DIR, { recursive: true });
+}
+
+export async function readState() {
+  try {
+    const raw = await readFile(STATE_FILE, 'utf8');
+    return JSON.parse(raw);
+  } catch {
+    return { status: STATE.STOPPED };
+  }
+}
+
+export async function writeState(patch) {
+  await ensureDir();
+  const current = await readState();
+  const next = { ...current, ...patch, updatedAt: new Date().toISOString() };
+  await writeFile(STATE_FILE, JSON.stringify(next, null, 2), 'utf8');
+}
+
+// ─── convenience writers ──────────────────────────────────────────────────────
+
+export async function markRunning(sessionData = {}) {
+  await writeState({ status: STATE.RUNNING, ...sessionData });
+}
+
+export async function markPaused() {
+  await writeState({ status: STATE.PAUSED, pausedAt: new Date().toISOString() });
+}
+
+export async function markStopped() {
+  await writeState({ status: STATE.STOPPED, pausedAt: null });
+}

package/src/ui.js

@@ -0,0 +1,63 @@
+import chalk from 'chalk';
+
+// ─── sigil + brand ────────────────────────────────────────────────────────────
+
+export const SIGIL = '✦';
+
+export const brand  = (msg) => chalk.white(`\n  ${SIGIL} ${msg}`);
+export const info   = (msg) => chalk.white(`    ${msg}`);
+export const good   = (msg) => chalk.green(`  ✔  ${msg}`);
+export const bad    = (msg) => chalk.red(`  ✗  ${msg}`);
+export const warn   = (msg) => chalk.yellow(`  ⚠  ${msg}`);
+export const hint   = (msg) => chalk.dim(`    ${msg}`);
+export const divider = (label) =>
+  chalk.dim(`\n  ${'─'.repeat(41)}\n  ${label}\n  ${'─'.repeat(41)}`);
+
+// ─── key/value rows ───────────────────────────────────────────────────────────
+
+// prints a two-column row like:
+//   watching    ~/notes
+export function row(key, value, tag) {
+  const k = chalk.dim(key.padEnd(14));
+  const v = chalk.white(value);
+  const t = tag ? chalk.dim(` (${tag})`) : '';
+  return `    ${k}${v}${t}`;
+}
+
+// ─── spacing ──────────────────────────────────────────────────────────────────
+
+export const gap = () => console.log();
+
+// ─── printers ─────────────────────────────────────────────────────────────────
+
+export const print = {
+  brand:   (msg) => console.log(brand(msg)),
+  info:    (msg) => console.log(info(msg)),
+  good:    (msg) => console.log(good(msg)),
+  bad:     (msg) => console.log(bad(msg)),
+  warn:    (msg) => console.log(warn(msg)),
+  hint:    (msg) => console.log(hint(msg)),
+  divider: (label) => console.log(divider(label)),
+  row:     (key, value, tag) => console.log(row(key, value, tag)),
+  gap,
+};
+
+// ─── time formatting ──────────────────────────────────────────────────────────
+
+export function timeAgo(date) {
+  if (!date) return 'never';
+  const seconds = Math.floor((Date.now() - new Date(date)) / 1000);
+  if (seconds < 10)  return 'just now';
+  if (seconds < 60)  return `${seconds}s ago`;
+  if (seconds < 3600) return `${Math.floor(seconds / 60)}m ago`;
+  if (seconds < 86400) return `${Math.floor(seconds / 3600)}h ago`;
+  return `${Math.floor(seconds / 86400)}d ago`;
+}
+
+// ─── ms formatting ────────────────────────────────────────────────────────────
+
+export function formatMs(ms) {
+  if (ms < 1000) return `${ms}ms`;
+  if (ms < 60000) return `${ms / 1000}s`;
+  return `${ms / 60000} min`;
+}

package/src/watcher.js

@@ -0,0 +1,59 @@
+import chokidar from 'chokidar';
+
+// ─── watcher factory ──────────────────────────────────────────────────────────
+
+// starts a chokidar watcher on the given paths, filtered to fileTypes.
+// calls onSave(filepath, dir) after the per-file debounce window.
+export function createWatcher({ paths, fileTypes, debounce, onSave }) {
+  // build a glob pattern for each watched path
+  const globs = paths.map(p => `${p}/**/*`);
+
+  const watcher = chokidar.watch(globs, {
+    ignored: [
+      /(^|[/\\])\../,   // dotfiles
+      /node_modules/,
+      /\.git/,
+    ],
+    persistent:          true,
+    ignoreInitial:       true,
+    awaitWriteFinish: {
+      stabilityThreshold: 200,  // wait 200ms for the write to fully flush
+      pollInterval:       100,
+    },
+  });
+
+  // per-file debounce timers — each file gets its own timer
+  const timers = new Map();
+
+  function handleChange(filepath) {
+    // only act on files matching the configured types
+    const matches = fileTypes.some(ext => filepath.endsWith(ext));
+    if (!matches) return;
+
+    // find which watched directory this file belongs to
+    const dir = paths.find(p => filepath.startsWith(p));
+    if (!dir) return;
+
+    // reset the timer for this specific file
+    if (timers.has(filepath)) clearTimeout(timers.get(filepath));
+
+    const timer = setTimeout(() => {
+      timers.delete(filepath);
+      onSave(filepath, dir);
+    }, debounce);
+
+    timers.set(filepath, timer);
+  }
+
+  watcher.on('add',    handleChange);
+  watcher.on('change', handleChange);
+
+  return {
+    close: () => watcher.close(),
+    // re-attach watchers after sleep — called on SIGCONT
+    restart: () => {
+      watcher.close();
+      return createWatcher({ paths, fileTypes, debounce, onSave });
+    },
+  };
+}

package/src/words.json

@@ -0,0 +1,128 @@
+{
+  "adjectives": [
+    "amber",
+    "angry",
+    "blue",
+    "breezy",
+    "calm",
+    "coral",
+    "crimson",
+    "dizzy",
+    "drowsy",
+    "fancy",
+    "fuzzy",
+    "gentle",
+    "gloomy",
+    "golden",
+    "grumpy",
+    "happy",
+    "hungry",
+    "indigo",
+    "itchy",
+    "ivory",
+    "jade",
+    "jolly",
+    "lavender",
+    "little",
+    "lonely",
+    "loud",
+    "nervous",
+    "olive",
+    "polite",
+    "rusty",
+    "scarlet",
+    "shaggy",
+    "silent",
+    "silver",
+    "sleepy",
+    "teal",
+    "tiny",
+    "violet",
+    "wobbly",
+    "yellow"
+  ],
+  "nouns": [
+    "acorn",
+    "anvil",
+    "badger",
+    "biscuit",
+    "blanket",
+    "broom",
+    "bucket",
+    "cactus",
+    "candle",
+    "cloud",
+    "coyote",
+    "door",
+    "ferret",
+    "flamingo",
+    "fox",
+    "gerbil",
+    "hammer",
+    "hedgehog",
+    "kettle",
+    "lantern",
+    "lemur",
+    "lizard",
+    "marble",
+    "narwhal",
+    "noodle",
+    "otter",
+    "pebble",
+    "penguin",
+    "pillow",
+    "panther",
+    "raccoon",
+    "radish",
+    "spatula",
+    "sponge",
+    "teapot",
+    "tree",
+    "trumpet",
+    "walrus",
+    "wombat",
+    "zebra"
+  ],
+  "verbs": [
+    "balancing",
+    "blinking",
+    "bouncing",
+    "brooding",
+    "clapping",
+    "climbing",
+    "clattering",
+    "dreaming",
+    "drifting",
+    "fidgeting",
+    "floating",
+    "galloping",
+    "giggling",
+    "grumbling",
+    "hovering",
+    "humming",
+    "juggling",
+    "jumping",
+    "leaping",
+    "marching",
+    "mumbling",
+    "napping",
+    "nodding",
+    "pondering",
+    "rambling",
+    "running",
+    "rustling",
+    "shuffling",
+    "sighing",
+    "skipping",
+    "sleeping",
+    "slouching",
+    "spinning",
+    "sprinting",
+    "squinting",
+    "stumbling",
+    "swaying",
+    "waddling",
+    "yawning",
+    "yodeling"
+  ]
+}