driftseal 0.1.0 → 0.2.0

package/README.md

@@ -66,7 +66,7 @@ driftseal end \
 
 If the scope changes, close the current intent as `partial` or `abandoned`, then start a new one. After context loss, use `driftseal status` and `driftseal log --last 3` to re-anchor.
 
-If the user has authorized a Git commit, staging and committing only the verified changes and the just-closed intent log finalizes that round; it does not need a commit-only intent. Any content change made while preparing the commit starts a new round.
+Single-step commands that only build, check, or record work already done — compiling, running tests, `git add`/`git commit` — need no intent of their own. When a commit is authorized, staging and committing only the verified changes and the just-closed intent log finalizes that round. Any content change made while preparing the commit starts a new round.
 
 ## Commands
 

package/README.zh-CN.md

@@ -66,7 +66,7 @@ driftseal end \
 
 如果范围发生变化，先把当前 intent 以 `partial` 或 `abandoned` 关闭，再开启新的 intent。发生 context loss 后，用 `driftseal status` 和 `driftseal log --last 3` 重新锚定当前目标。
 
-如果用户已经授权创建 Git commit，只把已验证的改动和刚关闭的 intent log 进行 stage 和 commit，就属于这一轮的持久化收尾，不需要额外开启一个只用于 commit 的 intent。准备 commit 时一旦需要修改内容，就必须开启新一轮。
+只负责构建、检查或记录已完成工作的单步命令（编译、跑测试、`git add`/`git commit`）不需要单独开启 intent。如果用户已经授权创建 Git commit，只把已验证的改动和刚关闭的 intent log 进行 stage 和 commit，就属于这一轮的持久化收尾。准备 commit 时一旦需要修改内容，就必须开启新一轮。
 
 ## 命令速览
 

package/bin/driftseal.js

@@ -7,7 +7,7 @@
  * Intent-level write-ahead log and MADR decision log for agentic coding sessions.
  *
  * Protocol per work round:
- *   1. driftseal begin "<intent>" [--verify "<how to verify>"]   (before touching anything)
+ *   1. driftseal begin "<intent>" [--verify "<how to verify>"]   (before changes that may need a rollback)
  *   2. execute the intent
  *   3. driftseal end [--status ...] [--note ...] [--verify-result ...]  (reconcile against intent)
  *
@@ -35,7 +35,7 @@ const DECISION_STATUSES = [
   'superseded',
 ];
 const EVENT_SCHEMA_VERSION = 2;
-const PROTOCOL_VERSION = 4;
+const PROTOCOL_VERSION = 5;
 const LOCK_STALE_MS = 30 * 60 * 1000;
 const LOCK_INIT_STALE_MS = 5 * 1000;
 const MAX_DECISION_SLUG_LENGTH = 180;
@@ -1018,9 +1018,12 @@ function intentProtocolBlock(version = PROTOCOL_VERSION) {
 
 This repo uses DriftSeal (\`driftseal\`) to prevent agent drift. Every work round:
 
-1. **Write intent first**, before modifying a file or running a mutating command:
+1. **Write intent first**, before modifying, creating, or deleting files, or
+   making any other change that may need a rollback:
    \`driftseal begin "<what this round will accomplish>" --verify "<command or check that proves it>"\`.
    Add one \`--decision <id>\` for each existing decision this round may change.
+   Single-step commands that only build, check, or record work already done
+   (compiling, running tests, \`git add\`/\`git commit\`) need no intent.
 2. **Execute only the intent.** Scope change? Close the current intent
    (\`driftseal end -s partial|abandoned -n "<why>"\`) and \`driftseal begin\` a new one.
 3. **Verify, then close**: run the declared verification, then
@@ -1044,7 +1047,19 @@ ${INTENT_PROTOCOL_END}`;
 }
 
 function previousIntentProtocolBlock(version) {
-  return intentProtocolBlock(version).replace(
+  const v4 = intentProtocolBlock(version).replace(
+    '1. **Write intent first**, before modifying, creating, or deleting files, or\n' +
+      '   making any other change that may need a rollback:\n' +
+      '   `driftseal begin "<what this round will accomplish>" --verify "<command or check that proves it>"`.\n' +
+      '   Add one `--decision <id>` for each existing decision this round may change.\n' +
+      '   Single-step commands that only build, check, or record work already done\n' +
+      '   (compiling, running tests, `git add`/`git commit`) need no intent.',
+    '1. **Write intent first**, before modifying a file or running a mutating command:\n' +
+      '   `driftseal begin "<what this round will accomplish>" --verify "<command or check that proves it>"`.\n' +
+      '   Add one `--decision <id>` for each existing decision this round may change.'
+  );
+  if (version >= 4) return v4;
+  return v4.replace(
     '   by the next linked `decision update` or successful `end`. Closing as\n' +
       '   `failed` or `abandoned` cancels pending recovery for that intent.',
     '   by the next `decision update` or `end`.'
@@ -1489,6 +1504,7 @@ const commands = {
       knownManagedBlocks: [
         protocolEol(previousIntentProtocolBlock(2), eol),
         protocolEol(previousIntentProtocolBlock(3), eol),
+        protocolEol(previousIntentProtocolBlock(4), eol),
       ],
       knownLegacyBlocks: [protocolEol(legacyIntentProtocolBlock(), eol)],
     });
@@ -1502,6 +1518,7 @@ const commands = {
       knownManagedBlocks: [
         protocolEol(decisionProtocolBlock(2), eol),
         protocolEol(decisionProtocolBlock(3), eol),
+        protocolEol(decisionProtocolBlock(4), eol),
       ],
       knownLegacyBlocks: [protocolEol(legacyDecisionProtocolBlock(), eol)],
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "driftseal",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Seal intent, verification, and decisions into an auditable workflow for agentic coding",
   "keywords": [
     "driftseal",

package/skills/use-driftseal/SKILL.md

@@ -35,8 +35,8 @@ open intent, stop mutating and coordinate instead of abandoning its work.
 
 ## Begin the Round
 
-Before modifying a file or running any mutating command, declare one objective
-and its proof:
+Before modifying, creating, or deleting files — or making any other change that
+may need a rollback — declare one objective and its proof:
 
 ```sh
 driftseal begin "<small objective for this round>" \
@@ -45,7 +45,9 @@ driftseal begin "<small objective for this round>" \
 
 Make the intent small enough to finish and verify in one round. Prefer an
 outcome-focused check over a vague activity such as "inspect the result."
-Starting the intent is the first permitted mutation.
+Starting the intent is the first permitted mutation. Single-step commands that
+only build, check, or record work already done — compiling, running tests,
+`git add`/`git commit` — need no intent of their own.
 
 When the round may change or confirm an existing decision, declare each one at
 the boundary with `--decision <id>`. Do not add decision links speculatively.