@niujiajie/freespec 0.0.0-stage → 1.15.0

package/dist/core/command-generation/adapters/claude.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Claude Code Command Adapter
+ *
+ * Formats commands for Claude Code following its frontmatter specification.
+ */
+import type { ToolCommandAdapter } from '../types.js';
+/**
+ * Claude Code adapter for command generation.
+ * File path: .claude/commands/freespec/<id>.md
+ * Frontmatter: name, description, allowed-tools, category, tags
+ */
+export declare const claudeAdapter: ToolCommandAdapter;
+//# sourceMappingURL=claude.d.ts.map

package/dist/core/command-generation/adapters/claude.js

@@ -0,0 +1,32 @@
+/**
+ * Claude Code Command Adapter
+ *
+ * Formats commands for Claude Code following its frontmatter specification.
+ */
+import path from 'path';
+import { escapeYamlValue, formatTagsArray } from '../yaml.js';
+import { OPENSPEC_CLI_ALLOWED_TOOLS } from '../../shared/allowed-tools.js';
+/**
+ * Claude Code adapter for command generation.
+ * File path: .claude/commands/freespec/<id>.md
+ * Frontmatter: name, description, allowed-tools, category, tags
+ */
+export const claudeAdapter = {
+    toolId: 'claude',
+    getFilePath(commandId) {
+        return path.join('.claude', 'commands', 'freespec', `${commandId}.md`);
+    },
+    formatFile(content) {
+        return `---
+name: ${escapeYamlValue(content.name)}
+description: ${escapeYamlValue(content.description)}
+allowed-tools: ${OPENSPEC_CLI_ALLOWED_TOOLS}
+category: ${escapeYamlValue(content.category)}
+tags: ${formatTagsArray(content.tags)}
+---
+
+${content.body}
+`;
+    },
+};
+//# sourceMappingURL=claude.js.map

package/dist/core/command-generation/adapters/cline.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Cline Command Adapter
+ *
+ * Formats commands for Cline following its workflow specification.
+ * Cline uses markdown headers instead of YAML frontmatter.
+ */
+import type { ToolCommandAdapter } from '../types.js';
+/**
+ * Cline adapter for command generation.
+ * File path: .clinerules/workflows/freespec-<id>.md
+ * Format: Markdown header with description
+ */
+export declare const clineAdapter: ToolCommandAdapter;
+//# sourceMappingURL=cline.d.ts.map

package/dist/core/command-generation/adapters/cline.js

@@ -0,0 +1,27 @@
+/**
+ * Cline Command Adapter
+ *
+ * Formats commands for Cline following its workflow specification.
+ * Cline uses markdown headers instead of YAML frontmatter.
+ */
+import path from 'path';
+/**
+ * Cline adapter for command generation.
+ * File path: .clinerules/workflows/freespec-<id>.md
+ * Format: Markdown header with description
+ */
+export const clineAdapter = {
+    toolId: 'cline',
+    getFilePath(commandId) {
+        return path.join('.clinerules', 'workflows', `freespec-${commandId}.md`);
+    },
+    formatFile(content) {
+        return `# ${content.name}
+
+${content.description}
+
+${content.body}
+`;
+    },
+};
+//# sourceMappingURL=cline.js.map

package/dist/core/command-generation/adapters/codeassistant.d.ts

@@ -0,0 +1,15 @@
+/**
+ * SourceCraft Code Assistant Command Adapter
+ *
+ * Formats commands for the SourceCraft Code Assistant VS Code extension.
+ *
+ * @see https://sourcecraft.dev/portal/docs/en/code-assistant/operations/agent/slash-commands
+ */
+import type { ToolCommandAdapter } from '../types.js';
+/**
+ * SourceCraft Code Assistant adapter for command generation.
+ * File path: .codeassistant/commands/freespec-<id>.md
+ * Format: YAML frontmatter with description
+ */
+export declare const codeassistantAdapter: ToolCommandAdapter;
+//# sourceMappingURL=codeassistant.d.ts.map

package/dist/core/command-generation/adapters/codeassistant.js

@@ -0,0 +1,29 @@
+/**
+ * SourceCraft Code Assistant Command Adapter
+ *
+ * Formats commands for the SourceCraft Code Assistant VS Code extension.
+ *
+ * @see https://sourcecraft.dev/portal/docs/en/code-assistant/operations/agent/slash-commands
+ */
+import path from 'path';
+import { escapeYamlValue } from '../yaml.js';
+/**
+ * SourceCraft Code Assistant adapter for command generation.
+ * File path: .codeassistant/commands/freespec-<id>.md
+ * Format: YAML frontmatter with description
+ */
+export const codeassistantAdapter = {
+    toolId: 'codeassistant',
+    getFilePath(commandId) {
+        return path.join('.codeassistant', 'commands', `freespec-${commandId}.md`);
+    },
+    formatFile(content) {
+        return `---
+description: ${escapeYamlValue(content.description)}
+---
+
+${content.body}
+`;
+    },
+};
+//# sourceMappingURL=codeassistant.js.map

package/dist/core/command-generation/adapters/codebuddy.d.ts

@@ -0,0 +1,13 @@
+/**
+ * CodeBuddy Command Adapter
+ *
+ * Formats commands for CodeBuddy following its frontmatter specification.
+ */
+import type { ToolCommandAdapter } from '../types.js';
+/**
+ * CodeBuddy adapter for command generation.
+ * File path: .codebuddy/commands/freespec/<id>.md
+ * Frontmatter: name, description, argument-hint
+ */
+export declare const codebuddyAdapter: ToolCommandAdapter;
+//# sourceMappingURL=codebuddy.d.ts.map

package/dist/core/command-generation/adapters/codebuddy.js

@@ -0,0 +1,29 @@
+/**
+ * CodeBuddy Command Adapter
+ *
+ * Formats commands for CodeBuddy following its frontmatter specification.
+ */
+import path from 'path';
+import { escapeYamlValue } from '../yaml.js';
+/**
+ * CodeBuddy adapter for command generation.
+ * File path: .codebuddy/commands/freespec/<id>.md
+ * Frontmatter: name, description, argument-hint
+ */
+export const codebuddyAdapter = {
+    toolId: 'codebuddy',
+    getFilePath(commandId) {
+        return path.join('.codebuddy', 'commands', 'freespec', `${commandId}.md`);
+    },
+    formatFile(content) {
+        return `---
+name: ${escapeYamlValue(content.name)}
+description: ${escapeYamlValue(content.description)}
+argument-hint: "[command arguments]"
+---
+
+${content.body}
+`;
+    },
+};
+//# sourceMappingURL=codebuddy.js.map

package/dist/core/command-generation/adapters/codestudio.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Code Studio Command Adapter
+ *
+ * Formats commands for Syncfusion Code Studio following its .prompt.md specification.
+ */
+import type { ToolCommandAdapter } from '../types.js';
+/**
+ * Code Studio adapter for command generation.
+ * File path: .codestudio/prompts/freespec-<id>.prompt.md
+ * Frontmatter: description
+ */
+export declare const codeStudioAdapter: ToolCommandAdapter;
+//# sourceMappingURL=codestudio.d.ts.map

package/dist/core/command-generation/adapters/codestudio.js

@@ -0,0 +1,27 @@
+/**
+ * Code Studio Command Adapter
+ *
+ * Formats commands for Syncfusion Code Studio following its .prompt.md specification.
+ */
+import path from 'path';
+import { escapeYamlValue } from '../yaml.js';
+/**
+ * Code Studio adapter for command generation.
+ * File path: .codestudio/prompts/freespec-<id>.prompt.md
+ * Frontmatter: description
+ */
+export const codeStudioAdapter = {
+    toolId: 'codestudio',
+    getFilePath(commandId) {
+        return path.join('.codestudio', 'prompts', `freespec-${commandId}.prompt.md`);
+    },
+    formatFile(content) {
+        return `---
+description: ${escapeYamlValue(content.description)}
+---
+
+${content.body}
+`;
+    },
+};
+//# sourceMappingURL=codestudio.js.map

package/dist/core/command-generation/adapters/command-code.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Command Code Command Adapter
+ *
+ * Command Code reads custom slash commands from `.commandcode/commands/`. The
+ * command name is the markdown filename without its `.md` extension, so
+ * `freespec-<id>.md` registers `/freespec-<id>` — the same flat naming Cursor and
+ * OpenCode use. See https://commandcode.ai/docs/reference/slash-commands.
+ */
+import type { ToolCommandAdapter } from '../types.js';
+/**
+ * Command Code adapter for command generation.
+ * File path: .commandcode/commands/freespec-<id>.md
+ * Format: plain Markdown with $ARGUMENTS injected after the input contract
+ *
+ * Command Code executes the full trimmed file body and substitutes invocation
+ * arguments only where the body includes one of its argument placeholders.
+ */
+export declare const commandCodeAdapter: ToolCommandAdapter;
+//# sourceMappingURL=command-code.d.ts.map

package/dist/core/command-generation/adapters/command-code.js

@@ -0,0 +1,34 @@
+/**
+ * Command Code Command Adapter
+ *
+ * Command Code reads custom slash commands from `.commandcode/commands/`. The
+ * command name is the markdown filename without its `.md` extension, so
+ * `freespec-<id>.md` registers `/freespec-<id>` — the same flat naming Cursor and
+ * OpenCode use. See https://commandcode.ai/docs/reference/slash-commands.
+ */
+import path from 'path';
+const COMMAND_CODE_INPUT_HEADING = /^\*\*Input\*\*:[^\n]*$/m;
+function injectCommandCodeArgs(body) {
+    if (/^\*\*Provided arguments\*\*:\s*(?:\$(?:ARGUMENTS|@)|\$\{(?:ARGUMENTS|@)\})\s*$/m.test(body)) {
+        return body;
+    }
+    return body.replace(COMMAND_CODE_INPUT_HEADING, (heading) => `${heading}\n**Provided arguments**: $ARGUMENTS`);
+}
+/**
+ * Command Code adapter for command generation.
+ * File path: .commandcode/commands/freespec-<id>.md
+ * Format: plain Markdown with $ARGUMENTS injected after the input contract
+ *
+ * Command Code executes the full trimmed file body and substitutes invocation
+ * arguments only where the body includes one of its argument placeholders.
+ */
+export const commandCodeAdapter = {
+    toolId: 'command-code',
+    getFilePath(commandId) {
+        return path.join('.commandcode', 'commands', `freespec-${commandId}.md`);
+    },
+    formatFile(content) {
+        return `${injectCommandCodeArgs(content.body)}\n`;
+    },
+};
+//# sourceMappingURL=command-code.js.map

package/dist/core/command-generation/adapters/continue.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Continue Command Adapter
+ *
+ * Formats commands for Continue following its .prompt specification.
+ */
+import type { ToolCommandAdapter } from '../types.js';
+/**
+ * Continue adapter for command generation.
+ * File path: .continue/prompts/freespec-<id>.prompt
+ * Frontmatter: name, description, invokable
+ */
+export declare const continueAdapter: ToolCommandAdapter;
+//# sourceMappingURL=continue.d.ts.map

package/dist/core/command-generation/adapters/continue.js

@@ -0,0 +1,33 @@
+/**
+ * Continue Command Adapter
+ *
+ * Formats commands for Continue following its .prompt specification.
+ */
+import path from 'path';
+import { escapeYamlValue } from '../yaml.js';
+/**
+ * Continue adapter for command generation.
+ * File path: .continue/prompts/freespec-<id>.prompt
+ * Frontmatter: name, description, invokable
+ */
+export const continueAdapter = {
+    toolId: 'continue',
+    getFilePath(commandId) {
+        return path.join('.continue', 'prompts', `freespec-${commandId}.prompt`);
+    },
+    formatFile(content) {
+        // Continue injects an invoked prompt into the model context. Smaller local
+        // models can otherwise mistake the workflow name for a tool to call (#925).
+        return `---
+name: ${escapeYamlValue(`freespec-${content.id}`)}
+description: ${escapeYamlValue(content.description)}
+invokable: true
+---
+
+This workflow prompt is already active. Follow its instructions directly. Do not call a tool named after this workflow.
+
+${content.body}
+`;
+    },
+};
+//# sourceMappingURL=continue.js.map

package/dist/core/command-generation/adapters/costrict.d.ts

@@ -0,0 +1,13 @@
+/**
+ * CoStrict Command Adapter
+ *
+ * Formats commands for CoStrict following its frontmatter specification.
+ */
+import type { ToolCommandAdapter } from '../types.js';
+/**
+ * CoStrict adapter for command generation.
+ * File path: .cospec/freespec/commands/freespec-<id>.md
+ * Frontmatter: description, argument-hint
+ */
+export declare const costrictAdapter: ToolCommandAdapter;
+//# sourceMappingURL=costrict.d.ts.map

package/dist/core/command-generation/adapters/costrict.js

@@ -0,0 +1,28 @@
+/**
+ * CoStrict Command Adapter
+ *
+ * Formats commands for CoStrict following its frontmatter specification.
+ */
+import path from 'path';
+import { escapeYamlValue } from '../yaml.js';
+/**
+ * CoStrict adapter for command generation.
+ * File path: .cospec/freespec/commands/freespec-<id>.md
+ * Frontmatter: description, argument-hint
+ */
+export const costrictAdapter = {
+    toolId: 'costrict',
+    getFilePath(commandId) {
+        return path.join('.cospec', 'freespec', 'commands', `freespec-${commandId}.md`);
+    },
+    formatFile(content) {
+        return `---
+description: ${escapeYamlValue(content.description)}
+argument-hint: command arguments
+---
+
+${content.body}
+`;
+    },
+};
+//# sourceMappingURL=costrict.js.map

package/dist/core/command-generation/adapters/crush.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Crush Command Adapter
+ *
+ * Formats commands for Crush following its frontmatter specification.
+ */
+import type { ToolCommandAdapter } from '../types.js';
+/**
+ * Crush adapter for command generation.
+ * File path: .crush/commands/freespec/<id>.md
+ * Frontmatter: name, description, category, tags
+ */
+export declare const crushAdapter: ToolCommandAdapter;
+//# sourceMappingURL=crush.d.ts.map

package/dist/core/command-generation/adapters/crush.js

@@ -0,0 +1,30 @@
+/**
+ * Crush Command Adapter
+ *
+ * Formats commands for Crush following its frontmatter specification.
+ */
+import path from 'path';
+import { escapeYamlValue, formatTagsArray } from '../yaml.js';
+/**
+ * Crush adapter for command generation.
+ * File path: .crush/commands/freespec/<id>.md
+ * Frontmatter: name, description, category, tags
+ */
+export const crushAdapter = {
+    toolId: 'crush',
+    getFilePath(commandId) {
+        return path.join('.crush', 'commands', 'freespec', `${commandId}.md`);
+    },
+    formatFile(content) {
+        return `---
+name: ${escapeYamlValue(content.name)}
+description: ${escapeYamlValue(content.description)}
+category: ${escapeYamlValue(content.category)}
+tags: ${formatTagsArray(content.tags)}
+---
+
+${content.body}
+`;
+    },
+};
+//# sourceMappingURL=crush.js.map

package/dist/core/command-generation/adapters/cursor.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Cursor Command Adapter
+ *
+ * Formats commands for Cursor following its frontmatter specification.
+ * Cursor uses a different frontmatter format and file naming convention.
+ */
+import type { ToolCommandAdapter } from '../types.js';
+/**
+ * Cursor adapter for command generation.
+ * File path: .cursor/commands/freespec-<id>.md
+ * Frontmatter: name (as /freespec-<id>), id, category, description
+ */
+export declare const cursorAdapter: ToolCommandAdapter;
+//# sourceMappingURL=cursor.d.ts.map

package/dist/core/command-generation/adapters/cursor.js

@@ -0,0 +1,31 @@
+/**
+ * Cursor Command Adapter
+ *
+ * Formats commands for Cursor following its frontmatter specification.
+ * Cursor uses a different frontmatter format and file naming convention.
+ */
+import path from 'path';
+import { escapeYamlValue } from '../yaml.js';
+/**
+ * Cursor adapter for command generation.
+ * File path: .cursor/commands/freespec-<id>.md
+ * Frontmatter: name (as /freespec-<id>), id, category, description
+ */
+export const cursorAdapter = {
+    toolId: 'cursor',
+    getFilePath(commandId) {
+        return path.join('.cursor', 'commands', `freespec-${commandId}.md`);
+    },
+    formatFile(content) {
+        return `---
+name: ${escapeYamlValue(`/freespec-${content.id}`)}
+id: ${escapeYamlValue(`freespec-${content.id}`)}
+category: ${escapeYamlValue(content.category)}
+description: ${escapeYamlValue(content.description)}
+---
+
+${content.body}
+`;
+    },
+};
+//# sourceMappingURL=cursor.js.map

package/dist/core/command-generation/adapters/devin.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Devin Desktop Command Adapter
+ *
+ * Formats commands for Devin Desktop following its frontmatter specification.
+ * Devin Desktop reads Cascade-style workflows from `.devin/workflows/`, the
+ * same shape Windsurf uses.
+ */
+import type { ToolCommandAdapter } from '../types.js';
+/**
+ * Devin Desktop adapter for command generation.
+ * File path: .devin/workflows/freespec-<id>.md
+ * Frontmatter: name, description, category, tags
+ *
+ * The `freespec-` filename prefix makes this a flat invocation, so the generator
+ * rewrites the body's `/freespec:*` references to the `/freespec-*` form Devin
+ * registers — see invocation.ts.
+ */
+export declare const devinAdapter: ToolCommandAdapter;
+//# sourceMappingURL=devin.d.ts.map

package/dist/core/command-generation/adapters/devin.js

@@ -0,0 +1,36 @@
+/**
+ * Devin Desktop Command Adapter
+ *
+ * Formats commands for Devin Desktop following its frontmatter specification.
+ * Devin Desktop reads Cascade-style workflows from `.devin/workflows/`, the
+ * same shape Windsurf uses.
+ */
+import path from 'path';
+import { escapeYamlValue, formatTagsArray } from '../yaml.js';
+/**
+ * Devin Desktop adapter for command generation.
+ * File path: .devin/workflows/freespec-<id>.md
+ * Frontmatter: name, description, category, tags
+ *
+ * The `freespec-` filename prefix makes this a flat invocation, so the generator
+ * rewrites the body's `/freespec:*` references to the `/freespec-*` form Devin
+ * registers — see invocation.ts.
+ */
+export const devinAdapter = {
+    toolId: 'devin',
+    getFilePath(commandId) {
+        return path.join('.devin', 'workflows', `freespec-${commandId}.md`);
+    },
+    formatFile(content) {
+        return `---
+name: ${escapeYamlValue(content.name)}
+description: ${escapeYamlValue(content.description)}
+category: ${escapeYamlValue(content.category)}
+tags: ${formatTagsArray(content.tags)}
+---
+
+${content.body}
+`;
+    },
+};
+//# sourceMappingURL=devin.js.map

package/dist/core/command-generation/adapters/easycode.d.ts

@@ -0,0 +1,17 @@
+/**
+ * EasyCode Command Adapter
+ *
+ * Formats commands for OrionStarAI/EasyCode using its TOML command format.
+ * https://github.com/OrionStarAI/EasyCode
+ */
+import type { ToolCommandAdapter } from '../types.js';
+/**
+ * EasyCode adapter for command generation.
+ * File path: .easycode/commands/freespec/<id>.toml
+ *
+ * Format:
+ *   description = "<basic-string>"         single-line, backslash/quote-safe
+ *   prompt = """<multiline-string>"""       multiline, backslash/triple-quote-safe
+ */
+export declare const easycodeAdapter: ToolCommandAdapter;
+//# sourceMappingURL=easycode.d.ts.map

package/dist/core/command-generation/adapters/easycode.js

@@ -0,0 +1,28 @@
+/**
+ * EasyCode Command Adapter
+ *
+ * Formats commands for OrionStarAI/EasyCode using its TOML command format.
+ * https://github.com/OrionStarAI/EasyCode
+ */
+import path from 'path';
+import { escapeTomlBasicString, escapeTomlMultilineBasicString } from '../toml.js';
+/**
+ * EasyCode adapter for command generation.
+ * File path: .easycode/commands/freespec/<id>.toml
+ *
+ * Format:
+ *   description = "<basic-string>"         single-line, backslash/quote-safe
+ *   prompt = """<multiline-string>"""       multiline, backslash/triple-quote-safe
+ */
+export const easycodeAdapter = {
+    toolId: 'easycode',
+    getFilePath(commandId) {
+        return path.join('.easycode', 'commands', 'freespec', `${commandId}.toml`);
+    },
+    formatFile(content) {
+        const safeDesc = escapeTomlBasicString(content.description);
+        const safeBody = escapeTomlMultilineBasicString(content.body);
+        return `description = "${safeDesc}"\n\nprompt = """\n${safeBody}\n"""\n`;
+    },
+};
+//# sourceMappingURL=easycode.js.map

package/dist/core/command-generation/adapters/factory.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Factory Droid Command Adapter
+ *
+ * Formats commands for Factory Droid following its frontmatter specification.
+ */
+import type { ToolCommandAdapter } from '../types.js';
+/**
+ * Factory adapter for command generation.
+ * File path: .factory/commands/freespec-<id>.md
+ * Frontmatter: description, argument-hint
+ */
+export declare const factoryAdapter: ToolCommandAdapter;
+//# sourceMappingURL=factory.d.ts.map

package/dist/core/command-generation/adapters/factory.js

@@ -0,0 +1,28 @@
+/**
+ * Factory Droid Command Adapter
+ *
+ * Formats commands for Factory Droid following its frontmatter specification.
+ */
+import path from 'path';
+import { escapeYamlValue } from '../yaml.js';
+/**
+ * Factory adapter for command generation.
+ * File path: .factory/commands/freespec-<id>.md
+ * Frontmatter: description, argument-hint
+ */
+export const factoryAdapter = {
+    toolId: 'factory',
+    getFilePath(commandId) {
+        return path.join('.factory', 'commands', `freespec-${commandId}.md`);
+    },
+    formatFile(content) {
+        return `---
+description: ${escapeYamlValue(content.description)}
+argument-hint: command arguments
+---
+
+${content.body}
+`;
+    },
+};
+//# sourceMappingURL=factory.js.map

package/dist/core/command-generation/adapters/gemini.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Gemini CLI Command Adapter
+ *
+ * Formats commands for Gemini CLI following its TOML specification.
+ */
+import type { ToolCommandAdapter } from '../types.js';
+/**
+ * Gemini adapter for command generation.
+ * File path: .gemini/commands/freespec/<id>.toml
+ * Format: TOML with description and prompt fields
+ */
+export declare const geminiAdapter: ToolCommandAdapter;
+//# sourceMappingURL=gemini.d.ts.map

package/dist/core/command-generation/adapters/gemini.js

@@ -0,0 +1,27 @@
+/**
+ * Gemini CLI Command Adapter
+ *
+ * Formats commands for Gemini CLI following its TOML specification.
+ */
+import path from 'path';
+import { escapeTomlBasicString, escapeTomlMultilineBasicString } from '../toml.js';
+/**
+ * Gemini adapter for command generation.
+ * File path: .gemini/commands/freespec/<id>.toml
+ * Format: TOML with description and prompt fields
+ */
+export const geminiAdapter = {
+    toolId: 'gemini',
+    getFilePath(commandId) {
+        return path.join('.gemini', 'commands', 'freespec', `${commandId}.toml`);
+    },
+    formatFile(content) {
+        return `description = "${escapeTomlBasicString(content.description)}"
+
+prompt = """
+${escapeTomlMultilineBasicString(content.body)}
+"""
+`;
+    },
+};
+//# sourceMappingURL=gemini.js.map