thatgfsj-code 0.3.0 → 0.3.1

package/dist/utils/memory.js

@@ -0,0 +1,186 @@
+/**
+ * Session Memory - Remember modifications during conversation
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+export class SessionMemory {
+    entries = [];
+    sessionId;
+    memoryFile;
+    constructor(sessionId) {
+        this.sessionId = sessionId || this.generateId();
+    }
+    /**
+     * Add an entry to memory
+     */
+    add(entry) {
+        this.entries.push({
+            ...entry,
+            id: this.generateId(),
+            timestamp: Date.now()
+        });
+    }
+    /**
+     * Record file read
+     */
+    recordRead(path, lines) {
+        this.add({
+            type: 'file_read',
+            description: `Read ${path}`,
+            details: { path, lines }
+        });
+    }
+    /**
+     * Record file write
+     */
+    recordWrite(path, content) {
+        this.add({
+            type: 'file_write',
+            description: `Wrote ${path}`,
+            details: { path, size: content?.length || 0 }
+        });
+    }
+    /**
+     * Record file edit
+     */
+    recordEdit(path, operation) {
+        this.add({
+            type: 'file_edit',
+            description: `Edited ${path}: ${operation}`,
+            details: { path, operation }
+        });
+    }
+    /**
+     * Record command execution
+     */
+    recordCommand(command, output) {
+        this.add({
+            type: 'command',
+            description: `Executed: ${command}`,
+            details: { command, output: output?.slice(0, 200) }
+        });
+    }
+    /**
+     * Record git operation
+     */
+    recordGit(operation, result) {
+        this.add({
+            type: 'git',
+            description: `Git ${operation}`,
+            details: { operation, result: result.slice(0, 200) }
+        });
+    }
+    /**
+     * Record a note
+     */
+    recordNote(note) {
+        this.add({
+            type: 'note',
+            description: note,
+            details: {}
+        });
+    }
+    /**
+     * Get all entries
+     */
+    getEntries() {
+        return [...this.entries];
+    }
+    /**
+     * Get recent entries
+     */
+    getRecent(count = 10) {
+        return this.entries.slice(-count);
+    }
+    /**
+     * Get entries by type
+     */
+    getByType(type) {
+        return this.entries.filter(e => e.type === type);
+    }
+    /**
+     * Search entries
+     */
+    search(query) {
+        const lower = query.toLowerCase();
+        return this.entries.filter(e => e.description.toLowerCase().includes(lower) ||
+            JSON.stringify(e.details).toLowerCase().includes(lower));
+    }
+    /**
+     * Get summary
+     */
+    getSummary() {
+        if (this.entries.length === 0) {
+            return 'No actions recorded yet.';
+        }
+        const types = this.entries.reduce((acc, e) => {
+            acc[e.type] = (acc[e.type] || 0) + 1;
+            return acc;
+        }, {});
+        const lines = ['📋 Session Summary:'];
+        for (const [type, count] of Object.entries(types)) {
+            const emoji = {
+                'file_read': '📖',
+                'file_write': '✍️',
+                'file_edit': '📝',
+                'command': '⚡',
+                'git': '📊',
+                'note': '📌'
+            }[type] || '•';
+            lines.push(`  ${emoji} ${type}: ${count}`);
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Export to file
+     */
+    save() {
+        if (!this.memoryFile) {
+            const homeDir = homedir();
+            const memDir = join(homeDir, '.thatgfsj', 'memory');
+            if (!existsSync(memDir)) {
+                mkdirSync(memDir, { recursive: true });
+            }
+            this.memoryFile = join(memDir, `${this.sessionId}.json`);
+        }
+        writeFileSync(this.memoryFile, JSON.stringify({
+            sessionId: this.sessionId,
+            entries: this.entries,
+            savedAt: Date.now()
+        }, null, 2));
+    }
+    /**
+     * Load from file
+     */
+    load(sessionId) {
+        const homeDir = homedir();
+        const memoryFile = join(homeDir, '.thatgfsj', 'memory', `${sessionId}.json`);
+        if (!existsSync(memoryFile)) {
+            return false;
+        }
+        try {
+            const data = JSON.parse(readFileSync(memoryFile, 'utf-8'));
+            this.entries = data.entries || [];
+            this.sessionId = data.sessionId;
+            this.memoryFile = memoryFile;
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Clear memory
+     */
+    clear() {
+        this.entries = [];
+    }
+    /**
+     * Generate unique ID
+     */
+    generateId() {
+        return `${Date.now()}_${Math.random().toString(36).substring(2, 9)}`;
+    }
+}
+//# sourceMappingURL=memory.js.map

package/dist/utils/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../src/utils/memory.ts"],"names":[],"mappings":"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"}

package/dist/utils/project-context.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Project Context - Auto-detect and read project files
+ */
+export interface ProjectInfo {
+    root: string;
+    name: string;
+    language: string;
+    buildTool?: string;
+    gitIgnore: string[];
+    files: string[];
+    hasGit: boolean;
+    packageJson?: PackageJson;
+}
+export interface PackageJson {
+    name: string;
+    version: string;
+    description?: string;
+    scripts?: Record<string, string>;
+    dependencies?: Record<string, string>;
+    devDependencies?: Record<string, string>;
+}
+export declare class ProjectContext {
+    private root;
+    constructor(root?: string);
+    /**
+     * Detect project type and gather context
+     */
+    detect(): Promise<ProjectInfo>;
+    /**
+     * Get project name
+     */
+    private getProjectName;
+    /**
+     * Detect primary language
+     */
+    private detectLanguage;
+    /**
+     * Detect build tool
+     */
+    private detectBuildTool;
+    /**
+     * Read .gitignore
+     */
+    private readGitIgnore;
+    /**
+     * Read package.json
+     */
+    private readPackageJson;
+    /**
+     * List project files
+     */
+    private listFiles;
+    /**
+     * Check if ignored
+     */
+    private isIgnored;
+    /**
+     * Get context summary
+     */
+    getContextSummary(): Promise<string>;
+}
+//# sourceMappingURL=project-context.d.ts.map

package/dist/utils/project-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-context.d.ts","sourceRoot":"","sources":["../../src/utils/project-context.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1C;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,IAAI,CAAS;gBAET,IAAI,GAAE,MAAsB;IAIxC;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,WAAW,CAAC;IAmBpC;;OAEG;IACH,OAAO,CAAC,cAAc;IAQtB;;OAEG;IACH,OAAO,CAAC,cAAc;IAyCtB;;OAEG;IACH,OAAO,CAAC,eAAe;IAUvB;;OAEG;IACH,OAAO,CAAC,aAAa;IASrB;;OAEG;IACH,OAAO,CAAC,eAAe;IAQvB;;OAEG;IACH,OAAO,CAAC,SAAS;IA8BjB;;OAEG;IACH,OAAO,CAAC,SAAS;IAMjB;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC;CAc3C"}

package/dist/utils/project-context.js

@@ -0,0 +1,197 @@
+/**
+ * Project Context - Auto-detect and read project files
+ */
+import { readFileSync, existsSync, readdirSync, statSync } from 'fs';
+import { join, relative } from 'path';
+export class ProjectContext {
+    root;
+    constructor(root = process.cwd()) {
+        this.root = root;
+    }
+    /**
+     * Detect project type and gather context
+     */
+    async detect() {
+        const info = {
+            root: this.root,
+            name: this.getProjectName(),
+            language: this.detectLanguage(),
+            buildTool: this.detectBuildTool(),
+            gitIgnore: this.readGitIgnore(),
+            files: this.listFiles(),
+            hasGit: existsSync(join(this.root, '.git'))
+        };
+        const pkg = this.readPackageJson();
+        if (pkg) {
+            info.packageJson = pkg;
+        }
+        return info;
+    }
+    /**
+     * Get project name
+     */
+    getProjectName() {
+        const pkg = this.readPackageJson();
+        if (pkg?.name) {
+            return pkg.name;
+        }
+        return this.root.split(/[\\/]/).pop() || 'unknown';
+    }
+    /**
+     * Detect primary language
+     */
+    detectLanguage() {
+        const langCounts = {};
+        const scan = (dir, depth = 0) => {
+            if (depth > 3)
+                return;
+            try {
+                const items = readdirSync(dir);
+                for (const item of items) {
+                    if (['node_modules', '.git', 'dist'].includes(item))
+                        continue;
+                    const fullPath = join(dir, item);
+                    try {
+                        const stat = statSync(fullPath);
+                        if (stat.isDirectory()) {
+                            scan(fullPath, depth + 1);
+                        }
+                        else if (stat.isFile()) {
+                            const ext = item.split('.').pop()?.toLowerCase();
+                            if (ext)
+                                langCounts[ext] = (langCounts[ext] || 0) + 1;
+                        }
+                    }
+                    catch { /* skip */ }
+                }
+            }
+            catch { /* skip */ }
+        };
+        scan(this.root);
+        const extToLang = {
+            'ts': 'TypeScript', 'tsx': 'TypeScript',
+            'js': 'JavaScript', 'jsx': 'JavaScript', 'mjs': 'JavaScript',
+            'py': 'Python', 'java': 'Java', 'go': 'Go', 'rs': 'Rust',
+            'c': 'C/C++', 'cpp': 'C/C++', 'h': 'C/C++', 'hpp': 'C/C++',
+            'cs': 'C#', 'rb': 'Ruby', 'php': 'PHP',
+        };
+        for (const [ext, count] of Object.entries(langCounts)) {
+            const lang = extToLang[ext];
+            if (lang && count > 0)
+                return lang;
+        }
+        return 'Unknown';
+    }
+    /**
+     * Detect build tool
+     */
+    detectBuildTool() {
+        if (existsSync(join(this.root, 'package.json')))
+            return 'npm/yarn/pnpm';
+        if (existsSync(join(this.root, 'Cargo.toml')))
+            return 'Cargo';
+        if (existsSync(join(this.root, 'go.mod')))
+            return 'Go';
+        if (existsSync(join(this.root, 'pom.xml')))
+            return 'Maven';
+        if (existsSync(join(this.root, 'build.gradle')))
+            return 'Gradle';
+        if (existsSync(join(this.root, 'Makefile')))
+            return 'Make';
+        return undefined;
+    }
+    /**
+     * Read .gitignore
+     */
+    readGitIgnore() {
+        const path = join(this.root, '.gitignore');
+        if (!existsSync(path))
+            return [];
+        try {
+            return readFileSync(path, 'utf-8').split('\n')
+                .map(l => l.trim()).filter(l => l && !l.startsWith('#'));
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * Read package.json
+     */
+    readPackageJson() {
+        const path = join(this.root, 'package.json');
+        if (!existsSync(path))
+            return null;
+        try {
+            return JSON.parse(readFileSync(path, 'utf-8'));
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * List project files
+     */
+    listFiles(maxFiles = 100) {
+        const files = [];
+        const gitIgnore = this.readGitIgnore();
+        const scan = (dir, depth = 0) => {
+            if (depth > 4 || files.length >= maxFiles)
+                return;
+            try {
+                const items = readdirSync(dir);
+                for (const item of items) {
+                    if (files.length >= maxFiles)
+                        break;
+                    if (this.isIgnored(item, gitIgnore))
+                        continue;
+                    const fullPath = join(dir, item);
+                    const relPath = relative(this.root, fullPath);
+                    try {
+                        const stat = statSync(fullPath);
+                        if (stat.isDirectory()) {
+                            files.push(relPath + '/');
+                            scan(fullPath, depth + 1);
+                        }
+                        else if (stat.isFile()) {
+                            files.push(relPath);
+                        }
+                    }
+                    catch { /* skip */ }
+                }
+            }
+            catch { /* skip */ }
+        };
+        scan(this.root);
+        return files;
+    }
+    /**
+     * Check if ignored
+     */
+    isIgnored(name, gitIgnore) {
+        const common = ['node_modules', '.git', 'dist', 'build', '__pycache__', '.env'];
+        if (common.includes(name))
+            return true;
+        return gitIgnore.includes(name);
+    }
+    /**
+     * Get context summary
+     */
+    async getContextSummary() {
+        const info = await this.detect();
+        const lines = [`📁 Project: ${info.name}`, `💻 Language: ${info.language}`];
+        if (info.buildTool)
+            lines.push(`🔧 Build: ${info.buildTool}`);
+        if (info.hasGit)
+            lines.push(`📊 Git: Yes`);
+        if (info.packageJson) {
+            lines.push(`📦 Package: ${info.packageJson.name}@${info.packageJson.version}`);
+            if (info.packageJson.scripts) {
+                lines.push(`   Scripts: ${Object.keys(info.packageJson.scripts).slice(0, 5).join(', ')}`);
+            }
+        }
+        lines.push(`📁 Files: ${info.files.length} files scanned`);
+        return lines.join('\n');
+    }
+}
+//# sourceMappingURL=project-context.js.map

package/dist/utils/project-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-context.js","sourceRoot":"","sources":["../../src/utils/project-context.ts"],"names":[],"mappings":"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"}

package/docs/API_KEY_GUIDE.md

@@ -2,6 +2,9 @@
 
 Thatgfsj Code 支持多种 AI 提供商，以下是各提供商 API Key 的获取教程。
 
+> 贡献者请阅读 [`DEVELOPMENT.md`](../DEVELOPMENT.md)；版本变更与已知限制见
+> [`CHANGELOG.md`](../CHANGELOG.md)。
+
 ## 目录
 
 1. [SiliconFlow (推荐)](#1-siliconflow-推荐)
@@ -208,6 +211,9 @@ export DEEPSEEK_API_KEY=你的密钥
 
 # Ollama
 export OLLAMA_BASE_URL=http://localhost:11434
+
+# 文心一言 (ERNIE) — Access Token 方式
+export ERNIE_API_KEY=你的_access_token
 ```
 
 或者运行 `gfcode init` 交互式配置。

package/docs/FAQ.md

@@ -1,11 +1,14 @@
 # 常见问题 FAQ
 
+> 贡献者请阅读 [`DEVELOPMENT.md`](../DEVELOPMENT.md)，版本变更见
+> [`CHANGELOG.md`](../CHANGELOG.md)。
+
 ## 目录
 
 1. [安装问题](#1-安装问题)
 2. [配置问题](#2-配置问题)
 3. [使用问题](#3-使用问题)
-4. [ Provider 问题](#4-provider-问题)
+4. [Provider 问题](#4-provider-问题)
 5. [其他问题](#5-其他问题)
 
 ---
@@ -32,9 +35,10 @@
 
 ### Q: 如何配置 API Key？
 
-**A**: 两种方式：
+**A**: 三种方式任选其一：
 1. 交互式配置（推荐）：运行 `gfcode init`
-2. 环境变量：设置对应的环境变量
+2. 环境变量：设置对应的环境变量（详见 [API_KEY_GUIDE.md](./API_KEY_GUIDE.md)）
+3. 手动编辑 `~/.thatgfsj/config.json`
 
 ### Q: 配置文件在哪里？
 
@@ -148,12 +152,30 @@ gfcode --version
 
 ### Q: 如何更新到最新版本？
 
+**A**:
 ```bash
+# 源码安装
 git pull
 npm install
 npm run build
+
+# 全局 npm 包
+npm install -g thatgfsj-code@latest
 ```
 
+### Q: 启动瞬间报 `ReferenceError: require is not defined`？
+
+**A**: 这是 0.2.1 之前的 bug，已经在 **0.2.2** 修复（用 `createRequire(import.meta.url)`）。
+如果你看到这个错，升级到最新版本即可：
+```bash
+npm install -g thatgfsj-code@latest
+```
+
+### Q: REPL 中 Ctrl+C 不能退出？
+
+**A**: 0.2.2 起，空输入连续按两次 Ctrl+C 即可退出。0.2.1 之前该路径只会打
+warning，不会退出；升级版本解决。
+
 ### Q: 遇到其他错误怎么办？
 
 **A**:

package/package.json

@@ -1,27 +1,59 @@
 {
   "name": "thatgfsj-code",
-  "version": "0.3.0",
-  "description": "Thatgfsj Code - AI Coding Assistant",
-  "main": "dist/cmd/index.js",
+  "version": "0.3.1",
+  "description": "Thatgfsj Code - Your AI Coding Assistant",
+  "main": "dist/index.js",
   "type": "module",
   "bin": {
-    "thatgfsj": "./dist/cmd/index.js",
-    "gfcode": "./dist/cmd/index.js"
+    "thatgfsj": "./dist/index.js",
+    "gfcode": "./dist/index.js"
   },
   "scripts": {
     "build": "tsc",
-    "start": "node dist/cmd/index.js",
-    "dev": "tsc && node dist/cmd/index.js",
-    "link": "npm link"
+    "start": "node dist/index.js",
+    "dev": "tsc && node dist/index.js",
+    "link": "npm link",
+    "test": "node --test tests/*.test.js",
+    "test:silent": "node --test --test-reporter=dot tests/*.test.js",
+    "prepublishOnly": "npm run test && npm run build"
   },
+  "files": [
+    "dist",
+    "README.md",
+    "DEVELOPMENT.md",
+    "CHANGELOG.md",
+    "LICENSE",
+    "docs",
+    "install.sh",
+    "install.ps1",
+    "install.bat"
+  ],
   "keywords": [
     "ai",
     "cli",
     "coding",
-    "assistant"
+    "assistant",
+    "anthropic",
+    "openai",
+    "siliconflow",
+    "minimax",
+    "kimi",
+    "deepseek",
+    "ollama"
   ],
   "author": "Thatgfsj",
   "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Thatgfsj/thatgfsj-code.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Thatgfsj/thatgfsj-code/issues"
+  },
+  "homepage": "https://github.com/Thatgfsj/thatgfsj-code#readme",
   "dependencies": {
     "chalk": "^5.3.0",
     "commander": "^11.1.0",

package/ROADMAP.md

@@ -1,61 +0,0 @@
-# Thatgfsj Code - Development Roadmap
-
----
-
-## ✅ v0.3.0 - 架构重构 (当前版本)
-
-### 核心改进
-- [x] 参考 opencode 重构模块化架构
-- [x] LLM Provider 抽象层 (OpenAI/Anthropic/Gemini)
-- [x] 统一 App 核心服务层
-- [x] 精简 CLI 入口 (去掉 explain/debug/chat/template)
-- [x] 类型系统整理 (types.ts 拆分到各模块)
-- [x] 删除未使用模块 (skills, subagent, state, intent)
-
-### 新目录结构
-```
-src/
-├── cmd/        # CLI 入口
-├── app/        # 核心服务 + Agent Loop
-├── config/     # 配置 + Provider 定义
-├── llm/        # LLM Provider 抽象
-├── session/    # 会话管理
-├── tools/      # 工具系统
-├── tui/        # 终端 UI
-├── mcp/        # MCP 协议
-├── hooks/      # 钩子系统
-├── prompts/    # 提示构建
-└── utils/      # 工具函数
-```
-
----
-
-## 📋 未来计划
-
-### v0.4.0 - 增强功能
-- [ ] SQLite 会话持久化
-- [ ] 命令历史持久化
-- [ ] 自定义工具插件加载
-- [ ] MCP 服务器配置文件支持
-
-### v0.5.0 - TUI 升级
-- [ ] Ink/React TUI 替换 readline
-- [ ] 分屏显示 (代码 + 对话)
-- [ ] Vim 模式编辑器
-- [ ] 文件变更预览面板
-
-### v1.0.0 - 稳定版
-- [ ] LSP 集成
-- [ ] 多会话管理
-- [ ] 插件市场
-- [ ] 完整测试覆盖
-
----
-
-## 已完成的历史阶段
-
-### ✅ v0.1.0 - REPL 基础
-- 彩色 UI、命令提示符、Ctrl+C 中断、内置命令
-
-### ✅ v0.2.0 - 工具 + LLM
-- Git/搜索工具、多 Provider 支持、流式输出、意图识别