@devtrack-solution/codesdd 1.2.3 → 1.2.4

package/dist/core/sdd/services/archive-quality-coherence.service.js

@@ -0,0 +1,141 @@
+import { existsSync } from 'node:fs';
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { parseWorkspaceYamlDocument } from '../workspace-schemas.js';
+const PLACEHOLDER_PATTERNS = [
+    /\(fill in/i,
+    /\(placeholder/i,
+    /\btodo\b/i,
+    /\btbd\b/i,
+    /\bpending\b/i,
+    /\bmust implement\b/i,
+    /\bto be executed\b/i,
+    /\bplanned\b/i,
+    /\bwill be\b/i,
+    /\bto do\b/i,
+];
+const GENERIC_EVIDENCE_PATTERNS = [
+    /must implement and record executable evidence/i,
+    /planned but not yet executed/i,
+    /is implemented only in the planned surfaces/i,
+    /planned implementation surface/i,
+    /pending\.?$/i,
+];
+const DEFAULT_GRANDFATHER_MAX_FEAT = 451;
+function featNumericId(featureId) {
+    const match = featureId.match(/^FEAT-(\d{4,})$/);
+    if (!match)
+        return null;
+    return Number.parseInt(match[1] || '', 10);
+}
+function hasPattern(text, patterns) {
+    return patterns.some((pattern) => pattern.test(text));
+}
+function qualityHasPlaceholderOrGenericEvidence(document) {
+    let hasPlaceholder = false;
+    let hasGeneric = false;
+    const evidenceTexts = [
+        ...document.evidence_log.flatMap((entry) => [entry.kind, entry.result, entry.artifact ?? '']),
+        ...document.acceptance_matrix.flatMap((entry) => [entry.criterion, entry.evidence]),
+    ];
+    for (const text of evidenceTexts) {
+        if (!text)
+            continue;
+        if (!hasPlaceholder && hasPattern(text, PLACEHOLDER_PATTERNS)) {
+            hasPlaceholder = true;
+        }
+        if (!hasGeneric && hasPattern(text, GENERIC_EVIDENCE_PATTERNS)) {
+            hasGeneric = true;
+        }
+        if (hasPlaceholder && hasGeneric) {
+            break;
+        }
+    }
+    return { hasPlaceholder, hasGeneric };
+}
+export async function scanArchiveQualityCoherence(archivedDir, options = {}) {
+    if (!existsSync(archivedDir)) {
+        return {
+            scanned: 0,
+            analyzed: 0,
+            grandfathered: 0,
+            issues: [],
+        };
+    }
+    const grandfatherMaxFeat = options.grandfatherMaxFeat ?? DEFAULT_GRANDFATHER_MAX_FEAT;
+    const issues = [];
+    const entries = await fs.readdir(archivedDir, { withFileTypes: true });
+    let scanned = 0;
+    let analyzed = 0;
+    let grandfathered = 0;
+    for (const entry of entries) {
+        if (!entry.isDirectory() || !entry.name.startsWith('FEAT-'))
+            continue;
+        scanned += 1;
+        const featureId = entry.name;
+        const numericId = featNumericId(featureId);
+        if (numericId !== null && numericId <= grandfatherMaxFeat) {
+            grandfathered += 1;
+            continue;
+        }
+        const qualityPath = path.join(archivedDir, featureId, '5-quality.yaml');
+        if (!existsSync(qualityPath)) {
+            continue;
+        }
+        const raw = await fs.readFile(qualityPath, 'utf-8').catch(() => '');
+        if (!raw.trim()) {
+            continue;
+        }
+        let quality;
+        try {
+            quality = parseWorkspaceYamlDocument('5-quality.yaml', raw);
+        }
+        catch {
+            continue;
+        }
+        analyzed += 1;
+        if (quality.q95_ledger.status !== 'pass') {
+            continue;
+        }
+        if (quality.acceptance_matrix.some((entry) => entry.status === 'not_met')) {
+            issues.push({
+                featureId,
+                qualityPath,
+                issueCode: 'ACCEPTANCE_NOT_MET_WITH_Q95_PASS',
+                message: `${featureId} archived quality has q95_ledger.status=pass but acceptance_matrix contains not_met entries.`,
+            });
+        }
+        if (quality.requirement_validation_evidence_risk_matrix.some((entry) => entry.risk_status === 'open')) {
+            issues.push({
+                featureId,
+                qualityPath,
+                issueCode: 'OPEN_RISK_WITH_Q95_PASS',
+                message: `${featureId} archived quality has q95_ledger.status=pass but requirement risk_status=open remains unresolved.`,
+            });
+        }
+        const evidenceSignals = qualityHasPlaceholderOrGenericEvidence(quality);
+        if (evidenceSignals.hasPlaceholder) {
+            issues.push({
+                featureId,
+                qualityPath,
+                issueCode: 'PLACEHOLDER_EVIDENCE_WITH_Q95_PASS',
+                message: `${featureId} archived quality has q95_ledger.status=pass but placeholder/future-tense evidence markers are present.`,
+            });
+        }
+        if (evidenceSignals.hasGeneric) {
+            issues.push({
+                featureId,
+                qualityPath,
+                issueCode: 'GENERIC_EVIDENCE_WITH_Q95_PASS',
+                message: `${featureId} archived quality has q95_ledger.status=pass but generic non-executable evidence text is still present.`,
+            });
+        }
+    }
+    return {
+        scanned,
+        analyzed,
+        grandfathered,
+        issues,
+    };
+}
+//# sourceMappingURL=archive-quality-coherence.service.js.map

package/dist/core/sdd/services/capability-diff.service.d.ts

@@ -0,0 +1,18 @@
+import { type CapabilityDiffReport, type CapabilityInventory, type CapabilityInventoryItem, type CapabilityKind, type CapabilityRiskInput, type CapabilityRiskReport } from '../domain/capability-diff.js';
+export interface CapabilityDiffServiceRequest extends Omit<CapabilityRiskInput, 'diff'> {
+    before: CapabilityInventoryItem[] | CapabilityInventory;
+    after: CapabilityInventoryItem[] | CapabilityInventory;
+    required_kinds?: CapabilityKind[];
+}
+export interface CapabilityDiffServiceResult {
+    schema_version: 1;
+    contract: 'capability-diff-service-result/v1';
+    before: CapabilityInventory;
+    after: CapabilityInventory;
+    diff: CapabilityDiffReport;
+    risk: CapabilityRiskReport;
+}
+export declare class CapabilityDiffService {
+    execute(request: CapabilityDiffServiceRequest): CapabilityDiffServiceResult;
+}
+//# sourceMappingURL=capability-diff.service.d.ts.map

package/dist/core/sdd/services/capability-diff.service.js

@@ -0,0 +1,26 @@
+import { buildCapabilityInventory, diffCapabilityInventories, scoreCapabilityDiffRisk, } from '../domain/capability-diff.js';
+export class CapabilityDiffService {
+    execute(request) {
+        const before = normalizeInventoryRequest(request.before);
+        const after = normalizeInventoryRequest(request.after);
+        const diff = diffCapabilityInventories(before, after);
+        const risk = scoreCapabilityDiffRisk({
+            diff,
+            change_safety: request.change_safety,
+            planned_changes: request.planned_changes,
+            required_kinds: request.required_kinds,
+        });
+        return {
+            schema_version: 1,
+            contract: 'capability-diff-service-result/v1',
+            before,
+            after,
+            diff,
+            risk,
+        };
+    }
+}
+function normalizeInventoryRequest(input) {
+    return Array.isArray(input) ? buildCapabilityInventory(input) : input;
+}
+//# sourceMappingURL=capability-diff.service.js.map

package/dist/core/sdd/services/change-safety-preflight.service.d.ts

@@ -0,0 +1,17 @@
+import { type ChangeSafetyContract, type ChangeSafetyEvaluation, type PlannedFileChange } from '../domain/change-safety-guardrails.js';
+export interface ChangeSafetyPreflightRequest {
+    feature_id: string;
+    change_safety?: ChangeSafetyContract;
+    planned_changes?: PlannedFileChange[];
+}
+export interface ChangeSafetyPreflightResult extends ChangeSafetyEvaluation {
+    schema_version: 1;
+    contract: 'change-safety-preflight/v1';
+    feature_id: string;
+    fail_closed: true;
+    phase: 'mechanical';
+}
+export declare class ChangeSafetyPreflightService {
+    execute(request: ChangeSafetyPreflightRequest): ChangeSafetyPreflightResult;
+}
+//# sourceMappingURL=change-safety-preflight.service.d.ts.map

package/dist/core/sdd/services/change-safety-preflight.service.js

@@ -0,0 +1,17 @@
+import { evaluateChangeSafety, } from '../domain/change-safety-guardrails.js';
+export class ChangeSafetyPreflightService {
+    execute(request) {
+        const evaluation = evaluateChangeSafety(request.change_safety ?? {}, request.planned_changes ?? [], {
+            feature_id: request.feature_id,
+        });
+        return {
+            schema_version: 1,
+            contract: 'change-safety-preflight/v1',
+            feature_id: request.feature_id,
+            fail_closed: true,
+            phase: 'mechanical',
+            ...evaluation,
+        };
+    }
+}
+//# sourceMappingURL=change-safety-preflight.service.js.map

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