initialize

func BackupFile ¶

func BackupFile(path string) error

BackupFile creates a backup of an existing file with a timestamp suffix. The backup file name format is: original_name.backup.YYYYMMDD_HHMMSS.NNNNNNNNN If the file doesn't exist, no backup is created and no error is returned.

Returns an error if the backup operation fails.

func EnsureDir ¶

func EnsureDir(path string) error

EnsureDir creates a directory and all parent directories if they don't exist. It is idempotent - no error is returned if the directory already exists. Directories are created with dirPerms permissions (rwxr-xr-x).

Returns an error if directory creation fails.

func ExpandPath ¶

func ExpandPath(path string) (string, error)

ExpandPath expands a path that may contain ~ for home directory or relative paths. It handles: - Home directory expansion (~/) - Relative paths (converts to absolute) - Absolute paths (returns as-is)

Returns an absolute path or an error if expansion fails.

func FileExists ¶

func FileExists(path string) bool

FileExists checks if a file or directory exists at the given path. Returns false if the path doesn't exist or if there's an error checking.

func FormatNextStepsMessage ¶

func FormatNextStepsMessage() string

FormatNextStepsMessage returns a formatted next steps message for display after initialization

func IsSpectrInitialized ¶

func IsSpectrInitialized(
	projectPath string,
) bool

IsSpectrInitialized checks if Spectr is already initialized in the project. It looks for the "spectr/project.md" file in the project directory.

Returns true if the project is already initialized, false otherwise.

func UpdateFileWithMarkers ¶

func UpdateFileWithMarkers(
	filePath, content, startMarker, endMarker string,
) error

UpdateFileWithMarkers updates a file with content between markers. If the file doesn't exist, creates it with markers. If the file exists, updates content between markers.

Marker behavior:

• Both markers found: Updates content between them
• No markers found: Prepends content with markers
• Only one marker found: Returns error (invalid state)

The markers must be on their own line (only whitespace around them).

Example usage:

err := UpdateFileWithMarkers(
    "CLAUDE.md",
    "# Instructions\nFollow these rules...",
    SpectrStartMarker,
    SpectrEndMarker,
)

func WriteFile ¶

func WriteFile(
	path string,
	content []byte,
) error

WriteFile writes content to a file with filePerms permissions (rw-r--r--). It creates parent directories if needed. Returns an error if the file already exists to prevent accidental overwrites.

Use BackupFile before calling WriteFile if you want to preserve existing files.