@mindfoldhq/trellis 0.1.9 → 0.2.2

package/dist/utils/template-hash.js

@@ -0,0 +1,234 @@
+/**
+ * Template hash utilities for detecting user modifications
+ *
+ * Stores SHA256 hashes of template files at install time.
+ * Used to determine if users have modified templates.
+ */
+import { createHash } from "node:crypto";
+import fs from "node:fs";
+import path from "node:path";
+import { DIR_NAMES } from "../constants/paths.js";
+/** File name for storing template hashes */
+const HASHES_FILE = ".template-hashes.json";
+/**
+ * Compute SHA256 hash of content
+ */
+export function computeHash(content) {
+    return createHash("sha256").update(content, "utf-8").digest("hex");
+}
+/**
+ * Get path to the hashes file
+ */
+function getHashesPath(cwd) {
+    return path.join(cwd, DIR_NAMES.WORKFLOW, HASHES_FILE);
+}
+/**
+ * Load stored template hashes
+ */
+export function loadHashes(cwd) {
+    const hashesPath = getHashesPath(cwd);
+    if (!fs.existsSync(hashesPath)) {
+        return {};
+    }
+    try {
+        const content = fs.readFileSync(hashesPath, "utf-8");
+        return JSON.parse(content);
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Save template hashes
+ */
+export function saveHashes(cwd, hashes) {
+    const hashesPath = getHashesPath(cwd);
+    fs.writeFileSync(hashesPath, JSON.stringify(hashes, null, 2));
+}
+/**
+ * Update hashes for specific files
+ *
+ * @param cwd - Working directory
+ * @param files - Map of relative paths to file contents
+ */
+export function updateHashes(cwd, files) {
+    const hashes = loadHashes(cwd);
+    for (const [relativePath, content] of files) {
+        hashes[relativePath] = computeHash(content);
+    }
+    saveHashes(cwd, hashes);
+}
+/**
+ * Update hash for a single file by reading its current content
+ */
+export function updateHashFromFile(cwd, relativePath) {
+    const fullPath = path.join(cwd, relativePath);
+    if (!fs.existsSync(fullPath)) {
+        return;
+    }
+    const content = fs.readFileSync(fullPath, "utf-8");
+    const hashes = loadHashes(cwd);
+    hashes[relativePath] = computeHash(content);
+    saveHashes(cwd, hashes);
+}
+/**
+ * Remove hash entry for a file (e.g., after deletion)
+ */
+export function removeHash(cwd, relativePath) {
+    const hashes = loadHashes(cwd);
+    const { [relativePath]: _, ...rest } = hashes;
+    saveHashes(cwd, rest);
+}
+/**
+ * Rename hash entry (used after file rename)
+ */
+export function renameHash(cwd, oldPath, newPath) {
+    const hashes = loadHashes(cwd);
+    if (hashes[oldPath]) {
+        const { [oldPath]: oldValue, ...rest } = hashes;
+        rest[newPath] = oldValue;
+        saveHashes(cwd, rest);
+    }
+}
+/**
+ * Check if a template file has been modified by the user
+ *
+ * @param cwd - Working directory
+ * @param relativePath - Relative path to the file
+ * @param hashes - Stored template hashes
+ * @returns true if file has been modified from template, false otherwise
+ */
+export function isTemplateModified(cwd, relativePath, hashes) {
+    const fullPath = path.join(cwd, relativePath);
+    // If file doesn't exist, can't be modified
+    if (!fs.existsSync(fullPath)) {
+        return false;
+    }
+    // If we don't have a stored hash, assume it's modified (conservative)
+    const storedHash = hashes[relativePath];
+    if (!storedHash) {
+        return true;
+    }
+    // Compare current content hash with stored hash
+    const currentContent = fs.readFileSync(fullPath, "utf-8");
+    const currentHash = computeHash(currentContent);
+    return currentHash !== storedHash;
+}
+/**
+ * Check if a file matches its original template content
+ * (Useful for determining if a file can be safely auto-migrated)
+ *
+ * @param cwd - Working directory
+ * @param relativePath - Relative path to the file
+ * @param originalContent - Original template content
+ * @returns true if file matches original template
+ */
+export function matchesOriginalTemplate(cwd, relativePath, originalContent) {
+    const fullPath = path.join(cwd, relativePath);
+    if (!fs.existsSync(fullPath)) {
+        return false;
+    }
+    const currentContent = fs.readFileSync(fullPath, "utf-8");
+    return currentContent === originalContent;
+}
+/**
+ * Get modification status for multiple files
+ *
+ * @param cwd - Working directory
+ * @param relativePaths - Array of relative paths to check
+ * @param hashes - Stored template hashes
+ * @returns Map of path to modification status
+ */
+export function getModificationStatus(cwd, relativePaths, hashes) {
+    const result = new Map();
+    for (const relativePath of relativePaths) {
+        result.set(relativePath, isTemplateModified(cwd, relativePath, hashes));
+    }
+    return result;
+}
+/**
+ * Directories to scan for template files during init
+ */
+const TEMPLATE_DIRS = [".trellis", ".claude", ".cursor"];
+/**
+ * Patterns to exclude from hash tracking
+ */
+const EXCLUDE_FROM_HASH = [
+    ".template-hashes.json", // Hash file itself
+    ".version", // Version file
+    ".gitignore", // Git ignore files
+    ".developer/", // Developer-specific files
+    "workspace/", // Workspace files
+    "tasks/", // Task files
+    "agent-traces/", // Agent trace files
+    "backlog/", // Backlog files
+    ".current-task/", // Current task marker
+    "spec/frontend/", // User-filled spec files
+    "spec/backend/", // User-filled spec files
+    ".backup-", // Backup directories
+];
+/**
+ * Check if a path should be excluded from hash tracking
+ */
+function shouldExcludeFromHash(relativePath) {
+    for (const pattern of EXCLUDE_FROM_HASH) {
+        if (relativePath.includes(pattern)) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Recursively collect all files in a directory
+ */
+function collectFiles(cwd, dir, relativeTo = "") {
+    const fullDir = path.join(cwd, dir);
+    if (!fs.existsSync(fullDir)) {
+        return [];
+    }
+    const files = [];
+    const entries = fs.readdirSync(fullDir, { withFileTypes: true });
+    for (const entry of entries) {
+        const relativePath = path.join(dir, entry.name);
+        if (shouldExcludeFromHash(relativePath)) {
+            continue;
+        }
+        if (entry.isDirectory()) {
+            files.push(...collectFiles(cwd, relativePath, relativeTo));
+        }
+        else if (entry.isFile()) {
+            files.push(relativePath);
+        }
+    }
+    return files;
+}
+/**
+ * Initialize template hashes after init
+ *
+ * Scans all template directories and computes hashes for files.
+ * This should be called at the end of `trellis init` to enable
+ * modification detection on subsequent updates.
+ *
+ * @param cwd - Working directory
+ * @returns Number of files hashed
+ */
+export function initializeHashes(cwd) {
+    const hashes = {};
+    // Collect all template files
+    for (const dir of TEMPLATE_DIRS) {
+        const files = collectFiles(cwd, dir);
+        for (const relativePath of files) {
+            const fullPath = path.join(cwd, relativePath);
+            try {
+                const content = fs.readFileSync(fullPath, "utf-8");
+                hashes[relativePath] = computeHash(content);
+            }
+            catch {
+                // Skip files that can't be read (binary, etc.)
+            }
+        }
+    }
+    saveHashes(cwd, hashes);
+    return Object.keys(hashes).length;
+}
+//# sourceMappingURL=template-hash.js.map

package/dist/utils/template-hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-hash.js","sourceRoot":"","sources":["../../src/utils/template-hash.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mindfoldhq/trellis",
-  "version": "0.1.9",
+  "version": "0.2.2",
   "description": "AI capabilities grow like ivy — Trellis provides the structure to guide them along a disciplined path",
   "type": "module",
   "main": "./dist/index.js",

package/dist/templates/trellis/scripts/common/backlog.sh

@@ -1,220 +0,0 @@
-#!/bin/bash
-# Backlog utility functions
-#
-# Usage: source this file in other scripts
-#   source "$(dirname "$0")/common/backlog.sh"
-#
-# Provides:
-#   create_backlog_issue   - Create backlog JSON file
-#   delete_backlog_issue   - Delete backlog file
-#   list_backlog_issues    - List all backlog issues
-#   get_backlog_stats      - Get P0/P1/P2/P3 counts
-
-# Ensure paths.sh is loaded
-if ! type get_repo_root &>/dev/null; then
-  echo "Error: paths.sh must be sourced before backlog.sh" >&2
-  exit 1
-fi
-
-# =============================================================================
-# Helper Functions
-# =============================================================================
-
-# Convert title to slug (only works with ASCII)
-_slugify() {
-  local result=$(echo "$1" | tr '[:upper:]' '[:lower:]' | sed 's/[^a-z0-9]/-/g' | sed 's/--*/-/g' | sed 's/^-//' | sed 's/-$//')
-  echo "$result"
-}
-
-# Ensure backlog directory exists
-_ensure_backlog_dir() {
-  local repo_root="${1:-$(get_repo_root)}"
-  local backlog_dir=$(get_backlog_dir "$repo_root")
-  if [[ ! -d "$backlog_dir" ]]; then
-    mkdir -p "$backlog_dir"
-  fi
-}
-
-# =============================================================================
-# Public Functions
-# =============================================================================
-
-# Create a backlog issue
-# Args: title, assignee, priority, [slug], [description], [creator]
-# Returns: issue ID (e.g., "260119-my-feature")
-create_backlog_issue() {
-  local title="$1"
-  local assignee="$2"
-  local priority="${3:-P2}"
-  local slug="$4"
-  local description="${5:-}"
-  local creator="${6:-$assignee}"
-  local repo_root="${7:-$(get_repo_root)}"
-
-  # Validate required fields
-  if [[ -z "$title" ]] || [[ -z "$assignee" ]]; then
-    echo "Error: title and assignee are required" >&2
-    return 1
-  fi
-
-  # Validate priority
-  if [[ ! "$priority" =~ ^P[0-3]$ ]]; then
-    echo "Error: priority must be P0, P1, P2, or P3" >&2
-    return 1
-  fi
-
-  # Validate assignee exists
-  local assignee_dir="$repo_root/$DIR_WORKFLOW/$DIR_PROGRESS/$assignee"
-  if [[ ! -d "$assignee_dir" ]]; then
-    echo "Error: developer '$assignee' not found" >&2
-    return 1
-  fi
-
-  _ensure_backlog_dir "$repo_root"
-
-  # Generate slug if not provided
-  if [[ -z "$slug" ]]; then
-    slug=$(_slugify "$title")
-  fi
-
-  # Validate slug
-  if [[ -z "$slug" ]]; then
-    echo "Error: could not generate slug from title" >&2
-    return 1
-  fi
-
-  # Generate ID
-  local date_prefix=$(generate_backlog_id)
-  local id="${date_prefix}-${slug}"
-  local backlog_dir=$(get_backlog_dir "$repo_root")
-  local issue_file="$backlog_dir/${id}.json"
-
-  # Check if file exists
-  if [[ -f "$issue_file" ]]; then
-    echo "Error: issue already exists: ${id}.json" >&2
-    return 1
-  fi
-
-  # Create issue JSON
-  local created_at=$(date -Iseconds)
-  cat > "$issue_file" << EOF
-{
-  "id": "$id",
-  "title": "$title",
-  "description": "$description",
-  "priority": "$priority",
-  "status": "in_progress",
-  "assigned_to": "$assignee",
-  "created_by": "$creator",
-  "created_at": "$created_at"
-}
-EOF
-
-  # Return the ID
-  echo "$id"
-}
-
-# Complete a backlog issue (set status to done)
-# Args: backlog_ref (e.g., "260119-my-feature.json")
-complete_backlog_issue() {
-  local backlog_ref="$1"
-  local repo_root="${2:-$(get_repo_root)}"
-
-  if [[ -z "$backlog_ref" ]]; then
-    return 0
-  fi
-
-  local backlog_dir=$(get_backlog_dir "$repo_root")
-  local backlog_file="$backlog_dir/$backlog_ref"
-
-  if [[ -f "$backlog_file" ]]; then
-    local completed_at=$(date -Iseconds)
-    jq --arg completed_at "$completed_at" '.status = "done" | .completed_at = $completed_at' "$backlog_file" > "${backlog_file}.tmp"
-    mv "${backlog_file}.tmp" "$backlog_file"
-    return 0
-  fi
-
-  return 1
-}
-
-# Delete a backlog issue by filename
-# Args: backlog_ref (e.g., "260119-my-feature.json")
-delete_backlog_issue() {
-  local backlog_ref="$1"
-  local repo_root="${2:-$(get_repo_root)}"
-
-  if [[ -z "$backlog_ref" ]]; then
-    return 0
-  fi
-
-  local backlog_dir=$(get_backlog_dir "$repo_root")
-  local backlog_file="$backlog_dir/$backlog_ref"
-
-  if [[ -f "$backlog_file" ]]; then
-    rm -f "$backlog_file"
-    return 0
-  fi
-
-  return 1
-}
-
-# List backlog issues
-# Args: [filter_priority], [filter_status]
-# Output: formatted list to stdout
-list_backlog_issues() {
-  local filter_priority="$1"
-  local filter_status="$2"
-  local repo_root="${3:-$(get_repo_root)}"
-
-  local backlog_dir=$(get_backlog_dir "$repo_root")
-
-  if [[ ! -d "$backlog_dir" ]]; then
-    return 0
-  fi
-
-  for f in "$backlog_dir"/*.json; do
-    if [[ -f "$f" ]]; then
-      local id=$(jq -r '.id' "$f")
-      local title=$(jq -r '.title' "$f")
-      local priority=$(jq -r '.priority // "P2"' "$f")
-      local status=$(jq -r '.status // "open"' "$f")
-      local assignee=$(jq -r '.assigned_to' "$f")
-
-      # Apply filters
-      if [[ -n "$filter_priority" ]] && [[ "$priority" != "$filter_priority" ]]; then
-        continue
-      fi
-      if [[ -n "$filter_status" ]] && [[ "$status" != "$filter_status" ]]; then
-        continue
-      fi
-
-      echo "$priority|$id|$title|$status|$assignee"
-    fi
-  done
-}
-
-# Get backlog statistics
-# Output: "P0:N P1:N P2:N P3:N Total:N"
-get_backlog_stats() {
-  local repo_root="${1:-$(get_repo_root)}"
-  local backlog_dir=$(get_backlog_dir "$repo_root")
-
-  local p0=0 p1=0 p2=0 p3=0 total=0
-
-  if [[ -d "$backlog_dir" ]]; then
-    for f in "$backlog_dir"/*.json; do
-      if [[ -f "$f" ]]; then
-        local priority=$(jq -r '.priority // "P2"' "$f" 2>/dev/null)
-        case "$priority" in
-          P0) ((p0++)) ;;
-          P1) ((p1++)) ;;
-          P2) ((p2++)) ;;
-          P3) ((p3++)) ;;
-        esac
-        ((total++))
-      fi
-    done
-  fi
-
-  echo "P0:$p0 P1:$p1 P2:$p2 P3:$p3 Total:$total"
-}

package/dist/templates/trellis/scripts/common/feature-utils.sh

@@ -1,194 +0,0 @@
-#!/bin/bash
-# Feature utility functions
-#
-# Usage: source this file in other scripts
-#   source "$(dirname "$0")/common/feature-utils.sh"
-#
-# Provides:
-#   is_safe_feature_path     - Validate feature path is safe to operate on
-#   find_feature_by_name     - Find feature directory by name
-#   complete_feature_backlog - Complete linked backlog issue
-#   archive_feature_dir      - Archive feature to monthly directory
-
-# Ensure dependencies are loaded
-if ! type get_repo_root &>/dev/null; then
-  echo "Error: paths.sh must be sourced before feature-utils.sh" >&2
-  exit 1
-fi
-
-if ! type complete_backlog_issue &>/dev/null; then
-  echo "Error: backlog.sh must be sourced before feature-utils.sh" >&2
-  exit 1
-fi
-
-# =============================================================================
-# Path Safety
-# =============================================================================
-
-# Check if a relative feature path is safe to operate on
-# Args: feature_path (relative), repo_root
-# Returns: 0 if safe, 1 if dangerous
-# Outputs: error message to stderr if unsafe
-is_safe_feature_path() {
-  local feature_path="$1"
-  local repo_root="${2:-$(get_repo_root)}"
-
-  # Check empty or null
-  if [[ -z "$feature_path" ]] || [[ "$feature_path" = "null" ]]; then
-    echo "Error: empty or null feature path" >&2
-    return 1
-  fi
-
-  # Reject absolute paths
-  if [[ "$feature_path" = /* ]]; then
-    echo "Error: absolute path not allowed: $feature_path" >&2
-    return 1
-  fi
-
-  # Reject ".", "..", paths starting with "./" or "../", or containing ".."
-  if [[ "$feature_path" = "." ]] || [[ "$feature_path" = ".." ]] || \
-     [[ "$feature_path" = "./" ]] || [[ "$feature_path" == ./* ]] || \
-     [[ "$feature_path" == *".."* ]]; then
-    echo "Error: path traversal not allowed: $feature_path" >&2
-    return 1
-  fi
-
-  # Final check: ensure resolved path is not the repo root
-  local abs_path="${repo_root}/${feature_path}"
-  if [[ -e "$abs_path" ]]; then
-    local resolved=$(realpath "$abs_path" 2>/dev/null)
-    local root_resolved=$(realpath "$repo_root" 2>/dev/null)
-    if [[ "$resolved" = "$root_resolved" ]]; then
-      echo "Error: path resolves to repo root: $feature_path" >&2
-      return 1
-    fi
-  fi
-
-  return 0
-}
-
-# =============================================================================
-# Feature Lookup
-# =============================================================================
-
-# Find feature directory by name (exact or suffix match)
-# Args: feature_name, features_dir
-# Returns: absolute path to feature directory, or empty if not found
-find_feature_by_name() {
-  local feature_name="$1"
-  local features_dir="$2"
-
-  if [[ -z "$feature_name" ]] || [[ -z "$features_dir" ]]; then
-    return 1
-  fi
-
-  # Try exact match first
-  local feature_dir=$(find "$features_dir" -maxdepth 1 -type d -name "${feature_name}" 2>/dev/null | head -1)
-
-  # Try suffix match (e.g., "my-feature" matches "250119-my-feature")
-  if [[ -z "$feature_dir" ]]; then
-    feature_dir=$(find "$features_dir" -maxdepth 1 -type d -name "*-${feature_name}" 2>/dev/null | head -1)
-  fi
-
-  if [[ -n "$feature_dir" ]] && [[ -d "$feature_dir" ]]; then
-    echo "$feature_dir"
-    return 0
-  fi
-
-  return 1
-}
-
-# =============================================================================
-# Backlog Integration
-# =============================================================================
-
-# Complete the backlog issue linked to a feature
-# Args: feature_dir_abs, [repo_root]
-# Returns: 0 if completed or no backlog, 1 on error
-complete_feature_backlog() {
-  local feature_dir_abs="$1"
-  local repo_root="${2:-$(get_repo_root)}"
-
-  local feature_json="$feature_dir_abs/feature.json"
-
-  if [[ ! -f "$feature_json" ]]; then
-    return 0
-  fi
-
-  local backlog_ref=$(jq -r '.backlog_ref // empty' "$feature_json" 2>/dev/null)
-
-  if [[ -n "$backlog_ref" ]]; then
-    if complete_backlog_issue "$backlog_ref" "$repo_root"; then
-      echo "$backlog_ref"
-      return 0
-    else
-      return 1
-    fi
-  fi
-
-  return 0
-}
-
-# =============================================================================
-# Archive Operations
-# =============================================================================
-
-# Archive a feature directory to archive/{YYYY-MM}/
-# Args: feature_dir_abs, [repo_root]
-# Returns: 0 on success, 1 on error
-# Outputs: archive destination path
-archive_feature_dir() {
-  local feature_dir_abs="$1"
-  local repo_root="${2:-$(get_repo_root)}"
-
-  if [[ ! -d "$feature_dir_abs" ]]; then
-    echo "Error: feature directory not found: $feature_dir_abs" >&2
-    return 1
-  fi
-
-  # Get features directory (parent of the feature)
-  local features_dir=$(dirname "$feature_dir_abs")
-  local archive_dir="$features_dir/archive"
-  local year_month=$(date +%Y-%m)
-  local month_dir="$archive_dir/$year_month"
-
-  # Create archive directory
-  mkdir -p "$month_dir"
-
-  # Move feature to archive
-  local feature_name=$(basename "$feature_dir_abs")
-  mv "$feature_dir_abs" "$month_dir/"
-
-  # Output the destination
-  echo "$month_dir/$feature_name"
-  return 0
-}
-
-# Complete archive workflow: complete backlog + archive directory
-# Args: feature_dir_abs, [repo_root]
-# Returns: 0 on success
-# Outputs: lines with status info
-archive_feature_complete() {
-  local feature_dir_abs="$1"
-  local repo_root="${2:-$(get_repo_root)}"
-
-  if [[ ! -d "$feature_dir_abs" ]]; then
-    echo "Error: feature directory not found: $feature_dir_abs" >&2
-    return 1
-  fi
-
-  # Complete linked backlog
-  local backlog_ref=$(complete_feature_backlog "$feature_dir_abs" "$repo_root")
-  if [[ -n "$backlog_ref" ]]; then
-    echo "backlog_completed:$backlog_ref"
-  fi
-
-  # Archive the directory
-  local archive_dest
-  if archive_dest=$(archive_feature_dir "$feature_dir_abs" "$repo_root"); then
-    echo "archived_to:$archive_dest"
-    return 0
-  fi
-
-  return 1
-}