@fission-ai/openspec 0.23.0 → 1.0.0

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

@@ -0,0 +1,41 @@
+/**
+ * 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
+ */
+export declare function generateSkillContent(template: SkillTemplate, generatedByVersion: string): string;
+//# sourceMappingURL=skill-generation.d.ts.map

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

@@ -0,0 +1,76 @@
+/**
+ * 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
+ */
+export function generateSkillContent(template, generatedByVersion) {
+    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}"
+---
+
+${template.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/templates/index.d.ts

@@ -1,17 +1,8 @@
-import { ProjectContext } from './project-template.js';
-import { SlashCommandId } from './slash-command-templates.js';
-export interface Template {
-    path: string;
-    content: string | ((context: ProjectContext) => string);
-}
-export declare class TemplateManager {
-    static getTemplates(context?: ProjectContext): Template[];
-    static getClaudeTemplate(): string;
-    static getClineTemplate(): string;
-    static getCostrictTemplate(): string;
-    static getAgentsStandardTemplate(): string;
-    static getSlashCommandBody(id: SlashCommandId): string;
-}
-export { ProjectContext } from './project-template.js';
-export type { SlashCommandId } from './slash-command-templates.js';
+/**
+ * Template exports for OpenSpec.
+ *
+ * The old config file templates (AGENTS.md, project.md, claude-template, etc.)
+ * have been removed. The skill-based workflow uses skill-templates.ts directly.
+ */
+export { getExploreSkillTemplate, getNewChangeSkillTemplate, getContinueChangeSkillTemplate, getApplyChangeSkillTemplate, getFfChangeSkillTemplate, getSyncSpecsSkillTemplate, getArchiveChangeSkillTemplate, getBulkArchiveChangeSkillTemplate, getVerifyChangeSkillTemplate, getOpsxExploreCommandTemplate, getOpsxNewCommandTemplate, getOpsxContinueCommandTemplate, getOpsxApplyCommandTemplate, getOpsxFfCommandTemplate, getOpsxSyncCommandTemplate, getOpsxArchiveCommandTemplate, getOpsxBulkArchiveCommandTemplate, getOpsxVerifyCommandTemplate, } from './skill-templates.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/core/templates/index.js

@@ -1,37 +1,9 @@
-import { agentsTemplate } from './agents-template.js';
-import { projectTemplate } from './project-template.js';
-import { claudeTemplate } from './claude-template.js';
-import { clineTemplate } from './cline-template.js';
-import { costrictTemplate } from './costrict-template.js';
-import { agentsRootStubTemplate } from './agents-root-stub.js';
-import { getSlashCommandBody } from './slash-command-templates.js';
-export class TemplateManager {
-    static getTemplates(context = {}) {
-        return [
-            {
-                path: 'AGENTS.md',
-                content: agentsTemplate
-            },
-            {
-                path: 'project.md',
-                content: projectTemplate(context)
-            }
-        ];
-    }
-    static getClaudeTemplate() {
-        return claudeTemplate;
-    }
-    static getClineTemplate() {
-        return clineTemplate;
-    }
-    static getCostrictTemplate() {
-        return costrictTemplate;
-    }
-    static getAgentsStandardTemplate() {
-        return agentsRootStubTemplate;
-    }
-    static getSlashCommandBody(id) {
-        return getSlashCommandBody(id);
-    }
-}
+/**
+ * Template exports for OpenSpec.
+ *
+ * The old config file templates (AGENTS.md, project.md, claude-template, etc.)
+ * have been removed. The skill-based workflow uses skill-templates.ts directly.
+ */
+// Re-export skill templates for convenience
+export { getExploreSkillTemplate, getNewChangeSkillTemplate, getContinueChangeSkillTemplate, getApplyChangeSkillTemplate, getFfChangeSkillTemplate, getSyncSpecsSkillTemplate, getArchiveChangeSkillTemplate, getBulkArchiveChangeSkillTemplate, getVerifyChangeSkillTemplate, getOpsxExploreCommandTemplate, getOpsxNewCommandTemplate, getOpsxContinueCommandTemplate, getOpsxApplyCommandTemplate, getOpsxFfCommandTemplate, getOpsxSyncCommandTemplate, getOpsxArchiveCommandTemplate, getOpsxBulkArchiveCommandTemplate, getOpsxVerifyCommandTemplate, } from './skill-templates.js';
 //# sourceMappingURL=index.js.map

package/dist/core/templates/skill-templates.d.ts

@@ -11,6 +11,9 @@ export interface SkillTemplate {
     name: string;
     description: string;
     instructions: string;
+    license?: string;
+    compatibility?: string;
+    metadata?: Record<string, string>;
 }
 /**
  * Template for openspec-explore skill
@@ -42,6 +45,11 @@ export declare function getFfChangeSkillTemplate(): SkillTemplate;
  * For syncing delta specs from a change to main specs (agent-driven)
  */
 export declare function getSyncSpecsSkillTemplate(): SkillTemplate;
+/**
+ * Template for openspec-onboard skill
+ * Guided onboarding through the complete OpenSpec workflow
+ */
+export declare function getOnboardSkillTemplate(): SkillTemplate;
 export interface CommandTemplate {
     name: string;
     description: string;
@@ -93,6 +101,11 @@ export declare function getVerifyChangeSkillTemplate(): SkillTemplate;
  * Template for /opsx:archive slash command
  */
 export declare function getOpsxArchiveCommandTemplate(): CommandTemplate;
+/**
+ * Template for /opsx:onboard slash command
+ * Guided onboarding through the complete OpenSpec workflow
+ */
+export declare function getOpsxOnboardCommandTemplate(): CommandTemplate;
 /**
  * Template for /opsx:bulk-archive slash command
  */