tarsk 0.4.4 → 0.4.6

package/dist/features/scaffold/scaffold.runner.js

@@ -1,475 +0,0 @@
-/**
- * Scaffold runner: creates projects from the template catalog
- * with placeholder substitution, package manager rewriting, and optional handlers.
- */
-import { existsSync } from "fs";
-import { join } from "path";
-import { mkdir, readdir, stat, rename, rm } from "fs/promises";
-import { spawnSyncProcess, spawnProcess } from "../../core/utils.js";
-import { createInterface } from "readline";
-import embeddedTemplates from "../../scaffold-templates.json" with { type: "json" };
-const HANDLERS = new Map();
-/**
- * Register a handler for templates that use the given handler name.
- * When a template has `handler` set, the runner calls this callback to get the command list.
- */
-export function registerScaffoldHandler(handlerName, callback) {
-    HANDLERS.set(handlerName, callback);
-}
-function loadCatalog() {
-    return embeddedTemplates;
-}
-function getProjectName(name) {
-    return name
-        .toLowerCase()
-        .replace(/\s/g, "-")
-        .replace(/[^a-z0-9-]/g, "")
-        .replace(/-(\d)/g, "-a$1"); // Replace dash-number with dash-letter-number
-}
-function getPackageId(name) {
-    let packageId = name.replace(/\s/g, ".").replace(/-/g, ".");
-    if (!packageId.includes(".")) {
-        packageId = `ionic.${packageId}`;
-    }
-    const parts = packageId.split(".");
-    for (const part of parts) {
-        if (part.length > 0 && /^\d+$/.test(part)) {
-            packageId = packageId.replace(part, `v${part}`);
-        }
-    }
-    return packageId.trim();
-}
-function toTitleCase(s) {
-    return s.replace(/\w\S*/g, (w) => w.charAt(0).toUpperCase() + w.slice(1).toLowerCase());
-}
-function capacitorPluginHandler(_template, options) {
-    const nm = options.projectName.replace(/\s/g, "").toLowerCase().replace(/-/g, "");
-    const nmp = options.projectName.replace(/\s/g, ".").replace(/-/g, ".");
-    const nmt = toTitleCase(options.projectName.replace(/-/g, " ")).replace(/\s/g, "");
-    return [
-        `npx @capacitor/create-plugin "${nm}" --name "${nm}" --package-id "com.mycompany.${nmp}" --class-name "${nmt}" --author "me" --license MIT --repo https://github.com --description "${nmt} Capacitor Plugin"`,
-        "#" + options.projectPath,
-    ];
-}
-function substitutePlaceholders(command, options, template) {
-    return command
-        .replace(/\$\(project-name\)/g, options.projectName)
-        .replace(/\$\(package-id\)/g, options.packageId)
-        .replace(/\$\(project-folder\)/g, options.projectPath)
-        .replace(/\$\(template\)/g, template.variation)
-        .replace(/\$\(type\)/g, template.type);
-}
-function applyPackageManagerSubstitution(command, pm) {
-    const trimmed = command.trim();
-    if (trimmed.startsWith("npm create ")) {
-        const rest = trimmed.slice("npm create ".length);
-        switch (pm) {
-            case "bun":
-                return `bun create ${rest}`;
-            case "pnpm":
-                return `pnpm create ${rest}`;
-            case "yarn":
-                return `yarn create ${rest}`;
-            default:
-                return trimmed;
-        }
-    }
-    if (trimmed.startsWith("npx ")) {
-        const rest = trimmed.slice(4);
-        switch (pm) {
-            case "bun":
-                return `bunx ${rest}`;
-            case "pnpm":
-                return `pnpm exec ${rest}`;
-            case "yarn":
-                return `yarn dlx ${rest}`;
-            default:
-                return trimmed;
-        }
-    }
-    return trimmed;
-}
-function getInstallCommand(pm) {
-    switch (pm) {
-        case "bun":
-            return "bun install";
-        case "pnpm":
-            return "pnpm install";
-        case "yarn":
-            return "yarn install";
-        default:
-            return "npm install";
-    }
-}
-function buildCommandList(template, options) {
-    if (template.handler) {
-        const handler = HANDLERS.get(template.handler);
-        if (!handler) {
-            throw new Error(`Unknown scaffold handler: ${template.handler}`);
-        }
-        const raw = handler(template, options);
-        const withPlaceholders = raw.map((c) => c.startsWith("#") ? c : substitutePlaceholders(c, options, template));
-        return withPlaceholders.map((c) => {
-            if (c.startsWith("#"))
-                return c;
-            return applyPackageManagerSubstitution(c, options.packageManager);
-        });
-    }
-    const commands = template.commands ?? [];
-    const withPlaceholders = commands.map((c) => substitutePlaceholders(c, options, template));
-    const withPm = withPlaceholders.map((c) => {
-        if (c.startsWith("#"))
-            return c;
-        return applyPackageManagerSubstitution(c, options.packageManager);
-    });
-    const hasCd = withPm.some((c) => c.startsWith("#"));
-    if (!hasCd && withPm.length > 0) {
-        withPm.push("#" + options.projectPath);
-    }
-    return withPm;
-}
-function runCommand(cwd, command) {
-    const [bin, ...args] = command.split(/\s+/);
-    const result = spawnSyncProcess(bin, args, {
-        cwd,
-        shell: true,
-        stdio: ["ignore", "pipe", "pipe"],
-        encoding: "utf-8",
-    });
-    return {
-        ok: result.status === 0,
-        stderr: (typeof result.stderr === "string"
-            ? result.stderr
-            : result.stderr?.toString() || "").trim(),
-    };
-}
-/**
- * Run a single command with streaming stdout/stderr. Yields each line, then yields done with exit status.
- */
-async function* runCommandStreaming(cwd, command) {
-    const [bin, ...args] = command.split(/\s+/);
-    const child = spawnProcess(bin, args, {
-        cwd,
-        shell: true,
-        stdio: ["ignore", "pipe", "pipe"],
-    });
-    const queue = [];
-    let resolveWait = null;
-    const wait = () => new Promise((r) => {
-        resolveWait = r;
-    });
-    const push = (event) => {
-        queue.push(event);
-        if (resolveWait) {
-            resolveWait();
-            resolveWait = null;
-        }
-    };
-    const stderrChunks = [];
-    if (child.stdout) {
-        const rl = createInterface({ input: child.stdout, crlfDelay: Infinity });
-        rl.on("line", (line) => push({ type: "output", line: line ?? "" }));
-    }
-    if (child.stderr) {
-        const rl = createInterface({ input: child.stderr, crlfDelay: Infinity });
-        rl.on("line", (line) => {
-            const s = line ?? "";
-            stderrChunks.push(s);
-            push({ type: "output", line: s });
-        });
-    }
-    child.on("close", (code) => {
-        push({
-            type: "done",
-            ok: code === 0,
-            stderr: stderrChunks.join("\n").trim(),
-        });
-    });
-    while (true) {
-        while (queue.length > 0) {
-            const event = queue.shift();
-            yield event;
-            if (event.type === "done")
-                return;
-        }
-        await wait();
-    }
-}
-/**
- * Create a project from a template. Runs scaffold commands then install in the project folder.
- */
-export async function createScaffoldedProject(options) {
-    const projectPath = join(options.parentDir, options.threadId);
-    if (!existsSync(options.parentDir)) {
-        return {
-            success: false,
-            projectPath,
-            error: `Parent directory does not exist: ${options.parentDir}`,
-        };
-    }
-    // Create the thread directory first
-    try {
-        await mkdir(projectPath, { recursive: true });
-    }
-    catch (error) {
-        return {
-            success: false,
-            projectPath,
-            error: `Failed to create thread directory: ${error instanceof Error ? error.message : String(error)}`,
-        };
-    }
-    const catalog = loadCatalog();
-    const template = catalog.find((t) => t.id === options.templateId);
-    if (!template) {
-        return {
-            success: false,
-            projectPath,
-            error: `Unknown template id: ${options.templateId}`,
-        };
-    }
-    const projectName = getProjectName(options.projectName);
-    const packageId = getPackageId(projectName);
-    const scaffoldOptions = {
-        parentDir: options.parentDir,
-        projectName,
-        projectPath,
-        threadId: options.threadId,
-        packageId,
-        packageManager: options.packageManager,
-    };
-    let commands;
-    try {
-        commands = buildCommandList(template, scaffoldOptions);
-    }
-    catch (err) {
-        return {
-            success: false,
-            projectPath: scaffoldOptions.projectPath,
-            error: err instanceof Error ? err.message : String(err),
-        };
-    }
-    let cwd = options.parentDir;
-    for (const raw of commands) {
-        if (raw.startsWith("#")) {
-            cwd = raw.slice(1).trim();
-            continue;
-        }
-        const cmd = raw.startsWith("npm ") || raw.startsWith("npx ")
-            ? applyPackageManagerSubstitution(raw, options.packageManager)
-            : raw;
-        const { ok, stderr } = runCommand(cwd === options.parentDir ? projectPath : cwd, cmd);
-        if (!ok) {
-            return {
-                success: false,
-                projectPath: scaffoldOptions.projectPath,
-                error: stderr || `Command failed: ${cmd}`,
-            };
-        }
-    }
-    // After scaffold commands complete, move project contents from subdirectory to thread folder
-    // Many CLI tools create a subdirectory with the project name
-    try {
-        const projectName = getProjectName(options.projectName);
-        const projectSubDir = join(projectPath, projectName);
-        // Check if project was created in a subdirectory
-        try {
-            const subDirStat = await stat(projectSubDir);
-            if (subDirStat.isDirectory()) {
-                // Move all contents from subdirectory to thread folder
-                const items = await readdir(projectSubDir);
-                for (const item of items) {
-                    const oldPath = join(projectSubDir, item);
-                    const newPath = join(projectPath, item);
-                    await rename(oldPath, newPath);
-                }
-                // Remove the empty subdirectory
-                await rm(projectSubDir, { recursive: true, force: true });
-            }
-        }
-        catch {
-            // Subdirectory doesn't exist, which is fine - project was created directly
-        }
-    }
-    catch (error) {
-        // Non-fatal error, continue with installation
-        console.warn(`Warning: Could not reorganize project files: ${error instanceof Error ? error.message : String(error)}`);
-    }
-    const installCwd = scaffoldOptions.projectPath;
-    if (existsSync(installCwd)) {
-        const installCmd = getInstallCommand(options.packageManager);
-        const { ok, stderr } = runCommand(installCwd, installCmd);
-        if (!ok) {
-            return {
-                success: true,
-                projectPath: installCwd,
-                error: `Scaffold completed but install failed: ${stderr || installCmd}`,
-            };
-        }
-    }
-    return {
-        success: true,
-        projectPath: scaffoldOptions.projectPath,
-    };
-}
-/**
- * Create a project from a template with streaming command output. Yields progress for each line of stdout/stderr, then result.
- */
-export async function* createScaffoldedProjectStreaming(options) {
-    const projectPath = join(options.parentDir, options.threadId);
-    if (!existsSync(options.parentDir)) {
-        yield {
-            type: "result",
-            result: {
-                success: false,
-                projectPath,
-                error: `Parent directory does not exist: ${options.parentDir}`,
-            },
-        };
-        return;
-    }
-    // Create the thread directory first
-    try {
-        await mkdir(projectPath, { recursive: true });
-    }
-    catch (error) {
-        yield {
-            type: "result",
-            result: {
-                success: false,
-                projectPath,
-                error: `Failed to create thread directory: ${error instanceof Error ? error.message : String(error)}`,
-            },
-        };
-        return;
-    }
-    const catalog = loadCatalog();
-    const template = catalog.find((t) => t.id === options.templateId);
-    if (!template) {
-        yield {
-            type: "result",
-            result: { success: false, projectPath, error: `Unknown template id: ${options.templateId}` },
-        };
-        return;
-    }
-    const projectName = getProjectName(options.projectName);
-    const packageId = getPackageId(projectName);
-    const scaffoldOptions = {
-        parentDir: options.parentDir,
-        projectName,
-        projectPath,
-        threadId: options.threadId,
-        packageId,
-        packageManager: options.packageManager,
-    };
-    let commands;
-    try {
-        commands = buildCommandList(template, scaffoldOptions);
-    }
-    catch (err) {
-        yield {
-            type: "result",
-            result: {
-                success: false,
-                projectPath: scaffoldOptions.projectPath,
-                error: err instanceof Error ? err.message : String(err),
-            },
-        };
-        return;
-    }
-    let cwd = options.parentDir;
-    for (const raw of commands) {
-        if (raw.startsWith("#")) {
-            cwd = raw.slice(1).trim();
-            continue;
-        }
-        const cmd = raw.startsWith("npm ") || raw.startsWith("npx ")
-            ? applyPackageManagerSubstitution(raw, options.packageManager)
-            : raw;
-        for await (const event of runCommandStreaming(cwd === options.parentDir ? projectPath : cwd, cmd)) {
-            if (event.type === "output") {
-                yield { type: "progress", message: event.line };
-            }
-            else {
-                if (!event.ok) {
-                    yield {
-                        type: "result",
-                        result: {
-                            success: false,
-                            projectPath: scaffoldOptions.projectPath,
-                            error: event.stderr || `Command failed: ${cmd}`,
-                        },
-                    };
-                    return;
-                }
-            }
-        }
-    }
-    // After scaffold commands complete, move project contents from subdirectory to thread folder
-    // Many CLI tools create a subdirectory with the project name
-    try {
-        const projectName = getProjectName(options.projectName);
-        const projectSubDir = join(projectPath, projectName);
-        // Check if project was created in a subdirectory
-        try {
-            const subDirStat = await stat(projectSubDir);
-            if (subDirStat.isDirectory()) {
-                yield {
-                    type: "progress",
-                    message: `Moving project files from ${projectName}/ to thread folder...`,
-                };
-                // Move all contents from subdirectory to thread folder
-                const items = await readdir(projectSubDir);
-                for (const item of items) {
-                    const oldPath = join(projectSubDir, item);
-                    const newPath = join(projectPath, item);
-                    await rename(oldPath, newPath);
-                }
-                // Remove the empty subdirectory
-                await rm(projectSubDir, { recursive: true, force: true });
-                yield { type: "progress", message: `Project files organized in thread folder` };
-            }
-        }
-        catch {
-            // Subdirectory doesn't exist, which is fine - project was created directly
-            yield { type: "progress", message: `Project already in correct location` };
-        }
-    }
-    catch (error) {
-        yield {
-            type: "progress",
-            message: `Warning: Could not reorganize project files: ${error instanceof Error ? error.message : String(error)}`,
-        };
-    }
-    const installCwd = scaffoldOptions.projectPath;
-    if (existsSync(installCwd)) {
-        const installCmd = getInstallCommand(options.packageManager);
-        for await (const event of runCommandStreaming(installCwd, installCmd)) {
-            if (event.type === "output") {
-                yield { type: "progress", message: event.line };
-            }
-            else {
-                if (!event.ok) {
-                    yield {
-                        type: "result",
-                        result: {
-                            success: true,
-                            projectPath: installCwd,
-                            error: `Scaffold completed but install failed: ${event.stderr || installCmd}`,
-                        },
-                    };
-                    return;
-                }
-            }
-        }
-    }
-    yield { type: "result", result: { success: true, projectPath: scaffoldOptions.projectPath } };
-}
-/**
- * Load catalog and return all template entries (for API/UI listing).
- */
-export function getScaffoldTemplates() {
-    return loadCatalog();
-}
-// Register built-in handlers
-registerScaffoldHandler("capacitor-plugin", capacitorPluginHandler);
-//# sourceMappingURL=scaffold.runner.js.map

package/dist/features/scaffold/scaffold.types.d.ts

@@ -1,26 +0,0 @@
-/**
- * Types for scaffold (create project) feature
- */
-import type { PackageManager } from "@tarsk/shared";
-export interface TemplateEntry {
-    id: string;
-    type: string;
-    typeName: string;
-    variation: string;
-    variationName: string;
-    description: string;
-    url?: string;
-    commands?: string[];
-    handler?: string;
-    threadId?: string;
-}
-export interface ScaffoldOptions {
-    parentDir: string;
-    projectName: string;
-    threadId: string;
-    projectPath: string;
-    packageId: string;
-    packageManager: PackageManager;
-}
-export type ScaffoldHandler = (template: TemplateEntry, options: ScaffoldOptions) => string[];
-//# sourceMappingURL=scaffold.types.d.ts.map

package/dist/features/scaffold/scaffold.types.js

@@ -1,5 +0,0 @@
-/**
- * Types for scaffold (create project) feature
- */
-export {};
-//# sourceMappingURL=scaffold.types.js.map

package/dist/features/skills/skills.activation.d.ts

@@ -1,31 +0,0 @@
-/**
- * Skill Activation Logic
- *
- * Determines which skills to activate for a given task/thread based on:
- * 1. Manual overrides (enabledSkills/disabledSkills in thread metadata)
- * 2. Auto-discovery (keyword matching between task and skill descriptions)
- */
-import type { Skill, Thread } from "@tarsk/shared";
-/**
- * Activate skills for a task based on thread configuration and auto-discovery
- *
- * Activation rules:
- * 1. If thread has enabledSkills, use only those
- * 2. If thread has disabledSkills, auto-discover but exclude those
- * 3. Otherwise, auto-discover based on keyword matching
- *
- * @param allSkills - All available skills (global + project)
- * @param taskDescription - The user's task/message description
- * @param thread - The current thread (may contain manual skill overrides)
- * @param options - Optional configuration for auto-discovery
- * @returns Array of activated skills
- */
-export declare function activateSkills(allSkills: Skill[], taskDescription: string, thread?: Thread, options?: {
-    relevanceThreshold?: number;
-    maxSkills?: number;
-}): Promise<Skill[]>;
-/**
- * Get skill names from activated skills (utility function)
- */
-export declare function getSkillNames(skills: Skill[]): string[];
-//# sourceMappingURL=skills.activation.d.ts.map

package/dist/features/skills/skills.activation.js

@@ -1,155 +0,0 @@
-/**
- * Skill Activation Logic
- *
- * Determines which skills to activate for a given task/thread based on:
- * 1. Manual overrides (enabledSkills/disabledSkills in thread metadata)
- * 2. Auto-discovery (keyword matching between task and skill descriptions)
- */
-/**
- * Common stop words to filter out during keyword extraction
- */
-const STOP_WORDS = new Set([
-    "a",
-    "an",
-    "and",
-    "are",
-    "as",
-    "at",
-    "be",
-    "by",
-    "for",
-    "from",
-    "has",
-    "he",
-    "in",
-    "is",
-    "it",
-    "its",
-    "of",
-    "on",
-    "that",
-    "the",
-    "to",
-    "was",
-    "will",
-    "with",
-    "when",
-    "where",
-    "which",
-    "who",
-    "use",
-    "used",
-    "using",
-    "this",
-    "can",
-    "do",
-    "does",
-    "how",
-    "what",
-    "i",
-    "you",
-    "we",
-    "they",
-    "them",
-    "their",
-    "my",
-    "your",
-    "our",
-]);
-/**
- * Extract keywords from text for skill matching
- * - Lowercase the text
- * - Split by whitespace and punctuation
- * - Remove stop words
- * - Filter to words with 3+ characters
- */
-function extractKeywords(text) {
-    const keywords = new Set();
-    // Lowercase and split by non-alphanumeric characters
-    const words = text
-        .toLowerCase()
-        .split(/[^a-z0-9]+/)
-        .filter((word) => word.length >= 3);
-    for (const word of words) {
-        if (!STOP_WORDS.has(word)) {
-            keywords.add(word);
-        }
-    }
-    return keywords;
-}
-/**
- * Calculate relevance score between task and skill description
- * Returns a score from 0 to 1 based on keyword overlap
- */
-function calculateRelevanceScore(taskKeywords, skillDescription) {
-    const skillKeywords = extractKeywords(skillDescription);
-    if (skillKeywords.size === 0 || taskKeywords.size === 0) {
-        return 0;
-    }
-    // Count matching keywords
-    let matches = 0;
-    for (const keyword of taskKeywords) {
-        if (skillKeywords.has(keyword)) {
-            matches++;
-        }
-    }
-    // Score is the ratio of matches to task keywords
-    // (How much of the task is covered by this skill?)
-    return matches / taskKeywords.size;
-}
-/**
- * Auto-discover relevant skills based on task description
- * Returns skills sorted by relevance (most relevant first)
- */
-function autoDiscoverSkills(allSkills, taskDescription, relevanceThreshold = 0.1, maxSkills = 5) {
-    const taskKeywords = extractKeywords(taskDescription);
-    // Calculate relevance scores for all skills
-    const scoredSkills = allSkills.map((skill) => ({
-        skill,
-        score: calculateRelevanceScore(taskKeywords, skill.description),
-    }));
-    // Filter by threshold and sort by score (descending)
-    const relevantSkills = scoredSkills
-        .filter(({ score }) => score >= relevanceThreshold)
-        .sort((a, b) => b.score - a.score)
-        .slice(0, maxSkills)
-        .map(({ skill }) => skill);
-    return relevantSkills;
-}
-/**
- * Activate skills for a task based on thread configuration and auto-discovery
- *
- * Activation rules:
- * 1. If thread has enabledSkills, use only those
- * 2. If thread has disabledSkills, auto-discover but exclude those
- * 3. Otherwise, auto-discover based on keyword matching
- *
- * @param allSkills - All available skills (global + project)
- * @param taskDescription - The user's task/message description
- * @param thread - The current thread (may contain manual skill overrides)
- * @param options - Optional configuration for auto-discovery
- * @returns Array of activated skills
- */
-export async function activateSkills(allSkills, taskDescription, thread, options) {
-    const { relevanceThreshold = 0.1, maxSkills = 5 } = options ?? {};
-    // Rule 1: If thread has explicitly enabled skills, use only those
-    if (thread?.enabledSkills && thread.enabledSkills.length > 0) {
-        const enabledSet = new Set(thread.enabledSkills);
-        return allSkills.filter((skill) => enabledSet.has(skill.name));
-    }
-    // Rule 2 & 3: Auto-discover, but respect disabled skills
-    const autoDiscovered = autoDiscoverSkills(allSkills, taskDescription, relevanceThreshold, maxSkills);
-    // Filter out disabled skills if specified
-    if (thread?.disabledSkills && thread.disabledSkills.length > 0) {
-        const disabledSet = new Set(thread.disabledSkills);
-        return autoDiscovered.filter((skill) => !disabledSet.has(skill.name));
-    }
-    return autoDiscovered;
-}
-/**
- * Get skill names from activated skills (utility function)
- */
-export function getSkillNames(skills) {
-    return skills.map((skill) => skill.name);
-}
-//# sourceMappingURL=skills.activation.js.map