grafeo-ogm 1.9.1 → 1.10.0

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## 1.10.0 (2026-06-13) — 🚀 `grafeo init`
+
+> **The fastest way into grafeo.** `grafeo init` sets a project up in one step — and for the *existing* grafeo user adopting the CLI, it auto-wires itself: it finds your schema and your generated types and writes a ready `grafeo.config.ts` pointing at them. Greenfield? It scaffolds a starter schema (the Neo4j movie graph) and config. Either way you get an npm `generate` script. Interactive by default, fully non-interactive (`--yes`) for CI, and non-destructive throughout.
+
+### ✨ `grafeo init` — scaffold, or auto-detect an existing project
+
+- **Autodetection.** In a project that already uses grafeo, `init` locates the SDL schema (by its `@node`/`@relationship` directives — a bare GraphQL file is *not* mistaken for it) and a previously generated types file (by the generator's header line), and pre-fills `grafeo.config.ts` with those paths. Multiple schema candidates → it asks which.
+- **Greenfield scaffold.** With nothing to detect (or `--fresh`), it writes a starter `schema.graphql` — the classic Neo4j movie example (`Movie`/`Person`, `ACTED_IN`/`DIRECTED`) — and a config.
+- **npm script.** Adds `"generate": "grafeo generate"` to `package.json` (an existing `generate` script is preserved, never clobbered).
+- **Optional seed.** `--seed` scaffolds an upsert-based `seed.ts` stub.
+- **Non-destructive.** Never overwrites an existing config/schema/seed without `--force` (or an interactive confirmation); re-running `init` is safe.
+- **No secrets, no new deps.** Connection settings reference `NEO4J_*` env vars (never prompted); prompts use `node:readline/promises`. The runtime footprint is unchanged.
+
+Flags: `--schema`, `--out`, `--seed`, `--fresh`, `--yes`, `--force`. The README quickstart now leads with `npx grafeo init`.
+
+### Tests
+
+New `detect` + `init` coverage (14 cases): autodetection (single/multiple/none, directive-gated, marker-anchored), greenfield scaffold, `--fresh`, non-destructive config/seed writes, npm-script add/preserve, non-interactive `--yes`, no-secret-prompt, and a regression test that a quote-bearing path is safely escaped into the config (no injection). Full suite green; lint, format, type-check clean.
+
+---
+
 ## 1.9.1 (2026-06-13) — 🩹 `grafeo generate` formatting DX
 
 > **A first-run papercut from the 1.9.0 CLI.** Prettier is a *dev* dependency (kept out of the runtime footprint on purpose), so a consumer who runs `grafeo generate` without prettier installed got a terse `Prettier formatting failed; output written without formatting.` — accurate, but unhelpful. The output was always valid TypeScript; only the message was poor. `1.9.1` makes that path friendly and honest.

package/README.md

@@ -128,6 +128,8 @@ yarn add grafeo-ogm neo4j-driver graphql
 
 ### 1. Define your schema
 
+> **Fastest start:** `npx grafeo init` scaffolds a starter `schema.graphql` + `grafeo.config.ts` for you — and auto-detects an existing setup. See [CLI → `grafeo init`](#cli). Prefer to do it by hand? Define a `schema.graphql`:
+
 ```graphql
 # schema.graphql
 type Book @node
@@ -228,6 +230,7 @@ grafeo-ogm ships a `grafeo` binary (installed with the package — no global ins
 
 | Command | Purpose |
 |---|---|
+| `grafeo init` | Scaffold a project — or auto-detect an existing one — wiring config, schema, and an npm script |
 | `grafeo generate` | Generate TypeScript types from your SDL — one-shot, `--watch`, or `--verify` CI gate |
 | `grafeo db push` | Diff SDL-declared constraints/indexes against the live database and apply them |
 | `grafeo db seed` | Run your seed script with a constructed, connected OGM |
@@ -262,6 +265,26 @@ export default defineConfig({
 
 > **Config and seed files run as trusted code.** `grafeo.config.ts` and your seed script are executed in-process (via [jiti](https://github.com/unjs/jiti)) with your database credentials — the same trust model as Prisma/Drizzle. Only run `grafeo` in a directory whose config and seed files you control.
 
+### `grafeo init`
+
+Sets up a project in one step. In an **existing** grafeo project it auto-detects your schema (by its `@node`/`@relationship` directives) and a previously generated types file (by the generator's header marker), and writes a `grafeo.config.ts` wired to them. With **nothing to detect** (or `--fresh`), it scaffolds a starter `schema.graphql` — the Neo4j movie example — plus the config. Either way it adds a `"generate": "grafeo generate"` npm script.
+
+```bash
+npx grafeo init          # interactive: detect or scaffold, confirm the paths
+npx grafeo init --yes    # non-interactive: accept detected values / defaults (CI)
+```
+
+| Flag | Description |
+|---|---|
+| `--schema <path>` | schema path (skip detection/prompt) |
+| `--out <path>` | generated-types output path |
+| `--seed` | also scaffold a `seed.ts` upsert stub |
+| `--fresh` | ignore a detected setup and scaffold a new project |
+| `--yes` | non-interactive: detected values / defaults, no prompts |
+| `--force` | overwrite an existing `grafeo.config.ts` / `seed.ts` |
+
+`init` is **non-destructive** — it never overwrites your config, schema, or seed without `--force` (or an interactive confirmation), and connection settings reference `NEO4J_*` env vars (it never prompts for a password).
+
 ### `grafeo generate`
 
 Compiles your SDL to TypeScript types (wraps `generateTypes()` — see [Type Generation](#type-generation) for the programmatic API and the full option list).

package/dist/cjs/cli/commands/init.d.ts

@@ -0,0 +1,3 @@
+import type { CliIO } from '../types';
+export declare function runInit(argv: string[], io: CliIO): Promise<number>;
+//# sourceMappingURL=init.d.ts.map

package/dist/cjs/cli/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AA6JtC,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CA8GxE"}

package/dist/cjs/cli/commands/init.js

@@ -0,0 +1,273 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runInit = runInit;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const node_util_1 = require("node:util");
+const detect_1 = require("../detect");
+const errors_1 = require("../errors");
+function parseInitFlags(argv) {
+    try {
+        const { values } = (0, node_util_1.parseArgs)({
+            args: argv,
+            options: {
+                schema: { type: 'string' },
+                out: { type: 'string' },
+                seed: { type: 'boolean' },
+                fresh: { type: 'boolean' },
+                yes: { type: 'boolean' },
+                force: { type: 'boolean' },
+                debug: { type: 'boolean' },
+            },
+            strict: true,
+            allowPositionals: false,
+        });
+        return values;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new errors_1.CliError(`init: ${message}`);
+    }
+}
+// The classic Neo4j movie graph, expressed in grafeo SDL — recognizable to
+// Neo4j users and it exercises relationship arity/direction both ways.
+const MOVIE_SCHEMA = `# grafeo schema — the Neo4j movie example.
+# Run \`npx grafeo generate\` (or \`npm run generate\`) to emit typed models.
+
+type Movie @node {
+  title: String! @unique
+  released: Int
+  tagline: String
+  actors: [Person!]! @relationship(type: "ACTED_IN", direction: IN)
+  directors: [Person!]! @relationship(type: "DIRECTED", direction: IN)
+}
+
+type Person @node {
+  name: String! @id @unique
+  born: Int
+  actedIn: [Movie!]! @relationship(type: "ACTED_IN", direction: OUT)
+  directed: [Movie!]! @relationship(type: "DIRECTED", direction: OUT)
+}
+`;
+const SEED_STUB = `import type { OGM } from 'grafeo-ogm';
+
+// Prefer upsert over create so repeated seeds converge instead of duplicating.
+export default async function seed(ogm: OGM) {
+  const Movie = ogm.model('Movie');
+  await Movie.upsert({
+    where: { title: 'The Matrix' },
+    create: { title: 'The Matrix', released: 1999 },
+    update: { released: 1999 },
+  });
+}
+`;
+function renderConfig(schemaPath, outPath, includeSeed) {
+    // JSON.stringify, NOT string-templating: the paths come from --schema/--out
+    // /prompts and this file is later EXECUTED by jiti, so a raw `'${path}'`
+    // would let a quote in the path break out and inject code (and an innocent
+    // apostrophe would produce a broken config). JSON.stringify emits a fully
+    // escaped, valid string literal.
+    const seedLine = includeSeed ? `\n  seed: './seed.ts',` : '';
+    return `import { defineConfig } from 'grafeo-ogm';
+
+export default defineConfig({
+  schema: ${JSON.stringify(rel(schemaPath))},
+  out: ${JSON.stringify(rel(outPath))},
+  database: {
+    uri: process.env.NEO4J_URI,
+    username: process.env.NEO4J_USERNAME,
+    // Never commit a password — set NEO4J_PASSWORD in your environment.
+    password: process.env.NEO4J_PASSWORD,
+  },${seedLine}
+});
+`;
+}
+/** Normalize a path to a `./`-prefixed relative form for the config file. */
+function rel(p) {
+    const normalized = p.replace(/\\/g, '/');
+    return normalized.startsWith('.') ? normalized : `./${normalized}`;
+}
+function writeFileEnsuringDir(absPath, content) {
+    fs.mkdirSync(path.dirname(absPath), { recursive: true });
+    fs.writeFileSync(absPath, content, 'utf-8');
+}
+/**
+ * Add `"generate": "grafeo generate"` to package.json scripts. Non-destructive:
+ * an existing `generate` script is preserved. Returns what happened so the
+ * summary can report it.
+ */
+function wireGenerateScript(cwd) {
+    const pkgPath = path.join(cwd, 'package.json');
+    if (!fs.existsSync(pkgPath))
+        return 'none';
+    // Strip a UTF-8 BOM (common on Windows-edited files) so parse doesn't fail.
+    const raw = fs.readFileSync(pkgPath, 'utf-8').replace(/^\uFEFF/, '');
+    let pkg;
+    try {
+        pkg = JSON.parse(raw);
+    }
+    catch {
+        return 'none';
+    }
+    // Only treat `scripts` as a map when it's actually an object — otherwise a
+    // malformed value would be spread into garbage.
+    const scripts = typeof pkg.scripts === 'object' && pkg.scripts !== null
+        ? pkg.scripts
+        : {};
+    if (scripts.generate)
+        return 'kept';
+    pkg.scripts = {
+        ...scripts,
+        generate: 'grafeo generate',
+    };
+    const indent = /^\t/m.test(raw) ? '\t' : 2;
+    fs.writeFileSync(pkgPath, `${JSON.stringify(pkg, null, indent)}\n`, 'utf-8');
+    return 'added';
+}
+/** Pick the schema among detected candidates (prompt only when ambiguous). */
+async function chooseSchema(candidates, io, canPrompt) {
+    if (candidates.length === 1)
+        return candidates[0];
+    if (canPrompt && io.prompt) {
+        io.out('Multiple grafeo schemas found:');
+        candidates.forEach((c, i) => io.out(`  ${i + 1}) ${c}`));
+        const answer = await io.prompt('Which is your schema? (number)', '1');
+        const idx = Number.parseInt(answer, 10) - 1;
+        if (Number.isInteger(idx) && idx >= 0 && idx < candidates.length)
+            return candidates[idx];
+    }
+    return candidates[0];
+}
+async function runInit(argv, io) {
+    const flags = parseInitFlags(argv);
+    const yes = flags.yes === true;
+    const force = flags.force === true;
+    const canPrompt = io.interactive === true && !yes;
+    const detection = (0, detect_1.detectProject)(io.cwd, io.env);
+    const hasDetected = detection.schemaCandidates.length > 0 || detection.generatedTypes != null;
+    // Detected setup vs fresh start.
+    let fresh = flags.fresh === true;
+    if (hasDetected && !fresh && canPrompt && io.confirm) {
+        const detail = [
+            detection.schemaCandidates[0]
+                ? `schema: ${detection.schemaCandidates[0]}`
+                : null,
+            detection.generatedTypes ? `types: ${detection.generatedTypes}` : null,
+        ]
+            .filter(Boolean)
+            .join(', ');
+        const useDetected = await io.confirm(`Existing grafeo setup detected (${detail}) — wire the config to it?`);
+        fresh = !useDetected;
+    }
+    const useDetected = hasDetected && !fresh;
+    // Resolve schema path: flag > detected > prompt/default.
+    let schemaPath = flags.schema;
+    if (!schemaPath && useDetected)
+        schemaPath = await chooseSchema(detection.schemaCandidates, io, canPrompt);
+    if (!schemaPath)
+        schemaPath =
+            canPrompt && io.prompt
+                ? await io.prompt('Schema path?', 'schema.graphql')
+                : 'schema.graphql';
+    // Resolve output path: flag > detected > prompt/default.
+    let outPath = flags.out;
+    if (!outPath && useDetected && detection.generatedTypes)
+        outPath = detection.generatedTypes;
+    if (!outPath)
+        outPath =
+            canPrompt && io.prompt
+                ? await io.prompt('Generated types output path?', 'grafeo.generated.ts')
+                : 'grafeo.generated.ts';
+    const created = [];
+    const kept = [];
+    // Scaffold the schema only when it doesn't already exist.
+    const schemaAbs = path.resolve(io.cwd, schemaPath);
+    if (fs.existsSync(schemaAbs))
+        kept.push(schemaPath);
+    else {
+        writeFileEnsuringDir(schemaAbs, MOVIE_SCHEMA);
+        created.push(schemaPath);
+    }
+    const wantSeed = flags.seed === true;
+    // Write grafeo.config.ts — never clobber an existing one without consent.
+    const configAbs = path.resolve(io.cwd, 'grafeo.config.ts');
+    const config = renderConfig(schemaPath, outPath, wantSeed);
+    if (fs.existsSync(configAbs) && !force) {
+        const overwrite = canPrompt && io.confirm
+            ? await io.confirm('grafeo.config.ts exists — overwrite it?')
+            : false;
+        if (!overwrite) {
+            if (!canPrompt)
+                throw new errors_1.CliError('grafeo.config.ts already exists. Re-run with --force to overwrite.');
+            kept.push('grafeo.config.ts');
+        }
+        else {
+            fs.writeFileSync(configAbs, config, 'utf-8');
+            created.push('grafeo.config.ts');
+        }
+    }
+    else {
+        fs.writeFileSync(configAbs, config, 'utf-8');
+        created.push('grafeo.config.ts');
+    }
+    // Optional seed stub.
+    if (wantSeed) {
+        const seedAbs = path.resolve(io.cwd, 'seed.ts');
+        if (fs.existsSync(seedAbs) && !force)
+            kept.push('seed.ts');
+        else {
+            fs.writeFileSync(seedAbs, SEED_STUB, 'utf-8');
+            created.push('seed.ts');
+        }
+    }
+    // Wire an npm script (non-destructive).
+    const pkgNote = wireGenerateScript(io.cwd);
+    // Summary + next step.
+    for (const f of created)
+        io.out(`✓ created ${f}`);
+    for (const f of kept)
+        io.out(`• kept ${f} (already present)`);
+    if (pkgNote === 'added')
+        io.out('✓ added "generate" script to package.json');
+    else if (pkgNote === 'kept')
+        io.out('• kept existing "generate" script in package.json');
+    io.out('');
+    io.out(pkgNote === 'added'
+        ? 'Next: `npm run generate` (or `npx grafeo generate`)'
+        : 'Next: `npx grafeo generate`');
+    return 0;
+}
+//# sourceMappingURL=init.js.map

package/dist/cjs/cli/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../../src/cli/commands/init.ts"],"names":[],"mappings":"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"}

package/dist/cjs/cli/detect.d.ts

@@ -0,0 +1,18 @@
+/** What `grafeo init` found (or didn't) in an existing project. */
+export interface DetectionResult {
+    /** `.graphql`/`.gql` files that carry grafeo directives (relative to cwd). */
+    schemaCandidates: string[];
+    /** A previously generated types file, identified by the header marker. */
+    generatedTypes?: string;
+    /** An existing grafeo.config.{ts,js,json}, if present. */
+    existingConfig?: string;
+    /** True if a NEO4J_* env var or a .env mentioning one is present. */
+    hasNeo4jEnv: boolean;
+}
+/**
+ * Scan `cwd` for an existing grafeo setup so `init` can wire itself up. Pure
+ * filesystem reads — shallow, with generated/VCS dirs skipped — so it stays
+ * fast and never walks `node_modules`.
+ */
+export declare function detectProject(cwd: string, env: NodeJS.ProcessEnv): DetectionResult;
+//# sourceMappingURL=detect.d.ts.map

package/dist/cjs/cli/detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../../../src/cli/detect.ts"],"names":[],"mappings":"AAGA,mEAAmE;AACnE,MAAM,WAAW,eAAe;IAC9B,8EAA8E;IAC9E,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,0EAA0E;IAC1E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0DAA0D;IAC1D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qEAAqE;IACrE,WAAW,EAAE,OAAO,CAAC;CACtB;AA2DD;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,CAAC,UAAU,GACrB,eAAe,CAyCjB"}

package/dist/cjs/cli/detect.js

@@ -0,0 +1,142 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectProject = detectProject;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+// Directories never worth scanning — large, generated, or VCS internals.
+const SKIP_DIRS = new Set([
+    'node_modules',
+    'dist',
+    'build',
+    '.git',
+    '.next',
+    'coverage',
+    '.turbo',
+]);
+const MAX_DEPTH = 3;
+const CONFIG_NAMES = [
+    'grafeo.config.ts',
+    'grafeo.config.js',
+    'grafeo.config.json',
+];
+// Generated files open with a `// Generated by <pkg> generateTypes()` header
+// line (utility-types emitter). Anchor to the line start so a doc comment that
+// merely mentions the phrase isn't misdetected, and allow any package name so
+// files generated under an npm alias still match.
+const GENERATED_MARKER = /^\/\/\s*Generated by .+ generateTypes\(\)/m;
+// A schema is grafeo's only if it actually uses grafeo's directives — a bare
+// GraphQL file in the tree must not be mistaken for the OGM schema.
+const GRAFEO_DIRECTIVE = /@(node|relationship|relationshipProperties)\b/;
+function walk(root, depth, out) {
+    let entries;
+    try {
+        entries = fs.readdirSync(root, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        if (entry.name.startsWith('.') && entry.name !== '.env')
+            continue;
+        const full = path.join(root, entry.name);
+        if (entry.isDirectory()) {
+            if (depth >= MAX_DEPTH || SKIP_DIRS.has(entry.name))
+                continue;
+            walk(full, depth + 1, out);
+        }
+        else if (entry.isFile())
+            out.push(full);
+    }
+}
+function readHead(file, bytes = 4096) {
+    try {
+        const fd = fs.openSync(file, 'r');
+        try {
+            const buf = Buffer.alloc(bytes);
+            const read = fs.readSync(fd, buf, 0, bytes, 0);
+            return buf.toString('utf-8', 0, read);
+        }
+        finally {
+            fs.closeSync(fd);
+        }
+    }
+    catch {
+        return '';
+    }
+}
+/**
+ * Scan `cwd` for an existing grafeo setup so `init` can wire itself up. Pure
+ * filesystem reads — shallow, with generated/VCS dirs skipped — so it stays
+ * fast and never walks `node_modules`.
+ */
+function detectProject(cwd, env) {
+    const files = [];
+    walk(cwd, 0, files);
+    const schemaCandidates = [];
+    let generatedTypes;
+    for (const file of files) {
+        const ext = path.extname(file);
+        const rel = path.relative(cwd, file);
+        if (ext === '.graphql' || ext === '.gql') {
+            // Only count it as the schema if it actually uses grafeo directives.
+            // Head-read (guarded + capped) like the .ts sniff — directives sit at the
+            // top of real schemas, and this avoids reading (or throwing on) a huge or
+            // unreadable file.
+            if (GRAFEO_DIRECTIVE.test(readHead(file, 65536)))
+                schemaCandidates.push(rel);
+        }
+        else if (ext === '.ts' && !generatedTypes)
+            if (GENERATED_MARKER.test(readHead(file)))
+                generatedTypes = rel;
+    }
+    // Prefer a file literally named schema.graphql when several candidates exist.
+    schemaCandidates.sort((a, b) => {
+        const an = path.basename(a) === 'schema.graphql' ? 0 : 1;
+        const bn = path.basename(b) === 'schema.graphql' ? 0 : 1;
+        return an - bn || a.localeCompare(b);
+    });
+    let existingConfig;
+    for (const name of CONFIG_NAMES)
+        if (fs.existsSync(path.join(cwd, name))) {
+            existingConfig = name;
+            break;
+        }
+    const hasNeo4jEnv = Object.keys(env).some((k) => k.startsWith('NEO4J_')) ||
+        (fs.existsSync(path.join(cwd, '.env')) &&
+            /^\s*NEO4J_/m.test(readHead(path.join(cwd, '.env'))));
+    return { schemaCandidates, generatedTypes, existingConfig, hasNeo4jEnv };
+}
+//# sourceMappingURL=detect.js.map

package/dist/cjs/cli/detect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.js","sourceRoot":"","sources":["../../../src/cli/detect.ts"],"names":[],"mappings":"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"}

package/dist/cjs/cli/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/index.ts"],"names":[],"mappings":";AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAoDrC;;;GAGG;AACH,wBAAsB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CA+ErE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/index.ts"],"names":[],"mappings":";AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAoErC;;;GAGG;AACH,wBAAsB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAoFrE"}

package/dist/cjs/cli/index.js

@@ -40,6 +40,7 @@ const errors_1 = require("./errors");
 const HELP = `grafeo — CLI for grafeo-ogm
 
 Usage:
+  grafeo init     [--schema <path>] [--out <path>] [--seed] [--fresh] [--yes] [--force]
   grafeo generate [--schema <path>] [--out <path>] [--watch] [--verify] [--poll <ms>]
   grafeo db push  [--schema <path>] [--dry-run] [--force-drop] [--yes]
                   [--uri <bolt-uri>] [--username <user>] [--database <name>]
@@ -56,6 +57,21 @@ Configuration:
   NEO4J_DATABASE. The password is never accepted as a flag.`;
 /** Focused per-command help, shown for \`grafeo <command> --help\`. */
 const COMMAND_HELP = {
+    init: `grafeo init — scaffold (or auto-detect) a grafeo project
+
+Usage:
+  grafeo init [--schema <path>] [--out <path>] [--seed] [--fresh] [--yes] [--force]
+
+  Detects an existing grafeo schema + generated types and wires grafeo.config.ts
+  to them. With nothing to detect (or --fresh), scaffolds a starter schema
+  (the Neo4j movie example) and config.
+
+  --schema <path>  schema path (skip detection/prompt)
+  --out <path>     generated-types output path
+  --seed           also scaffold a seed.ts stub
+  --fresh          ignore any detected setup and scaffold a new project
+  --yes            non-interactive: accept detected values / defaults, no prompts
+  --force          overwrite an existing grafeo.config.ts / seed.ts`,
     generate: `grafeo generate — generate TypeScript types from your SDL
 
 Usage:
@@ -132,6 +148,10 @@ async function main(argv, io) {
             return 0;
         }
         // Commands load lazily so `generate` never pays for neo4j-driver.
+        if (command === 'init') {
+            const { runInit } = await Promise.resolve().then(() => __importStar(require('./commands/init')));
+            return await runInit(commandArgs, io);
+        }
         if (command === 'generate') {
             const { runGenerate } = await Promise.resolve().then(() => __importStar(require('./commands/generate')));
             return await runGenerate(commandArgs, io);
@@ -179,6 +199,21 @@ if (typeof require !== 'undefined' && require.main === module) {
                 rl.close();
             }
         },
+        // Free-text prompt for `grafeo init` (path entry, candidate selection).
+        prompt: async (question, defaultValue) => {
+            const rl = readline.createInterface({
+                input: process.stdin,
+                output: process.stdout,
+            });
+            try {
+                const suffix = defaultValue ? ` (${defaultValue})` : '';
+                const answer = (await rl.question(`${question}${suffix} `)).trim();
+                return answer || defaultValue || '';
+            }
+            finally {
+                rl.close();
+            }
+        },
     };
     void main(process.argv.slice(2), io).then((code) => {
         process.exitCode = code;

package/dist/cjs/cli/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/index.ts"],"names":[],"mappings":"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"}

package/dist/cjs/cli/types.d.ts

@@ -61,6 +61,12 @@ export interface CliIO {
     interactive?: boolean;
     /** Prompt for yes/no confirmation (only called when interactive). */
     confirm?(question: string): Promise<boolean>;
+    /**
+     * Prompt for a free-text answer (only called when interactive). Returns the
+     * trimmed input, or `defaultValue` when the user enters nothing. Used by
+     * `grafeo init` for path entry and detected-vs-fresh selection.
+     */
+    prompt?(question: string, defaultValue?: string): Promise<string>;
     /**
      * Cooperative shutdown for long-running commands (`generate --watch`).
      * The bin runs without one (Ctrl-C kills the process); tests abort it

package/dist/cjs/cli/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/cli/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAEvE,kFAAkF;AAClF,MAAM,WAAW,oBAAoB;IACnC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,QAAQ,GAAG,WAAW,CAAC;CACrC;AAED,qDAAqD;AACrD,MAAM,WAAW,YAAY;IAC3B,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IAC/B,kEAAkE;IAClE,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,qEAAqE;IACrE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;CACzD;AAED,+DAA+D;AAC/D,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CAE/D;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,KAAK;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,oEAAoE;IACpE,aAAa,CAAC,CAAC,UAAU,EAAE,kBAAkB,GAAG,MAAM,CAAC;IACvD,2DAA2D;IAC3D,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,qEAAqE;IACrE,OAAO,CAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7C;;;;OAIG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/cli/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAEvE,kFAAkF;AAClF,MAAM,WAAW,oBAAoB;IACnC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,QAAQ,GAAG,WAAW,CAAC;CACrC;AAED,qDAAqD;AACrD,MAAM,WAAW,YAAY;IAC3B,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IAC/B,kEAAkE;IAClE,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,qEAAqE;IACrE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;CACzD;AAED,+DAA+D;AAC/D,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CAE/D;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,KAAK;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,oEAAoE;IACpE,aAAa,CAAC,CAAC,UAAU,EAAE,kBAAkB,GAAG,MAAM,CAAC;IACvD,2DAA2D;IAC3D,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,qEAAqE;IACrE,OAAO,CAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7C;;;;OAIG;IACH,MAAM,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAClE;;;;OAIG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB"}

package/dist/esm/cli/commands/init.d.ts

@@ -0,0 +1,3 @@
+import type { CliIO } from '../types';
+export declare function runInit(argv: string[], io: CliIO): Promise<number>;
+//# sourceMappingURL=init.d.ts.map

package/dist/esm/cli/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AA6JtC,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CA8GxE"}

package/dist/esm/cli/commands/init.js

@@ -0,0 +1,237 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { parseArgs } from 'node:util';
+import { detectProject } from '../detect';
+import { CliError } from '../errors';
+function parseInitFlags(argv) {
+    try {
+        const { values } = parseArgs({
+            args: argv,
+            options: {
+                schema: { type: 'string' },
+                out: { type: 'string' },
+                seed: { type: 'boolean' },
+                fresh: { type: 'boolean' },
+                yes: { type: 'boolean' },
+                force: { type: 'boolean' },
+                debug: { type: 'boolean' },
+            },
+            strict: true,
+            allowPositionals: false,
+        });
+        return values;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new CliError(`init: ${message}`);
+    }
+}
+// The classic Neo4j movie graph, expressed in grafeo SDL — recognizable to
+// Neo4j users and it exercises relationship arity/direction both ways.
+const MOVIE_SCHEMA = `# grafeo schema — the Neo4j movie example.
+# Run \`npx grafeo generate\` (or \`npm run generate\`) to emit typed models.
+
+type Movie @node {
+  title: String! @unique
+  released: Int
+  tagline: String
+  actors: [Person!]! @relationship(type: "ACTED_IN", direction: IN)
+  directors: [Person!]! @relationship(type: "DIRECTED", direction: IN)
+}
+
+type Person @node {
+  name: String! @id @unique
+  born: Int
+  actedIn: [Movie!]! @relationship(type: "ACTED_IN", direction: OUT)
+  directed: [Movie!]! @relationship(type: "DIRECTED", direction: OUT)
+}
+`;
+const SEED_STUB = `import type { OGM } from 'grafeo-ogm';
+
+// Prefer upsert over create so repeated seeds converge instead of duplicating.
+export default async function seed(ogm: OGM) {
+  const Movie = ogm.model('Movie');
+  await Movie.upsert({
+    where: { title: 'The Matrix' },
+    create: { title: 'The Matrix', released: 1999 },
+    update: { released: 1999 },
+  });
+}
+`;
+function renderConfig(schemaPath, outPath, includeSeed) {
+    // JSON.stringify, NOT string-templating: the paths come from --schema/--out
+    // /prompts and this file is later EXECUTED by jiti, so a raw `'${path}'`
+    // would let a quote in the path break out and inject code (and an innocent
+    // apostrophe would produce a broken config). JSON.stringify emits a fully
+    // escaped, valid string literal.
+    const seedLine = includeSeed ? `\n  seed: './seed.ts',` : '';
+    return `import { defineConfig } from 'grafeo-ogm';
+
+export default defineConfig({
+  schema: ${JSON.stringify(rel(schemaPath))},
+  out: ${JSON.stringify(rel(outPath))},
+  database: {
+    uri: process.env.NEO4J_URI,
+    username: process.env.NEO4J_USERNAME,
+    // Never commit a password — set NEO4J_PASSWORD in your environment.
+    password: process.env.NEO4J_PASSWORD,
+  },${seedLine}
+});
+`;
+}
+/** Normalize a path to a `./`-prefixed relative form for the config file. */
+function rel(p) {
+    const normalized = p.replace(/\\/g, '/');
+    return normalized.startsWith('.') ? normalized : `./${normalized}`;
+}
+function writeFileEnsuringDir(absPath, content) {
+    fs.mkdirSync(path.dirname(absPath), { recursive: true });
+    fs.writeFileSync(absPath, content, 'utf-8');
+}
+/**
+ * Add `"generate": "grafeo generate"` to package.json scripts. Non-destructive:
+ * an existing `generate` script is preserved. Returns what happened so the
+ * summary can report it.
+ */
+function wireGenerateScript(cwd) {
+    const pkgPath = path.join(cwd, 'package.json');
+    if (!fs.existsSync(pkgPath))
+        return 'none';
+    // Strip a UTF-8 BOM (common on Windows-edited files) so parse doesn't fail.
+    const raw = fs.readFileSync(pkgPath, 'utf-8').replace(/^\uFEFF/, '');
+    let pkg;
+    try {
+        pkg = JSON.parse(raw);
+    }
+    catch {
+        return 'none';
+    }
+    // Only treat `scripts` as a map when it's actually an object — otherwise a
+    // malformed value would be spread into garbage.
+    const scripts = typeof pkg.scripts === 'object' && pkg.scripts !== null
+        ? pkg.scripts
+        : {};
+    if (scripts.generate)
+        return 'kept';
+    pkg.scripts = {
+        ...scripts,
+        generate: 'grafeo generate',
+    };
+    const indent = /^\t/m.test(raw) ? '\t' : 2;
+    fs.writeFileSync(pkgPath, `${JSON.stringify(pkg, null, indent)}\n`, 'utf-8');
+    return 'added';
+}
+/** Pick the schema among detected candidates (prompt only when ambiguous). */
+async function chooseSchema(candidates, io, canPrompt) {
+    if (candidates.length === 1)
+        return candidates[0];
+    if (canPrompt && io.prompt) {
+        io.out('Multiple grafeo schemas found:');
+        candidates.forEach((c, i) => io.out(`  ${i + 1}) ${c}`));
+        const answer = await io.prompt('Which is your schema? (number)', '1');
+        const idx = Number.parseInt(answer, 10) - 1;
+        if (Number.isInteger(idx) && idx >= 0 && idx < candidates.length)
+            return candidates[idx];
+    }
+    return candidates[0];
+}
+export async function runInit(argv, io) {
+    const flags = parseInitFlags(argv);
+    const yes = flags.yes === true;
+    const force = flags.force === true;
+    const canPrompt = io.interactive === true && !yes;
+    const detection = detectProject(io.cwd, io.env);
+    const hasDetected = detection.schemaCandidates.length > 0 || detection.generatedTypes != null;
+    // Detected setup vs fresh start.
+    let fresh = flags.fresh === true;
+    if (hasDetected && !fresh && canPrompt && io.confirm) {
+        const detail = [
+            detection.schemaCandidates[0]
+                ? `schema: ${detection.schemaCandidates[0]}`
+                : null,
+            detection.generatedTypes ? `types: ${detection.generatedTypes}` : null,
+        ]
+            .filter(Boolean)
+            .join(', ');
+        const useDetected = await io.confirm(`Existing grafeo setup detected (${detail}) — wire the config to it?`);
+        fresh = !useDetected;
+    }
+    const useDetected = hasDetected && !fresh;
+    // Resolve schema path: flag > detected > prompt/default.
+    let schemaPath = flags.schema;
+    if (!schemaPath && useDetected)
+        schemaPath = await chooseSchema(detection.schemaCandidates, io, canPrompt);
+    if (!schemaPath)
+        schemaPath =
+            canPrompt && io.prompt
+                ? await io.prompt('Schema path?', 'schema.graphql')
+                : 'schema.graphql';
+    // Resolve output path: flag > detected > prompt/default.
+    let outPath = flags.out;
+    if (!outPath && useDetected && detection.generatedTypes)
+        outPath = detection.generatedTypes;
+    if (!outPath)
+        outPath =
+            canPrompt && io.prompt
+                ? await io.prompt('Generated types output path?', 'grafeo.generated.ts')
+                : 'grafeo.generated.ts';
+    const created = [];
+    const kept = [];
+    // Scaffold the schema only when it doesn't already exist.
+    const schemaAbs = path.resolve(io.cwd, schemaPath);
+    if (fs.existsSync(schemaAbs))
+        kept.push(schemaPath);
+    else {
+        writeFileEnsuringDir(schemaAbs, MOVIE_SCHEMA);
+        created.push(schemaPath);
+    }
+    const wantSeed = flags.seed === true;
+    // Write grafeo.config.ts — never clobber an existing one without consent.
+    const configAbs = path.resolve(io.cwd, 'grafeo.config.ts');
+    const config = renderConfig(schemaPath, outPath, wantSeed);
+    if (fs.existsSync(configAbs) && !force) {
+        const overwrite = canPrompt && io.confirm
+            ? await io.confirm('grafeo.config.ts exists — overwrite it?')
+            : false;
+        if (!overwrite) {
+            if (!canPrompt)
+                throw new CliError('grafeo.config.ts already exists. Re-run with --force to overwrite.');
+            kept.push('grafeo.config.ts');
+        }
+        else {
+            fs.writeFileSync(configAbs, config, 'utf-8');
+            created.push('grafeo.config.ts');
+        }
+    }
+    else {
+        fs.writeFileSync(configAbs, config, 'utf-8');
+        created.push('grafeo.config.ts');
+    }
+    // Optional seed stub.
+    if (wantSeed) {
+        const seedAbs = path.resolve(io.cwd, 'seed.ts');
+        if (fs.existsSync(seedAbs) && !force)
+            kept.push('seed.ts');
+        else {
+            fs.writeFileSync(seedAbs, SEED_STUB, 'utf-8');
+            created.push('seed.ts');
+        }
+    }
+    // Wire an npm script (non-destructive).
+    const pkgNote = wireGenerateScript(io.cwd);
+    // Summary + next step.
+    for (const f of created)
+        io.out(`✓ created ${f}`);
+    for (const f of kept)
+        io.out(`• kept ${f} (already present)`);
+    if (pkgNote === 'added')
+        io.out('✓ added "generate" script to package.json');
+    else if (pkgNote === 'kept')
+        io.out('• kept existing "generate" script in package.json');
+    io.out('');
+    io.out(pkgNote === 'added'
+        ? 'Next: `npm run generate` (or `npx grafeo generate`)'
+        : 'Next: `npx grafeo generate`');
+    return 0;
+}
+//# sourceMappingURL=init.js.map

package/dist/esm/cli/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../../src/cli/commands/init.ts"],"names":[],"mappings":"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"}

package/dist/esm/cli/detect.d.ts

@@ -0,0 +1,18 @@
+/** What `grafeo init` found (or didn't) in an existing project. */
+export interface DetectionResult {
+    /** `.graphql`/`.gql` files that carry grafeo directives (relative to cwd). */
+    schemaCandidates: string[];
+    /** A previously generated types file, identified by the header marker. */
+    generatedTypes?: string;
+    /** An existing grafeo.config.{ts,js,json}, if present. */
+    existingConfig?: string;
+    /** True if a NEO4J_* env var or a .env mentioning one is present. */
+    hasNeo4jEnv: boolean;
+}
+/**
+ * Scan `cwd` for an existing grafeo setup so `init` can wire itself up. Pure
+ * filesystem reads — shallow, with generated/VCS dirs skipped — so it stays
+ * fast and never walks `node_modules`.
+ */
+export declare function detectProject(cwd: string, env: NodeJS.ProcessEnv): DetectionResult;
+//# sourceMappingURL=detect.d.ts.map

package/dist/esm/cli/detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../../../src/cli/detect.ts"],"names":[],"mappings":"AAGA,mEAAmE;AACnE,MAAM,WAAW,eAAe;IAC9B,8EAA8E;IAC9E,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,0EAA0E;IAC1E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0DAA0D;IAC1D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qEAAqE;IACrE,WAAW,EAAE,OAAO,CAAC;CACtB;AA2DD;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,CAAC,UAAU,GACrB,eAAe,CAyCjB"}

package/dist/esm/cli/detect.js

@@ -0,0 +1,106 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+// Directories never worth scanning — large, generated, or VCS internals.
+const SKIP_DIRS = new Set([
+    'node_modules',
+    'dist',
+    'build',
+    '.git',
+    '.next',
+    'coverage',
+    '.turbo',
+]);
+const MAX_DEPTH = 3;
+const CONFIG_NAMES = [
+    'grafeo.config.ts',
+    'grafeo.config.js',
+    'grafeo.config.json',
+];
+// Generated files open with a `// Generated by <pkg> generateTypes()` header
+// line (utility-types emitter). Anchor to the line start so a doc comment that
+// merely mentions the phrase isn't misdetected, and allow any package name so
+// files generated under an npm alias still match.
+const GENERATED_MARKER = /^\/\/\s*Generated by .+ generateTypes\(\)/m;
+// A schema is grafeo's only if it actually uses grafeo's directives — a bare
+// GraphQL file in the tree must not be mistaken for the OGM schema.
+const GRAFEO_DIRECTIVE = /@(node|relationship|relationshipProperties)\b/;
+function walk(root, depth, out) {
+    let entries;
+    try {
+        entries = fs.readdirSync(root, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        if (entry.name.startsWith('.') && entry.name !== '.env')
+            continue;
+        const full = path.join(root, entry.name);
+        if (entry.isDirectory()) {
+            if (depth >= MAX_DEPTH || SKIP_DIRS.has(entry.name))
+                continue;
+            walk(full, depth + 1, out);
+        }
+        else if (entry.isFile())
+            out.push(full);
+    }
+}
+function readHead(file, bytes = 4096) {
+    try {
+        const fd = fs.openSync(file, 'r');
+        try {
+            const buf = Buffer.alloc(bytes);
+            const read = fs.readSync(fd, buf, 0, bytes, 0);
+            return buf.toString('utf-8', 0, read);
+        }
+        finally {
+            fs.closeSync(fd);
+        }
+    }
+    catch {
+        return '';
+    }
+}
+/**
+ * Scan `cwd` for an existing grafeo setup so `init` can wire itself up. Pure
+ * filesystem reads — shallow, with generated/VCS dirs skipped — so it stays
+ * fast and never walks `node_modules`.
+ */
+export function detectProject(cwd, env) {
+    const files = [];
+    walk(cwd, 0, files);
+    const schemaCandidates = [];
+    let generatedTypes;
+    for (const file of files) {
+        const ext = path.extname(file);
+        const rel = path.relative(cwd, file);
+        if (ext === '.graphql' || ext === '.gql') {
+            // Only count it as the schema if it actually uses grafeo directives.
+            // Head-read (guarded + capped) like the .ts sniff — directives sit at the
+            // top of real schemas, and this avoids reading (or throwing on) a huge or
+            // unreadable file.
+            if (GRAFEO_DIRECTIVE.test(readHead(file, 65536)))
+                schemaCandidates.push(rel);
+        }
+        else if (ext === '.ts' && !generatedTypes)
+            if (GENERATED_MARKER.test(readHead(file)))
+                generatedTypes = rel;
+    }
+    // Prefer a file literally named schema.graphql when several candidates exist.
+    schemaCandidates.sort((a, b) => {
+        const an = path.basename(a) === 'schema.graphql' ? 0 : 1;
+        const bn = path.basename(b) === 'schema.graphql' ? 0 : 1;
+        return an - bn || a.localeCompare(b);
+    });
+    let existingConfig;
+    for (const name of CONFIG_NAMES)
+        if (fs.existsSync(path.join(cwd, name))) {
+            existingConfig = name;
+            break;
+        }
+    const hasNeo4jEnv = Object.keys(env).some((k) => k.startsWith('NEO4J_')) ||
+        (fs.existsSync(path.join(cwd, '.env')) &&
+            /^\s*NEO4J_/m.test(readHead(path.join(cwd, '.env'))));
+    return { schemaCandidates, generatedTypes, existingConfig, hasNeo4jEnv };
+}
+//# sourceMappingURL=detect.js.map

package/dist/esm/cli/detect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.js","sourceRoot":"","sources":["../../../src/cli/detect.ts"],"names":[],"mappings":"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"}

package/dist/esm/cli/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/index.ts"],"names":[],"mappings":";AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAoDrC;;;GAGG;AACH,wBAAsB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CA+ErE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/index.ts"],"names":[],"mappings":";AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAoErC;;;GAGG;AACH,wBAAsB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAoFrE"}

package/dist/esm/cli/index.js

@@ -4,6 +4,7 @@ import { CliError, renderError } from './errors';
 const HELP = `grafeo — CLI for grafeo-ogm
 
 Usage:
+  grafeo init     [--schema <path>] [--out <path>] [--seed] [--fresh] [--yes] [--force]
   grafeo generate [--schema <path>] [--out <path>] [--watch] [--verify] [--poll <ms>]
   grafeo db push  [--schema <path>] [--dry-run] [--force-drop] [--yes]
                   [--uri <bolt-uri>] [--username <user>] [--database <name>]
@@ -20,6 +21,21 @@ Configuration:
   NEO4J_DATABASE. The password is never accepted as a flag.`;
 /** Focused per-command help, shown for \`grafeo <command> --help\`. */
 const COMMAND_HELP = {
+    init: `grafeo init — scaffold (or auto-detect) a grafeo project
+
+Usage:
+  grafeo init [--schema <path>] [--out <path>] [--seed] [--fresh] [--yes] [--force]
+
+  Detects an existing grafeo schema + generated types and wires grafeo.config.ts
+  to them. With nothing to detect (or --fresh), scaffolds a starter schema
+  (the Neo4j movie example) and config.
+
+  --schema <path>  schema path (skip detection/prompt)
+  --out <path>     generated-types output path
+  --seed           also scaffold a seed.ts stub
+  --fresh          ignore any detected setup and scaffold a new project
+  --yes            non-interactive: accept detected values / defaults, no prompts
+  --force          overwrite an existing grafeo.config.ts / seed.ts`,
     generate: `grafeo generate — generate TypeScript types from your SDL
 
 Usage:
@@ -96,6 +112,10 @@ export async function main(argv, io) {
             return 0;
         }
         // Commands load lazily so `generate` never pays for neo4j-driver.
+        if (command === 'init') {
+            const { runInit } = await import('./commands/init');
+            return await runInit(commandArgs, io);
+        }
         if (command === 'generate') {
             const { runGenerate } = await import('./commands/generate');
             return await runGenerate(commandArgs, io);
@@ -143,6 +163,21 @@ if (typeof require !== 'undefined' && require.main === module) {
                 rl.close();
             }
         },
+        // Free-text prompt for `grafeo init` (path entry, candidate selection).
+        prompt: async (question, defaultValue) => {
+            const rl = readline.createInterface({
+                input: process.stdin,
+                output: process.stdout,
+            });
+            try {
+                const suffix = defaultValue ? ` (${defaultValue})` : '';
+                const answer = (await rl.question(`${question}${suffix} `)).trim();
+                return answer || defaultValue || '';
+            }
+            finally {
+                rl.close();
+            }
+        },
     };
     void main(process.argv.slice(2), io).then((code) => {
         process.exitCode = code;

package/dist/esm/cli/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/index.ts"],"names":[],"mappings":";AACA,OAAO,KAAK,QAAQ,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAGjD,MAAM,IAAI,GAAG;;;;;;;;;;;;;;;;4DAgB+C,CAAC;AAE7D,uEAAuE;AACvE,MAAM,YAAY,GAA2B;IAC3C,QAAQ,EAAE;;;;;;;;;kFASsE;IAChF,SAAS,EAAE;;;;;;;;;;gFAUmE;IAC9E,SAAS,EAAE;;;;;;kFAMqE;CACjF,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,IAAc,EAAE,EAAS;IAClD,qEAAqE;IACrE,oEAAoE;IACpE,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,YAAY,IAAI,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;QACrE,OAAO,WAAW,CAChB,IAAI,QAAQ,CACV,sEAAsE;YACpE,gEAAgE,CACnE,EACD,EAAE,EACF,KAAK,CACN,CAAC;IAEJ,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IACvC,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAEjE,2EAA2E;IAC3E,wEAAwE;IACxE,wEAAwE;IACxE,4EAA4E;IAC5E,oEAAoE;IACpE,oEAAoE;IACpE,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;IAC1D,MAAM,cAAc,GAAa,EAAE,CAAC;IACpC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACtB,IAAI,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,SAAS;QACtC,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,MAAM;QACjC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACzB,CAAC;IACD,MAAM,OAAO,GACX,cAAc,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;IACxE,MAAM,UAAU,GACd,cAAc,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;IACxE,MAAM,OAAO,GACX,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,UAAU,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;IAEvE,6EAA6E;IAC7E,uEAAuE;IACvE,8CAA8C;IAC9C,MAAM,SAAS,GAAG,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC;IAC5D,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAE3D,IAAI,CAAC;QACH,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACb,OAAO,CAAC,CAAC;QACX,CAAC;QACD,IAAI,SAAS,EAAE,CAAC;YACd,EAAE,CAAC,GAAG,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC;YACtC,OAAO,CAAC,CAAC;QACX,CAAC;QAED,kEAAkE;QAClE,IAAI,OAAO,KAAK,UAAU,EAAE,CAAC;YAC3B,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;YAC5D,OAAO,MAAM,WAAW,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAC5C,CAAC;QAED,IAAI,OAAO,KAAK,IAAI,IAAI,UAAU,KAAK,MAAM,EAAE,CAAC;YAC9C,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;YACzD,OAAO,MAAM,SAAS,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAC1C,CAAC;QAED,IAAI,OAAO,KAAK,IAAI,IAAI,UAAU,KAAK,MAAM,EAAE,CAAC;YAC9C,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;YACzD,OAAO,MAAM,SAAS,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAC1C,CAAC;QAED,EAAE,CAAC,GAAG,CACJ,2BAA2B,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAC9E,CAAC;QACF,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACX,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACb,OAAO,CAAC,CAAC;IACX,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,WAAW,CAAC,KAAK,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;IACvC,CAAC;AACH,CAAC;AAED,4EAA4E;AAC5E,8EAA8E;AAC9E,0BAA0B;AAC1B,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC9D,MAAM,EAAE,GAAU;QAChB,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;QAClB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC;QAChD,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC;QAChD,WAAW,EAAE,OAAO,CAAC,KAAK,CAAC,KAAK,KAAK,IAAI;QACzC,wEAAwE;QACxE,uEAAuE;QACvE,yDAAyD;QACzD,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE;YAC1B,MAAM,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAC;gBAClC,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,MAAM,EAAE,OAAO,CAAC,MAAM;aACvB,CAAC,CAAC;YACH,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,GAAG,QAAQ,SAAS,CAAC,CAAC;gBACvD,OAAO,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;YACzC,CAAC;oBAAS,CAAC;gBACT,EAAE,CAAC,KAAK,EAAE,CAAC;YACb,CAAC;QACH,CAAC;KACF,CAAC;IACF,KAAK,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;QACjD,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAC1B,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/index.ts"],"names":[],"mappings":"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"}

package/dist/esm/cli/types.d.ts

@@ -61,6 +61,12 @@ export interface CliIO {
     interactive?: boolean;
     /** Prompt for yes/no confirmation (only called when interactive). */
     confirm?(question: string): Promise<boolean>;
+    /**
+     * Prompt for a free-text answer (only called when interactive). Returns the
+     * trimmed input, or `defaultValue` when the user enters nothing. Used by
+     * `grafeo init` for path entry and detected-vs-fresh selection.
+     */
+    prompt?(question: string, defaultValue?: string): Promise<string>;
     /**
      * Cooperative shutdown for long-running commands (`generate --watch`).
      * The bin runs without one (Ctrl-C kills the process); tests abort it

package/dist/esm/cli/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/cli/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAEvE,kFAAkF;AAClF,MAAM,WAAW,oBAAoB;IACnC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,QAAQ,GAAG,WAAW,CAAC;CACrC;AAED,qDAAqD;AACrD,MAAM,WAAW,YAAY;IAC3B,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IAC/B,kEAAkE;IAClE,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,qEAAqE;IACrE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;CACzD;AAED,+DAA+D;AAC/D,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CAE/D;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,KAAK;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,oEAAoE;IACpE,aAAa,CAAC,CAAC,UAAU,EAAE,kBAAkB,GAAG,MAAM,CAAC;IACvD,2DAA2D;IAC3D,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,qEAAqE;IACrE,OAAO,CAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7C;;;;OAIG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/cli/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAEvE,kFAAkF;AAClF,MAAM,WAAW,oBAAoB;IACnC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,QAAQ,GAAG,WAAW,CAAC;CACrC;AAED,qDAAqD;AACrD,MAAM,WAAW,YAAY;IAC3B,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IAC/B,kEAAkE;IAClE,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,qEAAqE;IACrE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;CACzD;AAED,+DAA+D;AAC/D,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CAE/D;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,KAAK;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,oEAAoE;IACpE,aAAa,CAAC,CAAC,UAAU,EAAE,kBAAkB,GAAG,MAAM,CAAC;IACvD,2DAA2D;IAC3D,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,qEAAqE;IACrE,OAAO,CAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7C;;;;OAIG;IACH,MAAM,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAClE;;;;OAIG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "grafeo-ogm",
-  "version": "1.9.1",
+  "version": "1.10.0",
   "description": "Type-safe Neo4j ORM / OGM for TypeScript. Define your graph in GraphQL SDL, get fully typed Prisma-like CRUD, optimized Cypher, and zero-config code generation. Community successor to @neo4j/graphql-ogm.",
   "license": "MIT",
   "author": "Alejandro Guzman",