sniff-qa 0.3.0 → 0.4.0

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.
Files changed (34) hide show
  1. package/README.md +41 -0
  2. package/dist/classifier-XEA6ZGE7.js +673 -0
  3. package/dist/classifier-XEA6ZGE7.js.map +1 -0
  4. package/dist/cli/index.js +80 -4
  5. package/dist/cli/index.js.map +1 -1
  6. package/dist/discover-BLUSO42Q.js +228 -0
  7. package/dist/discover-BLUSO42Q.js.map +1 -0
  8. package/dist/domain-UQ34YE4B.js +1817 -0
  9. package/dist/domain-UQ34YE4B.js.map +1 -0
  10. package/dist/edge-cases-ZADKDZHL.js +246 -0
  11. package/dist/edge-cases-ZADKDZHL.js.map +1 -0
  12. package/dist/flakiness-OLJAY7CS.js +53 -0
  13. package/dist/flakiness-OLJAY7CS.js.map +1 -0
  14. package/dist/llm-VJAI6H6G.js +126 -0
  15. package/dist/llm-VJAI6H6G.js.map +1 -0
  16. package/dist/mcp/server.js +89 -0
  17. package/dist/mcp/server.js.map +1 -1
  18. package/dist/persistence-KTCRIGHU.js +270 -0
  19. package/dist/persistence-KTCRIGHU.js.map +1 -0
  20. package/dist/{repo-analyzer-WK5WP7NT.js → repo-analyzer-4OURSITY.js} +1 -1
  21. package/dist/report-SDZWX25B.js +280 -0
  22. package/dist/report-SDZWX25B.js.map +1 -0
  23. package/dist/{report-WLDV72FM.js → report-STC6CAVJ.js} +1 -1
  24. package/dist/runner-OYTN2NFD.js +996 -0
  25. package/dist/runner-OYTN2NFD.js.map +1 -0
  26. package/dist/scenarios-25UAZY6F.js +982 -0
  27. package/dist/scenarios-25UAZY6F.js.map +1 -0
  28. package/dist/tiebreak-L5UFNKU2.js +60 -0
  29. package/dist/tiebreak-L5UFNKU2.js.map +1 -0
  30. package/dist/{unified-7RKNG3EI.js → unified-2PM442OY.js} +2 -2
  31. package/package.json +1 -1
  32. /package/dist/{repo-analyzer-WK5WP7NT.js.map → repo-analyzer-4OURSITY.js.map} +0 -0
  33. /package/dist/{report-WLDV72FM.js.map → report-STC6CAVJ.js.map} +0 -0
  34. /package/dist/{unified-7RKNG3EI.js.map → unified-2PM442OY.js.map} +0 -0
@@ -0,0 +1,53 @@
1
+ import {
2
+ computeFlakeStatus
3
+ } from "./chunk-ZM6MGWO4.js";
4
+
5
+ // src/discovery/report/flakiness.ts
6
+ function buildScenarioTestId(scenarioId, baseUrl) {
7
+ return `discovery::${scenarioId}::${baseUrl}`;
8
+ }
9
+ function buildScenarioTestRunRecords(report, runId, baseUrl) {
10
+ const timestamp = (/* @__PURE__ */ new Date()).toISOString();
11
+ const records = [];
12
+ for (const result of report.scenarios) {
13
+ if (result.status === "skip") continue;
14
+ records.push({
15
+ runId,
16
+ timestamp,
17
+ testId: buildScenarioTestId(result.scenario.id, baseUrl),
18
+ passed: result.status === "pass",
19
+ duration: result.durationMs
20
+ });
21
+ }
22
+ return records;
23
+ }
24
+ function markQuarantinedScenarios(report, history, baseUrl, options = {}) {
25
+ const windowSize = options.windowSize ?? 5;
26
+ const threshold = options.threshold ?? 3;
27
+ const scenarios = report.scenarios.map((result) => {
28
+ if (result.status !== "fail") return result;
29
+ const testId = buildScenarioTestId(result.scenario.id, baseUrl);
30
+ const flake = computeFlakeStatus(history, testId, windowSize, threshold);
31
+ if (!flake.isFlaky) return result;
32
+ return {
33
+ ...result,
34
+ quarantined: true,
35
+ quarantineReason: `quarantined: ${flake.failureCount}/${flake.runCount} recent runs failed`
36
+ };
37
+ });
38
+ const stats = {
39
+ ...report.stats,
40
+ quarantined: scenarios.filter((s) => s.quarantined === true).length
41
+ };
42
+ return { ...report, scenarios, stats };
43
+ }
44
+ function shouldFailCi(report) {
45
+ return report.scenarios.some((s) => s.status === "fail" && s.quarantined !== true);
46
+ }
47
+ export {
48
+ buildScenarioTestId,
49
+ buildScenarioTestRunRecords,
50
+ markQuarantinedScenarios,
51
+ shouldFailCi
52
+ };
53
+ //# sourceMappingURL=flakiness-OLJAY7CS.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/discovery/report/flakiness.ts"],"sourcesContent":["import type { FlakinessHistory, TestRunRecord } from '../../core/types.js';\nimport { computeFlakeStatus } from '../../core/flakiness.js';\nimport type { DiscoveryReport, ScenarioResult } from '../run-types.js';\n\nexport function buildScenarioTestId(scenarioId: string, baseUrl: string): string {\n return `discovery::${scenarioId}::${baseUrl}`;\n}\n\nexport function buildScenarioTestRunRecords(\n report: DiscoveryReport,\n runId: string,\n baseUrl: string,\n): TestRunRecord[] {\n const timestamp = new Date().toISOString();\n const records: TestRunRecord[] = [];\n\n for (const result of report.scenarios) {\n if (result.status === 'skip') continue;\n records.push({\n runId,\n timestamp,\n testId: buildScenarioTestId(result.scenario.id, baseUrl),\n passed: result.status === 'pass',\n duration: result.durationMs,\n });\n }\n\n return records;\n}\n\nexport interface QuarantineOptions {\n windowSize?: number;\n threshold?: number;\n}\n\nexport function markQuarantinedScenarios(\n report: DiscoveryReport,\n history: FlakinessHistory,\n baseUrl: string,\n options: QuarantineOptions = {},\n): DiscoveryReport {\n const windowSize = options.windowSize ?? 5;\n const threshold = options.threshold ?? 3;\n\n const scenarios: ScenarioResult[] = report.scenarios.map((result) => {\n if (result.status !== 'fail') return result;\n const testId = buildScenarioTestId(result.scenario.id, baseUrl);\n const flake = computeFlakeStatus(history, testId, windowSize, threshold);\n if (!flake.isFlaky) return result;\n return {\n ...result,\n quarantined: true,\n quarantineReason: `quarantined: ${flake.failureCount}/${flake.runCount} recent runs failed`,\n };\n });\n\n const stats = {\n ...report.stats,\n quarantined: scenarios.filter((s) => s.quarantined === true).length,\n };\n\n return { ...report, scenarios, stats };\n}\n\nexport function shouldFailCi(report: DiscoveryReport): boolean {\n return report.scenarios.some((s) => s.status === 'fail' && s.quarantined !== true);\n}\n"],"mappings":";;;;;AAIO,SAAS,oBAAoB,YAAoB,SAAyB;AAC/E,SAAO,cAAc,UAAU,KAAK,OAAO;AAC7C;AAEO,SAAS,4BACd,QACA,OACA,SACiB;AACjB,QAAM,aAAY,oBAAI,KAAK,GAAE,YAAY;AACzC,QAAM,UAA2B,CAAC;AAElC,aAAW,UAAU,OAAO,WAAW;AACrC,QAAI,OAAO,WAAW,OAAQ;AAC9B,YAAQ,KAAK;AAAA,MACX;AAAA,MACA;AAAA,MACA,QAAQ,oBAAoB,OAAO,SAAS,IAAI,OAAO;AAAA,MACvD,QAAQ,OAAO,WAAW;AAAA,MAC1B,UAAU,OAAO;AAAA,IACnB,CAAC;AAAA,EACH;AAEA,SAAO;AACT;AAOO,SAAS,yBACd,QACA,SACA,SACA,UAA6B,CAAC,GACb;AACjB,QAAM,aAAa,QAAQ,cAAc;AACzC,QAAM,YAAY,QAAQ,aAAa;AAEvC,QAAM,YAA8B,OAAO,UAAU,IAAI,CAAC,WAAW;AACnE,QAAI,OAAO,WAAW,OAAQ,QAAO;AACrC,UAAM,SAAS,oBAAoB,OAAO,SAAS,IAAI,OAAO;AAC9D,UAAM,QAAQ,mBAAmB,SAAS,QAAQ,YAAY,SAAS;AACvE,QAAI,CAAC,MAAM,QAAS,QAAO;AAC3B,WAAO;AAAA,MACL,GAAG;AAAA,MACH,aAAa;AAAA,MACb,kBAAkB,gBAAgB,MAAM,YAAY,IAAI,MAAM,QAAQ;AAAA,IACxE;AAAA,EACF,CAAC;AAED,QAAM,QAAQ;AAAA,IACZ,GAAG,OAAO;AAAA,IACV,aAAa,UAAU,OAAO,CAAC,MAAM,EAAE,gBAAgB,IAAI,EAAE;AAAA,EAC/D;AAEA,SAAO,EAAE,GAAG,QAAQ,WAAW,MAAM;AACvC;AAEO,SAAS,aAAa,QAAkC;AAC7D,SAAO,OAAO,UAAU,KAAK,CAAC,MAAM,EAAE,WAAW,UAAU,EAAE,gBAAgB,IAAI;AACnF;","names":[]}
@@ -0,0 +1,126 @@
1
+ // src/discovery/llm/cache.ts
2
+ import { createHash } from "crypto";
3
+ import { mkdir, readFile, writeFile } from "fs/promises";
4
+ import { join } from "path";
5
+ function keyFor(system, user, purpose) {
6
+ return createHash("sha256").update(`${purpose}::${system}::${user}`, "utf-8").digest("hex");
7
+ }
8
+ async function readLlmCache(input) {
9
+ const key = keyFor(input.system, input.user, input.purpose);
10
+ const path = join(input.rootDir, input.cacheDir, `${key}.json`);
11
+ try {
12
+ const raw = await readFile(path, "utf-8");
13
+ const parsed = JSON.parse(raw);
14
+ return typeof parsed.response === "string" ? parsed.response : null;
15
+ } catch {
16
+ return null;
17
+ }
18
+ }
19
+ async function writeLlmCache(input, response) {
20
+ const key = keyFor(input.system, input.user, input.purpose);
21
+ const dir = join(input.rootDir, input.cacheDir);
22
+ await mkdir(dir, { recursive: true });
23
+ const path = join(dir, `${key}.json`);
24
+ await writeFile(
25
+ path,
26
+ JSON.stringify({ purpose: input.purpose, response, cachedAt: (/* @__PURE__ */ new Date()).toISOString() }, null, 2),
27
+ "utf-8"
28
+ );
29
+ }
30
+
31
+ // src/discovery/llm/cached-provider.ts
32
+ var CachedDiscoveryLLM = class {
33
+ constructor(inner, options) {
34
+ this.inner = inner;
35
+ this.options = options;
36
+ this.name = `${inner.name}+cache`;
37
+ }
38
+ inner;
39
+ options;
40
+ name;
41
+ available() {
42
+ return this.inner.available();
43
+ }
44
+ async complete(request) {
45
+ const hit = await readLlmCache({
46
+ rootDir: this.options.rootDir,
47
+ cacheDir: this.options.cacheDir,
48
+ system: request.system,
49
+ user: request.user,
50
+ purpose: request.purpose
51
+ });
52
+ if (hit !== null) return hit;
53
+ const fresh = await this.inner.complete(request);
54
+ await writeLlmCache(
55
+ {
56
+ rootDir: this.options.rootDir,
57
+ cacheDir: this.options.cacheDir,
58
+ system: request.system,
59
+ user: request.user,
60
+ purpose: request.purpose
61
+ },
62
+ fresh
63
+ );
64
+ return fresh;
65
+ }
66
+ };
67
+
68
+ // src/discovery/llm/claude-code.ts
69
+ import { execFile as execFileCb } from "child_process";
70
+ import { promisify } from "util";
71
+ var execFile = promisify(execFileCb);
72
+ var ClaudeCodeLLM = class {
73
+ name = "claude-code-cli";
74
+ cliPath;
75
+ timeoutMs;
76
+ maxBufferBytes;
77
+ constructor(options = {}) {
78
+ this.cliPath = options.cliPath ?? "claude";
79
+ this.timeoutMs = options.timeoutMs ?? 6e4;
80
+ this.maxBufferBytes = options.maxBufferBytes ?? 1024 * 1024 * 2;
81
+ }
82
+ async available() {
83
+ try {
84
+ await execFile(this.cliPath, ["--version"], { timeout: 3e3, maxBuffer: 1024 * 64 });
85
+ return true;
86
+ } catch {
87
+ return false;
88
+ }
89
+ }
90
+ async complete(request) {
91
+ const { stdout } = await execFile(
92
+ this.cliPath,
93
+ [
94
+ "--print",
95
+ "--output-format",
96
+ "json",
97
+ "--system-prompt",
98
+ request.system,
99
+ request.user
100
+ ],
101
+ { timeout: this.timeoutMs, maxBuffer: this.maxBufferBytes }
102
+ );
103
+ try {
104
+ const parsed = JSON.parse(stdout);
105
+ return typeof parsed.result === "string" ? parsed.result : stdout;
106
+ } catch {
107
+ return stdout;
108
+ }
109
+ }
110
+ };
111
+
112
+ // src/discovery/llm/index.ts
113
+ async function resolveDiscoveryLLM(options) {
114
+ const inner = new ClaudeCodeLLM(options.cliPath ? { cliPath: options.cliPath } : {});
115
+ if (!await inner.available()) return null;
116
+ return new CachedDiscoveryLLM(inner, { rootDir: options.rootDir, cacheDir: options.cacheDir });
117
+ }
118
+ export {
119
+ CachedDiscoveryLLM,
120
+ ClaudeCodeLLM,
121
+ keyFor as cacheKeyFor,
122
+ readLlmCache,
123
+ resolveDiscoveryLLM,
124
+ writeLlmCache
125
+ };
126
+ //# sourceMappingURL=llm-VJAI6H6G.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/discovery/llm/cache.ts","../src/discovery/llm/cached-provider.ts","../src/discovery/llm/claude-code.ts","../src/discovery/llm/index.ts"],"sourcesContent":["import { createHash } from 'node:crypto';\nimport { mkdir, readFile, writeFile } from 'node:fs/promises';\nimport { join } from 'node:path';\n\nfunction keyFor(system: string, user: string, purpose: string): string {\n return createHash('sha256').update(`${purpose}::${system}::${user}`, 'utf-8').digest('hex');\n}\n\nexport interface CacheLookupInput {\n rootDir: string;\n cacheDir: string;\n system: string;\n user: string;\n purpose: string;\n}\n\nexport async function readLlmCache(input: CacheLookupInput): Promise<string | null> {\n const key = keyFor(input.system, input.user, input.purpose);\n const path = join(input.rootDir, input.cacheDir, `${key}.json`);\n try {\n const raw = await readFile(path, 'utf-8');\n const parsed = JSON.parse(raw) as { response?: string };\n return typeof parsed.response === 'string' ? parsed.response : null;\n } catch {\n return null;\n }\n}\n\nexport async function writeLlmCache(input: CacheLookupInput, response: string): Promise<void> {\n const key = keyFor(input.system, input.user, input.purpose);\n const dir = join(input.rootDir, input.cacheDir);\n await mkdir(dir, { recursive: true });\n const path = join(dir, `${key}.json`);\n await writeFile(\n path,\n JSON.stringify({ purpose: input.purpose, response, cachedAt: new Date().toISOString() }, null, 2),\n 'utf-8',\n );\n}\n\nexport { keyFor as cacheKeyFor };\n","import { readLlmCache, writeLlmCache } from './cache.js';\nimport type { DiscoveryLLM, LLMCompleteRequest } from './types.js';\n\nexport interface CachedProviderOptions {\n rootDir: string;\n cacheDir: string;\n}\n\nexport class CachedDiscoveryLLM implements DiscoveryLLM {\n readonly name: string;\n\n constructor(private readonly inner: DiscoveryLLM, private readonly options: CachedProviderOptions) {\n this.name = `${inner.name}+cache`;\n }\n\n available(): Promise<boolean> {\n return this.inner.available();\n }\n\n async complete(request: LLMCompleteRequest): Promise<string> {\n const hit = await readLlmCache({\n rootDir: this.options.rootDir,\n cacheDir: this.options.cacheDir,\n system: request.system,\n user: request.user,\n purpose: request.purpose,\n });\n if (hit !== null) return hit;\n\n const fresh = await this.inner.complete(request);\n await writeLlmCache(\n {\n rootDir: this.options.rootDir,\n cacheDir: this.options.cacheDir,\n system: request.system,\n user: request.user,\n purpose: request.purpose,\n },\n fresh,\n );\n return fresh;\n }\n}\n","import { execFile as execFileCb } from 'node:child_process';\nimport { promisify } from 'node:util';\nimport type { DiscoveryLLM, LLMCompleteRequest } from './types.js';\n\nconst execFile = promisify(execFileCb);\n\nexport interface ClaudeCodeLLMOptions {\n cliPath?: string;\n timeoutMs?: number;\n maxBufferBytes?: number;\n}\n\nexport class ClaudeCodeLLM implements DiscoveryLLM {\n readonly name = 'claude-code-cli';\n private readonly cliPath: string;\n private readonly timeoutMs: number;\n private readonly maxBufferBytes: number;\n\n constructor(options: ClaudeCodeLLMOptions = {}) {\n this.cliPath = options.cliPath ?? 'claude';\n this.timeoutMs = options.timeoutMs ?? 60_000;\n this.maxBufferBytes = options.maxBufferBytes ?? 1024 * 1024 * 2;\n }\n\n async available(): Promise<boolean> {\n try {\n await execFile(this.cliPath, ['--version'], { timeout: 3_000, maxBuffer: 1024 * 64 });\n return true;\n } catch {\n return false;\n }\n }\n\n async complete(request: LLMCompleteRequest): Promise<string> {\n const { stdout } = await execFile(\n this.cliPath,\n [\n '--print',\n '--output-format',\n 'json',\n '--system-prompt',\n request.system,\n request.user,\n ],\n { timeout: this.timeoutMs, maxBuffer: this.maxBufferBytes },\n );\n\n try {\n const parsed = JSON.parse(stdout) as { result?: string };\n return typeof parsed.result === 'string' ? parsed.result : stdout;\n } catch {\n return stdout;\n }\n }\n}\n","import { CachedDiscoveryLLM } from './cached-provider.js';\nimport { ClaudeCodeLLM } from './claude-code.js';\nimport type { DiscoveryLLM } from './types.js';\n\nexport interface ResolveOptions {\n rootDir: string;\n cacheDir: string;\n cliPath?: string;\n}\n\nexport async function resolveDiscoveryLLM(options: ResolveOptions): Promise<DiscoveryLLM | null> {\n const inner = new ClaudeCodeLLM(options.cliPath ? { cliPath: options.cliPath } : {});\n if (!(await inner.available())) return null;\n return new CachedDiscoveryLLM(inner, { rootDir: options.rootDir, cacheDir: options.cacheDir });\n}\n\nexport { ClaudeCodeLLM } from './claude-code.js';\nexport { CachedDiscoveryLLM } from './cached-provider.js';\nexport { readLlmCache, writeLlmCache, cacheKeyFor } from './cache.js';\nexport type { DiscoveryLLM, LLMCompleteRequest } from './types.js';\n"],"mappings":"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","names":[]}
@@ -96,6 +96,59 @@ async function handleSniffRun(rootDir, baseUrl, headless) {
96
96
  ]
97
97
  };
98
98
  }
99
+ async function handleSniffDiscover(options) {
100
+ const rootErr = validateRootDir(options.rootDir);
101
+ if (rootErr) {
102
+ return { content: [{ type: "text", text: JSON.stringify({ error: rootErr }) }] };
103
+ }
104
+ if (!options.baseUrl) {
105
+ return {
106
+ content: [
107
+ {
108
+ type: "text",
109
+ text: JSON.stringify({
110
+ error: "No baseUrl provided and no local dev server detected. Start your dev server or pass baseUrl."
111
+ })
112
+ }
113
+ ]
114
+ };
115
+ }
116
+ const urlErr = validateBaseUrl(options.baseUrl);
117
+ if (urlErr) {
118
+ return { content: [{ type: "text", text: JSON.stringify({ error: urlErr }) }] };
119
+ }
120
+ const { discoverCommand } = await import("../discover-BLUSO42Q.js");
121
+ const result = await discoverCommand({
122
+ rootDir: options.rootDir,
123
+ url: options.baseUrl,
124
+ headless: options.headless ?? true,
125
+ nonInteractive: true,
126
+ json: true,
127
+ ...options.maxScenarios !== void 0 ? { maxScenarios: options.maxScenarios } : {},
128
+ ...options.maxVariantsPerScenario !== void 0 ? { maxVariantsPerScenario: options.maxVariantsPerScenario } : {},
129
+ ...options.maxVariantsPerRun !== void 0 ? { maxVariantsPerRun: options.maxVariantsPerRun } : {},
130
+ ...options.realism !== void 0 ? { realism: options.realism } : {},
131
+ ...options.seed !== void 0 ? { seed: options.seed } : {},
132
+ ...options.only !== void 0 ? { only: options.only } : {},
133
+ ...options.appType !== void 0 ? { appType: options.appType } : {}
134
+ });
135
+ const summary = {
136
+ baseUrl: result.baseUrl,
137
+ stats: result.report.stats,
138
+ topAppType: result.report.appTypeGuesses[0]?.type,
139
+ topAppConfidence: result.report.appTypeGuesses[0]?.confidence,
140
+ savedPaths: result.savedPaths,
141
+ failedScenarios: result.report.scenarios.filter((s) => s.status === "fail" && s.quarantined !== true).map((s) => ({
142
+ id: s.scenario.id,
143
+ name: s.scenario.name,
144
+ failureReason: s.steps.find((step) => step.status === "fail")?.failureReason
145
+ })),
146
+ exitCode: result.exitCode
147
+ };
148
+ return {
149
+ content: [{ type: "text", text: JSON.stringify(summary, null, 2) }]
150
+ };
151
+ }
99
152
  async function handleSniffReport(rootDir, format) {
100
153
  const rootErr = validateRootDir(rootDir);
101
154
  if (rootErr) {
@@ -168,6 +221,42 @@ async function startMcpServer() {
168
221
  return handleSniffScan(rootDir);
169
222
  }
170
223
  );
224
+ server.tool(
225
+ "sniff_discover",
226
+ "Run autonomous end-to-end discovery: extract the app domain from source, classify the app type, generate scenarios with edge-case variants, drive them through Playwright, and return a compact summary. Requires a running dev server (baseUrl optional, auto-detected if omitted). Writes HTML/JSON reports to sniff-reports/discovery/.",
227
+ {
228
+ rootDir: z.string().describe("Absolute path to the project root directory"),
229
+ baseUrl: z.string().optional().describe("URL of the running app. Optional -- sniff auto-detects localhost servers if omitted."),
230
+ headless: z.boolean().default(true).describe("Run browser in headless mode"),
231
+ maxScenarios: z.number().int().min(1).max(200).optional().describe("Cap total scenarios (default: 50)"),
232
+ maxVariantsPerScenario: z.number().int().min(0).max(20).optional().describe("Cap edge variants per scenario (default: 3)"),
233
+ maxVariantsPerRun: z.number().int().min(0).max(200).optional().describe("Cap edge variants per run (default: 40)"),
234
+ realism: z.enum(["robot", "careful-user", "casual-user", "frustrated-user", "power-user"]).optional().describe("Realism profile (default: robot in CI, casual-user otherwise)"),
235
+ seed: z.number().int().optional().describe("Replay a specific random seed"),
236
+ only: z.string().optional().describe("Filter scenarios by id substring or app type"),
237
+ appType: z.array(z.string()).optional().describe("Force app types")
238
+ },
239
+ async (args) => {
240
+ let url = args.baseUrl;
241
+ if (!url) {
242
+ const { detectDevServerUrl } = await import("../dev-server-detector-NJ5RN4IC.js");
243
+ const detection = await detectDevServerUrl(args.rootDir);
244
+ url = detection.url;
245
+ }
246
+ return handleSniffDiscover({
247
+ rootDir: args.rootDir,
248
+ baseUrl: url,
249
+ headless: args.headless,
250
+ ...args.maxScenarios !== void 0 ? { maxScenarios: args.maxScenarios } : {},
251
+ ...args.maxVariantsPerScenario !== void 0 ? { maxVariantsPerScenario: args.maxVariantsPerScenario } : {},
252
+ ...args.maxVariantsPerRun !== void 0 ? { maxVariantsPerRun: args.maxVariantsPerRun } : {},
253
+ ...args.realism !== void 0 ? { realism: args.realism } : {},
254
+ ...args.seed !== void 0 ? { seed: args.seed } : {},
255
+ ...args.only !== void 0 ? { only: args.only } : {},
256
+ ...args.appType !== void 0 ? { appType: args.appType } : {}
257
+ });
258
+ }
259
+ );
171
260
  server.tool(
172
261
  "sniff_report",
173
262
  "Get the results from the most recent sniff scan. Returns findings, severities, and fix suggestions.",
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/mcp/server.ts","../../src/mcp/handlers.ts"],"sourcesContent":["import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';\nimport { z } from 'zod';\nimport { handleSniffScan, handleSniffRun, handleSniffReport } from './handlers.js';\nimport { getVersion } from '../version.js';\n\nexport async function startMcpServer(): Promise<void> {\n const server = new McpServer({\n name: 'sniff',\n version: getVersion(),\n });\n\n // Tool: sniff_scan -- static source analysis (no browser needed)\n server.tool(\n 'sniff_scan',\n 'Scan project source code for bugs. Finds debug statements, placeholder text, dead links, broken imports, hardcoded URLs, and API endpoint issues (missing validation, auth, error handling, secrets). Works offline, no browser or API key needed. Just pass the project path.',\n {\n rootDir: z.string().describe('Absolute path to the project root directory'),\n },\n async ({ rootDir }) => handleSniffScan(rootDir),\n );\n\n // Tool: sniff_run -- full audit (source + browser, auto-detects URL)\n server.tool(\n 'sniff_run',\n 'Run a full quality audit: source scan + browser checks (accessibility, visual regression, performance). The URL is optional -- sniff auto-detects running dev servers. If no server is found, runs source scan only. No API key needed.',\n {\n rootDir: z.string().describe('Absolute path to the project root directory'),\n baseUrl: z.string().optional().describe('URL of the running app. Optional -- sniff auto-detects localhost servers if omitted.'),\n headless: z.boolean().default(true).describe('Run browser in headless mode'),\n },\n async ({ rootDir, baseUrl, headless }) => {\n // Auto-detect URL if not provided\n let url = baseUrl;\n if (!url) {\n const { detectDevServerUrl } = await import('../config/dev-server-detector.js');\n const detection = await detectDevServerUrl(rootDir);\n url = detection.url;\n }\n\n if (url) {\n return handleSniffRun(rootDir, url, headless);\n }\n\n // No server found -- fall back to source scan only\n return handleSniffScan(rootDir);\n },\n );\n\n // Tool: sniff_report -- load last results\n server.tool(\n 'sniff_report',\n 'Get the results from the most recent sniff scan. Returns findings, severities, and fix suggestions.',\n {\n rootDir: z.string().describe('Absolute path to the project root directory'),\n format: z.enum(['json', 'summary']).default('summary').describe('Output format: full JSON or text summary'),\n },\n async ({ rootDir, format }) => handleSniffReport(rootDir, format),\n );\n\n // Connect via stdio transport\n const transport = new StdioServerTransport();\n await server.connect(transport);\n}\n","import { resolve } from 'node:path';\nimport { existsSync } from 'node:fs';\nimport type { Finding, BrowserFinding } from '../core/types.js';\n\nexport interface McpToolResult {\n [key: string]: unknown;\n content: Array<{ type: 'text'; text: string }>;\n}\n\n/**\n * Validate rootDir is absolute and exists on disk (T-04-15 mitigation).\n */\nfunction validateRootDir(rootDir: string): string | null {\n const resolved = resolve(rootDir);\n if (resolved !== rootDir) {\n return `rootDir must be an absolute path, got: ${rootDir}`;\n }\n if (!existsSync(resolved)) {\n return `rootDir does not exist: ${resolved}`;\n }\n return null;\n}\n\n/**\n * Validate baseUrl is a valid http/https URL (T-04-16 mitigation).\n */\nfunction validateBaseUrl(baseUrl: string): string | null {\n try {\n const parsed = new URL(baseUrl);\n if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') {\n return `baseUrl must use http or https scheme, got: ${parsed.protocol}`;\n }\n return null;\n } catch {\n return `Invalid URL: ${baseUrl}`;\n }\n}\n\nexport async function handleSniffScan(rootDir: string): Promise<McpToolResult> {\n const rootErr = validateRootDir(rootDir);\n if (rootErr) {\n return { content: [{ type: 'text', text: JSON.stringify({ error: rootErr }) }] };\n }\n\n const { loadConfig } = await import('../config/loader.js');\n const { ScannerRegistry } = await import('../scanners/registry.js');\n const { SourceScanner } = await import('../scanners/source/index.js');\n\n const config = await loadConfig(rootDir);\n const registry = new ScannerRegistry();\n registry.register(new SourceScanner());\n\n const results = await registry.runAll({ config, rootDir });\n return {\n content: [{ type: 'text', text: JSON.stringify(results, null, 2) }],\n };\n}\n\nexport async function handleSniffRun(\n rootDir: string,\n baseUrl: string,\n headless: boolean,\n): Promise<McpToolResult> {\n const rootErr = validateRootDir(rootDir);\n if (rootErr) {\n return { content: [{ type: 'text', text: JSON.stringify({ error: rootErr }) }] };\n }\n\n const urlErr = validateBaseUrl(baseUrl);\n if (urlErr) {\n return { content: [{ type: 'text', text: JSON.stringify({ error: urlErr }) }] };\n }\n\n const { loadConfig } = await import('../config/loader.js');\n const { BrowserRunner } = await import('../browser/runner.js');\n const { AccessibilityScanner } = await import('../scanners/accessibility/index.js');\n const { VisualRegressionScanner } = await import('../scanners/visual/index.js');\n const { PerformanceScanner } = await import('../scanners/performance/index.js');\n\n const config = await loadConfig(rootDir);\n\n const runner = new BrowserRunner(config);\n runner.registerScanner(new AccessibilityScanner());\n runner.registerScanner(new VisualRegressionScanner());\n runner.registerScanner(new PerformanceScanner());\n\n const result = await runner.run({\n baseUrl,\n testFiles: ['/'],\n viewports: config.viewports ?? [{ name: 'desktop', width: 1280, height: 720 }],\n headless,\n slowMo: 0,\n timeout: config.browser?.timeout ?? 30000,\n });\n\n // Type both groups explicitly to avoid Finding vs BrowserFinding incompatibility\n const allFindings: Array<Finding | BrowserFinding> = [\n ...result.scanResults.flatMap((r) => r.findings),\n ...result.pageVisits.flatMap((v) => v.findings),\n ];\n\n return {\n content: [\n {\n type: 'text',\n text: JSON.stringify(\n {\n findings: allFindings,\n urls: result.urls,\n duration: result.duration,\n findingCount: allFindings.length,\n },\n null,\n 2,\n ),\n },\n ],\n };\n}\n\nexport async function handleSniffReport(\n rootDir: string,\n format: 'json' | 'summary',\n): Promise<McpToolResult> {\n const rootErr = validateRootDir(rootDir);\n if (rootErr) {\n return { content: [{ type: 'text', text: JSON.stringify({ error: rootErr }) }] };\n }\n\n const { loadLastResults } = await import('../core/persistence.js');\n const results = await loadLastResults(rootDir);\n\n if (!results) {\n return {\n content: [\n {\n type: 'text',\n text: 'No previous sniff results found. Run sniff_scan or sniff_run first.',\n },\n ],\n };\n }\n\n if (format === 'json') {\n return { content: [{ type: 'text', text: JSON.stringify(results, null, 2) }] };\n }\n\n // Summary format\n const totalFindings = results.results.reduce((sum, r) => sum + r.findings.length, 0);\n const bySeverity: Record<string, number> = {};\n for (const r of results.results) {\n for (const f of r.findings) {\n bySeverity[f.severity] = (bySeverity[f.severity] ?? 0) + 1;\n }\n }\n const scanners = results.results.map((r) => r.scanner).join(', ');\n const summary = [\n `Sniff Results (${results.timestamp})`,\n `Scanners: ${scanners}`,\n `Total findings: ${totalFindings}`,\n ...Object.entries(bySeverity).map(([sev, count]) => ` ${sev}: ${count}`),\n ].join('\\n');\n\n return { content: [{ type: 'text', text: summary }] };\n}\n"],"mappings":"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","names":[]}
1
+ {"version":3,"sources":["../../src/mcp/server.ts","../../src/mcp/handlers.ts"],"sourcesContent":["import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';\nimport { z } from 'zod';\nimport { handleSniffScan, handleSniffRun, handleSniffReport, handleSniffDiscover } from './handlers.js';\nimport { getVersion } from '../version.js';\n\nexport async function startMcpServer(): Promise<void> {\n const server = new McpServer({\n name: 'sniff',\n version: getVersion(),\n });\n\n // Tool: sniff_scan -- static source analysis (no browser needed)\n server.tool(\n 'sniff_scan',\n 'Scan project source code for bugs. Finds debug statements, placeholder text, dead links, broken imports, hardcoded URLs, and API endpoint issues (missing validation, auth, error handling, secrets). Works offline, no browser or API key needed. Just pass the project path.',\n {\n rootDir: z.string().describe('Absolute path to the project root directory'),\n },\n async ({ rootDir }) => handleSniffScan(rootDir),\n );\n\n // Tool: sniff_run -- full audit (source + browser, auto-detects URL)\n server.tool(\n 'sniff_run',\n 'Run a full quality audit: source scan + browser checks (accessibility, visual regression, performance). The URL is optional -- sniff auto-detects running dev servers. If no server is found, runs source scan only. No API key needed.',\n {\n rootDir: z.string().describe('Absolute path to the project root directory'),\n baseUrl: z.string().optional().describe('URL of the running app. Optional -- sniff auto-detects localhost servers if omitted.'),\n headless: z.boolean().default(true).describe('Run browser in headless mode'),\n },\n async ({ rootDir, baseUrl, headless }) => {\n // Auto-detect URL if not provided\n let url = baseUrl;\n if (!url) {\n const { detectDevServerUrl } = await import('../config/dev-server-detector.js');\n const detection = await detectDevServerUrl(rootDir);\n url = detection.url;\n }\n\n if (url) {\n return handleSniffRun(rootDir, url, headless);\n }\n\n // No server found -- fall back to source scan only\n return handleSniffScan(rootDir);\n },\n );\n\n // Tool: sniff_discover -- autonomous E2E discovery (scenarios + edge cases)\n server.tool(\n 'sniff_discover',\n 'Run autonomous end-to-end discovery: extract the app domain from source, classify the app type, generate scenarios with edge-case variants, drive them through Playwright, and return a compact summary. Requires a running dev server (baseUrl optional, auto-detected if omitted). Writes HTML/JSON reports to sniff-reports/discovery/.',\n {\n rootDir: z.string().describe('Absolute path to the project root directory'),\n baseUrl: z.string().optional().describe('URL of the running app. Optional -- sniff auto-detects localhost servers if omitted.'),\n headless: z.boolean().default(true).describe('Run browser in headless mode'),\n maxScenarios: z.number().int().min(1).max(200).optional().describe('Cap total scenarios (default: 50)'),\n maxVariantsPerScenario: z.number().int().min(0).max(20).optional().describe('Cap edge variants per scenario (default: 3)'),\n maxVariantsPerRun: z.number().int().min(0).max(200).optional().describe('Cap edge variants per run (default: 40)'),\n realism: z.enum(['robot', 'careful-user', 'casual-user', 'frustrated-user', 'power-user']).optional().describe('Realism profile (default: robot in CI, casual-user otherwise)'),\n seed: z.number().int().optional().describe('Replay a specific random seed'),\n only: z.string().optional().describe('Filter scenarios by id substring or app type'),\n appType: z.array(z.string()).optional().describe('Force app types'),\n },\n async (args) => {\n let url = args.baseUrl;\n if (!url) {\n const { detectDevServerUrl } = await import('../config/dev-server-detector.js');\n const detection = await detectDevServerUrl(args.rootDir);\n url = detection.url;\n }\n return handleSniffDiscover({\n rootDir: args.rootDir,\n baseUrl: url,\n headless: args.headless,\n ...(args.maxScenarios !== undefined ? { maxScenarios: args.maxScenarios } : {}),\n ...(args.maxVariantsPerScenario !== undefined ? { maxVariantsPerScenario: args.maxVariantsPerScenario } : {}),\n ...(args.maxVariantsPerRun !== undefined ? { maxVariantsPerRun: args.maxVariantsPerRun } : {}),\n ...(args.realism !== undefined ? { realism: args.realism } : {}),\n ...(args.seed !== undefined ? { seed: args.seed } : {}),\n ...(args.only !== undefined ? { only: args.only } : {}),\n ...(args.appType !== undefined ? { appType: args.appType } : {}),\n });\n },\n );\n\n // Tool: sniff_report -- load last results\n server.tool(\n 'sniff_report',\n 'Get the results from the most recent sniff scan. Returns findings, severities, and fix suggestions.',\n {\n rootDir: z.string().describe('Absolute path to the project root directory'),\n format: z.enum(['json', 'summary']).default('summary').describe('Output format: full JSON or text summary'),\n },\n async ({ rootDir, format }) => handleSniffReport(rootDir, format),\n );\n\n // Connect via stdio transport\n const transport = new StdioServerTransport();\n await server.connect(transport);\n}\n","import { resolve } from 'node:path';\nimport { existsSync } from 'node:fs';\nimport type { Finding, BrowserFinding } from '../core/types.js';\n\nexport interface McpToolResult {\n [key: string]: unknown;\n content: Array<{ type: 'text'; text: string }>;\n}\n\n/**\n * Validate rootDir is absolute and exists on disk (T-04-15 mitigation).\n */\nfunction validateRootDir(rootDir: string): string | null {\n const resolved = resolve(rootDir);\n if (resolved !== rootDir) {\n return `rootDir must be an absolute path, got: ${rootDir}`;\n }\n if (!existsSync(resolved)) {\n return `rootDir does not exist: ${resolved}`;\n }\n return null;\n}\n\n/**\n * Validate baseUrl is a valid http/https URL (T-04-16 mitigation).\n */\nfunction validateBaseUrl(baseUrl: string): string | null {\n try {\n const parsed = new URL(baseUrl);\n if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') {\n return `baseUrl must use http or https scheme, got: ${parsed.protocol}`;\n }\n return null;\n } catch {\n return `Invalid URL: ${baseUrl}`;\n }\n}\n\nexport async function handleSniffScan(rootDir: string): Promise<McpToolResult> {\n const rootErr = validateRootDir(rootDir);\n if (rootErr) {\n return { content: [{ type: 'text', text: JSON.stringify({ error: rootErr }) }] };\n }\n\n const { loadConfig } = await import('../config/loader.js');\n const { ScannerRegistry } = await import('../scanners/registry.js');\n const { SourceScanner } = await import('../scanners/source/index.js');\n\n const config = await loadConfig(rootDir);\n const registry = new ScannerRegistry();\n registry.register(new SourceScanner());\n\n const results = await registry.runAll({ config, rootDir });\n return {\n content: [{ type: 'text', text: JSON.stringify(results, null, 2) }],\n };\n}\n\nexport async function handleSniffRun(\n rootDir: string,\n baseUrl: string,\n headless: boolean,\n): Promise<McpToolResult> {\n const rootErr = validateRootDir(rootDir);\n if (rootErr) {\n return { content: [{ type: 'text', text: JSON.stringify({ error: rootErr }) }] };\n }\n\n const urlErr = validateBaseUrl(baseUrl);\n if (urlErr) {\n return { content: [{ type: 'text', text: JSON.stringify({ error: urlErr }) }] };\n }\n\n const { loadConfig } = await import('../config/loader.js');\n const { BrowserRunner } = await import('../browser/runner.js');\n const { AccessibilityScanner } = await import('../scanners/accessibility/index.js');\n const { VisualRegressionScanner } = await import('../scanners/visual/index.js');\n const { PerformanceScanner } = await import('../scanners/performance/index.js');\n\n const config = await loadConfig(rootDir);\n\n const runner = new BrowserRunner(config);\n runner.registerScanner(new AccessibilityScanner());\n runner.registerScanner(new VisualRegressionScanner());\n runner.registerScanner(new PerformanceScanner());\n\n const result = await runner.run({\n baseUrl,\n testFiles: ['/'],\n viewports: config.viewports ?? [{ name: 'desktop', width: 1280, height: 720 }],\n headless,\n slowMo: 0,\n timeout: config.browser?.timeout ?? 30000,\n });\n\n // Type both groups explicitly to avoid Finding vs BrowserFinding incompatibility\n const allFindings: Array<Finding | BrowserFinding> = [\n ...result.scanResults.flatMap((r) => r.findings),\n ...result.pageVisits.flatMap((v) => v.findings),\n ];\n\n return {\n content: [\n {\n type: 'text',\n text: JSON.stringify(\n {\n findings: allFindings,\n urls: result.urls,\n duration: result.duration,\n findingCount: allFindings.length,\n },\n null,\n 2,\n ),\n },\n ],\n };\n}\n\nexport interface SniffDiscoverOptions {\n rootDir: string;\n baseUrl?: string;\n headless?: boolean;\n maxScenarios?: number;\n maxVariantsPerScenario?: number;\n maxVariantsPerRun?: number;\n realism?: 'robot' | 'careful-user' | 'casual-user' | 'frustrated-user' | 'power-user';\n seed?: number;\n only?: string;\n appType?: string[];\n}\n\nexport async function handleSniffDiscover(options: SniffDiscoverOptions): Promise<McpToolResult> {\n const rootErr = validateRootDir(options.rootDir);\n if (rootErr) {\n return { content: [{ type: 'text', text: JSON.stringify({ error: rootErr }) }] };\n }\n\n if (!options.baseUrl) {\n return {\n content: [\n {\n type: 'text',\n text: JSON.stringify({\n error: 'No baseUrl provided and no local dev server detected. Start your dev server or pass baseUrl.',\n }),\n },\n ],\n };\n }\n\n const urlErr = validateBaseUrl(options.baseUrl);\n if (urlErr) {\n return { content: [{ type: 'text', text: JSON.stringify({ error: urlErr }) }] };\n }\n\n const { discoverCommand } = await import('../cli/commands/discover.js');\n const result = await discoverCommand({\n rootDir: options.rootDir,\n url: options.baseUrl,\n headless: options.headless ?? true,\n nonInteractive: true,\n json: true,\n ...(options.maxScenarios !== undefined ? { maxScenarios: options.maxScenarios } : {}),\n ...(options.maxVariantsPerScenario !== undefined\n ? { maxVariantsPerScenario: options.maxVariantsPerScenario }\n : {}),\n ...(options.maxVariantsPerRun !== undefined ? { maxVariantsPerRun: options.maxVariantsPerRun } : {}),\n ...(options.realism !== undefined ? { realism: options.realism } : {}),\n ...(options.seed !== undefined ? { seed: options.seed } : {}),\n ...(options.only !== undefined ? { only: options.only } : {}),\n ...(options.appType !== undefined ? { appType: options.appType } : {}),\n });\n\n const summary = {\n baseUrl: result.baseUrl,\n stats: result.report.stats,\n topAppType: result.report.appTypeGuesses[0]?.type,\n topAppConfidence: result.report.appTypeGuesses[0]?.confidence,\n savedPaths: result.savedPaths,\n failedScenarios: result.report.scenarios\n .filter((s) => s.status === 'fail' && s.quarantined !== true)\n .map((s) => ({\n id: s.scenario.id,\n name: s.scenario.name,\n failureReason: s.steps.find((step) => step.status === 'fail')?.failureReason,\n })),\n exitCode: result.exitCode,\n };\n\n return {\n content: [{ type: 'text', text: JSON.stringify(summary, null, 2) }],\n };\n}\n\nexport async function handleSniffReport(\n rootDir: string,\n format: 'json' | 'summary',\n): Promise<McpToolResult> {\n const rootErr = validateRootDir(rootDir);\n if (rootErr) {\n return { content: [{ type: 'text', text: JSON.stringify({ error: rootErr }) }] };\n }\n\n const { loadLastResults } = await import('../core/persistence.js');\n const results = await loadLastResults(rootDir);\n\n if (!results) {\n return {\n content: [\n {\n type: 'text',\n text: 'No previous sniff results found. Run sniff_scan or sniff_run first.',\n },\n ],\n };\n }\n\n if (format === 'json') {\n return { content: [{ type: 'text', text: JSON.stringify(results, null, 2) }] };\n }\n\n // Summary format\n const totalFindings = results.results.reduce((sum, r) => sum + r.findings.length, 0);\n const bySeverity: Record<string, number> = {};\n for (const r of results.results) {\n for (const f of r.findings) {\n bySeverity[f.severity] = (bySeverity[f.severity] ?? 0) + 1;\n }\n }\n const scanners = results.results.map((r) => r.scanner).join(', ');\n const summary = [\n `Sniff Results (${results.timestamp})`,\n `Scanners: ${scanners}`,\n `Total findings: ${totalFindings}`,\n ...Object.entries(bySeverity).map(([sev, count]) => ` ${sev}: ${count}`),\n ].join('\\n');\n\n return { content: [{ type: 'text', text: summary }] };\n}\n"],"mappings":"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","names":[]}
@@ -0,0 +1,270 @@
1
+ // src/discovery/persistence/frontmatter.ts
2
+ var FRONTMATTER_OPEN = "---json";
3
+ var FRONTMATTER_CLOSE = "---";
4
+ function parseJsonFrontmatter(content) {
5
+ const normalized = content.replace(/\r\n/g, "\n");
6
+ if (!normalized.startsWith(FRONTMATTER_OPEN)) {
7
+ return { data: null, body: normalized, error: "missing ---json opening marker" };
8
+ }
9
+ const afterOpen = normalized.slice(FRONTMATTER_OPEN.length);
10
+ if (!afterOpen.startsWith("\n")) {
11
+ return { data: null, body: normalized, error: "expected newline after ---json" };
12
+ }
13
+ const rest = afterOpen.slice(1);
14
+ const closeMatch = rest.match(/\n---(?=\n|$)/);
15
+ if (!closeMatch || closeMatch.index === void 0) {
16
+ return { data: null, body: normalized, error: "missing --- closing marker" };
17
+ }
18
+ const jsonPart = rest.slice(0, closeMatch.index);
19
+ const bodyStart = closeMatch.index + closeMatch[0].length;
20
+ const body = rest.slice(bodyStart).replace(/^\n/, "");
21
+ try {
22
+ const data = JSON.parse(jsonPart);
23
+ return { data, body };
24
+ } catch (err) {
25
+ const message = err instanceof Error ? err.message : String(err);
26
+ return { data: null, body, error: `invalid JSON: ${message}` };
27
+ }
28
+ }
29
+ function serializeJsonFrontmatter(data, body = "") {
30
+ const json = JSON.stringify(data, null, 2);
31
+ const trailing = body ? `
32
+ ${body.replace(/^\n+/, "")}` : "";
33
+ return `${FRONTMATTER_OPEN}
34
+ ${json}
35
+ ${FRONTMATTER_CLOSE}
36
+ ${trailing}`;
37
+ }
38
+
39
+ // src/discovery/persistence/scenario-file.ts
40
+ function bodyForScenario(scenario) {
41
+ const lines = [];
42
+ lines.push(`# ${scenario.name}`, "");
43
+ lines.push("## Purpose", "");
44
+ lines.push(scenario.goal.description, "");
45
+ lines.push(`Goal kind: \`${scenario.goal.kind}\``, `Goal value: \`${scenario.goal.value}\``, "");
46
+ if (scenario.tags.length > 0) {
47
+ lines.push("## Tags", "");
48
+ lines.push(scenario.tags.map((t) => `- \`${t}\``).join("\n"), "");
49
+ }
50
+ lines.push("## Steps", "");
51
+ for (const step of scenario.steps) {
52
+ lines.push(`${step.n}. **${step.intent}** (\`${step.action}\`)`);
53
+ }
54
+ lines.push("");
55
+ lines.push("## Known failure modes", "");
56
+ lines.push("Add observed failure modes here. They are informational only.", "");
57
+ return lines.join("\n");
58
+ }
59
+ function scenarioToMarkdown(scenario) {
60
+ return serializeJsonFrontmatter(scenario, bodyForScenario(scenario));
61
+ }
62
+ function markdownToScenario(content) {
63
+ const { data, error } = parseJsonFrontmatter(content);
64
+ if (!data) return { scenario: null, ...error ? { error } : {} };
65
+ if (typeof data.id !== "string" || !Array.isArray(data.steps)) {
66
+ return { scenario: null, error: "frontmatter missing required Scenario fields" };
67
+ }
68
+ return { scenario: data };
69
+ }
70
+ function scenarioRelativePath(scenario) {
71
+ const suffix = scenario.variant === "happy" ? "happy" : scenario.variant.replace(/[^a-z0-9-]/gi, "-");
72
+ return `${scenario.appType}/${scenario.journey}.${suffix}.scenario.md`;
73
+ }
74
+
75
+ // src/discovery/persistence/hashes.ts
76
+ import { createHash } from "crypto";
77
+ import { readFile, writeFile, mkdir } from "fs/promises";
78
+ import { dirname, join } from "path";
79
+ function hashContent(content) {
80
+ return createHash("sha256").update(content, "utf-8").digest("hex");
81
+ }
82
+ async function loadHashes(generatedDir) {
83
+ const path = join(generatedDir, ".hashes.json");
84
+ try {
85
+ const raw = await readFile(path, "utf-8");
86
+ const parsed = JSON.parse(raw);
87
+ return parsed && typeof parsed === "object" ? parsed : {};
88
+ } catch {
89
+ return {};
90
+ }
91
+ }
92
+ async function saveHashes(generatedDir, hashes) {
93
+ const path = join(generatedDir, ".hashes.json");
94
+ await mkdir(dirname(path), { recursive: true });
95
+ await writeFile(path, JSON.stringify(hashes, null, 2), "utf-8");
96
+ }
97
+ async function currentFileHash(path) {
98
+ try {
99
+ const raw = await readFile(path, "utf-8");
100
+ return hashContent(raw);
101
+ } catch {
102
+ return null;
103
+ }
104
+ }
105
+
106
+ // src/discovery/persistence/writer.ts
107
+ import { mkdir as mkdir2, readFile as readFile2, readdir, rm, stat, writeFile as writeFile2 } from "fs/promises";
108
+ import { dirname as dirname2, join as join2, relative } from "path";
109
+ var GITIGNORE_CONTENTS = "# sniff discovery artifacts\ncache/\nruns/\n";
110
+ async function listGeneratedScenarioFiles(generatedDir) {
111
+ const out = [];
112
+ async function walk(dir) {
113
+ let entries;
114
+ try {
115
+ entries = await readdir(dir, { withFileTypes: true });
116
+ } catch {
117
+ return;
118
+ }
119
+ for (const entry of entries) {
120
+ const abs = join2(dir, entry.name);
121
+ if (entry.isDirectory()) {
122
+ await walk(abs);
123
+ } else if (entry.isFile() && entry.name.endsWith(".scenario.md")) {
124
+ out.push(abs);
125
+ }
126
+ }
127
+ }
128
+ await walk(generatedDir);
129
+ return out;
130
+ }
131
+ async function writeIfChanged(path, content) {
132
+ await mkdir2(dirname2(path), { recursive: true });
133
+ try {
134
+ const existing = await readFile2(path, "utf-8");
135
+ if (existing === content) return false;
136
+ } catch {
137
+ }
138
+ await writeFile2(path, content, "utf-8");
139
+ return true;
140
+ }
141
+ async function ensureGitignore(scenariosDir) {
142
+ const path = join2(scenariosDir, ".gitignore");
143
+ try {
144
+ await stat(path);
145
+ return;
146
+ } catch {
147
+ }
148
+ await mkdir2(scenariosDir, { recursive: true });
149
+ await writeFile2(path, GITIGNORE_CONTENTS, "utf-8");
150
+ }
151
+ async function resolveConflict(conflict, options) {
152
+ if (options.forceRegenerate) return "overwrite";
153
+ if (options.nonInteractive) return "keep";
154
+ if (options.onConflict) return options.onConflict(conflict);
155
+ return "keep";
156
+ }
157
+ async function moveToCustom(generatedPath, customDir, generatedDir) {
158
+ const rel = relative(generatedDir, generatedPath);
159
+ const dest = join2(customDir, rel);
160
+ await mkdir2(dirname2(dest), { recursive: true });
161
+ const content = await readFile2(generatedPath, "utf-8");
162
+ await writeFile2(dest, content, "utf-8");
163
+ return dest;
164
+ }
165
+ async function saveDiscoveryScenarios(options) {
166
+ const scenariosDir = join2(options.rootDir, "sniff-scenarios");
167
+ const generatedDir = join2(scenariosDir, "_generated");
168
+ const customDir = join2(scenariosDir, "custom");
169
+ await mkdir2(generatedDir, { recursive: true });
170
+ await mkdir2(customDir, { recursive: true });
171
+ await ensureGitignore(scenariosDir);
172
+ const hashes = await loadHashes(generatedDir);
173
+ const nextHashes = {};
174
+ const result = {
175
+ scenariosDir,
176
+ generatedDir,
177
+ customDir,
178
+ written: [],
179
+ skippedKept: [],
180
+ movedToCustom: [],
181
+ removed: [],
182
+ conflicts: []
183
+ };
184
+ const intendedPaths = /* @__PURE__ */ new Set();
185
+ for (const scenario of options.scenarios) {
186
+ const rel = scenarioRelativePath(scenario);
187
+ const abs = join2(generatedDir, rel);
188
+ intendedPaths.add(abs);
189
+ const content = scenarioToMarkdown(scenario);
190
+ const newHash = hashContent(content);
191
+ const stored = hashes[rel];
192
+ const currentHash = await currentFileHash(abs);
193
+ if (stored?.userOwned) {
194
+ nextHashes[rel] = { hash: stored.hash, userOwned: true };
195
+ result.skippedKept.push(abs);
196
+ continue;
197
+ }
198
+ if (currentHash && stored && currentHash !== stored.hash) {
199
+ const conflict = {
200
+ path: abs,
201
+ relativePath: rel,
202
+ storedHash: stored.hash,
203
+ currentHash,
204
+ scenarioId: scenario.id
205
+ };
206
+ result.conflicts.push(conflict);
207
+ const action = await resolveConflict(conflict, options);
208
+ if (action === "keep") {
209
+ nextHashes[rel] = { hash: stored.hash, userOwned: true };
210
+ result.skippedKept.push(abs);
211
+ continue;
212
+ }
213
+ if (action === "move-to-custom") {
214
+ const moved = await moveToCustom(abs, customDir, generatedDir);
215
+ result.movedToCustom.push(moved);
216
+ }
217
+ }
218
+ const changed = await writeIfChanged(abs, content);
219
+ if (changed) result.written.push(abs);
220
+ nextHashes[rel] = { hash: newHash };
221
+ }
222
+ const existing = await listGeneratedScenarioFiles(generatedDir);
223
+ for (const abs of existing) {
224
+ if (intendedPaths.has(abs)) continue;
225
+ const rel = relative(generatedDir, abs);
226
+ const stored = hashes[rel];
227
+ if (stored?.userOwned) continue;
228
+ const currentHash = await currentFileHash(abs);
229
+ if (currentHash && stored && currentHash !== stored.hash) {
230
+ const conflict = {
231
+ path: abs,
232
+ relativePath: rel,
233
+ storedHash: stored.hash,
234
+ currentHash,
235
+ scenarioId: "(removed)"
236
+ };
237
+ result.conflicts.push(conflict);
238
+ const action = await resolveConflict(conflict, options);
239
+ if (action === "keep") continue;
240
+ if (action === "move-to-custom") {
241
+ const moved = await moveToCustom(abs, customDir, generatedDir);
242
+ result.movedToCustom.push(moved);
243
+ }
244
+ }
245
+ try {
246
+ await rm(abs);
247
+ result.removed.push(abs);
248
+ } catch {
249
+ }
250
+ }
251
+ const snapshotPath = join2(generatedDir, "snapshot.json");
252
+ const classificationPath = join2(generatedDir, "classification.json");
253
+ await writeIfChanged(snapshotPath, JSON.stringify(options.snapshot, null, 2));
254
+ await writeIfChanged(classificationPath, JSON.stringify(options.guesses, null, 2));
255
+ await saveHashes(generatedDir, nextHashes);
256
+ return result;
257
+ }
258
+ export {
259
+ currentFileHash,
260
+ hashContent,
261
+ loadHashes,
262
+ markdownToScenario,
263
+ parseJsonFrontmatter,
264
+ saveDiscoveryScenarios,
265
+ saveHashes,
266
+ scenarioRelativePath,
267
+ scenarioToMarkdown,
268
+ serializeJsonFrontmatter
269
+ };
270
+ //# sourceMappingURL=persistence-KTCRIGHU.js.map