@sppg2001/atomize 0.0.1 → 1.0.0

package/package.json

@@ -1,81 +1,86 @@
 {
-  "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"
-  }
+	"name": "@sppg2001/atomize",
+	"version": "1.0.0",
+	"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/presets",
+		"README.md",
+		"LICENSE",
+		".env.example"
+	],
+	"scripts": {
+		"dev": "bun run src/cli/index.ts",
+		"build": "bun run typecheck && bun run build:bun",
+		"postbuild": "node make-executable.js",
+		"build:bun": "bun build ./src/cli/index.ts --outdir ./dist/cli --target node --format esm",
+		"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 --coverage-reporter=lcov",
+		"typecheck": "tsc --noEmit",
+		"validate": "bun run src/cli/index.ts validate",
+		"validate:package": "test -d dist && test -f dist/cli/index.js && test -d templates/presets",
+		"check": "bun typecheck && bun test",
+		"lint": "bunx biome check --max-diagnostics 100",
+		"lint:fix": "bunx biome check --fix --max-diagnostics 100"
+	},
+	"keywords": [
+		"devops",
+		"azure-devops",
+		"task-automation",
+		"task-generation",
+		"agile",
+		"scrum",
+		"sprint-planning",
+		"cli",
+		"automation",
+		"productivity"
+	],
+	"repository": {
+		"type": "git",
+		"url": "git+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": {
+		"@biomejs/biome": "2.3.11",
+		"@types/bun": "1.3.5",
+		"@types/inquirer": "^9.0.9",
+		"@types/node": "^25.0.3"
+	},
+	"peerDependencies": {
+		"typescript": "^5.9.3"
+	},
+	"dependencies": {
+		"@google/generative-ai": "^0.24.1",
+		"azure-devops-node-api": "^15.1.2",
+		"chalk": "^5.6.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/presets/backend-api.yaml

@@ -0,0 +1,60 @@
+version: "1.0"
+name: "Backend API Development"
+description: "Standard backend API development with database integration"
+author: "Atomize"
+tags: ["backend", "api", "database"]
+
+filter:
+  workItemTypes: ["User Story"]
+  states: ["New", "Active", "Approved"]
+  tags:
+    include: ["backend", "api"]
+  excludeIfHasTasks: true
+
+tasks:
+  - title: "Design API Endpoints: ${story.title}"
+    description: "Design REST API endpoints, request/response schemas, and error handling"
+    estimationPercent: 15
+    activity: "Design"
+    tags: ["design", "api"]
+
+  - title: "Database Schema: ${story.title}"
+    description: "Design and create database tables, migrations, and relationships"
+    estimationPercent: 15
+    activity: "Design"
+    tags: ["database", "migration"]
+
+  - title: "Implement Core Logic: ${story.title}"
+    description: "Implement business logic, data validation, and error handling"
+    estimationPercent: 35
+    activity: "Development"
+    tags: ["implementation"]
+
+  - title: "Write Unit Tests"
+    description: "Unit tests for services, repositories, and utilities"
+    estimationPercent: 15
+    activity: "Testing"
+    tags: ["testing", "unit-tests"]
+
+  - title: "Integration Tests & Documentation"
+    description: "API integration tests and OpenAPI/Swagger documentation"
+    estimationPercent: 10
+    activity: "Testing"
+    tags: ["testing", "documentation"]
+
+  - title: "Code Review & Refinement"
+    description: "Address code review feedback and refactor as needed"
+    estimationPercent: 10
+    activity: "Documentation"
+    tags: ["review"]
+
+estimation:
+  strategy: "percentage"
+  rounding: "nearest"
+  minimumTaskPoints: 0
+
+metadata:
+  category: "Backend"
+  difficulty: "intermediate"
+  recommendedFor: ["API development", "Microservices", "REST APIs"]
+  estimationGuidelines: "Based on typical backend development workflows"

package/templates/presets/bug-fix.yaml

@@ -0,0 +1,44 @@
+version: "1.0"
+name: "Bug Fix"
+description: "Standard bug investigation and resolution workflow"
+author: "Atomize"
+tags: ["bug", "fix"]
+
+filter:
+  workItemTypes: ["Bug"]
+  states: ["New", "Active", "Approved"]
+  excludeIfHasTasks: true
+
+tasks:
+  - title: "Investigate & Reproduce: ${story.title}"
+    description: "Investigate root cause and create reproduction steps"
+    estimationPercent: 30
+    activity: "Development"
+    tags: ["investigation"]
+
+  - title: "Implement Fix: ${story.title}"
+    description: "Fix the bug and ensure no regressions"
+    estimationPercent: 40
+    activity: "Development"
+    tags: ["implementation"]
+
+  - title: "Test & Verify"
+    description: "Verify fix works and add regression tests"
+    estimationPercent: 20
+    activity: "Testing"
+    tags: ["testing", "verification"]
+
+  - title: "Review & Deploy"
+    description: "Code review and prepare for deployment"
+    estimationPercent: 10
+    activity: "Documentation"
+    tags: ["review"]
+
+estimation:
+  strategy: "percentage"
+  rounding: "nearest"
+
+metadata:
+  category: "Maintenance"
+  difficulty: "beginner"
+  recommendedFor: ["Bug fixes", "Hotfixes", "Production issues"]

package/templates/presets/custom.yaml

@@ -0,0 +1,89 @@
+version: "1.0"
+name: " Custom Example"
+description: "Example template for an Agile project"
+author: "Atomize"
+tags: []
+
+filter:
+  workItemTypes: ["User Story"]
+  states: ["New"]
+  tags:
+    include: ["Candidate S113"]
+  excludeIfHasTasks: true
+
+tasks:
+  - title: "Analysis & Playback"
+    description: "Analyze requirements and planning of necessary changes and discuss with the team."
+    estimationPercent: 20
+    activity: "Development"
+    tags: []
+
+  - title: "Build"
+    description: "Devolop the required changes in the codebase following best practices."
+    estimationPercent: 50
+    activity: "Development"
+    tags: []
+
+  - title: "Developer Test"
+    description: "Testing the changes made to ensure they meet the requirements and do not introduce new issues.Provide evidence of testing"
+    estimationPercent: 25
+    activity: "Development"
+    tags: []
+
+  - title: "QA Smoke Test"
+    description: "Ensure that main functionalities are working as expected after the deployment to the QA environment."
+    estimationPercent: 0
+    activity: "Development"
+    tags: []
+
+  - title: "WIKI"
+    description: "Update relevant documentation and WIKI pages to reflect the changes made."
+    estimationPercent: 5
+    activity: "Development"
+    tags: []
+
+  - title: "Code Review "
+    description: "Address code review feedback and refactor as needed"
+    estimationPercent: 0
+    activity: "Development"
+    tags: []
+  
+  - title: "Test Preparation"
+    description: "Prepare test cases and scenarios for QA testing."
+    estimationPercent: 40
+    activity: "Testing"
+    tags: []
+  
+  - title: "Test Execution"
+    description: "Execute test cases and report any defects found during testing."
+    estimationPercent: 27
+    activity: "Testing"
+    tags: []
+
+  - title: "Automation Testing"
+    description: "Develop and maintain automated test scripts to improve testing efficiency."
+    estimationPercent: 0
+    activity: "Testing"
+    tags: []
+  
+  - title: "Test Review"
+    description: "Review test results and ensure all requirements are met before deployment."
+    estimationPercent: 0
+    activity: "Testing"
+    tags: []
+  
+  - title: "Release Notes"
+    description: "Prepare release notes and documentation for the deployment."
+    estimationPercent: 0
+    activity: "Documentation"
+    tags: []
+
+estimation:
+  strategy: "percentage"
+  rounding: "nearest"
+  minimumTaskPoints: 0
+
+metadata:
+  category: "Agile Project"
+  recommendedFor: []
+  estimationGuidelines: "Based on possible Agile project workflow"

package/templates/presets/frontend-feature.yaml

@@ -0,0 +1,52 @@
+version: "1.0"
+name: "Frontend Feature Development"
+description: "UI/UX feature development with React/Vue components"
+author: "Atomize"
+tags: ["frontend", "ui", "react"]
+
+filter:
+  workItemTypes: ["User Story"]
+  states: ["New", "Active", "Approved"]
+  tags:
+    include: ["frontend", "ui"]
+  excludeIfHasTasks: true
+
+tasks:
+  - title: "UI/UX Design: ${story.title}"
+    description: "Create wireframes, mockups, and component designs"
+    estimationPercent: 15
+    activity: "Design"
+    tags: ["design", "ui"]
+
+  - title: "Component Implementation: ${story.title}"
+    description: "Build React/Vue components with proper state management"
+    estimationPercent: 40
+    activity: "Development"
+    tags: ["implementation", "react"]
+
+  - title: "Styling & Responsiveness"
+    description: "CSS/Tailwind styling and responsive design for mobile/tablet"
+    estimationPercent: 20
+    activity: "Development"
+    tags: ["css", "responsive"]
+
+  - title: "Unit & Component Tests"
+    description: "Jest/React Testing Library tests for components"
+    estimationPercent: 15
+    activity: "Testing"
+    tags: ["testing"]
+
+  - title: "Code Review & Accessibility"
+    description: "Review, accessibility improvements, and polish"
+    estimationPercent: 10
+    activity: "Documentation"
+    tags: ["review", "a11y"]
+
+estimation:
+  strategy: "percentage"
+  rounding: "nearest"
+
+metadata:
+  category: "Frontend"
+  difficulty: "intermediate"
+  recommendedFor: ["React", "Vue", "UI components"]

package/templates/backend.yaml

@@ -1,124 +0,0 @@
-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

@@ -1,123 +0,0 @@
-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"