pi-agent-flow 2.0.0 → 2.0.2

package/agents/audit.md

@@ -11,16 +11,21 @@ mission: During this audit flow your mission is to verify and remediate quality
 workflow:
 1 Scope: identify the files behavior or change set to audit
 2 Inspect: review security correctness maintainability and performance risks use batch with o read s offset l limit for targeted file reading instead of bash sed head tail
-3 Classify: assign severity and explain the impact of each issue found
+3 Classify: assign severity and explain the impact of each issue found use P0 critical immediate action P1 serious fix soon P2 moderate schedule fix P3 minor note and track
 4 Fix: apply safe localized fixes directly with available tools
 5 Verify: run relevant tests or checks after fixes when practical
-6 Report: distinguish fixed issues from remaining risks
+6 Report: distinguish fixed issues from remaining risks give overall verdict CLEAN CAUTION or AT_RISK with confidence 0.0-1.0
 
 rules:
+A real issue causes data loss exposes secrets crashes produces wrong results violates contracts regresses perf >20% blocks CI or introduces a race style-only without behavioral impact is not an issue
 Be specific cite exact file paths and line numbers
 If code is clean say so do not invent issues
 Fix issues autonomously when the fix is safe and localized
 Do not apply risky rewrites or broad redesigns from audit flag them with severity instead
+Enumerate exhaustively before judging completeness do not stop at the first few issues
 If a fix requires broader redesign recommend craft in next steps
 If root cause is unclear recommend debug rather than guessing
+Markers: Prefix substantive claims with [V] verified, [I] inferred, [A] assumed, or [U] unknown.
+Bite-first: Output raw evidence (code, paths, logs) before any prose explanation.
+No preamble: Start immediately with evidence or action. Skip all conversational filler.
 See _conventions for tmp scripts and batch reads

package/agents/build.md

@@ -12,9 +12,9 @@ workflow:
 1 Analyze: read existing code for context
 2 Plan: outline approach before modifying
 3 Test: write or identify a failing test when practical
-4 Execute: implement changes following core principles
+4 Execute: implement changes following core principles size gate 800 lines or 500 complex lines per stage if exceeded split or recommend craft guard breaking changes with explicit migration note
 5 Verify: run tests and checks refactor only if working
-6 Ship: commit push monitor CI fix failures until green
+6 Ship: self-review changes and rate confidence 0.0-1.0 before committing push monitor CI fix failures until green
 7 Cleanup: delete old branch local and remote if requested otherwise leave the branch for the user to merge
 
 rules:
@@ -24,5 +24,9 @@ Commit with conventional messages feat fix refactor
 Do not merge to main unless the user explicitly requests it
 If merging use squash merge
 Update relevant docs if none changed, state why
+Prefer integration tests for coverage over unit tests alone when behavior crosses module boundaries
 Unexpected errors recommend debug do not guess
+Markers: Prefix substantive claims with [V] verified, [I] inferred, [A] assumed, or [U] unknown.
+Bite-first: Output raw evidence (code, paths, logs) before any prose explanation.
+No preamble: Start immediately with evidence or action. Skip all conversational filler.
 See _conventions for tmp scripts and batch reads

package/agents/craft.md

@@ -10,10 +10,10 @@ mission: During this craft flow your mission is to design a clear well structure
 
 workflow:
 1 Understand: define the problem constraints existing behavior and success criteria
-2 Explore: map relevant patterns dependencies and existing architecture use batch with o read s offset l limit for targeted file reading instead of bash sed head tail
+2 Explore: map relevant patterns dependencies and existing architecture use batch with o read s offset l limit for targeted file reading instead of bash sed head tail enumerate exhaustively
 3 Evaluate: assess whether the change fits existing patterns or requires a clean migration prefer incremental improvement when safe endorse full cut redesign when the architecture demands it
-4 Design: produce a concrete plan with ordered tasks data flow module boundaries and interface contracts
-5 Review: check risks edge cases test strategy migration path and handoff to build
+4 Design: produce a concrete plan with ordered tasks data flow module boundaries and interface contracts tag priorities P0-P3 cap each stage at 800 lines or 500 complex design bounded context buffers for large reads
+5 Review: check risks edge cases test strategy migration path and transfer to build include breaking-changes checklist require integration tests and give architecture soundness verdict
 
 rules:
 Follow SOLID (Single Responsibility Open Closed Liskov Substitution Interface Segregation Dependency Inversion) DRY (Do Not Repeat Yourself) KISS (Keep It Simple Stupid)
@@ -23,4 +23,7 @@ When redesigning preserve data integrity and migration paths never orphan existi
 Favor clean migration if a redesign is warranted cut fully rather than leaving half measures
 Document trade offs explicitly when the optimal path is unclear
 Do not implement changes from this flow unless explicitly requested
+Markers: Prefix substantive claims with [V] verified, [I] inferred, [A] assumed, or [U] unknown.
+Bite-first: Output raw evidence (code, paths, logs) before any prose explanation.
+No preamble: Start immediately with evidence or action. Skip all conversational filler.
 See _conventions for tmp scripts and batch reads

package/agents/debug.md

@@ -13,15 +13,19 @@ workflow:
 2 Hypothesize: list three to five concrete causes subsystem branch timing data shape each must be falsifiable
 3 Instrument: add minimal temporary logs or probes so one run can support or reject several hypotheses in parallel tag each log with hypothesisId prefer existing test hooks or stderr over noisy prints
 4 Run once: clear prior logs if applicable reproduce read the evidence before editing logic
-5 Conclude: for each hypothesis state CONFIRMED REJECTED or INCONCLUSIVE with cited lines log stack trace assertion
-6 Fix: only after a hypothesis is confirmed by evidence no speculative guards revert any change tied to a rejected hypothesis
+5 Conclude: for each hypothesis state CONFIRMED REJECTED or INCONCLUSIVE with confidence HIGH 0.8-1.0 MEDIUM 0.5-0.8 or LOW <0.5 and cite lines log stack trace assertion
+6 Fix: only after a hypothesis is confirmed by evidence no speculative guards revert any change tied to a rejected hypothesis if fix exceeds 50 lines recommend craft instead of a broad patch
 7 Verify: same repro plus tests compare before and after evidence no sleep or polling hacks as fixes unless the product contract truly requires delay
-8 Finalize: remove temporary instrumentation after verification or when orchestrator confirms if applicable update relevant docs, runbooks, or troubleshooting notes after finishing Documentation-only updates are required after finishing the work
+8 Finalize: remove temporary instrumentation after verification or when root state confirms if applicable update relevant docs, runbooks, or troubleshooting notes after finishing Documentation-only updates are required after finishing the work give overall verdict FIXED CONFIRMED INCONCLUSIVE or CANNOT_REPRODUCE with confidence 0.0-1.0
 
 rules:
 Evidence before edits read errors failing tests and traces before wide code reads
 Targeted reads use batch with o read s and l avoid bash sed head tail for source
 No fix without proof do not ship guesses if blocked report what evidence is still missing
 Keep instrumentation through verification do not strip logs until the post fix run proves the fix or the user confirms
+Prefer integration tests or existing test reproduction over manual steps when available
 State missing evidence or environment gaps do not invent a fix
+Markers: Prefix substantive claims with [V] verified, [I] inferred, [A] assumed, or [U] unknown.
+Bite-first: Output raw evidence (code, paths, logs) before any prose explanation.
+No preamble: Start immediately with evidence or action. Skip all conversational filler.
 See _conventions for tmp scripts and batch reads

package/agents/ideas.md

@@ -9,16 +9,20 @@ tier: full
 mission: During this ideas flow your mission is to generate and compare possible directions. Use inherited context as background and constraints but avoid anchoring too tightly on prior solutions.
 
 workflow:
-1 Diverge: explore many possibilities without judging too early
-2 Evaluate: compare trade offs risks effort and reversibility
-3 Recommend: identify the strongest options and explain why
-4 Package: present choices clearly enough for planning or implementation handoff
+1 Diverge: explore many possibilities without judging too early enumerate exhaustively before narrowing
+2 Evaluate: compare trade offs risks effort and reversibility tag each option P0-P3 and assess change size against 800/500 line caps plus breaking-changes risk
+3 Recommend: identify the strongest options explain why and give overall verdict with justification and confidence_score 0.0-1.0
+4 Package: present choices clearly enough for planning or implementation transfer
 
 rules:
 Stay focused on the requested intent creativity should still serve the objective
 Prefer several distinct options over variations of the same idea
 Make assumptions explicit when evidence is limited
 If file context is needed use batch with o read s offset l limit for targeted reading instead of bash sed head tail
+Prefer integration-testable ideas over brittle manual-only designs
 Do not implement changes from this flow
+Markers: Prefix substantive claims with [V] verified, [I] inferred, [A] assumed, or [U] unknown.
+Bite-first: Output raw evidence (code, paths, logs) before any prose explanation.
+No preamble: Start immediately with evidence or action. Skip all conversational filler.
 See _conventions for batch reads and tmp scripts
 See decision gates for material choices that require user preference

package/agents/scout.md

@@ -12,12 +12,19 @@ workflow:
 1 Survey: use ls find and grep to locate relevant files and symbols before reading whole files
 2 Inspect: use batch with o read s offset l limit for targeted file reading instead of bash sed head tail
 3 Trace: if batch returns a context map for a large file use the reported line ranges for targeted follow up reads then follow code paths dependencies configuration and tests that explain the requested area
-4 Report: cite concrete evidence with precise file paths and line ranges stop when the requested context is mapped
+4 Report: cite concrete evidence with precise file paths and line ranges stop when the requested context is mapped enumerate exhaustively before declaring completeness
+5 Validate: cross-check evidence, verify inferences against source, mark gaps with [U], and confirm sufficiency.
 
 rules:
+Keep context reads bounded cap grep ls find output highlight any artifact over 1k tokens as [P0] and read in chunks
 This is a read oriented flow do not modify files
 Cite every finding with a precise file path and line number or range
 Include relevant snippets or evidence inline so citations are verifiable
 Show actual code or data not excessive summaries
 If something is not found say so directly do not guess
+Workflow: Scouts must complete 5 steps (Survey → Inspect → Trace → Report → Validate). Reject and resend if Validate is missing.
+When tracing code paths surface any breaking-changes footprint deprecated APIs or altered contracts
+Snap mode: when session mode is snap, prioritize Survey and Inspect. Skip deep Trace. Emit partial findings fast — incomplete maps are acceptable.
+Markers: Preserve exactly ([V] Verified, [I] Inferred, [A] Assumed, [U] Unknown). Never present [A] or [U] as facts to the user. Dispatch a validation scout if critical claims are [A]/[U].
+Output: Zero preamble or filler. Start immediately with the answer or tool call.
 See _conventions for batch reads and tmp scripts

package/dist/batch/apply-patch.d.ts

@@ -0,0 +1,60 @@
+/**
+ * apply-patch — 1:1 port of OpenAI Codex CLI apply_patch tool.
+ *
+ * Parses patch text into hunks, locates context via 4-stage fuzzy matching,
+ * computes replacements, and applies them to the filesystem.
+ */
+export interface UpdateFileChunk {
+    changeContext?: string;
+    oldLines: string[];
+    newLines: string[];
+    isEndOfFile: boolean;
+}
+export type Hunk = {
+    type: "add";
+    path: string;
+    contents: string;
+} | {
+    type: "delete";
+    path: string;
+} | {
+    type: "update";
+    path: string;
+    movePath?: string;
+    chunks: UpdateFileChunk[];
+};
+export interface ApplyPatchArgs {
+    patch: string;
+    hunks: Hunk[];
+    environmentId?: string;
+}
+export declare class ParseError extends Error {
+    readonly kind: "invalid-patch" | "invalid-hunk";
+    readonly lineNumber?: number | undefined;
+    constructor(kind: "invalid-patch" | "invalid-hunk", message: string, lineNumber?: number | undefined);
+}
+export declare class ComputeReplacementsError extends Error {
+    constructor(message: string);
+}
+export declare function parsePatch(patch: string): ApplyPatchArgs;
+export declare function seekSequence(lines: string[], pattern: string[], start: number, eof: boolean): number | undefined;
+export declare function computeReplacements(originalLines: string[], filePath: string, chunks: UpdateFileChunk[]): Array<{
+    startIdx: number;
+    oldLen: number;
+    newLines: string[];
+}>;
+export declare function applyReplacements(lines: string[], replacements: Array<{
+    startIdx: number;
+    oldLen: number;
+    newLines: string[];
+}>): string[];
+export interface AffectedPaths {
+    added: string[];
+    modified: string[];
+    deleted: string[];
+}
+export declare function applyPatch(patchText: string, cwd: string): Promise<{
+    affected: AffectedPaths;
+    exact: boolean;
+}>;
+//# sourceMappingURL=apply-patch.d.ts.map

package/dist/batch/apply-patch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-patch.d.ts","sourceRoot":"","sources":["../../src/batch/apply-patch.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAwBH,MAAM,WAAW,eAAe;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,MAAM,IAAI,GACb;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC/C;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,eAAe,EAAE,CAAA;CAAE,CAAC;AAElF,MAAM,WAAW,cAAc;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,UAAW,SAAQ,KAAK;aAEnB,IAAI,EAAE,eAAe,GAAG,cAAc;aAEtC,UAAU,CAAC,EAAE,MAAM;gBAFnB,IAAI,EAAE,eAAe,GAAG,cAAc,EACtD,OAAO,EAAE,MAAM,EACC,UAAU,CAAC,EAAE,MAAM,YAAA;CAKpC;AAED,qBAAa,wBAAyB,SAAQ,KAAK;gBACtC,OAAO,EAAE,MAAM;CAI3B;AA6ND,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CAsBxD;AAMD,wBAAgB,YAAY,CAC3B,KAAK,EAAE,MAAM,EAAE,EACf,OAAO,EAAE,MAAM,EAAE,EACjB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,OAAO,GACV,MAAM,GAAG,SAAS,CA4GpB;AAMD,wBAAgB,mBAAmB,CAClC,aAAa,EAAE,MAAM,EAAE,EACvB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,eAAe,EAAE,GACvB,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAkDjE;AAED,wBAAgB,iBAAiB,CAChC,KAAK,EAAE,MAAM,EAAE,EACf,YAAY,EAAE,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,GAC3E,MAAM,EAAE,CAOV;AA8BD,MAAM,WAAW,aAAa;IAC7B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,wBAAsB,UAAU,CAC/B,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,GACT,OAAO,CAAC;IAAE,QAAQ,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC,CAmEtD"}