target

type AIDLCTarget struct{}

type Agent struct {
	ID           string
	Name         string
	Role         string
	Capabilities []string
	Priority     int
}

type Bead struct {
	ID          string
	Name        string
	Description string
	Status      string   // ready, blocked, done
	BlockedBy   []string // IDs of beads that must complete first
	Agent       string   // Which agent handles this
	Priority    int
}

type Capabilities struct {
	SequentialTasks   bool `json:"sequential_tasks"`
	ParallelExecution bool `json:"parallel_execution"`
	MultiAgent        bool `json:"multi_agent"`
	Verification      bool `json:"verification"`
	DependencyGraph   bool `json:"dependency_graph"`
}

type ExportConfig struct {
	ProjectName string         `json:"project_name"`
	OutputDir   string         `json:"output_dir"`
	Options     map[string]any `json:"options,omitempty"`
}

type ExportResult struct {
	Target    string   `json:"target"`
	OutputDir string   `json:"output_dir"`
	Files     []string `json:"files"`
	Success   bool     `json:"success"`
	Message   string   `json:"message,omitempty"`
}

type GSDTarget struct{}

type GasCityTarget struct{}

type GasTownTarget struct{}

type GitHubIssue struct {
	Title      string   `json:"title"`
	Body       string   `json:"body"`
	Labels     []string `json:"labels,omitempty"`
	Assignees  []string `json:"assignees,omitempty"`
	Milestone  string   `json:"milestone,omitempty"`
	Project    string   `json:"project,omitempty"`
	State      string   `json:"state,omitempty"`
	Priority   string   `json:"priority,omitempty"`
	TaskID     string   `json:"task_id,omitempty"`
	RequireID  string   `json:"requirement_id,omitempty"`
	AcceptCrit []string `json:"acceptance_criteria,omitempty"`
}

type GitHubIssuesExport struct {
	Repository string        `json:"repository"`
	ExportedAt time.Time     `json:"exported_at"`
	Source     string        `json:"source"`
	Issues     []GitHubIssue `json:"issues"`
	Milestones []string      `json:"milestones,omitempty"`
	Labels     []string      `json:"labels,omitempty"`
}

type GitHubIssuesTarget struct{}

type JiraExport struct {
	Project    JiraProject `json:"project"`
	ExportedAt time.Time   `json:"exportedAt"`
	Source     string      `json:"source"`
	Issues     []JiraIssue `json:"issues"`
	Epics      []JiraIssue `json:"epics,omitempty"`
	Components []string    `json:"components,omitempty"`
	Versions   []string    `json:"versions,omitempty"`
}

type JiraIssue struct {
	Key          string            `json:"key,omitempty"`
	Summary      string            `json:"summary"`
	Description  string            `json:"description"`
	IssueType    string            `json:"issuetype"`
	Priority     string            `json:"priority,omitempty"`
	Labels       []string          `json:"labels,omitempty"`
	Components   []string          `json:"components,omitempty"`
	FixVersions  []string          `json:"fixVersions,omitempty"`
	Sprint       string            `json:"sprint,omitempty"`
	Epic         string            `json:"epic,omitempty"`
	Assignee     string            `json:"assignee,omitempty"`
	Reporter     string            `json:"reporter,omitempty"`
	Status       string            `json:"status,omitempty"`
	StoryPoints  float64           `json:"storyPoints,omitempty"`
	AcceptCrit   string            `json:"acceptanceCriteria,omitempty"`
	CustomFields map[string]string `json:"customFields,omitempty"`
	SubTasks     []JiraIssue       `json:"subtasks,omitempty"`
	RequireID    string            `json:"requirementId,omitempty"`
}

type JiraProject struct {
	Key  string `json:"key"`
	Name string `json:"name,omitempty"`
	URL  string `json:"url,omitempty"`
}

type JiraTarget struct{}

type MustHaves struct {
	Truths    []string `json:"truths"`
	Artifacts []string `json:"artifacts"`
	KeyLinks  []string `json:"key_links"`
}

type OpenSpecAppendix struct {
	Glossary    map[string]string   `json:"glossary,omitempty" yaml:"glossary,omitempty"`
	References  []OpenSpecReference `json:"references,omitempty" yaml:"references,omitempty"`
	Diagrams    []string            `json:"diagrams,omitempty" yaml:"diagrams,omitempty"`
	RawSections map[string]string   `json:"raw_sections,omitempty" yaml:"raw_sections,omitempty"`
}

type OpenSpecConstraint struct {
	ID          string `json:"id" yaml:"id"`
	Type        string `json:"type" yaml:"type"` // technical, business, regulatory, timeline
	Description string `json:"description" yaml:"description"`
	Impact      string `json:"impact,omitempty" yaml:"impact,omitempty"`
	Mitigation  string `json:"mitigation,omitempty" yaml:"mitigation,omitempty"`
}

type OpenSpecCriteria struct {
	ID          string `json:"id" yaml:"id"`
	FeatureID   string `json:"feature_id,omitempty" yaml:"feature_id,omitempty"`
	Description string `json:"description" yaml:"description"`
	Type        string `json:"type" yaml:"type"` // functional, performance, security, usability
	Given       string `json:"given,omitempty" yaml:"given,omitempty"`
	When        string `json:"when,omitempty" yaml:"when,omitempty"`
	Then        string `json:"then,omitempty" yaml:"then,omitempty"`
	Status      string `json:"status" yaml:"status"` // pending, passed, failed
}

type OpenSpecDocument struct {
	Version     string               `json:"version" yaml:"version"`
	Metadata    OpenSpecMetadata     `json:"metadata" yaml:"metadata"`
	Overview    OpenSpecOverview     `json:"overview" yaml:"overview"`
	Features    []OpenSpecFeature    `json:"features" yaml:"features"`
	Tasks       []OpenSpecTask       `json:"tasks" yaml:"tasks"`
	Acceptance  []OpenSpecCriteria   `json:"acceptance" yaml:"acceptance"`
	Constraints []OpenSpecConstraint `json:"constraints,omitempty" yaml:"constraints,omitempty"`
	Appendix    *OpenSpecAppendix    `json:"appendix,omitempty" yaml:"appendix,omitempty"`
}

type OpenSpecFeature struct {
	ID           string                 `json:"id" yaml:"id"`
	Name         string                 `json:"name" yaml:"name"`
	Description  string                 `json:"description" yaml:"description"`
	Priority     string                 `json:"priority" yaml:"priority"` // must, should, could, wont
	Status       string                 `json:"status" yaml:"status"`     // proposed, approved, implemented, verified
	Category     string                 `json:"category,omitempty" yaml:"category,omitempty"`
	Requirements []OpenSpecRequirement  `json:"requirements" yaml:"requirements"`
	Dependencies []string               `json:"dependencies,omitempty" yaml:"dependencies,omitempty"`
	Metadata     map[string]interface{} `json:"metadata,omitempty" yaml:"metadata,omitempty"`
}

type OpenSpecMetadata struct {
	Project     string            `json:"project" yaml:"project"`
	Title       string            `json:"title,omitempty" yaml:"title,omitempty"`
	Description string            `json:"description,omitempty" yaml:"description,omitempty"`
	Author      string            `json:"author,omitempty" yaml:"author,omitempty"`
	CreatedAt   time.Time         `json:"created_at" yaml:"created_at"`
	UpdatedAt   time.Time         `json:"updated_at" yaml:"updated_at"`
	Status      string            `json:"status" yaml:"status"` // draft, approved, implemented
	Tags        []string          `json:"tags,omitempty" yaml:"tags,omitempty"`
	Labels      map[string]string `json:"labels,omitempty" yaml:"labels,omitempty"`
	SourceSpec  string            `json:"source_spec,omitempty" yaml:"source_spec,omitempty"`
}

type OpenSpecOverview struct {
	Problem    string   `json:"problem" yaml:"problem"`
	Solution   string   `json:"solution" yaml:"solution"`
	Goals      []string `json:"goals" yaml:"goals"`
	NonGoals   []string `json:"non_goals,omitempty" yaml:"non_goals,omitempty"`
	Audience   []string `json:"audience,omitempty" yaml:"audience,omitempty"`
	Milestones []string `json:"milestones,omitempty" yaml:"milestones,omitempty"`
}

type OpenSpecReference struct {
	Title string `json:"title" yaml:"title"`
	URL   string `json:"url,omitempty" yaml:"url,omitempty"`
	Type  string `json:"type,omitempty" yaml:"type,omitempty"`
}

type OpenSpecRequirement struct {
	ID           string `json:"id" yaml:"id"`
	Type         string `json:"type" yaml:"type"` // functional, nonfunctional, constraint
	Description  string `json:"description" yaml:"description"`
	Rationale    string `json:"rationale,omitempty" yaml:"rationale,omitempty"`
	Priority     string `json:"priority" yaml:"priority"`
	Status       string `json:"status" yaml:"status"`
	Verification string `json:"verification,omitempty" yaml:"verification,omitempty"`
}

type OpenSpecTarget struct{}

type OpenSpecTask struct {
	ID          string   `json:"id" yaml:"id"`
	Title       string   `json:"title" yaml:"title"`
	Description string   `json:"description,omitempty" yaml:"description,omitempty"`
	Type        string   `json:"type" yaml:"type"` // feature, bugfix, refactor, docs, test
	Priority    string   `json:"priority" yaml:"priority"`
	Status      string   `json:"status" yaml:"status"` // todo, in_progress, done, blocked
	Assignee    string   `json:"assignee,omitempty" yaml:"assignee,omitempty"`
	FeatureID   string   `json:"feature_id,omitempty" yaml:"feature_id,omitempty"`
	DependsOn   []string `json:"depends_on,omitempty" yaml:"depends_on,omitempty"`
	Blocks      []string `json:"blocks,omitempty" yaml:"blocks,omitempty"`
	Estimate    string   `json:"estimate,omitempty" yaml:"estimate,omitempty"`
	Labels      []string `json:"labels,omitempty" yaml:"labels,omitempty"`
}

type Order struct {
	ID          string
	Description string
	AssignedTo  string   // Agent ID
	DependsOn   []string // Order IDs
	Status      string   // pending, in_progress, complete
	Priority    int
}

type Phase struct {
	Name        string   `json:"name"`
	Description string   `json:"description"`
	Tasks       []string `json:"tasks"`
	Wave        int      `json:"wave"`
}

type SpecKitTarget struct{}

type SyncResult struct {
	Target   string      `json:"target"`
	SyncedAt time.Time   `json:"synced_at"`
	Tasks    []TaskState `json:"tasks"`
	Summary  SyncSummary `json:"summary"`
}

type SyncSummary struct {
	TotalTasks int `json:"total_tasks"`
	TodoCount  int `json:"todo_count"`
	InProgress int `json:"in_progress"`
	DoneCount  int `json:"done_count"`
}

type Syncer interface {
	// CanSync returns whether this target supports syncing.
	CanSync(config ExportConfig) bool

	// Sync retrieves task state from the exported target.
	Sync(config ExportConfig) (*SyncResult, error)
}

type Target interface {
	// Name returns the target name.
	Name() string

	// Description returns a description of the target.
	Description() string

	// Capabilities returns what this target supports.
	Capabilities() Capabilities

	// Validate checks if the spec can be exported to this target.
	Validate(spec string) error

	// Export exports the spec to this target.
	Export(spec string, config ExportConfig) (*ExportResult, error)
}

type TargetInfo struct {
	Name         string       `json:"name"`
	Description  string       `json:"description"`
	Capabilities Capabilities `json:"capabilities"`
}

type Task struct {
	ID          string   `json:"id"`
	Description string   `json:"description"`
	Status      string   `json:"status"` // todo, in_progress, done
	Priority    string   `json:"priority"`
	DependsOn   []string `json:"depends_on,omitempty"`
}

type TaskState struct {
	ID     string `json:"id"`
	Title  string `json:"title"`
	Status string `json:"status"` // todo, in_progress, done, blocked
}