@akanjs/devkit 2.3.11-rc.4 → 2.3.11-rc.6

package/executors.test.ts

@@ -140,7 +140,7 @@ describe("Executor filesystem helpers", () => {
     expect(await readFile(path.join(root, "workspace/.env"), "utf8")).toContain("AKAN_PUBLIC_REPO_NAME");
     expect(await readFile(path.join(root, "workspace/.vscode/settings.json"), "utf8")).toContain("typescript.tsdk");
     expect(await readFile(path.join(root, "workspace/.cursor/rules/akan.mdc"), "utf8")).toContain(
-      "Akan.js Workspace Rules",
+      "Akan workspace agent guide",
     );
     expect(await readFile(path.join(root, "workspace/AGENTS.md"), "utf8")).toContain("sample Agent Guide");
     expect(await readFile(path.join(root, "workspace/docs/AI-DEVELOPMENT.md"), "utf8")).toContain(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akanjs/devkit",
-  "version": "2.3.11-rc.4",
+  "version": "2.3.11-rc.6",
   "sourceType": "module",
   "type": "module",
   "publishConfig": {
@@ -32,7 +32,7 @@
     "@langchain/openai": "^1.4.6",
     "@tailwindcss/node": "^4.3.0",
     "@trapezedev/project": "^7.1.4",
-    "akanjs": "2.3.11-rc.4",
+    "akanjs": "2.3.11-rc.6",
     "chalk": "^5.6.2",
     "commander": "^14.0.3",
     "daisyui": "5.5.23",

package/qualityScanner.ts

@@ -37,6 +37,7 @@ interface ExportedFunctionLike {
   file: string;
   line: number;
   bodyFingerprint?: string;
+  duplicateNameExempt: boolean;
 }
 
 interface TopLevelDeclaration {
@@ -177,7 +178,8 @@ export class AkanQualityScanner {
     const exportedFunctionLikes = sourceFiles.flatMap((sourceFile) => getExportedFunctionLikes(sourceFile));
     const warnings: QualityWarning[] = [];
 
-    for (const [name, declarations] of groupBy(exportedFunctionLikes, (declaration) => declaration.name)) {
+    const nameCheckedDeclarations = exportedFunctionLikes.filter((declaration) => !declaration.duplicateNameExempt);
+    for (const [name, declarations] of groupBy(nameCheckedDeclarations, (declaration) => declaration.name)) {
       if (declarations.length < 2) continue;
       warnings.push({
         rule: "akan.global.duplicate-exported-function-name",
@@ -345,6 +347,7 @@ function formatQualityLocation(file: string | undefined, line: number | undefine
 
 function getExportedFunctionLikes(sourceFile: SourceFileInfo): ExportedFunctionLike[] {
   const declarations: ExportedFunctionLike[] = [];
+  const pageExempt = isPageRouteFile(sourceFile.file);
   for (const statement of sourceFile.sourceFile.statements) {
     if (ts.isFunctionDeclaration(statement) && statement.name && isExported(statement)) {
       declarations.push({
@@ -353,6 +356,7 @@ function getExportedFunctionLikes(sourceFile: SourceFileInfo): ExportedFunctionL
         file: sourceFile.file,
         line: getLine(sourceFile.sourceFile, statement),
         bodyFingerprint: getBodyFingerprint(sourceFile.sourceFile, statement.body),
+        duplicateNameExempt: pageExempt || isConventionDuplicateNameExempt(sourceFile.file, false),
       });
     }
     if (ts.isClassDeclaration(statement) && statement.name && isExported(statement)) {
@@ -362,6 +366,9 @@ function getExportedFunctionLikes(sourceFile: SourceFileInfo): ExportedFunctionL
         file: sourceFile.file,
         line: getLine(sourceFile.sourceFile, statement),
         bodyFingerprint: getBodyFingerprint(sourceFile.sourceFile, statement),
+        duplicateNameExempt:
+          pageExempt ||
+          isConventionDuplicateNameExempt(sourceFile.file, isEnumClassStatement(sourceFile.sourceFile, statement)),
       });
     }
     if (ts.isVariableStatement(statement) && isExported(statement)) {
@@ -373,6 +380,7 @@ function getExportedFunctionLikes(sourceFile: SourceFileInfo): ExportedFunctionL
           file: sourceFile.file,
           line: getLine(sourceFile.sourceFile, declaration),
           bodyFingerprint: getBodyFingerprint(sourceFile.sourceFile, declaration.initializer),
+          duplicateNameExempt: pageExempt || isConventionDuplicateNameExempt(sourceFile.file, false),
         });
       }
     }
@@ -380,6 +388,38 @@ function getExportedFunctionLikes(sourceFile: SourceFileInfo): ExportedFunctionL
   return declarations;
 }
 
+function isPageRouteFile(file: string) {
+  const segments = file.split("/");
+  return (segments[0] === "apps" || segments[0] === "libs") && segments[2] === "page";
+}
+
+function isConventionDuplicateNameExempt(file: string, isEnumClass: boolean) {
+  if (!isInLibModule(file)) return false;
+  if (file.endsWith(".tsx")) return true;
+  if (
+    file.endsWith(".document.ts") ||
+    file.endsWith(".service.ts") ||
+    file.endsWith(".signal.ts") ||
+    file.endsWith(".store.ts")
+  )
+    return true;
+  // Model view classes may repeat across modules; enum classes must stay uniquely named.
+  if (file.endsWith(".constant.ts")) return !isEnumClass;
+  return false;
+}
+
+function isInLibModule(file: string) {
+  const segments = file.split("/");
+  return (segments[0] === "apps" || segments[0] === "libs") && segments.includes("lib");
+}
+
+function isEnumClassStatement(sourceFile: ts.SourceFile, statement: ts.Statement) {
+  if (!ts.isClassDeclaration(statement)) return false;
+  const heritageClause = statement.heritageClauses?.find((clause) => clause.token === ts.SyntaxKind.ExtendsKeyword);
+  const expression = heritageClause?.types[0]?.expression;
+  return !!expression && expression.getText(sourceFile).startsWith("enumOf(");
+}
+
 function getExportedClassNames(sourceFile: ts.SourceFile) {
   return sourceFile.statements
     .filter((statement): statement is ts.ClassDeclaration => ts.isClassDeclaration(statement) && !!statement.name)
@@ -403,11 +443,7 @@ function getPlaceholderExportWarnings(sourceFile: SourceFileInfo): QualityWarnin
 
 function getDictionaryTextWarnings(sourceFile: SourceFileInfo): QualityWarning[] {
   if (!sourceFile.file.endsWith(".dictionary.ts")) return [];
-  const stalePatterns = [
-    { pattern: /\b[A-Z][A-Za-z0-9]* description\b/, label: "scaffold description text" },
-    { pattern: /settting/, label: "misspelling: settting" },
-    { pattern: /배너 수/, label: "stale copied Korean domain noun: 배너 수" },
-  ];
+  const stalePatterns = [{ pattern: /\b[A-Z][A-Za-z0-9]* description\b/, label: "scaffold description text" }];
   return stalePatterns.flatMap(({ pattern, label }) =>
     findPatternLines(sourceFile.content, pattern).map((line) => ({
       rule: "akan.file.dictionary-stale-text",

package/scanInfo.ts

@@ -52,6 +52,7 @@ const appRootAllowedFiles = new Set([
   "package.json",
   "server.ts",
   "tsconfig.json",
+  "tsconfig.tsbuildinfo",
 ]);
 const appRootAllowedDirs = new Set([
   ".akan",