@seanmars/tospec 0.19.0-beta.0 → 0.19.0-beta.13

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,67 +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;
-/**
- * Coerce a string value to its appropriate type.
- * - "true" / "false" -> boolean
- * - Numeric strings -> number
- * - JSON arrays/objects -> parsed containers
- * - Everything else -> string
- *
- * @param value - The string value to coerce
- * @param forceString - If true, always return the value as a string
- * @returns The coerced value
- */
-export declare function coerceValue(value: string, forceString?: boolean): 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
- */
+/** 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>;
 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;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,EACb,WAAW,GAAE,OAAe,GAC3B,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAyBjE;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"}

package/dist/core/config-schema.js

@@ -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 const GlobalConfigSchema = z
     .object({
     profile: z
@@ -14,9 +11,6 @@ export const GlobalConfigSchema = z
         .optional(),
 })
     .passthrough();
-/**
- * Default configuration values.
- */
 export const DEFAULT_CONFIG = {
     profile: 'core',
 };
@@ -31,16 +25,12 @@ function hasUnsafeSegment(keys) {
 }
 /**
  * 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 function hasUnsafeKeySegment(path) {
     return hasUnsafeSegment(path.split('.'));
 }
-/**
- * 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 function validateConfigKeyPath(path) {
     const rawKeys = path.split('.');
     if (rawKeys.length === 0 || rawKeys.some((key) => key.trim() === '')) {
@@ -59,13 +49,7 @@ export function validateConfigKeyPath(path) {
     }
     return { valid: true };
 }
-/**
- * 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 function getNestedValue(obj, path) {
     const keys = path.split('.');
     if (hasUnsafeSegment(keys)) {
@@ -83,19 +67,12 @@ export function getNestedValue(obj, path) {
     }
     return current;
 }
-/**
- * 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 function setNestedValue(obj, path, value) {
     const keys = path.split('.');
-    // Compared literally rather than through a helper, so the guard is plain to a
-    // reader and to static analysis. Checked for the whole path before anything is
-    // written, so a rejected key never leaves half-created objects behind.
+    // Compared literally rather than through a helper, so the guard is plain to
+    // static analysis. Checked for the whole path before anything is written, so
+    // a rejected key leaves no half-created objects.
     for (const key of keys) {
         if (key === '__proto__' || key === 'constructor' || key === 'prototype') {
             return;
@@ -112,13 +89,7 @@ export function setNestedValue(obj, path, value) {
     const lastKey = keys[keys.length - 1];
     current[lastKey] = value;
 }
-/**
- * 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 function deleteNestedValue(obj, path) {
     const keys = path.split('.');
     for (const key of keys) {
@@ -127,43 +98,57 @@ export function deleteNestedValue(obj, path) {
         }
     }
     let current = obj;
+    // Every container on the way down, so emptied parents can be pruned after
+    // the leaf goes: `unset foo.bar` used to leave `foo: {}` behind, a key
+    // `config list` then showed as if the user had set it.
+    const trail = [];
     for (let i = 0; i < keys.length - 1; i++) {
         const key = keys[i];
         if (current[key] === undefined || current[key] === null || typeof current[key] !== 'object') {
             return false;
         }
+        trail.push({ parent: current, key });
         current = current[key];
     }
     const lastKey = keys[keys.length - 1];
-    if (lastKey in current) {
-        delete current[lastKey];
-        return true;
+    if (!(lastKey in current)) {
+        return false;
+    }
+    delete current[lastKey];
+    for (let i = trail.length - 1; i >= 0; i--) {
+        const { parent, key } = trail[i];
+        const container = parent[key];
+        if (Object.keys(container).length > 0)
+            break;
+        delete parent[key];
     }
-    return false;
+    return true;
 }
 /**
- * Coerce a string value to its appropriate type.
- * - "true" / "false" -> boolean
- * - Numeric strings -> number
- * - JSON arrays/objects -> parsed containers
- * - Everything else -> string
- *
- * @param value - The string value to coerce
- * @param forceString - If true, always return the value as a string
- * @returns The coerced value
+ * Config keys whose value is a list. Splitting on commas cannot be decided from
+ * the value alone — a string key such as `context` may legitimately contain
+ * them — so the decision is keyed on the field, read from the same schema that
+ * validates the result.
  */
-export function coerceValue(value, forceString = false) {
+const ARRAY_VALUED_KEYS = new Set(Object.entries(GlobalConfigSchema.shape)
+    .filter(([, field]) => {
+    // Unwrap `.optional()` to reach the array underneath.
+    const inner = field instanceof z.ZodOptional ? field.unwrap() : field;
+    return inner instanceof z.ZodArray;
+})
+    .map(([name]) => name));
+/** Reads a CLI string as a boolean, number, JSON container, list, or string. */
+export function coerceValue(value, forceString = false, key) {
     if (forceString) {
         return value;
     }
-    // Boolean coercion
     if (value === 'true') {
         return true;
     }
     if (value === 'false') {
         return false;
     }
-    // Number coercion - must be a valid finite number
+    // Finite numbers only; `''`, `'NaN'` and `'Infinity'` stay strings.
     const num = Number(value);
     if (!isNaN(num) && isFinite(num) && value.trim() !== '') {
         return num;
@@ -172,6 +157,15 @@ export function coerceValue(value, forceString = false) {
     if (jsonContainer !== undefined) {
         return jsonContainer;
     }
+    // `--tools a,b,c` already reads this way, so requiring a JSON array would make
+    // the syntax the CLI teaches elsewhere fail with a type error. JSON is tried
+    // first, so an explicit array literal still wins and `--string` opts out.
+    if (key !== undefined && ARRAY_VALUED_KEYS.has(key)) {
+        return value
+            .split(',')
+            .map((entry) => entry.trim())
+            .filter(Boolean);
+    }
     return value;
 }
 function parseJsonContainer(value) {
@@ -195,12 +189,6 @@ function parseJsonContainer(value) {
     }
     return undefined;
 }
-/**
- * Validate a configuration object against the schema.
- *
- * @param config - The configuration to validate
- * @returns Validation result with success status and optional error message
- */
 export function validateConfig(config) {
     try {
         GlobalConfigSchema.parse(config);
@@ -208,8 +196,7 @@ export function validateConfig(config) {
     }
     catch (error) {
         if (error instanceof z.ZodError) {
-            const zodError = error;
-            const messages = zodError.issues.map((e) => `${e.path.join('.')}: ${e.message}`);
+            const messages = error.issues.map((e) => `${e.path.join('.')}: ${e.message}`);
             return { success: false, error: messages.join('; ') };
         }
         return { success: false, error: 'Unknown validation error' };