@rynx-ai/workspace 0.1.9

package/dist/skill-name.js

@@ -0,0 +1,21 @@
+const MAX_WORKSPACE_SKILL_NAME_LENGTH = 64;
+/**
+ * Return the portable skill identity used by workspace, daemon, and runtimes.
+ * Runtime skill loaders expect a lowercase kebab-case directory/frontmatter
+ * name, so display names must never be used as the installation identity.
+ */
+export function canonicalWorkspaceSkillName(value, fallback = "skill") {
+    const normalize = (input) => input
+        .normalize("NFKD")
+        .toLowerCase()
+        .replace(/[_\s]+/g, "-")
+        .replace(/[^a-z0-9-]+/g, "-")
+        .replace(/-+/g, "-")
+        .replace(/^-|-$/g, "");
+    const candidate = normalize(value) || normalize(fallback);
+    if (!candidate)
+        return "";
+    return candidate
+        .slice(0, MAX_WORKSPACE_SKILL_NAME_LENGTH)
+        .replace(/-+$/g, "");
+}

package/dist/skill-path.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Produce the collision key used before an immutable Skill revision is stored
+ * or materialized. It models the common case-insensitive, Unicode-normalizing
+ * filesystem boundary and rejects Windows paths that cannot be represented
+ * exactly. The original path remains the content-hash input.
+ */
+export declare function portableWorkspaceSkillPathKey(value: string): string;

package/dist/skill-path.js

@@ -0,0 +1,27 @@
+const WINDOWS_RESERVED_SEGMENT = /^(?:con|prn|aux|nul|com[1-9]|lpt[1-9])(?:\..*)?$/i;
+const WINDOWS_INVALID_SEGMENT_CHARACTER = /[<>:"|?*\u0000-\u001f]/u;
+/**
+ * Produce the collision key used before an immutable Skill revision is stored
+ * or materialized. It models the common case-insensitive, Unicode-normalizing
+ * filesystem boundary and rejects Windows paths that cannot be represented
+ * exactly. The original path remains the content-hash input.
+ */
+export function portableWorkspaceSkillPathKey(value) {
+    const normalizedSeparators = value.replaceAll("\\", "/");
+    const segments = normalizedSeparators.split("/");
+    if (normalizedSeparators.startsWith("/") ||
+        segments.some((segment) => !segment || segment === "." || segment === "..")) {
+        throw new Error(`Invalid portable Skill file path: ${value}`);
+    }
+    return segments.map((segment) => {
+        const normalized = segment.normalize("NFC");
+        if (normalized !== segment ||
+            normalized.endsWith(".") ||
+            normalized.endsWith(" ") ||
+            WINDOWS_INVALID_SEGMENT_CHARACTER.test(normalized) ||
+            WINDOWS_RESERVED_SEGMENT.test(normalized)) {
+            throw new Error(`Invalid portable Skill file path: ${value}`);
+        }
+        return normalized.toLowerCase();
+    }).join("/");
+}