@ginkoai/cli 1.0.0

package/dist/core/documents/template-engine.js

@@ -0,0 +1,440 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-09-22
+ * @tags: [templates, engine, variables, substitution, generation]
+ * @related: [document-manager.ts, markdown-processor.ts, ../../types/documents.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [fs-extra, path]
+ */
+import * as fs from 'fs-extra';
+import * as path from 'path';
+/**
+ * Template engine for document generation
+ */
+export class TemplateEngine {
+    static instance;
+    templates = new Map();
+    templateDirs = [];
+    constructor() {
+        this.initializeBuiltinTemplates();
+    }
+    static getInstance() {
+        if (!TemplateEngine.instance) {
+            TemplateEngine.instance = new TemplateEngine();
+        }
+        return TemplateEngine.instance;
+    }
+    /**
+     * Initialize built-in templates
+     */
+    initializeBuiltinTemplates() {
+        // Ginko TypeScript file template
+        this.registerTemplate({
+            name: 'ginko-typescript',
+            description: 'Standard TypeScript file with ginko frontmatter',
+            format: 'md',
+            content: `/**
+ * @fileType: {{fileType}}
+ * @status: current
+ * @updated: {{date}}
+ * @tags: [{{tags}}]
+ * @related: [{{related}}]
+ * @priority: {{priority}}
+ * @complexity: {{complexity}}
+ * @dependencies: [{{dependencies}}]
+ */
+
+{{content}}`,
+            variables: {
+                fileType: 'utility',
+                date: new Date().toISOString().split('T')[0],
+                tags: '',
+                related: '',
+                priority: 'medium',
+                complexity: 'medium',
+                dependencies: '',
+                content: '// Add your code here'
+            }
+        });
+        // Ginko markdown document template
+        this.registerTemplate({
+            name: 'ginko-markdown',
+            description: 'Standard markdown document with frontmatter',
+            format: 'md',
+            content: `---
+title: {{title}}
+description: {{description}}
+author: {{author}}
+created: {{date}}
+updated: {{date}}
+tags: [{{tags}}]
+template: {{template}}
+---
+
+# {{title}}
+
+{{description}}
+
+## Overview
+
+{{content}}
+
+## Related Documents
+
+{{related}}`,
+            variables: {
+                title: 'Document Title',
+                description: 'Document description',
+                author: 'Ginko AI',
+                date: new Date().toISOString().split('T')[0],
+                tags: '',
+                template: 'ginko-markdown',
+                content: 'Add your content here...',
+                related: '- [Related Document](./related.md)'
+            }
+        });
+        // API documentation template
+        this.registerTemplate({
+            name: 'api-documentation',
+            description: 'API endpoint documentation template',
+            format: 'md',
+            content: `# {{endpoint}} API
+
+## Overview
+{{description}}
+
+## Endpoint
+\`{{method}} {{endpoint}}\`
+
+## Parameters
+
+### Path Parameters
+{{pathParams}}
+
+### Query Parameters
+{{queryParams}}
+
+### Request Body
+{{requestBody}}
+
+## Response
+
+### Success Response
+\`\`\`json
+{{successResponse}}
+\`\`\`
+
+### Error Responses
+{{errorResponses}}
+
+## Examples
+
+### Request
+\`\`\`bash
+{{requestExample}}
+\`\`\`
+
+### Response
+\`\`\`json
+{{responseExample}}
+\`\`\`
+
+## Notes
+{{notes}}`,
+            variables: {
+                endpoint: '/api/example',
+                method: 'GET',
+                description: 'API endpoint description',
+                pathParams: 'None',
+                queryParams: 'None',
+                requestBody: 'None',
+                successResponse: '{"success": true, "data": {}}',
+                errorResponses: '{"error": "Error message"}',
+                requestExample: 'curl -X GET /api/example',
+                responseExample: '{"success": true, "data": {}}',
+                notes: 'Additional notes about this endpoint'
+            }
+        });
+        // Configuration file template
+        this.registerTemplate({
+            name: 'config-json',
+            description: 'JSON configuration file template',
+            format: 'json',
+            content: `{
+  "name": "{{name}}",
+  "version": "{{version}}",
+  "description": "{{description}}",
+  "config": {
+    {{configItems}}
+  },
+  "created": "{{date}}",
+  "updated": "{{date}}"
+}`,
+            variables: {
+                name: 'config-name',
+                version: '1.0.0',
+                description: 'Configuration file',
+                configItems: '"key": "value"',
+                date: new Date().toISOString()
+            }
+        });
+    }
+    /**
+     * Register a new template
+     */
+    registerTemplate(template) {
+        this.templates.set(template.name, template);
+    }
+    /**
+     * Get template by name
+     */
+    getTemplate(name) {
+        return this.templates.get(name);
+    }
+    /**
+     * List all available templates
+     */
+    listTemplates() {
+        return Array.from(this.templates.values());
+    }
+    /**
+     * Add template directory
+     */
+    addTemplateDirectory(dir) {
+        if (!this.templateDirs.includes(dir)) {
+            this.templateDirs.push(dir);
+        }
+    }
+    /**
+     * Load templates from directory
+     */
+    async loadTemplatesFromDirectory(dir) {
+        try {
+            if (!await fs.pathExists(dir)) {
+                return 0;
+            }
+            this.addTemplateDirectory(dir);
+            const files = await fs.readdir(dir);
+            let loaded = 0;
+            for (const file of files) {
+                const filePath = path.join(dir, file);
+                const stats = await fs.stat(filePath);
+                if (stats.isFile() && this.isTemplateFile(file)) {
+                    const template = await this.loadTemplateFile(filePath);
+                    if (template) {
+                        this.registerTemplate(template);
+                        loaded++;
+                    }
+                }
+            }
+            return loaded;
+        }
+        catch (error) {
+            console.error(`Error loading templates from ${dir}:`, error);
+            return 0;
+        }
+    }
+    /**
+     * Check if file is a template file
+     */
+    isTemplateFile(filename) {
+        const templateExtensions = ['.template.md', '.template.json', '.template.yaml', '.template.txt'];
+        return templateExtensions.some(ext => filename.endsWith(ext));
+    }
+    /**
+     * Load template from file
+     */
+    async loadTemplateFile(filePath) {
+        try {
+            const content = await fs.readFile(filePath, 'utf8');
+            const filename = path.basename(filePath);
+            const name = filename.replace(/\.template\.\w+$/, '');
+            const format = this.getFormatFromFilename(filename);
+            if (!format) {
+                console.warn(`Unknown format for template file: ${filename}`);
+                return null;
+            }
+            // Try to extract template metadata from content
+            const metadata = this.extractTemplateMetadata(content);
+            return {
+                name,
+                description: metadata.description || `Template loaded from ${filename}`,
+                format,
+                content: metadata.content || content,
+                variables: metadata.variables || {},
+                metadata: metadata.metadata
+            };
+        }
+        catch (error) {
+            console.error(`Error loading template ${filePath}:`, error);
+            return null;
+        }
+    }
+    /**
+     * Get format from filename
+     */
+    getFormatFromFilename(filename) {
+        if (filename.includes('.template.md'))
+            return 'md';
+        if (filename.includes('.template.json'))
+            return 'json';
+        if (filename.includes('.template.yaml'))
+            return 'yaml';
+        if (filename.includes('.template.txt'))
+            return 'txt';
+        return null;
+    }
+    /**
+     * Extract template metadata from content
+     */
+    extractTemplateMetadata(content) {
+        // For now, just return the content as-is
+        // In the future, we could parse special template metadata sections
+        return { content };
+    }
+    /**
+     * Generate document from template
+     */
+    generateDocument(templateName, variables) {
+        const template = this.getTemplate(templateName);
+        if (!template) {
+            return {
+                success: false,
+                error: `Template not found: ${templateName}`
+            };
+        }
+        try {
+            const mergedVariables = this.mergeVariables(template.variables || {}, variables || {});
+            const content = this.substituteVariables(template.content, mergedVariables);
+            return {
+                success: true,
+                document: {
+                    path: '',
+                    format: template.format,
+                    metadata: template.metadata || {},
+                    content
+                }
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: `Failed to generate document: ${error instanceof Error ? error.message : String(error)}`
+            };
+        }
+    }
+    /**
+     * Substitute variables in template content
+     */
+    substituteVariables(content, variables) {
+        let result = content;
+        for (const [key, value] of Object.entries(variables)) {
+            const placeholder = `{{${key}}}`;
+            const stringValue = this.formatValue(value);
+            result = result.replace(new RegExp(placeholder.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'), 'g'), stringValue);
+        }
+        return result;
+    }
+    /**
+     * Format variable value for substitution
+     */
+    formatValue(value) {
+        if (value instanceof Date) {
+            return value.toISOString().split('T')[0];
+        }
+        return String(value);
+    }
+    /**
+     * Merge template variables with user variables
+     */
+    mergeVariables(templateVars, userVars) {
+        return { ...templateVars, ...userVars };
+    }
+    /**
+     * Validate template content
+     */
+    validateTemplate(template) {
+        const errors = [];
+        if (!template.name || template.name.trim() === '') {
+            errors.push('Template name is required');
+        }
+        if (!template.content || template.content.trim() === '') {
+            errors.push('Template content is required');
+        }
+        if (!template.format) {
+            errors.push('Template format is required');
+        }
+        // Check for valid variable placeholders
+        const placeholders = this.extractPlaceholders(template.content);
+        const variables = Object.keys(template.variables || {});
+        for (const placeholder of placeholders) {
+            if (!variables.includes(placeholder)) {
+                errors.push(`Placeholder {{${placeholder}}} has no corresponding variable`);
+            }
+        }
+        return {
+            valid: errors.length === 0,
+            errors
+        };
+    }
+    /**
+     * Extract placeholder names from template content
+     */
+    extractPlaceholders(content) {
+        const placeholderRegex = /\{\{([^}]+)\}\}/g;
+        const placeholders = [];
+        let match;
+        while ((match = placeholderRegex.exec(content)) !== null) {
+            const placeholder = match[1].trim();
+            if (!placeholders.includes(placeholder)) {
+                placeholders.push(placeholder);
+            }
+        }
+        return placeholders;
+    }
+    /**
+     * Create template from document
+     */
+    createTemplateFromDocument(name, description, content, format, extractVariables = true) {
+        const template = {
+            name,
+            description,
+            format,
+            content
+        };
+        if (extractVariables) {
+            const placeholders = this.extractPlaceholders(content);
+            template.variables = {};
+            for (const placeholder of placeholders) {
+                template.variables[placeholder] = `{{${placeholder}}}`;
+            }
+        }
+        return template;
+    }
+    /**
+     * Save template to file
+     */
+    async saveTemplate(template, outputDir) {
+        try {
+            await fs.ensureDir(outputDir);
+            const filename = `${template.name}.template.${template.format}`;
+            const filePath = path.join(outputDir, filename);
+            await fs.writeFile(filePath, template.content, 'utf8');
+            return true;
+        }
+        catch (error) {
+            console.error(`Error saving template ${template.name}:`, error);
+            return false;
+        }
+    }
+    /**
+     * Clear all templates
+     */
+    clearTemplates() {
+        this.templates.clear();
+        this.initializeBuiltinTemplates();
+    }
+}
+//# sourceMappingURL=template-engine.js.map

package/dist/core/documents/template-engine.js.map

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

package/dist/core/handoff-quality.d.ts

@@ -0,0 +1,164 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-10-01
+ * @tags: [handoff, quality, scoring, validation, adr-033, synthesis]
+ * @related: [../commands/handoff/handoff-reflection.ts, ./simple-pipeline.ts]
+ * @priority: critical
+ * @complexity: high
+ * @dependencies: [simple-git, fs-extra]
+ */
+/**
+ * Handoff Quality Management System
+ * Ensures comprehensive, high-quality handoffs for AI+Human collaboration
+ */
+export interface HandoffSection {
+    name: string;
+    required: boolean;
+    minItems?: number;
+    score: number;
+    validator: (content: string) => boolean;
+    enhancer?: (context: any) => string;
+}
+export interface QualityReport {
+    score: number;
+    maxScore: number;
+    percentage: number;
+    missing: string[];
+    weak: string[];
+    suggestions: string[];
+    passed: boolean;
+    confidence: number;
+    contextPressure?: number;
+    qualityEstimate?: number;
+    synthesisRatio?: string;
+}
+export interface HandoffContext {
+    commits: any[];
+    uncommittedChanges: any;
+    branch: string;
+    ahead: number;
+    behind: number;
+    sessionId: string;
+    duration: string;
+    startTime: Date;
+    endTime: Date;
+    prds: Array<{
+        number: string;
+        title: string;
+    }>;
+    adrs: Array<{
+        number: string;
+        title: string;
+    }>;
+    tasks: Array<{
+        number: string;
+        title: string;
+        priority: string;
+    }>;
+    focus: string;
+    modifiedFiles: Array<{
+        path: string;
+        changes: string;
+        description?: string;
+    }>;
+    newFiles: string[];
+    deletedFiles: string[];
+    todos: Array<{
+        file: string;
+        line: number;
+        text: string;
+    }>;
+    fixmes: Array<{
+        file: string;
+        line: number;
+        text: string;
+    }>;
+    patterns: any[];
+    achievements: string[];
+    decisions: string[];
+    nextSteps: Array<{
+        title: string;
+        command?: string;
+        location?: string;
+        estimate?: string;
+    }>;
+    knownIssues: string[];
+    insights: string[];
+}
+export declare class HandoffQualityScorer {
+    private static readonly SECTIONS;
+    static readonly MINIMUM_SCORE = 70;
+    static readonly TARGET_SCORE = 85;
+    /**
+     * Score a handoff's quality
+     */
+    static score(content: string): QualityReport;
+    /**
+     * Generate improvement suggestions
+     */
+    private static generateSuggestions;
+    /**
+     * Display quality report with colors
+     */
+    static displayReport(report: QualityReport): void;
+}
+export declare class HandoffContextAggregator {
+    private git;
+    private projectRoot;
+    constructor(projectRoot: string);
+    /**
+     * Gather comprehensive context from multiple sources
+     */
+    gatherContext(): Promise<HandoffContext>;
+    /**
+     * Detect active workstream from git and files
+     */
+    private detectWorkstream;
+    /**
+     * Find TODO comments in code
+     */
+    private findTodos;
+    /**
+     * Find FIXME comments in code
+     */
+    private findFixmes;
+    /**
+     * Synthesize achievements from context
+     */
+    private synthesizeAchievements;
+    /**
+     * Generate next steps based on context
+     */
+    private generateNextSteps;
+}
+export declare class HandoffEnhancer {
+    /**
+     * Enhance a handoff to meet quality standards
+     */
+    static enhance(content: string, context: HandoffContext): Promise<string>;
+    /**
+     * Add a missing section
+     */
+    private static addMissingSection;
+    /**
+     * Enhance a weak section
+     */
+    private static enhanceWeakSection;
+    /**
+     * Add quality metadata
+     */
+    private static addQualityMetadata;
+    private static generateAchievements;
+    private static generateWorkstream;
+    private static generateNextSteps;
+    private static generateModifiedFiles;
+    private static generateMentalModel;
+}
+declare const _default: {
+    HandoffQualityScorer: typeof HandoffQualityScorer;
+    HandoffContextAggregator: typeof HandoffContextAggregator;
+    HandoffEnhancer: typeof HandoffEnhancer;
+};
+export default _default;
+//# sourceMappingURL=handoff-quality.d.ts.map

package/dist/core/handoff-quality.d.ts.map

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