@kurrent/kcap 0.11.39 → 0.12.0-beta.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
|
@@ -33,6 +33,9 @@ no breakdown.
|
|
|
33
33
|
- The structure changed (a part was dropped, a dependency no longer holds) →
|
|
34
34
|
retract it.
|
|
35
35
|
- You want to see the current structure → read the topology.
|
|
36
|
+
- Two items describe the same work (a title-only item you created and the
|
|
37
|
+
issue/PR-keyed item the server minted) → merge yours into the keyed one.
|
|
38
|
+
- The session was attached to the wrong item → detach it.
|
|
36
39
|
|
|
37
40
|
## The flow
|
|
38
41
|
|
|
@@ -50,6 +53,22 @@ no breakdown.
|
|
|
50
53
|
5. **Verify** with `get_work_item_topology` (pass the parent's `work_item_id`) —
|
|
51
54
|
it returns the parent, parts, and dependencies you can see.
|
|
52
55
|
|
|
56
|
+
## Duplicates and wrong attaches
|
|
57
|
+
|
|
58
|
+
A `new_title` declare made before a PR or issue existed becomes a duplicate once the
|
|
59
|
+
server mints the keyed item for that work. Do not declare a breakdown to connect the
|
|
60
|
+
two — that records structure that isn't there. Merge instead:
|
|
61
|
+
|
|
62
|
+
- `merge_work_item` with `work_item_id` = the title-only item and `into_work_item_id` =
|
|
63
|
+
the keyed item. The keyed item survives; the title item's sessions and links move to
|
|
64
|
+
it. Repeating a landed merge is a no-op.
|
|
65
|
+
- The server refuses (409) when a user marked either item standalone, rejected the
|
|
66
|
+
pairing, or the items belong to different tracker hierarchies. Stop and tell the
|
|
67
|
+
user — they can merge from the dashboard. Do not retry.
|
|
68
|
+
- `detach_work_item` removes this session from an item it was wrongly attached to. The
|
|
69
|
+
removal is durable for automated correlation; an attachment a user pinned cannot be
|
|
70
|
+
removed by an agent.
|
|
71
|
+
|
|
53
72
|
## Rules the server enforces
|
|
54
73
|
|
|
55
74
|
- **Visibility, not repository.** Every item you name must be visible to you.
|
|
@@ -62,6 +81,8 @@ no breakdown.
|
|
|
62
81
|
the server resolves the caller. Don't look for such arguments.
|
|
63
82
|
- **Retract, don't delete.** Use `retract_work_breakdown` / `retract_work_relation`
|
|
64
83
|
when the structure changes.
|
|
84
|
+
- **Merges defer to user facts.** A standalone confirmation or a rejected pairing a
|
|
85
|
+
user recorded blocks an agent merge; only a user can lift it.
|
|
65
86
|
|
|
66
87
|
## Tool reference
|
|
67
88
|
|
|
@@ -74,6 +95,8 @@ no breakdown.
|
|
|
74
95
|
| `declare_work_relation` | `from_id`, `to_id`, `relation_kind` (`blocks`\|`blocked_by`) | Declare a dependency. |
|
|
75
96
|
| `retract_work_relation` | `from_id`, `to_id`, `relation_kind` | Retract a dependency. |
|
|
76
97
|
| `get_work_item_topology` | `work_item_id` | Read parent, parts, and dependencies (visibility-scoped). |
|
|
98
|
+
| `merge_work_item` | `work_item_id`, `into_work_item_id` | Merge a duplicate into the survivor (prefer the keyed item as survivor). |
|
|
99
|
+
| `detach_work_item` | `work_item_id` | Detach the session from a wrongly attached item. `session_id` defaults to `KCAP_SESSION_ID`. |
|
|
77
100
|
|
|
78
101
|
## Requirements
|
|
79
102
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@kurrent/kcap",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.12.0-beta.1",
|
|
4
4
|
"description": "CLI companion for Kurrent Capacitor — records and visualizes Claude Code sessions",
|
|
5
5
|
"license": "SEE LICENSE IN LICENSE.md",
|
|
6
6
|
"repository": {
|
|
@@ -14,17 +14,17 @@
|
|
|
14
14
|
"postinstall": "node bin/postinstall.js"
|
|
15
15
|
},
|
|
16
16
|
"optionalDependencies": {
|
|
17
|
-
"@kurrent/kcap-darwin-arm64": "0.
|
|
18
|
-
"@kurrent/kcap-linux-arm64": "0.
|
|
19
|
-
"@kurrent/kcap-linux-musl-arm64": "0.
|
|
20
|
-
"@kurrent/kcap-linux-musl-x64": "0.
|
|
21
|
-
"@kurrent/kcap-linux-x64": "0.
|
|
22
|
-
"@kurrent/kcap-win-x64": "0.
|
|
17
|
+
"@kurrent/kcap-darwin-arm64": "0.12.0-beta.1",
|
|
18
|
+
"@kurrent/kcap-linux-arm64": "0.12.0-beta.1",
|
|
19
|
+
"@kurrent/kcap-linux-musl-arm64": "0.12.0-beta.1",
|
|
20
|
+
"@kurrent/kcap-linux-musl-x64": "0.12.0-beta.1",
|
|
21
|
+
"@kurrent/kcap-linux-x64": "0.12.0-beta.1",
|
|
22
|
+
"@kurrent/kcap-win-x64": "0.12.0-beta.1"
|
|
23
23
|
},
|
|
24
24
|
"files": [
|
|
25
25
|
"bin/",
|
|
26
26
|
"kcap/"
|
|
27
27
|
],
|
|
28
|
-
"kcapReleaseCommit": "
|
|
29
|
-
"kcapReleaseTag": "v0.
|
|
28
|
+
"kcapReleaseCommit": "4ec4163e8ca662d88f3af1ec9e4acfb46ae60316",
|
|
29
|
+
"kcapReleaseTag": "v0.12.0-beta.1"
|
|
30
30
|
}
|