@wipcomputer/wip-file-guard 1.0.1 → 1.9.7

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 (5) hide show
  1. package/LICENSE +52 -0
  2. package/README.md +10 -2
  3. package/REFERENCE.md +13 -6
  4. package/SKILL.md +19 -12
  5. package/package.json +1 -1
package/LICENSE ADDED
@@ -0,0 +1,52 @@
1
+ Dual License: MIT + AGPLv3
2
+
3
+ Copyright (c) 2026 WIP Computer, Inc.
4
+
5
+
6
+ 1. MIT License (local and personal use)
7
+ ---------------------------------------
8
+
9
+ Permission is hereby granted, free of charge, to any person obtaining a copy
10
+ of this software and associated documentation files (the "Software"), to deal
11
+ in the Software without restriction, including without limitation the rights
12
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
13
+ copies of the Software, and to permit persons to whom the Software is
14
+ furnished to do so, subject to the following conditions:
15
+
16
+ The above copyright notice and this permission notice shall be included in all
17
+ copies or substantial portions of the Software.
18
+
19
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
20
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
21
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
22
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
23
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
24
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
25
+ SOFTWARE.
26
+
27
+
28
+ 2. GNU Affero General Public License v3.0 (commercial and cloud use)
29
+ --------------------------------------------------------------------
30
+
31
+ If you run this software as part of a hosted service, cloud platform,
32
+ marketplace listing, or any network-accessible offering for commercial
33
+ purposes, the AGPLv3 terms apply. You must either:
34
+
35
+ a) Release your complete source code under AGPLv3, or
36
+ b) Obtain a commercial license.
37
+
38
+ This program is free software: you can redistribute it and/or modify
39
+ it under the terms of the GNU Affero General Public License as published
40
+ by the Free Software Foundation, either version 3 of the License, or
41
+ (at your option) any later version.
42
+
43
+ This program is distributed in the hope that it will be useful,
44
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
45
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
46
+ GNU Affero General Public License for more details.
47
+
48
+ You should have received a copy of the GNU Affero General Public License
49
+ along with this program. If not, see <https://www.gnu.org/licenses/>.
50
+
51
+
52
+ AGPLv3 for personal use is free. Commercial licenses available.
package/README.md CHANGED
@@ -1,4 +1,7 @@
1
1
  ###### WIP Computer
2
+
3
+ [![npm](https://img.shields.io/npm/v/@wipcomputer/wip-file-guard)](https://www.npmjs.com/package/@wipcomputer/wip-file-guard) [![CLI / TUI](https://img.shields.io/badge/interface-CLI_/_TUI-black)](https://github.com/wipcomputer/wip-ai-devops-toolbox/blob/main/tools/wip-file-guard/guard.mjs) [![OpenClaw Plugin](https://img.shields.io/badge/interface-OpenClaw_Plugin-black)](https://github.com/wipcomputer/wip-ai-devops-toolbox/blob/main/tools/wip-file-guard/openclaw.plugin.json) [![Claude Code Hook](https://img.shields.io/badge/interface-Claude_Code_Hook-black)](https://github.com/wipcomputer/wip-ai-devops-toolbox/blob/main/tools/wip-file-guard/guard.mjs) [![Claude Code Skill](https://img.shields.io/badge/interface-Claude_Code_Skill-black)](https://github.com/wipcomputer/wip-ai-devops-toolbox/blob/main/tools/wip-file-guard/SKILL.md) [![Universal Interface Spec](https://img.shields.io/badge/Universal_Interface_Spec-black?style=flat&color=black)](https://github.com/wipcomputer/wip-ai-devops-toolbox/blob/main/tools/wip-universal-installer/SPEC.md)
4
+
2
5
  # File Guard
3
6
 
4
7
  PreToolUse hook that blocks destructive edits to protected files. When an AI agent tries to overwrite or strip content from files like CLAUDE.md, SHARED-CONTEXT.md, or SOUL.md... it gets blocked with a clear explanation of what went wrong.
@@ -100,6 +103,11 @@ This happened five times in one session. The fix isn't better prompting. It's a
100
103
 
101
104
  ## License
102
105
 
103
- MIT
106
+ ```
107
+ CLI, OpenClaw plugin, hooks MIT (use anywhere, no restrictions)
108
+ Hosted or cloud service use AGPL (network service distribution)
109
+ ```
110
+
111
+ AGPL for personal use is free.
104
112
 
105
- Built by Parker Todd Brooks, with Claude Code and Lēsa (OpenClaw).
113
+ Built by Parker Todd Brooks, Lēsa (OpenClaw, Claude Opus 4.6), Claude Code (Claude Opus 4.6).
package/REFERENCE.md CHANGED
@@ -3,6 +3,17 @@
3
3
 
4
4
  Manual install instructions, CLI usage, and customization.
5
5
 
6
+ ## Install
7
+
8
+ Install to your LDM OS home:
9
+
10
+ ```bash
11
+ mkdir -p ~/.ldm/extensions/wip-file-guard
12
+ cp guard.mjs openclaw.plugin.json package.json ~/.ldm/extensions/wip-file-guard/
13
+ ```
14
+
15
+ All config paths should point to the installed location (`~/.ldm/extensions/`), not the source repo.
16
+
6
17
  ## Claude Code
7
18
 
8
19
  Add to `~/.claude/settings.json`:
@@ -16,7 +27,7 @@ Add to `~/.claude/settings.json`:
16
27
  "hooks": [
17
28
  {
18
29
  "type": "command",
19
- "command": "node \"/path/to/wip-file-guard/guard.mjs\"",
30
+ "command": "node ~/.ldm/extensions/wip-file-guard/guard.mjs",
20
31
  "timeout": 5
21
32
  }
22
33
  ]
@@ -26,14 +37,10 @@ Add to `~/.claude/settings.json`:
26
37
  }
27
38
  ```
28
39
 
29
- Replace `/path/to/wip-file-guard/` with where you cloned the repo.
30
-
31
40
  ## OpenClaw
32
41
 
33
- Add to your OpenClaw installation's `extensions/` directory:
34
-
35
42
  ```bash
36
- cp -r wip-file-guard ~/.openclaw/extensions/wip-file-guard
43
+ cp -r ~/.ldm/extensions/wip-file-guard ~/.openclaw/extensions/wip-file-guard
37
44
  ```
38
45
 
39
46
  The `openclaw.plugin.json` registers a `before_tool_use` lifecycle hook that applies the same rules.
package/SKILL.md CHANGED
@@ -1,24 +1,31 @@
1
1
  ---
2
- name: WIP.file-guard
3
- version: 1.0.1
2
+ name: wip-file-guard
4
3
  description: Hook that blocks destructive edits to protected identity files. For Claude Code CLI and OpenClaw.
5
- homepage: https://github.com/wipcomputer/wip-file-guard
4
+ license: MIT
5
+ interface: [cli, module, hook, plugin, skill]
6
6
  metadata:
7
+ display-name: "Identity File Protection"
8
+ version: "1.0.1"
9
+ homepage: "https://github.com/wipcomputer/wip-file-guard"
10
+ author: "Parker Todd Brooks"
7
11
  category: dev-tools
8
12
  capabilities:
9
13
  - file-protection
10
14
  - edit-blocking
11
15
  - identity-guard
12
- dependencies: []
13
- interface: Claude Code Hook
14
16
  requires:
15
- binaries: [node]
16
- openclaw:
17
- emoji: "🛡️"
18
- install:
19
- env: []
20
- author:
21
- name: Parker Todd Brooks
17
+ bins: [node]
18
+ openclaw:
19
+ requires:
20
+ bins: [node]
21
+ install:
22
+ - id: node
23
+ kind: node
24
+ package: "@wipcomputer/wip-file-guard"
25
+ bins: [wip-file-guard]
26
+ label: "Install via npm"
27
+ emoji: "🛡️"
28
+ compatibility: Requires node. Node.js 18+.
22
29
  ---
23
30
 
24
31
  # wip-file-guard
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@wipcomputer/wip-file-guard",
3
- "version": "1.0.1",
3
+ "version": "1.9.7",
4
4
  "type": "module",
5
5
  "description": "Hook that blocks destructive edits to protected identity files. For Claude Code CLI and OpenClaw.",
6
6
  "main": "guard.mjs",