@aiwg/cli 2026.8.8 → 2026.8.10

package/tools/agents/providers/windsurf.mjs

@@ -1,7 +1,9 @@
 /**
- * Windsurf Provider (EXPERIMENTAL)
+ * Devin Desktop Provider (Windsurf compatibility adapter)
  *
- * Deploys agents to Windsurf format with aggregated AGENTS.md and trigger-frontmatter rules.
+ * Deploys agents to the Devin Desktop/Windsurf compatibility surface with
+ * aggregated AGENTS.md and trigger-frontmatter rules. The provider id and
+ * generated `.windsurf/` paths remain stable for backward compatibility.
  *
  * Deployment paths:
  *   - Output: AGENTS.md (aggregated agents)
@@ -18,7 +20,7 @@
  *   - Capabilities tags for tools
  *   - Workflow format for commands
  *   - Conventional skills and rules deployment
- *   - EXPERIMENTAL: Untested, may require adjustments
+ *   - Devin Desktop selectors resolve to the stable `windsurf` provider id
  */
 
 import realFs from 'fs';
@@ -57,7 +59,7 @@ import {
 // ============================================================================
 
 export const name = 'windsurf';
-export const aliases = [];
+export const aliases = ['devin', 'devin-desktop', 'devin-local', 'cascade'];
 
 export const paths = {
   agents: '.windsurf/agents/',      // Discrete mirrors alongside AGENTS.md
@@ -85,17 +87,6 @@ export const capabilities = {
   yamlFormat: false
 };
 
-// ============================================================================
-// Warning Display
-// ============================================================================
-
-function displayWarning() {
-  console.log('\n' + '='.repeat(70));
-  console.log('[EXPERIMENTAL] Windsurf provider support is experimental and untested.');
-  console.log('Please report issues: https://github.com/jmagly/aiwg/issues');
-  console.log('='.repeat(70) + '\n');
-}
-
 // ============================================================================
 // Content Transformation
 // ============================================================================
@@ -253,12 +244,12 @@ export function generateAgentsMd(files, destPath, opts) {
   // refuses to replace the legacy 2MB+ aggregate writer's output.
   lines.push('<!-- aiwg-managed -->');
   lines.push('');
-  lines.push('> AIWG Agent Directory for Windsurf');
+  lines.push('> AIWG Agent Directory for Devin Desktop');
   lines.push('');
   lines.push('<!--');
-  lines.push('  [EXPERIMENTAL] Generated by AIWG for Windsurf');
-  lines.push('  Windsurf reads this file for directory-scoped AI instructions.');
-  lines.push('  See: https://docs.windsurf.com/windsurf/cascade/agents-md');
+  lines.push('  Generated by AIWG for Devin Desktop using the Windsurf compatibility adapter.');
+  lines.push('  Devin Desktop reads this file for directory-scoped AI instructions.');
+  lines.push('  See: https://docs.devin.ai/onboard-devin/agents-md');
   lines.push('-->');
   lines.push('');
   lines.push('## Table of Contents');
@@ -316,10 +307,10 @@ export function generateWindsurfRules(srcRoot, target, opts) {
   lines.push('trigger: always_on');
   lines.push('---');
   lines.push('');
-  lines.push('# AIWG Orchestration for Windsurf');
+  lines.push('# AIWG Orchestration for Devin Desktop');
   lines.push('');
   lines.push('<!--');
-  lines.push('  [EXPERIMENTAL] Generated by AIWG for Windsurf');
+  lines.push('  Generated by AIWG for Devin Desktop using the Windsurf compatibility adapter.');
   lines.push('  This file provides orchestration context for AIWG SDLC workflows.');
   lines.push('  trigger: always_on — included in system prompt on every message.');
   lines.push('-->');
@@ -556,9 +547,7 @@ export async function deploy(opts) {
     dryRun
   } = opts;
 
-  displayWarning();
-
-  console.log(`\n=== Windsurf Provider (EXPERIMENTAL) ===`);
+  console.log(`\n=== Devin Desktop Provider (windsurf compatibility adapter) ===`);
   console.log(`Target: ${target}`);
   console.log(`Mode: ${mode}`);
   const normalizedMode = normalizeDeploymentMode(mode);

package/tools/skills/deploy-skills-codex.mjs

@@ -417,6 +417,17 @@ function isFullAiwgSourceRoot(srcRoot) {
   const repoRoot = path.resolve(scriptDir, '..', '..');
   const srcRoot = source || repoRoot;
   const fullAiwgSourceRoot = isFullAiwgSourceRoot(srcRoot);
+  const copyStandardSkills = cfg.copyStandardSkills === true;
+  // Component-scoped deploys (the way `aiwg use all` installs selected
+  // frameworks/addons) still need a complete inventory for stale-skill
+  // reconciliation.  AIWG_ROOT is supplied by the orchestrator for exactly
+  // this purpose; fall back to the script checkout for standalone use.
+  const configuredAiwgRoot = process.env.AIWG_ROOT
+    ? path.resolve(process.env.AIWG_ROOT)
+    : repoRoot;
+  const inventoryRoot = fullAiwgSourceRoot
+    ? srcRoot
+    : (!copyStandardSkills && isFullAiwgSourceRoot(configuredAiwgRoot) ? configuredAiwgRoot : null);
 
   console.log(`Deploying skills to Codex`);
   console.log(`  Source: ${srcRoot}`);
@@ -440,8 +451,6 @@ function isFullAiwgSourceRoot(srcRoot) {
   // Codex normally deploys to the project `.agents/skills/` target, so the
   // kernel/standard split is enforced at filter time rather than via separate
   // destination directories. The standalone legacy default remains supported.
-  const copyStandardSkills = cfg.copyStandardSkills === true;
-
   // Track every AIWG-managed source skill name so we can scope post-deploy
   // cleanup to skills AIWG ships — never delete user-authored or
   // third-party skills sitting alongside.
@@ -457,10 +466,13 @@ function isFullAiwgSourceRoot(srcRoot) {
   // so full-root cleanup can remove stale AIWG skills. Component-scoped
   // cleanup is limited below to names owned by that component, preserving
   // user-authored skills alongside the generated set.
-  for (const { dir } of getSkillDirectories(srcRoot, 'all')) {
+  for (const { dir } of getSkillDirectories(inventoryRoot || srcRoot, 'all')) {
     const allSkills = findSkillDirs(dir);
     for (const s of allSkills) {
       allManagedNames.add(path.basename(s));
+      if (!copyStandardSkills && isKernelSkill(s)) {
+        desiredNames.add(path.basename(s));
+      }
       // Also record the frontmatter `name:` since Codex uses that as the
       // target dir. Best-effort — ignore parse errors.
       try {
@@ -469,7 +481,11 @@ function isFullAiwgSourceRoot(srcRoot) {
         if (fmMatch) {
           const nameMatch = fmMatch[1].match(/^\s*name:\s*(.+?)\s*$/m);
           if (nameMatch) {
-            allManagedNames.add(stripWrappingQuotes(nameMatch[1]));
+            const deployedName = stripWrappingQuotes(nameMatch[1]);
+            allManagedNames.add(deployedName);
+            if (!copyStandardSkills && isKernelSkill(s)) {
+              desiredNames.add(deployedName);
+            }
           }
         }
       } catch { /* ignore */ }
@@ -528,7 +544,7 @@ function isFullAiwgSourceRoot(srcRoot) {
       // the .aiwg-managed marker. Treat only the exact historical names as
       // managed so malformed legacy frontmatter cannot survive an upgrade.
       let isAiwgManaged = allManagedNames.has(name) || LEGACY_RENAMED_SKILLS.has(name);
-      if (!isAiwgManaged && fullAiwgSourceRoot) {
+      if (!isAiwgManaged && (fullAiwgSourceRoot || inventoryRoot)) {
         // Check for the .aiwg-managed marker file (preferred — survives
         // frontmatter transforms) or fall back to namespace check.
         const markerFile = path.join(target, name, '.aiwg-managed');