@shepai/cli 1.44.2 → 1.45.0

package/dist/src/presentation/cli/commands/repo/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Repo Command
+ *
+ * Top-level repo command with subcommands for managing tracked repositories.
+ *
+ * Usage:
+ *   shep repo [subcommand]
+ *
+ * Subcommands:
+ *   shep repo ls             List tracked repositories
+ *   shep repo show <id>      Display details of a tracked repository
+ */
+import { Command } from 'commander';
+/**
+ * Create the repo command with all subcommands
+ */
+export declare function createRepoCommand(): Command;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/presentation/cli/commands/repo/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/repo/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAO3C"}

package/dist/src/presentation/cli/commands/repo/index.js

@@ -0,0 +1,25 @@
+/**
+ * Repo Command
+ *
+ * Top-level repo command with subcommands for managing tracked repositories.
+ *
+ * Usage:
+ *   shep repo [subcommand]
+ *
+ * Subcommands:
+ *   shep repo ls             List tracked repositories
+ *   shep repo show <id>      Display details of a tracked repository
+ */
+import { Command } from 'commander';
+import { createShowCommand } from './show.command.js';
+import { createLsCommand } from './ls.command.js';
+/**
+ * Create the repo command with all subcommands
+ */
+export function createRepoCommand() {
+    const repo = new Command('repo')
+        .description('Manage tracked repositories')
+        .addCommand(createLsCommand())
+        .addCommand(createShowCommand());
+    return repo;
+}

package/dist/src/presentation/cli/commands/repo/ls.command.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Repo List Command
+ *
+ * List all tracked repositories in a formatted table.
+ *
+ * Usage:
+ *   shep repo ls
+ */
+import { Command } from 'commander';
+export declare function createLsCommand(): Command;
+//# sourceMappingURL=ls.command.d.ts.map

package/dist/src/presentation/cli/commands/repo/ls.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ls.command.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/repo/ls.command.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAmBpC,wBAAgB,eAAe,IAAI,OAAO,CAuCzC"}

package/dist/src/presentation/cli/commands/repo/ls.command.js

@@ -0,0 +1,64 @@
+/**
+ * Repo List Command
+ *
+ * List all tracked repositories in a formatted table.
+ *
+ * Usage:
+ *   shep repo ls
+ */
+import { Command } from 'commander';
+import { container } from '../../../../../packages/core/src/infrastructure/di/container.js';
+import { ListRepositoriesUseCase } from '../../../../../packages/core/src/application/use-cases/repositories/list-repositories.use-case.js';
+import { colors, messages, renderListView } from '../../ui/index.js';
+/** Format a duration in ms to a compact human-readable string. */
+function formatDuration(ms) {
+    const seconds = Math.floor(ms / 1000);
+    if (seconds < 60)
+        return `${seconds}s`;
+    const minutes = Math.floor(seconds / 60);
+    if (minutes < 60)
+        return `${minutes}m`;
+    const hours = Math.floor(minutes / 60);
+    const remMin = minutes % 60;
+    if (hours < 24)
+        return remMin > 0 ? `${hours}h ${remMin}m` : `${hours}h`;
+    const days = Math.floor(hours / 24);
+    return `${days}d`;
+}
+export function createLsCommand() {
+    return new Command('ls').description('List tracked repositories').action(async () => {
+        try {
+            const useCase = container.resolve(ListRepositoriesUseCase);
+            const featureRepo = container.resolve('IFeatureRepository');
+            const repositories = await useCase.execute();
+            const now = Date.now();
+            const rows = await Promise.all(repositories.map(async (repo) => {
+                const features = await featureRepo.list({ repositoryPath: repo.path });
+                return [
+                    repo.id.substring(0, 8),
+                    repo.name,
+                    String(features.length),
+                    repo.path,
+                    colors.muted(`${formatDuration(now - new Date(repo.createdAt).getTime())} ago`),
+                ];
+            }));
+            renderListView({
+                title: 'Repositories',
+                columns: [
+                    { label: 'ID', width: 10 },
+                    { label: 'Name', width: 28 },
+                    { label: 'Features', width: 10 },
+                    { label: 'Path', width: 36 },
+                    { label: 'Created', width: 12 },
+                ],
+                rows,
+                emptyMessage: 'No repositories found',
+            });
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            messages.error('Failed to list repositories', err);
+            process.exitCode = 1;
+        }
+    });
+}

package/dist/src/presentation/cli/commands/repo/resolve-repository.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Shared helper: resolve a repository by exact or prefix ID.
+ */
+import type { Repository } from '../../../../../packages/core/src/domain/generated/output.js';
+export declare function resolveRepository(id: string): Promise<{
+    repository: Repository;
+} | {
+    error: string;
+}>;
+//# sourceMappingURL=resolve-repository.d.ts.map

package/dist/src/presentation/cli/commands/repo/resolve-repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-repository.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/repo/resolve-repository.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAE/D,wBAAsB,iBAAiB,CACrC,EAAE,EAAE,MAAM,GACT,OAAO,CAAC;IAAE,UAAU,EAAE,UAAU,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAqBzD"}

package/dist/src/presentation/cli/commands/repo/resolve-repository.js

@@ -0,0 +1,24 @@
+/**
+ * Shared helper: resolve a repository by exact or prefix ID.
+ */
+import { container } from '../../../../../packages/core/src/infrastructure/di/container.js';
+export async function resolveRepository(id) {
+    const repo = container.resolve('IRepositoryRepository');
+    // Try exact match first
+    const exact = await repo.findById(id);
+    if (exact)
+        return { repository: exact };
+    // Try prefix match
+    if (id.length < 36) {
+        const all = await repo.list();
+        const matches = all.filter((r) => r.id.startsWith(id));
+        if (matches.length === 1)
+            return { repository: matches[0] };
+        if (matches.length > 1) {
+            return {
+                error: `Multiple repositories match prefix "${id}": ${matches.map((m) => m.id.substring(0, 8)).join(', ')}`,
+            };
+        }
+    }
+    return { error: `Repository not found: ${id}` };
+}

package/dist/src/presentation/cli/commands/repo/show.command.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Repo Show Command
+ *
+ * Display details of a specific tracked repository.
+ *
+ * Usage:
+ *   shep repo show <id>
+ */
+import { Command } from 'commander';
+export declare function createShowCommand(): Command;
+//# sourceMappingURL=show.command.d.ts.map

package/dist/src/presentation/cli/commands/repo/show.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"show.command.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/repo/show.command.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoCpC,wBAAgB,iBAAiB,IAAI,OAAO,CAsD3C"}

package/dist/src/presentation/cli/commands/repo/show.command.js

@@ -0,0 +1,95 @@
+/**
+ * Repo Show Command
+ *
+ * Display details of a specific tracked repository.
+ *
+ * Usage:
+ *   shep repo show <id>
+ */
+import { Command } from 'commander';
+import { container } from '../../../../../packages/core/src/infrastructure/di/container.js';
+import { colors, messages, renderDetailView } from '../../ui/index.js';
+import { resolveRepository } from './resolve-repository.js';
+/** Color a lifecycle value to match feat ls status styling. */
+function colorLifecycle(lifecycle) {
+    switch (lifecycle) {
+        case 'Started':
+            return colors.muted(lifecycle);
+        case 'Analyze':
+        case 'Requirements':
+        case 'Research':
+        case 'Planning':
+            return colors.info(lifecycle);
+        case 'Implementation':
+            return colors.warning(lifecycle);
+        case 'Review':
+            return colors.brand(lifecycle);
+        case 'Maintain':
+            return colors.success(lifecycle);
+        default:
+            return colors.muted(lifecycle);
+    }
+}
+function formatDate(date) {
+    if (!date)
+        return null;
+    try {
+        return new Date(date).toLocaleString();
+    }
+    catch {
+        return String(date);
+    }
+}
+export function createShowCommand() {
+    return new Command('show')
+        .description('Display details of a tracked repository')
+        .argument('<id>', 'Repository ID (or prefix)')
+        .action(async (id) => {
+        try {
+            const resolved = await resolveRepository(id);
+            if ('error' in resolved) {
+                messages.error(resolved.error);
+                process.exitCode = 1;
+                return;
+            }
+            const repository = resolved.repository;
+            const featureRepo = container.resolve('IFeatureRepository');
+            const features = await featureRepo.list({ repositoryPath: repository.path });
+            const featureFields = features.length > 0
+                ? features.map((f) => ({
+                    label: `${colors.muted(f.id.slice(0, 8))}  ${f.name}`,
+                    value: colorLifecycle(f.lifecycle),
+                }))
+                : [{ label: 'No features found', value: '—' }];
+            renderDetailView({
+                title: 'Repository',
+                sections: [
+                    {
+                        fields: [
+                            { label: 'ID', value: repository.id },
+                            { label: 'Name', value: repository.name },
+                            { label: 'Path', value: repository.path },
+                        ],
+                    },
+                    {
+                        title: 'Timestamps',
+                        fields: [
+                            { label: 'Created', value: formatDate(repository.createdAt) },
+                            { label: 'Updated', value: formatDate(repository.updatedAt) },
+                            { label: 'Deleted', value: formatDate(repository.deletedAt) },
+                        ],
+                    },
+                    {
+                        title: `Features (${features.length})`,
+                        fields: featureFields,
+                    },
+                ],
+            });
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            messages.error('Failed to show repository', err);
+            process.exitCode = 1;
+        }
+    });
+}

package/dist/src/presentation/cli/index.d.ts

@@ -14,6 +14,7 @@
  *   shep run          Run an AI agent workflow
  *   shep agent        Manage and view agent runs
  *   shep feat         Manage features through the SDLC lifecycle
+ *   shep repo         Manage tracked repositories
  *   shep settings     Configure Shep settings
  *   shep upgrade      Upgrade Shep CLI to the latest version
  *   shep --version    Display version number only

package/dist/src/presentation/cli/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/presentation/cli/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/presentation/cli/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAGH,OAAO,kBAAkB,CAAC"}

package/dist/src/presentation/cli/index.js

@@ -14,6 +14,7 @@
  *   shep run          Run an AI agent workflow
  *   shep agent        Manage and view agent runs
  *   shep feat         Manage features through the SDLC lifecycle
+ *   shep repo         Manage tracked repositories
  *   shep settings     Configure Shep settings
  *   shep upgrade      Upgrade Shep CLI to the latest version
  *   shep --version    Display version number only
@@ -31,6 +32,7 @@ import { createUiCommand } from './commands/ui.command.js';
 import { createRunCommand } from './commands/run.command.js';
 import { createAgentCommand } from './commands/agent/index.js';
 import { createFeatCommand } from './commands/feat/index.js';
+import { createRepoCommand } from './commands/repo/index.js';
 import { createIdeOpenCommand } from './commands/ide-open.command.js';
 import { createInstallCommand } from './commands/install.command.js';
 import { createUpgradeCommand } from './commands/upgrade.command.js';
@@ -95,6 +97,7 @@ async function bootstrap() {
         program.addCommand(createRunCommand());
         program.addCommand(createAgentCommand());
         program.addCommand(createFeatCommand());
+        program.addCommand(createRepoCommand());
         program.addCommand(createIdeOpenCommand());
         program.addCommand(createInstallCommand());
         program.addCommand(createUpgradeCommand());