runwork 0.15.0 → 0.15.2

package/dist/sync/change-detect.js

@@ -1,136 +0,0 @@
-import { contentHash } from './hash.js';
-export function computeSyncPlan(input) {
-    const { storedHashes, localSkills, remoteSkills } = input;
-    const plan = {
-        pulls: [],
-        pushes: [],
-        conflicts: [],
-        skips: [],
-        deletions: [],
-    };
-    const localByName = new Map(localSkills.map((s) => [s.name, s]));
-    const remoteByName = new Map(remoteSkills.map((s) => [s.name, s]));
-    // Process all remote skills — new-remote or change-detection
-    for (const remote of remoteSkills) {
-        const stored = storedHashes[remote.name];
-        const local = localByName.get(remote.name);
-        const remoteHash = contentHash(remote.content);
-        if (!stored) {
-            // New remote skill — never seen before
-            plan.pulls.push({
-                name: remote.name,
-                action: 'new-remote',
-                remoteContent: remote.content,
-                source: remote.source,
-                remoteId: remote.remoteId,
-                appId: remote.appId,
-            });
-            continue;
-        }
-        const localHash = local ? contentHash(local.content) : null;
-        const localChanged = localHash !== null && localHash !== stored.localHash;
-        const remoteChanged = remoteHash !== stored.remoteHash;
-        if (!local) {
-            // Local file was deleted — restore from remote
-            plan.pulls.push({
-                name: remote.name,
-                action: 'pull',
-                remoteContent: remote.content,
-                source: remote.source,
-                remoteId: remote.remoteId,
-                appId: remote.appId,
-            });
-            continue;
-        }
-        if (!localChanged && !remoteChanged) {
-            // Nothing changed
-            plan.skips.push({
-                name: remote.name,
-                action: 'skip',
-                source: remote.source,
-                remoteId: remote.remoteId,
-                appId: remote.appId,
-            });
-            continue;
-        }
-        if (!localChanged && remoteChanged) {
-            // Only remote changed
-            plan.pulls.push({
-                name: remote.name,
-                action: 'pull',
-                localContent: local.content,
-                remoteContent: remote.content,
-                source: remote.source,
-                remoteId: remote.remoteId,
-                appId: remote.appId,
-            });
-            continue;
-        }
-        if (localChanged && !remoteChanged) {
-            if (remote.source === 'external') {
-                // Only local changed and skill is external — push
-                plan.pushes.push({
-                    name: remote.name,
-                    action: 'push',
-                    localContent: local.content,
-                    remoteContent: remote.content,
-                    source: remote.source,
-                    remoteId: remote.remoteId,
-                    appId: remote.appId,
-                });
-            }
-            else {
-                // App skill — overwrite local with remote (read-only)
-                plan.pulls.push({
-                    name: remote.name,
-                    action: 'pull',
-                    localContent: local.content,
-                    remoteContent: remote.content,
-                    source: remote.source,
-                    remoteId: remote.remoteId,
-                    appId: remote.appId,
-                });
-            }
-            continue;
-        }
-        // Both changed
-        if (remote.source === 'external') {
-            plan.conflicts.push({
-                name: remote.name,
-                action: 'conflict',
-                localContent: local.content,
-                remoteContent: remote.content,
-                source: remote.source,
-                remoteId: remote.remoteId,
-                appId: remote.appId,
-            });
-        }
-        else {
-            // App skill always wins
-            plan.pulls.push({
-                name: remote.name,
-                action: 'pull',
-                localContent: local.content,
-                remoteContent: remote.content,
-                source: remote.source,
-                remoteId: remote.remoteId,
-                appId: remote.appId,
-            });
-        }
-    }
-    // Process stored skills that no longer exist on remote — deleted remotely
-    for (const [name, stored] of Object.entries(storedHashes)) {
-        if (!remoteByName.has(name)) {
-            const local = localByName.get(name);
-            plan.deletions.push({
-                name,
-                action: 'deleted-remote',
-                localContent: local?.content,
-                source: stored.source,
-                remoteId: stored.remoteId,
-                appId: stored.appId,
-            });
-        }
-    }
-    return plan;
-}

package/dist/sync/conflict-ui.d.ts

@@ -1,5 +0,0 @@
-import type { SyncPlan, SkillSyncAction } from './types.js';
-export declare function printSyncSummary(plan: SyncPlan): void;
-export type ConflictResolution = 'local' | 'remote' | 'skip';
-export declare function resolveConflict(action: SkillSyncAction): Promise<ConflictResolution>;
-export declare function resolveConflictNonInteractive(prefer: 'local' | 'remote'): ConflictResolution;

package/dist/sync/conflict-ui.js

@@ -1,78 +0,0 @@
-import { promptSelect } from '../utils/prompt.js';
-import { bold, dim, cyan, yellow, green } from '../ui/colors.js';
-export function printSyncSummary(plan) {
-    const pullCount = plan.pulls.length;
-    const pushCount = plan.pushes.length;
-    const conflictCount = plan.conflicts.length;
-    const deleteCount = plan.deletions.length;
-    const skipCount = plan.skips.length;
-    console.log('');
-    console.log(bold('Sync summary:') + ` ${pullCount} to pull, ${pushCount} to push, ${conflictCount} conflict${conflictCount !== 1 ? 's' : ''}, ${deleteCount} to delete, ${skipCount} up to date`);
-    console.log('');
-    for (const s of plan.pulls) {
-        const label = s.action === 'new-remote' ? 'new' : 'pull';
-        console.log(`  ${green(`[${label}]`.padEnd(8))} ${s.name.padEnd(28)} ${dim('remote updated')}`);
-    }
-    for (const s of plan.pushes) {
-        console.log(`  ${cyan('[push]'.padEnd(8))} ${s.name.padEnd(28)} ${dim('local changes')}`);
-    }
-    for (const s of plan.conflicts) {
-        console.log(`  ${yellow('[!!]'.padEnd(8))} ${s.name.padEnd(28)} ${dim('modified both locally and remotely')}`);
-    }
-    for (const s of plan.deletions) {
-        console.log(`  ${dim('[del]'.padEnd(8))} ${s.name.padEnd(28)} ${dim('removed from workspace')}`);
-    }
-    console.log('');
-}
-export async function resolveConflict(action) {
-    console.log(`\n${bold(`Conflict: "${action.name}"`)} modified both locally and remotely.\n`);
-    if (action.localContent && action.remoteContent) {
-        const localLines = action.localContent.split('\n').length;
-        const remoteLines = action.remoteContent.split('\n').length;
-        console.log(`  Local:  ${localLines} lines`);
-        console.log(`  Remote: ${remoteLines} lines`);
-        console.log('');
-    }
-    const choice = await promptSelect('Resolution:', [
-        { label: 'Keep local version and push to workspace', value: 'local' },
-        { label: 'Keep remote version and overwrite local', value: 'remote' },
-        { label: 'Show diff', value: 'diff' },
-        { label: 'Skip (resolve later)', value: 'skip' },
-    ]);
-    if (choice.value === 'diff') {
-        printDiff(action.localContent || '', action.remoteContent || '');
-        const choice2 = await promptSelect('After reviewing diff:', [
-            { label: 'Keep local version and push to workspace', value: 'local' },
-            { label: 'Keep remote version and overwrite local', value: 'remote' },
-            { label: 'Skip (resolve later)', value: 'skip' },
-        ]);
-        return choice2.value;
-    }
-    return choice.value;
-}
-function printDiff(local, remote) {
-    const localLines = local.split('\n');
-    const remoteLines = remote.split('\n');
-    const maxLen = Math.max(localLines.length, remoteLines.length);
-    console.log('');
-    console.log(bold('--- Local'));
-    console.log(bold('+++ Remote'));
-    console.log('');
-    for (let i = 0; i < maxLen; i++) {
-        const l = localLines[i];
-        const r = remoteLines[i];
-        if (l === r) {
-            console.log(dim(`  ${l ?? ''}`));
-        }
-        else {
-            if (l !== undefined)
-                console.log(cyan(`- ${l}`));
-            if (r !== undefined)
-                console.log(green(`+ ${r}`));
-        }
-    }
-    console.log('');
-}
-export function resolveConflictNonInteractive(prefer) {
-    return prefer;
-}

package/dist/sync/executor.d.ts

@@ -1,23 +0,0 @@
-import type { ApiClient } from '../api/client.js';
-import type { AgentAdapter } from '../agents/types.js';
-import type { SyncPlan } from './types.js';
-interface ExecutorContext {
-    client: ApiClient;
-    workspaceId: string;
-    adapters: AgentAdapter[];
-    scopes: Array<'project' | 'user'>;
-    /** True when MCP servers are configured; app-sourced skills are skipped since MCP provides them */
-    hasMcp?: boolean;
-}
-/**
- * Execute the resolved sync plan: pull remote skills, push local skills,
- * delete removed skills. Returns updated skillHashes for state persistence.
- */
-export declare function executeSyncPlan(plan: SyncPlan, resolvedConflicts: Map<string, 'local' | 'remote'>, ctx: ExecutorContext): Promise<Record<string, {
-    localHash: string;
-    remoteHash: string;
-    source: 'external' | 'app';
-    remoteId?: string;
-    appId?: string;
-}>>;
-export {};

package/dist/sync/executor.js

@@ -1,102 +0,0 @@
-import { toSlug } from '../agents/types.js';
-import { contentHash } from './hash.js';
-/**
- * Execute the resolved sync plan: pull remote skills, push local skills,
- * delete removed skills. Returns updated skillHashes for state persistence.
- */
-export async function executeSyncPlan(plan, resolvedConflicts, ctx) {
-    const newHashes = {};
-    // Process pulls
-    for (const action of plan.pulls) {
-        if (!action.remoteContent)
-            continue;
-        const hash = contentHash(action.remoteContent);
-        writeSkillToAgents(action.name, action.remoteContent, action.source, ctx);
-        newHashes[action.name] = {
-            localHash: hash,
-            remoteHash: hash,
-            source: action.source,
-            remoteId: action.remoteId,
-            appId: action.appId,
-        };
-        console.log(`  Pulled: ${action.name}`);
-    }
-    // Process pushes
-    for (const action of plan.pushes) {
-        if (!action.localContent || !action.remoteId)
-            continue;
-        await ctx.client.updateExternalSkill(ctx.workspaceId, action.remoteId, {
-            name: action.name,
-            description: extractDescription(action.localContent),
-            content: stripFrontmatter(action.localContent),
-        });
-        const hash = contentHash(action.localContent);
-        newHashes[action.name] = {
-            localHash: hash,
-            remoteHash: hash,
-            source: 'external',
-            remoteId: action.remoteId,
-        };
-        console.log(`  Pushed: ${action.name}`);
-    }
-    // Process resolved conflicts
-    for (const action of plan.conflicts) {
-        const resolution = resolvedConflicts.get(action.name);
-        if (!resolution)
-            continue;
-        if (resolution === 'local' && action.localContent && action.remoteId) {
-            await ctx.client.updateExternalSkill(ctx.workspaceId, action.remoteId, {
-                name: action.name,
-                description: extractDescription(action.localContent),
-                content: stripFrontmatter(action.localContent),
-            });
-            const hash = contentHash(action.localContent);
-            newHashes[action.name] = { localHash: hash, remoteHash: hash, source: 'external', remoteId: action.remoteId };
-            console.log(`  Pushed (conflict resolved): ${action.name}`);
-        }
-        else if (resolution === 'remote' && action.remoteContent) {
-            writeSkillToAgents(action.name, action.remoteContent, action.source, ctx);
-            const hash = contentHash(action.remoteContent);
-            newHashes[action.name] = { localHash: hash, remoteHash: hash, source: 'external', remoteId: action.remoteId };
-            console.log(`  Pulled (conflict resolved): ${action.name}`);
-        }
-    }
-    // Process skips -- preserve current state
-    for (const _action of plan.skips) {
-        // Skips don't change hashes -- caller preserves existing state
-    }
-    // Process deletions -- not added to newHashes = removed from state
-    for (const action of plan.deletions) {
-        console.log(`  Deleted locally: ${action.name}`);
-    }
-    return newHashes;
-}
-function writeSkillToAgents(name, content, source, ctx) {
-    const skillFile = {
-        name,
-        filename: toSlug(name),
-        content,
-        description: extractDescription(content),
-    };
-    for (const adapter of ctx.adapters) {
-        // Skip app-sourced skills for adapters where MCP already provides them as skill_* tools
-        if (source === 'app' && ctx.hasMcp && adapter.mcpProvidesSkills)
-            continue;
-        for (const scope of ctx.scopes) {
-            if (!adapter.supportsSkills())
-                continue;
-            try {
-                adapter.writeSkills([skillFile], scope);
-            }
-            catch { /* skip failing adapters */ }
-        }
-    }
-}
-function extractDescription(content) {
-    const match = content.match(/^---\n[\s\S]*?description:\s*(.+)\n[\s\S]*?---/);
-    return match ? match[1].trim() : '';
-}
-function stripFrontmatter(content) {
-    const match = content.match(/^---\n[\s\S]*?\n---\n([\s\S]*)$/);
-    return match ? match[1] : content;
-}

package/dist/sync/hash.d.ts

@@ -1 +0,0 @@
-export declare function contentHash(content: string): string;

package/dist/sync/hash.js

@@ -1,4 +0,0 @@
-import { createHash } from 'crypto';
-export function contentHash(content) {
-    return 'sha256:' + createHash('sha256').update(content).digest('hex');
-}

package/dist/sync/types.d.ts

@@ -1,24 +0,0 @@
-export interface SkillHashState {
-    localHash: string;
-    remoteHash: string;
-    source: 'external' | 'app';
-    remoteId?: string;
-    appId?: string;
-}
-export type SkillSyncActionType = 'pull' | 'push' | 'conflict' | 'skip' | 'new-local' | 'new-remote' | 'deleted-remote';
-export interface SkillSyncAction {
-    name: string;
-    action: SkillSyncActionType;
-    localContent?: string;
-    remoteContent?: string;
-    source: 'external' | 'app';
-    remoteId?: string;
-    appId?: string;
-}
-export interface SyncPlan {
-    pulls: SkillSyncAction[];
-    pushes: SkillSyncAction[];
-    conflicts: SkillSyncAction[];
-    skips: SkillSyncAction[];
-    deletions: SkillSyncAction[];
-}

package/dist/sync/types.js

@@ -1 +0,0 @@
-export {};

package/dist/template/manifest.d.ts

@@ -1,17 +0,0 @@
-export interface TemplateManifest {
-    version: 1;
-    files: Record<string, string>;
-}
-export declare function generateManifest(dir: string): Promise<TemplateManifest>;
-export declare function saveManifest(dir: string, manifest: TemplateManifest): Promise<void>;
-export declare function loadManifest(dir: string): Promise<TemplateManifest | null>;
-/**
- * Detect files the user edited outside of `runwork dev`.
- *
- * Two sources of edits:
- * 1. Git-tracked files with uncommitted changes (git diff + git diff --cached)
- * 2. Untracked files that aren't in the template manifest (user-created files)
- *
- * Already-committed files are NOT flagged -- git already knows about them.
- */
-export declare function detectUserEdits(dir: string, manifest: TemplateManifest): Promise<string[]>;

package/dist/template/manifest.js

@@ -1,145 +0,0 @@
-import { createHash } from 'crypto';
-import { execFileSync } from '../utils/subprocess.js';
-import { readFileSync, writeFileSync, existsSync, readdirSync, mkdirSync } from 'fs';
-import { join, relative } from 'path';
-import { buildIgnoreSets } from '../utils/ignore-matcher.js';
-function sha256(data) {
-    return 'sha256:' + createHash('sha256').update(data).digest('hex');
-}
-function walkDir(dir, base, sets) {
-    const results = [];
-    const entries = readdirSync(dir, { withFileTypes: true });
-    for (const entry of entries) {
-        if (sets.dirs.has(entry.name))
-            continue;
-        if (sets.files.has(entry.name))
-            continue;
-        if (entry.isFile()) {
-            const dotIndex = entry.name.lastIndexOf('.');
-            if (dotIndex >= 0 && sets.extensions.has(entry.name.slice(dotIndex)))
-                continue;
-        }
-        const fullPath = join(dir, entry.name);
-        if (entry.isDirectory()) {
-            results.push(...walkDir(fullPath, base, sets));
-        }
-        else if (entry.isFile()) {
-            results.push(relative(base, fullPath));
-        }
-    }
-    return results;
-}
-export async function generateManifest(dir) {
-    const files = {};
-    const sets = buildIgnoreSets(dir);
-    const allFiles = walkDir(dir, dir, sets);
-    for (const relPath of allFiles) {
-        const content = readFileSync(join(dir, relPath));
-        files[relPath] = sha256(content);
-    }
-    return { version: 1, files };
-}
-export async function saveManifest(dir, manifest) {
-    const manifestDir = join(dir, '.runwork');
-    if (!existsSync(manifestDir)) {
-        mkdirSync(manifestDir, { recursive: true });
-    }
-    writeFileSync(join(manifestDir, 'template-manifest.json'), JSON.stringify(manifest, null, 2));
-}
-export async function loadManifest(dir) {
-    const manifestPath = join(dir, '.runwork', 'template-manifest.json');
-    if (!existsSync(manifestPath))
-        return null;
-    try {
-        return JSON.parse(readFileSync(manifestPath, 'utf-8'));
-    }
-    catch {
-        return null;
-    }
-}
-/**
- * Detect files the user edited outside of `runwork dev`.
- *
- * Two sources of edits:
- * 1. Git-tracked files with uncommitted changes (git diff + git diff --cached)
- * 2. Untracked files that aren't in the template manifest (user-created files)
- *
- * Already-committed files are NOT flagged -- git already knows about them.
- */
-export async function detectUserEdits(dir, manifest) {
-    const edits = [];
-    // 1. Uncommitted changes to tracked files (skip if no commits yet)
-    // Use -c core.quotePath=false to get real filenames instead of octal-escaped quoted strings
-    // for non-ASCII characters (e.g. "caf\303\251.txt" → café.txt)
-    try {
-        execFileSync('git', ['rev-parse', 'HEAD'], { cwd: dir, stdio: 'pipe' });
-        const modified = execFileSync('git', ['-c', 'core.quotePath=false', 'diff', '--name-only', 'HEAD'], { cwd: dir, encoding: 'utf-8' }).trim();
-        const staged = execFileSync('git', ['-c', 'core.quotePath=false', 'diff', '--cached', '--name-only'], { cwd: dir, encoding: 'utf-8' }).trim();
-        for (const file of [...modified.split('\n'), ...staged.split('\n')]) {
-            if (file && !edits.includes(file))
-                edits.push(file);
-        }
-    }
-    catch {
-        // No git repo or no commits yet
-    }
-    // 2. Untracked files that aren't template files
-    try {
-        const untracked = execFileSync('git', ['-c', 'core.quotePath=false', 'ls-files', '--others', '--exclude-standard'], { cwd: dir, encoding: 'utf-8' }).trim();
-        for (const relPath of untracked.split('\n')) {
-            if (!relPath)
-                continue;
-            // Skip files in ignored directories
-            if (relPath.startsWith('node_modules/') || relPath.startsWith('.runwork/'))
-                continue;
-            // If it's a pristine template file, skip it
-            const expectedHash = manifest.files[relPath];
-            if (expectedHash) {
-                const content = readFileSync(join(dir, relPath));
-                if (sha256(content) === expectedHash)
-                    continue;
-            }
-            if (!edits.includes(relPath))
-                edits.push(relPath);
-        }
-    }
-    catch {
-        // No git repo
-    }
-    // 3. Scan manifest files on disk directly — catches gitignored files that
-    // git ls-files --exclude-standard would miss. If a template file was added
-    // to .gitignore by the user and then modified, only this check detects it.
-    //
-    // Tracked files are excluded here because their state is fully described
-    // by Method 1 (`git diff HEAD`). After `runwork clone`, AI-customized
-    // versions of template files are committed at HEAD and would otherwise be
-    // false-flagged on every fresh clone.
-    const trackedFiles = new Set();
-    try {
-        const tracked = execFileSync('git', ['-c', 'core.quotePath=false', 'ls-files'], { cwd: dir, encoding: 'utf-8' }).trim();
-        for (const relPath of tracked.split('\n')) {
-            if (relPath)
-                trackedFiles.add(relPath);
-        }
-    }
-    catch {
-        // No git repo — every manifest file remains a candidate for Method 3.
-    }
-    for (const [relPath, expectedHash] of Object.entries(manifest.files)) {
-        if (edits.includes(relPath))
-            continue;
-        if (trackedFiles.has(relPath))
-            continue;
-        const filePath = join(dir, relPath);
-        try {
-            const content = readFileSync(filePath);
-            if (sha256(content) !== expectedHash) {
-                edits.push(relPath);
-            }
-        }
-        catch {
-            // File doesn't exist on disk — not an edit to detect
-        }
-    }
-    return edits;
-}

package/dist/tools/types.d.ts

@@ -1,52 +0,0 @@
-/**
- * Shared types for everything Runwork can detect and offer to install
- * locally. Both AI agents and developer prerequisites (git, etc.) extend
- * `InstallableTool` so the desktop can render and detect them uniformly.
- *
- * Browser-safe: no node-only imports.
- */
-/** Platform-specific string. Plain string = same on all platforms. */
-export type PlatformString = string | {
-    default?: string;
-    macos?: string;
-    windows?: string;
-    linux?: string;
-};
-/**
- * Detection strategy. Supports simple binary/path checks plus richer
- * Windows-specific methods and a nested `any` combinator for tools that
- * ship as both GUI app and CLI binary.
- *
- * `always` means "no local probe; treat as available." Used by web-only
- * agents (e.g. ChatGPT Web) that have no local footprint to detect.
- */
-export type Detection = {
-    method: 'binary' | 'path';
-    target: PlatformString;
-} | {
-    method: 'windows-appx' | 'windows-start-app';
-    target: string | string[];
-} | {
-    method: 'any';
-    target: Detection[];
-} | {
-    method: 'always';
-};
-/**
- * Common shape for anything that can be detected and installed locally.
- * AI agents and developer tools both extend this.
- */
-export interface InstallableTool {
-    /** Stable identifier, kebab-case (e.g. "claude-code", "git"). */
-    slug: string;
-    /** Display name. */
-    name: string;
-    /** One-line description shown in lists. */
-    description: string;
-    /** How to determine whether this tool is installed locally. */
-    detection: Detection;
-    /** Public install/download URL — universal fallback when auto-install isn't available. */
-    downloadUrl?: string;
-    /** Logo identifier (matches an entry in the desktop's logo map). Optional. */
-    logo?: string;
-}

package/dist/tools/types.js

@@ -1,8 +0,0 @@
-/**
- * Shared types for everything Runwork can detect and offer to install
- * locally. Both AI agents and developer prerequisites (git, etc.) extend
- * `InstallableTool` so the desktop can render and detect them uniformly.
- *
- * Browser-safe: no node-only imports.
- */
-export {};

package/dist/types-manager.d.ts

@@ -1 +0,0 @@
-export declare function populateTypes(projectDir: string): Promise<void>;

package/dist/types-manager.js

@@ -1,35 +0,0 @@
-import { existsSync, mkdirSync, readdirSync, copyFileSync, writeFileSync } from 'fs';
-import { join } from 'path';
-import { BUNDLED_TYPES } from './generated/bundled-types.js';
-const TYPES_DIR = '.runwork/types';
-export async function populateTypes(projectDir) {
-    const typesDir = join(projectDir, TYPES_DIR);
-    mkdirSync(typesDir, { recursive: true });
-    // Tier 1: Copy from node_modules/@runworkai/framework/dist/
-    const frameworkDist = join(projectDir, 'node_modules/@runworkai/framework/dist');
-    if (existsSync(frameworkDist)) {
-        copyDtsFiles(frameworkDist, typesDir);
-        console.log('Types populated from node_modules/@runworkai/framework');
-        return;
-    }
-    // Tier 2: Download from platform (TODO - stub for now)
-    // Will be implemented when platform has a types download endpoint
-    // Tier 3: Write from embedded bundled types
-    const typeEntries = Object.entries(BUNDLED_TYPES);
-    if (typeEntries.length > 0) {
-        for (const [filename, content] of typeEntries) {
-            writeFileSync(join(typesDir, filename), content);
-        }
-        console.log('Types populated from bundled types');
-        return;
-    }
-    console.warn('No type definitions found. Install @runworkai/framework or reinstall the CLI.');
-}
-function copyDtsFiles(srcDir, destDir) {
-    const files = readdirSync(srcDir);
-    for (const file of files) {
-        if (file.endsWith('.d.ts')) {
-            copyFileSync(join(srcDir, file), join(destDir, file));
-        }
-    }
-}