@singi-labs/sifa-sdk 0.19.79 → 0.19.81

package/dist/index.cjs

@@ -7313,7 +7313,7 @@ function describeSifaRecord(collection, value) {
 }
 
 // src/index.ts
-var SIFA_SDK_VERSION = "0.19.79";
+var SIFA_SDK_VERSION = "0.19.81";
 
 exports.ACTIVITY_TIERS = ACTIVITY_TIERS;
 exports.ACTIVITY_VERBS = ACTIVITY_VERBS;

package/dist/index.js

@@ -370,7 +370,7 @@ import {
   roadmapIssueUrl
 } from "./roadmap/index.js";
 import { SIFA_REPO_GROUPS, describeSifaRecord, repoGroupForCollection } from "./repo/index.js";
-var SIFA_SDK_VERSION = "0.19.79";
+var SIFA_SDK_VERSION = "0.19.81";
 export {
   ACTIVITY_TIERS,
   ACTIVITY_VERBS,

package/dist/jev/error.cjs

@@ -0,0 +1,96 @@
+'use strict';
+
+// src/jev/error.ts
+var DID_RE = /did:(?:plc|web):[A-Za-z0-9._:%-]+/g;
+var EMAIL_RE = /[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}/g;
+var HANDLE_RE = /@[A-Za-z0-9-]+(?:\.[A-Za-z0-9-]+)+/g;
+var PROFILE_PATH_RE = /(\/(?:p|profile)\/)[^/\s?#]+/g;
+var AT_URI_RE = /at:\/\/[^\s/]+/g;
+function scrubErrorText(text) {
+  return text.replace(AT_URI_RE, "at://<id>").replace(DID_RE, "<did>").replace(EMAIL_RE, "<email>").replace(HANDLE_RE, "<handle>").replace(PROFILE_PATH_RE, "$1<handle>");
+}
+var ERROR_MAX_FRAMES = 8;
+var ISSUE_CANDIDATE_BODY_MAX_CHARS = 2e3;
+function frameState(frames) {
+  const inApp = frames.filter((f) => f.inApp !== false);
+  const chosen = (inApp.length > 0 ? inApp : frames).slice(0, ERROR_MAX_FRAMES);
+  const out = chosen.map((f) => {
+    const s = {};
+    if (f.filename) s.filename = scrubErrorText(f.filename);
+    if (f.function) s.function = scrubErrorText(f.function);
+    if (typeof f.lineNo === "number") s.lineNo = f.lineNo;
+    return s;
+  });
+  return out.length > 0 ? out : void 0;
+}
+function buildErrorReportState(report) {
+  const state = { title: scrubErrorText(report.title.trim()) };
+  if (report.culprit) state.culprit = scrubErrorText(report.culprit);
+  if (report.level) state.level = report.level;
+  if (report.type) state.type = scrubErrorText(report.type);
+  if (report.value) state.value = scrubErrorText(report.value.trim());
+  if (report.release) state.release = report.release;
+  const frames = report.frames ? frameState(report.frames) : void 0;
+  if (frames) state.frames = frames;
+  return state;
+}
+function buildIssueCandidateState(issue) {
+  const state = {
+    number: issue.number,
+    title: scrubErrorText(issue.title.trim())
+  };
+  const body = issue.body?.trim();
+  if (body) state.body = scrubErrorText(body.slice(0, ISSUE_CANDIDATE_BODY_MAX_CHARS));
+  return state;
+}
+function buildErrorIssuePairState(report, issue) {
+  return { error: buildErrorReportState(report), issue: buildIssueCandidateState(issue) };
+}
+var ERROR_SAME_BUG_NOUL_QUESTION = {
+  type: "noul",
+  instructions: "The state holds an error report (title, culprit, exception, top stack frames) and an existing GitHub issue. Does the issue describe the same underlying bug as the error report?",
+  criteria: {
+    true: "Same root cause: the same exception at the same code path, or the issue text names the same failure even if line numbers or messages differ slightly.",
+    false: "A different bug: different exception type or code path, a different feature, or an issue that only shares generic words (error, 500, profile) with the report."
+  }
+};
+var SAME_BUG_THRESHOLD = 0.85;
+function isLikelySameBug(noul, threshold = SAME_BUG_THRESHOLD) {
+  return noul >= threshold;
+}
+function buildSameBugQuestions(candidates) {
+  const out = {};
+  for (const c of candidates) {
+    out[`sameBug:${c.number}`] = {
+      type: "noul",
+      instructions: `${ERROR_SAME_BUG_NOUL_QUESTION.instructions} Judge the candidate issue with number ${c.number} in state.candidates.`,
+      ...ERROR_SAME_BUG_NOUL_QUESTION.criteria ? { criteria: ERROR_SAME_BUG_NOUL_QUESTION.criteria } : {}
+    };
+  }
+  return out;
+}
+function buildErrorCandidatesState(report, candidates) {
+  return {
+    error: buildErrorReportState(report),
+    candidates: candidates.map(buildIssueCandidateState)
+  };
+}
+function issueNumberFromSameBugKey(key) {
+  const m = /^sameBug:(\d+)$/.exec(key);
+  return m ? Number(m[1]) : null;
+}
+
+exports.ERROR_MAX_FRAMES = ERROR_MAX_FRAMES;
+exports.ERROR_SAME_BUG_NOUL_QUESTION = ERROR_SAME_BUG_NOUL_QUESTION;
+exports.ISSUE_CANDIDATE_BODY_MAX_CHARS = ISSUE_CANDIDATE_BODY_MAX_CHARS;
+exports.SAME_BUG_THRESHOLD = SAME_BUG_THRESHOLD;
+exports.buildErrorCandidatesState = buildErrorCandidatesState;
+exports.buildErrorIssuePairState = buildErrorIssuePairState;
+exports.buildErrorReportState = buildErrorReportState;
+exports.buildIssueCandidateState = buildIssueCandidateState;
+exports.buildSameBugQuestions = buildSameBugQuestions;
+exports.isLikelySameBug = isLikelySameBug;
+exports.issueNumberFromSameBugKey = issueNumberFromSameBugKey;
+exports.scrubErrorText = scrubErrorText;
+//# sourceMappingURL=error.cjs.map
+//# sourceMappingURL=error.cjs.map

package/dist/jev/error.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/jev/error.ts"],"names":[],"mappings":"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","file":"error.cjs","sourcesContent":["/**\n * Error-report judgments for the GlitchTip relay (sifa-workspace decision\n * 2026-10-05, background agents tier policy, Phase 2). Pure builders: the\n * state for \"is this error event the same bug as an existing issue?\", the\n * Noul question, the threshold, and the scrubber that removes identifiers\n * before anything leaves the server. No network, no key.\n *\n * Privacy: GlitchTip frames and messages can embed handles, DIDs, emails and\n * URLs with user paths. {@link scrubErrorText} runs over every string placed\n * in the state; callers must not bypass it.\n */\n\nimport type { NoulQuestion } from './index.js';\n\n// ---------------------------------------------------------------------------\n// Scrubbing\n// ---------------------------------------------------------------------------\n\nconst DID_RE = /did:(?:plc|web):[A-Za-z0-9._:%-]+/g;\nconst EMAIL_RE = /[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\\.[A-Za-z]{2,}/g;\n/** `@handle.tld` mentions; a bare `@` inside code (decorators) has no dot-tld. */\nconst HANDLE_RE = /@[A-Za-z0-9-]+(?:\\.[A-Za-z0-9-]+)+/g;\n/** `/p/<handle>` and `/profile/<handle>` path segments on Sifa URLs. */\nconst PROFILE_PATH_RE = /(\\/(?:p|profile)\\/)[^/\\s?#]+/g;\n/** at:// URIs carry a DID or handle as authority. */\nconst AT_URI_RE = /at:\\/\\/[^\\s/]+/g;\n\n/** Replace identifiers with stable placeholders. Idempotent. */\nexport function scrubErrorText(text: string): string {\n  return text\n    .replace(AT_URI_RE, 'at://<id>')\n    .replace(DID_RE, '<did>')\n    .replace(EMAIL_RE, '<email>')\n    .replace(HANDLE_RE, '<handle>')\n    .replace(PROFILE_PATH_RE, '$1<handle>');\n}\n\n// ---------------------------------------------------------------------------\n// Input and state\n// ---------------------------------------------------------------------------\n\n/** One stack frame, already reduced to what a same-bug judgment needs. */\nexport interface ErrorFrameInput {\n  filename?: string;\n  function?: string;\n  lineNo?: number;\n  inApp?: boolean;\n}\n\n/** A GlitchTip issue (error group) as seen by the relay. */\nexport interface ErrorReportInput {\n  title: string;\n  culprit?: string;\n  level?: string;\n  /** Exception type, e.g. `TypeError`. */\n  type?: string;\n  /** Exception value / message. */\n  value?: string;\n  frames?: ErrorFrameInput[];\n  /** Release or deploy identifier, when GlitchTip has it. */\n  release?: string;\n}\n\n/** An existing GitHub issue candidate (title + body, labelled `glitchtip`). */\nexport interface IssueCandidateInput {\n  number: number;\n  title: string;\n  body?: string;\n}\n\n/** Keep the judgment cheap and bounded: top in-app frames only. */\nexport const ERROR_MAX_FRAMES = 8;\nexport const ISSUE_CANDIDATE_BODY_MAX_CHARS = 2000;\n\nexport interface ErrorReportState {\n  title: string;\n  culprit?: string;\n  level?: string;\n  type?: string;\n  value?: string;\n  release?: string;\n  frames?: Array<{ filename?: string; function?: string; lineNo?: number }>;\n}\n\nexport interface IssueCandidateState {\n  number: number;\n  title: string;\n  body?: string;\n}\n\nfunction frameState(frames: ErrorFrameInput[]): ErrorReportState['frames'] {\n  const inApp = frames.filter((f) => f.inApp !== false);\n  const chosen = (inApp.length > 0 ? inApp : frames).slice(0, ERROR_MAX_FRAMES);\n  const out = chosen.map((f) => {\n    const s: { filename?: string; function?: string; lineNo?: number } = {};\n    if (f.filename) s.filename = scrubErrorText(f.filename);\n    if (f.function) s.function = scrubErrorText(f.function);\n    if (typeof f.lineNo === 'number') s.lineNo = f.lineNo;\n    return s;\n  });\n  return out.length > 0 ? out : undefined;\n}\n\n/** Scrubbed, bounded state for the error side of the pair. */\nexport function buildErrorReportState(report: ErrorReportInput): ErrorReportState {\n  const state: ErrorReportState = { title: scrubErrorText(report.title.trim()) };\n  if (report.culprit) state.culprit = scrubErrorText(report.culprit);\n  if (report.level) state.level = report.level;\n  if (report.type) state.type = scrubErrorText(report.type);\n  if (report.value) state.value = scrubErrorText(report.value.trim());\n  if (report.release) state.release = report.release;\n  const frames = report.frames ? frameState(report.frames) : undefined;\n  if (frames) state.frames = frames;\n  return state;\n}\n\n/** Scrubbed, bounded state for the GitHub issue side of the pair. */\nexport function buildIssueCandidateState(issue: IssueCandidateInput): IssueCandidateState {\n  const state: IssueCandidateState = {\n    number: issue.number,\n    title: scrubErrorText(issue.title.trim()),\n  };\n  const body = issue.body?.trim();\n  if (body) state.body = scrubErrorText(body.slice(0, ISSUE_CANDIDATE_BODY_MAX_CHARS));\n  return state;\n}\n\n/** State for one error-vs-issue pair, both under stable named fields. */\nexport function buildErrorIssuePairState(\n  report: ErrorReportInput,\n  issue: IssueCandidateInput,\n): { error: ErrorReportState; issue: IssueCandidateState } {\n  return { error: buildErrorReportState(report), issue: buildIssueCandidateState(issue) };\n}\n\n// ---------------------------------------------------------------------------\n// Question and threshold\n// ---------------------------------------------------------------------------\n\n/** Static Noul question paired with {@link buildErrorIssuePairState}. */\nexport const ERROR_SAME_BUG_NOUL_QUESTION: NoulQuestion = {\n  type: 'noul',\n  instructions:\n    'The state holds an error report (title, culprit, exception, top stack frames) and an existing GitHub issue. Does the issue describe the same underlying bug as the error report?',\n  criteria: {\n    true: 'Same root cause: the same exception at the same code path, or the issue text names the same failure even if line numbers or messages differ slightly.',\n    false:\n      'A different bug: different exception type or code path, a different feature, or an issue that only shares generic words (error, 500, profile) with the report.',\n  },\n};\n\n/**\n * Precision over recall: a false \"same bug\" hides a new error behind an old\n * issue; a false \"new\" costs one duplicate issue a human closes. Validate on\n * labelled GlitchTip-event-to-issue pairs before widening.\n */\nexport const SAME_BUG_THRESHOLD = 0.85;\n\n/** True when the Noul probability clears the same-bug threshold. */\nexport function isLikelySameBug(noul: number, threshold: number = SAME_BUG_THRESHOLD): boolean {\n  return noul >= threshold;\n}\n\n/**\n * Question ids for a batched call over several candidates: one Noul per\n * candidate, keyed `sameBug:<issueNumber>`. Pair with one state holding\n * `error` plus `candidates[]`; each question names its candidate number.\n */\nexport function buildSameBugQuestions(\n  candidates: IssueCandidateInput[],\n): Record<string, NoulQuestion> {\n  const out: Record<string, NoulQuestion> = {};\n  for (const c of candidates) {\n    out[`sameBug:${c.number}`] = {\n      type: 'noul',\n      instructions: `${ERROR_SAME_BUG_NOUL_QUESTION.instructions} Judge the candidate issue with number ${c.number} in state.candidates.`,\n      ...(ERROR_SAME_BUG_NOUL_QUESTION.criteria\n        ? { criteria: ERROR_SAME_BUG_NOUL_QUESTION.criteria }\n        : {}),\n    };\n  }\n  return out;\n}\n\n/** State for the batched form: one error against several candidates. */\nexport function buildErrorCandidatesState(\n  report: ErrorReportInput,\n  candidates: IssueCandidateInput[],\n): { error: ErrorReportState; candidates: IssueCandidateState[] } {\n  return {\n    error: buildErrorReportState(report),\n    candidates: candidates.map(buildIssueCandidateState),\n  };\n}\n\n/** Parse `sameBug:<n>` back to the issue number, or null for a foreign key. */\nexport function issueNumberFromSameBugKey(key: string): number | null {\n  const m = /^sameBug:(\\d+)$/.exec(key);\n  return m ? Number(m[1]) : null;\n}\n"]}

package/dist/jev/error.d.cts

@@ -0,0 +1,98 @@
+import { NoulQuestion } from './index.cjs';
+import 'zod';
+
+/**
+ * Error-report judgments for the GlitchTip relay (sifa-workspace decision
+ * 2026-10-05, background agents tier policy, Phase 2). Pure builders: the
+ * state for "is this error event the same bug as an existing issue?", the
+ * Noul question, the threshold, and the scrubber that removes identifiers
+ * before anything leaves the server. No network, no key.
+ *
+ * Privacy: GlitchTip frames and messages can embed handles, DIDs, emails and
+ * URLs with user paths. {@link scrubErrorText} runs over every string placed
+ * in the state; callers must not bypass it.
+ */
+
+/** Replace identifiers with stable placeholders. Idempotent. */
+declare function scrubErrorText(text: string): string;
+/** One stack frame, already reduced to what a same-bug judgment needs. */
+interface ErrorFrameInput {
+    filename?: string;
+    function?: string;
+    lineNo?: number;
+    inApp?: boolean;
+}
+/** A GlitchTip issue (error group) as seen by the relay. */
+interface ErrorReportInput {
+    title: string;
+    culprit?: string;
+    level?: string;
+    /** Exception type, e.g. `TypeError`. */
+    type?: string;
+    /** Exception value / message. */
+    value?: string;
+    frames?: ErrorFrameInput[];
+    /** Release or deploy identifier, when GlitchTip has it. */
+    release?: string;
+}
+/** An existing GitHub issue candidate (title + body, labelled `glitchtip`). */
+interface IssueCandidateInput {
+    number: number;
+    title: string;
+    body?: string;
+}
+/** Keep the judgment cheap and bounded: top in-app frames only. */
+declare const ERROR_MAX_FRAMES = 8;
+declare const ISSUE_CANDIDATE_BODY_MAX_CHARS = 2000;
+interface ErrorReportState {
+    title: string;
+    culprit?: string;
+    level?: string;
+    type?: string;
+    value?: string;
+    release?: string;
+    frames?: Array<{
+        filename?: string;
+        function?: string;
+        lineNo?: number;
+    }>;
+}
+interface IssueCandidateState {
+    number: number;
+    title: string;
+    body?: string;
+}
+/** Scrubbed, bounded state for the error side of the pair. */
+declare function buildErrorReportState(report: ErrorReportInput): ErrorReportState;
+/** Scrubbed, bounded state for the GitHub issue side of the pair. */
+declare function buildIssueCandidateState(issue: IssueCandidateInput): IssueCandidateState;
+/** State for one error-vs-issue pair, both under stable named fields. */
+declare function buildErrorIssuePairState(report: ErrorReportInput, issue: IssueCandidateInput): {
+    error: ErrorReportState;
+    issue: IssueCandidateState;
+};
+/** Static Noul question paired with {@link buildErrorIssuePairState}. */
+declare const ERROR_SAME_BUG_NOUL_QUESTION: NoulQuestion;
+/**
+ * Precision over recall: a false "same bug" hides a new error behind an old
+ * issue; a false "new" costs one duplicate issue a human closes. Validate on
+ * labelled GlitchTip-event-to-issue pairs before widening.
+ */
+declare const SAME_BUG_THRESHOLD = 0.85;
+/** True when the Noul probability clears the same-bug threshold. */
+declare function isLikelySameBug(noul: number, threshold?: number): boolean;
+/**
+ * Question ids for a batched call over several candidates: one Noul per
+ * candidate, keyed `sameBug:<issueNumber>`. Pair with one state holding
+ * `error` plus `candidates[]`; each question names its candidate number.
+ */
+declare function buildSameBugQuestions(candidates: IssueCandidateInput[]): Record<string, NoulQuestion>;
+/** State for the batched form: one error against several candidates. */
+declare function buildErrorCandidatesState(report: ErrorReportInput, candidates: IssueCandidateInput[]): {
+    error: ErrorReportState;
+    candidates: IssueCandidateState[];
+};
+/** Parse `sameBug:<n>` back to the issue number, or null for a foreign key. */
+declare function issueNumberFromSameBugKey(key: string): number | null;
+
+export { ERROR_MAX_FRAMES, ERROR_SAME_BUG_NOUL_QUESTION, type ErrorFrameInput, type ErrorReportInput, type ErrorReportState, ISSUE_CANDIDATE_BODY_MAX_CHARS, type IssueCandidateInput, type IssueCandidateState, SAME_BUG_THRESHOLD, buildErrorCandidatesState, buildErrorIssuePairState, buildErrorReportState, buildIssueCandidateState, buildSameBugQuestions, isLikelySameBug, issueNumberFromSameBugKey, scrubErrorText };

package/dist/jev/error.d.ts

@@ -0,0 +1,98 @@
+import { NoulQuestion } from './index.js';
+import 'zod';
+
+/**
+ * Error-report judgments for the GlitchTip relay (sifa-workspace decision
+ * 2026-10-05, background agents tier policy, Phase 2). Pure builders: the
+ * state for "is this error event the same bug as an existing issue?", the
+ * Noul question, the threshold, and the scrubber that removes identifiers
+ * before anything leaves the server. No network, no key.
+ *
+ * Privacy: GlitchTip frames and messages can embed handles, DIDs, emails and
+ * URLs with user paths. {@link scrubErrorText} runs over every string placed
+ * in the state; callers must not bypass it.
+ */
+
+/** Replace identifiers with stable placeholders. Idempotent. */
+declare function scrubErrorText(text: string): string;
+/** One stack frame, already reduced to what a same-bug judgment needs. */
+interface ErrorFrameInput {
+    filename?: string;
+    function?: string;
+    lineNo?: number;
+    inApp?: boolean;
+}
+/** A GlitchTip issue (error group) as seen by the relay. */
+interface ErrorReportInput {
+    title: string;
+    culprit?: string;
+    level?: string;
+    /** Exception type, e.g. `TypeError`. */
+    type?: string;
+    /** Exception value / message. */
+    value?: string;
+    frames?: ErrorFrameInput[];
+    /** Release or deploy identifier, when GlitchTip has it. */
+    release?: string;
+}
+/** An existing GitHub issue candidate (title + body, labelled `glitchtip`). */
+interface IssueCandidateInput {
+    number: number;
+    title: string;
+    body?: string;
+}
+/** Keep the judgment cheap and bounded: top in-app frames only. */
+declare const ERROR_MAX_FRAMES = 8;
+declare const ISSUE_CANDIDATE_BODY_MAX_CHARS = 2000;
+interface ErrorReportState {
+    title: string;
+    culprit?: string;
+    level?: string;
+    type?: string;
+    value?: string;
+    release?: string;
+    frames?: Array<{
+        filename?: string;
+        function?: string;
+        lineNo?: number;
+    }>;
+}
+interface IssueCandidateState {
+    number: number;
+    title: string;
+    body?: string;
+}
+/** Scrubbed, bounded state for the error side of the pair. */
+declare function buildErrorReportState(report: ErrorReportInput): ErrorReportState;
+/** Scrubbed, bounded state for the GitHub issue side of the pair. */
+declare function buildIssueCandidateState(issue: IssueCandidateInput): IssueCandidateState;
+/** State for one error-vs-issue pair, both under stable named fields. */
+declare function buildErrorIssuePairState(report: ErrorReportInput, issue: IssueCandidateInput): {
+    error: ErrorReportState;
+    issue: IssueCandidateState;
+};
+/** Static Noul question paired with {@link buildErrorIssuePairState}. */
+declare const ERROR_SAME_BUG_NOUL_QUESTION: NoulQuestion;
+/**
+ * Precision over recall: a false "same bug" hides a new error behind an old
+ * issue; a false "new" costs one duplicate issue a human closes. Validate on
+ * labelled GlitchTip-event-to-issue pairs before widening.
+ */
+declare const SAME_BUG_THRESHOLD = 0.85;
+/** True when the Noul probability clears the same-bug threshold. */
+declare function isLikelySameBug(noul: number, threshold?: number): boolean;
+/**
+ * Question ids for a batched call over several candidates: one Noul per
+ * candidate, keyed `sameBug:<issueNumber>`. Pair with one state holding
+ * `error` plus `candidates[]`; each question names its candidate number.
+ */
+declare function buildSameBugQuestions(candidates: IssueCandidateInput[]): Record<string, NoulQuestion>;
+/** State for the batched form: one error against several candidates. */
+declare function buildErrorCandidatesState(report: ErrorReportInput, candidates: IssueCandidateInput[]): {
+    error: ErrorReportState;
+    candidates: IssueCandidateState[];
+};
+/** Parse `sameBug:<n>` back to the issue number, or null for a foreign key. */
+declare function issueNumberFromSameBugKey(key: string): number | null;
+
+export { ERROR_MAX_FRAMES, ERROR_SAME_BUG_NOUL_QUESTION, type ErrorFrameInput, type ErrorReportInput, type ErrorReportState, ISSUE_CANDIDATE_BODY_MAX_CHARS, type IssueCandidateInput, type IssueCandidateState, SAME_BUG_THRESHOLD, buildErrorCandidatesState, buildErrorIssuePairState, buildErrorReportState, buildIssueCandidateState, buildSameBugQuestions, isLikelySameBug, issueNumberFromSameBugKey, scrubErrorText };

package/dist/jev/error.js

@@ -0,0 +1,94 @@
+// src/jev/error.ts
+var DID_RE = /did:(?:plc|web):[A-Za-z0-9._:%-]+/g;
+var EMAIL_RE = /[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}/g;
+var HANDLE_RE = /@[A-Za-z0-9-]+(?:\.[A-Za-z0-9-]+)+/g;
+var PROFILE_PATH_RE = /(\/(?:p|profile)\/)[^/\s?#]+/g;
+var AT_URI_RE = /at:\/\/[^\s/]+/g;
+function scrubErrorText(text) {
+  return text.replace(AT_URI_RE, "at://<id>").replace(DID_RE, "<did>").replace(EMAIL_RE, "<email>").replace(HANDLE_RE, "<handle>").replace(PROFILE_PATH_RE, "$1<handle>");
+}
+var ERROR_MAX_FRAMES = 8;
+var ISSUE_CANDIDATE_BODY_MAX_CHARS = 2e3;
+function frameState(frames) {
+  const inApp = frames.filter((f) => f.inApp !== false);
+  const chosen = (inApp.length > 0 ? inApp : frames).slice(0, ERROR_MAX_FRAMES);
+  const out = chosen.map((f) => {
+    const s = {};
+    if (f.filename) s.filename = scrubErrorText(f.filename);
+    if (f.function) s.function = scrubErrorText(f.function);
+    if (typeof f.lineNo === "number") s.lineNo = f.lineNo;
+    return s;
+  });
+  return out.length > 0 ? out : void 0;
+}
+function buildErrorReportState(report) {
+  const state = { title: scrubErrorText(report.title.trim()) };
+  if (report.culprit) state.culprit = scrubErrorText(report.culprit);
+  if (report.level) state.level = report.level;
+  if (report.type) state.type = scrubErrorText(report.type);
+  if (report.value) state.value = scrubErrorText(report.value.trim());
+  if (report.release) state.release = report.release;
+  const frames = report.frames ? frameState(report.frames) : void 0;
+  if (frames) state.frames = frames;
+  return state;
+}
+function buildIssueCandidateState(issue) {
+  const state = {
+    number: issue.number,
+    title: scrubErrorText(issue.title.trim())
+  };
+  const body = issue.body?.trim();
+  if (body) state.body = scrubErrorText(body.slice(0, ISSUE_CANDIDATE_BODY_MAX_CHARS));
+  return state;
+}
+function buildErrorIssuePairState(report, issue) {
+  return { error: buildErrorReportState(report), issue: buildIssueCandidateState(issue) };
+}
+var ERROR_SAME_BUG_NOUL_QUESTION = {
+  type: "noul",
+  instructions: "The state holds an error report (title, culprit, exception, top stack frames) and an existing GitHub issue. Does the issue describe the same underlying bug as the error report?",
+  criteria: {
+    true: "Same root cause: the same exception at the same code path, or the issue text names the same failure even if line numbers or messages differ slightly.",
+    false: "A different bug: different exception type or code path, a different feature, or an issue that only shares generic words (error, 500, profile) with the report."
+  }
+};
+var SAME_BUG_THRESHOLD = 0.85;
+function isLikelySameBug(noul, threshold = SAME_BUG_THRESHOLD) {
+  return noul >= threshold;
+}
+function buildSameBugQuestions(candidates) {
+  const out = {};
+  for (const c of candidates) {
+    out[`sameBug:${c.number}`] = {
+      type: "noul",
+      instructions: `${ERROR_SAME_BUG_NOUL_QUESTION.instructions} Judge the candidate issue with number ${c.number} in state.candidates.`,
+      ...ERROR_SAME_BUG_NOUL_QUESTION.criteria ? { criteria: ERROR_SAME_BUG_NOUL_QUESTION.criteria } : {}
+    };
+  }
+  return out;
+}
+function buildErrorCandidatesState(report, candidates) {
+  return {
+    error: buildErrorReportState(report),
+    candidates: candidates.map(buildIssueCandidateState)
+  };
+}
+function issueNumberFromSameBugKey(key) {
+  const m = /^sameBug:(\d+)$/.exec(key);
+  return m ? Number(m[1]) : null;
+}
+export {
+  ERROR_MAX_FRAMES,
+  ERROR_SAME_BUG_NOUL_QUESTION,
+  ISSUE_CANDIDATE_BODY_MAX_CHARS,
+  SAME_BUG_THRESHOLD,
+  buildErrorCandidatesState,
+  buildErrorIssuePairState,
+  buildErrorReportState,
+  buildIssueCandidateState,
+  buildSameBugQuestions,
+  isLikelySameBug,
+  issueNumberFromSameBugKey,
+  scrubErrorText
+};
+//# sourceMappingURL=error.js.map

package/dist/jev/error.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/jev/error.ts"],"sourcesContent":["/**\n * Error-report judgments for the GlitchTip relay (sifa-workspace decision\n * 2026-10-05, background agents tier policy, Phase 2). Pure builders: the\n * state for \"is this error event the same bug as an existing issue?\", the\n * Noul question, the threshold, and the scrubber that removes identifiers\n * before anything leaves the server. No network, no key.\n *\n * Privacy: GlitchTip frames and messages can embed handles, DIDs, emails and\n * URLs with user paths. {@link scrubErrorText} runs over every string placed\n * in the state; callers must not bypass it.\n */\n\nimport type { NoulQuestion } from './index.js';\n\n// ---------------------------------------------------------------------------\n// Scrubbing\n// ---------------------------------------------------------------------------\n\nconst DID_RE = /did:(?:plc|web):[A-Za-z0-9._:%-]+/g;\nconst EMAIL_RE = /[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\\.[A-Za-z]{2,}/g;\n/** `@handle.tld` mentions; a bare `@` inside code (decorators) has no dot-tld. */\nconst HANDLE_RE = /@[A-Za-z0-9-]+(?:\\.[A-Za-z0-9-]+)+/g;\n/** `/p/<handle>` and `/profile/<handle>` path segments on Sifa URLs. */\nconst PROFILE_PATH_RE = /(\\/(?:p|profile)\\/)[^/\\s?#]+/g;\n/** at:// URIs carry a DID or handle as authority. */\nconst AT_URI_RE = /at:\\/\\/[^\\s/]+/g;\n\n/** Replace identifiers with stable placeholders. Idempotent. */\nexport function scrubErrorText(text: string): string {\n  return text\n    .replace(AT_URI_RE, 'at://<id>')\n    .replace(DID_RE, '<did>')\n    .replace(EMAIL_RE, '<email>')\n    .replace(HANDLE_RE, '<handle>')\n    .replace(PROFILE_PATH_RE, '$1<handle>');\n}\n\n// ---------------------------------------------------------------------------\n// Input and state\n// ---------------------------------------------------------------------------\n\n/** One stack frame, already reduced to what a same-bug judgment needs. */\nexport interface ErrorFrameInput {\n  filename?: string;\n  function?: string;\n  lineNo?: number;\n  inApp?: boolean;\n}\n\n/** A GlitchTip issue (error group) as seen by the relay. */\nexport interface ErrorReportInput {\n  title: string;\n  culprit?: string;\n  level?: string;\n  /** Exception type, e.g. `TypeError`. */\n  type?: string;\n  /** Exception value / message. */\n  value?: string;\n  frames?: ErrorFrameInput[];\n  /** Release or deploy identifier, when GlitchTip has it. */\n  release?: string;\n}\n\n/** An existing GitHub issue candidate (title + body, labelled `glitchtip`). */\nexport interface IssueCandidateInput {\n  number: number;\n  title: string;\n  body?: string;\n}\n\n/** Keep the judgment cheap and bounded: top in-app frames only. */\nexport const ERROR_MAX_FRAMES = 8;\nexport const ISSUE_CANDIDATE_BODY_MAX_CHARS = 2000;\n\nexport interface ErrorReportState {\n  title: string;\n  culprit?: string;\n  level?: string;\n  type?: string;\n  value?: string;\n  release?: string;\n  frames?: Array<{ filename?: string; function?: string; lineNo?: number }>;\n}\n\nexport interface IssueCandidateState {\n  number: number;\n  title: string;\n  body?: string;\n}\n\nfunction frameState(frames: ErrorFrameInput[]): ErrorReportState['frames'] {\n  const inApp = frames.filter((f) => f.inApp !== false);\n  const chosen = (inApp.length > 0 ? inApp : frames).slice(0, ERROR_MAX_FRAMES);\n  const out = chosen.map((f) => {\n    const s: { filename?: string; function?: string; lineNo?: number } = {};\n    if (f.filename) s.filename = scrubErrorText(f.filename);\n    if (f.function) s.function = scrubErrorText(f.function);\n    if (typeof f.lineNo === 'number') s.lineNo = f.lineNo;\n    return s;\n  });\n  return out.length > 0 ? out : undefined;\n}\n\n/** Scrubbed, bounded state for the error side of the pair. */\nexport function buildErrorReportState(report: ErrorReportInput): ErrorReportState {\n  const state: ErrorReportState = { title: scrubErrorText(report.title.trim()) };\n  if (report.culprit) state.culprit = scrubErrorText(report.culprit);\n  if (report.level) state.level = report.level;\n  if (report.type) state.type = scrubErrorText(report.type);\n  if (report.value) state.value = scrubErrorText(report.value.trim());\n  if (report.release) state.release = report.release;\n  const frames = report.frames ? frameState(report.frames) : undefined;\n  if (frames) state.frames = frames;\n  return state;\n}\n\n/** Scrubbed, bounded state for the GitHub issue side of the pair. */\nexport function buildIssueCandidateState(issue: IssueCandidateInput): IssueCandidateState {\n  const state: IssueCandidateState = {\n    number: issue.number,\n    title: scrubErrorText(issue.title.trim()),\n  };\n  const body = issue.body?.trim();\n  if (body) state.body = scrubErrorText(body.slice(0, ISSUE_CANDIDATE_BODY_MAX_CHARS));\n  return state;\n}\n\n/** State for one error-vs-issue pair, both under stable named fields. */\nexport function buildErrorIssuePairState(\n  report: ErrorReportInput,\n  issue: IssueCandidateInput,\n): { error: ErrorReportState; issue: IssueCandidateState } {\n  return { error: buildErrorReportState(report), issue: buildIssueCandidateState(issue) };\n}\n\n// ---------------------------------------------------------------------------\n// Question and threshold\n// ---------------------------------------------------------------------------\n\n/** Static Noul question paired with {@link buildErrorIssuePairState}. */\nexport const ERROR_SAME_BUG_NOUL_QUESTION: NoulQuestion = {\n  type: 'noul',\n  instructions:\n    'The state holds an error report (title, culprit, exception, top stack frames) and an existing GitHub issue. Does the issue describe the same underlying bug as the error report?',\n  criteria: {\n    true: 'Same root cause: the same exception at the same code path, or the issue text names the same failure even if line numbers or messages differ slightly.',\n    false:\n      'A different bug: different exception type or code path, a different feature, or an issue that only shares generic words (error, 500, profile) with the report.',\n  },\n};\n\n/**\n * Precision over recall: a false \"same bug\" hides a new error behind an old\n * issue; a false \"new\" costs one duplicate issue a human closes. Validate on\n * labelled GlitchTip-event-to-issue pairs before widening.\n */\nexport const SAME_BUG_THRESHOLD = 0.85;\n\n/** True when the Noul probability clears the same-bug threshold. */\nexport function isLikelySameBug(noul: number, threshold: number = SAME_BUG_THRESHOLD): boolean {\n  return noul >= threshold;\n}\n\n/**\n * Question ids for a batched call over several candidates: one Noul per\n * candidate, keyed `sameBug:<issueNumber>`. Pair with one state holding\n * `error` plus `candidates[]`; each question names its candidate number.\n */\nexport function buildSameBugQuestions(\n  candidates: IssueCandidateInput[],\n): Record<string, NoulQuestion> {\n  const out: Record<string, NoulQuestion> = {};\n  for (const c of candidates) {\n    out[`sameBug:${c.number}`] = {\n      type: 'noul',\n      instructions: `${ERROR_SAME_BUG_NOUL_QUESTION.instructions} Judge the candidate issue with number ${c.number} in state.candidates.`,\n      ...(ERROR_SAME_BUG_NOUL_QUESTION.criteria\n        ? { criteria: ERROR_SAME_BUG_NOUL_QUESTION.criteria }\n        : {}),\n    };\n  }\n  return out;\n}\n\n/** State for the batched form: one error against several candidates. */\nexport function buildErrorCandidatesState(\n  report: ErrorReportInput,\n  candidates: IssueCandidateInput[],\n): { error: ErrorReportState; candidates: IssueCandidateState[] } {\n  return {\n    error: buildErrorReportState(report),\n    candidates: candidates.map(buildIssueCandidateState),\n  };\n}\n\n/** Parse `sameBug:<n>` back to the issue number, or null for a foreign key. */\nexport function issueNumberFromSameBugKey(key: string): number | null {\n  const m = /^sameBug:(\\d+)$/.exec(key);\n  return m ? Number(m[1]) : null;\n}\n"],"mappings":"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","names":[]}

package/dist/jev/issue.cjs

@@ -0,0 +1,183 @@
+'use strict';
+
+var zod = require('zod');
+
+// src/jev/issue.ts
+var noulAnswerSchema = zod.z.object({
+  type: zod.z.literal("noul"),
+  noul: zod.z.number().min(0).max(1)
+});
+var choiceAnswerSchema = zod.z.object({
+  type: zod.z.literal("choice"),
+  choice: zod.z.string(),
+  confidence: zod.z.number().min(0).max(1),
+  probabilities: zod.z.record(zod.z.string(), zod.z.number())
+});
+var FIRMOGRAPHIC_CONFIDENCE_FLOOR = 0.6;
+function pickChoiceAboveFloor(answer, opts = {}) {
+  const floor = opts.floor ?? FIRMOGRAPHIC_CONFIDENCE_FLOOR;
+  if (answer.confidence < floor) return null;
+  if (opts.noMatch !== void 0 && answer.choice === opts.noMatch) return null;
+  return answer.choice;
+}
+
+// src/jev/issue.ts
+var ISSUE_BODY_MAX_CHARS = 6e3;
+function buildIssueTriageState(issue) {
+  const state = { repo: issue.repo, title: issue.title.trim() };
+  const body = issue.body?.trim();
+  if (body) {
+    if (body.length > ISSUE_BODY_MAX_CHARS) {
+      state.body = body.slice(0, ISSUE_BODY_MAX_CHARS);
+      state.bodyTruncated = true;
+    } else {
+      state.body = body;
+    }
+  }
+  if (issue.existingLabels && issue.existingLabels.length > 0) {
+    state.existingLabels = issue.existingLabels;
+  }
+  return state;
+}
+var ISSUE_TYPE_TAXONOMY = {
+  bug: "Something that exists does not behave as documented or expected (error, crash, wrong output)",
+  feature: "A request for new behaviour or capability that does not exist yet",
+  question: "A question about how something works, with nothing to build or fix",
+  documentation: "Docs, README, comments, or examples are missing, wrong, or unclear",
+  "tech-debt": "Internal refactor, cleanup, dependency, or tooling work with no user-visible change",
+  spam: "Spam, gibberish, advertising, or a test submission",
+  unclear: "Not enough information to decide the type"
+};
+var ISSUE_STREAM_TAXONOMY = {
+  sifa: "The Sifa profile, activity stream, ingestion, search, or web app",
+  kootana: "Kootana: events, meetings, in-person connect, QR scan, organizer tools",
+  unclear: "Cannot tell from the issue"
+};
+var ISSUE_STREAM_LABELS = {
+  sifa: null,
+  kootana: "stream:kootana",
+  unclear: null
+};
+function choiceQuestion2(instructions, criteria) {
+  return { type: "choice", instructions, criteria };
+}
+var ISSUE_TYPE_CHOICE_QUESTION = choiceQuestion2(
+  "The state holds one GitHub issue (repo, title, body, existing labels). Which single type best describes it?",
+  ISSUE_TYPE_TAXONOMY
+);
+var ISSUE_STREAM_CHOICE_QUESTION = choiceQuestion2(
+  "Which product stream does this issue concern?",
+  ISSUE_STREAM_TAXONOMY
+);
+var ISSUE_ACTIONABLE_NOUL_QUESTION = {
+  type: "noul",
+  instructions: "Does the issue contain enough information for a maintainer to act on it without asking the reporter anything?",
+  criteria: {
+    true: "For a bug: steps or a trigger, expected vs actual, and an error or location. For a feature: the problem, the desired outcome, and rough scope.",
+    false: "Essential details are missing: no way to reproduce, no expected behaviour, vague wish with no outcome, or a bare title."
+  }
+};
+var ISSUE_SECURITY_NOUL_QUESTION = {
+  type: "noul",
+  instructions: "Does the issue describe a security-relevant problem?",
+  criteria: {
+    true: "A vulnerability, auth or session flaw, data exposure, abuse or spam vector, secrets handling, or a dependency advisory.",
+    false: "An ordinary bug, feature, question, or docs issue with no security angle."
+  }
+};
+var ISSUE_REGRESSION_NOUL_QUESTION = {
+  type: "noul",
+  instructions: "Does the issue report that something which previously worked no longer works?",
+  criteria: {
+    true: "The reporter states or clearly implies the behaviour worked before a release, deploy, or change.",
+    false: "A new bug with no prior-working claim, a feature request, or a question."
+  }
+};
+var ISSUE_TRIAGE_QUESTION_IDS = {
+  type: "issueType",
+  stream: "issueStream",
+  actionable: "issueActionable",
+  security: "issueSecurity",
+  regression: "issueRegression"
+};
+function buildIssueTriageQuestions() {
+  return {
+    [ISSUE_TRIAGE_QUESTION_IDS.type]: ISSUE_TYPE_CHOICE_QUESTION,
+    [ISSUE_TRIAGE_QUESTION_IDS.stream]: ISSUE_STREAM_CHOICE_QUESTION,
+    [ISSUE_TRIAGE_QUESTION_IDS.actionable]: ISSUE_ACTIONABLE_NOUL_QUESTION,
+    [ISSUE_TRIAGE_QUESTION_IDS.security]: ISSUE_SECURITY_NOUL_QUESTION,
+    [ISSUE_TRIAGE_QUESTION_IDS.regression]: ISSUE_REGRESSION_NOUL_QUESTION
+  };
+}
+var issueTriageAnswersSchema = zod.z.object({
+  [ISSUE_TRIAGE_QUESTION_IDS.type]: choiceAnswerSchema,
+  [ISSUE_TRIAGE_QUESTION_IDS.stream]: choiceAnswerSchema,
+  [ISSUE_TRIAGE_QUESTION_IDS.actionable]: noulAnswerSchema,
+  [ISSUE_TRIAGE_QUESTION_IDS.security]: noulAnswerSchema,
+  [ISSUE_TRIAGE_QUESTION_IDS.regression]: noulAnswerSchema
+});
+var ISSUE_TYPE_CONFIDENCE_FLOOR = 0.6;
+var ISSUE_STREAM_CONFIDENCE_FLOOR = 0.7;
+var ISSUE_NEEDS_INFO_MAX_ACTIONABLE = 0.35;
+var ISSUE_ROUTING_THRESHOLD = 0.85;
+function clearsNoul(answer, threshold) {
+  return answer.noul >= threshold;
+}
+function pickType(answer, floor) {
+  const choice = pickChoiceAboveFloor(answer, { floor, noMatch: "unclear" });
+  return choice !== null && choice in ISSUE_TYPE_TAXONOMY ? choice : null;
+}
+function pickStream(answer, floor) {
+  const choice = pickChoiceAboveFloor(answer, { floor, noMatch: "unclear" });
+  return choice !== null && choice in ISSUE_STREAM_TAXONOMY ? choice : null;
+}
+function issueLabelsFromAnswers(answers, opts = {}) {
+  const typeFloor = opts.typeFloor ?? ISSUE_TYPE_CONFIDENCE_FLOOR;
+  const streamFloor = opts.streamFloor ?? ISSUE_STREAM_CONFIDENCE_FLOOR;
+  const needsInfoMax = opts.needsInfoMaxActionable ?? ISSUE_NEEDS_INFO_MAX_ACTIONABLE;
+  const routing = opts.routingThreshold ?? ISSUE_ROUTING_THRESHOLD;
+  const type = pickType(answers[ISSUE_TRIAGE_QUESTION_IDS.type], typeFloor);
+  if (type === "spam") {
+    return {
+      labels: ["spam"],
+      type,
+      stream: null,
+      needsInfo: false,
+      security: false,
+      regression: false
+    };
+  }
+  const stream = pickStream(answers[ISSUE_TRIAGE_QUESTION_IDS.stream], streamFloor);
+  const needsInfo = answers[ISSUE_TRIAGE_QUESTION_IDS.actionable].noul < needsInfoMax;
+  const security = clearsNoul(answers[ISSUE_TRIAGE_QUESTION_IDS.security], routing);
+  const regression = clearsNoul(answers[ISSUE_TRIAGE_QUESTION_IDS.regression], routing);
+  const labels = [];
+  if (type !== null) labels.push(type);
+  if (security) labels.push("security");
+  if (regression) labels.push("regression");
+  const streamLabel = stream !== null ? ISSUE_STREAM_LABELS[stream] : null;
+  if (streamLabel) labels.push(streamLabel);
+  if (needsInfo) labels.push("needs-info");
+  return { labels, type, stream, needsInfo, security, regression };
+}
+
+exports.ISSUE_ACTIONABLE_NOUL_QUESTION = ISSUE_ACTIONABLE_NOUL_QUESTION;
+exports.ISSUE_BODY_MAX_CHARS = ISSUE_BODY_MAX_CHARS;
+exports.ISSUE_NEEDS_INFO_MAX_ACTIONABLE = ISSUE_NEEDS_INFO_MAX_ACTIONABLE;
+exports.ISSUE_REGRESSION_NOUL_QUESTION = ISSUE_REGRESSION_NOUL_QUESTION;
+exports.ISSUE_ROUTING_THRESHOLD = ISSUE_ROUTING_THRESHOLD;
+exports.ISSUE_SECURITY_NOUL_QUESTION = ISSUE_SECURITY_NOUL_QUESTION;
+exports.ISSUE_STREAM_CHOICE_QUESTION = ISSUE_STREAM_CHOICE_QUESTION;
+exports.ISSUE_STREAM_CONFIDENCE_FLOOR = ISSUE_STREAM_CONFIDENCE_FLOOR;
+exports.ISSUE_STREAM_LABELS = ISSUE_STREAM_LABELS;
+exports.ISSUE_STREAM_TAXONOMY = ISSUE_STREAM_TAXONOMY;
+exports.ISSUE_TRIAGE_QUESTION_IDS = ISSUE_TRIAGE_QUESTION_IDS;
+exports.ISSUE_TYPE_CHOICE_QUESTION = ISSUE_TYPE_CHOICE_QUESTION;
+exports.ISSUE_TYPE_CONFIDENCE_FLOOR = ISSUE_TYPE_CONFIDENCE_FLOOR;
+exports.ISSUE_TYPE_TAXONOMY = ISSUE_TYPE_TAXONOMY;
+exports.buildIssueTriageQuestions = buildIssueTriageQuestions;
+exports.buildIssueTriageState = buildIssueTriageState;
+exports.issueLabelsFromAnswers = issueLabelsFromAnswers;
+exports.issueTriageAnswersSchema = issueTriageAnswersSchema;
+//# sourceMappingURL=issue.cjs.map
+//# sourceMappingURL=issue.cjs.map

package/dist/jev/issue.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/jev/index.ts","../../src/jev/issue.ts"],"names":["z","choiceQuestion"],"mappings":"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","file":"issue.cjs","sourcesContent":["/**\n * `@singi-labs/sifa-sdk/jev` -- TypeSafe System One (Jev) question builders,\n * taxonomies, result schemas, and threshold predicates for Sifa's organisation\n * intelligence.\n *\n * This subpath is pure: it defines the typed *questions* to ask Jev, validates\n * the *answers*, and holds the policy constants (thresholds, taxonomies) that\n * turn a raw judgment into a decision. It performs no network calls and needs\n * no API key, so it is safe to import anywhere. The actual `systemOne` call\n * lives server-side in sifa-api, which passes an API key that must never reach\n * the browser.\n *\n * Judgment shapes:\n * - Duplicate-org detection: a single Noul over a candidate pair.\n * - Firmographic classification: independent Choice questions (industry, type,\n *   size) asked together over one org's state.\n *\n * See docs.typesafe.ai for the wire contract. Typed output guarantees the\n * interface, not truth: validate thresholds on labelled Sifa data before\n * enabling any write.\n */\n\nimport { z } from 'zod';\n\n// ---------------------------------------------------------------------------\n// Wire question types\n// ---------------------------------------------------------------------------\n\n/** A yes/no judgment. `criteria` clarifies what true vs false means. */\nexport interface NoulQuestion {\n  type: 'noul';\n  instructions: string;\n  criteria?: { true: string; false: string };\n}\n\n/** A single-selection judgment. `criteria` maps each option to its description. */\nexport interface ChoiceQuestion {\n  type: 'choice';\n  instructions: string;\n  criteria: Record<string, string>;\n}\n\n// ---------------------------------------------------------------------------\n// Answer schemas (validate Jev's response before code trusts it)\n// ---------------------------------------------------------------------------\n\n/** Jev's Noul answer: `noul` is the probability that the answer is yes (0..1). */\nexport const noulAnswerSchema = z.object({\n  type: z.literal('noul'),\n  noul: z.number().min(0).max(1),\n});\nexport type NoulAnswer = z.infer<typeof noulAnswerSchema>;\n\n/**\n * Jev's Choice answer: `choice` is the highest-probability option, `confidence`\n * summarises how concentrated the distribution is, `probabilities` sums to 1.\n */\nexport const choiceAnswerSchema = z.object({\n  type: z.literal('choice'),\n  choice: z.string(),\n  confidence: z.number().min(0).max(1),\n  probabilities: z.record(z.string(), z.number()),\n});\nexport type ChoiceAnswer = z.infer<typeof choiceAnswerSchema>;\n\n// ---------------------------------------------------------------------------\n// Duplicate-org detection (Noul) -- ticket #560\n// ---------------------------------------------------------------------------\n\n/** Public, non-user fields we compare when judging whether two orgs are the same. */\nexport interface OrgRecordInput {\n  name: string;\n  domain?: string;\n  location?: string;\n  description?: string;\n}\n\n/** Build a plain object with only the defined keys (Jev sees no `undefined`). */\nfunction compact<T extends object>(obj: T): Partial<T> {\n  const out: Partial<T> = {};\n  for (const [k, v] of Object.entries(obj)) {\n    if (v !== undefined && v !== null && v !== '') out[k as keyof T] = v as T[keyof T];\n  }\n  return out;\n}\n\n/**\n * State for the org-pair judgment. Both records live under stable named fields\n * so the question can reference them unambiguously.\n */\nexport function buildOrgPairState(\n  a: OrgRecordInput,\n  b: OrgRecordInput,\n): { orgA: Partial<OrgRecordInput>; orgB: Partial<OrgRecordInput> } {\n  return { orgA: compact(a), orgB: compact(b) };\n}\n\n/** Static Noul question paired with {@link buildOrgPairState}. */\nexport const ORG_PAIR_NOUL_QUESTION: NoulQuestion = {\n  type: 'noul',\n  instructions:\n    'The state holds two organisation records, orgA and orgB. Do they refer to the same real-world organisation?',\n  criteria: {\n    true: 'Same organisation, e.g. a legal-suffix or abbreviation variant of the same name, or the same primary domain.',\n    false:\n      'Distinct organisations, e.g. a shared word in the name but different domains, locations, or lines of business.',\n  },\n};\n\n/**\n * Threshold favouring precision: a wrong merge is worse than a missed one.\n * Validate on labelled pairs (ticket #560) before enabling merges in prod.\n */\nexport const SAME_ORG_THRESHOLD = 0.85;\n\n/** True when the Noul probability clears the merge threshold. */\nexport function isLikelySameOrg(noul: number, threshold: number = SAME_ORG_THRESHOLD): boolean {\n  return noul >= threshold;\n}\n\n// ---------------------------------------------------------------------------\n// Firmographic classification (Choice) -- ticket #561\n// ---------------------------------------------------------------------------\n\n/** Industry taxonomy. Single source of truth; `other` is the no-match option. */\nexport const INDUSTRY_TAXONOMY: Record<string, string> = {\n  technology: 'Software, IT services, internet, hardware, telecoms',\n  finance: 'Banking, insurance, investment, fintech, accounting',\n  healthcare: 'Medical care, pharma, biotech, health services',\n  education: 'Schools, universities, training, edtech',\n  manufacturing: 'Industrial production, hardware, materials, automotive',\n  retail: 'Retail, ecommerce, consumer goods, hospitality, food',\n  media: 'Media, publishing, entertainment, marketing, advertising',\n  energy: 'Energy, utilities, oil and gas, renewables',\n  construction: 'Construction, real estate, architecture, engineering',\n  transport: 'Transport, logistics, shipping, aviation',\n  professional_services: 'Legal, consulting, HR, business services',\n  public_sector: 'Government, defence, public administration',\n  nonprofit: 'Charities, NGOs, foundations, associations',\n  agriculture: 'Agriculture, farming, fishing, forestry',\n  other: 'None of the above, or not enough information to decide',\n};\n\n/**\n * Organisation type (the org's FORM, not its sector -- a hospital's type is\n * healthcare_provider while its industry is healthcare). `other` is the no-match\n * option. Prefer the registry `legalForm` where it already encodes the form.\n */\nexport const ORG_TYPE_TAXONOMY: Record<string, string> = {\n  company: 'For-profit company or corporation',\n  cooperative: 'Member-owned co-operative (e.g. eG, SCOP, mutual, credit union)',\n  nonprofit: 'Nonprofit, charity, or NGO',\n  foundation: 'Grant-making or endowed foundation (e.g. Stiftung, fonds)',\n  government: 'Government body, agency, or public-sector authority',\n  educational: 'School, college, or university',\n  research_institute: 'Independent research institute or laboratory',\n  healthcare_provider: 'Hospital, clinic, or healthcare provider',\n  professional_association: 'Professional association, trade body, or trade union',\n  agency: 'Agency, consultancy, or professional-services firm',\n  religious: 'Religious organisation',\n  political: 'Political party or organisation',\n  self_employed: 'Sole proprietor, freelancer, or self-employed individual',\n  other: 'None of the above, or not enough information to decide',\n};\n\n/** Ordered employee-size bands; `unknown` is the no-match option. */\nexport const SIZE_BAND_TAXONOMY: Record<string, string> = {\n  solo: '1 person',\n  small: '2 to 10 people',\n  medium: '11 to 50 people',\n  large: '51 to 250 people',\n  enterprise: 'More than 250 people',\n  unknown: 'Not enough information to decide',\n};\n\nfunction choiceQuestion(instructions: string, criteria: Record<string, string>): ChoiceQuestion {\n  return { type: 'choice', instructions, criteria };\n}\n\nexport const INDUSTRY_CHOICE_QUESTION = choiceQuestion(\n  'Based on the org state, which single industry best describes this organisation?',\n  INDUSTRY_TAXONOMY,\n);\n\nexport const ORG_TYPE_CHOICE_QUESTION = choiceQuestion(\n  'Based on the org state, which single organisation type (its form, not its industry sector) best describes this organisation?',\n  ORG_TYPE_TAXONOMY,\n);\n\nexport const SIZE_BAND_CHOICE_QUESTION = choiceQuestion(\n  'Based on the org state, which employee-size band best fits this organisation?',\n  SIZE_BAND_TAXONOMY,\n);\n\n/**\n * Input for firmographic classification. `enrichmentText` (the org's description)\n * is the strongest evidence, but it is optional: many registry orgs have only a\n * name, domain, country, or link set. Passing those lets Jev classify from the\n * signal we hold rather than skipping the org for want of a description. A bare\n * name alone rarely suffices; a name plus a domain or country often does.\n */\nexport interface FirmographicInput {\n  name: string;\n  domain?: string;\n  country?: string;\n  /** Featured/external link labels or hosts (e.g. 'linkedin', 'wikipedia'). */\n  links?: string[];\n  /** An already-known industry, when set (helps disambiguate type/size). */\n  industry?: string;\n  enrichmentText?: string;\n}\n\n/**\n * State for the firmographic questions. Drops absent/empty fields (including\n * empty arrays) so Jev never sees a null or `[]` it would have to reason about.\n */\nexport function buildFirmographicState(org: FirmographicInput): Partial<FirmographicInput> {\n  const compacted = compact(org);\n  if (compacted.links && compacted.links.length === 0) delete compacted.links;\n  return compacted;\n}\n\n/**\n * Below this confidence a firmographic field is left unset rather than guessed.\n * Validate per field on labelled orgs (ticket #561).\n */\nexport const FIRMOGRAPHIC_CONFIDENCE_FLOOR = 0.6;\n\n/**\n * Select the classified option, or `null` to leave the field unset. Returns\n * null when confidence is below the floor, or when the selected option is the\n * taxonomy's no-match option.\n */\nexport function pickChoiceAboveFloor(\n  answer: ChoiceAnswer,\n  opts: { floor?: number; noMatch?: string } = {},\n): string | null {\n  const floor = opts.floor ?? FIRMOGRAPHIC_CONFIDENCE_FLOOR;\n  if (answer.confidence < floor) return null;\n  if (opts.noMatch !== undefined && answer.choice === opts.noMatch) return null;\n  return answer.choice;\n}\n","/**\n * Issue-triage judgments for the background-agent chores (sifa-workspace\n * decision 2026-10-05, background agents tier policy). Pure builders: the\n * typed questions to ask Jev about a GitHub issue, the label taxonomies, and\n * the thresholds that turn answers into label suggestions. No network, no key.\n *\n * Scope is deliberately T0 (read-only): the output is a list of label\n * suggestions a workflow may apply from an allowlist, never a code change.\n * Jev only sees public issue text. Exact signals (GlitchTip links, template\n * fields present) stay in code, not in a judgment.\n */\n\nimport { z } from 'zod';\n\nimport {\n  choiceAnswerSchema,\n  noulAnswerSchema,\n  pickChoiceAboveFloor,\n  type ChoiceAnswer,\n  type ChoiceQuestion,\n  type NoulAnswer,\n  type NoulQuestion,\n} from './index.js';\n\n// ---------------------------------------------------------------------------\n// Input and state\n// ---------------------------------------------------------------------------\n\n/** Public, non-user fields of a GitHub issue that the judgment may see. */\nexport interface IssueInput {\n  repo: string;\n  title: string;\n  body?: string;\n  /** Labels already on the issue (e.g. set by a template). */\n  existingLabels?: string[];\n}\n\n/** Longest issue body forwarded to Jev; keeps state bounded and cheap. */\nexport const ISSUE_BODY_MAX_CHARS = 6000;\n\nexport interface IssueTriageState {\n  repo: string;\n  title: string;\n  body?: string;\n  bodyTruncated?: true;\n  existingLabels?: string[];\n}\n\n/** State for the issue questions. Absent and blank fields are dropped. */\nexport function buildIssueTriageState(issue: IssueInput): IssueTriageState {\n  const state: IssueTriageState = { repo: issue.repo, title: issue.title.trim() };\n  const body = issue.body?.trim();\n  if (body) {\n    if (body.length > ISSUE_BODY_MAX_CHARS) {\n      state.body = body.slice(0, ISSUE_BODY_MAX_CHARS);\n      state.bodyTruncated = true;\n    } else {\n      state.body = body;\n    }\n  }\n  if (issue.existingLabels && issue.existingLabels.length > 0) {\n    state.existingLabels = issue.existingLabels;\n  }\n  return state;\n}\n\n// ---------------------------------------------------------------------------\n// Taxonomies (keys double as label names where a label exists)\n// ---------------------------------------------------------------------------\n\n/** One type label per issue. `unclear` is the no-match option and never a label. */\nexport const ISSUE_TYPE_TAXONOMY: Record<string, string> = {\n  bug: 'Something that exists does not behave as documented or expected (error, crash, wrong output)',\n  feature: 'A request for new behaviour or capability that does not exist yet',\n  question: 'A question about how something works, with nothing to build or fix',\n  documentation: 'Docs, README, comments, or examples are missing, wrong, or unclear',\n  'tech-debt':\n    'Internal refactor, cleanup, dependency, or tooling work with no user-visible change',\n  spam: 'Spam, gibberish, advertising, or a test submission',\n  unclear: 'Not enough information to decide the type',\n};\n\n/** Which product stream an issue belongs to. `unclear` is the no-match option. */\nexport const ISSUE_STREAM_TAXONOMY: Record<string, string> = {\n  sifa: 'The Sifa profile, activity stream, ingestion, search, or web app',\n  kootana: 'Kootana: events, meetings, in-person connect, QR scan, organizer tools',\n  unclear: 'Cannot tell from the issue',\n};\n\n/** Label applied for the Kootana stream; the Sifa stream carries no label. */\nexport const ISSUE_STREAM_LABELS: Readonly<Record<string, string | null>> = {\n  sifa: null,\n  kootana: 'stream:kootana',\n  unclear: null,\n};\n\n// ---------------------------------------------------------------------------\n// Questions (asked together over one issue state)\n// ---------------------------------------------------------------------------\n\nfunction choiceQuestion(instructions: string, criteria: Record<string, string>): ChoiceQuestion {\n  return { type: 'choice', instructions, criteria };\n}\n\nexport const ISSUE_TYPE_CHOICE_QUESTION = choiceQuestion(\n  'The state holds one GitHub issue (repo, title, body, existing labels). Which single type best describes it?',\n  ISSUE_TYPE_TAXONOMY,\n);\n\nexport const ISSUE_STREAM_CHOICE_QUESTION = choiceQuestion(\n  'Which product stream does this issue concern?',\n  ISSUE_STREAM_TAXONOMY,\n);\n\nexport const ISSUE_ACTIONABLE_NOUL_QUESTION: NoulQuestion = {\n  type: 'noul',\n  instructions:\n    'Does the issue contain enough information for a maintainer to act on it without asking the reporter anything?',\n  criteria: {\n    true: 'For a bug: steps or a trigger, expected vs actual, and an error or location. For a feature: the problem, the desired outcome, and rough scope.',\n    false:\n      'Essential details are missing: no way to reproduce, no expected behaviour, vague wish with no outcome, or a bare title.',\n  },\n};\n\nexport const ISSUE_SECURITY_NOUL_QUESTION: NoulQuestion = {\n  type: 'noul',\n  instructions: 'Does the issue describe a security-relevant problem?',\n  criteria: {\n    true: 'A vulnerability, auth or session flaw, data exposure, abuse or spam vector, secrets handling, or a dependency advisory.',\n    false: 'An ordinary bug, feature, question, or docs issue with no security angle.',\n  },\n};\n\nexport const ISSUE_REGRESSION_NOUL_QUESTION: NoulQuestion = {\n  type: 'noul',\n  instructions: 'Does the issue report that something which previously worked no longer works?',\n  criteria: {\n    true: 'The reporter states or clearly implies the behaviour worked before a release, deploy, or change.',\n    false: 'A new bug with no prior-working claim, a feature request, or a question.',\n  },\n};\n\n/** Stable question ids; the answer keys Jev returns. */\nexport const ISSUE_TRIAGE_QUESTION_IDS = {\n  type: 'issueType',\n  stream: 'issueStream',\n  actionable: 'issueActionable',\n  security: 'issueSecurity',\n  regression: 'issueRegression',\n} as const;\n\n/** All issue questions, keyed by {@link ISSUE_TRIAGE_QUESTION_IDS}, for one batched call. */\nexport function buildIssueTriageQuestions(): Record<string, ChoiceQuestion | NoulQuestion> {\n  return {\n    [ISSUE_TRIAGE_QUESTION_IDS.type]: ISSUE_TYPE_CHOICE_QUESTION,\n    [ISSUE_TRIAGE_QUESTION_IDS.stream]: ISSUE_STREAM_CHOICE_QUESTION,\n    [ISSUE_TRIAGE_QUESTION_IDS.actionable]: ISSUE_ACTIONABLE_NOUL_QUESTION,\n    [ISSUE_TRIAGE_QUESTION_IDS.security]: ISSUE_SECURITY_NOUL_QUESTION,\n    [ISSUE_TRIAGE_QUESTION_IDS.regression]: ISSUE_REGRESSION_NOUL_QUESTION,\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Answers -> label suggestions\n// ---------------------------------------------------------------------------\n\n/** Parsed answers for the batched issue call. */\nexport const issueTriageAnswersSchema = z.object({\n  [ISSUE_TRIAGE_QUESTION_IDS.type]: choiceAnswerSchema,\n  [ISSUE_TRIAGE_QUESTION_IDS.stream]: choiceAnswerSchema,\n  [ISSUE_TRIAGE_QUESTION_IDS.actionable]: noulAnswerSchema,\n  [ISSUE_TRIAGE_QUESTION_IDS.security]: noulAnswerSchema,\n  [ISSUE_TRIAGE_QUESTION_IDS.regression]: noulAnswerSchema,\n});\nexport type IssueTriageAnswers = z.infer<typeof issueTriageAnswersSchema>;\n\n/**\n * Thresholds. Precision over recall: a wrong label costs a maintainer a click\n * and trains distrust; a missing label costs nothing. Validate on labelled\n * closed issues (sifa-api#1555) before widening.\n */\nexport const ISSUE_TYPE_CONFIDENCE_FLOOR = 0.6;\nexport const ISSUE_STREAM_CONFIDENCE_FLOOR = 0.7;\n/** Below this P(actionable) the issue gets `needs-info`. */\nexport const ISSUE_NEEDS_INFO_MAX_ACTIONABLE = 0.35;\n/** Routing labels (security, regression) need a confident yes. */\nexport const ISSUE_ROUTING_THRESHOLD = 0.85;\n\nexport interface IssueLabelSuggestions {\n  /** Labels to apply, in a stable order, each guaranteed to be a real label name. */\n  labels: string[];\n  /** The type choice after the floor, or null when unset. */\n  type: string | null;\n  /** The stream choice after the floor, or null when unset. */\n  stream: string | null;\n  needsInfo: boolean;\n  security: boolean;\n  regression: boolean;\n}\n\nexport interface IssueLabelOptions {\n  typeFloor?: number;\n  streamFloor?: number;\n  needsInfoMaxActionable?: number;\n  routingThreshold?: number;\n}\n\nfunction clearsNoul(answer: NoulAnswer, threshold: number): boolean {\n  return answer.noul >= threshold;\n}\n\nfunction pickType(answer: ChoiceAnswer, floor: number): string | null {\n  const choice = pickChoiceAboveFloor(answer, { floor, noMatch: 'unclear' });\n  return choice !== null && choice in ISSUE_TYPE_TAXONOMY ? choice : null;\n}\n\nfunction pickStream(answer: ChoiceAnswer, floor: number): string | null {\n  const choice = pickChoiceAboveFloor(answer, { floor, noMatch: 'unclear' });\n  return choice !== null && choice in ISSUE_STREAM_TAXONOMY ? choice : null;\n}\n\n/**\n * Turn validated answers into label suggestions. Spam short-circuits: a spam\n * issue gets only `spam`, no routing or needs-info. A choice outside the\n * taxonomy (Jev invented a key) is treated as unset.\n */\nexport function issueLabelsFromAnswers(\n  answers: IssueTriageAnswers,\n  opts: IssueLabelOptions = {},\n): IssueLabelSuggestions {\n  const typeFloor = opts.typeFloor ?? ISSUE_TYPE_CONFIDENCE_FLOOR;\n  const streamFloor = opts.streamFloor ?? ISSUE_STREAM_CONFIDENCE_FLOOR;\n  const needsInfoMax = opts.needsInfoMaxActionable ?? ISSUE_NEEDS_INFO_MAX_ACTIONABLE;\n  const routing = opts.routingThreshold ?? ISSUE_ROUTING_THRESHOLD;\n\n  const type = pickType(answers[ISSUE_TRIAGE_QUESTION_IDS.type], typeFloor);\n  if (type === 'spam') {\n    return {\n      labels: ['spam'],\n      type,\n      stream: null,\n      needsInfo: false,\n      security: false,\n      regression: false,\n    };\n  }\n\n  const stream = pickStream(answers[ISSUE_TRIAGE_QUESTION_IDS.stream], streamFloor);\n  const needsInfo = answers[ISSUE_TRIAGE_QUESTION_IDS.actionable].noul < needsInfoMax;\n  const security = clearsNoul(answers[ISSUE_TRIAGE_QUESTION_IDS.security], routing);\n  const regression = clearsNoul(answers[ISSUE_TRIAGE_QUESTION_IDS.regression], routing);\n\n  const labels: string[] = [];\n  if (type !== null) labels.push(type);\n  if (security) labels.push('security');\n  if (regression) labels.push('regression');\n  const streamLabel = stream !== null ? ISSUE_STREAM_LABELS[stream] : null;\n  if (streamLabel) labels.push(streamLabel);\n  if (needsInfo) labels.push('needs-info');\n\n  return { labels, type, stream, needsInfo, security, regression };\n}\n"]}

package/dist/jev/issue.d.cts

@@ -0,0 +1,119 @@
+import { z } from 'zod';
+import { NoulQuestion, ChoiceQuestion } from './index.cjs';
+
+/**
+ * Issue-triage judgments for the background-agent chores (sifa-workspace
+ * decision 2026-10-05, background agents tier policy). Pure builders: the
+ * typed questions to ask Jev about a GitHub issue, the label taxonomies, and
+ * the thresholds that turn answers into label suggestions. No network, no key.
+ *
+ * Scope is deliberately T0 (read-only): the output is a list of label
+ * suggestions a workflow may apply from an allowlist, never a code change.
+ * Jev only sees public issue text. Exact signals (GlitchTip links, template
+ * fields present) stay in code, not in a judgment.
+ */
+
+/** Public, non-user fields of a GitHub issue that the judgment may see. */
+interface IssueInput {
+    repo: string;
+    title: string;
+    body?: string;
+    /** Labels already on the issue (e.g. set by a template). */
+    existingLabels?: string[];
+}
+/** Longest issue body forwarded to Jev; keeps state bounded and cheap. */
+declare const ISSUE_BODY_MAX_CHARS = 6000;
+interface IssueTriageState {
+    repo: string;
+    title: string;
+    body?: string;
+    bodyTruncated?: true;
+    existingLabels?: string[];
+}
+/** State for the issue questions. Absent and blank fields are dropped. */
+declare function buildIssueTriageState(issue: IssueInput): IssueTriageState;
+/** One type label per issue. `unclear` is the no-match option and never a label. */
+declare const ISSUE_TYPE_TAXONOMY: Record<string, string>;
+/** Which product stream an issue belongs to. `unclear` is the no-match option. */
+declare const ISSUE_STREAM_TAXONOMY: Record<string, string>;
+/** Label applied for the Kootana stream; the Sifa stream carries no label. */
+declare const ISSUE_STREAM_LABELS: Readonly<Record<string, string | null>>;
+declare const ISSUE_TYPE_CHOICE_QUESTION: ChoiceQuestion;
+declare const ISSUE_STREAM_CHOICE_QUESTION: ChoiceQuestion;
+declare const ISSUE_ACTIONABLE_NOUL_QUESTION: NoulQuestion;
+declare const ISSUE_SECURITY_NOUL_QUESTION: NoulQuestion;
+declare const ISSUE_REGRESSION_NOUL_QUESTION: NoulQuestion;
+/** Stable question ids; the answer keys Jev returns. */
+declare const ISSUE_TRIAGE_QUESTION_IDS: {
+    readonly type: "issueType";
+    readonly stream: "issueStream";
+    readonly actionable: "issueActionable";
+    readonly security: "issueSecurity";
+    readonly regression: "issueRegression";
+};
+/** All issue questions, keyed by {@link ISSUE_TRIAGE_QUESTION_IDS}, for one batched call. */
+declare function buildIssueTriageQuestions(): Record<string, ChoiceQuestion | NoulQuestion>;
+/** Parsed answers for the batched issue call. */
+declare const issueTriageAnswersSchema: z.ZodObject<{
+    issueType: z.ZodObject<{
+        type: z.ZodLiteral<"choice">;
+        choice: z.ZodString;
+        confidence: z.ZodNumber;
+        probabilities: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    }, z.core.$strip>;
+    issueStream: z.ZodObject<{
+        type: z.ZodLiteral<"choice">;
+        choice: z.ZodString;
+        confidence: z.ZodNumber;
+        probabilities: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    }, z.core.$strip>;
+    issueActionable: z.ZodObject<{
+        type: z.ZodLiteral<"noul">;
+        noul: z.ZodNumber;
+    }, z.core.$strip>;
+    issueSecurity: z.ZodObject<{
+        type: z.ZodLiteral<"noul">;
+        noul: z.ZodNumber;
+    }, z.core.$strip>;
+    issueRegression: z.ZodObject<{
+        type: z.ZodLiteral<"noul">;
+        noul: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+type IssueTriageAnswers = z.infer<typeof issueTriageAnswersSchema>;
+/**
+ * Thresholds. Precision over recall: a wrong label costs a maintainer a click
+ * and trains distrust; a missing label costs nothing. Validate on labelled
+ * closed issues (sifa-api#1555) before widening.
+ */
+declare const ISSUE_TYPE_CONFIDENCE_FLOOR = 0.6;
+declare const ISSUE_STREAM_CONFIDENCE_FLOOR = 0.7;
+/** Below this P(actionable) the issue gets `needs-info`. */
+declare const ISSUE_NEEDS_INFO_MAX_ACTIONABLE = 0.35;
+/** Routing labels (security, regression) need a confident yes. */
+declare const ISSUE_ROUTING_THRESHOLD = 0.85;
+interface IssueLabelSuggestions {
+    /** Labels to apply, in a stable order, each guaranteed to be a real label name. */
+    labels: string[];
+    /** The type choice after the floor, or null when unset. */
+    type: string | null;
+    /** The stream choice after the floor, or null when unset. */
+    stream: string | null;
+    needsInfo: boolean;
+    security: boolean;
+    regression: boolean;
+}
+interface IssueLabelOptions {
+    typeFloor?: number;
+    streamFloor?: number;
+    needsInfoMaxActionable?: number;
+    routingThreshold?: number;
+}
+/**
+ * Turn validated answers into label suggestions. Spam short-circuits: a spam
+ * issue gets only `spam`, no routing or needs-info. A choice outside the
+ * taxonomy (Jev invented a key) is treated as unset.
+ */
+declare function issueLabelsFromAnswers(answers: IssueTriageAnswers, opts?: IssueLabelOptions): IssueLabelSuggestions;
+
+export { ISSUE_ACTIONABLE_NOUL_QUESTION, ISSUE_BODY_MAX_CHARS, ISSUE_NEEDS_INFO_MAX_ACTIONABLE, ISSUE_REGRESSION_NOUL_QUESTION, ISSUE_ROUTING_THRESHOLD, ISSUE_SECURITY_NOUL_QUESTION, ISSUE_STREAM_CHOICE_QUESTION, ISSUE_STREAM_CONFIDENCE_FLOOR, ISSUE_STREAM_LABELS, ISSUE_STREAM_TAXONOMY, ISSUE_TRIAGE_QUESTION_IDS, ISSUE_TYPE_CHOICE_QUESTION, ISSUE_TYPE_CONFIDENCE_FLOOR, ISSUE_TYPE_TAXONOMY, type IssueInput, type IssueLabelOptions, type IssueLabelSuggestions, type IssueTriageAnswers, type IssueTriageState, buildIssueTriageQuestions, buildIssueTriageState, issueLabelsFromAnswers, issueTriageAnswersSchema };

package/dist/jev/issue.d.ts

@@ -0,0 +1,119 @@
+import { z } from 'zod';
+import { NoulQuestion, ChoiceQuestion } from './index.js';
+
+/**
+ * Issue-triage judgments for the background-agent chores (sifa-workspace
+ * decision 2026-10-05, background agents tier policy). Pure builders: the
+ * typed questions to ask Jev about a GitHub issue, the label taxonomies, and
+ * the thresholds that turn answers into label suggestions. No network, no key.
+ *
+ * Scope is deliberately T0 (read-only): the output is a list of label
+ * suggestions a workflow may apply from an allowlist, never a code change.
+ * Jev only sees public issue text. Exact signals (GlitchTip links, template
+ * fields present) stay in code, not in a judgment.
+ */
+
+/** Public, non-user fields of a GitHub issue that the judgment may see. */
+interface IssueInput {
+    repo: string;
+    title: string;
+    body?: string;
+    /** Labels already on the issue (e.g. set by a template). */
+    existingLabels?: string[];
+}
+/** Longest issue body forwarded to Jev; keeps state bounded and cheap. */
+declare const ISSUE_BODY_MAX_CHARS = 6000;
+interface IssueTriageState {
+    repo: string;
+    title: string;
+    body?: string;
+    bodyTruncated?: true;
+    existingLabels?: string[];
+}
+/** State for the issue questions. Absent and blank fields are dropped. */
+declare function buildIssueTriageState(issue: IssueInput): IssueTriageState;
+/** One type label per issue. `unclear` is the no-match option and never a label. */
+declare const ISSUE_TYPE_TAXONOMY: Record<string, string>;
+/** Which product stream an issue belongs to. `unclear` is the no-match option. */
+declare const ISSUE_STREAM_TAXONOMY: Record<string, string>;
+/** Label applied for the Kootana stream; the Sifa stream carries no label. */
+declare const ISSUE_STREAM_LABELS: Readonly<Record<string, string | null>>;
+declare const ISSUE_TYPE_CHOICE_QUESTION: ChoiceQuestion;
+declare const ISSUE_STREAM_CHOICE_QUESTION: ChoiceQuestion;
+declare const ISSUE_ACTIONABLE_NOUL_QUESTION: NoulQuestion;
+declare const ISSUE_SECURITY_NOUL_QUESTION: NoulQuestion;
+declare const ISSUE_REGRESSION_NOUL_QUESTION: NoulQuestion;
+/** Stable question ids; the answer keys Jev returns. */
+declare const ISSUE_TRIAGE_QUESTION_IDS: {
+    readonly type: "issueType";
+    readonly stream: "issueStream";
+    readonly actionable: "issueActionable";
+    readonly security: "issueSecurity";
+    readonly regression: "issueRegression";
+};
+/** All issue questions, keyed by {@link ISSUE_TRIAGE_QUESTION_IDS}, for one batched call. */
+declare function buildIssueTriageQuestions(): Record<string, ChoiceQuestion | NoulQuestion>;
+/** Parsed answers for the batched issue call. */
+declare const issueTriageAnswersSchema: z.ZodObject<{
+    issueType: z.ZodObject<{
+        type: z.ZodLiteral<"choice">;
+        choice: z.ZodString;
+        confidence: z.ZodNumber;
+        probabilities: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    }, z.core.$strip>;
+    issueStream: z.ZodObject<{
+        type: z.ZodLiteral<"choice">;
+        choice: z.ZodString;
+        confidence: z.ZodNumber;
+        probabilities: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    }, z.core.$strip>;
+    issueActionable: z.ZodObject<{
+        type: z.ZodLiteral<"noul">;
+        noul: z.ZodNumber;
+    }, z.core.$strip>;
+    issueSecurity: z.ZodObject<{
+        type: z.ZodLiteral<"noul">;
+        noul: z.ZodNumber;
+    }, z.core.$strip>;
+    issueRegression: z.ZodObject<{
+        type: z.ZodLiteral<"noul">;
+        noul: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+type IssueTriageAnswers = z.infer<typeof issueTriageAnswersSchema>;
+/**
+ * Thresholds. Precision over recall: a wrong label costs a maintainer a click
+ * and trains distrust; a missing label costs nothing. Validate on labelled
+ * closed issues (sifa-api#1555) before widening.
+ */
+declare const ISSUE_TYPE_CONFIDENCE_FLOOR = 0.6;
+declare const ISSUE_STREAM_CONFIDENCE_FLOOR = 0.7;
+/** Below this P(actionable) the issue gets `needs-info`. */
+declare const ISSUE_NEEDS_INFO_MAX_ACTIONABLE = 0.35;
+/** Routing labels (security, regression) need a confident yes. */
+declare const ISSUE_ROUTING_THRESHOLD = 0.85;
+interface IssueLabelSuggestions {
+    /** Labels to apply, in a stable order, each guaranteed to be a real label name. */
+    labels: string[];
+    /** The type choice after the floor, or null when unset. */
+    type: string | null;
+    /** The stream choice after the floor, or null when unset. */
+    stream: string | null;
+    needsInfo: boolean;
+    security: boolean;
+    regression: boolean;
+}
+interface IssueLabelOptions {
+    typeFloor?: number;
+    streamFloor?: number;
+    needsInfoMaxActionable?: number;
+    routingThreshold?: number;
+}
+/**
+ * Turn validated answers into label suggestions. Spam short-circuits: a spam
+ * issue gets only `spam`, no routing or needs-info. A choice outside the
+ * taxonomy (Jev invented a key) is treated as unset.
+ */
+declare function issueLabelsFromAnswers(answers: IssueTriageAnswers, opts?: IssueLabelOptions): IssueLabelSuggestions;
+
+export { ISSUE_ACTIONABLE_NOUL_QUESTION, ISSUE_BODY_MAX_CHARS, ISSUE_NEEDS_INFO_MAX_ACTIONABLE, ISSUE_REGRESSION_NOUL_QUESTION, ISSUE_ROUTING_THRESHOLD, ISSUE_SECURITY_NOUL_QUESTION, ISSUE_STREAM_CHOICE_QUESTION, ISSUE_STREAM_CONFIDENCE_FLOOR, ISSUE_STREAM_LABELS, ISSUE_STREAM_TAXONOMY, ISSUE_TRIAGE_QUESTION_IDS, ISSUE_TYPE_CHOICE_QUESTION, ISSUE_TYPE_CONFIDENCE_FLOOR, ISSUE_TYPE_TAXONOMY, type IssueInput, type IssueLabelOptions, type IssueLabelSuggestions, type IssueTriageAnswers, type IssueTriageState, buildIssueTriageQuestions, buildIssueTriageState, issueLabelsFromAnswers, issueTriageAnswersSchema };

package/dist/jev/issue.js

@@ -0,0 +1,166 @@
+// src/jev/issue.ts
+import { z } from "zod";
+import {
+  choiceAnswerSchema,
+  noulAnswerSchema,
+  pickChoiceAboveFloor
+} from "./index.js";
+var ISSUE_BODY_MAX_CHARS = 6e3;
+function buildIssueTriageState(issue) {
+  const state = { repo: issue.repo, title: issue.title.trim() };
+  const body = issue.body?.trim();
+  if (body) {
+    if (body.length > ISSUE_BODY_MAX_CHARS) {
+      state.body = body.slice(0, ISSUE_BODY_MAX_CHARS);
+      state.bodyTruncated = true;
+    } else {
+      state.body = body;
+    }
+  }
+  if (issue.existingLabels && issue.existingLabels.length > 0) {
+    state.existingLabels = issue.existingLabels;
+  }
+  return state;
+}
+var ISSUE_TYPE_TAXONOMY = {
+  bug: "Something that exists does not behave as documented or expected (error, crash, wrong output)",
+  feature: "A request for new behaviour or capability that does not exist yet",
+  question: "A question about how something works, with nothing to build or fix",
+  documentation: "Docs, README, comments, or examples are missing, wrong, or unclear",
+  "tech-debt": "Internal refactor, cleanup, dependency, or tooling work with no user-visible change",
+  spam: "Spam, gibberish, advertising, or a test submission",
+  unclear: "Not enough information to decide the type"
+};
+var ISSUE_STREAM_TAXONOMY = {
+  sifa: "The Sifa profile, activity stream, ingestion, search, or web app",
+  kootana: "Kootana: events, meetings, in-person connect, QR scan, organizer tools",
+  unclear: "Cannot tell from the issue"
+};
+var ISSUE_STREAM_LABELS = {
+  sifa: null,
+  kootana: "stream:kootana",
+  unclear: null
+};
+function choiceQuestion(instructions, criteria) {
+  return { type: "choice", instructions, criteria };
+}
+var ISSUE_TYPE_CHOICE_QUESTION = choiceQuestion(
+  "The state holds one GitHub issue (repo, title, body, existing labels). Which single type best describes it?",
+  ISSUE_TYPE_TAXONOMY
+);
+var ISSUE_STREAM_CHOICE_QUESTION = choiceQuestion(
+  "Which product stream does this issue concern?",
+  ISSUE_STREAM_TAXONOMY
+);
+var ISSUE_ACTIONABLE_NOUL_QUESTION = {
+  type: "noul",
+  instructions: "Does the issue contain enough information for a maintainer to act on it without asking the reporter anything?",
+  criteria: {
+    true: "For a bug: steps or a trigger, expected vs actual, and an error or location. For a feature: the problem, the desired outcome, and rough scope.",
+    false: "Essential details are missing: no way to reproduce, no expected behaviour, vague wish with no outcome, or a bare title."
+  }
+};
+var ISSUE_SECURITY_NOUL_QUESTION = {
+  type: "noul",
+  instructions: "Does the issue describe a security-relevant problem?",
+  criteria: {
+    true: "A vulnerability, auth or session flaw, data exposure, abuse or spam vector, secrets handling, or a dependency advisory.",
+    false: "An ordinary bug, feature, question, or docs issue with no security angle."
+  }
+};
+var ISSUE_REGRESSION_NOUL_QUESTION = {
+  type: "noul",
+  instructions: "Does the issue report that something which previously worked no longer works?",
+  criteria: {
+    true: "The reporter states or clearly implies the behaviour worked before a release, deploy, or change.",
+    false: "A new bug with no prior-working claim, a feature request, or a question."
+  }
+};
+var ISSUE_TRIAGE_QUESTION_IDS = {
+  type: "issueType",
+  stream: "issueStream",
+  actionable: "issueActionable",
+  security: "issueSecurity",
+  regression: "issueRegression"
+};
+function buildIssueTriageQuestions() {
+  return {
+    [ISSUE_TRIAGE_QUESTION_IDS.type]: ISSUE_TYPE_CHOICE_QUESTION,
+    [ISSUE_TRIAGE_QUESTION_IDS.stream]: ISSUE_STREAM_CHOICE_QUESTION,
+    [ISSUE_TRIAGE_QUESTION_IDS.actionable]: ISSUE_ACTIONABLE_NOUL_QUESTION,
+    [ISSUE_TRIAGE_QUESTION_IDS.security]: ISSUE_SECURITY_NOUL_QUESTION,
+    [ISSUE_TRIAGE_QUESTION_IDS.regression]: ISSUE_REGRESSION_NOUL_QUESTION
+  };
+}
+var issueTriageAnswersSchema = z.object({
+  [ISSUE_TRIAGE_QUESTION_IDS.type]: choiceAnswerSchema,
+  [ISSUE_TRIAGE_QUESTION_IDS.stream]: choiceAnswerSchema,
+  [ISSUE_TRIAGE_QUESTION_IDS.actionable]: noulAnswerSchema,
+  [ISSUE_TRIAGE_QUESTION_IDS.security]: noulAnswerSchema,
+  [ISSUE_TRIAGE_QUESTION_IDS.regression]: noulAnswerSchema
+});
+var ISSUE_TYPE_CONFIDENCE_FLOOR = 0.6;
+var ISSUE_STREAM_CONFIDENCE_FLOOR = 0.7;
+var ISSUE_NEEDS_INFO_MAX_ACTIONABLE = 0.35;
+var ISSUE_ROUTING_THRESHOLD = 0.85;
+function clearsNoul(answer, threshold) {
+  return answer.noul >= threshold;
+}
+function pickType(answer, floor) {
+  const choice = pickChoiceAboveFloor(answer, { floor, noMatch: "unclear" });
+  return choice !== null && choice in ISSUE_TYPE_TAXONOMY ? choice : null;
+}
+function pickStream(answer, floor) {
+  const choice = pickChoiceAboveFloor(answer, { floor, noMatch: "unclear" });
+  return choice !== null && choice in ISSUE_STREAM_TAXONOMY ? choice : null;
+}
+function issueLabelsFromAnswers(answers, opts = {}) {
+  const typeFloor = opts.typeFloor ?? ISSUE_TYPE_CONFIDENCE_FLOOR;
+  const streamFloor = opts.streamFloor ?? ISSUE_STREAM_CONFIDENCE_FLOOR;
+  const needsInfoMax = opts.needsInfoMaxActionable ?? ISSUE_NEEDS_INFO_MAX_ACTIONABLE;
+  const routing = opts.routingThreshold ?? ISSUE_ROUTING_THRESHOLD;
+  const type = pickType(answers[ISSUE_TRIAGE_QUESTION_IDS.type], typeFloor);
+  if (type === "spam") {
+    return {
+      labels: ["spam"],
+      type,
+      stream: null,
+      needsInfo: false,
+      security: false,
+      regression: false
+    };
+  }
+  const stream = pickStream(answers[ISSUE_TRIAGE_QUESTION_IDS.stream], streamFloor);
+  const needsInfo = answers[ISSUE_TRIAGE_QUESTION_IDS.actionable].noul < needsInfoMax;
+  const security = clearsNoul(answers[ISSUE_TRIAGE_QUESTION_IDS.security], routing);
+  const regression = clearsNoul(answers[ISSUE_TRIAGE_QUESTION_IDS.regression], routing);
+  const labels = [];
+  if (type !== null) labels.push(type);
+  if (security) labels.push("security");
+  if (regression) labels.push("regression");
+  const streamLabel = stream !== null ? ISSUE_STREAM_LABELS[stream] : null;
+  if (streamLabel) labels.push(streamLabel);
+  if (needsInfo) labels.push("needs-info");
+  return { labels, type, stream, needsInfo, security, regression };
+}
+export {
+  ISSUE_ACTIONABLE_NOUL_QUESTION,
+  ISSUE_BODY_MAX_CHARS,
+  ISSUE_NEEDS_INFO_MAX_ACTIONABLE,
+  ISSUE_REGRESSION_NOUL_QUESTION,
+  ISSUE_ROUTING_THRESHOLD,
+  ISSUE_SECURITY_NOUL_QUESTION,
+  ISSUE_STREAM_CHOICE_QUESTION,
+  ISSUE_STREAM_CONFIDENCE_FLOOR,
+  ISSUE_STREAM_LABELS,
+  ISSUE_STREAM_TAXONOMY,
+  ISSUE_TRIAGE_QUESTION_IDS,
+  ISSUE_TYPE_CHOICE_QUESTION,
+  ISSUE_TYPE_CONFIDENCE_FLOOR,
+  ISSUE_TYPE_TAXONOMY,
+  buildIssueTriageQuestions,
+  buildIssueTriageState,
+  issueLabelsFromAnswers,
+  issueTriageAnswersSchema
+};
+//# sourceMappingURL=issue.js.map

package/dist/jev/issue.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/jev/issue.ts"],"sourcesContent":["/**\n * Issue-triage judgments for the background-agent chores (sifa-workspace\n * decision 2026-10-05, background agents tier policy). Pure builders: the\n * typed questions to ask Jev about a GitHub issue, the label taxonomies, and\n * the thresholds that turn answers into label suggestions. No network, no key.\n *\n * Scope is deliberately T0 (read-only): the output is a list of label\n * suggestions a workflow may apply from an allowlist, never a code change.\n * Jev only sees public issue text. Exact signals (GlitchTip links, template\n * fields present) stay in code, not in a judgment.\n */\n\nimport { z } from 'zod';\n\nimport {\n  choiceAnswerSchema,\n  noulAnswerSchema,\n  pickChoiceAboveFloor,\n  type ChoiceAnswer,\n  type ChoiceQuestion,\n  type NoulAnswer,\n  type NoulQuestion,\n} from './index.js';\n\n// ---------------------------------------------------------------------------\n// Input and state\n// ---------------------------------------------------------------------------\n\n/** Public, non-user fields of a GitHub issue that the judgment may see. */\nexport interface IssueInput {\n  repo: string;\n  title: string;\n  body?: string;\n  /** Labels already on the issue (e.g. set by a template). */\n  existingLabels?: string[];\n}\n\n/** Longest issue body forwarded to Jev; keeps state bounded and cheap. */\nexport const ISSUE_BODY_MAX_CHARS = 6000;\n\nexport interface IssueTriageState {\n  repo: string;\n  title: string;\n  body?: string;\n  bodyTruncated?: true;\n  existingLabels?: string[];\n}\n\n/** State for the issue questions. Absent and blank fields are dropped. */\nexport function buildIssueTriageState(issue: IssueInput): IssueTriageState {\n  const state: IssueTriageState = { repo: issue.repo, title: issue.title.trim() };\n  const body = issue.body?.trim();\n  if (body) {\n    if (body.length > ISSUE_BODY_MAX_CHARS) {\n      state.body = body.slice(0, ISSUE_BODY_MAX_CHARS);\n      state.bodyTruncated = true;\n    } else {\n      state.body = body;\n    }\n  }\n  if (issue.existingLabels && issue.existingLabels.length > 0) {\n    state.existingLabels = issue.existingLabels;\n  }\n  return state;\n}\n\n// ---------------------------------------------------------------------------\n// Taxonomies (keys double as label names where a label exists)\n// ---------------------------------------------------------------------------\n\n/** One type label per issue. `unclear` is the no-match option and never a label. */\nexport const ISSUE_TYPE_TAXONOMY: Record<string, string> = {\n  bug: 'Something that exists does not behave as documented or expected (error, crash, wrong output)',\n  feature: 'A request for new behaviour or capability that does not exist yet',\n  question: 'A question about how something works, with nothing to build or fix',\n  documentation: 'Docs, README, comments, or examples are missing, wrong, or unclear',\n  'tech-debt':\n    'Internal refactor, cleanup, dependency, or tooling work with no user-visible change',\n  spam: 'Spam, gibberish, advertising, or a test submission',\n  unclear: 'Not enough information to decide the type',\n};\n\n/** Which product stream an issue belongs to. `unclear` is the no-match option. */\nexport const ISSUE_STREAM_TAXONOMY: Record<string, string> = {\n  sifa: 'The Sifa profile, activity stream, ingestion, search, or web app',\n  kootana: 'Kootana: events, meetings, in-person connect, QR scan, organizer tools',\n  unclear: 'Cannot tell from the issue',\n};\n\n/** Label applied for the Kootana stream; the Sifa stream carries no label. */\nexport const ISSUE_STREAM_LABELS: Readonly<Record<string, string | null>> = {\n  sifa: null,\n  kootana: 'stream:kootana',\n  unclear: null,\n};\n\n// ---------------------------------------------------------------------------\n// Questions (asked together over one issue state)\n// ---------------------------------------------------------------------------\n\nfunction choiceQuestion(instructions: string, criteria: Record<string, string>): ChoiceQuestion {\n  return { type: 'choice', instructions, criteria };\n}\n\nexport const ISSUE_TYPE_CHOICE_QUESTION = choiceQuestion(\n  'The state holds one GitHub issue (repo, title, body, existing labels). Which single type best describes it?',\n  ISSUE_TYPE_TAXONOMY,\n);\n\nexport const ISSUE_STREAM_CHOICE_QUESTION = choiceQuestion(\n  'Which product stream does this issue concern?',\n  ISSUE_STREAM_TAXONOMY,\n);\n\nexport const ISSUE_ACTIONABLE_NOUL_QUESTION: NoulQuestion = {\n  type: 'noul',\n  instructions:\n    'Does the issue contain enough information for a maintainer to act on it without asking the reporter anything?',\n  criteria: {\n    true: 'For a bug: steps or a trigger, expected vs actual, and an error or location. For a feature: the problem, the desired outcome, and rough scope.',\n    false:\n      'Essential details are missing: no way to reproduce, no expected behaviour, vague wish with no outcome, or a bare title.',\n  },\n};\n\nexport const ISSUE_SECURITY_NOUL_QUESTION: NoulQuestion = {\n  type: 'noul',\n  instructions: 'Does the issue describe a security-relevant problem?',\n  criteria: {\n    true: 'A vulnerability, auth or session flaw, data exposure, abuse or spam vector, secrets handling, or a dependency advisory.',\n    false: 'An ordinary bug, feature, question, or docs issue with no security angle.',\n  },\n};\n\nexport const ISSUE_REGRESSION_NOUL_QUESTION: NoulQuestion = {\n  type: 'noul',\n  instructions: 'Does the issue report that something which previously worked no longer works?',\n  criteria: {\n    true: 'The reporter states or clearly implies the behaviour worked before a release, deploy, or change.',\n    false: 'A new bug with no prior-working claim, a feature request, or a question.',\n  },\n};\n\n/** Stable question ids; the answer keys Jev returns. */\nexport const ISSUE_TRIAGE_QUESTION_IDS = {\n  type: 'issueType',\n  stream: 'issueStream',\n  actionable: 'issueActionable',\n  security: 'issueSecurity',\n  regression: 'issueRegression',\n} as const;\n\n/** All issue questions, keyed by {@link ISSUE_TRIAGE_QUESTION_IDS}, for one batched call. */\nexport function buildIssueTriageQuestions(): Record<string, ChoiceQuestion | NoulQuestion> {\n  return {\n    [ISSUE_TRIAGE_QUESTION_IDS.type]: ISSUE_TYPE_CHOICE_QUESTION,\n    [ISSUE_TRIAGE_QUESTION_IDS.stream]: ISSUE_STREAM_CHOICE_QUESTION,\n    [ISSUE_TRIAGE_QUESTION_IDS.actionable]: ISSUE_ACTIONABLE_NOUL_QUESTION,\n    [ISSUE_TRIAGE_QUESTION_IDS.security]: ISSUE_SECURITY_NOUL_QUESTION,\n    [ISSUE_TRIAGE_QUESTION_IDS.regression]: ISSUE_REGRESSION_NOUL_QUESTION,\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Answers -> label suggestions\n// ---------------------------------------------------------------------------\n\n/** Parsed answers for the batched issue call. */\nexport const issueTriageAnswersSchema = z.object({\n  [ISSUE_TRIAGE_QUESTION_IDS.type]: choiceAnswerSchema,\n  [ISSUE_TRIAGE_QUESTION_IDS.stream]: choiceAnswerSchema,\n  [ISSUE_TRIAGE_QUESTION_IDS.actionable]: noulAnswerSchema,\n  [ISSUE_TRIAGE_QUESTION_IDS.security]: noulAnswerSchema,\n  [ISSUE_TRIAGE_QUESTION_IDS.regression]: noulAnswerSchema,\n});\nexport type IssueTriageAnswers = z.infer<typeof issueTriageAnswersSchema>;\n\n/**\n * Thresholds. Precision over recall: a wrong label costs a maintainer a click\n * and trains distrust; a missing label costs nothing. Validate on labelled\n * closed issues (sifa-api#1555) before widening.\n */\nexport const ISSUE_TYPE_CONFIDENCE_FLOOR = 0.6;\nexport const ISSUE_STREAM_CONFIDENCE_FLOOR = 0.7;\n/** Below this P(actionable) the issue gets `needs-info`. */\nexport const ISSUE_NEEDS_INFO_MAX_ACTIONABLE = 0.35;\n/** Routing labels (security, regression) need a confident yes. */\nexport const ISSUE_ROUTING_THRESHOLD = 0.85;\n\nexport interface IssueLabelSuggestions {\n  /** Labels to apply, in a stable order, each guaranteed to be a real label name. */\n  labels: string[];\n  /** The type choice after the floor, or null when unset. */\n  type: string | null;\n  /** The stream choice after the floor, or null when unset. */\n  stream: string | null;\n  needsInfo: boolean;\n  security: boolean;\n  regression: boolean;\n}\n\nexport interface IssueLabelOptions {\n  typeFloor?: number;\n  streamFloor?: number;\n  needsInfoMaxActionable?: number;\n  routingThreshold?: number;\n}\n\nfunction clearsNoul(answer: NoulAnswer, threshold: number): boolean {\n  return answer.noul >= threshold;\n}\n\nfunction pickType(answer: ChoiceAnswer, floor: number): string | null {\n  const choice = pickChoiceAboveFloor(answer, { floor, noMatch: 'unclear' });\n  return choice !== null && choice in ISSUE_TYPE_TAXONOMY ? choice : null;\n}\n\nfunction pickStream(answer: ChoiceAnswer, floor: number): string | null {\n  const choice = pickChoiceAboveFloor(answer, { floor, noMatch: 'unclear' });\n  return choice !== null && choice in ISSUE_STREAM_TAXONOMY ? choice : null;\n}\n\n/**\n * Turn validated answers into label suggestions. Spam short-circuits: a spam\n * issue gets only `spam`, no routing or needs-info. A choice outside the\n * taxonomy (Jev invented a key) is treated as unset.\n */\nexport function issueLabelsFromAnswers(\n  answers: IssueTriageAnswers,\n  opts: IssueLabelOptions = {},\n): IssueLabelSuggestions {\n  const typeFloor = opts.typeFloor ?? ISSUE_TYPE_CONFIDENCE_FLOOR;\n  const streamFloor = opts.streamFloor ?? ISSUE_STREAM_CONFIDENCE_FLOOR;\n  const needsInfoMax = opts.needsInfoMaxActionable ?? ISSUE_NEEDS_INFO_MAX_ACTIONABLE;\n  const routing = opts.routingThreshold ?? ISSUE_ROUTING_THRESHOLD;\n\n  const type = pickType(answers[ISSUE_TRIAGE_QUESTION_IDS.type], typeFloor);\n  if (type === 'spam') {\n    return {\n      labels: ['spam'],\n      type,\n      stream: null,\n      needsInfo: false,\n      security: false,\n      regression: false,\n    };\n  }\n\n  const stream = pickStream(answers[ISSUE_TRIAGE_QUESTION_IDS.stream], streamFloor);\n  const needsInfo = answers[ISSUE_TRIAGE_QUESTION_IDS.actionable].noul < needsInfoMax;\n  const security = clearsNoul(answers[ISSUE_TRIAGE_QUESTION_IDS.security], routing);\n  const regression = clearsNoul(answers[ISSUE_TRIAGE_QUESTION_IDS.regression], routing);\n\n  const labels: string[] = [];\n  if (type !== null) labels.push(type);\n  if (security) labels.push('security');\n  if (regression) labels.push('regression');\n  const streamLabel = stream !== null ? ISSUE_STREAM_LABELS[stream] : null;\n  if (streamLabel) labels.push(streamLabel);\n  if (needsInfo) labels.push('needs-info');\n\n  return { labels, type, stream, needsInfo, security, regression };\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@singi-labs/sifa-sdk",
-  "version": "0.19.79",
+  "version": "0.19.81",
   "description": "Sifa SDK — public client library for the Sifa AppView on AT Protocol. Shared by sifa-web and sifa-app.",
   "license": "MIT",
   "type": "module",
@@ -172,6 +172,26 @@
         "default": "./dist/jev/index.cjs"
       }
     },
+    "./jev/issue": {
+      "import": {
+        "types": "./dist/jev/issue.d.ts",
+        "default": "./dist/jev/issue.js"
+      },
+      "require": {
+        "types": "./dist/jev/issue.d.cts",
+        "default": "./dist/jev/issue.cjs"
+      }
+    },
+    "./jev/error": {
+      "import": {
+        "types": "./dist/jev/error.d.ts",
+        "default": "./dist/jev/error.js"
+      },
+      "require": {
+        "types": "./dist/jev/error.d.cts",
+        "default": "./dist/jev/error.cjs"
+      }
+    },
     "./rpg": {
       "import": {
         "types": "./dist/rpg/index.d.ts",