@treeseed/sdk 0.12.44 → 0.12.46

package/dist/guarantees/index.d.ts

@@ -1,5 +1,6 @@
 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';
@@ -123,6 +124,8 @@ export type TreeseedGuaranteeFilter = {
     type?: string;
     subtype?: string;
     ownerPackage?: string;
+    ownerPackages?: string[];
+    sceneBacked?: boolean;
     status?: TreeseedGuaranteeStatus;
     ids?: string[];
     journeyIndexes?: number[];
@@ -159,6 +162,62 @@ export type TreeseedGuaranteePlanEntry = {
     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;
@@ -210,6 +269,7 @@ export type TreeseedGuaranteeRunReport = {
     startedAt: string;
     completedAt: string;
     outputRoot: string;
+    statePath?: string;
     plan: TreeseedGuaranteePlanReport;
     results: TreeseedGuaranteeRunResult[];
     diagnostics: TreeseedGuaranteeDiagnostic[];
@@ -242,6 +302,7 @@ export type TreeseedGuaranteeVerifierExecutionInput = {
     ref: string;
     definition: TreeseedGuaranteeVerifierDefinition;
     kind: TreeseedGuaranteeRunStep['kind'];
+    onProgress?: (message: string, stream?: 'stdout' | 'stderr') => void;
 };
 export type TreeseedGuaranteeVerifierExecutionResult = {
     status: TreeseedGuaranteeRunStatus;
@@ -316,6 +377,12 @@ export declare function planTreeseedGuarantees(input: {
     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;
@@ -387,6 +454,21 @@ export declare function resolveTreeseedGuaranteeVerifierRefs(input: {
     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;
@@ -405,6 +487,7 @@ export declare function runTreeseedGuarantees(input: {
     evidenceTarget?: 'local' | 'ci' | 'release';
     sceneExecutor?: TreeseedGuaranteeSceneExecutor;
     verifierExecutor?: TreeseedGuaranteeVerifierExecutor;
+    onProgress?: (message: string, stream?: 'stdout' | 'stderr') => void;
     now?: Date;
 }): Promise<TreeseedGuaranteeRunReport>;
 export declare function createTreeseedGuaranteeStatusReport(input: {