@owlmeans/mongo-resource 0.1.16-rc.0 → 0.1.16

package/README.md

@@ -128,10 +128,9 @@ database — an Entity-layer database tracks its own).
 <!-- owlmeans:agent-guidance:start -->
 ## Agent guidance
 
-This package ships embedded Claude Code skills and GitHub Copilot instructions under
-`agent-meta/`. After installing your `@owlmeans/*` packages, run the OwlMeans
-agent-skills installer to place them into your project's native locations
-(`.claude/skills/` and `.github/instructions/`):
+This package ships embedded agent skills under `agent-meta/`. After installing your
+`@owlmeans/*` packages, run the OwlMeans agent-skills installer to place them into
+your project's skill store (`.agents/skills/`):
 
 ```sh
 npx @owlmeans/agent-skills

package/agent-meta/manifest.json

@@ -1,8 +1,8 @@
 {
-  "schemaVersion": 1,
+  "schemaVersion": 2,
   "package": "@owlmeans/mongo-resource",
-  "version": "0.1.16-rc.0",
-  "generatedAt": "2026-08-11T14:02:34.974Z",
+  "version": "0.1.16",
+  "generatedAt": "2026-08-14T10:14:48.849Z",
   "canonicalRepo": "https://github.com/owlmeans/common",
   "entries": [
     {
@@ -10,14 +10,7 @@
       "name": "mongo-resource",
       "category": "package-specific",
       "file": "skills/mongo-resource/SKILL.md",
-      "canonicalPath": ".claude/skills/mongo-resource/SKILL.md"
-    },
-    {
-      "kind": "instruction",
-      "name": "mongo-resource",
-      "category": "package-specific",
-      "file": "instructions/mongo-resource.instructions.md",
-      "canonicalPath": ".github/instructions/mongo-resource.instructions.md"
+      "canonicalPath": ".agents/skills/mongo-resource/SKILL.md"
     }
   ]
 }

package/agent-meta/skills/mongo-resource/SKILL.md

@@ -8,7 +8,7 @@ user-invocable: false
 # @owlmeans/mongo-resource
 
 **Layer:** Infra
-**Install:** `"@owlmeans/mongo-resource": "^0.1.16-rc.0"` in `dependencies` (peers `mongodb`, `ajv`)
+**Install:** `"@owlmeans/mongo-resource": "^0.1.16"` in `dependencies` (peers `mongodb`, `ajv`)
 
 The Mongo counterpart of [[postgres-resource]]. A collection has no structure of its own, so
 here the resource layer owns the *validator* (`$jsonSchema` from the AJV schema), the indexes,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owlmeans/mongo-resource",
-  "version": "0.1.16-rc.0",
+  "version": "0.1.16",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -26,13 +26,13 @@
     "mongodb": "*"
   },
   "dependencies": {
-    "@owlmeans/context": "^0.1.16-rc.0",
-    "@owlmeans/resource": "^0.1.16-rc.0",
-    "@owlmeans/server-context": "^0.1.16-rc.0"
+    "@owlmeans/context": "^0.1.16",
+    "@owlmeans/resource": "^0.1.16",
+    "@owlmeans/server-context": "^0.1.16"
   },
   "devDependencies": {
     "@owlmeans/dep-config": "workspace:*",
-    "@owlmeans/test-integration": "^0.1.16-rc.0",
+    "@owlmeans/test-integration": "^0.1.16",
     "@types/bun": "^1.3.14",
     "@types/node": "^26.1.0",
     "mongodb": "^6.9.0",

package/agent-meta/instructions/mongo-resource.instructions.md

@@ -1,65 +0,0 @@
----
-description: "How to use @owlmeans/mongo-resource — MongoDB-backed Resource with AJV-schema validators, code migrations and ObjectId reference conversion. Use when defining a mongo resource, declaring record references, or writing mongo migrations."
-applyTo: "**/*.ts, **/*.tsx"
----
-<!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
-
-# @owlmeans/mongo-resource
-
-**Layer:** Infra
-**Install:** `"@owlmeans/mongo-resource": "^0.1.16-rc.0"` in `dependencies` (peers `mongodb`, `ajv`)
-
-## Key Exports
-
-| Export | Description |
-|--------|-------------|
-| `makeMongoResource<R, T>(alias, dbAlias?, serviceAlias?, maker?, collectionName?)` | The resource factory (positional args, NOT an options object) |
-| `MongoResource<T>` | `Resource<T>` + `collection`, `index`, `reference`/`references`, `migration`/`migrations`, `lock`/`unlock` |
-| `MongoTx` | Migration façade: `db`, `collection`, `use(alias)`, `ref(alias)` |
-| `marshalReference`, `demarshalReference`, `marshalCriteria`, `identityCriteria`, `isObjectIdHex` | Reference conversion layer — reuse for raw driver access |
-| `getDeclaration`, `resetDeclarations` | Module-scope migration/reference declarations per alias |
-
-## Usage
-
-```typescript
-export const makeStoryResource: ResourceMaker<StoryRecord, StoryResource> = (dbAlias, serviceAlias) => {
-  const resource = makeMongoResource<StoryRecord, StoryResource>(RES_STORY, dbAlias, serviceAlias, makeStoryResource)
-  resource.schema = StorySchema
-  resource.reference('projectId', RES_PROJECT)   // field stores another record's id
-  resource.index('code', { projectId: 1, code: 1 }, { sparse: true })
-  resource.migration('0001-backfill', async tx => { /* idempotent body */ })
-  return resource
-}
-```
-
-## ObjectId references
-
-- `reference(field, targetAlias?)` — records/criteria carry strings, the collection stores
-  `ObjectId`s (converted like `_id`); the field gets an automatic index (`ref_<field>`)
-  unless an identical key pattern is already declared; the validator declares it `objectId`.
-- Writes are strict (non-24-hex throws `MisshapedRecord`), reads/criteria tolerant. `id`
-  criteria map onto `_id`.
-- Declaring one registers the system migration `$ref:<field>@1` (Pre) that converts existing
-  strings; the boot additionally probes the collection and repairs drift (the double check).
-  Any semantic edit to the shared conversion body must bump the `@N` suffix.
-- NEVER declare business/external keys as references: `entityId`/`entity` slugs, composite
-  `profileId`, `credentials.userId` (external key — but `profile.userId` IS a reference),
-  Stripe/Cloudflare/GitHub ids, minted slugs/tokens.
-- Raw `resource.collection.*` access bypasses conversion — marshal filters with
-  `marshalReference` and stringify read-back ids by hand.
-
-## Migrations
-
-- `migration(name, apply, stage?)` — applied once per database in declaration order,
-  ledgered in `_owlmeans_migrations`. `Pre` runs before validator/index update, `Post` after.
-  Fresh collections baseline (record without running).
-- No multi-document transactions (standalone mongod) → bodies MUST be idempotent; the ledger
-  claims-then-completes on a unique `(alias, name)` index.
-- Checksums fingerprint the body's source text: keep bodies at module scope; an edited
-  applied body raises `MigrationConflict`.
-- `migration()`/`reference()` survive `reinitializeContext` (module-scope declarations);
-  `schema`/`index()` survive only when the maker is passed as the 4th factory argument.
-
-## Depends On
-
-- `@owlmeans/mongo` (service), `@owlmeans/resource` (contracts + migration framework), `@owlmeans/server-context`