@soleri/core 9.0.3 → 9.2.0

package/dist/planning/gap-patterns.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Gap analysis helpers, pattern constants, and structural passes (1-4).
+ * Contains shared utilities and the first four analysis passes that check
+ * structure, completeness, feasibility, and risk.
+ */
+import type { Plan, PlanDecision } from './planner.js';
+import type { PlanGap, GapSeverity, GapCategory } from './gap-types.js';
+/** Create a PlanGap with auto-generated ID. */
+export declare function gap(severity: GapSeverity, category: GapCategory, description: string, recommendation: string, location?: string, trigger?: string): PlanGap;
+/** Combine all task descriptions + titles into a single text blob for analysis. */
+export declare function taskText(plan: Plan): string;
+/** Extract text from a decision (supports both string and structured format). */
+export declare function decisionText(d: string | PlanDecision): string;
+/** Combine all decisions into a single text blob. */
+export declare function decisionsText(plan: Plan): string;
+/** Check if text contains any of the given patterns (case-insensitive). */
+export declare function containsAny(text: string, patterns: string[]): boolean;
+export declare const METRIC_PATTERNS: RegExp[];
+export declare const EXCLUSION_KEYWORDS: string[];
+export declare const OVERLY_BROAD_PATTERNS: string[];
+export declare const DEPENDENCY_KEYWORDS: string[];
+export declare const BREAKING_CHANGE_KEYWORDS: string[];
+export declare const MITIGATION_KEYWORDS: string[];
+export declare const VERIFICATION_KEYWORDS: string[];
+export declare function analyzeStructure(plan: Plan): PlanGap[];
+export declare function analyzeCompleteness(plan: Plan): PlanGap[];
+export declare function analyzeFeasibility(plan: Plan): PlanGap[];
+export declare function analyzeRisk(plan: Plan): PlanGap[];
+//# sourceMappingURL=gap-patterns.d.ts.map

package/dist/planning/gap-patterns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gap-patterns.d.ts","sourceRoot":"","sources":["../../src/planning/gap-patterns.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAUxE,+CAA+C;AAC/C,wBAAgB,GAAG,CACjB,QAAQ,EAAE,WAAW,EACrB,QAAQ,EAAE,WAAW,EACrB,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,EACtB,QAAQ,CAAC,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAUT;AAED,mFAAmF;AACnF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAE3C;AAED,iFAAiF;AACjF,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,MAAM,CAE7D;AAED,qDAAqD;AACrD,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAEhD;AAED,2EAA2E;AAC3E,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAGrE;AAID,eAAO,MAAM,eAAe,UAG3B,CAAC;AAEF,eAAO,MAAM,kBAAkB,UAE9B,CAAC;AAEF,eAAO,MAAM,qBAAqB,UAGjC,CAAC;AAEF,eAAO,MAAM,mBAAmB,UAE/B,CAAC;AAEF,eAAO,MAAM,wBAAwB,UAGpC,CAAC;AAEF,eAAO,MAAM,mBAAmB,UAG/B,CAAC;AAEF,eAAO,MAAM,qBAAqB,UAEjC,CAAC;AAIF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,EAAE,CAsCtD;AAID,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,EAAE,CAqCzD;AAID,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,EAAE,CA0BxD;AAID,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,EAAE,CA0BjD"}

package/dist/planning/gap-patterns.js

@@ -0,0 +1,129 @@
+/**
+ * Gap analysis helpers, pattern constants, and structural passes (1-4).
+ * Contains shared utilities and the first four analysis passes that check
+ * structure, completeness, feasibility, and risk.
+ */
+import { generateGapId, MIN_OBJECTIVE_LENGTH, MIN_SCOPE_LENGTH, MIN_DECISION_LENGTH, } from './gap-types.js';
+// ─── Helper Functions ────────────────────────────────────────────
+/** Create a PlanGap with auto-generated ID. */
+export function gap(severity, category, description, recommendation, location, trigger) {
+    return {
+        id: generateGapId(),
+        severity,
+        category,
+        description,
+        recommendation,
+        ...(location ? { location } : {}),
+        ...(trigger ? { _trigger: trigger } : {}),
+    };
+}
+/** Combine all task descriptions + titles into a single text blob for analysis. */
+export function taskText(plan) {
+    return plan.tasks.map((t) => `${t.title} ${t.description}`).join(' ');
+}
+/** Extract text from a decision (supports both string and structured format). */
+export function decisionText(d) {
+    return typeof d === 'string' ? d : `${d.decision} ${d.rationale}`;
+}
+/** Combine all decisions into a single text blob. */
+export function decisionsText(plan) {
+    return plan.decisions.map(decisionText).join(' ');
+}
+/** Check if text contains any of the given patterns (case-insensitive). */
+export function containsAny(text, patterns) {
+    const lower = text.toLowerCase();
+    return patterns.some((p) => lower.includes(p.toLowerCase()));
+}
+// ─── Pattern Constants (Passes 1-4) ─────────────────────────────
+export const METRIC_PATTERNS = [
+    /\d+/, /percent/i, /reduce/i, /increase/i, /measure/i,
+    /target/i, /goal/i, /kpi/i, /metric/i, /benchmark/i,
+];
+export const EXCLUSION_KEYWORDS = [
+    'not', 'exclude', 'outside', 'beyond', 'limit', 'except', "won't", 'will not',
+];
+export const OVERLY_BROAD_PATTERNS = [
+    'everything', 'all systems', 'entire codebase', 'complete rewrite',
+    'from scratch', 'total overhaul', 'rewrite everything',
+];
+export const DEPENDENCY_KEYWORDS = [
+    'depends', 'dependency', 'prerequisite', 'requires', 'blocked', 'before',
+];
+export const BREAKING_CHANGE_KEYWORDS = [
+    'breaking change', 'breaking', 'migration', 'deprecate',
+    'remove api', 'remove endpoint', 'schema change', 'database migration',
+];
+export const MITIGATION_KEYWORDS = [
+    'rollback', 'backward compatible', 'backwards compatible', 'feature flag',
+    'gradual', 'phased', 'fallback', 'backup', 'canary', 'blue-green',
+];
+export const VERIFICATION_KEYWORDS = [
+    'test', 'verify', 'validate', 'check', 'assert', 'confirm', 'spec', 'coverage',
+];
+// ─── Pass 1: Structure ───────────────────────────────────────────
+export function analyzeStructure(plan) {
+    const gaps = [];
+    if (!plan.objective || plan.objective.trim().length < MIN_OBJECTIVE_LENGTH) {
+        gaps.push(gap('critical', 'structure', plan.objective
+            ? `Objective too short (${plan.objective.trim().length} chars, need ${MIN_OBJECTIVE_LENGTH}+).`
+            : 'Plan has no objective.', 'Add a clear objective describing what this plan achieves.', 'objective', 'missing_or_short_objective'));
+    }
+    if (!plan.scope || plan.scope.trim().length < MIN_SCOPE_LENGTH) {
+        gaps.push(gap('critical', 'structure', plan.scope
+            ? `Scope too short (${plan.scope.trim().length} chars, need ${MIN_SCOPE_LENGTH}+).`
+            : 'Plan has no scope defined.', 'Define the scope — what is included and excluded.', 'scope', 'missing_or_short_scope'));
+    }
+    if (plan.tasks.length === 0) {
+        gaps.push(gap('critical', 'structure', 'Plan has no tasks.', 'Add at least one task to make the plan actionable.', 'tasks', 'no_tasks'));
+    }
+    return gaps;
+}
+// ─── Pass 2: Completeness ────────────────────────────────────────
+export function analyzeCompleteness(plan) {
+    const gaps = [];
+    if (plan.objective && !METRIC_PATTERNS.some((p) => p.test(plan.objective))) {
+        gaps.push(gap('minor', 'completeness', 'Objective has no measurable targets or metrics.', 'Include quantifiable success criteria (numbers, percentages, concrete outcomes).', 'objective', 'no_metrics_in_objective'));
+    }
+    if (plan.decisions.length > 0) {
+        for (let i = 0; i < plan.decisions.length; i++) {
+            const d = plan.decisions[i];
+            const text = decisionText(d);
+            if (text.trim().length < MIN_DECISION_LENGTH) {
+                gaps.push(gap('major', 'completeness', `Decision ${i + 1} is too short (${text.trim().length} chars) — lacks rationale.`, 'Expand each decision to include the reasoning (why this choice over alternatives).', `decisions[${i}]`, 'short_decision'));
+            }
+        }
+    }
+    if (plan.scope && !containsAny(plan.scope, EXCLUSION_KEYWORDS)) {
+        gaps.push(gap('minor', 'completeness', 'Scope does not mention what is excluded.', 'Add explicit exclusions to prevent scope creep (e.g., "does NOT include…").', 'scope', 'no_exclusions_in_scope'));
+    }
+    return gaps;
+}
+// ─── Pass 3: Feasibility ─────────────────────────────────────────
+export function analyzeFeasibility(plan) {
+    const gaps = [];
+    const scopeAndTasks = `${plan.scope} ${taskText(plan)}`;
+    if (containsAny(scopeAndTasks, OVERLY_BROAD_PATTERNS)) {
+        gaps.push(gap('major', 'feasibility', 'Scope contains overly broad indicators — risk of unrealistic delivery.', 'Narrow the scope to a well-defined subset. Prefer incremental delivery over big-bang rewrites.', 'scope', 'overly_broad_scope'));
+    }
+    if (plan.tasks.length > 3 && !containsAny(scopeAndTasks, DEPENDENCY_KEYWORDS)) {
+        const hasDeps = plan.tasks.some((t) => t.dependsOn && t.dependsOn.length > 0);
+        if (!hasDeps) {
+            gaps.push(gap('minor', 'feasibility', `${plan.tasks.length} tasks with no dependency mentions — execution order unclear.`, 'Identify dependencies between tasks or add explicit ordering notes.', 'tasks', 'no_dependency_awareness'));
+        }
+    }
+    return gaps;
+}
+// ─── Pass 4: Risk ────────────────────────────────────────────────
+export function analyzeRisk(plan) {
+    const gaps = [];
+    const allText = `${plan.objective} ${plan.scope} ${taskText(plan)} ${decisionsText(plan)}`;
+    if (containsAny(allText, BREAKING_CHANGE_KEYWORDS) &&
+        !containsAny(allText, MITIGATION_KEYWORDS)) {
+        gaps.push(gap('major', 'risk', 'Plan involves breaking changes but mentions no mitigation strategy.', 'Add a rollback plan, feature flags, or phased migration approach.', undefined, 'breaking_without_mitigation'));
+    }
+    if (plan.tasks.length > 0 && !containsAny(allText, VERIFICATION_KEYWORDS)) {
+        gaps.push(gap('minor', 'risk', 'No verification or testing mentioned in the plan.', 'Add at least one task or note about testing/validation.', 'tasks', 'no_verification_mentioned'));
+    }
+    return gaps;
+}
+//# sourceMappingURL=gap-patterns.js.map

package/dist/planning/gap-patterns.js.map

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

package/dist/planning/gap-types.d.ts

@@ -3,7 +3,7 @@
  * Ported from Salvador MCP's multi-pass grading engine.
  */
 export type GapSeverity = 'critical' | 'major' | 'minor' | 'info' | 'bonus';
-export type GapCategory = 'structure' | 'completeness' | 'feasibility' | 'risk' | 'clarity' | 'semantic-quality' | 'knowledge-depth' | 'tool-feasibility' | 'flow-alignment' | 'anti-pattern';
+export type GapCategory = 'structure' | 'completeness' | 'feasibility' | 'risk' | 'clarity' | 'semantic-quality' | 'knowledge-depth' | 'alternative-analysis' | 'tool-feasibility' | 'flow-alignment' | 'anti-pattern' | 'rationalization';
 export interface PlanGap {
     id: string;
     severity: GapSeverity;

package/dist/planning/gap-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gap-types.d.ts","sourceRoot":"","sources":["../../src/planning/gap-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;AAE5E,MAAM,MAAM,WAAW,GACnB,WAAW,GACX,cAAc,GACd,aAAa,GACb,MAAM,GACN,SAAS,GACT,kBAAkB,GAClB,iBAAiB,GACjB,kBAAkB,GAClB,gBAAgB,GAChB,cAAc,CAAC;AAEnB,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,WAAW,CAAC;IACtB,QAAQ,EAAE,WAAW,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAID,wEAAwE;AACxE,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAMxD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAExD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAEtD,CAAC;AAIF,eAAO,MAAM,oBAAoB,KAAK,CAAC;AACvC,eAAO,MAAM,gBAAgB,KAAK,CAAC;AACnC,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAItC,wBAAgB,aAAa,IAAI,MAAM,CAEtC"}
+{"version":3,"file":"gap-types.d.ts","sourceRoot":"","sources":["../../src/planning/gap-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;AAE5E,MAAM,MAAM,WAAW,GACnB,WAAW,GACX,cAAc,GACd,aAAa,GACb,MAAM,GACN,SAAS,GACT,kBAAkB,GAClB,iBAAiB,GACjB,sBAAsB,GACtB,kBAAkB,GAClB,gBAAgB,GAChB,cAAc,GACd,iBAAiB,CAAC;AAEtB,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,WAAW,CAAC;IACtB,QAAQ,EAAE,WAAW,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAID,wEAAwE;AACxE,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAMxD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAGxD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAEtD,CAAC;AAIF,eAAO,MAAM,oBAAoB,KAAK,CAAC;AACvC,eAAO,MAAM,gBAAgB,KAAK,CAAC;AACnC,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAItC,wBAAgB,aAAa,IAAI,MAAM,CAEtC"}

package/dist/planning/gap-types.js

@@ -17,6 +17,7 @@ export const SEVERITY_WEIGHTS = {
  */
 export const CATEGORY_PENALTY_CAPS = {
     clarity: 10,
+    'alternative-analysis': 15,
 };
 /**
  * Maximum bonus per category.

package/dist/planning/gap-types.js.map

@@ -1 +1 @@
-{"version":3,"file":"gap-types.js","sourceRoot":"","sources":["../../src/planning/gap-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA8BH,oEAAoE;AAEpE,wEAAwE;AACxE,MAAM,CAAC,MAAM,gBAAgB,GAAgC;IAC3D,QAAQ,EAAE,EAAE;IACZ,KAAK,EAAE,EAAE;IACT,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC,CAAC;CACV,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAA2B;IAC3D,OAAO,EAAE,EAAE;CACZ,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAA2B;IACzD,iBAAiB,EAAE,EAAE;CACtB,CAAC;AAEF,oEAAoE;AAEpE,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC;AACvC,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,CAAC;AACnC,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAEtC,oEAAoE;AAEpE,MAAM,UAAU,aAAa;IAC3B,OAAO,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AAC3E,CAAC"}
+{"version":3,"file":"gap-types.js","sourceRoot":"","sources":["../../src/planning/gap-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAgCH,oEAAoE;AAEpE,wEAAwE;AACxE,MAAM,CAAC,MAAM,gBAAgB,GAAgC;IAC3D,QAAQ,EAAE,EAAE;IACZ,KAAK,EAAE,EAAE;IACT,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC,CAAC;CACV,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAA2B;IAC3D,OAAO,EAAE,EAAE;IACX,sBAAsB,EAAE,EAAE;CAC3B,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAA2B;IACzD,iBAAiB,EAAE,EAAE;CACtB,CAAC;AAEF,oEAAoE;AAEpE,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC;AACvC,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,CAAC;AACnC,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAEtC,oEAAoE;AAEpE,MAAM,UAAU,aAAa;IAC3B,OAAO,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AAC3E,CAAC"}

package/dist/planning/github-projection.d.ts

@@ -0,0 +1,122 @@
+/**
+ * GitHub Projection — auto-link Ernesto plans to GitHub issues.
+ *
+ * After plan_split (tasks defined), the agent can detect a GitHub repo
+ * and project plan tasks as GitHub issues with plan metadata linked.
+ *
+ * The plan is the source of truth; GitHub issues are the projection.
+ */
+export interface GitHubRepo {
+    owner: string;
+    repo: string;
+}
+export interface GitHubMilestone {
+    number: number;
+    title: string;
+    state: string;
+}
+export interface GitHubIssue {
+    number: number;
+    title: string;
+    state: string;
+    body?: string;
+}
+export interface GitHubLabel {
+    name: string;
+    color?: string;
+}
+export interface GitHubContext {
+    repo: GitHubRepo;
+    authenticated: boolean;
+    milestones: GitHubMilestone[];
+    existingIssues: GitHubIssue[];
+    labels: GitHubLabel[];
+}
+export interface GitHubProjection {
+    repo: string;
+    milestone?: number;
+    issues: Array<{
+        taskId: string;
+        issueNumber: number;
+    }>;
+    projectedAt: number;
+}
+export interface ProjectedIssue {
+    taskId: string;
+    issueNumber: number;
+    issueUrl: string;
+}
+/**
+ * Parse a GitHub owner/repo from a git remote URL.
+ * Supports HTTPS (github.com/owner/repo.git) and SSH (git@github.com:owner/repo.git).
+ */
+export declare function parseGitHubRemote(remoteUrl: string): GitHubRepo | null;
+/**
+ * Detect the GitHub remote from a project directory.
+ * Returns null if no GitHub remote found or not a git repo.
+ */
+export declare function detectGitHubRemote(projectPath: string): GitHubRepo | null;
+/**
+ * Check if the `gh` CLI is authenticated.
+ */
+export declare function isGhAuthenticated(): boolean;
+/**
+ * List milestones for a GitHub repo.
+ */
+export declare function listMilestones(repo: GitHubRepo): GitHubMilestone[];
+/**
+ * List open issues for a GitHub repo.
+ */
+export declare function listOpenIssues(repo: GitHubRepo, limit?: number): GitHubIssue[];
+/**
+ * List labels for a GitHub repo.
+ */
+export declare function listLabels(repo: GitHubRepo): GitHubLabel[];
+/**
+ * Detect full GitHub context for a project.
+ * Returns null if not a GitHub project or gh CLI not available.
+ */
+export declare function detectGitHubContext(projectPath: string): GitHubContext | null;
+/**
+ * Find the best matching milestone by name similarity.
+ * Uses simple word overlap scoring.
+ */
+export declare function findMatchingMilestone(phaseName: string, milestones: GitHubMilestone[]): GitHubMilestone | null;
+/**
+ * Find an existing issue that likely covers the same task.
+ * Uses title similarity (word overlap).
+ */
+export declare function findDuplicateIssue(taskTitle: string, existingIssues: GitHubIssue[]): GitHubIssue | null;
+export interface PlanMetadataForIssue {
+    planId: string;
+    grade: string;
+    score: number;
+    objective: string;
+    decisions: Array<string | {
+        decision: string;
+        rationale: string;
+    }>;
+    tasks: Array<{
+        id: string;
+        title: string;
+        description: string;
+        dependsOn?: string[];
+    }>;
+}
+/**
+ * Format an issue body with plan metadata.
+ */
+export declare function formatIssueBody(plan: PlanMetadataForIssue, taskTitle: string, taskDescription: string): string;
+/**
+ * Create a GitHub issue using the `gh` CLI.
+ * Returns the issue number, or null on failure.
+ */
+export declare function createGitHubIssue(repo: GitHubRepo, title: string, body: string, options?: {
+    milestone?: number;
+    labels?: string[];
+}): number | null;
+/**
+ * Update an existing GitHub issue body (for linking plans to existing issues).
+ */
+export declare function updateGitHubIssueBody(repo: GitHubRepo, issueNumber: number, body: string): boolean;
+//# sourceMappingURL=github-projection.d.ts.map

package/dist/planning/github-projection.d.ts.map

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

package/dist/planning/github-projection.js

@@ -0,0 +1,294 @@
+/**
+ * GitHub Projection — auto-link Ernesto plans to GitHub issues.
+ *
+ * After plan_split (tasks defined), the agent can detect a GitHub repo
+ * and project plan tasks as GitHub issues with plan metadata linked.
+ *
+ * The plan is the source of truth; GitHub issues are the projection.
+ */
+import { execFileSync } from 'node:child_process';
+// ---------------------------------------------------------------------------
+// Git remote detection
+// ---------------------------------------------------------------------------
+/**
+ * Parse a GitHub owner/repo from a git remote URL.
+ * Supports HTTPS (github.com/owner/repo.git) and SSH (git@github.com:owner/repo.git).
+ */
+export function parseGitHubRemote(remoteUrl) {
+    // HTTPS: https://github.com/owner/repo.git
+    const httpsMatch = remoteUrl.match(/github\.com\/([^/]+)\/([^/\s]+?)(?:\.git)?$/);
+    if (httpsMatch) {
+        return { owner: httpsMatch[1], repo: httpsMatch[2] };
+    }
+    // SSH: git@github.com:owner/repo.git
+    const sshMatch = remoteUrl.match(/github\.com:([^/]+)\/([^/\s]+?)(?:\.git)?$/);
+    if (sshMatch) {
+        return { owner: sshMatch[1], repo: sshMatch[2] };
+    }
+    return null;
+}
+/**
+ * Detect the GitHub remote from a project directory.
+ * Returns null if no GitHub remote found or not a git repo.
+ */
+export function detectGitHubRemote(projectPath) {
+    try {
+        const output = execFileSync('git', ['remote', 'get-url', 'origin'], {
+            cwd: projectPath,
+            encoding: 'utf-8',
+            timeout: 5000,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+        return parseGitHubRemote(output);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Check if the `gh` CLI is authenticated.
+ */
+export function isGhAuthenticated() {
+    try {
+        execFileSync('gh', ['auth', 'status'], {
+            encoding: 'utf-8',
+            timeout: 5000,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+// ---------------------------------------------------------------------------
+// GitHub API helpers (via `gh` CLI)
+// ---------------------------------------------------------------------------
+/**
+ * List milestones for a GitHub repo.
+ */
+export function listMilestones(repo) {
+    try {
+        const output = execFileSync('gh', ['api', `repos/${repo.owner}/${repo.repo}/milestones`, '--jq', '.[] | {number, title, state}'], {
+            encoding: 'utf-8',
+            timeout: 10000,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+        if (!output)
+            return [];
+        // gh --jq outputs one JSON object per line
+        return output
+            .split('\n')
+            .filter(Boolean)
+            .map((line) => JSON.parse(line));
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * List open issues for a GitHub repo.
+ */
+export function listOpenIssues(repo, limit = 100) {
+    try {
+        const output = execFileSync('gh', [
+            'issue', 'list',
+            '--repo', `${repo.owner}/${repo.repo}`,
+            '--state', 'open',
+            '--limit', String(limit),
+            '--json', 'number,title,state,body',
+        ], {
+            encoding: 'utf-8',
+            timeout: 10000,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+        if (!output)
+            return [];
+        return JSON.parse(output);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * List labels for a GitHub repo.
+ */
+export function listLabels(repo) {
+    try {
+        const output = execFileSync('gh', [
+            'label', 'list',
+            '--repo', `${repo.owner}/${repo.repo}`,
+            '--json', 'name,color',
+        ], {
+            encoding: 'utf-8',
+            timeout: 10000,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+        if (!output)
+            return [];
+        return JSON.parse(output);
+    }
+    catch {
+        return [];
+    }
+}
+// ---------------------------------------------------------------------------
+// Full context detection
+// ---------------------------------------------------------------------------
+/**
+ * Detect full GitHub context for a project.
+ * Returns null if not a GitHub project or gh CLI not available.
+ */
+export function detectGitHubContext(projectPath) {
+    const repo = detectGitHubRemote(projectPath);
+    if (!repo)
+        return null;
+    const authenticated = isGhAuthenticated();
+    if (!authenticated)
+        return null;
+    const milestones = listMilestones(repo);
+    const existingIssues = listOpenIssues(repo);
+    const labels = listLabels(repo);
+    return { repo, authenticated, milestones, existingIssues, labels };
+}
+// ---------------------------------------------------------------------------
+// Milestone matching
+// ---------------------------------------------------------------------------
+/**
+ * Find the best matching milestone by name similarity.
+ * Uses simple word overlap scoring.
+ */
+export function findMatchingMilestone(phaseName, milestones) {
+    if (milestones.length === 0)
+        return null;
+    const phaseWords = new Set(phaseName.toLowerCase().split(/\s+/));
+    let bestMatch = null;
+    let bestScore = 0;
+    for (const ms of milestones) {
+        if (ms.state !== 'open')
+            continue;
+        const msWords = ms.title.toLowerCase().split(/\s+/);
+        let overlap = 0;
+        for (const w of msWords) {
+            if (phaseWords.has(w))
+                overlap++;
+        }
+        const score = overlap / Math.max(phaseWords.size, msWords.length);
+        if (score > bestScore && score > 0.2) {
+            bestScore = score;
+            bestMatch = ms;
+        }
+    }
+    return bestMatch;
+}
+// ---------------------------------------------------------------------------
+// Duplicate detection
+// ---------------------------------------------------------------------------
+/**
+ * Find an existing issue that likely covers the same task.
+ * Uses title similarity (word overlap).
+ */
+export function findDuplicateIssue(taskTitle, existingIssues) {
+    const taskWords = new Set(taskTitle.toLowerCase().split(/\s+/).filter((w) => w.length > 2));
+    for (const issue of existingIssues) {
+        const issueWords = issue.title.toLowerCase().split(/\s+/).filter((w) => w.length > 2);
+        let overlap = 0;
+        for (const w of issueWords) {
+            if (taskWords.has(w))
+                overlap++;
+        }
+        const score = overlap / Math.max(taskWords.size, issueWords.length, 1);
+        if (score >= 0.5)
+            return issue;
+    }
+    return null;
+}
+/**
+ * Format an issue body with plan metadata.
+ */
+export function formatIssueBody(plan, taskTitle, taskDescription) {
+    const lines = [];
+    lines.push(`## Ernesto Plan: \`${plan.planId}\` (Grade: ${plan.grade}, ${plan.score}/100)`);
+    lines.push('');
+    lines.push(`**Objective:** ${plan.objective}`);
+    lines.push('');
+    if (plan.decisions.length > 0) {
+        lines.push('## Decisions');
+        for (const d of plan.decisions) {
+            if (typeof d === 'string') {
+                lines.push(`- ${d}`);
+            }
+            else {
+                lines.push(`- **${d.decision}** — ${d.rationale}`);
+            }
+        }
+        lines.push('');
+    }
+    lines.push('## Task');
+    lines.push(taskDescription);
+    lines.push('');
+    lines.push('## All Plan Tasks');
+    lines.push('| # | Task | Depends On |');
+    lines.push('|---|------|------------|');
+    for (const t of plan.tasks) {
+        const deps = t.dependsOn?.join(', ') || '—';
+        lines.push(`| ${t.id} | ${t.title} | ${deps} |`);
+    }
+    return lines.join('\n');
+}
+// ---------------------------------------------------------------------------
+// Issue creation
+// ---------------------------------------------------------------------------
+/**
+ * Create a GitHub issue using the `gh` CLI.
+ * Returns the issue number, or null on failure.
+ */
+export function createGitHubIssue(repo, title, body, options) {
+    try {
+        const args = [
+            'issue', 'create',
+            '--repo', `${repo.owner}/${repo.repo}`,
+            '--title', title,
+            '--body', body,
+        ];
+        if (options?.milestone) {
+            args.push('--milestone', String(options.milestone));
+        }
+        if (options?.labels && options.labels.length > 0) {
+            args.push('--label', options.labels.join(','));
+        }
+        const output = execFileSync('gh', args, {
+            encoding: 'utf-8',
+            timeout: 15000,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+        // gh issue create returns the issue URL: https://github.com/owner/repo/issues/123
+        const match = output.match(/\/issues\/(\d+)/);
+        return match ? parseInt(match[1], 10) : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Update an existing GitHub issue body (for linking plans to existing issues).
+ */
+export function updateGitHubIssueBody(repo, issueNumber, body) {
+    try {
+        execFileSync('gh', [
+            'issue', 'edit',
+            '--repo', `${repo.owner}/${repo.repo}`,
+            String(issueNumber),
+            '--body', body,
+        ], {
+            encoding: 'utf-8',
+            timeout: 15000,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=github-projection.js.map

package/dist/planning/github-projection.js.map

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