@wipcomputer/wip-license-guard 1.9.13 → 1.9.15

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 } from './core.mjs';
+import { generateLicense, 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');
 
@@ -320,6 +321,136 @@ async function check(repoPath) {
   return issues;
 }
 
+async function readmeLicense(targetPath) {
+  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 = [];
+  const configPath = join(targetPath, '.license-guard.json');
+  if (existsSync(configPath)) {
+    // Single repo
+    repos.push(targetPath);
+  } else {
+    // Directory of repos (or nested categories like ldm-os/components/)
+    const scanDir = (dir) => {
+      try {
+        for (const entry of readdirSync(dir, { withFileTypes: true })) {
+          if (!entry.isDirectory() || entry.name.startsWith('.') || entry.name === 'node_modules' || entry.name === '_trash') continue;
+          const sub = join(dir, entry.name);
+          if (existsSync(join(sub, '.license-guard.json'))) {
+            repos.push(sub);
+          } else if (existsSync(join(sub, 'package.json')) || existsSync(join(sub, 'README.md'))) {
+            repos.push(sub);
+          } else {
+            scanDir(sub); // recurse into category folders
+          }
+        }
+      } catch {}
+    };
+    scanDir(targetPath);
+  }
+
+  if (repos.length === 0) {
+    warn('No repos found. Point at a repo or a directory containing repos.');
+    return 1;
+  }
+
+  log(`  Found ${repos.length} repo(s)\n`);
+
+  let totalIssues = 0;
+
+  for (const repoPath of repos) {
+    const repoName = repoPath.split('/').pop();
+    const repoConfig = join(repoPath, '.license-guard.json');
+    const config = existsSync(repoConfig)
+      ? JSON.parse(readFileSync(repoConfig, 'utf8'))
+      : WIP_STANDARD;
+
+    // 1. Check main README
+    const readmePath = join(repoPath, 'README.md');
+    if (existsSync(readmePath)) {
+      const content = readFileSync(readmePath, 'utf8');
+      const expected = generateReadmeBlock(config);
+
+      if (content.includes('### Can I use this?') && content.includes('Dual-license model')) {
+        ok(`${repoName}/README.md ... standard license block`);
+      } 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);
+          writeFileSync(readmePath, updated);
+          ok(`${repoName}/README.md ... updated to standard (--fix)`);
+          totalIssues--;
+        }
+      } 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);
+          writeFileSync(readmePath, updated);
+          ok(`${repoName}/README.md ... added standard block (--fix)`);
+          totalIssues--;
+        }
+      }
+    } else {
+      warn(`${repoName}/README.md ... not found`);
+      totalIssues++;
+    }
+
+    // 2. Check sub-tool READMEs (should NOT have license sections)
+    const toolsDir = join(repoPath, 'tools');
+    if (existsSync(toolsDir)) {
+      try {
+        for (const tool of readdirSync(toolsDir, { withFileTypes: true })) {
+          if (!tool.isDirectory()) continue;
+          const subReadme = join(toolsDir, tool.name, 'README.md');
+          if (!existsSync(subReadme)) continue;
+
+          const subContent = readFileSync(subReadme, 'utf8');
+          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);
+              ok(`${repoName}/tools/${tool.name}/README.md ... license section removed (--fix)`);
+              totalIssues--;
+            }
+          }
+        }
+      } catch {}
+    }
+  }
+
+  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 --dry-run to preview or --fix to apply.\n`);
+  }
+
+  return totalIssues;
+}
+
 // Main
 if (command === 'init') {
   await init(target === 'init' ? '.' : target);
@@ -327,6 +458,10 @@ if (command === 'init') {
   const repoPath = (target === 'check') ? '.' : target;
   const issues = await check(repoPath);
   process.exit(issues > 0 ? 1 : 0);
+} else if (command === 'readme-license') {
+  const repoPath = (target === 'readme-license') ? '.' : target;
+  const issues = await readmeLicense(repoPath);
+  process.exit(issues > 0 ? 1 : 0);
 } else if (command === '--help' || command === '-h' || command === 'help') {
   console.log(`
   wip-license-guard
@@ -336,6 +471,9 @@ if (command === 'init') {
     init --from-standard       Apply WIP Computer defaults (MIT+AGPL, CLA, attribution).
     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.
 
   On first run, if no config exists, check will offer to run init.

package/core.mjs

@@ -131,15 +131,59 @@ AGPLv3. AGPLv3 for personal use is free.${attribution ? '\n\n' + attribution : '
 
   return `## License
 
+Dual-license model designed to keep tools free while preventing commercial resellers.
+
 \`\`\`
 MIT      All CLI tools, MCP servers, skills, and hooks (use anywhere, no restrictions).
 AGPLv3   Commercial redistribution, marketplace listings, or bundling into paid services.
 \`\`\`
 
-Dual-license model designed to keep tools free while preventing commercial resellers.
-
 AGPLv3 for personal use is free. Commercial licenses available.
 
+### Can I use this?
+
+**Yes, freely:**
+- Use any tool locally or on your own servers
+- Modify the code for your own projects
+- Include in your internal CI/CD pipelines
+- Fork it and send us feedback via PRs (we'd love that)
+
+**Need a commercial license:**
+- Bundle into a product you sell
+- List on a marketplace (VS Code, JetBrains, etc.)
+- Offer as part of a hosted/SaaS platform
+- Redistribute commercially
+
 Using these tools to build your own software is fine. Reselling the tools themselves is what requires a commercial license.
+
+By submitting a PR, you agree to the [Contributor License Agreement](CLA.md).
 ${attribution ? '\n' + attribution : ''}`;
 }
+
+/**
+ * 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);
+
+  // Match from "## License" to the next ## heading or end of file
+  const licenseRegex = /## License[\s\S]*?(?=\n## [^#]|\n---\s*$|$)/;
+  if (licenseRegex.test(content)) {
+    return content.replace(licenseRegex, block.trimEnd());
+  }
+
+  // No license section found, append
+  return content.trimEnd() + '\n\n' + block;
+}
+
+/**
+ * Remove ## License section from content (for sub-tool READMEs).
+ * Returns the updated content.
+ */
+export function removeReadmeLicenseSection(content) {
+  // Match from "## License" to the next ## heading or end of file
+  const licenseRegex = /\n## License[\s\S]*?(?=\n## [^#]|$)/;
+  return content.replace(licenseRegex, '').trimEnd() + '\n';
+}

package/package.json

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