Implement manifest model and local store

internal/app/commands_test.go

@@ -2,14 +2,19 @@ package app
 
 import (
 	"bytes"
+	"context"
 	"os"
 	"path/filepath"
 	"strings"
 	"testing"
+	"time"
+
+	"gitea.maximumdirect.net/eric/narratio/internal/manifest"
 )
 
 func TestExecuteValidCommands(t *testing.T) {
 	pipelinePath, sessionPath := writeValidConfigFiles(t)
+	manifestPath := writeManifestPathForExecute(t)
 
 	cases := []struct {
 		name    string
@@ -18,7 +23,7 @@ func TestExecuteValidCommands(t *testing.T) {
 	}{
 		{name: "run", args: []string{"run", "--config", pipelinePath, "--session", sessionPath}, wantOut: "narratio run: configuration loaded and valid"},
 		{name: "plan", args: []string{"plan", "--config", pipelinePath, "--session", sessionPath}, wantOut: "narratio plan: configuration loaded and valid"},
-		{name: "status", args: []string{"status"}, wantOut: "narratio status: not yet implemented"},
+		{name: "status", args: []string{"status", "--manifest", manifestPath}, wantOut: "session_id: 2026-05-03"},
 		{name: "resume", args: []string{"resume"}, wantOut: "narratio resume: not yet implemented"},
 		{name: "run-stage", args: []string{"run-stage", "polish"}, wantOut: "narratio run-stage: not yet implemented"},
 	}
@@ -42,7 +47,7 @@ func TestExecuteValidCommands(t *testing.T) {
 	}
 }
 
-func TestExecuteMissingConfigFlags(t *testing.T) {
+func TestExecuteMissingRequiredFlags(t *testing.T) {
 	cases := []struct {
 		name string
 		args []string
@@ -50,6 +55,7 @@ func TestExecuteMissingConfigFlags(t *testing.T) {
 	}{
 		{name: "run missing flags", args: []string{"run"}, want: "run: --config and --session are required"},
 		{name: "plan missing flags", args: []string{"plan"}, want: "plan: --config and --session are required"},
+		{name: "status missing flags", args: []string{"status"}, want: "status: --manifest is required"},
 	}
 
 	for _, tc := range cases {
@@ -149,3 +155,18 @@ inputs:
 
 	return pipelinePath, sessionPath
 }
+
+func writeManifestPathForExecute(t *testing.T) string {
+	t.Helper()
+
+	store := &manifest.LocalStore{}
+	m := manifest.New("2026-05-03", time.Date(2026, 5, 3, 10, 0, 0, 0, time.UTC))
+	m.MarkStageSucceeded("prepare", time.Date(2026, 5, 3, 10, 1, 0, 0, time.UTC), nil)
+
+	path := filepath.Join(t.TempDir(), "manifest.json")
+	if err := store.Save(context.Background(), path, m); err != nil {
+		t.Fatalf("save manifest: %v", err)
+	}
+
+	return path
+}

internal/app/status.go

@@ -2,10 +2,66 @@ package app
 
 import (
 	"context"
+	"flag"
+	"fmt"
 	"io"
+	"sort"
+
+	"gitea.maximumdirect.net/eric/narratio/internal/manifest"
 )
 
-// Status is a placeholder for future manifest status inspection behavior.
-func Status(_ context.Context, _ []string, out io.Writer) error {
-	return placeholder(out, "status")
+// Status reads and prints stage statuses from an existing manifest.
+func Status(ctx context.Context, args []string, out io.Writer) error {
+	fs := flag.NewFlagSet("status", flag.ContinueOnError)
+	fs.SetOutput(io.Discard)
+
+	var manifestPath string
+	fs.StringVar(&manifestPath, "manifest", "", "path to manifest.json")
+
+	if err := fs.Parse(args); err != nil {
+		return fmt.Errorf("status: invalid flags: %w", err)
+	}
+	if fs.NArg() != 0 {
+		return fmt.Errorf("status: unexpected positional arguments")
+	}
+	if manifestPath == "" {
+		return fmt.Errorf("status: --manifest is required")
+	}
+
+	store := &manifest.LocalStore{}
+	m, err := store.Load(ctx, manifestPath)
+	if err != nil {
+		return fmt.Errorf("status: %w", err)
+	}
+
+	if _, err := fmt.Fprintf(out, "session_id: %s\n", m.SessionID); err != nil {
+		return err
+	}
+	if _, err := fmt.Fprintf(out, "updated_at: %s\n", m.UpdatedAt.UTC().Format("2006-01-02T15:04:05Z07:00")); err != nil {
+		return err
+	}
+
+	if len(m.Stages) == 0 {
+		_, err := fmt.Fprintln(out, "stages: no stages recorded")
+		return err
+	}
+
+	if _, err := fmt.Fprintln(out, "stages:"); err != nil {
+		return err
+	}
+
+	names := make([]string, 0, len(m.Stages))
+	for name := range m.Stages {
+		names = append(names, name)
+	}
+	sort.Strings(names)
+
+	for _, name := range names {
+		status := m.Stages[name].Status
+		if _, err := fmt.Fprintf(out, "- %s: %s\n", name, status); err != nil {
+			return err
+		}
+	}
+
+	return nil
 }

internal/app/status_test.go

@@ -0,0 +1,73 @@
+package app
+
+import (
+	"bytes"
+	"context"
+	"os"
+	"path/filepath"
+	"strings"
+	"testing"
+	"time"
+
+	"gitea.maximumdirect.net/eric/narratio/internal/manifest"
+)
+
+func TestStatusCommandReadsManifest(t *testing.T) {
+	manifestPath := writeManifestForStatus(t)
+
+	var out bytes.Buffer
+	err := Status(context.Background(), []string{"--manifest", manifestPath}, &out)
+	if err != nil {
+		t.Fatalf("Status() error = %v", err)
+	}
+
+	s := out.String()
+	if !strings.Contains(s, "session_id: 2026-05-03") {
+		t.Fatalf("output = %q, want session_id", s)
+	}
+	if !strings.Contains(s, "- merge: succeeded") {
+		t.Fatalf("output = %q, want stage status", s)
+	}
+}
+
+func TestStatusCommandMissingManifestFlag(t *testing.T) {
+	var out bytes.Buffer
+	err := Status(context.Background(), nil, &out)
+	if err == nil {
+		t.Fatal("expected error, got nil")
+	}
+	if !strings.Contains(err.Error(), "--manifest is required") {
+		t.Fatalf("error = %q, want missing manifest flag", err.Error())
+	}
+}
+
+func TestStatusCommandBadManifest(t *testing.T) {
+	dir := t.TempDir()
+	path := filepath.Join(dir, "manifest.json")
+	if err := os.WriteFile(path, []byte("{not-json"), 0o644); err != nil {
+		t.Fatalf("WriteFile() error = %v", err)
+	}
+
+	var out bytes.Buffer
+	err := Status(context.Background(), []string{"--manifest", path}, &out)
+	if err == nil {
+		t.Fatal("expected error, got nil")
+	}
+	if !strings.Contains(err.Error(), "decode manifest") {
+		t.Fatalf("error = %q, want decode error", err.Error())
+	}
+}
+
+func writeManifestForStatus(t *testing.T) string {
+	t.Helper()
+
+	store := &manifest.LocalStore{}
+	m := manifest.New("2026-05-03", time.Date(2026, 5, 3, 10, 0, 0, 0, time.UTC))
+	m.MarkStageSucceeded("merge", time.Date(2026, 5, 3, 10, 5, 0, 0, time.UTC), nil)
+
+	path := filepath.Join(t.TempDir(), "manifest.json")
+	if err := store.Save(context.Background(), path, m); err != nil {
+		t.Fatalf("Save() error = %v", err)
+	}
+	return path
+}