@knpkv/jcf-web 0.2.0

package/dist/shared/contracts.js

@@ -0,0 +1,365 @@
+/**
+ * The HTTP contract of the week view.
+ *
+ * **Mental model**
+ *
+ * - **Reads and reviewed writes.** `week` shows what each system holds, what the sessions say is
+ *   missing, and what could not be placed. Description suggestions reuse that scan's evidence;
+ *   confirmation, manual entry and saved-entry update requests write provider time.
+ * - **The server owns expected state.** Confirmations name retained row evidence. Saved-entry edits
+ *   name a retained provider entry; the engine rechecks that snapshot before updating it.
+ * - **Edits are explicit.** Confirmations may override amount, Issue Key and note. Saved-entry edits
+ *   change time and exact description. Generating a description never saves it.
+ *
+ * @module
+ */
+import { Schema } from "effect";
+/** A local calendar day, `YYYY-MM-DD` — the unit every bucket in jcf is keyed by. */
+export const Day = Schema.String.pipe(Schema.check(Schema.isPattern(/^\d{4}-\d{2}-\d{2}$/)));
+/**
+ * An Issue Key as Jira writes them. Checked here as well as in the engine so a malformed override
+ * is refused at the boundary, before it can become a Clockify description nothing can read back.
+ */
+export const TicketKey = Schema.String.pipe(Schema.check(Schema.isPattern(/^[A-Z][A-Z0-9]{1,9}-\d{1,6}$/)));
+/** Seconds of work: whole, positive, and under a day. */
+export const WorkSeconds = Schema.Number.pipe(Schema.check(Schema.isInt(), Schema.isBetween({ maximum: 24 * 60 * 60, minimum: 1 })));
+/** Free text a person typed, bounded so a description cannot be used to write a novel into Jira. */
+export const Note = Schema.String.pipe(Schema.check(Schema.isMaxLength(500)));
+/** Request a row-level note from the scan's retained evidence, without reading sessions again. */
+export const DescribeRowRequest = Schema.Struct({ planId: Schema.String, rowId: Schema.String });
+/** A suggestion for review, never an instruction to write it to a provider. */
+export const DescribeRowResponse = Schema.Struct({
+    planId: Schema.String,
+    rowId: Schema.String,
+    note: Schema.NullOr(Note)
+});
+/** Whole provider entry, retained on every visible slice. Description includes provider prefixes. */
+export const SavedEntry = Schema.Struct({
+    /** Opaque retained snapshot handle. Send unchanged when saving; use the returned handle afterward. */
+    revision: Schema.String,
+    id: Schema.String,
+    source: Schema.Literals(["jira", "clockify"]),
+    ticketKey: Schema.NullOr(Schema.String),
+    startMs: Schema.Number,
+    endMs: Schema.Number,
+    description: Schema.NullOr(Schema.String)
+});
+export const DescribeSavedEntryRequest = Schema.Struct({
+    planId: Schema.String,
+    source: SavedEntry.fields.source,
+    entryId: Schema.String
+});
+export const DescribeSavedEntryResponse = Schema.Struct({
+    ...DescribeSavedEntryRequest.fields,
+    note: Schema.NullOr(Note),
+    sessionCount: Schema.Number
+});
+/** Server resolves the expected entry; the client can change only its interval and exact description. */
+export const UpdateSavedEntryRequest = Schema.Struct({
+    ...DescribeSavedEntryRequest.fields,
+    revision: SavedEntry.fields.revision,
+    startMs: Schema.Number.pipe(Schema.check(Schema.isInt(), Schema.isBetween({ minimum: 0, maximum: 8640000000000000 }))),
+    endMs: Schema.Number.pipe(Schema.check(Schema.isInt(), Schema.isBetween({ minimum: 0, maximum: 8640000000000000 }))),
+    description: Schema.String.pipe(Schema.check(Schema.isMaxLength(32000)))
+});
+export const UpdateSavedEntryResponse = Schema.Struct({ planId: Schema.String, entry: SavedEntry });
+export class ApiError extends Schema.TaggedError()("ApiError", {
+    message: Schema.String
+}) {
+}
+export class UnauthorizedApiError extends Schema.TaggedError()("UnauthorizedApiError", { message: Schema.String }, { httpApiStatus: 401 }) {
+}
+export class ForbiddenApiError extends Schema.TaggedError()("ForbiddenApiError", { message: Schema.String }, { httpApiStatus: 403 }) {
+}
+/**
+ * The plan a confirmation names is gone, or the row in it is.
+ *
+ * Separate from a rejected write because the repair is different and the browser can do it without
+ * asking anyone: re-read the week and offer the row again.
+ */
+export class PlanExpiredError extends Schema.TaggedError()("PlanExpiredError", { message: Schema.String }, { httpApiStatus: 409 }) {
+}
+/**
+ * The write was refused on its own terms — an amount past what the evidence supports, an Issue Key
+ * the engine will not write. `maxSeconds` is present when a cap is what refused it, so the browser
+ * can say what the ceiling is rather than only that there is one.
+ */
+export class ProposalRejectedError extends Schema.TaggedError()("ProposalRejectedError", { message: Schema.String, maxSeconds: Schema.optional(Schema.Number) }, { httpApiStatus: 422 }) {
+}
+/**
+ * One stretch of credited work: when it happened, and what it is worth.
+ *
+ * Epoch milliseconds because the browser draws these on a grid, and `seconds` because a block is
+ * what a person accepts on its own — `seconds` is its share of the row, which on time worked in
+ * parallel is less than the interval it spans.
+ */
+export const ProposalBlock = Schema.Struct({
+    /** Normalized seconds this source block already supplied to each provider, including corrected-ticket writes. */
+    consumed: Schema.Struct({ clockify: Schema.Number, jira: Schema.Number }),
+    /** A provider-specific safety hold, never a consumed-seconds estimate. */
+    clockifyRefusal: Schema.optionalKey(Schema.Literal("unlinked-overlap")),
+    endMs: Schema.Number,
+    seconds: Schema.Number,
+    startMs: Schema.Number,
+    /** Stable source-cluster identity; rendered starts may move as overlapping work grows. */
+    sourceStartMs: Schema.optional(Schema.Number)
+});
+/** Which evidence placed a row on its Issue Key. */
+export const AttributionSignal = Schema.Literals(["branch", "path", "standing", "agent", "none"]);
+/**
+ * Which systems a week is about.
+ *
+ * One name rather than two booleans in the query string, because "neither" is not a week anyone
+ * asked for. A side that is out is not read, not proposed for, and not written to — so a week with
+ * `only=jira` never touches Clockify at all.
+ */
+export const WeekScope = Schema.Literals(["both", "clockify", "jira"]);
+/** Which systems a single write may touch. Defaults to the scope the week was read under. */
+export const WriteTargets = Schema.Struct({
+    clockify: Schema.Boolean,
+    jira: Schema.Boolean
+});
+/** When recorded time happened, and which system says so. */
+export const RecordedInterval = Schema.Struct({
+    entry: Schema.optionalKey(SavedEntry),
+    endMs: Schema.Number,
+    source: Schema.Literals(["clockify", "jira"]),
+    startMs: Schema.Number
+});
+/**
+ * What a row's sessions say, and what accepting it would write.
+ *
+ * `maxSeconds` is the credited evidence: the ceiling on an edited amount. Editing below it is a
+ * person saying the evidence overstates the work; editing above it would be the tool inventing
+ * hours, which is the one thing every rule here exists to prevent.
+ */
+export const RowProposal = Schema.Struct({
+    activeSeconds: Schema.Number,
+    /**
+     * The stretches behind this row, ascending. They sum to `maxSeconds`, and a confirmation may name
+     * a subset of them by position — which is how a morning gets written without the afternoon.
+     */
+    blocks: Schema.Array(ProposalBlock),
+    clockifyDelta: Schema.Number,
+    confidence: Schema.NullOr(Schema.Number),
+    jiraDelta: Schema.Number,
+    maxSeconds: Schema.Number,
+    sessionCount: Schema.Number,
+    signal: AttributionSignal
+});
+/**
+ * One `(Issue Key, day)` cell of the week.
+ *
+ * Rows exist for time that is only recorded, only evidenced, or both — a day tracked with a Timer
+ * has no proposal, and a day nobody logged has no allocated seconds. Which is the point of showing
+ * them together.
+ */
+export const WeekRow = Schema.Struct({
+    clockifyDescription: Schema.NullOr(Schema.String),
+    clockifySeconds: Schema.Number,
+    day: Day,
+    /**
+     * When the recorded time happened — the entries behind the totals, so a week can be drawn as a
+     * calendar. Empty when the systems reported no usable interval, never fabricated from the total.
+     */
+    intervals: Schema.Array(RecordedInterval),
+    jiraSeconds: Schema.Number,
+    proposal: Schema.optional(RowProposal),
+    rowId: Schema.String,
+    ticketKey: Schema.String,
+    /**
+     * The issue title, or null when Jira could not be asked — logged out, unreachable, or out of
+     * scope for this week. Null is "unknown", never "untitled": an Issue Key alone is a lookup nobody
+     * can do six months later, so it is worth saying when it is missing.
+     */
+    ticketTitle: Schema.NullOr(Schema.String)
+});
+/** Hours that happened on a day and no signal could place, with the directories behind them. */
+export const UnattributedDay = Schema.Struct({
+    cwds: Schema.Array(Schema.String),
+    day: Day,
+    seconds: Schema.Number,
+    sessionCount: Schema.Number
+});
+/** Attributed by a Coding Agent below the confidence floor: shown so the hours stay visible. */
+export const WithheldRow = Schema.Struct({
+    confidence: Schema.NullOr(Schema.Number),
+    day: Day,
+    seconds: Schema.Number,
+    ticketKey: Schema.String,
+    ticketTitle: Schema.NullOr(Schema.String)
+});
+/**
+ * Hours a signal placed on a ticket Jira says belongs to somebody else.
+ *
+ * Reported rather than proposed, and reported rather than dropped: a branch cannot tell authoring
+ * from reviewing, so this is usually a pull request you read — and occasionally your own work on a
+ * colleague's ticket, which is what `assignee` and the override are for.
+ */
+export const NotMineRow = Schema.Struct({
+    /** Who Jira says owns it, or null when it is unassigned. */
+    assignee: Schema.NullOr(Schema.String),
+    day: Day,
+    seconds: Schema.Number,
+    signal: AttributionSignal,
+    ticketKey: Schema.String,
+    ticketTitle: Schema.NullOr(Schema.String)
+});
+/** A day withheld from proposals, with the reason, so it never reads as "nothing to log". */
+export const ExcludedDay = Schema.Struct({
+    day: Day,
+    reason: Schema.String
+});
+export const WeekPlan = Schema.Struct({
+    /**
+     * True when a Coding Agent was needed and could not be reached. The deterministic rows are still
+     * complete; what is missing is only the placement of sessions no branch or path could place.
+     */
+    attributorAvailable: Schema.Boolean,
+    attributorCalls: Schema.Number,
+    days: Schema.Array(Day),
+    excludedDays: Schema.Array(ExcludedDay),
+    monday: Day,
+    /** Names the server-held evidence a confirmation refers to. */
+    planId: Schema.String,
+    rows: Schema.Array(WeekRow),
+    /** Closed Clockify entries without a ticket, excluded from ticket reconciliation. */
+    unlinkedClockify: Schema.Array(Schema.Struct({
+        entry: Schema.optionalKey(SavedEntry),
+        day: Day,
+        seconds: Schema.Number,
+        description: Schema.NullOr(Schema.String),
+        startMs: Schema.Number,
+        endMs: Schema.Number
+    })),
+    sessionCount: Schema.Number,
+    /** False for recorded-only weeks. Omitted by older servers means a session scan is available. */
+    sessionScanAvailable: Schema.optional(Schema.Boolean),
+    /** Which systems this week was read from. A side that is out reports zero because nobody asked. */
+    scope: WeekScope,
+    /** Zero means nothing is opted in, which is the usual reason for an empty week. */
+    sessionRootCount: Schema.Number,
+    /** Hours on tickets assigned to somebody else. Empty when ownership is not being enforced. */
+    notMine: Schema.Array(NotMineRow),
+    /**
+     * True when Jira actually answered about who owns these tickets.
+     *
+     * False means nothing was filtered on ownership, whatever the setting says — a week that quietly
+     * hid rows because Jira was unreachable would be a week missing hours with nothing to explain it.
+     */
+    ownershipChecked: Schema.Boolean,
+    /** Whether this week withheld tickets assigned to other people. */
+    ownership: Schema.Literals(["assigned", "any"]),
+    unattributed: Schema.Array(UnattributedDay),
+    withheld: Schema.Array(WithheldRow)
+});
+/** Authenticated cached view. Missing evidence allows provider-only reads; suggestions require an explicit scan. */
+export const SavedWeek = Schema.Struct({ monday: Day, scope: WeekScope, plan: Schema.NullOr(WeekPlan) });
+/** What one side of a write did. Mirrors `SideOutcome` in the engine. */
+export const SideOutcome = Schema.Union([
+    Schema.TaggedStruct("Written", {
+        seconds: Schema.Number,
+        segments: Schema.optional(Schema.Array(Schema.Struct({ startMs: Schema.Number, endMs: Schema.Number })))
+    }),
+    Schema.TaggedStruct("PartiallyWritten", {
+        seconds: Schema.Number,
+        segments: Schema.optional(Schema.Array(Schema.Struct({ startMs: Schema.Number, endMs: Schema.Number }))),
+        failure: Schema.Union([
+            Schema.TaggedStruct("Refused", { message: Schema.String }),
+            Schema.TaggedStruct("NotLoggedIn", {})
+        ])
+    }),
+    Schema.TaggedStruct("NothingOwed", {}),
+    Schema.TaggedStruct("Skipped", {}),
+    Schema.TaggedStruct("Refused", { message: Schema.String }),
+    Schema.TaggedStruct("NotLoggedIn", {})
+]);
+/**
+ * What a write actually did, in the engine's own words.
+ *
+ * `lines` is rendered by the engine rather than the browser so a terminal and a page cannot describe
+ * the same write differently. `description` is what landed in both systems, returned because it is
+ * the text other people will read.
+ */
+export const WriteResult = Schema.Struct({
+    clockify: SideOutcome,
+    description: Schema.String,
+    jira: SideOutcome,
+    lines: Schema.Array(Schema.String)
+});
+/**
+ * Accept one proposed row, optionally with the amount or the Issue Key overruled.
+ *
+ * No spans, no credited seconds, no deltas: the server holds the evidence this row was built from
+ * and re-reads both systems before writing, so the only numbers a browser can influence are the ones
+ * a person is allowed to choose.
+ */
+export const ConfirmPayload = Schema.Struct({
+    /**
+     * Which of the row's blocks to write, by position. Absent means all of them.
+     *
+     * Positions rather than times or durations, so the server still owns every number: naming block
+     * two of a row it built is not the same kind of claim as sending "40 minutes at 20:52".
+     */
+    blocks: Schema.optional(Schema.Array(Schema.Number.pipe(Schema.check(Schema.isInt())))),
+    note: Schema.optional(Note),
+    planId: Schema.String,
+    rowId: Schema.String,
+    /** Absent means the systems the week was read under. Neither is a usage error, not a write. */
+    targets: Schema.optional(WriteTargets),
+    /** Absent means "as proposed". Present must not exceed the row's `maxSeconds`. */
+    seconds: Schema.optional(WorkSeconds),
+    /** Absent means the Issue Key the evidence placed it on. */
+    ticketKey: Schema.optional(TicketKey)
+});
+/**
+ * Log time no session evidences — a meeting, a whiteboard, a review away from the keyboard.
+ *
+ * Deliberately an *addition* rather than a top-up: a person typing 30 minutes means add 30 minutes,
+ * which is what `jcf timer log` has always done. Nothing is subtracted, so running it twice logs
+ * twice, exactly as typing it twice would.
+ */
+export const ManualPayload = Schema.Struct({
+    day: Day,
+    note: Schema.optional(Note),
+    seconds: WorkSeconds,
+    targets: Schema.optional(WriteTargets),
+    /** Local `HH:MM` the work began. Absent lets the engine place it at local noon. */
+    startClock: Schema.optional(Schema.String.pipe(Schema.check(Schema.isPattern(/^(?:[01]\d|2[0-3]):[0-5]\d$/)))),
+    ticketKey: TicketKey
+});
+/** Treat one ticket as yours whatever Jira says its assignee is. Sticks, in `~/.jcf/config.json`. */
+export const OwnershipPayload = Schema.Struct({
+    ticketKey: TicketKey
+});
+export const OwnershipResult = Schema.Struct({
+    ownershipOverrides: Schema.Array(Schema.String)
+});
+/** Map a directory prefix to an Issue Key, so recurring ticket-less work stops being unplaced. */
+export const StandingPayload = Schema.Struct({
+    cwd: Schema.String.pipe(Schema.check(Schema.isPattern(/^(?:\/|~|[A-Za-z]:[\\/]|[\\/]{2}[^\\/]+[\\/][^\\/]+)/))),
+    ticketKey: TicketKey
+});
+export const StandingResult = Schema.Struct({
+    sessionTicketMap: Schema.Record(Schema.String, Schema.String)
+});
+/** Actual server stages. Counts describe completed attribution work, never estimated percentages. */
+export const ReadProgress = Schema.Struct({
+    activity: Schema.optional(Schema.Struct({
+        batch: Schema.Number,
+        batches: Schema.Number,
+        kind: Schema.Literals(["status", "text", "request", "response"]),
+        text: Schema.String
+    })),
+    stage: Schema.Literals(["sessions", "attribution", "recorded", "issues", "calendar"]),
+    message: Schema.String,
+    completed: Schema.optional(Schema.Number),
+    total: Schema.optional(Schema.Number)
+});
+/** One authenticated read stream, ending in exactly one plan or failure. */
+export const WeekReadEvent = Schema.Union([
+    Schema.TaggedStruct("Progress", { progress: ReadProgress }),
+    Schema.TaggedStruct("Complete", { plan: WeekPlan }),
+    Schema.TaggedStruct("Failed", { message: Schema.String })
+]);
+//# sourceMappingURL=contracts.js.map

package/dist/shared/contracts.js.map

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

package/dist/shared/writePlanning.d.ts

@@ -0,0 +1,6 @@
+import type { CreditedBlock } from "@knpkv/jira-clockify/agent/sessions.js";
+import type { ProposalBlockResponse } from "./contracts.js";
+/** Use only the server-projected consumption for the same block objects given to the planner. */
+export declare const consumedFromWeekBlocks: (blocks: ReadonlyArray<ProposalBlockResponse>) => (block: CreditedBlock, source: "clockify" | "jira") => number;
+/** Compatibility exports; the engine owns confirmation planning for every caller. */
+export { MINIMUM_WRITE_SECONDS, prepareProposal, type ProposedWrite, proposeWrite, selectedBlocks } from "@knpkv/jira-clockify/agent/writePlanning.js";

package/dist/shared/writePlanning.js

@@ -0,0 +1,19 @@
+import { Data } from "effect";
+class MissingProjectedConsumptionError extends Data.TaggedError("MissingProjectedConsumptionError") {
+}
+/** Use only the server-projected consumption for the same block objects given to the planner. */
+export const consumedFromWeekBlocks = (blocks) => {
+    const byBlock = new Map(blocks.map((block) => [
+        block,
+        block.consumed
+    ]));
+    return (block, source) => {
+        const consumed = byBlock.get(block);
+        if (consumed === undefined)
+            throw new MissingProjectedConsumptionError();
+        return consumed[source];
+    };
+};
+/** Compatibility exports; the engine owns confirmation planning for every caller. */
+export { MINIMUM_WRITE_SECONDS, prepareProposal, proposeWrite, selectedBlocks } from "@knpkv/jira-clockify/agent/writePlanning.js";
+//# sourceMappingURL=writePlanning.js.map

package/dist/shared/writePlanning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writePlanning.js","sourceRoot":"","sources":["../../src/shared/writePlanning.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAG7B,MAAM,gCAAiC,SAAQ,IAAI,CAAC,WAAW,CAAC,kCAAkC,CAAK;CAAG;AAE1G,iGAAiG;AACjG,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,MAA4C,EAAE,EAAE;IACrF,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAA+D,EAAE,CAAC;QACzG,KAAK;QACL,KAAK,CAAC,QAAQ;KACf,CAAC,CAAC,CAAA;IACH,OAAO,CAAC,KAAoB,EAAE,MAA2B,EAAU,EAAE;QACnE,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QACnC,IAAI,QAAQ,KAAK,SAAS;YAAE,MAAM,IAAI,gCAAgC,EAAE,CAAA;QACxE,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAA;IACzB,CAAC,CAAA;AACH,CAAC,CAAA;AAED,qFAAqF;AACrF,OAAO,EACL,qBAAqB,EACrB,eAAe,EAEf,YAAY,EACZ,cAAc,EACf,MAAM,6CAA6C,CAAA"}