@alessandroraffa/tangyr 0.18.0 → 0.19.0

package/dist/index.js

@@ -32303,6 +32303,14 @@ var FRONTMATTER_REQUIRED_FIELDS = {
   rules: [],
   hooks: ["name", "description", "events"]
 };
+var CANONICAL_SKILL_SUBFOLDERS = [
+  "assets",
+  "references",
+  "schemas",
+  "scripts",
+  "tests",
+  "evals"
+];
 function runValidateCommand(options, logger) {
   const { kitInfo } = resolveRuntime(options, import.meta.url);
   if (!kitInfo) {
@@ -32315,16 +32323,26 @@ function runValidateCommand(options, logger) {
   const result = validateKit(kitInfo);
   if (options.json) {
     logger.info(JSON.stringify(result, null, 2));
-  } else if (result.conformant) {
-    logger.info(
-      `validate: OK (kit '${kitInfo.name}' conforms to kitFormat ${kitInfo.kitFormat})`
-    );
   } else {
-    logger.error(
-      `validate: FAILED (${result.violations.length} violation${result.violations.length === 1 ? "" : "s"})`
-    );
-    for (const v2 of result.violations) {
-      logger.error(`  [${v2.code}] ${v2.location}: ${v2.message}`);
+    if (result.conformant) {
+      logger.info(
+        `validate: OK (kit '${kitInfo.name}' conforms to kitFormat ${kitInfo.kitFormat})`
+      );
+    } else {
+      logger.error(
+        `validate: FAILED (${result.violations.length} violation${result.violations.length === 1 ? "" : "s"})`
+      );
+      for (const v2 of result.violations) {
+        logger.error(`  [${v2.code}] ${v2.location}: ${v2.message}`);
+      }
+    }
+    if (result.notices.length > 0) {
+      logger.warn(
+        `validate: ${result.notices.length} notice${result.notices.length === 1 ? "" : "s"} (not violations; the verdict above stands)`
+      );
+      for (const n7 of result.notices) {
+        logger.warn(`  [${n7.code}] ${n7.location}: ${n7.message}`);
+      }
     }
   }
   if (!result.conformant) {
@@ -32343,9 +32361,34 @@ function validateKit(kitInfo) {
   violations.push(...checkHumanOnlyCommandInvocation(kitInfo));
   return {
     conformant: violations.length === 0,
-    violations
+    violations,
+    notices: checkSkillSubfolderNames(kitInfo)
   };
 }
+function checkSkillSubfolderNames(kit) {
+  const notices = [];
+  const canonical = new Set(CANONICAL_SKILL_SUBFOLDERS);
+  for (const name of kit.components.skills.declared) {
+    const skillDir = path43.join(kit.path, "skills", name);
+    let entries;
+    try {
+      entries = fs42.readdirSync(skillDir, { withFileTypes: true });
+    } catch {
+      continue;
+    }
+    for (const entry of entries) {
+      if (!entry.isDirectory() || entry.name.startsWith(".") || canonical.has(entry.name)) {
+        continue;
+      }
+      notices.push({
+        code: "skill-subfolder-unrecognized",
+        location: `skills/${name}/${entry.name}/`,
+        message: `skills: '${name}' contains a subfolder '${entry.name}' that the contract does not enumerate. The recognized names are ${CANONICAL_SKILL_SUBFOLDERS.join(", ")}. This is not a violation, and nothing is rejected: the CLI carries the whole skill folder to local targets either way. It is reported so a convention stays visible rather than drifting silently.`
+      });
+    }
+  }
+  return notices;
+}
 function collect(violations, v2) {
   if (v2) violations.push(v2);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alessandroraffa/tangyr",
-  "version": "0.18.0",
+  "version": "0.19.0",
   "description": "CLI for the Tangyr discipline — install and manage operating kits for AI coding tools",
   "license": "MIT",
   "engines": {