@objectstack/cli 9.7.0 → 9.9.0

package/dist/utils/lint-flow-patterns.test.js

@@ -1,6 +1,18 @@
 // Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
 import { describe, it, expect } from 'vitest';
-import { lintFlowPatterns, FLOW_TIME_RELATIVE_ANTIPATTERN, FLOW_DOUBLE_BRACE_INTERP, FLOW_BARE_DOLLAR_REF, } from './lint-flow-patterns.js';
+import { lintFlowPatterns, FLOW_TIME_RELATIVE_ANTIPATTERN, FLOW_DATE_EQUALITY_FILTER, FLOW_PHANTOM_AGGREGATION, FLOW_DOUBLE_BRACE_INTERP, FLOW_BARE_DOLLAR_REF, } from './lint-flow-patterns.js';
+const CEL = (source) => ({ dialect: 'cel', source });
+/** A scheduled flow with a get_record node carrying `filter`. */
+const filterFlow = (filter) => ({
+    flows: [{
+            name: 'expiry_alert',
+            nodes: [
+                { id: 'start', type: 'start', config: { triggerType: 'schedule', schedule: 'cron:0 9 * * *' } },
+                { id: 'query', type: 'get_record', config: { objectName: 'contract', filter } },
+            ],
+            edges: [],
+        }],
+});
 const flow = (condition, triggerType = 'record-after-update') => ({
     flows: [{
             name: 'renewal_alert',
@@ -38,6 +50,74 @@ describe('lintFlowPatterns — time-relative anti-pattern (#1874)', () => {
         });
     });
 });
+describe('lintFlowPatterns — date-equality in query filter (#1874)', () => {
+    it('flags a field bound directly to a time value (implicit equality)', () => {
+        const fnds = lintFlowPatterns(filterFlow({ expires_at: CEL('daysFromNow(30)') }));
+        expect(fnds).toHaveLength(1);
+        expect(fnds[0].rule).toBe(FLOW_DATE_EQUALITY_FILTER);
+        expect(fnds[0].hint).toMatch(/\$gte.*daysFromNow\(N\).*\$lt/);
+    });
+    it('flags `$in` against time values (the original renewal_alert bug)', () => {
+        const fnds = lintFlowPatterns(filterFlow({
+            status: 'active',
+            end_date: { $in: [CEL('daysFromNow(60)'), CEL('daysFromNow(30)'), CEL('daysFromNow(7)')] },
+        }));
+        expect(fnds).toHaveLength(1);
+        expect(fnds[0].rule).toBe(FLOW_DATE_EQUALITY_FILTER);
+    });
+    it('flags `$eq` against a time value', () => {
+        expect(lintFlowPatterns(filterFlow({ d: { $eq: CEL('today()') } }))).toHaveLength(1);
+    });
+    describe('does NOT flag (false-positive guards)', () => {
+        it('a one-day window (the correct fix)', () => {
+            expect(lintFlowPatterns(filterFlow({
+                end_date: { $gte: CEL('daysFromNow(7)'), $lt: CEL('daysFromNow(8)') },
+            }))).toHaveLength(0);
+        });
+        it('multi-tier windows wrapped in $or', () => {
+            expect(lintFlowPatterns(filterFlow({
+                status: 'active',
+                $or: [
+                    { end_date: { $gte: CEL('daysFromNow(7)'), $lt: CEL('daysFromNow(8)') } },
+                    { end_date: { $gte: CEL('daysFromNow(30)'), $lt: CEL('daysFromNow(31)') } },
+                ],
+            }))).toHaveLength(0);
+        });
+        it('a plain range like `due_date < today()` (overdue query)', () => {
+            expect(lintFlowPatterns(filterFlow({ status: 'open', due_date: { $lt: CEL('today()') } }))).toHaveLength(0);
+        });
+        it('equality against a non-time value (status, interpolated id)', () => {
+            expect(lintFlowPatterns(filterFlow({ status: 'active', id: '{record.id}' }))).toHaveLength(0);
+            expect(lintFlowPatterns(filterFlow({ amount: { $eq: CEL('record.threshold') } }))).toHaveLength(0);
+        });
+    });
+});
+describe('lintFlowPatterns — phantom aggregation capability (#1870)', () => {
+    const scriptNode = (config) => ({
+        flows: [{
+                name: 'rollup',
+                nodes: [
+                    { id: 'start', type: 'start', config: {} },
+                    { id: 'sum', type: 'script', config },
+                ],
+                edges: [],
+            }],
+    });
+    it('flags `aggregations` on a script node (publication_rollup bug)', () => {
+        const fnds = lintFlowPatterns(scriptNode({ aggregations: { total: { sum: 'amount' } } }));
+        expect(fnds).toHaveLength(1);
+        expect(fnds[0].rule).toBe(FLOW_PHANTOM_AGGREGATION);
+        expect(fnds[0].hint).toMatch(/Field\.summary/);
+    });
+    it('flags groupBy / rollup / aggregate / having too', () => {
+        for (const key of ['groupBy', 'rollup', 'aggregate', 'having']) {
+            expect(lintFlowPatterns(scriptNode({ [key]: {} })).map((f) => f.rule)).toContain(FLOW_PHANTOM_AGGREGATION);
+        }
+    });
+    it('does NOT flag an ordinary script/function node', () => {
+        expect(lintFlowPatterns(scriptNode({ function: 'helpdesk.triage', inputs: { x: 1 } }))).toHaveLength(0);
+    });
+});
 /** A flow with a create_record node carrying `config`. */
 const nodeFlow = (config) => ({
     flows: [{

package/dist/utils/lint-flow-patterns.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"lint-flow-patterns.test.js","sourceRoot":"","sources":["../../src/utils/lint-flow-patterns.test.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"lint-flow-patterns.test.js","sourceRoot":"","sources":["../../src/utils/lint-flow-patterns.test.ts"],"names":[],"mappings":"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"}

package/dist/utils/lint-liveness-properties.d.ts

@@ -0,0 +1,19 @@
+export interface LivenessLintFinding {
+    where: string;
+    message: string;
+    hint: string;
+    rule: string;
+}
+export declare const LIVENESS_DEAD_PROPERTY = "liveness-dead-property";
+export declare const LIVENESS_EXPERIMENTAL_PROPERTY = "liveness-experimental-property";
+type AnyRec = Record<string, unknown>;
+/**
+ * Lint the compiled stack for authored properties the liveness ledger flags as
+ * misleading. Advisory only — returns findings, never throws. v1 covers the two
+ * highest-signal surfaces (objects incl. their `enable.*` flags, and their
+ * fields); the mechanism is ledger-driven, so coverage grows by marking more
+ * entries `authorWarn` rather than touching this code.
+ */
+export declare function lintLivenessProperties(stack: AnyRec): LivenessLintFinding[];
+export {};
+//# sourceMappingURL=lint-liveness-properties.d.ts.map

package/dist/utils/lint-liveness-properties.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint-liveness-properties.d.ts","sourceRoot":"","sources":["../../src/utils/lint-liveness-properties.ts"],"names":[],"mappings":"AA0BA,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,eAAO,MAAM,sBAAsB,2BAA2B,CAAC;AAC/D,eAAO,MAAM,8BAA8B,mCAAmC,CAAC;AAE/E,KAAK,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AA8GtC;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,mBAAmB,EAAE,CAmB3E"}

package/dist/utils/lint-liveness-properties.js

@@ -0,0 +1,150 @@
+// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
+/**
+ * Build-time lint that closes the spec-liveness loop on the AUTHOR side.
+ *
+ * The liveness ledgers (`@objectstack/spec/liveness/<type>.json`) classify every
+ * authorable metadata property as live / experimental / dead with evidence. The
+ * CI gate enforces that classification is *complete*, but the ledger's knowledge
+ * never reached the person (very often an AI) writing the metadata. This lint
+ * surfaces it: when an authored object/field sets a property the ledger marks as
+ * dead-and-misleading (or experimental), it emits an advisory WARNING — "you set
+ * this expecting it to do something; at runtime it does nothing" — with a hint
+ * toward the supported alternative. It NEVER fails the build.
+ *
+ * Signal over noise is the whole point, so the ledger opts in per entry via
+ * `"authorWarn": true` (+ an optional `"authorHint"`). A property being merely
+ * `dead` is NOT enough — plenty of dead props are benign display/doc metadata.
+ * Only entries an author would be *misled* by are marked. Booleans warn only when
+ * set truthy (so schema defaults like `enable.trash` never trip it); object/
+ * string/array props warn when present at all.
+ */
+import { createRequire } from 'node:module';
+import { dirname, join } from 'node:path';
+import { existsSync, readFileSync } from 'node:fs';
+export const LIVENESS_DEAD_PROPERTY = 'liveness-dead-property';
+export const LIVENESS_EXPERIMENTAL_PROPERTY = 'liveness-experimental-property';
+function asArray(v) {
+    if (Array.isArray(v))
+        return v;
+    if (v && typeof v === 'object')
+        return Object.entries(v).map(([name, def]) => ({ name, ...def }));
+    return [];
+}
+/** Locate `@objectstack/spec`'s shipped `liveness/` dir (workspace src or published files). */
+function resolveLivenessDir() {
+    try {
+        const require = createRequire(import.meta.url);
+        const pkgJson = require.resolve('@objectstack/spec/package.json');
+        const dir = join(dirname(pkgJson), 'liveness');
+        return existsSync(dir) ? dir : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Build the warn-only lookup for one type, flattening one level of `children`. */
+function loadWarnMap(dir, type) {
+    const map = new Map();
+    const file = join(dir, `${type}.json`);
+    if (!existsSync(file))
+        return map;
+    let ledger;
+    try {
+        ledger = JSON.parse(readFileSync(file, 'utf8'));
+    }
+    catch {
+        return map;
+    }
+    const props = ledger.props || {};
+    for (const [key, entry] of Object.entries(props)) {
+        if (entry?.children) {
+            for (const [ck, centry] of Object.entries(entry.children)) {
+                if (shouldWarn(centry))
+                    map.set(`${key}.${ck}`, centry);
+            }
+        }
+        if (shouldWarn(entry))
+            map.set(key, entry);
+    }
+    return map;
+}
+/** An entry warns when explicitly opted in, OR when it's experimental (a declared-but-unenforced guarantee). */
+function shouldWarn(entry) {
+    if (!entry)
+        return false;
+    return entry.authorWarn === true || entry.status === 'experimental';
+}
+/** A value that signals authoring intent: booleans only when truthy; everything else when present. */
+function isAuthored(value) {
+    if (value === undefined || value === null)
+        return false;
+    if (typeof value === 'boolean')
+        return value === true;
+    return true;
+}
+function describe(entry) {
+    if (entry.status === 'experimental') {
+        return { kind: 'is experimental — declared but NOT enforced at runtime', rule: LIVENESS_EXPERIMENTAL_PROPERTY };
+    }
+    return { kind: 'has no runtime effect (liveness: dead)', rule: LIVENESS_DEAD_PROPERTY };
+}
+/** Check one metadata item's set properties against its type's warn-map. */
+function checkItem(type, item, whereBase, warnMap, findings) {
+    for (const [path, entry] of warnMap) {
+        const value = path.includes('.')
+            ? getNested(item, path)
+            : item[path];
+        if (!isAuthored(value))
+            continue;
+        const { kind, rule } = describe(entry);
+        const hint = entry.authorHint
+            ?? entry.note
+            ?? 'Remove it — it is declared in the spec but not consumed at runtime.';
+        findings.push({
+            where: whereBase,
+            message: `sets \`${path}\` but this ${type} property ${kind}.`,
+            hint,
+            rule,
+        });
+    }
+}
+/** Resolve a dotted path one or more levels, treating a missing parent as absent. */
+function getNested(obj, path) {
+    let cur = obj;
+    for (const seg of path.split('.')) {
+        if (cur === null || typeof cur !== 'object')
+            return undefined;
+        cur = cur[seg];
+    }
+    return cur;
+}
+/**
+ * Lint the compiled stack for authored properties the liveness ledger flags as
+ * misleading. Advisory only — returns findings, never throws. v1 covers the two
+ * highest-signal surfaces (objects incl. their `enable.*` flags, and their
+ * fields); the mechanism is ledger-driven, so coverage grows by marking more
+ * entries `authorWarn` rather than touching this code.
+ */
+export function lintLivenessProperties(stack) {
+    const dir = resolveLivenessDir();
+    if (!dir)
+        return [];
+    const objectWarn = loadWarnMap(dir, 'object');
+    const fieldWarn = loadWarnMap(dir, 'field');
+    if (objectWarn.size === 0 && fieldWarn.size === 0)
+        return [];
+    const findings = [];
+    for (const obj of asArray(stack.objects)) {
+        const objName = typeof obj.name === 'string' ? obj.name : '(unnamed object)';
+        if (objectWarn.size > 0)
+            checkItem('object', obj, `object '${objName}'`, objectWarn, findings);
+        if (fieldWarn.size > 0) {
+            for (const field of asArray(obj.fields)) {
+                const fieldName = typeof field.name === 'string' ? field.name : '(unnamed field)';
+                checkItem('field', field, `object '${objName}' · field '${fieldName}'`, fieldWarn, findings);
+            }
+        }
+    }
+    return findings;
+}
+//# sourceMappingURL=lint-liveness-properties.js.map

package/dist/utils/lint-liveness-properties.js.map

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

package/dist/utils/lint-liveness-properties.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=lint-liveness-properties.test.d.ts.map

package/dist/utils/lint-liveness-properties.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint-liveness-properties.test.d.ts","sourceRoot":"","sources":["../../src/utils/lint-liveness-properties.test.ts"],"names":[],"mappings":""}

package/dist/utils/lint-liveness-properties.test.js

@@ -0,0 +1,66 @@
+// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
+import { describe, it, expect } from 'vitest';
+import { lintLivenessProperties, LIVENESS_DEAD_PROPERTY, } from './lint-liveness-properties.js';
+/**
+ * These run against the REAL ledgers shipped by `@objectstack/spec` (the same
+ * files the gate enforces), so they double as a contract test: if an
+ * `authorWarn` annotation is removed from `enable.feeds` / `columnName` / etc.,
+ * the matching assertion fails.
+ */
+const objStack = (obj) => ({ objects: [{ name: 'widget', ...obj }] });
+const rules = (findings) => findings.map((f) => f.rule);
+const paths = (findings) => findings.map((f) => f.message);
+describe('lintLivenessProperties', () => {
+    it('warns on an authored dead capability flag (enable.feeds: true)', () => {
+        const findings = lintLivenessProperties(objStack({ enable: { feeds: true } }));
+        expect(findings.length).toBeGreaterThan(0);
+        const feeds = findings.find((f) => f.message.includes('enable.feeds'));
+        expect(feeds).toBeDefined();
+        expect(feeds.rule).toBe(LIVENESS_DEAD_PROPERTY);
+        expect(feeds.where).toBe("object 'widget'");
+        expect(feeds.hint.length).toBeGreaterThan(0);
+    });
+    it('does NOT warn on a default-on flag the author left alone (enable.trash: true)', () => {
+        const findings = lintLivenessProperties(objStack({ enable: { trash: true } }));
+        expect(paths(findings).some((m) => m.includes('enable.trash'))).toBe(false);
+    });
+    it('does NOT warn when a dead boolean flag is explicitly false (enable.files: false)', () => {
+        const findings = lintLivenessProperties(objStack({ enable: { files: false } }));
+        expect(paths(findings).some((m) => m.includes('enable.files'))).toBe(false);
+    });
+    it('warns on a present dead object block (versioning)', () => {
+        const findings = lintLivenessProperties(objStack({ versioning: { enabled: true } }));
+        expect(paths(findings).some((m) => m.includes('versioning'))).toBe(true);
+    });
+    it('warns on a misleading dead field prop (columnName)', () => {
+        const findings = lintLivenessProperties(objStack({ fields: [{ name: 'code', type: 'text', columnName: 'legacy_code' }] }));
+        const f = findings.find((x) => x.message.includes('columnName'));
+        expect(f).toBeDefined();
+        expect(f.where).toBe("object 'widget' · field 'code'");
+    });
+    it('warns on a field-level index flag set true, but not when false', () => {
+        const on = lintLivenessProperties(objStack({ fields: [{ name: 'code', type: 'text', index: true }] }));
+        expect(paths(on).some((m) => m.includes('`index`'))).toBe(true);
+        const off = lintLivenessProperties(objStack({ fields: [{ name: 'code', type: 'text', index: false }] }));
+        expect(paths(off).some((m) => m.includes('`index`'))).toBe(false);
+    });
+    it('is silent for a clean object with only live properties', () => {
+        const findings = lintLivenessProperties(objStack({
+            label: 'Widget',
+            enable: { apiEnabled: true },
+            fields: [{ name: 'name', type: 'text', label: 'Name' }],
+        }));
+        expect(findings).toEqual([]);
+    });
+    it('handles objects as a keyed record (not just arrays)', () => {
+        const findings = lintLivenessProperties({
+            objects: { widget: { name: 'widget', enable: { feeds: true } } },
+        });
+        expect(rules(findings)).toContain(LIVENESS_DEAD_PROPERTY);
+    });
+    it('returns [] on an empty / shapeless stack', () => {
+        expect(lintLivenessProperties({})).toEqual([]);
+        expect(lintLivenessProperties({ objects: [] })).toEqual([]);
+    });
+});
+//# sourceMappingURL=lint-liveness-properties.test.js.map

package/dist/utils/lint-liveness-properties.test.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@objectstack/cli",
-  "version": "9.7.0",
+  "version": "9.9.0",
   "description": "Command Line Interface for ObjectStack Protocol",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -47,51 +47,51 @@
     "tsx": "^4.22.4",
     "yaml": "^2.9.0",
     "zod": "^4.4.3",
-    "@objectstack/account": "9.7.0",
-    "@objectstack/client": "9.7.0",
-    "@objectstack/console": "9.7.0",
-    "@objectstack/core": "^9.7.0",
-    "@objectstack/driver-memory": "^9.7.0",
-    "@objectstack/driver-mongodb": "^9.7.0",
-    "@objectstack/driver-sql": "^9.7.0",
-    "@objectstack/driver-sqlite-wasm": "^9.7.0",
-    "@objectstack/formula": "9.7.0",
-    "@objectstack/objectql": "^9.7.0",
-    "@objectstack/observability": "^9.7.0",
-    "@objectstack/platform-objects": "9.7.0",
-    "@objectstack/plugin-approvals": "9.7.0",
-    "@objectstack/plugin-audit": "9.7.0",
-    "@objectstack/plugin-auth": "9.7.0",
-    "@objectstack/plugin-email": "9.7.0",
-    "@objectstack/setup": "9.7.0",
-    "@objectstack/studio": "9.7.0",
-    "@objectstack/plugin-hono-server": "9.7.0",
-    "@objectstack/mcp": "9.7.0",
-    "@objectstack/plugin-org-scoping": "9.7.0",
-    "@objectstack/plugin-reports": "9.7.0",
-    "@objectstack/plugin-security": "9.7.0",
-    "@objectstack/plugin-sharing": "9.7.0",
-    "@objectstack/trigger-record-change": "9.7.0",
-    "@objectstack/trigger-api": "9.7.0",
-    "@objectstack/trigger-schedule": "9.7.0",
-    "@objectstack/plugin-webhooks": "9.7.0",
-    "@objectstack/rest": "9.7.0",
-    "@objectstack/runtime": "^9.7.0",
-    "@objectstack/service-ai": "9.7.0",
-    "@objectstack/service-analytics": "9.7.0",
-    "@objectstack/service-automation": "9.7.0",
-    "@objectstack/service-cache": "9.7.0",
-    "@objectstack/service-datasource": "9.7.0",
-    "@objectstack/service-feed": "9.7.0",
-    "@objectstack/service-job": "9.7.0",
-    "@objectstack/service-messaging": "9.7.0",
-    "@objectstack/service-package": "9.7.0",
-    "@objectstack/service-queue": "9.7.0",
-    "@objectstack/service-realtime": "9.7.0",
-    "@objectstack/service-settings": "9.7.0",
-    "@objectstack/service-storage": "9.7.0",
-    "@objectstack/spec": "9.7.0",
-    "@objectstack/types": "9.7.0"
+    "@objectstack/account": "9.9.0",
+    "@objectstack/client": "9.9.0",
+    "@objectstack/cloud-connection": "9.9.0",
+    "@objectstack/console": "9.9.0",
+    "@objectstack/core": "^9.9.0",
+    "@objectstack/driver-memory": "^9.9.0",
+    "@objectstack/driver-mongodb": "^9.9.0",
+    "@objectstack/driver-sql": "^9.9.0",
+    "@objectstack/driver-sqlite-wasm": "^9.9.0",
+    "@objectstack/formula": "9.9.0",
+    "@objectstack/objectql": "^9.9.0",
+    "@objectstack/observability": "^9.9.0",
+    "@objectstack/platform-objects": "9.9.0",
+    "@objectstack/plugin-approvals": "9.9.0",
+    "@objectstack/plugin-audit": "9.9.0",
+    "@objectstack/plugin-auth": "9.9.0",
+    "@objectstack/plugin-email": "9.9.0",
+    "@objectstack/setup": "9.9.0",
+    "@objectstack/studio": "9.9.0",
+    "@objectstack/plugin-hono-server": "9.9.0",
+    "@objectstack/mcp": "9.9.0",
+    "@objectstack/plugin-org-scoping": "9.9.0",
+    "@objectstack/plugin-reports": "9.9.0",
+    "@objectstack/plugin-security": "9.9.0",
+    "@objectstack/plugin-sharing": "9.9.0",
+    "@objectstack/trigger-record-change": "9.9.0",
+    "@objectstack/trigger-api": "9.9.0",
+    "@objectstack/trigger-schedule": "9.9.0",
+    "@objectstack/plugin-webhooks": "9.9.0",
+    "@objectstack/rest": "9.9.0",
+    "@objectstack/runtime": "^9.9.0",
+    "@objectstack/service-ai": "9.9.0",
+    "@objectstack/service-analytics": "9.9.0",
+    "@objectstack/service-automation": "9.9.0",
+    "@objectstack/service-cache": "9.9.0",
+    "@objectstack/service-datasource": "9.9.0",
+    "@objectstack/service-job": "9.9.0",
+    "@objectstack/service-messaging": "9.9.0",
+    "@objectstack/service-package": "9.9.0",
+    "@objectstack/service-queue": "9.9.0",
+    "@objectstack/service-realtime": "9.9.0",
+    "@objectstack/service-settings": "9.9.0",
+    "@objectstack/service-storage": "9.9.0",
+    "@objectstack/spec": "9.9.0",
+    "@objectstack/types": "9.9.0"
   },
   "devDependencies": {
     "@oclif/plugin-help": "^6.2.50",