@hyperdrive.bot/cli 1.0.7 → 1.0.8

package/dist/commands/project/list.js

@@ -0,0 +1,119 @@
+import { Command, Flags } from '@oclif/core';
+import chalk from 'chalk';
+import ora from 'ora';
+import { HyperdriveSigV4Service } from '../../services/hyperdrive-sigv4.js';
+import { printTable } from '../../utils/table.js';
+export default class ProjectList extends Command {
+    static description = 'List all projects with Jira configuration status';
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> --json',
+        '<%= config.bin %> <%= command.id %> --domain custom.hyperdrive.bot',
+    ];
+    static flags = {
+        domain: Flags.string({
+            char: 'd',
+            description: 'Tenant domain (for multi-domain setups)',
+        }),
+        json: Flags.boolean({
+            description: 'Output as JSON',
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(ProjectList);
+        let service;
+        const spinner = ora('Checking authentication...').start();
+        try {
+            service = new HyperdriveSigV4Service(flags.domain);
+            spinner.succeed('Authenticated');
+        }
+        catch (error) {
+            spinner.fail('Not authenticated');
+            this.error(`${error.message}\n\nPlease authenticate first with: ${chalk.cyan('hd auth login')}`);
+        }
+        spinner.start('Fetching projects...');
+        try {
+            const modules = await service.moduleList();
+            if (!modules || modules.length === 0) {
+                spinner.stop();
+                this.log(chalk.yellow('No projects found.'));
+                this.log(chalk.dim(`Run ${chalk.cyan('hd project init')} to create your first project.`));
+                return;
+            }
+            // Enrich each project with Jira config and repos count
+            const enrichedProjects = await Promise.all(modules.map(async (mod) => {
+                let jiraKey = '—';
+                let repoCount = 0;
+                let lastSynced = '—';
+                if (mod.projectId) {
+                    try {
+                        const jiraConfig = await service.projectGetJiraConfig(mod.projectId);
+                        jiraKey = jiraConfig.jiraProjectKey;
+                        lastSynced = jiraConfig.updatedAt
+                            ? new Date(jiraConfig.updatedAt).toLocaleDateString()
+                            : '—';
+                    }
+                    catch {
+                        // 404 = not linked, silently ignore
+                    }
+                    try {
+                        const repos = await service.projectListRepos(mod.projectId);
+                        repoCount = repos.length;
+                    }
+                    catch {
+                        // silently ignore
+                    }
+                }
+                return {
+                    ...mod,
+                    hookCount: 0,
+                    jiraKey,
+                    lastSynced,
+                    repoCount,
+                };
+            }));
+            spinner.succeed(`Found ${enrichedProjects.length} project(s)`);
+            if (flags.json) {
+                this.log(JSON.stringify(enrichedProjects, null, 2));
+                return;
+            }
+            this.log('');
+            printTable(enrichedProjects, {
+                name: { header: 'Name', minWidth: 20 },
+                slug: {
+                    get: (row) => chalk.cyan(row.slug),
+                    header: 'Slug',
+                    minWidth: 15,
+                },
+                jiraKey: { header: 'Jira Key' },
+                repoCount: {
+                    get: (row) => String(row.repoCount),
+                    header: 'Repos',
+                },
+                hookCount: {
+                    get: (row) => String(row.hookCount),
+                    header: 'Hooks',
+                },
+                lastSynced: { header: 'Last Synced' },
+            }, (msg) => this.log(msg));
+        }
+        catch (error) {
+            spinner.fail('Failed to fetch projects');
+            let errorMessage = error.message;
+            if (error.response) {
+                const status = error.response.status;
+                const data = error.response.data;
+                if (status === 401 || status === 403) {
+                    errorMessage = `Authentication failed. Please run ${chalk.cyan('hd auth login')}`;
+                }
+                else if (data?.error) {
+                    errorMessage = data.error;
+                }
+                else if (data?.message) {
+                    errorMessage = data.message;
+                }
+            }
+            this.error(errorMessage);
+        }
+    }
+}

package/dist/commands/project/status.d.ts

@@ -0,0 +1,13 @@
+import { Command } from '@oclif/core';
+export default class ProjectStatus extends Command {
+    static args: {
+        project: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        domain: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/project/status.js

@@ -0,0 +1,163 @@
+import { Args, Command, Flags } from '@oclif/core';
+import chalk from 'chalk';
+import ora from 'ora';
+import { HyperdriveSigV4Service } from '../../services/hyperdrive-sigv4.js';
+import { printTable } from '../../utils/table.js';
+const STALE_THRESHOLD_MS = 7 * 24 * 60 * 60 * 1000; // 7 days
+export default class ProjectStatus extends Command {
+    static args = {
+        project: Args.string({
+            description: 'Project slug',
+            required: true,
+        }),
+    };
+    static description = 'Show detailed status of a project including Jira config, repos, and hooks';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> my-project',
+        '<%= config.bin %> <%= command.id %> my-project --json',
+        '<%= config.bin %> <%= command.id %> my-project --domain custom.hyperdrive.bot',
+    ];
+    static flags = {
+        domain: Flags.string({
+            char: 'd',
+            description: 'Tenant domain (for multi-domain setups)',
+        }),
+        json: Flags.boolean({
+            description: 'Output as JSON',
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(ProjectStatus);
+        const slug = args.project;
+        let service;
+        const spinner = ora('Checking authentication...').start();
+        try {
+            service = new HyperdriveSigV4Service(flags.domain);
+            spinner.succeed('Authenticated');
+        }
+        catch (error) {
+            spinner.fail('Not authenticated');
+            this.error(`${error.message}\n\nPlease authenticate first with: ${chalk.cyan('hd auth login')}`);
+        }
+        spinner.start(`Fetching project '${slug}'...`);
+        try {
+            // Find the project by slug
+            const modules = await service.moduleList();
+            const project = modules.find((m) => m.slug === slug);
+            if (!project || !project.projectId) {
+                spinner.fail('Project not found');
+                this.error(`Project '${slug}' not found. Run ${chalk.cyan('hd project list')} to see available projects.`);
+            }
+            const projectId = project.projectId;
+            // Fetch Jira config and repos in parallel
+            let jiraConfig = null;
+            let repos = [];
+            const [jiraResult, reposResult] = await Promise.allSettled([
+                service.projectGetJiraConfig(projectId),
+                service.projectListRepos(projectId),
+            ]);
+            if (jiraResult.status === 'fulfilled') {
+                jiraConfig = jiraResult.value;
+            }
+            if (reposResult.status === 'fulfilled') {
+                repos = reposResult.value;
+            }
+            spinner.succeed('Project data loaded');
+            // JSON output
+            if (flags.json) {
+                this.log(JSON.stringify({ jiraConfig, project, repos }, null, 2));
+                return;
+            }
+            // Project metadata
+            this.log('');
+            this.log(chalk.bold('Project'));
+            this.log(`  ${chalk.dim('Name:')}       ${project.name}`);
+            this.log(`  ${chalk.dim('Slug:')}       ${chalk.cyan(project.slug)}`);
+            this.log(`  ${chalk.dim('Created:')}    ${project.createdAt ? new Date(project.createdAt).toLocaleDateString() : '—'}`);
+            this.log('');
+            // Jira config section
+            this.log(chalk.bold('Jira Configuration'));
+            if (jiraConfig) {
+                this.log(`  ${chalk.dim('Jira Key:')}   ${chalk.cyan(jiraConfig.jiraProjectKey)}`);
+                this.log(`  ${chalk.dim('Linked:')}     ${chalk.green('Yes')}`);
+                this.log('');
+                // Status mapping table
+                if (jiraConfig.statusMapping && Object.keys(jiraConfig.statusMapping).length > 0) {
+                    this.log(chalk.bold('Status Mapping'));
+                    const mappingData = Object.entries(jiraConfig.statusMapping).map(([jiraStatus, normalizedState]) => ({
+                        jiraStatus,
+                        normalizedState,
+                    }));
+                    printTable(mappingData, {
+                        jiraStatus: { header: 'Jira Status', minWidth: 25 },
+                        normalizedState: {
+                            get: (row) => chalk.cyan(row.normalizedState),
+                            header: 'Normalized State',
+                            minWidth: 20,
+                        },
+                    }, (msg) => this.log(msg));
+                }
+            }
+            else {
+                this.log(chalk.yellow(`  No Jira configuration. Run ${chalk.cyan(`hd project init`)} to set up.`));
+            }
+            this.log('');
+            // Repos section
+            this.log(chalk.bold('Repositories'));
+            if (repos.length > 0) {
+                for (const repo of repos) {
+                    this.log(`  ${chalk.cyan(repo.name)}`);
+                    this.log(`    ${chalk.dim('Remote:')}     ${chalk.cyan(repo.gitRemote)}`);
+                    this.log(`    ${chalk.dim('Provider:')}   ${repo.provider}`);
+                    this.log(`    ${chalk.dim('Branch:')}     ${repo.defaultBranch}`);
+                    // Architecture summary age
+                    if (!repo.architectureSummary) {
+                        this.log(chalk.yellow(`    Architecture summary is missing for ${repo.name}. Run ${chalk.cyan(`hd project sync ${slug}`)} to update.`));
+                    }
+                    else if (repo.architectureSummaryUpdatedAt) {
+                        const age = Date.now() - new Date(repo.architectureSummaryUpdatedAt).getTime();
+                        if (age > STALE_THRESHOLD_MS) {
+                            const days = Math.floor(age / (24 * 60 * 60 * 1000));
+                            this.log(`    ${chalk.dim('Summary Age:')} ${chalk.yellow(`${days} days`)}`);
+                            this.log(chalk.yellow(`    Architecture summary is stale for ${repo.name}. Run ${chalk.cyan(`hd project sync ${slug}`)} to update.`));
+                        }
+                        else {
+                            const days = Math.floor(age / (24 * 60 * 60 * 1000));
+                            this.log(`    ${chalk.dim('Summary Age:')} ${chalk.green(`${days} day${days === 1 ? '' : 's'}`)}`);
+                        }
+                    }
+                    this.log('');
+                }
+            }
+            else {
+                this.log(chalk.dim('  No repositories linked.'));
+                this.log('');
+            }
+            // Hooks section
+            this.log(chalk.bold('Hooks'));
+            this.log(chalk.dim('  No hooks configured (coming in a future release)'));
+            this.log('');
+        }
+        catch (error) {
+            spinner.fail('Failed to fetch project status');
+            let errorMessage = error.message;
+            if (error.response) {
+                const status = error.response.status;
+                const data = error.response.data;
+                if (status === 401 || status === 403) {
+                    errorMessage = `Authentication failed. Please run ${chalk.cyan('hd auth login')}`;
+                }
+                else if (status === 404) {
+                    errorMessage = `Project '${slug}' not found. Run ${chalk.cyan('hd project list')} to see available projects.`;
+                }
+                else if (data?.error) {
+                    errorMessage = data.error;
+                }
+                else if (data?.message) {
+                    errorMessage = data.message;
+                }
+            }
+            this.error(errorMessage);
+        }
+    }
+}

package/dist/commands/project/sync.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Project Sync Command
+ *
+ * Generates structured architecture summaries for repos in a project.
+ * For each repo: clone/pull → detect _bmad or invoke Claude → validate YAML → upload S3 → update DynamoDB.
+ */
+import { Command } from '@oclif/core';
+export default class ProjectSync extends Command {
+    static args: {
+        project: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        domain: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        repo: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+    private syncRepo;
+    private detectBmadDocs;
+    private runClaude;
+    private validateYaml;
+    private readGutEntities;
+    private mergeEntityRegistries;
+}