factory-factory 0.3.17 → 0.3.19

package/dist/src/backend/services/auto-iteration/service/response-parsing.test.js

@@ -0,0 +1,66 @@
+import { describe, expect, it } from 'vitest';
+import { parseCritiqueResult, parseMetricEvaluation } from './response-parsing.js';
+describe('auto-iteration response parsing', () => {
+    it('parses metric evaluation JSON from surrounding text', () => {
+        const result = parseMetricEvaluation('Result:\n```json\n{"metricSummary":"12 passing tests","improved":true,"targetReached":false}\n```');
+        expect(result).toEqual({
+            metricSummary: '12 passing tests',
+            improved: true,
+            targetReached: false,
+        });
+    });
+    it('ignores braces inside JSON strings while finding the object boundary', () => {
+        const result = parseMetricEvaluation('Result: {"metricSummary":"kept { nested } text and an escaped quote: \\"ok\\"","improved":true,"targetReached":true} trailing');
+        expect(result).toEqual({
+            metricSummary: 'kept { nested } text and an escaped quote: "ok"',
+            improved: true,
+            targetReached: true,
+        });
+    });
+    it('falls back to a rejected metric evaluation when JSON is absent', () => {
+        const result = parseMetricEvaluation('plain text response');
+        expect(result).toEqual({
+            metricSummary: 'plain text response',
+            improved: false,
+            targetReached: false,
+        });
+    });
+    it('parses explicit string metric flags', () => {
+        const result = parseMetricEvaluation('{"metricSummary":"string flags","improved":"false","targetReached":"true"}');
+        expect(result).toEqual({
+            metricSummary: 'string flags',
+            improved: false,
+            targetReached: true,
+        });
+    });
+    it('parses numeric true metric flags without treating other numbers as true', () => {
+        const result = parseMetricEvaluation('{"metricSummary":"numeric flags","improved":1,"targetReached":2}');
+        expect(result).toEqual({
+            metricSummary: 'numeric flags',
+            improved: true,
+            targetReached: false,
+        });
+    });
+    it('rejects critique responses that cannot be parsed', () => {
+        const result = parseCritiqueResult('not json');
+        expect(result).toEqual({
+            approved: false,
+            notes: 'Could not parse critique response: not json',
+        });
+    });
+    it('treats non-boolean critique approval as false', () => {
+        const result = parseCritiqueResult('{"approved":"false","notes":"not approved"}');
+        expect(result).toEqual({
+            approved: false,
+            notes: 'not approved',
+        });
+    });
+    it('accepts explicit string true critique approval', () => {
+        const result = parseCritiqueResult('{"approved":"true","notes":"approved"}');
+        expect(result).toEqual({
+            approved: true,
+            notes: 'approved',
+        });
+    });
+});
+//# sourceMappingURL=response-parsing.test.js.map

package/dist/src/backend/services/auto-iteration/service/response-parsing.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-parsing.test.js","sourceRoot":"","sources":["../../../../../../src/backend/services/auto-iteration/service/response-parsing.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAEhF,QAAQ,CAAC,iCAAiC,EAAE,GAAG,EAAE;IAC/C,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,MAAM,MAAM,GAAG,qBAAqB,CAClC,mGAAmG,CACpG,CAAC;QAEF,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YACrB,aAAa,EAAE,kBAAkB;YACjC,QAAQ,EAAE,IAAI;YACd,aAAa,EAAE,KAAK;SACrB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sEAAsE,EAAE,GAAG,EAAE;QAC9E,MAAM,MAAM,GAAG,qBAAqB,CAClC,+HAA+H,CAChI,CAAC;QAEF,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YACrB,aAAa,EAAE,iDAAiD;YAChE,QAAQ,EAAE,IAAI;YACd,aAAa,EAAE,IAAI;SACpB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gEAAgE,EAAE,GAAG,EAAE;QACxE,MAAM,MAAM,GAAG,qBAAqB,CAAC,qBAAqB,CAAC,CAAC;QAE5D,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YACrB,aAAa,EAAE,qBAAqB;YACpC,QAAQ,EAAE,KAAK;YACf,aAAa,EAAE,KAAK;SACrB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,MAAM,GAAG,qBAAqB,CAClC,4EAA4E,CAC7E,CAAC;QAEF,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YACrB,aAAa,EAAE,cAAc;YAC7B,QAAQ,EAAE,KAAK;YACf,aAAa,EAAE,IAAI;SACpB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yEAAyE,EAAE,GAAG,EAAE;QACjF,MAAM,MAAM,GAAG,qBAAqB,CAClC,kEAAkE,CACnE,CAAC;QAEF,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YACrB,aAAa,EAAE,eAAe;YAC9B,QAAQ,EAAE,IAAI;YACd,aAAa,EAAE,KAAK;SACrB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,MAAM,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAC;QAE/C,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YACrB,QAAQ,EAAE,KAAK;YACf,KAAK,EAAE,6CAA6C;SACrD,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,MAAM,GAAG,mBAAmB,CAAC,6CAA6C,CAAC,CAAC;QAElF,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YACrB,QAAQ,EAAE,KAAK;YACf,KAAK,EAAE,cAAc;SACtB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,MAAM,MAAM,GAAG,mBAAmB,CAAC,wCAAwC,CAAC,CAAC;QAE7E,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YACrB,QAAQ,EAAE,IAAI;YACd,KAAK,EAAE,UAAU;SAClB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/backend/services/check-single-writer.test.js

@@ -7,6 +7,7 @@ describe('check-single-writer', () => {
     const tempDirs = [];
     const checkerScriptPath = path.join(process.cwd(), 'scripts/check-single-writer.mjs');
     const accessorSource = readFileSync(path.join(process.cwd(), 'src/backend/services/workspace/resources/workspace.accessor.ts'), 'utf8');
+    const schemaSource = readFileSync(path.join(process.cwd(), 'prisma/schema.prisma'), 'utf8');
     afterEach(() => {
         for (const dir of tempDirs) {
             rmSync(dir, { recursive: true, force: true });
@@ -19,6 +20,9 @@ describe('check-single-writer', () => {
         const accessorDir = path.join(tempRoot, 'src/backend/services/workspace/resources');
         mkdirSync(accessorDir, { recursive: true });
         writeFileSync(path.join(accessorDir, 'workspace.accessor.ts'), accessorSource);
+        const prismaDir = path.join(tempRoot, 'prisma');
+        mkdirSync(prismaDir, { recursive: true });
+        writeFileSync(path.join(prismaDir, 'schema.prisma'), schemaSource);
         for (const file of sourceFiles) {
             const fullPath = path.join(tempRoot, file.relPath);
             mkdirSync(path.dirname(fullPath), { recursive: true });
@@ -121,6 +125,9 @@ describe('check-single-writer', () => {
 export const workspaceAccessor = new WorkspaceAccessor();
 `);
         writeFileSync(path.join(accessorDir, 'workspace.accessor.ts'), accessorWithNewMutator);
+        const prismaDir = path.join(tempRoot, 'prisma');
+        mkdirSync(prismaDir, { recursive: true });
+        writeFileSync(path.join(prismaDir, 'schema.prisma'), schemaSource);
         const sessionDir = path.join(tempRoot, 'src/backend/services/session/service/lifecycle');
         mkdirSync(sessionDir, { recursive: true });
         writeFileSync(path.join(sessionDir, 'session.service.ts'), 'export const marker = "noop";\n');
@@ -128,5 +135,19 @@ export const workspaceAccessor = new WorkspaceAccessor();
         expect(result.status).toBe(1);
         expect(result.output).toContain('workspace mutator(s) missing from checker rules: unsafeExtraMutator');
     });
+    it('fails when a Workspace scalar field is missing ownership policy coverage', () => {
+        const tempRoot = createTempBackend([
+            {
+                relPath: 'src/backend/services/workspace/service/lifecycle/data.service.ts',
+                content: 'export const marker = "noop";\n',
+            },
+        ]);
+        const schemaPath = path.join(tempRoot, 'prisma/schema.prisma');
+        const schemaWithNewField = schemaSource.replace('  stateComputedAt     DateTime?         // Last kanban column computation', '  stateComputedAt     DateTime?         // Last kanban column computation\n  uncheckedMutableField String?');
+        writeFileSync(schemaPath, schemaWithNewField);
+        const result = runChecker(tempRoot);
+        expect(result.status).toBe(1);
+        expect(result.output).toContain('Workspace field(s) missing ownership policy: uncheckedMutableField');
+    });
 });
 //# sourceMappingURL=check-single-writer.test.js.map

package/dist/src/backend/services/check-single-writer.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"check-single-writer.test.js","sourceRoot":"","sources":["../../../../src/backend/services/check-single-writer.test.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"check-single-writer.test.js","sourceRoot":"","sources":["../../../../src/backend/services/check-single-writer.test.ts"],"names":[],"mappings":"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"}

package/dist/src/backend/services/periodic-task/resources/periodic-task.accessor.d.ts

@@ -1,17 +1,21 @@
 import type { PeriodicTask, PeriodicTaskExecution } from '../../../../../prisma/generated/client.js';
 import type { PeriodicTaskCadence, PeriodicTaskExecutionStatus } from '../../../../shared/core/index.js';
-declare function computeNextRunAt(cadence: PeriodicTaskCadence, from?: Date): Date;
+declare function computeNextRunAt(cadence: PeriodicTaskCadence, from?: Date, scheduledTime?: string | null, timezone?: string | null, scheduledDayOfMonth?: number | null): Date;
 interface CreatePeriodicTaskInput {
     projectId: string;
     name: string;
     prompt: string;
     cadence: PeriodicTaskCadence;
+    scheduledTime?: string | null;
+    timezone?: string | null;
 }
 interface UpdatePeriodicTaskInput {
     name?: string;
     prompt?: string;
     cadence?: PeriodicTaskCadence;
     isEnabled?: boolean;
+    scheduledTime?: string | null;
+    timezone?: string | null;
 }
 type PeriodicTaskWithExecutions = PeriodicTask & {
     executions: PeriodicTaskExecution[];
@@ -25,7 +29,7 @@ export declare const periodicTaskAccessor: {
     delete(id: string): Promise<void>;
     toggleEnabled(id: string, enabled: boolean): Promise<PeriodicTask>;
     findDueTasks(): Promise<PeriodicTask[]>;
-    markDispatched(id: string, cadence: PeriodicTaskCadence): Promise<void>;
+    markDispatched(id: string, cadence: PeriodicTaskCadence, scheduledTime: string | null, timezone: string | null, scheduledDayOfMonth: number | null): Promise<void>;
     createExecution(input: {
         periodicTaskId: string;
         workspaceId: string;

package/dist/src/backend/services/periodic-task/resources/periodic-task.accessor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"periodic-task.accessor.d.ts","sourceRoot":"","sources":["../../../../../../src/backend/services/periodic-task/resources/periodic-task.accessor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAE9E,OAAO,KAAK,EAAE,mBAAmB,EAAE,2BAA2B,EAAE,MAAM,eAAe,CAAC;AAItF,iBAAS,gBAAgB,CAAC,OAAO,EAAE,mBAAmB,EAAE,IAAI,GAAE,IAAiB,GAAG,IAAI,CA0BrF;AAID,UAAU,uBAAuB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,mBAAmB,CAAC;CAC9B;AAED,UAAU,uBAAuB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,KAAK,0BAA0B,GAAG,YAAY,GAAG;IAC/C,UAAU,EAAE,qBAAqB,EAAE,CAAC;CACrC,CAAC;AAIF,eAAO,MAAM,oBAAoB;;kBAGX,uBAAuB,GAAG,OAAO,CAAC,YAAY,CAAC;iBAYhD,MAAM,GAAG,OAAO,CAAC,0BAA0B,GAAG,IAAI,CAAC;6BAOvC,MAAM,GAAG,OAAO,CAAC,0BAA0B,EAAE,CAAC;eAQ5D,MAAM,SAAS,uBAAuB,GAAG,OAAO,CAAC,YAAY,CAAC;eAmB9D,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;sBAIf,MAAM,WAAW,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC;oBASlD,OAAO,CAAC,YAAY,EAAE,CAAC;uBASpB,MAAM,WAAW,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;2BAYhD;QAC3B,cAAc,EAAE,MAAM,CAAC;QACvB,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,2BAA2B,CAAC;KACrC,GAAG,OAAO,CAAC,qBAAqB,CAAC;wBAW5B,MAAM,QACJ;QACJ,MAAM,CAAC,EAAE,2BAA2B,CAAC;QACrC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,WAAW,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;KAC3B,GACA,OAAO,CAAC,qBAAqB,CAAC;mCAII,MAAM,mBAAe,OAAO,CAAC,qBAAqB,EAAE,CAAC;6BAQ3D,OAAO,CACpC,CAAC,qBAAqB,GAAG;QAAE,YAAY,EAAE,YAAY,CAAA;KAAE,CAAC,EAAE,CAC3D;wCAOyC,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;0DAQjD,MAAM,GACrB,OAAO,CAAC,qBAAqB,EAAE,CAAC;CAOpC,CAAC"}
+{"version":3,"file":"periodic-task.accessor.d.ts","sourceRoot":"","sources":["../../../../../../src/backend/services/periodic-task/resources/periodic-task.accessor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAE9E,OAAO,KAAK,EAAE,mBAAmB,EAAE,2BAA2B,EAAE,MAAM,eAAe,CAAC;AAkLtF,iBAAS,gBAAgB,CACvB,OAAO,EAAE,mBAAmB,EAC5B,IAAI,GAAE,IAAiB,EACvB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,EAC7B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,EACxB,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,GAClC,IAAI,CA+CN;AAID,UAAU,uBAAuB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,mBAAmB,CAAC;IAC7B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,UAAU,uBAAuB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,KAAK,0BAA0B,GAAG,YAAY,GAAG;IAC/C,UAAU,EAAE,qBAAqB,EAAE,CAAC;CACrC,CAAC;AAIF,eAAO,MAAM,oBAAoB;;kBAGX,uBAAuB,GAAG,OAAO,CAAC,YAAY,CAAC;iBAmBhD,MAAM,GAAG,OAAO,CAAC,0BAA0B,GAAG,IAAI,CAAC;6BAOvC,MAAM,GAAG,OAAO,CAAC,0BAA0B,EAAE,CAAC;eAQ5D,MAAM,SAAS,uBAAuB,GAAG,OAAO,CAAC,YAAY,CAAC;eAqC9D,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;sBAIf,MAAM,WAAW,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC;oBAsBlD,OAAO,CAAC,YAAY,EAAE,CAAC;uBAUvC,MAAM,WACD,mBAAmB,iBACb,MAAM,GAAG,IAAI,YAClB,MAAM,GAAG,IAAI,uBACF,MAAM,GAAG,IAAI,GACjC,OAAO,CAAC,IAAI,CAAC;2BAiCa;QAC3B,cAAc,EAAE,MAAM,CAAC;QACvB,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,2BAA2B,CAAC;KACrC,GAAG,OAAO,CAAC,qBAAqB,CAAC;wBAW5B,MAAM,QACJ;QACJ,MAAM,CAAC,EAAE,2BAA2B,CAAC;QACrC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,WAAW,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;KAC3B,GACA,OAAO,CAAC,qBAAqB,CAAC;mCAII,MAAM,mBAAe,OAAO,CAAC,qBAAqB,EAAE,CAAC;6BAQ3D,OAAO,CACpC,CAAC,qBAAqB,GAAG;QAAE,YAAY,EAAE,YAAY,CAAA;KAAE,CAAC,EAAE,CAC3D;wCAOyC,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;0DAQjD,MAAM,GACrB,OAAO,CAAC,qBAAqB,EAAE,CAAC;CAOpC,CAAC"}

package/dist/src/backend/services/periodic-task/resources/periodic-task.accessor.js

@@ -1,5 +1,102 @@
 import { prisma } from '../../../../backend/db.js';
-function computeNextRunAt(cadence, from = new Date()) {
+const LONG_CADENCES = new Set(['DAILY', 'WEEKLY', 'MONTHLY']);
+const MIN_TIMEZONE_OFFSET_MINUTES = -14 * 60;
+const MAX_TIMEZONE_OFFSET_MINUTES = 12 * 60;
+function getTimeZoneDateParts(date, timezone) {
+    const parts = Object.fromEntries(new Intl.DateTimeFormat('en-CA', {
+        timeZone: timezone,
+        year: 'numeric',
+        month: '2-digit',
+        day: '2-digit',
+    })
+        .formatToParts(date)
+        .map(({ type, value }) => [type, value]));
+    return {
+        year: Number(parts.year),
+        month: Number(parts.month),
+        day: Number(parts.day),
+    };
+}
+function getTimeZoneDateTimeParts(date, formatter) {
+    const parts = Object.fromEntries(formatter.formatToParts(date).map(({ type, value }) => [type, value]));
+    return {
+        year: Number(parts.year),
+        month: Number(parts.month),
+        day: Number(parts.day),
+        hour: Number(parts.hour) % 24,
+        minute: Number(parts.minute),
+    };
+}
+function parseScheduledTime(scheduledTime) {
+    const parts = scheduledTime.split(':').map(Number);
+    return {
+        hours: parts[0] ?? 0,
+        minutes: parts[1] ?? 0,
+    };
+}
+function daysInMonth(year, month) {
+    return new Date(year, month, 0).getDate();
+}
+function dateFromTimeZoneDateTime(dateParts, timeParts, timezone) {
+    const utcProbeMs = Date.UTC(dateParts.year, dateParts.month - 1, dateParts.day, timeParts.hours, timeParts.minutes, 0);
+    const dateTimeFormatter = new Intl.DateTimeFormat('en-CA', {
+        timeZone: timezone,
+        year: 'numeric',
+        month: '2-digit',
+        day: '2-digit',
+        hour: '2-digit',
+        minute: '2-digit',
+        hour12: false,
+    });
+    for (let offsetMinutes = MIN_TIMEZONE_OFFSET_MINUTES; offsetMinutes <= MAX_TIMEZONE_OFFSET_MINUTES; offsetMinutes += 1) {
+        const candidate = new Date(utcProbeMs + offsetMinutes * 60_000);
+        const candidateParts = getTimeZoneDateTimeParts(candidate, dateTimeFormatter);
+        if (candidateParts.year === dateParts.year &&
+            candidateParts.month === dateParts.month &&
+            candidateParts.day === dateParts.day &&
+            candidateParts.hour === timeParts.hours &&
+            candidateParts.minute === timeParts.minutes) {
+            return candidate;
+        }
+    }
+    for (let offsetMinutes = MIN_TIMEZONE_OFFSET_MINUTES; offsetMinutes <= MAX_TIMEZONE_OFFSET_MINUTES; offsetMinutes += 1) {
+        const candidate = new Date(utcProbeMs + offsetMinutes * 60_000);
+        const candidateParts = getTimeZoneDateTimeParts(candidate, dateTimeFormatter);
+        const candidateClockMinutes = candidateParts.hour * 60 + candidateParts.minute;
+        if (candidateParts.year === dateParts.year &&
+            candidateParts.month === dateParts.month &&
+            candidateParts.day === dateParts.day &&
+            candidateClockMinutes > timeParts.hours * 60 + timeParts.minutes) {
+            return candidate;
+        }
+    }
+    return new Date(utcProbeMs);
+}
+function applyScheduledTime(date, scheduledTime, timezone) {
+    return dateFromTimeZoneDateTime(getTimeZoneDateParts(date, timezone), parseScheduledTime(scheduledTime), timezone);
+}
+function getDayOfMonth(date, timezone) {
+    if (!timezone) {
+        return date.getDate();
+    }
+    const day = new Intl.DateTimeFormat('en-US', {
+        timeZone: timezone,
+        day: 'numeric',
+    }).format(date);
+    return Number(day);
+}
+function assignIfDefined(data, key, value) {
+    if (value !== undefined) {
+        data[key] = value;
+    }
+}
+function resolveScheduledDayOfMonth(cadence, existingDay, timezone, anchorDate) {
+    if (cadence !== 'MONTHLY') {
+        return null;
+    }
+    return existingDay ?? getDayOfMonth(anchorDate, timezone);
+}
+function computeNextRunAt(cadence, from = new Date(), scheduledTime, timezone, scheduledDayOfMonth) {
     const next = new Date(from);
     switch (cadence) {
         case 'EVERY_MINUTE':
@@ -15,26 +112,42 @@ function computeNextRunAt(cadence, from = new Date()) {
             next.setDate(next.getDate() + 7);
             break;
         case 'MONTHLY': {
+            if (scheduledTime && timezone) {
+                const fromParts = getTimeZoneDateParts(from, timezone);
+                const targetYear = fromParts.month === 12 ? fromParts.year + 1 : fromParts.year;
+                const targetMonth = fromParts.month === 12 ? 1 : fromParts.month + 1;
+                const targetDay = Math.min(scheduledDayOfMonth ?? fromParts.day, daysInMonth(targetYear, targetMonth));
+                return dateFromTimeZoneDateTime({ year: targetYear, month: targetMonth, day: targetDay }, parseScheduledTime(scheduledTime), timezone);
+            }
             const targetMonth = next.getMonth() + 1;
             next.setDate(1);
             next.setMonth(targetMonth);
-            const lastDay = new Date(next.getFullYear(), next.getMonth() + 1, 0).getDate();
-            next.setDate(Math.min(from.getDate(), lastDay));
+            const targetDay = scheduledDayOfMonth ?? getDayOfMonth(from, timezone);
+            const lastDay = daysInMonth(next.getFullYear(), next.getMonth() + 1);
+            next.setDate(Math.min(targetDay, lastDay));
             break;
         }
     }
+    if (scheduledTime && timezone && LONG_CADENCES.has(cadence)) {
+        return applyScheduledTime(next, scheduledTime, timezone);
+    }
     return next;
 }
 export const periodicTaskAccessor = {
     computeNextRunAt,
     async create(input) {
+        const now = new Date();
+        const scheduledDayOfMonth = input.cadence === 'MONTHLY' ? getDayOfMonth(now, input.timezone) : null;
         return await prisma.periodicTask.create({
             data: {
                 projectId: input.projectId,
                 name: input.name,
                 prompt: input.prompt,
                 cadence: input.cadence,
-                nextRunAt: new Date(),
+                scheduledTime: input.scheduledTime ?? null,
+                timezone: input.timezone ?? null,
+                scheduledDayOfMonth,
+                nextRunAt: now,
             },
         });
     },
@@ -53,18 +166,26 @@ export const periodicTaskAccessor = {
     },
     async update(id, input) {
         const data = {};
-        if (input.name !== undefined) {
-            data.name = input.name;
-        }
-        if (input.prompt !== undefined) {
-            data.prompt = input.prompt;
-        }
-        if (input.isEnabled !== undefined) {
-            data.isEnabled = input.isEnabled;
-        }
-        if (input.cadence !== undefined) {
-            data.cadence = input.cadence;
-            data.nextRunAt = computeNextRunAt(input.cadence);
+        assignIfDefined(data, 'name', input.name);
+        assignIfDefined(data, 'prompt', input.prompt);
+        assignIfDefined(data, 'isEnabled', input.isEnabled);
+        const needsNextRunAt = input.cadence !== undefined ||
+            input.scheduledTime !== undefined ||
+            input.timezone !== undefined;
+        if (needsNextRunAt) {
+            const existing = await prisma.periodicTask.findUniqueOrThrow({ where: { id } });
+            const cadence = (input.cadence ?? existing.cadence);
+            const scheduledTime = input.scheduledTime !== undefined ? input.scheduledTime : existing.scheduledTime;
+            const timezone = input.timezone !== undefined ? input.timezone : existing.timezone;
+            const now = new Date();
+            const scheduledDayOfMonth = resolveScheduledDayOfMonth(cadence, existing.scheduledDayOfMonth, timezone, existing.cadence === 'MONTHLY' ? existing.createdAt : now);
+            Object.assign(data, {
+                ...(input.cadence !== undefined && { cadence: input.cadence }),
+                ...(input.scheduledTime !== undefined && { scheduledTime: input.scheduledTime }),
+                ...(input.timezone !== undefined && { timezone: input.timezone }),
+                scheduledDayOfMonth,
+                nextRunAt: computeNextRunAt(cadence, now, scheduledTime, timezone, scheduledDayOfMonth),
+            });
         }
         return await prisma.periodicTask.update({ where: { id }, data });
     },
@@ -75,7 +196,9 @@ export const periodicTaskAccessor = {
         const data = { isEnabled: enabled };
         if (enabled) {
             const task = await prisma.periodicTask.findUniqueOrThrow({ where: { id } });
-            data.nextRunAt = computeNextRunAt(task.cadence);
+            const scheduledDayOfMonth = resolveScheduledDayOfMonth(task.cadence, task.scheduledDayOfMonth, task.timezone, task.createdAt);
+            data.scheduledDayOfMonth = scheduledDayOfMonth;
+            data.nextRunAt = computeNextRunAt(task.cadence, new Date(), task.scheduledTime, task.timezone, scheduledDayOfMonth);
         }
         return await prisma.periodicTask.update({ where: { id }, data });
     },
@@ -87,12 +210,21 @@ export const periodicTaskAccessor = {
             },
         });
     },
-    async markDispatched(id, cadence) {
+    async markDispatched(id, cadence, scheduledTime, timezone, scheduledDayOfMonth) {
+        let resolvedScheduledDayOfMonth = scheduledDayOfMonth;
+        if (cadence === 'MONTHLY' && resolvedScheduledDayOfMonth == null) {
+            const task = await prisma.periodicTask.findUnique({
+                where: { id },
+                select: { createdAt: true, scheduledDayOfMonth: true, timezone: true },
+            });
+            resolvedScheduledDayOfMonth = resolveScheduledDayOfMonth(cadence, task?.scheduledDayOfMonth, task?.timezone ?? timezone, task?.createdAt ?? new Date());
+        }
         await prisma.periodicTask.update({
             where: { id },
             data: {
                 lastRunAt: new Date(),
-                nextRunAt: computeNextRunAt(cadence),
+                scheduledDayOfMonth: resolvedScheduledDayOfMonth,
+                nextRunAt: computeNextRunAt(cadence, new Date(), scheduledTime, timezone, resolvedScheduledDayOfMonth),
             },
         });
     },

package/dist/src/backend/services/periodic-task/resources/periodic-task.accessor.js.map

@@ -1 +1 @@
-{"version":3,"file":"periodic-task.accessor.js","sourceRoot":"","sources":["../../../../../../src/backend/services/periodic-task/resources/periodic-task.accessor.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"periodic-task.accessor.js","sourceRoot":"","sources":["../../../../../../src/backend/services/periodic-task/resources/periodic-task.accessor.ts"],"names":[],"mappings":"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"}

package/dist/src/backend/services/periodic-task/resources/periodic-task.accessor.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=periodic-task.accessor.test.d.ts.map

package/dist/src/backend/services/periodic-task/resources/periodic-task.accessor.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"periodic-task.accessor.test.d.ts","sourceRoot":"","sources":["../../../../../../src/backend/services/periodic-task/resources/periodic-task.accessor.test.ts"],"names":[],"mappings":""}

package/dist/src/backend/services/periodic-task/resources/periodic-task.accessor.test.js

@@ -0,0 +1,150 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+const prismaMock = vi.hoisted(() => ({
+    periodicTask: {
+        findUnique: vi.fn(),
+        update: vi.fn(),
+    },
+}));
+vi.mock('@/backend/db', () => ({
+    prisma: prismaMock,
+}));
+import { periodicTaskAccessor } from './periodic-task.accessor.js';
+function calendarDate(date, timezone = 'UTC') {
+    const parts = Object.fromEntries(new Intl.DateTimeFormat('en-CA', {
+        timeZone: timezone,
+        year: 'numeric',
+        month: '2-digit',
+        day: '2-digit',
+    })
+        .formatToParts(date)
+        .map(({ type, value }) => [type, value]));
+    return `${parts.year}-${parts.month}-${parts.day}`;
+}
+function getLocalParts(date, timezone) {
+    return Object.fromEntries(new Intl.DateTimeFormat('en-US', {
+        timeZone: timezone,
+        year: 'numeric',
+        month: '2-digit',
+        day: '2-digit',
+        hour: '2-digit',
+        minute: '2-digit',
+        hour12: false,
+    })
+        .formatToParts(date)
+        .map(({ type, value }) => [type, value]));
+}
+function localTime(date, timezone) {
+    const parts = getLocalParts(date, timezone);
+    return `${parts.hour}:${parts.minute}`;
+}
+describe('periodicTaskAccessor.computeNextRunAt', () => {
+    it('keeps scheduled time on the spring-forward DST transition day', () => {
+        const nextRunAt = periodicTaskAccessor.computeNextRunAt('DAILY', new Date('2024-03-09T12:00:00.000Z'), '03:30', 'America/New_York');
+        expect(nextRunAt.toISOString()).toBe('2024-03-10T07:30:00.000Z');
+    });
+    it('runs at the first valid later time when scheduled time does not exist', () => {
+        const nextRunAt = periodicTaskAccessor.computeNextRunAt('DAILY', new Date('2024-03-09T12:00:00.000Z'), '02:30', 'America/New_York');
+        expect(nextRunAt.toISOString()).toBe('2024-03-10T07:00:00.000Z');
+    });
+    it('keeps scheduled time on the fall-back DST transition day', () => {
+        const nextRunAt = periodicTaskAccessor.computeNextRunAt('DAILY', new Date('2024-11-02T12:00:00.000Z'), '03:30', 'America/New_York');
+        expect(nextRunAt.toISOString()).toBe('2024-11-03T08:30:00.000Z');
+    });
+    it('preserves scheduled time for UTC+14 day boundaries', () => {
+        const nextRunAt = periodicTaskAccessor.computeNextRunAt('DAILY', new Date('2024-01-01T00:00:00.000Z'), '03:30', 'Pacific/Kiritimati');
+        expect(nextRunAt.toISOString()).toBe('2024-01-01T13:30:00.000Z');
+    });
+    it('preserves scheduled time for UTC-12 day boundaries', () => {
+        const nextRunAt = periodicTaskAccessor.computeNextRunAt('DAILY', new Date('2024-01-01T12:00:00.000Z'), '23:30', 'Etc/GMT+12');
+        expect(nextRunAt.toISOString()).toBe('2024-01-03T11:30:00.000Z');
+    });
+    it('does not snap short cadences to scheduled times', () => {
+        const nextRunAt = periodicTaskAccessor.computeNextRunAt('EVERY_FIVE_MINUTES', new Date('2024-03-09T12:00:00.000Z'), '03:30', 'America/New_York');
+        expect(nextRunAt.toISOString()).toBe('2024-03-09T12:05:00.000Z');
+    });
+    it('preserves the anchored monthly day after clamping for a short month', () => {
+        const february = periodicTaskAccessor.computeNextRunAt('MONTHLY', new Date('2026-01-31T12:00:00.000Z'), null, null, 31);
+        const march = periodicTaskAccessor.computeNextRunAt('MONTHLY', february, null, null, 31);
+        expect(calendarDate(february)).toBe('2026-02-28');
+        expect(calendarDate(march)).toBe('2026-03-31');
+    });
+    it('preserves a day 30 monthly anchor after February', () => {
+        const february = periodicTaskAccessor.computeNextRunAt('MONTHLY', new Date('2026-01-30T12:00:00.000Z'), null, null, 30);
+        const march = periodicTaskAccessor.computeNextRunAt('MONTHLY', february, null, null, 30);
+        expect(calendarDate(february)).toBe('2026-02-28');
+        expect(calendarDate(march)).toBe('2026-03-30');
+    });
+    it('handles leap-year February while preserving a day 31 monthly anchor', () => {
+        const february = periodicTaskAccessor.computeNextRunAt('MONTHLY', new Date('2028-01-31T12:00:00.000Z'), null, null, 31);
+        const march = periodicTaskAccessor.computeNextRunAt('MONTHLY', february, null, null, 31);
+        expect(calendarDate(february)).toBe('2028-02-29');
+        expect(calendarDate(march)).toBe('2028-03-31');
+    });
+    it('falls back to the dispatch date for legacy rows without a monthly anchor', () => {
+        const next = periodicTaskAccessor.computeNextRunAt('MONTHLY', new Date('2026-02-28T12:00:00.000Z'));
+        expect(calendarDate(next)).toBe('2026-03-28');
+    });
+    it('applies scheduled time in timezone without losing the monthly anchor', () => {
+        const timezone = 'America/New_York';
+        const february = periodicTaskAccessor.computeNextRunAt('MONTHLY', new Date('2026-01-31T15:00:00.000Z'), '09:30', timezone, 31);
+        const march = periodicTaskAccessor.computeNextRunAt('MONTHLY', february, '09:30', timezone, 31);
+        expect(calendarDate(february, timezone)).toBe('2026-02-28');
+        expect(localTime(february, timezone)).toBe('09:30');
+        expect(calendarDate(march, timezone)).toBe('2026-03-31');
+        expect(localTime(march, timezone)).toBe('09:30');
+    });
+    it('keeps MONTHLY scheduled runs on the local clamped day near UTC rollover', () => {
+        const timezone = 'America/New_York';
+        const from = new Date('2026-01-31T00:05:00.000Z');
+        const nextRunAt = periodicTaskAccessor.computeNextRunAt('MONTHLY', from, '09:00', timezone);
+        expect(getLocalParts(nextRunAt, timezone)).toMatchObject({
+            year: '2026',
+            month: '02',
+            day: '28',
+            hour: '09',
+            minute: '00',
+        });
+    });
+    it('preserves local Date monthly clamping when no timezone is configured', () => {
+        const from = new Date(2026, 0, 31, 9, 5);
+        const nextRunAt = periodicTaskAccessor.computeNextRunAt('MONTHLY', from);
+        expect(nextRunAt.getTime()).toBe(new Date(2026, 1, 28, 9, 5).getTime());
+    });
+});
+describe('periodicTaskAccessor.markDispatched', () => {
+    beforeEach(() => {
+        vi.useFakeTimers();
+        vi.setSystemTime(new Date('2026-02-28T15:00:00.000Z'));
+        prismaMock.periodicTask.findUnique.mockReset();
+        prismaMock.periodicTask.update.mockReset();
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+    });
+    it('lazily backfills a legacy monthly anchor from createdAt in the task timezone', async () => {
+        const timezone = 'America/Los_Angeles';
+        prismaMock.periodicTask.findUnique.mockResolvedValue({
+            createdAt: new Date('2026-02-01T07:30:00.000Z'),
+            scheduledDayOfMonth: null,
+            timezone,
+        });
+        prismaMock.periodicTask.update.mockResolvedValue({});
+        await periodicTaskAccessor.markDispatched('task-1', 'MONTHLY', '09:00', timezone, null);
+        expect(prismaMock.periodicTask.update).toHaveBeenCalledWith({
+            where: { id: 'task-1' },
+            data: expect.objectContaining({
+                scheduledDayOfMonth: 31,
+            }),
+        });
+        const updateArgs = prismaMock.periodicTask.update.mock.calls[0]?.[0];
+        const nextRunAt = updateArgs?.data.nextRunAt;
+        expect(getLocalParts(nextRunAt, timezone)).toMatchObject({
+            year: '2026',
+            month: '03',
+            day: '31',
+            hour: '09',
+            minute: '00',
+        });
+    });
+});
+//# sourceMappingURL=periodic-task.accessor.test.js.map

package/dist/src/backend/services/periodic-task/resources/periodic-task.accessor.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"periodic-task.accessor.test.js","sourceRoot":"","sources":["../../../../../../src/backend/services/periodic-task/resources/periodic-task.accessor.test.ts"],"names":[],"mappings":"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"}