Turtle
cfa6f7359e
Freeze the existing prefixed directories in LEGACY_PREFIXED_EXPERIMENTAL_PACKAGE_DIRECTORIES and reject the prefix elsewhere. Record the naming decision in a new Agent Note and keep the plugin identity note's facts current. Refs #7841
126 lines
6.6 KiB
TypeScript
126 lines
6.6 KiB
TypeScript
/** Experimental package identities, publication policy, and npm names. */
|
|
|
|
/**
|
|
* Experimental packages whose npm names omit the experimental prefix, by directory. Every new experimental package
|
|
* belongs here so that promotion keeps its name; isolation checks and plugin-record ownership recognize an unprefixed
|
|
* experimental name only through this map.
|
|
*/
|
|
export const EXPERIMENTAL_PACKAGE_NAME_EXCEPTIONS: Readonly<Record<string, string>> = {
|
|
'packages/experimental/cua': '@deepseek-ai/dsh-cua',
|
|
'packages/experimental/cua-bundle': '@deepseek-ai/dsh-cua-bundle',
|
|
'packages/experimental/tool-session-query': '@deepseek-ai/dsh-tool-session-query',
|
|
'packages/experimental/session-title-all-prompts-llm': '@deepseek-ai/dsh-session-title-all-prompts-llm',
|
|
'packages/experimental/tool-terminal': '@deepseek-ai/dsh-tool-terminal',
|
|
'packages/experimental/tool-ralph': '@deepseek-ai/dsh-tool-ralph',
|
|
'packages/experimental/skill-badge': '@deepseek-ai/dsh-skill-badge',
|
|
'packages/experimental/hook-protocol': '@deepseek-ai/dsh-hook-protocol',
|
|
'packages/experimental/hooks-claude-code': '@deepseek-ai/dsh-hooks-claude-code',
|
|
'packages/experimental/hooks-codex': '@deepseek-ai/dsh-hooks-codex',
|
|
'packages/experimental/webhook': '@deepseek-ai/dsh-webhook',
|
|
'packages/experimental/webhook-github': '@deepseek-ai/dsh-webhook-github',
|
|
'packages/experimental/action-cards': '@deepseek-ai/dsh-action-cards',
|
|
'packages/experimental/client-ui-action-cards': '@deepseek-ai/dsh-client-ui-action-cards',
|
|
'packages/experimental/creation-recommendations': '@deepseek-ai/dsh-creation-recommendations',
|
|
'packages/experimental/client-ui-creation-recommendations': '@deepseek-ai/dsh-client-ui-creation-recommendations',
|
|
'packages/experimental/plugin-recommendations': '@deepseek-ai/dsh-plugin-recommendations',
|
|
'packages/experimental/client-ui-plugin-recommendations': '@deepseek-ai/dsh-client-ui-plugin-recommendations',
|
|
'packages/experimental/personalized-recommendations': '@deepseek-ai/dsh-personalized-recommendations',
|
|
} satisfies Record<`packages/experimental/${string}`, `@deepseek-ai/dsh-${string}`>
|
|
|
|
/** Legacy npm namespace, allowed only in `LEGACY_PREFIXED_EXPERIMENTAL_PACKAGE_DIRECTORIES`. */
|
|
export const EXPERIMENTAL_PACKAGE_NAME_PREFIX = '@deepseek-ai/dsh-experimental-'
|
|
|
|
/** Existing experimental packages that keep the legacy prefix until a rename; this list must not grow. */
|
|
export const LEGACY_PREFIXED_EXPERIMENTAL_PACKAGE_DIRECTORIES: readonly string[] = [
|
|
'packages/experimental/api-speech-to-text',
|
|
'packages/experimental/auto-review',
|
|
'packages/experimental/badge-skill-bundle',
|
|
'packages/experimental/browser-use-chrome-devtools-mcp',
|
|
'packages/experimental/browser-use-playwright-mcp',
|
|
'packages/experimental/browser-use-runtime',
|
|
'packages/experimental/browser-use-stagehand-native',
|
|
'packages/experimental/claude-code-mods',
|
|
'packages/experimental/client-ui-claude-code-mods',
|
|
'packages/experimental/client-ui-cot-translation',
|
|
'packages/experimental/client-ui-forge',
|
|
'packages/experimental/client-ui-stats',
|
|
'packages/experimental/client-ui-voice-input',
|
|
'packages/experimental/computer-use-cua-driver-mcp',
|
|
'packages/experimental/computer-use-cua-driver-native',
|
|
'packages/experimental/cot-translation-bundle',
|
|
'packages/experimental/cua-macos',
|
|
'packages/experimental/forge',
|
|
'packages/experimental/forge-bundle',
|
|
'packages/experimental/forge-github',
|
|
'packages/experimental/forge-session',
|
|
'packages/experimental/inspector',
|
|
'packages/experimental/inspector-profile',
|
|
'packages/experimental/liveshare',
|
|
'packages/experimental/liveshare-protocol',
|
|
'packages/experimental/plugin-market-bundle',
|
|
'packages/experimental/ptc-runtime-python',
|
|
'packages/experimental/ralph-bundle',
|
|
'packages/experimental/session-inspector',
|
|
'packages/experimental/session-search',
|
|
'packages/experimental/session-titles-bundle',
|
|
'packages/experimental/speech-to-text',
|
|
'packages/experimental/speech-to-text-sensevoice',
|
|
'packages/experimental/subagent-oar',
|
|
'packages/experimental/terminal-bundle',
|
|
'packages/experimental/tool-subagent-oar',
|
|
'packages/experimental/tool-worktree',
|
|
'packages/experimental/translator',
|
|
'packages/experimental/voice-input-bundle',
|
|
'packages/experimental/webworker-packer',
|
|
'packages/experimental/webworker-runtime',
|
|
'packages/experimental/worktree',
|
|
]
|
|
const unprefixedNames = new Set(Object.values(EXPERIMENTAL_PACKAGE_NAME_EXCEPTIONS))
|
|
|
|
/**
|
|
* Identify an experimental npm package independently of its installed directory.
|
|
* @param name - complete npm package name, without a version or subpath.
|
|
* @returns Whether the name uses the legacy prefix or appears in `EXPERIMENTAL_PACKAGE_NAME_EXCEPTIONS`.
|
|
*/
|
|
export function isExperimentalPackageName(name: string): boolean {
|
|
return name.startsWith(EXPERIMENTAL_PACKAGE_NAME_PREFIX) || unprefixedNames.has(name)
|
|
}
|
|
|
|
/**
|
|
* Find experimental identities in module ids, paths, subpaths, or npm alias specifications.
|
|
* @param reference - package reference or bundler/runtime module identifier.
|
|
* @returns Whether a delimited package name identifies an experimental capability.
|
|
*/
|
|
export function hasExperimentalPackageReference(reference: string): boolean {
|
|
const normalized = reference.replaceAll('\\', '/')
|
|
return [...normalized.matchAll(/(?:^|[/:\u0000])(@deepseek-ai\/[^/@?#:\s]+)(?=$|[/@?#:])/g)]
|
|
.some(([, name]) => name !== undefined && isExperimentalPackageName(name))
|
|
}
|
|
|
|
/**
|
|
* Derive the package-owned plugin record namespace without changing persisted names.
|
|
* @param name - complete experimental npm package name.
|
|
* @returns Capability suffix, or undefined for a non-experimental name.
|
|
*/
|
|
export function experimentalPackageRecordNamespace(name: string): string | undefined {
|
|
if (!isExperimentalPackageName(name)) return undefined
|
|
return name.slice(name.startsWith(EXPERIMENTAL_PACKAGE_NAME_PREFIX) ? EXPERIMENTAL_PACKAGE_NAME_PREFIX.length : '@deepseek-ai/dsh-'.length)
|
|
}
|
|
|
|
/** Experimental packages excluded from public releases and npm baselines. */
|
|
export const PRIVATE_EXPERIMENTAL_PACKAGE_DIRECTORIES: readonly string[] = []
|
|
|
|
/**
|
|
* Whether an experimental package publishes under the default-public policy.
|
|
* @param directory - repository-relative package directory.
|
|
* @param privateDirectories - experimental directories excluded from publication.
|
|
* @returns Whether the package publishes with the dsh family.
|
|
*/
|
|
export function isPublicExperimentalPackageDirectory(
|
|
directory: string,
|
|
privateDirectories: readonly string[] = PRIVATE_EXPERIMENTAL_PACKAGE_DIRECTORIES,
|
|
): boolean {
|
|
return /^packages\/experimental\/[^/]+$/.test(directory)
|
|
&& !privateDirectories.includes(directory)
|
|
}
|