@jaypie/mcp 0.6.6 → 0.7.1

package/dist/suites/docs/index.js

@@ -1,4 +1,5 @@
 import { fabricService } from '@jaypie/fabric';
+import { createMarkdownStore, normalizeAlias, isValidAlias } from '@jaypie/tildeskill';
 import * as fs from 'node:fs/promises';
 import * as path from 'node:path';
 import { fileURLToPath } from 'node:url';
@@ -8,22 +9,15 @@ import { gt } from 'semver';
 /**
  * Docs Suite - Documentation services (skill, version, release_notes)
  */
-const BUILD_VERSION_STRING = "@jaypie/mcp@0.6.6#c35efb78"
+const BUILD_VERSION_STRING = "@jaypie/mcp@0.7.1#82d19d8a"
     ;
 const __filename$1 = fileURLToPath(import.meta.url);
 const __dirname$1 = path.dirname(__filename$1);
 // From dist/suites/docs/, go up 3 levels to package root where skills/ and release-notes/ live
 const RELEASE_NOTES_PATH = path.join(__dirname$1, "..", "..", "..", "release-notes");
 const SKILLS_PATH = path.join(__dirname$1, "..", "..", "..", "skills");
-function isValidSkillAlias(alias) {
-    const normalized = alias.toLowerCase().trim();
-    if (normalized.includes("/") ||
-        normalized.includes("\\") ||
-        normalized.includes("..")) {
-        return false;
-    }
-    return /^[a-z0-9_-]+$/.test(normalized);
-}
+// Create skill store using tildeskill
+const skillStore = createMarkdownStore({ path: SKILLS_PATH });
 async function parseReleaseNoteFile(filePath) {
     try {
         const content = await fs.readFile(filePath, "utf-8");
@@ -55,24 +49,6 @@ function formatReleaseNoteListItem(note) {
     }
     return parts.join(" ");
 }
-async function parseSkillFile(filePath) {
-    try {
-        const content = await fs.readFile(filePath, "utf-8");
-        const alias = path.basename(filePath, ".md");
-        if (content.startsWith("---")) {
-            const parsed = matter(content);
-            const frontMatter = parsed.data;
-            return {
-                alias,
-                description: frontMatter.description,
-            };
-        }
-        return { alias };
-    }
-    catch {
-        return { alias: path.basename(filePath, ".md") };
-    }
-}
 function formatSkillListItem(skill) {
     const { alias, description } = skill;
     if (description) {
@@ -130,40 +106,30 @@ const skillService = fabricService({
         },
     },
     service: async ({ alias: inputAlias }) => {
-        const alias = (inputAlias || "index").toLowerCase().trim();
-        if (!isValidSkillAlias(alias)) {
+        const alias = normalizeAlias(inputAlias || "index");
+        if (!isValidAlias(alias)) {
             throw new Error(`Invalid skill alias "${alias}". Use alphanumeric characters, hyphens, and underscores only.`);
         }
         if (alias === "index") {
-            const indexPath = path.join(SKILLS_PATH, "index.md");
-            let indexContent = "";
-            try {
-                indexContent = await fs.readFile(indexPath, "utf-8");
-                if (indexContent.startsWith("---")) {
-                    const parsed = matter(indexContent);
-                    indexContent = parsed.content.trim();
-                }
-            }
-            catch {
-                // Index file doesn't exist, will just show skill list
-            }
-            const files = await fs.readdir(SKILLS_PATH);
-            const mdFiles = files.filter((file) => file.endsWith(".md") && file !== "index.md");
-            const skills = await Promise.all(mdFiles.map((file) => parseSkillFile(path.join(SKILLS_PATH, file))));
-            skills.sort((a, b) => a.alias.localeCompare(b.alias));
+            // Get index content
+            const indexRecord = await skillStore.get("index");
+            const indexContent = indexRecord?.content || "";
+            // List all skills except index
+            const allSkills = await skillStore.list();
+            const skills = allSkills.filter((s) => s.alias !== "index");
             const skillList = skills.map(formatSkillListItem).join("\n");
             if (indexContent) {
                 return `${indexContent}\n\n## Available Skills\n\n${skillList}`;
             }
             return `# Jaypie Skills\n\n## Available Skills\n\n${skillList}`;
         }
-        const skillPath = path.join(SKILLS_PATH, `${alias}.md`);
-        try {
-            return await fs.readFile(skillPath, "utf-8");
-        }
-        catch {
+        const skill = await skillStore.get(alias);
+        if (!skill) {
             throw new Error(`Skill "${alias}" not found. Use skill("index") to list available skills.`);
         }
+        // Return raw file content for non-index skills (preserve frontmatter)
+        const skillPath = path.join(SKILLS_PATH, `${alias}.md`);
+        return fs.readFile(skillPath, "utf-8");
     },
 });
 // =============================================================================

package/dist/suites/docs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../src/suites/docs/index.ts"],"sourcesContent":["/**\n * Docs Suite - Documentation services (skill, version, release_notes)\n */\nimport { fabricService } from \"@jaypie/fabric\";\nimport * as fs from \"node:fs/promises\";\nimport * as path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport matter from \"gray-matter\";\nimport { gt } from \"semver\";\n\n// Build-time constants\ndeclare const __BUILD_VERSION_STRING__: string;\nconst BUILD_VERSION_STRING =\n  typeof __BUILD_VERSION_STRING__ !== \"undefined\"\n    ? __BUILD_VERSION_STRING__\n    : \"@jaypie/mcp@0.0.0\";\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = path.dirname(__filename);\n// From dist/suites/docs/, go up 3 levels to package root where skills/ and release-notes/ live\nconst RELEASE_NOTES_PATH = path.join(\n  __dirname,\n  \"..\",\n  \"..\",\n  \"..\",\n  \"release-notes\",\n);\nconst SKILLS_PATH = path.join(__dirname, \"..\", \"..\", \"..\", \"skills\");\n\n// =============================================================================\n// HELPER FUNCTIONS\n// =============================================================================\n\ninterface ReleaseNoteFrontMatter {\n  date?: string;\n  summary?: string;\n  version?: string;\n}\n\ninterface SkillFrontMatter {\n  description?: string;\n}\n\nfunction isValidSkillAlias(alias: string): boolean {\n  const normalized = alias.toLowerCase().trim();\n  if (\n    normalized.includes(\"/\") ||\n    normalized.includes(\"\\\\\") ||\n    normalized.includes(\"..\")\n  ) {\n    return false;\n  }\n  return /^[a-z0-9_-]+$/.test(normalized);\n}\n\nasync function parseReleaseNoteFile(filePath: string): Promise<{\n  date?: string;\n  filename: string;\n  summary?: string;\n  version?: string;\n}> {\n  try {\n    const content = await fs.readFile(filePath, \"utf-8\");\n    const filename = path.basename(filePath, \".md\");\n\n    if (content.startsWith(\"---\")) {\n      const parsed = matter(content);\n      const frontMatter = parsed.data as ReleaseNoteFrontMatter;\n      return {\n        date: frontMatter.date,\n        filename,\n        summary: frontMatter.summary,\n        version: frontMatter.version || filename,\n      };\n    }\n\n    return { filename, version: filename };\n  } catch {\n    return { filename: path.basename(filePath, \".md\") };\n  }\n}\n\nfunction formatReleaseNoteListItem(note: {\n  date?: string;\n  filename: string;\n  packageName: string;\n  summary?: string;\n  version?: string;\n}): string {\n  const { date, packageName, summary, version } = note;\n  const parts = [`* ${packageName}@${version}`];\n\n  if (date) {\n    parts.push(`(${date})`);\n  }\n\n  if (summary) {\n    parts.push(`- ${summary}`);\n  }\n\n  return parts.join(\" \");\n}\n\nasync function parseSkillFile(filePath: string): Promise<{\n  alias: string;\n  description?: string;\n}> {\n  try {\n    const content = await fs.readFile(filePath, \"utf-8\");\n    const alias = path.basename(filePath, \".md\");\n\n    if (content.startsWith(\"---\")) {\n      const parsed = matter(content);\n      const frontMatter = parsed.data as SkillFrontMatter;\n      return {\n        alias,\n        description: frontMatter.description,\n      };\n    }\n\n    return { alias };\n  } catch {\n    return { alias: path.basename(filePath, \".md\") };\n  }\n}\n\nfunction formatSkillListItem(skill: {\n  alias: string;\n  description?: string;\n}): string {\n  const { alias, description } = skill;\n  if (description) {\n    return `* ${alias} - ${description}`;\n  }\n  return `* ${alias}`;\n}\n\nasync function getPackageReleaseNotes(packageName: string): Promise<\n  Array<{\n    date?: string;\n    filename: string;\n    packageName: string;\n    summary?: string;\n    version?: string;\n  }>\n> {\n  const packageDir = path.join(RELEASE_NOTES_PATH, packageName);\n  try {\n    const files = await fs.readdir(packageDir);\n    const mdFiles = files.filter((file) => file.endsWith(\".md\"));\n\n    const notes = await Promise.all(\n      mdFiles.map(async (file) => {\n        const parsed = await parseReleaseNoteFile(path.join(packageDir, file));\n        return { ...parsed, packageName };\n      }),\n    );\n\n    return notes.sort((a, b) => {\n      if (!a.version || !b.version) return 0;\n      try {\n        return gt(a.version, b.version) ? -1 : 1;\n      } catch {\n        return b.version.localeCompare(a.version);\n      }\n    });\n  } catch {\n    return [];\n  }\n}\n\nfunction filterReleaseNotesSince(\n  notes: Array<{\n    date?: string;\n    filename: string;\n    packageName: string;\n    summary?: string;\n    version?: string;\n  }>,\n  sinceVersion: string,\n): Array<{\n  date?: string;\n  filename: string;\n  packageName: string;\n  summary?: string;\n  version?: string;\n}> {\n  return notes.filter((note) => {\n    if (!note.version) return false;\n    try {\n      return gt(note.version, sinceVersion);\n    } catch {\n      return false;\n    }\n  });\n}\n\n// =============================================================================\n// SKILL SERVICE\n// =============================================================================\n\nexport const skillService = fabricService({\n  alias: \"skill\",\n  description:\n    \"Access Jaypie development documentation. Pass a skill alias (e.g., 'aws', 'tests', 'errors') to get that documentation. Pass 'index' or no argument to list all available skills.\",\n  input: {\n    alias: {\n      description:\n        \"Skill alias (e.g., 'aws', 'tests'). Omit or use 'index' to list all skills.\",\n      required: false,\n      type: String,\n    },\n  },\n  service: async ({ alias: inputAlias }: { alias?: string }) => {\n    const alias = (inputAlias || \"index\").toLowerCase().trim();\n\n    if (!isValidSkillAlias(alias)) {\n      throw new Error(\n        `Invalid skill alias \"${alias}\". Use alphanumeric characters, hyphens, and underscores only.`,\n      );\n    }\n\n    if (alias === \"index\") {\n      const indexPath = path.join(SKILLS_PATH, \"index.md\");\n      let indexContent = \"\";\n\n      try {\n        indexContent = await fs.readFile(indexPath, \"utf-8\");\n        if (indexContent.startsWith(\"---\")) {\n          const parsed = matter(indexContent);\n          indexContent = parsed.content.trim();\n        }\n      } catch {\n        // Index file doesn't exist, will just show skill list\n      }\n\n      const files = await fs.readdir(SKILLS_PATH);\n      const mdFiles = files.filter(\n        (file) => file.endsWith(\".md\") && file !== \"index.md\",\n      );\n\n      const skills = await Promise.all(\n        mdFiles.map((file) => parseSkillFile(path.join(SKILLS_PATH, file))),\n      );\n\n      skills.sort((a, b) => a.alias.localeCompare(b.alias));\n\n      const skillList = skills.map(formatSkillListItem).join(\"\\n\");\n\n      if (indexContent) {\n        return `${indexContent}\\n\\n## Available Skills\\n\\n${skillList}`;\n      }\n      return `# Jaypie Skills\\n\\n## Available Skills\\n\\n${skillList}`;\n    }\n\n    const skillPath = path.join(SKILLS_PATH, `${alias}.md`);\n    try {\n      return await fs.readFile(skillPath, \"utf-8\");\n    } catch {\n      throw new Error(\n        `Skill \"${alias}\" not found. Use skill(\"index\") to list available skills.`,\n      );\n    }\n  },\n});\n\n// =============================================================================\n// VERSION SERVICE\n// =============================================================================\n\nexport const versionService = fabricService({\n  alias: \"version\",\n  description: `Prints the current version and hash, \\`${BUILD_VERSION_STRING}\\``,\n  input: {},\n  service: async () => BUILD_VERSION_STRING,\n});\n\n// =============================================================================\n// RELEASE NOTES SERVICE\n// =============================================================================\n\nasync function getReleaseNotesHelp(): Promise<string> {\n  return fs.readFile(path.join(__dirname, \"release-notes\", \"help.md\"), \"utf-8\");\n}\n\ninterface ReleaseNotesInput {\n  package?: string;\n  since_version?: string;\n  version?: string;\n}\n\nexport const releaseNotesService = fabricService({\n  alias: \"release_notes\",\n  description:\n    \"Browse Jaypie package release notes. Commands: list, read. Call with no args for help.\",\n  input: {\n    command: {\n      description: \"Command to execute (omit for help)\",\n      required: false,\n      type: String,\n    },\n    input: {\n      description: \"Command parameters\",\n      required: false,\n      type: Object,\n    },\n  },\n  service: async ({\n    command,\n    input: params,\n  }: {\n    command?: string;\n    input?: ReleaseNotesInput;\n  }) => {\n    if (!command || command === \"help\") {\n      return getReleaseNotesHelp();\n    }\n\n    const p = params || {};\n\n    switch (command) {\n      case \"list\": {\n        const entries = await fs.readdir(RELEASE_NOTES_PATH, {\n          withFileTypes: true,\n        });\n        const packageDirs = entries\n          .filter((entry) => entry.isDirectory())\n          .map((entry) => entry.name);\n        const packagesToList = p.package\n          ? packageDirs.filter((pkg) => pkg === p.package)\n          : packageDirs;\n\n        if (packagesToList.length === 0 && p.package) {\n          return `No release notes found for package \"${p.package}\".`;\n        }\n\n        const allNotes = await Promise.all(\n          packagesToList.map((pkg) => getPackageReleaseNotes(pkg)),\n        );\n        let flatNotes = allNotes.flat();\n\n        if (p.since_version) {\n          flatNotes = filterReleaseNotesSince(flatNotes, p.since_version);\n        }\n\n        if (flatNotes.length === 0) {\n          const filterDesc = p.since_version\n            ? ` newer than ${p.since_version}`\n            : \"\";\n          return `No release notes found${filterDesc}.`;\n        }\n\n        return flatNotes.map(formatReleaseNoteListItem).join(\"\\n\");\n      }\n\n      case \"read\": {\n        if (!p.package) throw new Error(\"package is required\");\n        if (!p.version) throw new Error(\"version is required\");\n        const filePath = path.join(\n          RELEASE_NOTES_PATH,\n          p.package,\n          `${p.version}.md`,\n        );\n        return fs.readFile(filePath, \"utf-8\");\n      }\n\n      default:\n        throw new Error(\n          `Unknown command: ${command}. Use release_notes() for help.`,\n        );\n    }\n  },\n});\n"],"names":["__filename","__dirname"],"mappings":"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"}
+{"version":3,"file":"index.js","sources":["../../../src/suites/docs/index.ts"],"sourcesContent":["/**\n * Docs Suite - Documentation services (skill, version, release_notes)\n */\nimport { fabricService } from \"@jaypie/fabric\";\nimport {\n  createMarkdownStore,\n  isValidAlias,\n  normalizeAlias,\n  type SkillRecord,\n} from \"@jaypie/tildeskill\";\nimport * as fs from \"node:fs/promises\";\nimport * as path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport matter from \"gray-matter\";\nimport { gt } from \"semver\";\n\n// Build-time constants\ndeclare const __BUILD_VERSION_STRING__: string;\nconst BUILD_VERSION_STRING =\n  typeof __BUILD_VERSION_STRING__ !== \"undefined\"\n    ? __BUILD_VERSION_STRING__\n    : \"@jaypie/mcp@0.0.0\";\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = path.dirname(__filename);\n// From dist/suites/docs/, go up 3 levels to package root where skills/ and release-notes/ live\nconst RELEASE_NOTES_PATH = path.join(\n  __dirname,\n  \"..\",\n  \"..\",\n  \"..\",\n  \"release-notes\",\n);\nconst SKILLS_PATH = path.join(__dirname, \"..\", \"..\", \"..\", \"skills\");\n\n// Create skill store using tildeskill\nconst skillStore = createMarkdownStore({ path: SKILLS_PATH });\n\n// =============================================================================\n// HELPER FUNCTIONS\n// =============================================================================\n\ninterface ReleaseNoteFrontMatter {\n  date?: string;\n  summary?: string;\n  version?: string;\n}\n\nasync function parseReleaseNoteFile(filePath: string): Promise<{\n  date?: string;\n  filename: string;\n  summary?: string;\n  version?: string;\n}> {\n  try {\n    const content = await fs.readFile(filePath, \"utf-8\");\n    const filename = path.basename(filePath, \".md\");\n\n    if (content.startsWith(\"---\")) {\n      const parsed = matter(content);\n      const frontMatter = parsed.data as ReleaseNoteFrontMatter;\n      return {\n        date: frontMatter.date,\n        filename,\n        summary: frontMatter.summary,\n        version: frontMatter.version || filename,\n      };\n    }\n\n    return { filename, version: filename };\n  } catch {\n    return { filename: path.basename(filePath, \".md\") };\n  }\n}\n\nfunction formatReleaseNoteListItem(note: {\n  date?: string;\n  filename: string;\n  packageName: string;\n  summary?: string;\n  version?: string;\n}): string {\n  const { date, packageName, summary, version } = note;\n  const parts = [`* ${packageName}@${version}`];\n\n  if (date) {\n    parts.push(`(${date})`);\n  }\n\n  if (summary) {\n    parts.push(`- ${summary}`);\n  }\n\n  return parts.join(\" \");\n}\n\nfunction formatSkillListItem(skill: SkillRecord): string {\n  const { alias, description } = skill;\n  if (description) {\n    return `* ${alias} - ${description}`;\n  }\n  return `* ${alias}`;\n}\n\nasync function getPackageReleaseNotes(packageName: string): Promise<\n  Array<{\n    date?: string;\n    filename: string;\n    packageName: string;\n    summary?: string;\n    version?: string;\n  }>\n> {\n  const packageDir = path.join(RELEASE_NOTES_PATH, packageName);\n  try {\n    const files = await fs.readdir(packageDir);\n    const mdFiles = files.filter((file) => file.endsWith(\".md\"));\n\n    const notes = await Promise.all(\n      mdFiles.map(async (file) => {\n        const parsed = await parseReleaseNoteFile(path.join(packageDir, file));\n        return { ...parsed, packageName };\n      }),\n    );\n\n    return notes.sort((a, b) => {\n      if (!a.version || !b.version) return 0;\n      try {\n        return gt(a.version, b.version) ? -1 : 1;\n      } catch {\n        return b.version.localeCompare(a.version);\n      }\n    });\n  } catch {\n    return [];\n  }\n}\n\nfunction filterReleaseNotesSince(\n  notes: Array<{\n    date?: string;\n    filename: string;\n    packageName: string;\n    summary?: string;\n    version?: string;\n  }>,\n  sinceVersion: string,\n): Array<{\n  date?: string;\n  filename: string;\n  packageName: string;\n  summary?: string;\n  version?: string;\n}> {\n  return notes.filter((note) => {\n    if (!note.version) return false;\n    try {\n      return gt(note.version, sinceVersion);\n    } catch {\n      return false;\n    }\n  });\n}\n\n// =============================================================================\n// SKILL SERVICE\n// =============================================================================\n\nexport const skillService = fabricService({\n  alias: \"skill\",\n  description:\n    \"Access Jaypie development documentation. Pass a skill alias (e.g., 'aws', 'tests', 'errors') to get that documentation. Pass 'index' or no argument to list all available skills.\",\n  input: {\n    alias: {\n      description:\n        \"Skill alias (e.g., 'aws', 'tests'). Omit or use 'index' to list all skills.\",\n      required: false,\n      type: String,\n    },\n  },\n  service: async ({ alias: inputAlias }: { alias?: string }) => {\n    const alias = normalizeAlias(inputAlias || \"index\");\n\n    if (!isValidAlias(alias)) {\n      throw new Error(\n        `Invalid skill alias \"${alias}\". Use alphanumeric characters, hyphens, and underscores only.`,\n      );\n    }\n\n    if (alias === \"index\") {\n      // Get index content\n      const indexRecord = await skillStore.get(\"index\");\n      const indexContent = indexRecord?.content || \"\";\n\n      // List all skills except index\n      const allSkills = await skillStore.list();\n      const skills = allSkills.filter((s) => s.alias !== \"index\");\n      const skillList = skills.map(formatSkillListItem).join(\"\\n\");\n\n      if (indexContent) {\n        return `${indexContent}\\n\\n## Available Skills\\n\\n${skillList}`;\n      }\n      return `# Jaypie Skills\\n\\n## Available Skills\\n\\n${skillList}`;\n    }\n\n    const skill = await skillStore.get(alias);\n    if (!skill) {\n      throw new Error(\n        `Skill \"${alias}\" not found. Use skill(\"index\") to list available skills.`,\n      );\n    }\n\n    // Return raw file content for non-index skills (preserve frontmatter)\n    const skillPath = path.join(SKILLS_PATH, `${alias}.md`);\n    return fs.readFile(skillPath, \"utf-8\");\n  },\n});\n\n// =============================================================================\n// VERSION SERVICE\n// =============================================================================\n\nexport const versionService = fabricService({\n  alias: \"version\",\n  description: `Prints the current version and hash, \\`${BUILD_VERSION_STRING}\\``,\n  input: {},\n  service: async () => BUILD_VERSION_STRING,\n});\n\n// =============================================================================\n// RELEASE NOTES SERVICE\n// =============================================================================\n\nasync function getReleaseNotesHelp(): Promise<string> {\n  return fs.readFile(path.join(__dirname, \"release-notes\", \"help.md\"), \"utf-8\");\n}\n\ninterface ReleaseNotesInput {\n  package?: string;\n  since_version?: string;\n  version?: string;\n}\n\nexport const releaseNotesService = fabricService({\n  alias: \"release_notes\",\n  description:\n    \"Browse Jaypie package release notes. Commands: list, read. Call with no args for help.\",\n  input: {\n    command: {\n      description: \"Command to execute (omit for help)\",\n      required: false,\n      type: String,\n    },\n    input: {\n      description: \"Command parameters\",\n      required: false,\n      type: Object,\n    },\n  },\n  service: async ({\n    command,\n    input: params,\n  }: {\n    command?: string;\n    input?: ReleaseNotesInput;\n  }) => {\n    if (!command || command === \"help\") {\n      return getReleaseNotesHelp();\n    }\n\n    const p = params || {};\n\n    switch (command) {\n      case \"list\": {\n        const entries = await fs.readdir(RELEASE_NOTES_PATH, {\n          withFileTypes: true,\n        });\n        const packageDirs = entries\n          .filter((entry) => entry.isDirectory())\n          .map((entry) => entry.name);\n        const packagesToList = p.package\n          ? packageDirs.filter((pkg) => pkg === p.package)\n          : packageDirs;\n\n        if (packagesToList.length === 0 && p.package) {\n          return `No release notes found for package \"${p.package}\".`;\n        }\n\n        const allNotes = await Promise.all(\n          packagesToList.map((pkg) => getPackageReleaseNotes(pkg)),\n        );\n        let flatNotes = allNotes.flat();\n\n        if (p.since_version) {\n          flatNotes = filterReleaseNotesSince(flatNotes, p.since_version);\n        }\n\n        if (flatNotes.length === 0) {\n          const filterDesc = p.since_version\n            ? ` newer than ${p.since_version}`\n            : \"\";\n          return `No release notes found${filterDesc}.`;\n        }\n\n        return flatNotes.map(formatReleaseNoteListItem).join(\"\\n\");\n      }\n\n      case \"read\": {\n        if (!p.package) throw new Error(\"package is required\");\n        if (!p.version) throw new Error(\"version is required\");\n        const filePath = path.join(\n          RELEASE_NOTES_PATH,\n          p.package,\n          `${p.version}.md`,\n        );\n        return fs.readFile(filePath, \"utf-8\");\n      }\n\n      default:\n        throw new Error(\n          `Unknown command: ${command}. Use release_notes() for help.`,\n        );\n    }\n  },\n});\n"],"names":["__filename","__dirname"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jaypie/mcp",
-  "version": "0.6.6",
+  "version": "0.7.1",
   "description": "Jaypie MCP",
   "repository": {
     "type": "git",
@@ -41,6 +41,7 @@
   "dependencies": {
     "@jaypie/fabric": "*",
     "@jaypie/llm": "*",
+    "@jaypie/tildeskill": "*",
     "@modelcontextprotocol/sdk": "^1.17.0",
     "commander": "^14.0.0",
     "gray-matter": "^4.0.3",

package/release-notes/constructs/1.2.25.md

@@ -0,0 +1,11 @@
+---
+version: 1.2.25
+date: 2025-01-28
+summary: Add streaming support to JaypieNextJs construct
+---
+
+## Changes
+
+- Add `streaming` prop to `JaypieNextJs` construct for Lambda response streaming
+  - When `streaming: true`, enables faster Time To First Byte (TTFB) via Lambda response streaming
+  - Passes through to underlying `cdk-nextjs-standalone` Nextjs construct

package/release-notes/mcp/0.7.0.md

@@ -0,0 +1,17 @@
+---
+version: 0.7.0
+date: 2025-01-26
+summary: Integrate @jaypie/tildeskill for skill storage abstraction
+---
+
+# @jaypie/mcp v0.7.0
+
+## Changes
+
+- **New dependency**: Uses `@jaypie/tildeskill` for skill management
+- **Refactored skill service**: Migrated from inline implementation to tildeskill's `createMarkdownStore`
+- **Improved validation**: Uses tildeskill's `isValidAlias()` and `normalizeAlias()` utilities
+
+## Breaking Changes
+
+None - API remains unchanged. The skill service still works exactly the same way.

package/release-notes/mcp/0.7.1.md

@@ -0,0 +1,10 @@
+---
+version: 0.7.1
+date: 2025-01-28
+summary: Add tildeskill documentation
+---
+
+## Changes
+
+- Add `tildeskill` skill documentation for the new `@jaypie/tildeskill` package
+- Update skills index with tildeskill reference

package/release-notes/testkit/1.2.20.md

@@ -0,0 +1,12 @@
+---
+version: 1.2.20
+date: 2025-01-28
+summary: Updated tildeskill mocks for extended schema
+---
+
+## Changes
+
+- Updated `createMemoryStore` and `createMarkdownStore` mocks with new methods:
+  - `getByNickname`: Returns `null` by default
+  - `search`: Returns empty array by default
+- Added `expandIncludes` mock that returns `record.content` by default

package/release-notes/tildeskill/0.1.0.md

@@ -0,0 +1,36 @@
+---
+version: 0.1.0
+date: 2025-01-26
+summary: Initial release with markdown and memory storage backends
+---
+
+# @jaypie/tildeskill v0.1.0
+
+Initial release of the skill/vocabulary management package with pluggable storage backends.
+
+## Features
+
+- **Core types**: `SkillRecord` and `SkillStore` interfaces for skill management
+- **Markdown store**: `createMarkdownStore({ path })` reads skill files from a directory with gray-matter frontmatter support
+- **Memory store**: `createMemoryStore(initial?)` provides in-memory storage for testing
+- **Validation utilities**: `isValidAlias()` and `validateAlias()` for secure alias handling
+- **Normalization utilities**: `normalizeAlias()` and `parseList()` for consistent alias formatting
+
+## Usage
+
+```typescript
+import { createMarkdownStore, createMemoryStore, isValidAlias } from "@jaypie/tildeskill";
+
+// File-based store
+const store = createMarkdownStore({ path: "./skills" });
+
+// Memory store for testing
+const testStore = createMemoryStore([
+  { alias: "test", content: "# Test", description: "Test skill" }
+]);
+
+// Validate aliases
+if (isValidAlias(userInput)) {
+  const skill = await store.get(userInput);
+}
+```

package/release-notes/tildeskill/0.2.0.md

@@ -0,0 +1,28 @@
+---
+version: 0.2.0
+date: 2025-01-28
+summary: Extended schema with nicknames, tags, includes and enhanced store interface
+---
+
+## New Features
+
+### Extended SkillRecord Schema
+
+- `name`: Display title for the skill
+- `nicknames`: Alternate lookup keys for `getByNickname()`
+- `tags`: Categorization tags for filtering
+- `includes`: Auto-expand other skill content on lookup
+
+### Enhanced SkillStore Interface
+
+- `getByNickname(nickname)`: Look up skills by alternate names
+- `list(filter)`: Filter by namespace prefix or tag
+- `search(term)`: Search across alias, name, description, content, and tags
+
+### Include Expansion
+
+New `expandIncludes(store, record)` utility that:
+- Prepends included skills' content before the record's content
+- Recursively expands nested includes
+- Prevents circular references
+- Skips missing includes silently

package/skills/skills.md

@@ -1,6 +1,6 @@
 ---
 description: About the Jaypie skill system
-related: agents, index
+related: agents, index, tildeskill
 ---
 
 # Jaypie Skills

package/skills/tildeskill.md

@@ -0,0 +1,172 @@
+---
+description: Skill/vocabulary storage with pluggable backends (pre-1.0)
+related: fabric, mcp, tools
+---
+
+# @jaypie/tildeskill
+
+Skill/vocabulary management with pluggable storage backends for AI assistants and documentation systems.
+
+## Overview
+
+This package provides a storage abstraction for skill/vocabulary documents with markdown frontmatter support. It enables:
+- Loading skills from markdown files with YAML frontmatter
+- In-memory storage for testing
+- Consistent alias normalization and validation
+- Filtering by namespace and tags
+- Searching across alias, name, description, content, and tags
+- Include expansion for composable skills
+
+## Installation
+
+```bash
+npm install @jaypie/tildeskill
+```
+
+## Core Types
+
+```typescript
+interface SkillRecord {
+  alias: string;              // Lookup key (normalized lowercase)
+  content: string;            // Markdown body
+  description?: string;       // Brief description from frontmatter
+  includes?: string[];        // Auto-expand these skill aliases on lookup
+  name?: string;              // Display title for the skill
+  nicknames?: string[];       // Alternate lookup keys for getByNickname
+  related?: string[];         // Related skill aliases
+  tags?: string[];            // Categorization tags
+}
+
+interface ListFilter {
+  namespace?: string;         // Namespace prefix matching (e.g., "kit:*")
+  tag?: string;               // Filter by tag
+}
+
+interface SkillStore {
+  get(alias: string): Promise<SkillRecord | null>;
+  getByNickname(nickname: string): Promise<SkillRecord | null>;
+  list(filter?: ListFilter): Promise<SkillRecord[]>;
+  put(record: SkillRecord): Promise<SkillRecord>;
+  search(term: string): Promise<SkillRecord[]>;
+}
+```
+
+## Store Factories
+
+### Markdown Store (File-based)
+
+```typescript
+import { createMarkdownStore } from "@jaypie/tildeskill";
+
+const store = createMarkdownStore({ path: "./skills" });
+
+// Get a specific skill
+const skill = await store.get("aws");
+if (skill) {
+  console.log(skill.content);
+}
+
+// List all skills
+const skills = await store.list();
+skills.forEach(s => console.log(`${s.alias}: ${s.description}`));
+```
+
+### Memory Store (Testing)
+
+```typescript
+import { createMemoryStore } from "@jaypie/tildeskill";
+
+const store = createMemoryStore([
+  { alias: "test", content: "# Test\n\nContent", description: "Test skill" }
+]);
+
+const skill = await store.get("test");
+```
+
+## Include Expansion
+
+```typescript
+import { expandIncludes, createMemoryStore } from "@jaypie/tildeskill";
+
+const store = createMemoryStore([
+  { alias: "base", content: "Base content" },
+  { alias: "main", content: "Main content", includes: ["base"] },
+]);
+
+const record = await store.get("main");
+const expanded = await expandIncludes(store, record);
+// expanded = "Base content\n\nMain content"
+```
+
+## Filtering and Search
+
+```typescript
+// Filter by namespace prefix
+const kitSkills = await store.list({ namespace: "kit:" });
+
+// Filter by tag
+const cloudSkills = await store.list({ tag: "cloud" });
+
+// Search across alias, name, description, content, and tags
+const results = await store.search("lambda");
+
+// Lookup by nickname
+const skill = await store.getByNickname("amazon");
+```
+
+## Validation Utilities
+
+```typescript
+import { isValidAlias, validateAlias, normalizeAlias } from "@jaypie/tildeskill";
+
+// Check validity
+isValidAlias("my-skill");     // true
+isValidAlias("../../etc");    // false (path traversal)
+
+// Normalize to lowercase
+normalizeAlias("MY-Skill");   // "my-skill"
+
+// Validate and normalize (throws on invalid)
+validateAlias("valid");       // returns "valid"
+validateAlias("../bad");      // throws BadRequestError
+```
+
+## Skill File Format
+
+Skill files use YAML frontmatter:
+
+```yaml
+---
+description: Brief description shown in listings
+includes: base-skill, common-utils
+name: Display Title
+nicknames: alt-name, another-alias
+related: alias1, alias2, alias3
+tags: category1, category2
+---
+
+# Skill Title
+
+Markdown content...
+```
+
+All frontmatter fields accept either comma-separated strings or YAML arrays.
+
+## Testing with Mocks
+
+```typescript
+import { mockTildeskill, restoreTildeskill } from "@jaypie/testkit";
+
+beforeEach(() => {
+  mockTildeskill();
+});
+
+afterEach(() => {
+  restoreTildeskill();
+});
+```
+
+## See Also
+
+- **`skill("fabric")`** - Service patterns that use tildeskill
+- **`skill("mcp")`** - MCP server that uses tildeskill for skill storage