clementine-agent 1.18.141 → 1.18.142

package/dist/cli/dashboard.js

@@ -39309,11 +39309,23 @@ async function refreshWorkflows() {
     var r = await apiFetch('/api/workflows');
     var data = await r.json();
     var workflows = data.workflows || [];
+    // 1.18.142 — Soft-deprecation banner. Always shown when there's at least
+    // one workflow on disk, hidden when the user has fully migrated. New
+    // users who never had workflows in the first place see a different empty
+    // state pointing them at Skills.
+    var banner = '';
+    if (workflows.length > 0) {
+      banner = '<div class="card" style="margin-bottom:14px;padding:12px 14px;background:var(--accent-glow);border-left:3px solid var(--accent)">' +
+        '<div style="font-weight:600;margin-bottom:4px">Workflows are being phased out → Skills</div>' +
+        '<div style="font-size:13px;color:var(--text-secondary);line-height:1.5">' +
+        'Skills cover the same use cases with better composability and the new builder. Use the <strong>Migrate</strong> button on any workflow row below to convert it into a vanilla Anthropic skill folder. Your existing workflows keep firing until you migrate them — nothing breaks.' +
+        '</div></div>';
+    }
     if (workflows.length === 0) {
-      containers.forEach(function(c) { c.innerHTML = '<div class="empty-state">No workflows defined. Create .md files in vault/00-System/workflows/</div>'; });
+      containers.forEach(function(c) { c.innerHTML = '<div class="empty-state">No workflows defined. <strong>Skills are the way forward</strong> — create one from the Skills tab. Workflow .md files in vault/00-System/workflows/ still work for legacy setups.</div>'; });
       return;
     }
-    var html = '';
+    var html = banner;
     workflows.forEach(function(wf) {
       var triggerLabel = wf.trigger && wf.trigger.schedule ? describeCron(wf.trigger.schedule) || wf.trigger.schedule : 'Manual only';
       var stepCount = wf.steps ? wf.steps.length : 0;
@@ -39324,6 +39336,7 @@ async function refreshWorkflows() {
       html += '<span class="badge ' + (wf.enabled ? 'badge-green' : 'badge-gray') + '" style="font-size:10px">' + (wf.enabled ? 'Enabled' : 'Disabled') + '</span>';
       html += '<button class="btn btn-sm" onclick="runWorkflow(\\x27' + esc(wf.name) + '\\x27)" style="font-size:10px;color:var(--green)">Run</button>';
       html += '<button class="btn btn-sm" onclick="showWorkflowRuns(\\x27' + esc(wf.name) + '\\x27)" style="font-size:10px">History</button>';
+      html += '<button class="btn btn-sm" onclick="migrateWorkflowToSkill(\\x27' + esc(wf.name) + '\\x27)" style="font-size:10px;color:var(--accent)" title="Convert this workflow into a vanilla Anthropic skill folder. Original is renamed to .md.migrated, kept on disk for rollback.">Migrate → Skill</button>';
       html += '</div>';
       html += '<div class="card-body">';
       if (wf.description) html += '<div style="font-size:13px;color:var(--text-secondary);margin-bottom:8px">' + esc(wf.description) + '</div>';
@@ -39367,6 +39380,30 @@ async function runWorkflow(name) {
   } catch(e) { toast(String(e), 'error'); }
 }
 
+// 1.18.142 — Convert a workflow into a vanilla skill folder, then refresh
+// the list so the migrated workflow disappears (its .md is renamed to
+// .md.migrated server-side and parseAllWorkflows stops picking it up).
+async function migrateWorkflowToSkill(name) {
+  if (!confirm('Migrate "' + name + '" into a skill folder?\n\n' +
+    '• A new skill will be created at vault/00-System/skills/<slug>/SKILL.md\n' +
+    '• The original workflow .md will be renamed to .md.migrated (kept for rollback)\n' +
+    '• The workflow stops firing; the skill is ready to schedule from the Skills tab')) return;
+  try {
+    var r = await apiFetch('/api/workflows/' + encodeURIComponent(name) + '/migrate-to-skill', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({}),
+    });
+    var d = await r.json();
+    if (d.ok) {
+      toast('Migrated "' + name + '" → skill "' + (d.skill && d.skill.name || '?') + '"' + (d.warning ? ' (' + d.warning + ')' : ''));
+      refreshWorkflows();
+    } else {
+      toast(d.error || 'Migration failed', 'error');
+    }
+  } catch(e) { toast(String(e), 'error'); }
+}
+
 async function showWorkflowRuns(name) {
   var safeId = 'wf-runs-' + name.replace(/[^a-zA-Z0-9]/g, '_');
   var panel = document.getElementById(safeId);

package/dist/cli/routes/workflows.js

@@ -3,7 +3,7 @@
  */
 import { Router } from 'express';
 import express from 'express';
-import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { existsSync, readFileSync, readdirSync, renameSync } from 'node:fs';
 import path from 'node:path';
 export function workflowsRouter(deps) {
     const router = Router();
@@ -68,6 +68,104 @@ export function workflowsRouter(deps) {
             res.status(500).json({ ok: false, error: String(e) });
         }
     });
+    /**
+     * 1.18.142 — Migrate a workflow into a vanilla Anthropic skill folder.
+     *
+     * Skills are subsuming workflows. To let users move at their own pace
+     * without breaking the workflow runtime, this endpoint converts ONE
+     * workflow at a time and renames the original .md → .md.migrated so
+     * the workflow runner stops picking it up but the file is still on
+     * disk for rollback.
+     *
+     * Conversion: workflow.name → skill name (slugified to Anthropic
+     * regex), workflow.description → skill description, raw workflow
+     * markdown body → skill procedure body (steps + synthesis prompt are
+     * preserved as documentation; runtime is the SDK reading the body).
+     * Frontmatter is rebuilt from scratch by writeSkill, so legacy
+     * workflow YAML doesn't leak into the new skill.
+     */
+    router.post('/:name/migrate-to-skill', express.json(), async (req, res) => {
+        try {
+            const name = decodeURIComponent(req.params.name);
+            const { parseAllWorkflows } = await import('../../agent/workflow-runner.js');
+            const { writeSkill } = await import('../../agent/skill-store.js');
+            const matter = (await import('gray-matter')).default;
+            // Find the workflow across global + agent scopes
+            const candidates = [];
+            if (existsSync(workflowsDir)) {
+                for (const wf of parseAllWorkflows(workflowsDir)) {
+                    if (wf.name === name)
+                        candidates.push({ wf });
+                }
+            }
+            if (existsSync(agentsBase)) {
+                for (const slug of readdirSync(agentsBase).filter(d => !d.startsWith('_'))) {
+                    const wfDir = path.join(agentsBase, slug, 'workflows');
+                    if (!existsSync(wfDir))
+                        continue;
+                    for (const wf of parseAllWorkflows(wfDir)) {
+                        if (wf.name === name)
+                            candidates.push({ wf, agentSlug: slug });
+                    }
+                }
+            }
+            if (candidates.length === 0) {
+                res.status(404).json({ ok: false, error: 'Workflow not found: ' + name });
+                return;
+            }
+            const { wf, agentSlug } = candidates[0];
+            // Slugify the workflow name to the Anthropic regex
+            const slug = name.toLowerCase().replace(/[^a-z0-9-]+/g, '-').replace(/^-+|-+$/g, '').slice(0, 64);
+            if (!/^[a-z0-9][a-z0-9-]{0,63}$/.test(slug)) {
+                res.status(400).json({ ok: false, error: `Workflow name "${name}" cannot be slugified to Anthropic regex` });
+                return;
+            }
+            // Build the skill body from the workflow's raw markdown body. The
+            // workflow runner's frontmatter is dropped — writeSkill rebuilds
+            // a clementine.* block from scratch. Steps and synthesis live as
+            // markdown for the SDK to read directly.
+            const raw = readFileSync(wf.sourceFile, 'utf-8');
+            const parsed = matter(raw);
+            const body = parsed.content.trim() || `Migrated from workflow "${name}". Add a procedure here.`;
+            const description = wf.description || `Migrated from workflow ${name}`;
+            let written;
+            try {
+                written = writeSkill({
+                    name: slug,
+                    title: wf.name,
+                    description,
+                    body,
+                    source: 'imported',
+                    agentSlug,
+                });
+            }
+            catch (err) {
+                res.status(409).json({ ok: false, error: String(err instanceof Error ? err.message : err) });
+                return;
+            }
+            // Rename the original .md → .md.migrated so parseAllWorkflows
+            // stops picking it up. File stays on disk for rollback.
+            const migratedPath = wf.sourceFile + '.migrated';
+            try {
+                renameSync(wf.sourceFile, migratedPath);
+            }
+            catch (err) {
+                // Skill is already written; surface the rename failure but don't
+                // roll back — the user can manually delete the .md if needed.
+                res.json({
+                    ok: true,
+                    skill: written,
+                    warning: `Skill created but original workflow file rename failed: ${String(err)}`,
+                });
+                return;
+            }
+            broadcastEvent({ type: 'workflow_migrated', data: { workflowName: name, skillSlug: slug, agentSlug } });
+            res.json({ ok: true, skill: written, originalRenamedTo: migratedPath });
+        }
+        catch (e) {
+            res.status(500).json({ ok: false, error: String(e) });
+        }
+    });
     router.get('/:name/runs', (_req, res) => {
         try {
             const name = decodeURIComponent(_req.params.name);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clementine-agent",
-  "version": "1.18.141",
+  "version": "1.18.142",
   "description": "Clementine — Personal AI Assistant (TypeScript)",
   "type": "module",
   "main": "dist/index.js",