kairo-mcp 1.3.0

package/dist/core/github/commitMessage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commitMessage.d.ts","sourceRoot":"","sources":["../../../src/core/github/commitMessage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAEvE,OAAO,KAAK,EAAE,cAAc,EAAc,MAAM,YAAY,CAAC;AA2E7D,wBAAgB,aAAa,CAAC,KAAK,EAAE,YAAY,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,cAAc,CAwDxF"}

package/dist/core/github/commitMessage.js

@@ -0,0 +1,125 @@
+import { assessSession } from '../risk/riskEngine.js';
+/**
+ * Generates a Conventional-Commits message FROM Kairo's session memory — not from a
+ * diff. The value is that the message reflects the decisions and risk Kairo recorded,
+ * which a diff-only tool cannot see. Per ADR-0003 this only produces text.
+ *
+ * Deliberately emits no AI co-author/attribution trailer: these are the author's
+ * commits.
+ */
+function fileCategory(path) {
+    if (/(^|\/)(__tests__|tests?|spec)\//i.test(path) || /\.(test|spec)\.[tj]sx?$/i.test(path)) {
+        return 'test';
+    }
+    if (/\.md$|(^|\/)docs?\//i.test(path))
+        return 'docs';
+    if (/\.github\/workflows\//i.test(path))
+        return 'ci';
+    if (/(^|\/)(package\.json|package-lock\.json|pnpm-lock\.yaml|tsconfig.*\.json|eslint\.config\.|\.prettierrc|vitest\.config\.)/i.test(path)) {
+        return 'build';
+    }
+    return 'src';
+}
+function topLevelScope(paths) {
+    const counts = new Map();
+    for (const p of paths) {
+        const seg = p.split('/');
+        // Prefer the dir under src/ (e.g. src/auth/x.ts -> "auth"); else top dir.
+        const scope = seg[0] === 'src' && seg.length > 2 ? seg[1] : seg.length > 1 ? seg[0] : undefined;
+        if (scope)
+            counts.set(scope, (counts.get(scope) ?? 0) + 1);
+    }
+    let best;
+    let max = 0;
+    for (const [k, v] of counts) {
+        if (v > max) {
+            max = v;
+            best = k;
+        }
+    }
+    return best;
+}
+function classify(state, files) {
+    const cats = files.map((f) => fileCategory(f.path));
+    const all = (c) => cats.length > 0 && cats.every((x) => x === c);
+    const hasResolvedErrors = state.errors.some((e) => e.resolved);
+    const createdSrc = files.some((f) => f.changeKind === 'created' && fileCategory(f.path) === 'src');
+    const refactorIntent = [state.task, ...state.decisions.map((d) => d.summary)]
+        .join(' ')
+        .match(/\brefactor|restructure|rename|extract\b/i);
+    if (all('docs'))
+        return { type: 'docs', why: 'every changed file is documentation' };
+    if (all('test'))
+        return { type: 'test', why: 'every changed file is a test' };
+    if (all('ci'))
+        return { type: 'ci', why: 'every changed file is a CI workflow' };
+    if (all('build'))
+        return { type: 'build', why: 'every changed file is build/config' };
+    if (createdSrc)
+        return { type: 'feat', why: 'new source modules were created' };
+    if (hasResolvedErrors) {
+        return { type: 'fix', why: 'errors were recorded and resolved during the session' };
+    }
+    if (refactorIntent)
+        return { type: 'refactor', why: 'task/decisions indicate a refactor' };
+    if (files.length === 0)
+        return { type: 'chore', why: 'no file changes recorded' };
+    return { type: 'feat', why: 'source files modified with no fix/refactor signal' };
+}
+function subjectFrom(task, type) {
+    let s = (task || `${type} changes`).trim().replace(/\.$/, '');
+    s = s.charAt(0).toLowerCase() + s.slice(1);
+    return s.length > 60 ? `${s.slice(0, 57)}...` : s;
+}
+export function proposeCommit(state, extraSummary) {
+    const files = Object.values(state.changedFiles);
+    const { type, why } = classify(state, files);
+    const scope = topLevelScope(files.map((f) => f.path));
+    const subject = subjectFrom(state.task, type);
+    const header = scope ? `${type}(${scope}): ${subject}` : `${type}: ${subject}`;
+    const body = [];
+    if (extraSummary)
+        body.push(extraSummary.trim(), '');
+    if (state.decisions.length > 0) {
+        for (const d of state.decisions.slice(0, 8)) {
+            body.push(`- ${d.summary}${d.rationale ? ` (${d.rationale})` : ''}`);
+        }
+        body.push('');
+    }
+    if (files.length > 0) {
+        const shown = files
+            .slice(0, 10)
+            .map((f) => `- ${f.changeKind}: ${f.path}`)
+            .join('\n');
+        body.push('Changed files:', shown);
+        if (files.length > 10)
+            body.push(`- …and ${files.length - 10} more`);
+        body.push('');
+    }
+    const risk = assessSession(state);
+    const footer = [];
+    if (risk.level !== 'low') {
+        footer.push(`Risk: ${risk.level.toUpperCase()} — ${risk.factors[0]?.detail ?? 'review carefully'}`);
+    }
+    const unresolved = state.errors.filter((e) => !e.resolved).length;
+    if (unresolved > 0)
+        footer.push(`WARNING: ${unresolved} unresolved error(s) at commit time.`);
+    footer.push(`Refs: kairo-session ${state.id}`);
+    const message = [header, '', body.join('\n').trim(), '', footer.join('\n')]
+        .join('\n')
+        .replace(/\n{3,}/g, '\n\n')
+        .trim();
+    const reasoning = [
+        `Type "${type}": ${why}.`,
+        scope ? `Scope "${scope}": most-touched area.` : 'No dominant scope; omitted.',
+        `Engineering risk ${risk.level.toUpperCase()} folded into the footer.`,
+    ];
+    return {
+        type,
+        ...(scope ? { scope } : {}),
+        header,
+        message,
+        reasoning,
+    };
+}
+//# sourceMappingURL=commitMessage.js.map

package/dist/core/github/commitMessage.js.map

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

package/dist/core/github/gitContext.d.ts

@@ -0,0 +1,3 @@
+import type { GitContext } from './types.js';
+export declare function readGitContext(cwd: string): Promise<GitContext>;
+//# sourceMappingURL=gitContext.d.ts.map

package/dist/core/github/gitContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitContext.d.ts","sourceRoot":"","sources":["../../../src/core/github/gitContext.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAwB7C,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAyCrE"}

package/dist/core/github/gitContext.js

@@ -0,0 +1,67 @@
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { logger } from '../../utils/logger.js';
+const exec = promisify(execFile);
+/**
+ * Read-only git introspection. Per ADR-0003 this module runs ONLY non-mutating
+ * commands; it never stages, commits, tags, or pushes. Every call degrades to a safe
+ * partial result rather than throwing, because "not a git repo" is a normal state.
+ */
+async function git(cwd, args) {
+    try {
+        const { stdout } = await exec('git', args, { cwd, windowsHide: true, timeout: 5_000 });
+        return stdout.trim();
+    }
+    catch {
+        return undefined;
+    }
+}
+function countLines(s, pred) {
+    if (!s)
+        return 0;
+    return s.split('\n').filter((l) => l.length > 0 && pred(l)).length;
+}
+export async function readGitContext(cwd) {
+    const inside = await git(cwd, ['rev-parse', '--is-inside-work-tree']);
+    if (inside !== 'true') {
+        return { isRepo: false, staged: 0, unstaged: 0, untracked: 0, recentCommits: [] };
+    }
+    const [branch, status, lastTag, log, aheadBehind] = await Promise.all([
+        git(cwd, ['rev-parse', '--abbrev-ref', 'HEAD']),
+        git(cwd, ['status', '--porcelain']),
+        git(cwd, ['describe', '--tags', '--abbrev=0']),
+        git(cwd, ['log', '-5', '--pretty=%s']),
+        git(cwd, ['rev-list', '--left-right', '--count', 'HEAD...@{upstream}']),
+    ]);
+    // Porcelain: XY <path>. X=index (staged), Y=worktree (unstaged); '??' = untracked.
+    const staged = countLines(status, (l) => /^[MADRC]/.test(l));
+    const unstaged = countLines(status, (l) => /^.[MD]/.test(l));
+    const untracked = countLines(status, (l) => l.startsWith('??'));
+    let ahead;
+    let behind;
+    if (aheadBehind) {
+        const [a, b] = aheadBehind.split(/\s+/).map(Number);
+        if (Number.isFinite(a))
+            ahead = a;
+        if (Number.isFinite(b))
+            behind = b;
+    }
+    const ctx = {
+        isRepo: true,
+        staged,
+        unstaged,
+        untracked,
+        recentCommits: log ? log.split('\n').filter(Boolean) : [],
+    };
+    if (branch)
+        ctx.branch = branch;
+    if (lastTag)
+        ctx.lastTag = lastTag;
+    if (ahead !== undefined)
+        ctx.ahead = ahead;
+    if (behind !== undefined)
+        ctx.behind = behind;
+    logger.info('Read git context', { branch: ctx.branch, staged, unstaged, untracked });
+    return ctx;
+}
+//# sourceMappingURL=gitContext.js.map

package/dist/core/github/gitContext.js.map

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

package/dist/core/github/releasePlan.d.ts

@@ -0,0 +1,8 @@
+import type { SessionState } from '../../types/domain.js';
+import type { ReleasePlan } from './types.js';
+/**
+ * Suggests the next version, tag, and release notes from the session. Per ADR-0003 it
+ * does NOT bump package.json, tag, or push — it returns a plan for a human to apply.
+ */
+export declare function proposeReleasePlan(state: SessionState, currentVersion: string): ReleasePlan;
+//# sourceMappingURL=releasePlan.d.ts.map

package/dist/core/github/releasePlan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"releasePlan.d.ts","sourceRoot":"","sources":["../../../src/core/github/releasePlan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAI1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,GAAG,WAAW,CAyD3F"}

package/dist/core/github/releasePlan.js

@@ -0,0 +1,56 @@
+import { assessSession } from '../risk/riskEngine.js';
+import { proposeChangelog } from './changelog.js';
+import { applyBump, formatSemver, parseSemver } from './semver.js';
+/**
+ * Suggests the next version, tag, and release notes from the session. Per ADR-0003 it
+ * does NOT bump package.json, tag, or push — it returns a plan for a human to apply.
+ */
+export function proposeReleasePlan(state, currentVersion) {
+    const parsed = parseSemver(currentVersion) ?? { major: 0, minor: 0, patch: 0 };
+    const corpus = [state.task, ...state.decisions.flatMap((d) => [d.summary, d.rationale ?? ''])]
+        .join('\n')
+        .toLowerCase();
+    const reasoning = [];
+    let bump;
+    if (/breaking change|\bbreaking\b|remove (public|the) api|incompatib/.test(corpus)) {
+        bump = 'major';
+        reasoning.push('Breaking-change language found in task/decisions → MAJOR.');
+    }
+    else if (Object.values(state.changedFiles).some((f) => f.changeKind === 'created' && /(^|\/)src\//.test(f.path))) {
+        bump = 'minor';
+        reasoning.push('New source modules were added → MINOR (new functionality).');
+    }
+    else {
+        bump = 'patch';
+        reasoning.push('No new features or breaking changes detected → PATCH.');
+    }
+    if (parsed.major === 0 && bump === 'major') {
+        reasoning.push('Pre-1.0: a breaking change bumps MINOR by convention, not MAJOR.');
+    }
+    const next = applyBump(parsed, bump);
+    const nextVersion = formatSemver(next);
+    const risk = assessSession(state);
+    if (risk.level !== 'low') {
+        reasoning.push(`Session engineering risk is ${risk.level.toUpperCase()} — review before tagging.`);
+    }
+    const notes = [
+        `## ${nextVersion}`,
+        '',
+        proposeChangelog(state).markdown,
+        '',
+        risk.level !== 'low' ? `> Risk at release: ${risk.level.toUpperCase()}.` : '',
+        `> Generated from kairo-session ${state.id}.`,
+    ]
+        .join('\n')
+        .replace(/\n{3,}/g, '\n\n')
+        .trim();
+    return {
+        currentVersion: formatSemver(parsed),
+        bump,
+        nextVersion,
+        tag: `v${nextVersion}`,
+        notes,
+        reasoning,
+    };
+}
+//# sourceMappingURL=releasePlan.js.map

package/dist/core/github/releasePlan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"releasePlan.js","sourceRoot":"","sources":["../../../src/core/github/releasePlan.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAa,MAAM,aAAa,CAAC;AAG9E;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAmB,EAAE,cAAsB;IAC5E,MAAM,MAAM,GAAG,WAAW,CAAC,cAAc,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IAC/E,MAAM,MAAM,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,CAAC;SAC3F,IAAI,CAAC,IAAI,CAAC;SACV,WAAW,EAAE,CAAC;IAEjB,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,IAAI,IAAU,CAAC;IACf,IAAI,iEAAiE,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACnF,IAAI,GAAG,OAAO,CAAC;QACf,SAAS,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;IAC9E,CAAC;SAAM,IACL,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,IAAI,CACpC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,SAAS,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAChE,EACD,CAAC;QACD,IAAI,GAAG,OAAO,CAAC;QACf,SAAS,CAAC,IAAI,CAAC,4DAA4D,CAAC,CAAC;IAC/E,CAAC;SAAM,CAAC;QACN,IAAI,GAAG,OAAO,CAAC;QACf,SAAS,CAAC,IAAI,CAAC,uDAAuD,CAAC,CAAC;IAC1E,CAAC;IAED,IAAI,MAAM,CAAC,KAAK,KAAK,CAAC,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;QAC3C,SAAS,CAAC,IAAI,CAAC,kEAAkE,CAAC,CAAC;IACrF,CAAC;IAED,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACrC,MAAM,WAAW,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAEvC,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IAClC,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;QACzB,SAAS,CAAC,IAAI,CACZ,+BAA+B,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,2BAA2B,CACnF,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG;QACZ,MAAM,WAAW,EAAE;QACnB,EAAE;QACF,gBAAgB,CAAC,KAAK,CAAC,CAAC,QAAQ;QAChC,EAAE;QACF,IAAI,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,sBAAsB,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE;QAC7E,kCAAkC,KAAK,CAAC,EAAE,GAAG;KAC9C;SACE,IAAI,CAAC,IAAI,CAAC;SACV,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC;SAC1B,IAAI,EAAE,CAAC;IAEV,OAAO;QACL,cAAc,EAAE,YAAY,CAAC,MAAM,CAAC;QACpC,IAAI;QACJ,WAAW;QACX,GAAG,EAAE,IAAI,WAAW,EAAE;QACtB,KAAK;QACL,SAAS;KACV,CAAC;AACJ,CAAC"}

package/dist/core/github/semver.d.ts

@@ -0,0 +1,11 @@
+/** Minimal semver handling — no dependency, only what the release planner needs. */
+export type Bump = 'major' | 'minor' | 'patch';
+export interface SemVer {
+    major: number;
+    minor: number;
+    patch: number;
+}
+export declare function parseSemver(input: string): SemVer | undefined;
+export declare function applyBump(v: SemVer, bump: Bump): SemVer;
+export declare function formatSemver(v: SemVer): string;
+//# sourceMappingURL=semver.d.ts.map

package/dist/core/github/semver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semver.d.ts","sourceRoot":"","sources":["../../../src/core/github/semver.ts"],"names":[],"mappings":"AAAA,oFAAoF;AAEpF,MAAM,MAAM,IAAI,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAE/C,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAID,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAI7D;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,MAAM,CASvD;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE9C"}

package/dist/core/github/semver.js

@@ -0,0 +1,23 @@
+/** Minimal semver handling — no dependency, only what the release planner needs. */
+const RE = /^v?(\d+)\.(\d+)\.(\d+)/;
+export function parseSemver(input) {
+    const m = RE.exec(input.trim());
+    if (!m)
+        return undefined;
+    return { major: Number(m[1]), minor: Number(m[2]), patch: Number(m[3]) };
+}
+export function applyBump(v, bump) {
+    if (bump === 'major') {
+        // Pre-1.0 convention: a breaking change bumps MINOR, not MAJOR, until 1.0.0.
+        return v.major === 0
+            ? { major: 0, minor: v.minor + 1, patch: 0 }
+            : { major: v.major + 1, minor: 0, patch: 0 };
+    }
+    if (bump === 'minor')
+        return { major: v.major, minor: v.minor + 1, patch: 0 };
+    return { major: v.major, minor: v.minor, patch: v.patch + 1 };
+}
+export function formatSemver(v) {
+    return `${v.major}.${v.minor}.${v.patch}`;
+}
+//# sourceMappingURL=semver.js.map

package/dist/core/github/semver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semver.js","sourceRoot":"","sources":["../../../src/core/github/semver.ts"],"names":[],"mappings":"AAAA,oFAAoF;AAUpF,MAAM,EAAE,GAAG,wBAAwB,CAAC;AAEpC,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IAChC,IAAI,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IACzB,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC3E,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,CAAS,EAAE,IAAU;IAC7C,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;QACrB,6EAA6E;QAC7E,OAAO,CAAC,CAAC,KAAK,KAAK,CAAC;YAClB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE;YAC5C,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IACjD,CAAC;IACD,IAAI,IAAI,KAAK,OAAO;QAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IAC9E,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,CAAS;IACpC,OAAO,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;AAC5C,CAAC"}

package/dist/core/github/types.d.ts

@@ -0,0 +1,36 @@
+import type { Bump } from './semver.js';
+/** Read-only snapshot of the working tree. All fields best-effort. */
+export interface GitContext {
+    isRepo: boolean;
+    branch?: string;
+    /** Commits ahead / behind the upstream, if an upstream is configured. */
+    ahead?: number;
+    behind?: number;
+    staged: number;
+    unstaged: number;
+    untracked: number;
+    lastTag?: string;
+    /** Subjects of the most recent commits, newest first. */
+    recentCommits: string[];
+}
+export type CommitType = 'feat' | 'fix' | 'docs' | 'refactor' | 'test' | 'build' | 'ci' | 'chore';
+export interface CommitProposal {
+    type: CommitType;
+    scope?: string;
+    /** Conventional Commits subject line, e.g. `feat(auth): add SSO login`. */
+    header: string;
+    message: string;
+    reasoning: string[];
+}
+export interface ChangelogFragment {
+    markdown: string;
+}
+export interface ReleasePlan {
+    currentVersion: string;
+    bump: Bump;
+    nextVersion: string;
+    tag: string;
+    notes: string;
+    reasoning: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/github/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/github/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAExC,sEAAsE;AACtE,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,UAAU,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,OAAO,CAAC;AAElG,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,IAAI,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB"}

package/dist/core/github/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/github/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/github/types.ts"],"names":[],"mappings":""}

package/dist/core/graph/derived.d.ts

@@ -0,0 +1,6 @@
+import type { RepoIntelligence } from '../repo/types.js';
+import type { RepoGraph } from './types.js';
+export declare function buildServiceGraph(intel: RepoIntelligence): RepoGraph;
+export declare function buildArchitectureGraph(intel: RepoIntelligence): RepoGraph;
+export declare function buildPipelineGraph(intel: RepoIntelligence): RepoGraph;
+//# sourceMappingURL=derived.d.ts.map

package/dist/core/graph/derived.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"derived.d.ts","sourceRoot":"","sources":["../../../src/core/graph/derived.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EAAwB,SAAS,EAAE,MAAM,YAAY,CAAC;AAWlE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,gBAAgB,GAAG,SAAS,CAuCpE;AAiBD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,gBAAgB,GAAG,SAAS,CA8CzE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,gBAAgB,GAAG,SAAS,CAwBrE"}

package/dist/core/graph/derived.js

@@ -0,0 +1,133 @@
+/**
+ * Service / architecture / pipeline graphs are *derived purely* from the cached
+ * RepoIntelligence — no extra scanning. They are intentionally high-level and
+ * heuristic; the note on each graph states that so the reader trusts it appropriately.
+ */
+function node(id, label, group) {
+    return group !== undefined ? { id, label, group } : { id, label };
+}
+export function buildServiceGraph(intel) {
+    const nodes = [];
+    const edges = [];
+    const has = (cat) => intel.frameworks.some((f) => f.category === cat);
+    const names = (cat) => intel.frameworks
+        .filter((f) => f.category === cat)
+        .map((f) => f.name)
+        .join(' / ');
+    if (has('frontend') || has('fullstack')) {
+        nodes.push(node('client', `Client\n(${names('frontend') || names('fullstack')})`, 'client'));
+    }
+    if (has('backend') || has('fullstack')) {
+        nodes.push(node('api', `Backend / API\n(${names('backend') || names('fullstack')})`, 'api'));
+    }
+    if (has('infra')) {
+        nodes.push(node('infra', `Infrastructure\n(${names('infra')})`, 'infra'));
+    }
+    if (has('build')) {
+        nodes.push(node('ci', `CI / Build\n(${names('build')})`, 'ci'));
+    }
+    if (nodes.length === 0) {
+        nodes.push(node('app', `Application\n(${intel.languages.primary})`, 'app'));
+    }
+    const id = (x) => nodes.some((n) => n.id === x);
+    if (id('client') && id('api'))
+        edges.push({ from: 'client', to: 'api', label: 'requests' });
+    if (id('api') && id('infra'))
+        edges.push({ from: 'api', to: 'infra', label: 'deploys to' });
+    if (id('ci') && id('infra'))
+        edges.push({ from: 'ci', to: 'infra', label: 'ships' });
+    return {
+        kind: 'service',
+        title: 'Service graph',
+        nodes,
+        edges,
+        truncated: false,
+        note: 'High-level services inferred from detected frameworks/infra. Heuristic, not a runtime trace.',
+    };
+}
+const LAYER_RULES = [
+    {
+        test: /^(api|routes?|controllers?|handlers?|graphql|grpc|http|web|server|pages?|app|cli|cmd)$/i,
+        layer: 'Interface',
+        order: 0,
+    },
+    { test: /^(services?|core|domain|usecases?|business|lib|engine)$/i, layer: 'Domain', order: 1 },
+    {
+        test: /^(db|data|models?|repositories|prisma|store|storage|migrations?)$/i,
+        layer: 'Data',
+        order: 2,
+    },
+    { test: /^(infra|config|deploy|ops|k8s|terraform)$/i, layer: 'Infrastructure', order: 3 },
+];
+export function buildArchitectureGraph(intel) {
+    // Most TS projects nest layers under src/, so consider source subdirs too.
+    const candidates = [...intel.inventory.topLevelDirs, ...intel.inventory.sourceDirs];
+    const found = new Map();
+    for (const d of candidates) {
+        for (const r of LAYER_RULES) {
+            if (r.test.test(d))
+                found.set(r.layer, r.order);
+        }
+    }
+    if (found.size === 0) {
+        // Fall back to listing the actual layer-candidate dirs as opaque modules.
+        const dirs = (intel.inventory.sourceDirs.length > 0
+            ? intel.inventory.sourceDirs
+            : intel.inventory.topLevelDirs).slice(0, 20);
+        const pool = intel.inventory.sourceDirs.length > 0
+            ? intel.inventory.sourceDirs
+            : intel.inventory.topLevelDirs;
+        return {
+            kind: 'architecture',
+            title: 'Architecture graph',
+            nodes: dirs.map((d, i) => node(`d${i}`, d)),
+            edges: [],
+            truncated: pool.length > 20,
+            note: intel.inventory.sourceDirs.length > 0
+                ? 'No conventional layers detected; showing source modules.'
+                : 'No conventional layers detected; showing top-level directories only.',
+        };
+    }
+    const ordered = [...found.entries()].sort((a, b) => a[1] - b[1]).map(([l]) => l);
+    const nodes = ordered.map((l, i) => node(`L${i}`, l, l));
+    const edges = [];
+    for (let i = 0; i < ordered.length - 1; i++) {
+        edges.push({ from: `L${i}`, to: `L${i + 1}`, label: 'depends on' });
+    }
+    return {
+        kind: 'architecture',
+        title: 'Architecture (layered)',
+        nodes,
+        edges,
+        truncated: false,
+        note: 'Layers inferred from directory naming conventions. Heuristic.',
+    };
+}
+export function buildPipelineGraph(intel) {
+    const stages = ['Source'];
+    const fwIds = new Set(intel.frameworks.map((f) => f.id));
+    if (fwIds.has('typescript'))
+        stages.push('Typecheck');
+    if (fwIds.has('vitest') || fwIds.has('jest'))
+        stages.push('Test');
+    if (fwIds.has('vite') || fwIds.has('webpack') || fwIds.has('typescript'))
+        stages.push('Build');
+    const nodes = stages.map((s, i) => node(`s${i}`, s, 'stage'));
+    const edges = [];
+    for (let i = 0; i < stages.length - 1; i++)
+        edges.push({ from: `s${i}`, to: `s${i + 1}` });
+    intel.ciWorkflows.forEach((w, i) => {
+        const wid = `w${i}`;
+        nodes.push(node(wid, `CI: ${w.split('/').pop() ?? w}`, 'ci'));
+        edges.push({ from: `s${stages.length - 1}`, to: wid, label: 'runs in' });
+    });
+    return {
+        kind: 'pipeline',
+        title: 'Build / CI pipeline',
+        nodes,
+        edges,
+        truncated: false,
+        note: 'Pipeline inferred from build tooling and CI workflow files. Heuristic.',
+    };
+}
+//# sourceMappingURL=derived.js.map

package/dist/core/graph/derived.js.map

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

package/dist/core/graph/graphEngine.d.ts

@@ -0,0 +1,11 @@
+import type { RepoIntelligence } from '../repo/types.js';
+import type { GraphKind, RepoGraph } from './types.js';
+/**
+ * Single entry point for the graph engine. The `module` graph is read from the cached
+ * intelligence (it required scanning); the rest are derived purely on demand. No
+ * filesystem access here — graphs are a projection of intelligence.
+ */
+export declare function buildGraph(intel: RepoIntelligence, kind: GraphKind): RepoGraph;
+export declare const GRAPH_KINDS: readonly GraphKind[];
+export declare function buildAllGraphs(intel: RepoIntelligence): Record<GraphKind, RepoGraph>;
+//# sourceMappingURL=graphEngine.d.ts.map

package/dist/core/graph/graphEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphEngine.d.ts","sourceRoot":"","sources":["../../../src/core/graph/graphEngine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAGvD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,SAAS,GAAG,SAAS,CAW9E;AAED,eAAO,MAAM,WAAW,EAAE,SAAS,SAAS,EAAsD,CAAC;AAEnG,wBAAgB,cAAc,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,CAOpF"}

package/dist/core/graph/graphEngine.js

@@ -0,0 +1,28 @@
+import { buildServiceGraph, buildArchitectureGraph, buildPipelineGraph } from './derived.js';
+/**
+ * Single entry point for the graph engine. The `module` graph is read from the cached
+ * intelligence (it required scanning); the rest are derived purely on demand. No
+ * filesystem access here — graphs are a projection of intelligence.
+ */
+export function buildGraph(intel, kind) {
+    switch (kind) {
+        case 'module':
+            return intel.moduleGraph;
+        case 'service':
+            return buildServiceGraph(intel);
+        case 'architecture':
+            return buildArchitectureGraph(intel);
+        case 'pipeline':
+            return buildPipelineGraph(intel);
+    }
+}
+export const GRAPH_KINDS = ['module', 'service', 'architecture', 'pipeline'];
+export function buildAllGraphs(intel) {
+    return {
+        module: intel.moduleGraph,
+        service: buildServiceGraph(intel),
+        architecture: buildArchitectureGraph(intel),
+        pipeline: buildPipelineGraph(intel),
+    };
+}
+//# sourceMappingURL=graphEngine.js.map

package/dist/core/graph/graphEngine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphEngine.js","sourceRoot":"","sources":["../../../src/core/graph/graphEngine.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAE7F;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,KAAuB,EAAE,IAAe;IACjE,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,QAAQ;YACX,OAAO,KAAK,CAAC,WAAW,CAAC;QAC3B,KAAK,SAAS;YACZ,OAAO,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAClC,KAAK,cAAc;YACjB,OAAO,sBAAsB,CAAC,KAAK,CAAC,CAAC;QACvC,KAAK,UAAU;YACb,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAAyB,CAAC,QAAQ,EAAE,SAAS,EAAE,cAAc,EAAE,UAAU,CAAC,CAAC;AAEnG,MAAM,UAAU,cAAc,CAAC,KAAuB;IACpD,OAAO;QACL,MAAM,EAAE,KAAK,CAAC,WAAW;QACzB,OAAO,EAAE,iBAAiB,CAAC,KAAK,CAAC;QACjC,YAAY,EAAE,sBAAsB,CAAC,KAAK,CAAC;QAC3C,QAAQ,EAAE,kBAAkB,CAAC,KAAK,CAAC;KACpC,CAAC;AACJ,CAAC"}

package/dist/core/graph/imports.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Heuristic import extraction. This is regex-based, NOT a full AST, and we say so
+ * honestly: it catches static `import`/`require`/`from` forms and resolves only
+ * INTERNAL (relative) edges. Dynamic/computed specifiers and bare package imports are
+ * intentionally out of scope — they would add noise without improving the
+ * directory-level graph the engine actually renders.
+ */
+export type ImportLang = 'js' | 'py';
+export declare function importLangForExt(ext: string): ImportLang | undefined;
+/** Raw specifier strings referenced by a file (deduped, order-stable). */
+export declare function extractImports(lang: ImportLang, text: string): string[];
+export interface RawImport {
+    from: string;
+    spec: string;
+    lang: ImportLang;
+}
+/** File-level internal edges `[fromRel, toRel]`, deduped, deterministic. */
+export declare function resolveModuleEdges(sourceFiles: Set<string>, raw: RawImport[]): Array<[string, string]>;
+//# sourceMappingURL=imports.d.ts.map

package/dist/core/graph/imports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imports.d.ts","sourceRoot":"","sources":["../../../src/core/graph/imports.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,IAAI,CAAC;AAYrC,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAEpE;AAYD,0EAA0E;AAC1E,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAYvE;AAuED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,CAAC;CAClB;AAED,4EAA4E;AAC5E,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,EACxB,GAAG,EAAE,SAAS,EAAE,GACf,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAgBzB"}