@pmelab/gtd 58.2.0 → 59.0.0

package/src/install/ConfigScaffold.ts

@@ -1,22 +0,0 @@
-// What `gtd install` writes as a repository's `gtd.config.ts`. The default
-// export is also exported as `feature`, so a process shows that name.
-export const CONFIG_SCAFFOLD = `// The workflows gtd runs here: gtd's shipped feature, review and fix.
-// Every exported function is startable with \`gtd --workflow <name>\`; the
-// default export is what a change in the tree starts. Each workflow brings
-// its own doors: \`gtd door review [base]\` and \`gtd door fix\`. Export \`rollout\`
-// from \`@pmelab/gtd/workflows/rollout\` and \`cleanup\` from
-// \`@pmelab/gtd/workflows/cleanup\` to add \`gtd door rollout <flag>\` and
-// \`gtd door cleanup <flag>\`.
-export {
-  feature as default,
-  feature,
-  defaults,
-  envDefaults,
-  summary,
-  steering,
-  skills,
-  access,
-} from "@pmelab/gtd/workflows/feature"
-export { review } from "@pmelab/gtd/workflows/review"
-export { fix } from "@pmelab/gtd/workflows/fix"
-`

package/src/workflows/cleanup/cleanup-path.feature

@@ -1,94 +0,0 @@
-# One SDLC path per file, so a changed path reds exactly one fixture — do not merge.
-@inmem
-Feature: cleanup walks one fixed path from the opening commit to idle
-
-  A default-on release flag is cleaned up by an agent that removes the registry
-  entry and the off path; health, review and closing follow and the process
-  rests at idle. Cleanup reads no release flag, so no flag is pinned here and
-  every flag state takes the same path.
-
-  Background:
-    Given the shipped workflows, as gtd install scaffolds them
-    And a gtd config with:
-      """
-      export {
-        feature as default,
-        feature,
-        defaults,
-        envDefaults,
-        summary,
-        steering,
-        skills,
-        access,
-      } from "@pmelab/gtd/workflows/feature"
-      import { cleanup } from "@pmelab/gtd/workflows"
-      export { cleanup }
-      """
-    And an environment variable "GTD_QUALITYREVIEWS" set to ""
-    And a file "src/flags/index.ts" with:
-      """
-      export const FLAGS = [
-        { name: "alpha", owner: "a", expiry: "2027-01-01", kind: "release" },
-        { name: "live", owner: "d", expiry: "2027-04-01", kind: "release", defaultOn: true },
-      ] as const
-      """
-    And a file "src/calc.ts" with:
-      """
-      export const on = process.env.GTD_FLAG_LIVE !== "0"
-      """
-    And the working tree is committed as "feat: registry"
-    And step "cleanup.removing" writes "src/flags/index.ts" with:
-      """
-      export const FLAGS = [
-        { name: "alpha", owner: "a", expiry: "2027-01-01", kind: "release" },
-      ] as const
-      """
-    And step "cleanup.removing" writes "src/calc.ts" with:
-      """
-      export const on = true
-      """
-    And step "build.health.check" changes nothing
-    And step "build.review.reviewing" writes ".gtd/REVIEW.md" with:
-      """
-      # Review: abc1234
-
-      <!-- base: 0000000 -->
-
-      ## calc
-
-      - [ ] ./src/calc.ts#1-1
-        flag removed
-      """
-    And step "build.review.closing" runs its script
-
-  Scenario: removing the entry and the off path runs health, review and closing to idle
-    When gtd starts workflow "cleanup" with "--var flag=live"
-    And the process is driven
-    Then the process rests at "build.review.await-review"
-    Given a file ".gtd/REVIEW.md" with:
-      """
-      # Review: abc1234
-
-      <!-- base: 0000000 -->
-
-      ## calc
-
-      - [x] ./src/calc.ts#1-1
-        flag removed
-      """
-    When gtd lands
-    And the process is driven
-    Then the process rests at "idle"
-    And "src/flags/index.ts" does not contain "live"
-    And "src/calc.ts" does not contain "GTD_FLAG_LIVE"
-    And the commit subjects end with:
-      """
-      gtd(human): cleanup.removing
-      gtd(agent): cleanup.removing → build.health.check
-      gtd(check): build.health.check → build.review.reviewing
-      gtd(agent): build.review.reviewing → build.review.await-review
-      gtd(human): build.review.await-review → build.review.closing
-      gtd(check): build.review.closing → idle
-      """
-    And the commit "gtd(human): cleanup.removing" has a body containing "Gtd-Workflow: cleanup"
-    And the commit "gtd(human): cleanup.removing" has a body containing "Gtd-Var: flag=live"

package/src/workflows/cleanup/cleanup.feature

@@ -1,315 +0,0 @@
-Feature: cleanup removes a default-on release flag and keeps its flag-on path
-
-  `gtd --workflow cleanup --var flag=<name>` has an agent delete the registry
-  entry and the off path; checks refuse a surviving entry or env-var reference,
-  then the shared health loop and review run; the same checks re-run after every later agent turn. A review note ends the process.
-
-  Background:
-    Given the shipped workflows, as gtd install scaffolds them
-    And a gtd config with:
-      """
-      export {
-        feature as default,
-        feature,
-        defaults,
-        envDefaults,
-        summary,
-        steering,
-        skills,
-        access,
-      } from "@pmelab/gtd/workflows/feature"
-      import { cleanup } from "@pmelab/gtd/workflows"
-      export { cleanup }
-      """
-    And an environment variable "GTD_QUALITYREVIEWS" set to ""
-    And a file "src/flags/index.ts" with:
-      """
-      export const FLAGS = [
-        { name: "alpha", owner: "a", expiry: "2027-01-01", kind: "release" },
-        { name: "ops1", owner: "c", expiry: "2027-03-01", kind: "ops" },
-        { name: "live", owner: "d", expiry: "2027-04-01", kind: "release", defaultOn: true },
-      ] as const
-      """
-    And a file "src/calc.ts" with:
-      """
-      export const on = process.env.GTD_FLAG_LIVE !== "0"
-      """
-    And the working tree is committed as "feat: registry"
-
-  Scenario: a turn leaving the registry entry is refused
-    Given step "cleanup.removing" writes "src/calc.ts" with:
-      """
-      export const on = true
-      """
-    When gtd starts workflow "cleanup" with "--var flag=live"
-    Then driving the process is refused with "src/flags/index.ts still declares flag \"live\""
-
-  Scenario: a turn leaving the env var in a shipped source is refused naming path:line
-    Given step "cleanup.removing" writes "src/flags/index.ts" with:
-      """
-      export const FLAGS = [
-        { name: "alpha", owner: "a", expiry: "2027-01-01", kind: "release" },
-      ] as const
-      """
-    When gtd starts workflow "cleanup" with "--var flag=live"
-    Then driving the process is refused with "src/calc.ts:1 still names GTD_FLAG_LIVE"
-
-  Scenario: the same env var in a test file is allowed
-    Given a file "src/calc.test.ts" with:
-      """
-      process.env.GTD_FLAG_LIVE = "0"
-      """
-    And the working tree is committed as "test: pin kill switch"
-    And step "cleanup.removing" writes "src/flags/index.ts" with:
-      """
-      export const FLAGS = [
-        { name: "alpha", owner: "a", expiry: "2027-01-01", kind: "release" },
-      ] as const
-      """
-    And step "cleanup.removing" writes "src/calc.ts" with:
-      """
-      export const on = true
-      """
-    And step "build.health.check" changes nothing
-    When gtd starts workflow "cleanup" with "--var flag=live"
-    And the process is driven
-    Then the process rests at "build.review.reviewing"
-
-  @inmem
-  Scenario: gtd door cleanup starts the cleanup of its flag argument and reaches the review
-    Given step "cleanup.removing" writes "src/flags/index.ts" with:
-      """
-      export const FLAGS = [
-        { name: "alpha", owner: "a", expiry: "2027-01-01", kind: "release" },
-      ] as const
-      """
-    And step "cleanup.removing" writes "src/calc.ts" with:
-      """
-      export const on = true
-      """
-    And step "build.health.check" changes nothing
-    When gtd opens door "cleanup" with "live"
-    And the process is driven
-    Then the process rests at "build.review.reviewing"
-
-  @inmem
-  Scenario: gtd door cleanup with no argument is refused naming the flag
-    Then opening door "cleanup" is refused with "usage: gtd door cleanup <flag>"
-
-  @inmem
-  Scenario: a fix after a red suite that restores the registry entry is refused
-    Given step "cleanup.removing" writes "src/flags/index.ts" with:
-      """
-      export const FLAGS = [
-        { name: "alpha", owner: "a", expiry: "2027-01-01", kind: "release" },
-      ] as const
-      """
-    And step "cleanup.removing" writes "src/calc.ts" with:
-      """
-      export const on = true
-      """
-    When gtd starts workflow "cleanup" with "--var flag=live"
-    And the process is driven
-    Then the process rests at "build.health.check"
-
-    Given a file ".gtd/FEEDBACK.md" with:
-      """
-      1 failing
-      """
-    When gtd lands
-    Then the process rests at "build.fix"
-
-    Given step "build.fix" writes "src/flags/index.ts" with:
-      """
-      export const FLAGS = [
-        { name: "alpha", owner: "a", expiry: "2027-01-01", kind: "release" },
-        { name: "live", owner: "d", expiry: "2027-04-01", kind: "release", defaultOn: true },
-      ] as const
-      """
-    Then driving the process is refused with "still declares flag \"live\""
-
-  @inmem
-  Scenario: a fix after a red suite that re-adds the env var to a shipped source is refused
-    Given step "cleanup.removing" writes "src/flags/index.ts" with:
-      """
-      export const FLAGS = [
-        { name: "alpha", owner: "a", expiry: "2027-01-01", kind: "release" },
-      ] as const
-      """
-    And step "cleanup.removing" writes "src/calc.ts" with:
-      """
-      export const on = true
-      """
-    When gtd starts workflow "cleanup" with "--var flag=live"
-    And the process is driven
-    Then the process rests at "build.health.check"
-
-    Given a file ".gtd/FEEDBACK.md" with:
-      """
-      1 failing
-      """
-    When gtd lands
-    Then the process rests at "build.fix"
-
-    Given step "build.fix" writes "src/calc.ts" with:
-      """
-      export const on = process.env.GTD_FLAG_LIVE !== "0"
-      """
-    Then driving the process is refused with "src/calc.ts:1 still names GTD_FLAG_LIVE"
-
-  @inmem
-  Scenario: a fix after a red suite that edits another file only reaches the review
-    Given step "cleanup.removing" writes "src/flags/index.ts" with:
-      """
-      export const FLAGS = [
-        { name: "alpha", owner: "a", expiry: "2027-01-01", kind: "release" },
-      ] as const
-      """
-    And step "cleanup.removing" writes "src/calc.ts" with:
-      """
-      export const on = true
-      """
-    When gtd starts workflow "cleanup" with "--var flag=live"
-    And the process is driven
-    Then the process rests at "build.health.check"
-
-    Given a file ".gtd/FEEDBACK.md" with:
-      """
-      1 failing
-      """
-    When gtd lands
-    Then the process rests at "build.fix"
-
-    Given step "build.fix" writes "src/other.ts" with:
-      """
-      export const other = 1
-      """
-    And step "build.health.check" changes nothing
-    When the process is driven
-    Then the process rests at "build.review.reviewing"
-
-  @inmem
-  Scenario: a risk-fix turn after the review that restores the registry entry is refused
-    Given step "cleanup.removing" writes "src/flags/index.ts" with:
-      """
-      export const FLAGS = [
-        { name: "alpha", owner: "a", expiry: "2027-01-01", kind: "release" },
-      ] as const
-      """
-    And step "cleanup.removing" writes "src/calc.ts" with:
-      """
-      export const on = true
-      """
-    And step "build.health.check" changes nothing
-    And step "build.review.reviewing" writes ".gtd/REVIEW.md" with:
-      """
-      # Review: abc1234
-
-      <!-- base: 0000000 -->
-
-      ## calc
-
-      - [ ] ./src/calc.ts#1-1
-        Risk: leaks
-      """
-    And step "build.review.fix.risks.fixing" writes "src/flags/index.ts" with:
-      """
-      export const FLAGS = [
-        { name: "alpha", owner: "a", expiry: "2027-01-01", kind: "release" },
-        { name: "live", owner: "d", expiry: "2027-04-01", kind: "release", defaultOn: true },
-      ] as const
-      """
-    When gtd starts workflow "cleanup" with "--var flag=live"
-    Then driving the process is refused with "still declares flag \"live\""
-
-  @inmem
-  Scenario: the human's review sign-off may restore the registry entry
-    Given step "cleanup.removing" writes "src/flags/index.ts" with:
-      """
-      export const FLAGS = [
-        { name: "alpha", owner: "a", expiry: "2027-01-01", kind: "release" },
-      ] as const
-      """
-    And step "cleanup.removing" writes "src/calc.ts" with:
-      """
-      export const on = true
-      """
-    And step "build.health.check" changes nothing
-    And step "build.review.reviewing" writes ".gtd/REVIEW.md" with:
-      """
-      # Review: abc1234
-
-      <!-- base: 0000000 -->
-
-      ## calc
-
-      - [ ] ./src/calc.ts#1-1
-        fine
-      """
-    When gtd starts workflow "cleanup" with "--var flag=live"
-    And the process is driven
-    Then the process rests at "build.review.await-review"
-
-    Given a file "src/flags/index.ts" with:
-      """
-      export const FLAGS = [
-        { name: "alpha", owner: "a", expiry: "2027-01-01", kind: "release" },
-        { name: "live", owner: "d", expiry: "2027-04-01", kind: "release", defaultOn: true },
-      ] as const
-      """
-    When gtd lands
-    Then the process rests at "build.health.check"
-
-  Scenario: a review note ends the process leaving the review for fix
-    Given step "cleanup.removing" writes "src/flags/index.ts" with:
-      """
-      export const FLAGS = [
-        { name: "alpha", owner: "a", expiry: "2027-01-01", kind: "release" },
-      ] as const
-      """
-    And step "cleanup.removing" writes "src/calc.ts" with:
-      """
-      export const on = true
-      """
-    And step "build.health.check" changes nothing
-    And step "build.review.reviewing" writes ".gtd/REVIEW.md" with:
-      """
-      # Review: abc1234
-
-      <!-- base: 0000000 -->
-
-      ## calc
-
-      - [ ] ./src/calc.ts#1-1
-        flag removed
-      """
-    When gtd starts workflow "cleanup" with "--var flag=live"
-    And the process is driven
-    Then the process rests at "build.review.await-review"
-
-    Given a file ".gtd/REVIEW.md" with:
-      """
-      # Review: abc1234
-
-      <!-- base: 0000000 -->
-
-      ## calc
-
-      - [ ] ./src/calc.ts#1-1
-        flag removed — also drop the constant
-      """
-    And step "build.review.handing-off" runs its script
-    When gtd lands
-    And the process is driven
-    Then the process rests at "idle"
-    And ".gtd/REVIEW.md" contains "also drop the constant"
-    And ".gtd/REVIEW.orig.md" contains "flag removed"
-
-  Scenario: a default-off flag is refused at start
-    Then starting workflow "cleanup" with "--var flag=alpha" is refused with "flag \"alpha\" is not default-on — roll it out first"
-
-  Scenario: an unknown flag is refused at start
-    Then starting workflow "cleanup" with "--var flag=nope" is refused with "no flag \"nope\" in src/flags/index.ts"
-
-  Scenario: a non-release flag is refused at start
-    Then starting workflow "cleanup" with "--var flag=ops1" is refused with "flag \"ops1\" is ops, not release"