@wipcomputer/wip-license-guard 1.9.14 → 1.9.17

package/README.md

@@ -0,0 +1,32 @@
+###### WIP Computer
+
+# License Guard
+
+Enforce licensing on every commit. Copyright, dual-license, CLA. Checked automatically.
+
+## What it does
+
+- Ensures your own repos have correct copyright, license type, and LICENSE files
+- Interactive first-run setup
+- Toolbox-aware: checks every sub-tool
+- Auto-fix mode repairs issues
+- `readme-license` scans all your repos and applies a standard license block to every README in one command
+- Removes duplicate license sections from sub-tool READMEs
+
+## Usage
+
+```bash
+node tools/wip-license-guard/cli.mjs /path/to/repo
+node tools/wip-license-guard/cli.mjs /path/to/repo --fix
+```
+
+## Requirements
+
+- node (18+)
+- git
+
+## Interfaces
+
+- **CLI**: Command-line tool
+
+## Part of [AI DevOps Toolbox](https://github.com/wipcomputer/wip-ai-devops-toolbox)

package/SKILL.md

@@ -29,17 +29,37 @@ metadata:
 
 # wip-license-guard
 
-License compliance for your own repos. Scans source files for correct copyright headers, verifies dual-license blocks (MIT + AGPL), and checks LICENSE files.
+License compliance for your own repos. Ensures correct copyright, dual-license blocks, LICENSE files, and README license sections.
 
 ## When to Use This Skill
 
 - Before a release, to verify all files have correct license headers
 - After adding new source files to a repo
 - To enforce the MIT/AGPL dual-license pattern
+- To standardize README license sections across all your repos
 
 ## CLI
 
 ```bash
-wip-license-guard /path/to/repo          # scan and report
-wip-license-guard /path/to/repo --fix    # auto-fix missing headers
+wip-license-guard check [path]                  # audit repo against config
+wip-license-guard check --fix [path]             # auto-fix LICENSE, CLA, copyright issues
+wip-license-guard init [path]                    # interactive setup
+wip-license-guard init --from-standard           # apply WIP Computer defaults (no prompts)
+wip-license-guard readme-license [path]          # audit README license sections
+wip-license-guard readme-license --dry-run       # preview what would change
+wip-license-guard readme-license --fix           # apply standard block to all READMEs
+```
+
+### readme-license
+
+Scans all repos for README license sections. Three modes:
+
+- **No flags**: audit only. Reports non-standard, missing, and sub-tool READMEs that shouldn't have license sections.
+- **--dry-run**: preview. Shows what each README has now and what would change. No files touched.
+- **--fix**: apply. Replaces non-standard sections with the standard dual MIT/AGPLv3 block. Removes license sections from sub-tool READMEs.
+
+Works on a single repo or a directory of repos:
+```bash
+wip-license-guard readme-license /path/to/one-repo
+wip-license-guard readme-license /path/to/directory-of-repos
 ```

package/cli.mjs

@@ -6,13 +6,14 @@
 import { existsSync, readFileSync, writeFileSync, readdirSync } from 'node:fs';
 import { join } from 'node:path';
 import { createInterface } from 'node:readline';
-import { generateLicense, generateReadmeBlock, replaceReadmeLicenseSection, removeReadmeLicenseSection } from './core.mjs';
+import { generateLicense, generateCLA, generateReadmeBlock, replaceReadmeLicenseSection, removeReadmeLicenseSection } from './core.mjs';
 
 const args = process.argv.slice(2);
 const HELP_FLAGS = ['--help', '-h', 'help'];
 const command = HELP_FLAGS.some(f => args.includes(f)) ? 'help' : (args.find(a => !a.startsWith('--')) || 'check');
 const target = args.find((a, i) => i > 0 && !a.startsWith('--')) || '.';
 const FIX = args.includes('--fix');
+const DRY_RUN = args.includes('--dry-run');
 const QUIET = args.includes('--quiet');
 const FROM_STANDARD = args.includes('--from-standard');
 
@@ -38,29 +39,6 @@ const WIP_STANDARD = {
   attribution: 'Built by Parker Todd Brooks, Lēsa (OpenClaw, Claude Opus 4.6), Claude Code (Claude Opus 4.6).',
 };
 
-function generateCLA() {
-  return `###### WIP Computer
-
-# Contributor License Agreement
-
-By submitting a pull request to this repository, you agree to the following:
-
-1. **You grant WIP Computer, Inc. a perpetual, worldwide, non-exclusive, royalty-free, irrevocable license** to use, reproduce, modify, distribute, sublicense, and otherwise exploit your contribution under any license, including commercial licenses.
-
-2. **You retain copyright** to your contribution. This agreement does not transfer ownership. You can use your own code however you want.
-
-3. **You confirm** that your contribution is your original work, or that you have the right to submit it under these terms.
-
-4. **You understand** that your contribution may be used in both open source and commercial versions of this software.
-
-This is standard open source governance. Apache, Google, Meta, and Anthropic all use similar agreements. The goal is simple: keep the tools free for everyone while allowing WIP Computer, Inc. to offer commercial licenses to companies that need them.
-
-Using these tools to build your own software is always free. This agreement only matters if WIP Computer, Inc. needs to relicense the codebase commercially.
-
-If you have questions, open an issue or reach out.
-`;
-}
-
 async function init(repoPath) {
   const configPath = join(repoPath, '.license-guard.json');
 
@@ -74,12 +52,12 @@ async function init(repoPath) {
     ok(`Config saved to .license-guard.json`);
 
     const licensePath = join(repoPath, 'LICENSE');
-    writeFileSync(licensePath, generateLicense(config));
+    writeFileSync(licensePath, generateLicense(config, repoPath));
     ok(`LICENSE file generated (dual MIT+AGPLv3)`);
 
     const claPath = join(repoPath, 'CLA.md');
     if (!existsSync(claPath)) {
-      writeFileSync(claPath, generateCLA());
+      writeFileSync(claPath, generateCLA(repoPath));
       ok(`CLA.md generated`);
     } else {
       ok(`CLA.md already exists`);
@@ -132,14 +110,14 @@ async function init(repoPath) {
   ok(`Config saved to .license-guard.json`);
 
   const licensePath = join(repoPath, 'LICENSE');
-  const licenseText = generateLicense(config);
+  const licenseText = generateLicense(config, repoPath);
   writeFileSync(licensePath, licenseText);
   ok(`LICENSE file generated`);
 
   // Generate CLA.md if it doesn't exist
   const claPath = join(repoPath, 'CLA.md');
   if (!existsSync(claPath)) {
-    writeFileSync(claPath, generateCLA());
+    writeFileSync(claPath, generateCLA(repoPath));
     ok(`CLA.md generated`);
   }
 
@@ -173,7 +151,7 @@ async function check(repoPath) {
     warn('LICENSE file missing');
     issues++;
     if (FIX) {
-      writeFileSync(licensePath, generateLicense(config));
+      writeFileSync(licensePath, generateLicense(config, repoPath));
       ok('LICENSE file created (--fix)');
       issues--;
     }
@@ -184,7 +162,7 @@ async function check(repoPath) {
       warn(`LICENSE copyright does not match "${config.copyright}"`);
       issues++;
       if (FIX) {
-        writeFileSync(licensePath, generateLicense(config));
+        writeFileSync(licensePath, generateLicense(config, repoPath));
         ok('LICENSE file updated (--fix)');
         issues--;
       }
@@ -197,7 +175,7 @@ async function check(repoPath) {
         warn('LICENSE file is MIT-only but config says MIT+AGPL');
         issues++;
         if (FIX) {
-          writeFileSync(licensePath, generateLicense(config));
+          writeFileSync(licensePath, generateLicense(config, repoPath));
           ok('LICENSE file updated to dual-license (--fix)');
           issues--;
         }
@@ -213,7 +191,7 @@ async function check(repoPath) {
     warn('CLA.md missing');
     issues++;
     if (FIX) {
-      writeFileSync(claPath, generateCLA());
+      writeFileSync(claPath, generateCLA(repoPath));
       ok('CLA.md created (--fix)');
       issues--;
     }
@@ -288,7 +266,7 @@ async function check(repoPath) {
           warn(`tools/${entry.name}/LICENSE missing`);
           issues++;
           if (FIX) {
-            writeFileSync(toolLicense, generateLicense(config));
+            writeFileSync(toolLicense, generateLicense(config, repoPath));
             ok(`tools/${entry.name}/LICENSE created (--fix)`);
             issues--;
           }
@@ -298,7 +276,7 @@ async function check(repoPath) {
             warn(`tools/${entry.name}/LICENSE wrong copyright`);
             issues++;
             if (FIX) {
-              writeFileSync(toolLicense, generateLicense(config));
+              writeFileSync(toolLicense, generateLicense(config, repoPath));
               ok(`tools/${entry.name}/LICENSE updated (--fix)`);
               issues--;
             }
@@ -321,7 +299,8 @@ async function check(repoPath) {
 }
 
 async function readmeLicense(targetPath) {
-  log(`\n  wip-license-guard readme-license${FIX ? ' --fix' : ''}\n`);
+  const mode = FIX ? '--fix' : DRY_RUN ? '--dry-run' : '';
+  log(`\n  wip-license-guard readme-license${mode ? ' ' + mode : ''}\n`);
 
   // Detect if targetPath is a single repo or a directory of repos
   const repos = [];
@@ -376,8 +355,16 @@ async function readmeLicense(targetPath) {
       } else if (content.includes('## License')) {
         warn(`${repoName}/README.md ... non-standard license section`);
         totalIssues++;
+        if (DRY_RUN) {
+          // Extract current license section for preview
+          const match = content.match(/## License[\s\S]*?(?=\n## [^#]|$)/);
+          if (match) {
+            log(`    current: ${match[0].split('\n').slice(0, 3).join(' | ').substring(0, 80)}...`);
+          }
+          log(`    would replace with: standard dual MIT/AGPLv3 block`);
+        }
         if (FIX) {
-          const updated = replaceReadmeLicenseSection(content, config);
+          const updated = replaceReadmeLicenseSection(content, config, repoPath);
           writeFileSync(readmePath, updated);
           ok(`${repoName}/README.md ... updated to standard (--fix)`);
           totalIssues--;
@@ -385,8 +372,11 @@ async function readmeLicense(targetPath) {
       } else {
         warn(`${repoName}/README.md ... missing ## License`);
         totalIssues++;
+        if (DRY_RUN) {
+          log(`    would add: standard dual MIT/AGPLv3 block at end of README`);
+        }
         if (FIX) {
-          const updated = replaceReadmeLicenseSection(content, config);
+          const updated = replaceReadmeLicenseSection(content, config, repoPath);
           writeFileSync(readmePath, updated);
           ok(`${repoName}/README.md ... added standard block (--fix)`);
           totalIssues--;
@@ -410,6 +400,9 @@ async function readmeLicense(targetPath) {
           if (subContent.includes('## License')) {
             warn(`${repoName}/tools/${tool.name}/README.md ... has license section (should be removed)`);
             totalIssues++;
+            if (DRY_RUN) {
+              log(`    would remove: ## License section from sub-tool README`);
+            }
             if (FIX) {
               const cleaned = removeReadmeLicenseSection(subContent);
               writeFileSync(subReadme, cleaned);
@@ -425,8 +418,11 @@ async function readmeLicense(targetPath) {
   log('');
   if (totalIssues === 0) {
     log('  All README license sections are correct.\n');
+  } else if (DRY_RUN) {
+    log(`  ${totalIssues} issue(s) found. Dry run complete. No changes made.`);
+    log(`  Run with --fix to apply changes.\n`);
   } else {
-    log(`  ${totalIssues} issue(s) found. Run with --fix to auto-repair.\n`);
+    log(`  ${totalIssues} issue(s) found. Run with --dry-run to preview or --fix to apply.\n`);
   }
 
   return totalIssues;
@@ -453,6 +449,7 @@ if (command === 'init') {
     check [path]               Audit repo against saved config. Exit 1 if issues found.
     check --fix [path]         Auto-fix issues (update LICENSE files, wrong copyright).
     readme-license [path]      Scan README license sections. Works on one repo or a directory of repos.
+    readme-license --dry-run   Preview what would change. Shows current vs standard for each README.
     readme-license --fix       Apply standard license block to all READMEs. Remove from sub-tools.
     help                       Show this help.
 

package/core.mjs

@@ -1,12 +1,81 @@
 // wip-license-guard/core.mjs
 // License generation and validation logic.
+// Reads templates from ai/wip-templates/readme/ when available.
+// Falls back to hardcoded defaults for standalone use.
 
-export function generateLicense(config) {
+import { existsSync, readFileSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+
+// ── Template Resolution ─────────────────────────────────────────────
+
+/**
+ * Find the templates directory. Checks:
+ * 1. WIP_TEMPLATES_DIR env var
+ * 2. Walk up from repoPath looking for ai/wip-templates/readme/
+ * 3. Walk up from this file's location (for toolbox-internal use)
+ * Returns null if not found.
+ */
+function findTemplatesDir(repoPath) {
+  // 1. Env var
+  const envDir = process.env.WIP_TEMPLATES_DIR;
+  if (envDir && existsSync(join(envDir, 'LICENSE.md'))) return envDir;
+
+  // 2. Walk up from repoPath
+  if (repoPath) {
+    let dir = repoPath;
+    for (let i = 0; i < 10; i++) {
+      const candidate = join(dir, 'ai', 'wip-templates', 'readme');
+      if (existsSync(join(candidate, 'LICENSE.md'))) return candidate;
+      const parent = dirname(dir);
+      if (parent === dir) break;
+      dir = parent;
+    }
+  }
+
+  // 3. Walk up from this file (tools/wip-license-guard/ -> repo root)
+  const thisDir = dirname(new URL(import.meta.url).pathname);
+  let dir = thisDir;
+  for (let i = 0; i < 10; i++) {
+    const candidate = join(dir, 'ai', 'wip-templates', 'readme');
+    if (existsSync(join(candidate, 'LICENSE.md'))) return candidate;
+    const parent = dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+
+  return null;
+}
+
+/**
+ * Read a template file. Returns content or null.
+ */
+function readTemplate(templatesDir, filename) {
+  if (!templatesDir) return null;
+  const path = join(templatesDir, filename);
+  if (!existsSync(path)) return null;
+  return readFileSync(path, 'utf8');
+}
+
+/**
+ * Extract the markdown format section from wip-lic-footer.md.
+ * The file has two sections: // PLAIN TXT and // MD FORMAT.
+ * Returns the MD FORMAT section, or the whole file if no marker found.
+ */
+function extractMdFormat(content) {
+  const marker = '// MD FORMAT';
+  const idx = content.indexOf(marker);
+  if (idx === -1) return content;
+  return content.slice(idx + marker.length).trim();
+}
+
+// ── License Generation ──────────────────────────────────────────────
+
+export function generateLicense(config, repoPath) {
   const { copyright, license, year } = config;
 
   if (license === 'MIT') return generateMIT(copyright, year);
   if (license === 'AGPL-3.0') return generateAGPL(copyright, year);
-  if (license === 'MIT+AGPL') return generateDual(copyright, year);
+  if (license === 'MIT+AGPL') return generateDual(copyright, year, repoPath);
 
   return generateMIT(copyright, year);
 }
@@ -56,7 +125,16 @@ along with this program. If not, see <https://www.gnu.org/licenses/>.
 `;
 }
 
-function generateDual(copyright, year) {
+function generateDual(copyright, year, repoPath) {
+  // Try template first
+  const templatesDir = findTemplatesDir(repoPath);
+  const template = readTemplate(templatesDir, 'LICENSE.md');
+  if (template) {
+    // Replace copyright year if template has a different one
+    return template.replace(/Copyright \(c\) \d{4}/, `Copyright (c) ${year}`);
+  }
+
+  // Hardcoded fallback
   return `Dual License: MIT + AGPLv3
 
 Copyright (c) ${year} ${copyright}
@@ -112,7 +190,40 @@ AGPLv3 for personal use is free. Commercial licenses available.
 `;
 }
 
-export function generateReadmeBlock(config) {
+// ── CLA Generation ──────────────────────────────────────────────────
+
+export function generateCLA(repoPath) {
+  // Try template first
+  const templatesDir = findTemplatesDir(repoPath);
+  const template = readTemplate(templatesDir, 'cla.md');
+  if (template) return template;
+
+  // Hardcoded fallback
+  return `###### WIP Computer
+
+# Contributor License Agreement
+
+By submitting a pull request to this repository, you agree to the following:
+
+1. **You grant WIP Computer, Inc. a perpetual, worldwide, non-exclusive, royalty-free, irrevocable license** to use, reproduce, modify, distribute, sublicense, and otherwise exploit your contribution under any license, including commercial licenses.
+
+2. **You retain copyright** to your contribution. This agreement does not transfer ownership. You can use your own code however you want.
+
+3. **You confirm** that your contribution is your original work, or that you have the right to submit it under these terms.
+
+4. **You understand** that your contribution may be used in both open source and commercial versions of this software.
+
+This is standard open source governance. Apache, Google, Meta, and Anthropic all use similar agreements. The goal is simple: keep the tools free for everyone while allowing WIP Computer, Inc. to offer commercial licenses to companies that need them.
+
+Using these tools to build your own software is always free. This agreement only matters if WIP Computer, Inc. needs to relicense the codebase commercially.
+
+If you have questions, open an issue or reach out.
+`;
+}
+
+// ── README License Block ────────────────────────────────────────────
+
+export function generateReadmeBlock(config, repoPath) {
   const { license, attribution } = config;
 
   if (license === 'MIT') {
@@ -129,6 +240,14 @@ AGPLv3. AGPLv3 for personal use is free.${attribution ? '\n\n' + attribution : '
 `;
   }
 
+  // MIT+AGPL: try template first
+  const templatesDir = findTemplatesDir(repoPath);
+  const footer = readTemplate(templatesDir, 'wip-lic-footer.md');
+  if (footer) {
+    return extractMdFormat(footer);
+  }
+
+  // Hardcoded fallback
   return `## License
 
 Dual-license model designed to keep tools free while preventing commercial resellers.
@@ -160,13 +279,15 @@ By submitting a PR, you agree to the [Contributor License Agreement](CLA.md).
 ${attribution ? '\n' + attribution : ''}`;
 }
 
+// ── README License Section Replace/Remove ───────────────────────────
+
 /**
  * Replace ## License section in readme content.
  * If no ## License exists, appends the block at the end.
  * Returns the updated content.
  */
-export function replaceReadmeLicenseSection(content, config) {
-  const block = generateReadmeBlock(config);
+export function replaceReadmeLicenseSection(content, config, repoPath) {
+  const block = generateReadmeBlock(config, repoPath);
 
   // Match from "## License" to the next ## heading or end of file
   const licenseRegex = /## License[\s\S]*?(?=\n## [^#]|\n---\s*$|$)/;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wipcomputer/wip-license-guard",
-  "version": "1.9.14",
+  "version": "1.9.17",
   "description": "License compliance for your own repos. Ensures correct copyright, dual-license blocks, and LICENSE files.",
   "type": "module",
   "bin": {