@alneas/appkit-react 0.1.0 → 0.2.0

package/dist/ai/proposal/use-proposal-batch-review.d.ts

@@ -1,36 +1,162 @@
 import { ExecutionContext, ExecutionRecord, ApplyProposalPayload, FieldDecision, FieldKey, PreparedProposalBatch, ProposalBatchItem, ProposalBatchValidator, ReviewDecisions } from '@alneas/appkit-core/ai';
-/** Multi-record review. Each item must have a unique validated immutable proposal. */
+/**
+ * Host inputs for reviewing unique immutable proposals across multiple records.
+ *
+ * @typeParam TRecord - Record shape; defaults to a string-keyed record.
+ *
+ * @see useProposalBatchReview for usage.
+ */
 export interface UseProposalBatchReviewOptions<TRecord extends Record<string, any> = Record<string, any>> {
     /** Change for a new review session, including an intentional replay of the same proposals. */
     batchId: string;
+    /**
+     * Validated proposals and latest records/versions; proposal IDs must be unique.
+     */
     items: readonly ProposalBatchItem<TRecord>[];
+    /**
+     * Optional synchronous validator passed to Core batch preparation; thrown errors become invalid_candidate issues.
+     */
     validateCandidate?: ProposalBatchValidator<TRecord>;
-    /** Called sequentially. Resolve only when this row is applied; reject to stop the batch. */
+    /**
+     * Sequential host callback receiving one prepared payload and cooperative abort/progress context.
+     *
+     * @param payload - Validated candidate and decisions for one proposal.
+     *
+     * @param context - Abort signal and fractional-progress reporting for this row.
+     *
+     * @returns No value after the host confirms application; reject to stop later rows.
+     */
     onApply?: (payload: ApplyProposalPayload<TRecord>, context: ExecutionContext) => void | Promise<void>;
 }
-/** Headless controller shared by batch lists and custom application layouts. */
+/**
+ * Batch selection/decision state and explicit execution controls.
+ *
+ * @typeParam TRecord - Shared record shape; defaults to a string-keyed record.
+ *
+ * @see useProposalBatchReview for usage.
+ */
 export interface UseProposalBatchReviewReturn<TRecord extends Record<string, any> = Record<string, any>> {
+    /**
+     * Current selected proposal IDs; applied IDs are excluded from preparation.
+     */
     selectedIds: ReadonlySet<string>;
+    /**
+     * Host-confirmed successes in this review session.
+     */
     appliedIds: ReadonlySet<string>;
+    /**
+     * Per-proposal field decisions; absent choices remain pending.
+     */
     decisions: ReadonlyMap<string, ReviewDecisions<TRecord>>;
+    /**
+     * Core batch preflight result for current selection and latest input props.
+     */
     preparation: PreparedProposalBatch<TRecord>;
+    /**
+     * Whether a handler exists, preparation passes and state is not submitting.
+     */
     canApply: boolean;
+    /**
+     * Whether the displayed batch is currently running.
+     */
     isSubmitting: boolean;
+    /**
+     * Current row being applied, or null outside active row work.
+     */
     activeProposalId: string | null;
+    /**
+     * Generic current-session batch failure message, or null; raw host exceptions are not exposed.
+     */
     error: string | null;
+    /**
+     * Read-only execution history for this batch session.
+     */
     history: readonly ExecutionRecord[];
+    /**
+     * Select or deselect an editable known proposal.
+     *
+     * @param id - Proposal identifier.
+     *
+     * @param selected - Desired selection state.
+     *
+     * @returns No value; unknown/applied/busy proposals are ignored.
+     */
     setSelected(id: string, selected: boolean): void;
+    /**
+     * Change selection for the current items when idle.
+     *
+     * @param selected - True selects all current IDs; false retains only applied IDs in the selection set.
+     *
+     * @returns No value; calls while execution is busy are ignored.
+     */
     selectAll(selected: boolean): void;
+    /**
+     * Change one existing proposed field while editable.
+     *
+     * @param id - Proposal identifier.
+     *
+     * @param field - Field present in that proposal.
+     *
+     * @param decision - Pending, accepted or rejected choice.
+     *
+     * @returns No value; invalid IDs/fields and busy/applied proposals are ignored.
+     */
     setDecision(id: string, field: FieldKey<TRecord>, decision: FieldDecision): void;
+    /**
+     * Change every proposed field choice for one editable proposal.
+     *
+     * @param id - Proposal identifier.
+     *
+     * @param decision - Choice applied to all its changes.
+     *
+     * @returns No value; unknown/applied/busy proposals are ignored.
+     */
     decideAll(id: string, decision: FieldDecision): void;
+    /**
+     * Preflight the selection, then apply rows sequentially with latest-record rechecks.
+     *
+     * @returns True only for current-session complete success; false when blocked, failed, cancelled or superseded.
+     *
+     * @remarks Confirmed successes are retained and skipped on retry; unconfirmed backend effects may still exist.
+     */
     apply(): Promise<boolean>;
+    /**
+     * Request cooperative cancellation of current execution.
+     *
+     * @returns No value; does not roll back previously applied rows or force host work to stop.
+     */
     cancel(): void;
+    /**
+     * Clear settled execution history using the session policy.
+     *
+     * @returns No value; does not clear review choices or confirmed applied IDs.
+     */
     clearHistory(): void;
 }
 /**
- * Reviews multiple records without implicit field acceptance. Preflights the entire
- * selection, then rechecks each latest committed record immediately before applying it.
- * Stops on first failure or cancellation; confirmed successes are never retried within
- * this session.
+ * Reviews a batch with explicit field decisions and sequential host application.
+ *
+ * @typeParam TRecord - Record shape; defaults to a string-keyed record.
+ *
+ * @param options - Batch identity, unique immutable proposals/latest records, validation and optional host apply callback.
+ *
+ * @returns Selection/decision controls, preflight state, bounded execution history and cooperative cancellation.
+ *
+ * @remarks Requires React; no context/styles. Changing batchId or serialized proposal
+ * content starts a new session; unmount/session changes request cancellation. Each row
+ * is rechecked against latest committed host inputs before apply. Stops at the first
+ * failure/cancellation; successes remain excluded from retries. Cancellation cannot
+ * undo host effects, so persist idempotently and enforce concurrency/authorization in
+ * the backend. A row that changed the backend before rejecting has an uncertain outcome.
+ *
+ * @example
+ * ```tsx
+ * import { useProposalBatchReview, type UseProposalBatchReviewOptions } from '@alneas/appkit-react/ai/proposal';
+ * type RecordData = { title: string };
+ * export function Batch({ options }: { options: UseProposalBatchReviewOptions<RecordData> }) {
+ *   const review = useProposalBatchReview(options);
+ *   return <button disabled={!review.canApply} onClick={() => { void review.apply(); }}>Apply selected records</button>;
+ * }
+ * ```
  */
 export declare function useProposalBatchReview<TRecord extends Record<string, any> = Record<string, any>>(options: UseProposalBatchReviewOptions<TRecord>): UseProposalBatchReviewReturn<TRecord>;

package/dist/ai/proposal/use-proposal-batch-review.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-proposal-batch-review.js","names":["initial","createExecutionSession","useProposalBatchReview","key","options","item","stored","setStored","useState","state","session","live","useRef","latest","useLayoutEffect","current","history","useSyncExternalStore","busy","record","update","change","entries","items","applied","preparation","prepareProposalBatch","editable","id","next","value","selected","field","decision","planned","outcome","completed","payload","context","checked","fraction","progress"],"sources":["../../../src/ai/proposal/use-proposal-batch-review.ts"],"sourcesContent":["import { useLayoutEffect, useRef, useState, useSyncExternalStore } from 'react';\nimport { createExecutionSession, type ExecutionContext, type ExecutionRecord, type ExecutionSession } from \"@alneas/appkit-core/ai\";\nimport {\n  prepareProposalBatch,\n  type ApplyProposalPayload,\n  type FieldDecision,\n  type FieldKey,\n  type PreparedProposalBatch,\n  type ProposalBatchEntry,\n  type ProposalBatchItem,\n  type ProposalBatchValidator,\n  type ReviewDecisions,\n} from \"@alneas/appkit-core/ai\";\n\n/** Multi-record review. Each item must have a unique validated immutable proposal. */\nexport interface UseProposalBatchReviewOptions<TRecord extends Record<string, any> = Record<string, any>> {\n  /** Change for a new review session, including an intentional replay of the same proposals. */\n  batchId: string;\n  items: readonly ProposalBatchItem<TRecord>[];\n  validateCandidate?: ProposalBatchValidator<TRecord>;\n  /** Called sequentially. Resolve only when this row is applied; reject to stop the batch. */\n  onApply?: (payload: ApplyProposalPayload<TRecord>, context: ExecutionContext) => void | Promise<void>;\n}\n\n/** Headless controller shared by batch lists and custom application layouts. */\nexport interface UseProposalBatchReviewReturn<TRecord extends Record<string, any> = Record<string, any>> {\n  selectedIds: ReadonlySet<string>;\n  appliedIds: ReadonlySet<string>;\n  decisions: ReadonlyMap<string, ReviewDecisions<TRecord>>;\n  preparation: PreparedProposalBatch<TRecord>;\n  canApply: boolean;\n  isSubmitting: boolean;\n  activeProposalId: string | null;\n  error: string | null;\n  history: readonly ExecutionRecord[];\n  setSelected(id: string, selected: boolean): void;\n  selectAll(selected: boolean): void;\n  setDecision(id: string, field: FieldKey<TRecord>, decision: FieldDecision): void;\n  decideAll(id: string, decision: FieldDecision): void;\n  apply(): Promise<boolean>;\n  cancel(): void;\n  clearHistory(): void;\n}\n\ninterface ReviewState<TRecord extends Record<string, any>> {\n  key: string;\n  session: ExecutionSession;\n  selected: ReadonlySet<string>;\n  applied: ReadonlySet<string>;\n  decisions: ReadonlyMap<string, ReviewDecisions<TRecord>>;\n  running: boolean;\n  active: string | null;\n  error: string | null;\n}\n\nfunction initial<TRecord extends Record<string, any>>(key: string): ReviewState<TRecord> {\n  return {\n    key,\n    session: createExecutionSession(),\n    selected: new Set(),\n    applied: new Set(),\n    decisions: new Map(),\n    running: false,\n    active: null,\n    error: null,\n  };\n}\n\n/**\n * Reviews multiple records without implicit field acceptance. Preflights the entire\n * selection, then rechecks each latest committed record immediately before applying it.\n * Stops on first failure or cancellation; confirmed successes are never retried within\n * this session.\n */\nexport function useProposalBatchReview<TRecord extends Record<string, any> = Record<string, any>>(\n  options: UseProposalBatchReviewOptions<TRecord>\n): UseProposalBatchReviewReturn<TRecord> {\n  const key = JSON.stringify([options.batchId, options.items.map(item => JSON.stringify(item.proposal)).sort()]);\n  const [stored, setStored] = useState(() => initial<TRecord>(key));\n  let state = stored;\n  if (state.key !== key) {\n    state = initial<TRecord>(key);\n    setStored(state);\n  }\n  const session = state.session;\n  const live = useRef<{ session: ExecutionSession; applied: Set<string> } | null>(null);\n  const latest = useRef(options);\n  useLayoutEffect(() => {\n    latest.current = options;\n  });\n  useLayoutEffect(() => {\n    const current = { session, applied: new Set<string>() };\n    live.current = current;\n    return () => {\n      session.cancel();\n      if (live.current === current) live.current = null;\n    };\n  }, [session]);\n\n  const history = useSyncExternalStore(session.subscribe, session.getSnapshot, session.getSnapshot);\n  const busy = () => session.getSnapshot().some(record => record.status === 'running' || record.status === 'cancelling');\n  const update = (change: (current: ReviewState<TRecord>) => ReviewState<TRecord>) => {\n    setStored(current => (current.session === session ? change(current) : current));\n  };\n\n  const entries = (\n    items: readonly ProposalBatchItem<TRecord>[],\n    applied: ReadonlySet<string>\n  ): ProposalBatchEntry<TRecord>[] =>\n    items.map(item => ({\n      ...item,\n      decisions: state.decisions.get(item.proposal.id) ?? ({} as ReviewDecisions<TRecord>),\n      selected: state.selected.has(item.proposal.id) && !applied.has(item.proposal.id),\n    }));\n\n  const preparation = prepareProposalBatch(entries(options.items, state.applied), options.validateCandidate);\n  const editable = (id: string) =>\n    live.current?.session === session && !busy() && !live.current.applied.has(id) && options.items.some(item => item.proposal.id === id);\n\n  const apply = async (): Promise<boolean> => {\n    const current = live.current;\n    if (!current || current.session !== session || busy() || !latest.current.onApply) return false;\n    const planned = prepareProposalBatch(entries(latest.current.items, current.applied), latest.current.validateCandidate);\n    if (!planned.canApply) return false;\n    update(value => ({ ...value, running: true, error: null }));\n    const outcome = await session.run(`一括適用 ${planned.payloads.length} 件`, async context => {\n      context.reportProgress({ completed: 0, total: planned.payloads.length });\n      let completed = 0;\n      for (const payload of planned.payloads) {\n        context.signal.throwIfAborted();\n        if (live.current !== current) throw new DOMException('Review session changed', 'AbortError');\n        const item = latest.current.items.find(value => value.proposal.id === payload.proposalId);\n        if (!item) throw new Error('対象の提案が見つかりません。再確認してください。');\n        const checked = prepareProposalBatch(\n          [{ ...item, selected: true, decisions: state.decisions.get(payload.proposalId) ?? ({} as ReviewDecisions<TRecord>) }],\n          latest.current.validateCandidate\n        );\n        if (!checked.canApply || !latest.current.onApply) {\n          throw new Error('適用前にデータが変更されたため停止しました。再確認してください。');\n        }\n        update(value => ({ ...value, active: payload.proposalId }));\n        await latest.current.onApply(checked.payloads[0], {\n          signal: context.signal,\n          reportProgress(progress) {\n            const fraction =\n              progress.total && Number.isFinite(progress.total) && Number.isFinite(progress.completed)\n                ? Math.max(0, Math.min(1, progress.completed / progress.total))\n                : 0;\n            context.reportProgress({\n              completed: completed + fraction,\n              total: planned.payloads.length,\n              message: progress.message,\n            });\n          },\n        });\n        if (live.current !== current) throw new DOMException('Review session changed', 'AbortError');\n        current.applied.add(payload.proposalId);\n        update(value => ({ ...value, applied: new Set(current.applied) }));\n        context.reportProgress({ completed: ++completed, total: planned.payloads.length });\n      }\n    });\n    if (live.current !== current) return false;\n    update(value => ({\n      ...value,\n      running: false,\n      active: null,\n      error: outcome.status === 'failed' ? '適用に失敗しました。成功済みの提案を除いて再試行できます。' : null,\n    }));\n    return outcome.status === 'succeeded';\n  };\n\n  return {\n    selectedIds: state.selected,\n    appliedIds: state.applied,\n    decisions: state.decisions,\n    preparation,\n    canApply: !!options.onApply && preparation.canApply && !state.running,\n    isSubmitting: state.running,\n    activeProposalId: state.active,\n    error: state.error,\n    history,\n    setSelected(id, selected) {\n      if (!editable(id)) return;\n      update(value => {\n        const next = new Set(value.selected);\n        if (selected) next.add(id);\n        else next.delete(id);\n        return { ...value, selected: next, error: null };\n      });\n    },\n    selectAll(selected) {\n      if (busy()) return;\n      update(value => ({\n        ...value,\n        selected: new Set(selected ? options.items.map(item => item.proposal.id) : value.applied),\n        error: null,\n      }));\n    },\n    setDecision(id, field, decision) {\n      if (!editable(id) || !options.items.find(item => item.proposal.id === id)?.proposal.changes.some(change => change.field === field)) return;\n      update(value => ({\n        ...value,\n        decisions: new Map(value.decisions).set(id, {\n          ...value.decisions.get(id),\n          [field]: decision,\n        } as ReviewDecisions<TRecord>),\n        error: null,\n      }));\n    },\n    decideAll(id, decision) {\n      if (!editable(id)) return;\n      const item = options.items.find(value => value.proposal.id === id)!;\n      update(value => ({\n        ...value,\n        decisions: new Map(value.decisions).set(\n          id,\n          Object.fromEntries(item.proposal.changes.map(change => [change.field, decision])) as ReviewDecisions<TRecord>\n        ),\n        error: null,\n      }));\n    },\n    apply,\n    cancel: session.cancel,\n    clearHistory: session.clearHistory,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"use-proposal-batch-review.js","names":["initial","createExecutionSession","useProposalBatchReview","key","options","item","stored","setStored","useState","state","session","live","useRef","latest","useLayoutEffect","current","history","useSyncExternalStore","busy","record","update","change","entries","items","applied","preparation","prepareProposalBatch","editable","id","next","value","selected","field","decision","planned","outcome","completed","payload","context","checked","fraction","progress"],"sources":["../../../src/ai/proposal/use-proposal-batch-review.ts"],"sourcesContent":["import { useLayoutEffect, useRef, useState, useSyncExternalStore } from 'react';\nimport { createExecutionSession, type ExecutionContext, type ExecutionRecord, type ExecutionSession } from \"@alneas/appkit-core/ai\";\nimport {\n  prepareProposalBatch,\n  type ApplyProposalPayload,\n  type FieldDecision,\n  type FieldKey,\n  type PreparedProposalBatch,\n  type ProposalBatchEntry,\n  type ProposalBatchItem,\n  type ProposalBatchValidator,\n  type ReviewDecisions,\n} from \"@alneas/appkit-core/ai\";\n\n/**\n * Host inputs for reviewing unique immutable proposals across multiple records.\n *\n * @typeParam TRecord - Record shape; defaults to a string-keyed record.\n *\n * @see useProposalBatchReview for usage.\n */\nexport interface UseProposalBatchReviewOptions<TRecord extends Record<string, any> = Record<string, any>> {\n  /** Change for a new review session, including an intentional replay of the same proposals. */\n  batchId: string;\n  /**\n   * Validated proposals and latest records/versions; proposal IDs must be unique.\n   */\n  items: readonly ProposalBatchItem<TRecord>[];\n  /**\n   * Optional synchronous validator passed to Core batch preparation; thrown errors become invalid_candidate issues.\n   */\n  validateCandidate?: ProposalBatchValidator<TRecord>;\n    /**\n     * Sequential host callback receiving one prepared payload and cooperative abort/progress context.\n     *\n     * @param payload - Validated candidate and decisions for one proposal.\n     *\n     * @param context - Abort signal and fractional-progress reporting for this row.\n     *\n     * @returns No value after the host confirms application; reject to stop later rows.\n     */\n  onApply?: (payload: ApplyProposalPayload<TRecord>, context: ExecutionContext) => void | Promise<void>;\n}\n\n/**\n * Batch selection/decision state and explicit execution controls.\n *\n * @typeParam TRecord - Shared record shape; defaults to a string-keyed record.\n *\n * @see useProposalBatchReview for usage.\n */\nexport interface UseProposalBatchReviewReturn<TRecord extends Record<string, any> = Record<string, any>> {\n  /**\n   * Current selected proposal IDs; applied IDs are excluded from preparation.\n   */\n  selectedIds: ReadonlySet<string>;\n  /**\n   * Host-confirmed successes in this review session.\n   */\n  appliedIds: ReadonlySet<string>;\n  /**\n   * Per-proposal field decisions; absent choices remain pending.\n   */\n  decisions: ReadonlyMap<string, ReviewDecisions<TRecord>>;\n  /**\n   * Core batch preflight result for current selection and latest input props.\n   */\n  preparation: PreparedProposalBatch<TRecord>;\n  /**\n   * Whether a handler exists, preparation passes and state is not submitting.\n   */\n  canApply: boolean;\n  /**\n   * Whether the displayed batch is currently running.\n   */\n  isSubmitting: boolean;\n  /**\n   * Current row being applied, or null outside active row work.\n   */\n  activeProposalId: string | null;\n  /**\n   * Generic current-session batch failure message, or null; raw host exceptions are not exposed.\n   */\n  error: string | null;\n  /**\n   * Read-only execution history for this batch session.\n   */\n  history: readonly ExecutionRecord[];\n  /**\n   * Select or deselect an editable known proposal.\n   *\n   * @param id - Proposal identifier.\n   *\n   * @param selected - Desired selection state.\n   *\n   * @returns No value; unknown/applied/busy proposals are ignored.\n   */\n  setSelected(id: string, selected: boolean): void;\n  /**\n   * Change selection for the current items when idle.\n   *\n   * @param selected - True selects all current IDs; false retains only applied IDs in the selection set.\n   *\n   * @returns No value; calls while execution is busy are ignored.\n   */\n  selectAll(selected: boolean): void;\n  /**\n   * Change one existing proposed field while editable.\n   *\n   * @param id - Proposal identifier.\n   *\n   * @param field - Field present in that proposal.\n   *\n   * @param decision - Pending, accepted or rejected choice.\n   *\n   * @returns No value; invalid IDs/fields and busy/applied proposals are ignored.\n   */\n  setDecision(id: string, field: FieldKey<TRecord>, decision: FieldDecision): void;\n  /**\n   * Change every proposed field choice for one editable proposal.\n   *\n   * @param id - Proposal identifier.\n   *\n   * @param decision - Choice applied to all its changes.\n   *\n   * @returns No value; unknown/applied/busy proposals are ignored.\n   */\n  decideAll(id: string, decision: FieldDecision): void;\n  /**\n   * Preflight the selection, then apply rows sequentially with latest-record rechecks.\n   *\n   * @returns True only for current-session complete success; false when blocked, failed, cancelled or superseded.\n   *\n   * @remarks Confirmed successes are retained and skipped on retry; unconfirmed backend effects may still exist.\n   */\n  apply(): Promise<boolean>;\n  /**\n   * Request cooperative cancellation of current execution.\n   *\n   * @returns No value; does not roll back previously applied rows or force host work to stop.\n   */\n  cancel(): void;\n  /**\n   * Clear settled execution history using the session policy.\n   *\n   * @returns No value; does not clear review choices or confirmed applied IDs.\n   */\n  clearHistory(): void;\n}\n\ninterface ReviewState<TRecord extends Record<string, any>> {\n  key: string;\n  session: ExecutionSession;\n  selected: ReadonlySet<string>;\n  applied: ReadonlySet<string>;\n  decisions: ReadonlyMap<string, ReviewDecisions<TRecord>>;\n  running: boolean;\n  active: string | null;\n  error: string | null;\n}\n\nfunction initial<TRecord extends Record<string, any>>(key: string): ReviewState<TRecord> {\n  return {\n    key,\n    session: createExecutionSession(),\n    selected: new Set(),\n    applied: new Set(),\n    decisions: new Map(),\n    running: false,\n    active: null,\n    error: null,\n  };\n}\n\n/**\n * Reviews a batch with explicit field decisions and sequential host application.\n *\n * @typeParam TRecord - Record shape; defaults to a string-keyed record.\n *\n * @param options - Batch identity, unique immutable proposals/latest records, validation and optional host apply callback.\n *\n * @returns Selection/decision controls, preflight state, bounded execution history and cooperative cancellation.\n *\n * @remarks Requires React; no context/styles. Changing batchId or serialized proposal\n * content starts a new session; unmount/session changes request cancellation. Each row\n * is rechecked against latest committed host inputs before apply. Stops at the first\n * failure/cancellation; successes remain excluded from retries. Cancellation cannot\n * undo host effects, so persist idempotently and enforce concurrency/authorization in\n * the backend. A row that changed the backend before rejecting has an uncertain outcome.\n *\n * @example\n * ```tsx\n * import { useProposalBatchReview, type UseProposalBatchReviewOptions } from '@alneas/appkit-react/ai/proposal';\n * type RecordData = { title: string };\n * export function Batch({ options }: { options: UseProposalBatchReviewOptions<RecordData> }) {\n *   const review = useProposalBatchReview(options);\n *   return <button disabled={!review.canApply} onClick={() => { void review.apply(); }}>Apply selected records</button>;\n * }\n * ```\n */\nexport function useProposalBatchReview<TRecord extends Record<string, any> = Record<string, any>>(\n  options: UseProposalBatchReviewOptions<TRecord>\n): UseProposalBatchReviewReturn<TRecord> {\n  const key = JSON.stringify([options.batchId, options.items.map(item => JSON.stringify(item.proposal)).sort()]);\n  const [stored, setStored] = useState(() => initial<TRecord>(key));\n  let state = stored;\n  if (state.key !== key) {\n    state = initial<TRecord>(key);\n    setStored(state);\n  }\n  const session = state.session;\n  const live = useRef<{ session: ExecutionSession; applied: Set<string> } | null>(null);\n  const latest = useRef(options);\n  useLayoutEffect(() => {\n    latest.current = options;\n  });\n  useLayoutEffect(() => {\n    const current = { session, applied: new Set<string>() };\n    live.current = current;\n    return () => {\n      session.cancel();\n      if (live.current === current) live.current = null;\n    };\n  }, [session]);\n\n  const history = useSyncExternalStore(session.subscribe, session.getSnapshot, session.getSnapshot);\n  const busy = () => session.getSnapshot().some(record => record.status === 'running' || record.status === 'cancelling');\n  const update = (change: (current: ReviewState<TRecord>) => ReviewState<TRecord>) => {\n    setStored(current => (current.session === session ? change(current) : current));\n  };\n\n  const entries = (\n    items: readonly ProposalBatchItem<TRecord>[],\n    applied: ReadonlySet<string>\n  ): ProposalBatchEntry<TRecord>[] =>\n    items.map(item => ({\n      ...item,\n      decisions: state.decisions.get(item.proposal.id) ?? ({} as ReviewDecisions<TRecord>),\n      selected: state.selected.has(item.proposal.id) && !applied.has(item.proposal.id),\n    }));\n\n  const preparation = prepareProposalBatch(entries(options.items, state.applied), options.validateCandidate);\n  const editable = (id: string) =>\n    live.current?.session === session && !busy() && !live.current.applied.has(id) && options.items.some(item => item.proposal.id === id);\n\n  const apply = async (): Promise<boolean> => {\n    const current = live.current;\n    if (!current || current.session !== session || busy() || !latest.current.onApply) return false;\n    const planned = prepareProposalBatch(entries(latest.current.items, current.applied), latest.current.validateCandidate);\n    if (!planned.canApply) return false;\n    update(value => ({ ...value, running: true, error: null }));\n    const outcome = await session.run(`一括適用 ${planned.payloads.length} 件`, async context => {\n      context.reportProgress({ completed: 0, total: planned.payloads.length });\n      let completed = 0;\n      for (const payload of planned.payloads) {\n        context.signal.throwIfAborted();\n        if (live.current !== current) throw new DOMException('Review session changed', 'AbortError');\n        const item = latest.current.items.find(value => value.proposal.id === payload.proposalId);\n        if (!item) throw new Error('対象の提案が見つかりません。再確認してください。');\n        const checked = prepareProposalBatch(\n          [{ ...item, selected: true, decisions: state.decisions.get(payload.proposalId) ?? ({} as ReviewDecisions<TRecord>) }],\n          latest.current.validateCandidate\n        );\n        if (!checked.canApply || !latest.current.onApply) {\n          throw new Error('適用前にデータが変更されたため停止しました。再確認してください。');\n        }\n        update(value => ({ ...value, active: payload.proposalId }));\n        await latest.current.onApply(checked.payloads[0], {\n          signal: context.signal,\n          reportProgress(progress) {\n            const fraction =\n              progress.total && Number.isFinite(progress.total) && Number.isFinite(progress.completed)\n                ? Math.max(0, Math.min(1, progress.completed / progress.total))\n                : 0;\n            context.reportProgress({\n              completed: completed + fraction,\n              total: planned.payloads.length,\n              message: progress.message,\n            });\n          },\n        });\n        if (live.current !== current) throw new DOMException('Review session changed', 'AbortError');\n        current.applied.add(payload.proposalId);\n        update(value => ({ ...value, applied: new Set(current.applied) }));\n        context.reportProgress({ completed: ++completed, total: planned.payloads.length });\n      }\n    });\n    if (live.current !== current) return false;\n    update(value => ({\n      ...value,\n      running: false,\n      active: null,\n      error: outcome.status === 'failed' ? '適用に失敗しました。成功済みの提案を除いて再試行できます。' : null,\n    }));\n    return outcome.status === 'succeeded';\n  };\n\n  return {\n    selectedIds: state.selected,\n    appliedIds: state.applied,\n    decisions: state.decisions,\n    preparation,\n    canApply: !!options.onApply && preparation.canApply && !state.running,\n    isSubmitting: state.running,\n    activeProposalId: state.active,\n    error: state.error,\n    history,\n    setSelected(id, selected) {\n      if (!editable(id)) return;\n      update(value => {\n        const next = new Set(value.selected);\n        if (selected) next.add(id);\n        else next.delete(id);\n        return { ...value, selected: next, error: null };\n      });\n    },\n    selectAll(selected) {\n      if (busy()) return;\n      update(value => ({\n        ...value,\n        selected: new Set(selected ? options.items.map(item => item.proposal.id) : value.applied),\n        error: null,\n      }));\n    },\n    setDecision(id, field, decision) {\n      if (!editable(id) || !options.items.find(item => item.proposal.id === id)?.proposal.changes.some(change => change.field === field)) return;\n      update(value => ({\n        ...value,\n        decisions: new Map(value.decisions).set(id, {\n          ...value.decisions.get(id),\n          [field]: decision,\n        } as ReviewDecisions<TRecord>),\n        error: null,\n      }));\n    },\n    decideAll(id, decision) {\n      if (!editable(id)) return;\n      const item = options.items.find(value => value.proposal.id === id)!;\n      update(value => ({\n        ...value,\n        decisions: new Map(value.decisions).set(\n          id,\n          Object.fromEntries(item.proposal.changes.map(change => [change.field, decision])) as ReviewDecisions<TRecord>\n        ),\n        error: null,\n      }));\n    },\n    apply,\n    cancel: session.cancel,\n    clearHistory: session.clearHistory,\n  };\n}\n"],"mappings":"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"}

package/dist/ai/proposal/use-proposal-review.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-proposal-review.cjs","names":["useState","useRef","useCallback","useMemo","buildCandidateRecord","verifyCurrentState","computeReviewStatus","canApplyProposal","buildApplyPayload","react","_alneas_appkit_core_ai","useProposalReview","options","activeProposalId","setActiveProposalId","proposal","rawDecisions","setRawDecisions","isSubmitting","setIsSubmitting","saveError","setSaveError","displayGeneration","setDisplayGeneration","displayGenerationRef","executionTokenRef","isExecutingLockRef","decisions","prev","setDecision","field","decision","acceptAll","next","change","rejectAll","resetDecisions","candidateRecord","currentRecord","consistency","currentVersion","candidateValidation","validateCandidate","reviewStatus","canApply","onApply","handleApply","executionGen","currentToken","payload","err","message"],"sources":["../../../src/ai/proposal/use-proposal-review.ts"],"sourcesContent":["'use client';\n\nimport { useState, useMemo, useCallback, useRef, useEffect } from 'react';\nimport {\n  buildApplyPayload,\n  buildCandidateRecord,\n  canApplyProposal,\n  computeReviewStatus,\n  verifyCurrentState,\n} from \"@alneas/appkit-core/ai\";\nimport type {\n  CandidateValidationResult,\n  FieldDecision,\n  FieldKey,\n  RecordProposal,\n  ReviewDecisions,\n} from \"@alneas/appkit-core/ai\";\nimport type { ProposalReviewCardProps, UseProposalReviewReturn } from './types';\n\n/** Options for useProposalReview hook. */\nexport interface UseProposalReviewOptions<\n  TRecord extends Record<string, any> = Record<string, any>,\n> {\n  proposal: RecordProposal<TRecord>;\n  currentRecord: TRecord;\n  currentVersion: string | number;\n  validateCandidate?: (candidate: TRecord) => CandidateValidationResult;\n  onApply?: ProposalReviewCardProps<TRecord>['onApply'];\n}\n\n/**\n * 変更提案のレビュー状態を管理するカスタムフック\n *\n * @template TRecord レコード型\n * @param options フックオプション\n * @returns レビュー状態と操作ハンドラ\n */\nexport function useProposalReview<\n  TRecord extends Record<string, any> = Record<string, any>,\n>(options: UseProposalReviewOptions<TRecord>): UseProposalReviewReturn<TRecord> {\n  const { proposal, currentRecord, currentVersion, validateCandidate, onApply } = options;\n\n  // 提案切替（proposal.id 変更）の検知用\n  const [activeProposalId, setActiveProposalId] = useState<string>(proposal.id);\n  const [rawDecisions, setRawDecisions] = useState<ReviewDecisions<TRecord>>(\n    {} as ReviewDecisions<TRecord>\n  );\n  const [isSubmitting, setIsSubmitting] = useState(false);\n  const [saveError, setSaveError] = useState<string | null>(null);\n\n  // 表示世代カウンター: 提案切替（A→B, B→A など）のたびにインクリメント\n  const [displayGeneration, setDisplayGeneration] = useState<number>(1);\n  const displayGenerationRef = useRef<number>(1);\n\n  // 実行トークン: 適用実行ごとに一意なトークンをインクリメント\n  const executionTokenRef = useRef<number>(0);\n  // 同期実行ロック: 再レンダー完了前の高速な連続クリック（二重実行）を同期的にブロック\n  const isExecutingLockRef = useRef<boolean>(false);\n\n  // プロジェクト標準ルール: 「No synchronous setState in useEffect」\n  // 提案 ID が切り替わった場合、レンダー中に状態を初期化して同期ズレを防ぐ\n  let decisions = rawDecisions;\n  if (proposal.id !== activeProposalId) {\n    setActiveProposalId(proposal.id);\n    setRawDecisions({} as ReviewDecisions<TRecord>);\n    setSaveError(null);\n    setIsSubmitting(false);\n    setDisplayGeneration((prev) => prev + 1);\n    decisions = {} as ReviewDecisions<TRecord>;\n  }\n\n  // 提案が切り替わった場合、実行ロックを非同期完了を待たずに解除し、表示世代Refを同期\n  useEffect(() => {\n    displayGenerationRef.current = displayGeneration;\n    isExecutingLockRef.current = false;\n  }, [displayGeneration]);\n\n  // 個別フィールド決定の更新\n  const setDecision = useCallback((field: FieldKey<TRecord>, decision: FieldDecision) => {\n    setRawDecisions((prev) => ({\n      ...prev,\n      [field]: decision,\n    }));\n    setSaveError(null);\n  }, []);\n\n  // 全採用\n  const acceptAll = useCallback(() => {\n    const next: Partial<Record<FieldKey<TRecord>, FieldDecision>> = {};\n    for (const change of proposal.changes) {\n      next[change.field] = 'accepted';\n    }\n    setRawDecisions(next);\n    setSaveError(null);\n  }, [proposal.changes]);\n\n  // 全却下\n  const rejectAll = useCallback(() => {\n    const next: Partial<Record<FieldKey<TRecord>, FieldDecision>> = {};\n    for (const change of proposal.changes) {\n      next[change.field] = 'rejected';\n    }\n    setRawDecisions(next);\n    setSaveError(null);\n  }, [proposal.changes]);\n\n  // リセット（全 pending）\n  const resetDecisions = useCallback(() => {\n    setRawDecisions({} as ReviewDecisions<TRecord>);\n    setSaveError(null);\n  }, []);\n\n  // 候補レコードの合成（不変・純粋関数）\n  const candidateRecord = useMemo(() => {\n    return buildCandidateRecord(currentRecord, proposal, decisions);\n  }, [currentRecord, proposal, decisions]);\n\n  // 現在値およびバージョンとの整合性検査\n  const consistency = useMemo(() => {\n    return verifyCurrentState(currentRecord, currentVersion, proposal, decisions);\n  }, [currentRecord, currentVersion, proposal, decisions]);\n\n  // 候補レコード全体のカスタム検証（相関チェック等）\n  const candidateValidation = useMemo(() => {\n    if (!validateCandidate) return undefined;\n    return validateCandidate(candidateRecord);\n  }, [validateCandidate, candidateRecord]);\n\n  // 全体のレビュー状態（派生値）\n  const reviewStatus = useMemo(() => {\n    return computeReviewStatus(proposal, decisions);\n  }, [proposal, decisions]);\n\n  // 適用可能かどうかの判定（onApply が指定されていることも条件）\n  const canApply = useMemo(() => {\n    if (!onApply) return false;\n    return canApplyProposal({\n      proposal,\n      decisions,\n      consistency,\n      candidateValidation,\n    });\n  }, [onApply, proposal, decisions, consistency, candidateValidation]);\n\n  // 適用実行ハンドラ（提案世代・トークン・同期ロックによる完全隔離）\n  const handleApply = useCallback(async (): Promise<boolean> => {\n    // 1. 同期ロックおよび適用可否チェック（再レンダー前の重複実行も防止）\n    if (!canApply || isExecutingLockRef.current || !onApply) {\n      return false;\n    }\n\n    isExecutingLockRef.current = true;\n    const executionGen = displayGenerationRef.current;\n    const currentToken = ++executionTokenRef.current;\n\n    setIsSubmitting(true);\n    setSaveError(null);\n\n    try {\n      const payload = buildApplyPayload({\n        proposal,\n        candidateRecord,\n        decisions,\n      });\n\n      await onApply(payload);\n\n      // 非同期完了時: 表示世代および実行トークンが現在と一致している場合のみ状態を更新\n      if (\n        displayGenerationRef.current === executionGen &&\n        executionTokenRef.current === currentToken\n      ) {\n        setIsSubmitting(false);\n        setSaveError(null);\n        isExecutingLockRef.current = false;\n        return true;\n      }\n      return false;\n    } catch (err) {\n      // 非同期失敗時: 表示世代および実行トークンが現在と一致している場合のみエラーを設定\n      if (\n        displayGenerationRef.current === executionGen &&\n        executionTokenRef.current === currentToken\n      ) {\n        setIsSubmitting(false);\n        const message = err instanceof Error ? err.message : '適用の保存中にエラーが発生しました';\n        setSaveError(message);\n        isExecutingLockRef.current = false;\n      }\n      return false;\n    } finally {\n      // 過去世代の結果が遅れて完了した場合の finally では、現在のロックを解除しない\n      if (\n        displayGenerationRef.current === executionGen &&\n        executionTokenRef.current === currentToken\n      ) {\n        isExecutingLockRef.current = false;\n      }\n    }\n  }, [canApply, onApply, proposal, candidateRecord, decisions]);\n\n  return {\n    decisions,\n    setDecision,\n    acceptAll,\n    rejectAll,\n    resetDecisions,\n    candidateRecord,\n    reviewStatus,\n    consistency,\n    candidateValidation,\n    canApply,\n    isSubmitting,\n    saveError,\n    handleApply,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"use-proposal-review.cjs","names":["useState","useRef","useCallback","useMemo","buildCandidateRecord","verifyCurrentState","computeReviewStatus","canApplyProposal","buildApplyPayload","react","_alneas_appkit_core_ai","useProposalReview","options","activeProposalId","setActiveProposalId","proposal","rawDecisions","setRawDecisions","isSubmitting","setIsSubmitting","saveError","setSaveError","displayGeneration","setDisplayGeneration","displayGenerationRef","executionTokenRef","isExecutingLockRef","decisions","prev","setDecision","field","decision","acceptAll","next","change","rejectAll","resetDecisions","candidateRecord","currentRecord","consistency","currentVersion","candidateValidation","validateCandidate","reviewStatus","canApply","onApply","handleApply","executionGen","currentToken","payload","err","message"],"sources":["../../../src/ai/proposal/use-proposal-review.ts"],"sourcesContent":["'use client';\n\nimport { useState, useMemo, useCallback, useRef, useEffect } from 'react';\nimport {\n  buildApplyPayload,\n  buildCandidateRecord,\n  canApplyProposal,\n  computeReviewStatus,\n  verifyCurrentState,\n} from \"@alneas/appkit-core/ai\";\nimport type {\n  CandidateValidationResult,\n  FieldDecision,\n  FieldKey,\n  RecordProposal,\n  ReviewDecisions,\n} from \"@alneas/appkit-core/ai\";\nimport type { ProposalReviewCardProps, UseProposalReviewReturn } from './types';\n\n/**\n * Host inputs for one immutable change proposal.\n *\n * @typeParam TRecord - Record shape; defaults to a string-keyed record.\n *\n * @see useProposalReview for complete usage.\n */\nexport interface UseProposalReviewOptions<\n  TRecord extends Record<string, any> = Record<string, any>,\n> {\n  /**\n   * Validated immutable proposal; a new id starts a new review generation.\n   */\n  proposal: RecordProposal<TRecord>;\n  /**\n   * Latest record to compare and compose with accepted changes.\n   */\n  currentRecord: TRecord;\n  /**\n   * Current host version used for consistency checks.\n   */\n  currentVersion: string | number;\n  /**\n   * Optional pure synchronous full-record validator; render-time exceptions propagate.\n   */\n  validateCandidate?: (candidate: TRecord) => CandidateValidationResult;\n  /**\n   * Optional async host persistence/form-application handler; absence prevents apply.\n   */\n  onApply?: ProposalReviewCardProps<TRecord>['onApply'];\n}\n\n/**\n * Manages explicit field decisions and candidate consistency for a single proposal.\n *\n * @typeParam TRecord - Current record shape; defaults to a string-keyed record.\n *\n * @param options - Immutable proposal, latest record/version, optional candidate validator and host apply handler.\n *\n * @returns Review decisions, composed candidate, validation state and explicit apply controls.\n *\n * @throws Host validateCandidate errors propagate from render.\n *\n * @remarks Requires React; no context or CSS. Changing proposal.id resets choices, error\n * and displayed submission state. A synchronous lock blocks duplicate apply calls.\n * Late results from an older displayed generation do not update the current review;\n * this does not cancel or roll back host effects. onApply errors become saveError and\n * handleApply returns false. No backend authorization or persistence is provided.\n *\n * @example\n * ```tsx\n * import { useProposalReview, type UseProposalReviewOptions } from '@alneas/appkit-react/ai/proposal';\n * type RecordData = { title: string };\n * // The host supplies a validated proposal, current record/version and real onApply.\n * export function Review({ options }: { options: UseProposalReviewOptions<RecordData> }) {\n *   const review = useProposalReview(options);\n *   return <button disabled={!review.canApply || review.isSubmitting} onClick={() => { void review.handleApply(); }}>Apply reviewed changes</button>;\n * }\n * ```\n */\nexport function useProposalReview<\n  TRecord extends Record<string, any> = Record<string, any>,\n>(options: UseProposalReviewOptions<TRecord>): UseProposalReviewReturn<TRecord> {\n  const { proposal, currentRecord, currentVersion, validateCandidate, onApply } = options;\n\n  // 提案切替（proposal.id 変更）の検知用\n  const [activeProposalId, setActiveProposalId] = useState<string>(proposal.id);\n  const [rawDecisions, setRawDecisions] = useState<ReviewDecisions<TRecord>>(\n    {} as ReviewDecisions<TRecord>\n  );\n  const [isSubmitting, setIsSubmitting] = useState(false);\n  const [saveError, setSaveError] = useState<string | null>(null);\n\n  // 表示世代カウンター: 提案切替（A→B, B→A など）のたびにインクリメント\n  const [displayGeneration, setDisplayGeneration] = useState<number>(1);\n  const displayGenerationRef = useRef<number>(1);\n\n  // 実行トークン: 適用実行ごとに一意なトークンをインクリメント\n  const executionTokenRef = useRef<number>(0);\n  // 同期実行ロック: 再レンダー完了前の高速な連続クリック（二重実行）を同期的にブロック\n  const isExecutingLockRef = useRef<boolean>(false);\n\n  // プロジェクト標準ルール: 「No synchronous setState in useEffect」\n  // 提案 ID が切り替わった場合、レンダー中に状態を初期化して同期ズレを防ぐ\n  let decisions = rawDecisions;\n  if (proposal.id !== activeProposalId) {\n    setActiveProposalId(proposal.id);\n    setRawDecisions({} as ReviewDecisions<TRecord>);\n    setSaveError(null);\n    setIsSubmitting(false);\n    setDisplayGeneration((prev) => prev + 1);\n    decisions = {} as ReviewDecisions<TRecord>;\n  }\n\n  // 提案が切り替わった場合、実行ロックを非同期完了を待たずに解除し、表示世代Refを同期\n  useEffect(() => {\n    displayGenerationRef.current = displayGeneration;\n    isExecutingLockRef.current = false;\n  }, [displayGeneration]);\n\n  // 個別フィールド決定の更新\n  const setDecision = useCallback((field: FieldKey<TRecord>, decision: FieldDecision) => {\n    setRawDecisions((prev) => ({\n      ...prev,\n      [field]: decision,\n    }));\n    setSaveError(null);\n  }, []);\n\n  // 全採用\n  const acceptAll = useCallback(() => {\n    const next: Partial<Record<FieldKey<TRecord>, FieldDecision>> = {};\n    for (const change of proposal.changes) {\n      next[change.field] = 'accepted';\n    }\n    setRawDecisions(next);\n    setSaveError(null);\n  }, [proposal.changes]);\n\n  // 全却下\n  const rejectAll = useCallback(() => {\n    const next: Partial<Record<FieldKey<TRecord>, FieldDecision>> = {};\n    for (const change of proposal.changes) {\n      next[change.field] = 'rejected';\n    }\n    setRawDecisions(next);\n    setSaveError(null);\n  }, [proposal.changes]);\n\n  // リセット（全 pending）\n  const resetDecisions = useCallback(() => {\n    setRawDecisions({} as ReviewDecisions<TRecord>);\n    setSaveError(null);\n  }, []);\n\n  // 候補レコードの合成（不変・純粋関数）\n  const candidateRecord = useMemo(() => {\n    return buildCandidateRecord(currentRecord, proposal, decisions);\n  }, [currentRecord, proposal, decisions]);\n\n  // 現在値およびバージョンとの整合性検査\n  const consistency = useMemo(() => {\n    return verifyCurrentState(currentRecord, currentVersion, proposal, decisions);\n  }, [currentRecord, currentVersion, proposal, decisions]);\n\n  // 候補レコード全体のカスタム検証（相関チェック等）\n  const candidateValidation = useMemo(() => {\n    if (!validateCandidate) return undefined;\n    return validateCandidate(candidateRecord);\n  }, [validateCandidate, candidateRecord]);\n\n  // 全体のレビュー状態（派生値）\n  const reviewStatus = useMemo(() => {\n    return computeReviewStatus(proposal, decisions);\n  }, [proposal, decisions]);\n\n  // 適用可能かどうかの判定（onApply が指定されていることも条件）\n  const canApply = useMemo(() => {\n    if (!onApply) return false;\n    return canApplyProposal({\n      proposal,\n      decisions,\n      consistency,\n      candidateValidation,\n    });\n  }, [onApply, proposal, decisions, consistency, candidateValidation]);\n\n  // 適用実行ハンドラ（提案世代・トークン・同期ロックによる完全隔離）\n  const handleApply = useCallback(async (): Promise<boolean> => {\n    // 1. 同期ロックおよび適用可否チェック（再レンダー前の重複実行も防止）\n    if (!canApply || isExecutingLockRef.current || !onApply) {\n      return false;\n    }\n\n    isExecutingLockRef.current = true;\n    const executionGen = displayGenerationRef.current;\n    const currentToken = ++executionTokenRef.current;\n\n    setIsSubmitting(true);\n    setSaveError(null);\n\n    try {\n      const payload = buildApplyPayload({\n        proposal,\n        candidateRecord,\n        decisions,\n      });\n\n      await onApply(payload);\n\n      // 非同期完了時: 表示世代および実行トークンが現在と一致している場合のみ状態を更新\n      if (\n        displayGenerationRef.current === executionGen &&\n        executionTokenRef.current === currentToken\n      ) {\n        setIsSubmitting(false);\n        setSaveError(null);\n        isExecutingLockRef.current = false;\n        return true;\n      }\n      return false;\n    } catch (err) {\n      // 非同期失敗時: 表示世代および実行トークンが現在と一致している場合のみエラーを設定\n      if (\n        displayGenerationRef.current === executionGen &&\n        executionTokenRef.current === currentToken\n      ) {\n        setIsSubmitting(false);\n        const message = err instanceof Error ? err.message : '適用の保存中にエラーが発生しました';\n        setSaveError(message);\n        isExecutingLockRef.current = false;\n      }\n      return false;\n    } finally {\n      // 過去世代の結果が遅れて完了した場合の finally では、現在のロックを解除しない\n      if (\n        displayGenerationRef.current === executionGen &&\n        executionTokenRef.current === currentToken\n      ) {\n        isExecutingLockRef.current = false;\n      }\n    }\n  }, [canApply, onApply, proposal, candidateRecord, decisions]);\n\n  return {\n    decisions,\n    setDecision,\n    acceptAll,\n    rejectAll,\n    resetDecisions,\n    candidateRecord,\n    reviewStatus,\n    consistency,\n    candidateValidation,\n    canApply,\n    isSubmitting,\n    saveError,\n    handleApply,\n  };\n}\n"],"mappings":"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"}

package/dist/ai/proposal/use-proposal-review.d.cts

@@ -1,18 +1,60 @@
 import { CandidateValidationResult, RecordProposal } from '@alneas/appkit-core/ai';
 import { ProposalReviewCardProps, UseProposalReviewReturn } from './types.cjs';
-/** Options for useProposalReview hook. */
+/**
+ * Host inputs for one immutable change proposal.
+ *
+ * @typeParam TRecord - Record shape; defaults to a string-keyed record.
+ *
+ * @see useProposalReview for complete usage.
+ */
 export interface UseProposalReviewOptions<TRecord extends Record<string, any> = Record<string, any>> {
+    /**
+     * Validated immutable proposal; a new id starts a new review generation.
+     */
     proposal: RecordProposal<TRecord>;
+    /**
+     * Latest record to compare and compose with accepted changes.
+     */
     currentRecord: TRecord;
+    /**
+     * Current host version used for consistency checks.
+     */
     currentVersion: string | number;
+    /**
+     * Optional pure synchronous full-record validator; render-time exceptions propagate.
+     */
     validateCandidate?: (candidate: TRecord) => CandidateValidationResult;
+    /**
+     * Optional async host persistence/form-application handler; absence prevents apply.
+     */
     onApply?: ProposalReviewCardProps<TRecord>['onApply'];
 }
 /**
- * 変更提案のレビュー状態を管理するカスタムフック
+ * Manages explicit field decisions and candidate consistency for a single proposal.
+ *
+ * @typeParam TRecord - Current record shape; defaults to a string-keyed record.
+ *
+ * @param options - Immutable proposal, latest record/version, optional candidate validator and host apply handler.
+ *
+ * @returns Review decisions, composed candidate, validation state and explicit apply controls.
+ *
+ * @throws Host validateCandidate errors propagate from render.
+ *
+ * @remarks Requires React; no context or CSS. Changing proposal.id resets choices, error
+ * and displayed submission state. A synchronous lock blocks duplicate apply calls.
+ * Late results from an older displayed generation do not update the current review;
+ * this does not cancel or roll back host effects. onApply errors become saveError and
+ * handleApply returns false. No backend authorization or persistence is provided.
  *
- * @template TRecord レコード型
- * @param options フックオプション
- * @returns レビュー状態と操作ハンドラ
+ * @example
+ * ```tsx
+ * import { useProposalReview, type UseProposalReviewOptions } from '@alneas/appkit-react/ai/proposal';
+ * type RecordData = { title: string };
+ * // The host supplies a validated proposal, current record/version and real onApply.
+ * export function Review({ options }: { options: UseProposalReviewOptions<RecordData> }) {
+ *   const review = useProposalReview(options);
+ *   return <button disabled={!review.canApply || review.isSubmitting} onClick={() => { void review.handleApply(); }}>Apply reviewed changes</button>;
+ * }
+ * ```
  */
 export declare function useProposalReview<TRecord extends Record<string, any> = Record<string, any>>(options: UseProposalReviewOptions<TRecord>): UseProposalReviewReturn<TRecord>;

package/dist/ai/proposal/use-proposal-review.d.ts

@@ -1,18 +1,60 @@
 import { CandidateValidationResult, RecordProposal } from '@alneas/appkit-core/ai';
 import { ProposalReviewCardProps, UseProposalReviewReturn } from './types.js';
-/** Options for useProposalReview hook. */
+/**
+ * Host inputs for one immutable change proposal.
+ *
+ * @typeParam TRecord - Record shape; defaults to a string-keyed record.
+ *
+ * @see useProposalReview for complete usage.
+ */
 export interface UseProposalReviewOptions<TRecord extends Record<string, any> = Record<string, any>> {
+    /**
+     * Validated immutable proposal; a new id starts a new review generation.
+     */
     proposal: RecordProposal<TRecord>;
+    /**
+     * Latest record to compare and compose with accepted changes.
+     */
     currentRecord: TRecord;
+    /**
+     * Current host version used for consistency checks.
+     */
     currentVersion: string | number;
+    /**
+     * Optional pure synchronous full-record validator; render-time exceptions propagate.
+     */
     validateCandidate?: (candidate: TRecord) => CandidateValidationResult;
+    /**
+     * Optional async host persistence/form-application handler; absence prevents apply.
+     */
     onApply?: ProposalReviewCardProps<TRecord>['onApply'];
 }
 /**
- * 変更提案のレビュー状態を管理するカスタムフック
+ * Manages explicit field decisions and candidate consistency for a single proposal.
+ *
+ * @typeParam TRecord - Current record shape; defaults to a string-keyed record.
+ *
+ * @param options - Immutable proposal, latest record/version, optional candidate validator and host apply handler.
+ *
+ * @returns Review decisions, composed candidate, validation state and explicit apply controls.
+ *
+ * @throws Host validateCandidate errors propagate from render.
+ *
+ * @remarks Requires React; no context or CSS. Changing proposal.id resets choices, error
+ * and displayed submission state. A synchronous lock blocks duplicate apply calls.
+ * Late results from an older displayed generation do not update the current review;
+ * this does not cancel or roll back host effects. onApply errors become saveError and
+ * handleApply returns false. No backend authorization or persistence is provided.
  *
- * @template TRecord レコード型
- * @param options フックオプション
- * @returns レビュー状態と操作ハンドラ
+ * @example
+ * ```tsx
+ * import { useProposalReview, type UseProposalReviewOptions } from '@alneas/appkit-react/ai/proposal';
+ * type RecordData = { title: string };
+ * // The host supplies a validated proposal, current record/version and real onApply.
+ * export function Review({ options }: { options: UseProposalReviewOptions<RecordData> }) {
+ *   const review = useProposalReview(options);
+ *   return <button disabled={!review.canApply || review.isSubmitting} onClick={() => { void review.handleApply(); }}>Apply reviewed changes</button>;
+ * }
+ * ```
  */
 export declare function useProposalReview<TRecord extends Record<string, any> = Record<string, any>>(options: UseProposalReviewOptions<TRecord>): UseProposalReviewReturn<TRecord>;

package/dist/ai/proposal/use-proposal-review.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-proposal-review.js","names":["useProposalReview","options","activeProposalId","setActiveProposalId","useState","proposal","rawDecisions","setRawDecisions","isSubmitting","setIsSubmitting","saveError","setSaveError","displayGeneration","setDisplayGeneration","displayGenerationRef","useRef","executionTokenRef","isExecutingLockRef","decisions","prev","useEffect","setDecision","useCallback","field","decision","acceptAll","next","change","rejectAll","resetDecisions","candidateRecord","useMemo","buildCandidateRecord","currentRecord","consistency","verifyCurrentState","currentVersion","candidateValidation","validateCandidate","reviewStatus","computeReviewStatus","canApply","onApply","canApplyProposal","handleApply","executionGen","currentToken","payload","buildApplyPayload","err","message"],"sources":["../../../src/ai/proposal/use-proposal-review.ts"],"sourcesContent":["'use client';\n\nimport { useState, useMemo, useCallback, useRef, useEffect } from 'react';\nimport {\n  buildApplyPayload,\n  buildCandidateRecord,\n  canApplyProposal,\n  computeReviewStatus,\n  verifyCurrentState,\n} from \"@alneas/appkit-core/ai\";\nimport type {\n  CandidateValidationResult,\n  FieldDecision,\n  FieldKey,\n  RecordProposal,\n  ReviewDecisions,\n} from \"@alneas/appkit-core/ai\";\nimport type { ProposalReviewCardProps, UseProposalReviewReturn } from './types';\n\n/** Options for useProposalReview hook. */\nexport interface UseProposalReviewOptions<\n  TRecord extends Record<string, any> = Record<string, any>,\n> {\n  proposal: RecordProposal<TRecord>;\n  currentRecord: TRecord;\n  currentVersion: string | number;\n  validateCandidate?: (candidate: TRecord) => CandidateValidationResult;\n  onApply?: ProposalReviewCardProps<TRecord>['onApply'];\n}\n\n/**\n * 変更提案のレビュー状態を管理するカスタムフック\n *\n * @template TRecord レコード型\n * @param options フックオプション\n * @returns レビュー状態と操作ハンドラ\n */\nexport function useProposalReview<\n  TRecord extends Record<string, any> = Record<string, any>,\n>(options: UseProposalReviewOptions<TRecord>): UseProposalReviewReturn<TRecord> {\n  const { proposal, currentRecord, currentVersion, validateCandidate, onApply } = options;\n\n  // 提案切替（proposal.id 変更）の検知用\n  const [activeProposalId, setActiveProposalId] = useState<string>(proposal.id);\n  const [rawDecisions, setRawDecisions] = useState<ReviewDecisions<TRecord>>(\n    {} as ReviewDecisions<TRecord>\n  );\n  const [isSubmitting, setIsSubmitting] = useState(false);\n  const [saveError, setSaveError] = useState<string | null>(null);\n\n  // 表示世代カウンター: 提案切替（A→B, B→A など）のたびにインクリメント\n  const [displayGeneration, setDisplayGeneration] = useState<number>(1);\n  const displayGenerationRef = useRef<number>(1);\n\n  // 実行トークン: 適用実行ごとに一意なトークンをインクリメント\n  const executionTokenRef = useRef<number>(0);\n  // 同期実行ロック: 再レンダー完了前の高速な連続クリック（二重実行）を同期的にブロック\n  const isExecutingLockRef = useRef<boolean>(false);\n\n  // プロジェクト標準ルール: 「No synchronous setState in useEffect」\n  // 提案 ID が切り替わった場合、レンダー中に状態を初期化して同期ズレを防ぐ\n  let decisions = rawDecisions;\n  if (proposal.id !== activeProposalId) {\n    setActiveProposalId(proposal.id);\n    setRawDecisions({} as ReviewDecisions<TRecord>);\n    setSaveError(null);\n    setIsSubmitting(false);\n    setDisplayGeneration((prev) => prev + 1);\n    decisions = {} as ReviewDecisions<TRecord>;\n  }\n\n  // 提案が切り替わった場合、実行ロックを非同期完了を待たずに解除し、表示世代Refを同期\n  useEffect(() => {\n    displayGenerationRef.current = displayGeneration;\n    isExecutingLockRef.current = false;\n  }, [displayGeneration]);\n\n  // 個別フィールド決定の更新\n  const setDecision = useCallback((field: FieldKey<TRecord>, decision: FieldDecision) => {\n    setRawDecisions((prev) => ({\n      ...prev,\n      [field]: decision,\n    }));\n    setSaveError(null);\n  }, []);\n\n  // 全採用\n  const acceptAll = useCallback(() => {\n    const next: Partial<Record<FieldKey<TRecord>, FieldDecision>> = {};\n    for (const change of proposal.changes) {\n      next[change.field] = 'accepted';\n    }\n    setRawDecisions(next);\n    setSaveError(null);\n  }, [proposal.changes]);\n\n  // 全却下\n  const rejectAll = useCallback(() => {\n    const next: Partial<Record<FieldKey<TRecord>, FieldDecision>> = {};\n    for (const change of proposal.changes) {\n      next[change.field] = 'rejected';\n    }\n    setRawDecisions(next);\n    setSaveError(null);\n  }, [proposal.changes]);\n\n  // リセット（全 pending）\n  const resetDecisions = useCallback(() => {\n    setRawDecisions({} as ReviewDecisions<TRecord>);\n    setSaveError(null);\n  }, []);\n\n  // 候補レコードの合成（不変・純粋関数）\n  const candidateRecord = useMemo(() => {\n    return buildCandidateRecord(currentRecord, proposal, decisions);\n  }, [currentRecord, proposal, decisions]);\n\n  // 現在値およびバージョンとの整合性検査\n  const consistency = useMemo(() => {\n    return verifyCurrentState(currentRecord, currentVersion, proposal, decisions);\n  }, [currentRecord, currentVersion, proposal, decisions]);\n\n  // 候補レコード全体のカスタム検証（相関チェック等）\n  const candidateValidation = useMemo(() => {\n    if (!validateCandidate) return undefined;\n    return validateCandidate(candidateRecord);\n  }, [validateCandidate, candidateRecord]);\n\n  // 全体のレビュー状態（派生値）\n  const reviewStatus = useMemo(() => {\n    return computeReviewStatus(proposal, decisions);\n  }, [proposal, decisions]);\n\n  // 適用可能かどうかの判定（onApply が指定されていることも条件）\n  const canApply = useMemo(() => {\n    if (!onApply) return false;\n    return canApplyProposal({\n      proposal,\n      decisions,\n      consistency,\n      candidateValidation,\n    });\n  }, [onApply, proposal, decisions, consistency, candidateValidation]);\n\n  // 適用実行ハンドラ（提案世代・トークン・同期ロックによる完全隔離）\n  const handleApply = useCallback(async (): Promise<boolean> => {\n    // 1. 同期ロックおよび適用可否チェック（再レンダー前の重複実行も防止）\n    if (!canApply || isExecutingLockRef.current || !onApply) {\n      return false;\n    }\n\n    isExecutingLockRef.current = true;\n    const executionGen = displayGenerationRef.current;\n    const currentToken = ++executionTokenRef.current;\n\n    setIsSubmitting(true);\n    setSaveError(null);\n\n    try {\n      const payload = buildApplyPayload({\n        proposal,\n        candidateRecord,\n        decisions,\n      });\n\n      await onApply(payload);\n\n      // 非同期完了時: 表示世代および実行トークンが現在と一致している場合のみ状態を更新\n      if (\n        displayGenerationRef.current === executionGen &&\n        executionTokenRef.current === currentToken\n      ) {\n        setIsSubmitting(false);\n        setSaveError(null);\n        isExecutingLockRef.current = false;\n        return true;\n      }\n      return false;\n    } catch (err) {\n      // 非同期失敗時: 表示世代および実行トークンが現在と一致している場合のみエラーを設定\n      if (\n        displayGenerationRef.current === executionGen &&\n        executionTokenRef.current === currentToken\n      ) {\n        setIsSubmitting(false);\n        const message = err instanceof Error ? err.message : '適用の保存中にエラーが発生しました';\n        setSaveError(message);\n        isExecutingLockRef.current = false;\n      }\n      return false;\n    } finally {\n      // 過去世代の結果が遅れて完了した場合の finally では、現在のロックを解除しない\n      if (\n        displayGenerationRef.current === executionGen &&\n        executionTokenRef.current === currentToken\n      ) {\n        isExecutingLockRef.current = false;\n      }\n    }\n  }, [canApply, onApply, proposal, candidateRecord, decisions]);\n\n  return {\n    decisions,\n    setDecision,\n    acceptAll,\n    rejectAll,\n    resetDecisions,\n    candidateRecord,\n    reviewStatus,\n    consistency,\n    candidateValidation,\n    canApply,\n    isSubmitting,\n    saveError,\n    handleApply,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"use-proposal-review.js","names":["useProposalReview","options","activeProposalId","setActiveProposalId","useState","proposal","rawDecisions","setRawDecisions","isSubmitting","setIsSubmitting","saveError","setSaveError","displayGeneration","setDisplayGeneration","displayGenerationRef","useRef","executionTokenRef","isExecutingLockRef","decisions","prev","useEffect","setDecision","useCallback","field","decision","acceptAll","next","change","rejectAll","resetDecisions","candidateRecord","useMemo","buildCandidateRecord","currentRecord","consistency","verifyCurrentState","currentVersion","candidateValidation","validateCandidate","reviewStatus","computeReviewStatus","canApply","onApply","canApplyProposal","handleApply","executionGen","currentToken","payload","buildApplyPayload","err","message"],"sources":["../../../src/ai/proposal/use-proposal-review.ts"],"sourcesContent":["'use client';\n\nimport { useState, useMemo, useCallback, useRef, useEffect } from 'react';\nimport {\n  buildApplyPayload,\n  buildCandidateRecord,\n  canApplyProposal,\n  computeReviewStatus,\n  verifyCurrentState,\n} from \"@alneas/appkit-core/ai\";\nimport type {\n  CandidateValidationResult,\n  FieldDecision,\n  FieldKey,\n  RecordProposal,\n  ReviewDecisions,\n} from \"@alneas/appkit-core/ai\";\nimport type { ProposalReviewCardProps, UseProposalReviewReturn } from './types';\n\n/**\n * Host inputs for one immutable change proposal.\n *\n * @typeParam TRecord - Record shape; defaults to a string-keyed record.\n *\n * @see useProposalReview for complete usage.\n */\nexport interface UseProposalReviewOptions<\n  TRecord extends Record<string, any> = Record<string, any>,\n> {\n  /**\n   * Validated immutable proposal; a new id starts a new review generation.\n   */\n  proposal: RecordProposal<TRecord>;\n  /**\n   * Latest record to compare and compose with accepted changes.\n   */\n  currentRecord: TRecord;\n  /**\n   * Current host version used for consistency checks.\n   */\n  currentVersion: string | number;\n  /**\n   * Optional pure synchronous full-record validator; render-time exceptions propagate.\n   */\n  validateCandidate?: (candidate: TRecord) => CandidateValidationResult;\n  /**\n   * Optional async host persistence/form-application handler; absence prevents apply.\n   */\n  onApply?: ProposalReviewCardProps<TRecord>['onApply'];\n}\n\n/**\n * Manages explicit field decisions and candidate consistency for a single proposal.\n *\n * @typeParam TRecord - Current record shape; defaults to a string-keyed record.\n *\n * @param options - Immutable proposal, latest record/version, optional candidate validator and host apply handler.\n *\n * @returns Review decisions, composed candidate, validation state and explicit apply controls.\n *\n * @throws Host validateCandidate errors propagate from render.\n *\n * @remarks Requires React; no context or CSS. Changing proposal.id resets choices, error\n * and displayed submission state. A synchronous lock blocks duplicate apply calls.\n * Late results from an older displayed generation do not update the current review;\n * this does not cancel or roll back host effects. onApply errors become saveError and\n * handleApply returns false. No backend authorization or persistence is provided.\n *\n * @example\n * ```tsx\n * import { useProposalReview, type UseProposalReviewOptions } from '@alneas/appkit-react/ai/proposal';\n * type RecordData = { title: string };\n * // The host supplies a validated proposal, current record/version and real onApply.\n * export function Review({ options }: { options: UseProposalReviewOptions<RecordData> }) {\n *   const review = useProposalReview(options);\n *   return <button disabled={!review.canApply || review.isSubmitting} onClick={() => { void review.handleApply(); }}>Apply reviewed changes</button>;\n * }\n * ```\n */\nexport function useProposalReview<\n  TRecord extends Record<string, any> = Record<string, any>,\n>(options: UseProposalReviewOptions<TRecord>): UseProposalReviewReturn<TRecord> {\n  const { proposal, currentRecord, currentVersion, validateCandidate, onApply } = options;\n\n  // 提案切替（proposal.id 変更）の検知用\n  const [activeProposalId, setActiveProposalId] = useState<string>(proposal.id);\n  const [rawDecisions, setRawDecisions] = useState<ReviewDecisions<TRecord>>(\n    {} as ReviewDecisions<TRecord>\n  );\n  const [isSubmitting, setIsSubmitting] = useState(false);\n  const [saveError, setSaveError] = useState<string | null>(null);\n\n  // 表示世代カウンター: 提案切替（A→B, B→A など）のたびにインクリメント\n  const [displayGeneration, setDisplayGeneration] = useState<number>(1);\n  const displayGenerationRef = useRef<number>(1);\n\n  // 実行トークン: 適用実行ごとに一意なトークンをインクリメント\n  const executionTokenRef = useRef<number>(0);\n  // 同期実行ロック: 再レンダー完了前の高速な連続クリック（二重実行）を同期的にブロック\n  const isExecutingLockRef = useRef<boolean>(false);\n\n  // プロジェクト標準ルール: 「No synchronous setState in useEffect」\n  // 提案 ID が切り替わった場合、レンダー中に状態を初期化して同期ズレを防ぐ\n  let decisions = rawDecisions;\n  if (proposal.id !== activeProposalId) {\n    setActiveProposalId(proposal.id);\n    setRawDecisions({} as ReviewDecisions<TRecord>);\n    setSaveError(null);\n    setIsSubmitting(false);\n    setDisplayGeneration((prev) => prev + 1);\n    decisions = {} as ReviewDecisions<TRecord>;\n  }\n\n  // 提案が切り替わった場合、実行ロックを非同期完了を待たずに解除し、表示世代Refを同期\n  useEffect(() => {\n    displayGenerationRef.current = displayGeneration;\n    isExecutingLockRef.current = false;\n  }, [displayGeneration]);\n\n  // 個別フィールド決定の更新\n  const setDecision = useCallback((field: FieldKey<TRecord>, decision: FieldDecision) => {\n    setRawDecisions((prev) => ({\n      ...prev,\n      [field]: decision,\n    }));\n    setSaveError(null);\n  }, []);\n\n  // 全採用\n  const acceptAll = useCallback(() => {\n    const next: Partial<Record<FieldKey<TRecord>, FieldDecision>> = {};\n    for (const change of proposal.changes) {\n      next[change.field] = 'accepted';\n    }\n    setRawDecisions(next);\n    setSaveError(null);\n  }, [proposal.changes]);\n\n  // 全却下\n  const rejectAll = useCallback(() => {\n    const next: Partial<Record<FieldKey<TRecord>, FieldDecision>> = {};\n    for (const change of proposal.changes) {\n      next[change.field] = 'rejected';\n    }\n    setRawDecisions(next);\n    setSaveError(null);\n  }, [proposal.changes]);\n\n  // リセット（全 pending）\n  const resetDecisions = useCallback(() => {\n    setRawDecisions({} as ReviewDecisions<TRecord>);\n    setSaveError(null);\n  }, []);\n\n  // 候補レコードの合成（不変・純粋関数）\n  const candidateRecord = useMemo(() => {\n    return buildCandidateRecord(currentRecord, proposal, decisions);\n  }, [currentRecord, proposal, decisions]);\n\n  // 現在値およびバージョンとの整合性検査\n  const consistency = useMemo(() => {\n    return verifyCurrentState(currentRecord, currentVersion, proposal, decisions);\n  }, [currentRecord, currentVersion, proposal, decisions]);\n\n  // 候補レコード全体のカスタム検証（相関チェック等）\n  const candidateValidation = useMemo(() => {\n    if (!validateCandidate) return undefined;\n    return validateCandidate(candidateRecord);\n  }, [validateCandidate, candidateRecord]);\n\n  // 全体のレビュー状態（派生値）\n  const reviewStatus = useMemo(() => {\n    return computeReviewStatus(proposal, decisions);\n  }, [proposal, decisions]);\n\n  // 適用可能かどうかの判定（onApply が指定されていることも条件）\n  const canApply = useMemo(() => {\n    if (!onApply) return false;\n    return canApplyProposal({\n      proposal,\n      decisions,\n      consistency,\n      candidateValidation,\n    });\n  }, [onApply, proposal, decisions, consistency, candidateValidation]);\n\n  // 適用実行ハンドラ（提案世代・トークン・同期ロックによる完全隔離）\n  const handleApply = useCallback(async (): Promise<boolean> => {\n    // 1. 同期ロックおよび適用可否チェック（再レンダー前の重複実行も防止）\n    if (!canApply || isExecutingLockRef.current || !onApply) {\n      return false;\n    }\n\n    isExecutingLockRef.current = true;\n    const executionGen = displayGenerationRef.current;\n    const currentToken = ++executionTokenRef.current;\n\n    setIsSubmitting(true);\n    setSaveError(null);\n\n    try {\n      const payload = buildApplyPayload({\n        proposal,\n        candidateRecord,\n        decisions,\n      });\n\n      await onApply(payload);\n\n      // 非同期完了時: 表示世代および実行トークンが現在と一致している場合のみ状態を更新\n      if (\n        displayGenerationRef.current === executionGen &&\n        executionTokenRef.current === currentToken\n      ) {\n        setIsSubmitting(false);\n        setSaveError(null);\n        isExecutingLockRef.current = false;\n        return true;\n      }\n      return false;\n    } catch (err) {\n      // 非同期失敗時: 表示世代および実行トークンが現在と一致している場合のみエラーを設定\n      if (\n        displayGenerationRef.current === executionGen &&\n        executionTokenRef.current === currentToken\n      ) {\n        setIsSubmitting(false);\n        const message = err instanceof Error ? err.message : '適用の保存中にエラーが発生しました';\n        setSaveError(message);\n        isExecutingLockRef.current = false;\n      }\n      return false;\n    } finally {\n      // 過去世代の結果が遅れて完了した場合の finally では、現在のロックを解除しない\n      if (\n        displayGenerationRef.current === executionGen &&\n        executionTokenRef.current === currentToken\n      ) {\n        isExecutingLockRef.current = false;\n      }\n    }\n  }, [canApply, onApply, proposal, candidateRecord, decisions]);\n\n  return {\n    decisions,\n    setDecision,\n    acceptAll,\n    rejectAll,\n    resetDecisions,\n    candidateRecord,\n    reviewStatus,\n    consistency,\n    candidateValidation,\n    canApply,\n    isSubmitting,\n    saveError,\n    handleApply,\n  };\n}\n"],"mappings":"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"}

package/dist/avatar.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64"><rect width="64" height="64" rx="32" fill="#334155"/><circle cx="32" cy="23" r="11" fill="#f8fafc"/><path d="M12 58a20 20 0 0 1 40 0" fill="#f8fafc"/></svg>

package/dist/consumer-ai/SKILL.md

@@ -4,3 +4,9 @@ description: Integrate @alneas/appkit-react using published feature subpaths.
 ---
 
 Read package-context.json for exact exports and peers. Install package names; import feature subpaths. Each feature guide must state its public import path. Preserve host providers and explicit CSS imports. Applications own authorization, migrations, final writes, atomic checks and durable idempotency. AI metadata consistency does not establish end-to-end coding-agent capability.
+
+Use api-index.json for actual exported names, signatures and public import paths. Read llms.txt and the linked feature guide before choosing optional peers, host providers or CSS. Package.json appkit.agent is Appkit-specific discovery metadata, not an automatically executed agent hook. The same skill, context and catalog are present at consumer-ai/ and dist/consumer-ai/ for compatibility.
+
+The Core package's appkit-api CLI searches locally available catalogs without running tools or contacting a provider. Check each result's package version and digest; registry 0.1.0 does not include this new CLI. Never replace a missing legacy catalog with a newer API surface. Always verify generated code with the consumer's type checker and relevant behavior tests.
+
+AI tool calls and outputs are untrusted. Schema validity is not approval. Bind host approval to immutable arguments/targets/session/registration, enforce server permissions and durable idempotency at execution, and project minimal outputs. Adapters do not run tools or authorize writes. Read the AI guide and Core error guide; never infer permission from a tool-output event or bypass duplicate-call protection.