caplets 0.11.0 → 0.12.1

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "caplets",
-  "version": "0.11.0",
-  "description": "Progressive disclosure gateway for MCP servers.",
+  "version": "0.12.1",
+  "description": "Progressive disclosure gateway CLI for MCP servers and native Caplets adapters.",
   "keywords": [
     "caplets",
     "gateway",
@@ -17,73 +17,38 @@
   "author": "Spirit-Led Software LLC",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/spiritledsoftware/caplets.git"
+    "url": "git+https://github.com/spiritledsoftware/caplets.git",
+    "directory": "packages/cli"
   },
   "bin": {
     "caplets": "dist/index.js"
   },
   "files": [
     "dist",
-    "caplets",
-    "schemas",
-    "README.md",
-    "LICENSE"
+    "README.md"
   ],
   "type": "module",
   "main": "dist/index.js",
-  "exports": {
-    ".": "./dist/index.js"
-  },
   "publishConfig": {
     "access": "public"
   },
   "dependencies": {
-    "@apidevtools/swagger-parser": "^12.1.0",
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "commander": "^14.0.3",
-    "graphql": "^16.14.0",
-    "vfile": "^6.0.3",
-    "vfile-matter": "^5.0.1",
-    "zod": "^4.4.3"
+    "@caplets/core": "0.12.1"
   },
   "devDependencies": {
-    "@changesets/cli": "^2.31.0",
-    "@types/node": "^25.6.2",
-    "husky": "^9.1.7",
-    "lint-staged": "^17.0.3",
-    "oxfmt": "^0.48.0",
-    "oxlint": "^1.63.0",
+    "@types/node": "^25.7.0",
     "rolldown": "^1.0.0",
     "typescript": "^6.0.3",
-    "vitest": "^4.1.5"
-  },
-  "lint-staged": {
-    "*.{js,cjs,mjs,ts,json,md,yml,yaml}": "oxfmt --check",
-    "*.{js,cjs,mjs,ts}": "oxlint"
+    "vitest": "^4.1.6"
   },
   "engines": {
     "node": ">=22"
   },
   "scripts": {
-    "build": "rolldown -c",
-    "build:watch": "rolldown -c --watch",
-    "benchmark": "node benchmarks/run-deterministic.mjs",
-    "benchmark:check": "node benchmarks/run-deterministic.mjs --check",
-    "benchmark:live": "node benchmarks/run-live.mjs",
-    "benchmark:live:opencode": "node benchmarks/run-live.mjs --agent opencode",
-    "benchmark:live:pi": "node benchmarks/run-live.mjs --agent pi",
-    "changeset": "changeset",
-    "dev": "node ./scripts/dev.mjs",
-    "format": "oxfmt .",
-    "format:check": "oxfmt --check .",
-    "lint": "oxlint .",
-    "lint:fix": "oxlint --fix .",
-    "release": "pnpm build && changeset publish",
-    "schema:check": "rolldown -c rolldown.schema.config.ts && node dist-schema/generate-config-schema.js --check && rm -rf dist-schema",
-    "schema:generate": "rolldown -c rolldown.schema.config.ts && node dist-schema/generate-config-schema.js && rm -rf dist-schema",
+    "build": "rm -rf dist && rolldown -c",
+    "dev": "node ../../scripts/dev.mjs",
     "typecheck": "tsc --noEmit",
-    "test": "vitest run",
-    "verify": "pnpm format:check && pnpm lint && pnpm typecheck && pnpm schema:check && pnpm test && pnpm benchmark:check && pnpm build",
-    "version-packages": "changeset version"
+    "test": "vitest run --passWithNoTests"
   }
 }

package/caplets/context7.md

@@ -1,33 +0,0 @@
----
-$schema: https://raw.githubusercontent.com/spiritledsoftware/caplets/main/schemas/caplet.schema.json
-name: Context7 Documentation
-description: Fetch current library and framework documentation through Context7 before using version-sensitive APIs.
-tags:
-  - docs
-  - libraries
-  - frameworks
-  - api-reference
-mcpServer:
-  command: npx
-  args:
-    - -y
-    - "@upstash/context7-mcp"
----
-
-# Context7 Documentation
-
-Use this Caplet when the agent needs up-to-date library, SDK, framework, CLI, or cloud-service
-documentation before writing code or giving technical instructions.
-
-## Good Fits
-
-- Check current API signatures for fast-moving JavaScript, TypeScript, Python, or cloud libraries.
-- Look up migration notes before changing framework configuration.
-- Retrieve official examples for a specific package version.
-- Resolve uncertainty about CLI flags, config files, or SDK initialization.
-
-## Use Carefully
-
-- Prefer primary documentation over snippets when implementation risk is high.
-- Record the library or package name clearly before searching.
-- Do not use this as a substitute for project-local types and tests.

package/caplets/github/CAPLET.md

@@ -1,54 +0,0 @@
----
-$schema: https://raw.githubusercontent.com/spiritledsoftware/caplets/main/schemas/caplet.schema.json
-name: GitHub
-description: Inspect and manage GitHub repositories, issues, pull requests, branches, commits, and code review workflows.
-tags:
-  - code
-  - github
-  - pull-requests
-  - issues
-  - reviews
-mcpServer:
-  command: docker
-  args:
-    - run
-    - -i
-    - --rm
-    - -e
-    - GITHUB_PERSONAL_ACCESS_TOKEN
-    - ghcr.io/github/github-mcp-server
-  env:
-    GITHUB_PERSONAL_ACCESS_TOKEN: $env:GITHUB_PERSONAL_ACCESS_TOKEN
----
-
-# GitHub
-
-Use this Caplet when the agent needs live GitHub repository context or needs to act on
-issues, pull requests, branches, commits, or review feedback.
-
-## Good Fits
-
-- Summarize recent pull request activity before a code review.
-- Inspect open issues and identify implementation work.
-- Create or update issues from an implementation plan.
-- Compare branches, inspect commits, or review pull request files.
-- Leave review comments after the agent has inspected the relevant diff.
-
-## Use Carefully
-
-- Mutating operations can affect real repositories. Prefer read operations first.
-- Use a least-privilege `GITHUB_PERSONAL_ACCESS_TOKEN`.
-- Do not ask the agent to expose token values, repository secrets, or private issue contents outside
-  the intended conversation.
-
-## Setup
-
-Create a GitHub personal access token with the minimum repository scopes needed for your workflow,
-then export it before starting Caplets:
-
-```sh
-export GITHUB_PERSONAL_ACCESS_TOKEN=github_pat_...
-caplets serve
-```
-
-This Caplet uses GitHub's official MCP server container, so Docker must be available on the host.

package/caplets/github/README.md

@@ -1,13 +0,0 @@
-# GitHub Caplet
-
-This Caplet wraps GitHub's official MCP server container:
-
-```sh
-docker run -i --rm -e GITHUB_PERSONAL_ACCESS_TOKEN ghcr.io/github/github-mcp-server
-```
-
-Install it from this repo:
-
-```sh
-caplets install spiritledsoftware/caplets github
-```

package/caplets/github-cli/CAPLET.md

@@ -1,41 +0,0 @@
----
-$schema: https://raw.githubusercontent.com/spiritledsoftware/caplets/main/schemas/caplet.schema.json
-name: GitHub CLI
-description: Inspect GitHub pull requests and issues through curated gh CLI commands.
-tags:
-  - cli
-  - github
-  - code
-cliTools:
-  actions:
-    gh_pr_status:
-      description: Show pull request status for the current branch as JSON.
-      command: gh
-      args:
-        - pr
-        - status
-        - --json
-        - currentBranch
-      output:
-        type: json
-      annotations:
-        readOnlyHint: true
-        openWorldHint: true
-    gh_issue_list:
-      description: List open GitHub issues as JSON.
-      command: gh
-      args:
-        - issue
-        - list
-        - --json
-        - number,title,state,url
-      output:
-        type: json
-      annotations:
-        readOnlyHint: true
-        openWorldHint: true
----
-
-# GitHub CLI
-
-Use this Caplet to expose read-oriented GitHub workflows through `gh` without giving the agent an unrestricted shell.

package/caplets/linear/CAPLET.md

@@ -1,50 +0,0 @@
----
-$schema: https://raw.githubusercontent.com/spiritledsoftware/caplets/main/schemas/caplet.schema.json
-name: Linear
-description: Plan and track product work in Linear by reading teams, projects, cycles, issues, comments, and workflow state.
-tags:
-  - planning
-  - linear
-  - issues
-  - projects
-  - triage
-mcpServer:
-  transport: http
-  url: https://mcp.linear.app/mcp
-  auth:
-    type: oauth2
----
-
-# Linear
-
-Use this Caplet when the agent needs live product planning context from Linear or needs to keep
-implementation work synchronized with issues, projects, and team workflows.
-
-## Good Fits
-
-- Find the current issue or project that matches a requested feature.
-- Summarize open work by team, project, cycle, label, or assignee.
-- Draft issue breakdowns from a technical plan.
-- Add implementation notes or status comments after code changes.
-- Check whether a bug or feature already has active work before creating a new issue.
-
-## Reference Files
-
-- [Workflows](./workflows.md): recommended lookup, planning, status update, and triage flows.
-
-## Use Carefully
-
-- Linear issue updates are visible to teammates. Read first, then write deliberately.
-- Keep issue titles and comments concise; use links to detailed implementation artifacts when useful.
-- Avoid broad, noisy searches when a team key, issue ID, project, or label is available.
-
-## Setup
-
-Authenticate once through Caplets:
-
-```sh
-caplets auth login linear
-```
-
-The Linear MCP endpoint supports OAuth. Caplets stores the resulting token bundle in your local
-Caplets auth store.

package/caplets/linear/workflows.md

@@ -1,9 +0,0 @@
-# Linear Workflows
-
-Useful agent flows:
-
-- **Issue lookup**: search by issue key first, then by title or project if no key is provided.
-- **Planning**: read project context, summarize constraints, then create child issues only when the
-  requested breakdown is clear.
-- **Status updates**: comment with what changed, verification run, and remaining risk.
-- **Triage**: group candidate issues by urgency, owner, and whether they are blocked.

package/caplets/repo-cli/CAPLET.md

@@ -1,37 +0,0 @@
----
-$schema: https://raw.githubusercontent.com/spiritledsoftware/caplets/main/schemas/caplet.schema.json
-name: Repository CLI
-description: Inspect and run common local repository workflows through curated CLI tools.
-tags:
-  - cli
-  - code
-cliTools:
-  actions:
-    git_status:
-      description: Show concise Git working tree status.
-      command: git
-      args:
-        - status
-        - --short
-      annotations:
-        readOnlyHint: true
-    git_current_branch:
-      description: Print the current Git branch name.
-      command: git
-      args:
-        - branch
-        - --show-current
-      annotations:
-        readOnlyHint: true
-    package_test:
-      description: Run the repository test script with pnpm.
-      command: pnpm
-      args:
-        - run
-        - test
-      timeoutMs: 120000
----
-
-# Repository CLI
-
-Use this Caplet to expose a small, typed set of local repository commands without giving an agent arbitrary shell access.