@schnick371/devsteps-shared 1.1.0-next.3 → 2.0.0-next.1

package/dist/core/child-relations.js

@@ -0,0 +1,50 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * The types a new item can take when it is created under a parent item, each with the relation
+ * from the new item to the parent. Which pairs are allowed comes from `validateRelationship`,
+ * the one source of the relationship rules; this module only names the relation each kind of
+ * child uses.
+ * @see STORY-535
+ */
+import { ItemType } from '../schemas/index.js';
+import { isCrossCutting } from './decision-question.js';
+import { validateRelationship } from './validation.js';
+/** Top types implement nothing; a new one sits beside a peer of its own type. */
+const TOP_TYPES = ['epic', 'requirement'];
+function accepts(child, parent, relation, methodology) {
+    const source = { id: `${child}-new`, type: child };
+    const target = { id: `${parent}-parent`, type: parent };
+    return validateRelationship(source, target, relation, methodology).valid;
+}
+function relationFor(child, parent, methodology) {
+    // A doc documents its parent; doc to doc is the BOM's structure and stays refused.
+    if (child === 'doc') {
+        return accepts(child, parent, 'documents', methodology) ? 'documents' : undefined;
+    }
+    // A decision or question relates to the work item it decides for or asks about.
+    if (isCrossCutting(child))
+        return isCrossCutting(parent) ? undefined : 'relates-to';
+    if (TOP_TYPES.includes(child))
+        return child === parent ? 'relates-to' : undefined;
+    if (!accepts(child, parent, 'implements', methodology))
+        return undefined;
+    // A TEST run needs a direct tests link to the item it accepts (TASK-812).
+    return child === 'test' ? 'tests' : 'implements';
+}
+/**
+ * The types a new item can take under an item of `parentType`, in the order of the item type
+ * enum, each with the relation that links the new item to the parent. Empty when nothing can be
+ * created under the parent.
+ */
+export function childRelationsFor(parentType, methodology) {
+    const options = [];
+    for (const type of ItemType.options) {
+        const relation = relationFor(type, parentType, methodology);
+        if (relation)
+            options.push({ type, relation });
+    }
+    return options;
+}
+//# sourceMappingURL=child-relations.js.map

package/dist/core/child-relations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"child-relations.js","sourceRoot":"","sources":["../../src/core/child-relations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,QAAQ,EAAoB,MAAM,qBAAqB,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAYvD,iFAAiF;AACjF,MAAM,SAAS,GAAwB,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAE/D,SAAS,OAAO,CACd,KAAe,EACf,MAAgB,EAChB,QAAgB,EAChB,WAAwB;IAExB,MAAM,MAAM,GAAG,EAAE,EAAE,EAAE,GAAG,KAAK,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IACnD,MAAM,MAAM,GAAG,EAAE,EAAE,EAAE,GAAG,MAAM,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IACxD,OAAO,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,KAAK,CAAC;AAC3E,CAAC;AAED,SAAS,WAAW,CAClB,KAAe,EACf,MAAgB,EAChB,WAAwB;IAExB,mFAAmF;IACnF,IAAI,KAAK,KAAK,KAAK,EAAE,CAAC;QACpB,OAAO,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;IACpF,CAAC;IACD,gFAAgF;IAChF,IAAI,cAAc,CAAC,KAAK,CAAC;QAAE,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC;IACpF,IAAI,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC;IAClF,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,WAAW,CAAC;QAAE,OAAO,SAAS,CAAC;IACzE,0EAA0E;IAC1E,OAAO,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC;AACnD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC/B,UAAoB,EACpB,WAAwB;IAExB,MAAM,OAAO,GAA0B,EAAE,CAAC;IAC1C,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;QACpC,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;QAC5D,IAAI,QAAQ;YAAE,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/core/classification-defaults.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Built-in facets. ISO/IEC 25010:2023 seeds the concerns, SWEBOK v4 the
+ * activities, user-story practice the roles. A project file extends or
+ * overrides any of them; these lists are seed, not law.
+ *
+ * @see STORY-420 TASK-828
+ */
+import type { ActivityNode, FacetNode } from './classification-registry.js';
+/** ISO/IEC 25010:2023 characteristics plus observability; sub-characteristics as aliases. */
+export declare const DEFAULT_CONCERNS: Record<string, FacetNode>;
+/** SWEBOK v4 knowledge areas reduced to the eight kinds of work a backlog holds. */
+export declare const DEFAULT_ACTIVITIES: Record<string, ActivityNode>;
+/** Canonical role → phrases found in `As a <role> I want …`. */
+export declare const DEFAULT_ROLES: Record<string, string[]>;
+/** Types that must carry a registry category unless the project file says otherwise. */
+export declare const DEFAULT_REQUIRED: Record<string, string[]>;
+//# sourceMappingURL=classification-defaults.d.ts.map

package/dist/core/classification-defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classification-defaults.d.ts","sourceRoot":"","sources":["../../src/core/classification-defaults.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAE5E,6FAA6F;AAC7F,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAuItD,CAAC;AAEF,oFAAoF;AACpF,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAkF3D,CAAC;AAEF,gEAAgE;AAChE,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAelD,CAAC;AAEF,wFAAwF;AACxF,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAErD,CAAC"}

package/dist/core/classification-defaults.js

@@ -0,0 +1,253 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Built-in facets. ISO/IEC 25010:2023 seeds the concerns, SWEBOK v4 the
+ * activities, user-story practice the roles. A project file extends or
+ * overrides any of them; these lists are seed, not law.
+ *
+ * @see STORY-420 TASK-828
+ */
+/** ISO/IEC 25010:2023 characteristics plus observability; sub-characteristics as aliases. */
+export const DEFAULT_CONCERNS = {
+    security: {
+        q: 'Does it change who may do what, or how secrets and access are handled?',
+        aliases: [
+            'security',
+            'sicherheit',
+            'rbac',
+            'authentication',
+            'authorization',
+            'audit',
+            'hardening',
+            'access control',
+            'secret',
+            'credential',
+            'permission',
+        ],
+    },
+    'privacy-compliance': {
+        q: 'Does it exist because of a legal or data-protection obligation?',
+        aliases: [
+            'privacy',
+            'datenschutz',
+            'dsgvo',
+            'gdpr',
+            'compliance',
+            'data protection',
+            'legal',
+            'retention',
+        ],
+    },
+    reliability: {
+        q: 'Does it keep data or service intact under failure?',
+        aliases: [
+            'reliability',
+            'autosave',
+            'persistence',
+            'backup',
+            'disaster recovery',
+            'business continuity',
+            'robust',
+            'atomic',
+            'recovery',
+            'resilien',
+            'integrity',
+            'consistency',
+        ],
+    },
+    performance: {
+        q: 'Does it change speed, throughput, memory or cost?',
+        aliases: [
+            'performance',
+            'speed',
+            'scalab',
+            'optimization',
+            'optimierung',
+            'gpu',
+            'cache',
+            'latency',
+            'token',
+            'efficien',
+        ],
+    },
+    usability: {
+        q: 'Does it change how a person experiences the product?',
+        aliases: [
+            'usability',
+            'ux',
+            'polish',
+            'styling',
+            'user experience',
+            'interaction',
+            'onboarding',
+        ],
+    },
+    accessibility: {
+        q: 'Does it make the product usable with assistive technology?',
+        aliases: ['accessibility', 'wcag', 'a11y', 'barrierefrei', 'screen reader'],
+    },
+    maintainability: {
+        q: 'Does it make the code easier to change without adding user value?',
+        aliases: [
+            'maintainab',
+            'refactor',
+            'dependency update',
+            'tech debt',
+            'cleanup',
+            'hygiene',
+            'modular',
+            'simplif',
+            'duplication',
+            'code quality',
+            'dead code',
+        ],
+    },
+    compatibility: {
+        q: 'Does it concern interplay with another system or API contract?',
+        aliases: [
+            'compatib',
+            'integration',
+            'api contract',
+            'interoperab',
+            'protocol',
+            'third-party',
+            'external system',
+        ],
+    },
+    flexibility: {
+        q: 'Does it concern running or installing on another platform or configuration?',
+        aliases: [
+            'portab',
+            'cross-platform',
+            'installer',
+            'installab',
+            'windows',
+            'linux',
+            'docker',
+            'container',
+            'adaptab',
+            'configurab',
+            'tenant',
+        ],
+    },
+    observability: {
+        q: 'Does it make runtime behaviour visible?',
+        aliases: [
+            'observab',
+            'monitoring',
+            'logging',
+            'metrics',
+            'telemetry',
+            'tracing',
+            'prometheus',
+            'health',
+        ],
+    },
+};
+/** SWEBOK v4 knowledge areas reduced to the eight kinds of work a backlog holds. */
+export const DEFAULT_ACTIVITIES = {
+    research: {
+        types: ['spike'],
+        aliases: [
+            'research',
+            'evaluat',
+            'assessment',
+            'investigat',
+            'brief',
+            'proof of concept',
+            'poc',
+            'analyse',
+            'analysis',
+        ],
+    },
+    design: {
+        aliases: [
+            'architecture',
+            'architektur',
+            'design',
+            'adr',
+            'data model',
+            'datenmodell',
+            'concept',
+            'specification',
+            'strategy',
+            'zielbild',
+            'contract',
+        ],
+    },
+    construction: {
+        default_for: ['story', 'task', 'feature', 'epic', 'requirement', 'bug'],
+        aliases: ['implement', 'build', 'feature', 'create', 'develop'],
+    },
+    testing: {
+        types: ['test'],
+        aliases: [
+            'test',
+            'e2e',
+            'qa',
+            'quality assurance',
+            'coverage',
+            'bats',
+            'vitest',
+            'playwright',
+            'acceptance',
+        ],
+    },
+    operations: {
+        aliases: [
+            'deploy',
+            'release',
+            'ci/cd',
+            'cicd',
+            'gitlab ci',
+            'installer',
+            'publish',
+            'rollout',
+            'infrastructure',
+            'devops',
+            'server',
+        ],
+    },
+    documentation: {
+        types: ['doc'],
+        aliases: ['documentation', 'dokumentation', 'handbook', 'readme', 'docs', 'diataxis', 'manual'],
+    },
+    migration: {
+        aliases: ['migration', 'migrate', 'upgrade', 'umstellen', 'convert', 'umzug', 'consolidat'],
+    },
+    maintenance: {
+        aliases: [
+            'maintenance',
+            'wartung',
+            'dependency',
+            'groom',
+            'hygiene',
+            'quarterly',
+            'cleanup',
+            'obsolete',
+        ],
+    },
+};
+/** Canonical role → phrases found in `As a <role> I want …`. */
+export const DEFAULT_ROLES = {
+    developer: ['developer', 'entwickler', 'engineer'],
+    maintainer: ['maintainer'],
+    operator: ['operator', 'betreiber'],
+    administrator: ['administrator', 'admin'],
+    user: ['user', 'nutzer', 'anwender'],
+    learner: ['learner', 'lernende', 'student'],
+    'content-manager': ['content manager', 'author', 'autor', 'editor'],
+    'data-protection-officer': ['data protection officer', 'datenschutz'],
+    'devops-engineer': ['devops'],
+    architect: ['architect'],
+    'team-lead': ['team lead', 'technical lead', 'teamleiter'],
+    agent: ['agent', 'copilot', 'claude'],
+    packager: ['packager', 'release manager'],
+    'backlog-keeper': ['backlog keeper', 'product owner'],
+};
+/** Types that must carry a registry category unless the project file says otherwise. */
+export const DEFAULT_REQUIRED = {
+    category: ['epic', 'story', 'requirement', 'feature'],
+};
+//# sourceMappingURL=classification-defaults.js.map

package/dist/core/classification-defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classification-defaults.js","sourceRoot":"","sources":["../../src/core/classification-defaults.ts"],"names":[],"mappings":"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"}

package/dist/core/classification-exports.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Core barrel, classification part: the category registry, its gate, leaves, resolution,
+ * scoring and snapshot. Re-exported unchanged through `core/index.ts`.
+ */
+export { applyClassificationGate, type ClassificationGate, ClassificationGateError, type FacetSuggestions, type GateArgs, type GateKind, type GateNext, type GateNode, type GateResult, resolveConcernTags, suggestFacets, } from './classification-gate.js';
+export { type CategoryLeaf, countOpenByCategory, getCategoryLeaf, type LeafItem, leafReceipt, summarize, } from './classification-leaf.js';
+export { CLASSIFICATION_FILE, type ClassificationFile, ClassificationFileSchema, type ClassificationRegistry, ClassificationRegistryError, canonicalJson, DEFAULT_ACTIVITIES, DEFAULT_CONCERNS, DEFAULT_REQUIRED, DEFAULT_ROLES, FACET_QUESTIONS, type FacetKey, type FacetNode, loadClassificationRegistry, NodeStatus, readClassificationFile, UNCLASSIFIED, writeClassificationFile, } from './classification-registry.js';
+export { REGISTRY_ACTIONS, REGISTRY_FACETS, type RegistryAction, type RegistryActionInput, type RegistryActionResult, runRegistryAction, } from './classification-registry-action.js';
+export { addRegistryNode, confirmRegistryNode, deprecateRegistryNode, type MutableFacet, type NewNode, renameRegistryNode, } from './classification-registry-ops.js';
+export { levenshtein, type NodeResolution, type ResolvableNodes, resolveNode, slugify, } from './classification-resolve.js';
+export { activityFor, aliasHits, type ClassifiableItem, classifyItem, componentsFromPaths, type FacetHit, type ItemClassification, roleFromStory, scoreNodes, } from './classification-score.js';
+export { buildClassificationSnapshot, type ClassificationSnapshot, type ClassificationSnapshotArgs, type ClassifiedItem, DEFAULT_SNAPSHOT_TYPES, type FacetSummary, OPEN_STATUSES, } from './classification-snapshot.js';
+//# sourceMappingURL=classification-exports.d.ts.map

package/dist/core/classification-exports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classification-exports.d.ts","sourceRoot":"","sources":["../../src/core/classification-exports.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,uBAAuB,EACvB,KAAK,kBAAkB,EACvB,uBAAuB,EACvB,KAAK,gBAAgB,EACrB,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,kBAAkB,EAClB,aAAa,GACd,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,KAAK,YAAY,EACjB,mBAAmB,EACnB,eAAe,EACf,KAAK,QAAQ,EACb,WAAW,EACX,SAAS,GACV,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,mBAAmB,EACnB,KAAK,kBAAkB,EACvB,wBAAwB,EACxB,KAAK,sBAAsB,EAC3B,2BAA2B,EAC3B,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,0BAA0B,EAC1B,UAAU,EACV,sBAAsB,EACtB,YAAY,EACZ,uBAAuB,GACxB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,iBAAiB,GAClB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EACrB,KAAK,YAAY,EACjB,KAAK,OAAO,EACZ,kBAAkB,GACnB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,WAAW,EACX,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,WAAW,EACX,OAAO,GACR,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,WAAW,EACX,SAAS,EACT,KAAK,gBAAgB,EACrB,YAAY,EACZ,mBAAmB,EACnB,KAAK,QAAQ,EACb,KAAK,kBAAkB,EACvB,aAAa,EACb,UAAU,GACX,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,2BAA2B,EAC3B,KAAK,sBAAsB,EAC3B,KAAK,0BAA0B,EAC/B,KAAK,cAAc,EACnB,sBAAsB,EACtB,KAAK,YAAY,EACjB,aAAa,GACd,MAAM,8BAA8B,CAAC"}

package/dist/core/classification-exports.js

@@ -0,0 +1,16 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Core barrel, classification part: the category registry, its gate, leaves, resolution,
+ * scoring and snapshot. Re-exported unchanged through `core/index.ts`.
+ */
+export { applyClassificationGate, ClassificationGateError, resolveConcernTags, suggestFacets, } from './classification-gate.js';
+export { countOpenByCategory, getCategoryLeaf, leafReceipt, summarize, } from './classification-leaf.js';
+export { CLASSIFICATION_FILE, ClassificationFileSchema, ClassificationRegistryError, canonicalJson, DEFAULT_ACTIVITIES, DEFAULT_CONCERNS, DEFAULT_REQUIRED, DEFAULT_ROLES, FACET_QUESTIONS, loadClassificationRegistry, NodeStatus, readClassificationFile, UNCLASSIFIED, writeClassificationFile, } from './classification-registry.js';
+export { REGISTRY_ACTIONS, REGISTRY_FACETS, runRegistryAction, } from './classification-registry-action.js';
+export { addRegistryNode, confirmRegistryNode, deprecateRegistryNode, renameRegistryNode, } from './classification-registry-ops.js';
+export { levenshtein, resolveNode, slugify, } from './classification-resolve.js';
+export { activityFor, aliasHits, classifyItem, componentsFromPaths, roleFromStory, scoreNodes, } from './classification-score.js';
+export { buildClassificationSnapshot, DEFAULT_SNAPSHOT_TYPES, OPEN_STATUSES, } from './classification-snapshot.js';
+//# sourceMappingURL=classification-exports.js.map

package/dist/core/classification-exports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classification-exports.js","sourceRoot":"","sources":["../../src/core/classification-exports.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,uBAAuB,EAEvB,uBAAuB,EAOvB,kBAAkB,EAClB,aAAa,GACd,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAEL,mBAAmB,EACnB,eAAe,EAEf,WAAW,EACX,SAAS,GACV,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,mBAAmB,EAEnB,wBAAwB,EAExB,2BAA2B,EAC3B,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,eAAe,EAGf,0BAA0B,EAC1B,UAAU,EACV,sBAAsB,EACtB,YAAY,EACZ,uBAAuB,GACxB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,gBAAgB,EAChB,eAAe,EAIf,iBAAiB,GAClB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EAGrB,kBAAkB,GACnB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,WAAW,EAGX,WAAW,EACX,OAAO,GACR,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,WAAW,EACX,SAAS,EAET,YAAY,EACZ,mBAAmB,EAGnB,aAAa,EACb,UAAU,GACX,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,2BAA2B,EAI3B,sBAAsB,EAEtB,aAAa,GACd,MAAM,8BAA8B,CAAC"}

package/dist/core/classification-gate.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * The classification gate runs inside `addItem` before anything is written.
+ * For the types the registry requires, the category must resolve to a node and
+ * the caller must present the receipt of that node's leaf. Every refusal carries
+ * what the caller needs next: the nodes and their questions, the nearest names,
+ * or the current leaf with its receipt.
+ *
+ * @see STORY-421 TASK-835
+ */
+import { type CategoryLeaf } from './classification-leaf.js';
+import { type ClassificationRegistry } from './classification-registry.js';
+import { type NewNode } from './classification-registry-ops.js';
+import { type FacetHit } from './classification-score.js';
+export type GateKind = 'missing_category' | 'unknown_category' | 'deprecated_category' | 'missing_receipt' | 'stale_receipt';
+export interface GateNode {
+    name: string;
+    q?: string;
+    status?: string;
+    open_count: number;
+}
+/** What to send next: the retry arguments, or the parameter still missing. */
+export interface GateNext {
+    tool: 'add' | 'update';
+    arguments?: Record<string, unknown>;
+    supply?: string;
+}
+/** Facets the scorer suggests for a new item; the caller confirms by passing tags. */
+export interface FacetSuggestions {
+    concern?: FacetHit[];
+    /** A story whose title does not read `As a <role> I want …`. */
+    role_missing?: true;
+}
+export interface ClassificationGate {
+    kind: GateKind;
+    category?: string;
+    nodes?: GateNode[];
+    candidates?: GateNode[];
+    successors?: string[];
+    leaf?: CategoryLeaf;
+    next?: GateNext;
+    facet_suggestions?: FacetSuggestions;
+    hint: string;
+}
+export declare class ClassificationGateError extends Error {
+    readonly gate: ClassificationGate;
+    constructor(message: string, gate: ClassificationGate);
+}
+export interface GateArgs {
+    type: string;
+    title?: string;
+    description?: string;
+    category?: string;
+    tags?: string[];
+    leaf_receipt?: string;
+    new_node?: NewNode;
+}
+export interface GateResult {
+    category: string;
+    tags: string[];
+    /** Human-readable notes: what was resolved to what, which nodes were created. */
+    resolutions: string[];
+    created_nodes: string[];
+    leaf?: {
+        open_count: number;
+        delivered_count: number;
+        retired_count: number;
+    };
+    /** The leaf's receipt after the add wrote its item, for the next add into it (TASK-1007). */
+    leaf_receipt?: string;
+    facet_suggestions?: FacetSuggestions;
+}
+/** Concern candidates when none was passed, and a missing role on a story. */
+export declare function suggestFacets(registry: ClassificationRegistry, args: GateArgs, tags: string[]): FacetSuggestions | undefined;
+/** `concern:` tags are resolved to canonical nodes; other tags pass untouched. */
+export declare function resolveConcernTags(tags: string[], registry: ClassificationRegistry, notes: string[]): string[];
+/**
+ * Require the current receipt of a category's leaf. `nextFor` builds the retry step from the
+ * leaf's receipt; it defaults to the add retry, and update passes its own (BUG-236).
+ */
+export declare function requireLeaf(devstepsDir: string, registry: ClassificationRegistry, args: GateArgs, category: string, tags: string[], nextFor?: (receipt: string) => GateNext): Promise<CategoryLeaf>;
+/** Resolve category and tags for a new item; throws ClassificationGateError with the next step. */
+export declare function applyClassificationGate(devstepsDir: string, args: GateArgs): Promise<GateResult>;
+//# sourceMappingURL=classification-gate.d.ts.map

package/dist/core/classification-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classification-gate.d.ts","sourceRoot":"","sources":["../../src/core/classification-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,KAAK,YAAY,EAAwC,MAAM,0BAA0B,CAAC;AACnG,OAAO,EACL,KAAK,sBAAsB,EAG5B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAmB,KAAK,OAAO,EAAE,MAAM,kCAAkC,CAAC;AAEjF,OAAO,EAGL,KAAK,QAAQ,EAId,MAAM,2BAA2B,CAAC;AAEnC,MAAM,MAAM,QAAQ,GAChB,kBAAkB,GAClB,kBAAkB,GAClB,qBAAqB,GACrB,iBAAiB,GACjB,eAAe,CAAC;AAEpB,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,8EAA8E;AAC9E,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,KAAK,GAAG,QAAQ,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,sFAAsF;AACtF,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,QAAQ,EAAE,CAAC;IACrB,gEAAgE;IAChE,YAAY,CAAC,EAAE,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC;IACnB,UAAU,CAAC,EAAE,QAAQ,EAAE,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,iBAAiB,CAAC,EAAE,gBAAgB,CAAC;IACrC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAElC,YAAY,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,EAIpD;CACF;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,iFAAiF;IACjF,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,IAAI,CAAC,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9E,6FAA6F;IAC7F,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,gBAAgB,CAAC;CACtC;AAKD,8EAA8E;AAC9E,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,sBAAsB,EAChC,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE,MAAM,EAAE,GACb,gBAAgB,GAAG,SAAS,CAmB9B;AAwBD,kFAAkF;AAClF,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EAAE,EACd,QAAQ,EAAE,sBAAsB,EAChC,KAAK,EAAE,MAAM,EAAE,GACd,MAAM,EAAE,CAcV;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,sBAAsB,EAChC,IAAI,EAAE,QAAQ,EACd,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,QAAQ,GACtC,OAAO,CAAC,YAAY,CAAC,CAkCvB;AAwED,mGAAmG;AACnG,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,QAAQ,GACb,OAAO,CAAC,UAAU,CAAC,CAkFrB"}