swipium 1.0.0

package/dist/testSuite/schema.js

@@ -0,0 +1,86 @@
+// Canonical persistent QA test-case suite schema (SWIPIUM-REQ-06). This is the long-lived,
+// project-level QA knowledge that grows with the app map — distinct from the per-run test catalog
+// (src/report/testCatalog.ts) and the per-suite POM catalog (src/suite/testcase.ts), which are
+// snapshots. A CanonicalTestCase carries manual + automated coverage, expected vs. actual results,
+// creativity level, automation readiness, traceability to the app/tickets/requirements, and a
+// historical run ledger. PURE: types + validation + id helpers only; the store (store.ts) does IO.
+export const TEST_SUITE_SCHEMA_VERSION = 1;
+export const PRIORITIES = ['P0', 'P1', 'P2', 'P3'];
+export const CASE_TYPES = ['smoke', 'functional', 'regression', 'negative', 'edge', 'accessibility', 'visual', 'performance', 'security'];
+export const CREATIVITY_LEVELS = ['conservative', 'standard', 'creative', 'adversarial'];
+export const CASE_STATUSES = ['active', 'draft', 'deprecated', 'blocked', 'manual_only'];
+export const ACTUAL_STATUSES = ['pass', 'fail', 'blocked', 'skipped', 'not_run'];
+export const AUTOMATION_STATUSES = ['automated', 'partial', 'manual', 'candidate', 'not_automatable_yet'];
+export const LOCATOR_READINESS = ['A', 'B', 'C', 'D'];
+/** Fields populated by generation; everything else is curated/manual and never overwritten silently. */
+export const GENERATED_FIELDS = [
+    'steps',
+    'expectedResult',
+    'automation',
+    'mapLinks',
+    'preconditions',
+    'fixtures',
+    'testData',
+];
+export function emptySuite(appId, now = new Date().toISOString()) {
+    return { schemaVersion: TEST_SUITE_SCHEMA_VERSION, updatedAt: now, appId, cases: [], retiredIds: [] };
+}
+/** Slugify a functionality label into a stable, filesystem-safe segment (e.g. "Weather Analysis" → "weather-analysis"). */
+export function functionalitySlug(functionality) {
+    return (functionality
+        .replace(/([a-z0-9])([A-Z])/g, '$1-$2')
+        .replace(/[^A-Za-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .toLowerCase() || 'general');
+}
+/** Derive the ID prefix token for a functionality (e.g. "weather-analysis" → "WEATHER"). */
+export function idPrefix(functionality) {
+    const slug = functionalitySlug(functionality);
+    const token = slug.split('-')[0] || 'gen';
+    return token.replace(/[^a-z0-9]/g, '').slice(0, 10).toUpperCase() || 'GEN';
+}
+/** A normalized identity key for de-duplication: feature + objective + ordered (action→target) steps. */
+export function caseIdentity(c) {
+    const norm = (s) => s.trim().toLowerCase().replace(/\s+/g, ' ');
+    const stepKey = c.steps.map((s) => `${norm(s.action)}>${norm(s.target ?? '')}`).join('|');
+    return `${norm(c.featureId)}::${norm(c.objective)}::${stepKey}`;
+}
+/** Validate a single canonical case, returning human-readable errors (empty = valid). */
+export function validateCase(c) {
+    const errors = [];
+    const must = (cond, msg) => {
+        if (!cond)
+            errors.push(msg);
+    };
+    must(c.schemaVersion === TEST_SUITE_SCHEMA_VERSION, `schemaVersion must be ${TEST_SUITE_SCHEMA_VERSION}`);
+    must(!!c.id, 'id is required');
+    must(!!c.featureId, `${c.id}: featureId is required`);
+    must(!!c.functionality, `${c.id}: functionality is required`);
+    must(!!c.title, `${c.id}: title is required`);
+    must(PRIORITIES.includes(c.priority), `${c.id}: invalid priority ${c.priority}`);
+    must(CASE_TYPES.includes(c.type), `${c.id}: invalid type ${c.type}`);
+    must(CREATIVITY_LEVELS.includes(c.creativityLevel), `${c.id}: invalid creativityLevel ${c.creativityLevel}`);
+    must(CASE_STATUSES.includes(c.status), `${c.id}: invalid status ${c.status}`);
+    must(Array.isArray(c.platforms) && c.platforms.length > 0, `${c.id}: at least one platform required`);
+    must(Array.isArray(c.steps), `${c.id}: steps must be an array`);
+    must(Array.isArray(c.expectedResult), `${c.id}: expectedResult must be an array`);
+    must(!!c.actualResult && ACTUAL_STATUSES.includes(c.actualResult.status), `${c.id}: invalid actualResult.status`);
+    must(!!c.automation && AUTOMATION_STATUSES.includes(c.automation.status), `${c.id}: invalid automation.status`);
+    must(!!c.automation && LOCATOR_READINESS.includes(c.automation.locatorReadiness), `${c.id}: invalid automation.locatorReadiness`);
+    return errors;
+}
+/** Validate the whole suite (per-case + duplicate-id check). */
+export function validateSuite(suite) {
+    const errors = [];
+    if (suite.schemaVersion !== TEST_SUITE_SCHEMA_VERSION)
+        errors.push(`suite schemaVersion must be ${TEST_SUITE_SCHEMA_VERSION}`);
+    const seen = new Set();
+    for (const c of suite.cases) {
+        if (seen.has(c.id))
+            errors.push(`duplicate id ${c.id}`);
+        seen.add(c.id);
+        errors.push(...validateCase(c));
+    }
+    return errors;
+}
+//# sourceMappingURL=schema.js.map

package/dist/testSuite/schema.js.map

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

package/dist/testSuite/store.js

@@ -0,0 +1,116 @@
+// Persistent-suite store (SWIPIUM-REQ-06 "Suite Store Requirements"). The ONLY module here that does
+// IO: it owns `.swipium/test-suite.json`, the per-functionality `.swipium/test-suite/<func>/<id>.yaml`
+// mirror, and the `.swipium/test-runs/<runId>.json` ledger. Everything it persists is produced by the
+// pure modules (schema/merge/generator/history) so the on-disk format is deterministic and testable.
+import { mkdirSync, writeFileSync, readFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { stringify } from 'yaml';
+import { emptySuite, functionalitySlug, validateSuite, TEST_SUITE_SCHEMA_VERSION, } from './schema.js';
+import { mergeCases } from './merge.js';
+import { buildRunLedger } from './history.js';
+export function suiteRoot(root) {
+    return join(root, '.swipium');
+}
+export function suiteJsonPath(root) {
+    return join(suiteRoot(root), 'test-suite.json');
+}
+export function suiteCasesDir(root) {
+    return join(suiteRoot(root), 'test-suite');
+}
+export function testRunsDir(root) {
+    return join(suiteRoot(root), 'test-runs');
+}
+/** Resource URI for the canonical suite of a session (mirrors the swipium:// artifact scheme). */
+export function suiteResourceUri(sessionId) {
+    return `swipium://session/${sessionId}/test-suite/test-suite.json`;
+}
+/** A filesystem-safe run id from an ISO timestamp (no clock read here — caller passes `now`). */
+export function runIdFromNow(now) {
+    return now.replace(/[:.]/g, '-');
+}
+/** Load the persistent suite, returning an empty suite when none exists yet. */
+export function loadSuite(root, appId) {
+    const path = suiteJsonPath(root);
+    if (!existsSync(path))
+        return emptySuite(appId);
+    try {
+        const parsed = JSON.parse(readFileSync(path, 'utf8'));
+        return {
+            schemaVersion: TEST_SUITE_SCHEMA_VERSION,
+            updatedAt: parsed.updatedAt ?? new Date(0).toISOString(),
+            appId: parsed.appId ?? appId,
+            cases: Array.isArray(parsed.cases) ? parsed.cases : [],
+            retiredIds: Array.isArray(parsed.retiredIds) ? parsed.retiredIds : [],
+        };
+    }
+    catch {
+        return emptySuite(appId);
+    }
+}
+/** Persist the suite JSON + the per-functionality YAML mirror. Returns absolute paths written. */
+export function saveSuite(root, suite) {
+    const written = [];
+    const base = suiteRoot(root);
+    mkdirSync(base, { recursive: true });
+    const jsonPath = suiteJsonPath(root);
+    writeFileSync(jsonPath, JSON.stringify(suite, null, 2));
+    written.push(jsonPath);
+    for (const c of suite.cases) {
+        const dir = join(suiteCasesDir(root), functionalitySlug(c.functionality));
+        mkdirSync(dir, { recursive: true });
+        const yamlPath = join(dir, `${c.id}.yaml`);
+        writeFileSync(yamlPath, stringify(c));
+        written.push(yamlPath);
+    }
+    return written;
+}
+/** Append a per-run ledger file. Returns the absolute path written. */
+export function recordRun(root, ledger) {
+    const dir = testRunsDir(root);
+    mkdirSync(dir, { recursive: true });
+    const path = join(dir, `${runIdFromNow(ledger.at)}.json`);
+    writeFileSync(path, JSON.stringify(ledger, null, 2));
+    return path;
+}
+/**
+ * Full disk round-trip: load → merge → validate → save → record run ledger. The single entry point
+ * every integration hook (qa_test_this / report / explore / feature / ticket) calls so the suite is
+ * updated consistently from one place.
+ */
+export function applyMerge(root, incoming, opts, appId) {
+    const suite = loadSuite(root, appId);
+    const result = mergeCases(suite, incoming, opts);
+    const validationErrors = validateSuite(result.suite);
+    const written = saveSuite(root, result.suite);
+    const ledger = buildRunLedger(result.suite.cases, {
+        runId: opts.runId,
+        at: opts.now,
+        source: opts.source,
+        sourceUri: opts.sourceUri,
+        created: result.created,
+        updated: result.updated,
+        deprecated: result.deprecated,
+    });
+    const runPath = recordRun(root, ledger);
+    return { result, ledger, validationErrors, written, runPath };
+}
+export function suiteDelta(suite, result) {
+    const touched = new Set([...result.created, ...result.updated]);
+    const byId = new Map(suite.cases.map((c) => [c.id, c]));
+    const failed = [];
+    const blocked = [];
+    const newlyAutomated = [];
+    for (const id of touched) {
+        const c = byId.get(id);
+        if (!c)
+            continue;
+        if (c.actualResult.status === 'fail')
+            failed.push(id);
+        if (c.actualResult.status === 'blocked' || c.status === 'blocked')
+            blocked.push(id);
+        if (result.created.includes(id) ? c.automation.status === 'automated' || c.automation.status === 'partial' : false)
+            newlyAutomated.push(id);
+    }
+    return { totalCases: suite.cases.length, created: result.created, updated: result.updated, deprecated: result.deprecated, failed, blocked, newlyAutomated };
+}
+//# sourceMappingURL=store.js.map

package/dist/testSuite/store.js.map

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

package/dist/testSuite/traceability.js

@@ -0,0 +1,55 @@
+// Traceability helpers (SWIPIUM-REQ-06 "Integration Requirements"). PURE. Build the links that tie a
+// canonical case back to the app map, runtime screens, source files, tickets, requirements, and
+// evidence so the persistent suite is navigable rather than a flat list of steps.
+/** Build app-map links from POM page names + the runtime screens touched while recording. */
+export function buildMapLinks(input) {
+    const links = [];
+    const seen = new Set();
+    const push = (kind, id, label) => {
+        if (!id)
+            return;
+        const key = `${kind}:${id}`;
+        if (seen.has(key))
+            return;
+        seen.add(key);
+        links.push({ kind, id, ...(label ? { label } : {}) });
+    };
+    if (input.featureId)
+        push('feature', input.featureId);
+    for (const p of input.pages ?? [])
+        push('static_screen', p, p);
+    for (const s of input.screens ?? [])
+        push('runtime_screen', s);
+    return links;
+}
+/** Normalize a list of evidence URIs/records into EvidenceRef[], de-duped by uri. */
+export function buildEvidence(uris) {
+    const out = [];
+    const seen = new Set();
+    for (const u of uris) {
+        if (!u)
+            continue;
+        const ref = typeof u === 'string' ? { uri: u } : u;
+        if (!ref.uri || seen.has(ref.uri))
+            continue;
+        seen.add(ref.uri);
+        out.push(ref);
+    }
+    return out;
+}
+/** Pull ticket-like and requirement-like tokens out of a free-text label (e.g. "JIRA-123", "SWIPIUM-REQ-06"). */
+export function extractRefs(text) {
+    const ticketRefs = [];
+    const requirementRefs = [];
+    if (!text)
+        return { ticketRefs, requirementRefs };
+    for (const m of text.matchAll(/\b([A-Z][A-Z0-9]+-(?:REQ-)?\d+)\b/g)) {
+        const token = m[1];
+        if (/-REQ-/.test(token))
+            requirementRefs.push(token);
+        else
+            ticketRefs.push(token);
+    }
+    return { ticketRefs: Array.from(new Set(ticketRefs)), requirementRefs: Array.from(new Set(requirementRefs)) };
+}
+//# sourceMappingURL=traceability.js.map

package/dist/testSuite/traceability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"traceability.js","sourceRoot":"","sources":["../../src/testSuite/traceability.ts"],"names":[],"mappings":"AAAA,qGAAqG;AACrG,gGAAgG;AAChG,kFAAkF;AAIlF,6FAA6F;AAC7F,MAAM,UAAU,aAAa,CAAC,KAAmE;IAC/F,MAAM,KAAK,GAAiB,EAAE,CAAC;IAC/B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,IAAI,GAAG,CAAC,IAAwB,EAAE,EAAU,EAAE,KAAc,EAAE,EAAE;QACpE,IAAI,CAAC,EAAE;YAAE,OAAO;QAChB,MAAM,GAAG,GAAG,GAAG,IAAI,IAAI,EAAE,EAAE,CAAC;QAC5B,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,OAAO;QAC1B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACxD,CAAC,CAAC;IACF,IAAI,KAAK,CAAC,SAAS;QAAE,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IACtD,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,KAAK,IAAI,EAAE;QAAE,IAAI,CAAC,eAAe,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC/D,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,IAAI,EAAE;QAAE,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC;IAC/D,OAAO,KAAK,CAAC;AACf,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,aAAa,CAAC,IAAoD;IAChF,MAAM,GAAG,GAAkB,EAAE,CAAC;IAC9B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,IAAI,CAAC,CAAC;YAAE,SAAS;QACjB,MAAM,GAAG,GAAgB,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAChE,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QAC5C,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClB,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,iHAAiH;AACjH,MAAM,UAAU,WAAW,CAAC,IAAwB;IAClD,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,MAAM,eAAe,GAAa,EAAE,CAAC;IACrC,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,CAAC;IAClD,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,oCAAoC,CAAC,EAAE,CAAC;QACpE,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACnB,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;YAAE,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;;YAChD,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,EAAE,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC,EAAE,eAAe,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,eAAe,CAAC,CAAC,EAAE,CAAC;AAChH,CAAC"}