@hardlydifficult/shared-config 0.0.0

package/README.md

@@ -0,0 +1,64 @@
+# @hardlydifficult/shared-config
+
+Shared configuration files synced to consuming repos via a `postinstall` hook.
+
+## Installation
+
+```bash
+npm install -D @hardlydifficult/shared-config
+```
+
+## What Gets Synced
+
+| Path | Strategy | Details |
+|------|----------|---------|
+| `.gitignore` | Overwrite | Shared config is authoritative |
+| `.github/dependabot.yml` | Overwrite | Shared config is authoritative |
+| `.claude/` | Merge | Shared files overwrite, local additions preserved |
+
+## How It Works
+
+The package has a `postinstall` hook that runs automatically on `npm install`. It copies the bundled shared files into the consuming repo's root directory using the strategies listed above.
+
+No manual steps required after installation. Every `npm install` re-syncs the files.
+
+## Updating
+
+```bash
+# Re-sync with the currently installed version
+npm install
+
+# Bump to the latest published version
+npm install @hardlydifficult/shared-config@latest
+```
+
+Both commands trigger the `postinstall` hook, which re-syncs all shared files.
+
+## Skill Repos
+
+`skill-repos.json` lists external GitHub repos (in `owner/repo` format) used as skill sources:
+
+```json
+[
+  "some-org/some-repo",
+  "another-org/another-repo"
+]
+```
+
+Pull the latest skills from those repos into the local `.claude/` directory:
+
+```bash
+npx sync-skills
+```
+
+This fetches skills via the GitHub API. It runs in the monorepo only and is not published to npm.
+
+## Local .claude/ Files
+
+The `.claude/` merge strategy means any files you add locally are preserved across syncs. Only files that exist in the shared config are overwritten.
+
+To see which `.claude/` files are local additions (not from the shared config):
+
+```bash
+npx log-local-skills
+```

package/dist/postinstall.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=postinstall.d.ts.map

package/dist/postinstall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postinstall.d.ts","sourceRoot":"","sources":["../src/postinstall.ts"],"names":[],"mappings":""}

package/dist/postinstall.js

@@ -0,0 +1,80 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs_1 = require("fs");
+const path_1 = require("path");
+function findRepoRoot() {
+    // INIT_CWD is set by npm to the directory where npm install was run
+    if (process.env.INIT_CWD !== undefined && process.env.INIT_CWD !== "") {
+        return process.env.INIT_CWD;
+    }
+    // Fallback: walk up from our location past node_modules
+    let dir = __dirname;
+    while (dir !== (0, path_1.dirname)(dir)) {
+        if (dir.endsWith("node_modules")) {
+            return (0, path_1.dirname)(dir);
+        }
+        dir = (0, path_1.dirname)(dir);
+    }
+    return null;
+}
+function findFilesDir() {
+    // When installed from npm: files/ is a sibling of dist/
+    const fromDist = (0, path_1.join)(__dirname, "..", "files");
+    if ((0, fs_1.existsSync)(fromDist)) {
+        return fromDist;
+    }
+    return null;
+}
+function copyDirMerge(src, dest) {
+    if (!(0, fs_1.existsSync)(dest)) {
+        (0, fs_1.mkdirSync)(dest, { recursive: true });
+    }
+    for (const entry of (0, fs_1.readdirSync)(src)) {
+        const srcPath = (0, path_1.join)(src, entry);
+        const destPath = (0, path_1.join)(dest, entry);
+        const stat = (0, fs_1.statSync)(srcPath);
+        if (stat.isDirectory()) {
+            copyDirMerge(srcPath, destPath);
+        }
+        else {
+            (0, fs_1.copyFileSync)(srcPath, destPath);
+        }
+    }
+}
+function copyFileWithDir(src, dest) {
+    const destDir = (0, path_1.dirname)(dest);
+    if (!(0, fs_1.existsSync)(destDir)) {
+        (0, fs_1.mkdirSync)(destDir, { recursive: true });
+    }
+    (0, fs_1.copyFileSync)(src, dest);
+}
+function main() {
+    const repoRoot = findRepoRoot();
+    if (repoRoot === null) {
+        // Can't determine repo root, skip silently
+        return;
+    }
+    const filesDir = findFilesDir();
+    if (filesDir === null) {
+        // No files directory found (probably in development), skip silently
+        return;
+    }
+    // Copy .gitignore (overwrite - shared config is authoritative)
+    const gitignoreSrc = (0, path_1.join)(filesDir, ".gitignore");
+    if ((0, fs_1.existsSync)(gitignoreSrc)) {
+        copyFileWithDir(gitignoreSrc, (0, path_1.join)(repoRoot, ".gitignore"));
+    }
+    // Copy .github/dependabot.yml (overwrite - shared config is authoritative)
+    const dependabotSrc = (0, path_1.join)(filesDir, ".github", "dependabot.yml");
+    if ((0, fs_1.existsSync)(dependabotSrc)) {
+        copyFileWithDir(dependabotSrc, (0, path_1.join)(repoRoot, ".github", "dependabot.yml"));
+    }
+    // Merge .claude/ (additive only - never delete local files)
+    const claudeSrc = (0, path_1.join)(filesDir, ".claude");
+    if ((0, fs_1.existsSync)(claudeSrc)) {
+        copyDirMerge(claudeSrc, (0, path_1.join)(repoRoot, ".claude"));
+    }
+}
+main();
+//# sourceMappingURL=postinstall.js.map

package/dist/postinstall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postinstall.js","sourceRoot":"","sources":["../src/postinstall.ts"],"names":[],"mappings":"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"}

package/files/.github/dependabot.yml

@@ -0,0 +1,13 @@
+version: 2
+updates:
+  - package-ecosystem: npm
+    directory: /
+    schedule:
+      interval: weekly
+    open-pull-requests-limit: 10
+    versioning-strategy: increase
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: weekly
+    open-pull-requests-limit: 5

package/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "@hardlydifficult/shared-config",
+  "version": "0.0.0",
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "lint": "tsc --noEmit",
+    "postinstall": "node -e \"try{require('./dist/postinstall.js')}catch{}\""
+  },
+  "files": [
+    "dist",
+    "files"
+  ],
+  "devDependencies": {
+    "@types/node": "20.19.31",
+    "typescript": "5.8.3"
+  }
+}