@devtrack-solution/codesdd 1.2.2 → 1.2.3

package/dist/core/sdd/plugin-broker.d.ts

@@ -0,0 +1,558 @@
+import { z } from 'zod';
+import { type PluginRegistryState } from './plugin-registry.js';
+export declare const pluginBrokerPlanRequestSchema: z.ZodObject<{
+    feature_ref: z.ZodString;
+    capability: z.ZodString;
+    inputs: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    skill_ref: z.ZodOptional<z.ZodString>;
+    technology: z.ZodOptional<z.ZodObject<{
+        language: z.ZodOptional<z.ZodString>;
+        framework: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    requested_write_scope: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    require_apply: z.ZodDefault<z.ZodBoolean>;
+    created_at: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const pluginInvocationEnvelopeSchema: z.ZodObject<{
+    schema_version: z.ZodLiteral<1>;
+    mode: z.ZodLiteral<"dry-run">;
+    feature_ref: z.ZodString;
+    skill_ref: z.ZodOptional<z.ZodString>;
+    plugin_ref: z.ZodObject<{
+        id: z.ZodString;
+        version: z.ZodString;
+    }, z.core.$strip>;
+    capability: z.ZodString;
+    inputs: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    command: z.ZodObject<{
+        executable: z.ZodString;
+        args: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        timeout_seconds: z.ZodNumber;
+        env_allowlist: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        network: z.ZodEnum<{
+            disabled: "disabled";
+            restricted: "restricted";
+            enabled: "enabled";
+        }>;
+        process_spawn: z.ZodEnum<{
+            forbidden: "forbidden";
+            declared: "declared";
+        }>;
+    }, z.core.$strip>;
+    write_scope: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    evidence_requirements: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export declare const pluginArtifactManifestEntrySchema: z.ZodObject<{
+    path: z.ZodString;
+    operation: z.ZodEnum<{
+        created: "created";
+        planned: "planned";
+        modified: "modified";
+        deleted: "deleted";
+        unchanged: "unchanged";
+        validated: "validated";
+    }>;
+    reason: z.ZodString;
+    checksum_before: z.ZodOptional<z.ZodString>;
+    checksum_after: z.ZodOptional<z.ZodString>;
+    content_type: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const pluginArtifactManifestSchema: z.ZodObject<{
+    schema_version: z.ZodLiteral<1>;
+    operation_id: z.ZodString;
+    generated_at: z.ZodString;
+    feature_ref: z.ZodString;
+    plugin_ref: z.ZodObject<{
+        id: z.ZodString;
+        version: z.ZodString;
+    }, z.core.$strip>;
+    capability: z.ZodString;
+    mode: z.ZodEnum<{
+        apply: "apply";
+        "dry-run": "dry-run";
+        rollback: "rollback";
+    }>;
+    status: z.ZodEnum<{
+        planned: "planned";
+        applied: "applied";
+        rolled_back: "rolled_back";
+        failed: "failed";
+    }>;
+    artifacts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        operation: z.ZodEnum<{
+            created: "created";
+            planned: "planned";
+            modified: "modified";
+            deleted: "deleted";
+            unchanged: "unchanged";
+            validated: "validated";
+        }>;
+        reason: z.ZodString;
+        checksum_before: z.ZodOptional<z.ZodString>;
+        checksum_after: z.ZodOptional<z.ZodString>;
+        content_type: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    validation_evidence: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        command: z.ZodString;
+        status: z.ZodEnum<{
+            failed: "failed";
+            pending: "pending";
+            passed: "passed";
+            skipped: "skipped";
+        }>;
+        evidence_ref: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export declare const pluginRollbackManifestSchema: z.ZodObject<{
+    schema_version: z.ZodLiteral<1>;
+    operation_id: z.ZodString;
+    generated_at: z.ZodString;
+    feature_ref: z.ZodString;
+    plugin_ref: z.ZodObject<{
+        id: z.ZodString;
+        version: z.ZodString;
+    }, z.core.$strip>;
+    capability: z.ZodString;
+    mode: z.ZodEnum<{
+        apply: "apply";
+        "dry-run": "dry-run";
+        rollback: "rollback";
+    }>;
+    status: z.ZodEnum<{
+        planned: "planned";
+        "not-required": "not-required";
+    }>;
+    reason: z.ZodString;
+    rollback_steps: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export declare const pluginRuntimeInvocationRequestSchema: z.ZodObject<{
+    feature_ref: z.ZodString;
+    capability: z.ZodString;
+    inputs: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    skill_ref: z.ZodOptional<z.ZodString>;
+    technology: z.ZodOptional<z.ZodObject<{
+        language: z.ZodOptional<z.ZodString>;
+        framework: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    requested_write_scope: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    require_apply: z.ZodDefault<z.ZodBoolean>;
+    created_at: z.ZodOptional<z.ZodString>;
+    mode: z.ZodDefault<z.ZodEnum<{
+        apply: "apply";
+        "dry-run": "dry-run";
+        rollback: "rollback";
+    }>>;
+    operation_id: z.ZodOptional<z.ZodString>;
+    approval_grants: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+        maintainer: "maintainer";
+        security: "security";
+        "architecture-board": "architecture-board";
+    }>>>;
+    source_checksum: z.ZodOptional<z.ZodString>;
+    planned_writes: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    requested_env: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    network_domains: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    process_spawn_requested: z.ZodDefault<z.ZodBoolean>;
+    filesystem_checks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        real_path: z.ZodString;
+        project_root: z.ZodString;
+        is_symlink: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export declare const pluginRuntimeInvocationEnvelopeSchema: z.ZodObject<{
+    schema_version: z.ZodLiteral<1>;
+    operation_id: z.ZodString;
+    created_at: z.ZodString;
+    mode: z.ZodEnum<{
+        apply: "apply";
+        "dry-run": "dry-run";
+        rollback: "rollback";
+    }>;
+    feature_ref: z.ZodString;
+    skill_ref: z.ZodOptional<z.ZodString>;
+    plugin_ref: z.ZodObject<{
+        id: z.ZodString;
+        version: z.ZodString;
+    }, z.core.$strip>;
+    capability: z.ZodString;
+    inputs: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    command: z.ZodObject<{
+        executable: z.ZodString;
+        args: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        timeout_seconds: z.ZodNumber;
+        env_allowlist: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        network: z.ZodEnum<{
+            disabled: "disabled";
+            restricted: "restricted";
+            enabled: "enabled";
+        }>;
+        process_spawn: z.ZodEnum<{
+            forbidden: "forbidden";
+            declared: "declared";
+        }>;
+        working_directory: z.ZodString;
+    }, z.core.$strip>;
+    write_scope: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    policy: z.ZodObject<{
+        schema_version: z.ZodLiteral<1>;
+        plugin_ref: z.ZodObject<{
+            id: z.ZodString;
+            version: z.ZodString;
+        }, z.core.$strip>;
+        capability: z.ZodString;
+        mode: z.ZodEnum<{
+            apply: "apply";
+            "dry-run": "dry-run";
+            rollback: "rollback";
+        }>;
+        decision: z.ZodEnum<{
+            deny: "deny";
+            warn: "warn";
+            allow: "allow";
+        }>;
+        issues: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            code: z.ZodString;
+            severity: z.ZodEnum<{
+                deny: "deny";
+                warn: "warn";
+            }>;
+            message: z.ZodString;
+            path: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>;
+    expected_artifact_manifest: z.ZodObject<{
+        path: z.ZodString;
+        required_operations: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+            created: "created";
+            planned: "planned";
+            modified: "modified";
+            deleted: "deleted";
+            unchanged: "unchanged";
+            validated: "validated";
+        }>>>;
+    }, z.core.$strip>;
+    expected_evidence_manifest: z.ZodObject<{
+        path: z.ZodString;
+    }, z.core.$strip>;
+    expected_validation_manifest: z.ZodObject<{
+        path: z.ZodString;
+        required_statuses: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+            partial: "partial";
+            failed: "failed";
+            passed: "passed";
+        }>>>;
+    }, z.core.$strip>;
+    expected_rollback_manifest: z.ZodObject<{
+        path: z.ZodString;
+        required_for_mode: z.ZodBoolean;
+    }, z.core.$strip>;
+    evidence_requirements: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export declare const pluginRuntimeInvocationPlanSchema: z.ZodObject<{
+    schema_version: z.ZodLiteral<1>;
+    created_at: z.ZodString;
+    status: z.ZodEnum<{
+        ready: "ready";
+        blocked: "blocked";
+        unresolved: "unresolved";
+    }>;
+    request: z.ZodObject<{
+        feature_ref: z.ZodString;
+        capability: z.ZodString;
+        inputs: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        skill_ref: z.ZodOptional<z.ZodString>;
+        technology: z.ZodOptional<z.ZodObject<{
+            language: z.ZodOptional<z.ZodString>;
+            framework: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        requested_write_scope: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        require_apply: z.ZodDefault<z.ZodBoolean>;
+        created_at: z.ZodOptional<z.ZodString>;
+        mode: z.ZodDefault<z.ZodEnum<{
+            apply: "apply";
+            "dry-run": "dry-run";
+            rollback: "rollback";
+        }>>;
+        operation_id: z.ZodOptional<z.ZodString>;
+        approval_grants: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+            maintainer: "maintainer";
+            security: "security";
+            "architecture-board": "architecture-board";
+        }>>>;
+        source_checksum: z.ZodOptional<z.ZodString>;
+        planned_writes: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        requested_env: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        network_domains: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        process_spawn_requested: z.ZodDefault<z.ZodBoolean>;
+        filesystem_checks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            real_path: z.ZodString;
+            project_root: z.ZodString;
+            is_symlink: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>;
+    reasons: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    policy: z.ZodOptional<z.ZodObject<{
+        schema_version: z.ZodLiteral<1>;
+        plugin_ref: z.ZodObject<{
+            id: z.ZodString;
+            version: z.ZodString;
+        }, z.core.$strip>;
+        capability: z.ZodString;
+        mode: z.ZodEnum<{
+            apply: "apply";
+            "dry-run": "dry-run";
+            rollback: "rollback";
+        }>;
+        decision: z.ZodEnum<{
+            deny: "deny";
+            warn: "warn";
+            allow: "allow";
+        }>;
+        issues: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            code: z.ZodString;
+            severity: z.ZodEnum<{
+                deny: "deny";
+                warn: "warn";
+            }>;
+            message: z.ZodString;
+            path: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+    envelope: z.ZodOptional<z.ZodObject<{
+        schema_version: z.ZodLiteral<1>;
+        operation_id: z.ZodString;
+        created_at: z.ZodString;
+        mode: z.ZodEnum<{
+            apply: "apply";
+            "dry-run": "dry-run";
+            rollback: "rollback";
+        }>;
+        feature_ref: z.ZodString;
+        skill_ref: z.ZodOptional<z.ZodString>;
+        plugin_ref: z.ZodObject<{
+            id: z.ZodString;
+            version: z.ZodString;
+        }, z.core.$strip>;
+        capability: z.ZodString;
+        inputs: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        command: z.ZodObject<{
+            executable: z.ZodString;
+            args: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            timeout_seconds: z.ZodNumber;
+            env_allowlist: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            network: z.ZodEnum<{
+                disabled: "disabled";
+                restricted: "restricted";
+                enabled: "enabled";
+            }>;
+            process_spawn: z.ZodEnum<{
+                forbidden: "forbidden";
+                declared: "declared";
+            }>;
+            working_directory: z.ZodString;
+        }, z.core.$strip>;
+        write_scope: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        policy: z.ZodObject<{
+            schema_version: z.ZodLiteral<1>;
+            plugin_ref: z.ZodObject<{
+                id: z.ZodString;
+                version: z.ZodString;
+            }, z.core.$strip>;
+            capability: z.ZodString;
+            mode: z.ZodEnum<{
+                apply: "apply";
+                "dry-run": "dry-run";
+                rollback: "rollback";
+            }>;
+            decision: z.ZodEnum<{
+                deny: "deny";
+                warn: "warn";
+                allow: "allow";
+            }>;
+            issues: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                code: z.ZodString;
+                severity: z.ZodEnum<{
+                    deny: "deny";
+                    warn: "warn";
+                }>;
+                message: z.ZodString;
+                path: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>;
+        expected_artifact_manifest: z.ZodObject<{
+            path: z.ZodString;
+            required_operations: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+                created: "created";
+                planned: "planned";
+                modified: "modified";
+                deleted: "deleted";
+                unchanged: "unchanged";
+                validated: "validated";
+            }>>>;
+        }, z.core.$strip>;
+        expected_evidence_manifest: z.ZodObject<{
+            path: z.ZodString;
+        }, z.core.$strip>;
+        expected_validation_manifest: z.ZodObject<{
+            path: z.ZodString;
+            required_statuses: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+                partial: "partial";
+                failed: "failed";
+                passed: "passed";
+            }>>>;
+        }, z.core.$strip>;
+        expected_rollback_manifest: z.ZodObject<{
+            path: z.ZodString;
+            required_for_mode: z.ZodBoolean;
+        }, z.core.$strip>;
+        evidence_requirements: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    artifact_manifest: z.ZodOptional<z.ZodObject<{
+        schema_version: z.ZodLiteral<1>;
+        operation_id: z.ZodString;
+        generated_at: z.ZodString;
+        feature_ref: z.ZodString;
+        plugin_ref: z.ZodObject<{
+            id: z.ZodString;
+            version: z.ZodString;
+        }, z.core.$strip>;
+        capability: z.ZodString;
+        mode: z.ZodEnum<{
+            apply: "apply";
+            "dry-run": "dry-run";
+            rollback: "rollback";
+        }>;
+        status: z.ZodEnum<{
+            planned: "planned";
+            applied: "applied";
+            rolled_back: "rolled_back";
+            failed: "failed";
+        }>;
+        artifacts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            operation: z.ZodEnum<{
+                created: "created";
+                planned: "planned";
+                modified: "modified";
+                deleted: "deleted";
+                unchanged: "unchanged";
+                validated: "validated";
+            }>;
+            reason: z.ZodString;
+            checksum_before: z.ZodOptional<z.ZodString>;
+            checksum_after: z.ZodOptional<z.ZodString>;
+            content_type: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        validation_evidence: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            command: z.ZodString;
+            status: z.ZodEnum<{
+                failed: "failed";
+                pending: "pending";
+                passed: "passed";
+                skipped: "skipped";
+            }>;
+            evidence_ref: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+    rollback_manifest: z.ZodOptional<z.ZodObject<{
+        schema_version: z.ZodLiteral<1>;
+        operation_id: z.ZodString;
+        generated_at: z.ZodString;
+        feature_ref: z.ZodString;
+        plugin_ref: z.ZodObject<{
+            id: z.ZodString;
+            version: z.ZodString;
+        }, z.core.$strip>;
+        capability: z.ZodString;
+        mode: z.ZodEnum<{
+            apply: "apply";
+            "dry-run": "dry-run";
+            rollback: "rollback";
+        }>;
+        status: z.ZodEnum<{
+            planned: "planned";
+            "not-required": "not-required";
+        }>;
+        reason: z.ZodString;
+        rollback_steps: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const pluginDryRunArtifactPlanEntrySchema: z.ZodObject<{
+    path: z.ZodString;
+    operation: z.ZodEnum<{
+        plan: "plan";
+    }>;
+    reason: z.ZodString;
+}, z.core.$strip>;
+export declare const pluginDryRunExecutionPlanSchema: z.ZodObject<{
+    schema_version: z.ZodLiteral<1>;
+    created_at: z.ZodString;
+    status: z.ZodEnum<{
+        planned: "planned";
+        unresolved: "unresolved";
+    }>;
+    request: z.ZodObject<{
+        feature_ref: z.ZodString;
+        capability: z.ZodString;
+        inputs: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        skill_ref: z.ZodOptional<z.ZodString>;
+        technology: z.ZodOptional<z.ZodObject<{
+            language: z.ZodOptional<z.ZodString>;
+            framework: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        requested_write_scope: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        require_apply: z.ZodDefault<z.ZodBoolean>;
+        created_at: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    reasons: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    envelope: z.ZodOptional<z.ZodObject<{
+        schema_version: z.ZodLiteral<1>;
+        mode: z.ZodLiteral<"dry-run">;
+        feature_ref: z.ZodString;
+        skill_ref: z.ZodOptional<z.ZodString>;
+        plugin_ref: z.ZodObject<{
+            id: z.ZodString;
+            version: z.ZodString;
+        }, z.core.$strip>;
+        capability: z.ZodString;
+        inputs: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        command: z.ZodObject<{
+            executable: z.ZodString;
+            args: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            timeout_seconds: z.ZodNumber;
+            env_allowlist: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            network: z.ZodEnum<{
+                disabled: "disabled";
+                restricted: "restricted";
+                enabled: "enabled";
+            }>;
+            process_spawn: z.ZodEnum<{
+                forbidden: "forbidden";
+                declared: "declared";
+            }>;
+        }, z.core.$strip>;
+        write_scope: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        evidence_requirements: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    artifact_plan: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        operation: z.ZodEnum<{
+            plan: "plan";
+        }>;
+        reason: z.ZodString;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type PluginBrokerPlanRequest = z.infer<typeof pluginBrokerPlanRequestSchema>;
+export type PluginInvocationEnvelope = z.infer<typeof pluginInvocationEnvelopeSchema>;
+export type PluginDryRunExecutionPlan = z.infer<typeof pluginDryRunExecutionPlanSchema>;
+export type PluginRuntimeInvocationRequest = z.infer<typeof pluginRuntimeInvocationRequestSchema>;
+export type PluginRuntimeInvocationPlan = z.infer<typeof pluginRuntimeInvocationPlanSchema>;
+export type PluginRuntimeInvocationEnvelope = z.infer<typeof pluginRuntimeInvocationEnvelopeSchema>;
+export type PluginArtifactManifest = z.infer<typeof pluginArtifactManifestSchema>;
+export type PluginRollbackManifest = z.infer<typeof pluginRollbackManifestSchema>;
+export declare function buildPluginDryRunExecutionPlan(registryState: PluginRegistryState, request: PluginBrokerPlanRequest): PluginDryRunExecutionPlan;
+export declare function buildPluginRuntimeInvocationPlan(registryState: PluginRegistryState, request: PluginRuntimeInvocationRequest): PluginRuntimeInvocationPlan;
+//# sourceMappingURL=plugin-broker.d.ts.map