@dynamicworks/br-openspec 1.3.1

package/dist/core/tools-manager.js

@@ -0,0 +1,215 @@
+/**
+ * Tools Manager
+ *
+ * Encapsulates adding and removing IDE/Code Agent OpenSpec configuration files.
+ * Shared by `openspec init` (via InitCommand) and `openspec tools`.
+ */
+import { TOOLS_MESSAGES } from '../messages/index.js';
+import path from 'path';
+import * as fs from 'fs';
+import { createRequire } from 'module';
+import { FileSystemUtils } from '../utils/file-system.js';
+import { transformToHyphenCommands } from '../utils/command-references.js';
+import { AI_TOOLS } from './config.js';
+import { generateCommands, CommandAdapterRegistry, } from './command-generation/index.js';
+import { getSkillTemplates, getCommandContents, generateSkillContent, } from './shared/index.js';
+import { getToolStates, getToolsWithSkillsDir, } from './shared/index.js';
+import { getGlobalConfig } from './global-config.js';
+import { getProfileWorkflows, ALL_WORKFLOWS } from './profiles.js';
+const require = createRequire(import.meta.url);
+const { version: OPENSPEC_VERSION } = require('../../package.json');
+// Map from workflow ID to the skill directory name it uses
+const WORKFLOW_TO_SKILL_DIR = {
+    explore: 'openspec-explore',
+    new: 'openspec-new-change',
+    continue: 'openspec-continue-change',
+    apply: 'openspec-apply-change',
+    ff: 'openspec-ff-change',
+    sync: 'openspec-sync-specs',
+    archive: 'openspec-archive-change',
+    'bulk-archive': 'openspec-bulk-archive-change',
+    verify: 'openspec-verify-change',
+    onboard: 'openspec-onboard',
+    propose: 'openspec-propose',
+};
+// ─────────────────────────────────────────────────────────────────────────────
+// Shared remove helpers (also used by InitCommand)
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Removes all OpenSpec-owned skill directories under the given `skillsDir`.
+ * Only directories whose names match known workflow skill dir names are removed.
+ * Other files and directories are left intact.
+ *
+ * @returns Number of directories removed
+ */
+export async function removeOpenSpecSkillDirs(skillsDir) {
+    let removed = 0;
+    for (const workflow of ALL_WORKFLOWS) {
+        const dirName = WORKFLOW_TO_SKILL_DIR[workflow];
+        if (!dirName)
+            continue;
+        const skillDir = path.join(skillsDir, dirName);
+        try {
+            if (fs.existsSync(skillDir)) {
+                await fs.promises.rm(skillDir, { recursive: true, force: true });
+                removed++;
+            }
+        }
+        catch {
+            // Ignore individual errors
+        }
+    }
+    return removed;
+}
+/**
+ * Removes all OpenSpec-owned command files for the given tool.
+ * Only files whose paths are produced by the tool's adapter `getFilePath()` are removed.
+ * The tool's configuration directory is left intact.
+ *
+ * @returns Number of files removed
+ */
+export async function removeOpenSpecCommandFiles(projectPath, toolId) {
+    let removed = 0;
+    const adapter = CommandAdapterRegistry.get(toolId);
+    if (!adapter)
+        return 0;
+    for (const workflow of ALL_WORKFLOWS) {
+        const cmdPath = adapter.getFilePath(workflow);
+        const fullPath = path.isAbsolute(cmdPath)
+            ? cmdPath
+            : path.join(projectPath, cmdPath);
+        try {
+            if (fs.existsSync(fullPath)) {
+                await fs.promises.unlink(fullPath);
+                removed++;
+            }
+        }
+        catch {
+            // Ignore individual errors
+        }
+    }
+    return removed;
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Add / Remove API
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Adds OpenSpec skill and command files for the given tool.
+ * Creates the tool's configuration directory if it does not exist.
+ * Respects the active global config (profile and delivery settings).
+ */
+export async function addTool(projectPath, tool) {
+    if (!tool.skillsDir) {
+        throw new Error(`Tool '${tool.value}' does not support skill generation.`);
+    }
+    const globalConfig = getGlobalConfig();
+    const profile = globalConfig.profile ?? 'core';
+    const delivery = globalConfig.delivery ?? 'both';
+    const workflows = getProfileWorkflows(profile, globalConfig.workflows);
+    const shouldGenerateSkills = delivery !== 'commands';
+    const shouldGenerateCommands = delivery !== 'skills';
+    // Write skill files
+    if (shouldGenerateSkills) {
+        const skillsDir = path.join(projectPath, tool.skillsDir, 'skills');
+        const skillTemplates = getSkillTemplates(workflows);
+        for (const { template, dirName } of skillTemplates) {
+            const skillDir = path.join(skillsDir, dirName);
+            const skillFile = path.join(skillDir, 'SKILL.md');
+            const transformer = tool.value === 'opencode' || tool.value === 'pi'
+                ? transformToHyphenCommands
+                : undefined;
+            const skillContent = generateSkillContent(template, OPENSPEC_VERSION, transformer);
+            await FileSystemUtils.writeFile(skillFile, skillContent);
+        }
+    }
+    // Write command files
+    if (shouldGenerateCommands) {
+        const adapter = CommandAdapterRegistry.get(tool.value);
+        if (adapter) {
+            const commandContents = getCommandContents(workflows);
+            const generatedCommands = generateCommands(commandContents, adapter);
+            for (const cmd of generatedCommands) {
+                const commandFile = path.isAbsolute(cmd.path)
+                    ? cmd.path
+                    : path.join(projectPath, cmd.path);
+                await FileSystemUtils.writeFile(commandFile, cmd.fileContent);
+            }
+        }
+    }
+}
+/**
+ * Removes OpenSpec-owned skill and command files for the given tool.
+ * The tool's configuration directory itself is left intact; only files and
+ * directories created by OpenSpec are removed.
+ *
+ * @returns Counts of removed skill dirs and command files
+ */
+export async function removeTool(projectPath, tool) {
+    if (!tool.skillsDir) {
+        return { removedSkillCount: 0, removedCommandCount: 0 };
+    }
+    const skillsDir = path.join(projectPath, tool.skillsDir, 'skills');
+    const removedSkillCount = await removeOpenSpecSkillDirs(skillsDir);
+    const removedCommandCount = await removeOpenSpecCommandFiles(projectPath, tool.value);
+    return { removedSkillCount, removedCommandCount };
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Query helpers
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Returns the IDs of all tools that are currently configured in the project.
+ */
+export function getCurrentToolIds(projectPath) {
+    const toolStates = getToolStates(projectPath);
+    const configured = new Set();
+    for (const [toolId, status] of toolStates) {
+        if (status.configured)
+            configured.add(toolId);
+    }
+    return configured;
+}
+/**
+ * Returns all tools eligible for skill generation (those with a skillsDir).
+ */
+export function getEligibleTools() {
+    return AI_TOOLS.filter((t) => !!t.skillsDir);
+}
+/**
+ * Resolves a comma-separated tool list string to an array of valid tool IDs.
+ *
+ * Accepts the special values "all" and "none".
+ * Throws a descriptive error for invalid or ambiguous inputs.
+ */
+export function resolveToolsArg(raw) {
+    const trimmed = raw.trim();
+    if (trimmed.length === 0) {
+        throw new Error(TOOLS_MESSAGES.addRemoveRequiresValue);
+    }
+    const availableTools = getToolsWithSkillsDir();
+    const availableSet = new Set(availableTools);
+    if (trimmed.toLowerCase() === 'all') {
+        return availableTools;
+    }
+    if (trimmed.toLowerCase() === 'none') {
+        return [];
+    }
+    const tokens = trimmed
+        .split(',')
+        .map((t) => t.trim().toLowerCase())
+        .filter((t) => t.length > 0);
+    if (tokens.some((t) => t === 'all' || t === 'none')) {
+        throw new Error(TOOLS_MESSAGES.cannotCombineReserved);
+    }
+    const invalid = tokens.filter((t) => !availableSet.has(t));
+    if (invalid.length > 0) {
+        throw new Error(TOOLS_MESSAGES.invalidTools(invalid.join(', '), availableTools.join(', ')));
+    }
+    // Deduplicate preserving order
+    const deduped = [];
+    for (const t of tokens) {
+        if (!deduped.includes(t))
+            deduped.push(t);
+    }
+    return deduped;
+}
+//# sourceMappingURL=tools-manager.js.map

package/dist/core/update.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Update Command
+ *
+ * Refreshes BR-OpenSpec skills and commands for configured tools.
+ * Supports profile-aware updates, delivery changes, migration, and smart update detection.
+ */
+/**
+ * Options for the update command.
+ */
+export interface UpdateCommandOptions {
+    /** Force update even when tools are up to date */
+    force?: boolean;
+}
+/**
+ * Scans installed workflow artifacts (skills and managed commands) across all configured tools.
+ * Returns the union of detected workflow IDs that match ALL_WORKFLOWS.
+ *
+ * Wrapper around the shared migration module's scanInstalledWorkflows that accepts tool IDs.
+ */
+export declare function scanInstalledWorkflows(projectPath: string, toolIds: string[]): string[];
+export declare class UpdateCommand {
+    private readonly force;
+    constructor(options?: UpdateCommandOptions);
+    execute(projectPath: string): Promise<void>;
+    /**
+     * Display message when all tools are up to date.
+     */
+    private displayUpToDateMessage;
+    /**
+     * Display the update plan showing which tools need updating.
+     */
+    private displayUpdatePlan;
+    /**
+     * Detects new tool directories that aren't currently configured and displays a hint.
+     */
+    private detectNewTools;
+    /**
+     * Displays a note about extra workflows installed that aren't in the current profile.
+     */
+    private displayExtraWorkflowsNote;
+    /**
+     * Removes skill directories for workflows when delivery changed to commands-only.
+     * Returns the number of directories removed.
+     */
+    private removeSkillDirs;
+    /**
+     * Removes skill directories for workflows that are no longer selected in the active profile.
+     * Returns the number of directories removed.
+     */
+    private removeUnselectedSkillDirs;
+    /**
+     * Removes command files for workflows when delivery changed to skills-only.
+     * Returns the number of files removed.
+     */
+    private removeCommandFiles;
+    /**
+     * Removes command files for workflows that are no longer selected in the active profile.
+     * Returns the number of files removed.
+     */
+    private removeUnselectedCommandFiles;
+    /**
+     * Detect and handle legacy BR-OpenSpec artifacts.
+     * Unlike init, update warns but continues if legacy files found in non-interactive mode.
+     * Returns array of tool IDs that were newly configured during legacy upgrade.
+     */
+    private handleLegacyCleanup;
+    /**
+     * Perform cleanup of legacy artifacts.
+     */
+    private performLegacyCleanup;
+    /**
+     * Upgrade legacy tools to new skills system.
+     * Returns array of tool IDs that were newly configured.
+     */
+    private upgradeLegacyTools;
+}
+//# sourceMappingURL=update.d.ts.map