@descryy/cli 0.1.0

package/dist/bin/descry.d.ts

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+/**
+ * `descry` — the command-line entry point.
+ *
+ * The only command today is `init`. Nothing prints before argument parsing
+ * finishes, and a bad flag is a loud, immediate failure rather than a run
+ * that silently ignored it — the same instinct `descry-mcp`'s bin file
+ * states for its own argument handling.
+ */
+export {};
+//# sourceMappingURL=descry.d.ts.map

package/dist/bin/descry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"descry.d.ts","sourceRoot":"","sources":["../../src/bin/descry.ts"],"names":[],"mappings":";AACA;;;;;;;GAOG"}

package/dist/bin/descry.js

@@ -0,0 +1,171 @@
+#!/usr/bin/env node
+/**
+ * `descry` — the command-line entry point.
+ *
+ * The only command today is `init`. Nothing prints before argument parsing
+ * finishes, and a bad flag is a loud, immediate failure rather than a run
+ * that silently ignored it — the same instinct `descry-mcp`'s bin file
+ * states for its own argument handling.
+ */
+import process from "node:process";
+import { runInit } from "../commands/init.js";
+import { runViz } from "../commands/viz.js";
+const USAGE = `descry — Descry's command-line surface
+
+  descry init [--workspace <name>] [--repo <name>] [repository-path]
+  descry viz [--port <number>] [repository-path]
+
+Writes .descry/config.json with an explicit repo identity and, when given, a
+workspace id every other repository in the same workspace must share
+byte-identical. Also writes a packages declaration, but only when this
+repository is a monorepo and nothing already declares one — never a pairing
+between packages, which this command does not infer.
+
+  --workspace <name>   the workspace id shared with other repositories.
+                        Omit it for a single-repo project — nothing is
+                        written and the output says so.
+  --repo <name>         this repository's identity. Detected from
+                        package.json#name or pyproject.toml's [project].name
+                        when omitted, but always written explicitly either
+                        way — never left to default at every future read.
+  repository-path       defaults to the current directory.
+
+descry viz serves a local, query-driven inspector over an already-built
+graph (run analyze first). Search a symbol, see its neighbourhood — never
+the whole graph at once.
+
+  --port <number>       defaults to an OS-assigned free port.
+`;
+function parseInitArgs(args) {
+    let workspace;
+    let repo;
+    const positional = [];
+    for (let i = 0; i < args.length; i += 1) {
+        const arg = args[i];
+        if (arg === "--help" || arg === "-h")
+            return { help: true, repoPath: process.cwd() };
+        if (arg === "--workspace") {
+            i += 1;
+            const value = args[i];
+            if (value === undefined)
+                throw new Error("--workspace needs a value");
+            workspace = value;
+            continue;
+        }
+        if (arg === "--repo") {
+            i += 1;
+            const value = args[i];
+            if (value === undefined)
+                throw new Error("--repo needs a value");
+            repo = value;
+            continue;
+        }
+        if (arg?.startsWith("--"))
+            throw new Error(`unknown flag "${arg}"`);
+        if (arg !== undefined)
+            positional.push(arg);
+    }
+    return {
+        help: false,
+        ...(workspace === undefined ? {} : { workspace }),
+        ...(repo === undefined ? {} : { repo }),
+        repoPath: positional[0] ?? process.cwd(),
+    };
+}
+function parseVizArgs(args) {
+    let port;
+    const positional = [];
+    for (let i = 0; i < args.length; i += 1) {
+        const arg = args[i];
+        if (arg === "--help" || arg === "-h")
+            return { help: true, repoPath: process.cwd() };
+        if (arg === "--port") {
+            i += 1;
+            const value = args[i];
+            if (value === undefined)
+                throw new Error("--port needs a value");
+            const parsedPort = Number(value);
+            if (!Number.isInteger(parsedPort) || parsedPort <= 0)
+                throw new Error(`--port must be a positive integer, got "${value}"`);
+            port = parsedPort;
+            continue;
+        }
+        if (arg?.startsWith("--"))
+            throw new Error(`unknown flag "${arg}"`);
+        if (arg !== undefined)
+            positional.push(arg);
+    }
+    return { help: false, ...(port === undefined ? {} : { port }), repoPath: positional[0] ?? process.cwd() };
+}
+async function runInitCommand(rest) {
+    let parsed;
+    try {
+        parsed = parseInitArgs(rest);
+    }
+    catch (error) {
+        process.stderr.write(`descry init: ${error.message}\n\n${USAGE}`);
+        return 1;
+    }
+    if (parsed.help) {
+        process.stdout.write(USAGE);
+        return 0;
+    }
+    try {
+        const result = await runInit({
+            repoPath: parsed.repoPath,
+            ...(parsed.workspace === undefined ? {} : { workspace: parsed.workspace }),
+            ...(parsed.repo === undefined ? {} : { repo: parsed.repo }),
+        });
+        for (const line of result.lines)
+            process.stdout.write(`${line}\n`);
+        return 0;
+    }
+    catch (error) {
+        process.stderr.write(`descry init: ${error.message}\n`);
+        return 1;
+    }
+}
+async function runVizCommand(rest) {
+    let parsed;
+    try {
+        parsed = parseVizArgs(rest);
+    }
+    catch (error) {
+        process.stderr.write(`descry viz: ${error.message}\n\n${USAGE}`);
+        return 1;
+    }
+    if (parsed.help) {
+        process.stdout.write(USAGE);
+        return 0;
+    }
+    try {
+        const server = await runViz({
+            repoPath: parsed.repoPath,
+            ...(parsed.port === undefined ? {} : { port: parsed.port }),
+        });
+        process.stdout.write(`descry viz: ${server.url}\n`);
+        process.stdout.write("Ctrl-C to stop.\n");
+        await new Promise((res) => process.once("SIGINT", () => res()));
+        await server.close();
+        return 0;
+    }
+    catch (error) {
+        process.stderr.write(`descry viz: ${error.message}\n`);
+        return 1;
+    }
+}
+async function main() {
+    const [command, ...rest] = process.argv.slice(2);
+    if (command === undefined || command === "--help" || command === "-h") {
+        process.stdout.write(USAGE);
+        return command === undefined ? 1 : 0;
+    }
+    if (command === "init")
+        return runInitCommand(rest);
+    if (command === "viz")
+        return runVizCommand(rest);
+    process.stderr.write(`descry: unknown command "${command}"\n\n${USAGE}`);
+    return 1;
+}
+process.exitCode = await main();
+//# sourceMappingURL=descry.js.map

package/dist/bin/descry.js.map

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

package/dist/commands/init.d.ts

@@ -0,0 +1,48 @@
+/**
+ * `descry init` — write the two declarations a multi-repo run needs.
+ *
+ * Neither is inferred. The workspace id (`.descry/config.json`) is either
+ * given with `--workspace` or left unset; the package list a monorepo needs
+ * is read back from the manifests `resolveWorkspace` already knows how to
+ * read, never guessed here a second time. A pairing between two packages is
+ * never written by this command at all — `workspace.ts`'s header states why,
+ * and `init` does not relax it.
+ *
+ * ## What this prevents, and what it does not
+ *
+ * This is the declare-it-once half. The two guards that catch a run where
+ * nobody declared anything, or declared it wrong, live elsewhere: a
+ * zero-join warning at query time (`graph/build.ts`'s `NO_CROSS_REPO_JOIN`)
+ * and a workspace-mismatch check at write time from `batch.workspace`
+ * (`graph/writer.ts`). `init` does not duplicate either — it exists so a user
+ * who runs it never needs them.
+ */
+import { type DeclarationSource } from "@descryy/core";
+export type RepoSource = "flag" | "package.json#name" | "pyproject.toml#name" | "directory basename";
+export interface InitOptions {
+    readonly repoPath: string;
+    readonly workspace?: string | undefined;
+    readonly repo?: string | undefined;
+}
+export interface DeclarationWritten {
+    readonly path: string;
+    readonly source: DeclarationSource;
+    readonly packages: readonly string[];
+}
+export interface InitResult {
+    readonly configPath: string;
+    readonly repo: string;
+    readonly repoSource: RepoSource;
+    readonly workspace: string | undefined;
+    readonly declarationWritten: DeclarationWritten | null;
+    /** Why no packages declaration was written, when one was not. */
+    readonly declarationSkippedReason: string | null;
+    /** MK-3. The bare module specifiers written to `sources`, `null` when none were. */
+    readonly sourcesWritten: readonly string[] | null;
+    /** Why `sources` was not written, when it was not. */
+    readonly sourcesSkippedReason: string | null;
+    /** The exact report text — `bin/descry.ts` and tests share this rather than each formatting their own. */
+    readonly lines: readonly string[];
+}
+export declare function runInit(options: InitOptions): Promise<InitResult>;
+//# sourceMappingURL=init.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAMH,OAAO,EAAoB,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGzE,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,mBAAmB,GAAG,qBAAqB,GAAG,oBAAoB,CAAC;AAErG,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,kBAAkB,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACvD,iEAAiE;IACjE,QAAQ,CAAC,wBAAwB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjD,oFAAoF;IACpF,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;IAClD,sDAAsD;IACtD,QAAQ,CAAC,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7C,0GAA0G;IAC1G,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AA4GD,wBAAsB,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAqGvE"}

package/dist/commands/init.js

@@ -0,0 +1,223 @@
+/**
+ * `descry init` — write the two declarations a multi-repo run needs.
+ *
+ * Neither is inferred. The workspace id (`.descry/config.json`) is either
+ * given with `--workspace` or left unset; the package list a monorepo needs
+ * is read back from the manifests `resolveWorkspace` already knows how to
+ * read, never guessed here a second time. A pairing between two packages is
+ * never written by this command at all — `workspace.ts`'s header states why,
+ * and `init` does not relax it.
+ *
+ * ## What this prevents, and what it does not
+ *
+ * This is the declare-it-once half. The two guards that catch a run where
+ * nobody declared anything, or declared it wrong, live elsewhere: a
+ * zero-join warning at query time (`graph/build.ts`'s `NO_CROSS_REPO_JOIN`)
+ * and a workspace-mismatch check at write time from `batch.workspace`
+ * (`graph/writer.ts`). `init` does not duplicate either — it exists so a user
+ * who runs it never needs them.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { readFile, readdir, writeFile } from "node:fs/promises";
+import { basename, join, resolve } from "node:path";
+import { resolveWorkspace } from "@descryy/core";
+import { loadConfig, writeConfig, writeSources } from "@descryy/mcp";
+/**
+ * MK-3 — installed adapters, detected rather than named.
+ *
+ * `registry.ts`'s own header is explicit that this repository must never
+ * name a language: an adapter is anything installed under
+ * `@descryhq-wq/adapter-*`, found by listing a directory, not by matching a
+ * hand-maintained list that silently goes stale the next time
+ * `descry-adapters` ships a package this file has never heard of.
+ *
+ * Only `repoPath`'s own `node_modules` is checked — a workspace root that
+ * hoists dependencies elsewhere is a real gap, disclosed in
+ * `sourcesSkippedReason` rather than worked around by walking upward and
+ * risking a match against an unrelated monorepo's adapters.
+ */
+async function detectInstalledAdapters(repoPath) {
+    const scopeDir = join(repoPath, "node_modules", "@descryhq-wq");
+    let entries;
+    try {
+        entries = (await readdir(scopeDir, { withFileTypes: true }))
+            .filter((e) => (e.isDirectory() || e.isSymbolicLink()) && e.name.startsWith("adapter-"))
+            .map((e) => e.name);
+    }
+    catch {
+        return [];
+    }
+    return entries.sort().map((name) => `@descryhq-wq/${name}`);
+}
+/**
+ * `[project]`'s `name`, read as narrowly as `workspace.ts` reads
+ * `[tool.descry]` — this is not a TOML parser, and a `name` key belonging to
+ * some other table (a dependency, `[tool.poetry]`) must not be picked up by
+ * accident.
+ */
+function readPyprojectProjectName(repoPath) {
+    const path = join(repoPath, "pyproject.toml");
+    if (!existsSync(path))
+        return undefined;
+    let text;
+    try {
+        text = readFileSync(path, "utf8");
+    }
+    catch {
+        return undefined;
+    }
+    let inProjectTable = false;
+    for (const raw of text.split("\n")) {
+        const line = raw.trim();
+        if (/^\[.*\]$/.test(line)) {
+            inProjectTable = line === "[project]";
+            continue;
+        }
+        if (!inProjectTable)
+            continue;
+        const match = /^name\s*=\s*"([^"]*)"\s*$/.exec(line);
+        if (match?.[1] !== undefined && match[1] !== "")
+            return match[1];
+    }
+    return undefined;
+}
+function detectRepoName(repoPath) {
+    const pkgJsonPath = join(repoPath, "package.json");
+    if (existsSync(pkgJsonPath)) {
+        try {
+            const parsed = JSON.parse(readFileSync(pkgJsonPath, "utf8"));
+            if (typeof parsed.name === "string" && parsed.name !== "") {
+                return { name: parsed.name, source: "package.json#name" };
+            }
+        }
+        catch {
+            // fall through
+        }
+    }
+    const pyprojectName = readPyprojectProjectName(repoPath);
+    if (pyprojectName !== undefined)
+        return { name: pyprojectName, source: "pyproject.toml#name" };
+    return { name: basename(resolve(repoPath)), source: "directory basename" };
+}
+/**
+ * Packages only, by preference: an existing manifest over a new root file.
+ * `null` means a declaration slot exists but this reader would not trust
+ * itself to merge into it — left untouched rather than risking a duplicate
+ * `[tool.descry]` table or a silently overwritten key.
+ */
+async function writePackagesDeclaration(repoPath, packages) {
+    const pkgJsonPath = join(repoPath, "package.json");
+    if (existsSync(pkgJsonPath)) {
+        const parsed = JSON.parse(await readFile(pkgJsonPath, "utf8"));
+        if (parsed.descry !== undefined)
+            return null;
+        parsed.descry = { packages: [...packages] };
+        await writeFile(pkgJsonPath, `${JSON.stringify(parsed, null, 2)}\n`, "utf8");
+        return { path: pkgJsonPath, source: "package.json#descry" };
+    }
+    const pyprojectPath = join(repoPath, "pyproject.toml");
+    if (existsSync(pyprojectPath)) {
+        const text = await readFile(pyprojectPath, "utf8");
+        if (text.includes("[tool.descry]"))
+            return null;
+        const table = `\n[tool.descry]\npackages = [${packages.map((p) => `"${p}"`).join(", ")}]\n`;
+        await writeFile(pyprojectPath, `${text.replace(/\n*$/, "\n")}${table}`, "utf8");
+        return { path: pyprojectPath, source: "pyproject.toml#tool.descry" };
+    }
+    const descryJsonPath = join(repoPath, "descry.json");
+    await writeFile(descryJsonPath, `${JSON.stringify({ packages: [...packages] }, null, 2)}\n`, "utf8");
+    return { path: descryJsonPath, source: "descry.json" };
+}
+export async function runInit(options) {
+    const repoPath = resolve(options.repoPath);
+    const lines = [];
+    const repo = options.repo !== undefined && options.repo !== ""
+        ? { name: options.repo, source: "flag" }
+        : detectRepoName(repoPath);
+    const config = await writeConfig(repoPath, {
+        repo: repo.name,
+        ...(options.workspace === undefined ? {} : { workspace: options.workspace }),
+    });
+    lines.push(`wrote ${config.path}`);
+    lines.push(`  repo: "${repo.name}"  (from ${repo.source})`);
+    if (options.workspace !== undefined) {
+        lines.push(`  workspace: "${options.workspace}"`);
+        if (config.previousWorkspace !== undefined && config.previousWorkspace !== options.workspace) {
+            lines.push(`  (replaced previous workspace "${config.previousWorkspace}")`);
+        }
+        lines.push("");
+        lines.push(`WORKSPACE ID: ${options.workspace}`);
+        lines.push("Write this exact string, byte-identical, into every other repository that should join " +
+            "this one's graph. A single differing character produces a graph that joins nothing, silently.");
+    }
+    else {
+        lines.push("  workspace: not set");
+        lines.push("");
+        lines.push("Single-repo project — no workspace id written. Nothing here can join another repository's " +
+            "graph, which is correct until there is a second repository to join. Run again with " +
+            "--workspace <name> when there is.");
+    }
+    const declaration = resolveWorkspace(repoPath);
+    let declarationWritten = null;
+    let declarationSkippedReason = null;
+    lines.push("");
+    if (declaration.packages.length <= 1) {
+        declarationSkippedReason = "single package — no packages declaration needed.";
+        lines.push(declarationSkippedReason);
+    }
+    else if (declaration.declarationSource !== "none") {
+        declarationSkippedReason = `packages already declared via ${declaration.declarationSource} — left untouched.`;
+        lines.push(declarationSkippedReason);
+    }
+    else {
+        const written = await writePackagesDeclaration(repoPath, declaration.packages);
+        if (written === null) {
+            declarationSkippedReason =
+                "a packages declaration slot exists but could not be read safely, so nothing was written " +
+                    'to it — add "descry": { "packages": [...] } (or the pyproject.toml [tool.descry] table) by hand.';
+            lines.push(declarationSkippedReason);
+        }
+        else {
+            declarationWritten = { path: written.path, source: written.source, packages: declaration.packages };
+            lines.push(`wrote ${written.path}  (${declaration.packages.length} package(s): ${declaration.packages.join(", ")})`);
+            lines.push("No pairing was written. A pairing between two packages is never inferred from their names — " +
+                "declare it by hand if two packages here are meant to join, or let a real USES_API/SERVES_API " +
+                "edge at R3 discover it.");
+        }
+    }
+    lines.push("");
+    let sourcesWritten = null;
+    let sourcesSkippedReason = null;
+    const existingSources = (await loadConfig(repoPath)).sources;
+    if (existingSources.length > 0) {
+        sourcesSkippedReason = `sources already configured (${existingSources.length}) — left untouched.`;
+        lines.push(sourcesSkippedReason);
+    }
+    else {
+        const detected = await detectInstalledAdapters(repoPath);
+        if (detected.length === 0) {
+            sourcesSkippedReason =
+                "no adapter found under node_modules/@descryhq-wq — install one " +
+                    '("npm install @descryhq-wq/adapter-<name>") and run init again, or add "sources" to ' +
+                    ".descry/config.json by hand.";
+            lines.push(sourcesSkippedReason);
+        }
+        else {
+            await writeSources(repoPath, detected);
+            sourcesWritten = detected;
+            lines.push(`wrote sources: ${detected.length} adapter(s) detected — ${detected.join(", ")}`);
+        }
+    }
+    return {
+        configPath: config.path,
+        repo: repo.name,
+        repoSource: repo.source,
+        workspace: options.workspace,
+        declarationWritten,
+        declarationSkippedReason,
+        sourcesWritten,
+        sourcesSkippedReason,
+        lines,
+    };
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

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

package/dist/commands/viz.d.ts

@@ -0,0 +1,16 @@
+/**
+ * `descry viz` — resolve the graph path the same way every other front door
+ * does (`.descry/config.json`'s `graph` field, defaulting like `Session`
+ * does) and hand it to `@descryy/viz`. This command owns argument parsing and
+ * path resolution only; it reads no graph itself.
+ */
+export interface RunVizOptions {
+    readonly repoPath: string;
+    readonly port?: number | undefined;
+}
+export interface RunVizResult {
+    readonly url: string;
+    readonly close: () => Promise<void>;
+}
+export declare function runViz(options: RunVizOptions): Promise<RunVizResult>;
+//# sourceMappingURL=viz.d.ts.map

package/dist/commands/viz.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viz.d.ts","sourceRoot":"","sources":["../../src/commands/viz.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC;AAED,wBAAsB,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAW1E"}

package/dist/commands/viz.js

@@ -0,0 +1,20 @@
+/**
+ * `descry viz` — resolve the graph path the same way every other front door
+ * does (`.descry/config.json`'s `graph` field, defaulting like `Session`
+ * does) and hand it to `@descryy/viz`. This command owns argument parsing and
+ * path resolution only; it reads no graph itself.
+ */
+import { isAbsolute, join, resolve } from "node:path";
+import { loadConfig } from "@descryy/mcp";
+import { startVizServer } from "@descryy/viz";
+export async function runViz(options) {
+    const repoPath = resolve(options.repoPath);
+    const config = await loadConfig(repoPath);
+    const graphPath = isAbsolute(config.graph) ? config.graph : join(repoPath, config.graph);
+    const server = await startVizServer({
+        graphPath,
+        ...(options.port === undefined ? {} : { port: options.port }),
+    });
+    return { url: server.url, close: server.close };
+}
+//# sourceMappingURL=viz.js.map

package/dist/commands/viz.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"viz.js","sourceRoot":"","sources":["../../src/commands/viz.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEtD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAY9C,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,OAAsB;IACjD,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC1C,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IAEzF,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC;QAClC,SAAS;QACT,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;KAC9D,CAAC,CAAC;IAEH,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;AAClD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { runInit, type InitOptions, type InitResult, type DeclarationWritten, type RepoSource } from "./commands/init.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,KAAK,kBAAkB,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { runInit } from "./commands/init.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAA+E,MAAM,oBAAoB,CAAC"}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@descryy/cli",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Descry's command-line surface. First command is `init`, which writes the declarations a multi-repo run needs — the workspace id in .descry/config.json, and a package/pairing declaration when the repo is a monorepo. Neither is ever inferred.",
+  "license": "MIT",
+  "engines": {
+    "node": ">=22.5"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "descry": "./dist/bin/descry.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -b"
+  },
+  "dependencies": {
+    "@descryy/core": "0.1.1",
+    "@descryy/mcp": "0.1.1",
+    "@descryy/viz": "0.1.0"
+  }
+}