JF là một coding agent mạnh mẽ, tích hợp các công cụ phát triển phần mềm AI‑ready. Xây dựng trên nền tảng Pi SDK.
- Quản lý session và context compaction
- Indexer codebase với AST
- Skills engine và test generation
- Extensions framework (Git, …)
- Logging configurable
Cài đặt nhanh bằng npm (lệnh ngắn nhất):
📋 Copy lệnh
npm i -g github:cotapelu/jfSau đó chạy:
jf --helpHoặc cài với tag cụ thể (ví dụ v0.0.7):
📋 Copy lệnh (v0.0.7)
npm i -g github:cotapelu/jf#v0.0.7# Khởi động agent
jf
# Sử dụng các lệnh session
jf session create "Tên session"
jf session list
jf session switch <id>git clone https://github.com/cotapelu/jf.git
cd jf
npm install
npm run build
npm testAPIs Used:
- Pi SDK family:
@earendil-works/pi-coding-agent,@earendil-works/pi-ai,@earendil-works/pi-tui - Build: TypeScript, Vite, Vitest, ESLint, Prettier
- Runtime: Node.js 18+
Deprecation Status:
- No deprecated APIs in use. Dependencies are pinned in
package-lock.jsonand updates are performed vianpm updatewithin semver ranges.
Fallback Strategy:
- Not applicable (no deprecated APIs). If future deprecations arise, we will use feature detection and polyfills where appropriate.
Migration Plan:
- Monthly check for outdated dependencies (
npm outdated). - Test new major versions in a feature branch before upgrading.
- Track migration tasks in GitHub Issues.
Version Pinning:
- Exact versions committed in
package-lock.json. - Update schedule: monthly or as needed for security patches.
Master tool provides a built-in master_tool.stats command to retrieve executor metrics:
# Human-readable (default)
master_tool({ command: "master_tool.stats", args: {} })
# Machine-readable JSON
master_tool({ command: "master_tool.stats", args: { format: "json" } })Metrics include registered commands, total executions, success rate, per‑command count & average duration, cache stats, and recent errors. Useful for SLO monitoring and capacity planning.
JF follows the GOAL.md production-readiness framework. See GOAL.md for the full specification.
- Quality gates: Functions ≤20 lines, Complexity ≤10, Coverage ≥80%
- Security: Input validation, parameterized queries, TLS 1.2+, JWT RS256, rate limiting
- Performance: p50<100ms, p99<200ms, 1000+ RPS
- Observability: Structured logs, metrics, tracing, health checks
- Resilience: Retry, timeout, circuit breaker, bulkhead, fallback
- Error handling: Format
[ERROR] Component Action - Reason - Suggestion - Concurrency safety: mutexes, atomic ops, deadlock avoidance
See docs/COMPLIANCE.md for the compliance matrix (GDPR, HIPAA, PCI, SOX, COPPA) and audit evidence.
Apache License 2.0 - xem file LICENSE.