agentskeptic 0.1.1 → 0.1.3

package/dist/enforceCli.js

@@ -10,17 +10,17 @@ function writeCliError(code, message) {
     console.error(cliErrorEnvelope(code, message));
 }
 function usageEnforce() {
-    return `Usage:
-  agentskeptic enforce batch (--expect-lock <path> | --output-lock <path>) <same flags as batch verify>
-  agentskeptic enforce quick (--expect-lock <path> | --output-lock <path>) <same flags as quick>
-
-Exactly one of --expect-lock or --output-lock is required.
-
-Exit codes (batch): same as batch verify for 0–2; 3 operational; 4 lock mismatch (--expect-lock only).
-Exit codes (quick): same as quick for 0–2; 3 operational; 4 lock mismatch (--expect-lock only).
-
-See docs/ci-enforcement.md and docs/agentskeptic.md.
-
+    return `Usage:
+  agentskeptic enforce batch (--expect-lock <path> | --output-lock <path>) <same flags as batch verify>
+  agentskeptic enforce quick (--expect-lock <path> | --output-lock <path>) <same flags as quick>
+
+Exactly one of --expect-lock or --output-lock is required.
+
+Exit codes (batch): same as batch verify for 0–2; 3 operational; 4 lock mismatch (--expect-lock only).
+Exit codes (quick): same as quick for 0–2; 3 operational; 4 lock mismatch (--expect-lock only).
+
+See docs/ci-enforcement.md and docs/agentskeptic.md.
+
   --help, -h  print this message and exit 0`;
 }
 async function runEnforceBatch(restArgs) {

package/dist/planTransition.test.js

@@ -220,16 +220,16 @@ describe("planTransition", () => {
         execFileSync("git", ["-C", dir, "add", "."], { windowsHide: true });
         execFileSync("git", ["-C", dir, "commit", "-m", "chg"], { windowsHide: true });
         const after = execFileSync("git", ["-C", dir, "rev-parse", "HEAD"], { encoding: "utf8", windowsHide: true }).trim();
-        const planBody = `---
-planValidation:
-  schemaVersion: 1
-  rules:
-    - id: must_modify
-      kind: matchingRowsMustHaveRowKinds
-      pattern: "src/x.txt"
-      rowKinds: [modify]
----
-# Plan
+        const planBody = `---
+planValidation:
+  schemaVersion: 1
+  rules:
+    - id: must_modify
+      kind: matchingRowsMustHaveRowKinds
+      pattern: "src/x.txt"
+      rowKinds: [modify]
+---
+# Plan
 `;
         const planPath = path.join(dir, "Plan.md");
         writeFileSync(planPath, planBody, "utf8");
@@ -277,16 +277,16 @@ planValidation:
         execFileSync("git", ["-C", dir, "mv", "old.txt", "new.txt"], { windowsHide: true });
         execFileSync("git", ["-C", dir, "commit", "-m", "mv"], { windowsHide: true });
         const after = execFileSync("git", ["-C", dir, "rev-parse", "HEAD"], { encoding: "utf8", windowsHide: true }).trim();
-        const planBody = `---
-planValidation:
-  schemaVersion: 1
-  rules:
-    - id: renamed
-      kind: requireRenameFromTo
-      fromPattern: "old.txt"
-      toPattern: "new.txt"
-      includeCopy: false
----
+        const planBody = `---
+planValidation:
+  schemaVersion: 1
+  rules:
+    - id: renamed
+      kind: requireRenameFromTo
+      fromPattern: "old.txt"
+      toPattern: "new.txt"
+      includeCopy: false
+---
 `;
         const planPath = path.join(dir, "Plan.md");
         writeFileSync(planPath, planBody, "utf8");
@@ -311,15 +311,15 @@ planValidation:
         execFileSync("git", ["-C", dir, "add", "."], { windowsHide: true });
         execFileSync("git", ["-C", dir, "commit", "-m", "add"], { windowsHide: true });
         const after = execFileSync("git", ["-C", dir, "rev-parse", "HEAD"], { encoding: "utf8", windowsHide: true }).trim();
-        const planBody = `---
-planValidation:
-  schemaVersion: 1
-  rules:
-    - id: y_must_be_modify
-      kind: matchingRowsMustHaveRowKinds
-      pattern: "y.txt"
-      rowKinds: [modify]
----
+        const planBody = `---
+planValidation:
+  schemaVersion: 1
+  rules:
+    - id: y_must_be_modify
+      kind: matchingRowsMustHaveRowKinds
+      pattern: "y.txt"
+      rowKinds: [modify]
+---
 `;
         const planPath = path.join(dir, "Plan.md");
         writeFileSync(planPath, planBody, "utf8");
@@ -345,19 +345,19 @@ planValidation:
         execFileSync("git", ["-C", dir, "add", "."], { windowsHide: true });
         execFileSync("git", ["-C", dir, "commit", "-m", "chg"], { windowsHide: true });
         const after = execFileSync("git", ["-C", dir, "rev-parse", "HEAD"], { encoding: "utf8", windowsHide: true }).trim();
-        const planBody = `---
-name: Cursor plan
-overview: test
----
-## Repository transition validation
-\`\`\`yaml
-schemaVersion: 1
-rules:
-  - id: must_modify
-    kind: matchingRowsMustHaveRowKinds
-    pattern: "src/x.txt"
-    rowKinds: [modify]
-\`\`\`
+        const planBody = `---
+name: Cursor plan
+overview: test
+---
+## Repository transition validation
+\`\`\`yaml
+schemaVersion: 1
+rules:
+  - id: must_modify
+    kind: matchingRowsMustHaveRowKinds
+    pattern: "src/x.txt"
+    rowKinds: [modify]
+\`\`\`
 `;
         const planPath = path.join(dir, "Plan.md");
         writeFileSync(planPath, planBody, "utf8");
@@ -385,24 +385,24 @@ rules:
         execFileSync("git", ["-C", dir, "add", "."], { windowsHide: true });
         execFileSync("git", ["-C", dir, "commit", "-m", "chg"], { windowsHide: true });
         const after = execFileSync("git", ["-C", dir, "rev-parse", "HEAD"], { encoding: "utf8", windowsHide: true }).trim();
-        const planBody = `---
-planValidation:
-  schemaVersion: 1
-  rules:
-    - id: must_modify
-      kind: matchingRowsMustHaveRowKinds
-      pattern: "src/x.txt"
-      rowKinds: [modify]
----
-## Repository transition validation
-## Repository transition validation
-\`\`\`yaml
-schemaVersion: 1
-rules:
-  - id: forbid_all
-    kind: forbidMatchingRows
-    pattern: "**/*"
-\`\`\`
+        const planBody = `---
+planValidation:
+  schemaVersion: 1
+  rules:
+    - id: must_modify
+      kind: matchingRowsMustHaveRowKinds
+      pattern: "src/x.txt"
+      rowKinds: [modify]
+---
+## Repository transition validation
+## Repository transition validation
+\`\`\`yaml
+schemaVersion: 1
+rules:
+  - id: forbid_all
+    kind: forbidMatchingRows
+    pattern: "**/*"
+\`\`\`
 `;
         const planPath = path.join(dir, "Plan.md");
         writeFileSync(planPath, planBody, "utf8");
@@ -429,23 +429,23 @@ rules:
         execFileSync("git", ["-C", dir, "add", "."], { windowsHide: true });
         execFileSync("git", ["-C", dir, "commit", "-m", "chg"], { windowsHide: true });
         const after = execFileSync("git", ["-C", dir, "rev-parse", "HEAD"], { encoding: "utf8", windowsHide: true }).trim();
-        const planBody = `---
-planValidation:
-  schemaVersion: 1
-  rules:
-    - id: must_modify
-      kind: matchingRowsMustHaveRowKinds
-      pattern: "src/x.txt"
-      rowKinds: [modify]
----
-## Repository transition validation
-\`\`\`yaml
-schemaVersion: 1
-rules:
-  - id: forbid_all
-    kind: forbidMatchingRows
-    pattern: "**/*"
-\`\`\`
+        const planBody = `---
+planValidation:
+  schemaVersion: 1
+  rules:
+    - id: must_modify
+      kind: matchingRowsMustHaveRowKinds
+      pattern: "src/x.txt"
+      rowKinds: [modify]
+---
+## Repository transition validation
+\`\`\`yaml
+schemaVersion: 1
+rules:
+  - id: forbid_all
+    kind: forbidMatchingRows
+    pattern: "**/*"
+\`\`\`
 `;
         const planPath = path.join(dir, "Plan.md");
         writeFileSync(planPath, planBody, "utf8");
@@ -471,17 +471,17 @@ rules:
         execFileSync("git", ["-C", dir, "add", "."], { windowsHide: true });
         execFileSync("git", ["-C", dir, "commit", "-m", "chg"], { windowsHide: true });
         const after = execFileSync("git", ["-C", dir, "rev-parse", "HEAD"], { encoding: "utf8", windowsHide: true }).trim();
-        const planBody = `---
-name: Plan
-overview: x
-isProject: false
----
-
-# Work
-
-## Implementation
-
-Change \`src/tracked.ts\`.
+        const planBody = `---
+name: Plan
+overview: x
+isProject: false
+---
+
+# Work
+
+## Implementation
+
+Change \`src/tracked.ts\`.
 `;
         const planPath = path.join(dir, "Plan.md");
         writeFileSync(planPath, planBody, "utf8");
@@ -510,17 +510,17 @@ Change \`src/tracked.ts\`.
         execFileSync("git", ["-C", dir, "add", "."], { windowsHide: true });
         execFileSync("git", ["-C", dir, "commit", "-m", "chg"], { windowsHide: true });
         const after = execFileSync("git", ["-C", dir, "rev-parse", "HEAD"], { encoding: "utf8", windowsHide: true }).trim();
-        const planBody = `---
-name: Plan
-overview: x
-isProject: false
----
-
-# Work
-
-## Implementation
-
-Change \`src/tracked.ts\`.
+        const planBody = `---
+name: Plan
+overview: x
+isProject: false
+---
+
+# Work
+
+## Implementation
+
+Change \`src/tracked.ts\`.
 `;
         const planPath = path.join(dir, "Plan.md");
         writeFileSync(planPath, planBody, "utf8");
@@ -548,17 +548,17 @@ Change \`src/tracked.ts\`.
         execFileSync("git", ["-C", dir, "add", "."], { windowsHide: true });
         execFileSync("git", ["-C", dir, "commit", "-m", "add uncited only"], { windowsHide: true });
         const after = execFileSync("git", ["-C", dir, "rev-parse", "HEAD"], { encoding: "utf8", windowsHide: true }).trim();
-        const planBody = `---
-name: Plan
-overview: x
-isProject: false
----
-
-# Work
-
-## Implementation
-
-Change \`src/tracked.ts\`.
+        const planBody = `---
+name: Plan
+overview: x
+isProject: false
+---
+
+# Work
+
+## Implementation
+
+Change \`src/tracked.ts\`.
 `;
         const planPath = path.join(dir, "Plan.md");
         writeFileSync(planPath, planBody, "utf8");
@@ -577,14 +577,14 @@ Change \`src/tracked.ts\`.
 });
 describe("loadPlanTransitionRules", () => {
     it("Cursor-like front matter without planValidation and no citations yields INSUFFICIENT_SPEC", () => {
-        const md = `---
-name: Example plan
-overview: x
-todos: []
-isProject: false
----
-
-# Body
+        const md = `---
+name: Example plan
+overview: x
+todos: []
+isProject: false
+---
+
+# Body
 `;
         try {
             loadPlanTransitionRules(md);
@@ -596,17 +596,17 @@ isProject: false
         }
     });
     it("derived_citations: zero Repository transition heading and one backtick path yields requireMatchingRow rules", () => {
-        const md = `---
-name: Example plan
-overview: x
-isProject: false
----
-
-# Body
-
-## Implementation
-
-Change \`src/only.ts\`.
+        const md = `---
+name: Example plan
+overview: x
+isProject: false
+---
+
+# Body
+
+## Implementation
+
+Change \`src/only.ts\`.
 `;
         const { rules, source } = loadPlanTransitionRules(md);
         expect(source).toBe("derived_citations");
@@ -620,17 +620,17 @@ Change \`src/only.ts\`.
         ]);
     });
     it("derived_citations: two backtick paths yield two requireMatchingRow rules in path sort order", () => {
-        const md = `---
-name: Example plan
-overview: x
-isProject: false
----
-
-# Body
-
-## Implementation
-
-Touch \`src/a.ts\` and \`src/b.ts\`.
+        const md = `---
+name: Example plan
+overview: x
+isProject: false
+---
+
+# Body
+
+## Implementation
+
+Touch \`src/a.ts\` and \`src/b.ts\`.
 `;
         const { rules, source } = loadPlanTransitionRules(md);
         expect(source).toBe("derived_citations");
@@ -649,13 +649,13 @@ Touch \`src/a.ts\` and \`src/b.ts\`.
         });
     });
     it("duplicate Repository transition validation headings yield AMBIGUOUS_BODY_RULES", () => {
-        const md = `---
-name: x
----
-## Repository transition validation
-x
-## Repository transition validation
-y
+        const md = `---
+name: x
+---
+## Repository transition validation
+x
+## Repository transition validation
+y
 `;
         try {
             loadPlanTransitionRules(md);
@@ -667,13 +667,13 @@ y
         }
     });
     it("first fence not yaml yields INSUFFICIENT_SPEC", () => {
-        const md = `---
-name: x
----
-## Repository transition validation
-\`\`\`json
-{}
-\`\`\`
+        const md = `---
+name: x
+---
+## Repository transition validation
+\`\`\`json
+{}
+\`\`\`
 `;
         try {
             loadPlanTransitionRules(md);
@@ -685,18 +685,18 @@ name: x
         }
     });
     it("two yaml fences in section yield AMBIGUOUS_BODY_RULES", () => {
-        const md = `---
-name: x
----
-## Repository transition validation
-\`\`\`yaml
-schemaVersion: 1
-rules: []
-\`\`\`
-\`\`\`yaml
-schemaVersion: 1
-rules: []
-\`\`\`
+        const md = `---
+name: x
+---
+## Repository transition validation
+\`\`\`yaml
+schemaVersion: 1
+rules: []
+\`\`\`
+\`\`\`yaml
+schemaVersion: 1
+rules: []
+\`\`\`
 `;
         try {
             loadPlanTransitionRules(md);
@@ -708,14 +708,14 @@ rules: []
         }
     });
     it("invalid yaml in body fence yields PLAN_VALIDATION_YAML_INVALID with body prefix", () => {
-        const md = `---
-name: x
----
-## Repository transition validation
-\`\`\`yaml
-schemaVersion: 1
-rules: [oops not closed
-\`\`\`
+        const md = `---
+name: x
+---
+## Repository transition validation
+\`\`\`yaml
+schemaVersion: 1
+rules: [oops not closed
+\`\`\`
 `;
         try {
             loadPlanTransitionRules(md);
@@ -728,18 +728,18 @@ rules: [oops not closed
         }
     });
     it("body yaml valid but schema invalid yields SCHEMA_INVALID with body prefix", () => {
-        const md = `---
-name: x
----
-## Repository transition validation
-\`\`\`yaml
-schemaVersion: 1
-rules:
-  - id: x
-    kind: requireRenameFromTo
-    fromPattern: a
-    toPattern: b
-\`\`\`
+        const md = `---
+name: x
+---
+## Repository transition validation
+\`\`\`yaml
+schemaVersion: 1
+rules:
+  - id: x
+    kind: requireRenameFromTo
+    fromPattern: a
+    toPattern: b
+\`\`\`
 `;
         try {
             loadPlanTransitionRules(md);
@@ -752,18 +752,18 @@ rules:
         }
     });
     it("planValidation in front matter wins over body path citations", () => {
-        const md = `---
-planValidation:
-  schemaVersion: 1
-  rules:
-    - id: fm_rule
-      kind: forbidMatchingRows
-      pattern: "nope.txt"
----
-
-## Implementation
-
-Also \`src/ignored.ts\` in prose.
+        const md = `---
+planValidation:
+  schemaVersion: 1
+  rules:
+    - id: fm_rule
+      kind: forbidMatchingRows
+      pattern: "nope.txt"
+---
+
+## Implementation
+
+Also \`src/ignored.ts\` in prose.
 `;
         const { rules, source } = loadPlanTransitionRules(md);
         expect(source).toBe("front_matter");
@@ -786,14 +786,14 @@ describe("plan-transition CLI", () => {
         execFileSync("git", ["-C", dir, "add", "."], { windowsHide: true });
         execFileSync("git", ["-C", dir, "commit", "-m", "b"], { windowsHide: true });
         const a = execFileSync("git", ["-C", dir, "rev-parse", "HEAD"], { encoding: "utf8", windowsHide: true }).trim();
-        const plan = `---
-planValidation:
-  schemaVersion: 1
-  rules:
-    - id: r1
-      kind: forbidMatchingRows
-      pattern: "nonexistent.zzz"
----
+        const plan = `---
+planValidation:
+  schemaVersion: 1
+  rules:
+    - id: r1
+      kind: forbidMatchingRows
+      pattern: "nonexistent.zzz"
+---
 `;
         const planPath = path.join(dir, "Plan.md");
         writeFileSync(planPath, plan, "utf8");
@@ -815,14 +815,14 @@ planValidation:
         execFileSync("git", ["-C", dir, "add", "."], { windowsHide: true });
         execFileSync("git", ["-C", dir, "commit", "-m", "b"], { windowsHide: true });
         const a = execFileSync("git", ["-C", dir, "rev-parse", "HEAD"], { encoding: "utf8", windowsHide: true }).trim();
-        const plan = `---
-planValidation:
-  schemaVersion: 1
-  rules:
-    - id: noop
-      kind: forbidMatchingRows
-      pattern: "__no_such_path_plan_bundle__.txt"
----
+        const plan = `---
+planValidation:
+  schemaVersion: 1
+  rules:
+    - id: noop
+      kind: forbidMatchingRows
+      pattern: "__no_such_path_plan_bundle__.txt"
+---
 `;
         const planPath = path.join(dir, "Plan.md");
         writeFileSync(planPath, plan, "utf8");
@@ -865,17 +865,17 @@ planValidation:
         execFileSync("git", ["-C", dir, "add", "."], { windowsHide: true });
         execFileSync("git", ["-C", dir, "commit", "-m", "b"], { windowsHide: true });
         const a = execFileSync("git", ["-C", dir, "rev-parse", "HEAD"], { encoding: "utf8", windowsHide: true }).trim();
-        const plan = `---
-name: p
----
-## Repository transition validation
-\`\`\`yaml
-schemaVersion: 1
-rules:
-  - id: noop
-    kind: forbidMatchingRows
-    pattern: "__no_such_path_plan_bundle_body__.txt"
-\`\`\`
+        const plan = `---
+name: p
+---
+## Repository transition validation
+\`\`\`yaml
+schemaVersion: 1
+rules:
+  - id: noop
+    kind: forbidMatchingRows
+    pattern: "__no_such_path_plan_bundle_body__.txt"
+\`\`\`
 `;
         const planPath = path.join(dir, "Plan.md");
         writeFileSync(planPath, plan, "utf8");
@@ -914,16 +914,16 @@ rules:
         execFileSync("git", ["-C", dir, "add", "."], { windowsHide: true });
         execFileSync("git", ["-C", dir, "commit", "-m", "b"], { windowsHide: true });
         const a = execFileSync("git", ["-C", dir, "rev-parse", "HEAD"], { encoding: "utf8", windowsHide: true }).trim();
-        const plan = `---
-name: p
-overview: x
----
-
-# x
-
-## Implementation
-
-Change \`src/t.ts\`.
+        const plan = `---
+name: p
+overview: x
+---
+
+# x
+
+## Implementation
+
+Change \`src/t.ts\`.
 `;
         const planPath = path.join(dir, "Plan.md");
         writeFileSync(planPath, plan, "utf8");