@seanmars/tospec 0.19.0-beta.8 → 0.20.0

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

@@ -1,22 +1,12 @@
-/**
- * Claude Code Command Adapter
- *
- * Formats commands for Claude Code following its frontmatter specification.
- */
 import path from 'path';
 import { escapeYamlValue } from '../yaml.js';
-/**
- * Formats a tags array as a YAML array with proper escaping.
- */
 function formatTagsArray(tags) {
     const escapedTags = tags.map((tag) => escapeYamlValue(tag));
     return `[${escapedTags.join(', ')}]`;
 }
 /**
- * Claude Code adapter for command generation.
- * File path: .claude/commands/tosx/<id>.md — the `tosx` sub-folder becomes the
- * command namespace, so commands are invoked as `/tosx:<id>`.
- * Frontmatter: name, description, category, tags
+ * The `tosx` sub-folder becomes the command namespace, so what lands at
+ * `.claude/commands/tosx/<id>.md` is invoked as `/tosx:<id>`.
  */
 export const claudeAdapter = {
     toolId: 'claude',

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

@@ -1 +1 @@
-{"version":3,"file":"claude.js","sourceRoot":"","sources":["../../../../src/core/command-generation/adapters/claude.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C;;GAEG;AACH,SAAS,eAAe,CAAC,IAAc;IACrC,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5D,OAAO,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;AACvC,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAuB;IAC/C,MAAM,EAAE,QAAQ;IAEhB,WAAW,CAAC,SAAiB;QAC3B,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,SAAS,KAAK,CAAC,CAAC;IACrE,CAAC;IAED,UAAU,CAAC,OAAuB;QAChC,OAAO;QACH,eAAe,CAAC,OAAO,CAAC,IAAI,CAAC;eACtB,eAAe,CAAC,OAAO,CAAC,WAAW,CAAC;YACvC,eAAe,CAAC,OAAO,CAAC,QAAQ,CAAC;QACrC,eAAe,CAAC,OAAO,CAAC,IAAI,CAAC;;;EAGnC,OAAO,CAAC,IAAI;CACb,CAAC;IACA,CAAC;CACF,CAAC"}
+{"version":3,"file":"claude.js","sourceRoot":"","sources":["../../../../src/core/command-generation/adapters/claude.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,SAAS,eAAe,CAAC,IAAc;IACrC,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5D,OAAO,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;AACvC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAuB;IAC/C,MAAM,EAAE,QAAQ;IAEhB,WAAW,CAAC,SAAiB;QAC3B,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,SAAS,KAAK,CAAC,CAAC;IACrE,CAAC;IAED,UAAU,CAAC,OAAuB;QAChC,OAAO;QACH,eAAe,CAAC,OAAO,CAAC,IAAI,CAAC;eACtB,eAAe,CAAC,OAAO,CAAC,WAAW,CAAC;YACvC,eAAe,CAAC,OAAO,CAAC,QAAQ,CAAC;QACrC,eAAe,CAAC,OAAO,CAAC,IAAI,CAAC;;;EAGnC,OAAO,CAAC,IAAI;CACb,CAAC;IACA,CAAC;CACF,CAAC"}

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

@@ -1,15 +1,7 @@
-/**
- * Command Adapters Index
- *
- * Re-exports the tool command adapters tospec ships (claude only).
- */
 import type { ToolCommandAdapter } from '../types.js';
 import { claudeAdapter } from './claude.js';
 export { claudeAdapter };
-/**
- * The adapter registry. Adding a tool means adding it here — callers resolve by
- * `toolId` rather than testing the tool name, so no generation code changes.
- */
+/** Adding a tool means adding it here; callers resolve by `toolId`. */
 export declare const COMMAND_ADAPTERS: readonly ToolCommandAdapter[];
 export declare function findCommandAdapter(toolId: string): ToolCommandAdapter | undefined;
 //# sourceMappingURL=index.d.ts.map

package/dist/core/command-generation/adapters/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/command-generation/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,aAAa,EAAE,CAAC;AAEzB;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,kBAAkB,EAAoB,CAAC;AAE/E,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAEjF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/command-generation/adapters/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,aAAa,EAAE,CAAC;AAEzB,uEAAuE;AACvE,eAAO,MAAM,gBAAgB,EAAE,SAAS,kBAAkB,EAAoB,CAAC;AAE/E,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAEjF"}

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

@@ -1,14 +1,6 @@
-/**
- * Command Adapters Index
- *
- * Re-exports the tool command adapters tospec ships (claude only).
- */
 import { claudeAdapter } from './claude.js';
 export { claudeAdapter };
-/**
- * The adapter registry. Adding a tool means adding it here — callers resolve by
- * `toolId` rather than testing the tool name, so no generation code changes.
- */
+/** Adding a tool means adding it here; callers resolve by `toolId`. */
 export const COMMAND_ADAPTERS = [claudeAdapter];
 export function findCommandAdapter(toolId) {
     return COMMAND_ADAPTERS.find((adapter) => adapter.toolId === toolId);

package/dist/core/command-generation/adapters/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/command-generation/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,aAAa,EAAE,CAAC;AAEzB;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAkC,CAAC,aAAa,CAAC,CAAC;AAE/E,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC/C,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;AACvE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/command-generation/adapters/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,aAAa,EAAE,CAAC;AAEzB,uEAAuE;AACvE,MAAM,CAAC,MAAM,gBAAgB,GAAkC,CAAC,aAAa,CAAC,CAAC;AAE/E,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC/C,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;AACvE,CAAC"}

package/dist/core/command-generation/generator.d.ts

@@ -1,21 +1,4 @@
-/**
- * Command Generator
- *
- * Functions for generating command files using tool adapters.
- */
 import type { CommandContent, ToolCommandAdapter, GeneratedCommand } from './types.js';
-/**
- * Generate a single command file using the provided adapter.
- * @param content - The tool-agnostic command content
- * @param adapter - The tool-specific adapter
- * @returns Generated command with path and file content
- */
 export declare function generateCommand(content: CommandContent, adapter: ToolCommandAdapter): GeneratedCommand;
-/**
- * Generate multiple command files using the provided adapter.
- * @param contents - Array of tool-agnostic command contents
- * @param adapter - The tool-specific adapter
- * @returns Array of generated commands with paths and file contents
- */
 export declare function generateCommands(contents: CommandContent[], adapter: ToolCommandAdapter): GeneratedCommand[];
 //# sourceMappingURL=generator.d.ts.map

package/dist/core/command-generation/generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../../src/core/command-generation/generator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEvF;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,kBAAkB,GAC1B,gBAAgB,CAKlB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,cAAc,EAAE,EAC1B,OAAO,EAAE,kBAAkB,GAC1B,gBAAgB,EAAE,CAEpB"}
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../../src/core/command-generation/generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEvF,wBAAgB,eAAe,CAC7B,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,kBAAkB,GAC1B,gBAAgB,CAKlB;AAED,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,cAAc,EAAE,EAC1B,OAAO,EAAE,kBAAkB,GAC1B,gBAAgB,EAAE,CAEpB"}

package/dist/core/command-generation/generator.js

@@ -1,26 +1,9 @@
-/**
- * Command Generator
- *
- * Functions for generating command files using tool adapters.
- */
-/**
- * Generate a single command file using the provided adapter.
- * @param content - The tool-agnostic command content
- * @param adapter - The tool-specific adapter
- * @returns Generated command with path and file content
- */
 export function generateCommand(content, adapter) {
     return {
         path: adapter.getFilePath(content.id),
         fileContent: adapter.formatFile(content),
     };
 }
-/**
- * Generate multiple command files using the provided adapter.
- * @param contents - Array of tool-agnostic command contents
- * @param adapter - The tool-specific adapter
- * @returns Array of generated commands with paths and file contents
- */
 export function generateCommands(contents, adapter) {
     return contents.map((content) => generateCommand(content, adapter));
 }

package/dist/core/command-generation/generator.js.map

@@ -1 +1 @@
-{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../../src/core/command-generation/generator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAC7B,OAAuB,EACvB,OAA2B;IAE3B,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC;QACrC,WAAW,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC;KACzC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAC9B,QAA0B,EAC1B,OAA2B;IAE3B,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;AACtE,CAAC"}
+{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../../src/core/command-generation/generator.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,eAAe,CAC7B,OAAuB,EACvB,OAA2B;IAE3B,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC;QACrC,WAAW,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC;KACzC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,QAA0B,EAC1B,OAA2B;IAE3B,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;AACtE,CAAC"}

package/dist/core/command-generation/index.d.ts

@@ -1,9 +1,6 @@
 /**
- * Command Generation Module
- *
- * Generic command generation with a tool adapter. Claude Code is the only
- * shipped adapter today; add a tool by writing an adapter in adapters/ and
- * registering it in COMMAND_ADAPTERS — callers resolve it by toolId.
+ * Command generation through a tool adapter. Claude Code is the only shipped
+ * one; add a tool by writing an adapter and registering it in COMMAND_ADAPTERS.
  */
 export type { CommandContent, ToolCommandAdapter, GeneratedCommand, } from './types.js';
 export { generateCommand, generateCommands } from './generator.js';

package/dist/core/command-generation/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/command-generation/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,YAAY,EACV,cAAc,EACd,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGnE,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/command-generation/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,YAAY,EACV,cAAc,EACd,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEnE,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/core/command-generation/index.js

@@ -1,12 +1,3 @@
-/**
- * Command Generation Module
- *
- * Generic command generation with a tool adapter. Claude Code is the only
- * shipped adapter today; add a tool by writing an adapter in adapters/ and
- * registering it in COMMAND_ADAPTERS — callers resolve it by toolId.
- */
-// Generator functions
 export { generateCommand, generateCommands } from './generator.js';
-// Adapters
 export { claudeAdapter, COMMAND_ADAPTERS, findCommandAdapter } from './adapters/index.js';
 //# sourceMappingURL=index.js.map

package/dist/core/command-generation/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/command-generation/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,sBAAsB;AACtB,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEnE,WAAW;AACX,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/command-generation/index.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEnE,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/core/command-generation/types.d.ts

@@ -1,56 +1,30 @@
-/**
- * Command Generation Types
- *
- * Tool-agnostic interfaces for command generation.
- * These types separate "what to generate" from "how to format it".
- */
-/**
- * Tool-agnostic command data.
- * Represents the content of a command without any tool-specific formatting.
- */
+/** A command's content, before any tool-specific formatting. */
 export interface CommandContent {
-    /** Command identifier (e.g., 'explore', 'apply', 'new') */
+    /** e.g. 'explore', 'apply', 'new'. */
     id: string;
-    /** Human-readable name (e.g., 'Tospec Explore') */
     name: string;
-    /** Brief description of command purpose */
     description: string;
-    /** Grouping category (e.g., 'Workflow') */
+    /** Grouping category, e.g. 'Workflow'. */
     category: string;
-    /** Array of tag strings */
     tags: string[];
-    /** The command instruction content (body text) */
+    /** The command instruction text. */
     body: string;
 }
-/**
- * Per-tool formatting strategy.
- * Each AI tool implements this interface to handle its specific file path
- * and frontmatter format requirements.
- */
+/** Per-tool formatting strategy: where the file goes and how it is framed. */
 export interface ToolCommandAdapter {
-    /** Tool identifier matching AIToolOption.value (e.g., 'claude', 'cursor') */
+    /** Matches AIToolOption.value, e.g. 'claude'. */
     toolId: string;
     /**
-     * Returns the file path for a command.
-     * @param commandId - The command identifier (e.g., 'explore')
-     * @returns Path from project root (e.g., '.claude/commands/tosx/explore.md').
-     *          May be absolute for tools with global-scoped prompts (e.g., Codex).
+     * Path from the project root, e.g. '.claude/commands/tosx/explore.md'. May be
+     * absolute for a tool with global-scoped prompts.
      */
     getFilePath(commandId: string): string;
-    /**
-     * Formats the complete file content including frontmatter.
-     * @param content - The tool-agnostic command content
-     * @returns Complete file content ready to write
-     */
+    /** The complete file, frontmatter included. */
     formatFile(content: CommandContent): string;
 }
-/**
- * Result of generating a command file.
- */
 export interface GeneratedCommand {
-    /** File path from project root, or absolute for global-scoped tools */
+    /** From the project root, or absolute for global-scoped tools. */
     path: string;
-    /** Complete file content (frontmatter + body) */
     fileContent: string;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/core/command-generation/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/command-generation/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,2DAA2D;IAC3D,EAAE,EAAE,MAAM,CAAC;IACX,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,6EAA6E;IAC7E,MAAM,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IACvC;;;;OAIG;IACH,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,WAAW,EAAE,MAAM,CAAC;CACrB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/command-generation/types.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,MAAM,WAAW,cAAc;IAC7B,sCAAsC;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,8EAA8E;AAC9E,MAAM,WAAW,kBAAkB;IACjC,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IACvC,+CAA+C;IAC/C,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAAC;CAC7C;AAED,MAAM,WAAW,gBAAgB;IAC/B,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB"}

package/dist/core/command-generation/types.js

@@ -1,8 +1,2 @@
-/**
- * Command Generation Types
- *
- * Tool-agnostic interfaces for command generation.
- * These types separate "what to generate" from "how to format it".
- */
 export {};
 //# sourceMappingURL=types.js.map

package/dist/core/command-generation/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/command-generation/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/command-generation/types.ts"],"names":[],"mappings":""}

package/dist/core/command-generation/yaml.d.ts

@@ -1,22 +1,7 @@
 /**
- * Shared YAML frontmatter helpers for command adapters.
- *
- * Several tool adapters emit YAML frontmatter and need to escape
- * user-facing strings (name, description, category, tags) so the
- * generated file stays valid YAML. This module centralizes that logic
- * so the behavior is identical across adapters and fixed in one place.
- */
-/**
- * Escapes a string value for safe YAML output.
- *
- * Quotes the value with double quotes when it contains characters that
- * carry special meaning in YAML (or leading/trailing whitespace), and
- * escapes the characters that are not representable verbatim inside a
- * double-quoted scalar: backslash, double quote, line feed and carriage
- * return. Values without special characters are returned unquoted.
- *
- * @param value - The raw string to embed in YAML frontmatter.
- * @returns The value, double-quoted and escaped when necessary.
+ * Double-quotes and escapes a frontmatter value when it carries YAML-special
+ * characters or edge whitespace; returns it unquoted otherwise. Shared by every
+ * adapter so the escaping cannot differ between them.
  */
 export declare function escapeYamlValue(value: string): string;
 //# sourceMappingURL=yaml.d.ts.map

package/dist/core/command-generation/yaml.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"yaml.d.ts","sourceRoot":"","sources":["../../../src/core/command-generation/yaml.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAgBrD"}
+{"version":3,"file":"yaml.d.ts","sourceRoot":"","sources":["../../../src/core/command-generation/yaml.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAarD"}

package/dist/core/command-generation/yaml.js

@@ -1,31 +1,13 @@
 /**
- * Shared YAML frontmatter helpers for command adapters.
- *
- * Several tool adapters emit YAML frontmatter and need to escape
- * user-facing strings (name, description, category, tags) so the
- * generated file stays valid YAML. This module centralizes that logic
- * so the behavior is identical across adapters and fixed in one place.
- */
-/**
- * Escapes a string value for safe YAML output.
- *
- * Quotes the value with double quotes when it contains characters that
- * carry special meaning in YAML (or leading/trailing whitespace), and
- * escapes the characters that are not representable verbatim inside a
- * double-quoted scalar: backslash, double quote, line feed and carriage
- * return. Values without special characters are returned unquoted.
- *
- * @param value - The raw string to embed in YAML frontmatter.
- * @returns The value, double-quoted and escaped when necessary.
+ * Double-quotes and escapes a frontmatter value when it carries YAML-special
+ * characters or edge whitespace; returns it unquoted otherwise. Shared by every
+ * adapter so the escaping cannot differ between them.
  */
 export function escapeYamlValue(value) {
-    // Check if value needs quoting (contains special YAML characters or starts/ends with whitespace)
     const needsQuoting = /[:\n\r#{}[\],&*!|>'"%@`]|^\s|\s$/.test(value);
     if (needsQuoting) {
-        // Use double quotes and escape characters that are not safe to emit
-        // verbatim inside a double-quoted YAML scalar. Carriage returns must be
-        // escaped too: a literal CR inside double quotes is subject to YAML line
-        // folding/normalization and would silently corrupt the round-tripped value.
+        // CR too: a literal one inside double quotes is subject to YAML line
+        // folding and corrupts the round-tripped value.
         const escaped = value
             .replace(/\\/g, '\\\\')
             .replace(/"/g, '\\"')

package/dist/core/command-generation/yaml.js.map

@@ -1 +1 @@
-{"version":3,"file":"yaml.js","sourceRoot":"","sources":["../../../src/core/command-generation/yaml.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,iGAAiG;IACjG,MAAM,YAAY,GAAG,kCAAkC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpE,IAAI,YAAY,EAAE,CAAC;QACjB,oEAAoE;QACpE,wEAAwE;QACxE,yEAAyE;QACzE,4EAA4E;QAC5E,MAAM,OAAO,GAAG,KAAK;aAClB,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC;aACtB,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC;aACpB,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC;aACrB,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACzB,OAAO,IAAI,OAAO,GAAG,CAAC;IACxB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"yaml.js","sourceRoot":"","sources":["../../../src/core/command-generation/yaml.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,MAAM,YAAY,GAAG,kCAAkC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpE,IAAI,YAAY,EAAE,CAAC;QACjB,qEAAqE;QACrE,gDAAgD;QAChD,MAAM,OAAO,GAAG,KAAK;aAClB,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC;aACtB,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC;aACpB,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC;aACrB,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACzB,OAAO,IAAI,OAAO,GAAG,CAAC;IACxB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/core/config-prompts.d.ts

@@ -1,9 +1,7 @@
 import type { ProjectConfig } from './project-config.js';
 /**
- * Serialize config to YAML string with helpful comments.
- *
- * @param config - Partial config object (schema required, context/rules optional)
- * @returns YAML string ready to write to file
+ * A starter config.yaml: the `schema` value plus commented-out examples of
+ * `context` and `rules`. Only `schema` is read from `config`.
  */
 export declare function serializeConfig(config: Partial<ProjectConfig>): string;
 //# sourceMappingURL=config-prompts.d.ts.map

package/dist/core/config-prompts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config-prompts.d.ts","sourceRoot":"","sources":["../../src/core/config-prompts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,MAAM,CA8BtE"}
+{"version":3,"file":"config-prompts.d.ts","sourceRoot":"","sources":["../../src/core/config-prompts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,MAAM,CA2BtE"}

package/dist/core/config-prompts.js

@@ -1,15 +1,11 @@
 /**
- * Serialize config to YAML string with helpful comments.
- *
- * @param config - Partial config object (schema required, context/rules optional)
- * @returns YAML string ready to write to file
+ * A starter config.yaml: the `schema` value plus commented-out examples of
+ * `context` and `rules`. Only `schema` is read from `config`.
  */
 export function serializeConfig(config) {
     const lines = [];
-    // Schema (required)
     lines.push(`schema: ${config.schema}`);
     lines.push('');
-    // Context section with comments
     lines.push('# Project context (optional)');
     lines.push('# This is shown to AI when creating artifacts.');
     lines.push('# Add your tech stack, conventions, style guides, domain knowledge, etc.');
@@ -19,7 +15,6 @@ export function serializeConfig(config) {
     lines.push('#     We use conventional commits');
     lines.push('#     Domain: e-commerce platform');
     lines.push('');
-    // Rules section with comments
     lines.push('# Per-artifact rules (optional)');
     lines.push('# Add custom rules for specific artifacts.');
     lines.push('# Example:');

package/dist/core/config-prompts.js.map

@@ -1 +1 @@
-{"version":3,"file":"config-prompts.js","sourceRoot":"","sources":["../../src/core/config-prompts.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,MAA8B;IAC5D,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,oBAAoB;IACpB,KAAK,CAAC,IAAI,CAAC,WAAW,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACvC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,gCAAgC;IAChC,KAAK,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;IAC3C,KAAK,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;IAC7D,KAAK,CAAC,IAAI,CAAC,0EAA0E,CAAC,CAAC;IACvF,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACzB,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC7B,KAAK,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;IAC3D,KAAK,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;IAChD,KAAK,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;IAChD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,8BAA8B;IAC9B,KAAK,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;IAC9C,KAAK,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;IACzD,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACzB,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACzB,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAC9B,KAAK,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;IACvD,KAAK,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;IAC7D,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;IAE/D,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AACjC,CAAC"}
+{"version":3,"file":"config-prompts.js","sourceRoot":"","sources":["../../src/core/config-prompts.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,MAA8B;IAC5D,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,WAAW,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACvC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,KAAK,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;IAC3C,KAAK,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;IAC7D,KAAK,CAAC,IAAI,CAAC,0EAA0E,CAAC,CAAC;IACvF,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACzB,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC7B,KAAK,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;IAC3D,KAAK,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;IAChD,KAAK,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;IAChD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,KAAK,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;IAC9C,KAAK,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;IACzD,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACzB,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACzB,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAC9B,KAAK,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;IACvD,KAAK,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;IAC7D,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;IAE/D,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AACjC,CAAC"}

package/dist/core/config-schema.d.ts

@@ -1,8 +1,5 @@
 import { z } from 'zod';
-/**
- * Zod schema for global Tospec configuration.
- * Uses passthrough() to preserve unknown fields for forward compatibility.
- */
+/** passthrough() preserves unknown fields, for forward compatibility. */
 export declare const GlobalConfigSchema: z.ZodObject<{
     profile: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
         core: "core";
@@ -11,56 +8,25 @@ export declare const GlobalConfigSchema: z.ZodObject<{
     workflows: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$loose>;
 export type GlobalConfigType = z.infer<typeof GlobalConfigSchema>;
-/**
- * Default configuration values.
- */
 export declare const DEFAULT_CONFIG: GlobalConfigType;
 /**
  * True when a dot-notation key path contains a prototype-reaching segment.
- * Callers that bypass key validation (e.g. --allow-unknown) still must not
- * bypass this.
+ * `--allow-unknown` relaxes key validation, never this.
  */
 export declare function hasUnsafeKeySegment(path: string): boolean;
-/**
- * Validate a config key path for CLI set operations.
- * Unknown top-level keys are rejected unless explicitly allowed by the caller.
- */
+/** Unknown top-level keys are rejected unless the caller allows them. */
 export declare function validateConfigKeyPath(path: string): {
     valid: boolean;
     reason?: string;
 };
-/**
- * Get a nested value from an object using dot notation.
- *
- * @param obj - The object to access
- * @param path - Dot-separated path (e.g., "featureFlags.someFlag")
- * @returns The value at the path, or undefined if not found
- */
+/** Reads `obj` at a dot-separated path, e.g. "featureFlags.someFlag". */
 export declare function getNestedValue(obj: Record<string, unknown>, path: string): unknown;
-/**
- * Set a nested value in an object using dot notation.
- * Creates intermediate objects as needed.
- *
- * @param obj - The object to modify (mutated in place)
- * @param path - Dot-separated path (e.g., "featureFlags.someFlag")
- * @param value - The value to set
- */
+/** Writes `obj` at a dot-separated path, creating intermediate objects. */
 export declare function setNestedValue(obj: Record<string, unknown>, path: string, value: unknown): void;
-/**
- * Delete a nested value from an object using dot notation.
- *
- * @param obj - The object to modify (mutated in place)
- * @param path - Dot-separated path (e.g., "featureFlags.someFlag")
- * @returns true if the key existed and was deleted, false otherwise
- */
+/** Deletes `obj`'s value at a dot-separated path; false when it was absent. */
 export declare function deleteNestedValue(obj: Record<string, unknown>, path: string): boolean;
+/** Reads a CLI string as a boolean, number, JSON container, list, or string. */
 export declare function coerceValue(value: string, forceString?: boolean, key?: string): string | number | boolean | unknown[] | Record<string, unknown>;
-/**
- * Validate a configuration object against the schema.
- *
- * @param config - The configuration to validate
- * @returns Validation result with success status and optional error message
- */
 export declare function validateConfig(config: unknown): {
     success: boolean;
     error?: string;

package/dist/core/config-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config-schema.d.ts","sourceRoot":"","sources":["../../src/core/config-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;;iBAUf,CAAC;AAEjB,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAElE;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,gBAE5B,CAAC;AAcF;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAsBvF;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAkBlF;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAwB/F;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAyBrF;AA+BD,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,EACb,WAAW,GAAE,OAAe,EAC5B,GAAG,CAAC,EAAE,MAAM,GACX,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAqCjE;AA2BD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAYpF"}
+{"version":3,"file":"config-schema.d.ts","sourceRoot":"","sources":["../../src/core/config-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,yEAAyE;AACzE,eAAO,MAAM,kBAAkB;;;;;;iBAUf,CAAC;AAEjB,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAElE,eAAO,MAAM,cAAc,EAAE,gBAE5B,CAAC;AAcF;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED,yEAAyE;AACzE,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAsBvF;AAED,yEAAyE;AACzE,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAkBlF;AAED,2EAA2E;AAC3E,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAwB/F;AAED,+EAA+E;AAC/E,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAqCrF;AAkBD,gFAAgF;AAChF,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,EACb,WAAW,GAAE,OAAe,EAC5B,GAAG,CAAC,EAAE,MAAM,GACX,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAkCjE;AA2BD,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAWpF"}