cntx-ui 1.0.9 → 2.0.0

package/README.md

@@ -1,135 +1 @@
-# cntx-ui
-
-> File bundling and tagging tool for AI development workflows
-
-Cntx helps developers organize, tag, and bundle their codebase files for AI tools like ChatGPT, Claude, and Cursor. Create structured bundles with semantic tags to provide better context to AI systems.
-
-## ✨ Features
-
-- 📁 **Direct File System Access** - Work with your files without uploads
-- 🏷️ **Smart Tagging System** - Organize files with semantic tags
-- 📦 **Bundle Creation** - Package files for AI consumption with metadata
-- 🔍 **Bundle Analysis** - Track file changes and staleness over time
-- 🎯 **Master Bundles** - Create snapshots to track project evolution
-- 🎨 **Modern Interface** - Clean, responsive web UI
-- ⚡ **Real-time Updates** - Watch for file changes automatically
-
-## 🚀 Quick Start
-
-```bash
-npx cntx-ui
-```
-
-That's it! Cntx will start a local server and open in your browser.
-
-## 📋 Requirements
-
-- **Node.js 16+**
-- **Chromium-based browser** (Chrome, Edge, Opera, Brave)
-  - Firefox and Safari don't support File System Access API yet
-
-## 🎯 How to Use
-
-### 1. Initialize Your Project
-
-1. Run `npx cntx-ui`
-2. Click "Select Directory" and choose your project folder
-3. Initialize the project (creates a `.cntx` folder with configuration)
-
-### 2. Organize with Tags
-
-- Use the **Tags** tab to create semantic tags (e.g., "core", "ui-components", "utilities")
-- Tag files using the paint brush icon in the file tree
-- Tags help categorize files by their role in your project
-
-### 3. Create Bundles
-
-- Select files in the directory tree (checkbox selection)
-- Click "Bundle" to create a package for AI tools
-- Bundles include file content, metadata, and your tag organization
-
-### 4. Master Bundles
-
-- Create a "Master Bundle" to snapshot your entire project
-- Use this as a reference point to track which files have changed
-- Perfect for providing complete project context to AI tools
-
-### 5. Bundle Analysis
-
-- View bundle freshness and file staleness
-- See which files have changed since the last bundle
-- Analyze tag distribution and file types
-
-## 🔧 Browser Compatibility
-
-Cntx uses the [File System Access API](https://developer.mozilla.org/en-US/docs/Web/API/File_System_API), which requires:
-
-- ✅ Chrome 86+
-- ✅ Edge 86+
-- ✅ Opera 72+
-- ✅ Other Chromium-based browsers
-- ❌ Firefox (not yet supported)
-- ❌ Safari (not yet supported)
-
-## 📁 Project Structure
-
-When you initialize a project, Cntx creates a `.cntx` folder:
-
-```
-your-project/
-├── .cntx/
-│   ├── config/
-│   │   ├── tags.ts          # Tag definitions
-│   │   └── pattern-ignore.ts # Files to ignore
-│   ├── bundles/             # Regular bundles
-│   │   └── master/          # Master bundles
-│   └── state/
-│       └── file.json        # File tracking state
-└── your-code-files...
-```
-
-## 🤖 AI Integration
-
-Cntx bundles are designed for AI tools:
-
-- **Structured XML format** with file metadata
-- **Directory tree visualization**
-- **Tag-based organization** for context
-- **Change tracking** to highlight recent modifications
-- **Ignore patterns** to exclude irrelevant files
-
-## 💡 Tips
-
-- **Tag Strategy**: Use tags like "core", "ui-components", "utilities", "configuration"
-- **Ignore Patterns**: Configure patterns to exclude `node_modules`, build files, etc.
-- **Master Bundles**: Create these periodically to track project evolution
-- **File Selection**: Use Shift+click for range selection in the file tree
-
-## 🐛 Troubleshooting
-
-**"No files found"**
-
-- Check your ignore patterns in the Config tab
-- Ensure you're using a supported browser
-
-**"Failed to access directory"**
-
-- Grant file system permissions when prompted
-- Try refreshing and re-selecting the directory
-
-**Bundle creation fails**
-
-- Ensure files are staged (selected with checkboxes)
-- Check browser console for detailed errors
-
-## 📄 License
-
-MIT
-
-## 🤝 Contributing
-
-See [DEVELOPMENT.md](./DEVELOPMENT.md) for local development setup.
-
----
-
-**Made for AI-powered development workflows** 🤖✨
+# Test Project

package/bin/cntx-ui.js

@@ -0,0 +1,51 @@
+#!/usr/bin/env node
+
+import { startServer, generateBundle, initConfig, getStatus } from '../server.js';
+
+const args = process.argv.slice(2);
+const command = args[0] || 'watch';
+
+// Graceful shutdown
+process.on('SIGINT', () => {
+  console.log('\n👋 Shutting down cntx-ui...');
+  process.exit(0);
+});
+
+switch (command) {
+  case 'watch':
+    const port = parseInt(args[1]) || 3333;
+    startServer({ port });
+    break;
+
+  case 'bundle':
+    const bundleName = args[1] || 'master';
+    try {
+      generateBundle(bundleName);
+      console.log(`✅ Bundle '${bundleName}' generated`);
+    } catch (e) {
+      console.error(`❌ Bundle '${bundleName}' not found`);
+    }
+    break;
+
+  case 'init':
+    initConfig();
+    break;
+
+  case 'status':
+    getStatus();
+    break;
+
+  default:
+    console.log(`cntx-ui v2.0.0
+        
+Usage:
+  cntx-ui init                Initialize configuration
+  cntx-ui watch [port]        Start API server (default port: 3333)
+  cntx-ui bundle [name]       Generate specific bundle (default: master)
+  cntx-ui status              Show current status
+  
+Examples:
+  cntx-ui init
+  cntx-ui watch 8080
+  cntx-ui bundle api`);
+}

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "cntx-ui",
   "type": "module",
-  "version": "1.0.9",
-  "description": "File bundling and tagging tool for AI development",
+  "version": "2.0.0",
+  "description": "Minimal file bundling and tagging tool for AI development",
   "keywords": [
     "ai",
     "bundling",
@@ -14,77 +14,30 @@
     "type": "git",
     "url": "git+https://github.com/nothingdao/cntx-ui.git"
   },
-  "homepage": "https://github.com/nothingdao/cntx-ui#readme",
-  "bugs": {
-    "url": "https://github.com/nothingdao/cntx-ui/issues"
-  },
   "author": "whaleen",
   "license": "MIT",
   "bin": {
-    "cntx-ui": "./bin/cntx.cjs"
+    "cntx-ui": "./bin/cntx-ui.js"
   },
   "files": [
-    "dist",
-    "bin",
-    "README.md"
+    "bin/cntx-ui.js",
+    "server.js",
+    "README.md",
+    "web/dist"
   ],
   "engines": {
-    "node": ">=16.0.0"
+    "node": ">=18.0.0"
   },
   "scripts": {
-    "dev": "vite",
-    "build": "vite build",
-    "build-with-types": "tsc -b && vite build",
-    "lint": "eslint .",
-    "preview": "vite preview",
-    "prepare": "npm run build",
-    "start": "node bin/cntx.js"
+    "dev": "node server.js",
+    "build": "cd web && npm install && npm run build",
+    "build:web": "cd web && npm install && npm run build",
+    "dev:web": "cd web && npm run dev",
+    "prebuild": "npm run build:web",
+    "prepublishOnly": "npm run build:web",
+    "test:local": "npm pack && npm install -g ./cntx-ui-2.0.0.tgz"
   },
   "dependencies": {
-    "@radix-ui/react-alert-dialog": "^1.1.4",
-    "@radix-ui/react-avatar": "^1.1.2",
-    "@radix-ui/react-checkbox": "^1.1.3",
-    "@radix-ui/react-dialog": "^1.1.4",
-    "@radix-ui/react-dropdown-menu": "^2.1.4",
-    "@radix-ui/react-label": "^2.1.7",
-    "@radix-ui/react-popover": "^1.1.14",
-    "@radix-ui/react-progress": "^1.1.7",
-    "@radix-ui/react-scroll-area": "^1.2.2",
-    "@radix-ui/react-select": "^2.1.4",
-    "@radix-ui/react-separator": "^1.1.7",
-    "@radix-ui/react-slot": "^1.1.1",
-    "@radix-ui/react-switch": "^1.2.5",
-    "@radix-ui/react-tabs": "^1.1.2",
-    "@radix-ui/react-tooltip": "^1.1.6",
-    "@tanstack/react-query": "^5.62.8",
-    "class-variance-authority": "^0.7.1",
-    "clsx": "^2.1.1",
-    "console-feed": "^3.6.0",
-    "dotenv": "^16.4.7",
-    "express": "^4.18.2",
-    "lucide-react": "^0.469.0",
-    "open": "^8.4.2",
-    "react": "^18.3.1",
-    "react-dom": "^18.3.1",
-    "simple-git": "^3.27.0",
-    "tailwind-merge": "^2.5.5",
-    "tailwindcss-animate": "^1.0.7",
-    "zustand": "^5.0.2"
-  },
-  "devDependencies": {
-    "@eslint/js": "^9.17.0",
-    "@types/react": "^18.3.17",
-    "@types/react-dom": "^18.3.5",
-    "@vitejs/plugin-react": "^4.3.4",
-    "autoprefixer": "^10.4.20",
-    "eslint": "^9.17.0",
-    "eslint-plugin-react-hooks": "^5.0.0",
-    "eslint-plugin-react-refresh": "^0.4.16",
-    "globals": "^15.13.0",
-    "postcss": "^8.4.49",
-    "tailwindcss": "^3.4.17",
-    "typescript": "~5.6.2",
-    "typescript-eslint": "^8.18.1",
-    "vite": "5.4.2"
+    "ws": "^8.13.0"
   }
 }