@bobby_z/openspec 0.0.1

package/dist/core/shared/index.js

@@ -0,0 +1,8 @@
+/**
+ * Shared Utilities
+ *
+ * Common code shared between init and update commands.
+ */
+export { SKILL_NAMES, getToolsWithSkillsDir, getToolSkillStatus, getToolStates, extractGeneratedByVersion, getToolVersionStatus, getConfiguredTools, getAllToolVersionStatus, } from './tool-detection.js';
+export { getSkillTemplates, getCommandTemplates, getCommandContents, generateSkillContent, } from './skill-generation.js';
+//# sourceMappingURL=index.js.map

package/dist/core/shared/skill-generation.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Skill Generation Utilities
+ *
+ * Shared utilities for generating skill and command files.
+ */
+import { getOpsxExploreCommandTemplate, type SkillTemplate } from '../templates/skill-templates.js';
+import type { CommandContent } from '../command-generation/index.js';
+/**
+ * Skill template with directory name mapping.
+ */
+export interface SkillTemplateEntry {
+    template: SkillTemplate;
+    dirName: string;
+}
+/**
+ * Command template with ID mapping.
+ */
+export interface CommandTemplateEntry {
+    template: ReturnType<typeof getOpsxExploreCommandTemplate>;
+    id: string;
+}
+/**
+ * Gets all skill templates with their directory names.
+ */
+export declare function getSkillTemplates(): SkillTemplateEntry[];
+/**
+ * Gets all command templates with their IDs.
+ */
+export declare function getCommandTemplates(): CommandTemplateEntry[];
+/**
+ * Converts command templates to CommandContent array.
+ */
+export declare function getCommandContents(): CommandContent[];
+/**
+ * Generates skill file content with YAML frontmatter.
+ *
+ * @param template - The skill template
+ * @param generatedByVersion - The OpenSpec version to embed in the file
+ * @param transformInstructions - Optional callback to transform the instructions content
+ */
+export declare function generateSkillContent(template: SkillTemplate, generatedByVersion: string, transformInstructions?: (instructions: string) => string): string;
+//# sourceMappingURL=skill-generation.d.ts.map

package/dist/core/shared/skill-generation.js

@@ -0,0 +1,80 @@
+/**
+ * Skill Generation Utilities
+ *
+ * Shared utilities for generating skill and command files.
+ */
+import { getExploreSkillTemplate, getNewChangeSkillTemplate, getContinueChangeSkillTemplate, getApplyChangeSkillTemplate, getFfChangeSkillTemplate, getSyncSpecsSkillTemplate, getArchiveChangeSkillTemplate, getBulkArchiveChangeSkillTemplate, getVerifyChangeSkillTemplate, getOnboardSkillTemplate, getOpsxExploreCommandTemplate, getOpsxNewCommandTemplate, getOpsxContinueCommandTemplate, getOpsxApplyCommandTemplate, getOpsxFfCommandTemplate, getOpsxSyncCommandTemplate, getOpsxArchiveCommandTemplate, getOpsxBulkArchiveCommandTemplate, getOpsxVerifyCommandTemplate, getOpsxOnboardCommandTemplate, } from '../templates/skill-templates.js';
+/**
+ * Gets all skill templates with their directory names.
+ */
+export function getSkillTemplates() {
+    return [
+        { template: getExploreSkillTemplate(), dirName: 'openspec-explore' },
+        { template: getNewChangeSkillTemplate(), dirName: 'openspec-new-change' },
+        { template: getContinueChangeSkillTemplate(), dirName: 'openspec-continue-change' },
+        { template: getApplyChangeSkillTemplate(), dirName: 'openspec-apply-change' },
+        { template: getFfChangeSkillTemplate(), dirName: 'openspec-ff-change' },
+        { template: getSyncSpecsSkillTemplate(), dirName: 'openspec-sync-specs' },
+        { template: getArchiveChangeSkillTemplate(), dirName: 'openspec-archive-change' },
+        { template: getBulkArchiveChangeSkillTemplate(), dirName: 'openspec-bulk-archive-change' },
+        { template: getVerifyChangeSkillTemplate(), dirName: 'openspec-verify-change' },
+        { template: getOnboardSkillTemplate(), dirName: 'openspec-onboard' },
+    ];
+}
+/**
+ * Gets all command templates with their IDs.
+ */
+export function getCommandTemplates() {
+    return [
+        { template: getOpsxExploreCommandTemplate(), id: 'explore' },
+        { template: getOpsxNewCommandTemplate(), id: 'new' },
+        { template: getOpsxContinueCommandTemplate(), id: 'continue' },
+        { template: getOpsxApplyCommandTemplate(), id: 'apply' },
+        { template: getOpsxFfCommandTemplate(), id: 'ff' },
+        { template: getOpsxSyncCommandTemplate(), id: 'sync' },
+        { template: getOpsxArchiveCommandTemplate(), id: 'archive' },
+        { template: getOpsxBulkArchiveCommandTemplate(), id: 'bulk-archive' },
+        { template: getOpsxVerifyCommandTemplate(), id: 'verify' },
+        { template: getOpsxOnboardCommandTemplate(), id: 'onboard' },
+    ];
+}
+/**
+ * Converts command templates to CommandContent array.
+ */
+export function getCommandContents() {
+    const commandTemplates = getCommandTemplates();
+    return commandTemplates.map(({ template, id }) => ({
+        id,
+        name: template.name,
+        description: template.description,
+        category: template.category,
+        tags: template.tags,
+        body: template.content,
+    }));
+}
+/**
+ * Generates skill file content with YAML frontmatter.
+ *
+ * @param template - The skill template
+ * @param generatedByVersion - The OpenSpec version to embed in the file
+ * @param transformInstructions - Optional callback to transform the instructions content
+ */
+export function generateSkillContent(template, generatedByVersion, transformInstructions) {
+    const instructions = transformInstructions
+        ? transformInstructions(template.instructions)
+        : template.instructions;
+    return `---
+name: ${template.name}
+description: ${template.description}
+license: ${template.license || 'MIT'}
+compatibility: ${template.compatibility || 'Requires openspec CLI.'}
+metadata:
+  author: ${template.metadata?.author || 'openspec'}
+  version: "${template.metadata?.version || '1.0'}"
+  generatedBy: "${generatedByVersion}"
+---
+
+${instructions}
+`;
+}
+//# sourceMappingURL=skill-generation.js.map

package/dist/core/shared/tool-detection.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Tool Detection Utilities
+ *
+ * Shared utilities for detecting tool configurations and version status.
+ */
+/**
+ * Names of skill directories created by openspec init.
+ */
+export declare const SKILL_NAMES: readonly ["openspec-explore", "openspec-new-change", "openspec-continue-change", "openspec-apply-change", "openspec-ff-change", "openspec-sync-specs", "openspec-archive-change", "openspec-bulk-archive-change", "openspec-verify-change"];
+export type SkillName = (typeof SKILL_NAMES)[number];
+/**
+ * Status of skill configuration for a tool.
+ */
+export interface ToolSkillStatus {
+    /** Whether the tool has any skills configured */
+    configured: boolean;
+    /** Whether all 9 skills are configured */
+    fullyConfigured: boolean;
+    /** Number of skills currently configured (0-9) */
+    skillCount: number;
+}
+/**
+ * Version information for a tool's skills.
+ */
+export interface ToolVersionStatus {
+    /** The tool ID */
+    toolId: string;
+    /** The tool's display name */
+    toolName: string;
+    /** Whether the tool has any skills configured */
+    configured: boolean;
+    /** The generatedBy version found in the skill files, or null if not found */
+    generatedByVersion: string | null;
+    /** Whether the tool needs updating (version mismatch or missing) */
+    needsUpdate: boolean;
+}
+/**
+ * Gets the list of tools with skillsDir configured.
+ */
+export declare function getToolsWithSkillsDir(): string[];
+/**
+ * Checks which skill files exist for a tool.
+ */
+export declare function getToolSkillStatus(projectRoot: string, toolId: string): ToolSkillStatus;
+/**
+ * Gets the skill status for all tools with skillsDir configured.
+ */
+export declare function getToolStates(projectRoot: string): Map<string, ToolSkillStatus>;
+/**
+ * Extracts the generatedBy version from a skill file's YAML frontmatter.
+ * Returns null if the field is not found or the file doesn't exist.
+ */
+export declare function extractGeneratedByVersion(skillFilePath: string): string | null;
+/**
+ * Gets version status for a tool by reading the first available skill file.
+ */
+export declare function getToolVersionStatus(projectRoot: string, toolId: string, currentVersion: string): ToolVersionStatus;
+/**
+ * Gets all configured tools in the project.
+ */
+export declare function getConfiguredTools(projectRoot: string): string[];
+/**
+ * Gets version status for all configured tools.
+ */
+export declare function getAllToolVersionStatus(projectRoot: string, currentVersion: string): ToolVersionStatus[];
+//# sourceMappingURL=tool-detection.d.ts.map

package/dist/core/shared/tool-detection.js

@@ -0,0 +1,140 @@
+/**
+ * Tool Detection Utilities
+ *
+ * Shared utilities for detecting tool configurations and version status.
+ */
+import path from 'path';
+import * as fs from 'fs';
+import { AI_TOOLS } from '../config.js';
+/**
+ * Names of skill directories created by openspec init.
+ */
+export const SKILL_NAMES = [
+    'openspec-explore',
+    'openspec-new-change',
+    'openspec-continue-change',
+    'openspec-apply-change',
+    'openspec-ff-change',
+    'openspec-sync-specs',
+    'openspec-archive-change',
+    'openspec-bulk-archive-change',
+    'openspec-verify-change',
+];
+/**
+ * Gets the list of tools with skillsDir configured.
+ */
+export function getToolsWithSkillsDir() {
+    return AI_TOOLS.filter((t) => t.skillsDir).map((t) => t.value);
+}
+/**
+ * Checks which skill files exist for a tool.
+ */
+export function getToolSkillStatus(projectRoot, toolId) {
+    const tool = AI_TOOLS.find((t) => t.value === toolId);
+    if (!tool?.skillsDir) {
+        return { configured: false, fullyConfigured: false, skillCount: 0 };
+    }
+    const skillsDir = path.join(projectRoot, tool.skillsDir, 'skills');
+    let skillCount = 0;
+    for (const skillName of SKILL_NAMES) {
+        const skillFile = path.join(skillsDir, skillName, 'SKILL.md');
+        if (fs.existsSync(skillFile)) {
+            skillCount++;
+        }
+    }
+    return {
+        configured: skillCount > 0,
+        fullyConfigured: skillCount === SKILL_NAMES.length,
+        skillCount,
+    };
+}
+/**
+ * Gets the skill status for all tools with skillsDir configured.
+ */
+export function getToolStates(projectRoot) {
+    const states = new Map();
+    const toolIds = AI_TOOLS.filter((t) => t.skillsDir).map((t) => t.value);
+    for (const toolId of toolIds) {
+        states.set(toolId, getToolSkillStatus(projectRoot, toolId));
+    }
+    return states;
+}
+/**
+ * Extracts the generatedBy version from a skill file's YAML frontmatter.
+ * Returns null if the field is not found or the file doesn't exist.
+ */
+export function extractGeneratedByVersion(skillFilePath) {
+    try {
+        if (!fs.existsSync(skillFilePath)) {
+            return null;
+        }
+        const content = fs.readFileSync(skillFilePath, 'utf-8');
+        // Look for generatedBy in the YAML frontmatter
+        // The file format is:
+        // ---
+        // ...
+        // metadata:
+        //   author: openspec
+        //   version: "1.0"
+        //   generatedBy: "0.23.0"
+        // ---
+        const generatedByMatch = content.match(/^\s*generatedBy:\s*["']?([^"'\n]+)["']?\s*$/m);
+        if (generatedByMatch && generatedByMatch[1]) {
+            return generatedByMatch[1].trim();
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Gets version status for a tool by reading the first available skill file.
+ */
+export function getToolVersionStatus(projectRoot, toolId, currentVersion) {
+    const tool = AI_TOOLS.find((t) => t.value === toolId);
+    if (!tool?.skillsDir) {
+        return {
+            toolId,
+            toolName: toolId,
+            configured: false,
+            generatedByVersion: null,
+            needsUpdate: false,
+        };
+    }
+    const skillsDir = path.join(projectRoot, tool.skillsDir, 'skills');
+    let generatedByVersion = null;
+    // Find the first skill file that exists and read its version
+    for (const skillName of SKILL_NAMES) {
+        const skillFile = path.join(skillsDir, skillName, 'SKILL.md');
+        if (fs.existsSync(skillFile)) {
+            generatedByVersion = extractGeneratedByVersion(skillFile);
+            break;
+        }
+    }
+    const configured = getToolSkillStatus(projectRoot, toolId).configured;
+    const needsUpdate = configured && (generatedByVersion === null || generatedByVersion !== currentVersion);
+    return {
+        toolId,
+        toolName: tool.name,
+        configured,
+        generatedByVersion,
+        needsUpdate,
+    };
+}
+/**
+ * Gets all configured tools in the project.
+ */
+export function getConfiguredTools(projectRoot) {
+    return AI_TOOLS
+        .filter((t) => t.skillsDir && getToolSkillStatus(projectRoot, t.value).configured)
+        .map((t) => t.value);
+}
+/**
+ * Gets version status for all configured tools.
+ */
+export function getAllToolVersionStatus(projectRoot, currentVersion) {
+    const configuredTools = getConfiguredTools(projectRoot);
+    return configuredTools.map((toolId) => getToolVersionStatus(projectRoot, toolId, currentVersion));
+}
+//# sourceMappingURL=tool-detection.js.map

package/dist/core/specs-apply.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Spec Application Logic
+ *
+ * Extracted from ArchiveCommand to enable standalone spec application.
+ * Applies delta specs from a change to main specs without archiving.
+ */
+export interface SpecUpdate {
+    source: string;
+    target: string;
+    exists: boolean;
+}
+export interface ApplyResult {
+    capability: string;
+    added: number;
+    modified: number;
+    removed: number;
+    renamed: number;
+}
+export interface SpecsApplyOutput {
+    changeName: string;
+    capabilities: ApplyResult[];
+    totals: {
+        added: number;
+        modified: number;
+        removed: number;
+        renamed: number;
+    };
+    noChanges: boolean;
+}
+/**
+ * Find all delta spec files that need to be applied from a change.
+ */
+export declare function findSpecUpdates(changeDir: string, mainSpecsDir: string): Promise<SpecUpdate[]>;
+/**
+ * Build an updated spec by applying delta operations.
+ * Returns the rebuilt content and counts of operations.
+ */
+export declare function buildUpdatedSpec(update: SpecUpdate, changeName: string): Promise<{
+    rebuilt: string;
+    counts: {
+        added: number;
+        modified: number;
+        removed: number;
+        renamed: number;
+    };
+}>;
+/**
+ * Write an updated spec to disk.
+ */
+export declare function writeUpdatedSpec(update: SpecUpdate, rebuilt: string, counts: {
+    added: number;
+    modified: number;
+    removed: number;
+    renamed: number;
+}): Promise<void>;
+/**
+ * Build a skeleton spec for new capabilities.
+ */
+export declare function buildSpecSkeleton(specFolderName: string, changeName: string): string;
+/**
+ * Apply all delta specs from a change to main specs.
+ *
+ * @param projectRoot - The project root directory
+ * @param changeName - The name of the change to apply
+ * @param options - Options for the operation
+ * @returns Result of the operation with counts
+ */
+export declare function applySpecs(projectRoot: string, changeName: string, options?: {
+    dryRun?: boolean;
+    skipValidation?: boolean;
+    silent?: boolean;
+}): Promise<SpecsApplyOutput>;
+//# sourceMappingURL=specs-apply.d.ts.map