@devtrack-solution/codesdd 1.2.2

package/dist/core/sdd/structural-health.d.ts

@@ -0,0 +1,557 @@
+import { z } from 'zod';
+export declare const STRUCTURAL_HEALTH_TOKENS: {
+    readonly lifecycleDirectories: readonly ["planned", "active", "archived"];
+    readonly generatedDirectories: readonly ["planning", "core"];
+    readonly commandNames: readonly ["diagnose", "sanitize", "check", "audit"];
+    readonly findingSeverities: readonly ["info", "warning", "error", "blocker"];
+    readonly findingCategories: readonly ["lifecycle", "references", "integrity", "boundary", "render", "metadata", "naming"];
+    readonly sanitizerDispositions: readonly ["safe", "manual", "blocked", "noop"];
+    readonly lifecycleStates: readonly ["planned", "ready", "blocked", "in_progress", "done", "archived"];
+    readonly navigationNodeKinds: readonly ["insight", "debate", "epic", "feature", "frontend_gap", "tech_debt", "other"];
+    readonly navigationEdgeKinds: readonly ["origin", "depends_on", "produces", "consumes", "related"];
+    readonly boundaryViolations: readonly ["none", "path_traversal", "symlink_escape", "absolute_escape", "out_of_root"];
+};
+export declare const StructuralLifecycleDirectoryTokenSchema: z.ZodEnum<{
+    active: "active";
+    planned: "planned";
+    archived: "archived";
+}>;
+export declare const StructuralGeneratedDirectoryTokenSchema: z.ZodEnum<{
+    core: "core";
+    planning: "planning";
+}>;
+export declare const StructuralCommandNameTokenSchema: z.ZodEnum<{
+    check: "check";
+    diagnose: "diagnose";
+    sanitize: "sanitize";
+    audit: "audit";
+}>;
+export declare const StructuralFindingSeveritySchema: z.ZodEnum<{
+    error: "error";
+    warning: "warning";
+    info: "info";
+    blocker: "blocker";
+}>;
+export declare const StructuralFindingCategorySchema: z.ZodEnum<{
+    metadata: "metadata";
+    lifecycle: "lifecycle";
+    render: "render";
+    references: "references";
+    integrity: "integrity";
+    boundary: "boundary";
+    naming: "naming";
+}>;
+export declare const StructuralSanitizerDispositionSchema: z.ZodEnum<{
+    manual: "manual";
+    safe: "safe";
+    blocked: "blocked";
+    noop: "noop";
+}>;
+export declare const StructuralLifecycleStateTokenSchema: z.ZodEnum<{
+    done: "done";
+    planned: "planned";
+    in_progress: "in_progress";
+    archived: "archived";
+    blocked: "blocked";
+    ready: "ready";
+}>;
+export declare const StructuralNavigationNodeKindSchema: z.ZodEnum<{
+    epic: "epic";
+    frontend_gap: "frontend_gap";
+    tech_debt: "tech_debt";
+    feature: "feature";
+    other: "other";
+    insight: "insight";
+    debate: "debate";
+}>;
+export declare const StructuralNavigationEdgeKindSchema: z.ZodEnum<{
+    produces: "produces";
+    consumes: "consumes";
+    depends_on: "depends_on";
+    origin: "origin";
+    related: "related";
+}>;
+export declare const StructuralBoundaryViolationSchema: z.ZodEnum<{
+    none: "none";
+    path_traversal: "path_traversal";
+    symlink_escape: "symlink_escape";
+    absolute_escape: "absolute_escape";
+    out_of_root: "out_of_root";
+}>;
+export declare const StructuralTokenRegistrySchema: z.ZodObject<{
+    lifecycle_directories: z.ZodArray<z.ZodEnum<{
+        active: "active";
+        planned: "planned";
+        archived: "archived";
+    }>>;
+    generated_directories: z.ZodArray<z.ZodEnum<{
+        core: "core";
+        planning: "planning";
+    }>>;
+    command_names: z.ZodArray<z.ZodEnum<{
+        check: "check";
+        diagnose: "diagnose";
+        sanitize: "sanitize";
+        audit: "audit";
+    }>>;
+    finding_severities: z.ZodArray<z.ZodEnum<{
+        error: "error";
+        warning: "warning";
+        info: "info";
+        blocker: "blocker";
+    }>>;
+    finding_categories: z.ZodArray<z.ZodEnum<{
+        metadata: "metadata";
+        lifecycle: "lifecycle";
+        render: "render";
+        references: "references";
+        integrity: "integrity";
+        boundary: "boundary";
+        naming: "naming";
+    }>>;
+    sanitizer_dispositions: z.ZodArray<z.ZodEnum<{
+        manual: "manual";
+        safe: "safe";
+        blocked: "blocked";
+        noop: "noop";
+    }>>;
+}, z.core.$strip>;
+export declare const StructuralBoundaryPathSchema: z.ZodObject<{
+    root_path: z.ZodString;
+    candidate_path: z.ZodString;
+    normalized_path: z.ZodString;
+    real_path: z.ZodString;
+    is_within_root: z.ZodBoolean;
+    violation: z.ZodDefault<z.ZodEnum<{
+        none: "none";
+        path_traversal: "path_traversal";
+        symlink_escape: "symlink_escape";
+        absolute_escape: "absolute_escape";
+        out_of_root: "out_of_root";
+    }>>;
+}, z.core.$strip>;
+export declare const StructuralCommandInvocationSchema: z.ZodObject<{
+    command: z.ZodEnum<{
+        check: "check";
+        diagnose: "diagnose";
+        sanitize: "sanitize";
+        audit: "audit";
+    }>;
+    mode: z.ZodEnum<{
+        apply: "apply";
+        dry_run: "dry_run";
+        read: "read";
+    }>;
+    args: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export declare const StructuralFindingSchema: z.ZodObject<{
+    finding_id: z.ZodString;
+    rule_id: z.ZodString;
+    category: z.ZodEnum<{
+        metadata: "metadata";
+        lifecycle: "lifecycle";
+        render: "render";
+        references: "references";
+        integrity: "integrity";
+        boundary: "boundary";
+        naming: "naming";
+    }>;
+    severity: z.ZodEnum<{
+        error: "error";
+        warning: "warning";
+        info: "info";
+        blocker: "blocker";
+    }>;
+    summary: z.ZodString;
+    evidence: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    location: z.ZodOptional<z.ZodString>;
+    sanitizer: z.ZodObject<{
+        disposition: z.ZodEnum<{
+            manual: "manual";
+            safe: "safe";
+            blocked: "blocked";
+            noop: "noop";
+        }>;
+        reason: z.ZodString;
+        actions: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const StructuralDiagnosticReportSchema: z.ZodObject<{
+    report_version: z.ZodLiteral<1>;
+    generated_at: z.ZodString;
+    root_path: z.ZodString;
+    strict: z.ZodDefault<z.ZodBoolean>;
+    findings: z.ZodArray<z.ZodObject<{
+        finding_id: z.ZodString;
+        rule_id: z.ZodString;
+        category: z.ZodEnum<{
+            metadata: "metadata";
+            lifecycle: "lifecycle";
+            render: "render";
+            references: "references";
+            integrity: "integrity";
+            boundary: "boundary";
+            naming: "naming";
+        }>;
+        severity: z.ZodEnum<{
+            error: "error";
+            warning: "warning";
+            info: "info";
+            blocker: "blocker";
+        }>;
+        summary: z.ZodString;
+        evidence: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        location: z.ZodOptional<z.ZodString>;
+        sanitizer: z.ZodObject<{
+            disposition: z.ZodEnum<{
+                manual: "manual";
+                safe: "safe";
+                blocked: "blocked";
+                noop: "noop";
+            }>;
+            reason: z.ZodString;
+            actions: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+    summary: z.ZodObject<{
+        total: z.ZodNumber;
+        by_severity: z.ZodDefault<z.ZodRecord<z.ZodEnum<{
+            error: "error";
+            warning: "warning";
+            info: "info";
+            blocker: "blocker";
+        }> & z.core.$partial, z.ZodNumber>>;
+        by_category: z.ZodDefault<z.ZodRecord<z.ZodEnum<{
+            metadata: "metadata";
+            lifecycle: "lifecycle";
+            render: "render";
+            references: "references";
+            integrity: "integrity";
+            boundary: "boundary";
+            naming: "naming";
+        }> & z.core.$partial, z.ZodNumber>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const StructuralSanitizerActionSchema: z.ZodObject<{
+    action_id: z.ZodString;
+    finding_id: z.ZodString;
+    disposition: z.ZodEnum<{
+        manual: "manual";
+        safe: "safe";
+        blocked: "blocked";
+        noop: "noop";
+    }>;
+    operation: z.ZodEnum<{
+        mkdir: "mkdir";
+        render: "render";
+        move: "move";
+        register: "register";
+        manual_review: "manual_review";
+        skip: "skip";
+    }>;
+    from_path: z.ZodOptional<z.ZodString>;
+    to_path: z.ZodOptional<z.ZodString>;
+    notes: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const StructuralSanitizerRollbackOperationSchema: z.ZodObject<{
+    operation: z.ZodEnum<{
+        noop: "noop";
+        move: "move";
+        delete_path: "delete_path";
+        restore_backup: "restore_backup";
+    }>;
+    path: z.ZodOptional<z.ZodString>;
+    from_path: z.ZodOptional<z.ZodString>;
+    to_path: z.ZodOptional<z.ZodString>;
+    backup_path: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const StructuralSanitizerTransactionOperationSchema: z.ZodObject<{
+    transaction_action_id: z.ZodString;
+    action_id: z.ZodString;
+    finding_id: z.ZodString;
+    disposition: z.ZodEnum<{
+        manual: "manual";
+        safe: "safe";
+        blocked: "blocked";
+        noop: "noop";
+    }>;
+    operation: z.ZodEnum<{
+        mkdir: "mkdir";
+        render: "render";
+        move: "move";
+        register: "register";
+        manual_review: "manual_review";
+        skip: "skip";
+    }>;
+    status: z.ZodEnum<{
+        skipped: "skipped";
+        failed: "failed";
+        applied: "applied";
+        rolled_back: "rolled_back";
+    }>;
+    from_path: z.ZodOptional<z.ZodString>;
+    to_path: z.ZodOptional<z.ZodString>;
+    before_hash: z.ZodOptional<z.ZodString>;
+    after_hash: z.ZodOptional<z.ZodString>;
+    error: z.ZodOptional<z.ZodString>;
+    rollback: z.ZodObject<{
+        operation: z.ZodEnum<{
+            noop: "noop";
+            move: "move";
+            delete_path: "delete_path";
+            restore_backup: "restore_backup";
+        }>;
+        path: z.ZodOptional<z.ZodString>;
+        from_path: z.ZodOptional<z.ZodString>;
+        to_path: z.ZodOptional<z.ZodString>;
+        backup_path: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const StructuralSanitizerTransactionSummarySchema: z.ZodObject<{
+    applied: z.ZodNumber;
+    skipped: z.ZodNumber;
+    failed: z.ZodNumber;
+    rolled_back: z.ZodNumber;
+}, z.core.$strip>;
+export declare const StructuralSanitizerTransactionManifestSchema: z.ZodObject<{
+    report_version: z.ZodLiteral<1>;
+    transaction_id: z.ZodString;
+    generated_at: z.ZodString;
+    source_report_id: z.ZodString;
+    root_path: z.ZodString;
+    mode: z.ZodLiteral<"apply">;
+    operations: z.ZodArray<z.ZodObject<{
+        transaction_action_id: z.ZodString;
+        action_id: z.ZodString;
+        finding_id: z.ZodString;
+        disposition: z.ZodEnum<{
+            manual: "manual";
+            safe: "safe";
+            blocked: "blocked";
+            noop: "noop";
+        }>;
+        operation: z.ZodEnum<{
+            mkdir: "mkdir";
+            render: "render";
+            move: "move";
+            register: "register";
+            manual_review: "manual_review";
+            skip: "skip";
+        }>;
+        status: z.ZodEnum<{
+            skipped: "skipped";
+            failed: "failed";
+            applied: "applied";
+            rolled_back: "rolled_back";
+        }>;
+        from_path: z.ZodOptional<z.ZodString>;
+        to_path: z.ZodOptional<z.ZodString>;
+        before_hash: z.ZodOptional<z.ZodString>;
+        after_hash: z.ZodOptional<z.ZodString>;
+        error: z.ZodOptional<z.ZodString>;
+        rollback: z.ZodObject<{
+            operation: z.ZodEnum<{
+                noop: "noop";
+                move: "move";
+                delete_path: "delete_path";
+                restore_backup: "restore_backup";
+            }>;
+            path: z.ZodOptional<z.ZodString>;
+            from_path: z.ZodOptional<z.ZodString>;
+            to_path: z.ZodOptional<z.ZodString>;
+            backup_path: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+    summary: z.ZodObject<{
+        applied: z.ZodNumber;
+        skipped: z.ZodNumber;
+        failed: z.ZodNumber;
+        rolled_back: z.ZodNumber;
+    }, z.core.$strip>;
+    audit_log_path: z.ZodString;
+}, z.core.$strip>;
+export declare const StructuralSanitizerReportSchema: z.ZodObject<{
+    report_version: z.ZodLiteral<1>;
+    generated_at: z.ZodString;
+    source_report_id: z.ZodString;
+    mode: z.ZodEnum<{
+        apply: "apply";
+        dry_run: "dry_run";
+    }>;
+    actions: z.ZodArray<z.ZodObject<{
+        action_id: z.ZodString;
+        finding_id: z.ZodString;
+        disposition: z.ZodEnum<{
+            manual: "manual";
+            safe: "safe";
+            blocked: "blocked";
+            noop: "noop";
+        }>;
+        operation: z.ZodEnum<{
+            mkdir: "mkdir";
+            render: "render";
+            move: "move";
+            register: "register";
+            manual_review: "manual_review";
+            skip: "skip";
+        }>;
+        from_path: z.ZodOptional<z.ZodString>;
+        to_path: z.ZodOptional<z.ZodString>;
+        notes: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    blocked_actions: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        action_id: z.ZodString;
+        finding_id: z.ZodString;
+        disposition: z.ZodEnum<{
+            manual: "manual";
+            safe: "safe";
+            blocked: "blocked";
+            noop: "noop";
+        }>;
+        operation: z.ZodEnum<{
+            mkdir: "mkdir";
+            render: "render";
+            move: "move";
+            register: "register";
+            manual_review: "manual_review";
+            skip: "skip";
+        }>;
+        from_path: z.ZodOptional<z.ZodString>;
+        to_path: z.ZodOptional<z.ZodString>;
+        notes: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    transaction_id: z.ZodOptional<z.ZodString>;
+    manifest_path: z.ZodOptional<z.ZodString>;
+    audit_log_path: z.ZodOptional<z.ZodString>;
+    summary: z.ZodOptional<z.ZodObject<{
+        applied: z.ZodNumber;
+        skipped: z.ZodNumber;
+        failed: z.ZodNumber;
+        rolled_back: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const StructuralLifecycleEntrySchema: z.ZodObject<{
+    entity_id: z.ZodString;
+    expected_root: z.ZodEnum<{
+        active: "active";
+        planned: "planned";
+        archived: "archived";
+    }>;
+    actual_root: z.ZodOptional<z.ZodEnum<{
+        active: "active";
+        planned: "planned";
+        archived: "archived";
+    }>>;
+    state_token: z.ZodEnum<{
+        done: "done";
+        planned: "planned";
+        in_progress: "in_progress";
+        archived: "archived";
+        blocked: "blocked";
+        ready: "ready";
+    }>;
+}, z.core.$strip>;
+export declare const StructuralDirectoryStateMappingSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    lifecycle_roots: z.ZodRecord<z.ZodEnum<{
+        active: "active";
+        planned: "planned";
+        archived: "archived";
+    }>, z.ZodArray<z.ZodEnum<{
+        done: "done";
+        planned: "planned";
+        in_progress: "in_progress";
+        archived: "archived";
+        blocked: "blocked";
+        ready: "ready";
+    }>>>;
+    state_to_root: z.ZodRecord<z.ZodEnum<{
+        done: "done";
+        planned: "planned";
+        in_progress: "in_progress";
+        archived: "archived";
+        blocked: "blocked";
+        ready: "ready";
+    }>, z.ZodEnum<{
+        active: "active";
+        planned: "planned";
+        archived: "archived";
+    }>>;
+}, z.core.$strip>;
+export declare const StructuralNavigationNodeSchema: z.ZodObject<{
+    node_id: z.ZodString;
+    kind: z.ZodEnum<{
+        epic: "epic";
+        frontend_gap: "frontend_gap";
+        tech_debt: "tech_debt";
+        feature: "feature";
+        other: "other";
+        insight: "insight";
+        debate: "debate";
+    }>;
+    ref: z.ZodString;
+    status: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const StructuralNavigationEdgeSchema: z.ZodObject<{
+    from: z.ZodString;
+    to: z.ZodString;
+    kind: z.ZodEnum<{
+        produces: "produces";
+        consumes: "consumes";
+        depends_on: "depends_on";
+        origin: "origin";
+        related: "related";
+    }>;
+}, z.core.$strip>;
+export declare const StructuralNavigationGraphSchema: z.ZodObject<{
+    nodes: z.ZodArray<z.ZodObject<{
+        node_id: z.ZodString;
+        kind: z.ZodEnum<{
+            epic: "epic";
+            frontend_gap: "frontend_gap";
+            tech_debt: "tech_debt";
+            feature: "feature";
+            other: "other";
+            insight: "insight";
+            debate: "debate";
+        }>;
+        ref: z.ZodString;
+        status: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    edges: z.ZodArray<z.ZodObject<{
+        from: z.ZodString;
+        to: z.ZodString;
+        kind: z.ZodEnum<{
+            produces: "produces";
+            consumes: "consumes";
+            depends_on: "depends_on";
+            origin: "origin";
+            related: "related";
+        }>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const StructuralFixtureRootSchema: z.ZodObject<{
+    fixture_id: z.ZodString;
+    lifecycle_directories: z.ZodArray<z.ZodEnum<{
+        active: "active";
+        planned: "planned";
+        archived: "archived";
+    }>>;
+    generated_directories: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+        core: "core";
+        planning: "planning";
+    }>>>;
+    state_files: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    translated_directories: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type StructuralDiagnosticReport = z.infer<typeof StructuralDiagnosticReportSchema>;
+export type StructuralSanitizerReport = z.infer<typeof StructuralSanitizerReportSchema>;
+export type StructuralSanitizerTransactionManifest = z.infer<typeof StructuralSanitizerTransactionManifestSchema>;
+export type StructuralSanitizerTransactionOperation = z.infer<typeof StructuralSanitizerTransactionOperationSchema>;
+export type StructuralCommandInvocation = z.infer<typeof StructuralCommandInvocationSchema>;
+export type StructuralLifecycleEntry = z.infer<typeof StructuralLifecycleEntrySchema>;
+export type StructuralDirectoryStateMapping = z.infer<typeof StructuralDirectoryStateMappingSchema>;
+export type StructuralNavigationGraph = z.infer<typeof StructuralNavigationGraphSchema>;
+export type StructuralBoundaryPath = z.infer<typeof StructuralBoundaryPathSchema>;
+export type StructuralFixtureRoot = z.infer<typeof StructuralFixtureRootSchema>;
+//# sourceMappingURL=structural-health.d.ts.map