@trackunit/iris-app 2.15.16 → 2.16.3

package/CHANGELOG.md

@@ -1,3 +1,57 @@
+## 2.16.3 (2026-11-04)
+
+### 🧱 Updated Dependencies
+
+- Updated iris-app-build-utilities to 3.0.18
+- Updated iris-app-api to 2.13.6
+- Updated react-vite-test-setup to 0.0.204
+- Updated css-classname-utils to 0.0.112
+- Updated react-graphql-tools to 1.23.35
+- Updated shared-utils to 1.22.31
+
+## 2.16.2 (2026-11-04)
+
+### 🧱 Updated Dependencies
+
+- Updated iris-app-build-utilities to 3.0.17
+- Updated iris-app-api to 2.13.5
+- Updated react-vite-test-setup to 0.0.203
+- Updated css-classname-utils to 0.0.111
+- Updated react-graphql-tools to 1.23.34
+- Updated shared-utils to 1.22.30
+
+## 2.16.1 (2026-11-04)
+
+### 🧱 Updated Dependencies
+
+- Updated iris-app-build-utilities to 3.0.16
+- Updated iris-app-api to 2.13.4
+- Updated react-vite-test-setup to 0.0.202
+- Updated css-classname-utils to 0.0.110
+- Updated react-graphql-tools to 1.23.33
+- Updated shared-utils to 1.22.29
+
+## 2.16.0 (2026-11-04)
+
+### 🚀 Features
+
+- **iris-app-sdk:** guide apps to lazy pages for AI navigation and follow getParentRoute ([#27279](https://github.com/Trackunit/manager/pull/27279))
+- **iris-app:** generate AGENTS.md only, no CLAUDE.md ([#27348](https://github.com/Trackunit/manager/pull/27348))
+
+### 🧱 Updated Dependencies
+
+- Updated iris-app-build-utilities to 3.0.15
+- Updated iris-app-api to 2.13.3
+- Updated react-vite-test-setup to 0.0.201
+- Updated css-classname-utils to 0.0.109
+- Updated react-graphql-tools to 1.23.32
+- Updated shared-utils to 1.22.28
+
+### ❤️ Thank You
+
+- Kasper Laursen @ghost-of-kla-trackunit
+- Ulrik Jørgensen @ujo-trackunit
+
 ## 2.15.16 (2026-11-04)
 
 ### 🧱 Updated Dependencies

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trackunit/iris-app",
-  "version": "2.15.16",
+  "version": "2.16.3",
   "license": "SEE LICENSE IN LICENSE.txt",
   "main": "src/index.js",
   "generators": "./generators.json",
@@ -10,7 +10,7 @@
     "node": ">=24.x"
   },
   "dependencies": {
-    "@trackunit/css-classname-utils": "0.0.108",
+    "@trackunit/css-classname-utils": "0.0.112",
     "@typescript-eslint/types": "8.71.2",
     "@typescript-eslint/typescript-estree": "8.71.2",
     "pacote": "^21.5.1",
@@ -26,10 +26,10 @@
     "@nx/react": "23.3.0",
     "@npmcli/arborist": "^9.1.9",
     "win-ca": "^3.5.1",
-    "@trackunit/iris-app-build-utilities": "3.0.14",
-    "@trackunit/react-graphql-tools": "1.23.31",
-    "@trackunit/shared-utils": "1.22.27",
-    "@trackunit/iris-app-api": "2.13.2",
+    "@trackunit/iris-app-build-utilities": "3.0.18",
+    "@trackunit/react-graphql-tools": "1.23.35",
+    "@trackunit/shared-utils": "1.22.31",
+    "@trackunit/iris-app-api": "2.13.6",
     "tslib": "^2.6.2",
     "@clack/prompts": "^1.8.1",
     "@nx/devkit": "23.3.0",

package/src/generators/ai-agent-sync/README.md

@@ -1,6 +1,6 @@
 # AI Agent Sync Generator
 
-Syncs agent skills, AGENTS.md, CLAUDE.md, and AI agent configuration files to the latest version. Ensures the SDK is at the latest version before applying updates.
+Syncs agent skills, AGENTS.md, and AI agent configuration files to the latest version. Ensures the SDK is at the latest version before applying updates.
 
 ## Usage
 
@@ -13,8 +13,9 @@ nx g @trackunit/iris-app:ai-agent-sync
 - `.agents/skills/` - AI agent skills for the IrisX App SDK (editor-agnostic)
 - `.mcp.json` - project-scoped MCP configuration for coding agents
 - `.cursor/mcp.json` - Cursor MCP configuration
-- `AGENTS.md` - Workspace-level agent instructions (always applied)
-- `CLAUDE.md` - Claude-specific configuration (references AGENTS.md)
+- `AGENTS.md` - Workspace-level agent instructions (always applied), read by Cursor and Claude Code
+
+It also removes the `CLAUDE.md` that earlier SDK versions generated, since Claude Code reads `AGENTS.md` natively. Only an unmodified copy is removed (see `legacy-claude-md/`), and not while a `CLAUDE.local.md` or `.claude/CLAUDE.md` exists, since its `@AGENTS.md` import is then what loads `AGENTS.md`. A `CLAUDE.md` you wrote or edited is kept.
 
 ## Flow
 

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

@@ -1,7 +1,7 @@
 import { GeneratorCallback, Tree } from "@nx/devkit";
 import { AiAgentSyncGeneratorSchema } from "./schema";
 /**
- * Syncs Cursor skills, AGENTS.md, CLAUDE.md, and AI agent configuration files.
+ * Syncs Cursor skills, AGENTS.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<GeneratorCallback>;

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

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.aiAgentSyncGenerator = aiAgentSyncGenerator;
 const tslib_1 = require("tslib");
 const devkit_1 = require("@nx/devkit");
+const fs = tslib_1.__importStar(require("fs"));
 const devkit_exports_1 = require("nx/src/devkit-exports");
 const path = tslib_1.__importStar(require("path"));
 const semver = tslib_1.__importStar(require("semver"));
@@ -10,6 +11,9 @@ const get_package_manifest_1 = require("../utils/get-package-manifest");
 const link_claude_skills_1 = require("../utils/link-claude-skills");
 const IRIS_APP_PACKAGE = "@trackunit/iris-app";
 const MIGRATIONS_PACKAGE = "@trackunit/migrations";
+const CLAUDE_MD = "CLAUDE.md";
+const CLAUDE_MEMORY_FILES = [CLAUDE_MD, ".claude/CLAUDE.md", "CLAUDE.local.md"];
+const LEGACY_CLAUDE_MD_DIR = path.join(__dirname, "legacy-claude-md");
 function getStringValue(obj, key) {
     if (typeof obj === "object" && obj !== null && key in obj) {
         const value = obj[key];
@@ -49,8 +53,48 @@ function upgradeInstructions() {
         `  ${pmc.exec} nx g ${MIGRATIONS_PACKAGE}:run-migrations`,
     ].join("\n");
 }
+function normalizeWhitespace(content) {
+    return content.replace(/\s+/g, " ").trim();
+}
+/**
+ * Every CLAUDE.md template earlier SDK versions shipped, whitespace-normalized so a
+ * workspace formatter's line wrapping or line endings do not hide a match.
+ */
+function readLegacyClaudeMdTemplates() {
+    return new Set(fs
+        .readdirSync(LEGACY_CLAUDE_MD_DIR)
+        .filter(file => file.endsWith(".md"))
+        .map(file => normalizeWhitespace(fs.readFileSync(path.join(LEGACY_CLAUDE_MD_DIR, file), "utf-8"))));
+}
+function importsAgentsMd(content) {
+    return /^@AGENTS\.md\s*$/m.test(content);
+}
+/**
+ * Earlier SDK versions generated a CLAUDE.md that imported AGENTS.md. Claude Code
+ * now reads AGENTS.md directly, so an unmodified copy of that file is removed. Any
+ * other CLAUDE.md is the user's and is kept, because AGENTS.md tells users they may
+ * add one.
+ *
+ * Claude Code skips AGENTS.md while any of its memory files exists, so the SDK copy
+ * is also kept when another one does: its import is then what loads AGENTS.md.
+ */
+function removeSdkGeneratedClaudeMd(tree) {
+    const content = tree.read(CLAUDE_MD, "utf-8");
+    const otherMemoryFiles = CLAUDE_MEMORY_FILES.filter(file => file !== CLAUDE_MD && tree.exists(file));
+    if (content !== null &&
+        otherMemoryFiles.length === 0 &&
+        readLegacyClaudeMdTemplates().has(normalizeWhitespace(content))) {
+        tree.delete(CLAUDE_MD);
+    }
+    const presentMemoryFiles = CLAUDE_MEMORY_FILES.filter(file => tree.exists(file));
+    if (presentMemoryFiles.length > 0 &&
+        !presentMemoryFiles.some(file => importsAgentsMd(tree.read(file, "utf-8") ?? ""))) {
+        devkit_1.logger.warn(`[iris-app:ai-agent-sync] Claude Code skips AGENTS.md while ${presentMemoryFiles.join(", ")} exists. ` +
+            `Add an @AGENTS.md line to one of them or delete them.`);
+    }
+}
 /**
- * Syncs Cursor skills, AGENTS.md, CLAUDE.md, and AI agent configuration files.
+ * Syncs Cursor skills, AGENTS.md, and AI agent configuration files.
  * Requires the SDK to be at the latest version before running.
  */
 async function aiAgentSyncGenerator(tree, options) {
@@ -69,7 +113,7 @@ async function aiAgentSyncGenerator(tree, options) {
                 `Then run this generator again.`);
         }
     }
-    // Clean up old .cursor files that were managed by previous versions.
+    // Clean up files that were managed by previous versions.
     const oldManagedFiles = [
         ".cursor/rules/irisx-app-sdk.mdc",
         ".cursor/rules/rules-index.mdc",
@@ -88,10 +132,11 @@ async function aiAgentSyncGenerator(tree, options) {
             tree.delete(file);
         }
     }
+    removeSdkGeneratedClaudeMd(tree);
     // Copy MCP configuration and agent skills shared with the preset generator.
     const managedFilesTemplatePath = path.join(__dirname, "../preset/files");
     (0, devkit_1.generateFiles)(tree, managedFilesTemplatePath, ".", {});
-    // Copy AGENTS.md and CLAUDE.md to workspace root
+    // Copy AGENTS.md to workspace root
     const rootTemplatePath = path.join(__dirname, "../preset/root-files");
     (0, devkit_1.generateFiles)(tree, rootTemplatePath, ".", {});
     await (0, devkit_1.formatFiles)(tree);

package/src/generators/ai-agent-sync/legacy-claude-md/v1.md

@@ -0,0 +1 @@
+@AGENTS.md

package/src/generators/ai-agent-sync/legacy-claude-md/v2.md

@@ -0,0 +1,13 @@
+@AGENTS.md
+
+# Claude Code Users
+
+Skills are in `.agents/skills/` (cross-tool compatible). Claude Code reads from `.claude/skills/`.
+
+To enable skill discovery, create a symlink:
+
+```bash
+ln -s .agents/skills .claude/skills
+```
+
+Or read skills directly from `.agents/skills/[skill-name]/SKILL.md` when referenced in AGENTS.md.

package/src/generators/ai-agent-sync/legacy-claude-md/v3.md

@@ -0,0 +1,17 @@
+@AGENTS.md
+
+# IrisX App Workspace
+
+This is an IrisX App project generated by the Trackunit SDK. Follow AGENTS.md for all development rules.
+
+## 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`.
+
+If skills from `.agents/skills/` are not appearing in your available skills list, suggest the user symlink them for automatic discovery:
+
+```bash
+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.

package/src/generators/ai-agent-sync/legacy-claude-md/v4.md

@@ -0,0 +1,17 @@
+@AGENTS.md
+
+# IrisX App Workspace
+
+This is an IrisX App project generated by the Trackunit SDK. Follow AGENTS.md for all development rules.
+
+## Skills
+
+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 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
+```
+
+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/extend/files/react-app/src/routeTree.tsx__template__

@@ -1,8 +1,9 @@
-import { Navigate, createRootRoute, createRoute } from "@tanstack/react-router";
-import { App } from "./app";
+import { Navigate, createRootRoute, createRoute, lazyRouteComponent } from "@tanstack/react-router";
 
+// Pages are loaded lazily because the extension manifest imports this tree in
+// Node at build time, where a page that needs a browser would fail the build.
 const rootRoute = createRootRoute({
-  component: () => <App />,
+  component: lazyRouteComponent(() => import("./app"), "App"),
 });
 
 const defaultRoute = createRoute({

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

@@ -60,3 +60,19 @@ Available extension types:
 ## Quality Assurance
 
 Before completing any task: Always check for and fix all ESLint and TypeScript errors in modified files.
+
+## Claude Code
+
+Claude Code (v2.1.277 or later) reads this file directly. A `CLAUDE.md` or `CLAUDE.local.md` stops that; if you need one (older Claude Code, personal notes), make its first line `@AGENTS.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 this file, read it from `.agents/skills/[skill-name]/SKILL.md`.
+
+Restart Claude Code after changing `.mcp.json` so the MCP servers are reloaded.
+
+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
+```
+
+If `.claude/skills` already exists as a real directory, move its contents into `.agents/skills/` and delete it before running the command above.