@descix/cli 1.0.1 → 1.0.4

package/lib/commands/folder.js

@@ -1,291 +0,0 @@
-/**
- * Folder Commands - Drive Folder Management
- * 
- * Commands for managing Drive folder IDs for entities:
- *   descix folder set --user/--community/--app/--kb <folder-id>
- *   descix folder get --user/--community/--app/--kb
- *   descix folder allocate --app/--kb
- *   descix folder validate <folder-id>
- */
-
-import chalk from 'chalk';
-import ora from 'ora';
-import { DeSciXApiClient } from '../api-client.js';
-import { requireAuth } from '../auth-guard.js';
-import { GlobalConfig } from '../global-config.js';
-
-/**
- * Extract folder ID from Drive URL or return as-is
- */
-function extractFolderId(input) {
-  if (!input) return null;
-  
-  const trimmed = input.trim();
-  
-  // Handle full URLs
-  if (trimmed.includes('drive.google.com')) {
-    const foldersMatch = trimmed.match(/\/folders\/([a-zA-Z0-9_-]+)/);
-    if (foldersMatch && foldersMatch[1]) return foldersMatch[1];
-    
-    const dMatch = trimmed.match(/\/d\/([a-zA-Z0-9_-]+)/);
-    if (dMatch && dMatch[1]) return dMatch[1];
-    
-    const idMatch = trimmed.match(/[?&]id=([a-zA-Z0-9_-]+)/);
-    if (idMatch && idMatch[1]) return idMatch[1];
-  }
-  
-  return trimmed;
-}
-
-/**
- * Set folder ID for an entity
- */
-export async function setFolder(options) {
-  const apiClient = new DeSciXApiClient();
-  await requireAuth(apiClient);
-  
-  const spinner = ora('Setting folder...').start();
-  
-  try {
-    let entityType, entityIds, folderId;
-    
-    if (options.user) {
-      entityType = 'user';
-      folderId = extractFolderId(options.user);
-    } else if (options.community) {
-      entityType = 'community';
-      entityIds = { community_id: options.community };
-      folderId = extractFolderId(options.folderId);
-    } else if (options.app) {
-      entityType = 'app';
-      // Parse "community app" format
-      const parts = options.app.split(/\s+/);
-      if (parts.length < 2) {
-        throw new Error('App requires both community and app ID: --app "community app"');
-      }
-      entityIds = { community_id: parts[0], app_id: parts[1] };
-      folderId = extractFolderId(options.folderId);
-    } else if (options.kb) {
-      entityType = 'kb';
-      // Parse "community app kb" format
-      const parts = options.kb.split(/\s+/);
-      if (parts.length < 3) {
-        throw new Error('KB requires community, app, and kb ID: --kb "community app kb"');
-      }
-      entityIds = { community_id: parts[0], app_id: parts[1], kb_id: parts[2] };
-      folderId = extractFolderId(options.folderId);
-    } else {
-      throw new Error('Specify entity type: --user, --community, --app, or --kb');
-    }
-    
-    if (!folderId) {
-      throw new Error('Folder ID is required');
-    }
-    
-    const response = await apiClient.invoke('set_folder_id', {
-      entity_type: entityType,
-      entity_ids: entityIds,
-      folder_id: folderId
-    });
-    
-    const result = response.message || response;
-    
-    spinner.succeed('Folder set successfully');
-    
-    console.log(chalk.green(`\n✓ ${result.message}`));
-    console.log(chalk.gray(`  Entity: ${entityType}`));
-    console.log(chalk.gray(`  Folder: ${folderId}`));
-    console.log(chalk.cyan(`  URL: https://drive.google.com/drive/folders/${folderId}\n`));
-    
-    // Update global config if setting user folder
-    if (entityType === 'user') {
-      const globalConfig = await GlobalConfig.load();
-      globalConfig.user_base_folder_id = folderId;
-      globalConfig.registered_at = new Date().toISOString();
-      await globalConfig.save();
-    }
-    
-    return result;
-    
-  } catch (error) {
-    spinner.fail('Failed to set folder');
-    console.error(chalk.red(`\n❌ ${error.message}\n`));
-    throw error;
-  }
-}
-
-/**
- * Get folder info for an entity
- */
-export async function getFolder(options) {
-  const apiClient = new DeSciXApiClient();
-  await requireAuth(apiClient);
-  
-  const spinner = ora('Getting folder info...').start();
-  
-  try {
-    let entityType, entityIds;
-    
-    if (options.user) {
-      entityType = 'user';
-    } else if (options.community) {
-      entityType = 'community';
-      entityIds = { community_id: options.community };
-    } else if (options.app) {
-      entityType = 'app';
-      const parts = options.app.split(/\s+/);
-      if (parts.length < 2) {
-        throw new Error('App requires both community and app ID: --app "community app"');
-      }
-      entityIds = { community_id: parts[0], app_id: parts[1] };
-    } else if (options.kb) {
-      entityType = 'kb';
-      const parts = options.kb.split(/\s+/);
-      if (parts.length < 3) {
-        throw new Error('KB requires community, app, and kb ID: --kb "community app kb"');
-      }
-      entityIds = { community_id: parts[0], app_id: parts[1], kb_id: parts[2] };
-    } else {
-      throw new Error('Specify entity type: --user, --community, --app, or --kb');
-    }
-    
-    const response = await apiClient.invoke('get_folder_info', {
-      entity_type: entityType,
-      entity_ids: entityIds
-    });
-    
-    const result = response.message || response;
-    
-    spinner.succeed('Folder info retrieved');
-    
-    console.log(chalk.cyan(`\n📁 Folder Info: ${entityType}\n`));
-    
-    if (result.has_folder) {
-      console.log(chalk.green(`  ✓ Folder registered`));
-      console.log(chalk.white(`    ID: ${result.folder_id}`));
-      if (result.folder_name) {
-        console.log(chalk.white(`    Name: ${result.folder_name}`));
-      }
-      if (result.kb_folder_id) {
-        console.log(chalk.white(`    KB Folder: ${result.kb_folder_id}`));
-      }
-      console.log(chalk.cyan(`    URL: https://drive.google.com/drive/folders/${result.folder_id}`));
-    } else {
-      console.log(chalk.yellow(`  ⚠ No folder registered`));
-      console.log(chalk.gray(`    Use 'descix folder set' to register a folder`));
-    }
-    
-    console.log('');
-    return result;
-    
-  } catch (error) {
-    spinner.fail('Failed to get folder info');
-    console.error(chalk.red(`\n❌ ${error.message}\n`));
-    throw error;
-  }
-}
-
-/**
- * Allocate a new folder for an entity
- */
-export async function allocateFolder(options) {
-  const apiClient = new DeSciXApiClient();
-  await requireAuth(apiClient);
-  
-  const spinner = ora('Allocating folder...').start();
-  
-  try {
-    let entityType, entityIds, folderName;
-    
-    if (options.app) {
-      entityType = 'app';
-      const parts = options.app.split(/\s+/);
-      if (parts.length < 2) {
-        throw new Error('App requires both community and app ID: --app "community app"');
-      }
-      entityIds = { community_id: parts[0], app_id: parts[1] };
-      folderName = options.name || `${parts[0]}_${parts[1]}`;
-    } else if (options.kb) {
-      entityType = 'kb';
-      const parts = options.kb.split(/\s+/);
-      if (parts.length < 3) {
-        throw new Error('KB requires community, app, and kb ID: --kb "community app kb"');
-      }
-      entityIds = { community_id: parts[0], app_id: parts[1], kb_id: parts[2] };
-      folderName = options.name || parts[2];
-    } else {
-      throw new Error('Specify entity type: --app or --kb');
-    }
-    
-    const response = await apiClient.invoke('allocate_folder', {
-      entity_type: entityType,
-      entity_ids: entityIds,
-      folder_name: folderName
-    });
-    
-    const result = response.message || response;
-    
-    spinner.succeed('Folder allocated successfully');
-    
-    console.log(chalk.green(`\n✓ New folder created`));
-    console.log(chalk.white(`  Name: ${result.folder_name}`));
-    console.log(chalk.white(`  ID: ${result.folder_id}`));
-    console.log(chalk.cyan(`  URL: ${result.drive_url}\n`));
-    
-    return result;
-    
-  } catch (error) {
-    spinner.fail('Failed to allocate folder');
-    console.error(chalk.red(`\n❌ ${error.message}\n`));
-    throw error;
-  }
-}
-
-/**
- * Validate folder access
- */
-export async function validateFolder(folderId, options = {}) {
-  const apiClient = new DeSciXApiClient();
-  await requireAuth(apiClient);
-  
-  const spinner = ora('Validating folder...').start();
-  
-  try {
-    const parsedFolderId = extractFolderId(folderId);
-    
-    if (!parsedFolderId) {
-      throw new Error('Folder ID is required');
-    }
-    
-    const response = await apiClient.invoke('validate_folder_access', {
-      folder_id: parsedFolderId
-    });
-    
-    const result = response.message || response;
-    
-    if (result.accessible) {
-      spinner.succeed('Folder is accessible');
-      console.log(chalk.green(`\n✓ ${result.message}`));
-      console.log(chalk.white(`  Name: ${result.folder_name}`));
-      console.log(chalk.white(`  ID: ${parsedFolderId}`));
-      console.log(chalk.cyan(`  URL: https://drive.google.com/drive/folders/${parsedFolderId}\n`));
-    } else {
-      spinner.fail('Folder not accessible');
-      console.log(chalk.red(`\n❌ ${result.message}\n`));
-    }
-    
-    return result;
-    
-  } catch (error) {
-    spinner.fail('Validation failed');
-    console.error(chalk.red(`\n❌ ${error.message}\n`));
-    throw error;
-  }
-}
-
-export default {
-  setFolder,
-  getFolder,
-  allocateFolder,
-  validateFolder
-};

package/lib/core/PathContext.js

@@ -1,335 +0,0 @@
-/**
- * PathContext - Unified filesystem context for DeSciX CLI
- * 
- * Design principle: No "finding" after setup.
- * - Setup time: Detect IDE markers, persist absolute paths to workspace.json
- * - Runtime: Load workspace.json, all paths are simple lookups
- * 
- * The workspace.json is the single source of truth for all paths.
- */
-
-import * as fs from 'fs/promises';
-import * as path from 'path';
-
-/**
- * Find IDE workspace root by searching for .cursor/ or .vscode/ markers
- * This is the only "searching" allowed - IDE markers are guaranteed in Cursor/VSCode
- * 
- * @param {string} startDir - Directory to start searching from
- * @returns {Promise<string|null>} Workspace root path, or null if not in IDE workspace
- */
-export async function findIDEMarker(startDir = process.cwd()) {
-  let currentDir = path.resolve(startDir);
-  const root = path.parse(currentDir).root;
-  
-  // Only look for IDE markers (not .descix - that's created by setup)
-  const ideMarkers = ['.cursor', '.vscode'];
-  
-  while (currentDir !== root) {
-    for (const marker of ideMarkers) {
-      const markerDir = path.join(currentDir, marker);
-      try {
-        const stat = await fs.stat(markerDir);
-        if (stat.isDirectory()) {
-          return currentDir;
-        }
-      } catch {
-        // Marker not found, continue
-      }
-    }
-    
-    const parentDir = path.dirname(currentDir);
-    if (parentDir === currentDir) break;
-    currentDir = parentDir;
-  }
-  
-  return null;
-}
-
-/**
- * PathContext - Unified path resolution from workspace.json
- * 
- * All paths come from workspace.json - no runtime "finding" of app contexts.
- */
-export class PathContext {
-  /**
-   * @param {string} workspaceRoot - Absolute path to workspace root
-   * @param {Object} config - Parsed workspace.json contents
-   */
-  constructor(workspaceRoot, config) {
-    this.workspaceRoot = workspaceRoot;
-    this.config = config;
-  }
-
-  /**
-   * Load PathContext from workspace.json
-   * 
-   * @param {string} startDir - Directory to start searching from (default: cwd)
-   * @returns {Promise<PathContext>} Loaded context
-   * @throws {Error} If not in IDE workspace or workspace not configured
-   */
-  static async load(startDir = process.cwd()) {
-    // Find IDE marker (only .cursor/ or .vscode/)
-    const wsRoot = await findIDEMarker(startDir);
-    if (!wsRoot) {
-      throw new Error(
-        'Not in a Cursor/VSCode workspace.\n' +
-        'Open this folder in Cursor or VSCode first.'
-      );
-    }
-    
-    // Load workspace.json
-    const configPath = path.join(wsRoot, '.descix', 'workspace.json');
-    let configData;
-    try {
-      const content = await fs.readFile(configPath, 'utf-8');
-      configData = JSON.parse(content);
-    } catch (error) {
-      throw new Error(
-        'Workspace not configured.\n' +
-        'Run "npx descix init" first to configure your workspace.'
-      );
-    }
-    
-    return new PathContext(wsRoot, configData);
-  }
-
-  /**
-   * Try to load PathContext, return null if not configured
-   * Useful for commands that need to check if workspace exists
-   * 
-   * @param {string} startDir - Directory to start searching from
-   * @returns {Promise<PathContext|null>}
-   */
-  static async tryLoad(startDir = process.cwd()) {
-    try {
-      return await PathContext.load(startDir);
-    } catch {
-      return null;
-    }
-  }
-
-  // ============ Path Getters (all from workspace.json) ============
-
-  /**
-   * Get workspace root path
-   * @returns {string} Absolute path to workspace root
-   */
-  getWorkspaceRoot() {
-    return this.config.workspaceRoot || this.workspaceRoot;
-  }
-
-  /**
-   * Get community path
-   * @param {string} communityId - Community identifier
-   * @returns {string|null} Absolute path to community folder, or null if not found
-   */
-  getCommunityPath(communityId) {
-    const community = this.config.communities?.[communityId];
-    if (!community) return null;
-    
-    // Use absolutePath if available, otherwise compute from localPath
-    if (community.absolutePath) {
-      return community.absolutePath;
-    }
-    if (community.localPath) {
-      return path.join(this.getWorkspaceRoot(), community.localPath);
-    }
-    return null;
-  }
-
-  /**
-   * Get app path
-   * @param {string} communityId - Community identifier
-   * @param {string} appId - App identifier
-   * @returns {string|null} Absolute path to app folder, or null if not found
-   */
-  getAppPath(communityId, appId) {
-    const app = this.config.communities?.[communityId]?.apps?.[appId];
-    if (!app) return null;
-    
-    // Use absolutePath if available, otherwise compute from localPath
-    if (app.absolutePath) {
-      return app.absolutePath;
-    }
-    if (app.localPath) {
-      return path.join(this.getWorkspaceRoot(), app.localPath);
-    }
-    return null;
-  }
-
-  /**
-   * Get KB path
-   * @param {string} communityId - Community identifier
-   * @param {string} appId - App identifier
-   * @param {string} kbId - KB identifier (default: 'General')
-   * @returns {string|null} Absolute path to KB folder, or null if app not found
-   */
-  getKbPath(communityId, appId, kbId = 'General') {
-    const appPath = this.getAppPath(communityId, appId);
-    return appPath ? path.join(appPath, 'kb', kbId) : null;
-  }
-
-  /**
-   * Get site path
-   * @param {string} communityId - Community identifier
-   * @param {string} appId - App identifier
-   * @returns {string|null} Absolute path to site folder, or null if app not found
-   */
-  getSitePath(communityId, appId) {
-    const appPath = this.getAppPath(communityId, appId);
-    return appPath ? path.join(appPath, 'site') : null;
-  }
-
-  /**
-   * Get microservice path
-   * @param {string} communityId - Community identifier
-   * @param {string} appId - App identifier
-   * @returns {string|null} Absolute path to microservice folder, or null if app not found
-   */
-  getMicroservicePath(communityId, appId) {
-    const appPath = this.getAppPath(communityId, appId);
-    return appPath ? path.join(appPath, 'microservice') : null;
-  }
-
-  // ============ Context Detection (match cwd against known paths) ============
-
-  /**
-   * Detect community/app context from current working directory
-   * Matches cwd against known absolutePaths in workspace.json
-   * 
-   * @returns {{ communityId: string, appId: string, kbId: string }|null}
-   */
-  detectContext() {
-    const cwd = process.cwd();
-    
-    for (const [commId, comm] of Object.entries(this.config.communities || {})) {
-      for (const [appId, app] of Object.entries(comm.apps || {})) {
-        const appPath = app.absolutePath || 
-          (app.localPath ? path.join(this.getWorkspaceRoot(), app.localPath) : null);
-        
-        if (appPath && cwd.startsWith(appPath)) {
-          return {
-            communityId: commId,
-            appId,
-            kbId: app.kbId || 'General'
-          };
-        }
-      }
-    }
-    
-    return null;
-  }
-
-  /**
-   * Resolve context by merging CLI options with detected context
-   * CLI options take priority over detected context
-   * 
-   * @param {Object} options - CLI options { community, app, kb }
-   * @returns {{ communityId: string|null, appId: string|null, kbId: string }}
-   */
-  resolveContext(options = {}) {
-    const detected = this.detectContext();
-    
-    const resolved = {
-      communityId: options.community || detected?.communityId || null,
-      appId: options.app || detected?.appId || null,
-      kbId: options.kb || detected?.kbId || 'General'
-    };
-    
-    return resolved;
-  }
-
-  /**
-   * Resolve context and throw if community/app not determined
-   * 
-   * @param {Object} options - CLI options { community, app, kb }
-   * @returns {{ communityId: string, appId: string, kbId: string }}
-   * @throws {Error} If community or app cannot be determined
-   */
-  requireContext(options = {}) {
-    const ctx = this.resolveContext(options);
-    
-    if (!ctx.communityId || !ctx.appId) {
-      throw new Error(
-        'Could not determine app context.\n\n' +
-        'Options:\n' +
-        '  1. cd into an app directory\n' +
-        '  2. Use flags: -c <community> -a <app>\n\n' +
-        'Example: npx descix kb build -c descix -a appsdk'
-      );
-    }
-    
-    return ctx;
-  }
-
-  // ============ Config Access ============
-
-  /**
-   * Get raw workspace.json config
-   * @returns {Object}
-   */
-  getWorkspaceConfig() {
-    return this.config;
-  }
-
-  /**
-   * Get Drive configuration
-   * @returns {{ base_folder_id: string }|null}
-   */
-  getDriveConfig() {
-    return this.config.driveConfig || null;
-  }
-
-  /**
-   * Get API URL
-   * Derives from env.platform.microservice.port in DEV mode (v2.1 workspace format).
-   * @returns {string}
-   */
-  getApiUrl() {
-    if (this.config.apiUrl) return this.config.apiUrl;
-    const env = this.config.env || {};
-    const platformPort = env.platform?.microservice?.port;
-    if (platformPort && env.environment === 'DEV') return `https://localhost:${platformPort}`;
-    return 'https://descix.net';
-  }
-
-  /**
-   * Get environment
-   * @returns {string}
-   */
-  getEnvironment() {
-    return this.config.environment || 'production';
-  }
-
-  // ============ Listing ============
-
-  /**
-   * List all community IDs
-   * @returns {string[]}
-   */
-  listCommunities() {
-    return Object.keys(this.config.communities || {});
-  }
-
-  /**
-   * List all app IDs (optionally filtered by community)
-   * @param {string} communityId - Optional community filter
-   * @returns {Array<{ communityId: string, appId: string }>}
-   */
-  listApps(communityId = null) {
-    const apps = [];
-    
-    for (const [commId, comm] of Object.entries(this.config.communities || {})) {
-      if (communityId && commId !== communityId) continue;
-      
-      for (const appId of Object.keys(comm.apps || {})) {
-        apps.push({ communityId: commId, appId });
-      }
-    }
-    
-    return apps;
-  }
-}
-
-export default PathContext;

package/templates/scaffolds/microservice/dev-overrides.json.example

@@ -1,5 +0,0 @@
-# Local dev overrides - DO NOT COMMIT
-# Rename to dev-overrides.json
-{
-    "SERVICE_SECRET": "local-dev-secret"
-}

package/templates/scaffolds/site/DeSciXAppSDK.js

@@ -1,62 +0,0 @@
-/**
- * DeSciXAppSDK.js (V2 - App Shell Edition)
- * 
- * A thin wrapper for CodeSites and ChatWidgets running within the DeSciX PWA.
- * Leverages Same-Origin interframe scripting to provide direct access to
- * PWA helpers and the backend API.
- */
-
-window.DeSciX = (() => {
-    const isEmbedded = window.top !== window;
-    
-    // Check for same-origin access
-    const hasParentAccess = () => {
-        try {
-            return isEmbedded && !!window.top.DeSciX;
-        } catch (e) {
-            return false;
-        }
-    };
-
-    if (!hasParentAccess()) {
-        console.warn('[DeSciX SDK] Running in standalone mode or cross-origin. Direct PWA helpers unavailable.');
-        return {
-            mode: 'standalone',
-            call: async (command, params) => {
-                throw new Error('SDK not initialized in PWA App Shell mode.');
-            }
-        };
-    }
-
-    console.log('[DeSciX SDK] Initialized in App Shell mode.');
-
-    // Proxy to the PWA's global DeSciX object
-    return {
-        mode: 'shell',
-        
-        /**
-         * Access to global application data (Communities, Apps, User Profile)
-         */
-        get AppData() { return window.top.DeSciX.AppData; },
-
-        /**
-         * Access to the PWA state machine and navigation
-         */
-        get AppContext() { return window.top.DeSciX.AppContext; },
-
-        /**
-         * Direct API call helper (proxied through PWA session)
-         */
-        call: (command, params) => window.top.DeSciX.call(command, params),
-
-        /**
-         * Chat interaction helpers
-         */
-        Chat: {
-            suggestPrompt: (text) => {
-                // Future: trigger text injection into ChatWidget
-                console.log('[DeSciX SDK] Suggesting prompt:', text);
-            }
-        }
-    };
-})();