@descix/cli 1.0.0 → 1.0.1

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@descix/cli",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "DeSciX CLI and MCP Server - Unified command-line interface for DeSciX platform",
   "type": "module",
   "main": "./bin/descix.js",
   "bin": {
-    "descix": "./bin/descix.js",
-    "descix-mcp": "./bin/mcp-server.js"
+    "descix": "bin/descix.js",
+    "descix-mcp": "bin/mcp-server.js"
   },
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1",
@@ -34,7 +34,14 @@
     "ora": "^9.0.0",
     "vite": "^6.2.0"
   },
-  "bundledDependencies": ["@descix/app-sdk", "@descix/sdk"],
+  "files": [
+    "bin",
+    "lib",
+    "templates",
+    "agent-assets",
+    "vendor",
+    "!**/node_modules"
+  ],
   "engines": {
     "node": ">=24.0.0"
   }

package/SERVICE_README_sdk.md

@@ -1,399 +0,0 @@
-# DeSciX SDK - CLI and MCP Tools
-
-## Overview
-
-The DeSciX SDK provides command-line tools and MCP (Model Context Protocol) integration for building applications on the DeSciX platform. The SDK enables developers to authenticate, manage workspaces, create apps, and leverage AI-assisted development through Cursor IDE integration.
-
-**Key capabilities:**
-- CLI commands for all platform operations
-- MCP server for Cursor IDE integration
-- Intelligent tool discovery via `tell_me_how`
-- Entitlements-driven workspace setup
-- Git-aware project initialization
-
----
-
-## Installation
-
-```bash
-# Global install (recommended)
-npm install -g @descix/cli
-
-# Or via npm link during development
-cd DeSciX_Core/descix-cli
-npm link
-```
-
----
-
-## CLI Commands
-
-### descix setup
-
-**Description:** One-time workspace configuration wizard
-**Use when:** First time setting up DeSciX in a new workspace or Cursor project
-**What it does:**
-1. Prompts for API endpoint (production/local/custom)
-2. Runs device authentication (opens browser)
-3. Creates `.cursor/mcp.json` for MCP server
-4. Creates `.cursor/rules/descix_mcp.mdc` for AI agent instructions
-5. Creates `.descix/workspace.json` with initial configuration
-
-**Example:**
-```bash
-cd ~/Projects/MyApp
-descix setup
-# Follow the prompts
-# Restart Cursor after completion
-```
-
----
-
-### descix login
-
-**Description:** Authenticate with the DeSciX platform
-**Use when:** Session expired or first-time authentication
-**Options:**
-- `--device` (default): Opens browser for Powch authentication
-- `--wallet`: Direct wallet signature authentication
-
-**Example:**
-```bash
-descix login
-# Opens browser, complete authentication
-# Credentials saved to .descix/wallet.json
-```
-
----
-
-### descix whoami
-
-**Description:** Display current authentication status
-**Use when:** Checking if you're logged in and what account you're using
-
-**Example:**
-```bash
-descix whoami
-# Output:
-# User: sam@descix.net
-# Wallet: 0xe71b412d...
-# Session: Valid
-```
-
----
-
-### descix tell-me-how
-
-**Description:** Discover platform tools using natural language
-**Use when:** You don't know which command to use for a task
-
-**Options:**
-- `--scope project`: Search within current workspace apps
-- `--scope entitlements`: Search apps you have access to (default)
-- `--scope discovery`: Search all platform tools
-- `--json`: Output raw JSON response
-
-**Examples:**
-```bash
-# Find how to create an app
-descix tell-me-how "How do I create a new app?"
-
-# Search within current project
-descix tell-me-how --scope project "How do I sync my knowledge base?"
-
-# Discover all available tools
-descix tell-me-how --scope discovery "What AI training tools exist?"
-```
-
----
-
-### descix app create
-
-**Description:** Create or hydrate an app using the interactive wizard
-**Use when:** Starting a new project or hydrating an existing app
-**Options:**
-- `-c, --community <id>`: Community ID
-- `-a, --app <name>`: App name
-- `--wizard`: Interactive wizard mode
-- `--quick`: Skip optional prompts
-
-**Note:** New apps should primarily be provisioned via the PWA. This command can hydrate a local workspace from an existing app or create a skeleton if permitted.
-
-**Example:**
-```bash
-# Interactive wizard
-descix app create --wizard
-```
-
----
-
-### descix kb
-
-**Description:** Manage Knowledge Base content (Git Mode)
-**Use when:** Processing KB documents locally
-
-**Subcommands:**
-- `pull`: Download source documents from Drive to `kb/src/`
-- `chunk`: Process source files into chunks in `kb/chunks/`
-- `sync`: Push chunks to the platform (Pinecone)
-- `build`: Run the full pipeline (Pull -> Chunk -> Sync)
-
-**Example:**
-```bash
-# Full build pipeline
-descix kb build -c descix -a myapp
-```
-
----
-
-### descix microservice vectorize
-
-**Description:** Vectorize a SERVICE_README for tell_me_how discovery
-**Use when:** Adding or updating service documentation
-**Options:**
-- `-n, --name <name>`: Service name
-- `-c, --community <id>`: Community ID
-- `-a, --app <id>`: App ID
-- `-r, --readme <path>`: Path to README file
-
-**Example:**
-```bash
-descix microservice vectorize -r ./SERVICE_README_myservice.md
-```
-
----
-
-### descix purchases
-
-**Description:** List your entitlements (communities, apps, service slots)
-**Use when:** Checking what resources you have access to
-
-**Example:**
-```bash
-descix purchases
-# Output shows communities, apps, and service slots
-```
-
----
-
-## MCP Tools (for Cursor AI)
-
-After running `descix setup` and restarting Cursor, these MCP tools are available to the AI agent:
-
-### tell_me_how
-
-**Description:** Primary discovery tool - finds relevant commands for any task
-**Use first:** Always use this before attempting platform operations
-
-```javascript
-tell_me_how({ 
-  question: "How do I deploy my app?",
-  scope: "entitlements"
-})
-```
-
-**Scope options:**
-- `project`: Uses `.descix/workspace.json` mappings
-- `entitlements`: Only tools you have access to (default)
-- `discovery`: All platform tools (may require purchase)
-
----
-
-### execute_remote_command
-
-**Description:** Execute any backend command discovered via tell_me_how
-**Use after:** tell_me_how returns recommended commands
-
-```javascript
-execute_remote_command({
-  command: "create_app",
-  params: {
-    community_id: "descix",
-    app_name: "My New App"
-  }
-})
-```
-
----
-
-### descix_init
-
-**Description:** Initialize a local project for DeSciX deployment
-**Use when:** Setting up a new project folder
-
-```javascript
-descix_init({
-  projectPath: "/Users/dev/Projects/MyApp",
-  appName: "my-app",
-  communityId: "descix"
-})
-```
-
-**Creates:**
-- `.descix/workspace.json` or `.descix/context.json`
-- `app_description.md` from README if missing
-- Folder structure for knowledge base
-
----
-
-### descix_wizard_step
-
-**Description:** Execute multi-step wizard workflows
-**Use when:** Creating apps, communities, or complex operations
-
-```javascript
-descix_wizard_step({
-  wizard_type: "create_app",
-  step: "init",
-  params: {
-    community_id: "descix",
-    app_name: "My App"
-  }
-})
-```
-
-**Wizard types:**
-- `create_app`: App creation with folder setup
-- `create_community`: Community creation with token
-- `publish_kb`: Knowledge base sync and publish
-
----
-
-### git_sync_ops
-
-**Description:** Git operations with auto-generated commit messages
-**Use when:** Committing changes, checking status
-
-```javascript
-git_sync_ops({
-  operation: "status",  // or "commit", "diff", "sync_info"
-  projectPath: "/Users/dev/Projects/MyApp"
-})
-```
-
----
-
-### search_knowledge_base
-
-**Description:** Search a specific knowledge base via RAG
-**Use when:** You know the exact KB to search
-
-```javascript
-search_knowledge_base({
-  communityId: "descix",
-  appId: "docs",
-  kbId: "sdk",
-  query: "How do I authenticate?"
-})
-```
-
----
-
-### chat_with_kb
-
-**Description:** Conversational RAG with knowledge base context
-**Use when:** Complex questions requiring AI reasoning
-
-```javascript
-chat_with_kb({
-  communityId: "descix",
-  appId: "docs",
-  kbId: "sdk",
-  message: "Explain the authentication flow step by step"
-})
-```
-
----
-
-## Workspace Configuration
-
-### workspace.json (Monorepo)
-
-For multi-app workspaces, create `.descix/workspace.json`:
-
-```json
-{
-  "version": "2.0",
-  "primaryCommunity": "descix",
-  "directoryMappings": {
-    "frontend": { "communityId": "descix", "appId": "pwa", "kbId": "General" },
-    "backend": { "communityId": "descix", "appId": "cloud", "kbId": "General" },
-    "docs": { "communityId": "descix", "appId": "docs", "kbId": "sdk" }
-  },
-  "defaultContext": {
-    "communityId": "descix",
-    "appId": "docs",
-    "kbId": "sdk"
-  }
-}
-```
-
-### context.json (Single App)
-
-For individual app folders, create `.descix/context.json`:
-
-```json
-{
-  "version": "2.0",
-  "type": "app",
-  "community_id": "descix",
-  "app_id": "myapp",
-  "app_name": "My Application",
-  "folders": {
-    "app": { "local_path": ".", "sync_type": "assets" },
-    "kb": { "local_path": "docs", "sync_type": "rag" }
-  }
-}
-```
-
----
-
-## Common Workflows
-
-### New Developer Onboarding (Cursor IDE)
-
-1. Install CLI: `npm install -g @descix/cli`
-2. Run setup: `descix setup`
-3. Restart Cursor (Cmd+Shift+P → "Reload Window")
-4. AI agent can now use MCP tools
-5. Ask: "How do I create an app?"
-6. AI uses `tell_me_how` → `execute_remote_command`
-
-### Entitlements-First App Creation
-
-1. AI calls `execute_remote_command({ command: "fetch_my_purchases" })`
-2. AI presents user's communities and apps
-3. User selects community (or creates new)
-4. AI calls `descix_wizard_step` for app creation
-5. AI creates local `.descix/context.json`
-
-### Monorepo Setup
-
-1. AI calls `fetch_my_purchases` to get entitlements
-2. AI scans workspace folders
-3. AI asks user: "Map `frontend/` to which app?"
-4. AI creates `.descix/workspace.json` with mappings
-5. `tell_me_how --scope project` now uses these mappings
-
----
-
-## Troubleshooting
-
-### "MCP tools not available"
-1. Run `descix setup` in workspace root
-2. Restart Cursor completely
-3. Check `.cursor/mcp.json` exists with `descix` server
-
-### "Session expired"
-Run `descix reconnect` or `descix login`
-
-### "No results from tell_me_how"
-Service READMEs may not be vectorized. Ask admin to run `descix microservice vectorize` for relevant services.
-
-### "workspace.json not found" for project scope
-Run `descix init` or let AI create workspace.json via `descix_init` MCP tool.
-
----
-
-*SDK Version: 2.0.0*
-*Package: @descix/cli*

package/test-hydration.js

@@ -1,150 +0,0 @@
-#!/usr/bin/env node
-/**
- * Test Drive Hydration
- */
-
-import { google } from 'googleapis';
-import GoogleStorage from './lib/google-storage-adc.js';
-import * as fs from 'fs/promises';
-import * as path from 'path';
-import { fileURLToPath } from 'url';
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const DRIVE_FOLDER_MIME = 'application/vnd.google-apps.folder';
-
-async function getAuth() {
-  return new google.auth.GoogleAuth({
-    scopes: ['https://www.googleapis.com/auth/drive', 'https://www.googleapis.com/auth/drive.file']
-  });
-}
-
-async function main() {
-  console.log('=== Drive Hydration Test ===\n');
-  
-  // Step 1: Verify ADC
-  console.log('1. Verifying ADC authentication...');
-  const user = await GoogleStorage.verifyDriveAuth();
-  console.log(`   ✓ Authenticated as: ${user.emailAddress}\n`);
-  
-  // Step 2: Find DeSciX base folder
-  console.log('2. Looking for DeSciX base folder...');
-  const auth = await getAuth();
-  const drive = google.drive({ version: 'v3', auth });
-  
-  const possibleNames = ['DeSciX', 'DeSciX_Apps', 'descix-apps', 'descix'];
-  let baseFolder = null;
-  
-  for (const name of possibleNames) {
-    const res = await drive.files.list({
-      q: `name='${name}' and mimeType='${DRIVE_FOLDER_MIME}' and trashed=false`,
-      fields: 'files(id, name)'
-    });
-    if (res.data.files?.length) {
-      baseFolder = res.data.files[0];
-      console.log(`   ✓ Found base folder: "${name}" (ID: ${baseFolder.id})\n`);
-      break;
-    }
-  }
-  
-  if (!baseFolder) {
-    console.log('   ✗ Could not find DeSciX base folder');
-    const rootRes = await drive.files.list({
-      q: `'root' in parents and mimeType='${DRIVE_FOLDER_MIME}' and trashed=false`,
-      fields: 'files(id, name)',
-      pageSize: 20
-    });
-    console.log('   Root folders:');
-    for (const f of rootRes.data.files || []) {
-      console.log(`     - ${f.name} (${f.id})`);
-    }
-    return;
-  }
-  
-  // Step 3: Find descix/agent
-  console.log('3. Locating descix/agent folder...');
-  const agentFolderId = await GoogleStorage.findFolderByPath(baseFolder.id, 'descix/agent');
-  
-  if (!agentFolderId) {
-    console.log('   ✗ Could not find descix/agent folder');
-    console.log('   Contents of base folder:');
-    const contents = await GoogleStorage.listFolderWithMeta(baseFolder.id);
-    for (const f of contents) {
-      console.log(`     - ${f.name} (${f.mimeType === DRIVE_FOLDER_MIME ? 'folder' : 'file'})`);
-    }
-    return;
-  }
-  
-  console.log(`   ✓ Found descix/agent folder (ID: ${agentFolderId})\n`);
-  
-  // Step 4: List contents
-  console.log('4. Contents of descix/agent in Drive:');
-  const agentContents = await GoogleStorage.listFolderWithMeta(agentFolderId);
-  for (const f of agentContents) {
-    const type = f.mimeType === DRIVE_FOLDER_MIME ? '📁' : '📄';
-    console.log(`   ${type} ${f.name}`);
-    
-    // List subfolders
-    if (f.mimeType === DRIVE_FOLDER_MIME) {
-      const subContents = await GoogleStorage.listFolderWithMeta(f.id);
-      for (const sf of subContents) {
-        const subType = sf.mimeType === DRIVE_FOLDER_MIME ? '📁' : '📄';
-        console.log(`     ${subType} ${sf.name}`);
-      }
-    }
-  }
-  console.log('');
-  
-  // Step 5: Pull content using the new downloadFileFromDrive function
-  const targetDir = '/Users/essam/Documents/Code/DaitaERC20/descix/agent';
-  console.log(`5. Pulling content to ${targetDir}...`);
-  
-  const pullRecursive = async (localPath, folderId, indent = '  ') => {
-    await fs.mkdir(localPath, { recursive: true });
-    const files = await GoogleStorage.listFolderWithMeta(folderId);
-    let count = 0;
-    
-    for (const file of files) {
-      const targetPath = path.join(localPath, file.name);
-      
-      if (file.mimeType === DRIVE_FOLDER_MIME) {
-        console.log(`${indent}📁 ${file.name}/`);
-        count += await pullRecursive(targetPath, file.id, indent + '  ');
-      } else {
-        console.log(`${indent}📄 Downloading: ${file.name}`);
-        await GoogleStorage.downloadFileFromDrive(file.id, targetPath);
-        count++;
-      }
-    }
-    return count;
-  };
-  
-  const downloaded = await pullRecursive(targetDir, agentFolderId);
-  console.log(`\n   ✓ Downloaded ${downloaded} files\n`);
-  
-  // Step 6: Verify
-  console.log('6. Verifying local content:');
-  const verifyDir = async (dir, indent = '') => {
-    try {
-      const entries = await fs.readdir(dir, { withFileTypes: true });
-      for (const e of entries) {
-        const type = e.isDirectory() ? '📁' : '📄';
-        console.log(`   ${indent}${type} ${e.name}`);
-        if (e.isDirectory()) {
-          await verifyDir(path.join(dir, e.name), indent + '  ');
-        }
-      }
-    } catch {
-      console.log(`   ${indent}(empty)`);
-    }
-  };
-  await verifyDir(targetDir);
-  
-  console.log('\n=== Test Complete ===');
-  console.log(`\nBase folder ID for workspace.json: ${baseFolder.id}`);
-}
-
-main().catch(err => {
-  console.error('Error:', err.message);
-  console.error(err.stack);
-  process.exit(1);
-});