feat: add remind batch dismiss, normalize, and range support

ctx remind dismiss now accepts multiple IDs and ranges
(e.g., dismiss 3 5-7). Reuses parse.IDs from the pad package.
New: ctx remind normalize reassigns IDs as 1..N.

Removes dead One() dismiss function and InvalidID error
constructor (parsing now handled by shared parse.IDs).

Spec: specs/pad-stable-ids.md
Signed-off-by: Jose Alekhinne <jose@ctx.ist>

Author: josealekhine

docs/cli/tools.md

@@ -594,15 +594,33 @@ ctx pad show 2 --out ./recovered.yaml
 
 #### `ctx pad rm`
 
-Remove an entry by number.
+Remove one or more entries by stable ID. Supports individual IDs and
+ranges.
 
 ```bash
-ctx pad rm <n>
+ctx pad rm <id> [id...]
 ```
 
 **Arguments**:
 
-* `n`: 1-based entry number
+* `id`: One or more entry IDs (e.g., `3`, `1 4`, `3-5`)
+
+**Examples**:
+
+```bash
+ctx pad rm 2
+ctx pad rm 1 4
+ctx pad rm 3-5
+```
+
+#### `ctx pad normalize`
+
+Reassign entry IDs as a contiguous sequence 1..N, closing any gaps
+left by deletions.
+
+```bash
+ctx pad normalize
+```
 
 #### `ctx pad edit`
 
@@ -806,16 +824,17 @@ ctx remind list
 
 #### `ctx remind dismiss`
 
-Remove a reminder by ID, or remove all reminders with `--all`.
+Remove one or more reminders by ID, or remove all with `--all`.
+Supports individual IDs and ranges.
 
 ```bash
-ctx remind dismiss <id>
+ctx remind dismiss <id> [id...]
 ctx remind dismiss --all
 ```
 
 **Arguments**:
 
-- `id`: Reminder ID (shown in `list` output)
+- `id`: One or more reminder IDs (e.g., `3`, `3 5-7`)
 
 **Flags**:
 
@@ -829,9 +848,19 @@ ctx remind dismiss --all
 
 ```bash
 ctx remind dismiss 3
+ctx remind dismiss 3 5-7
 ctx remind dismiss --all
 ```
 
+#### `ctx remind normalize`
+
+Reassign reminder IDs as a contiguous sequence 1..N, closing any gaps
+left by dismissals.
+
+```bash
+ctx remind normalize
+```
+
 ---
 
 ### `ctx pause`

docs/home/common-workflows.md

@@ -67,8 +67,9 @@ ctx remind "check CI after the deploy" --after 2026-02-25
 # List pending reminders
 ctx remind list
 
-# Dismiss a reminder by ID
+# Dismiss reminders by ID (supports ranges)
 ctx remind dismiss 1
+ctx remind dismiss 3 5-7
 ```
 
 Reminders are relayed verbatim at session start by the `check-reminders` hook

docs/recipes/scratchpad-sync.md

@@ -45,7 +45,7 @@ chmod 600 ~/.ctx/.ctx.key                                 # 3. secure it
 |-------------------------|-------------|--------------------------------------------------------|
 | `ctx init`              | CLI command | Initialize context (*generates the key automatically*) |
 | `ctx pad add`           | CLI command | Add a scratchpad entry                                 |
-| `ctx pad rm`            | CLI command | Remove a scratchpad entry                              |
+| `ctx pad rm`            | CLI command | Remove entries by stable ID (supports ranges)          |
 | `ctx pad edit`          | CLI command | Edit a scratchpad entry                                |
 | `ctx pad resolve`       | CLI command | Show both sides of a merge conflict                    |
 | `ctx pad merge`         | CLI command | Merge entries from other scratchpad files              |

docs/recipes/scratchpad-with-claude.md

@@ -39,7 +39,8 @@ Use the `/ctx-pad` skill to manage entries from inside your AI session.
 | `ctx pad edit`         | CLI command | Replace, append to, or prepend to an entry     |
 | `ctx pad add --file`   | CLI command | Ingest a file as a blob entry                  |
 | `ctx pad show N --out` | CLI command | Extract a blob entry to a file                 |
-| `ctx pad rm`           | CLI command | Remove an entry                                |
+| `ctx pad rm`           | CLI command | Remove entries by stable ID (supports ranges)  |
+| `ctx pad normalize`    | CLI command | Reassign entry IDs as 1..N                     |
 | `ctx pad mv`           | CLI command | Reorder entries                                |
 | `ctx pad --tag`        | CLI command | Filter entries by tag                          |
 | `ctx pad tags`         | CLI command | List all tags with counts                      |
@@ -120,7 +121,8 @@ Agent: [runs ctx pad mv 4 1]
 You: "remove entry 2, it's done"
 
 Agent: [runs ctx pad rm 2]
-       "Removed entry 2. 3 entries remaining."
+       "Removed entry 2. 3 entries remaining.
+        (IDs are stable — remaining entries keep their IDs.)"
 ```
 
 ### Step 7: Store a File as a Blob
@@ -212,8 +214,9 @@ Agent: [runs ctx pad --tag later]
         3. review PR feedback #later #ci"
 ```
 
-Entry numbers stay the same when filtering — `ctx pad rm 3` still
-targets entry 3 regardless of active filters.
+Entry IDs are stable — they don't shift when other entries are deleted,
+so `ctx pad rm 3` always targets the same entry regardless of deletions
+or active filters. Use `ctx pad normalize` to reassign IDs as 1..N.
 
 Exclude a tag with `~`:
 
@@ -262,6 +265,8 @@ Once the skill is active, it translates intent into commands:
 | "show my scratchpad" / "what's on my pad" | `ctx pad`                               |
 | "show me entry 3"                         | `ctx pad show 3`                        |
 | "delete the third one" / "remove entry 3" | `ctx pad rm 3`                          |
+| "remove entries 3 through 5"              | `ctx pad rm 3-5`                        |
+| "renumber my scratchpad"                  | `ctx pad normalize`                     |
 | "change entry 2 to ..."                   | `ctx pad edit 2 "new text"`             |
 | "append ' +important' to entry 3"         | `ctx pad edit 3 --append " +important"` |
 | "prepend 'URGENT:' to entry 1"            | `ctx pad edit 1 --prepend "URGENT: "`   |

docs/recipes/session-reminders.md

@@ -19,7 +19,7 @@ scratchpad entries don't announce themselves.
 ```bash
 ctx remind "refactor the swagger definitions"
 ctx remind list
-ctx remind dismiss 1
+ctx remind dismiss 1       # or batch: ctx remind dismiss 1 3-5
 ```
 
 Reminders surface automatically at session start: VERBATIM, every
@@ -98,6 +98,10 @@ You: "dismiss reminder 1"
 Agent: [runs ctx remind dismiss 1]
        "Dismissed:
          - [1] refactor the swagger definitions"
+
+# Batch dismiss also works:
+# "dismiss reminders 3, 5 through 7"
+# → ctx remind dismiss 3 5-7
 ```
 
 Or clear everything:
@@ -137,6 +141,7 @@ You: /ctx-remind dismiss reminder 3
 | "remind me next week to check staging"      | `ctx remind "check staging" --after 2026-03-02` |
 | "what reminders do I have?"                 | `ctx remind list`                               |
 | "dismiss reminder 3"                        | `ctx remind dismiss 3`                          |
+| "dismiss reminders 3, 5 through 7"         | `ctx remind dismiss 3 5-7`                      |
 | "clear all reminders"                       | `ctx remind dismiss --all`                      |
 
 ## Reminders vs Scratchpad vs Tasks

docs/reference/scratchpad.md

@@ -48,13 +48,14 @@ Because the key is `.gitignore`d and the data is committed, you get:
 | `ctx pad`                         | List all entries (numbered 1-based)                    |
 | `ctx pad show N`                  | Output raw text of entry N (no prefix, pipe-friendly)  |
 | `ctx pad add "text"`              | Append a new entry                                     |
-| `ctx pad rm N`                    | Remove entry at position N                             |
+| `ctx pad rm ID [ID...]`           | Remove entries by stable ID (supports ranges: `3-5`)   |
 | `ctx pad edit N "text"`           | Replace entry N with new text                          |
 | `ctx pad edit N --append "text"`  | Append text to the end of entry N                      |
 | `ctx pad edit N --prepend "text"` | Prepend text to the beginning of entry N               |
 | `ctx pad edit N --tag tagname`    | Add a tag to entry N                                   |
 | `ctx pad add TEXT --file PATH`    | Ingest a file as a blob entry (TEXT is the label)      |
 | `ctx pad show N --out PATH`       | Write decoded blob content to a file                   |
+| `ctx pad normalize`               | Reassign entry IDs as 1..N                             |
 | `ctx pad mv N M`                  | Move entry from position N to position M               |
 | `ctx pad resolve`                 | Show both sides of a merge conflict for resolution     |
 | `ctx pad import FILE`             | Bulk-import lines from a file (or stdin with `-`)      |
@@ -92,7 +93,7 @@ ctx pad edit 1 --append "$(ctx pad show 2)"
 # Reorder
 ctx pad mv 2 1
 
-# Clean up
+# Clean up (IDs are stable — they don't shift when entries are deleted)
 ctx pad rm 2
 ```
 
@@ -141,8 +142,9 @@ ctx pad edit 1 --append "checked" --tag done
 ctx pad edit 1 "check DNS propagation"
 ```
 
-Entry numbers are preserved when filtering — `ctx pad rm 3` targets the
-same entry regardless of active filters. Tags are case-sensitive and support
+Entry IDs are stable — they don't shift when other entries are deleted, so
+`ctx pad rm 3` always targets the same entry. Use `ctx pad normalize` to
+reassign IDs as 1..N if gaps bother you. Tags are case-sensitive and support
 letters, digits, hyphens, and underscores (`#high-priority`, `#v2`, `#my_tag`).
 
 For blob entries, tags are extracted from the label only.

internal/assets/commands/commands.yaml

@@ -874,6 +874,8 @@ remind.dismiss:
   short: Dismiss one or all reminders
 remind.list:
   short: Show all pending reminders
+remind.normalize:
+  short: Reassign reminder IDs as 1..N, closing gaps
 resume:
   long: |-
     Resume context hooks after a pause. Silent no-op if not paused.

internal/assets/commands/text/errors.yaml

@@ -402,8 +402,6 @@ err.journal.source.reindex-file-write:
   short: 'failed to write %s: %w'
 err.journal.source.stats-glob:
   short: 'globbing stats files: %w'
-err.reminder.invalid-id:
-  short: invalid ID %q
 err.reminder.parse-reminders:
   short: 'parse reminders: %w'
 err.reminder.read-reminders:

internal/assets/commands/text/write.yaml

@@ -520,6 +520,8 @@ write.reminder-dismissed:
   short: '  - [%d] %s'
 write.reminder-dismissed-all:
   short: Dismissed %d reminders.
+write.reminder-normalized:
+  short: Normalized %d reminders (IDs reassigned as 1..N).
 write.reminder-item:
   short: '  [%d] %s%s'
 write.reminder-none:

internal/cli/pad/cmd/normalize/doc.go

@@ -4,9 +4,22 @@
 //   \    Copyright 2026-present Context contributors.
 //                 SPDX-License-Identifier: Apache-2.0
 
-// Package normalize provides the pad normalize subcommand.
+// Package normalize implements the "ctx pad normalize"
+// subcommand for compacting stable entry IDs.
 //
-// It reassigns entry IDs as 1..N in current file order,
-// closing all gaps left by deletions. This invalidates
-// previously-seen IDs.
+// Pad entries carry stable IDs that persist across
+// additions and deletions. Over time, gaps accumulate
+// (e.g., 1, 3, 7) as entries are removed. Normalize
+// closes those gaps by reassigning IDs sequentially
+// starting from 1, preserving the current file order.
+//
+// This is a deliberate user action, not automatic: it
+// invalidates any IDs the user may have noted or that
+// appear in prior session transcripts. The command
+// prints a confirmation with the count of entries
+// renumbered.
+//
+// The underlying ID reassignment logic lives in
+// [parse.Normalize]; this package handles the CLI
+// wiring, file I/O, and user output.
 package normalize