@syntesseraai/opencode-feature-factory 0.6.7 → 0.6.9

package/dist/agent-context.js

@@ -1,282 +0,0 @@
-import { isValidUUID } from './uuid.js';
-import { writeFile, readFile, readdir, stat, unlink } from 'fs/promises';
-/**
- * Generate the content for an agent context file
- */
-function generateContextFileContent(context) {
-    const frontmatter = `---
-id: "${context.id}"
-agent: ${context.agent}
-title: "${context.title}"
-description: "${context.description}"
-folder: "${context.folder}"
-status: ${context.status}
-started: "${context.started}"
-session: "${context.session}"
-${context.parent ? `parent: "${context.parent}"` : 'parent: null'}
-${context.delegated_to && context.delegated_to.length > 0 ? `delegated_to:\n${context.delegated_to.map((id) => `  - "${id}"`).join('\n')}` : 'delegated_to: []'}
----`;
-    const body = `
-
-## Task Context
-
-${context.notes || 'No additional notes.'}
-
-## Progress
-
-- [ ] Task started
-
-## Delegated Work
-
-${context.delegated_to && context.delegated_to.length > 0 ? context.delegated_to.map((id) => `- Agent ${id} (pending)`).join('\n') : 'No delegated work.'}
-`;
-    return frontmatter + body;
-}
-/**
- * Write an agent context file
- * File naming: {agent}-{uuid}.md
- */
-export async function writeAgentContext(directory, context) {
-    const fileName = `${context.agent}-${context.id}.md`;
-    const filePath = `${directory}/.feature-factory/agents/${fileName}`;
-    const content = generateContextFileContent(context);
-    try {
-        await writeFile(filePath, content, 'utf-8');
-        return filePath;
-    }
-    catch (error) {
-        throw new Error(`Failed to write agent context file: ${error}`);
-    }
-}
-/**
- * Read an agent context file by UUID
- */
-export async function readAgentContextById(directory, id) {
-    if (!isValidUUID(id)) {
-        return null;
-    }
-    try {
-        // Read directory and find file with this UUID
-        const agentsDir = `${directory}/.feature-factory/agents`;
-        const entries = await readdir(agentsDir, { withFileTypes: true });
-        const fileName = entries
-            .filter((entry) => entry.isFile() && entry.name.endsWith('.md'))
-            .map((entry) => entry.name)
-            .find((name) => name.includes(`-${id}.md`));
-        if (!fileName) {
-            return null;
-        }
-        const filePath = `${agentsDir}/${fileName}`;
-        const content = await readFile(filePath, 'utf-8');
-        return parseAgentContext(content);
-    }
-    catch {
-        return null;
-    }
-}
-/**
- * Parse agent context from markdown content
- */
-function parseAgentContext(content) {
-    try {
-        // Extract frontmatter
-        const frontmatterMatch = content.match(/---\n([\s\S]*?)\n---/);
-        if (!frontmatterMatch) {
-            return null;
-        }
-        const frontmatter = frontmatterMatch[1];
-        const lines = frontmatter.split('\n');
-        const context = {};
-        for (const line of lines) {
-            const match = line.match(/^([a-z_]+):\s*(.*)$/);
-            if (match) {
-                const [, key, value] = match;
-                const cleanValue = value.replace(/^["']|["']$/g, ''); // Remove quotes
-                if (key === 'delegated_to') {
-                    // Handle array - this is simplified, real YAML parsing would be better
-                    continue;
-                }
-                else if (key === 'parent' && cleanValue === 'null') {
-                    context[key] = undefined;
-                }
-                else {
-                    context[key] = cleanValue;
-                }
-            }
-        }
-        // Parse delegated_to array manually from content
-        const delegatedMatch = content.match(/delegated_to:\n((?: {2}- ".*"\n?)*)/);
-        if (delegatedMatch) {
-            const delegatedLines = delegatedMatch[1].trim().split('\n');
-            context.delegated_to = delegatedLines
-                .map((line) => line.match(/- "([^"]+)"/)?.[1])
-                .filter((id) => !!id);
-        }
-        return context;
-    }
-    catch {
-        return null;
-    }
-}
-/**
- * Update agent status in context file
- */
-export async function updateAgentStatus(directory, id, status) {
-    try {
-        const agentsDir = `${directory}/.feature-factory/agents`;
-        const entries = await readdir(agentsDir, { withFileTypes: true });
-        const fileName = entries
-            .filter((entry) => entry.isFile() && entry.name.endsWith('.md'))
-            .map((entry) => entry.name)
-            .find((name) => name.includes(`-${id}.md`));
-        if (!fileName) {
-            return false;
-        }
-        const filePath = `${agentsDir}/${fileName}`;
-        // Read current content
-        const content = await readFile(filePath, 'utf-8');
-        let text = content;
-        // Replace status line
-        text = text.replace(/status: \w+/, `status: ${status}`);
-        // Write back
-        await writeFile(filePath, text, 'utf-8');
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * List all active agents
- */
-export async function listActiveAgents(directory, sessionId, agentType) {
-    const agentsDir = `${directory}/.feature-factory/agents`;
-    try {
-        // Check if directory exists
-        await stat(agentsDir);
-    }
-    catch {
-        return [];
-    }
-    try {
-        const entries = await readdir(agentsDir, { withFileTypes: true });
-        const files = entries
-            .filter((entry) => entry.isFile() && entry.name.endsWith('.md'))
-            .map((entry) => `${agentsDir}/${entry.name}`);
-        const agents = [];
-        for (const filePath of files) {
-            try {
-                const content = await readFile(filePath, 'utf-8');
-                const context = parseAgentContext(content);
-                if (context) {
-                    // Apply filters
-                    if (sessionId && context.session !== sessionId) {
-                        continue;
-                    }
-                    if (agentType && context.agent !== agentType) {
-                        continue;
-                    }
-                    agents.push(context);
-                }
-            }
-            catch {
-                // Skip files that can't be read
-                continue;
-            }
-        }
-        return agents;
-    }
-    catch {
-        return [];
-    }
-}
-/**
- * Find agent files by various criteria
- */
-export async function findAgentFiles(directory, agentType, sessionId) {
-    const agentsDir = `${directory}/.feature-factory/agents`;
-    try {
-        await stat(agentsDir);
-    }
-    catch {
-        return [];
-    }
-    try {
-        const entries = await readdir(agentsDir, { withFileTypes: true });
-        let files = entries
-            .filter((entry) => entry.isFile() && entry.name.endsWith('.md'))
-            .map((entry) => `${agentsDir}/${entry.name}`);
-        if (agentType) {
-            files = files.filter((file) => file.includes(`${agentType}-`));
-        }
-        if (sessionId) {
-            // Filter by session ID (need to read files)
-            const filteredFiles = [];
-            for (const file of files) {
-                try {
-                    const content = await readFile(file, 'utf-8');
-                    if (content.includes(`session: "${sessionId}"`)) {
-                        filteredFiles.push(file);
-                    }
-                }
-                catch {
-                    continue;
-                }
-            }
-            return filteredFiles;
-        }
-        return files;
-    }
-    catch {
-        return [];
-    }
-}
-/**
- * Find agent file by UUID
- */
-export async function findAgentFilesById(directory, id) {
-    if (!isValidUUID(id)) {
-        return [];
-    }
-    try {
-        const agentsDir = `${directory}/.feature-factory/agents`;
-        const entries = await readdir(agentsDir, { withFileTypes: true });
-        return entries
-            .filter((entry) => entry.isFile() && entry.name.endsWith('.md') && entry.name.includes(`-${id}.md`))
-            .map((entry) => `${agentsDir}/${entry.name}`);
-    }
-    catch {
-        return [];
-    }
-}
-/**
- * Find all agent files
- */
-export async function findAllAgentFiles(directory) {
-    const agentsDir = `${directory}/.feature-factory/agents`;
-    try {
-        const entries = await readdir(agentsDir, { withFileTypes: true });
-        return entries
-            .filter((entry) => entry.isFile() && entry.name.endsWith('.md'))
-            .map((entry) => `${agentsDir}/${entry.name}`);
-    }
-    catch {
-        return [];
-    }
-}
-/**
- * Delete agent files
- */
-export async function deleteAgentFiles(directory, files) {
-    let deletedCount = 0;
-    for (const file of files) {
-        try {
-            await unlink(file);
-            deletedCount++;
-        }
-        catch {
-            // Continue even if one file fails
-        }
-    }
-    return deletedCount;
-}

package/dist/plugins/ff-agent-context-create-plugin.d.ts

@@ -1,2 +0,0 @@
-import { tool } from '@opencode-ai/plugin/tool';
-export declare function createFFAgentContextCreateTool(): ReturnType<typeof tool>;

package/dist/plugins/ff-agent-context-create-plugin.js

@@ -1,82 +0,0 @@
-import { tool } from '@opencode-ai/plugin/tool';
-import { writeFile, mkdir } from 'fs/promises';
-import { dirname } from 'path';
-export function createFFAgentContextCreateTool() {
-    return tool({
-        description: 'Create a new agent context file in .feature-factory/agents/. Use this to document agent tasks, track progress, and maintain delegation chains.',
-        args: {
-            id: tool.schema.string().describe('Unique UUID for this agent instance'),
-            agent: tool.schema
-                .string()
-                .describe('Agent type (e.g., planning, building, reviewing, ff-research)'),
-            title: tool.schema.string().describe('Task title'),
-            description: tool.schema.string().describe('Detailed task description'),
-            status: tool.schema
-                .enum(['in-progress', 'completed', 'delegated', 'failed'])
-                .default('in-progress')
-                .describe('Current status'),
-            parent: tool.schema.string().optional().describe('Parent agent UUID if this was delegated'),
-            delegatedTo: tool.schema
-                .array(tool.schema.string())
-                .optional()
-                .describe('Array of child agent UUIDs'),
-            notes: tool.schema.string().optional().describe('Additional notes or context'),
-        },
-        async execute(args, toolCtx) {
-            try {
-                const timestamp = new Date().toISOString();
-                const filePath = `${toolCtx.directory}/.feature-factory/agents/${args.agent}-${args.id}.md`;
-                // Generate frontmatter
-                const frontmatter = `---
-
-id: "${args.id}"
-agent: ${args.agent}
-title: "${args.title}"
-description: "${args.description}"
-folder: "${toolCtx.directory}"
-status: ${args.status}
-started: "${timestamp}"
-session: "${args.agent}-${args.id}"
-${args.parent ? `parent: "${args.parent}"` : 'parent: null'}
-${args.delegatedTo && args.delegatedTo.length > 0 ? `delegated_to:\n${args.delegatedTo.map((id) => `  - "${id}"`).join('\n')}` : 'delegated_to: []'}
-
----`;
-                const body = `
-
-## Task Context
-
-${args.description}
-
-## Progress
-
-- [x] Task started
-- [ ] Analysis complete
-- [ ] Implementation pending
-
-## Delegated Work
-
-No delegated work yet.
-
-${args.notes ? `## Notes\n\n${args.notes}` : ''}
-`;
-                const fullContent = `${frontmatter}${body}`;
-                // Ensure directory exists
-                await mkdir(dirname(filePath), { recursive: true });
-                // Write file
-                await writeFile(filePath, fullContent, 'utf-8');
-                return JSON.stringify({
-                    success: true,
-                    agentId: args.id,
-                    filePath: `.feature-factory/agents/${args.agent}-${args.id}.md`,
-                    message: `Agent context created successfully at .feature-factory/agents/${args.agent}-${args.id}.md`,
-                }, null, 2);
-            }
-            catch (error) {
-                return JSON.stringify({
-                    success: false,
-                    error: `Failed to create agent context: ${error}`,
-                }, null, 2);
-            }
-        },
-    });
-}

package/dist/plugins/ff-agent-context-update-plugin.d.ts

@@ -1,2 +0,0 @@
-import { tool } from '@opencode-ai/plugin/tool';
-export declare function createFFAgentContextUpdateTool(): ReturnType<typeof tool>;

package/dist/plugins/ff-agent-context-update-plugin.js

@@ -1,78 +0,0 @@
-import { tool } from '@opencode-ai/plugin/tool';
-import { readFile, writeFile } from 'fs/promises';
-export function createFFAgentContextUpdateTool() {
-    return tool({
-        description: 'Update an existing agent context file in .feature-factory/agents/. Use this to update status, add delegated agents, or append notes.',
-        args: {
-            agentId: tool.schema.string().describe('Agent UUID to update'),
-            agent: tool.schema.string().describe('Agent type'),
-            status: tool.schema
-                .enum(['in-progress', 'completed', 'delegated', 'failed'])
-                .optional()
-                .describe('New status'),
-            addDelegatedTo: tool.schema
-                .string()
-                .optional()
-                .describe('Add a child agent UUID to delegated_to list'),
-            notes: tool.schema.string().optional().describe('Notes to append to the file'),
-            progressUpdate: tool.schema
-                .string()
-                .optional()
-                .describe('Progress update to add (e.g., "- [x] Step completed")'),
-        },
-        async execute(args, toolCtx) {
-            try {
-                const filePath = `${toolCtx.directory}/.feature-factory/agents/${args.agent}-${args.agentId}.md`;
-                // Read existing file
-                let content;
-                try {
-                    content = await readFile(filePath, 'utf-8');
-                }
-                catch {
-                    return JSON.stringify({
-                        success: false,
-                        error: `Agent context file not found: ${filePath}`,
-                    }, null, 2);
-                }
-                // Update status if provided
-                if (args.status) {
-                    content = content.replace(/status: (in-progress|completed|delegated|failed)/, `status: ${args.status}`);
-                }
-                // Add delegated agent if provided
-                if (args.addDelegatedTo) {
-                    if (content.includes('delegated_to: []')) {
-                        content = content.replace('delegated_to: []', `delegated_to:\n  - "${args.addDelegatedTo}"`);
-                    }
-                    else if (content.includes('delegated_to:')) {
-                        content = content.replace(/(delegated_to:\n(?: {2}- ".*"\n)*)/, `$1  - "${args.addDelegatedTo}"\n`);
-                    }
-                }
-                // Append notes if provided
-                if (args.notes) {
-                    const timestamp = new Date().toISOString();
-                    content += `\n\n## Update - ${timestamp}\n\n${args.notes}\n`;
-                }
-                // Add progress update if provided
-                if (args.progressUpdate) {
-                    if (content.includes('## Progress')) {
-                        content = content.replace(/(## Progress\n\n)/, `$1${args.progressUpdate}\n`);
-                    }
-                }
-                // Write updated file
-                await writeFile(filePath, content, 'utf-8');
-                return JSON.stringify({
-                    success: true,
-                    agentId: args.agentId,
-                    filePath: `.feature-factory/agents/${args.agent}-${args.agentId}.md`,
-                    message: `Agent context updated successfully`,
-                }, null, 2);
-            }
-            catch (error) {
-                return JSON.stringify({
-                    success: false,
-                    error: `Failed to update agent context: ${error}`,
-                }, null, 2);
-            }
-        },
-    });
-}

package/dist/plugins/ff-agents-clear-plugin.d.ts

@@ -1,2 +0,0 @@
-import { tool } from '@opencode-ai/plugin/tool';
-export declare function createFFAgentsClearTool(): ReturnType<typeof tool>;

package/dist/plugins/ff-agents-clear-plugin.js

@@ -1,40 +0,0 @@
-import { tool } from '@opencode-ai/plugin/tool';
-import { findAgentFiles, findAgentFilesById, findAllAgentFiles, deleteAgentFiles, } from '../agent-context.js';
-export function createFFAgentsClearTool() {
-    return tool({
-        description: 'Clear agent context files. Can clear all, or filter by session, agent type, or specific UUID',
-        args: {
-            sessionID: tool.schema.string().optional().describe('Clear only agents for specific session'),
-            agent: tool.schema.string().optional().describe('Clear only specific agent type'),
-            id: tool.schema.string().optional().describe('Clear specific agent by UUID'),
-        },
-        async execute(args, toolCtx) {
-            try {
-                let files = [];
-                if (args.id) {
-                    files = await findAgentFilesById(toolCtx.directory, args.id);
-                }
-                else if (args.agent && args.sessionID) {
-                    files = await findAgentFiles(toolCtx.directory, args.agent, args.sessionID);
-                }
-                else if (args.sessionID) {
-                    files = await findAgentFiles(toolCtx.directory, undefined, args.sessionID);
-                }
-                else if (args.agent) {
-                    files = await findAgentFiles(toolCtx.directory, args.agent);
-                }
-                else {
-                    files = await findAllAgentFiles(toolCtx.directory);
-                }
-                if (files.length === 0) {
-                    return 'No agent context files found to clear.';
-                }
-                const deletedCount = await deleteAgentFiles(toolCtx.directory, files);
-                return `Cleared ${deletedCount} agent context file(s)`;
-            }
-            catch (error) {
-                return `Error clearing agents: ${error}`;
-            }
-        },
-    });
-}

package/dist/plugins/ff-agents-current-plugin.d.ts

@@ -1,2 +0,0 @@
-import { tool } from '@opencode-ai/plugin/tool';
-export declare function createFFAgentsCurrentTool(): ReturnType<typeof tool>;

package/dist/plugins/ff-agents-current-plugin.js

@@ -1,45 +0,0 @@
-import { tool } from '@opencode-ai/plugin/tool';
-import { listActiveAgents } from '../agent-context.js';
-export function createFFAgentsCurrentTool() {
-    return tool({
-        description: 'List all currently active Feature Factory agents with their UUIDs and status',
-        args: {
-            sessionID: tool.schema.string().optional().describe('Filter by specific session ID'),
-            agent: tool.schema
-                .string()
-                .optional()
-                .describe('Filter by agent type (e.g., planning, research)'),
-        },
-        async execute(args, toolCtx) {
-            try {
-                const agents = await listActiveAgents(toolCtx.directory, args.sessionID, args.agent);
-                if (agents.length === 0) {
-                    return JSON.stringify({
-                        count: 0,
-                        message: 'No active agents found',
-                        agents: [],
-                    }, null, 2);
-                }
-                return JSON.stringify({
-                    count: agents.length,
-                    agents: agents.map((a) => ({
-                        id: a.id,
-                        agent: a.agent,
-                        title: a.title,
-                        folder: a.folder,
-                        status: a.status,
-                        started: a.started,
-                        session: a.session,
-                        parent: a.parent || null,
-                        delegated_to: a.delegated_to || [],
-                    })),
-                }, null, 2);
-            }
-            catch (error) {
-                return JSON.stringify({
-                    error: `Failed to list agents: ${error}`,
-                }, null, 2);
-            }
-        },
-    });
-}

package/dist/plugins/ff-agents-delete-plugin.d.ts

@@ -1,2 +0,0 @@
-import { tool } from '@opencode-ai/plugin/tool';
-export declare function createFFAgentsDeleteTool(): ReturnType<typeof tool>;

package/dist/plugins/ff-agents-delete-plugin.js

@@ -1,32 +0,0 @@
-import { tool } from '@opencode-ai/plugin/tool';
-import { validateSafePath, resolveSafePath, getFeatureFactoryDir } from '../utils/file-utils.js';
-import { unlink } from 'fs/promises';
-export function createFFAgentsDeleteTool() {
-    return tool({
-        description: 'Delete an agent context file from .feature-factory/agents',
-        args: {
-            fileName: tool.schema
-                .string()
-                .describe('Name of the agent file to delete (e.g., "planning-abc123.md")'),
-        },
-        async execute(args, toolCtx) {
-            try {
-                const agentsDir = getFeatureFactoryDir(toolCtx.directory, 'agents');
-                // Validate the file path
-                if (!validateSafePath(agentsDir, args.fileName)) {
-                    return `Error: Invalid or unsafe file name "${args.fileName}". Only .md files with alphanumeric names are allowed.`;
-                }
-                const filePath = resolveSafePath(agentsDir, args.fileName);
-                // Delete the file
-                await unlink(filePath);
-                return `Successfully deleted agent file: ${args.fileName}`;
-            }
-            catch (error) {
-                if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {
-                    return `Error: File "${args.fileName}" not found in .feature-factory/agents`;
-                }
-                return `Error deleting agent file: ${error}`;
-            }
-        },
-    });
-}

package/dist/plugins/ff-agents-get-plugin.d.ts

@@ -1,2 +0,0 @@
-import { tool } from '@opencode-ai/plugin/tool';
-export declare function createFFAgentsGetTool(): ReturnType<typeof tool>;

package/dist/plugins/ff-agents-get-plugin.js

@@ -1,32 +0,0 @@
-import { tool } from '@opencode-ai/plugin/tool';
-import { validateSafePath, resolveSafePath, getFeatureFactoryDir } from '../utils/file-utils.js';
-import { readFile } from 'fs/promises';
-export function createFFAgentsGetTool() {
-    return tool({
-        description: 'Read an agent context file by name from .feature-factory/agents',
-        args: {
-            fileName: tool.schema
-                .string()
-                .describe('Name of the agent file (e.g., "planning-abc123.md")'),
-        },
-        async execute(args, toolCtx) {
-            try {
-                const agentsDir = getFeatureFactoryDir(toolCtx.directory, 'agents');
-                // Validate the file path
-                if (!validateSafePath(agentsDir, args.fileName)) {
-                    return `Error: Invalid or unsafe file name "${args.fileName}". Only .md files with alphanumeric names are allowed.`;
-                }
-                const filePath = resolveSafePath(agentsDir, args.fileName);
-                // Read file content
-                const content = await readFile(filePath, 'utf-8');
-                return content;
-            }
-            catch (error) {
-                if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {
-                    return `Error: File "${args.fileName}" not found in .feature-factory/agents`;
-                }
-                return `Error reading agent file: ${error}`;
-            }
-        },
-    });
-}

package/dist/plugins/ff-agents-list-plugin.d.ts

@@ -1,2 +0,0 @@
-import { tool } from '@opencode-ai/plugin/tool';
-export declare function createFFAgentsListTool(): ReturnType<typeof tool>;

package/dist/plugins/ff-agents-list-plugin.js

@@ -1,42 +0,0 @@
-import { tool } from '@opencode-ai/plugin/tool';
-import { validateSafePattern, ensureDirectoryExists, getFeatureFactoryDir, } from '../utils/file-utils.js';
-import { readdir } from 'fs/promises';
-export function createFFAgentsListTool() {
-    return tool({
-        description: 'List all agent context files in .feature-factory/agents',
-        args: {
-            pattern: tool.schema
-                .string()
-                .optional()
-                .describe('Optional filter pattern (e.g., "planning-*.md")'),
-        },
-        async execute(args, toolCtx) {
-            try {
-                const agentsDir = getFeatureFactoryDir(toolCtx.directory, 'agents');
-                // Ensure the agents directory exists
-                await ensureDirectoryExists(agentsDir);
-                // List files
-                const entries = await readdir(agentsDir, { withFileTypes: true });
-                let files = entries
-                    .filter((entry) => entry.isFile() && entry.name.endsWith('.md'))
-                    .map((entry) => entry.name);
-                // Apply pattern filter if provided
-                if (args.pattern) {
-                    if (!validateSafePattern(args.pattern)) {
-                        return `Error: Invalid pattern "${args.pattern}". Only safe pattern characters are allowed.`;
-                    }
-                    // Simple glob-like matching
-                    const regex = new RegExp('^' + args.pattern.replace(/\*/g, '.*').replace(/\?/g, '.') + '$');
-                    files = files.filter((f) => regex.test(f));
-                }
-                if (files.length === 0) {
-                    return 'No agent files found in .feature-factory/agents';
-                }
-                return JSON.stringify(files, null, 2);
-            }
-            catch (error) {
-                return `Error listing agent files: ${error}`;
-            }
-        },
-    });
-}

package/dist/plugins/ff-agents-show-plugin.d.ts

@@ -1,2 +0,0 @@
-import { tool } from '@opencode-ai/plugin/tool';
-export declare function createFFAgentsShowTool(): ReturnType<typeof tool>;