@orgloop/transform-filter 0.1.0

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 OrgLoop contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,140 @@
+# @orgloop/transform-filter
+
+Filters events by field matching or jq expressions. Events that pass the filter continue through the pipeline; events that fail are dropped.
+
+## Install
+
+```bash
+npm install @orgloop/transform-filter
+```
+
+## Configuration
+
+The filter supports two modes: **match/exclude** (built-in) and **jq** (subprocess).
+
+### Mode 1: Match / Exclude
+
+```yaml
+transforms:
+  - name: humans-only
+    type: package
+    package: "@orgloop/transform-filter"
+    config:
+      match:                                    # all criteria must match to pass
+        type: "resource.changed"
+        "provenance.author_type": "team_member"
+      exclude:                                  # any match here drops the event
+        "provenance.author":
+          - "dependabot[bot]"
+          - "renovate[bot]"
+```
+
+### Mode 2: jq expression
+
+```yaml
+transforms:
+  - name: high-priority
+    type: package
+    package: "@orgloop/transform-filter"
+    config:
+      jq: '.payload.priority == "high"'        # truthy result = pass, falsy = drop
+```
+
+### Config options
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `match` | `object` | Dot-path field to value map. **All** criteria must match for the event to pass |
+| `exclude` | `object` | Dot-path field to value map. **Any** match drops the event |
+| `jq` | `string` | jq expression evaluated against the full event. Truthy = pass, falsy/error = drop |
+
+If both `match` and `exclude` are set, `exclude` is checked first.
+
+If `jq` is set, it takes precedence over `match`/`exclude`.
+
+### Value matching
+
+The `match` and `exclude` fields support several value types:
+
+| Pattern type | Example | Behavior |
+|---|---|---|
+| String | `"team_member"` | Exact match |
+| Number | `42` | Strict equality |
+| Boolean | `true` | Strict equality |
+| Array | `["bot", "system"]` | Matches if actual value equals any element |
+| Regex string | `"/fix\\|bug/i"` | Regex test against stringified value |
+| `null` | `null` | Matches `null` or `undefined` |
+
+### Dot-path field access
+
+Fields are accessed via dot-notation paths into the event object:
+
+- `type` -- top-level event type
+- `provenance.author` -- nested provenance field
+- `payload.pr_number` -- payload field
+
+## Examples
+
+### Filter by event type and author
+
+```yaml
+routes:
+  - name: human-pr-reviews
+    when:
+      source: github-eng
+      events:
+        - resource.changed
+    transforms:
+      - ref: humans-only
+    then:
+      actor: openclaw-agent
+```
+
+### CWD-based routing with regex
+
+Route Claude Code stop events to different agents based on the working directory:
+
+```yaml
+transforms:
+  - name: work-repos
+    type: package
+    package: "@orgloop/transform-filter"
+    config:
+      match:
+        "payload.cwd": "/\\/code\\/mono/"           # regex: matches ~/code/mono*
+  - name: personal-repos
+    type: package
+    package: "@orgloop/transform-filter"
+    config:
+      match:
+        "payload.cwd": "/\\/personal\\//"            # regex: matches ~/personal/*
+
+routes:
+  - name: work-tasks
+    when:
+      source: claude-code
+      events: [actor.stopped]
+    transforms: [{ ref: work-repos }]
+    then:
+      actor: work-agent
+  - name: personal-tasks
+    when:
+      source: claude-code
+      events: [actor.stopped]
+    transforms: [{ ref: personal-repos }]
+    then:
+      actor: personal-agent
+```
+
+## Auth / prerequisites
+
+- None for match/exclude mode.
+- **jq mode** requires the `jq` binary to be installed and available on `PATH`. The subprocess runs with a 5-second timeout.
+
+## Limitations / known issues
+
+- **jq mode spawns a subprocess** per event. This is convenient but not suitable for high-throughput pipelines.
+- **jq errors drop the event** -- If the jq expression fails to parse or returns an error exit code, the event is silently dropped (not passed through).
+- **jq can modify events** -- If the jq expression returns a valid JSON object with an `id` field, that object replaces the original event. Otherwise, the original event passes through unchanged.
+- **No OR logic for match** -- All `match` criteria use AND logic. For OR, use an array value within a single field or use jq mode.
+- **Regex patterns** -- Must start and end with `/` (e.g., `"/pattern/flags"`). Invalid regex falls back to exact string comparison.

package/dist/filter.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Filter transform — the workhorse event filter for OrgLoop.
+ *
+ * Two modes:
+ * 1. Match/exclude mode: built-in dot-path field matching
+ * 2. jq mode: pipe event through jq subprocess
+ *
+ * Match modes:
+ * - match:     AND — all criteria must match (keep if all match)
+ * - match_any: OR  — any criterion can match (keep if any matches)
+ * - exclude:   OR  — any criterion drops the event
+ */
+import type { OrgLoopEvent, Transform, TransformContext } from '@orgloop/sdk';
+export declare class FilterTransform implements Transform {
+    readonly id = "filter";
+    private config;
+    init(config: Record<string, unknown>): Promise<void>;
+    execute(event: OrgLoopEvent, _context: TransformContext): Promise<OrgLoopEvent | null>;
+    shutdown(): Promise<void>;
+    private executeMatchExclude;
+    private executeJq;
+}
+//# sourceMappingURL=filter.d.ts.map

package/dist/filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../src/filter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AA2B9E,qBAAa,eAAgB,YAAW,SAAS;IAChD,QAAQ,CAAC,EAAE,YAAY;IACvB,OAAO,CAAC,MAAM,CAAoB;IAE5B,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAUpD,OAAO,CAAC,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAStF,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAI/B,OAAO,CAAC,mBAAmB;IA2B3B,OAAO,CAAC,SAAS;CAmDjB"}

package/dist/filter.js

@@ -0,0 +1,123 @@
+/**
+ * Filter transform — the workhorse event filter for OrgLoop.
+ *
+ * Two modes:
+ * 1. Match/exclude mode: built-in dot-path field matching
+ * 2. jq mode: pipe event through jq subprocess
+ *
+ * Match modes:
+ * - match:     AND — all criteria must match (keep if all match)
+ * - match_any: OR  — any criterion can match (keep if any matches)
+ * - exclude:   OR  — any criterion drops the event
+ */
+import { spawn } from 'node:child_process';
+import { matchesAll, matchesAny } from './matcher.js';
+/**
+ * Expand comma-separated string values into arrays for matching.
+ * "alice,bob" → ["alice", "bob"]. Already-array values pass through.
+ * Only applies to criterion values, not field paths.
+ */
+function expandCsvValues(criteria) {
+    const result = {};
+    for (const [key, value] of Object.entries(criteria)) {
+        if (typeof value === 'string' && value.includes(',')) {
+            result[key] = value.split(',').map((s) => s.trim());
+        }
+        else {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+export class FilterTransform {
+    id = 'filter';
+    config = {};
+    async init(config) {
+        const raw = config;
+        this.config = {
+            match: raw.match ? expandCsvValues(raw.match) : undefined,
+            match_any: raw.match_any ? expandCsvValues(raw.match_any) : undefined,
+            exclude: raw.exclude ? expandCsvValues(raw.exclude) : undefined,
+            jq: raw.jq,
+        };
+    }
+    async execute(event, _context) {
+        // jq mode takes precedence if specified
+        if (this.config.jq) {
+            return this.executeJq(event);
+        }
+        return this.executeMatchExclude(event);
+    }
+    async shutdown() {
+        // No resources to clean up
+    }
+    executeMatchExclude(event) {
+        const eventObj = event;
+        // Check exclude first — if any exclude criterion matches, drop
+        if (this.config.exclude) {
+            if (matchesAny(eventObj, this.config.exclude)) {
+                return null;
+            }
+        }
+        // Check match — all criteria must match (AND)
+        if (this.config.match) {
+            if (!matchesAll(eventObj, this.config.match)) {
+                return null;
+            }
+        }
+        // Check match_any — at least one criterion must match (OR)
+        if (this.config.match_any) {
+            if (!matchesAny(eventObj, this.config.match_any)) {
+                return null;
+            }
+        }
+        return event;
+    }
+    executeJq(event) {
+        return new Promise((resolve) => {
+            try {
+                const input = JSON.stringify(event);
+                const proc = spawn('jq', ['-e', this.config.jq], {
+                    stdio: ['pipe', 'pipe', 'pipe'],
+                    timeout: 5000,
+                });
+                let stdout = '';
+                proc.stdout.on('data', (chunk) => {
+                    stdout += chunk.toString();
+                });
+                proc.on('error', () => {
+                    resolve(null);
+                });
+                proc.on('close', (code) => {
+                    if (code !== 0) {
+                        resolve(null);
+                        return;
+                    }
+                    const trimmed = stdout.trim();
+                    if (!trimmed || trimmed === 'null' || trimmed === 'false') {
+                        resolve(null);
+                        return;
+                    }
+                    // If jq returned a modified object, try to parse it
+                    try {
+                        const result = JSON.parse(trimmed);
+                        if (typeof result === 'object' && result !== null && result.id) {
+                            resolve(result);
+                            return;
+                        }
+                    }
+                    catch {
+                        // Non-JSON truthy output means pass through
+                    }
+                    resolve(event);
+                });
+                proc.stdin.write(input);
+                proc.stdin.end();
+            }
+            catch {
+                resolve(null);
+            }
+        });
+    }
+}
+//# sourceMappingURL=filter.js.map

package/dist/filter.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @orgloop/transform-filter — registration entry point.
+ */
+import type { TransformRegistration } from '@orgloop/sdk';
+export declare function register(): TransformRegistration;
+export { FilterTransform } from './filter.js';
+export { getByPath, matchesAll, matchesAny, matchesValue } from './matcher.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAG1D,wBAAgB,QAAQ,IAAI,qBAAqB,CAuBhD;AAED,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,31 @@
+/**
+ * @orgloop/transform-filter — registration entry point.
+ */
+import { FilterTransform } from './filter.js';
+export function register() {
+    return {
+        id: 'filter',
+        transform: FilterTransform,
+        configSchema: {
+            type: 'object',
+            properties: {
+                match: {
+                    type: 'object',
+                    description: 'Dot-path field → value patterns. All must match for event to pass.',
+                },
+                exclude: {
+                    type: 'object',
+                    description: 'Dot-path field → value or array. Any match drops the event.',
+                },
+                jq: {
+                    type: 'string',
+                    description: 'jq expression. Truthy result = pass, falsy/error = drop.',
+                },
+            },
+            additionalProperties: false,
+        },
+    };
+}
+export { FilterTransform } from './filter.js';
+export { getByPath, matchesAll, matchesAny, matchesValue } from './matcher.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,UAAU,QAAQ;IACvB,OAAO;QACN,EAAE,EAAE,QAAQ;QACZ,SAAS,EAAE,eAAe;QAC1B,YAAY,EAAE;YACb,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACX,KAAK,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,oEAAoE;iBACjF;gBACD,OAAO,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,6DAA6D;iBAC1E;gBACD,EAAE,EAAE;oBACH,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,0DAA0D;iBACvE;aACD;YACD,oBAAoB,EAAE,KAAK;SAC3B;KACD,CAAC;AACH,CAAC;AAED,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC"}

package/dist/matcher.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Dot-path field matching logic for the filter transform.
+ *
+ * Supports nested field access via dot notation (e.g., "provenance.author_type")
+ * and pattern matching against values.
+ */
+/**
+ * Get a value from a nested object using a dot-separated path.
+ * Returns undefined if any segment is missing.
+ */
+export declare function getByPath(obj: unknown, path: string): unknown;
+/**
+ * Check if a value matches a pattern.
+ * - Strings: exact match
+ * - Numbers/booleans: strict equality
+ * - Arrays: value must match any element in the array
+ * - RegExp-like strings (/pattern/flags): regex test
+ * - null: matches null or undefined
+ */
+export declare function matchesValue(actual: unknown, pattern: unknown): boolean;
+/**
+ * Check if an event matches all criteria in a match object.
+ * Every field in `criteria` must match the corresponding event field.
+ */
+export declare function matchesAll(event: Record<string, unknown>, criteria: Record<string, unknown>): boolean;
+/**
+ * Check if an event matches any criterion in an exclude object.
+ * If any field matches, the event should be excluded.
+ */
+export declare function matchesAny(event: Record<string, unknown>, criteria: Record<string, unknown>): boolean;
+//# sourceMappingURL=matcher.d.ts.map

package/dist/matcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matcher.d.ts","sourceRoot":"","sources":["../src/matcher.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;GAGG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAU7D;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAwBvE;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACzB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAQT;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACzB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAQT"}

package/dist/matcher.js

@@ -0,0 +1,79 @@
+/**
+ * Dot-path field matching logic for the filter transform.
+ *
+ * Supports nested field access via dot notation (e.g., "provenance.author_type")
+ * and pattern matching against values.
+ */
+/**
+ * Get a value from a nested object using a dot-separated path.
+ * Returns undefined if any segment is missing.
+ */
+export function getByPath(obj, path) {
+    const segments = path.split('.');
+    let current = obj;
+    for (const segment of segments) {
+        if (current === null || current === undefined || typeof current !== 'object') {
+            return undefined;
+        }
+        current = current[segment];
+    }
+    return current;
+}
+/**
+ * Check if a value matches a pattern.
+ * - Strings: exact match
+ * - Numbers/booleans: strict equality
+ * - Arrays: value must match any element in the array
+ * - RegExp-like strings (/pattern/flags): regex test
+ * - null: matches null or undefined
+ */
+export function matchesValue(actual, pattern) {
+    if (pattern === null || pattern === undefined) {
+        return actual === null || actual === undefined;
+    }
+    if (Array.isArray(pattern)) {
+        return pattern.some((p) => matchesValue(actual, p));
+    }
+    if (typeof pattern === 'string' && pattern.startsWith('/')) {
+        const lastSlash = pattern.lastIndexOf('/');
+        if (lastSlash > 0) {
+            const regexBody = pattern.slice(1, lastSlash);
+            const flags = pattern.slice(lastSlash + 1);
+            try {
+                const regex = new RegExp(regexBody, flags);
+                return regex.test(String(actual));
+            }
+            catch {
+                // Invalid regex, fall through to exact match
+            }
+        }
+    }
+    return actual === pattern;
+}
+/**
+ * Check if an event matches all criteria in a match object.
+ * Every field in `criteria` must match the corresponding event field.
+ */
+export function matchesAll(event, criteria) {
+    for (const [path, pattern] of Object.entries(criteria)) {
+        const actual = getByPath(event, path);
+        if (!matchesValue(actual, pattern)) {
+            return false;
+        }
+    }
+    return true;
+}
+/**
+ * Check if an event matches any criterion in an exclude object.
+ * If any field matches, the event should be excluded.
+ */
+export function matchesAny(event, criteria) {
+    for (const [path, pattern] of Object.entries(criteria)) {
+        const actual = getByPath(event, path);
+        if (matchesValue(actual, pattern)) {
+            return true;
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=matcher.js.map

package/dist/matcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"matcher.js","sourceRoot":"","sources":["../src/matcher.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,GAAY,EAAE,IAAY;IACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,OAAO,GAAY,GAAG,CAAC;IAC3B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAChC,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAC9E,OAAO,SAAS,CAAC;QAClB,CAAC;QACD,OAAO,GAAI,OAAmC,CAAC,OAAO,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,OAAO,CAAC;AAChB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,MAAe,EAAE,OAAgB;IAC7D,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC/C,OAAO,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,SAAS,CAAC;IAChD,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5B,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;IACrD,CAAC;IAED,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5D,MAAM,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAC3C,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;YACnB,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;YAC9C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;YAC3C,IAAI,CAAC;gBACJ,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;gBAC3C,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;YACnC,CAAC;YAAC,MAAM,CAAC;gBACR,6CAA6C;YAC9C,CAAC;QACF,CAAC;IACF,CAAC;IAED,OAAO,MAAM,KAAK,OAAO,CAAC;AAC3B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CACzB,KAA8B,EAC9B,QAAiC;IAEjC,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACxD,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;YACpC,OAAO,KAAK,CAAC;QACd,CAAC;IACF,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CACzB,KAA8B,EAC9B,QAAiC;IAEjC,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACxD,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACtC,IAAI,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;YACnC,OAAO,IAAI,CAAC;QACb,CAAC;IACF,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC"}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@orgloop/transform-filter",
+  "version": "0.1.0",
+  "description": "OrgLoop filter transform — jq-based and match/exclude filtering",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "dependencies": {
+    "@orgloop/sdk": "0.1.0"
+  },
+  "orgloop": {
+    "type": "transform",
+    "id": "filter"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  }
+}