@fifine/aim-studio 0.0.1

package/dist/utils/template-fetcher.js

@@ -0,0 +1,174 @@
+/**
+ * Remote template fetcher for AIM Studio CLI
+ *
+ * Fetches spec templates from the official docs repository:
+ * https://github.com/mindfold-ai/docs/tree/main/marketplace
+ */
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { downloadTemplate } from "giget";
+// =============================================================================
+// Constants
+// =============================================================================
+const TEMPLATE_INDEX_URL = "https://raw.githubusercontent.com/mindfold-ai/docs/main/marketplace/index.json";
+const TEMPLATE_REPO = "gh:mindfold-ai/docs";
+/** Map template type to installation path */
+const INSTALL_PATHS = {
+    spec: ".aim-studio/spec",
+    skill: ".agents/skills",
+    command: ".claude/commands",
+    full: ".", // Entire project root
+};
+// =============================================================================
+// Fetch Template Index
+// =============================================================================
+/**
+ * Fetch available templates from the remote index
+ * Returns empty array on network error (allows fallback to blank)
+ */
+export async function fetchTemplateIndex() {
+    try {
+        const res = await fetch(TEMPLATE_INDEX_URL);
+        if (!res.ok) {
+            throw new Error(`HTTP ${res.status}`);
+        }
+        const index = (await res.json());
+        return index.templates;
+    }
+    catch {
+        // Network error - return empty array, caller will fallback to blank
+        return [];
+    }
+}
+/**
+ * Find a template by ID from the index
+ */
+export async function findTemplate(templateId) {
+    const templates = await fetchTemplateIndex();
+    return templates.find((t) => t.id === templateId) ?? null;
+}
+// =============================================================================
+// Download Template
+// =============================================================================
+/**
+ * Get the installation path for a template type
+ */
+export function getInstallPath(cwd, templateType) {
+    const relativePath = INSTALL_PATHS[templateType] || INSTALL_PATHS.spec;
+    return path.join(cwd, relativePath);
+}
+/**
+ * Download a template with the specified strategy
+ *
+ * @param templatePath - Path in the docs repo (e.g., "marketplace/specs/electron-fullstack")
+ * @param destDir - Destination directory
+ * @param strategy - How to handle existing directory: skip, overwrite, or append
+ * @returns true if template was downloaded, false if skipped
+ */
+export async function downloadWithStrategy(templatePath, destDir, strategy) {
+    const exists = fs.existsSync(destDir);
+    // skip: Directory exists, don't download
+    if (strategy === "skip" && exists) {
+        return false;
+    }
+    // overwrite: Delete existing directory first
+    if (strategy === "overwrite" && exists) {
+        await fs.promises.rm(destDir, { recursive: true });
+    }
+    // append: Download to temp dir, then merge missing files
+    if (strategy === "append" && exists) {
+        const tempDir = path.join(os.tmpdir(), `aim-template-${Date.now()}`);
+        try {
+            await downloadTemplate(`${TEMPLATE_REPO}/${templatePath}`, {
+                dir: tempDir,
+                preferOffline: true,
+            });
+            await copyMissing(tempDir, destDir);
+        }
+        finally {
+            // Clean up temp directory
+            await fs.promises.rm(tempDir, { recursive: true, force: true });
+        }
+        return true;
+    }
+    // Default: Direct download (for new directory or after overwrite)
+    await downloadTemplate(`${TEMPLATE_REPO}/${templatePath}`, {
+        dir: destDir,
+        preferOffline: true,
+    });
+    return true;
+}
+/**
+ * Copy only files that don't exist in the destination
+ */
+async function copyMissing(src, dest) {
+    // Ensure destination exists
+    if (!fs.existsSync(dest)) {
+        await fs.promises.mkdir(dest, { recursive: true });
+    }
+    const entries = await fs.promises.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 missing files in subdirectory
+            await copyMissing(srcPath, destPath);
+        }
+        else if (!fs.existsSync(destPath)) {
+            // Only copy if file doesn't exist
+            await fs.promises.copyFile(srcPath, destPath);
+        }
+    }
+}
+/**
+ * Download a template by ID
+ *
+ * @param cwd - Current working directory
+ * @param templateId - Template ID from the index
+ * @param strategy - How to handle existing directory
+ * @returns Object with success status and message
+ */
+export async function downloadTemplateById(cwd, templateId, strategy) {
+    // Find template in index
+    const template = await findTemplate(templateId);
+    if (!template) {
+        return {
+            success: false,
+            message: `Template "${templateId}" not found`,
+        };
+    }
+    // Only support spec type in MVP
+    if (template.type !== "spec") {
+        return {
+            success: false,
+            message: `Template type "${template.type}" is not supported yet (only "spec" is supported)`,
+        };
+    }
+    // Get destination path
+    const destDir = getInstallPath(cwd, template.type);
+    // Check if directory exists for skip strategy
+    if (strategy === "skip" && fs.existsSync(destDir)) {
+        return {
+            success: true,
+            skipped: true,
+            message: `Skipped: ${destDir} already exists`,
+        };
+    }
+    // Download template
+    try {
+        await downloadWithStrategy(template.path, destDir, strategy);
+        return {
+            success: true,
+            message: `Downloaded template "${templateId}" to ${destDir}`,
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : "Unknown error";
+        return {
+            success: false,
+            message: `Failed to download template: ${errorMessage}`,
+        };
+    }
+}
+//# sourceMappingURL=template-fetcher.js.map

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

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

package/dist/utils/template-hash.d.ts

@@ -0,0 +1,78 @@
+/**
+ * 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 type { TemplateHashes } from "../types/migration.js";
+/**
+ * Compute SHA256 hash of content
+ */
+export declare function computeHash(content: string): string;
+/**
+ * Load stored template hashes
+ */
+export declare function loadHashes(cwd: string): TemplateHashes;
+/**
+ * Save template hashes
+ */
+export declare function saveHashes(cwd: string, hashes: TemplateHashes): void;
+/**
+ * Update hashes for specific files
+ *
+ * @param cwd - Working directory
+ * @param files - Map of relative paths to file contents
+ */
+export declare function updateHashes(cwd: string, files: Map<string, string>): void;
+/**
+ * Update hash for a single file by reading its current content
+ */
+export declare function updateHashFromFile(cwd: string, relativePath: string): void;
+/**
+ * Remove hash entry for a file (e.g., after deletion)
+ */
+export declare function removeHash(cwd: string, relativePath: string): void;
+/**
+ * Rename hash entry (used after file rename)
+ */
+export declare function renameHash(cwd: string, oldPath: string, newPath: string): void;
+/**
+ * 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 declare function isTemplateModified(cwd: string, relativePath: string, hashes: TemplateHashes): boolean;
+/**
+ * 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 declare function matchesOriginalTemplate(cwd: string, relativePath: string, originalContent: string): boolean;
+/**
+ * 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 declare function getModificationStatus(cwd: string, relativePaths: string[], hashes: TemplateHashes): Map<string, boolean>;
+/**
+ * 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 declare function initializeHashes(cwd: string): number;
+//# sourceMappingURL=template-hash.d.ts.map

package/dist/utils/template-hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-hash.d.ts","sourceRoot":"","sources":["../../src/utils/template-hash.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAK5D;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnD;AASD;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAYtD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,IAAI,CAGpE;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAU1E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAU1E;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAIlE;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,IAAI,CAON;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,cAAc,GACrB,OAAO,CAmBT;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,MAAM,EACpB,eAAe,EAAE,MAAM,GACtB,OAAO,CAST;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,MAAM,EACX,aAAa,EAAE,MAAM,EAAE,EACvB,MAAM,EAAE,cAAc,GACrB,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAQtB;AAsED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAsBpD"}

package/dist/utils/template-hash.js

@@ -0,0 +1,239 @@
+/**
+ * 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) {
+        // Normalize path to forward slashes for portable hash keys
+        const portablePath = relativePath.split(path.sep).join("/");
+        hashes[portablePath] = 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) {
+    // Normalize to forward slashes for pattern matching
+    const normalizedPath = relativePath.split(path.sep).join("/");
+    for (const pattern of EXCLUDE_FROM_HASH) {
+        if (normalizedPath.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");
+                // Normalize path to forward slashes for portable hash keys
+                const portablePath = relativePath.split(path.sep).join("/");
+                hashes[portablePath] = 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":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAG7D,4CAA4C;AAC5C,MAAM,WAAW,GAAG,uBAAuB,CAAC;AAE5C;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACrE,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CAAC,GAAW;IAChC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;AACzD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,MAAM,UAAU,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IACtC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACrD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAmB,CAAC;IAC/C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,GAAW,EAAE,MAAsB;IAC5D,MAAM,UAAU,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IACtC,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAChE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW,EAAE,KAA0B;IAClE,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;IAE/B,KAAK,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,IAAI,KAAK,EAAE,CAAC;QAC5C,2DAA2D;QAC3D,MAAM,YAAY,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC5D,MAAM,CAAC,YAAY,CAAC,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IAC9C,CAAC;IAED,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAW,EAAE,YAAoB;IAClE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IAC9C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACnD,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;IAC/B,MAAM,CAAC,YAAY,CAAC,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IAC5C,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,GAAW,EAAE,YAAoB;IAC1D,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;IAC/B,MAAM,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;IAC9C,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CACxB,GAAW,EACX,OAAe,EACf,OAAe;IAEf,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;IAC/B,IAAI,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QACpB,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QAChD,IAAI,CAAC,OAAO,CAAC,GAAG,QAAQ,CAAC;QACzB,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACxB,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAChC,GAAW,EACX,YAAoB,EACpB,MAAsB;IAEtB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IAE9C,2CAA2C;IAC3C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,sEAAsE;IACtE,MAAM,UAAU,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;IACxC,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,gDAAgD;IAChD,MAAM,cAAc,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC1D,MAAM,WAAW,GAAG,WAAW,CAAC,cAAc,CAAC,CAAC;IAEhD,OAAO,WAAW,KAAK,UAAU,CAAC;AACpC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,uBAAuB,CACrC,GAAW,EACX,YAAoB,EACpB,eAAuB;IAEvB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IAE9C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,cAAc,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC1D,OAAO,cAAc,KAAK,eAAe,CAAC;AAC5C,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CACnC,GAAW,EACX,aAAuB,EACvB,MAAsB;IAEtB,MAAM,MAAM,GAAG,IAAI,GAAG,EAAmB,CAAC;IAE1C,KAAK,MAAM,YAAY,IAAI,aAAa,EAAE,CAAC;QACzC,MAAM,CAAC,GAAG,CAAC,YAAY,EAAE,kBAAkB,CAAC,GAAG,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC;IAC1E,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,aAAa,GAAG,gBAAgB,CAAC;AAEvC;;GAEG;AACH,MAAM,iBAAiB,GAAG;IACxB,uBAAuB,EAAE,mBAAmB;IAC5C,UAAU,EAAE,eAAe;IAC3B,YAAY,EAAE,mBAAmB;IACjC,YAAY,EAAE,0BAA0B;IACxC,YAAY,EAAE,8BAA8B;IAC5C,QAAQ,EAAE,yBAAyB;IACnC,eAAe,EAAE,4CAA4C;IAC7D,gBAAgB,EAAE,yBAAyB;IAC3C,eAAe,EAAE,yBAAyB;IAC1C,UAAU,EAAE,qBAAqB;CAClC,CAAC;AAEF;;GAEG;AACH,SAAS,qBAAqB,CAAC,YAAoB;IACjD,oDAAoD;IACpD,MAAM,cAAc,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC9D,KAAK,MAAM,OAAO,IAAI,iBAAiB,EAAE,CAAC;QACxC,IAAI,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YACrC,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,SAAS,YAAY,CACnB,GAAW,EACX,GAAW,EACX,aAAqB,EAAE;IAEvB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACpC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAEjE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAEhD,IAAI,qBAAqB,CAAC,YAAY,CAAC,EAAE,CAAC;YACxC,SAAS;QACX,CAAC;QAED,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,KAAK,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,GAAG,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC,CAAC;QAC7D,CAAC;aAAM,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;YAC1B,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,MAAM,MAAM,GAAmB,EAAE,CAAC;IAElC,6BAA6B;IAC7B,KAAK,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;QAChC,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAErC,KAAK,MAAM,YAAY,IAAI,KAAK,EAAE,CAAC;YACjC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;YAC9C,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBACnD,2DAA2D;gBAC3D,MAAM,YAAY,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAC5D,MAAM,CAAC,YAAY,CAAC,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;YAC9C,CAAC;YAAC,MAAM,CAAC;gBACP,+CAA+C;YACjD,CAAC;QACH,CAAC;IACH,CAAC;IAED,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACxB,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC;AACpC,CAAC"}

package/package.json

@@ -0,0 +1,87 @@
+{
+  "name": "@fifine/aim-studio",
+  "version": "0.0.1",
+  "description": "AIM Studio — Specialized CLI for AI comic and drama generation. Formerly Trellis.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "aim": "bin/aim.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "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",
+    "prepare": "husky",
+    "prepublishOnly": "pnpm run build",
+    "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",
+    "manifest": "node scripts/create-manifest.js"
+  },
+  "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.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mindfold-ai/aim-studio.git"
+  }
+}