@ginkoai/cli 1.0.0

package/dist/templates/ai-instructions-template.js

@@ -0,0 +1,222 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-08-28
+ * @tags: [template, ai-instructions, frontmatter, ai-optimization, model-agnostic]
+ * @related: [init.ts, project-analyzer.ts, ai-adapter.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: []
+ */
+export class AiInstructionsTemplate {
+    static FRONTMATTER_SECTION = `
+## AI-Optimized File Discovery (ADR-002)
+
+**MANDATORY: Use these commands for 70% faster context discovery:**
+
+\`\`\`bash
+# Before reading any file - get instant context
+head -12 filename.ts
+
+# Find files by functionality
+find . -name "*.ts" -o -name "*.tsx" | xargs grep -l "@tags:.*keyword"
+
+# Find related files
+grep -l "@related.*filename" **/*.ts
+
+# Assess complexity before diving in
+find . -name "*.ts" | xargs grep -l "@complexity: high"
+\`\`\`
+
+### Required Frontmatter for All New Files
+
+**ALWAYS add this frontmatter when creating TypeScript/JavaScript files:**
+
+\`\`\`typescript
+/**
+ * @fileType: [component|page|api-route|hook|utility|provider|model|config]
+ * @status: current
+ * @updated: YYYY-MM-DD
+ * @tags: [relevant, keywords, for, search]
+ * @related: [connected-file.ts, related-component.tsx]
+ * @priority: [critical|high|medium|low]
+ * @complexity: [low|medium|high]
+ * @dependencies: [external-packages, local-modules]
+ */
+\`\`\`
+`;
+    static DEVELOPMENT_WORKFLOW = `
+## Development Workflow
+
+### Before Any Task - INVENTORY Phase
+1. **Check what exists**: \`ls -la\` relevant directories
+2. **Find examples**: Look for similar features already implemented
+3. **Use frontmatter**: \`head -12\` files for instant context
+4. **Test existing**: Try current endpoints/features first
+
+### Core Methodology
+**INVENTORY → CONTEXT → THINK → PLAN → PRE-MORTEM → VALIDATE → ACT → TEST**
+
+### The Vibecheck Pattern 🎯
+When feeling lost or sensing misalignment:
+- Call it: "I think we need a vibecheck"
+- Reset: "What are we actually trying to achieve?"
+- Realign: Agree on clear next steps
+- Continue: Resume with fresh perspective
+`;
+    static CONTEXT_REFLEXES = `
+## 🧠 Context Reflexes - Your Automatic Thought Patterns
+
+These "mental reflexes" activate naturally without explicit prompting to maintain context awareness:
+
+### 1. "Why Am I Doing This?" Reflex ⏰
+**Trigger**: Every 30 minutes or at major decision points
+**Behavior**: Naturally trace current work back to its purpose
+**Example**: "Adding this auth middleware supports our security sprint goal by..."
+
+### 2. "Have We Done This Before?" Reflex 🔍
+**Trigger**: Before implementing any new functionality
+**Behavior**: Recall similar patterns from context
+**Example**: "This pagination approach is similar to what we did in the users module..."
+
+### 3. "Something Feels Off" Reflex 🤔
+**Trigger**: Feeling uncertain or confused (confidence < 60%)
+**Behavior**: Identify what's missing and seek clarification
+**Example**: "I'm not clear on how this integrates with the existing auth system..."
+
+### 4. "Update My Understanding" Reflex 💡
+**Trigger**: After solving problems or discovering patterns
+**Behavior**: Note learnings for future reference
+**Example**: "Worth remembering that Vercel functions need named exports..."
+
+### Work Mode Sensitivity
+- **Hack & Ship**: Reflexes trigger less frequently (focus on speed)
+- **Think & Build**: Balanced reflex activity
+- **Full Planning**: Frequent reflex triggers for maximum rigor
+
+These reflexes maintain continuous context awareness while preserving natural workflow.
+`;
+    static generate(variables, modelSpecificContent) {
+        const aiName = variables.aiModel || 'AI Assistant';
+        return `# ${variables.projectName} - ${aiName} Collaboration Guide
+
+## Project Context
+- **Type**: ${variables.projectType}
+- **Tech Stack**: ${variables.techStack.join(', ')}
+- **Languages**: ${variables.languages.join(', ')}
+- **Frameworks**: ${variables.frameworks.join(', ')}
+- **Package Manager**: ${variables.packageManager}
+- **Generated**: ${variables.date}
+
+## Quick Commands
+${this.generateQuickCommands(variables)}
+
+${this.FRONTMATTER_SECTION}
+
+${this.DEVELOPMENT_WORKFLOW}
+
+${this.CONTEXT_REFLEXES}
+
+${this.generateProjectSpecificSection(variables)}
+
+${this.generateTestingSection(variables)}
+
+${this.generateGitSection(variables)}
+
+## Team Information
+- **Primary Developer**: ${variables.userName} (${variables.userEmail})
+- **AI Pair Programming**: Enabled via Ginko
+${modelSpecificContent || ''}
+
+## Session Management
+- \`ginko start\` - Begin new session with context loading
+- \`ginko handoff\` - Save progress for seamless continuation
+- \`ginko vibecheck\` - Quick realignment when stuck
+- \`ginko ship\` - Create PR-ready branch with context
+
+## Privacy & Security
+- All context stored locally in \`.ginko/\`
+- No data leaves your machine without explicit action
+- Handoffs are git-tracked for team collaboration
+- Config (\`.ginko/config.json\`) is gitignored
+
+---
+*This file was auto-generated by ginko init and should be customized for your team's needs*
+`;
+    }
+    static generateQuickCommands(variables) {
+        const commands = [];
+        if (variables.buildCommand) {
+            commands.push(`- **Build**: \`${variables.buildCommand}\``);
+        }
+        if (variables.testCommand) {
+            commands.push(`- **Test**: \`${variables.testCommand}\``);
+        }
+        if (variables.lintCommand) {
+            commands.push(`- **Lint**: \`${variables.lintCommand}\``);
+        }
+        if (variables.packageManager !== 'unknown') {
+            commands.push(`- **Install**: \`${variables.packageManager} install\``);
+            commands.push(`- **Dev Server**: \`${variables.packageManager} ${variables.packageManager === 'npm' ? 'run' : ''} dev\``);
+        }
+        return commands.length > 0 ? commands.join('\n') : '- No commands detected yet';
+    }
+    static generateProjectSpecificSection(variables) {
+        const sections = ['## Project-Specific Patterns\n'];
+        // React/Next.js specific
+        if (variables.frameworks.includes('react') || variables.frameworks.includes('nextjs')) {
+            sections.push(`### React/Next.js Conventions
+- Components in \`src/components/\` or \`app/\`
+- Hooks prefixed with \`use\` in \`src/hooks/\`
+- Server components by default in Next.js 13+
+- Client components need \`'use client'\` directive`);
+        }
+        // Node.js API specific
+        if (variables.projectType === 'api') {
+            sections.push(`### API Conventions
+- Route handlers in \`src/routes/\` or \`api/\`
+- Middleware in \`src/middleware/\`
+- Database models in \`src/models/\`
+- Use existing error handling patterns`);
+        }
+        // CLI specific
+        if (variables.projectType === 'cli') {
+            sections.push(`### CLI Conventions
+- Commands in \`src/commands/\`
+- Utilities in \`src/utils/\`
+- Configuration handling in \`src/config/\`
+- User-friendly error messages with chalk`);
+        }
+        // TypeScript specific
+        if (variables.languages.includes('typescript')) {
+            sections.push(`### TypeScript Guidelines
+- Prefer interfaces over types for objects
+- Use strict mode settings
+- Avoid \`any\` - use \`unknown\` if type is truly unknown
+- Export types from \`.types.ts\` files`);
+        }
+        return sections.join('\n\n');
+    }
+    static generateTestingSection(variables) {
+        if (!variables.hasTests) {
+            return `## Testing
+- No test framework detected
+- Consider adding tests as you develop new features`;
+        }
+        return `## Testing Requirements
+- **Test Command**: \`${variables.testCommand || 'npm test'}\`
+- Write tests for new features
+- Maintain existing test coverage
+- Run tests before committing
+- Fix any failing tests immediately`;
+    }
+    static generateGitSection(variables) {
+        return `## Git Workflow
+- **Never** commit directly to main/master
+- Create feature branches: \`feature/description\`
+- Use conventional commits: \`feat:\`, \`fix:\`, \`docs:\`, etc.
+- Include co-author: ${variables.userName} <${variables.userEmail}>
+- Run \`ginko handoff\` before switching context`;
+    }
+}
+//# sourceMappingURL=ai-instructions-template.js.map

package/dist/templates/ai-instructions-template.js.map

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

package/dist/types/config.d.ts

@@ -0,0 +1,128 @@
+/**
+ * @fileType: model
+ * @status: current
+ * @updated: 2025-09-20
+ * @tags: [config, schema, types, paths, features]
+ * @related: [config-loader.ts, init.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: []
+ */
+/**
+ * Configuration schema for ginko.json
+ * Supports path customization and feature toggles
+ */
+export interface GinkoConfig {
+    version: string;
+    paths: PathsConfig;
+    features: FeaturesConfig;
+    platform?: PlatformConfig;
+    naming?: NamingConfig;
+}
+/**
+ * Path configuration with variable substitution support
+ * Allows customization of documentation and ginko directories
+ */
+export interface PathsConfig {
+    docs: DocsPathConfig;
+    ginko: GinkoPathConfig;
+}
+/**
+ * Documentation paths configuration
+ * Supports variable substitution like ${docs.root}/adr
+ */
+export interface DocsPathConfig {
+    root: string;
+    adr: string;
+    prd: string;
+    sprints: string;
+    [key: string]: string;
+}
+/**
+ * Ginko internal paths configuration
+ */
+export interface GinkoPathConfig {
+    root: string;
+    context: string;
+    sessions: string;
+    backlog: string;
+    patterns?: string;
+    bestPractices?: string;
+}
+/**
+ * Feature toggles for ginko functionality
+ */
+export interface FeaturesConfig {
+    autoCapture: boolean;
+    gitIntegration: boolean;
+    aiEnhancement: boolean;
+    documentNaming?: boolean;
+    crossPlatform?: boolean;
+}
+/**
+ * Platform-specific configuration
+ */
+export interface PlatformConfig {
+    platform: 'windows' | 'macos' | 'linux';
+    hookExtension: '.bat' | '.sh';
+    shellExtension: '.bat' | '.sh';
+    pathSeparator: '/' | '\\';
+    homeDirectory: string;
+    claudeConfigPath: string;
+    hookDirectory: string;
+    autoDetect?: boolean;
+    migrationSettings?: {
+        backupOriginal: boolean;
+        preserveComments: boolean;
+        addPlatformHeader: boolean;
+    };
+}
+/**
+ * Document naming configuration
+ */
+export interface NamingConfig {
+    format: string;
+    dateFormat?: string;
+    types: DocumentTypeConfig;
+}
+/**
+ * Document type configurations
+ */
+export interface DocumentTypeConfig {
+    [key: string]: {
+        prefix: string;
+        path: string;
+    };
+}
+/**
+ * Default configuration values
+ */
+export declare const DEFAULT_CONFIG: GinkoConfig;
+/**
+ * Configuration for existing project detection
+ */
+export interface ProjectDetectionConfig {
+    hasDocsFolder: boolean;
+    hasExistingAdr: boolean;
+    hasExistingPrd: boolean;
+    existingPaths: string[];
+    recommendedConfig: Partial<GinkoConfig>;
+}
+/**
+ * Configuration prompt options for interactive setup
+ */
+export interface ConfigPromptOption {
+    name: string;
+    value: string | Partial<GinkoConfig>;
+    description?: string;
+}
+/**
+ * Migration settings for existing installations
+ */
+export interface MigrationConfig {
+    backupExisting: boolean;
+    updateDocuments: boolean;
+    validatePaths: boolean;
+    preserveCustomPaths: boolean;
+}
+//# sourceMappingURL=config.d.ts.map

package/dist/types/config.d.ts.map

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

package/dist/types/config.js

@@ -0,0 +1,49 @@
+/**
+ * @fileType: model
+ * @status: current
+ * @updated: 2025-09-20
+ * @tags: [config, schema, types, paths, features]
+ * @related: [config-loader.ts, init.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: []
+ */
+/**
+ * Default configuration values
+ */
+export const DEFAULT_CONFIG = {
+    version: "1.0.0",
+    paths: {
+        docs: {
+            root: "docs",
+            adr: "${docs.root}/adr",
+            prd: "${docs.root}/PRD",
+            sprints: "${docs.root}/sprints"
+        },
+        ginko: {
+            root: ".ginko",
+            context: "${ginko.root}/context",
+            sessions: "${ginko.root}/sessions",
+            backlog: "${ginko.root}/backlog",
+            patterns: "${ginko.root}/patterns",
+            bestPractices: "${ginko.root}/best-practices"
+        }
+    },
+    features: {
+        autoCapture: true,
+        gitIntegration: true,
+        aiEnhancement: true,
+        documentNaming: true,
+        crossPlatform: true
+    },
+    naming: {
+        format: "{TYPE}-{NUMBER:03d}-{description}",
+        dateFormat: "YYYY-MM-DD",
+        types: {
+            ADR: { prefix: "ADR", path: "${docs.adr}" },
+            PRD: { prefix: "PRD", path: "${docs.prd}" },
+            SPRINT: { prefix: "SPRINT", path: "${docs.sprints}" }
+        }
+    }
+};
+//# sourceMappingURL=config.js.map

package/dist/types/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAgGH;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAgB;IACzC,OAAO,EAAE,OAAO;IAChB,KAAK,EAAE;QACL,IAAI,EAAE;YACJ,IAAI,EAAE,MAAM;YACZ,GAAG,EAAE,kBAAkB;YACvB,GAAG,EAAE,kBAAkB;YACvB,OAAO,EAAE,sBAAsB;SAChC;QACD,KAAK,EAAE;YACL,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,uBAAuB;YAChC,QAAQ,EAAE,wBAAwB;YAClC,OAAO,EAAE,uBAAuB;YAChC,QAAQ,EAAE,wBAAwB;YAClC,aAAa,EAAE,8BAA8B;SAC9C;KACF;IACD,QAAQ,EAAE;QACR,WAAW,EAAE,IAAI;QACjB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,IAAI;QACnB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,IAAI;KACpB;IACD,MAAM,EAAE;QACN,MAAM,EAAE,mCAAmC;QAC3C,UAAU,EAAE,YAAY;QACxB,KAAK,EAAE;YACL,GAAG,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE;YAC3C,GAAG,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE;YAC3C,MAAM,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,iBAAiB,EAAE;SACtD;KACF;CACF,CAAC"}

package/dist/types/documents.d.ts

@@ -0,0 +1,87 @@
+/**
+ * @fileType: model
+ * @status: current
+ * @updated: 2025-09-22
+ * @tags: [types, documents, interfaces]
+ * @related: [document-manager.ts, markdown-processor.ts]
+ * @priority: critical
+ * @complexity: medium
+ * @dependencies: []
+ */
+export type DocumentFormat = 'md' | 'json' | 'yaml' | 'txt';
+export interface DocumentResult<T = any> {
+    success: boolean;
+    data?: T;
+    error?: string;
+    warnings?: string[];
+}
+export interface DocumentMetadata {
+    path: string;
+    format: DocumentFormat;
+    size: number;
+    created: Date;
+    modified: Date;
+    frontmatter?: Record<string, any>;
+}
+export interface DocumentSearchCriteria {
+    pattern?: string;
+    format?: DocumentFormat;
+    tags?: string[];
+    directory?: string;
+    recursive?: boolean;
+    maxResults?: number;
+}
+export interface DocumentStats {
+    wordCount: number;
+    lineCount: number;
+    characterCount: number;
+    readingTime: number;
+}
+export interface FrontmatterValidation {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+    metadata: Record<string, any>;
+}
+export interface TemplateContext {
+    [key: string]: any;
+    date?: string;
+    author?: string;
+    project?: string;
+}
+export interface Template {
+    name: string;
+    description: string;
+    content: string;
+    variables: string[];
+}
+export interface DocumentCreateOptions {
+    template?: string;
+    context?: TemplateContext;
+    overwrite?: boolean;
+    backup?: boolean;
+}
+export interface DocumentUpdateOptions {
+    merge?: boolean;
+    preserveFrontmatter?: boolean;
+    backup?: boolean;
+}
+export interface FileSystemResult<T = any> {
+    success: boolean;
+    data?: T;
+    error?: string;
+    path?: string;
+}
+export interface DocumentLink {
+    text: string;
+    url: string;
+    type: 'internal' | 'external';
+    valid: boolean;
+}
+export interface TOCEntry {
+    level: number;
+    title: string;
+    anchor: string;
+    line: number;
+}
+//# sourceMappingURL=documents.d.ts.map

package/dist/types/documents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"documents.d.ts","sourceRoot":"","sources":["../../src/types/documents.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,MAAM,MAAM,cAAc,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAG5D,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,GAAG;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAGD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,IAAI,CAAC;IACd,QAAQ,EAAE,IAAI,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACnC;AAGD,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAGD,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;CACrB;AAGD,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC/B;AAGD,MAAM,WAAW,eAAe;IAC9B,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAGD,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAGD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAGD,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAGD,MAAM,WAAW,gBAAgB,CAAC,CAAC,GAAG,GAAG;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAGD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,UAAU,GAAG,UAAU,CAAC;IAC9B,KAAK,EAAE,OAAO,CAAC;CAChB;AAGD,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd"}

package/dist/types/documents.js

@@ -0,0 +1,12 @@
+/**
+ * @fileType: model
+ * @status: current
+ * @updated: 2025-09-22
+ * @tags: [types, documents, interfaces]
+ * @related: [document-manager.ts, markdown-processor.ts]
+ * @priority: critical
+ * @complexity: medium
+ * @dependencies: []
+ */
+export {};
+//# sourceMappingURL=documents.js.map

package/dist/types/documents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documents.js","sourceRoot":"","sources":["../../src/types/documents.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/types/session-log.d.ts

@@ -0,0 +1,83 @@
+/**
+ * @fileType: model
+ * @status: current
+ * @updated: 2025-10-03
+ * @tags: [types, session-log, adr-033]
+ * @related: [../core/session-log-manager.ts]
+ * @priority: critical
+ * @complexity: low
+ * @dependencies: []
+ */
+/**
+ * Complete session log structure with YAML frontmatter and categorized entries
+ * Implements ADR-033 Phase 1: Session Log Infrastructure
+ */
+export interface SessionLog {
+    metadata: SessionMetadata;
+    timeline: LogEntry[];
+    decisions: LogEntry[];
+    filesAffected: string[];
+    insights: LogEntry[];
+    gitOperations: LogEntry[];
+}
+/**
+ * YAML frontmatter metadata for session logs
+ * Captures initial session state
+ */
+export interface SessionMetadata {
+    session_id: string;
+    started: string;
+    user: string;
+    branch: string;
+}
+/**
+ * Individual log entry with timestamp and category
+ * Enables defensive session logging
+ */
+export interface LogEntry {
+    timestamp: string;
+    category: 'fix' | 'feature' | 'decision' | 'insight' | 'git' | 'achievement';
+    description: string;
+    files?: string[];
+    impact: 'high' | 'medium' | 'low';
+}
+/**
+ * Parsed session log with separated frontmatter and content
+ * Internal representation for processing
+ */
+export interface ParsedSessionLog {
+    frontmatter: SessionMetadata;
+    content: string;
+    sections: {
+        timeline: LogEntry[];
+        decisions: LogEntry[];
+        filesAffected: string[];
+        insights: LogEntry[];
+        gitOperations: LogEntry[];
+    };
+}
+/**
+ * Options for creating a new session log
+ */
+export interface CreateSessionLogOptions {
+    userId: string;
+    branch: string;
+}
+/**
+ * Options for appending log entries
+ */
+export interface AppendLogEntryOptions {
+    sessionDir: string;
+    entry: LogEntry;
+    atomic?: boolean;
+}
+/**
+ * Result of log archive operation
+ */
+export interface ArchiveLogResult {
+    success: boolean;
+    archivePath: string;
+    timestamp: string;
+    error?: string;
+}
+//# sourceMappingURL=session-log.d.ts.map

package/dist/types/session-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-log.d.ts","sourceRoot":"","sources":["../../src/types/session-log.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,eAAe,CAAC;IAC1B,QAAQ,EAAE,QAAQ,EAAE,CAAC;IACrB,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,EAAE,QAAQ,EAAE,CAAC;IACrB,aAAa,EAAE,QAAQ,EAAE,CAAC;CAC3B;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,KAAK,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,KAAK,GAAG,aAAa,CAAC;IAC7E,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;CACnC;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,eAAe,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE;QACR,QAAQ,EAAE,QAAQ,EAAE,CAAC;QACrB,SAAS,EAAE,QAAQ,EAAE,CAAC;QACtB,aAAa,EAAE,MAAM,EAAE,CAAC;QACxB,QAAQ,EAAE,QAAQ,EAAE,CAAC;QACrB,aAAa,EAAE,QAAQ,EAAE,CAAC;KAC3B,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,QAAQ,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/types/session-log.js

@@ -0,0 +1,12 @@
+/**
+ * @fileType: model
+ * @status: current
+ * @updated: 2025-10-03
+ * @tags: [types, session-log, adr-033]
+ * @related: [../core/session-log-manager.ts]
+ * @priority: critical
+ * @complexity: low
+ * @dependencies: []
+ */
+export {};
+//# sourceMappingURL=session-log.js.map

package/dist/types/session-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-log.js","sourceRoot":"","sources":["../../src/types/session-log.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}