@seanmars/tospec 0.19.0-beta.7 → 0.20.0

package/dist/core/global-config.js

@@ -1,7 +1,7 @@
 import * as fs from 'node:fs';
 import * as path from 'node:path';
 import * as os from 'node:os';
-// Constants
+import { stripBom } from './parsers/requirement-text.js';
 export const GLOBAL_CONFIG_DIR_NAME = 'tospec';
 export const GLOBAL_CONFIG_FILE_NAME = 'config.json';
 export const GLOBAL_DATA_DIR_NAME = 'tospec';
@@ -9,21 +9,17 @@ const DEFAULT_CONFIG = {
     profile: 'core',
 };
 /**
- * The single user-level tospec directory, on every platform.
+ * The single user-level tospec directory on every platform:
+ * `$XDG_CONFIG_HOME/tospec/`, else `~/.config/tospec/`.
  *
- * - $XDG_CONFIG_HOME/tospec/ when XDG_CONFIG_HOME is set
- * - ~/.config/tospec/ otherwise
- *
- * Deliberately platform-uniform: %APPDATA% is not consulted, so config, schema
- * overrides and the dashboard registry cannot end up in three different trees on
- * Windows. Anyone who wants the roaming behaviour back — %APPDATA% is synced
- * across domain-joined machines and the home directory is not — sets
- * XDG_CONFIG_HOME to it.
+ * Platform-uniform on purpose: %APPDATA% is not consulted, so config, schema
+ * overrides and the dashboard registry cannot land in three different trees on
+ * Windows. Point XDG_CONFIG_HOME at %APPDATA% for the roaming behaviour.
  */
 export function getGlobalConfigDir(options = {}) {
     const env = options.env ?? process.env;
     const platform = options.platform ?? os.platform();
-    // XDG_CONFIG_HOME takes precedence on all platforms when explicitly set
+    // XDG_CONFIG_HOME wins on every platform when explicitly set.
     const xdgConfigHome = env.XDG_CONFIG_HOME;
     if (xdgConfigHome) {
         return joinGlobalPath(platform, xdgConfigHome, GLOBAL_CONFIG_DIR_NAME);
@@ -38,42 +34,34 @@ function joinGlobalPath(platform, ...segments) {
         : path.posix.join(...segments);
 }
 /**
- * The user data directory schema overrides used to live in, before they moved
- * under the config directory.
- *
- * - macOS/Linux: ~/.local/share/tospec/
- * - Windows: %LOCALAPPDATA%/tospec/
+ * Where schema overrides lived before moving under the config directory:
+ * `~/.local/share/tospec/`, or `%LOCALAPPDATA%/tospec/` on Windows.
  *
- * XDG_DATA_HOME is deliberately *not* consulted here. It still names a live
- * schema override (see getUserSchemasDir), so a directory it points at is one
- * the user chose on purpose — reading it as "legacy" would have the migration
- * move files out of a location we are still honouring.
+ * XDG_DATA_HOME is *not* consulted: it still names a live schema override (see
+ * getUserSchemasDir), so reading it as "legacy" would migrate files out of a
+ * location tospec still honours.
  */
 export function getLegacyDataDir(options = {}) {
     const env = options.env ?? process.env;
     const platform = options.platform ?? os.platform();
     const homedir = options.homedir ?? os.homedir();
     if (platform === 'win32') {
-        // Windows: use %LOCALAPPDATA%
+        // Windows: %LOCALAPPDATA%.
         const localAppData = env.LOCALAPPDATA;
         if (localAppData) {
             return joinGlobalPath(platform, localAppData, GLOBAL_DATA_DIR_NAME);
         }
-        // Fallback for Windows if LOCALAPPDATA is not set
+        // Windows without LOCALAPPDATA.
         return joinGlobalPath(platform, homedir, 'AppData', 'Local', GLOBAL_DATA_DIR_NAME);
     }
-    // Unix/macOS fallback: ~/.local/share
+    // Unix/macOS: ~/.local/share.
     return joinGlobalPath(platform, homedir, '.local', 'share', GLOBAL_DATA_DIR_NAME);
 }
 /**
- * Where config lived before it moved under ~/.config. Only the migration and
- * the read fallback below consult it, and together with getLegacySchemasDir it
- * is the last place platform branching survives.
- *
- * On macOS/Linux — and on any platform with XDG_CONFIG_HOME set — the old
- * resolver already produced today's answer, so "legacy" is the current
- * directory and every caller degenerates into a no-op without needing to ask
- * which platform it is on.
+ * Where config lived before it moved under ~/.config; only the migration and the
+ * read fallback consult it. On macOS/Linux, and anywhere XDG_CONFIG_HOME is set,
+ * the old resolver already produced today's answer, so every caller degenerates
+ * into a no-op.
  */
 export function getLegacyConfigDir(options = {}) {
     const env = options.env ?? process.env;
@@ -87,31 +75,29 @@ export function getLegacyConfigDir(options = {}) {
         ? joinGlobalPath(platform, appData, GLOBAL_CONFIG_DIR_NAME)
         : joinGlobalPath(platform, homedir, 'AppData', 'Roaming', GLOBAL_CONFIG_DIR_NAME);
 }
-/**
- * Gets the path to the global config file.
- */
 export function getGlobalConfigPath() {
     return path.join(getGlobalConfigDir(), GLOBAL_CONFIG_FILE_NAME);
 }
 function readConfigFile(configPath) {
     try {
         const content = fs.readFileSync(configPath, 'utf-8');
-        const parsed = JSON.parse(content);
-        // Valid JSON is not the same as usable config. `[1,2,3]` and `"hello"` parse
-        // without a SyntaxError, and spreading either produces an index-keyed object
-        // that was returned as configuration — the user saw settings quietly not
-        // apply, with nothing naming the file. Route it to the same warn-and-default
-        // path a parse error takes.
+        // A BOM is not JSON whitespace, so `JSON.parse` throws on it before reaching
+        // the opening brace and the file is reported as invalid when it is not. The
+        // yaml reader tolerates one natively, so without this the two config formats
+        // disagree about the same edit in the same Windows editor.
+        const parsed = JSON.parse(stripBom(content));
+        // Valid JSON is not usable config: `[1,2,3]` and `"hello"` parse without a
+        // SyntaxError, and spreading either yields an index-keyed object that would
+        // be returned as configuration.
         if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
             console.error(`Warning: ${configPath} is not a JSON object, using defaults`);
             return { ...DEFAULT_CONFIG };
         }
-        // Merge with defaults (loaded values take precedence). Unknown keys from
-        // older config versions pass through harmlessly.
+        // Loaded values win; unknown keys from older versions pass through.
         return { ...DEFAULT_CONFIG, ...parsed };
     }
     catch (error) {
-        // Log warning for parse errors, but not for missing files
+        // A missing file is the normal case and says nothing.
         if (error instanceof SyntaxError) {
             console.error(`Warning: Invalid JSON in ${configPath}, using defaults`);
         }
@@ -119,20 +105,16 @@ function readConfigFile(configPath) {
     }
 }
 /**
- * Reads config from `configDir`, falling back to `legacyConfigDir` while an
- * install has not been migrated yet — migration only runs on init/update, so
- * without this a user who upgrades and runs anything else would silently drop
- * to the default profile. Writes always go to `configDir`, so the fallback
- * stops firing as soon as anything saves.
- *
- * Takes resolved directories rather than reading them itself so the on-disk
- * behaviour is testable without a platform whose legacy path differs.
+ * Falls back to `legacyConfigDir` while an install has not been migrated:
+ * migration only runs on init/update, so without this a user who upgrades and
+ * runs anything else silently drops to the default profile. Writes always go to
+ * `configDir`, so the fallback stops firing as soon as anything saves.
  */
 export function loadGlobalConfigFrom(configDir, legacyConfigDir) {
     const configPath = resolveConfigPath(configDir, legacyConfigDir);
     return fs.existsSync(configPath) ? readConfigFile(configPath) : { ...DEFAULT_CONFIG };
 }
-/** Single owner of the current-then-legacy precedence, so nothing re-derives it. */
+/** The single owner of the current-then-legacy precedence. */
 function resolveConfigPath(configDir, legacyConfigDir) {
     const configPath = path.join(configDir, GLOBAL_CONFIG_FILE_NAME);
     if (fs.existsSync(configPath)) {
@@ -142,31 +124,20 @@ function resolveConfigPath(configDir, legacyConfigDir) {
     return legacyPath !== configPath && fs.existsSync(legacyPath) ? legacyPath : configPath;
 }
 /**
- * The config file a read actually lands on. Callers that re-read the raw file to
- * tell explicit values from defaults need this rather than getGlobalConfigPath,
- * which names where config is *written* — during the fallback window those are
- * different files, and using the wrong one labels every explicit value
- * "(default)".
+ * The config file a read actually lands on, as opposed to getGlobalConfigPath,
+ * which names where config is *written*. During the fallback window those are
+ * different files, and the wrong one labels every explicit value "(default)".
  */
 export function getEffectiveConfigPath() {
     return resolveConfigPath(getGlobalConfigDir(), getLegacyConfigDir());
 }
-/**
- * Loads the global configuration from disk.
- * Returns default configuration if file doesn't exist or is invalid.
- * Merges loaded config with defaults to ensure new fields are available.
- */
+/** Merged over the defaults; a missing or invalid file yields the defaults. */
 export function getGlobalConfig() {
     return loadGlobalConfigFrom(getGlobalConfigDir(), getLegacyConfigDir());
 }
-/**
- * Saves the global configuration to disk.
- * Creates the config directory if it doesn't exist.
- */
 export function saveGlobalConfig(config) {
     const configDir = getGlobalConfigDir();
     const configPath = getGlobalConfigPath();
-    // Create directory if it doesn't exist
     if (!fs.existsSync(configDir)) {
         fs.mkdirSync(configDir, { recursive: true });
     }

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

@@ -1 +1 @@
-{"version":3,"file":"global-config.js","sourceRoot":"","sources":["../../src/core/global-config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"global-config.js","sourceRoot":"","sources":["../../src/core/global-config.ts"],"names":[],"mappings":"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"}

package/dist/core/init.d.ts

@@ -1,32 +1,41 @@
-/**
- * Init Command
- *
- * Sets up tospec Agent Skills for Claude Code and Codex.
- */
+/** Sets up tospec Agent Skills for Claude Code and Codex. */
 type InitCommandOptions = {
     tools?: string;
     force?: boolean;
     interactive?: boolean;
     profile?: string;
+    /** Emit one JSON document instead of progress prose. */
+    json?: boolean;
 };
+/** The `--json` null-shape; mirrors the success payload with `init` nulled. */
+export declare const INIT_FAILURE_PAYLOAD: Record<string, unknown>;
 export declare class InitCommand {
     private readonly toolsArg?;
     private readonly force;
     private readonly interactiveOption?;
     private readonly profileOverride?;
+    private readonly json;
     constructor(options?: InitCommandOptions);
+    /**
+     * Progress prose, suppressed under `--json`: the envelope contract allows only
+     * one document on stdout.
+     */
+    private say;
+    /**
+     * Unlike `say`, a warning has no other carrier — dropping it under `--json`
+     * would leave an agent caller less informed than a human.
+     */
+    private warn;
+    /** Emitted alongside the success payload; empty means the key is omitted. */
+    private readonly jsonWarnings;
     execute(targetPath: string): Promise<void>;
     private validate;
     /**
-     * Every row in the menu is now a real choice, so a row can still arrive
-     * uninvited — by being required by another. That has to be said *before* the
-     * prompt: an explanation reaching the user after they answered cannot inform
-     * the answer. Derived from the table so a future dependency documents itself.
+     * A row can arrive uninvited by being required by another, which has to be
+     * said *before* the prompt to inform the answer. Derived from the table so a
+     * future dependency documents itself.
      *
-     * Which is also why it is called from the prompt path only. A run driven by
-     * `--tools` or `--interactive=false` has no answer to inform, so the same
-     * lines there are just an unprompted paragraph about targets the user may not
-     * have picked — `tospec init --tools agents` explaining Claude Code.
+     * Prompt path only: a `--tools` run has no answer to inform.
      */
     private discloseToolDependencies;
     private canPromptInteractively;
@@ -35,12 +44,9 @@ export declare class InitCommand {
     private resolveToolsArg;
     private validateTools;
     /**
-     * Anchoring runs on every init, not only the first: a project that predates
-     * the rule reaches the same state by re-running the command it already runs
-     * to refresh generated files, with no separate migration step.
-     *
-     * extendMode differs only in staying quiet — the work itself is identical, so
-     * it is a pair of guards rather than a second copy of the loop.
+     * Anchoring runs on every init, not only the first, so a project predating the
+     * rule reaches the same state without a migration step. `extendMode` differs
+     * only in staying quiet.
      */
     private createDirectoryStructure;
     private generateSkillsAndCommands;

package/dist/core/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/core/init.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA2DH,KAAK,kBAAkB,GAAG;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAMF,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAU;IAChC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAU;IAC7C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAS;IAE1C,YAAY,OAAO,GAAE,kBAAuB,EAK3C;IAEK,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA2D/C;YAMa,QAAQ;IAatB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,wBAAwB;IAiBhC,OAAO,CAAC,sBAAsB;IAM9B,OAAO,CAAC,sBAAsB;YAgBhB,gBAAgB;IA2G9B,OAAO,CAAC,eAAe;IAyDvB,OAAO,CAAC,aAAa;IAsCrB;;;;;;;OAOG;YACW,wBAAwB;YAkBxB,yBAAyB;YAqGzB,YAAY;IAqB1B,OAAO,CAAC,qBAAqB;YAwGf,oBAAoB;CAqBnC"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/core/init.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAiD7D,KAAK,kBAAkB,GAAG;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,+EAA+E;AAC/E,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAA8B,CAAC;AAExF,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAU;IAChC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAU;IAC7C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAU;IAE/B,YAAY,OAAO,GAAE,kBAAuB,EAM3C;IAED;;;OAGG;IACH,OAAO,CAAC,GAAG;IAIX;;;OAGG;IACH,OAAO,CAAC,IAAI;IAQZ,6EAA6E;IAC7E,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA2B;IAElD,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA4G/C;YAEa,QAAQ;IAMtB;;;;;;OAMG;IACH,OAAO,CAAC,wBAAwB;IAiBhC,OAAO,CAAC,sBAAsB;IAM9B,OAAO,CAAC,sBAAsB;YAYhB,gBAAgB;IAoG9B,OAAO,CAAC,eAAe;IAyDvB,OAAO,CAAC,aAAa;IAkCrB;;;;OAIG;YACW,wBAAwB;YAcxB,yBAAyB;YAmFzB,YAAY;IAgB1B,OAAO,CAAC,qBAAqB;YA6Ff,oBAAoB;CAoBnC"}