sdd-agent-platform 0.4.2 → 0.5.0

package/node_modules/@sdd-agent-platform/core/src/router/stage-route-binding.ts

@@ -1,279 +1,273 @@
-import type { RuntimeRef, SddStage } from '../contracts.js';
-import { readLifecycleRiskDecisionProjection } from '../risk/kernel.js';
-import { resolveSddContext } from '../sdd-docs/context.js';
-import { parseSddBranch, type SddTask, type SddTaskModel } from '../sdd-docs/task-parser.js';
-import { STAGE_ROUTE_BINDING_PRODUCER_VERSION, STAGE_ROUTE_BINDING_PROJECTION_TYPE, runtimeProjectionStableHash } from '../runtime-projection-p0.js';
-import { recordRuntimeProjectionEnvelope, type RuntimeProjectionEnvelopeWriteResult } from '../storage/runtime-store.js';
-
-export const STAGE_ROUTE_BINDING_CONTRACT_VERSION = 'sdd-stage-route-binding-v1' as const;
-
-export type StageRouteEntry = 'sdd:plan' | 'sdd:tasks' | 'sdd:do' | 'sdd:test' | 'sdd:ship';
-export type SddCommandBundle = 'plan' | 'tasks' | 'do' | 'test' | 'ship';
-export type StageRouteBindingStatus = 'bound' | 'ambiguous' | 'not_found' | 'stale_upstream' | 'boundary_expanding' | 'blocked';
-export type StageRouteTargetKind = 'task' | 'stage' | 'gate' | 'evidence_set' | 'ship_scope';
-export type StageRouteBindingNextAction = 'enter_stage' | 'run_internal_stage' | 'ask_clarification' | 'route_to_lifecycle_decision' | 'runtime_repair_required' | 'blocked';
-
-export interface StageRouteBinding {
-  contract: typeof STAGE_ROUTE_BINDING_CONTRACT_VERSION;
-  branch: string;
-  entry: StageRouteEntry;
-  bundle: SddCommandBundle;
-  targetRuntimeStage: SddStage;
-  userText: string;
-  status: StageRouteBindingStatus;
-  targetKind: StageRouteTargetKind | null;
-  targetId: string | null;
-  matchedRefs: RuntimeRef[];
-  activeLifecycleDecisionRef: string | null;
-  nextAction: StageRouteBindingNextAction;
-  reasons: string[];
-}
-
-interface TaskMatchCandidate {
-  task: SddTask;
-  score: number;
-}
-
-export async function bindStageRoute(projectRoot: string, input: { entry: StageRouteEntry; branch?: string; userText?: string }): Promise<StageRouteBinding> {
-  const context = await resolveSddContext(projectRoot, { branch: input.branch, branchSource: input.branch ? 'cli_option' : undefined });
-  const model = await parseSddBranch(projectRoot, context.partition);
-  return bindStageRouteForModel(projectRoot, {
-    branch: context.partition,
-    model,
-    entry: input.entry,
-    userText: input.userText ?? ''
-  });
-}
-
-export async function bindStageRouteForModel(projectRoot: string, input: { branch: string; model: SddTaskModel; entry: StageRouteEntry; userText?: string }): Promise<StageRouteBinding> {
-  const userText = (input.userText ?? '').trim();
-  const activeLifecycleDecisionRef = (await readLifecycleRiskDecisionProjection(projectRoot, { branch: input.branch }))?.id ?? null;
-  if (input.entry === 'sdd:do') {
-    return bindDoTask(input.branch, input.model, userText, activeLifecycleDecisionRef);
-  }
-  return bindBundleStage(input.branch, input.entry, userText, activeLifecycleDecisionRef);
-}
-
-export function stageRouteBindingScopeKey(binding: Pick<StageRouteBinding, 'branch' | 'entry' | 'userText'>): string {
-  return [binding.branch, binding.entry, runtimeProjectionStableHash(binding.userText || '<empty>').slice(0, 16)].join(':');
-}
-
-export async function recordStageRouteBindingProjection(projectRoot: string, binding: StageRouteBinding): Promise<RuntimeProjectionEnvelopeWriteResult<StageRouteBinding>> {
-  return recordRuntimeProjectionEnvelope(projectRoot, {
-    projectionType: STAGE_ROUTE_BINDING_PROJECTION_TYPE,
-    scopeKey: stageRouteBindingScopeKey(binding),
-    inputHash: runtimeProjectionStableHash(binding),
-    producer: 'phase9.18-stage-route-binding-runtime',
-    producerVersion: STAGE_ROUTE_BINDING_PRODUCER_VERSION,
-    payload: binding
-  });
-}
-
-function bindDoTask(branch: string, model: SddTaskModel, userText: string, activeLifecycleDecisionRef: string | null): StageRouteBinding {
-  const staleReason = doStageStaleReason(model);
-  if (staleReason) {
-    return binding({
-      branch,
-      entry: 'sdd:do',
-      targetRuntimeStage: 'do',
-      userText,
-      status: 'stale_upstream',
-      targetKind: 'task',
-      targetId: null,
-      matchedRefs: [],
-      activeLifecycleDecisionRef,
-      nextAction: 'runtime_repair_required',
-      reasons: [staleReason]
-    });
-  }
-
-  const matches = matchTasks(model.tasks, userText);
-  if (matches.length === 0) {
-    const looksLikeId = looksLikeTaskId(userText);
-    return binding({
-      branch,
-      entry: 'sdd:do',
-      targetRuntimeStage: 'do',
-      userText,
-      status: looksLikeId ? 'not_found' : 'boundary_expanding',
-      targetKind: 'task',
-      targetId: null,
-      matchedRefs: [],
-      activeLifecycleDecisionRef,
-      nextAction: looksLikeId ? 'ask_clarification' : 'route_to_lifecycle_decision',
-      reasons: looksLikeId
-        ? [`Task ${userText || '<empty>'} was not found in the accepted task set.`]
-        : [`No accepted task boundary matched "${userText}"; run /sdd or /sdd:spec if this is new scope, risk, or acceptance.`]
-    });
-  }
-
-  const topScore = matches[0].score;
-  const tied = matches.filter((candidate) => candidate.score === topScore);
-  if (tied.length > 1) {
-    return binding({
-      branch,
-      entry: 'sdd:do',
-      targetRuntimeStage: 'do',
-      userText,
-      status: 'ambiguous',
-      targetKind: 'task',
-      targetId: null,
-      matchedRefs: tied.map((candidate) => taskRuntimeRef(candidate.task)),
-      activeLifecycleDecisionRef,
-      nextAction: 'ask_clarification',
-      reasons: [`Ambiguous task text "${userText}" matched ${tied.map((candidate) => candidate.task.id).join(', ')}; specify a task id or more precise title.`]
-    });
-  }
-
-  const task = matches[0].task;
-  return binding({
-    branch,
-    entry: 'sdd:do',
-    targetRuntimeStage: 'do',
-    userText,
-    status: 'bound',
-    targetKind: 'task',
-    targetId: task.id,
-    matchedRefs: [taskRuntimeRef(task)],
-    activeLifecycleDecisionRef,
-    nextAction: 'enter_stage',
-    reasons: [`Bound "${userText}" to task ${task.id}.`]
-  });
-}
-
-function bindBundleStage(branch: string, entry: Exclude<StageRouteEntry, 'sdd:do'>, userText: string, activeLifecycleDecisionRef: string | null): StageRouteBinding {
-  const targetRuntimeStage = bundleTargetRuntimeStage(entry, userText);
-  return binding({
-    branch,
-    entry,
-    targetRuntimeStage,
-    userText,
-    status: 'bound',
-    targetKind: entry === 'sdd:ship' ? 'ship_scope' : 'stage',
-    targetId: targetRuntimeStage,
-    matchedRefs: [{ kind: entry === 'sdd:ship' ? 'projection' : 'command', ref: `${entry}:${targetRuntimeStage}` }],
-    activeLifecycleDecisionRef,
-    nextAction: targetRuntimeStage === bundleForEntry(entry) ? 'enter_stage' : 'run_internal_stage',
-    reasons: [`Bound ${entry} to runtime stage ${targetRuntimeStage}.`]
-  });
-}
-
-function binding(input: Omit<StageRouteBinding, 'contract' | 'bundle'>): StageRouteBinding {
-  return {
-    contract: STAGE_ROUTE_BINDING_CONTRACT_VERSION,
-    bundle: bundleForEntry(input.entry),
-    ...input
-  };
-}
-
-function bundleForEntry(entry: StageRouteEntry): SddCommandBundle {
-  if (entry === 'sdd:plan') return 'plan';
-  if (entry === 'sdd:tasks') return 'tasks';
-  if (entry === 'sdd:do') return 'do';
-  if (entry === 'sdd:test') return 'test';
-  return 'ship';
-}
-
-function bundleTargetRuntimeStage(entry: Exclude<StageRouteEntry, 'sdd:do'>, userText: string): SddStage {
-  const normalized = normalizeSearchText(userText);
-  if (entry === 'sdd:plan') return 'plan';
-  if (entry === 'sdd:tasks') return normalized.includes('verif') || normalized.includes('verify') ? 'verifies' : 'tasks';
-  if (entry === 'sdd:test') return normalized.includes('goalverify') || normalized.includes('goal') ? 'goal-verify' : 'test';
-  return 'ship';
-}
-
-function doStageStaleReason(model: SddTaskModel): string | null {
-  if (model.documents.tasksStale) {
-    return 'Tasks document is stale; return to the tasks bundle before executing do-stage binding.';
-  }
-  if (model.documents.verifyStale) {
-    return 'Verify document is stale; return to the tasks/verifies bundle before executing do-stage binding.';
-  }
-  return null;
-}
-
-function matchTasks(tasks: SddTask[], userText: string): TaskMatchCandidate[] {
-  const query = normalizeSearchText(userText);
-  if (!query) {
-    return [];
-  }
-  return tasks
-    .map((task) => ({ task, score: scoreTask(task, userText, query) }))
-    .filter((candidate) => candidate.score >= 40)
-    .sort((left, right) => right.score - left.score || left.task.id.localeCompare(right.task.id));
-}
-
-function scoreTask(task: SddTask, rawQuery: string, normalizedQuery: string): number {
-  const normalizedId = normalizeSearchText(task.id);
-  if (normalizedId === normalizedQuery) {
-    return 1000;
-  }
-  if (normalizedId.includes(normalizedQuery) && normalizedQuery.length >= 2) {
-    return 700;
-  }
-
-  let score = 0;
-  score = Math.max(score, scoreTextField(task.title ?? '', rawQuery, normalizedQuery, 600, 360, 80));
-  score = Math.max(score, scoreTextField(task.acceptance.join(' '), rawQuery, normalizedQuery, 260, 180, 35));
-  score = Math.max(score, scoreTextField(task.boundary ?? '', rawQuery, normalizedQuery, 180, 120, 24));
-  score = Math.max(score, scoreTextField(task.affectedFiles.join(' '), rawQuery, normalizedQuery, 120, 80, 12));
-  return score;
-}
-
-function scoreTextField(value: string, rawQuery: string, normalizedQuery: string, exactScore: number, containsScore: number, tokenWeight: number): number {
-  const normalizedValue = normalizeSearchText(value);
-  if (!normalizedValue) {
-    return 0;
-  }
-  if (normalizedValue === normalizedQuery) {
-    return exactScore;
-  }
-  if ((normalizedValue.includes(normalizedQuery) || normalizedQuery.includes(normalizedValue)) && Math.min(normalizedValue.length, normalizedQuery.length) >= 2) {
-    return containsScore;
-  }
-  const queryTokens = searchTokens(rawQuery);
-  const valueTokens = searchTokens(value);
-  let overlap = 0;
-  for (const token of queryTokens) {
-    if (valueTokens.has(token)) {
-      overlap += 1;
-    }
-  }
-  return overlap * tokenWeight;
-}
-
-function normalizeSearchText(value: string): string {
-  return value.toLocaleLowerCase().normalize('NFKC').replace(/[\s\p{P}\p{S}_-]+/gu, '');
-}
-
-const LOW_SIGNAL_SEARCH_TOKENS = new Set(['system', 'systems', 'feature', 'features', '功能', '系统', '模块', '服务', '任务', '实现', '完成', '边界']);
-
-function searchTokens(value: string): Set<string> {
-  const tokens = new Set<string>();
-  const normalized = value.toLocaleLowerCase().normalize('NFKC');
-  for (const match of normalized.matchAll(/[a-z0-9]+/g)) {
-    addSearchToken(tokens, match[0]);
-  }
-  for (const match of normalized.matchAll(/\p{Script=Han}+/gu)) {
-    const text = match[0];
-    addSearchToken(tokens, text);
-    for (let index = 0; index < text.length - 1; index += 1) {
-      addSearchToken(tokens, text.slice(index, index + 2));
-    }
-  }
-  return tokens;
-}
-
-function addSearchToken(tokens: Set<string>, token: string): void {
-  if (token.length >= 2 && !LOW_SIGNAL_SEARCH_TOKENS.has(token)) {
-    tokens.add(token);
-  }
-}
-
-function looksLikeTaskId(value: string): boolean {
-  return /^[a-z][a-z0-9._-]*-?\d+$/i.test(value.trim());
-}
-
-function taskRuntimeRef(task: SddTask): RuntimeRef {
-  return { kind: 'task', ref: `task:${task.id}` };
-}
+import type { RuntimeRef, SddStage } from '../contracts.js';
+import { readLifecycleRiskDecisionProjection } from '../risk/kernel.js';
+import { resolveSddContext } from '../sdd-docs/context.js';
+import { parseSddBranch, type SddTask, type SddTaskModel } from '../sdd-docs/task-parser.js';
+import { STAGE_ROUTE_BINDING_PRODUCER_VERSION, STAGE_ROUTE_BINDING_PROJECTION_TYPE, runtimeProjectionStableHash } from '../runtime-projection-p0.js';
+import { recordRuntimeProjectionEnvelope, type RuntimeProjectionEnvelopeWriteResult } from '../storage/runtime-store.js';
+
+export const STAGE_ROUTE_BINDING_CONTRACT_VERSION = 'sdd-stage-route-binding-v1' as const;
+
+export type StageRouteEntry = 'sdd:plan' | 'sdd:tasks' | 'sdd:execute' | 'sdd:ship';
+export type SddCommandBundle = 'plan' | 'tasks' | 'execute' | 'ship';
+export type StageRouteBindingStatus = 'bound' | 'ambiguous' | 'not_found' | 'stale_upstream' | 'boundary_expanding' | 'blocked';
+export type StageRouteTargetKind = 'task' | 'stage' | 'gate' | 'evidence_set' | 'ship_scope';
+export type StageRouteBindingNextAction = 'enter_stage' | 'run_internal_stage' | 'ask_clarification' | 'route_to_lifecycle_decision' | 'runtime_repair_required' | 'blocked';
+
+export interface StageRouteBinding {
+  contract: typeof STAGE_ROUTE_BINDING_CONTRACT_VERSION;
+  branch: string;
+  entry: StageRouteEntry;
+  bundle: SddCommandBundle;
+  targetRuntimeStage: SddStage;
+  userText: string;
+  status: StageRouteBindingStatus;
+  targetKind: StageRouteTargetKind | null;
+  targetId: string | null;
+  matchedRefs: RuntimeRef[];
+  activeLifecycleDecisionRef: string | null;
+  nextAction: StageRouteBindingNextAction;
+  reasons: string[];
+}
+
+interface TaskMatchCandidate {
+  task: SddTask;
+  score: number;
+}
+
+export async function bindStageRoute(projectRoot: string, input: { entry: StageRouteEntry; branch?: string; userText?: string }): Promise<StageRouteBinding> {
+  const context = await resolveSddContext(projectRoot, { branch: input.branch, branchSource: input.branch ? 'cli_option' : undefined });
+  const model = await parseSddBranch(projectRoot, context.partition);
+  return bindStageRouteForModel(projectRoot, {
+    branch: context.partition,
+    model,
+    entry: input.entry,
+    userText: input.userText ?? ''
+  });
+}
+
+export async function bindStageRouteForModel(projectRoot: string, input: { branch: string; model: SddTaskModel; entry: StageRouteEntry; userText?: string }): Promise<StageRouteBinding> {
+  const userText = (input.userText ?? '').trim();
+  const activeLifecycleDecisionRef = (await readLifecycleRiskDecisionProjection(projectRoot, { branch: input.branch }))?.id ?? null;
+  if (input.entry === 'sdd:execute') {
+    return bindExecuteTask(input.branch, input.model, userText, activeLifecycleDecisionRef);
+  }
+  return bindBundleStage(input.branch, input.entry, userText, activeLifecycleDecisionRef);
+}
+
+export function stageRouteBindingScopeKey(binding: Pick<StageRouteBinding, 'branch' | 'entry' | 'userText'>): string {
+  return [binding.branch, binding.entry, runtimeProjectionStableHash(binding.userText || '<empty>').slice(0, 16)].join(':');
+}
+
+export async function recordStageRouteBindingProjection(projectRoot: string, binding: StageRouteBinding): Promise<RuntimeProjectionEnvelopeWriteResult<StageRouteBinding>> {
+  return recordRuntimeProjectionEnvelope(projectRoot, {
+    projectionType: STAGE_ROUTE_BINDING_PROJECTION_TYPE,
+    scopeKey: stageRouteBindingScopeKey(binding),
+    inputHash: runtimeProjectionStableHash(binding),
+    producer: 'phase9.18-stage-route-binding-runtime',
+    producerVersion: STAGE_ROUTE_BINDING_PRODUCER_VERSION,
+    payload: binding
+  });
+}
+
+function bindExecuteTask(branch: string, model: SddTaskModel, userText: string, activeLifecycleDecisionRef: string | null): StageRouteBinding {
+  const staleReason = executeStageStaleReason(model);
+  if (staleReason) {
+    return binding({
+      branch,
+      entry: 'sdd:execute',
+      targetRuntimeStage: 'execute',
+      userText,
+      status: 'stale_upstream',
+      targetKind: 'task',
+      targetId: null,
+      matchedRefs: [],
+      activeLifecycleDecisionRef,
+      nextAction: 'runtime_repair_required',
+      reasons: [staleReason]
+    });
+  }
+
+  const matches = matchTasks(model.tasks, userText);
+  if (matches.length === 0) {
+    const looksLikeId = looksLikeTaskId(userText);
+    return binding({
+      branch,
+      entry: 'sdd:execute',
+      targetRuntimeStage: 'execute',
+      userText,
+      status: looksLikeId ? 'not_found' : 'boundary_expanding',
+      targetKind: 'task',
+      targetId: null,
+      matchedRefs: [],
+      activeLifecycleDecisionRef,
+      nextAction: looksLikeId ? 'ask_clarification' : 'route_to_lifecycle_decision',
+      reasons: looksLikeId
+        ? [`Task ${userText || '<empty>'} was not found in the accepted task set.`]
+        : [`No accepted task boundary matched "${userText}"; run /sdd or /sdd:spec if this is new scope, risk, or acceptance.`]
+    });
+  }
+
+  const topScore = matches[0].score;
+  const tied = matches.filter((candidate) => candidate.score === topScore);
+  if (tied.length > 1) {
+    return binding({
+      branch,
+      entry: 'sdd:execute',
+      targetRuntimeStage: 'execute',
+      userText,
+      status: 'ambiguous',
+      targetKind: 'task',
+      targetId: null,
+      matchedRefs: tied.map((candidate) => taskRuntimeRef(candidate.task)),
+      activeLifecycleDecisionRef,
+      nextAction: 'ask_clarification',
+      reasons: [`Ambiguous task text "${userText}" matched ${tied.map((candidate) => candidate.task.id).join(', ')}; specify a task id or more precise title.`]
+    });
+  }
+
+  const task = matches[0].task;
+  return binding({
+    branch,
+    entry: 'sdd:execute',
+    targetRuntimeStage: 'execute',
+    userText,
+    status: 'bound',
+    targetKind: 'task',
+    targetId: task.id,
+    matchedRefs: [taskRuntimeRef(task)],
+    activeLifecycleDecisionRef,
+    nextAction: 'enter_stage',
+    reasons: [`Bound "${userText}" to task ${task.id}.`]
+  });
+}
+
+function bindBundleStage(branch: string, entry: Exclude<StageRouteEntry, 'sdd:execute'>, userText: string, activeLifecycleDecisionRef: string | null): StageRouteBinding {
+  const targetRuntimeStage = bundleTargetRuntimeStage(entry);
+  return binding({
+    branch,
+    entry,
+    targetRuntimeStage,
+    userText,
+    status: 'bound',
+    targetKind: entry === 'sdd:ship' ? 'ship_scope' : 'stage',
+    targetId: targetRuntimeStage,
+    matchedRefs: [{ kind: entry === 'sdd:ship' ? 'projection' : 'command', ref: `${entry}:${targetRuntimeStage}` }],
+    activeLifecycleDecisionRef,
+    nextAction: 'enter_stage',
+    reasons: [`Bound ${entry} to runtime stage ${targetRuntimeStage}.`]
+  });
+}
+
+function binding(input: Omit<StageRouteBinding, 'contract' | 'bundle'>): StageRouteBinding {
+  return {
+    contract: STAGE_ROUTE_BINDING_CONTRACT_VERSION,
+    bundle: bundleForEntry(input.entry),
+    ...input
+  };
+}
+
+function bundleForEntry(entry: StageRouteEntry): SddCommandBundle {
+  if (entry === 'sdd:plan') return 'plan';
+  if (entry === 'sdd:tasks') return 'tasks';
+  if (entry === 'sdd:execute') return 'execute';
+  return 'ship';
+}
+
+function bundleTargetRuntimeStage(entry: Exclude<StageRouteEntry, 'sdd:execute'>): SddStage {
+  if (entry === 'sdd:plan') return 'plan';
+  if (entry === 'sdd:tasks') return 'tasks';
+  return 'ship';
+}
+
+function executeStageStaleReason(model: SddTaskModel): string | null {
+  if (model.documents.tasksStale) {
+    return 'Tasks document is stale; return to the tasks stage before execute-stage binding.';
+  }
+  return null;
+}
+
+function matchTasks(tasks: SddTask[], userText: string): TaskMatchCandidate[] {
+  const query = normalizeSearchText(userText);
+  if (!query) {
+    return [];
+  }
+  return tasks
+    .map((task) => ({ task, score: scoreTask(task, userText, query) }))
+    .filter((candidate) => candidate.score >= 40)
+    .sort((left, right) => right.score - left.score || left.task.id.localeCompare(right.task.id));
+}
+
+function scoreTask(task: SddTask, rawQuery: string, normalizedQuery: string): number {
+  const normalizedId = normalizeSearchText(task.id);
+  if (normalizedId === normalizedQuery) {
+    return 1000;
+  }
+  if (normalizedId.includes(normalizedQuery) && normalizedQuery.length >= 2) {
+    return 700;
+  }
+
+  let score = 0;
+  score = Math.max(score, scoreTextField(task.title ?? '', rawQuery, normalizedQuery, 600, 360, 80));
+  score = Math.max(score, scoreTextField(task.acceptance.join(' '), rawQuery, normalizedQuery, 260, 180, 35));
+  score = Math.max(score, scoreTextField(task.boundary ?? '', rawQuery, normalizedQuery, 180, 120, 24));
+  score = Math.max(score, scoreTextField(task.affectedFiles.join(' '), rawQuery, normalizedQuery, 120, 80, 12));
+  return score;
+}
+
+function scoreTextField(value: string, rawQuery: string, normalizedQuery: string, exactScore: number, containsScore: number, tokenWeight: number): number {
+  const normalizedValue = normalizeSearchText(value);
+  if (!normalizedValue) {
+    return 0;
+  }
+  if (normalizedValue === normalizedQuery) {
+    return exactScore;
+  }
+  if ((normalizedValue.includes(normalizedQuery) || normalizedQuery.includes(normalizedValue)) && Math.min(normalizedValue.length, normalizedQuery.length) >= 2) {
+    return containsScore;
+  }
+  const queryTokens = searchTokens(rawQuery);
+  const valueTokens = searchTokens(value);
+  let overlap = 0;
+  for (const token of queryTokens) {
+    if (valueTokens.has(token)) {
+      overlap += 1;
+    }
+  }
+  return overlap * tokenWeight;
+}
+
+function normalizeSearchText(value: string): string {
+  return value.toLocaleLowerCase().normalize('NFKC').replace(/[\s\p{P}\p{S}_-]+/gu, '');
+}
+
+const LOW_SIGNAL_SEARCH_TOKENS = new Set(['system', 'systems', 'feature', 'features', '功能', '系统', '模块', '服务', '任务', '实现', '完成', '边界']);
+
+function searchTokens(value: string): Set<string> {
+  const tokens = new Set<string>();
+  const normalized = value.toLocaleLowerCase().normalize('NFKC');
+  for (const match of normalized.matchAll(/[a-z0-9]+/g)) {
+    addSearchToken(tokens, match[0]);
+  }
+  for (const match of normalized.matchAll(/\p{Script=Han}+/gu)) {
+    const text = match[0];
+    addSearchToken(tokens, text);
+    for (let index = 0; index < text.length - 1; index += 1) {
+      addSearchToken(tokens, text.slice(index, index + 2));
+    }
+  }
+  return tokens;
+}
+
+function addSearchToken(tokens: Set<string>, token: string): void {
+  if (token.length >= 2 && !LOW_SIGNAL_SEARCH_TOKENS.has(token)) {
+    tokens.add(token);
+  }
+}
+
+function looksLikeTaskId(value: string): boolean {
+  return /^[a-z][a-z0-9._-]*-?\d+$/i.test(value.trim());
+}
+
+function taskRuntimeRef(task: SddTask): RuntimeRef {
+  return { kind: 'task', ref: `task:${task.id}` };
+}