@difflab/pi 0.7.0 → 0.7.1

package/skills/review/references/workflows/new.md

@@ -1,19 +1,9 @@
 # new
 
-## Arguments
+**Owner/tier:** foreground or background lifecycle coordinator; no Reviewer or Worker required.
 
-```text
-/review new [title] [--intent text] [--base branch] [--local] [--bg]
-```
+1. Parse title, intent, base, target, and `--local`. Call `review_context` first with the exact selection.
+2. Call `review_new` with the same target/backend/local values. This creates a local tuicr review or remote draft PR/MR and opens it; use `review_launch_ui` only when needed.
+3. Report the created target and draft state. Do not run findings, publish, complete, or merge.
 
-- `title` is the optional first positional argument; quote a title containing spaces.
-- `--intent` and `--base` each consume the following value. `--local` is a boolean backend flag; the skill handles `--bg` before this workflow.
-- Flags may appear in any order. Reject unknown or duplicate flags, missing flag values, and extra positional arguments. Stating this grammar before the procedure is intentional: an explicit argument contract is the best practice for making workflow behavior predictable and preventing ambiguous execution.
-
-## Workflow
-
-1. Parse the arguments using the grammar above after skill-owned background dispatch. A background child follows these steps directly and must not redispatch. A remote target is the current branch; `new` creates a new review rather than opening an existing one.
-2. Call `review_context` first with `local: true` when `--local` is present, otherwise `local: false`.
-3. Call `review_new` with the parsed title, intent, base branch, and the same explicit backend selection (`local: true` for `--local`, otherwise `local: false`). With `--local`, it creates and opens a local tuicr working-tree review. Without `--local`, it requires a clean, pushed branch, creates a draft PR/MR, and opens that PR/MR in tuicr.
-4. If a local session or remote PR/MR already exists, direct the user to `edit` instead.
-5. Report the PR/MR URL and whether tuicr opened in a mux, prepared a Zed task, or returned a command. Do not generate findings, publish, complete, or merge.
+Missing title/base, unsupported forge, dirty remote branch, or creation failure is an explicit error; never silently switch backend. `--bg` is one named child only.

package/skills/review/references/workflows/open.md

@@ -1,3 +1,5 @@
 # open
 
-Call `review_context` first. Without `--local`, call `review_open` to resolve an existing PR/MR and open its URL in the system browser. It must never create a PR/MR; if none exists, direct the user to `/review new`. If browser launch fails, show the plain URL. With `--local`, call `review_new` with `local=true` to preserve local working-tree behavior.
+**Owner/tier:** lifecycle coordinator, read-only.
+
+Call `review_context` first with the exact target/backend/local, then call `review_open`. It opens an existing remote PR/MR; it never creates one. With `--local`, preserve the local behavior selected by context. Report unsupported or missing targets and browser/launch failures; do not mutate review state.

package/skills/review/references/workflows/publish.md

@@ -1,8 +1,7 @@
 # publish
 
-1. Parse an optional PR/MR id or URL, `--local`, and one status: `--comment`, `--approve`, `--request-changes`, or `--close`. The default is comment. The skill has already handled `--bg`; a background child follows these steps without redispatch.
-2. Call `review_context` first with the target and `local: true` so the exact tuicr PR session can be inspected. If no matching local session exists, continue with `local: false` only for forge-native pending review work. If that session exists and has drafts, publish through the local promotion path even when the user omitted `--local`. Use `local: false` only when no matching tuicr session exists or when the target has forge-native pending review work.
-3. The local promotion path reads the exact tuicr session. A local line comment on the same file and line as an existing remote thread is treated as a response, not a new comment. A leading `[REOPEN]`, `[RESOLVE]`, or `[DELETE]` changes the thread state; the marker is removed from the response body. `[DELETE]` deletes the matched remote thread when the forge supports it. Other unpublished line comments become new review comments. The tool follows the stored local overlay path, posts unpublished replies to their remote threads, and then publishes the selected status. Question replies remain open. The tool does not post an overall review comment.
-4. For a forge-native review without a matching tuicr session, call `review_publish` without `local`. Existing pending forge comments already contain provenance, so the tool only publishes them with the selected status and no overall comment.
-5. Comment, approve, and request-changes mark a draft PR/MR ready before publication. Close publishes pending work as comment status and then closes the PR/MR. GitLab rejects request-changes because it has no equivalent review state.
-6. Report promoted comment and reply counts, the public status, and the final PR/MR state. Publishing never merges. If a response cannot be matched by file and line, report it as a new comment rather than silently attaching it to the wrong thread.
+**Owner/tier:** lifecycle coordinator; no Reviewer or Worker.
+
+1. Parse target, `--local`, and one status: comment (default), approve, request-changes, or close. Call `review_context` first and preserve the selected backend. A local promotion may be used only when context identifies the matching local session; never silently switch.
+2. Call `review_publish` with the same target/backend/local. It promotes/stages pending local work where applicable and publishes the selected status; remote comments remain pending until this call. Comment/approve/request-changes mark remote drafts ready; close publishes comment then closes. GitLab may reject request-changes.
+3. Report promoted bodies/comments/replies, status, and final state. Publish never merges. Unsupported target, unmatched response, or forge failure is explicit.

package/skills/review/references/workflows/status.md

@@ -1,3 +1,5 @@
 # status
 
-Call `review_context` first, then `review_status` with the same target and local setting. Report branch, worktree counts, local and remote review state, URLs, and remote tuicr state. Status must remain useful when no forge or tuicr binary is installed.
+**Owner/tier:** lifecycle coordinator, read-only.
+
+Call `review_context` first with the exact target/backend/local, then `review_status` with the same values. Report branch, worktree, forge/local review, URLs, and tuicr state. Missing or unsupported targets are errors; status never creates, publishes, completes, merges, or changes comments.

package/templates/plan/PLAN.md

@@ -1,13 +1,10 @@
-<!-- diffpi-plan: {"schemaVersion":1,"id":"{{id}}","revision":0,"branch":"{{branch}}","issueId":"{{issue_id}}","issueUrl":"{{issue_url}}","status":"draft","createdAt":"{{created_at}}","updatedAt":"{{updated_at}}"} -->
-
 # {{title}}
 
 - **Plan ID:** {{id}}
 - **Branch:** {{branch}}
+- **Status:** draft
 - **Issue:** {{issue_id}}
 - **Issue URL:** {{issue_url}}
-- **Status:** draft
-- **Revision:** 0
 
 ## Intent
 
@@ -15,26 +12,36 @@
 
 ## Requirements
 
-<!-- Add requirements. -->
+<!-- Add concrete requirements. -->
 
 ## Design
 
 ### Big Ideas
 
-<!-- Describe the main approach. -->
+<!-- Describe the outcome-oriented design. -->
 
 ### Key API Addition/Updates
 
-<!-- Describe public API changes. -->
+<!-- Describe public or internal contract changes. -->
 
 ### Consequences
 
-<!-- Describe trade-offs and limitations. -->
+<!-- Describe before/after behavior, risks, and trade-offs. -->
+
+## Phases
+
+<!-- Use numbered phases. State prerequisites on the phase only; do not add task dependencies here. -->
+
+### Phase 1: <!-- phase title -->
 
-## Implementation
+- **Phase ID:** <!-- assign a stable phase ID -->
+- **Prerequisites:** <!-- list phase IDs, or “None” -->
+- **Objective:** <!-- state the outcome -->
+- **Constraints:** <!-- phase guardrails or None; do not repeat them in briefs -->
 
-<!-- Add phases with one complete plan_apply_revision request. -->
+- [ ] <!-- assign a stable task ID --> Task title
+- [ ] <!-- assign a stable task ID --> Another task title
 
 ## References
 
-<!-- Add references. -->
+<!-- Add repository or external references. -->

package/templates/plan/implementation.md

@@ -1,30 +1,41 @@
-<!-- diffpi-implementation: {"schemaVersion":1,"planRevision":{{plan_revision}},"ordinal":{{phase_ordinal}},"phaseId":"{{phase_id}}"} -->
-
 # Phase {{phase_ordinal}}: {{phase_title}}
 
 - **Phase ID:** {{phase_id}}
-- **Plan Revision:** {{plan_revision}}
-
-## Summary
-
-{{phase_summary}}
+- **Prerequisites:** {{phase_prerequisites}}
 
 ## Objective
 
 {{phase_objective}}
 
-## Tasks
+## Files Affected
 
-{{phase_tasks}}
+<!-- This is the sole file scope for this phase. Use one fenced text tree; label each file leaf [ADD], [MODIFY], [REMOVE], [MOVE from: path], or [VERIFY]. Do not repeat file scopes in tasks or PLAN.md. -->
 
-## API Changes
+```text
+Phase {{phase_ordinal}}/
+├── [MODIFY] <!-- exact/path/to/implementation-file -->
+└── [VERIFY] <!-- exact/path/to/test-or-check -->
+{{phase_files_affected}}
+```
 
-{{phase_api}}
+## Tasks
+
+<!-- Keep tasks flat and in phase order. Repeat this shape for each task. -->
 
-## Libraries and Algorithms
+### 1. <!-- task title -->
 
-{{phase_libraries}}
+- **Task ID:** <!-- stable task ID -->
+- **Steps:**
+  1. <!-- ordered implementation action -->
+  2. <!-- ordered implementation action -->
+- **Verify:**
+  - <!-- command or inspection that proves this task -->
+- **Acceptance:** <!-- observable result -->
+
+{{phase_tasks}}
 
 ## Implementation Constraints
 
-{{phase_constraints}}
+<!-- Free-form implementation details, not a restatement of PLAN.md phase constraints. Add only useful optional headings: Required Libraries & Technology Choices, Key Algorithm Specifications, Core Invariants. Refer to the PLAN.md phase ID instead of repeating a phase guardrail. -->
+
+{{phase_implementation_constraints}}

package/dist/plan/index.d.ts

@@ -1,4 +0,0 @@
-export type { PlanCiRetry, PlanCiUpdate, PlanStatusUpdate, PlanStatusUpdateResult } from './operations';
-export { createPlanStore, type InitPlanInput, type NewPlanLogEntry, type PlanResolution, type PlanStore, type PlanStoreOptions, type ResolvePlanFilters, } from './store';
-export type * from './types';
-//# sourceMappingURL=index.d.ts.map

package/dist/plan/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plan/index.ts"],"names":[],"mappings":"AAEA,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACxG,OAAO,EACL,eAAe,EACf,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,GACxB,MAAM,SAAS,CAAC;AACjB,mBAAmB,SAAS,CAAC"}

package/dist/plan/markdown.d.ts

@@ -1,9 +0,0 @@
-import type { PlanDocument, PlanImplementationBrief, PlanPhase, PlanRecord, PlanValidationIssue, PlanValidationOptions } from './types';
-export declare function countDesignWords(plan: PlanDocument): number;
-export declare function validatePlanDocument(plan: PlanDocument, options?: PlanValidationOptions): PlanValidationIssue[];
-export declare function validatePlanBriefs(plan: PlanDocument, briefs: readonly PlanImplementationBrief[]): PlanValidationIssue[];
-export declare function validatePlanRecord(record: PlanRecord, options?: PlanValidationOptions): Promise<PlanValidationIssue[]>;
-export declare function renderImplementationBrief(planRevision: number, ordinal: number, phase: PlanPhase, brief: PlanImplementationBrief): string;
-export declare function renderPlanDocument(plan: PlanDocument, previousSource?: string): string;
-export declare function parsePlanDocument(source: string, ref?: string): PlanDocument;
-//# sourceMappingURL=markdown.d.ts.map

package/dist/plan/markdown.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/plan/markdown.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,YAAY,EACZ,uBAAuB,EACvB,SAAS,EACT,UAAU,EAGV,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,SAAS,CAAC;AAgDjB,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAM3D;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,GAAE,qBAA0B,GAAG,mBAAmB,EAAE,CAuDnH;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,YAAY,EAClB,MAAM,EAAE,SAAS,uBAAuB,EAAE,GACzC,mBAAmB,EAAE,CAqDvB;AAED,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,UAAU,EAClB,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAMhC;AAED,wBAAgB,yBAAyB,CACvC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,uBAAuB,GAC7B,MAAM,CAsDR;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,YAAY,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CAgEtF;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,SAAY,GAAG,YAAY,CA6B/E"}

package/dist/plan/operations.d.ts

@@ -1,43 +0,0 @@
-import type { SubagentEscalation } from '../extensions/subagentx';
-import type { PlanStore } from './store';
-import type { PlanCiStatus, PlanCommit, PlanDocument, PlanPhaseStatus, PlanRecord, PlanStatus } from './types';
-export interface PlanStatusUpdate {
-    target: {
-        type: 'plan' | 'phase' | 'task';
-        id?: string;
-    };
-    expectedStatus: PlanStatus | PlanPhaseStatus;
-    status: PlanStatus | PlanPhaseStatus;
-    actor: string;
-    message: string;
-    executionId?: string;
-    evidence?: string[];
-    blockedReason?: string;
-    attempts?: string[];
-    needsUserDecision?: boolean;
-    commit?: PlanCommit;
-}
-export interface PlanStatusUpdateResult {
-    record: PlanRecord;
-    escalation?: SubagentEscalation;
-}
-export interface PlanCiUpdate {
-    phaseId: string;
-    sha: string;
-    status: Exclude<PlanCiStatus, 'pending'>;
-    actor: string;
-    executionId: string;
-    detail: string;
-}
-export interface PlanCiRetry {
-    phaseId: string;
-    sha: string;
-    actor: string;
-    executionId: string;
-    reason: string;
-}
-export declare function updatePlanStatus(store: PlanStore, cwd: string, query: string, input: PlanStatusUpdate): Promise<PlanStatusUpdateResult>;
-export declare function updatePlanCi(store: PlanStore, cwd: string, query: string, input: PlanCiUpdate): Promise<PlanRecord>;
-export declare function retryPlanCi(store: PlanStore, cwd: string, query: string, input: PlanCiRetry): Promise<PlanRecord>;
-export declare function assertPhasePushEligible(plan: PlanDocument, phaseId: string, executionId: string): void;
-//# sourceMappingURL=operations.d.ts.map

package/dist/plan/operations.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../../src/plan/operations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,KAAK,EAEV,YAAY,EACZ,UAAU,EACV,YAAY,EAEZ,eAAe,EACf,UAAU,EACV,UAAU,EAGX,MAAM,SAAS,CAAC;AAIjB,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACzD,cAAc,EAAE,UAAU,GAAG,eAAe,CAAC;IAC7C,MAAM,EAAE,UAAU,GAAG,eAAe,CAAC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,UAAU,CAAC;IACnB,UAAU,CAAC,EAAE,kBAAkB,CAAC;CACjC;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,OAAO,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAID,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,SAAS,EAChB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,sBAAsB,CAAC,CAkIjC;AAED,wBAAsB,YAAY,CAChC,KAAK,EAAE,SAAS,EAChB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,YAAY,GAClB,OAAO,CAAC,UAAU,CAAC,CAwCrB;AAED,wBAAsB,WAAW,CAC/B,KAAK,EAAE,SAAS,EAChB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,WAAW,GACjB,OAAO,CAAC,UAAU,CAAC,CAoCrB;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAiBtG"}

package/dist/plan/reviews.d.ts

@@ -1,28 +0,0 @@
-import type { PlanRecord } from './types';
-interface PlanReviewDump {
-    schemaVersion: 1;
-    planId: string;
-    planRevision: number;
-    source: 'tuicr';
-    sourceId: string;
-    planSource: string;
-    content: string;
-}
-interface PlanReview {
-    path: string;
-    dump: PlanReviewDump;
-}
-interface PlanReviewRuntime {
-    execute?: (command: string, args: string[], cwd: string, interactive: boolean) => Promise<{
-        code: number;
-        stdout: string;
-        stderr: string;
-    }>;
-}
-export declare function createPlanReview(record: PlanRecord, runtime?: PlanReviewRuntime): Promise<{
-    code: number;
-    review: PlanReview;
-}>;
-export declare function readPlanReview(record: PlanRecord): Promise<PlanReview | undefined>;
-export {};
-//# sourceMappingURL=reviews.d.ts.map

package/dist/plan/reviews.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"reviews.d.ts","sourceRoot":"","sources":["../../src/plan/reviews.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAI1C,UAAU,cAAc;IACtB,aAAa,EAAE,CAAC,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,cAAc,CAAC;CACtB;AAED,UAAU,iBAAiB;IACzB,OAAO,CAAC,EAAE,CACR,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,OAAO,KACjB,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChE;AAID,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,UAAU,EAClB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAAE,CAAC,CA4B/C;AAED,wBAAsB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAiBxF"}

package/dist/plan/schema.d.ts

@@ -1,249 +0,0 @@
-import { z } from 'zod';
-export declare const planContextParametersSchema: z.ZodObject<{
-    cwd: z.ZodOptional<z.ZodString>;
-    plan: z.ZodOptional<z.ZodString>;
-    branch: z.ZodOptional<z.ZodString>;
-    statuses: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-        draft: "draft";
-        ready: "ready";
-        in_progress: "in_progress";
-        blocked: "blocked";
-        completed: "completed";
-    }>>>;
-}, z.core.$strict>;
-export declare const planInitParametersSchema: z.ZodObject<{
-    cwd: z.ZodOptional<z.ZodString>;
-    shortSlug: z.ZodString;
-    branch: z.ZodOptional<z.ZodString>;
-    title: z.ZodOptional<z.ZodString>;
-    intent: z.ZodOptional<z.ZodString>;
-    issueId: z.ZodOptional<z.ZodString>;
-    issueUrl: z.ZodOptional<z.ZodURL>;
-    request: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
-        kind: z.ZodLiteral<"annotation">;
-        text: z.ZodString;
-        response: z.ZodString;
-    }, z.core.$strict>, z.ZodObject<{
-        kind: z.ZodLiteral<"user">;
-        text: z.ZodString;
-        response: z.ZodOptional<z.ZodString>;
-    }, z.core.$strict>, z.ZodObject<{
-        kind: z.ZodLiteral<"blocker">;
-        text: z.ZodString;
-        response: z.ZodOptional<z.ZodString>;
-    }, z.core.$strict>], "kind">>;
-    open: z.ZodOptional<z.ZodBoolean>;
-}, z.core.$strict>;
-export declare const planApplyRevisionParametersSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
-    request: z.ZodDiscriminatedUnion<[z.ZodObject<{
-        kind: z.ZodLiteral<"annotation">;
-        text: z.ZodString;
-        response: z.ZodString;
-    }, z.core.$strict>, z.ZodObject<{
-        kind: z.ZodLiteral<"user">;
-        text: z.ZodString;
-        response: z.ZodOptional<z.ZodString>;
-    }, z.core.$strict>, z.ZodObject<{
-        kind: z.ZodLiteral<"blocker">;
-        text: z.ZodString;
-        response: z.ZodOptional<z.ZodString>;
-    }, z.core.$strict>], "kind">;
-    title: z.ZodString;
-    intent: z.ZodString;
-    requirements: z.ZodArray<z.ZodString>;
-    design: z.ZodObject<{
-        bigIdeas: z.ZodString;
-        keyApiUpdates: z.ZodString;
-        consequences: z.ZodString;
-    }, z.core.$strict>;
-    references: z.ZodArray<z.ZodObject<{
-        id: z.ZodString;
-        value: z.ZodString;
-    }, z.core.$strict>>;
-    phases: z.ZodArray<z.ZodObject<{
-        id: z.ZodString;
-        title: z.ZodString;
-        objective: z.ZodString;
-        dependencies: z.ZodArray<z.ZodString>;
-        tasks: z.ZodArray<z.ZodObject<{
-            id: z.ZodString;
-            title: z.ZodString;
-            dependencies: z.ZodArray<z.ZodString>;
-        }, z.core.$strict>>;
-    }, z.core.$strict>>;
-    briefs: z.ZodArray<z.ZodObject<{
-        phaseId: z.ZodString;
-        summary: z.ZodString;
-        apiChanges: z.ZodArray<z.ZodString>;
-        libraries: z.ZodArray<z.ZodString>;
-        constraints: z.ZodArray<z.ZodString>;
-        tasks: z.ZodArray<z.ZodObject<{
-            taskId: z.ZodString;
-            steps: z.ZodArray<z.ZodString>;
-            fileScopes: z.ZodArray<z.ZodString>;
-            acceptanceCriteria: z.ZodArray<z.ZodString>;
-        }, z.core.$strict>>;
-    }, z.core.$strict>>;
-    mode: z.ZodLiteral<"create">;
-    cwd: z.ZodOptional<z.ZodString>;
-    shortSlug: z.ZodString;
-    branch: z.ZodOptional<z.ZodString>;
-    issueId: z.ZodOptional<z.ZodString>;
-    issueUrl: z.ZodOptional<z.ZodURL>;
-}, z.core.$strict>, z.ZodObject<{
-    request: z.ZodDiscriminatedUnion<[z.ZodObject<{
-        kind: z.ZodLiteral<"annotation">;
-        text: z.ZodString;
-        response: z.ZodString;
-    }, z.core.$strict>, z.ZodObject<{
-        kind: z.ZodLiteral<"user">;
-        text: z.ZodString;
-        response: z.ZodOptional<z.ZodString>;
-    }, z.core.$strict>, z.ZodObject<{
-        kind: z.ZodLiteral<"blocker">;
-        text: z.ZodString;
-        response: z.ZodOptional<z.ZodString>;
-    }, z.core.$strict>], "kind">;
-    title: z.ZodString;
-    intent: z.ZodString;
-    requirements: z.ZodArray<z.ZodString>;
-    design: z.ZodObject<{
-        bigIdeas: z.ZodString;
-        keyApiUpdates: z.ZodString;
-        consequences: z.ZodString;
-    }, z.core.$strict>;
-    references: z.ZodArray<z.ZodObject<{
-        id: z.ZodString;
-        value: z.ZodString;
-    }, z.core.$strict>>;
-    phases: z.ZodArray<z.ZodObject<{
-        id: z.ZodString;
-        title: z.ZodString;
-        objective: z.ZodString;
-        dependencies: z.ZodArray<z.ZodString>;
-        tasks: z.ZodArray<z.ZodObject<{
-            id: z.ZodString;
-            title: z.ZodString;
-            dependencies: z.ZodArray<z.ZodString>;
-        }, z.core.$strict>>;
-    }, z.core.$strict>>;
-    briefs: z.ZodArray<z.ZodObject<{
-        phaseId: z.ZodString;
-        summary: z.ZodString;
-        apiChanges: z.ZodArray<z.ZodString>;
-        libraries: z.ZodArray<z.ZodString>;
-        constraints: z.ZodArray<z.ZodString>;
-        tasks: z.ZodArray<z.ZodObject<{
-            taskId: z.ZodString;
-            steps: z.ZodArray<z.ZodString>;
-            fileScopes: z.ZodArray<z.ZodString>;
-            acceptanceCriteria: z.ZodArray<z.ZodString>;
-        }, z.core.$strict>>;
-    }, z.core.$strict>>;
-    mode: z.ZodLiteral<"amend">;
-    cwd: z.ZodOptional<z.ZodString>;
-    plan: z.ZodString;
-    expectedPlanRevision: z.ZodNumber;
-}, z.core.$strict>], "mode">;
-export declare const planValidateParametersSchema: z.ZodObject<{
-    cwd: z.ZodOptional<z.ZodString>;
-    plan: z.ZodString;
-    strict: z.ZodOptional<z.ZodBoolean>;
-}, z.core.$strict>;
-export declare const planLogProgressParametersSchema: z.ZodObject<{
-    cwd: z.ZodOptional<z.ZodString>;
-    plan: z.ZodString;
-    actor: z.ZodString;
-    message: z.ZodString;
-    executionId: z.ZodOptional<z.ZodString>;
-    phaseId: z.ZodOptional<z.ZodString>;
-    taskId: z.ZodOptional<z.ZodString>;
-    evidence: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-}, z.core.$strict>;
-export declare const planRunGatesParametersSchema: z.ZodObject<{
-    cwd: z.ZodOptional<z.ZodString>;
-    plan: z.ZodString;
-    phaseId: z.ZodString;
-    expectedPhaseRevision: z.ZodNumber;
-    executionId: z.ZodString;
-    actor: z.ZodString;
-}, z.core.$strict>;
-export declare const planRecordCiParametersSchema: z.ZodObject<{
-    cwd: z.ZodOptional<z.ZodString>;
-    plan: z.ZodString;
-    phaseId: z.ZodString;
-    sha: z.ZodString;
-    executionId: z.ZodString;
-    actor: z.ZodString;
-    status: z.ZodEnum<{
-        skipped: "skipped";
-        passed: "passed";
-        failed: "failed";
-    }>;
-    detail: z.ZodString;
-    retryReason: z.ZodOptional<z.ZodString>;
-}, z.core.$strict>;
-export declare const planLookupParametersSchema: z.ZodObject<{
-    cwd: z.ZodOptional<z.ZodString>;
-    plan: z.ZodOptional<z.ZodString>;
-}, z.core.$strict>;
-export declare const planStartExecutionParametersSchema: z.ZodObject<{
-    cwd: z.ZodOptional<z.ZodString>;
-    plan: z.ZodString;
-    commitMode: z.ZodEnum<{
-        push: "push";
-        "no-commit": "no-commit";
-        commit: "commit";
-    }>;
-    actor: z.ZodString;
-}, z.core.$strict>;
-export declare const planUpdateStatusParametersSchema: z.ZodObject<{
-    cwd: z.ZodOptional<z.ZodString>;
-    plan: z.ZodString;
-    target: z.ZodObject<{
-        type: z.ZodEnum<{
-            phase: "phase";
-            task: "task";
-            plan: "plan";
-        }>;
-        id: z.ZodOptional<z.ZodString>;
-    }, z.core.$strict>;
-    expectedStatus: z.ZodEnum<{
-        draft: "draft";
-        ready: "ready";
-        in_progress: "in_progress";
-        blocked: "blocked";
-        completed: "completed";
-        pending: "pending";
-        skipped: "skipped";
-    }>;
-    status: z.ZodEnum<{
-        draft: "draft";
-        ready: "ready";
-        in_progress: "in_progress";
-        blocked: "blocked";
-        completed: "completed";
-        pending: "pending";
-        skipped: "skipped";
-    }>;
-    actor: z.ZodString;
-    message: z.ZodString;
-    executionId: z.ZodOptional<z.ZodString>;
-    evidence: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    blockedReason: z.ZodOptional<z.ZodString>;
-    attempts: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    needsUserDecision: z.ZodOptional<z.ZodBoolean>;
-    commit: z.ZodOptional<z.ZodObject<{
-        sha: z.ZodString;
-        subject: z.ZodString;
-        completedAt: z.ZodString;
-        pushedAt: z.ZodOptional<z.ZodString>;
-        ci: z.ZodOptional<z.ZodObject<{
-            status: z.ZodLiteral<"pending">;
-            startedAt: z.ZodString;
-        }, z.core.$strict>>;
-    }, z.core.$strict>>;
-}, z.core.$strict>;
-export type PlanRevisionDraft = z.infer<typeof planApplyRevisionParametersSchema>;
-//# sourceMappingURL=schema.d.ts.map

package/dist/plan/schema.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/plan/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA0DxB,eAAO,MAAM,2BAA2B;;;;;;;;;;;kBAO7B,CAAC;AAEZ,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;kBAY1B,CAAC;AAEZ,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4BAqB5C,CAAC;AAEH,eAAO,MAAM,4BAA4B;;;;kBAE9B,CAAC;AAEZ,eAAO,MAAM,+BAA+B;;;;;;;;;;kBAYjC,CAAC;AAEZ,eAAO,MAAM,4BAA4B;;;;;;;kBAS9B,CAAC;AAEZ,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;kBAY9B,CAAC;AAEZ,eAAO,MAAM,0BAA0B;;;kBAAkE,CAAC;AAE1G,eAAO,MAAM,kCAAkC;;;;;;;;;kBAOpC,CAAC;AAEZ,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA+BlC,CAAC;AAEZ,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC"}

package/dist/plan/store.d.ts

@@ -1,75 +0,0 @@
-import { type DiffpiLogEntry, type NewLogEntry } from '../log';
-import type { PlanAuthoringRequest, PlanDocument, PlanImplementationBrief, PlanLogEntry, PlanRecord, PlanStatus } from './types';
-export type NewPlanLogEntry = NewLogEntry<PlanLogEntry & DiffpiLogEntry>;
-export interface PlanStoreOptions {
-    homeDir?: string;
-    now?: () => Date;
-    bundledTemplatesDir?: string;
-}
-export interface ResolvePlanFilters {
-    branch?: string;
-    statuses?: readonly PlanStatus[];
-}
-export interface PlanResolution {
-    candidates: PlanRecord[];
-    record?: PlanRecord;
-    ambiguous: boolean;
-}
-export interface PlanTaskDraft {
-    id: string;
-    title: string;
-    dependencies: string[];
-}
-export interface PlanPhaseDraft {
-    id: string;
-    title: string;
-    objective: string;
-    dependencies: string[];
-    tasks: PlanTaskDraft[];
-}
-interface PlanRevisionContent {
-    request: PlanAuthoringRequest;
-    title: string;
-    intent: string;
-    requirements: string[];
-    design: PlanDocument['design'];
-    references: PlanDocument['references'];
-    phases: PlanPhaseDraft[];
-    briefs: PlanImplementationBrief[];
-}
-export interface CreatePlanRevisionRequest extends PlanRevisionContent {
-    mode: 'create';
-    shortSlug: string;
-    branch: string;
-    issueId?: string;
-    issueUrl?: string;
-}
-export interface AmendPlanRevisionRequest extends PlanRevisionContent {
-    mode: 'amend';
-    plan: string;
-    expectedPlanRevision: number;
-}
-export type PlanRevisionRequest = CreatePlanRevisionRequest | AmendPlanRevisionRequest;
-export interface InitPlanInput {
-    cwd: string;
-    shortSlug: string;
-    branch: string;
-    title?: string;
-    intent?: string;
-    issueId?: string;
-    issueUrl?: string;
-    request?: PlanAuthoringRequest;
-}
-export interface PlanStore {
-    context(cwd: string, query?: string, filters?: ResolvePlanFilters): Promise<PlanResolution>;
-    init(input: InitPlanInput): Promise<PlanRecord>;
-    read(cwd: string, query: string, filters?: ResolvePlanFilters): Promise<PlanRecord>;
-    mutate(cwd: string, query: string, operation: string, update: (document: PlanDocument) => PlanDocument | Promise<PlanDocument>): Promise<PlanRecord>;
-    applyRevision(cwd: string, request: PlanRevisionRequest): Promise<PlanRecord>;
-    log(cwd: string, query: string, event: NewPlanLogEntry): Promise<PlanLogEntry>;
-}
-export declare function planRecordName(shortSlug: string, date?: Date): string;
-export declare function resolvePlan(cwd: string, query?: string, filters?: ResolvePlanFilters, options?: PlanStoreOptions): Promise<PlanResolution>;
-export declare function createPlanStore(options?: PlanStoreOptions): PlanStore;
-export {};
-//# sourceMappingURL=store.d.ts.map

package/dist/plan/store.d.ts.map

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