@happyvertical/smrt-projects 0.57.31 → 0.57.32

package/README.md

@@ -202,3 +202,42 @@ await withRepositoryClient(
 
 See [`AGENTS.md`](./AGENTS.md) for package architecture, invariants, validation,
 and contributor guidance.
+
+### Structured project questions
+
+`ProjectGovernanceService.createQuestion({ ..., options })` accepts optional
+single-choice suggestions (`ProjectQuestionOption`: stable `id`, `label`, optional
+`description`, optional boolean `recommended`). Recommendations are presentation
+only: creation leaves the question open, with no answer or selection. IDs must be
+unique and nonempty; `other` (case insensitive) is reserved and cannot be authored.
+`question.getOptions()` appends `{ id: 'other', label: 'Other' }` to structured
+questions. Omitting options, or supplying an empty array, keeps the existing
+free-text question flow.
+
+`answerQuestion` continues to require a nonempty string `answer`. It additionally
+accepts optional `selectedOptionId` and `idempotencyKey`. An explicit selection
+must match an offered ID, including `other`; an Other answer requires text. Hosts
+should send the chosen label as `answer` for ordinary choices and the person's
+text for Other. The generic `ProjectQuestionsAndDecisions` component supplies
+these values, uses an unselected radio group, marks recommendations, and always
+shows the Other text box. Only explicit form submission invokes `onanswer`.
+
+Existing free-text API clients remain compatible, including when answering a
+structured question without a selection: the service stores their answer and
+leaves `selectedOptionId` empty. It never guesses an option from text. Existing
+questions and immutable history are not rewritten or backfilled. New answer
+history has a `getAnswerSelection()` snapshot with answer text, observed revision,
+and explicit option ID/label when supplied; older events return `null`.
+
+The optional idempotency key is scoped to a question. After tenant/project and
+current owner/manager authorization, an identical actor, answer, selection,
+expected revision, and note replays without a new revision or history event.
+Reusing the key with different input conflicts. Without a key, the existing
+expected-revision conflict behavior applies. Transaction rollback covers both
+question and history writes. Hosts retain responsibility for affected-task
+reconciliation after persistence and replay.
+
+This additive contract adds `question_options` and `selected_option_id` columns
+to `project_questions`, and `answer_selection` to `project_governance_events`.
+Consumers must run their normal manifest-driven database migration before using
+the new released surface. It introduces no new model or table.

package/dist/index.d.ts

@@ -75,7 +75,8 @@ export { PullRequest, type PullRequestOptions } from "./models/PullRequest.js";
 export { Repository, type RepositoryOptions } from "./models/Repository.js";
 export * from './models/service-evidence.js';
 export type { ProjectBoardMoveIntent } from './project-board-types.js';
-export type { ProjectContextReference, ProjectContextReferenceKind, ProjectDecisionCreateInput, ProjectDecisionOption, ProjectDecisionStatus, ProjectGovernanceAction, ProjectGovernanceActor, ProjectGovernanceActorType, ProjectGovernanceOwner, ProjectGovernanceRecordKind, ProjectGovernanceScope, ProjectGovernanceVisibility, ProjectQuestionCreateInput, ProjectQuestionStatus, } from './project-governance-types.js';
+export type { ProjectContextReference, ProjectContextReferenceKind, ProjectDecisionCreateInput, ProjectDecisionOption, ProjectDecisionStatus, ProjectGovernanceAction, ProjectGovernanceActor, ProjectGovernanceActorType, ProjectGovernanceOwner, ProjectGovernanceRecordKind, ProjectGovernanceScope, ProjectGovernanceVisibility, ProjectQuestionAnswerSelection, ProjectQuestionCreateInput, ProjectQuestionOption, ProjectQuestionStatus, } from './project-governance-types.js';
+export { PROJECT_QUESTION_OTHER_OPTION_ID } from './project-governance-types.js';
 export { issueIncorporateFeedbackPrompt } from "./prompts.js";
 export { ProjectTrackerRecipe } from "./recipes.js";
 export { type RepositoryClientScope, withRepositoryClient, } from "./repository-client-scope.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAKH,OAAO,wBAAwB,CAAC;AAGhC,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAAwB,CAAC;AAC3D,OAAO,EAAE,mCAAmC,EAAE,MAAM,8CAA2C,CAAC;AAChG,OAAO,EAAE,4BAA4B,EAAE,MAAM,sCAAmC,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAsB,CAAC;AACvD,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAgC,CAAC;AAC3E,OAAO,EAAE,gCAAgC,EAAE,MAAM,0CAAuC,CAAC;AACzF,OAAO,EAAE,iCAAiC,EAAE,MAAM,2CAAwC,CAAC;AAC3F,OAAO,EAAE,4BAA4B,EAAE,MAAM,sCAAmC,CAAC;AACjF,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAgC,CAAC;AAC3E,OAAO,EAAE,8BAA8B,EAAE,MAAM,wCAAwC,CAAC;AACxF,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAAwB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA4B,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA4B,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAkB,CAAC;AAExD,OAAO,EACL,gCAAgC,EAChC,sBAAsB,EACtB,mCAAmC,EACnC,gCAAgC,GACjC,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,qBAAkB,CAAC;AAChE,OAAO,EACL,kBAAkB,EAClB,KAAK,yBAAyB,GAC/B,MAAM,gCAA6B,CAAC;AACrC,OAAO,EACL,yBAAyB,EACzB,KAAK,gCAAgC,GACtC,MAAM,uCAAoC,CAAC;AAC5C,cAAc,oCAAoC,CAAC;AACnD,OAAO,EACL,KAAK,EACL,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,EAC9B,KAAK,4BAA4B,EACjC,KAAK,YAAY,GAClB,MAAM,mBAAgB,CAAC;AACxB,OAAO,EAAE,KAAK,EAAE,KAAK,YAAY,EAAE,MAAM,mBAAgB,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,qBAAkB,CAAC;AAChE,OAAO,EACL,eAAe,EACf,KAAK,sBAAsB,GAC5B,MAAM,6BAA0B,CAAC;AAClC,OAAO,EACL,sBAAsB,EACtB,KAAK,6BAA6B,GACnC,MAAM,oCAAiC,CAAC;AACzC,OAAO,EACL,kBAAkB,EAClB,KAAK,yBAAyB,GAC/B,MAAM,gCAA6B,CAAC;AACrC,OAAO,EACL,uBAAuB,EACvB,KAAK,8BAA8B,GACpC,MAAM,qCAAkC,CAAC;AAC1C,OAAO,EACL,eAAe,EACf,KAAK,sBAAsB,GAC5B,MAAM,6BAA0B,CAAC;AAClC,OAAO,EACL,oBAAoB,EACpB,KAAK,2BAA2B,GACjC,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,yBAAsB,CAAC;AAC5E,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,wBAAqB,CAAC;AACzE,cAAc,8BAA8B,CAAC;AAC7C,YAAY,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AACvE,YAAY,EACV,uBAAuB,EACvB,2BAA2B,EAC3B,0BAA0B,EAC1B,qBAAqB,EACrB,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,EACtB,0BAA0B,EAC1B,sBAAsB,EACtB,2BAA2B,EAC3B,sBAAsB,EACtB,2BAA2B,EAC3B,8BAA8B,EAC9B,0BAA0B,EAC1B,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,gCAAgC,EAAE,MAAM,+BAA+B,CAAC;AACjF,OAAO,EAAE,8BAA8B,EAAE,MAAM,cAAW,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAW,CAAC;AACjD,OAAO,EACL,KAAK,qBAAqB,EAC1B,oBAAoB,GACrB,MAAM,8BAA2B,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,OAAO,EACL,0CAA0C,EAC1C,KAAK,kCAAkC,EACvC,oCAAoC,GACrC,MAAM,uDAAuD,CAAC;AAC/D,cAAc,6CAA6C,CAAC;AAE5D,YAAY,EACV,wBAAwB,EAExB,MAAM,EACN,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,0BAA0B,EAC1B,wBAAwB,EACxB,wBAAwB,EACxB,iCAAiC,EACjC,sBAAsB,EACtB,4BAA4B,EAC5B,yBAAyB,EAEzB,0BAA0B,EAC1B,yBAAyB,EAEzB,QAAQ,EACR,WAAW,EACX,WAAW,EACX,6BAA6B,EAC7B,oCAAoC,EACpC,WAAW,EACX,aAAa,EACb,YAAY,EACZ,kBAAkB,EAClB,6BAA6B,EAC7B,4BAA4B,EAC5B,wBAAwB,EACxB,WAAW,EACX,mBAAmB,EACnB,aAAa,EACb,gBAAgB,EAChB,sBAAsB,EACtB,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,cAAc,EACd,aAAa,EACb,aAAa,EACb,eAAe,EACf,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,EACtB,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,IAAI,GACL,MAAM,YAAS,CAAC;AAEjB,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,SAAM,CAAC"}