@graphit/cli 0.2.322 → 0.2.330

package/dist/commands/sl/index.js

@@ -1,263 +0,0 @@
-import { readFileSync } from "node:fs";
-import { apiClient } from "../../api/client.js";
-import { errorOutput } from "../../output/format.js";
-import { writeStderr } from "../../stderr.js";
-// The dbt-native semantic-layer command tree (dormant preview).
-//
-// GATED: registered only when GRAPHIT_SL=1 (see src/index.ts). This file lives
-// in a SUBDIRECTORY of commands/ deliberately - the SKILL.md/tool-manifest
-// generators walk only top-level dist/commands/*.js registrars, so nothing
-// here can reach the published skill, the verb-policy manifest, or the in-app
-// agent surface until the cutover promotes it. At cutover this tree replaces
-// the legacy `kb` group (same verbs, `kb` group name), the gate drops, a
-// top-level registrar makes the walk see it, verb-policy rows + skill
-// references land, and gen:commands regenerates - the full CLI change
-// checklist runs THEN, against commands users can actually run.
-//
-// The noun set mirrors the backend's typed descriptors: semantic-model,
-// metric, group. Nested entities/dimensions/measures mutate through
-// `update semantic-model` (a provided list replaces the stored list whole)
-// and are independently readable (`sl entity`, `sl get semantic-model`).
-const NOUNS = ["semantic-model", "metric", "group"];
-const ARG_NOUN = "Semantic-layer noun - semantic-model, metric or group";
-const ARG_NAME = "Asset name (lowercase snake_case), as returned by sl list or sl search";
-function requireNoun(noun) {
-    if (!NOUNS.includes(noun)) {
-        writeStderr(JSON.stringify({
-            error: `Unknown noun '${noun}'. Valid: ${NOUNS.join(", ")}`,
-        }));
-        process.exit(1);
-    }
-    return noun;
-}
-function payloadFromOpts(opts) {
-    if (!opts.file && !opts.json) {
-        writeStderr(JSON.stringify({ error: "Provide the definition via --file <path> or --json <string>" }));
-        process.exit(1);
-    }
-    if (opts.file && opts.json) {
-        writeStderr(JSON.stringify({ error: "--file and --json are mutually exclusive" }));
-        process.exit(1);
-    }
-    const raw = opts.file ? readFileSync(opts.file, "utf-8") : opts.json;
-    try {
-        return JSON.parse(raw);
-    }
-    catch {
-        writeStderr(JSON.stringify({ error: "Definition is not valid JSON" }));
-        process.exit(1);
-    }
-}
-function parseAxes(pairs) {
-    const axes = {};
-    for (const pair of pairs ?? []) {
-        const eq = pair.indexOf("=");
-        if (eq <= 0) {
-            writeStderr(JSON.stringify({ error: `--axis '${pair}' must be key=value` }));
-            process.exit(1);
-        }
-        axes[pair.slice(0, eq)] = pair.slice(eq + 1);
-    }
-    return axes;
-}
-export function registerSlCommands(program) {
-    const sl = program
-        .command("sl")
-        .description("Semantic layer (dbt-native Knowledge Base) - semantic models, metrics, groups");
-    // -- create ---------------------------------------------------------------
-    const create = sl.command("create").description("Create semantic-layer assets");
-    create
-        .command("semantic-model")
-        .description("Create a semantic model from a JSON definition (dbt shape: name, model, " +
-        "entities, dimensions, measures, defaults, group)")
-        .option("--file <path>", "Path to a JSON definition file")
-        .option("--json <string>", "Inline JSON definition")
-        .option("--unverified", "Create as draft instead of verified")
-        .action(async function () {
-        try {
-            const opts = this.opts();
-            const body = {
-                definition: payloadFromOpts(opts),
-                unverified: opts.unverified === true,
-            };
-            console.log(JSON.stringify(await apiClient.post("/api/v1/cli/sl/semantic-model", body)));
-        }
-        catch (err) {
-            errorOutput(err);
-        }
-    });
-    create
-        .command("metric")
-        .description("Create a metric from a JSON definition (type: simple, ratio, derived, " +
-        "cumulative or conversion, with type_params). --family/--axis tag a " +
-        "concrete member of a metric family")
-        .option("--file <path>", "Path to a JSON definition file")
-        .option("--json <string>", "Inline JSON definition")
-        .option("--family <name>", "Metric family this variant belongs to")
-        .option("--axis <key=value...>", "Axis value that generated this variant (repeatable)")
-        .option("--unverified", "Create as draft instead of verified")
-        .action(async function () {
-        try {
-            const opts = this.opts();
-            const definition = payloadFromOpts(opts);
-            if (opts.family) {
-                const meta = (definition.meta ??= {});
-                const graphit = (meta.graphit ??=
-                    {});
-                graphit.family ??= opts.family;
-                const axes = parseAxes(opts.axis);
-                if (Object.keys(axes).length > 0)
-                    graphit.axes ??= axes;
-            }
-            const body = { definition, unverified: opts.unverified === true };
-            console.log(JSON.stringify(await apiClient.post("/api/v1/cli/sl/metric", body)));
-        }
-        catch (err) {
-            errorOutput(err);
-        }
-    });
-    create
-        .command("group")
-        .description("Create a group (the domain analogue; admin only)")
-        .requiredOption("--name <name>", "Group name (lowercase snake_case)")
-        .option("--description <text>", "Group description")
-        .option("--owner-email <email>", "Owning analyst's email")
-        .option("--access <level>", "dbt group access level: private, protected or public")
-        .action(async function () {
-        try {
-            const opts = this.opts();
-            const definition = { name: opts.name };
-            if (opts.description)
-                definition.description = opts.description;
-            if (opts.ownerEmail)
-                definition.owner_email = opts.ownerEmail;
-            if (opts.access)
-                definition.access = opts.access;
-            console.log(JSON.stringify(await apiClient.post("/api/v1/cli/sl/group", { definition })));
-        }
-        catch (err) {
-            errorOutput(err);
-        }
-    });
-    // -- update ---------------------------------------------------------------
-    sl.command("update")
-        .argument("<noun>", ARG_NOUN)
-        .argument("<name>", ARG_NAME)
-        .description("Update an asset with a JSON patch. On semantic-model, a provided " +
-        "entities/dimensions/measures list replaces the stored list whole")
-        .option("--file <path>", "Path to a JSON patch file")
-        .option("--json <string>", "Inline JSON patch")
-        .action(async function (noun, name) {
-        try {
-            requireNoun(noun);
-            const body = { patch: payloadFromOpts(this.opts()) };
-            console.log(JSON.stringify(await apiClient.put(`/api/v1/cli/sl/${noun}/${encodeURIComponent(name)}`, body)));
-        }
-        catch (err) {
-            errorOutput(err);
-        }
-    });
-    // -- delete ---------------------------------------------------------------
-    sl.command("delete")
-        .argument("<noun>", ARG_NOUN)
-        .argument("<name>", ARG_NAME)
-        .description("Delete an asset (requires --yes). Refused while other definitions " +
-        "still reference it")
-        .requiredOption("--yes", "Confirm deletion")
-        .action(async function (noun, name) {
-        try {
-            requireNoun(noun);
-            await apiClient.delete(`/api/v1/cli/sl/${noun}/${encodeURIComponent(name)}`);
-            console.log(JSON.stringify({ status: "deleted", noun, name }));
-        }
-        catch (err) {
-            errorOutput(err);
-        }
-    });
-    // -- reads ----------------------------------------------------------------
-    sl.command("get")
-        .argument("<noun>", ARG_NOUN)
-        .argument("<name>", ARG_NAME)
-        .description("Fetch one asset. Metrics include their family and sibling variants")
-        .action(async function (noun, name) {
-        try {
-            requireNoun(noun);
-            console.log(JSON.stringify(await apiClient.get(`/api/v1/cli/sl/${noun}/${encodeURIComponent(name)}`)));
-        }
-        catch (err) {
-            errorOutput(err);
-        }
-    });
-    sl.command("list")
-        .argument("<noun>", ARG_NOUN)
-        .description("List all visible assets of one noun")
-        .action(async function (noun) {
-        try {
-            requireNoun(noun);
-            console.log(JSON.stringify(await apiClient.get(`/api/v1/cli/sl/${noun}`)));
-        }
-        catch (err) {
-            errorOutput(err);
-        }
-    });
-    sl.command("tree")
-        .description("The whole visible semantic layer: group -> semantic model -> assets, " +
-        "metric families collapsed to one card each")
-        .action(async function () {
-        try {
-            console.log(JSON.stringify(await apiClient.get("/api/v1/cli/sl/tree")));
-        }
-        catch (err) {
-            errorOutput(err);
-        }
-    });
-    sl.command("search")
-        .argument("<query>", "Search text (name or description)")
-        .description("Search semantic models, metrics, groups and nested components")
-        .option("--limit <n>", "Maximum results (default 50)")
-        .action(async function (query) {
-        try {
-            const rawLimit = this.opts().limit;
-            if (rawLimit !== undefined && !/^[1-9]\d*$/.test(rawLimit)) {
-                writeStderr(JSON.stringify({ error: `--limit '${rawLimit}' must be a positive integer` }));
-                process.exit(1);
-            }
-            const limit = rawLimit ? `&limit=${rawLimit}` : "";
-            console.log(JSON.stringify(await apiClient.get(`/api/v1/cli/sl/search?q=${encodeURIComponent(query)}${limit}`)));
-        }
-        catch (err) {
-            errorOutput(err);
-        }
-    });
-    sl.command("entity")
-        .argument("<name>", "Entity name (as declared inside semantic models)")
-        .description("One entity across every visible semantic model that declares it")
-        .action(async function (name) {
-        try {
-            console.log(JSON.stringify(await apiClient.get(`/api/v1/cli/sl/entity/${encodeURIComponent(name)}`)));
-        }
-        catch (err) {
-            errorOutput(err);
-        }
-    });
-    sl.command("family")
-        .argument("<family>", "Metric family name")
-        .description("Expand a metric family; with --axis constraints, resolve to the one " +
-        "concrete member (ambiguity answers with the still-open axes)")
-        .option("--axis <key=value...>", "Axis constraint to resolve against (repeatable)")
-        .action(async function (family) {
-        try {
-            const axes = parseAxes(this.opts().axis);
-            const entries = Object.entries(axes);
-            const encoded = encodeURIComponent(family);
-            const path = entries.length > 0
-                ? `/api/v1/cli/sl/family/${encoded}/resolve?axes=${encodeURIComponent(entries.map(([k, v]) => `${k}=${v}`).join(","))}`
-                : `/api/v1/cli/sl/family/${encoded}`;
-            console.log(JSON.stringify(await apiClient.get(path)));
-        }
-        catch (err) {
-            errorOutput(err);
-        }
-    });
-}
-//# sourceMappingURL=index.js.map

package/dist/commands/sl/index.js.map

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

package/skills/graphit/references/parameterized-metrics.md

@@ -1,77 +0,0 @@
-# Parameterized Metrics
-
-A parameterized metric is a template whose calculation contains `${PARAM:NAME}` tokens (dollar sign and curly braces). Each token maps to a named parameter with a list of values (a value name paired with the SQL fragment it substitutes in). The system auto-generates one validated child variant per combination of values - a ROAS template with REVENUE (9 values) and DN (4 values) produces 36 children.
-
-## When to Parameterize
-
-Parameterize when columns or formulas follow a variant pattern: `total_iap` / `total_iap_new_users` / `estimated_gross_iap` map to one REVENUE parameter; metrics that differ only by a WHERE window (D7, D30, D90) map to one DN parameter. Stay standalone when the metric has no natural variants, has only one or two (template overhead is not worth it), or when variants use fundamentally different formulas.
-
-## Authoring a Template
-
-Put `${PARAM:NAME}` tokens in the calculation, then pass the value map with `--parameters` (inline JSON array) or `--parameters-file <path>` on `graphit kb create metric` / `graphit kb update metric`. Run `graphit kb create metric --help` for the exact flag spelling.
-
-```json
-[
-  {
-    "name": "REVENUE",
-    "values": {"ALL_BOOKINGS": "total_iap", "NEW_BOOKINGS": "total_iap_new_users"},
-    "default_value": "ALL_BOOKINGS"
-  },
-  {
-    "name": "DN",
-    "values": {"D0": "", "D7": "WHERE day <= 7"},
-    "default_value": "D0"
-  }
-]
-```
-
-Paired with a calculation such as `SUM(${PARAM:REVENUE}) / SUM(cost) * 100 ${PARAM:DN}`.
-
-| Rule | Detail |
-|------|--------|
-| Token match | Every `${PARAM:NAME}` token in the calculation needs a matching parameter by name |
-| Empty values | Valid as no-ops (e.g. D0 adds no filter) |
-| Variant cap | Max 1000 (the Cartesian product of all parameter values) |
-| Child naming | Auto-generated as `{PARENT}_{VALUE1}_{VALUE2}` (e.g. ROAS_ALL_BOOKINGS_D7) |
-| Validation | Template create skips per-formula validation (children validate on generation) |
-
-## Editing a Template
-
-All edits go through the parent template; children are read-only. Run a fresh `--parameters` array to change the value sets.
-
-| User intent | Edit action |
-|-------------|-------------|
-| Change formula | Update `--sql` on the template - children re-generate |
-| Add a variant (e.g. D120) | Update `--parameters` with the new value added to the relevant parameter |
-| Remove variants | Update `--parameters` with values removed from the relevant parameter |
-| Change description or topics | Update those fields on the template - no child re-generation |
-
-If the user targets a child for edit or delete, redirect to the parent: "ROAS_ALL_BOOKINGS_D7 is a variant of ROAS. Edit the parent template ROAS instead."
-
-## Using a Variant in a Query
-
-You never substitute tokens by hand. The server resolves a variant when you reference it with the parameter syntax in SQL.
-
-1. Find the template. `graphit kb list metric` shows the collapsed inventory - templates and flat metrics only, never child variants - with a `params` column (the required parameter names, e.g. `REVENUE, DN`) and a `variant_count`; an empty `params` cell means the metric is flat. To enumerate a template's concrete variants, `graphit kb explore metric NAME`; reach for `graphit kb list metric --include-variants` only when you truly need every child row flat.
-2. Map the user's words to parameter values: "D7 ROAS for new users" maps to `REVENUE=NEW_BOOKINGS` and `DN=D7`.
-3. Reference it with `{{metric:NAME(K=V)}}` in the query SQL, e.g. `{{metric:ROAS(REVENUE=NEW_BOOKINGS, DN=D7)}}`. The server expands it to the pre-validated child calculation at query time.
-
-```bash
-graphit query "SELECT {{dim:INSTALL_MONTH}}, {{metric:ROAS(REVENUE=NEW_BOOKINGS, DN=D7)}} AS roas FROM MARKETING_UA_DS GROUP BY 1" --ds MARKETING_UA_DS --verbose
-```
-
-Defaults and errors:
-- Omitting a parameter on a required metric returns a clear error naming the parameter and the valid values. Retry with a value or ask the user which one they meant.
-- A pre-baked variant (ROAS_D7, ARPU_D30) has its value hardcoded in the name, so reference it plainly as `{{metric:ROAS_D7}}` with no parameter clause. Find its exact name via `graphit kb explore metric ROAS` (lists the variants) or `graphit kb list metric --include-variants` - the collapsed `kb list` does not show child variant names.
-
-## Contrast: Wrong vs Right
-
-| Wrong | Right |
-|-------|-------|
-| Replace `${PARAM:REVENUE}` with `total_iap` by hand and put that in the query SQL | Reference `{{metric:ROAS(REVENUE=ALL_BOOKINGS, DN=D7)}}` and let the server expand the validated child |
-| Create ROAS_ALL_BOOKINGS and ROAS_NEW_BOOKINGS as separate standalone metrics | Create one ROAS template with a REVENUE parameter |
-| Edit ROAS_ALL_BOOKINGS_D7 directly | Edit the parent ROAS template instead |
-
-## Delete and Verify
-
-Deleting the parent cascade-deletes every child; the blast radius includes all children plus their downstream references (graphs, rules, synonyms), so confirm before deleting. Verifying the parent sets `verified=true` on the parent and every child at once.