core

type Architecture struct {
	// Pattern is the primary architectural pattern (e.g., "adapter", "hexagonal").
	Pattern string `json:"pattern,omitempty"`

	// Summary is a brief summary of the architecture.
	Summary string `json:"summary,omitempty"`

	// Diagrams contains ASCII or mermaid diagrams.
	Diagrams []Diagram `json:"diagrams,omitempty"`
}

type BaseConverter struct {
	// contains filtered or unexported fields
}

type Context struct {
	// Schema is the JSON Schema reference for validation.
	Schema string `json:"$schema,omitempty"`

	// Name is the project name.
	Name string `json:"name"`

	// Description is a brief description of the project's purpose.
	Description string `json:"description,omitempty"`

	// Version is the current project version.
	Version string `json:"version,omitempty"`

	// Language is the primary programming language.
	Language string `json:"language,omitempty"`

	// Architecture describes the high-level architecture.
	Architecture *Architecture `json:"architecture,omitempty"`

	// Packages lists key packages/modules and their purposes.
	Packages []Package `json:"packages,omitempty"`

	// Commands contains common commands for working with the project.
	Commands map[string]string `json:"commands,omitempty"`

	// Conventions lists coding conventions and patterns.
	Conventions []string `json:"conventions,omitempty"`

	// Dependencies describes key dependencies.
	Dependencies *Dependencies `json:"dependencies,omitempty"`

	// Testing describes the testing strategy.
	Testing *Testing `json:"testing,omitempty"`

	// Files describes important files.
	Files *Files `json:"files,omitempty"`

	// Notes contains additional notes and gotchas.
	Notes []Note `json:"notes,omitempty"`

	// Related lists related projects or resources.
	Related []Related `json:"related,omitempty"`
}

type ConversionError struct {
	Format string
	Err    error
}

type Converter interface {
	// Name returns the converter name (e.g., "claude", "cursor").
	Name() string

	// OutputFileName returns the default output file name (e.g., "CLAUDE.md").
	OutputFileName() string

	// Convert converts the context to the tool-specific format.
	Convert(ctx *Context) ([]byte, error)

	// WriteFile writes the converted context to a file.
	WriteFile(ctx *Context, path string) error
}

type ConverterRegistry struct {
	// contains filtered or unexported fields
}

type Dependencies struct {
	// Runtime lists runtime dependencies.
	Runtime []Dependency `json:"runtime,omitempty"`

	// Development lists development dependencies.
	Development []Dependency `json:"development,omitempty"`
}

type Dependency struct {
	// Name is the dependency name/identifier.
	Name string `json:"name"`

	// Purpose describes what this dependency is used for.
	Purpose string `json:"purpose,omitempty"`
}

type Diagram struct {
	// Title is the diagram title.
	Title string `json:"title,omitempty"`

	// Type is the diagram type ("ascii" or "mermaid").
	Type string `json:"type,omitempty"`

	// Content is the diagram content.
	Content string `json:"content"`
}

type Files struct {
	// EntryPoints lists main entry point files.
	EntryPoints []string `json:"entryPoints,omitempty"`

	// Config lists configuration files.
	Config []string `json:"config,omitempty"`

	// Ignore lists files/patterns to ignore during analysis.
	Ignore []string `json:"ignore,omitempty"`
}

type Note struct {
	// Title is an optional title for the note.
	Title string `json:"title,omitempty"`

	// Content is the note content.
	Content string `json:"content"`

	// Severity indicates the importance (info, warning, critical).
	Severity string `json:"severity,omitempty"`
}

type Package struct {
	// Path is the relative path to the package.
	Path string `json:"path"`

	// Purpose is a brief description of the package's purpose.
	Purpose string `json:"purpose"`

	// Public indicates whether this is part of the public API.
	Public *bool `json:"public,omitempty"`
}

type ParseError struct {
	Path string
	Err  error
}

type Related struct {
	// Name is the name of the related item.
	Name string `json:"name"`

	// URL is an optional URL.
	URL string `json:"url,omitempty"`

	// Description is an optional description.
	Description string `json:"description,omitempty"`
}

type Testing struct {
	// Framework is the testing framework used.
	Framework string `json:"framework,omitempty"`

	// Coverage describes coverage requirements or current coverage.
	Coverage string `json:"coverage,omitempty"`

	// Patterns lists testing patterns and conventions.
	Patterns []string `json:"patterns,omitempty"`
}

type WriteError struct {
	Format string
	Path   string
	Err    error
}