shreni 0.1.0

package/dist/kshetra/toolchain.js

@@ -0,0 +1,146 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeLanguage = normalizeLanguage;
+exports.profileFor = profileFor;
+exports.resolveBuildCommand = resolveBuildCommand;
+exports.resolveTestCommand = resolveTestCommand;
+exports.resolveLintCommand = resolveLintCommand;
+exports.resolveTestGlobs = resolveTestGlobs;
+exports.resolveVendorDirs = resolveVendorDirs;
+exports.splitCommand = splitCommand;
+exports.matchesTestGlob = matchesTestGlob;
+// Map a free-form stack.language string onto a profile key. Aliases keep common
+// spellings (ts/js/golang/rs) pointing at the right ecosystem; anything we don't
+// recognise falls to 'unknown' (skip-and-warn gates, never a wrong pnpm run).
+function normalizeLanguage(language) {
+    const l = language.trim().toLowerCase();
+    if (['typescript', 'ts', 'javascript', 'js', 'node', 'nodejs'].includes(l))
+        return 'node';
+    if (['python', 'py'].includes(l))
+        return 'python';
+    if (['go', 'golang'].includes(l))
+        return 'go';
+    if (['rust', 'rs'].includes(l))
+        return 'rust';
+    if (['java'].includes(l))
+        return 'java';
+    return 'unknown';
+}
+// Non-node profiles are static. Node's command family depends on the package
+// manager (pnpm/npm/yarn), so it is built per-config in nodeProfile().
+const STATIC_PROFILES = {
+    // Many Python repos have no build step, so build defaults to skip (OQ3).
+    python: {
+        build: '',
+        test: 'pytest',
+        lint: 'ruff check',
+        testFileGlobs: ['test_*.py', '*_test.py'],
+        vendorDirs: ['.venv', '__pycache__'],
+    },
+    go: {
+        build: 'go build ./...',
+        test: 'go test ./...',
+        lint: 'go vet ./...',
+        testFileGlobs: ['*_test.go'],
+        vendorDirs: ['vendor'],
+    },
+    rust: {
+        build: 'cargo build',
+        test: 'cargo test',
+        lint: 'cargo clippy',
+        testFileGlobs: ['tests/**', '*_test.rs'],
+        vendorDirs: ['target'],
+    },
+    java: {
+        build: 'mvn -q compile',
+        test: 'mvn -q test',
+        lint: 'mvn -q checkstyle:check',
+        testFileGlobs: ['*Test.java'],
+        vendorDirs: ['target'],
+    },
+    // Unknown language: every command skips (visible warn), and we only refuse to
+    // descend into .git during the discovery walk.
+    unknown: {
+        build: '',
+        test: '',
+        lint: '',
+        testFileGlobs: [],
+        vendorDirs: ['.git'],
+    },
+};
+function nodeProfile(packageManager) {
+    const pm = packageManager.trim() || 'pnpm';
+    return {
+        build: `${pm} build`,
+        test: `${pm} test`,
+        lint: `${pm} lint`,
+        testFileGlobs: ['**/*.test.ts', '**/*.spec.ts', '**/*.test.js'],
+        vendorDirs: ['node_modules', 'dist'],
+    };
+}
+function profileFor(kshetra) {
+    const key = normalizeLanguage(kshetra.stack.language);
+    if (key === 'node')
+        return nodeProfile(kshetra.stack.packageManager ?? 'pnpm');
+    return STATIC_PROFILES[key];
+}
+// Resolve a command override: an explicit stack value (including "" for skip)
+// wins; only when unset does the language default apply. Returned trimmed.
+function resolveCommand(override, fallback) {
+    if (override !== undefined)
+        return override.trim();
+    return fallback;
+}
+// The authoritative compile/type-check gate (Viharapala). "" = skipped.
+function resolveBuildCommand(kshetra) {
+    return resolveCommand(kshetra.stack.buildCommand, profileFor(kshetra).build);
+}
+// The authoritative test gate (health). "" = skipped.
+function resolveTestCommand(kshetra) {
+    return resolveCommand(kshetra.stack.testRunner, profileFor(kshetra).test);
+}
+// The enforced lint gate (§3.3). "" = skipped; never synthesised for a repo
+// that has no lint step.
+function resolveLintCommand(kshetra) {
+    return resolveCommand(kshetra.stack.lintCommand, profileFor(kshetra).lint);
+}
+// Test-file globs for Parikshaka's static discovery walk. Config override wins.
+function resolveTestGlobs(kshetra) {
+    return kshetra.stack.testFileGlobs ?? profileFor(kshetra).testFileGlobs;
+}
+// Directory names to skip when walking the repo. Config override wins.
+function resolveVendorDirs(kshetra) {
+    return kshetra.stack.vendorDirs ?? profileFor(kshetra).vendorDirs;
+}
+// Split a command string into argv (space-delimited, as the gates run today).
+// Empty/whitespace command yields [] so callers can detect "skip".
+function splitCommand(command) {
+    const trimmed = command.trim();
+    return trimmed ? trimmed.split(/\s+/) : [];
+}
+// Translate a simple glob into an anchored RegExp. Supports `*` (any run of
+// non-slash chars), a leading `**/` (zero or more directories — so
+// `**/*.test.ts` also matches a root-level file), and a bare `**` (any run
+// including slashes); other regex specials are escaped. Sentinels keep the `**`
+// rewrites from being clobbered by the single-`*` step.
+function globToRegExp(glob) {
+    const escaped = glob
+        .replace(/[.+^${}()|[\]\\]/g, '\\$&')
+        .replace(/\*\*\//g, '@@DIRS@@')
+        .replace(/\*\*/g, '@@ANY@@')
+        .replace(/\*/g, '[^/]*')
+        .replace(/@@DIRS@@/g, '(?:.*/)?')
+        .replace(/@@ANY@@/g, '.*');
+    return new RegExp('^' + escaped + '$');
+}
+// True when a repo-relative path matches any of the test-file globs. Globs
+// without a `/` match against the basename; globs with a `/` (or a `**/` prefix)
+// match against the full repo-relative path.
+function matchesTestGlob(relPath, globs) {
+    const base = relPath.split('/').pop() ?? relPath;
+    return globs.some(g => {
+        const re = globToRegExp(g);
+        return g.includes('/') ? re.test(relPath) : re.test(base);
+    });
+}
+//# sourceMappingURL=toolchain.js.map

package/dist/kshetra/toolchain.js.map

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

package/dist/phalaka/api.d.ts

@@ -0,0 +1,123 @@
+import { z } from 'zod';
+import type { FastifyInstance } from 'fastify';
+export declare const PHALAKA_VERSION = "1.0.0";
+export declare const CountsSchema: z.ZodObject<{
+    open: z.ZodNumber;
+    in_progress: z.ZodNumber;
+    blocked: z.ZodNumber;
+    closed: z.ZodNumber;
+}, z.core.$strip>;
+export declare const StuckSchema: z.ZodObject<{
+    since: z.ZodString;
+    reason: z.ZodString;
+    remediation: z.ZodString;
+}, z.core.$strip>;
+export declare const KshetraSummarySchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    counts: z.ZodOptional<z.ZodObject<{
+        open: z.ZodNumber;
+        in_progress: z.ZodNumber;
+        blocked: z.ZodNumber;
+        closed: z.ZodNumber;
+    }, z.core.$strip>>;
+    phase: z.ZodOptional<z.ZodString>;
+    paused: z.ZodOptional<z.ZodBoolean>;
+    stuck: z.ZodOptional<z.ZodObject<{
+        since: z.ZodString;
+        reason: z.ZodString;
+        remediation: z.ZodString;
+    }, z.core.$strip>>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const KshetraListSchema: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    counts: z.ZodOptional<z.ZodObject<{
+        open: z.ZodNumber;
+        in_progress: z.ZodNumber;
+        blocked: z.ZodNumber;
+        closed: z.ZodNumber;
+    }, z.core.$strip>>;
+    phase: z.ZodOptional<z.ZodString>;
+    paused: z.ZodOptional<z.ZodBoolean>;
+    stuck: z.ZodOptional<z.ZodObject<{
+        since: z.ZodString;
+        reason: z.ZodString;
+        remediation: z.ZodString;
+    }, z.core.$strip>>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+export declare const BeadSummarySchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    status: z.ZodString;
+    priority: z.ZodNumber;
+    type: z.ZodString;
+    assignee: z.ZodOptional<z.ZodString>;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
+export declare const TaskListResponseSchema: z.ZodObject<{
+    kshetraId: z.ZodString;
+    tasks: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        status: z.ZodString;
+        priority: z.ZodNumber;
+        type: z.ZodString;
+        assignee: z.ZodOptional<z.ZodString>;
+        updatedAt: z.ZodString;
+    }, z.core.$strip>>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const BeadDependencySchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const BeadDetailSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    status: z.ZodString;
+    priority: z.ZodNumber;
+    type: z.ZodString;
+    assignee: z.ZodOptional<z.ZodString>;
+    updatedAt: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    notes: z.ZodOptional<z.ZodString>;
+    design: z.ZodOptional<z.ZodString>;
+    acceptance: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodString;
+    dependencies: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    blockedBy: z.ZodArray<z.ZodString>;
+    parent: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const NotificationSchema: z.ZodObject<{
+    ts: z.ZodString;
+    event: z.ZodString;
+    beadId: z.ZodOptional<z.ZodString>;
+    reason: z.ZodOptional<z.ZodString>;
+    remediation: z.ZodOptional<z.ZodString>;
+    message: z.ZodString;
+}, z.core.$strip>;
+export declare const NotificationListResponseSchema: z.ZodObject<{
+    kshetraId: z.ZodString;
+    notifications: z.ZodArray<z.ZodObject<{
+        ts: z.ZodString;
+        event: z.ZodString;
+        beadId: z.ZodOptional<z.ZodString>;
+        reason: z.ZodOptional<z.ZodString>;
+        remediation: z.ZodOptional<z.ZodString>;
+        message: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const HealthSchema: z.ZodObject<{
+    ok: z.ZodLiteral<true>;
+    version: z.ZodString;
+}, z.core.$strip>;
+export declare function registerPhalakaApi(app: FastifyInstance): void;
+//# sourceMappingURL=api.d.ts.map

package/dist/phalaka/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/phalaka/api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,eAAe,EAAgC,MAAM,SAAS,CAAC;AAQ7E,eAAO,MAAM,eAAe,UAAU,CAAC;AAIvC,eAAO,MAAM,YAAY;;;;;iBAKvB,CAAC;AAEH,eAAO,MAAM,WAAW;;;;iBAItB,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;iBAW/B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;kBAAgC,CAAC;AAE/D,eAAO,MAAM,iBAAiB;;;;;;;;iBAQ5B,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;iBAIjC,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;iBAI/B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;iBAS3B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;iBAO7B,CAAC;AAEH,eAAO,MAAM,8BAA8B;;;;;;;;;;iBAGzC,CAAC;AAEH,eAAO,MAAM,YAAY;;;iBAAyD,CAAC;AA6DnF,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI,CAyD7D"}

package/dist/phalaka/api.js

@@ -0,0 +1,196 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HealthSchema = exports.NotificationListResponseSchema = exports.NotificationSchema = exports.BeadDetailSchema = exports.BeadDependencySchema = exports.TaskListResponseSchema = exports.BeadSummarySchema = exports.KshetraListSchema = exports.KshetraSummarySchema = exports.StuckSchema = exports.CountsSchema = exports.PHALAKA_VERSION = void 0;
+exports.registerPhalakaApi = registerPhalakaApi;
+const zod_1 = require("zod");
+const registry_js_1 = require("../kshetra/registry.js");
+const state_js_1 = require("../kshetra/state.js");
+const token_js_1 = require("./token.js");
+const beads_read_js_1 = require("./beads-read.js");
+const notifications_js_1 = require("../sthapathi/notifications.js");
+exports.PHALAKA_VERSION = '1.0.0';
+// ── Response schemas (zod) ──────────────────────────────────────────────────
+exports.CountsSchema = zod_1.z.object({
+    open: zod_1.z.number().int().nonnegative(),
+    in_progress: zod_1.z.number().int().nonnegative(),
+    blocked: zod_1.z.number().int().nonnegative(),
+    closed: zod_1.z.number().int().nonnegative(),
+});
+exports.StuckSchema = zod_1.z.object({
+    since: zod_1.z.string(),
+    reason: zod_1.z.string(),
+    remediation: zod_1.z.string(),
+});
+exports.KshetraSummarySchema = zod_1.z.object({
+    id: zod_1.z.string(),
+    name: zod_1.z.string(),
+    counts: exports.CountsSchema.optional(),
+    // Worker phase + health, from state.json — so the board shows what the worker
+    // is doing and, when stuck, why + how to fix it.
+    phase: zod_1.z.string().optional(),
+    paused: zod_1.z.boolean().optional(),
+    stuck: exports.StuckSchema.optional(),
+    // One Kshetra's broken beads DB surfaces here instead of blanking the board.
+    error: zod_1.z.string().optional(),
+});
+exports.KshetraListSchema = zod_1.z.array(exports.KshetraSummarySchema);
+exports.BeadSummarySchema = zod_1.z.object({
+    id: zod_1.z.string(),
+    title: zod_1.z.string(),
+    status: zod_1.z.string(),
+    priority: zod_1.z.number(),
+    type: zod_1.z.string(),
+    assignee: zod_1.z.string().optional(),
+    updatedAt: zod_1.z.string(),
+});
+exports.TaskListResponseSchema = zod_1.z.object({
+    kshetraId: zod_1.z.string(),
+    tasks: zod_1.z.array(exports.BeadSummarySchema),
+    error: zod_1.z.string().optional(),
+});
+exports.BeadDependencySchema = zod_1.z.object({
+    id: zod_1.z.string(),
+    title: zod_1.z.string().optional(),
+    type: zod_1.z.string().optional(),
+});
+exports.BeadDetailSchema = exports.BeadSummarySchema.extend({
+    description: zod_1.z.string().optional(),
+    notes: zod_1.z.string().optional(),
+    design: zod_1.z.string().optional(),
+    acceptance: zod_1.z.string().optional(),
+    createdAt: zod_1.z.string(),
+    dependencies: zod_1.z.array(exports.BeadDependencySchema),
+    blockedBy: zod_1.z.array(zod_1.z.string()),
+    parent: zod_1.z.string().optional(),
+});
+exports.NotificationSchema = zod_1.z.object({
+    ts: zod_1.z.string(),
+    event: zod_1.z.string(),
+    beadId: zod_1.z.string().optional(),
+    reason: zod_1.z.string().optional(),
+    remediation: zod_1.z.string().optional(),
+    message: zod_1.z.string(),
+});
+exports.NotificationListResponseSchema = zod_1.z.object({
+    kshetraId: zod_1.z.string(),
+    notifications: zod_1.z.array(exports.NotificationSchema),
+});
+exports.HealthSchema = zod_1.z.object({ ok: zod_1.z.literal(true), version: zod_1.z.string() });
+// ── Auth ────────────────────────────────────────────────────────────────────
+function extractToken(req) {
+    const q = req.query?.token;
+    if (typeof q === 'string' && q.length > 0)
+        return q;
+    const auth = req.headers['authorization'];
+    if (typeof auth === 'string' && auth.startsWith('Bearer ')) {
+        const t = auth.slice('Bearer '.length).trim();
+        if (t.length > 0)
+            return t;
+    }
+    return null;
+}
+// Returns true when the request is authorized; otherwise replies 401 and
+// returns false so the handler can bail.
+function requireToken(req, reply) {
+    const expected = (0, token_js_1.readToken)();
+    const provided = extractToken(req);
+    if (!expected || provided !== expected) {
+        reply.code(401).send({ error: 'unauthorized' });
+        return false;
+    }
+    return true;
+}
+// ── Data helpers ──────────────────────────────────────────────────────────────
+function findKshetra(id) {
+    return (0, registry_js_1.loadRegistry)().find(k => k.id === id) ?? null;
+}
+async function summarizeKshetra(kshetra) {
+    try {
+        const reader = (0, beads_read_js_1.beadsRead)(kshetra);
+        // Active list (open/in_progress/blocked/deferred) + closed list, so the
+        // counts cover every status without a wide-open `bd list --all`.
+        const [active, closed] = await Promise.all([reader.list(), reader.list({ status: 'closed' })]);
+        const counts = { open: 0, in_progress: 0, blocked: 0, closed: closed.length };
+        for (const t of active) {
+            if (t.status === 'open')
+                counts.open++;
+            else if (t.status === 'in_progress')
+                counts.in_progress++;
+            else if (t.status === 'blocked')
+                counts.blocked++;
+        }
+        const ks = (0, state_js_1.loadState)().kshetras[kshetra.id];
+        return {
+            id: kshetra.id,
+            name: kshetra.name,
+            counts,
+            phase: ks?.phase,
+            paused: ks?.paused,
+            stuck: ks?.stuck ? { since: ks.stuck.since, reason: ks.stuck.reason, remediation: ks.stuck.remediation } : undefined,
+        };
+    }
+    catch (err) {
+        return { id: kshetra.id, name: kshetra.name, error: err instanceof Error ? err.message : String(err) };
+    }
+}
+// ── Routes ────────────────────────────────────────────────────────────────────
+function registerPhalakaApi(app) {
+    // Health is unauthenticated (carries no task data).
+    app.get('/api/health', async () => exports.HealthSchema.parse({ ok: true, version: exports.PHALAKA_VERSION }));
+    app.get('/api/kshetras', async (req, reply) => {
+        if (!requireToken(req, reply))
+            return;
+        const summaries = await Promise.all((0, registry_js_1.loadRegistry)().map(summarizeKshetra));
+        return exports.KshetraListSchema.parse(summaries);
+    });
+    app.get('/api/kshetras/:id/tasks', async (req, reply) => {
+        if (!requireToken(req, reply))
+            return;
+        const { id } = req.params;
+        const kshetra = findKshetra(id);
+        if (!kshetra)
+            return reply.code(404).send({ error: `unknown kshetra: ${id}` });
+        const status = req.query?.status;
+        const result = await (0, beads_read_js_1.readKshetraTasks)(kshetra, status ? { status } : {});
+        if ('error' in result) {
+            return exports.TaskListResponseSchema.parse({ kshetraId: id, tasks: [], error: result.error });
+        }
+        return exports.TaskListResponseSchema.parse({ kshetraId: id, tasks: result.tasks });
+    });
+    app.get('/api/kshetras/:id/notifications', async (req, reply) => {
+        if (!requireToken(req, reply))
+            return;
+        const { id } = req.params;
+        const kshetra = findKshetra(id);
+        if (!kshetra)
+            return reply.code(404).send({ error: `unknown kshetra: ${id}` });
+        const query = req.query;
+        const sinceTs = query?.since;
+        const parsedLimit = query?.limit !== undefined ? Number(query.limit) : undefined;
+        const limit = parsedLimit !== undefined && Number.isInteger(parsedLimit) && parsedLimit >= 0
+            ? parsedLimit
+            : undefined;
+        const notifications = (0, notifications_js_1.readNotifications)(id, { sinceTs, limit });
+        return exports.NotificationListResponseSchema.parse({ kshetraId: id, notifications });
+    });
+    app.get('/api/kshetras/:id/tasks/:beadId', async (req, reply) => {
+        if (!requireToken(req, reply))
+            return;
+        const { id, beadId } = req.params;
+        const kshetra = findKshetra(id);
+        if (!kshetra)
+            return reply.code(404).send({ error: `unknown kshetra: ${id}` });
+        if (!(0, beads_read_js_1.isValidBeadId)(beadId))
+            return reply.code(400).send({ error: 'invalid bead id' });
+        try {
+            const detail = await (0, beads_read_js_1.beadsRead)(kshetra).show(beadId);
+            if (!detail)
+                return reply.code(404).send({ error: `unknown bead: ${beadId}` });
+            return exports.BeadDetailSchema.parse(detail);
+        }
+        catch (err) {
+            return reply.code(502).send({ error: err instanceof Error ? err.message : String(err) });
+        }
+    });
+}
+//# sourceMappingURL=api.js.map

package/dist/phalaka/api.js.map

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

package/dist/phalaka/beads-read.d.ts

@@ -0,0 +1,49 @@
+import type { KshetraConfig } from '../kshetra/config.js';
+export declare const LIST_CACHE_TTL_MS = 5000;
+export declare class BeadsReadError extends Error {
+    readonly cause?: unknown | undefined;
+    constructor(message: string, cause?: unknown | undefined);
+}
+export declare function isValidBeadId(id: string): boolean;
+export interface BeadSummary {
+    id: string;
+    title: string;
+    status: string;
+    priority: number;
+    type: string;
+    assignee?: string;
+    updatedAt: string;
+}
+export interface BeadDependency {
+    id: string;
+    title?: string;
+    type?: string;
+}
+export interface BeadDetail extends BeadSummary {
+    description?: string;
+    notes?: string;
+    design?: string;
+    acceptance?: string;
+    createdAt: string;
+    dependencies: BeadDependency[];
+    blockedBy: string[];
+    parent?: string;
+}
+export declare function clearBeadsReadCache(): void;
+export interface ListFilters {
+    status?: string;
+}
+export declare function beadsRead(kshetra: KshetraConfig): {
+    list(filters?: ListFilters): Promise<BeadSummary[]>;
+    show(id: string): Promise<BeadDetail | null>;
+};
+export type KshetraTasksResult = {
+    kshetra: KshetraConfig;
+    tasks: BeadSummary[];
+} | {
+    kshetra: KshetraConfig;
+    error: string;
+};
+export declare function readKshetraTasks(kshetra: KshetraConfig, filters?: ListFilters): Promise<KshetraTasksResult>;
+export declare function readAllKshetraTasks(kshetras: KshetraConfig[], filters?: ListFilters): Promise<KshetraTasksResult[]>;
+//# sourceMappingURL=beads-read.d.ts.map

package/dist/phalaka/beads-read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"beads-read.d.ts","sourceRoot":"","sources":["../../src/phalaka/beads-read.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAY1D,eAAO,MAAM,iBAAiB,OAAQ,CAAC;AAEvC,qBAAa,cAAe,SAAQ,KAAK;aAGrB,KAAK,CAAC,EAAE,OAAO;gBAD/B,OAAO,EAAE,MAAM,EACC,KAAK,CAAC,EAAE,OAAO,YAAA;CAKlC;AAMD,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAEjD;AAID,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,UAAW,SAAQ,WAAW;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,cAAc,EAAE,CAAC;IAC/B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAiGD,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAsBD,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,aAAa;mBAKxB,WAAW,GAAQ,OAAO,CAAC,WAAW,EAAE,CAAC;aAO9C,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;EAYrD;AAQD,MAAM,MAAM,kBAAkB,GAC1B;IAAE,OAAO,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,WAAW,EAAE,CAAA;CAAE,GAChD;IAAE,OAAO,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9C,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,aAAa,EACtB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,kBAAkB,CAAC,CAO7B;AAED,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,aAAa,EAAE,EACzB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAE/B"}