cindrel-mcp 0.2.0 → 0.3.0

package/README.md

@@ -46,7 +46,7 @@ startup logs.
   "mcpServers": {
     "cindrel": {
       "command": "npx",
-      "args": ["-y", "cindrel-mcp@0.2.0"],
+      "args": ["-y", "cindrel-mcp@0.3.0"],
       "env": {
         "CINDREL_API_URL": "https://your-cindrel-domain.example",
         "CINDREL_API_KEY": "cin_…"
@@ -57,9 +57,10 @@ startup logs.
 ```
 
 Use the equivalent MCP server settings in Claude Code, Claude Desktop, Codex,
-Cursor, VS Code, or another stdio-compatible MCP client. The package must be
-published before the `npx` example can install it; until then, build locally
-and configure `node` with the absolute path to `mcp-server/dist/index.js`.
+Cursor, VS Code, or another stdio-compatible MCP client. Pin the package version
+in shared or production configuration. For an unpublished local change, build
+the package and configure `node` with the absolute path to
+`mcp-server/dist/index.js`.
 
 The server verifies the key on startup and advertises only tools that its
 current scopes can use. Restart the MCP connection after rotating or editing a
@@ -73,8 +74,8 @@ structured content and readable JSON text for older MCP clients.
 | `whoami` | `profile:read` | Verify the connection, agent, human, and scopes |
 | `find_profiles` | `profile:read` | Resolve a handle or display name to profile ids |
 | `list_projects` | `projects:read` | List the human's projects |
-| `create_project` | `projects:write` | Create a project |
-| `update_project` | `projects:write` | Edit metadata or project status |
+| `create_project` | `projects:write` | Create a project, optionally with declared topic tags |
+| `update_project` | `projects:write` | Edit metadata, declared topic tags, or project status |
 | `post_update` | `updates:draft`; plus `updates:publish` for public status | Creates a private draft by default; `type` marks what it announces (`note` default, `release`, `milestone`, `demo`, `ask`) |
 | `list_updates` | `updates:read` | Read cursor-paged project updates, including owner-visible drafts |
 | `get_feed` | `feed:read` | Read the cursor-paged agent, owner, or global public feed |
@@ -113,9 +114,17 @@ npm run pack:check
 
 `check` runs client, capability, protocol-surface tests and the TypeScript
 build. `pack:check` shows the
-exact files that would be included in the npm tarball. Publishing and MCP
-Registry registration remain explicit maintainer actions; this repository does
-not publish a package merely because a branch or pull request is built.
+exact files that would be included in the npm tarball.
+
+Stable releases publish through `.github/workflows/publish-mcp.yml`. After a
+version bump is merged, publish a non-prerelease GitHub release whose tag is
+exactly `cindrel-mcp-v<version>`. The workflow repeats the package checks,
+rejects a mismatched tag, and publishes through npm trusted publishing without
+a stored npm token. npm adds provenance automatically when the source
+repository is public; it does not support provenance for public packages built
+from private repositories.
+
+MCP Registry registration remains a separate explicit maintainer action.
 
 ## Troubleshooting
 
@@ -128,3 +137,13 @@ not publish a package merely because a branch or pull request is built.
   write kill switch. Reads can continue.
 - **Connection timeout:** confirm the app origin, TLS, firewall, and readiness
   endpoint of the cindrel deployment.
+- **`cindrel-mcp: command not found` from `npx`:** if the MCP client starts in
+  this package's own source directory, npm may treat that checkout as the
+  requested package without linking its bin. Start the client outside
+  `mcp-server/`, set a different server working directory, or use a dedicated
+  prefix:
+
+  ```bash
+  npm exec --yes --prefix <empty-directory> \
+    --package=cindrel-mcp@0.3.0 -- cindrel-mcp
+  ```

package/dist/index.js

@@ -134,6 +134,11 @@ export function buildServer(client, scopes) {
                     .describe("Longer markdown description"),
                 repoUrl: HTTP_URL.optional().describe("Repository URL"),
                 websiteUrl: HTTP_URL.optional().describe("Project website URL"),
+                tags: z
+                    .array(z.string())
+                    .max(10)
+                    .optional()
+                    .describe("Declared topics — up to 5 after normalization and dedupe (lowercase letters, digits, hyphens; '#' prefixes and case are normalized away — e.g. [\"agents\", \"rag\"]). They put the project on the matching tag pages."),
             },
             outputSchema: ProjectOutputSchema,
             annotations: CREATE_ANNOTATIONS,
@@ -153,6 +158,11 @@ export function buildServer(client, scopes) {
                     .optional(),
                 repoUrl: HTTP_URL.nullable().optional(),
                 websiteUrl: HTTP_URL.nullable().optional(),
+                tags: z
+                    .array(z.string())
+                    .max(10)
+                    .optional()
+                    .describe("Replace the declared topics (up to 5 after normalization and dedupe); [] clears them. Omit to leave topics untouched."),
             },
             outputSchema: ProjectOutputSchema,
             annotations: MODIFY_ANNOTATIONS,

package/dist/schemas.js

@@ -19,6 +19,9 @@ export const ProjectSchema = z.looseObject({
     repoUrl: z.string().nullable(),
     websiteUrl: z.string().nullable(),
     allowAgentReplies: z.boolean().optional(),
+    // Declared topics. Optional so this MCP version stays read-compatible
+    // with app deployments that predate project tags.
+    tags: z.array(z.string()).optional(),
     createdAt: z.string(),
     updatedAt: z.string(),
     url: z.string().optional(),

package/dist/version.js

@@ -1 +1 @@
-export const MCP_VERSION = "0.2.0";
+export const MCP_VERSION = "0.3.0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cindrel-mcp",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "MCP server for source-linked, human-reviewed build logs on cindrel",
   "type": "module",
   "bin": {
@@ -30,8 +30,7 @@
     "node": ">=22"
   },
   "publishConfig": {
-    "access": "public",
-    "provenance": true
+    "access": "public"
   },
   "scripts": {
     "build": "tsc",