fss-link 1.9.2 → 1.9.3

package/bundle/worktrees/SKILL.md

@@ -0,0 +1,102 @@
+---
+name: worktrees
+description: >
+  Git worktrees for isolated parallel development across agents.
+  Use when starting feature work that needs isolation, before executing
+  plans that risk breaking the main branch, or when another agent is
+  already working in the project.
+category: workflow
+triggers: [worktree, isolated, parallel, branch workspace]
+version: 1
+---
+
+# Git Worktrees — Isolated Parallel Development
+
+**Use when:** Multiple agents need to work on different features simultaneously without interfering with each other.
+
+## When to Use
+
+- Starting feature work that needs isolation from the current workspace
+- Before executing implementation plans that risk breaking the main branch
+- When another agent is already working in the project
+
+## When NOT to Use
+
+- The user simply asks to fix a bug or implement a feature — those belong to the regular working directory
+- You are already inside a worktree
+- The project is not a git repository
+
+## Creating a Worktree
+
+Use the `enter_worktree` tool:
+
+```
+enter_worktree({ name: "fix-auth-bug" })
+```
+
+Returns:
+- `worktreePath` — absolute path (e.g., `/path/to/project/.fss-link/worktrees/fix-auth-bug`)
+- `branch` — git branch name (e.g., `fss-link-fix-auth-bug`)
+
+**CRITICAL:** Every tool call must use the full absolute `worktreePath`. Never use relative paths.
+
+```bash
+# ✅ CORRECT — absolute path
+write_file({ path: "/path/to/project/.fss-link/worktrees/fix-auth-bug/src/auth.ts", ... })
+
+# ❌ WRONG — relative path modifies the MAIN checkout
+write_file({ path: "src/auth.ts", ... })
+```
+
+## Verifying You Are in the Worktree
+
+```bash
+pwd  # Should show .../.fss-link/worktrees/<slug>/
+git branch --show-current  # Should show fss-link-<slug>
+```
+
+## Project Setup
+
+Auto-detect and run appropriate setup:
+
+```bash
+cd /path/to/project/.fss-link/worktrees/fix-auth-bug && npm install
+cd /path/to/project/.fss-link/worktrees/fix-auth-bug && cargo build
+cd /path/to/project/.fss-link/worktrees/fix-auth-bug && pip install -r requirements.txt
+```
+
+## Exiting a Worktree
+
+```
+exit_worktree({ name: "fix-auth-bug", action: "keep" })      # Work in progress
+exit_worktree({ name: "fix-auth-bug", action: "remove" })    # Work committed
+exit_worktree({ name: "fix-auth-bug", action: "remove", discard_changes: true })  # Discard everything
+```
+
+## Quick Reference
+
+| Situation | Action |
+|-----------|--------|
+| Need isolated workspace | `enter_worktree({ name: "feature-name" })` |
+| Already in a worktree | Do NOT call enter_worktree again |
+| Done, work in progress | `exit_worktree({ name, action: "keep" })` |
+| Done, work committed | `exit_worktree({ name, action: "remove" })` |
+| Done, discard everything | `exit_worktree({ name, action: "remove", discard_changes: true })` |
+
+## Common Mistakes
+
+1. **Using relative paths** — Always use full `worktreePath` for every tool call
+2. **Creating nested worktrees** — Check path first; if it contains `.fss-link/worktrees/`, you're already in one
+3. **Running `git worktree add` manually** — Always use the `enter_worktree` tool
+4. **Removing with uncommitted changes** — Commit or stash first, or use `discard_changes: true`
+
+## Global Flags
+
+N/A — this is a workflow skill, not a CLI tool.
+
+---
+
+*This skill is part of the FSS Parsers collection.*
+
+**References:**
+- Full procedural guide → `references/capabilities.md`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fss-link",
-  "version": "1.9.2",
+  "version": "1.9.3",
   "engines": {
     "node": ">=20.0.0"
   },
@@ -13,7 +13,7 @@
     "url": "git+https://github.com/FSSCoding/fss-link.git"
   },
   "config": {
-    "sandboxImageUri": "ghcr.io/fsscoding/fss-link:1.9.2"
+    "sandboxImageUri": "ghcr.io/fsscoding/fss-link:1.9.3"
   },
   "scripts": {
     "start": "node scripts/start.js",

package/scripts/copy_bundle_assets.js

@@ -46,4 +46,22 @@ for (const file of sbFiles) {
   copyFileSync(join(root, file), join(bundleDir, basename(file)));
 }
 
+// Copy bundled default skills (SKILL.md files) alongside the bundled JS.
+// bundledSkills.ts reads these via `path.join(__dirname, './<dir>/SKILL.md')`
+// relative to the running bundle/fss-link-main.js, so the source tree layout
+// (packages/core/src/bundled-skills/<dir>/SKILL.md) must be mirrored here as
+// bundle/<dir>/SKILL.md — esbuild only bundles JS, it never copies these.
+const skillFiles = glob.sync('packages/core/src/bundled-skills/**/SKILL.md', {
+  cwd: root,
+});
+for (const file of skillFiles) {
+  const rel = file.replace('packages/core/src/bundled-skills/', '');
+  const dest = join(bundleDir, rel);
+  mkdirSync(dirname(dest), { recursive: true });
+  copyFileSync(join(root, file), dest);
+}
+if (skillFiles.length > 0) {
+  console.log(`Bundled skills copied to bundle/ (${skillFiles.length} file(s))`);
+}
+
 console.log('Assets copied to bundle/');