@taskforcehq/taskforce 0.3.169 → 0.3.300

package/dist/shared/customTaxonomyLibrary.js

@@ -0,0 +1,276 @@
+function cloneOptions(options) {
+    return options.map((option) => ({
+        ...option,
+        aliases: Array.isArray(option.aliases) ? [...option.aliases] : undefined
+    }));
+}
+function cloneTaxonomies(taxonomies) {
+    return taxonomies.map((taxonomy) => ({
+        ...taxonomy,
+        aliases: Array.isArray(taxonomy.aliases) ? [...taxonomy.aliases] : undefined,
+        options: cloneOptions(Array.isArray(taxonomy.options) ? taxonomy.options : [])
+    }));
+}
+const BUILT_IN_CUSTOM_LIBRARY_PACKS = [
+    {
+        id: 'client-delivery',
+        label: 'Client Delivery',
+        description: 'Taxonomies for client-facing work, approvals, and service commitments.',
+        domainTag: 'operations',
+        bestFor: 'Agencies, consulting, and service delivery work.',
+        taxonomies: [
+            {
+                id: 'approval-stage',
+                label: 'Approval Stage',
+                description: 'Track where work sits in the client or internal approval pipeline.',
+                widgetType: 'select',
+                isSystem: false,
+                multiSelect: false,
+                isRequired: false,
+                formEnabled: true,
+                filterEnabled: true,
+                sortEnabled: true,
+                status: 'active',
+                options: [
+                    { value: 'draft', label: 'Draft', color: 'blue-200', icon: 'Pencil', status: 'active' },
+                    { value: 'internal-review', label: 'Internal Review', color: 'blue-500', icon: 'Users', status: 'active' },
+                    { value: 'client-review', label: 'Client Review', color: 'amber-500', icon: 'MessageSquare', status: 'active' },
+                    { value: 'approved', label: 'Approved', color: 'emerald-500', icon: 'CheckCircle', status: 'active' }
+                ]
+            },
+            {
+                id: 'service-line',
+                label: 'Service Line',
+                description: 'Identify which delivery lane owns or contributes to this work.',
+                widgetType: 'select',
+                isSystem: false,
+                multiSelect: true,
+                isRequired: false,
+                formEnabled: true,
+                filterEnabled: true,
+                sortEnabled: false,
+                status: 'active',
+                options: [
+                    { value: 'strategy', label: 'Strategy', color: 'violet-500', icon: 'Target', status: 'active' },
+                    { value: 'content', label: 'Content', color: 'sky-500', icon: 'Pencil', status: 'active' },
+                    { value: 'delivery', label: 'Delivery', color: 'emerald-500', icon: 'Briefcase', status: 'active' },
+                    { value: 'reporting', label: 'Reporting', color: 'amber-500', icon: 'Activity', status: 'active' }
+                ]
+            }
+        ]
+    },
+    {
+        id: 'content-operations',
+        label: 'Content Operations',
+        description: 'Reusable taxonomies for channels, publishing readiness, and editorial planning.',
+        domainTag: 'content',
+        bestFor: 'Editorial calendars, content teams, and publishing operations.',
+        taxonomies: [
+            {
+                id: 'content-channel',
+                label: 'Content Channel',
+                description: 'Show where a piece of work will be published or reused.',
+                widgetType: 'select',
+                isSystem: false,
+                multiSelect: true,
+                isRequired: false,
+                formEnabled: true,
+                filterEnabled: true,
+                sortEnabled: false,
+                status: 'active',
+                options: [
+                    { value: 'blog', label: 'Blog', color: 'blue-500', icon: 'FileText', status: 'active' },
+                    { value: 'email', label: 'Email', color: 'amber-500', icon: 'Mail', status: 'active' },
+                    { value: 'social', label: 'Social', color: 'violet-500', icon: 'Flag', status: 'active' },
+                    { value: 'webinar', label: 'Webinar', color: 'violet-500', icon: 'Video', status: 'active' }
+                ]
+            },
+            {
+                id: 'publish-readiness',
+                label: 'Publish Readiness',
+                description: 'Track whether a content task is ready to move into scheduling or release.',
+                widgetType: 'select',
+                isSystem: false,
+                multiSelect: false,
+                isRequired: true,
+                formEnabled: true,
+                filterEnabled: true,
+                sortEnabled: true,
+                status: 'active',
+                options: [
+                    { value: 'not-started', label: 'Not Started', color: 'blue-200', icon: 'Circle', status: 'active' },
+                    { value: 'in-review', label: 'In Review', color: 'amber-500', icon: 'Search', status: 'active' },
+                    { value: 'ready', label: 'Ready', color: 'emerald-500', icon: 'Rocket', status: 'active' }
+                ]
+            },
+            {
+                id: 'effort-band',
+                label: 'Effort Band',
+                description: 'A lightweight numeric scale for content effort without using complexity.',
+                widgetType: 'level',
+                isSystem: false,
+                multiSelect: false,
+                isRequired: false,
+                formEnabled: false,
+                filterEnabled: true,
+                sortEnabled: true,
+                status: 'active',
+                options: [
+                    { value: 1, label: 'Light', color: 'teal-500', icon: 'Wind', status: 'active' },
+                    { value: 2, label: 'Standard', color: 'blue-500', icon: 'Minus', status: 'active' },
+                    { value: 3, label: 'Heavy', color: 'orange-500', icon: 'Gauge', status: 'active' }
+                ]
+            }
+        ]
+    },
+    {
+        id: 'product-delivery',
+        label: 'Product Delivery',
+        description: 'Useful planning taxonomies for delivery stages, stakeholders, and delivery risk.',
+        domainTag: 'product',
+        bestFor: 'Product teams, implementation work, and cross-functional delivery.',
+        taxonomies: [
+            {
+                id: 'delivery-stage',
+                label: 'Delivery Stage',
+                description: 'Track how work moves from intake through active delivery.',
+                widgetType: 'select',
+                isSystem: false,
+                multiSelect: false,
+                isRequired: true,
+                formEnabled: true,
+                filterEnabled: true,
+                sortEnabled: true,
+                status: 'active',
+                options: [
+                    { value: 'backlog', label: 'Backlog', color: 'blue-200', icon: 'Inbox', status: 'active' },
+                    { value: 'scoping', label: 'Scoping', color: 'sky-500', icon: 'Search', status: 'active' },
+                    { value: 'ready', label: 'Ready', color: 'blue-500', icon: 'Check', status: 'active' },
+                    { value: 'in-flight', label: 'In Flight', color: 'indigo-500', icon: 'Play', status: 'active' },
+                    { value: 'blocked', label: 'Blocked', color: 'amber-500', icon: 'Pause', status: 'active' },
+                    { value: 'done', label: 'Done', color: 'green-500', icon: 'CheckCircle', status: 'active' }
+                ]
+            },
+            {
+                id: 'stakeholder',
+                label: 'Stakeholder',
+                description: 'Show which audience or stakeholder group is most relevant to the work.',
+                widgetType: 'select',
+                isSystem: false,
+                multiSelect: true,
+                isRequired: false,
+                formEnabled: true,
+                filterEnabled: true,
+                sortEnabled: false,
+                status: 'active',
+                options: [
+                    { value: 'internal', label: 'Internal', color: 'blue-500', icon: 'Users', status: 'active' },
+                    { value: 'client', label: 'Client', color: 'amber-500', icon: 'Briefcase', status: 'active' },
+                    { value: 'leadership', label: 'Leadership', color: 'violet-500', icon: 'Flag', status: 'active' },
+                    { value: 'partner', label: 'Partner', color: 'teal-500', icon: 'Globe', status: 'active' }
+                ]
+            },
+            {
+                id: 'risk-level',
+                label: 'Risk Level',
+                description: 'A simple signal for delivery or coordination risk.',
+                widgetType: 'level',
+                isSystem: false,
+                multiSelect: false,
+                isRequired: false,
+                formEnabled: false,
+                filterEnabled: true,
+                sortEnabled: true,
+                status: 'active',
+                options: [
+                    { value: 1, label: 'Low', color: 'teal-500', icon: 'Wind', status: 'active' },
+                    { value: 2, label: 'Medium', color: 'amber-500', icon: 'Gauge', status: 'active' },
+                    { value: 3, label: 'High', color: 'red-500', icon: 'TriangleAlert', status: 'active' }
+                ]
+            }
+        ]
+    },
+    {
+        id: 'content-production',
+        label: 'Content Production',
+        description: 'Production-oriented taxonomies for content stages, channels, and asset effort.',
+        domainTag: 'marketing',
+        bestFor: 'Marketing teams, campaigns, and multi-channel asset production.',
+        taxonomies: [
+            {
+                id: 'content-stage',
+                label: 'Content Stage',
+                description: 'Track where a content asset sits in the production lifecycle.',
+                widgetType: 'select',
+                isSystem: false,
+                multiSelect: false,
+                isRequired: true,
+                formEnabled: true,
+                filterEnabled: true,
+                sortEnabled: true,
+                status: 'active',
+                options: [
+                    { value: 'outline', label: 'Outline', color: 'blue-200', icon: 'Pencil', status: 'active' },
+                    { value: 'draft', label: 'Draft', color: 'blue-500', icon: 'FileText', status: 'active' },
+                    { value: 'review', label: 'Review', color: 'amber-500', icon: 'Search', status: 'active' },
+                    { value: 'approved', label: 'Approved', color: 'green-500', icon: 'CheckCircle', status: 'active' },
+                    { value: 'published', label: 'Published', color: 'violet-500', icon: 'Rocket', status: 'active' }
+                ]
+            },
+            {
+                id: 'distribution-channel',
+                label: 'Distribution Channel',
+                description: 'Capture where the asset will be published or promoted.',
+                widgetType: 'select',
+                isSystem: false,
+                multiSelect: true,
+                isRequired: false,
+                formEnabled: true,
+                filterEnabled: true,
+                sortEnabled: false,
+                status: 'active',
+                options: [
+                    { value: 'blog', label: 'Blog', color: 'blue-500', icon: 'FileText', status: 'active' },
+                    { value: 'email', label: 'Email', color: 'amber-500', icon: 'Mail', status: 'active' },
+                    { value: 'video', label: 'Video', color: 'violet-500', icon: 'Video', status: 'active' },
+                    { value: 'social', label: 'Social', color: 'indigo-500', icon: 'Flag', status: 'active' },
+                    { value: 'docs', label: 'Docs', color: 'sky-500', icon: 'Book', status: 'active' }
+                ]
+            },
+            {
+                id: 'asset-effort',
+                label: 'Asset Effort',
+                description: 'Estimate the relative production effort for a content asset.',
+                widgetType: 'level',
+                isSystem: false,
+                multiSelect: false,
+                isRequired: false,
+                formEnabled: false,
+                filterEnabled: true,
+                sortEnabled: true,
+                status: 'active',
+                options: [
+                    { value: 1, label: 'Quick', color: 'teal-500', icon: 'Wind', status: 'active' },
+                    { value: 2, label: 'Standard', color: 'blue-500', icon: 'Minus', status: 'active' },
+                    { value: 3, label: 'Campaign', color: 'orange-500', icon: 'Rocket', status: 'active' }
+                ]
+            }
+        ]
+    }
+];
+export function listBuiltInCustomTaxonomyLibraryPacks() {
+    return BUILT_IN_CUSTOM_LIBRARY_PACKS.map((pack) => ({
+        ...pack,
+        taxonomies: cloneTaxonomies(pack.taxonomies)
+    }));
+}
+export function getBuiltInCustomTaxonomyLibraryPack(packId) {
+    const normalizedPackId = String(packId || '').trim().toLowerCase();
+    const pack = BUILT_IN_CUSTOM_LIBRARY_PACKS.find((entry) => entry.id === normalizedPackId);
+    if (!pack)
+        return null;
+    return {
+        ...pack,
+        taxonomies: cloneTaxonomies(pack.taxonomies)
+    };
+}

package/dist/shared/customTaxonomyLibrary.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/shared/customTaxonomyLibrary.test.js

@@ -0,0 +1,20 @@
+import { describe, expect, it } from 'vitest';
+import { getBuiltInCustomTaxonomyLibraryPack, listBuiltInCustomTaxonomyLibraryPacks } from './customTaxonomyLibrary';
+describe('customTaxonomyLibrary', () => {
+    it('includes the expanded built-in custom taxonomy packs', () => {
+        const packs = listBuiltInCustomTaxonomyLibraryPacks();
+        expect(packs.map((pack) => pack.id)).toEqual(expect.arrayContaining([
+            'client-delivery',
+            'content-operations',
+            'product-delivery',
+            'content-production'
+        ]));
+    });
+    it('returns cloned pack definitions', () => {
+        const pack = getBuiltInCustomTaxonomyLibraryPack('product-delivery');
+        expect(pack?.label).toBe('Product Delivery');
+        pack?.taxonomies[0]?.options?.push({ value: 'test', label: 'Test' });
+        const freshPack = getBuiltInCustomTaxonomyLibraryPack('product-delivery');
+        expect(freshPack?.taxonomies[0]?.options).not.toEqual(expect.arrayContaining([expect.objectContaining({ value: 'test' })]));
+    });
+});

package/dist/shared/taxonomyCatalog.d.ts

@@ -0,0 +1,19 @@
+import type { TaxonomyDefinition } from '../types';
+import type { NormalizedWorkspaceTaxonomyState } from './taxonomyState.js';
+export type TaxonomyCatalogItemKind = 'system' | 'custom' | 'attribute';
+export interface TaxonomyCatalogItem {
+    id: string;
+    label: string;
+    kind: TaxonomyCatalogItemKind;
+    summary: string;
+    taxonomy?: TaxonomyDefinition;
+}
+export interface BuildTaxonomyCatalogInput {
+    categories: NormalizedWorkspaceTaxonomyState['categories'];
+    types: NormalizedWorkspaceTaxonomyState['types'];
+    priorities: NormalizedWorkspaceTaxonomyState['priorities'];
+    taxonomies: TaxonomyDefinition[];
+    manualComplexityEnabled: boolean;
+    displayLabels?: NormalizedWorkspaceTaxonomyState['displayLabels'];
+}
+export declare function buildTaxonomyCatalog(input: BuildTaxonomyCatalogInput): TaxonomyCatalogItem[];

package/dist/shared/taxonomyCatalog.js

@@ -0,0 +1,36 @@
+export function buildTaxonomyCatalog(input) {
+    const systemItems = [
+        {
+            id: 'categories',
+            label: input.displayLabels?.category || 'Categories',
+            kind: 'system',
+            summary: `${input.categories.length} configured`
+        },
+        {
+            id: 'types',
+            label: input.displayLabels?.type || 'Task Types',
+            kind: 'system',
+            summary: `${input.types.length} active`
+        },
+        {
+            id: 'priorities',
+            label: input.displayLabels?.priority || 'Priority Levels',
+            kind: 'system',
+            summary: `${input.priorities.length} levels`
+        },
+        {
+            id: 'complexities',
+            label: 'Complexity',
+            kind: 'attribute',
+            summary: input.manualComplexityEnabled ? 'Enabled' : 'Disabled (default)'
+        }
+    ];
+    const customItems = input.taxonomies.map((taxonomy) => ({
+        id: taxonomy.id,
+        label: taxonomy.label,
+        kind: 'custom',
+        summary: `${taxonomy.options.length} options${taxonomy.status === 'retired' ? ' · Retired' : ''}`,
+        taxonomy
+    }));
+    return [...systemItems, ...customItems];
+}

package/dist/shared/taxonomyDefaults.d.ts

@@ -0,0 +1,29 @@
+export interface DefaultCategoryDefinition {
+    value: string;
+    label: string;
+    icon?: string;
+    color?: string;
+}
+export interface DefaultTypeDefinition {
+    value: string;
+    label: string;
+    icon?: string;
+    color?: string;
+}
+export interface DefaultPriorityDefinition {
+    value: number;
+    label: string;
+    color?: string;
+    icon?: string;
+}
+export declare const DEFAULT_CATEGORY_VALUE = "default";
+export declare const DEFAULT_CATEGORY_LABEL = "General";
+export declare const DEFAULT_TYPE_VALUE = "task";
+export declare const DEFAULT_PRIORITY_VALUE = 2;
+export declare const EMERGENCY_CATEGORY_DEFINITIONS: readonly DefaultCategoryDefinition[];
+export declare const EMERGENCY_TYPE_DEFINITIONS: readonly DefaultTypeDefinition[];
+export declare const EMERGENCY_PRIORITY_DEFINITIONS: readonly DefaultPriorityDefinition[];
+export declare function cloneDefaultCategoryDefinitions(): DefaultCategoryDefinition[];
+export declare function cloneDefaultTypeDefinitions(): DefaultTypeDefinition[];
+export declare function getDefaultTypeDefinition(typeValue?: string | null): DefaultTypeDefinition | undefined;
+export declare function cloneDefaultPriorityDefinitions(): DefaultPriorityDefinition[];

package/dist/shared/taxonomyDefaults.js

@@ -0,0 +1,26 @@
+export const DEFAULT_CATEGORY_VALUE = 'default';
+export const DEFAULT_CATEGORY_LABEL = 'General';
+export const DEFAULT_TYPE_VALUE = 'task';
+export const DEFAULT_PRIORITY_VALUE = 2;
+export const EMERGENCY_CATEGORY_DEFINITIONS = [
+    { value: DEFAULT_CATEGORY_VALUE, label: DEFAULT_CATEGORY_LABEL, icon: 'Inbox' }
+];
+export const EMERGENCY_TYPE_DEFINITIONS = [
+    { value: DEFAULT_TYPE_VALUE, label: 'Task', icon: 'CheckSquare', color: 'blue-500' }
+];
+export const EMERGENCY_PRIORITY_DEFINITIONS = [
+    { value: DEFAULT_PRIORITY_VALUE, label: 'Medium', color: 'blue-500', icon: 'Minus' }
+];
+export function cloneDefaultCategoryDefinitions() {
+    return EMERGENCY_CATEGORY_DEFINITIONS.map((category) => ({ ...category }));
+}
+export function cloneDefaultTypeDefinitions() {
+    return EMERGENCY_TYPE_DEFINITIONS.map((type) => ({ ...type }));
+}
+export function getDefaultTypeDefinition(typeValue) {
+    const normalizedValue = String(typeValue || '').trim().toLowerCase();
+    return EMERGENCY_TYPE_DEFINITIONS.find((type) => type.value === normalizedValue);
+}
+export function cloneDefaultPriorityDefinitions() {
+    return EMERGENCY_PRIORITY_DEFINITIONS.map((priority) => ({ ...priority }));
+}

package/dist/shared/taxonomyLibrary.d.ts

@@ -0,0 +1,15 @@
+import type { CategoryConfig, PriorityDefinition } from '../types';
+import type { TaxonomyTypeDefinition } from './taxonomyState.js';
+export interface TaxonomyLibraryPack {
+    id: string;
+    label: string;
+    description: string;
+    categories: CategoryConfig[];
+    types: TaxonomyTypeDefinition[];
+    priorities: PriorityDefinition[];
+    isDefaultStarter?: boolean;
+}
+export declare function listBuiltInTaxonomyLibraryPacks(): TaxonomyLibraryPack[];
+export declare function getBuiltInTaxonomyLibraryPack(packId: string): TaxonomyLibraryPack | null;
+export declare function getDefaultStarterTaxonomyLibraryPack(): TaxonomyLibraryPack;
+export declare function getEmergencyStarterTaxonomyLibraryPack(): TaxonomyLibraryPack;

package/dist/shared/taxonomyLibrary.js

@@ -0,0 +1,98 @@
+import { DEFAULT_CATEGORY_LABEL, DEFAULT_CATEGORY_VALUE } from './taxonomyDefaults.js';
+function cloneCategories(categories) {
+    return categories.map((category) => ({ ...category }));
+}
+function cloneTypes(types) {
+    return types.map((type) => ({ ...type }));
+}
+function clonePriorities(priorities) {
+    return priorities.map((priority) => ({ ...priority }));
+}
+const SOFTWARE_DEVELOPMENT_PACK = {
+    id: 'software-development',
+    label: 'Software Development',
+    description: 'A software-oriented starter pack with developer-focused work types and a 4-level priority scale.',
+    categories: [
+        { value: 'default', label: 'General', icon: 'Inbox' },
+        { value: 'product', label: 'Product', icon: 'Layers', color: 'blue-500' },
+        { value: 'ui-ux', label: 'UI/UX', icon: 'Palette', color: 'violet-500' },
+        { value: 'backend', label: 'Backend', icon: 'Server', color: 'emerald-500' }
+    ],
+    types: [
+        { value: 'feature', label: 'Feature', icon: 'Star', color: 'teal-500', status: 'active' },
+        { value: 'bug', label: 'Bug', icon: 'Bug', color: 'red-500', status: 'active' },
+        { value: 'chore', label: 'Chore', icon: 'Zap', color: 'amber-500', status: 'active' },
+        { value: 'refactor', label: 'Refactor', icon: 'Code', color: 'blue-500', status: 'active' },
+        { value: 'documentation', label: 'Docs', icon: 'Book', color: 'sky-500', status: 'active' }
+    ],
+    priorities: [
+        { value: 1, label: 'Low', color: 'amber-200', icon: 'ArrowDown' },
+        { value: 2, label: 'Medium', color: 'yellow-500', icon: 'Minus' },
+        { value: 3, label: 'High', color: 'orange-500', icon: 'ArrowUp' },
+        { value: 4, label: 'Critical', color: 'red-500', icon: 'AlertTriangle' }
+    ]
+};
+const BUILT_IN_LIBRARY_PACKS = [
+    {
+        id: 'general',
+        label: 'General',
+        description: 'A neutral starter pack for broad project and AI collaboration workflows.',
+        isDefaultStarter: true,
+        categories: [
+            { value: DEFAULT_CATEGORY_VALUE, label: DEFAULT_CATEGORY_LABEL, icon: 'Inbox' }
+        ],
+        types: [
+            { value: 'task', label: 'Task', icon: 'CheckSquare', color: 'blue-500', status: 'active' },
+            { value: 'deliverable', label: 'Deliverable', icon: 'Package', color: 'teal-500', status: 'active' },
+            { value: 'issue', label: 'Issue', icon: 'AlertCircle', color: 'red-500', status: 'active' },
+            { value: 'idea', label: 'Idea', icon: 'Lightbulb', color: 'amber-500', status: 'active' },
+            { value: 'review', label: 'Review', icon: 'Search', color: 'violet-500', status: 'active' }
+        ],
+        priorities: [
+            { value: 1, label: 'Low', color: 'teal-500', icon: 'ArrowDown' },
+            { value: 2, label: 'Medium', color: 'blue-500', icon: 'Minus' },
+            { value: 3, label: 'High', color: 'amber-500', icon: 'ArrowUp' }
+        ]
+    },
+    SOFTWARE_DEVELOPMENT_PACK
+];
+export function listBuiltInTaxonomyLibraryPacks() {
+    return BUILT_IN_LIBRARY_PACKS.map((pack) => ({
+        ...pack,
+        categories: cloneCategories(pack.categories),
+        types: cloneTypes(pack.types),
+        priorities: clonePriorities(pack.priorities)
+    }));
+}
+export function getBuiltInTaxonomyLibraryPack(packId) {
+    const normalizedPackId = String(packId || '').trim().toLowerCase();
+    const pack = BUILT_IN_LIBRARY_PACKS.find((entry) => entry.id === normalizedPackId);
+    if (!pack)
+        return null;
+    return {
+        ...pack,
+        categories: cloneCategories(pack.categories),
+        types: cloneTypes(pack.types),
+        priorities: clonePriorities(pack.priorities)
+    };
+}
+export function getDefaultStarterTaxonomyLibraryPack() {
+    return getBuiltInTaxonomyLibraryPack(BUILT_IN_LIBRARY_PACKS.find((pack) => pack.isDefaultStarter)?.id || 'general') || {
+        id: 'general',
+        label: 'General',
+        description: 'A neutral starter pack for broad project and AI collaboration workflows.',
+        categories: [{ value: DEFAULT_CATEGORY_VALUE, label: DEFAULT_CATEGORY_LABEL, icon: 'Inbox' }],
+        types: [{ value: 'task', label: 'Task', icon: 'CheckSquare', color: 'blue-500', status: 'active' }],
+        priorities: [{ value: 2, label: 'Medium', color: 'blue-500', icon: 'Minus' }]
+    };
+}
+export function getEmergencyStarterTaxonomyLibraryPack() {
+    return {
+        id: 'emergency-general',
+        label: 'Emergency General',
+        description: 'Minimal emergency fallback when no library-backed starter pack can be resolved.',
+        categories: [{ value: DEFAULT_CATEGORY_VALUE, label: DEFAULT_CATEGORY_LABEL, icon: 'Inbox' }],
+        types: [{ value: 'task', label: 'Task', icon: 'CheckSquare', color: 'blue-500', status: 'active' }],
+        priorities: [{ value: 2, label: 'Medium', color: 'blue-500', icon: 'Minus' }]
+    };
+}

package/dist/shared/taxonomyLibrary.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/shared/taxonomyLibrary.test.js

@@ -0,0 +1,26 @@
+import { describe, expect, it } from 'vitest';
+import { getDefaultStarterTaxonomyLibraryPack, listBuiltInTaxonomyLibraryPacks } from './taxonomyLibrary.js';
+describe('taxonomyLibrary', () => {
+    it('includes General and Software Development starter packs', () => {
+        const packs = listBuiltInTaxonomyLibraryPacks();
+        expect(packs.map((pack) => pack.id)).toEqual(['general', 'software-development']);
+        expect(packs.find((pack) => pack.id === 'general')).toEqual(expect.objectContaining({
+            label: 'General'
+        }));
+        expect(packs.find((pack) => pack.id === 'software-development')).toEqual(expect.objectContaining({
+            label: 'Software Development'
+        }));
+    });
+    it('returns cloned pack payloads so callers cannot mutate the source definitions', () => {
+        const [firstCallPack] = listBuiltInTaxonomyLibraryPacks();
+        firstCallPack.categories[0].label = 'Changed';
+        const [secondCallPack] = listBuiltInTaxonomyLibraryPacks();
+        expect(secondCallPack.categories[0].label).toBe('General');
+    });
+    it('marks General as the default starter pack', () => {
+        const pack = getDefaultStarterTaxonomyLibraryPack();
+        expect(pack.id).toBe('general');
+        expect(pack.types.map((type) => type.value)).toEqual(['task', 'deliverable', 'issue', 'idea', 'review']);
+        expect(pack.priorities.map((priority) => priority.value)).toEqual([1, 2, 3]);
+    });
+});

package/dist/shared/taxonomyState.d.ts

@@ -0,0 +1,36 @@
+import type { CategoryConfig, TaxonomyDefinition } from '../types';
+export interface FirstClassTaxonomyDisplayLabels {
+    category?: string;
+    type?: string;
+    priority?: string;
+}
+export type TaxonomyTypeDefinition = {
+    value: string;
+    label: string;
+    icon?: string;
+    color?: string;
+    aliases?: string[];
+    status?: 'active' | 'retired';
+};
+export type TaxonomyPriorityDefinition = {
+    value: number;
+    label: string;
+    color?: string;
+    icon?: string;
+};
+export interface WorkspaceTaxonomyState {
+    categories?: Array<string | CategoryConfig>;
+    types?: TaxonomyTypeDefinition[];
+    priorities?: TaxonomyPriorityDefinition[];
+    taxonomies?: TaxonomyDefinition[];
+    displayLabels?: FirstClassTaxonomyDisplayLabels;
+}
+export interface NormalizedWorkspaceTaxonomyState {
+    categories: CategoryConfig[];
+    types: TaxonomyTypeDefinition[];
+    priorities: TaxonomyPriorityDefinition[];
+    taxonomies: TaxonomyDefinition[];
+    displayLabels: FirstClassTaxonomyDisplayLabels;
+}
+export declare function hasWorkspaceTaxonomyStatePayload(input: unknown): input is WorkspaceTaxonomyState;
+export declare function normalizeWorkspaceTaxonomyStatePayload(input: WorkspaceTaxonomyState | null | undefined): NormalizedWorkspaceTaxonomyState;