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

package/dist/core/project-config.js

@@ -2,131 +2,143 @@ import { existsSync, readFileSync } from 'fs';
 import path from 'path';
 import { parse as parseYaml } from 'yaml';
 import { z } from 'zod';
-/**
- * Zod schema for project configuration.
- *
- * Purpose:
- * 1. Documentation - clearly defines the config file structure
- * 2. Type safety - TypeScript infers ProjectConfig type from schema
- * 3. Runtime validation - uses safeParse() for resilient field-by-field validation
- *
- * Why Zod over manual validation:
- * - Helps understand Tospec's data interfaces at a glance
- * - Single source of truth for type and validation
- * - Consistent with other Tospec schemas
- */
+/** Single source of truth for both `ProjectConfig` and its runtime validation. */
 export const ProjectConfigSchema = z.object({
-    // Required: which schema to use (e.g., "sdd", or project-local schema name)
     schema: z
         .string()
         .min(1)
         .describe('The workflow schema to use (e.g., "sdd")'),
-    // Optional: project context (injected into all artifact instructions)
-    // Max size: 50KB (enforced during parsing)
+    // Capped at MAX_CONTEXT_SIZE during parsing.
     context: z
         .string()
         .optional()
         .describe('Project context injected into all artifact instructions'),
-    // Optional: per-artifact rules (additive to schema's built-in guidance)
+    // Additive to the schema's built-in guidance.
     rules: z
-        .record(z.string(), // artifact ID
-    z.array(z.string()) // list of rules
-    )
+        .record(z.string(), z.array(z.string()))
         .optional()
         .describe('Per-artifact rules, keyed by artifact ID'),
-    // Optional: dashboard tuning (ADR 001). staleDays: days without any file
-    // change before an active change is flagged stale (default 14).
+    // ADR 001. staleDays: days without a file change before an active change is
+    // flagged stale (default 14).
     dashboard: z
         .object({
         staleDays: z.number().int().positive().optional(),
     })
         .optional()
         .describe('Dashboard settings (staleDays: stale-change threshold in days)'),
-    // Note: the retired `agentsLinkMode` field (per-tool skill delivery mode)
-    // is intentionally absent — existing config files that still carry it are
-    // simply ignored, never an error.
+    // The retired `agentsLinkMode` field is absent on purpose: config files still
+    // carrying it are ignored, never an error.
 });
 export const MAX_CONTEXT_SIZE = 50 * 1024; // 50KB hard limit on inlined context
 /**
- * Read and parse tospec/config.yaml from project root.
- * Uses resilient parsing - validates each field independently using Zod safeParse.
- * Returns null if file doesn't exist.
- * Returns partial config if some fields are invalid (with warnings).
+ * Reads `tospec/config.yaml`, validating each field independently so one bad
+ * field does not discard the rest. Uncached on purpose: ~0.5 ms for a typical
+ * config and 1-2 reads per command, so mtime invalidation would buy nothing.
  *
- * Performance note (Jan 2025):
- * Benchmarks showed direct file reads are fast enough without caching:
- * - Typical config (1KB): ~0.5ms per read
- * - Large config (50KB): ~1.6ms per read
- * - Missing config: ~0.01ms per read
- * Config is read 1-2 times per command (schema resolution + instruction loading),
- * adding ~1-3ms total overhead. Caching would add complexity (mtime checks,
- * invalidation logic) for negligible benefit. Direct reads also ensure config
- * changes are reflected immediately without stale cache issues.
- *
- * @param projectRoot - The root directory of the project (where `tospec/` lives)
- * @returns Parsed config or null if file doesn't exist
+ * Diagnostics go to stderr here, for callers with no envelope to carry them;
+ * the ones that have an envelope call the variant below.
  */
 export function readProjectConfig(projectRoot) {
+    const { config, diagnostics } = readProjectConfigWithDiagnostics(projectRoot);
+    for (const diagnostic of diagnostics) {
+        console.warn(diagnostic.message);
+    }
+    return config;
+}
+/**
+ * Stderr copy of the config diagnostics, for commands that never read the
+ * config themselves. `list` and `status` resolve each change's schema from its
+ * own `.tospec.yaml` and consult the project config only when that field is
+ * absent, so a config that no longer parses went unmentioned by exactly the
+ * commands a user runs to look around. Stderr in both modes: a `--json` stdout
+ * stays one document, and a warning is not a failed command.
+ */
+export function printProjectConfigDiagnostics(projectRoot) {
+    for (const diagnostic of readProjectConfigWithDiagnostics(projectRoot).diagnostics) {
+        console.error(diagnostic.message.startsWith('Warning:') ? diagnostic.message : `Warning: ${diagnostic.message}`);
+    }
+}
+/** The same read, with the dropped fields handed back instead of printed. */
+export function readProjectConfigWithDiagnostics(projectRoot) {
     const configPath = resolveConfigFilePath(projectRoot);
     if (configPath === null) {
-        return null; // No config is OK
+        return { config: null, diagnostics: [] }; // No config is OK
     }
+    const diagnostics = [];
+    const where = configPath;
     try {
         const content = readFileSync(configPath, 'utf-8');
         const raw = parseYaml(content);
         if (!raw || typeof raw !== 'object') {
-            console.warn(`tospec/config.yaml is not a valid YAML object`);
-            return null;
+            return {
+                config: null,
+                diagnostics: [
+                    {
+                        code: 'config_not_a_mapping',
+                        message: `${where} is not a YAML mapping; ignoring it.`,
+                    },
+                ],
+            };
         }
         const config = {};
-        // Parse schema field using Zod
         const schemaField = z.string().min(1);
         const schemaResult = schemaField.safeParse(raw.schema);
         if (schemaResult.success) {
             config.schema = schemaResult.data;
         }
         else if (raw.schema !== undefined) {
-            console.warn(`Invalid 'schema' field in config (must be non-empty string)`);
+            diagnostics.push({
+                code: 'config_field_invalid',
+                message: `Invalid 'schema' field in ${where} (must be a non-empty string); ignoring it.`,
+            });
         }
-        // Parse context field with size limit
         if (raw.context !== undefined) {
             const contextField = z.string();
             const contextResult = contextField.safeParse(raw.context);
             if (contextResult.success) {
                 const contextSize = Buffer.byteLength(contextResult.data, 'utf-8');
                 if (contextSize > MAX_CONTEXT_SIZE) {
-                    console.warn(`Context too large (${(contextSize / 1024).toFixed(1)}KB, limit: ${MAX_CONTEXT_SIZE / 1024}KB)`);
-                    console.warn(`Ignoring context field`);
+                    diagnostics.push({
+                        code: 'config_context_too_large',
+                        message: `Context too large (${(contextSize / 1024).toFixed(1)}KB, limit: ${MAX_CONTEXT_SIZE / 1024}KB); ignoring the context field in ${where}.`,
+                    });
                 }
                 else {
                     config.context = contextResult.data;
                 }
             }
             else {
-                console.warn(`Invalid 'context' field in config (must be string)`);
+                diagnostics.push({
+                    code: 'config_field_invalid',
+                    message: `Invalid 'context' field in ${where} (must be a string); ignoring it.`,
+                });
             }
         }
-        // Parse rules field using Zod
         if (raw.rules !== undefined) {
-            // First check if it's an object structure (guard against null since typeof null === 'object')
+            // The null guard matters: typeof null === 'object'.
             if (typeof raw.rules === 'object' && raw.rules !== null && !Array.isArray(raw.rules)) {
                 const parsedRules = {};
                 let hasValidRules = false;
                 for (const [artifactId, rules] of Object.entries(raw.rules)) {
                     const rulesArrayResult = z.array(z.string()).safeParse(rules);
                     if (rulesArrayResult.success) {
-                        // Filter out empty strings
                         const validRules = rulesArrayResult.data.filter((r) => r.length > 0);
                         if (validRules.length > 0) {
                             parsedRules[artifactId] = validRules;
                             hasValidRules = true;
                         }
                         if (validRules.length < rulesArrayResult.data.length) {
-                            console.warn(`Some rules for '${artifactId}' are empty strings, ignoring them`);
+                            diagnostics.push({
+                                code: 'config_rules_empty_entries',
+                                message: `Some rules for '${artifactId}' in ${where} are empty strings, ignoring them`,
+                            });
                         }
                     }
                     else {
-                        console.warn(`Rules for '${artifactId}' must be an array of strings, ignoring this artifact's rules`);
+                        diagnostics.push({
+                            code: 'config_field_invalid',
+                            message: `Rules for '${artifactId}' in ${where} must be an array of strings, ignoring this artifact's rules`,
+                        });
                     }
                 }
                 if (hasValidRules) {
@@ -134,10 +146,12 @@ export function readProjectConfig(projectRoot) {
                 }
             }
             else {
-                console.warn(`Invalid 'rules' field in config (must be object)`);
+                diagnostics.push({
+                    code: 'config_field_invalid',
+                    message: `Invalid 'rules' field in ${where} (must be a mapping); ignoring it.`,
+                });
             }
         }
-        // Parse dashboard field using Zod
         if (raw.dashboard !== undefined) {
             const dashboardField = z.object({ staleDays: z.number().int().positive().optional() });
             const dashboardResult = dashboardField.safeParse(raw.dashboard);
@@ -145,40 +159,51 @@ export function readProjectConfig(projectRoot) {
                 config.dashboard = dashboardResult.data;
             }
             else {
-                console.warn(`Invalid 'dashboard' field in config (staleDays must be a positive integer)`);
+                diagnostics.push({
+                    code: 'config_field_invalid',
+                    message: `Invalid 'dashboard' field in ${where} (staleDays must be a positive integer); ignoring it.`,
+                });
             }
         }
-        // Return partial config even if some fields failed
-        return Object.keys(config).length > 0 ? config : null;
+        // A partial config, even when some fields failed.
+        return {
+            config: Object.keys(config).length > 0 ? config : null,
+            diagnostics,
+        };
     }
     catch (error) {
-        console.warn(`Warning: could not parse ${configPathForWarnings(projectRoot)} (${error instanceof Error ? error.message.split('\n')[0] : String(error)}); ignoring it.`);
-        return null;
+        return {
+            config: null,
+            diagnostics: [
+                {
+                    code: 'config_unparseable',
+                    // First line only, minus the colon that introduces the yaml
+                    // library's code frame on the lines that follow.
+                    message: `Warning: could not parse ${where} (${error instanceof Error ? error.message.split('\n')[0].replace(/:\s*$/, '') : String(error)}); ignoring it.`,
+                },
+            ],
+        };
     }
 }
-function configPathForWarnings(projectRoot) {
-    return resolveConfigFilePath(projectRoot) ?? path.join(projectRoot, 'tospec', 'config.yaml');
-}
 /**
- * Validate artifact IDs in rules against the artifacts of every available
- * schema, not just the one the current change happens to use.
- *
- * `rules:` is a single global map, but a change is always loaded under exactly
- * one schema. Checking the global map against one schema's artifacts made any
- * project that configures rules for two schemas (say `proposal` for sdd and
- * `task` for issue) emit a false warning on every command run under the other —
- * a warning that named a real, correctly-spelled artifact as unknown.
+ * The one `rules:` key that is not an artifact: every other names a document to
+ * write, this one the phase that writes code. Without it a project can say how
+ * to write tasks.md but not how to implement it.
+ */
+export const APPLY_RULES_KEY = 'apply';
+/**
+ * Checks rule keys against the artifacts of *every* available schema. `rules:`
+ * is one global map but a change loads under one schema, so checking against
+ * that schema alone warns about real, correctly-spelled artifacts.
  *
- * @param rules - The rules object from config
- * @param validArtifactIds - Union of artifact IDs across all available schemas
- *   (see collectAllArtifactIds)
- * @returns Array of warning messages for artifact IDs that match no schema
+ * @param validArtifactIds Union across all schemas; see collectAllArtifactIds.
  */
 export function validateConfigRules(rules, validArtifactIds) {
     const warnings = [];
+    const validKeys = new Set([...validArtifactIds, APPLY_RULES_KEY]);
     for (const artifactId of Object.keys(rules)) {
-        if (!validArtifactIds.has(artifactId)) {
-            const validIds = Array.from(validArtifactIds).sort().join(', ');
+        if (!validKeys.has(artifactId)) {
+            const validIds = Array.from(validKeys).sort().join(', ');
             warnings.push(`Unknown artifact ID in rules: "${artifactId}". ` +
                 `Valid IDs across all available schemas: ${validIds}`);
         }
@@ -186,9 +211,9 @@ export function validateConfigRules(rules, validArtifactIds) {
     return warnings;
 }
 /**
- * Shared .yaml/.yml probe over an existing `tospec/` directory. The one place
- * that decides which config file a root has — init used to answer this
- * separately and could report "created" next to a config the reader was using.
+ * Shared .yaml/.yml probe over an existing `tospec/` directory: the one place
+ * that decides which config file a root has, so init cannot report "created"
+ * next to a config the reader is already using.
  */
 export function resolveConfigFileInDir(tospecDir) {
     const yamlPath = path.join(tospecDir, 'config.yaml');

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

@@ -1 +1 @@
-{"version":3,"file":"project-config.js","sourceRoot":"","sources":["../../src/core/project-config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"project-config.js","sourceRoot":"","sources":["../../src/core/project-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAC1C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,kFAAkF;AAClF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,0CAA0C,CAAC;IAEvD,6CAA6C;IAC7C,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,yDAAyD,CAAC;IAEtE,8CAA8C;IAC9C,KAAK,EAAE,CAAC;SACL,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;SACvC,QAAQ,EAAE;SACV,QAAQ,CAAC,0CAA0C,CAAC;IAEvD,4EAA4E;IAC5E,8BAA8B;IAC9B,SAAS,EAAE,CAAC;SACT,MAAM,CAAC;QACN,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;KAClD,CAAC;SACD,QAAQ,EAAE;SACV,QAAQ,CAAC,gEAAgE,CAAC;IAE7E,8EAA8E;IAC9E,2CAA2C;CAC5C,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,qCAAqC;AAiBhF;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,WAAmB;IACnD,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,gCAAgC,CAAC,WAAW,CAAC,CAAC;IAC9E,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,6BAA6B,CAAC,WAAmB;IAC/D,KAAK,MAAM,UAAU,IAAI,gCAAgC,CAAC,WAAW,CAAC,CAAC,WAAW,EAAE,CAAC;QACnF,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC;IACnH,CAAC;AACH,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,gCAAgC,CAAC,WAAmB;IAClE,MAAM,UAAU,GAAG,qBAAqB,CAAC,WAAW,CAAC,CAAC;IACtD,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;QACxB,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC,kBAAkB;IAC9D,CAAC;IAED,MAAM,WAAW,GAA8B,EAAE,CAAC;IAClD,MAAM,KAAK,GAAG,UAAU,CAAC;IAEzB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAClD,MAAM,GAAG,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;QAE/B,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YACpC,OAAO;gBACL,MAAM,EAAE,IAAI;gBACZ,WAAW,EAAE;oBACX;wBACE,IAAI,EAAE,sBAAsB;wBAC5B,OAAO,EAAE,GAAG,KAAK,sCAAsC;qBACxD;iBACF;aACF,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAA2B,EAAE,CAAC;QAE1C,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACtC,MAAM,YAAY,GAAG,WAAW,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACvD,IAAI,YAAY,CAAC,OAAO,EAAE,CAAC;YACzB,MAAM,CAAC,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC;QACpC,CAAC;aAAM,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACpC,WAAW,CAAC,IAAI,CAAC;gBACf,IAAI,EAAE,sBAAsB;gBAC5B,OAAO,EAAE,6BAA6B,KAAK,6CAA6C;aACzF,CAAC,CAAC;QACL,CAAC;QAED,IAAI,GAAG,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAC9B,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC;YAChC,MAAM,aAAa,GAAG,YAAY,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAE1D,IAAI,aAAa,CAAC,OAAO,EAAE,CAAC;gBAC1B,MAAM,WAAW,GAAG,MAAM,CAAC,UAAU,CAAC,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;gBACnE,IAAI,WAAW,GAAG,gBAAgB,EAAE,CAAC;oBACnC,WAAW,CAAC,IAAI,CAAC;wBACf,IAAI,EAAE,0BAA0B;wBAChC,OAAO,EAAE,sBAAsB,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,gBAAgB,GAAG,IAAI,sCAAsC,KAAK,GAAG;qBAClJ,CAAC,CAAC;gBACL,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,OAAO,GAAG,aAAa,CAAC,IAAI,CAAC;gBACtC,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,WAAW,CAAC,IAAI,CAAC;oBACf,IAAI,EAAE,sBAAsB;oBAC5B,OAAO,EAAE,8BAA8B,KAAK,mCAAmC;iBAChF,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC5B,oDAAoD;YACpD,IAAI,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ,IAAI,GAAG,CAAC,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;gBACrF,MAAM,WAAW,GAA6B,EAAE,CAAC;gBACjD,IAAI,aAAa,GAAG,KAAK,CAAC;gBAE1B,KAAK,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;oBAC5D,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;oBAE9D,IAAI,gBAAgB,CAAC,OAAO,EAAE,CAAC;wBAC7B,MAAM,UAAU,GAAG,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;wBACrE,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;4BAC1B,WAAW,CAAC,UAAU,CAAC,GAAG,UAAU,CAAC;4BACrC,aAAa,GAAG,IAAI,CAAC;wBACvB,CAAC;wBACD,IAAI,UAAU,CAAC,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;4BACrD,WAAW,CAAC,IAAI,CAAC;gCACf,IAAI,EAAE,4BAA4B;gCAClC,OAAO,EAAE,mBAAmB,UAAU,QAAQ,KAAK,mCAAmC;6BACvF,CAAC,CAAC;wBACL,CAAC;oBACH,CAAC;yBAAM,CAAC;wBACN,WAAW,CAAC,IAAI,CAAC;4BACf,IAAI,EAAE,sBAAsB;4BAC5B,OAAO,EAAE,cAAc,UAAU,QAAQ,KAAK,8DAA8D;yBAC7G,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;gBAED,IAAI,aAAa,EAAE,CAAC;oBAClB,MAAM,CAAC,KAAK,GAAG,WAAW,CAAC;gBAC7B,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,WAAW,CAAC,IAAI,CAAC;oBACf,IAAI,EAAE,sBAAsB;oBAC5B,OAAO,EAAE,4BAA4B,KAAK,oCAAoC;iBAC/E,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,IAAI,GAAG,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YAChC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YACvF,MAAM,eAAe,GAAG,cAAc,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAChE,IAAI,eAAe,CAAC,OAAO,EAAE,CAAC;gBAC5B,MAAM,CAAC,SAAS,GAAG,eAAe,CAAC,IAAI,CAAC;YAC1C,CAAC;iBAAM,CAAC;gBACN,WAAW,CAAC,IAAI,CAAC;oBACf,IAAI,EAAE,sBAAsB;oBAC5B,OAAO,EAAE,gCAAgC,KAAK,uDAAuD;iBACtG,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,kDAAkD;QAClD,OAAO;YACL,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAE,MAAwB,CAAC,CAAC,CAAC,IAAI;YACzE,WAAW;SACZ,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,MAAM,EAAE,IAAI;YACZ,WAAW,EAAE;gBACX;oBACE,IAAI,EAAE,oBAAoB;oBAC1B,4DAA4D;oBAC5D,iDAAiD;oBACjD,OAAO,EAAE,4BAA4B,KAAK,KACxC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAC3F,iBAAiB;iBAClB;aACF;SACF,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,OAAO,CAAC;AAEvC;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAA+B,EAC/B,gBAA6B;IAE7B,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,gBAAgB,EAAE,eAAe,CAAC,CAAC,CAAC;IAElE,KAAK,MAAM,UAAU,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YAC/B,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACzD,QAAQ,CAAC,IAAI,CACX,kCAAkC,UAAU,KAAK;gBAC/C,2CAA2C,QAAQ,EAAE,CACxD,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,SAAiB;IACtD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;IACrD,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzB,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IACnD,OAAO,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;AAC9C,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,qBAAqB,CAAC,WAAmB;IACvD,OAAO,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC;AAClE,CAAC"}

package/dist/core/project-layout.d.ts

@@ -1,29 +1,21 @@
 /**
  * The directory layout `tospec init` creates, and the anchors that make it
- * survive version control.
- *
- * Git does not track an empty directory, so a layout committed straight after
- * init is not the layout a collaborator clones: the directories are gone, and
- * the first command that looks for one reports the project as uninitialized.
- * Nothing is lost — every writer creates the directory it needs on demand — but
- * a diagnostic that sends the reader to re-run a command that will change
- * nothing is worse than a crash.
+ * survive version control. Git does not track an empty directory, so without
+ * them a collaborator clones a layout whose directories are gone and the first
+ * command reports the project as uninitialized — nothing is lost, but the
+ * diagnostic sends the reader to re-run a command that changes nothing.
  */
 /**
- * Relative to `tospec/`, in creation order.
- *
- * Not named for anchoring: whether a directory gets an anchor is computed from
- * whether it ends up empty, and `changes/` never does because it holds
- * `archive/`. A name asserting the property would be wrong for the next
- * directory that ships with content.
+ * Relative to `tospec/`, in creation order. Not named for anchoring: whether a
+ * directory gets an anchor is computed from whether it ends up empty, and
+ * `changes/` never does because it holds `archive/`.
  */
-export declare const TOSPEC_LAYOUT_DIRS: readonly ["specs", "changes", "changes/archive", "decisions"];
+export declare const TOSPEC_LAYOUT_DIRS: readonly ['specs', 'changes', 'changes/archive', 'decisions'];
 /** The layout as absolute paths, so callers never re-derive the join. */
 export declare function tospecLayoutDirs(tospecPath: string): string[];
 /**
- * Anchor `directory` if it is empty. A directory that already holds content
- * needs no anchor — the anchor exists to make an empty directory representable,
- * and adding one beside real content leaves a file nobody asked for.
+ * Anchor `directory` if it is empty. An anchor exists to make an empty directory
+ * representable, so adding one beside real content leaves a file nobody wanted.
  */
 export declare function ensureDirectoryAnchor(directory: string): Promise<void>;
 //# sourceMappingURL=project-layout.d.ts.map

package/dist/core/project-layout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project-layout.d.ts","sourceRoot":"","sources":["../../src/core/project-layout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,+DAOrB,CAAC;AAIX,yEAAyE;AACzE,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAE7D;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAmB5E"}
+{"version":3,"file":"project-layout.d.ts","sourceRoot":"","sources":["../../src/core/project-layout.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,YAC7B,OAAO,EACP,SAAS,EACT,iBAAiB,EAGjB,WAAW,CACH,CAAC;AAIX,yEAAyE;AACzE,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAE7D;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiB5E"}

package/dist/core/project-layout.js

@@ -1,30 +1,23 @@
 /**
  * The directory layout `tospec init` creates, and the anchors that make it
- * survive version control.
- *
- * Git does not track an empty directory, so a layout committed straight after
- * init is not the layout a collaborator clones: the directories are gone, and
- * the first command that looks for one reports the project as uninitialized.
- * Nothing is lost — every writer creates the directory it needs on demand — but
- * a diagnostic that sends the reader to re-run a command that will change
- * nothing is worse than a crash.
+ * survive version control. Git does not track an empty directory, so without
+ * them a collaborator clones a layout whose directories are gone and the first
+ * command reports the project as uninitialized — nothing is lost, but the
+ * diagnostic sends the reader to re-run a command that changes nothing.
  */
 import path from 'path';
 import { promises as fs } from 'fs';
 /**
- * Relative to `tospec/`, in creation order.
- *
- * Not named for anchoring: whether a directory gets an anchor is computed from
- * whether it ends up empty, and `changes/` never does because it holds
- * `archive/`. A name asserting the property would be wrong for the next
- * directory that ships with content.
+ * Relative to `tospec/`, in creation order. Not named for anchoring: whether a
+ * directory gets an anchor is computed from whether it ends up empty, and
+ * `changes/` never does because it holds `archive/`.
  */
 export const TOSPEC_LAYOUT_DIRS = [
     'specs',
     'changes',
     'changes/archive',
-    // Permanent decision records (`tospec decision new`); scaffolded here so the
-    // layout is visible from the start instead of appearing on first use.
+    // Permanent decision records (`tospec decision new`), scaffolded here so the
+    // layout is visible from the start rather than appearing on first use.
     'decisions',
 ];
 const DIRECTORY_ANCHOR_FILE_NAME = '.gitkeep';
@@ -33,27 +26,24 @@ export function tospecLayoutDirs(tospecPath) {
     return TOSPEC_LAYOUT_DIRS.map((relative) => path.join(tospecPath, relative));
 }
 /**
- * Anchor `directory` if it is empty. A directory that already holds content
- * needs no anchor — the anchor exists to make an empty directory representable,
- * and adding one beside real content leaves a file nobody asked for.
+ * Anchor `directory` if it is empty. An anchor exists to make an empty directory
+ * representable, so adding one beside real content leaves a file nobody wanted.
  */
 export async function ensureDirectoryAnchor(directory) {
     if ((await fs.readdir(directory)).length > 0)
         return;
     try {
-        // Exclusive create. The emptiness check above already covers every entry
-        // visible when it ran; this closes the window after it, where a file or a
-        // link can appear at the anchor's path. An ordinary write would overwrite
-        // content the anchor never owned, or write *through* a link into a path
-        // outside the project entirely.
+        // Exclusive create, closing the window after the emptiness check where a
+        // file or link can appear at the anchor's path: an ordinary write would
+        // overwrite content the anchor never owned, or write *through* a link.
         await fs.writeFile(path.join(directory, DIRECTORY_ANCHOR_FILE_NAME), '', {
             encoding: 'utf-8',
             flag: 'wx',
         });
     }
     catch (error) {
-        // Something is already there, so the directory is not empty and needs no
-        // anchor. That is the anchor's job being done, not a failure.
+        // Something is already there, so the directory needs no anchor: done, not
+        // a failure.
         if (error?.code === 'EEXIST')
             return;
         throw error;

package/dist/core/project-layout.js.map

@@ -1 +1 @@
-{"version":3,"file":"project-layout.js","sourceRoot":"","sources":["../../src/core/project-layout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,IAAI,CAAC;AAEpC;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,OAAO;IACP,SAAS;IACT,iBAAiB;IACjB,6EAA6E;IAC7E,sEAAsE;IACtE,WAAW;CACH,CAAC;AAEX,MAAM,0BAA0B,GAAG,UAAU,CAAC;AAE9C,yEAAyE;AACzE,MAAM,UAAU,gBAAgB,CAAC,UAAkB;IACjD,OAAO,kBAAkB,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,SAAiB;IAC3D,IAAI,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO;IAErD,IAAI,CAAC;QACH,yEAAyE;QACzE,0EAA0E;QAC1E,0EAA0E;QAC1E,wEAAwE;QACxE,gCAAgC;QAChC,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,0BAA0B,CAAC,EAAE,EAAE,EAAE;YACvE,QAAQ,EAAE,OAAO;YACjB,IAAI,EAAE,IAAI;SACX,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,yEAAyE;QACzE,8DAA8D;QAC9D,IAAK,KAA+B,EAAE,IAAI,KAAK,QAAQ;YAAE,OAAO;QAChE,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}
+{"version":3,"file":"project-layout.js","sourceRoot":"","sources":["../../src/core/project-layout.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,IAAI,CAAC;AAEpC;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,OAAO;IACP,SAAS;IACT,iBAAiB;IACjB,6EAA6E;IAC7E,uEAAuE;IACvE,WAAW;CACH,CAAC;AAEX,MAAM,0BAA0B,GAAG,UAAU,CAAC;AAE9C,yEAAyE;AACzE,MAAM,UAAU,gBAAgB,CAAC,UAAkB;IACjD,OAAO,kBAAkB,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,SAAiB;IAC3D,IAAI,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO;IAErD,IAAI,CAAC;QACH,yEAAyE;QACzE,wEAAwE;QACxE,uEAAuE;QACvE,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,0BAA0B,CAAC,EAAE,EAAE,EAAE;YACvE,QAAQ,EAAE,OAAO;YACjB,IAAI,EAAE,IAAI;SACX,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,0EAA0E;QAC1E,aAAa;QACb,IAAK,KAA+B,EAAE,IAAI,KAAK,QAAQ;YAAE,OAAO;QAChE,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/core/root-selection.d.ts

@@ -1,13 +1,17 @@
 /**
- * tospec root resolution — minimal single-team version.
- *
- * tospec drops the store subsystem, so resolution collapses to the plan's
- * rule: walk up from the start path to the nearest ancestor that contains a
- * `tospec/` directory; if none is found, treat the current directory as an
- * implicit root (unless the caller forbids it).
+ * Root resolution: walk up from the start path to the nearest ancestor holding
+ * a `tospec/` directory, else treat the current directory as an implicit root
+ * unless the caller forbids it.
  */
 import { type PlanningHome } from './planning-home.js';
-export type TospecRootSource = 'nearest' | 'implicit';
+/**
+ * How a command arrived at the root it reports. `nearest` and `implicit` are the
+ * two outcomes of *searching*; `explicit` is the install layer (`init`,
+ * `update`, `rules`, `migrate`), which operates on the path it was handed.
+ * Naming that case keeps the key present: `JSON.stringify` drops an omitted
+ * one, leaving a caller unable to tell it from a renamed field.
+ */
+export type TospecRootSource = 'nearest' | 'implicit' | 'explicit';
 export interface ResolveTospecRootOptions {
     startPath?: string;
     allowImplicitRoot?: boolean;

package/dist/core/root-selection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"root-selection.d.ts","sourceRoot":"","sources":["../../src/core/root-selection.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAGL,KAAK,YAAY,EAClB,MAAM,oBAAoB,CAAC;AAG5B,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,UAAU,CAAC;AAEtD,MAAM,WAAW,wBAAwB;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,KAAK,CAAC;IACrB,MAAM,EAAE,gBAAgB,CAAC;CAC1B;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,UAAU,EAAE,uBAAuB,CAAC;gBAG3C,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAO;CAWlD;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB,CAEhF;AAaD,wBAAsB,iBAAiB,CACrC,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,kBAAkB,CAAC,CAgB7B;AAMD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,gBAAgB,CAAC;CAC1B;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,kBAAkB,GAAG,UAAU,CAKjE;AAED,0EAA0E;AAC1E,wBAAgB,cAAc,CAAC,IAAI,EAAE,kBAAkB,GAAG,YAAY,CAOrE;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,SAAS,EAAE,OAAO,EAClB,MAAM,GAAE;IACN,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,iBAAiB,CAAC,EAAE,OAAO,CAAC;CACxB,GACL,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAcpC"}
+{"version":3,"file":"root-selection.d.ts","sourceRoot":"","sources":["../../src/core/root-selection.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAGL,KAAK,YAAY,EAClB,MAAM,oBAAoB,CAAC;AAG5B;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;AAEnE,MAAM,WAAW,wBAAwB;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,KAAK,CAAC;IACrB,MAAM,EAAE,gBAAgB,CAAC;CAC1B;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,UAAU,EAAE,uBAAuB,CAAC;IAE7C,YACE,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAO,EAUhD;CACF;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB,CAEhF;AAaD,wBAAsB,iBAAiB,CACrC,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,kBAAkB,CAAC,CAgB7B;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,gBAAgB,CAAC;CAC1B;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,kBAAkB,GAAG,UAAU,CAKjE;AAED,0EAA0E;AAC1E,wBAAgB,cAAc,CAAC,IAAI,EAAE,kBAAkB,GAAG,YAAY,CAOrE;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,SAAS,EAAE,OAAO,EAClB,MAAM,GAAE;IACN,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,iBAAiB,CAAC,EAAE,OAAO,CAAC;CACxB,GACL,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAgBpC"}

package/dist/core/root-selection.js

@@ -1,14 +1,11 @@
 /**
- * tospec root resolution — minimal single-team version.
- *
- * tospec drops the store subsystem, so resolution collapses to the plan's
- * rule: walk up from the start path to the nearest ancestor that contains a
- * `tospec/` directory; if none is found, treat the current directory as an
- * implicit root (unless the caller forbids it).
+ * Root resolution: walk up from the start path to the nearest ancestor holding
+ * a `tospec/` directory, else treat the current directory as an implicit root
+ * unless the caller forbids it.
  */
 import * as path from 'node:path';
 import { findRepoPlanningRootSync, getSearchStartDirectory, } from './planning-home.js';
-import { emitFailureStatus } from '../commands/shared-output.js';
+import { emitFailureStatus, recordResolvedRoot } from '../commands/shared-output.js';
 export class RootSelectionError extends Error {
     diagnostic;
     constructor(message, code, options = {}) {
@@ -68,11 +65,13 @@ export function toPlanningHome(root) {
  */
 export async function resolveRootForCommand(_selector, output = {}) {
     try {
-        return await resolveTospecRoot({
+        const root = await resolveTospecRoot({
             ...(output.allowImplicitRoot !== undefined
                 ? { allowImplicitRoot: output.allowImplicitRoot }
                 : {}),
         });
+        recordResolvedRoot(toRootOutput(root));
+        return root;
     }
     catch (error) {
         if (output.json && isRootSelectionError(error)) {

package/dist/core/root-selection.js.map

@@ -1 +1 @@
-{"version":3,"file":"root-selection.js","sourceRoot":"","sources":["../../src/core/root-selection.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EACL,wBAAwB,EACxB,uBAAuB,GAExB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AA2BjE,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAClC,UAAU,CAA0B;IAE7C,YACE,OAAe,EACf,IAAY,EACZ,UAA6C,EAAE;QAE/C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,UAAU,GAAG;YAChB,QAAQ,EAAE,OAAO;YACjB,IAAI;YACJ,OAAO;YACP,GAAG,OAAO;SACX,CAAC;IACJ,CAAC;CACF;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,OAAO,KAAK,YAAY,kBAAkB,CAAC;AAC7C,CAAC;AAED,SAAS,QAAQ,CAAC,QAAgB,EAAE,MAAwB;IAC1D,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC;QACpD,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC;QAChD,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC;QAC/D,aAAa,EAAE,KAAK;QACpB,MAAM;KACP,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,UAAoC,EAAE;IAEtC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACrD,MAAM,WAAW,GAAG,wBAAwB,CAAC,SAAS,CAAC,CAAC;IACxD,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO,QAAQ,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IAC1C,CAAC;IAED,IAAI,OAAO,CAAC,iBAAiB,KAAK,KAAK,EAAE,CAAC;QACxC,MAAM,IAAI,kBAAkB,CAC1B,kDAAkD,EAClD,gBAAgB,EAChB,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,wCAAwC,EAAE,CACzE,CAAC;IACJ,CAAC;IAED,OAAO,QAAQ,CAAC,uBAAuB,CAAC,SAAS,CAAC,EAAE,UAAU,CAAC,CAAC;AAClE,CAAC;AAWD,MAAM,UAAU,YAAY,CAAC,IAAwB;IACnD,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,MAAM,EAAE,IAAI,CAAC,MAAM;KACpB,CAAC;AACJ,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,cAAc,CAAC,IAAwB;IACrD,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,aAAa,EAAE,IAAI,CAAC,aAAa;KAClC,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,SAAkB,EAClB,SAII,EAAE;IAEN,IAAI,CAAC;QACH,OAAO,MAAM,iBAAiB,CAAC;YAC7B,GAAG,CAAC,MAAM,CAAC,iBAAiB,KAAK,SAAS;gBACxC,CAAC,CAAC,EAAE,iBAAiB,EAAE,MAAM,CAAC,iBAAiB,EAAE;gBACjD,CAAC,CAAC,EAAE,CAAC;SACR,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,MAAM,CAAC,IAAI,IAAI,oBAAoB,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/C,iBAAiB,CAAC,MAAM,CAAC,cAAc,IAAI,EAAE,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;YACjE,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}
+{"version":3,"file":"root-selection.js","sourceRoot":"","sources":["../../src/core/root-selection.ts"],"names":[],"mappings":"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"}

package/dist/core/rules.d.ts

@@ -0,0 +1,10 @@
+export interface RulesCommandOptions {
+    json?: boolean;
+}
+/** The `--json` null-shape; mirrors the success payload with `rules` nulled. */
+export declare const RULES_FAILURE_PAYLOAD: Record<string, unknown>;
+/** Refresh only the workflow rule files of agents already configured for tospec. */
+export declare class RulesCommand {
+    execute(targetPath: string, options?: RulesCommandOptions): Promise<void>;
+}
+//# sourceMappingURL=rules.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../src/core/rules.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,gFAAgF;AAChF,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAA+B,CAAC;AAE1F,oFAAoF;AACpF,qBAAa,YAAY;IACjB,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkClF;CACF"}

package/dist/core/rules.js

@@ -0,0 +1,43 @@
+import path from 'node:path';
+import { FileSystemUtils } from '../utils/file-system.js';
+import { TOSPEC_DIR_NAME } from './config.js';
+import { getConfiguredTools } from './shared/tool-detection.js';
+import { planWorkflowRules, writeWorkflowRules } from './shared/rules-generation.js';
+import { emitSuccess } from '../commands/shared-output.js';
+/** The `--json` null-shape; mirrors the success payload with `rules` nulled. */
+export const RULES_FAILURE_PAYLOAD = { rules: null, root: null };
+/** Refresh only the workflow rule files of agents already configured for tospec. */
+export class RulesCommand {
+    async execute(targetPath, options = {}) {
+        const projectPath = path.resolve(targetPath);
+        if (!await FileSystemUtils.directoryExists(path.join(projectPath, TOSPEC_DIR_NAME))) {
+            throw new Error("No Tospec directory found. Run 'tospec init' first.");
+        }
+        const tools = getConfiguredTools(projectPath);
+        if (tools.length === 0) {
+            // Not an error: a project can legitimately have no agent configured. The
+            // JSON form says so with an empty list, so a caller need not read English
+            // to tell "nothing to do" from "something went wrong".
+            if (options.json) {
+                emitSuccess({ rules: [], message: 'No configured tools found.' }, { path: projectPath, source: 'explicit' });
+                return;
+            }
+            console.log('No configured tools found. Run "tospec init" to set up tools.');
+            return;
+        }
+        const plan = await planWorkflowRules(projectPath, tools);
+        await writeWorkflowRules(plan, { silent: options.json });
+        if (options.json) {
+            emitSuccess({
+                rules: plan.map((entry) => ({
+                    tool: entry.toolId,
+                    rule: entry.rule,
+                    path: entry.destination,
+                    action: entry.action,
+                    ...(entry.retire ? { retiredPath: entry.retire } : {}),
+                })),
+            }, { path: projectPath, source: 'explicit' });
+        }
+    }
+}
+//# sourceMappingURL=rules.js.map

package/dist/core/rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.js","sourceRoot":"","sources":["../../src/core/rules.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AACrF,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAM3D,gFAAgF;AAChF,MAAM,CAAC,MAAM,qBAAqB,GAA4B,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AAE1F,oFAAoF;AACpF,MAAM,OAAO,YAAY;IACvB,KAAK,CAAC,OAAO,CAAC,UAAkB,EAAE,OAAO,GAAwB,EAAE;QACjE,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAC7C,IAAI,CAAC,MAAM,eAAe,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC;YACpF,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACzE,CAAC;QACD,MAAM,KAAK,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAC;QAC9C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,yEAAyE;YACzE,0EAA0E;YAC1E,uDAAuD;YACvD,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;gBACjB,WAAW,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,4BAA4B,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;gBAC7G,OAAO;YACT,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,+DAA+D,CAAC,CAAC;YAC7E,OAAO;QACT,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,iBAAiB,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;QACzD,MAAM,kBAAkB,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QAEzD,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,WAAW,CACT;gBACE,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;oBAC1B,IAAI,EAAE,KAAK,CAAC,MAAM;oBAClB,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,IAAI,EAAE,KAAK,CAAC,WAAW;oBACvB,MAAM,EAAE,KAAK,CAAC,MAAM;oBACpB,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACvD,CAAC,CAAC;aACJ,EACD,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,CAC1C,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}