@jamesaphoenix/tx-api-server 0.1.1

package/dist/routes/invariants.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Invariant Route Handlers
+ *
+ * Implements invariant endpoint handlers using Effect HttpApiBuilder.
+ * Manages system invariants and check recording.
+ */
+import { DocService } from "@jamesaphoenix/tx-core";
+export declare const InvariantsLive: import("effect/Layer").Layer<import("@effect/platform/HttpApiGroup").ApiGroup<"tx", "invariants">, never, DocService>;
+//# sourceMappingURL=invariants.d.ts.map

package/dist/routes/invariants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invariants.d.ts","sourceRoot":"","sources":["../../src/routes/invariants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAkCnD,eAAO,MAAM,cAAc,uHAyC1B,CAAA"}

package/dist/routes/invariants.js

@@ -0,0 +1,64 @@
+/**
+ * Invariant Route Handlers
+ *
+ * Implements invariant endpoint handlers using Effect HttpApiBuilder.
+ * Manages system invariants and check recording.
+ */
+import { HttpApiBuilder } from "@effect/platform";
+import { Effect } from "effect";
+import { DocService } from "@jamesaphoenix/tx-core";
+import { TxApi, NotFound, mapCoreError } from "../api.js";
+// -----------------------------------------------------------------------------
+// Serialization Helpers
+// -----------------------------------------------------------------------------
+const serializeInvariant = (inv) => ({
+    id: inv.id,
+    rule: inv.rule,
+    enforcement: inv.enforcement,
+    docId: inv.docId,
+    subsystem: inv.subsystem,
+    testRef: inv.testRef,
+    lintRule: inv.lintRule,
+    promptRef: inv.promptRef,
+    status: inv.status,
+    createdAt: inv.createdAt.toISOString(),
+});
+const serializeInvariantCheck = (check) => ({
+    id: check.id,
+    invariantId: check.invariantId,
+    passed: check.passed,
+    details: check.details,
+    checkedAt: check.checkedAt.toISOString(),
+    durationMs: check.durationMs,
+});
+// -----------------------------------------------------------------------------
+// Handler Layer
+// -----------------------------------------------------------------------------
+export const InvariantsLive = HttpApiBuilder.group(TxApi, "invariants", (handlers) => handlers
+    .handle("listInvariants", ({ urlParams }) => Effect.gen(function* () {
+    const docService = yield* DocService;
+    const filter = {};
+    if (urlParams.subsystem) {
+        filter.subsystem = urlParams.subsystem;
+    }
+    if (urlParams.enforcement) {
+        filter.enforcement = urlParams.enforcement;
+    }
+    const invariants = yield* docService.listInvariants(filter);
+    return { invariants: invariants.map(serializeInvariant) };
+}).pipe(Effect.mapError(mapCoreError)))
+    .handle("getInvariant", ({ path }) => Effect.gen(function* () {
+    const docService = yield* DocService;
+    const invariants = yield* docService.listInvariants();
+    const inv = invariants.find(i => i.id === path.id);
+    if (!inv) {
+        return yield* Effect.fail(new NotFound({ message: `Invariant not found: ${path.id}` }));
+    }
+    return serializeInvariant(inv);
+}).pipe(Effect.mapError(mapCoreError)))
+    .handle("checkInvariant", ({ path, payload }) => Effect.gen(function* () {
+    const docService = yield* DocService;
+    const check = yield* docService.recordInvariantCheck(path.id, payload.passed, payload.details, payload.durationMs);
+    return serializeInvariantCheck(check);
+}).pipe(Effect.mapError(mapCoreError))));
+//# sourceMappingURL=invariants.js.map

package/dist/routes/invariants.js.map

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

package/dist/routes/learnings.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Learning Route Handlers
+ *
+ * Implements learning and file learning endpoint handlers.
+ */
+import { LearningService, FileLearningService } from "@jamesaphoenix/tx-core";
+export declare const LearningsLive: import("effect/Layer").Layer<import("@effect/platform/HttpApiGroup").ApiGroup<"tx", "learnings">, never, LearningService | FileLearningService>;
+//# sourceMappingURL=learnings.d.ts.map

package/dist/routes/learnings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"learnings.d.ts","sourceRoot":"","sources":["../../src/routes/learnings.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AAO7E,eAAO,MAAM,aAAa,iJA0GzB,CAAA"}

package/dist/routes/learnings.js

@@ -0,0 +1,93 @@
+/**
+ * Learning Route Handlers
+ *
+ * Implements learning and file learning endpoint handlers.
+ */
+import { HttpApiBuilder } from "@effect/platform";
+import { Effect } from "effect";
+import { serializeLearning, serializeLearningWithScore, serializeFileLearning } from "@jamesaphoenix/tx-types";
+import { LearningService, FileLearningService } from "@jamesaphoenix/tx-core";
+import { TxApi, mapCoreError } from "../api.js";
+// -----------------------------------------------------------------------------
+// Handler Layer
+// -----------------------------------------------------------------------------
+export const LearningsLive = HttpApiBuilder.group(TxApi, "learnings", (handlers) => handlers
+    .handle("searchLearnings", ({ urlParams }) => Effect.gen(function* () {
+    const learningService = yield* LearningService;
+    const limit = urlParams.limit ?? 10;
+    let learnings;
+    if (!urlParams.query) {
+        learnings = yield* learningService.getRecent(limit);
+    }
+    else {
+        learnings = yield* learningService.search({
+            query: urlParams.query,
+            limit,
+            minScore: urlParams.minScore ?? undefined,
+            category: urlParams.category ?? undefined,
+        });
+    }
+    // Ensure all results have score fields
+    const isWithScore = (l) => "relevanceScore" in l;
+    return {
+        learnings: learnings.map(l => isWithScore(l) ? serializeLearningWithScore(l) : serializeLearningWithScore({
+            ...l,
+            relevanceScore: 1,
+            bm25Score: 0,
+            vectorScore: 0,
+            recencyScore: 0,
+            rrfScore: 0,
+            bm25Rank: 0,
+            vectorRank: 0,
+        })),
+    };
+}).pipe(Effect.mapError(mapCoreError)))
+    .handle("getLearning", ({ path }) => Effect.gen(function* () {
+    const learningService = yield* LearningService;
+    const learning = yield* learningService.get(path.id);
+    return serializeLearning(learning);
+}).pipe(Effect.mapError(mapCoreError)))
+    .handle("createLearning", ({ payload }) => Effect.gen(function* () {
+    const learningService = yield* LearningService;
+    const learning = yield* learningService.create({
+        content: payload.content,
+        sourceType: payload.sourceType ?? "manual",
+        sourceRef: payload.sourceRef ?? undefined,
+        category: payload.category ?? undefined,
+        keywords: payload.keywords ?? undefined,
+    });
+    return serializeLearning(learning);
+}).pipe(Effect.mapError(mapCoreError)))
+    .handle("updateHelpfulness", ({ path, payload }) => Effect.gen(function* () {
+    const learningService = yield* LearningService;
+    yield* learningService.updateOutcome(path.id, payload.score);
+    return { success: true, id: path.id, score: payload.score };
+}).pipe(Effect.mapError(mapCoreError)))
+    .handle("getContext", ({ path }) => Effect.gen(function* () {
+    const learningService = yield* LearningService;
+    const result = yield* learningService.getContextForTask(path.taskId);
+    return {
+        taskId: result.taskId,
+        taskTitle: result.taskTitle,
+        learnings: result.learnings.map(serializeLearningWithScore),
+        searchQuery: result.searchQuery,
+        searchDuration: result.searchDuration,
+    };
+}).pipe(Effect.mapError(mapCoreError)))
+    .handle("listFileLearnings", ({ urlParams }) => Effect.gen(function* () {
+    const fileLearningService = yield* FileLearningService;
+    const learnings = urlParams.path
+        ? yield* fileLearningService.recall(urlParams.path)
+        : yield* fileLearningService.getAll();
+    return { learnings: learnings.map(serializeFileLearning) };
+}).pipe(Effect.mapError(mapCoreError)))
+    .handle("createFileLearning", ({ payload }) => Effect.gen(function* () {
+    const fileLearningService = yield* FileLearningService;
+    const learning = yield* fileLearningService.create({
+        filePattern: payload.filePattern,
+        note: payload.note,
+        taskId: payload.taskId ?? undefined,
+    });
+    return serializeFileLearning(learning);
+}).pipe(Effect.mapError(mapCoreError))));
+//# sourceMappingURL=learnings.js.map

package/dist/routes/learnings.js.map

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

package/dist/routes/runs.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Run Route Handlers
+ *
+ * Implements run tracking endpoint handlers.
+ */
+import { RunRepository } from "@jamesaphoenix/tx-core";
+export declare const RunsLive: import("effect/Layer").Layer<import("@effect/platform/HttpApiGroup").ApiGroup<"tx", "runs">, never, RunRepository>;
+//# sourceMappingURL=runs.d.ts.map

package/dist/routes/runs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runs.d.ts","sourceRoot":"","sources":["../../src/routes/runs.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AA+BtD,eAAO,MAAM,QAAQ,oHA0NpB,CAAA"}

package/dist/routes/runs.js

@@ -0,0 +1,195 @@
+/**
+ * Run Route Handlers
+ *
+ * Implements run tracking endpoint handlers.
+ */
+import { HttpApiBuilder } from "@effect/platform";
+import { Effect } from "effect";
+import { serializeRun } from "@jamesaphoenix/tx-types";
+import { RunRepository } from "@jamesaphoenix/tx-core";
+import { TxApi, NotFound, BadRequest, mapCoreError } from "../api.js";
+import { parseTranscript, findMatchingTranscript, isAllowedTranscriptPath } from "../utils/transcript-parser.js";
+import { readLogFile, isAllowedRunPath } from "../utils/log-reader.js";
+const parseRunCursor = (cursor) => {
+    const colonIndex = cursor.lastIndexOf(":");
+    if (colonIndex === -1)
+        return null;
+    return {
+        startedAt: cursor.slice(0, colonIndex),
+        id: cursor.slice(colonIndex + 1),
+    };
+};
+const buildRunCursor = (run) => {
+    return `${run.startedAt.toISOString()}:${run.id}`;
+};
+// -----------------------------------------------------------------------------
+// Handler Layer
+// -----------------------------------------------------------------------------
+export const RunsLive = HttpApiBuilder.group(TxApi, "runs", (handlers) => handlers
+    .handle("listRuns", ({ urlParams }) => Effect.gen(function* () {
+    const runRepo = yield* RunRepository;
+    const limit = urlParams.limit ?? 20;
+    // Get runs based on filters
+    let allRuns;
+    if (urlParams.taskId) {
+        allRuns = yield* runRepo.findByTaskId(urlParams.taskId);
+    }
+    else if (urlParams.status && urlParams.status.split(",").length === 1) {
+        allRuns = yield* runRepo.findByStatus(urlParams.status);
+    }
+    else {
+        // TODO: Push agent/multi-status filtering down to the repository layer
+        // to avoid loading excessive runs into memory for in-JS filtering.
+        // Using a high limit to reduce silent data loss from in-memory filtering.
+        allRuns = yield* runRepo.findRecent(10_000);
+    }
+    // Apply additional filters in memory
+    let filtered = [...allRuns];
+    if (urlParams.agent) {
+        filtered = filtered.filter(r => r.agent === urlParams.agent);
+    }
+    if (urlParams.status && urlParams.status.split(",").length > 1) {
+        const statusFilter = urlParams.status.split(",").filter(Boolean);
+        filtered = filtered.filter(r => statusFilter.includes(r.status));
+    }
+    // Sort by startedAt DESC, id ASC
+    filtered.sort((a, b) => {
+        const aTime = a.startedAt.getTime();
+        const bTime = b.startedAt.getTime();
+        if (aTime !== bTime)
+            return bTime - aTime;
+        return a.id.localeCompare(b.id);
+    });
+    // Apply cursor pagination
+    let startIndex = 0;
+    if (urlParams.cursor) {
+        const parsed = parseRunCursor(urlParams.cursor);
+        if (parsed) {
+            const cursorTime = new Date(parsed.startedAt).getTime();
+            startIndex = filtered.findIndex(r => r.startedAt.getTime() < cursorTime ||
+                (r.startedAt.getTime() === cursorTime && r.id > parsed.id));
+            if (startIndex === -1)
+                startIndex = filtered.length;
+        }
+    }
+    const total = filtered.length;
+    const paginated = filtered.slice(startIndex, startIndex + limit + 1);
+    const hasMore = paginated.length > limit;
+    const resultRuns = hasMore ? paginated.slice(0, limit) : paginated;
+    return {
+        runs: resultRuns.map(serializeRun),
+        nextCursor: hasMore && resultRuns.length > 0
+            ? buildRunCursor(resultRuns[resultRuns.length - 1])
+            : null,
+        hasMore,
+        total,
+    };
+}).pipe(Effect.mapError(mapCoreError)))
+    .handle("getRun", ({ path }) => Effect.gen(function* () {
+    const runRepo = yield* RunRepository;
+    const found = yield* runRepo.findById(path.id);
+    if (!found) {
+        return yield* Effect.fail(new NotFound({ message: `Run not found: ${path.id}` }));
+    }
+    // Parse transcript if available
+    let messages = [];
+    let transcriptPath = found.transcriptPath;
+    // If no explicit transcript path, try to find one by timestamp correlation
+    if (!transcriptPath) {
+        // Derive project root from DB path (e.g. /path/to/project/.tx/tasks.db -> /path/to/project)
+        // Falls back to process.cwd() if TX_DB_PATH is not absolute
+        const dbPath = process.env.TX_DB_PATH ?? "";
+        const projectRoot = dbPath.includes("/.tx/")
+            ? dbPath.slice(0, dbPath.indexOf("/.tx/"))
+            : process.cwd();
+        const discovered = yield* Effect.tryPromise({
+            try: () => findMatchingTranscript(projectRoot, found.startedAt, found.endedAt),
+            catch: () => null,
+        });
+        transcriptPath = discovered;
+    }
+    if (transcriptPath) {
+        const parsed = yield* parseTranscript(transcriptPath).pipe(Effect.catchAll(() => Effect.succeed([])));
+        messages = parsed;
+    }
+    return {
+        run: serializeRun(found),
+        messages: messages,
+    };
+}).pipe(Effect.mapError(mapCoreError)))
+    .handle("createRun", ({ payload }) => Effect.gen(function* () {
+    // Security: validate transcriptPath before storing
+    if (payload.transcriptPath && !isAllowedTranscriptPath(payload.transcriptPath)) {
+        return yield* Effect.fail(new BadRequest({ message: "Invalid transcriptPath: must be under ~/.claude/ or .tx/" }));
+    }
+    // Security: validate contextInjected path is under .tx/runs/ (prefix match, not substring)
+    if (payload.contextInjected) {
+        if (!isAllowedRunPath(payload.contextInjected)) {
+            return yield* Effect.fail(new BadRequest({ message: "Invalid contextInjected: must be under .tx/runs/" }));
+        }
+    }
+    const runRepo = yield* RunRepository;
+    const run = yield* runRepo.create({
+        taskId: payload.taskId,
+        agent: payload.agent,
+        pid: payload.pid,
+        transcriptPath: payload.transcriptPath,
+        contextInjected: payload.contextInjected,
+        metadata: payload.metadata,
+    });
+    return serializeRun(run);
+}).pipe(Effect.mapError(mapCoreError)))
+    .handle("updateRun", ({ path, payload }) => Effect.gen(function* () {
+    // Security: validate transcriptPath before storing
+    if (payload.transcriptPath && !isAllowedTranscriptPath(payload.transcriptPath)) {
+        return yield* Effect.fail(new BadRequest({ message: "Invalid transcriptPath: must be under ~/.claude/ or .tx/" }));
+    }
+    const runRepo = yield* RunRepository;
+    yield* runRepo.update(path.id, {
+        status: payload.status,
+        endedAt: payload.endedAt ? new Date(payload.endedAt) : undefined,
+        exitCode: payload.exitCode,
+        summary: payload.summary,
+        errorMessage: payload.errorMessage,
+        transcriptPath: payload.transcriptPath,
+    });
+    const updated = yield* runRepo.findById(path.id);
+    if (!updated) {
+        return yield* Effect.fail(new NotFound({ message: `Run not found: ${path.id}` }));
+    }
+    return serializeRun(updated);
+}).pipe(Effect.mapError(mapCoreError)))
+    .handle("getRunStdout", ({ path, urlParams }) => Effect.gen(function* () {
+    const runRepo = yield* RunRepository;
+    const found = yield* runRepo.findById(path.id);
+    if (!found) {
+        return yield* Effect.fail(new NotFound({ message: `Run not found: ${path.id}` }));
+    }
+    if (!found.stdoutPath) {
+        return { content: "", truncated: false };
+    }
+    return yield* readLogFile(found.stdoutPath, urlParams.tail ?? 0).pipe(Effect.catchAll(() => Effect.succeed({ content: "", truncated: false })));
+}).pipe(Effect.mapError(mapCoreError)))
+    .handle("getRunStderr", ({ path, urlParams }) => Effect.gen(function* () {
+    const runRepo = yield* RunRepository;
+    const found = yield* runRepo.findById(path.id);
+    if (!found) {
+        return yield* Effect.fail(new NotFound({ message: `Run not found: ${path.id}` }));
+    }
+    if (!found.stderrPath) {
+        return { content: "", truncated: false };
+    }
+    return yield* readLogFile(found.stderrPath, urlParams.tail ?? 0).pipe(Effect.catchAll(() => Effect.succeed({ content: "", truncated: false })));
+}).pipe(Effect.mapError(mapCoreError)))
+    .handle("getRunContext", ({ path }) => Effect.gen(function* () {
+    const runRepo = yield* RunRepository;
+    const found = yield* runRepo.findById(path.id);
+    if (!found) {
+        return yield* Effect.fail(new NotFound({ message: `Run not found: ${path.id}` }));
+    }
+    if (!found.contextInjected) {
+        return { content: "", truncated: false };
+    }
+    return yield* readLogFile(found.contextInjected).pipe(Effect.catchAll(() => Effect.succeed({ content: "", truncated: false })));
+}).pipe(Effect.mapError(mapCoreError))));
+//# sourceMappingURL=runs.js.map

package/dist/routes/runs.js.map

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

package/dist/routes/sync.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Sync Route Handlers
+ *
+ * Implements JSONL-based git-tracked sync endpoint handlers.
+ */
+import { SyncService } from "@jamesaphoenix/tx-core";
+export declare const SyncLive: import("effect/Layer").Layer<import("@effect/platform/HttpApiGroup").ApiGroup<"tx", "sync">, never, SyncService>;
+//# sourceMappingURL=sync.d.ts.map

package/dist/routes/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/routes/sync.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AAiCpD,eAAO,MAAM,QAAQ,kHA2CpB,CAAA"}

package/dist/routes/sync.js

@@ -0,0 +1,67 @@
+/**
+ * Sync Route Handlers
+ *
+ * Implements JSONL-based git-tracked sync endpoint handlers.
+ */
+import { HttpApiBuilder } from "@effect/platform";
+import { Effect } from "effect";
+import { resolve, sep } from "node:path";
+import { SyncService } from "@jamesaphoenix/tx-core";
+import { TxApi, BadRequest, mapCoreError } from "../api.js";
+// -----------------------------------------------------------------------------
+// Path Validation
+// -----------------------------------------------------------------------------
+/**
+ * Validate that a user-provided sync file path does not escape the project
+ * directory via path traversal (e.g. "../../etc/passwd" or absolute paths
+ * outside the project root).
+ *
+ * Returns Effect that fails with BadRequest on invalid path.
+ */
+const validateSyncPath = (userPath) => {
+    if (userPath === undefined)
+        return Effect.succeed(undefined);
+    const projectRoot = process.cwd();
+    const resolved = resolve(projectRoot, userPath);
+    if (!resolved.startsWith(projectRoot + sep)) {
+        return Effect.fail(new BadRequest({
+            message: "Path traversal rejected: sync file path must be within the project directory",
+        }));
+    }
+    return Effect.succeed(userPath);
+};
+// -----------------------------------------------------------------------------
+// Handler Layer
+// -----------------------------------------------------------------------------
+export const SyncLive = HttpApiBuilder.group(TxApi, "sync", (handlers) => handlers
+    .handle("syncExport", ({ payload }) => Effect.gen(function* () {
+    const safePath = yield* validateSyncPath(payload.path);
+    const syncService = yield* SyncService;
+    const result = yield* syncService.export(safePath ?? undefined);
+    return { opCount: result.opCount, path: result.path };
+}).pipe(Effect.mapError(mapCoreError)))
+    .handle("syncImport", ({ payload }) => Effect.gen(function* () {
+    const safePath = yield* validateSyncPath(payload.path);
+    const syncService = yield* SyncService;
+    const result = yield* syncService.import(safePath ?? undefined);
+    return { imported: result.imported, skipped: result.skipped, conflicts: result.conflicts };
+}).pipe(Effect.mapError(mapCoreError)))
+    .handle("syncStatus", () => Effect.gen(function* () {
+    const syncService = yield* SyncService;
+    const status = yield* syncService.status();
+    return {
+        dbTaskCount: status.dbTaskCount,
+        jsonlOpCount: status.jsonlOpCount,
+        lastExport: status.lastExport?.toISOString() ?? null,
+        lastImport: status.lastImport?.toISOString() ?? null,
+        isDirty: status.isDirty,
+        autoSyncEnabled: status.autoSyncEnabled,
+    };
+}).pipe(Effect.mapError(mapCoreError)))
+    .handle("syncCompact", ({ payload }) => Effect.gen(function* () {
+    const safePath = yield* validateSyncPath(payload.path);
+    const syncService = yield* SyncService;
+    const result = yield* syncService.compact(safePath ?? undefined);
+    return { before: result.before, after: result.after };
+}).pipe(Effect.mapError(mapCoreError))));
+//# sourceMappingURL=sync.js.map

package/dist/routes/sync.js.map

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

package/dist/routes/tasks.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Task Route Handlers
+ *
+ * Implements task endpoint handlers using Effect HttpApiBuilder.
+ * All responses return TaskWithDeps per Doctrine Rule 1.
+ */
+import { TaskService, ReadyService, DependencyService, HierarchyService } from "@jamesaphoenix/tx-core";
+export declare const TasksLive: import("effect/Layer").Layer<import("@effect/platform/HttpApiGroup").ApiGroup<"tx", "tasks">, never, TaskService | ReadyService | DependencyService | HierarchyService>;
+//# sourceMappingURL=tasks.d.ts.map

package/dist/routes/tasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../src/routes/tasks.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AA6BvG,eAAO,MAAM,SAAS,yKAwLrB,CAAA"}