@knpkv/jira-clockify 1.3.0 → 1.4.1

package/dist/src/agent/writePlanning.d.ts

@@ -0,0 +1,154 @@
+import type { CreditedBlock, CreditedSpan } from "./sessions.js";
+/** The provider scope explicitly selected by the caller. */
+export interface WriteTargets {
+    readonly clockify: boolean;
+    readonly jira: boolean;
+}
+/** Concrete provider arguments. Zero seconds means this side has no write. */
+export interface SideWrite {
+    readonly seconds: number;
+    /** Owed seconds that cannot be represented by this provider's minimum segment size. */
+    readonly withheldSeconds?: number | undefined;
+    /** A safety hold on selected source blocks; not an amount already logged. */
+    readonly refusal?: "unlinked-overlap" | undefined;
+    readonly startedAt: Date | undefined;
+    /** Uncovered source pieces to write in order; kept separate across recorded gaps and blocks. */
+    readonly segments: ReadonlyArray<{
+        readonly block: CreditedBlock;
+        readonly seconds: number;
+        readonly startedAt: Date;
+        /** Provider-visible description override for this exact segment. */
+        readonly description?: string | undefined;
+    }>;
+}
+/** Sizing and anchoring are finished before a provider executes this plan. */
+export interface PlannedWrite {
+    readonly _tag: "Write";
+    readonly ticketKey: string;
+    readonly day: string;
+    readonly targets: WriteTargets;
+    readonly clockify: SideWrite;
+    readonly jira: SideWrite;
+}
+interface RecordedBucket {
+    readonly ticketKey: string;
+    readonly day: string;
+    readonly clockifySeconds: number;
+    readonly jiraSeconds: number;
+    readonly intervals: ReadonlyArray<{
+        readonly startMs: number;
+        readonly endMs: number;
+        readonly source: "clockify" | "jira";
+    }>;
+}
+export type PreparedProposal = {
+    readonly _tag: "UnknownBlocks";
+} | {
+    readonly _tag: "NoTargets";
+} | {
+    readonly _tag: "Prepared";
+    readonly ticketKey: string;
+    readonly day: string;
+    readonly targets: WriteTargets;
+    readonly provenance: {
+        readonly evidence: "session";
+        readonly amountSetByHand: boolean;
+        readonly ticketSetByHand: boolean;
+    };
+    readonly plan: (recorded: ReadonlyArray<RecordedBucket>) => PlannedWrite | Exclude<ProposedWrite, {
+        readonly _tag: "Write";
+    }>;
+};
+/**
+ * Resolve the selected evidence before reading providers, then plan against their answers.
+ * Server callers supply fresh totals; previews supply cached totals. Neither caller computes
+ * selection credit or anchors. A selected subset starts where the person pointed; a whole row
+ * advances past each provider's recorded time. No evidence or provider state is mutated.
+ */
+export declare const prepareProposal: (options: {
+    readonly evidence: {
+        readonly blocks: ReadonlyArray<CreditedBlock>;
+        readonly credited: number;
+        readonly ticketKey: string;
+        readonly day: string;
+    };
+    readonly request: {
+        readonly blocks?: ReadonlyArray<number> | undefined;
+        readonly seconds?: number | undefined;
+        readonly ticketKey?: string | undefined;
+        readonly targets?: WriteTargets | undefined;
+    };
+    readonly targets: WriteTargets;
+    /** Server-retained source credit already written under a corrected ticket. */
+    readonly consumed?: ((block: CreditedBlock, source: "clockify" | "jira") => number) | undefined;
+}) => PreparedProposal;
+/**
+ * The blocks a confirmation named, or every block when it named none.
+ *
+ * `undefined` for an index that is not a block of this row: a stale page confirming against a plan
+ * that has been re-read is a case to refuse, not to write a guess for.
+ */
+export declare const selectedBlocks: (blocks: ReadonlyArray<CreditedBlock>, chosen: ReadonlyArray<number> | undefined) => ReadonlyArray<CreditedBlock> | undefined;
+/**
+ * What accepting a row would write, given a live re-tally of the target bucket.
+ *
+ * Every number here is the server's: `credited` is the evidence the plan was built from, `selected`
+ * is the part of it a person is accepting now, and `held` is what the two systems answered a moment
+ * ago. `requested` is the only input a person supplies, and it is capped by the selection rather
+ * than clamped to it — silently writing less than someone asked for is its own kind of wrong.
+ *
+ * **Why a side is sized against the whole row and not against the selection.** `credited - held` is
+ * the room left in the day; the selection only says how much of that room to use now. Sizing a
+ * block against `selected - held` instead would report "already logged" for the second block of any
+ * row whose first block is already in — the arithmetic would treat the morning's entry as evidence
+ * that the afternoon had been written too.
+ */
+export type ProposedWrite = {
+    readonly _tag: "Write";
+    readonly clockifyDelta: number;
+    readonly jiraDelta: number;
+} | {
+    readonly _tag: "NothingOwed";
+} | {
+    readonly _tag: "PastEvidence";
+    readonly maxSeconds: number;
+} | {
+    readonly _tag: "BelowMinimum";
+    readonly minimumSeconds: number;
+};
+/**
+ * Jira's minimum worklog duration. Clockify retains exact positive seconds below this floor.
+ */
+export declare const MINIMUM_WRITE_SECONDS = 60;
+export declare const proposeWrite: (options: {
+    readonly credited: number;
+    /** The blocks being accepted now. Defaults to the whole row. */
+    readonly selected?: number | undefined;
+    readonly requested: number | undefined;
+    readonly heldClockifySeconds: number;
+    readonly heldJiraSeconds: number;
+    /** Provider time already overlapping this selection. Omitted for a whole-row write. */
+    readonly heldSelectedClockifySeconds?: number | undefined;
+    readonly heldSelectedJiraSeconds?: number | undefined;
+    /** Which systems are in play. A side that is out gets a zero delta, never a gap. */
+    readonly targets?: {
+        readonly clockify: boolean;
+        readonly jira: boolean;
+    } | undefined;
+}) => ProposedWrite;
+/**
+ * Where a write should say the work began, given what that side already holds.
+ *
+ * A proposal covers a whole `(Issue Key, day)` bucket, but the amount written is only the gap. Under
+ * `jcf watch` that gap arrives block by block: the morning is written when it settles, and the
+ * afternoon follows as its own write against the same bucket. Anchoring both at the bucket's first
+ * instant would file the afternoon's hours at 09:00 — a second Clockify entry laid directly over the
+ * first, and a Jira worklog dated to work that had not started yet.
+ *
+ * So the anchor skips the blocks that side already accounts for and starts at the first one it does
+ * not. Approximate where work ran in parallel, because `seconds` is a *share* of those blocks rather
+ * than their wall clock — but the error is then bounded by one block, against a whole day before.
+ */
+export declare const writeAnchor: (spans: ReadonlyArray<CreditedSpan>, alreadyRecordedSeconds: number) => Date | undefined;
+export {};
+//# sourceMappingURL=writePlanning.d.ts.map

package/dist/src/agent/writePlanning.d.ts.map

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

package/dist/src/agent/writePlanning.js

@@ -0,0 +1,210 @@
+import * as SourceConsumption from "./sourceConsumption.js";
+/** Recorded seconds that overlap the selected evidence, unioned per block and capped by its credit. */
+const recordedIn = (blocks, intervals, source) => blocks.reduce((total, block) => total + SourceConsumption.recordedSecondsInBlock(block, intervals, source), 0);
+/** Wall-clock pieces of one block not covered by this provider's existing target-bucket entries. */
+const uncovered = (block, intervals, source) => {
+    const covered = intervals
+        .filter((interval) => interval.source === source)
+        .map((interval) => ({
+        startMs: Math.max(block.startMs, interval.startMs),
+        endMs: Math.min(block.endMs, interval.endMs)
+    }))
+        .filter((interval) => interval.endMs > interval.startMs)
+        .sort((a, b) => a.startMs - b.startMs);
+    const result = [];
+    let cursor = block.startMs;
+    for (const interval of covered) {
+        if (interval.startMs > cursor)
+            result.push({ startMs: cursor, endMs: interval.startMs });
+        cursor = Math.max(cursor, interval.endMs);
+    }
+    if (cursor < block.endMs)
+        result.push({ startMs: cursor, endMs: block.endMs });
+    return result;
+};
+/**
+ * Resolve the selected evidence before reading providers, then plan against their answers.
+ * Server callers supply fresh totals; previews supply cached totals. Neither caller computes
+ * selection credit or anchors. A selected subset starts where the person pointed; a whole row
+ * advances past each provider's recorded time. No evidence or provider state is mutated.
+ */
+export const prepareProposal = (options) => {
+    const { evidence, request } = options;
+    const blocks = selectedBlocks(evidence.blocks, request.blocks);
+    if (blocks === undefined)
+        return { _tag: "UnknownBlocks" };
+    const targets = request.targets ?? options.targets;
+    if (!targets.clockify && !targets.jira)
+        return { _tag: "NoTargets" };
+    const selected = blocks.reduce((sum, block) => sum + block.seconds, 0);
+    const ticketKey = request.ticketKey ?? evidence.ticketKey;
+    return {
+        _tag: "Prepared",
+        ticketKey,
+        day: evidence.day,
+        targets,
+        provenance: {
+            evidence: "session",
+            amountSetByHand: request.seconds !== undefined && request.seconds !== selected,
+            ticketSetByHand: ticketKey !== evidence.ticketKey
+        },
+        plan: (recorded) => {
+            const bucket = recorded.find((row) => row.ticketKey === ticketKey && row.day === evidence.day);
+            const correctedBeyondTarget = (source) => evidence.blocks.reduce((total, block) => total + Math.max(0, (options.consumed?.(block, source) ?? 0) - recordedIn([block], bucket?.intervals ?? [], source)), 0);
+            const heldClockifySeconds = (bucket?.clockifySeconds ?? 0) + correctedBeyondTarget("clockify");
+            const heldJiraSeconds = (bucket?.jiraSeconds ?? 0) + correctedBeyondTarget("jira");
+            const heldInSelection = (source) => blocks.reduce((total, block) => total + Math.max(recordedIn([block], bucket?.intervals ?? [], source), options.consumed?.(block, source) ?? 0), 0);
+            const heldSelectedClockifySeconds = heldInSelection("clockify");
+            const heldSelectedJiraSeconds = heldInSelection("jira");
+            const sized = proposeWrite({
+                credited: evidence.credited,
+                selected,
+                requested: request.seconds,
+                heldClockifySeconds,
+                heldJiraSeconds,
+                heldSelectedClockifySeconds,
+                heldSelectedJiraSeconds,
+                targets
+            });
+            if (sized._tag !== "Write")
+                return sized;
+            const side = (seconds, source) => {
+                let remaining = seconds;
+                let refused = false;
+                const segments = [];
+                for (const block of blocks) {
+                    if (remaining <= 0)
+                        break;
+                    const recorded = recordedIn([block], bucket?.intervals ?? [], source);
+                    const consumed = options.consumed?.(block, source) ?? 0;
+                    let skip = Math.max(0, consumed - recorded);
+                    let availableCredit = Math.max(0, block.seconds - Math.max(recorded, consumed));
+                    if (source === "clockify" && block.clockifyRefusal === "unlinked-overlap" && availableCredit > 0) {
+                        refused = true;
+                        continue;
+                    }
+                    for (const range of uncovered(block, bucket?.intervals ?? [], source)) {
+                        const rangeSeconds = (range.endMs - range.startMs) / 1000;
+                        const skipped = Math.min(skip, rangeSeconds);
+                        skip -= skipped;
+                        const capacity = Math.min(rangeSeconds - skipped, availableCredit);
+                        const allocated = Math.min(remaining, capacity);
+                        if (allocated > 0) {
+                            // Jira rounds every worklog up to its one-minute floor. A shorter executable segment
+                            // would write more than this evidence permits, even when several short gaps total a
+                            // minute, so it must stay withheld.
+                            if (source === "jira" && allocated < MINIMUM_WRITE_SECONDS)
+                                continue;
+                            segments.push({
+                                block,
+                                seconds: allocated,
+                                startedAt: new Date(range.startMs + skipped * 1000)
+                            });
+                            remaining -= allocated;
+                            availableCredit -= allocated;
+                        }
+                    }
+                }
+                const executableSeconds = segments.reduce((sum, segment) => sum + segment.seconds, 0);
+                return {
+                    seconds: executableSeconds,
+                    withheldSeconds: Math.max(0, seconds - executableSeconds),
+                    ...(refused && { refusal: "unlinked-overlap" }),
+                    segments,
+                    startedAt: segments[0]?.startedAt
+                };
+            };
+            const clockify = side(sized.clockifyDelta, "clockify");
+            const jira = side(sized.jiraDelta, "jira");
+            if (clockify.seconds === 0 && jira.seconds === 0 && clockify.refusal === undefined) {
+                return { _tag: "BelowMinimum", minimumSeconds: MINIMUM_WRITE_SECONDS };
+            }
+            return {
+                _tag: "Write",
+                ticketKey,
+                day: evidence.day,
+                targets,
+                clockify,
+                jira
+            };
+        }
+    };
+};
+/**
+ * The blocks a confirmation named, or every block when it named none.
+ *
+ * `undefined` for an index that is not a block of this row: a stale page confirming against a plan
+ * that has been re-read is a case to refuse, not to write a guess for.
+ */
+export const selectedBlocks = (blocks, chosen) => {
+    if (chosen === undefined)
+        return blocks;
+    const picked = [];
+    for (const index of [...new Set(chosen)].sort((a, b) => a - b)) {
+        const block = blocks[index];
+        if (block === undefined)
+            return undefined;
+        picked.push(block);
+    }
+    return picked.length === 0 ? undefined : picked;
+};
+/**
+ * Jira's minimum worklog duration. Clockify retains exact positive seconds below this floor.
+ */
+export const MINIMUM_WRITE_SECONDS = 60;
+export const proposeWrite = (options) => {
+    const targets = options.targets ?? { clockify: true, jira: true };
+    const selected = Math.min(options.selected ?? options.credited, options.credited);
+    const requested = options.requested ?? selected;
+    if (requested > selected)
+        return { _tag: "PastEvidence", maxSeconds: selected };
+    if (requested < (targets.clockify ? 1 : MINIMUM_WRITE_SECONDS)) {
+        return { _tag: "BelowMinimum", minimumSeconds: targets.clockify ? 1 : MINIMUM_WRITE_SECONDS };
+    }
+    const owed = (held, heldSelected, asked, minimum) => {
+        if (!asked)
+            return 0;
+        // Room left in the day, then as much of it as this selection asks for.
+        const room = Math.max(0, options.credited - held);
+        const delta = Math.min(Math.max(0, requested - heldSelected), room);
+        return delta < minimum ? 0 : delta;
+    };
+    const clockifyDelta = owed(options.heldClockifySeconds, options.heldSelectedClockifySeconds ?? 0, targets.clockify, 1);
+    const jiraDelta = owed(options.heldJiraSeconds, options.heldSelectedJiraSeconds ?? 0, targets.jira, MINIMUM_WRITE_SECONDS);
+    // Nothing left on either side asked for: the ordinary outcome of confirming a row twice, or of a
+    // watch having taken it in between. Not a failure, and not a write.
+    if (clockifyDelta === 0 && jiraDelta === 0)
+        return { _tag: "NothingOwed" };
+    return { _tag: "Write", clockifyDelta, jiraDelta };
+};
+/**
+ * Where a write should say the work began, given what that side already holds.
+ *
+ * A proposal covers a whole `(Issue Key, day)` bucket, but the amount written is only the gap. Under
+ * `jcf watch` that gap arrives block by block: the morning is written when it settles, and the
+ * afternoon follows as its own write against the same bucket. Anchoring both at the bucket's first
+ * instant would file the afternoon's hours at 09:00 — a second Clockify entry laid directly over the
+ * first, and a Jira worklog dated to work that had not started yet.
+ *
+ * So the anchor skips the blocks that side already accounts for and starts at the first one it does
+ * not. Approximate where work ran in parallel, because `seconds` is a *share* of those blocks rather
+ * than their wall clock — but the error is then bounded by one block, against a whole day before.
+ */
+export const writeAnchor = (spans, alreadyRecordedSeconds) => {
+    const ordered = [...spans].sort((a, b) => a.startMs - b.startMs);
+    let remaining = alreadyRecordedSeconds;
+    for (const span of ordered) {
+        const seconds = (span.endMs - span.startMs) / 1000;
+        if (remaining >= seconds) {
+            remaining -= seconds;
+            continue;
+        }
+        return new Date(span.startMs + remaining * 1000);
+    }
+    // Every block is already spoken for. Reached only when a side is not short, so nothing is written
+    // with this anchor — but the end of the last block is the one instant that cannot overlap what is
+    // already recorded, where the first block is the one instant guaranteed to.
+    const last = ordered[ordered.length - 1];
+    return last === undefined ? undefined : new Date(last.endMs);
+};
+//# sourceMappingURL=writePlanning.js.map

package/dist/src/agent/writePlanning.js.map

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

package/dist/src/bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/src/bin.d.ts.map

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

package/dist/src/bin.js

@@ -6,11 +6,12 @@
  */
 import { NodeRuntime } from "@effect/platform-node";
 import { Effect } from "effect";
+import { Command } from "effect/cli";
 import * as Runtime from "effect/Runtime";
 import * as Stdio from "effect/Stdio";
-import { Command } from "effect/unstable/cli";
 import { HeadlessLayer } from "./cli/layers.js";
 import { root } from "./cli/root.js";
+import { reportUnhandled } from "./cli/runtimeFailure.js";
 const processArgv = Effect.gen(function* () {
     const stdio = yield* Stdio.Stdio;
     const args = yield* stdio.args;
@@ -19,7 +20,10 @@ const processArgv = Effect.gen(function* () {
 const cli = Command.runWith(root, {
     version: "0.1.0"
 });
-const program = processArgv.pipe(Effect.flatMap((argv) => cli(argv)), Effect.provide(HeadlessLayer));
+const program = reportUnhandled(processArgv.pipe(Effect.flatMap((argv) => cli(argv)))).pipe(
+// This *is* the entry point: the one place the whole layer graph is composed and provided.
+// @effect-diagnostics-next-line strictEffectProvide:off
+Effect.provide(HeadlessLayer));
 // The TUI keeps long-lived resources open through its atom runtime, and OpenTUI
 // holds stdin in raw mode so Ctrl-C arrives as a keypress, not a SIGINT. On a
 // clean in-app quit (exit code 0) runMain's default teardown never reaches
@@ -27,5 +31,7 @@ const program = processArgv.pipe(Effect.flatMap((argv) => cli(argv)), Effect.pro
 // UI tears down. This bin also runs as the Bun child re-spawned from the Node
 // parent, so both processes need the explicit exit. Always terminate.
 const forceExitTeardown = (exit) => Runtime.defaultTeardown(exit, (code) => process.exit(code));
-NodeRuntime.runMain(program, { teardown: forceExitTeardown });
+// The command boundary above renders unreported failures once. Runtime reporting stays disabled so
+// it cannot add a second stack trace after that concise diagnostic.
+NodeRuntime.runMain(program, { disableErrorReporting: true, teardown: forceExitTeardown });
 //# sourceMappingURL=bin.js.map

package/dist/src/bin.js.map

@@ -1 +1 @@
-{"version":3,"file":"bin.js","sourceRoot":"","sources":["../../src/bin.ts"],"names":[],"mappings":";AACA;;;;GAIG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAA;AACzC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAA;AAEpC,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IACtC,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,KAAK,CAAC,KAAK,CAAA;IAChC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,KAAK,CAAC,IAAI,CAAA;IAC9B,OAAO,IAAI,CAAA;AACb,CAAC,CAAC,CAAA;AAEF,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE;IAChC,OAAO,EAAE,OAAO;CACjB,CAAC,CAAA;AAEF,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAC9B,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,EACnC,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAC9B,CAAA;AAED,gFAAgF;AAChF,8EAA8E;AAC9E,2EAA2E;AAC3E,8EAA8E;AAC9E,8EAA8E;AAC9E,sEAAsE;AACtE,MAAM,iBAAiB,GAAqB,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;AAEjH,WAAW,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,iBAAiB,EAAE,CAAC,CAAA"}
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../../src/bin.ts"],"names":[],"mappings":";AACA;;;;GAIG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACpC,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAA;AACzC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAA;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAEzD,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IACtC,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,KAAK,CAAC,KAAK,CAAA;IAChC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,KAAK,CAAC,IAAI,CAAA;IAC9B,OAAO,IAAI,CAAA;AACb,CAAC,CAAC,CAAA;AAEF,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE;IAChC,OAAO,EAAE,OAAO;CACjB,CAAC,CAAA;AAEF,MAAM,OAAO,GAAG,eAAe,CAAC,WAAW,CAAC,IAAI,CAC9C,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CACpC,CAAC,CAAC,IAAI;AACL,2FAA2F;AAC3F,wDAAwD;AACxD,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAC9B,CAAA;AAED,gFAAgF;AAChF,8EAA8E;AAC9E,2EAA2E;AAC3E,8EAA8E;AAC9E,8EAA8E;AAC9E,sEAAsE;AACtE,MAAM,iBAAiB,GAAqB,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;AAEjH,mGAAmG;AACnG,oEAAoE;AACpE,WAAW,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,qBAAqB,EAAE,IAAI,EAAE,QAAQ,EAAE,iBAAiB,EAAE,CAAC,CAAA"}

package/dist/src/cli/agentWrite.d.ts

@@ -0,0 +1,164 @@
+/**
+ * Writing one Proposed Worklog, shared by `jcf sync reconcile --agent`, `jcf watch`, and any other
+ * surface that offers a proposal for confirmation.
+ *
+ * **Mental model**
+ *
+ * - **One write path**: every surface derives proposals from the same evidence and must put the same
+ *   text in the same two places. A second implementation would drift, and the drift would only ever
+ *   be visible in someone else's timesheet.
+ * - **Say it before writing it**: the entry text lands in two systems other people read, so the
+ *   caller shows it first. Nothing here writes anything the user has not already been shown.
+ * - **Reports, never prints.** A write returns what each side did and the caller renders it. A
+ *   terminal has a console to print to and an HTTP handler has a response to fill; a write path that
+ *   printed could only ever serve the first, and the second would grow its own copy of these rules.
+ *
+ * @module
+ */
+import * as Effect from "effect/Effect";
+import type { SessionProposal } from "../agent/sessions.js";
+import { type PlannedWrite, type WriteTargets } from "../agent/writePlanning.js";
+import type { JiraAvailability, ProviderScopes, ReconcileServiceContract } from "../services/ReconcileService.js";
+export { writeAnchor, type WriteTargets } from "../agent/writePlanning.js";
+/** Clip `text` to `width`, marking that something was dropped. */
+export declare const clip: (text: string, width: number) => string;
+/**
+ * What accepting one row would write, naming only the sides that are actually short.
+ *
+ * Collapsed to "to both" when the two gaps are equal, which is the usual case for time neither
+ * side ever recorded — spelling the same number out twice reads like a mistake.
+ */
+export declare const proposalTargets: (proposal: Pick<SessionProposal, "blocks" | "clockifyDelta" | "jiraDelta">) => string;
+/**
+ * What a written entry claims about itself.
+ *
+ * The distinctions are not decoration. `session` evidence is the claim ADR-0006 lets the tool make —
+ * a transcript recorded that this work happened for this long. Every flag here is a place a person
+ * overruled that, and a row where they did must not keep citing evidence for the part they chose.
+ * Which is why this is three independent facts and not one label: an amount typed over a proposal
+ * still has a transcript behind *when* the work happened, and a proposal moved to another Issue Key
+ * still has a transcript behind *how long* it took.
+ */
+export interface WriteProvenance {
+    /** `session` when a transcript stands behind the time; `hand` when nothing does. */
+    readonly evidence: "session" | "hand";
+    /** The amount was set by a person rather than taken from the evidence. */
+    readonly amountSetByHand: boolean;
+    /** The Issue Key was chosen by a person rather than by an Attribution Signal. */
+    readonly ticketSetByHand: boolean;
+}
+/** A proposal accepted exactly as it was offered. */
+export declare const asProposed: WriteProvenance;
+/** Time no session evidences: a meeting, a whiteboard, work away from the keyboard. */
+export declare const byHand: WriteProvenance;
+/**
+ * Where a written entry says it came from. This prose is never load-bearing: ordinary writes tally
+ * by `[KEY]` and day. Session-backed writes also carry a source suffix for legacy migration; the
+ * private provider-ID ledger, not editable text, keeps corrected-ticket consumption after a write.
+ */
+export declare const PROVENANCE = "Reconciled from Claude Agent Session";
+/** What an entry with this provenance says about itself. */
+export declare const provenanceText: (provenance: WriteProvenance) => string;
+/**
+ * What a written entry says about itself: the issue title, what was done, and where it came from.
+ *
+ * An entry that says only "reconciled from an Agent Session" answers the wrong question. The one
+ * asked of a timesheet months later is *what* the time went on, and by then the Issue Key alone is
+ * a lookup and the transcript is gone. So the title goes in — Clockify has no other way to know it —
+ * and the note goes in after it, as the one thing neither system can reconstruct.
+ *
+ * Both halves are optional, for different reasons: Jira may be unreachable, and a session whose
+ * prompts never say what was done gets no sentence rather than an invented one. The provenance stays
+ * last and unconditional — a reader has to be able to tell that a line was written by a tool from a
+ * session, not typed by hand.
+ */
+export declare const entryDescription: (options: {
+    readonly summary: string | null;
+    readonly note: string | null;
+    /** Defaults to a proposal accepted as offered — the only kind the CLI's own commands write. */
+    readonly provenance?: WriteProvenance | undefined;
+}) => string;
+/**
+ * What one side of a write did.
+ *
+ * `NothingOwed` is not a failure and not a write: the side already holds the proposal's time, which
+ * is the ordinary outcome of topping up a day only one system missed. `Skipped` is a different
+ * statement again — the side was never asked. Keeping all three distinct from a `Written` of zero is
+ * what stops a summary counting any of them as work logged, and stops "you asked me not to" reading
+ * as "there was nothing to do".
+ */
+export type SideOutcome = {
+    readonly _tag: "Written";
+    readonly seconds: number;
+    readonly segments?: ReadonlyArray<WrittenSegment>;
+} | {
+    readonly _tag: "PartiallyWritten";
+    readonly seconds: number;
+    readonly segments?: ReadonlyArray<WrittenSegment>;
+    readonly failure: {
+        readonly _tag: "Refused";
+        readonly message: string;
+    } | {
+        readonly _tag: "NotLoggedIn";
+    };
+} | {
+    readonly _tag: "NothingOwed";
+} | {
+    readonly _tag: "Skipped";
+} | {
+    readonly _tag: "Refused";
+    readonly message: string;
+}
+/** Jira only: the session expired, so every later Jira write would fail the same way. */
+ | {
+    readonly _tag: "NotLoggedIn";
+};
+export interface WrittenSegment {
+    readonly startMs: number;
+    readonly endMs: number;
+}
+/** Both systems: what a write means unless someone says otherwise. */
+export declare const bothTargets: WriteTargets;
+/**
+ * What one write attempt achieved, per side.
+ *
+ * Per side rather than a single boolean because the two fail independently, and a caller that
+ * summarises what it wrote must not count a side that refused.
+ */
+export interface WriteOutcome {
+    readonly clockify: SideOutcome;
+    readonly jira: SideOutcome;
+}
+/** Why later rows would repeat the same Jira failure, or `null` when the next row remains useful. */
+export declare const writeStopReason: (outcome: WriteOutcome) => string | null;
+/** Seconds this write actually put on Clockify. */
+export declare const clockifyWritten: (outcome: WriteOutcome) => number;
+/** Seconds this write actually put on Jira. */
+export declare const jiraWritten: (outcome: WriteOutcome) => number;
+/**
+ * Whether a run should go on to the next row.
+ *
+ * False for an expired Jira session or an unverified Jira account: every remaining Jira write
+ * would fail the same way, and twenty rows that all fail is worse than stopping at the first. A
+ * Clockify refusal, or a Jira refusal about *this* row, says nothing about the next one.
+ */
+export declare const keepGoing: (outcome: WriteOutcome) => boolean;
+/**
+ * One line per side saying what happened, in the words every surface should use.
+ *
+ * Here rather than in each caller so a terminal and a browser cannot describe the same write
+ * differently. Silent about a side that owed nothing — a row where only Jira was short should not
+ * report a Clockify non-event.
+ */
+export declare const writeOutcomeLines: (outcome: WriteOutcome) => ReadonlyArray<string>;
+/**
+ * Execute concrete per-side amounts and starts without reinterpreting their evidence.
+ *
+ * The plan's targets narrow which systems are touched. A side left out is reported as `Skipped` and its gap
+ * is left exactly as it was — so asking for Jira alone today and both tomorrow writes the Clockify
+ * half tomorrow, rather than treating the skipped side as settled.
+ */
+export declare const applyPlannedWrite: (service: Pick<ReconcileServiceContract, "applyToClockify" | "applyToJira">, plan: PlannedWrite, description: string, sourceRowId?: string, expectedScopes?: ProviderScopes, jiraAvailability?: JiraAvailability) => Effect.Effect<WriteOutcome, never, never>;
+/** Execute CLI/watch proposals while preserving exact corrected-ticket source consumption. */
+export declare const applyProposal: (service: Pick<ReconcileServiceContract, "applyToClockify" | "applyToJira">, proposal: SessionProposal, description: string, sourceScopes: ProviderScopes, targets?: WriteTargets, jiraAvailability?: JiraAvailability) => Effect.Effect<WriteOutcome>;
+//# sourceMappingURL=agentWrite.d.ts.map

package/dist/src/cli/agentWrite.d.ts.map

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