trekoon 0.2.4 → 0.2.6

package/.agents/skills/trekoon/SKILL.md

@@ -42,6 +42,15 @@ Fail fast if the envelope reports `recoveryRequired`, a storage mismatch, or any
 bootstrap error. In linked worktrees, `sharedStorageRoot` may differ from
 `worktreeRoot`; that is expected because the repo shares one DB across checkouts.
 
+If the session envelope shows `behind > 0`, pull before claiming any task:
+
+```bash
+trekoon --toon sync pull --from main
+```
+
+This syncs tracker events (not git commits) from the source branch so task
+states, dependencies, and subtrees are up to date before you start work.
+
 ### 2. Claim work explicitly
 
 ```bash

package/README.md

@@ -608,16 +608,18 @@ Path behavior:
 - `--to <path>` overrides the editor root for link creation only.
 - `--to` does **not** move or copy `SKILL.md` to that path.
 - By default, link targets must resolve inside the current working directory root.
+- Editor symlinks are written with relative targets so repo-local links survive
+  moving the repository.
 - Use `--allow-outside-repo` only for intentional external links.
 - When override is used, install prints a warning and includes confirmation
   fields in machine output.
 - Re-running install is idempotent: it refreshes `SKILL.md` and reuses/replaces
   the same symlink target.
 - `trekoon skills update` is idempotent: it refreshes canonical
-  `.agents/skills/trekoon/SKILL.md` and reports default link states for
-  opencode/claude/pi as `missing`, `valid`, or `conflict`.
-- Update does not mutate default links; conflicts are reported with actionable
-  path context.
+  `.agents/skills/trekoon/SKILL.md` and creates or refreshes default editor
+  links when their config directories exist.
+- Update skips editors with no config dir and leaves conflicts untouched while
+  reporting actionable path context.
 - If the link destination exists as a non-link path, install fails with an
   actionable conflict error.
 
@@ -628,7 +630,7 @@ How `--to` works (step-by-step):
 2. If `--link` is present, Trekoon creates a `trekoon` symlink directory entry.
 3. `--to <path>` sets the symlink root directory.
 4. Final link path is:
-   - `<resolved-to-path>/trekoon -> <cwd>/.agents/skills/trekoon`
+   - `<resolved-to-path>/trekoon -> <relative path to <cwd>/.agents/skills/trekoon>`
 
 Example:
 
@@ -640,7 +642,7 @@ This produces:
 
 - `<cwd>/.agents/skills/trekoon/SKILL.md` (copied file)
 - `<cwd>/.custom-editor/skills/trekoon` (symlink)
-- symlink target: `<cwd>/.agents/skills/trekoon`
+- symlink target: relative path to `<cwd>/.agents/skills/trekoon`
 
 Trekoon does not mutate global editor config directories.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "trekoon",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "description": "AI-first local issue tracker CLI.",
   "license": "MIT",
   "type": "module",

package/src/commands/skills.ts

@@ -215,6 +215,11 @@ function resolveDefaultLinkPath(cwd: string, editor: EditorName): string {
   return join(resolveLinkRoot(cwd, editor, undefined), "trekoon");
 }
 
+function toRelativeSymlinkTarget(linkPath: string, targetPath: string): string {
+  const relativeTarget: string = relative(dirname(linkPath), resolve(targetPath));
+  return relativeTarget === "" ? "." : relativeTarget;
+}
+
 function resolveEditorConfigDir(cwd: string, editor: EditorName): string {
   if (editor === "opencode") {
     return join(cwd, ".opencode");
@@ -279,13 +284,15 @@ function replaceOrCreateSymlink(
   repoRoot: string,
   allowOutsideRepo: boolean,
 ): CliResult | null {
+  const symlinkTarget: string = toRelativeSymlinkTarget(linkPath, targetPath);
+
   if (!existsSync(linkPath)) {
     mkdirSync(dirname(linkPath), { recursive: true });
     const boundaryFailure = revalidateLinkParentBoundary(repoRoot, linkPath, allowOutsideRepo);
     if (boundaryFailure) {
       return boundaryFailure;
     }
-    symlinkSync(targetPath, linkPath, "dir");
+    symlinkSync(symlinkTarget, linkPath, "dir");
     return null;
   }
 
@@ -331,7 +338,7 @@ function replaceOrCreateSymlink(
   if (boundaryFailure) {
     return boundaryFailure;
   }
-  symlinkSync(targetPath, linkPath, "dir");
+  symlinkSync(symlinkTarget, linkPath, "dir");
   return null;
 }
 
@@ -489,6 +496,7 @@ function updateEditorLink(
 ): UpdateLinkEntry {
   const linkPath: string = resolveDefaultLinkPath(cwd, editor);
   const expectedTarget: string = resolve(installedDir);
+  const symlinkTarget: string = toRelativeSymlinkTarget(linkPath, expectedTarget);
   const editorConfigDir: string = resolveEditorConfigDir(cwd, editor);
 
   if (!existsSync(editorConfigDir)) {
@@ -504,7 +512,7 @@ function updateEditorLink(
 
   if (!existsSync(linkPath)) {
     mkdirSync(dirname(linkPath), { recursive: true });
-    symlinkSync(expectedTarget, linkPath, "dir");
+    symlinkSync(symlinkTarget, linkPath, "dir");
     return {
       editor,
       linkPath,
@@ -542,7 +550,7 @@ function updateEditorLink(
   }
 
   rmSync(linkPath, { force: true });
-  symlinkSync(expectedTarget, linkPath, "dir");
+  symlinkSync(symlinkTarget, linkPath, "dir");
   return {
     editor,
     linkPath,