@utilix-tech/sdk 0.82.0 → 0.84.0

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 Full release notes for all Utilix surfaces (browser tools, REST API, SDKs, MCP server) live at [utilix.tech/changelog](https://utilix.tech/changelog). This file tracks just this package.
 
+## 0.84.0
+- Add `findCronOverlaps` (cron-overlap-detector): walk minute-by-minute over a window of days and flag every minute where two or more cron schedules fire at once, listing which expressions collided.
+- Add `lintDockerfile` (dockerfile-linter): lint a Dockerfile for an unpinned or `:latest` base image, a final stage missing WORKDIR or USER, and ADD used on a plain local file where COPY would do.
+
+## 0.83.0
+- Add `extractMarkdownLinkReferences` (markdown-link-reference-extractor): extract reference-style Markdown links (`[text][ref]`, the `[text][]` shortcut, and `![alt][ref]` image references) and match them against their `[ref]: url` definitions, flagging unresolved references and unused definitions.
+- Add `extractPromptTemplateVariables` (prompt-template-variable-extractor): extract `{{variable}}`-style placeholders from a prompt template, report occurrence counts, flag duplicates, and optionally cross-check against a list of provided variable names.
+
 ## 0.82.0
 - Add `generateRobotsTxt` (robots-txt-generator): build a robots.txt file from User-agent groups with Allow/Disallow rules and an optional Crawl-delay, plus a list of Sitemap URLs. The generator-side sibling of `validateRobotsTxt`.
 

package/README.md

@@ -1,6 +1,6 @@
 # @utilix-tech/sdk
 
-**716 developer utility functions for Node.js: runs locally, no API key required.**
+**721 developer utility functions for Node.js: runs locally, no API key required.**
 
 [![npm version](https://img.shields.io/npm/v/@utilix-tech/sdk?style=flat-square&color=cb3837)](https://www.npmjs.com/package/@utilix-tech/sdk)
 [![npm downloads](https://img.shields.io/npm/dm/@utilix-tech/sdk?style=flat-square)](https://www.npmjs.com/package/@utilix-tech/sdk)
@@ -877,6 +877,11 @@ extractMarkdownFootnotes("A claim[^1].\n\n[^1]: The source.");
 import { validateAria } from "@utilix-tech/sdk/code";
 validateAria('<div role="checkbox">Opt in</div>');
 // { elementCount: 1, elementsWithRoleOrAria: 1, valid: false, issues: [{ severity: "error", message: 'role="checkbox" is missing required attribute aria-checked', ... }] }
+
+// Extract reference-style Markdown links ([text][ref], [text][], ![alt][ref]) and match them against [ref]: url definitions
+import { extractMarkdownLinkReferences } from "@utilix-tech/sdk/code";
+extractMarkdownLinkReferences("See the [docs][api-ref].\n\n[api-ref]: https://example.com/api \"API Reference\"");
+// { referenceCount: 1, definitionCount: 1, resolved: [{ text: "docs", label: "api-ref", image: false, url: "https://example.com/api", title: "API Reference" }], unresolvedReferences: [], unusedDefinitions: [] }
 ```
 
 ---
@@ -1050,11 +1055,11 @@ readMidiInfo(new Uint8Array(midiBytes));
 | `@utilix-tech/sdk/units` | Bytes, CSS px/rem, number bases, currency format, credit card/IBAN/barcode/ISBN/VIN/ISIN validation, loan calculator, EMI calculator, compound/simple interest calculators, VAT/sales tax calculator, tip/bill split calculator, break-even point calculator, Rule of 72 calculator, savings goal calculator, ROI calculator, cash denomination/till calculator, payback period calculator, CD maturity calculator, debt-to-income ratio calculator, freelancer hourly rate calculator, debt snowball/avalanche payoff planner, tax-equivalent yield calculator, mortgage discount points break-even calculator, loan prepayment penalty calculator, data transfer time / required bandwidth estimator, real rate of return (Fisher equation) calculator |
 | `@utilix-tech/sdk/network` | HTTP status codes, IP validation, country flags, geolocation URLs, HAR file parsing, User-Agent parsing, IPv6 address compress/expand, Permissions-Policy header builder, Client Hints header builder/parser, Content-Disposition header builder/parser, X-Content-Type-Options header builder/risk assessor, sitemap.xml validator, sitemap index splitter, robots.txt validator, robots.txt generator, Prefer header builder/parser (RFC 7240), Retry-After header builder/parser (RFC 9110), Priority header builder/parser (RFC 9218), WebSocket close code reference/lookup, Strict-Transport-Security (HSTS) header builder/parser, X-Robots-Tag header builder/parser, WebSocket frame opcode reference/lookup, robots meta tag builder/parser, Cookie header byte-size budget calculator |
 | `@utilix-tech/sdk/api` | cURL build/parse, JWT decode/sign, JWKS parse, CORS headers, CSP header, TOTP/HOTP code generator, webhook HMAC signature verifier |
-| `@utilix-tech/sdk/code` | SQL format/minify, HTML format/minify, regex tester, GraphQL format, MIME type lookup, GitHub URL parsing, regex ReDoS detector, Conventional Commits linter, package.json exports field validator, package.json dependency range auditor, regex capture group/backreference visualizer, SVG sprite symbol extractor, ARIA role & attribute validator, database connection string parser, Markdown code fence language tag validator, SQL query parameter placeholder counter |
+| `@utilix-tech/sdk/code` | SQL format/minify, HTML format/minify, regex tester, GraphQL format, MIME type lookup, GitHub URL parsing, regex ReDoS detector, Conventional Commits linter, package.json exports field validator, package.json dependency range auditor, regex capture group/backreference visualizer, SVG sprite symbol extractor, ARIA role & attribute validator, database connection string parser, Markdown code fence language tag validator, SQL query parameter placeholder counter, Markdown link reference extractor |
 | `@utilix-tech/sdk/color` | Hex/RGB/HSL/HSV/CMYK convert, palette generation, contrast check |
 | `@utilix-tech/sdk/css` | CSS gradient, box-shadow, border-radius, keyframe animation generators |
 | `@utilix-tech/sdk/misc` | SVG optimize/sanitize, file size format, Unicode inspector |
-| `@utilix-tech/sdk/ai_agent` | Token estimate/trim, chunk text, extract URLs/JSON/keywords, sanitize HTML, flatten/merge JSON, dedupe lines, validate schema, PII/secret/injection detect, vector similarity, few-shot prompt formatter, tool-definition schema linter, retry/backoff schedule calculator |
+| `@utilix-tech/sdk/ai_agent` | Token estimate/trim, chunk text, extract URLs/JSON/keywords, sanitize HTML, flatten/merge JSON, dedupe lines, validate schema, PII/secret/injection detect, vector similarity, few-shot prompt formatter, tool-definition schema linter, retry/backoff schedule calculator, prompt template variable extractor |
 | `@utilix-tech/sdk/media` | Image format & dimension reading from raw bytes (PNG, JPEG, GIF, WebP, BMP); PDF metadata reading; PDF page dimension/orientation listing; WAV audio info; ID3 tags; ICO favicon inspection; FLAC metadata reading; MP4/WebM video info; GIF frame/loop inspection |
 
 ---

package/dist/{ai_agent-DeCy0oZK.d.cts → ai_agent-B9wWLBDf.d.cts}

@@ -409,6 +409,30 @@ interface RetryBackoffResult {
 declare function calculateRetryBackoffSchedule(input: RetryBackoffInput): RetryBackoffResult | {
     error: string;
 };
+interface PromptTemplateVariable {
+    name: string;
+    count: number;
+}
+interface PromptTemplateVariableResult {
+    variableCount: number;
+    variables: PromptTemplateVariable[];
+    duplicates: string[];
+    missing: string[];
+    unused: string[];
+}
+/**
+ * Extract every {{variable}}-style placeholder from a prompt template,
+ * reporting each unique variable's occurrence count and flagging ones used
+ * more than once. When providedVars is given, also cross-checks the
+ * template against it: variables the template uses but providedVars is
+ * missing, and names in providedVars the template never references. Only
+ * double-curly {{name}} syntax is recognized (dotted/dashed names like
+ * {{user.name}} are allowed); single-brace, triple-brace, and Jinja-style
+ * {% %} tags are out of scope.
+ */
+declare function extractPromptTemplateVariables(template: string, providedVars?: string[]): PromptTemplateVariableResult | {
+    error: string;
+};
 
 type ai_agent_ChunkStrategy = ChunkStrategy;
 type ai_agent_CompressHtmlResult = CompressHtmlResult;
@@ -440,6 +464,8 @@ type ai_agent_ModelPricing = ModelPricing;
 type ai_agent_PiiDetectResult = PiiDetectResult;
 type ai_agent_PiiFinding = PiiFinding;
 type ai_agent_PiiType = PiiType;
+type ai_agent_PromptTemplateVariable = PromptTemplateVariable;
+type ai_agent_PromptTemplateVariableResult = PromptTemplateVariableResult;
 type ai_agent_RankedChunk = RankedChunk;
 type ai_agent_RelevanceResult = RelevanceResult;
 type ai_agent_RetryBackoffAttempt = RetryBackoffAttempt;
@@ -479,6 +505,7 @@ declare const ai_agent_expandQuery: typeof expandQuery;
 declare const ai_agent_extractEntities: typeof extractEntities;
 declare const ai_agent_extractJson: typeof extractJson;
 declare const ai_agent_extractKeywords: typeof extractKeywords;
+declare const ai_agent_extractPromptTemplateVariables: typeof extractPromptTemplateVariables;
 declare const ai_agent_extractTables: typeof extractTables;
 declare const ai_agent_extractUrls: typeof extractUrls;
 declare const ai_agent_flattenJson: typeof flattenJson;
@@ -496,7 +523,7 @@ declare const ai_agent_unflattenJson: typeof unflattenJson;
 declare const ai_agent_validateJsonSchema: typeof validateJsonSchema;
 declare const ai_agent_vectorSimilarity: typeof vectorSimilarity;
 declare namespace ai_agent {
-  export { type ai_agent_ChunkStrategy as ChunkStrategy, type ai_agent_CompressHtmlResult as CompressHtmlResult, type ai_agent_CompressJsonResult as CompressJsonResult, type ai_agent_CompressMarkdownResult as CompressMarkdownResult, type ai_agent_CostEstimate as CostEstimate, type ai_agent_DedupeResult as DedupeResult, type ai_agent_DedupeStrategy as DedupeStrategy, type ai_agent_DiffEntry2 as DiffEntry2, type ai_agent_DiffOp2 as DiffOp2, type ai_agent_DiffResult2 as DiffResult2, type ai_agent_Entity2 as Entity2, type ai_agent_EntityType2 as EntityType2, type ai_agent_ExtractJsonResult as ExtractJsonResult, type ai_agent_ExtractKeywordsResult as ExtractKeywordsResult, type ai_agent_ExtractUrlsResult as ExtractUrlsResult, type ai_agent_FewShotExample as FewShotExample, type ai_agent_FewShotFormat as FewShotFormat, type ai_agent_FewShotFormatResult as FewShotFormatResult, type ai_agent_InjectionDetectResult as InjectionDetectResult, type ai_agent_InjectionFinding as InjectionFinding, type ai_agent_JsonBlock as JsonBlock, type ai_agent_JsonRepairResult as JsonRepairResult, type ai_agent_Keyword as Keyword, ai_agent_MODEL_PRICING as MODEL_PRICING, type ai_agent_MergeResult as MergeResult, type ai_agent_MergeStrategy as MergeStrategy, type ai_agent_ModelPricing as ModelPricing, type ai_agent_PiiDetectResult as PiiDetectResult, type ai_agent_PiiFinding as PiiFinding, type ai_agent_PiiType as PiiType, type ai_agent_RankedChunk as RankedChunk, type ai_agent_RelevanceResult as RelevanceResult, type ai_agent_RetryBackoffAttempt as RetryBackoffAttempt, type ai_agent_RetryBackoffInput as RetryBackoffInput, type ai_agent_RetryBackoffResult as RetryBackoffResult, type ai_agent_RetryJitterMode as RetryJitterMode, type ai_agent_SanitizeResult as SanitizeResult, type ai_agent_SecretDetectResult as SecretDetectResult, type ai_agent_SecretFinding as SecretFinding, type ai_agent_SecretType as SecretType, type ai_agent_SummaryResult as SummaryResult, type ai_agent_TableResult2 as TableResult2, type ai_agent_TextChunk as TextChunk, type ai_agent_TokenEstimate as TokenEstimate, type ai_agent_TokenEstimateResult as TokenEstimateResult, type ai_agent_ToolSchemaIssue as ToolSchemaIssue, type ai_agent_ToolSchemaLintResult as ToolSchemaLintResult, type ai_agent_TrimResult as TrimResult, type ai_agent_TrimStrategy as TrimStrategy, type ai_agent_UrlMatch as UrlMatch, type ai_agent_ValidationError as ValidationError, type ai_agent_ValidationResult as ValidationResult, type ai_agent_VectorSimilarityResult as VectorSimilarityResult, ai_agent_calculateRetryBackoffSchedule as calculateRetryBackoffSchedule, ai_agent_chunkText as chunkText, ai_agent_compressHtml as compressHtml, ai_agent_compressJson as compressJson, ai_agent_compressMarkdown as compressMarkdown, ai_agent_deduplicateLines as deduplicateLines, ai_agent_detectPii as detectPii, ai_agent_detectPromptInjection as detectPromptInjection, ai_agent_detectSecrets as detectSecrets, ai_agent_diffJson as diffJson, ai_agent_estimateCost as estimateCost, ai_agent_estimateTokens as estimateTokens, ai_agent_expandQuery as expandQuery, ai_agent_extractEntities as extractEntities, ai_agent_extractJson as extractJson, ai_agent_extractKeywords as extractKeywords, ai_agent_extractTables as extractTables, ai_agent_extractUrls as extractUrls, ai_agent_flattenJson as flattenJson, ai_agent_formatFewShotExamples as formatFewShotExamples, ai_agent_lintToolSchema as lintToolSchema, ai_agent_mergeJson as mergeJson, ai_agent_redactPii as redactPii, ai_agent_repairJson as repairJson, ai_agent_rerankChunks as rerankChunks, ai_agent_sanitizeHtml as sanitizeHtml, ai_agent_scoreRelevance as scoreRelevance, ai_agent_summarizeForLlm as summarizeForLlm, ai_agent_trimToTokens as trimToTokens, ai_agent_unflattenJson as unflattenJson, ai_agent_validateJsonSchema as validateJsonSchema, ai_agent_vectorSimilarity as vectorSimilarity };
+  export { type ai_agent_ChunkStrategy as ChunkStrategy, type ai_agent_CompressHtmlResult as CompressHtmlResult, type ai_agent_CompressJsonResult as CompressJsonResult, type ai_agent_CompressMarkdownResult as CompressMarkdownResult, type ai_agent_CostEstimate as CostEstimate, type ai_agent_DedupeResult as DedupeResult, type ai_agent_DedupeStrategy as DedupeStrategy, type ai_agent_DiffEntry2 as DiffEntry2, type ai_agent_DiffOp2 as DiffOp2, type ai_agent_DiffResult2 as DiffResult2, type ai_agent_Entity2 as Entity2, type ai_agent_EntityType2 as EntityType2, type ai_agent_ExtractJsonResult as ExtractJsonResult, type ai_agent_ExtractKeywordsResult as ExtractKeywordsResult, type ai_agent_ExtractUrlsResult as ExtractUrlsResult, type ai_agent_FewShotExample as FewShotExample, type ai_agent_FewShotFormat as FewShotFormat, type ai_agent_FewShotFormatResult as FewShotFormatResult, type ai_agent_InjectionDetectResult as InjectionDetectResult, type ai_agent_InjectionFinding as InjectionFinding, type ai_agent_JsonBlock as JsonBlock, type ai_agent_JsonRepairResult as JsonRepairResult, type ai_agent_Keyword as Keyword, ai_agent_MODEL_PRICING as MODEL_PRICING, type ai_agent_MergeResult as MergeResult, type ai_agent_MergeStrategy as MergeStrategy, type ai_agent_ModelPricing as ModelPricing, type ai_agent_PiiDetectResult as PiiDetectResult, type ai_agent_PiiFinding as PiiFinding, type ai_agent_PiiType as PiiType, type ai_agent_PromptTemplateVariable as PromptTemplateVariable, type ai_agent_PromptTemplateVariableResult as PromptTemplateVariableResult, type ai_agent_RankedChunk as RankedChunk, type ai_agent_RelevanceResult as RelevanceResult, type ai_agent_RetryBackoffAttempt as RetryBackoffAttempt, type ai_agent_RetryBackoffInput as RetryBackoffInput, type ai_agent_RetryBackoffResult as RetryBackoffResult, type ai_agent_RetryJitterMode as RetryJitterMode, type ai_agent_SanitizeResult as SanitizeResult, type ai_agent_SecretDetectResult as SecretDetectResult, type ai_agent_SecretFinding as SecretFinding, type ai_agent_SecretType as SecretType, type ai_agent_SummaryResult as SummaryResult, type ai_agent_TableResult2 as TableResult2, type ai_agent_TextChunk as TextChunk, type ai_agent_TokenEstimate as TokenEstimate, type ai_agent_TokenEstimateResult as TokenEstimateResult, type ai_agent_ToolSchemaIssue as ToolSchemaIssue, type ai_agent_ToolSchemaLintResult as ToolSchemaLintResult, type ai_agent_TrimResult as TrimResult, type ai_agent_TrimStrategy as TrimStrategy, type ai_agent_UrlMatch as UrlMatch, type ai_agent_ValidationError as ValidationError, type ai_agent_ValidationResult as ValidationResult, type ai_agent_VectorSimilarityResult as VectorSimilarityResult, ai_agent_calculateRetryBackoffSchedule as calculateRetryBackoffSchedule, ai_agent_chunkText as chunkText, ai_agent_compressHtml as compressHtml, ai_agent_compressJson as compressJson, ai_agent_compressMarkdown as compressMarkdown, ai_agent_deduplicateLines as deduplicateLines, ai_agent_detectPii as detectPii, ai_agent_detectPromptInjection as detectPromptInjection, ai_agent_detectSecrets as detectSecrets, ai_agent_diffJson as diffJson, ai_agent_estimateCost as estimateCost, ai_agent_estimateTokens as estimateTokens, ai_agent_expandQuery as expandQuery, ai_agent_extractEntities as extractEntities, ai_agent_extractJson as extractJson, ai_agent_extractKeywords as extractKeywords, ai_agent_extractPromptTemplateVariables as extractPromptTemplateVariables, ai_agent_extractTables as extractTables, ai_agent_extractUrls as extractUrls, ai_agent_flattenJson as flattenJson, ai_agent_formatFewShotExamples as formatFewShotExamples, ai_agent_lintToolSchema as lintToolSchema, ai_agent_mergeJson as mergeJson, ai_agent_redactPii as redactPii, ai_agent_repairJson as repairJson, ai_agent_rerankChunks as rerankChunks, ai_agent_sanitizeHtml as sanitizeHtml, ai_agent_scoreRelevance as scoreRelevance, ai_agent_summarizeForLlm as summarizeForLlm, ai_agent_trimToTokens as trimToTokens, ai_agent_unflattenJson as unflattenJson, ai_agent_validateJsonSchema as validateJsonSchema, ai_agent_vectorSimilarity as vectorSimilarity };
 }
 
-export { type VectorSimilarityResult as $, type RetryJitterMode as A, type SecretDetectResult as B, type ChunkStrategy as C, type DedupeResult as D, type Entity2 as E, type FewShotExample as F, type SecretFinding as G, type SecretType as H, type InjectionDetectResult as I, type JsonBlock as J, type Keyword as K, type SummaryResult as L, MODEL_PRICING as M, type TextChunk as N, type TokenEstimate as O, type PiiDetectResult as P, type TokenEstimateResult as Q, type RankedChunk as R, type SanitizeResult as S, type TableResult2 as T, type ToolSchemaIssue as U, type ToolSchemaLintResult as V, type TrimResult as W, type TrimStrategy as X, type UrlMatch as Y, type ValidationError as Z, type ValidationResult as _, ai_agent as a, calculateRetryBackoffSchedule as a0, chunkText as a1, compressHtml as a2, compressJson as a3, compressMarkdown as a4, deduplicateLines as a5, detectPii as a6, detectPromptInjection as a7, detectSecrets as a8, diffJson as a9, estimateCost as aa, estimateTokens as ab, expandQuery as ac, extractEntities as ad, extractJson as ae, extractKeywords as af, extractTables as ag, extractUrls as ah, flattenJson as ai, formatFewShotExamples as aj, lintToolSchema as ak, mergeJson as al, redactPii as am, repairJson as an, rerankChunks as ao, sanitizeHtml as ap, scoreRelevance as aq, summarizeForLlm as ar, trimToTokens as as, unflattenJson as at, validateJsonSchema as au, vectorSimilarity as av, type CompressHtmlResult as b, type CompressJsonResult as c, type CompressMarkdownResult as d, type CostEstimate as e, type DedupeStrategy as f, type DiffEntry2 as g, type DiffOp2 as h, type DiffResult2 as i, type EntityType2 as j, type ExtractJsonResult as k, type ExtractKeywordsResult as l, type ExtractUrlsResult as m, type FewShotFormat as n, type FewShotFormatResult as o, type InjectionFinding as p, type JsonRepairResult as q, type MergeResult as r, type MergeStrategy as s, type ModelPricing as t, type PiiFinding as u, type PiiType as v, type RelevanceResult as w, type RetryBackoffAttempt as x, type RetryBackoffInput as y, type RetryBackoffResult as z };
+export { type ValidationError as $, type RetryBackoffInput as A, type RetryBackoffResult as B, type ChunkStrategy as C, type DedupeResult as D, type Entity2 as E, type FewShotExample as F, type RetryJitterMode as G, type SecretDetectResult as H, type InjectionDetectResult as I, type JsonBlock as J, type Keyword as K, type SecretFinding as L, MODEL_PRICING as M, type SecretType as N, type SummaryResult as O, type PiiDetectResult as P, type TextChunk as Q, type RankedChunk as R, type SanitizeResult as S, type TableResult2 as T, type TokenEstimate as U, type TokenEstimateResult as V, type ToolSchemaIssue as W, type ToolSchemaLintResult as X, type TrimResult as Y, type TrimStrategy as Z, type UrlMatch as _, ai_agent as a, type ValidationResult as a0, type VectorSimilarityResult as a1, calculateRetryBackoffSchedule as a2, chunkText as a3, compressHtml as a4, compressJson as a5, compressMarkdown as a6, deduplicateLines as a7, detectPii as a8, detectPromptInjection as a9, detectSecrets as aa, diffJson as ab, estimateCost as ac, estimateTokens as ad, expandQuery as ae, extractEntities as af, extractJson as ag, extractKeywords as ah, extractPromptTemplateVariables as ai, extractTables as aj, extractUrls as ak, flattenJson as al, formatFewShotExamples as am, lintToolSchema as an, mergeJson as ao, redactPii as ap, repairJson as aq, rerankChunks as ar, sanitizeHtml as as, scoreRelevance as at, summarizeForLlm as au, trimToTokens as av, unflattenJson as aw, validateJsonSchema as ax, vectorSimilarity as ay, type CompressHtmlResult as b, type CompressJsonResult as c, type CompressMarkdownResult as d, type CostEstimate as e, type DedupeStrategy as f, type DiffEntry2 as g, type DiffOp2 as h, type DiffResult2 as i, type EntityType2 as j, type ExtractJsonResult as k, type ExtractKeywordsResult as l, type ExtractUrlsResult as m, type FewShotFormat as n, type FewShotFormatResult as o, type InjectionFinding as p, type JsonRepairResult as q, type MergeResult as r, type MergeStrategy as s, type ModelPricing as t, type PiiFinding as u, type PiiType as v, type PromptTemplateVariable as w, type PromptTemplateVariableResult as x, type RelevanceResult as y, type RetryBackoffAttempt as z };

package/dist/{ai_agent-DeCy0oZK.d.ts → ai_agent-B9wWLBDf.d.ts}

@@ -409,6 +409,30 @@ interface RetryBackoffResult {
 declare function calculateRetryBackoffSchedule(input: RetryBackoffInput): RetryBackoffResult | {
     error: string;
 };
+interface PromptTemplateVariable {
+    name: string;
+    count: number;
+}
+interface PromptTemplateVariableResult {
+    variableCount: number;
+    variables: PromptTemplateVariable[];
+    duplicates: string[];
+    missing: string[];
+    unused: string[];
+}
+/**
+ * Extract every {{variable}}-style placeholder from a prompt template,
+ * reporting each unique variable's occurrence count and flagging ones used
+ * more than once. When providedVars is given, also cross-checks the
+ * template against it: variables the template uses but providedVars is
+ * missing, and names in providedVars the template never references. Only
+ * double-curly {{name}} syntax is recognized (dotted/dashed names like
+ * {{user.name}} are allowed); single-brace, triple-brace, and Jinja-style
+ * {% %} tags are out of scope.
+ */
+declare function extractPromptTemplateVariables(template: string, providedVars?: string[]): PromptTemplateVariableResult | {
+    error: string;
+};
 
 type ai_agent_ChunkStrategy = ChunkStrategy;
 type ai_agent_CompressHtmlResult = CompressHtmlResult;
@@ -440,6 +464,8 @@ type ai_agent_ModelPricing = ModelPricing;
 type ai_agent_PiiDetectResult = PiiDetectResult;
 type ai_agent_PiiFinding = PiiFinding;
 type ai_agent_PiiType = PiiType;
+type ai_agent_PromptTemplateVariable = PromptTemplateVariable;
+type ai_agent_PromptTemplateVariableResult = PromptTemplateVariableResult;
 type ai_agent_RankedChunk = RankedChunk;
 type ai_agent_RelevanceResult = RelevanceResult;
 type ai_agent_RetryBackoffAttempt = RetryBackoffAttempt;
@@ -479,6 +505,7 @@ declare const ai_agent_expandQuery: typeof expandQuery;
 declare const ai_agent_extractEntities: typeof extractEntities;
 declare const ai_agent_extractJson: typeof extractJson;
 declare const ai_agent_extractKeywords: typeof extractKeywords;
+declare const ai_agent_extractPromptTemplateVariables: typeof extractPromptTemplateVariables;
 declare const ai_agent_extractTables: typeof extractTables;
 declare const ai_agent_extractUrls: typeof extractUrls;
 declare const ai_agent_flattenJson: typeof flattenJson;
@@ -496,7 +523,7 @@ declare const ai_agent_unflattenJson: typeof unflattenJson;
 declare const ai_agent_validateJsonSchema: typeof validateJsonSchema;
 declare const ai_agent_vectorSimilarity: typeof vectorSimilarity;
 declare namespace ai_agent {
-  export { type ai_agent_ChunkStrategy as ChunkStrategy, type ai_agent_CompressHtmlResult as CompressHtmlResult, type ai_agent_CompressJsonResult as CompressJsonResult, type ai_agent_CompressMarkdownResult as CompressMarkdownResult, type ai_agent_CostEstimate as CostEstimate, type ai_agent_DedupeResult as DedupeResult, type ai_agent_DedupeStrategy as DedupeStrategy, type ai_agent_DiffEntry2 as DiffEntry2, type ai_agent_DiffOp2 as DiffOp2, type ai_agent_DiffResult2 as DiffResult2, type ai_agent_Entity2 as Entity2, type ai_agent_EntityType2 as EntityType2, type ai_agent_ExtractJsonResult as ExtractJsonResult, type ai_agent_ExtractKeywordsResult as ExtractKeywordsResult, type ai_agent_ExtractUrlsResult as ExtractUrlsResult, type ai_agent_FewShotExample as FewShotExample, type ai_agent_FewShotFormat as FewShotFormat, type ai_agent_FewShotFormatResult as FewShotFormatResult, type ai_agent_InjectionDetectResult as InjectionDetectResult, type ai_agent_InjectionFinding as InjectionFinding, type ai_agent_JsonBlock as JsonBlock, type ai_agent_JsonRepairResult as JsonRepairResult, type ai_agent_Keyword as Keyword, ai_agent_MODEL_PRICING as MODEL_PRICING, type ai_agent_MergeResult as MergeResult, type ai_agent_MergeStrategy as MergeStrategy, type ai_agent_ModelPricing as ModelPricing, type ai_agent_PiiDetectResult as PiiDetectResult, type ai_agent_PiiFinding as PiiFinding, type ai_agent_PiiType as PiiType, type ai_agent_RankedChunk as RankedChunk, type ai_agent_RelevanceResult as RelevanceResult, type ai_agent_RetryBackoffAttempt as RetryBackoffAttempt, type ai_agent_RetryBackoffInput as RetryBackoffInput, type ai_agent_RetryBackoffResult as RetryBackoffResult, type ai_agent_RetryJitterMode as RetryJitterMode, type ai_agent_SanitizeResult as SanitizeResult, type ai_agent_SecretDetectResult as SecretDetectResult, type ai_agent_SecretFinding as SecretFinding, type ai_agent_SecretType as SecretType, type ai_agent_SummaryResult as SummaryResult, type ai_agent_TableResult2 as TableResult2, type ai_agent_TextChunk as TextChunk, type ai_agent_TokenEstimate as TokenEstimate, type ai_agent_TokenEstimateResult as TokenEstimateResult, type ai_agent_ToolSchemaIssue as ToolSchemaIssue, type ai_agent_ToolSchemaLintResult as ToolSchemaLintResult, type ai_agent_TrimResult as TrimResult, type ai_agent_TrimStrategy as TrimStrategy, type ai_agent_UrlMatch as UrlMatch, type ai_agent_ValidationError as ValidationError, type ai_agent_ValidationResult as ValidationResult, type ai_agent_VectorSimilarityResult as VectorSimilarityResult, ai_agent_calculateRetryBackoffSchedule as calculateRetryBackoffSchedule, ai_agent_chunkText as chunkText, ai_agent_compressHtml as compressHtml, ai_agent_compressJson as compressJson, ai_agent_compressMarkdown as compressMarkdown, ai_agent_deduplicateLines as deduplicateLines, ai_agent_detectPii as detectPii, ai_agent_detectPromptInjection as detectPromptInjection, ai_agent_detectSecrets as detectSecrets, ai_agent_diffJson as diffJson, ai_agent_estimateCost as estimateCost, ai_agent_estimateTokens as estimateTokens, ai_agent_expandQuery as expandQuery, ai_agent_extractEntities as extractEntities, ai_agent_extractJson as extractJson, ai_agent_extractKeywords as extractKeywords, ai_agent_extractTables as extractTables, ai_agent_extractUrls as extractUrls, ai_agent_flattenJson as flattenJson, ai_agent_formatFewShotExamples as formatFewShotExamples, ai_agent_lintToolSchema as lintToolSchema, ai_agent_mergeJson as mergeJson, ai_agent_redactPii as redactPii, ai_agent_repairJson as repairJson, ai_agent_rerankChunks as rerankChunks, ai_agent_sanitizeHtml as sanitizeHtml, ai_agent_scoreRelevance as scoreRelevance, ai_agent_summarizeForLlm as summarizeForLlm, ai_agent_trimToTokens as trimToTokens, ai_agent_unflattenJson as unflattenJson, ai_agent_validateJsonSchema as validateJsonSchema, ai_agent_vectorSimilarity as vectorSimilarity };
+  export { type ai_agent_ChunkStrategy as ChunkStrategy, type ai_agent_CompressHtmlResult as CompressHtmlResult, type ai_agent_CompressJsonResult as CompressJsonResult, type ai_agent_CompressMarkdownResult as CompressMarkdownResult, type ai_agent_CostEstimate as CostEstimate, type ai_agent_DedupeResult as DedupeResult, type ai_agent_DedupeStrategy as DedupeStrategy, type ai_agent_DiffEntry2 as DiffEntry2, type ai_agent_DiffOp2 as DiffOp2, type ai_agent_DiffResult2 as DiffResult2, type ai_agent_Entity2 as Entity2, type ai_agent_EntityType2 as EntityType2, type ai_agent_ExtractJsonResult as ExtractJsonResult, type ai_agent_ExtractKeywordsResult as ExtractKeywordsResult, type ai_agent_ExtractUrlsResult as ExtractUrlsResult, type ai_agent_FewShotExample as FewShotExample, type ai_agent_FewShotFormat as FewShotFormat, type ai_agent_FewShotFormatResult as FewShotFormatResult, type ai_agent_InjectionDetectResult as InjectionDetectResult, type ai_agent_InjectionFinding as InjectionFinding, type ai_agent_JsonBlock as JsonBlock, type ai_agent_JsonRepairResult as JsonRepairResult, type ai_agent_Keyword as Keyword, ai_agent_MODEL_PRICING as MODEL_PRICING, type ai_agent_MergeResult as MergeResult, type ai_agent_MergeStrategy as MergeStrategy, type ai_agent_ModelPricing as ModelPricing, type ai_agent_PiiDetectResult as PiiDetectResult, type ai_agent_PiiFinding as PiiFinding, type ai_agent_PiiType as PiiType, type ai_agent_PromptTemplateVariable as PromptTemplateVariable, type ai_agent_PromptTemplateVariableResult as PromptTemplateVariableResult, type ai_agent_RankedChunk as RankedChunk, type ai_agent_RelevanceResult as RelevanceResult, type ai_agent_RetryBackoffAttempt as RetryBackoffAttempt, type ai_agent_RetryBackoffInput as RetryBackoffInput, type ai_agent_RetryBackoffResult as RetryBackoffResult, type ai_agent_RetryJitterMode as RetryJitterMode, type ai_agent_SanitizeResult as SanitizeResult, type ai_agent_SecretDetectResult as SecretDetectResult, type ai_agent_SecretFinding as SecretFinding, type ai_agent_SecretType as SecretType, type ai_agent_SummaryResult as SummaryResult, type ai_agent_TableResult2 as TableResult2, type ai_agent_TextChunk as TextChunk, type ai_agent_TokenEstimate as TokenEstimate, type ai_agent_TokenEstimateResult as TokenEstimateResult, type ai_agent_ToolSchemaIssue as ToolSchemaIssue, type ai_agent_ToolSchemaLintResult as ToolSchemaLintResult, type ai_agent_TrimResult as TrimResult, type ai_agent_TrimStrategy as TrimStrategy, type ai_agent_UrlMatch as UrlMatch, type ai_agent_ValidationError as ValidationError, type ai_agent_ValidationResult as ValidationResult, type ai_agent_VectorSimilarityResult as VectorSimilarityResult, ai_agent_calculateRetryBackoffSchedule as calculateRetryBackoffSchedule, ai_agent_chunkText as chunkText, ai_agent_compressHtml as compressHtml, ai_agent_compressJson as compressJson, ai_agent_compressMarkdown as compressMarkdown, ai_agent_deduplicateLines as deduplicateLines, ai_agent_detectPii as detectPii, ai_agent_detectPromptInjection as detectPromptInjection, ai_agent_detectSecrets as detectSecrets, ai_agent_diffJson as diffJson, ai_agent_estimateCost as estimateCost, ai_agent_estimateTokens as estimateTokens, ai_agent_expandQuery as expandQuery, ai_agent_extractEntities as extractEntities, ai_agent_extractJson as extractJson, ai_agent_extractKeywords as extractKeywords, ai_agent_extractPromptTemplateVariables as extractPromptTemplateVariables, ai_agent_extractTables as extractTables, ai_agent_extractUrls as extractUrls, ai_agent_flattenJson as flattenJson, ai_agent_formatFewShotExamples as formatFewShotExamples, ai_agent_lintToolSchema as lintToolSchema, ai_agent_mergeJson as mergeJson, ai_agent_redactPii as redactPii, ai_agent_repairJson as repairJson, ai_agent_rerankChunks as rerankChunks, ai_agent_sanitizeHtml as sanitizeHtml, ai_agent_scoreRelevance as scoreRelevance, ai_agent_summarizeForLlm as summarizeForLlm, ai_agent_trimToTokens as trimToTokens, ai_agent_unflattenJson as unflattenJson, ai_agent_validateJsonSchema as validateJsonSchema, ai_agent_vectorSimilarity as vectorSimilarity };
 }
 
-export { type VectorSimilarityResult as $, type RetryJitterMode as A, type SecretDetectResult as B, type ChunkStrategy as C, type DedupeResult as D, type Entity2 as E, type FewShotExample as F, type SecretFinding as G, type SecretType as H, type InjectionDetectResult as I, type JsonBlock as J, type Keyword as K, type SummaryResult as L, MODEL_PRICING as M, type TextChunk as N, type TokenEstimate as O, type PiiDetectResult as P, type TokenEstimateResult as Q, type RankedChunk as R, type SanitizeResult as S, type TableResult2 as T, type ToolSchemaIssue as U, type ToolSchemaLintResult as V, type TrimResult as W, type TrimStrategy as X, type UrlMatch as Y, type ValidationError as Z, type ValidationResult as _, ai_agent as a, calculateRetryBackoffSchedule as a0, chunkText as a1, compressHtml as a2, compressJson as a3, compressMarkdown as a4, deduplicateLines as a5, detectPii as a6, detectPromptInjection as a7, detectSecrets as a8, diffJson as a9, estimateCost as aa, estimateTokens as ab, expandQuery as ac, extractEntities as ad, extractJson as ae, extractKeywords as af, extractTables as ag, extractUrls as ah, flattenJson as ai, formatFewShotExamples as aj, lintToolSchema as ak, mergeJson as al, redactPii as am, repairJson as an, rerankChunks as ao, sanitizeHtml as ap, scoreRelevance as aq, summarizeForLlm as ar, trimToTokens as as, unflattenJson as at, validateJsonSchema as au, vectorSimilarity as av, type CompressHtmlResult as b, type CompressJsonResult as c, type CompressMarkdownResult as d, type CostEstimate as e, type DedupeStrategy as f, type DiffEntry2 as g, type DiffOp2 as h, type DiffResult2 as i, type EntityType2 as j, type ExtractJsonResult as k, type ExtractKeywordsResult as l, type ExtractUrlsResult as m, type FewShotFormat as n, type FewShotFormatResult as o, type InjectionFinding as p, type JsonRepairResult as q, type MergeResult as r, type MergeStrategy as s, type ModelPricing as t, type PiiFinding as u, type PiiType as v, type RelevanceResult as w, type RetryBackoffAttempt as x, type RetryBackoffInput as y, type RetryBackoffResult as z };
+export { type ValidationError as $, type RetryBackoffInput as A, type RetryBackoffResult as B, type ChunkStrategy as C, type DedupeResult as D, type Entity2 as E, type FewShotExample as F, type RetryJitterMode as G, type SecretDetectResult as H, type InjectionDetectResult as I, type JsonBlock as J, type Keyword as K, type SecretFinding as L, MODEL_PRICING as M, type SecretType as N, type SummaryResult as O, type PiiDetectResult as P, type TextChunk as Q, type RankedChunk as R, type SanitizeResult as S, type TableResult2 as T, type TokenEstimate as U, type TokenEstimateResult as V, type ToolSchemaIssue as W, type ToolSchemaLintResult as X, type TrimResult as Y, type TrimStrategy as Z, type UrlMatch as _, ai_agent as a, type ValidationResult as a0, type VectorSimilarityResult as a1, calculateRetryBackoffSchedule as a2, chunkText as a3, compressHtml as a4, compressJson as a5, compressMarkdown as a6, deduplicateLines as a7, detectPii as a8, detectPromptInjection as a9, detectSecrets as aa, diffJson as ab, estimateCost as ac, estimateTokens as ad, expandQuery as ae, extractEntities as af, extractJson as ag, extractKeywords as ah, extractPromptTemplateVariables as ai, extractTables as aj, extractUrls as ak, flattenJson as al, formatFewShotExamples as am, lintToolSchema as an, mergeJson as ao, redactPii as ap, repairJson as aq, rerankChunks as ar, sanitizeHtml as as, scoreRelevance as at, summarizeForLlm as au, trimToTokens as av, unflattenJson as aw, validateJsonSchema as ax, vectorSimilarity as ay, type CompressHtmlResult as b, type CompressJsonResult as c, type CompressMarkdownResult as d, type CostEstimate as e, type DedupeStrategy as f, type DiffEntry2 as g, type DiffOp2 as h, type DiffResult2 as i, type EntityType2 as j, type ExtractJsonResult as k, type ExtractKeywordsResult as l, type ExtractUrlsResult as m, type FewShotFormat as n, type FewShotFormatResult as o, type InjectionFinding as p, type JsonRepairResult as q, type MergeResult as r, type MergeStrategy as s, type ModelPricing as t, type PiiFinding as u, type PiiType as v, type PromptTemplateVariable as w, type PromptTemplateVariableResult as x, type RelevanceResult as y, type RetryBackoffAttempt as z };

package/dist/{chunk-HJLGUNSO.js → chunk-5VVC7BHS.js}

@@ -20,6 +20,7 @@ __export(ai_agent_exports, {
   extractEntities: () => extractEntities,
   extractJson: () => extractJson,
   extractKeywords: () => extractKeywords,
+  extractPromptTemplateVariables: () => extractPromptTemplateVariables,
   extractTables: () => extractTables,
   extractUrls: () => extractUrls,
   flattenJson: () => flattenJson,
@@ -1173,5 +1174,44 @@ function calculateRetryBackoffSchedule(input) {
     totalWorstCaseMs: round0(totalWorstCaseMs)
   };
 }
+var PROMPT_TEMPLATE_VARIABLE_REGEX = /\{\{\s*([a-zA-Z0-9_.-]+)\s*\}\}/g;
+function extractPromptTemplateVariables(template, providedVars) {
+  const trimmed = template.trim();
+  if (!trimmed) return { error: "Empty input" };
+  const order = [];
+  const counts = /* @__PURE__ */ new Map();
+  for (const m of template.matchAll(PROMPT_TEMPLATE_VARIABLE_REGEX)) {
+    const name = m[1];
+    if (!counts.has(name)) {
+      counts.set(name, 0);
+      order.push(name);
+    }
+    counts.set(name, (counts.get(name) ?? 0) + 1);
+  }
+  if (order.length === 0) return { error: "No {{variable}} placeholders found" };
+  const variables = order.map((name) => ({ name, count: counts.get(name) ?? 0 }));
+  const duplicates = order.filter((name) => (counts.get(name) ?? 0) > 1);
+  let missing = [];
+  const unused = [];
+  if (providedVars !== void 0) {
+    const providedSet = new Set(providedVars.map((v) => v.trim()).filter(Boolean));
+    const usedSet = new Set(order);
+    missing = order.filter((name) => !providedSet.has(name));
+    const seenProvided = /* @__PURE__ */ new Set();
+    for (const raw of providedVars) {
+      const v = raw.trim();
+      if (!v || usedSet.has(v) || seenProvided.has(v)) continue;
+      seenProvided.add(v);
+      unused.push(v);
+    }
+  }
+  return {
+    variableCount: order.length,
+    variables,
+    duplicates,
+    missing,
+    unused
+  };
+}
 
-export { MODEL_PRICING, ai_agent_exports, calculateRetryBackoffSchedule, chunkText, compressHtml, compressJson, compressMarkdown, deduplicateLines, detectPii, detectPromptInjection, detectSecrets, diffJson, estimateCost, estimateTokens, expandQuery, extractEntities, extractJson, extractKeywords, extractTables, extractUrls, flattenJson, formatFewShotExamples, lintToolSchema, mergeJson, redactPii, repairJson, rerankChunks, sanitizeHtml, scoreRelevance, summarizeForLlm, trimToTokens, unflattenJson, validateJsonSchema, vectorSimilarity };
+export { MODEL_PRICING, ai_agent_exports, calculateRetryBackoffSchedule, chunkText, compressHtml, compressJson, compressMarkdown, deduplicateLines, detectPii, detectPromptInjection, detectSecrets, diffJson, estimateCost, estimateTokens, expandQuery, extractEntities, extractJson, extractKeywords, extractPromptTemplateVariables, extractTables, extractUrls, flattenJson, formatFewShotExamples, lintToolSchema, mergeJson, redactPii, repairJson, rerankChunks, sanitizeHtml, scoreRelevance, summarizeForLlm, trimToTokens, unflattenJson, validateJsonSchema, vectorSimilarity };

package/dist/{chunk-IEPWZERQ.js → chunk-6EJVNQSY.js}

@@ -8,6 +8,7 @@ __export(time_exports, {
   TIMEZONES: () => TIMEZONES,
   convertTime: () => convertTime,
   diffDates: () => diffDates,
+  findCronOverlaps: () => findCronOverlaps,
   formatInTimezone: () => formatInTimezone,
   formatIso8601Duration: () => formatIso8601Duration,
   formatRelative: () => formatRelative,
@@ -683,6 +684,42 @@ function getRunInterval(dates) {
   const days = Math.round(diffMins / 1440);
   return `Every ${days} days`;
 }
+var MAX_CRON_OVERLAPS = 200;
+function findCronOverlaps(expressions, windowDays = 30, fromDate) {
+  if (expressions.length < 2) return { error: "Provide at least two cron expressions to check for overlaps" };
+  if (expressions.length > 10) return { error: "Provide 10 or fewer cron expressions" };
+  if (windowDays < 1 || windowDays > 365) return { error: "windowDays must be between 1 and 365" };
+  const parsedList = [];
+  for (let i = 0; i < expressions.length; i++) {
+    const parsed = parseCronExpression(expressions[i]);
+    if (typeof parsed === "object" && "error" in parsed) {
+      return { error: `Expression ${i + 1} ("${expressions[i]}"): ${parsed.error}` };
+    }
+    parsedList.push(parsed);
+  }
+  const start = fromDate ? new Date(fromDate) : /* @__PURE__ */ new Date();
+  const cursor = new Date(start);
+  cursor.setSeconds(0, 0);
+  cursor.setMinutes(cursor.getMinutes() + 1);
+  const endTime = cursor.getTime() + windowDays * 24 * 60 * 60 * 1e3;
+  const overlaps = [];
+  let truncated = false;
+  while (cursor.getTime() < endTime) {
+    const matched = [];
+    for (let i = 0; i < parsedList.length; i++) {
+      if (matchesCron(cursor, parsedList[i])) matched.push(i);
+    }
+    if (matched.length >= 2) {
+      if (overlaps.length >= MAX_CRON_OVERLAPS) {
+        truncated = true;
+        break;
+      }
+      overlaps.push({ date: new Date(cursor), expressionIndexes: matched });
+    }
+    cursor.setMinutes(cursor.getMinutes() + 1);
+  }
+  return { overlaps, windowDays, truncated };
+}
 var DURATION_SECONDS_PER_YEAR = 365 * 86400;
 var DURATION_SECONDS_PER_MONTH = 30 * 86400;
 function humanizeDurationParts(parts) {
@@ -775,4 +812,4 @@ function formatIso8601Duration(seconds) {
   };
 }
 
-export { COMMON_CRONS, COMMON_DATE_PRESETS, TIMEZONES, convertTime, diffDates, formatInTimezone, formatIso8601Duration, formatRelative, formatRunDate, fromIsoString, fromUnix, getAllZonesForTime, getNextRuns, getNow, getRunInterval, getTimezoneOffset, humanizeDiff, parseCron, parseCronExpression, parseDate, parseIso8601Duration, time_exports };
+export { COMMON_CRONS, COMMON_DATE_PRESETS, TIMEZONES, convertTime, diffDates, findCronOverlaps, formatInTimezone, formatIso8601Duration, formatRelative, formatRunDate, fromIsoString, fromUnix, getAllZonesForTime, getNextRuns, getNow, getRunInterval, getTimezoneOffset, humanizeDiff, parseCron, parseCronExpression, parseDate, parseIso8601Duration, time_exports };

package/dist/{chunk-FPFA4ZHC.js → chunk-RMXZMYSG.js}

@@ -27,6 +27,7 @@ __export(code_exports, {
   envToExport: () => envToExport,
   envToJson: () => envToJson,
   extractMarkdownFootnotes: () => extractMarkdownFootnotes,
+  extractMarkdownLinkReferences: () => extractMarkdownLinkReferences,
   extractSvgSpriteSymbols: () => extractSvgSpriteSymbols,
   formatCss: () => formatCss,
   formatGql: () => formatGql,
@@ -38,6 +39,7 @@ __export(code_exports, {
   getMethodColor: () => getMethodColor,
   isValidTag: () => isValidTag,
   lintConventionalCommit: () => lintConventionalCommit,
+  lintDockerfile: () => lintDockerfile,
   lookupMime: () => lookupMime,
   minifyCss: () => minifyCss,
   minifyGql: () => minifyGql,
@@ -1868,6 +1870,111 @@ function normalizeRef(ref) {
   const tagPart = parsed.digest ? `@${parsed.digest}` : parsed.tag ? `:${parsed.tag}` : "";
   return `${parsed.registry}/${ns}${parsed.repository}${tagPart}`;
 }
+function _parseDockerfileInstructions(content) {
+  const rawLines = content.replace(/\r\n/g, "\n").split("\n");
+  const instructions = [];
+  let buffer = "";
+  let bufferStartLine = 0;
+  for (let i = 0; i < rawLines.length; i++) {
+    const lineNo = i + 1;
+    const line = rawLines[i];
+    const trimmed = line.trim();
+    if (buffer === "") {
+      if (trimmed === "" || trimmed.startsWith("#")) continue;
+      bufferStartLine = lineNo;
+      buffer = line.trimEnd();
+    } else {
+      buffer += "\n" + line.trimEnd();
+    }
+    if (buffer.endsWith("\\")) {
+      buffer = buffer.slice(0, -1);
+      continue;
+    }
+    const match = buffer.trim().match(/^([A-Za-z]+)\s*([\s\S]*)$/);
+    if (match) {
+      instructions.push({ instruction: match[1].toUpperCase(), args: match[2].trim(), line: bufferStartLine });
+    }
+    buffer = "";
+  }
+  return instructions;
+}
+var _DOCKERFILE_TAR_RE = /\.(tar(\.(gz|bz2|xz))?|tgz|tbz2|txz)$/i;
+function lintDockerfile(content) {
+  if (!content || !content.trim()) return { error: "Dockerfile content is required" };
+  const instructions = _parseDockerfileInstructions(content);
+  if (instructions.length === 0) return { error: "No Dockerfile instructions found" };
+  const fromInstructions = instructions.filter((i) => i.instruction === "FROM");
+  if (fromInstructions.length === 0) return { error: "No FROM instruction found; this does not look like a valid Dockerfile" };
+  const stageNames = /* @__PURE__ */ new Set();
+  const stages = fromInstructions.map((inst, idx) => {
+    const asMatch = inst.args.match(/^(\S+)(?:\s+AS\s+(\S+))?/i);
+    const baseImage = asMatch ? asMatch[1] : inst.args.split(/\s+/)[0];
+    const name = asMatch && asMatch[2] ? asMatch[2] : null;
+    if (name) stageNames.add(name.toLowerCase());
+    return { index: idx, name, baseImage, fromLine: inst.line };
+  });
+  const findings = [];
+  for (const stage of stages) {
+    const base = stage.baseImage;
+    if (base.toLowerCase() === "scratch") continue;
+    if (stageNames.has(base.toLowerCase())) continue;
+    const withoutDigest = base.split("@")[0];
+    const hasTag = withoutDigest.includes(":");
+    const tag = hasTag ? withoutDigest.split(":").pop() : null;
+    if (!hasTag) {
+      findings.push({
+        rule: "unpinned-base-image",
+        severity: "warning",
+        line: stage.fromLine,
+        message: `FROM ${base} has no tag, so it resolves to ":latest", which can silently change what gets built on a future run. Pin an explicit version tag instead.`
+      });
+    } else if (tag === "latest") {
+      findings.push({
+        rule: "unpinned-base-image",
+        severity: "warning",
+        line: stage.fromLine,
+        message: `FROM ${base} is explicitly pinned to the "latest" tag, which is a moving target rather than a fixed version. Pin an explicit version tag instead.`
+      });
+    }
+  }
+  const finalStage = stages[stages.length - 1];
+  const finalStageInstructions = instructions.filter((i) => i.line >= finalStage.fromLine);
+  if (!finalStageInstructions.some((i) => i.instruction === "WORKDIR")) {
+    findings.push({
+      rule: "missing-workdir",
+      severity: "warning",
+      line: finalStage.fromLine,
+      message: 'No WORKDIR instruction in the final stage, so RUN/CMD/ENTRYPOINT execute from "/" by default. Set an explicit WORKDIR.'
+    });
+  }
+  if (!finalStageInstructions.some((i) => i.instruction === "USER")) {
+    findings.push({
+      rule: "running-as-root",
+      severity: "warning",
+      line: finalStage.fromLine,
+      message: "No USER instruction in the final stage, so the container runs as root by default. Add a non-root USER unless root is genuinely required."
+    });
+  }
+  for (const inst of instructions) {
+    if (inst.instruction !== "ADD") continue;
+    const parts = inst.args.split(/\s+/).filter(Boolean).filter((p) => !p.startsWith("--"));
+    if (parts.length < 2) continue;
+    const sources = parts.slice(0, -1);
+    for (const src of sources) {
+      const isUrl = /^https?:\/\//i.test(src);
+      const isTar = _DOCKERFILE_TAR_RE.test(src);
+      if (!isUrl && !isTar) {
+        findings.push({
+          rule: "add-vs-copy",
+          severity: "info",
+          line: inst.line,
+          message: `ADD ${src} copies a local file/directory, not a URL or an auto-extracting archive. Use COPY instead, since ADD's extra behavior (remote fetch, tar auto-extract) doesn't apply here.`
+        });
+      }
+    }
+  }
+  return { findings, stages };
+}
 function removeJsComments(code) {
   let result = "";
   let i = 0;
@@ -4268,5 +4375,63 @@ function countSqlPlaceholders(sql) {
     numberedDuplicates
   };
 }
+var LINK_REF_DEFINITION_REGEX = /^ {0,3}\[([^\]]+)\]:\s*(\S+)(?:\s+(?:"([^"]*)"|'([^']*)'|\(([^)]*)\)))?\s*$/;
+var LINK_REF_USAGE_REGEX = /(!?)\[([^[\]\n]*)\]\[([^[\]\n]*)\]/g;
+function normalizeLinkLabel(label) {
+  return label.trim().replace(/\s+/g, " ").toLowerCase();
+}
+function extractMarkdownLinkReferences(markdown) {
+  const trimmed = markdown.trim();
+  if (!trimmed) return { error: "Empty input" };
+  const lines = markdown.replace(/\r\n/g, "\n").split("\n");
+  const definitions = [];
+  const definitionsByLabel = /* @__PURE__ */ new Map();
+  for (const line of lines) {
+    const match = line.match(LINK_REF_DEFINITION_REGEX);
+    if (!match) continue;
+    const label = match[1];
+    const normalized = normalizeLinkLabel(label);
+    if (definitionsByLabel.has(normalized)) continue;
+    const def = {
+      label,
+      url: match[2],
+      title: match[3] ?? match[4] ?? match[5] ?? void 0
+    };
+    definitionsByLabel.set(normalized, def);
+    definitions.push(def);
+  }
+  const usages = [];
+  for (const m of markdown.matchAll(LINK_REF_USAGE_REGEX)) {
+    const image = m[1] === "!";
+    const text = m[2];
+    const rawRef = m[3];
+    const label = rawRef.trim() === "" ? text : rawRef;
+    usages.push({ text, label, image });
+  }
+  if (definitions.length === 0 && usages.length === 0) {
+    return { error: "No reference-style links or definitions found" };
+  }
+  const usedLabels = /* @__PURE__ */ new Set();
+  const resolved = [];
+  const unresolvedReferences = [];
+  for (const usage of usages) {
+    const normalized = normalizeLinkLabel(usage.label);
+    const def = definitionsByLabel.get(normalized);
+    if (def) {
+      usedLabels.add(normalized);
+      resolved.push({ ...usage, url: def.url, title: def.title });
+    } else {
+      unresolvedReferences.push(usage);
+    }
+  }
+  const unusedDefinitions = definitions.filter((d) => !usedLabels.has(normalizeLinkLabel(d.label)));
+  return {
+    referenceCount: usages.length,
+    definitionCount: definitions.length,
+    resolved,
+    unresolvedReferences,
+    unusedDefinitions
+  };
+}
 
-export { ALL_FLAGS, CHEATSHEET, DEFAULT_COMMIT_TYPES, KNOWN_LANGUAGE_TAGS, MIME_TABLE, OPERATIONS, SQL_DEFAULT_OPTIONS, analyzeRegexGroups, auditDependencyRanges, buildDockerPull, buildDockerRun, buildGitCommand, code_exports, collapseHtmlWhitespace, collapseJsWhitespace, countProperties, countRules, countSqlPlaceholders, detectDialect, detectOperationType, detectRedos, envToExport, envToJson, extractMarkdownFootnotes, extractSvgSpriteSymbols, formatCss, formatGql, formatHtml, formatSql, getEndpointsByTag, getHtmlStats, getJsStats, getMethodColor, isValidTag, lintConventionalCommit, lookupMime, minifyCss, minifyGql, minifyHtml, minifyJs, minifySql, normalizeRef, parseCommitTrailers, parseConnectionString, parseDockerImage, parseEnv, parseGitCommand, parseGithubUrl, parseSpec, removeConsoleCalls, removeEmptyAttributes, removeHtmlComments, removeJsComments, removeRedundantAttributes, searchCheatsheet, searchEndpoints, splitStatements, testGitignorePatterns, testPattern, testRegex, validateAria, validateEditorConfig, validateEnvKey, validateFenceLanguageTags, validatePackageExports, validateTsconfig };
+export { ALL_FLAGS, CHEATSHEET, DEFAULT_COMMIT_TYPES, KNOWN_LANGUAGE_TAGS, MIME_TABLE, OPERATIONS, SQL_DEFAULT_OPTIONS, analyzeRegexGroups, auditDependencyRanges, buildDockerPull, buildDockerRun, buildGitCommand, code_exports, collapseHtmlWhitespace, collapseJsWhitespace, countProperties, countRules, countSqlPlaceholders, detectDialect, detectOperationType, detectRedos, envToExport, envToJson, extractMarkdownFootnotes, extractMarkdownLinkReferences, extractSvgSpriteSymbols, formatCss, formatGql, formatHtml, formatSql, getEndpointsByTag, getHtmlStats, getJsStats, getMethodColor, isValidTag, lintConventionalCommit, lintDockerfile, lookupMime, minifyCss, minifyGql, minifyHtml, minifyJs, minifySql, normalizeRef, parseCommitTrailers, parseConnectionString, parseDockerImage, parseEnv, parseGitCommand, parseGithubUrl, parseSpec, removeConsoleCalls, removeEmptyAttributes, removeHtmlComments, removeJsComments, removeRedundantAttributes, searchCheatsheet, searchEndpoints, splitStatements, testGitignorePatterns, testPattern, testRegex, validateAria, validateEditorConfig, validateEnvKey, validateFenceLanguageTags, validatePackageExports, validateTsconfig };