levifig · levifig · Jul 20, 2026 · Jul 20, 2026 · Jul 20, 2026 · Jul 20, 2026
diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json
@@ -6,14 +6,14 @@
   },
   "metadata": {
     "description": "Loaf - An Opinionated Agentic Framework",
-    "version": "2.0.0-alpha.11"
+    "version": "2.0.0-alpha.12"
   },
   "plugins": [
     {
       "name": "loaf",
       "description": "Loaf - An Opinionated Agentic Framework",
       "source": "./plugins/loaf",
-      "version": "2.0.0-alpha.11",
+      "version": "2.0.0-alpha.12",
       "license": "MIT",
       "repository": "https://github.com/levifig/loaf"
     }

diff --git a/AGENTS.md b/AGENTS.md
@@ -531,7 +531,7 @@ Configure target-specific behavior and sidecars.
 - [Claude Code Skills Best Practices](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices)
 - [Claude Code Skills Documentation](https://code.claude.com/docs/en/skills)
 
-<!-- loaf:managed:start v2.0.0-alpha.2 -->
+<!-- loaf:managed:start v2.0.0-alpha.11 sha256=4e202b0bcb7ad79fd7808772d67bfae87299c05d920083c6fa220292770a007d -->
 <!-- Maintained by loaf install/upgrade - do not edit manually -->
 ## Loaf Framework
 
@@ -549,6 +549,7 @@ Configure target-specific behavior and sidecars.
 
 **Journal Discipline:**
 Before completing any response that includes edits, commits, or significant decisions, log journal entries using `loaf journal log "type(scope): description"`. Entry types: `decision`, `discover`, `wrap`. Do not defer journaling - log before responding.
+In Codex Auto mode, when the user explicitly installed the managed basic-command policy, use the exact path-pinned Loaf executable in the managed `CODEX_HOME/AGENTS.md` block; do not substitute a bare `loaf`. The policy authorizes only explicitly classified basic Loaf command leaves and does not grant unclassified/operator commands, a bare Loaf namespace, or general filesystem access. Other harness adapters are not implied.
 
 See [orchestration skill](skills/orchestration/SKILL.md) for full details.
 <!-- loaf:managed:end -->
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -8,6 +8,18 @@ is a Loaf workflow staging section for curated entries before release.
 
 - _No unreleased changes yet._
 
+## [2.0.0-alpha.12] - 2026-07-20
+
+### Changed
+
+- Codex-managed guidance, hooks, and execpolicy rules now render the stable PATH entrypoint (for example `/opt/homebrew/bin/loaf`) instead of the versioned Homebrew Cellar target, so package upgrades no longer invalidate installed policy or strand running Codex tasks; symlink-target validation against forbidden roots is unchanged and now covers both symlink directions (#127).
+
+### Fixed
+
+- Recognize the relationship provenance written by Intent creation, Exploration creation, and legacy-deferral conversion: every writer now shares one closed origin vocabulary, so `loaf doctor` no longer reports permanent unknown-origin warnings on healthy databases (#127).
+- `loaf state repair relationship-origin` reclassifies the retired legacy origins (`intent-create`, `legacy-conversion`, `exploration-create`, `system`) to `command`, backup-first and idempotent; bare invocation is reclassify-only, `--origin imported|manual` still enables the missing-origin backfill, and unrecognized foreign origins are reported but never rewritten (#127).
+- Live help agrees with dispatchable commands: `loaf state migrate --help` lists all six sources from the same registry that dispatches them, and bare or leaf `--help` invocations (`migrate`, `conversation handle add`, `exploration conversation add`) print usage and exit 0 (#127).
+
 ## [2.0.0-alpha.11] - 2026-07-19
 
 ### Fixed

diff --git a/dist/amp/.amp/plugins/loaf.ts b/dist/amp/.amp/plugins/loaf.ts
@@ -1,7 +1,7 @@
 /**
  * Amp Plugin - Agent Skills Hooks
  * Auto-generated by loaf build system
- * @version 2.0.0-alpha.11
+ * @version 2.0.0-alpha.12
  */
 
 import type { PluginAPI } from '@ampcode/plugin';

diff --git a/dist/amp/.loaf-target-manifest.json b/dist/amp/.loaf-target-manifest.json
@@ -1,7 +1,7 @@
 {
   "version": 1,
   "target": "amp",
-  "package_version": "2.0.0-alpha.11",
+  "package_version": "2.0.0-alpha.12",
   "capability_contract_version": 3,
   "adapters": [
     "amp-plugin-v1"
@@ -18,7 +18,7 @@
       "kind": "plugin",
       "source_path": ".amp/plugins/loaf.ts",
       "destination": "plugins/loaf.ts",
-      "sha256": "6fa80df47dcca8d060c6d516ac7332ff90239d071a9d87a31ccef2c8b9d48e61",
+      "sha256": "1ef9bd2eb2fb3fb1db43dc551817836b257da47fee214380c3084bf1db9f2e2a",
       "mode": 420
     }
   ]

diff --git a/dist/amp/skills/architecture/SKILL.md b/dist/amp/skills/architecture/SKILL.md
@@ -12,7 +12,7 @@ description: >-
   `decision(scope)` entry to the project journal instead). The ADR log is
   append-only — when circumstances change, write a new ADR that supersedes the
   old one.
-version: 2.0.0-alpha.11
+version: 2.0.0-alpha.12
 ---
 
 # Architecture

diff --git a/dist/amp/skills/bootstrap/SKILL.md b/dist/amp/skills/bootstrap/SKILL.md
@@ -6,7 +6,7 @@ description: >-
   I start a new project?", "set up Loaf," or "bootstrap my project." Produces
   populated project documents and setup recommendations. Not for shaping
   features (use shape) or brainstorming ideas (use brainstorm).
-version: 2.0.0-alpha.11
+version: 2.0.0-alpha.12
 ---
 
 # Bootstrap

diff --git a/dist/amp/skills/brainstorm/SKILL.md b/dist/amp/skills/brainstorm/SKILL.md
@@ -6,7 +6,7 @@ description: >-
   capture. Explore owns the user-facing inquiry lifecycle; reference this
   technique from it. Not a primary entry point — route "explore this" or "help
   me think through options" to explore.
-version: 2.0.0-alpha.11
+version: 2.0.0-alpha.12
 ---
 
 # Brainstorm

diff --git a/dist/amp/skills/breakdown/SKILL.md b/dist/amp/skills/breakdown/SKILL.md
@@ -5,7 +5,7 @@ description: >-
   Use when the user asks "break this down" or "create tasks for this spec."
   Produces task files with estimates, dependencies, and acceptance criteria. Not
   for shaping ideas (use shape) or implementation work (use implement).
-version: 2.0.0-alpha.11
+version: 2.0.0-alpha.12
 ---
 
 # Breakdown

diff --git a/dist/amp/skills/council/SKILL.md b/dist/amp/skills/council/SKILL.md
@@ -7,7 +7,7 @@ description: >-
   the user wants a structured debate between domain-specific viewpoints. Not for
   single-perspective research (use research) or architectural decisions that
   don't need multi-agent deliberation (use architecture).
-version: 2.0.0-alpha.11
+version: 2.0.0-alpha.12
 ---
 
 # Council

diff --git a/dist/amp/skills/database-design/SKILL.md b/dist/amp/skills/database-design/SKILL.md
@@ -7,7 +7,7 @@ description: >-
   database administration and development. Not for ORM usage in application code
   (use language-specific development skills) or infrastructure orchestration
   (use infrastructure-management).
-version: 2.0.0-alpha.11
+version: 2.0.0-alpha.12
 ---
 
 # Database Skill

diff --git a/dist/amp/skills/debugging/SKILL.md b/dist/amp/skills/debugging/SKILL.md
@@ -6,7 +6,7 @@ description: >-
   flaky tests. Provides methodology for root cause analysis and issue
   resolution. Not for writing new tests (use development skills) or security
   analysis (use security-compliance).
-version: 2.0.0-alpha.11
+version: 2.0.0-alpha.12
 ---
 
 # Debugging

diff --git a/dist/amp/skills/documentation-standards/SKILL.md b/dist/amp/skills/documentation-standards/SKILL.md
@@ -6,7 +6,7 @@ description: >-
   reviewing documentation quality, or creating architecture diagrams. Not for
   inline code comments (use code style guides) or project READMEs (use
   project-specific conventions).
-version: 2.0.0-alpha.11
+version: 2.0.0-alpha.12
 ---
 
 # Documentation Standards

diff --git a/dist/amp/skills/explore/SKILL.md b/dist/amp/skills/explore/SKILL.md
@@ -10,7 +10,7 @@ description: >-
   research), continuing implementation or delivery work (use implement),
   processing the intake queue (use triage), shaping a bounded Change (use
   shape), or quick capture (use idea).
-version: 2.0.0-alpha.11
+version: 2.0.0-alpha.12
 ---
 
 # Explore

diff --git a/dist/amp/skills/foundations/SKILL.md b/dist/amp/skills/foundations/SKILL.md
@@ -6,7 +6,7 @@ description: >-
   setting up project standards. Covers naming, TDD, verification, and review
   workflows. Not for git workflow (use git-workflow), debugging (use debugging),
   or security audits (use security-compliance).
-version: 2.0.0-alpha.11
+version: 2.0.0-alpha.12
 ---
 
 # Code Standards

diff --git a/dist/amp/skills/git-workflow/SKILL.md b/dist/amp/skills/git-workflow/SKILL.md
@@ -6,7 +6,7 @@ description: >-
   PRs, or managing git history. Provides patterns for collaborative git
   workflows. Not for code style (use foundations) or CI/CD pipelines (use
   infrastructure-management).
-version: 2.0.0-alpha.11
+version: 2.0.0-alpha.12
 ---
 
 # Git Workflow

diff --git a/dist/amp/skills/go-development/SKILL.md b/dist/amp/skills/go-development/SKILL.md
@@ -6,7 +6,7 @@ description: >-
   Follows Effective Go principles and community conventions. Not for database
   schema design (use database-design) or infrastructure orchestration (use
   infrastructure-management).
-version: 2.0.0-alpha.11
+version: 2.0.0-alpha.12
 ---
 
 # Go Skill

diff --git a/dist/amp/skills/handoff/SKILL.md b/dist/amp/skills/handoff/SKILL.md
@@ -7,7 +7,7 @@ description: >-
   being parked for later. Not for routine journal continuity (use orchestration)
   or an end-of-conversation checkpoint (use wrap). Produces a disposable handoff
   artifact that housekeeping deletes after confirmed deprecation.
-version: 2.0.0-alpha.11
+version: 2.0.0-alpha.12
 ---
 
 # Handoff

diff --git a/dist/amp/skills/housekeeping/SKILL.md b/dist/amp/skills/housekeeping/SKILL.md
@@ -7,7 +7,7 @@ description: >-
   completed work, and ensures extracted knowledge is preserved. Not for
   strategic reflection (use reflect) or knowledge management (use
   knowledge-base).
-version: 2.0.0-alpha.11
+version: 2.0.0-alpha.12
 ---
 
 # Housekeeping

diff --git a/dist/amp/skills/idea/SKILL.md b/dist/amp/skills/idea/SKILL.md
@@ -7,7 +7,7 @@ description: >-
   capture primitives routed through triage, which chooses dispositions such as
   tracking an Intent. Not for divergent inquiry (use explore), processing the
   intake queue (use triage), or shaping (use shape).
-version: 2.0.0-alpha.11
+version: 2.0.0-alpha.12
 ---
 
 # Idea

diff --git a/dist/amp/skills/implement/SKILL.md b/dist/amp/skills/implement/SKILL.md
@@ -6,7 +6,7 @@ description: >-
   changes. Logs to the project journal and produces agent spawn plans and
   progress tracking. Not for shaping (use shape), breakdown (use breakdown),
   research, or review.
-version: 2.0.0-alpha.11
+version: 2.0.0-alpha.12
 ---
 
 # Implement

diff --git a/dist/amp/skills/infrastructure-management/SKILL.md b/dist/amp/skills/infrastructure-management/SKILL.md
@@ -6,7 +6,7 @@ description: >-
   managing deployments. Provides patterns for infrastructure as code. Not for
   application code (use development skills), database schema (use
   database-design), or security audits (use security-compliance).
-version: 2.0.0-alpha.11
+version: 2.0.0-alpha.12
 ---
 
 # Infrastructure

diff --git a/dist/amp/skills/interface-design/SKILL.md b/dist/amp/skills/interface-design/SKILL.md
@@ -6,7 +6,7 @@ description: >-
   ensuring accessibility compliance. Not for frontend code (use
   typescript-development) or API design (use architecture or language-specific
   skills).
-version: 2.0.0-alpha.11
+version: 2.0.0-alpha.12
 ---
 
 # Design Principles

diff --git a/dist/amp/skills/knowledge-base/SKILL.md b/dist/amp/skills/knowledge-base/SKILL.md
@@ -6,7 +6,7 @@ description: >-
   covers: field, and the review workflow. Not for retrieval or search (use QMD
   directly), architectural decisions (use ADRs), or agent instructions (use
   AGENTS.md).
-version: 2.0.0-alpha.11
+version: 2.0.0-alpha.12
 ---
 
 # Knowledge Base

diff --git a/dist/amp/skills/loaf-reference/SKILL.md b/dist/amp/skills/loaf-reference/SKILL.md
@@ -7,7 +7,7 @@ description: >-
   when asked to upgrade, diagnose, repair, configure, or bring a Loaf project
   current. Not for workflow guidance (workflow skills own their CLI contracts)
   or build internals.
-version: 2.0.0-alpha.11
+version: 2.0.0-alpha.12
 ---
 
 # Loaf Reference

diff --git a/dist/amp/skills/orchestration/SKILL.md b/dist/amp/skills/orchestration/SKILL.md
@@ -5,7 +5,7 @@ description: >-
   integration, and council workflows. Use when delegating to agents or
   coordinating cross-cutting work across multiple agents. Not for single-task
   implementation (use direct tool delegation) or solo research (use research).
-version: 2.0.0-alpha.11
+version: 2.0.0-alpha.12
 ---
 
 # Orchestration

diff --git a/dist/amp/skills/power-systems-modeling/SKILL.md b/dist/amp/skills/power-systems-modeling/SKILL.md
@@ -6,7 +6,7 @@ description: >-
   thermal calculations, validating conductors, or computing sag and resistance.
   Not for infrastructure deployment (use infrastructure-management) or system
   architecture.
-version: 2.0.0-alpha.11
+version: 2.0.0-alpha.12
 ---
 
 # Power Systems Reference

diff --git a/dist/amp/skills/python-development/SKILL.md b/dist/amp/skills/python-development/SKILL.md
@@ -6,7 +6,7 @@ description: >-
   models, or tests. Provides patterns for modern Python development. Not for
   schema design (use database-design), infrastructure (use
   infrastructure-management), or frontend code (use typescript-development).
-version: 2.0.0-alpha.11
+version: 2.0.0-alpha.12
 ---
 
 # Python Development

diff --git a/dist/amp/skills/refactor-deepen/SKILL.md b/dist/amp/skills/refactor-deepen/SKILL.md
@@ -7,7 +7,7 @@ description: >-
   improvements, or when the user asks "is this module too shallow?" or "where
   should we deepen this code?" Produces either a read-only report or a PLAN file
   with candidates, dependency categories, and proposed deepened modules.
-version: 2.0.0-alpha.11
+version: 2.0.0-alpha.12
 ---
 
 # Refactor-Deepen

diff --git a/dist/amp/skills/reflect/SKILL.md b/dist/amp/skills/reflect/SKILL.md
@@ -6,7 +6,7 @@ description: >-
   VISION.md, STRATEGY.md, and ARCHITECTURE.md based on implementation
   experience. Not for pre-implementation strategy (use strategy) or ADRs (use
   architecture).
-version: 2.0.0-alpha.11
+version: 2.0.0-alpha.12
 ---
 
 # Reflect

diff --git a/dist/amp/skills/release/SKILL.md b/dist/amp/skills/release/SKILL.md
@@ -7,7 +7,7 @@ description: >-
   a release," "publish a version," "release from main," or asks whether enough
   landed work should become a release. Not for reviewing or merging a PR (use
   ship).
-version: 2.0.0-alpha.11
+version: 2.0.0-alpha.12
 ---
 
 # Release

diff --git a/dist/amp/skills/research/SKILL.md b/dist/amp/skills/research/SKILL.md
@@ -6,7 +6,7 @@ description: >-
   Produces state assessments, research findings with ranked options, or vision
   change proposals. Not for multi-agent coordination (use orchestration) or
   implementation.
-version: 2.0.0-alpha.11
+version: 2.0.0-alpha.12
 ---
 
 # Research

diff --git a/dist/amp/skills/ruby-development/SKILL.md b/dist/amp/skills/ruby-development/SKILL.md
@@ -6,7 +6,7 @@ description: >-
   following Rails patterns. Follows DHH/37signals conventions. Not for database
   schema design (use database-design) or frontend outside Hotwire (use
   typescript-development).
-version: 2.0.0-alpha.11
+version: 2.0.0-alpha.12
 ---
 
 # Ruby Development

diff --git a/dist/amp/skills/security-compliance/SKILL.md b/dist/amp/skills/security-compliance/SKILL.md
@@ -5,7 +5,7 @@ description: >-
   verification. Use when reviewing code for security, managing secrets,
   performing threat analysis, or running compliance audits. Not for debugging
   (use debugging) or general code review (use foundations).
-version: 2.0.0-alpha.11
+version: 2.0.0-alpha.12
 ---
 
 # Security & Compliance

diff --git a/dist/amp/skills/shape/SKILL.md b/dist/amp/skills/shape/SKILL.md
@@ -12,7 +12,7 @@ description: >-
   conversations, and plain conversation as input. Produces a Change, never a
   numbered spec or task file. Not for quick capture (use idea) or open-ended
   divergent thinking before scope exists (use brainstorm).
-version: 2.0.0-alpha.11
+version: 2.0.0-alpha.12
 ---
 
 # Shape

diff --git a/dist/amp/skills/ship/SKILL.md b/dist/amp/skills/ship/SKILL.md
@@ -6,7 +6,7 @@ description: >-
   final merge gate. Produces a reviewed, squash-merged PR and post-merge
   cleanup. Not for version bumps, tags, GitHub Releases, or install verification
   (use release).
-version: 2.0.0-alpha.11
+version: 2.0.0-alpha.12
 ---
 
 # Ship

diff --git a/dist/amp/skills/strategy/SKILL.md b/dist/amp/skills/strategy/SKILL.md
@@ -6,7 +6,7 @@ description: >-
   personas, market landscape analysis, and problem space definitions. Not for
   architecture (use architecture) or post-implementation reflection (use
   reflect).
-version: 2.0.0-alpha.11
+version: 2.0.0-alpha.12
 ---
 
 # Strategy

diff --git a/dist/amp/skills/triage/SKILL.md b/dist/amp/skills/triage/SKILL.md
@@ -9,7 +9,7 @@ description: >-
   shape. Not for reading a single known item (use loaf intent show or journal
   directly), capturing new ideas (use idea), divergent inquiry (use explore), or
   bounding one chosen direction (use shape).
-version: 2.0.0-alpha.11
+version: 2.0.0-alpha.12
 ---
 
 # Triage

diff --git a/dist/amp/skills/typescript-development/SKILL.md b/dist/amp/skills/typescript-development/SKILL.md
@@ -5,7 +5,7 @@ description: >-
   CSS, and Vitest testing. Use when writing TypeScript applications, React
   components, or Node.js services. Not for UI/UX design (use interface-design),
   database schema (use database-design), or Python (use python-development).
-version: 2.0.0-alpha.11
+version: 2.0.0-alpha.12
 ---
 
 # TypeScript Development

diff --git a/dist/amp/skills/wrap/SKILL.md b/dist/amp/skills/wrap/SKILL.md
@@ -7,7 +7,7 @@ description: >-
   end of a work session or when the user asks "wrap up." Not for archiving (use
   housekeeping) or capturing ideas (use idea). Produces a Session Wrap-Up
   summary and an optional wrap journal entry.
-version: 2.0.0-alpha.11
+version: 2.0.0-alpha.12
 ---
 
 # Wrap