ts-procedures 5.2.0 → 5.3.0

package/agent_config/lib/install-claude.mjs

@@ -0,0 +1,109 @@
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const SKILLS_DIR = join(__dirname, '..', 'claude-code', 'skills');
+const AGENTS_DIR = join(__dirname, '..', 'claude-code', 'agents');
+
+function getPackageVersion() {
+  try {
+    const pkg = JSON.parse(readFileSync(join(__dirname, '..', '..', 'package.json'), 'utf-8'));
+    return pkg.version || 'unknown';
+  } catch {
+    return 'unknown';
+  }
+}
+
+function makeAutoHeader() {
+  const version = getPackageVersion();
+  return `<!-- Auto-generated by ts-procedures@${version}. Updated on npm install/update. Do not edit. -->\n\n`;
+}
+
+function stripFrontmatter(content) {
+  const match = content.match(/^---\n[\s\S]*?\n---\n([\s\S]*)$/);
+  return match ? match[1].trim() : content.trim();
+}
+
+function ensureDir(dir) {
+  if (!existsSync(dir)) {
+    mkdirSync(dir, { recursive: true });
+  }
+}
+
+/**
+ * Install Claude Code integration files into a project's .claude/ directory.
+ *
+ * Creates:
+ *   .claude/rules/ts-procedures.md            — Framework reference (always loaded in context)
+ *   .claude/commands/ts-procedures-scaffold.md — Scaffold command (/project:ts-procedures-scaffold)
+ *   .claude/commands/ts-procedures-review.md   — Review command (/project:ts-procedures-review)
+ *   .claude/agents/ts-procedures-architect.md  — Architecture planning agent
+ *
+ * @param {string} projectRoot — Absolute path to the consuming project's root
+ * @returns {{ files: string[] }} — List of created/updated file paths (relative to projectRoot)
+ */
+export function installClaude(projectRoot) {
+  const claudeDir = join(projectRoot, '.claude');
+  const rulesDir = join(claudeDir, 'rules');
+  const commandsDir = join(claudeDir, 'commands');
+  const agentsDir = join(claudeDir, 'agents');
+
+  ensureDir(rulesDir);
+  ensureDir(commandsDir);
+  ensureDir(agentsDir);
+
+  const autoHeader = makeAutoHeader();
+  const files = [];
+
+  // 1. Rules file — framework reference (always loaded in context)
+  const guideSkill = readFileSync(join(SKILLS_DIR, 'guide', 'SKILL.md'), 'utf-8');
+  const guideBody = stripFrontmatter(guideSkill)
+    // Remove the "Supporting Files" section — replaced by "Detailed Reference" below
+    .replace(/\n## Supporting Files[\s\S]*$/, '');
+
+  const rulesContent = autoHeader + guideBody + `
+
+## Detailed Reference
+
+For complete API details, patterns, and anti-patterns, read the files in:
+\`node_modules/ts-procedures/agent_config/claude-code/skills/guide/\`
+
+- \`api-reference.md\` — Full API reference for Procedures, Create, CreateStream, errors, schema, HTTP implementations
+- \`patterns.md\` — Prescribed patterns with code examples
+- \`anti-patterns.md\` — Common mistakes to avoid with fixes
+`;
+
+  writeFileSync(join(rulesDir, 'ts-procedures.md'), rulesContent, 'utf-8');
+  files.push('.claude/rules/ts-procedures.md');
+
+  // 2. Scaffold command
+  const scaffoldSkill = readFileSync(join(SKILLS_DIR, 'scaffold', 'SKILL.md'), 'utf-8');
+  const scaffoldBody = stripFrontmatter(scaffoldSkill)
+    .replace(
+      'Read the template file from `templates/<type>.md` in this skill directory.',
+      'Read the template file from `node_modules/ts-procedures/agent_config/claude-code/skills/scaffold/templates/<type>.md`.'
+    );
+
+  writeFileSync(join(commandsDir, 'ts-procedures-scaffold.md'), autoHeader + scaffoldBody, 'utf-8');
+  files.push('.claude/commands/ts-procedures-scaffold.md');
+
+  // 3. Review command
+  const reviewSkill = readFileSync(join(SKILLS_DIR, 'review', 'SKILL.md'), 'utf-8');
+  const reviewBody = stripFrontmatter(reviewSkill)
+    .replaceAll(
+      '`checklist.md`',
+      '`node_modules/ts-procedures/agent_config/claude-code/skills/review/checklist.md`'
+    );
+
+  writeFileSync(join(commandsDir, 'ts-procedures-review.md'), autoHeader + reviewBody, 'utf-8');
+  files.push('.claude/commands/ts-procedures-review.md');
+
+  // 4. Architect agent
+  const architectAgent = readFileSync(join(AGENTS_DIR, 'ts-procedures-architect.md'), 'utf-8');
+  writeFileSync(join(agentsDir, 'ts-procedures-architect.md'), autoHeader + architectAgent, 'utf-8');
+  files.push('.claude/agents/ts-procedures-architect.md');
+
+  return { files };
+}

package/package.json

@@ -1,14 +1,18 @@
 {
   "name": "ts-procedures",
-  "version": "5.2.0",
+  "version": "5.3.0",
   "description": "A TypeScript RPC framework that creates type-safe, schema-validated procedure calls with a single function definition. Define your procedures once and get full type inference, runtime validation, and framework integration hooks.",
   "main": "build/exports.js",
   "types": "build/exports.d.ts",
   "type": "module",
+  "bin": {
+    "ts-procedures-setup": "./agent_config/bin/setup.mjs"
+  },
   "scripts": {
     "build": "tsc",
     "lint": "npx eslint src/ --quiet",
     "prepublishOnly": "npm run lint && npm run build",
+    "postinstall": "node ./agent_config/bin/postinstall.mjs",
     "test": "vitest run"
   },
   "exports": {
@@ -38,7 +42,8 @@
   "files": [
     "assets",
     "build",
-    "src"
+    "src",
+    "agent_config"
   ],
   "keywords": [
     "typescript",