hyntx 2.1.0 → 2.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -71,6 +71,13 @@ type AnalyzePromptsOptions = {
71
71
  readonly rules?: RulesConfig;
72
72
  readonly onProgress?: (current: number, total: number) => void;
73
73
  readonly noCache?: boolean;
74
+ /**
75
+ * Pre-cached results from incremental results storage.
76
+ * When provided, these will be merged with newly analyzed results
77
+ * using mergeBatchResults(). This enables incremental analysis
78
+ * where only new prompts are analyzed.
79
+ */
80
+ readonly cachedResults?: ReadonlyMap<string, AnalysisResult>;
74
81
  };
75
82
  /**
76
83
  * Analyzes prompts using the provided AI provider.
@@ -81,14 +88,19 @@ type AnalyzePromptsOptions = {
81
88
  * 3. Checks cache for existing results (unless noCache is true)
82
89
  * 4. Processes batches sequentially with progress updates
83
90
  * 5. Stores results in cache for future use
84
- * 6. Merges batch results into final output
91
+ * 6. Merges batch results with any provided cached results
85
92
  * 7. Applies rules configuration to filter/modify patterns
86
93
  *
94
+ * For incremental analysis, use the `cachedResults` option to provide
95
+ * pre-loaded results from the incremental results storage. This allows
96
+ * the analyzer to only process new prompts and merge the results.
97
+ *
87
98
  * @param options - Analysis options
88
99
  * @returns Analysis result
89
100
  *
90
101
  * @example
91
102
  * ```typescript
103
+ * // Basic usage
92
104
  * const result = await analyzePrompts({
93
105
  * provider: ollamaProvider,
94
106
  * prompts: ['prompt1', 'prompt2', 'prompt3'],
@@ -97,6 +109,15 @@ type AnalyzePromptsOptions = {
97
109
  * onProgress: (current, total) => console.log(`${current}/${total}`),
98
110
  * noCache: false
99
111
  * });
112
+ *
113
+ * // With incremental cached results
114
+ * const { cached, toAnalyze } = await getPromptsWithCache(prompts, model, schema);
115
+ * const result = await analyzePrompts({
116
+ * provider,
117
+ * prompts: toAnalyze.map(p => p.content),
118
+ * date: '2025-01-15',
119
+ * cachedResults: cached, // Pre-loaded results from incremental storage
120
+ * });
100
121
  * ```
101
122
  */
102
123
  declare function analyzePrompts(options: AnalyzePromptsOptions): Promise<AnalysisResult>;
package/dist/api/index.js CHANGED
@@ -1019,15 +1019,61 @@ function applyRulesToResult(result, rules) {
1019
1019
  topSuggestion
1020
1020
  };
1021
1021
  }
1022
+ function mergeWithCachedResults(newResults, cachedResults, date, rules) {
1023
+ if (!cachedResults || cachedResults.size === 0) {
1024
+ if (newResults.length === 1) {
1025
+ const result = newResults[0];
1026
+ if (result) {
1027
+ return applyRulesToResult(result, rules);
1028
+ }
1029
+ }
1030
+ const mergedResult2 = mergeBatchResults({ results: newResults, date });
1031
+ return applyRulesToResult(mergedResult2, rules);
1032
+ }
1033
+ const cachedArray = Array.from(cachedResults.values());
1034
+ const allResults = [...cachedArray, ...newResults];
1035
+ logger.debug(
1036
+ `Merging ${String(cachedArray.length)} cached + ${String(newResults.length)} new results`,
1037
+ "analyzer"
1038
+ );
1039
+ const mergedResult = mergeBatchResults({ results: allResults, date });
1040
+ return applyRulesToResult(mergedResult, rules);
1041
+ }
1022
1042
  async function analyzePrompts(options) {
1023
- const { provider, prompts, date, context, rules, onProgress, noCache } = options;
1043
+ const {
1044
+ provider,
1045
+ prompts,
1046
+ date,
1047
+ context,
1048
+ rules,
1049
+ onProgress,
1050
+ noCache,
1051
+ cachedResults
1052
+ } = options;
1024
1053
  logger.debug(
1025
1054
  `Starting analysis of ${String(prompts.length)} prompts for ${date}`,
1026
1055
  "analyzer"
1027
1056
  );
1057
+ if (prompts.length === 0 && cachedResults && cachedResults.size > 0) {
1058
+ logger.debug(
1059
+ `Using ${String(cachedResults.size)} cached result(s), no new prompts to analyze`,
1060
+ "analyzer"
1061
+ );
1062
+ const cachedArray = Array.from(cachedResults.values());
1063
+ const mergedResult = mergeBatchResults({ results: cachedArray, date });
1064
+ return applyRulesToResult(mergedResult, rules);
1065
+ }
1028
1066
  if (prompts.length === 0) {
1029
1067
  throw new Error("Cannot analyze empty prompts array");
1030
1068
  }
1069
+ if (cachedResults && cachedResults.size > 0) {
1070
+ const totalPrompts = prompts.length + cachedResults.size;
1071
+ const cacheHitRate = (cachedResults.size / totalPrompts * 100).toFixed(1);
1072
+ logger.debug(
1073
+ `Results cache: ${String(cachedResults.size)} cached, ${String(prompts.length)} to analyze (${cacheHitRate}% hit rate)`,
1074
+ "analyzer"
1075
+ );
1076
+ }
1031
1077
  const { prompts: sanitizedPrompts, totalRedacted } = sanitizePrompts(prompts);
1032
1078
  if (totalRedacted > 0) {
1033
1079
  logger.debug(
@@ -1078,27 +1124,8 @@ async function analyzePrompts(options) {
1078
1124
  if (results2.length === 0) {
1079
1125
  throw new Error("All prompts failed analysis");
1080
1126
  }
1081
- if (results2.length === 1) {
1082
- const result = results2[0];
1083
- if (!result) {
1084
- throw new Error("Analysis returned empty result");
1085
- }
1086
- logger.debug(
1087
- `Analysis complete: ${String(result.patterns.length)} patterns found`,
1088
- "analyzer"
1089
- );
1090
- return applyRulesToResult(result, rules);
1091
- }
1092
- logger.debug(
1093
- `Merging ${String(results2.length)} fallback results`,
1094
- "analyzer"
1095
- );
1096
- const mergedResult2 = mergeBatchResults({ results: results2, date });
1097
- logger.debug(
1098
- `Analysis complete: ${String(mergedResult2.patterns.length)} patterns found`,
1099
- "analyzer"
1100
- );
1101
- return applyRulesToResult(mergedResult2, rules);
1127
+ logger.debug(`Analysis complete, merging with cached results`, "analyzer");
1128
+ return mergeWithCachedResults(results2, cachedResults, date, rules);
1102
1129
  }
1103
1130
  const results = [];
1104
1131
  const totalBatches = batches.length;
@@ -1135,13 +1162,11 @@ async function analyzePrompts(options) {
1135
1162
  if (results.length === 0) {
1136
1163
  throw new Error("All batches failed analysis");
1137
1164
  }
1138
- logger.debug(`Merging ${String(results.length)} batch results`, "analyzer");
1139
- const mergedResult = mergeBatchResults({ results, date });
1140
1165
  logger.debug(
1141
- `Analysis complete: ${String(mergedResult.patterns.length)} patterns found`,
1166
+ `Analysis complete, merging ${String(results.length)} batch results with cached results`,
1142
1167
  "analyzer"
1143
1168
  );
1144
- return applyRulesToResult(mergedResult, rules);
1169
+ return mergeWithCachedResults(results, cachedResults, date, rules);
1145
1170
  }
1146
1171
 
1147
1172
  // src/core/schema-validator.ts
package/dist/cli.js CHANGED
@@ -1970,15 +1970,61 @@ function applyRulesToResult(result, rules) {
1970
1970
  topSuggestion
1971
1971
  };
1972
1972
  }
1973
+ function mergeWithCachedResults(newResults, cachedResults, date, rules) {
1974
+ if (!cachedResults || cachedResults.size === 0) {
1975
+ if (newResults.length === 1) {
1976
+ const result = newResults[0];
1977
+ if (result) {
1978
+ return applyRulesToResult(result, rules);
1979
+ }
1980
+ }
1981
+ const mergedResult2 = mergeBatchResults({ results: newResults, date });
1982
+ return applyRulesToResult(mergedResult2, rules);
1983
+ }
1984
+ const cachedArray = Array.from(cachedResults.values());
1985
+ const allResults = [...cachedArray, ...newResults];
1986
+ logger.debug(
1987
+ `Merging ${String(cachedArray.length)} cached + ${String(newResults.length)} new results`,
1988
+ "analyzer"
1989
+ );
1990
+ const mergedResult = mergeBatchResults({ results: allResults, date });
1991
+ return applyRulesToResult(mergedResult, rules);
1992
+ }
1973
1993
  async function analyzePrompts(options) {
1974
- const { provider, prompts: prompts3, date, context, rules, onProgress, noCache } = options;
1994
+ const {
1995
+ provider,
1996
+ prompts: prompts3,
1997
+ date,
1998
+ context,
1999
+ rules,
2000
+ onProgress,
2001
+ noCache,
2002
+ cachedResults
2003
+ } = options;
1975
2004
  logger.debug(
1976
2005
  `Starting analysis of ${String(prompts3.length)} prompts for ${date}`,
1977
2006
  "analyzer"
1978
2007
  );
2008
+ if (prompts3.length === 0 && cachedResults && cachedResults.size > 0) {
2009
+ logger.debug(
2010
+ `Using ${String(cachedResults.size)} cached result(s), no new prompts to analyze`,
2011
+ "analyzer"
2012
+ );
2013
+ const cachedArray = Array.from(cachedResults.values());
2014
+ const mergedResult = mergeBatchResults({ results: cachedArray, date });
2015
+ return applyRulesToResult(mergedResult, rules);
2016
+ }
1979
2017
  if (prompts3.length === 0) {
1980
2018
  throw new Error("Cannot analyze empty prompts array");
1981
2019
  }
2020
+ if (cachedResults && cachedResults.size > 0) {
2021
+ const totalPrompts = prompts3.length + cachedResults.size;
2022
+ const cacheHitRate = (cachedResults.size / totalPrompts * 100).toFixed(1);
2023
+ logger.debug(
2024
+ `Results cache: ${String(cachedResults.size)} cached, ${String(prompts3.length)} to analyze (${cacheHitRate}% hit rate)`,
2025
+ "analyzer"
2026
+ );
2027
+ }
1982
2028
  const { prompts: sanitizedPrompts, totalRedacted } = sanitizePrompts(prompts3);
1983
2029
  if (totalRedacted > 0) {
1984
2030
  logger.debug(
@@ -2029,27 +2075,8 @@ async function analyzePrompts(options) {
2029
2075
  if (results2.length === 0) {
2030
2076
  throw new Error("All prompts failed analysis");
2031
2077
  }
2032
- if (results2.length === 1) {
2033
- const result = results2[0];
2034
- if (!result) {
2035
- throw new Error("Analysis returned empty result");
2036
- }
2037
- logger.debug(
2038
- `Analysis complete: ${String(result.patterns.length)} patterns found`,
2039
- "analyzer"
2040
- );
2041
- return applyRulesToResult(result, rules);
2042
- }
2043
- logger.debug(
2044
- `Merging ${String(results2.length)} fallback results`,
2045
- "analyzer"
2046
- );
2047
- const mergedResult2 = mergeBatchResults({ results: results2, date });
2048
- logger.debug(
2049
- `Analysis complete: ${String(mergedResult2.patterns.length)} patterns found`,
2050
- "analyzer"
2051
- );
2052
- return applyRulesToResult(mergedResult2, rules);
2078
+ logger.debug(`Analysis complete, merging with cached results`, "analyzer");
2079
+ return mergeWithCachedResults(results2, cachedResults, date, rules);
2053
2080
  }
2054
2081
  const results = [];
2055
2082
  const totalBatches = batches.length;
@@ -2086,13 +2113,11 @@ async function analyzePrompts(options) {
2086
2113
  if (results.length === 0) {
2087
2114
  throw new Error("All batches failed analysis");
2088
2115
  }
2089
- logger.debug(`Merging ${String(results.length)} batch results`, "analyzer");
2090
- const mergedResult = mergeBatchResults({ results, date });
2091
2116
  logger.debug(
2092
- `Analysis complete: ${String(mergedResult.patterns.length)} patterns found`,
2117
+ `Analysis complete, merging ${String(results.length)} batch results with cached results`,
2093
2118
  "analyzer"
2094
2119
  );
2095
- return applyRulesToResult(mergedResult, rules);
2120
+ return mergeWithCachedResults(results, cachedResults, date, rules);
2096
2121
  }
2097
2122
  function severityIcon(severity) {
2098
2123
  const icons = {
package/dist/index.js CHANGED
@@ -1019,15 +1019,61 @@ function applyRulesToResult(result, rules) {
1019
1019
  topSuggestion
1020
1020
  };
1021
1021
  }
1022
+ function mergeWithCachedResults(newResults, cachedResults, date, rules) {
1023
+ if (!cachedResults || cachedResults.size === 0) {
1024
+ if (newResults.length === 1) {
1025
+ const result = newResults[0];
1026
+ if (result) {
1027
+ return applyRulesToResult(result, rules);
1028
+ }
1029
+ }
1030
+ const mergedResult2 = mergeBatchResults({ results: newResults, date });
1031
+ return applyRulesToResult(mergedResult2, rules);
1032
+ }
1033
+ const cachedArray = Array.from(cachedResults.values());
1034
+ const allResults = [...cachedArray, ...newResults];
1035
+ logger.debug(
1036
+ `Merging ${String(cachedArray.length)} cached + ${String(newResults.length)} new results`,
1037
+ "analyzer"
1038
+ );
1039
+ const mergedResult = mergeBatchResults({ results: allResults, date });
1040
+ return applyRulesToResult(mergedResult, rules);
1041
+ }
1022
1042
  async function analyzePrompts(options) {
1023
- const { provider, prompts, date, context, rules, onProgress, noCache } = options;
1043
+ const {
1044
+ provider,
1045
+ prompts,
1046
+ date,
1047
+ context,
1048
+ rules,
1049
+ onProgress,
1050
+ noCache,
1051
+ cachedResults
1052
+ } = options;
1024
1053
  logger.debug(
1025
1054
  `Starting analysis of ${String(prompts.length)} prompts for ${date}`,
1026
1055
  "analyzer"
1027
1056
  );
1057
+ if (prompts.length === 0 && cachedResults && cachedResults.size > 0) {
1058
+ logger.debug(
1059
+ `Using ${String(cachedResults.size)} cached result(s), no new prompts to analyze`,
1060
+ "analyzer"
1061
+ );
1062
+ const cachedArray = Array.from(cachedResults.values());
1063
+ const mergedResult = mergeBatchResults({ results: cachedArray, date });
1064
+ return applyRulesToResult(mergedResult, rules);
1065
+ }
1028
1066
  if (prompts.length === 0) {
1029
1067
  throw new Error("Cannot analyze empty prompts array");
1030
1068
  }
1069
+ if (cachedResults && cachedResults.size > 0) {
1070
+ const totalPrompts = prompts.length + cachedResults.size;
1071
+ const cacheHitRate = (cachedResults.size / totalPrompts * 100).toFixed(1);
1072
+ logger.debug(
1073
+ `Results cache: ${String(cachedResults.size)} cached, ${String(prompts.length)} to analyze (${cacheHitRate}% hit rate)`,
1074
+ "analyzer"
1075
+ );
1076
+ }
1031
1077
  const { prompts: sanitizedPrompts, totalRedacted } = sanitizePrompts(prompts);
1032
1078
  if (totalRedacted > 0) {
1033
1079
  logger.debug(
@@ -1078,27 +1124,8 @@ async function analyzePrompts(options) {
1078
1124
  if (results2.length === 0) {
1079
1125
  throw new Error("All prompts failed analysis");
1080
1126
  }
1081
- if (results2.length === 1) {
1082
- const result = results2[0];
1083
- if (!result) {
1084
- throw new Error("Analysis returned empty result");
1085
- }
1086
- logger.debug(
1087
- `Analysis complete: ${String(result.patterns.length)} patterns found`,
1088
- "analyzer"
1089
- );
1090
- return applyRulesToResult(result, rules);
1091
- }
1092
- logger.debug(
1093
- `Merging ${String(results2.length)} fallback results`,
1094
- "analyzer"
1095
- );
1096
- const mergedResult2 = mergeBatchResults({ results: results2, date });
1097
- logger.debug(
1098
- `Analysis complete: ${String(mergedResult2.patterns.length)} patterns found`,
1099
- "analyzer"
1100
- );
1101
- return applyRulesToResult(mergedResult2, rules);
1127
+ logger.debug(`Analysis complete, merging with cached results`, "analyzer");
1128
+ return mergeWithCachedResults(results2, cachedResults, date, rules);
1102
1129
  }
1103
1130
  const results = [];
1104
1131
  const totalBatches = batches.length;
@@ -1135,13 +1162,11 @@ async function analyzePrompts(options) {
1135
1162
  if (results.length === 0) {
1136
1163
  throw new Error("All batches failed analysis");
1137
1164
  }
1138
- logger.debug(`Merging ${String(results.length)} batch results`, "analyzer");
1139
- const mergedResult = mergeBatchResults({ results, date });
1140
1165
  logger.debug(
1141
- `Analysis complete: ${String(mergedResult.patterns.length)} patterns found`,
1166
+ `Analysis complete, merging ${String(results.length)} batch results with cached results`,
1142
1167
  "analyzer"
1143
1168
  );
1144
- return applyRulesToResult(mergedResult, rules);
1169
+ return mergeWithCachedResults(results, cachedResults, date, rules);
1145
1170
  }
1146
1171
 
1147
1172
  // src/core/schema-validator.ts
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "hyntx",
3
- "version": "2.1.0",
3
+ "version": "2.2.1",
4
4
  "description": "CLI that analyzes Claude Code prompts and generates improvement suggestions",
5
5
  "type": "module",
6
6
  "engines": {
@@ -41,7 +41,7 @@
41
41
  "vitest": "^4.0.16"
42
42
  },
43
43
  "bin": {
44
- "hyntx": "./dist/cli.js"
44
+ "hyntx": "dist/cli.js"
45
45
  },
46
46
  "exports": {
47
47
  ".": {