@devtrack-solution/codesdd 1.2.2 → 1.2.4-rc3

package/dist/core/sdd/services/context.service.d.ts

@@ -1,346 +1,49 @@
 import { SddStores } from "../store/sdd-stores.js";
+export declare const CONTEXT_PACK_BUDGET_MODES: readonly ["compact", "standard", "full"];
+export type ContextPackBudgetMode = (typeof CONTEXT_PACK_BUDGET_MODES)[number];
+export type ContextServiceOptions = {
+    budgetMode?: ContextPackBudgetMode;
+};
+type ContextPackBudgetReport = {
+    mode: ContextPackBudgetMode;
+    estimated_chars_before_budget: number;
+    estimated_chars_after_budget: number;
+    deduped_fields: Array<{
+        field: string;
+        before: number;
+        after: number;
+        removed: number;
+    }>;
+    truncated_fields: string[];
+};
+type ContextPackDisclosureHint = {
+    mode: ContextPackBudgetMode;
+    reveal_command: string;
+    omitted_fields: Array<{
+        field: string;
+        omitted_count: number;
+        reason: 'budget';
+    }>;
+};
+type ContextPackCacheMetadata = {
+    schema_version: 2;
+    enabled: true;
+    hit: boolean;
+    key: string;
+    project_fingerprint: string;
+    source_fingerprint: string;
+    cache_path: string;
+    refreshed_at: string;
+};
+type ContextPackWithBudget = Record<string, unknown> & {
+    context_budget: ContextPackBudgetReport;
+    progressive_disclosure?: ContextPackDisclosureHint;
+    context_cache?: ContextPackCacheMetadata;
+};
 export declare class ContextService {
     private readonly stores;
     constructor(stores: SddStores);
-    execute(projectRoot: string, ref: string): Promise<{
-        sdd_pack_version: number;
-        target_id: string;
-        target_type: "FEAT";
-        summary: string;
-        objective: string;
-        expected_outcome: string;
-        system_impact: string;
-        architectural_impact: {
-            description: string;
-            affected_modules: string[];
-        } | null;
-        workspace_frontend_impact: {
-            status: "unknown" | "none" | "required";
-            description: string;
-        } | null;
-        affected_contracts: {
-            name: string;
-            change_type: string;
-        }[];
-        quality_strategy: {
-            unit_target: number;
-            integration_target: number;
-            approach: string;
-        } | null;
-        workspace: {
-            path: string;
-            state: "" | "active" | "planned" | "archived";
-            docs: string[];
-            schema_errors: string[];
-        };
-        origin: {
-            type: "radar" | "epic" | "direct" | "fast_track" | "frontend_gap" | "tech_debt";
-            ref: string;
-        };
-        related_discovery: string[];
-        related_gaps: string[];
-        recommended_skills: string[];
-        recommended_bundles: string[];
-        skill_execution_contract: {
-            required: boolean;
-            required_skill_ids: string[];
-            verification_location: string;
-            verification_rule: string;
-        };
-        change_name: string;
-        blocked_by: string[];
-        lock_domains: string[];
-        parallel_group: string | undefined;
-        planning_mode: "local_plan" | "direct_tasks";
-        flow_mode: "direto" | "padrao" | "rigoroso";
-        current_stage: "proposta" | "planejamento" | "tarefas" | "execucao" | "consolidacao";
-        gates: {
-            proposta: {
-                status: "nao_exigida" | "rascunho" | "pronta" | "aprovada";
-                approved_at?: string | undefined;
-                approved_by?: string | undefined;
-                note?: string | undefined;
-            };
-            planejamento: {
-                status: "nao_exigida" | "rascunho" | "pronta" | "aprovada";
-                approved_at?: string | undefined;
-                approved_by?: string | undefined;
-                note?: string | undefined;
-            };
-            tarefas: {
-                status: "nao_exigida" | "rascunho" | "pronta" | "aprovada";
-                approved_at?: string | undefined;
-                approved_by?: string | undefined;
-                note?: string | undefined;
-            };
-        };
-        frontend_impact_status: "unknown" | "none" | "required";
-        frontend_impact_reason: string;
-        frontend_impact_declared_at: string;
-        frontend_surface_tokens: string[];
-        quality_contract: {
-            version: 1;
-            enabled: boolean;
-            scope: string;
-            unit_target_percent: number;
-            integration_target_percent: number;
-            evidence_mode: "coverage" | "equivalence" | "hybrid";
-            enforcement: "advisory" | "blocking";
-            stack_profile: string;
-            required_axes: string[];
-            required_evidence: {
-                kind: string;
-                required: boolean;
-                status: "planned" | "provided" | "waived";
-                command?: string | undefined;
-                artifact?: string | undefined;
-                notes?: string | undefined;
-            }[];
-            exceptions: {
-                id: string;
-                scope: string;
-                reason: string;
-                accepted_risk: string;
-                compensating_control: string;
-                review_deadline: string;
-                approved_by: string;
-                approved_at?: string | undefined;
-            }[];
-            inherited_from?: string | undefined;
-            updated_at?: string | undefined;
-        } | null;
-        quality_artifact: string;
-        start_commit_sha: string;
-        next_action: string;
-        execution_kind: "documentation" | "feature" | "infra" | "migration" | "frontend_coverage";
-        produces: string[];
-        consumes: string[];
-        predecessor_outputs: {
-            feature_id: string;
-            status: "ARCHIVED" | "READY" | "IN_PROGRESS" | "DONE" | "BLOCKED" | "SYNC_REQUIRED" | "VERIFY_FAILED";
-            produces: string[];
-            summary: string;
-        }[];
-        relevant_adrs: string[];
-        relevant_services: {
-            id: string;
-            name: string;
-            contracts: string[];
-        }[];
-        relevant_contracts: string[];
-        relevant_frontend_decisions: {
-            id: string;
-            title: string;
-            status: "APPROVED" | "DISCARDED" | "SUPERSEDED" | "PROPOSED";
-            route_refs: string[];
-        }[];
-        read_order: string[];
-        active_path: string;
-        unresolved_blocked_by: string[];
-        lock_conflicts_with: string[];
-        readiness: "READY" | "BLOCKED" | "LOCK_CONFLICT";
-        core_docs: string[];
-        related_features?: undefined;
-        related_debates?: undefined;
-        source_feature?: undefined;
-        resolved_by_feature?: undefined;
-        routes?: undefined;
-        related_refs?: undefined;
-    } | {
-        sdd_pack_version: number;
-        target_id: string;
-        target_type: "RAD" | "EPIC";
-        summary: string;
-        quality_contract: {
-            version: 1;
-            enabled: boolean;
-            scope: string;
-            unit_target_percent: number;
-            integration_target_percent: number;
-            evidence_mode: "coverage" | "equivalence" | "hybrid";
-            enforcement: "advisory" | "blocking";
-            stack_profile: string;
-            required_axes: string[];
-            required_evidence: {
-                kind: string;
-                required: boolean;
-                status: "planned" | "provided" | "waived";
-                command?: string | undefined;
-                artifact?: string | undefined;
-                notes?: string | undefined;
-            }[];
-            exceptions: {
-                id: string;
-                scope: string;
-                reason: string;
-                accepted_risk: string;
-                compensating_control: string;
-                review_deadline: string;
-                approved_by: string;
-                approved_at?: string | undefined;
-            }[];
-            inherited_from?: string | undefined;
-            updated_at?: string | undefined;
-        } | null;
-        related_features: string[];
-        related_debates: string[];
-        read_order: string[];
-        core_docs: string[];
-        objective?: undefined;
-        expected_outcome?: undefined;
-        system_impact?: undefined;
-        architectural_impact?: undefined;
-        workspace_frontend_impact?: undefined;
-        affected_contracts?: undefined;
-        quality_strategy?: undefined;
-        workspace?: undefined;
-        origin?: undefined;
-        related_discovery?: undefined;
-        related_gaps?: undefined;
-        recommended_skills?: undefined;
-        recommended_bundles?: undefined;
-        skill_execution_contract?: undefined;
-        change_name?: undefined;
-        blocked_by?: undefined;
-        lock_domains?: undefined;
-        parallel_group?: undefined;
-        planning_mode?: undefined;
-        flow_mode?: undefined;
-        current_stage?: undefined;
-        gates?: undefined;
-        frontend_impact_status?: undefined;
-        frontend_impact_reason?: undefined;
-        frontend_impact_declared_at?: undefined;
-        frontend_surface_tokens?: undefined;
-        quality_artifact?: undefined;
-        start_commit_sha?: undefined;
-        next_action?: undefined;
-        execution_kind?: undefined;
-        produces?: undefined;
-        consumes?: undefined;
-        predecessor_outputs?: undefined;
-        relevant_adrs?: undefined;
-        relevant_services?: undefined;
-        relevant_contracts?: undefined;
-        relevant_frontend_decisions?: undefined;
-        active_path?: undefined;
-        unresolved_blocked_by?: undefined;
-        lock_conflicts_with?: undefined;
-        readiness?: undefined;
-        source_feature?: undefined;
-        resolved_by_feature?: undefined;
-        routes?: undefined;
-        related_refs?: undefined;
-    } | {
-        sdd_pack_version: number;
-        target_id: string;
-        target_type: "FGAP";
-        summary: string;
-        source_feature: string;
-        resolved_by_feature: string;
-        routes: string[];
-        read_order: string[];
-        core_docs: string[];
-        objective?: undefined;
-        expected_outcome?: undefined;
-        system_impact?: undefined;
-        architectural_impact?: undefined;
-        workspace_frontend_impact?: undefined;
-        affected_contracts?: undefined;
-        quality_strategy?: undefined;
-        workspace?: undefined;
-        origin?: undefined;
-        related_discovery?: undefined;
-        related_gaps?: undefined;
-        recommended_skills?: undefined;
-        recommended_bundles?: undefined;
-        skill_execution_contract?: undefined;
-        change_name?: undefined;
-        blocked_by?: undefined;
-        lock_domains?: undefined;
-        parallel_group?: undefined;
-        planning_mode?: undefined;
-        flow_mode?: undefined;
-        current_stage?: undefined;
-        gates?: undefined;
-        frontend_impact_status?: undefined;
-        frontend_impact_reason?: undefined;
-        frontend_impact_declared_at?: undefined;
-        frontend_surface_tokens?: undefined;
-        quality_contract?: undefined;
-        quality_artifact?: undefined;
-        start_commit_sha?: undefined;
-        next_action?: undefined;
-        execution_kind?: undefined;
-        produces?: undefined;
-        consumes?: undefined;
-        predecessor_outputs?: undefined;
-        relevant_adrs?: undefined;
-        relevant_services?: undefined;
-        relevant_contracts?: undefined;
-        relevant_frontend_decisions?: undefined;
-        active_path?: undefined;
-        unresolved_blocked_by?: undefined;
-        lock_conflicts_with?: undefined;
-        readiness?: undefined;
-        related_features?: undefined;
-        related_debates?: undefined;
-        related_refs?: undefined;
-    } | {
-        sdd_pack_version: number;
-        target_id: string;
-        target_type: "TD";
-        summary: string;
-        related_refs: string[];
-        read_order: string[];
-        core_docs: string[];
-        objective?: undefined;
-        expected_outcome?: undefined;
-        system_impact?: undefined;
-        architectural_impact?: undefined;
-        workspace_frontend_impact?: undefined;
-        affected_contracts?: undefined;
-        quality_strategy?: undefined;
-        workspace?: undefined;
-        origin?: undefined;
-        related_discovery?: undefined;
-        related_gaps?: undefined;
-        recommended_skills?: undefined;
-        recommended_bundles?: undefined;
-        skill_execution_contract?: undefined;
-        change_name?: undefined;
-        blocked_by?: undefined;
-        lock_domains?: undefined;
-        parallel_group?: undefined;
-        planning_mode?: undefined;
-        flow_mode?: undefined;
-        current_stage?: undefined;
-        gates?: undefined;
-        frontend_impact_status?: undefined;
-        frontend_impact_reason?: undefined;
-        frontend_impact_declared_at?: undefined;
-        frontend_surface_tokens?: undefined;
-        quality_contract?: undefined;
-        quality_artifact?: undefined;
-        start_commit_sha?: undefined;
-        next_action?: undefined;
-        execution_kind?: undefined;
-        produces?: undefined;
-        consumes?: undefined;
-        predecessor_outputs?: undefined;
-        relevant_adrs?: undefined;
-        relevant_services?: undefined;
-        relevant_contracts?: undefined;
-        relevant_frontend_decisions?: undefined;
-        active_path?: undefined;
-        unresolved_blocked_by?: undefined;
-        lock_conflicts_with?: undefined;
-        readiness?: undefined;
-        related_features?: undefined;
-        related_debates?: undefined;
-        source_feature?: undefined;
-        resolved_by_feature?: undefined;
-        routes?: undefined;
-    }>;
+    execute(projectRoot: string, ref: string, options?: ContextServiceOptions): Promise<ContextPackWithBudget>;
 }
+export {};
 //# sourceMappingURL=context.service.d.ts.map