meridian-dev 1.1.0

package/bin/meridian.js

@@ -0,0 +1,100 @@
+#!/usr/bin/env node
+
+const { execSync, spawnSync } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+const ROOT = path.join(__dirname, '..');
+const COMMANDS = {
+  init: {
+    desc: 'Install Meridian for your AI tool (Claude Code, Cursor, or generic)',
+    run: (args) => {
+      const hasToolFlag = args.some((a) => a === '--tool' || a.startsWith('--tool='));
+      const toolArgs = hasToolFlag ? args : ['--tool', 'claude-code', ...args];
+      spawn('bash', [path.join(ROOT, 'setup.sh'), ...toolArgs]);
+    },
+  },
+  'init-cursor': {
+    desc: 'Install Meridian for Cursor',
+    run: (args) => {
+      spawn('bash', [path.join(ROOT, 'setup.sh'), '--tool', 'cursor', ...args]);
+    },
+  },
+  update: {
+    desc: 'Update Meridian to latest version (re-runs setup in update mode)',
+    run: (args) => {
+      const tool = args.includes('--tool') ? args : ['--tool', 'claude-code', ...args];
+      spawn('bash', [path.join(ROOT, 'setup.sh'), '--update', ...tool]);
+    },
+  },
+  digest: {
+    desc: 'Generate a journal digest (weekly summary of AI sessions)',
+    run: (args) => {
+      spawn('bash', [path.join(ROOT, 'journal-summary.sh'), ...args]);
+    },
+  },
+  doctor: {
+    desc: 'Check your Meridian installation for issues',
+    run: (args) => {
+      spawn('bash', [path.join(ROOT, 'doctor.sh'), ...args]);
+    },
+  },
+  help: {
+    desc: 'Show this help message',
+    run: () => showHelp(),
+  },
+};
+
+function showHelp() {
+  console.log('');
+  console.log('Meridian — Team decision trail for AI-assisted development');
+  console.log('');
+  console.log('Usage: meridian <command> [options]');
+  console.log('');
+  console.log('Commands:');
+  for (const [name, cmd] of Object.entries(COMMANDS)) {
+    console.log(`  ${name.padEnd(16)} ${cmd.desc}`);
+  }
+  console.log('');
+  console.log('Getting started:');
+  console.log('  npx meridian-dev init          Install for Claude Code');
+  console.log('  npx meridian-dev init-cursor   Install for Cursor');
+  console.log('');
+  console.log('In a Claude Code session:');
+  console.log('  /init-memory                   Set up memory for current repo');
+  console.log('  /init-team                     Set up team context (journals, digests, Notion)');
+  console.log('  /journal                       View your session journal digest');
+  console.log('  /doctor                        Check installation health');
+  console.log('');
+  console.log('Ongoing:');
+  console.log('  npx meridian-dev digest                This week\'s digest');
+  console.log('  npx meridian-dev digest --last-week    Last week\'s digest');
+  console.log('  npx meridian-dev digest --team <path>  Team digest from shared journals');
+  console.log('');
+}
+
+function spawn(cmd, args) {
+  const result = spawnSync(cmd, args, {
+    stdio: 'inherit',
+    env: { ...process.env },
+  });
+  if (result.error) {
+    console.error(`Error: ${result.error.message}`);
+    process.exit(1);
+  }
+  process.exit(result.status || 0);
+}
+
+// --- Main ---
+
+const args = process.argv.slice(2);
+const command = args[0] || 'help';
+const commandArgs = args.slice(1);
+
+if (COMMANDS[command]) {
+  COMMANDS[command].run(commandArgs);
+} else {
+  console.error(`Unknown command: ${command}`);
+  console.error('Run "meridian help" for available commands.');
+  process.exit(1);
+}

package/doctor.sh

@@ -0,0 +1,173 @@
+#!/usr/bin/env bash
+# Skip Tissue — Doctor
+# Validates that the memory system is correctly installed and functioning.
+# Usage: bash doctor.sh [--verbose]
+
+set -euo pipefail
+
+VERBOSE=false
+[[ "${1:-}" == "--verbose" ]] && VERBOSE=true
+
+GREEN='\033[0;32m'; YELLOW='\033[1;33m'; RED='\033[0;31m'; RESET='\033[0m'
+
+ok()   { echo -e "${GREEN}✓${RESET} $1"; }
+warn() { echo -e "${YELLOW}⚠${RESET}  $1"; }
+err()  { echo -e "${RED}✗${RESET} $1"; }
+info() { echo "  $1"; }
+
+ISSUES=0
+
+check_hook_registered() {
+    echo ""
+    echo "Hook registration"
+    local SETTINGS="$HOME/.claude/settings.json"
+    if [ ! -f "$SETTINGS" ]; then
+        err "settings.json not found — hook is not registered"
+        info "Run: bash setup.sh --tool claude-code"
+        ISSUES=$((ISSUES + 1))
+        return
+    fi
+    if grep -q "check-global-state" "$SETTINGS" 2>/dev/null; then
+        ok "SessionStart hook registered in settings.json"
+    else
+        err "Hook not registered in settings.json"
+        info "Re-run setup.sh to merge the hook"
+        ISSUES=$((ISSUES + 1))
+    fi
+
+    if [ -f "$HOME/.claude/hooks/check-global-state.sh" ]; then
+        ok "check-global-state.sh exists"
+    else
+        err "check-global-state.sh not found at ~/.claude/hooks/"
+        ISSUES=$((ISSUES + 1))
+    fi
+}
+
+check_global_state() {
+    echo ""
+    echo "Global state file"
+    local GLOBAL="$HOME/.claude/global-state.md"
+    if [ ! -f "$GLOBAL" ]; then
+        err "global-state.md not found at $GLOBAL"
+        info "Run: bash setup.sh --tool claude-code"
+        ISSUES=$((ISSUES + 1))
+        return
+    fi
+    ok "global-state.md exists"
+
+    # Check if it was updated recently
+    local LAST_UPDATED
+    LAST_UPDATED=$(grep -m1 '^Last updated:' "$GLOBAL" 2>/dev/null | sed 's/^Last updated: *//' || echo "")
+    if [ -n "$LAST_UPDATED" ]; then
+        if [[ "$LAST_UPDATED" < "$(date -d '7 days ago' +%Y-%m-%d 2>/dev/null || date -v-7d +%Y-%m-%d 2>/dev/null || echo '0000-00-00')" ]]; then
+            warn "global-state.md last updated $LAST_UPDATED (>7 days ago)"
+        else
+            ok "global-state.md updated $LAST_UPDATED"
+        fi
+    else
+        warn "global-state.md has no 'Last updated:' line"
+    fi
+}
+
+check_backup() {
+    echo ""
+    echo "Backup status"
+    local LAST_PUSH="$HOME/.claude/.backup-last-push"
+    local LAST_ERROR="$HOME/.claude/.backup-last-error"
+
+    if [ ! -f "$HOME/.claude-backup/.git/config" ] 2>/dev/null && [ ! -f "$LAST_PUSH" ]; then
+        info "Backup not configured (optional — run backup/setup.sh <repo-url> to enable)"
+        return
+    fi
+
+    if [ -f "$LAST_ERROR" ]; then
+        warn "Backup: last push FAILED"
+        info "$(cat "$LAST_ERROR")"
+        ISSUES=$((ISSUES + 1))
+    elif [ -f "$LAST_PUSH" ]; then
+        local PUSH_TIME
+        PUSH_TIME=$(cat "$LAST_PUSH")
+        ok "Backup: last push $PUSH_TIME"
+    else
+        warn "Backup configured but no push record found"
+    fi
+}
+
+scan_repos() {
+    echo ""
+    echo "Repo state files"
+    local SCAN_ROOTS="${AI_MEMORY_SCAN_ROOTS:-$HOME/repos $HOME/code $HOME/dev $HOME/projects}"
+    local FOUND=0
+
+    for root in $SCAN_ROOTS; do
+        [ -d "$root" ] || continue
+        while IFS= read -r state_file; do
+            FOUND=$((FOUND + 1))
+            local rel="${state_file#$HOME/}"
+            local repo_name="${rel%/.claude/team-state.md}"
+            repo_name="${repo_name%/.claude/state.md}"
+            local LAST_UPDATED
+            LAST_UPDATED=$(grep -m1 '^Last updated:' "$state_file" 2>/dev/null | sed 's/^Last updated: *//' || echo "unknown")
+            ok "$repo_name (updated $LAST_UPDATED)"
+        done < <(find "$root" \( -path '*/.claude/state.md' -o -path '*/.claude/team-state.md' \) 2>/dev/null | sort)
+    done
+
+    if [ "$FOUND" -eq 0 ]; then
+        info "No repos with state.md found in: $SCAN_ROOTS"
+        info "Run /init-memory in a repo to initialize it"
+    fi
+}
+
+check_memory_files() {
+    echo ""
+    echo "Memory files"
+    local MEMORY_DIR="$HOME/.claude/memory"
+    if [ ! -d "$MEMORY_DIR" ]; then
+        warn "Memory directory not found: $MEMORY_DIR"
+        return
+    fi
+
+    local COUNT=0
+    while IFS= read -r f; do
+        COUNT=$((COUNT + 1))
+        local SIZE
+        SIZE=$(wc -c < "$f" 2>/dev/null || echo 0)
+        local SIZE_KB=$((SIZE / 1024))
+        local FNAME
+        FNAME=$(basename "$f")
+        if [ "$SIZE" -gt 8192 ]; then
+            warn "$FNAME (${SIZE_KB}KB) — exceeds recommended 8KB; consider summarizing"
+        else
+            [ "$VERBOSE" = true ] && ok "$FNAME (${SIZE_KB}KB)"
+        fi
+    done < <(find "$MEMORY_DIR" -name '*.md' -not -path '*/journal/*' 2>/dev/null | sort)
+
+    local JOURNAL_DIR="$MEMORY_DIR/journal"
+    if [ -d "$JOURNAL_DIR" ]; then
+        local JOURNAL_COUNT
+        JOURNAL_COUNT=$(find "$JOURNAL_DIR" -name '*.md' 2>/dev/null | wc -l)
+        ok "Journal: $JOURNAL_COUNT entries"
+    fi
+
+    [ "$COUNT" -gt 0 ] && ok "$COUNT memory file(s) found" || info "No memory files yet"
+}
+
+# Run checks
+echo ""
+echo "Skip Tissue — Doctor"
+echo "══════════════════════"
+
+check_hook_registered
+check_global_state
+check_backup
+check_memory_files
+scan_repos
+
+echo ""
+echo "══════════════════════"
+if [ "$ISSUES" -eq 0 ]; then
+    echo -e "${GREEN}All checks passed${RESET}"
+else
+    echo -e "${YELLOW}$ISSUES issue(s) found${RESET}"
+    exit 1
+fi

package/install.sh

@@ -0,0 +1,62 @@
+#!/usr/bin/env bash
+# Skip Tissue — Installer
+# Usage:
+#   curl -fsSL https://raw.githubusercontent.com/leizerowicz/skip-tissue/main/install.sh | bash
+#   ST_VERSION=v1.0.0 bash install.sh   # Install specific version
+
+set -euo pipefail
+
+REPO="leizerowicz/skip-tissue"
+VERSION="${ST_VERSION:-main}"
+TMP_DIR="$(mktemp -d)"
+
+cleanup() { rm -rf "$TMP_DIR"; }
+trap cleanup EXIT
+
+echo ""
+echo "Skip Tissue — Installing${VERSION:+ (${VERSION})}..."
+echo ""
+
+# Download
+if [ "$VERSION" = "main" ]; then
+    DOWNLOAD_URL="https://github.com/$REPO/archive/refs/heads/main.tar.gz"
+    ARCHIVE_NAME="skip-tissue-main"
+else
+    DOWNLOAD_URL="https://github.com/$REPO/archive/refs/tags/${VERSION}.tar.gz"
+    ARCHIVE_NAME="skip-tissue-${VERSION#v}"
+fi
+
+ARCHIVE="$TMP_DIR/kit.tar.gz"
+if ! curl -fsSL "$DOWNLOAD_URL" -o "$ARCHIVE"; then
+    echo ""
+    echo "Error: download failed."
+    if [ "$VERSION" != "main" ]; then
+        echo "Check that version '$VERSION' exists: https://github.com/$REPO/releases"
+    fi
+    exit 1
+fi
+tar -xz -C "$TMP_DIR" -f "$ARCHIVE"
+KIT_DIR="$TMP_DIR/$ARCHIVE_NAME"
+
+# Verify the kit downloaded correctly
+if [ ! -f "$KIT_DIR/setup.sh" ]; then
+    echo "Error: download failed or unexpected archive structure"
+    exit 1
+fi
+
+# Run setup
+bash "$KIT_DIR/setup.sh" --tool claude-code
+
+# Keep the kit locally so doctor.sh and future updates are available
+KIT_DEST="$HOME/.claude/skip-tissue"
+rm -rf "$KIT_DEST"
+cp -r "$KIT_DIR" "$KIT_DEST"
+
+echo ""
+echo "Installation complete."
+[ "$VERSION" != "main" ] && echo "Version: $VERSION"
+echo "Kit installed to: $KIT_DEST"
+echo ""
+echo "Next: run /init-memory in any Claude Code session to initialize a repo."
+echo "To set up backup: tell Claude 'Set up backup using <your-private-repo-url>'"
+echo ""