@we-scrum/cli 1.0.8 → 1.0.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@we-scrum/cli",
-  "version": "1.0.8",
+  "version": "1.0.9",
   "description": "Cli tool for we-scrum application",
   "main": "dist/cli.js",
   "bin": {
@@ -37,11 +37,11 @@
     "@types/node": "^22.19.17",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",
+    "@my-devkit/core": "1.0.0",
     "@my-devkit/cli": "2.1.0",
-    "@we-scrum/enums": "1.0.0",
     "@we-scrum/commands": "1.0.0",
-    "@my-devkit/core": "1.0.0",
     "@we-scrum/models": "1.0.0",
+    "@we-scrum/enums": "1.0.0",
     "@we-scrum/utils": "1.0.0"
   },
   "scripts": {

package/src/cli.ts

@@ -1,11 +1,14 @@
 #!/usr/bin/env node
-import { select } from '@inquirer/prompts';
-import { assert, Logger } from '@my-devkit/core';
-import { UserProjectModel } from '@we-scrum/models';
+import { Logger } from '@my-devkit/core';
 import { Command } from 'commander';
 import { version } from '../package.json';
-
-import { AuthHelper, FirebaseHelper, ProjectHelper, WeScrumHelper } from './helpers';
+import {
+    registerAuthCommands,
+    registerPolicyCommands,
+    registerProjectCommands,
+    registerStoryCommands,
+    registerTaskCommands,
+} from './commands';
 
 Logger.registerLogger(new Logger.ConsoleImplementation());
 
@@ -13,154 +16,10 @@ const program = new Command();
 
 program.name('we-scrum').description('CLI for we-scrum application').version(version);
 
-async function requireAuth(): Promise<void> {
-    const initialized = await AuthHelper.initializeFromStoredCredentials();
-    assert(initialized, 'Not authenticated. Please run "we-scrum login" first.');
-}
-
-async function requireProject(): Promise<void> {
-    const root = ProjectHelper.requireRoot();
-    await ProjectHelper.init(root);
-}
-
-function runCommand<T = void>(fn: (options: T) => Promise<string | void>) {
-    return async (options: T) => {
-        try {
-            const output = await fn(options);
-            if (output) process.stdout.write(output + '\n');
-            process.exit(0);
-        } catch (error) {
-            if (error?.name === 'ExitPromptError') process.exit(0);
-            Logger.error(error?.message ?? 'Command failed');
-            process.exit(1);
-        }
-    };
-}
-
-function runProjectCommand<T = void>(fn: (options: T) => Promise<string | void>) {
-    return runCommand<T>(async (options) => {
-        await requireProject();
-        await requireAuth();
-        return fn(options);
-    });
-}
-
-program
-    .command('login')
-    .description('Authenticate with your Google account')
-    .action(
-        runCommand(async () => {
-            await AuthHelper.loginWithGoogle();
-        }),
-    );
-
-program
-    .command('logout')
-    .description('Log out and remove stored credentials')
-    .action(
-        runCommand(async () => {
-            AuthHelper.logout();
-            Logger.info('Logged out successfully.');
-        }),
-    );
-
-program
-    .command('use-project')
-    .description('Select the active project and initialize we-scrum.json')
-    .option('--projectId <id>', 'Set the active project directly without the interactive prompt')
-    .action(
-        runCommand<{ projectId?: string }>(async (options) => {
-            await requireAuth();
-
-            const projects = await FirebaseHelper.getCollection<UserProjectModel>(`users/${AuthHelper.userId}/projects`);
-            assert(projects.length > 0, 'No projects found for your account. Please create a project in the we-scrum web app first.');
-
-            let selectedProjectId: string;
-
-            if (options.projectId) {
-                const match = projects.find((p) => p.projectId === options.projectId);
-                assert(!!match, `Project "${options.projectId}" not found in your account.`);
-                selectedProjectId = match.projectId;
-            } else {
-                selectedProjectId = await select({
-                    message: 'Select a project',
-                    choices: projects.map((p) => ({
-                        name: p.name,
-                        value: p.projectId,
-                        description: p.projectId,
-                    })),
-                });
-            }
-
-            const projectRoot = await ProjectHelper.confirmAndCreate(selectedProjectId);
-            await ProjectHelper.init(projectRoot);
-
-            Logger.info(`Project configured: ${projects.find((p) => p.projectId === selectedProjectId)?.name}`);
-        }),
-    );
-
-program
-    .command('start-task')
-    .description('Mark a specific task as in progress')
-    .requiredOption('--identificationNumber <id>', 'Story identification number')
-    .requiredOption('--taskId <id>', 'Unique identifier of the change to act on')
-    .action(
-        runProjectCommand<{ identificationNumber: string; taskId: string }>(async (options) => {
-            await WeScrumHelper.startTask(options.identificationNumber, options.taskId);
-            Logger.info('Task started successfully. You can now make changes to the codebase.');
-        }),
-    );
-
-program
-    .command('complete-task')
-    .description('Mark the current in-progress task as done')
-    .requiredOption('--identificationNumber <id>', 'Story identification number')
-    .requiredOption('--taskId <id>', 'Unique identifier of the change to act on')
-    .action(
-        runProjectCommand<{ identificationNumber: string; taskId: string }>(async (options) => {
-            await WeScrumHelper.completeTask(options.identificationNumber, options.taskId);
-            Logger.info('Task completed successfully.');
-        }),
-    );
-
-program
-    .command('get-story-description')
-    .description('Get the description of a story')
-    .requiredOption('--identificationNumber <id>', 'Story identification number')
-    .action(
-        runProjectCommand<{ identificationNumber: string }>(async (options) => {
-            return WeScrumHelper.getStoryDescription(options.identificationNumber);
-        }),
-    );
-
-program
-    .command('get-story-analysis')
-    .description('Get the analysis DSL for a story')
-    .requiredOption('--identificationNumber <id>', 'Story identification number')
-    .action(
-        runProjectCommand<{ identificationNumber: string }>(async (options) => {
-            return WeScrumHelper.getStoryAnalysis(options.identificationNumber);
-        }),
-    );
-
-program
-    .command('get-next-task')
-    .description('Get the next pending task for a story')
-    .requiredOption('--identificationNumber <id>', 'Story identification number')
-    .action(
-        runProjectCommand<{ identificationNumber: string }>(async (options) => {
-            return WeScrumHelper.getNextTask(options.identificationNumber);
-        }),
-    );
-
-program
-    .command('synchronize-development-policies')
-    .description('Sync development guidelines from we-scrum into the project')
-    .action(
-        runProjectCommand(async () => {
-            const count = await WeScrumHelper.synchronizeDevelopmentPolicies();
-            Logger.info(`Synchronized ${count} development ${count === 1 ? 'policy' : 'policies'}.`);
-        }),
-    );
+registerAuthCommands(program);
+registerProjectCommands(program);
+registerStoryCommands(program);
+registerTaskCommands(program);
+registerPolicyCommands(program);
 
 program.parse(process.argv);

package/src/commands/auth.ts

@@ -0,0 +1,25 @@
+import { AuthHelper } from '@helpers';
+import { Logger } from '@my-devkit/core';
+import { runCommand } from '@utils';
+import { Command } from 'commander';
+
+export function registerAuthCommands(program: Command): void {
+    program
+        .command('login')
+        .description('Authenticate with your Google account')
+        .action(
+            runCommand(async () => {
+                await AuthHelper.loginWithGoogle();
+            }),
+        );
+
+    program
+        .command('logout')
+        .description('Log out and remove stored credentials')
+        .action(
+            runCommand(async () => {
+                AuthHelper.logout();
+                Logger.info('Logged out successfully.');
+            }),
+        );
+}

package/src/commands/index.ts

@@ -0,0 +1,5 @@
+export * from './auth';
+export * from './policy';
+export * from './project';
+export * from './story';
+export * from './task';

package/src/commands/policy.ts

@@ -0,0 +1,16 @@
+import { WeScrumHelper } from '@helpers';
+import { Logger } from '@my-devkit/core';
+import { runProjectCommand } from '@utils';
+import { Command } from 'commander';
+
+export function registerPolicyCommands(program: Command): void {
+    program
+        .command('synchronize-development-policies')
+        .description('Sync development guidelines from we-scrum into the project')
+        .action(
+            runProjectCommand(async () => {
+                const count = await WeScrumHelper.synchronizeDevelopmentPolicies();
+                Logger.info(`Synchronized ${count} development ${count === 1 ? 'policy' : 'policies'}.`);
+            }),
+        );
+}

package/src/commands/project.ts

@@ -0,0 +1,43 @@
+import { AuthHelper, FirebaseHelper, ProjectHelper } from '@helpers';
+import { select } from '@inquirer/prompts';
+import { assert, Logger } from '@my-devkit/core';
+import { requireAuth, runCommand } from '@utils';
+import { UserProjectModel } from '@we-scrum/models';
+import { Command } from 'commander';
+
+export function registerProjectCommands(program: Command): void {
+    program
+        .command('use-project')
+        .description('Select the active project and initialize we-scrum.json')
+        .option('--projectId <id>', 'Set the active project directly without the interactive prompt')
+        .action(
+            runCommand<{ projectId?: string }>(async (options) => {
+                await requireAuth();
+
+                const projects = await FirebaseHelper.getCollection<UserProjectModel>(`users/${AuthHelper.userId}/projects`);
+                assert(projects.length > 0, 'No projects found for your account. Please create a project in the we-scrum web app first.');
+
+                let selectedProjectId: string;
+
+                if (options.projectId) {
+                    const match = projects.find((p) => p.projectId === options.projectId);
+                    assert(!!match, `Project "${options.projectId}" not found in your account.`);
+                    selectedProjectId = match.projectId;
+                } else {
+                    selectedProjectId = await select({
+                        message: 'Select a project',
+                        choices: projects.map((p) => ({
+                            name: p.name,
+                            value: p.projectId,
+                            description: p.projectId,
+                        })),
+                    });
+                }
+
+                const projectRoot = await ProjectHelper.confirmAndCreate(selectedProjectId);
+                await ProjectHelper.init(projectRoot);
+
+                Logger.info(`Project configured: ${projects.find((p) => p.projectId === selectedProjectId)?.name}`);
+            }),
+        );
+}

package/src/commands/story.ts

@@ -0,0 +1,35 @@
+import { WeScrumHelper } from '@helpers';
+import { runProjectCommand } from '@utils';
+import { Command } from 'commander';
+
+export function registerStoryCommands(program: Command): void {
+    program
+        .command('get-story-description')
+        .description('Get the description of a story')
+        .requiredOption('-i, --identificationNumber <id>', 'Story identification number')
+        .action(
+            runProjectCommand<{ identificationNumber: string }>(async (options) => {
+                return WeScrumHelper.getStoryDescription(options.identificationNumber);
+            }),
+        );
+
+    program
+        .command('get-story-analysis')
+        .description('Get the analysis DSL for a story')
+        .requiredOption('-i, --identificationNumber <id>', 'Story identification number')
+        .action(
+            runProjectCommand<{ identificationNumber: string }>(async (options) => {
+                return WeScrumHelper.getStoryAnalysis(options.identificationNumber);
+            }),
+        );
+
+    program
+        .command('get-next-task')
+        .description('Get the next pending task for a story')
+        .requiredOption('-i, --identificationNumber <id>', 'Story identification number')
+        .action(
+            runProjectCommand<{ identificationNumber: string }>(async (options) => {
+                return WeScrumHelper.getNextTask(options.identificationNumber);
+            }),
+        );
+}

package/src/commands/task.ts

@@ -0,0 +1,30 @@
+import { WeScrumHelper } from '@helpers';
+import { Logger } from '@my-devkit/core';
+import { runProjectCommand } from '@utils';
+import { Command } from 'commander';
+
+export function registerTaskCommands(program: Command): void {
+    program
+        .command('start-task')
+        .description('Mark a specific task as in progress')
+        .requiredOption('-i, --identificationNumber <id>', 'Story identification number')
+        .requiredOption('-t, --taskId <id>', 'Unique identifier of the change to act on')
+        .action(
+            runProjectCommand<{ identificationNumber: string; taskId: string }>(async (options) => {
+                await WeScrumHelper.startTask(options.identificationNumber, options.taskId);
+                Logger.info('Task started successfully. You can now make changes to the codebase.');
+            }),
+        );
+
+    program
+        .command('complete-task')
+        .description('Mark the current in-progress task as done')
+        .requiredOption('-i, --identificationNumber <id>', 'Story identification number')
+        .requiredOption('-t, --taskId <id>', 'Unique identifier of the change to act on')
+        .action(
+            runProjectCommand<{ identificationNumber: string; taskId: string }>(async (options) => {
+                await WeScrumHelper.completeTask(options.identificationNumber, options.taskId);
+                Logger.info('Task completed successfully.');
+            }),
+        );
+}

package/src/helpers/project-helper.ts

@@ -1,5 +1,5 @@
-import { assert, Logger } from '@my-devkit/core';
 import { confirm, input } from '@inquirer/prompts';
+import { assert, Logger } from '@my-devkit/core';
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { dirname, join, resolve } from 'node:path';
 import { version as cliVersion } from '../../package.json';
@@ -37,7 +37,7 @@ export class ProjectHelper {
 
     public static write(root: string, partial: Partial<WeScrumProjectConfig>): void {
         const existing = existsSync(join(root, CONFIG_FILE)) ? this.read(root) : ({} as WeScrumProjectConfig);
-        writeFileSync(join(root, CONFIG_FILE), JSON.stringify({ ...existing, ...partial }, null, 2) + '\n');
+        writeFileSync(join(root, CONFIG_FILE), JSON.stringify({ ...existing, ...partial }, null, 4) + '\n');
     }
 
     public static async init(root: string): Promise<void> {

package/src/utils/index.ts

@@ -0,0 +1,3 @@
+export * from './require-auth';
+export * from './run-command';
+export * from './run-project-command';

package/src/utils/require-auth.ts

@@ -0,0 +1,7 @@
+import { AuthHelper } from '@helpers';
+import { assert } from '@my-devkit/core';
+
+export async function requireAuth(): Promise<void> {
+    const initialized = await AuthHelper.initializeFromStoredCredentials();
+    assert(initialized, 'Not authenticated. Please run "we-scrum login" first.');
+}

package/src/utils/require-project.ts

@@ -0,0 +1,6 @@
+import { ProjectHelper } from '@helpers';
+
+export async function requireProject(): Promise<void> {
+    const root = ProjectHelper.requireRoot();
+    await ProjectHelper.init(root);
+}

package/src/utils/run-command.ts

@@ -0,0 +1,15 @@
+import { Logger } from '@my-devkit/core';
+
+export function runCommand<T = void>(fn: (options: T) => Promise<string | void>) {
+    return async (options: T) => {
+        try {
+            const output = await fn(options);
+            if (output) process.stdout.write(output + '\n');
+            process.exit(0);
+        } catch (error) {
+            if (error?.name === 'ExitPromptError') process.exit(0);
+            Logger.error(error?.message ?? 'Command failed');
+            process.exit(1);
+        }
+    };
+}

package/src/utils/run-project-command.ts

@@ -0,0 +1,11 @@
+import { requireAuth } from './require-auth';
+import { requireProject } from './require-project';
+import { runCommand } from './run-command';
+
+export function runProjectCommand<T = void>(fn: (options: T) => Promise<string | void>) {
+    return runCommand<T>(async (options) => {
+        await requireProject();
+        await requireAuth();
+        return fn(options);
+    });
+}

package/templates/analysis-dsl-legend.hbs

@@ -1,3 +1,3 @@
 **Analysis DSL** — `+` Create · `-` Delete · `~` Update (operation prefixes, not markdown bullets).
 These appear on both change headers (`## + Object Foo`) and property lines (`+ name: String`, `~ price: Number`, `- email: String`).
-Rename: `~ OldName > NewName`. Metadata: `> key: value`. Description block: `:::...:::`.
+Handler relations use `>>` as separator: `+ ObjectA >> ObjectB >> ObjectC`.

package/templates/develop-story-skill.hbs

@@ -44,3 +44,15 @@ we-scrum get-next-task --identificationNumber <identificationNumber>
 ```
 
 Repeat until all tasks are complete.
+
+---
+
+## Developer context
+
+A TypeScript watcher is already running in parallel — compiled output is always up to date. Do not trigger manual application builds.
+
+Before committing any task, run ESLint on every modified file and fix all reported violations:
+
+```bash
+npx eslint <file1> <file2> ...
+```

package/tsconfig.json

@@ -13,7 +13,8 @@
         "skipLibCheck": true,
         "resolveJsonModule": true,
         "paths": {
-            "@helpers": ["helpers"]
+            "@helpers": ["helpers"],
+            "@utils": ["utils"]
         },
         "forceConsistentCasingInFileNames": true
     }