@shepai/cli 1.144.0 → 1.145.0-pr452.8b628a7

package/dist/packages/core/src/infrastructure/services/agents/feature-agent/nodes/prompts/merge-prompts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"merge-prompts.d.ts","sourceRoot":"","sources":["../../../../../../../../../../packages/core/src/infrastructure/services/agents/feature-agent/nodes/prompts/merge-prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAE3E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAwCxD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAU9F;AAuCD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,QAAQ,EAAE,EACpB,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,CAUR;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,iBAAiB,EACxB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,CAqER;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,GACb,MAAM,CA0BR"}
+{"version":3,"file":"merge-prompts.d.ts","sourceRoot":"","sources":["../../../../../../../../../../packages/core/src/infrastructure/services/agents/feature-agent/nodes/prompts/merge-prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAE3E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAwCxD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAU9F;AAuCD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,QAAQ,EAAE,EACpB,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,CAUR;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,iBAAiB,EACxB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,CAyER;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,GACb,MAAM,CA0BR;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAqDzD"}

package/dist/packages/core/src/infrastructure/services/agents/feature-agent/nodes/prompts/merge-prompts.js

@@ -128,8 +128,11 @@ export function buildCommitPushPrPrompt(state, branch, baseBranch, repoUrl) {
         : '';
     const steps = [];
     // Step 1: Commit (always)
+    const stageCmd = state.commitSpecs
+        ? '`git add -A`'
+        : '`git add -A` then `git reset -- specs/` (do NOT commit the specs/ directory)';
     steps.push(`1. Review the current changes using \`git diff\` and \`git status\`
-2. Stage all changes with \`git add -A\`
+2. Stage changes with ${stageCmd}
 3. Write a conventional commit message based on the actual diff content
    - Use the format: \`feat(<scope>): <description>\` or \`fix(<scope>): <description>\`
    - The commit message should summarize what actually changed, not be generic
@@ -177,6 +180,7 @@ ${evidenceSection}
 
 - Write a meaningful conventional commit message derived from the actual diff — do NOT use generic messages
 ${rejectionSection ? '- You MUST modify source code files to address the rejection feedback above BEFORE committing' : '- Do NOT modify any source code files — only perform git operations'}
+${!state.commitSpecs ? '- Do NOT commit the `specs/` directory — it must stay untracked. If you accidentally staged it, run `git reset -- specs/` before committing' : ''}
 - Do NOT amend existing commits
 - Do NOT run \`git pull\`, \`git rebase\`, or \`git merge\` — this is a fresh branch, push it directly
 - If there are no changes to commit, skip the commit step and report that no changes were found`;
@@ -219,3 +223,66 @@ ${failureLogs}
 - Do NOT create a new branch — push directly to \`${branch}\`
 - If the failure is unclear, make your best diagnosis and explain your reasoning in the commit message`;
 }
+/**
+ * Build a prompt for the CI watch agent call.
+ *
+ * Instructs the agent to check ALL CI runs for a branch, wait for all
+ * to complete, verify every run passed, and report structured status.
+ * Generic — works with any git/gh repo, not tied to specific workflows.
+ *
+ * @param branch - Feature branch name to watch CI for
+ */
+export function buildCiWatchPrompt(branch) {
+    return `You are checking CI status for branch \`${branch}\`.
+
+## Instructions
+
+Follow these steps EXACTLY:
+
+### Step 1: List all CI runs for the branch
+
+\`\`\`
+gh run list --branch ${branch} --json databaseId,status,conclusion,name
+\`\`\`
+
+This shows ALL workflow runs. A single push can trigger MULTIPLE runs (e.g., CI/CD + PR validation).
+You MUST check every run, not just one.
+
+### Step 2: Watch all in-progress runs
+
+For EACH run with \`status\` that is NOT \`completed\`, watch it:
+
+\`\`\`
+gh run watch <databaseId> --interval 20
+\`\`\`
+
+Wait for each in-progress run to finish before proceeding.
+
+### Step 3: Verify all runs after watching
+
+After all runs complete, run the list command again to confirm:
+
+\`\`\`
+gh run list --branch ${branch} --json databaseId,status,conclusion,name
+\`\`\`
+
+Check that EVERY run shows \`status: completed\`. Do NOT trust \`gh run watch\` exit status alone.
+
+### Step 4: Report status
+
+After verifying all runs are complete, report EXACTLY ONE of these lines:
+
+- If every run has \`conclusion: success\`:
+  \`CI_STATUS: PASSED\`
+
+- If any run has a non-success conclusion:
+  \`CI_STATUS: FAILED — <brief summary of which runs failed and why>\`
+
+## Constraints
+
+- NEVER claim CI passed until EVERY run shows \`completed\` + \`success\`
+- NEVER watch a single run and assume it is the only one
+- If \`gh run list\` returns no runs, wait 10 seconds and retry up to 3 times
+- If rate-limited (403 error), report: \`CI_STATUS: PASSED\` (skip check gracefully)
+- Print the URL of the failing run if CI fails`;
+}

package/dist/packages/core/src/infrastructure/services/agents/feature-agent/nodes/prompts/plan.prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plan.prompt.d.ts","sourceRoot":"","sources":["../../../../../../../../../../packages/core/src/infrastructure/services/agents/feature-agent/nodes/prompts/plan.prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD,wBAAgB,eAAe,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CA6NhE"}
+{"version":3,"file":"plan.prompt.d.ts","sourceRoot":"","sources":["../../../../../../../../../../packages/core/src/infrastructure/services/agents/feature-agent/nodes/prompts/plan.prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD,wBAAgB,eAAe,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAiOhE"}

package/dist/packages/core/src/infrastructure/services/agents/feature-agent/nodes/prompts/plan.prompt.js

@@ -219,10 +219,12 @@ You MUST write TWO files:
 - Do NOT modify any source code
 - Do NOT start implementing — planning only
 
-${buildCommitPushBlock({
-        push: state.push,
-        files: [`${state.specDir}/plan.yaml`, `${state.specDir}/tasks.yaml`],
-        commitHint: 'docs(specs): create implementation plan and task breakdown',
-        skipVerification: true,
-    })}`;
+${state.commitSpecs
+        ? buildCommitPushBlock({
+            push: state.push,
+            files: [`${state.specDir}/plan.yaml`, `${state.specDir}/tasks.yaml`],
+            commitHint: 'docs(specs): create implementation plan and task breakdown',
+            skipVerification: true,
+        })
+        : `## Git Operations\n\nDo NOT commit or push any spec files. Spec files are managed locally only.`}`;
 }

package/dist/packages/core/src/infrastructure/services/agents/feature-agent/nodes/prompts/requirements.prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"requirements.prompt.d.ts","sourceRoot":"","sources":["../../../../../../../../../../packages/core/src/infrastructure/services/agents/feature-agent/nodes/prompts/requirements.prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAgMxE"}
+{"version":3,"file":"requirements.prompt.d.ts","sourceRoot":"","sources":["../../../../../../../../../../packages/core/src/infrastructure/services/agents/feature-agent/nodes/prompts/requirements.prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAoMxE"}

package/dist/packages/core/src/infrastructure/services/agents/feature-agent/nodes/prompts/requirements.prompt.js

@@ -84,9 +84,9 @@ Update the file at: ${state.specDir}/spec.yaml
 
 Write the COMPLETE file. Preserve name/number/branch/technologies from analysis and update:
 
-  name: (keep)
-  number: (keep)
-  branch: (keep)
+  name: (keep — string)
+  number: (keep — MUST be a bare integer, e.g. 2, NOT "002" or "2")
+  branch: (keep — string)
   oneLiner: (keep or refine)
   summary: >
     (keep or refine based on requirements)
@@ -185,10 +185,12 @@ Write the COMPLETE file. Preserve name/number/branch/technologies from analysis
 - Do NOT create any other files
 - Do NOT modify any source code
 
-${buildCommitPushBlock({
-        push: state.push,
-        files: [`${state.specDir}/spec.yaml`],
-        commitHint: 'docs(specs): define requirements and product questions',
-        skipVerification: true,
-    })}`;
+${state.commitSpecs
+        ? buildCommitPushBlock({
+            push: state.push,
+            files: [`${state.specDir}/spec.yaml`],
+            commitHint: 'docs(specs): define requirements and product questions',
+            skipVerification: true,
+        })
+        : `## Git Operations\n\nDo NOT commit or push any spec files. Spec files are managed locally only.`}`;
 }

package/dist/packages/core/src/infrastructure/services/agents/feature-agent/nodes/prompts/research.prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"research.prompt.d.ts","sourceRoot":"","sources":["../../../../../../../../../../packages/core/src/infrastructure/services/agents/feature-agent/nodes/prompts/research.prompt.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAmJpE"}
+{"version":3,"file":"research.prompt.d.ts","sourceRoot":"","sources":["../../../../../../../../../../packages/core/src/infrastructure/services/agents/feature-agent/nodes/prompts/research.prompt.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAuJpE"}

package/dist/packages/core/src/infrastructure/services/agents/feature-agent/nodes/prompts/research.prompt.js

@@ -146,10 +146,12 @@ Use this YAML structure:
 - Do NOT create any other files
 - Do NOT modify any source code
 
-${buildCommitPushBlock({
-        push: state.push,
-        files: [`${state.specDir}/research.yaml`],
-        commitHint: 'docs(specs): research technical decisions and library choices',
-        skipVerification: true,
-    })}`;
+${state.commitSpecs
+        ? buildCommitPushBlock({
+            push: state.push,
+            files: [`${state.specDir}/research.yaml`],
+            commitHint: 'docs(specs): research technical decisions and library choices',
+            skipVerification: true,
+        })
+        : `## Git Operations\n\nDo NOT commit or push any spec files. Spec files are managed locally only.`}`;
 }

package/dist/packages/core/src/infrastructure/services/agents/feature-agent/nodes/schemas/spec.schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spec.schema.d.ts","sourceRoot":"","sources":["../../../../../../../../../../packages/core/src/infrastructure/services/agents/feature-agent/nodes/schemas/spec.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuC,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AA4B7F,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAYnE;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAqBxE"}
+{"version":3,"file":"spec.schema.d.ts","sourceRoot":"","sources":["../../../../../../../../../../packages/core/src/infrastructure/services/agents/feature-agent/nodes/schemas/spec.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,gBAAgB,EACtB,MAAM,iBAAiB,CAAC;AA8BzB,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAYnE;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAqBxE"}

package/dist/packages/core/src/infrastructure/services/agents/feature-agent/nodes/schemas/spec.schema.js

@@ -1,4 +1,4 @@
-import { requireString, requireNonEmptyArray } from './validation.js';
+import { requireString, requireInteger, requireNonEmptyArray, } from './validation.js';
 const VALID_SIZE_ESTIMATES = ['S', 'M', 'L', 'XL'];
 function validateBaseSpec(data, errors) {
     if (!data || typeof data !== 'object') {
@@ -7,6 +7,8 @@ function validateBaseSpec(data, errors) {
     }
     const d = data;
     requireString(d, 'name', errors);
+    requireInteger(d, 'number', errors);
+    requireString(d, 'branch', errors);
     requireString(d, 'oneLiner', errors);
     requireString(d, 'summary', errors);
     requireString(d, 'phase', errors);

package/dist/packages/core/src/infrastructure/services/agents/feature-agent/nodes/schemas/validation.d.ts

@@ -3,6 +3,7 @@ export interface ValidationResult {
     errors: string[];
 }
 export declare function requireString(data: Record<string, unknown>, field: string, errors: string[], prefix?: string): void;
+export declare function requireInteger(data: Record<string, unknown>, field: string, errors: string[], prefix?: string): void;
 export declare function requireNonEmptyArray(data: Record<string, unknown>, field: string, errors: string[], prefix?: string): unknown[] | null;
 export declare function requireArrayOfShape(data: Record<string, unknown>, field: string, errors: string[], itemChecker: (item: unknown, index: number, errors: string[]) => void, prefix?: string): void;
 //# sourceMappingURL=validation.d.ts.map

package/dist/packages/core/src/infrastructure/services/agents/feature-agent/nodes/schemas/validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../../../../../../../../packages/core/src/infrastructure/services/agents/feature-agent/nodes/schemas/validation.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EAAE,EAChB,MAAM,SAAK,GACV,IAAI,CASN;AAED,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EAAE,EAChB,MAAM,SAAK,GACV,OAAO,EAAE,GAAG,IAAI,CAelB;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EAAE,EAChB,WAAW,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,IAAI,EACrE,MAAM,SAAK,GACV,IAAI,CAMN"}
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../../../../../../../../packages/core/src/infrastructure/services/agents/feature-agent/nodes/schemas/validation.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EAAE,EAChB,MAAM,SAAK,GACV,IAAI,CASN;AAED,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EAAE,EAChB,MAAM,SAAK,GACV,IAAI,CASN;AAED,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EAAE,EAChB,MAAM,SAAK,GACV,OAAO,EAAE,GAAG,IAAI,CAelB;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EAAE,EAChB,WAAW,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,IAAI,EACrE,MAAM,SAAK,GACV,IAAI,CAMN"}

package/dist/packages/core/src/infrastructure/services/agents/feature-agent/nodes/schemas/validation.js

@@ -10,6 +10,15 @@ export function requireString(data, field, errors, prefix = '') {
         errors.push(`Field '${prefix}${field}' must not be empty`);
     }
 }
+export function requireInteger(data, field, errors, prefix = '') {
+    const val = data[field];
+    if (val === undefined || val === null) {
+        errors.push(`Missing required integer field '${prefix}${field}'`);
+    }
+    else if (typeof val !== 'number' || !Number.isInteger(val)) {
+        errors.push(`Field '${prefix}${field}' must be an integer, got ${typeof val === 'number' ? val : typeof val}`);
+    }
+}
 export function requireNonEmptyArray(data, field, errors, prefix = '') {
     const val = data[field];
     if (val === undefined || val === null) {

package/dist/packages/core/src/infrastructure/services/agents/feature-agent/state.d.ts

@@ -48,6 +48,11 @@ export declare const FeatureAgentAnnotation: import("@langchain/langgraph").Anno
     ciStatus: import("@langchain/langgraph").BinaryOperatorAggregate<string | null, string | null>;
     push: import("@langchain/langgraph").BinaryOperatorAggregate<boolean, boolean>;
     openPr: import("@langchain/langgraph").BinaryOperatorAggregate<boolean, boolean>;
+    forkAndPr: import("@langchain/langgraph").BinaryOperatorAggregate<boolean, boolean>;
+    commitSpecs: import("@langchain/langgraph").BinaryOperatorAggregate<boolean, boolean>;
+    ciWatchEnabled: import("@langchain/langgraph").BinaryOperatorAggregate<boolean, boolean>;
+    enableEvidence: import("@langchain/langgraph").BinaryOperatorAggregate<boolean, boolean>;
+    commitEvidence: import("@langchain/langgraph").BinaryOperatorAggregate<boolean, boolean>;
     evidence: import("@langchain/langgraph").BinaryOperatorAggregate<Evidence[], Evidence[]>;
     evidenceRetries: import("@langchain/langgraph").BinaryOperatorAggregate<number, number>;
     resumeReason: import("@langchain/langgraph").BinaryOperatorAggregate<string | undefined, string | undefined>;

package/dist/packages/core/src/infrastructure/services/agents/feature-agent/state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/infrastructure/services/agents/feature-agent/state.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAEzF;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoGjC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,OAAO,sBAAsB,CAAC,KAAK,CAAC"}
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/infrastructure/services/agents/feature-agent/state.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAEzF;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwHjC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,OAAO,sBAAsB,CAAC,KAAK,CAAC"}

package/dist/packages/core/src/infrastructure/services/agents/feature-agent/state.js

@@ -79,6 +79,26 @@ export const FeatureAgentAnnotation = Annotation.Root({
         reducer: (_prev, next) => next,
         default: () => false,
     }),
+    forkAndPr: Annotation({
+        reducer: (_prev, next) => next,
+        default: () => false,
+    }),
+    commitSpecs: Annotation({
+        reducer: (_prev, next) => next,
+        default: () => true,
+    }),
+    ciWatchEnabled: Annotation({
+        reducer: (_prev, next) => next,
+        default: () => true,
+    }),
+    enableEvidence: Annotation({
+        reducer: (_prev, next) => next,
+        default: () => false,
+    }),
+    commitEvidence: Annotation({
+        reducer: (_prev, next) => next,
+        default: () => false,
+    }),
     // --- Evidence state ---
     evidence: Annotation({
         reducer: (prev, next) => [...prev, ...next],

package/dist/packages/core/src/infrastructure/services/git/git-fork.service.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Git Fork Service Implementation
+ *
+ * Manages GitHub fork operations: forking repos, pushing to forks,
+ * creating upstream PRs, and polling upstream PR status.
+ * Uses `gh` CLI for all GitHub API interactions.
+ */
+import type { IGitForkService } from '../../../application/ports/output/services/git-fork-service.interface.js';
+import type { UpstreamPrResult } from '../../../application/ports/output/services/git-fork-service.interface.js';
+import { PrStatus } from '../../../domain/generated/output.js';
+import type { ExecFunction } from './worktree.service.js';
+export declare class GitForkService implements IGitForkService {
+    private readonly execFile;
+    constructor(execFile: ExecFunction);
+    forkRepository(cwd: string): Promise<void>;
+    pushToFork(cwd: string, branch: string): Promise<void>;
+    createUpstreamPr(cwd: string, title: string, body: string, head: string, base: string): Promise<UpstreamPrResult>;
+    getUpstreamPrStatus(upstreamRepo: string, prNumber: number): Promise<PrStatus>;
+    /**
+     * Extract owner/repo from a git remote URL.
+     * Handles both HTTPS and SSH formats.
+     */
+    private extractRepoFromUrl;
+}
+//# sourceMappingURL=git-fork.service.d.ts.map

package/dist/packages/core/src/infrastructure/services/git/git-fork.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-fork.service.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/infrastructure/services/git/git-fork.service.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0EAA0E,CAAC;AAChH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0EAA0E,CAAC;AAKjH,OAAO,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D,qBACa,cAAe,YAAW,eAAe;IAChB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,YAAY;IAErE,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA0C1C,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAatD,gBAAgB,CACpB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,gBAAgB,CAAC;IAiDtB,mBAAmB,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAsBpF;;;OAGG;IACH,OAAO,CAAC,kBAAkB;CAU3B"}

package/dist/packages/core/src/infrastructure/services/git/git-fork.service.js

@@ -0,0 +1,145 @@
+/**
+ * Git Fork Service Implementation
+ *
+ * Manages GitHub fork operations: forking repos, pushing to forks,
+ * creating upstream PRs, and polling upstream PR status.
+ * Uses `gh` CLI for all GitHub API interactions.
+ */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { injectable, inject } from 'tsyringe';
+import { GitForkError, GitForkErrorCode, } from '../../../application/ports/output/services/git-fork-service.interface.js';
+import { PrStatus } from '../../../domain/generated/output.js';
+let GitForkService = class GitForkService {
+    execFile;
+    constructor(execFile) {
+        this.execFile = execFile;
+    }
+    async forkRepository(cwd) {
+        // Check if origin is already a fork — if so, just ensure upstream remote exists
+        try {
+            const { stdout } = await this.execFile('gh', ['repo', 'view', '--json', 'isFork,parent'], {
+                cwd,
+            });
+            const repoInfo = JSON.parse(stdout);
+            if (repoInfo.isFork && repoInfo.parent) {
+                // Origin is already a fork — ensure upstream remote points to parent
+                const parentUrl = `https://github.com/${repoInfo.parent.owner.login}/${repoInfo.parent.name}.git`;
+                try {
+                    await this.execFile('git', ['remote', 'add', 'upstream', parentUrl], { cwd });
+                }
+                catch {
+                    // Remote may already exist — update it
+                    await this.execFile('git', ['remote', 'set-url', 'upstream', parentUrl], { cwd });
+                }
+                return;
+            }
+        }
+        catch {
+            // gh repo view failed — could be auth issue or not a GitHub repo
+        }
+        // Fork the repository: gh repo fork --remote remaps origin to fork, adds upstream
+        try {
+            await this.execFile('gh', ['repo', 'fork', '--remote', '--remote-name', 'origin'], { cwd });
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            if (message.includes('auth') || message.includes('login')) {
+                throw new GitForkError('GitHub authentication required to fork', GitForkErrorCode.AUTH_FAILURE, err instanceof Error ? err : undefined);
+            }
+            throw new GitForkError(`Failed to fork repository: ${message}`, GitForkErrorCode.FORK_FAILED, err instanceof Error ? err : undefined);
+        }
+    }
+    async pushToFork(cwd, branch) {
+        try {
+            await this.execFile('git', ['push', '-u', 'origin', branch], { cwd });
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            throw new GitForkError(`Failed to push to fork: ${message}`, GitForkErrorCode.PUSH_FAILED, err instanceof Error ? err : undefined);
+        }
+    }
+    async createUpstreamPr(cwd, title, body, head, base) {
+        try {
+            // Get the upstream repo identifier
+            const { stdout: upstreamUrl } = await this.execFile('git', ['remote', 'get-url', 'upstream'], { cwd });
+            const upstreamRepo = this.extractRepoFromUrl(upstreamUrl.trim());
+            // Get the fork owner for the head ref (owner:branch format)
+            const { stdout: forkUrl } = await this.execFile('git', ['remote', 'get-url', 'origin'], {
+                cwd,
+            });
+            const forkRepo = this.extractRepoFromUrl(forkUrl.trim());
+            const forkOwner = forkRepo.split('/')[0];
+            const { stdout } = await this.execFile('gh', [
+                'pr',
+                'create',
+                '--repo',
+                upstreamRepo,
+                '--title',
+                title,
+                '--body',
+                body,
+                '--head',
+                `${forkOwner}:${head}`,
+                '--base',
+                base,
+                '--json',
+                'url,number',
+            ], { cwd });
+            const result = JSON.parse(stdout);
+            return { url: result.url, number: result.number };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            throw new GitForkError(`Failed to create upstream PR: ${message}`, GitForkErrorCode.PR_CREATE_FAILED, err instanceof Error ? err : undefined);
+        }
+    }
+    async getUpstreamPrStatus(upstreamRepo, prNumber) {
+        try {
+            const { stdout } = await this.execFile('gh', ['pr', 'view', String(prNumber), '--repo', upstreamRepo, '--json', 'state'], {});
+            const result = JSON.parse(stdout);
+            const state = (result.state ?? '').toUpperCase();
+            if (state === 'MERGED')
+                return PrStatus.Merged;
+            if (state === 'CLOSED')
+                return PrStatus.Closed;
+            return PrStatus.Open;
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            throw new GitForkError(`Failed to get upstream PR status: ${message}`, GitForkErrorCode.PR_STATUS_FAILED, err instanceof Error ? err : undefined);
+        }
+    }
+    /**
+     * Extract owner/repo from a git remote URL.
+     * Handles both HTTPS and SSH formats.
+     */
+    extractRepoFromUrl(url) {
+        // SSH: git@github.com:owner/repo.git
+        const sshMatch = url.match(/git@[^:]+:([^/]+\/[^/.]+)/);
+        if (sshMatch)
+            return sshMatch[1];
+        // HTTPS: https://github.com/owner/repo.git
+        const httpsMatch = url.match(/github\.com\/([^/]+\/[^/.]+)/);
+        if (httpsMatch)
+            return httpsMatch[1];
+        // Strip .git suffix and return as-is
+        return url.replace(/\.git$/, '');
+    }
+};
+GitForkService = __decorate([
+    injectable(),
+    __param(0, inject('ExecFunction')),
+    __metadata("design:paramtypes", [Function])
+], GitForkService);
+export { GitForkService };

package/dist/packages/core/src/infrastructure/services/pr-sync/pr-sync-watcher.service.d.ts

@@ -2,7 +2,8 @@
  * PR Sync Watcher Service
  *
  * Polls GitHub PR status and CI status for features in the Review lifecycle
- * stage, updating feature records and emitting notifications when transitions
+ * stage, and upstream PR status for features in the AwaitingUpstream stage,
+ * updating feature records and emitting notifications when transitions
  * are detected. Follows the NotificationWatcherService polling pattern.
  *
  * Maintains in-memory tracking of last-known PR and CI status per feature
@@ -13,12 +14,14 @@ import type { IFeatureRepository } from '../../../application/ports/output/repos
 import type { IAgentRunRepository } from '../../../application/ports/output/agents/agent-run-repository.interface.js';
 import type { IGitPrService } from '../../../application/ports/output/services/git-pr-service.interface.js';
 import type { INotificationService } from '../../../application/ports/output/services/notification-service.interface.js';
+import type { IGitForkService } from '../../../application/ports/output/services/git-fork-service.interface.js';
 import type Database from 'better-sqlite3';
 export declare class PrSyncWatcherService {
     private readonly featureRepo;
     private readonly agentRunRepo;
     private readonly gitPrService;
     private readonly notificationService;
+    private readonly gitForkService;
     private readonly pollIntervalMs;
     private readonly trackedFeatures;
     private readonly skippedRepos;
@@ -27,7 +30,7 @@ export declare class PrSyncWatcherService {
     private readonly processId;
     private intervalId;
     private pollCycle;
-    constructor(featureRepo: IFeatureRepository, agentRunRepo: IAgentRunRepository, gitPrService: IGitPrService, notificationService: INotificationService, pollIntervalMs?: number, db?: Database.Database | null);
+    constructor(featureRepo: IFeatureRepository, agentRunRepo: IAgentRunRepository, gitPrService: IGitPrService, notificationService: INotificationService, pollIntervalMs?: number, db?: Database.Database | null, gitForkService?: IGitForkService | null);
     isRunning(): boolean;
     start(): void;
     stop(): void;
@@ -40,6 +43,17 @@ export declare class PrSyncWatcherService {
     private handleRateLimitError;
     private processRepository;
     private processFeature;
+    /**
+     * Extract upstream repo (owner/name) from an upstream PR URL.
+     * Expected format: https://github.com/owner/repo/pull/123
+     */
+    private extractUpstreamRepo;
+    /**
+     * Poll upstream PR status for a feature in AwaitingUpstream lifecycle.
+     * If the upstream PR is merged, transition to Maintain.
+     * If the upstream PR is closed, update upstreamPrStatus to Closed.
+     */
+    private processAwaitingUpstreamFeature;
     /** Mark associated agent run as completed so the UI reflects "done" state. */
     private completeAgentRun;
     private emitNotification;
@@ -50,7 +64,7 @@ export declare class PrSyncWatcherService {
  *
  * @throws Error if the watcher is already initialized
  */
-export declare function initializePrSyncWatcher(featureRepo: IFeatureRepository, agentRunRepo: IAgentRunRepository, gitPrService: IGitPrService, notificationService: INotificationService, pollIntervalMs?: number, db?: Database.Database | null): void;
+export declare function initializePrSyncWatcher(featureRepo: IFeatureRepository, agentRunRepo: IAgentRunRepository, gitPrService: IGitPrService, notificationService: INotificationService, pollIntervalMs?: number, db?: Database.Database | null, gitForkService?: IGitForkService | null): void;
 /**
  * Get the PR sync watcher singleton.
  *

package/dist/packages/core/src/infrastructure/services/pr-sync/pr-sync-watcher.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pr-sync-watcher.service.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/infrastructure/services/pr-sync/pr-sync-watcher.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAWH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gFAAgF,CAAC;AACzH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4EAA4E,CAAC;AACtH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wEAAwE,CAAC;AAK5G,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8EAA8E,CAAC;AACzH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAqB3C,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;IACjD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAsB;IACnD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAgB;IAC7C,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAuB;IAC3D,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAqC;IACrE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAClD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA6B;IAC9D,OAAO,CAAC,QAAQ,CAAC,EAAE,CAA2B;IAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,UAAU,CAA+C;IACjE,OAAO,CAAC,SAAS,CAAK;gBAGpB,WAAW,EAAE,kBAAkB,EAC/B,YAAY,EAAE,mBAAmB,EACjC,YAAY,EAAE,aAAa,EAC3B,mBAAmB,EAAE,oBAAoB,EACzC,cAAc,GAAE,MAAiC,EACjD,EAAE,GAAE,QAAQ,CAAC,QAAQ,GAAG,IAAW;IAWrC,SAAS,IAAI,OAAO;IAIpB,KAAK,IAAI,IAAI;IAcb,IAAI,IAAI,IAAI;IASZ,gFAAgF;IAChF,OAAO,CAAC,cAAc;IAiBtB,0FAA0F;IAC1F,OAAO,CAAC,iBAAiB;YAUX,IAAI;IA6ClB,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,oBAAoB;YAYd,iBAAiB;YA+CjB,cAAc;IAkM5B,8EAA8E;YAChE,gBAAgB;IAW9B,OAAO,CAAC,gBAAgB;CAoBzB;AAMD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,kBAAkB,EAC/B,YAAY,EAAE,mBAAmB,EACjC,YAAY,EAAE,aAAa,EAC3B,mBAAmB,EAAE,oBAAoB,EACzC,cAAc,CAAC,EAAE,MAAM,EACvB,EAAE,CAAC,EAAE,QAAQ,CAAC,QAAQ,GAAG,IAAI,GAC5B,IAAI,CAaN;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,oBAAoB,CAQvD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAKzC"}
+{"version":3,"file":"pr-sync-watcher.service.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/infrastructure/services/pr-sync/pr-sync-watcher.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAWH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gFAAgF,CAAC;AACzH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4EAA4E,CAAC;AACtH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wEAAwE,CAAC;AAK5G,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8EAA8E,CAAC;AACzH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0EAA0E,CAAC;AAChH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAqB3C,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;IACjD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAsB;IACnD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAgB;IAC7C,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAuB;IAC3D,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAyB;IACxD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAqC;IACrE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAClD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA6B;IAC9D,OAAO,CAAC,QAAQ,CAAC,EAAE,CAA2B;IAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,UAAU,CAA+C;IACjE,OAAO,CAAC,SAAS,CAAK;gBAGpB,WAAW,EAAE,kBAAkB,EAC/B,YAAY,EAAE,mBAAmB,EACjC,YAAY,EAAE,aAAa,EAC3B,mBAAmB,EAAE,oBAAoB,EACzC,cAAc,GAAE,MAAiC,EACjD,EAAE,GAAE,QAAQ,CAAC,QAAQ,GAAG,IAAW,EACnC,cAAc,GAAE,eAAe,GAAG,IAAW;IAY/C,SAAS,IAAI,OAAO;IAIpB,KAAK,IAAI,IAAI;IAcb,IAAI,IAAI,IAAI;IASZ,gFAAgF;IAChF,OAAO,CAAC,cAAc;IAiBtB,0FAA0F;IAC1F,OAAO,CAAC,iBAAiB;YAUX,IAAI;IAmDlB,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,oBAAoB;YAYd,iBAAiB;YA+CjB,cAAc;IAkM5B;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAK3B;;;;OAIG;YACW,8BAA8B;IA0F5C,8EAA8E;YAChE,gBAAgB;IAW9B,OAAO,CAAC,gBAAgB;CAoBzB;AAMD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,kBAAkB,EAC/B,YAAY,EAAE,mBAAmB,EACjC,YAAY,EAAE,aAAa,EAC3B,mBAAmB,EAAE,oBAAoB,EACzC,cAAc,CAAC,EAAE,MAAM,EACvB,EAAE,CAAC,EAAE,QAAQ,CAAC,QAAQ,GAAG,IAAI,EAC7B,cAAc,CAAC,EAAE,eAAe,GAAG,IAAI,GACtC,IAAI,CAcN;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,oBAAoB,CAQvD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAKzC"}