scene-capability-engine 3.6.28 → 3.6.32

package/lib/commands/timeline.js

@@ -5,6 +5,12 @@ const {
   ProjectTimelineStore,
   captureTimelineCheckpoint
 } = require('../runtime/project-timeline');
+const {
+  summarizeTimelineAttention,
+  buildTimelineEntryViewModel,
+  buildTimelineListViewModel,
+  buildTimelineShowViewModel
+} = require('../magicball/timeline-view-model');
 
 function normalizeText(value) {
   if (typeof value !== 'string') {
@@ -44,88 +50,6 @@ function createStore(dependencies = {}) {
   return dependencies.timelineStore || new ProjectTimelineStore(projectPath, fileSystem);
 }
 
-function summarizeTimelineAttention(entry = {}) {
-  const trigger = normalizeText(entry.trigger).toLowerCase();
-  const git = entry && typeof entry.git === 'object' ? entry.git : {};
-  if (trigger === 'restore') {
-    return 'high';
-  }
-  if (trigger === 'push') {
-    return 'medium';
-  }
-  if (Number(git.dirty_count || 0) > 0) {
-    return 'medium';
-  }
-  return 'low';
-}
-
-function buildTimelineEntryViewModel(entry = {}) {
-  const title = normalizeText(entry.summary) || ((normalizeText(entry.trigger) || 'timeline') + ' checkpoint');
-  const subtitleParts = [
-    normalizeText(entry.event),
-    entry.scene_id ? ('scene=' + entry.scene_id) : '',
-    Number.isFinite(Number(entry.file_count)) ? ('files=' + Number(entry.file_count)) : ''
-  ].filter(Boolean);
-  return {
-    snapshot_id: normalizeText(entry.snapshot_id) || null,
-    title,
-    subtitle: subtitleParts.join(' | '),
-    trigger: normalizeText(entry.trigger) || null,
-    event: normalizeText(entry.event) || null,
-    created_at: normalizeText(entry.created_at) || null,
-    scene_id: normalizeText(entry.scene_id) || null,
-    session_id: normalizeText(entry.session_id) || null,
-    file_count: Number.isFinite(Number(entry.file_count)) ? Number(entry.file_count) : 0,
-    branch: entry && entry.git ? normalizeText(entry.git.branch) || null : null,
-    head: entry && entry.git ? normalizeText(entry.git.head) || null : null,
-    dirty_count: entry && entry.git && Number.isFinite(Number(entry.git.dirty_count)) ? Number(entry.git.dirty_count) : 0,
-    attention_level: summarizeTimelineAttention(entry),
-    show_command: normalizeText(entry.snapshot_id) ? ('sce timeline show ' + entry.snapshot_id + ' --json') : null,
-    restore_command: normalizeText(entry.snapshot_id) ? ('sce timeline restore ' + entry.snapshot_id + ' --json') : null
-  };
-}
-
-function buildTimelineListViewModel(payload = {}) {
-  const snapshots = Array.isArray(payload.snapshots) ? payload.snapshots : [];
-  const trigger_counts = {};
-  let dirty_snapshot_count = 0;
-  const sceneIds = new Set();
-  for (const item of snapshots) {
-    const trigger = normalizeText(item.trigger) || 'unknown';
-    trigger_counts[trigger] = Number(trigger_counts[trigger] || 0) + 1;
-    if (item.scene_id) {
-      sceneIds.add(item.scene_id);
-    }
-    if (item.git && item.git.dirty) {
-      dirty_snapshot_count += 1;
-    }
-  }
-  return {
-    summary: {
-      total: Number(payload.total || snapshots.length || 0),
-      latest_snapshot_id: snapshots[0] ? normalizeText(snapshots[0].snapshot_id) || null : null,
-      latest_created_at: snapshots[0] ? normalizeText(snapshots[0].created_at) || null : null,
-      dirty_snapshot_count,
-      scene_count: sceneIds.size,
-      trigger_counts
-    },
-    entries: snapshots.map((item) => buildTimelineEntryViewModel(item))
-  };
-}
-
-function buildTimelineShowViewModel(payload = {}) {
-  const snapshot = payload.snapshot && typeof payload.snapshot === 'object' ? payload.snapshot : {};
-  const filesPayload = payload.files && typeof payload.files === 'object' ? payload.files : {};
-  const files = Array.isArray(filesPayload.files) ? filesPayload.files : [];
-  return {
-    snapshot: buildTimelineEntryViewModel(snapshot),
-    files_preview: files.slice(0, 20),
-    file_preview_count: Math.min(files.length, 20),
-    file_total: Number(filesPayload.file_count || files.length || 0),
-    restore_command: snapshot.snapshot_id ? ('sce timeline restore ' + snapshot.snapshot_id + ' --json') : null
-  };
-}
-
 function printPayload(payload, asJson = false, title = 'Timeline') {
   if (asJson) {
     console.log(JSON.stringify(payload, null, 2));

package/lib/magicball/capability-inventory-view-model.js

@@ -0,0 +1,213 @@
+const { buildMagicballStatusLanguage } = require('./status-language');
+
+function normalizeText(value) {
+  if (typeof value !== 'string') {
+    return '';
+  }
+  return value.trim();
+}
+
+function buildCapabilityInventorySceneAdvice(entry = {}) {
+  const sceneId = String(entry && entry.scene_id || 'scene.unknown');
+  const releaseUi = entry && entry.release_readiness_ui ? entry.release_readiness_ui : { publish_ready: true, blocking_missing: [] };
+  const missing = Array.isArray(releaseUi.blocking_missing) ? releaseUi.blocking_missing : [];
+  const valueScore = Number(entry && entry.score_preview && entry.score_preview.value_score || 0);
+
+  let attentionLevel = 'low';
+  let recommendedAction = '可直接发布';
+  let blockingSummary = '已满足发布前置条件';
+  let nextAction = 'publish';
+
+  if (!releaseUi.publish_ready) {
+    if (missing.includes('decision_strategy')) {
+      attentionLevel = 'critical';
+      recommendedAction = '补齐决策策略';
+      blockingSummary = '缺决策策略，暂不可发布';
+      nextAction = 'fill_decision_strategy';
+    } else if (missing.includes('business_rules')) {
+      attentionLevel = 'high';
+      recommendedAction = '补齐业务规则';
+      blockingSummary = '缺业务规则，暂不可发布';
+      nextAction = 'fill_business_rules';
+    } else if (missing.includes('entity_relation')) {
+      attentionLevel = 'medium';
+      recommendedAction = '补齐实体关系';
+      blockingSummary = '缺实体关系，暂不可发布';
+      nextAction = 'fill_entity_relation';
+    } else {
+      attentionLevel = 'medium';
+      recommendedAction = '补齐本体能力';
+      blockingSummary = '本体能力不完整，暂不可发布';
+      nextAction = 'repair_ontology_core';
+    }
+  } else if (valueScore >= 70) {
+    attentionLevel = 'low';
+    recommendedAction = '进入模板构建';
+    blockingSummary = '能力成熟度较高，可进入模板构建/发布';
+    nextAction = 'build_template';
+  } else {
+    attentionLevel = 'medium';
+    recommendedAction = '继续补充任务证据';
+    blockingSummary = '已可发布，但建议先补强任务与验证证据';
+    nextAction = 'strengthen_evidence';
+  }
+
+  return {
+    attention_level: attentionLevel,
+    recommended_action: recommendedAction,
+    blocking_summary: blockingSummary,
+    next_action: nextAction,
+    next_command: 'sce capability extract --scene ' + sceneId + ' --json',
+    mb_status: buildMagicballStatusLanguage({
+      attention_level: attentionLevel,
+      status_label: releaseUi.publish_ready ? 'publish_ready' : 'blocked',
+      blocking_summary: blockingSummary,
+      recommended_action: recommendedAction
+    })
+  };
+}
+
+function buildCapabilityInventorySummaryStats(entries) {
+  const items = Array.isArray(entries) ? entries : [];
+  const summary = {
+    publish_ready_count: 0,
+    blocked_count: 0,
+    missing_triads: {
+      decision_strategy: 0,
+      business_rules: 0,
+      entity_relation: 0
+    }
+  };
+
+  for (const entry of items) {
+    const ready = Boolean(entry && entry.release_readiness_ui && entry.release_readiness_ui.publish_ready);
+    if (ready) {
+      summary.publish_ready_count += 1;
+    } else {
+      summary.blocked_count += 1;
+    }
+
+    const missing = Array.isArray(entry && entry.release_readiness_ui && entry.release_readiness_ui.blocking_missing)
+      ? entry.release_readiness_ui.blocking_missing
+      : [];
+    for (const triad of Object.keys(summary.missing_triads)) {
+      if (missing.includes(triad)) {
+        summary.missing_triads[triad] += 1;
+      }
+    }
+  }
+
+  return summary;
+}
+
+function buildCapabilityInventorySummaryRecommendations(entries) {
+  const items = Array.isArray(entries) ? entries : [];
+  const recommendations = [];
+  const blocked = items.filter((item) => !(item && item.release_readiness_ui && item.release_readiness_ui.publish_ready));
+  const missingDecision = blocked.filter((item) => Array.isArray(item.release_readiness_ui && item.release_readiness_ui.blocking_missing) && item.release_readiness_ui.blocking_missing.includes('decision_strategy'));
+  const missingRules = blocked.filter((item) => Array.isArray(item.release_readiness_ui && item.release_readiness_ui.blocking_missing) && item.release_readiness_ui.blocking_missing.includes('business_rules'));
+  const readyScenes = items.filter((item) => item && item.release_readiness_ui && item.release_readiness_ui.publish_ready);
+
+  if (missingDecision.length > 0) {
+    recommendations.push('优先处理缺决策策略的 scene（' + missingDecision.length + '）');
+  }
+  if (missingRules.length > 0) {
+    recommendations.push('其次处理缺业务规则的 scene（' + missingRules.length + '）');
+  }
+  if (readyScenes.length > 0) {
+    recommendations.push('可优先推进可发布 scene 进入模板构建（' + readyScenes.length + '）');
+  }
+  if (blocked.length === 0 && readyScenes.length === 0 && items.length > 0) {
+    recommendations.push('当前 scene 已基本稳定，可继续补强验证证据');
+  }
+
+  return recommendations;
+}
+
+function buildCapabilityInventoryQuickFilters(summaryStats) {
+  const stats = summaryStats || { blocked_count: 0, missing_triads: {} };
+  const filters = [];
+  if (Number(stats.blocked_count || 0) > 0) {
+    filters.push({ id: 'blocked', label: '不可发布', query: { release_ready: false, missing_triad: null } });
+  }
+  for (const triad of ['decision_strategy', 'business_rules', 'entity_relation']) {
+    if (Number(stats.missing_triads && stats.missing_triads[triad] || 0) > 0) {
+      filters.push({ id: 'missing_' + triad, label: '缺' + triad, query: { release_ready: false, missing_triad: triad } });
+    }
+  }
+  if (Number(stats.publish_ready_count || 0) > 0) {
+    filters.push({ id: 'ready', label: '可发布', query: { release_ready: true, missing_triad: null } });
+  }
+  return filters;
+}
+
+function resolveCapabilityTriadPriority(entry = {}) {
+  const missing = Array.isArray(entry && entry.release_readiness_ui && entry.release_readiness_ui.blocking_missing)
+    ? entry.release_readiness_ui.blocking_missing
+    : [];
+  if (missing.includes('decision_strategy')) {
+    return 0;
+  }
+  if (missing.includes('business_rules')) {
+    return 1;
+  }
+  if (missing.includes('entity_relation')) {
+    return 2;
+  }
+  return 3;
+}
+
+function sortCapabilityInventoryEntries(entries) {
+  return [...(Array.isArray(entries) ? entries : [])].sort((left, right) => {
+    const leftReady = Boolean(left && left.release_readiness_ui && left.release_readiness_ui.publish_ready);
+    const rightReady = Boolean(right && right.release_readiness_ui && right.release_readiness_ui.publish_ready);
+    if (leftReady !== rightReady) {
+      return leftReady ? 1 : -1;
+    }
+
+    const triadDelta = resolveCapabilityTriadPriority(left) - resolveCapabilityTriadPriority(right);
+    if (triadDelta !== 0) {
+      return triadDelta;
+    }
+
+    const leftValue = Number(left && left.score_preview && left.score_preview.value_score || 0);
+    const rightValue = Number(right && right.score_preview && right.score_preview.value_score || 0);
+    if (leftValue !== rightValue) {
+      return rightValue - leftValue;
+    }
+
+    return String(left && left.scene_id || '').localeCompare(String(right && right.scene_id || ''));
+  });
+}
+
+function filterCapabilityInventoryEntries(entries, options = {}) {
+  const normalizedMissingTriad = normalizeText(options.missingTriad || options.missing_triad).toLowerCase();
+  const releaseReadyFilter = normalizeText(options.releaseReady || options.release_ready).toLowerCase();
+  return (Array.isArray(entries) ? entries : []).filter((entry) => {
+    if (releaseReadyFilter) {
+      const expected = ['1', 'true', 'yes', 'ready'].includes(releaseReadyFilter);
+      if (Boolean(entry.release_readiness_ui && entry.release_readiness_ui.publish_ready) !== expected) {
+        return false;
+      }
+    }
+    if (normalizedMissingTriad) {
+      const missing = Array.isArray(entry.release_readiness_ui && entry.release_readiness_ui.blocking_missing)
+        ? entry.release_readiness_ui.blocking_missing
+        : [];
+      if (!missing.includes(normalizedMissingTriad)) {
+        return false;
+      }
+    }
+    return true;
+  });
+}
+
+module.exports = {
+  buildCapabilityInventorySceneAdvice,
+  buildCapabilityInventorySummaryStats,
+  buildCapabilityInventorySummaryRecommendations,
+  buildCapabilityInventoryQuickFilters,
+  resolveCapabilityTriadPriority,
+  sortCapabilityInventoryEntries,
+  filterCapabilityInventoryEntries
+};

package/lib/magicball/status-language.js

@@ -0,0 +1,29 @@
+const TONE_BY_ATTENTION = Object.freeze({
+  critical: 'danger',
+  high: 'warning',
+  medium: 'info',
+  low: 'success'
+});
+
+function normalizeText(value) {
+  if (typeof value !== 'string') {
+    return '';
+  }
+  return value.trim();
+}
+
+function buildMagicballStatusLanguage(input = {}) {
+  const attention = normalizeText(input.attention_level) || 'medium';
+  return {
+    attention_level: attention,
+    status_tone: TONE_BY_ATTENTION[attention] || 'info',
+    status_label: normalizeText(input.status_label) || null,
+    blocking_summary: normalizeText(input.blocking_summary) || null,
+    recommended_action: normalizeText(input.recommended_action) || null
+  };
+}
+
+module.exports = {
+  buildMagicballStatusLanguage,
+  TONE_BY_ATTENTION
+};

package/lib/magicball/task-feedback-model.js

@@ -0,0 +1,113 @@
+const { buildMagicballStatusLanguage } = require('./status-language');
+
+function normalizeString(value) {
+  if (typeof value !== 'string') {
+    return '';
+  }
+  return value.trim();
+}
+
+function buildTaskFeedbackModel(payload = {}) {
+  const task = payload && payload.task && typeof payload.task === 'object' ? payload.task : {};
+  const handoff = task && typeof task.handoff === 'object' ? task.handoff : {};
+  const errors = Array.isArray(task.errors) ? task.errors : [];
+  const commands = Array.isArray(task.commands) ? task.commands : [];
+  const fileChanges = Array.isArray(task.file_changes) ? task.file_changes : [];
+  const evidence = Array.isArray(task.evidence) ? task.evidence : [];
+  const acceptance = Array.isArray(task.acceptance_criteria) ? task.acceptance_criteria : [];
+  const firstError = errors[0] || {};
+  const stage = normalizeString(handoff.stage) || 'task';
+  const status = normalizeString(task.status) || 'unknown';
+  const problemComponent = normalizeString(handoff.component) || normalizeString(payload.sceneId) || null;
+  const expected = normalizeString(acceptance[0]) || ('Complete ' + stage + ' stage successfully');
+  const actual = normalizeString(firstError.message) || ('Current status: ' + status);
+
+  let chainCheckpoint = 'task-envelope';
+  if (errors.length > 0 && commands.length > 0) {
+    chainCheckpoint = 'command-execution';
+  } else if (errors.length > 0) {
+    chainCheckpoint = 'stage-gate';
+  } else if (fileChanges.length > 0) {
+    chainCheckpoint = 'patch-applied';
+  } else if (evidence.length > 0) {
+    chainCheckpoint = 'evidence-collected';
+  }
+
+  let confidence = 'low';
+  if (errors.length > 0) {
+    confidence = 'medium';
+  } else if (status === 'completed') {
+    confidence = 'high';
+  }
+
+  let recommendedAction = '继续当前阶段';
+  if (errors.length > 0) {
+    recommendedAction = '处理阻断后重试';
+  } else if (status === 'completed' && normalizeString(task.next_action) && normalizeString(task.next_action) !== 'complete') {
+    recommendedAction = '执行下一阶段';
+  } else if (status === 'completed') {
+    recommendedAction = '任务完成';
+  }
+
+  const model = {
+    version: '1.0',
+    problem: {
+      component: problemComponent,
+      action: normalizeString(handoff.action) || stage,
+      expected,
+      actual
+    },
+    execution: {
+      stage,
+      status,
+      summary: Array.isArray(task.summary) ? task.summary.slice(0, 3) : [],
+      blocking_summary: normalizeString(handoff.blocking_summary) || normalizeString(firstError.message) || null
+    },
+    diagnosis: {
+      hypothesis: normalizeString(firstError.error_bundle) || normalizeString(firstError.message) || normalizeString(handoff.reason) || null,
+      chain_checkpoint: chainCheckpoint,
+      root_cause_confidence: confidence
+    },
+    evidence: {
+      file_count: fileChanges.length,
+      file_paths: fileChanges.slice(0, 5).map((item) => normalizeString(item && item.path)).filter(Boolean),
+      command_count: commands.length,
+      error_count: errors.length,
+      verification_result: status === 'completed' ? 'passed-or-advanced' : (errors.length > 0 ? 'blocked' : 'in-progress'),
+      regression_scope: Array.isArray(handoff.regression_scope) ? handoff.regression_scope : []
+    },
+    next_step: {
+      recommended_action: recommendedAction,
+      next_action: normalizeString(task.next_action) || null,
+      next_command: normalizeString(task.next_action) || null
+    }
+  };
+
+  model.mb_status = buildMagicballStatusLanguage({
+    status: model.execution.status,
+    attention_level: model.diagnosis.root_cause_confidence === 'high' ? 'high' : (model.execution.status === 'completed' ? 'low' : 'medium'),
+    status_label: model.execution.status,
+    blocking_summary: model.execution.blocking_summary,
+    recommended_action: model.next_step.recommended_action
+  });
+
+  return model;
+}
+
+function attachTaskFeedbackModel(payload = {}) {
+  if (!payload || typeof payload !== 'object' || !payload.task || typeof payload.task !== 'object') {
+    return payload;
+  }
+  return {
+    ...payload,
+    task: {
+      ...payload.task,
+      feedback_model: buildTaskFeedbackModel(payload)
+    }
+  };
+}
+
+module.exports = {
+  buildTaskFeedbackModel,
+  attachTaskFeedbackModel
+};

package/lib/magicball/timeline-view-model.js

@@ -0,0 +1,95 @@
+function normalizeText(value) {
+  if (typeof value !== 'string') {
+    return '';
+  }
+  return value.trim();
+}
+
+function summarizeTimelineAttention(entry = {}) {
+  const trigger = normalizeText(entry.trigger).toLowerCase();
+  const git = entry && typeof entry.git === 'object' ? entry.git : {};
+  if (trigger === 'restore') {
+    return 'high';
+  }
+  if (trigger === 'push') {
+    return 'medium';
+  }
+  if (Number(git.dirty_count || 0) > 0) {
+    return 'medium';
+  }
+  return 'low';
+}
+
+function buildTimelineEntryViewModel(entry = {}) {
+  const title = normalizeText(entry.summary) || ((normalizeText(entry.trigger) || 'timeline') + ' checkpoint');
+  const subtitleParts = [
+    normalizeText(entry.event),
+    entry.scene_id ? ('scene=' + entry.scene_id) : '',
+    Number.isFinite(Number(entry.file_count)) ? ('files=' + Number(entry.file_count)) : ''
+  ].filter(Boolean);
+  return {
+    snapshot_id: normalizeText(entry.snapshot_id) || null,
+    title,
+    subtitle: subtitleParts.join(' | '),
+    trigger: normalizeText(entry.trigger) || null,
+    event: normalizeText(entry.event) || null,
+    created_at: normalizeText(entry.created_at) || null,
+    scene_id: normalizeText(entry.scene_id) || null,
+    session_id: normalizeText(entry.session_id) || null,
+    file_count: Number.isFinite(Number(entry.file_count)) ? Number(entry.file_count) : 0,
+    branch: entry && entry.git ? normalizeText(entry.git.branch) || null : null,
+    head: entry && entry.git ? normalizeText(entry.git.head) || null : null,
+    dirty_count: entry && entry.git && Number.isFinite(Number(entry.git.dirty_count)) ? Number(entry.git.dirty_count) : 0,
+    attention_level: summarizeTimelineAttention(entry),
+    show_command: normalizeText(entry.snapshot_id) ? ('sce timeline show ' + entry.snapshot_id + ' --json') : null,
+    restore_command: normalizeText(entry.snapshot_id) ? ('sce timeline restore ' + entry.snapshot_id + ' --json') : null
+  };
+}
+
+function buildTimelineListViewModel(payload = {}) {
+  const snapshots = Array.isArray(payload.snapshots) ? payload.snapshots : [];
+  const trigger_counts = {};
+  let dirty_snapshot_count = 0;
+  const sceneIds = new Set();
+  for (const item of snapshots) {
+    const trigger = normalizeText(item.trigger) || 'unknown';
+    trigger_counts[trigger] = Number(trigger_counts[trigger] || 0) + 1;
+    if (item.scene_id) {
+      sceneIds.add(item.scene_id);
+    }
+    if (item.git && item.git.dirty) {
+      dirty_snapshot_count += 1;
+    }
+  }
+  return {
+    summary: {
+      total: Number(payload.total || snapshots.length || 0),
+      latest_snapshot_id: snapshots[0] ? normalizeText(snapshots[0].snapshot_id) || null : null,
+      latest_created_at: snapshots[0] ? normalizeText(snapshots[0].created_at) || null : null,
+      dirty_snapshot_count,
+      scene_count: sceneIds.size,
+      trigger_counts
+    },
+    entries: snapshots.map((item) => buildTimelineEntryViewModel(item))
+  };
+}
+
+function buildTimelineShowViewModel(payload = {}) {
+  const snapshot = payload.snapshot && typeof payload.snapshot === 'object' ? payload.snapshot : {};
+  const filesPayload = payload.files && typeof payload.files === 'object' ? payload.files : {};
+  const files = Array.isArray(filesPayload.files) ? filesPayload.files : [];
+  return {
+    snapshot: buildTimelineEntryViewModel(snapshot),
+    files_preview: files.slice(0, 20),
+    file_preview_count: Math.min(files.length, 20),
+    file_total: Number(filesPayload.file_count || files.length || 0),
+    restore_command: snapshot.snapshot_id ? ('sce timeline restore ' + snapshot.snapshot_id + ' --json') : null
+  };
+}
+
+module.exports = {
+  summarizeTimelineAttention,
+  buildTimelineEntryViewModel,
+  buildTimelineListViewModel,
+  buildTimelineShowViewModel
+};