v0.4.1 : Phase 1 complete (17/17) - dashboard TUI (#33), favoris/notes/tags (#39), profils d'environnement (#40), completions dynamiques + man pages (#41), packaging officiel + CI (#42), self-update Gitea, state v3, 212 tests

2026-08-17 10:50:13 -04:00
parent 4f4cd034b2
commit 56732d672b
93 changed files with 9412 additions and 1270 deletions
@@ -429,10 +429,11 @@ pub static HELP_SPECS: &[HelpSpec] = &[
        name: "search",
        category: "Commands",
        usage: "search {flags} <keyword>",
-        about: "Search the catalog by keyword (name, description, category, tags).",
+        about: "Search the catalog by keyword (name, description, category, tags); --tag filters on personal tags.",
        search_terms: &["find", "catalog", "keyword"],
        flags: &[
            HelpFlag { short: "", long: "--category", value: "CATEGORY", desc: "Restrict to this category" },
+            HelpFlag { short: "", long: "--tag", value: "TAG", desc: "Only agents carrying this personal tag" },
        ],
        subcommands: &[],
        parameters: &[
@@ -442,6 +443,7 @@ pub static HELP_SPECS: &[HelpSpec] = &[
        examples: &[
            HelpExample { desc: "Find agents related to rust.", code: "search rust" },
            HelpExample { desc: "Search within one category.", code: "search coding --category coding-agent" },
+            HelpExample { desc: "Find agents tagged python.", code: "search --tag python" },
        ],
    },
    HelpSpec {
@@ -541,7 +543,7 @@ pub static HELP_SPECS: &[HelpSpec] = &[
        name: "start",
        category: "Commands",
        usage: "start {flags} <agent>",
-        about: "Start an agent (foreground by default, or detached with --background).",
+        about: "Start an agent (foreground by default, or detached with --background). --profile applies an environment profile (env + args).",
        search_terms: &["launch", "begin"],
        flags: START_FLAGS,
        subcommands: &[],
@@ -553,6 +555,7 @@ pub static HELP_SPECS: &[HelpSpec] = &[
            HelpExample { desc: "Start an agent in the background.", code: "start claude-code --background" },
            HelpExample { desc: "Start with extra arguments.", code: "start claude-code --args \"--model sonnet\"" },
            HelpExample { desc: "Start every agent of a group.", code: "start group:dev --background" },
+            HelpExample { desc: "Start with an environment profile.", code: "start claude-code --profile prod" },
        ],
    },
    HelpSpec {
@@ -661,9 +664,11 @@ pub static HELP_SPECS: &[HelpSpec] = &[
        name: "completion",
        category: "Commands",
        usage: "completion {flags} <shell>",
-        about: "Generate a shell completion script (bash, zsh, fish, powershell, elvish).",
+        about: "Generate a shell completion script (bash, zsh, fish, powershell, elvish). With --installed, Tab also completes the installed agents, aliases and groups.",
        search_terms: &["autocomplete", "shell"],
-        flags: &[],
+        flags: &[
+            HelpFlag { short: "", long: "--installed", value: "", desc: "Add dynamic completion of installed agents, aliases and groups" },
+        ],
        subcommands: &[],
        parameters: &[
            HelpParam { name: "shell", typ: "oneof<bash, zsh, fish, powershell, elvish>", desc: "Shell to generate completions for" },
@@ -671,14 +676,15 @@ pub static HELP_SPECS: &[HelpSpec] = &[
        io: None,
        examples: &[
            HelpExample { desc: "Generate PowerShell completions.", code: "completion powershell" },
+            HelpExample { desc: "Generate bash completions with the installed agents.", code: "completion bash --installed" },
        ],
    },
    HelpSpec {
        name: "self-update",
        category: "Commands",
        usage: "self-update {flags}",
-        about: "Update agent-manager itself from GitHub Releases.",
-        search_terms: &["upgrade", "release"],
+        about: "Update agent-manager itself from the latest release (GitHub ou Gitea, selon settings.self_update_*).",
+        search_terms: &["upgrade", "release", "gitea"],
        flags: &[
            HelpFlag { short: "", long: "--check", value: "", desc: "Only check whether a newer version exists" },
            HelpFlag { short: "", long: "--to", value: "FILE", desc: "Download the new binary to this path instead of replacing the current one" },
@@ -738,6 +744,163 @@ pub static HELP_SPECS: &[HelpSpec] = &[
            HelpExample { desc: "Restore a backup.", code: "import am-export.json" },
        ],
    },
+    HelpSpec {
+        name: "dashboard",
+        category: "Commands",
+        usage: "dashboard {flags}",
+        about: "Live TUI dashboard: the whole fleet in one screen — overview, activity, stats, sessions and projects, refreshed every second.",
+        search_terms: &["tui", "monitor", "overview", "cockpit"],
+        flags: &[],
+        subcommands: &[],
+        parameters: &[],
+        io: None,
+        examples: &[
+            HelpExample { desc: "Open the dashboard (Tab or arrows switch tabs, j/k scroll, q quits).", code: "dashboard" },
+        ],
+    },
+    HelpSpec {
+        name: "favorite",
+        category: "Commands",
+        usage: "favorite {flags} <agent>",
+        about: "Mark an agent as a favorite: a star appears in 'am list', 'am status' and 'am info'.",
+        search_terms: &["star", "bookmark", "prefer"],
+        flags: &[],
+        subcommands: &[],
+        parameters: &[
+            HelpParam { name: "agent", typ: "string", desc: "Agent name or alias" },
+        ],
+        io: None,
+        examples: &[
+            HelpExample { desc: "Mark claude-code as a favorite.", code: "favorite claude-code" },
+        ],
+    },
+    HelpSpec {
+        name: "unfavorite",
+        category: "Commands",
+        usage: "unfavorite {flags} <agent>",
+        about: "Remove the favorite star from an agent.",
+        search_terms: &["star", "bookmark"],
+        flags: &[],
+        subcommands: &[],
+        parameters: &[
+            HelpParam { name: "agent", typ: "string", desc: "Agent name or alias" },
+        ],
+        io: None,
+        examples: &[
+            HelpExample { desc: "Remove the star from claude-code.", code: "unfavorite claude-code" },
+        ],
+    },
+    HelpSpec {
+        name: "note",
+        category: "Commands",
+        usage: "note {flags} <agent> [text...]",
+        about: "Attach a free-form note to an agent, shown in 'am info'. Without text, prints the current note.",
+        search_terms: &["comment", "remark", "memo"],
+        flags: &[],
+        subcommands: &[],
+        parameters: &[
+            HelpParam { name: "agent", typ: "string", desc: "Agent name or alias" },
+            HelpParam { name: "text", typ: "string", desc: "Note text (several words are joined); empty prints the note" },
+        ],
+        io: None,
+        examples: &[
+            HelpExample { desc: "Set a note.", code: "note claude-code use the sonnet model for this repo" },
+            HelpExample { desc: "Show the note.", code: "note claude-code" },
+        ],
+    },
+    HelpSpec {
+        name: "tag",
+        category: "Commands",
+        usage: "tag {flags} <agent> <tag>...",
+        about: "Add personal tags to an agent; they are searchable with 'am search --tag' and listed in 'am info'.",
+        search_terms: &["label", "keyword", "filter"],
+        flags: &[],
+        subcommands: &[],
+        parameters: &[
+            HelpParam { name: "agent", typ: "string", desc: "Agent name or alias" },
+            HelpParam { name: "tag", typ: "string", desc: "One or more tags to add" },
+        ],
+        io: None,
+        examples: &[
+            HelpExample { desc: "Tag claude-code for Python work.", code: "tag claude-code python frontend" },
+            HelpExample { desc: "Find everything tagged python.", code: "search --tag python" },
+        ],
+    },
+    HelpSpec {
+        name: "untag",
+        category: "Commands",
+        usage: "untag {flags} <agent> <tag>",
+        about: "Remove a personal tag from an agent.",
+        search_terms: &["label", "remove"],
+        flags: &[],
+        subcommands: &[],
+        parameters: &[
+            HelpParam { name: "agent", typ: "string", desc: "Agent name or alias" },
+            HelpParam { name: "tag", typ: "string", desc: "Tag to remove" },
+        ],
+        io: None,
+        examples: &[
+            HelpExample { desc: "Remove the python tag from claude-code.", code: "untag claude-code python" },
+        ],
+    },
+    HelpSpec {
+        name: "tags",
+        category: "Commands",
+        usage: "tags {flags} [agent]",
+        about: "List personal tags with the agents carrying them; with an agent, list only its tags.",
+        search_terms: &["labels", "tag list"],
+        flags: &[],
+        subcommands: &[],
+        parameters: &[
+            HelpParam { name: "agent", typ: "string", desc: "Agent name or alias (optional)" },
+        ],
+        io: None,
+        examples: &[
+            HelpExample { desc: "List every personal tag.", code: "tags" },
+            HelpExample { desc: "List the tags of one agent.", code: "tags claude-code" },
+        ],
+    },
+    HelpSpec {
+        name: "profile",
+        category: "Commands",
+        usage: "profile {flags} <list|show> [name]",
+        about: "Environment profiles: a named set of agent, env and args defined in the config, applied with 'am start --profile dev'.",
+        search_terms: &["environment", "context", "dev", "prod"],
+        flags: &[],
+        subcommands: &[
+            ("list", "List every defined profile"),
+            ("show", "Show one profile in detail"),
+        ],
+        parameters: &[
+            HelpParam { name: "name", typ: "string", desc: "Profile to show" },
+        ],
+        io: None,
+        examples: &[
+            HelpExample { desc: "List the profiles.", code: "profile list" },
+            HelpExample { desc: "Show the dev profile.", code: "profile show dev" },
+            HelpExample { desc: "Start an agent with the prod profile.", code: "start claude-code --profile prod" },
+        ],
+    },
+    HelpSpec {
+        name: "man",
+        category: "Commands",
+        usage: "man {flags} [command]",
+        about: "Generate roff man pages from the command definitions: one page for the whole CLI, or one page per command with --output.",
+        search_terms: &["documentation", "roff", "unix"],
+        flags: &[
+            HelpFlag { short: "", long: "--output", value: "DIR", desc: "Write am.1 plus one am-<command>.1 per command into this directory" },
+        ],
+        subcommands: &[],
+        parameters: &[
+            HelpParam { name: "command", typ: "string", desc: "Command to document; omit for the whole CLI" },
+        ],
+        io: None,
+        examples: &[
+            HelpExample { desc: "Print the man page of the whole CLI.", code: "man" },
+            HelpExample { desc: "Print one command page.", code: "man install" },
+            HelpExample { desc: "Write every page into man/ (for a package).", code: "man --output man/" },
+        ],
+    },
    HelpSpec {
        name: "help",
        category: "Commands",