@open-agent-toolkit/cli 0.2.59 → 0.2.62

package/assets/skills/oat-project-review-provide/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: oat-project-review-provide
-version: 1.5.4
+version: 1.5.5
 description: Use when the user explicitly asks to review an OAT project — e.g. "review project", "review the project", "run project review", or confirms a previously offered review. Do NOT auto-invoke on completed work alone. Resolves a project review scope and offers before running.
 disable-model-invocation: false
 user-invocable: true
@@ -306,6 +306,7 @@ WORKFLOW_MODE=$(oat project status --project-path "$PROJECT_PATH" --field projec
 - `spec-driven`: `spec.md`, `design.md`, `plan.md`
 - `quick`: `discovery.md`, `plan.md` (`spec.md`/`design.md` optional if present)
 - `import`: `plan.md` (`references/imported-plan.md` recommended, `spec.md`/`design.md` optional)
+- `lite`: `plan.md`, `implementation.md` (`discovery.md`/`spec.md`/`design.md` are absent by design)
 
 **Required for artifact review:**
 
@@ -314,9 +315,10 @@ WORKFLOW_MODE=$(oat project status --project-path "$PROJECT_PATH" --field projec
   - reviewing `spec` requires `discovery.md`
   - reviewing `design` in `spec-driven` mode requires `spec.md`
   - reviewing `design` in `quick/import` mode requires only `discovery.md` (spec is skipped in these modes)
-  - in `quick/import` mode, missing `spec.md` must not be treated as a project review gate failure for `artifact design`; proceed with normal project-scoped review flow, artifact writing, and bookkeeping
+  - in `quick/import` mode (lite has no design artifact), missing `spec.md` must not be treated as a project review gate failure for `artifact design`; proceed with normal project-scoped review flow, artifact writing, and bookkeeping
   - reviewing `plan` in `spec-driven` mode requires `spec.md` + `design.md`
-  - reviewing `plan` in `quick/import` mode may use `discovery.md` and/or `references/imported-plan.md` instead
+  - reviewing `plan` in `quick/import` mode may use `discovery.md` and/or `references/imported-plan.md` instead; lite uses the separate rule below
+  - reviewing `plan` in `lite` mode requires only `plan.md`; its Summary, Decisions, Assumptions, Out of Scope, and Validation Criteria sections are the complete upstream contract
 
 **If missing:** Report missing required artifacts for the current mode and stop if requirements are not met.
 
@@ -502,6 +504,8 @@ case "$SCOPE_TOKEN" in
       FILES_CHANGED=$(printf "%s\n" "$PROJECT_PATH/plan.md" "$PROJECT_PATH/spec.md" "$PROJECT_PATH/design.md")
     elif [[ "$WORKFLOW_MODE" == "quick" ]]; then
       FILES_CHANGED=$(printf "%s\n" "$PROJECT_PATH/plan.md" "$PROJECT_PATH/discovery.md")
+    elif [[ "$WORKFLOW_MODE" == "lite" ]]; then
+      FILES_CHANGED=$(printf "%s\n" "$PROJECT_PATH/plan.md")
     else
       FILES_CHANGED=$(printf "%s\n" "$PROJECT_PATH/plan.md" "$PROJECT_PATH/references/imported-plan.md")
     fi
@@ -581,10 +585,12 @@ Build the "Review Scope" metadata for the reviewer:
 **Scope:** {scope}{optional: " (" + SCOPE_RANGE + ")"}
 **Date:** {today}
 
+- Workflow mode: {WORKFLOW_MODE}
+
 **Artifact Paths:**
 
-- Spec: {PROJECT_PATH}/spec.md (required in spec-driven mode; optional in quick/import)
-- Design: {PROJECT_PATH}/design.md (required in spec-driven mode; optional in quick/import)
+- Spec: {PROJECT_PATH}/spec.md (required in spec-driven mode; optional in quick/import/lite)
+- Design: {PROJECT_PATH}/design.md (required in spec-driven mode; optional in quick/import/lite)
 - Plan: {PROJECT_PATH}/plan.md
 - Implementation: {PROJECT_PATH}/implementation.md
 - Discovery: {PROJECT_PATH}/discovery.md
@@ -622,6 +628,19 @@ Build the "Review Scope" metadata for the reviewer:
 - Do not force a code-defect framing for accepted design drift; `oat-project-review-receive` can convert artifact drift into alignment tasks or explicit deferrals.
 ```
 
+For `WORKFLOW_MODE=lite`, render the artifact-path portion of every artifact-plan
+and code-final Review Scope explicitly as:
+
+- Discovery: not required (absent by design)
+- Spec: not required (absent by design)
+- Design: not required (absent by design)
+- Import reference: not required
+- Plan: `{PROJECT_PATH}/plan.md` (Summary, Decisions, Assumptions, Out of Scope, and Validation Criteria are the requirements contract)
+- Implementation: `{PROJECT_PATH}/implementation.md`
+
+Always pass the resolved workflow mode. Never omit it and let the reviewer fall
+back to its spec-driven default.
+
 ### Step 6: Execute Review (3-Tier Capability Model)
 
 **Canonical reviewer instructions:** Before a direct reviewer-definition read or
@@ -944,7 +963,7 @@ If running inline (Tier 3), execute the review and write artifact.
 **Review checklist (from oat-reviewer):**
 
 1. Verify scope (don't review out-of-scope changes)
-2. If code review: verify alignment to available requirements sources (`spec`/`design` for spec-driven mode; `discovery`/import reference for quick/import)
+2. If code review: verify alignment to available requirements sources (`spec`/`design` for spec-driven mode; `discovery`/import reference for quick/import; plan.md Summary, Decisions, Assumptions, Out of Scope, and Validation Criteria for lite)
 3. If code review: verify code quality (correctness, tests, security, maintainability)
 4. If artifact review: verify completeness/clarity/readiness of the artifact and its alignment with upstream artifacts
 5. Categorize findings (Critical/Important/Medium/Minor)

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

@@ -1,6 +1,6 @@
 ---
 name: oat-project-summary
-version: 1.5.1
+version: 1.5.2
 description: Use when the user requests or confirms summarizing an active OAT project — e.g. "summarize the project", "generate the summary", "run oat-project-summary", or confirms a previously offered summary run. Do NOT auto-invoke when implementation completes. Generates summary.md from project artifacts as institutional memory.
 disable-model-invocation: false
 user-invocable: true
@@ -117,7 +117,16 @@ test -f "$PROJECT_PATH/implementation.md"
 
 ### Step 2: Read Project Artifacts
 
-Read all available artifacts for synthesis:
+For `oat_workflow_mode: lite`, use the reduced artifact contract and skip the
+ordinary artifact list below. Read the five `plan.md` sections `Summary`,
+`Decisions`, `Assumptions`, `Out of Scope`, and `Validation Criteria`, then read
+`implementation.md` for task outcomes and the shipped results in `Final
+Summary (for PR/docs)`. Read `state.md` only for routing metadata. A lite
+project accepts `discovery.md`, `spec.md`, and `design.md` as absent; do not
+read or require them. Ground the summary in what actually shipped, with
+`implementation.md` taking precedence over the plan.
+
+For every other workflow mode, read all available artifacts for synthesis:
 
 - `"$PROJECT_PATH/discovery.md"` — initial request, decisions, constraints
 - `"$PROJECT_PATH/spec.md"` — requirements, goals (optional — may not exist in quick mode)
@@ -213,7 +222,22 @@ For each section, synthesize content from the relevant artifacts. Apply these ru
 
 **Minimum viable summary:** Overview + What Was Implemented + Key Decisions. All other sections are included only when they have content worth preserving.
 
-**Section sources:**
+**Lite section sources:**
+
+Use this table only for `oat_workflow_mode: lite`. It maps every canonical lite
+plan section and shipped implementation results without requiring discovery,
+spec, or design artifacts.
+
+| Summary Section      | Primary Lite Sources                                          |
+| -------------------- | ------------------------------------------------------------- |
+| Overview             | plan.md `Summary`; implementation.md `Final Summary`          |
+| What Was Implemented | implementation.md shipped results and task outcomes           |
+| Key Decisions        | plan.md `Decisions`; implementation.md accepted decisions     |
+| Tradeoffs Made       | plan.md `Assumptions`; implementation.md decisions            |
+| Follow-up Items      | plan.md `Out of Scope`; implementation.md deferred results    |
+| Integration Notes    | plan.md `Validation Criteria`; implementation.md test results |
+
+**Non-lite section sources:**
 
 | Section                        | Primary Sources                                                        |
 | ------------------------------ | ---------------------------------------------------------------------- |

package/assets/templates/plan-lite.md

@@ -0,0 +1,165 @@
+---
+oat_status: in_progress
+oat_ready_for: null
+oat_blockers: []
+oat_last_updated: YYYY-MM-DD
+oat_phase: plan
+oat_phase_status: in_progress
+oat_plan_hill_phases: []
+oat_plan_parallel_groups: []
+oat_plan_source: lite
+oat_import_reference: null
+oat_import_source_path: null
+oat_import_provider: null
+oat_generated: false
+oat_template: true
+oat_template_name: plan-lite
+---
+
+# Lite Plan: {Project Name}
+
+**Goal:** [State the outcome this single-sitting change must achieve.]
+
+## Summary
+
+[Summarize the requested behavior and the smallest coherent implementation.]
+
+## Decisions
+
+- **Content shape:** `[minimal | product | technical | both]` — [One-line rationale tied to the observable shape triggers.]
+- [Record the other decisions made during the critical interview.]
+
+## Product Behavior
+
+<!-- Include for product or both; omit this section for minimal or technical. -->
+
+1. **[Observable behavior]** — [State the testable user-visible outcome.]
+
+## Technical Design
+
+<!-- Include for technical or both; omit this section for minimal or product. -->
+
+- **Current operation:** [Describe how the affected modules and contracts work now.]
+- **Proposed changes:** [Describe the change with file-and-symbol references, not line numbers.]
+- **Data flow:** [When state or data crosses a boundary, describe its path and transformations. Omit this item otherwise.]
+
+## Assumptions
+
+- [Record assumptions the implementation and validation depend on.]
+
+## Out of Scope
+
+- [Name adjacent work intentionally excluded from this change.]
+
+## Validation Criteria
+
+- [ ] [Observable criterion] — Check: `[exact verification command]`
+- [ ] [Observable criterion] — Check: `[exact verification command]`
+
+## Parallelism
+
+This plan has one phase and executes sequentially.
+
+## Phase 1: [Phase Name]
+
+### Task p01-t01: [Task Name]
+
+**Files:**
+
+- Create: `[path/to/file.ts]`
+- Modify: `[path/to/existing.ts]`
+
+**Implementation and Proof Strategy:**
+
+- **Strategy:** `[test-first | characterization-first | implementation-then-regression | static-or-build | manual-or-visual]`
+- **Observable risk:** [Name the behavior, contract, or invariant this evidence covers.]
+- **Why proportionate:** [Explain why this is the smallest proof capable of detecting the relevant failure.]
+
+**Step 1: Implement**
+
+[Describe the bounded implementation in the order required by the selected strategy.]
+
+**Step 2: Prove**
+
+Run: `[exact proof command or manual: instruction]`
+Expected: [State the observable passing result and, for behavior changes, how this proof fails without the change.]
+
+**Step 3: Refactor and format**
+
+[Describe bounded cleanup and name the exact write-mode formatting command.]
+
+**Step 4: Verify**
+
+Run: `[exact task verification command]`
+Expected: No errors
+
+**Step 5: Commit**
+
+```bash
+git add [task files]
+git commit -m "feat(p01-t01): [description]"
+```
+
+---
+
+### Task p01-t02: [Task Name]
+
+**Files:**
+
+- Modify: `[path/to/existing.ts]`
+
+**Implementation and Proof Strategy:**
+
+- **Strategy:** `[test-first | characterization-first | implementation-then-regression | static-or-build | manual-or-visual]`
+- **Observable risk:** [Name the behavior, contract, or invariant this evidence covers.]
+- **Why proportionate:** [Explain why this is the smallest proof capable of detecting the relevant failure.]
+
+**Step 1: Implement**
+
+[Describe the bounded implementation in the order required by the selected strategy.]
+
+**Step 2: Prove**
+
+Run: `[exact proof command or manual: instruction]`
+Expected: [State the observable passing result and, for behavior changes, how this proof fails without the change.]
+
+**Step 3: Refactor and format**
+
+[Describe bounded cleanup and name the exact write-mode formatting command.]
+
+**Step 4: Verify**
+
+Run: `[exact task verification command]`
+Expected: No errors
+
+**Step 5: Commit**
+
+```bash
+git add [task files]
+git commit -m "feat(p01-t02): [description]"
+```
+
+---
+
+## Reviews
+
+| Scope  | Type     | Status  | Date | Artifact | Reviewed Head | Invocation | Gate Target |
+| ------ | -------- | ------- | ---- | -------- | ------------- | ---------- | ----------- |
+| p01    | code     | pending | -    | -        | -             | -          | -           |
+| final  | code     | pending | -    | -        | -             | -          | -           |
+| spec   | artifact | pending | -    | -        | -             | -          | -           |
+| design | artifact | pending | -    | -        | -             | -          | -           |
+
+## Implementation Complete
+
+**Summary:**
+
+- Phase 1: [N] tasks — [Description]
+
+**Total: [N] tasks**
+
+Ready for final code review and PR preparation.
+
+## References
+
+- Imported Source: `references/imported-plan.md` (when imported provenance applies)

package/assets/templates/plan.md

@@ -7,7 +7,7 @@ oat_phase: plan
 oat_phase_status: in_progress
 oat_plan_hill_phases: [] # phases to pause AFTER completing (empty = every phase)
 oat_plan_parallel_groups: [] # groups of phases that run concurrently in worktrees; [] = fully sequential
-oat_plan_source: spec-driven # spec-driven | quick | imported
+oat_plan_source: spec-driven # spec-driven | quick | imported | lite
 oat_import_reference: null # e.g., references/imported-plan.md
 oat_import_source_path: null # original source path provided by user
 oat_import_provider: null # codex | cursor | claude | null

package/assets/templates/state.md

@@ -34,7 +34,7 @@ oat_phase_status: in_progress # Status: in_progress | complete | pr_open
 #         - { harness: cursor, model: gpt-5.5-xhigh }
 #   source: project-state
 # oat_dispatch_ceiling: # legacy compatibility alias for capped managed provider targets
-oat_workflow_mode: { OAT_WORKFLOW_MODE } # spec-driven | quick | import
+oat_workflow_mode: { OAT_WORKFLOW_MODE } # spec-driven | quick | import | lite
 oat_workflow_origin: native # native | imported
 # oat_skill_gate_overrides: # optional; per-project posture for configured lifecycle gates
 #   oat-project-implement: disabled # only the literal value `disabled`; absence means follow configuration

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/project/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAuBpC,wBAAgB,oBAAoB,IAAI,OAAO,CAuB9C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/project/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwBpC,wBAAgB,oBAAoB,IAAI,OAAO,CAwB9C"}

package/dist/commands/project/index.js

@@ -11,6 +11,7 @@ import { createProjectMigrateCommand } from './migrate/index.js';
 import { createProjectNewCommand } from './new/index.js';
 import { createProjectOpenCommand } from './open/index.js';
 import { createProjectPauseCommand } from './pause/index.js';
+import { createProjectPromoteCommand } from './promote/index.js';
 import { createProjectPruneCommand } from './prune/index.js';
 import { createProjectPullCommand } from './pull/index.js';
 import { createProjectPushCommand } from './push/index.js';
@@ -34,6 +35,7 @@ export function createProjectCommand() {
         .addCommand(createProjectNewCommand())
         .addCommand(createProjectOpenCommand())
         .addCommand(createProjectPauseCommand())
+        .addCommand(createProjectPromoteCommand())
         .addCommand(createProjectPruneCommand())
         .addCommand(createProjectPushCommand())
         .addCommand(createProjectPullCommand())

package/dist/commands/project/new/index.d.ts

@@ -1,13 +1,14 @@
 import { type CommandContext, type GlobalOptions } from '../../../app/command-context.js';
 import { type ProjectScope } from '../../shared/project-scope.js';
+import { type WorkflowMode } from '@open-agent-toolkit/control-plane';
 import { Command } from 'commander';
-import { type ProjectScaffoldMode, type ScaffoldProjectResult } from './scaffold.js';
+import { type ScaffoldProjectResult } from './scaffold.js';
 interface ProjectNewDependencies {
     buildCommandContext: (options: GlobalOptions) => CommandContext;
     scaffoldProject: (options: {
         repoRoot: string;
         projectName: string;
-        mode: ProjectScaffoldMode;
+        mode: WorkflowMode;
         force: boolean;
         setActive: boolean;
         refreshDashboard: boolean;

package/dist/commands/project/new/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/new/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAEL,KAAK,YAAY,EAClB,MAAM,gCAAgC,CAAC;AAGxC,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAE5C,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC3B,MAAM,YAAY,CAAC;AAmBpB,UAAU,sBAAsB;IAC9B,mBAAmB,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,cAAc,CAAC;IAChE,eAAe,EAAE,CAAC,OAAO,EAAE;QACzB,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,mBAAmB,CAAC;QAC1B,KAAK,EAAE,OAAO,CAAC;QACf,SAAS,EAAE,OAAO,CAAC;QACnB,gBAAgB,EAAE,OAAO,CAAC;QAC1B,MAAM,EAAE,OAAO,CAAC;QAChB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,KAAK,CAAC,EAAE,YAAY,CAAC;KACtB,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAC;CACtC;AAmGD,wBAAgB,uBAAuB,CACrC,SAAS,GAAE,OAAO,CAAC,sBAAsB,CAAM,GAC9C,OAAO,CAgDT"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/new/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAEL,KAAK,YAAY,EAClB,MAAM,gCAAgC,CAAC;AAGxC,OAAO,EAEL,KAAK,YAAY,EAClB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAE5C,OAAO,EAEL,KAAK,qBAAqB,EAC3B,MAAM,YAAY,CAAC;AAmBpB,UAAU,sBAAsB;IAC9B,mBAAmB,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,cAAc,CAAC;IAChE,eAAe,EAAE,CAAC,OAAO,EAAE;QACzB,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,YAAY,CAAC;QACnB,KAAK,EAAE,OAAO,CAAC;QACf,SAAS,EAAE,OAAO,CAAC;QACnB,gBAAgB,EAAE,OAAO,CAAC;QAC1B,MAAM,EAAE,OAAO,CAAC;QAChB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,KAAK,CAAC,EAAE,YAAY,CAAC;KACtB,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAC;CACtC;AAmGD,wBAAgB,uBAAuB,CACrC,SAAS,GAAE,OAAO,CAAC,sBAAsB,CAAM,GAC9C,OAAO,CAgDT"}

package/dist/commands/project/new/index.js

@@ -2,6 +2,7 @@ import { buildCommandContext, } from '../../../app/command-context.js';
 import { PROJECT_SCOPES, } from '../../shared/project-scope.js';
 import { readGlobalOptions } from '../../shared/shared.utils.js';
 import { CliError } from '../../../errors/cli-error.js';
+import { WORKFLOW_MODES, } from '@open-agent-toolkit/control-plane';
 import { Command, Option } from 'commander';
 import { scaffoldProject as defaultScaffoldProject, } from './scaffold.js';
 const COMMIT_STATUS_MESSAGES = {
@@ -98,7 +99,7 @@ export function createProjectNewCommand(overrides = {}) {
         .description('Create or update an OAT project scaffold')
         .argument('<name>', 'Project name (letters, numbers, dash, underscore)')
         .addOption(new Option('--mode <mode>', 'Scaffold mode')
-        .choices(['spec-driven', 'quick', 'import'])
+        .choices([...WORKFLOW_MODES])
         .default('spec-driven'))
         .addOption(new Option('--scope <scope>', 'Project scope').choices(PROJECT_SCOPES))
         .option('--force', 'Allow a duplicate slug in another scope; scaffold remains non-destructive')

package/dist/commands/project/new/scaffold.d.ts

@@ -4,12 +4,12 @@ import { writeSyncedRecord } from '../../project/sync/record.js';
 import { commitRecordChange, createSyncedProject, pushSynced, rollbackCreatedSyncedProject } from '../../project/sync/ref-sync.js';
 import { resolveDefaultScope, type ProjectScope } from '../../shared/project-scope.js';
 import { setActiveProject } from '../../../config/oat-config.js';
-export type ProjectScaffoldMode = 'spec-driven' | 'quick' | 'import';
+import type { WorkflowMode } from '@open-agent-toolkit/control-plane';
 export interface ScaffoldProjectOptions {
     repoRoot: string;
     projectName: string;
     scope?: ProjectScope;
-    mode?: ProjectScaffoldMode;
+    mode?: WorkflowMode;
     force?: boolean;
     setActive?: boolean;
     refreshDashboard?: boolean;
@@ -34,7 +34,7 @@ export interface ScaffoldProjectOptions {
  */
 export type CommitScaffoldStatus = 'committed' | 'skipped_disabled' | 'skipped_no_worktree' | 'skipped_nothing' | 'failed';
 export interface ScaffoldProjectResult {
-    mode: ProjectScaffoldMode;
+    mode: WorkflowMode;
     scope: ProjectScope;
     projectsRoot: string;
     projectPath: string;
@@ -60,5 +60,7 @@ export interface ScaffoldProjectDependencies {
     ensureScopedRootGitignore: typeof ensureScopedRootGitignore;
     setActiveProject: typeof setActiveProject;
 }
+export declare function applyTemplateReplacements(template: string, projectName: string, today: string, nowUtc: string, mode: WorkflowMode): string;
+export declare function resolveTemplateSource(userOatRoot: string, repoRoot: string, templateFile: string): Promise<string>;
 export declare function scaffoldProject(options: ScaffoldProjectOptions, overrides?: Partial<ScaffoldProjectDependencies>): Promise<ScaffoldProjectResult>;
 //# sourceMappingURL=scaffold.d.ts.map

package/dist/commands/project/new/scaffold.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/new/scaffold.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAErE,OAAO,EAAoB,KAAK,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAC9E,OAAO,EAEL,iBAAiB,EAClB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAEL,kBAAkB,EAClB,mBAAmB,EACnB,UAAU,EACV,4BAA4B,EAC7B,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EAGL,mBAAmB,EAGnB,KAAK,YAAY,EAClB,MAAM,gCAAgC,CAAC;AAExC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAOtD,MAAM,MAAM,mBAAmB,GAAG,aAAa,GAAG,OAAO,GAAG,QAAQ,CAAC;AAErE,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,IAAI,CAAC,EAAE,mBAAmB,CAAC;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wBAAwB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvE;AAED;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAC5B,WAAW,GACX,kBAAkB,GAClB,qBAAqB,GACrB,iBAAiB,GACjB,QAAQ,CAAC;AAEb,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,mBAAmB,CAAC;IAC1B,KAAK,EAAE,YAAY,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,oBAAoB,CAAC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,2BAA2B;IAC1C,mBAAmB,EAAE,OAAO,mBAAmB,CAAC;IAChD,SAAS,EAAE,SAAS,CAAC;IACrB,mBAAmB,EAAE,OAAO,mBAAmB,CAAC;IAChD,UAAU,EAAE,OAAO,UAAU,CAAC;IAC9B,kBAAkB,EAAE,OAAO,kBAAkB,CAAC;IAC9C,4BAA4B,EAAE,OAAO,4BAA4B,CAAC;IAClE,iBAAiB,EAAE,OAAO,iBAAiB,CAAC;IAC5C,yBAAyB,EAAE,OAAO,yBAAyB,CAAC;IAC5D,gBAAgB,EAAE,OAAO,gBAAgB,CAAC;CAC3C;AA6bD,wBAAsB,eAAe,CACnC,OAAO,EAAE,sBAAsB,EAC/B,SAAS,GAAE,OAAO,CAAC,2BAA2B,CAAM,GACnD,OAAO,CAAC,qBAAqB,CAAC,CAsXhC"}
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/new/scaffold.ts"],"names":[],"mappings":"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"}

package/dist/commands/project/new/scaffold.js

@@ -37,7 +37,15 @@ const TEMPLATES_BY_MODE = {
     ],
     quick: ['state.md', 'discovery.md', 'plan.md', 'implementation.md'],
     import: ['state.md', 'plan.md', 'implementation.md'],
+    lite: [
+        'state.md',
+        { source: 'plan-lite.md', target: 'plan.md' },
+        'implementation.md',
+    ],
 };
+function normalizeTemplateEntry(entry) {
+    return typeof entry === 'string' ? { source: entry, target: entry } : entry;
+}
 const OAT_PLACEHOLDER_PATTERN = /(?<!\{)\{\s*(OAT_[A-Z0-9_]+)\s*\}(?!\})/g;
 const STATE_TEMPLATE_BY_MODE = {
     'spec-driven': {
@@ -97,6 +105,22 @@ const STATE_TEMPLATE_BY_MODE = {
         ],
         nextMilestone: 'Run `oat-project-import-plan` to normalize the external plan',
     },
+    lite: {
+        hillCheckpoints: '[]',
+        phase: 'plan',
+        status: 'Plan',
+        currentPhase: 'Plan - Authoring a single-phase lite plan',
+        artifacts: [
+            '- **Plan:** `plan.md` (scaffolded lite template — not started)',
+            '- **Implementation:** `implementation.md` (scaffolded template — not started)',
+        ],
+        progress: [
+            '- ✓ Lite project scaffolded',
+            '- ✓ Plan and implementation artifacts scaffolded',
+            '- ⧗ Awaiting critical interview and plan authoring',
+        ],
+        nextMilestone: 'Run `oat-project-lite` to author and approve the plan',
+    },
 };
 function replaceOatPlaceholders(template, replacements) {
     return template.replace(OAT_PLACEHOLDER_PATTERN, (placeholder, token) => replacements[token] ?? placeholder);
@@ -120,7 +144,7 @@ function validateProjectName(name) {
 function shellQuote(value) {
     return `'${value.replaceAll("'", "'\\''")}'`;
 }
-function applyTemplateReplacements(template, projectName, today, nowUtc, mode) {
+export function applyTemplateReplacements(template, projectName, today, nowUtc, mode) {
     const stateContent = STATE_TEMPLATE_BY_MODE[mode];
     const oatReplacements = {
         OAT_HILL_CHECKPOINTS: stateContent.hillCheckpoints,
@@ -185,21 +209,25 @@ async function commitScaffold(cwd, absoluteProjectPath, projectName, createdFile
 async function scaffoldModeTemplates(userOatRoot, repoRoot, absoluteProjectPath, projectName, mode, today, nowUtc) {
     const createdFiles = [];
     const skippedFiles = [];
-    for (const templateFile of TEMPLATES_BY_MODE[mode]) {
-        const src = await resolveTemplateSource(userOatRoot, repoRoot, templateFile);
-        const dest = join(absoluteProjectPath, templateFile);
+    for (const entry of TEMPLATES_BY_MODE[mode]) {
+        const { source, target } = normalizeTemplateEntry(entry);
+        const src = await resolveTemplateSource(userOatRoot, repoRoot, source);
+        const dest = join(absoluteProjectPath, target);
         if (await fileExists(dest)) {
-            skippedFiles.push(templateFile);
+            skippedFiles.push(target);
             continue;
         }
         const template = await readFile(src, 'utf8');
-        const rendered = applyTemplateReplacements(template, projectName, today, nowUtc, mode);
-        assertNoUnresolvedOatPlaceholders(rendered, templateFile);
-        if (templateFile === 'state.md') {
+        let rendered = applyTemplateReplacements(template, projectName, today, nowUtc, mode);
+        if (mode === 'lite' && target === 'plan.md') {
+            rendered = rendered.replace(/^---\n/, '---\noat_template: true\n');
+        }
+        assertNoUnresolvedOatPlaceholders(rendered, source);
+        if (target === 'state.md') {
             assertValidProjectStateContent(rendered, { filePath: dest });
         }
         await writeFile(dest, rendered, 'utf8');
-        createdFiles.push(templateFile);
+        createdFiles.push(target);
     }
     return { createdFiles, skippedFiles };
 }
@@ -214,7 +242,7 @@ async function scaffoldProjectLog(userOatRoot, repoRoot, absoluteProjectPath, pr
     await writeFile(dest, instantiateProjectLogTemplate(template, projectName, today), 'utf8');
     return 'created';
 }
-async function resolveTemplateSource(userOatRoot, repoRoot, templateFile) {
+export async function resolveTemplateSource(userOatRoot, repoRoot, templateFile) {
     const userSource = join(userOatRoot, 'templates', templateFile);
     if (await fileExists(userSource)) {
         return userSource;

package/dist/commands/project/promote/index.d.ts

@@ -0,0 +1,2 @@
+export { createProjectPromoteCommand } from './promote.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/project/promote/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/promote/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,WAAW,CAAC"}

package/dist/commands/project/promote/index.js

@@ -0,0 +1 @@
+export { createProjectPromoteCommand } from './promote.js';

package/dist/commands/project/promote/promote.d.ts

@@ -0,0 +1,47 @@
+import { mkdir as defaultMkdir, readFile as defaultReadFile, rename as defaultRename, writeFile as defaultWriteFile } from 'node:fs/promises';
+import { type CommandContext, type GlobalOptions } from '../../../app/command-context.js';
+import { resolveTemplateSource as defaultResolveTemplateSource } from '../../project/new/scaffold.js';
+import { type GitRunner } from '../../project/sync/git.js';
+import { type PushResult, type SyncTarget } from '../../project/sync/ref-sync.js';
+import { fileExists as defaultFileExists } from '../../../fs/io.js';
+import { Command } from 'commander';
+export interface LitePlanSections {
+    summary: string;
+    decisions: string;
+    assumptions: string;
+    outOfScope: string;
+    validationCriteria: string;
+    productBehavior?: string;
+    technicalDesign?: string;
+}
+type PromotionReason = 'promoted' | 'unsupported-target' | 'not-lite' | 'lite-plan-reference-exists' | 'invalid-lite-plan' | 'scope-unresolved' | 'project-unreadable' | 'template-unreadable' | 'write-failed' | 'persistence-failed';
+export type PromotionResult = {
+    status: 'promoted';
+    reason: 'promoted';
+    files: string[];
+} | {
+    status: 'refused';
+    reason: Exclude<PromotionReason, 'promoted'>;
+    files: string[];
+};
+export interface ProjectPromoteDependencies {
+    buildCommandContext: (options: GlobalOptions) => CommandContext;
+    resolveProjectRoot: (cwd: string) => Promise<string>;
+    resolveProjectsRoot: (repoRoot: string, env: NodeJS.ProcessEnv) => Promise<string>;
+    resolveTemplateSource: typeof defaultResolveTemplateSource;
+    readFile: typeof defaultReadFile;
+    writeFile: typeof defaultWriteFile;
+    mkdir: typeof defaultMkdir;
+    rename: typeof defaultRename;
+    fileExists: typeof defaultFileExists;
+    gitRunner: GitRunner;
+    pushSynced: (target: SyncTarget, git: GitRunner, options: {
+        message?: string;
+    }) => Promise<PushResult>;
+    processEnv: NodeJS.ProcessEnv;
+    now: () => Date;
+}
+export declare function parseLitePlanSections(planContent: string, liteTemplateContent?: string): LitePlanSections | null;
+export declare function createProjectPromoteCommand(overrides?: Partial<ProjectPromoteDependencies>): Command;
+export {};
+//# sourceMappingURL=promote.d.ts.map

package/dist/commands/project/promote/promote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promote.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/promote/promote.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,IAAI,YAAY,EACrB,QAAQ,IAAI,eAAe,EAC3B,MAAM,IAAI,aAAa,EACvB,SAAS,IAAI,gBAAgB,EAC9B,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAEL,qBAAqB,IAAI,4BAA4B,EACtD,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAoB,KAAK,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAC9E,OAAO,EAGL,KAAK,UAAU,EACf,KAAK,UAAU,EAChB,MAAM,iCAAiC,CAAC;AAMzC,OAAO,EAAE,UAAU,IAAI,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAEzD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkBpC,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,KAAK,eAAe,GAChB,UAAU,GACV,oBAAoB,GACpB,UAAU,GACV,4BAA4B,GAC5B,mBAAmB,GACnB,kBAAkB,GAClB,oBAAoB,GACpB,qBAAqB,GACrB,cAAc,GACd,oBAAoB,CAAC;AAEzB,MAAM,MAAM,eAAe,GACvB;IACE,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,GACD;IACE,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC,eAAe,EAAE,UAAU,CAAC,CAAC;IAC7C,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AAMN,MAAM,WAAW,0BAA0B;IACzC,mBAAmB,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,cAAc,CAAC;IAChE,kBAAkB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,mBAAmB,EAAE,CACnB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,CAAC,UAAU,KACnB,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB,qBAAqB,EAAE,OAAO,4BAA4B,CAAC;IAC3D,QAAQ,EAAE,OAAO,eAAe,CAAC;IACjC,SAAS,EAAE,OAAO,gBAAgB,CAAC;IACnC,KAAK,EAAE,OAAO,YAAY,CAAC;IAC3B,MAAM,EAAE,OAAO,aAAa,CAAC;IAC7B,UAAU,EAAE,OAAO,iBAAiB,CAAC;IACrC,SAAS,EAAE,SAAS,CAAC;IACrB,UAAU,EAAE,CACV,MAAM,EAAE,UAAU,EAClB,GAAG,EAAE,SAAS,EACd,OAAO,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,KAC1B,OAAO,CAAC,UAAU,CAAC,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC;IAC9B,GAAG,EAAE,MAAM,IAAI,CAAC;CACjB;AA4ED,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,EACnB,mBAAmB,CAAC,EAAE,MAAM,GAC3B,gBAAgB,GAAG,IAAI,CAYzB;AA0SD,wBAAgB,2BAA2B,CACzC,SAAS,GAAE,OAAO,CAAC,0BAA0B,CAAM,GAClD,OAAO,CA+BT"}