@seanmars/tospec 0.19.0-beta.7 → 0.20.0

package/dist/core/profiles.d.ts

@@ -1,16 +1,9 @@
-/**
- * Profile System
- *
- * Defines workflow profiles that control which workflows are installed.
- * Profiles determine WHICH workflows are installed.
- */
+/** Workflow profiles: which workflows an install writes. */
 import type { Profile } from './global-config.js';
 export { ALL_WORKFLOWS, type WorkflowId } from './shared/skill-generation.js';
 /**
- * Resolves which workflows should be active for a given profile configuration.
- *
- * - 'core' profile always returns ALL_WORKFLOWS (the only profile's worth of workflows)
- * - 'custom' profile returns the provided customWorkflows, or empty array if not provided
+ * The workflows a profile resolves to: `core` is always ALL_WORKFLOWS, `custom`
+ * is `customWorkflows`, or empty when none was given.
  */
 export declare function getProfileWorkflows(profile: Profile, customWorkflows?: string[]): readonly string[];
 //# sourceMappingURL=profiles.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"profiles.d.ts","sourceRoot":"","sources":["../../src/core/profiles.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAIlD,OAAO,EAAE,aAAa,EAAE,KAAK,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAG9E;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,OAAO,EAChB,eAAe,CAAC,EAAE,MAAM,EAAE,GACzB,SAAS,MAAM,EAAE,CAKnB"}
+{"version":3,"file":"profiles.d.ts","sourceRoot":"","sources":["../../src/core/profiles.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAE5D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAIlD,OAAO,EAAE,aAAa,EAAE,KAAK,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAG9E;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,OAAO,EAChB,eAAe,CAAC,EAAE,MAAM,EAAE,GACzB,SAAS,MAAM,EAAE,CAKnB"}

package/dist/core/profiles.js

@@ -1,18 +1,11 @@
-/**
- * Profile System
- *
- * Defines workflow profiles that control which workflows are installed.
- * Profiles determine WHICH workflows are installed.
- */
-// The workflow id list lives in the single workflow registry
-// (shared/skill-generation.ts) — re-exported here for existing importers.
+/** Workflow profiles: which workflows an install writes. */
+// The workflow id list lives in the one registry (shared/skill-generation.ts);
+// re-exported here for existing importers.
 export { ALL_WORKFLOWS } from './shared/skill-generation.js';
 import { ALL_WORKFLOWS } from './shared/skill-generation.js';
 /**
- * Resolves which workflows should be active for a given profile configuration.
- *
- * - 'core' profile always returns ALL_WORKFLOWS (the only profile's worth of workflows)
- * - 'custom' profile returns the provided customWorkflows, or empty array if not provided
+ * The workflows a profile resolves to: `core` is always ALL_WORKFLOWS, `custom`
+ * is `customWorkflows`, or empty when none was given.
  */
 export function getProfileWorkflows(profile, customWorkflows) {
     if (profile === 'custom') {

package/dist/core/profiles.js.map

@@ -1 +1 @@
-{"version":3,"file":"profiles.js","sourceRoot":"","sources":["../../src/core/profiles.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,6DAA6D;AAC7D,0EAA0E;AAC1E,OAAO,EAAE,aAAa,EAAmB,MAAM,8BAA8B,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAE7D;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAgB,EAChB,eAA0B;IAE1B,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;QACzB,OAAO,eAAe,IAAI,EAAE,CAAC;IAC/B,CAAC;IACD,OAAO,aAAa,CAAC;AACvB,CAAC"}
+{"version":3,"file":"profiles.js","sourceRoot":"","sources":["../../src/core/profiles.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAI5D,+EAA+E;AAC/E,2CAA2C;AAC3C,OAAO,EAAE,aAAa,EAAmB,MAAM,8BAA8B,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAE7D;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAgB,EAChB,eAA0B;IAE1B,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;QACzB,OAAO,eAAe,IAAI,EAAE,CAAC;IAC/B,CAAC;IACD,OAAO,aAAa,CAAC;AACvB,CAAC"}

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

@@ -1,17 +1,5 @@
 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 declare const ProjectConfigSchema: z.ZodObject<{
     schema: z.ZodString;
     context: z.ZodOptional<z.ZodString>;
@@ -23,45 +11,56 @@ export declare const ProjectConfigSchema: z.ZodObject<{
 export type ProjectConfig = z.infer<typeof ProjectConfigSchema>;
 export declare const MAX_CONTEXT_SIZE: number;
 /**
- * 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).
- *
- * 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.
+ * A field this reader could not use, and therefore dropped. Returned rather than
+ * `console.warn`ed so it can reach `status[]`: "sets no context" and "your
+ * context was thrown away" are different facts.
+ */
+export interface ProjectConfigDiagnostic {
+    code: string;
+    message: string;
+}
+export interface ProjectConfigResult {
+    config: ProjectConfig | null;
+    diagnostics: ProjectConfigDiagnostic[];
+}
+/**
+ * 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.
  *
- * @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 declare function readProjectConfig(projectRoot: string): ProjectConfig | null;
 /**
- * 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.
+ * 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 declare function printProjectConfigDiagnostics(projectRoot: string): void;
+/** The same read, with the dropped fields handed back instead of printed. */
+export declare function readProjectConfigWithDiagnostics(projectRoot: string): ProjectConfigResult;
+/**
+ * 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 declare 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 declare function validateConfigRules(rules: Record<string, string[]>, validArtifactIds: Set<string>): string[];
 /**
- * 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 declare function resolveConfigFileInDir(tospecDir: string): string | null;
 /** Shared .yaml/.yml probe used by project-config readers. */

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

@@ -1 +1 @@
-{"version":3,"file":"project-config.d.ts","sourceRoot":"","sources":["../../src/core/project-config.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,mBAAmB;;;;;;;iBAmC9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,gBAAgB,QAAY,CAAC;AAE1C;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAuG3E;AAMD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAC/B,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,GAC5B,MAAM,EAAE,CAcV;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOvE;AAED,8DAA8D;AAC9D,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAExE"}
+{"version":3,"file":"project-config.d.ts","sourceRoot":"","sources":["../../src/core/project-config.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,kFAAkF;AAClF,eAAO,MAAM,mBAAmB;;;;;;;iBA6B9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,gBAAgB,QAAY,CAAC;AAE1C;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;IAC7B,WAAW,EAAE,uBAAuB,EAAE,CAAC;CACxC;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAM3E;AAED;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAIvE;AAED,6EAA6E;AAC7E,wBAAgB,gCAAgC,CAAC,WAAW,EAAE,MAAM,GAAG,mBAAmB,CAqIzF;AAED;;;;GAIG;AACH,eAAO,MAAM,eAAe,UAAU,CAAC;AAEvC;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAC/B,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,GAC5B,MAAM,EAAE,CAeV;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOvE;AAED,8DAA8D;AAC9D,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAExE"}

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":"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"}

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'];
 /** 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,YAC7B,OAAO,EACP,SAAS,EACT,iBAAiB,EAGjB,WAAW,CACH,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"}