@open-agent-toolkit/cli 0.0.53 → 0.0.55

package/assets/skills/oat-project-design/references/selective-review-pass.md

@@ -0,0 +1,112 @@
+# Selective Review Pass
+
+This reference defines the prose-driven classification pass used by `oat-project-design` when `DESIGN_MODE == "selective"`. The skill body owns flow; this file owns the heuristic.
+
+## Signal Set
+
+Classify each design section as `routine` or `needs-eyes`. Bias is conservative: any one `needs-eyes` signal marks the section `needs-eyes`.
+
+Always `needs-eyes`:
+
+- `Overview + Architecture`
+- `Security Considerations`
+- `Performance Considerations`
+- `Error Handling`
+- `Migration Plan`
+
+Per-section `needs-eyes` signals:
+
+- The user flagged concern, uncertainty, or worry about this area during discovery.
+- Discovery Open Questions mention this area.
+- Three or more spec FRs/NFRs directly touch this area.
+- Component boundaries cross modules not already described in `.oat/repo/knowledge/architecture.md`.
+- The section introduces a pattern absent from `.oat/repo/knowledge/conventions.md` and `.oat/repo/knowledge/stack.md`.
+- The section changes public API, CLI, configuration, workflow semantics, defaults, or persisted state.
+- The section introduces a new dependency, provider, service, storage model, permission boundary, or external integration.
+- The section depends on knowledge files that are missing, stale, or too thin to support a low-risk classification.
+
+`routine` means the section follows established repo patterns, is low-risk, and has enough grounding to draft silently. It does not mean the section is unimportant; it still appears in the committed design and final review gate.
+
+## Adequate Grounding
+
+Grounding is adequate when at least one strong source, or two weaker sources, exists for the design surface:
+
+- Strong sources: `.oat/repo/knowledge/project-index.md`, `.oat/repo/knowledge/architecture.md`, or a configured docs app with relevant architecture/convention docs.
+- Weaker sources: non-thin `docs/`, `.oat/repo/knowledge/conventions.md`, `.oat/repo/knowledge/stack.md`, `.oat/repo/knowledge/concerns.md`, discovery notes with concrete implementation context, or existing nearby implementation patterns found in the repo.
+
+Treat grounding as broadly absent when discovery skipped solution-space exploration and the knowledge base/docs are sparse. In that case, do not recommend Selective Collaborative; prefer Collaborative.
+
+## Recommendation Rules
+
+Before the picker, run a lightweight classification preflight against the shared section list. Assign Selective Collaborative one of four states:
+
+- `recommended`: grounding is adequate and at least 3 sections, or roughly 30-40% of sections, classify as `routine`.
+- `available`: grounding is adequate but Collaborative is still the safer default.
+- `available-not-recommended`: grounding exists, but savings are marginal for this design.
+- `unavailable`: grounding is broadly absent.
+
+Default recommendation is Collaborative when in doubt. Draft-and-review is never the picker default unless explicitly selected through argument, environment, or config.
+
+## Edge Cases
+
+- If every section is `needs-eyes`, Selective Collaborative collapses to Collaborative. Emit: "All sections flagged for review — running as full collaborative."
+- If zero sections are `needs-eyes`, force `Overview + Architecture` to `needs-eyes` so the user sees the framing before silent drafting continues.
+- If a user elevates a `routine` section in the Section Review Plan, keep it `needs-eyes` for the rest of the run.
+- If the user chooses "walk me through every remaining section" during a needs-eyes confirmation, mark all remaining sections `needs-eyes`.
+- If the classification cannot explain its reason in one sentence, treat the section as `needs-eyes`.
+
+## Examples
+
+Routine example:
+
+| Section          | Classification | Reason                                                                                             | Signals hit         |
+| ---------------- | -------------- | -------------------------------------------------------------------------------------------------- | ------------------- |
+| Testing Strategy | routine        | Follows existing requirement-to-test mapping pattern and no discovery uncertainty touches testing. | established pattern |
+
+Needs-eyes example:
+
+| Section    | Classification | Reason                                                                | Signals hit                                 |
+| ---------- | -------------- | --------------------------------------------------------------------- | ------------------------------------------- |
+| API Design | needs-eyes     | Adds a new public CLI/config surface that changes workflow semantics. | public API/CLI/config, user-facing defaults |
+
+## Dogfood Notes
+
+Use this section to capture misclassifications found while dogfooding Selective Collaborative mode. Keep entries short and actionable.
+
+Template:
+
+```markdown
+- Date/project:
+- Section:
+- Classified as:
+- Should have been:
+- Missed or overweighted signal:
+- Prose adjustment:
+```
+
+### Dogfood run 2026-04-30: collaborative-design-workflow
+
+Classification pass run manually against this project's own `spec.md`, `design.md`, `discovery.md`, and `.oat/repo/knowledge/*` context. Grounding was adequate (`project-index.md`, `architecture.md`, `conventions.md`, `stack.md`, and detailed discovery/design artifacts exist). Result: Selective Collaborative would be `recommended` because 3 of 12 sections classify as `routine` while high-risk sections still receive live review.
+
+| Section                                             | Classified As | Expected? | Notes                                                                 |
+| --------------------------------------------------- | ------------- | --------- | --------------------------------------------------------------------- |
+| Overview + Architecture                             | needs-eyes    | yes       | Forced floor; user should see framing before any silent drafting.     |
+| Component Design                                    | needs-eyes    | yes       | Cross-skill workflow semantics and config/skill boundaries changed.   |
+| Data Models                                         | routine       | yes       | No database/domain model changes; config risk covered elsewhere.      |
+| API Design                                          | needs-eyes    | yes       | Public CLI/config surface changes via `workflow.designMode`.          |
+| Security Considerations                             | needs-eyes    | yes       | High-risk-by-default section.                                         |
+| Performance Considerations                          | needs-eyes    | yes       | High-risk-by-default section.                                         |
+| Error Handling                                      | needs-eyes    | yes       | High-risk-by-default section.                                         |
+| Testing Strategy (with Requirement-to-Test Mapping) | needs-eyes    | yes       | New prose-contract validation plus manual dogfood acceptance surface. |
+| Deployment Strategy                                 | routine       | yes       | No deployment-path change; release packaging validated separately.    |
+| Migration Plan                                      | needs-eyes    | yes       | High-risk-by-default section, even when no migration is expected.     |
+| Implementation Phases                               | routine       | yes       | Follows established OAT plan/task structure.                          |
+| Risks and Mitigation                                | needs-eyes    | yes       | New user-facing workflow mode and heuristic failure modes.            |
+
+No classification misfires were identified in this artifact-only pass. Live picker taxonomy, mid-flight elevation, and final recap behavior still require an interactive dogfood run because `oat-project-design` is a provider skill, not an executable CLI command.
+
+Deferred follow-up dogfood after this PR opens:
+
+- Exercise picker taxonomy live paths: `Recommended`, `Available / not recommended`, and `Unavailable`.
+- Select "walk me through every remaining section" during a needs-eyes confirmation and verify every remaining section is presented.
+- Confirm the final user-review gate lists sections drafted without live confirmation.

package/assets/skills/oat-project-discover/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: oat-project-discover
-version: 1.3.0
+version: 2.0.0
 description: Use when starting a project or when requirements are still unclear. Runs structured discovery to gather requirements, constraints, and context.
 disable-model-invocation: true
 user-invocable: true
@@ -322,7 +322,7 @@ If `"discovery"` is in `oat_hill_checkpoints`, require explicit user approval be
 
 **Approval prompt (required):**
 
-- "Discovery artifact is ready. Approve discovery and unlock `oat-project-spec`?"
+- "Discovery artifact is ready. Approve discovery and unlock `oat-project-design`?"
 
 **Optional independent review path:**
 
@@ -347,7 +347,7 @@ Update frontmatter:
 ```yaml
 ---
 oat_status: complete
-oat_ready_for: oat-project-spec
+oat_ready_for: oat-project-design
 ---
 ```
 
@@ -383,7 +383,7 @@ Key decisions:
 - {Decision 1}
 - {Decision 2}
 
-Ready for specification phase"
+Ready for design phase"
 ```
 
 ### Step 15: Output Summary
@@ -391,5 +391,9 @@ Ready for specification phase"
 ```
 Discovery phase complete for {project-name}.
 
-Next: Create specification with the oat-project-spec skill
+Next: Create design with the oat-project-design skill (which will confirm
+requirements automatically and produce both spec.md and design.md).
+
+If you'd rather formalize requirements without designing yet, run
+`oat-project-spec` as a standalone step.
 ```

package/assets/skills/oat-project-quick-start/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: oat-project-quick-start
-version: 1.3.6
+version: 2.0.2
 description: Use when a task is small enough for quick mode or rapid iteration is preferred. Scaffolds a lightweight OAT project from discovery directly to a runnable plan, with optional brainstorming and lightweight design.
 argument-hint: '<project-name> ["project description"]'
 disable-model-invocation: true
@@ -170,7 +170,7 @@ git diff --cached --quiet || git commit -m "chore(oat): capture quick-start disc
 
 ### Step 2.5: Decision Point — Design Depth
 
-**Auto-advance rule:** If the request was classified as **well-understood** in Step 2a and discovery surfaced no architecture decisions, component boundary questions, or unexpected complexity, skip this decision point entirely and continue directly to Step 3. This preserves the minimal-ceremony contract for straightforward requests.
+**Auto-advance rule:** If the request was classified as **well-understood** in Step 2a and discovery surfaced no architecture decisions, component boundary questions, or unexpected complexity, skip this decision point entirely and continue directly to Step 2.6 (the requirements gate still fires before plan generation). This preserves the minimal-ceremony contract for straightforward requests.
 
 **Otherwise**, present the user with a choice about how to proceed:
 
@@ -188,15 +188,15 @@ Use `AskUserQuestion` to present this choice.
 - If discovery surfaced architecture choices, component boundaries, or data model questions → recommend "Lightweight design first"
 - If discovery revealed the scope is larger or more complex than initially expected → recommend "Promote to spec-driven"
 
-**If user chooses "Straight to plan":** continue to Step 3.
+**If user chooses "Straight to plan":** continue to Step 2.6 (requirements gate), then Step 3.
 
-**If user chooses "Lightweight design first":** execute Step 2.75 before continuing to Step 3.
+**If user chooses "Lightweight design first":** execute Step 2.75 before continuing to Step 3. The Step 2.6 requirements gate is skipped — Step 2.75's in-conversation design validation covers that ground.
 
 **If user chooses "Promote to spec-driven":**
 
 - Update `discovery.md` frontmatter:
   - `oat_status: complete`
-  - `oat_ready_for: oat-project-spec`
+  - `oat_ready_for: oat-project-design`
   - `oat_last_updated: {today}`
 - Update `state.md`:
   - `oat_workflow_mode: spec-driven`
@@ -211,9 +211,105 @@ git add "$PROJECT_PATH/discovery.md" "$PROJECT_PATH/state.md" ".oat/state.md"
 git diff --cached --quiet || git commit -m "chore(oat): promote quick-start discovery for {project-name}"
 ```
 
-- Inform the user: "Discovery is complete. Run `oat-project-spec` next to formalize requirements."
+- Inform the user: "Discovery is complete. Run `oat-project-design` next — it will confirm requirements and produce both `spec.md` and `design.md` in one collaborative pass. If you'd rather formalize requirements without designing yet, `oat-project-spec` remains available as an optional standalone step."
 - Stop here. Do not generate a plan.
 
+### Step 2.6: Requirements Gate (Straight-to-Plan Path)
+
+Fires only when the straight-to-plan path was chosen at Step 2.5 (explicit choice or auto-advance). Skip when the user selected "Lightweight design first" (Step 2.75 handles its own in-conversation confirmation) or "Promote to spec-driven".
+
+Single conversational turn — no loop inside the gate. If the user materially redirects scope, route OUT to lightweight design or back to discovery.
+
+> **Tool availability is not the same as interactivity.** If `AskUserQuestion` is unavailable but chat is available, present this gate as a plain chat message and wait for the user's reply. Do not auto-confirm just because the structured question tool is missing.
+
+```
+# Explicit non-interactive fallback FIRST (FR9 contract; same signal as
+# design mode choice). Lack of AskUserQuestion alone is NOT non-interactive
+# — if chat with the user is available, present the gate as a plain chat
+# message and wait for their reply instead.
+if [ "${OAT_NON_INTERACTIVE:-}" = "1" ] || no_user_response_channel_exists; then
+  echo "Requirements gate auto-confirmed in non-interactive mode."
+  # proceed to Step 3
+fi
+
+# Interactive bypass (power-user opt-out).
+if [ "${OAT_NO_REQUIREMENTS_GATE:-}" = "1" ] || [ "$ARG_NO_GATE" = "1" ]; then
+  # proceed to Step 3 silently
+fi
+
+# Extract requirements from discovery.md:
+#   - Key Decisions
+#   - Success Criteria
+#   - Constraints
+# Format as bullet list and present (SINGLE TURN):
+#
+#   > "Before I generate the plan, here are the requirements I'm building against:
+#   >
+#   >    Key decisions:
+#   >    - [decision 1]
+#   >    - [decision 2]
+#   >
+#   >    Success criteria:
+#   >    - [criterion 1]
+#   >
+#   >    Constraints:
+#   >    - [constraint 1]
+#   >
+#   >  Does this match what you want?"
+
+# AskUserQuestion multi-choice:
+#   1. Yes — proceed to plan generation
+#   2. Add a minor requirement that still fits this scope (capture inline, proceed — no re-present)
+#   3. Scope needs redirecting — rework discovery or produce a lightweight design first
+#
+# On choice 1: continue to Step 3.
+# On choice 2: prompt once for the addition, append to discovery.md, proceed to Step 3 (do NOT re-present).
+# On choice 3: exit the gate cleanly. Present follow-up choice:
+#   a. Produce a lightweight design first (run Step 2.75)
+#   b. Expand discovery (return to Step 2)
+# Route the user accordingly. Do NOT loop back into the gate.
+```
+
+### Step 2.75a: Lightweight Design Mode Choice
+
+Resolve the interaction mode before drafting. Same mechanics as the full `oat-project-design` skill (Component 1): argument precedes env var, config fallback, **explicit** non-interactive fallback to draft.
+
+> **Tool availability is not the same as interactivity.** If `AskUserQuestion` is unavailable but chat is available, ask the mode-choice question as a plain chat message and wait for the user's reply. Only fall back to draft when `OAT_NON_INTERACTIVE=1` is set or there is no user-response channel at all.
+
+```
+DESIGN_MODE="${ARG_MODE:-${OAT_DESIGN_MODE:-}}"
+if [ -z "$DESIGN_MODE" ]; then
+  if [ "${OAT_NON_INTERACTIVE:-}" = "1" ] || no_user_response_channel_exists; then
+    DESIGN_MODE="draft"
+    echo "Non-interactive context detected. Falling back to draft-and-review mode."
+  else
+    # Consult persisted preference (FR15 / Component 14) before prompting
+    CONFIG_MODE=$(oat config get workflow.designMode 2>/dev/null || echo "")
+    if [ "$CONFIG_MODE" = "collaborative" ] || [ "$CONFIG_MODE" = "selective" ] || [ "$CONFIG_MODE" = "draft" ]; then
+      DESIGN_MODE="$CONFIG_MODE"
+      if [ "$DESIGN_MODE" = "selective" ]; then
+        DESIGN_MODE="collaborative"
+        echo "Using workflow.designMode = selective from config (treating as collaborative for lightweight design; Selective Collaborative is only available in full oat-project-design)."
+      else
+        echo "Using workflow.designMode = ${DESIGN_MODE} from config."
+      fi
+    else
+      # Prefer AskUserQuestion for structured multi-choice when available.
+      # If AskUserQuestion is unavailable, ask the same question as a plain
+      # chat message and wait for the user's reply. Do NOT switch to draft
+      # mode just because the structured tool is missing.
+      #
+      # Prompt (SAME text as oat-project-design Step 1.5):
+      #   "How would you like to work through the lightweight design?
+      #     1. Collaborative (recommended) — section-by-section, one approach confirmation before drafting
+      #     2. Draft-and-review — full draft up front, you review holistically"
+      :
+    fi
+  fi
+fi
+echo "Running in ${DESIGN_MODE} mode."
+```
+
 ### Step 2.75: Lightweight Design (Optional)
 
 Produce a focused `design.md` covering only what's needed for a quality plan. This is NOT the full spec-driven design — it's a quick architectural sketch.
@@ -242,14 +338,37 @@ Copy template: `.oat/templates/design.md` → `"$PROJECT_PATH/design.md"`
 - Dependencies (captured in discovery instead)
 - Risks and Mitigation (captured in discovery instead)
 
-**Present design incrementally for validation:**
-
-1. Draft architecture overview → present to user for validation
-2. Draft component design → present to user for validation
-3. Draft data flow + testing approach → present to user for validation
-4. Finalize `design.md`
+**Draft the design based on `DESIGN_MODE` (resolved in Step 2.75a):**
 
-After each chunk, ask: "Does this look right, or should we adjust before continuing?"
+```
+IF DESIGN_MODE == "collaborative":
+  For SECTION in [Overview, Architecture, Component Design, Testing Strategy
+                  (required); Data Models, API Design, Error Handling
+                  (include only when relevant); SKIP Security, Performance,
+                  Deployment, Migration]:
+    Draft section content. Scale each section to its complexity:
+      a few sentences if straightforward, up to 200-300 words if nuanced.
+    Not-applicable sections: state as a single sentence, not empty.
+    Present:
+      "Here's what I have for [section]: [content].
+       Does this look right, or should we adjust before continuing?"
+    Use AskUserQuestion for the validation prompt.
+    Revise inline on feedback. Be ready to go back and clarify if something
+      doesn't make sense. Re-present if substantive.
+    Mark section approved. Move to next.
+
+IF DESIGN_MODE == "draft":
+  Draft all required sections (Overview, Architecture, Component Design,
+    Testing Strategy) and any applicable optional sections (Data Models,
+    API Design, Error Handling) in ONE pass (same reduced section set).
+  Scale each section to its complexity — no per-section prompts fire.
+  Run the FULL 4-check self-review (placeholder + internal consistency +
+    scope + ambiguity). No scaled-down variant — identical to the full
+    oat-project-design self-review.
+  Present the user-review gate wording (adapted for quick-start:
+    no HiLL gate by default; commits-first is still in effect).
+  Produce design.md only — NO spec.md is written by lightweight design.
+```
 
 If `design.md` or `state.md` was updated before one of these validation pauses, commit those artifact changes before waiting for the user response.
 

package/assets/skills/oat-project-spec/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: oat-project-spec
-version: 1.2.0
-description: Use when discovery is complete and the project needs a formal requirements baseline. Transforms discovery output into structured specification artifacts.
+version: 2.0.0
+description: Optional standalone skill for formalizing requirements into a structured spec.md when discovery is complete but you're not ready to design yet. Independent of the design workflow — oat-project-design confirms requirements automatically and does not require this skill to be run first.
 disable-model-invocation: true
 user-invocable: true
 allowed-tools: Read, Write, Bash(git:*), Glob, Grep, AskUserQuestion
@@ -450,7 +450,7 @@ Ready for design phase"
 ### Step 21: Output Summary
 
 ```
-Specification phase complete for {project-name}.
+Specification artifact created for {project-name}.
 
 Created:
 - {N} functional requirements
@@ -458,7 +458,12 @@ Created:
 - High-level design approach
 - Success metrics
 
-Next: Create detailed design with the oat-project-design skill
+Note: This skill is optional in the default workflow. `oat-project-design`
+will confirm requirements automatically when run after discovery.
+
+If you want to proceed to design now, run: `oat-project-design`
+If you're parking the project here, the spec.md is committed and ready
+to pick up later.
 ```
 
 ## Success Criteria

package/assets/templates/discovery.md

@@ -129,7 +129,16 @@ _Include this section only when the request is exploratory or multiple viable ap
 
 Use this discovery artifact to drive the next workflow step:
 
-- **Quick mode → straight to plan:** proceed directly to `plan.md` when scope is clear and no architecture decisions remain.
-- **Quick mode → optional lightweight design:** produce a focused `design.md` (architecture, components, data flow, testing) before planning. Choose this when discovery surfaced architecture choices or component boundaries.
-- **Quick mode → promote:** escalate to spec-driven if discovery revealed the scope is larger or more complex than expected.
-- **Spec-driven mode:** continue to `oat-project-spec` (after HiLL approval if configured).
+- **Spec-driven mode:** continue to `oat-project-design` (which confirms
+  requirements and produces both `spec.md` and `design.md`).
+- **Spec-driven mode → formalize-only:** use `oat-project-spec` standalone
+  if you want a formalized requirements artifact but aren't ready to
+  design yet.
+- **Quick mode → straight to plan:** proceed directly to `plan.md` when
+  scope is clear and no architecture decisions remain.
+- **Quick mode → optional lightweight design:** produce a focused
+  `design.md` (architecture, components, data flow, testing) before
+  planning. Choose this when discovery surfaced architecture choices
+  or component boundaries.
+- **Quick mode → promote:** escalate to spec-driven if discovery revealed
+  the scope is larger or more complex than expected.

package/dist/commands/config/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/config/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGhF,OAAO,EACL,KAAK,SAAS,EACd,KAAK,cAAc,EAGnB,KAAK,UAAU,EAOhB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAEL,KAAK,cAAc,EAEpB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAqDpC,UAAU,yBAAyB;IACjC,mBAAmB,EAAE,CACnB,OAAO,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,CAAC,CAAC,KAC/C,cAAc,CAAC;IACpB,kBAAkB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,aAAa,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;IACxD,cAAc,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvE,kBAAkB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IAClE,mBAAmB,EAAE,CACnB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,cAAc,KACnB,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,cAAc,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IAC/D,eAAe,EAAE,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9E,mBAAmB,EAAE,CACnB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,CAAC,UAAU,KACnB,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB,sBAAsB,EAAE,CACtB,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EACrB,GAAG,EAAE,MAAM,CAAC,UAAU,KACnB,OAAO,CAAC,cAAc,CAAC,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC;CAC/B;AAwjCD,wBAAgB,mBAAmB,CACjC,SAAS,GAAE,OAAO,CAAC,yBAAyB,CAAM,GACjD,OAAO,CA0GT"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/config/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGhF,OAAO,EACL,KAAK,SAAS,EACd,KAAK,cAAc,EAGnB,KAAK,UAAU,EAOhB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAEL,KAAK,cAAc,EAEpB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwDpC,UAAU,yBAAyB;IACjC,mBAAmB,EAAE,CACnB,OAAO,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,CAAC,CAAC,KAC/C,cAAc,CAAC;IACpB,kBAAkB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,aAAa,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;IACxD,cAAc,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvE,kBAAkB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IAClE,mBAAmB,EAAE,CACnB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,cAAc,KACnB,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,cAAc,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IAC/D,eAAe,EAAE,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9E,mBAAmB,EAAE,CACnB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,CAAC,UAAU,KACnB,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB,sBAAsB,EAAE,CACtB,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EACrB,GAAG,EAAE,MAAM,CAAC,UAAU,KACnB,OAAO,CAAC,cAAc,CAAC,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC;CAC/B;AAwmCD,wBAAgB,mBAAmB,CACjC,SAAS,GAAE,OAAO,CAAC,yBAAyB,CAAM,GACjD,OAAO,CA0GT"}

package/dist/commands/config/index.js

@@ -14,6 +14,8 @@ const KEY_ORDER = [
     'archive.s3SyncOnComplete',
     'archive.summaryExportPath',
     'archive.wrapUpExportPath',
+    'archive.awsProfile',
+    'archive.awsRegion',
     'autoReviewAtCheckpoints',
     'lastPausedProject',
     'documentation.root',
@@ -36,6 +38,7 @@ const KEY_ORDER = [
     'workflow.reviewExecutionModel',
     'workflow.autoReviewAtHillCheckpoints',
     'workflow.autoNarrowReReviewScope',
+    'workflow.designMode',
     'worktrees.root',
 ];
 const CONFIG_CATALOG = [
@@ -171,6 +174,28 @@ const CONFIG_CATALOG = [
         owningCommand: 'oat config set archive.wrapUpExportPath <value>',
         description: 'Repository-relative directory where the oat-wrap-up skill writes date-ranged shipping digests. When unset, the skill falls back to `.oat/repo/reference/wrap-ups`.',
     },
+    {
+        key: 'archive.awsProfile',
+        group: 'Shared Repo (.oat/config.json)',
+        file: '.oat/config.json',
+        scope: 'shared repo',
+        type: 'string',
+        defaultValue: 'unset',
+        mutability: 'read/write',
+        owningCommand: 'oat config set archive.awsProfile <value>',
+        description: 'AWS named profile forwarded as AWS_PROFILE to every `aws` invocation made by the archive S3 sync (completion + `oat project archive sync`). Precedence: per-invocation flag > existing shell env > this config value.',
+    },
+    {
+        key: 'archive.awsRegion',
+        group: 'Shared Repo (.oat/config.json)',
+        file: '.oat/config.json',
+        scope: 'shared repo',
+        type: 'string',
+        defaultValue: 'unset',
+        mutability: 'read/write',
+        owningCommand: 'oat config set archive.awsRegion <value>',
+        description: 'AWS region forwarded as AWS_REGION to every `aws` invocation made by the archive S3 sync (completion + `oat project archive sync`). Precedence: per-invocation flag > existing shell env > this config value.',
+    },
     {
         key: 'tools.core',
         group: 'Shared Repo (.oat/config.json)',
@@ -369,6 +394,17 @@ const CONFIG_CATALOG = [
         owningCommand: 'oat config set workflow.autoNarrowReReviewScope <true|false>',
         description: 'Auto-narrow re-review scope to fix-task commits in oat-project-review-provide when re-reviewing completed fix tasks. Has no effect on initial reviews (there is nothing to narrow to). When unset, the skill prompts. Resolution: env > local > shared > user > default.',
     },
+    {
+        key: 'workflow.designMode',
+        group: 'Workflow Preferences (3-layer: local > shared > user)',
+        file: '.oat/config.local.json | .oat/config.json | ~/.oat/config.json',
+        scope: 'workflow',
+        type: 'collaborative | selective | draft',
+        defaultValue: 'unset',
+        mutability: 'read/write',
+        owningCommand: 'oat config set workflow.designMode <value>',
+        description: 'Persisted preference for oat-project-design: "collaborative" runs every section section-by-section, "selective" drafts routine sections silently and live-reviews high-risk sections, and "draft" drafts the full design up front for holistic review. Quick-start lightweight design supports collaborative/draft only and treats selective as collaborative when encountered. When unset, the skill prompts. Runtime signals (OAT_NON_INTERACTIVE=1, no TTY) always outrank this preference. Resolution: arg > env > non-interactive context > local > shared > user > default.',
+    },
     {
         key: 'sync.defaultStrategy',
         group: 'Sync/Provider (.oat/sync/config.json)',
@@ -430,6 +466,7 @@ const WORKFLOW_ENUM_VALUES = {
     'workflow.hillCheckpointDefault': ['every', 'final'],
     'workflow.postImplementSequence': ['wait', 'summary', 'pr', 'docs-pr'],
     'workflow.reviewExecutionModel': ['subagent', 'inline', 'fresh-session'],
+    'workflow.designMode': ['collaborative', 'selective', 'draft'],
 };
 const WORKFLOW_BOOLEAN_KEYS = new Set([
     'workflow.archiveOnComplete',
@@ -642,6 +679,16 @@ async function setConfigValue(repoRoot, userConfigDir, key, rawValue, surface, d
         else if (key === 'archive.wrapUpExportPath') {
             archive.wrapUpExportPath = normalizeSharedRoot(rawValue);
         }
+        else if (key === 'archive.awsProfile' || key === 'archive.awsRegion') {
+            const subKey = key.slice('archive.'.length);
+            const trimmed = rawValue.trim();
+            if (trimmed === '') {
+                delete archive[subKey];
+            }
+            else {
+                archive[subKey] = trimmed;
+            }
+        }
         await dependencies.writeOatConfig(repoRoot, {
             ...config,
             archive,

package/dist/commands/project/archive/archive-utils.d.ts

@@ -11,6 +11,23 @@ export interface EnsureS3ArchiveAccessOptions {
     mode: 'completion' | 'sync';
     s3Uri?: string | null;
     syncOnComplete: boolean;
+    /**
+     * Config-only fallback AWS profile (e.g., `archive.awsProfile`). This helper
+     * applies the value only when the parent env does not already provide
+     * `AWS_PROFILE`, matching discovery decision #3 ("config does not clobber an
+     * explicit shell env"). Callers that override via flags must layer the
+     * override into `dependencies.env` (the helper's second argument) —
+     * `buildAwsEnv` is non-clobbering and will not overwrite a value already
+     * present in the parent env. Passing a flag value through this option alone
+     * is not sufficient.
+     */
+    awsProfile?: string | null;
+    /**
+     * Config-only fallback AWS region. Same non-clobbering semantics as
+     * `awsProfile`: flag-style overrides must be layered into
+     * `dependencies.env`, not passed through this option.
+     */
+    awsRegion?: string | null;
 }
 interface EnsureS3ArchiveAccessDependencies {
     execFile?: ExecFileLike;
@@ -28,6 +45,17 @@ export interface ArchiveProjectOnCompletionOptions {
     s3Uri?: string | null;
     s3SyncOnComplete: boolean;
     summaryExportPath?: string | null;
+    /**
+     * Config-only AWS profile (`archive.awsProfile`). The completion path has no
+     * flag override; this value is forwarded as-is into the env merge, where the
+     * parent env wins if it already supplies `AWS_PROFILE`. Discovery decision #3.
+     */
+    awsProfile?: string | null;
+    /**
+     * Config-only AWS region (`archive.awsRegion`). Same non-clobbering semantics
+     * as `awsProfile`.
+     */
+    awsRegion?: string | null;
 }
 interface ArchiveProjectOnCompletionDependencies extends EnsureS3ArchiveAccessDependencies {
     ensureS3ArchiveAccess?: typeof ensureS3ArchiveAccess;
@@ -60,6 +88,31 @@ export interface ArchiveSnapshotMetadata {
     projectName: string;
     snapshotName: string;
 }
+/**
+ * Build the env passed to every `aws` spawn in this module.
+ *
+ * Non-clobbering merge: a non-empty value in `opts` is applied only when
+ * `parentEnv` does not already provide that key (treating empty/whitespace
+ * parent values as unset). If parent env has a non-empty value, it is left
+ * untouched even when `opts` supplies a non-empty value. Callers that need
+ * flag-style overrides must set the env entry themselves before calling this
+ * helper. This matches discovery decision #3 — config does not clobber an
+ * explicit shell env.
+ *
+ * An empty/whitespace value in `opts` is also treated as unset, and we never
+ * inject a key when neither source supplies one — so the spawned process sees
+ * the same "unset" signal it would have seen without this plumbing.
+ *
+ * Exported as a package-internal helper so the archive sync command (which
+ * also spawns `aws`) can layer flag/env/config precedence and produce the same
+ * env shape without duplicating this logic. This symbol is **not** part of the
+ * public package surface — keep usage limited to files inside
+ * `commands/project/archive/`.
+ */
+export declare function buildAwsEnv(parentEnv: NodeJS.ProcessEnv, opts: {
+    awsProfile?: string | null;
+    awsRegion?: string | null;
+}): NodeJS.ProcessEnv;
 export declare function buildRepoArchiveS3Uri(s3Uri: string, repoRoot: string): string;
 export declare function buildProjectArchiveS3Uri(s3Uri: string, repoRoot: string, projectKey: string): string;
 export declare function buildArchiveSnapshotName(projectName: string, timestamp: string): string;

package/dist/commands/project/archive/archive-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"archive-utils.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/archive/archive-utils.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"archive-utils.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/archive/archive-utils.ts"],"names":[],"mappings":"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"}