rigjs 3.0.32 → 4.0.2

package/scripts/postinstall.mjs

@@ -0,0 +1,108 @@
+#!/usr/bin/env node
+// Runs after `npm i -g rigjs`. Symlinks bundled rig skills into
+// ~/.claude/skills/<skill>/SKILL.md so Claude Code sees them without the
+// user needing to run `rig wiki install-skill` first.
+//
+// Guardrails (so this never breaks an `npm install`):
+//   - macOS only (defense-in-depth alongside package.json `os: ["darwin"]`)
+//   - exit 0 even when something goes wrong; print a hint instead
+//   - opt-out via env: `RIG_NO_AUTO_SKILL=1 npm i -g rigjs`
+//   - idempotent: re-running is safe
+//   - never clobber a symlink that points elsewhere (user may have
+//     `yarn link`-ed a dev copy on top of a registry install)
+
+import { existsSync, mkdirSync, readlinkSync, statSync, symlinkSync, unlinkSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { fileURLToPath } from 'node:url';
+import path from 'node:path';
+
+const ok = () => process.exit(0);
+
+if (process.platform !== 'darwin') {
+  console.log('rig: postinstall skipping (rig wiki is macOS-only)');
+  ok();
+}
+
+if (process.env.RIG_NO_AUTO_SKILL === '1') {
+  console.log('rig: postinstall skipping (RIG_NO_AUTO_SKILL=1)');
+  ok();
+}
+
+const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+const skills = [
+  { name: 'rig-wiki', src: path.join(repoRoot, 'RIG_WIKI_SKILL.md') },
+  { name: 'rig-crew', src: path.join(repoRoot, 'RIG_CREW_SKILL.md') },
+];
+
+if (!skills.some(s => existsSync(s.src))) {
+  console.log(`rig: postinstall skipping (no bundled skill files found in ${repoRoot})`);
+  ok();
+}
+
+const claudeSkillsDir = path.join(homedir(), '.claude', 'skills');
+if (!existsSync(claudeSkillsDir)) {
+  console.log([
+    '',
+    'rig: Claude Code skills dir not found.',
+    `  Expected: ${claudeSkillsDir}`,
+    '  Install Claude Code first, then run:  rig wiki install-skill',
+    '',
+  ].join('\n'));
+  ok();
+}
+
+try {
+  for (const skill of skills) {
+    if (!existsSync(skill.src)) {
+      console.log(`rig: skipping ${skill.name} skill (${skill.src} not found)`);
+      continue;
+    }
+    linkSkill(skill.name, skill.src);
+  }
+} catch (err) {
+  console.log(`rig: postinstall couldn't link skills (${err && err.message || err}). Run \`rig wiki install-skill\` manually.`);
+}
+ok();
+
+function linkSkill(name, src) {
+  const targetDir = path.join(claudeSkillsDir, name);
+  const target = path.join(targetDir, 'SKILL.md');
+  mkdirSync(targetDir, { recursive: true });
+
+  if (existsSync(target) || isBrokenSymlink(target)) {
+    const existing = safeReadlink(target);
+    if (existing === src) {
+      console.log(`rig: skill already linked  (${target})`);
+      return;
+    }
+    if (existing) {
+      console.log([
+        `rig: skill link target conflicts at ${target}`,
+        `  existing → ${existing}`,
+        `  wanted   → ${src}`,
+        '  Refusing to clobber. Run `rig wiki install-skill --force` if you want to replace it.',
+      ].join('\n'));
+      return;
+    }
+    // Regular file (not a symlink). Skip — user wrote something custom.
+    console.log(`rig: ${target} exists as a regular file; leaving it alone`);
+    return;
+  }
+
+  symlinkSync(src, target);
+  console.log(`rig: linked ${name} skill -> ${target}`);
+}
+
+function safeReadlink(p) {
+  try { return readlinkSync(p); } catch { return null; }
+}
+
+function isBrokenSymlink(p) {
+  try {
+    statSync(p); // follows symlinks
+    return false;
+  } catch {
+    // statSync throws if target is missing. lstat tells us if `p` itself exists as a link.
+    try { return Boolean(readlinkSync(p)); } catch { return false; }
+  }
+}

package/scripts/publish.mjs

@@ -0,0 +1,93 @@
+#!/usr/bin/env node
+// Thin wrapper around `npm publish`:
+//   - reads NPM_TOKEN from env, or `--token <val>` from argv
+//   - fails fast with a clear hint when neither is present
+//   - writes a short-lived temp .npmrc with the token + registry, points
+//     npm at it via --userconfig (token never lives in argv → no `ps` leak,
+//     never lives in the repo, deleted on exit)
+//   - passes everything else through to npm publish
+
+import { spawnSync } from 'node:child_process';
+import { readFileSync, writeFileSync, mkdtempSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { fileURLToPath } from 'node:url';
+import path from 'node:path';
+
+const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+const REGISTRY = 'https://registry.npmjs.org/';
+
+// --- parse argv ---
+const argv = process.argv.slice(2);
+let token = process.env.NPM_TOKEN;
+const passthrough = [];
+for (let i = 0; i < argv.length; i++) {
+  if (argv[i] === '--token' && argv[i + 1]) {
+    token = argv[++i];
+  } else if (argv[i].startsWith('--token=')) {
+    token = argv[i].slice('--token='.length);
+  } else {
+    passthrough.push(argv[i]);
+  }
+}
+
+// --- check token ---
+if (!token) {
+  process.stderr.write([
+    '',
+    'npm publish: NPM_TOKEN not found.',
+    '',
+    'Fix one of:',
+    '  1) Set persistent env var (recommended)',
+    '       echo \'export NPM_TOKEN=npm_xxx\' >> ~/.zshrc && source ~/.zshrc',
+    '  2) Pass it inline this run only',
+    '       yarn deliver --token npm_xxx',
+    '  3) Export in current shell',
+    '       export NPM_TOKEN=npm_xxx && yarn deliver',
+    '',
+    'Generate one at:  https://www.npmjs.com/settings/<your-user>/tokens',
+    'Choose "Automation" if you have 2FA enabled.',
+    '',
+  ].join('\n'));
+  process.exit(1);
+}
+
+// --- show what's about to ship ---
+const pkg = JSON.parse(readFileSync(path.join(repoRoot, 'package.json'), 'utf8'));
+process.stdout.write(`\npublishing ${pkg.name}@${pkg.version} to ${REGISTRY}\n\n`);
+
+// --- write throwaway userconfig with the real token ---
+const tmpDir = mkdtempSync(path.join(tmpdir(), 'rigjs-publish-'));
+const tmpRc = path.join(tmpDir, '.npmrc');
+writeFileSync(tmpRc, [
+  `registry=${REGISTRY}`,
+  `//registry.npmjs.org/:_authToken=${token}`,
+  'always-auth=true',
+  '',
+].join('\n'), { mode: 0o600 });
+
+// Scrub `npm_config_*` env vars before spawning npm. yarn injects
+// `npm_config_registry=https://registry.yarnpkg.com` when running scripts,
+// and that env wins over the registry= line in our temp .npmrc.
+const cleanEnv = Object.fromEntries(
+  Object.entries(process.env).filter(([k]) => !/^npm_config_/i.test(k))
+);
+
+let status = 1;
+try {
+  // `--registry` on the CLI is the strongest override (CLI flag > env > rc).
+  // Belt-and-braces with the scrubbed env above.
+  const res = spawnSync('npm', [
+    'publish',
+    '--registry', REGISTRY,
+    `--userconfig=${tmpRc}`,
+    ...passthrough,
+  ], {
+    cwd: repoRoot,
+    stdio: 'inherit',
+    env: cleanEnv,
+  });
+  status = res.status ?? 1;
+} finally {
+  rmSync(tmpDir, { recursive: true, force: true });
+}
+process.exit(status);

package/scripts/sync-skill.mjs

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+// Keep Claude plugin skill copies in sync with canonical root skill files.
+// Runs from `prepublishOnly` so the tarball always ships matching copies.
+//
+// We keep two real files (instead of a symlink) because npm pack does not
+// preserve symlinks in the tarball, and the official Claude Code plugin
+// loader expects a real file at <plugin>/.claude/skills/<name>/SKILL.md.
+
+import { readFileSync, writeFileSync, mkdirSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import path from 'node:path';
+
+const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+
+const skills = [
+  ['RIG_WIKI_SKILL.md', '.claude/skills/rig-wiki/SKILL.md'],
+];
+
+for (const [srcRel, destRel] of skills) {
+  const src = path.join(repoRoot, srcRel);
+  const dest = path.join(repoRoot, destRel);
+  const srcContent = readFileSync(src, 'utf8');
+  mkdirSync(path.dirname(dest), { recursive: true });
+  let destContent = '';
+  try { destContent = readFileSync(dest, 'utf8'); } catch { /* missing is fine */ }
+
+  if (srcContent === destContent) {
+    console.log(`sync-skill: ${destRel} already in sync`);
+  } else {
+    writeFileSync(dest, srcContent, 'utf8');
+    console.log(`sync-skill: wrote ${destRel}  (<-  ${srcRel})`);
+  }
+}

package/scripts/version-code.mjs

@@ -0,0 +1,86 @@
+#!/usr/bin/env node
+// versionCode bumper.
+//
+// Format: YYMMDDNN — 6-digit local date prefix + 2-digit sequence (01-99).
+// Caps at 99 builds per day. Same algorithm as bitterless/scripts/publish.js
+// `updateVersionCode`, kept here so rig (and any project that imports this
+// module) can stamp builds without depending on bitterless.
+//
+// Usage:
+//   node scripts/version-code.mjs            # bump + write package.json + print
+//   node scripts/version-code.mjs --print    # print current code, no write
+//   node scripts/version-code.mjs --peek     # show what the next bump would be
+//   import { bumpVersionCode } from './scripts/version-code.mjs'
+//
+// All file I/O is relative to the package.json found by walking up from CWD,
+// so the script works from any subdir of the project.
+
+import { readFileSync, writeFileSync, existsSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const PAD2 = (n) => n.toString().padStart(2, '0');
+
+function todayPrefix(date = new Date()) {
+  const y = date.getFullYear().toString().slice(-2);
+  return `${y}${PAD2(date.getMonth() + 1)}${PAD2(date.getDate())}`;
+}
+
+function nextCode(currentCode, prefix = todayPrefix()) {
+  const current = currentCode != null ? String(currentCode) : '';
+  if (current.startsWith(prefix)) {
+    const n = parseInt(current.slice(6), 10);
+    if (isNaN(n)) return `${prefix}01`;
+    if (n >= 99) {
+      throw new Error(`versionCode cap reached (99 builds today for prefix ${prefix})`);
+    }
+    return `${prefix}${PAD2(n + 1)}`;
+  }
+  return `${prefix}01`;
+}
+
+function findPackageJson(startDir = process.cwd()) {
+  let dir = path.resolve(startDir);
+  while (true) {
+    const p = path.join(dir, 'package.json');
+    if (existsSync(p)) return p;
+    const parent = path.dirname(dir);
+    if (parent === dir) throw new Error('package.json not found walking up from ' + startDir);
+    dir = parent;
+  }
+}
+
+export function bumpVersionCode(packageJsonPath = findPackageJson()) {
+  const pkg = JSON.parse(readFileSync(packageJsonPath, 'utf8'));
+  const before = pkg.versionCode != null ? String(pkg.versionCode) : '';
+  const after = nextCode(before);
+  pkg.versionCode = parseInt(after, 10);
+  writeFileSync(packageJsonPath, JSON.stringify(pkg, null, 2) + '\n');
+  return { before, after: pkg.versionCode, packageJsonPath };
+}
+
+export function readVersionCode(packageJsonPath = findPackageJson()) {
+  const pkg = JSON.parse(readFileSync(packageJsonPath, 'utf8'));
+  return pkg.versionCode != null ? String(pkg.versionCode) : null;
+}
+
+// CLI entrypoint
+const isMain = (() => {
+  try { return path.resolve(process.argv[1]) === fileURLToPath(import.meta.url); }
+  catch { return false; }
+})();
+
+if (isMain) {
+  const arg = process.argv[2];
+  const pkgPath = findPackageJson();
+  if (arg === '--print') {
+    const code = readVersionCode(pkgPath);
+    process.stdout.write((code ?? '') + '\n');
+  } else if (arg === '--peek') {
+    const code = readVersionCode(pkgPath);
+    process.stdout.write(nextCode(code ?? '') + '\n');
+  } else {
+    const { before, after } = bumpVersionCode(pkgPath);
+    process.stdout.write(`versionCode: ${before || '<empty>'} -> ${after}\n`);
+  }
+}

package/skills.md

@@ -0,0 +1,54 @@
+# rig Skills
+
+This page is the skill index for the `rigjs` package.
+
+Keep the root `README.md` short: it should link here and to the canonical skill files, while this page explains how the bundled skills relate to the CLI.
+
+## Bundled Skills
+
+| Skill | Canonical file | Plugin copy | CLI area | Purpose |
+|---|---|---|---|---|
+| `rig-wiki` | [`RIG_WIKI_SKILL.md`](./RIG_WIKI_SKILL.md) | [`.claude/skills/rig-wiki/SKILL.md`](./.claude/skills/rig-wiki/SKILL.md) | `rig wiki *` | Karpathy-style LLM wiki operations: scan, fetch, ingest, query, lint, and rebuild. |
+| `rig-crew` | [`RIG_CREW_SKILL.md`](./RIG_CREW_SKILL.md) | None; use the Vault/overmind skill copy | `rig crew *` | File-backed, Leader-first multi-agent coordination over an Obsidian vault. |
+
+`rig-crew` is intentionally not copied into `projects/rig/.claude/skills/`. In the overmind workflow, `rig` is just one project inside the Vault. The active crew instructions come from the Vault root `CLAUDE.md` / `AGENTS.md` managed block plus the overmind/user-level skill installation, so a project-local Claude skill copy would be misleading.
+
+## Install
+
+Normal install:
+
+```bash
+npm i -g rigjs
+```
+
+The `postinstall` script links bundled skills into `~/.claude/skills/` when Claude Code is installed.
+
+Security-conscious install:
+
+```bash
+npm i -g rigjs --ignore-scripts
+rig wiki install-skill
+```
+
+`rig wiki install-skill` installs both bundled skills. The command name remains under `wiki` for backward compatibility.
+
+## Maintenance
+
+Canonical files live at the package root:
+
+- [`RIG_WIKI_SKILL.md`](./RIG_WIKI_SKILL.md)
+- [`RIG_CREW_SKILL.md`](./RIG_CREW_SKILL.md)
+
+Plugin copies that belong to the `rig` package live under `.claude/skills/` and are synchronized by:
+
+```bash
+node scripts/sync-skill.mjs
+```
+
+`prepublishOnly` runs the sync script before packaging. Today this plugin-copy set only includes `rig-wiki`; `rig-crew` remains Vault-level guidance.
+
+## Documentation Policy
+
+- Put one-line skill visibility and high-level links in `README.md`.
+- Put all skill references, maintenance notes, and plugin-copy details in this file.
+- Keep each canonical `RIG_*_SKILL.md` self-contained so users can read exactly what they are enabling.

package/.github/workflows/npm-publish.yml

@@ -1,22 +0,0 @@
-# This workflow will run tests using node and then publish a package to GitHub Packages when a release is created
-# For more information see: https://docs.github.com/en/actions/publishing-packages/publishing-nodejs-packages
-
-name: Node.js Package
-
-on:
-  push:
-    tags:
-      - '*'
-
-jobs:
-  publish:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: 18
-          registry-url: https://registry.npmjs.org/
-      - run: yarn deliver
-        env:
-          NODE_AUTH_TOKEN: ${{secrets.NPM_TOKEN}}

package/demo/.env.oem1

@@ -1,4 +0,0 @@
-OUT_PUT_DIR = dist/ykp/test/oem1
-NODE_ENV = test
-BUILD_TYPE = test_ome1
-VUE_APP_BASE_URL = 'http://localhost:9001'

package/demo/.env.oem2

@@ -1,4 +0,0 @@
-OUT_PUT_DIR = dist/ykp/test/oem2
-NODE_ENV = test
-BUILD_TYPE = test_ome2
-VUE_APP_BASE_URL = 'http://localhost:9001'

package/demo/babel.config.js

@@ -1,5 +0,0 @@
-module.exports = {
-  presets: [
-    '@vue/cli-plugin-babel/preset'
-  ]
-}

package/demo/env.rig.json5

@@ -1,8 +0,0 @@
-{
-  dev: {
-    DEV_URL: 'test.test'
-  },
-  prod: {
-    PROD_URL: 'test.test'
-  },
-}

package/demo/jsconfig.json

@@ -1,19 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "es5",
-    "module": "esnext",
-    "baseUrl": "./",
-    "moduleResolution": "node",
-    "paths": {
-      "@/*": [
-        "src/*"
-      ]
-    },
-    "lib": [
-      "esnext",
-      "dom",
-      "dom.iterable",
-      "scripthost"
-    ]
-  }
-}

package/demo/package.json

@@ -1,59 +0,0 @@
-{
-  "name": "demo",
-  "version": "0.1.0",
-  "private": true,
-  "scripts": {
-    "serve": "vue-cli-service serve",
-    "build:oem1": "vue-cli-service build --mode oem1",
-    "build:oem2": "vue-cli-service build --mode oem2",
-    "build": "vue-cli-service build",
-    "lint": "vue-cli-service lint",
-    "test_prei": "node ../built/index.js preinstall",
-    "test_tag": "node ../built/index.js tag",
-    "test_env": "node ../built/index.js --env dev",
-    "test_posti": "node ../built/index.js postinstall"
-  },
-  "dependencies": {
-    "core-js": "^3.8.3",
-    "cross-env": "^7.0.3",
-    "rig-test-2": "git+ssh://git@github.com:FlashHand/rig-test-2.git#1.0.1",
-    "vue": "^2.6.14",
-    "rig-test-1": "git+ssh://git@github.com:FlashHand/rig-test-1.git#1.0.1",
-    "r-foundation": "git+ssh://git@github.com:FlashHand/r-foundation.git#1.1.7"
-  },
-  "devDependencies": {
-    "@babel/core": "^7.12.16",
-    "@babel/eslint-parser": "^7.12.16",
-    "@vue/cli-plugin-babel": "~5.0.0",
-    "@vue/cli-plugin-eslint": "~5.0.0",
-    "@vue/cli-service": "~5.0.0",
-    "eslint": "^7.32.0",
-    "eslint-plugin-vue": "^8.0.3",
-    "json5": "2.2.1",
-    "vue-template-compiler": "^2.6.14"
-  },
-  "eslintConfig": {
-    "root": true,
-    "env": {
-      "node": true
-    },
-    "extends": [
-      "plugin:vue/essential",
-      "eslint:recommended"
-    ],
-    "parserOptions": {
-      "parser": "@babel/eslint-parser"
-    },
-    "rules": {}
-  },
-  "browserslist": [
-    "> 1%",
-    "last 2 versions",
-    "not dead"
-  ],
-  "workspaces": [
-    "rigs/*",
-    "rigs_dev/*",
-    "rig_dev/*"
-  ]
-}

package/demo/package.rig.json5

@@ -1,78 +0,0 @@
-{
-  dependencies: {
-    'rig-test-1': {
-      dev: true,
-      name: 'rig-test-1',
-      source: 'git@github.com:FlashHand/rig-test-1.git',
-      version: '1.0.1',
-    },
-    'rig-test-2': {
-      dev: false,
-      name: 'rig-test-2',
-      source: 'git@github.com:FlashHand/rig-test-2.git',
-      version: '1.0.1',
-    },
-    'r-foundation': {
-      name: 'r-foundation',
-      source: 'git@github.com:FlashHand/r-foundation.git',
-      version: '1.1.7',
-      dev: true,
-    },
-    'zenrtcjssdk': {
-      //      dev: true,
-      name: 'zenrtcjssdk',
-      source: 'git@code.y5ops.com:zenrtc/zenrtcjssdk.git',
-      version: '1.8.16-dev.5'
-    }
-  },
-  isLegacy: false,
-  cicd: {
-    path_schema: "demo/{env}/{oem}",
-    //Your local build's path.
-    source: {
-      root_path: "dist"
-    },
-    //Entry path for your website's index.html.Default is '/'.
-    web_entry_path: '/',
-    //Your deploy target
-    target: {
-      //Only support alicould for now.
-      id: "alicloud",
-      type: "alicloud",
-      bucket: "rys-deploy",
-      region: "oss-cn-hangzhou",
-      access_key: "${ak}",
-      access_secret: "${as}",
-      //Root path in the bucket,default is '/'.
-      root_path: "/",
-    },
-    endpoints: {
-      "demo/test/oem1": {
-        build: 'yarn cross-env OUTPUT_DIR=__RIG_OUTPUT_DIR__ PUBLIC_PATH=__RIG_PUBLIC_PATH__ vue-cli-service build',
-        defines: {
-          RIG_REPLACE_GRAY: '/test-gray'
-        },
-        domains: [
-          "test-mp.domain.com"
-        ],
-      },
-    },
-    groups: [
-      {
-        name: "%oem",
-        level: "oem",
-        includes: [
-          "oem1",
-          "oem2"
-        ]
-      },
-    ]
-
-  },
-  share: {
-    eslint: {
-      links: ['https://gist.githubusercontent.com/FlashHand/580a0a2f13b5ec31ccbedd368abd3bbf/raw/0638841f4f0c284d442a7ffe7bc9c8f3f2feb91e/.eslintrc.js'],
-    }
-  }
-
-}

package/demo/public/index.html

@@ -1,17 +0,0 @@
-<!DOCTYPE html>
-<html lang="">
-  <head>
-    <meta charset="utf-8">
-    <meta http-equiv="X-UA-Compatible" content="IE=edge">
-    <meta name="viewport" content="width=device-width,initial-scale=1.0">
-    <link rel="icon" href="<%= BASE_URL %>favicon.ico">
-    <title><%= htmlWebpackPlugin.options.title %></title>
-  </head>
-  <body>
-    <noscript>
-      <strong>We're sorry but <%= htmlWebpackPlugin.options.title %> doesn't work properly without JavaScript enabled. Please enable it to continue.</strong>
-    </noscript>
-    <div id="app"></div>
-    <!-- built files will be auto injected -->
-  </body>
-</html>

package/demo/rig_helper.d.ts

@@ -1,4 +0,0 @@
-declare namespace rig_helper {
-	export const getPkgs: () => string[]
-}
-export default rig_helper;

package/demo/rig_helper.js

@@ -1,10 +0,0 @@
-const json5 = require('json5');
-const fs = require('fs');
-const getPkgs = () => {
-	let rigPkg = json5.parse(fs.readFileSync('./package.rig.json5'));
-	return Object.keys(rigPkg.dependencies);
-}
-
-module.exports = {
-	getPkgs
-}

package/demo/src/App.vue

@@ -1,34 +0,0 @@
-<template>
-  <div id="app">
-    <img alt="Vue logo" src="./assets/logo.png">
-    <HelloWorld msg="Welcome to Your Vue.js App"/>
-		<span>test_replace:{{ test_replace}}</span>
-  </div>
-</template>
-
-<script>
-import HelloWorld from './components/HelloWorld.vue'
-
-export default {
-  name: 'App',
-	data() {
-		return {
-			test_replace: 'NGINX_REPLACE_A'
-		}
-	},
-  components: {
-    HelloWorld
-  }
-}
-</script>
-
-<style>
-#app {
-  font-family: Avenir, Helvetica, Arial, sans-serif;
-  -webkit-font-smoothing: antialiased;
-  -moz-osx-font-smoothing: grayscale;
-  text-align: center;
-  color: #2c3e50;
-  margin-top: 60px;
-}
-</style>