@bumpyclock/tasque-linux-x64-gnu 0.6.4 → 0.6.6

package/SKILLS/tasque/SKILL.md

@@ -79,11 +79,15 @@ tsq create --parent <parent-id> --from-file tasks.md
 ```bash
 tsq spec <id> --text "## Plan\n...\n## Acceptance\n..."
 tsq spec <id> --show
+# Choose one edit mode when changing an existing spec:
+tsq spec <id> --update --stdin
+tsq spec <id> --patch --stdin
 tsq planned <id>
 tsq claim <id> --assignee <name> --start
 ```
 
 Use `tsq spec <id> --show` when spec markdown lives in sync worktree.
+Use `--update` for whole-spec replacement. Use `--patch` for small agent edits; patch applies only to the attached spec and fails if context is stale. Prefer `--stdin` or `--file` for patches because unified diffs start with `---`.
 
 ## Parallel Work
 

package/SKILLS/tasque/references/command-reference.md

@@ -14,7 +14,7 @@ Use `--sync-branch <name>` or `--worktree-name <name>` to choose another branch/
 and create the worktree on first use. `tsq sync` pushes the sync branch to `origin`
 and sets upstream automatically when needed. Non-git directories use local `.tasque/` storage.
 
-- `tsq create <title...> [--kind ...] [-p ...] [--parent <id>] [--from-file tasks.md] [--description <text>] [--external-ref <ref>] [--discovered-from <id>] [--planned|--needs-plan] [--ensure] [--id <tsq-xxxxxxxx>] [--body-file <path|->]`
+- `tsq create <title...> [--kind ...] [-p ...] [--parent <id>] [--from-file tasks.md] [--description <text>] [--external-ref <ref>] [--discovered-from <id>] [--planned|--needs-plan] [--ensure] [--id <id>] [--body-file <path|->] [--force]`
 
 `tasks.md` supports nested two-space bullets:
 
@@ -29,8 +29,7 @@ and sets upstream automatically when needed. Non-git directories use local `.tas
 - `tsq find ready [--lane <planning|coding>] [--assignee <name>] [--unassigned] [--kind ...] [--label ...] [--planning <needs_planning|planned>] [--tree [--full]]`
 - `tsq find <blocked|open|in-progress|deferred|done|canceled> [filters...] [--tree [--full]]`
 - `tsq find search <query> [--full]`
-
-Note: for `find ready` and status-based `find` commands, `--full` is only valid with `--tree`. `--tree --full` keeps the full status set instead of applying the default tree status narrowing. `find search --full` remains valid without `--tree`.
+- `tsq find similar "<text>"`
 - `tsq edit <id> [--title ...] [--description ...] [--clear-description] [--priority ...] [--external-ref <ref>] [--clear-external-ref] [--discovered-from <id>] [--clear-discovered-from]`
 - `tsq claim <id> [--assignee <a>] [--start] [--require-spec]`
 - `tsq assign <id> --assignee <a>`
@@ -44,6 +43,14 @@ Note: for `find ready` and status-based `find` commands, `--full` is only valid
 - `tsq reopen <id...> [--note <text>]`
 - `tsq cancel <id...> [--note <text>]`
 
+Notes:
+- New root task IDs use `tsq-<number>`; legacy `tsq-<8 crockford base32 chars>` IDs remain valid.
+- `--id <id>` accepts `tsq-<number>` or legacy `tsq-<8 crockford base32 chars>`.
+- Task JSON includes `alias`, generated from the creation title and stable across title edits.
+- Commands that accept a task ID also accept exact aliases and unique alias prefixes unless `--exact-id` is used.
+- `tsq find similar "<text>"` shows ranked duplicate candidates.
+- `tsq create` refuses similar open/in-progress/blocked/deferred tasks unless `--force` is passed.
+
 ## Dependencies and relations
 
 - `tsq block <task> by <blocker>`
@@ -61,6 +68,8 @@ Note: for `find ready` and status-based `find` commands, `--full` is only valid
 ## Specs, notes, labels, history
 
 - `tsq spec <id> [--file <path> | --stdin | --text <markdown> | --show | --check] [--force]`
+- `tsq spec <id> --update [--file <path> | --stdin | --text <markdown>]`
+- `tsq spec <id> --patch [--file <path> | --stdin | --text <patch>]`
 - `tsq note <id> <text>`
 - `tsq note <id> --stdin`
 - `tsq notes <id>`
@@ -69,9 +78,16 @@ Note: for `find ready` and status-based `find` commands, `--full` is only valid
 - `tsq labels`
 - `tsq history <id> [--limit <n>] [--type <event-type>] [--actor <name>] [--since <iso>]`
 
+Spec update notes:
+- `--update` requires an existing attached spec and atomically replaces the whole spec.
+- `--patch` requires an existing attached spec, applies one unified diff to the current spec in memory, rejects multi-file patches, and fails when patch context is stale.
+- Prefer `--patch --stdin` or `--patch --file spec.patch`; unified diffs begin with `---`, which can confuse shell/arg parsing when passed via `--text`.
+
 ## Reporting and maintenance
 
-- `tsq watch [--once] [--interval <seconds>] [--status <csv>] [--assignee <name>] [--tree]`
+- `tsq watch [--once] [--interval <seconds>] [--status <csv>] [--assignee <name>] [--tree] [--flat]`
+
+`watch` renders the task tree by default for human output. Use `--tree` to explicitly request tree view or `--flat` for the compact list view. These options are mutually exclusive.
 - `tsq tui [--once] [--interval <seconds>] [--status <csv>] [--assignee <name>] [--board|--epics]`
 - `tsq stale [--days <n>] [--status <status>] [--assignee <name>] [--limit <n>]`
 - `tsq orphans`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bumpyclock/tasque-linux-x64-gnu",
-  "version": "0.6.4",
+  "version": "0.6.6",
   "description": "Tasque binary for Linux x64 (glibc)",
   "license": "MIT",
   "repository": {