@jaypie/mcp 0.7.0 → 0.7.2

package/dist/suites/docs/index.js

@@ -9,7 +9,7 @@ import { gt } from 'semver';
 /**
  * Docs Suite - Documentation services (skill, version, release_notes)
  */
-const BUILD_VERSION_STRING = "@jaypie/mcp@0.7.0#e0ca7c9f"
+const BUILD_VERSION_STRING = "@jaypie/mcp@0.7.2#5d947297"
     ;
 const __filename$1 = fileURLToPath(import.meta.url);
 const __dirname$1 = path.dirname(__filename$1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jaypie/mcp",
-  "version": "0.7.0",
+  "version": "0.7.2",
   "description": "Jaypie MCP",
   "repository": {
     "type": "git",

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.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/mcp/0.7.2.md

@@ -0,0 +1,18 @@
+---
+version: 0.7.2
+date: 2026-01-30
+summary: Document JaypieNextJs streaming configuration requirements
+---
+
+## Documentation
+
+- Added JaypieNextJs streaming documentation to `streaming.md` skill
+- Added JaypieNextJs construct to `cdk.md` skill
+- Clarified that `streaming: true` requires `open-next.config.ts` with `aws-lambda-streaming` wrapper
+
+## Context
+
+Issue #171 reported that `JaypieNextJs` with `streaming: true` returns a JSON envelope instead of streamed HTML. This is expected behavior - Lambda response streaming requires both:
+
+1. CDK: `streaming: true` (configures `InvokeMode: RESPONSE_STREAM`)
+2. Next.js: `open-next.config.ts` with `wrapper: "aws-lambda-streaming"`

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.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/cdk.md

@@ -139,7 +139,24 @@ const handler = new JaypieLambda(this, "Handler", {
 });
 ```
 
+## JaypieNextJs
+
+Deploy Next.js applications:
+
+```typescript
+import { JaypieNextJs } from "@jaypie/constructs";
+
+new JaypieNextJs(this, "App", {
+  nextjsPath: "../nextjs",
+  domainName: "app.example.com",
+  hostedZone: "example.com",
+  streaming: true,  // Optional: enables response streaming
+});
+```
+
+**Streaming Note:** When `streaming: true`, also create `open-next.config.ts` in your Next.js app with `wrapper: "aws-lambda-streaming"`. See `skill("streaming")` for details.
+
 ## See Also
 
-- **`skill("streaming")`** - JaypieDistribution with `streaming: true` for response streaming
+- **`skill("streaming")`** - JaypieDistribution and JaypieNextJs streaming configuration
 - **`skill("websockets")`** - JaypieWebSocket and JaypieWebSocketTable constructs

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/streaming.md

@@ -76,6 +76,8 @@ export const handler = lambdaStreamHandler(async (event, context) => {
 
 ## CDK Configuration
 
+### JaypieDistribution
+
 ```typescript
 import { JaypieLambda, JaypieDistribution } from "@jaypie/constructs";
 
@@ -90,6 +92,40 @@ new JaypieDistribution(this, "Api", {
 });
 ```
 
+### JaypieNextJs Streaming
+
+For Next.js applications with `JaypieNextJs`, streaming requires **two** configurations:
+
+1. **CDK** - Set `streaming: true` in the construct
+2. **Next.js App** - Create `open-next.config.ts` with the streaming wrapper
+
+```typescript
+// CDK Stack
+import { JaypieNextJs } from "@jaypie/constructs";
+
+new JaypieNextJs(this, "App", {
+  nextjsPath: "../nextjs",
+  streaming: true,
+});
+```
+
+```typescript
+// nextjs/open-next.config.ts (required for streaming)
+import type { OpenNextConfig } from "@opennextjs/aws/types/open-next.js";
+
+const config = {
+  default: {
+    override: {
+      wrapper: "aws-lambda-streaming",
+    },
+  },
+} satisfies OpenNextConfig;
+
+export default config;
+```
+
+**Important:** Without `open-next.config.ts`, the Lambda returns a JSON envelope `{ statusCode, headers, body }` instead of streaming HTML. This is because `cdk-nextjs-standalone` configures the Lambda Function URL with `RESPONSE_STREAM` invoke mode, but OpenNext also needs to be configured to use the streaming wrapper.
+
 ## Error Handling
 
 Errors are written to the stream in the configured format:

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