@hapico/cli

Hapico CLI Orchestrator

Hapico CLI is a high-performance development lifecycle tool engineered for the com.ai.vn ecosystem. It bridges the gap between local high-fidelity development and cloud-native execution, leveraging binary-compressed synchronization and neural-enhanced code intelligence.

🛠 Core Architecture

• Stateful Sync Engine: Utilizes WebSockets with Pako (Zlib) compression for ultra-low latency differential state synchronization.
• Neural Orchestration (vibe): Integrated AI agent capable of contextual project analysis and non-destructive refactoring.
• Cross-Platform Bridge: Unified pipeline supporting Web (React), Mobile (Expo/React Native), and Zalo Mini App ecosystems.
• Atomic Deployment: Guarantees consistency across main projects and distributed replicas through transactional push-to-publish cycles.

📦 Rapid Deployment

Bootstrap your environment globally via your preferred package manager:

npm install -g @hapico/cli
# - or -
yarn global add @hapico/cli

🎮 Command Specification

1. Identity & Security

Command	Capability	Implementation
hapico login	Device Authorization	Initiates OAuth2 Device Flow (RFC 8628). Stores encrypted tokens in local secure context.
hapico logout	Session Termination	Revokes local authorization state and flushes cache.

2. Workspace Provisioning

hapico clone <project_id>

Provision a new workspace. This command performs a three-stage initialization:

• Metadata Discovery: Resolves project architecture and type.
• Template Injection: Hydrates the local environment with standardized scaffolds.
• State Recovery: Synchronizes the latest production and draft source files via binary decompression.

hapico pull

Synchronizes the local src directory with the upstream server state. Essential for multi-agent collaboration and IDE parity.

3. Continuous Integration & Delivery

hapico push

Triggers a delta-update to the remote server.

• Orchestrates multi-target sync for all Replicas defined in hapico.config.json.
• Transpiles and synchronizes critical root-level assets (.env, package.json, tsconfig.json).

hapico publish

Executes an atomic Push + Build + Deploy sequence. This ensures that the code currently in your local buffer is the exact version promoted to production across all primary and replica endpoints.

4. Development & Intelligence

hapico dev [--zversion <v>]

Spawns the local development runtime:

• Hot-Reload Watcher: Monitors filesystem I/O and streams updates via binary WebSocket packets.
• Dynamic Previews:
  • Web: Instant browser orchestration.
  • Mobile: Real-time QR generation for Expo Go and Zalo testing environments.
• NativeWind JIT: Integrated Just-In-Time compilation for Tailwind-based mobile styling.

hapico vibe

The Neural Intelligence interface. It injects an AI agent into your local context to perform high-order refactoring, logic optimization, and feature synthesis based on the current project's AST.

hapico mirror

Generates an LLM-optimized context snapshot (hapico_files.txt). This aggregates the entire codebase into a single formatted stream for feeding into Large Language Models.

⚙️ Infrastructure Configuration

Project behavior is governed by hapico.config.json at the root level:

{
  "projectId": "12345",
  "replicate": ["67890", "11223"]
}

• projectId: The authoritative UUID for the primary cloud container.
• replicate: A vector of IDs for automated mirroring during deployment cycles.

📂 System Topology

Hapico mandates a strict, high-efficiency directory structure:

• /src: Authoritative source code container (TSX/JSX/CSS).
• .env*: Context-aware environment variables (synced securely).
• nativewind.json: Styling configuration for mobile runtimes.

🌐 Preview Matrix

Runtime Environment	Protocol	Access Method
Enterprise Web	HTTP/S	Browser Orchestration
Expo (Native)	exp://	Expo Go QR Code
Zalo Mini App	zalo://	Zalo Player QR Code

⚖️ Proprietary Notice

Copyright © 2024 COM.AI.VN. Engineered for professionals who demand low-latency, AI-augmented development workflows.