@open-agent-toolkit/cli 0.1.72 → 0.1.73

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

@@ -1,10 +1,10 @@
 ---
 name: oat-project-summary
-version: 1.3.2
+version: 1.3.3
 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
-allowed-tools: Read, Write, Bash(git:*), Bash(oat config:*), Bash(oat decision:*), Glob, Grep, AskUserQuestion
+allowed-tools: Read, Write, Bash(git:*), Bash(oat config:*), Bash(oat decision:*), Bash(oat project log:*), Glob, Grep, AskUserQuestion
 ---
 
 # Project Summary
@@ -36,16 +36,17 @@ When executing this skill, provide lightweight progress feedback so the user can
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
 - Before multi-step work, print step indicators, e.g.:
-  - `[1/5] Resolving project + reading artifacts…`
-  - `[2/5] Checking for existing summary…`
-  - `[3/5] Generating / updating summary sections…`
-  - `[4/5] Promoting key decisions to reference/decisions/ (if PJM installed)…`
-  - `[5/5] Committing…`
+  - `[1/6] Resolving project + reading artifacts…`
+  - `[2/6] Checking project log + existing summary…`
+  - `[3/6] Generating / updating summary sections…`
+  - `[4/6] Rolling up project observations…`
+  - `[5/6] Promoting key decisions to reference/decisions/ (if PJM installed)…`
+  - `[6/6] Committing…`
 
 **BLOCKED Activities:**
 
 - ❌ No implementation work
-- ❌ No changing project artifacts (other than summary.md)
+- ❌ No hand-editing project artifacts (other than summary.md)
 - ❌ No creating tasks or modifying plan
 - ❌ No hand-authoring decision files or editing `reference/decisions/index.md` inside its managed markers
 
@@ -53,6 +54,10 @@ When executing this skill, provide lightweight progress feedback so the user can
 
 - ✅ Reading all project artifacts
 - ✅ Creating or updating summary.md
+- ✅ Using `oat project log append` and `oat project log rollup` as the only
+  writers for project-log promotion and roll-up
+- ✅ Offering follow-up-marked project-log entries to
+  `oat-pjm-add-backlog-item`
 - ✅ Committing summary.md changes
 - ✅ Promoting the summary's Key Decisions into canonical `reference/decisions/` records via `oat decision new` (Step 7), gated on the PJM tool pack being installed
 
@@ -120,6 +125,8 @@ Read all available artifacts for synthesis:
 - `"$PROJECT_PATH/plan.md"` — phases, tasks, reviews, deferred items
 - `"$PROJECT_PATH/implementation.md"` — task outcomes, deviations, challenges, review notes
 - `"$PROJECT_PATH/state.md"` — associated issues, workflow mode
+- `"$PROJECT_PATH/project-log.md"` — optional append-only workflow
+  observations; never hand-edit
 - `"$PROJECT_PATH/oat-execution-learnings.md"` — optional append-only
   autonomous-run observations and recommendations
 
@@ -128,6 +135,34 @@ Read all available artifacts for synthesis:
 If `oat-execution-learnings.md` is absent, do not infer autonomous learnings
 from other artifacts and do not add an Autonomous Execution Learnings section.
 
+### Step 2.5: Check Project Log and Offer Ledger Graduation
+
+Run the read-only status probe before authoring or refreshing `summary.md`:
+
+```bash
+PROJECT_LOG_CHECK=$(oat project log check --project "$PROJECT_PATH" --json)
+PROJECT_LOG_PROMOTION_APPENDED="false"
+```
+
+Route on the structured result. `status: "absent"` is inert. When the entry
+counts show one or more entries, keep the log in the summary flow even if task,
+revision, and autonomous-learning tracking fields are otherwise current.
+
+Before roll-up, inspect `project`-scoped judgments for observations that are
+reusable across projects and offer ledger graduation. For every observation the
+user selects, invoke `oat project log append` with the original judgment type
+and area, `--scope general`, and a body that references the original entry's
+exact heading. The new body may explain why the observation is reusable, but it
+must not copy the full original entry. Request the append result as structured
+JSON; whenever it reports `status: "appended"`, set
+`PROJECT_LOG_PROMOTION_APPENDED="true"` so the commit step includes the mutated
+project log.
+
+Ledger graduation is append-only: never edit, annotate, strike through, or add
+side metadata to the original entry. The newly appended `general` judgment is
+the promotion, and the later `rollup` command naturally selects it for the
+ledger.
+
 ### Step 3: Check for Existing Summary
 
 ```bash
@@ -154,7 +189,7 @@ test -f "$PROJECT_PATH/summary.md"
      identifiers (timestamp, category, and title) with the source pointers in
      the existing `## Autonomous Execution Learnings` section. Treat missing,
      added, or changed recommendations as `learnings_changed`.
-   - If `oat_summary_last_task == current_last_task` AND `oat_summary_revision_count == current_rev_count` AND learnings are absent or unchanged: **No changes detected. Skip update.** Report: "Summary is current. No updates needed."
+   - If `oat_summary_last_task == current_last_task` AND `oat_summary_revision_count == current_rev_count` AND learnings are absent or unchanged AND the project-log check reports no entries: **No changes detected. Skip update.** Report: "Summary is current. No updates needed."
    - If `current_rev_count > oat_summary_revision_count`: New revision phases exist. Update: Revision History, What Was Implemented, Follow-up Items.
    - If `current_last_task > oat_summary_last_task`: New tasks completed. Update: What Was Implemented, Notable Challenges, Tradeoffs Made.
    - If `learnings_changed`: update Autonomous Execution Learnings even when
@@ -192,6 +227,7 @@ For each section, synthesize content from the relevant artifacts. Apply these ru
 | Revision History               | plan.md p-revN phases, implementation.md revision notes                |
 | Follow-up Items                | implementation.md deferred findings, plan.md deferred items            |
 | Associated Issues              | state.md `associated_issues` field                                     |
+| Workflow Observations          | project-log.md via `oat project log rollup` only                       |
 | Autonomous Execution Learnings | oat-execution-learnings.md dated entries                               |
 
 **Autonomous Execution Learnings (conditional):**
@@ -232,6 +268,17 @@ entries, omit the entire section. If the file is absent, this behavior is inert:
 remove the template placeholder during a first render and make no
 learnings-driven update on a re-run.
 
+**Workflow Observations coexistence contract:**
+
+Keep `## Workflow Observations` and `## Autonomous Execution Learnings` as
+distinct summary sections. Author the autonomous-execution section first, then
+perform the project-log roll-up in Step 6. Because the roll-up command writes
+every project-log entry, keep the project-log observation in Workflow
+Observations and represent any overlap from Autonomous Execution Learnings with
+a one-line cross-reference instead of copying it there. The roll-up command
+remains the only writer of Workflow Observations—never hand-implement its
+section or ledger writes.
+
 **For incremental updates (re-run):**
 
 Only update sections affected by the new content. Do not rewrite the entire summary. Preserve existing section content and append/modify as needed.
@@ -253,11 +300,50 @@ oat_summary_includes_revisions: [{ list of p-revN IDs reflected }]
 ---
 ```
 
-### Step 6: Promote Key Decisions to Canonical Decision Records
+### Step 6: Roll Up Project Observations and Offer Backlog Graduation
+
+Run this step after `summary.md` has been authored or refreshed, including the
+distinct `## Autonomous Execution Learnings` section when its source artifact
+exists.
+
+When Step 2.5 found entries, run:
+
+```bash
+PROJECT_LOG_LEDGER_PATH=$(oat config get workflow.projectLogLedgerPath)
+PROJECT_LOG_LEDGER_APPENDED="false"
+PROJECT_LOG_ROLLUP=$(oat project log rollup --project "$PROJECT_PATH" --json)
+```
+
+`PROJECT_LOG_LEDGER_PATH` must be the effective resolved path, including the
+default when no override exists. If it cannot be resolved, stop before roll-up
+because a later `ledgerOutcome: "appended"` could not be staged safely.
+
+Route only on the structured `ProjectLogRollupResult`:
+
+- `status: "ok"` with `ledgerOutcome: "appended"`: set
+  `PROJECT_LOG_LEDGER_APPENDED="true"` and proceed.
+- `status: "ok"` with `ledgerOutcome: "deduplicated"`: proceed without staging
+  the unchanged ledger.
+- `status: "ok"` with `ledgerOutcome: "skipped_permitted"`: proceed and report
+  that the ledger was permissibly skipped because the default reference layer
+  is absent.
+- `status: "failed"` or `ledgerOutcome: "failed"`: surface the failure to the
+  user and stop before commit. Do not describe the summary as fully rolled up.
+
+The command mechanically writes or updates `## Workflow Observations` and
+appends/deduplicates eligible `general` judgments in the configured ledger. Do
+not reproduce either write by hand.
+
+Separately inspect follow-up-marked project-log entries and offer backlog
+graduation through `oat-pjm-add-backlog-item`. Backlog graduation creates a
+tracked work item; it is not ledger graduation and must not replace the
+append-based `project` → `general` promotion in Step 2.5.
+
+### Step 7: Promote Key Decisions to Canonical Decision Records
 
 Run this step **after** `summary.md` (including its `## Key Decisions` section) has been written/refreshed and its frontmatter updated. It promotes the project's Key Decisions out of per-project prose and into the canonical, repo-wide `reference/decisions/` log so they stop being siloed in `summary.md`. This step is **additive and non-interactive** — it never prompts.
 
-**6.1 — PJM gate (auto, no prompt).** Check whether the PJM tool pack is installed:
+**7.1 — PJM gate (auto, no prompt).** Check whether the PJM tool pack is installed:
 
 ```bash
 PJM_ENABLED=$(oat config get tools.project-management 2>/dev/null || echo "")
@@ -266,9 +352,9 @@ PJM_ENABLED=$(oat config get tools.project-management 2>/dev/null || echo "")
 - If `PJM_ENABLED` is `true` → perform the promotion automatically. Do NOT ask the user.
 - Otherwise (any other value, empty, or unset) → **skip this entire step silently.** Do not print a warning or prompt.
 
-**6.2 — Skip if nothing to promote.** If `summary.md` has no `## Key Decisions` section, or that section has no decision content, skip the step. There is nothing to promote.
+**7.2 — Skip if nothing to promote.** If `summary.md` has no `## Key Decisions` section, or that section has no decision content, skip the step. There is nothing to promote.
 
-**6.3 — Ensure the decisions surface exists.** The canonical decisions root is `.oat/repo/reference/decisions` (the `oat decision` default; pass `--decisions-root <path>` only for an explicit override). If its managed index is missing — i.e. `.oat/repo/reference/decisions/index.md` does not exist — initialize it first so `oat decision new` can succeed:
+**7.3 — Ensure the decisions surface exists.** The canonical decisions root is `.oat/repo/reference/decisions` (the `oat decision` default; pass `--decisions-root <path>` only for an explicit override). If its managed index is missing — i.e. `.oat/repo/reference/decisions/index.md` does not exist — initialize it first so `oat decision new` can succeed:
 
 ```bash
 test -f .oat/repo/reference/decisions/index.md || oat decision init
@@ -276,7 +362,7 @@ test -f .oat/repo/reference/decisions/index.md || oat decision init
 
 `oat decision init` is idempotent; running it when the scaffold already exists is harmless.
 
-**6.4 — Idempotent, date-independent promotion (critical).** For each decision in `## Key Decisions`:
+**7.4 — Idempotent, date-independent promotion (critical).** For each decision in `## Key Decisions`:
 
 1. **Derive title + complete sections.** Ground every value in the Key Decision and its project artifacts:
    - The bold lead-in / first clause becomes the **title** (a short noun phrase).
@@ -308,7 +394,7 @@ Because of the date-independent slug dedup, this step is **safe to run every tim
 
 **Status value:** use `--status accepted`. The decision template's status field (`.oat/templates/decision.md`) is free-form, and the canonical accepted/decided value in the decision vocabulary (`proposed` → `accepted` → `superseded`) is `accepted`. A Key Decision in a completed project's summary represents a decision that was made and shipped, so `accepted` is the correct status.
 
-**6.5 — Report, don't prompt.** After processing all Key Decisions, print a short informational summary, e.g.:
+**7.5 — Report, don't prompt.** After processing all Key Decisions, print a short informational summary, e.g.:
 
 ```
 Promoted N key decision(s) to reference/decisions/:
@@ -318,14 +404,25 @@ Promoted N key decision(s) to reference/decisions/:
 
 This is informational only. There is no interactive prompt anywhere in this step.
 
-### Step 7: Commit
+### Step 8: Commit
 
 ```bash
 git add "$PROJECT_PATH/summary.md"
+if [ "$PROJECT_LOG_PROMOTION_APPENDED" = "true" ]; then
+  git add "$PROJECT_PATH/project-log.md"
+fi
+if [ "$PROJECT_LOG_LEDGER_APPENDED" = "true" ]; then
+  git add "$PROJECT_LOG_LEDGER_PATH"
+fi
 git commit -m "docs: generate summary for {project-name}"
 ```
 
-If decision records were promoted in Step 6, also stage `.oat/repo/reference/decisions/` so the new `DR-*.md` records and the regenerated `index.md` land with the summary.
+These conditional paths are required: append-based promotion mutates
+`project-log.md`, while `ledgerOutcome: "appended"` mutates the effective
+repository ledger. A permitted skip or deduplicated ledger does not add a
+ledger staging path.
+
+If decision records were promoted in Step 7, also stage `.oat/repo/reference/decisions/` so the new `DR-*.md` records and the regenerated `index.md` land with the summary.
 
 If this is a re-run (incremental update):
 
@@ -333,7 +430,7 @@ If this is a re-run (incremental update):
 git commit -m "docs: update summary for {project-name}"
 ```
 
-### Step 8: Output Summary
+### Step 9: Output Summary
 
 ```
 Summary generated for {project-name}.
@@ -360,5 +457,12 @@ Summary tracks: last task {task_id}, {N} revision phases
   follow-ups, and Workflow issues with source-entry pointers
 - When `oat-execution-learnings.md` is absent, no Autonomous Execution
   Learnings section is rendered and normal summary behavior is unchanged
+- Project-log ledger graduation appends a new referencing `general` judgment
+  before roll-up and never mutates the original `project` judgment
+- `oat project log rollup --json` owns the distinct Workflow Observations
+  section and ledger writes; `failed` stops the summary flow while
+  `skipped_permitted` proceeds with a note
+- Follow-up-marked project-log entries use backlog graduation separately from
+  ledger graduation
 - When the PJM tool pack is installed, each Key Decision is promoted to a canonical `reference/decisions/DR-YYMMDD-slug` record via `oat decision new` (status `accepted`), deduped on the date-independent slug so re-runs never create duplicate records
 - When the PJM tool pack is not installed, decision promotion is skipped silently with no prompt

package/assets/templates/project-log.md

@@ -0,0 +1,47 @@
+---
+oat_generated: false
+oat_template: true
+oat_template_name: project-log
+purpose: project-observations
+oat_last_updated: YYYY-MM-DD
+---
+
+# Project Log: {Project Name}
+
+This append-only log serves two audiences: the project team learning from this project's execution, and maintainers improving the general OAT workflow and tooling.
+
+## Logging contract
+
+Append when something breaks, surprises you, requires a workaround, or works notably well enough to preserve as do-not-regress evidence. Record evidence, not a running narrative. Prior entries are never edited or struck through; append corrections as a new judgment entry that references the original entry and explains the correction. Add a version note to tool-related observations. Create entries only with `oat project log append`; run `oat project log append --help` for the complete entry contract. Reference supporting artifacts by path instead of inlining them. Never record secret values such as tokens, keys, signed URLs, or credentials because this log rolls up into tracked surfaces; reference secrets by name or source, never by value.
+
+Judgment entries default to 1–3 sentences covering what happened, the impact or workaround, and any follow-up. High-value entries may instead use this structured body:
+
+```text
+Observation: What happened and the supporting evidence.
+Impact: Why it mattered or what workaround was required.
+Recommendation: What should change or be preserved.
+```
+
+Shared tracked surfaces must be written only from the root checkout, never from parallel worktrees.
+
+## Entry format
+
+Judgment entries:
+
+```text
+### YYYY-MM-DD · <project|general> · <bug|friction|worked-well|feedback> · <area>
+```
+
+Structural entries:
+
+```text
+### YYYY-MM-DD · structural · <producer> · <ref>
+```
+
+## Entries
+
+Entries are chronological and append-only.
+
+## End-of-run synthesis (pending — do not skip at project completion)
+
+Summarize the overall verdict, adopted adjustments, and entries graduated to the repo ledger or backlog. Roll up durable observations into tracked surfaces before archiving this project log.

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":"AAGA,OAAO,EAAE,mBAAmB,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEhF,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,iCAAiC,CAAC;AAezC,OAAO,EAML,KAAK,SAAS,EACd,KAAK,cAAc,EAGnB,KAAK,UAAU,EAehB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAEL,KAAK,cAAc,EAEpB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAGL,KAAK,8BAA8B,EACnC,KAAK,yBAAyB,EAC/B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,mCAAmC,EACnC,0BAA0B,EAC3B,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAuFpC,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,iBAAiB,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5C,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACzE,kBAAkB,EAAE,CAClB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,yBAAyB,KAC/B,OAAO,CAAC,8BAA8B,CAAC,CAAC;IAC7C,mCAAmC,EAAE,OAAO,mCAAmC,CAAC;IAChF,0BAA0B,EAAE,OAAO,0BAA0B,CAAC;IAC9D,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC;CAC/B;AAg+DD,wBAAgB,mBAAmB,CACjC,SAAS,GAAE,OAAO,CAAC,yBAAyB,CAAM,GACjD,OAAO,CAsKT"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/config/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEhF,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,iCAAiC,CAAC;AAezC,OAAO,EAML,KAAK,SAAS,EACd,KAAK,cAAc,EAGnB,KAAK,UAAU,EAehB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAEL,KAAK,cAAc,EAEpB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAGL,KAAK,8BAA8B,EACnC,KAAK,yBAAyB,EAC/B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,mCAAmC,EACnC,0BAA0B,EAC3B,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAyFpC,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,iBAAiB,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5C,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACzE,kBAAkB,EAAE,CAClB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,yBAAyB,KAC/B,OAAO,CAAC,8BAA8B,CAAC,CAAC;IAC7C,mCAAmC,EAAE,OAAO,mCAAmC,CAAC;IAChF,0BAA0B,EAAE,OAAO,0BAA0B,CAAC;IAC9D,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC;CAC/B;AAkhED,wBAAgB,mBAAmB,CACjC,SAAS,GAAE,OAAO,CAAC,yBAAyB,CAAM,GACjD,OAAO,CAsKT"}

package/dist/commands/config/index.js

@@ -57,6 +57,8 @@ const KEY_ORDER = [
     'workflow.autoNarrowReReviewScope',
     'workflow.autoArtifactReview.plan',
     'workflow.autoArtifactReview.analysis',
+    'workflow.projectLog',
+    'workflow.projectLogLedgerPath',
     'workflow.designMode',
     'workflow.dispatchPolicy.mode',
     'workflow.dispatchPolicy.policy',
@@ -464,6 +466,28 @@ const CONFIG_CATALOG = [
         owningCommand: 'oat config set workflow.autoArtifactReview.analysis <true|false>',
         description: 'Automatically run the bounded accuracy-review loop for generated analysis artifacts before apply workflows consume them. Resolution: local > shared > user > default.',
     },
+    {
+        key: 'workflow.projectLog',
+        group: 'Workflow Preferences (3-layer: local > shared > user)',
+        file: '.oat/config.local.json | .oat/config.json | ~/.oat/config.json',
+        scope: 'workflow',
+        type: 'true | false | auto',
+        defaultValue: 'auto',
+        mutability: 'read/write',
+        owningCommand: 'oat config set workflow.projectLog <true|false|auto>',
+        description: 'Controls the append-only per-project observation log. auto creates it on first append; an existing artifact always remains enabled. Resolution: local > shared > user > default.',
+    },
+    {
+        key: 'workflow.projectLogLedgerPath',
+        group: 'Workflow Preferences (3-layer: local > shared > user)',
+        file: '.oat/config.local.json | .oat/config.json | ~/.oat/config.json',
+        scope: 'workflow',
+        type: 'string',
+        defaultValue: '.oat/repo/reference/project-observations.md',
+        mutability: 'read/write',
+        owningCommand: 'oat config set workflow.projectLogLedgerPath <repo-relative-path>',
+        description: 'Repo-relative ledger path used by project-log rollup. Resolution: local > shared > user > default.',
+    },
     {
         key: 'workflow.designMode',
         group: 'Workflow Preferences (3-layer: local > shared > user)',
@@ -745,6 +769,23 @@ function parseWorkflowValue(key, rawValue) {
     if (WORKFLOW_BOOLEAN_KEYS.has(key)) {
         return parseBooleanValue(key, rawValue);
     }
+    if (key === 'workflow.projectLog') {
+        const normalized = rawValue.trim().toLowerCase();
+        if (normalized === 'true' || normalized === 'false') {
+            return normalized === 'true';
+        }
+        if (normalized === 'auto') {
+            return normalized;
+        }
+        throw new Error(`Invalid value for ${key}: expected one of true | false | auto, got '${rawValue}'`);
+    }
+    if (key === 'workflow.projectLogLedgerPath') {
+        const normalized = rawValue.trim();
+        if (!normalized) {
+            throw new Error(`Invalid value for ${key}: expected a non-empty string path`);
+        }
+        return normalized;
+    }
     if (key === 'workflow.postImplementSequence') {
         const normalized = rawValue.trim();
         if (normalized.startsWith('{') || normalized.startsWith('[')) {

package/dist/commands/gate/index.d.ts

@@ -1,4 +1,5 @@
 import { type CommandContext, type GlobalOptions } from '../../app/command-context.js';
+import { appendProjectLog } from '../project/log/append.js';
 import { type ExecTarget, type OatConfig, type OatLocalConfig, type UserConfig } from '../../config/oat-config.js';
 import { type ResolvedConfig } from '../../config/resolve.js';
 import { type ModelFamily } from '../../providers/identity/family.js';
@@ -24,6 +25,7 @@ interface GateCommandDependencies {
     readGateRouteReceipt: typeof readGateRouteReceipt;
     runProcess: (command: string, args: string[], options: ProcessRunOptions) => Promise<ProcessRunResult>;
     parseReviewGateVerdict: typeof parseReviewGateVerdict;
+    appendProjectLog: typeof appendProjectLog;
     processEnv: NodeJS.ProcessEnv;
     writeGateRunMarker: (path: string, marker: GateRunMarker, warn: (message: string) => void) => Promise<boolean>;
     removeGateRunMarker: (path: string, warn: (message: string) => void) => Promise<void>;

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

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

package/dist/commands/gate/index.js

@@ -4,6 +4,7 @@ import { mkdir, readdir, readFile, rm, writeFile } from 'node:fs/promises';
 import { tmpdir } from 'node:os';
 import { basename, isAbsolute, join, relative } from 'node:path';
 import { buildCommandContext, } from '../../app/command-context.js';
+import { appendProjectLog } from '../project/log/append.js';
 import { getFrontmatterBlock, parseFrontmatterScalarFields, parseGeneratedTime, } from '../shared/frontmatter.js';
 import { readGlobalOptions } from '../shared/shared.utils.js';
 import { parseJsonConfig } from '../../config/json.js';
@@ -38,6 +39,7 @@ const DEFAULT_DEPENDENCIES = {
     readGateRouteReceipt,
     runProcess: runChildProcess,
     parseReviewGateVerdict,
+    appendProjectLog,
     processEnv: process.env,
     writeGateRunMarker,
     removeGateRunMarker,
@@ -1654,6 +1656,29 @@ function writeReviewGateTargetingFailure(context, payload) {
     context.logger.error(`Expected project=${payload.corroboration.expectedProject} run=${payload.gateInvocation.runId}; actual containing_project=${payload.corroboration.actual.containingProject ?? 'missing'} artifact_project=${payload.corroboration.actual.artifactProject ?? 'missing'} run_matches=${payload.corroboration.actual.matchingArtifactPaths.join(',') || 'none'}.`);
     context.logger.error('This targeting failure is not receive-eligible and must be corrected before severity or invocation remediation.');
 }
+async function finalizeReviewGateProjectLog(context, dependencies, finalization) {
+    const findings = finalization.counts
+        ? ` findings=critical:${finalization.counts.critical},important:${finalization.counts.important},medium:${finalization.counts.medium},minor:${finalization.counts.minor}`
+        : '';
+    const artifact = finalization.artifactPath
+        ? ` artifact=${finalization.artifactPath}`
+        : '';
+    const body = `target=${finalization.target} threshold=${finalization.threshold}${findings} exit=${finalization.exitCode} status=${finalization.status}${artifact}`;
+    try {
+        await dependencies.appendProjectLog({
+            repoRoot: finalization.repoRoot,
+            home: finalization.home,
+            project: finalization.project,
+            structural: true,
+            producer: 'oat gate review',
+            ref: finalization.ref,
+            body,
+        });
+    }
+    catch (error) {
+        context.logger.warn(`Warning: unable to append oat gate review result to the project log: ${error instanceof Error ? error.message : String(error)}. Gate result is unchanged.`);
+    }
+}
 async function updateConfigLayer(context, layer, dependencies, mutate) {
     const repoRoot = await dependencies.resolveProjectRoot(context.cwd);
     const userConfigDir = join(context.home, '.oat');
@@ -1809,6 +1834,8 @@ async function runReviewGate(prompt, options, context, dependencies) {
     let runMarkerPath;
     let runMarkerWritten = false;
     let branchLocalGateCli;
+    let projectLogFinalization;
+    let projectLogFinalized = false;
     let postSelectionContext;
     try {
         const repoRoot = await dependencies.resolveProjectRoot(context.cwd);
@@ -1854,6 +1881,16 @@ async function runReviewGate(prompt, options, context, dependencies) {
             dispatchReport,
         };
         const threshold = parseReviewGateThreshold(options.exitNonzeroOn);
+        projectLogFinalization = {
+            repoRoot,
+            home: context.home,
+            project: projectPath,
+            ref: options.reviewScope?.trim() || 'gate-review',
+            target: selected.id,
+            threshold,
+            status: 'review_failed',
+            exitCode: 1,
+        };
         const before = await listReviewGateArtifactCandidates({
             repoRoot,
             effective,
@@ -1926,6 +1963,10 @@ async function runReviewGate(prompt, options, context, dependencies) {
             if (!refusal) {
                 return false;
             }
+            if (projectLogFinalization) {
+                projectLogFinalization.status = 'review_failed';
+                projectLogFinalization.exitCode = 1;
+            }
             writeReviewGateExecutionFailure(context, {
                 runId,
                 target: selected.id,
@@ -1955,12 +1996,21 @@ async function runReviewGate(prompt, options, context, dependencies) {
             before,
             after,
         });
+        if (projectLogFinalization) {
+            projectLogFinalization.artifactPath =
+                artifactResolution.artifact?.path ??
+                    artifactResolution.diagnosticArtifact?.path;
+        }
         if (!artifactResolution.artifact && writeRefusalFailure()) {
             return;
         }
         if (childExitCode !== 0 &&
             !childResult.timedOut &&
             !artifactResolution.artifact) {
+            if (projectLogFinalization) {
+                projectLogFinalization.status = 'review_failed';
+                projectLogFinalization.exitCode = childExitCode;
+            }
             writeReviewGateExecutionFailure(context, {
                 runId,
                 target: selected.id,
@@ -1982,6 +2032,10 @@ async function runReviewGate(prompt, options, context, dependencies) {
         if (childResult.timedOut &&
             artifactResolution.matchingArtifactPaths.length === 0 &&
             !artifactResolution.diagnosticArtifact) {
+            if (projectLogFinalization) {
+                projectLogFinalization.status = 'review_failed';
+                projectLogFinalization.exitCode = childExitCode;
+            }
             writeReviewGateExecutionFailure(context, {
                 runId,
                 target: selected.id,
@@ -2017,6 +2071,10 @@ async function runReviewGate(prompt, options, context, dependencies) {
                 : initialTargetCorroboration.run === 'mismatched'
                     ? `The changed review artifact did not carry the expected gate run ID ${runId}.`
                     : `No direct active project review artifact carried gate run ID ${runId}.`;
+            if (projectLogFinalization) {
+                projectLogFinalization.status = 'targeting_correlation_failed';
+                projectLogFinalization.exitCode = 1;
+            }
             writeReviewGateTargetingFailure(context, {
                 runId,
                 target: selected.id,
@@ -2038,6 +2096,10 @@ async function runReviewGate(prompt, options, context, dependencies) {
             if (writeRefusalFailure()) {
                 return;
             }
+            if (projectLogFinalization) {
+                projectLogFinalization.status = 'targeting_correlation_failed';
+                projectLogFinalization.exitCode = 1;
+            }
             writeReviewGateTargetingFailure(context, {
                 runId,
                 target: selected.id,
@@ -2062,6 +2124,10 @@ async function runReviewGate(prompt, options, context, dependencies) {
             if (writeRefusalFailure()) {
                 return;
             }
+            if (projectLogFinalization) {
+                projectLogFinalization.status = 'artifact_validation_failed';
+                projectLogFinalization.exitCode = 1;
+            }
             writeReviewGateArtifactValidationFailure(context, {
                 runId,
                 target: selected.id,
@@ -2093,6 +2159,10 @@ async function runReviewGate(prompt, options, context, dependencies) {
                 return;
             }
             const detail = error instanceof Error ? error.message : String(error);
+            if (projectLogFinalization) {
+                projectLogFinalization.status = 'artifact_validation_failed';
+                projectLogFinalization.exitCode = 1;
+            }
             writeReviewGateArtifactValidationFailure(context, {
                 runId,
                 target: selected.id,
@@ -2109,6 +2179,9 @@ async function runReviewGate(prompt, options, context, dependencies) {
             process.exitCode = 1;
             return;
         }
+        if (projectLogFinalization) {
+            projectLogFinalization.counts = verdict.counts;
+        }
         const targetCorroboration = initialTargetCorroboration;
         const corroboration = corroborateGateInvocation(gateInvocation, verdict.gateInvocation, targetCorroboration);
         if (corroboration.run !== 'matched' ||
@@ -2118,6 +2191,10 @@ async function runReviewGate(prompt, options, context, dependencies) {
             }
             const missing = corroboration.run === 'missing' ||
                 corroboration.invocation === 'missing';
+            if (projectLogFinalization) {
+                projectLogFinalization.status = 'artifact_validation_failed';
+                projectLogFinalization.exitCode = 1;
+            }
             writeReviewGateArtifactValidationFailure(context, {
                 runId,
                 target: selected.id,
@@ -2140,6 +2217,10 @@ async function runReviewGate(prompt, options, context, dependencies) {
             if (writeRefusalFailure()) {
                 return;
             }
+            if (projectLogFinalization) {
+                projectLogFinalization.status = 'artifact_validation_failed';
+                projectLogFinalization.exitCode = 1;
+            }
             writeReviewGateArtifactValidationFailure(context, {
                 runId,
                 target: selected.id,
@@ -2163,6 +2244,12 @@ async function runReviewGate(prompt, options, context, dependencies) {
             threshold,
             blocking,
         });
+        if (projectLogFinalization) {
+            projectLogFinalization.status = blocking ? 'blocked' : 'ok';
+            projectLogFinalization.exitCode = blocking ? 1 : 0;
+            projectLogFinalization.counts = verdict.counts;
+            projectLogFinalization.artifactPath = producedArtifact.path;
+        }
         writeReviewGateResult(context, {
             status: blocking ? 'blocked' : 'ok',
             runId,
@@ -2200,11 +2287,19 @@ async function runReviewGate(prompt, options, context, dependencies) {
         }
     }
     finally {
-        if (branchLocalGateCli) {
-            await dependencies.removeBranchLocalGateCli(branchLocalGateCli);
+        try {
+            if (branchLocalGateCli) {
+                await dependencies.removeBranchLocalGateCli(branchLocalGateCli);
+            }
+            if (runMarkerPath) {
+                await dependencies.removeGateRunMarker(runMarkerPath, (message) => context.logger.warn(message));
+            }
         }
-        if (runMarkerPath) {
-            await dependencies.removeGateRunMarker(runMarkerPath, (message) => context.logger.warn(message));
+        finally {
+            if (projectLogFinalization && !projectLogFinalized) {
+                projectLogFinalized = true;
+                await finalizeReviewGateProjectLog(context, dependencies, projectLogFinalization);
+            }
         }
     }
 }

package/dist/commands/init/tools/shared/skill-manifest.d.ts

@@ -13,7 +13,7 @@ export declare const PACK_METADATA: Record<string, PackMetadata>;
 export declare function resolvePackDefaultScope(packName: string): 'user' | 'project';
 export declare const WORKFLOW_SKILLS: readonly ["oat-cursor-cloud-projects", "oat-project-autonomous", "oat-project-capture", "oat-project-clear-active", "oat-project-complete", "oat-project-design", "oat-project-dispatch-subagents", "oat-project-discover", "oat-project-document", "oat-project-implement", "oat-project-import-plan", "oat-project-new", "oat-project-next", "oat-project-open", "oat-project-plan", "oat-project-plan-writing", "oat-project-pr-final", "oat-project-pr-progress", "oat-project-progress", "oat-project-promote-spec-driven", "oat-project-quick-start", "oat-project-reconcile", "oat-project-revise", "oat-project-review-provide", "oat-project-review-provide-remote", "oat-project-review-receive", "oat-project-review-receive-remote", "oat-project-spec", "oat-project-split", "oat-project-summary", "oat-repo-knowledge-index", "oat-worktree-bootstrap", "oat-worktree-bootstrap-auto", "oat-wrap-up"];
 export declare const WORKFLOW_AGENTS: readonly ["oat-codebase-mapper.md", "oat-phase-implementer.md", "oat-reviewer.md"];
-export declare const WORKFLOW_TEMPLATES: readonly ["state.md", "discovery.md", "spec.md", "design.md", "plan.md", "implementation.md", "summary.md"];
+export declare const WORKFLOW_TEMPLATES: readonly ["state.md", "discovery.md", "spec.md", "design.md", "plan.md", "implementation.md", "summary.md", "project-log.md"];
 export declare const WORKFLOW_SCRIPTS: readonly ["generate-oat-state.sh", "generate-thin-index.sh", "resolve-tracking.sh"];
 export declare const IDEA_SKILLS: readonly ["oat-idea-new", "oat-idea-ideate", "oat-idea-summarize", "oat-idea-scratchpad"];
 export declare const CORE_SKILLS: readonly ["oat-docs", "oat-doctor"];