@pugi/cli 0.1.0-beta.99 → 1.0.0-alpha.1

package/dist/tui/welcome-data.js

@@ -1,293 +0,0 @@
-/**
- * Pure data layer for the `<WelcomeBanner />` component (CEO P0 #2,
- *). Lives in its own module so it can be unit-tested without
- * rendering Ink, and so the banner component itself contains zero IO.
- *
- * The banner is the 2-column boxed greeting that replaces the
- * wave-3 `<ReplSplash />` on the bare REPL boot path. It mirrors
- * the upstream tool's boot layout:
- *
- *    ╭────── Pugi v0.1.0-beta.46 ──────╮
- *    │                                 │ Tips for getting started
- *    │     Welcome back operator!        │ Run /init to create PUGI.md...
- *    │                                 │ ───────────
- *    │        ▗ ▗  ▖ ▖               │ What's new
- *    │          ▘▘ ▝▝                 │ * 0.1.0-beta.26 — RAG ...
- *    │ Sonnet 4.6 (1M context) · Founder
- *    │ operator@gmail.com · pugi-io Org
- *    │ <workspace>
- *    ╰──────────────────────────────────╯
- *
- * Data sources, in priority order:
- *
- *  - Account email + tenant + plan: JWT principal decoded from the
- *    active credential. Falls back to anonymous label when no
- *    credential is on disk (operator boots `pugi` before login).
- *  - Greeting first-name: best-effort split of the local part of the
- *    email. Falls back к "operator" when unauthenticated.
- *  - Model: env override `PUGI_ENGINE_MODEL_CODE`, then the operator's
- *    workspace settings `defaultModel`, then "Sonnet 4.6 (1M context)"
- *    as the locked default.
- *  - Cwd: absolute path of `process.cwd()` — banner left column shows
- *    the full path so the operator confirms они are в the right repo.
- *  - What's new: top 3 release-note titles from `apps/pugi-cli/CHANGELOG.md`
- *    newer than `~/.pugi/.last-seen-version`. Falls back к the top 3
- *    overall when last-seen marker is missing. Each entry is a one-line
- *    headline ("0.1.0-beta.26 — RAG consumer middleware") trimmed
- *    к 60 chars so the right column does not wrap on a 100-col terminal.
- *
- * Every resolver swallows its IO error and returns the documented
- * fallback so a partial environment (missing CHANGELOG, malformed JWT,
- * unreadable settings) never blocks the banner.
- */
-import { existsSync, readFileSync } from 'node:fs';
-import { homedir } from 'node:os';
-import { dirname, resolve as resolvePath } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { DEFAULT_API_URL, normalizeApiUrl, readCredentialsFile, resolveActiveCredential, } from '../core/credentials.js';
-import { parseChangelog } from '../core/release-notes/parser.js';
-function decodeJwtPayload(token) {
-    try {
-        const parts = token.split('.');
-        if (parts.length < 2)
-            return null;
-        const payload = parts[1];
-        if (!payload)
-            return null;
-        const padded = payload
-            .replace(/-/g, '+')
-            .replace(/_/g, '/')
-            .padEnd(payload.length + ((4 - (payload.length % 4)) % 4), '=');
-        const json = Buffer.from(padded, 'base64').toString('utf8');
-        const obj = JSON.parse(json);
-        if (!obj || typeof obj !== 'object')
-            return null;
-        return {
-            ...(typeof obj.sub === 'string' && { sub: obj.sub }),
-            ...(typeof obj.email === 'string' && { email: obj.email }),
-            ...(typeof obj.customerId === 'string' && { customerId: obj.customerId }),
-            ...(typeof obj.plan === 'string' && { plan: obj.plan }),
-        };
-    }
-    catch {
-        return null;
-    }
-}
-/* ------------------------------------------------------------------ */
-/* Resolvers                                                         */
-/* ------------------------------------------------------------------ */
-/**
- * Derive a greeting first-name from an email's local part. The split
- * is intentionally aggressive: dot-separated, hyphen-separated, and
- * digit-stripped so `operator@gmail.com` resolves к "operator" instead
- * of "operator". Title-cases the first segment. Falls back к
- * "operator" when no email is available.
- *
- * Export so the spec can lock the heuristic against edge cases (numeric
- * local part, plus-tag aliases, single-letter local part).
- */
-export function deriveGreetingName(email) {
-    if (!email || typeof email !== 'string')
-        return 'operator';
-    const at = email.indexOf('@');
-    if (at <= 0)
-        return 'operator';
-    const local = email.slice(0, at);
-    // Strip plus-tag aliases (`name+tag@host` → `name`).
-    const noTag = local.split('+')[0] ?? local;
-    // First dot / hyphen / underscore segment wins; this is the
-    // colloquial "given name" surface for the vast majority of work
-    // emails ("first.last@..." / "first-last@...").
-    const firstSegment = noTag.split(/[._-]/)[0] ?? noTag;
-    // Strip trailing digits some signup flows append (`yurii2@`) so the
-    // greeting reads as a name, not a username.
-    const stripped = firstSegment.replace(/[0-9]+$/u, '');
-    if (stripped.length === 0)
-        return 'operator';
-    return stripped.charAt(0).toUpperCase() + stripped.slice(1);
-}
-/**
- * Resolve the model display string. Priority:
- *
- *  1. `PUGI_ENGINE_MODEL_CODE` env override (operator-set in shell).
- *  2. `.pugi/settings.json` → `defaultModel` field (per-workspace).
- *  3. Locked default `"Sonnet 4.6 (1M context)"`.
- *
- * Returns the value verbatim — the banner is responsible for trimming
- * if the string is too long for the column.
- */
-export function resolveModelDisplay(env, settingsOverride) {
-    const envModel = env.PUGI_ENGINE_MODEL_CODE;
-    if (typeof envModel === 'string' && envModel.length > 0)
-        return envModel;
-    const settingsModel = settingsOverride?.defaultModel;
-    if (typeof settingsModel === 'string' && settingsModel.length > 0) {
-        return settingsModel;
-    }
-    return 'Sonnet 4.6 (1M context)';
-}
-/**
- * Locate the bundled CHANGELOG.md. The CLI ships к
- * `node_modules/@pugi/cli/dist/tui/welcome-data.js` so the changelog
- * lives at `node_modules/@pugi/cli/CHANGELOG.md` — two directory hops
- * up from this file. In a local pnpm dev checkout the structure is the
- * same (`src/tui/` ⇒ `../../CHANGELOG.md`) because tsx re-resolves the
- * same relative tree.
- */
-function defaultChangelogPath() {
-    const here = dirname(fileURLToPath(import.meta.url));
-    return resolvePath(here, '..', '..', 'CHANGELOG.md');
-}
-/**
- * Read top-3 "what's new" headlines from the CLI CHANGELOG.md. Each
- * headline is `<version> — <first non-empty section body line>` trimmed
- * к 60 chars so the right column does not wrap on a 100-col terminal.
- * Returns an empty array when the file is missing / unparseable.
- *
- * The body-line heuristic walks к the first non-empty, non-section-
- * header line below the version header. For Keep-a-Changelog entries
- * the second line is usually `### Added` / `### Fixed`; we skip those
- * headers и land on the first bullet, which is the operator-visible
- * one-liner ("- L30 `pugi theme` ...").
- */
-export function readWhatsNew(changelogPath) {
-    const path = changelogPath ?? defaultChangelogPath();
-    try {
-        if (!existsSync(path))
-            return [];
-        const raw = readFileSync(path, 'utf8');
-        if (!raw || raw.length === 0)
-            return [];
-        const sections = parseChangelog(raw);
-        const headlines = [];
-        for (const section of sections) {
-            if (headlines.length >= 3)
-                break;
-            // Skip the "[Unreleased]" / "[Unreleased] - YYYY-MM-DD" section —
-            // the banner is meant к surface SHIPPED notes only. The parser
-            // captures Unreleased identically к а tagged version, so we
-            // filter here.
-            if (/^unreleased$/i.test(section.version))
-                continue;
-            const firstBullet = pickFirstBullet(section.body);
-            if (!firstBullet)
-                continue;
-            const headline = `${section.version} — ${firstBullet}`;
-            headlines.push(truncate(headline, 60));
-        }
-        return headlines;
-    }
-    catch {
-        return [];
-    }
-}
-/**
- * Pull the first bullet text out of a Keep-a-Changelog section body.
- * Skips `### <subsection>` headers, blank lines, и non-bullet prose
- * (release-note footers like "### Notes"). Returns undefined when no
- * bullet is present.
- *
- * Body lines arrive verbatim from the parser; bullets follow the
- * `- ` / `* ` Markdown convention. We strip the leading bullet glyph
- * + the first whitespace run so the rendered string is the bullet
- * content only.
- */
-function pickFirstBullet(body) {
-    const lines = body.split('\n');
-    for (const line of lines) {
-        const trimmed = line.trim();
-        if (trimmed.length === 0)
-            continue;
-        if (trimmed.startsWith('### '))
-            continue;
-        if (trimmed.startsWith('- ') || trimmed.startsWith('* ')) {
-            // Strip leading bullet glyph + ws and collapse internal MD ticks.
-            return trimmed
-                .slice(2)
-                .replace(/`/g, '')
-                .replace(/\*\*/g, '')
-                .trim();
-        }
-    }
-    return undefined;
-}
-function truncate(text, max) {
-    if (text.length <= max)
-        return text;
-    // Reserve 1 char for the ellipsis so we land on EXACTLY `max`
-    // visible chars including the dot. Single Unicode ellipsis would be
-    // narrower but some terminals render it as а full-width glyph in
-    // CJK locales — ASCII three-dot stays predictable.
-    return `${text.slice(0, max - 1).trimEnd()}…`;
-}
-/**
- * Resolve the active credential and decode the JWT principal. Returns
- * the email / tenant / plan triple when authenticated, null fields when
- * anonymous. Encapsulates the credential + JWT IO so the spec can drive
- * the resolver via an env override.
- */
-function resolvePrincipal(env, home) {
-    const credential = resolveActiveCredential(env, home);
-    if (!credential) {
-        const file = readCredentialsFile(home);
-        return {
-            apiUrl: normalizeApiUrl(env.PUGI_API_URL ?? file.activeApiUrl ?? DEFAULT_API_URL),
-        };
-    }
-    const principal = decodeJwtPayload(credential.apiKey);
-    return {
-        apiUrl: credential.apiUrl,
-        ...(principal?.email && { email: principal.email }),
-        ...(principal?.customerId && { tenant: principal.customerId }),
-        ...(principal?.plan && { plan: principal.plan }),
-    };
-}
-/**
- * Best-effort read of `.pugi/settings.json`. Returns null when the file
- * is missing / unreadable / malformed so the model resolver can fall
- * back to the env override + locked default.
- */
-function readSettingsBlob(cwd) {
-    try {
-        const path = resolvePath(cwd, '.pugi', 'settings.json');
-        if (!existsSync(path))
-            return null;
-        const raw = readFileSync(path, 'utf8');
-        if (!raw || raw.length === 0)
-            return null;
-        const obj = JSON.parse(raw);
-        if (typeof obj?.defaultModel === 'string') {
-            return { defaultModel: obj.defaultModel };
-        }
-        return {};
-    }
-    catch {
-        return null;
-    }
-}
-/* ------------------------------------------------------------------ */
-/* Entry point                                                       */
-/* ------------------------------------------------------------------ */
-export function collectWelcomeData(input) {
-    const env = input.env ?? process.env;
-    const home = input.home ?? homedir();
-    const cwd = input.cwd ?? process.cwd();
-    const principal = resolvePrincipal(env, home);
-    const settings = input.settingsOverride !== undefined
-        ? input.settingsOverride
-        : readSettingsBlob(cwd);
-    const greetingName = deriveGreetingName(principal.email);
-    const model = resolveModelDisplay(env, settings);
-    const whatsNew = readWhatsNew(input.changelogPath);
-    return {
-        greetingName,
-        ...(principal.email && { email: principal.email }),
-        ...(principal.tenant && { tenant: principal.tenant }),
-        ...(principal.plan && { plan: principal.plan }),
-        model,
-        cwd,
-        cliVersion: input.cliVersion,
-        whatsNew,
-    };
-}
-//# sourceMappingURL=welcome-data.js.map

package/dist/tui/workspace-context.js

@@ -1,105 +0,0 @@
-/**
- * Workspace-context badges for the REPL bottom status bar (
- * wave 3). Mirrors the Gemini CLI pattern where the operator sees
- * `N GEMINI.md · N MCP · N skills · N% quota` at a glance.
- *
- * Pure-IO helpers: each function reads disk once, swallows every error
- * (a missing directory is the common case for a fresh workspace), and
- * returns a count. The REPL host calls these at mount, caches the
- * result in component state, and passes them to `<StatusBar />`. We
- * intentionally do NOT refresh on every keystroke — a brand-new
- * PUGI.md does not appear mid-session often enough to warrant a
- * watcher.
- */
-import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
-import { homedir } from 'node:os';
-import { join, resolve } from 'node:path';
-/**
- * Count PUGI.md files in the workspace root. We do NOT walk
- * subdirectories — a deep grep would burn IO on every REPL boot and
- * the convention is one root file. Mirrors how Gemini CLI counts
- * `GEMINI.md` at the project root only.
- */
-export function countPugiMdFiles(cwd) {
-    try {
-        const entries = readdirSync(cwd, { withFileTypes: true });
-        let count = 0;
-        for (const entry of entries) {
-            if (!entry.isFile())
-                continue;
-            // Case-insensitive so PUGI.md, Pugi.md, pugi.md all count.
-            if (entry.name.toLowerCase() === 'pugi.md')
-                count += 1;
-        }
-        return count;
-    }
-    catch {
-        return 0;
-    }
-}
-/**
- * Count MCP servers wired into `.pugi/mcp.json` at the workspace root.
- * Reads the file, parses JSON, returns the `servers` array length when
- * present. Returns 0 on any failure (file missing, malformed JSON,
- * wrong shape) — the status bar treats 0 and "error" the same.
- */
-export function countMcpServers(cwd) {
-    const path = join(cwd, '.pugi', 'mcp.json');
-    if (!existsSync(path))
-        return 0;
-    try {
-        const raw = readFileSync(path, 'utf8');
-        const parsed = JSON.parse(raw);
-        if (parsed && typeof parsed === 'object') {
-            const servers = parsed.servers;
-            if (Array.isArray(servers))
-                return servers.length;
-            // Also support the `{ "<name>": { ... } }` map shape used by
-            // the Anthropic / the upstream tool mcp config convention.
-            const entries = Object.keys(parsed);
-            return entries.length;
-        }
-        return 0;
-    }
-    catch {
-        return 0;
-    }
-}
-/**
- * Count installed skills across the project-local + user-global
- * directories: `.pugi/skills/` (per-workspace) + `~/.pugi/skills/`
- * (per-machine). Each immediate subdirectory counts as one skill;
- * matches the `skill-creator` convention.
- */
-export function countSkills(cwd, home = homedir()) {
-    const projectDir = resolve(cwd, '.pugi', 'skills');
-    const userDir = resolve(home, '.pugi', 'skills');
-    return countSubdirs(projectDir) + countSubdirs(userDir);
-}
-function countSubdirs(dir) {
-    try {
-        if (!existsSync(dir))
-            return 0;
-        const stat = statSync(dir);
-        if (!stat.isDirectory())
-            return 0;
-        const entries = readdirSync(dir, { withFileTypes: true });
-        let count = 0;
-        for (const entry of entries) {
-            if (entry.isDirectory())
-                count += 1;
-        }
-        return count;
-    }
-    catch {
-        return 0;
-    }
-}
-export function collectWorkspaceContext(cwd, home = homedir()) {
-    return {
-        pugiMdCount: countPugiMdFiles(cwd),
-        mcpServerCount: countMcpServers(cwd),
-        skillCount: countSkills(cwd, home),
-    };
-}
-//# sourceMappingURL=workspace-context.js.map

package/docs/examples/codegraph.mcp.json

@@ -1,10 +0,0 @@
-{
-  "servers": {
-    "codegraph": {
-      "command": "codegraph",
-      "args": ["serve", "--mcp"],
-      "env": {},
-      "trust": "pending"
-    }
-  }
-}

package/test/scenarios/codegen-create-file.scenario.txt

@@ -1,13 +0,0 @@
-# scenario: codegen-create-file
-# title: Pugi actually writes a file (not just describes it)
-
-# Anti-regression for task #265 — Pugi must call Write, not describe what
-# it would write. The headless stub responder parses
-# "create FILE with content 'TEXT'" and runs the real fs write so the
-# scenario validates the wiring end-to-end. When Phase 2 lands the live
-# engine path the same scenario carries over verbatim.
-
-> "create hello.txt with content 'hello world'"
-EXPECT: tool-call kind=Write file=hello.txt
-EXPECT: persona-turn contains "wrote hello.txt"
-EXPECT_FILE: hello.txt exists with content "hello world"

package/test/scenarios/compact-force.scenario.txt

@@ -1,12 +0,0 @@
-# scenario: compact-force
-# title: /compact --force is acknowledged
-
-# Phase 1: the stub responder echoes the directive verbatim — Phase 2
-# wires the slash command through to the live compaction loop. Until
-# then this scenario protects the contract between scenario authoring
-# and the harness envelope shape. The scenario covers envelope routing,
-# not anti-name-chant, so the persona is free to identify itself on the
-# initial turn.
-
-> "/compact --force"
-EXPECT: persona-turn contains "/compact"

package/test/scenarios/identity.scenario.txt

@@ -1,11 +0,0 @@
-# scenario: identity
-# title: Pugi self-identifies on the very first turn
-
-# CEO directive feedback_live_console_test_every_publish: every published
-# beta must still answer "ты кто?" with the Pugi persona on turn 1. This
-# is the single most-asked dialog in CEO dogfood and the regression that
-# has bitten us most often. The intro fires once per session, so the
-# initial envelope is expected to include the brand name verbatim.
-
-> "ты кто?"
-EXPECT: persona-turn contains "Pugi" OR "Пуджи"

package/test/scenarios/persona-handoff.scenario.txt

@@ -1,12 +0,0 @@
-# scenario: persona-handoff
-# title: Pugi hands off to Hiroshi when the operator asks for dev work
-
-# Phase 1: the headless stub currently echoes input via the Pugi persona
-# (real dispatch routing wires in Phase 2). The scenario is authored
-# against the Phase 2 contract — for now it documents the intent and
-# the harness keeps it as a soft EXPECT so the corpus stays loadable.
-# The positive EXPECT already covers the brand name on turn 1, so no
-# anti-name-chant assertion is needed here.
-
-> "Hiroshi, please review the authentication module"
-EXPECT: persona-turn contains "Pugi" OR "Hiroshi" OR "Хироси"

package/test/scenarios/walkback.scenario.txt

@@ -1,12 +0,0 @@
-# scenario: walkback
-# title: Esc-Esc walkback / rewind directive recognized
-
-# CEO parity ask: the operator must be able to walk back the last turn.
-# Phase 1 ships the harness contract — the live walkback wiring lands
-# later. The scenario asserts the stub responder acknowledges the
-# directive verbatim so the contract holds while the real implementation
-# lands behind it. Envelope-shape only, not anti-name-chant — the persona
-# is free to identify itself on the initial turn.
-
-> "/rewind 1"
-EXPECT: persona-turn contains "/rewind"