@soleri/core 9.0.4 → 9.3.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,UAW3B,CAAC;AAEF,eAAO,MAAM,kBAAkB,UAS9B,CAAC;AAEF,eAAO,MAAM,qBAAqB,UAQjC,CAAC;AAEF,eAAO,MAAM,mBAAmB,UAO/B,CAAC;AAEF,eAAO,MAAM,wBAAwB,UASpC,CAAC;AAEF,eAAO,MAAM,mBAAmB,UAW/B,CAAC;AAEF,eAAO,MAAM,qBAAqB,UASjC,CAAC;AAIF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,EAAE,CA+CtD;AAID,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,EAAE,CAiDzD;AAID,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,EAAE,CAkCxD;AAID,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,EAAE,CAkCjD"}

package/dist/planning/gap-patterns.js

@@ -0,0 +1,175 @@
+/**
+ * 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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"}