@codedrifters/configulator 0.0.283 → 0.0.284

package/lib/index.d.mts

@@ -1968,7 +1968,7 @@ interface UnblockDependentsConfig {
  *
  * Every field is optional. When the whole config is absent the
  * convention ships **enabled** with JSON-formatted files stored under
- * `.claude/state/<issue-number>-progress.json`.
+ * `.state/<issue-number>-progress.json`.
  *
  * Malformed configs — empty / whitespace-only or absolute `stateDir`,
  * empty / whitespace-only `filenamePattern`, `filenamePattern` missing
@@ -1997,7 +1997,10 @@ interface ProgressFilesConfig {
      * The directory is added to the project's `.gitignore` at synth
      * time so progress files never land on the default branch.
      *
-     * Defaults to `.claude/state`.
+     * Defaults to `.state` — a top-level repo-root directory rather
+     * than a Claude-specific subtree, so the same progress files can
+     * be read and written by any agent runtime (Claude Code, Cursor,
+     * a bespoke worker).
      */
     readonly stateDir?: string;
     /**
@@ -2944,7 +2947,7 @@ interface AgentConfigOptions {
      *
      * When the whole config is omitted, the convention ships
      * **enabled** with JSON-formatted files stored under
-     * `.claude/state/<issue-number>-progress.json` and a 72-hour
+     * `.state/<issue-number>-progress.json` and a 72-hour
      * staleness threshold.
      *
      * Supply `enabled: false` to disable the convention entirely,
@@ -4601,9 +4604,15 @@ declare const DEFAULT_PROGRESS_FILES_ENABLED = true;
  * `<stateDir>/<filename>` where `<filename>` is produced from
  * `filenamePattern` at runtime.
  *
+ * Lives at the top-level `.state/` directory rather than under
+ * `.claude/state/` so the path stays harness-neutral — any agent
+ * runtime (Claude Code, Cursor, a bespoke worker) can read and
+ * write the same progress files without having to scope under a
+ * Claude-specific tree.
+ *
  * @see ProgressFilesConfig
  */
-declare const DEFAULT_PROGRESS_FILES_STATE_DIR = ".claude/state";
+declare const DEFAULT_PROGRESS_FILES_STATE_DIR = ".state";
 /**
  * Default filename pattern for a progress file. The `<ISSUE_NUMBER>`
  * placeholder is substituted at runtime with the numeric id of the

package/lib/index.d.ts

@@ -2017,7 +2017,7 @@ interface UnblockDependentsConfig {
  *
  * Every field is optional. When the whole config is absent the
  * convention ships **enabled** with JSON-formatted files stored under
- * `.claude/state/<issue-number>-progress.json`.
+ * `.state/<issue-number>-progress.json`.
  *
  * Malformed configs — empty / whitespace-only or absolute `stateDir`,
  * empty / whitespace-only `filenamePattern`, `filenamePattern` missing
@@ -2046,7 +2046,10 @@ interface ProgressFilesConfig {
      * The directory is added to the project's `.gitignore` at synth
      * time so progress files never land on the default branch.
      *
-     * Defaults to `.claude/state`.
+     * Defaults to `.state` — a top-level repo-root directory rather
+     * than a Claude-specific subtree, so the same progress files can
+     * be read and written by any agent runtime (Claude Code, Cursor,
+     * a bespoke worker).
      */
     readonly stateDir?: string;
     /**
@@ -2993,7 +2996,7 @@ interface AgentConfigOptions {
      *
      * When the whole config is omitted, the convention ships
      * **enabled** with JSON-formatted files stored under
-     * `.claude/state/<issue-number>-progress.json` and a 72-hour
+     * `.state/<issue-number>-progress.json` and a 72-hour
      * staleness threshold.
      *
      * Supply `enabled: false` to disable the convention entirely,
@@ -4650,9 +4653,15 @@ declare const DEFAULT_PROGRESS_FILES_ENABLED = true;
  * `<stateDir>/<filename>` where `<filename>` is produced from
  * `filenamePattern` at runtime.
  *
+ * Lives at the top-level `.state/` directory rather than under
+ * `.claude/state/` so the path stays harness-neutral — any agent
+ * runtime (Claude Code, Cursor, a bespoke worker) can read and
+ * write the same progress files without having to scope under a
+ * Claude-specific tree.
+ *
  * @see ProgressFilesConfig
  */
-declare const DEFAULT_PROGRESS_FILES_STATE_DIR = ".claude/state";
+declare const DEFAULT_PROGRESS_FILES_STATE_DIR = ".state";
 /**
  * Default filename pattern for a progress file. The `<ISSUE_NUMBER>`
  * placeholder is substituted at runtime with the numeric id of the

package/lib/index.js

@@ -1938,7 +1938,7 @@ function resolveAgentPaths(paths) {
 
 // src/agent/bundles/progress-files.ts
 var DEFAULT_PROGRESS_FILES_ENABLED = true;
-var DEFAULT_PROGRESS_FILES_STATE_DIR = ".claude/state";
+var DEFAULT_PROGRESS_FILES_STATE_DIR = ".state";
 var DEFAULT_PROGRESS_FILES_FILENAME_PATTERN = "<ISSUE_NUMBER>-progress.json";
 var DEFAULT_PROGRESS_FILES_FORMAT = "json";
 var DEFAULT_PROGRESS_FILES_STALE_AFTER_HOURS = 72;