feat(v2): add output and detect packages

- internal/output: JSON response types, error codes, exit codes, pretty output
- internal/detect: auto-detection of project type (static/docker/binary)
- PROGRESS.md: track rebuild progress

Foundation for agent-first JSON interface per SPEC.md

2 files changed, 327 insertions, 0 deletions

diff --git a/internal/detect/detect.go b/internal/detect/detect.go
new file mode 100644
index 0000000..f3efd22
--- /dev/null
+++ b/internal/detect/detect.go
@@ -0,0 +1,105 @@
+// Package detect provides auto-detection of project types.
+package detect
+
+import (
+        "os"
+        "path/filepath"
+
+        "github.com/bdw/ship/internal/output"
+)
+
+// ProjectType represents the detected deployment type
+type ProjectType string
+
+const (
+        TypeStatic ProjectType = "static"
+        TypeDocker ProjectType = "docker"
+        TypeBinary ProjectType = "binary"
+)
+
+// Result is the detection outcome
+type Result struct {
+        Type    ProjectType
+        Path    string // Absolute path to deploy
+        Error   *output.ErrorResponse
+}
+
+// Detect examines a path and determines how to deploy it.
+// Follows the logic from SPEC.md:
+//   - File: must be executable → binary
+//   - Directory with Dockerfile → docker
+//   - Directory with index.html → static
+//   - Go/Node without Dockerfile → error with guidance
+//   - Empty or unknown → error
+func Detect(path string) Result {
+        absPath, err := filepath.Abs(path)
+        if err != nil {
+                return Result{Error: output.Err(output.ErrInvalidPath, "cannot resolve path: "+err.Error())}
+        }
+
+        info, err := os.Stat(absPath)
+        if err != nil {
+                if os.IsNotExist(err) {
+                        return Result{Error: output.Err(output.ErrInvalidPath, "path does not exist: "+path)}
+                }
+                return Result{Error: output.Err(output.ErrInvalidPath, "cannot access path: "+err.Error())}
+        }
+
+        // File: must be executable binary
+        if !info.IsDir() {
+                return detectFile(absPath, info)
+        }
+
+        // Directory: check contents
+        return detectDirectory(absPath)
+}
+
+func detectFile(path string, info os.FileInfo) Result {
+        // Check if executable
+        if info.Mode()&0111 == 0 {
+                return Result{Error: output.Err(output.ErrUnknownProjectType, "file is not executable")}
+        }
+        return Result{Type: TypeBinary, Path: path}
+}
+
+func detectDirectory(path string) Result {
+        // Check for Dockerfile first (highest priority)
+        if hasFile(path, "Dockerfile") {
+                return Result{Type: TypeDocker, Path: path}
+        }
+
+        // Check for static site
+        if hasFile(path, "index.html") || hasFile(path, "index.htm") {
+                return Result{Type: TypeStatic, Path: path}
+        }
+
+        // Check for Go project without Dockerfile
+        if hasFile(path, "go.mod") {
+                return Result{Error: output.Err(output.ErrUnknownProjectType,
+                        "Go project without Dockerfile. Add a Dockerfile or build a binary first.")}
+        }
+
+        // Check for Node project without Dockerfile
+        if hasFile(path, "package.json") {
+                return Result{Error: output.Err(output.ErrUnknownProjectType,
+                        "Node project without Dockerfile. Add a Dockerfile.")}
+        }
+
+        // Check if empty
+        entries, err := os.ReadDir(path)
+        if err != nil {
+                return Result{Error: output.Err(output.ErrInvalidPath, "cannot read directory: "+err.Error())}
+        }
+        if len(entries) == 0 {
+                return Result{Error: output.Err(output.ErrInvalidPath, "directory is empty")}
+        }
+
+        // Unknown
+        return Result{Error: output.Err(output.ErrUnknownProjectType,
+                "cannot detect project type. Add a Dockerfile or index.html.")}
+}
+
+func hasFile(dir, name string) bool {
+        _, err := os.Stat(filepath.Join(dir, name))
+        return err == nil
+}
diff --git a/internal/output/output.go b/internal/output/output.go
new file mode 100644
index 0000000..13e34a3
--- /dev/null
+++ b/internal/output/output.go
@@ -0,0 +1,222 @@
+// Package output provides JSON response types for ship v2.
+// All commands output JSON by default. Human-readable output is opt-in via --pretty.
+package output
+
+import (
+        "encoding/json"
+        "fmt"
+        "os"
+)
+
+// Response is the base interface for all output types
+type Response interface {
+        IsError() bool
+}
+
+// DeployResponse is returned on successful deploy
+type DeployResponse struct {
+        Status  string          `json:"status"`
+        Name    string          `json:"name"`
+        URL     string          `json:"url"`
+        Type    string          `json:"type"` // "static", "docker", "binary"
+        TookMs  int64           `json:"took_ms"`
+        Health  *HealthResult   `json:"health,omitempty"`
+        Expires string          `json:"expires,omitempty"` // ISO 8601, only if TTL set
+}
+
+func (r DeployResponse) IsError() bool { return false }
+
+// HealthResult is the health check outcome
+type HealthResult struct {
+        Endpoint  string `json:"endpoint"`
+        Status    int    `json:"status"`
+        LatencyMs int64  `json:"latency_ms"`
+}
+
+// ListResponse is returned by ship list
+type ListResponse struct {
+        Status  string       `json:"status"`
+        Deploys []DeployInfo `json:"deploys"`
+}
+
+func (r ListResponse) IsError() bool { return false }
+
+// DeployInfo is a single deploy in a list
+type DeployInfo struct {
+        Name    string `json:"name"`
+        URL     string `json:"url"`
+        Type    string `json:"type"`
+        Running bool   `json:"running"`
+        Expires string `json:"expires,omitempty"`
+}
+
+// StatusResponse is returned by ship status
+type StatusResponse struct {
+        Status    string `json:"status"`
+        Name      string `json:"name"`
+        URL       string `json:"url"`
+        Type      string `json:"type"`
+        Running   bool   `json:"running"`
+        Port      int    `json:"port,omitempty"`
+        Expires   string `json:"expires,omitempty"`
+        Memory    string `json:"memory,omitempty"`
+        CPU       string `json:"cpu,omitempty"`
+}
+
+func (r StatusResponse) IsError() bool { return false }
+
+// LogsResponse is returned by ship logs
+type LogsResponse struct {
+        Status string   `json:"status"`
+        Name   string   `json:"name"`
+        Lines  []string `json:"lines"`
+}
+
+func (r LogsResponse) IsError() bool { return false }
+
+// RemoveResponse is returned by ship remove
+type RemoveResponse struct {
+        Status  string `json:"status"`
+        Name    string `json:"name"`
+        Removed bool   `json:"removed"`
+}
+
+func (r RemoveResponse) IsError() bool { return false }
+
+// HostInitResponse is returned by ship host init
+type HostInitResponse struct {
+        Status    string   `json:"status"`
+        Host      string   `json:"host"`
+        Domain    string   `json:"domain"`
+        Installed []string `json:"installed"`
+}
+
+func (r HostInitResponse) IsError() bool { return false }
+
+// ErrorResponse is returned on any failure
+type ErrorResponse struct {
+        Status  string `json:"status"` // always "error"
+        Code    string `json:"code"`
+        Message string `json:"message"`
+        Name    string `json:"name,omitempty"`
+        URL     string `json:"url,omitempty"`
+}
+
+func (r ErrorResponse) IsError() bool { return true }
+
+// Error codes
+const (
+        ErrInvalidPath         = "INVALID_PATH"
+        ErrUnknownProjectType  = "UNKNOWN_PROJECT_TYPE"
+        ErrSSHConnectFailed    = "SSH_CONNECT_FAILED"
+        ErrSSHAuthFailed       = "SSH_AUTH_FAILED"
+        ErrUploadFailed        = "UPLOAD_FAILED"
+        ErrBuildFailed         = "BUILD_FAILED"
+        ErrServiceFailed       = "SERVICE_FAILED"
+        ErrCaddyFailed         = "CADDY_FAILED"
+        ErrHealthCheckFailed   = "HEALTH_CHECK_FAILED"
+        ErrHealthCheckTimeout  = "HEALTH_CHECK_TIMEOUT"
+        ErrNotFound            = "NOT_FOUND"
+        ErrConflict            = "CONFLICT"
+        ErrHostNotConfigured   = "HOST_NOT_CONFIGURED"
+        ErrInvalidTTL          = "INVALID_TTL"
+        ErrInvalidName         = "INVALID_NAME"
+        ErrPortExhausted       = "PORT_EXHAUSTED"
+)
+
+// Exit codes
+const (
+        ExitSuccess       = 0
+        ExitDeployFailed  = 1
+        ExitInvalidArgs   = 2
+        ExitSSHFailed     = 3
+        ExitHealthFailed  = 4
+)
+
+// Pretty controls human-readable output
+var Pretty bool
+
+// Print outputs the response as JSON (or pretty if enabled)
+func Print(r Response) {
+        if Pretty {
+                printPretty(r)
+                return
+        }
+        enc := json.NewEncoder(os.Stdout)
+        enc.Encode(r)
+}
+
+// PrintAndExit outputs the response and exits with appropriate code
+func PrintAndExit(r Response) {
+        Print(r)
+        if r.IsError() {
+                os.Exit(exitCodeForError(r.(*ErrorResponse).Code))
+        }
+        os.Exit(ExitSuccess)
+}
+
+// Err creates an ErrorResponse
+func Err(code, message string) *ErrorResponse {
+        return &ErrorResponse{
+                Status:  "error",
+                Code:    code,
+                Message: message,
+        }
+}
+
+// ErrWithName creates an ErrorResponse with name context
+func ErrWithName(code, message, name string) *ErrorResponse {
+        return &ErrorResponse{
+                Status:  "error",
+                Code:    code,
+                Message: message,
+                Name:    name,
+        }
+}
+
+func exitCodeForError(code string) int {
+        switch code {
+        case ErrSSHConnectFailed, ErrSSHAuthFailed:
+                return ExitSSHFailed
+        case ErrHealthCheckFailed, ErrHealthCheckTimeout:
+                return ExitHealthFailed
+        case ErrInvalidPath, ErrInvalidTTL, ErrInvalidName, ErrHostNotConfigured:
+                return ExitInvalidArgs
+        default:
+                return ExitDeployFailed
+        }
+}
+
+func printPretty(r Response) {
+        switch v := r.(type) {
+        case *DeployResponse:
+                fmt.Printf("✓ Deployed to %s (%.1fs)\n", v.URL, float64(v.TookMs)/1000)
+        case *ListResponse:
+                if len(v.Deploys) == 0 {
+                        fmt.Println("No deployments")
+                        return
+                }
+                fmt.Printf("%-20s %-40s %-8s %s\n", "NAME", "URL", "TYPE", "STATUS")
+                for _, d := range v.Deploys {
+                        status := "running"
+                        if !d.Running {
+                                status = "stopped"
+                        }
+                        if d.Expires != "" {
+                                status += " (expires " + d.Expires + ")"
+                        }
+                        fmt.Printf("%-20s %-40s %-8s %s\n", d.Name, d.URL, d.Type, status)
+                }
+        case *RemoveResponse:
+                fmt.Printf("✓ Removed %s\n", v.Name)
+        case *ErrorResponse:
+                fmt.Printf("✗ %s: %s\n", v.Code, v.Message)
+        case *HostInitResponse:
+                fmt.Printf("✓ Initialized %s with domain %s\n", v.Host, v.Domain)
+        default:
+                // Fallback to JSON
+                enc := json.NewEncoder(os.Stdout)
+                enc.SetIndent("", "  ")
+                enc.Encode(r)
+        }
+}