taskin 0.1.0-beta.0

package/dist/lib/task-linter.d.ts

@@ -0,0 +1,29 @@
+import type {
+  ITaskLinter,
+  LintResult,
+  TaskMetadata,
+  ValidationError,
+} from './task-linter.types.js';
+export declare class TaskLinter implements ITaskLinter {
+  private errors;
+  private addError;
+  /**
+   * Validate task file name format
+   */
+  validateFileName(fileName: string): ValidationError | null;
+  private extractMetadata;
+  /**
+   * Validate task metadata
+   */
+  validateMetadata(metadata: TaskMetadata, filePath: string): ValidationError[];
+  private validateContent;
+  /**
+   * Lint a single task file
+   */
+  lintFile(filePath: string): Promise<ValidationError[]>;
+  /**
+   * Lint all task files in the specified directory
+   */
+  lintDirectory(tasksDir: string): Promise<LintResult>;
+  static printResults(result: LintResult): void;
+}

package/dist/lib/task-linter.js

@@ -0,0 +1,215 @@
+import chalk from 'chalk';
+import { readdir, readFile } from 'fs/promises';
+import { join } from 'path';
+const VALID_STATUSES = ['pending', 'in-progress', 'done', 'blocked'];
+const VALID_TYPES = ['feat', 'fix', 'chore', 'docs', 'refactor', 'test'];
+export class TaskLinter {
+  errors = [];
+  addError(file, message, severity = 'error', line) {
+    this.errors.push({ file, message, severity, line });
+  }
+  /**
+   * Validate task file name format
+   */
+  validateFileName(fileName) {
+    const pattern = /^task-\d{2,3}-[a-z0-9-]+\.md$/;
+    if (!pattern.test(fileName)) {
+      return {
+        file: fileName,
+        message: 'Invalid filename. Expected: task-NNN-kebab-case-title.md',
+        severity: 'error',
+      };
+    }
+    return null;
+  }
+  extractMetadata(content) {
+    const headerSection = content.split(/^##/m)[0];
+    const statusMatch = headerSection.match(/^Status:\s*(.+)$/im);
+    const typeMatch = headerSection.match(/^Type:\s*(.+)$/im);
+    const assigneeMatch = headerSection.match(/^Assignee:\s*(.+)$/im);
+    return {
+      status: statusMatch?.[1]?.trim().toLowerCase(),
+      type: typeMatch?.[1]?.trim().toLowerCase(),
+      assignee: assigneeMatch?.[1]?.trim(),
+    };
+  }
+  /**
+   * Validate task metadata
+   */
+  validateMetadata(metadata, filePath) {
+    const errors = [];
+    if (!metadata.status) {
+      errors.push({
+        file: filePath,
+        message: 'Missing required metadata: Status',
+        severity: 'error',
+      });
+    } else if (!VALID_STATUSES.includes(metadata.status)) {
+      errors.push({
+        file: filePath,
+        message: `Invalid status "${metadata.status}". Valid: ${VALID_STATUSES.join(', ')}`,
+        severity: 'error',
+      });
+    }
+    if (!metadata.type) {
+      errors.push({
+        file: filePath,
+        message: 'Missing required metadata: Type',
+        severity: 'error',
+      });
+    } else if (!VALID_TYPES.includes(metadata.type)) {
+      errors.push({
+        file: filePath,
+        message: `Invalid type "${metadata.type}". Valid: ${VALID_TYPES.join(', ')}`,
+        severity: 'error',
+      });
+    }
+    if (!metadata.assignee) {
+      errors.push({
+        file: filePath,
+        message: 'Missing recommended metadata: Assignee',
+        severity: 'warning',
+      });
+    }
+    return errors;
+  }
+  validateContent(filename, content) {
+    const lines = content.split('\n');
+    // Check H1 heading
+    if (!lines[0]?.trim().startsWith('# ')) {
+      this.addError(
+        filename,
+        'Task file must start with a level 1 heading (# Task NNN — Title)',
+        'error',
+        1,
+      );
+    }
+    const h1Pattern = /^#\s+(?:🧩\s+)?Task\s+\d{2,3}\s+[—-]\s+.+$/i;
+    if (lines[0] && !h1Pattern.test(lines[0])) {
+      this.addError(
+        filename,
+        'H1 heading must follow format: "# Task NNN — Title"',
+        'error',
+        1,
+      );
+    }
+    const metadata = this.extractMetadata(content);
+    const metadataErrors = this.validateMetadata(metadata, filename);
+    metadataErrors.forEach((error) => {
+      this.addError(error.file, error.message, error.severity, error.line);
+    });
+    const h2Sections = content.match(/^##\s+.+$/gm);
+    if (!h2Sections || h2Sections.length === 0) {
+      this.addError(
+        filename,
+        'Task should have at least one section (## heading)',
+        'warning',
+      );
+    }
+    const firstH2Index = content.indexOf('\n##');
+    if (firstH2Index > -1) {
+      const afterH2 = content.substring(firstH2Index);
+      if (
+        afterH2.match(/^Status:/im) ||
+        afterH2.match(/^Type:/im) ||
+        afterH2.match(/^Assignee:/im)
+      ) {
+        this.addError(
+          filename,
+          'Metadata must be placed BEFORE the first ## section',
+          'error',
+        );
+      }
+    }
+  }
+  /**
+   * Lint a single task file
+   */
+  async lintFile(filePath) {
+    const errors = [];
+    // Validate filename
+    const fileName = filePath.split('/').pop() || filePath;
+    const fileNameError = this.validateFileName(fileName);
+    if (fileNameError) {
+      errors.push(fileNameError);
+    }
+    // Read and validate content
+    try {
+      const content = await readFile(filePath, 'utf-8');
+      this.errors = [];
+      this.validateContent(fileName, content);
+      errors.push(...this.errors);
+    } catch (error) {
+      errors.push({
+        file: fileName,
+        message: `Failed to read file: ${error}`,
+        severity: 'error',
+      });
+    }
+    return errors;
+  }
+  /**
+   * Lint all task files in the specified directory
+   */
+  async lintDirectory(tasksDir) {
+    this.errors = [];
+    try {
+      const files = await readdir(tasksDir);
+      const taskFiles = files.filter((f) => f.endsWith('.md'));
+      for (const file of taskFiles) {
+        const fileNameError = this.validateFileName(file);
+        if (fileNameError) {
+          this.addError(file, fileNameError.message, fileNameError.severity);
+        }
+        const content = await readFile(join(tasksDir, file), 'utf-8');
+        this.validateContent(file, content);
+      }
+      const errors = this.errors.filter((e) => e.severity === 'error');
+      const warnings = this.errors.filter((e) => e.severity === 'warning');
+      return {
+        errors,
+        warnings,
+        filesChecked: taskFiles.length,
+        valid: errors.length === 0,
+      };
+    } catch (error) {
+      throw new Error(`Failed to lint tasks: ${error}`);
+    }
+  }
+  static printResults(result) {
+    if (result.errors.length === 0 && result.warnings.length === 0) {
+      console.log(
+        chalk.green(`✅ All ${result.filesChecked} task files are valid!\n`),
+      );
+      return;
+    }
+    console.log(
+      chalk.bold(
+        `\n📊 Validation Results (${result.filesChecked} files checked):\n`,
+      ),
+    );
+    const errorsByFile = new Map();
+    [...result.errors, ...result.warnings].forEach((error) => {
+      if (!errorsByFile.has(error.file)) {
+        errorsByFile.set(error.file, []);
+      }
+      errorsByFile.get(error.file).push(error);
+    });
+    for (const [file, fileErrors] of errorsByFile) {
+      console.log(chalk.cyan(`\n📄 ${file}`));
+      for (const error of fileErrors) {
+        const icon =
+          error.severity === 'error' ? chalk.red('❌') : chalk.yellow('⚠️');
+        const location = error.line ? `:${error.line}` : '';
+        console.log(`  ${icon} ${error.message}${location}`);
+      }
+    }
+    console.log('\n' + '─'.repeat(60));
+    console.log(
+      chalk.bold(
+        `\n📊 Summary: ${chalk.red(result.errors.length + ' error(s)')}, ${chalk.yellow(result.warnings.length + ' warning(s)')}\n`,
+      ),
+    );
+  }
+}
+//# sourceMappingURL=task-linter.js.map

package/dist/lib/task-linter.js.map

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

package/dist/lib/task-linter.types.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Task linter types
+ */
+export interface ValidationError {
+  file: string;
+  message: string;
+  severity: 'error' | 'warning';
+  line?: number;
+}
+export interface TaskMetadata {
+  assignee?: string;
+  status?: string;
+  type?: string;
+}
+export interface LintResult {
+  errors: ValidationError[];
+  filesChecked: number;
+  valid: boolean;
+  warnings: ValidationError[];
+}
+export interface ITaskLinter {
+  /**
+   * Lint all task files in the specified directory
+   */
+  lintDirectory(tasksDir: string): Promise<LintResult>;
+  /**
+   * Lint a single task file
+   */
+  lintFile(filePath: string): Promise<ValidationError[]>;
+  /**
+   * Validate task file name format
+   */
+  validateFileName(fileName: string): ValidationError | null;
+  /**
+   * Validate task metadata
+   */
+  validateMetadata(metadata: TaskMetadata, filePath: string): ValidationError[];
+}

package/dist/lib/task-linter.types.js

@@ -0,0 +1,5 @@
+/**
+ * Task linter types
+ */
+export {};
+//# sourceMappingURL=task-linter.types.js.map

package/dist/lib/task-linter.types.js.map

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

package/dist/main.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Main entry point for Taskin CLI
+ * Handles dependency injection and initialization
+ */
+import { Taskin } from './taskin.js';
+/**
+ * Factory function to create a configured Taskin instance
+ */
+export declare function createTaskin(tasksDir?: string): Taskin;
+/**
+ * Get the default Taskin instance
+ * Uses current working directory TASKS folder
+ */
+export declare function getTaskin(): Taskin;

package/dist/main.js

@@ -0,0 +1,29 @@
+/**
+ * Main entry point for Taskin CLI
+ * Handles dependency injection and initialization
+ */
+import { FileSystemTaskProvider } from '@taskin/fs-task-provider';
+import { TaskManager } from '@taskin/task-manager';
+import { join } from 'path';
+import { FileSystemTaskLinter } from './lib/file-system-task-linter/index.js';
+import { Taskin } from './taskin.js';
+/**
+ * Factory function to create a configured Taskin instance
+ */
+export function createTaskin(tasksDir) {
+  const resolvedTasksDir = tasksDir || join(process.cwd(), 'TASKS');
+  // Initialize dependencies
+  const taskProvider = new FileSystemTaskProvider(resolvedTasksDir);
+  const taskManager = new TaskManager(taskProvider);
+  const linter = new FileSystemTaskLinter();
+  // Create and return Taskin instance with injected dependencies
+  return new Taskin(taskProvider, taskManager, linter);
+}
+/**
+ * Get the default Taskin instance
+ * Uses current working directory TASKS folder
+ */
+export function getTaskin() {
+  return createTaskin();
+}
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AAC9E,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,QAAiB;IAC5C,MAAM,gBAAgB,GAAG,QAAQ,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,CAAC;IAElE,0BAA0B;IAC1B,MAAM,YAAY,GAAG,IAAI,sBAAsB,CAAC,gBAAgB,CAAC,CAAC;IAClE,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC,YAAY,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAE1C,+DAA+D;IAC/D,OAAO,IAAI,MAAM,CAAC,YAAY,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;AACvD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS;IACvB,OAAO,YAAY,EAAE,CAAC;AACxB,CAAC"}

package/dist/taskin.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Taskin - Concrete implementation of ITaskin
+ * Main class that implements task management with dependency injection
+ */
+import type { FileSystemTaskProvider } from '@taskin/fs-task-provider';
+import type { TaskManager } from '@taskin/task-manager';
+import type {
+  FinishTaskOptions,
+  ITaskin,
+  LintResult,
+  LintTasksOptions,
+  ListTasksOptions,
+  PauseTaskOptions,
+  StartTaskOptions,
+  Task,
+  TaskId,
+} from '@taskin/types-ts';
+import type { FileSystemTaskLinter } from './lib/file-system-task-linter/file-system-task-linter.js';
+export declare class Taskin implements ITaskin {
+  private readonly taskProvider;
+  private readonly taskManager;
+  private readonly linter;
+  constructor(
+    taskProvider: FileSystemTaskProvider,
+    taskManager: TaskManager,
+    linter: FileSystemTaskLinter,
+  );
+  list(options?: ListTasksOptions): Promise<Task[]>;
+  start(taskId: TaskId, options?: StartTaskOptions): Promise<void>;
+  pause(taskId: TaskId, options?: PauseTaskOptions): Promise<void>;
+  finish(taskId: TaskId, _options?: FinishTaskOptions): Promise<void>;
+  lint(options?: LintTasksOptions): Promise<LintResult>;
+}

package/dist/taskin.js

@@ -0,0 +1,101 @@
+/**
+ * Taskin - Concrete implementation of ITaskin
+ * Main class that implements task management with dependency injection
+ */
+export class Taskin {
+  taskProvider;
+  taskManager;
+  linter;
+  constructor(taskProvider, taskManager, linter) {
+    this.taskProvider = taskProvider;
+    this.taskManager = taskManager;
+    this.linter = linter;
+  }
+  async list(options) {
+    const tasks = await this.taskProvider.getAllTasks();
+    // Convert TaskFile to Task and apply filters
+    return tasks
+      .map((taskFile) => {
+        // Map TaskFile to Task
+        const task = {
+          createdAt: taskFile.createdAt,
+          id: taskFile.id,
+          status: taskFile.status,
+          title: taskFile.title,
+          type: taskFile.type,
+          assignee: taskFile.userId, // Map userId to assignee
+        };
+        return task;
+      })
+      .filter((task) => {
+        if (options?.status && task.status !== options.status) {
+          return false;
+        }
+        if (options?.type && task.type !== options.type) {
+          return false;
+        }
+        if (options?.assignee && task.assignee !== options.assignee) {
+          return false;
+        }
+        return true;
+      });
+  }
+  async start(taskId, options) {
+    const task = await this.taskProvider.findTask(taskId);
+    if (!task) {
+      throw new Error(`Task not found: ${taskId}`);
+    }
+    await this.taskManager.startTask(taskId);
+    // TODO: Handle options.force and options.base when git integration is ready
+    if (options?.force) {
+      // Force start implementation
+    }
+    if (options?.base) {
+      // Base branch implementation
+    }
+  }
+  async pause(taskId, options) {
+    const task = await this.taskProvider.findTask(taskId);
+    if (!task) {
+      throw new Error(`Task not found: ${taskId}`);
+    }
+    // TODO: Implement pause logic with git operations
+    if (!options?.skipCommit) {
+      // Commit changes
+      task.status = 'pending';
+      await this.taskProvider.updateTask(task);
+    }
+    if (options?.message) {
+      // Use custom commit message
+    }
+  }
+  async finish(taskId, _options) {
+    const task = await this.taskProvider.findTask(taskId);
+    if (!task) {
+      throw new Error(`Task not found: ${taskId}`);
+    }
+    await this.taskManager.finishTask(taskId);
+  }
+  async lint(options) {
+    const lintPath = options?.path || 'TASKS';
+    const fileResult = await this.linter.lintDirectory(lintPath);
+    // Convert FileSystem-specific result to provider-agnostic result
+    return {
+      errors: fileResult.errors.map((e) => ({
+        taskId: e.file,
+        message: e.message,
+        severity: e.severity,
+        line: e.line,
+      })),
+      warnings: fileResult.warnings.map((e) => ({
+        taskId: e.file,
+        message: e.message,
+        severity: e.severity,
+        line: e.line,
+      })),
+      tasksChecked: fileResult.filesChecked,
+      valid: fileResult.valid,
+    };
+  }
+}
+//# sourceMappingURL=taskin.js.map

package/dist/taskin.js.map

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

package/package.json

@@ -0,0 +1,81 @@
+{
+  "name": "taskin",
+  "version": "0.1.0-beta.0",
+  "description": "Task management system integrated with Git workflows",
+  "keywords": [
+    "task",
+    "management",
+    "git",
+    "workflow",
+    "cli",
+    "productivity",
+    "task-tracker",
+    "project-management",
+    "developer-tools",
+    "taskin"
+  ],
+  "homepage": "https://opentask.com.br",
+  "bugs": {
+    "url": "https://github.com/opentask-app/taskin/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/opentask-app/taskin.git",
+    "directory": "packages/cli"
+  },
+  "license": "MIT",
+  "author": {
+    "name": "OpenTask",
+    "email": "contato@opentask.com.br",
+    "url": "https://opentask.com.br"
+  },
+  "contributors": [
+    {
+      "name": "Sidarta Veloso",
+      "email": "sidartaveloso@gmail.com"
+    }
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "bin": {
+    "taskin": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist coverage .turbo",
+    "dev": "tsc --watch",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "prepublishOnly": "pnpm build",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@taskin/core": "workspace:*",
+    "@taskin/fs-task-provider": "workspace:*",
+    "@taskin/git-utils": "workspace:*",
+    "@taskin/task-manager": "workspace:*",
+    "@taskin/types-ts": "workspace:*",
+    "@taskin/utils": "workspace:*",
+    "@types/inquirer": "^9.0.9",
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "inquirer": "^12.10.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.14.10",
+    "eslint": "^8.57.0",
+    "typescript": "^5.5.3",
+    "vitest": "^1.6.0"
+  }
+}