npm - @open-agent-toolkit/cli - Versions diffs - 0.2.36 → 0.2.38 - Mend

@open-agent-toolkit/cli 0.2.36 → 0.2.38

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (183) hide show

package/assets/skills/oat-agent-instructions-apply/SKILL.md CHANGED Viewed

@@ -1,6 +1,6 @@
 ---
 name: oat-agent-instructions-apply
-version: 1.6.2
+version: 1.7.0
 description: Run when you have an agent instructions analysis artifact and want to generate or update instruction files. Creates a branch, generates files from templates, and optionally opens a PR.
 disable-model-invocation: true
 user-invocable: true
@@ -154,9 +154,33 @@ Then stop.
 ### Step 1: Resolve Providers
+Resolve the analyze sibling from the loaded skill root first, then the canonical
+user root, then the current repository's project root. Stop if none contains
+both the sibling `SKILL.md` and `scripts/resolve-providers.sh`.
 ```bash
-SCRIPT_DIR=".agents/skills/oat-agent-instructions-analyze/scripts"
-TRACKING_SCRIPT=".oat/scripts/resolve-tracking.sh"
+# Set APPLY_SKILL_DIR to the absolute directory containing this loaded SKILL.md.
+REPO_ROOT="$(git rev-parse --show-toplevel)"
+ANALYZE_SKILL_DIR=""
+for CANDIDATE in \
+  "$(dirname "$APPLY_SKILL_DIR")/oat-agent-instructions-analyze" \
+  "${HOME}/.agents/skills/oat-agent-instructions-analyze" \
+  "$REPO_ROOT/.agents/skills/oat-agent-instructions-analyze"
+do
+  if [[ -f "$CANDIDATE/SKILL.md" && -f "$CANDIDATE/scripts/resolve-providers.sh" ]]; then
+    ANALYZE_SKILL_DIR="$CANDIDATE"
+    break
+  fi
+done
+if [[ -z "$ANALYZE_SKILL_DIR" ]]; then
+  echo "oat-agent-instructions-analyze is not installed at the loaded, user, or project skill root." >&2
+  exit 1
+fi
+SCRIPT_DIR="$ANALYZE_SKILL_DIR/scripts"
+SCOPE_ROOT="$(cd "$APPLY_SKILL_DIR/../../.." && pwd)"
+TRACKING_SCRIPT="$SCOPE_ROOT/.oat/scripts/resolve-tracking.sh"
 PROVIDERS=$(bash "$SCRIPT_DIR/resolve-providers.sh" --non-interactive)
 ```
@@ -462,7 +486,7 @@ PR creation failed. To create manually:
 **Update tracking:**
 ```bash
-TRACKING_SCRIPT=".oat/scripts/resolve-tracking.sh"
+# Reuse the apply-skill scope paths resolved in Step 1.
 ROOT_TARGET=$(bash "$TRACKING_SCRIPT" root)
 ROOT_HASH=$(echo "$ROOT_TARGET" | jq -r '.commitHash')
 ROOT_BRANCH=$(echo "$ROOT_TARGET" | jq -r '.baseBranch')
@@ -506,4 +530,5 @@ Apply complete.
 - Templates: `references/instruction-file-templates/`
 - Canonical rule frontmatter reference: `references/instruction-file-templates/frontmatter/canonical-rule.md`
 - Apply plan template: `references/apply-plan-template.md`
-- Tracking script: `.oat/scripts/resolve-tracking.sh`
+- Tracking script: `$SCOPE_ROOT/.oat/scripts/resolve-tracking.sh`, where
+  `SCOPE_ROOT` is derived from the loaded skill directory.

package/assets/skills/oat-brainstorm/SKILL.md CHANGED Viewed

@@ -1,6 +1,6 @@
 ---
 name: oat-brainstorm
-version: 1.1.2
+version: 1.3.0
 description: Use when the user explicitly invokes the `brainstorm` verb, including `/oat-brainstorm`, "let's brainstorm", "brainstorm this", "can we brainstorm X", or "help me brainstorm X". For ambiguous exploratory phrasing ("I've been thinking", "what if", "help me think through"), do NOT auto-enter; respond conversationally and offer mode only after ≥2 sustained exploratory turns. Do NOT use for review, debug, PR, status, implementation, or active-workflow questions.
 disable-model-invocation: false
 user-invocable: true
@@ -217,7 +217,11 @@ Run pack-detection and active-project resolution **once** per session, before th
 ```bash
 IDEAS_INSTALLED=$(oat tools has ideas 2>/dev/null || echo "false")
-PJM_INSTALLED=$(oat tools has project-management 2>/dev/null || echo "false")
+PJM_CAPABILITY=$(oat tools has project-management 2>/dev/null || echo "false")
+PJM_ADOPTION_STATE=""
+if [ "$PJM_CAPABILITY" = "true" ]; then
+  PJM_ADOPTION_STATE=$(oat pjm doctor --json 2>/dev/null | jq -r '.adoption.state // ""')
+fi
 WORKFLOWS_INSTALLED=$(oat tools has workflows 2>/dev/null || echo "false")
 ACTIVE_PROJECT=$(oat config get activeProject 2>/dev/null || echo "")
@@ -290,7 +294,10 @@ If "keep going", return to step 5. If "wrap up", surface the **pack-filtered ter
 2. Filter by pack:
    - Always-available: `Inline only`, `Doc-to-path`.
    - Gated by `IDEAS_INSTALLED == "true"`: `Capture as new idea`, `Extend existing idea`, `Summarize idea directly`.
-   - Gated by `PJM_INSTALLED == "true"`: `Scoped backlog item`.
+   - Gated by `PJM_CAPABILITY == "true"` **and** `PJM_ADOPTION_STATE` equal to
+     `declared` or `inferred-legacy`: `Scoped backlog item`. Capability without
+     repository adoption never enables this write destination; for `none` or
+     `partial-initialization`, explain that `oat pjm init` is required.
    - Gated by `WORKFLOWS_INSTALLED == "true"` AND `ACTIVE_PROJECT_VALID != "true"`: `Promote to new OAT project`.
    - Gated by `WORKFLOWS_INSTALLED == "true"` AND `ACTIVE_PROJECT_VALID == "true"`: `Active project: fold-back` and `Active project: brainstorming reference file`. When this branch fires, present the **3-way active-project router first** (see step 9 active-project branches) — its outcome controls whether the rest of the picker is even surfaced.
 3. Evaluate whether the accumulated brainstorm scope is large enough to offer a split destination. Track the same four split signals used by discovery and evaluate them through the installed CLI:
@@ -387,6 +394,25 @@ After confirmation succeeds, proceed to step 9 (handoff).
 Branch on the destination. Each branch executes its handoff inline using the confirmed payload. The non-fold-back destinations are listed first; the active-project router and fold-back commit safety contract are detailed at the end of this step.
+**Resolving `${SKILLS_ROOT}` for chained skills.** The `ideas` and
+`project-management` packs default to user scope just as `brainstorm` does, so a
+chained sibling skill normally lives at `~/.agents/skills/<name>/SKILL.md` and
+**not** in the current repository. Never read a bare repo-relative
+`.agents/skills/<name>/SKILL.md`. Resolve the skills root before every chained
+read, in order:
+1. Derive it from the loaded skill directory: `${SKILL_DIR}/..` (with
+   `${SKILL_DIR}` resolved per the rule in step 3). This is
+   `<scope-root>/.agents/skills`.
+2. Otherwise try the user-scope root first: `${HOME}/.agents/skills` (matches
+   the pack default).
+3. Fall back to the project-scope root: `<repo-root>/.agents/skills` (set when
+   the pack is explicitly installed at project scope).
+Probe each candidate for `<name>/SKILL.md` and treat the first match as
+`${SKILLS_ROOT}`. If no candidate resolves, tell the user the chained skill is
+not installed and stop that branch instead of improvising its process.
 #### 9a — Inline only
 Print a one-paragraph closing summary capturing chosen direction (or "no direction selected"), key decisions, and any open questions. End mode assertion. No artifact is written.
@@ -404,7 +430,7 @@ When validation passes, render `${SKILL_DIR}/templates/brainstorm-doc.md` (resol
 #### 9c — Capture as new idea
-Read `.agents/skills/oat-idea-new/SKILL.md` and execute its **Steps 3 through 7** inline using the confirmed slug as the idea name:
+Read `${SKILLS_ROOT}/oat-idea-new/SKILL.md` (resolve `${SKILLS_ROOT}` per the rule at the top of step 9) and execute its **Steps 3 through 7** inline using the confirmed slug as the idea name:
 - Step 3: initialize ideas directory (`mkdir -p` for the idea root, copy `ideas-backlog.md` and `ideas-scratchpad.md` from templates if missing).
 - Step 4: scaffold `discovery.md` from the `idea-discovery.md` template.
@@ -421,14 +447,14 @@ Then **seed the scaffolded `discovery.md`** with the synthesized payload — fil
 After the seed write, offer the user two options:
-- **Chain into ideation** → read `.agents/skills/oat-idea-ideate/SKILL.md` and continue from its Step 4 (Start New Session).
+- **Chain into ideation** → read `${SKILLS_ROOT}/oat-idea-ideate/SKILL.md` and continue from its Step 4 (Start New Session).
 - **Stop here** → end mode assertion; report the idea path.
 Do not invoke `oat-idea-ideate` automatically. The handoff is offered, not forced.
 #### 9d — Extend existing idea
-The "which idea" was confirmed at step 8. Read `.agents/skills/oat-idea-ideate/SKILL.md` and **jump directly to its Step 4 (Start New Session)** with the resolved idea path. Append `transcriptSessionNote` from the payload as the new session's body. Include `chosenDirection`, `openQuestions`, and `nextSteps` in the session entry if they surfaced during convergence (they often do when the user wants the new session to record decisions, not just notes).
+The "which idea" was confirmed at step 8. Read `${SKILLS_ROOT}/oat-idea-ideate/SKILL.md` and **jump directly to its Step 4 (Start New Session)** with the resolved idea path. Append `transcriptSessionNote` from the payload as the new session's body. Include `chosenDirection`, `openQuestions`, and `nextSteps` in the session entry if they surfaced during convergence (they often do when the user wants the new session to record decisions, not just notes).
 End mode assertion when ideation hands control back.
@@ -437,13 +463,13 @@ End mode assertion when ideation hands control back.
 Two-step inline execution, run silently from the user's point of view:
 1. **Capture as new idea silently** — execute branch 9c above (Steps 3-7 of `oat-idea-new` plus seed). Do not surface progress detail; this is plumbing for the summary that's coming next.
-2. **Summarize end-to-end** — read `.agents/skills/oat-idea-summarize/SKILL.md` and run its full process. The downstream skill surfaces its own summary for accept/refine review — that is the user's gate.
+2. **Summarize end-to-end** — read `${SKILLS_ROOT}/oat-idea-summarize/SKILL.md` and run its full process. The downstream skill surfaces its own summary for accept/refine review — that is the user's gate.
 End mode assertion when `oat-idea-summarize` hands control back.
 #### 9f — Scoped backlog item
-Read `.agents/skills/oat-pjm-add-backlog-item/SKILL.md` and execute its process **from Step 1**. Pre-fill its early-prompt answers from the confirmed payload:
+Read `${SKILLS_ROOT}/oat-pjm-add-backlog-item/SKILL.md` (resolve `${SKILLS_ROOT}` per the rule at the top of step 9) and execute its process **from Step 1**. Pre-fill its early-prompt answers from the confirmed payload:
 - `Title` → payload field-by-field title (already user-confirmed at step 8).
 - `Description / context` → user-confirmed description.

package/assets/skills/oat-brainstorm/references/destinations.md CHANGED Viewed

@@ -83,7 +83,12 @@ Always honor an explicit user-supplied path over the suggestion. Brainstorm docs
 ### Destination: Scoped backlog item
-**Pack required:** `project-management` (i.e., `oat tools has project-management` returns `true`)
+**Capability required:** `project-management` (`oat tools has project-management`
+returns `true`). This proves only that the workflow is available.
+**Repository adoption required:** the read-only `oat pjm doctor --json` result
+has `adoption.state` equal to `declared` or `inferred-legacy`. For `none` or
+`partial-initialization`, do not offer or perform this write; stop with the
+actionable recovery `oat pjm init`.
 **Trigger phrases:** "track this as a backlog item", "make a ticket", "log this", "open a backlog entry", "add this to the backlog", "create a backlog item for this".
 **Required template fields:** `title` (1-line summary), `description` (problem + proposed approach), `acceptance criteria` (bullet list), `scope` (xs / s / m / l / xl), `priority` (p0 / p1 / p2 / p3). Template: `.oat/templates/backlog-item.md` (consumed via `oat-pjm-add-backlog-item`).
 **Optional template fields:** related items, target release, owner.

package/assets/skills/oat-docs-analyze/SKILL.md CHANGED Viewed

@@ -1,6 +1,6 @@
 ---
 name: oat-docs-analyze
-version: 1.4.0
+version: 1.5.0
 description: Run when you need to evaluate documentation structure, navigation, and coverage against the OAT docs app contract. Produces a severity-rated analysis artifact for oat-docs-apply.
 disable-model-invocation: true
 user-invocable: true
@@ -111,7 +111,9 @@ the app declared in `.oat/config.json` when multiple app candidates exist.
 Resolve tracking and analysis mode using the shared helper:
 ```bash
-TRACKING_SCRIPT=".oat/scripts/resolve-tracking.sh"
+# Set SKILL_DIR to the absolute directory containing this loaded SKILL.md.
+SCOPE_ROOT="$(cd "$SKILL_DIR/../../.." && pwd)"
+TRACKING_SCRIPT="$SCOPE_ROOT/.oat/scripts/resolve-tracking.sh"
 TRACKING=$(bash "$TRACKING_SCRIPT" read docs 2>/dev/null || true)
 ```
@@ -459,7 +461,9 @@ If the loop is disabled, note `Auto artifact review: skipped (workflow.autoArtif
 Update docs tracking using the shared helper:
 ```bash
-TRACKING_SCRIPT=".oat/scripts/resolve-tracking.sh"
+# Set SKILL_DIR to the absolute directory containing this loaded SKILL.md.
+SCOPE_ROOT="$(cd "$SKILL_DIR/../../.." && pwd)"
+TRACKING_SCRIPT="$SCOPE_ROOT/.oat/scripts/resolve-tracking.sh"
 ROOT_TARGET=$(bash "$TRACKING_SCRIPT" root)
 ROOT_HASH=$(echo "$ROOT_TARGET" | jq -r '.commitHash')
 ROOT_BRANCH=$(echo "$ROOT_TARGET" | jq -r '.baseBranch')
@@ -507,4 +511,5 @@ Next step: Run oat-docs-apply to act on these findings.
 - Analysis artifact template: `references/analysis-artifact-template.md`
 - Quality checklist: `references/quality-checklist.md`
 - Directory criteria: `references/directory-assessment-criteria.md`
-- Shared tracking helper: `.oat/scripts/resolve-tracking.sh`
+- Shared tracking helper: `$SCOPE_ROOT/.oat/scripts/resolve-tracking.sh`, where
+  `SCOPE_ROOT` is derived from this loaded skill's directory.

package/assets/skills/oat-docs-apply/SKILL.md CHANGED Viewed

@@ -1,6 +1,6 @@
 ---
 name: oat-docs-apply
-version: 1.2.0
+version: 1.3.0
 description: Run when you have a docs analysis artifact and want to generate or update documentation structure and content. Creates a branch, applies approved changes, and optionally opens a PR.
 disable-model-invocation: true
 user-invocable: true
@@ -301,7 +301,9 @@ PR creation failed. To create manually:
 Update shared tracking:
 ```bash
-TRACKING_SCRIPT=".oat/scripts/resolve-tracking.sh"
+# Set SKILL_DIR to the absolute directory containing this loaded SKILL.md.
+SCOPE_ROOT="$(cd "$SKILL_DIR/../../.." && pwd)"
+TRACKING_SCRIPT="$SCOPE_ROOT/.oat/scripts/resolve-tracking.sh"
 ROOT_TARGET=$(bash "$TRACKING_SCRIPT" root)
 ROOT_HASH=$(echo "$ROOT_TARGET" | jq -r '.commitHash')
 ROOT_BRANCH=$(echo "$ROOT_TARGET" | jq -r '.baseBranch')
@@ -336,4 +338,5 @@ Next step: Re-run oat-docs-analyze if you want a post-apply verification artifac
 ## References
 - Apply plan template: `references/apply-plan-template.md`
-- Shared tracking helper: `.oat/scripts/resolve-tracking.sh`
+- Shared tracking helper: `$SCOPE_ROOT/.oat/scripts/resolve-tracking.sh`, where
+  `SCOPE_ROOT` is derived from this loaded skill's directory.

package/assets/skills/oat-pjm-add-backlog-item/SKILL.md CHANGED Viewed

@@ -1,6 +1,6 @@
 ---
 name: oat-pjm-add-backlog-item
-version: 1.3.1
+version: 1.4.0
 description: Use when the user requests or confirms adding a new repo backlog item — e.g. "add a backlog item for X", "capture that as backlog", "track that follow-up", "file a backlog ticket", or confirms a previously offered backlog capture. Do NOT auto-invoke when a follow-up is mentioned. Creates the item file in the file-per-item backlog structure, regenerates the index, and prompts for curated overview updates.
 disable-model-invocation: false
 user-invocable: true
@@ -35,6 +35,19 @@ When executing this skill, provide lightweight progress feedback so the user can
 ## Process
+### Step 0: Verify Repository PJM Adoption
+Run the read-only preflight before any file write:
+```bash
+oat pjm doctor --json
+```
+Inspect the exact `adoption.state` field. Continue only for `declared` or
+`inferred-legacy`. For `none` or `partial-initialization`, stop before writing
+and tell the user to run `oat pjm init`. Global project-management tool
+availability is capability evidence only; it is never repository adoption.
 ### Step 1: Resolve Inputs
 Collect the item details from the user or surrounding context:

package/assets/skills/oat-pjm-decision/SKILL.md CHANGED Viewed

@@ -1,6 +1,6 @@
 ---
 name: oat-pjm-decision
-version: 1.0.0
+version: 1.1.0
 description: Use when the user requests or confirms recording a durable repo decision — e.g. "capture that as a decision", "write an ADR for X", "record this architectural choice", or confirms a previously offered decision capture. Creates a file-per-record decision under reference/decisions/ via `oat decision new` and refreshes the generated decision index. Do NOT auto-invoke for routine choices that do not warrant durable history.
 disable-model-invocation: false
 user-invocable: true
@@ -35,6 +35,19 @@ When executing this skill, provide lightweight progress feedback so the user can
 ## Process
+### Step 0: Verify Repository PJM Adoption
+Run the read-only preflight before any file write:
+```bash
+oat pjm doctor --json
+```
+Inspect the exact `adoption.state` field. Continue only for `declared` or
+`inferred-legacy`. For `none` or `partial-initialization`, stop before writing
+and tell the user to run `oat pjm init`. Do not use global pack presence as
+evidence that this repository adopted PJM.
 ### Step 1: Resolve Inputs
 Collect the decision details from the user or surrounding context:
@@ -48,22 +61,21 @@ Collect the decision details from the user or surrounding context:
 If the title is missing, ask the user.
 If context is missing, ask for 1-3 sentences describing the situation.
-### Step 2: Ensure Decision Scaffold
-Before creating records, ensure the canonical decision scaffold and exact managed index markers exist:
-```bash
-oat decision init
-```
+### Step 2: Verify Decision Scaffold
-This command is idempotent. The scaffold writes `reference/decisions/index.md` with the exact markers required by the CLI:
+The adoption preflight must succeed before this check. Confirm that
+`.oat/repo/reference/decisions/index.md` contains the exact markers required by
+the CLI:
 ```md
 <!-- OAT DECISION-INDEX -->
 <!-- END OAT DECISION-INDEX -->
 ```
-Do not hand-create or rename the managed marker block. Decisions default to `.oat/repo/reference/decisions/`; pass `--decisions-root <path>` only when an explicit override is required.
+Do not hand-create or rename the managed marker block. If it is absent, stop and
+repair the repository with `oat pjm init`. Decisions default to
+`.oat/repo/reference/decisions/`; pass `--decisions-root <path>` only when an
+explicit override is required.
 ### Step 3: Create the Decision Record

package/assets/skills/oat-pjm-review-backlog/SKILL.md CHANGED Viewed

@@ -1,6 +1,6 @@
 ---
 name: oat-pjm-review-backlog
-version: 1.5.0
+version: 1.6.0
 description: Use when prioritizing the file-backed repo backlog or evaluating roadmap alignment. Produces value-effort ratings, dependency mapping, execution recommendations, and an optional external-plan handoff.
 argument-hint: '[backlog-root] [--roadmap=<path>] [--output=<path>]'
 disable-model-invocation: true
@@ -68,6 +68,23 @@ Parse from `$ARGUMENTS`:
 ## Process
+### Step 0: Resolve Skill Resources and Verify Adoption
+Set `SKILL_DIR` to the absolute directory containing this loaded `SKILL.md`.
+Resolve every bundled template from `$SKILL_DIR/references/`; never assume the
+skill lives under the current repository's `.agents/skills/` tree.
+Before any review or alignment file write, run the read-only preflight:
+```bash
+oat pjm doctor --json
+```
+Inspect the exact `adoption.state` field. Continue only for `declared` or
+`inferred-legacy`. For `none` or `partial-initialization`, stop before writing
+and tell the user to run `oat pjm init`. Pack presence is capability evidence,
+not repository adoption.
 ### Step 1: Locate Inputs
 **Backlog root:**
@@ -172,7 +189,7 @@ If a roadmap was provided:
 ### Step 7: Write the Review Document
-Use the template at `.agents/skills/oat-pjm-review-backlog/references/backlog-review-template.md`.
+Use the template at `$SKILL_DIR/references/backlog-review-template.md`.
 Write the **living** review to the resolved output path (default `.oat/repo/pjm/backlog/reviews/backlog-and-roadmap-review.md`). If `--archive-dated` was passed, also write a dated snapshot alongside it (`backlog-and-roadmap-review-YYYY-MM-DD.md` in the same directory). Never split living and dated outputs across different directories — they must live together under `backlog/reviews/`.
@@ -222,7 +239,7 @@ If the operator declines, skip Steps 9–10 and continue to the Step 11 external
    - Are there calendar constraints (freezes, releases, time off) that affect ordering?
    - Does the operator want an optional axis like "planning investment" or "design effort" as a column? (Some repos find this useful; many don't. Default: omit unless operator opts in.)
 3. **Iterate on phase names, ordering, and the kickoff stack** until the operator is satisfied. Phase names should reflect the repo's actual initiatives, not generic placeholders.
-4. **Write or update** `.oat/repo/pjm/backlog/reviews/priority-alignment.md` using the template at `.agents/skills/oat-pjm-review-backlog/references/priority-alignment-template.md`. Add a new Changelog entry summarizing what shifted in this pass.
+4. **Write or update** `.oat/repo/pjm/backlog/reviews/priority-alignment.md` using the template at `$SKILL_DIR/references/priority-alignment-template.md`. Add a new Changelog entry summarizing what shifted in this pass.
 5. **Confirm the result** with the operator: file path, top-of-doc Status line, and the kickoff stack.
 When referencing backlog items inside the priority-alignment doc, the **Reference Format Convention** still applies — link to the item file and pair the ID with a human-readable title.

package/assets/skills/oat-pjm-update-repo-reference/SKILL.md CHANGED Viewed

@@ -1,6 +1,6 @@
 ---
 name: oat-pjm-update-repo-reference
-version: 1.3.0
+version: 1.4.0
 description: Use when repo reference artifacts need updating — roadmap, decision records, backlog status, or completed history. Frequently invoked at project completion, often chained from `oat-project-document`, to ensure active `.oat/repo/pjm/` state and durable `.oat/repo/reference/` records reflect what shipped.
 disable-model-invocation: false
 user-invocable: true
@@ -35,6 +35,19 @@ When executing this skill, provide lightweight progress feedback so the user can
 ## Process
+### Step 0: Verify Repository PJM Adoption
+Run the read-only preflight before any file write:
+```bash
+oat pjm doctor --json
+```
+Inspect the exact `adoption.state` field. Continue only for `declared` or
+`inferred-legacy`. For `none` or `partial-initialization`, stop before writing
+and tell the user to run `oat pjm init`. Installed project-management skills
+show capability availability only, not repository adoption.
 ### Step 1: Identify What Changed
 Write down a 1-3 bullet summary of the implementation change:
@@ -45,22 +58,19 @@ Write down a 1-3 bullet summary of the implementation change:
 - Repo-reference behavior changes
 - File moves, renames, or retirements
-### Step 2: Ensure Backlog Scaffold
-Before editing any backlog files or running backlog regeneration, run:
-```bash
-oat backlog init
-```
+### Step 2: Verify Backlog Scaffold
-This command is idempotent and ensures `.oat/repo/pjm/backlog/index.md` exists with the exact managed markers required by the CLI:
+After the adoption preflight succeeds, confirm that
+`.oat/repo/pjm/backlog/index.md` exists with the exact managed markers required
+by the CLI:
 ```md
 <!-- OAT BACKLOG-INDEX -->
 <!-- END OAT BACKLOG-INDEX -->
 ```
-Do not hand-author or rename those managed markers.
+Do not hand-author or rename those managed markers. If they are absent, stop and
+repair the repository with `oat pjm init`.
 ### Step 3: Mine Project Artifacts for Deferred Work and Decisions

package/assets/skills/oat-project-autonomous/references/gate-inventory.md CHANGED Viewed

@@ -241,7 +241,7 @@ remains immutable baseline evidence for the original p01-t01 verification.
 | `oat-project-implement/references/plan-and-resume.md`          | `413829d31e32 -> IMPLEMENT-02`; `c7706cd8ad09 -> IMPLEMENT-03`; `a80a948df658 -> IMPLEMENT-03`; `b7ea139780ec -> IMPLEMENT-03+IMPLEMENT-04`; `8d438f2180ba -> IMPLEMENT-03`; `9e72e0518cda -> IMPLEMENT-03`; `3e177a1021e6 -> IMPLEMENT-03+IMPLEMENT-04`; `b59fc9eb9ce3 -> IMPLEMENT-03`; `a2b1d6855283 -> IMPLEMENT-03`; `44351a32e52a -> IMPLEMENT-03`; `b98b022f5523 -> IMPLEMENT-03`; `e9f5b949e214 -> IMPLEMENT-03`; `316fb6d9e980 -> IMPLEMENT-03`; `8b25a2c5c548 -> IMPLEMENT-03`; `1a59b1c0e705 -> IMPLEMENT-03`; `466cd562fc52 -> IMPLEMENT-03`; `083d896978d5 -> IMPLEMENT-03`; `f4ab11c13ae9 -> IMPLEMENT-03`; `7dc17ffcc1c4 -> IMPLEMENT-03`; `f731a90adabd -> IMPLEMENT-04`; `886ac01e7aa9 -> IMPLEMENT-04`; `b715db67df0c -> IMPLEMENT-04`; `2d9f26a539f3 -> IMPLEMENT-10`; `28384dee114f -> IMPLEMENT-05`; `f2591a4978b4 -> NG`; `8290823080b5 -> IMPLEMENT-06`; `f75789bf6c8e -> IMPLEMENT-07`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
 | `oat-project-document/SKILL.md`                                | `4fc2d8618208 -> NG`; `3f9b0273ba77 -> NG`; `40f8be47affa -> NG`; `3a3c390528f3 -> DOCUMENT-03`; `2a7ba093b315 -> DOCUMENT-02`; `252aabe44db2 -> DOCUMENT-02`; `3751172de299 -> DOCUMENT-02`; `b987a0697ba9 -> DOCUMENT-01`; `a06ff3ca7926 -> NG`; `0d04714ca9fc -> NG`; `f79af01d94c6 -> DOCUMENT-02`; `71634113c348 -> DOCUMENT-02`; `cdb707f5081e -> NG`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
 | `oat-project-document/references/docs/autonomy-contract.md`    | `* -> NG`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
-| `oat-project-summary/SKILL.md`                                 | `68c197c44c18 -> NG`; `a167d03559fa -> NG`; `cf317c17c586 -> SUMMARY-01`; `8ff515033147 -> NG`; `ac36f854dd6b -> NG`; `f3e49b727752 -> NG`; `5f315ab87cb1 -> NG`; `e73bd88837ea -> NG`; `83257ff6cb68 -> NG`; `c8fced47ef8e -> NG`; `d7ea1e2a4f5f -> NG`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
+| `oat-project-summary/SKILL.md`                                 | `68c197c44c18 -> NG`; `a167d03559fa -> NG`; `cf317c17c586 -> SUMMARY-01`; `8ff515033147 -> NG`; `f979b2342d28 -> NG`; `f3e49b727752 -> NG`; `5f315ab87cb1 -> NG`; `803bf40ec423 -> NG`; `c8fced47ef8e -> NG`; `d7ea1e2a4f5f -> NG`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
 | `oat-project-pr-final/SKILL.md`                                | `601ac2b890f2 -> NG`; `5eb3949f32e1 -> NG`; `9efcbcee42ea -> NG`; `655d61df0a8f -> NG`; `cf317c17c586 -> PRFINAL-01`; `2de348a391c0 -> PRFINAL-03`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
 | `oat-project-pr-final/references/docs/autonomy-contract.md`    | `* -> NG`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
 | `oat-project-complete/SKILL.md`                                | `6ed459f9e462 -> NG`; `a167d03559fa -> NG`; `79c2eeed668c -> COMPLETE-01`; `2c1514b9d9af -> COMPLETE-01`; `31c750b4fea7 -> COMPLETE-01`; `cfba413b1293 -> COMPLETE-01`; `ffcdc9d576c0 -> COMPLETE-01`; `7fcfce0423ac -> COMPLETE-01`; `9497d9f94eed -> COMPLETE-01`; `7b59c728d3fb -> COMPLETE-01`; `48e10a9636fe -> COMPLETE-01`; `c0dad37fc166 -> COMPLETE-01`; `aa9a36243ec1 -> COMPLETE-01`; `7bcbf58b54e9 -> NG`; `4c7f88a7f942 -> COMPLETE-02`; `6a1a95acc8cc -> COMPLETE-02`; `3b559956b3eb -> COMPLETE-03`; `14d161cdf99b -> COMPLETE-03`; `12f7c30a54c8 -> NG`; `fffe5eea5ebd -> NG`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |

package/assets/skills/oat-project-document/SKILL.md CHANGED Viewed

@@ -1,6 +1,6 @@
 ---
 name: oat-project-document
-version: 1.6.2
+version: 1.8.0
 description: Use when the user requests or confirms documenting an active OAT project — e.g. "document the project", "update the docs", "run oat-project-document", or confirms a previously offered documentation run. Do NOT auto-invoke when implementation completes. Analyzes project artifacts, presents a documentation delta plan, and applies approved changes.
 argument-hint: '[project-path] [--auto]'
 disable-model-invocation: false
@@ -159,21 +159,39 @@ Store resolved values for use in later steps. Do not write auto-detected values
 ### Step 1: Check for PJM Infrastructure
-Check whether the project-management tool pack is effectively available:
+Check capability availability, then separately inspect repository adoption:
 ```bash
 PJM_INSTALLED=$(oat tools has project-management 2>/dev/null || echo "false")
+PJM_ADOPTION_STATE=""
+if [ "$PJM_INSTALLED" = "true" ]; then
+  PJM_ADOPTION_STATE=$(oat pjm doctor --json 2>/dev/null | jq -r '.adoption.state // ""')
+fi
 ```
-**If `PJM_INSTALLED` is `true`:**
+`PJM_INSTALLED=true` means the capability is available; it does not mean this
+repository adopted PJM.
+**If `PJM_ADOPTION_STATE` is `declared` or `inferred-legacy`:**
 - Invoke `oat-pjm-update-repo-reference` automatically before proceeding.
 - Do not ask whether to run the repo reference update during project-document.
 - **If invocation succeeds:** Log that repo reference docs were refreshed and continue to Step 2. The reference surfaces will already be current when the documentation scan reads them in Step 4a.4.
 - **If invocation fails:** Warn the user that the repo reference update failed, but continue with the documentation sync — a PJM failure should not block documentation updates.
+**If `PJM_ADOPTION_STATE` is `none` or `partial-initialization`:** Do not invoke
+any PJM writer. Warn that repository adoption is absent/incomplete, recommend
+`oat pjm init`, and proceed with documentation-only work.
 **If `PJM_INSTALLED` is not `true`:** Skip silently and proceed to Step 2.
+**If `PJM_INSTALLED` is `true` but `PJM_ADOPTION_STATE` is empty or holds any
+value other than the four documented states (`declared`, `inferred-legacy`,
+`none`, `partial-initialization`):** Treat adoption as unverified. Do not invoke
+any PJM writer, and do not fall through to the `declared` branch. Report that
+adoption could not be determined — the usual causes are `jq` missing from
+`PATH` or `oat pjm doctor` failing — and proceed with documentation-only work.
 ### Step 2: Read Project Artifacts
 Read all available project artifacts to build an understanding of what was built.

package/assets/skills/oat-project-document/references/docs/autonomy-contract.md CHANGED Viewed

@@ -241,7 +241,7 @@ remains immutable baseline evidence for the original p01-t01 verification.
 | `oat-project-implement/references/plan-and-resume.md`          | `413829d31e32 -> IMPLEMENT-02`; `c7706cd8ad09 -> IMPLEMENT-03`; `a80a948df658 -> IMPLEMENT-03`; `b7ea139780ec -> IMPLEMENT-03+IMPLEMENT-04`; `8d438f2180ba -> IMPLEMENT-03`; `9e72e0518cda -> IMPLEMENT-03`; `3e177a1021e6 -> IMPLEMENT-03+IMPLEMENT-04`; `b59fc9eb9ce3 -> IMPLEMENT-03`; `a2b1d6855283 -> IMPLEMENT-03`; `44351a32e52a -> IMPLEMENT-03`; `b98b022f5523 -> IMPLEMENT-03`; `e9f5b949e214 -> IMPLEMENT-03`; `316fb6d9e980 -> IMPLEMENT-03`; `8b25a2c5c548 -> IMPLEMENT-03`; `1a59b1c0e705 -> IMPLEMENT-03`; `466cd562fc52 -> IMPLEMENT-03`; `083d896978d5 -> IMPLEMENT-03`; `f4ab11c13ae9 -> IMPLEMENT-03`; `7dc17ffcc1c4 -> IMPLEMENT-03`; `f731a90adabd -> IMPLEMENT-04`; `886ac01e7aa9 -> IMPLEMENT-04`; `b715db67df0c -> IMPLEMENT-04`; `2d9f26a539f3 -> IMPLEMENT-10`; `28384dee114f -> IMPLEMENT-05`; `f2591a4978b4 -> NG`; `8290823080b5 -> IMPLEMENT-06`; `f75789bf6c8e -> IMPLEMENT-07`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
 | `oat-project-document/SKILL.md`                                | `4fc2d8618208 -> NG`; `3f9b0273ba77 -> NG`; `40f8be47affa -> NG`; `3a3c390528f3 -> DOCUMENT-03`; `2a7ba093b315 -> DOCUMENT-02`; `252aabe44db2 -> DOCUMENT-02`; `3751172de299 -> DOCUMENT-02`; `b987a0697ba9 -> DOCUMENT-01`; `a06ff3ca7926 -> NG`; `0d04714ca9fc -> NG`; `f79af01d94c6 -> DOCUMENT-02`; `71634113c348 -> DOCUMENT-02`; `cdb707f5081e -> NG`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
 | `oat-project-document/references/docs/autonomy-contract.md`    | `* -> NG`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
-| `oat-project-summary/SKILL.md`                                 | `68c197c44c18 -> NG`; `a167d03559fa -> NG`; `cf317c17c586 -> SUMMARY-01`; `8ff515033147 -> NG`; `ac36f854dd6b -> NG`; `f3e49b727752 -> NG`; `5f315ab87cb1 -> NG`; `e73bd88837ea -> NG`; `83257ff6cb68 -> NG`; `c8fced47ef8e -> NG`; `d7ea1e2a4f5f -> NG`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
+| `oat-project-summary/SKILL.md`                                 | `68c197c44c18 -> NG`; `a167d03559fa -> NG`; `cf317c17c586 -> SUMMARY-01`; `8ff515033147 -> NG`; `f979b2342d28 -> NG`; `f3e49b727752 -> NG`; `5f315ab87cb1 -> NG`; `803bf40ec423 -> NG`; `c8fced47ef8e -> NG`; `d7ea1e2a4f5f -> NG`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
 | `oat-project-pr-final/SKILL.md`                                | `601ac2b890f2 -> NG`; `5eb3949f32e1 -> NG`; `9efcbcee42ea -> NG`; `655d61df0a8f -> NG`; `cf317c17c586 -> PRFINAL-01`; `2de348a391c0 -> PRFINAL-03`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
 | `oat-project-pr-final/references/docs/autonomy-contract.md`    | `* -> NG`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
 | `oat-project-complete/SKILL.md`                                | `6ed459f9e462 -> NG`; `a167d03559fa -> NG`; `79c2eeed668c -> COMPLETE-01`; `2c1514b9d9af -> COMPLETE-01`; `31c750b4fea7 -> COMPLETE-01`; `cfba413b1293 -> COMPLETE-01`; `ffcdc9d576c0 -> COMPLETE-01`; `7fcfce0423ac -> COMPLETE-01`; `9497d9f94eed -> COMPLETE-01`; `7b59c728d3fb -> COMPLETE-01`; `48e10a9636fe -> COMPLETE-01`; `c0dad37fc166 -> COMPLETE-01`; `aa9a36243ec1 -> COMPLETE-01`; `7bcbf58b54e9 -> NG`; `4c7f88a7f942 -> COMPLETE-02`; `6a1a95acc8cc -> COMPLETE-02`; `3b559956b3eb -> COMPLETE-03`; `14d161cdf99b -> COMPLETE-03`; `12f7c30a54c8 -> NG`; `fffe5eea5ebd -> NG`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |