feat(module): add PlanForce to Module interface with stubs

internal/engine/engine_test.go

@@ -31,6 +31,12 @@ func (s scriptedModule) Plan(ctx context.Context, _ module.State) (module.Plan,
 	}
 	return module.Plan{}, nil
 }
+func (s scriptedModule) PlanForce(ctx context.Context) (module.Plan, error) {
+	if s.plan != nil {
+		return s.plan()
+	}
+	return module.Plan{}, nil
+}
 func (s scriptedModule) Apply(ctx context.Context, _ module.Plan, _ module.Reporter) error {
 	if s.apply != nil {
 		return s.apply()

internal/module/module.go

@@ -49,6 +49,12 @@ type Module interface {
 	Meta() Meta
 	Detect(ctx context.Context) (State, error)
 	Plan(ctx context.Context, current State) (Plan, error)
+	// PlanForce returns a plan that reapplies the module unconditionally,
+	// ignoring current detected state. Used by `archduino install --force`.
+	// Implementations should produce a plan equivalent to a from-scratch
+	// install — reinstall packages without pacman's --needed guard and
+	// rewrite managed config files.
+	PlanForce(ctx context.Context) (Plan, error)
 	Apply(ctx context.Context, plan Plan, r Reporter) error
 	Verify(ctx context.Context) error
 }

internal/module/registry_test.go

@@ -13,6 +13,7 @@ type fakeModule struct {
 func (f fakeModule) Meta() Meta                                  { return Meta{ID: f.id, Name: f.id, Deps: f.deps} }
 func (f fakeModule) Detect(context.Context) (State, error)       { return nil, nil }
 func (f fakeModule) Plan(context.Context, State) (Plan, error)   { return Plan{}, nil }
+func (f fakeModule) PlanForce(context.Context) (Plan, error)     { return Plan{}, nil }
 func (f fakeModule) Apply(context.Context, Plan, Reporter) error { return nil }
 func (f fakeModule) Verify(context.Context) error                { return nil }
 

internal/modules/arduinocli/arduinocli.go

@@ -4,6 +4,7 @@ package arduinocli
 import (
 	"bytes"
 	"context"
+	"errors"
 	"fmt"
 	"os"
 	"path/filepath"
@@ -136,3 +137,7 @@ func (m Module) Verify(ctx context.Context) error {
 	}
 	return nil
 }
+
+func (m Module) PlanForce(ctx context.Context) (module.Plan, error) {
+	return module.Plan{}, errors.New("PlanForce not implemented")
+}

internal/modules/fonts/fonts.go

@@ -3,6 +3,7 @@ package fonts
 
 import (
 	"context"
+	"errors"
 	"fmt"
 	"strings"
 
@@ -80,3 +81,7 @@ func (m Module) Verify(ctx context.Context) error {
 	}
 	return nil
 }
+
+func (m Module) PlanForce(ctx context.Context) (module.Plan, error) {
+	return module.Plan{}, errors.New("PlanForce not implemented")
+}

internal/modules/gittools/gittools.go

@@ -3,6 +3,7 @@ package gittools
 
 import (
 	"context"
+	"errors"
 	"fmt"
 	"strings"
 
@@ -72,3 +73,7 @@ func (m Module) Verify(ctx context.Context) error {
 	}
 	return nil
 }
+
+func (m Module) PlanForce(ctx context.Context) (module.Plan, error) {
+	return module.Plan{}, errors.New("PlanForce not implemented")
+}

internal/modules/hello/hello.go

@@ -4,6 +4,7 @@ package hello
 
 import (
 	"context"
+	"errors"
 	"fmt"
 	"os"
 	"path/filepath"
@@ -96,3 +97,7 @@ func (m Module) Verify(ctx context.Context) error {
 	}
 	return nil
 }
+
+func (m Module) PlanForce(ctx context.Context) (module.Plan, error) {
+	return module.Plan{}, errors.New("PlanForce not implemented")
+}

internal/modules/neovim/neovim.go

@@ -6,6 +6,7 @@ package neovim
 import (
 	"bytes"
 	"context"
+	"errors"
 	"embed"
 	"fmt"
 	"os"
@@ -461,3 +462,7 @@ func (m Module) Verify(ctx context.Context) error {
 	}
 	return nil
 }
+
+func (m Module) PlanForce(ctx context.Context) (module.Plan, error) {
+	return module.Plan{}, errors.New("PlanForce not implemented")
+}

internal/modules/packages/packages.go

@@ -3,6 +3,7 @@ package packages
 
 import (
 	"context"
+	"errors"
 	"fmt"
 	"strings"
 
@@ -72,3 +73,7 @@ func (m Module) Verify(ctx context.Context) error {
 	}
 	return nil
 }
+
+func (m Module) PlanForce(ctx context.Context) (module.Plan, error) {
+	return module.Plan{}, errors.New("PlanForce not implemented")
+}

internal/modules/renode/renode.go

@@ -5,6 +5,7 @@ package renode
 import (
 	"bytes"
 	"context"
+	"errors"
 	"embed"
 	"fmt"
 	"os"
@@ -185,3 +186,7 @@ func (m Module) Verify(ctx context.Context) error {
 	}
 	return nil
 }
+
+func (m Module) PlanForce(ctx context.Context) (module.Plan, error) {
+	return module.Plan{}, errors.New("PlanForce not implemented")
+}

internal/modules/shellconfig/shellconfig.go

@@ -3,6 +3,7 @@ package shellconfig
 
 import (
 	"context"
+	"errors"
 	"fmt"
 	"os"
 	"path/filepath"
@@ -88,3 +89,7 @@ func (m Module) Verify(ctx context.Context) error {
 	}
 	return nil
 }
+
+func (m Module) PlanForce(ctx context.Context) (module.Plan, error) {
+	return module.Plan{}, errors.New("PlanForce not implemented")
+}

internal/modules/starship/starship.go

@@ -3,6 +3,7 @@ package starship
 
 import (
 	"context"
+	"errors"
 	"fmt"
 	"strings"
 
@@ -72,3 +73,7 @@ func (m Module) Verify(ctx context.Context) error {
 	}
 	return nil
 }
+
+func (m Module) PlanForce(ctx context.Context) (module.Plan, error) {
+	return module.Plan{}, errors.New("PlanForce not implemented")
+}

internal/modules/themes/themes.go

@@ -4,6 +4,7 @@ package themes
 import (
 	"bytes"
 	"context"
+	"errors"
 	"fmt"
 	"io/fs"
 	"os"
@@ -113,3 +114,7 @@ func (m Module) Verify(ctx context.Context) error {
 	}
 	return nil
 }
+
+func (m Module) PlanForce(ctx context.Context) (module.Plan, error) {
+	return module.Plan{}, errors.New("PlanForce not implemented")
+}

internal/modules/yazi/yazi.go

@@ -3,6 +3,7 @@ package yazi
 
 import (
 	"context"
+	"errors"
 	"fmt"
 	"strings"
 
@@ -72,3 +73,7 @@ func (m Module) Verify(ctx context.Context) error {
 	}
 	return nil
 }
+
+func (m Module) PlanForce(ctx context.Context) (module.Plan, error) {
+	return module.Plan{}, errors.New("PlanForce not implemented")
+}

internal/modules/zellij/zellij.go

@@ -3,6 +3,7 @@ package zellij
 
 import (
 	"context"
+	"errors"
 	"fmt"
 	"os"
 	"path/filepath"
@@ -108,3 +109,7 @@ func (m Module) Verify(ctx context.Context) error {
 	}
 	return nil
 }
+
+func (m Module) PlanForce(ctx context.Context) (module.Plan, error) {
+	return module.Plan{}, errors.New("PlanForce not implemented")
+}

internal/modules/zsh/zsh.go

@@ -3,6 +3,7 @@ package zsh
 
 import (
 	"context"
+	"errors"
 	"fmt"
 	"os"
 	"path/filepath"
@@ -130,3 +131,7 @@ func (m Module) Verify(ctx context.Context) error {
 	}
 	return nil
 }
+
+func (m Module) PlanForce(ctx context.Context) (module.Plan, error) {
+	return module.Plan{}, errors.New("PlanForce not implemented")
+}

internal/subcommands/doctor/doctor_test.go

@@ -19,6 +19,9 @@ func (c convergedModule) Detect(context.Context) (module.State, error) { return
 func (c convergedModule) Plan(context.Context, module.State) (module.Plan, error) {
 	return module.Plan{}, nil
 }
+func (c convergedModule) PlanForce(context.Context) (module.Plan, error) {
+	return module.Plan{}, nil
+}
 func (c convergedModule) Apply(context.Context, module.Plan, module.Reporter) error { return nil }
 func (c convergedModule) Verify(context.Context) error                              { return nil }
 
@@ -29,6 +32,9 @@ func (p pendingModule) Detect(context.Context) (module.State, error) { return ni
 func (p pendingModule) Plan(context.Context, module.State) (module.Plan, error) {
 	return module.Plan{Actions: []module.Action{{Description: "do a thing"}}}, nil
 }
+func (p pendingModule) PlanForce(context.Context) (module.Plan, error) {
+	return module.Plan{Actions: []module.Action{{Description: "do a thing"}}}, nil
+}
 func (p pendingModule) Apply(context.Context, module.Plan, module.Reporter) error { return nil }
 func (p pendingModule) Verify(context.Context) error                              { return nil }
 
@@ -41,6 +47,9 @@ func (d detectFailModule) Detect(context.Context) (module.State, error) {
 func (d detectFailModule) Plan(context.Context, module.State) (module.Plan, error) {
 	return module.Plan{}, nil
 }
+func (d detectFailModule) PlanForce(context.Context) (module.Plan, error) {
+	return module.Plan{}, nil
+}
 func (d detectFailModule) Apply(context.Context, module.Plan, module.Reporter) error { return nil }
 func (d detectFailModule) Verify(context.Context) error                              { return nil }
 

internal/tui/state_test.go

@@ -18,6 +18,9 @@ func (f fakeModule) Detect(context.Context) (module.State, error) { return nil,
 func (f fakeModule) Plan(context.Context, module.State) (module.Plan, error) {
 	return module.Plan{}, nil
 }
+func (f fakeModule) PlanForce(context.Context) (module.Plan, error) {
+	return module.Plan{}, nil
+}
 func (f fakeModule) Apply(context.Context, module.Plan, module.Reporter) error { return nil }
 func (f fakeModule) Verify(context.Context) error                              { return nil }
 

internal/tui/wizard/wizard_test.go

@@ -119,6 +119,12 @@ func (c countingModule) Plan(context.Context, module.State) (module.Plan, error)
 	}
 	return module.Plan{}, nil
 }
+func (c countingModule) PlanForce(context.Context) (module.Plan, error) {
+	if c.onPlan != nil {
+		c.onPlan()
+	}
+	return module.Plan{}, nil
+}
 func (c countingModule) Apply(context.Context, module.Plan, module.Reporter) error { return nil }
 func (c countingModule) Verify(context.Context) error                              { return nil }