scene-capability-engine 3.4.5 → 3.5.0

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,69 @@ 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 STUDIO_INTAKE_POLICY_DEFAULTS = Object.freeze({
+  schema_version: '1.0',
+  enabled: true,
+  auto_create_spec: true,
+  force_spec_for_studio_plan: true,
+  prefer_existing_scene_spec: true,
+  related_spec_min_score: 45,
+  allow_new_spec_when_goal_diverges: true,
+  divergence_similarity_threshold: 0.2,
+  goal_missing_strategy: 'create_for_tracking',
+  question_only_patterns: [
+    'how', 'what', 'why', 'when', 'where', 'which', 'can', 'could', 'should', 'would',
+    '是否', '怎么', '如何', '为什么', '吗', '么'
+  ],
+  change_intent_patterns: [
+    'implement', 'build', 'create', 'add', 'update', 'upgrade', 'refactor', 'fix', 'stabilize',
+    'optimize', 'deliver', 'release', 'bootstrap', 'repair', 'patch',
+    '新增', '增加', '实现', '构建', '开发', '修复', '优化', '重构', '发布', '改造', '完善', '增强'
+  ],
+  spec_id: {
+    prefix: 'auto',
+    max_goal_slug_tokens: 6
+  },
+  governance: {
+    auto_run_on_plan: true,
+    max_active_specs_per_scene: 3,
+    stale_days: 14,
+    duplicate_similarity_threshold: 0.66
+  }
 });
 
 const TAKEOVER_DEFAULTS = Object.freeze({
@@ -70,13 +134,55 @@ 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
+    }
+  },
+  studio_intake: {
+    enabled: true,
+    auto_create_spec: true,
+    force_spec_for_studio_plan: true,
+    prefer_existing_scene_spec: true,
+    related_spec_min_score: 45,
+    allow_new_spec_when_goal_diverges: true,
+    divergence_similarity_threshold: 0.2,
+    goal_missing_strategy: 'create_for_tracking',
+    governance: {
+      auto_run_on_plan: true,
+      max_active_specs_per_scene: 3,
+      stale_days: 14,
+      duplicate_similarity_threshold: 0.66
+    }
   },
   debug_policy: {
     prioritize_root_cause_fix: true,
@@ -346,6 +452,8 @@ 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 studioIntakePolicyPath = path.join(sceRoot, 'config', 'studio-intake-policy.json');
   const reportPath = path.join(sceRoot, 'reports', 'takeover-baseline-latest.json');
 
   const existingAdoption = await _readJsonSafe(adoptionPath, fileSystem);
@@ -354,6 +462,8 @@ 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 existingStudioIntakePolicy = await _readJsonSafe(studioIntakePolicyPath, fileSystem);
 
   const desiredAdoption = _buildAdoptionConfig(existingAdoption, nowIso, sceVersion);
   const desiredAutoConfig = _buildAutoConfig(existingAuto);
@@ -361,6 +471,8 @@ 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 desiredStudioIntakePolicy = _deepMerge(existingStudioIntakePolicy || {}, STUDIO_INTAKE_POLICY_DEFAULTS);
 
   const fileResults = [];
   fileResults.push(await _reconcileJsonFile(adoptionPath, desiredAdoption, {
@@ -393,6 +505,16 @@ async function applyTakeoverBaseline(projectPath = process.cwd(), options = {})
     apply,
     fileSystem
   }));
+  fileResults.push(await _reconcileJsonFile(problemClosurePolicyPath, desiredProblemClosurePolicy, {
+    projectPath,
+    apply,
+    fileSystem
+  }));
+  fileResults.push(await _reconcileJsonFile(studioIntakePolicyPath, desiredStudioIntakePolicy, {
+    projectPath,
+    apply,
+    fileSystem
+  }));
   fileResults.push(await _reconcileSteeringContract(projectPath, {
     apply,
     fileSystem
@@ -441,6 +563,8 @@ module.exports = {
   TAKEOVER_DEFAULTS,
   SESSION_GOVERNANCE_DEFAULTS,
   SPEC_DOMAIN_POLICY_DEFAULTS,
+  PROBLEM_CLOSURE_POLICY_DEFAULTS,
   PROBLEM_EVAL_POLICY_DEFAULTS,
+  STUDIO_INTAKE_POLICY_DEFAULTS,
   applyTakeoverBaseline
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scene-capability-engine",
-  "version": "3.4.5",
+  "version": "3.5.0",
   "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/config/studio-intake-policy.json

@@ -0,0 +1,68 @@
+{
+  "schema_version": "1.0",
+  "enabled": true,
+  "auto_create_spec": true,
+  "force_spec_for_studio_plan": true,
+  "prefer_existing_scene_spec": true,
+  "related_spec_min_score": 45,
+  "allow_new_spec_when_goal_diverges": true,
+  "divergence_similarity_threshold": 0.2,
+  "goal_missing_strategy": "create_for_tracking",
+  "question_only_patterns": [
+    "how",
+    "what",
+    "why",
+    "when",
+    "where",
+    "which",
+    "can",
+    "could",
+    "should",
+    "would",
+    "是否",
+    "怎么",
+    "如何",
+    "为什么",
+    "吗",
+    "么"
+  ],
+  "change_intent_patterns": [
+    "implement",
+    "build",
+    "create",
+    "add",
+    "update",
+    "upgrade",
+    "refactor",
+    "fix",
+    "stabilize",
+    "optimize",
+    "deliver",
+    "release",
+    "bootstrap",
+    "repair",
+    "patch",
+    "新增",
+    "增加",
+    "实现",
+    "构建",
+    "开发",
+    "修复",
+    "优化",
+    "重构",
+    "发布",
+    "改造",
+    "完善",
+    "增强"
+  ],
+  "spec_id": {
+    "prefix": "auto",
+    "max_goal_slug_tokens": 6
+  },
+  "governance": {
+    "auto_run_on_plan": true,
+    "max_active_specs_per_scene": 3,
+    "stale_days": 14,
+    "duplicate_similarity_threshold": 0.66
+  }
+}

package/template/.sce/config/takeover-baseline.json

@@ -18,7 +18,94 @@
     "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"
+      ],
+      "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
+      }
+    },
+    "studio_intake": {
+      "enabled": true,
+      "auto_create_spec": true,
+      "force_spec_for_studio_plan": true,
+      "prefer_existing_scene_spec": true,
+      "related_spec_min_score": 45,
+      "allow_new_spec_when_goal_diverges": true,
+      "divergence_similarity_threshold": 0.2,
+      "goal_missing_strategy": "create_for_tracking",
+      "governance": {
+        "auto_run_on_plan": true,
+        "max_active_specs_per_scene": 3,
+        "stale_days": 14,
+        "duplicate_similarity_threshold": 0.66
+      }
     },
     "debug_policy": {
       "prioritize_root_cause_fix": true,

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 默认启用）
 
 **目标**: 用全局问题域视角 + 场景契约约束，减少方向性错误与盲改，提升纠偏效率