@captain_z/zsk 1.8.3 → 1.8.5

package/dist/core/demo-scenarios.d.ts

@@ -0,0 +1,62 @@
+import { type ResolvedDemoAuthConfig } from "./demo-auth.js";
+import { type DemoSourceDoc } from "./demo-sources.js";
+export type OptimizedPlanStep = {
+    id: string;
+    intent: string;
+    action: "goto" | "fill" | "click" | "assert";
+    target?: string;
+    locator?: {
+        strategy: "role" | "text";
+        role?: string;
+        name?: string;
+        text?: string;
+    };
+    value?: string;
+};
+export type OptimizedDemoCase = {
+    id: string;
+    title: string;
+    source: string;
+    sourceKind: string;
+    sourceBasis: string[];
+    priority: "P0";
+    preconditions: string[];
+    uiObservationBoundary: {
+        role: "observation-only";
+        allowedOutput: string;
+        prohibitedOutputs: string[];
+    };
+    steps: OptimizedPlanStep[];
+    assertions: Array<{
+        intent: string;
+        type: "visible";
+        locator: {
+            strategy: "text";
+            text: string;
+        };
+    }>;
+    risks: string[];
+};
+type RoleTarget = {
+    role: string;
+    name: string;
+};
+export declare function synthesizeOptimizedDemoCases(params: {
+    moduleId: string;
+    sourceBasis: DemoSourceDoc[];
+    runtimeUrl?: string;
+    playwrightAuthState: string;
+}): OptimizedDemoCase[];
+export declare function renderOptimizedSpec(moduleId: string, demoAuth: ResolvedDemoAuthConfig, cases: Array<{
+    title: string;
+    source: string;
+    sourceBasis?: string[];
+    steps: OptimizedPlanStep[];
+}>): string;
+export declare function parseRoleTargets(snapshot: string): RoleTarget[];
+export declare function synthesizePlaywrightSteps(targets: RoleTarget[], testCase: string): string[];
+export declare function inferFillValue(testCase: string): string;
+export declare function inferScenarioName(testCase: string): string | null;
+export declare function slugify(value: string): string;
+export declare function escapeForDoubleQuotedString(value: string): string;
+export {};

package/dist/core/demo-scenarios.js

@@ -0,0 +1,276 @@
+import { basename } from "node:path";
+import { demoAuthRuntimeLines, } from "./demo-auth.js";
+import { inferRouteHint, selectDemoCaseSources, summarizeCaseSourceBasis, } from "./demo-sources.js";
+export function synthesizeOptimizedDemoCases(params) {
+    const cases = [];
+    const caseSources = selectDemoCaseSources(params.sourceBasis);
+    for (const sourceDoc of caseSources) {
+        const content = sourceDoc.content;
+        const joinedSourceText = [content, ...params.sourceBasis.map((source) => source.content)].join("\n\n");
+        const title = inferScenarioName(content) ?? basename(sourceDoc.path).replace(/\.[^.]+$/, "") ?? "generated case";
+        const fillValue = inferFillValue(joinedSourceText);
+        const expectedText = inferExpectedText(joinedSourceText, fillValue);
+        const caseId = slugify(`${params.moduleId}-${title}`);
+        const routeHint = inferRouteHint(joinedSourceText, params.runtimeUrl);
+        const steps = [
+            {
+                id: "step-1",
+                intent: "Open the demo entry page",
+                action: "goto",
+                target: routeHint ?? "{{baseUrl}}",
+            },
+            {
+                id: "step-2",
+                intent: "Perform the primary user input from the source-backed scenario",
+                action: "fill",
+                locator: {
+                    strategy: "role",
+                    role: "textbox",
+                },
+                value: fillValue,
+            },
+            {
+                id: "step-3",
+                intent: "Submit or advance the flow",
+                action: "click",
+                locator: {
+                    strategy: "role",
+                    role: "button",
+                },
+            },
+            {
+                id: "step-4",
+                intent: "Verify the expected visible result",
+                action: "assert",
+                locator: {
+                    strategy: "text",
+                    text: expectedText,
+                },
+            },
+        ];
+        cases.push({
+            id: caseId,
+            title,
+            source: sourceDoc.path,
+            sourceKind: sourceDoc.kind,
+            sourceBasis: summarizeCaseSourceBasis(sourceDoc, params.sourceBasis),
+            priority: "P0",
+            preconditions: [
+                "Scenario is grounded in module design/spec/tasks, raw sources, existing tests, or implementation mapping.",
+                `If authentication is required, Playwright storageState is prepared under ${params.playwrightAuthState} and gitignored.`,
+                "Computer Use observation is preferred for visual/current-page refinement when available; otherwise use Playwright MCP/ARIA/CDP, manual evidence, or Browser Use only in runtimes that support it.",
+            ],
+            uiObservationBoundary: {
+                role: "observation-only",
+                allowedOutput: "structured observation with URL, page title, visible targets, role/label hints, auth/session note, and privacy note",
+                prohibitedOutputs: ["test-plan.json", ".spec.ts"],
+            },
+            steps,
+            assertions: [
+                {
+                    intent: "Expected result from raw test case is visible",
+                    type: "visible",
+                    locator: {
+                        strategy: "text",
+                        text: expectedText,
+                    },
+                },
+            ],
+            risks: [
+                "Generated locator names must be refined from Computer Use, Playwright MCP/ARIA/CDP, manual evidence, or supported Browser Use observation before promotion.",
+                "Do not fall back to Playwright MCP or the hybrid bridge in optimized mode.",
+            ],
+        });
+    }
+    return cases;
+}
+export function renderOptimizedSpec(moduleId, demoAuth, cases) {
+    const lines = [
+        `import { test, expect } from "@playwright/test";`,
+        `import { existsSync, mkdirSync, readFileSync } from "node:fs";`,
+        `import { dirname, resolve } from "node:path";`,
+        `import { homedir } from "node:os";`,
+        ``,
+        `const envFiles = ${JSON.stringify(demoAuth.envFiles)};`,
+        `const authEnv = ${JSON.stringify(demoAuth.env)};`,
+        `const authSelectors = ${JSON.stringify(demoAuth.selectors)};`,
+        `const storageStatePath = resolve(process.cwd(), process.env.ZSK_PLAYWRIGHT_STORAGE_STATE ?? ${quote(demoAuth.storageState)});`,
+        `const authMode = process.env.ZSK_DEMO_AUTH ?? ${quote(demoAuth.required ? "required" : "none")};`,
+        `const loginEnabled = ["1", "true", "yes"].includes((process.env.ZSK_DEMO_LOGIN ?? "").toLowerCase());`,
+        `const configuredLoginUrl = ${quote(demoAuth.loginUrl ?? "")};`,
+        `const loginUrl = process.env.ZSK_DEMO_LOGIN_URL ?? (configuredLoginUrl || process.env.ZSK_DEMO_BASE_URL);`,
+        ``,
+        ...demoAuthRuntimeLines(),
+        ``,
+        `test.describe.configure({ mode: "serial" });`,
+        ``,
+        `async function ensureDemoAuthState(browser) {`,
+        `  if (authMode === "none" || existsSync(storageStatePath)) return;`,
+        `  if (!loginEnabled) {`,
+        `    throw new Error([`,
+        `      \`Missing demo auth storageState: ${"${storageStatePath}"}\`,`,
+        `      "Run once with ZSK_DEMO_LOGIN=1 and --headed/PWDEBUG=1 to login and save state.",`,
+        `      "Set ZSK_DEMO_AUTH=none only for public flows that do not require login.",`,
+        `    ].join("\\n"));`,
+        `  }`,
+        `  if (!loginUrl) throw new Error("Set ZSK_DEMO_LOGIN_URL or ZSK_DEMO_BASE_URL before first login.");`,
+        `  loadConfiguredEnvFiles();`,
+        `  const context = await browser.newContext();`,
+        `  const page = await context.newPage();`,
+        `  await page.goto(loginUrl);`,
+        `  await fillConfiguredLogin(page);`,
+        `  await page.pause();`,
+        `  mkdirSync(dirname(storageStatePath), { recursive: true });`,
+        `  await context.storageState({ path: storageStatePath });`,
+        `  await context.close();`,
+        `}`,
+        ``,
+        `async function newDemoPage(browser) {`,
+        `  await ensureDemoAuthState(browser);`,
+        `  const context = await browser.newContext(authMode === "none" ? {} : { storageState: storageStatePath });`,
+        `  const page = await context.newPage();`,
+        `  return { context, page };`,
+        `}`,
+        ``,
+        `async function assertNotBlockedByLogin(page) {`,
+        `  await page.waitForLoadState("domcontentloaded").catch(() => undefined);`,
+        `  const urlLooksLogin = /login|signin|sign-in|auth|sso/i.test(page.url());`,
+        `  const passwordVisible = await page.locator("input[type='password']").first().isVisible({ timeout: 500 }).catch(() => false);`,
+        `  const loginTextVisible = await page.getByText(/登录|登陆|login|sign in|sign-in/i).first().isVisible({ timeout: 500 }).catch(() => false);`,
+        `  if (!urlLooksLogin && !passwordVisible) return;`,
+        `  throw new Error([`,
+        `    "Demo scenario was blocked by a login page before business assertions.",`,
+        `    \`Refresh ${"${storageStatePath}"} by running with ZSK_DEMO_LOGIN=1, or run zsk demo auth and execute the generated login helper.\`,`,
+        `    loginTextVisible ? "Login text was visible on the page." : "Password field or login URL was detected.",`,
+        `  ].join("\\n"));`,
+        `}`,
+        ``,
+        `test.describe("${escapeForDoubleQuotedString(moduleId)} optimized demo scenarios", () => {`,
+    ];
+    for (const testCase of cases) {
+        const goto = testCase.steps.find((step) => step.action === "goto");
+        const fill = testCase.steps.find((step) => step.action === "fill");
+        const click = testCase.steps.find((step) => step.action === "click");
+        const assertion = testCase.steps.find((step) => step.action === "assert");
+        lines.push(`  test("${escapeForDoubleQuotedString(testCase.title)}", async ({ browser }) => {`, `    const baseUrl = process.env.ZSK_DEMO_BASE_URL;`, `    if (!baseUrl) throw new Error("Set ZSK_DEMO_BASE_URL to run this scenario.");`, `    const { context, page } = await newDemoPage(browser);`, `    try {`, goto?.target && goto.target !== "{{baseUrl}}"
+            ? `      await page.goto(new URL(${quote(goto.target)}, baseUrl).toString());`
+            : `      await page.goto(baseUrl);`, `      await assertNotBlockedByLogin(page);`, ``, `      // Source: ${escapeForLineComment(testCase.source)}`, ...(testCase.sourceBasis ?? [])
+            .slice(0, 5)
+            .map((source) => `      // Basis: ${escapeForLineComment(source)}`), `      // ZSK_GENERATED_REFINEMENT_REQUIRED: refine locator names from Computer Use, Playwright MCP/ARIA/CDP, manual evidence, or compatible Browser Use before promotion.`);
+        if (fill?.locator?.role && fill.value) {
+            lines.push(`      await ${renderRoleLocator(fill.locator.role, fill.locator.name)}.fill(${quote(fill.value)});`);
+        }
+        if (click?.locator?.role) {
+            lines.push(`      await ${renderRoleLocator(click.locator.role, click.locator.name)}.click();`);
+        }
+        if (assertion?.locator?.text) {
+            lines.push(`      await expect(page.getByText(${quote(assertion.locator.text)})).toBeVisible();`);
+        }
+        else {
+            lines.push(`      await expect(page).toHaveURL(/.+/);`);
+        }
+        lines.push(`    } finally {`, `      await context.close();`, `    }`, `  });`, ``);
+    }
+    lines.push(`});`, ``);
+    return lines.join("\n");
+}
+export function parseRoleTargets(snapshot) {
+    const targets = [];
+    const rolePattern = /(?:^|\n)\s*-\s*(button|link|textbox|checkbox|heading|combobox|radio|menuitem)\s+"([^"]+)"/gi;
+    for (const match of snapshot.matchAll(rolePattern)) {
+        const role = normalizeRole(match[1] ?? "");
+        const name = (match[2] ?? "").trim();
+        if (!role || !name)
+            continue;
+        targets.push({ role, name });
+    }
+    return targets;
+}
+export function synthesizePlaywrightSteps(targets, testCase) {
+    const steps = [];
+    const textbox = targets.find((target) => target.role === "textbox");
+    const button = targets.find((target) => target.role === "button");
+    const link = targets.find((target) => target.role === "link");
+    const checkbox = targets.find((target) => target.role === "checkbox");
+    const heading = targets.find((target) => target.role === "heading");
+    const fillValue = inferFillValue(testCase);
+    steps.push(`// Generated from test case and structured aria/accessibility snapshot.`);
+    if (textbox) {
+        steps.push(`await page.getByRole("textbox", { name: ${quote(textbox.name)} }).fill(${quote(fillValue)});`);
+    }
+    if (checkbox && shouldCheck(testCase)) {
+        steps.push(`await page.getByRole("checkbox", { name: ${quote(checkbox.name)} }).check();`);
+    }
+    if (button) {
+        steps.push(`await page.getByRole("button", { name: ${quote(button.name)} }).click();`);
+    }
+    else if (link) {
+        steps.push(`await page.getByRole("link", { name: ${quote(link.name)} }).click();`);
+    }
+    if (heading) {
+        steps.push(`await expect(page.getByRole("heading", { name: ${quote(heading.name)} })).toBeVisible();`);
+    }
+    else if (textbox || button || link || checkbox) {
+        steps.push(`await expect(page).toHaveURL(/.+/);`);
+    }
+    else {
+        steps.push(`// Provide a Playwright accessibility snapshot to synthesize role-first locators.`);
+        steps.push(`await expect(page).toHaveURL(/.+/);`);
+    }
+    return steps;
+}
+export function inferFillValue(testCase) {
+    const quoted = testCase.match(/["“”']([^"“”']{2,80})["“”']/);
+    if (quoted?.[1])
+        return quoted[1];
+    const afterInput = testCase.match(/(?:输入|type|fill|enter)\s*[:：]?\s*([^\n，,。]{2,80})/i);
+    if (afterInput?.[1])
+        return afterInput[1].trim();
+    return "demo value";
+}
+export function inferScenarioName(testCase) {
+    const heading = testCase.match(/^#\s+(.+)$/m);
+    if (heading?.[1])
+        return heading[1];
+    const title = testCase.match(/(?:title|标题|用例)[:：]\s*(.+)/i);
+    if (title?.[1])
+        return title[1];
+    return null;
+}
+export function slugify(value) {
+    const slug = value
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+    return slug || "generated-from-test-case";
+}
+export function escapeForDoubleQuotedString(value) {
+    return value.replace(/\\/g, "\\\\").replace(/"/g, "\\\"");
+}
+function renderRoleLocator(role, name) {
+    if (name)
+        return `page.getByRole(${quote(role)}, { name: ${quote(name)} })`;
+    return `page.getByRole(${quote(role)}).first()`;
+}
+function normalizeRole(role) {
+    if (role === "textbox")
+        return "textbox";
+    return role.toLowerCase();
+}
+function shouldCheck(testCase) {
+    return /check|toggle|勾选|选中|切换/i.test(testCase);
+}
+function quote(value) {
+    return JSON.stringify(value);
+}
+function escapeForLineComment(value) {
+    return value.replace(/\*\//g, "* /").replace(/\n/g, " ");
+}
+function inferExpectedText(testCase, fallback) {
+    const expected = testCase.match(/(?:expect|should see|visible|断言|期望|显示|可见)\s*[:：]?\s*["“”']?([^"“”'\n。]{2,80})/i);
+    if (expected?.[1])
+        return expected[1].trim();
+    const quoted = [...testCase.matchAll(/["“”']([^"“”']{2,80})["“”']/g)].map((match) => match[1]).filter(Boolean);
+    return quoted.at(-1) ?? fallback;
+}
+//# sourceMappingURL=demo-scenarios.js.map

package/dist/core/demo-scenarios.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"demo-scenarios.js","sourceRoot":"","sources":["../../src/core/demo-scenarios.ts"],"names":[],"mappings":"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"}

package/dist/core/demo-sources.d.ts

@@ -0,0 +1,37 @@
+import type { ProjectConfig } from "./config.js";
+export type ModuleConfig = {
+    module?: {
+        id?: string;
+    };
+    sources?: Record<string, ModuleSourceValue | undefined>;
+    runtime?: {
+        url?: string;
+    };
+    tests?: {
+        raw_cases?: string[];
+        derived_cases?: string[];
+        automated?: {
+            unit?: string[];
+            integration?: string[];
+            e2e?: string[];
+        };
+    };
+};
+export type ModuleSourceValue = string[] | {
+    source?: string;
+    path?: string;
+    paths?: string[];
+    sections?: string[];
+};
+export type DemoSourceKind = "stage-doc" | "raw" | "test-case" | "existing-test" | "implementation";
+export type DemoSourceDoc = {
+    kind: DemoSourceKind;
+    path: string;
+    content: string;
+};
+export declare function collectDemoSourceBasis(target: string, config: ProjectConfig, moduleId: string, moduleConfig: ModuleConfig): Promise<DemoSourceDoc[]>;
+export declare function testCasePathsFromModule(moduleConfig: ModuleConfig): string[];
+export declare function selectDemoCaseSources(sourceBasis: DemoSourceDoc[]): DemoSourceDoc[];
+export declare function summarizeCaseSourceBasis(primary: DemoSourceDoc, sourceBasis: DemoSourceDoc[]): string[];
+export declare function summarizeText(content: string): string;
+export declare function inferRouteHint(content: string, runtimeUrl: string | undefined): string | undefined;

package/dist/core/demo-sources.js

@@ -0,0 +1,198 @@
+import { readdir, readFile, stat } from "node:fs/promises";
+import { join, relative, resolve } from "node:path";
+import { getWorkspacePath } from "./workspace-layout.js";
+export async function collectDemoSourceBasis(target, config, moduleId, moduleConfig) {
+    const docs = [];
+    const moduleRoot = resolve(target, getWorkspacePath(config, "moduleRoot", { module: moduleId }));
+    for (const name of ["proposal.md", "spec.md", "design.md", "tasks.md", "CONTEXT.md"]) {
+        const doc = await readDemoSourcePath(target, relative(target, join(moduleRoot, name)), "stage-doc");
+        if (doc)
+            docs.push(doc);
+    }
+    for (const path of testCasePathsFromModule(moduleConfig)) {
+        const doc = await readDemoSourcePath(target, path, "test-case");
+        if (doc)
+            docs.push(doc);
+    }
+    for (const path of automatedTestPathsFromModule(moduleConfig)) {
+        const doc = await readDemoSourcePath(target, path, "existing-test");
+        if (doc)
+            docs.push(doc);
+    }
+    for (const [sourceKey, value] of Object.entries(moduleConfig.sources ?? {})) {
+        for (const path of pathsFromModuleSourceValue(value)) {
+            const doc = await readDemoSourcePath(target, path, classifyModuleSource(sourceKey, path));
+            if (doc)
+                docs.push(doc);
+        }
+    }
+    return uniqueSourceDocs(docs);
+}
+export function testCasePathsFromModule(moduleConfig) {
+    return uniqueStrings([
+        ...(moduleConfig.tests?.raw_cases ?? []),
+        ...pathsFromNamedModuleSources(moduleConfig, ["testing", "test", "tests", "test_cases", "qa"]),
+    ]);
+}
+export function selectDemoCaseSources(sourceBasis) {
+    const testSources = sourceBasis.filter((source) => source.kind === "test-case");
+    if (testSources.length > 0)
+        return testSources.slice(0, 12);
+    const existingTests = sourceBasis.filter((source) => source.kind === "existing-test");
+    if (existingTests.length > 0)
+        return existingTests.slice(0, 8);
+    const stageDocs = sourceBasis.filter((source) => source.kind === "stage-doc" && /(?:spec|design|tasks)\.md$/i.test(source.path));
+    if (stageDocs.length > 0)
+        return stageDocs.slice(0, 3);
+    const rawSources = sourceBasis.filter((source) => source.kind === "raw");
+    if (rawSources.length > 0)
+        return rawSources.slice(0, 3);
+    return sourceBasis.slice(0, 1);
+}
+export function summarizeCaseSourceBasis(primary, sourceBasis) {
+    return uniqueStrings([
+        `${primary.kind}: ${primary.path}`,
+        ...sourceBasis
+            .filter((source) => source.path !== primary.path)
+            .slice(0, 6)
+            .map((source) => `${source.kind}: ${source.path}`),
+    ]);
+}
+export function summarizeText(content) {
+    const text = content
+        .split("\n")
+        .map((line) => line.trim())
+        .filter(Boolean)
+        .find((line) => !line.startsWith("#") && !line.startsWith("-")) ?? content.trim();
+    return truncate(text.replace(/\s+/g, " "), 180);
+}
+export function inferRouteHint(content, runtimeUrl) {
+    if (runtimeUrl?.trim())
+        return runtimeUrl.trim();
+    const route = content.match(/(?:route|url|path|页面|路由|入口)[:：]\s*`?((?:https?:\/\/|\/)[^\s`，,。)]+)/i);
+    return route?.[1]?.trim();
+}
+function automatedTestPathsFromModule(moduleConfig) {
+    return uniqueStrings([
+        ...(moduleConfig.tests?.derived_cases ?? []),
+        ...(moduleConfig.tests?.automated?.unit ?? []),
+        ...(moduleConfig.tests?.automated?.integration ?? []),
+        ...(moduleConfig.tests?.automated?.e2e ?? []),
+    ]);
+}
+function pathsFromNamedModuleSources(moduleConfig, names) {
+    const expected = new Set(names);
+    return Object.entries(moduleConfig.sources ?? {})
+        .filter(([key]) => expected.has(key.replace(/[-_]/g, "_")))
+        .flatMap(([, value]) => pathsFromModuleSourceValue(value));
+}
+function pathsFromModuleSourceValue(value) {
+    if (Array.isArray(value))
+        return value.filter(isNonEmptyString);
+    if (!value || typeof value !== "object")
+        return [];
+    return uniqueStrings([
+        typeof value.path === "string" ? value.path : undefined,
+        ...(Array.isArray(value.paths) ? value.paths : []),
+    ].filter(isNonEmptyString));
+}
+async function readDemoSourcePath(target, path, kind) {
+    if (!path || /[*?[\]{}]/.test(path))
+        return null;
+    const abs = resolve(target, path);
+    const info = await safeStat(abs);
+    if (!info)
+        return null;
+    const rel = relative(target, abs) || path;
+    if (info.isFile) {
+        const content = truncate(await readOptional(abs), 12_000);
+        if (!content.trim())
+            return null;
+        return { kind, path: rel, content };
+    }
+    if (!info.isDirectory)
+        return null;
+    const entries = await safeReadDir(abs);
+    const visible = entries
+        .filter((entry) => !entry.name.startsWith("."))
+        .sort((a, b) => a.name.localeCompare(b.name));
+    const files = visible.filter((entry) => entry.isFile()).slice(0, 24);
+    const snippets = [];
+    for (const entry of files.filter((file) => isReadableDemoSourceFile(file.name)).slice(0, kind === "implementation" ? 6 : 10)) {
+        const filePath = join(abs, entry.name);
+        const body = truncate(await readOptional(filePath), kind === "implementation" ? 2_000 : 4_000);
+        if (body.trim())
+            snippets.push(`## ${relative(target, filePath)}\n\n${body.trim()}`);
+    }
+    const content = [
+        `Directory: ${rel}`,
+        "",
+        "Files:",
+        ...visible.slice(0, 40).map((entry) => `- ${entry.name}${entry.isDirectory() ? "/" : ""}`),
+        "",
+        ...snippets,
+    ].join("\n");
+    return { kind, path: rel, content: truncate(content, 12_000) };
+}
+function classifyModuleSource(sourceKey, path) {
+    const key = `${sourceKey} ${path}`.toLowerCase();
+    if (/test|case|qa|spec\.|e2e|playwright|vitest|jest/.test(key))
+        return "test-case";
+    if (/code|implementation|repo|repository|src\/|app\/|components?\/|pages?\//.test(key))
+        return "implementation";
+    if (/raw|srs|prd|requirement|design|figma|issue|research|customer/.test(key))
+        return "raw";
+    return "raw";
+}
+async function readOptional(file) {
+    try {
+        return await readFile(file, "utf8");
+    }
+    catch {
+        return "";
+    }
+}
+async function safeStat(path) {
+    try {
+        const info = await stat(path);
+        return { isFile: info.isFile(), isDirectory: info.isDirectory() };
+    }
+    catch {
+        return null;
+    }
+}
+async function safeReadDir(path) {
+    try {
+        return await readdir(path, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+}
+function isReadableDemoSourceFile(name) {
+    return /\.(md|mdx|txt|yaml|yml|json|ts|tsx|js|jsx|vue|svelte|html)$/i.test(name);
+}
+function isNonEmptyString(value) {
+    return typeof value === "string" && value.trim().length > 0;
+}
+function uniqueStrings(values) {
+    return Array.from(new Set(values.map((value) => value.trim()).filter(Boolean)));
+}
+function uniqueSourceDocs(values) {
+    const seen = new Set();
+    const docs = [];
+    for (const value of values) {
+        const key = value.path;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        docs.push(value);
+    }
+    return docs;
+}
+function truncate(value, max) {
+    if (value.length <= max)
+        return value;
+    return `${value.slice(0, max - 24).trimEnd()}\n...[truncated by zsk]`;
+}
+//# sourceMappingURL=demo-sources.js.map

package/dist/core/demo-sources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"demo-sources.js","sourceRoot":"","sources":["../../src/core/demo-sources.ts"],"names":[],"mappings":"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"}

package/dist/core/mcp-registry-discovery.d.ts

@@ -0,0 +1,16 @@
+export type McpRegistryRegistration = {
+    name: string;
+    host: "workspace" | "vscode";
+    scope: "workspace" | "user";
+    configPath: string;
+    transport?: "stdio" | "http" | "sse";
+    commandLabel?: string;
+    url?: string;
+    envKeys: string[];
+    staticTools?: string[];
+};
+export type McpRegistryDiscovery = {
+    registrations: McpRegistryRegistration[];
+    warnings: string[];
+};
+export declare function discoverMcpRegistries(target: string): Promise<McpRegistryDiscovery>;