@itz4blitz/agentful 0.2.1 → 0.3.0

package/bin/hooks/health-check.sh

@@ -8,29 +8,29 @@ set -e
 
 # Check if .agentful directory exists
 if [ ! -d ".agentful" ]; then
-  echo "Agentful not initialized. Run /agentful-start to set up."
+  echo "Agentful not initialized. Run: npx @itz4blitz/agentful init"
   exit 0
 fi
 
-# Check for critical files
-WARNINGS=()
-
+# Check if this is a fresh init (no architecture.json means analysis hasn't run)
 if [ ! -f ".agentful/architecture.json" ]; then
-  WARNINGS+=("Architecture config missing. Run /agentful-analyze to detect tech stack.")
+  echo "Agentful initialized but not analyzed."
+  echo ""
+  echo "Run /agentful-generate to:"
+  echo "  - Detect your tech stack"
+  echo "  - Discover business domains"
+  echo "  - Generate specialized agents and skills"
+  exit 0
 fi
 
-if [ ! -f "package.json" ] && [ ! -f "pyproject.toml" ] && [ ! -f "go.mod" ] && [ ! -f "Cargo.toml" ]; then
-  WARNINGS+=("No package manager config found. Project structure unclear.")
-fi
+# Check for generated agents
+AGENT_COUNT=$(find .claude/agents -name "*.md" 2>/dev/null | wc -l | tr -d ' ')
+SKILL_COUNT=$(find .claude/skills -name "SKILL.md" 2>/dev/null | wc -l | tr -d ' ')
 
-# Output any warnings
-if [ ${#WARNINGS[@]} -gt 0 ]; then
-  echo "Agentful Health Check:"
-  for warning in "${WARNINGS[@]}"; do
-    echo "  - $warning"
-  done
-else
-  echo "Agentful ready."
+if [ "$AGENT_COUNT" -lt 3 ] || [ "$SKILL_COUNT" -lt 1 ]; then
+  echo "Agentful ready. Consider running /agentful-generate to generate more agents/skills."
+  exit 0
 fi
 
+echo "Agentful ready."
 exit 0

package/lib/index.js

@@ -1,40 +1,10 @@
-#!/usr/bin/env node
-
 /**
- * agentful Analysis Engine
- * Smart project analysis for autonomous development
+ * agentful - Lightweight project initialization
  *
- * @module agentful/analyzer
- */
-
-export { analyzeProject, exportToArchitectureJson } from './project-analyzer.js';
-export { detectDomains, getDomainKeywords, getAllDomains, addCustomDomainPattern } from './domain-detector.js';
-export { detectTechStack } from './tech-stack-detector.js';
-
-/**
- * Main entry point for project analysis
- * @param {string} projectRoot - Root directory of the project to analyze
- * @returns {Promise<Object>} Comprehensive project analysis
- */
-export async function analyze(projectRoot) {
-  return await analyzeProject(projectRoot);
-}
-
-/**
- * Quick tech stack detection
- * @param {string} projectRoot - Root directory of the project
- * @returns {Promise<Object>} Detected tech stack
+ * The heavy analysis is done by Claude via /agentful-agents and /agentful-skills commands.
+ * This module just handles template copying and state management.
+ *
+ * @module agentful
  */
-export async function detectStack(projectRoot) {
-  return await detectTechStack(projectRoot);
-}
 
-/**
- * Domain detection
- * @param {string} projectRoot - Root directory of the project
- * @param {Object} quickScan - Optional quick scan results
- * @returns {Promise<Object>} Detected domains with confidence scores
- */
-export async function detectBusinessDomains(projectRoot, quickScan) {
-  return await detectDomains(projectRoot, quickScan);
-}
+export { initProject, copyDirectory, isInitialized, getState } from './init.js';

package/lib/init.js

@@ -0,0 +1,162 @@
+import fs from 'fs/promises';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const TEMPLATE_DIR = path.join(__dirname, '..', 'template');
+const CLAUDE_DIR = path.join(__dirname, '..', '.claude');
+
+/**
+ * Initialize agentful in a target project directory
+ * @param {string} targetDir - Target project directory
+ * @param {Object} options - Initialization options
+ * @param {boolean} options.includeProduct - Whether to include PRODUCT.md template
+ * @returns {Promise<{success: boolean, files: string[]}>}
+ */
+export async function initProject(targetDir, options = {}) {
+  const { includeProduct = false } = options;
+  const createdFiles = [];
+
+  try {
+    // Ensure target directory exists
+    await fs.access(targetDir);
+
+    // 1. Copy .claude/ directory (agents, skills, commands)
+    const claudeTargetDir = path.join(targetDir, '.claude');
+
+    try {
+      await fs.access(CLAUDE_DIR);
+      await copyDirectory(CLAUDE_DIR, claudeTargetDir);
+      createdFiles.push('.claude/');
+    } catch (err) {
+      // .claude directory doesn't exist in package, skip
+    }
+
+    // 2. Copy CLAUDE.md template
+    const claudeMdSource = path.join(TEMPLATE_DIR, 'CLAUDE.md');
+    const claudeMdTarget = path.join(targetDir, 'CLAUDE.md');
+
+    try {
+      await fs.access(claudeMdSource);
+      await fs.copyFile(claudeMdSource, claudeMdTarget);
+      createdFiles.push('CLAUDE.md');
+    } catch (err) {
+      // CLAUDE.md template doesn't exist, skip
+    }
+
+    // 3. Create .agentful/ directory with state files
+    const agentfulDir = path.join(targetDir, '.agentful');
+    await fs.mkdir(agentfulDir, { recursive: true });
+    createdFiles.push('.agentful/');
+
+    // Create state.json
+    const stateFile = path.join(agentfulDir, 'state.json');
+    const initialState = {
+      initialized: new Date().toISOString(),
+      version: '1.0.0',
+      agents: [],
+      skills: []
+    };
+    await fs.writeFile(stateFile, JSON.stringify(initialState, null, 2));
+    createdFiles.push('.agentful/state.json');
+
+    // Create completion.json
+    const completionFile = path.join(agentfulDir, 'completion.json');
+    const initialCompletion = {
+      agents: {},
+      skills: {},
+      lastUpdated: new Date().toISOString()
+    };
+    await fs.writeFile(completionFile, JSON.stringify(initialCompletion, null, 2));
+    createdFiles.push('.agentful/completion.json');
+
+    // Create decisions.json
+    const decisionsFile = path.join(agentfulDir, 'decisions.json');
+    const initialDecisions = {
+      decisions: [],
+      lastUpdated: new Date().toISOString()
+    };
+    await fs.writeFile(decisionsFile, JSON.stringify(initialDecisions, null, 2));
+    createdFiles.push('.agentful/decisions.json');
+
+    // 4. Optionally copy PRODUCT.md template
+    if (includeProduct) {
+      const productMdSource = path.join(TEMPLATE_DIR, 'PRODUCT.md');
+      const productMdTarget = path.join(targetDir, 'PRODUCT.md');
+
+      try {
+        await fs.access(productMdSource);
+        await fs.copyFile(productMdSource, productMdTarget);
+        createdFiles.push('PRODUCT.md');
+      } catch (err) {
+        // PRODUCT.md template doesn't exist, skip
+      }
+    }
+
+    return {
+      success: true,
+      files: createdFiles
+    };
+  } catch (error) {
+    throw new Error(`Failed to initialize project: ${error.message}`);
+  }
+}
+
+/**
+ * Recursively copy a directory
+ * @param {string} src - Source directory
+ * @param {string} dest - Destination directory
+ */
+export async function copyDirectory(src, dest) {
+  // Create destination directory
+  await fs.mkdir(dest, { recursive: true });
+
+  // Read source directory
+  const entries = await fs.readdir(src, { withFileTypes: true });
+
+  for (const entry of entries) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+
+    if (entry.isDirectory()) {
+      // Recursively copy subdirectory
+      await copyDirectory(srcPath, destPath);
+    } else {
+      // Copy file
+      await fs.copyFile(srcPath, destPath);
+    }
+  }
+}
+
+/**
+ * Check if project is already initialized
+ * @param {string} targetDir - Target project directory
+ * @returns {Promise<boolean>}
+ */
+export async function isInitialized(targetDir) {
+  const agentfulDir = path.join(targetDir, '.agentful');
+  const stateFile = path.join(agentfulDir, 'state.json');
+
+  try {
+    await fs.access(stateFile);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Get current state from .agentful/state.json
+ * @param {string} targetDir - Target project directory
+ * @returns {Promise<Object|null>}
+ */
+export async function getState(targetDir) {
+  const stateFile = path.join(targetDir, '.agentful', 'state.json');
+
+  try {
+    const content = await fs.readFile(stateFile, 'utf-8');
+    return JSON.parse(content);
+  } catch {
+    return null;
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@itz4blitz/agentful",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "Human-in-the-loop development kit for Claude Code with smart product analysis and natural conversation",
   "type": "module",
   "bin": {
@@ -23,7 +23,6 @@
     "bin/",
     "lib/",
     "template/",
-    "templates/",
     ".claude/",
     "version.json",
     "LICENSE"

package/version.json

@@ -1,3 +1,3 @@
 {
-  "version": "0.2.0"
+  "version": "0.2.1"
 }