spectra-cli 4.1.1

package/templates/drift-report.hbs

@@ -0,0 +1,53 @@
+---
+type: drift-report
+specPath: {{specPath}}
+sourcePath: {{sourcePath}}
+generatedAt: {{generatedAt}}
+specVersion: {{specVersion}}
+---
+
+# 漂移检测报告
+
+**Spec**: `{{specPath}}` ({{specVersion}})
+**源码**: `{{sourcePath}}`
+**生成时间**: {{generatedAt}}
+
+## 汇总统计
+
+| 指标 | 数值 |
+|------|------|
+| 实质性变更 | {{summary.totalChanges}} |
+| HIGH (Breaking) | {{summary.high}} |
+| MEDIUM (行为变化) | {{summary.medium}} |
+| LOW (新增/优化) | {{summary.low}} |
+| 新增 | {{summary.additions}} |
+| 删除 | {{summary.removals}} |
+| 修改 | {{summary.modifications}} |
+| 噪声过滤 | {{filteredNoise}} |
+
+{{#if items.length}}
+## 漂移详情
+
+{{#each items}}
+### {{severity}} — {{description}}
+
+- **ID**: `{{id}}`
+- **类别**: {{category}}
+- **变更类型**: {{changeType}}
+- **位置**: `{{location}}`
+{{#if symbolName}}- **符号**: `{{symbolName}}`{{/if}}
+{{#if oldValue}}- **旧值**: `{{oldValue}}`{{/if}}
+{{#if newValue}}- **新值**: `{{newValue}}`{{/if}}
+- **检测方式**: {{detectedBy}}
+- **建议更新**: {{proposedUpdate}}
+
+{{/each}}
+{{else}}
+## 漂移详情
+
+未检测到实质性变更。
+{{/if}}
+
+## 建议
+
+{{{recommendation}}}

package/templates/dynamic-scenarios.hbs

@@ -0,0 +1,46 @@
+# 动态链路: {{model.projectName}}
+
+- 生成时间: `{{generatedAt}}`
+- 场景数: `{{model.stats.totalScenarios}}`
+- 总步骤数: `{{model.stats.totalSteps}}`
+- 高置信场景数: `{{model.stats.highConfidenceScenarios}}`
+
+{{#if warnings.length}}
+## 1. Warnings
+
+{{#each warnings}}
+- {{this}}
+{{/each}}
+{{/if}}
+
+## 2. 场景列表
+
+{{#each model.scenarios}}
+### {{title}}
+
+- 分类: `{{category}}`
+- Trigger: `{{trigger}}`
+- 置信度: `{{confidence}}`
+- 推断: `{{inferred}}`
+- 参与者: {{#each participants}}`{{this}}` {{/each}}
+- 摘要: {{summary}}
+{{#if outcome}}
+- 结果: {{outcome}}
+{{/if}}
+
+#### Steps
+
+{{#each steps}}
+{{index}}. `{{actor}}`{{#if target}} -> `{{target}}`{{/if}}: {{action}}
+   {{detail}}
+   证据: {{#each evidence}}`{{sourceType}}:{{ref}}` {{/each}}
+{{/each}}
+
+{{#if evidence.length}}
+#### Evidence
+
+{{#each evidence}}
+- `{{sourceType}}:{{ref}}`{{#if note}} - {{note}}{{/if}}
+{{/each}}
+{{/if}}
+{{/each}}

package/templates/event-surface.hbs

@@ -0,0 +1,90 @@
+---
+type: event-surface
+generatedAt: {{generatedAt}}
+projectName: {{projectName}}
+totalChannels: {{totalChannels}}
+---
+
+# 事件面文档: {{projectName}}
+
+## 总览
+
+- Channels: `{{totalChannels}}`
+- Publishers: `{{totalPublishers}}`
+- Subscribers: `{{totalSubscribers}}`
+
+{{#if warnings.length}}
+## Warning
+
+{{#each warnings}}
+- {{this}}
+{{/each}}
+{{/if}}
+
+## Channel Inventory
+
+| Channel | Kind | Publishers | Subscribers | Message Fields |
+| --- | --- | --- | --- | --- |
+{{#each channels}}
+| `{{channelName}}` | `{{kind}}` | `{{publishers.length}}` | `{{subscribers.length}}` | {{#if messageFields.length}}`{{messageFields}}`{{else}}-{{/if}} |
+{{/each}}
+
+{{#each channels}}
+## {{channelName}}
+
+- Kind: `{{kind}}`
+- Publishers: `{{publishers.length}}`
+- Subscribers: `{{subscribers.length}}`
+
+{{#if messageFields.length}}
+**Message fields**
+{{#each messageFields}}
+- `{{this}}`
+{{/each}}
+{{/if}}
+
+{{#if payloadSamples.length}}
+**Payload samples**
+{{#each payloadSamples}}
+- `{{this}}`
+{{/each}}
+{{/if}}
+
+**Publishers**
+{{#if publishers.length}}
+{{#each publishers}}
+- `{{symbolName}}` @ `{{sourceFile}}` via `{{methodName}}`
+{{#if payloadSummary}}: `{{payloadSummary}}`{{/if}}
+{{/each}}
+{{else}}
+- None
+{{/if}}
+
+**Subscribers**
+{{#if subscribers.length}}
+{{#each subscribers}}
+- `{{symbolName}}` @ `{{sourceFile}}` via `{{methodName}}`
+{{/each}}
+{{else}}
+- None
+{{/if}}
+
+{{/each}}
+
+{{#if eventFlowMermaid}}
+## Event Flow
+
+```mermaid
+{{eventFlowMermaid}}
+```
+{{/if}}
+
+{{#if stateAppendixMermaid}}
+## 状态附录 [推断]
+
+置信度: `{{stateAppendixConfidence}}`
+
+```mermaid
+{{stateAppendixMermaid}}
+```
+{{/if}}

package/templates/feature-brief-index.hbs

@@ -0,0 +1,27 @@
+# {{title}}
+
+> 生成时间: `{{generatedAt}}`
+> 置信度: `{{confidence}}`
+
+{{#if warnings.length}}
+## 注意事项
+{{#each warnings}}
+- {{this}}
+{{/each}}
+{{/if}}
+
+## 1. 总览
+
+{{#each summary}}
+- {{this}}
+{{/each}}
+
+## 2. Feature Brief 列表
+
+{{#if briefs.length}}
+{{#each briefs}}
+- [{{title}}]({{fileName}}.md) — `{{status}}` / `{{confidence}}`
+{{/each}}
+{{else}}
+当前未生成 feature brief。
+{{/if}}

package/templates/feature-brief.hbs

@@ -0,0 +1,28 @@
+# {{title}}
+
+> Brief ID: `{{id}}`
+> 状态: `{{status}}`
+> 置信度: `{{confidence}}`
+> 是否推断: `{{#if inferred}}是{{else}}否{{/if}}`
+
+## 1. 摘要
+
+{{summary}}
+
+## 2. 问题
+
+{{problem}}
+
+## 3. 方案
+
+{{proposedSolution}}
+
+## 4. 目标受众
+
+{{audience}}
+
+## 5. 证据
+
+{{#each evidence}}
+- `{{sourceType}}` {{label}}{{#if path}} — `{{path}}`{{/if}}: {{excerpt}}
+{{/each}}

package/templates/index-spec.hbs

@@ -0,0 +1,57 @@
+---
+type: {{frontmatter.type}}
+version: {{frontmatter.version}}
+generatedBy: {{frontmatter.generatedBy}}
+projectRoot: {{frontmatter.projectRoot}}
+totalModules: {{frontmatter.totalModules}}
+lastUpdated: {{frontmatter.lastUpdated}}
+---
+
+# 架构索引
+
+## 系统目的
+
+{{{systemPurpose}}}
+
+## 架构模式
+
+{{{architecturePattern}}}
+
+## 模块映射
+
+| 模块 | 说明 | 拓扑层级 | 依赖 |
+|------|------|---------|------|
+{{#each moduleMap}}
+| [{{name}}]({{specPath}}) | {{description}} | {{level}} | {{#each dependencies}}{{this}}{{#unless @last}}, {{/unless}}{{/each}} |
+{{/each}}
+
+{{#if languageDistribution}}
+
+## 语言分布
+
+| 语言 | 文件数 | 模块数 | 占比 | 本次处理 |
+|------|--------|--------|------|---------|
+{{#each languageDistribution}}
+| {{language}} | {{fileCount}} | {{moduleCount}} | {{percentage}}% | {{#if processed}}是{{else}}否{{/if}} |
+{{/each}}
+
+{{/if}}
+## 依赖关系图
+
+```mermaid
+{{{dependencyDiagram}}}
+```
+
+## 横切关注点
+
+{{#each crossCuttingConcerns}}
+- {{this}}
+{{/each}}
+
+## 技术栈
+
+| 类别 | 技术 | 版本 | 用途 |
+|------|------|------|------|
+{{#each technologyStack}}
+| {{category}} | {{name}} | {{#if version}}{{version}}{{else}}-{{/if}} | {{purpose}} |
+{{/each}}

package/templates/interface-surface.hbs

@@ -0,0 +1,87 @@
+---
+type: interface-surface
+generatedBy: interface-surface
+generatedAt: {{generatedAt}}
+---
+# Interface Surface: {{projectName}}
+
+> 自动生成于 {{generatedAt}}
+
+## 1. 摘要
+
+- 模块数: `{{totalModules}}`
+- 入口模块数: `{{entryModules.length}}`
+- 公开符号数: `{{totalSymbols}}`
+- 关键方法数: `{{totalMethods}}`
+
+{{#each summary}}
+- {{this}}
+{{/each}}
+
+{{#if warnings.length}}
+## 2. Warnings
+
+{{#each warnings}}
+- {{this}}
+{{/each}}
+{{/if}}
+
+{{#if entryModules.length}}
+## 3. 入口模块
+
+{{#each entryModules}}
+### `{{sourceTarget}}`
+
+- 角色: `{{role}}`
+- 置信度: `{{confidence}}`
+- 摘要: {{summary}}
+{{#if relatedFiles.length}}
+- 关联文件:
+{{#each relatedFiles}}
+  - `{{this}}`
+{{/each}}
+{{/if}}
+{{/each}}
+{{/if}}
+
+## 4. 模块接口清单
+
+{{#each modules}}
+### `{{sourceTarget}}`
+
+- 角色: `{{role}}`
+- 置信度: `{{confidence}}`
+- 摘要: {{summary}}
+{{#if exportedSymbols.length}}
+- 公开符号:
+{{#each exportedSymbols}}
+  - `{{name}}` [`{{kind}}`]{{#if signature}} -> `{{signature}}`{{/if}}{{#if note}}: {{note}}{{/if}}
+{{/each}}
+{{/if}}
+{{#if publicMethods.length}}
+- 关键方法:
+{{#each publicMethods}}
+  - `{{name}}`{{#if ownerName}} (owner=`{{ownerName}}`){{/if}} [`{{kind}}`]{{#if signature}} -> `{{signature}}`{{/if}}{{#if note}}: {{note}}{{/if}}
+{{/each}}
+{{/if}}
+{{/each}}
+
+## 5. 关键公开符号
+
+{{#if keySymbols.length}}
+{{#each keySymbols}}
+- `{{name}}` [`{{kind}}`] in `{{moduleName}}`{{#if signature}} -> `{{signature}}`{{/if}}{{#if note}}: {{note}}{{/if}}
+{{/each}}
+{{else}}
+未识别出高置信公开符号。
+{{/if}}
+
+## 6. 关键方法 / 函数
+
+{{#if keyMethods.length}}
+{{#each keyMethods}}
+- `{{name}}`{{#if ownerName}} (owner=`{{ownerName}}`){{/if}} in `{{moduleName}}` [`{{kind}}`]{{#if signature}} -> `{{signature}}`{{/if}}{{#if note}}: {{note}}{{/if}}
+{{/each}}
+{{else}}
+未识别出高置信关键方法。
+{{/if}}

package/templates/module-spec.hbs

@@ -0,0 +1,117 @@
+---
+type: {{frontmatter.type}}
+version: {{frontmatter.version}}
+generatedBy: {{frontmatter.generatedBy}}
+sourceTarget: {{frontmatter.sourceTarget}}
+relatedFiles:
+{{#each frontmatter.relatedFiles}}
+  - {{this}}
+{{/each}}
+lastUpdated: {{frontmatter.lastUpdated}}
+confidence: {{frontmatter.confidence}}
+skeletonHash: {{frontmatter.skeletonHash}}
+{{#if frontmatter.language}}language: {{frontmatter.language}}
+{{/if}}{{#if frontmatter.crossLanguageRefs}}crossLanguageRefs:
+{{#each frontmatter.crossLanguageRefs}}
+  - {{this}}
+{{/each}}
+{{/if}}{{#if frontmatter.tokenUsage}}tokenUsage:
+  input: {{frontmatter.tokenUsage.input}}
+  output: {{frontmatter.tokenUsage.output}}
+durationMs: {{frontmatter.durationMs}}
+llmModel: "{{frontmatter.llmModel}}"
+fallbackReason: {{#if frontmatter.fallbackReason}}"{{frontmatter.fallbackReason}}"{{else}}null{{/if}}
+{{/if}}{{#if frontmatter.generatedByMode}}generatedByMode: {{frontmatter.generatedByMode}}
+{{/if}}---
+
+<a id="module-spec"></a>
+
+# {{#if frontmatter.displayName}}{{frontmatter.displayName}}{{else}}{{frontmatter.sourceTarget}}{{/if}}
+
+{{#if crossReferenceIndex}}
+<!-- cross-reference-index: auto generatedAt={{crossReferenceIndex.generatedAt}} same={{crossReferenceIndex.sameModule.length}} cross={{crossReferenceIndex.crossModule.length}} -->
+
+## 相关 Spec
+
+{{#if (hasContent crossReferenceIndex.sameModule)}}
+### 同模块关联
+
+{{#each crossReferenceIndex.sameModule}}
+- [{{label}}]({{href}}) - {{summary}}
+{{/each}}
+
+{{/if}}
+{{#if (hasContent crossReferenceIndex.crossModule)}}
+### 跨模块关联
+
+{{#each crossReferenceIndex.crossModule}}
+- [{{label}}]({{href}}) - {{summary}}
+{{/each}}
+
+{{/if}}
+{{#unless (hasContent crossReferenceIndex.sameModule)}}
+{{#unless (hasContent crossReferenceIndex.crossModule)}}
+当前模块暂无可自动归档的相关 Spec 链接。
+
+{{/unless}}
+{{/unless}}
+{{/if}}
+
+## 1. 意图
+
+{{{sections.intent}}}
+
+## 2. 业务逻辑
+
+{{{sections.businessLogic}}}
+
+## 3. 接口定义
+
+{{{sections.interfaceDefinition}}}
+
+{{#if mermaidDiagrams}}
+{{#each mermaidDiagrams}}
+{{#if title}}
+### {{title}}
+
+{{/if}}
+```mermaid
+{{{source}}}
+```
+
+{{/each}}
+{{/if}}
+
+## 4. 数据结构
+
+{{{sections.dataStructures}}}
+
+## 5. 约束条件
+
+{{{sections.constraints}}}
+
+## 6. 边界条件
+
+{{{sections.edgeCases}}}
+
+## 7. 技术债务
+
+{{{sections.technicalDebt}}}
+
+## 8. 测试覆盖
+
+{{{sections.testCoverage}}}
+
+## 9. 依赖关系
+
+{{{sections.dependencies}}}
+
+---
+
+## 附录：文件清单
+
+| 文件 | 行数 | 主要用途 |
+|------|------|----------|
+{{#each fileInventory}}
+| `{{shortPath}}` | {{loc}} | {{purpose}} |
+{{/each}}

package/templates/pattern-hints.hbs

@@ -0,0 +1,85 @@
+## 架构模式提示
+
+> 基于 045 的共享架构概览模型自动生成
+
+| 指标 | 值 |
+|------|------|
+| 评估模式数 | {{model.stats.totalPatternsEvaluated}} |
+| 命中模式数 | {{model.stats.matchedPatterns}} |
+| 高置信度模式数 | {{model.stats.highConfidencePatterns}} |
+| Warnings 数 | {{model.stats.warningCount}} |
+
+{{#if warnings.length}}
+### Warnings
+
+{{#each warnings}}
+- {{this}}
+{{/each}}
+{{/if}}
+
+{{#if model.noHighConfidenceMatch}}
+### 结果摘要
+
+> [!NOTE] 未识别到高置信度模式
+>
+> 当前规则没有发现超过阈值的架构模式，以下候选模式可作为人工复核参考。
+
+{{#if model.alternatives.length}}
+| 候选模式 | 原因 | 阈值差距 |
+|----------|------|----------|
+{{#each model.alternatives}}
+| `{{patternName}}` | {{reason}} | {{#if confidenceGap}}{{confidenceGap}}{{else}}--{{/if}} |
+{{/each}}
+{{/if}}
+{{else}}
+### 已识别模式
+
+{{#each model.matchedPatterns}}
+#### {{patternName}}（{{matchLevel}} / confidence={{confidence}}）
+
+{{summary}}
+
+{{explanation}}
+
+**命中信号**
+
+{{#if matchedSignals.length}}
+{{#each matchedSignals}}
+- {{this}}
+{{/each}}
+{{else}}
+- -- 
+{{/if}}
+
+**缺失信号**
+
+{{#if missingSignals.length}}
+{{#each missingSignals}}
+- {{this}}
+{{/each}}
+{{else}}
+- 无
+{{/if}}
+
+**证据链**
+
+{{#if evidence.length}}
+{{#each evidence}}
+- `{{source}}` → `{{ref}}`{{#if sectionKind}}（{{sectionKind}}）{{/if}}{{#if note}}: {{note}}{{/if}}{{#if inferred}} `[推断]`{{/if}}
+{{/each}}
+{{else}}
+- 无
+{{/if}}
+
+**候选替代模式**
+
+{{#if competingAlternatives.length}}
+{{#each competingAlternatives}}
+- `{{patternName}}`: {{reason}}{{#if confidenceGap}}（差距 {{confidenceGap}}）{{/if}}
+{{/each}}
+{{else}}
+- 无
+{{/if}}
+
+{{/each}}
+{{/if}}

package/templates/product-overview.hbs

@@ -0,0 +1,65 @@
+# {{title}}
+
+> 生成时间: `{{generatedAt}}`
+> 置信度: `{{confidence}}`
+{{#if inferred}}> 说明: `仅基于代码与现有规格推断`
+{{/if}}
+
+{{#if warnings.length}}
+## 注意事项
+{{#each warnings}}
+- {{this}}
+{{/each}}
+{{/if}}
+
+## 1. 产品定位
+
+{{#each summary}}
+{{this}}
+
+{{/each}}
+
+## 2. 目标用户
+
+{{#if targetUsers.length}}
+{{#each targetUsers}}
+### {{name}}
+
+- 描述: {{description}}
+- 主要场景: {{#if primaryScenarios.length}}{{primaryScenarios.[0]}}{{#if primaryScenarios.[1]}}；{{primaryScenarios.[1]}}{{/if}}{{#if primaryScenarios.[2]}}；{{primaryScenarios.[2]}}{{/if}}{{else}}未明确{{/if}}
+- 置信度: `{{confidence}}`
+{{/each}}
+{{else}}
+未识别到稳定的目标用户画像。
+{{/if}}
+
+## 3. 核心场景
+
+{{#if coreScenarios.length}}
+{{#each coreScenarios}}
+### {{title}}
+
+- 摘要: {{summary}}
+- 参与者: {{#if actors.length}}{{actors.[0]}}{{#if actors.[1]}}、{{actors.[1]}}{{/if}}{{#if actors.[2]}}、{{actors.[2]}}{{/if}}{{else}}未明确{{/if}}
+- 置信度: `{{confidence}}`
+- 是否推断: `{{#if inferred}}是{{else}}否{{/if}}`
+{{/each}}
+{{else}}
+未识别到稳定的核心场景列表。
+{{/if}}
+
+## 4. 关键任务流
+
+{{#if keyTaskFlows.length}}
+{{#each keyTaskFlows}}
+1. {{this}}
+{{/each}}
+{{else}}
+未识别到稳定的关键任务流。
+{{/if}}
+
+## 5. 事实来源
+
+{{#each evidence}}
+- `{{sourceType}}` {{label}}{{#if path}} — `{{path}}`{{/if}}: {{excerpt}}
+{{/each}}