@pmelab/gtd 20.4.0 → 21.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pmelab/gtd",
-  "version": "20.4.0",
+  "version": "21.1.0",
   "private": false,
   "description": "Git-aware CLI that emits the next prompt for an autonomous coding agent based on the current repository state",
   "bin": {
@@ -8,7 +8,16 @@
   },
   "exports": {
     "./flows": "./src/flows/index.ts",
-    "./workflow": "./src/workflows/bundled.ts"
+    "./workflows": {
+      "types": "./src/workflows/index.ts",
+      "source": "./src/workflows/index.ts",
+      "default": "./dist/workflows.mjs"
+    },
+    "./workflow": {
+      "types": "./src/workflows/index.ts",
+      "source": "./src/workflows/index.ts",
+      "default": "./dist/workflows.mjs"
+    }
   },
   "files": [
     "dist/",
@@ -42,7 +51,7 @@
   "scripts": {
     "prepare": "husky",
     "dev": "node dev/run.mjs",
-    "build": "tsdown --filter web && npx @tailwindcss/cli -i src/web/styles.css -o dist/web/main.css --minify && node scripts/inline-web-client.mjs && tsdown --filter gtd",
+    "build": "tsdown --filter web && npx @tailwindcss/cli -i src/web/styles.css -o dist/web/main.css --minify && node scripts/inline-web-client.mjs && tsdown --filter gtd && tsdown --filter workflows",
     "postbuild": "jiti scripts/generate-schema.ts && node scripts/assert-no-test-doubles.mjs",
     "watch": "tsdown --watch",
     "bench:replay": "node scripts/bench-replay.mjs",

package/schema.json

@@ -36,15 +36,15 @@
             "jev",
             "llm"
           ],
-          "description": "Judge provider `gtd judge run` uses when no --provider flag and no GTD_JUDGE_PROVIDER is set. Absent means auto: jev when TYPESAFE_API_KEY is set, otherwise 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 and no GTD_JUDGE_MODEL is set. Pairing it with another provider is an error."
+          "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 or GTD_JUDGE_* variable says."
+      "description": "Which judge `gtd judge run` uses, when no flag, GTD_JUDGE_* variable or user-level judge.json says."
     },
     "modes": {
       "type": "object",

package/skills/authoring/SKILL.md

@@ -29,12 +29,12 @@ what a driver does.
 state (`gtd next`, `gtd lsp`, `gtd door` and `gtd doors` included). It is code
 the user's repository runs; write it with the same care as a build script.
 
-## Golden rule: start from the bundled default, edit incrementally
+## Golden rule: start from the shipped workflows, edit incrementally
 
 Do **not** write a workflow from a blank page unless the user wants something
-tiny. gtd ships three startable workflows (`feature`, `review`, `fix`) as named
-exports of `@pmelab/gtd/workflow` and runs them when no `gtd.config.ts` is
-found. Its default export is `feature` (the ordinary start), and every phase and
+tiny. gtd ships three workflows (`feature`, `review`, `fix`) as named exports of
+`@pmelab/gtd/workflows`; `gtd install` scaffolds a `gtd.config.ts` re-exporting
+them. Its default export is `feature` (the ordinary start), and every phase and
 single step they are built from is a named export too. Start by importing what
 you keep and writing only what changes. Import phases by name; **never
 `export *` from it** — every exported function of your file would become a
@@ -42,7 +42,7 @@ startable workflow:
 
 ```ts
 import { start } from "@pmelab/gtd/flows"
-import { afterTail, buildTail, feature } from "@pmelab/gtd/workflow"
+import { afterTail, buildTail, feature } from "@pmelab/gtd/workflows"
 
 export {
   defaults,
@@ -51,7 +51,7 @@ export {
   base,
   steering,
   skills,
-} from "@pmelab/gtd/workflow"
+} from "@pmelab/gtd/workflows"
 
 export default feature
 

package/src/workflows/access.test.ts

@@ -1,6 +1,6 @@
 import { describe, expect, it } from "vitest"
 import { access } from "./access.js"
-import { bundled as workflow } from "./index.js"
+import * as workflow from "./index.js"
 
 const { defaults } = workflow
 

package/src/workflows/index.ts

@@ -1 +1,4 @@
-export * as bundled from "./bundled.js"
+// The `@pmelab/gtd/workflows` entry, built on its own: core never imports it,
+// a repository's `gtd.config.ts` does.
+export * from "./bundled.js"
+export { default } from "./bundled.js"

package/src/workflows/review.test.ts

@@ -1,7 +1,7 @@
 import { afterEach, describe, expect, it } from "vitest"
 import { installContext, type Change, type JudgeAnswer, type StepRequest } from "../flows/index.js"
 import { fixQualityFindings, review, type ReviewOutcome } from "./review.js"
-import { bundled } from "./index.js"
+import * as bundled from "./index.js"
 import { fixtureContext } from "./text.fixture.js"
 
 afterEach(() => installContext(undefined))

package/src/workflows/skills.test.ts

@@ -1,6 +1,6 @@
 import { describe, expect, it } from "vitest"
 import { skills } from "./skills.js"
-import { bundled as workflow } from "./index.js"
+import * as workflow from "./index.js"
 
 const { defaults } = workflow