spectra-cli 4.1.1

package/templates/api-surface.hbs

@@ -0,0 +1,40 @@
+---
+type: api-surface-reference
+generatedBy: api-surface
+generatedAt: {{generatedAt}}
+source: {{source}}
+---
+# API Surface Reference: {{projectName}}
+
+> 自动生成于 {{generatedAt}} | source: `{{source}}`
+
+## 摘要
+
+- 端点总数: **{{totalEndpoints}}**
+- 参数总数: **{{totalParameters}}**
+- 来源文件数: **{{sourceFiles.length}}**
+{{#if tags.length}}
+- 标签: {{#each tags}}`{{this}}`{{#unless @last}}, {{/unless}}{{/each}}
+{{/if}}
+
+{{#if sourceFiles.length}}
+## 来源文件
+
+{{#each sourceFiles}}
+- `{{this}}`
+{{/each}}
+{{/if}}
+
+{{#if endpoints.length}}
+## Endpoints
+
+| Method | Path | Parameters | Response | Auth | Tags | Source |
+| --- | --- | --- | --- | --- | --- | --- |
+{{#each endpoints}}
+| `{{method}}` | `{{path}}` | {{#if parameters.length}}{{#each parameters}}`{{in}}:{{name}}:{{type}}{{#if required}}*{{/if}}`{{#unless @last}}<br>{{/unless}}{{/each}}{{else}}-{{/if}} | {{responseType}} | {{#if auth.length}}{{#each auth}}`{{this}}`{{#unless @last}}, {{/unless}}{{/each}}{{else}}-{{/if}} | {{#if tags.length}}{{#each tags}}`{{this}}`{{#unless @last}}, {{/unless}}{{/each}}{{else}}-{{/if}} | `{{source}}` |
+{{/each}}
+{{else}}
+## Endpoints
+
+未发现可静态提取的 API 端点。
+{{/if}}

package/templates/architecture-ir.hbs

@@ -0,0 +1,49 @@
+# {{title}}
+
+> Generated: {{generatedAt}}
+
+## 概览
+
+- 项目：`{{ir.projectName}}`
+- 来源数：`{{ir.stats.sourceCount}}`
+- 元素数：`{{ir.stats.totalElements}}`
+- 关系数：`{{ir.stats.totalRelationships}}`
+- 可用视图：`{{ir.stats.availableViews}} / {{ir.stats.totalViews}}`
+
+## 视图状态
+
+| 视图 | 可用 | 元素 | 关系 | Mermaid Section |
+|------|------|------|------|-----------------|
+{{#each ir.views}}
+| {{title}} | {{#if available}}Yes{{else}}No{{/if}} | {{elementIds.length}} | {{relationshipIds.length}} | `{{mermaidSection}}` |
+{{/each}}
+
+## 元素清单
+
+| ID | 名称 | Kind | Technology | Sources |
+|----|------|------|------------|---------|
+{{#each ir.elements}}
+| `{{id}}` | `{{name}}` | `{{kind}}` | {{#if technology}}`{{technology}}`{{else}}-{{/if}} | {{#each sourceTags}}`{{this}}` {{/each}} |
+{{/each}}
+
+## Structurizr DSL
+
+```text
+{{exports.structurizrDsl}}
+```
+
+{{#if exports.mermaid.combinedDiagram}}
+## Mermaid 互通输出
+
+```mermaid
+{{exports.mermaid.combinedDiagram}}
+```
+{{/if}}
+
+{{#if warnings.length}}
+## Warnings
+
+{{#each warnings}}
+- {{this}}
+{{/each}}
+{{/if}}

package/templates/architecture-narrative.hbs

@@ -0,0 +1,116 @@
+---
+type: architecture-narrative
+generatedBy: architecture-narrative
+generatedAt: {{generatedAt}}
+projectName: {{projectName}}
+keyModuleCount: {{keyModules.length}}
+keySymbolCount: {{keySymbols.length}}
+keyMethodCount: {{keyMethods.length}}
+---
+
+# {{title}}
+
+> 自动生成于 {{generatedAt}}
+{{#if readmeExcerpt}}
+
+## 0. README 摘录（Feature 140 FR-010）
+
+> 摘录自项目 `README.md`，前 1000 字符。完整 README 在 LLM 阶段（Phase 3b MapReduce）作为 shared header 注入 narrative pipeline。
+
+```
+{{readmeExcerpt}}
+```
+{{/if}}
+
+## 1. 先说结论
+
+{{#each executiveSummary}}
+- {{this}}
+{{/each}}
+
+## 2. 仓库结构总览
+
+| 目录/域 | 类型 | 模块数 | 文件数 | 说明 |
+|------|------|------:|------:|------|
+{{#if repositoryMap.length}}
+{{#each repositoryMap}}
+| `{{path}}` | {{category}} | {{moduleCount}} | {{fileCount}} | {{summary}} |
+{{/each}}
+{{else}}
+| -- | -- | 0 | 0 | 当前未提取到可归档的模块结构 |
+{{/if}}
+
+## 3. 关键模块
+
+{{#if keyModules.length}}
+{{#each keyModules}}
+### `{{sourceTarget}}`
+
+- **职责**: {{intentSummary}}
+- **实现重点**: {{businessSummary}}
+- **依赖线索**: {{dependencySummary}}
+- **置信度**: `{{confidence}}`{{#if inferred}} / [推断]{{/if}}
+- **相关文件**: {{#if relatedFiles.length}}{{#each relatedFiles}}`{{this}}`{{#unless @last}}, {{/unless}}{{/each}}{{else}}--{{/if}}
+
+{{#if keySymbols.length}}
+关键类 / 类型:
+{{#each keySymbols}}
+- `{{name}}` ({{kind}}) — {{note}}
+{{/each}}
+{{/if}}
+
+{{#if keyMethods.length}}
+关键方法 / 函数:
+{{#each keyMethods}}
+- {{#if ownerName}}`{{ownerName}}.{{name}}`{{else}}`{{name}}`{{/if}} — {{note}}
+{{/each}}
+{{/if}}
+
+{{/each}}
+{{else}}
+当前批次未提取到可用于叙事的关键模块。
+{{/if}}
+
+## 4. 关键类 / 类型
+
+| 名称 | 所属模块 | 类型 | 签名 | 说明 |
+|------|----------|------|------|------|
+{{#if keySymbols.length}}
+{{#each keySymbols}}
+| `{{name}}` | `{{moduleName}}` | `{{kind}}` | `{{signature}}` | {{note}} |
+{{/each}}
+{{else}}
+| -- | -- | -- | -- | 当前未提取到代表性类型/类 |
+{{/if}}
+
+## 5. 关键方法 / 函数
+
+| 名称 | 所属模块 | 宿主 | 类型 | 签名 | 说明 |
+|------|----------|------|------|------|------|
+{{#if keyMethods.length}}
+{{#each keyMethods}}
+| `{{name}}` | `{{moduleName}}` | {{#if ownerName}}`{{ownerName}}`{{else}}模块级{{/if}} | `{{kind}}` | `{{signature}}` | {{note}} |
+{{/each}}
+{{else}}
+| -- | -- | -- | -- | -- | 当前未提取到代表性方法/函数 |
+{{/if}}
+
+## 6. 相关结构化文档
+
+{{#if supportingDocs.length}}
+{{#each supportingDocs}}
+- [{{title}}]({{path}})
+{{/each}}
+{{else}}
+- 当前批次没有额外的项目级结构化文档可交叉阅读。
+{{/if}}
+
+## 7. 架构观察
+
+{{#if observations.length}}
+{{#each observations}}
+- {{this}}
+{{/each}}
+{{else}}
+- 当前没有额外架构观察。
+{{/if}}

package/templates/architecture-overview.hbs

@@ -0,0 +1,103 @@
+---
+type: architecture-overview
+generatedBy: architecture-overview
+generatedAt: {{generatedAt}}
+availableSections: {{model.stats.availableSections}}
+totalWarnings: {{model.stats.totalWarnings}}
+---
+
+# {{title}}
+
+> 自动生成于 {{generatedAt}}
+
+## 摘要
+
+| 指标 | 值 |
+|------|------|
+| 总视图版块数 | {{model.stats.totalSections}} |
+| 可用版块数 | {{model.stats.availableSections}} |
+| 节点总数 | {{model.stats.totalNodes}} |
+| 关系边总数 | {{model.stats.totalEdges}} |
+| 模块职责条目数 | {{model.stats.totalModules}} |
+| 部署单元数 | {{model.stats.totalDeploymentUnits}} |
+| Warnings 数 | {{model.stats.totalWarnings}} |
+
+{{#if warnings.length}}
+## Warnings
+
+{{#each warnings}}
+- {{this}}
+{{/each}}
+{{/if}}
+
+## 系统上下文视图
+
+{{#if systemContext.available}}
+{{#if systemContext.description}}
+{{systemContext.description}}
+{{/if}}
+
+```mermaid
+{{{systemContext.mermaidDiagram}}}
+```
+{{else}}
+> [!NOTE] 当前版块不可用
+>
+> {{systemContext.missingReason}}
+{{/if}}
+
+## 部署视图
+
+{{#if deploymentView.available}}
+{{#if deploymentView.description}}
+{{deploymentView.description}}
+{{/if}}
+
+```mermaid
+{{{deploymentView.mermaidDiagram}}}
+```
+{{else}}
+> [!NOTE] 当前版块不可用
+>
+> {{deploymentView.missingReason}}
+{{/if}}
+
+## 分层视图
+
+{{#if layeredView.available}}
+{{#if layeredView.description}}
+{{layeredView.description}}
+{{/if}}
+
+```mermaid
+{{{layeredView.mermaidDiagram}}}
+```
+{{else}}
+> [!NOTE] 当前版块不可用
+>
+> {{layeredView.missingReason}}
+{{/if}}
+
+## 部署单元摘要
+
+| 服务 | 容器 | 镜像 | Target Stage | 依赖 | 端口 | 卷 |
+|------|------|------|--------------|------|------|----|
+{{#if model.deploymentUnits.length}}
+{{#each model.deploymentUnits}}
+| `{{serviceName}}` | {{#if containerName}}`{{containerName}}`{{else}}--{{/if}} | {{#if imageName}}`{{imageName}}`{{else}}--{{/if}} | {{#if targetStage}}`{{targetStage}}`{{else}}--{{/if}} | {{#if dependsOn.length}}{{#each dependsOn}}`{{this}}`{{#unless @last}}, {{/unless}}{{/each}}{{else}}--{{/if}} | {{#if ports.length}}{{#each ports}}`{{this}}`{{#unless @last}}, {{/unless}}{{/each}}{{else}}--{{/if}} | {{#if volumes.length}}{{#each volumes}}`{{this}}`{{#unless @last}}, {{/unless}}{{/each}}{{else}}--{{/if}} |
+{{/each}}
+{{else}}
+| -- | -- | -- | -- | -- | -- | -- |
+{{/if}}
+
+## 模块职责摘要
+
+| 分组 | 包 | 路径 | 语言 | 职责 | 依赖 |
+|------|----|------|------|------|------|
+{{#if model.moduleSummaries.length}}
+{{#each model.moduleSummaries}}
+| `{{groupName}}` | `{{packageName}}` | `{{path}}` | `{{language}}` | {{responsibility}} | {{#if dependencies.length}}{{#each dependencies}}`{{this}}`{{#unless @last}}, {{/unless}}{{/each}}{{else}}--{{/if}} |
+{{/each}}
+{{else}}
+| -- | -- | -- | -- | -- | -- |
+{{/if}}

package/templates/component-view.hbs

@@ -0,0 +1,87 @@
+# 组件视图: {{model.projectName}}
+
+- 生成时间: `{{generatedAt}}`
+- 关键组件数: `{{model.stats.totalComponents}}`
+- 关键关系数: `{{model.stats.totalRelationships}}`
+- 高置信组件数: `{{model.stats.highConfidenceComponents}}`
+
+## 1. 摘要
+
+{{#each model.summary}}
+- {{this}}
+{{/each}}
+
+{{#if warnings.length}}
+## 2. Warnings
+
+{{#each warnings}}
+- {{this}}
+{{/each}}
+{{/if}}
+
+## 3. 组件分组
+
+{{#each model.groups}}
+### {{name}}
+
+- 组件数: `{{componentIds.length}}`
+{{#if summary}}
+- 摘要: {{summary}}
+{{/if}}
+{{/each}}
+
+## 4. 关键组件
+
+{{#each model.components}}
+### {{name}}
+
+- 分类: `{{category}}`
+- 子系统: `{{subsystem}}`
+- 置信度: `{{confidence}}`
+- 推断: `{{inferred}}`
+- 摘要: {{summary}}
+{{#if responsibilities.length}}
+- 职责:
+{{#each responsibilities}}
+  - {{this}}
+{{/each}}
+{{/if}}
+{{#if relatedFiles.length}}
+- 关联文件:
+{{#each relatedFiles}}
+  - `{{this}}`
+{{/each}}
+{{/if}}
+{{#if keyMethods.length}}
+- 关键方法:
+{{#each keyMethods}}
+  - `{{name}}`{{#if ownerName}} (owner=`{{ownerName}}`){{/if}}{{#if signature}} -> `{{signature}}`{{/if}} [`{{kind}}`]
+{{/each}}
+{{/if}}
+{{#if downstreamIds.length}}
+- 下游组件: `{{downstreamIds.length}}`
+{{/if}}
+{{#if upstreamIds.length}}
+- 上游组件: `{{upstreamIds.length}}`
+{{/if}}
+{{#if evidence.length}}
+- Evidence:
+{{#each evidence}}
+  - `{{sourceType}}:{{ref}}`{{#if note}} - {{note}}{{/if}}
+{{/each}}
+{{/if}}
+{{/each}}
+
+## 5. 关键关系
+
+{{#each model.relationships}}
+- `{{fromId}}` -> `{{toId}}` [`{{kind}}`, `{{confidence}}`]: {{label}}
+{{/each}}
+
+{{#if model.mermaidDiagram}}
+## 6. Mermaid
+
+```mermaid
+{{model.mermaidDiagram}}
+```
+{{/if}}

package/templates/config-reference.hbs

@@ -0,0 +1,22 @@
+# 配置参考手册: {{projectName}}
+
+> 自动生成于 {{generatedAt}} | 共 {{totalEntries}} 个配置项
+
+{{#each files}}
+## {{filePath}} (`{{format}}`)
+
+{{#if description}}
+> {{{description}}}
+
+{{/if}}
+{{#if entries.length}}
+| 配置项 | 类型 | 默认值 | 说明 |
+|--------|------|--------|------|
+{{#each entries}}
+| `{{keyPath}}` | {{type}} | {{#if defaultValue}}`{{defaultValue}}`{{else}}_(空)_{{/if}} | {{#if description}}{{description}}{{else}}—{{/if}} |
+{{/each}}
+{{else}}
+_无配置项_
+{{/if}}
+
+{{/each}}

package/templates/coverage-report.hbs

@@ -0,0 +1,84 @@
+# 文档覆盖率审计报告
+
+生成时间: {{generatedAt}}
+
+## 总览
+
+| 指标 | 数值 |
+|------|------|
+| 应文档化模块数 | {{summary.totalModules}} |
+| 已文档化模块数 | {{summary.documentedModules}} |
+| 模块覆盖率 | {{summary.moduleCoveragePct}}% |
+| 缺少文档模块 | {{summary.missingDocCount}} |
+| 缺少交叉引用 | {{summary.missingLinkCount}} |
+| 断链条目 | {{summary.danglingLinkCount}} |
+| 低置信度文档 | {{summary.lowConfidenceCount}} |
+| 适用 generators | {{summary.applicableGenerators}} |
+| 已生成 project docs | {{summary.generatedGeneratorDocs}} |
+
+## Generator Coverage
+
+| Generator | Scope | Expected | Generated | Missing | Coverage |
+|-----------|-------|----------|-----------|---------|----------|
+{{#each generatorCoverage}}
+| `{{generatorId}}` | {{scope}} | {{expectedCount}} | {{generatedCount}} | {{missingCount}} | {{coveragePct}}% |
+{{/each}}
+
+## 模块层级分布
+
+| Level | Total | Documented | Attention | Missing Doc |
+|-------|-------|------------|-----------|-------------|
+{{#each levelCoverage}}
+| {{level}} | {{total}} | {{documented}} | {{attention}} | {{missingDoc}} |
+{{/each}}
+
+## 缺失文档模块
+
+{{#if missingDocModules.length}}
+{{#each missingDocModules}}
+- `{{moduleName}}`
+{{/each}}
+{{else}}
+无。
+{{/if}}
+
+## 需要关注的模块
+
+{{#if attentionModules.length}}
+{{#each attentionModules}}
+- `{{moduleName}}`:
+  状态 `{{status}}`，问题 {{issues}}
+{{/each}}
+{{else}}
+无。
+{{/if}}
+
+## 断链
+
+{{#if danglingLinks.length}}
+{{#each danglingLinks}}
+- `{{specPath}}` -> `{{href}}`（{{reason}}）
+{{/each}}
+{{else}}
+无。
+{{/if}}
+
+## 缺少交叉引用
+
+{{#if missingLinks.length}}
+{{#each missingLinks}}
+- `{{specPath}}`（{{sourceTarget}}）
+{{/each}}
+{{else}}
+无。
+{{/if}}
+
+## 低置信度文档
+
+{{#if lowConfidenceSpecs.length}}
+{{#each lowConfidenceSpecs}}
+- `{{specPath}}`（{{sourceTarget}}）
+{{/each}}
+{{else}}
+无。
+{{/if}}

package/templates/cross-package-analysis.hbs

@@ -0,0 +1,43 @@
+---
+type: cross-package-analysis
+generatedBy: cross-package-deps
+generatedAt: {{generatedAt}}
+---
+# 跨包依赖分析: {{projectName}}
+
+> 自动生成于 {{generatedAt}} | workspace 类型: {{workspaceType}}
+
+## 依赖拓扑图
+
+```mermaid
+{{{mermaidDiagram}}}
+```
+
+## 循环依赖检测
+
+{{#if hasCycles}}
+> [!WARNING] 检测到循环依赖
+
+{{#each cycleGroups}}
+- **循环 {{@index}}**: {{{cyclePath}}}
+{{/each}}
+{{else}}
+未检测到循环依赖。
+{{/if}}
+
+## 拓扑排序 & 层级
+
+| 层级 | 子包 |
+|------|------|
+{{#each levels}}
+| Level {{level}} | {{#each packages}}{{this}}{{#unless @last}}, {{/unless}}{{/each}} |
+{{/each}}
+
+## 统计摘要
+
+| 指标 | 值 |
+|------|------|
+| 子包总数 | {{stats.totalPackages}} |
+| 依赖边总数 | {{stats.totalEdges}} |
+| Root 包（无入度） | {{#each stats.rootPackages}}{{this}}{{#unless @last}}, {{/unless}}{{/each}} |
+| Leaf 包（无出度） | {{#each stats.leafPackages}}{{this}}{{#unless @last}}, {{/unless}}{{/each}} |

package/templates/data-model.hbs

@@ -0,0 +1,72 @@
+# 数据模型文档
+
+## 概览
+
+| 指标 | 值 |
+|------|-----|
+| 模型总数 | {{summary.totalModels}} |
+| 字段总数 | {{summary.totalFields}} |
+{{#each summary.byLanguage}}
+| {{@key}} 模型数 | {{this}} |
+{{/each}}
+{{#each summary.byKind}}
+| {{@key}} 数量 | {{this}} |
+{{/each}}
+
+---
+
+{{#if pythonModels}}
+## Python 数据模型
+
+{{#each pythonModels}}
+### {{name}}
+
+**文件**: `{{filePath}}`
+**类型**: {{kind}}
+{{#if bases.length}}
+**继承**: {{#each bases}}`{{this}}`{{#unless @last}}, {{/unless}}{{/each}}
+{{/if}}
+{{#if description}}
+
+{{{description}}}
+{{/if}}
+
+| 字段名 | 类型 | 可选 | 默认值 | 描述 |
+|--------|------|------|--------|------|
+{{#each fields}}
+| `{{name}}` | `{{typeStr}}` | {{#if optional}}是{{else}}否{{/if}} | {{#if defaultValue}}`{{defaultValue}}`{{else}}—{{/if}} | {{#if description}}{{description}}{{else}}—{{/if}} |
+{{/each}}
+
+{{/each}}
+{{/if}}
+{{#if tsModels}}
+## TypeScript 数据模型
+
+{{#each tsModels}}
+### {{name}}
+
+**文件**: `{{filePath}}`
+**类型**: {{kind}}
+{{#if bases.length}}
+**扩展**: {{#each bases}}`{{this}}`{{#unless @last}}, {{/unless}}{{/each}}
+{{/if}}
+{{#if description}}
+
+{{{description}}}
+{{/if}}
+
+| 属性名 | 类型 | 可选 | 描述 |
+|--------|------|------|------|
+{{#each fields}}
+| `{{name}}` | `{{typeStr}}` | {{#if optional}}是{{else}}否{{/if}} | {{#if description}}{{description}}{{else}}—{{/if}} |
+{{/each}}
+
+{{/each}}
+{{/if}}
+{{#if erDiagram}}
+## 实体关系图
+
+```mermaid
+{{{erDiagram}}}
+```
+{{/if}}

package/templates/delta-report.hbs

@@ -0,0 +1,53 @@
+---
+type: delta-report
+generatedAt: {{generatedAt}}
+mode: {{mode}}
+projectRoot: {{projectRoot}}
+totalTargets: {{totalTargets}}
+---
+
+# Delta Regeneration Report
+
+## Summary
+
+- Mode: `{{mode}}`
+- Total targets: `{{totalTargets}}`
+- Regenerate: `{{regenerateTargets.length}}`
+- Unchanged: `{{unchangedTargets.length}}`
+{{#if fallbackReason}}
+- Fallback reason: `{{fallbackReason}}`
+{{/if}}
+
+## Direct Changes
+
+{{#if directChanges.length}}
+| Source Target | Reason | Previous Hash | Current Hash |
+| --- | --- | --- | --- |
+{{#each directChanges}}
+| `{{sourceTarget}}` | `{{reason}}` | `{{#if previousHash}}{{previousHash}}{{else}}-{{/if}}` | `{{#if currentHash}}{{currentHash}}{{else}}-{{/if}}` |
+{{/each}}
+{{else}}
+No direct changes.
+{{/if}}
+
+## Propagated Changes
+
+{{#if propagatedChanges.length}}
+| Source Target | Impacted By |
+| --- | --- |
+{{#each propagatedChanges}}
+| `{{sourceTarget}}` | {{#if impactedBy.length}}{{#each impactedBy}}`{{this}}`{{#unless @last}}, {{/unless}}{{/each}}{{else}}-{{/if}} |
+{{/each}}
+{{else}}
+No propagated changes.
+{{/if}}
+
+## Unchanged Targets
+
+{{#if unchangedTargets.length}}
+{{#each unchangedTargets}}
+- `{{this}}`
+{{/each}}
+{{else}}
+No unchanged targets.
+{{/if}}

package/templates/docs-bundle-index.hbs

@@ -0,0 +1,41 @@
+---
+type: docs-bundle-index
+profileId: {{profileId}}
+generatedAt: {{generatedAt}}
+---
+
+# {{title}}
+
+> 自动生成于 {{generatedAt}}
+
+{{description}}
+
+## 1. Recommended Reading Path
+
+{{#if readingPath.length}}
+{{#each readingPath}}
+- [{{title}}]({{navPath}}){{#if description}} — {{description}}{{/if}}
+{{/each}}
+{{else}}
+当前 profile 没有可纳入的项目级文档。
+{{/if}}
+
+## 2. Module Specs
+
+{{#if moduleDocs.length}}
+{{#each moduleDocs}}
+- [{{title}}]({{navPath}})
+{{/each}}
+{{else}}
+- 当前 profile 不包含 module spec，或本批次未生成可用 module spec。
+{{/if}}
+
+## 3. Warnings
+
+{{#if warnings.length}}
+{{#each warnings}}
+- {{this}}
+{{/each}}
+{{else}}
+- 无额外 warning。
+{{/if}}