spectra-cli 4.1.1

package/templates/quality-report.hbs

@@ -0,0 +1,130 @@
+---
+type: quality-report
+generatedBy: docs-quality-evaluator
+generatedAt: {{generatedAt}}
+status: {{status}}
+score: {{stats.score}}
+bundleCoverage: {{bundleCoverage}}
+---
+
+# {{title}}
+
+> 自动生成于 {{generatedAt}}
+
+## 摘要
+
+| 指标 | 值 |
+|------|------|
+| 总体状态 | `{{status}}` |
+| 质量分数 | `{{stats.score}}` |
+| Provenance 文档数 | `{{stats.availableProvenanceDocs}} / {{stats.totalProvenanceDocs}}` |
+| 高覆盖文档数 | `{{stats.highCoverageDocs}}` |
+| 冲突数 | `{{stats.totalConflicts}}` |
+| 高严重冲突数 | `{{stats.highSeverityConflicts}}` |
+| Required docs 覆盖数 | `{{stats.coveredRequiredDocs}} / {{stats.totalRequiredDocs}}` |
+| Required docs 缺失数 | `{{stats.missingRequiredDocs}}` |
+| Dependency warnings | `{{stats.dependencyWarningCount}}` |
+| General warnings | `{{stats.warningCount}}` |
+
+{{#if summary.length}}
+### 结果摘要
+
+{{#each summary}}
+- {{this}}
+{{/each}}
+{{/if}}
+
+{{#if dependencyWarnings.length}}
+## Dependency Warnings
+
+{{#each dependencyWarnings}}
+- {{this}}
+{{/each}}
+{{/if}}
+
+{{#if warnings.length}}
+## General Warnings
+
+{{#each warnings}}
+- {{this}}
+{{/each}}
+{{/if}}
+
+## Provenance Coverage
+
+{{#each provenance}}
+### {{title}}
+
+- Document ID: `{{documentId}}`
+- Available: `{{available}}`
+- Coverage: `{{coverage}}`
+- Confidence: `{{confidence}}`
+- Sections: `{{sectionCount}}`
+- Entries: `{{entryCount}}`
+{{#if sourcePath}}
+- Source Path: `{{sourcePath}}`
+{{/if}}
+{{#if missingReason}}
+- Missing Reason: {{missingReason}}
+{{/if}}
+
+{{#if sourceTypes.length}}
+**Source Types**
+
+{{#each sourceTypes}}
+- `{{this}}`
+{{/each}}
+{{/if}}
+
+{{#if warnings.length}}
+**Warnings**
+
+{{#each warnings}}
+- {{this}}
+{{/each}}
+{{/if}}
+
+{{#if sections.length}}
+**Sections**
+
+{{#each sections}}
+- `{{id}}` / {{title}} / coverage=`{{coverage}}`
+  {{#if summary}}{{summary}}{{/if}}
+  {{#if entries.length}}
+  {{#each entries}}
+  - `{{sourceType}}` → `{{ref}}`{{#if originType}} (`{{originType}}`){{/if}}{{#if path}} @ `{{path}}`{{/if}}{{#if note}}: {{note}}{{/if}}{{#if inferred}} `[inferred]`{{/if}}
+  {{/each}}
+  {{else}}
+  - 无 provenance entry
+  {{/if}}
+{{/each}}
+{{/if}}
+{{/each}}
+
+## Conflict Records
+
+{{#if conflicts.length}}
+{{#each conflicts}}
+### {{topic}} / severity=`{{severity}}`
+
+{{summary}}
+
+{{#each sources}}
+- `{{sourceType}}` / {{label}} / `{{canonicalValue}}`{{#if path}} @ `{{path}}`{{/if}}{{#if excerpt}}: {{excerpt}}{{/if}}
+{{/each}}
+{{/each}}
+{{else}}
+- 未检测到显式 conflict record。
+{{/if}}
+
+## Required Docs
+
+| Doc | Coverage | Present | Required By | Included Bundles | Notes |
+|-----|----------|---------|-------------|------------------|-------|
+{{#if requiredDocs.length}}
+{{#each requiredDocs}}
+| `{{docId}}` | `{{coverage}}` | `{{present}}` | {{#if requiredBy.length}}{{#each requiredBy}}`{{this}}`{{#unless @last}}, {{/unless}}{{/each}}{{else}}--{{/if}} | {{#if includedInBundles.length}}{{#each includedInBundles}}`{{this}}`{{#unless @last}}, {{/unless}}{{/each}}{{else}}--{{/if}} | {{#if notes.length}}{{#each notes}}{{this}}{{#unless @last}} / {{/unless}}{{/each}}{{else}}--{{/if}} |
+{{/each}}
+{{else}}
+| -- | -- | -- | -- | -- | -- |
+{{/if}}

package/templates/runtime-topology.hbs

@@ -0,0 +1,128 @@
+---
+type: runtime-topology
+generatedBy: runtime-topology
+generatedAt: {{generatedAt}}
+totalServices: {{stats.totalServices}}
+totalImages: {{stats.totalImages}}
+totalContainers: {{stats.totalContainers}}
+totalStages: {{stats.totalStages}}
+---
+
+# {{title}}
+
+> 自动生成于 {{generatedAt}}
+
+## 摘要
+
+| 指标 | 值 |
+|------|------|
+| 服务数 | {{stats.totalServices}} |
+| 镜像数 | {{stats.totalImages}} |
+| 容器数 | {{stats.totalContainers}} |
+| 构建阶段数 | {{stats.totalStages}} |
+| 依赖关系数 | {{stats.totalDependencies}} |
+| 运行时配置提示数 | {{stats.totalConfigHints}} |
+
+## 服务
+
+| 服务 | 容器 | 镜像 | 构建上下文 | Dockerfile | Target Stage | 启动命令 | 依赖 |
+|------|------|------|------------|------------|--------------|----------|------|
+{{#each topology.services}}
+| {{name}} | `{{containerName}}` | {{#if image}}`{{image}}`{{else}}--{{/if}} | {{#if buildContext}}`{{buildContext}}`{{else}}--{{/if}} | {{#if dockerfilePath}}`{{dockerfilePath}}`{{else}}--{{/if}} | {{#if targetStage}}`{{targetStage}}`{{else}}--{{/if}} | {{#if command}}`{{command}}`{{else}}--{{/if}} | {{#if dependsOn.length}}{{#each dependsOn}}`{{service}}`{{#unless @last}}, {{/unless}}{{/each}}{{else}}--{{/if}} |
+{{/each}}
+
+{{#each topology.services}}
+### 服务: {{name}}
+
+- 来源文件: `{{sourceFile}}`
+- 容器实例: `{{containerName}}`
+- 入口命令: {{#if entrypoint}}`{{entrypoint}}`{{else}}--{{/if}}
+- `env_file`: {{#if envFiles.length}}{{#each envFiles}}`{{this}}`{{#unless @last}}, {{/unless}}{{/each}}{{else}}--{{/if}}
+
+#### 环境变量
+
+| 变量 | 值 | 来源 |
+|------|----|------|
+{{#if environment.length}}
+{{#each environment}}
+| `{{name}}` | {{#if value}}`{{value}}`{{else}}--{{/if}} | `{{sourceFile}}` |
+{{/each}}
+{{else}}
+| -- | -- | -- |
+{{/if}}
+
+#### 端口映射
+
+| Published | Target | 协议 | 原始声明 |
+|-----------|--------|------|----------|
+{{#if ports.length}}
+{{#each ports}}
+| {{#if published}}`{{published}}`{{else}}--{{/if}} | `{{target}}` | `{{protocol}}` | `{{raw}}` |
+{{/each}}
+{{else}}
+| -- | -- | -- | -- |
+{{/if}}
+
+#### 卷挂载
+
+| Source | Target | 类型 | 只读 | 原始声明 |
+|--------|--------|------|------|----------|
+{{#if volumes.length}}
+{{#each volumes}}
+| {{#if source}}`{{source}}`{{else}}--{{/if}} | `{{target}}` | `{{type}}` | {{#if readOnly}}yes{{else}}no{{/if}} | `{{raw}}` |
+{{/each}}
+{{else}}
+| -- | -- | -- | -- | -- |
+{{/if}}
+
+{{/each}}
+
+## 容器实例
+
+| 容器 | 服务 | 镜像 | 启动命令 | 依赖服务 |
+|------|------|------|----------|----------|
+{{#each topology.containers}}
+| `{{name}}` | `{{service}}` | {{#if image}}`{{image}}`{{else}}--{{/if}} | {{#if command}}`{{command}}`{{else}}--{{/if}} | {{#if dependsOn.length}}{{#each dependsOn}}`{{this}}`{{#unless @last}}, {{/unless}}{{/each}}{{else}}--{{/if}} |
+{{/each}}
+
+## 镜像与构建阶段
+
+| 镜像 | 显式镜像名 | 构建上下文 | Dockerfile | Target Stage | Stages |
+|------|------------|------------|------------|--------------|--------|
+{{#each topology.images}}
+| `{{name}}` | {{#if explicitImage}}`{{explicitImage}}`{{else}}--{{/if}} | {{#if buildContext}}`{{buildContext}}`{{else}}--{{/if}} | {{#if dockerfilePath}}`{{dockerfilePath}}`{{else}}--{{/if}} | {{#if targetStage}}`{{targetStage}}`{{else}}--{{/if}} | {{#if stageNames.length}}{{#each stageNames}}`{{this}}`{{#unless @last}}, {{/unless}}{{/each}}{{else}}--{{/if}} |
+{{/each}}
+
+### Docker Build Stages
+
+| Stage | 角色 | 基础镜像 | 来源 Dockerfile | WORKDIR | CMD | ENTRYPOINT | 复制来源 |
+|-------|------|----------|-----------------|---------|-----|------------|----------|
+{{#each topology.stages}}
+| `{{name}}` | `{{role}}` | `{{baseImage}}` | `{{sourceFile}}` | {{#if workdir}}`{{workdir}}`{{else}}--{{/if}} | {{#if command}}`{{command}}`{{else}}--{{/if}} | {{#if entrypoint}}`{{entrypoint}}`{{else}}--{{/if}} | {{#if copiesFrom.length}}{{#each copiesFrom}}`{{this}}`{{#unless @last}}, {{/unless}}{{/each}}{{else}}--{{/if}} |
+{{/each}}
+
+## 运行时配置提示
+
+| 来源 | 格式 | 类别 | Key | Value |
+|------|------|------|-----|-------|
+{{#if topology.configHints.length}}
+{{#each topology.configHints}}
+| `{{sourceFile}}` | `{{format}}` | `{{category}}` | `{{keyPath}}` | {{#if value}}`{{value}}`{{else}}--{{/if}} |
+{{/each}}
+{{else}}
+| -- | -- | -- | -- | -- |
+{{/if}}
+
+## Source Files
+
+{{#each topology.sourceFiles}}
+- `{{this}}`
+{{/each}}
+
+{{#if warnings.length}}
+## Warnings
+
+{{#each warnings}}
+- {{this}}
+{{/each}}
+{{/if}}

package/templates/troubleshooting.hbs

@@ -0,0 +1,86 @@
+---
+type: troubleshooting
+generatedAt: {{generatedAt}}
+projectName: {{projectName}}
+totalEntries: {{totalEntries}}
+---
+
+# 故障排查 / 原理说明: {{projectName}}
+
+## 总览
+
+- Troubleshooting entries: `{{totalEntries}}`
+- Explanation notes: `{{explanations.length}}`
+
+{{#if warnings.length}}
+## Warning
+
+{{#each warnings}}
+- {{this}}
+{{/each}}
+{{/if}}
+
+## Troubleshooting Inventory
+
+| Title | Kind | Confidence | Config Keys | Locations |
+| --- | --- | --- | --- | --- |
+{{#each entries}}
+| {{title}} | `{{kind}}` | `{{confidence}}` | {{#if configKeys.length}}`{{configKeys}}`{{else}}-{{/if}} | {{relatedLocations.length}} |
+{{/each}}
+
+{{#each entries}}
+## {{title}}
+
+- Kind: `{{kind}}`
+- Confidence: `{{confidence}}`
+
+**Symptom**
+
+{{symptom}}
+
+**Possible causes**
+{{#each possibleCauses}}
+- {{this}}
+{{/each}}
+
+**Recovery steps**
+{{#each recoverySteps}}
+- {{this}}
+{{/each}}
+
+**Related locations**
+{{#each relatedLocations}}
+- `{{sourceFile}}:{{line}}` (`{{symbolName}}`){{#if excerpt}}: `{{excerpt}}`{{/if}}
+{{/each}}
+
+{{#if configKeys.length}}
+**Config keys**
+{{#each configKeys}}
+- `{{this}}`
+{{/each}}
+{{/if}}
+
+**Evidence**
+{{#each evidence}}
+- `{{this}}`
+{{/each}}
+
+{{/each}}
+
+{{#if explanations.length}}
+## Explanation
+
+{{#each explanations}}
+### {{title}}
+
+{{summary}}
+
+{{#if evidence.length}}
+Evidence:
+{{#each evidence}}
+- {{this}}
+{{/each}}
+{{/if}}
+
+{{/each}}
+{{/if}}

package/templates/user-journeys.hbs

@@ -0,0 +1,44 @@
+# {{title}}
+
+> 生成时间: `{{generatedAt}}`
+> 置信度: `{{confidence}}`
+
+{{#if warnings.length}}
+## 注意事项
+{{#each warnings}}
+- {{this}}
+{{/each}}
+{{/if}}
+
+## 1. 总览
+
+{{#each summary}}
+- {{this}}
+{{/each}}
+
+## 2. 用户旅程
+
+{{#if journeys.length}}
+{{#each journeys}}
+### {{title}}
+
+- 角色: {{actor}}
+- 目标: {{goal}}
+- 结果: {{outcome}}
+- 置信度: `{{confidence}}`
+- 是否推断: `{{#if inferred}}是{{else}}否{{/if}}`
+
+#### 关键步骤
+{{#each steps}}
+1. **{{title}}**: {{detail}}{{#if inferred}} `（推断）`{{/if}}
+{{/each}}
+
+#### 证据
+{{#each evidence}}
+- `{{sourceType}}` {{label}}{{#if path}} — `{{path}}`{{/if}}: {{excerpt}}
+{{/each}}
+
+{{/each}}
+{{else}}
+未生成稳定的用户旅程。
+{{/if}}

package/templates/workspace-index.hbs

@@ -0,0 +1,26 @@
+---
+type: workspace-index
+generatedBy: workspace-index-generator
+generatedAt: {{generatedAt}}
+totalPackages: {{totalPackages}}
+---
+
+# {{title}}
+
+> 自动生成于 {{generatedAt}} | 共 {{totalPackages}} 个子包
+
+{{#each groups}}
+## {{name}}
+
+| 名称 | 路径 | 描述 | 语言 |
+|------|------|------|------|
+{{#each packages}}
+| {{name}} | `{{path}}` | {{#if description}}{{description}}{{else}}--{{/if}} | {{language}} |
+{{/each}}
+
+{{/each}}
+## 包级依赖关系图
+
+```mermaid
+{{{dependencyDiagram}}}
+```