@manukyalo/scopelock 3.0.0 → 3.0.2

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.
Files changed (3) hide show
  1. package/README.md +28 -17
  2. package/assets/logo.png +0 -0
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -1,6 +1,8 @@
1
- # scopelock v3.0
2
-
3
- **Anti-hallucination scope locking for AI coding agents.**
1
+ <div align="center">
2
+ <img src="assets/logo.png" width="200" alt="scopelock logo" />
3
+ <h1>scopelock v3.0</h1>
4
+ <p><strong>Anti-hallucination scope locking for AI coding agents.</strong></p>
5
+ </div>
4
6
 
5
7
  ```bash
6
8
  npm install -g @manukyalo/scopelock
@@ -24,20 +26,29 @@ npm install -g @manukyalo/scopelock
24
26
 
25
27
  ## Commands
26
28
 
27
- ```bash
28
- scopelock init Scan repo and generate .scopelock.json
29
- scopelock lock <file>[:<func>] [reason] Lock a file or a specific function
30
- scopelock unlock <file>[:<func>] <reason> Unlock (reason is mandatory)
31
- scopelock seal <file> <reason> Permanent production-path lock (no override)
32
- scopelock unseal <file> --human-approved=<ticket> <reason> Release a seal
33
- scopelock impact <file> Show all files that import this file
34
- scopelock trust <file> <reason> Bypass Secret Sentinel for a specific file
35
- scopelock save Auto-snapshot repo state before an agent session
36
- scopelock restore Rollback to the last snapshot
37
- scopelock context [task] Generate AI context block for a task
38
- scopelock guard [--tests] Check git diff for violations and secret leaks
39
- scopelock status Show manifest summary
40
- ```
29
+ ### 🛡️ Guardrails & Locks
30
+ | Command | Description |
31
+ | :--- | :--- |
32
+ | `scopelock lock <file>[:<func>] [reason]` | Lock a file or a specific AST function |
33
+ | `scopelock unlock <file>[:<func>] <reason>` | Unlock (reason is mandatory) |
34
+ | `scopelock seal <file> <reason>` | Permanent production-path lock (cannot be unlocked normally) |
35
+ | `scopelock unseal <file> --human-approved=<ticket> <reason>` | Release a seal with a Jira/PR ticket |
36
+ | `scopelock guard [--tests]` | Wire as `pre-commit` to check diffs for violations & leaked secrets |
37
+ | `scopelock trust <file> <reason>` | Explicitly bypass Secret Sentinel for a mock/test file |
38
+
39
+ ### 🛠️ Agent Tools (Godmode)
40
+ | Command | Description |
41
+ | :--- | :--- |
42
+ | `scopelock impact <file>` | Show the Blast Radius (all files importing this file) before modifying it |
43
+ | `scopelock save` | Auto-snapshot repo state into a hidden git stash before an agent session |
44
+ | `scopelock restore` | Instant escape hatch: obliterate agent changes and restore the snapshot |
45
+ | `scopelock context [task]` | Generate a token-efficient AI context block mapping the locked boundaries |
46
+
47
+ ### ⚙️ Core
48
+ | Command | Description |
49
+ | :--- | :--- |
50
+ | `scopelock init` | Scan repo and generate `.scopelock.json` manifest |
51
+ | `scopelock status` | Show a summary of all locked/sealed files |
41
52
 
42
53
  ### `scopelock lock` & `unlock`
43
54
  Lock a whole file or a specific named function. Unlock requires a reason that gets logged to history.
package/assets/logo.png ADDED
Binary file
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@manukyalo/scopelock",
3
- "version": "3.0.0",
3
+ "version": "3.0.2",
4
4
  "description": "Anti-hallucination scope locking for AI coding agents.",
5
5
  "main": "bin/scopelock.js",
6
6
  "bin": {