File size: 4,271 Bytes
bf96836 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 | #!/usr/bin/env node
/**
* SessionStart Hook - Load previous context on new session
*
* Cross-platform (Windows, macOS, Linux)
*
* Runs when a new Claude session starts. Loads the most recent session
* summary into Claude's context via stdout, and reports available
* sessions and learned skills.
*/
const path = require('path');
const fs = require('fs');
const {
getSessionsDir,
getLearnedSkillsDir,
findFiles,
ensureDir,
readFile,
log,
output
} = require('../lib/utils');
const { getPackageManager, getSelectionPrompt } = require('../lib/package-manager');
const { listAliases } = require('../lib/session-aliases');
async function main() {
const sessionsDir = getSessionsDir();
const learnedDir = getLearnedSkillsDir();
// Ensure directories exist
ensureDir(sessionsDir);
ensureDir(learnedDir);
// Check for recent session files (last 7 days)
const recentSessions = findFiles(sessionsDir, '*-session.tmp', { maxAge: 7 });
if (recentSessions.length > 0) {
const latest = recentSessions[0];
log(`[SessionStart] Found ${recentSessions.length} recent session(s)`);
log(`[SessionStart] Latest: ${latest.path}`);
// Read and inject the latest session content into Claude's context
const content = readFile(latest.path);
if (content && !content.includes('[Session context goes here]')) {
// Only inject if the session has actual content (not the blank template)
output(`Previous session summary:\n${content}`);
}
}
// Check for learned skills
const learnedSkills = findFiles(learnedDir, '*.md');
if (learnedSkills.length > 0) {
log(`[SessionStart] ${learnedSkills.length} learned skill(s) available in ${learnedDir}`);
}
// Check for available session aliases
const aliases = listAliases({ limit: 5 });
if (aliases.length > 0) {
const aliasNames = aliases.map(a => a.name).join(', ');
log(`[SessionStart] ${aliases.length} session alias(es) available: ${aliasNames}`);
log(`[SessionStart] Use /sessions load <alias> to continue a previous session`);
}
// Load active ticket context if present
const activeTicketFile = path.join(process.cwd(), '.ai', 'tickets', 'active.md');
if (fs.existsSync(activeTicketFile)) {
const activeContent = readFile(activeTicketFile);
const ticketIdMatch = activeContent && activeContent.match(/^(GH-\d+|\d+)$/m);
if (ticketIdMatch) {
const rawId = ticketIdMatch[1];
const ticketId = rawId.startsWith('GH-') ? rawId : `GH-${rawId}`;
const contextFile = path.join(process.cwd(), '.ai', 'tickets', ticketId, 'context.md');
if (fs.existsSync(contextFile)) {
const contextContent = readFile(contextFile);
if (contextContent) {
output(`Active ticket context (${ticketId}):\n${contextContent}`);
log(`[SessionStart] Loaded ticket context: ${ticketId}`);
}
}
}
}
// BUILDING-SETUP.md reminder — fires until wizard runs and self-deletes the setup file
const buildingSetupPath = path.join(process.cwd(), 'BUILDING-SETUP.md');
const buildingMdPath = path.join(process.cwd(), 'BUILDING.md');
if (fs.existsSync(buildingSetupPath) && !fs.existsSync(buildingMdPath)) {
log('[SessionStart] BUILDING-SETUP.md found — build journal not yet initialized');
output(`IMPORTANT: This project has BUILDING-SETUP.md but no BUILDING.md yet.
The build journal has not been set up. Before starting any work, tell the user:
"I noticed BUILDING-SETUP.md is present but BUILDING.md hasn't been created yet. Would you like to set up your build journal now? Just say the word and I'll run through the setup — it takes 2-3 minutes and will self-update as you build."
Do not start any implementation work until you've offered this.`);
}
// Detect and report package manager
const pm = getPackageManager();
log(`[SessionStart] Package manager: ${pm.name} (${pm.source})`);
// If no explicit package manager config was found, show selection prompt
if (pm.source === 'default') {
log('[SessionStart] No package manager preference found.');
log(getSelectionPrompt());
}
process.exit(0);
}
main().catch(err => {
console.error('[SessionStart] Error:', err.message);
process.exit(0); // Don't block on errors
});
|