Context Go 结构提取

English

@c4a/extract-go 为 Context 知识项目提供确定性的 Go 结构事实。它提取声明、签名、 源码文档、导入、调用关系和常见 HTTP 路由注册，但不赋予产品专属含义。

这是 Code Indexer Provider 按需使用的可选结构包。Provider 把结构事实映射到 当前 Indexer Result；Candidate 状态、审核、新鲜度、close 和构建继续由 Context 负责。

在知识生产链中的位置

已确认的 Go 仓库边界
          ↓
Go 结构索引
          ↓
选中的 Code Indexer Provider
          ↓
Context 候选 → 审核 → 正式知识

公开 API

import {
  GoPlugin,
  goExtractionToEvidenceAdapterResult,
  indexGoRepository,
  indexGoSource,
} from "@c4a/extract-go";

• GoPlugin 实现标准 @c4a/extract 插件协议；
• GoPlugin 声明 ast-catalog capability，并为每个解析的 Go 文件返回显式 disposition；
• goExtractionToEvidenceAdapterResult() 发布统一的 context.indexer.evidence-adapter-result/v1 线协议结果；
• indexGoSource() 解析一个源码单元，供 Adapter 在生成候选前读取细粒度事实；
• indexGoRepository() 索引仓库树，并通过确定性参数控制 include root、测试文件、 生成文件和排除目录。

输出始终由代码事实支撑。package 命名、业务分类、知识路径、候选摘要和审核决定属于 知识项目及其 Agent 工作流。

适用场景

当 Code Indexer Provider 需要 Go 符号或关系时使用本包。语言解析器无法决定目标 读者、产品边界或有价值的知识形态，这些仍由 Provider 负责。

开发

bun run --filter @c4a/extract-go build
bun run --filter @c4a/extract-go typecheck
bun run --filter @c4a/extract-go test
bun run --filter @c4a/extract-go lint