taskin 0.1.0-beta.0

package/dist/lib/provider-registry/index.js

@@ -0,0 +1,6 @@
+/**
+ * Provider registry exports
+ */
+export * from './provider-registry.js';
+export * from './provider-registry.types.js';
+//# sourceMappingURL=index.js.map

package/dist/lib/provider-registry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/provider-registry/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC"}

package/dist/lib/provider-registry/provider-registry.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Provider registry
+ * Central registry of available task providers
+ */
+import type { ProviderInfo } from './provider-registry.types.js';
+export declare const AVAILABLE_PROVIDERS: ProviderInfo[];
+export declare function getProviderById(id: string): ProviderInfo | undefined;
+export declare function getAvailableProviders(): ProviderInfo[];
+export declare function getAllProviders(): ProviderInfo[];

package/dist/lib/provider-registry/provider-registry.js

@@ -0,0 +1,111 @@
+/**
+ * Provider registry
+ * Central registry of available task providers
+ */
+export const AVAILABLE_PROVIDERS = [
+  {
+    id: 'fs',
+    name: '📁 File System',
+    description: 'Store tasks as Markdown files in a local TASKS/ directory',
+    packageName: '@taskin/fs-task-provider',
+    configSchema: {
+      required: ['tasksDir'],
+      properties: {
+        tasksDir: {
+          type: 'string',
+          description: 'Directory to store task files',
+        },
+      },
+    },
+    status: 'stable',
+  },
+  {
+    id: 'redmine',
+    name: '🔴 Redmine',
+    description: 'Sync tasks with Redmine issues via REST API',
+    packageName: '@taskin/redmine-task-provider',
+    configSchema: {
+      required: ['apiUrl', 'apiKey', 'projectId'],
+      properties: {
+        apiUrl: {
+          type: 'string',
+          description: 'Redmine server URL (e.g., https://redmine.example.com)',
+        },
+        apiKey: {
+          type: 'string',
+          description: 'Your Redmine API key',
+          secret: true,
+        },
+        projectId: {
+          type: 'string',
+          description: 'Project identifier or ID',
+        },
+      },
+    },
+    status: 'coming-soon',
+  },
+  {
+    id: 'jira',
+    name: '🔵 Jira',
+    description: 'Sync tasks with Jira issues via REST API',
+    packageName: '@taskin/jira-task-provider',
+    configSchema: {
+      required: ['apiUrl', 'email', 'apiToken', 'projectKey'],
+      properties: {
+        apiUrl: {
+          type: 'string',
+          description: 'Jira server URL (e.g., https://company.atlassian.net)',
+        },
+        email: {
+          type: 'string',
+          description: 'Your Atlassian account email',
+        },
+        apiToken: {
+          type: 'string',
+          description: 'Your Jira API token',
+          secret: true,
+        },
+        projectKey: {
+          type: 'string',
+          description: 'Project key (e.g., PROJ)',
+        },
+      },
+    },
+    status: 'coming-soon',
+  },
+  {
+    id: 'github',
+    name: '🐙 GitHub Issues',
+    description: 'Sync tasks with GitHub Issues',
+    packageName: '@taskin/github-task-provider',
+    configSchema: {
+      required: ['owner', 'repo', 'token'],
+      properties: {
+        owner: {
+          type: 'string',
+          description: 'Repository owner (username or organization)',
+        },
+        repo: {
+          type: 'string',
+          description: 'Repository name',
+        },
+        token: {
+          type: 'string',
+          description: 'GitHub Personal Access Token',
+          secret: true,
+        },
+      },
+    },
+    status: 'coming-soon',
+  },
+];
+export function getProviderById(id) {
+  return AVAILABLE_PROVIDERS.find((p) => p.id === id);
+}
+export function getAvailableProviders() {
+  return AVAILABLE_PROVIDERS.filter((p) => p.status !== 'coming-soon');
+}
+export function getAllProviders() {
+  return AVAILABLE_PROVIDERS;
+}
+//# sourceMappingURL=provider-registry.js.map

package/dist/lib/provider-registry/provider-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-registry.js","sourceRoot":"","sources":["../../../src/lib/provider-registry/provider-registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,CAAC,MAAM,mBAAmB,GAAmB;IACjD;QACE,EAAE,EAAE,IAAI;QACR,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE,2DAA2D;QACxE,WAAW,EAAE,0BAA0B;QACvC,YAAY,EAAE;YACZ,QAAQ,EAAE,CAAC,UAAU,CAAC;YACtB,UAAU,EAAE;gBACV,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,+BAA+B;iBAC7C;aACF;SACF;QACD,MAAM,EAAE,QAAQ;KACjB;IACD;QACE,EAAE,EAAE,SAAS;QACb,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,6CAA6C;QAC1D,WAAW,EAAE,+BAA+B;QAC5C,YAAY,EAAE;YACZ,QAAQ,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,WAAW,CAAC;YAC3C,UAAU,EAAE;gBACV,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,wDAAwD;iBACtE;gBACD,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,sBAAsB;oBACnC,MAAM,EAAE,IAAI;iBACb;gBACD,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,0BAA0B;iBACxC;aACF;SACF;QACD,MAAM,EAAE,aAAa;KACtB;IACD;QACE,EAAE,EAAE,MAAM;QACV,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,0CAA0C;QACvD,WAAW,EAAE,4BAA4B;QACzC,YAAY,EAAE;YACZ,QAAQ,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,YAAY,CAAC;YACvD,UAAU,EAAE;gBACV,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,uDAAuD;iBACrE;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,8BAA8B;iBAC5C;gBACD,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,qBAAqB;oBAClC,MAAM,EAAE,IAAI;iBACb;gBACD,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,0BAA0B;iBACxC;aACF;SACF;QACD,MAAM,EAAE,aAAa;KACtB;IACD;QACE,EAAE,EAAE,QAAQ;QACZ,IAAI,EAAE,kBAAkB;QACxB,WAAW,EAAE,+BAA+B;QAC5C,WAAW,EAAE,8BAA8B;QAC3C,YAAY,EAAE;YACZ,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC;YACpC,UAAU,EAAE;gBACV,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,6CAA6C;iBAC3D;gBACD,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,iBAAiB;iBAC/B;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,8BAA8B;oBAC3C,MAAM,EAAE,IAAI;iBACb;aACF;SACF;QACD,MAAM,EAAE,aAAa;KACtB;CACF,CAAC;AAEF,MAAM,UAAU,eAAe,CAAC,EAAU;IACxC,OAAO,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,OAAO,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,aAAa,CAAC,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,mBAAmB,CAAC;AAC7B,CAAC"}

package/dist/lib/provider-registry/provider-registry.types.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Provider registry types
+ * Re-exports from @taskin/types-ts for convenience
+ */
+export type { ProviderInfo } from '@taskin/types-ts';

package/dist/lib/provider-registry/provider-registry.types.js

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

package/dist/lib/provider-registry/provider-registry.types.js.map

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

package/dist/lib/provider-registry.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Provider registry
+ * Central registry of available task providers
+ */
+export interface ProviderInfo {
+  configSchema: {
+    properties: Record<
+      string,
+      {
+        description: string;
+        type: string;
+        secret?: boolean;
+      }
+    >;
+    required: string[];
+  };
+  description: string;
+  id: string;
+  name: string;
+  packageName: string;
+  status: 'stable' | 'beta' | 'coming-soon';
+}
+export declare const AVAILABLE_PROVIDERS: ProviderInfo[];
+export declare function getProviderById(id: string): ProviderInfo | undefined;
+export declare function getAvailableProviders(): ProviderInfo[];
+export declare function getAllProviders(): ProviderInfo[];

package/dist/lib/provider-registry.js

@@ -0,0 +1,111 @@
+/**
+ * Provider registry
+ * Central registry of available task providers
+ */
+export const AVAILABLE_PROVIDERS = [
+  {
+    id: 'fs',
+    name: '📁 File System',
+    description: 'Store tasks as Markdown files in a local TASKS/ directory',
+    packageName: '@taskin/fs-task-provider',
+    configSchema: {
+      required: ['tasksDir'],
+      properties: {
+        tasksDir: {
+          type: 'string',
+          description: 'Directory to store task files',
+        },
+      },
+    },
+    status: 'stable',
+  },
+  {
+    id: 'redmine',
+    name: '🔴 Redmine',
+    description: 'Sync tasks with Redmine issues via REST API',
+    packageName: '@taskin/redmine-task-provider',
+    configSchema: {
+      required: ['apiUrl', 'apiKey', 'projectId'],
+      properties: {
+        apiUrl: {
+          type: 'string',
+          description: 'Redmine server URL (e.g., https://redmine.example.com)',
+        },
+        apiKey: {
+          type: 'string',
+          description: 'Your Redmine API key',
+          secret: true,
+        },
+        projectId: {
+          type: 'string',
+          description: 'Project identifier or ID',
+        },
+      },
+    },
+    status: 'coming-soon',
+  },
+  {
+    id: 'jira',
+    name: '🔵 Jira',
+    description: 'Sync tasks with Jira issues via REST API',
+    packageName: '@taskin/jira-task-provider',
+    configSchema: {
+      required: ['apiUrl', 'email', 'apiToken', 'projectKey'],
+      properties: {
+        apiUrl: {
+          type: 'string',
+          description: 'Jira server URL (e.g., https://company.atlassian.net)',
+        },
+        email: {
+          type: 'string',
+          description: 'Your Atlassian account email',
+        },
+        apiToken: {
+          type: 'string',
+          description: 'Your Jira API token',
+          secret: true,
+        },
+        projectKey: {
+          type: 'string',
+          description: 'Project key (e.g., PROJ)',
+        },
+      },
+    },
+    status: 'coming-soon',
+  },
+  {
+    id: 'github',
+    name: '🐙 GitHub Issues',
+    description: 'Sync tasks with GitHub Issues',
+    packageName: '@taskin/github-task-provider',
+    configSchema: {
+      required: ['owner', 'repo', 'token'],
+      properties: {
+        owner: {
+          type: 'string',
+          description: 'Repository owner (username or organization)',
+        },
+        repo: {
+          type: 'string',
+          description: 'Repository name',
+        },
+        token: {
+          type: 'string',
+          description: 'GitHub Personal Access Token',
+          secret: true,
+        },
+      },
+    },
+    status: 'coming-soon',
+  },
+];
+export function getProviderById(id) {
+  return AVAILABLE_PROVIDERS.find((p) => p.id === id);
+}
+export function getAvailableProviders() {
+  return AVAILABLE_PROVIDERS.filter((p) => p.status !== 'coming-soon');
+}
+export function getAllProviders() {
+  return AVAILABLE_PROVIDERS;
+}
+//# sourceMappingURL=provider-registry.js.map

package/dist/lib/provider-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-registry.js","sourceRoot":"","sources":["../../src/lib/provider-registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAkBH,MAAM,CAAC,MAAM,mBAAmB,GAAmB;IACjD;QACE,EAAE,EAAE,IAAI;QACR,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE,2DAA2D;QACxE,WAAW,EAAE,0BAA0B;QACvC,YAAY,EAAE;YACZ,QAAQ,EAAE,CAAC,UAAU,CAAC;YACtB,UAAU,EAAE;gBACV,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,+BAA+B;iBAC7C;aACF;SACF;QACD,MAAM,EAAE,QAAQ;KACjB;IACD;QACE,EAAE,EAAE,SAAS;QACb,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,6CAA6C;QAC1D,WAAW,EAAE,+BAA+B;QAC5C,YAAY,EAAE;YACZ,QAAQ,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,WAAW,CAAC;YAC3C,UAAU,EAAE;gBACV,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,wDAAwD;iBACtE;gBACD,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,sBAAsB;oBACnC,MAAM,EAAE,IAAI;iBACb;gBACD,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,0BAA0B;iBACxC;aACF;SACF;QACD,MAAM,EAAE,aAAa;KACtB;IACD;QACE,EAAE,EAAE,MAAM;QACV,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,0CAA0C;QACvD,WAAW,EAAE,4BAA4B;QACzC,YAAY,EAAE;YACZ,QAAQ,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,YAAY,CAAC;YACvD,UAAU,EAAE;gBACV,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,uDAAuD;iBACrE;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,8BAA8B;iBAC5C;gBACD,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,qBAAqB;oBAClC,MAAM,EAAE,IAAI;iBACb;gBACD,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,0BAA0B;iBACxC;aACF;SACF;QACD,MAAM,EAAE,aAAa;KACtB;IACD;QACE,EAAE,EAAE,QAAQ;QACZ,IAAI,EAAE,kBAAkB;QACxB,WAAW,EAAE,+BAA+B;QAC5C,WAAW,EAAE,8BAA8B;QAC3C,YAAY,EAAE;YACZ,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC;YACpC,UAAU,EAAE;gBACV,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,6CAA6C;iBAC3D;gBACD,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,iBAAiB;iBAC/B;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,8BAA8B;oBAC3C,MAAM,EAAE,IAAI;iBACb;aACF;SACF;QACD,MAAM,EAAE,aAAa;KACtB;CACF,CAAC;AAEF,MAAM,UAAU,eAAe,CAAC,EAAU;IACxC,OAAO,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,OAAO,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,aAAa,CAAC,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,mBAAmB,CAAC;AAC7B,CAAC"}

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

@@ -0,0 +1,5 @@
+/**
+ * Task linter exports
+ */
+export * from './task-linter.js';
+export * from './task-linter.types.js';

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

@@ -0,0 +1,6 @@
+/**
+ * Task linter exports
+ */
+export * from './task-linter.js';
+export * from './task-linter.types.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/task-linter/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC"}

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

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

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

@@ -0,0 +1,219 @@
+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'];
+/**
+ * FileSystem-specific TaskLinter implementation
+ * Validates task markdown files in the local filesystem
+ */
+export class TaskLinter {
+  errors = [];
+  addError(file, message, severity = 'error', line) {
+    this.errors.push({ file, message, severity, line });
+  }
+  /**
+   * Validate task file name format (FileSystem-specific)
+   */
+  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 (FileSystem-specific)
+   */
+  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 (FileSystem-specific)
+   */
+  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 (FileSystem-specific)
+   */
+  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/task-linter.js.map

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

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

@@ -0,0 +1,52 @@
+/**
+ * Task linter types
+ * Re-exports from @taskin/types-ts + FileSystem-specific extensions
+ */
+import type { TaskValidationIssue } from '@taskin/types-ts';
+export type { TaskMetadata, TaskValidationIssue } from '@taskin/types-ts';
+/**
+ * FileSystem-specific validation error
+ * Extends TaskValidationIssue with file-specific information
+ */
+export interface FileValidationError
+  extends Omit<TaskValidationIssue, 'taskId'> {
+  file: string;
+}
+/**
+ * FileSystem-specific lint result
+ * Contains file-based validation results
+ */
+export interface FileLintResult {
+  errors: FileValidationError[];
+  filesChecked: number;
+  valid: boolean;
+  warnings: FileValidationError[];
+}
+/**
+ * FileSystem-specific task linter interface
+ * Defines validation operations for file-based task providers
+ */
+export interface IFileSystemTaskLinter {
+  /**
+   * Lint all task files in a directory
+   * @param tasksDir - Directory containing task markdown files
+   * @returns Validation results for all files
+   */
+  lintDirectory(tasksDir: string): Promise<FileLintResult>;
+  /**
+   * Lint a single task file
+   * @param filePath - Path to the task markdown file
+   * @returns Array of validation errors found in the file
+   */
+  lintFile(filePath: string): Promise<FileValidationError[]>;
+  /**
+   * Validate task metadata
+   * @param metadata - Task metadata to validate
+   * @param fileName - Name of the file being validated
+   * @returns Array of validation errors
+   */
+  validateMetadata(
+    metadata: Record<string, unknown>,
+    fileName: string,
+  ): FileValidationError[];
+}

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

@@ -0,0 +1,6 @@
+/**
+ * Task linter types
+ * Re-exports from @taskin/types-ts + FileSystem-specific extensions
+ */
+export {};
+//# sourceMappingURL=task-linter.types.js.map

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

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