@jamesaphoenix/tx-test-utils 0.10.1 → 0.11.0
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.
- package/README.md +13 -27
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -48,7 +48,7 @@ Composable primitives that handle the hard parts. You keep control of the orches
|
|
|
48
48
|
├─────────────────────────────────────────────────────────┤
|
|
49
49
|
│ tx primitives │
|
|
50
50
|
│ │
|
|
51
|
-
│ tx ready tx done tx
|
|
51
|
+
│ tx ready tx done tx memory tx pin │
|
|
52
52
|
│ tx claim tx block tx sync tx trace │
|
|
53
53
|
│ │
|
|
54
54
|
└─────────────────────────────────────────────────────────┘
|
|
@@ -89,15 +89,15 @@ Structured insights that attach to tasks and file paths.
|
|
|
89
89
|
|
|
90
90
|
```bash
|
|
91
91
|
# Store knowledge
|
|
92
|
-
tx
|
|
92
|
+
tx memory add "Use bcrypt for passwords" --tags security
|
|
93
93
|
|
|
94
94
|
# Attach learnings to file paths
|
|
95
|
-
tx learn "src/auth/*.ts" "Services must use Effect-TS patterns"
|
|
95
|
+
tx memory learn "src/auth/*.ts" "Services must use Effect-TS patterns"
|
|
96
96
|
|
|
97
97
|
# Retrieve via search or task context
|
|
98
|
-
tx
|
|
99
|
-
tx context tx-abc123 # Get relevant
|
|
100
|
-
tx recall "src/auth/hash.ts" # Recall learnings for a file
|
|
98
|
+
tx memory search "authentication"
|
|
99
|
+
tx memory context tx-abc123 # Get relevant memory for a task
|
|
100
|
+
tx memory recall "src/auth/hash.ts" # Recall learnings for a file
|
|
101
101
|
```
|
|
102
102
|
|
|
103
103
|
Hybrid search (BM25 + vector with RRF fusion) finds relevant knowledge.
|
|
@@ -130,16 +130,6 @@ tx claim renew tx-abc123 worker-1 # Extend lease
|
|
|
130
130
|
tx claim release tx-abc123 worker-1 # Release early
|
|
131
131
|
```
|
|
132
132
|
|
|
133
|
-
### Attempts
|
|
134
|
-
|
|
135
|
-
Track what approaches have been tried on a task.
|
|
136
|
-
|
|
137
|
-
```bash
|
|
138
|
-
tx try tx-abc123 "Used Redux" --failed "Too complex for this use case"
|
|
139
|
-
tx try tx-abc123 "Used Zustand" --succeeded
|
|
140
|
-
tx attempts tx-abc123 # See all attempts
|
|
141
|
-
```
|
|
142
|
-
|
|
143
133
|
### Docs
|
|
144
134
|
|
|
145
135
|
Structured documentation as primitives. YAML-based with versioning, locking, and linking.
|
|
@@ -323,22 +313,18 @@ tx memory backlinks <id> # Incoming links
|
|
|
323
313
|
tx memory list # List documents (--source, --tags)
|
|
324
314
|
tx memory link <src> <tgt> # Create explicit edge
|
|
325
315
|
|
|
326
|
-
#
|
|
327
|
-
tx
|
|
328
|
-
tx
|
|
329
|
-
tx
|
|
330
|
-
tx
|
|
331
|
-
tx
|
|
332
|
-
tx
|
|
333
|
-
tx learn <path> <note> # Attach to file
|
|
334
|
-
tx recall [path] # Query by file
|
|
316
|
+
# Memory
|
|
317
|
+
tx memory add <title> # Create .md knowledge file
|
|
318
|
+
tx memory search <query> # BM25 search (--semantic, --expand)
|
|
319
|
+
tx memory context <id> # Task-relevant memory retrieval
|
|
320
|
+
tx memory learn <p> <note> # Attach learning to file path/glob
|
|
321
|
+
tx memory recall [path] # Query file-specific learnings
|
|
322
|
+
tx memory index # Index all sources
|
|
335
323
|
|
|
336
324
|
# Coordination
|
|
337
325
|
tx claim <id> <worker> # Lease-based claim
|
|
338
326
|
tx claim renew <id> <worker> # Extend lease
|
|
339
327
|
tx claim release <id> <worker> # Release early
|
|
340
|
-
tx try <id> <approach> # Record attempt
|
|
341
|
-
tx attempts <id> # List attempts
|
|
342
328
|
|
|
343
329
|
# Docs
|
|
344
330
|
tx doc add <type> <slug> # Create doc
|