@procedures/mongo 0.1.0 → 0.2.1

package/src/procedures/documents.count.ts

@@ -3,7 +3,7 @@
  * Count documents matching a filter
  */
 
-import { createProcedure, zodAdapter, type Procedure, type ProcedureContext } from "@procedures/client";
+import { createProcedure, zodAdapter, type Effects, type Procedure, type ProcedureContext } from "@procedures/client";
 import { collectionFor, type ScopeInput } from "../scope.js";
 import { scopeFields, documentObject } from "./input-schemas.js";
 import { z } from "zod";
@@ -34,12 +34,15 @@ const countOutputSchema = zodAdapter<CountOutput>(
 export const countProcedure: Procedure<
   CountInput,
   CountOutput,
-  { description: string }
+  { description: string; effects?: Effects }
 > = createProcedure()
   .path(["mongo", "documents", "count"])
   .input(countInputSchema)
   .output(countOutputSchema)
-  .meta({ description: "Count documents matching a filter" })
+  .meta({
+    description: "Count documents matching a filter",
+    effects: { reads: ["mongo", "network"], writes: [] },
+  })
   .handler(async (input: CountInput, ctx: ProcedureContext) => {
     const { collection } = await collectionFor(input, ctx);
 

package/src/procedures/documents.delete.ts

@@ -3,7 +3,7 @@
  * Delete documents matching a filter
  */
 
-import { createProcedure, type Procedure, type ProcedureContext, zodAdapter } from "@procedures/client";
+import { createProcedure, type Effects, type Procedure, type ProcedureContext, zodAdapter } from "@procedures/client";
 import { collectionFor } from "../scope.js";
 import { described, scopeFields, targetFields } from "./input-schemas.js";
 import { z } from "zod";
@@ -33,12 +33,15 @@ const deleteOutputSchema = zodAdapter<DeleteOutput>(
 export const deleteProcedure: Procedure<
   DeleteInput,
   DeleteOutput,
-  { description: string }
+  { description: string; effects?: Effects }
 > = createProcedure()
   .path(["mongo", "documents", "delete"])
   .input(deleteInputSchema)
   .output(deleteOutputSchema)
-  .meta({ description: "Delete documents matching a filter" })
+  .meta({
+    description: "Delete documents matching a filter",
+    effects: { reads: ["mongo", "network"], writes: ["mongo", "network"] },
+  })
   .handler(async (input: DeleteInput, ctx: ProcedureContext) => {
     const { collection } = await collectionFor(input, ctx);
     const filter = targetFilter(input);

package/src/procedures/documents.find.ts

@@ -5,6 +5,7 @@
 
 import {
   createProcedure,
+  type Effects,
   type Procedure,
   type ProcedureContext,
   zodAdapter,
@@ -102,12 +103,15 @@ const findOutputSchema = zodAdapter<FindOutput>(
 export const findProcedure: Procedure<
   FindInput,
   FindOutput,
-  { description: string }
+  { description: string; effects?: Effects }
 > = createProcedure()
   .path(["mongo", "documents", "find"])
   .input(findInputSchema)
   .output(findOutputSchema)
-  .meta({ description: "Find documents with pagination and filtering" })
+  .meta({
+    description: "Find documents with pagination and filtering",
+    effects: { reads: ["mongo", "network"], writes: [] },
+  })
   .handler(async (input: FindInput, ctx: ProcedureContext) => {
     const { collection } = await collectionFor(input, ctx);
 

package/src/procedures/documents.get.ts

@@ -5,6 +5,7 @@
 
 import {
   createProcedure,
+  type Effects,
   type Procedure,
   type ProcedureContext,
   zodAdapter,
@@ -78,12 +79,15 @@ const getOutputSchema = zodAdapter<GetOutput>(
 export const getProcedure: Procedure<
   GetInput,
   GetOutput,
-  { description: string }
+  { description: string; effects?: Effects }
 > = createProcedure()
   .path(["mongo", "documents", "get"])
   .input(getInputSchema)
   .output(getOutputSchema)
-  .meta({ description: "Get a single document by ID" })
+  .meta({
+    description: "Get a single document by ID",
+    effects: { reads: ["mongo", "network"], writes: [] },
+  })
   .handler(async (input: GetInput, ctx: ProcedureContext) => {
     const { collection } = await collectionFor(input, ctx);
 

package/src/procedures/documents.insert.ts

@@ -3,7 +3,7 @@
  * Insert one or more documents
  */
 
-import { createProcedure, zodAdapter, type Procedure, type ProcedureContext } from "@procedures/client";
+import { createProcedure, zodAdapter, type Effects, type Procedure, type ProcedureContext } from "@procedures/client";
 import { collectionFor, type ScopeInput } from "../scope.js";
 import { scopeFields, documentObject } from "./input-schemas.js";
 import { z } from "zod";
@@ -41,12 +41,15 @@ const insertOutputSchema = zodAdapter<InsertOutput>(
 export const insertProcedure: Procedure<
   InsertInput,
   InsertOutput,
-  { description: string }
+  { description: string; effects?: Effects }
 > = createProcedure()
   .path(["mongo", "documents", "insert"])
   .input(insertInputSchema)
   .output(insertOutputSchema)
-  .meta({ description: "Insert one or more documents" })
+  .meta({
+    description: "Insert one or more documents",
+    effects: { reads: ["mongo", "network"], writes: ["mongo", "network"], destructive: false },
+  })
   .handler(async (input: InsertInput, ctx: ProcedureContext) => {
     const { collection } = await collectionFor(input, ctx);
 

package/src/procedures/documents.update.ts

@@ -3,7 +3,7 @@
  * Update documents matching a filter
  */
 
-import { createProcedure, type Procedure, type ProcedureContext, zodAdapter } from "@procedures/client";
+import { createProcedure, type Effects, type Procedure, type ProcedureContext, zodAdapter } from "@procedures/client";
 import { collectionFor } from "../scope.js";
 import { described, documentObject, scopeFields, targetFields } from "./input-schemas.js";
 import { z } from "zod";
@@ -66,12 +66,15 @@ const updateOutputSchema = zodAdapter<UpdateOutput>(
 export const updateProcedure: Procedure<
   UpdateInput,
   UpdateOutput,
-  { description: string }
+  { description: string; effects?: Effects }
 > = createProcedure()
   .path(["mongo", "documents", "update"])
   .input(updateInputSchema)
   .output(updateOutputSchema)
-  .meta({ description: "Update documents matching a filter" })
+  .meta({
+    description: "Update documents matching a filter",
+    effects: { reads: ["mongo", "network"], writes: ["mongo", "network"] },
+  })
   .handler(async (input: UpdateInput, ctx: ProcedureContext) => {
     const { collection } = await collectionFor(input, ctx);
     const upsert = input.upsert ?? false;

package/src/procedures/indexes.create.ts

@@ -3,7 +3,7 @@
  * Create an index on a collection
  */
 
-import { createProcedure, zodAdapter, type Procedure, type ProcedureContext } from "@procedures/client";
+import { createProcedure, zodAdapter, type Effects, type Procedure, type ProcedureContext } from "@procedures/client";
 import { collectionFor, type ScopeInput } from "../scope.js";
 import { scopeFields } from "./input-schemas.js";
 import { z } from "zod";
@@ -48,12 +48,16 @@ const createIndexOutputSchema = zodAdapter<CreateIndexOutput>(
 export const createIndexProcedure: Procedure<
   CreateIndexInput,
   CreateIndexOutput,
-  { description: string }
+  { description: string; effects?: Effects }
 > = createProcedure()
   .path(["mongo", "indexes", "create"])
   .input(createIndexInputSchema)
   .output(createIndexOutputSchema)
-  .meta({ description: "Create an index on a collection" })
+  .meta({
+    description: "Create an index on a collection",
+    // A second call with the same keys and options keeps the existing index
+    effects: { reads: ["mongo", "network"], writes: ["mongo", "network"], destructive: false, idempotent: true },
+  })
   .handler(async (input: CreateIndexInput, ctx: ProcedureContext) => {
     const { collection } = await collectionFor(input, ctx);
 

package/src/procedures/indexes.drop.ts

@@ -3,7 +3,7 @@
  * Drop an index from a collection
  */
 
-import { createProcedure, zodAdapter, type Procedure, type ProcedureContext } from "@procedures/client";
+import { createProcedure, zodAdapter, type Effects, type Procedure, type ProcedureContext } from "@procedures/client";
 import { collectionFor, type ScopeInput } from "../scope.js";
 import { scopeFields } from "./input-schemas.js";
 import { z } from "zod";
@@ -33,12 +33,15 @@ const dropIndexOutputSchema = zodAdapter<DropIndexOutput>(
 export const dropIndexProcedure: Procedure<
   DropIndexInput,
   DropIndexOutput,
-  { description: string }
+  { description: string; effects?: Effects }
 > = createProcedure()
   .path(["mongo", "indexes", "drop"])
   .input(dropIndexInputSchema)
   .output(dropIndexOutputSchema)
-  .meta({ description: "Drop an index from a collection" })
+  .meta({
+    description: "Drop an index from a collection",
+    effects: { reads: ["mongo", "network"], writes: ["mongo", "network"] },
+  })
   .handler(async (input: DropIndexInput, ctx: ProcedureContext) => {
     const { collection } = await collectionFor(input, ctx);
 

package/src/procedures/indexes.list.ts

@@ -3,7 +3,7 @@
  * List indexes on a collection
  */
 
-import { createProcedure, zodAdapter, type Procedure, type ProcedureContext } from "@procedures/client";
+import { createProcedure, zodAdapter, type Effects, type Procedure, type ProcedureContext } from "@procedures/client";
 import { collectionFor, type ScopeInput } from "../scope.js";
 import { scopeFields } from "./input-schemas.js";
 import { z } from "zod";
@@ -39,12 +39,15 @@ const listIndexesOutputSchema = zodAdapter<ListIndexesOutput>(
 export const listIndexesProcedure: Procedure<
   ListIndexesInput,
   ListIndexesOutput,
-  { description: string }
+  { description: string; effects?: Effects }
 > = createProcedure()
   .path(["mongo", "indexes", "list"])
   .input(listIndexesInputSchema)
   .output(listIndexesOutputSchema)
-  .meta({ description: "List indexes on a collection" })
+  .meta({
+    description: "List indexes on a collection",
+    effects: { reads: ["mongo", "network"], writes: [] },
+  })
   .handler(async (input: ListIndexesInput, ctx: ProcedureContext) => {
     const { collection } = await collectionFor(input, ctx);
 

package/src/register.ts

@@ -1,17 +1,11 @@
 /**
- * Importing this file registers the procedures of @procedures/mongo in the global registry
- * (DECISIONS-2026-10, "Every package root registers its procedures"). The procedures as data
- * are in `module.ts`, which registers nothing: a host with its own registry uses that one.
+ * Importing this file registers the procedures of @procedures/mongo, and of the modules that it
+ * requires, in the global registry: `import "@procedures/mongo/register"`. The package root and the
+ * `./module` entry register nothing (ARCHITECTURE-PROPOSALS-2026-10, P9).
  */
 
-import { registerProcedures } from "@procedures/client";
-import { mongoModule } from "./module.js";
+import { registerMongoProcedures } from "./module.js";
 
 export * from "./module.js";
 
-export function registerMongoProcedures(): void {
-  registerProcedures(mongoModule.procedures);
-}
-
-// Auto-register when this module is loaded
 registerMongoProcedures();