@meyverick/agentic 5.0.2

package/install.ts

@@ -0,0 +1,349 @@
+#!/usr/bin/env bun
+/**
+ * install.ts - Install agentic skills, scripts, and AGENTS.md
+ * 
+ * Usage: bunx @meyverick/agentic
+ *   (or: bunx github:meyverick/agentic)
+ * 
+ * Installs to current directory:
+ *   - project/skills/* → .agents/skills/ (atomic replacement)
+ *   - project/scripts/* → scripts/ (diff-based)
+ *   - project/AGENTS.md → AGENTS.md
+ */
+
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+// Source directory (where this script lives)
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+// Try to find the source directory
+function findSourceDir(): string {
+  if (fs.existsSync(path.join(__dirname, 'skills'))) {
+    return __dirname;
+  }
+  
+  const parentDir = path.dirname(__dirname);
+  if (fs.existsSync(path.join(parentDir, 'skills'))) {
+    return parentDir;
+  }
+  
+  const scopedNodeModules = path.join(__dirname, 'node_modules', '@meyverick', 'agentic');
+  if (fs.existsSync(scopedNodeModules) && fs.existsSync(path.join(scopedNodeModules, 'skills'))) {
+    return scopedNodeModules;
+  }
+  
+  const parentScopedNodeModules = path.join(parentDir, 'node_modules', '@meyverick', 'agentic');
+  if (fs.existsSync(parentScopedNodeModules) && fs.existsSync(path.join(parentScopedNodeModules, 'skills'))) {
+    return parentScopedNodeModules;
+  }
+  
+  const nodeModulesPath = path.join(__dirname, 'node_modules', 'agentic');
+  if (fs.existsSync(nodeModulesPath) && fs.existsSync(path.join(nodeModulesPath, 'skills'))) {
+    return nodeModulesPath;
+  }
+  
+  const parentNodeModules = path.join(parentDir, 'node_modules', 'agentic');
+  if (fs.existsSync(parentNodeModules) && fs.existsSync(path.join(parentNodeModules, 'skills'))) {
+    return parentNodeModules;
+  }
+  
+  return __dirname;
+}
+
+const srcDir = findSourceDir();
+const targetDir = process.cwd();
+
+// Track stats
+let copied = 0;
+let skipped = 0;
+let replaced = 0;
+let created = 0;
+
+/**
+ * Get all files in directory recursively
+ */
+function getAllFiles(dir: string): string[] {
+  const files: string[] = [];
+  if (!fs.existsSync(dir)) return files;
+  
+  const items = fs.readdirSync(dir);
+  for (const item of items) {
+    const itemPath = path.join(dir, item);
+    const stat = fs.statSync(itemPath);
+    if (stat.isDirectory()) {
+      files.push(...getAllFiles(itemPath).map(f => path.join(item, f)));
+    } else {
+      files.push(item);
+    }
+  }
+  return files;
+}
+
+/**
+ * Compare two directories - return true if ANY file differs
+ */
+function hasDifferences(srcDir: string, dstDir: string): boolean {
+  if (!fs.existsSync(dstDir)) return true;
+  
+  const srcFiles = getAllFiles(srcDir);
+  const dstFiles = getAllFiles(dstDir);
+  
+  // Different number of files = different
+  if (srcFiles.length !== dstFiles.length) return true;
+  
+  // Check each file
+  for (const file of srcFiles) {
+    const srcPath = path.join(srcDir, file);
+    const dstPath = path.join(dstDir, file);
+    
+    if (!fs.existsSync(dstPath)) return true;
+    
+    const srcContent = fs.readFileSync(srcPath);
+    const dstContent = fs.readFileSync(dstPath);
+    
+    if (!srcContent.equals(dstContent)) return true;
+  }
+  
+  return false; // No differences
+}
+
+/**
+ * Replace entire skill directory (atomic)
+ */
+function replaceSkill(srcDir: string, dstDir: string): void {
+  // Remove existing directory
+  if (fs.existsSync(dstDir)) {
+    fs.rmSync(dstDir, { recursive: true, force: true });
+  }
+  
+  // Copy entire directory
+  fs.cpSync(srcDir, dstDir, { recursive: true });
+  replaced++;
+}
+
+/**
+ * Diff-based copy for single files (prompts, AGENTS.md)
+ */
+function syncFile(src: string, dst: string): boolean {
+  const dstDir = path.dirname(dst);
+  
+  if (!fs.existsSync(dstDir)) {
+    fs.mkdirSync(dstDir, { recursive: true });
+    created++;
+  }
+  
+  if (fs.existsSync(dst)) {
+    const srcContent = fs.readFileSync(src);
+    const dstContent = fs.readFileSync(dst);
+    
+    if (srcContent.equals(dstContent)) {
+      skipped++;
+      return false;
+    }
+  }
+  
+  fs.copyFileSync(src, dst);
+  copied++;
+  return true;
+}
+
+/**
+ * Install skills atomically
+ */
+function installSkills(): void {
+  const skillsSrc = path.join(srcDir, 'skills');
+  const skillsDst = path.join(targetDir, '.agents', 'skills');
+  
+  console.log('📦 Skills:');
+  
+  if (!fs.existsSync(skillsSrc)) {
+    console.log('  ⚠️  Source not found');
+    return;
+  }
+  
+  // Ensure target directory exists
+  if (!fs.existsSync(skillsDst)) {
+    fs.mkdirSync(skillsDst, { recursive: true });
+    created++;
+  }
+  
+  // Get all skills from source (directories only — dotfiles like
+  // .agentic-manifest.json / .ownership.json are files and never match)
+  const skills = fs.readdirSync(skillsSrc).filter(item => {
+    const itemPath = path.join(skillsSrc, item);
+    return fs.statSync(itemPath).isDirectory();
+  });
+  
+  for (const skill of skills) {
+    const srcPath = path.join(skillsSrc, skill);
+    const dstPath = path.join(skillsDst, skill);
+    
+    if (!fs.existsSync(dstPath)) {
+      // New skill - copy entirely
+      fs.cpSync(srcPath, dstPath, { recursive: true });
+      copied++;
+      console.log(`  + ${skill} (new)`);
+    } else if (hasDifferences(srcPath, dstPath)) {
+      // Skill changed - replace entirely
+      // Drift warning: existing content differs from what we ship.
+      // Atomic replacement overwrites ANY local modifications.
+      console.log(`  ⚠️  ${skill}: local modifications will be overwritten`);
+      replaceSkill(srcPath, dstPath);
+      console.log(`  ~ ${skill} (replaced)`);
+    } else {
+      // No changes - skip
+      skipped++;
+      console.log(`  = ${skill} (unchanged)`);
+    }
+  }
+  
+  console.log(`\n   → ${skillsDst}`);
+  console.log(`   Copied: ${copied} | Replaced: ${replaced} | Skipped: ${skipped}\n`);
+}
+
+/**
+ * Install scripts (diff-based with executable permissions)
+ */
+function installScripts(): void {
+  const scriptsSrc = path.join(srcDir, 'scripts');
+  const scriptsDst = path.join(targetDir, 'scripts');
+  
+  console.log('📜 Scripts:');
+  
+  if (!fs.existsSync(scriptsSrc)) {
+    console.log('   ⚠️  Not found\n');
+    return;
+  }
+  
+  copied = 0;
+  skipped = 0;
+  
+  const scriptFiles = fs.readdirSync(scriptsSrc).filter(item => {
+    return fs.statSync(path.join(scriptsSrc, item)).isFile();
+  });
+  
+  for (const file of scriptFiles) {
+    const srcPath = path.join(scriptsSrc, file);
+    const dstPath = path.join(scriptsDst, file);
+    
+    const changed = syncFile(srcPath, dstPath);
+    try {
+      fs.chmodSync(dstPath, 0o755);
+    } catch (_) {}
+    
+    if (changed) {
+      console.log(`  + ${file}`);
+    } else {
+      console.log(`  = ${file} (unchanged)`);
+    }
+  }
+  
+  console.log(`\n   → ${scriptsDst}`);
+  console.log(`   Copied: ${copied} | Skipped: ${skipped}\n`);
+}
+
+/**
+ * Install AGENTS.md (diff-based)
+ */
+function installAgentsMd(): void {
+  const agentsSrc = path.join(srcDir, 'AGENTS.md');
+  const agentsDst = path.join(targetDir, 'AGENTS.md');
+  
+  console.log('📋 AGENTS.md:');
+  
+  if (fs.existsSync(agentsSrc)) {
+    copied = 0;
+    skipped = 0;
+    syncFile(agentsSrc, agentsDst);
+    console.log(`   → ${agentsDst}`);
+    console.log(`   Copied: ${copied} | Skipped: ${skipped}\n`);
+  } else {
+    console.log('   ⚠️  Not found\n');
+  }
+}
+
+/**
+ * Create openspec/reports/ directory
+ */
+function createReportsDir(): void {
+  const reportsDst = path.join(targetDir, 'openspec', 'reports');
+  console.log('📂 Reports directory:');
+  
+  if (!fs.existsSync(reportsDst)) {
+    fs.mkdirSync(reportsDst, { recursive: true });
+    console.log(`   → Created ${reportsDst}\n`);
+  } else {
+    console.log(`   → ${reportsDst} (exists)\n`);
+  }
+}
+
+/**
+ * Write provenance manifest (.agents/skills/.agentic-manifest.json)
+ *
+ * Records what this installer owns so consuming-project agents can
+ * classify skill ownership without inference (ownership input). Consumer
+ * agents treat installed skills as read-only (never edit .agents/skills/*
+ * in place; reroute upstream or to project-local homes). Source skills
+ * in project/skills/* are owned and editable only by the project owner
+ * and trusted session. NEVER touches .ownership.json (user-owned adjudications).
+ */
+function writeProvenanceManifest(version: string): void {
+  const skillsDst = path.join(targetDir, '.agents', 'skills');
+  if (!fs.existsSync(skillsDst)) {
+    fs.mkdirSync(skillsDst, { recursive: true });
+  }
+  
+  const skillsSrc = path.join(srcDir, 'skills');
+  const scriptsSrc = path.join(srcDir, 'scripts');
+  
+  const skills = fs.existsSync(skillsSrc)
+    ? fs.readdirSync(skillsSrc).filter(item => fs.statSync(path.join(skillsSrc, item)).isDirectory())
+    : [];
+  
+  const scripts = fs.existsSync(scriptsSrc)
+    ? fs.readdirSync(scriptsSrc).filter(item => fs.statSync(path.join(scriptsSrc, item)).isFile())
+    : [];
+  
+  const manifest = {
+    installed_by: 'agentic',
+    version,
+    skills,
+    scripts,
+    prompts: []
+  };
+  
+  const manifestPath = path.join(skillsDst, '.agentic-manifest.json');
+  fs.writeFileSync(manifestPath, JSON.stringify(manifest, null, 2) + '\n');
+  console.log(`📑 Provenance manifest → ${manifestPath}`);
+}
+
+/**
+ * Main installation
+ */
+function install(): void {
+  // Read version from package.json
+  const packageJsonPath = path.join(srcDir, 'package.json');
+  let version = 'unknown';
+  if (fs.existsSync(packageJsonPath)) {
+    try {
+      const pkg = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
+      version = pkg.version || 'unknown';
+    } catch (e) {}
+  }
+  
+  console.log(`🔧 Installing agentic v${version}...\n`);
+  
+  installSkills();
+  installScripts();
+  installAgentsMd();
+  createReportsDir();
+  writeProvenanceManifest(version);
+  
+  console.log('✅ Done!');
+}
+
+// Run
+install();

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@meyverick/agentic",
+  "version": "5.0.2",
+  "description": "AI agent skills and prompts for pi.dev",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/meyverick/agentic.git"
+  },
+  "files": [
+    "install.ts",
+    "skills",
+    "scripts",
+    "AGENTS.md",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "check-deps": "./scripts/check-deps.mjs",
+    "git-dl": "./scripts/git-dl.mjs"
+  },
+  "bin": {
+    "agentic": "install.ts",
+    "check-deps": "scripts/check-deps.mjs",
+    "git-dl": "scripts/git-dl.mjs"
+  },
+  "keywords": [
+    "ai",
+    "agents",
+    "skills",
+    "prompts",
+    "pi"
+  ],
+  "license": "MIT"
+}