@shepai/cli 1.44.1 → 1.45.0

package/apis/json-schema/FeatureAgent.yaml

@@ -0,0 +1,29 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: FeatureAgent.yaml
+type: object
+properties:
+  id:
+    $ref: UUID.yaml
+    description: Unique identifier for this feature agent instance
+  feature:
+    $ref: Feature.yaml
+    description: The feature being managed by this agent throughout its lifecycle
+  agents:
+    type: array
+    items:
+      $ref: AgentInstance.yaml
+    description: Sub-agents spawned to handle specific tasks within the workflow
+  state:
+    $ref: FeatureAgentState.yaml
+    description: Current operational state determining what the agent is doing
+  createdAt:
+    type: string
+    format: date-time
+    description: Timestamp when this feature agent was created
+required:
+  - id
+  - feature
+  - agents
+  - state
+  - createdAt
+description: Main orchestrating agent - the 'brain' that manages the complete SDLC workflow for a feature

package/apis/json-schema/FeatureAgentState.yaml

@@ -0,0 +1,11 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: FeatureAgentState.yaml
+type: string
+enum:
+  - GatheringRequirements
+  - ClarificationsRequired
+  - DoingResearch
+  - AwaitingReview
+  - ExecutingWorkPlan
+  - Ready
+description: States for the feature agent orchestrating the SDLC workflow

package/apis/json-schema/FeatureArtifact.yaml

@@ -0,0 +1,35 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: FeatureArtifact.yaml
+type: object
+properties:
+  number:
+    type: integer
+    minimum: -2147483648
+    maximum: 2147483647
+    description: Spec number (e.g., 11 for spec 011)
+  branch:
+    type: string
+    description: Git branch name for this feature (e.g., 'feat/011-feature-name')
+  oneLiner:
+    type: string
+    description: One-line description of the feature
+  phase:
+    $ref: SdlcLifecycle.yaml
+    description: Current phase in the SDLC lifecycle
+  sizeEstimate:
+    type: string
+    description: "Size estimate: XS, S, M, L, or XL"
+  rejectionFeedback:
+    type: array
+    items:
+      $ref: RejectionFeedbackEntry.yaml
+    description: Rejection feedback history for PRD iterations (append-only)
+required:
+  - number
+  - branch
+  - oneLiner
+  - phase
+  - sizeEstimate
+allOf:
+  - $ref: SpecArtifactBase.yaml
+description: Feature specification artifact (PRD) defining requirements and scope

package/apis/json-schema/FeatureCheckpoint.yaml

@@ -0,0 +1,18 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: FeatureCheckpoint.yaml
+type: object
+properties:
+  phase:
+    type: string
+    description: Phase name (e.g., 'feature-created', 'research-complete')
+  completedAt:
+    type: string
+    description: ISO timestamp when this checkpoint was reached
+  completedBy:
+    type: string
+    description: Agent or skill that completed this phase
+required:
+  - phase
+  - completedAt
+  - completedBy
+description: Milestone checkpoint for phase completion

package/apis/json-schema/FeatureErrors.yaml

@@ -0,0 +1,15 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: FeatureErrors.yaml
+type: object
+properties:
+  current:
+    type: string
+    description: Current error message (null if no active error)
+  history:
+    type: array
+    items:
+      type: string
+    description: History of past error messages
+required:
+  - history
+description: Error tracking for feature execution

package/apis/json-schema/FeatureIdentity.yaml

@@ -0,0 +1,32 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: FeatureIdentity.yaml
+type: object
+properties:
+  id:
+    type: string
+    description: Feature ID slug (e.g., '012-autonomous-pr-review-loop')
+  name:
+    type: string
+    description: Human-readable feature name
+  number:
+    type: integer
+    minimum: -2147483648
+    maximum: 2147483647
+    description: Feature number (e.g., 12)
+  branch:
+    type: string
+    description: Git branch for this feature
+  lifecycle:
+    type: string
+    description: Current lifecycle phase (e.g., 'research', 'implementation', 'complete')
+  createdAt:
+    type: string
+    description: When the feature was created
+required:
+  - id
+  - name
+  - number
+  - branch
+  - lifecycle
+  - createdAt
+description: Feature identity metadata in feature.yaml

package/apis/json-schema/FeatureSpec.yaml

@@ -0,0 +1,30 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: FeatureSpec.yaml
+type: object
+properties:
+  number:
+    type: integer
+    minimum: -2147483648
+    maximum: 2147483647
+    description: Spec number (e.g., 11 for spec 011)
+  branch:
+    type: string
+    description: Git branch name for this feature (e.g., 'feat/011-feature-name')
+  oneLiner:
+    type: string
+    description: One-line description of the feature
+  phase:
+    $ref: SdlcLifecycle.yaml
+    description: Current phase in the SDLC lifecycle
+  sizeEstimate:
+    type: string
+    description: "Size estimate: XS, S, M, L, or XL"
+required:
+  - number
+  - branch
+  - oneLiner
+  - phase
+  - sizeEstimate
+allOf:
+  - $ref: SpecArtifactBase.yaml
+description: Feature specification artifact defining requirements and scope

package/apis/json-schema/FeatureStatus.yaml

@@ -0,0 +1,40 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: FeatureStatus.yaml
+type: object
+properties:
+  feature:
+    $ref: FeatureIdentity.yaml
+    description: Feature identity metadata
+  status:
+    $ref: FeatureStatusInfo.yaml
+    description: Current execution status and progress
+  prUrl:
+    type: string
+    description: PR URL if a pull request has been created
+  mergedAt:
+    type: string
+    description: ISO timestamp when the feature was merged
+  validation:
+    $ref: FeatureValidation.yaml
+    description: Validation gate results
+  tasks:
+    $ref: FeatureTaskTracking.yaml
+    description: Task execution tracking
+  checkpoints:
+    type: array
+    items:
+      $ref: FeatureCheckpoint.yaml
+    description: Milestone checkpoints recording phase completions
+  errors:
+    $ref: FeatureErrors.yaml
+    description: Error tracking state
+required:
+  - feature
+  - status
+  - validation
+  - tasks
+  - checkpoints
+  - errors
+allOf:
+  - $ref: BaseEntity.yaml
+description: Feature status tracking artifact (feature.yaml)

package/apis/json-schema/FeatureStatusInfo.yaml

@@ -0,0 +1,30 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: FeatureStatusInfo.yaml
+type: object
+properties:
+  phase:
+    type: string
+    description: Current SDLC phase
+  completedPhases:
+    type: array
+    items:
+      type: string
+    description: Phases that have been completed
+  progress:
+    $ref: FeatureStatusProgress.yaml
+    description: Task completion progress
+  currentTask:
+    type: string
+    description: ID of the task currently being executed (null if none)
+  lastUpdated:
+    type: string
+    description: ISO timestamp of last status update
+  lastUpdatedBy:
+    type: string
+    description: Agent or skill that last updated the status
+required:
+  - phase
+  - progress
+  - lastUpdated
+  - lastUpdatedBy
+description: Feature execution status

package/apis/json-schema/FeatureStatusProgress.yaml

@@ -0,0 +1,24 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: FeatureStatusProgress.yaml
+type: object
+properties:
+  completed:
+    type: integer
+    minimum: -2147483648
+    maximum: 2147483647
+    description: Number of completed tasks
+  total:
+    type: integer
+    minimum: -2147483648
+    maximum: 2147483647
+    description: Total number of tasks
+  percentage:
+    type: integer
+    minimum: -2147483648
+    maximum: 2147483647
+    description: Completion percentage (0-100)
+required:
+  - completed
+  - total
+  - percentage
+description: Task completion progress counters

package/apis/json-schema/FeatureTaskTracking.yaml

@@ -0,0 +1,21 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: FeatureTaskTracking.yaml
+type: object
+properties:
+  current:
+    type: string
+    description: ID of the task currently being worked on (null if none)
+  blocked:
+    type: array
+    items:
+      type: string
+    description: IDs of tasks blocked by unmet dependencies
+  failed:
+    type: array
+    items:
+      type: string
+    description: IDs of tasks that failed execution
+required:
+  - blocked
+  - failed
+description: Task execution tracking state

package/apis/json-schema/FeatureValidation.yaml

@@ -0,0 +1,21 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: FeatureValidation.yaml
+type: object
+properties:
+  lastRun:
+    type: string
+    description: ISO timestamp of last validation run (null if never run)
+  gatesPassed:
+    type: array
+    items:
+      type: string
+    description: Names of validation gates that passed
+  autoFixesApplied:
+    type: array
+    items:
+      type: string
+    description: Descriptions of auto-fixes that were applied
+required:
+  - gatesPassed
+  - autoFixesApplied
+description: Validation gate results

package/apis/json-schema/GanttTask.yaml

@@ -0,0 +1,34 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: GanttTask.yaml
+type: object
+properties:
+  id:
+    $ref: UUID.yaml
+    description: Unique identifier for the Gantt task
+  name:
+    type: string
+    description: Display name of the task shown in the Gantt chart
+  start:
+    type: string
+    format: date-time
+    description: Scheduled start time for the task
+  end:
+    type: string
+    format: date-time
+    description: Scheduled end time for the task
+  dependencies:
+    type: array
+    items:
+      $ref: UUID.yaml
+    description: IDs of tasks that this task depends on (must complete before this task can start)
+  progress:
+    type: number
+    description: Completion progress as a fraction (0.0 = not started, 1.0 = complete)
+required:
+  - id
+  - name
+  - start
+  - end
+  - dependencies
+  - progress
+description: Individual task representation within a Gantt chart visualization

package/apis/json-schema/GanttViewData.yaml

@@ -0,0 +1,22 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: GanttViewData.yaml
+type: object
+properties:
+  tasks:
+    type: array
+    items:
+      $ref: GanttTask.yaml
+    description: Collection of tasks to display in the Gantt chart
+  startDate:
+    type: string
+    format: date-time
+    description: Start date of the overall work plan (left boundary of the chart)
+  endDate:
+    type: string
+    format: date-time
+    description: End date of the overall work plan (right boundary of the chart)
+required:
+  - tasks
+  - startDate
+  - endDate
+description: Container for Gantt chart visualization data including tasks and time bounds

package/apis/json-schema/InstallationSuggestion.yaml

@@ -0,0 +1,21 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: InstallationSuggestion.yaml
+type: object
+properties:
+  packageManager:
+    type: string
+    description: Package manager or installation method
+  command:
+    type: string
+    description: Installation command
+  documentationUrl:
+    type: string
+    description: Official documentation URL
+  notes:
+    type: string
+    description: Additional notes for installation
+required:
+  - packageManager
+  - command
+  - documentationUrl
+description: Single installation suggestion for a tool

package/apis/json-schema/LocalDeployAgent.yaml

@@ -0,0 +1,18 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: LocalDeployAgent.yaml
+type: object
+properties:
+  id:
+    $ref: UUID.yaml
+    description: Unique identifier for this deployment agent instance
+  url:
+    type: string
+    description: URL where the deployment is accessible once available (null before deployment)
+  createdAt:
+    type: string
+    format: date-time
+    description: Timestamp when this deployment agent was created
+required:
+  - id
+  - createdAt
+description: Agent for handling local deployment of features, tasks, or action items

package/apis/json-schema/Message.yaml

@@ -0,0 +1,29 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: Message.yaml
+type: object
+properties:
+  role:
+    $ref: MessageRole.yaml
+    description: Role of the message sender (User or Assistant)
+  content:
+    type: string
+    description: The text content of the message
+  options:
+    type: array
+    items:
+      type: string
+    description: Optional choices presented to the user for selection
+  answer:
+    type: string
+    description: Optional user's freeform text answer
+  selectedOption:
+    type: integer
+    minimum: -2147483648
+    maximum: 2147483647
+    description: Optional index of the selected option from the options array (0-based)
+required:
+  - role
+  - content
+allOf:
+  - $ref: BaseEntity.yaml
+description: A message in a conversation thread between user and AI assistant

package/apis/json-schema/MessageRole.yaml

@@ -0,0 +1,7 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: MessageRole.yaml
+type: string
+enum:
+  - assistant
+  - user
+description: Roles for participants in conversational interactions

package/apis/json-schema/ModelConfiguration.yaml

@@ -0,0 +1,26 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: ModelConfiguration.yaml
+type: object
+properties:
+  analyze:
+    type: string
+    default: claude-sonnet-4-5
+    description: Model for codebase analysis agent
+  requirements:
+    type: string
+    default: claude-sonnet-4-5
+    description: Model for requirements gathering agent
+  plan:
+    type: string
+    default: claude-sonnet-4-5
+    description: Model for planning agent
+  implement:
+    type: string
+    default: claude-sonnet-4-5
+    description: Model for implementation agent
+required:
+  - analyze
+  - requirements
+  - plan
+  - implement
+description: AI model configuration for different SDLC agents

package/apis/json-schema/NotificationChannelConfig.yaml

@@ -0,0 +1,11 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: NotificationChannelConfig.yaml
+type: object
+properties:
+  enabled:
+    type: boolean
+    default: true
+    description: Whether this notification channel is enabled
+required:
+  - enabled
+description: Notification channel enable/disable configuration

package/apis/json-schema/NotificationEvent.yaml

@@ -0,0 +1,34 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: NotificationEvent.yaml
+type: object
+properties:
+  eventType:
+    $ref: NotificationEventType.yaml
+    description: Type of lifecycle event
+  agentRunId:
+    type: string
+    description: ID of the agent run that triggered this event
+  featureName:
+    type: string
+    description: Human-readable feature name
+  phaseName:
+    type: string
+    description: Phase name (only for phaseCompleted events)
+  message:
+    type: string
+    description: Human-readable event description
+  severity:
+    $ref: NotificationSeverity.yaml
+    description: Display severity for notification rendering
+  timestamp:
+    type: string
+    format: date-time
+    description: When the event occurred
+required:
+  - eventType
+  - agentRunId
+  - featureName
+  - message
+  - severity
+  - timestamp
+description: Notification event emitted for agent lifecycle transitions

package/apis/json-schema/NotificationEventConfig.yaml

@@ -0,0 +1,31 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: NotificationEventConfig.yaml
+type: object
+properties:
+  agentStarted:
+    type: boolean
+    default: true
+    description: Notify when agent starts running
+  phaseCompleted:
+    type: boolean
+    default: true
+    description: Notify when agent completes a workflow phase
+  waitingApproval:
+    type: boolean
+    default: true
+    description: Notify when agent is waiting for human approval
+  agentCompleted:
+    type: boolean
+    default: true
+    description: Notify when agent completes successfully
+  agentFailed:
+    type: boolean
+    default: true
+    description: Notify when agent execution fails
+required:
+  - agentStarted
+  - phaseCompleted
+  - waitingApproval
+  - agentCompleted
+  - agentFailed
+description: Notification event type filters

package/apis/json-schema/NotificationEventType.yaml

@@ -0,0 +1,10 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: NotificationEventType.yaml
+type: string
+enum:
+  - agent_started
+  - phase_completed
+  - waiting_approval
+  - agent_completed
+  - agent_failed
+description: Types of agent lifecycle notification events

package/apis/json-schema/NotificationPreferences.yaml

@@ -0,0 +1,22 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: NotificationPreferences.yaml
+type: object
+properties:
+  inApp:
+    $ref: NotificationChannelConfig.yaml
+    description: In-app toast notification channel (Sonner)
+  browser:
+    $ref: NotificationChannelConfig.yaml
+    description: Browser push notification channel (Web Notifications API)
+  desktop:
+    $ref: NotificationChannelConfig.yaml
+    description: Desktop OS notification channel (node-notifier)
+  events:
+    $ref: NotificationEventConfig.yaml
+    description: Which event types trigger notifications
+required:
+  - inApp
+  - browser
+  - desktop
+  - events
+description: Notification preferences for agent lifecycle events

package/apis/json-schema/NotificationSeverity.yaml

@@ -0,0 +1,9 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: NotificationSeverity.yaml
+type: string
+enum:
+  - info
+  - warning
+  - success
+  - error
+description: Severity level for notification display

package/apis/json-schema/OpenQuestion.yaml

@@ -0,0 +1,25 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: OpenQuestion.yaml
+type: object
+properties:
+  question:
+    type: string
+    description: The question text that needs to be answered
+  resolved:
+    type: boolean
+    description: Whether this question has been resolved (false = blocking)
+  options:
+    type: array
+    items:
+      $ref: QuestionOption.yaml
+    description: Structured options for resolving this question (spec.yaml pattern)
+  selectionRationale:
+    type: string
+    description: Rationale explaining which option was selected and why
+  answer:
+    type: string
+    description: Free-text answer or resolution (research.yaml pattern)
+required:
+  - question
+  - resolved
+description: Open question with resolution via options or direct answer

package/apis/json-schema/PhaseTiming.yaml

@@ -0,0 +1,35 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: PhaseTiming.yaml
+type: object
+properties:
+  agentRunId:
+    type: string
+    description: Agent run this timing belongs to
+  phase:
+    type: string
+    description: "Graph node name: analyze, requirements, research, plan, implement"
+  startedAt:
+    type: string
+    format: date-time
+    description: When the phase started executing
+  completedAt:
+    type: string
+    format: date-time
+    description: When the phase finished executing (null if still running)
+  durationMs:
+    type: string
+    description: Duration in milliseconds (computed on completion)
+  waitingApprovalAt:
+    type: string
+    format: date-time
+    description: When the phase started waiting for user approval (null if no approval needed)
+  approvalWaitMs:
+    type: string
+    description: Duration in milliseconds the phase waited for user approval (null if no approval needed)
+required:
+  - agentRunId
+  - phase
+  - startedAt
+allOf:
+  - $ref: BaseEntity.yaml
+description: Timing record for a single agent graph node execution