@happyvertical/smrt-projects 0.60.8 → 0.60.10

package/dist/smrt-knowledge.json

@@ -3,12 +3,12 @@
   "sensitiveFieldsExcluded": true,
   "generatedAt": "1970-01-01T00:00:00.000Z",
   "packageName": "@happyvertical/smrt-projects",
-  "packageVersion": "0.60.8",
+  "packageVersion": "0.60.10",
   "sourceManifestPath": "dist/manifest.json",
   "agentDocPath": "AGENTS.md",
   "sourceHashes": {
-    "manifest": "0c850fb0d111b20dc43580eb499c9cd79ffde1c6b0dcbb75ff8f0c2dd01abda1",
-    "packageJson": "6b36adbe360d9366cfb46b7d28f8c214ef8f0ff07dd84a6e8b3cdb25456469de",
+    "manifest": "041080f88a30cc8780dd0337e318cfa66f091e1390b7810d7bbbcf4011f12b8a",
+    "packageJson": "2f4bcb63845c682e3c304875322e928e745147238d13f06b9d638ba99ab8a271",
     "agents": "2879830c12902195bd4f887cf00bdabbe8e7216ebafe2a9b2d007a00d137435c"
   },
   "exports": [

package/dist/smrt-knowledge.okf.md

@@ -0,0 +1,131 @@
+---
+type: "Component"
+title: "@happyvertical/smrt-projects"
+description: "Provider-agnostic project management models (Issues, PRs, Repositories, Projects) for SMRT framework"
+status: "stable"
+generated:
+  by: "smrt/scripts/generate-knowledge-okf.ts"
+  at: "2026-11-05T15:48:19Z"
+audience: "internal"
+evidence_level: "source-inspected"
+source_revision: "sha256:800a0e90c386ac2e2fe701004092478c3c53c1acfb8c257f86d675003e9ccd03"
+sources:
+  - id: "manifest"
+    resource: "https://github.com/happyvertical/smrt/blob/main/packages/projects/package.json"
+    title: "@happyvertical/smrt-projects package manifest"
+  - id: "agents"
+    resource: "https://github.com/happyvertical/smrt/blob/main/packages/projects/AGENTS.md"
+    title: "@happyvertical/smrt-projects packages/projects/AGENTS.md"
+---
+
+# @happyvertical/smrt-projects
+
+## Package
+
+- Directory: `packages/projects`
+- Private: no
+- Object source: `domain-artifact`
+- Evidence level: `source-inspected`
+
+## Documentation
+
+- `packages/projects/AGENTS.md`
+
+## Framework dependencies
+
+- [smrt-cli](/components/smrt-cli.md)
+- [smrt-config](/components/smrt-config.md)
+- [smrt-core](/components/smrt-core.md)
+- [smrt-prompts](/components/smrt-prompts.md)
+- [smrt-subscriptions](/components/smrt-subscriptions.md)
+- [smrt-svelte](/components/smrt-svelte.md)
+- [smrt-tenancy](/components/smrt-tenancy.md)
+- [smrt-timesheets](/components/smrt-timesheets.md)
+- [smrt-types](/components/smrt-types.md)
+- [smrt-ui](/components/smrt-ui.md)
+- [smrt-vitest](/components/smrt-vitest.md)
+
+## SDK dependencies
+
+- `@happyvertical/ai`
+- `@happyvertical/logger`
+- `@happyvertical/projects`
+- `@happyvertical/repos`
+- `@happyvertical/sql`
+- `@happyvertical/utils`
+
+## Exports
+
+- `.`
+- `./manifest`
+- `./manifest.json`
+- `./playground`
+- `./svelte`
+- `./ui`
+
+## Models
+
+- `AssistanceRequest` (collection `assistancerequests`, extends `SmrtObject`)
+- `AssistanceRequestCollection` (collection `assistancerequests`, extends `SmrtCollection`)
+- `AssistanceRequestEvent` (collection `assistancerequestevents`, extends `SmrtObject`)
+- `AssistanceRequestEventCollection` (collection `assistancerequestevents`, extends `SmrtCollection`)
+- `Comment` (collection `comments`, extends `SmrtObject`)
+- `CommentCollection` (collection `comments`, extends `SmrtCollection`)
+- `DevelopmentRequest` (collection `developmentrequests`, extends `SmrtObject`)
+- `DevelopmentRequestCollection` (collection `developmentrequests`, extends `SmrtCollection`)
+- `DevelopmentRequestHistory` (collection `developmentrequesthistories`, extends `SmrtObject`)
+- `DevelopmentRequestHistoryCollection` (collection `developmentrequesthistories`, extends `SmrtCollection`)
+- `DevelopmentRequestWorkLink` (collection `developmentrequestworklinks`, extends `SmrtObject`)
+- `DevelopmentRequestWorkLinkCollection` (collection `developmentrequestworklinks`, extends `SmrtCollection`)
+- `Issue` (collection `issues`, extends `SmrtObject`, STI table)
+- `IssueCollection` (collection `issues`, extends `SmrtCollection`)
+- `Label` (collection `labels`, extends `SmrtObject`)
+- `PreviewApproval` (collection `previewapprovals`, extends `SmrtObject`)
+- `PreviewApprovalCollection` (collection `previewapprovals`, extends `SmrtCollection`)
+- `Project` (collection `projects`, extends `SmrtObject`)
+- `ProjectCollection` (collection `projects`, extends `SmrtCollection`)
+- `ProjectDecision` (collection `projectdecisions`, extends `SmrtPolymorphicAssociation`)
+- `ProjectDecisionCollection` (collection `projectdecisions`, extends `SmrtCollection`)
+- `ProjectDeliveryEvent` (collection `projectdeliveryevents`, extends `SmrtObject`)
+- `ProjectDeliveryEventCollection` (collection `projectdeliveryevents`, extends `SmrtCollection`)
+- `ProjectGovernanceEvent` (collection `projectgovernanceevents`, extends `SmrtPolymorphicAssociation`)
+- `ProjectGovernanceEventCollection` (collection `projectgovernanceevents`, extends `SmrtCollection`)
+- `ProjectIntegration` (collection `projectintegrations`, extends `SmrtObject`)
+- `ProjectIntegrationAudit` (collection `projectintegrationaudits`, extends `SmrtObject`)
+- `ProjectIntegrationAuditCollection` (collection `projectintegrationaudits`, extends `SmrtCollection`)
+- `ProjectIntegrationCollection` (collection `projectintegrations`, extends `SmrtCollection`)
+- `ProjectQuestion` (collection `projectquestions`, extends `SmrtPolymorphicAssociation`)
+- `ProjectQuestionCollection` (collection `projectquestions`, extends `SmrtCollection`)
+- `ProjectSpecification` (collection `projectspecifications`, extends `SmrtPolymorphicAssociation`)
+- `ProjectSpecificationCollection` (collection `projectspecifications`, extends `SmrtCollection`)
+- `PullRequest` (collection `issues`, extends `Issue`, STI table)
+- `PullRequestCollection` (collection `issues`, extends `SmrtCollection`)
+- `Repository` (collection `repositories`, extends `SmrtObject`)
+- `RepositoryCollection` (collection `repositories`, extends `SmrtCollection`)
+
+## MCP tools
+
+- `comment_get`: get on `@happyvertical/smrt-projects:Comment`
+- `comment_list`: list on `@happyvertical/smrt-projects:Comment`
+- `issue_get`: get on `@happyvertical/smrt-projects:Issue`
+- `issue_incorporatefeedback`: incorporateFeedback on `@happyvertical/smrt-projects:Issue`
+- `issue_list`: list on `@happyvertical/smrt-projects:Issue`
+- `issue_sync`: sync on `@happyvertical/smrt-projects:Issue`
+- `label_create`: create on `@happyvertical/smrt-projects:Label`
+- `label_get`: get on `@happyvertical/smrt-projects:Label`
+- `label_list`: list on `@happyvertical/smrt-projects:Label`
+- `project_additem`: addItem on `@happyvertical/smrt-projects:Project`
+- `project_get`: get on `@happyvertical/smrt-projects:Project`
+- `project_list`: list on `@happyvertical/smrt-projects:Project`
+- `project_sync`: sync on `@happyvertical/smrt-projects:Project`
+- `project_updateitemstatus`: updateItemStatus on `@happyvertical/smrt-projects:Project`
+- `projectintegration_get`: get on `@happyvertical/smrt-projects:ProjectIntegration`
+- `projectintegration_list`: list on `@happyvertical/smrt-projects:ProjectIntegration`
+- `pullrequest_get`: get on `@happyvertical/smrt-projects:PullRequest`
+- `pullrequest_list`: list on `@happyvertical/smrt-projects:PullRequest`
+- `pullrequest_merge`: merge on `@happyvertical/smrt-projects:PullRequest`
+- `pullrequest_summarize`: summarize on `@happyvertical/smrt-projects:PullRequest`
+- `pullrequest_sync`: sync on `@happyvertical/smrt-projects:PullRequest`
+- `repository_get`: get on `@happyvertical/smrt-projects:Repository`
+- `repository_list`: list on `@happyvertical/smrt-projects:Repository`
+- `repository_sync`: sync on `@happyvertical/smrt-projects:Repository`

package/dist/svelte/ProjectInterview.svelte

@@ -0,0 +1,387 @@
+<script lang="ts">
+import { Form, Input, Textarea } from '@happyvertical/smrt-ui/forms';
+import { useI18n } from '@happyvertical/smrt-ui/i18n';
+import { Button } from '@happyvertical/smrt-ui/ui';
+import { tick } from 'svelte';
+import { M } from './i18n.js';
+import type {
+  ProjectDecisionResolveInput,
+  ProjectDecisionView,
+  ProjectInterviewAdvanceDetail,
+  ProjectInterviewFraming,
+  ProjectQuestionAnswerInput,
+  ProjectQuestionView,
+} from './project-governance-types.js';
+
+export interface Props {
+  /** Authorized questions, in the order the host wants them asked. */
+  questions?: ProjectQuestionView[];
+  /** Authorized decisions, asked after the questions in the host's order. */
+  decisions?: ProjectDecisionView[];
+  /** Disable submissions and navigation while the host saves a change. */
+  busy?: boolean;
+  /** Plain-language framing keyed by question or decision id. */
+  framing?: Record<string, ProjectInterviewFraming>;
+  /**
+   * Zero-based record to open first (e.g. a resumed position). Defaults to the
+   * first open record; read once on mount.
+   */
+  startIndex?: number;
+  /** Save an explicit answer with the observed revision. */
+  onanswer?: (input: ProjectQuestionAnswerInput) => void | Promise<void>;
+  /** Save a selected outcome and optional rationale with the observed revision. */
+  ondecide?: (input: ProjectDecisionResolveInput) => void | Promise<void>;
+  /** Called whenever the interview moves to another record or completes. */
+  onadvance?: (detail: ProjectInterviewAdvanceDetail) => void;
+}
+
+type Step =
+  | { kind: 'question'; key: string; record: ProjectQuestionView }
+  | { kind: 'decision'; key: string; record: ProjectDecisionView };
+
+let {
+  questions = [],
+  decisions = [],
+  busy = false,
+  framing = {},
+  startIndex,
+  onanswer,
+  ondecide,
+  onadvance,
+}: Props = $props();
+
+const { t } = useI18n();
+
+const steps = $derived<Step[]>([
+  ...questions.map((record) => ({
+    kind: 'question' as const,
+    key: `question:${record.id}`,
+    record,
+  })),
+  ...decisions.map((record) => ({
+    kind: 'decision' as const,
+    key: `decision:${record.id}`,
+    record,
+  })),
+]);
+const total = $derived(steps.length);
+const answeredCount = $derived(
+  steps.filter((step) => step.record.status !== 'open').length,
+);
+const openCount = $derived(total - answeredCount);
+
+function firstOpenFrom(from: number): number {
+  for (let index = Math.max(0, from); index < steps.length; index++) {
+    if (steps[index].record.status === 'open') return index;
+  }
+  return steps.length;
+}
+
+function initialCursor(): { key: string | null; index: number } {
+  const index =
+    startIndex === undefined
+      ? firstOpenFrom(0)
+      : Math.min(Math.max(0, Math.trunc(startIndex)), steps.length);
+  return { key: steps[index]?.key ?? null, index };
+}
+
+// Track the current record by identity so host re-ordering or removal of an
+// answered record never jumps the person to an unrelated question.
+let cursor = $state(initialCursor());
+const position = $derived.by(() => {
+  const found = cursor.key
+    ? steps.findIndex((step) => step.key === cursor.key)
+    : -1;
+  return found >= 0 ? found : Math.min(cursor.index, total);
+});
+const current = $derived<Step | null>(steps[position] ?? null);
+
+// Keep the fallback index aligned with the record's latest position so a later
+// withdrawal resumes from where that record actually was.
+$effect(() => {
+  if (
+    cursor.key &&
+    steps[position]?.key === cursor.key &&
+    cursor.index !== position
+  ) {
+    cursor = { key: cursor.key, index: position };
+  }
+});
+
+let pendingKey = $state<string | null>(null);
+let selections = $state<Record<string, string>>({});
+let heading = $state<HTMLElement | null>(null);
+let focusRequested = false;
+
+// Motion is opt-in: assume reduced motion until the browser says otherwise.
+let reducedMotion = $state(true);
+$effect(() => {
+  if (typeof window === 'undefined' || !window.matchMedia) return;
+  const query = window.matchMedia('(prefers-reduced-motion: reduce)');
+  reducedMotion = query.matches;
+  const update = (event: MediaQueryListEvent) => {
+    reducedMotion = event.matches;
+  };
+  query.addEventListener?.('change', update);
+  return () => query.removeEventListener?.('change', update);
+});
+
+function moveTo(
+  index: number,
+  reason: ProjectInterviewAdvanceDetail['reason'],
+) {
+  const next = Math.min(Math.max(0, index), total);
+  const step = steps[next] ?? null;
+  cursor = { key: step?.key ?? null, index: next };
+  pendingKey = null;
+  focusRequested = true;
+  onadvance?.({
+    index: next,
+    total,
+    id: step?.record.id ?? null,
+    kind: step?.kind ?? null,
+    reason,
+  });
+}
+
+// Advance once the host persists the submitted record (status leaves `open` or
+// the record is withdrawn); a failed save keeps the person on the question.
+$effect(() => {
+  if (!pendingKey) return;
+  const index = steps.findIndex((step) => step.key === pendingKey);
+  if (index >= 0 && steps[index].record.status === 'open') return;
+  const from = index >= 0 ? index + 1 : Math.min(cursor.index, total);
+  moveTo(firstOpenFrom(from), 'answered');
+});
+
+$effect(() => {
+  if (!heading || !focusRequested) return;
+  focusRequested = false;
+  const target = heading;
+  void tick().then(() => target.focus());
+});
+
+function sortedOptions<T extends { id: string; recommended?: boolean }>(
+  options: T[] | undefined,
+  recommendedId: string | undefined,
+  reserveOther: boolean,
+): Array<T & { isRecommended: boolean }> {
+  return (
+    (options ?? [])
+      // `other` is reserved for the question form's free-text choice only.
+      .filter((option) => !reserveOther || option.id !== 'other')
+      .map((option) => ({
+        ...option,
+        isRecommended: recommendedId
+          ? option.id === recommendedId
+          : Boolean(option.recommended),
+      }))
+      .sort((a, b) => Number(b.isRecommended) - Number(a.isRecommended))
+  );
+}
+
+function submitAnswer(event: SubmitEvent, question: ProjectQuestionView) {
+  event.preventDefault();
+  if (busy) return;
+  const form = new FormData(event.currentTarget as HTMLFormElement);
+  const selectedOptionId = String(form.get('selectedOptionId') ?? '');
+  const structured = Boolean(question.options?.length);
+  if (structured && !selectedOptionId) return;
+  const option = question.options?.find(
+    (entry) => entry.id === selectedOptionId,
+  );
+  const answer =
+    structured && selectedOptionId !== 'other'
+      ? (option?.label ?? '')
+      : String(form.get('answer') ?? '').trim();
+  if (!answer) return;
+  pendingKey = `question:${question.id}`;
+  void onanswer?.({
+    id: question.id,
+    answer,
+    expectedRevision: question.revision,
+    ...(structured ? { selectedOptionId } : {}),
+  });
+}
+
+function submitDecision(event: SubmitEvent, decision: ProjectDecisionView) {
+  event.preventDefault();
+  if (busy) return;
+  const form = new FormData(event.currentTarget as HTMLFormElement);
+  const outcome = String(form.get('outcome') ?? '').trim();
+  if (!outcome) return;
+  pendingKey = `decision:${decision.id}`;
+  void ondecide?.({
+    id: decision.id,
+    outcome,
+    rationale: String(form.get('rationale') ?? '').trim(),
+    expectedRevision: decision.revision,
+  });
+}
+</script>
+
+<section
+  class="interview"
+  aria-label={t(M['projects.interview.aria'])}
+  data-smrt-component="ProjectInterview"
+  data-motion={reducedMotion ? 'off' : 'on'}
+>
+  {#if total === 0}
+    <p class="empty">{t(M['projects.interview.empty'])}</p>
+  {:else}
+    <div class="progress">
+      <p aria-live="polite">
+        {#if current}{t(M['projects.interview.progress'], { current: position + 1, total })} · {/if}{t(M['projects.interview.answered_count'], { answered: answeredCount, total })}
+      </p>
+      <progress value={answeredCount} max={total} aria-label={t(M['projects.interview.answered_count'], { answered: answeredCount, total })}></progress>
+    </div>
+
+    {#key current?.key ?? 'complete'}
+      <article class="step" data-interview-step={current?.key ?? 'complete'}>
+        {#if current}
+          {@const frame = framing[current.record.id] ?? {}}
+          {@const prompt = current.kind === 'question' ? current.record.prompt : current.record.question}
+          <h2 tabindex="-1" bind:this={heading}>{prompt}</h2>
+          {#if frame.why}
+            <div class="framing">
+              <h3>{t(M['projects.interview.why'])}</h3>
+              <p>{frame.why}</p>
+            </div>
+          {/if}
+          {#if frame.unblocks?.length}
+            <div class="framing">
+              <h3 id={`unblocks-${current.key}`}>{t(M['projects.interview.unblocks'])}</h3>
+              <ul aria-labelledby={`unblocks-${current.key}`}>
+                {#each frame.unblocks as label, index (`${index}:${label}`)}
+                  <li>{label}</li>
+                {/each}
+              </ul>
+            </div>
+          {/if}
+
+          {#if current.record.status !== 'open'}
+            <div class="recorded">
+              <h3>{t(M['projects.interview.recorded'])}</h3>
+              {#if current.kind === 'question'}
+                <p>{current.record.answer}</p>
+              {:else}
+                {@const decision = current.record}
+                <p>
+                  <strong>{decision.options?.find((option) => option.id === decision.outcome)?.label ?? decision.outcome}</strong>
+                  {#if decision.rationale}<span>{decision.rationale}</span>{/if}
+                </p>
+              {/if}
+            </div>
+          {:else if !current.record.canResolve}
+            <p class="empty">{t(M['projects.interview.not_yours'])}</p>
+          {:else if current.kind === 'question'}
+            {@const question = current.record}
+            {@const options = sortedOptions(question.options, frame.recommendedOptionId, true)}
+            <Form onsubmit={(event) => submitAnswer(event, question)}>
+              {#if options.length}
+                <fieldset disabled={busy}>
+                  <legend>{t(M['projects.interview.your_answer'])}</legend>
+                  {#each options as option (option.id)}
+                    <label class="choice" class:recommended={option.isRecommended}>
+                      <Input type="radio" name="selectedOptionId" value={option.id} required interaction={false} checked={selections[current.key] === option.id} onchange={() => (selections[current.key] = option.id)} />
+                      <span>{option.label}{#if option.isRecommended} <strong>{t(M['projects.governance.recommended'])}</strong>{/if}
+                        {#if option.description}<small>{option.description}</small>{/if}
+                      </span>
+                    </label>
+                  {/each}
+                  <label class="choice">
+                    <Input type="radio" name="selectedOptionId" value="other" required interaction={false} checked={selections[current.key] === 'other'} onchange={() => (selections[current.key] = 'other')} />
+                    <span>{t(M['projects.governance.other'])}</span>
+                  </label>
+                  <label for={`interview-answer-${question.id}`}>{t(M['projects.governance.other_answer'])}</label>
+                  <Textarea id={`interview-answer-${question.id}`} name="answer" required={selections[current.key] === 'other'}></Textarea>
+                </fieldset>
+              {:else}
+                <label for={`interview-answer-${question.id}`}>{t(M['projects.interview.your_answer'])}</label>
+                <Textarea id={`interview-answer-${question.id}`} name="answer" required disabled={busy}></Textarea>
+              {/if}
+              <Button type="submit" disabled={busy}>{t(M['projects.interview.submit'])}</Button>
+            </Form>
+          {:else}
+            {@const decision = current.record}
+            {@const options = sortedOptions(decision.options, frame.recommendedOptionId, false)}
+            <Form onsubmit={(event) => submitDecision(event, decision)}>
+              {#if options.length}
+                <fieldset disabled={busy}>
+                  <legend>{t(M['projects.interview.your_choice'])}</legend>
+                  {#each options as option (option.id)}
+                    <label class="choice" class:recommended={option.isRecommended}>
+                      <Input type="radio" name="outcome" value={option.id} required interaction={false} />
+                      <span>{option.label}{#if option.isRecommended} <strong>{t(M['projects.governance.recommended'])}</strong>{/if}
+                        {#if option.description}<small>{option.description}</small>{/if}
+                      </span>
+                    </label>
+                  {/each}
+                </fieldset>
+              {:else}
+                <label for={`interview-outcome-${decision.id}`}>{t(M['projects.interview.your_choice'])}</label>
+                <Input id={`interview-outcome-${decision.id}`} name="outcome" required disabled={busy} />
+              {/if}
+              <label for={`interview-rationale-${decision.id}`}>{t(M['projects.interview.notes'])}</label>
+              <Textarea id={`interview-rationale-${decision.id}`} name="rationale" disabled={busy}></Textarea>
+              <Button type="submit" disabled={busy}>{t(M['projects.interview.submit'])}</Button>
+            </Form>
+          {/if}
+
+          <nav class="navigation" aria-label={t(M['projects.interview.navigation'])}>
+            <Button type="button" variant="ghost" disabled={busy || position === 0} onclick={() => moveTo(position - 1, 'back')}>{t(M['projects.interview.back'])}</Button>
+            {#if current.record.status === 'open'}
+              <Button type="button" variant="ghost" disabled={busy} onclick={() => moveTo(position + 1, 'skip')}>{t(M['projects.interview.skip'])}</Button>
+            {:else}
+              <Button type="button" variant="ghost" disabled={busy} onclick={() => moveTo(firstOpenFrom(position + 1), 'next')}>{t(M['projects.interview.next'])}</Button>
+            {/if}
+          </nav>
+        {:else if openCount === 0}
+          <h2 tabindex="-1" bind:this={heading}>{t(M['projects.interview.complete_title'])}</h2>
+          <p>{t(M['projects.interview.complete_description'])}</p>
+          <nav class="navigation" aria-label={t(M['projects.interview.navigation'])}>
+            <Button type="button" variant="ghost" disabled={busy} onclick={() => moveTo(total - 1, 'back')}>{t(M['projects.interview.back'])}</Button>
+          </nav>
+        {:else}
+          <h2 tabindex="-1" bind:this={heading}>{t(M['projects.interview.remaining_title'])}</h2>
+          <p>{t(M['projects.interview.remaining_description'], { count: openCount })}</p>
+          <nav class="navigation" aria-label={t(M['projects.interview.navigation'])}>
+            <Button type="button" variant="ghost" disabled={busy} onclick={() => moveTo(total - 1, 'back')}>{t(M['projects.interview.back'])}</Button>
+            <Button type="button" disabled={busy} onclick={() => moveTo(firstOpenFrom(0), 'review')}>{t(M['projects.interview.review_skipped'])}</Button>
+          </nav>
+        {/if}
+      </article>
+    {/key}
+  {/if}
+</section>
+
+<style>
+@layer smrt.reset, smrt.structure, smrt.theme;
+@layer smrt.theme {
+  .interview { display: grid; gap: var(--smrt-spacing-4); max-width: 40rem; }
+  .progress { display: grid; gap: var(--smrt-spacing-2); }
+  .progress p, .step h2, .step h3, .step p { margin: 0; }
+  .progress p, .empty, .choice small { color: var(--smrt-color-on-surface-variant); }
+  .progress progress { width: 100%; }
+  .step { border: var(--smrt-hairline); border-radius: var(--smrt-radius-medium); display: grid; gap: var(--smrt-spacing-4); padding: var(--smrt-spacing-5); }
+  .step h2:focus { outline: none; }
+  .step h2:focus-visible { outline: var(--smrt-focus-ring-width) solid var(--smrt-focus-ring-color); outline-offset: var(--smrt-focus-ring-offset); }
+  .framing { display: grid; gap: var(--smrt-spacing-1); }
+  .framing h3, .recorded h3 { font-size: var(--smrt-typography-label-large-size); }
+  .framing ul { margin: 0; padding-inline-start: var(--smrt-spacing-5); }
+  .recorded p { display: grid; gap: var(--smrt-spacing-1); }
+  .step :global(form) { display: grid; gap: var(--smrt-spacing-3); }
+  .step :global(form button[type='submit']) { justify-self: start; }
+  fieldset { display: grid; gap: var(--smrt-spacing-2); border: 0; padding: 0; margin: 0; min-width: 0; }
+  legend { margin-bottom: var(--smrt-spacing-2); padding: 0; }
+  .choice { display: flex; align-items: start; gap: var(--smrt-spacing-2); }
+  .choice.recommended { font-weight: var(--smrt-typography-weight-medium, 500); }
+  .choice :global(input[type='radio']) { width: auto; min-height: auto; padding: 0; }
+  .choice small { display: block; }
+  .navigation { display: flex; flex-wrap: wrap; gap: var(--smrt-spacing-2); justify-content: space-between; }
+  @media (prefers-reduced-motion: no-preference) {
+    .interview[data-motion='on'] .step { animation: smrt-interview-enter 160ms ease-out; }
+  }
+  @keyframes smrt-interview-enter { from { opacity: 0; transform: translateY(0.25rem); } to { opacity: 1; transform: none; } }
+}
+</style>

package/dist/svelte/ProjectInterview.svelte.d.ts

@@ -0,0 +1,26 @@
+import type { ProjectDecisionResolveInput, ProjectDecisionView, ProjectInterviewAdvanceDetail, ProjectInterviewFraming, ProjectQuestionAnswerInput, ProjectQuestionView } from './project-governance-types.js';
+export interface Props {
+    /** Authorized questions, in the order the host wants them asked. */
+    questions?: ProjectQuestionView[];
+    /** Authorized decisions, asked after the questions in the host's order. */
+    decisions?: ProjectDecisionView[];
+    /** Disable submissions and navigation while the host saves a change. */
+    busy?: boolean;
+    /** Plain-language framing keyed by question or decision id. */
+    framing?: Record<string, ProjectInterviewFraming>;
+    /**
+     * Zero-based record to open first (e.g. a resumed position). Defaults to the
+     * first open record; read once on mount.
+     */
+    startIndex?: number;
+    /** Save an explicit answer with the observed revision. */
+    onanswer?: (input: ProjectQuestionAnswerInput) => void | Promise<void>;
+    /** Save a selected outcome and optional rationale with the observed revision. */
+    ondecide?: (input: ProjectDecisionResolveInput) => void | Promise<void>;
+    /** Called whenever the interview moves to another record or completes. */
+    onadvance?: (detail: ProjectInterviewAdvanceDetail) => void;
+}
+declare const ProjectInterview: import("svelte").Component<Props, {}, "">;
+type ProjectInterview = ReturnType<typeof ProjectInterview>;
+export default ProjectInterview;
+//# sourceMappingURL=ProjectInterview.svelte.d.ts.map

package/dist/svelte/ProjectInterview.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProjectInterview.svelte.d.ts","sourceRoot":"","sources":["../../src/svelte/ProjectInterview.svelte.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,2BAA2B,EAC3B,mBAAmB,EACnB,6BAA6B,EAC7B,uBAAuB,EACvB,0BAA0B,EAC1B,mBAAmB,EACpB,MAAM,+BAA+B,CAAC;AAGvC,MAAM,WAAW,KAAK;IACpB,oEAAoE;IACpE,SAAS,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAClC,2EAA2E;IAC3E,SAAS,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAClC,wEAAwE;IACxE,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;IAClD;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,0BAA0B,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvE,iFAAiF;IACjF,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,2BAA2B,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxE,0EAA0E;IAC1E,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,6BAA6B,KAAK,IAAI,CAAC;CAC7D;AA0UD,QAAA,MAAM,gBAAgB,2CAAwC,CAAC;AAC/D,KAAK,gBAAgB,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC5D,eAAe,gBAAgB,CAAC"}

package/dist/svelte/i18n.d.ts

@@ -18,6 +18,27 @@ export declare const M: {
     readonly 'projects.governance.choose_option': "projects.governance.choose_option";
     readonly 'projects.governance.rationale': "projects.governance.rationale";
     readonly 'projects.governance.record_decision': "projects.governance.record_decision";
+    readonly 'projects.interview.aria': "projects.interview.aria";
+    readonly 'projects.interview.progress': "projects.interview.progress";
+    readonly 'projects.interview.answered_count': "projects.interview.answered_count";
+    readonly 'projects.interview.why': "projects.interview.why";
+    readonly 'projects.interview.unblocks': "projects.interview.unblocks";
+    readonly 'projects.interview.your_answer': "projects.interview.your_answer";
+    readonly 'projects.interview.your_choice': "projects.interview.your_choice";
+    readonly 'projects.interview.notes': "projects.interview.notes";
+    readonly 'projects.interview.submit': "projects.interview.submit";
+    readonly 'projects.interview.navigation': "projects.interview.navigation";
+    readonly 'projects.interview.back': "projects.interview.back";
+    readonly 'projects.interview.skip': "projects.interview.skip";
+    readonly 'projects.interview.next': "projects.interview.next";
+    readonly 'projects.interview.recorded': "projects.interview.recorded";
+    readonly 'projects.interview.not_yours': "projects.interview.not_yours";
+    readonly 'projects.interview.empty': "projects.interview.empty";
+    readonly 'projects.interview.complete_title': "projects.interview.complete_title";
+    readonly 'projects.interview.complete_description': "projects.interview.complete_description";
+    readonly 'projects.interview.remaining_title': "projects.interview.remaining_title";
+    readonly 'projects.interview.remaining_description': "projects.interview.remaining_description";
+    readonly 'projects.interview.review_skipped': "projects.interview.review_skipped";
     readonly 'projects.development_request.type': "projects.development_request.type";
     readonly 'projects.development_request.feature': "projects.development_request.feature";
     readonly 'projects.development_request.bug': "projects.development_request.bug";

package/dist/svelte/i18n.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../../src/svelte/i18n.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8DZ,CAAC"}
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../../src/svelte/i18n.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsFZ,CAAC"}

package/dist/svelte/i18n.js

@@ -19,6 +19,27 @@ export const M = defineMessages({
     'projects.governance.choose_option': 'Select an option',
     'projects.governance.rationale': 'Rationale',
     'projects.governance.record_decision': 'Record decision',
+    'projects.interview.aria': 'Project interview',
+    'projects.interview.progress': 'Question {current} of {total}',
+    'projects.interview.answered_count': '{answered} of {total} answered',
+    'projects.interview.why': 'Why this matters',
+    'projects.interview.unblocks': 'What this unblocks',
+    'projects.interview.your_answer': 'Your answer',
+    'projects.interview.your_choice': 'Your choice',
+    'projects.interview.notes': 'Anything to add? (optional)',
+    'projects.interview.submit': 'Save and continue',
+    'projects.interview.navigation': 'Interview navigation',
+    'projects.interview.back': 'Back',
+    'projects.interview.skip': 'Skip for now',
+    'projects.interview.next': 'Next',
+    'projects.interview.recorded': 'Recorded answer',
+    'projects.interview.not_yours': 'Someone else on the project answers this one.',
+    'projects.interview.empty': 'There is nothing to answer right now.',
+    'projects.interview.complete_title': 'All done',
+    'projects.interview.complete_description': 'Thank you. Every question has an answer.',
+    'projects.interview.remaining_title': 'Almost there',
+    'projects.interview.remaining_description': '{count} skipped and still waiting for an answer.',
+    'projects.interview.review_skipped': 'Answer skipped questions',
     'projects.development_request.type': 'Request type',
     'projects.development_request.feature': 'Feature',
     'projects.development_request.bug': 'Bug',

package/dist/svelte/index.d.ts

@@ -19,9 +19,10 @@ import DevelopmentBoard from './DevelopmentBoard.svelte';
 import DevelopmentRequestDetail from './DevelopmentRequestDetail.svelte';
 import PreviewApprovalPanel from './PreviewApprovalPanel.svelte';
 import ProjectBoard from './ProjectBoard.svelte';
+import ProjectInterview from './ProjectInterview.svelte';
 import ProjectQuestionsAndDecisions from './ProjectQuestionsAndDecisions.svelte';
 import ServiceEvidenceList from './ServiceEvidenceList.svelte';
-export { ApprovalActions, AssistanceLauncher, BulkActions, DeliveryStatus, DevelopmentBoard, DevelopmentRequestDetail, DevelopmentRequestForm, DevelopmentRequestList, DurationDisplay, PreviewApprovalPanel, ProjectBoard, ProjectQuestionsAndDecisions, RejectDialog, ServiceEvidenceList, TimeEntryCard, TimeEntryList, TimeSummary, };
+export { ApprovalActions, AssistanceLauncher, BulkActions, DeliveryStatus, DevelopmentBoard, DevelopmentRequestDetail, DevelopmentRequestForm, DevelopmentRequestList, DurationDisplay, PreviewApprovalPanel, ProjectBoard, ProjectInterview, ProjectQuestionsAndDecisions, RejectDialog, ServiceEvidenceList, TimeEntryCard, TimeEntryList, TimeSummary, };
 export type ApprovalActionsProps = ComponentProps<typeof ApprovalActions>;
 export type AssistanceLauncherProps = ComponentProps<typeof AssistanceLauncher>;
 export type BulkActionsProps = ComponentProps<typeof BulkActions>;
@@ -33,11 +34,12 @@ export type DevelopmentRequestListProps = ComponentProps<typeof DevelopmentReque
 export type RejectDialogProps = ComponentProps<typeof RejectDialog>;
 export type PreviewApprovalPanelProps = ComponentProps<typeof PreviewApprovalPanel>;
 export type ProjectBoardProps = ComponentProps<typeof ProjectBoard>;
+export type ProjectInterviewProps = ComponentProps<typeof ProjectInterview>;
 export type ProjectQuestionsAndDecisionsProps = ComponentProps<typeof ProjectQuestionsAndDecisions>;
 export type ServiceEvidenceListProps = ComponentProps<typeof ServiceEvidenceList>;
 export type { DurationDisplayProps, TimeEntryCardProps, TimeEntryListProps, TimeSummaryProps, } from '@happyvertical/smrt-timesheets/svelte';
 export * from './delivery-types.js';
 export type { ProjectBoardMoveIntent } from './project-board-types.js';
-export type { ProjectDecisionResolveInput, ProjectDecisionView, ProjectQuestionAnswerInput, ProjectQuestionView, } from './project-governance-types.js';
+export type { ProjectDecisionResolveInput, ProjectDecisionView, ProjectInterviewAdvanceDetail, ProjectInterviewFraming, ProjectInterviewRecordKind, ProjectQuestionAnswerInput, ProjectQuestionView, } from './project-governance-types.js';
 export { type ApprovalStatus, type Currency, formatCurrency, formatDate, formatHours, formatHoursHHMM, statusColors, type TimeEntry, type TimeEntryStatus, } from './utils.js';
 //# sourceMappingURL=index.d.ts.map