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

package/action.yml

@@ -0,0 +1,56 @@
+name: 'Hit Em With The Docs'
+description: 'Self-managing documentation system with hierarchical structure, intelligent automation, and pattern discovery'
+author: 'hit-em-with-the-docs'
+
+branding:
+  icon: 'book-open'
+  color: 'blue'
+
+inputs:
+  command:
+    description: 'Command to run: init, maintain, audit, link-check, metadata-sync, integrate, discover'
+    required: true
+    default: 'maintain'
+  mode:
+    description: 'Execution mode: quick (skip link check), full (all checks), fix (auto-fix issues)'
+    required: false
+    default: 'quick'
+  docs-path:
+    description: 'Path to documentation directory'
+    required: false
+    default: '.documentation'
+  domain:
+    description: 'Specific domain to operate on (optional, applies to audit, link-check)'
+    required: false
+  discover-type:
+    description: 'Discovery type: patterns, anti-patterns, standards, dependencies'
+    required: false
+    default: 'patterns'
+  fail-on-error:
+    description: 'Fail the workflow if critical errors are found'
+    required: false
+    default: 'false'
+  fail-threshold:
+    description: 'Health score threshold below which to fail (0-100)'
+    required: false
+    default: '50'
+
+outputs:
+  health-score:
+    description: 'Documentation health score (0-100)'
+  total-documents:
+    description: 'Total number of documentation files'
+  issues-found:
+    description: 'Number of issues found'
+  issues-fixed:
+    description: 'Number of issues auto-fixed (when mode=fix)'
+  broken-links:
+    description: 'Number of broken links detected'
+  metadata-compliance:
+    description: 'Percentage of documents with complete metadata'
+  report-path:
+    description: 'Path to the generated report file'
+
+runs:
+  using: 'node20'
+  main: 'dist/action/index.js'

package/dist/action/action/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["file:///mnt/e/docker-containers/hit-em-with-the-docs/src/action/index.ts"],"names":[],"mappings":""}

package/dist/action/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/action/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["file:///mnt/e/docker-containers/hit-em-with-the-docs/src/cli/index.ts"],"names":[],"mappings":""}

package/dist/action/core/audit/auditor.d.ts

@@ -0,0 +1,43 @@
+export interface AuditOptions {
+    docsPath: string;
+    domain?: string;
+    issuesOnly?: boolean;
+    silent?: boolean;
+}
+export interface AuditResult {
+    totalFiles: number;
+    passedFiles: number;
+    failedFiles: number;
+    issues: AuditIssue[];
+    stats: AuditStats;
+    healthScore: number;
+}
+export interface AuditIssue {
+    file: string;
+    rule: string;
+    severity: 'error' | 'warning' | 'info';
+    message: string;
+    fixable: boolean;
+    suggestion?: string;
+}
+export interface AuditStats {
+    metadataCompliance: number;
+    namingCompliance: number;
+    placementCompliance: number;
+    tagConsistency: number;
+    byDomain: Record<string, DomainAuditStats>;
+}
+export interface DomainAuditStats {
+    files: number;
+    issues: number;
+    healthScore: number;
+}
+/**
+ * Audit documentation for compliance and issues
+ */
+export declare function auditDocumentation(options: AuditOptions): Promise<AuditResult>;
+/**
+ * Get audit summary for a domain
+ */
+export declare function getAuditSummaryForDomain(docsPath: string, domain: string): Promise<DomainAuditStats>;
+//# sourceMappingURL=auditor.d.ts.map

package/dist/action/core/audit/auditor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auditor.d.ts","sourceRoot":"","sources":["file:///mnt/e/docker-containers/hit-em-with-the-docs/src/core/audit/auditor.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,KAAK,EAAE,UAAU,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CA4IpF;AA+ID;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,gBAAgB,CAAC,CAQ3B"}

package/dist/action/core/audit/rules.d.ts

@@ -0,0 +1,37 @@
+export interface AuditRule {
+    id: string;
+    name: string;
+    description: string;
+    severity: 'error' | 'warning' | 'info';
+    check: (filePath: string, docsPath: string) => RuleCheckResult;
+}
+export interface RuleCheckResult {
+    valid: boolean;
+    message?: string;
+    suggestion?: string;
+}
+/**
+ * Check if file name follows naming convention (kebab-case)
+ */
+export declare function checkNamingConvention(filePath: string): RuleCheckResult;
+/**
+ * Check if file is in the correct domain folder
+ */
+export declare function checkFilePlacement(filePath: string, docsPath: string, declaredDomain?: string): RuleCheckResult;
+/**
+ * Check file size is within acceptable range
+ */
+export declare function checkFileSize(_filePath: string, fileSize: number, tier?: string): RuleCheckResult;
+/**
+ * Check for required sections based on tier
+ */
+export declare function checkRequiredSections(content: string, tier?: string): RuleCheckResult;
+/**
+ * Check for broken relative links within content
+ */
+export declare function checkRelativeLinks(content: string, _filePath: string): RuleCheckResult;
+/**
+ * All built-in audit rules
+ */
+export declare const AUDIT_RULES: AuditRule[];
+//# sourceMappingURL=rules.d.ts.map

package/dist/action/core/audit/rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["file:///mnt/e/docker-containers/hit-em-with-the-docs/src/core/audit/rules.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IACvC,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,eAAe,CAAC;CAChE;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,CA+CvE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,cAAc,CAAC,EAAE,MAAM,GACtB,eAAe,CAkDjB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,MAAM,GACZ,eAAe,CA+BjB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,MAAM,GACZ,eAAe,CAuCjB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,eAAe,CAqCjB;AASD;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,SAAS,EAelC,CAAC"}

package/dist/action/core/discover/antipatterns.d.ts

@@ -0,0 +1,24 @@
+export interface AntiPatternDiscoveryOptions {
+    rootPath: string;
+    silent?: boolean;
+}
+export interface DiscoveredAntiPattern {
+    name: string;
+    severity: 'high' | 'medium' | 'low';
+    type: AntiPatternType;
+    description: string;
+    locations: AntiPatternLocation[];
+    recommendation: string;
+}
+export interface AntiPatternLocation {
+    file: string;
+    line: number;
+    code: string;
+    context?: string;
+}
+export type AntiPatternType = 'hardcoded-credentials' | 'sql-injection' | 'missing-error-handling' | 'code-duplication' | 'god-object' | 'long-function' | 'magic-numbers' | 'missing-types' | 'console-log' | 'any-type' | 'unused-import' | 'deprecated-api';
+/**
+ * Discover anti-patterns in codebase
+ */
+export declare function discoverAntiPatterns(options: AntiPatternDiscoveryOptions): Promise<DiscoveredAntiPattern[]>;
+//# sourceMappingURL=antipatterns.d.ts.map

package/dist/action/core/discover/antipatterns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"antipatterns.d.ts","sourceRoot":"","sources":["file:///mnt/e/docker-containers/hit-em-with-the-docs/src/core/discover/antipatterns.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACpC,IAAI,EAAE,eAAe,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,mBAAmB,EAAE,CAAC;IACjC,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,eAAe,GACvB,uBAAuB,GACvB,eAAe,GACf,wBAAwB,GACxB,kBAAkB,GAClB,YAAY,GACZ,eAAe,GACf,eAAe,GACf,eAAe,GACf,aAAa,GACb,UAAU,GACV,eAAe,GACf,gBAAgB,CAAC;AAgIrB;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,qBAAqB,EAAE,CAAC,CA2ElC"}

package/dist/action/core/discover/dependencies.d.ts

@@ -0,0 +1,57 @@
+export interface DependencyAnalysisOptions {
+    rootPath: string;
+    silent?: boolean;
+}
+export interface DependencyAnalysis {
+    packages: PackageAnalysis;
+    modules: ModuleAnalysis;
+    security: SecurityAnalysis;
+    unused: UnusedDependency[];
+}
+export interface PackageAnalysis {
+    total: number;
+    production: number;
+    development: number;
+    dependencies: PackageInfo[];
+    devDependencies: PackageInfo[];
+}
+export interface PackageInfo {
+    name: string;
+    version: string;
+    type: 'production' | 'development';
+    outdated?: boolean;
+    latestVersion?: string;
+}
+export interface ModuleAnalysis {
+    totalFiles: number;
+    imports: number;
+    circularDependencies: CircularDependency[];
+    highCoupling: HighCouplingModule[];
+}
+export interface CircularDependency {
+    files: string[];
+}
+export interface HighCouplingModule {
+    file: string;
+    imports: number;
+    importedBy: number;
+}
+export interface SecurityAnalysis {
+    vulnerabilities: SecurityVulnerability[];
+}
+export interface SecurityVulnerability {
+    package: string;
+    severity: 'low' | 'moderate' | 'high' | 'critical';
+    title: string;
+    recommendation: string;
+}
+export interface UnusedDependency {
+    name: string;
+    type: 'production' | 'development';
+    reason: string;
+}
+/**
+ * Analyze project dependencies
+ */
+export declare function analyzeDependencies(options: DependencyAnalysisOptions): Promise<DependencyAnalysis>;
+//# sourceMappingURL=dependencies.d.ts.map

package/dist/action/core/discover/dependencies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependencies.d.ts","sourceRoot":"","sources":["file:///mnt/e/docker-containers/hit-em-with-the-docs/src/core/discover/dependencies.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,eAAe,CAAC;IAC1B,OAAO,EAAE,cAAc,CAAC;IACxB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,MAAM,EAAE,gBAAgB,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,eAAe,EAAE,WAAW,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,YAAY,GAAG,aAAa,CAAC;IACnC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB,EAAE,kBAAkB,EAAE,CAAC;IAC3C,YAAY,EAAE,kBAAkB,EAAE,CAAC;CACpC;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,eAAe,EAAE,qBAAqB,EAAE,CAAC;CAC1C;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,KAAK,GAAG,UAAU,GAAG,MAAM,GAAG,UAAU,CAAC;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,YAAY,GAAG,aAAa,CAAC;IACnC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,kBAAkB,CAAC,CAyC7B"}

package/dist/action/core/discover/patterns.d.ts

@@ -0,0 +1,38 @@
+export interface PatternDiscoveryOptions {
+    rootPath: string;
+    language?: string;
+    category?: string;
+    silent?: boolean;
+}
+export interface DiscoveredPattern {
+    name: string;
+    category: PatternCategory;
+    description: string;
+    occurrences: number;
+    examples: PatternExample[];
+    suggestedDocumentation?: string;
+}
+export interface PatternExample {
+    file: string;
+    line: number;
+    code: string;
+    context?: string;
+}
+export type PatternCategory = 'architecture' | 'data-access' | 'error-handling' | 'security' | 'testing' | 'api' | 'state-management' | 'utility';
+export interface PatternDefinition {
+    name: string;
+    category: PatternCategory;
+    description: string;
+    patterns: RegExp[];
+    filePatterns?: string[];
+    languages?: string[];
+}
+/**
+ * Discover patterns in codebase
+ */
+export declare function discoverPatterns(options: PatternDiscoveryOptions): Promise<DiscoveredPattern[]>;
+/**
+ * Generate documentation suggestion for a pattern
+ */
+export declare function generatePatternDocumentation(pattern: DiscoveredPattern): string;
+//# sourceMappingURL=patterns.d.ts.map

package/dist/action/core/discover/patterns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patterns.d.ts","sourceRoot":"","sources":["file:///mnt/e/docker-containers/hit-em-with-the-docs/src/core/discover/patterns.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,eAAe,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,eAAe,GACvB,cAAc,GACd,aAAa,GACb,gBAAgB,GAChB,UAAU,GACV,SAAS,GACT,KAAK,GACL,kBAAkB,GAClB,SAAS,CAAC;AAEd,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,eAAe,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAsND;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAoE9B;AA0FD;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAkC/E"}

package/dist/action/core/discover/standards.d.ts

@@ -0,0 +1,58 @@
+export interface StandardsDiscoveryOptions {
+    rootPath: string;
+    silent?: boolean;
+}
+export interface DiscoveredStandards {
+    naming: NamingStandards;
+    fileOrganization: FileOrganizationStandards;
+    codeStyle: CodeStyleStandards;
+    documentation: DocumentationStandards;
+    testing: TestingStandards;
+}
+export interface NamingStandards {
+    functions: ConventionCompliance;
+    classes: ConventionCompliance;
+    constants: ConventionCompliance;
+    variables: ConventionCompliance;
+    files: ConventionCompliance;
+}
+export interface ConventionCompliance {
+    convention: string;
+    compliance: number;
+    examples: {
+        name: string;
+        file: string;
+        compliant: boolean;
+    }[];
+}
+export interface FileOrganizationStandards {
+    patterns: {
+        pattern: string;
+        files: number;
+        examples: string[];
+    }[];
+    rootFolders: string[];
+}
+export interface CodeStyleStandards {
+    maxLineLength: number;
+    indentation: 'spaces' | 'tabs' | 'mixed';
+    indentSize?: number;
+    semicolons: 'always' | 'never' | 'mixed';
+    quotes: 'single' | 'double' | 'mixed';
+    trailingCommas: 'always' | 'never' | 'mixed';
+}
+export interface DocumentationStandards {
+    docstringStyle: string;
+    coverage: number;
+    typeHintCoverage: number;
+}
+export interface TestingStandards {
+    pattern: string;
+    coverage?: number;
+    fixturePattern?: string;
+}
+/**
+ * Discover implicit standards from codebase
+ */
+export declare function discoverStandards(options: StandardsDiscoveryOptions): Promise<DiscoveredStandards>;
+//# sourceMappingURL=standards.d.ts.map

package/dist/action/core/discover/standards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standards.d.ts","sourceRoot":"","sources":["file:///mnt/e/docker-containers/hit-em-with-the-docs/src/core/discover/standards.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,eAAe,CAAC;IACxB,gBAAgB,EAAE,yBAAyB,CAAC;IAC5C,SAAS,EAAE,kBAAkB,CAAC;IAC9B,aAAa,EAAE,sBAAsB,CAAC;IACtC,OAAO,EAAE,gBAAgB,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,oBAAoB,CAAC;IAChC,OAAO,EAAE,oBAAoB,CAAC;IAC9B,SAAS,EAAE,oBAAoB,CAAC;IAChC,SAAS,EAAE,oBAAoB,CAAC;IAChC,KAAK,EAAE,oBAAoB,CAAC;CAC7B;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,EAAE,CAAC;CAChE;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,CAAC;IACnE,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAC;IACzC,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;IACtC,cAAc,EAAE,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAC;CAC9C;AAED,MAAM,WAAW,sBAAsB;IACrC,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,mBAAmB,CAAC,CAoD9B"}

package/dist/action/core/domains/classifier.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Document tier classification system.
+ * Classifies documents into 5 tiers based on content structure.
+ */
+export declare const TIERS: readonly ["guide", "standard", "example", "reference", "admin"];
+export type Tier = (typeof TIERS)[number];
+export interface TierDefinition {
+    id: Tier;
+    name: string;
+    description: string;
+    sizeRange: {
+        min: number;
+        max: number;
+    };
+    indicators: string[];
+    headingPatterns: RegExp[];
+}
+export declare const TIER_DEFINITIONS: Record<Tier, TierDefinition>;
+export interface TierClassificationResult {
+    tier: Tier;
+    confidence: number;
+    scores: Record<Tier, number>;
+    reasoning: string[];
+}
+/**
+ * Classify document content into a tier
+ */
+export declare function classifyTier(content: string): TierClassificationResult;
+/**
+ * Get tier definition by ID
+ */
+export declare function getTierDefinition(tier: Tier): TierDefinition;
+/**
+ * Check if a string is a valid tier
+ */
+export declare function isValidTier(value: string): value is Tier;
+/**
+ * Get tier display name
+ */
+export declare function getTierDisplayName(tier: Tier): string;
+//# sourceMappingURL=classifier.d.ts.map

package/dist/action/core/domains/classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classifier.d.ts","sourceRoot":"","sources":["file:///mnt/e/docker-containers/hit-em-with-the-docs/src/core/domains/classifier.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,KAAK,iEAAkE,CAAC;AACrF,MAAM,MAAM,IAAI,GAAG,CAAC,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1C,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,IAAI,CAAC;IACT,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IACxC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,IAAI,EAAE,cAAc,CAgFzD,CAAC;AAEF,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,IAAI,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC7B,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,wBAAwB,CA+GtE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,cAAc,CAE5D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,IAAI,CAExD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAErD"}

package/dist/action/core/domains/constants.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Domain definitions for the hierarchical documentation system.
+ * The system organizes documentation into 15 specialized domains.
+ */
+export declare const DOMAINS: readonly ["agents", "api", "architecture", "backups", "database", "devops", "features", "plans", "procedures", "quickstart", "security", "standards", "testing", "troubleshooting", "workflows"];
+export type Domain = (typeof DOMAINS)[number];
+export interface DomainDefinition {
+    id: Domain;
+    name: string;
+    description: string;
+    keywords: string[];
+    loadPriority: number;
+    category: 'core' | 'development' | 'features' | 'advanced';
+}
+export declare const DOMAIN_DEFINITIONS: Record<Domain, DomainDefinition>;
+/**
+ * Get domain definition by ID
+ */
+export declare function getDomainDefinition(domain: Domain): DomainDefinition;
+/**
+ * Get all domain IDs
+ */
+export declare function getAllDomains(): readonly Domain[];
+/**
+ * Get domains by category
+ */
+export declare function getDomainsByCategory(category: DomainDefinition['category']): Domain[];
+/**
+ * Get domains sorted by load priority (highest first)
+ */
+export declare function getDomainsByPriority(): Domain[];
+/**
+ * Check if a string is a valid domain
+ */
+export declare function isValidDomain(value: string): value is Domain;
+/**
+ * Get all keywords across all domains
+ */
+export declare function getAllKeywords(): Map<string, Domain[]>;
+//# sourceMappingURL=constants.d.ts.map

package/dist/action/core/domains/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["file:///mnt/e/docker-containers/hit-em-with-the-docs/src/core/domains/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,OAAO,kMAgBV,CAAC;AAEX,MAAM,MAAM,MAAM,GAAG,CAAC,OAAO,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9C,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,GAAG,aAAa,GAAG,UAAU,GAAG,UAAU,CAAC;CAC5D;AAED,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAwL/D,CAAC;AAEF;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAEpE;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,SAAS,MAAM,EAAE,CAEjD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,gBAAgB,CAAC,UAAU,CAAC,GACrC,MAAM,EAAE,CAEV;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,EAAE,CAI/C;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,MAAM,CAE5D;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAatD"}

package/dist/action/core/domains/detector.d.ts

@@ -0,0 +1,35 @@
+import { Domain } from './constants.js';
+export interface DomainDetectionResult {
+    domain: Domain | null;
+    confidence: number;
+    method: 'path' | 'content' | 'keywords' | 'none';
+    alternativeDomains: {
+        domain: Domain;
+        confidence: number;
+    }[];
+}
+/**
+ * Detect domain from file path and/or content
+ */
+export declare function detectDomain(filePath: string, content?: string, docsRoot?: string): DomainDetectionResult;
+/**
+ * Detect domain from file path
+ */
+export declare function detectDomainFromPath(filePath: string, docsRoot?: string): DomainDetectionResult;
+/**
+ * Detect domain from document content
+ */
+export declare function detectDomainFromContent(content: string): DomainDetectionResult;
+/**
+ * Get suggested domains for a file based on its name
+ */
+export declare function suggestDomainsForFile(fileName: string): Domain[];
+/**
+ * Validate that a file is in the correct domain
+ */
+export declare function validateDomainPlacement(filePath: string, docsRoot?: string): {
+    isCorrect: boolean;
+    currentDomain: Domain | null;
+    suggestedDomain: Domain | null;
+};
+//# sourceMappingURL=detector.d.ts.map

package/dist/action/core/domains/detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detector.d.ts","sourceRoot":"","sources":["file:///mnt/e/docker-containers/hit-em-with-the-docs/src/core/domains/detector.ts"],"names":[],"mappings":"AACA,OAAO,EACL,MAAM,EAKP,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;IACjD,kBAAkB,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC9D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,EAChB,QAAQ,GAAE,MAAyB,GAClC,qBAAqB,CA8BvB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,QAAQ,GAAE,MAAyB,GAClC,qBAAqB,CA8CvB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,qBAAqB,CAyD9E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAyBhE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,EAChB,QAAQ,GAAE,MAAyB,GAClC;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAWtF"}

package/dist/action/core/integrate/integrator.d.ts

@@ -0,0 +1,35 @@
+import { type PartialDocumentMetadata } from '../metadata/schema.js';
+import type { Domain } from '../domains/constants.js';
+export interface IntegrateOptions {
+    filePath: string;
+    docsPath: string;
+    auto?: boolean;
+    dryRun?: boolean;
+    force?: boolean;
+    silent?: boolean;
+}
+export interface IntegrateResult {
+    success: boolean;
+    integrated: boolean;
+    originalPath: string;
+    targetPath?: string;
+    domain?: Domain;
+    tier?: string;
+    duplicates?: DuplicateMatch[];
+    metadata?: PartialDocumentMetadata;
+    error?: string;
+}
+export interface DuplicateMatch {
+    path: string;
+    title: string;
+    similarity: number;
+}
+/**
+ * Integrate a document into the documentation system
+ */
+export declare function integrateDocument(options: IntegrateOptions): Promise<IntegrateResult>;
+/**
+ * Batch integrate multiple documents
+ */
+export declare function batchIntegrate(files: string[], options: Omit<IntegrateOptions, 'filePath'>): Promise<IntegrateResult[]>;
+//# sourceMappingURL=integrator.d.ts.map

package/dist/action/core/integrate/integrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integrator.d.ts","sourceRoot":"","sources":["file:///mnt/e/docker-containers/hit-em-with-the-docs/src/core/integrate/integrator.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAGtD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC;IAC9B,QAAQ,CAAC,EAAE,uBAAuB,CAAC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,eAAe,CAAC,CA8I1B;AA+GD;;GAEG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,MAAM,EAAE,EACf,OAAO,EAAE,IAAI,CAAC,gBAAgB,EAAE,UAAU,CAAC,GAC1C,OAAO,CAAC,eAAe,EAAE,CAAC,CAY5B"}

package/dist/action/core/links/checker.d.ts

@@ -0,0 +1,64 @@
+import type { Domain } from '../domains/constants.js';
+export { type MarkdownLink } from '../../utils/markdown.js';
+export interface LinkCheckOptions {
+    docsPath: string;
+    domain?: string;
+    checkExternal?: boolean;
+    silent?: boolean;
+}
+export interface LinkCheckResult {
+    totalFiles: number;
+    totalLinks: number;
+    validLinks: number;
+    brokenLinks: BrokenLink[];
+    crossDomainLinks: CrossDomainLink[];
+    externalLinks: ExternalLink[];
+    stats: LinkStats;
+}
+export interface BrokenLink {
+    sourceFile: string;
+    targetPath: string;
+    lineNumber: number;
+    linkText: string;
+    reason: string;
+}
+export interface CrossDomainLink {
+    sourceFile: string;
+    sourceDomain: Domain | null;
+    targetPath: string;
+    targetDomain: Domain | null;
+    linkText: string;
+}
+export interface ExternalLink {
+    sourceFile: string;
+    url: string;
+    linkText: string;
+    status?: number;
+}
+export interface LinkStats {
+    internalLinks: number;
+    externalLinks: number;
+    crossDomainLinks: number;
+    brokenPercentage: number;
+    topConnectedDomains: {
+        from: string;
+        to: string;
+        count: number;
+    }[];
+}
+/**
+ * Check all links in documentation
+ */
+export declare function checkLinks(options: LinkCheckOptions): Promise<LinkCheckResult>;
+/**
+ * Check a single link and return its status
+ */
+export declare function checkSingleLink(linkUrl: string, sourceFile: string, docsPath: string): Promise<{
+    valid: boolean;
+    reason?: string;
+}>;
+/**
+ * Get broken links for a specific file
+ */
+export declare function getFileBrokenLinks(filePath: string, docsPath: string): Promise<BrokenLink[]>;
+//# sourceMappingURL=checker.d.ts.map

package/dist/action/core/links/checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checker.d.ts","sourceRoot":"","sources":["file:///mnt/e/docker-containers/hit-em-with-the-docs/src/core/links/checker.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAGtD,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE5D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,gBAAgB,EAAE,eAAe,EAAE,CAAC;IACpC,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,KAAK,EAAE,SAAS,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,mBAAmB,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACpE;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAmJpF;AAuBD;;GAEG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAW9C;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,UAAU,EAAE,CAAC,CAyBvB"}