@we-scrum/cli 1.0.8 → 6.8.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@we-scrum/cli",
-  "version": "1.0.8",
+  "version": "6.8.1",
   "description": "Cli tool for we-scrum application",
   "main": "dist/cli.js",
   "bin": {
@@ -26,21 +26,21 @@
     }
   },
   "dependencies": {
-    "@inquirer/prompts": "^8.4.2",
-    "commander": "^14.0.3",
-    "firebase": "^12.12.1",
-    "google-auth-library": "^10.6.2",
+    "@inquirer/prompts": "^8.6.0",
+    "commander": "^15.0.0",
+    "firebase": "^12.18.0",
+    "google-auth-library": "^11.0.2",
     "handlebars": "^4.7.9",
-    "open": "^11.0.0"
+    "open": "^11.0.1"
   },
   "devDependencies": {
-    "@types/node": "^22.19.17",
+    "@types/node": "^24.13.3",
     "tsup": "^8.5.1",
-    "typescript": "^5.9.3",
+    "typescript": "^6.0.3",
     "@my-devkit/cli": "2.1.0",
+    "@my-devkit/core": "1.0.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/utils": "1.0.0"
   },

package/src/cli.ts

@@ -1,11 +1,15 @@
 #!/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,
+    registerIterationCommands,
+    registerPolicyCommands,
+    registerProjectCommands,
+    registerStoryCommands,
+    registerTaskCommands,
+} from './commands';
 
 Logger.registerLogger(new Logger.ConsoleImplementation());
 
@@ -13,154 +17,11 @@ 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);
+registerIterationCommands(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,6 @@
+export * from './auth';
+export * from './iteration';
+export * from './policy';
+export * from './project';
+export * from './story';
+export * from './task';

package/src/commands/iteration.ts

@@ -0,0 +1,26 @@
+import { WeScrumHelper } from '@helpers';
+import { runProjectCommand } from '@utils';
+import { Command } from 'commander';
+
+export function registerIterationCommands(program: Command): void {
+    program
+        .command('update-iteration')
+        .description('Update an iteration')
+        .requiredOption('-n, --name <name>', 'Iteration name')
+        .option('-ca, --capacity <capacity>', 'Iteration capacity')
+        .option('-co, --comment <comment>', 'Iteration comment')
+        .option('-sd, --startDate <startDate>', 'Iteration start date (ISO 8601)')
+        .option('-ed, --endDate <endDate>', 'Iteration end date (ISO 8601)')
+        .action(
+            runProjectCommand<{ name: string; capacity?: string; comment?: string; startDate?: string; endDate?: string }>(
+                async (options) => {
+                    await WeScrumHelper.updateIteration(options.name, {
+                        capacity: options.capacity !== undefined ? Number(options.capacity) : undefined,
+                        comment: options.comment,
+                        startDate: options.startDate !== undefined ? new Date(options.startDate) : undefined,
+                        endDate: options.endDate !== undefined ? new Date(options.endDate) : undefined,
+                    });
+                },
+            ),
+        );
+}

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/firebase-helper.ts

@@ -24,7 +24,7 @@ import {
 } from 'firebase/firestore';
 
 for (const i in models) {
-    new models[i]();
+    new (models as unknown as Record<string, new () => unknown>)[i]();
 }
 
 export class FirebaseHelper {

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/helpers/we-scrum.helper.ts

@@ -10,10 +10,12 @@ import {
     TakeRelationChangeCommand,
     TakeRouteChangeCommand,
     TakeTaskCommand,
+    UpdateIterationCommand,
 } from '@we-scrum/commands';
 import { ContentType, ProgressStatus } from '@we-scrum/enums';
 import {
     DevelopmentPolicyModel,
+    ProjectIterationModel,
     ProjectStoryModel,
     ProjectStorySectionModel,
     ProjectStorySectionModelEnumerationChange,
@@ -163,6 +165,29 @@ export class WeScrumHelper {
         }
     }
 
+    public static async updateIteration(
+        name: string,
+        options: { capacity?: number; comment?: string; startDate?: Date; endDate?: Date },
+    ): Promise<void> {
+        const iteration = await FirebaseHelper.findDocument<ProjectIterationModel>(`/projects/${this.projectId}/iterations`, [
+            ['name', '==', name],
+        ]);
+
+        assert(!!iteration, `Iteration "${name}" not found in the active project.`);
+
+        await this.post(
+            'project-management/update-iteration',
+            TypeHelper.transform(UpdateIterationCommand, {
+                iterationId: iteration.iterationId,
+                name: iteration.name,
+                startDate: options.startDate ?? iteration.startDate,
+                endDate: options.endDate ?? iteration.endDate,
+                capacity: options.capacity ?? iteration.capacity,
+                comment: options.comment ?? iteration.comment,
+            }),
+        );
+    }
+
     public static async getChangeDevelopmentPolicy(change: DevelopmentPolicyHelper.Change) {
         const developmentPolicies = await this.getDevelopmentPolicies();
 

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

@@ -1,10 +1,17 @@
 {
     "compilerOptions": {
+        "strict": false,
+        "strictNullChecks": false,
+        "noImplicitThis": true,
+        "alwaysStrict": true,
+        "strictBindCallApply": true,
+        "strictFunctionTypes": true,
+        "noImplicitAny": true,
         "module": "commonjs",
         "moduleResolution": "bundler",
-        "target": "es2021",
+        "target": "es2023",
+        "lib": ["ES2023"],
         "outDir": "./dist",
-        "baseUrl": "src",
         "sourceMap": true,
         "declaration": false,
         "emitDecoratorMetadata": true,
@@ -13,7 +20,8 @@
         "skipLibCheck": true,
         "resolveJsonModule": true,
         "paths": {
-            "@helpers": ["helpers"]
+            "@helpers": ["./src/helpers"],
+            "@utils": ["./src/utils"]
         },
         "forceConsistentCasingInFileNames": true
     }