@madkid/relay-ctx 0.1.0

package/dist/commands/checkpoint.d.ts

@@ -0,0 +1,18 @@
+/**
+ * relay checkpoint <message> — Save a named snapshot of current context.
+ *
+ * Options:
+ * --list    List all saved checkpoints
+ * --silent  Suppress all output (used by git hooks)
+ *
+ * Flow:
+ * 1. Read current PROJECT.md
+ * 2. Create snapshot file in projects/{name}/snapshots/
+ * 3. Append checkpoint entry to PROJECT.md under "## Checkpoints"
+ * 4. Success message (unless --silent)
+ */
+export declare function checkpointCommand(message?: string, options?: {
+    list?: boolean;
+    silent?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=checkpoint.d.ts.map

package/dist/commands/checkpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint.d.ts","sourceRoot":"","sources":["../../src/commands/checkpoint.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;GAYG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAC7C,OAAO,CAAC,IAAI,CAAC,CAsHf"}

package/dist/commands/checkpoint.js

@@ -0,0 +1,130 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkpointCommand = checkpointCommand;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const storage_1 = require("../core/storage");
+/**
+ * relay checkpoint <message> — Save a named snapshot of current context.
+ *
+ * Options:
+ * --list    List all saved checkpoints
+ * --silent  Suppress all output (used by git hooks)
+ *
+ * Flow:
+ * 1. Read current PROJECT.md
+ * 2. Create snapshot file in projects/{name}/snapshots/
+ * 3. Append checkpoint entry to PROJECT.md under "## Checkpoints"
+ * 4. Success message (unless --silent)
+ */
+async function checkpointCommand(message, options) {
+    const projectName = (0, storage_1.getProjectName)();
+    const projectPath = (0, storage_1.getProjectPath)();
+    const silent = options?.silent ?? false;
+    if (!fs_1.default.existsSync(projectPath)) {
+        if (silent)
+            return;
+        console.log('❌ Relay not initialized for this project. Run `relay init` first.');
+        process.exit(1);
+    }
+    const snapshotsDir = path_1.default.join(projectPath, 'snapshots');
+    if (options?.list) {
+        if (!fs_1.default.existsSync(snapshotsDir)) {
+            if (!silent)
+                console.log('No checkpoints found.');
+            return;
+        }
+        const files = fs_1.default.readdirSync(snapshotsDir);
+        const mdFiles = files.filter((f) => f.endsWith('.md')).sort();
+        if (mdFiles.length === 0) {
+            if (!silent)
+                console.log('No checkpoints found.');
+            return;
+        }
+        if (silent)
+            return;
+        console.log(`\n💾 Saved checkpoints for "${projectName}":\n`);
+        mdFiles.forEach((file) => {
+            const datetimePart = file.slice(0, 19); // 2026-06-16T05-30-22
+            const dateStr = datetimePart.split('T')[0];
+            const timeStr = datetimePart.split('T')[1]?.replace(/-/g, ':') || '';
+            const msgStr = file.slice(20, -3).replace(/-/g, ' ');
+            console.log(`  [${dateStr} ${timeStr}] "${msgStr}"`);
+        });
+        console.log('');
+        return;
+    }
+    if (!message) {
+        if (silent)
+            return;
+        console.log('❌ Error: Checkpoint message is required.');
+        process.exit(1);
+    }
+    const projectMd = (0, storage_1.readProjectMd)();
+    if (!projectMd) {
+        if (silent)
+            return;
+        console.log('❌ PROJECT.md is empty. Run `relay sync` first.');
+        process.exit(1);
+    }
+    // 1. Build timestamp
+    const now = new Date();
+    const dateStr = now.toISOString().split('T')[0]; // 2024-01-15
+    const timeStr = now.toTimeString().slice(0, 5); // 14:32
+    const fileTimestamp = now.toISOString().replace(/[:.]/g, '-').slice(0, 19); // 2024-01-15T14-32-00
+    // 2. Create snapshot file
+    fs_1.default.mkdirSync(snapshotsDir, { recursive: true });
+    const sanitizedMessage = message
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/(^-|-$)/g, '');
+    const snapshotFilename = `${fileTimestamp}-${sanitizedMessage}.md`;
+    const snapshotPath = path_1.default.join(snapshotsDir, snapshotFilename);
+    const snapshotContent = `# Checkpoint: ${message}\n\n` +
+        `> Saved: ${dateStr} ${timeStr}\n` +
+        `> Project: ${projectName}\n\n` +
+        `---\n\n` +
+        projectMd;
+    fs_1.default.writeFileSync(snapshotPath, snapshotContent, 'utf-8');
+    // 3. Append checkpoint to PROJECT.md
+    const checkpointEntry = `- [${dateStr} ${timeStr}] "${message}"`;
+    let updatedMd;
+    if (projectMd.includes('## Checkpoints')) {
+        // Append to existing checkpoints section
+        updatedMd = projectMd.replace(/(## Checkpoints\n)([\s\S]*?)(\n##|\n---|\s*$)/, (match, heading, existing, after) => {
+            return `${heading}${existing.trimEnd()}\n${checkpointEntry}\n${after}`;
+        });
+        // If the regex didn't match (e.g. checkpoints is the last section), try simpler append
+        if (updatedMd === projectMd) {
+            updatedMd = projectMd.trimEnd() + `\n${checkpointEntry}\n`;
+        }
+    }
+    else {
+        // Add new checkpoints section
+        updatedMd = projectMd.trimEnd() + `\n\n## Checkpoints\n\n${checkpointEntry}\n`;
+    }
+    (0, storage_1.writeProjectMd)(updatedMd);
+    // Update meta.json
+    const metaPath = path_1.default.join(projectPath, 'meta.json');
+    let meta = {};
+    if (fs_1.default.existsSync(metaPath)) {
+        try {
+            meta = JSON.parse(fs_1.default.readFileSync(metaPath, 'utf-8'));
+        }
+        catch {
+            // ignore
+        }
+    }
+    meta.name = projectName;
+    meta.lastCheckpoint = new Date().toISOString();
+    fs_1.default.writeFileSync(metaPath, JSON.stringify(meta, null, 2), 'utf-8');
+    // 4. Success
+    if (!silent) {
+        console.log(`\n✅ Checkpoint saved: "${message}"`);
+        console.log(`   📄 ${snapshotPath}\n`);
+    }
+}
+//# sourceMappingURL=checkpoint.js.map

package/dist/commands/checkpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint.js","sourceRoot":"","sources":["../../src/commands/checkpoint.ts"],"names":[],"mappings":"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"}

package/dist/commands/hooks.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Install all 3 git hooks for Relay.
+ * Returns the list of installed hook names and any skipped hooks.
+ */
+export declare function installHooks(): {
+    installed: string[];
+    skipped: string[];
+};
+/**
+ * Remove all relay-managed git hooks.
+ * Returns the list of removed hook names.
+ */
+export declare function uninstallHooks(): string[];
+/**
+ * Check the installation status of all 3 git hooks.
+ */
+export declare function getHooksStatus(): Array<{
+    name: string;
+    exists: boolean;
+    relayManaged: boolean;
+    path: string;
+}>;
+/**
+ * relay hooks — Manage git hooks for automatic context tracking.
+ *
+ * Options:
+ * --install    Install git hooks into this project
+ * --uninstall  Remove git hooks from this project
+ * --status     Show current hook installation status
+ */
+export declare function hooksCommand(options: {
+    install?: boolean;
+    uninstall?: boolean;
+    status?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/commands/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/commands/hooks.ts"],"names":[],"mappings":"AAkEA;;;GAGG;AACH,wBAAgB,YAAY,IAAI;IAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAmCzE;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,MAAM,EAAE,CAgBzC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,KAAK,CAAC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,EAAE,OAAO,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC,CAcD;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE;IAC1C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,GAAG,OAAO,CAAC,IAAI,CAAC,CA0FhB"}

package/dist/commands/hooks.js

@@ -0,0 +1,226 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.installHooks = installHooks;
+exports.uninstallHooks = uninstallHooks;
+exports.getHooksStatus = getHooksStatus;
+exports.hooksCommand = hooksCommand;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const storage_1 = require("../core/storage");
+const RELAY_MANAGED_MARKER = '# relay-managed';
+const HOOKS = [
+    {
+        name: 'post-commit',
+        content: `#!/bin/sh
+${RELAY_MANAGED_MARKER}
+COMMIT_MSG=$(git log -1 --pretty=%B | head -1)
+relay checkpoint "$COMMIT_MSG" --silent 2>/dev/null || true
+`,
+        description: 'auto-checkpoint with your commit message',
+    },
+    {
+        name: 'post-checkout',
+        content: `#!/bin/sh
+${RELAY_MANAGED_MARKER}
+PREV_HEAD=$1
+NEW_HEAD=$2
+BRANCH_SWITCH=$3
+
+if [ "$BRANCH_SWITCH" = "1" ]; then
+  BRANCH=$(git rev-parse --abbrev-ref HEAD)
+  relay sync --silent 2>/dev/null || true
+  echo "⚡ Relay: synced context for branch '$BRANCH'"
+fi
+`,
+        description: 'auto-sync when you switch branches',
+    },
+    {
+        name: 'post-merge',
+        content: `#!/bin/sh
+${RELAY_MANAGED_MARKER}
+relay sync --silent 2>/dev/null || true
+relay checkpoint "post-merge sync" --silent 2>/dev/null || true
+echo "⚡ Relay: context updated after merge"
+`,
+        description: 'auto-sync + checkpoint after merges',
+    },
+];
+/**
+ * Get the .git/hooks directory for the current project.
+ */
+function getGitHooksDir() {
+    return path_1.default.join(process.cwd(), '.git', 'hooks');
+}
+/**
+ * Check if a hook file is relay-managed.
+ */
+function isRelayManaged(hookPath) {
+    if (!fs_1.default.existsSync(hookPath))
+        return false;
+    const content = fs_1.default.readFileSync(hookPath, 'utf-8');
+    return content.includes(RELAY_MANAGED_MARKER);
+}
+/**
+ * Install all 3 git hooks for Relay.
+ * Returns the list of installed hook names and any skipped hooks.
+ */
+function installHooks() {
+    const hookNames = HOOKS.map((h) => h.name);
+    const installed = [];
+    const skipped = [];
+    const hooksDir = getGitHooksDir();
+    // Ensure hooks directory exists
+    fs_1.default.mkdirSync(hooksDir, { recursive: true });
+    for (const hook of HOOKS) {
+        const hookPath = path_1.default.join(hooksDir, hook.name);
+        if (fs_1.default.existsSync(hookPath)) {
+            if (isRelayManaged(hookPath)) {
+                // Overwrite existing relay-managed hook with latest content
+                fs_1.default.writeFileSync(hookPath, hook.content, 'utf-8');
+                if (process.platform !== 'win32') {
+                    fs_1.default.chmodSync(hookPath, 0o755);
+                }
+                installed.push(hook.name);
+            }
+            else {
+                // Skip — hook exists but isn't relay-managed
+                skipped.push(hook.name);
+            }
+        }
+        else {
+            fs_1.default.writeFileSync(hookPath, hook.content, 'utf-8');
+            if (process.platform !== 'win32') {
+                fs_1.default.chmodSync(hookPath, 0o755);
+            }
+            installed.push(hook.name);
+        }
+    }
+    return { installed, skipped };
+}
+/**
+ * Remove all relay-managed git hooks.
+ * Returns the list of removed hook names.
+ */
+function uninstallHooks() {
+    const removed = [];
+    const hooksDir = getGitHooksDir();
+    if (!fs_1.default.existsSync(hooksDir))
+        return removed;
+    for (const hook of HOOKS) {
+        const hookPath = path_1.default.join(hooksDir, hook.name);
+        if (fs_1.default.existsSync(hookPath) && isRelayManaged(hookPath)) {
+            fs_1.default.unlinkSync(hookPath);
+            removed.push(hook.name);
+        }
+    }
+    return removed;
+}
+/**
+ * Check the installation status of all 3 git hooks.
+ */
+function getHooksStatus() {
+    const hooksDir = getGitHooksDir();
+    return HOOKS.map((hook) => {
+        const hookPath = path_1.default.join(hooksDir, hook.name);
+        const exists = fs_1.default.existsSync(hookPath);
+        return {
+            name: hook.name,
+            exists,
+            relayManaged: isRelayManaged(hookPath),
+            path: hookPath,
+            description: hook.description,
+        };
+    });
+}
+/**
+ * relay hooks — Manage git hooks for automatic context tracking.
+ *
+ * Options:
+ * --install    Install git hooks into this project
+ * --uninstall  Remove git hooks from this project
+ * --status     Show current hook installation status
+ */
+async function hooksCommand(options) {
+    const projectName = (0, storage_1.getProjectName)();
+    // Default to --status if no option given
+    if (!options.install && !options.uninstall && !options.status) {
+        options.status = true;
+    }
+    if (options.status) {
+        const statusList = getHooksStatus();
+        console.log(`\n🔌 Relay hooks status for "${projectName}":\n`);
+        for (const s of statusList) {
+            let state;
+            if (!s.exists) {
+                state = '❌ Not installed';
+            }
+            else if (s.relayManaged) {
+                state = '✅ Installed (relay-managed)';
+            }
+            else {
+                state = '⚠️  Exists (not relay-managed)';
+            }
+            const hookDef = HOOKS.find((h) => h.name === s.name);
+            const desc = hookDef ? hookDef.description : '';
+            console.log(`  ${s.name.padEnd(15)} ${state}`);
+            console.log(`  ${''.padEnd(15)} → ${desc}`);
+            console.log(`  ${''.padEnd(15)} Path: ${s.path}`);
+            console.log('');
+        }
+        return;
+    }
+    if (options.install) {
+        // Validate: must be a git repo
+        const gitDir = path_1.default.join(process.cwd(), '.git');
+        if (!fs_1.default.existsSync(gitDir)) {
+            console.log('❌ Error: Current directory is not a git repository.');
+            console.log('   Run `git init` first, then `relay hooks --install`.\n');
+            return;
+        }
+        // Validate: relay must be initialized
+        const projectPath = (0, storage_1.getProjectPath)();
+        if (!fs_1.default.existsSync(projectPath)) {
+            console.log('❌ Error: Relay is not initialized for this project.');
+            console.log('   Run `relay init` first.\n');
+            return;
+        }
+        const { installed, skipped } = installHooks();
+        if (installed.length > 0) {
+            console.log(`\n⚡ Relay hooks installed for "${projectName}"\n`);
+            for (const name of installed) {
+                const hookDef = HOOKS.find((h) => h.name === name);
+                const desc = hookDef ? hookDef.description : '';
+                console.log(`  ${name.padEnd(15)} → ${desc}`);
+            }
+            console.log('\nEvery git commit now saves a Relay checkpoint automatically.');
+            console.log('After 30 commits you\'ll have a complete decision trail.');
+            console.log('\nTo remove: relay hooks --uninstall\n');
+        }
+        if (skipped.length > 0) {
+            for (const name of skipped) {
+                console.log(`⚠️  Skipped ${name}: hook already exists (not relay-managed).`);
+                console.log('   Add relay checkpoint manually.');
+            }
+            console.log('');
+        }
+        return;
+    }
+    if (options.uninstall) {
+        const removed = uninstallHooks();
+        if (removed.length > 0) {
+            console.log(`\n🔌 Relay hooks removed for "${projectName}":\n`);
+            for (const name of removed) {
+                console.log(`  ✅ ${name} — removed`);
+            }
+            console.log('\nGit hooks are no longer active. Re-install with: relay hooks --install\n');
+        }
+        else {
+            console.log('\nNo relay-managed hooks found to remove.\n');
+        }
+        return;
+    }
+}
+//# sourceMappingURL=hooks.js.map

package/dist/commands/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/commands/hooks.ts"],"names":[],"mappings":"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"}

package/dist/commands/init.d.ts

@@ -0,0 +1,14 @@
+/**
+ * relay init — Initialize Relay for the current project.
+ *
+ * Flow:
+ * 1. Ensure relay root directory exists
+ * 2. Detect project name
+ * 3. Check for existing project, prompt for re-init
+ * 4. Interactive setup prompts
+ * 5. Check/prompt for Anthropic API key
+ * 6. Write initial PROJECT.md
+ * 7. Ask about installing git hooks
+ */
+export declare function initCommand(): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AA+DA;;;;;;;;;;;GAWG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAoJjD"}