@ginkoai/cli 1.0.0

package/dist/core/documents/sequence-manager.js

@@ -0,0 +1,246 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-09-19
+ * @tags: [document, sequence, numbering, persistence]
+ * @related: [document-namer.ts, document-migrator.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [fs-extra, path]
+ */
+import * as fs from 'fs-extra';
+import * as path from 'path';
+/**
+ * Manages document sequence numbers for consistent naming convention.
+ * Ensures thread-safe allocation and persistent storage of document numbers.
+ */
+export class SequenceManager {
+    sequencePath;
+    lockPath;
+    data;
+    config;
+    constructor(config) {
+        this.config = config;
+        this.sequencePath = path.join(config.ginkoRoot, '.ginko', 'sequences.json');
+        this.lockPath = path.join(config.ginkoRoot, '.ginko', 'sequences.lock');
+        this.data = this.getDefaultData();
+    }
+    /**
+     * Initialize the sequence manager by loading existing data or creating defaults
+     */
+    async initialize() {
+        try {
+            await fs.ensureDir(path.dirname(this.sequencePath));
+            if (await fs.pathExists(this.sequencePath)) {
+                await this.loadSequenceData();
+            }
+            else {
+                await this.scanExistingDocuments();
+                await this.saveSequenceData();
+            }
+        }
+        catch (error) {
+            throw new Error(`Failed to initialize SequenceManager: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Get the next sequence number for a document type
+     */
+    async getNext(type) {
+        await this.acquireLock();
+        try {
+            await this.loadSequenceData();
+            const nextNumber = this.data.sequences[type];
+            this.data.sequences[type]++;
+            this.data.lastUpdated = new Date().toISOString();
+            await this.saveSequenceData();
+            return nextNumber;
+        }
+        finally {
+            await this.releaseLock();
+        }
+    }
+    /**
+     * Get the current sequence number for a document type without incrementing
+     */
+    async getCurrent(type) {
+        await this.loadSequenceData();
+        return this.data.sequences[type] - 1;
+    }
+    /**
+     * Set a specific sequence number for a document type
+     */
+    async setSequence(type, number) {
+        if (number < 1) {
+            throw new Error(`Sequence number must be positive, got: ${number}`);
+        }
+        await this.acquireLock();
+        try {
+            await this.loadSequenceData();
+            this.data.sequences[type] = number;
+            this.data.lastUpdated = new Date().toISOString();
+            await this.saveSequenceData();
+        }
+        finally {
+            await this.releaseLock();
+        }
+    }
+    /**
+     * Reset sequences based on existing documents in the filesystem
+     */
+    async rescanDocuments() {
+        await this.acquireLock();
+        try {
+            await this.scanExistingDocuments();
+            await this.saveSequenceData();
+        }
+        finally {
+            await this.releaseLock();
+        }
+    }
+    /**
+     * Get all current sequence numbers
+     */
+    async getAllSequences() {
+        await this.loadSequenceData();
+        return { ...this.data.sequences };
+    }
+    /**
+     * Load sequence data from persistent storage
+     */
+    async loadSequenceData() {
+        try {
+            if (await fs.pathExists(this.sequencePath)) {
+                const content = await fs.readJson(this.sequencePath);
+                this.data = this.validateSequenceData(content);
+            }
+        }
+        catch (error) {
+            // If we can't load, fall back to scanning documents
+            await this.scanExistingDocuments();
+        }
+    }
+    /**
+     * Save sequence data to persistent storage
+     */
+    async saveSequenceData() {
+        await fs.writeJson(this.sequencePath, this.data, { spaces: 2 });
+    }
+    /**
+     * Scan existing documents to determine current sequence numbers
+     */
+    async scanExistingDocuments() {
+        const docsPath = path.join(this.config.ginkoRoot, 'docs');
+        const typeDirectories = {
+            'ADR': path.join(docsPath, 'adr'),
+            'PRD': path.join(docsPath, 'PRD'),
+            'SPRINT': path.join(docsPath, 'sprints'),
+            'STRATEGY': path.join(docsPath, 'strategy')
+        };
+        for (const [type, dirPath] of Object.entries(typeDirectories)) {
+            let maxNumber = this.config.startingNumbers?.[type] || 1;
+            if (await fs.pathExists(dirPath)) {
+                const files = await fs.readdir(dirPath);
+                for (const file of files) {
+                    if (file.endsWith('.md')) {
+                        const match = file.match(new RegExp(`^${type}-(\\d{3})-`));
+                        if (match) {
+                            const number = parseInt(match[1], 10);
+                            maxNumber = Math.max(maxNumber, number + 1);
+                        }
+                    }
+                }
+            }
+            this.data.sequences[type] = maxNumber;
+        }
+        this.data.lastUpdated = new Date().toISOString();
+    }
+    /**
+     * Acquire a lock for thread-safe operations
+     */
+    async acquireLock() {
+        let attempts = 0;
+        const maxAttempts = 100;
+        const retryDelay = 50; // milliseconds
+        while (attempts < maxAttempts) {
+            try {
+                await fs.writeFile(this.lockPath, process.pid.toString(), { flag: 'wx' });
+                return;
+            }
+            catch (error) {
+                attempts++;
+                if (attempts >= maxAttempts) {
+                    throw new Error('Failed to acquire sequence lock after maximum attempts');
+                }
+                await this.delay(retryDelay);
+            }
+        }
+    }
+    /**
+     * Release the lock
+     */
+    async releaseLock() {
+        try {
+            await fs.remove(this.lockPath);
+        }
+        catch (error) {
+            // Lock file might not exist, which is ok
+        }
+    }
+    /**
+     * Simple delay utility
+     */
+    delay(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+    /**
+     * Get default sequence data
+     */
+    getDefaultData() {
+        return {
+            version: '1.0.0',
+            sequences: {
+                'ADR': this.config.startingNumbers?.ADR || 1,
+                'PRD': this.config.startingNumbers?.PRD || 1,
+                'SPRINT': this.config.startingNumbers?.SPRINT || 1,
+                'STRATEGY': this.config.startingNumbers?.STRATEGY || 1
+            },
+            lastUpdated: new Date().toISOString()
+        };
+    }
+    /**
+     * Validate and migrate sequence data from storage
+     */
+    validateSequenceData(data) {
+        const defaultData = this.getDefaultData();
+        if (!data || typeof data !== 'object') {
+            return defaultData;
+        }
+        return {
+            version: data.version || defaultData.version,
+            sequences: {
+                'ADR': this.validateSequenceNumber(data.sequences?.ADR, defaultData.sequences.ADR),
+                'PRD': this.validateSequenceNumber(data.sequences?.PRD, defaultData.sequences.PRD),
+                'SPRINT': this.validateSequenceNumber(data.sequences?.SPRINT, defaultData.sequences.SPRINT),
+                'STRATEGY': this.validateSequenceNumber(data.sequences?.STRATEGY, defaultData.sequences.STRATEGY)
+            },
+            lastUpdated: data.lastUpdated || defaultData.lastUpdated
+        };
+    }
+    /**
+     * Validate a sequence number
+     */
+    validateSequenceNumber(value, defaultValue) {
+        if (typeof value === 'number' && value >= 1 && Number.isInteger(value)) {
+            return value;
+        }
+        return defaultValue;
+    }
+}
+/**
+ * Create a sequence manager instance with default configuration
+ */
+export function createSequenceManager(ginkoRoot, startingNumbers) {
+    return new SequenceManager({ ginkoRoot, startingNumbers });
+}
+//# sourceMappingURL=sequence-manager.js.map

package/dist/core/documents/sequence-manager.js.map

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

package/dist/core/documents/template-engine.d.ts

@@ -0,0 +1,101 @@
+/**
+ * @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 { DocumentTemplate, TemplateVariables, DocumentFormat, DocumentResult } from '../../types/documents.js';
+/**
+ * Template engine for document generation
+ */
+export declare class TemplateEngine {
+    private static instance;
+    private templates;
+    private templateDirs;
+    private constructor();
+    static getInstance(): TemplateEngine;
+    /**
+     * Initialize built-in templates
+     */
+    private initializeBuiltinTemplates;
+    /**
+     * Register a new template
+     */
+    registerTemplate(template: DocumentTemplate): void;
+    /**
+     * Get template by name
+     */
+    getTemplate(name: string): DocumentTemplate | undefined;
+    /**
+     * List all available templates
+     */
+    listTemplates(): DocumentTemplate[];
+    /**
+     * Add template directory
+     */
+    addTemplateDirectory(dir: string): void;
+    /**
+     * Load templates from directory
+     */
+    loadTemplatesFromDirectory(dir: string): Promise<number>;
+    /**
+     * Check if file is a template file
+     */
+    private isTemplateFile;
+    /**
+     * Load template from file
+     */
+    private loadTemplateFile;
+    /**
+     * Get format from filename
+     */
+    private getFormatFromFilename;
+    /**
+     * Extract template metadata from content
+     */
+    private extractTemplateMetadata;
+    /**
+     * Generate document from template
+     */
+    generateDocument(templateName: string, variables?: TemplateVariables): DocumentResult;
+    /**
+     * Substitute variables in template content
+     */
+    substituteVariables(content: string, variables: TemplateVariables): string;
+    /**
+     * Format variable value for substitution
+     */
+    private formatValue;
+    /**
+     * Merge template variables with user variables
+     */
+    private mergeVariables;
+    /**
+     * Validate template content
+     */
+    validateTemplate(template: DocumentTemplate): {
+        valid: boolean;
+        errors: string[];
+    };
+    /**
+     * Extract placeholder names from template content
+     */
+    extractPlaceholders(content: string): string[];
+    /**
+     * Create template from document
+     */
+    createTemplateFromDocument(name: string, description: string, content: string, format: DocumentFormat, extractVariables?: boolean): DocumentTemplate;
+    /**
+     * Save template to file
+     */
+    saveTemplate(template: DocumentTemplate, outputDir: string): Promise<boolean>;
+    /**
+     * Clear all templates
+     */
+    clearTemplates(): void;
+}
+//# sourceMappingURL=template-engine.d.ts.map

package/dist/core/documents/template-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-engine.d.ts","sourceRoot":"","sources":["../../../src/core/documents/template-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EAGd,cAAc,EACf,MAAM,0BAA0B,CAAC;AAElC;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAiB;IACxC,OAAO,CAAC,SAAS,CAA4C;IAC7D,OAAO,CAAC,YAAY,CAAgB;IAEpC,OAAO;WAIO,WAAW,IAAI,cAAc;IAO3C;;OAEG;IACH,OAAO,CAAC,0BAA0B;IA4JlC;;OAEG;IACI,gBAAgB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI;IAIzD;;OAEG;IACI,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAI9D;;OAEG;IACI,aAAa,IAAI,gBAAgB,EAAE;IAI1C;;OAEG;IACI,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAM9C;;OAEG;IACU,0BAA0B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA+BrE;;OAEG;IACH,OAAO,CAAC,cAAc;IAKtB;;OAEG;YACW,gBAAgB;IA6B9B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAQ7B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAW/B;;OAEG;IACI,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,iBAAiB,GAAG,cAAc;IA8B5F;;OAEG;IACI,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,iBAAiB,GAAG,MAAM;IAYjF;;OAEG;IACH,OAAO,CAAC,WAAW;IAOnB;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;OAEG;IACI,gBAAgB,CAAC,QAAQ,EAAE,gBAAgB,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;IA+BzF;;OAEG;IACI,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE;IAerD;;OAEG;IACI,0BAA0B,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,gBAAgB,GAAE,OAAc,GAAG,gBAAgB;IAoBjK;;OAEG;IACU,YAAY,CAAC,QAAQ,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAe1F;;OAEG;IACI,cAAc,IAAI,IAAI;CAI9B"}