playwright-intelligence-engine 0.0.0-stage → 2.0.0

package/dist/selector/candidate-extractor.d.ts

@@ -0,0 +1,71 @@
+import { ResolvedElement } from '../trace/snapshot-resolver.js';
+import { FailedAction } from '../core/types/diagnostic-context.js';
+export type LocatorPlan = {
+    kind: 'getByRole';
+    role: string;
+    options?: {
+        name?: string;
+        exact?: boolean;
+    };
+} | {
+    kind: 'getByText';
+    text: string;
+    options?: {
+        exact?: boolean;
+    };
+} | {
+    kind: 'getByLabel';
+    label: string;
+    options?: {
+        exact?: boolean;
+    };
+} | {
+    kind: 'getByPlaceholder';
+    placeholder: string;
+    options?: {
+        exact?: boolean;
+    };
+} | {
+    kind: 'getByTestId';
+    testId: string;
+} | {
+    kind: 'locator';
+    selector: string;
+};
+export declare class CandidateExtractor {
+    /**
+     * Safely escapes a string literal for embedding inside TypeScript single-quoted strings.
+     * Handles backslashes, quotes, newlines, tabs, and unicode line separators.
+     */
+    static escapeLocatorString(val: string): string;
+    /**
+     * Discovers the page property identifier used in a Page Object class using AST analysis.
+     * Inspects class property declarations, constructor parameters, and inheritance context.
+     * Does NOT rely on loose substring search in comments or unrelated text.
+     */
+    static discoverPageProperty(source?: string): string;
+    /**
+     * Generates a strongly typed, safe LocatorPlan representing a Playwright locator intent.
+     * Strictly refuses to generate bare tag fallbacks.
+     */
+    static generateLocatorPlan(el: ResolvedElement): LocatorPlan;
+    /**
+     * Converts a typed LocatorPlan into an approved TypeScript expression string.
+     */
+    static planToExpression(plan: LocatorPlan, pageProperty?: string): string;
+    /**
+     * Generates a modern, user-centric Playwright locator expression.
+     * Delegates to generateLocatorPlan and planToExpression.
+     * Throws EngineError('INSUFFICIENT_IDENTIFIERS') if element lacks distinctive attributes.
+     */
+    static generateLocator(el: ResolvedElement, pageProperty?: string): string;
+    /**
+     * Extracts candidate elements from a resolved DOM tree matching the target action's semantics.
+     * Requires genuine semantic or structural affinity.
+     */
+    static extractCandidates(root: ResolvedElement, actionOrFailedAction?: FailedAction | {
+        action?: string | undefined;
+        selector?: string | undefined;
+    } | string): ResolvedElement[];
+}
+//# sourceMappingURL=candidate-extractor.d.ts.map

package/dist/selector/candidate-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"candidate-extractor.d.ts","sourceRoot":"","sources":["../../src/selector/candidate-extractor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAoB,MAAM,+BAA+B,CAAC;AAClF,OAAO,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AAGnE,MAAM,MAAM,WAAW,GACnB;IACE,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB,CAAC;CACH,GACD;IACE,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB,CAAC;CACH,GACD;IACE,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB,CAAC;CACH,GACD;IACE,IAAI,EAAE,kBAAkB,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB,CAAC;CACH,GACD;IACE,IAAI,EAAE,aAAa,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB,GACD;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEN,qBAAa,kBAAkB;IAC7B;;;OAGG;IACH,OAAc,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CASrD;IAED;;;;OAIG;IACH,OAAc,oBAAoB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAuD1D;IAED;;;OAGG;IACH,OAAc,mBAAmB,CAAC,EAAE,EAAE,eAAe,GAAG,WAAW,CAwGlE;IAED;;OAEG;IACH,OAAc,gBAAgB,CAAC,IAAI,EAAE,WAAW,EAAE,YAAY,SAAc,GAAG,MAAM,CA+BpF;IAED;;;;OAIG;IACH,OAAc,eAAe,CAAC,EAAE,EAAE,eAAe,EAAE,YAAY,SAAc,GAAG,MAAM,CAGrF;IAED;;;OAGG;IACH,OAAc,iBAAiB,CAC7B,IAAI,EAAE,eAAe,EACrB,oBAAoB,CAAC,EAAE,YAAY,GAAG;QAAE,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,GAAG,MAAM,GAC5G,eAAe,EAAE,CAwDnB;CACF"}

package/dist/selector/live-locator-verifier.d.ts

@@ -0,0 +1,28 @@
+import { LocatorPlan } from './candidate-extractor.js';
+export interface LiveVerificationResult {
+    isUnique: boolean;
+    count: number;
+    isVisible: boolean;
+    isEnabled: boolean;
+    plan: LocatorPlan;
+    expression: string;
+    reason?: string;
+}
+/**
+ * Safely resolves typed LocatorPlan instances to live Playwright Locator objects
+ * and empirically tests count(), isVisible(), and isEnabled() against the live browser DOM.
+ * Strictly enforces that count() === 1 for uniqueness (AUDIT-13).
+ */
+export declare class LiveLocatorVerifier {
+    static locate(pageOrFrame: any, plan: LocatorPlan): any;
+    /**
+     * Dispatches typed LocatorPlan to official Playwright Page/Frame API methods.
+     * Completely avoids eval or arbitrary code execution.
+     */
+    static resolveLocator(pageOrFrame: any, plan: LocatorPlan): any;
+    /**
+     * Empirically checks locator uniqueness (count === 1) and actionability in the live DOM.
+     */
+    static verify(pageOrFrame: any, plan: LocatorPlan): Promise<LiveVerificationResult>;
+}
+//# sourceMappingURL=live-locator-verifier.d.ts.map

package/dist/selector/live-locator-verifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-locator-verifier.d.ts","sourceRoot":"","sources":["../../src/selector/live-locator-verifier.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAsB,MAAM,0BAA0B,CAAC;AAE3E,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,WAAW,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,qBAAa,mBAAmB;IAC9B,OAAc,MAAM,CAAC,WAAW,EAAE,GAAG,EAAE,IAAI,EAAE,WAAW,GAAG,GAAG,CAE7D;IAED;;;OAGG;IACH,OAAc,cAAc,CAAC,WAAW,EAAE,GAAG,EAAE,IAAI,EAAE,WAAW,GAAG,GAAG,CAuCrE;IAED;;OAEG;IACH,OAAoB,MAAM,CAAC,WAAW,EAAE,GAAG,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAmE/F;CACF"}

package/dist/selector/repair-candidate-ranker.d.ts

@@ -0,0 +1,10 @@
+import { ProjectIntelligenceSnapshot } from '../intelligence/project-intelligence.js';
+import { ResolvedElement } from '../trace/snapshot-resolver.js';
+import { ScoredCandidate } from './abstention-policy.js';
+export interface RankedRepairCandidate extends ScoredCandidate {
+    locatorExpression: string;
+}
+export declare class RepairCandidateRanker {
+    static rank(candidates: ResolvedElement[], originalSelector?: string, intendedAction?: string, intelligence?: ProjectIntelligenceSnapshot, rootDom?: ResolvedElement, testIntentText?: string): RankedRepairCandidate[];
+}
+//# sourceMappingURL=repair-candidate-ranker.d.ts.map

package/dist/selector/repair-candidate-ranker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repair-candidate-ranker.d.ts","sourceRoot":"","sources":["../../src/selector/repair-candidate-ranker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAqC,MAAM,yCAAyC,CAAC;AAEzH,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAIzD,MAAM,WAAW,qBAAsB,SAAQ,eAAe;IAC5D,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAa,qBAAqB;IAChC,OAAc,IAAI,CAChB,UAAU,EAAE,eAAe,EAAE,EAC7B,gBAAgB,CAAC,EAAE,MAAM,EACzB,cAAc,CAAC,EAAE,MAAM,EACvB,YAAY,CAAC,EAAE,2BAA2B,EAC1C,OAAO,CAAC,EAAE,eAAe,EACzB,cAAc,CAAC,EAAE,MAAM,GACtB,qBAAqB,EAAE,CAuEzB;CACF"}

package/dist/selector/selector-scorer.d.ts

@@ -0,0 +1,43 @@
+import { ResolvedElement } from '../trace/snapshot-resolver.js';
+export interface ScorerWeights {
+    wU: number;
+    wI: number;
+    wM: number;
+    wA: number;
+    wH: number;
+    wD: number;
+}
+export interface ScoreBreakdown {
+    score: number;
+    transformedScore: number;
+    calibratedProbability: number;
+    uniqueness: number;
+    matchCount: number;
+    identityMatch: number;
+    semanticMatch: number;
+    actionability: number;
+    historicalReliability: number;
+    historicalExecutionReliability: number;
+    volatilePenalty: number;
+    conventionAlignment?: number;
+    explanation: string[];
+}
+export interface SelectorProjectContext {
+    preferredLocator?: 'getByRole' | 'getByTestId' | 'getByLabel' | 'getByText' | 'locator' | 'unknown';
+    /** Observed locator counts from the repository profile. */
+    locatorUsage?: Partial<Record<'getByRole' | 'getByTestId' | 'getByLabel' | 'getByText' | 'locator', number>>;
+}
+export declare class SelectorScorer {
+    static readonly DEFAULT_WEIGHTS: ScorerWeights;
+    /**
+     * Scores a candidate element against the multi-factor formula:
+     * S(L) = w1*U + w2*I + w3*M + w4*A + w5*H - w6*D
+     *
+     * Uniqueness evaluates whether the proposed locator resolves to exactly one element.
+     * Identity requires affirmative token overlap and rejects contradictory semantics.
+     * Actionability verifies enabled state and non-hidden status.
+     * Produces a transformed score (sigmoid scaling), not an overclaimed empirical probability.
+     */
+    static score(candidate: ResolvedElement, allCandidates: ResolvedElement[], originalSelector?: string, historicalScore?: number, weights?: ScorerWeights, projectContext?: SelectorProjectContext): ScoreBreakdown;
+}
+//# sourceMappingURL=selector-scorer.d.ts.map

package/dist/selector/selector-scorer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selector-scorer.d.ts","sourceRoot":"","sources":["../../src/selector/selector-scorer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAEhE,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,EAAE,MAAM,CAAC;IACzB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,8BAA8B,EAAE,MAAM,CAAC;IACvC,eAAe,EAAE,MAAM,CAAC;IACxB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,sBAAsB;IACrC,gBAAgB,CAAC,EAAE,WAAW,GAAG,aAAa,GAAG,YAAY,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,CAAC;IACpG,2DAA2D;IAC3D,YAAY,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,GAAG,aAAa,GAAG,YAAY,GAAG,WAAW,GAAG,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;CAC9G;AAcD,qBAAa,cAAc;IACzB,gBAAuB,eAAe,EAAE,aAAa,CAOnD;IAEF;;;;;;;;OAQG;IACH,OAAc,KAAK,CACjB,SAAS,EAAE,eAAe,EAC1B,aAAa,EAAE,eAAe,EAAE,EAChC,gBAAgB,CAAC,EAAE,MAAM,EACzB,eAAe,CAAC,EAAE,MAAM,EACxB,OAAO,gBAAiC,EACxC,cAAc,CAAC,EAAE,sBAAsB,GACtC,cAAc,CA+QhB;CACF"}

package/dist/trace/adapters/adapter-registry.d.ts

@@ -0,0 +1,18 @@
+import { TraceAdapter, ArchiveManifest } from './trace-adapter.js';
+export declare class TraceAdapterRegistry {
+    private static adapters;
+    private static fallbackAdapter;
+    /**
+     * Registers a custom or extended trace adapter.
+     */
+    static registerAdapter(adapter: TraceAdapter): void;
+    /**
+     * Resolves the matching TraceAdapter for a given trace format version.
+     */
+    static getAdapter(version: number): TraceAdapter;
+    /**
+     * Resolves the matching TraceAdapter for a given trace archive and sample lines.
+     */
+    static resolveAdapter(manifest: ArchiveManifest, sampleLines: string[]): TraceAdapter;
+}
+//# sourceMappingURL=adapter-registry.d.ts.map

package/dist/trace/adapters/adapter-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-registry.d.ts","sourceRoot":"","sources":["../../../src/trace/adapters/adapter-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAOnE,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAKrB;IAEF,OAAO,CAAC,MAAM,CAAC,eAAe,CAA6B;IAE3D;;OAEG;IACH,OAAc,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAEzD;IAED;;OAEG;IACH,OAAc,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CAOtD;IAED;;OAEG;IACH,OAAc,cAAc,CAAC,QAAQ,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,YAAY,CAO3F;CACF"}

package/dist/trace/adapters/trace-adapter.d.ts

@@ -0,0 +1,21 @@
+import { DiagnosticContext } from '../../core/types/diagnostic-context.js';
+export interface ArchiveManifest {
+    archivePath: string;
+    entryNames: string[];
+    traceEntryName?: string | undefined;
+    networkEntryName?: string | undefined;
+    stacksEntryName?: string | undefined;
+}
+export interface AdapterValidationResult {
+    isValid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+export interface TraceAdapter {
+    readonly adapterVersion: string;
+    readonly supportedFormatVersions: number[];
+    canParse(manifest: ArchiveManifest, sampleLines: string[]): boolean;
+    parse(manifest: ArchiveManifest, traceLines: string[], networkLines: string[]): Promise<DiagnosticContext>;
+    validate(context: DiagnosticContext): AdapterValidationResult;
+}
+//# sourceMappingURL=trace-adapter.d.ts.map

package/dist/trace/adapters/trace-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-adapter.d.ts","sourceRoot":"","sources":["../../../src/trace/adapters/trace-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAE3E,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,uBAAuB,EAAE,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,QAAQ,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IACpE,KAAK,CACH,QAAQ,EAAE,eAAe,EACzB,UAAU,EAAE,MAAM,EAAE,EACpB,YAAY,EAAE,MAAM,EAAE,GACrB,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,uBAAuB,CAAC;CAC/D"}

package/dist/trace/adapters/unknown-adapter.d.ts

@@ -0,0 +1,10 @@
+import { TraceAdapter, ArchiveManifest, AdapterValidationResult } from './trace-adapter.js';
+import { DiagnosticContext } from '../../core/types/diagnostic-context.js';
+export declare class UnknownTraceAdapter implements TraceAdapter {
+    readonly adapterVersion = "1.0.0-unsupported";
+    readonly supportedFormatVersions: number[];
+    canParse(_manifest: ArchiveManifest, _sampleLines: string[]): boolean;
+    parse(_manifest: ArchiveManifest, traceLines: string[], _networkLines: string[]): Promise<DiagnosticContext>;
+    validate(context: DiagnosticContext): AdapterValidationResult;
+}
+//# sourceMappingURL=unknown-adapter.d.ts.map

package/dist/trace/adapters/unknown-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unknown-adapter.d.ts","sourceRoot":"","sources":["../../../src/trace/adapters/unknown-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC5F,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAG3E,qBAAa,mBAAoB,YAAW,YAAY;IACtD,SAAgB,cAAc,uBAAuB;IACrD,SAAgB,uBAAuB,EAAE,MAAM,EAAE,CAAM;IAEhD,QAAQ,CAAC,SAAS,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,OAAO,CAE3E;IAEY,KAAK,CAChB,SAAS,EAAE,eAAe,EAC1B,UAAU,EAAE,MAAM,EAAE,EACpB,aAAa,EAAE,MAAM,EAAE,GACtB,OAAO,CAAC,iBAAiB,CAAC,CAqB5B;IAEM,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,uBAAuB,CAQnE;CACF"}

package/dist/trace/adapters/v10-adapter.d.ts

@@ -0,0 +1,10 @@
+import { TraceAdapter, ArchiveManifest, AdapterValidationResult } from './trace-adapter.js';
+import { DiagnosticContext } from '../../core/types/diagnostic-context.js';
+export declare class V10TraceAdapter implements TraceAdapter {
+    readonly adapterVersion = "1.0.0-v10";
+    readonly supportedFormatVersions: number[];
+    canParse(_manifest: ArchiveManifest, sampleLines: string[]): boolean;
+    parse(_manifest: ArchiveManifest, traceLines: string[], networkLines: string[]): Promise<DiagnosticContext>;
+    validate(context: DiagnosticContext): AdapterValidationResult;
+}
+//# sourceMappingURL=v10-adapter.d.ts.map

package/dist/trace/adapters/v10-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"v10-adapter.d.ts","sourceRoot":"","sources":["../../../src/trace/adapters/v10-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC5F,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAI3E,qBAAa,eAAgB,YAAW,YAAY;IAClD,SAAgB,cAAc,eAAe;IAC7C,SAAgB,uBAAuB,WAAQ;IAExC,QAAQ,CAAC,SAAS,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,OAAO,CAG1E;IAEY,KAAK,CAChB,SAAS,EAAE,eAAe,EAC1B,UAAU,EAAE,MAAM,EAAE,EACpB,YAAY,EAAE,MAAM,EAAE,GACrB,OAAO,CAAC,iBAAiB,CAAC,CAG5B;IAEM,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,uBAAuB,CAanE;CACF"}

package/dist/trace/adapters/v4-adapter.d.ts

@@ -0,0 +1,11 @@
+import { TraceAdapter, ArchiveManifest, AdapterValidationResult } from './trace-adapter.js';
+import { DiagnosticContext } from '../../core/types/diagnostic-context.js';
+/** Compatibility adapter for Playwright 1.32-era trace format v4. */
+export declare class V4TraceAdapter implements TraceAdapter {
+    readonly adapterVersion = "1.0.0-v4";
+    readonly supportedFormatVersions: number[];
+    canParse(_manifest: ArchiveManifest, sampleLines: string[]): boolean;
+    parse(_manifest: ArchiveManifest, traceLines: string[], networkLines: string[]): Promise<DiagnosticContext>;
+    validate(context: DiagnosticContext): AdapterValidationResult;
+}
+//# sourceMappingURL=v4-adapter.d.ts.map

package/dist/trace/adapters/v4-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"v4-adapter.d.ts","sourceRoot":"","sources":["../../../src/trace/adapters/v4-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC5F,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAI3E,qEAAqE;AACrE,qBAAa,cAAe,YAAW,YAAY;IACjD,SAAgB,cAAc,cAAc;IAC5C,SAAgB,uBAAuB,WAAO;IAEvC,QAAQ,CAAC,SAAS,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,OAAO,CAG1E;IAEY,KAAK,CAChB,SAAS,EAAE,eAAe,EAC1B,UAAU,EAAE,MAAM,EAAE,EACpB,YAAY,EAAE,MAAM,EAAE,GACrB,OAAO,CAAC,iBAAiB,CAAC,CAE5B;IAEM,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,uBAAuB,CAMnE;CACF"}

package/dist/trace/adapters/v8-adapter.d.ts

@@ -0,0 +1,10 @@
+import { TraceAdapter, ArchiveManifest, AdapterValidationResult } from './trace-adapter.js';
+import { DiagnosticContext } from '../../core/types/diagnostic-context.js';
+export declare class V8TraceAdapter implements TraceAdapter {
+    readonly adapterVersion = "1.0.0-v8";
+    readonly supportedFormatVersions: number[];
+    canParse(_manifest: ArchiveManifest, sampleLines: string[]): boolean;
+    parse(_manifest: ArchiveManifest, traceLines: string[], networkLines: string[]): Promise<DiagnosticContext>;
+    validate(context: DiagnosticContext): AdapterValidationResult;
+}
+//# sourceMappingURL=v8-adapter.d.ts.map

package/dist/trace/adapters/v8-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"v8-adapter.d.ts","sourceRoot":"","sources":["../../../src/trace/adapters/v8-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC5F,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAI3E,qBAAa,cAAe,YAAW,YAAY;IACjD,SAAgB,cAAc,cAAc;IAC5C,SAAgB,uBAAuB,WAAU;IAE1C,QAAQ,CAAC,SAAS,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,OAAO,CAG1E;IAEY,KAAK,CAChB,SAAS,EAAE,eAAe,EAC1B,UAAU,EAAE,MAAM,EAAE,EACpB,YAAY,EAAE,MAAM,EAAE,GACrB,OAAO,CAAC,iBAAiB,CAAC,CAI5B;IAEM,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,uBAAuB,CAgBnE;CACF"}

package/dist/trace/adapters/v9-adapter.d.ts

@@ -0,0 +1,10 @@
+import { TraceAdapter, ArchiveManifest, AdapterValidationResult } from './trace-adapter.js';
+import { DiagnosticContext } from '../../core/types/diagnostic-context.js';
+export declare class V9TraceAdapter implements TraceAdapter {
+    readonly adapterVersion = "1.0.0-v9";
+    readonly supportedFormatVersions: number[];
+    canParse(_manifest: ArchiveManifest, sampleLines: string[]): boolean;
+    parse(_manifest: ArchiveManifest, traceLines: string[], networkLines: string[]): Promise<DiagnosticContext>;
+    validate(context: DiagnosticContext): AdapterValidationResult;
+}
+//# sourceMappingURL=v9-adapter.d.ts.map

package/dist/trace/adapters/v9-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"v9-adapter.d.ts","sourceRoot":"","sources":["../../../src/trace/adapters/v9-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC5F,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAI3E,qBAAa,cAAe,YAAW,YAAY;IACjD,SAAgB,cAAc,cAAc;IAC5C,SAAgB,uBAAuB,WAAO;IAEvC,QAAQ,CAAC,SAAS,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,OAAO,CAG1E;IAEY,KAAK,CAChB,SAAS,EAAE,eAAe,EAC1B,UAAU,EAAE,MAAM,EAAE,EACpB,YAAY,EAAE,MAAM,EAAE,GACrB,OAAO,CAAC,iBAAiB,CAAC,CAG5B;IAEM,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,uBAAuB,CAanE;CACF"}

package/dist/trace/archive-reader.d.ts

@@ -0,0 +1,44 @@
+export interface UnpackOptions {
+    maxTotalSize?: number;
+    maxEntries?: number;
+    targetDir?: string;
+}
+export interface ExtractedTraceArchive {
+    archivePath: string;
+    extractDir: string;
+    entryNames: string[];
+    hasTraceEventFile: boolean;
+    hasNetworkEventFile: boolean;
+}
+export interface TraceEntryDiscovery {
+    /** Best stream for backward-compatible single-stream consumers. */
+    traceEntryName?: string | undefined;
+    networkEntryName?: string | undefined;
+    /** All streams, ordered with explicit failure streams first. */
+    traceEntryNames?: string[] | undefined;
+    networkEntryNames?: string[] | undefined;
+}
+export declare class ArchiveReader {
+    private static readonly DEFAULT_MAX_SIZE;
+    private static readonly DEFAULT_MAX_ENTRIES;
+    private static readonly MAX_COMPRESSION_RATIO;
+    private static readonly MAX_SINGLE_ENTRY_SIZE;
+    /**
+     * Automatically discovers the primary trace and network JSONL entry names inside a Playwright trace archive.
+     * Matches stream and worker IDs between .trace and .network files to prevent cross-worker mismatch.
+     */
+    static findTraceFileEntries(zipPath: string): TraceEntryDiscovery;
+    /** Reads multiple archive entries and joins them as one logical JSONL stream. */
+    static readEntriesAsText(zipPath: string, entryNames: string[]): Promise<string>;
+    /**
+     * Reads a single entry as a UTF-8 string directly from a .zip file in memory
+     * with strict per-entry size limits.
+     */
+    static readEntryAsText(zipPath: string, entryName: string): Promise<string>;
+    /**
+     * Safely unpacks a Playwright trace.zip archive to an isolated destination directory
+     * with strict Zip-Slip and Zip-Bomb protections.
+     */
+    static unpackSafely(zipPath: string, destinationDir: string, options?: UnpackOptions): Promise<ExtractedTraceArchive>;
+}
+//# sourceMappingURL=archive-reader.d.ts.map

package/dist/trace/archive-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive-reader.d.ts","sourceRoot":"","sources":["../../src/trace/archive-reader.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,aAAa;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,mBAAmB;IAClC,mEAAmE;IACnE,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,gEAAgE;IAChE,eAAe,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IACvC,iBAAiB,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;CAC1C;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAqB;IAC7D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAS;IACpD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAAM;IACnD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAAoB;IAEjE;;;OAGG;IACH,OAAc,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB,CA6DvE;IAED,iFAAiF;IACjF,OAAoB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAI5F;IAED;;;OAGG;IACH,OAAoB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAkBvF;IAED;;;OAGG;IACH,OAAoB,YAAY,CAC9B,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,qBAAqB,CAAC,CAuGhC;CACF"}

package/dist/trace/snapshot-resolver.d.ts

@@ -0,0 +1,55 @@
+export type NodeSnapshot = string | number | [string, Record<string, string>, ...NodeSnapshot[]];
+export interface ResolvedElement {
+    tag: string;
+    attributes: Record<string, string>;
+    text: string;
+    children: ResolvedElement[];
+    role?: string | undefined;
+    accessibleName?: string | undefined;
+}
+export type SnapshotCompleteness = 'COMPLETE' | 'PARTIAL' | 'UNAVAILABLE';
+export interface ResolvedSnapshot {
+    frameId: string;
+    callId?: string | undefined;
+    phase: 'before' | 'action' | 'after';
+    completeness: SnapshotCompleteness;
+    unresolvedReferences: string[];
+    dom: ResolvedElement[];
+}
+export interface FrameSnapshotRecord {
+    frameId: string;
+    pageId?: string | undefined;
+    callId?: string | undefined;
+    snapshotName?: string | undefined;
+    phase?: 'before' | 'action' | 'after' | undefined;
+    node?: NodeSnapshot | undefined;
+}
+export declare class SnapshotResolver {
+    /**
+     * Reconstructs an in-memory resolved element tree from Playwright's array-based NodeSnapshot,
+     * tracking provenance, snapshot phase, and evidence completeness.
+     */
+    static resolveSnapshot(record: FrameSnapshotRecord): ResolvedSnapshot;
+    /**
+     * Reconstructs an in-memory resolved element tree from Playwright's array-based NodeSnapshot.
+     */
+    static resolveNode(node: NodeSnapshot, unresolvedRefs?: string[]): ResolvedElement | null;
+    /**
+     * Traverses and collects all nodes in depth-first order as Playwright's snapshotNodes does.
+     */
+    static snapshotNodes(snap: any): any[];
+    /**
+     * Resolves a modern Playwright differential snapshot node with support for subtree references [ [ delta, nodeIndex ] ].
+     */
+    static resolveDifferentialNode(n: any, snapshotIndex: number, allSnapshots: any[], unresolvedRefs?: string[]): ResolvedElement | string | null;
+    /**
+     * Serializes a resolved element tree back into clean, formatted HTML.
+     */
+    static toHtml(element: ResolvedElement, indent?: number): string;
+    /**
+     * Collects all descendant interactive elements (buttons, inputs, links, selects, roles).
+     */
+    static extractInteractiveElements(root: ResolvedElement): ResolvedElement[];
+    private static inferRoleFromTag;
+}
+//# sourceMappingURL=snapshot-resolver.d.ts.map

package/dist/trace/snapshot-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-resolver.d.ts","sourceRoot":"","sources":["../../src/trace/snapshot-resolver.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GACpB,MAAM,GACN,MAAM,GACN,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,YAAY,EAAE,CAAC,CAAC;AAExD,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AAED,MAAM,MAAM,oBAAoB,GAAG,UAAU,GAAG,SAAS,GAAG,aAAa,CAAC;AAE1E,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,KAAK,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;IACrC,YAAY,EAAE,oBAAoB,CAAC;IACnC,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,GAAG,EAAE,eAAe,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,KAAK,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;IAClD,IAAI,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;CACjC;AAED,qBAAa,gBAAgB;IAC3B;;;OAGG;IACH,OAAc,eAAe,CAAC,MAAM,EAAE,mBAAmB,GAAG,gBAAgB,CA4B3E;IAED;;OAEG;IACH,OAAc,WAAW,CAAC,IAAI,EAAE,YAAY,EAAE,cAAc,CAAC,EAAE,MAAM,EAAE,GAAG,eAAe,GAAG,IAAI,CAmD/F;IAED;;OAEG;IACH,OAAc,aAAa,CAAC,IAAI,EAAE,GAAG,GAAG,GAAG,EAAE,CAiB5C;IAED;;OAEG;IACH,OAAc,uBAAuB,CACnC,CAAC,EAAE,GAAG,EACN,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,GAAG,EAAE,EACnB,cAAc,CAAC,EAAE,MAAM,EAAE,GACxB,eAAe,GAAG,MAAM,GAAG,IAAI,CAyEjC;IAED;;OAEG;IACH,OAAc,MAAM,CAAC,OAAO,EAAE,eAAe,EAAE,MAAM,SAAI,GAAG,MAAM,CAajE;IAED;;OAEG;IACH,OAAc,0BAA0B,CAAC,IAAI,EAAE,eAAe,GAAG,eAAe,EAAE,CAiCjF;IAED,OAAO,CAAC,MAAM,CAAC,gBAAgB;CAqBhC"}

package/dist/trace/trace-parser.d.ts

@@ -0,0 +1,50 @@
+import { DiagnosticContext, FailedAction, NetworkEvent, ConsoleEvent } from '../core/types/diagnostic-context.js';
+import { ResolvedElement } from './snapshot-resolver.js';
+export interface RawTraceEvent {
+    type: string;
+    callId?: string;
+    apiName?: string;
+    method?: string;
+    title?: string;
+    params?: Record<string, any>;
+    error?: any;
+    stack?: Array<{
+        file: string;
+        line: number;
+        column?: number;
+    }>;
+    wallTime?: number;
+    startTime?: number;
+    endTime?: number;
+    log?: string[];
+    message?: string;
+    snapshot?: any;
+    [key: string]: any;
+}
+export interface ParsedTraceStream {
+    actions: Map<string, FailedAction>;
+    failedAction?: FailedAction | undefined;
+    consoleEvents: ConsoleEvent[];
+    rawSnapshots?: any[];
+    latestResolvedDom?: ResolvedElement | null;
+    mainFrameDom?: ResolvedElement | null;
+    latestChildFrameDom?: ResolvedElement | null;
+    domByCallId?: Map<string, ResolvedElement>;
+    domByFrameId?: Map<string, ResolvedElement>;
+}
+export declare class TraceParser {
+    private static selectFailedAction;
+    /**
+     * Parses the raw lines of a .trace JSONL stream into structured actions, events, and DOM snapshots.
+     */
+    static parseTraceLines(lines: string[]): ParsedTraceStream;
+    /**
+     * Parses raw lines of a .network JSONL stream into structured NetworkEvents.
+     */
+    static parseNetworkLines(lines: string[]): NetworkEvent[];
+    /**
+     * Assembles a normalized DiagnosticContext from raw trace lines and network lines.
+     */
+    static assembleDiagnosticContext(traceLines: string[], networkLines: string[]): DiagnosticContext;
+}
+//# sourceMappingURL=trace-parser.d.ts.map

package/dist/trace/trace-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-parser.d.ts","sourceRoot":"","sources":["../../src/trace/trace-parser.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,YAAY,EACb,MAAM,qCAAqC,CAAC;AAE7C,OAAO,EAAoB,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE3E,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,GAAG,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACnC,YAAY,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;IACxC,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,YAAY,CAAC,EAAE,GAAG,EAAE,CAAC;IACrB,iBAAiB,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IAC3C,YAAY,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IACtC,mBAAmB,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IAC7C,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAC3C,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CAC7C;AA4BD,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAiBjC;;OAEG;IACH,OAAc,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,iBAAiB,CAoQhE;IAED;;OAEG;IACH,OAAc,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,YAAY,EAAE,CA6C/D;IAED;;OAEG;IACH,OAAc,yBAAyB,CACrC,UAAU,EAAE,MAAM,EAAE,EACpB,YAAY,EAAE,MAAM,EAAE,GACrB,iBAAiB,CA4DnB;CACF"}

package/dist/trace/version-detector.d.ts

@@ -0,0 +1,20 @@
+export interface TraceVersionInfo {
+    traceFormatVersion: number;
+    playwrightVersion?: string;
+    isSupported: boolean;
+}
+export declare class VersionDetector {
+    static readonly SUPPORTED_FORMAT_VERSIONS: number[];
+    /**
+     * Detects the trace format version from raw JSONL event lines or an archive entry.
+     * Scans the first N events looking for a 'version' event or metadata object.
+     * If no explicit version is found, returns version 0 (unknown/unsupported).
+     */
+    static detectFromLines(lines: string[]): TraceVersionInfo;
+    /**
+     * Asserts that a detected trace version is supported by the engine.
+     * Throws UnsupportedTraceVersionError if not.
+     */
+    static assertSupported(versionInfo: TraceVersionInfo): void;
+}
+//# sourceMappingURL=version-detector.d.ts.map

package/dist/trace/version-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-detector.d.ts","sourceRoot":"","sources":["../../src/trace/version-detector.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,gBAAgB;IAC/B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,qBAAa,eAAe;IAI1B,gBAAuB,yBAAyB,WAA0B;IAE1E;;;;OAIG;IACH,OAAc,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,gBAAgB,CA8C/D;IAED;;;OAGG;IACH,OAAc,eAAe,CAAC,WAAW,EAAE,gBAAgB,GAAG,IAAI,CAOjE;CACF"}

package/package.json

@@ -1,6 +1,76 @@
-{
-  "name": "playwright-intelligence-engine",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+{
+  "name": "playwright-intelligence-engine",
+  "version": "2.0.0",
+  "description": "Enterprise-grade Playwright reliability, failure diagnosis, and intent-preserving test verification engine",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "pw-intel": "bin/pw-intel.js",
+    "playwright-intelligence-engine": "bin/pw-intel.js"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "src",
+    "skills",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --clean && tsc --emitDeclarationOnly --declaration --declarationMap --outDir dist",
+    "test": "vitest run --maxWorkers=4",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit && tsc -p tests/tsconfig.json --noEmit",
+    "verify:all": "node scripts/verify/index.mjs",
+    "verify:full": "node scripts/verify/index.mjs --full",
+    "verify:baseline": "node scripts/verify-baseline.mjs"
+  },
+  "keywords": [
+    "playwright",
+    "test-intelligence",
+    "self-healing",
+    "flaky-tests",
+    "ast-manipulation",
+    "trace-analysis"
+  ],
+  "author": "Playwright Intelligence Team",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lst2121/playwright-intelligence-engine.git"
+  },
+  "bugs": {
+    "url": "https://github.com/lst2121/playwright-intelligence-engine/issues"
+  },
+  "homepage": "https://github.com/lst2121/playwright-intelligence-engine#readme",
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "dependencies": {
+    "adm-zip": "^0.6.1",
+    "ts-morph": "^28.0.0",
+    "tsx": "^4.23.15",
+    "zod": "^4.6.7"
+  },
+  "peerDependencies": {
+    "@playwright/test": ">=1.30.0"
+  },
+  "peerDependenciesMeta": {
+    "@playwright/test": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.64.1",
+    "@types/adm-zip": "^0.6.0",
+    "@types/node": "^26.6.6",
+    "tsup": "^9.0.0",
+    "typescript": "^7.0.2",
+    "vitest": "^5.1.0"
+  },
+  "directories": {
+    "doc": "docs",
+    "test": "tests"
+  }
+}

package/skills/README.md

@@ -0,0 +1,20 @@
+# PIE Agent Skill Pack
+
+This directory contains first-party skills for agents that use PIE through the
+CLI or MCP server.
+
+- `pie-quality-engineer`: end-to-end quality workflow.
+- `pie-failure-investigation`: evidence-first diagnosis.
+- `pie-repair-review`: safe repair review and approval readiness.
+- `pie-trace-to-repair`: trace diagnosis through bounded repair proposal and
+  isolated verification.
+- `pie-release-readiness`: suite health and release reporting.
+
+The skills orchestrate PIE. They do not replace PIE's deterministic safety
+gates, worktree isolation, verification, or human approval model.
+
+## Architectural Rule: Workflow vs Conventions vs Truth
+
+- **Skills carry workflow** (sequencing, diagnostic reasoning, human review narrative).
+- **Conventions live in `.pie/conventions.json`** (discovered runtime facts: locator strategies, directory layout, identifier conventions, sibling exemplars).
+- **Truth is enforced by a validator** (AST invariant proofs, typechecking, execution proofs). Anything that must be true is enforced by a validator, never by a prompt.

package/skills/pie-failure-investigation/SKILL.md

@@ -0,0 +1,16 @@
+---
+name: pie-failure-investigation
+description: Investigate Playwright failures through PIE evidence, causal classification, failure clustering, and safe abstention.
+---
+
+# PIE Failure Investigation
+
+Use `diagnose_trace` for individual traces and `cluster_failures` for multiple
+observations. Preserve the original trace, repository, commit, test title, and
+source location in every finding.
+
+Do not propose locator changes for backend, authentication, assertion,
+environment, incomplete-evidence, or unsupported-trace failures.
+
+When evidence is incomplete, explain what is missing and request a rerun or
+additional artifact instead of guessing.