@trackunit/iris-app 1.21.9 → 1.21.12

package/CHANGELOG.md

@@ -1,3 +1,33 @@
+## 1.21.12 (2026-05-28)
+
+### 🧱 Updated Dependencies
+
+- Updated iris-app-build-utilities to 1.18.10
+- Updated iris-app-api to 1.20.10
+- Updated react-vite-test-setup to 0.0.10
+- Updated shared-utils to 1.15.9
+
+## 1.21.11 (2026-05-28)
+
+### 🩹 Fixes
+
+- **iris-app-sdk:** preserve custom Claude skills symlinks ([0a394e8a976](https://github.com/Trackunit/manager/commit/0a394e8a976))
+- **iris-app-sdk:** address PR #23363 review comments ([#23363](https://github.com/Trackunit/manager/issues/23363))
+
+### ❤️ Thank You
+
+- Cursor @cursoragent
+- kla-trackunit
+
+## 1.21.10 (2026-05-27)
+
+### 🧱 Updated Dependencies
+
+- Updated iris-app-build-utilities to 1.18.9
+- Updated iris-app-api to 1.20.9
+- Updated react-vite-test-setup to 0.0.9
+- Updated shared-utils to 1.15.8
+
 ## 1.21.9 (2026-05-26)
 
 ### 🧱 Updated Dependencies

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trackunit/iris-app",
-  "version": "1.21.9",
+  "version": "1.21.12",
   "license": "SEE LICENSE IN LICENSE.txt",
   "main": "src/index.js",
   "generators": "./generators.json",
@@ -23,8 +23,8 @@
     "@nx/react": "22.6.5",
     "@npmcli/arborist": "^9.1.9",
     "win-ca": "^3.5.1",
-    "@trackunit/shared-utils": "1.15.7",
-    "@trackunit/iris-app-api": "1.20.8",
+    "@trackunit/shared-utils": "1.15.9",
+    "@trackunit/iris-app-api": "1.20.10",
     "tslib": "^2.6.2",
     "@clack/prompts": "^1.0.0",
     "@npm/types": "^1.0.2",

package/src/generators/ai-agent-sync/generator.d.ts

@@ -1,7 +1,7 @@
-import { Tree } from "@nx/devkit";
+import { GeneratorCallback, Tree } from "@nx/devkit";
 import { AiAgentSyncGeneratorSchema } from "./schema";
 /**
  * Syncs Cursor skills, AGENTS.md, CLAUDE.md, and AI agent configuration files.
  * Requires the SDK to be at the latest version before running.
  */
-export declare function aiAgentSyncGenerator(tree: Tree, options: AiAgentSyncGeneratorSchema): Promise<void>;
+export declare function aiAgentSyncGenerator(tree: Tree, options: AiAgentSyncGeneratorSchema): Promise<GeneratorCallback>;

package/src/generators/ai-agent-sync/generator.js

@@ -7,6 +7,7 @@ const devkit_exports_1 = require("nx/src/devkit-exports");
 const pacote = tslib_1.__importStar(require("pacote"));
 const path = tslib_1.__importStar(require("path"));
 const semver = tslib_1.__importStar(require("semver"));
+const link_claude_skills_1 = require("../utils/link-claude-skills");
 const IRIS_APP_PACKAGE = "@trackunit/iris-app";
 const UPDATE_SCRIPT_NAME = "update:trackunit";
 const UPDATE_SCRIPT_CMD = 'npx npm-check-updates "/@trackunit/" -u';
@@ -103,5 +104,16 @@ async function aiAgentSyncGenerator(tree, options) {
     const rootTemplatePath = path.join(__dirname, "../preset/root-files");
     (0, devkit_1.generateFiles)(tree, rootTemplatePath, ".", {});
     await (0, devkit_1.formatFiles)(tree);
+    // After tree flush, create a symlink at .claude/skills -> ../.agents/skills
+    // so Claude Code auto-discovers the same skills Cursor and Codex consume.
+    // The Tree API has no symlink primitive, so this runs as a post-generation
+    // callback against the actual filesystem.
+    return () => {
+        const result = (0, link_claude_skills_1.linkClaudeSkills)(tree.root);
+        if (result.status === "skipped") {
+            devkit_1.logger.warn(`[iris-app:ai-agent-sync] Skipped creating .claude/skills symlink: ${result.reason}. ` +
+                `Claude Code users may need to create it manually: ln -s ../.agents/skills .claude/skills`);
+        }
+    };
 }
 //# sourceMappingURL=generator.js.map

package/src/generators/preset/generator.js

@@ -6,6 +6,7 @@ const devkit_1 = require("@nx/devkit");
 const js_1 = require("@nx/js");
 const react_1 = require("@nx/react");
 const path_1 = tslib_1.__importDefault(require("path"));
+const link_claude_skills_1 = require("../utils/link-claude-skills");
 /**
  *  Preset generator for Iris apps workspace.
  *  Use with create-nx-workspace to create a new workspace for developing Iris apps.
@@ -56,7 +57,16 @@ async function presetGenerator(tree, options) {
     });
     // This react generator adds react 19 and react-dom 19 to the package.json if we don't add react 18 above.
     const initReact = await (0, react_1.reactInitGenerator)(tree, {});
-    return (0, devkit_1.runTasksInSerial)(jsInitTask, initReact);
+    // Post-flush task: symlink .claude/skills -> ../.agents/skills so Claude Code
+    // auto-discovers the same skills as Cursor/Codex without manual setup.
+    const linkSkillsTask = () => {
+        const result = (0, link_claude_skills_1.linkClaudeSkills)(tree.root);
+        if (result.status === "skipped") {
+            devkit_1.logger.warn(`[iris-app:preset] Skipped creating .claude/skills symlink: ${result.reason}. ` +
+                `Claude Code users may need to create it manually: ln -s ../.agents/skills .claude/skills`);
+        }
+    };
+    return (0, devkit_1.runTasksInSerial)(jsInitTask, initReact, linkSkillsTask);
 }
 function updateWorkspaceLayout(tree) {
     const nxJson = (0, devkit_1.readNxJson)(tree) ?? {};

package/src/generators/preset/root-files/CLAUDE.md

@@ -6,12 +6,12 @@ This is an IrisX App project generated by the Trackunit SDK. Follow AGENTS.md fo
 
 ## Skills
 
-SDK-specific skills are located in `.agents/skills/`. When a skill is referenced in AGENTS.md, read it from `.agents/skills/[skill-name]/SKILL.md`.
+SDK-specific skills live in `.agents/skills/`. The generator creates a `.claude/skills` symlink pointing at `../.agents/skills` so Claude Code auto-discovers them. When a skill is referenced in AGENTS.md, read it from `.agents/skills/[skill-name]/SKILL.md`.
 
-If skills from `.agents/skills/` are not appearing in your available skills list, suggest the user symlink them for automatic discovery:
+If skills are not appearing in your available skills list, the symlink may be missing (for example on Windows without Developer Mode, or if a real `.claude/skills` directory existed first). Recreate it with:
 
 ```bash
-ln -s .agents/skills .claude/skills
+ln -s ../.agents/skills .claude/skills
 ```
 
-Note: If the user already has a `.claude/skills` folder, they should symlink individual skills or the contents instead.
+If `.claude/skills` already exists as a real directory, move its contents into `.agents/skills/` and delete it before running the command above.

package/src/generators/utils/link-claude-skills.d.ts

@@ -0,0 +1,18 @@
+export type LinkClaudeSkillsResult = {
+    status: "created";
+} | {
+    status: "already-linked";
+} | {
+    status: "skipped";
+    reason: string;
+};
+/**
+ * Ensures `.claude/skills` is a symlink to `../.agents/skills` so Claude Code
+ * auto-discovers skills shared via `.agents/skills`.
+ *
+ * Idempotent: leaves an existing valid symlink alone, refuses to overwrite a
+ * real `.claude/skills` directory or file. Cross-platform-safe: catches
+ * symlink permission errors (e.g. Windows without Developer Mode) and returns
+ * a `skipped` result instead of throwing.
+ */
+export declare function linkClaudeSkills(workspaceRoot: string): LinkClaudeSkillsResult;

package/src/generators/utils/link-claude-skills.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.linkClaudeSkills = linkClaudeSkills;
+const tslib_1 = require("tslib");
+const fs = tslib_1.__importStar(require("fs"));
+const path = tslib_1.__importStar(require("path"));
+const CLAUDE_DIR = ".claude";
+const CLAUDE_SKILLS_NAME = "skills";
+const AGENTS_SKILLS_REL = path.join("..", ".agents", "skills");
+/**
+ * Ensures `.claude/skills` is a symlink to `../.agents/skills` so Claude Code
+ * auto-discovers skills shared via `.agents/skills`.
+ *
+ * Idempotent: leaves an existing valid symlink alone, refuses to overwrite a
+ * real `.claude/skills` directory or file. Cross-platform-safe: catches
+ * symlink permission errors (e.g. Windows without Developer Mode) and returns
+ * a `skipped` result instead of throwing.
+ */
+function linkClaudeSkills(workspaceRoot) {
+    const claudeDir = path.join(workspaceRoot, CLAUDE_DIR);
+    const linkPath = path.join(claudeDir, CLAUDE_SKILLS_NAME);
+    const agentsSkillsAbs = path.join(workspaceRoot, ".agents", "skills");
+    if (!fs.existsSync(agentsSkillsAbs)) {
+        return { status: "skipped", reason: ".agents/skills does not exist" };
+    }
+    fs.mkdirSync(claudeDir, { recursive: true });
+    const existingLstat = safeLstat(linkPath);
+    if (existingLstat?.isSymbolicLink()) {
+        const currentTarget = fs.readlinkSync(linkPath);
+        if (resolveSymlinkTarget({
+            currentTarget,
+            linkParentPath: claudeDir,
+        }) === path.resolve(agentsSkillsAbs)) {
+            return { status: "already-linked" };
+        }
+        return {
+            status: "skipped",
+            reason: `.claude/skills already exists as a symlink to ${currentTarget}`,
+        };
+    }
+    else if (existingLstat) {
+        return {
+            status: "skipped",
+            reason: `.claude/skills already exists as a ${existingLstat.isDirectory() ? "directory" : "file"}`,
+        };
+    }
+    try {
+        fs.symlinkSync(AGENTS_SKILLS_REL, linkPath, "dir");
+        return { status: "created" };
+    }
+    catch (error) {
+        return {
+            status: "skipped",
+            reason: `failed to create symlink: ${error instanceof Error ? error.message : String(error)}`,
+        };
+    }
+}
+function safeLstat(p) {
+    try {
+        return fs.lstatSync(p);
+    }
+    catch {
+        return undefined;
+    }
+}
+function resolveSymlinkTarget({ currentTarget, linkParentPath }) {
+    if (path.isAbsolute(currentTarget)) {
+        return path.resolve(currentTarget);
+    }
+    return path.resolve(linkParentPath, currentTarget);
+}
+//# sourceMappingURL=link-claude-skills.js.map