@mycodemap/mycodemap 0.1.1 → 0.2.0

package/dist/types/index.d.ts

@@ -1,373 +1,7 @@
-export type SymbolKind = 'function' | 'class' | 'interface' | 'type' | 'enum' | 'variable' | 'constant' | 'namespace' | 'decorator' | 'method' | 'property' | 'parameter';
-export interface SourceLocation {
-    file: string;
-    line: number;
-    column: number;
-    endLine?: number;
-    endColumn?: number;
-}
-export interface DecoratorInfo {
-    name: string;
-    params?: any;
-    target: 'class' | 'method' | 'property' | 'parameter';
-}
-export interface ParameterInfo {
-    name: string;
-    type: string;
-    optional: boolean;
-    defaultValue?: string;
-}
-export interface CallInfo {
-    callee: string;
-    line: number;
-    column?: number;
-}
-export type CodeSnippetType = 'if' | 'loop' | 'try' | 'switch' | 'early-return' | 'guard';
-export interface CodeSnippet {
-    type: CodeSnippetType;
-    lines: string;
-    lineStart: number;
-    lineEnd: number;
-    description?: string;
-}
-export interface FunctionSignature {
-    parameters: ParameterInfo[];
-    returnType: string;
-    genericParams?: string[];
-    async: boolean;
-    calls?: CallInfo[];
-    bodySnippets?: CodeSnippet[];
-}
-export interface MemberInfo {
-    name: string;
-    kind: 'property' | 'method' | 'getter' | 'setter';
-    type: string;
-    visibility: 'public' | 'private' | 'protected' | 'internal';
-    optional: boolean;
-    static?: boolean;
-    abstract?: boolean;
-    readonly?: boolean;
-    signature?: FunctionSignature;
-}
-export interface JSDocTag {
-    name: string;
-    text?: string;
-}
-export interface JSDocComment {
-    description: string;
-    tags: JSDocTag[];
-    params: Array<{
-        name: string;
-        description?: string;
-        type?: string;
-    }>;
-    returns?: {
-        description?: string;
-        type?: string;
-    };
-    examples: string[];
-    deprecated?: string;
-    since?: string;
-    see: string[];
-}
-export interface ModuleSymbol {
-    id: string;
-    name: string;
-    kind: SymbolKind;
-    location: SourceLocation;
-    visibility: 'public' | 'private' | 'protected' | 'internal';
-    documentation?: string;
-    jsdoc?: JSDocComment;
-    relatedSymbols: string[];
-    decorators?: DecoratorInfo[];
-    signature?: FunctionSignature;
-    members?: MemberInfo[];
-    type?: string;
-    extends?: string[];
-    implements?: string[];
-}
-export interface ImportInfo {
-    source: string;
-    sourceType: 'relative' | 'absolute' | 'node_module' | 'alias';
-    specifiers: ImportSpecifier[];
-    isTypeOnly: boolean;
-    isReExport?: boolean;
-}
-export interface ImportSpecifier {
-    name: string;
-    alias?: string;
-    isTypeOnly: boolean;
-}
-export interface ExportInfo {
-    name: string;
-    kind: SymbolKind;
-    isDefault: boolean;
-    isTypeOnly: boolean;
-    origin?: string;
-}
-export interface ModuleInfo {
-    id: string;
-    path: string;
-    absolutePath: string;
-    type: 'source' | 'test' | 'config' | 'type';
-    stats: {
-        lines: number;
-        codeLines: number;
-        commentLines: number;
-        blankLines: number;
-    };
-    exports: ExportInfo[];
-    imports: ImportInfo[];
-    overview?: string;
-    symbols: ModuleSymbol[];
-    dependencies: string[];
-    dependents: string[];
-    /** 复杂度指标 */
-    complexity?: {
-        cyclomatic: number;
-        cognitive: number;
-        maintainability: number;
-        details?: {
-            functions: Array<{
-                name: string;
-                cyclomatic: number;
-                cognitive: number;
-                lines: number;
-            }>;
-        };
-    };
-    /** 调用图 */
-    callGraph?: {
-        calls: Array<{
-            caller: string;
-            callee: string;
-            line: number;
-        }>;
-        recursive: string[];
-        callCounts: Record<string, number>;
-        crossFileCalls?: CrossFileCall[];
-    };
-    /** 完整类型信息 */
-    typeInfo?: {
-        typeDefinitions: Array<{
-            name: string;
-            kind: 'interface' | 'type' | 'enum' | 'class' | 'alias';
-            members: Array<{
-                name: string;
-                type: string;
-                optional: boolean;
-            }>;
-        }>;
-        genericParams: Array<{
-            name: string;
-            extends?: string;
-            default?: string;
-        }>;
-        crossFileRefs: Array<{
-            symbol: string;
-            file: string;
-            line: number;
-        }>;
-        unionTypes: string[];
-        intersectionTypes: string[];
-    };
-}
-export interface ProjectSummary {
-    totalFiles: number;
-    totalLines: number;
-    totalModules: number;
-    totalExports: number;
-    totalTypes: number;
-}
-export interface ProjectInfo {
-    name: string;
-    rootDir: string;
-    tsconfigPath?: string;
-    packageManager: 'npm' | 'yarn' | 'pnpm' | 'bun';
-}
-export interface DependencyNode {
-    id: string;
-    path: string;
-    category: 'core' | 'feature' | 'utility' | 'external';
-}
-export interface DependencyEdge {
-    from: string;
-    to: string;
-    type: 'import' | 'inherit' | 'implement' | 'call' | 'type-ref';
-    weight: number;
-}
-export interface DependencyGraph {
-    nodes: DependencyNode[];
-    edges: DependencyEdge[];
-}
-export interface CodeMap {
-    version: string;
-    generatedAt: string;
-    project: ProjectInfo;
-    summary: ProjectSummary;
-    modules: ModuleInfo[];
-    dependencies: DependencyGraph;
-    actualMode?: 'fast' | 'smart';
-}
-export interface AnalysisOptions {
-    mode: 'fast' | 'smart' | 'hybrid';
-    rootDir: string;
-    include?: string[];
-    exclude?: string[];
-    output?: string;
-    watch?: boolean;
-    actualMode?: 'fast' | 'smart';
-}
-export interface FileChange {
-    path: string;
-    type: 'added' | 'modified' | 'deleted' | 'renamed';
-    oldHash?: string;
-    newHash?: string;
-}
-export interface CodemapConfig {
-    mode: 'fast' | 'smart';
-    include: string[];
-    exclude: string[];
-    output: string;
-    watch: boolean;
-}
-export interface GlobalSymbolInfo {
-    name: string;
-    kind: SymbolKind;
-    filePath: string;
-    line: number;
-    column: number;
-    isExported: boolean;
-    isDefault?: boolean;
-}
-export interface CrossFileCall {
-    callee: string;
-    calleeLocation: SourceLocation;
-    callerLocation: SourceLocation;
-    importPath?: string;
-    resolved: boolean;
-}
-export interface GlobalSymbolIndex {
-    symbols: Map<string, GlobalSymbolInfo[]>;
-    files: Map<string, FileSymbolIndex>;
-}
-export interface FileSymbolIndex {
-    filePath: string;
-    imports: Map<string, ImportInfo>;
-    exports: Map<string, GlobalSymbolInfo>;
-    localSymbols: Map<string, GlobalSymbolInfo>;
-    crossFileCalls: CrossFileCall[];
-}
-export interface CallChain {
-    entries: CallChainEntry[];
-    depth: number;
-}
-export interface CallChainEntry {
-    file: string;
-    symbol: string;
-    line: number;
-    column: number;
-    callType: 'local' | 'cross-file' | 'external';
-}
-export interface TypeMember {
-    name: string;
-    type: string;
-    optional: boolean;
-    visibility: 'public' | 'private' | 'protected';
-    isReadonly?: boolean;
-}
-export interface TypeDefinition {
-    name: string;
-    kind: 'interface' | 'type' | 'enum' | 'class' | 'alias';
-    members: TypeMember[];
-    extends?: string[];
-    implements?: string[];
-    genericParams?: GenericParam[];
-    description?: string;
-}
-export interface GenericParam {
-    name: string;
-    extends?: string;
-    default?: string;
-    constraint?: string;
-    variance?: 'in' | 'out' | 'inout';
-}
-export interface ConditionalTypeInfo {
-    checkType: string;
-    extendsType: string;
-    trueType: string;
-    falseType: string;
-}
-export interface MappedTypeInfo {
-    typeParameter: string;
-    constraint: string;
-    valueType: string;
-    asType?: string;
-    modifiers?: ('readonly' | 'optional' | 'nullable')[];
-    readonly?: 'add' | 'remove';
-    optional?: 'add' | 'remove';
-}
-export interface TemplateLiteralTypeInfo {
-    head: string;
-    spans: Array<{
-        type: string;
-        literal: string;
-    }>;
-}
-export interface AdvancedTypeInfo {
-    conditionalTypes?: ConditionalTypeInfo[];
-    mappedTypes?: MappedTypeInfo[];
-    templateLiteralTypes?: TemplateLiteralTypeInfo[];
-    indexedAccessTypes?: string[];
-    inferredTypes?: string[];
-}
-export interface CrossFileRef {
-    symbol: string;
-    file: string;
-    line: number;
-    column?: number;
-    exportName?: string;
-}
-export interface FullTypeInfo {
-    typeDefinitions: TypeDefinition[];
-    genericParams: GenericParam[];
-    crossFileRefs: CrossFileRef[];
-    unionTypes: string[];
-    intersectionTypes: string[];
-    typeAliases: Array<{
-        name: string;
-        type: string;
-        genericParams?: GenericParam[];
-    }>;
-}
-export interface VisualizationNode {
-    id: string;
-    label: string;
-    path: string;
-    category: 'core' | 'feature' | 'utility' | 'external' | 'entry';
-    type: 'source' | 'test' | 'config' | 'type';
-    exportCount: number;
-    dependencyCount: number;
-}
-export interface VisualizationEdge {
-    from: string;
-    to: string;
-    type: 'import' | 'inherit' | 'implement' | 'call' | 'type-ref';
-    label?: string;
-}
-export interface MermaidConfig {
-    graphType: 'graph' | 'flowchart' | 'mindmap';
-    direction: 'TB' | 'BT' | 'LR' | 'RL';
-    nodeShape: 'box' | 'round' | 'stadium' | 'cylinder';
-    showLabels: boolean;
-    maxNodes: number;
-    maxEdges: number;
-}
-export interface VisualizationConfig {
-    mermaid: MermaidConfig;
-    includeTestFiles: boolean;
-    includeExternalDeps: boolean;
-    showComplexity: boolean;
-    outputFormat: 'markdown' | 'html' | 'json';
-}
+export * from '../interface/types/index.js';
+export * from '../interface/types/storage.js';
+export * from '../interface/types/parser.js';
+export * from '../interface/config/index.js';
+/** @deprecated 使用 CodemapConfig 替代 */
+export type CodeMapConfig = import('../interface/config/index.js').CodemapConfig;
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AASA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC;AAG7C,sCAAsC;AACtC,MAAM,MAAM,aAAa,GAAG,OAAO,8BAA8B,EAAE,aAAa,CAAC"}

package/dist/types/index.js

@@ -1,7 +1,13 @@
 // [META] since:2024-06 | owner:core-team | stable:true
-// [WHY] 定义 CodeMap 项目的核心类型系统，供所有模块共享使用
+// [WHY] 向后兼容层 - 转发到 Interface Layer
+// 原有类型定义已迁移到 src/interface/types/
+// 此文件保留以维持向后兼容
 // ============================================
-// CodeMap 核心类型定义
+// CodeMap 核心类型定义 (向后兼容层)
 // ============================================
-export {};
+// 转发所有类型到 Interface Layer
+export * from '../interface/types/index.js';
+export * from '../interface/types/storage.js';
+export * from '../interface/types/parser.js';
+export * from '../interface/config/index.js';
 //# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,uCAAuC;AACvC,+CAA+C;AAC/C,iBAAiB;AACjB,+CAA+C"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,oCAAoC;AACpC,kCAAkC;AAClC,eAAe;AACf,+CAA+C;AAC/C,yBAAyB;AACzB,+CAA+C;AAE/C,0BAA0B;AAC1B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC"}

package/docs/AI_ASSISTANT_SETUP.md

@@ -45,6 +45,14 @@ MyCodeMap 可以与多种 AI 编程助手集成，让 AI 能够：
 | `.mycodemap/context/` | 模块详细上下文 | ⭐ |
 | `.mycodemap/dependency-graph.md` | Mermaid 依赖图 | ⭐ |
 
+### 当前仓库维护者附加护栏
+
+如果你在维护当前 CodeMap 仓库，而不是只在使用安装包：
+
+- 修改 README、AI 助手提示、CLI 示例、测试事实后，先运行 `npm run docs:check`
+- 也可以通过 `mycodemap ci check-docs-sync` 走统一的 CI 子命令入口
+- 当前仓库的 agent 工程规则以 `docs/rules/engineering-with-codex-openai.md` 为准
+
 ---
 
 ## Kimi CLI 配置
@@ -126,6 +134,57 @@ $CODEMAP_CMD cycles
 $CODEMAP_CMD complexity -f "<file-path>"
 ```
 
+### 统一分析入口（analyze）
+```bash
+# 影响分析
+$CODEMAP_CMD analyze -i impact -t "<file-path>"
+
+# 依赖分析
+$CODEMAP_CMD analyze -i dependency -t "<module-path>"
+
+# 复杂度分析
+$CODEMAP_CMD analyze -i complexity -t "<path>"
+
+# 搜索分析
+$CODEMAP_CMD analyze -i search -k "<keyword>"
+
+# 项目概览
+$CODEMAP_CMD analyze -i overview -t "<path>"
+
+# JSON 输出
+$CODEMAP_CMD analyze -i impact -t "<file>" --json
+```
+
+### CI 门禁（ci）
+```bash
+# 检查提交格式
+$CODEMAP_CMD ci check-commits
+
+# 检查文件头
+$CODEMAP_CMD ci check-headers
+
+# 评估变更风险
+$CODEMAP_CMD ci assess-risk
+
+# 验证输出契约
+$CODEMAP_CMD ci check-output-contract
+```
+
+### 工作流编排（workflow）
+```bash
+# 启动工作流
+$CODEMAP_CMD workflow start "<task-description>"
+
+# 查看状态
+$CODEMAP_CMD workflow status
+
+# 推进到下一阶段
+$CODEMAP_CMD workflow proceed
+
+# 可视化工作流
+$CODEMAP_CMD workflow visualize
+```
+
 ## 使用场景
 
 ### 场景 1：理解项目结构
@@ -622,6 +681,15 @@ Use CodeMap for code analysis:
 
 ## 高级配置
 
+### 仓库级护栏
+
+当 AI 助手配置文档本身被修改时，建议在提交前执行：
+
+```bash
+npm run docs:check
+mycodemap ci check-docs-sync
+```
+
 ### 自定义输出格式
 
 对于需要特定输出格式的场景，创建包装脚本：

package/docs/PUBLISHING.md

@@ -0,0 +1,162 @@
+# NPM 自动发布指南
+
+> 本文档说明如何配置和触发 @mycodemap/mycodemap 的自动发布流程
+
+## 📋 发布流程概览
+
+```
+本地执行 release.sh → 推送 tag → GitHub Actions → 发布到 NPM
+```
+
+## 🔧 前置配置
+
+### 方式一: NPM Token (推荐，简单)
+
+1. **获取 NPM Token**
+   - 登录 [npmjs.com](https://www.npmjs.com/)
+   - 进入 Access Tokens → Generate New Token → Classic Token
+   - 选择类型: **Automation** (用于 CI/CD)
+   - 复制生成的 token
+
+2. **配置 GitHub Secret**
+   - 进入仓库 Settings → Secrets and variables → Actions
+   - 点击 "New repository secret"
+   - Name: `NPM_TOKEN`
+   - Value: 粘贴刚才复制的 npm token
+   - 点击 "Add secret"
+
+### 方式二: OIDC Trusted Publishing (更安全)
+
+1. **在 NPM 上配置**
+   - 登录 [npmjs.com](https://www.npmjs.com/)
+   - 进入包页面 → Access → Grant Access
+   - 选择 "Automation" → "GitHub Actions"
+   - 配置:
+     - GitHub Organization: `yuanyuanyuan` (或你的组织名)
+     - GitHub Repository: `mycodemap`
+     - Workflow name: `publish.yml`
+
+2. **修改 workflow** (已默认支持)
+   - 当前 `publish.yml` 已同时支持两种方式
+   - 如使用 OIDC，确保不设置 `NPM_TOKEN` secret
+
+## 🚀 发布操作
+
+### 方法 1: 使用发布脚本 (推荐)
+
+```bash
+# 进入项目目录
+cd /path/to/mycodemap
+
+# 发布 patch 版本 (0.2.0 -> 0.2.1)
+./scripts/release.sh patch
+
+# 发布 minor 版本 (0.2.0 -> 0.3.0)
+./scripts/release.sh minor
+
+# 发布 major 版本 (0.2.0 -> 1.0.0)
+./scripts/release.sh major
+
+# 发布指定版本
+./scripts/release.sh 0.2.1
+```
+
+脚本会自动：
+1. 更新 `package.json` 和 `package-lock.json` 中的版本号
+2. 运行完整的代码检查
+3. 提交版本更新
+4. 创建 git tag
+5. 推送到远程仓库
+6. 触发 GitHub Actions 发布流程
+
+### 方法 2: 手动操作
+
+```bash
+# 1. 更新版本号
+npm version patch  # 或 minor, major
+
+# 2. 推送代码和标签
+git push origin main --tags
+
+# 或者直接推送特定标签
+git push origin v0.2.1
+```
+
+### 方法 3: GitHub 网页手动触发
+
+1. 进入仓库 Actions → Publish to NPM
+2. 点击 "Run workflow"
+3. 可选择输入版本号，或直接运行使用当前 package.json 版本
+
+## ✅ 发布前检查清单
+
+- [ ] 更新 `CHANGELOG.md` 记录本次变更
+- [ ] 确保所有测试通过 (`npm test`)
+- [ ] 确保代码检查通过 (`npm run check:all`)
+- [ ] 更新 `README.md` 中的版本说明（如需要）
+- [ ] 确认版本号符合 [semver](https://semver.org/lang/zh-CN/) 规范
+
+## 🔍 验证发布
+
+发布后验证：
+
+```bash
+# 查看 npm 上的最新版本
+npm view @mycodemap/mycodemap version
+
+# 安装测试
+npm install -g @mycodemap/mycodemap
+
+# 验证 CLI 版本
+mycodemap --version
+```
+
+## 🐛 故障排查
+
+### 发布失败: "ENEEDAUTH"
+
+**原因**: NPM_TOKEN 未配置或已过期
+
+**解决**:
+1. 检查 GitHub Secrets 中是否设置了 `NPM_TOKEN`
+2. 确认 token 未过期（npm 上可查看）
+3. 确认 token 有发布权限
+
+### 发布失败: "403 Forbidden"
+
+**原因**: 没有包发布权限
+
+**解决**:
+1. 确认你是该 npm 包的维护者
+2. 如果是 scoped package (@mycodemap/xxx)，确认已设置 `--access public`
+
+### 发布失败: "版本已存在"
+
+**原因**: npm 上已有相同版本
+
+**解决**:
+1. 检查 package.json 中的版本号
+2. npm 版本号不可重复，需要递增
+
+### GitHub Actions 未触发
+
+**原因**: tag 格式不正确或 workflow 配置错误
+
+**解决**:
+1. 确保 tag 格式为 `v*` (例如: v0.2.1)
+2. 检查 `.github/workflows/publish.yml` 是否存在
+3. 查看 Actions 日志排查问题
+
+## 📚 相关文件
+
+| 文件 | 说明 |
+|------|------|
+| `.github/workflows/publish.yml` | GitHub Actions 发布工作流 |
+| `scripts/release.sh` | 本地发布助手脚本 |
+| `package.json` | 版本号定义 |
+| `CHANGELOG.md` | 版本变更记录 |
+
+## 🔗 相关链接
+
+- NPM 包页面: https://www.npmjs.com/package/@mycodemap/mycodemap
+- GitHub Actions: https://github.com/yuanyuanyuan/mycodemap/actions