@sppg2001/atomize 0.0.1

package/package.json

@@ -0,0 +1,81 @@
+{
+  "name": "@sppg2001/atomize",
+  "version": "0.0.1",
+  "description": "⚛️ Automatically generate tasks from user stories with smart templates",
+  "type": "module",
+  "main": "./dist/cli/index.js",
+  "bin": {
+    "atomize": "./dist/cli/index.js",
+    "atom": "./dist/cli/index.js"
+  },
+  "publishConfig": {
+    "access": "public",
+    "tag": "latest"
+  },
+  "files": [
+    "dist",
+    "templates",
+    "README.md",
+    "LICENSE",
+    ".env.example"
+  ],
+  "scripts": {
+    "dev": "bun run src/cli/index.ts",
+    "build": "npm run typecheck && npm run build:bun",
+    "postbuild": "node make-executable.js",
+    "build:bun": " bun build ./src/cli/index.ts --outdir ./dist/cli --target node --format esm && node make-executable.js",
+    "build:standalone": "bun build src/cli/index.ts --compile --outfile atomize",
+    "prepublishOnly": "npm run build",
+    "test": "bun test",
+    "test:unit": "bun test tests/unit",
+    "test:integration": "bun test tests/integration.test.ts",
+    "test:watch": "bun test --watch",
+    "test:coverage": "bun test --coverage",
+    "typecheck": "tsc --noEmit",
+    "validate": "bun run src/cli/index.ts validate",
+    "check": "bun typecheck && bun test"
+  },
+  "keywords": [
+    "devops",
+    "azure-devops",
+    "task-automation",
+    "task-generation",
+    "agile",
+    "scrum",
+    "sprint-planning",
+    "cli",
+    "automation",
+    "productivity"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Simao-Pereira-Gomes/atomize.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Simao-Pereira-Gomes/atomize/issues"
+  },
+  "author": "Simão Pereira Gomes",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/bun": "1.3.5",
+    "@types/inquirer": "^9.0.9",
+    "@types/node": "^25.0.3",
+    "chalk": "^5.6.2"
+  },
+  "peerDependencies": {
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "azure-devops-node-api": "^15.1.2",
+    "commander": "^14.0.2",
+    "dotenv": "^17.2.3",
+    "inquirer": "^13.1.0",
+    "ts-pattern": "^5.9.0",
+    "winston": "^3.19.0",
+    "yaml": "^2.8.2",
+    "zod": "^4.2.1"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/templates/backend.yaml

@@ -0,0 +1,124 @@
+version: "1.0"
+name: "Backend API Feature"
+description: "Standard tasks for backend API development"
+author: "Atomize"
+tags: ["backend", "api", "standard"]
+
+# Filter to identify applicable User Stories
+filter:
+  workItemTypes:
+    - "User Story"
+    - "Product Backlog Item"
+  states:
+    - "New"
+    - "Approved"
+    - "Active"
+  tags:
+    include:
+      - "backend"
+      - "api"
+  excludeIfHasTasks: true
+
+# Task template with estimation percentages
+tasks:
+  - id: "design-api"
+    title: "Design API Specification"
+    description: |
+      Design RESTful API endpoints following company standards:
+      - Define request/response models
+      - Document in OpenAPI/Swagger
+      - Review with team architect
+    estimationPercent: 10
+    tags: ["design", "api"]
+    activity: "Design"
+
+  - id: "database-schema"
+    title: "Database Schema Changes"
+    description: |
+      Design and implement database changes:
+      - Create/update migrations
+      - Define models and relationships
+      - Index optimization
+    estimationPercent: 20
+    tags: ["database", "backend"]
+    activity: "Development"
+
+  - id: "implement-logic"
+    title: "Implement Business Logic"
+    description: |
+      Core API implementation:
+      - Implement service layer
+      - Add validation logic
+      - Error handling
+      - Logging
+    estimationPercent: 35
+    tags: ["implementation", "backend"]
+    activity: "Development"
+    dependsOn:
+      - "design-api"
+      - "database-schema"
+
+  - id: "unit-tests"
+    title: "Unit & Integration Tests"
+    description: |
+      Comprehensive test coverage:
+      - Unit tests (80%+ coverage)
+      - Integration tests
+      - Mock external dependencies
+    estimationPercent: 20
+    tags: ["testing", "quality"]
+    activity: "Testing"
+    dependsOn:
+      - "implement-logic"
+
+  - id: "documentation"
+    title: "API Documentation"
+    description: |
+      Update documentation:
+      - API endpoint documentation
+      - Update README
+      - Code comments
+      - Postman collection
+    estimationPercent: 5
+    tags: ["documentation"]
+    activity: "Documentation"
+
+  - id: "code-review"
+    title: "Code Review & Refinement"
+    description: |
+      Review and refine:
+      - Create pull request
+      - Address review feedback
+      - Final testing
+    estimationPercent: 10
+    tags: ["review", "quality"]
+    activity: "Design"
+
+# Estimation strategy
+estimation:
+  strategy: "percentage"
+  source: "Microsoft.VSTS.Scheduling.StoryPoints"
+  rounding: "nearest"
+  minimumTaskPoints: 0.5
+
+# Validation rules
+validation:
+  totalEstimationMustBe: 100
+  minTasks: 4
+  maxTasks: 10
+
+# Metadata
+metadata:
+  category: "Backend Development"
+  difficulty: "intermediate"
+  recommendedFor:
+    - "API features"
+    - "Microservices"
+    - "Backend services"
+  estimationGuidelines: |
+    Use this template for stories sized 3-13 points.
+    For larger stories, consider breaking down first.
+  examples:
+    - "User authentication API"
+    - "Payment processing endpoint"
+    - "Data export service"

package/templates/frontend.yaml

@@ -0,0 +1,123 @@
+version: "1.0"
+name: "Frontend React Feature"
+description: "Standard tasks for React component development"
+author: "Atomize"
+tags: ["frontend", "react", "ui"]
+
+filter:
+  workItemTypes:
+    - "User Story"
+  states:
+    - "New"
+    - "Approved"
+  tags:
+    include:
+      - "frontend"
+      - "react"
+  excludeIfHasTasks: true
+
+tasks:
+  - id: "ui-design-review"
+    title: " UI/UX Design Review"
+    description: |
+      Review designs and create implementation plan:
+      - Review Figma/design specs
+      - Identify reusable components
+      - Plan component hierarchy
+      - Clarify interactions and states
+    estimationPercent: 10
+    tags: ["design", "planning"]
+    activity: "Design"
+
+  - id: "component-structure"
+    title: "Component Structure & Setup"
+    description: |
+      Set up component architecture:
+      - Create component files
+      - Define props interfaces
+      - Set up state management
+      - Configure routing (if needed)
+    estimationPercent: 15
+    tags: ["setup", "architecture"]
+    activity: "Development"
+
+  - id: "component-logic"
+    title: "Component Logic Implementation"
+    description: |
+      Implement core functionality:
+      - Business logic
+      - Event handlers
+      - API integration
+      - Form validation
+    estimationPercent: 30
+    tags: ["implementation", "logic"]
+    activity: "Development"
+    dependsOn:
+      - "component-structure"
+
+  - id: "styling"
+    title: "Styling & Responsive Design"
+    description: |
+      Apply styles and ensure responsiveness:
+      - CSS/Tailwind implementation
+      - Mobile responsiveness
+      - Theme integration
+      - Dark mode (if applicable)
+    estimationPercent: 20
+    tags: ["styling", "css", "responsive"]
+    activity: "Development"
+
+  - id: "accessibility"
+    title: "Accessibility Testing"
+    description: |
+      Ensure WCAG 2.1 AA compliance:
+      - Keyboard navigation
+      - Screen reader testing
+      - ARIA labels
+      - Color contrast
+      - Focus management
+    estimationPercent: 10
+    tags: ["accessibility", "a11y", "quality"]
+    activity: "Testing"
+
+  - id: "component-tests"
+    title: "Component Testing"
+    description: |
+      Write comprehensive tests:
+      - Jest unit tests
+      - React Testing Library
+      - Test user interactions
+      - Snapshot tests
+    estimationPercent: 15
+    tags: ["testing", "quality"]
+    activity: "Testing"
+    dependsOn:
+      - "component-logic"
+
+# Estimation configuration
+estimation:
+  strategy: "percentage"
+  source: "Microsoft.VSTS.Scheduling.StoryPoints"
+  rounding: "nearest"
+  minimumTaskPoints: 0.5
+
+# Validation
+validation:
+  totalEstimationMustBe: 100
+  minTasks: 4
+
+# Metadata
+metadata:
+  category: "Frontend Development"
+  difficulty: "intermediate"
+  recommendedFor:
+    - "React components"
+    - "UI features"
+    - "User interfaces"
+  estimationGuidelines: |
+    Best for stories sized 3-8 points.
+    Complex UIs with animations may need additional tasks.
+  examples:
+    - "User profile page"
+    - "Data table component"
+    - "Form wizard"

package/templates/fullstack.yaml

@@ -0,0 +1,169 @@
+version: "1.0"
+name: "Fullstack Feature"
+description: "Complete fullstack feature with frontend and backend tasks"
+author: "Atomize"
+tags: ["fullstack", "frontend", "backend"]
+
+filter:
+  workItemTypes:
+    - "User Story"
+  states:
+    - "New"
+    - "Active"
+  tags:
+    include:
+      - "fullstack"
+  excludeIfHasTasks: true
+
+# Variables for conditionals
+variables:
+  hasDatabase: true
+  hasAuth: false
+
+tasks:
+  # Design Phase
+  - id: "design-overview"
+    title: "Technical Design"
+    description: |
+      Create comprehensive technical design:
+      - Architecture diagram
+      - API contract definition
+      - Data models
+      - UI/UX flow
+    estimationPercent: 10
+    tags: ["design", "planning"]
+    activity: "Design"
+
+  # Backend Tasks
+  - id: "backend-api"
+    title: " Backend API Implementation"
+    description: |
+      Implement backend API:
+      - API endpoints
+      - Business logic
+      - Validation
+      - Error handling
+    estimationPercent: 20
+    tags: ["backend", "api"]
+    activity: "Development"
+    dependsOn: ["design-overview"]
+
+  - id: "database"
+    title: "Database Implementation"
+    description: |
+      Database changes:
+      - Schema migrations
+      - Models
+      - Queries
+      - Indexes
+    estimationPercent: 15
+    tags: ["database", "backend"]
+    activity: "Development"
+    condition: "${variables.hasDatabase}"
+
+  - id: "backend-tests"
+    title: "Backend Tests"
+    description: |
+      Backend test coverage:
+      - Unit tests (80%+)
+      - Integration tests
+      - API endpoint tests
+    estimationPercent: 10
+    tags: ["testing", "backend"]
+    activity: "Testing"
+    dependsOn: ["backend-api"]
+
+  # Frontend Tasks
+  - id: "frontend-components"
+    title: "Frontend Components"
+    description: |
+      Build React components:
+      - Component structure
+      - Props interfaces
+      - State management
+      - Event handlers
+    estimationPercent: 20
+    tags: ["frontend", "react"]
+    activity: "Development"
+    dependsOn: ["design-overview"]
+
+  - id: "frontend-styling"
+    title: "Styling & Responsive Design"
+    description: |
+      Apply styles:
+      - CSS/Tailwind
+      - Mobile responsive
+      - Theme integration
+    estimationPercent: 10
+    tags: ["frontend", "styling"]
+    activity: "Development"
+
+  - id: "frontend-tests"
+    title: "Frontend Tests"
+    description: |
+      Frontend test coverage:
+      - Component tests
+      - User interaction tests
+      - Snapshot tests
+    estimationPercent: 8
+    tags: ["testing", "frontend"]
+    activity: "Testing"
+    dependsOn: ["frontend-components"]
+
+  # Integration
+  - id: "integration"
+    title: "Frontend-Backend Integration"
+    description: |
+      Connect frontend to backend:
+      - API integration
+      - Error handling
+      - Loading states
+      - Data flow testing
+    estimationPercent: 12
+    tags: ["integration"]
+    activity: "Development"
+    dependsOn: ["backend-api", "frontend-components"]
+
+  # Documentation & Review
+  - id: "documentation"
+    title: "Documentation"
+    description: |
+      Complete documentation:
+      - API documentation
+      - Component documentation
+      - README updates
+      - Deployment guide
+    estimationPercent: 5
+    tags: ["documentation"]
+    activity: "Documentation"
+
+# Estimation configuration
+estimation:
+  strategy: "percentage"
+  source: "Microsoft.VSTS.Scheduling.StoryPoints"
+  rounding: "nearest"
+  minimumTaskPoints: 0.5
+
+# Validation
+validation:
+  totalEstimationRange:
+    min: 95
+    max: 105
+  minTasks: 5
+
+# Metadata
+metadata:
+  category: "Fullstack Development"
+  difficulty: "advanced"
+  recommendedFor:
+    - "Full features with UI and API"
+    - "Complete user flows"
+    - "End-to-end features"
+  estimationGuidelines: |
+    Best for stories sized 5-13 points.
+    This template covers both frontend and backend.
+    Adjust tasks based on complexity.
+  examples:
+    - "User registration flow"
+    - "Dashboard with data visualization"
+    - "Search and filter feature"