arreio 1.0.1 → 1.0.2-dev.0

package/README.md

@@ -17,9 +17,7 @@ Install Arreio as a dependency to enable all skills in your workspace:
 npm install arreio
 ```
 
-The post-install script will automatically copy all Arreio skills to your `~/.agents/skills/` directory, making them available in VS Code Copilot Chat. (Note: npm may show an advisory about unallowed install scripts—this is informational and won't block the installation.)
-
-Then initialize your project to set up the Arreio folder structure and documentation:
+Then initialize your project to set up Arreio workflows:
 
 ```
 /arreio-init
@@ -27,7 +25,7 @@ Then initialize your project to set up the Arreio folder structure and documenta
 
 Run this command in VS Code Copilot Chat to:
 
-1. Verify or manually install Arreio skills to `~/.agents/skills/` (if postinstall was skipped)
+1. Copy all Arreio skills to your `~/.agents/skills/` directory
 2. Create the project structure (`docs/plans/`, `docs/learn/`, etc.)
 3. Set up architectural documentation and index files
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arreio",
-  "version": "1.0.1",
+  "version": "1.0.2-dev.0",
   "description": "Arreio transforms agentic coding workflows into a predictable, safe, and high-quality software delivery pipeline. Master the four core phases—Plan, Work, Review, Learn—to orchestrate a highly reliable development cycle.",
   "license": "MIT",
   "author": "Wicttor",
@@ -27,12 +27,8 @@
   "main": "README.md",
   "files": [
     "skills/",
-    "scripts/",
     "README.md"
   ],
-  "scripts": {
-    "postinstall": "node scripts/postinstall.js"
-  },
   "engines": {
     "node": ">=14.0.0"
   },

package/skills/arreio-init/SKILL.md

@@ -35,18 +35,16 @@ After initialization, the following modules can operate:
 
 The initialization workflow runs in two phases:
 
-1. **Phase 0: Install Skills (Optional)** — Verify or manually copy Arreio skills to `~/.agents/skills/` (skills are normally installed via npm postinstall, but this phase can install them as a fallback)
+1. **Phase 0: Install Skills** — Copy Arreio skills to `~/.agents/skills/` for VS Code Copilot Chat discovery
 2. **Phase 1: Initialize Project Structure** — Create folders, indexes, and architectural documentation
 
-### Step 1: Install Skills (Optional Fallback)
+### Step 1: Install Skills
 
-Verify that Arreio skills are installed to the user's `.agents/skills` directory. See [modules/install.md](modules/install.md) for detailed instructions.
+Install Arreio skills to the user's `.agents/skills` directory. See [modules/install.md](modules/install.md) for detailed instructions.
 
-**Why:** Skills must be available in `~/.agents/skills/` for VS Code Copilot Chat discovery. Normally, the npm postinstall script handles this automatically when you run `npm install arreio`. This step provides a manual fallback if postinstall was skipped.
+**Why:** Skills must be copied from the installed npm package to the user's home directory so they are discoverable by VS Code Copilot Chat. This step must run first, before project structure is created.
 
-**When to run:** Skip this step if npm postinstall has already run. If skills are not yet installed, this phase will copy them from `node_modules/arreio/skills/` to `~/.agents/skills/`.
-
-**Action:** See [install.md](modules/install.md) for verification and manual installation steps.
+**Action:** Execute the [install.md](modules/install.md) phase to copy all skills from `node_modules/arreio/skills/` to `~/.agents/skills/`.
 
 ### Step 2: Create Core Folder Structure
 

package/skills/arreio-init/modules/install.md

@@ -1,37 +1,22 @@
 ---
 title: Install Skills
-description: Verify or manually install Arreio skills to the user's .agents/skills directory, providing a fallback if npm postinstall was skipped.
+description: Install Arreio skills to the user's .agents/skills directory, making them available in VS Code Copilot Chat.
 type: module
 version: 1.0
 timestamp: "2026-09-01"
 ---
 
-# Phase 0 - Install Skills (Fallback)
+# Phase 0 - Install Skills
 
-**Purpose:** Verify that Arreio skills are installed to the user's `~/.agents/skills/` directory, making them available for discovery and invocation in VS Code Copilot Chat. This is normally handled by the npm postinstall script, but this phase provides a manual fallback if postinstall was skipped or if users need to reinstall skills.
+**Purpose:** Copy Arreio skills from the installed npm package to the user's `~/.agents/skills/` directory, making them available for discovery and invocation in VS Code Copilot Chat. This ensures all Arreio workflows (plan, work, review, learn, end-session) are accessible after initialization.
 
 ## Workflow
 
-This is the Phase 0 pipeline for the Arreio Init Skill. It performs verification and optional installation before creating project structure.
+This is the Phase 0 pipeline for the Arreio Init Skill. It orchestrates the following steps before creating project structure.
 
-### Step 1: Check if Skills Already Installed
+### Step 1: Verify Installation Context
 
-First, verify that Arreio skills are already available:
-
-1. Check if `~/.agents/skills/` directory exists and contains the expected skill folders (plan, work, review, learn, end-session, arreio-init).
-2. If all skills are present and current, log success and skip to project structure initialization (Step 2).
-3. If skills are missing or incomplete, proceed to Step 2.
-
-**Result:**
-
-- ✓ Skills already installed → Skip to project structure
-- ✗ Skills missing → Proceed to manual installation
-
-### Step 2: Verify Installation Context (if needed)
-
-### Step 2: Verify Installation Context (if needed)
-
-Verify that the prerequisites are met if skills need to be installed:
+Verify that the prerequisites are met:
 
 1. Arreio is installed as an npm package in the current project (`node_modules/arreio/` exists).
 2. The skills directory exists in the package: `node_modules/arreio/skills/` contains subdirectories for each skill.
@@ -43,7 +28,7 @@ If any verification fails:
 - **Missing skills:** Report a package integrity error (the skills/ directory is missing from the installed package).
 - **No home access:** Report an environment error (unable to determine home directory).
 
-### Step 3: Create Target Directory
+### Step 2: Create Target Directory
 
 Create the destination directory hierarchy:
 
@@ -51,7 +36,7 @@ Create the destination directory hierarchy:
 2. If `~/.agents/skills/` does not exist, create it.
 3. Log: `✓ Created ~/.agents/skills/`
 
-### Step 4: Copy Skills from Package
+### Step 3: Copy Skills from Package
 
 Copy each skill directory from `node_modules/arreio/skills/` to `~/.agents/skills/`:
 
@@ -79,7 +64,7 @@ If any copy operation fails:
 - Ask the user to manually verify the source exists and the destination is writable.
 - Do not proceed to the next phase.
 
-### Step 5: Verify Installation Success
+### Step 4: Verify Installation Success
 
 After all skills are copied, verify that the expected skill files are present:
 
@@ -104,14 +89,14 @@ Skills are now available in VS Code Copilot Chat.
 
 If verification fails for any skill, report which skills failed and suggest manual verification.
 
-### Step 6: Log Installation Summary
+### Step 5: Log Installation Summary
 
 Provide the user with confirmation and next steps:
 
 ```
 Installation complete. Arreio skills are now available:
 
-Next step: Project structure will be initialized in the next phase of arreio-init.
+Next step: Project structure will be initialized in Step 1 of arreio-init.
 
 You can now use:
   /plan    — Create implementation plans

package/scripts/postinstall.js

@@ -1,50 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Post-install script for arreio
- * Copies skills from the package to the user's .agents/skills directory
- */
-
-const fs = require('fs');
-const path = require('path');
-const os = require('os');
-
-// Determine the source and destination paths
-const packageDir = path.dirname(__dirname);
-const skillsSource = path.join(packageDir, 'skills');
-const agentsDir = path.join(os.homedir(), '.agents');
-const skillsDestination = path.join(agentsDir, 'skills');
-
-// Function to recursively copy directories
-function copyDirectory(src, dest) {
-  if (!fs.existsSync(dest)) {
-    fs.mkdirSync(dest, { recursive: true });
-  }
-
-  const files = fs.readdirSync(src);
-  files.forEach(file => {
-    const srcFile = path.join(src, file);
-    const destFile = path.join(dest, file);
-    const stat = fs.statSync(srcFile);
-
-    if (stat.isDirectory()) {
-      copyDirectory(srcFile, destFile);
-    } else {
-      fs.copyFileSync(srcFile, destFile);
-    }
-  });
-}
-
-try {
-  // Create .agents directory if it doesn't exist
-  if (!fs.existsSync(agentsDir)) {
-    fs.mkdirSync(agentsDir, { recursive: true });
-  }
-
-  // Copy skills to .agents/skills
-  copyDirectory(skillsSource, skillsDestination);
-  console.log(`✓ Arreio skills installed to ${skillsDestination}`);
-} catch (error) {
-  console.error(`✗ Failed to install Arreio skills: ${error.message}`);
-  process.exit(1);
-}