openplanr 1.25.3 → 2.0.0

package/dist/services/revise-service.d.ts

@@ -1,115 +0,0 @@
-/**
- * `planr revise` — core service.
- *
- * Exposes composable primitives. `reviseArtifact` produces dry-run decisions;
- * `applyDecision` writes them to disk. The verifier context is exposed so
- * callers can run `verifyDecision` against the same inputs the agent saw.
- */
-import { type RevisePromptArtifact, type ReviseWritableScope } from '../ai/prompts/prompt-builder.js';
-import { type AIProvider, type AIUsage } from '../ai/types.js';
-import type { ArtifactType, OpenPlanrConfig, ReviseAuditEntry, ReviseDecision } from '../models/types.js';
-import type { AuditLogWriter } from './audit-log-service.js';
-import type { EvidenceVerifierContext } from './evidence-verifier.js';
-export interface ReviseArtifactOptions {
-    /** Must be `true` in this release; reserved for future write path. */
-    dryRun: true;
-    /** Which parts of the artifact the agent may modify. Default: 'all'. */
-    writableScope?: ReviseWritableScope;
-    /** Skip codebase context assembly (fast mode). Default: include code. */
-    noCodeContext?: boolean;
-    /** Skip immediate-sibling context gathering (fast mode / first-pass). Default: include. */
-    noSiblingContext?: boolean;
-    /** Maximum number of sibling artifacts to inject (budget guard). Default: 8. */
-    maxSiblings?: number;
-}
-export interface ReviseArtifactContextStats {
-    parentsLoaded: number;
-    siblingsLoaded: number;
-    codebaseContextIncluded: boolean;
-    sourcesLoaded: number;
-}
-export interface ReviseArtifactResult {
-    decision: ReviseDecision;
-    usage: AIUsage;
-    contextStats: ReviseArtifactContextStats;
-    /** Filesystem path the decision's revisedMarkdown would be written to. */
-    artifactPath: string;
-    /** Pre-revise raw content, used for diff rendering and auditing. */
-    originalContent: string;
-    /** Context the caller should pass to `verifyDecision`. */
-    verifierContext: EvidenceVerifierContext;
-}
-/**
- * Error thrown when an artifact id cannot be resolved to an artifact type or
- * the artifact file does not exist on disk.
- */
-export declare class ReviseArtifactNotFoundError extends Error {
-    readonly artifactId: string;
-    constructor(artifactId: string, message: string);
-}
-/**
- * Revise a single artifact (dry-run).
- *
- * Does NOT write any files. The returned decision is the agent output after
- * schema validation; evidence verification, diff preview, and write live in
- * the CLI / apply path. Cascade, siblings, and declared sources are future
- * extensions.
- */
-export declare function reviseArtifact(projectDir: string, config: OpenPlanrConfig, provider: AIProvider, artifactId: string, options: ReviseArtifactOptions): Promise<ReviseArtifactResult>;
-export interface ApplyDecisionOptions {
-    artifactPath: string;
-    originalContent: string;
-    decision: ReviseDecision;
-    /**
-     * Directory where sidecar backups are written. Typically
-     * `.planr/reports/revise-<scope>-<date>/backup/` — set by the CLI.
-     */
-    backupDir: string;
-    /** Audit writer that will persist an entry describing the outcome. */
-    audit: AuditLogWriter;
-    /** When true, produces an audit entry but does not write the artifact. */
-    dryRun: boolean;
-    /** Cascade level tag for audit log grouping; omit for single-artifact runs. */
-    cascadeLevel?: ReviseAuditEntry['cascadeLevel'];
-}
-export interface ApplyDecisionResult {
-    outcome: ReviseAuditEntry['outcome'];
-    wrote: boolean;
-    diff: string;
-}
-/**
- * Apply a (verified) decision: write the artifact atomically when
- * `action === 'revise'` and `dryRun` is false, emit an audit entry
- * describing the outcome either way.
- *
- * Caller is expected to have already run `verifyDecision` — `applyDecision`
- * trusts that whatever decision arrives is allowed to be written.
- */
-export declare function applyDecision(options: ApplyDecisionOptions): Promise<ApplyDecisionResult>;
-/**
- * `true` when the agent's `revisedMarkdown` is byte-identical to `original`,
- * or differs only in trailing whitespace/newlines (LLM markdown serializers
- * routinely drop or add one trailing newline without changing semantics).
- *
- * Exported so the `--apply-from <audit>` replay path and the interactive
- * UI can share the same unchanged-detection rule.
- */
-export declare function isEffectivelyUnchanged(original: string, revised: string | undefined): boolean;
-/**
- * Load immediate-sibling artifacts (same artifact type, same parent) as
- * prompt entries. Lazy-reads each sibling's body only if it's going to be
- * included — the listing check is cheap, the reads are budgeted by
- * `maxSiblings` (default 8) so the prompt stays within token budget even on
- * epics with many features.
- *
- * For epic scope, there are no siblings (epics live at the top). For types
- * without a parent-id relationship (quick, backlog, etc.), returns empty.
- */
-export declare function loadSiblingPromptArtifacts(projectDir: string, config: OpenPlanrConfig, type: ArtifactType, id: string, maxSiblings: number): Promise<RevisePromptArtifact[]>;
-/**
- * Resolve the parent chain for an artifact and return it as the ordered
- * `RevisePromptArtifact[]` the prompt builder expects (epic → feature →
- * story). Empty array for top-level artifacts (epic scope).
- */
-export declare function loadParentPromptArtifacts(projectDir: string, config: OpenPlanrConfig, type: ArtifactType, id: string): Promise<RevisePromptArtifact[]>;
-//# sourceMappingURL=revise-service.d.ts.map

package/dist/services/revise-service.d.ts.map

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

package/dist/services/revise-service.js

@@ -1,294 +0,0 @@
-/**
- * `planr revise` — core service.
- *
- * Exposes composable primitives. `reviseArtifact` produces dry-run decisions;
- * `applyDecision` writes them to disk. The verifier context is exposed so
- * callers can run `verifyDecision` against the same inputs the agent saw.
- */
-import path from 'node:path';
-import { buildCodebaseContext, extractKeywords, formatCodebaseContext, } from '../ai/codebase/context-builder.js';
-import { buildRevisePrompt, } from '../ai/prompts/prompt-builder.js';
-import { aiReviseDecisionSchema } from '../ai/schemas/ai-response-schemas.js';
-import { TOKEN_BUDGETS } from '../ai/types.js';
-import { logger } from '../utils/logger.js';
-import { generateJSON } from './ai-service.js';
-import { findArtifactTypeById, getArtifactDir, getParentChain, listArtifacts, readArtifact, readArtifactRaw, resolveArtifactFilename, } from './artifact-service.js';
-import { atomicWriteFile } from './atomic-write-service.js';
-import { renderDiff } from './diff-service.js';
-import { getCanonicalSections } from './template-sections.js';
-/**
- * Error thrown when an artifact id cannot be resolved to an artifact type or
- * the artifact file does not exist on disk.
- */
-export class ReviseArtifactNotFoundError extends Error {
-    artifactId;
-    constructor(artifactId, message) {
-        super(message);
-        this.name = 'ReviseArtifactNotFoundError';
-        this.artifactId = artifactId;
-    }
-}
-/**
- * Revise a single artifact (dry-run).
- *
- * Does NOT write any files. The returned decision is the agent output after
- * schema validation; evidence verification, diff preview, and write live in
- * the CLI / apply path. Cascade, siblings, and declared sources are future
- * extensions.
- */
-export async function reviseArtifact(projectDir, config, provider, artifactId, options) {
-    const artifactType = findArtifactTypeById(artifactId);
-    if (!artifactType) {
-        throw new ReviseArtifactNotFoundError(artifactId, `Cannot determine artifact type from ID: ${artifactId}. Expected format: EPIC-001, FEAT-001, US-001, TASK-001.`);
-    }
-    const artifactRaw = await readArtifactRaw(projectDir, config, artifactType, artifactId);
-    if (artifactRaw === null) {
-        throw new ReviseArtifactNotFoundError(artifactId, `Artifact ${artifactId} not found under ${artifactType}/ directory.`);
-    }
-    const parents = await loadParentPromptArtifacts(projectDir, config, artifactType, artifactId);
-    const siblings = options.noSiblingContext
-        ? []
-        : await loadSiblingPromptArtifacts(projectDir, config, artifactType, artifactId, options.maxSiblings ?? 8);
-    let codebaseContextFormatted;
-    let codebaseCtx;
-    if (!options.noCodeContext) {
-        const keywords = extractKeywords(artifactRaw);
-        codebaseCtx = await buildCodebaseContext(projectDir, keywords);
-        codebaseContextFormatted = formatCodebaseContext(codebaseCtx);
-    }
-    const messages = buildRevisePrompt({
-        artifact: { id: artifactId, type: artifactType, content: artifactRaw },
-        parents,
-        siblings,
-        codebaseContextFormatted,
-        sources: [], // Declared-sources loader lands with the revise.yaml config work
-        writableScope: options.writableScope ?? 'all',
-        canonicalSections: getCanonicalSections(artifactType),
-    });
-    logger.debug(`reviseArtifact: calling AI for ${artifactId}`);
-    const result = await generateJSON(provider, messages, aiReviseDecisionSchema, {
-        maxTokens: TOKEN_BUDGETS.revise,
-    });
-    // resolveArtifactFilename strips the `.md` extension (other callers want the
-    // slug form). Revise must write to the full `.md` file, so append the
-    // extension explicitly. Defensive fallback if a future version ever returns
-    // a filename with the extension intact.
-    const filenameNoExt = await resolveArtifactFilename(projectDir, config, artifactType, artifactId);
-    const artifactDir = path.join(projectDir, getArtifactDir(config, artifactType));
-    const fullFilename = filenameNoExt.endsWith('.md') ? filenameNoExt : `${filenameNoExt}.md`;
-    const artifactPath = path.join(artifactDir, fullFilename);
-    const verifierContext = {
-        projectDir,
-        config,
-        artifactDir: path.dirname(artifactPath),
-        codebaseContextFormatted,
-        knownSourceRefs: [], // sources loader (future extension) will populate
-        knownPatternRuleIds: codebaseCtx ? codebaseCtx.patternRules.map((r) => r.name) : [],
-    };
-    return {
-        decision: result.result,
-        usage: result.usage ?? { inputTokens: 0, outputTokens: 0 },
-        contextStats: {
-            parentsLoaded: parents.length,
-            siblingsLoaded: siblings.length,
-            codebaseContextIncluded: !!codebaseContextFormatted,
-            sourcesLoaded: 0,
-        },
-        artifactPath,
-        originalContent: artifactRaw,
-        verifierContext,
-    };
-}
-/**
- * Apply a (verified) decision: write the artifact atomically when
- * `action === 'revise'` and `dryRun` is false, emit an audit entry
- * describing the outcome either way.
- *
- * Caller is expected to have already run `verifyDecision` — `applyDecision`
- * trusts that whatever decision arrives is allowed to be written.
- */
-export async function applyDecision(options) {
-    const { decision, audit, dryRun, originalContent, artifactPath, backupDir } = options;
-    const timestamp = new Date().toISOString();
-    if (decision.action === 'skip') {
-        audit.appendEntry({
-            artifactId: decision.artifactId,
-            artifactPath,
-            outcome: 'skipped-by-agent',
-            rationale: decision.rationale,
-            evidence: decision.evidence,
-            ambiguous: decision.ambiguous,
-            cascadeLevel: options.cascadeLevel,
-            timestamp,
-        });
-        return { outcome: 'skipped-by-agent', wrote: false, diff: '' };
-    }
-    if (decision.action === 'flag') {
-        // When a revise → flag demotion happened upstream, `revisedMarkdown`
-        // still holds the agent's proposed rewrite. Include the would-have-been
-        // diff in the audit entry so users can see what was rejected and decide
-        // whether to hand-apply it.
-        const proposedDiff = decision.revisedMarkdown
-            ? renderDiff(originalContent, decision.revisedMarkdown, {
-                color: false,
-                oldLabel: `${decision.artifactId} (before)`,
-                newLabel: `${decision.artifactId} (proposed — REJECTED by verifier)`,
-            })
-            : undefined;
-        audit.appendEntry({
-            artifactId: decision.artifactId,
-            artifactPath,
-            outcome: 'flagged',
-            rationale: decision.rationale,
-            evidence: decision.evidence,
-            ambiguous: decision.ambiguous,
-            cascadeLevel: options.cascadeLevel,
-            ...(proposedDiff ? { diff: proposedDiff } : {}),
-            timestamp,
-        });
-        return { outcome: 'flagged', wrote: false, diff: proposedDiff ?? '' };
-    }
-    // action === 'revise'
-    const diff = decision.revisedMarkdown
-        ? renderDiff(originalContent, decision.revisedMarkdown, {
-            color: false,
-            oldLabel: `${decision.artifactId} (before)`,
-            newLabel: `${decision.artifactId} (proposed)`,
-        })
-        : '';
-    // Short-circuit: if the agent returned content that is effectively
-    // identical to the original (byte-exact, or only trailing-whitespace
-    // differences from markdown serializer normalization), skip the write
-    // and report `unchanged-by-agent`. Prevents the "Proposed diff: <empty>
-    // → applied" UX bug where a trivial newline-strip got reported as a
-    // successful revise even though the agent explicitly said the artifact
-    // was already well-structured.
-    if (isEffectivelyUnchanged(originalContent, decision.revisedMarkdown)) {
-        audit.appendEntry({
-            artifactId: decision.artifactId,
-            artifactPath,
-            outcome: 'unchanged-by-agent',
-            rationale: decision.rationale,
-            evidence: decision.evidence,
-            ambiguous: decision.ambiguous,
-            cascadeLevel: options.cascadeLevel,
-            timestamp,
-        });
-        return { outcome: 'unchanged-by-agent', wrote: false, diff: '' };
-    }
-    if (dryRun) {
-        audit.appendEntry({
-            artifactId: decision.artifactId,
-            artifactPath,
-            outcome: 'would-apply',
-            rationale: decision.rationale,
-            evidence: decision.evidence,
-            ambiguous: decision.ambiguous,
-            cascadeLevel: options.cascadeLevel,
-            diff,
-            timestamp,
-        });
-        return { outcome: 'would-apply', wrote: false, diff };
-    }
-    // Real apply: atomic write + sidecar backup.
-    const backupPath = path.join(backupDir, `${decision.artifactId}.md.bak`);
-    await atomicWriteFile(artifactPath, decision.revisedMarkdown ?? '', { backupPath });
-    audit.appendEntry({
-        artifactId: decision.artifactId,
-        artifactPath,
-        outcome: 'applied',
-        rationale: decision.rationale,
-        evidence: decision.evidence,
-        ambiguous: decision.ambiguous,
-        cascadeLevel: options.cascadeLevel,
-        diff,
-        timestamp,
-    });
-    return { outcome: 'applied', wrote: true, diff };
-}
-/**
- * `true` when the agent's `revisedMarkdown` is byte-identical to `original`,
- * or differs only in trailing whitespace/newlines (LLM markdown serializers
- * routinely drop or add one trailing newline without changing semantics).
- *
- * Exported so the `--apply-from <audit>` replay path and the interactive
- * UI can share the same unchanged-detection rule.
- */
-export function isEffectivelyUnchanged(original, revised) {
-    if (revised === undefined)
-        return true;
-    if (revised === original)
-        return true;
-    return revised.replace(/\s+$/, '') === original.replace(/\s+$/, '');
-}
-/**
- * Load immediate-sibling artifacts (same artifact type, same parent) as
- * prompt entries. Lazy-reads each sibling's body only if it's going to be
- * included — the listing check is cheap, the reads are budgeted by
- * `maxSiblings` (default 8) so the prompt stays within token budget even on
- * epics with many features.
- *
- * For epic scope, there are no siblings (epics live at the top). For types
- * without a parent-id relationship (quick, backlog, etc.), returns empty.
- */
-export async function loadSiblingPromptArtifacts(projectDir, config, type, id, maxSiblings) {
-    const parentFieldByType = {
-        feature: 'epicId',
-        story: 'featureId',
-        task: 'storyId',
-    };
-    const parentField = parentFieldByType[type];
-    if (!parentField)
-        return [];
-    const self = await readArtifact(projectDir, config, type, id);
-    if (!self)
-        return [];
-    const parentId = self.data[parentField];
-    if (!parentId)
-        return [];
-    const siblings = [];
-    const listing = await listArtifacts(projectDir, config, type);
-    for (const entry of listing) {
-        if (siblings.length >= maxSiblings)
-            break;
-        if (entry.id === id)
-            continue;
-        const sib = await readArtifact(projectDir, config, type, entry.id);
-        if (sib && sib.data[parentField] === parentId) {
-            siblings.push({ id: entry.id, type, content: sib.content });
-        }
-    }
-    return siblings;
-}
-/**
- * Resolve the parent chain for an artifact and return it as the ordered
- * `RevisePromptArtifact[]` the prompt builder expects (epic → feature →
- * story). Empty array for top-level artifacts (epic scope).
- */
-export async function loadParentPromptArtifacts(projectDir, config, type, id) {
-    const chain = await getParentChain(projectDir, config, type, id);
-    const parents = [];
-    if (chain.epic) {
-        parents.push({
-            id: String(chain.epic.data.id),
-            type: 'epic',
-            content: chain.epic.content,
-        });
-    }
-    if (chain.feature) {
-        parents.push({
-            id: String(chain.feature.data.id),
-            type: 'feature',
-            content: chain.feature.content,
-        });
-    }
-    if (chain.story) {
-        parents.push({
-            id: String(chain.story.data.id),
-            type: 'story',
-            content: chain.story.content,
-        });
-    }
-    return parents;
-}
-//# sourceMappingURL=revise-service.js.map

package/dist/services/revise-service.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"revise-service.js","sourceRoot":"","sources":["../../src/services/revise-service.ts"],"names":[],"mappings":"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"}

package/dist/templates/rules/claude/planr-pipeline.md.hbs

@@ -1,69 +0,0 @@
-# Planr Pipeline — Claude Code reference
-
-> Generated by OpenPlanr on {{date}}
-> Pairs with `CLAUDE.md` (sibling). OpenPlanr Protocol v{{protocolVersion}} — runtime-agnostic contract.
-
-This project uses the portable **planr-pipeline** package through its native
-Claude Code adapter. Nine canonical roles orchestrate PO → Design → Review →
-DEV → QA while sharing deterministic engine behavior with Codex and Cursor.
-
-## Install (one-time)
-
-```bash
-curl -fsSL https://openplanr.dev/install.sh | sh
-cd my-project
-planr setup
-planr doctor
-```
-
-The installer installs the CLI only. Guided setup detects Claude Code and
-previews adapter changes before applying them. Legacy marketplace commands
-remain compatible during the migration window.
-
-## Slash commands
-
-| Command | Phase | What it does |
-|---|---|---|
-| `/planr-pipeline:plan {feature}` | PO Phase | Auto-scaffolds spec shell if missing → designer-agent → specification-agent. STOPS for human review (rule R1). |
-| `/planr-pipeline:ship {feature}` | DEV Phase | frontend-agent ‖ backend-agent → qa-agent gate → devops-agent ‖ doc-gen-agent → CLAUDE.md snapshot → `.pipeline-shipped` marker. |
-
-The native slash commands remain available; the same operations can be routed
-with `planr pipeline plan {feature}` and `planr pipeline ship {feature}`.
-
-## Hard rule R1 — never auto-chain
-
-**The pipeline refuses to chain PO → DEV automatically.** A human review step
-between `/planr-pipeline:plan` and `/planr-pipeline:ship` is mandatory.
-This is the most important rule and the differentiator of the workflow.
-
-## Spec-driven mode (recommended)
-
-If `.planr/config.json` declares `idPrefix.spec`, the pipeline reads from
-`.planr/specs/SPEC-NNN-{slug}/` directly — no conversion. Same artifacts the
-planr CLI authors. Two products, one schema.
-
-## Documentation
-
-- Full rules: `${CLAUDE_PLUGIN_ROOT}/docs/rules.md`
-- Pipeline overview: `${CLAUDE_PLUGIN_ROOT}/docs/pipeline-overview.md`
-- Spec / US / Task anatomies: `${CLAUDE_PLUGIN_ROOT}/docs/{spec,us,task}-anatomy.md`
-- Cross-runtime compatibility (Cursor, Codex): `${CLAUDE_PLUGIN_ROOT}/docs/compatibility-matrix.md`
-- OpenPlanr Protocol v1.0.0: `${CLAUDE_PLUGIN_ROOT}/docs/protocol/`
-
-## Cross-runtime parity
-
-The same workflow runs on Cursor and Codex via planr-generated rules:
-
-```bash
-# Cursor (.cursor/rules/planr-pipeline.mdc + agents/)
-planr rules generate --target cursor --scope pipeline
-
-# Codex (AGENTS.md with pipeline section)
-planr rules generate --target codex --scope pipeline
-```
-
-See `${CLAUDE_PLUGIN_ROOT}/docs/compatibility-matrix.md` for the full parity table and per-runtime caveats.
-
----
-
-*Generated from the portable pipeline command and role registries.*

package/dist/templates/rules/codex/_pipeline-section.md.hbs

@@ -1,154 +0,0 @@
-## Planr Pipeline Orchestration
-
-This project conforms to the **OpenPlanr Protocol v{{protocolVersion}}** — a runtime-agnostic contract for spec-driven AI workflows. As a Codex agent you are both planner and executor across two distinct phases.
-
-**Hard rule R1: never auto-chain PO Phase to DEV Phase.** Two user invocations required: "plan {feature}" and "ship {feature}".
-
-### Mode detection
-
-1. If `.planr/config.json` exists with `idPrefix.spec` set, you are in **spec-driven mode**.
-   - Spec dir: `.planr/specs/SPEC-NNN-{slug}/`
-   - Stories: `<SPEC_DIR>/stories/US-NNN-{slug}.md`
-   - Tasks (flat): `<SPEC_DIR>/tasks/T-NNN-{slug}.md`
-2. Otherwise, **default mode**:
-   - Feature dir: `output/feats/feat-{name}/`
-   - Stories: `<feat>/us-{N}/us-{N}.md`
-   - Tasks: `<feat>/us-{N}/tasks/task-{M}.md`
-
-| Concept | Default | Spec-driven |
-|---|---|---|
-| Spec source | `input/specs/spec-{name}.md` | `<SPEC_DIR>/SPEC-NNN-{slug}.md` |
-| Design spec | `output/feats/feat-{name}/design-spec.md` | `<SPEC_DIR>/design/design-spec.md` |
-| US output | `output/feats/feat-{name}/us-{N}/us-{N}.md` | `<SPEC_DIR>/stories/US-NNN-{slug}.md` |
-| Task output | `output/feats/feat-{name}/us-{N}/tasks/task-{M}.md` | `<SPEC_DIR>/tasks/T-NNN-{slug}.md` |
-
-### PO Phase — when user says "plan {feature}"
-
-Follow these steps in order. **STOP after step 4.**
-
-1. **Mode detection + input validation.** If spec-driven mode, scan `.planr/specs/` for `SPEC-NNN-{feature}` directory. If missing, auto-scaffold (see Auto-scaffolding below).
-2. **Read inputs:** spec body, `input/tech/stack.md`, optional `output/db/schema.json`, optional design-spec from PNGs.
-3. **Decompose:** read spec + stack + optional schema + optional design-spec, write US/Task files. Hard rule R2: max 2 tasks per US (1 if no PNG present). Each task's `rationale:` frontmatter field must be populated with 1-3 sentences explaining why this task exists.
-4. **Clarification loop:** if genuine ambiguity exists (two valid interpretations → different architectures), emit `clarifications.md` with structured options. Continue decomposing unambiguous parts. On re-run, read resolved clarifications and use them.
-5. **STOP.** Print a summary. Wait for the human to type "ship {feature}".
-
-### DEV Phase — when user says "ship {feature}"
-
-1. **Read project memory:** if `.planr/memory.md` exists, keyword-match relevant entries (traps, decisions, corrections) against the current task's file list. Include matched entries in the persona's context to avoid repeating past mistakes.
-2. Validate task files exist. Read each task's `status` frontmatter — skip `done`, enqueue `pending`/`in-progress`/`blocked`.
-3. For each US in topological order, dispatch tasks:
-   - `Type: UI` → adopt the **frontend** persona (writes UI files only).
-   - `Type: Tech` → adopt the **backend** persona (writes services, DTOs, entities, controllers, DB queries — never UI).
-3. Apply the **3-iteration correction loop** (R6) per task:
-   - Iteration 1: direct fix on build/test failure (`BuildCommand` + `TestCommand` from `input/tech/stack.md`).
-   - Iteration 2: re-read task spec + design-spec/schema, fix holistically.
-   - Iteration 3: minimal safe fix, flag remaining issues.
-   - On entering iteration 2: append a trap entry to `.planr/memory.md` under `## Traps` — `- [YYYY-MM-DD, T-NNN] <what failed and fix approach>`. Create the file from template if absent.
-   - On 3rd failure: write `T-NNN-error-report.md` and stop that task.
-4. Run **QA gate** (qa persona, read-only): verify Create/Modify/Preserve lists, build, test, DoD. If task has `rationale:`, check implementation drift vs stated intent (non-blocking warning).
-5. Optionally generate Docker/CI (devops persona — file generators only, never deploys) and `Docs/feat-{name}/` (doc-gen persona).
-6. Refresh `CLAUDE.md` snapshot OR co-exist with planr-managed `CLAUDE.md` (see Snapshot rules below).
-7. Write `.pipeline-shipped` marker (proof of execution).
-
-### 8 named role personas
-
-When dispatching a task, adopt the corresponding role's behaviour. Codex doesn't have separate subagent processes — these are persona shifts within the same session, but the role's constraints are binding:
-
-- **db** — read-only DB introspection. Never DDL/DML. Output: `output/db/schema.json`.
-- **designer** — PNG analysis → `design-spec.md`. Read/Write only, no shell.
-- **specification** — spec → US + Task files. No shell. Strict R2 (max 2 tasks/US).
-- **frontend** — UI files only. Never touches services, controllers, DTOs, entities.
-- **backend** — services, DTOs, entities, controllers, DB queries. Never touches UI files.
-- **qa** — read-only verification. Runs build + test. Writes only `qa-report.md`.
-- **devops** — Docker, CI, env templates. **No shell whatsoever — never deploys.**
-- **doc-gen** — `Docs/feat-{name}/` from US, tasks, generated source.
-
-### Auto-scaffolding (when spec is missing)
-
-When `<SPEC_DIR>/SPEC-NNN-{feature}.md` is missing in spec-driven mode:
-
-1. Ensure `.planr/config.json` exists with `idPrefix.spec: "SPEC"`.
-2. Ensure `.planr/specs/` exists.
-3. Determine next SPEC ID by scanning existing `SPEC-NNN-*/` dirs.
-4. Create `.planr/specs/SPEC-NNN-{feature}/{stories,tasks,design}/`.
-5. Write a placeholder spec body to `<SPEC_DIR>/SPEC-NNN-{feature}.md` (use the v1.0.0 spec schema).
-6. Print: `✓ Scaffolded SPEC-NNN-{feature}. Edit the spec body, then re-run: plan {feature}`. ABORT.
-7. **Do not invoke any role.** Decomposition runs only on the second invocation, after the user has filled in the body.
-
-### Self-healing in spec mode
-
-When `input/tech/stack.md` is missing:
-
-1. Write a v1.0.0 stack template to `input/tech/stack.md` (project name, language, framework, ORM, BuildCommand, TestCommand). Create `input/tech/` if absent.
-2. Print: `✓ Created input/tech/stack.md from template. Edit to declare your real stack, then re-run: plan {feature}`. ABORT.
-
-### Snapshot rules (R7)
-
-At the end of `/ship`, refresh `CLAUDE.md` (or AGENTS.md, if that's the canonical doc for this project). Capture:
-- Project Identity (name, version, stack)
-- Phase Status (filesystem scan)
-- Feature Registry
-- Active roles + tier
-- Build Log (append-only — never truncate)
-- Known Issues (scan `error-report.md` files)
-- Stack Summary (embed `input/tech/stack.md`)
-
-**Coexistence with planr-managed CLAUDE.md:** if the existing `CLAUDE.md` opens with `> Generated by OpenPlanr` or contains `## Context-Gathering Protocol`, do NOT overwrite. Print: *"CLAUDE.md is planr-managed; pipeline state recorded via .pipeline-shipped marker."* and skip the snapshot write.
-
-### `.pipeline-shipped` marker
-
-After a successful `/ship`, write a YAML marker:
-
-**Default mode:** `output/feats/feat-{feature}/.pipeline-shipped`
-**Spec-driven mode:** `<SPEC_DIR>/.pipeline-shipped`
-
-```yaml
-shipped_at: "<ISO 8601 UTC>"
-pipeline_version: "<runtime adapter writes its own version, e.g. 0.6.0>"
-protocol_version: "{{protocolVersion}}"
-runtime: "codex"
-mode: "<default | spec-driven>"
-feature: "{feature}"
-tasks_executed: <integer>
-tasks_failed: <integer>
-qa_gate_status: "<passed | failed | skipped>"
-duration_seconds: <integer>
-agents_invoked:
-  - frontend-agent
-  - backend-agent
-  - qa-agent
-  - devops-agent
-  - doc-gen-agent
-devops_status: "<generated | skipped>"
-docs_status: "<generated | skipped>"
-snapshot_status: "<refreshed | skipped>"
-error_reports:
-  - <path>
-```
-
-### Hard rules (Codex enforcement — prompt-level, not enforced by runtime)
-
-- **R1** — Never auto-chain PLAN → SHIP. Always wait for explicit "ship {feature}".
-- **R2** — Max 2 tasks per US.
-- **R3** — Roles using `Sonnet 5` are analysis/decomposition; roles using `Opus 4.8` are codegen. On Codex, use the model picker to match.
-- **R5** — Files in any task's `Preserve:` list MUST NOT be touched. Conformance test asserts this via `git diff` on Preserve paths.
-- **R6** — Max 3 correction iterations per task.
-- **R7** — Refresh CLAUDE.md (or skip if planr-managed); always write `.pipeline-shipped` marker.
-- **R8** — db role is read-only.
-- **R9** — frontend role only writes UI files; backend role only writes services/DTOs/entities. No crossover.
-- **R10** — No new agent role ships without corresponding qa coverage.
-
-Note: tool restrictions on Codex are advisory (prompt-level only), not enforced by the runtime. Treat them as binding — the conformance harness will catch violations post-ship.
-
-### Conformance proof
-
-The OpenPlanr Protocol v1.0.0 conformance test (in `planr-pipeline/conformance/runner.mjs`) verifies:
-- Post-PO state (US + Task files exist with valid frontmatter)
-- Post-DEV state (`src/` populated, build/test green, `.pipeline-shipped` marker present)
-- Preserve list integrity (`git diff` on each task's Preserve paths returns empty)
-
-Compatibility matrix: see `planr-pipeline/docs/compatibility-matrix.md` for the full Codex parity table.
-
----
-
-*Generated by `planr rules generate --target codex --scope pipeline`. The Codex adapter for OpenPlanr Protocol v1.0.0.*