specpulse 1.4.0__py3-none-any.whl → 1.4.2__py3-none-any.whl

specpulse/resources/scripts/sp-pulse-spec.sh

@@ -41,15 +41,25 @@ fi
 SPEC_DIR="$PROJECT_ROOT/specs/${FEATURE_DIR}"
 TEMPLATE_FILE="$PROJECT_ROOT/templates/spec.md"
 
+# Validate template file exists before proceeding
+if [ ! -f "$TEMPLATE_FILE" ]; then
+    error_exit "Template not found: $TEMPLATE_FILE. Please ensure templates are properly initialized."
+fi
+
 # Ensure specs directory exists
-mkdir -p "$SPEC_DIR"
+mkdir -p "$SPEC_DIR" || error_exit "Failed to create specs directory: $SPEC_DIR"
 
 # Find latest spec file or create new one
 if [ -n "$SPEC_CONTENT" ]; then
     # Find next available spec number
     if [ -d "$SPEC_DIR" ]; then
-        existing_specs=$(find "$SPEC_DIR" -name "spec-*.md" | wc -l)
-        spec_number=$((existing_specs + 1))
+        # Get the highest spec number and increment it
+        highest_spec=$(find "$SPEC_DIR" -name "spec-*.md" -exec basename {} .md \; | sed 's/spec-//' | sort -n | tail -1)
+        if [ -n "$highest_spec" ]; then
+            spec_number=$((highest_spec + 1))
+        else
+            spec_number=1
+        fi
     else
         spec_number=1
     fi
@@ -63,24 +73,32 @@ else
     if [ -d "$SPEC_DIR" ]; then
         SPEC_FILE=$(find "$SPEC_DIR" -name "spec-*.md" -printf "%T@ %p\n" | sort -n | tail -1 | cut -d' ' -f2-)
         if [ -z "$SPEC_FILE" ]; then
-            # No spec files found, create first one
+            # No spec files found, create first one with marker for AI
             SPEC_FILE="$SPEC_DIR/spec-001.md"
-            if [ ! -f "$TEMPLATE_FILE" ]; then
-                error_exit "Template not found: $TEMPLATE_FILE"
-            fi
-            log "Creating specification from template: $SPEC_FILE"
-            cp "$TEMPLATE_FILE" "$SPEC_FILE" || error_exit "Failed to copy specification template"
+            log "Creating first specification marker: $SPEC_FILE"
+            echo "# Specification - $FEATURE_DIR" > "$SPEC_FILE"
+            echo "" >> "$SPEC_FILE"
+            echo "<!-- AI: Please generate specification using template: $TEMPLATE_FILE -->" >> "$SPEC_FILE"
+            echo "<!-- FEATURE_DIR: $FEATURE_DIR -->" >> "$SPEC_FILE"
+            echo "<!-- FEATURE_ID: $FEATURE_ID -->" >> "$SPEC_FILE"
+            echo "" >> "$SPEC_FILE"
+            echo "## Awaiting AI Generation" >> "$SPEC_FILE"
+            echo "This specification needs to be generated from the template." >> "$SPEC_FILE"
         else
             log "Using latest specification: $SPEC_FILE"
         fi
     else
-        # Create directory and first spec
+        # Create directory and first spec with marker for AI
         SPEC_FILE="$SPEC_DIR/spec-001.md"
-        if [ ! -f "$TEMPLATE_FILE" ]; then
-            error_exit "Template not found: $TEMPLATE_FILE"
-        fi
-        log "Creating specification from template: $SPEC_FILE"
-        cp "$TEMPLATE_FILE" "$SPEC_FILE" || error_exit "Failed to copy specification template"
+        log "Creating first specification marker: $SPEC_FILE"
+        echo "# Specification - $FEATURE_DIR" > "$SPEC_FILE"
+        echo "" >> "$SPEC_FILE"
+        echo "<!-- AI: Please generate specification using template: $TEMPLATE_FILE -->" >> "$SPEC_FILE"
+        echo "<!-- FEATURE_DIR: $FEATURE_DIR -->" >> "$SPEC_FILE"
+        echo "<!-- FEATURE_ID: $FEATURE_ID -->" >> "$SPEC_FILE"
+        echo "" >> "$SPEC_FILE"
+        echo "## Awaiting AI Generation" >> "$SPEC_FILE"
+        echo "This specification needs to be generated from the template." >> "$SPEC_FILE"
     fi
 fi
 
@@ -90,18 +108,24 @@ if [ ! -f "$SPEC_FILE" ]; then
     error_exit "Specification file does not exist: $SPEC_FILE"
 fi
 
-# Check for required sections
-REQUIRED_SECTIONS=("## Specification:" "## Metadata" "## Functional Requirements" "## Acceptance Scenarios")
-MISSING_SECTIONS=()
+# Check if file needs AI generation
+if grep -q "Awaiting AI Generation" "$SPEC_FILE"; then
+    log "WARNING: Specification needs to be generated by AI from template"
+    MISSING_SECTIONS=("ALL - Awaiting AI Generation")
+else
+    # Check for required sections only if file has been generated
+    REQUIRED_SECTIONS=("## Specification:" "## Metadata" "## Functional Requirements" "## Acceptance Scenarios")
+    MISSING_SECTIONS=()
 
-for section in "${REQUIRED_SECTIONS[@]}"; do
-    if ! grep -q "$section" "$SPEC_FILE"; then
-        MISSING_SECTIONS+=("$section")
-    fi
-done
+    for section in "${REQUIRED_SECTIONS[@]}"; do
+        if ! grep -q "$section" "$SPEC_FILE"; then
+            MISSING_SECTIONS+=("$section")
+        fi
+    done
 
-if [ ${#MISSING_SECTIONS[@]} -gt 0 ]; then
-    log "WARNING: Missing required sections: ${MISSING_SECTIONS[*]}"
+    if [ ${#MISSING_SECTIONS[@]} -gt 0 ]; then
+        log "WARNING: Missing required sections: ${MISSING_SECTIONS[*]}"
+    fi
 fi
 
 # Check for clarifications needed

specpulse/resources/scripts/sp-pulse-task.sh

@@ -42,8 +42,13 @@ PLAN_DIR="$PROJECT_ROOT/plans/${FEATURE_DIR}"
 SPEC_DIR="$PROJECT_ROOT/specs/${FEATURE_DIR}"
 TEMPLATE_FILE="$PROJECT_ROOT/templates/task.md"
 
+# Validate template file exists before proceeding
+if [ ! -f "$TEMPLATE_FILE" ]; then
+    error_exit "Template not found: $TEMPLATE_FILE. Please ensure templates are properly initialized."
+fi
+
 # Ensure tasks directory exists
-mkdir -p "$TASK_DIR"
+mkdir -p "$TASK_DIR" || error_exit "Failed to create tasks directory: $TASK_DIR"
 
 # Find latest spec file
 if [ -d "$SPEC_DIR" ]; then
@@ -67,8 +72,13 @@ fi
 
 # Find next available task number or create new one
 if [ -d "$TASK_DIR" ]; then
-    existing_tasks=$(find "$TASK_DIR" -name "task-*.md" | wc -l)
-    task_number=$((existing_tasks + 1))
+    # Get the highest task number and increment it
+    highest_task=$(find "$TASK_DIR" -name "task-*.md" -exec basename {} .md \; | sed 's/task-//' | sort -n | tail -1)
+    if [ -n "$highest_task" ]; then
+        task_number=$((highest_task + 1))
+    else
+        task_number=1
+    fi
 else
     task_number=1
 fi
@@ -79,25 +89,47 @@ if [ ! -f "$TEMPLATE_FILE" ]; then
     error_exit "Template not found: $TEMPLATE_FILE"
 fi
 
-# Create task file
-log "Creating task breakdown from template: $TASK_FILE"
-cp "$TEMPLATE_FILE" "$TASK_FILE" || error_exit "Failed to copy task template"
+# Create task file marker for AI generation
+log "Creating task breakdown marker: $TASK_FILE"
+echo "# Task Breakdown - $FEATURE_DIR" > "$TASK_FILE"
+echo "" >> "$TASK_FILE"
+echo "<!-- AI: Please generate tasks using template: $TEMPLATE_FILE -->" >> "$TASK_FILE"
+echo "<!-- SPEC_FILE: $SPEC_FILE -->" >> "$TASK_FILE"
+echo "<!-- PLAN_FILE: $PLAN_FILE -->" >> "$TASK_FILE"
+echo "<!-- FEATURE_DIR: $FEATURE_DIR -->" >> "$TASK_FILE"
+echo "<!-- FEATURE_ID: $FEATURE_ID -->" >> "$TASK_FILE"
+echo "" >> "$TASK_FILE"
+echo "## Awaiting AI Generation" >> "$TASK_FILE"
+echo "Tasks need to be generated from the template based on:" >> "$TASK_FILE"
+echo "- Specification: $SPEC_FILE" >> "$TASK_FILE"
+echo "- Plan: $PLAN_FILE" >> "$TASK_FILE"
 
 # Validate task structure
 log "Validating task breakdown..."
 
-# Check for required sections
-REQUIRED_SECTIONS=("## Task List:" "## Task Organization" "## Critical Path" "## Execution Schedule")
-MISSING_SECTIONS=()
-
-for section in "${REQUIRED_SECTIONS[@]}"; do
-    if ! grep -q "$section" "$TASK_FILE"; then
-        MISSING_SECTIONS+=("$section")
+# Check if file needs AI generation
+if grep -q "Awaiting AI Generation" "$TASK_FILE"; then
+    log "WARNING: Tasks need to be generated by AI from template"
+    MISSING_SECTIONS=("ALL - Awaiting AI Generation")
+    TOTAL_TASKS=0
+    COMPLETED_TASKS=0
+    PENDING_TASKS=0
+    BLOCKED_TASKS=0
+    PARALLEL_TASKS=0
+else
+    # Check for required sections only if file has been generated
+    REQUIRED_SECTIONS=("## Task List:" "## Task Organization" "## Critical Path" "## Execution Schedule")
+    MISSING_SECTIONS=()
+
+    for section in "${REQUIRED_SECTIONS[@]}"; do
+        if ! grep -q "$section" "$TASK_FILE"; then
+            MISSING_SECTIONS+=("$section")
+        fi
+    done
+
+    if [ ${#MISSING_SECTIONS[@]} -gt 0 ]; then
+        log "WARNING: Missing required sections: ${MISSING_SECTIONS[*]}"
     fi
-done
-
-if [ ${#MISSING_SECTIONS[@]} -gt 0 ]; then
-    log "WARNING: Missing required sections: ${MISSING_SECTIONS[*]}"
 fi
 
 # Count tasks and analyze structure

specpulse/resources/templates/decomposition/api-contract.yaml

@@ -1,22 +1,354 @@
 openapi: 3.0.0
 info:
-  title: {{ service_name }} API
-  version: {{ version }}
-  description: {{ service_description }}
-  
+  title: {{service_name}} API
+  version: 1.0.0
+  description: API contract for {{service_name}} microservice
+  contact:
+    name: API Support
+    email: api@example.com
+
 servers:
-  - url: {{ base_url }}
-    description: {{ environment }}
+  - url: http://localhost:{{port}}/api/v1
+    description: Development server
+  - url: https://api.example.com/{{service_name}}/v1
+    description: Production server
 
 paths:
-  {{ paths }}
+  /{{resource}}:
+    get:
+      summary: List all {{resource}}
+      operationId: list{{Resource}}
+      tags:
+        - {{Resource}}
+      parameters:
+        - in: query
+          name: page
+          schema:
+            type: integer
+            default: 1
+          description: Page number
+        - in: query
+          name: limit
+          schema:
+            type: integer
+            default: 20
+            maximum: 100
+          description: Number of items per page
+        - in: query
+          name: sort
+          schema:
+            type: string
+            enum: [created_at, updated_at, name]
+            default: created_at
+          description: Sort field
+        - in: query
+          name: order
+          schema:
+            type: string
+            enum: [asc, desc]
+            default: desc
+          description: Sort order
+      responses:
+        '200':
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  data:
+                    type: array
+                    items:
+                      $ref: '#/components/schemas/{{Resource}}'
+                  meta:
+                    $ref: '#/components/schemas/PaginationMeta'
+        '400':
+          $ref: '#/components/responses/BadRequest'
+        '401':
+          $ref: '#/components/responses/Unauthorized'
+        '500':
+          $ref: '#/components/responses/InternalError'
+
+    post:
+      summary: Create new {{resource}}
+      operationId: create{{Resource}}
+      tags:
+        - {{Resource}}
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/Create{{Resource}}Request'
+      responses:
+        '201':
+          description: Created successfully
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/{{Resource}}'
+        '400':
+          $ref: '#/components/responses/BadRequest'
+        '401':
+          $ref: '#/components/responses/Unauthorized'
+        '409':
+          $ref: '#/components/responses/Conflict'
+        '500':
+          $ref: '#/components/responses/InternalError'
+
+  /{{resource}}/{id}:
+    parameters:
+      - in: path
+        name: id
+        required: true
+        schema:
+          type: string
+          format: uuid
+        description: {{Resource}} ID
+
+    get:
+      summary: Get {{resource}} by ID
+      operationId: get{{Resource}}ById
+      tags:
+        - {{Resource}}
+      responses:
+        '200':
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/{{Resource}}'
+        '401':
+          $ref: '#/components/responses/Unauthorized'
+        '404':
+          $ref: '#/components/responses/NotFound'
+        '500':
+          $ref: '#/components/responses/InternalError'
+
+    put:
+      summary: Update {{resource}}
+      operationId: update{{Resource}}
+      tags:
+        - {{Resource}}
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/Update{{Resource}}Request'
+      responses:
+        '200':
+          description: Updated successfully
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/{{Resource}}'
+        '400':
+          $ref: '#/components/responses/BadRequest'
+        '401':
+          $ref: '#/components/responses/Unauthorized'
+        '404':
+          $ref: '#/components/responses/NotFound'
+        '409':
+          $ref: '#/components/responses/Conflict'
+        '500':
+          $ref: '#/components/responses/InternalError'
+
+    delete:
+      summary: Delete {{resource}}
+      operationId: delete{{Resource}}
+      tags:
+        - {{Resource}}
+      responses:
+        '204':
+          description: Deleted successfully
+        '401':
+          $ref: '#/components/responses/Unauthorized'
+        '404':
+          $ref: '#/components/responses/NotFound'
+        '409':
+          $ref: '#/components/responses/Conflict'
+        '500':
+          $ref: '#/components/responses/InternalError'
+
+  /health:
+    get:
+      summary: Health check
+      operationId: healthCheck
+      tags:
+        - System
+      responses:
+        '200':
+          description: Service is healthy
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/HealthCheck'
 
 components:
   schemas:
-    {{ schemas }}
-  
+    {{Resource}}:
+      type: object
+      required:
+        - id
+        - name
+        - status
+        - created_at
+        - updated_at
+      properties:
+        id:
+          type: string
+          format: uuid
+          description: Unique identifier
+        name:
+          type: string
+          description: {{Resource}} name
+        description:
+          type: string
+          description: {{Resource}} description
+        status:
+          type: string
+          enum: [active, inactive, pending]
+          description: Current status
+        metadata:
+          type: object
+          additionalProperties: true
+          description: Additional metadata
+        created_at:
+          type: string
+          format: date-time
+          description: Creation timestamp
+        updated_at:
+          type: string
+          format: date-time
+          description: Last update timestamp
+
+    Create{{Resource}}Request:
+      type: object
+      required:
+        - name
+      properties:
+        name:
+          type: string
+          minLength: 1
+          maxLength: 255
+        description:
+          type: string
+          maxLength: 1000
+        metadata:
+          type: object
+          additionalProperties: true
+
+    Update{{Resource}}Request:
+      type: object
+      properties:
+        name:
+          type: string
+          minLength: 1
+          maxLength: 255
+        description:
+          type: string
+          maxLength: 1000
+        status:
+          type: string
+          enum: [active, inactive, pending]
+        metadata:
+          type: object
+          additionalProperties: true
+
+    PaginationMeta:
+      type: object
+      properties:
+        page:
+          type: integer
+        limit:
+          type: integer
+        total:
+          type: integer
+        total_pages:
+          type: integer
+
+    Error:
+      type: object
+      required:
+        - code
+        - message
+      properties:
+        code:
+          type: string
+        message:
+          type: string
+        details:
+          type: object
+          additionalProperties: true
+
+    HealthCheck:
+      type: object
+      properties:
+        status:
+          type: string
+          enum: [healthy, degraded, unhealthy]
+        version:
+          type: string
+        uptime:
+          type: integer
+        checks:
+          type: object
+          additionalProperties:
+            type: object
+            properties:
+              status:
+                type: string
+              message:
+                type: string
+
+  responses:
+    BadRequest:
+      description: Bad request
+      content:
+        application/json:
+          schema:
+            $ref: '#/components/schemas/Error'
+
+    Unauthorized:
+      description: Unauthorized
+      content:
+        application/json:
+          schema:
+            $ref: '#/components/schemas/Error'
+
+    NotFound:
+      description: Resource not found
+      content:
+        application/json:
+          schema:
+            $ref: '#/components/schemas/Error'
+
+    Conflict:
+      description: Conflict with current state
+      content:
+        application/json:
+          schema:
+            $ref: '#/components/schemas/Error'
+
+    InternalError:
+      description: Internal server error
+      content:
+        application/json:
+          schema:
+            $ref: '#/components/schemas/Error'
+
   securitySchemes:
-    {{ security_schemes }}
+    BearerAuth:
+      type: http
+      scheme: bearer
+      bearerFormat: JWT
+
+    ApiKey:
+      type: apiKey
+      in: header
+      name: X-API-Key
 
-tags:
-  {{ tags }}
+security:
+  - BearerAuth: []
+  - ApiKey: []