@ginkoai/cli 1.0.0

package/dist/core/reflection-pattern.d.ts

@@ -0,0 +1,99 @@
+/**
+ * @fileType: model
+ * @status: current
+ * @updated: 2025-09-21
+ * @tags: [reflection, pattern, core, ai, universal, path-config]
+ * @related: [../commands/backlog/ai-template.ts, config/path-config.ts]
+ * @priority: critical
+ * @complexity: high
+ * @dependencies: [chalk, path-config]
+ */
+/**
+ * Universal Reflection Pattern
+ * The core pattern for Human+AI+Structure collaboration
+ * Now uses pathManager for configuration-based path management
+ */
+export interface ReflectionPattern {
+    intent: string;
+    template: {
+        requiredSections: string[];
+        contextToConsider: string[];
+        rulesAndConstraints: string[];
+    };
+    reflection: {
+        analysisOfIntent: string;
+        suggestedStructure: string;
+        keyInsights: string[];
+        risks: string[];
+        nextSteps: string[];
+    };
+    artifact: {
+        title: string;
+        content: string;
+        type: 'markdown' | 'code' | 'json' | 'yaml';
+    };
+}
+export type ReflectionDomain = 'start' | 'handoff' | 'prd' | 'backlog' | 'documentation' | 'testing' | 'architecture' | 'debugging' | 'review' | 'refactor' | 'pattern' | 'sprint' | 'overview' | 'git' | 'ai-collaboration' | 'bug' | 'changelog';
+export interface DomainConfig {
+    name: string;
+    description: string;
+    detectPatterns: RegExp[];
+    templatePath: string;
+    outputFormat: string;
+    outputLocation: string;
+    contextGatherers: string[];
+}
+/**
+ * Base class for reflection commands with configuration-based paths
+ */
+export declare abstract class ReflectionCommand {
+    protected domain: string;
+    private pathConfig;
+    constructor(domain: string);
+    abstract execute(intent: string, options?: any): Promise<void>;
+    /**
+     * Generate prompt for AI reflection
+     */
+    protected generatePrompt(intent: string, template: any, context: any): Promise<string>;
+    /**
+     * Get dynamic output paths based on pathManager configuration
+     */
+    protected getOutputPath(domain: ReflectionDomain): string;
+    /**
+     * Load domain configuration with dynamic paths
+     */
+    protected loadDomainConfig(domain: ReflectionDomain): DomainConfig;
+    /**
+     * Format context for display
+     */
+    protected formatContext(context: any): string;
+    /**
+     * Format rules for display
+     */
+    protected formatRules(rules?: string[]): string;
+}
+/**
+ * Factory for creating reflection commands
+ */
+export declare class ReflectionFactory {
+    static create(domain: ReflectionDomain): ReflectionCommand;
+    static detectDomain(intent: string): ReflectionDomain | null;
+}
+/**
+ * Utility functions for reflection patterns
+ */
+export declare const ReflectionUtils: {
+    /**
+     * Generate a timestamp for artifacts
+     */
+    timestamp(): string;
+    /**
+     * Sanitize filename for cross-platform compatibility
+     */
+    sanitizeFilename(filename: string): string;
+    /**
+     * Create relative path from project root
+     */
+    createRelativePath(absolutePath: string): string;
+};
+//# sourceMappingURL=reflection-pattern.d.ts.map

package/dist/core/reflection-pattern.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reflection-pattern.d.ts","sourceRoot":"","sources":["../../src/core/reflection-pattern.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAEhC,MAAM,EAAE,MAAM,CAAC;IAGf,QAAQ,EAAE;QACR,gBAAgB,EAAE,MAAM,EAAE,CAAC;QAC3B,iBAAiB,EAAE,MAAM,EAAE,CAAC;QAC5B,mBAAmB,EAAE,MAAM,EAAE,CAAC;KAC/B,CAAC;IAGF,UAAU,EAAE;QACV,gBAAgB,EAAE,MAAM,CAAC;QACzB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,KAAK,EAAE,MAAM,EAAE,CAAC;QAChB,SAAS,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;IAGF,QAAQ,EAAE;QACR,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;KAC7C,CAAC;CACH;AAED,MAAM,MAAM,gBAAgB,GACxB,OAAO,GAAG,SAAS,GAAG,KAAK,GAAG,SAAS,GAAG,eAAe,GACzD,SAAS,GAAG,cAAc,GAAG,WAAW,GAAG,QAAQ,GAAG,UAAU,GAChE,SAAS,GAAG,QAAQ,GAAG,UAAU,GAAG,KAAK,GAAG,kBAAkB,GAC9D,KAAK,GAAG,WAAW,CAAC;AAExB,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED;;GAEG;AACH,8BAAsB,iBAAiB;IACrC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,UAAU,CAA2B;gBAEjC,MAAM,EAAE,MAAM;IAI1B,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAE9D;;OAEG;cACa,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC;IAuB5F;;OAEG;IACH,SAAS,CAAC,aAAa,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM;IAwBzD;;OAEG;IACH,SAAS,CAAC,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,YAAY;IAkKlE;;OAEG;IACH,SAAS,CAAC,aAAa,CAAC,OAAO,EAAE,GAAG,GAAG,MAAM;IAM7C;;OAEG;IACH,SAAS,CAAC,WAAW,CAAC,KAAK,GAAE,MAAM,EAAO,GAAG,MAAM;CAGpD;AAED;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,iBAAiB;IAK1D,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;CAY7D;AAED;;GAEG;AACH,eAAO,MAAM,eAAe;IAC1B;;OAEG;iBACU,MAAM;IAInB;;OAEG;+BACwB,MAAM,GAAG,MAAM;IAQ1C;;OAEG;qCAC8B,MAAM,GAAG,MAAM;CAGjD,CAAC"}

package/dist/core/reflection-pattern.js

@@ -0,0 +1,294 @@
+/**
+ * @fileType: model
+ * @status: current
+ * @updated: 2025-09-21
+ * @tags: [reflection, pattern, core, ai, universal, path-config]
+ * @related: [../commands/backlog/ai-template.ts, config/path-config.ts]
+ * @priority: critical
+ * @complexity: high
+ * @dependencies: [chalk, path-config]
+ */
+import { pathManager } from './utils/paths.js';
+/**
+ * Base class for reflection commands with configuration-based paths
+ */
+export class ReflectionCommand {
+    domain;
+    pathConfig = pathManager.getConfig();
+    constructor(domain) {
+        this.domain = domain;
+    }
+    /**
+     * Generate prompt for AI reflection
+     */
+    async generatePrompt(intent, template, context) {
+        const formattedContext = this.formatContext(context);
+        const formattedRules = this.formatRules(template.rulesAndConstraints);
+        return `
+Intent: ${intent}
+
+Template Sections Required:
+${template.requiredSections?.map((s) => `- ${s}`).join('\n') || 'No sections specified'}
+
+Context to Consider:
+${template.contextToConsider?.map((c) => `- ${c}`).join('\n') || 'No context specified'}
+
+Current Context:
+${formattedContext}
+
+Rules and Constraints:
+${formattedRules}
+
+Please provide a structured response addressing all required sections.
+    `.trim();
+    }
+    /**
+     * Get dynamic output paths based on pathManager configuration
+     */
+    getOutputPath(domain) {
+        const pathMappings = {
+            'start': this.pathConfig.ginko.sessions,
+            'handoff': this.pathConfig.ginko.sessions,
+            'prd': this.pathConfig.docs.prd,
+            'backlog': this.pathConfig.ginko.backlog,
+            'documentation': this.pathConfig.docs.root,
+            'testing': pathManager.joinPaths(this.pathConfig.project.root, 'tests'),
+            'architecture': this.pathConfig.docs.adr,
+            'debugging': pathManager.joinPaths(this.pathConfig.project.root, 'debug'),
+            'review': pathManager.joinPaths(this.pathConfig.project.root, 'reviews'),
+            'refactor': pathManager.joinPaths(this.pathConfig.project.root, 'refactors'),
+            'pattern': pathManager.joinPaths(this.pathConfig.ginko.root, 'patterns'),
+            'sprint': this.pathConfig.docs.sprints,
+            'overview': this.pathConfig.docs.root,
+            'git': this.pathConfig.project.root,
+            'ai-collaboration': pathManager.joinPaths(this.pathConfig.ginko.root, 'ai-collab'),
+            'bug': pathManager.joinPaths(this.pathConfig.ginko.root, 'bugs'),
+            'changelog': this.pathConfig.docs.root
+        };
+        return pathMappings[domain] || this.pathConfig.docs.root;
+    }
+    /**
+     * Load domain configuration with dynamic paths
+     */
+    loadDomainConfig(domain) {
+        const configs = {
+            start: {
+                name: 'start',
+                description: 'Intelligent session initialization',
+                detectPatterns: [/start|begin|resume|init|session/i],
+                templatePath: 'templates/start.md',
+                outputFormat: 'markdown',
+                outputLocation: this.getOutputPath('start'),
+                contextGatherers: ['handoff', 'git', 'session']
+            },
+            handoff: {
+                name: 'handoff',
+                description: 'Session state preservation',
+                detectPatterns: [/handoff|stop|pause|save|preserve/i],
+                templatePath: 'templates/handoff.md',
+                outputFormat: 'markdown',
+                outputLocation: this.getOutputPath('handoff'),
+                contextGatherers: ['git', 'session', 'workstream']
+            },
+            prd: {
+                name: 'prd',
+                description: 'Product Requirements Document',
+                detectPatterns: [/prd|requirements|product spec|user story|pain point/i],
+                templatePath: 'templates/prd.md',
+                outputFormat: 'markdown',
+                outputLocation: this.getOutputPath('prd'),
+                contextGatherers: ['product', 'users', 'market']
+            },
+            backlog: {
+                name: 'backlog',
+                description: 'Backlog item creation and management',
+                detectPatterns: [/create|feature|story|task|backlog/i],
+                templatePath: 'templates/backlog.md',
+                outputFormat: 'markdown',
+                outputLocation: this.getOutputPath('backlog'),
+                contextGatherers: ['git', 'backlog', 'session']
+            },
+            documentation: {
+                name: 'documentation',
+                description: 'Documentation generation',
+                detectPatterns: [/doc|api|readme|guide/i],
+                templatePath: 'templates/documentation.md',
+                outputFormat: 'markdown',
+                outputLocation: this.getOutputPath('documentation'),
+                contextGatherers: ['code', 'tests', 'comments']
+            },
+            testing: {
+                name: 'testing',
+                description: 'Test generation',
+                detectPatterns: [/test|spec|coverage/i],
+                templatePath: 'templates/testing.md',
+                outputFormat: 'code',
+                outputLocation: this.getOutputPath('testing'),
+                contextGatherers: ['implementation', 'coverage', 'fixtures']
+            },
+            architecture: {
+                name: 'architecture',
+                description: 'Architecture decisions',
+                detectPatterns: [/architecture|adr|design/i],
+                templatePath: 'templates/architecture.md',
+                outputFormat: 'markdown',
+                outputLocation: this.getOutputPath('architecture'),
+                contextGatherers: ['current-arch', 'constraints', 'alternatives']
+            },
+            debugging: {
+                name: 'debugging',
+                description: 'Debug investigation',
+                detectPatterns: [/debug|investigate|error|bug/i],
+                templatePath: 'templates/debugging.md',
+                outputFormat: 'markdown',
+                outputLocation: this.getOutputPath('debugging'),
+                contextGatherers: ['logs', 'errors', 'recent-changes']
+            },
+            review: {
+                name: 'review',
+                description: 'Code review',
+                detectPatterns: [/review|pr|pull request/i],
+                templatePath: 'templates/review.md',
+                outputFormat: 'markdown',
+                outputLocation: this.getOutputPath('review'),
+                contextGatherers: ['diff', 'conventions', 'history']
+            },
+            refactor: {
+                name: 'refactor',
+                description: 'Code refactoring',
+                detectPatterns: [/refactor|extract|reorganize/i],
+                templatePath: 'templates/refactor.md',
+                outputFormat: 'code',
+                outputLocation: this.getOutputPath('refactor'),
+                contextGatherers: ['current-code', 'dependencies', 'tests']
+            },
+            pattern: {
+                name: 'pattern',
+                description: 'Pattern creation',
+                detectPatterns: [/pattern|template|framework/i],
+                templatePath: 'templates/pattern.md',
+                outputFormat: 'markdown',
+                outputLocation: this.getOutputPath('pattern'),
+                contextGatherers: ['existing-patterns', 'use-cases']
+            },
+            sprint: {
+                name: 'sprint',
+                description: 'Sprint planning and work breakdown',
+                detectPatterns: [/sprint|planning|breakdown|wbs|iteration/i],
+                templatePath: 'templates/sprint.md',
+                outputFormat: 'markdown',
+                outputLocation: this.getOutputPath('sprint'),
+                contextGatherers: ['backlog', 'team', 'velocity']
+            },
+            overview: {
+                name: 'overview',
+                description: 'System overview and architecture documentation',
+                detectPatterns: [/overview|system|big picture|architecture doc/i],
+                templatePath: 'templates/overview.md',
+                outputFormat: 'markdown',
+                outputLocation: this.getOutputPath('overview'),
+                contextGatherers: ['architecture', 'components', 'principles']
+            },
+            git: {
+                name: 'git',
+                description: 'Git workflow automation',
+                detectPatterns: [/git|branch|commit|pr|pull request|merge/i],
+                templatePath: 'templates/git.md',
+                outputFormat: 'markdown',
+                outputLocation: this.getOutputPath('git'),
+                contextGatherers: ['git-status', 'recent-commits', 'branch-info']
+            },
+            'ai-collaboration': {
+                name: 'ai-collaboration',
+                description: 'AI collaboration patterns and insights',
+                detectPatterns: [/ai|claude|gpt|collaboration|prompt/i],
+                templatePath: 'templates/ai-collaboration.md',
+                outputFormat: 'markdown',
+                outputLocation: this.getOutputPath('ai-collaboration'),
+                contextGatherers: ['conversation-history', 'patterns', 'effectiveness']
+            },
+            bug: {
+                name: 'bug',
+                description: 'Bug tracking and resolution',
+                detectPatterns: [/bug|defect|issue|broken|error|crash/i],
+                templatePath: 'templates/bug.md',
+                outputFormat: 'markdown',
+                outputLocation: this.getOutputPath('bug'),
+                contextGatherers: ['errors', 'logs', 'recent-changes', 'affected-files']
+            },
+            changelog: {
+                name: 'changelog',
+                description: 'Changelog generation from git history',
+                detectPatterns: [/changelog|changes|release notes|version/i],
+                templatePath: 'templates/changelog.md',
+                outputFormat: 'markdown',
+                outputLocation: this.getOutputPath('changelog'),
+                contextGatherers: ['git-commits', 'version-tags', 'pr-history']
+            }
+        };
+        return configs[domain];
+    }
+    // ... rest of the methods remain the same
+    /**
+     * Format context for display
+     */
+    formatContext(context) {
+        return Object.entries(context)
+            .map(([key, value]) => `${key}:\n${JSON.stringify(value, null, 2)}`)
+            .join('\n\n');
+    }
+    /**
+     * Format rules for display
+     */
+    formatRules(rules = []) {
+        return rules.map((rule, i) => `${i + 1}. ${rule}`).join('\n');
+    }
+}
+/**
+ * Factory for creating reflection commands
+ */
+export class ReflectionFactory {
+    static create(domain) {
+        // This would return specific implementations
+        throw new Error(`Reflection command for domain ${domain} not implemented`);
+    }
+    static detectDomain(intent) {
+        const domains = [
+            'start', 'handoff', 'prd', 'backlog', 'documentation',
+            'testing', 'architecture', 'debugging', 'review', 'refactor',
+            'pattern', 'sprint', 'overview', 'git', 'ai-collaboration',
+            'bug', 'changelog'
+        ];
+        // Domain auto-detection disabled - requires explicit domain parameter
+        // TODO: Implement proper domain detection without accessing protected methods
+        return null;
+    }
+}
+/**
+ * Utility functions for reflection patterns
+ */
+export const ReflectionUtils = {
+    /**
+     * Generate a timestamp for artifacts
+     */
+    timestamp() {
+        return new Date().toISOString().slice(0, 19).replace(/:/g, '-');
+    },
+    /**
+     * Sanitize filename for cross-platform compatibility
+     */
+    sanitizeFilename(filename) {
+        return filename
+            .toLowerCase()
+            .replace(/[^a-z0-9-]/g, '-')
+            .replace(/-+/g, '-')
+            .replace(/^-|-$/g, '');
+    },
+    /**
+     * Create relative path from project root
+     */
+    createRelativePath(absolutePath) {
+        return pathManager.getRelativePath(absolutePath);
+    }
+};
+//# sourceMappingURL=reflection-pattern.js.map

package/dist/core/reflection-pattern.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reflection-pattern.js","sourceRoot":"","sources":["../../src/core/reflection-pattern.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAmD/C;;GAEG;AACH,MAAM,OAAgB,iBAAiB;IAC3B,MAAM,CAAS;IACjB,UAAU,GAAG,WAAW,CAAC,SAAS,EAAE,CAAC;IAE7C,YAAY,MAAc;QACxB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAID;;OAEG;IACO,KAAK,CAAC,cAAc,CAAC,MAAc,EAAE,QAAa,EAAE,OAAY;QACxE,MAAM,gBAAgB,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QACrD,MAAM,cAAc,GAAG,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC;QAEtE,OAAO;UACD,MAAM;;;EAGd,QAAQ,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,uBAAuB;;;EAG7F,QAAQ,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,sBAAsB;;;EAG7F,gBAAgB;;;EAGhB,cAAc;;;KAGX,CAAC,IAAI,EAAE,CAAC;IACX,CAAC;IAED;;OAEG;IACO,aAAa,CAAC,MAAwB;QAC9C,MAAM,YAAY,GAAqC;YACrD,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,QAAQ;YACvC,SAAS,EAAE,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,QAAQ;YACzC,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG;YAC/B,SAAS,EAAE,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO;YACxC,eAAe,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI;YAC1C,SAAS,EAAE,WAAW,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;YACvE,cAAc,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG;YACxC,WAAW,EAAE,WAAW,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;YACzE,QAAQ,EAAE,WAAW,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC;YACxE,UAAU,EAAE,WAAW,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,WAAW,CAAC;YAC5E,SAAS,EAAE,WAAW,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC;YACxE,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO;YACtC,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI;YACrC,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI;YACnC,kBAAkB,EAAE,WAAW,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,EAAE,WAAW,CAAC;YAClF,KAAK,EAAE,WAAW,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC;YAChE,WAAW,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI;SACvC,CAAC;QAEF,OAAO,YAAY,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;IAC3D,CAAC;IAED;;OAEG;IACO,gBAAgB,CAAC,MAAwB;QACjD,MAAM,OAAO,GAA2C;YACtD,KAAK,EAAE;gBACL,IAAI,EAAE,OAAO;gBACb,WAAW,EAAE,oCAAoC;gBACjD,cAAc,EAAE,CAAC,kCAAkC,CAAC;gBACpD,YAAY,EAAE,oBAAoB;gBAClC,YAAY,EAAE,UAAU;gBACxB,cAAc,EAAE,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC;gBAC3C,gBAAgB,EAAE,CAAC,SAAS,EAAE,KAAK,EAAE,SAAS,CAAC;aAChD;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,4BAA4B;gBACzC,cAAc,EAAE,CAAC,mCAAmC,CAAC;gBACrD,YAAY,EAAE,sBAAsB;gBACpC,YAAY,EAAE,UAAU;gBACxB,cAAc,EAAE,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC;gBAC7C,gBAAgB,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,YAAY,CAAC;aACnD;YACD,GAAG,EAAE;gBACH,IAAI,EAAE,KAAK;gBACX,WAAW,EAAE,+BAA+B;gBAC5C,cAAc,EAAE,CAAC,sDAAsD,CAAC;gBACxE,YAAY,EAAE,kBAAkB;gBAChC,YAAY,EAAE,UAAU;gBACxB,cAAc,EAAE,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC;gBACzC,gBAAgB,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,QAAQ,CAAC;aACjD;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,sCAAsC;gBACnD,cAAc,EAAE,CAAC,oCAAoC,CAAC;gBACtD,YAAY,EAAE,sBAAsB;gBACpC,YAAY,EAAE,UAAU;gBACxB,cAAc,EAAE,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC;gBAC7C,gBAAgB,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,CAAC;aAChD;YACD,aAAa,EAAE;gBACb,IAAI,EAAE,eAAe;gBACrB,WAAW,EAAE,0BAA0B;gBACvC,cAAc,EAAE,CAAC,uBAAuB,CAAC;gBACzC,YAAY,EAAE,4BAA4B;gBAC1C,YAAY,EAAE,UAAU;gBACxB,cAAc,EAAE,IAAI,CAAC,aAAa,CAAC,eAAe,CAAC;gBACnD,gBAAgB,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,UAAU,CAAC;aAChD;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,iBAAiB;gBAC9B,cAAc,EAAE,CAAC,qBAAqB,CAAC;gBACvC,YAAY,EAAE,sBAAsB;gBACpC,YAAY,EAAE,MAAM;gBACpB,cAAc,EAAE,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC;gBAC7C,gBAAgB,EAAE,CAAC,gBAAgB,EAAE,UAAU,EAAE,UAAU,CAAC;aAC7D;YACD,YAAY,EAAE;gBACZ,IAAI,EAAE,cAAc;gBACpB,WAAW,EAAE,wBAAwB;gBACrC,cAAc,EAAE,CAAC,0BAA0B,CAAC;gBAC5C,YAAY,EAAE,2BAA2B;gBACzC,YAAY,EAAE,UAAU;gBACxB,cAAc,EAAE,IAAI,CAAC,aAAa,CAAC,cAAc,CAAC;gBAClD,gBAAgB,EAAE,CAAC,cAAc,EAAE,aAAa,EAAE,cAAc,CAAC;aAClE;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,WAAW;gBACjB,WAAW,EAAE,qBAAqB;gBAClC,cAAc,EAAE,CAAC,8BAA8B,CAAC;gBAChD,YAAY,EAAE,wBAAwB;gBACtC,YAAY,EAAE,UAAU;gBACxB,cAAc,EAAE,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC;gBAC/C,gBAAgB,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,gBAAgB,CAAC;aACvD;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,aAAa;gBAC1B,cAAc,EAAE,CAAC,yBAAyB,CAAC;gBAC3C,YAAY,EAAE,qBAAqB;gBACnC,YAAY,EAAE,UAAU;gBACxB,cAAc,EAAE,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC;gBAC5C,gBAAgB,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,SAAS,CAAC;aACrD;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,UAAU;gBAChB,WAAW,EAAE,kBAAkB;gBAC/B,cAAc,EAAE,CAAC,8BAA8B,CAAC;gBAChD,YAAY,EAAE,uBAAuB;gBACrC,YAAY,EAAE,MAAM;gBACpB,cAAc,EAAE,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC;gBAC9C,gBAAgB,EAAE,CAAC,cAAc,EAAE,cAAc,EAAE,OAAO,CAAC;aAC5D;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,kBAAkB;gBAC/B,cAAc,EAAE,CAAC,6BAA6B,CAAC;gBAC/C,YAAY,EAAE,sBAAsB;gBACpC,YAAY,EAAE,UAAU;gBACxB,cAAc,EAAE,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC;gBAC7C,gBAAgB,EAAE,CAAC,mBAAmB,EAAE,WAAW,CAAC;aACrD;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,oCAAoC;gBACjD,cAAc,EAAE,CAAC,0CAA0C,CAAC;gBAC5D,YAAY,EAAE,qBAAqB;gBACnC,YAAY,EAAE,UAAU;gBACxB,cAAc,EAAE,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC;gBAC5C,gBAAgB,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC;aAClD;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,UAAU;gBAChB,WAAW,EAAE,gDAAgD;gBAC7D,cAAc,EAAE,CAAC,+CAA+C,CAAC;gBACjE,YAAY,EAAE,uBAAuB;gBACrC,YAAY,EAAE,UAAU;gBACxB,cAAc,EAAE,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC;gBAC9C,gBAAgB,EAAE,CAAC,cAAc,EAAE,YAAY,EAAE,YAAY,CAAC;aAC/D;YACD,GAAG,EAAE;gBACH,IAAI,EAAE,KAAK;gBACX,WAAW,EAAE,yBAAyB;gBACtC,cAAc,EAAE,CAAC,0CAA0C,CAAC;gBAC5D,YAAY,EAAE,kBAAkB;gBAChC,YAAY,EAAE,UAAU;gBACxB,cAAc,EAAE,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC;gBACzC,gBAAgB,EAAE,CAAC,YAAY,EAAE,gBAAgB,EAAE,aAAa,CAAC;aAClE;YACD,kBAAkB,EAAE;gBAClB,IAAI,EAAE,kBAAkB;gBACxB,WAAW,EAAE,wCAAwC;gBACrD,cAAc,EAAE,CAAC,qCAAqC,CAAC;gBACvD,YAAY,EAAE,+BAA+B;gBAC7C,YAAY,EAAE,UAAU;gBACxB,cAAc,EAAE,IAAI,CAAC,aAAa,CAAC,kBAAkB,CAAC;gBACtD,gBAAgB,EAAE,CAAC,sBAAsB,EAAE,UAAU,EAAE,eAAe,CAAC;aACxE;YACD,GAAG,EAAE;gBACH,IAAI,EAAE,KAAK;gBACX,WAAW,EAAE,6BAA6B;gBAC1C,cAAc,EAAE,CAAC,sCAAsC,CAAC;gBACxD,YAAY,EAAE,kBAAkB;gBAChC,YAAY,EAAE,UAAU;gBACxB,cAAc,EAAE,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC;gBACzC,gBAAgB,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,gBAAgB,EAAE,gBAAgB,CAAC;aACzE;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,WAAW;gBACjB,WAAW,EAAE,uCAAuC;gBACpD,cAAc,EAAE,CAAC,0CAA0C,CAAC;gBAC5D,YAAY,EAAE,wBAAwB;gBACtC,YAAY,EAAE,UAAU;gBACxB,cAAc,EAAE,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC;gBAC/C,gBAAgB,EAAE,CAAC,aAAa,EAAE,cAAc,EAAE,YAAY,CAAC;aAChE;SACF,CAAC;QAEF,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC;IACzB,CAAC;IAED,0CAA0C;IAE1C;;OAEG;IACO,aAAa,CAAC,OAAY;QAClC,OAAO,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;aAC3B,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aACnE,IAAI,CAAC,MAAM,CAAC,CAAC;IAClB,CAAC;IAED;;OAEG;IACO,WAAW,CAAC,QAAkB,EAAE;QACxC,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChE,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,iBAAiB;IAC5B,MAAM,CAAC,MAAM,CAAC,MAAwB;QACpC,6CAA6C;QAC7C,MAAM,IAAI,KAAK,CAAC,iCAAiC,MAAM,kBAAkB,CAAC,CAAC;IAC7E,CAAC;IAED,MAAM,CAAC,YAAY,CAAC,MAAc;QAChC,MAAM,OAAO,GAAuB;YAClC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,eAAe;YACrD,SAAS,EAAE,cAAc,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU;YAC5D,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,kBAAkB;YAC1D,KAAK,EAAE,WAAW;SACnB,CAAC;QAEF,sEAAsE;QACtE,8EAA8E;QAC9E,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B;;OAEG;IACH,SAAS;QACP,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAClE,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,QAAgB;QAC/B,OAAO,QAAQ;aACZ,WAAW,EAAE;aACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;aAC3B,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;aACnB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,kBAAkB,CAAC,YAAoB;QACrC,OAAO,WAAW,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC;IACnD,CAAC;CACF,CAAC"}

package/dist/core/session-log-manager.d.ts

@@ -0,0 +1,83 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-10-03
+ * @tags: [session-logging, defensive-logging, handoff, continuous-logging]
+ * @related: [handoff/handoff-reflection-pipeline.ts, start/index.ts]
+ * @priority: high
+ * @complexity: high
+ * @dependencies: [fs, path, yaml]
+ */
+export type LogCategory = 'fix' | 'feature' | 'decision' | 'insight' | 'git' | 'achievement';
+export type LogImpact = 'high' | 'medium' | 'low';
+export interface LogEntry {
+    timestamp: string;
+    category: LogCategory;
+    description: string;
+    files?: string[];
+    impact: LogImpact;
+}
+export interface SessionLogMetadata {
+    session_id: string;
+    started: string;
+    user: string;
+    branch: string;
+}
+export interface SessionLog {
+    metadata: SessionLogMetadata;
+    timeline: LogEntry[];
+    keyDecisions: LogEntry[];
+    filesAffected: Set<string>;
+    insights: LogEntry[];
+    gitOperations: LogEntry[];
+}
+export declare class SessionLogManager {
+    private static SESSION_LOG_FILENAME;
+    private static ARCHIVE_DIR;
+    /**
+     * Get the session log path for a user
+     */
+    private static getSessionLogPath;
+    /**
+     * Get archive directory path
+     */
+    private static getArchiveDir;
+    /**
+     * Create a new session log
+     */
+    static createSessionLog(userDir: string, user: string, branch: string): Promise<void>;
+    /**
+     * Append an entry to the session log
+     * Atomic operation to prevent corruption
+     */
+    static appendEntry(userDir: string, entry: LogEntry): Promise<void>;
+    /**
+     * Load the current session log
+     */
+    static loadSessionLog(userDir: string): Promise<string>;
+    /**
+     * Archive the session log with timestamp
+     */
+    static archiveLog(userDir: string, handoffSummary?: string): Promise<string>;
+    /**
+     * Check if a session log exists
+     */
+    static hasSessionLog(userDir: string): Promise<boolean>;
+    /**
+     * Parse session log metadata from frontmatter
+     */
+    static parseMetadata(logContent: string): SessionLogMetadata | null;
+    /**
+     * Extract entries from a section
+     */
+    static extractEntries(logContent: string, section: string): LogEntry[];
+    /**
+     * Get summary statistics from session log
+     */
+    static getSummary(logContent: string): {
+        totalEntries: number;
+        byCategory: Record<string, number>;
+        filesAffected: number;
+    };
+}
+//# sourceMappingURL=session-log-manager.d.ts.map

package/dist/core/session-log-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-log-manager.d.ts","sourceRoot":"","sources":["../../src/core/session-log-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAcH,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,KAAK,GAAG,aAAa,CAAC;AAC7F,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAElD,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,WAAW,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,SAAS,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,QAAQ,EAAE,QAAQ,EAAE,CAAC;IACrB,YAAY,EAAE,QAAQ,EAAE,CAAC;IACzB,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3B,QAAQ,EAAE,QAAQ,EAAE,CAAC;IACrB,aAAa,EAAE,QAAQ,EAAE,CAAC;CAC3B;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAC,oBAAoB,CAA4B;IAC/D,OAAO,CAAC,MAAM,CAAC,WAAW,CAAa;IAEvC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAIhC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAI5B;;OAEG;WACU,gBAAgB,CAC3B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC;IAmChB;;;OAGG;WACU,WAAW,CACtB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,QAAQ,GACd,OAAO,CAAC,IAAI,CAAC;IAiFhB;;OAEG;WACU,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAU7D;;OAEG;WACU,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAiClF;;OAEG;WACU,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAU7D;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI;IAuBnE;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,QAAQ,EAAE;IAiDtE;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG;QACrC,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACnC,aAAa,EAAE,MAAM,CAAC;KACvB;CA0BF"}