@esthernandez/vibe-doc 0.1.0

package/dist/versioning/index.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Version Tracking and History Management
+ * Handles archiving and tracking documentation versions
+ */
+import { VibedocState, HistoryEntry } from '../state/schema';
+/**
+ * Archive the current version of a generated doc
+ * Moves it to docs/generated/.history/<docType>-v<N>-<date>.md
+ * @param projectPath - Root path of the project
+ * @param docType - Type of document to archive
+ * @param state - Current vibe-doc state
+ * @returns HistoryEntry if archived, null if no current version exists
+ */
+export declare function archiveCurrentVersion(projectPath: string, docType: string, state: VibedocState): HistoryEntry | null;
+/**
+ * Get version history for a specific doc type
+ * @param state - Current vibe-doc state
+ * @param docType - Type of document
+ * @returns Array of HistoryEntry for this doc type, sorted by version descending
+ */
+export declare function getVersionHistory(state: VibedocState, docType: string): HistoryEntry[];
+/**
+ * Get the next version number for a doc type
+ * @param state - Current vibe-doc state
+ * @param docType - Type of document
+ * @returns Next version number (count + 1)
+ */
+export declare function getNextVersion(state: VibedocState, docType: string): number;
+/**
+ * Get the full path to a versioned document
+ * @param projectPath - Root path of the project
+ * @param docType - Type of document
+ * @param version - Version number (e.g., "v1", "v2")
+ * @returns Full path to the versioned document, or null if not found
+ */
+export declare function getVersionedPath(projectPath: string, docType: string, version: string): string | null;
+/**
+ * List all available versions for a doc type on disk
+ * @param projectPath - Root path of the project
+ * @param docType - Type of document
+ * @returns Array of version strings (e.g., ["v2", "v1"])
+ */
+export declare function listAvailableVersions(projectPath: string, docType: string): string[];
+//# sourceMappingURL=index.d.ts.map

package/dist/versioning/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/versioning/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAI7D;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,YAAY,GAClB,YAAY,GAAG,IAAI,CAoCrB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,MAAM,GACd,YAAY,EAAE,CAShB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAQ3E;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,MAAM,GAAG,IAAI,CAgBf;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CA0BpF"}

package/dist/versioning/index.js

@@ -0,0 +1,165 @@
+"use strict";
+/**
+ * Version Tracking and History Management
+ * Handles archiving and tracking documentation versions
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.archiveCurrentVersion = archiveCurrentVersion;
+exports.getVersionHistory = getVersionHistory;
+exports.getNextVersion = getNextVersion;
+exports.getVersionedPath = getVersionedPath;
+exports.listAvailableVersions = listAvailableVersions;
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const HISTORY_DIR = '.history';
+/**
+ * Archive the current version of a generated doc
+ * Moves it to docs/generated/.history/<docType>-v<N>-<date>.md
+ * @param projectPath - Root path of the project
+ * @param docType - Type of document to archive
+ * @param state - Current vibe-doc state
+ * @returns HistoryEntry if archived, null if no current version exists
+ */
+function archiveCurrentVersion(projectPath, docType, state) {
+    const docsDir = path.join(projectPath, 'docs', 'generated');
+    const currentPath = path.join(docsDir, `${docType}.md`);
+    // Check if current version exists
+    if (!fs.existsSync(currentPath)) {
+        return null;
+    }
+    // Create .history directory if needed
+    const historyDir = path.join(docsDir, HISTORY_DIR);
+    if (!fs.existsSync(historyDir)) {
+        fs.mkdirSync(historyDir, { recursive: true });
+    }
+    // Get next version number
+    const nextVersion = getNextVersion(state, docType);
+    // Generate archive filename
+    const now = new Date();
+    const dateStr = now.toISOString().split('T')[0]; // YYYY-MM-DD
+    const archiveFilename = `${docType}-v${nextVersion}-${dateStr}.md`;
+    const archivePath = path.join(historyDir, archiveFilename);
+    // Move current to archive
+    fs.renameSync(currentPath, archivePath);
+    // Create history entry
+    const historyEntry = {
+        docType,
+        version: `v${nextVersion}`,
+        generatedAt: new Date().toISOString(),
+        path: path.relative(projectPath, archivePath),
+    };
+    return historyEntry;
+}
+/**
+ * Get version history for a specific doc type
+ * @param state - Current vibe-doc state
+ * @param docType - Type of document
+ * @returns Array of HistoryEntry for this doc type, sorted by version descending
+ */
+function getVersionHistory(state, docType) {
+    return state.history
+        .filter((entry) => entry.docType === docType)
+        .sort((a, b) => {
+        // Extract version numbers: "v1", "v2", etc.
+        const aNum = parseInt(a.version.replace('v', ''), 10);
+        const bNum = parseInt(b.version.replace('v', ''), 10);
+        return bNum - aNum; // Descending
+    });
+}
+/**
+ * Get the next version number for a doc type
+ * @param state - Current vibe-doc state
+ * @param docType - Type of document
+ * @returns Next version number (count + 1)
+ */
+function getNextVersion(state, docType) {
+    const history = getVersionHistory(state, docType);
+    if (history.length === 0) {
+        return 1;
+    }
+    // Extract the highest version number and increment
+    const highestVersion = parseInt(history[0].version.replace('v', ''), 10);
+    return highestVersion + 1;
+}
+/**
+ * Get the full path to a versioned document
+ * @param projectPath - Root path of the project
+ * @param docType - Type of document
+ * @param version - Version number (e.g., "v1", "v2")
+ * @returns Full path to the versioned document, or null if not found
+ */
+function getVersionedPath(projectPath, docType, version) {
+    const historyDir = path.join(projectPath, 'docs', 'generated', HISTORY_DIR);
+    if (!fs.existsSync(historyDir)) {
+        return null;
+    }
+    // Look for files matching pattern: <docType>-<version>-*.md
+    const files = fs.readdirSync(historyDir);
+    const versionedFile = files.find((f) => f.startsWith(`${docType}-${version}-`) && f.endsWith('.md'));
+    if (!versionedFile) {
+        return null;
+    }
+    return path.join(historyDir, versionedFile);
+}
+/**
+ * List all available versions for a doc type on disk
+ * @param projectPath - Root path of the project
+ * @param docType - Type of document
+ * @returns Array of version strings (e.g., ["v2", "v1"])
+ */
+function listAvailableVersions(projectPath, docType) {
+    const historyDir = path.join(projectPath, 'docs', 'generated', HISTORY_DIR);
+    if (!fs.existsSync(historyDir)) {
+        return [];
+    }
+    const files = fs.readdirSync(historyDir);
+    const versions = new Set();
+    for (const file of files) {
+        if (file.startsWith(`${docType}-v`) && file.endsWith('.md')) {
+            // Extract version from filename: <docType>-v<N>-<date>.md
+            const match = file.match(new RegExp(`^${docType}-(v\\d+)-`));
+            if (match) {
+                versions.add(match[1]);
+            }
+        }
+    }
+    // Sort descending
+    return Array.from(versions).sort((a, b) => {
+        const aNum = parseInt(a.replace('v', ''), 10);
+        const bNum = parseInt(b.replace('v', ''), 10);
+        return bNum - aNum;
+    });
+}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@esthernandez/vibe-doc",
+  "version": "0.1.0",
+  "description": "Vibe Doc CLI - Command-line interface for documentation generation",
+  "author": "Estevan Hernandez / 626Labs",
+  "license": "MIT",
+  "bin": {
+    "vibe-doc": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc && npm run build:copy-templates",
+    "build:copy-templates": "node scripts/copy-templates.js",
+    "dev": "tsx watch src/index.ts",
+    "start": "node dist/index.js",
+    "type-check": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "commander": "^11.1.0",
+    "simple-git": "^3.22.0",
+    "fast-glob": "^3.3.2",
+    "docx": "^8.5.0",
+    "diff": "^5.1.0",
+    "marked": "^11.1.1"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.3",
+    "tsx": "^4.7.0",
+    "@types/node": "^20.10.6",
+    "@types/diff": "^5.0.9"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}