sequant 1.12.0 → 1.13.1

package/dist/src/commands/sync.js

@@ -0,0 +1,102 @@
+/**
+ * sequant sync - Fast, non-interactive template sync
+ *
+ * Syncs skills and other templates from the package to the local project.
+ * Designed for plugin users who need to update after upgrading sequant.
+ */
+import chalk from "chalk";
+import { getManifest, updateManifest, getPackageVersion, } from "../lib/manifest.js";
+import { copyTemplates } from "../lib/templates.js";
+import { getConfig } from "../lib/config.js";
+import { writeFile, readFile, fileExists } from "../lib/fs.js";
+const SKILLS_VERSION_PATH = ".claude/skills/.sequant-version";
+/**
+ * Get the version of skills currently installed
+ */
+export async function getSkillsVersion() {
+    if (!(await fileExists(SKILLS_VERSION_PATH))) {
+        return null;
+    }
+    try {
+        const content = await readFile(SKILLS_VERSION_PATH);
+        return content.trim();
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Check if skills are outdated compared to package version
+ */
+export async function areSkillsOutdated() {
+    const currentVersion = await getSkillsVersion();
+    const packageVersion = getPackageVersion();
+    return {
+        outdated: currentVersion !== packageVersion,
+        currentVersion,
+        packageVersion,
+    };
+}
+/**
+ * Update the skills version marker
+ */
+async function updateSkillsVersion() {
+    await writeFile(SKILLS_VERSION_PATH, getPackageVersion());
+}
+export async function syncCommand(options = {}) {
+    const { force = false, quiet = false } = options;
+    if (!quiet) {
+        console.log(chalk.blue("\n🔄 Syncing templates...\n"));
+    }
+    // Check if initialized
+    const manifest = await getManifest();
+    if (!manifest) {
+        console.log(chalk.red("❌ Sequant is not initialized. Run `sequant init` first."));
+        process.exitCode = 1;
+        return;
+    }
+    const packageVersion = getPackageVersion();
+    const skillsVersion = await getSkillsVersion();
+    if (!quiet) {
+        console.log(chalk.gray(`Skills version: ${skillsVersion || "(unknown)"}`));
+        console.log(chalk.gray(`Package version: ${packageVersion}`));
+        console.log(chalk.gray(`Stack: ${manifest.stack}\n`));
+    }
+    // Check if sync is needed
+    if (!force && skillsVersion === packageVersion) {
+        if (!quiet) {
+            console.log(chalk.green("✅ Skills are already up to date!"));
+        }
+        return;
+    }
+    // Get config tokens for template processing
+    const config = await getConfig();
+    const tokens = config?.tokens || {};
+    // Copy templates with force to overwrite existing files
+    const copyOptions = {
+        force: true, // Always overwrite when syncing
+    };
+    if (!quiet) {
+        console.log(chalk.blue("📥 Copying templates..."));
+    }
+    await copyTemplates(manifest.stack, tokens, copyOptions);
+    // Update version markers
+    await updateSkillsVersion();
+    await updateManifest();
+    if (!quiet) {
+        console.log(chalk.green(`\n✅ Synced to v${packageVersion}`));
+        console.log(chalk.gray("\nSkills, hooks, and memory files have been updated."));
+    }
+}
+/**
+ * Check and warn if skills are outdated (for use by other commands)
+ */
+export async function checkAndWarnSkillsOutdated() {
+    const { outdated, currentVersion, packageVersion } = await areSkillsOutdated();
+    if (outdated) {
+        console.log(chalk.yellow(`\n⚠️  Skills are outdated (${currentVersion || "unknown"} → ${packageVersion})`));
+        console.log(chalk.yellow("   Run: npx sequant sync\n"));
+        return true;
+    }
+    return false;
+}

package/dist/src/index.d.ts

@@ -23,3 +23,9 @@ export { createStateHook, isOrchestrated, getOrchestrationContext, } from "./lib
 export type { StateHook, StateHookOptions } from "./lib/workflow/state-hook.js";
 export { rebuildStateFromLogs, cleanupStaleEntries, } from "./lib/workflow/state-utils.js";
 export type { RebuildOptions, RebuildResult, CleanupOptions, CleanupResult, } from "./lib/workflow/state-utils.js";
+export { analyzeTitleForPhases, analyzeBodyForPhases, analyzeContentForPhases, isTrivialWork, formatContentAnalysis, } from "./lib/content-analyzer.js";
+export type { ContentSignal, ContentAnalysisResult, } from "./lib/content-analyzer.js";
+export { mergePhaseSignals, signalFromLabel, signalsFromLabels, formatMergedPhases, SIGNAL_PRIORITY, } from "./lib/phase-signal.js";
+export type { SignalSource, SignalConfidence, PhaseSignal, MergedPhaseResult, } from "./lib/phase-signal.js";
+export { isSolveComment, findSolveComment, parseSolveWorkflow, solveWorkflowToSignals, solveCoversIssue, } from "./lib/solve-comment-parser.js";
+export type { SolveWorkflowResult, IssueComment, } from "./lib/solve-comment-parser.js";

package/dist/src/index.js

@@ -16,3 +16,7 @@ export { StateManager, getStateManager } from "./lib/workflow/state-manager.js";
 export { createEmptyState, createIssueState, createPhaseState, STATE_FILE_PATH, WORKFLOW_PHASES, } from "./lib/workflow/state-schema.js";
 export { createStateHook, isOrchestrated, getOrchestrationContext, } from "./lib/workflow/state-hook.js";
 export { rebuildStateFromLogs, cleanupStaleEntries, } from "./lib/workflow/state-utils.js";
+// Content analysis exports
+export { analyzeTitleForPhases, analyzeBodyForPhases, analyzeContentForPhases, isTrivialWork, formatContentAnalysis, } from "./lib/content-analyzer.js";
+export { mergePhaseSignals, signalFromLabel, signalsFromLabels, formatMergedPhases, SIGNAL_PRIORITY, } from "./lib/phase-signal.js";
+export { isSolveComment, findSolveComment, parseSolveWorkflow, solveWorkflowToSignals, solveCoversIssue, } from "./lib/solve-comment-parser.js";

package/dist/src/lib/cli-ui.d.ts

@@ -0,0 +1,196 @@
+/**
+ * Centralized CLI UI module for Sequant
+ *
+ * Provides consistent styling, spinners, boxes, tables, and branding
+ * with graceful fallbacks for non-TTY, CI, and legacy terminals.
+ */
+/**
+ * UI configuration options
+ */
+export interface UIConfig {
+    /** Disable all colors and styling */
+    noColor: boolean;
+    /** JSON output mode - suppress decorative output */
+    jsonMode: boolean;
+    /** Verbose mode - use text-only spinners to avoid overwriting output */
+    verbose: boolean;
+    /** Whether stdout is a TTY */
+    isTTY: boolean;
+    /** Running in CI environment */
+    isCI: boolean;
+    /** Minimal output mode */
+    minimal: boolean;
+}
+/**
+ * Configure UI settings
+ *
+ * Call this early in CLI startup to set global options.
+ */
+export declare function configureUI(options: Partial<UIConfig>): void;
+/**
+ * Get current UI configuration
+ */
+export declare function getUIConfig(): Readonly<UIConfig>;
+/**
+ * Standardized color palette for consistent styling
+ */
+export declare const colors: {
+    success: ((s: string) => string) | import("chalk").ChalkInstance;
+    error: import("chalk").ChalkInstance | ((s: string) => string);
+    warning: import("chalk").ChalkInstance | ((s: string) => string);
+    info: import("chalk").ChalkInstance | ((s: string) => string);
+    muted: import("chalk").ChalkInstance | ((s: string) => string);
+    header: import("chalk").ChalkInstance | ((s: string) => string);
+    label: import("chalk").ChalkInstance | ((s: string) => string);
+    value: import("chalk").ChalkInstance | ((s: string) => string);
+    accent: import("chalk").ChalkInstance | ((s: string) => string);
+    bold: import("chalk").ChalkInstance | ((s: string) => string);
+    pending: import("chalk").ChalkInstance | ((s: string) => string);
+    running: import("chalk").ChalkInstance | ((s: string) => string);
+    completed: import("chalk").ChalkInstance | ((s: string) => string);
+    failed: import("chalk").ChalkInstance | ((s: string) => string);
+};
+/**
+ * Get the ASCII logo with optional gradient
+ */
+export declare function logo(): string;
+/**
+ * Get the banner (logo + tagline)
+ */
+export declare function banner(): string;
+/**
+ * Spinner manager interface
+ */
+export interface SpinnerManager {
+    /** Start the spinner with optional new text */
+    start(text?: string): SpinnerManager;
+    /** Mark as succeeded with optional message */
+    succeed(text?: string): SpinnerManager;
+    /** Mark as failed with optional message */
+    fail(text?: string): SpinnerManager;
+    /** Mark as warning with optional message */
+    warn(text?: string): SpinnerManager;
+    /** Stop the spinner */
+    stop(): SpinnerManager;
+    /** Update the spinner text */
+    text: string;
+    /** Check if spinner is active */
+    isSpinning: boolean;
+}
+/**
+ * Create a spinner with automatic fallback
+ *
+ * Returns an animated spinner for TTY, text-only for non-TTY/verbose/CI.
+ */
+export declare function spinner(text: string): SpinnerManager;
+/**
+ * Box style presets
+ */
+export type BoxStyle = "success" | "error" | "warning" | "info" | "header" | "default";
+/**
+ * Create a boxed message
+ */
+export declare function box(content: string, style?: BoxStyle): string;
+/**
+ * Create a success box with title and message
+ */
+export declare function successBox(title: string, message: string): string;
+/**
+ * Create an error box with title and message
+ */
+export declare function errorBox(title: string, message: string): string;
+/**
+ * Create a warning box with title and message
+ */
+export declare function warningBox(title: string, message: string): string;
+/**
+ * Create a header box
+ */
+export declare function headerBox(title: string): string;
+/**
+ * Table column definition
+ */
+export interface TableColumn {
+    /** Column header text */
+    header: string;
+    /** Column width (optional) */
+    width?: number;
+    /** Text alignment */
+    align?: "left" | "center" | "right";
+}
+/**
+ * Table options
+ */
+export interface TableOptions {
+    /** Column definitions */
+    columns: TableColumn[];
+    /** Table style */
+    style?: "default" | "compact" | "borderless";
+}
+/**
+ * Create a formatted table
+ */
+export declare function table(rows: (string | number)[][], options: TableOptions): string;
+/**
+ * Create a simple key-value table
+ */
+export declare function keyValueTable(data: Record<string, string | number>): string;
+/**
+ * Status indicator types
+ */
+export type StatusType = "success" | "error" | "warning" | "pending" | "running";
+/**
+ * Get a status icon
+ */
+export declare function statusIcon(type: StatusType): string;
+/**
+ * Print a status message with icon
+ */
+export declare function printStatus(type: StatusType, message: string): void;
+/**
+ * Create a horizontal divider
+ */
+export declare function divider(width?: number): string;
+/**
+ * Create a section header
+ */
+export declare function sectionHeader(title: string): string;
+/**
+ * Phase status for progress display
+ */
+export interface PhaseStatus {
+    name: string;
+    status: "pending" | "running" | "success" | "failure" | "skipped";
+}
+/**
+ * Display phase progress as a visual indicator
+ */
+export declare function phaseProgress(phases: PhaseStatus[]): string;
+/**
+ * Create a progress bar
+ */
+export declare function progressBar(current: number, total: number, width?: number): string;
+/**
+ * Unified UI object for convenient access to all utilities
+ */
+export declare const ui: {
+    configure: typeof configureUI;
+    getConfig: typeof getUIConfig;
+    logo: typeof logo;
+    banner: typeof banner;
+    spinner: typeof spinner;
+    box: typeof box;
+    successBox: typeof successBox;
+    errorBox: typeof errorBox;
+    warningBox: typeof warningBox;
+    headerBox: typeof headerBox;
+    table: typeof table;
+    keyValueTable: typeof keyValueTable;
+    statusIcon: typeof statusIcon;
+    printStatus: typeof printStatus;
+    divider: typeof divider;
+    sectionHeader: typeof sectionHeader;
+    phaseProgress: typeof phaseProgress;
+    progressBar: typeof progressBar;
+};
+export default ui;