@pmelab/gtd 21.1.0 → 23.0.0

package/src/workflows/text.fixture.ts

@@ -20,9 +20,9 @@ export interface TextContext {
   readonly read?: (path: string) => string | undefined
   /** The scope the step runs in (`"build.review"`); the fixture pushes no scopes, so this stands in for the caller's. */
   readonly scope?: string
-  /** Stands in for `.gtdrc` `skills:`, keyed by scope full name. */
+  /** Stands in for `config.skills`, keyed by scope full name. */
   readonly skills?: Readonly<Record<string, readonly string[]>>
-  /** Stands in for `.gtdrc` `access:`, keyed by scope full name. */
+  /** Stands in for `config.access`, keyed by scope full name. */
   readonly access?: Readonly<Record<string, ScopeAccess>>
 }
 
@@ -30,7 +30,7 @@ const unavailable = (): never => {
   throw new Error("not available while rendering a text outside a replay")
 }
 
-/** Mirrors `Replay.ts`'s scope walk: for each prefix of the step's memory scope, innermost first, a `.gtdrc` entry, then the bundled export. */
+/** Mirrors `Replay.ts`'s scope walk: for each prefix of the step's memory scope, innermost first, a `config` entry, then the bundled export. */
 const skillsForOf =
   (context: TextContext) =>
   (localName: string): readonly string[] => {

package/src/workflows/text.ts

@@ -869,7 +869,7 @@ every commit is machine-authored.
   load (a stricter validation, an escape a value must now spell differently)
   — a public surface, not an internal one, either way — add a literal
   \`BREAKING CHANGE:\` footer naming what breaks and, for the second case,
-  the exact escape or rewrite a committed \`.gtdrc\` needs. A \`!\` on the
+  the exact escape or rewrite a committed config needs. A \`!\` on the
   type prefix alone (\`feat!:\`/\`refactor!:\`) is NOT enough: this repo's
   own commit-analyzer has missed that marker before, cutting no release
   until a follow-up commit carried the literal footer instead

package/src/workflows/vars.ts

@@ -1,7 +1,7 @@
 // The bundled workflow's settings, in two kinds. A process setting changes
 // which step comes next, so it is pinned for the whole process at its start;
 // an environment setting only changes how a step runs on this machine, so it
-// is read live on every invocation. `.gtdrc` `vars:`/`env:`, `--var` (process
+// is read live on every invocation. A factory option, `--var` (process
 // settings only) and `GTD_<NAME>` override either.
 
 /** Process settings. */

package/schema.json

@@ -1,136 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "type": "object",
-  "required": [],
-  "properties": {
-    "vars": {
-      "type": "object",
-      "description": "Flat name -> scalar map merged into the workflow's process settings (defaults), pinned for the whole process at its start. Scalars are coerced to strings.",
-      "additionalProperties": {
-        "type": [
-          "string",
-          "number",
-          "boolean"
-        ]
-      }
-    },
-    "env": {
-      "type": "object",
-      "description": "Flat name -> scalar map merged into the workflow's environment settings (envDefaults) — values that change how a step runs on this machine, like the test command or a model hint. Read fresh on every gtd call, never pinned to a process. GTD_<NAME> environment variables override these entries. Scalars are coerced to strings.",
-      "additionalProperties": {
-        "type": [
-          "string",
-          "number",
-          "boolean"
-        ]
-      }
-    },
-    "judge": {
-      "type": "object",
-      "required": [],
-      "properties": {
-        "provider": {
-          "type": "string",
-          "enum": [
-            "fixed",
-            "jev",
-            "llm"
-          ],
-          "description": "Judge provider `gtd judge run` uses when no --provider flag, no GTD_JUDGE_PROVIDER and no user-level judge.json says. Absent means auto: jev when TYPESAFE_API_KEY is set, otherwise llm."
-        },
-        "model": {
-          "type": "string",
-          "description": "Model for provider llm, used when no --model flag, no GTD_JUDGE_MODEL and no user-level judge.json says. Pairing it with another provider is an error."
-        }
-      },
-      "additionalProperties": false,
-      "description": "Which judge `gtd judge run` uses, when no flag, GTD_JUDGE_* variable or user-level judge.json says."
-    },
-    "modes": {
-      "type": "object",
-      "description": "Steering-file modes a workflow step's mode: may name. Each entry declares at least one of format/validate: shell commands gtd runs via bash with $GTD_FILE set to the steering file's path. format rewrites the file in place; validate exits 0 when valid, non-zero with findings on stdout/stderr otherwise. The halves layer independently, so naming a built-in mode (qa/review) and declaring only format: adds formatting while keeping gtd's own validation. gtd ships no formatter — bring your own (prettier, dprint, a script).",
-      "additionalProperties": {
-        "type": "object",
-        "description": "One mode: at least one of format/validate.",
-        "additionalProperties": false,
-        "minProperties": 1,
-        "properties": {
-          "format": {
-            "type": "string",
-            "description": "Shell command that rewrites the steering file in place before validation ($GTD_FILE is the file path). A non-zero exit is a hard error."
-          },
-          "validate": {
-            "type": "string",
-            "description": "Shell command that validates the steering file ($GTD_FILE is the file path). Exit 0 = valid; non-zero = invalid, with its output reported as the findings."
-          }
-        }
-      }
-    },
-    "ui": {
-      "type": "object",
-      "required": [],
-      "properties": {
-        "port": {
-          "type": "integer",
-          "description": "For ui, the tailscale serve port (default: the first free of 8443, 10000, 443), or the bind port when --host opts out of serve (default: a free port).",
-          "title": "int"
-        },
-        "host": {
-          "type": "string",
-          "description": "Host/interface `gtd ui` binds to."
-        },
-        "cert": {
-          "type": "string",
-          "description": "Path to a TLS certificate file, enabling HTTPS. Requires `key` too."
-        },
-        "key": {
-          "type": "string",
-          "description": "Path to a TLS private key file, enabling HTTPS. Requires `cert` too."
-        },
-        "format": {
-          "type": "string",
-          "description": "Shell command run after every UI write, before it resolves ($GTD_FILE is the written file's absolute path). A non-zero exit or missing binary never reverts the write or refuses it — it's reported to the client as a notice naming the command and its exit code. Absent means no command runs at all."
-        }
-      },
-      "additionalProperties": false,
-      "description": "Settings for `gtd ui`: where it listens, and optional TLS."
-    },
-    "skills": {
-      "type": "object",
-      "description": "Flat scope full-name -> skill-name array map. Each entry REPLACES the named scope's skill list wholesale (never merges into it) and reaches every nested scope that sets no list of its own; [] means no skills at all for that scope, and no preamble. A key that is not a scope running a turn is a load error listing the known scopes — the schema itself cannot validate a key, only a value's shape.",
-      "additionalProperties": {
-        "type": "array",
-        "items": {
-          "type": "string"
-        }
-      }
-    },
-    "access": {
-      "type": "object",
-      "description": "Flat scope full-name -> { read?, write? } map of glob arrays. Each entry REPLACES the named scope's declared access wholesale (never merges into it) and reaches every nested scope that sets none of its own; a missing side is unrestricted, [] allows nothing, and {} lifts every restriction. read and write are independent: write grants no read. A key that is not a scope running a turn is a load error listing the known scopes — the schema itself cannot validate a key, only a value's shape.",
-      "additionalProperties": {
-        "type": "object",
-        "additionalProperties": false,
-        "properties": {
-          "read": {
-            "type": "array",
-            "items": {
-              "type": "string"
-            }
-          },
-          "write": {
-            "type": "array",
-            "items": {
-              "type": "string"
-            }
-          }
-        }
-      }
-    },
-    "$schema": {
-      "type": "string",
-      "description": "Editor-only pointer at this schema. Stripped by gtd before validation."
-    }
-  },
-  "additionalProperties": false
-}