@graphit/cli 0.2.322 → 0.2.323

package/skills/graphit/references/presentations.md

@@ -77,7 +77,7 @@ deck.slide({
   html: `
     <h2>Live Data</h2>
     <div data-graphit-id="spend-chart" data-graphit-label="Ad Spend"
-         data-graphit-sql="SELECT {{dim:MEDIA_SOURCE_DIMENSION}} AS source, {{metric:TOTAL_AD_SPEND}} AS spend FROM MARKETING_UA_DS GROUP BY 1 ORDER BY spend DESC LIMIT 6"
+         data-graphit-sql="SELECT {{ Dimension('campaign__media_source') }} AS source, {{ Metric('total_ad_spend') }} AS spend FROM MARKETING_UA_DS GROUP BY 1 ORDER BY spend DESC LIMIT 6"
          data-graphit-ds="MARKETING_UA_DS">
       <div id="chart1" class="gh-loading">
         <div class="gh-loading-overlay"><svg class="gh-loading-spin" width="24" height="24" viewBox="0 0 24 24" fill="none"><circle cx="12" cy="12" r="10" stroke="#e5e5e5" stroke-width="2.5"/><path d="M12 2a10 10 0 0 1 10 10" stroke="#4DB6AC" stroke-width="2.5" stroke-linecap="round"/></svg></div>

package/skills/graphit/references/runtime.md

@@ -30,7 +30,7 @@ const result = await graphit.resolve({
 
 MUST: every resolve feeding a rendered graph, KPI, or table carries attribution - `target` (the entity wrapper or an element inside it), or `sourceEntityId` plus `targetEntityIds` when one result feeds several graphs. Attribution records the live filtered query behind that entity's details panel; unattributed, the panel shows `data-graphit-sql` as an unrun example, so a user changing a filter sees the SQL never move. Saving a page with filters or params and zero attributed resolves returns an `unattributed_resolves` warning. Queries feeding page chrome need no attribution and no entity, but belong on the primitives - `graphit.cascade` for option lists, `graphit.dataBounds` for a column's min/max, `graphit.rank` for top-N (`filters-advanced.md`) - never hand-written entity-less SQL.
 
-CRITICAL: use KB reference syntax (`{{metric:NAME}}`, `{{dim:NAME}}`) inside the entity's `data-graphit-sql` whenever a KB asset exists - the server expands it at query time, producing the governed trust tier. Syntax and trust tiers: `governance.md`.
+CRITICAL: use `{{ Metric('name') }}`, `{{ Dimension('entity__name') }}`, or Graphit's `{{ Measure('name') }}` extension inside `data-graphit-sql` whenever the semantic asset exists. The server expands it into the governed tier. See `governance.md`.
 
 Error handling: `graphit.resolve()` rejects on timeout (120s), bad SQL, or an invalid data source ID. Wrap calls in try/catch and show a user-visible error in the target element on failure. Verify the SQL returns data via the CLI before embedding it.
 
@@ -41,7 +41,7 @@ Every visible element - chart, KPI card, table, text section - must be wrapped s
 ```html
 <div data-graphit-id="revenue-trend"
      data-graphit-label="Revenue Trend"
-     data-graphit-sql="SELECT {{dim:REGION}} AS region, {{metric:REVENUE}} AS revenue FROM ORDERS_DS GROUP BY region"
+     data-graphit-sql="SELECT {{ Dimension('order__region') }} AS region, {{ Metric('revenue') }} AS revenue FROM ORDERS_DS GROUP BY region"
      data-graphit-ds="ORDERS_DS">
   <!-- chart, KPI, or table content here -->
 </div>
@@ -55,7 +55,7 @@ Every visible element - chart, KPI card, table, text section - must be wrapped s
 | `data-graphit-ds` | Data source name (same as the FROM table) or id | `"ORDERS_DS"` |
 | `data-graphit-state` | Not an entity attribute - a SIBLING wrapper around a user-changeable control, naming the state key saved views capture (`filters.md`) | `"country"` |
 
-KB asset references are derived automatically from `{{metric:X}}` / `{{dim:X}}` in the SQL; the governance compiler resolves these and shows KB asset chips in the details panel. Missing any one attribute breaks the entity; missing the wrapper makes the element invisible to the platform.
+Semantic references are derived automatically from the final grammar; the compiler resolves them and shows asset chips in the details panel. Missing any one attribute breaks the entity; missing the wrapper makes the element invisible to the platform.
 
 **JavaScript may populate an entity, never create one.** Every entity - including on hidden tabs, collapsed panels, and lazily-shown views - exists as static markup in the HTML you save; JavaScript fills its chart host, wires listeners, and toggles visibility. Nothing server-side runs your JavaScript, so a card built at render time (`host.innerHTML = charts.map(...)`) does not exist for governance, lineage, the KB graph, `list-entities`, or a later `get-entity`. A save whose `data-graphit-id`s are reachable only by running your JavaScript is REFUSED and the error names them. A dynamic **query** is supported - the attribute carries the canonical template; a dynamic **entity** is not.
 
@@ -74,14 +74,14 @@ A filtered entity uses `graphit.bind(el, { params, deps, render })` (`filters.md
 
 ```html
 <div data-graphit-id="explorer" data-graphit-label="Metric Explorer" data-graphit-ds="UA_DS"
-     data-graphit-sql="SELECT day, {{metric:ROAS}} AS roas FROM UA_DS GROUP BY 1"
-     data-graphit-vocab="metric:REV*,metric:ROAS,dim:COUNTRY"></div>
+     data-graphit-sql="SELECT day, {{ Metric('roas') }} AS roas FROM UA_DS GROUP BY 1"
+     data-graphit-vocab="metric:revenue,metric:roas,dimension:campaign__country"></div>
 ```
 ```js
 graphit.resolve({ sql: buildSql(picked), dataSourceId: "UA_DS", runtimeComposed: true, sourceEntityId: "explorer" });
 ```
 
-`metric:NAME` / `dim:NAME`, UPPER_SNAKE_CASE, one optional trailing `*` per family; a space instead of a comma is one malformed entry. Declare the family, not today's SQL - but every name must exist (an unknown name, a wildcard matching nothing, or a bare `metric:*` refuses), and wildcards alone add no lineage. Undeclared inline SQL is invisible to lineage and governance; a save that ADDS one is refused, and existing ones are not a defect to fix - move a query onto its entity only when asked (`migration.md`).
+Use comma-separated lowercase declarations such as `metric:revenue`, `dimension:order__region`, and `measure:order_total`. Every declared name must exist; unknown names and wildcards refuse. Undeclared inline SQL is invisible to lineage and governance. Existing runtime-composed queries are first-class, not debt; migrate query ownership only when asked (`migration.md`).
 
 **Label equals the visible title.** `data-graphit-label` MUST match the card's visible heading exactly - users find their chart by that label in @ mention dropdowns and entity panels, and a mismatch means they cannot find it.
 

package/skills/graphit/references/semantic-authoring.md

@@ -0,0 +1,65 @@
+# Semantic Authoring
+
+Load when creating or changing semantic models or metrics.
+
+## Syntax boundary
+
+Graphit accepts the MetricFlow 0.211 execution shape: semantic models contain
+entities, dimensions, and measures; metrics are top-level objects with `type`
+and `type_params`. Do not emit newer measureless/Fusion authoring syntax, dbt
+project YAML, Jinja, `ref()` expressions, or source declarations on this
+surface. Those belong to dbt project import/export, not Graphit authoring.
+
+Public dbt/MetricFlow concepts:
+
+- semantic model, entity, dimension, measure, metric, and group
+- simple, ratio, and derived metric composition
+- entity-qualified dimension paths
+
+Graphit extensions and assets:
+
+- `meta.graphit.family` and `axes` group concrete metric variants
+- topics are curated Graphit metadata, deliberately not dbt `tags`
+- rules are separate Graphit objects targeting semantic identities by name;
+  never embed them in dbt metadata
+- verification attribution, provenance, and data-source bindings are
+  server-owned; use dedicated actions instead of hand-authoring them
+
+Do not expose or depend on storage collection names, revision fields, feature
+flags, cache keys, or compiler implementation details.
+
+## Semantic model
+
+A semantic model owns:
+
+- lowercase name and physical model/binding
+- group placement
+- primary grain/entity
+- entities for joins
+- dimensions for grouping/filtering
+- measures for aggregation input
+- defaults such as aggregation time dimension
+
+Measure-bearing models need a valid aggregation time dimension. Primary/unique entity claims require grain evidence; never guess uniqueness. Time-aware shapes require the platform time-spine prerequisite.
+
+Nested lists replace whole lists on update. Read the model and preserve every sibling.
+
+## Metrics
+
+Only these shapes are served by the shipping fragment path:
+
+- **simple:** one measure object
+- **ratio:** numerator and denominator metric objects
+- **derived:** expression over declared metric inputs or aliases
+
+Metric-level and per-input filters must resolve through declared semantic identities. Bare strings where an input object is required are refused.
+
+Cumulative, conversion, shifted inputs, time-spine joins, and null-fill are unavailable until Project #289. Use a supported decomposition or clearly labeled free SQL; do not create an unusable governed definition.
+
+## Verification
+
+Create defaults to verified on human-driven CLI paths; `--unverified` creates a draft. Promote or demote with dedicated verify/unverify actions. Never replace `meta` only to toggle verification.
+
+## Final check
+
+Re-read the root, verify nested completeness, inspect group/binding, and use the returned receipt. A degraded freshness result may mean the write landed; do not retry blindly.

package/skills/graphit/references/sql-reference.md

@@ -1,6 +1,6 @@
 # SQL Reference
 
-Consult when writing queries. Data source queries (`graphit query --ds`) always run DuckDB. Warehouse queries (`graphit query --warehouse`) run the connected warehouse - Snowflake or BigQuery - and the dialect follows the connection type; governance parses your SQL in that dialect. You MUST use the correct dialect. To read a table's columns, use `graphit kb explore table <NAME>` - never `DESCRIBE`/DDL (`graphit query` runs SELECT only).
+Consult when writing queries. Data-source queries run DuckDB. Warehouse queries run the connected Snowflake or BigQuery dialect. Governance parses the same dialect. Read physical columns through metadata discovery or semantic-model physical detail; never use DDL through the SELECT-only query surface.
 
 ## DuckDB vs Snowflake Translation
 
@@ -138,22 +138,20 @@ The canvas `percent` format only appends `%` (it does not multiply by 100), so m
 
 ## Presenting Query Results
 
-After every `graphit query`, present results grounded in the KB. Always show which KB assets were used - this is what makes governed queries valuable.
-
-**When using KB reference syntax** (`{{metric:X}}`, `{{dim:X}}`), show all five sections:
+After every query, show all five sections below. Use `--verbose` to obtain the resolved SQL. Executable SQL uses semantic references; narration uses backticked exact asset names so Graphit can render clickable KB pills.
 
 ~~~
-**KB Assets:** dimension **CAMPAIGN_CATEGORY**, metric **TOTAL_INSTALLS**, metric **CPI**, table **MARKETING_UA_DS**
+**KB Assets:** dimension `campaign__category`, metrics `total_installs` and `cpi`, semantic model `marketing_ua`
 
 **Query:**
 ```sql
 SELECT
-    {{dim:CAMPAIGN_CATEGORY}} AS category,
-    {{metric:TOTAL_INSTALLS}} AS installs,
-    {{metric:CPI}} AS cpi
+    {{ Dimension('campaign__category') }} AS category,
+    {{ Metric('total_installs') }} AS installs,
+    {{ Metric('cpi') }} AS cpi
 FROM MARKETING_UA_DS
 WHERE ACTIVITY_TIME >= '2026-01-01'
-GROUP BY {{dim:CAMPAIGN_CATEGORY}}
+GROUP BY {{ Dimension('campaign__category') }}
 ORDER BY installs DESC
 ```
 
@@ -179,17 +177,9 @@ ORDER BY installs DESC
 | Retargeting | 12,300 | $1.24 |
 | Connected TV | 3,100 | $2.80 |
 
-**Governance:** governed - 3 KB refs, 2 rules enforced (**EXCLUDE_ORGANIC**, **MIN_SPEND**). Max rows: 1,000.
-~~~
-
-**When using inline SQL** (no `{{metric:X}}`), present it the same way (query + results + governance), but the footer states the ad-hoc tier and offers the governed rewrite:
-
-~~~
-**Governance:** ad-hoc - 0 KB refs. Consider using `{{metric:TOTAL_SPEND}}` for governed tier.
+**Governance:** governed - 3 semantic refs; 2 rules enforced (`exclude_organic`, `min_spend`). Max rows: 1,000.
 ~~~
 
-Any ad-hoc query on the CLI is withheld until you justify it (full rules in governance.md): prefer a `{{metric:X}}` / `{{dim:X}}` rewrite, creating the metric or dimension first if it is missing, and pass `--adhoc-reason` only when nothing governed fits.
-
-**Always use `--verbose`** to get the resolved SQL; if the user didn't pass it, re-run with it.
+For inline SQL, use the same sections but state the ad-hoc tier and offer a governed rewrite, for example: **Governance:** ad-hoc - 0 semantic refs. Consider `{{ Metric('total_spend') }}`. Author a supported root definition first when needed; provide an ad-hoc reason only when nothing governed fits.
 
-Zero rows: explain what you checked and hypothesize why (wrong date range, filter too strict, table empty).
+For zero rows, explain the checks performed and likely cause, such as date range, filter, or empty source.

package/dist/commands/kb-constraints.d.ts

@@ -1,14 +0,0 @@
-/**
- * Pure parsers for `graphit kb create/update rule` --constraint / --apply-on flags.
- *
- * Extracted from kb.ts so they are unit-testable without Commander or the API
- * client (mirrors query-timeout.ts). Issue #548: the required_where quote
- * stripper used to remove ANY leading/trailing quote, so a predicate ending in
- * a SQL string literal lost its closing quote
- * (`MEDIA_SOURCE != 'organic'` -> `MEDIA_SOURCE != 'organic`), producing
- * unparseable SQL that the backend rejected - the constraint never persisted.
- */
-/** Strip wrapping quotes only when the value is wrapped in a matched pair. */
-export declare function unwrapQuotes(value: string): string;
-export declare function parseConstraintFlags(specs: string[]): Record<string, unknown>[];
-export declare function parseApplyOnFlags(specs: string[]): Record<string, string>[];

package/dist/commands/kb-constraints.js

@@ -1,53 +0,0 @@
-/**
- * Pure parsers for `graphit kb create/update rule` --constraint / --apply-on flags.
- *
- * Extracted from kb.ts so they are unit-testable without Commander or the API
- * client (mirrors query-timeout.ts). Issue #548: the required_where quote
- * stripper used to remove ANY leading/trailing quote, so a predicate ending in
- * a SQL string literal lost its closing quote
- * (`MEDIA_SOURCE != 'organic'` -> `MEDIA_SOURCE != 'organic`), producing
- * unparseable SQL that the backend rejected - the constraint never persisted.
- */
-/** Strip wrapping quotes only when the value is wrapped in a matched pair. */
-export function unwrapQuotes(value) {
-    const first = value[0];
-    if (value.length >= 2 &&
-        (first === '"' || first === "'") &&
-        value[value.length - 1] === first) {
-        return value.slice(1, -1);
-    }
-    return value;
-}
-export function parseConstraintFlags(specs) {
-    return specs.map((spec) => {
-        const colonIdx = spec.indexOf(":");
-        if (colonIdx < 0)
-            throw new Error(`Invalid constraint: "${spec}". Use type:value (e.g., forbidden_column:email)`);
-        const type = spec.slice(0, colonIdx);
-        const value = spec.slice(colonIdx + 1);
-        switch (type) {
-            case "required_where":
-                return { type, predicate: unwrapQuotes(value) };
-            case "forbidden_column":
-            case "required_filter":
-            case "required_aggregation":
-                return { type, column: value };
-            case "value_restriction": {
-                const [col, op, ...valueParts] = value.split(":");
-                const operator = op === "not_in" ? "not_in" : "in";
-                return { type, column: col, values: valueParts.join(":").split(","), operator };
-            }
-            default:
-                throw new Error(`Unknown constraint type: "${type}"`);
-        }
-    });
-}
-export function parseApplyOnFlags(specs) {
-    return specs.map((spec) => {
-        const colonIdx = spec.indexOf(":");
-        if (colonIdx < 0)
-            throw new Error(`Invalid apply-on: "${spec}". Use type:NAME (e.g., table:USERS)`);
-        return { type: spec.slice(0, colonIdx), name: spec.slice(colonIdx + 1) };
-    });
-}
-//# sourceMappingURL=kb-constraints.js.map

package/dist/commands/kb-constraints.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"kb-constraints.js","sourceRoot":"","sources":["../../src/commands/kb-constraints.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,8EAA8E;AAC9E,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACvB,IACE,KAAK,CAAC,MAAM,IAAI,CAAC;QACjB,CAAC,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,GAAG,CAAC;QAChC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,KAAK,EACjC,CAAC;QACD,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC5B,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAe;IAClD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACxB,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,QAAQ,GAAG,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,IAAI,kDAAkD,CAAC,CAAC;QAClH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;QACrC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;QACvC,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,gBAAgB;gBACnB,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;YAClD,KAAK,kBAAkB,CAAC;YACxB,KAAK,iBAAiB,CAAC;YACvB,KAAK,sBAAsB;gBACzB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;YACjC,KAAK,mBAAmB,CAAC,CAAC,CAAC;gBACzB,MAAM,CAAC,GAAG,EAAE,EAAE,EAAE,GAAG,UAAU,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBAClD,MAAM,QAAQ,GAAG,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;gBACnD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,CAAC;YAClF,CAAC;YACD;gBACE,MAAM,IAAI,KAAK,CAAC,6BAA6B,IAAI,GAAG,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAe;IAC/C,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACxB,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,QAAQ,GAAG,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,IAAI,sCAAsC,CAAC,CAAC;QACpG,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,EAAE,CAAC;IAC3E,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/commands/kb-create.d.ts

@@ -1,2 +0,0 @@
-import { Command } from "commander";
-export declare function addKBCreateCommands(kb: Command): void;

package/dist/commands/kb-create.js

@@ -1,296 +0,0 @@
-import { readFile } from "node:fs/promises";
-import { apiClient } from "../api/client.js";
-import { output, errorOutput, getOutputFormat } from "../output/format.js";
-import { writeStderr } from "../stderr.js";
-import { styledIntro, styledOutro, styledSuccess, formatBold, } from "../output/styled.js";
-import { parseConstraintFlags, parseApplyOnFlags } from "./kb-constraints.js";
-import { renderValidation, renderVisibility, withVisibility, } from "./kb-shared.js";
-// Project #254 Phase 1: kb create verbs (metric/dimension/rule/domain/synonym/
-// relationship/topic/template). Tables are created from data sources.
-export function addKBCreateCommands(kb) {
-    const create = kb
-        .command("create")
-        .description("Create KB entities. Tables are created from data sources - use 'graphit ds create'.");
-    create
-        .command("metric")
-        .description("Create a new metric")
-        .requiredOption("--name <name>", "Metric name (UPPER_SNAKE_CASE)")
-        .requiredOption("--sql <expr>", "SQL calculation expression")
-        .requiredOption("--table <table>", "Primary table")
-        .option("--description <desc>", "Business meaning of the metric - what it counts and when to use it", "")
-        .option("--topics <topics>", "Comma-separated topic names")
-        .option("--default-dimensions <dims>", "Comma-separated dimension names this metric naturally groups by")
-        .option("--parameters <json>", "JSON array of parameter definitions")
-        .option("--parameters-file <path>", "Read parameters JSON from file")
-        .option("--skip-validate", "Skip pre-creation data validation")
-        .option("--unverified", "Create as a draft instead of verified (default: verified)")
-        .action(async function () {
-        try {
-            const opts = this.opts();
-            const fmt = getOutputFormat(this);
-            const topics = opts.topics ? opts.topics.split(",").map((s) => s.trim()).filter(Boolean) : [];
-            const defaultDimensions = opts.defaultDimensions ? opts.defaultDimensions.split(",").map((s) => s.trim()).filter(Boolean) : [];
-            let parameters = [];
-            if (opts.parametersFile) {
-                parameters = JSON.parse(await readFile(opts.parametersFile, "utf-8"));
-            }
-            else if (opts.parameters) {
-                parameters = JSON.parse(opts.parameters);
-            }
-            const skipValidate = opts.skipValidate ? "true" : "false";
-            const resp = await apiClient.post(`/api/v1/cli/kb/metric?skip_validate=${skipValidate}`, {
-                name: opts.name,
-                calculation: opts.sql,
-                table: opts.table,
-                description: opts.description,
-                topics,
-                default_dimensions: defaultDimensions,
-                parameters,
-                unverified: Boolean(opts.unverified),
-            });
-            if (fmt === "styled") {
-                styledIntro(`graphit kb create metric`);
-                styledSuccess(`Metric ${formatBold(String(resp.entity.name))} created`);
-                renderValidation(this, resp);
-                renderVisibility(this, resp);
-                styledOutro();
-            }
-            else {
-                const out = withVisibility(this, { ...resp.entity }, resp);
-                if (resp.validation)
-                    out.validation = resp.validation;
-                output(this, out, { keyValue: true });
-            }
-        }
-        catch (err) {
-            errorOutput(err);
-        }
-    });
-    create
-        .command("dimension")
-        .description("Create a new dimension")
-        .requiredOption("--name <name>", "Dimension name (UPPER_SNAKE_CASE)")
-        .requiredOption("--expr <expr>", "SQL expression")
-        .requiredOption("--table <table>", "Primary table")
-        .option("--type <type>", "Semantic type: categorical, temporal, quantitative, boolean, geographic (auto-inferred if omitted)")
-        .option("--output-type <outputType>", "SQL output type: VARCHAR, NUMBER, BOOLEAN, DATE, TIMESTAMP (auto-inferred if omitted)")
-        .option("--description <desc>", "Business meaning of the dimension - what it slices and when to use it", "")
-        .option("--topics <topics>", "Comma-separated topic names")
-        .option("--skip-validate", "Skip pre-creation data validation")
-        .option("--unverified", "Create as a draft instead of verified (default: verified)")
-        .action(async function () {
-        try {
-            const opts = this.opts();
-            const fmt = getOutputFormat(this);
-            const topics = opts.topics ? opts.topics.split(",").map((s) => s.trim()).filter(Boolean) : [];
-            const body = {
-                name: opts.name,
-                expression: opts.expr,
-                table: opts.table,
-                description: opts.description,
-                topics,
-                unverified: Boolean(opts.unverified),
-            };
-            if (opts.type)
-                body.semantic_type = opts.type;
-            if (opts.outputType)
-                body.output_type = opts.outputType;
-            const skipValidate = opts.skipValidate ? "true" : "false";
-            const resp = await apiClient.post(`/api/v1/cli/kb/dimension?skip_validate=${skipValidate}`, body);
-            if (fmt === "styled") {
-                styledIntro(`graphit kb create dimension`);
-                styledSuccess(`Dimension ${formatBold(String(resp.entity.name))} created`);
-                renderValidation(this, resp);
-                renderVisibility(this, resp);
-                styledOutro();
-            }
-            else {
-                const out = withVisibility(this, { ...resp.entity }, resp);
-                if (resp.validation)
-                    out.validation = resp.validation;
-                output(this, out, { keyValue: true });
-            }
-        }
-        catch (err) {
-            errorOutput(err);
-        }
-    });
-    create
-        .command("rule")
-        .description("Create a new rule. Without --apply-on the rule governs the whole --table, which cascades to every metric and dimension on it. Use --apply-on metric:NAME / dimension:NAME to govern only specific assets instead. A rule must apply to at least one asset (targetless rules are rejected).")
-        .requiredOption("--name <name>", "Rule name (UPPER_SNAKE_CASE)")
-        .requiredOption("--sql <expr>", "Rule content/SQL")
-        .requiredOption("--table <table>", "Table the rule is about (validation context, and the whole-table target unless --apply-on narrows it)")
-        .option("--description <desc>", "What the rule enforces and why it exists", "")
-        .option("--topics <topics>", "Comma-separated topic names")
-        .option("--constraint <spec...>", "Enforceable constraints (e.g., required_where:\"x=1\" forbidden_column:email)")
-        .option("--enforcement-mode <mode>", "Rule enforcement: advisory|always|conditional")
-        .option("--apply-on <targets...>", "What the rule governs. Omit to govern the whole --table (cascades to every metric/dimension on it). Use metric:NAME / dimension:NAME to govern only those assets. Cannot mix a table target with metric/dimension targets.")
-        .option("--skip-validate", "Skip pre-creation data validation")
-        .option("--unverified", "Create as a draft instead of verified (default: verified)")
-        .action(async function () {
-        try {
-            const opts = this.opts();
-            const fmt = getOutputFormat(this);
-            const topics = opts.topics ? opts.topics.split(",").map((s) => s.trim()).filter(Boolean) : [];
-            const constraints = opts.constraint ? parseConstraintFlags(opts.constraint) : undefined;
-            const applyOn = opts.applyOn ? parseApplyOnFlags(opts.applyOn) : undefined;
-            const skipValidate = opts.skipValidate ? "true" : "false";
-            const resp = await apiClient.post(`/api/v1/cli/kb/rule?skip_validate=${skipValidate}`, {
-                name: opts.name,
-                content: opts.sql,
-                table: opts.table,
-                description: opts.description,
-                topics,
-                constraints,
-                enforcement_mode: opts.enforcementMode,
-                apply_on: applyOn,
-                unverified: Boolean(opts.unverified),
-            });
-            if (fmt === "styled") {
-                styledIntro(`graphit kb create rule`);
-                styledSuccess(`Rule ${formatBold(String(resp.entity.name))} created`);
-                renderValidation(this, resp);
-                renderVisibility(this, resp);
-                styledOutro();
-            }
-            else {
-                const out = withVisibility(this, { ...resp.entity }, resp);
-                if (resp.validation)
-                    out.validation = resp.validation;
-                output(this, out, { keyValue: true });
-            }
-        }
-        catch (err) {
-            errorOutput(err);
-        }
-    });
-    create
-        .command("domain")
-        .description("Create a new domain")
-        .requiredOption("--name <name>", "Domain name (UPPER_SNAKE_CASE)")
-        .option("--description <desc>", "What this domain covers - the business area its tables and assets belong to", "")
-        .option("--color <hex>", "Hex color for UI", "#4DB6AC")
-        .action(async function () {
-        try {
-            const opts = this.opts();
-            const resp = await apiClient.post("/api/v1/cli/kb/domain", {
-                name: opts.name,
-                description: opts.description,
-                color: opts.color,
-            });
-            output(this, resp.entity, { keyValue: true });
-        }
-        catch (err) {
-            errorOutput(err);
-        }
-    });
-    create
-        .command("synonym")
-        .description("Create a new synonym")
-        .requiredOption("--term <term>", "Synonym term (e.g., GMV)")
-        .requiredOption("--canonical <name>", "Canonical asset name (e.g., TOTAL_REVENUE)")
-        .requiredOption("--type <type>", "Canonical type: metric, column, or table")
-        .option("--description <desc>", "When this synonym applies - the phrasing users say for the canonical asset", "")
-        .option("--unverified", "Create as a draft instead of verified (default: verified)")
-        .action(async function () {
-        try {
-            const opts = this.opts();
-            const resp = await apiClient.post("/api/v1/cli/kb/synonym", {
-                term: opts.term,
-                canonical: opts.canonical,
-                canonical_type: opts.type,
-                description: opts.description,
-                unverified: Boolean(opts.unverified),
-            });
-            renderVisibility(this, resp);
-            output(this, withVisibility(this, { ...resp.entity }, resp), { keyValue: true });
-        }
-        catch (err) {
-            errorOutput(err);
-        }
-    });
-    create
-        .command("relationship")
-        .description("Create a new relationship (JOIN between tables)")
-        .requiredOption("--name <name>", "Relationship name (e.g., ORDERS_TO_CUSTOMERS)")
-        .requiredOption("--primary-table <table>", "Primary table")
-        .requiredOption("--primary-column <col>", "Primary column")
-        .requiredOption("--related-table <table>", "Related table")
-        .requiredOption("--related-column <col>", "Related column")
-        .option("--description <desc>", "What this join represents in the business", "")
-        .action(async function () {
-        try {
-            const opts = this.opts();
-            const resp = await apiClient.post("/api/v1/cli/kb/relationship", {
-                name: opts.name,
-                primary_table: opts.primaryTable,
-                primary_column: opts.primaryColumn,
-                related_table: opts.relatedTable,
-                related_column: opts.relatedColumn,
-                description: opts.description,
-            });
-            renderVisibility(this, resp);
-            output(this, withVisibility(this, { ...resp.entity }, resp), { keyValue: true });
-        }
-        catch (err) {
-            errorOutput(err);
-        }
-    });
-    create
-        .command("topic")
-        .description("Create a new topic (business-concept tag)")
-        .requiredOption("--name <name>", "Topic name (UPPER_SNAKE_CASE)")
-        .option("--description <desc>", "What this topic tags - the business concept its assets share", "")
-        .action(async function () {
-        try {
-            const opts = this.opts();
-            const resp = await apiClient.post("/api/v1/cli/kb/topic", {
-                name: opts.name,
-                description: opts.description,
-            });
-            output(this, resp.entity, { keyValue: true });
-        }
-        catch (err) {
-            errorOutput(err);
-        }
-    });
-    create
-        .command("template")
-        .description("Create a reusable template (chart, KPI, or filter control)")
-        .requiredOption("--name <name>", "Template name (UPPER_SNAKE_CASE)")
-        .option("--render-code <code>", "JS function body for rendering")
-        .option("--file <path>", "Read render code from a local file")
-        .option("--description <desc>", "What the template renders and when to reach for it", "")
-        .option("--chart-types <types>", "Related chart types (comma-separated)", "")
-        .action(async function () {
-        try {
-            const opts = this.opts();
-            let renderCode;
-            if (opts.file) {
-                renderCode = await readFile(opts.file, "utf-8");
-            }
-            else if (opts.renderCode) {
-                renderCode = opts.renderCode;
-            }
-            else {
-                writeStderr(JSON.stringify({ error: "Provide --render-code or --file" }));
-                process.exit(1);
-            }
-            const chartTypes = opts.chartTypes
-                ? opts.chartTypes.split(",").map((s) => s.trim()).filter(Boolean)
-                : [];
-            const resp = await apiClient.post("/api/v1/cli/kb/template", {
-                name: opts.name,
-                render_code: renderCode,
-                description: opts.description,
-                chart_types: chartTypes,
-            });
-            output(this, resp.entity, { keyValue: true });
-        }
-        catch (err) {
-            errorOutput(err);
-        }
-    });
-}
-//# sourceMappingURL=kb-create.js.map

package/dist/commands/kb-create.js.map

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

package/dist/commands/kb-delete.d.ts

@@ -1,2 +0,0 @@
-import { Command } from "commander";
-export declare function addKBDeleteCommands(kb: Command): void;

package/dist/commands/kb-delete.js

@@ -1,37 +0,0 @@
-import { apiClient } from "../api/client.js";
-import { errorOutput } from "../output/format.js";
-import { writeStderr } from "../stderr.js";
-import { KB_ARG_TYPE, KB_ARG_NAME } from "./kb-shared.js";
-// Project #254 Phase 1: kb delete verb.
-export function addKBDeleteCommands(kb) {
-    kb.command("delete")
-        .argument("<type>", KB_ARG_TYPE)
-        .argument("<name>", KB_ARG_NAME)
-        .description("Delete a KB entity (requires --yes flag)")
-        .requiredOption("--yes", "Confirm deletion")
-        // Project #272 F-6: a private asset belonging to another member can block a
-        // shared asset's delete, and the refusal names who to ask. --force is the
-        // other half of that: it proceeds anyway, and the backend notifies them.
-        // Deliberately NOT a second confirmation prompt (founder decision 4) - --yes
-        // already covers the destructive action, and a second gate teaches people to
-        // click through gates.
-        .option("--force", "Delete even though another member's private asset blocks it")
-        .action(async function (type, name) {
-        try {
-            const validTypes = ["metric", "dimension", "rule", "template", "synonym", "domain", "relationship", "topic"];
-            if (!validTypes.includes(type)) {
-                writeStderr(JSON.stringify({
-                    error: `Delete not supported for '${type}'. Supported: ${validTypes.join(", ")}`,
-                }));
-                process.exit(1);
-            }
-            const force = this.opts().force === true;
-            await apiClient.delete(`/api/v1/cli/kb/${type}/${encodeURIComponent(name)}${force ? "?force=true" : ""}`);
-            console.log(JSON.stringify({ status: "deleted", type, name: name.toUpperCase(), ...(force ? { forced: true } : {}) }));
-        }
-        catch (err) {
-            errorOutput(err);
-        }
-    });
-}
-//# sourceMappingURL=kb-delete.js.map

package/dist/commands/kb-delete.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"kb-delete.js","sourceRoot":"","sources":["../../src/commands/kb-delete.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE1D,wCAAwC;AAExC,MAAM,UAAU,mBAAmB,CAAC,EAAW;IAC7C,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC;SACjB,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;SAC/B,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;SAC/B,WAAW,CAAC,0CAA0C,CAAC;SACvD,cAAc,CAAC,OAAO,EAAE,kBAAkB,CAAC;QAC5C,4EAA4E;QAC5E,0EAA0E;QAC1E,yEAAyE;QACzE,6EAA6E;QAC7E,6EAA6E;QAC7E,uBAAuB;SACtB,MAAM,CAAC,SAAS,EAAE,6DAA6D,CAAC;SAChF,MAAM,CAAC,KAAK,WAA0B,IAAY,EAAE,IAAY;QAC/D,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,CAAC,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,EAAE,OAAO,CAAC,CAAC;YAC7G,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC/B,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC;oBACzB,KAAK,EAAE,6BAA6B,IAAI,iBAAiB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;iBACjF,CAAC,CAAC,CAAC;gBACJ,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YACD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC;YACzC,MAAM,SAAS,CAAC,MAAM,CACpB,kBAAkB,IAAI,IAAI,kBAAkB,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,EAAE,CAClF,CAAC;YACF,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACzH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,WAAW,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/kb-read.d.ts

@@ -1,2 +0,0 @@
-import { Command } from "commander";
-export declare function addKBReadCommands(kb: Command): void;