@shepai/cli 1.44.1 → 1.45.0

package/apis/json-schema/AcceptanceCriteria.yaml

@@ -0,0 +1,16 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: AcceptanceCriteria.yaml
+type: object
+properties:
+  description:
+    type: string
+    description: Description of what must be true for this criterion to be satisfied
+  verified:
+    type: boolean
+    description: Whether this criterion has been verified as complete
+required:
+  - description
+  - verified
+allOf:
+  - $ref: BaseEntity.yaml
+description: Acceptance criterion for validating completion of an action item

package/apis/json-schema/ActionItem.yaml

@@ -0,0 +1,32 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: ActionItem.yaml
+type: object
+properties:
+  name:
+    type: string
+    description: Short name describing the action (verb-noun pattern recommended)
+  description:
+    type: string
+    description: Detailed description of the work to be performed
+  branch:
+    type: string
+    description: Git branch name where this action item's work is performed
+  dependsOn:
+    type: array
+    items:
+      $ref: ActionItem.yaml
+    description: Action items that must complete before this one can start
+  acceptanceCriteria:
+    type: array
+    items:
+      $ref: AcceptanceCriteria.yaml
+    description: Acceptance criteria for verifying completion of this action item
+required:
+  - name
+  - description
+  - branch
+  - dependsOn
+  - acceptanceCriteria
+allOf:
+  - $ref: BaseEntity.yaml
+description: Granular, atomic step within a Task representing a single unit of work

package/apis/json-schema/AgentAuthMethod.yaml

@@ -0,0 +1,7 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: AgentAuthMethod.yaml
+type: string
+enum:
+  - session
+  - token
+description: Authentication method for the AI agent

package/apis/json-schema/AgentConfig.yaml

@@ -0,0 +1,19 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: AgentConfig.yaml
+type: object
+properties:
+  type:
+    $ref: AgentType.yaml
+    default: claude-code
+    description: Selected AI coding agent
+  authMethod:
+    $ref: AgentAuthMethod.yaml
+    default: session
+    description: Authentication method for the agent
+  token:
+    type: string
+    description: API token for token-based auth (optional)
+required:
+  - type
+  - authMethod
+description: AI coding agent configuration

package/apis/json-schema/AgentDefinition.yaml

@@ -0,0 +1,14 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: AgentDefinition.yaml
+type: object
+properties:
+  name:
+    type: string
+    description: Unique agent workflow name (e.g., analyze-repository)
+  description:
+    type: string
+    description: Human-readable description of what this agent does
+required:
+  - name
+  - description
+description: Agent workflow registration metadata

package/apis/json-schema/AgentFeature.yaml

@@ -0,0 +1,10 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: AgentFeature.yaml
+type: string
+enum:
+  - session-resume
+  - streaming
+  - tool-scoping
+  - structured-output
+  - system-prompt
+description: Agent executor capability declarations

package/apis/json-schema/AgentInstance.yaml

@@ -0,0 +1,23 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: AgentInstance.yaml
+type: object
+properties:
+  id:
+    $ref: UUID.yaml
+    description: Unique identifier for this agent instance
+  branch:
+    type: string
+    description: Git branch this agent is operating on for code changes
+  status:
+    $ref: AgentStatus.yaml
+    description: Current operational status of the agent (Idle, Running, Paused, or Stopped)
+  createdAt:
+    type: string
+    format: date-time
+    description: Timestamp when this agent instance was created
+required:
+  - id
+  - branch
+  - status
+  - createdAt
+description: A running agent instance that processes work and responds to queries

package/apis/json-schema/AgentRun.yaml

@@ -0,0 +1,63 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: AgentRun.yaml
+type: object
+properties:
+  agentType:
+    $ref: AgentType.yaml
+    description: Agent executor type used (claude-code, gemini-cli, etc.)
+  agentName:
+    type: string
+    description: Agent workflow name (analyze-repository, requirements, etc.)
+  status:
+    $ref: AgentRunStatus.yaml
+    description: Current execution status
+  prompt:
+    type: string
+    description: Input prompt sent to agent executor
+  result:
+    type: string
+    description: Final result output (optional, populated on completion)
+  sessionId:
+    type: string
+    description: Executor session ID for resumption (optional)
+  threadId:
+    type: string
+    description: LangGraph thread_id for checkpoint lookup and crash resume
+  pid:
+    type: integer
+    minimum: -2147483648
+    maximum: 2147483647
+    description: Process ID for crash recovery (optional)
+  lastHeartbeat:
+    type: string
+    format: date-time
+    description: Last heartbeat timestamp for crash detection (optional)
+  startedAt:
+    type: string
+    format: date-time
+    description: Execution start timestamp (optional)
+  completedAt:
+    type: string
+    format: date-time
+    description: Execution completion timestamp (optional)
+  error:
+    type: string
+    description: Error message if execution failed (optional)
+  featureId:
+    type: string
+    description: Associated feature ID for feature agent runs (optional)
+  repositoryPath:
+    type: string
+    description: Repository path for context scoping (optional)
+  approvalGates:
+    $ref: ApprovalGates.yaml
+    description: Approval gate configuration for human-in-the-loop review (optional)
+required:
+  - agentType
+  - agentName
+  - status
+  - prompt
+  - threadId
+allOf:
+  - $ref: BaseEntity.yaml
+description: Agent execution run record

package/apis/json-schema/AgentRunEvent.yaml

@@ -0,0 +1,25 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: AgentRunEvent.yaml
+type: object
+properties:
+  type:
+    anyOf:
+      - type: string
+        const: progress
+      - type: string
+        const: result
+      - type: string
+        const: error
+    description: "Event type: progress, result, or error"
+  content:
+    type: string
+    description: Event content
+  timestamp:
+    type: string
+    format: date-time
+    description: Event timestamp
+required:
+  - type
+  - content
+  - timestamp
+description: Streaming event emitted during agent execution

package/apis/json-schema/AgentRunStatus.yaml

@@ -0,0 +1,12 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: AgentRunStatus.yaml
+type: string
+enum:
+  - pending
+  - running
+  - completed
+  - failed
+  - interrupted
+  - cancelled
+  - waiting_approval
+description: Agent run execution status

package/apis/json-schema/AgentStatus.yaml

@@ -0,0 +1,9 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: AgentStatus.yaml
+type: string
+enum:
+  - Idle
+  - Running
+  - Paused
+  - Stopped
+description: Operational states for AI agents

package/apis/json-schema/AgentType.yaml

@@ -0,0 +1,10 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: AgentType.yaml
+type: string
+enum:
+  - claude-code
+  - gemini-cli
+  - aider
+  - continue
+  - cursor
+description: AI coding agent tool selection

package/apis/json-schema/ApprovalGates.yaml

@@ -0,0 +1,18 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: ApprovalGates.yaml
+type: object
+properties:
+  allowPrd:
+    type: boolean
+    description: Skip human review after requirements phase
+  allowPlan:
+    type: boolean
+    description: Skip human review after plan phase
+  allowMerge:
+    type: boolean
+    description: Skip human review after merge phase
+required:
+  - allowPrd
+  - allowPlan
+  - allowMerge
+description: Configuration for human-in-the-loop approval gates

package/apis/json-schema/Artifact.yaml

@@ -0,0 +1,36 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: Artifact.yaml
+type: object
+properties:
+  name:
+    type: string
+    description: Human-readable name identifying this artifact
+  type:
+    type: string
+    description: Type description providing additional context (e.g., 'documentation', 'api-spec')
+  category:
+    $ref: ArtifactCategory.yaml
+    description: Category classification (PRD, API, Design, or Other)
+  format:
+    $ref: ArtifactFormat.yaml
+    description: File format for the artifact content
+  summary:
+    type: string
+    description: Brief summary of the artifact's content and purpose
+  path:
+    type: string
+    description: Relative file path where the artifact is stored
+  state:
+    $ref: ArtifactState.yaml
+    description: Current state in the artifact generation lifecycle
+required:
+  - name
+  - type
+  - category
+  - format
+  - summary
+  - path
+  - state
+allOf:
+  - $ref: BaseEntity.yaml
+description: Generated document or file attached to a Feature

package/apis/json-schema/ArtifactCategory.yaml

@@ -0,0 +1,9 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: ArtifactCategory.yaml
+type: string
+enum:
+  - PRD
+  - API
+  - Design
+  - Other
+description: Categories for classifying artifact types by purpose

package/apis/json-schema/ArtifactFormat.yaml

@@ -0,0 +1,9 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: ArtifactFormat.yaml
+type: string
+enum:
+  - md
+  - txt
+  - yaml
+  - Other
+description: File formats for artifact content storage

package/apis/json-schema/ArtifactState.yaml

@@ -0,0 +1,8 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: ArtifactState.yaml
+type: string
+enum:
+  - Todo
+  - Elaborating
+  - Done
+description: States for artifact entities during generation

package/apis/json-schema/AskRequest.yaml

@@ -0,0 +1,10 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: AskRequest.yaml
+type: object
+properties:
+  query:
+    type: string
+    description: The natural language query to be processed by the AI agent
+required:
+  - query
+description: Request model for conversational AI interactions

package/apis/json-schema/AskResponse.yaml

@@ -0,0 +1,14 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: AskResponse.yaml
+type: object
+properties:
+  content:
+    type: string
+    description: The AI-generated response content (typically Markdown-formatted)
+  success:
+    type: boolean
+    description: Whether the operation completed successfully
+required:
+  - content
+  - success
+description: Response model for conversational AI interactions

package/apis/json-schema/AuditableEntity.yaml

@@ -0,0 +1,13 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: AuditableEntity.yaml
+type: object
+properties:
+  createdBy:
+    $ref: UUID.yaml
+    description: UUID of the user who created this entity (null for system-created)
+  updatedBy:
+    $ref: UUID.yaml
+    description: UUID of the user who last updated this entity (null for system-updated)
+allOf:
+  - $ref: BaseEntity.yaml
+description: Entity with audit trail tracking who created and modified it

package/apis/json-schema/BaseEntity.yaml

@@ -0,0 +1,20 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: BaseEntity.yaml
+type: object
+properties:
+  id:
+    $ref: UUID.yaml
+    description: Unique identifier for this entity (UUID v4 format)
+  createdAt:
+    type: string
+    format: date-time
+    description: Timestamp when this entity was created (read-only, set by system)
+  updatedAt:
+    type: string
+    format: date-time
+    description: Timestamp when this entity was last updated (read-only, set by system)
+required:
+  - id
+  - createdAt
+  - updatedAt
+description: Base model providing identity and timestamp fields for all domain entities

package/apis/json-schema/CiStatus.yaml

@@ -0,0 +1,8 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: CiStatus.yaml
+type: string
+enum:
+  - Pending
+  - Success
+  - Failure
+description: CI pipeline status

package/apis/json-schema/DeployMethod.yaml

@@ -0,0 +1,10 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: DeployMethod.yaml
+type: string
+enum:
+  - DockerCompose
+  - Docker
+  - Kubernetes
+  - Script
+  - Manual
+description: Methods for deploying applications

package/apis/json-schema/DeploySkill.yaml

@@ -0,0 +1,29 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: DeploySkill.yaml
+type: object
+properties:
+  id:
+    $ref: UUID.yaml
+    description: Unique identifier for the deployment skill configuration
+  ports:
+    type: array
+    items:
+      $ref: PortMap.yaml
+    description: List of port mappings for services to expose when deployed
+  method:
+    $ref: DeployMethod.yaml
+    description: Method to use for deployment (DockerCompose, Docker, Kubernetes, Script, or Manual)
+  instructions:
+    type: string
+    description: Deployment instructions or commands to execute for this deployment method
+  createdAt:
+    type: string
+    format: date-time
+    description: Timestamp when the deployment skill was created
+required:
+  - id
+  - ports
+  - method
+  - instructions
+  - createdAt
+description: Configuration defining how to deploy an application with method and instructions

package/apis/json-schema/DeployTarget.yaml

@@ -0,0 +1,10 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: DeployTarget.yaml
+anyOf:
+  - $ref: DeployTargetActionItem.yaml
+    description: Deploy a single action item for granular change preview
+  - $ref: DeployTargetTask.yaml
+    description: Deploy a single task with all its action items
+  - $ref: DeployTargetTasks.yaml
+    description: Deploy multiple tasks together for batch deployments
+description: Target for deployment operations - can be an action item, single task, or multiple tasks

package/apis/json-schema/DeployTargetActionItem.yaml

@@ -0,0 +1,15 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: DeployTargetActionItem.yaml
+type: object
+properties:
+  kind:
+    type: string
+    const: actionItem
+    description: Discriminator indicating this is an action item target
+  actionItem:
+    $ref: ActionItem.yaml
+    description: The action item to deploy - represents an atomic unit of work
+required:
+  - kind
+  - actionItem
+description: Deployment target wrapping a single ActionItem for granular deployments

package/apis/json-schema/DeployTargetTask.yaml

@@ -0,0 +1,15 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: DeployTargetTask.yaml
+type: object
+properties:
+  kind:
+    type: string
+    const: task
+    description: Discriminator indicating this is a task target
+  task:
+    $ref: Task.yaml
+    description: The task to deploy - includes all action items within the task
+required:
+  - kind
+  - task
+description: Deployment target wrapping a single Task for task-level deployments

package/apis/json-schema/DeployTargetTasks.yaml

@@ -0,0 +1,17 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: DeployTargetTasks.yaml
+type: object
+properties:
+  kind:
+    type: string
+    const: tasks
+    description: Discriminator indicating this is a multi-task target
+  tasks:
+    type: array
+    items:
+      $ref: Task.yaml
+    description: The tasks to deploy - enables batch deployment of related work
+required:
+  - kind
+  - tasks
+description: Deployment target wrapping multiple Tasks for batch deployments

package/apis/json-schema/Deployment.yaml

@@ -0,0 +1,33 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: Deployment.yaml
+type: object
+properties:
+  id:
+    $ref: UUID.yaml
+    description: Unique identifier for the deployment instance
+  state:
+    $ref: DeploymentState.yaml
+    description: Current state of the deployment (Booting, Ready, or Stopped)
+  url:
+    type: string
+    description: URL where the deployment is accessible (e.g., 'http://localhost:30100/' or 'http://172.33.0.20:5173')
+  ports:
+    type: array
+    items:
+      $ref: PortMap.yaml
+    description: List of port mappings for services exposed by this deployment
+  createdAt:
+    type: string
+    format: date-time
+    description: Timestamp when the deployment was created
+  stoppedAt:
+    type: string
+    format: date-time
+    description: Timestamp when the deployment was stopped (only present when state is Stopped)
+required:
+  - id
+  - state
+  - url
+  - ports
+  - createdAt
+description: A running deployment instance with network configuration and lifecycle management

package/apis/json-schema/DeploymentState.yaml

@@ -0,0 +1,8 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: DeploymentState.yaml
+type: string
+enum:
+  - Booting
+  - Ready
+  - Stopped
+description: States for deployment instances

package/apis/json-schema/EditorType.yaml

@@ -0,0 +1,10 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: EditorType.yaml
+type: string
+enum:
+  - vscode
+  - cursor
+  - windsurf
+  - zed
+  - antigravity
+description: Supported IDE/editor type

package/apis/json-schema/EnvironmentConfig.yaml

@@ -0,0 +1,16 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: EnvironmentConfig.yaml
+type: object
+properties:
+  defaultEditor:
+    $ref: EditorType.yaml
+    default: vscode
+    description: Preferred code editor
+  shellPreference:
+    type: string
+    default: bash
+    description: Preferred shell
+required:
+  - defaultEditor
+  - shellPreference
+description: Environment and tooling preferences

package/apis/json-schema/Feature.yaml

@@ -0,0 +1,77 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: Feature.yaml
+type: object
+properties:
+  name:
+    type: string
+    description: Human-readable name identifying this feature
+  userQuery:
+    type: string
+    description: The exact user input that initiated this feature, preserved verbatim
+  slug:
+    type: string
+    description: URL-friendly identifier derived from name (unique within repository)
+  description:
+    type: string
+    description: Detailed description explaining the feature's purpose and scope
+  repositoryPath:
+    type: string
+    description: Absolute file system path to the repository
+  branch:
+    type: string
+    description: Git branch name where this feature's work is performed
+  lifecycle:
+    $ref: SdlcLifecycle.yaml
+    description: Current stage in the SDLC lifecycle
+  messages:
+    type: array
+    items:
+      $ref: Message.yaml
+    description: Conversation history with the AI assistant
+  plan:
+    $ref: Plan.yaml
+    description: Implementation plan containing tasks, artifacts, and requirements (optional)
+  relatedArtifacts:
+    type: array
+    items:
+      $ref: Artifact.yaml
+    description: Generated documents and artifacts attached to this feature
+  agentRunId:
+    type: string
+    description: Associated agent run ID for process tracking (optional)
+  specPath:
+    type: string
+    description: Absolute path to the feature spec directory inside the worktree
+  push:
+    type: boolean
+    default: false
+    description: "Push branch to remote after implementation (default: false)"
+  openPr:
+    type: boolean
+    default: false
+    description: "Create PR after implementation (default: false)"
+  approvalGates:
+    $ref: ApprovalGates.yaml
+    description: Approval gates configuration (embedded value object)
+  worktreePath:
+    type: string
+    description: Absolute path to the git worktree for this feature
+  pr:
+    $ref: PullRequest.yaml
+    description: Pull request data (null until PR created)
+required:
+  - name
+  - userQuery
+  - slug
+  - description
+  - repositoryPath
+  - branch
+  - lifecycle
+  - messages
+  - relatedArtifacts
+  - push
+  - openPr
+  - approvalGates
+allOf:
+  - $ref: BaseEntity.yaml
+description: Central entity tracking a piece of work through the SDLC lifecycle (Aggregate Root)