@renseiai/agentfactory 0.8.17 → 0.8.19

package/dist/src/templates/schema.js

@@ -0,0 +1,139 @@
+/**
+ * Template JSON Schema Generation
+ *
+ * Generates JSON Schema 7 definitions from WorkflowTemplate objects.
+ * Schema is derived from TemplateContext fields referenced in the template's
+ * prompt via Handlebars expressions.
+ *
+ * @see SUP-1758
+ */
+// ---------------------------------------------------------------------------
+// Known TemplateContext field definitions
+// ---------------------------------------------------------------------------
+/**
+ * Maps TemplateContext field names to their JSON Schema 7 definitions.
+ * This is the source of truth for schema generation.
+ */
+const CONTEXT_FIELD_SCHEMAS = {
+    identifier: { type: 'string', description: 'Issue identifier, e.g., "SUP-123"' },
+    mentionContext: { type: 'string', description: 'Optional user mention text providing additional context' },
+    startStatus: { type: 'string', description: 'Status to show when agent starts, e.g., "Started"' },
+    completeStatus: { type: 'string', description: 'Status to show when agent completes, e.g., "Finished"' },
+    parentContext: { type: 'string', description: 'Pre-built enriched prompt for parent issues with sub-issues' },
+    subIssueList: { type: 'string', description: 'Formatted list of sub-issues with statuses' },
+    cycleCount: { type: 'integer', description: 'Current escalation cycle count' },
+    strategy: { type: 'string', description: 'Current escalation strategy' },
+    failureSummary: { type: 'string', description: 'Accumulated failure summary across cycles' },
+    attemptNumber: { type: 'integer', description: 'Attempt number within current phase' },
+    previousFailureReasons: {
+        type: 'array',
+        items: { type: 'string' },
+        description: 'List of previous failure reasons',
+    },
+    totalCostUsd: { type: 'number', description: 'Total cost in USD across all attempts' },
+    blockerIdentifier: { type: 'string', description: 'Blocker issue identifier' },
+    team: { type: 'string', description: 'Team name' },
+    repository: { type: 'string', description: 'Git repository URL pattern' },
+    projectPath: { type: 'string', description: 'Root directory for this project within the repo' },
+    sharedPaths: {
+        type: 'array',
+        items: { type: 'string' },
+        description: 'Shared directories that any project agent may modify',
+    },
+    useToolPlugins: { type: 'boolean', description: 'When true, agents use in-process tools instead of CLI' },
+    linearCli: { type: 'string', description: 'Command to invoke the Linear CLI (default: "pnpm af-linear")' },
+    packageManager: { type: 'string', description: 'Package manager used by the project (default: "pnpm")' },
+    buildCommand: { type: 'string', description: 'Build command override' },
+    testCommand: { type: 'string', description: 'Test command override' },
+    validateCommand: { type: 'string', description: 'Validation command override' },
+    phaseOutputs: {
+        type: 'object',
+        additionalProperties: {
+            type: 'object',
+            additionalProperties: true,
+        },
+        description: 'Collected outputs from upstream phases',
+    },
+    agentBugBacklog: { type: 'string', description: 'Linear project name for agent-improvement issues' },
+};
+/** Fields that are always required in a template config */
+const ALWAYS_REQUIRED = ['identifier'];
+// ---------------------------------------------------------------------------
+// Handlebars expression extraction
+// ---------------------------------------------------------------------------
+/**
+ * Extract Handlebars variable references from a template prompt.
+ * Matches {{ varName }}, {{ varName.property }}, and handles
+ * conditionals like {{#if varName}} and {{#unless varName}}.
+ *
+ * Returns the set of top-level variable names referenced.
+ */
+export function extractTemplateVariables(prompt) {
+    const vars = new Set();
+    // Match {{ expr }}, {{#if expr}}, {{#unless expr}}, {{> partial}}, etc.
+    const patterns = [
+        /\{\{\s*([a-zA-Z_][a-zA-Z0-9_.]*)\s*\}\}/g, // {{ varName }} or {{ var.prop }}
+        /\{\{#(?:if|unless)\s+([a-zA-Z_][a-zA-Z0-9_.]*)/g, // {{#if varName}}
+        /\{\{#(?:each)\s+([a-zA-Z_][a-zA-Z0-9_.]*)/g, // {{#each varName}}
+        /\{\{#(?:with)\s+([a-zA-Z_][a-zA-Z0-9_.]*)/g, // {{#with varName}}
+        /\{\{\s*(?:eq|neq)\s+([a-zA-Z_][a-zA-Z0-9_.]*)/g, // {{ eq varName "value" }}
+        /\((?:eq|neq)\s+([a-zA-Z_][a-zA-Z0-9_.]*)/g, // (eq varName "value") — subexpression
+    ];
+    for (const pattern of patterns) {
+        let match;
+        while ((match = pattern.exec(prompt)) !== null) {
+            const varName = match[1];
+            // Extract the top-level variable name (before any dot)
+            const topLevel = varName.split('.')[0];
+            // Skip Handlebars built-ins and partials
+            if (topLevel !== 'this' && topLevel !== 'else') {
+                vars.add(topLevel);
+            }
+        }
+    }
+    return vars;
+}
+// ---------------------------------------------------------------------------
+// Schema generation
+// ---------------------------------------------------------------------------
+/**
+ * Generate a JSON Schema 7 definition for a WorkflowTemplate's parameters.
+ *
+ * By default, only includes fields that are referenced in the template's
+ * prompt. Set `includeAllFields: true` to include all known TemplateContext fields.
+ */
+export function generateTemplateSchema(template, options) {
+    const includeAll = options?.includeAllFields ?? false;
+    const properties = {};
+    const required = [];
+    if (includeAll) {
+        // Include all known fields
+        for (const [field, schemaDef] of Object.entries(CONTEXT_FIELD_SCHEMAS)) {
+            properties[field] = schemaDef;
+        }
+    }
+    else {
+        // Only include fields referenced in the template prompt
+        const referencedVars = extractTemplateVariables(template.prompt);
+        for (const varName of referencedVars) {
+            if (varName in CONTEXT_FIELD_SCHEMAS) {
+                properties[varName] = CONTEXT_FIELD_SCHEMAS[varName];
+            }
+        }
+    }
+    // Always include 'identifier' as required
+    for (const field of ALWAYS_REQUIRED) {
+        if (field in properties && !required.includes(field)) {
+            required.push(field);
+        }
+    }
+    return {
+        $schema: 'http://json-schema.org/draft-07/schema#',
+        type: 'object',
+        title: `${template.metadata.name} config`,
+        description: template.metadata.description ?? `Configuration schema for ${template.metadata.name} template`,
+        properties,
+        required: required.length > 0 ? required : undefined,
+        additionalProperties: true,
+    };
+}

package/dist/src/templates/schema.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=schema.test.d.ts.map

package/dist/src/templates/schema.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.test.d.ts","sourceRoot":"","sources":["../../../src/templates/schema.test.ts"],"names":[],"mappings":""}

package/dist/src/templates/schema.test.js

@@ -0,0 +1,215 @@
+import { describe, it, expect } from 'vitest';
+import { generateTemplateSchema, extractTemplateVariables } from './schema.js';
+import { TemplateRegistry } from './registry.js';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function makeTemplate(prompt, overrides = {}) {
+    return {
+        apiVersion: 'v1',
+        kind: 'WorkflowTemplate',
+        metadata: {
+            name: 'test-template',
+            description: 'A test template',
+            workType: 'development',
+        },
+        prompt,
+        ...overrides,
+    };
+}
+// ---------------------------------------------------------------------------
+// extractTemplateVariables
+// ---------------------------------------------------------------------------
+describe('extractTemplateVariables', () => {
+    it('extracts simple variable references', () => {
+        const vars = extractTemplateVariables('Hello {{ identifier }}, your status is {{ startStatus }}');
+        expect(vars).toContain('identifier');
+        expect(vars).toContain('startStatus');
+    });
+    it('extracts dotted variable references (top-level only)', () => {
+        const vars = extractTemplateVariables('{{ phaseOutputs.dev.prUrl }}');
+        expect(vars).toContain('phaseOutputs');
+        expect(vars).not.toContain('dev');
+    });
+    it('extracts variables from #if blocks', () => {
+        const vars = extractTemplateVariables('{{#if parentContext}}Parent: {{ parentContext }}{{/if}}');
+        expect(vars).toContain('parentContext');
+    });
+    it('extracts variables from #unless blocks', () => {
+        const vars = extractTemplateVariables('{{#unless useToolPlugins}}Use CLI{{/unless}}');
+        expect(vars).toContain('useToolPlugins');
+    });
+    it('extracts variables from #each blocks', () => {
+        const vars = extractTemplateVariables('{{#each previousFailureReasons}}Reason: {{this}}{{/each}}');
+        expect(vars).toContain('previousFailureReasons');
+        // 'this' should be excluded
+        expect(vars).not.toContain('this');
+    });
+    it('extracts variables from eq/neq helpers', () => {
+        const vars = extractTemplateVariables('{{#if (eq strategy "decompose")}}Decompose{{/if}}');
+        expect(vars).toContain('strategy');
+    });
+    it('returns empty set for prompt with no variables', () => {
+        const vars = extractTemplateVariables('Plain text with no expressions');
+        expect(vars.size).toBe(0);
+    });
+    it('handles whitespace in expressions', () => {
+        const vars = extractTemplateVariables('{{  identifier  }}');
+        expect(vars).toContain('identifier');
+    });
+});
+// ---------------------------------------------------------------------------
+// generateTemplateSchema
+// ---------------------------------------------------------------------------
+describe('generateTemplateSchema', () => {
+    it('generates valid JSON Schema 7', () => {
+        const template = makeTemplate('{{ identifier }} - {{ strategy }}');
+        const schema = generateTemplateSchema(template);
+        expect(schema.$schema).toBe('http://json-schema.org/draft-07/schema#');
+        expect(schema.type).toBe('object');
+    });
+    it('includes only referenced fields by default', () => {
+        const template = makeTemplate('Issue {{ identifier }} with strategy {{ strategy }}');
+        const schema = generateTemplateSchema(template);
+        expect(schema.properties).toHaveProperty('identifier');
+        expect(schema.properties).toHaveProperty('strategy');
+        expect(schema.properties).not.toHaveProperty('buildCommand');
+        expect(schema.properties).not.toHaveProperty('testCommand');
+    });
+    it('includes all fields when includeAllFields is true', () => {
+        const template = makeTemplate('{{ identifier }}');
+        const schema = generateTemplateSchema(template, { includeAllFields: true });
+        expect(schema.properties).toHaveProperty('identifier');
+        expect(schema.properties).toHaveProperty('strategy');
+        expect(schema.properties).toHaveProperty('buildCommand');
+        expect(schema.properties).toHaveProperty('testCommand');
+    });
+    it('marks identifier as required', () => {
+        const template = makeTemplate('{{ identifier }}');
+        const schema = generateTemplateSchema(template);
+        expect(schema.required).toContain('identifier');
+    });
+    it('uses template name and description in schema', () => {
+        const template = makeTemplate('{{ identifier }}', {
+            metadata: {
+                name: 'my-template',
+                description: 'My custom template',
+                workType: 'development',
+            },
+        });
+        const schema = generateTemplateSchema(template);
+        expect(schema.title).toBe('my-template config');
+        expect(schema.description).toBe('My custom template');
+    });
+    it('sets additionalProperties to true (extensible)', () => {
+        const template = makeTemplate('{{ identifier }}');
+        const schema = generateTemplateSchema(template);
+        expect(schema.additionalProperties).toBe(true);
+    });
+    it('generates correct types for known fields', () => {
+        const template = makeTemplate('{{ identifier }} {{ cycleCount }} {{ useToolPlugins }} {{ previousFailureReasons }} {{ totalCostUsd }}');
+        const schema = generateTemplateSchema(template);
+        const props = schema.properties;
+        expect(props.identifier.type).toBe('string');
+        expect(props.cycleCount.type).toBe('integer');
+        expect(props.useToolPlugins.type).toBe('boolean');
+        expect(props.previousFailureReasons.type).toBe('array');
+        expect(props.totalCostUsd.type).toBe('number');
+    });
+});
+// ---------------------------------------------------------------------------
+// TemplateRegistry.getSchema()
+// ---------------------------------------------------------------------------
+describe('TemplateRegistry.getSchema', () => {
+    it('returns null for unknown template', () => {
+        const registry = new TemplateRegistry();
+        expect(registry.getSchema('nonexistent')).toBeNull();
+    });
+    it('returns JSON Schema for registered template', () => {
+        const registry = new TemplateRegistry();
+        registry.initialize({
+            useBuiltinDefaults: false,
+            templates: {
+                development: makeTemplate('Work on {{ identifier }} using {{ buildCommand }}'),
+            },
+        });
+        const schema = registry.getSchema('development');
+        expect(schema).not.toBeNull();
+        expect(schema?.properties).toHaveProperty('identifier');
+        expect(schema?.properties).toHaveProperty('buildCommand');
+    });
+    it('passes options through to schema generator', () => {
+        const registry = new TemplateRegistry();
+        registry.initialize({
+            useBuiltinDefaults: false,
+            templates: {
+                development: makeTemplate('{{ identifier }}'),
+            },
+        });
+        const defaultSchema = registry.getSchema('development');
+        const fullSchema = registry.getSchema('development', { includeAllFields: true });
+        expect(Object.keys(defaultSchema.properties).length).toBeLessThan(Object.keys(fullSchema.properties).length);
+    });
+});
+// ---------------------------------------------------------------------------
+// TemplateRegistry.validateConfig()
+// ---------------------------------------------------------------------------
+describe('TemplateRegistry.validateConfig', () => {
+    function createRegistryWithTemplate(prompt) {
+        const registry = new TemplateRegistry();
+        registry.initialize({
+            useBuiltinDefaults: false,
+            templates: {
+                development: makeTemplate(prompt),
+            },
+        });
+        return registry;
+    }
+    it('returns invalid for unknown template', () => {
+        const registry = new TemplateRegistry();
+        const result = registry.validateConfig('nonexistent', { identifier: 'SUP-1' });
+        expect(result.valid).toBe(false);
+        expect(result.errors[0]).toContain('not found');
+    });
+    it('validates required fields', () => {
+        const registry = createRegistryWithTemplate('{{ identifier }}');
+        const result = registry.validateConfig('development', {});
+        expect(result.valid).toBe(false);
+        expect(result.errors.some(e => e.includes('identifier'))).toBe(true);
+    });
+    it('accepts valid config', () => {
+        const registry = createRegistryWithTemplate('{{ identifier }} {{ strategy }}');
+        const result = registry.validateConfig('development', {
+            identifier: 'SUP-123',
+            strategy: 'normal',
+        });
+        expect(result.valid).toBe(true);
+        expect(result.errors).toHaveLength(0);
+    });
+    it('treats template expressions as valid for any field', () => {
+        const registry = createRegistryWithTemplate('{{ identifier }} {{ cycleCount }}');
+        const result = registry.validateConfig('development', {
+            identifier: '{{ issue.identifier }}',
+            cycleCount: '{{ escalation.cycleCount }}',
+        });
+        expect(result.valid).toBe(true);
+    });
+    it('detects type mismatches', () => {
+        const registry = createRegistryWithTemplate('{{ identifier }} {{ cycleCount }}');
+        const result = registry.validateConfig('development', {
+            identifier: 123, // should be string
+            cycleCount: 'not-a-number', // should be integer
+        });
+        expect(result.valid).toBe(false);
+        expect(result.errors.some(e => e.includes('identifier'))).toBe(true);
+        expect(result.errors.some(e => e.includes('cycleCount'))).toBe(true);
+    });
+    it('allows additional properties not in schema', () => {
+        const registry = createRegistryWithTemplate('{{ identifier }}');
+        const result = registry.validateConfig('development', {
+            identifier: 'SUP-123',
+            customField: 'custom-value',
+        });
+        expect(result.valid).toBe(true);
+    });
+});

package/dist/src/templates/types.d.ts

@@ -157,6 +157,7 @@ export declare const AgentWorkTypeSchema: z.ZodEnum<{
     "qa-coordination": "qa-coordination";
     "acceptance-coordination": "acceptance-coordination";
     merge: "merge";
+    security: "security";
 }>;
 export declare const ToolPermissionSchema: z.ZodUnion<readonly [z.ZodObject<{
     shell: z.ZodString;
@@ -181,6 +182,7 @@ export declare const WorkflowTemplateSchema: z.ZodObject<{
             "qa-coordination": "qa-coordination";
             "acceptance-coordination": "acceptance-coordination";
             merge: "merge";
+            security: "security";
         }>;
     }, z.core.$strip>;
     tools: z.ZodOptional<z.ZodObject<{

package/dist/src/templates/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/templates/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/templates/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAA;AAGlE,YAAY,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAA;AAMlE;;;;;;;GAOG;AACH,MAAM,MAAM,cAAc,GACtB;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GACjB,YAAY,GACZ,MAAM,CAAA;AAMV;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,IAAI,CAAA;IAChB,IAAI,EAAE,kBAAkB,CAAA;IACxB,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAA;QACZ,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,QAAQ,EAAE,aAAa,CAAA;KACxB,CAAA;IACD,KAAK,CAAC,EAAE;QACN,KAAK,CAAC,EAAE,cAAc,EAAE,CAAA;QACxB,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAA;KAC5B,CAAA;IACD,yEAAyE;IACzE,MAAM,EAAE,MAAM,CAAA;CACf;AAMD;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,IAAI,CAAA;IAChB,IAAI,EAAE,iBAAiB,CAAA;IACvB,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAA;QACZ,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,0EAA0E;QAC1E,QAAQ,CAAC,EAAE,MAAM,CAAA;KAClB,CAAA;IACD,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAA;CAChB;AAMD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAA;IAClB,8DAA8D;IAC9D,cAAc,CAAC,EAAE,MAAM,CAAA;IAGvB,iEAAiE;IACjE,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,4DAA4D;IAC5D,cAAc,CAAC,EAAE,MAAM,CAAA;IAGvB,kEAAkE;IAClE,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,CAAA;IAGrB,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,kGAAkG;IAClG,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,gDAAgD;IAChD,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,0CAA0C;IAC1C,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,uCAAuC;IACvC,sBAAsB,CAAC,EAAE,MAAM,EAAE,CAAA;IACjC,4CAA4C;IAC5C,YAAY,CAAC,EAAE,MAAM,CAAA;IAGrB,uDAAuD;IACvD,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAA;IAGb,sFAAsF;IACtF,UAAU,CAAC,EAAE,MAAM,CAAA;IAGnB,2EAA2E;IAC3E,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,oFAAoF;IACpF,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;IAGtB,wEAAwE;IACxE,cAAc,CAAC,EAAE,OAAO,CAAA;IAGxB,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,kGAAkG;IAClG,cAAc,CAAC,EAAE,MAAM,CAAA;IAGvB,iFAAiF;IACjF,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,uFAAuF;IACvF,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,mGAAmG;IACnG,eAAe,CAAC,EAAE,MAAM,CAAA;IAGxB,kFAAkF;IAClF,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IAGtD,iGAAiG;IACjG,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AAMD;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,+DAA+D;IAC/D,oBAAoB,CAAC,WAAW,EAAE,cAAc,EAAE,GAAG,MAAM,EAAE,CAAA;CAC9D;AAMD;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,sEAAsE;IACtE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAA;IAC/F,wDAAwD;IACxD,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAwBD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;EAAqB,CAAA;AAErD,eAAO,MAAM,oBAAoB;;4DAI/B,CAAA;AAEF,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAajC,CAAA;AAEF,eAAO,MAAM,qBAAqB;;;;;;;;;iBAShC,CAAA;AAEF,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;iBAmChC,CAAA;AAMF;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAS3F;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,eAAe,CASzF"}

package/dist/src/templates/types.js

@@ -31,6 +31,7 @@ const WORK_TYPES = [
     'qa-coordination',
     'acceptance-coordination',
     'merge',
+    'security',
 ];
 export const AgentWorkTypeSchema = z.enum(WORK_TYPES);
 export const ToolPermissionSchema = z.union([

package/dist/src/tools/index.d.ts

@@ -1,4 +1,6 @@
 export { ToolRegistry } from './registry.js';
 export type { CreateServersResult } from './registry.js';
 export type { ToolPlugin, ToolPluginContext } from './types.js';
+export { classifyTool } from './tool-category.js';
+export type { ToolCategory } from './tool-category.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/tools/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAC5C,YAAY,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AACxD,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAC5C,YAAY,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AACxD,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/src/tools/index.js

@@ -1 +1,2 @@
 export { ToolRegistry } from './registry.js';
+export { classifyTool } from './tool-category.js';

package/dist/src/tools/tool-category.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Tool category classification based on tool name pattern matching.
+ *
+ * Classifies tools into functional categories for dashboard and analytics use.
+ */
+export type ToolCategory = 'security' | 'testing' | 'build' | 'deploy' | 'research' | 'general';
+/**
+ * Classify a tool into a functional category based on its name.
+ *
+ * Handles both simple tool names (e.g. `Read`, `Bash`) and
+ * MCP-qualified names (e.g. `mcp__af-linear__af_linear_create_issue`).
+ *
+ * Returns `'general'` for tools that don't match any specific category.
+ */
+export declare function classifyTool(toolName: string): ToolCategory;
+//# sourceMappingURL=tool-category.d.ts.map

package/dist/src/tools/tool-category.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-category.d.ts","sourceRoot":"","sources":["../../../src/tools/tool-category.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAA;AAwC/F;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,CAU3D"}

package/dist/src/tools/tool-category.js

@@ -0,0 +1,58 @@
+/**
+ * Tool category classification based on tool name pattern matching.
+ *
+ * Classifies tools into functional categories for dashboard and analytics use.
+ */
+const CATEGORY_PATTERNS = [
+    {
+        category: 'security',
+        patterns: /security|vuln|scan|sast|dast|sbom|cve|audit(?!.*\bno-audit\b)/i,
+    },
+    {
+        category: 'testing',
+        patterns: /test|jest|vitest|playwright|cypress|coverage|assert/i,
+    },
+    {
+        category: 'deploy',
+        patterns: /deploy|release|publish|docker|k8s|terraform|infra/i,
+    },
+    {
+        category: 'build',
+        patterns: /build|compile|bundle|webpack|vite|esbuild|tsc/i,
+    },
+    {
+        category: 'research',
+        patterns: /search|fetch|browse|read|grep|glob|explore/i,
+    },
+];
+/**
+ * Extract the tool-specific portion from an MCP-qualified tool name.
+ *
+ * MCP tool names follow the pattern `mcp__{pluginName}__{toolName}`.
+ * Returns the portion after the last `__` separator, or the original
+ * name if it's not MCP-qualified.
+ */
+function extractToolName(toolName) {
+    const lastSep = toolName.lastIndexOf('__');
+    if (lastSep !== -1 && lastSep < toolName.length - 2) {
+        return toolName.substring(lastSep + 2);
+    }
+    return toolName;
+}
+/**
+ * Classify a tool into a functional category based on its name.
+ *
+ * Handles both simple tool names (e.g. `Read`, `Bash`) and
+ * MCP-qualified names (e.g. `mcp__af-linear__af_linear_create_issue`).
+ *
+ * Returns `'general'` for tools that don't match any specific category.
+ */
+export function classifyTool(toolName) {
+    const name = extractToolName(toolName);
+    for (const { category, patterns } of CATEGORY_PATTERNS) {
+        if (patterns.test(name)) {
+            return category;
+        }
+    }
+    return 'general';
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@renseiai/agentfactory",
-  "version": "0.8.17",
+  "version": "0.8.19",
   "type": "module",
   "description": "Multi-agent fleet management for coding agents — orchestrator, providers, crash recovery",
   "author": "Rensei AI (https://rensei.ai)",
@@ -56,7 +56,7 @@
     "@types/node": "^22.5.4",
     "typescript": "^5.7.3",
     "vitest": "^3.2.3",
-    "@renseiai/create-agentfactory-app": "0.8.17"
+    "@renseiai/create-agentfactory-app": "0.8.19"
   },
   "scripts": {
     "build": "tsc",