files

var FilesCmd = &cobra.Command{
	Use:   "files <REQ-ID>",
	Short: "List implementation files for a requirement",
	Long: `Files lists all implementation files containing tokens for a requirement.

By default, excludes spec and template files, showing only actual implementation.
Files are grouped by aspect and show token counts.

Examples:
  canary files CBIN-133
  canary files CBIN-133 --all  # Include spec/template files`,
	Args: cobra.ExactArgs(1),
	RunE: func(cmd *cobra.Command, args []string) error {
		prompt, _ := cmd.Flags().GetString("prompt")
		if prompt != "" {
			if _, err := utils.LoadPrompt(prompt); err != nil {
				return err
			}
		}
		reqID := args[0]
		includeAll, _ := cmd.Flags().GetBool("all")
		dbPath, _ := cmd.Flags().GetString("db")
		jsonOutput, _ := cmd.Flags().GetBool("json")

		projectID := utils.ReadProjectID(cmd)

		db, err := utils.OpenIndexRO(cmd, dbPath)
		if err != nil {
			return err
		}
		defer db.Close()

		excludeSpecs := !includeAll
		fileGroups, err := db.GetFilesByReqID(projectID, reqID, excludeSpecs)
		if err != nil {
			return utils.GuardContract(cmd, err)
		}

		if len(fileGroups) == 0 {
			fmt.Printf("No implementation files found for %s\n", reqID)
			if !includeAll {
				fmt.Println("\nTip: Use --all to include spec/template files")
			}
			return fmt.Errorf("no files found")
		}

		if jsonOutput {
			enc := json.NewEncoder(os.Stdout)
			return enc.Encode(buildFilesJSON(reqID, fileGroups))
		}

		fmt.Printf("Implementation files for %s:\n\n", reqID)
		fmt.Print(canary.FormatFilesList(fileGroups))

		return nil
	},
}