kaitranntt
ec7781bbc8
docs: update documentation for v7.1 remote CLIProxy feature
...
- README: add remote CLIProxy section with CLI flags and quick setup
- code-standards: add Config Priority Pattern (CLI > ENV > config.yaml)
- codebase-summary: add new remote proxy files, update test counts (638)
- project-overview-pdr: add FR-008 requirement, v7.1 release section
- project-roadmap: add Phase 10 (Remote CLIProxy), mark #142 complete
- system-architecture: add Remote CLIProxy Flow diagram
2025-12-21 20:09:46 -05:00
kaitranntt
e45b46d207
docs: update documentation for modularization phases 6-9
...
- mark settings, analytics, auth-monitor splits as complete
- add test infrastructure (99 tests, 90% threshold) to roadmap
- update codebase-summary.md with new modular structure
- add github issues backlog (13 issues categorized by priority)
- add future roadmap: multiple cliproxyapi, git worktree support
- update project-overview-pdr.md with v7.0 release items
- update system-architecture.md with new ui module structure
2025-12-21 03:45:02 -05:00
kaitranntt
53a7ba8d3f
docs(standards): add input state persistence patterns
...
- Pattern 1: Key-based remounting
- Pattern 2: Unsaved changes confirmation
- Pattern 3: Auto-save with visual feedback
Closes #165
2025-12-21 01:59:10 -05:00
kaitranntt
1ffd169b98
docs: add comprehensive documentation suite for modular architecture
...
Add five documentation files reflecting Phase 5 UI modularization:
- codebase-summary.md: Complete directory structure for CLI and UI
- code-standards.md: 200-line file limit, barrel exports, naming conventions
- system-architecture.md: ASCII architecture diagrams and data flows
- project-roadmap.md: Completed phases 1-5, future work
- project-overview-pdr.md: Product development requirements
2025-12-19 20:17:55 -05:00
kaitranntt
98c21efb5a
fix(websearch): detect Gemini CLI auth status before showing Ready
...
Previously, WebSearch status showed "Ready (Gemini)" when the CLI binary
was installed, misleading users who hadn't authenticated yet.
Changes:
- Add isGeminiAuthenticated() to check ~/.gemini/oauth_creds.json
- Add 'needs_auth' state to WebSearchReadiness type
- Show warning "[!] Gemini: run 'gemini' to login" when not authenticated
- Fix incorrect 'gemini auth login' references (no such command exists)
- Update docs with correct npm install and authentication instructions
2025-12-18 03:24:59 -05:00
kaitranntt
fd99ebca98
feat(websearch): add MCP fallback and Gemini CLI hook for third-party profiles
...
- Add Gemini CLI transformer hook (websearch-gemini-transformer.cjs)
- Implement MCP auto-configuration with web-search-prime, brave, tavily fallback
- Add installWebSearchHook() to activate hook on profile launch
- Update settings.tsx to clarify web-search-prime requires z.ai subscription
- Add WebSearch config types and loader support
- Create implementation plan for WebSearch UX enhancement (startup status, dashboard)
Third-party profiles (gemini, agy, codex, qwen, glm, kimi) now have WebSearch
capability via Gemini CLI primary + MCP fallback chain.
2025-12-16 02:49:07 -05:00
kaitranntt
071ec041ed
feat(websearch): add multi-tier MCP fallback for third-party profiles
...
Implements CCS WebSearch Native Infrastructure (Phases 1-3):
Phase 1 - Multi-tier MCP Fallback:
- Add mcp-manager.ts with ensureMcpWebSearch() for auto-configuration
- Support web-search-prime (primary), Brave Search, and Tavily MCPs
- Case-insensitive detection of existing web search MCPs
- Block-websearch hook for optional native WebSearch blocking
Phase 2 - User Configuration:
- Add WebSearchConfig interface to unified-config-types.ts
- Add getWebSearchConfig() to unified-config-loader.ts
- Support configurable webSearchPrimeUrl for security
- Add GET/PUT /api/websearch endpoints in routes.ts
- Add WebSearch settings UI in settings.tsx dashboard
Phase 3 - Documentation & Testing:
- Add WebSearch section to README.md
- Create comprehensive docs/websearch.md guide
- Add 23 unit tests for MCP manager logic
Enables web search for gemini, codex, agy, qwen, glm, kimi profiles
that cannot access Anthropic's native WebSearch API.
2025-12-16 00:42:13 -05:00
kaitranntt
aeec394380
chore: remove docs submodule (moved to products/ccs/docs)
2025-12-13 01:23:36 -05:00
kaitranntt
8d46317cf6
docs: migrate to Mintlify docs submodule
...
- Add kaitranntt/ccs-docs as git submodule under docs/
- Update README links to point to docs.ccs.kaitran.ca
- Remove old local docs (migrated to Mintlify MDX format)
Phase 3 of README restructure complete.
2025-12-13 00:49:21 -05:00
kaitranntt
25741ac515
docs(readme): restructure with 3-pillars format and add screenshots
...
- reduce main README from ~1070 to ~250 lines
- add dashboard screenshots (analytics, api_profiles, cliproxy)
- update Vietnamese and Japanese translations to match new structure
- add light/dark theme analytics screenshots
2025-12-12 22:39:58 -05:00
kaitranntt
53259ce1c7
docs: update project documentation with recent features
2025-12-12 05:49:48 -05:00
kaitranntt
f255a20a93
feat(analytics): refactor model color management and fix UI display issues
...
- Extract getModelColor utility to lib/utils.ts with improved FNV-1a hash algorithm
- Replace hardcoded color palette with vibrant tones palette
- Remove color constants from model-breakdown-chart.tsx
- Fix truncated model names in analytics display
- Update project roadmap with analytics enhancements
2025-12-09 14:44:56 -05:00
kaitranntt
69e6a32224
perf(analytics): add cache pre-warming and SWR pattern for instant page load
...
- Add server-side cache pre-warming on startup (non-blocking)
- Implement stale-while-revalidate pattern (1hr stale window)
- Add /api/usage/status endpoint for cache status
- Remove full-page blocking skeleton, use per-component loading
- Add "Updated X ago" timestamp indicator in UI header
- Export AnalyticsSkeleton component for potential future use
2025-12-08 23:09:01 -05:00
kaitranntt
ffb6e066a7
refactor(ui): standardize page layout across all routes
...
Applied consistent centered layout (max-w-6xl mx-auto) from cliproxy page
to all pages except home page. Updated spacing to space-y-8 for uniformity.
2025-12-08 01:01:32 -05:00
kaitranntt
481570f7b2
docs: update documentation to reflect v2.0 architecture
...
- Fix README.md dashboard command (ccs config) and port info
- Update all documentation to reflect React 19 dashboard
- Document new tooling: Bun, Vite, semantic release
- Add TypeScript strict mode and type coverage details
- Update architecture with WebSocket and modern stack
- Revise project roadmap with current implementation status
2025-12-07 17:41:18 -05:00
kaitranntt
c8890f33c2
feat(ui): redesign sidebar and fix disclaimer
...
- Redesign AppSidebar with collapsible groups ("Identity & Access", "System")
- Nest "Shared Data" under "Accounts" in sidebar
- Add collapsible UI component for sidebar nesting
- Fix LocalhostDisclaimer by moving it inside SidebarProvider
- Add roadmap entry for sidebar redesign
2025-12-07 17:21:24 -05:00
semantic-release-bot and kaitranntt
bd46c8de12
fix(tests): migrate test suite from mocha to bun test runner
...
- Replace before()/after() with beforeAll()/afterAll()
- Remove this.timeout() calls (unsupported by bun)
- Update package.json scripts to use bun test
- Fix error message regex for cross-runtime compatibility
- Skip integration tests requiring network/child process mocking
- Format source files with prettier
2025-12-03 21:43:29 -05:00
kaitranntt
9f40a0e255
chore: rename integration branch from beta to dev
...
Update CI/CD configuration, documentation, and scripts to use dev as the
primary integration branch instead of beta. Changes include GitHub Actions
workflow triggers, semantic-release configuration, and all relevant
documentation and helper scripts.
2025-12-02 20:50:00 -05:00
kaitranntt
716193a682
feat(ui): enhance delegation with listr2 task lists and styled output
...
Phase 5 of CLI UI/UX Enhancement - Delegation + Listr2
Added Listr2 integration for enhanced delegation progress display:
- Intelligent renderer selection (TTY/CI/Claude Code context detection)
- Styled result boxes and tables using ui layer
- Graceful fallback chain: Listr2 → Spinners → Plain text
- All delegation formatters converted to async
Changes:
- src/utils/ui.ts: Added taskList wrapper, isClaudeCodeContext detection
- src/delegation/result-formatter.ts: Async formatting with styled boxes/tables
- src/delegation/delegation-handler.ts: Async format calls
- src/delegation/headless-executor.ts: UI layer progress messages
- tests: Updated all formatter tests to handle async
- docs: Enhanced code standards and codebase summary
All validation passing (157/157 tests)
Phase 5 complete - All 5 phases delivered
2025-12-01 20:53:04 -05:00
kaitranntt
6e49e0e7e1
feat(ui): add central ui abstraction layer for cli styling
...
- create src/utils/ui.ts with semantic colors, status indicators, boxes, tables, spinners
- add ui types (SemanticColor, BoxOptions, TableOptions, SpinnerOptions) to src/types/utils.ts
- add deprecation notice to src/utils/helpers.ts for legacy color functions
- add unit tests for ui module (11 test cases)
- install chalk@5.6.2, boxen@8.0.1, gradient-string@3.0.0
features:
- semantic color system (success, error, warning, info, primary, secondary)
- ascii-only status indicators: [OK], [X], [!], [i]
- tty-aware with NO_COLOR/FORCE_COLOR support
- styled boxes with boxen (round, double, bold borders)
- formatted tables with cli-table3
- animated spinners with ora (fallback to plain text in non-tty)
- gradient text for headers (cyan-to-blue)
- lazy esm module loading for chalk/boxen/gradient-string
2025-12-01 19:22:51 -05:00
kaitranntt
d3d96371de
feat(release): implement semantic versioning automation with conventional commits
...
- Add semantic-release for automated npm publishing
- Add commitlint + husky for commit message enforcement
- Add professional branching strategy (beta → main workflow)
- Create .releaserc.json with multi-branch config
- Create sync-version-plugin.cjs for VERSION file sync
- Update release.yml workflow (Node.js 22 required)
- Update CLAUDE.md and CONTRIBUTING.md with new workflow
- Deprecate manual bump-version.sh script
2025-11-30 18:56:02 -05:00
kaitranntt
72c2b08715
refactor: consolidate test structure and remove backup files
...
- Move ux-integration-test.sh to tests/integration/ directory
- Consolidate tests/fixtures/ into tests/shared/fixtures/
- Fix import paths in cli.test.js and postinstall.test.js
- Remove src/ccs.ts.backup file (958 lines)
- Remove empty src/scripts/ directory
- Remove non-existent test:edge-cases script from package.json
- Update tests/README.md with accurate structure
- Update CONTRIBUTING.md with correct test commands
- Update docs/system-architecture.md with correct test paths
2025-11-30 17:54:04 -05:00
kaitranntt
296d5661d0
docs: mark native shell installers as deprecated across all documentation
...
Phase 02 of "Deprecate Native Installers" plan:
Documentation updates (10 files, 3 languages):
- README.md: Mark curl/irm installers as deprecated in collapsed section
- docs/en/installation.md: Add deprecation warnings, emphasize npm as primary
- docs/en/troubleshooting.md: Add FAQ for deprecation warning users see
- docs/en/usage.md: Update uninstall to show npm first, legacy second
- docs/version-management.md: Strikethrough deprecated release checklist items
- docs/ja/README.md: Japanese deprecation notice
- docs/vi/README.md: Vietnamese deprecation notice
- docs/vi/installation.vi.md: Vietnamese installation deprecation
- docs/vi/troubleshooting.vi.md: Vietnamese troubleshooting deprecation
- src/commands/help-command.ts: npm as recommended uninstall method
Code quality:
- Fixed emoji violations: replaced ⚠️ with [!] per CLAUDE.md ASCII-only rule
- Consistent messaging across EN/JA/VI translations
- Updated codebase-summary.md with Phase 02 achievements
All documentation now consistently recommends:
npm install -g @kaitranntt/ccs
Legacy installers (curl/irm) show deprecation warning and auto-redirect
to npm installation when Node.js is available.
2025-11-28 02:39:48 -05:00
kaitranntt
32ce8cc711
refactor: modularize CCS architecture - Phase 02 complete
...
Split monolithic ccs.ts (1071 lines) into modular command handlers:
Main file reduction:
- ccs.ts: 1071 → 593 lines (44.6% reduction)
- Maintains routing logic + profile detection + GLMT proxy
New utility modules:
- src/utils/shell-executor.ts: Cross-platform shell execution
- src/utils/package-manager-detector.ts: Package manager detection
New command handlers:
- src/commands/version-command.ts: Version display
- src/commands/help-command.ts: Help text and usage
- src/commands/install-command.ts: Install/uninstall stubs
- src/commands/doctor-command.ts: Health checks
- src/commands/sync-command.ts: CCS synchronization
- src/commands/shell-completion-command.ts: Shell completion
Validation:
- 39/39 tests passing (100% success rate)
- TypeScript compilation: ✅ Zero errors
- ESLint: ✅ Zero violations
- Manual testing: ✅ All commands working
Code review: EXCELLENT rating, 0 critical issues, zero regressions
Tier1 plan: 2/2 phases complete - both ESLint strictness and
modular architecture successfully implemented.
2025-11-27 17:54:51 -05:00
kaitranntt
06fa724525
feat: upgrade ESLint strictness - Phase 01 complete
...
Enhance code quality by upgrading 3 TypeScript ESLint rules from warn → error:
- @typescript-eslint/no-unused-vars: warn → error
- @typescript-eslint/no-explicit-any: warn → error
- @typescript-eslint/no-non-null-assertion: warn → error
Results:
- Zero violations found across 10,487 lines of TypeScript code
- 39/39 tests passing with no regressions
- All validation gates pass (typecheck, lint, format, test)
- Code review: EXCELLENT rating, 0 critical issues
Updated documentation:
- docs/code-standards.md: ESLint Quality Gates section
- docs/project-roadmap.md: Phase 01 completion details
- Plan status updated: Phase 01 ✅ COMPLETED
Phase 01 of tier1-eslint-and-ccs-split plan complete.
Ready for Phase 02: CCS monolithic split (1071 → ~200 lines).
2025-11-27 17:23:43 -05:00
kaitranntt
046a37b2a9
feat: implement bootstrap conversion and installer updates (Phase 1-3)
...
Phase 1 - Bootstrap Scripts:
- Convert lib/ccs to 32-line bootstrap (was 1919 lines)
- Convert lib/ccs.ps1 to 39-line bootstrap (was 1826 lines)
- Delegate all functionality to Node.js via npx
Phase 2 - Help Text Updates:
- Add Requirements section to Node.js help (lines 172-175)
- Bootstrap scripts delegate --help to npx
Phase 3 - Installer Updates:
- Add Node.js 14+ detection with clear warning messages
- Remove deprecated shell deps (bootstrap handles all)
- Update completion messages with Requirements/First Run sections
- Update docs with new architecture
Total code reduction: 3745 → 71 lines (98.1%)
2025-11-27 10:24:37 -05:00
kaitranntt
77d026869e
fix(tsconfig): remove duplicate compiler options
...
- Remove duplicate allowSyntheticDefaultImports (lines 16 & 42)
- Remove duplicate skipLibCheck (lines 18 & 46)
- Add TypeScript source files for npm package migration
- Verify build pipeline works (42/42 tests pass)
2025-11-26 19:24:40 -05:00
kaitranntt
c4e5bcc40b
docs: reorganize translated README files into docs/ folder structure
2025-11-22 21:48:18 -05:00
kaitranntt
24a11e1051
refactor(delegation)!: consolidate commands with intelligent profile selection
...
BREAKING CHANGE: Replace 4 hardcoded commands with 2 intelligent commands:
- Old: /ccs:glm, /ccs:kimi, /ccs:glm:continue, /ccs:kimi:continue
- New: /ccs (auto-selects), /ccs:continue (auto-dects)
- Override with flags: /ccs --glm "task", /ccs --kimi "task"
This change:
- Adds intelligent profile selection based on task analysis
- Supports custom profiles without creating new commands
- Enhances session management with automatic profile detection
- Updates all help text, examples, and documentation
- Fixes CCS Doctor health checks for new command structure
2025-11-21 20:31:44 -05:00
kaitranntt
9ae99460bc
docs: update documentation to reflect v4.3.2 architecture and features
...
- Updated code-standards.md with v4.3.2 subsystem organization, delegation patterns, and symlinking standards
- Enhanced codebase-summary.md to document delegation system, selective .claude/ symlinking, and shell completion
- Revised project-overview-pdr.md with v4.3.2 capabilities, feature requirements, and architectural evolution
- Added comprehensive project-roadmap.md documenting version history and future plans
- Updated system-architecture.md with delegation architecture, symlinking strategy, and diagnostics infrastructure
- Added repomix-output.xml to .gitignore
2025-11-21 19:18:37 -05:00
kaitranntt
53dc2ed8c8
feat(delegation): Enhance CCS delegation with auto-activation and refined workflow
...
This commit refactors the CCS delegation mechanism to introduce auto-activation
for eligible tasks and clarifies the delegation workflow.
Key changes include:
- Removal of the dedicated `ccs-delegator` agent, as its functionality is
now integrated and managed by the `ccs-delegation` skill.
- `allowed-tools` declarations have been removed from `ccs:glm`, `ccs:kimi`,
and their `continue` commands, streamlining tool management under the skill.
- Introduction of `CLAUDE.md.template` for `ccs-delegation` to standardize
auto-delegation configuration.
- Significant updates to the `ccs-delegation` skill (`SKILL.md`),
including:
- Auto-activation based on task patterns (e.g., "fix typos", "add tests").
- Defined user invocation patterns for explicit delegation (e.g., "use ccs glm").
- Agent response protocol for validating, enhancing, and executing delegated tasks.
- Clearer decision framework and examples for delegation eligibility.
- Deletion of `references/README.md` and `references/delegation-guidelines.md`
as their content is now integrated or no longer relevant.
- Renaming `references/headless-workflow.md` to `docs/headless-workflow.md`
to better reflect its documentation nature.
- Modification of `references/troubleshooting.md` to align with the new structure.
These changes aim to make the delegation process more autonomous, user-friendly,
and robust by centralizing control within the `ccs-delegation` skill and
improving documentation organization.
2025-11-18 20:38:14 -05:00
Kai (Tam Nhu) Tran and GitHub
4df5a7d357
feat!: delegation system overhaul and .claude/ shipping (v4.1.0) ( #8 )
...
## 🚀 Release v4.1.0 - Major Update
**Breaking changes from v3.5.0**. This release includes the complete v4.0.0 delegation overhaul plus v4.1.0 architecture improvements.
---
## 🎯 v4.0.0: Delegation System Overhaul
**Complete rewrite of the delegation infrastructure with enhanced decision-making and streaming support.**
### New Delegation Features
**Stream-JSON Communication Protocol:**
- Real-time token streaming with `{type: "content", data: "..."}` format
- Progress indicators during delegation execution
- Clean separation: stdout for data, stderr for errors
- Handles tool calls, thinking blocks, and text content
**Enhanced Decision Framework:**
- `/ccs:glm` and `/ccs:kimi` slash commands with auto-enhancement
- `[AUTO ENHANCE]` prompts for better model understanding
- Context-aware task delegation with clear boundaries
- Continuation support: `/ccs:glm:continue` and `/ccs:kimi:continue`
**Robust Error Handling:**
- Graceful degradation when profiles unconfigured
- Clear error messages with actionable fixes
- Signal handling (SIGINT/SIGTERM) for clean child process termination
- Session state recovery on interruption
**Performance & Reliability:**
- Headless mode (`-p` flag) for background execution
- Slash command detection and auto-routing
- Validation system with `DelegationValidator`
- Profile readiness checks in `ccs --version`
### Delegation Components
**New Files:**
- `bin/delegation/delegation-handler.js` - Core delegation orchestrator
- `bin/delegation/stream-processor.js` - Real-time output handling
- `bin/utils/delegation-validator.js` - Profile validation
- `.claude/commands/ccs/*.md` - Slash command definitions
- `.claude/skills/ccs-delegation/` - AI decision framework
- `.claude/agents/ccs-delegator.md` - Proactive delegation agent
**Documentation:**
- Complete delegation workflows with mermaid diagrams
- Troubleshooting guides for common issues
- Headless execution patterns
---
## ✨ v4.1.0: Selective Symlinking Architecture
**Single source of truth for CCS items with automatic propagation.**
### New Architecture
**Ship .claude/ Directory:**
- CCS items now ship with npm/sh/ps1 packages
- Selective item-level symlinks: `~/.ccs/.claude/` → `~/.claude/`
- Auto-propagation on `npm update` - zero manual sync
- Backward compatible with existing `~/.ccs/shared/` mechanism
**Symlink Chain:**
```
~/.ccs/.claude/ (source)
↓ selective symlinks
~/.claude/ (CCS items installed here)
↑ symlinked by
~/.ccs/shared/
↑ symlinked by
profiles (work, personal, team)
```
### New Commands
**Maintenance Tools:**
- `ccs update` - Re-install CCS symlinks to ~/.claude/
- `ccs doctor` - Added Check 9: CCS symlinks health verification
**Safe Installation:**
- Automatic conflict backup before symlinking
- Idempotent operations (safe to run multiple times)
- Health monitoring and recovery
### New Components
- `bin/utils/claude-symlink-manager.js` - Manages selective symlinks
- Updated all 3 installers (npm postinstall, install.sh, install.ps1)
- Enhanced `ccs doctor` with symlink health checks
---
## 💥 Breaking Changes
**From v3.5.0 → v4.x:**
1. **Delegation commands moved**:
- Old: User manually created in `~/.claude/commands/`
- New: Auto-shipped in `~/.ccs/.claude/`, symlinked to `~/.claude/commands/ccs/`
2. **Slash command format**:
- New: `/ccs:glm`, `/ccs:kimi`, `/ccs:glm:continue`
- Old custom commands may need migration
3. **Profile validation**:
- Placeholders (`YOUR_API_KEY_HERE`) now detected and marked invalid
- Must configure real API keys for delegation to work
4. **Stream output format**:
- Headless mode (`-p`) now uses stream-JSON protocol
- Old text output replaced with structured `{type, data}` format
2025-11-16 06:31:55 -05:00
Kai (Tam Nhu) Tran and GitHub
f40e9647ec
feat(cli): comprehensive UX improvements for v3.5.0 ( #7 )
...
Implements 6-phase CLI UX improvement plan with comprehensive error handling,
interactive features, and cross-platform consistency.
### Added
- Shell auto-completion (bash, zsh, PowerShell, Fish)
- Error codes (E101-E901) with documentation URLs
- Fuzzy matching "Did you mean?" suggestions (Levenshtein distance)
- Progress indicators (doctor [n/9] counter, GLMT proxy spinner)
- Interactive confirmation prompts with --yes/-y automation flag
- JSON output format (--json) for auth commands
- Impact display (session count, paths) before destructive operations
- Comprehensive test suite (15 tests, 100% pass rate)
- Complete error documentation in docs/errors/
- Cross-platform `--shell-completion` command
### Changed
- Error boxes: Unicode (╔═╗) → ASCII (===) for compatibility
- JSON output uses CCS version instead of schema version
- Help text includes EXAMPLES section across platforms
- Test suite properly counts test cases (not assertions)
### Fixed
- --yes flag bug (returned false instead of true)
- Help text consistency (added Uninstall section to bash)
- Test pass rate calculation (excludes skipped tests)
- Help section comparison (locale-specific sort)
### Testing
- 13/13 tests passing (2 legitimately skipped)
- Cross-platform verified (Node.js, bash, PowerShell)
- All error codes documented and tested
2025-11-15 01:26:50 -05:00
kaitranntt
66e25b4cc9
refactor(glmt): remove deprecated environment variables
...
Remove references to deprecated CCS_GLMT_FORCE_ENGLISH, CCS_GLMT_THINKING_BUDGET, and CCS_GLMT_STREAMING environment variables that were removed in v3.4.3.
Changes:
- README.md: Update GLMT environment variable documentation to reflect current intelligent control system
- tests/unit/glmt/locale-enforcer.test.js: Remove outdated test scenario for removed environment variable
- docs/glmt-controls.md: Rewrite documentation to describe new automatic control mechanisms
The GLMT component now uses intelligent, automatic controls instead of manual environment variable configuration.
2025-11-11 22:10:56 -05:00
kaitranntt
5fae92ac07
feat(glmt): add streaming with real-time thinking blocks
...
- reorganize bin/ into auth/, glmt/, management/, utils/
- add budget calculator and locale enforcer
- enhance test coverage with unit/integration separation
2025-11-11 15:39:00 -05:00
kaitranntt
657f99bfe8
feat: add GLMT proxy and transformer tools
...
- Add GLMT proxy server for GLM model routing
- Add GLMT transformer for output format conversion
- Update CLI with new proxy and transformer commands
- Add comprehensive test suite for new functionality
- Update documentation and architecture guides
- Bump version and update changelog
2025-11-11 03:08:56 -05:00
kaitranntt
d925dfc169
feat(shared): implement shared data architecture (v3.1.0)
...
Phase 1: Multi-profile shared data via symlinks
Added:
- SharedManager class for symlink orchestration (bin/shared-manager.js)
- Auto-migration from ~/.claude/ to ~/.ccs/shared/ on first run
- Shared directories: commands/, skills/, agents/
- Windows fallback: copies dirs if symlinks fail
Fixed:
- Migration logic now detects empty directories
- Previously skipped migration when postinstall created empty dirs
- Now properly copies from ~/.claude/ when shared dirs are empty
Changed:
- Instance initialization symlinks to shared dirs instead of copying
- Postinstall creates ~/.ccs/shared/ structure automatically
- All implementations (Node.js, bash, PowerShell) updated for consistency
- Help text includes agents/ in shared data section
Technical:
- Profile-specific data remains isolated (settings, sessions, todolists, logs)
- Migration is idempotent: safe to run multiple times
- Cross-platform symlink support with graceful fallback
Closes #4
2025-11-10 20:45:21 -05:00
kaitranntt
96701a4992
docs: streamline READMEs and update project documentation
...
- Streamline Features section (65% shorter, bullet points only)
- Remove redundant 'Why CCS' table column
- Fix 'Sub-Account' → 'Multiple Accounts' terminology
- Update tagline to highlight v3.0 multi-account capabilities
- Merge duplicate sections (Concurrent Sessions)
- Remove unrealistic usage examples
- Fix weird formatting and stray content
- Streamline Uninstall section with package managers grouped
- Create root-level CONTRIBUTING.md (GitHub standard)
- Remove duplicate docs/en/contributing.md and docs/vi/contributing.vi.md
- Update all README links to point to root CONTRIBUTING.md
- Refactor CLAUDE.md for v3.0 architecture
- Update project overview to highlight multiple Claude accounts
- Add v3.0 technical details (CLAUDE_CONFIG_DIR, profiles.json, instances/)
- Remove redundant high-level flow (now in README)
- Add Node.js code standards
- Document two profile types (settings vs account-based)
- Update testing requirements for v3.0
Total reduction: 46 lines across all READMEs
Cross-language consistency: EN/VI/JA fully synchronized
2025-11-09 17:11:58 -05:00
kaitranntt
7b25d5d437
feat!: v3.0.0 simplification - login-per-profile model
...
BREAKING CHANGE: Remove vault/encryption, implement login-per-profile
- Remove vault-manager.js, credential-reader.js, credential-injector.js (~642 lines)
- Implement login-per-profile (no credential copying)
- Rename 'auth save' to 'auth create'
- Fix profile schema (remove vault/subscription/email fields)
- Remove macOS credential switcher (CLAUDE_CONFIG_DIR works everywhere)
- Auto-create missing instance directories
- Maintain GLM/Kimi backward compatibility (settings profiles)
Performance: 50-120ms faster (no decryption overhead)
Code reduction: ~600 lines deleted (40% simpler)
Migration required: Users must recreate profiles with 'ccs auth create'
2025-11-09 05:43:09 -05:00
kaitranntt
be958e992d
chore(docs): remove Vietnamese documentation and outdated development files
2025-11-06 07:01:20 -05:00
kaitranntt
2b35bf419f
chore: release v2.4.6 with improved npm compatibility and fixes
...
- fix color detection for cross-platform TTY compatibility
- enhance help command with npm-specific content and npx examples
- remove --install/--uninstall flags pending .claude/ integration testing
- update version across all files and documentation
- preserve implementation code for future release readiness
2025-11-05 16:51:30 -05:00
kaitranntt
966a43f0f9
chore: release v2.4.5 with comprehensive testing and documentation updates
2025-11-05 16:10:03 -05:00
kaitranntt
64925d57ca
checkpoint: before test restructure migration
2025-11-05 10:16:18 -05:00
kaitranntt
1a5ae615e3
docs: update npm package name from @kai/ccs to @kaitranntt/ccs
2025-11-04 23:25:36 -05:00
kaitranntt
c17e3e8e3b
feat(ccs): complete PowerShell 7+ fixes and Node.js standalone refactor
...
- Fix PowerShell 7 syntax errors (ampersand, pipe chars, regex patterns)
- Refactor bin/ccs.js to standalone Node.js implementation
- Add modular architecture (helpers, claude-detector, config-manager)
- Create comprehensive test suite with 95% coverage
- Add npm publishing workflow and documentation
- Enhance cross-platform compatibility and error handling
- Achieve 60% performance improvement over shell spawning
Breaking Change: Node.js npm package no longer spawns shell processes
2025-11-04 21:26:13 -05:00
kaitranntt
f21b3a6de1
feat(ccs): custom Claude CLI path support with CCS_CLAUDE_PATH
...
BREAKING CHANGE: None - fully backward compatible
Adds comprehensive custom path support for Claude CLI installations:
- CCS_CLAUDE_PATH environment variable for custom locations
- Smart detection: env var → PATH → common locations fallback
- Enhanced error messages with platform-specific solutions
- Security validation preventing command injection
- D drive Windows installation support
- WSL access to Windows installations
- Performance optimized (<15ms overhead)
- Complete documentation and troubleshooting guides
Technical implementation:
- Added detect_claude_cli() / Find-ClaudeCli functions
- Added validate_claude_cli() / Test-ClaudeCli security validation
- Updated both bash (ccs) and PowerShell (ccs.ps1) executables
- Fixed PowerShell multi-line string syntax errors with here-strings
- Updated all installation scripts and documentation
- Bumped version to v2.3.0
Tested across all platforms with 90% test suite pass rate.
Resolves D drive installation issues for Windows users.
2025-11-04 20:08:27 -05:00
kaitranntt
86b7d123a7
docs: redesign README with professional layout and logo assets
...
- Add professional badge styling and two-column HTML table header layout
- Reorganize sections: Quick Start → Why → Architecture Overview
- Remove Technology Stack section for cleaner content
- Add optimized logo assets (medium-sized and original)
- Implement matching improvements in Vietnamese README
- Maintain YAGNI/KISS/DRY philosophy while enhancing visual appeal
2025-11-04 13:54:05 -05:00
kaitranntt
88e6c9d604
fix(ccs): resolve uninstall functionality test failures
...
- Fix environment variable pattern (HOME vs USERPROFILE) in ccs.ps1
- Implement HOME-first pattern with USERPROFILE fallback for cross-platform compatibility
- Remove PowerShell Start-Process compatibility issues in test scripts
- Add comprehensive uninstall test suite (20 tests total)
- Achieve 100% test pass rate (previously 68.4% failure rate)
- Add testing requirements documentation
- Update project roadmap with completion status
- Production-ready with comprehensive code review approval (9.5/10)
Testing:
- All 20 uninstall tests passing
- Cross-platform compatibility verified
- Security review passed (0 vulnerabilities)
- Performance optimized (<1ms improvement)
2025-11-03 11:57:50 -05:00
kaitranntt
02f299686f
feat(installer): add auto PATH config for v2.2.0
...
- Auto shell detection (bash/zsh/fish) with PATH setup
- Unified ~/.local/bin install (no sudo required)
- ANSI colors with TTY detection, NO_COLOR support
- Security: fix shell injection, error handling
- Replace emojis with ASCII symbols
- Update 16 files: core(6), en-docs(6), vi-docs(4)
2025-11-03 01:32:37 -05:00
kaitranntt
613b92ce60
feat(ccs): add --install command for delegation features
...
- Add installation function for commands and skills
- Implement --install flag in both bash and PowerShell scripts
- Update documentation with installation instructions
- Add comprehensive test suites for installation functionality
- Refactor delegation command to simplify profile handling
- Remove haiku references, focus on GLM delegation model
- Update usage examples and documentation
2025-11-03 00:29:41 -05:00