@theglitchking/hit-em-with-the-docs 2.0.0

package/dist/utils/logger.js

@@ -0,0 +1,118 @@
+import chalk from 'chalk';
+class Logger {
+    silent = false;
+    verbose = false;
+    prefix = '';
+    configure(options) {
+        if (options.silent !== undefined)
+            this.silent = options.silent;
+        if (options.verbose !== undefined)
+            this.verbose = options.verbose;
+        if (options.prefix !== undefined)
+            this.prefix = options.prefix;
+    }
+    formatMessage(message) {
+        return this.prefix ? `${this.prefix} ${message}` : message;
+    }
+    debug(message, ...args) {
+        if (this.silent || !this.verbose)
+            return;
+        console.log(chalk.gray(`[DEBUG] ${this.formatMessage(message)}`), ...args);
+    }
+    info(message, ...args) {
+        if (this.silent)
+            return;
+        console.log(chalk.blue('ℹ'), this.formatMessage(message), ...args);
+    }
+    success(message, ...args) {
+        if (this.silent)
+            return;
+        console.log(chalk.green('✓'), this.formatMessage(message), ...args);
+    }
+    warn(message, ...args) {
+        if (this.silent)
+            return;
+        console.log(chalk.yellow('⚠'), this.formatMessage(message), ...args);
+    }
+    error(message, ...args) {
+        console.error(chalk.red('✗'), this.formatMessage(message), ...args);
+    }
+    // Styled output helpers
+    header(title) {
+        if (this.silent)
+            return;
+        console.log();
+        console.log(chalk.bold.cyan(`━━━ ${title} ━━━`));
+        console.log();
+    }
+    subheader(title) {
+        if (this.silent)
+            return;
+        console.log();
+        console.log(chalk.bold(title));
+    }
+    list(items, indent = 0) {
+        if (this.silent)
+            return;
+        const prefix = '  '.repeat(indent);
+        items.forEach((item) => {
+            console.log(`${prefix}• ${item}`);
+        });
+    }
+    table(headers, rows) {
+        if (this.silent)
+            return;
+        const colWidths = headers.map((h, i) => Math.max(h.length, ...rows.map((r) => (r[i] ?? '').length)));
+        const separator = colWidths.map((w) => '─'.repeat(w + 2)).join('┼');
+        const headerRow = headers
+            .map((h, i) => ` ${h.padEnd(colWidths[i] ?? 0)} `)
+            .join('│');
+        console.log(chalk.gray(`┌${separator.replace(/┼/g, '┬')}┐`));
+        console.log(chalk.bold(`│${headerRow}│`));
+        console.log(chalk.gray(`├${separator}┤`));
+        rows.forEach((row) => {
+            const rowStr = row
+                .map((cell, i) => ` ${(cell ?? '').padEnd(colWidths[i] ?? 0)} `)
+                .join('│');
+            console.log(`│${rowStr}│`);
+        });
+        console.log(chalk.gray(`└${separator.replace(/┼/g, '┴')}┘`));
+    }
+    progress(current, total, label) {
+        if (this.silent)
+            return;
+        const percentage = Math.round((current / total) * 100);
+        const barWidth = 30;
+        const filled = Math.round((current / total) * barWidth);
+        const empty = barWidth - filled;
+        const bar = chalk.green('█'.repeat(filled)) + chalk.gray('░'.repeat(empty));
+        const labelStr = label ? ` ${label}` : '';
+        process.stdout.write(`\r${bar} ${percentage}%${labelStr}`);
+        if (current === total)
+            console.log();
+    }
+    newline() {
+        if (this.silent)
+            return;
+        console.log();
+    }
+    // Emoji helpers
+    emoji = {
+        docs: '📚',
+        check: '✅',
+        cross: '❌',
+        warn: '⚠️',
+        info: 'ℹ️',
+        search: '🔍',
+        stats: '📊',
+        fix: '🔧',
+        link: '🔗',
+        folder: '📁',
+        file: '📄',
+        clock: '⏱️',
+        sparkles: '✨',
+    };
+}
+export const logger = new Logger();
+export default logger;
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

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

package/dist/utils/markdown.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Markdown utilities for parsing and generating markdown content
+ */
+export interface MarkdownLink {
+    text: string;
+    url: string;
+    title?: string;
+    isInternal: boolean;
+    lineNumber: number;
+    startIndex: number;
+    endIndex: number;
+}
+export interface MarkdownHeading {
+    level: number;
+    text: string;
+    lineNumber: number;
+}
+/**
+ * Extract all links from markdown content
+ */
+export declare function extractLinks(content: string): MarkdownLink[];
+/**
+ * Extract only internal links
+ */
+export declare function extractInternalLinks(content: string): MarkdownLink[];
+/**
+ * Extract all headings from markdown content
+ */
+export declare function extractHeadings(content: string): MarkdownHeading[];
+/**
+ * Get the title (first h1) from markdown content
+ */
+export declare function extractTitle(content: string): string | null;
+/**
+ * Count words in markdown content (excluding code blocks and frontmatter)
+ */
+export declare function countWords(content: string): number;
+/**
+ * Calculate estimated read time in minutes
+ */
+export declare function calculateReadTime(content: string, wordsPerMinute?: number): number;
+/**
+ * Format read time as string
+ */
+export declare function formatReadTime(content: string): string;
+/**
+ * Generate a markdown link
+ */
+export declare function createLink(text: string, url: string, title?: string): string;
+/**
+ * Generate a markdown heading
+ */
+export declare function createHeading(text: string, level?: number): string;
+/**
+ * Generate a markdown table
+ */
+export declare function createTable(headers: string[], rows: string[][]): string;
+/**
+ * Generate a markdown list
+ */
+export declare function createList(items: string[], ordered?: boolean): string;
+/**
+ * Generate a markdown checkbox list
+ */
+export declare function createCheckboxList(items: {
+    text: string;
+    checked: boolean;
+}[]): string;
+/**
+ * Wrap text in a code block
+ */
+export declare function createCodeBlock(code: string, language?: string): string;
+/**
+ * Create an inline code span
+ */
+export declare function createInlineCode(code: string): string;
+/**
+ * Create a blockquote
+ */
+export declare function createBlockquote(text: string): string;
+/**
+ * Slugify text for use in URLs/anchors
+ */
+export declare function slugify(text: string): string;
+/**
+ * Extract first paragraph as excerpt
+ */
+export declare function extractExcerpt(content: string, maxLength?: number): string;
+//# sourceMappingURL=markdown.d.ts.map

package/dist/utils/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/utils/markdown.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,EAAE,CAmC5D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,EAAE,CAEpE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,EAAE,CAmBlE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAI3D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAclD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,GAAE,MAAY,GAAG,MAAM,CAGvF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGtD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAK5E;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,MAAM,CAGrE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,CAMvE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,OAAe,GAAG,MAAM,CAI5E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,EAAE,GAC1C,MAAM,CAIR;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAW,GAAG,MAAM,CAE3E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKrD;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAO5C;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,GAAE,MAAY,GAAG,MAAM,CAiB/E"}

package/dist/utils/markdown.js

@@ -0,0 +1,192 @@
+/**
+ * Markdown utilities for parsing and generating markdown content
+ */
+/**
+ * Extract all links from markdown content
+ */
+export function extractLinks(content) {
+    const links = [];
+    const lines = content.split('\n');
+    // Match markdown links: [text](url) or [text](url "title")
+    const linkRegex = /\[([^\]]*)\]\(([^)\s]+)(?:\s+"([^"]*)")?\)/g;
+    lines.forEach((line, lineIndex) => {
+        let match;
+        while ((match = linkRegex.exec(line)) !== null) {
+            const [fullMatch, text, url, title] = match;
+            const urlStr = url ?? '';
+            const isInternal = !urlStr.startsWith('http://') &&
+                !urlStr.startsWith('https://') &&
+                !urlStr.startsWith('mailto:') &&
+                !urlStr.startsWith('#');
+            const link = {
+                text: text ?? '',
+                url: urlStr,
+                isInternal,
+                lineNumber: lineIndex + 1,
+                startIndex: match.index,
+                endIndex: match.index + (fullMatch?.length ?? 0),
+            };
+            if (title) {
+                link.title = title;
+            }
+            links.push(link);
+        }
+        // Reset regex lastIndex for next line
+        linkRegex.lastIndex = 0;
+    });
+    return links;
+}
+/**
+ * Extract only internal links
+ */
+export function extractInternalLinks(content) {
+    return extractLinks(content).filter((link) => link.isInternal);
+}
+/**
+ * Extract all headings from markdown content
+ */
+export function extractHeadings(content) {
+    const headings = [];
+    const lines = content.split('\n');
+    // Match ATX headings: # Heading
+    const headingRegex = /^(#{1,6})\s+(.+)$/;
+    lines.forEach((line, lineIndex) => {
+        const match = line.match(headingRegex);
+        if (match) {
+            headings.push({
+                level: match[1]?.length ?? 1,
+                text: (match[2] ?? '').trim(),
+                lineNumber: lineIndex + 1,
+            });
+        }
+    });
+    return headings;
+}
+/**
+ * Get the title (first h1) from markdown content
+ */
+export function extractTitle(content) {
+    const headings = extractHeadings(content);
+    const h1 = headings.find((h) => h.level === 1);
+    return h1?.text ?? null;
+}
+/**
+ * Count words in markdown content (excluding code blocks and frontmatter)
+ */
+export function countWords(content) {
+    // Remove frontmatter
+    let text = content.replace(/^---[\s\S]*?---\n*/m, '');
+    // Remove code blocks
+    text = text.replace(/```[\s\S]*?```/g, '');
+    text = text.replace(/`[^`]+`/g, '');
+    // Remove markdown syntax
+    text = text.replace(/[#*_~\[\]()]/g, ' ');
+    // Count words
+    const words = text.split(/\s+/).filter((word) => word.length > 0);
+    return words.length;
+}
+/**
+ * Calculate estimated read time in minutes
+ */
+export function calculateReadTime(content, wordsPerMinute = 200) {
+    const wordCount = countWords(content);
+    return Math.ceil(wordCount / wordsPerMinute);
+}
+/**
+ * Format read time as string
+ */
+export function formatReadTime(content) {
+    const minutes = calculateReadTime(content);
+    return `${minutes} minute${minutes === 1 ? '' : 's'}`;
+}
+/**
+ * Generate a markdown link
+ */
+export function createLink(text, url, title) {
+    if (title) {
+        return `[${text}](${url} "${title}")`;
+    }
+    return `[${text}](${url})`;
+}
+/**
+ * Generate a markdown heading
+ */
+export function createHeading(text, level = 1) {
+    const hashes = '#'.repeat(Math.min(Math.max(level, 1), 6));
+    return `${hashes} ${text}`;
+}
+/**
+ * Generate a markdown table
+ */
+export function createTable(headers, rows) {
+    const headerRow = `| ${headers.join(' | ')} |`;
+    const separatorRow = `| ${headers.map(() => '---').join(' | ')} |`;
+    const dataRows = rows.map((row) => `| ${row.join(' | ')} |`);
+    return [headerRow, separatorRow, ...dataRows].join('\n');
+}
+/**
+ * Generate a markdown list
+ */
+export function createList(items, ordered = false) {
+    return items
+        .map((item, index) => (ordered ? `${index + 1}. ${item}` : `- ${item}`))
+        .join('\n');
+}
+/**
+ * Generate a markdown checkbox list
+ */
+export function createCheckboxList(items) {
+    return items
+        .map((item) => `- [${item.checked ? 'x' : ' '}] ${item.text}`)
+        .join('\n');
+}
+/**
+ * Wrap text in a code block
+ */
+export function createCodeBlock(code, language = '') {
+    return `\`\`\`${language}\n${code}\n\`\`\``;
+}
+/**
+ * Create an inline code span
+ */
+export function createInlineCode(code) {
+    return `\`${code}\``;
+}
+/**
+ * Create a blockquote
+ */
+export function createBlockquote(text) {
+    return text
+        .split('\n')
+        .map((line) => `> ${line}`)
+        .join('\n');
+}
+/**
+ * Slugify text for use in URLs/anchors
+ */
+export function slugify(text) {
+    return text
+        .toLowerCase()
+        .replace(/[^\w\s-]/g, '')
+        .replace(/\s+/g, '-')
+        .replace(/-+/g, '-')
+        .trim();
+}
+/**
+ * Extract first paragraph as excerpt
+ */
+export function extractExcerpt(content, maxLength = 200) {
+    // Remove frontmatter
+    let text = content.replace(/^---[\s\S]*?---\n*/m, '');
+    // Remove headings
+    text = text.replace(/^#+\s+.*$/gm, '');
+    // Get first paragraph
+    const paragraphs = text.split(/\n\n+/).filter((p) => p.trim().length > 0);
+    const firstParagraph = paragraphs[0] ?? '';
+    // Truncate if needed
+    if (firstParagraph.length <= maxLength) {
+        return firstParagraph.trim();
+    }
+    return firstParagraph.slice(0, maxLength).trim() + '...';
+}
+//# sourceMappingURL=markdown.js.map

package/dist/utils/markdown.js.map

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

package/package.json

@@ -0,0 +1,100 @@
+{
+  "name": "@theglitchking/hit-em-with-the-docs",
+  "version": "2.0.0",
+  "description": "Self-managing documentation system with hierarchical structure, intelligent automation, pattern discovery, and agent orchestration",
+  "type": "module",
+  "main": "dist/cli/index.js",
+  "bin": {
+    "hit-em-with-the-docs": "dist/cli/index.js",
+    "hewtd": "dist/cli/index.js"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./cli": {
+      "import": "./dist/cli/index.js"
+    },
+    "./action": {
+      "import": "./dist/action/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "templates",
+    ".claude-plugin",
+    "action.yml",
+    "README.md",
+    "LICENSE",
+    "MIGRATION.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "build:action": "ncc build src/action/index.ts -o dist/action --minify",
+    "build:all": "npm run build && npm run build:action",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint src --ext .ts",
+    "lint:fix": "eslint src --ext .ts --fix",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build:all && npm run test && bash scripts/validate-version.sh",
+    "cli": "node dist/cli/index.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "documentation",
+    "github-action",
+    "docs",
+    "markdown",
+    "automation",
+    "cli",
+    "hierarchical",
+    "metadata",
+    "pattern-discovery",
+    "code-quality",
+    "self-managing",
+    "dsmp"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/TheGlitchKing/hit-em-with-the-docs.git"
+  },
+  "bugs": {
+    "url": "https://github.com/TheGlitchKing/hit-em-with-the-docs/issues"
+  },
+  "homepage": "https://github.com/TheGlitchKing/hit-em-with-the-docs#readme",
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "fast-levenshtein": "^3.0.0",
+    "glob": "^10.4.5",
+    "gray-matter": "^4.0.3",
+    "yaml": "^2.6.1",
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "@actions/core": "^1.11.1",
+    "@actions/github": "^6.0.0",
+    "@types/fast-levenshtein": "^0.0.4",
+    "@types/node": "^20.17.12",
+    "@typescript-eslint/eslint-plugin": "^7.18.0",
+    "@typescript-eslint/parser": "^7.18.0",
+    "@vercel/ncc": "^0.38.3",
+    "@vitest/coverage-v8": "^2.1.8",
+    "eslint": "^8.57.1",
+    "prettier": "^3.4.2",
+    "typescript": "^5.7.3",
+    "vitest": "^2.1.8"
+  }
+}