driftseal 1.3.2 → 2.0.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 +223 -322
- package/README.zh-CN.md +199 -287
- package/bin/driftseal-mcp.js +156 -62
- package/bin/driftseal.js +1971 -352
- package/index.js +3 -0
- package/package.json +4 -3
- package/skills/use-driftseal/SKILL.md +19 -13
package/index.js
ADDED
package/package.json
CHANGED
|
@@ -1,14 +1,14 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "driftseal",
|
|
3
|
-
"version": "
|
|
4
|
-
"description": "Seal
|
|
3
|
+
"version": "2.0.0",
|
|
4
|
+
"description": "Seal outcomes, verification, and decisions into an auditable workflow for agentic coding",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"driftseal",
|
|
7
7
|
"agents",
|
|
8
8
|
"agentic-coding",
|
|
9
9
|
"agent-safety",
|
|
10
10
|
"developer-tools",
|
|
11
|
-
"
|
|
11
|
+
"outcome-log",
|
|
12
12
|
"decision-log",
|
|
13
13
|
"madr"
|
|
14
14
|
],
|
|
@@ -32,6 +32,7 @@
|
|
|
32
32
|
"test": "test"
|
|
33
33
|
},
|
|
34
34
|
"files": [
|
|
35
|
+
"index.js",
|
|
35
36
|
"bin",
|
|
36
37
|
"skills",
|
|
37
38
|
"README.md",
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: use-driftseal
|
|
3
|
-
description: Follow DriftSeal-managed repository work when AGENTS.md requires `driftseal`, the user invokes DriftSeal, or an interrupted
|
|
3
|
+
description: Follow DriftSeal-managed repository work when AGENTS.md requires `driftseal`, the user invokes DriftSeal, or an interrupted outcome must be resumed. Use this skill to locate the authoritative repository policy, re-anchor state after context loss, and choose the execution surface; prefer the `driftseal` CLI, using MCP only when the repository or user explicitly selects it.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# Use DriftSeal
|
|
@@ -23,15 +23,16 @@ the policy.
|
|
|
23
23
|
|
|
24
24
|
## Re-anchor When Needed
|
|
25
25
|
|
|
26
|
-
After context loss or when
|
|
26
|
+
After context loss or when outcome state is uncertain, run:
|
|
27
27
|
|
|
28
28
|
```sh
|
|
29
29
|
driftseal status
|
|
30
30
|
driftseal log --last 3
|
|
31
31
|
```
|
|
32
32
|
|
|
33
|
-
Then resume, replace, verify, or close the
|
|
34
|
-
requires.
|
|
33
|
+
Then resume, extend, replace, verify, or close the outcome exactly as
|
|
34
|
+
`AGENTS.md` requires. Use `extend` only when the additional work still delivers
|
|
35
|
+
the same coherent outcome. For command syntax, run:
|
|
35
36
|
|
|
36
37
|
```sh
|
|
37
38
|
driftseal help
|
|
@@ -39,17 +40,22 @@ driftseal help
|
|
|
39
40
|
|
|
40
41
|
## After a merge
|
|
41
42
|
|
|
42
|
-
If `status` or `log` fails with a duplicate id or with `multiple
|
|
43
|
-
progress`, or the
|
|
44
|
-
instead of editing `.
|
|
45
|
-
open
|
|
46
|
-
open
|
|
43
|
+
If `status` or `log` fails with a duplicate id or with `multiple outcomes in
|
|
44
|
+
progress`, or the outcome log has conflict markers, run `driftseal absorb`
|
|
45
|
+
instead of editing `.seal/outcomes/events.jsonl`. When both sides still have an
|
|
46
|
+
open outcome, add `--abandon-theirs` or `--abandon-ours`; this works whether your
|
|
47
|
+
open outcome sits in the log or is parked in Git metadata. `driftseal init` also
|
|
47
48
|
configures the local git merge driver; clones need `init` again for that driver.
|
|
48
49
|
|
|
49
|
-
In a Git worktree, `begin` does not dirty the tracked
|
|
50
|
-
can run with an
|
|
51
|
-
`.
|
|
52
|
-
and `end` can be run again.
|
|
50
|
+
In a Git worktree, `begin` does not dirty the tracked outcome log, so `git merge`
|
|
51
|
+
can run with an outcome still in progress. `end` writes the closed record to
|
|
52
|
+
`.seal/outcomes/events.jsonl`; if it is interrupted, the outcome stays open
|
|
53
|
+
there and `end` can be run again.
|
|
54
|
+
|
|
55
|
+
For a v1 repository, do not reinterpret or delete the old logs directly. Use
|
|
56
|
+
`driftseal migrate v1-to-v2 inspect`, prepare a reviewed grouping plan, apply
|
|
57
|
+
it, and run `check`. Migration stages `.seal/` beside v1 and never removes the
|
|
58
|
+
old paths; their removal requires explicit user approval.
|
|
53
59
|
|
|
54
60
|
Do not treat this skill, MCP descriptions, or lifecycle-hook reminders as
|
|
55
61
|
additional policy. If they conflict with `AGENTS.md`, follow `AGENTS.md`.
|