fallow 2.47.0 → 2.48.0

package/README.md

@@ -13,10 +13,20 @@ Static analysis is free and open source. Runtime intelligence is the paid team l
 ## Installation
 
 ```bash
-npm install -g fallow
+npm install --save-dev fallow   # or: pnpm add -D fallow / yarn add -D fallow / bun add -d fallow
 ```
 
-This installs the `fallow` CLI plus the companion `fallow-lsp` and `fallow-mcp` binaries.
+Installs the `fallow` CLI plus the companion `fallow-lsp` and `fallow-mcp` binaries in your project.
+
+The package also ships a version-matched Agent Skill under `skills/fallow`.
+TanStack Intent discovers it from `node_modules` automatically:
+
+```bash
+npx @tanstack/intent list
+npx @tanstack/intent load fallow#fallow
+```
+
+For one-off CLI use without project-local skill discovery, run `npx fallow`.
 
 ## Usage
 

package/bin/fallow

@@ -3,32 +3,21 @@
 const { execFileSync } = require('child_process');
 const { join } = require('path');
 const { existsSync } = require('fs');
+const { getPlatformPackage } = require('../scripts/platform-package');
 
-function getPlatformPackage() {
-  const platform = process.platform;
-  const arch = process.arch;
-
-  if (platform === 'win32' && arch === 'x64') {
-    return '@fallow-cli/win32-x64-msvc';
-  }
-  if (platform === 'darwin') {
-    return `@fallow-cli/darwin-${arch}`;
-  }
-  if (platform === 'linux') {
-    try {
-      const { familySync } = require('detect-libc');
-      const libc = familySync() === 'musl' ? 'musl' : 'gnu';
-      return `@fallow-cli/linux-${arch}-${libc}`;
-    } catch {
-      // musl binaries are statically linked and work on both glibc and musl systems
-      return `@fallow-cli/linux-${arch}-musl`;
-    }
+const pkg = (() => {
+  if (process.platform !== 'linux') {
+    return getPlatformPackage(process.platform, process.arch);
   }
 
-  return null;
-}
-
-const pkg = getPlatformPackage();
+  try {
+    const { familySync } = require('detect-libc');
+    return getPlatformPackage(process.platform, process.arch, familySync());
+  } catch {
+    // musl binaries are statically linked and work on both glibc and musl systems
+    return getPlatformPackage(process.platform, process.arch, 'musl');
+  }
+})();
 
 if (!pkg) {
   console.error(`Unsupported platform: ${process.platform}-${process.arch}`);

package/bin/fallow-lsp

@@ -3,32 +3,21 @@
 const { execFileSync } = require('child_process');
 const { join } = require('path');
 const { existsSync } = require('fs');
+const { getPlatformPackage } = require('../scripts/platform-package');
 
-function getPlatformPackage() {
-  const platform = process.platform;
-  const arch = process.arch;
-
-  if (platform === 'win32' && arch === 'x64') {
-    return '@fallow-cli/win32-x64-msvc';
-  }
-  if (platform === 'darwin') {
-    return `@fallow-cli/darwin-${arch}`;
-  }
-  if (platform === 'linux') {
-    try {
-      const { familySync } = require('detect-libc');
-      const libc = familySync() === 'musl' ? 'musl' : 'gnu';
-      return `@fallow-cli/linux-${arch}-${libc}`;
-    } catch {
-      // musl binaries are statically linked and work on both glibc and musl systems
-      return `@fallow-cli/linux-${arch}-musl`;
-    }
+const pkg = (() => {
+  if (process.platform !== 'linux') {
+    return getPlatformPackage(process.platform, process.arch);
   }
 
-  return null;
-}
-
-const pkg = getPlatformPackage();
+  try {
+    const { familySync } = require('detect-libc');
+    return getPlatformPackage(process.platform, process.arch, familySync());
+  } catch {
+    // musl binaries are statically linked and work on both glibc and musl systems
+    return getPlatformPackage(process.platform, process.arch, 'musl');
+  }
+})();
 
 if (!pkg) {
   console.error(`Unsupported platform: ${process.platform}-${process.arch}`);

package/bin/fallow-mcp

@@ -3,32 +3,21 @@
 const { execFileSync } = require('child_process');
 const { join } = require('path');
 const { existsSync } = require('fs');
+const { getPlatformPackage } = require('../scripts/platform-package');
 
-function getPlatformPackage() {
-  const platform = process.platform;
-  const arch = process.arch;
-
-  if (platform === 'win32' && arch === 'x64') {
-    return '@fallow-cli/win32-x64-msvc';
-  }
-  if (platform === 'darwin') {
-    return `@fallow-cli/darwin-${arch}`;
-  }
-  if (platform === 'linux') {
-    try {
-      const { familySync } = require('detect-libc');
-      const libc = familySync() === 'musl' ? 'musl' : 'gnu';
-      return `@fallow-cli/linux-${arch}-${libc}`;
-    } catch {
-      // musl binaries are statically linked and work on both glibc and musl systems
-      return `@fallow-cli/linux-${arch}-musl`;
-    }
+const pkg = (() => {
+  if (process.platform !== 'linux') {
+    return getPlatformPackage(process.platform, process.arch);
   }
 
-  return null;
-}
-
-const pkg = getPlatformPackage();
+  try {
+    const { familySync } = require('detect-libc');
+    return getPlatformPackage(process.platform, process.arch, familySync());
+  } catch {
+    // musl binaries are statically linked and work on both glibc and musl systems
+    return getPlatformPackage(process.platform, process.arch, 'musl');
+  }
+})();
 
 if (!pkg) {
   console.error(`Unsupported platform: ${process.platform}-${process.arch}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fallow",
-  "version": "2.47.0",
+  "version": "2.48.0",
   "description": "Codebase intelligence for TypeScript and JavaScript. Finds unused code, duplication, circular dependencies, complexity hotspots, and architecture drift. Optional runtime intelligence layer (Fallow Runtime) adds production execution evidence. Rust-native, sub-second, 90 framework plugins.",
   "license": "MIT",
   "repository": {
@@ -11,6 +11,11 @@
   "bugs": {
     "url": "https://github.com/fallow-rs/fallow/issues"
   },
+  "intent": {
+    "version": 1,
+    "repo": "fallow-rs/fallow",
+    "docs": "https://docs.fallow.tools"
+  },
   "keywords": [
     "unused-code",
     "circular-dependencies",
@@ -19,7 +24,9 @@
     "analyzer",
     "typescript",
     "javascript",
-    "static-analysis"
+    "static-analysis",
+    "agent-skills",
+    "tanstack-intent"
   ],
   "engines": {
     "node": ">=16"
@@ -32,21 +39,28 @@
   "files": [
     "bin",
     "scripts",
+    "skills",
+    "!skills/_artifacts",
     "README.md"
   ],
   "scripts": {
-    "postinstall": "node scripts/postinstall.js"
+    "postinstall": "node scripts/postinstall.js",
+    "test:platform": "node --test scripts/platform-package.test.js"
   },
   "dependencies": {
     "detect-libc": "2.1.2"
   },
+  "devDependencies": {
+    "@tanstack/intent": "0.0.29"
+  },
   "optionalDependencies": {
-    "@fallow-cli/darwin-arm64": "2.47.0",
-    "@fallow-cli/darwin-x64": "2.47.0",
-    "@fallow-cli/linux-x64-gnu": "2.47.0",
-    "@fallow-cli/linux-arm64-gnu": "2.47.0",
-    "@fallow-cli/linux-x64-musl": "2.47.0",
-    "@fallow-cli/linux-arm64-musl": "2.47.0",
-    "@fallow-cli/win32-x64-msvc": "2.47.0"
+    "@fallow-cli/darwin-arm64": "2.48.0",
+    "@fallow-cli/darwin-x64": "2.48.0",
+    "@fallow-cli/linux-x64-gnu": "2.48.0",
+    "@fallow-cli/linux-arm64-gnu": "2.48.0",
+    "@fallow-cli/linux-x64-musl": "2.48.0",
+    "@fallow-cli/linux-arm64-musl": "2.48.0",
+    "@fallow-cli/win32-arm64-msvc": "2.48.0",
+    "@fallow-cli/win32-x64-msvc": "2.48.0"
   }
 }

package/scripts/platform-package.js

@@ -0,0 +1,28 @@
+function getPlatformPackage(platform, arch, libcFamily) {
+  if (platform === 'win32') {
+    if (arch === 'x64') return '@fallow-cli/win32-x64-msvc';
+    if (arch === 'arm64') return '@fallow-cli/win32-arm64-msvc';
+    return null;
+  }
+
+  if (platform === 'darwin') {
+    if (arch === 'x64' || arch === 'arm64') {
+      return `@fallow-cli/darwin-${arch}`;
+    }
+    return null;
+  }
+
+  if (platform === 'linux') {
+    const libc = libcFamily === 'musl' ? 'musl' : 'gnu';
+    if (arch === 'x64' || arch === 'arm64') {
+      return `@fallow-cli/linux-${arch}-${libc}`;
+    }
+    return null;
+  }
+
+  return null;
+}
+
+module.exports = {
+  getPlatformPackage,
+};

package/scripts/platform-package.test.js

@@ -0,0 +1,26 @@
+const test = require('node:test');
+const assert = require('node:assert/strict');
+
+const { getPlatformPackage } = require('./platform-package');
+
+test('maps Windows x64 and arm64 to MSVC packages', () => {
+  assert.equal(getPlatformPackage('win32', 'x64'), '@fallow-cli/win32-x64-msvc');
+  assert.equal(getPlatformPackage('win32', 'arm64'), '@fallow-cli/win32-arm64-msvc');
+});
+
+test('maps Linux packages with libc awareness', () => {
+  assert.equal(getPlatformPackage('linux', 'x64', 'gnu'), '@fallow-cli/linux-x64-gnu');
+  assert.equal(getPlatformPackage('linux', 'arm64', 'musl'), '@fallow-cli/linux-arm64-musl');
+  assert.equal(getPlatformPackage('linux', 'arm64'), '@fallow-cli/linux-arm64-gnu');
+});
+
+test('maps macOS packages by architecture', () => {
+  assert.equal(getPlatformPackage('darwin', 'x64'), '@fallow-cli/darwin-x64');
+  assert.equal(getPlatformPackage('darwin', 'arm64'), '@fallow-cli/darwin-arm64');
+});
+
+test('returns null for unsupported targets', () => {
+  assert.equal(getPlatformPackage('win32', 'ia32'), null);
+  assert.equal(getPlatformPackage('linux', 'ppc64'), null);
+  assert.equal(getPlatformPackage('freebsd', 'x64'), null);
+});

package/scripts/postinstall.js

@@ -1,28 +1,17 @@
-// Verify the correct platform-specific package was installed
-function getPlatformPackage() {
-  const platform = process.platform;
-  const arch = process.arch;
+const { getPlatformPackage } = require('./platform-package');
 
-  if (platform === 'win32' && arch === 'x64') {
-    return '@fallow-cli/win32-x64-msvc';
-  }
-  if (platform === 'darwin') {
-    return `@fallow-cli/darwin-${arch}`;
-  }
-  if (platform === 'linux') {
-    try {
-      const { familySync } = require('detect-libc');
-      const libc = familySync() === 'musl' ? 'musl' : 'gnu';
-      return `@fallow-cli/linux-${arch}-${libc}`;
-    } catch {
-      return `@fallow-cli/linux-${arch}-gnu`;
-    }
+const pkg = (() => {
+  if (process.platform !== 'linux') {
+    return getPlatformPackage(process.platform, process.arch);
   }
 
-  return null;
-}
-
-const pkg = getPlatformPackage();
+  try {
+    const { familySync } = require('detect-libc');
+    return getPlatformPackage(process.platform, process.arch, familySync());
+  } catch {
+    return getPlatformPackage(process.platform, process.arch);
+  }
+})();
 
 if (!pkg) {
   console.warn(