Skip to content
cotapeluPublic

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

JF - Pi Coding Agent

npm version license

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.

Tính năng chính

  • 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

Cài đặt nhanh bằng npm (lệnh ngắn nhất):

📋 Copy lệnh

npm i -g github:cotapelu/jf

Sau đó chạy:

jf --help

Hoặ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

Cách dùng cơ bản

# 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>

Phát triển

git clone https://github.com/cotapelu/jf.git
cd jf
npm install
npm run build
npm test

API Compatibility

APIs 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.json and updates are performed via npm update within 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.

Observability

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.

Production Standards

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

Compliance

See docs/COMPLIANCE.md for the compliance matrix (GDPR, HIPAA, PCI, SOX, COPPA) and audit evidence.

License

Apache License 2.0 - xem file LICENSE.

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages