@softspark/ai-toolkit 4.6.0 → 4.7.0

package/scripts/generate_windsurf_rules.py

@@ -1,17 +1,25 @@
 #!/usr/bin/env python3
-"""Generate ``.windsurf/rules/*.md`` (and workflows) for Windsurf IDE.
+"""Generate ``.devin/rules/*.md`` and ``.windsurf/rules/*.md`` (and workflows)
+for Devin Desktop (formerly Windsurf).
 
-Windsurf reads directory-based rules from ``.windsurf/rules/*.md`` (since
-mid-2025). Each rule file supports YAML frontmatter with these fields
-(from docs.windsurf.com/windsurf/cascade/memories):
+Windsurf rebranded to Devin Desktop on 2026-06-02. ``.devin/`` is now the
+primary read+write workspace tree; ``.windsurf/`` is a legacy read-only
+fallback that current builds still honor (docs.devin.ai/desktop/devin-desktop-faq:
+"The application already supports .devin/ as the primary workspace directory
+and falls back to .windsurf/ for backward compatibility"). We dual-emit the
+same content to both trees so old Windsurf builds keep working during the
+transition.
+
+Each rule file supports YAML frontmatter with these fields
+(from docs.devin.ai/desktop — memories docs):
 
 * ``trigger`` — activation mode: ``always_on`` | ``glob`` | ``model_decision``
-  | ``manual``. When omitted, Windsurf defaults to manual-only.
+  | ``manual``. When omitted, the IDE defaults to manual-only.
 * ``globs`` — comma-separated glob patterns (only when ``trigger: glob``).
 * ``description`` — shown to the model when ``trigger: model_decision``.
 
-Windsurf also reads workflow markdown files from ``.windsurf/workflows/*.md``
-which users invoke via ``/<name>`` slash commands (Cascade). This generator
+Workflow markdown files (invoked via ``/<name>`` slash commands) are emitted
+to ``.devin/workflows/*.md`` and ``.windsurf/workflows/*.md``. This generator
 emits the same workflow catalogue used by Antigravity and Cline.
 
 The legacy ``.windsurfrules`` single-file format is still produced by
@@ -142,20 +150,26 @@ def _build_rules(language_modules: list[str] | None,
 
 
 # ---------------------------------------------------------------------------
-# Workflows — .windsurf/workflows/<name>.md invocable via /<name>
+# Workflows — <tree>/workflows/<name>.md invocable via /<name>
 # ---------------------------------------------------------------------------
 
+# .devin/ is primary since the 2026-06-02 Devin Desktop rebrand; .windsurf/
+# is the legacy fallback still read by pre-rebrand builds.
+CONFIG_TREES: tuple[str, ...] = (".devin", ".windsurf")
+
+
 def _write_workflows(target_dir: Path, *, cleanup: bool = True) -> None:
-    """Write ``.windsurf/workflows/*.md`` files for Cascade slash commands."""
-    workflows_dir = target_dir / ".windsurf" / "workflows"
-    workflows_dir.mkdir(parents=True, exist_ok=True)
+    """Write ``workflows/*.md`` slash-command files to both config trees."""
+    for tree in CONFIG_TREES:
+        workflows_dir = target_dir / tree / "workflows"
+        workflows_dir.mkdir(parents=True, exist_ok=True)
 
-    if cleanup:
-        cleanup_stale(workflows_dir, set(STANDARD_WORKFLOWS.keys()))
+        if cleanup:
+            cleanup_stale(workflows_dir, set(STANDARD_WORKFLOWS.keys()))
 
-    for filename, content_fn in STANDARD_WORKFLOWS.items():
-        (workflows_dir / filename).write_text(content_fn(), encoding="utf-8")
-        print(f"  Generated: .windsurf/workflows/{filename}")
+        for filename, content_fn in STANDARD_WORKFLOWS.items():
+            (workflows_dir / filename).write_text(content_fn(), encoding="utf-8")
+            print(f"  Generated: {tree}/workflows/{filename}")
 
 
 # ---------------------------------------------------------------------------
@@ -170,15 +184,16 @@ def generate(target_dir: Path, *,
              managed_scopes: tuple[str, ...] = (
                  STANDARD_SCOPE, LANG_SCOPE, CUSTOM_SCOPE,
              )) -> None:
-    """Write ``.windsurf/rules/*.md`` and ``.windsurf/workflows/*.md``."""
+    """Write ``rules/*.md`` and ``workflows/*.md`` to both config trees."""
     rules = _build_rules(language_modules, rules_dir)
-    write_rules(
-        target_dir,
-        rules,
-        ".windsurf/rules",
-        cleanup=cleanup,
-        managed_scopes=managed_scopes,
-    )
+    for tree in CONFIG_TREES:
+        write_rules(
+            target_dir,
+            rules,
+            f"{tree}/rules",
+            cleanup=cleanup,
+            managed_scopes=managed_scopes,
+        )
 
     if emit_workflows:
         _write_workflows(target_dir, cleanup=cleanup)

package/scripts/generate_windsurf_skills.py

@@ -1,5 +1,11 @@
 #!/usr/bin/env python3
-"""Generate a Windsurf skill pointer under ``.windsurf/skills/``."""
+"""Generate a Devin Desktop (formerly Windsurf) skill pointer.
+
+Dual-emits under ``.devin/skills/`` (primary since the 2026-06-02 rebrand)
+and ``.windsurf/skills/`` (legacy fallback). Pass an explicit ``skill_root``
+to emit a single location instead (used for the ``~/.codeium/windsurf/``
+global install path).
+"""
 from __future__ import annotations
 
 import sys
@@ -8,13 +14,17 @@ from pathlib import Path
 sys.path.insert(0, str(Path(__file__).resolve().parent))
 from skill_pointer import POINTER_SKILL_NAME, write_pointer_skill
 
+DEFAULT_SKILL_ROOTS: tuple[str, ...] = (".devin/skills", ".windsurf/skills")
+
 
 def generate(target_dir: Path, *, emit_skill_pointer: bool = True,
-             skill_root: str = ".windsurf/skills") -> None:
+             skill_root: str | None = None) -> None:
     if not emit_skill_pointer:
         return
-    write_pointer_skill(target_dir, skill_root, "Windsurf")
-    print(f"  Generated: {skill_root}/{POINTER_SKILL_NAME}/SKILL.md")
+    roots = (skill_root,) if skill_root else DEFAULT_SKILL_ROOTS
+    for root in roots:
+        write_pointer_skill(target_dir, root, "Windsurf")
+        print(f"  Generated: {root}/{POINTER_SKILL_NAME}/SKILL.md")
 
 
 def main() -> None:

package/scripts/install_steps/ai_tools.py

@@ -381,6 +381,9 @@ _EDITOR_MARKERS: dict[str, str] = {
     ".cursor/rules": "cursor",
     ".windsurfrules": "windsurf",
     ".windsurf/rules": "windsurf",
+    # .devin/ is the primary Devin Desktop tree since the 2026-06-02 rebrand;
+    # .windsurf/ markers stay to detect legacy installs.
+    ".devin/rules": "windsurf",
     ".clinerules": "cline",
     ".roomodes": "roo",
     ".roo/rules": "roo",
@@ -411,11 +414,25 @@ def _detect_editors(cwd: Path) -> list[str]:
     found: set[str] = set()
     for marker, editor in _EDITOR_MARKERS.items():
         p = cwd / marker
-        if p.exists():
-            found.add(editor)
+        if not p.exists():
+            continue
+        if marker == ".agents/skills" and _is_pointer_only_skills_dir(p):
+            # The Antigravity CLI pointer skill also lives in .agents/skills/;
+            # only real (materialized) skills indicate a Codex install.
+            continue
+        found.add(editor)
     return sorted(found)
 
 
+def _is_pointer_only_skills_dir(skills_dir: Path) -> bool:
+    """True when a skills dir holds only the ai-toolkit pointer skill."""
+    try:
+        entries = [e.name for e in skills_dir.iterdir() if not e.name.startswith(".")]
+    except OSError:
+        return False
+    return entries == ["ai-toolkit-skill-catalogue"]
+
+
 def _resolve_editors(editors_arg: str, cwd: Path) -> list[str]:
     """Resolve --editors argument to a list of editor names.
 
@@ -709,7 +726,7 @@ def _install_local_dry_run(reset: bool, editors: list[str] | None = None,
     _EDITOR_DRY_RUN = {
         "copilot":      "  Would inject: .github/copilot-instructions.md",
         "cursor":       "  Would generate: .cursorrules + .cursor/rules/*.mdc",
-        "windsurf":     "  Would generate: .windsurfrules + .windsurf/rules/*.md",
+        "windsurf":     "  Would generate: .windsurfrules + .devin/rules/*.md + .windsurf/rules/*.md",
         "cline":        "  Would generate: .clinerules/*.md",
         "roo":          "  Would generate: .roomodes + .roo/rules/*.md",
         "aider":        "  Would generate: .aider.conf.yml + CONVENTIONS.md",
@@ -731,7 +748,7 @@ def _install_local_dry_run(reset: bool, editors: list[str] | None = None,
         if "cursor" in eds:
             print("  Would generate: .cursor/hooks.json + .cursor/agents/ + .cursor/skills/ (profile=full)")
         if "windsurf" in eds:
-            print("  Would generate: .windsurf/hooks.json + .windsurf/skills/ (profile=full)")
+            print("  Would generate: .windsurf/hooks.json + .devin/skills/ + .windsurf/skills/ (profile=full)")
         if "cline" in eds:
             print("  Would generate: .cline/skills/ (profile=full)")
         if "augment" in eds:

package/scripts/validate.py

@@ -851,6 +851,7 @@ _README_PLATFORM_KEY = {
     "claude code": "claude",
     "cursor": "cursor",
     "windsurf": "windsurf",
+    "windsurf (devin desktop)": "windsurf",
     "gemini cli": "gemini",
     "github copilot": "copilot",
     "cline": "cline",