/adr

/adr [ACTION] [TITLE or ID]

/adr new "Use PostgreSQL for primary storage"

/adr list

/adr show 0015

/adr supersede 0012 0018

/adr deprecate 0007

/adr status

defmodule PrismaticArchitecture.ADR.Command do
  @moduledoc """
  Architecture Decision Record command handler.
  Creates, manages, and tracks ADRs with full lifecycle support.
  """

  @adr_directory "docs/architecture/decisions/"

  @spec new(String.t()) :: {:ok, String.t()} | {:error, term()}
  def new(title) do
    next_id = get_next_adr_id()
    filename = format_filename(next_id, title)
    content = generate_adr_template(next_id, title)

    case File.write(Path.join(@adr_directory, filename), content) do
      :ok -> {:ok, filename}
      {:error, reason} -> {:error, {:write_failed, reason}}
    end
  end

  @spec list() :: {:ok, [map()]}
  def list do
    adrs =
      @adr_directory
      |> File.ls!()
      |> Enum.filter(&String.ends_with?(&1, ".md"))
      |> Enum.sort()
      |> Enum.map(&parse_adr_summary/1)

    {:ok, adrs}
  end

  @spec supersede(String.t(), String.t()) :: {:ok, map()} | {:error, term()}
  def supersede(old_id, new_id) do
    with {:ok, old_path} <- find_adr_by_id(old_id),
         {:ok, new_path} <- find_adr_by_id(new_id),
         :ok <- update_status(old_path, "Superseded by ADR-#{new_id}"),
         :ok <- add_supersedes_reference(new_path, old_id) do
      {:ok, %{old: old_path, new: new_path, status: :superseded}}
    end
  end
end

# ADR-XXXX: Title

## Status
[Proposed | Accepted | Deprecated | Superseded by ADR-YYYY]

## Context
[What is the issue that we're seeing that motivates this decision?]

## Decision
[What is the change that we're proposing and/or doing?]

## Consequences
### Positive
- [Consequence 1]
- [Consequence 2]

### Negative
- [Consequence 1]
- [Consequence 2]

## Related Decisions
- ADR-XXXX: [Title]

Related Commands