@codemieai/code 0.15.0 → 0.15.2

package/dist/utils/whatsnew.js

@@ -0,0 +1,200 @@
+/**
+ * What's New — release notes from CHANGELOG.md
+ *
+ * CHANGELOG.md (Keep a Changelog format) is the curated source of truth for
+ * release notes. It ships inside the npm package and is consumed by:
+ * - `codemie whatsnew` — browse notes for the current, one, or all versions
+ * - the once-per-upgrade startup notice in bin/codemie.js, which shows the
+ *   current version's notes once and records a `.last-seen-version` marker
+ *   under the CodeMie home directory
+ *
+ * This module must stay safe to import from the bin entry point, so its
+ * dependencies are limited to fs/path/chalk plus the logger, paths, and tips
+ * utilities — never commander or the CLI layer.
+ *
+ * Environment Variables:
+ * - CODEMIE_TIPS=false|0|no: also suppresses the upgrade notice. The "reduce
+ *   chatter" switch is shared with feature tips on purpose — see tips.ts.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
+import path from 'path';
+import chalk from 'chalk';
+import { logger } from './logger.js';
+import { getCodemiePath, getDirname } from './paths.js';
+import { isTipsEnabled } from './tips.js';
+/**
+ * Tolerant Keep-a-Changelog parser. Recognizes `## [x.y.z] - date` headings,
+ * `### Section` subheadings, and `- item` bullets; everything else is skipped.
+ */
+export function parseChangelog(content) {
+    const entries = [];
+    let currentEntry = null;
+    let currentSection = null;
+    for (const line of content.split(/\r?\n/)) {
+        const versionMatch = line.match(/^##\s+\[([^\]]+)\](?:\s*-\s*(.+?))?\s*$/);
+        if (versionMatch) {
+            currentEntry = {
+                version: versionMatch[1].trim(),
+                date: versionMatch[2]?.trim(),
+                sections: []
+            };
+            entries.push(currentEntry);
+            currentSection = null;
+            continue;
+        }
+        if (!currentEntry) {
+            continue;
+        }
+        const sectionMatch = line.match(/^###\s+(.+?)\s*$/);
+        if (sectionMatch) {
+            currentSection = { title: sectionMatch[1].trim(), items: [] };
+            currentEntry.sections.push(currentSection);
+            continue;
+        }
+        const itemMatch = line.match(/^\s*[-*]\s+(.+?)\s*$/);
+        if (itemMatch && currentSection) {
+            currentSection.items.push(itemMatch[1].trim());
+        }
+    }
+    return entries;
+}
+/**
+ * Locate CHANGELOG.md at the package root. Works both from src/utils (dev
+ * repo) and dist/utils (built/installed package) — the root is two levels up
+ * in both layouts.
+ *
+ * @returns Absolute path to CHANGELOG.md, or null when it is not shipped
+ */
+export function getChangelogPath() {
+    const changelogPath = path.resolve(getDirname(import.meta.url), '../../CHANGELOG.md');
+    return existsSync(changelogPath) ? changelogPath : null;
+}
+/**
+ * Read release notes from the changelog.
+ *
+ * @param version - When given, the entry for this exact version; if there is
+ *   no matching heading, falls back to the newest versioned entry (or
+ *   Unreleased when that is all there is) so the once-per-upgrade notice
+ *   always has something to show
+ * @returns Parsed entries (newest first, as written), or an empty array when
+ *   the changelog is missing or unparseable
+ */
+export function getReleaseNotes(version) {
+    const changelogPath = getChangelogPath();
+    if (!changelogPath) {
+        logger.debug('[whatsnew] CHANGELOG.md not found at package root');
+        return [];
+    }
+    try {
+        const entries = parseChangelog(readFileSync(changelogPath, 'utf-8'));
+        if (entries.length === 0) {
+            logger.debug('[whatsnew] CHANGELOG.md parsed to zero release entries', { changelogPath });
+        }
+        if (!version) {
+            return entries;
+        }
+        const exact = entries.filter(entry => entry.version === version);
+        if (exact.length > 0) {
+            return exact;
+        }
+        // No heading for this exact version (changelog not updated for the
+        // release) — fall back to the newest versioned entry so the once-per-
+        // upgrade notice still shows something before the version is marked seen.
+        const fallback = entries.find(entry => entry.version !== 'Unreleased') ?? entries[0];
+        if (fallback) {
+            logger.debug(`[whatsnew] No changelog entry for ${version} — falling back to ${fallback.version}`);
+            return [fallback];
+        }
+        return [];
+    }
+    catch (error) {
+        logger.debug('[whatsnew] Failed to read changelog:', error);
+        return [];
+    }
+}
+const lastSeenFilePath = () => getCodemiePath('.last-seen-version');
+/**
+ * Version for which the upgrade notice was last shown, or null if never.
+ * Best-effort: an unreadable marker is treated as "never seen".
+ */
+export function getLastSeenVersion() {
+    try {
+        return readFileSync(lastSeenFilePath(), 'utf-8').trim() || null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Record that the upgrade notice was shown for a version. Best-effort: write
+ * failures are swallowed — worst case the notice shows once more.
+ */
+export function markVersionSeen(version) {
+    try {
+        const file = lastSeenFilePath();
+        mkdirSync(path.dirname(file), { recursive: true });
+        writeFileSync(file, version, 'utf-8');
+    }
+    catch (error) {
+        logger.debug('[whatsnew] Failed to persist last-seen version (non-fatal):', error);
+    }
+}
+/**
+ * Render release notes to the console. Never throws.
+ *
+ * @param options.maxItems - Cap on the total number of bullets printed across
+ *   all entries; when truncated, a pointer to `codemie whatsnew` is appended
+ */
+export function renderReleaseNotes(entries, options) {
+    try {
+        if (entries.length === 0) {
+            return;
+        }
+        let remaining = options?.maxItems ?? Number.POSITIVE_INFINITY;
+        let truncated = false;
+        console.log();
+        for (const entry of entries) {
+            if (remaining <= 0) {
+                truncated = true;
+                break;
+            }
+            const dateSuffix = entry.date ? ` (${entry.date})` : '';
+            console.log(chalk.bold.cyan(`## What's new in ${entry.version}${dateSuffix}`));
+            for (const section of entry.sections) {
+                if (remaining <= 0) {
+                    truncated = true;
+                    break;
+                }
+                if (section.items.length === 0) {
+                    continue;
+                }
+                console.log(chalk.dim(`  ${section.title}`));
+                for (const item of section.items) {
+                    if (remaining <= 0) {
+                        truncated = true;
+                        break;
+                    }
+                    console.log(`  • ${item}`);
+                    remaining--;
+                }
+            }
+            console.log();
+        }
+        if (truncated) {
+            console.log(chalk.dim('  … run `codemie whatsnew` for the full notes'));
+            console.log();
+        }
+    }
+    catch (error) {
+        logger.debug('[whatsnew] renderReleaseNotes failed (non-fatal):', error);
+    }
+}
+/**
+ * Whether the once-per-upgrade notice may print. Deliberately shares the
+ * CODEMIE_TIPS switch with feature tips — one "reduce chatter" toggle for all
+ * informational CLI output.
+ */
+export function isWhatsNewEnabled() {
+    return isTipsEnabled();
+}
+//# sourceMappingURL=whatsnew.js.map

package/dist/utils/whatsnew.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codemieai/code",
-  "version": "0.15.0",
+  "version": "0.15.2",
   "description": "Unified AI coding assistant CLI - Manage Claude Code, Gemini & custom agents. Multi-provider support (OpenAI, Azure, LiteLLM, SSO). Built-in LangGraph agent with file operations & git integration.",
   "type": "module",
   "main": "dist/index.js",
@@ -26,7 +26,9 @@
     "bin",
     "scripts",
     "src/workflows/templates/**/*.yml",
+    "src/utils/tips.json",
     "README.md",
+    "CHANGELOG.md",
     "LICENSE"
   ],
   "scripts": {
@@ -35,14 +37,7 @@
     "copy-plugin": "node scripts/copy-plugins.js",
     "prepare:install-artifacts": "node scripts/prepare-install-artifacts.mjs",
     "dev": "tsc --watch",
-    "test": "vitest",
-    "test:unit": "vitest run --project unit",
-    "test:integration": "vitest run --project cli",
-    "test:integration:cli": "vitest run --project cli",
-    "test:integration:vscode-models": "vitest run --project cli tests/integration/vscode-byok.test.ts tests/integration/vscode-models.live.test.ts",
-    "test:integration:agent": "vitest run --project agent",
-    "test:run": "vitest run --project unit --project cli",
-    "test:all": "vitest run --project unit && vitest run --project cli && vitest run --project agent",
+    "test": "vitest run --project unit && vitest run --project cli && vitest run --project agent",
     "test:coverage": "vitest run --project unit --coverage",
     "test:watch": "vitest --watch",
     "test:ui": "vitest --ui",
@@ -55,7 +50,7 @@
     "commitlint:last": "commitlint --from HEAD~1 --to HEAD --verbose",
     "validate:secrets": "node scripts/validate-secrets.js",
     "license-check": "node scripts/license-check.js",
-    "ci": "npm run license-check && npm run lint && npm run build && npm run test:unit && npm run test:integration",
+    "ci": "npm run license-check && npm run lint && npm run build && vitest run --project unit && vitest run --project cli",
     "ci:full": "npm run commitlint:last && npm run ci",
     "prepare": "husky",
     "prepublishOnly": "npm run build",

package/scripts/release.sh

@@ -6,7 +6,7 @@
 # Designed to be resumable - can continue from failed steps
 #
 # Release flow: version bump → commit → agent tests gate → tag → push → GitHub release
-# Agent tests gate: runs `npm run test:integration:agent` before tagging.
+# Agent tests gate: runs `npx vitest run --project agent` before tagging.
 #   - Tests pass → continue automatically
 #   - Tests fail → release blocked (fix tests first)
 #   - Tests cannot run (missing SSO/JWT credentials) → manual confirmation required
@@ -132,6 +132,12 @@ if ! git diff --quiet || ! git diff --cached --quiet; then
     fi
 fi
 
+# Remind about release notes in CHANGELOG.md (non-blocking; `codemie whatsnew`
+# and the once-per-upgrade notice read them)
+if [[ ! -f CHANGELOG.md ]] || ! grep -q "^## \[$VERSION\]" CHANGELOG.md; then
+    printf "\033[33m⚠️  CHANGELOG.md has no '## [%s]' section — add release notes before publishing.\033[0m\n" "$VERSION"
+fi
+
 # Show what will be done
 echo ""
 echo "📋 Actions that will be performed:"
@@ -207,7 +213,7 @@ echo ""
 echo "🧪 Running agent tests..."
 AGENT_TEST_JSON=$(mktemp /tmp/agent-test-XXXXX.json) || { echo "ERROR: mktemp failed, cannot capture agent test results"; exit 1; }
 trap 'rm -f "$AGENT_TEST_JSON"' EXIT INT TERM
-npm run test:integration:agent -- --reporter=verbose --reporter=json --outputFile="$AGENT_TEST_JSON"
+npx vitest run --project agent --reporter=verbose --reporter=json --outputFile="$AGENT_TEST_JSON"
 AGENT_EXIT_CODE=$?
 
 AGENT_PASSED=0
@@ -237,7 +243,7 @@ else
     echo "     (check: cat ~/.codemie/codemie-cli.config.json)"
     echo "   • CI:    set CI_IS_LOCAL_RUN=false and provide tests/.env.test.local"
     echo ""
-    echo "   To run manually: npm run test:integration:agent"
+    echo "   To run manually: npx vitest run --project agent"
     echo ""
     read -p "❓ Have you manually run agent tests and confirmed they pass? (y/N): " -n 1 -r
     echo