scene-capability-engine 3.4.5 → 3.4.6

package/lib/workspace/takeover-baseline.js

@@ -23,7 +23,9 @@ const SPEC_DOMAIN_POLICY_DEFAULTS = Object.freeze({
   schema_version: '1.0',
   closed_loop_research_required: true,
   coverage_validation_required: true,
-  fail_on_gap_default: true
+  fail_on_gap_default: true,
+  problem_contract_required: true,
+  ontology_axes_required: ['entity', 'relation', 'business_rule', 'decision_policy', 'execution_flow']
 });
 
 const PROBLEM_EVAL_POLICY_DEFAULTS = Object.freeze({
@@ -51,7 +53,38 @@ const PROBLEM_EVAL_POLICY_DEFAULTS = Object.freeze({
     'compliance',
     'data-loss'
   ],
-  recommendation_limit: 6
+  recommendation_limit: 6,
+  max_failed_rounds_before_debug: 2,
+  problem_contract_required_stages: ['plan', 'generate', 'apply', 'verify', 'release'],
+  problem_contract_block_stages: ['plan', 'apply', 'release'],
+  ontology_alignment_required_stages: ['plan', 'generate', 'apply', 'verify', 'release'],
+  ontology_alignment_block_stages: ['apply', 'release'],
+  ontology_required_axes: ['entity', 'relation', 'business_rule', 'decision_policy', 'execution_flow'],
+  require_ontology_evidence_binding: true,
+  ontology_evidence_min_bindings: 1,
+  convergence_required_stages: ['verify', 'release'],
+  convergence_block_stages: ['release'],
+  release_block_on_high_alerts: true,
+  release_require_governance_report: false
+});
+
+const PROBLEM_CLOSURE_POLICY_DEFAULTS = Object.freeze({
+  schema_version: '1.0',
+  enabled: true,
+  governance_report_path: '.sce/reports/interactive-governance-report.json',
+  verify: {
+    require_problem_contract: true,
+    require_domain_validation: true,
+    require_domain_coverage: true
+  },
+  release: {
+    require_problem_contract: true,
+    require_domain_validation: true,
+    require_domain_coverage: true,
+    require_verify_report: true,
+    require_governance_report: false,
+    block_on_high_governance_alerts: true
+  }
 });
 
 const TAKEOVER_DEFAULTS = Object.freeze({
@@ -70,13 +103,39 @@ const TAKEOVER_DEFAULTS = Object.freeze({
   spec_domain_policy: {
     closed_loop_research_required: true,
     coverage_validation_required: true,
-    fail_on_gap_default: true
+    fail_on_gap_default: true,
+    problem_contract_required: true,
+    ontology_axes_required: ['entity', 'relation', 'business_rule', 'decision_policy', 'execution_flow']
   },
   problem_evaluation: {
     enabled: true,
     mode: 'required',
     enforce_on_stages: ['plan', 'generate', 'apply', 'verify', 'release'],
-    block_on_stages: ['apply', 'release']
+    block_on_stages: ['apply', 'release'],
+    problem_contract_required_stages: ['plan', 'generate', 'apply', 'verify', 'release'],
+    problem_contract_block_stages: ['plan', 'apply', 'release'],
+    ontology_alignment_required_stages: ['plan', 'generate', 'apply', 'verify', 'release'],
+    ontology_alignment_block_stages: ['apply', 'release'],
+    convergence_required_stages: ['verify', 'release'],
+    convergence_block_stages: ['release'],
+    max_failed_rounds_before_debug: 2
+  },
+  problem_closure: {
+    enabled: true,
+    governance_report_path: '.sce/reports/interactive-governance-report.json',
+    verify: {
+      require_problem_contract: true,
+      require_domain_validation: true,
+      require_domain_coverage: true
+    },
+    release: {
+      require_problem_contract: true,
+      require_domain_validation: true,
+      require_domain_coverage: true,
+      require_verify_report: true,
+      require_governance_report: false,
+      block_on_high_governance_alerts: true
+    }
   },
   debug_policy: {
     prioritize_root_cause_fix: true,
@@ -346,6 +405,7 @@ async function applyTakeoverBaseline(projectPath = process.cwd(), options = {})
   const sessionGovernancePath = path.join(sceRoot, 'config', 'session-governance.json');
   const specDomainPolicyPath = path.join(sceRoot, 'config', 'spec-domain-policy.json');
   const problemEvalPolicyPath = path.join(sceRoot, 'config', 'problem-eval-policy.json');
+  const problemClosurePolicyPath = path.join(sceRoot, 'config', 'problem-closure-policy.json');
   const reportPath = path.join(sceRoot, 'reports', 'takeover-baseline-latest.json');
 
   const existingAdoption = await _readJsonSafe(adoptionPath, fileSystem);
@@ -354,6 +414,7 @@ async function applyTakeoverBaseline(projectPath = process.cwd(), options = {})
   const existingSessionGovernance = await _readJsonSafe(sessionGovernancePath, fileSystem);
   const existingSpecDomainPolicy = await _readJsonSafe(specDomainPolicyPath, fileSystem);
   const existingProblemEvalPolicy = await _readJsonSafe(problemEvalPolicyPath, fileSystem);
+  const existingProblemClosurePolicy = await _readJsonSafe(problemClosurePolicyPath, fileSystem);
 
   const desiredAdoption = _buildAdoptionConfig(existingAdoption, nowIso, sceVersion);
   const desiredAutoConfig = _buildAutoConfig(existingAuto);
@@ -361,6 +422,7 @@ async function applyTakeoverBaseline(projectPath = process.cwd(), options = {})
   const desiredSessionGovernance = _deepMerge(existingSessionGovernance || {}, SESSION_GOVERNANCE_DEFAULTS);
   const desiredSpecDomainPolicy = _deepMerge(existingSpecDomainPolicy || {}, SPEC_DOMAIN_POLICY_DEFAULTS);
   const desiredProblemEvalPolicy = _deepMerge(existingProblemEvalPolicy || {}, PROBLEM_EVAL_POLICY_DEFAULTS);
+  const desiredProblemClosurePolicy = _deepMerge(existingProblemClosurePolicy || {}, PROBLEM_CLOSURE_POLICY_DEFAULTS);
 
   const fileResults = [];
   fileResults.push(await _reconcileJsonFile(adoptionPath, desiredAdoption, {
@@ -393,6 +455,11 @@ async function applyTakeoverBaseline(projectPath = process.cwd(), options = {})
     apply,
     fileSystem
   }));
+  fileResults.push(await _reconcileJsonFile(problemClosurePolicyPath, desiredProblemClosurePolicy, {
+    projectPath,
+    apply,
+    fileSystem
+  }));
   fileResults.push(await _reconcileSteeringContract(projectPath, {
     apply,
     fileSystem
@@ -441,6 +508,7 @@ module.exports = {
   TAKEOVER_DEFAULTS,
   SESSION_GOVERNANCE_DEFAULTS,
   SPEC_DOMAIN_POLICY_DEFAULTS,
+  PROBLEM_CLOSURE_POLICY_DEFAULTS,
   PROBLEM_EVAL_POLICY_DEFAULTS,
   applyTakeoverBaseline
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scene-capability-engine",
-  "version": "3.4.5",
+  "version": "3.4.6",
   "description": "SCE (Scene Capability Engine) - A CLI tool and npm package for spec-driven development with AI coding assistants.",
   "main": "index.js",
   "bin": {

package/template/.sce/config/problem-closure-policy.json

@@ -0,0 +1,18 @@
+{
+  "schema_version": "1.0",
+  "enabled": true,
+  "governance_report_path": ".sce/reports/interactive-governance-report.json",
+  "verify": {
+    "require_problem_contract": true,
+    "require_domain_validation": true,
+    "require_domain_coverage": true
+  },
+  "release": {
+    "require_problem_contract": true,
+    "require_domain_validation": true,
+    "require_domain_coverage": true,
+    "require_verify_report": true,
+    "require_governance_report": false,
+    "block_on_high_governance_alerts": true
+  }
+}

package/template/.sce/config/problem-eval-policy.json

@@ -32,5 +32,47 @@
     "compliance",
     "data-loss"
   ],
-  "recommendation_limit": 6
+  "recommendation_limit": 6,
+  "max_failed_rounds_before_debug": 2,
+  "problem_contract_required_stages": [
+    "plan",
+    "generate",
+    "apply",
+    "verify",
+    "release"
+  ],
+  "problem_contract_block_stages": [
+    "plan",
+    "apply",
+    "release"
+  ],
+  "ontology_alignment_required_stages": [
+    "plan",
+    "generate",
+    "apply",
+    "verify",
+    "release"
+  ],
+  "ontology_alignment_block_stages": [
+    "apply",
+    "release"
+  ],
+  "ontology_required_axes": [
+    "entity",
+    "relation",
+    "business_rule",
+    "decision_policy",
+    "execution_flow"
+  ],
+  "require_ontology_evidence_binding": true,
+  "ontology_evidence_min_bindings": 1,
+  "convergence_required_stages": [
+    "verify",
+    "release"
+  ],
+  "convergence_block_stages": [
+    "release"
+  ],
+  "release_block_on_high_alerts": true,
+  "release_require_governance_report": false
 }

package/template/.sce/config/spec-domain-policy.json

@@ -2,5 +2,13 @@
   "schema_version": "1.0",
   "closed_loop_research_required": true,
   "coverage_validation_required": true,
-  "fail_on_gap_default": true
+  "fail_on_gap_default": true,
+  "problem_contract_required": true,
+  "ontology_axes_required": [
+    "entity",
+    "relation",
+    "business_rule",
+    "decision_policy",
+    "execution_flow"
+  ]
 }

package/template/.sce/steering/CORE_PRINCIPLES.md

@@ -211,10 +211,12 @@
    - `.sce/specs/<spec>/custom/problem-domain-map.md`
    - `.sce/specs/<spec>/custom/scene-spec.md`
    - `.sce/specs/<spec>/custom/problem-domain-chain.json`
+   - `.sce/specs/<spec>/custom/problem-contract.json`
 2) `problem-domain-map` 必须包含：Root Problem、Mind Map、Layered Exploration Chain、Correction Loop
 3) `scene-spec` 必须包含：Scene Definition、Ontology Coverage、Decision & Execution Path、Acceptance & Gate
-4) `problem-domain-chain.json` 必须包含可机读思维链：problem/ontology/hypotheses/risks/decision_execution_path/correction_loop/verification
-5) 默认门禁强制校验上述结构，缺失即 `no-go`
+4) `problem-domain-chain.json` 必须包含可机读思维链：problem/ontology/hypotheses/risks/decision_execution_path/correction_loop/verification/problem_contract/ontology_evidence
+5) `problem-contract.json` 必须包含：issue_statement、expected_outcome、reproduction_steps、impact_scope、forbidden_workarounds
+6) 默认门禁强制校验上述结构，缺失即 `no-go`（`problem-closure-gate` 在 verify/release 默认启用）
 
 **目标**: 用全局问题域视角 + 场景契约约束，减少方向性错误与盲改，提升纠偏效率