@contextium/cli 0.3.0

package/README.md

@@ -0,0 +1,227 @@
+# Contextium CLI
+
+Command-line interface for Contextium that allows developers to fetch and pipe documentation to external AI tools.
+
+## Installation
+
+```bash
+# Build the CLI
+npm run build
+
+# Link for local development
+npm link
+```
+
+## Setup
+
+### 1. Initialize a Project
+
+```bash
+# Navigate to your project directory
+cd /path/to/your/project
+
+# Initialize Contextium with your workspace and project
+contextium init \
+  --api-key YOUR_API_KEY \
+  --workspace your-workspace-slug \
+  --project your-project-slug \
+  --api-url http://localhost:3001/api/v1
+
+# Or use environment variable for API key
+export CONTEXTIUM_API_KEY=your_api_key
+contextium init --workspace your-workspace-slug --project your-project-slug
+```
+
+This creates:
+- `.contextiumrc` - Configuration file
+- `.contextium-cache/` - Local cache directory
+- Updates `.gitignore` to exclude cache directory
+
+### 2. Sync Files
+
+Download all project files to local cache:
+
+```bash
+# Sync all files
+contextium sync
+
+# Sync specific files
+contextium sync README.md API_GUIDE.md
+
+# Sync files with specific tags
+contextium sync --tag foundation-context --tag always-include
+
+# Force re-download all files
+contextium sync --force
+
+# Dry run to see what would be synced
+contextium sync --dry-run
+```
+
+## Usage
+
+### Check Status
+
+Check which files are cached and up-to-date:
+
+```bash
+contextium status
+```
+
+Output:
+```
+Project: My Project
+Project ID: abc-123
+Workspace: my-workspace
+
+✓ README.md v3 (up to date)
+↓ API_GUIDE.md v2 (v5 available, 3 versions behind)
+? SETUP.md (not cached)
+
+2 file(s) need update - run 'contextium sync'
+1 file(s) not cached - run 'contextium sync'
+```
+
+### Output File Content
+
+Output file content to stdout for piping to AI tools:
+
+```bash
+# Output all files
+contextium cat --all
+
+# Output specific files
+contextium cat README.md API_GUIDE.md
+
+# Output files with specific tags
+contextium cat --tag always-include
+
+# Include metadata headers
+contextium cat --all --with-meta
+
+# Output as JSON
+contextium cat --all --format json
+```
+
+### Pipe to External AI Tools
+
+The primary use case - pipe documentation to AI tools like Cursor, Claude, or Copilot:
+
+```bash
+# Pipe all documentation to clipboard
+contextium cat --all | pbcopy
+
+# Pipe to Cursor
+contextium cat --all | cursor --add-context
+
+# Pipe foundation docs to Claude
+contextium cat --tag foundation-context | claude --context
+
+# Pipe specific files
+contextium cat README.md API_GUIDE.md | cursor --add-context
+```
+
+### Search Files
+
+Search for files in your project:
+
+```bash
+# Search by filename or content
+contextium search "authentication"
+
+# Search with tag filter
+contextium search "api" --tag backend
+
+# Limit results
+contextium search "guide" --limit 5
+```
+
+## Configuration
+
+The `.contextiumrc` file contains your project configuration:
+
+```json
+{
+  "api_key": "your-api-key",
+  "api_url": "http://localhost:3001/api/v1",
+  "project_id": "project-uuid",
+  "workspace": "workspace-slug",
+  "cache": {
+    "enabled": true,
+    "ttl": 3600,
+    "directory": ".contextium-cache",
+    "max_size_mb": 100
+  },
+  "sync": {
+    "auto": true,
+    "on_command": ["build", "test"],
+    "notify_changes": true,
+    "interval": 300
+  },
+  "files": {
+    "include": [],
+    "exclude": ["DEPRECATED_*.md", "DRAFT_*.md"],
+    "tags": ["foundation-context", "always-include"],
+    "auto_include_tags": true
+  }
+}
+```
+
+## Workflow Example
+
+```bash
+# 1. Initialize in your project
+cd ~/projects/my-app
+contextium init --workspace my-company --project my-app
+
+# 2. Sync all documentation
+contextium sync
+
+# 3. Start coding with AI assistance
+# Pipe all relevant docs to your AI tool
+contextium cat --tag always-include | cursor --add-context
+
+# 4. Update when docs change
+contextium status  # Check for updates
+contextium sync    # Download latest versions
+```
+
+## Cache Management
+
+The CLI caches files locally for faster access:
+
+- Cache directory: `.contextium-cache/`
+- TTL: 1 hour (configurable)
+- Auto-syncs based on configuration
+- Use `--no-cache` flag to bypass cache
+
+## Development
+
+```bash
+# Build
+npm run build
+
+# Watch mode
+npm run dev
+
+# Type check
+npm run type-check
+```
+
+## Architecture
+
+The CLI is designed to be a lightweight bridge between your Contextium documentation repository and external AI coding tools:
+
+```
+Your Project
+    ↓
+Contextium CLI (fetch docs)
+    ↓
+Local Cache (.contextium-cache/)
+    ↓
+Pipe to AI Tool (Cursor, Claude, Copilot)
+    ↓
+AI-assisted Development
+```
+
+For more information, see the [Platform Specification](../../Resources/CONTEXTHUB_PLATFORM_SPEC.md).

package/dist/commands/cat.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const catCommand: Command;
+//# sourceMappingURL=cat.d.ts.map

package/dist/commands/cat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cat.d.ts","sourceRoot":"","sources":["../../src/commands/cat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAOnC,eAAO,MAAM,UAAU,SAkLnB,CAAA"}

package/dist/commands/cat.js

@@ -0,0 +1,153 @@
+import { Command } from 'commander';
+import { ApiClient } from '../lib/api-client.js';
+import { loadConfig } from '../lib/config.js';
+import { Cache } from '../lib/cache.js';
+import { chalk } from '../lib/output.js';
+export const catCommand = new Command('cat')
+    .description('Output file content to stdout')
+    .argument('[files...]', 'File names to output')
+    .option('--all', 'Output all files (requires --workspace)')
+    .option('--workspace <slug>', 'Specify workspace to search in')
+    .option('--tag <tags...>', 'Filter by tags')
+    .option('--with-meta', 'Include metadata header')
+    .option('--format <format>', 'Output format (text|json)', 'text')
+    .option('--no-cache', 'Skip cache')
+    .action(async (files, options) => {
+    try {
+        const config = await loadConfig();
+        const client = new ApiClient(config.api_key, config.api_url);
+        const cache = new Cache(config.cache);
+        // Resolve workspace
+        let workspaceId;
+        if (options.workspace) {
+            const { data: workspacesData } = await client.get('/workspaces');
+            const workspaces = workspacesData.data || workspacesData;
+            const workspace = workspaces.find((w) => w.slug === options.workspace);
+            if (!workspace) {
+                console.error(chalk.red(`Error: Workspace '${options.workspace}' not found`));
+                process.exit(1);
+            }
+            workspaceId = workspace.id;
+        }
+        else if (config.workspace_id) {
+            workspaceId = config.workspace_id;
+        }
+        // For --all and --tag options, workspace is required
+        if ((options.all || options.tag) && !workspaceId) {
+            console.error(chalk.red('Error: --all and --tag options require a workspace'));
+            console.error(chalk.dim('Either set a default workspace or use --workspace <slug>'));
+            process.exit(1);
+        }
+        let filesToFetch = [];
+        if (options.all) {
+            // Fetch all files from workspace
+            const { data: workspacesData } = await client.get('/workspaces');
+            const workspaces = workspacesData.data || workspacesData;
+            const workspace = workspaces.find((w) => w.id === workspaceId);
+            const { data: projectsData } = await client.get(`/workspaces/${workspace.id}/projects`);
+            const projects = projectsData.data || projectsData;
+            for (const project of projects) {
+                const { data } = await client.get(`/projects/${project.id}/files`);
+                filesToFetch.push(...data.map((f) => f.title));
+            }
+        }
+        else if (options.tag && options.tag.length > 0) {
+            // Fetch by tags from workspace
+            const { data: projectsData } = await client.get(`/workspaces/${workspaceId}/projects`);
+            const projects = projectsData.data || projectsData;
+            for (const project of projects) {
+                const { data } = await client.get(`/projects/${project.id}/files`, { params: { tags: options.tag.join(',') } });
+                filesToFetch.push(...data.map((f) => f.title));
+            }
+        }
+        else if (files.length > 0) {
+            filesToFetch = files;
+        }
+        else {
+            console.error(chalk.red('Error: No files specified'));
+            console.error(chalk.dim('Usage: contextium cat <files...> or --all'));
+            process.exit(1);
+        }
+        // Fetch file contents
+        const results = [];
+        for (const fileName of filesToFetch) {
+            // Try cache first
+            if (options.cache !== false) {
+                const cached = await cache.get(fileName);
+                if (cached && cached.content) {
+                    results.push(cached);
+                    continue;
+                }
+            }
+            // Search across all workspaces if no default is set
+            let file;
+            if (workspaceId) {
+                // Search in specific workspace
+                const { data: projectsData } = await client.get(`/workspaces/${workspaceId}/projects`);
+                const projects = projectsData.data || projectsData;
+                for (const project of projects) {
+                    const { data: filesResponse } = await client.get(`/projects/${project.id}/files`, { params: { search: fileName } });
+                    file = filesResponse.find((f) => f.title === fileName || f.path === fileName);
+                    if (file)
+                        break;
+                }
+            }
+            else {
+                // Search across all workspaces
+                const { data: workspacesData } = await client.get('/workspaces');
+                const workspaces = workspacesData.data || workspacesData;
+                for (const workspace of workspaces) {
+                    const { data: projectsData } = await client.get(`/workspaces/${workspace.id}/projects`);
+                    const projects = projectsData.data || projectsData;
+                    for (const project of projects) {
+                        const { data: filesResponse } = await client.get(`/projects/${project.id}/files`, { params: { search: fileName } });
+                        file = filesResponse.find((f) => f.title === fileName || f.path === fileName);
+                        if (file)
+                            break;
+                    }
+                    if (file)
+                        break;
+                }
+            }
+            if (!file) {
+                console.error(chalk.yellow(`Warning: File not found: ${fileName}`));
+                continue;
+            }
+            // Get full file content
+            const { data: fileData } = await client.get(`/files/${file.id}`);
+            results.push(fileData.data || fileData);
+            // Cache it
+            if (options.cache !== false) {
+                await cache.set(fileName, fileData.data || fileData);
+            }
+        }
+        // Output
+        if (options.format === 'json') {
+            console.log(JSON.stringify(results, null, 2));
+        }
+        else {
+            for (const file of results) {
+                if (options.withMeta) {
+                    console.log(chalk.gray('---'));
+                    console.log(chalk.gray(`file: ${file.title}`));
+                    console.log(chalk.gray(`version: ${file.currentVersion}`));
+                    console.log(chalk.gray(`project_id: ${file.projectId}`));
+                    console.log(chalk.gray(`last_updated: ${file.updatedAt}`));
+                    console.log(chalk.gray('---'));
+                    console.log();
+                }
+                console.log(file.content);
+                if (results.length > 1 && !options.withMeta) {
+                    console.log();
+                    console.log(chalk.dim('─'.repeat(60)));
+                    console.log();
+                }
+            }
+        }
+    }
+    catch (error) {
+        console.error(chalk.red('Error:'), error.message);
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=cat.js.map

package/dist/commands/cat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cat.js","sourceRoot":"","sources":["../../src/commands/cat.ts"],"names":[],"mappings":"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"}

package/dist/commands/files.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const filesCommand: Command;
+//# sourceMappingURL=files.d.ts.map

package/dist/commands/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/commands/files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAMnC,eAAO,MAAM,YAAY,SAiJrB,CAAA"}

package/dist/commands/files.js

@@ -0,0 +1,121 @@
+import { Command } from 'commander';
+import { ApiClient } from '../lib/api-client.js';
+import { loadConfig } from '../lib/config.js';
+import { chalk, ora } from '../lib/output.js';
+export const filesCommand = new Command('files')
+    .description('List files in a project with pagination')
+    .argument('<project>', 'Project name or slug')
+    .option('--workspace <slug>', 'Specify workspace (required if project name is ambiguous)')
+    .option('--page <number>', 'Page number', '1')
+    .option('--limit <number>', 'Items per page', '20')
+    .action(async (projectName, options) => {
+    const spinner = ora('Loading files...').start();
+    try {
+        const config = await loadConfig();
+        const client = new ApiClient(config.api_key, config.api_url);
+        const page = parseInt(options.page);
+        const limit = parseInt(options.limit);
+        if (page < 1) {
+            spinner.fail('Page number must be >= 1');
+            process.exit(1);
+        }
+        // Get workspaces to search
+        const { data: workspacesData } = await client.get('/workspaces');
+        const workspaces = workspacesData.data || workspacesData;
+        let workspacesToSearch = workspaces;
+        if (options.workspace) {
+            const workspace = workspaces.find((w) => w.slug.toLowerCase() === options.workspace.toLowerCase() ||
+                w.name.toLowerCase() === options.workspace.toLowerCase());
+            if (!workspace) {
+                spinner.fail(`Workspace '${options.workspace}' not found`);
+                process.exit(1);
+            }
+            workspacesToSearch = [workspace];
+        }
+        // Find project by name or slug (case-insensitive)
+        let foundProject = null;
+        let foundWorkspace = null;
+        const matchingProjects = [];
+        for (const workspace of workspacesToSearch) {
+            const { data: projectsData } = await client.get(`/workspaces/${workspace.id}/projects`);
+            const projects = projectsData.data || projectsData;
+            for (const project of projects) {
+                if (project.deletedAt)
+                    continue;
+                if (project.slug.toLowerCase().trim() === projectName.toLowerCase().trim() ||
+                    project.name.toLowerCase().trim() === projectName.toLowerCase().trim()) {
+                    matchingProjects.push({ project, workspace });
+                }
+            }
+        }
+        if (matchingProjects.length === 0) {
+            spinner.fail(`Project '${projectName}' not found`);
+            process.exit(1);
+        }
+        if (matchingProjects.length > 1) {
+            spinner.fail(`Multiple projects found with name '${projectName}'`);
+            console.log();
+            console.log(chalk.dim('Please specify a workspace:'));
+            matchingProjects.forEach(({ project, workspace }) => {
+                console.log(chalk.dim(`  - ${project.name} in ${workspace.name} (--workspace ${workspace.slug})`));
+            });
+            process.exit(1);
+        }
+        const match = matchingProjects[0];
+        foundProject = match.project;
+        foundWorkspace = match.workspace;
+        // Get files in project
+        const { data: filesData } = await client.get(`/projects/${match.project.id}/files`);
+        const allFiles = filesData.data || filesData;
+        const activeFiles = allFiles.filter((f) => !f.deletedAt);
+        if (activeFiles.length === 0) {
+            spinner.stop();
+            console.log(chalk.yellow(`\nNo files found in project '${foundProject.name}'`));
+            return;
+        }
+        // Sort by updated date (newest first)
+        activeFiles.sort((a, b) => new Date(b.updatedAt).getTime() - new Date(a.updatedAt).getTime());
+        // Paginate
+        const totalFiles = activeFiles.length;
+        const totalPages = Math.ceil(totalFiles / limit);
+        const startIndex = (page - 1) * limit;
+        const endIndex = Math.min(startIndex + limit, totalFiles);
+        const pageFiles = activeFiles.slice(startIndex, endIndex);
+        spinner.stop();
+        console.log(chalk.bold(`\nFiles in '${foundProject.name}' (${foundWorkspace.name}):`));
+        console.log(chalk.dim(`Page ${page} of ${totalPages} (${totalFiles} total files)\n`));
+        for (let i = 0; i < pageFiles.length; i++) {
+            const file = pageFiles[i];
+            const itemNumber = startIndex + i + 1;
+            const updatedDate = new Date(file.updatedAt);
+            const now = new Date();
+            const diffMs = now.getTime() - updatedDate.getTime();
+            const diffHours = Math.floor(diffMs / (1000 * 60 * 60));
+            const diffDays = Math.floor(diffHours / 24);
+            let timeAgo;
+            if (diffHours < 1)
+                timeAgo = 'just now';
+            else if (diffHours < 24)
+                timeAgo = `${diffHours}h ago`;
+            else if (diffDays < 7)
+                timeAgo = `${diffDays}d ago`;
+            else
+                timeAgo = updatedDate.toLocaleDateString();
+            console.log(chalk.gray(`${itemNumber}.`), chalk.white(file.title), chalk.dim(`(v${file.currentVersion}, ${timeAgo})`));
+        }
+        console.log();
+        if (totalPages > 1) {
+            if (page < totalPages) {
+                console.log(chalk.dim(`Next page: contextium files "${projectName}" --page ${page + 1}`));
+            }
+            if (page > 1) {
+                console.log(chalk.dim(`Previous page: contextium files "${projectName}" --page ${page - 1}`));
+            }
+        }
+    }
+    catch (error) {
+        spinner.fail(`Failed to load files: ${error.message}`);
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=files.js.map

package/dist/commands/files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../../src/commands/files.ts"],"names":[],"mappings":"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"}

package/dist/commands/find.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const findCommand: Command;
+//# sourceMappingURL=find.d.ts.map

package/dist/commands/find.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find.d.ts","sourceRoot":"","sources":["../../src/commands/find.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAMnC,eAAO,MAAM,WAAW,SA0IpB,CAAA"}

package/dist/commands/find.js

@@ -0,0 +1,119 @@
+import { Command } from 'commander';
+import { ApiClient } from '../lib/api-client.js';
+import { loadConfig } from '../lib/config.js';
+import { chalk, ora } from '../lib/output.js';
+export const findCommand = new Command('find')
+    .description('Find files by name (partial match, no extension needed)')
+    .argument('<filename>', 'File name or partial name to search for')
+    .option('--workspace <slug>', 'Limit search to specific workspace')
+    .action(async (filename, options) => {
+    const spinner = ora('Searching for files...').start();
+    try {
+        const config = await loadConfig();
+        const client = new ApiClient(config.api_key, config.api_url);
+        // Normalize search query (lowercase, trim)
+        const searchQuery = filename.toLowerCase().trim();
+        // Get workspaces to search
+        const { data: workspacesData } = await client.get('/workspaces');
+        const workspaces = workspacesData.data || workspacesData;
+        let workspacesToSearch = workspaces;
+        if (options.workspace) {
+            const workspace = workspaces.find((w) => w.slug.toLowerCase() === options.workspace.toLowerCase() ||
+                w.name.toLowerCase() === options.workspace.toLowerCase());
+            if (!workspace) {
+                spinner.fail(`Workspace '${options.workspace}' not found`);
+                process.exit(1);
+            }
+            workspacesToSearch = [workspace];
+        }
+        // Search for files across all workspaces/projects
+        const matchingFiles = [];
+        for (const workspace of workspacesToSearch) {
+            const { data: projectsData } = await client.get(`/workspaces/${workspace.id}/projects`);
+            const projects = projectsData.data || projectsData;
+            for (const project of projects) {
+                if (project.deletedAt)
+                    continue;
+                const { data: filesData } = await client.get(`/projects/${project.id}/files`);
+                const files = filesData.data || filesData;
+                for (const file of files) {
+                    if (file.deletedAt)
+                        continue;
+                    // Smart matching: case-insensitive, partial match on title or path
+                    const fileTitle = file.title.toLowerCase();
+                    const filePath = file.path.toLowerCase();
+                    // Remove extension from file title for matching
+                    const titleWithoutExt = fileTitle.replace(/\.[^/.]+$/, '');
+                    if (fileTitle.includes(searchQuery) ||
+                        titleWithoutExt.includes(searchQuery) ||
+                        filePath.includes(searchQuery)) {
+                        matchingFiles.push({ file, project, workspace });
+                    }
+                }
+            }
+        }
+        spinner.stop();
+        if (matchingFiles.length === 0) {
+            console.log(chalk.yellow(`\nNo files found matching '${filename}'`));
+            return;
+        }
+        // Sort by relevance (exact match first, then by updated date)
+        matchingFiles.sort((a, b) => {
+            const aTitle = a.file.title.toLowerCase();
+            const bTitle = b.file.title.toLowerCase();
+            const aTitleNoExt = aTitle.replace(/\.[^/.]+$/, '');
+            const bTitleNoExt = bTitle.replace(/\.[^/.]+$/, '');
+            // Exact matches first
+            if (aTitleNoExt === searchQuery && bTitleNoExt !== searchQuery)
+                return -1;
+            if (bTitleNoExt === searchQuery && aTitleNoExt !== searchQuery)
+                return 1;
+            // Then by starts with
+            if (aTitleNoExt.startsWith(searchQuery) && !bTitleNoExt.startsWith(searchQuery))
+                return -1;
+            if (bTitleNoExt.startsWith(searchQuery) && !aTitleNoExt.startsWith(searchQuery))
+                return 1;
+            // Then by updated date (newest first)
+            return new Date(b.file.updatedAt).getTime() - new Date(a.file.updatedAt).getTime();
+        });
+        const matchText = matchingFiles.length === 1 ? 'match' : 'matches';
+        console.log(chalk.bold(`\nFound ${matchingFiles.length} ${matchText}:\n`));
+        for (let i = 0; i < matchingFiles.length; i++) {
+            const match = matchingFiles[i];
+            const { file, project, workspace } = match;
+            // Format time ago
+            const updatedDate = new Date(file.updatedAt);
+            const now = new Date();
+            const diffMs = now.getTime() - updatedDate.getTime();
+            const diffHours = Math.floor(diffMs / (1000 * 60 * 60));
+            const diffDays = Math.floor(diffHours / 24);
+            let timeAgo;
+            if (diffHours < 1)
+                timeAgo = 'just now';
+            else if (diffHours < 24)
+                timeAgo = `${diffHours} hour${diffHours === 1 ? '' : 's'} ago`;
+            else if (diffDays < 7)
+                timeAgo = `${diffDays} day${diffDays === 1 ? '' : 's'} ago`;
+            else
+                timeAgo = updatedDate.toLocaleDateString();
+            if (i > 0)
+                console.log();
+            console.log(chalk.white(`${i + 1}. ${file.title}`));
+            console.log(chalk.dim(`   Project: ${project.name}`));
+            console.log(chalk.dim(`   Workspace: ${workspace.name}`));
+            console.log(chalk.dim(`   Version: v${file.currentVersion}`));
+            console.log(chalk.dim(`   Updated: ${timeAgo}`));
+        }
+        console.log();
+        if (matchingFiles.length === 1) {
+            const { file } = matchingFiles[0];
+            console.log(chalk.dim(`To view this file, run:`));
+            console.log(chalk.white(`  contextium cat "${file.title}"`));
+        }
+    }
+    catch (error) {
+        spinner.fail(`Search failed: ${error.message}`);
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=find.js.map