sdd-agent-platform 0.2.0 → 0.4.0

package/node_modules/@sdd-agent-platform/core/dist/lifecycle/decision-gate.js

@@ -0,0 +1,319 @@
+import { LIFECYCLE_DECISION_CONTRACT, LIFECYCLE_DECISION_VERSION } from '../contracts.js';
+import { appendEvent } from '../run-state/events.js';
+import { readRunState, writeRunState } from '../run-state/run-state.js';
+const FULL_PROFILE_HARD_GATES = [
+    'security_auth',
+    'database_or_data_loss',
+    'api_schema_contract',
+    'state_machine_concurrency_liveness',
+    'ci_dependency_build_release'
+];
+export function evaluateLifecycleDecisionGate(input = {}, decidedAt = new Date()) {
+    const signals = normalizeLifecycleSignals(input);
+    const hardGateHits = evaluateLifecycleHardGates(signals);
+    const reasons = [];
+    const escalationTriggers = defaultEscalationTriggers();
+    let profile;
+    if (hardGateHits.includes('external_unknown') || hardGateHits.includes('architecture_decision_required')) {
+        profile = 'research';
+        reasons.push('External unknowns or architecture decisions require research before implementation.');
+    }
+    else if (hardGateHits.some((gate) => FULL_PROFILE_HARD_GATES.includes(gate))) {
+        profile = 'full';
+        reasons.push('Hard gate requires full SDD path with explicit spec, plan, tasks, review, and validation evidence.');
+    }
+    else if (signals.impact_confidence === 'low') {
+        profile = signals.can_scout_impact ? 'compact' : 'research';
+        reasons.push(signals.can_scout_impact ? 'Impact confidence is low but can be bounded by scout evidence, so direct is not allowed.' : 'Impact cannot be estimated safely, so research is required.');
+    }
+    else if (signals.acceptance_clarity === 'low' || signals.validation_clarity === 'unclear') {
+        profile = signals.external_unknown ? 'research' : 'compact';
+        reasons.push('Acceptance or validation signals are insufficient for direct execution.');
+    }
+    else if (matchesDirectWhitelist(signals, hardGateHits)) {
+        profile = 'direct';
+        reasons.push('All direct whitelist conditions hold: clear intent, clear acceptance, high impact confidence, no risk tags, reversible change, and cheap local validation.');
+    }
+    else if (isBoundedCompactChange(signals)) {
+        profile = 'compact';
+        reasons.push('Change is bounded but needs lightweight task boundary or validation context.');
+    }
+    else {
+        profile = 'full';
+        reasons.push('Signals exceed compact boundary or require multi-step SDD evidence.');
+    }
+    if (hardGateHits.length > 0) {
+        reasons.push(`Hard gates hit: ${hardGateHits.join(', ')}.`);
+    }
+    if (signals.policy_hits.length > 0) {
+        reasons.push(`Policy hits require checkpoint attention: ${signals.policy_hits.join(', ')}.`);
+    }
+    if (signals.permission_required.length > 0) {
+        reasons.push(`Permissions require explicit user/Claude Code confirmation: ${signals.permission_required.join(', ')}.`);
+    }
+    const confidence = estimateLifecycleConfidence(signals, hardGateHits);
+    const checkpointRequired = signals.human_checkpoint_required || hardGateHits.includes('database_or_data_loss') || signals.reversibility === 'irreversible' || signals.policy_hits.length > 0 || signals.permission_required.length > 0 || (confidence === 'low' && profile !== 'research');
+    const record = {
+        contract: LIFECYCLE_DECISION_CONTRACT,
+        version: LIFECYCLE_DECISION_VERSION,
+        model_version: 'phase1.0-final',
+        input_summary: {
+            intent_clarity: signals.intent_clarity,
+            acceptance_clarity: signals.acceptance_clarity,
+            estimated_change_size: signals.estimated_change_size,
+            task_count_estimate: signals.task_count_estimate,
+            file_count_estimate: signals.file_count_estimate,
+            impact_surface: signals.affected_layers,
+            affected_contracts: signals.affected_contracts,
+            dependency_fanout: signals.dependency_fanout,
+            impact_confidence: signals.impact_confidence,
+            risk_tags: signals.risk_tags,
+            reversibility: signals.reversibility,
+            validation_clarity: signals.validation_clarity,
+            validation_available: signals.validation_available,
+            validation_cost: signals.validation_cost,
+            orchestration_uncertainty: signals.orchestration_uncertainty,
+            policy_hits: signals.policy_hits,
+            permission_required: signals.permission_required
+        },
+        decision: {
+            profile,
+            confidence,
+            hard_gate_hits: hardGateHits,
+            required_stages: requiredStagesForProfile(profile),
+            skipped_stages: skippedStagesForProfile(profile),
+            human_checkpoint_required: checkpointRequired
+        },
+        reasons,
+        escalation_triggers: escalationTriggers,
+        downgrade_reason: null,
+        audit: {
+            decided_at: decidedAt.toISOString(),
+            decided_by: 'command',
+            policy_version: 'phase1.0-final',
+            source_artifacts: uniqueStrings(['docs/architecture/lifecycle-decision-model.md', ...signals.source_artifacts])
+        }
+    };
+    return {
+        record,
+        checkpointRequired,
+        boundaries: commandIntegrationBoundaries(profile),
+        autonomyCeiling: lifecycleAutonomyCeiling(record)
+    };
+}
+export async function recordLifecycleDecision(projectRoot, runId, record) {
+    const state = await readRunState(projectRoot, runId);
+    const nextState = {
+        ...state,
+        lifecycleDecision: record
+    };
+    await writeRunState(projectRoot, nextState);
+    await appendEvent(projectRoot, runId, {
+        event: 'lifecycle_decision_recorded',
+        runId,
+        summary: `Lifecycle decision recorded by Phase 1.7 command gate: ${record.decision.profile ?? 'unknown'} / ${record.decision.confidence ?? 'unknown'}`,
+        data: {
+            contract: record.contract,
+            modelVersion: record.model_version,
+            profile: record.decision.profile,
+            confidence: record.decision.confidence,
+            hardGateHits: record.decision.hard_gate_hits,
+            humanCheckpointRequired: record.decision.human_checkpoint_required
+        }
+    });
+    return readRunState(projectRoot, runId);
+}
+export function emptyLifecycleDecisionRecord() {
+    return {
+        contract: LIFECYCLE_DECISION_CONTRACT,
+        version: LIFECYCLE_DECISION_VERSION,
+        model_version: 'phase1.0-final',
+        input_summary: {},
+        decision: {
+            profile: null,
+            confidence: null,
+            hard_gate_hits: [],
+            required_stages: [],
+            skipped_stages: [],
+            human_checkpoint_required: false
+        },
+        reasons: ['Phase 1.2 records the lifecycle decision contract; Phase 1.7 command gate will populate decision values.'],
+        escalation_triggers: [],
+        downgrade_reason: null,
+        audit: {
+            decided_at: null,
+            decided_by: null,
+            policy_version: 'phase1.0-final',
+            source_artifacts: ['docs/architecture/lifecycle-decision-model.md']
+        }
+    };
+}
+export function lifecycleAutonomyCeiling(record) {
+    const decision = record.decision;
+    if (decision.profile === 'research') {
+        return 'research_before_implementation';
+    }
+    if (decision.profile === 'full' || decision.human_checkpoint_required || decision.hard_gate_hits.some((gate) => FULL_PROFILE_HARD_GATES.includes(gate))) {
+        return 'full_sdd_with_checkpoint';
+    }
+    if (decision.profile === 'compact') {
+        return 'compact_boundary_only';
+    }
+    return 'direct_execution_allowed';
+}
+function normalizeLifecycleSignals(input) {
+    return {
+        intent_clarity: input.intent_clarity ?? 'medium',
+        acceptance_clarity: input.acceptance_clarity ?? 'medium',
+        estimated_change_size: input.estimated_change_size ?? 'small',
+        task_count_estimate: input.task_count_estimate ?? 1,
+        file_count_estimate: input.file_count_estimate ?? 1,
+        affected_layers: input.affected_layers ?? [],
+        affected_contracts: input.affected_contracts ?? [],
+        dependency_fanout: input.dependency_fanout ?? 'local',
+        impact_confidence: input.impact_confidence ?? 'medium',
+        risk_tags: uniqueStrings(input.risk_tags ?? []),
+        reversibility: input.reversibility ?? 'unknown',
+        validation_clarity: input.validation_clarity ?? 'partial',
+        validation_available: input.validation_available ?? false,
+        validation_cost: input.validation_cost ?? 'unknown',
+        policy_hits: uniqueStrings(input.policy_hits ?? []),
+        permission_required: uniqueStrings(input.permission_required ?? []),
+        requires_agents: input.requires_agents ?? false,
+        handoff_count: input.handoff_count ?? 0,
+        artifact_dependency: input.artifact_dependency ?? false,
+        runtime_recovery_need: input.runtime_recovery_need ?? false,
+        orchestration_uncertainty: input.orchestration_uncertainty ?? 'medium',
+        human_checkpoint_required: input.human_checkpoint_required ?? false,
+        approval_reason: input.approval_reason ?? [],
+        source_artifacts: input.source_artifacts ?? [],
+        can_scout_impact: input.can_scout_impact ?? true,
+        architecture_decision_required: input.architecture_decision_required ?? false,
+        external_unknown: input.external_unknown ?? false
+    };
+}
+function evaluateLifecycleHardGates(signals) {
+    const hits = [];
+    const riskText = signals.risk_tags.map((tag) => tag.toLowerCase());
+    if (signals.external_unknown) {
+        hits.push('external_unknown');
+    }
+    if (signals.architecture_decision_required) {
+        hits.push('architecture_decision_required');
+    }
+    if (containsAny(riskText, ['security', 'auth', 'permission', 'credential', 'data_leak', 'privacy'])) {
+        hits.push('security_auth');
+    }
+    if (containsAny(riskText, ['database', 'migration', 'data_loss', 'irreversible', 'schema-data']) || signals.reversibility === 'irreversible') {
+        hits.push('database_or_data_loss');
+    }
+    if (signals.affected_contracts.length > 0 || containsAny(riskText, ['api', 'schema', 'contract'])) {
+        hits.push('api_schema_contract');
+    }
+    if (containsAny(riskText, ['state_machine', 'state-machine', 'concurrency', 'liveness', 'recovery'])) {
+        hits.push('state_machine_concurrency_liveness');
+    }
+    if (containsAny(riskText, ['ci', 'cd', 'dependency', 'build', 'release', 'publish'])) {
+        hits.push('ci_dependency_build_release');
+    }
+    if (signals.impact_confidence === 'low') {
+        hits.push(signals.can_scout_impact ? 'low_impact_confidence_scoutable' : 'low_impact_confidence_unscoutable');
+    }
+    if (signals.acceptance_clarity === 'low' || signals.validation_clarity === 'unclear') {
+        hits.push('unclear_acceptance_or_validation');
+    }
+    if (signals.policy_hits.length > 0 || signals.permission_required.length > 0) {
+        hits.push('policy_or_permission_checkpoint');
+    }
+    return uniqueStrings(hits);
+}
+function matchesDirectWhitelist(signals, hardGateHits) {
+    return signals.intent_clarity === 'high'
+        && signals.acceptance_clarity === 'high'
+        && signals.validation_clarity === 'clear'
+        && signals.validation_available
+        && signals.validation_cost === 'cheap'
+        && signals.impact_confidence === 'high'
+        && signals.risk_tags.length === 0
+        && hardGateHits.length === 0
+        && signals.reversibility === 'reversible'
+        && !signals.requires_agents
+        && signals.handoff_count === 0
+        && !signals.artifact_dependency
+        && !signals.runtime_recovery_need
+        && signals.orchestration_uncertainty === 'low'
+        && signals.file_count_estimate <= 2
+        && signals.task_count_estimate <= 1;
+}
+function isBoundedCompactChange(signals) {
+    return signals.estimated_change_size !== 'large'
+        && signals.task_count_estimate <= 2
+        && signals.file_count_estimate <= 5
+        && signals.dependency_fanout !== 'multi_component'
+        && signals.dependency_fanout !== 'unknown'
+        && signals.impact_confidence !== 'low'
+        && signals.validation_clarity !== 'unclear'
+        && signals.orchestration_uncertainty !== 'high';
+}
+function estimateLifecycleConfidence(signals, hardGateHits) {
+    if (signals.intent_clarity === 'low' || signals.impact_confidence === 'low' || signals.orchestration_uncertainty === 'high' || signals.external_unknown || signals.architecture_decision_required) {
+        return 'low';
+    }
+    if (signals.intent_clarity === 'high' && signals.acceptance_clarity === 'high' && signals.impact_confidence === 'high' && signals.validation_clarity === 'clear' && hardGateHits.length === 0) {
+        return 'high';
+    }
+    return 'medium';
+}
+function requiredStagesForProfile(profile) {
+    if (profile === 'direct') {
+        return ['intent', 'implement', 'minimal-validation'];
+    }
+    if (profile === 'compact') {
+        return ['intent-or-mini-spec', 'task-boundary', 'implement', 'validation'];
+    }
+    if (profile === 'full') {
+        return ['spec', 'plan', 'tasks', 'do', 'verify', 'sync-back-proposal'];
+    }
+    return ['research', 'options', 'decision', 'architecture-artifact', 'implementation-spec'];
+}
+function skippedStagesForProfile(profile) {
+    if (profile === 'direct') {
+        return ['full-spec', 'full-plan', 'full-tasks', 'agent-workflow'];
+    }
+    if (profile === 'compact') {
+        return ['full-spec', 'full-plan'];
+    }
+    if (profile === 'full') {
+        return ['research'];
+    }
+    return ['direct-implementation'];
+}
+function defaultEscalationTriggers() {
+    return [
+        'actual impact exceeds initial estimate',
+        'API/database/security/state-machine/concurrency/build risk appears',
+        'acceptance or validation becomes unclear',
+        'validation fails for non-obvious reasons',
+        'Spec/Plan/Task/Scope/Validation/Environment gap is detected',
+        'required artifact, delegation terminal event, or liveness evidence is missing'
+    ];
+}
+function commandIntegrationBoundaries(profile) {
+    const boundaries = [
+        'Command gate may decide and record lifecycle profile only.',
+        'Command gate must not execute Phase 1.8 task implementation loop.',
+        'Command gate must not launch agents or workflows in Phase 1.7.',
+        'Phase transition still requires checkpoint confirmation.'
+    ];
+    if (profile === 'direct' || profile === 'compact') {
+        boundaries.push('Short path is allowed only within the recorded lifecycle decision; escalation triggers remain active.');
+    }
+    return boundaries;
+}
+function containsAny(values, needles) {
+    return values.some((value) => needles.some((needle) => value.includes(needle)));
+}
+function uniqueStrings(values) {
+    return Array.from(new Set(values.filter((value) => value.length > 0)));
+}
+//# sourceMappingURL=decision-gate.js.map

package/node_modules/@sdd-agent-platform/core/dist/lifecycle/decision-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision-gate.js","sourceRoot":"","sources":["../../src/lifecycle/decision-gate.ts"],"names":[],"mappings":"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"}

package/node_modules/@sdd-agent-platform/core/dist/lifecycle/rendering.d.ts

@@ -0,0 +1,2 @@
+import type { LifecycleDecisionGateResult } from './decision-gate.js';
+export declare function renderLifecycleDecisionGate(result: LifecycleDecisionGateResult): string;

package/node_modules/@sdd-agent-platform/core/dist/lifecycle/rendering.js

@@ -0,0 +1,27 @@
+export function renderLifecycleDecisionGate(result) {
+    const decision = result.record.decision;
+    const lines = ['Lifecycle decision'];
+    lines.push('');
+    lines.push(lifecycleDecisionSentence(result));
+    lines.push('');
+    lines.push('Why:');
+    lines.push(`- ${result.record.reasons[0] ?? 'Lifecycle signals were evaluated.'}`);
+    lines.push('');
+    lines.push('Next:');
+    lines.push(`- ${decision.required_stages.length > 0 ? `Complete required stages: ${decision.required_stages.join(' -> ')}.` : 'No required stages were selected.'}`);
+    return lines.join('\n');
+}
+function lifecycleDecisionSentence(result) {
+    const decision = result.record.decision;
+    if (decision.profile === 'research') {
+        return 'Research is required before implementation.';
+    }
+    if (decision.human_checkpoint_required) {
+        return 'Lifecycle checkpoint is required.';
+    }
+    if (decision.profile === 'direct') {
+        return 'Direct workflow is allowed.';
+    }
+    return 'Lifecycle workflow was selected.';
+}
+//# sourceMappingURL=rendering.js.map

package/node_modules/@sdd-agent-platform/core/dist/lifecycle/rendering.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rendering.js","sourceRoot":"","sources":["../../src/lifecycle/rendering.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,2BAA2B,CAAC,MAAmC;IAC7E,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC;IACxC,MAAM,KAAK,GAAG,CAAC,oBAAoB,CAAC,CAAC;IACrC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,MAAM,CAAC,CAAC,CAAC;IAC9C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACnB,KAAK,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,mCAAmC,EAAE,CAAC,CAAC;IACnF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACpB,KAAK,CAAC,IAAI,CAAC,KAAK,QAAQ,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,6BAA6B,QAAQ,CAAC,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,mCAAmC,EAAE,CAAC,CAAC;IACrK,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,yBAAyB,CAAC,MAAmC;IACpE,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC;IACxC,IAAI,QAAQ,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;QACpC,OAAO,6CAA6C,CAAC;IACvD,CAAC;IACD,IAAI,QAAQ,CAAC,yBAAyB,EAAE,CAAC;QACvC,OAAO,mCAAmC,CAAC;IAC7C,CAAC;IACD,IAAI,QAAQ,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QAClC,OAAO,6BAA6B,CAAC;IACvC,CAAC;IACD,OAAO,kCAAkC,CAAC;AAC5C,CAAC"}

package/node_modules/@sdd-agent-platform/core/dist/lifecycle/risk-signals.d.ts

@@ -0,0 +1,57 @@
+import { LIFECYCLE_RISK_GATE_CONTRACT_VERSION } from '../contracts.js';
+export type SignalClarity = 'high' | 'medium' | 'low';
+export type EstimatedChangeSize = 'tiny' | 'small' | 'medium' | 'large';
+export type ImpactConfidence = 'high' | 'medium' | 'low';
+export type ValidationClarity = 'clear' | 'partial' | 'unclear';
+export type OrchestrationUncertainty = 'low' | 'medium' | 'high';
+export type Reversibility = 'reversible' | 'irreversible' | 'unknown';
+export type LifecycleRiskCategory = 'state_machine' | 'concurrency' | 'database_data_loss' | 'security' | 'sql' | 'api_schema' | 'ci_build' | 'external_unknown';
+export type LifecycleRiskExtractionSource = 'from_text' | 'from_file' | 'none';
+export interface LifecycleRiskExtractionEvidence {
+    category: LifecycleRiskCategory;
+    matched: string;
+    riskTag: string;
+}
+export interface LifecycleDecisionSignals {
+    intent_clarity: SignalClarity;
+    acceptance_clarity: SignalClarity;
+    estimated_change_size: EstimatedChangeSize;
+    task_count_estimate: number;
+    file_count_estimate: number;
+    affected_layers: string[];
+    affected_contracts: string[];
+    dependency_fanout: 'none' | 'local' | 'multi_component' | 'unknown';
+    impact_confidence: ImpactConfidence;
+    risk_tags: string[];
+    reversibility: Reversibility;
+    validation_clarity: ValidationClarity;
+    validation_available: boolean;
+    validation_cost: 'cheap' | 'moderate' | 'expensive' | 'unknown';
+    policy_hits: string[];
+    permission_required: string[];
+    requires_agents: boolean;
+    handoff_count: number;
+    artifact_dependency: boolean;
+    runtime_recovery_need: boolean;
+    orchestration_uncertainty: OrchestrationUncertainty;
+    human_checkpoint_required: boolean;
+    approval_reason: string[];
+    source_artifacts: string[];
+    can_scout_impact: boolean;
+    architecture_decision_required: boolean;
+    external_unknown: boolean;
+}
+export interface LifecycleRiskGateExtraction {
+    contract: typeof LIFECYCLE_RISK_GATE_CONTRACT_VERSION;
+    source: LifecycleRiskExtractionSource;
+    riskTags: string[];
+    affectedContracts: string[];
+    externalUnknown: boolean;
+    architectureDecisionRequired: boolean;
+    reversibility?: Reversibility;
+    validationClarity?: ValidationClarity;
+    impactConfidence?: ImpactConfidence;
+    evidence: LifecycleRiskExtractionEvidence[];
+    signals: Partial<LifecycleDecisionSignals>;
+}
+export declare function extractLifecycleRiskSignalsFromText(text: string, source?: LifecycleRiskExtractionSource): LifecycleRiskGateExtraction;

package/node_modules/@sdd-agent-platform/core/dist/lifecycle/risk-signals.js

@@ -0,0 +1,80 @@
+import { LIFECYCLE_RISK_GATE_CONTRACT_VERSION } from '../contracts.js';
+export function extractLifecycleRiskSignalsFromText(text, source = 'from_text') {
+    const evidence = [];
+    const riskTags = [];
+    const affectedContracts = [];
+    let externalUnknown = false;
+    let architectureDecisionRequired = false;
+    let reversibility;
+    let validationClarity;
+    let impactConfidence;
+    function addEvidence(category, matched, riskTag) {
+        evidence.push({ category, matched, riskTag });
+        riskTags.push(riskTag);
+    }
+    function collect(category, terms, riskTag) {
+        for (const term of terms) {
+            if (text.toLowerCase().includes(term.toLowerCase())) {
+                addEvidence(category, term, riskTag);
+            }
+        }
+    }
+    collect('state_machine', ['state machine', 'state-machine', 'state_machine', '状态机', '状态流转', '状态转换', 'liveness', 'recovery'], 'state-machine');
+    collect('concurrency', ['concurrency', 'parallel', 'race', 'thread', 'multi-thread', '并发', '线程', '竞态', '锁'], 'concurrency');
+    collect('database_data_loss', ['database', 'migration', 'consistency', '数据一致性', '数据库', '迁移'], 'database');
+    collect('database_data_loss', ['data loss', 'data-loss', '数据丢失', '不可逆', 'irreversible'], 'data_loss');
+    collect('sql', ['sql', 'SQL', 'SQL 拼接', '拼接 SQL'], 'database');
+    collect('security', ['security', 'auth', 'permission', 'credential', 'token', 'secret', 'privacy', '安全', '认证', '授权', '凭证', '隐私'], 'security');
+    collect('security', ['SQL injection', 'sql injection', '注入'], 'security');
+    collect('api_schema', ['api', 'schema', 'contract', 'openapi', '接口', '契约', '协议', '字段', '兼容'], 'api');
+    collect('ci_build', ['ci', 'cd', 'build', 'release', 'publish', 'dependency', 'pipeline', '构建', '发布', '依赖', '流水线'], 'build');
+    collect('external_unknown', ['external', 'third-party', 'unknown', 'unscoutable', '外部', '第三方', '未知', '不确定'], 'external_unknown');
+    if (evidence.some((item) => item.category === 'api_schema')) {
+        affectedContracts.push('api_schema');
+    }
+    if (evidence.some((item) => item.category === 'external_unknown')) {
+        externalUnknown = true;
+        impactConfidence = 'low';
+    }
+    if (evidence.some((item) => item.category === 'database_data_loss' && (item.riskTag === 'data_loss' || item.matched.toLowerCase().includes('irreversible') || item.matched.includes('不可逆')))) {
+        reversibility = 'irreversible';
+    }
+    if (evidence.some((item) => item.category === 'ci_build')) {
+        validationClarity = 'partial';
+    }
+    if (text.includes('架构') || text.toLowerCase().includes('architecture decision')) {
+        architectureDecisionRequired = true;
+    }
+    const signals = {
+        risk_tags: uniqueStrings(riskTags),
+        affected_contracts: uniqueStrings(affectedContracts),
+        external_unknown: externalUnknown,
+        architecture_decision_required: architectureDecisionRequired
+    };
+    if (reversibility) {
+        signals.reversibility = reversibility;
+    }
+    if (validationClarity) {
+        signals.validation_clarity = validationClarity;
+    }
+    if (impactConfidence) {
+        signals.impact_confidence = impactConfidence;
+    }
+    return {
+        contract: LIFECYCLE_RISK_GATE_CONTRACT_VERSION,
+        source,
+        riskTags: uniqueStrings(riskTags),
+        affectedContracts: uniqueStrings(affectedContracts),
+        externalUnknown,
+        architectureDecisionRequired,
+        reversibility,
+        validationClarity,
+        impactConfidence,
+        evidence,
+        signals
+    };
+}
+function uniqueStrings(values) {
+    return Array.from(new Set(values.filter((value) => value.length > 0)));
+}
+//# sourceMappingURL=risk-signals.js.map

package/node_modules/@sdd-agent-platform/core/dist/lifecycle/risk-signals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"risk-signals.js","sourceRoot":"","sources":["../../src/lifecycle/risk-signals.ts"],"names":[],"mappings":"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"}

package/node_modules/@sdd-agent-platform/core/dist/lifecycle/ship.d.ts

@@ -0,0 +1,42 @@
+import type { DoctorLevel } from '../doctor/model.js';
+import { type ProjectStatus } from '../status/project-status.js';
+export interface ShipReadinessCheck {
+    name: string;
+    status: 'PASS' | 'BLOCKED';
+    message: string;
+    nextAction?: string;
+}
+export interface ShipResult {
+    contract: 'sdd-ship-readiness-v1';
+    branch: string;
+    status: 'PASS' | 'BLOCKED';
+    dryRun: boolean;
+    releasePath: string;
+    wroteRelease: boolean;
+    checkedAt: string;
+    checks: ShipReadinessCheck[];
+    nextActions: string[];
+    projectStatus: {
+        workflowStatus: ProjectStatus['workflowStatus'];
+        tasks: ProjectStatus['tasks'];
+        taskRisk: ProjectStatus['taskRisk'];
+        latestRun: ProjectStatus['latestRun'];
+        latestRunEvidence: ProjectStatus['latestRunEvidence'];
+        staleReasons: string[];
+        affectedFileConflicts: number;
+        dependencyBlockers: number;
+        tokenProjection: ProjectStatus['tokenProjection'];
+        lifecycleRisk: ProjectStatus['lifecycleRisk'];
+    };
+    doctor: {
+        status: DoctorLevel;
+        pass: number;
+        warn: number;
+        fail: number;
+    };
+    releaseDocument: string;
+}
+export declare function runShip(projectRoot: string, options?: {
+    branch?: string | null;
+    dryRun?: boolean;
+}): Promise<ShipResult>;