clispark 1.5.0 → 1.6.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clispark",
-  "version": "1.5.0",
+  "version": "1.6.0",
   "description": "Interactive scaffolding tool for new CLI projects",
   "keywords": [
     "cli",

package/templates/base/src/commands/task/complete.test.ts

@@ -17,4 +17,10 @@ describe('task complete', () => {
     const { error } = await runCommand('task complete');
     expect(error?.message).toContain('Missing 1 required arg');
   });
+
+  it('shows a usage example in --help', async () => {
+    const { stdout } = await runCommand('task complete --help');
+    expect(stdout).toContain('EXAMPLES');
+    expect(stdout).toContain('task complete 1');
+  });
 });

package/templates/base/src/commands/task/complete.ts

@@ -4,6 +4,12 @@ import { BaseCommand } from '../../base-command';
 
 export default class TaskComplete extends BaseCommand {
   static description = 'Complete a task (demonstrates a subcommand with a required integer argument)';
+  static examples = [
+    {
+      command: '<%= config.bin %> task complete 1',
+      description: 'Marks task 1 as complete',
+    },
+  ];
   static args = {
     id: Args.integer({ required: true, description: 'Task ID to complete' }),
   };

package/templates/base/src/commands/task/list.test.ts

@@ -22,4 +22,12 @@ describe('task list', () => {
     const { stdout } = await runCommand('task list groceries no');
     expect(stdout).toContain('(completed only: false)');
   });
+
+  it('shows usage examples in --help', async () => {
+    const { stdout } = await runCommand('task list --help');
+    expect(stdout).toContain('EXAMPLES');
+    expect(stdout).toContain('task list');
+    expect(stdout).toContain('task list groceries');
+    expect(stdout).toContain('task list groceries true');
+  });
 });

package/templates/base/src/commands/task/list.ts

@@ -4,6 +4,20 @@ import { BaseCommand } from '../../base-command';
 
 export default class TaskList extends BaseCommand {
   static description = 'List tasks (demonstrates a subcommand with two optional arguments of different types)';
+  static examples = [
+    {
+      command: '<%= config.bin %> task list',
+      description: 'Lists all tasks',
+    },
+    {
+      command: '<%= config.bin %> task list groceries',
+      description: 'Lists tasks matching a filter term',
+    },
+    {
+      command: '<%= config.bin %> task list groceries true',
+      description: 'Lists tasks matching a filter, showing only completed ones',
+    },
+  ];
   static args = {
     filter: Args.string({ required: false, description: 'Optional filter term' }),
     done: Args.boolean({ required: false, description: 'Only show completed tasks (true/false)' }),

package/templates/base/src/commands/task.test.ts

@@ -23,4 +23,11 @@ describe('task', () => {
     const { error } = await runCommand('task');
     expect(error?.message).toContain('Missing 1 required arg');
   });
+
+  it('shows usage examples in --help', async () => {
+    const { stdout } = await runCommand('task --help');
+    expect(stdout).toContain('EXAMPLES');
+    expect(stdout).toContain('task "Buy milk"');
+    expect(stdout).toContain('task "Buy milk" high');
+  });
 });

package/templates/base/src/commands/task.ts

@@ -4,6 +4,16 @@ import { BaseCommand } from '../base-command';
 
 export default class Task extends BaseCommand {
   static description = 'Create a task (demonstrates a required string arg and an optional enum-constrained arg)';
+  static examples = [
+    {
+      command: '<%= config.bin %> task "Buy milk"',
+      description: 'Creates a task with just a title',
+    },
+    {
+      command: '<%= config.bin %> task "Buy milk" high',
+      description: 'Creates a task with an optional priority (low, medium, or high)',
+    },
+  ];
   static args = {
     title: Args.string({ required: true, description: 'Task title' }),
     priority: Args.string({