@singi-labs/sifa-sdk 0.19.79 → 0.19.80

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.80";
 
 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.80";
 export {
   ACTIVITY_TIERS,
   ACTIVITY_VERBS,

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.80",
   "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,16 @@
         "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"
+      }
+    },
     "./rpg": {
       "import": {
         "types": "./dist/rpg/index.d.ts",