@qulib/core 0.6.0 → 0.7.0

package/dist/adapters/cypress-e2e-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cypress-e2e-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/cypress-e2e-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAExF,qBAAa,iBAAkB,YAAW,WAAW;IACnD,QAAQ,CAAC,WAAW,iBAAiB;IAErC,MAAM,CAAC,QAAQ,EAAE,eAAe,GAAG,aAAa;IAIhD,SAAS,CAAC,SAAS,EAAE,eAAe,EAAE,GAAG,aAAa,EAAE;CAGzD"}
+{"version":3,"file":"cypress-e2e-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/cypress-e2e-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAY,MAAM,mCAAmC,CAAC;AA2ClG,qBAAa,iBAAkB,YAAW,WAAW;IACnD,QAAQ,CAAC,WAAW,iBAAiB;IAErC,MAAM,CAAC,QAAQ,EAAE,eAAe,GAAG,aAAa;IA4BhD,SAAS,CAAC,SAAS,EAAE,eAAe,EAAE,GAAG,aAAa,EAAE;CAGzD"}

package/dist/adapters/cypress-e2e-adapter.js

@@ -1,9 +1,70 @@
+function slugify(title) {
+    return title
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-|-$/g, '');
+}
+function renderStep(step) {
+    const t = step.target != null ? JSON.stringify(step.target) : null;
+    const v = step.value != null ? JSON.stringify(step.value) : null;
+    switch (step.action) {
+        case 'navigate':
+            return `    cy.visit(${JSON.stringify(step.target ?? step.value ?? '/')});`;
+        case 'click':
+            return t ? `    cy.get(${t}).click();` : `    // click: ${step.description}`;
+        case 'type':
+            return t && v ? `    cy.get(${t}).type(${v});` : `    // type: ${step.description}`;
+        case 'assert-visible':
+            return t ? `    cy.get(${t}).should('be.visible');` : `    cy.get('body').should('be.visible');`;
+        case 'assert-hidden':
+            return t ? `    cy.get(${t}).should('not.be.visible');` : `    // assert-hidden: ${step.description}`;
+        case 'assert-text':
+            if (t && v)
+                return `    cy.get(${t}).should('contain.text', ${v});`;
+            if (t)
+                return `    cy.get(${t}).should('not.be.empty');`;
+            return `    // assert-text: ${step.description}`;
+        case 'assert-disabled':
+            return t ? `    cy.get(${t}).should('be.disabled');` : `    // assert-disabled: ${step.description}`;
+        case 'assert-count':
+            return t
+                ? `    cy.get(${t}).should('have.length.gte', ${parseInt(step.value ?? '1', 10)});`
+                : `    // assert-count: ${step.description}`;
+        case 'wait':
+            return `    cy.wait(${parseInt(step.value ?? '1000', 10)});`;
+        case 'api-call':
+            return `    cy.request(${JSON.stringify(step.target ?? step.value ?? '/')}).its('status').should('eq', 200);`;
+        default:
+            return `    // TODO: ${step.description}`;
+    }
+}
 export class CypressE2EAdapter {
     adapterType = 'cypress-e2e';
     render(scenario) {
-        throw new Error('Not implemented');
+        const slug = slugify(scenario.title);
+        const filename = `${slug}.cy.ts`;
+        const stepLines = scenario.steps.map(renderStep).join('\n');
+        const code = [
+            `// ${scenario.description}`,
+            `// qulib-generated — scenario: ${scenario.id}`,
+            ``,
+            `describe(${JSON.stringify(scenario.title)}, () => {`,
+            `  it(${JSON.stringify(scenario.description)}, () => {`,
+            stepLines || `    // no steps — add assertions for: ${scenario.targetPath}`,
+            `  });`,
+            `});`,
+            ``,
+        ].join('\n');
+        return {
+            scenarioId: scenario.id,
+            adapter: 'cypress-e2e',
+            filename,
+            code,
+            source: 'template',
+            outputPath: `cypress/e2e/${filename}`,
+        };
     }
     renderAll(scenarios) {
-        throw new Error('Not implemented');
+        return scenarios.map((s) => this.render(s));
     }
 }

package/dist/index.d.ts

@@ -7,6 +7,8 @@ export { exploreAuth } from './tools/auth/explore.js';
 export { addUserProvider, removeUserProvider, listUserProviders } from './tools/auth/custom-providers.js';
 export { scanRepo } from './tools/repo/scan.js';
 export { computeAutomationMaturity } from './tools/scoring/automation-maturity.js';
+export { scaffoldTests } from './scaffold-tests.js';
+export type { ScaffoldOptions, ScaffoldResult, ProjectConfig } from './scaffold-tests.js';
 export { createProvider } from './llm/provider-registry.js';
 export { resolveMaxOutputTokensPerLlmCall } from './schemas/config.schema.js';
 export { resolveScanStateBaseDir, resolveReportDir } from './harness/state-manager.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,YAAY,EACV,YAAY,EACZ,kBAAkB,EAClB,SAAS,EACT,cAAc,EACd,uBAAuB,GACxB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,UAAU,EACV,oBAAoB,EACpB,4BAA4B,EAC5B,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,yBAAyB,EACzB,4BAA4B,GAC7B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAC1G,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,yBAAyB,EAAE,MAAM,wCAAwC,CAAC;AACnF,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,gCAAgC,EAAE,MAAM,4BAA4B,CAAC;AAC9E,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACvF,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACjF,YAAY,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACrE,YAAY,EACV,aAAa,EACb,cAAc,EACd,kBAAkB,GACnB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC9E,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,YAAY,EACV,aAAa,EACb,UAAU,EACV,cAAc,EACd,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,QAAQ,EACR,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,qBAAqB,EACrB,aAAa,EACb,kBAAkB,EAClB,2BAA2B,EAC3B,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,YAAY,EACV,YAAY,EACZ,kBAAkB,EAClB,SAAS,EACT,cAAc,EACd,uBAAuB,GACxB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,UAAU,EACV,oBAAoB,EACpB,4BAA4B,EAC5B,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,yBAAyB,EACzB,4BAA4B,GAC7B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAC1G,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,yBAAyB,EAAE,MAAM,wCAAwC,CAAC;AACnF,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC1F,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,gCAAgC,EAAE,MAAM,4BAA4B,CAAC;AAC9E,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACvF,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACjF,YAAY,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACrE,YAAY,EACV,aAAa,EACb,cAAc,EACd,kBAAkB,GACnB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC9E,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,YAAY,EACV,aAAa,EACb,UAAU,EACV,cAAc,EACd,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,QAAQ,EACR,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,qBAAqB,EACrB,aAAa,EACb,kBAAkB,EAClB,2BAA2B,EAC3B,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -5,6 +5,7 @@ export { exploreAuth } from './tools/auth/explore.js';
 export { addUserProvider, removeUserProvider, listUserProviders } from './tools/auth/custom-providers.js';
 export { scanRepo } from './tools/repo/scan.js';
 export { computeAutomationMaturity } from './tools/scoring/automation-maturity.js';
+export { scaffoldTests } from './scaffold-tests.js';
 export { createProvider } from './llm/provider-registry.js';
 export { resolveMaxOutputTokensPerLlmCall } from './schemas/config.schema.js';
 export { resolveScanStateBaseDir, resolveReportDir } from './harness/state-manager.js';

package/dist/scaffold-tests.d.ts

@@ -0,0 +1,34 @@
+import type { NeutralScenario, GeneratedTest } from './schemas/gap-analysis.schema.js';
+import type { AdapterType } from './schemas/config.schema.js';
+import type { AnalyzeProgressSink } from './harness/progress-log.js';
+import type { TelemetrySink } from './telemetry/telemetry.interface.js';
+export interface ScaffoldOptions {
+    framework?: Extract<AdapterType, 'cypress-e2e' | 'playwright'>;
+    maxPagesToScan?: number;
+    scenarios?: NeutralScenario[];
+    progressLog?: AnalyzeProgressSink;
+    telemetry?: TelemetrySink;
+}
+export interface ProjectConfig {
+    configFile: {
+        filename: string;
+        code: string;
+    };
+    packageJson: {
+        devDependencies: Record<string, string>;
+        scripts: Record<string, string>;
+    };
+    supportFiles: Array<{
+        filename: string;
+        code: string;
+    }>;
+}
+export interface ScaffoldResult {
+    url: string;
+    framework: Extract<AdapterType, 'cypress-e2e' | 'playwright'>;
+    generatedTests: GeneratedTest[];
+    scenarios: NeutralScenario[];
+    projectConfig: ProjectConfig;
+}
+export declare function scaffoldTests(url: string, options?: ScaffoldOptions): Promise<ScaffoldResult>;
+//# sourceMappingURL=scaffold-tests.d.ts.map

package/dist/scaffold-tests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold-tests.d.ts","sourceRoot":"","sources":["../src/scaffold-tests.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACvF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AAExE,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,OAAO,CAAC,WAAW,EAAE,aAAa,GAAG,YAAY,CAAC,CAAC;IAC/D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,eAAe,EAAE,CAAC;IAC9B,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAClC,SAAS,CAAC,EAAE,aAAa,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,WAAW,EAAE;QAAE,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC;IAC1F,YAAY,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACzD;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,OAAO,CAAC,WAAW,EAAE,aAAa,GAAG,YAAY,CAAC,CAAC;IAC9D,cAAc,EAAE,aAAa,EAAE,CAAC;IAChC,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,aAAa,EAAE,aAAa,CAAC;CAC9B;AA8ED,wBAAsB,aAAa,CACjC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,cAAc,CAAC,CAyCzB"}

package/dist/scaffold-tests.js

@@ -0,0 +1,113 @@
+import { analyzeApp } from './analyze.js';
+import { createAdapter } from './adapters/adapter-factory.js';
+function buildCypressProjectConfig(url) {
+    return {
+        configFile: {
+            filename: 'cypress.config.ts',
+            code: [
+                `import { defineConfig } from 'cypress';`,
+                ``,
+                `export default defineConfig({`,
+                `  e2e: {`,
+                `    baseUrl: ${JSON.stringify(url)},`,
+                `    viewportWidth: 1280,`,
+                `    viewportHeight: 720,`,
+                `    defaultCommandTimeout: 10000,`,
+                `    pageLoadTimeout: 30000,`,
+                `    video: false,`,
+                `    screenshotOnRunFailure: true,`,
+                `    screenshotsFolder: 'results/screenshots',`,
+                `    specPattern: 'cypress/e2e/**/*.cy.ts',`,
+                `    supportFile: 'cypress/support/e2e.ts',`,
+                `  },`,
+                `});`,
+                ``,
+            ].join('\n'),
+        },
+        packageJson: {
+            devDependencies: {
+                cypress: '^13.0.0',
+                typescript: '^5.4.0',
+            },
+            scripts: {
+                test: 'cypress run',
+                'test:headed': 'cypress open',
+                'test:ci': 'cypress run --reporter json --reporter-options output=results/cypress-results.json',
+            },
+        },
+        supportFiles: [
+            {
+                filename: 'cypress/support/e2e.ts',
+                code: [
+                    `Cypress.on('uncaught:exception', () => false);`,
+                    ``,
+                ].join('\n'),
+            },
+        ],
+    };
+}
+function buildPlaywrightProjectConfig(url) {
+    return {
+        configFile: {
+            filename: 'playwright.config.ts',
+            code: [
+                `import { defineConfig, devices } from '@playwright/test';`,
+                ``,
+                `export default defineConfig({`,
+                `  use: { baseURL: ${JSON.stringify(url)} },`,
+                `  projects: [{ name: 'chromium', use: { ...devices['Desktop Chrome'] } }],`,
+                `});`,
+                ``,
+            ].join('\n'),
+        },
+        packageJson: {
+            devDependencies: {
+                '@playwright/test': '^1.44.0',
+                typescript: '^5.4.0',
+            },
+            scripts: {
+                test: 'playwright test',
+                'test:headed': 'playwright test --headed',
+                'test:ci': 'playwright test --reporter=json',
+            },
+        },
+        supportFiles: [],
+    };
+}
+export async function scaffoldTests(url, options = {}) {
+    const framework = options.framework ?? 'cypress-e2e';
+    let scenarios;
+    if (options.scenarios && options.scenarios.length > 0) {
+        scenarios = options.scenarios;
+    }
+    else {
+        const result = await analyzeApp({
+            url,
+            config: {
+                maxPagesToScan: options.maxPagesToScan ?? 10,
+                maxDepth: 3,
+                minPagesForConfidence: 3,
+                timeoutMs: 30000,
+                retryCount: 0,
+                llmTokenBudget: 4096,
+                testGenerationLimit: 10,
+                enableLlmScenarios: true,
+                readOnlyMode: true,
+                requireHumanReview: false,
+                failOnConsoleError: false,
+                explorer: 'playwright',
+                defaultAdapter: framework,
+                adapters: [framework],
+            },
+            progressLog: options.progressLog,
+            telemetry: options.telemetry,
+        });
+        scenarios = result.gapAnalysis.scenarios;
+    }
+    const adapter = createAdapter(framework);
+    const generatedTests = adapter.renderAll(scenarios);
+    const projectConfig = framework === 'cypress-e2e'
+        ? buildCypressProjectConfig(url)
+        : buildPlaywrightProjectConfig(url);
+    return { url, framework, generatedTests, scenarios, projectConfig };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qulib/core",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "Qulib — analyze deployed web apps for honest quality gaps (CLI + programmatic API)",
   "license": "MIT",
   "author": "Tapesh Nagarwal",