@kernhq/module-tracker 0.1.0

package/dist/kql/validate.js

@@ -0,0 +1,84 @@
+import { walkComparisons } from './ast.js';
+import { findField, KQL_FUNCTIONS, operatorsFor } from './fields.js';
+const FUNCTIONS = new Map(KQL_FUNCTIONS.map((f) => [f.name.toLowerCase(), f]));
+const argCountOk = (spec, got) => typeof spec === 'number' ? got === spec : spec === '0-1' ? got <= 1 : true;
+/** Semantic checks: known fields, operators the field supports, plausible values, known functions. */
+export function validateQuery(query, fields) {
+    const issues = [];
+    walkComparisons(query.where, (cmp) => issues.push(...checkComparison(cmp, fields)));
+    for (const order of query.orderBy) {
+        const field = findField(fields, order.field);
+        if (!field) {
+            issues.push({ message: `Unknown field "${order.field}"`, ...order.span });
+            continue;
+        }
+        // only fields explicitly marked sortable have a deterministic column to order by
+        if (!field.sortable)
+            issues.push({ message: `Field "${order.field}" cannot be sorted on`, ...order.span });
+    }
+    return issues;
+}
+function checkComparison(cmp, fields) {
+    const issues = [];
+    const field = findField(fields, cmp.field);
+    if (!field) {
+        return [{ message: `Unknown field "${cmp.field}"`, start: cmp.span.start, end: cmp.span.end }];
+    }
+    const allowed = operatorsFor(field);
+    if (!allowed.includes(cmp.op))
+        issues.push({
+            message: `Operator "${cmp.op}" is not supported for "${field.name}" (try ${allowed.join(', ')})`,
+            start: cmp.span.start,
+            end: cmp.span.end,
+        });
+    for (const v of [cmp.value, ...(cmp.values ?? [])])
+        if (v)
+            issues.push(...checkValue(v, field));
+    return issues;
+}
+function checkValue(value, field) {
+    if (value.kind === 'func') {
+        const spec = FUNCTIONS.get(value.name.toLowerCase());
+        if (!spec)
+            return [{ message: `Unknown function "${value.name}()"`, ...value.span }];
+        if (!argCountOk(spec.args, value.args.length))
+            return [{ message: `${value.name}() expects ${spec.args} argument(s)`, ...value.span }];
+        return [];
+    }
+    if (value.kind === 'null')
+        return [];
+    switch (field.kind) {
+        case 'number':
+            if (value.kind !== 'number')
+                return [{ message: `"${field.name}" expects a number`, ...value.span }];
+            return [];
+        case 'boolean':
+            if (value.kind !== 'bool')
+                return [{ message: `"${field.name}" expects true or false`, ...value.span }];
+            return [];
+        case 'date':
+        case 'datetime':
+            if (value.kind !== 'date' && value.kind !== 'reldate')
+                return [
+                    {
+                        message: `"${field.name}" expects a date (2026-08-22), a relative date (-7d) or a function`,
+                        ...value.span,
+                    },
+                ];
+            return [];
+        case 'enum': {
+            const text = value.kind === 'string' || value.kind === 'ident' ? String(value.value) : null;
+            if (text && field.enumValues && !field.enumValues.includes(text.toLowerCase()))
+                return [
+                    {
+                        message: `"${text}" is not a valid ${field.name} (${field.enumValues.join(', ')})`,
+                        ...value.span,
+                    },
+                ];
+            return [];
+        }
+        default:
+            return [];
+    }
+}
+//# sourceMappingURL=validate.js.map

package/dist/kql/validate.js.map

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

package/dist/server/index.d.ts

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+export * from './rank.js';
+export * from './rich.js';
+export { trackerRouter } from './router.js';
+export * from './schema.js';
+export * from './services/index.js';
+/**
+ * The tracker module: projects, work items, workflows, KQL, planning, time tracking and reports.
+ *
+ * Hosted by the core service by default. Like every Kern module it is reachable from anywhere through
+ * `/api/tracker` and `kernel.call('tracker.*')`, so a deployment that outgrows core can move it to its
+ * own service by registering it there instead.
+ */
+export declare const trackerModule: import("@kernhq/kernel").ServerModule<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
+export default trackerModule;
+export type TrackerModule = typeof trackerModule;
+//# sourceMappingURL=index.d.ts.map

package/dist/server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAiBvB,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AACzB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,cAAc,aAAa,CAAA;AAC3B,cAAc,qBAAqB,CAAA;AAqNnC;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,gHA0cxB,CAAA;AAsBF,eAAe,aAAa,CAAA;AAC5B,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAA"}