topicop

package

v0.46.1 Latest Latest Go to latest Published: Sep 2, 2026 License: AGPL-3.0 Imports: 13 Imported by: 0

Details

Package topicop coordinates command-level topic selection over static or live current-state authority.

This section is empty.

This section is empty.

func Finish(outcome Outcome, operationErr, releaseErr error) error

Finish retains created paths when presentation cleanup or the caller-held lease release fails after the focused mutation returns.

func Run(ctx context.Context, root string, input Input, load LoadProject, gate Gate) (presentation.Detail, error)

Run validates syntax before state inspection, then selects static or live authority and returns the owner-produced semantic presentation detail.

type Gate func(context.Context, string) error

Gate validates the selected live command universe.

type Input struct {
	Selector             string
	References, Coverage bool
}

Input is the syntax-level topic selection supplied by the command parser.

type LoadProject func(context.Context, string) (*project.Session, error)

LoadProject opens the command-selected project inputs as immutable state.

type Outcome struct {
	Document presentation.Document
	Created  []string
}

Outcome retains the semantic document and every authored path created by one topic scaffold.

func Create(_ context.Context, domain, title string, tx *projectmutation.Transaction) (outcome Outcome, err error)

Create opens the selected project and performs one topic-scaffolding operation under the caller's tracked transaction.

type PartialScaffoldError struct {
	Created, Removed, Remaining []string
	Cause                       error
	Recovery                    []string
}

PartialScaffoldError retains rollback facts when a topic creation cannot remove every path it created. Cause identity remains available to callers.

func (e *PartialScaffoldError) Document() (presentation.Document, error)

func (e *PartialScaffoldError) Error() string

func (e *PartialScaffoldError) JoinCause(err error)

func (e *PartialScaffoldError) Unwrap() error

type UsageError struct{ Message string }

UsageError identifies an operation-level syntax refusal for command exit mapping.

func (e *UsageError) Error() string

Error returns the syntax refusal message.