@syntesseraai/opencode-feature-factory 0.6.8 → 0.6.10

package/commands/pipeline/planning/run-gemini.md

@@ -1,21 +0,0 @@
----
-description: Generate Gemini planning proposal
-subtask: true
-agent: ff-planning-gemini
----
-
-Create a comprehensive implementation plan from the current pipeline requirements.
-
-Requirements brief:
-
-$ARGUMENTS
-
-Persist plan content using `ff-plans-update` into `.feature-factory/plans/plan-gemini-{UUID}.md`.
-
-Include:
-
-- requirements summary
-- architecture validation for the proposed implementation approach
-- ordered implementation steps with file targets
-- risks and mitigations
-- testing and validation strategy

package/commands/pipeline/planning/run-opus.md

@@ -1,21 +0,0 @@
----
-description: Generate Opus planning proposal
-subtask: true
-agent: ff-planning-opus
----
-
-Create a comprehensive implementation plan from the current pipeline requirements.
-
-Requirements brief:
-
-$ARGUMENTS
-
-Persist plan content using `ff-plans-update` into `.feature-factory/plans/plan-opus-{UUID}.md`.
-
-Include:
-
-- requirements summary
-- architecture validation for the proposed implementation approach
-- ordered implementation steps with file targets
-- risks and mitigations
-- testing and validation strategy

package/commands/pipeline/planning/run.md

@@ -1,25 +0,0 @@
----
-description: Execute one planning iteration
-subtask: true
-model: openai/gpt-5.4
-parallel:
-  - /pipeline/planning/run-opus {as:plan-opus}
-  - /pipeline/planning/run-gemini {as:plan-gemini}
-  - /pipeline/planning/run-codex {as:plan-codex}
-return:
-  - /pipeline/planning/synthesize
-  - /pipeline/planning/gate
----
-
-Run one complete planning iteration for the active pipeline.
-
-Requirements brief:
-
-$ARGUMENTS
-
-Rules:
-
-1. Persist each planner output to `.feature-factory/plans/plan-{model}-{UUID}.md`.
-2. Preserve prior planning artifacts for audit.
-3. Each planning model must include architecture validation in its proposal.
-4. Continue only through gate outcomes defined in `/pipeline/planning/gate`.

package/commands/pipeline/planning/synthesize.md

@@ -1,18 +0,0 @@
----
-description: Synthesize planning consensus
-subtask: true
-agent: ff-planning-codex
-model: openai/gpt-5.4
----
-
-Read the latest planning artifacts (`plan-opus-{UUID}.md`, `plan-gemini-{UUID}.md`, `plan-codex-{UUID}.md`) and produce a consensus report.
-
-Persist as `.feature-factory/plans/plan-consensus-{UUID}.md`.
-
-Required output sections:
-
-1. `CONSENSUS_SCORE` (0-100)
-2. `AGREED_ELEMENTS`
-3. `DIVERGENT_ELEMENTS`
-4. `SYNTHESIZED_PLAN`
-5. `OPEN_QUESTIONS`

package/commands/pipeline/reviewing/run-codex.md

@@ -1,12 +0,0 @@
----
-description: Independent Codex review
-subtask: true
-agent: ff-reviewing-codex
-model: openai/gpt-5.3-codex
----
-
-Review the current task from triage brief for correctness, quality, architecture validity, testing, security, and edge cases.
-
-Classify findings as critical/high/medium/low and include confidence score.
-
-Persist to `.feature-factory/agents/ff-reviewing-codex-{UUID}-T{N}.md`.

package/commands/pipeline/reviewing/run-gemini.md

@@ -1,11 +0,0 @@
----
-description: Independent Gemini review
-subtask: true
-agent: ff-reviewing-gemini
----
-
-Review the current task from triage brief for correctness, quality, architecture validity, testing, security, and edge cases.
-
-Classify findings as critical/high/medium/low and include confidence score.
-
-Persist to `.feature-factory/agents/ff-reviewing-gemini-{UUID}-T{N}.md`.

package/commands/pipeline/reviewing/run-opus.md

@@ -1,11 +0,0 @@
----
-description: Independent Opus review
-subtask: true
-agent: ff-reviewing-opus
----
-
-Review the current task from triage brief for correctness, quality, architecture validity, testing, security, and edge cases.
-
-Classify findings as critical/high/medium/low and include confidence score.
-
-Persist to `.feature-factory/agents/ff-reviewing-opus-{UUID}-T{N}.md`.

package/commands/pipeline/reviewing/run.md

@@ -1,24 +0,0 @@
----
-description: Run review loop for completed tasks
-subtask: true
-model: openai/gpt-5.4
-loop:
-  max: 10
-  until: all tasks in the active batch are approved with confidence >=95 and zero unresolved issues
-return:
-  - /pipeline/reviewing/triage
-  - /pipeline/reviewing/run-opus {as:review-opus}
-  - /pipeline/reviewing/run-gemini {as:review-gemini}
-  - /pipeline/reviewing/run-codex {as:review-codex}
-  - /pipeline/reviewing/synthesize
-  - /pipeline/reviewing/gate
-  - If `REVIEW_GATE=REWORK`, invoke `/pipeline/building/implement-batch` to apply fixes before the next loop iteration.
----
-
-Execute the review loop for the current completed tasks/rework report.
-
-Stop criteria:
-
-- approve when `>=95` confidence and zero unresolved issues
-- continue loop while unresolved issues exist and iteration < 10
-- escalate to user when iteration reaches 10 without approval

package/commands/pipeline/start.md

@@ -1,22 +0,0 @@
----
-description: Pipeline workflow entrypoint
-subtask: true
-model: openai/gpt-5.4
-return:
-  - /pipeline/planning/run {loop:5 && until:planning gate is APPROVED or planning gate is BLOCKED and waiting for user confirmation}
-  - If planning is BLOCKED or loop max was reached, stop and ask the user whether to continue planning iterations. Otherwise continue.
-  - /pipeline/building/run
-  - /pipeline/documentation/run
-  - /pipeline/complete
----
-
-Start the deterministic Feature Factory pipeline with this requirements brief:
-
-$ARGUMENTS
-
-Execution requirements:
-
-1. Create a pipeline UUID and persist orchestrator state in `.feature-factory/agents/pipeline-{UUID}.md` via `ff-agents-update`.
-2. Keep all phase artifacts in `.feature-factory/plans/` and `.feature-factory/reviews/`.
-3. Use command chaining, parallel fan-out, and loop gates from the `/pipeline/...` command tree.
-4. Do not skip planning, review, and documentation gates.

package/dist/agent-context.d.ts

@@ -1,57 +0,0 @@
-export interface AgentContext {
-    /** Unique UUID for this agent instance */
-    id: string;
-    /** Agent type (planning, building, reviewing, etc.) */
-    agent: string;
-    /** Task title */
-    title: string;
-    /** Task description */
-    description: string;
-    /** Working directory/folder */
-    folder: string;
-    /** Current status */
-    status: 'in-progress' | 'completed' | 'delegated' | 'failed';
-    /** ISO timestamp when agent started */
-    started: string;
-    /** OpenCode session ID */
-    session: string;
-    /** Parent agent UUID (if delegated) */
-    parent?: string;
-    /** List of child agent UUIDs (if this agent delegated work) */
-    delegated_to?: string[];
-    /** Additional notes */
-    notes?: string;
-}
-/**
- * Write an agent context file
- * File naming: {agent}-{uuid}.md
- */
-export declare function writeAgentContext(directory: string, context: AgentContext): Promise<string>;
-/**
- * Read an agent context file by UUID
- */
-export declare function readAgentContextById(directory: string, id: string): Promise<AgentContext | null>;
-/**
- * Update agent status in context file
- */
-export declare function updateAgentStatus(directory: string, id: string, status: AgentContext['status']): Promise<boolean>;
-/**
- * List all active agents
- */
-export declare function listActiveAgents(directory: string, sessionId?: string, agentType?: string): Promise<AgentContext[]>;
-/**
- * Find agent files by various criteria
- */
-export declare function findAgentFiles(directory: string, agentType?: string, sessionId?: string): Promise<string[]>;
-/**
- * Find agent file by UUID
- */
-export declare function findAgentFilesById(directory: string, id: string): Promise<string[]>;
-/**
- * Find all agent files
- */
-export declare function findAllAgentFiles(directory: string): Promise<string[]>;
-/**
- * Delete agent files
- */
-export declare function deleteAgentFiles(directory: string, files: string[]): Promise<number>;

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);
-            }
-        },
-    });
-}