@talkpilot/core-db 1.3.70 → 1.3.72

package/README.md

@@ -182,6 +182,8 @@ Refer to `DEVELOPMENT.md` for the full walkthrough, token instructions, and fact
 | 1.3.61  | Optional `activeFlowId` on `WebsiteTalkProduct` (CP-1849). WebsiteTalk updates this flow instead of the flow on a phone number. |
 | 1.3.62  | Pause/Resume support for WebsiteTalk scans (CP-1752): `PAUSED` and `CANCELED` added to `SCAN_STATUSES` (`PAUSED` deliberately excluded from `FINISHED_SCAN_STATUSES` — pausing isn't done, `CANCELED` is). Added `Scan.pausedAt`, tracked across pause/resume so elapsed-time display can freeze correctly instead of counting the paused duration. |
 | 1.3.64  | New `callTokenUsage` collection with `incrementCallTokenUsage` (CP-1810): per-call realtime token usage, one document per `callSid`. |
+| 1.3.71  | Who ended a call (CP-1873): optional `Call.endedBy` (`system` / `agent` / `user`), `CallEndedByValues`, and `setCallEndedBy` (first write wins). **Breaking** vs 1.3.69–1.3.70: the value `resident` was replaced by `user`. |
+| 1.3.72  | Complaint tracking on `muniIssues` (CP-1888): optional `status` / `response` / `updatedAt`, `updateMuniIssueStatus`, `setMuniIssueResponse` (one response, then locked), `findMuniIssuesByClient`, `countMuniIssuesByClient`, `getMuniIssueByIdForClient`, index `clientId_1_createdAt_-1`. |
 
 ### 1.1.9
 
@@ -804,6 +806,24 @@ Optional `activeFlowId` on `WebsiteTalkProduct`. WTIS reads this field when it u
 
 No — the field is optional. **WTIS** should upgrade to **1.3.61** so the call-script update can use it.
 
+### 1.3.71 — Who ended the call (CP-1873)
+
+Records who ended a connected call. Unset for calls that never connected (busy, no-answer) and for calls moved to a conference.
+
+**Added**
+
+| Item | Purpose |
+| --- | --- |
+| `Call.endedBy` | `system` (our platform, e.g. silence timeout), `agent` (the bot ended the flow) or `user` (the caller hung up). |
+| `CallEndedByValues` / `CallEndedBy` | Const object and the type derived from it, same pattern as `CallStatusValues`. |
+| `setCallEndedBy(callSid, endedBy)` | Writes only if `endedBy` is not set yet; returns `true` when this call wrote it. |
+
+`endedBy` is not part of `CallUpdateParams`, so `updateCallByCallSid` cannot overwrite it.
+
+**Do I need to update my app?**
+
+**TalkPilot Server** must upgrade to **1.3.71** to write the field. 1.3.69–1.3.70 used `resident` instead of `user` — don't use them.
+
 ## 🛠 CI/CD & deployment
 
 - This package is consumed by Cloud Build-based services (TalkPilot Server, MIS, CIS) as a dependency when Docker images are built. Keep `dist/` in sync with your builds because the compiled artifact is what downstream services install.

package/dist/municipal/muniIssues/index.d.ts

@@ -1,7 +1,7 @@
 export * from "./muniIssues.getters";
 export * from "./muniIssues.setters";
 export * from "./muniIssues.setup";
-export { MUNI_ISSUES_COLLECTION, MUNI_ISSUE_SYNC_STATUSES, MUNI_ISSUE_TEXT_MAX_LENGTH, MUNI_ISSUE_NAME_MAX_LENGTH, } from "./muniIssues.constants";
+export { MUNI_ISSUES_COLLECTION, MUNI_ISSUE_STATUSES, MUNI_ISSUE_SYNC_STATUSES, MUNI_ISSUE_TEXT_MAX_LENGTH, MUNI_ISSUE_NAME_MAX_LENGTH, } from "./muniIssues.constants";
 export { muniIssuesJsonSchema, muniIssuesIndexes } from "./muniIssues.schema";
-export type { MuniIssue, MuniIssueContent, MuniIssueJira, MuniIssueSyncStatus, CreateMuniIssueInput, } from "./muniIssues.types";
+export type { MuniIssue, MuniIssueContent, MuniIssueJira, MuniIssueSyncStatus, MuniIssueStatus, MuniIssueResponse, CreateMuniIssueInput, SetMuniIssueResponseInput, FindMuniIssuesOptions, } from "./muniIssues.types";
 //# sourceMappingURL=index.d.ts.map

package/dist/municipal/muniIssues/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/municipal/muniIssues/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,0BAA0B,EAC1B,0BAA0B,GAC3B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC9E,YAAY,EACV,SAAS,EACT,gBAAgB,EAChB,aAAa,EACb,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/municipal/muniIssues/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,wBAAwB,EACxB,0BAA0B,EAC1B,0BAA0B,GAC3B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC9E,YAAY,EACV,SAAS,EACT,gBAAgB,EAChB,aAAa,EACb,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC"}

package/dist/municipal/muniIssues/index.js

@@ -14,12 +14,13 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.muniIssuesIndexes = exports.muniIssuesJsonSchema = exports.MUNI_ISSUE_NAME_MAX_LENGTH = exports.MUNI_ISSUE_TEXT_MAX_LENGTH = exports.MUNI_ISSUE_SYNC_STATUSES = exports.MUNI_ISSUES_COLLECTION = void 0;
+exports.muniIssuesIndexes = exports.muniIssuesJsonSchema = exports.MUNI_ISSUE_NAME_MAX_LENGTH = exports.MUNI_ISSUE_TEXT_MAX_LENGTH = exports.MUNI_ISSUE_SYNC_STATUSES = exports.MUNI_ISSUE_STATUSES = exports.MUNI_ISSUES_COLLECTION = void 0;
 __exportStar(require("./muniIssues.getters"), exports);
 __exportStar(require("./muniIssues.setters"), exports);
 __exportStar(require("./muniIssues.setup"), exports);
 var muniIssues_constants_1 = require("./muniIssues.constants");
 Object.defineProperty(exports, "MUNI_ISSUES_COLLECTION", { enumerable: true, get: function () { return muniIssues_constants_1.MUNI_ISSUES_COLLECTION; } });
+Object.defineProperty(exports, "MUNI_ISSUE_STATUSES", { enumerable: true, get: function () { return muniIssues_constants_1.MUNI_ISSUE_STATUSES; } });
 Object.defineProperty(exports, "MUNI_ISSUE_SYNC_STATUSES", { enumerable: true, get: function () { return muniIssues_constants_1.MUNI_ISSUE_SYNC_STATUSES; } });
 Object.defineProperty(exports, "MUNI_ISSUE_TEXT_MAX_LENGTH", { enumerable: true, get: function () { return muniIssues_constants_1.MUNI_ISSUE_TEXT_MAX_LENGTH; } });
 Object.defineProperty(exports, "MUNI_ISSUE_NAME_MAX_LENGTH", { enumerable: true, get: function () { return muniIssues_constants_1.MUNI_ISSUE_NAME_MAX_LENGTH; } });

package/dist/municipal/muniIssues/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/municipal/muniIssues/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,uDAAqC;AACrC,uDAAqC;AACrC,qDAAmC;AACnC,+DAKgC;AAJ9B,8HAAA,sBAAsB,OAAA;AACtB,gIAAA,wBAAwB,OAAA;AACxB,kIAAA,0BAA0B,OAAA;AAC1B,kIAAA,0BAA0B,OAAA;AAE5B,yDAA8E;AAArE,yHAAA,oBAAoB,OAAA;AAAE,sHAAA,iBAAiB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/municipal/muniIssues/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,uDAAqC;AACrC,uDAAqC;AACrC,qDAAmC;AACnC,+DAMgC;AAL9B,8HAAA,sBAAsB,OAAA;AACtB,2HAAA,mBAAmB,OAAA;AACnB,gIAAA,wBAAwB,OAAA;AACxB,kIAAA,0BAA0B,OAAA;AAC1B,kIAAA,0BAA0B,OAAA;AAE5B,yDAA8E;AAArE,yHAAA,oBAAoB,OAAA;AAAE,sHAAA,iBAAiB,OAAA"}

package/dist/municipal/muniIssues/muniIssues.constants.d.ts

@@ -2,6 +2,8 @@
 export declare const MUNI_ISSUES_COLLECTION = "muniIssues";
 /** Sync state of the issue's Jira ticket at write time. */
 export declare const MUNI_ISSUE_SYNC_STATUSES: readonly ["created", "failed"];
+/** Customer-facing complaint status, set manually by the TalkPilot team. */
+export declare const MUNI_ISSUE_STATUSES: readonly ["in_review", "in_progress", "resolved", "no_issue_found"];
 /** Max length for the long free-text fields — well above the ~2000-char target. */
 export declare const MUNI_ISSUE_TEXT_MAX_LENGTH = 5000;
 /** Max length for the short identity fields (a person's name and role). */

package/dist/municipal/muniIssues/muniIssues.constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"muniIssues.constants.d.ts","sourceRoot":"","sources":["../../../src/municipal/muniIssues/muniIssues.constants.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,eAAO,MAAM,sBAAsB,eAAe,CAAC;AAEnD,2DAA2D;AAC3D,eAAO,MAAM,wBAAwB,gCAAiC,CAAC;AAEvE,mFAAmF;AACnF,eAAO,MAAM,0BAA0B,OAAO,CAAC;AAE/C,2EAA2E;AAC3E,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAE9C,uGAAuG;AACvG,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAEnC,yEAAyE;AACzE,eAAO,MAAM,gBAAgB,EAAG,QAAiB,CAAC;AAClD,eAAO,MAAM,iBAAiB,EAAG,OAAgB,CAAC"}
+{"version":3,"file":"muniIssues.constants.d.ts","sourceRoot":"","sources":["../../../src/municipal/muniIssues/muniIssues.constants.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,eAAO,MAAM,sBAAsB,eAAe,CAAC;AAEnD,2DAA2D;AAC3D,eAAO,MAAM,wBAAwB,gCAAiC,CAAC;AAEvE,4EAA4E;AAC5E,eAAO,MAAM,mBAAmB,qEAKtB,CAAC;AAEX,mFAAmF;AACnF,eAAO,MAAM,0BAA0B,OAAO,CAAC;AAE/C,2EAA2E;AAC3E,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAE9C,uGAAuG;AACvG,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAEnC,yEAAyE;AACzE,eAAO,MAAM,gBAAgB,EAAG,QAAiB,CAAC;AAClD,eAAO,MAAM,iBAAiB,EAAG,OAAgB,CAAC"}

package/dist/municipal/muniIssues/muniIssues.constants.js

@@ -1,10 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.VALIDATION_ACTION = exports.VALIDATION_LEVEL = exports.NAMESPACE_EXISTS = exports.MUNI_ISSUE_NAME_MAX_LENGTH = exports.MUNI_ISSUE_TEXT_MAX_LENGTH = exports.MUNI_ISSUE_SYNC_STATUSES = exports.MUNI_ISSUES_COLLECTION = void 0;
+exports.VALIDATION_ACTION = exports.VALIDATION_LEVEL = exports.NAMESPACE_EXISTS = exports.MUNI_ISSUE_NAME_MAX_LENGTH = exports.MUNI_ISSUE_TEXT_MAX_LENGTH = exports.MUNI_ISSUE_STATUSES = exports.MUNI_ISSUE_SYNC_STATUSES = exports.MUNI_ISSUES_COLLECTION = void 0;
 /** Mongo collection name for reported municipal issues. */
 exports.MUNI_ISSUES_COLLECTION = "muniIssues";
 /** Sync state of the issue's Jira ticket at write time. */
 exports.MUNI_ISSUE_SYNC_STATUSES = ["created", "failed"];
+/** Customer-facing complaint status, set manually by the TalkPilot team. */
+exports.MUNI_ISSUE_STATUSES = [
+    "in_review",
+    "in_progress",
+    "resolved",
+    "no_issue_found",
+];
 /** Max length for the long free-text fields — well above the ~2000-char target. */
 exports.MUNI_ISSUE_TEXT_MAX_LENGTH = 5000;
 /** Max length for the short identity fields (a person's name and role). */

package/dist/municipal/muniIssues/muniIssues.constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"muniIssues.constants.js","sourceRoot":"","sources":["../../../src/municipal/muniIssues/muniIssues.constants.ts"],"names":[],"mappings":";;;AAAA,2DAA2D;AAC9C,QAAA,sBAAsB,GAAG,YAAY,CAAC;AAEnD,2DAA2D;AAC9C,QAAA,wBAAwB,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAU,CAAC;AAEvE,mFAAmF;AACtE,QAAA,0BAA0B,GAAG,IAAI,CAAC;AAE/C,2EAA2E;AAC9D,QAAA,0BAA0B,GAAG,GAAG,CAAC;AAE9C,uGAAuG;AAC1F,QAAA,gBAAgB,GAAG,EAAE,CAAC;AAEnC,yEAAyE;AAC5D,QAAA,gBAAgB,GAAG,QAAiB,CAAC;AACrC,QAAA,iBAAiB,GAAG,OAAgB,CAAC"}
+{"version":3,"file":"muniIssues.constants.js","sourceRoot":"","sources":["../../../src/municipal/muniIssues/muniIssues.constants.ts"],"names":[],"mappings":";;;AAAA,2DAA2D;AAC9C,QAAA,sBAAsB,GAAG,YAAY,CAAC;AAEnD,2DAA2D;AAC9C,QAAA,wBAAwB,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAU,CAAC;AAEvE,4EAA4E;AAC/D,QAAA,mBAAmB,GAAG;IACjC,WAAW;IACX,aAAa;IACb,UAAU;IACV,gBAAgB;CACR,CAAC;AAEX,mFAAmF;AACtE,QAAA,0BAA0B,GAAG,IAAI,CAAC;AAE/C,2EAA2E;AAC9D,QAAA,0BAA0B,GAAG,GAAG,CAAC;AAE9C,uGAAuG;AAC1F,QAAA,gBAAgB,GAAG,EAAE,CAAC;AAEnC,yEAAyE;AAC5D,QAAA,gBAAgB,GAAG,QAAiB,CAAC;AACrC,QAAA,iBAAiB,GAAG,OAAgB,CAAC"}

package/dist/municipal/muniIssues/muniIssues.getters.d.ts

@@ -1,7 +1,12 @@
 import { Collection, ObjectId } from "mongodb";
-import { MuniIssue } from "./muniIssues.types";
+import { FindMuniIssuesOptions, MuniIssue } from "./muniIssues.types";
 export declare const getMuniIssuesCollection: () => Collection<MuniIssue>;
 export declare const generateMuniIssueId: () => ObjectId;
 export declare const getMuniIssueById: (id: string) => Promise<MuniIssue | null>;
 export declare const getMuniIssueByJiraKey: (jiraKey: string) => Promise<MuniIssue | null>;
+/** A client's tracked issues, newest first. */
+export declare const findMuniIssuesByClient: (clientId: string, { answered, skip, limit }?: FindMuniIssuesOptions) => Promise<MuniIssue[]>;
+export declare const countMuniIssuesByClient: (clientId: string, { answered }?: Pick<FindMuniIssuesOptions, "answered">) => Promise<number>;
+/** One tracked issue, only if it belongs to the client. */
+export declare const getMuniIssueByIdForClient: (id: string, clientId: string) => Promise<MuniIssue | null>;
 //# sourceMappingURL=muniIssues.getters.d.ts.map

package/dist/municipal/muniIssues/muniIssues.getters.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"muniIssues.getters.d.ts","sourceRoot":"","sources":["../../../src/municipal/muniIssues/muniIssues.getters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAE/C,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAG/C,eAAO,MAAM,uBAAuB,QAAO,UAAU,CAAC,SAAS,CAE9D,CAAC;AAEF,eAAO,MAAM,mBAAmB,QAAO,QAA0B,CAAC;AAElE,eAAO,MAAM,gBAAgB,GAC3B,IAAI,MAAM,KACT,OAAO,CAAC,SAAS,GAAG,IAAI,CAI1B,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAChC,SAAS,MAAM,KACd,OAAO,CAAC,SAAS,GAAG,IAAI,CAE1B,CAAC"}
+{"version":3,"file":"muniIssues.getters.d.ts","sourceRoot":"","sources":["../../../src/municipal/muniIssues/muniIssues.getters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAU,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEvD,OAAO,EAAE,qBAAqB,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAGtE,eAAO,MAAM,uBAAuB,QAAO,UAAU,CAAC,SAAS,CAE9D,CAAC;AAEF,eAAO,MAAM,mBAAmB,QAAO,QAA0B,CAAC;AAElE,eAAO,MAAM,gBAAgB,GAC3B,IAAI,MAAM,KACT,OAAO,CAAC,SAAS,GAAG,IAAI,CAI1B,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAChC,SAAS,MAAM,KACd,OAAO,CAAC,SAAS,GAAG,IAAI,CAE1B,CAAC;AAYF,+CAA+C;AAC/C,eAAO,MAAM,sBAAsB,GACjC,UAAU,MAAM,EAChB,4BAAmC,qBAA0B,KAC5D,OAAO,CAAC,SAAS,EAAE,CAOrB,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAClC,UAAU,MAAM,EAChB,eAAc,IAAI,CAAC,qBAAqB,EAAE,UAAU,CAAM,KACzD,OAAO,CAAC,MAAM,CAIhB,CAAC;AAEF,2DAA2D;AAC3D,eAAO,MAAM,yBAAyB,GACpC,IAAI,MAAM,EACV,UAAU,MAAM,KACf,OAAO,CAAC,SAAS,GAAG,IAAI,CAM1B,CAAC"}

package/dist/municipal/muniIssues/muniIssues.getters.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getMuniIssueByJiraKey = exports.getMuniIssueById = exports.generateMuniIssueId = exports.getMuniIssuesCollection = void 0;
+exports.getMuniIssueByIdForClient = exports.countMuniIssuesByClient = exports.findMuniIssuesByClient = exports.getMuniIssueByJiraKey = exports.getMuniIssueById = exports.generateMuniIssueId = exports.getMuniIssuesCollection = void 0;
 const mongodb_1 = require("mongodb");
 const index_1 = require("../index");
 const muniIssues_constants_1 = require("./muniIssues.constants");
@@ -21,4 +21,34 @@ const getMuniIssueByJiraKey = async (jiraKey) => {
     return (0, exports.getMuniIssuesCollection)().findOne({ "jira.key": jiraKey });
 };
 exports.getMuniIssueByJiraKey = getMuniIssueByJiraKey;
+// Tracked issues of one client. Issues without a status predate complaint tracking and are excluded.
+const clientIssuesFilter = (clientId, answered) => ({
+    clientId,
+    status: { $exists: true },
+    ...(answered !== undefined && { response: { $exists: answered } }),
+});
+/** A client's tracked issues, newest first. */
+const findMuniIssuesByClient = async (clientId, { answered, skip = 0, limit = 0 } = {}) => {
+    return (0, exports.getMuniIssuesCollection)()
+        .find(clientIssuesFilter(clientId, answered))
+        .sort({ createdAt: -1 })
+        .skip(skip)
+        .limit(limit)
+        .toArray();
+};
+exports.findMuniIssuesByClient = findMuniIssuesByClient;
+const countMuniIssuesByClient = async (clientId, { answered } = {}) => {
+    return (0, exports.getMuniIssuesCollection)().countDocuments(clientIssuesFilter(clientId, answered));
+};
+exports.countMuniIssuesByClient = countMuniIssuesByClient;
+/** One tracked issue, only if it belongs to the client. */
+const getMuniIssueByIdForClient = async (id, clientId) => {
+    if (!mongodb_1.ObjectId.isValid(id))
+        return null;
+    return (0, exports.getMuniIssuesCollection)().findOne({
+        ...clientIssuesFilter(clientId),
+        _id: new mongodb_1.ObjectId(id),
+    });
+};
+exports.getMuniIssueByIdForClient = getMuniIssueByIdForClient;
 //# sourceMappingURL=muniIssues.getters.js.map

package/dist/municipal/muniIssues/muniIssues.getters.js.map

@@ -1 +1 @@
-{"version":3,"file":"muniIssues.getters.js","sourceRoot":"","sources":["../../../src/municipal/muniIssues/muniIssues.getters.ts"],"names":[],"mappings":";;;AAAA,qCAA+C;AAC/C,oCAAiC;AAEjC,iEAAgE;AAEzD,MAAM,uBAAuB,GAAG,GAA0B,EAAE;IACjE,OAAO,IAAA,aAAK,GAAE,CAAC,UAAU,CAAY,6CAAsB,CAAC,CAAC;AAC/D,CAAC,CAAC;AAFW,QAAA,uBAAuB,2BAElC;AAEK,MAAM,mBAAmB,GAAG,GAAa,EAAE,CAAC,IAAI,kBAAQ,EAAE,CAAC;AAArD,QAAA,mBAAmB,uBAAkC;AAE3D,MAAM,gBAAgB,GAAG,KAAK,EACnC,EAAU,EACiB,EAAE;IAC7B,iFAAiF;IACjF,IAAI,CAAC,kBAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAAE,OAAO,IAAI,CAAC;IACvC,OAAO,IAAA,+BAAuB,GAAE,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,IAAI,kBAAQ,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;AACtE,CAAC,CAAC;AANW,QAAA,gBAAgB,oBAM3B;AAEK,MAAM,qBAAqB,GAAG,KAAK,EACxC,OAAe,EACY,EAAE;IAC7B,OAAO,IAAA,+BAAuB,GAAE,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;AACpE,CAAC,CAAC;AAJW,QAAA,qBAAqB,yBAIhC"}
+{"version":3,"file":"muniIssues.getters.js","sourceRoot":"","sources":["../../../src/municipal/muniIssues/muniIssues.getters.ts"],"names":[],"mappings":";;;AAAA,qCAAuD;AACvD,oCAAiC;AAEjC,iEAAgE;AAEzD,MAAM,uBAAuB,GAAG,GAA0B,EAAE;IACjE,OAAO,IAAA,aAAK,GAAE,CAAC,UAAU,CAAY,6CAAsB,CAAC,CAAC;AAC/D,CAAC,CAAC;AAFW,QAAA,uBAAuB,2BAElC;AAEK,MAAM,mBAAmB,GAAG,GAAa,EAAE,CAAC,IAAI,kBAAQ,EAAE,CAAC;AAArD,QAAA,mBAAmB,uBAAkC;AAE3D,MAAM,gBAAgB,GAAG,KAAK,EACnC,EAAU,EACiB,EAAE;IAC7B,iFAAiF;IACjF,IAAI,CAAC,kBAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAAE,OAAO,IAAI,CAAC;IACvC,OAAO,IAAA,+BAAuB,GAAE,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,IAAI,kBAAQ,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;AACtE,CAAC,CAAC;AANW,QAAA,gBAAgB,oBAM3B;AAEK,MAAM,qBAAqB,GAAG,KAAK,EACxC,OAAe,EACY,EAAE;IAC7B,OAAO,IAAA,+BAAuB,GAAE,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;AACpE,CAAC,CAAC;AAJW,QAAA,qBAAqB,yBAIhC;AAEF,qGAAqG;AACrG,MAAM,kBAAkB,GAAG,CACzB,QAAgB,EAChB,QAAkB,EACC,EAAE,CAAC,CAAC;IACvB,QAAQ;IACR,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;IACzB,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,CAAC;CACnE,CAAC,CAAC;AAEH,+CAA+C;AACxC,MAAM,sBAAsB,GAAG,KAAK,EACzC,QAAgB,EAChB,EAAE,QAAQ,EAAE,IAAI,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,KAA4B,EAAE,EACvC,EAAE;IACxB,OAAO,IAAA,+BAAuB,GAAE;SAC7B,IAAI,CAAC,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;SAC5C,IAAI,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC;SACvB,IAAI,CAAC,IAAI,CAAC;SACV,KAAK,CAAC,KAAK,CAAC;SACZ,OAAO,EAAE,CAAC;AACf,CAAC,CAAC;AAVW,QAAA,sBAAsB,0BAUjC;AAEK,MAAM,uBAAuB,GAAG,KAAK,EAC1C,QAAgB,EAChB,EAAE,QAAQ,KAA8C,EAAE,EACzC,EAAE;IACnB,OAAO,IAAA,+BAAuB,GAAE,CAAC,cAAc,CAC7C,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CACvC,CAAC;AACJ,CAAC,CAAC;AAPW,QAAA,uBAAuB,2BAOlC;AAEF,2DAA2D;AACpD,MAAM,yBAAyB,GAAG,KAAK,EAC5C,EAAU,EACV,QAAgB,EACW,EAAE;IAC7B,IAAI,CAAC,kBAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAAE,OAAO,IAAI,CAAC;IACvC,OAAO,IAAA,+BAAuB,GAAE,CAAC,OAAO,CAAC;QACvC,GAAG,kBAAkB,CAAC,QAAQ,CAAC;QAC/B,GAAG,EAAE,IAAI,kBAAQ,CAAC,EAAE,CAAC;KACtB,CAAC,CAAC;AACL,CAAC,CAAC;AATW,QAAA,yBAAyB,6BASpC"}

package/dist/municipal/muniIssues/muniIssues.schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"muniIssues.schema.d.ts","sourceRoot":"","sources":["../../../src/municipal/muniIssues/muniIssues.schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAO1D,eAAO,MAAM,oBAAoB,EAAE,QAmDlC,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,gBAAgB,EAK/C,CAAC"}
+{"version":3,"file":"muniIssues.schema.d.ts","sourceRoot":"","sources":["../../../src/municipal/muniIssues/muniIssues.schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAQ1D,eAAO,MAAM,oBAAoB,EAAE,QA8DlC,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,gBAAgB,EAO/C,CAAC"}

package/dist/municipal/muniIssues/muniIssues.schema.js

@@ -52,11 +52,24 @@ exports.muniIssuesJsonSchema = {
             },
         },
         createdAt: { bsonType: "date" },
+        status: { enum: [...muniIssues_constants_1.MUNI_ISSUE_STATUSES] },
+        response: {
+            bsonType: "object",
+            required: ["text", "createdAt"],
+            properties: {
+                text: { bsonType: "string", maxLength: muniIssues_constants_1.MUNI_ISSUE_TEXT_MAX_LENGTH },
+                imageUrl: { bsonType: "string" },
+                createdAt: { bsonType: "date" },
+            },
+        },
+        updatedAt: { bsonType: "date" },
     },
 };
 exports.muniIssuesIndexes = [
     { key: { callSid: 1 }, name: "callSid_1" },
     { key: { createdAt: -1 }, name: "createdAt_-1" },
+    // Complaint list: one municipality's issues, newest first.
+    { key: { clientId: 1, createdAt: -1 }, name: "clientId_1_createdAt_-1" },
     // Unique: one stored document per Jira ticket, guarding against duplicate writes.
     { key: { "jira.key": 1 }, name: "jira_key_unique", unique: true },
 ];

package/dist/municipal/muniIssues/muniIssues.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"muniIssues.schema.js","sourceRoot":"","sources":["../../../src/municipal/muniIssues/muniIssues.schema.ts"],"names":[],"mappings":";;;AACA,iEAIgC;AAEnB,QAAA,oBAAoB,GAAa;IAC5C,QAAQ,EAAE,QAAQ;IAClB,QAAQ,EAAE;QACR,SAAS;QACT,UAAU;QACV,UAAU;QACV,cAAc;QACd,MAAM;QACN,WAAW;KACZ;IACD,UAAU,EAAE;QACV,OAAO,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE;QAC/B,QAAQ,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE;QAChC,QAAQ,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE;QAChC,YAAY,EAAE;YACZ,QAAQ,EAAE,QAAQ;YAClB,QAAQ,EAAE;gBACR,YAAY;gBACZ,YAAY;gBACZ,kBAAkB;gBAClB,iBAAiB;aAClB;YACD,UAAU,EAAE;gBACV,UAAU,EAAE;oBACV,QAAQ,EAAE,QAAQ;oBAClB,SAAS,EAAE,iDAA0B;iBACtC;gBACD,UAAU,EAAE;oBACV,QAAQ,EAAE,QAAQ;oBAClB,SAAS,EAAE,iDAA0B;iBACtC;gBACD,gBAAgB,EAAE;oBAChB,QAAQ,EAAE,QAAQ;oBAClB,SAAS,EAAE,iDAA0B;iBACtC;gBACD,eAAe,EAAE;oBACf,QAAQ,EAAE,QAAQ;oBAClB,SAAS,EAAE,iDAA0B;iBACtC;aACF;SACF;QACD,IAAI,EAAE;YACJ,QAAQ,EAAE,QAAQ;YAClB,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC;YAC/B,UAAU,EAAE;gBACV,GAAG,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE;gBAC3B,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC,GAAG,+CAAwB,CAAC,EAAE;aACpD;SACF;QACD,SAAS,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE;KAChC;CACF,CAAC;AAEW,QAAA,iBAAiB,GAAuB;IACnD,EAAE,GAAG,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE;IAC1C,EAAE,GAAG,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE;IAChD,kFAAkF;IAClF,EAAE,GAAG,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,MAAM,EAAE,IAAI,EAAE;CAClE,CAAC"}
+{"version":3,"file":"muniIssues.schema.js","sourceRoot":"","sources":["../../../src/municipal/muniIssues/muniIssues.schema.ts"],"names":[],"mappings":";;;AACA,iEAKgC;AAEnB,QAAA,oBAAoB,GAAa;IAC5C,QAAQ,EAAE,QAAQ;IAClB,QAAQ,EAAE;QACR,SAAS;QACT,UAAU;QACV,UAAU;QACV,cAAc;QACd,MAAM;QACN,WAAW;KACZ;IACD,UAAU,EAAE;QACV,OAAO,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE;QAC/B,QAAQ,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE;QAChC,QAAQ,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE;QAChC,YAAY,EAAE;YACZ,QAAQ,EAAE,QAAQ;YAClB,QAAQ,EAAE;gBACR,YAAY;gBACZ,YAAY;gBACZ,kBAAkB;gBAClB,iBAAiB;aAClB;YACD,UAAU,EAAE;gBACV,UAAU,EAAE;oBACV,QAAQ,EAAE,QAAQ;oBAClB,SAAS,EAAE,iDAA0B;iBACtC;gBACD,UAAU,EAAE;oBACV,QAAQ,EAAE,QAAQ;oBAClB,SAAS,EAAE,iDAA0B;iBACtC;gBACD,gBAAgB,EAAE;oBAChB,QAAQ,EAAE,QAAQ;oBAClB,SAAS,EAAE,iDAA0B;iBACtC;gBACD,eAAe,EAAE;oBACf,QAAQ,EAAE,QAAQ;oBAClB,SAAS,EAAE,iDAA0B;iBACtC;aACF;SACF;QACD,IAAI,EAAE;YACJ,QAAQ,EAAE,QAAQ;YAClB,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC;YAC/B,UAAU,EAAE;gBACV,GAAG,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE;gBAC3B,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC,GAAG,+CAAwB,CAAC,EAAE;aACpD;SACF;QACD,SAAS,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE;QAC/B,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,GAAG,0CAAmB,CAAC,EAAE;QAC1C,QAAQ,EAAE;YACR,QAAQ,EAAE,QAAQ;YAClB,QAAQ,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC;YAC/B,UAAU,EAAE;gBACV,IAAI,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,iDAA0B,EAAE;gBACnE,QAAQ,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE;gBAChC,SAAS,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE;aAChC;SACF;QACD,SAAS,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE;KAChC;CACF,CAAC;AAEW,QAAA,iBAAiB,GAAuB;IACnD,EAAE,GAAG,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE;IAC1C,EAAE,GAAG,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE;IAChD,2DAA2D;IAC3D,EAAE,GAAG,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,yBAAyB,EAAE;IACxE,kFAAkF;IAClF,EAAE,GAAG,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,MAAM,EAAE,IAAI,EAAE;CAClE,CAAC"}

package/dist/municipal/muniIssues/muniIssues.setters.d.ts

@@ -1,4 +1,8 @@
 import { ObjectId } from "mongodb";
-import { CreateMuniIssueInput } from "./muniIssues.types";
+import { CreateMuniIssueInput, MuniIssueStatus, SetMuniIssueResponseInput } from "./muniIssues.types";
 export declare const createMuniIssue: (issueData: CreateMuniIssueInput, id: ObjectId) => Promise<ObjectId>;
+/** Changes the status of an unanswered issue. Returns false if none matched. */
+export declare const updateMuniIssueStatus: (id: string, clientId: string, status: MuniIssueStatus) => Promise<boolean>;
+/** Saves the single TalkPilot response, which locks the issue. Returns false if none matched. */
+export declare const setMuniIssueResponse: (id: string, clientId: string, { status, text, imageUrl }: SetMuniIssueResponseInput) => Promise<boolean>;
 //# sourceMappingURL=muniIssues.setters.d.ts.map

package/dist/municipal/muniIssues/muniIssues.setters.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"muniIssues.setters.d.ts","sourceRoot":"","sources":["../../../src/municipal/muniIssues/muniIssues.setters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,oBAAoB,EAAa,MAAM,oBAAoB,CAAC;AAKrE,eAAO,MAAM,eAAe,GAC1B,WAAW,oBAAoB,EAC/B,IAAI,QAAQ,KACX,OAAO,CAAC,QAAQ,CAclB,CAAC"}
+{"version":3,"file":"muniIssues.setters.d.ts","sourceRoot":"","sources":["../../../src/municipal/muniIssues/muniIssues.setters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EACL,oBAAoB,EAEpB,eAAe,EACf,yBAAyB,EAC1B,MAAM,oBAAoB,CAAC;AAK5B,eAAO,MAAM,eAAe,GAC1B,WAAW,oBAAoB,EAC/B,IAAI,QAAQ,KACX,OAAO,CAAC,QAAQ,CAiBlB,CAAC;AAWF,gFAAgF;AAChF,eAAO,MAAM,qBAAqB,GAChC,IAAI,MAAM,EACV,UAAU,MAAM,EAChB,QAAQ,eAAe,KACtB,OAAO,CAAC,OAAO,CASjB,CAAC;AAEF,iGAAiG;AACjG,eAAO,MAAM,oBAAoB,GAC/B,IAAI,MAAM,EACV,UAAU,MAAM,EAChB,4BAA4B,yBAAyB,KACpD,OAAO,CAAC,OAAO,CAgBjB,CAAC"}

package/dist/municipal/muniIssues/muniIssues.setters.js

@@ -1,11 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createMuniIssue = void 0;
+exports.setMuniIssueResponse = exports.updateMuniIssueStatus = exports.createMuniIssue = void 0;
+const mongodb_1 = require("mongodb");
 const muniIssues_getters_1 = require("./muniIssues.getters");
 const muniIssues_setup_1 = require("./muniIssues.setup");
 // Required `id`: MIS pre-generates it (generateMuniIssueId) and embeds it in the Jira ticket — the two-way link.
 const createMuniIssue = async (issueData, id) => {
     await (0, muniIssues_setup_1.ensureMuniIssuesCollectionOnce)();
+    const now = new Date();
     const issue = {
         _id: id,
         ...issueData,
@@ -13,10 +15,45 @@ const createMuniIssue = async (issueData, id) => {
             ...issueData.jira,
             syncStatus: issueData.jira.syncStatus ?? "created",
         },
-        createdAt: new Date(),
+        status: "in_review",
+        createdAt: now,
+        updatedAt: now,
     };
     const { insertedId } = await (0, muniIssues_getters_1.getMuniIssuesCollection)().insertOne(issue);
     return insertedId;
 };
 exports.createMuniIssue = createMuniIssue;
+// An issue of this client that is tracked (has a status) and not yet answered.
+// The `response` condition is the lock: once answered, no further writes match.
+const openIssueFilter = (id, clientId) => ({
+    _id: new mongodb_1.ObjectId(id),
+    clientId,
+    status: { $exists: true },
+    response: { $exists: false },
+});
+/** Changes the status of an unanswered issue. Returns false if none matched. */
+const updateMuniIssueStatus = async (id, clientId, status) => {
+    if (!mongodb_1.ObjectId.isValid(id))
+        return false;
+    await (0, muniIssues_setup_1.ensureMuniIssuesCollectionOnce)();
+    const { matchedCount } = await (0, muniIssues_getters_1.getMuniIssuesCollection)().updateOne(openIssueFilter(id, clientId), { $set: { status, updatedAt: new Date() } });
+    return matchedCount > 0;
+};
+exports.updateMuniIssueStatus = updateMuniIssueStatus;
+/** Saves the single TalkPilot response, which locks the issue. Returns false if none matched. */
+const setMuniIssueResponse = async (id, clientId, { status, text, imageUrl }) => {
+    if (!mongodb_1.ObjectId.isValid(id))
+        return false;
+    await (0, muniIssues_setup_1.ensureMuniIssuesCollectionOnce)();
+    const now = new Date();
+    const { matchedCount } = await (0, muniIssues_getters_1.getMuniIssuesCollection)().updateOne(openIssueFilter(id, clientId), {
+        $set: {
+            status,
+            response: { text, ...(imageUrl && { imageUrl }), createdAt: now },
+            updatedAt: now,
+        },
+    });
+    return matchedCount > 0;
+};
+exports.setMuniIssueResponse = setMuniIssueResponse;
 //# sourceMappingURL=muniIssues.setters.js.map

package/dist/municipal/muniIssues/muniIssues.setters.js.map

@@ -1 +1 @@
-{"version":3,"file":"muniIssues.setters.js","sourceRoot":"","sources":["../../../src/municipal/muniIssues/muniIssues.setters.ts"],"names":[],"mappings":";;;AAEA,6DAA+D;AAC/D,yDAAoE;AAEpE,iHAAiH;AAC1G,MAAM,eAAe,GAAG,KAAK,EAClC,SAA+B,EAC/B,EAAY,EACO,EAAE;IACrB,MAAM,IAAA,iDAA8B,GAAE,CAAC;IAEvC,MAAM,KAAK,GAAc;QACvB,GAAG,EAAE,EAAE;QACP,GAAG,SAAS;QACZ,IAAI,EAAE;YACJ,GAAG,SAAS,CAAC,IAAI;YACjB,UAAU,EAAE,SAAS,CAAC,IAAI,CAAC,UAAU,IAAI,SAAS;SACnD;QACD,SAAS,EAAE,IAAI,IAAI,EAAE;KACtB,CAAC;IACF,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,IAAA,4CAAuB,GAAE,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACxE,OAAO,UAAU,CAAC;AACpB,CAAC,CAAC;AAjBW,QAAA,eAAe,mBAiB1B"}
+{"version":3,"file":"muniIssues.setters.js","sourceRoot":"","sources":["../../../src/municipal/muniIssues/muniIssues.setters.ts"],"names":[],"mappings":";;;AAAA,qCAA2C;AAO3C,6DAA+D;AAC/D,yDAAoE;AAEpE,iHAAiH;AAC1G,MAAM,eAAe,GAAG,KAAK,EAClC,SAA+B,EAC/B,EAAY,EACO,EAAE;IACrB,MAAM,IAAA,iDAA8B,GAAE,CAAC;IAEvC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,MAAM,KAAK,GAAc;QACvB,GAAG,EAAE,EAAE;QACP,GAAG,SAAS;QACZ,IAAI,EAAE;YACJ,GAAG,SAAS,CAAC,IAAI;YACjB,UAAU,EAAE,SAAS,CAAC,IAAI,CAAC,UAAU,IAAI,SAAS;SACnD;QACD,MAAM,EAAE,WAAW;QACnB,SAAS,EAAE,GAAG;QACd,SAAS,EAAE,GAAG;KACf,CAAC;IACF,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,IAAA,4CAAuB,GAAE,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACxE,OAAO,UAAU,CAAC;AACpB,CAAC,CAAC;AApBW,QAAA,eAAe,mBAoB1B;AAEF,+EAA+E;AAC/E,gFAAgF;AAChF,MAAM,eAAe,GAAG,CAAC,EAAU,EAAE,QAAgB,EAAqB,EAAE,CAAC,CAAC;IAC5E,GAAG,EAAE,IAAI,kBAAQ,CAAC,EAAE,CAAC;IACrB,QAAQ;IACR,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;IACzB,QAAQ,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE;CAC7B,CAAC,CAAC;AAEH,gFAAgF;AACzE,MAAM,qBAAqB,GAAG,KAAK,EACxC,EAAU,EACV,QAAgB,EAChB,MAAuB,EACL,EAAE;IACpB,IAAI,CAAC,kBAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAAE,OAAO,KAAK,CAAC;IACxC,MAAM,IAAA,iDAA8B,GAAE,CAAC;IAEvC,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,IAAA,4CAAuB,GAAE,CAAC,SAAS,CAChE,eAAe,CAAC,EAAE,EAAE,QAAQ,CAAC,EAC7B,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,EAAE,EAAE,CAC5C,CAAC;IACF,OAAO,YAAY,GAAG,CAAC,CAAC;AAC1B,CAAC,CAAC;AAbW,QAAA,qBAAqB,yBAahC;AAEF,iGAAiG;AAC1F,MAAM,oBAAoB,GAAG,KAAK,EACvC,EAAU,EACV,QAAgB,EAChB,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAA6B,EACnC,EAAE;IACpB,IAAI,CAAC,kBAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAAE,OAAO,KAAK,CAAC;IACxC,MAAM,IAAA,iDAA8B,GAAE,CAAC;IAEvC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,IAAA,4CAAuB,GAAE,CAAC,SAAS,CAChE,eAAe,CAAC,EAAE,EAAE,QAAQ,CAAC,EAC7B;QACE,IAAI,EAAE;YACJ,MAAM;YACN,QAAQ,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,QAAQ,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE;YACjE,SAAS,EAAE,GAAG;SACf;KACF,CACF,CAAC;IACF,OAAO,YAAY,GAAG,CAAC,CAAC;AAC1B,CAAC,CAAC;AApBW,QAAA,oBAAoB,wBAoB/B"}

package/dist/municipal/muniIssues/muniIssues.types.d.ts

@@ -1,7 +1,14 @@
 import { ObjectId } from "mongodb";
 import { CityName } from "../utils/types";
-import { MUNI_ISSUE_SYNC_STATUSES } from "./muniIssues.constants";
+import { MUNI_ISSUE_STATUSES, MUNI_ISSUE_SYNC_STATUSES } from "./muniIssues.constants";
 export type MuniIssueSyncStatus = (typeof MUNI_ISSUE_SYNC_STATUSES)[number];
+export type MuniIssueStatus = (typeof MUNI_ISSUE_STATUSES)[number];
+/** The single TalkPilot response; once set, the complaint is locked. */
+export type MuniIssueResponse = {
+    text: string;
+    imageUrl?: string;
+    createdAt: Date;
+};
 export type MuniIssueContent = {
     issuerName: string;
     issuerRole: string;
@@ -20,11 +27,25 @@ export type MuniIssue = {
     issueContent: MuniIssueContent;
     jira: MuniIssueJira;
     createdAt: Date;
+    status?: MuniIssueStatus;
+    response?: MuniIssueResponse;
+    updatedAt?: Date;
 };
-export type CreateMuniIssueInput = Omit<MuniIssue, "_id" | "createdAt" | "jira"> & {
+export type CreateMuniIssueInput = Omit<MuniIssue, "_id" | "createdAt" | "jira" | "status" | "response" | "updatedAt"> & {
     jira: {
         key: string;
         syncStatus?: MuniIssueSyncStatus;
     };
 };
+export type SetMuniIssueResponseInput = {
+    status: MuniIssueStatus;
+    text: string;
+    imageUrl?: string;
+};
+/** `answered` filters by whether a TalkPilot response exists; omit it for all issues. */
+export type FindMuniIssuesOptions = {
+    answered?: boolean;
+    skip?: number;
+    limit?: number;
+};
 //# sourceMappingURL=muniIssues.types.d.ts.map

package/dist/municipal/muniIssues/muniIssues.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"muniIssues.types.d.ts","sourceRoot":"","sources":["../../../src/municipal/muniIssues/muniIssues.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAElE,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5E,MAAM,MAAM,gBAAgB,GAAG;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,mBAAmB,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,GAAG,EAAE,QAAQ,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,QAAQ,CAAC;IACnB,YAAY,EAAE,gBAAgB,CAAC;IAC/B,IAAI,EAAE,aAAa,CAAC;IACpB,SAAS,EAAE,IAAI,CAAC;CACjB,CAAC;AAIF,MAAM,MAAM,oBAAoB,GAAG,IAAI,CACrC,SAAS,EACT,KAAK,GAAG,WAAW,GAAG,MAAM,CAC7B,GAAG;IACF,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,mBAAmB,CAAA;KAAE,CAAC;CACzD,CAAC"}
+{"version":3,"file":"muniIssues.types.d.ts","sourceRoot":"","sources":["../../../src/municipal/muniIssues/muniIssues.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACzB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5E,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnE,wEAAwE;AACxE,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,IAAI,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,mBAAmB,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,GAAG,EAAE,QAAQ,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,QAAQ,CAAC;IACnB,YAAY,EAAE,gBAAgB,CAAC;IAC/B,IAAI,EAAE,aAAa,CAAC;IACpB,SAAS,EAAE,IAAI,CAAC;IAGhB,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,SAAS,CAAC,EAAE,IAAI,CAAC;CAClB,CAAC;AAIF,MAAM,MAAM,oBAAoB,GAAG,IAAI,CACrC,SAAS,EACT,KAAK,GAAG,WAAW,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,WAAW,CACnE,GAAG;IACF,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,mBAAmB,CAAA;KAAE,CAAC;CACzD,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,MAAM,EAAE,eAAe,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,yFAAyF;AACzF,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC"}

package/dist/talkpilot/calls/calls.constants.d.ts

@@ -32,4 +32,10 @@ export declare const CallStatusValues: {
     readonly Canceled: "canceled";
 };
 export declare const ALL_CALL_STATUSES: ("in-progress" | "answered" | "no-answer" | "completed" | "busy" | "failed" | "canceled" | "initiated" | "ringing")[];
+/** Who ended a connected call: our platform, the bot (end flow), or the caller. */
+export declare const CallEndedByValues: {
+    readonly System: "system";
+    readonly Agent: "agent";
+    readonly User: "user";
+};
 //# sourceMappingURL=calls.constants.d.ts.map

package/dist/talkpilot/calls/calls.constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"calls.constants.d.ts","sourceRoot":"","sources":["../../../src/talkpilot/calls/calls.constants.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,eAAO,MAAM,wBAAwB,EAAG,UAAmB,CAAC;AAE5D,gDAAgD;AAChD,eAAO,MAAM,0BAA0B,EAAG,YAAqB,CAAC;AAEhE,wEAAwE;AACxE,eAAO,MAAM,gBAAgB,sCAAuC,CAAC;AAErE,4EAA4E;AAC5E,eAAO,MAAM,cAAc,mEAMjB,CAAC;AAEX,6BAA6B;AAC7B,eAAO,MAAM,aAAa,KAAK,CAAC;AAEhC,iEAAiE;AACjE,eAAO,MAAM,iBAAiB,QAAS,CAAC;AAExC;;;;;GAKG;AACH,eAAO,MAAM,6BAA6B,IAAI,CAAC;AAC/C,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAE9C,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAC9C,eAAO,MAAM,6BAA6B,KAAK,CAAC;AAEhD,eAAO,MAAM,gBAAgB;;;;;;;;;;CAUnB,CAAC;AAEX,eAAO,MAAM,iBAAiB,uHAAkC,CAAC"}
+{"version":3,"file":"calls.constants.d.ts","sourceRoot":"","sources":["../../../src/talkpilot/calls/calls.constants.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,eAAO,MAAM,wBAAwB,EAAG,UAAmB,CAAC;AAE5D,gDAAgD;AAChD,eAAO,MAAM,0BAA0B,EAAG,YAAqB,CAAC;AAEhE,wEAAwE;AACxE,eAAO,MAAM,gBAAgB,sCAAuC,CAAC;AAErE,4EAA4E;AAC5E,eAAO,MAAM,cAAc,mEAMjB,CAAC;AAEX,6BAA6B;AAC7B,eAAO,MAAM,aAAa,KAAK,CAAC;AAEhC,iEAAiE;AACjE,eAAO,MAAM,iBAAiB,QAAS,CAAC;AAExC;;;;;GAKG;AACH,eAAO,MAAM,6BAA6B,IAAI,CAAC;AAC/C,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAE9C,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAC9C,eAAO,MAAM,6BAA6B,KAAK,CAAC;AAEhD,eAAO,MAAM,gBAAgB;;;;;;;;;;CAUnB,CAAC;AAEX,eAAO,MAAM,iBAAiB,uHAAkC,CAAC;AAEjE,mFAAmF;AACnF,eAAO,MAAM,iBAAiB;;;;CAIpB,CAAC"}

package/dist/talkpilot/calls/calls.constants.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ALL_CALL_STATUSES = exports.CallStatusValues = exports.TOOL_EXECUTIONS_DEFAULT_LIMIT = exports.TOOL_EXECUTIONS_DEFAULT_SKIP = exports.TREND_WEEK_BUCKET_MIN_MONTHS = exports.TREND_MONTH_BUCKET_MIN_MONTHS = exports.STATS_MAX_TIME_MS = exports.HOURS_PER_DAY = exports.FINAL_STATUSES = exports.IN_CALL_STATUSES = exports.CONFERENCE_ROLE_SUPERVISOR = exports.CONFERENCE_ROLE_CUSTOMER = void 0;
+exports.CallEndedByValues = exports.ALL_CALL_STATUSES = exports.CallStatusValues = exports.TOOL_EXECUTIONS_DEFAULT_LIMIT = exports.TOOL_EXECUTIONS_DEFAULT_SKIP = exports.TREND_WEEK_BUCKET_MIN_MONTHS = exports.TREND_MONTH_BUCKET_MIN_MONTHS = exports.STATS_MAX_TIME_MS = exports.HOURS_PER_DAY = exports.FINAL_STATUSES = exports.IN_CALL_STATUSES = exports.CONFERENCE_ROLE_SUPERVISOR = exports.CONFERENCE_ROLE_CUSTOMER = void 0;
 /** Customer role within a conference call. */
 exports.CONFERENCE_ROLE_CUSTOMER = "customer";
 /** Supervisor role within a conference call. */
@@ -41,4 +41,10 @@ exports.CallStatusValues = {
     Canceled: "canceled",
 };
 exports.ALL_CALL_STATUSES = Object.values(exports.CallStatusValues);
+/** Who ended a connected call: our platform, the bot (end flow), or the caller. */
+exports.CallEndedByValues = {
+    System: "system",
+    Agent: "agent",
+    User: "user",
+};
 //# sourceMappingURL=calls.constants.js.map

package/dist/talkpilot/calls/calls.constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"calls.constants.js","sourceRoot":"","sources":["../../../src/talkpilot/calls/calls.constants.ts"],"names":[],"mappings":";;;AAAA,8CAA8C;AACjC,QAAA,wBAAwB,GAAG,UAAmB,CAAC;AAE5D,gDAAgD;AACnC,QAAA,0BAA0B,GAAG,YAAqB,CAAC;AAEhE,wEAAwE;AAC3D,QAAA,gBAAgB,GAAG,CAAC,aAAa,EAAE,UAAU,CAAU,CAAC;AAErE,4EAA4E;AAC/D,QAAA,cAAc,GAAG;IAC5B,WAAW;IACX,WAAW;IACX,MAAM;IACN,QAAQ;IACR,UAAU;CACF,CAAC;AAEX,6BAA6B;AAChB,QAAA,aAAa,GAAG,EAAE,CAAC;AAEhC,iEAAiE;AACpD,QAAA,iBAAiB,GAAG,MAAM,CAAC;AAExC;;;;;GAKG;AACU,QAAA,6BAA6B,GAAG,CAAC,CAAC;AAClC,QAAA,4BAA4B,GAAG,CAAC,CAAC;AAEjC,QAAA,4BAA4B,GAAG,CAAC,CAAC;AACjC,QAAA,6BAA6B,GAAG,EAAE,CAAC;AAEnC,QAAA,gBAAgB,GAAG;IAC9B,SAAS,EAAE,WAAW;IACtB,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,aAAa;IACzB,QAAQ,EAAE,UAAU;IACpB,SAAS,EAAE,WAAW;IACtB,IAAI,EAAE,MAAM;IACZ,QAAQ,EAAE,WAAW;IACrB,MAAM,EAAE,QAAQ;IAChB,QAAQ,EAAE,UAAU;CACZ,CAAC;AAEE,QAAA,iBAAiB,GAAG,MAAM,CAAC,MAAM,CAAC,wBAAgB,CAAC,CAAC"}
+{"version":3,"file":"calls.constants.js","sourceRoot":"","sources":["../../../src/talkpilot/calls/calls.constants.ts"],"names":[],"mappings":";;;AAAA,8CAA8C;AACjC,QAAA,wBAAwB,GAAG,UAAmB,CAAC;AAE5D,gDAAgD;AACnC,QAAA,0BAA0B,GAAG,YAAqB,CAAC;AAEhE,wEAAwE;AAC3D,QAAA,gBAAgB,GAAG,CAAC,aAAa,EAAE,UAAU,CAAU,CAAC;AAErE,4EAA4E;AAC/D,QAAA,cAAc,GAAG;IAC5B,WAAW;IACX,WAAW;IACX,MAAM;IACN,QAAQ;IACR,UAAU;CACF,CAAC;AAEX,6BAA6B;AAChB,QAAA,aAAa,GAAG,EAAE,CAAC;AAEhC,iEAAiE;AACpD,QAAA,iBAAiB,GAAG,MAAM,CAAC;AAExC;;;;;GAKG;AACU,QAAA,6BAA6B,GAAG,CAAC,CAAC;AAClC,QAAA,4BAA4B,GAAG,CAAC,CAAC;AAEjC,QAAA,4BAA4B,GAAG,CAAC,CAAC;AACjC,QAAA,6BAA6B,GAAG,EAAE,CAAC;AAEnC,QAAA,gBAAgB,GAAG;IAC9B,SAAS,EAAE,WAAW;IACtB,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,aAAa;IACzB,QAAQ,EAAE,UAAU;IACpB,SAAS,EAAE,WAAW;IACtB,IAAI,EAAE,MAAM;IACZ,QAAQ,EAAE,WAAW;IACrB,MAAM,EAAE,QAAQ;IAChB,QAAQ,EAAE,UAAU;CACZ,CAAC;AAEE,QAAA,iBAAiB,GAAG,MAAM,CAAC,MAAM,CAAC,wBAAgB,CAAC,CAAC;AAEjE,mFAAmF;AACtE,QAAA,iBAAiB,GAAG;IAC/B,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,MAAM;CACJ,CAAC"}

package/dist/talkpilot/calls/calls.types.d.ts

@@ -1,10 +1,10 @@
 import { ObjectId, Sort, WithId } from "mongodb";
 import { TranscriptionSegment } from "../results";
 import { LeadProperty } from "../leads";
-import { CallStatusValues, CONFERENCE_ROLE_CUSTOMER, CONFERENCE_ROLE_SUPERVISOR } from "./calls.constants";
+import { CallEndedByValues, CallStatusValues, CONFERENCE_ROLE_CUSTOMER, CONFERENCE_ROLE_SUPERVISOR } from "./calls.constants";
 export type ConferenceRole = typeof CONFERENCE_ROLE_CUSTOMER | typeof CONFERENCE_ROLE_SUPERVISOR | null;
 export type CallStatus = (typeof CallStatusValues)[keyof typeof CallStatusValues];
-export type CallEndedBy = "system" | "resident";
+export type CallEndedBy = (typeof CallEndedByValues)[keyof typeof CallEndedByValues];
 export type Call = {
     callSid: string;
     flowId: ObjectId;

package/dist/talkpilot/calls/calls.types.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@talkpilot/core-db",
-  "version": "1.3.70",
+  "version": "1.3.72",
   "description": "Core database package for centralized connections and ORM integration.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/municipal/muniIssues/__tests__/muniIssues.getters.spec.ts

@@ -0,0 +1,60 @@
+import { createMuniIssue, setMuniIssueResponse } from "../muniIssues.setters";
+import {
+  countMuniIssuesByClient,
+  findMuniIssuesByClient,
+  generateMuniIssueId,
+  getMuniIssueByIdForClient,
+  getMuniIssuesCollection,
+} from "../muniIssues.getters";
+import { createMuniIssueInput } from "../../../test-utils/factories";
+
+const CLIENT = "client-a";
+
+const createIssue = async (clientId = CLIENT) =>
+  (await createMuniIssue(createMuniIssueInput({ clientId }), generateMuniIssueId())).toString();
+
+describe("muniIssues getters (complaint tracking)", () => {
+  describe("findMuniIssuesByClient / countMuniIssuesByClient", () => {
+    it("should return only the client's tracked issues, newest first", async () => {
+      const older = await createIssue();
+      const newer = await createIssue();
+      await createIssue("client-b");
+      // An issue created before complaint tracking has no status.
+      await getMuniIssuesCollection().insertOne({
+        ...createMuniIssueInput({ clientId: CLIENT }),
+        _id: generateMuniIssueId(),
+        jira: { key: "CP-legacy", syncStatus: "created" },
+        createdAt: new Date(),
+      });
+
+      const issues = await findMuniIssuesByClient(CLIENT);
+
+      expect(issues.map((i) => i._id.toString())).toEqual([newer, older]);
+      expect(await countMuniIssuesByClient(CLIENT)).toBe(2);
+    });
+
+    it("should filter by answered and apply skip/limit", async () => {
+      const answered = await createIssue();
+      await createIssue();
+      await createIssue();
+      await setMuniIssueResponse(answered, CLIENT, { status: "resolved", text: "Done" });
+
+      expect(await countMuniIssuesByClient(CLIENT, { answered: true })).toBe(1);
+      expect(await countMuniIssuesByClient(CLIENT, { answered: false })).toBe(2);
+      expect(
+        (await findMuniIssuesByClient(CLIENT, { answered: true }))[0]._id.toString(),
+      ).toBe(answered);
+      expect(await findMuniIssuesByClient(CLIENT, { skip: 1, limit: 1 })).toHaveLength(1);
+    });
+  });
+
+  describe("getMuniIssueByIdForClient", () => {
+    it("should return the issue only for its own client", async () => {
+      const id = await createIssue();
+
+      expect((await getMuniIssueByIdForClient(id, CLIENT))?._id.toString()).toBe(id);
+      expect(await getMuniIssueByIdForClient(id, "client-b")).toBeNull();
+      expect(await getMuniIssueByIdForClient("not-a-valid-id", CLIENT)).toBeNull();
+    });
+  });
+});

package/src/municipal/muniIssues/__tests__/muniIssues.setters.spec.ts

@@ -1,4 +1,8 @@
-import { createMuniIssue } from "../muniIssues.setters";
+import {
+  createMuniIssue,
+  setMuniIssueResponse,
+  updateMuniIssueStatus,
+} from "../muniIssues.setters";
 import {
   generateMuniIssueId,
   getMuniIssueById,
@@ -25,6 +29,18 @@ describe("muniIssues setters", () => {
       expect(saved?.createdAt).toBeInstanceOf(Date);
     });
 
+    it("should start the issue as in_review with updatedAt and no response", async () => {
+      const insertedId = await createMuniIssue(
+        createMuniIssueInput(),
+        generateMuniIssueId(),
+      );
+
+      const saved = await getMuniIssueById(insertedId.toString());
+      expect(saved?.status).toBe("in_review");
+      expect(saved?.updatedAt).toBeInstanceOf(Date);
+      expect(saved?.response).toBeUndefined();
+    });
+
     it("should default jira.syncStatus to created when not provided", async () => {
       const id = generateMuniIssueId();
 
@@ -91,4 +107,61 @@ describe("muniIssues setters", () => {
       expect(await getMuniIssueByJiraKey("CP-nope")).toBeNull();
     });
   });
+
+  describe("updateMuniIssueStatus", () => {
+    it("should change the status of an unanswered issue", async () => {
+      const input = createMuniIssueInput();
+      const id = (await createMuniIssue(input, generateMuniIssueId())).toString();
+
+      expect(await updateMuniIssueStatus(id, input.clientId, "in_progress")).toBe(true);
+      expect((await getMuniIssueById(id))?.status).toBe("in_progress");
+    });
+
+    it("should not touch another client's issue or a malformed id", async () => {
+      const id = (
+        await createMuniIssue(createMuniIssueInput(), generateMuniIssueId())
+      ).toString();
+
+      expect(await updateMuniIssueStatus(id, "other-client", "resolved")).toBe(false);
+      expect(await updateMuniIssueStatus("not-a-valid-id", "any", "resolved")).toBe(false);
+      expect((await getMuniIssueById(id))?.status).toBe("in_review");
+    });
+  });
+
+  describe("setMuniIssueResponse", () => {
+    it("should save the response and status", async () => {
+      const input = createMuniIssueInput();
+      const id = (await createMuniIssue(input, generateMuniIssueId())).toString();
+
+      const saved = await setMuniIssueResponse(id, input.clientId, {
+        status: "resolved",
+        text: "Fixed",
+        imageUrl: "https://example.com/a.png",
+      });
+
+      expect(saved).toBe(true);
+      const issue = await getMuniIssueById(id);
+      expect(issue?.status).toBe("resolved");
+      expect(issue?.response).toMatchObject({
+        text: "Fixed",
+        imageUrl: "https://example.com/a.png",
+      });
+      expect(issue?.response?.createdAt).toBeInstanceOf(Date);
+    });
+
+    it("should lock the issue: no second response and no status change", async () => {
+      const input = createMuniIssueInput();
+      const id = (await createMuniIssue(input, generateMuniIssueId())).toString();
+      await setMuniIssueResponse(id, input.clientId, { status: "resolved", text: "First" });
+
+      expect(
+        await setMuniIssueResponse(id, input.clientId, { status: "in_progress", text: "Second" }),
+      ).toBe(false);
+      expect(await updateMuniIssueStatus(id, input.clientId, "in_progress")).toBe(false);
+
+      const issue = await getMuniIssueById(id);
+      expect(issue?.status).toBe("resolved");
+      expect(issue?.response?.text).toBe("First");
+    });
+  });
 });

package/src/municipal/muniIssues/__tests__/muniIssues.setup.spec.ts

@@ -28,6 +28,7 @@ describe("muniIssues setup", () => {
         expect.arrayContaining([
           "callSid_1",
           "createdAt_-1",
+          "clientId_1_createdAt_-1",
           "jira_key_unique",
         ]),
       );

package/src/municipal/muniIssues/index.ts

@@ -3,6 +3,7 @@ export * from "./muniIssues.setters";
 export * from "./muniIssues.setup";
 export {
   MUNI_ISSUES_COLLECTION,
+  MUNI_ISSUE_STATUSES,
   MUNI_ISSUE_SYNC_STATUSES,
   MUNI_ISSUE_TEXT_MAX_LENGTH,
   MUNI_ISSUE_NAME_MAX_LENGTH,
@@ -13,5 +14,9 @@ export type {
   MuniIssueContent,
   MuniIssueJira,
   MuniIssueSyncStatus,
+  MuniIssueStatus,
+  MuniIssueResponse,
   CreateMuniIssueInput,
+  SetMuniIssueResponseInput,
+  FindMuniIssuesOptions,
 } from "./muniIssues.types";

package/src/municipal/muniIssues/muniIssues.constants.ts

@@ -4,6 +4,14 @@ export const MUNI_ISSUES_COLLECTION = "muniIssues";
 /** Sync state of the issue's Jira ticket at write time. */
 export const MUNI_ISSUE_SYNC_STATUSES = ["created", "failed"] as const;
 
+/** Customer-facing complaint status, set manually by the TalkPilot team. */
+export const MUNI_ISSUE_STATUSES = [
+  "in_review",
+  "in_progress",
+  "resolved",
+  "no_issue_found",
+] as const;
+
 /** Max length for the long free-text fields — well above the ~2000-char target. */
 export const MUNI_ISSUE_TEXT_MAX_LENGTH = 5000;
 

package/src/municipal/muniIssues/muniIssues.getters.ts

@@ -1,6 +1,6 @@
-import { Collection, ObjectId } from "mongodb";
+import { Collection, Filter, ObjectId } from "mongodb";
 import { getDb } from "../index";
-import { MuniIssue } from "./muniIssues.types";
+import { FindMuniIssuesOptions, MuniIssue } from "./muniIssues.types";
 import { MUNI_ISSUES_COLLECTION } from "./muniIssues.constants";
 
 export const getMuniIssuesCollection = (): Collection<MuniIssue> => {
@@ -22,3 +22,47 @@ export const getMuniIssueByJiraKey = async (
 ): Promise<MuniIssue | null> => {
   return getMuniIssuesCollection().findOne({ "jira.key": jiraKey });
 };
+
+// Tracked issues of one client. Issues without a status predate complaint tracking and are excluded.
+const clientIssuesFilter = (
+  clientId: string,
+  answered?: boolean,
+): Filter<MuniIssue> => ({
+  clientId,
+  status: { $exists: true },
+  ...(answered !== undefined && { response: { $exists: answered } }),
+});
+
+/** A client's tracked issues, newest first. */
+export const findMuniIssuesByClient = async (
+  clientId: string,
+  { answered, skip = 0, limit = 0 }: FindMuniIssuesOptions = {},
+): Promise<MuniIssue[]> => {
+  return getMuniIssuesCollection()
+    .find(clientIssuesFilter(clientId, answered))
+    .sort({ createdAt: -1 })
+    .skip(skip)
+    .limit(limit)
+    .toArray();
+};
+
+export const countMuniIssuesByClient = async (
+  clientId: string,
+  { answered }: Pick<FindMuniIssuesOptions, "answered"> = {},
+): Promise<number> => {
+  return getMuniIssuesCollection().countDocuments(
+    clientIssuesFilter(clientId, answered),
+  );
+};
+
+/** One tracked issue, only if it belongs to the client. */
+export const getMuniIssueByIdForClient = async (
+  id: string,
+  clientId: string,
+): Promise<MuniIssue | null> => {
+  if (!ObjectId.isValid(id)) return null;
+  return getMuniIssuesCollection().findOne({
+    ...clientIssuesFilter(clientId),
+    _id: new ObjectId(id),
+  });
+};

package/src/municipal/muniIssues/muniIssues.schema.ts

@@ -1,5 +1,6 @@
 import type { Document, IndexDescription } from "mongodb";
 import {
+  MUNI_ISSUE_STATUSES,
   MUNI_ISSUE_SYNC_STATUSES,
   MUNI_ISSUE_TEXT_MAX_LENGTH,
   MUNI_ISSUE_NAME_MAX_LENGTH,
@@ -55,12 +56,25 @@ export const muniIssuesJsonSchema: Document = {
       },
     },
     createdAt: { bsonType: "date" },
+    status: { enum: [...MUNI_ISSUE_STATUSES] },
+    response: {
+      bsonType: "object",
+      required: ["text", "createdAt"],
+      properties: {
+        text: { bsonType: "string", maxLength: MUNI_ISSUE_TEXT_MAX_LENGTH },
+        imageUrl: { bsonType: "string" },
+        createdAt: { bsonType: "date" },
+      },
+    },
+    updatedAt: { bsonType: "date" },
   },
 };
 
 export const muniIssuesIndexes: IndexDescription[] = [
   { key: { callSid: 1 }, name: "callSid_1" },
   { key: { createdAt: -1 }, name: "createdAt_-1" },
+  // Complaint list: one municipality's issues, newest first.
+  { key: { clientId: 1, createdAt: -1 }, name: "clientId_1_createdAt_-1" },
   // Unique: one stored document per Jira ticket, guarding against duplicate writes.
   { key: { "jira.key": 1 }, name: "jira_key_unique", unique: true },
 ];

package/src/municipal/muniIssues/muniIssues.setters.ts

@@ -1,5 +1,10 @@
-import { ObjectId } from "mongodb";
-import { CreateMuniIssueInput, MuniIssue } from "./muniIssues.types";
+import { Filter, ObjectId } from "mongodb";
+import {
+  CreateMuniIssueInput,
+  MuniIssue,
+  MuniIssueStatus,
+  SetMuniIssueResponseInput,
+} from "./muniIssues.types";
 import { getMuniIssuesCollection } from "./muniIssues.getters";
 import { ensureMuniIssuesCollectionOnce } from "./muniIssues.setup";
 
@@ -10,6 +15,7 @@ export const createMuniIssue = async (
 ): Promise<ObjectId> => {
   await ensureMuniIssuesCollectionOnce();
 
+  const now = new Date();
   const issue: MuniIssue = {
     _id: id,
     ...issueData,
@@ -17,8 +23,58 @@ export const createMuniIssue = async (
       ...issueData.jira,
       syncStatus: issueData.jira.syncStatus ?? "created",
     },
-    createdAt: new Date(),
+    status: "in_review",
+    createdAt: now,
+    updatedAt: now,
   };
   const { insertedId } = await getMuniIssuesCollection().insertOne(issue);
   return insertedId;
 };
+
+// An issue of this client that is tracked (has a status) and not yet answered.
+// The `response` condition is the lock: once answered, no further writes match.
+const openIssueFilter = (id: string, clientId: string): Filter<MuniIssue> => ({
+  _id: new ObjectId(id),
+  clientId,
+  status: { $exists: true },
+  response: { $exists: false },
+});
+
+/** Changes the status of an unanswered issue. Returns false if none matched. */
+export const updateMuniIssueStatus = async (
+  id: string,
+  clientId: string,
+  status: MuniIssueStatus,
+): Promise<boolean> => {
+  if (!ObjectId.isValid(id)) return false;
+  await ensureMuniIssuesCollectionOnce();
+
+  const { matchedCount } = await getMuniIssuesCollection().updateOne(
+    openIssueFilter(id, clientId),
+    { $set: { status, updatedAt: new Date() } },
+  );
+  return matchedCount > 0;
+};
+
+/** Saves the single TalkPilot response, which locks the issue. Returns false if none matched. */
+export const setMuniIssueResponse = async (
+  id: string,
+  clientId: string,
+  { status, text, imageUrl }: SetMuniIssueResponseInput,
+): Promise<boolean> => {
+  if (!ObjectId.isValid(id)) return false;
+  await ensureMuniIssuesCollectionOnce();
+
+  const now = new Date();
+  const { matchedCount } = await getMuniIssuesCollection().updateOne(
+    openIssueFilter(id, clientId),
+    {
+      $set: {
+        status,
+        response: { text, ...(imageUrl && { imageUrl }), createdAt: now },
+        updatedAt: now,
+      },
+    },
+  );
+  return matchedCount > 0;
+};

package/src/municipal/muniIssues/muniIssues.types.ts

@@ -1,10 +1,22 @@
 import { ObjectId } from "mongodb";
 
 import { CityName } from "../utils/types";
-import { MUNI_ISSUE_SYNC_STATUSES } from "./muniIssues.constants";
+import {
+  MUNI_ISSUE_STATUSES,
+  MUNI_ISSUE_SYNC_STATUSES,
+} from "./muniIssues.constants";
 
 export type MuniIssueSyncStatus = (typeof MUNI_ISSUE_SYNC_STATUSES)[number];
 
+export type MuniIssueStatus = (typeof MUNI_ISSUE_STATUSES)[number];
+
+/** The single TalkPilot response; once set, the complaint is locked. */
+export type MuniIssueResponse = {
+  text: string;
+  imageUrl?: string;
+  createdAt: Date;
+};
+
 export type MuniIssueContent = {
   issuerName: string;
   issuerRole: string;
@@ -25,13 +37,31 @@ export type MuniIssue = {
   issueContent: MuniIssueContent;
   jira: MuniIssueJira;
   createdAt: Date;
+  // Complaint tracking (CP-1888). Optional: issues created before it have none
+  // of these, which is how they are kept out of tracking.
+  status?: MuniIssueStatus;
+  response?: MuniIssueResponse;
+  updatedAt?: Date;
 };
 
-// _id/createdAt are set on insert; jira.syncStatus defaults to "created"
-// because the issue is only stored after its Jira ticket exists (CP-1115).
+// _id/createdAt/status/updatedAt are set on insert; jira.syncStatus defaults to
+// "created" because the issue is only stored after its Jira ticket exists (CP-1115).
 export type CreateMuniIssueInput = Omit<
   MuniIssue,
-  "_id" | "createdAt" | "jira"
+  "_id" | "createdAt" | "jira" | "status" | "response" | "updatedAt"
 > & {
   jira: { key: string; syncStatus?: MuniIssueSyncStatus };
 };
+
+export type SetMuniIssueResponseInput = {
+  status: MuniIssueStatus;
+  text: string;
+  imageUrl?: string;
+};
+
+/** `answered` filters by whether a TalkPilot response exists; omit it for all issues. */
+export type FindMuniIssuesOptions = {
+  answered?: boolean;
+  skip?: number;
+  limit?: number;
+};

package/src/talkpilot/calls/__tests__/calls.spec.ts

@@ -80,11 +80,11 @@ describe("db.calls", () => {
       const call = createOutGoingCallDoc();
       await createCallDoc(call);
 
-      const written = await setCallEndedBy(call.callSid, "resident");
+      const written = await setCallEndedBy(call.callSid, "user");
 
       expect(written).toBe(true);
       expect(await getCallByCallSid(call.callSid)).toMatchObject({
-        endedBy: "resident",
+        endedBy: "user",
       });
     });
 
@@ -92,12 +92,12 @@ describe("db.calls", () => {
       const call = createOutGoingCallDoc();
       await createCallDoc(call);
 
-      await setCallEndedBy(call.callSid, "resident");
-      const written = await setCallEndedBy(call.callSid, "system");
+      await setCallEndedBy(call.callSid, "user");
+      const written = await setCallEndedBy(call.callSid, "agent");
 
       expect(written).toBe(false);
       expect(await getCallByCallSid(call.callSid)).toMatchObject({
-        endedBy: "resident",
+        endedBy: "user",
       });
     });
 
@@ -106,13 +106,13 @@ describe("db.calls", () => {
       await createCallDoc(call);
 
       const results = await Promise.all([
-        setCallEndedBy(call.callSid, "resident"),
+        setCallEndedBy(call.callSid, "user"),
         setCallEndedBy(call.callSid, "system"),
       ]);
 
       expect(results.filter(Boolean)).toHaveLength(1);
       const stored = await getCallByCallSid(call.callSid);
-      expect(stored?.endedBy).toBe(results[0] ? "resident" : "system");
+      expect(stored?.endedBy).toBe(results[0] ? "user" : "system");
     });
 
     it("should return false when the call does not exist", async () => {

package/src/talkpilot/calls/calls.constants.ts

@@ -47,3 +47,10 @@ export const CallStatusValues = {
 } as const;
 
 export const ALL_CALL_STATUSES = Object.values(CallStatusValues);
+
+/** Who ended a connected call: our platform, the bot (end flow), or the caller. */
+export const CallEndedByValues = {
+  System: "system",
+  Agent: "agent",
+  User: "user",
+} as const;

package/src/talkpilot/calls/calls.types.ts

@@ -3,6 +3,7 @@ import { TranscriptionSegment } from "../results";
 import { LeadProperty } from "../leads";
 
 import {
+  CallEndedByValues,
   CallStatusValues,
   CONFERENCE_ROLE_CUSTOMER,
   CONFERENCE_ROLE_SUPERVISOR,
@@ -15,7 +16,7 @@ export type ConferenceRole =
 
 export type CallStatus = (typeof CallStatusValues)[keyof typeof CallStatusValues];
 
-export type CallEndedBy = "system" | "resident";
+export type CallEndedBy = (typeof CallEndedByValues)[keyof typeof CallEndedByValues];
 
 export type Call = {
   callSid: string;