@treeseed/sdk 0.12.62 → 0.13.0-rc.10

package/dist/guarantees/index.d.ts

@@ -1,512 +0,0 @@
-export declare const TREESEED_GUARANTEE_SCHEMA_VERSION: "treeseed.guarantee/v1";
-export declare const TREESEED_GUARANTEE_VERIFIERS_SCHEMA_VERSION: "treeseed.guarantee-verifiers/v1";
-export declare const TREESEED_GUARANTEE_JOURNEY_AUDIT_SCHEMA_VERSION: "treeseed.guarantee-journey-audit/v1";
-export type TreeseedGuaranteeSchemaVersion = typeof TREESEED_GUARANTEE_SCHEMA_VERSION;
-export type TreeseedGuaranteeVerifiersSchemaVersion = typeof TREESEED_GUARANTEE_VERIFIERS_SCHEMA_VERSION;
-export type TreeseedGuaranteeGate = 'smoke' | 'core' | 'release' | 'security' | 'migration' | 'demo' | 'backlog' | 'future';
-export type TreeseedGuaranteeStatus = 'active' | 'planned' | 'blocked' | 'backlog' | 'deprecated';
-export type TreeseedGuaranteeSurface = 'admin-ui' | 'agent-runtime' | 'api-control-plane' | 'market-ui' | 'cli' | 'scene' | 'content-runtime';
-export type TreeseedGuaranteeDevice = 'desktop_chromium' | 'desktop_firefox' | 'desktop_webkit' | 'tablet_chromium' | 'mobile_chromium' | 'mobile_webkit';
-export type TreeseedGuaranteeDiagnosticSeverity = 'error' | 'warning';
-export type TreeseedGuaranteeDiagnostic = {
-    severity: TreeseedGuaranteeDiagnosticSeverity;
-    code: string;
-    message: string;
-    path?: string;
-    sourcePath?: string;
-};
-export type TreeseedGuaranteeVerifierContract = {
-    required?: boolean;
-    verifierRefs?: string[];
-};
-export type TreeseedGuaranteeApiContract = TreeseedGuaranteeVerifierContract;
-export type TreeseedGuaranteeSceneContract = {
-    required?: boolean;
-    manifest?: string;
-    mode?: {
-        acceptance?: boolean;
-        demo?: boolean;
-        training?: boolean;
-    };
-    entryRoute?: string;
-    componentContract?: string;
-    expectedEvidence?: string[];
-};
-export type TreeseedGuaranteeNegativeCase = {
-    id: string;
-    actor?: string;
-    verifierRefs?: string[];
-    notes?: string[];
-};
-export type TreeseedGuaranteeDependencies = {
-    journeys?: number[];
-    guarantees?: string[];
-};
-export type TreeseedGuaranteeRunContract = {
-    timeoutSeconds?: number;
-    allowSkipped?: boolean;
-    requiredForRelease?: boolean;
-};
-export type TreeseedGuaranteeManifest = {
-    schemaVersion: TreeseedGuaranteeSchemaVersion;
-    id: string;
-    journeyIndex?: number;
-    type: string;
-    subtype: string;
-    journey: string;
-    ownerPackage: string;
-    surface?: TreeseedGuaranteeSurface;
-    summary: string;
-    status: TreeseedGuaranteeStatus;
-    run?: TreeseedGuaranteeRunContract;
-    dependencies: TreeseedGuaranteeDependencies;
-    actors: {
-        allowed: string[];
-        forbidden: string[];
-    };
-    devices: {
-        required: TreeseedGuaranteeDevice[];
-        optional?: TreeseedGuaranteeDevice[];
-    };
-    gates: TreeseedGuaranteeGate[];
-    preconditions: {
-        fixtures?: string[];
-        notes?: string[];
-    };
-    scene?: TreeseedGuaranteeSceneContract;
-    api?: TreeseedGuaranteeApiContract;
-    content?: TreeseedGuaranteeVerifierContract;
-    audit?: TreeseedGuaranteeVerifierContract;
-    negativeCases?: TreeseedGuaranteeNegativeCase[];
-    evidence: {
-        required: string[];
-        optional?: string[];
-    };
-    notes?: string[];
-    dependsOnGuarantees?: string[];
-};
-export type TreeseedLoadedGuarantee = {
-    sourcePath: string;
-    relativePath: string;
-    packageRoot: string;
-    ownerPackage: string;
-    manifest: TreeseedGuaranteeManifest | null;
-    diagnostics: TreeseedGuaranteeDiagnostic[];
-};
-export type TreeseedGuaranteeVerifierKind = 'apiAcceptanceCase' | 'vitestCase' | 'nodeScript' | 'packageScript' | 'scene' | 'manualEvidence' | 'todo';
-export type TreeseedGuaranteeVerifierDefinition = {
-    kind: TreeseedGuaranteeVerifierKind;
-    ownerPackage?: string;
-    spec?: string;
-    caseId?: string;
-    command?: string;
-    args?: string[];
-    testFile?: string;
-    testName?: string;
-    cwd?: string;
-    timeoutSeconds?: number;
-    evidence?: string[];
-    description?: string;
-};
-export type TreeseedGuaranteeVerifierRegistry = {
-    schemaVersion: TreeseedGuaranteeVerifiersSchemaVersion;
-    ownerPackage: string;
-    verifiers: Record<string, TreeseedGuaranteeVerifierDefinition>;
-};
-export type TreeseedLoadedGuaranteeVerifierRegistry = {
-    sourcePath: string;
-    ownerPackage: string;
-    registry: TreeseedGuaranteeVerifierRegistry | null;
-    diagnostics: TreeseedGuaranteeDiagnostic[];
-};
-export type TreeseedGuaranteeFilter = {
-    gate?: TreeseedGuaranteeGate;
-    type?: string;
-    subtype?: string;
-    ownerPackage?: string;
-    ownerPackages?: string[];
-    sceneBacked?: boolean;
-    status?: TreeseedGuaranteeStatus;
-    ids?: string[];
-    journeyIndexes?: number[];
-};
-export type TreeseedGuaranteeRegistryReport = {
-    ok: boolean;
-    workspaceRoot: string;
-    guarantees: TreeseedLoadedGuarantee[];
-    verifierRegistries: TreeseedLoadedGuaranteeVerifierRegistry[];
-    diagnostics: TreeseedGuaranteeDiagnostic[];
-    counts: {
-        total: number;
-        valid: number;
-        selected?: number;
-        errors: number;
-        warnings: number;
-    };
-};
-export type TreeseedGuaranteePlanEntry = {
-    id: string;
-    journeyIndex?: number;
-    type: string;
-    subtype: string;
-    journey: string;
-    ownerPackage: string;
-    surface?: TreeseedGuaranteeSurface;
-    status: TreeseedGuaranteeStatus;
-    gates: TreeseedGuaranteeGate[];
-    sourcePath: string;
-    selected: boolean;
-    dependency: boolean;
-    sceneManifest?: string;
-    apiVerifierRefs: string[];
-    contentVerifierRefs: string[];
-    auditVerifierRefs: string[];
-    evidenceRequired: string[];
-    dependencyDepth: number;
-    dependencyOf: string[];
-    dependsOn: string[];
-    dependencyReason: Array<'explicit-guarantee' | 'journey-index' | 'depends-on-verifier' | 'implicit-auth' | 'state'>;
-    executionOrder: number;
-    blockedBy?: string[];
-    producesState?: string[];
-    consumesState?: string[];
-};
-export type TreeseedGuaranteeJourneyAudit = {
-    schemaVersion: typeof TREESEED_GUARANTEE_JOURNEY_AUDIT_SCHEMA_VERSION;
-    workspaceRoot: string;
-    generatedAt: string;
-    totals: {
-        guarantees: number;
-        sceneBacked: number;
-        activeSceneBacked: number;
-        weakSceneContracts: number;
-        missingRoutes: number;
-        missingSelectors: number;
-        dependencyErrors: number;
-        activeSceneBackedWeak: number;
-        activeMissingRoutes: number;
-        activeMissingSelectors: number;
-    };
-    items: TreeseedGuaranteeJourneyAuditItem[];
-    diagnostics: TreeseedGuaranteeDiagnostic[];
-    ok: boolean;
-};
-export type TreeseedGuaranteeJourneyAuditItem = {
-    guaranteeId: string;
-    status: TreeseedGuaranteeStatus;
-    ownerPackage: string;
-    type: string;
-    subtype: string;
-    journey: string;
-    sourcePath: string;
-    scenePath?: string;
-    currentRoute?: string;
-    resolvedRoute?: string;
-    routeExists: boolean;
-    sceneWorkflowStepCount: number;
-    interactiveStepCount: number;
-    classification: 'valid-service-journey' | 'weak-page-only-scene' | 'route-mismatch' | 'missing-product-route' | 'missing-stable-selectors' | 'planned-product-contract' | 'non-ui-guarantee';
-    requiredAction: 'author-scene' | 'fix-route' | 'add-selectors' | 'downgrade-status' | 'none';
-    diagnostics: TreeseedGuaranteeDiagnostic[];
-};
-export type TreeseedGuaranteeRunState = {
-    schemaVersion: 'treeseed.guarantee-run-state/v1';
-    runId: string;
-    values: Record<string, {
-        producerGuaranteeId: string;
-        kind: 'user' | 'team' | 'project' | 'host' | 'capacity-provider' | 'workday' | 'operation' | 'content' | 'custom';
-        value: unknown;
-        createdAt: string;
-    }>;
-};
-export type TreeseedGuaranteeVerifierResolution = {
-    ref: string;
-    resolved: boolean;
-    sourcePath?: string;
-    ownerPackage?: string;
-    definition?: TreeseedGuaranteeVerifierDefinition;
-};
-export type TreeseedGuaranteeVerifierResolutionReport = {
-    ok: boolean;
-    resolutions: TreeseedGuaranteeVerifierResolution[];
-    diagnostics: TreeseedGuaranteeDiagnostic[];
-};
-export type TreeseedGuaranteeRunStatus = 'passed' | 'failed' | 'skipped' | 'blocked';
-export type TreeseedGuaranteeRunStep = {
-    id: string;
-    kind: 'scene' | 'api' | 'content' | 'audit' | 'negative-case' | 'verifier';
-    status: TreeseedGuaranteeRunStatus;
-    ref?: string;
-    summary?: string;
-    evidence?: string[];
-    diagnostics?: TreeseedGuaranteeDiagnostic[];
-    startedAt?: string;
-    completedAt?: string;
-};
-export type TreeseedGuaranteeRunResult = {
-    id: string;
-    journeyIndex?: number;
-    type: string;
-    subtype: string;
-    journey: string;
-    ownerPackage: string;
-    status: TreeseedGuaranteeRunStatus;
-    selected: boolean;
-    dependency: boolean;
-    sourcePath: string;
-    startedAt: string;
-    completedAt: string;
-    steps: TreeseedGuaranteeRunStep[];
-    evidence: string[];
-    diagnostics: TreeseedGuaranteeDiagnostic[];
-};
-export type TreeseedGuaranteeRunReport = {
-    ok: boolean;
-    runId: string;
-    workspaceRoot: string;
-    environment: string;
-    filter: TreeseedGuaranteeFilter;
-    startedAt: string;
-    completedAt: string;
-    outputRoot: string;
-    statePath?: string;
-    plan: TreeseedGuaranteePlanReport;
-    results: TreeseedGuaranteeRunResult[];
-    diagnostics: TreeseedGuaranteeDiagnostic[];
-    counts: {
-        planned: number;
-        passed: number;
-        failed: number;
-        skipped: number;
-        blocked: number;
-        releaseBlockingFailures: number;
-    };
-};
-export type TreeseedGuaranteeReportWriteResult = {
-    ok: boolean;
-    outputRoot: string;
-    planPath: string;
-    reportPath: string;
-    markdownPath: string;
-    csvPath: string;
-    diagnostics: TreeseedGuaranteeDiagnostic[];
-};
-export type TreeseedGuaranteeVerifierExecutionInput = {
-    workspaceRoot: string;
-    environment: string;
-    runId: string;
-    outputRoot: string;
-    guarantee: TreeseedLoadedGuarantee & {
-        manifest: TreeseedGuaranteeManifest;
-    };
-    ref: string;
-    definition: TreeseedGuaranteeVerifierDefinition;
-    kind: TreeseedGuaranteeRunStep['kind'];
-    onProgress?: (message: string, stream?: 'stdout' | 'stderr') => void;
-};
-export type TreeseedGuaranteeVerifierExecutionResult = {
-    status: TreeseedGuaranteeRunStatus;
-    summary?: string;
-    evidence?: string[];
-    diagnostics?: TreeseedGuaranteeDiagnostic[];
-};
-export type TreeseedGuaranteeVerifierExecutor = (input: TreeseedGuaranteeVerifierExecutionInput) => Promise<TreeseedGuaranteeVerifierExecutionResult>;
-export type TreeseedGuaranteeSceneExecutionInput = {
-    workspaceRoot: string;
-    environment: string;
-    runId: string;
-    outputRoot: string;
-    guarantee: TreeseedLoadedGuarantee & {
-        manifest: TreeseedGuaranteeManifest;
-    };
-    scenePath: string;
-    record?: boolean;
-    artifactMode?: 'full' | 'screenshots';
-    device?: string;
-};
-export type TreeseedGuaranteeSceneExecutor = (input: TreeseedGuaranteeSceneExecutionInput) => Promise<TreeseedGuaranteeVerifierExecutionResult>;
-export type TreeseedGuaranteePlanReport = {
-    ok: boolean;
-    workspaceRoot: string;
-    filter: TreeseedGuaranteeFilter;
-    environment: string;
-    entries: TreeseedGuaranteePlanEntry[];
-    diagnostics: TreeseedGuaranteeDiagnostic[];
-    counts: {
-        total: number;
-        selected: number;
-        withDependencies: number;
-        errors: number;
-        warnings: number;
-    };
-};
-export declare function normalizeTreeseedGuaranteeTaxonomy(value: string): string;
-export declare function slugifyTreeseedGuaranteeJourney(value: string): string;
-export declare function loadTreeseedGuaranteeManifest(input: {
-    workspaceRoot: string;
-    path: string;
-}): TreeseedLoadedGuarantee;
-export declare function loadTreeseedGuaranteeVerifierRegistry(input: {
-    workspaceRoot: string;
-    path: string;
-}): TreeseedLoadedGuaranteeVerifierRegistry;
-export declare function discoverTreeseedGuarantees(input?: {
-    workspaceRoot: string;
-    filter?: TreeseedGuaranteeFilter;
-}): TreeseedGuaranteeRegistryReport;
-export declare function validateTreeseedGuarantee(input: {
-    workspaceRoot: string;
-    path: string;
-}): TreeseedLoadedGuarantee;
-export declare function filterTreeseedGuarantees(input: {
-    guarantees: TreeseedLoadedGuarantee[];
-    filter?: TreeseedGuaranteeFilter;
-    includeDependencies?: boolean;
-}): (TreeseedLoadedGuarantee & {
-    manifest: TreeseedGuaranteeManifest;
-})[];
-export declare function validateTreeseedGuaranteeRegistry(input: {
-    workspaceRoot: string;
-    guarantees: TreeseedLoadedGuarantee[];
-    verifierRegistries?: TreeseedLoadedGuaranteeVerifierRegistry[];
-    filter?: TreeseedGuaranteeFilter;
-}): TreeseedGuaranteeRegistryReport;
-export declare function planTreeseedGuarantees(input: {
-    workspaceRoot: string;
-    filter?: TreeseedGuaranteeFilter;
-    environment?: string;
-    includeDependencies?: boolean;
-}): TreeseedGuaranteePlanReport;
-export declare function auditTreeseedGuaranteeJourneys(input: {
-    workspaceRoot: string;
-    filter?: TreeseedGuaranteeFilter;
-    writeReport?: string;
-    now?: Date;
-}): TreeseedGuaranteeJourneyAudit;
-export declare function exportTreeseedGuaranteesCsv(input: {
-    guarantees: TreeseedLoadedGuarantee[];
-    filter?: TreeseedGuaranteeFilter;
-}): string;
-export declare function exportTreeseedGuaranteesJson(input: {
-    registry: TreeseedGuaranteeRegistryReport;
-    filter?: TreeseedGuaranteeFilter;
-}): {
-    schemaVersion: string;
-    generatedAt: string;
-    workspaceRoot: string;
-    guarantees: {
-        schemaVersion: TreeseedGuaranteeSchemaVersion;
-        id: string;
-        journeyIndex?: number;
-        type: string;
-        subtype: string;
-        journey: string;
-        ownerPackage: string;
-        surface?: TreeseedGuaranteeSurface;
-        summary: string;
-        status: TreeseedGuaranteeStatus;
-        run?: TreeseedGuaranteeRunContract;
-        dependencies: TreeseedGuaranteeDependencies;
-        actors: {
-            allowed: string[];
-            forbidden: string[];
-        };
-        devices: {
-            required: TreeseedGuaranteeDevice[];
-            optional?: TreeseedGuaranteeDevice[];
-        };
-        gates: TreeseedGuaranteeGate[];
-        preconditions: {
-            fixtures?: string[];
-            notes?: string[];
-        };
-        scene?: TreeseedGuaranteeSceneContract;
-        api?: TreeseedGuaranteeApiContract;
-        content?: TreeseedGuaranteeVerifierContract;
-        audit?: TreeseedGuaranteeVerifierContract;
-        negativeCases?: TreeseedGuaranteeNegativeCase[];
-        evidence: {
-            required: string[];
-            optional?: string[];
-        };
-        notes?: string[];
-        dependsOnGuarantees?: string[];
-        sourcePath: string;
-    }[];
-};
-export declare function exportTreeseedGuaranteesMarkdown(input: {
-    registry: TreeseedGuaranteeRegistryReport;
-    filter?: TreeseedGuaranteeFilter;
-}): string;
-export declare function writeTreeseedGuaranteesExport(input: {
-    workspaceRoot: string;
-    format: 'csv' | 'json' | 'markdown';
-    output: string;
-    filter?: TreeseedGuaranteeFilter;
-}): {
-    ok: boolean;
-    outputPath: string;
-    registry: TreeseedGuaranteeRegistryReport;
-};
-export declare function resolveTreeseedGuaranteeVerifierRefs(input: {
-    refs: string[];
-    verifierRegistries: TreeseedLoadedGuaranteeVerifierRegistry[];
-    status?: TreeseedGuaranteeStatus;
-    sourcePath?: string;
-}): TreeseedGuaranteeVerifierResolutionReport;
-export declare function validateTreeseedVitestVerifierOutput(result: {
-    stdout: string;
-    stderr: string;
-}): "Vitest verifier completed without executing any assertions. Check the verifier testName/testFile; skipped-only or no-match runs are not valid guarantee evidence." | null;
-export declare function validateGuaranteeSceneJourneyContract(input: {
-    scenePath: string;
-    sourcePath?: string;
-}): TreeseedGuaranteeDiagnostic[];
-export declare function sceneAuthRoleForGuarantee(manifest: TreeseedGuaranteeManifest): "owner" | "admin" | "member" | undefined;
-export declare function browserForGuaranteeDevice(device: string | undefined): "chromium" | "firefox" | "webkit";
-export declare function sceneDeviceRunsForGuarantee(devices: string[]): {
-    id: string;
-    device: string;
-    browser: string;
-}[];
-export declare function writeTreeseedGuaranteeRunReport(input: {
-    report: TreeseedGuaranteeRunReport;
-    registry?: TreeseedGuaranteeRegistryReport;
-}): TreeseedGuaranteeReportWriteResult;
-export declare function runTreeseedGuarantees(input: {
-    workspaceRoot: string;
-    filter?: TreeseedGuaranteeFilter;
-    environment?: string;
-    outputRoot?: string;
-    includeDependencies?: boolean;
-    includePlanned?: boolean;
-    failOnSkippedReleaseGuarantees?: boolean;
-    record?: boolean;
-    sceneArtifacts?: 'full' | 'screenshots';
-    device?: string;
-    evidenceTarget?: 'local' | 'ci' | 'release';
-    sceneExecutor?: TreeseedGuaranteeSceneExecutor;
-    verifierExecutor?: TreeseedGuaranteeVerifierExecutor;
-    onProgress?: (message: string, stream?: 'stdout' | 'stderr') => void;
-    now?: Date;
-}): Promise<TreeseedGuaranteeRunReport>;
-export declare function createTreeseedGuaranteeStatusReport(input: {
-    workspaceRoot: string;
-}): {
-    ok: boolean;
-    workspaceRoot: string;
-    guaranteeRoots: string[];
-    counts: {
-        total: number;
-        valid: number;
-        selected?: number;
-        errors: number;
-        warnings: number;
-    };
-    byType: Record<string, number>;
-    byStatus: Record<string, number>;
-    verifierRegistries: number;
-    diagnostics: TreeseedGuaranteeDiagnostic[];
-};
-export declare function assertPathInsideWorkspace(workspaceRoot: string, path: string): string;
-export declare function fileExists(path: string): boolean;