@knpkv/jcf-web 0.2.0

package/dist/server/Api.js

@@ -0,0 +1,98 @@
+/** Authenticated HTTP routes. Browser-safe payload schemas live in shared/contracts. */
+import { SessionAgentSettings } from "@knpkv/jira-clockify/agent/agentSettings.js";
+import { Schema } from "effect";
+import { HttpApi, HttpApiEndpoint, HttpApiGroup, HttpApiMiddleware, HttpApiSchema, HttpApiSecurity } from "effect/http-api";
+import { ApiError, ConfirmPayload, Day, DescribeRowRequest, DescribeRowResponse, DescribeSavedEntryRequest, DescribeSavedEntryResponse, ForbiddenApiError, ManualPayload, OwnershipPayload, OwnershipResult, PlanExpiredError, ProposalRejectedError, SavedWeek, StandingPayload, StandingResult, UnauthorizedApiError, UpdateSavedEntryRequest, UpdateSavedEntryResponse, WeekPlan, WeekScope, WriteResult } from "../shared/contracts.js";
+export * from "../shared/contracts.js";
+export class OwnerSessionAuth extends HttpApiMiddleware.Service()("@knpkv/jcf-web/OwnerSessionAuth", {
+    error: [UnauthorizedApiError, ForbiddenApiError],
+    security: {
+        ownerCookie: HttpApiSecurity.apiKey({ in: "cookie", key: "jcf_owner" })
+    }
+}) {
+}
+export class WeekGroup extends HttpApiGroup.make("week")
+    .add(HttpApiEndpoint.get("saved", "/saved", {
+    query: Schema.Struct({ monday: Schema.optional(Day), only: Schema.optional(WeekScope) }),
+    success: SavedWeek
+}))
+    .add(HttpApiEndpoint.get("read", "/", {
+    error: [ApiError, PlanExpiredError],
+    query: Schema.Struct({ monday: Schema.optional(Day), only: Schema.optional(WeekScope) }),
+    success: WeekPlan
+}))
+    .add(HttpApiEndpoint.get("stream", "/stream", {
+    error: [ApiError, PlanExpiredError],
+    query: Schema.Struct({ monday: Schema.optional(Day), only: Schema.optional(WeekScope) }),
+    success: HttpApiSchema.StreamUint8Array({ contentType: "application/x-ndjson" })
+}))
+    .add(HttpApiEndpoint.get("recorded", "/recorded", {
+    error: [ApiError, PlanExpiredError],
+    query: Schema.Struct({ planId: Schema.String }),
+    success: HttpApiSchema.StreamUint8Array({ contentType: "application/x-ndjson" })
+}))
+    .add(HttpApiEndpoint.get("recordedOnly", "/recorded-only", {
+    error: [ApiError, PlanExpiredError],
+    query: Schema.Struct({ monday: Schema.optional(Day), only: Schema.optional(WeekScope) }),
+    success: HttpApiSchema.StreamUint8Array({ contentType: "application/x-ndjson" })
+}))
+    .prefix("/api/week") {
+}
+export class RowsGroup extends HttpApiGroup.make("rows")
+    .add(HttpApiEndpoint.post("describe", "/describe", {
+    error: [ApiError, PlanExpiredError],
+    payload: DescribeRowRequest,
+    success: DescribeRowResponse
+}))
+    .add(HttpApiEndpoint.post("confirm", "/confirm", {
+    error: [ApiError, PlanExpiredError, ProposalRejectedError],
+    payload: ConfirmPayload,
+    success: WriteResult
+}))
+    .add(HttpApiEndpoint.post("manual", "/manual", {
+    error: [ApiError, ProposalRejectedError],
+    payload: ManualPayload,
+    success: WriteResult
+}))
+    .prefix("/api/rows") {
+}
+export class ConfigGroup extends HttpApiGroup.make("config")
+    .add(HttpApiEndpoint.get("agent", "/agent", { success: SessionAgentSettings }))
+    .add(HttpApiEndpoint.post("saveAgent", "/agent", {
+    payload: SessionAgentSettings,
+    success: SessionAgentSettings,
+    error: ApiError
+}))
+    .add(HttpApiEndpoint.post("standing", "/standing", {
+    error: [ApiError, ProposalRejectedError],
+    payload: StandingPayload,
+    success: StandingResult
+}))
+    .add(HttpApiEndpoint.post("mine", "/mine", {
+    error: [ApiError, ProposalRejectedError],
+    payload: OwnershipPayload,
+    success: OwnershipResult
+}))
+    .prefix("/api/config") {
+}
+export class EntriesGroup extends HttpApiGroup.make("entries")
+    .add(HttpApiEndpoint.post("update", "/update", {
+    error: [ApiError, PlanExpiredError, ProposalRejectedError],
+    payload: UpdateSavedEntryRequest,
+    success: UpdateSavedEntryResponse
+}))
+    .add(HttpApiEndpoint.post("describe", "/describe", {
+    error: [ApiError, PlanExpiredError],
+    payload: DescribeSavedEntryRequest,
+    success: DescribeSavedEntryResponse
+}))
+    .prefix("/api/entries") {
+}
+export class JcfWebApi extends HttpApi.make("JcfWebApi")
+    .add(WeekGroup)
+    .add(RowsGroup)
+    .add(ConfigGroup)
+    .add(EntriesGroup)
+    .middleware(OwnerSessionAuth) {
+}
+//# sourceMappingURL=Api.js.map

package/dist/server/Api.js.map

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

package/dist/server/Confirm.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Accepting a row, and logging time by hand.
+ *
+ * **Mental model**
+ *
+ * - **Held evidence, live arithmetic.** The plan says what the sessions accounted for; Jira and
+ *   Clockify are asked again, at this moment, what they already hold. The write is the difference.
+ *   That is the property that makes confirming the same row twice safe, and it is why nothing here
+ *   trusts a number that came from a browser except the two a person is allowed to choose.
+ * - **An override re-tallies the bucket it moves to.** A row moved to another Issue Key may land on a
+ *   day that already holds time the plan knew nothing about; sizing the write from the plan would log
+ *   that time twice.
+ * - **Outcomes, not HTTP.** Every refusal is a tagged value, so the transport maps them to status
+ *   codes and a test reads them directly.
+ *
+ * @module
+ */
+import { AgentWrite, ReconcileService } from "@knpkv/jira-clockify";
+import { Effect } from "effect";
+import { MINIMUM_WRITE_SECONDS } from "../shared/writePlanning.js";
+import { ProposalRejectedError, type WriteResultResponse } from "./Api.js";
+import { type HeldPlan } from "./WeekPlan.js";
+/** The engine operations these functions need. Narrow, so a test provides only what it must. */
+export type WriteCapableService = Pick<ReconcileService.ReconcileServiceContract, "applyToClockify" | "applyToJira" | "refreshRecordedTime">;
+/** What a confirmation did, or why it did nothing. */
+export type ConfirmOutcome = {
+    readonly _tag: "Written";
+    readonly result: WriteResultResponse;
+} | {
+    readonly _tag: "NothingOwed";
+    readonly result: WriteResultResponse;
+} | {
+    readonly _tag: "UnknownRow";
+}
+/** A block position that is not part of this row — a page confirming against a plan that moved. */
+ | {
+    readonly _tag: "UnknownBlocks";
+} | {
+    readonly _tag: "PastEvidence";
+    readonly maxSeconds: number;
+} | {
+    readonly _tag: "BelowMinimum";
+    readonly minimumSeconds: number;
+} | {
+    readonly _tag: "RunningTimer";
+    readonly reason: string;
+} | {
+    readonly _tag: "NoTargets";
+};
+export interface ConfirmRequest {
+    readonly rowId: string;
+    /** Which of the row's blocks to write, by position. Absent means the whole row. */
+    readonly blocks: ReadonlyArray<number> | undefined;
+    readonly seconds: number | undefined;
+    readonly ticketKey: string | undefined;
+    readonly note: string | undefined;
+    /** Which systems to write. Absent means the ones the plan was read under. */
+    readonly targets: AgentWrite.WriteTargets | undefined;
+}
+/**
+ * Write one confirmed row.
+ *
+ * `summaryOf` supplies the issue title Clockify has no other way to know. It is asked for after the
+ * row is known to be writable and is expected to answer null on failure: a missing title must never
+ * cost a write that is otherwise correct.
+ */
+export declare const confirmProposal: (options: {
+    readonly service: WriteCapableService;
+    readonly plan: HeldPlan;
+    readonly request: ConfirmRequest;
+    readonly summaryOf: (ticketKey: string) => Effect.Effect<string | null>;
+}) => Effect.Effect<ConfirmOutcome, ReconcileService.ReconcileError>;
+export interface ManualRequest {
+    readonly day: string;
+    readonly ticketKey: string;
+    readonly seconds: number;
+    readonly startClock: string | undefined;
+    readonly note: string | undefined;
+    readonly targets: AgentWrite.WriteTargets;
+}
+/**
+ * Log time no session evidences.
+ *
+ * Not a proposal, so not sized to a gap and not routed through `applyProposal`: a person typing
+ * thirty minutes means add thirty minutes to both systems, the way `jcf timer log` has always
+ * behaved. Nothing is subtracted, so typing it twice logs it twice — which is what typing it twice
+ * means.
+ */
+export declare const logManualEntry: (options: {
+    readonly service: Pick<WriteCapableService, "applyToClockify" | "applyToJira">;
+    readonly request: ManualRequest;
+    readonly summaryOf: (ticketKey: string) => Effect.Effect<string | null>;
+}) => Effect.Effect<WriteResultResponse, ProposalRejectedError>;
+export { MINIMUM_WRITE_SECONDS };

package/dist/server/Confirm.js

@@ -0,0 +1,243 @@
+/**
+ * Accepting a row, and logging time by hand.
+ *
+ * **Mental model**
+ *
+ * - **Held evidence, live arithmetic.** The plan says what the sessions accounted for; Jira and
+ *   Clockify are asked again, at this moment, what they already hold. The write is the difference.
+ *   That is the property that makes confirming the same row twice safe, and it is why nothing here
+ *   trusts a number that came from a browser except the two a person is allowed to choose.
+ * - **An override re-tallies the bucket it moves to.** A row moved to another Issue Key may land on a
+ *   day that already holds time the plan knew nothing about; sizing the write from the plan would log
+ *   that time twice.
+ * - **Outcomes, not HTTP.** Every refusal is a tagged value, so the transport maps them to status
+ *   codes and a test reads them directly.
+ *
+ * @module
+ */
+import { AgentWrite, ReconcileService, SourceConsumption, Time } from "@knpkv/jira-clockify";
+import { Clock, Effect } from "effect";
+import { MINIMUM_WRITE_SECONDS, prepareProposal } from "../shared/writePlanning.js";
+import { ProposalRejectedError } from "./Api.js";
+import { evidenceBlockKey, evidenceMarker, reconcileConsumption } from "./WeekPlan.js";
+import { planSides } from "./WeekPlan.js";
+/**
+ * Nothing was owed on the sides that were asked for.
+ *
+ * A side nobody asked about is `Skipped` rather than `NothingOwed`: its gap may well still be there,
+ * and saying "already holds this time" about a system that was never read would be a claim this run
+ * cannot make.
+ */
+const nothingOwed = (description, targets) => {
+    const asked = { _tag: "NothingOwed" };
+    const unasked = { _tag: "Skipped" };
+    const clockify = targets.clockify ? asked : unasked;
+    const jira = targets.jira ? asked : unasked;
+    return {
+        clockify,
+        description,
+        jira,
+        lines: ["· already logged where asked — nothing written", ...AgentWrite.writeOutcomeLines({ clockify, jira })]
+    };
+};
+/**
+ * Write one confirmed row.
+ *
+ * `summaryOf` supplies the issue title Clockify has no other way to know. It is asked for after the
+ * row is known to be writable and is expected to answer null on failure: a missing title must never
+ * cost a write that is otherwise correct.
+ */
+export const confirmProposal = (options) => Effect.gen(function* () {
+    const evidence = options.plan.evidence.get(options.request.rowId);
+    if (evidence === undefined)
+        return { _tag: "UnknownRow" };
+    const proposal = evidence.proposal;
+    let consumption = options.plan.consumption;
+    const prepared = prepareProposal({
+        evidence: { ...proposal, credited: proposal.sessionSeconds },
+        request: options.request,
+        targets: planSides(options.plan),
+        consumed: (block, source) => consumption.get(evidenceBlockKey(evidence.rowId, block))?.[source] ?? 0
+    });
+    if (prepared._tag !== "Prepared")
+        return prepared;
+    // Re-read the requested providers and timer state from retained evidence. Cached browser totals
+    // never authorize writes, and a timer started after the week was read must still withhold its day.
+    const refreshed = yield* options.service.refreshRecordedTime(Time.isoWeekPeriod(new Date(`${options.plan.plan.monday}T12:00:00`)), { ...options.plan.report, sides: prepared.targets }, { jiraIssueKeys: [...options.plan.jiraReceiptIssueKeys, prepared.ticketKey] });
+    const retainedScopes = options.plan.boundScopes;
+    const currentScopes = refreshed.sourceScopes;
+    const expectedScopes = currentScopes === undefined
+        ? undefined
+        : {
+            clockify: currentScopes.clockify === null
+                ? null
+                : retainedScopes.clockify ?? currentScopes.clockify,
+            jira: currentScopes.jira === null ? null : retainedScopes.jira ?? currentScopes.jira
+        };
+    if (expectedScopes === undefined || currentScopes === undefined ||
+        (prepared.targets.clockify &&
+            expectedScopes.clockify !== null && expectedScopes.clockify !== currentScopes.clockify) ||
+        (prepared.targets.jira && expectedScopes.jira !== null && expectedScopes.jira !== currentScopes.jira)) {
+        return yield* new ReconcileService.ReconcileError({
+            message: "The provider account changed or could not be verified; reload the week before confirming"
+        });
+    }
+    if (prepared.targets.clockify && expectedScopes.clockify !== null) {
+        options.plan.boundScopes.clockify = expectedScopes.clockify;
+    }
+    if (prepared.targets.jira && expectedScopes.jira !== null) {
+        options.plan.boundScopes.jira = expectedScopes.jira;
+    }
+    consumption = reconcileConsumption(refreshed, consumption);
+    options.plan.consumption.clear();
+    for (const [key, value] of consumption)
+        options.plan.consumption.set(key, value);
+    const excluded = refreshed.excludedDays.find(({ day }) => day === prepared.day);
+    if (excluded !== undefined) {
+        return { _tag: "RunningTimer", reason: excluded.reason };
+    }
+    const unlinkedRows = refreshed.unlinkedClockify.map((slice) => ({
+        intervals: slice.entry === undefined ? [] : [{ entry: slice.entry }]
+    }));
+    const ambiguous = SourceConsumption.unlinkedClockifyOverlaps(proposal.blocks, unlinkedRows, refreshed.sourceEntries);
+    const freshPrepared = prepareProposal({
+        evidence: {
+            ...proposal,
+            blocks: proposal.blocks.map((block, index) => ({
+                ...block,
+                clockifyRefusal: ambiguous[index] === true ? "unlinked-overlap" : undefined
+            })),
+            credited: proposal.sessionSeconds
+        },
+        request: options.request,
+        targets: planSides(options.plan),
+        consumed: (block, source) => consumption.get(evidenceBlockKey(evidence.rowId, block))?.[source] ?? 0
+    });
+    if (freshPrepared._tag !== "Prepared")
+        return freshPrepared;
+    const write = freshPrepared.plan(ReconcileService.recordedForExecution(refreshed.recorded, refreshed.jiraAvailability));
+    if (write._tag === "PastEvidence" || write._tag === "BelowMinimum")
+        return write;
+    const retainedTitle = options.plan.ownership.facts.get(prepared.ticketKey)?.title ?? null;
+    const summary = retainedTitle ??
+        (freshPrepared.targets.jira ? yield* options.summaryOf(freshPrepared.ticketKey) : null);
+    const description = AgentWrite.entryDescription({
+        note: options.request.note ?? null,
+        provenance: freshPrepared.provenance,
+        summary
+    });
+    // The suffix helps import legacy writes. The private provider-ID binding remains authoritative
+    // when a saved entry is relabeled or its description is edited outside jcf.
+    const providerWrite = write._tag === "NothingOwed"
+        ? {
+            _tag: "Write",
+            ticketKey: freshPrepared.ticketKey,
+            day: freshPrepared.day,
+            targets: freshPrepared.targets,
+            clockify: { seconds: 0, segments: [], startedAt: undefined },
+            jira: { seconds: 0, segments: [], startedAt: undefined }
+        }
+        : {
+            ...write,
+            clockify: {
+                ...write.clockify,
+                segments: write.clockify.segments.map((segment) => ({
+                    ...segment,
+                    description: `${description}\n${evidenceMarker(evidence.rowId, segment.block)}`
+                }))
+            },
+            jira: {
+                ...write.jira,
+                segments: write.jira.segments.map((segment) => ({
+                    ...segment,
+                    description: `${description}\n${evidenceMarker(evidence.rowId, segment.block)}`
+                }))
+            }
+        };
+    const outcome = yield* AgentWrite.applyPlannedWrite(options.service, providerWrite, description, evidence.rowId, expectedScopes, refreshed.jiraAvailability);
+    if (write._tag === "NothingOwed" &&
+        outcome.clockify._tag === (freshPrepared.targets.clockify ? "NothingOwed" : "Skipped") &&
+        outcome.jira._tag === (freshPrepared.targets.jira ? "NothingOwed" : "Skipped")) {
+        return { _tag: "NothingOwed", result: nothingOwed(description, freshPrepared.targets) };
+    }
+    for (const source of ["clockify", "jira"]) {
+        const side = outcome[source];
+        if (side._tag !== "Written" && side._tag !== "PartiallyWritten")
+            continue;
+        if (source === "jira")
+            options.plan.jiraReceiptIssueKeys.add(prepared.ticketKey);
+        let remaining = side.seconds;
+        for (const segment of providerWrite[source].segments) {
+            if (remaining <= 0)
+                break;
+            const block = segment.block;
+            const key = evidenceBlockKey(evidence.rowId, block);
+            const previous = consumption.get(key) ?? { clockify: 0, jira: 0 };
+            const added = Math.min(remaining, segment.seconds, Math.max(0, block.seconds - previous[source]));
+            const value = { ...previous, [source]: previous[source] + added };
+            consumption.set(key, value);
+            options.plan.consumption.set(key, value);
+            remaining -= added;
+        }
+    }
+    return {
+        _tag: "Written",
+        result: {
+            clockify: outcome.clockify,
+            description,
+            jira: outcome.jira,
+            lines: AgentWrite.writeOutcomeLines(outcome)
+        }
+    };
+});
+/**
+ * Log time no session evidences.
+ *
+ * Not a proposal, so not sized to a gap and not routed through `applyProposal`: a person typing
+ * thirty minutes means add thirty minutes to both systems, the way `jcf timer log` has always
+ * behaved. Nothing is subtracted, so typing it twice logs it twice — which is what typing it twice
+ * means.
+ */
+export const logManualEntry = (options) => Effect.gen(function* () {
+    const { request } = options;
+    const startedAt = new Date(`${request.day}T${request.startClock ?? "12:00"}:00`);
+    const startMs = startedAt.getTime();
+    if (!Number.isFinite(startMs) || Time.localDay(startedAt) !== request.day ||
+        (request.startClock !== undefined && Time.formatClock(startedAt) !== request.startClock)) {
+        return yield* new ProposalRejectedError({ message: "That local start time does not exist on the chosen day" });
+    }
+    const nowMs = yield* Clock.currentTimeMillis;
+    if (startMs > nowMs) {
+        return yield* new ProposalRejectedError({ message: "Start time is in the future" });
+    }
+    if (startMs + request.seconds * 1000 > nowMs) {
+        return yield* new ProposalRejectedError({ message: "End time is in the future" });
+    }
+    const description = AgentWrite.entryDescription({
+        note: request.note ?? null,
+        provenance: AgentWrite.byHand,
+        summary: request.targets.jira ? yield* options.summaryOf(request.ticketKey) : null
+    });
+    const clockify = !request.targets.clockify
+        ? { _tag: "Skipped" }
+        : yield* options.service
+            .applyToClockify(request.ticketKey, request.day, request.seconds, description, startedAt)
+            .pipe(Effect.map((created) => created
+            ? { _tag: "Written", seconds: request.seconds }
+            : { _tag: "Refused", message: "the entry was not created" }), Effect.catch((error) => Effect.succeed({ _tag: "Refused", message: error.message })));
+    if (!request.targets.jira) {
+        const jira = { _tag: "Skipped" };
+        return { clockify, description, jira, lines: AgentWrite.writeOutcomeLines({ clockify, jira }) };
+    }
+    const posted = yield* options.service.applyToJira(request.ticketKey, request.day, request.seconds, description, startedAt);
+    const jira = posted._tag === "Posted"
+        ? { _tag: "Written", seconds: request.seconds }
+        : posted._tag === "NotLoggedIn"
+            ? { _tag: "NotLoggedIn" }
+            : posted._tag === "VerificationUnavailable"
+                ? { _tag: "Refused", message: "the Jira account could not be verified; refresh before writing" }
+                : { _tag: "Refused", message: posted.message };
+    return { clockify, description, jira, lines: AgentWrite.writeOutcomeLines({ clockify, jira }) };
+});
+export { MINIMUM_WRITE_SECONDS };
+//# sourceMappingURL=Confirm.js.map

package/dist/server/Confirm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Confirm.js","sourceRoot":"","sources":["../../src/server/Confirm.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAA;AAE5F,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AACtC,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AACnF,OAAO,EAAE,qBAAqB,EAA4B,MAAM,UAAU,CAAA;AAC1E,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAiB,oBAAoB,EAAE,MAAM,eAAe,CAAA;AACrG,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AA+BzC;;;;;;GAMG;AACH,MAAM,WAAW,GAAG,CAAC,WAAmB,EAAE,OAAgC,EAAuB,EAAE;IACjG,MAAM,KAAK,GAA2B,EAAE,IAAI,EAAE,aAAa,EAAE,CAAA;IAC7D,MAAM,OAAO,GAA2B,EAAE,IAAI,EAAE,SAAS,EAAE,CAAA;IAC3D,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAA;IACnD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAA;IAC3C,OAAO;QACL,QAAQ;QACR,WAAW;QACX,IAAI;QACJ,KAAK,EAAE,CAAC,gDAAgD,EAAE,GAAG,UAAU,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;KAC/G,CAAA;AACH,CAAC,CAAA;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,OAK/B,EAAkE,EAAE,CACnE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;IACjE,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAA2B,CAAA;IAClF,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAA;IAClC,IAAI,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,WAAW,CAAA;IAC1C,MAAM,QAAQ,GAAG,eAAe,CAAC;QAC/B,QAAQ,EAAE,EAAE,GAAG,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,cAAc,EAAE;QAC5D,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,OAAO,EAAE,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC;QAChC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,gBAAgB,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC;KACrG,CAAC,CAAA;IACF,IAAI,QAAQ,CAAC,IAAI,KAAK,UAAU;QAAE,OAAO,QAAQ,CAAA;IAEjD,gGAAgG;IAChG,mGAAmG;IACnG,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAC1D,IAAI,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,WAAW,CAAC,CAAC,EACpE,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,OAAO,EAAE,EACnD,EAAE,aAAa,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,oBAAoB,EAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,CAC9E,CAAA;IACD,MAAM,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,WAAW,CAAA;IAC/C,MAAM,aAAa,GAAG,SAAS,CAAC,YAAY,CAAA;IAC5C,MAAM,cAAc,GAAG,aAAa,KAAK,SAAS;QAChD,CAAC,CAAC,SAAS;QACX,CAAC,CAAC;YACA,QAAQ,EAAE,aAAa,CAAC,QAAQ,KAAK,IAAI;gBACvC,CAAC,CAAC,IAAI;gBACN,CAAC,CAAC,cAAc,CAAC,QAAQ,IAAI,aAAa,CAAC,QAAQ;YACrD,IAAI,EAAE,aAAa,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,IAAI,aAAa,CAAC,IAAI;SACrF,CAAA;IACH,IACE,cAAc,KAAK,SAAS,IAAI,aAAa,KAAK,SAAS;QAC3D,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ;YACxB,cAAc,CAAC,QAAQ,KAAK,IAAI,IAAI,cAAc,CAAC,QAAQ,KAAK,aAAa,CAAC,QAAQ,CAAC;QACzF,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,IAAI,cAAc,CAAC,IAAI,KAAK,IAAI,IAAI,cAAc,CAAC,IAAI,KAAK,aAAa,CAAC,IAAI,CAAC,EACrG,CAAC;QACD,OAAO,KAAK,CAAC,CAAC,IAAI,gBAAgB,CAAC,cAAc,CAAC;YAChD,OAAO,EAAE,0FAA0F;SACpG,CAAC,CAAA;IACJ,CAAC;IACD,IAAI,QAAQ,CAAC,OAAO,CAAC,QAAQ,IAAI,cAAc,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;QAClE,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,GAAG,cAAc,CAAC,QAAQ,CAAA;IAC7D,CAAC;IACD,IAAI,QAAQ,CAAC,OAAO,CAAC,IAAI,IAAI,cAAc,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;QAC1D,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,GAAG,cAAc,CAAC,IAAI,CAAA;IACrD,CAAC;IACD,WAAW,GAAG,oBAAoB,CAAC,SAAS,EAAE,WAAW,CAAC,CAAA;IAC1D,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAA;IAChC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,WAAW;QAAE,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;IAChF,MAAM,QAAQ,GAAG,SAAS,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,GAAG,KAAK,QAAQ,CAAC,GAAG,CAAC,CAAA;IAC/E,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAA2B,CAAA;IACnF,CAAC;IACD,MAAM,YAAY,GAAG,SAAS,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC9D,SAAS,EAAE,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;KACrE,CAAC,CAAC,CAAA;IACH,MAAM,SAAS,GAAG,iBAAiB,CAAC,wBAAwB,CAC1D,QAAQ,CAAC,MAAM,EACf,YAAY,EACZ,SAAS,CAAC,aAAa,CACxB,CAAA;IACD,MAAM,aAAa,GAAG,eAAe,CAAC;QACpC,QAAQ,EAAE;YACR,GAAG,QAAQ;YACX,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;gBAC7C,GAAG,KAAK;gBACR,eAAe,EAAE,SAAS,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,SAAS;aAC5E,CAAC,CAAC;YACH,QAAQ,EAAE,QAAQ,CAAC,cAAc;SAClC;QACD,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,OAAO,EAAE,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC;QAChC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,gBAAgB,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC;KACrG,CAAC,CAAA;IACF,IAAI,aAAa,CAAC,IAAI,KAAK,UAAU;QAAE,OAAO,aAAa,CAAA;IAC3D,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAC9B,gBAAgB,CAAC,oBAAoB,CAAC,SAAS,CAAC,QAAQ,EAAE,SAAS,CAAC,gBAAgB,CAAC,CACtF,CAAA;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc;QAAE,OAAO,KAAK,CAAA;IAEhF,MAAM,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,KAAK,IAAI,IAAI,CAAA;IACzF,MAAM,OAAO,GAAG,aAAa;QAC3B,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;IACzF,MAAM,WAAW,GAAG,UAAU,CAAC,gBAAgB,CAAC;QAC9C,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI,IAAI,IAAI;QAClC,UAAU,EAAE,aAAa,CAAC,UAAU;QACpC,OAAO;KACR,CAAC,CAAA;IACF,+FAA+F;IAC/F,4EAA4E;IAC5E,MAAM,aAAa,GAAiB,KAAK,CAAC,IAAI,KAAK,aAAa;QAC9D,CAAC,CAAC;YACA,IAAI,EAAE,OAAO;YACb,SAAS,EAAE,aAAa,CAAC,SAAS;YAClC,GAAG,EAAE,aAAa,CAAC,GAAG;YACtB,OAAO,EAAE,aAAa,CAAC,OAAO;YAC9B,QAAQ,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE;YAC5D,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE;SACzD;QACD,CAAC,CAAC;YACA,GAAG,KAAK;YACR,QAAQ,EAAE;gBACR,GAAG,KAAK,CAAC,QAAQ;gBACjB,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;oBAClD,GAAG,OAAO;oBACV,WAAW,EAAE,GAAG,WAAW,KAAK,cAAc,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE;iBAChF,CAAC,CAAC;aACJ;YACD,IAAI,EAAE;gBACJ,GAAG,KAAK,CAAC,IAAI;gBACb,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;oBAC9C,GAAG,OAAO;oBACV,WAAW,EAAE,GAAG,WAAW,KAAK,cAAc,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE;iBAChF,CAAC,CAAC;aACJ;SACF,CAAA;IACH,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,UAAU,CAAC,iBAAiB,CACjD,OAAO,CAAC,OAAO,EACf,aAAa,EACb,WAAW,EACX,QAAQ,CAAC,KAAK,EACd,cAAc,EACd,SAAS,CAAC,gBAAgB,CAC3B,CAAA;IACD,IACE,KAAK,CAAC,IAAI,KAAK,aAAa;QAC5B,OAAO,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC;QACtF,OAAO,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,EAC9E,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,CAAC,WAAW,EAAE,aAAa,CAAC,OAAO,CAAC,EAA2B,CAAA;IAClH,CAAC;IACD,KAAK,MAAM,MAAM,IAAI,CAAC,UAAU,EAAE,MAAM,CAAwD,EAAE,CAAC;QACjG,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;QAC5B,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,KAAK,kBAAkB;YAAE,SAAQ;QACzE,IAAI,MAAM,KAAK,MAAM;YAAE,OAAO,CAAC,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAA;QAChF,IAAI,SAAS,GAAG,IAAI,CAAC,OAAO,CAAA;QAC5B,KAAK,MAAM,OAAO,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC;YACrD,IAAI,SAAS,IAAI,CAAC;gBAAE,MAAK;YACzB,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAA;YAC3B,MAAM,GAAG,GAAG,gBAAgB,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;YACnD,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAA;YACjE,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;YACjG,MAAM,KAAK,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,KAAK,EAAE,CAAA;YACjE,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;YAC3B,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;YACxC,SAAS,IAAI,KAAK,CAAA;QACpB,CAAC;IACH,CAAC;IACD,OAAO;QACL,IAAI,EAAE,SAAS;QACf,MAAM,EAAE;YACN,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,WAAW;YACX,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,KAAK,EAAE,UAAU,CAAC,iBAAiB,CAAC,OAAO,CAAC;SAC7C;KACuB,CAAA;AAC5B,CAAC,CAAC,CAAA;AAWJ;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,OAI9B,EAA6D,EAAE,CAC9D,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAA;IAC3B,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,UAAU,IAAI,OAAO,KAAK,CAAC,CAAA;IAChF,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,EAAE,CAAA;IACnC,IACE,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,KAAK,OAAO,CAAC,GAAG;QACrE,CAAC,OAAO,CAAC,UAAU,KAAK,SAAS,IAAI,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,KAAK,OAAO,CAAC,UAAU,CAAC,EACxF,CAAC;QACD,OAAO,KAAK,CAAC,CAAC,IAAI,qBAAqB,CAAC,EAAE,OAAO,EAAE,wDAAwD,EAAE,CAAC,CAAA;IAChH,CAAC;IACD,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAA;IAC5C,IAAI,OAAO,GAAG,KAAK,EAAE,CAAC;QACpB,OAAO,KAAK,CAAC,CAAC,IAAI,qBAAqB,CAAC,EAAE,OAAO,EAAE,6BAA6B,EAAE,CAAC,CAAA;IACrF,CAAC;IACD,IAAI,OAAO,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,GAAG,KAAK,EAAE,CAAC;QAC7C,OAAO,KAAK,CAAC,CAAC,IAAI,qBAAqB,CAAC,EAAE,OAAO,EAAE,2BAA2B,EAAE,CAAC,CAAA;IACnF,CAAC;IACD,MAAM,WAAW,GAAG,UAAU,CAAC,gBAAgB,CAAC;QAC9C,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,IAAI;QAC1B,UAAU,EAAE,UAAU,CAAC,MAAM;QAC7B,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI;KACnF,CAAC,CAAA;IAEF,MAAM,QAAQ,GAA2B,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ;QAChE,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE;QACrB,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,OAAO;aACrB,eAAe,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,EAAE,WAAW,EAAE,SAAS,CAAC;aACxF,IAAI,CACH,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,EAA0B,EAAE,CAC7C,OAAO;YACL,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE;YAC/C,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,2BAA2B,EAAE,CAC9D,EACD,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAyB,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAC7G,CAAA;IACL,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAC1B,MAAM,IAAI,GAA2B,EAAE,IAAI,EAAE,SAAS,EAAE,CAAA;QACxD,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE,CAAA;IACjG,CAAC;IACD,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,CAC/C,OAAO,CAAC,SAAS,EACjB,OAAO,CAAC,GAAG,EACX,OAAO,CAAC,OAAO,EACf,WAAW,EACX,SAAS,CACV,CAAA;IACD,MAAM,IAAI,GAA2B,MAAM,CAAC,IAAI,KAAK,QAAQ;QAC3D,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE;QAC/C,CAAC,CAAC,MAAM,CAAC,IAAI,KAAK,aAAa;YAC/B,CAAC,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE;YACzB,CAAC,CAAC,MAAM,CAAC,IAAI,KAAK,yBAAyB;gBAC3C,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,gEAAgE,EAAE;gBAChG,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAA;IAChD,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE,CAAA;AACjG,CAAC,CAAC,CAAA;AAEJ,OAAO,EAAE,qBAAqB,EAAE,CAAA"}

package/dist/server/Handlers.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Authenticated endpoint handlers.
+ *
+ * Week reads, retained descriptions, and write decisions live in their owning modules.
+ * These handlers translate their outcomes and coordinate configuration changes.
+ *
+ * @module
+ */
+import { ConfigService, IssueFacts, ReconcileService } from "@knpkv/jira-clockify";
+import { WeekPlans } from "./WeekPlans.js";
+export declare const WeekLive: import("effect/Layer").Layer<import("effect/http-api/HttpApiGroup").Service<"JcfWebApi", "week">, never, ConfigService.ConfigService | IssueFacts.IssueFacts | import("./Api.js").OwnerSessionAuth | ReconcileService.ReconcileService | WeekPlans>;
+export declare const RowsLive: import("effect/Layer").Layer<import("effect/http-api/HttpApiGroup").Service<"JcfWebApi", "rows">, never, import("@knpkv/jira-api-client").JiraApiClient | import("@knpkv/jira-cli/JiraAuth").JiraAuth | import("./Api.js").OwnerSessionAuth | ReconcileService.ReconcileService | WeekPlans>;
+export declare const ConfigLive: import("effect/Layer").Layer<import("effect/http-api/HttpApiGroup").Service<"JcfWebApi", "config">, never, ConfigService.ConfigService | import("./Api.js").OwnerSessionAuth | WeekPlans>;
+export declare const EntriesLive: import("effect/Layer").Layer<import("effect/http-api/HttpApiGroup").Service<"JcfWebApi", "entries">, never, import("./Api.js").OwnerSessionAuth | WeekPlans>;

package/dist/server/Handlers.js

@@ -0,0 +1,157 @@
+/**
+ * Authenticated endpoint handlers.
+ *
+ * Week reads, retained descriptions, and write decisions live in their owning modules.
+ * These handlers translate their outcomes and coordinate configuration changes.
+ *
+ * @module
+ */
+import { ConfigService, FetchTicket, IssueFacts, ReconcileService } from "@knpkv/jira-clockify";
+import { Effect, Semaphore } from "effect";
+import { HttpApiBuilder } from "effect/http-api";
+import { ApiError, JcfWebApi, PlanExpiredError, ProposalRejectedError } from "./Api.js";
+import { confirmProposal, logManualEntry, MINIMUM_WRITE_SECONDS } from "./Confirm.js";
+import { WeekPlans } from "./WeekPlans.js";
+import { readRecordedWeekPlan, readWeekPlan, refreshWeekPlan, savedWeekPlan, streamWeekRead } from "./WeekRead.js";
+const failed = (message) => new ApiError({ message });
+export const WeekLive = HttpApiBuilder.group(JcfWebApi, "week", (handlers) => Effect.gen(function* () {
+    const reconcile = yield* ReconcileService.ReconcileService;
+    const issues = yield* IssueFacts.IssueFacts;
+    const config = yield* ConfigService.ConfigService;
+    const plans = yield* WeekPlans;
+    const read = (query, report) => readWeekPlan({ query, report, reconcile, issues, config, plans });
+    return handlers
+        .handle("saved", ({ query }) => savedWeekPlan({ query, plans }))
+        .handle("read", ({ query }) => read(query, () => Effect.void))
+        .handle("stream", ({ query }) => Effect.succeed(streamWeekRead((report) => read(query, report))))
+        .handle("recordedOnly", ({ query }) => Effect.succeed(streamWeekRead((report) => readRecordedWeekPlan({ query, report, reconcile, config, plans }))))
+        .handle("recorded", ({ query }) => Effect.succeed(streamWeekRead((report) => refreshWeekPlan({ planId: query.planId, report, reconcile, plans }))));
+}));
+export const RowsLive = HttpApiBuilder.group(JcfWebApi, "rows", (handlers) => Effect.gen(function* () {
+    const reconcile = yield* ReconcileService.ReconcileService;
+    const plans = yield* WeekPlans;
+    const ticketSummary = yield* FetchTicket.ticketSummaryReader;
+    return handlers
+        .handle("describe", ({ payload }) => plans.describe(payload))
+        .handle("confirm", ({ payload }) => plans.withConfirmationPermit(Effect.gen(function* () {
+        const plan = yield* plans.find(payload.planId);
+        if (plan === undefined) {
+            return yield* new PlanExpiredError({ message: "This week was read too long ago — reload it" });
+        }
+        const outcome = yield* confirmProposal({
+            plan,
+            request: {
+                blocks: payload.blocks,
+                note: payload.note,
+                rowId: payload.rowId,
+                seconds: payload.seconds,
+                targets: payload.targets,
+                ticketKey: payload.ticketKey
+            },
+            service: reconcile,
+            summaryOf: ticketSummary
+        }).pipe(Effect.mapError((error) => failed(error.message)));
+        if (outcome._tag === "UnknownRow") {
+            return yield* new PlanExpiredError({ message: "That row is not part of this week — reload it" });
+        }
+        if (outcome._tag === "UnknownBlocks") {
+            return yield* new PlanExpiredError({
+                message: "Those blocks are not part of this row any more — reload the week"
+            });
+        }
+        if (outcome._tag === "PastEvidence") {
+            return yield* new ProposalRejectedError({
+                maxSeconds: outcome.maxSeconds,
+                message: "That is more time than the sessions evidence. Log the rest as a manual entry."
+            });
+        }
+        if (outcome._tag === "BelowMinimum") {
+            return yield* new ProposalRejectedError({
+                message: `Jira floors worklogs to the minute, so ${outcome.minimumSeconds}s is the smallest write.`
+            });
+        }
+        if (outcome._tag === "RunningTimer") {
+            return yield* new ProposalRejectedError({ message: outcome.reason });
+        }
+        if (outcome._tag === "NoTargets") {
+            return yield* new ProposalRejectedError({
+                message: "Pick at least one of Clockify or Jira — a write to neither is not a write."
+            });
+        }
+        return outcome.result;
+    })))
+        .handle("manual", ({ payload }) => plans.withConfirmationPermit(Effect.gen(function* () {
+        const targets = payload.targets ?? { clockify: true, jira: true };
+        if (!targets.clockify && !targets.jira) {
+            return yield* new ProposalRejectedError({
+                message: "Pick at least one of Clockify or Jira — a write to neither is not a write."
+            });
+        }
+        if (targets.jira && payload.seconds < MINIMUM_WRITE_SECONDS) {
+            return yield* new ProposalRejectedError({
+                message: `Jira floors worklogs to the minute, so ${MINIMUM_WRITE_SECONDS}s is the smallest write.`
+            });
+        }
+        return yield* logManualEntry({
+            request: {
+                day: payload.day,
+                note: payload.note,
+                seconds: payload.seconds,
+                startClock: payload.startClock,
+                targets,
+                ticketKey: payload.ticketKey
+            },
+            service: reconcile,
+            summaryOf: ticketSummary
+        });
+    })));
+}));
+export const ConfigLive = HttpApiBuilder.group(JcfWebApi, "config", (handlers) => Effect.gen(function* () {
+    const config = yield* ConfigService.ConfigService;
+    const plans = yield* WeekPlans;
+    const configWrites = yield* Semaphore.make(1);
+    return handlers
+        .handle("agent", () => config.get.pipe(Effect.map((settings) => settings.sessionAgent)))
+        .handle("saveAgent", ({ payload }) => configWrites.withPermits(1)(Effect.gen(function* () {
+        yield* plans.invalidateDescriptions;
+        yield* config.set({ sessionAgent: payload }).pipe(Effect.ensuring(plans.invalidateDescriptions));
+        const stored = (yield* config.get).sessionAgent;
+        if (stored.provider !== payload.provider || stored.model !== payload.model || stored.effort !== payload.effort) {
+            return yield* failed("Agent settings could not be saved. Retry the save.");
+        }
+        return stored;
+    })))
+        .handle("standing", ({ payload }) => configWrites.withPermits(1)(Effect.gen(function* () {
+        const current = yield* config.get;
+        const next = { ...current.sessionTicketMap, [payload.cwd]: payload.ticketKey };
+        yield* config.set({ sessionTicketMap: next });
+        // Read back rather than echo: the config service swallows a failed write, so echoing the map
+        // we meant to store would report a save that never happened.
+        const stored = (yield* config.get).sessionTicketMap;
+        if (stored[payload.cwd] !== payload.ticketKey) {
+            return yield* failed("The Standing Attribution could not be saved to ~/.jcf/config.json");
+        }
+        return { sessionTicketMap: stored };
+    })))
+        .handle("mine", ({ payload }) => configWrites.withPermits(1)(Effect.gen(function* () {
+        const current = yield* config.get;
+        const next = current.sessionOwnershipOverrides.includes(payload.ticketKey)
+            ? current.sessionOwnershipOverrides
+            : [...current.sessionOwnershipOverrides, payload.ticketKey].sort();
+        yield* config.set({ sessionOwnershipOverrides: next });
+        // Read back rather than echo: the config service swallows a failed write, so echoing the
+        // list we meant to store would report a decision that did not stick.
+        const stored = (yield* config.get).sessionOwnershipOverrides;
+        if (!stored.includes(payload.ticketKey)) {
+            return yield* failed("That ticket could not be saved to ~/.jcf/config.json");
+        }
+        return { ownershipOverrides: stored };
+    })));
+}));
+export const EntriesLive = HttpApiBuilder.group(JcfWebApi, "entries", (handlers) => Effect.gen(function* () {
+    const plans = yield* WeekPlans;
+    return handlers
+        .handle("update", ({ payload }) => plans.updateSaved(payload))
+        .handle("describe", ({ payload }) => plans.describeSaved(payload));
+}));
+//# sourceMappingURL=Handlers.js.map