@x12i/sdk 0.4.0 → 1.1.0

package/README.md

@@ -0,0 +1,62 @@
+# @x12i/sdk
+
+Version 1.0.0 is the catalog SDK. The earlier web client remains installable as `@x12i/sdk@0.4.0`.
+
+Find an `@x12i` package that fits a task, read its README and maturity, and file a signed review other code agents can see.
+
+The catalog and the ratings come from the x12i SDK service. A README is shown from the catalog cache first. When that cache is older than the publish time the catalog knows, the SDK fetches the current README and returns both. Listing and README text can also be read straight from the npm registry through `@x12i/npm-core` when that service is unreachable. Those registry matches are labeled unranked.
+
+```bash
+npx @x12i/sdk init
+npx @x12i/sdk init --all
+npx @x12i/sdk init --global
+npx @x12i/sdk mcp
+npx @x12i/sdk readme @x12i/sdk
+```
+
+`init` with no host flags writes Cursor's `.cursor/mcp.json` and `.cursor/rules/x12i-sdk.mdc`. `--claude` and `--codex` add Claude Code and Codex. `--all` writes all three. Existing MCP servers are left in place. The first run also creates an Ed25519 install key under `%LOCALAPPDATA%\x12i\sdk` on Windows (or the platform config directory). The private key stays there. There is no shared API key in this package.
+
+The rule tells the agent to call `x12i_search` before adding a dependency x12i might already publish, and `x12i_review` after trying one.
+
+The service is `https://x12i-sdk.x12i.com`. `X12I_SDK_URL` overrides it. Use `http://127.0.0.1:8789` for the local service.
+
+Search, README, reviews, and MCP are the regular SDK. Admin is separate and is not added to the MCP server:
+
+```bash
+x12i-sdk admin catalog
+x12i-sdk admin refresh
+x12i-sdk admin refresh @x12i/sdk
+```
+
+`admin catalog` prints every package as JSON, newest publish first. `admin refresh` updates the org listing, READMEs, and vulnerability scans. Set `X12I_SDK_ADMIN_KEY` for a remote service. The local service on `127.0.0.1` accepts its dev key when that variable is unset. `import { X12iAdmin } from "@x12i/sdk/admin"` is the same client.
+
+Managed catalog commands mint a scoped capability and never print it:
+
+```bash
+x12i-sdk admin import --from C:\path\to\x12i-catalog --dry-run
+x12i-sdk admin export
+x12i-sdk admin gaps
+x12i-sdk admin lineage
+x12i-sdk admin reconcile
+x12i-sdk admin npm-links
+x12i-sdk admin examples
+x12i-sdk admin runner path\to\usage-repo
+x12i-sdk admin mcp
+```
+
+Edit a package or product. Each save is one catalog revision that the audit page can revert:
+
+```bash
+x12i-sdk admin package @x12i/memorix
+x12i-sdk admin edit @x12i/memorix --reason "Maintainer review" \
+  --description "Scoped Mongo tier for Memorix entity collections." \
+  --use-case "Read or write scoped entity collections." --use-case "Discover registered collections." \
+  --add-tag "Mongo" --tiers data --primary data --product memorix
+x12i-sdk admin product memorix --reason "Review" --use-case "Store and retrieve scoped records."
+x12i-sdk admin products
+x12i-sdk admin tags
+```
+
+`--use-case` and `--tags` replace the current lists. `--add-tag` and `--remove-tag` adjust them. A tag name that does not exist yet is created. `--preview` saves nothing. The same edits are on the service at `/admin/packages` and `/admin/products`, and in `X12iAdmin` as `editPackage` and `editProduct`.
+
+`admin mcp` is a second stdio server for catalog edits, example preparation, and publish. The public `x12i-sdk mcp` server does not receive it. Publish tools dry-run unless the caller sets `dryRun` to false on a token that includes `examples:publish`. The App private key stays on the service. See `packages/sdk-service/ADMIN.md`.

package/dist/admin-import.d.ts

@@ -0,0 +1,6 @@
+import { X12iAdmin } from "./admin.js";
+export declare function verifyCheckpoint(root: string): Promise<{
+    checked: number;
+}>;
+export declare function planImport(root: string): Promise<Record<string, number>>;
+export declare function runImport(root: string, admin: X12iAdmin, dryRun: boolean): Promise<Record<string, unknown>>;

package/dist/admin-import.js

@@ -0,0 +1,127 @@
+import { createHash } from "node:crypto";
+import { readdir, readFile, stat } from "node:fs/promises";
+import { join, relative } from "node:path";
+const SKIP = new Set(["node_modules", ".git", "dist", ".vite"]);
+export async function verifyCheckpoint(root) {
+    const status = JSON.parse(await readFile(join(root, "research", "handover-status.json"), "utf8"));
+    const hashes = status.artifactSha256 ?? {};
+    let checked = 0;
+    for (const [name, expected] of Object.entries(hashes)) {
+        const actual = createHash("sha256").update(await readFile(join(root, name))).digest("hex");
+        if (actual !== expected)
+            throw new Error(`Checkpoint hash differs for ${name}`);
+        checked += 1;
+    }
+    return { checked };
+}
+export async function planImport(root) {
+    const catalog = JSON.parse(await readFile(join(root, "catalog.json"), "utf8"));
+    const evidence = JSON.parse(await readFile(join(root, "research", "enriched-evidence-index.json"), "utf8"));
+    const tasks = JSON.parse(await readFile(join(root, "todo.json"), "utf8"));
+    const receipts = JSON.parse(await readFile(join(root, "research", "usage-publish-receipts.json"), "utf8"));
+    return {
+        packages: catalog.packages.length,
+        families: catalog.families.length,
+        evidence: evidence.length,
+        tasks: tasks.tasks.length,
+        receipts: Object.keys(receipts).length,
+    };
+}
+export async function runImport(root, admin, dryRun) {
+    const checked = await verifyCheckpoint(root);
+    const plan = await planImport(root);
+    if (dryRun)
+        return { dryRun: true, ...checked, ...plan, uploaded: false };
+    const catalog = JSON.parse(await readFile(join(root, "catalog.json"), "utf8"));
+    const tokenAdmin = admin;
+    let applied = 0;
+    applied += await chunks(tokenAdmin, "packages", catalog.packages, (item) => String(item.name));
+    applied += await chunks(tokenAdmin, "families", catalog.families, (item) => String(item.id));
+    const evidence = JSON.parse(await readFile(join(root, "research", "enriched-evidence-index.json"), "utf8"));
+    applied += await chunks(tokenAdmin, "evidence", evidence, (item) => String(item.id));
+    const tasks = JSON.parse(await readFile(join(root, "todo.json"), "utf8"));
+    applied += await chunks(tokenAdmin, "tasks", tasks.tasks, (item) => String(item.id));
+    const findings = JSON.parse(await readFile(join(root, "research", "manual-findings.json"), "utf8"));
+    applied += await chunks(tokenAdmin, "findings", findings, (item) => String(item.title));
+    const receipts = JSON.parse(await readFile(join(root, "research", "usage-publish-receipts.json"), "utf8"));
+    applied += await chunks(tokenAdmin, "receipts", Object.entries(receipts).map(([slug, receipt]) => ({ slug, ...receipt })), (item) => String(item.slug));
+    const validation = JSON.parse(await readFile(join(root, "research", "usage-validation.json"), "utf8"));
+    applied += await chunks(tokenAdmin, "validations", validation, (item) => String(item.package));
+    const repositoryPlan = JSON.parse(await readFile(join(root, "research", "usage-repository-plan.json"), "utf8"));
+    applied += await chunks(tokenAdmin, "repositories", repositoryPlan.repositories, (item) => String(item.name));
+    const patches = JSON.parse(await readFile(join(root, "source-link-patches", "index.json"), "utf8"));
+    const links = patches.repositories.flatMap((repository) => repository.packages.map((pkg) => ({ ...pkg, repository: repository.repository, patch: repository.patch })));
+    applied += await chunks(tokenAdmin, "source-links", links, (item) => String(item.package));
+    applied += await importUsageFiles(root, tokenAdmin);
+    const current = await tokenAdmin.exportCatalog();
+    const finished = await tokenAdmin.finishImport(Number(current.revision ?? 0));
+    return { dryRun: false, ...checked, ...plan, chunks: applied, revision: finished.revision };
+}
+async function sendChunk(admin, chunk) {
+    for (let attempt = 0; attempt < 5; attempt += 1) {
+        try {
+            await admin.importChunk(chunk);
+            return;
+        }
+        catch (error) {
+            const status = error instanceof Error && "status" in error ? Number(error.status) : 0;
+            if (attempt === 4 || (status > 0 && status < 500))
+                throw error;
+            await new Promise((resolve) => setTimeout(resolve, 1000 * (attempt + 1)));
+        }
+    }
+}
+async function chunks(admin, kind, items, idOf) {
+    const size = 25;
+    let count = 0;
+    for (let index = 0; index < items.length; index += size) {
+        const slice = items.slice(index, index + size);
+        const chunkId = `${kind}-${index / size}`;
+        const digest = createHash("sha256").update(JSON.stringify(slice)).digest("hex");
+        await sendChunk(admin, { kind, chunkId, digest, items: slice.map((item) => ({ ...item, chunkKey: idOf(item) })) });
+        count += 1;
+    }
+    return count;
+}
+async function importUsageFiles(root, admin) {
+    const base = join(root, "usage-repos");
+    let count = 0;
+    let entries = [];
+    try {
+        entries = await readdir(base);
+    }
+    catch {
+        return 0;
+    }
+    for (const slug of entries) {
+        const directory = join(base, slug);
+        if (!(await stat(directory)).isDirectory())
+            continue;
+        const files = {};
+        await walk(directory, directory, files);
+        if (Object.keys(files).length === 0)
+            continue;
+        await sendChunk(admin, { kind: "usage-files", chunkId: slug, digest: createHash("sha256").update(JSON.stringify(files)).digest("hex"), items: [{ slug, files, state: "imported-draft" }] });
+        count += 1;
+    }
+    return count;
+}
+async function walk(root, directory, files) {
+    for (const name of await readdir(directory)) {
+        if (SKIP.has(name))
+            continue;
+        const path = join(directory, name);
+        const info = await stat(path);
+        if (info.isDirectory()) {
+            await walk(root, path, files);
+            continue;
+        }
+        if (info.size > 2_000_000)
+            continue;
+        const relativePath = relative(root, path).replaceAll("\\", "/");
+        if (!/^(README\.md|package\.json|package-lock\.json|\.gitignore|usage\.json|src\/.*)$/.test(relativePath))
+            continue;
+        files[relativePath] = await readFile(path, "utf8");
+    }
+}
+//# sourceMappingURL=admin-import.js.map

package/dist/admin-import.js.map

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

package/dist/admin-mcp.d.ts

@@ -0,0 +1,3 @@
+import type { X12iAdmin } from "./admin.js";
+export declare function runAdminMcp(admin: X12iAdmin): Promise<void>;
+export declare function handleAdminMcp(line: string, admin: X12iAdmin): Promise<string | undefined>;

package/dist/admin-mcp.js

@@ -0,0 +1,95 @@
+import { createInterface } from "node:readline";
+const object = (properties, required) => ({ type: "object", properties, required, additionalProperties: false });
+const str = (description) => ({ type: "string", description });
+const list = (description) => ({ type: "array", items: { type: "string" }, description });
+const TOOLS = [
+    { name: "x12i_admin_package", description: "Read one package: description, use cases, product, tags, tiers, lifecycle, and the current catalog revision.", inputSchema: object({ name: str("Exact npm name") }, ["name"]), run: (admin, args) => admin.getPackage(String(args.name ?? "")) },
+    {
+        name: "x12i_admin_edit_package",
+        description: "Edit a package in one revision. Send only the fields to change. useCases and tags replace the current lists; addTags and removeTags adjust them. An unknown tag name creates the tag. Use preview to check without saving.",
+        inputSchema: object({
+            name: str("Exact npm name"),
+            reason: str("Why this edit is being made"),
+            description: str("New package description"),
+            useCases: list("Every use case, one scenario per entry"),
+            tags: list("Every tag, by label or id"),
+            addTags: list("Tags to add"),
+            removeTags: list("Tags to remove"),
+            tiers: list("data, intelligence, presentation, or logic"),
+            primary: str("Primary tier, one of tiers"),
+            product: str("Product id, such as memorix"),
+            lifecycle: str("active, experimental, deprecated, superseded, or archived"),
+            preview: { type: "boolean" },
+        }, ["name", "reason"]),
+        run: (admin, args) => {
+            const { name, reason, preview, ...edit } = args;
+            return admin.editPackage(String(name ?? ""), edit, String(reason ?? ""), { preview: preview === true });
+        },
+    },
+    { name: "x12i_admin_products", description: "List products with their description, use cases, tags, and package counts.", inputSchema: object({}, []), run: (admin) => admin.products() },
+    {
+        name: "x12i_admin_edit_product",
+        description: "Edit a product's description, use cases, or tags in one revision. useCases and tags replace the current lists.",
+        inputSchema: object({ id: str("Product id"), reason: str("Why this edit is being made"), description: str("New description"), useCases: list("Every use case"), tags: list("Every tag, by label or id"), preview: { type: "boolean" } }, ["id", "reason"]),
+        run: (admin, args) => {
+            const { id, reason, preview, ...edit } = args;
+            return admin.editProduct(String(id ?? ""), edit, String(reason ?? ""), { preview: preview === true });
+        },
+    },
+    { name: "x12i_admin_tags", description: "List tags with their package counts.", inputSchema: object({}, []), run: (admin) => admin.tags() },
+    { name: "x12i_admin_gaps", description: "List packages that still need a confirmed tier or tag. Suggested rows are not confirmed.", inputSchema: object({}, []), run: (admin) => admin.gaps() },
+    { name: "x12i_admin_lineage", description: "Read the Memorix lineage report. Spelling collisions are not confirmed replacements.", inputSchema: object({}, []), run: (admin) => admin.lineage() },
+    { name: "x12i_admin_taxonomy", description: "Low-level batch edit. Change types: set-tiers, set-tags, set-family-tags, set-lifecycle, edit-family, merge-tags, edit-package, set-family, create-tag. Send expectedRevision.", inputSchema: object({ expectedRevision: { type: "integer" }, reason: str("Why this edit is being made"), preview: { type: "boolean" }, changes: { type: "array" } }, ["expectedRevision", "reason", "changes"]), run: (admin, args) => admin.taxonomy(args) },
+    { name: "x12i_admin_propose_replacement", description: "Propose a rename, successor, split, or merge. This does not hide the source package.", inputSchema: object({ expectedRevision: { type: "integer" }, source: { type: "array" }, target: { type: "array" }, kind: str("rename, successor, split, or merge"), migrationNotes: str("What a consumer should do") }, ["expectedRevision", "source", "target", "kind", "migrationNotes"]), run: (admin, args) => admin.proposeReplacement(args) },
+    { name: "x12i_admin_confirm_replacement", description: "Confirm a proposed replacement and mark its sources superseded.", inputSchema: object({ expectedRevision: { type: "integer" }, proposalId: str("Proposal id") }, ["expectedRevision", "proposalId"]), run: (admin, args) => admin.confirmReplacement(String(args.proposalId ?? ""), Number(args.expectedRevision)) },
+    { name: "x12i_admin_reconcile", description: "Compare the catalog, receipts, and drafts. Historical inventory and published coverage are separate.", inputSchema: object({}, []), run: (admin) => admin.reconcile() },
+    { name: "x12i_admin_npm_links", description: "List source link patches that are ready for review. This does not open a pull request or publish npm.", inputSchema: object({}, []), run: (admin) => admin.npmLinks() },
+    { name: "x12i_admin_prepare_example", description: "Store a usage draft. dryRun writes nothing.", inputSchema: object({ packageName: str("Exact npm name"), version: str("Exact version"), scenario: str("What the example demonstrates"), dryRun: { type: "boolean" }, files: { type: "object" } }, ["packageName", "version", "scenario"]), run: (admin, args) => admin.prepareDraft(args) },
+    { name: "x12i_admin_publish_example", description: "Publish a validated usage draft. dryRun is the default and creates nothing on GitHub.", inputSchema: object({ draftId: str("Draft id"), validationId: str("Validation id"), idempotencyKey: str("Retry key"), expectedRemoteHead: str("Remote commit the update must replace"), dryRun: { type: "boolean", description: "Defaults to true" } }, ["draftId", "validationId", "idempotencyKey"]), run: (admin, args) => admin.publishExample({ ...args, dryRun: args.dryRun !== false }) },
+];
+export async function runAdminMcp(admin) {
+    const token = process.env.X12I_SDK_ADMIN_TOKEN;
+    const scopes = (process.env.X12I_SDK_ADMIN_SCOPES ?? "catalog:read,metadata:write,examples:prepare,release:prepare").split(",").map((scope) => scope.trim()).filter(Boolean);
+    const scoped = token ? admin.withToken(token) : admin.withToken((await admin.mint(scopes, "admin-mcp")).token);
+    const lines = createInterface({ input: process.stdin });
+    for await (const line of lines) {
+        if (!line.trim())
+            continue;
+        const response = await handleAdminMcp(line, scoped);
+        if (response)
+            process.stdout.write(`${response}\n`);
+    }
+}
+export async function handleAdminMcp(line, admin) {
+    let message;
+    try {
+        message = JSON.parse(line);
+    }
+    catch {
+        return JSON.stringify({ jsonrpc: "2.0", id: null, error: { code: -32700, message: "Parse error" } });
+    }
+    if (message.id === undefined)
+        return undefined;
+    const id = message.id ?? null;
+    const params = message.params ?? {};
+    if (message.method === "initialize") {
+        return JSON.stringify({ jsonrpc: "2.0", id, result: { protocolVersion: "2025-06-18", capabilities: { tools: { listChanged: false } }, serverInfo: { name: "x12i-admin", version: "0.1.0" }, instructions: "Use these tools for catalog administration. Publishing defaults to a dry run. You do not receive the GitHub App key." } });
+    }
+    if (message.method === "tools/list") {
+        return JSON.stringify({ jsonrpc: "2.0", id, result: { tools: TOOLS.map(({ run: _run, ...tool }) => tool) } });
+    }
+    if (message.method === "tools/call") {
+        const tool = TOOLS.find((item) => item.name === params.name);
+        if (!tool)
+            return JSON.stringify({ jsonrpc: "2.0", id, error: { code: -32602, message: "Unknown tool" } });
+        try {
+            const value = await tool.run(admin, (params.arguments ?? {}));
+            return JSON.stringify({ jsonrpc: "2.0", id, result: { content: [{ type: "text", text: JSON.stringify(value) }], structuredContent: value, isError: false } });
+        }
+        catch (error) {
+            return JSON.stringify({ jsonrpc: "2.0", id, result: { content: [{ type: "text", text: error instanceof Error ? error.message : String(error) }], isError: true } });
+        }
+    }
+    return JSON.stringify({ jsonrpc: "2.0", id, error: { code: -32601, message: "Method not found" } });
+}
+//# sourceMappingURL=admin-mcp.js.map

package/dist/admin-mcp.js.map

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

package/dist/admin.d.ts

@@ -0,0 +1,156 @@
+/** Dev key the local catalog accepts when SDK_ADMIN_KEY is unset. Never sent to a remote host. */
+export declare const LOCAL_ADMIN_KEY = "dev-only-x12i-sdk-admin-key";
+export type AdminOptions = {
+    baseUrl?: string;
+    adminKey?: string;
+    fetch?: typeof fetch;
+};
+export type AdminRefreshTarget = "listing" | "readmes" | "audits" | "package";
+type CatalogPage = {
+    total?: number;
+    packages?: unknown[];
+    next?: string | null;
+    order?: string;
+    maturity?: unknown;
+};
+export type PackageEdit = {
+    description?: string;
+    useCases?: string[];
+    /** Replaces every tag. Labels or ids; an unknown label creates a tag. */
+    tags?: string[];
+    addTags?: string[];
+    removeTags?: string[];
+    /** data, intelligence, presentation, logic */
+    tiers?: string[];
+    primary?: string;
+    /** Product id, such as memorix. */
+    product?: string;
+    lifecycle?: "active" | "experimental" | "deprecated" | "superseded" | "archived";
+};
+export type ManagedPackageView = {
+    name: string;
+    version: string;
+    description: string;
+    useCases: string[];
+    product: string;
+    productTitle: string;
+    role: string;
+    tags: Array<{
+        id: string;
+        label: string;
+        reviewState: string;
+    }>;
+    tiers: Array<{
+        id: string;
+        primary: boolean;
+        reviewState: string;
+    }>;
+    lifecycle: {
+        state: string;
+        reviewState: string;
+        reason: string;
+    } | null;
+};
+export type ProductView = {
+    id: string;
+    title: string;
+    description: string;
+    useCases: string[];
+    tags: Array<{
+        id: string;
+        label: string;
+    }>;
+    packages: number;
+};
+export declare class X12iAdmin {
+    readonly baseUrl: string;
+    readonly adminKey: string;
+    private readonly fetchImpl;
+    constructor(options?: AdminOptions);
+    /** Every catalog package, newest publish first, without README bodies. */
+    catalog(): Promise<CatalogPage>;
+    status(): Promise<unknown>;
+    refresh(target: Exclude<AdminRefreshTarget, "package">, budget?: number): Promise<Record<string, unknown>>;
+    refreshPackage(name: string): Promise<Record<string, unknown>>;
+    /** Refresh the org listing, then READMEs, then vulnerability scans, until each queue is caught up. */
+    refreshAll(onBatch?: (kind: string, batch: Record<string, unknown>) => void): Promise<Record<string, unknown>>;
+    private untilQuiet;
+    mint(scopes: string[], label?: string, limits?: {
+        packageScope?: string[];
+        repoScope?: string[];
+    }): Promise<{
+        id: string;
+        token: string;
+        scopes: string[];
+    }>;
+    importChunk(chunk: {
+        kind: string;
+        chunkId: string;
+        digest: string;
+        items: unknown[];
+    }): Promise<unknown>;
+    finishImport(expectedRevision: number, reason?: string): Promise<unknown>;
+    exportCatalog(part?: "overrides"): Promise<unknown>;
+    taxonomy(body: Record<string, unknown>): Promise<unknown>;
+    /** One package as the admin sees it, with the catalog revision an edit must name. */
+    getPackage(name: string): Promise<{
+        revision: number;
+        package: ManagedPackageView;
+    }>;
+    /** Change any of a package's fields in one revision. Reads the current revision when it is not given. */
+    editPackage(name: string, edit: PackageEdit, reason: string, options?: {
+        expectedRevision?: number;
+        preview?: boolean;
+    }): Promise<Record<string, unknown>>;
+    products(): Promise<{
+        revision: number;
+        products: ProductView[];
+    }>;
+    getProduct(id: string): Promise<{
+        revision: number;
+        product: ProductView;
+    }>;
+    editProduct(id: string, edit: {
+        description?: string;
+        useCases?: string[];
+        tags?: string[];
+    }, reason: string, options?: {
+        expectedRevision?: number;
+        preview?: boolean;
+    }): Promise<Record<string, unknown>>;
+    tags(): Promise<{
+        tags: Array<{
+            id: string;
+            label: string;
+            category: string;
+            replacedBy: string | null;
+            packages: number;
+        }>;
+    }>;
+    proposeReplacement(body: Record<string, unknown>): Promise<unknown>;
+    confirmReplacement(proposalId: string, expectedRevision: number): Promise<unknown>;
+    gaps(): Promise<unknown>;
+    lineage(): Promise<unknown>;
+    reconcile(): Promise<unknown>;
+    npmLinks(): Promise<unknown>;
+    prepareDraft(body: Record<string, unknown>): Promise<unknown>;
+    recordValidation(body: Record<string, unknown>): Promise<unknown>;
+    publishExample(body: Record<string, unknown>): Promise<unknown>;
+    withToken(token: string): X12iAdmin;
+    operation(id: string): Promise<unknown>;
+    cancelOperation(id: string): Promise<unknown>;
+    resumeOperation(id: string): Promise<unknown>;
+    exampleBacklog(): Promise<unknown>;
+    private send;
+}
+export declare function runAdminCli(args: string[]): Promise<void>;
+type Flags = {
+    has(name: string): boolean;
+    single(name: string): string | undefined;
+    many(name: string): string[] | undefined;
+    list(name: string): string[] | undefined;
+    useCases(): string[] | undefined;
+};
+/** --name value pairs. Repeated flags collect; --tags and --tiers take comma lists. */
+export declare function parseFlags(args: string[]): Flags;
+export {};