@atscript/db-mongo 0.1.38 → 0.1.40

package/dist/mongo-filter-B5ZINZPF.cjs

@@ -0,0 +1,40 @@
+let _atscript_db = require("@atscript/db");
+//#region src/lib/mongo-filter.ts
+const EMPTY = {};
+const mongoVisitor = {
+	comparison(field, op, value) {
+		if (op === "$eq") return { [field]: value };
+		return { [field]: { [op]: value } };
+	},
+	and(children) {
+		if (children.length === 0) return EMPTY;
+		if (children.length === 1) return children[0];
+		return { $and: children };
+	},
+	or(children) {
+		if (children.length === 0) return { _impossible: true };
+		if (children.length === 1) return children[0];
+		return { $or: children };
+	},
+	not(child) {
+		return { $nor: [child] };
+	}
+};
+/**
+* Translates a generic {@link FilterExpr} into a MongoDB-compatible
+* {@link Filter} document.
+*
+* MongoDB's query language is nearly identical to the `FilterExpr` structure,
+* so this is largely a structural pass-through via the `walkFilter` visitor.
+*/
+function buildMongoFilter(filter) {
+	if (!filter || Object.keys(filter).length === 0) return EMPTY;
+	return (0, _atscript_db.walkFilter)(filter, mongoVisitor) ?? EMPTY;
+}
+//#endregion
+Object.defineProperty(exports, "buildMongoFilter", {
+	enumerable: true,
+	get: function() {
+		return buildMongoFilter;
+	}
+});

package/dist/{mongo-filter-CL69Yhcm.mjs → mongo-filter-CcQO-sEh.mjs}

@@ -1,6 +1,5 @@
 import { walkFilter } from "@atscript/db";
-
-//#region packages/db-mongo/src/lib/mongo-filter.ts
+//#region src/lib/mongo-filter.ts
 const EMPTY = {};
 const mongoVisitor = {
 	comparison(field, op, value) {
@@ -21,10 +20,16 @@ const mongoVisitor = {
 		return { $nor: [child] };
 	}
 };
+/**
+* Translates a generic {@link FilterExpr} into a MongoDB-compatible
+* {@link Filter} document.
+*
+* MongoDB's query language is nearly identical to the `FilterExpr` structure,
+* so this is largely a structural pass-through via the `walkFilter` visitor.
+*/
 function buildMongoFilter(filter) {
 	if (!filter || Object.keys(filter).length === 0) return EMPTY;
 	return walkFilter(filter, mongoVisitor) ?? EMPTY;
 }
-
 //#endregion
-export { buildMongoFilter };
+export { buildMongoFilter as t };

package/dist/plugin.cjs

@@ -1,31 +1,9 @@
-"use strict";
-Object.defineProperty(exports, '__esModule', { value: true });
-//#region rolldown:runtime
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
-		key = keys[i];
-		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
-			get: ((k) => from[k]).bind(null, key),
-			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-		});
-	}
-	return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
-	value: mod,
-	enumerable: true
-}) : target, mod));
-
-//#endregion
-const __atscript_core = __toESM(require("@atscript/core"));
-
-//#region packages/db-mongo/src/plugin/annotations.ts
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
+});
+let _atscript_core = require("@atscript/core");
+//#region src/plugin/annotations.ts
 const analyzers = [
 	"lucene.standard",
 	"lucene.simple",
@@ -42,18 +20,33 @@ const analyzers = [
 	"lucene.russian",
 	"lucene.arabic"
 ];
+/**
+* MongoDB-specific annotations.
+*
+* Merged into the global config under `{ db: { mongo: ... } }` so they
+* live alongside core's `@db.table`, `@db.index.*`, etc.
+*
+* Annotations removed (now in core):
+* - `@mongo.index.plain` → use `@db.index.plain`
+* - `@mongo.index.unique` → use `@db.index.unique`
+* - `@db.mongo.index.text` → use `@db.index.fulltext` (with optional weight arg)
+* - `@db.mongo.patch.strategy` → use `@db.patch.strategy`
+* - `@db.mongo.array.uniqueItems` → use `@expect.array.uniqueItems`
+* - `@db.mongo.autoIndexes` → removed (use explicit syncIndexes() calls)
+* - `@db.mongo.search.vector` → use `@db.search.vector` (generic, in @atscript/db/plugin)
+* - `@db.mongo.search.filter` → use `@db.search.filter` (generic, in @atscript/db/plugin)
+*/
 const annotations = {
-	collection: new __atscript_core.AnnotationSpec({
+	collection: new _atscript_core.AnnotationSpec({
 		description: "Marks an interface as a **MongoDB collection**.\n\n- Use together with `@db.table \"name\"` which provides the collection name.\n- Automatically injects a **non-optional** `_id` field if not explicitly defined.\n- `_id` must be of type **`string`**, **`number`**, or **`mongo.objectId`**.\n\n**Example:**\n```atscript\n@db.table \"users\"\n@db.mongo.collection\nexport interface User {\n    _id: mongo.objectId\n    email: string.email\n}\n```\n",
 		nodeType: ["interface"],
 		validate(token, args, doc) {
 			const parent = token.parentNode;
 			const struc = parent?.getDefinition();
 			const errors = [];
-			if ((0, __atscript_core.isInterface)(parent) && parent.props.has("_id") && (0, __atscript_core.isStructure)(struc)) {
+			if ((0, _atscript_core.isInterface)(parent) && parent.props.has("_id") && (0, _atscript_core.isStructure)(struc)) {
 				const _id = parent.props.get("_id");
-				const isOptional = !!_id.token("optional");
-				if (isOptional) errors.push({
+				if (!!_id.token("optional")) errors.push({
 					message: `[db.mongo] _id can't be optional in Mongo Collection`,
 					severity: 1,
 					range: _id.token("identifier").range
@@ -61,9 +54,9 @@ const annotations = {
 				const definition = _id.getDefinition();
 				if (!definition) return errors;
 				let wrongType = false;
-				if ((0, __atscript_core.isRef)(definition)) {
+				if ((0, _atscript_core.isRef)(definition)) {
 					const def = doc.unwindType(definition.id, definition.chain)?.def;
-					if ((0, __atscript_core.isPrimitive)(def) && !["string", "number"].includes(def.config.type)) wrongType = true;
+					if ((0, _atscript_core.isPrimitive)(def) && !["string", "number"].includes(def.config.type)) wrongType = true;
 				} else wrongType = true;
 				if (wrongType) errors.push({
 					message: `[db.mongo] _id must be of type string, number or mongo.objectId`,
@@ -73,17 +66,17 @@ const annotations = {
 			}
 			return errors;
 		},
-		modify(token, args, doc) {
+		modify(token, _args, _doc) {
 			const parent = token.parentNode;
 			const struc = parent?.getDefinition();
-			if ((0, __atscript_core.isInterface)(parent) && !parent.props.has("_id") && (0, __atscript_core.isStructure)(struc)) struc.addVirtualProp({
+			if ((0, _atscript_core.isInterface)(parent) && !parent.props.has("_id") && (0, _atscript_core.isStructure)(struc)) struc.addVirtualProp({
 				name: "_id",
 				type: "mongo.objectId",
 				documentation: "Mongodb Primary Key ObjectId"
 			});
 		}
 	}),
-	capped: new __atscript_core.AnnotationSpec({
+	capped: new _atscript_core.AnnotationSpec({
 		description: "Creates a **capped collection** with a fixed maximum size.\n\n- Capped collections have fixed size and maintain insertion order.\n- Ideal for logs, event streams, and cache-like data.\n- Changing the cap size requires dropping and recreating the collection — use `@db.sync.method \"drop\"` to allow this.\n\n**Example:**\n```atscript\n@db.table \"logs\"\n@db.mongo.collection\n@db.mongo.capped 10485760, 10000\n@db.sync.method \"drop\"\nexport interface LogEntry {\n    message: string\n    timestamp: number\n}\n```\n",
 		nodeType: ["interface"],
 		multiple: false,
@@ -100,7 +93,7 @@ const annotations = {
 		}]
 	}),
 	search: {
-		dynamic: new __atscript_core.AnnotationSpec({
+		dynamic: new _atscript_core.AnnotationSpec({
 			description: "Creates a **dynamic MongoDB Search Index** that applies to the entire collection.\n\n- **Indexes all text fields automatically** (no need to specify fields).\n- Supports **language analyzers** for text tokenization.\n- Enables **fuzzy search** (typo tolerance) if needed.\n\n**Example:**\n```atscript\n@db.mongo.search.dynamic \"lucene.english\", 1\nexport interface MongoCollection {}\n```\n",
 			nodeType: ["interface"],
 			multiple: false,
@@ -117,7 +110,7 @@ const annotations = {
 				description: "Maximum typo tolerance (`0-2`). Defaults to `0` (no fuzzy search).\n\n- `0` → Exact match required.\n- `1` → Allows small typos (e.g., `\"mongo\"` ≈ `\"mango\"`).\n- `2` → More typo tolerance (e.g., `\"mongodb\"` ≈ `\"mangodb\"`)."
 			}]
 		}),
-		static: new __atscript_core.AnnotationSpec({
+		static: new _atscript_core.AnnotationSpec({
 			description: "Defines a **MongoDB Atlas Search Index** for the collection. The props can refer to this index using `@db.mongo.search.text` annotation.\n\n- **Creates a named search index** for full-text search.\n- **Specify analyzers and fuzzy search** behavior at the index level.\n- **Fields must explicitly use `@db.mongo.search.text`** to be included in this search index.\n\n**Example:**\n```atscript\n@db.mongo.search.static \"lucene.english\", 1, \"mySearchIndex\"\nexport interface MongoCollection {}\n```\n",
 			nodeType: ["interface"],
 			multiple: true,
@@ -143,7 +136,7 @@ const annotations = {
 				}
 			]
 		}),
-		text: new __atscript_core.AnnotationSpec({
+		text: new _atscript_core.AnnotationSpec({
 			description: "Marks a field to be **included in a MongoDB Atlas Search Index** defined by `@db.mongo.search.static`.\n\n- **The field has to reference an existing search index name**.\n- If index name is not defined, a new search index with default attributes will be created.\n\n**Example:**\n```atscript\n@db.mongo.search.text \"lucene.english\", \"mySearchIndex\"\nfirstName: string\n```\n",
 			nodeType: ["prop"],
 			multiple: true,
@@ -162,17 +155,15 @@ const annotations = {
 		})
 	}
 };
-
 //#endregion
-//#region packages/db-mongo/src/plugin/primitives.ts
+//#region src/plugin/primitives.ts
 const primitives = { mongo: { extensions: { objectId: {
 	type: "string",
 	documentation: "Represents a **MongoDB ObjectId**.\n\n- Stored as a **string** but can be converted to an ObjectId at runtime.\n- Useful for handling `_id` fields and queries that require ObjectId conversion.\n- Automatically converts string `_id` values into **MongoDB ObjectId** when needed.\n\n**Example:**\n```atscript\nuserId: mongo.objectId\n```\n",
 	annotations: { "expect.pattern": { pattern: "^[a-fA-F0-9]{24}$" } }
 } } } };
-
 //#endregion
-//#region packages/db-mongo/src/plugin/index.ts
+//#region src/plugin/index.ts
 const MongoPlugin = () => ({
 	name: "mongo",
 	config() {
@@ -182,7 +173,6 @@ const MongoPlugin = () => ({
 		};
 	}
 });
-
 //#endregion
-exports.MongoPlugin = MongoPlugin
-exports.default = MongoPlugin
+exports.MongoPlugin = MongoPlugin;
+exports.default = MongoPlugin;

package/dist/plugin.d.cts

@@ -0,0 +1,6 @@
+import { TAtscriptPlugin } from "@atscript/core";
+
+//#region src/plugin/index.d.ts
+declare const MongoPlugin: () => TAtscriptPlugin;
+//#endregion
+export { MongoPlugin, MongoPlugin as default };

package/dist/plugin.d.mts

@@ -0,0 +1,6 @@
+import { TAtscriptPlugin } from "@atscript/core";
+
+//#region src/plugin/index.d.ts
+declare const MongoPlugin: () => TAtscriptPlugin;
+//#endregion
+export { MongoPlugin, MongoPlugin as default };

package/dist/plugin.mjs

@@ -1,6 +1,5 @@
 import { AnnotationSpec, isInterface, isPrimitive, isRef, isStructure } from "@atscript/core";
-
-//#region packages/db-mongo/src/plugin/annotations.ts
+//#region src/plugin/annotations.ts
 const analyzers = [
 	"lucene.standard",
 	"lucene.simple",
@@ -17,6 +16,22 @@ const analyzers = [
 	"lucene.russian",
 	"lucene.arabic"
 ];
+/**
+* MongoDB-specific annotations.
+*
+* Merged into the global config under `{ db: { mongo: ... } }` so they
+* live alongside core's `@db.table`, `@db.index.*`, etc.
+*
+* Annotations removed (now in core):
+* - `@mongo.index.plain` → use `@db.index.plain`
+* - `@mongo.index.unique` → use `@db.index.unique`
+* - `@db.mongo.index.text` → use `@db.index.fulltext` (with optional weight arg)
+* - `@db.mongo.patch.strategy` → use `@db.patch.strategy`
+* - `@db.mongo.array.uniqueItems` → use `@expect.array.uniqueItems`
+* - `@db.mongo.autoIndexes` → removed (use explicit syncIndexes() calls)
+* - `@db.mongo.search.vector` → use `@db.search.vector` (generic, in @atscript/db/plugin)
+* - `@db.mongo.search.filter` → use `@db.search.filter` (generic, in @atscript/db/plugin)
+*/
 const annotations = {
 	collection: new AnnotationSpec({
 		description: "Marks an interface as a **MongoDB collection**.\n\n- Use together with `@db.table \"name\"` which provides the collection name.\n- Automatically injects a **non-optional** `_id` field if not explicitly defined.\n- `_id` must be of type **`string`**, **`number`**, or **`mongo.objectId`**.\n\n**Example:**\n```atscript\n@db.table \"users\"\n@db.mongo.collection\nexport interface User {\n    _id: mongo.objectId\n    email: string.email\n}\n```\n",
@@ -27,8 +42,7 @@ const annotations = {
 			const errors = [];
 			if (isInterface(parent) && parent.props.has("_id") && isStructure(struc)) {
 				const _id = parent.props.get("_id");
-				const isOptional = !!_id.token("optional");
-				if (isOptional) errors.push({
+				if (!!_id.token("optional")) errors.push({
 					message: `[db.mongo] _id can't be optional in Mongo Collection`,
 					severity: 1,
 					range: _id.token("identifier").range
@@ -48,7 +62,7 @@ const annotations = {
 			}
 			return errors;
 		},
-		modify(token, args, doc) {
+		modify(token, _args, _doc) {
 			const parent = token.parentNode;
 			const struc = parent?.getDefinition();
 			if (isInterface(parent) && !parent.props.has("_id") && isStructure(struc)) struc.addVirtualProp({
@@ -137,17 +151,15 @@ const annotations = {
 		})
 	}
 };
-
 //#endregion
-//#region packages/db-mongo/src/plugin/primitives.ts
+//#region src/plugin/primitives.ts
 const primitives = { mongo: { extensions: { objectId: {
 	type: "string",
 	documentation: "Represents a **MongoDB ObjectId**.\n\n- Stored as a **string** but can be converted to an ObjectId at runtime.\n- Useful for handling `_id` fields and queries that require ObjectId conversion.\n- Automatically converts string `_id` values into **MongoDB ObjectId** when needed.\n\n**Example:**\n```atscript\nuserId: mongo.objectId\n```\n",
 	annotations: { "expect.pattern": { pattern: "^[a-fA-F0-9]{24}$" } }
 } } } };
-
 //#endregion
-//#region packages/db-mongo/src/plugin/index.ts
+//#region src/plugin/index.ts
 const MongoPlugin = () => ({
 	name: "mongo",
 	config() {
@@ -157,6 +169,5 @@ const MongoPlugin = () => ({
 		};
 	}
 });
-
 //#endregion
-export { MongoPlugin, MongoPlugin as default };
+export { MongoPlugin, MongoPlugin as default };

package/package.json

@@ -1,92 +1,73 @@
 {
   "name": "@atscript/db-mongo",
-  "version": "0.1.38",
+  "version": "0.1.40",
   "description": "Mongodb plugin for atscript.",
   "keywords": [
     "atscript",
     "mongodb",
     "plugin"
   ],
-  "homepage": "https://github.com/moostjs/atscript/tree/main/packages/db-mongo#readme",
+  "homepage": "https://github.com/moostjs/atscript-db/tree/main/packages/db-mongo#readme",
   "bugs": {
-    "url": "https://github.com/moostjs/atscript/issues"
+    "url": "https://github.com/moostjs/atscript-db/issues"
   },
   "license": "MIT",
   "author": "Artem Maltsev",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/moostjs/atscript.git",
+    "url": "git+https://github.com/moostjs/atscript-db.git",
     "directory": "packages/db-mongo"
   },
+  "bin": {
+    "atscript-db-mongo-skill": "./scripts/setup-skills.js"
+  },
   "files": [
     "dist",
     "skills",
     "scripts/setup-skills.js"
   ],
   "type": "module",
-  "bin": {
-    "atscript-db-mongo-skill": "./scripts/setup-skills.js"
-  },
   "main": "dist/index.mjs",
-  "types": "dist/index.d.ts",
-  "typesVersions": {
-    "*": {
-      "plugin": [
-        "dist/plugin.d.ts"
-      ],
-      "agg": [
-        "dist/agg.d.ts"
-      ],
-      "": [
-        "dist/index.d.ts"
-      ]
-    }
-  },
+  "types": "dist/index.d.mts",
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
+      "types": "./dist/index.d.mts",
       "import": "./dist/index.mjs",
       "require": "./dist/index.cjs"
     },
     "./plugin": {
-      "types": "./dist/plugin.d.ts",
+      "types": "./dist/plugin.d.mts",
       "import": "./dist/plugin.mjs",
       "require": "./dist/plugin.cjs"
     },
     "./agg": {
-      "types": "./dist/agg.d.ts",
+      "types": "./dist/agg.d.mts",
       "import": "./dist/agg.mjs",
       "require": "./dist/agg.cjs"
     },
     "./package.json": "./package.json"
   },
+  "publishConfig": {
+    "access": "public"
+  },
   "devDependencies": {
-    "vitest": "3.2.4"
+    "@atscript/core": "^0.1.39",
+    "@atscript/typescript": "^0.1.39",
+    "mongodb": "^6.17.0",
+    "unplugin-atscript": "^0.1.39"
   },
   "peerDependencies": {
+    "@atscript/core": "^0.1.39",
+    "@atscript/typescript": "^0.1.39",
     "mongodb": "^6.17.0",
-    "@atscript/core": "^0.1.38",
-    "@atscript/db": "^0.1.38",
-    "@atscript/typescript": "^0.1.38"
+    "@atscript/db": "^0.1.40"
   },
-  "build": [
-    {},
-    {
-      "entries": [
-        "src/plugin.ts"
-      ],
-      "dts": true
-    },
-    {
-      "entries": [
-        "src/agg.ts"
-      ],
-      "dts": true
-    }
-  ],
   "scripts": {
-    "pub": "pnpm publish --access public",
-    "test": "vitest",
+    "postinstall": "asc -f dts",
+    "build": "vp pack",
+    "dev": "vp pack --watch",
+    "test": "vp test",
+    "check": "vp check",
     "setup-skills": "node ./scripts/setup-skills.js"
   }
 }

package/scripts/setup-skills.js

@@ -1,78 +1,88 @@
 #!/usr/bin/env node
 /* prettier-ignore */
 import fs from 'fs'
-import path from 'path'
-import os from 'os'
-import { fileURLToPath } from 'url'
+import path from "path";
+import os from "os";
+import { fileURLToPath } from "url";
 
-const __dirname = path.dirname(fileURLToPath(import.meta.url))
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
 
-const SKILL_NAME = 'atscript-db-mongo'
-const SKILL_SRC = path.join(__dirname, '..', 'skills', SKILL_NAME)
+const SKILL_NAME = "atscript-db-mongo";
+const SKILL_SRC = path.join(__dirname, "..", "skills", SKILL_NAME);
 
 if (!fs.existsSync(SKILL_SRC)) {
-  console.error(`No skills found at ${SKILL_SRC}`)
-  console.error('Add your SKILL.md files to the skills/' + SKILL_NAME + '/ directory first.')
-  process.exit(1)
+  console.error(`No skills found at ${SKILL_SRC}`);
+  console.error("Add your SKILL.md files to the skills/" + SKILL_NAME + "/ directory first.");
+  process.exit(1);
 }
 
 const AGENTS = {
-  'Claude Code': { dir: '.claude/skills',   global: path.join(os.homedir(), '.claude', 'skills') },
-  'Cursor':      { dir: '.cursor/skills',   global: path.join(os.homedir(), '.cursor', 'skills') },
-  'Windsurf':    { dir: '.windsurf/skills', global: path.join(os.homedir(), '.windsurf', 'skills') },
-  'Codex':       { dir: '.codex/skills',    global: path.join(os.homedir(), '.codex', 'skills') },
-  'OpenCode':    { dir: '.opencode/skills', global: path.join(os.homedir(), '.opencode', 'skills') },
-}
+  "Claude Code": { dir: ".claude/skills", global: path.join(os.homedir(), ".claude", "skills") },
+  Cursor: { dir: ".cursor/skills", global: path.join(os.homedir(), ".cursor", "skills") },
+  Windsurf: { dir: ".windsurf/skills", global: path.join(os.homedir(), ".windsurf", "skills") },
+  Codex: { dir: ".codex/skills", global: path.join(os.homedir(), ".codex", "skills") },
+  OpenCode: { dir: ".opencode/skills", global: path.join(os.homedir(), ".opencode", "skills") },
+};
 
-const args = process.argv.slice(2)
-const isGlobal = args.includes('--global') || args.includes('-g')
-const isPostinstall = args.includes('--postinstall')
-let installed = 0, skipped = 0
-const installedDirs = []
+const args = new Set(process.argv.slice(2));
+const isGlobal = args.has("--global") || args.has("-g");
+const isPostinstall = args.has("--postinstall");
+let installed = 0,
+  skipped = 0;
+const installedDirs = [];
 
 for (const [agentName, cfg] of Object.entries(AGENTS)) {
-  const targetBase = isGlobal ? cfg.global : path.join(process.cwd(), cfg.dir)
-  const agentRootDir = path.dirname(cfg.global) // Check if the agent has ever been installed globally
+  const targetBase = isGlobal ? cfg.global : path.join(process.cwd(), cfg.dir);
+  const agentRootDir = path.dirname(cfg.global); // Check if the agent has ever been installed globally
 
   // In postinstall mode: silently skip agents that aren't set up globally
   if (isPostinstall || isGlobal) {
-    if (!fs.existsSync(agentRootDir)) { skipped++; continue }
+    if (!fs.existsSync(agentRootDir)) {
+      skipped++;
+      continue;
+    }
   }
 
-  const dest = path.join(targetBase, SKILL_NAME)
+  const dest = path.join(targetBase, SKILL_NAME);
   try {
-    fs.mkdirSync(dest, { recursive: true })
-    fs.cpSync(SKILL_SRC, dest, { recursive: true })
-    console.log(`✅  ${agentName}: installed to ${dest}`)
-    installed++
-    if (!isGlobal) installedDirs.push(cfg.dir + '/' + SKILL_NAME)
+    fs.mkdirSync(dest, { recursive: true });
+    fs.cpSync(SKILL_SRC, dest, { recursive: true });
+    console.log(`✅  ${agentName}: installed to ${dest}`);
+    installed++;
+    if (!isGlobal) installedDirs.push(cfg.dir + "/" + SKILL_NAME);
   } catch (err) {
-    console.warn(`⚠️   ${agentName}: failed — ${err.message}`)
+    console.warn(`⚠️   ${agentName}: failed — ${err.message}`);
   }
 }
 
 // Add locally-installed skill dirs to .gitignore
 if (!isGlobal && installedDirs.length > 0) {
-  const gitignorePath = path.join(process.cwd(), '.gitignore')
-  let gitignoreContent = ''
-  try { gitignoreContent = fs.readFileSync(gitignorePath, 'utf8') } catch {}
-  const linesToAdd = installedDirs.filter(d => !gitignoreContent.includes(d))
+  const gitignorePath = path.join(process.cwd(), ".gitignore");
+  let gitignoreContent = "";
+  try {
+    gitignoreContent = fs.readFileSync(gitignorePath, "utf8");
+  } catch {}
+  const linesToAdd = installedDirs.filter((d) => !gitignoreContent.includes(d));
   if (linesToAdd.length > 0) {
-    const hasHeader = gitignoreContent.includes('# AI agent skills')
-    const block = (gitignoreContent && !gitignoreContent.endsWith('\n') ? '\n' : '')
-      + (hasHeader ? '' : '\n# AI agent skills (auto-generated by setup-skills)\n')
-      + linesToAdd.join('\n') + '\n'
-    fs.appendFileSync(gitignorePath, block)
-    console.log(`📝  Added ${linesToAdd.length} entries to .gitignore`)
+    const hasHeader = gitignoreContent.includes("# AI agent skills");
+    const block =
+      (gitignoreContent && !gitignoreContent.endsWith("\n") ? "\n" : "") +
+      (hasHeader ? "" : "\n# AI agent skills (auto-generated by setup-skills)\n") +
+      linesToAdd.join("\n") +
+      "\n";
+    fs.appendFileSync(gitignorePath, block);
+    console.log(`📝  Added ${linesToAdd.length} entries to .gitignore`);
   }
 }
 
 if (installed === 0 && isPostinstall) {
   // Silence is fine — no agents present, nothing to do
 } else if (installed === 0 && skipped === Object.keys(AGENTS).length) {
-  console.log('No agent directories detected. Try --global or run without it for project-local install.')
+  console.log(
+    "No agent directories detected. Try --global or run without it for project-local install.",
+  );
 } else if (installed === 0) {
-  console.log('Nothing installed. Run without --global to install project-locally.')
+  console.log("Nothing installed. Run without --global to install project-locally.");
 } else {
-  console.log(`\n✨  Done! Restart your AI agent to pick up the "${SKILL_NAME}" skill.`)
+  console.log(`\n✨  Done! Restart your AI agent to pick up the "${SKILL_NAME}" skill.`);
 }

package/skills/atscript-db-mongo/SKILL.md

@@ -11,12 +11,12 @@ MongoDB metadata extension for Atscript. Defines annotations for collections, in
 
 Read the domain file that matches the task. Do not load all files — only what you need.
 
-| Domain | File | Load when... |
-|--------|------|-------------|
-| Core setup & plugin config | [core.md](core.md) | Installing the plugin, configuring atscript.config, understanding the plugin architecture |
-| Annotations reference | [annotations.md](annotations.md) | Writing .as files with database and MongoDB annotations, understanding annotation arguments |
-| Collections & CRUD | [collections.md](collections.md) | Using AsCollection/AsMongo for insert, replace, update, query, or sync indexes |
-| Patch strategies | [patches.md](patches.md) | Working with @db.mongo.patch.strategy, array patch operations ($insert/$upsert/$update/$remove/$replace) |
+| Domain                     | File                             | Load when...                                                                                             |
+| -------------------------- | -------------------------------- | -------------------------------------------------------------------------------------------------------- |
+| Core setup & plugin config | [core.md](core.md)               | Installing the plugin, configuring atscript.config, understanding the plugin architecture                |
+| Annotations reference      | [annotations.md](annotations.md) | Writing .as files with database and MongoDB annotations, understanding annotation arguments              |
+| Collections & CRUD         | [collections.md](collections.md) | Using AsCollection/AsMongo for insert, replace, update, query, or sync indexes                           |
+| Patch strategies           | [patches.md](patches.md)         | Working with @db.mongo.patch.strategy, array patch operations ($insert/$upsert/$update/$remove/$replace) |
 
 ## Quick reference
 
@@ -36,10 +36,10 @@ export interface User {
 ```
 
 ```typescript
-import { AsMongo } from '@atscript/db-mongo'
-import { User } from './user.as'
+import { AsMongo } from "@atscript/db-mongo";
+import { User } from "./user.as";
 
-const asMongo = new AsMongo('mongodb://localhost:27017/mydb')
-const users = asMongo.getCollection(User)
-await users.insert({ email: 'a@b.com', name: 'Alice', isActive: true })
+const asMongo = new AsMongo("mongodb://localhost:27017/mydb");
+const users = asMongo.getCollection(User);
+await users.insert({ email: "a@b.com", name: "Alice", isActive: true });
 ```