@git.zone/tsdoc 1.5.1 → 1.6.0

package/dist_ts/context/types.d.ts

@@ -54,6 +54,68 @@ export interface IContextConfig {
     };
     /** Trimming configuration */
     trimming?: ITrimConfig;
+    /** Cache configuration */
+    cache?: ICacheConfig;
+    /** Analyzer configuration */
+    analyzer?: IAnalyzerConfig;
+    /** Prioritization weights */
+    prioritization?: IPrioritizationWeights;
+    /** Tier configuration for adaptive trimming */
+    tiers?: ITierConfig;
+}
+/**
+ * Cache configuration
+ */
+export interface ICacheConfig {
+    /** Whether caching is enabled */
+    enabled?: boolean;
+    /** Time-to-live in seconds */
+    ttl?: number;
+    /** Maximum cache size in MB */
+    maxSize?: number;
+    /** Cache directory path */
+    directory?: string;
+}
+/**
+ * Analyzer configuration
+ */
+export interface IAnalyzerConfig {
+    /** Whether analyzer is enabled */
+    enabled?: boolean;
+    /** Whether to use AI refinement for selection */
+    useAIRefinement?: boolean;
+    /** AI model to use for refinement */
+    aiModel?: string;
+}
+/**
+ * Weights for file prioritization
+ */
+export interface IPrioritizationWeights {
+    /** Weight for dependency centrality */
+    dependencyWeight?: number;
+    /** Weight for task relevance */
+    relevanceWeight?: number;
+    /** Weight for token efficiency */
+    efficiencyWeight?: number;
+    /** Weight for file recency */
+    recencyWeight?: number;
+}
+/**
+ * Tier configuration for adaptive trimming
+ */
+export interface ITierConfig {
+    essential?: ITierSettings;
+    important?: ITierSettings;
+    optional?: ITierSettings;
+}
+/**
+ * Settings for a single tier
+ */
+export interface ITierSettings {
+    /** Minimum score to qualify for this tier */
+    minScore: number;
+    /** Trimming level to apply */
+    trimLevel: 'none' | 'light' | 'aggressive';
 }
 /**
  * Basic file information interface
@@ -87,3 +149,84 @@ export interface IContextResult {
     /** Token savings from trimming */
     tokenSavings: number;
 }
+/**
+ * File metadata without contents (for lazy loading)
+ */
+export interface IFileMetadata {
+    /** The file path */
+    path: string;
+    /** The file's relative path from the project root */
+    relativePath: string;
+    /** File size in bytes */
+    size: number;
+    /** Last modified time (Unix timestamp) */
+    mtime: number;
+    /** Estimated token count (without loading full contents) */
+    estimatedTokens: number;
+    /** The file's importance score */
+    importanceScore?: number;
+}
+/**
+ * Cache entry for a file
+ */
+export interface ICacheEntry {
+    /** File path */
+    path: string;
+    /** File contents */
+    contents: string;
+    /** Token count */
+    tokenCount: number;
+    /** Last modified time when cached */
+    mtime: number;
+    /** When this cache entry was created */
+    cachedAt: number;
+}
+/**
+ * Dependency information for a file
+ */
+export interface IFileDependencies {
+    /** File path */
+    path: string;
+    /** Files this file imports */
+    imports: string[];
+    /** Files that import this file */
+    importedBy: string[];
+    /** Centrality score (0-1) - how central this file is in the dependency graph */
+    centrality: number;
+}
+/**
+ * Analysis result for a file
+ */
+export interface IFileAnalysis {
+    /** File path */
+    path: string;
+    /** Task relevance score (0-1) */
+    relevanceScore: number;
+    /** Dependency centrality score (0-1) */
+    centralityScore: number;
+    /** Token efficiency score (0-1) */
+    efficiencyScore: number;
+    /** Recency score (0-1) */
+    recencyScore: number;
+    /** Combined importance score (0-1) */
+    importanceScore: number;
+    /** Assigned tier */
+    tier: 'essential' | 'important' | 'optional' | 'excluded';
+    /** Reason for the score */
+    reason?: string;
+}
+/**
+ * Result of context analysis
+ */
+export interface IAnalysisResult {
+    /** Task type being analyzed */
+    taskType: TaskType;
+    /** Analyzed files with scores */
+    files: IFileAnalysis[];
+    /** Dependency graph */
+    dependencyGraph: Map<string, IFileDependencies>;
+    /** Total files analyzed */
+    totalFiles: number;
+    /** Analysis duration in ms */
+    analysisDuration: number;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@git.zone/tsdoc",
-  "version": "1.5.1",
+  "version": "1.6.0",
   "private": false,
   "description": "A comprehensive TypeScript documentation tool that leverages AI to generate and enhance project documentation, including dynamic README creation, API docs via TypeDoc, and smart commit message generation.",
   "type": "module",
@@ -13,30 +13,29 @@
     "tsdoc": "cli.js"
   },
   "devDependencies": {
-    "@git.zone/tsbuild": "^2.6.4",
+    "@git.zone/tsbuild": "^2.6.8",
     "@git.zone/tsrun": "^1.2.46",
-    "@git.zone/tstest": "^2.3.2",
-    "@push.rocks/tapbundle": "^6.0.3",
+    "@git.zone/tstest": "^2.3.6",
     "@types/node": "^22.15.17"
   },
   "dependencies": {
-    "@git.zone/tspublish": "^1.10.1",
+    "@git.zone/tspublish": "^1.10.3",
     "@push.rocks/early": "^4.0.3",
-    "@push.rocks/npmextra": "^5.3.1",
-    "@push.rocks/qenv": "^6.1.2",
+    "@push.rocks/npmextra": "^5.3.3",
+    "@push.rocks/qenv": "^6.1.3",
     "@push.rocks/smartai": "^0.5.11",
     "@push.rocks/smartcli": "^4.0.11",
     "@push.rocks/smartdelay": "^3.0.5",
-    "@push.rocks/smartfile": "^11.2.5",
+    "@push.rocks/smartfile": "^11.2.7",
     "@push.rocks/smartgit": "^3.2.1",
     "@push.rocks/smartinteract": "^2.0.15",
-    "@push.rocks/smartlog": "^3.1.8",
+    "@push.rocks/smartlog": "^3.1.9",
     "@push.rocks/smartlog-destination-local": "^9.0.2",
     "@push.rocks/smartpath": "^6.0.0",
-    "@push.rocks/smartshell": "^3.2.4",
+    "@push.rocks/smartshell": "^3.3.0",
     "@push.rocks/smarttime": "^4.0.6",
-    "gpt-tokenizer": "^2.9.0",
-    "typedoc": "^0.28.10",
+    "gpt-tokenizer": "^3.0.1",
+    "typedoc": "^0.28.12",
     "typescript": "^5.9.2"
   },
   "files": [
@@ -76,7 +75,7 @@
   },
   "homepage": "https://gitlab.com/gitzone/tsdoc#readme",
   "scripts": {
-    "test": "(tstest test/) && npm run testCli",
+    "test": "(tstest test/ --verbose --logfile --timeout 600) && npm run testCli",
     "testCli": "(node ./cli.ts.js) && (node ./cli.ts.js aidocs)",
     "build": "(tsbuild --web --allowimplicitany)",
     "buildDocs": "tsdoc"