agileflow 2.99.8 → 3.0.1

package/lib/skill-loader.js

@@ -0,0 +1,206 @@
+#!/usr/bin/env node
+/**
+ * skill-loader.js
+ *
+ * Skill metadata parser and loader for enhanced skills (EP-0033 Story 4).
+ *
+ * Skills can now include frontmatter metadata:
+ * ---
+ * type: skill
+ * name: my-skill
+ * model: haiku
+ * category: database
+ * version: 1.0.0
+ * ---
+ *
+ * This module:
+ * - Parses skill frontmatter from SKILL.md files
+ * - Discovers all installed skills with metadata
+ * - Filters skills by category or model
+ * - Provides skill recommendations based on context
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+/**
+ * Parse frontmatter from a SKILL.md file.
+ * Supports YAML-like frontmatter between --- delimiters.
+ *
+ * @param {string} content - File content
+ * @returns {Object} { metadata: {...}, body: "..." }
+ */
+function parseSkillFrontmatter(content) {
+  const result = { metadata: {}, body: content };
+
+  if (!content || !content.startsWith('---')) {
+    return result;
+  }
+
+  const endIndex = content.indexOf('---', 3);
+  if (endIndex === -1) {
+    return result;
+  }
+
+  const frontmatterBlock = content.substring(3, endIndex).trim();
+  result.body = content.substring(endIndex + 3).trim();
+
+  // Simple YAML-like parsing (no dependency on js-yaml)
+  for (const line of frontmatterBlock.split('\n')) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith('#')) continue;
+
+    const colonIndex = trimmed.indexOf(':');
+    if (colonIndex === -1) continue;
+
+    const key = trimmed.substring(0, colonIndex).trim();
+    let value = trimmed.substring(colonIndex + 1).trim();
+
+    // Remove surrounding quotes
+    if ((value.startsWith('"') && value.endsWith('"')) ||
+        (value.startsWith("'") && value.endsWith("'"))) {
+      value = value.slice(1, -1);
+    }
+
+    // Type coercion for known fields
+    if (key === 'version' || key === 'model' || key === 'category' || key === 'name' || key === 'type') {
+      result.metadata[key] = value;
+    } else if (value === 'true') {
+      result.metadata[key] = true;
+    } else if (value === 'false') {
+      result.metadata[key] = false;
+    } else {
+      result.metadata[key] = value;
+    }
+  }
+
+  return result;
+}
+
+/**
+ * Load a single skill from its directory.
+ *
+ * @param {string} skillDir - Path to skill directory
+ * @returns {Object|null} Skill info or null if invalid
+ */
+function loadSkill(skillDir) {
+  const skillMdPath = path.join(skillDir, 'SKILL.md');
+
+  if (!fs.existsSync(skillMdPath)) {
+    return null;
+  }
+
+  try {
+    const content = fs.readFileSync(skillMdPath, 'utf8');
+    const { metadata, body } = parseSkillFrontmatter(content);
+
+    // Extract description from frontmatter or first paragraph
+    let description = metadata.description || '';
+    if (!description && body) {
+      // Try to get description from first non-empty line after title
+      const lines = body.split('\n');
+      for (const line of lines) {
+        const trimmed = line.trim();
+        if (trimmed && !trimmed.startsWith('#') && !trimmed.startsWith('---')) {
+          description = trimmed;
+          break;
+        }
+      }
+    }
+
+    return {
+      name: metadata.name || path.basename(skillDir),
+      type: metadata.type || 'skill',
+      model: metadata.model || null,
+      category: metadata.category || null,
+      version: metadata.version || null,
+      description,
+      path: skillDir,
+      hasReferences: fs.existsSync(path.join(skillDir, 'references.md')),
+      hasCookbook: fs.existsSync(path.join(skillDir, 'cookbook')),
+      hasMcp: fs.existsSync(path.join(skillDir, '.mcp.json')),
+      metadata,
+    };
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Discover all installed skills.
+ *
+ * @param {string} rootDir - Project root directory
+ * @returns {Object[]} Array of skill info objects
+ */
+function discoverSkills(rootDir) {
+  const skills = [];
+  const skillsDirs = [
+    path.join(rootDir, '.claude', 'skills'),
+    path.join(rootDir, '.agileflow', 'skills'),
+  ];
+
+  for (const skillsDir of skillsDirs) {
+    if (!fs.existsSync(skillsDir)) continue;
+
+    try {
+      const entries = fs.readdirSync(skillsDir, { withFileTypes: true });
+      for (const entry of entries) {
+        if (!entry.isDirectory()) continue;
+
+        const skill = loadSkill(path.join(skillsDir, entry.name));
+        if (skill) {
+          skills.push(skill);
+        }
+      }
+    } catch {
+      // Silently continue
+    }
+  }
+
+  return skills;
+}
+
+/**
+ * Filter skills by category.
+ *
+ * @param {Object[]} skills - Array of skill info objects
+ * @param {string} category - Category to filter by
+ * @returns {Object[]} Filtered skills
+ */
+function filterByCategory(skills, category) {
+  return skills.filter(s => s.category === category);
+}
+
+/**
+ * Filter skills by model preference.
+ *
+ * @param {Object[]} skills - Array of skill info objects
+ * @param {string} model - Model to filter by (haiku, sonnet, opus)
+ * @returns {Object[]} Filtered skills
+ */
+function filterByModel(skills, model) {
+  return skills.filter(s => s.model === model);
+}
+
+/**
+ * Get a formatted skill summary for display.
+ *
+ * @param {Object} skill - Skill info object
+ * @returns {string} Formatted summary line
+ */
+function formatSkillSummary(skill) {
+  const parts = [skill.name];
+  if (skill.category) parts.push(`[${skill.category}]`);
+  if (skill.model) parts.push(`(${skill.model})`);
+  if (skill.version) parts.push(`v${skill.version}`);
+  return parts.join(' ');
+}
+
+module.exports = {
+  parseSkillFrontmatter,
+  loadSkill,
+  discoverSkills,
+  filterByCategory,
+  filterByModel,
+  formatSkillSummary,
+};

package/lib/smart-json-file.js

@@ -427,13 +427,11 @@ class SmartJsonFile {
     debugLog('modify', { filePath: this.filePath });
 
     // Read current data
-    const readResult = await this.read();
+    let readResult = await this.read();
     if (!readResult.ok) {
       // If file doesn't exist but we have a default value, use that
       if (readResult.error?.errorCode === 'ENOENT' && this.defaultValue !== undefined) {
-        readResult.ok = true;
-        readResult.data = this.defaultValue;
-        delete readResult.error;
+        readResult = success(this.defaultValue);
       } else {
         return readResult;
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agileflow",
-  "version": "2.99.8",
+  "version": "3.0.1",
   "description": "AI-driven agile development system for Claude Code, Cursor, Windsurf, and more",
   "keywords": [
     "agile",

package/scripts/agileflow-configure.js

@@ -45,6 +45,7 @@ const {
 } = require('./lib/configure-features');
 const { listScripts, showVersionInfo, repairScripts } = require('./lib/configure-repair');
 const { feedback } = require('../lib/feedback');
+const { tryOptional } = require('../lib/errors');
 
 // ============================================================================
 // VERSION
@@ -52,31 +53,31 @@ const { feedback } = require('../lib/feedback');
 
 function getVersion() {
   // Try agileflow-metadata.json first
-  try {
+  const metaVersion = tryOptional(() => {
     const metaPath = path.join(process.cwd(), 'docs/00-meta/agileflow-metadata.json');
     if (fs.existsSync(metaPath)) {
-      const meta = JSON.parse(fs.readFileSync(metaPath, 'utf8'));
-      if (meta.version) return meta.version;
+      return JSON.parse(fs.readFileSync(metaPath, 'utf8')).version;
     }
-  } catch {}
+  }, 'read metadata version');
+  if (metaVersion) return metaVersion;
 
   // Try .agileflow/package.json
-  try {
+  const agileflowVersion = tryOptional(() => {
     const pkgPath = path.join(process.cwd(), '.agileflow/package.json');
     if (fs.existsSync(pkgPath)) {
-      const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
-      if (pkg.version) return pkg.version;
+      return JSON.parse(fs.readFileSync(pkgPath, 'utf8')).version;
     }
-  } catch {}
+  }, 'read agileflow package version');
+  if (agileflowVersion) return agileflowVersion;
 
   // Fallback to script's own package.json
-  try {
+  const pkgVersion = tryOptional(() => {
     const pkgPath = path.join(__dirname, '..', 'package.json');
     if (fs.existsSync(pkgPath)) {
-      const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
-      if (pkg.version) return pkg.version;
+      return JSON.parse(fs.readFileSync(pkgPath, 'utf8')).version;
     }
-  } catch {}
+  }, 'read package version');
+  if (pkgVersion) return pkgVersion;
 
   return 'unknown';
 }

package/scripts/agileflow-statusline.sh

@@ -87,6 +87,7 @@ SHOW_CONTEXT_BAR=true
 SHOW_SESSION_TIME=false
 SHOW_COST=false
 SHOW_GIT=true
+SHOW_SCALE=true
 
 # Check agileflow-metadata.json for component settings
 if [ -f "docs/00-meta/agileflow-metadata.json" ]; then
@@ -104,6 +105,7 @@ if [ -f "docs/00-meta/agileflow-metadata.json" ]; then
     SHOW_SESSION_TIME=$(echo "$COMPONENTS" | jq -r '.session_time | if . == null then true else . end')
     SHOW_COST=$(echo "$COMPONENTS" | jq -r '.cost | if . == null then true else . end')
     SHOW_GIT=$(echo "$COMPONENTS" | jq -r '.git | if . == null then true else . end')
+    SHOW_SCALE=$(echo "$COMPONENTS" | jq -r '.scale | if . == null then true else . end')
   fi
 fi
 
@@ -645,6 +647,28 @@ if [ "$SHOW_SESSION" = "true" ]; then
   fi
 fi
 
+# ============================================================================
+# Scale Detection (EP-0033: Scale-Adaptive Workflows)
+# ============================================================================
+# Reads cached scale from session-state.json (written by welcome hook)
+SCALE_DISPLAY=""
+if [ "$SHOW_SCALE" = "true" ] && [ -f "docs/09-agents/session-state.json" ]; then
+  DETECTED_SCALE=$(jq -r '.scale_detection.scale // empty' docs/09-agents/session-state.json 2>/dev/null)
+  if [ -n "$DETECTED_SCALE" ] && [ "$DETECTED_SCALE" != "null" ]; then
+    case "$DETECTED_SCALE" in
+      micro)      SCALE_COLOR="$CYAN";  SCALE_ICON="◦" ;;
+      small)      SCALE_COLOR="$CYAN";  SCALE_ICON="○" ;;
+      medium)     SCALE_COLOR="$GREEN"; SCALE_ICON="◎" ;;
+      large)      SCALE_COLOR="$YELLOW"; SCALE_ICON="●" ;;
+      enterprise) SCALE_COLOR="$RED";   SCALE_ICON="◉" ;;
+      *)          SCALE_COLOR="$DIM";   SCALE_ICON="◎" ;;
+    esac
+    # Capitalize first letter
+    SCALE_LABEL="$(echo "$DETECTED_SCALE" | sed 's/^./\U&/')"
+    SCALE_DISPLAY="${SCALE_COLOR}${SCALE_ICON}${SCALE_LABEL}${RESET}"
+  fi
+fi
+
 # ============================================================================
 # Build Status Line
 # ============================================================================
@@ -729,6 +753,12 @@ if [ "$SHOW_GIT" = "true" ] && [ -n "$GIT_DISPLAY" ]; then
   OUTPUT="${OUTPUT}${GIT_DISPLAY}"
 fi
 
+# Add scale indicator (if enabled)
+if [ "$SHOW_SCALE" = "true" ] && [ -n "$SCALE_DISPLAY" ]; then
+  [ -n "$OUTPUT" ] && OUTPUT="${OUTPUT}${SEP}"
+  OUTPUT="${OUTPUT}${SCALE_DISPLAY}"
+fi
+
 # Session health indicator (next to git branch)
 if [ "$SHOW_SESSION" = "true" ]; then
   SCRIPTS_DIR="$(dirname "$0")"