@jahanxu/trellis 0.4.1

package/dist/utils/template-hash.js

@@ -0,0 +1,233 @@
+/**
+ * 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";
+import { ALL_MANAGED_DIRS } from "../configurators/index.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 (derived from platform registry)
+ */
+const TEMPLATE_DIRS = ALL_MANAGED_DIRS;
+/**
+ * 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 identity file
+    "workspace/", // Workspace files (user data)
+    "tasks/", // Task files (user data)
+    ".current-task", // Current task marker (file, not directory)
+    "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

@@ -0,0 +1,87 @@
+{
+  "name": "@jahanxu/trellis",
+  "version": "0.4.1",
+  "description": "AI capabilities grow like ivy — Trellis provides the structure to guide them along a disciplined path",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "trellis": "./bin/trellis.js",
+    "tl": "./bin/trellis.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "ai",
+    "workflow",
+    "cursor",
+    "claude",
+    "iflow",
+    "cli",
+    "developer-tools",
+    "agent",
+    "memory",
+    "trellis"
+  ],
+  "author": "Mindfold LLC",
+  "license": "AGPL-3.0-only",
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "figlet": "^1.9.4",
+    "giget": "^3.1.1",
+    "inquirer": "^9.3.7"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.18.0",
+    "@types/figlet": "^1.7.0",
+    "@types/inquirer": "^9.0.7",
+    "@types/node": "^20.17.10",
+    "@vitest/coverage-v8": "^4.0.18",
+    "basedpyright": "^1.37.2",
+    "eslint": "^9.18.0",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.2.7",
+    "prettier": "^3.4.2",
+    "typescript": "^5.7.2",
+    "typescript-eslint": "^8.21.0",
+    "vitest": "^4.0.18"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "README.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Michaelxwb/Trellis.git"
+  },
+  "scripts": {
+    "build": "tsc && pnpm run copy-templates",
+    "copy-templates": "node scripts/copy-templates.js",
+    "dev": "tsc --watch",
+    "start": "node ./dist/cli/index.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint src/ test/",
+    "lint:fix": "eslint src/ test/ --fix",
+    "format": "prettier --write src/",
+    "format:check": "prettier --check src/",
+    "typecheck": "tsc --noEmit",
+    "lint:py": "basedpyright",
+    "lint:all": "pnpm lint && pnpm lint:py",
+    "release": "git add -A && git diff-index --quiet HEAD || git commit -m 'chore: pre-release updates' && pnpm version patch && git push origin main --tags",
+    "release:minor": "git add -A && git diff-index --quiet HEAD || git commit -m 'chore: pre-release updates' && pnpm version minor && git push origin main --tags",
+    "release:major": "git add -A && git diff-index --quiet HEAD || git commit -m 'chore: pre-release updates' && pnpm version major && git push origin main --tags",
+    "release:beta": "git add -A && git diff-index --quiet HEAD || git commit -m 'chore: pre-release updates' && pnpm version prerelease --preid beta && git push origin HEAD --tags",
+    "release:rc": "git add -A && git diff-index --quiet HEAD || git commit -m 'chore: pre-release updates' && pnpm version prerelease --preid rc && git push origin HEAD --tags",
+    "release:promote": "git add -A && git diff-index --quiet HEAD || git commit -m 'chore: pre-release updates' && pnpm version \"$(node -p \"require('./package.json').version.replace(/-.*/, '')\")\" && git push origin main --tags",
+    "manifest": "node scripts/create-manifest.js"
+  }
+}