@mycodemap/mycodemap 0.1.1 → 0.3.4

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
+```
+
 ### 自定义输出格式
 
 对于需要特定输出格式的场景，创建包装脚本：