taskin 0.1.0-beta.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 OpenTask (https://opentask.com.br)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,119 @@
+# Taskin
+
+> Task management system integrated with Git workflows
+
+Taskin is a command-line tool that helps you manage tasks directly from your terminal, with seamless Git integration and **dynamic provider loading**.
+
+[![npm version](https://img.shields.io/npm/v/taskin.svg)](https://www.npmjs.com/package/taskin)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## ✨ Features
+
+- 🎯 **Multiple Task Providers** - File System, Redmine, Jira, GitHub Issues (and more!)
+- 🔌 **Dynamic Provider Installation** - Automatically installs providers when needed
+- 📦 **Lightweight CLI** - Only installs what you use
+- 🔒 **Secure Configuration** - API keys protected in `.gitignore`
+- 🎨 **Beautiful CLI** - Colorful, interactive, and user-friendly
+- ⚡ **Fast & Efficient** - Built with performance in mind
+- 🧪 **Well Tested** - Comprehensive test coverage
+
+## 🚀 Installation
+
+\`\`\`bash
+# Using npx (recommended - no installation needed!)
+npx taskin init
+
+# Or install globally
+npm install -g taskin
+
+# Or with pnpm
+pnpm add -g taskin
+
+# Or with yarn
+yarn global add taskin
+\`\`\`
+
+> **Note:** This is a beta version. Please report any issues on [GitHub](https://github.com/opentask-app/taskin/issues).
+
+## Quick Start
+
+1. **Initialize Taskin in your project:**
+   \`\`\`bash
+   npx taskin init
+   \`\`\`
+
+   Select your preferred task provider:
+   - 📁 **File System** - Store tasks as Markdown files locally
+   - 🔴 **Redmine** - Sync with Redmine issues (coming soon)
+   - 🔵 **Jira** - Sync with Jira issues (coming soon)
+   - 🐙 **GitHub Issues** - Sync with GitHub (coming soon)
+
+2. **List all tasks:**
+   \`\`\`bash
+   taskin list
+   \`\`\`
+
+3. **Start working on a task:**
+   \`\`\`bash
+   taskin start task-001
+   \`\`\`
+
+## Commands
+
+- \`taskin init\` - Initialize Taskin in your project with interactive setup
+- \`taskin list\` - List all tasks
+- \`taskin start <id>\` - Start working on a task
+- \`taskin pause <id>\` - Pause work on a task
+- \`taskin finish <id>\` - Complete a task
+- \`taskin lint\` - Validate task files
+
+## 🏗️ Architecture
+
+Taskin uses a **plugin-based architecture** with dynamic provider loading:
+
+- Providers are loaded on-demand (only when selected)
+- Automatic installation via npm/pnpm/yarn
+- Easy to extend with custom providers
+
+📚 See [ARCHITECTURE.md](./ARCHITECTURE.md) for detailed technical documentation.
+
+## 📖 Examples
+
+See [EXAMPLES.md](./EXAMPLES.md) for detailed usage examples and workflows.
+
+## 🔌 Available Providers
+
+| Provider         | Status         | Package                           |
+| ---------------- | -------------- | --------------------------------- |
+| 📁 File System   | ✅ Stable      | \`@taskin/fs-task-provider\`      |
+| 🔴 Redmine       | 🚧 Coming Soon | \`@taskin/redmine-task-provider\` |
+| 🔵 Jira          | 🚧 Coming Soon | \`@taskin/jira-task-provider\`    |
+| 🐙 GitHub Issues | 🚧 Coming Soon | \`@taskin/github-task-provider\`  |
+
+Want to create your own provider? See [ARCHITECTURE.md](./ARCHITECTURE.md#-criando-um-novo-provider).
+
+## 🤝 Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## 📝 Requirements
+
+- Node.js >= 20.0.0
+- npm/pnpm/yarn
+
+## 🐛 Issues
+
+Found a bug? Have a feature request? Please [open an issue](https://github.com/opentask-app/taskin/issues).
+
+## � Team
+
+**OpenTask**
+- Website: [opentask.com.br](https://opentask.com.br)
+- Email: contato@opentask.com.br
+
+**Contributors:**
+- Sidarta Veloso ([@sidartaveloso](https://github.com/sidartaveloso))
+
+## 📄 License
+
+MIT © [OpenTask](https://opentask.com.br)

package/dist/commands/commands.types.d.ts

@@ -0,0 +1,13 @@
+/**
+ * CLI commands types
+ * Re-exports from @taskin/types-ts for convenience
+ */
+export type {
+  FinishTaskOptions,
+  ListTasksOptions,
+  PauseTaskOptions,
+  StartTaskOptions,
+} from '@taskin/types-ts';
+export interface LintOptions {
+  path?: string;
+}

package/dist/commands/commands.types.js

@@ -0,0 +1,6 @@
+/**
+ * CLI commands types
+ * Re-exports from @taskin/types-ts for convenience
+ */
+export {};
+//# sourceMappingURL=commands.types.js.map

package/dist/commands/commands.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.types.js","sourceRoot":"","sources":["../../src/commands/commands.types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/commands/define-command/define-command.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Command definition helper
+ * Provides a declarative way to define CLI commands
+ */
+import type { DefineCommandFunction } from './define-command.types.js';
+export declare const defineCommand: DefineCommandFunction;

package/dist/commands/define-command/define-command.js

@@ -0,0 +1,27 @@
+/**
+ * Command definition helper
+ * Provides a declarative way to define CLI commands
+ */
+import { error } from '../../lib/colors.js';
+export const defineCommand = (config) => {
+  return (program) => {
+    const cmd = program.command(config.name).description(config.description);
+    if (config.alias) {
+      cmd.alias(config.alias);
+    }
+    config.options?.forEach((opt) => {
+      cmd.option(opt.flags, opt.description, opt.defaultValue);
+    });
+    cmd.action(async (...args) => {
+      try {
+        await config.handler(...args);
+      } catch (err) {
+        error(
+          `Failed to execute command: ${err instanceof Error ? err.message : String(err)}`,
+        );
+        process.exit(1);
+      }
+    });
+  };
+};
+//# sourceMappingURL=define-command.js.map

package/dist/commands/define-command/define-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-command.js","sourceRoot":"","sources":["../../../src/commands/define-command/define-command.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAG5C,MAAM,CAAC,MAAM,aAAa,GAA0B,CAAC,MAAM,EAAE,EAAE;IAC7D,OAAO,CAAC,OAAgB,EAAE,EAAE;QAC1B,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QAEzE,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACjB,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;QAED,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;YAC9B,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC;QAC3D,CAAC,CAAC,CAAC;QAEH,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,IAAI,EAAE,EAAE;YAC3B,IAAI,CAAC;gBACH,MAAM,MAAM,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;YAChC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,KAAK,CACH,8BAA8B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CACjF,CAAC;gBACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC,CAAC"}

package/dist/commands/define-command/define-command.test.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Tests for defineCommand
+ */
+export {};

package/dist/commands/define-command/define-command.test.js

@@ -0,0 +1,125 @@
+/**
+ * Tests for defineCommand
+ */
+import { Command } from 'commander';
+import { describe, expect, it, vi } from 'vitest';
+import { defineCommand } from './define-command.js';
+describe('defineCommand', () => {
+  it('should create a command registration function', () => {
+    const handler = vi.fn();
+    const commandReg = defineCommand({
+      name: 'test',
+      description: 'Test command',
+      handler,
+    });
+    expect(commandReg).toBeTypeOf('function');
+  });
+  it('should register a command with the program', () => {
+    const program = new Command();
+    const handler = vi.fn();
+    const commandReg = defineCommand({
+      name: 'test',
+      description: 'Test command',
+      handler,
+    });
+    commandReg(program);
+    const commands = program.commands;
+    expect(commands).toHaveLength(1);
+    expect(commands[0]?.name()).toBe('test');
+  });
+  it('should register command with alias', () => {
+    const program = new Command();
+    const handler = vi.fn();
+    const commandReg = defineCommand({
+      name: 'test',
+      description: 'Test command',
+      alias: 't',
+      handler,
+    });
+    commandReg(program);
+    const command = program.commands[0];
+    expect(command?.alias()).toBe('t');
+  });
+  it('should register command with options', () => {
+    const program = new Command();
+    const handler = vi.fn();
+    const commandReg = defineCommand({
+      name: 'test',
+      description: 'Test command',
+      options: [
+        {
+          flags: '-f, --force',
+          description: 'Force flag',
+        },
+        {
+          flags: '-n, --name <name>',
+          description: 'Name option',
+          defaultValue: 'default',
+        },
+      ],
+      handler,
+    });
+    commandReg(program);
+    const command = program.commands[0];
+    const options = command?.options;
+    expect(options).toHaveLength(2);
+    expect(options?.[0]?.flags).toBe('-f, --force');
+    expect(options?.[1]?.flags).toBe('-n, --name <name>');
+  });
+  it('should call handler when command is executed', async () => {
+    const program = new Command();
+    const handler = vi.fn().mockResolvedValue(undefined);
+    const commandReg = defineCommand({
+      name: 'test <arg>',
+      description: 'Test command',
+      handler,
+    });
+    commandReg(program);
+    // Simulate command execution
+    await program.parseAsync(['node', 'test', 'test', 'myarg']);
+    expect(handler).toHaveBeenCalledWith(
+      'myarg',
+      expect.any(Object),
+      expect.any(Object),
+    );
+  });
+  it('should handle async handler errors', async () => {
+    const program = new Command();
+    const error = new Error('Test error');
+    const handler = vi.fn().mockRejectedValue(error);
+    const exitSpy = vi
+      .spyOn(process, 'exit')
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      .mockImplementation(() => {});
+    const commandReg = defineCommand({
+      name: 'test',
+      description: 'Test command',
+      handler,
+    });
+    commandReg(program);
+    await program.parseAsync(['node', 'test', 'test']);
+    expect(exitSpy).toHaveBeenCalledWith(1);
+    exitSpy.mockRestore();
+  });
+  it('should handle sync handler errors', async () => {
+    const program = new Command();
+    const error = new Error('Test error');
+    const handler = vi.fn().mockImplementation(() => {
+      throw error;
+    });
+    const exitSpy = vi
+      .spyOn(process, 'exit')
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      .mockImplementation(() => {});
+    const commandReg = defineCommand({
+      name: 'test',
+      description: 'Test command',
+      handler,
+    });
+    commandReg(program);
+    await program.parseAsync(['node', 'test', 'test']);
+    expect(exitSpy).toHaveBeenCalledWith(1);
+    exitSpy.mockRestore();
+  });
+});
+//# sourceMappingURL=define-command.test.js.map

package/dist/commands/define-command/define-command.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-command.test.js","sourceRoot":"","sources":["../../../src/commands/define-command/define-command.test.ts"],"names":[],"mappings":"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"}

package/dist/commands/define-command/define-command.types.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Command definition types
+ */
+import type { Command } from 'commander';
+export interface CommandOption {
+  description: string;
+  flags: string;
+  defaultValue?: string | boolean | string[];
+}
+export interface CommandConfig {
+  description: string;
+  handler: (...args: any[]) => Promise<void> | void;
+  name: string;
+  alias?: string;
+  options?: CommandOption[];
+}
+/**
+ * Type for a command registration function
+ * Takes a Commander program and registers a command with it
+ */
+export type CommandRegistration = (program: Command) => void;
+/**
+ * Type for the defineCommand function.
+ *
+ * Define a CLI command with declarative configuration.
+ * This function takes a command configuration object and returns a function
+ * that registers the command with a Commander program.
+ *
+ * @param config - Command configuration object containing name, description, options, and handler
+ * @returns Function that registers the command with a Commander program
+ *
+ * @example
+ * ```typescript
+ * export const listCommand = defineCommand({
+ *   name: 'list [filter]',
+ *   description: '📊 List all tasks',
+ *   alias: 'ls',
+ *   options: [
+ *     { flags: '-s, --status <status>', description: 'Filter by status' }
+ *   ],
+ *   handler: async (filter, options) => {
+ *     // Implementation
+ *   }
+ * });
+ * ```
+ */
+export type DefineCommandFunction = (
+  config: CommandConfig,
+) => CommandRegistration;

package/dist/commands/define-command/define-command.types.js

@@ -0,0 +1,5 @@
+/**
+ * Command definition types
+ */
+export {};
+//# sourceMappingURL=define-command.types.js.map

package/dist/commands/define-command/define-command.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-command.types.js","sourceRoot":"","sources":["../../../src/commands/define-command/define-command.types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/commands/define-command/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Command definition exports
+ */
+export * from './define-command.js';
+export * from './define-command.types.js';

package/dist/commands/define-command/index.js

@@ -0,0 +1,6 @@
+/**
+ * Command definition exports
+ */
+export * from './define-command.js';
+export * from './define-command.types.js';
+//# sourceMappingURL=index.js.map

package/dist/commands/define-command/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/define-command/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC"}

package/dist/commands/finish.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Finish command - Complete a task
+ */
+export declare const finishCommand: import('./define-command/define-command.types.js').CommandRegistration;

package/dist/commands/finish.js

@@ -0,0 +1,69 @@
+/**
+ * Finish command - Complete a task
+ */
+import { FileSystemTaskProvider } from '@taskin/fs-task-provider';
+import { TaskManager } from '@taskin/task-manager';
+import path from 'path';
+import { colors, error, info, printHeader, success } from '../lib/colors.js';
+import { defineCommand } from './define-command/index.js';
+export const finishCommand = defineCommand({
+  name: 'finish <task-id>',
+  description: '✅ Complete a task',
+  alias: 'done',
+  options: [
+    {
+      flags: '-s, --skip-update',
+      description: 'Skip updating task status',
+    },
+  ],
+  handler: async (taskId, options) => {
+    await finishTask(taskId, options);
+  },
+});
+async function finishTask(taskId, options) {
+  printHeader(`Finishing Task ${taskId}`, '✅');
+  // Normalize task ID
+  const normalizedId = taskId.replace(/^task-/, '').padStart(3, '0');
+  // Find TASKS directory
+  const tasksDir = path.join(process.cwd(), 'TASKS');
+  // Initialize task manager
+  const taskProvider = new FileSystemTaskProvider(tasksDir);
+  const taskManager = new TaskManager(taskProvider);
+  // Find task
+  const task = await taskProvider.findTask(normalizedId);
+  if (!task) {
+    error(`Task ${normalizedId} not found in TASKS/ directory`);
+    process.exit(1);
+  }
+  info(`Found task: ${task.title}`);
+  info(`Current status: ${task.status}`);
+  // Check if task is already done
+  if (task.status === 'done') {
+    error('Task is already done');
+    process.exit(1);
+  }
+  if (!options.skipUpdate) {
+    info('Marking task as done...');
+    const updatedTask = await taskManager.finishTask(task.id);
+    success(`Task ${updatedTask.id} completed successfully! 🎉`);
+    success(`Status changed to: ${updatedTask.status}`);
+  } else {
+    info('Skipping status update (--skip-update flag)');
+  }
+  console.log();
+  info('Suggested commit message:');
+  const commitType = task.type || 'feat';
+  console.log(
+    colors.highlight(`  ${commitType}(task-${normalizedId}): ${task.title}`),
+  );
+  console.log();
+  info('Next steps:');
+  console.log(colors.secondary('  1. Review your changes'));
+  console.log(colors.secondary('  2. Commit: git add . && git commit'));
+  console.log(colors.secondary('  3. Push: git push'));
+  console.log(colors.secondary('  4. Create a Pull Request'));
+  console.log();
+  success('Great work! 🚀');
+  console.log();
+}
+//# sourceMappingURL=finish.js.map

package/dist/commands/finish.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"finish.js","sourceRoot":"","sources":["../../src/commands/finish.ts"],"names":[],"mappings":"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"}

package/dist/commands/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * CLI commands exports
+ */
+export * from './finish.js';
+export * from './init.js';
+export * from './lint.js';
+export * from './list.js';
+export * from './pause.js';
+export * from './start.js';

package/dist/commands/index.js

@@ -0,0 +1,10 @@
+/**
+ * CLI commands exports
+ */
+export * from './finish.js';
+export * from './init.js';
+export * from './lint.js';
+export * from './list.js';
+export * from './pause.js';
+export * from './start.js';
+//# sourceMappingURL=index.js.map

package/dist/commands/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC"}

package/dist/commands/init.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Init command - Initialize Taskin in the current project
+ */
+export declare const initCommand: import('./define-command/define-command.types.js').CommandRegistration;