@opellen/scaff 0.1.14 → 0.1.15

package/dist/platforms/pi.d.ts

@@ -1,2 +0,0 @@
-import type { PlatformAdapter } from "./types.js";
-export declare const pi: PlatformAdapter;

package/dist/platforms/pi.js

@@ -1,12 +0,0 @@
-import { stripFrontmatter, yamlFrontmatter } from "./yaml.js";
-export const pi = {
-    id: "pi",
-    displayName: "Pi",
-    configDir: ".pi",
-    commandPath: (name) => `.pi/prompts/scaff-${name}.md`,
-    formatCommand: (body, meta) => {
-        const stripped = stripFrontmatter(body);
-        const fm = yamlFrontmatter({ description: meta.description });
-        return fm + stripped;
-    },
-};

package/dist/platforms/qoder.d.ts

@@ -1,2 +0,0 @@
-import type { PlatformAdapter } from "./types.js";
-export declare const qoder: PlatformAdapter;

package/dist/platforms/qoder.js

@@ -1,19 +0,0 @@
-import { stripFrontmatter, yamlFrontmatter, } from "./yaml.js";
-export const qoder = {
-    id: "qoder",
-    displayName: "Qoder",
-    configDir: ".qoder",
-    commandPath: (name) => `.qoder/commands/scaff/${name}.md`,
-    formatCommand: (body, meta) => {
-        const stripped = stripFrontmatter(body);
-        const fields = {
-            name: `scaff:${meta.name}`,
-            description: meta.description,
-        };
-        if (meta.category)
-            fields.category = meta.category;
-        if (meta.tags && meta.tags.length > 0)
-            fields.tags = meta.tags;
-        return yamlFrontmatter(fields) + stripped;
-    },
-};

package/dist/platforms/qwen.d.ts

@@ -1,2 +0,0 @@
-import type { PlatformAdapter } from "./types.js";
-export declare const qwen: PlatformAdapter;

package/dist/platforms/qwen.js

@@ -1,14 +0,0 @@
-import { stripFrontmatter } from "./yaml.js";
-import { escapeTomlString, escapeTomlMultiline } from "./toml.js";
-export const qwen = {
-    id: "qwen",
-    displayName: "Qwen Code",
-    configDir: ".qwen",
-    commandPath: (name) => `.qwen/commands/scaff-${name}.toml`,
-    formatCommand: (body, meta) => {
-        const stripped = stripFrontmatter(body);
-        const description = escapeTomlString(meta.description);
-        const prompt = escapeTomlMultiline(stripped.trimEnd());
-        return `description = "${description}"\n\nprompt = """\n${prompt}\n"""\n`;
-    },
-};

package/dist/platforms/roocode.d.ts

@@ -1,2 +0,0 @@
-import type { PlatformAdapter } from "./types.js";
-export declare const roocode: PlatformAdapter;

package/dist/platforms/roocode.js

@@ -1,11 +0,0 @@
-import { stripFrontmatter } from "./yaml.js";
-export const roocode = {
-    id: "roocode",
-    displayName: "RooCode",
-    configDir: ".roo",
-    commandPath: (name) => `.roo/commands/scaff-${name}.md`,
-    formatCommand: (body, meta) => {
-        const stripped = stripFrontmatter(body);
-        return `# scaff-${meta.name}\n\n${meta.description}\n\n${stripped}`;
-    },
-};

package/dist/platforms/toml.d.ts

@@ -1,9 +0,0 @@
-/**
- * Escapes a TOML basic string (double-quoted).
- */
-export declare function escapeTomlString(value: string): string;
-/**
- * Escapes a TOML multi-line basic string (triple-quoted).
- * Only the sequence `"""` needs escaping inside the body.
- */
-export declare function escapeTomlMultiline(value: string): string;

package/dist/platforms/toml.js

@@ -1,18 +0,0 @@
-/**
- * Escapes a TOML basic string (double-quoted).
- */
-export function escapeTomlString(value) {
-    return value
-        .replace(/\\/g, "\\\\")
-        .replace(/"/g, '\\"')
-        .replace(/\n/g, "\\n")
-        .replace(/\r/g, "\\r")
-        .replace(/\t/g, "\\t");
-}
-/**
- * Escapes a TOML multi-line basic string (triple-quoted).
- * Only the sequence `"""` needs escaping inside the body.
- */
-export function escapeTomlMultiline(value) {
-    return value.replace(/"""/g, '\\"\\"\\"');
-}

package/dist/platforms/trae.d.ts

@@ -1,2 +0,0 @@
-import type { PlatformAdapter } from "./types.js";
-export declare const trae: PlatformAdapter;

package/dist/platforms/trae.js

@@ -1,11 +0,0 @@
-export const trae = {
-    id: "trae",
-    displayName: "Trae",
-    configDir: ".trae",
-    supportsCommands: false,
-    // Trae is skills-only; commandPath/formatCommand are never invoked by the
-    // installer because supportsCommands=false. They exist to satisfy the
-    // interface contract.
-    commandPath: (name) => `.trae/commands/scaff-${name}.md`,
-    formatCommand: (body) => body,
-};

package/dist/platforms/types.d.ts

@@ -1,19 +0,0 @@
-export interface CommandMeta {
-    name: string;
-    description: string;
-    category?: string;
-    tags?: string[];
-}
-export interface PlatformAdapter {
-    id: string;
-    displayName: string;
-    configDir: string;
-    /**
-     * Whether this platform supports slash commands. When false, only skills
-     * are installed (e.g. Trae). Defaults to true.
-     */
-    supportsCommands?: boolean;
-    commandPath(name: string): string;
-    formatCommand(body: string, meta: CommandMeta): string;
-}
-export declare const DEFAULT_PLATFORM = "claude";

package/dist/platforms/types.js

@@ -1 +0,0 @@
-export const DEFAULT_PLATFORM = "claude";

package/dist/platforms/windsurf.d.ts

@@ -1,2 +0,0 @@
-import type { PlatformAdapter } from "./types.js";
-export declare const windsurf: PlatformAdapter;

package/dist/platforms/windsurf.js

@@ -1,19 +0,0 @@
-import { stripFrontmatter, yamlFrontmatter, } from "./yaml.js";
-export const windsurf = {
-    id: "windsurf",
-    displayName: "Windsurf",
-    configDir: ".windsurf",
-    commandPath: (name) => `.windsurf/workflows/scaff-${name}.md`,
-    formatCommand: (body, meta) => {
-        const stripped = stripFrontmatter(body);
-        const fields = {
-            name: `scaff:${meta.name}`,
-            description: meta.description,
-        };
-        if (meta.category)
-            fields.category = meta.category;
-        if (meta.tags && meta.tags.length > 0)
-            fields.tags = meta.tags;
-        return yamlFrontmatter(fields) + stripped;
-    },
-};

package/dist/platforms/yaml.d.ts

@@ -1,10 +0,0 @@
-export declare function stripFrontmatter(content: string): string;
-/**
- * Escapes a string value for safe YAML output.
- * Returns a plain scalar when possible; double-quotes only when the value
- * contains special YAML characters or looks ambiguous.
- */
-export declare function escapeYamlValue(value: string): string;
-export declare function formatYamlArray(items: string[]): string;
-export type YamlFieldValue = string | string[];
-export declare function yamlFrontmatter(fields: Record<string, YamlFieldValue>): string;

package/dist/platforms/yaml.js

@@ -1,30 +0,0 @@
-export function stripFrontmatter(content) {
-    const match = content.match(/^---\n[\s\S]*?\n---\n/);
-    return match ? content.slice(match[0].length) : content;
-}
-/**
- * Escapes a string value for safe YAML output.
- * Returns a plain scalar when possible; double-quotes only when the value
- * contains special YAML characters or looks ambiguous.
- */
-export function escapeYamlValue(value) {
-    const needsQuoting = /[:\n\r#{}[\],&*!|>'"%@`]|^\s|\s$/.test(value);
-    if (needsQuoting) {
-        const escaped = value
-            .replace(/\\/g, "\\\\")
-            .replace(/"/g, '\\"')
-            .replace(/\n/g, "\\n");
-        return `"${escaped}"`;
-    }
-    return value;
-}
-export function formatYamlArray(items) {
-    return `[${items.map(escapeYamlValue).join(", ")}]`;
-}
-export function yamlFrontmatter(fields) {
-    const lines = Object.entries(fields).map(([k, v]) => {
-        const rendered = Array.isArray(v) ? formatYamlArray(v) : escapeYamlValue(v);
-        return `${k}: ${rendered}`;
-    });
-    return `---\n${lines.join("\n")}\n---\n`;
-}

package/dist/prompts/platform-select.d.ts

@@ -1 +0,0 @@
-export declare function selectPlatforms(projectRoot: string): Promise<string[]>;

package/dist/prompts/platform-select.js

@@ -1,174 +0,0 @@
-import { createPrompt, useState, useKeypress, useMemo, useRef, usePagination, isUpKey, isDownKey, isSpaceKey, isBackspaceKey, isEnterKey, } from "@inquirer/core";
-import chalk from "chalk";
-import { getAllAdapters, detectInstalledPlatforms, DEFAULT_PLATFORM } from "../platforms/index.js";
-import { t } from "../i18n/index.js";
-import { brand } from "../ui/colors.js";
-const PAGE_SIZE = 15;
-function buildChoices(projectRoot) {
-    const detected = new Set(detectInstalledPlatforms(projectRoot));
-    const adapters = getAllAdapters();
-    const choices = adapters.map((a) => ({
-        id: a.id,
-        displayName: a.displayName,
-        detected: detected.has(a.id),
-    }));
-    choices.sort((a, b) => {
-        if (a.detected !== b.detected)
-            return a.detected ? -1 : 1;
-        return a.displayName.localeCompare(b.displayName);
-    });
-    return choices;
-}
-const platformSelect = createPrompt((config, done) => {
-    const { projectRoot } = config;
-    const allChoices = useRef(null);
-    if (allChoices.current === null) {
-        allChoices.current = buildChoices(projectRoot);
-    }
-    const initialSelected = useRef(null);
-    if (initialSelected.current === null) {
-        const s = new Set();
-        s.add(DEFAULT_PLATFORM);
-        for (const c of allChoices.current) {
-            if (c.detected)
-                s.add(c.id);
-        }
-        initialSelected.current = s;
-    }
-    const [selected, setSelected] = useState(() => new Set(initialSelected.current));
-    const [search, setSearch] = useState("");
-    const [cursorIndex, setCursorIndex] = useState(0);
-    const [submitted, setSubmitted] = useState(false);
-    const [errorMsg, setErrorMsg] = useState("");
-    const visibleChoices = useMemo(() => {
-        if (!search)
-            return allChoices.current;
-        const lower = search.toLowerCase();
-        return allChoices.current.filter((c) => c.displayName.toLowerCase().includes(lower));
-    }, [search]);
-    const clampedCursor = useMemo(() => {
-        if (visibleChoices.length === 0)
-            return 0;
-        return Math.min(cursorIndex, visibleChoices.length - 1);
-    }, [cursorIndex, visibleChoices.length]);
-    useKeypress((event, rl) => {
-        if (event.ctrl && event.name === "c") {
-            process.exit(0);
-        }
-        if (submitted)
-            return;
-        if (isEnterKey(event)) {
-            if (selected.size === 0) {
-                setErrorMsg(t("select.error.empty"));
-                return;
-            }
-            setSubmitted(true);
-            done([...selected]);
-            return;
-        }
-        if (isUpKey(event)) {
-            if (clampedCursor > 0) {
-                setCursorIndex(clampedCursor - 1);
-            }
-            return;
-        }
-        if (isDownKey(event)) {
-            if (clampedCursor < visibleChoices.length - 1) {
-                setCursorIndex(clampedCursor + 1);
-            }
-            return;
-        }
-        if (isSpaceKey(event)) {
-            if (visibleChoices.length === 0)
-                return;
-            const choice = visibleChoices[clampedCursor];
-            if (!choice)
-                return;
-            const next = new Set(selected);
-            if (next.has(choice.id)) {
-                next.delete(choice.id);
-            }
-            else {
-                next.add(choice.id);
-            }
-            setSelected(next);
-            setErrorMsg("");
-            return;
-        }
-        if (isBackspaceKey(event)) {
-            if (search.length > 0) {
-                setSearch(search.slice(0, -1));
-                setCursorIndex(0);
-            }
-            else {
-                if (selected.size > 0) {
-                    const arr = [...selected];
-                    const last = arr[arr.length - 1];
-                    const next = new Set(selected);
-                    next.delete(last);
-                    setSelected(next);
-                }
-            }
-            return;
-        }
-        if (event.name && event.name.length === 1 && !event.ctrl) {
-            setSearch(search + event.name);
-            setCursorIndex(0);
-            setErrorMsg("");
-        }
-    });
-    if (submitted) {
-        const names = allChoices.current
-            .filter((c) => selected.has(c.id))
-            .map((c) => brand(c.displayName))
-            .join(", ");
-        return `${chalk.green("✔")} ${config.message} ${names}`;
-    }
-    const pills = allChoices.current
-        .filter((c) => selected.has(c.id))
-        .map((c) => brand(`[${c.displayName}]`))
-        .join("  ");
-    const searchDisplay = search
-        ? chalk.yellow(search)
-        : chalk.dim(t("select.typeToFilter"));
-    const page = usePagination({
-        items: visibleChoices,
-        active: clampedCursor,
-        pageSize: PAGE_SIZE,
-        loop: false,
-        renderItem({ item, isActive }) {
-            const isSelected = selected.has(item.id);
-            const icon = isSelected ? brand("●") : "○";
-            const arrow = isActive ? brand("›") : " ";
-            const label = isActive ? brand(item.displayName) : item.displayName;
-            const suffix = item.detected
-                ? chalk.dim(` (${t("select.detected")})`)
-                : isSelected
-                    ? chalk.dim(` (${t("select.selected")})`)
-                    : "";
-            return `  ${arrow} ${icon} ${label}${suffix}`;
-        },
-    });
-    const totalPages = Math.ceil(visibleChoices.length / PAGE_SIZE);
-    const currentPage = totalPages > 0
-        ? Math.floor(clampedCursor / PAGE_SIZE) + 1
-        : 0;
-    const pageIndicator = totalPages > 1
-        ? chalk.dim(`  (${currentPage}/${totalPages})`)
-        : "";
-    const error = errorMsg ? `\n${chalk.red(errorMsg)}` : "";
-    const header = `${brand.bold("?")} ${config.message} (${allChoices.current.length} ${t("select.available")})`;
-    const selectedLine = `  ${t("select.selectedLabel")} ${pills || chalk.dim(t("select.none"))}`;
-    const searchLine = `  ${t("select.searchLabel")} [${searchDisplay}]`;
-    const hint = chalk.dim(`  ${t("select.hint")}`);
-    return [
-        `${header}\n${selectedLine}\n${searchLine}\n${hint}\n${page}${pageIndicator}${error}`,
-        undefined,
-    ];
-});
-export async function selectPlatforms(projectRoot) {
-    return platformSelect({
-        message: t("select.message"),
-        projectRoot,
-    });
-}

package/dist/skills/generate.d.ts

@@ -1,13 +0,0 @@
-import type { PlatformAdapter } from "../platforms/index.js";
-/**
- * Skill installation path per platform.
- * Skill content is universal (single format across all platforms);
- * platforms differ only in where the SKILL.md file is placed.
- */
-export declare function skillInstallPath(adapter: PlatformAdapter, skillName: string): string;
-/**
- * Produces the final skill file content.
- * Currently a passthrough — reserved for future enrichment
- * (license, compatibility, metadata.author/version/generatedBy).
- */
-export declare function formatSkill(body: string): string;

package/dist/skills/generate.js

@@ -1,16 +0,0 @@
-/**
- * Skill installation path per platform.
- * Skill content is universal (single format across all platforms);
- * platforms differ only in where the SKILL.md file is placed.
- */
-export function skillInstallPath(adapter, skillName) {
-    return `${adapter.configDir}/skills/${skillName}/SKILL.md`;
-}
-/**
- * Produces the final skill file content.
- * Currently a passthrough — reserved for future enrichment
- * (license, compatibility, metadata.author/version/generatedBy).
- */
-export function formatSkill(body) {
-    return body;
-}

package/dist/templates.d.ts

@@ -1,18 +0,0 @@
-import { type PlatformAdapter, type CommandMeta } from "./platforms/index.js";
-export interface ScaffConfig {
-    tools: string[];
-    subagent: boolean;
-    root: string;
-    docsDir: string;
-    codebaseDir: string;
-    force?: boolean;
-}
-export interface TemplateEntry {
-    src: string;
-    dst: string;
-    adapter: PlatformAdapter;
-    meta: CommandMeta;
-    rawContent: string;
-}
-export declare function resolveTemplates(config: ScaffConfig): TemplateEntry[];
-export declare function renderFile(entry: TemplateEntry, config: ScaffConfig): string;

package/dist/templates.js

@@ -1,96 +0,0 @@
-import { readFileSync } from "node:fs";
-import { join, dirname } from "node:path";
-import { fileURLToPath } from "node:url";
-import { renderTemplate } from "./marker.js";
-import { getAdapters } from "./platforms/index.js";
-import { skillInstallPath, formatSkill } from "./skills/generate.js";
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const TEMPLATE_DIR = join(__dirname, "..", "templates");
-// Installed CLI version — injected into skill metadata.generatedBy.
-// Read once at module load from the shipped package.json.
-const SCAFF_VERSION = (() => {
-    try {
-        const pkg = JSON.parse(readFileSync(join(__dirname, "..", "package.json"), "utf-8"));
-        return String(pkg.version ?? "0.0.0");
-    }
-    catch {
-        return "0.0.0";
-    }
-})();
-const COMMAND_TEMPLATES = [
-    "scout", "goal", "context", "design",
-    "roadmap", "verify", "recap", "overview", "go",
-];
-const SKILL_TEMPLATES = [
-    { src: "skills/scaff-subagent/SKILL.md", skillName: "scaff-subagent" },
-    { src: "skills/scaff-flow/SKILL.md", skillName: "scaff-flow" },
-];
-function parseMeta(content) {
-    const normalized = content.replace(/\r\n/g, "\n");
-    const fmMatch = normalized.match(/^---\n([\s\S]*?)\n---/);
-    if (!fmMatch)
-        return { name: "", description: "" };
-    const fm = fmMatch[1];
-    const nameMatch = fm.match(/name:\s*"?scaff:(\w+)"?/);
-    const descMatch = fm.match(/description:\s*"([^"]+)"/);
-    const categoryMatch = fm.match(/category:\s*(\S+)/);
-    const tagsMatch = fm.match(/tags:\s*\[([^\]]*)\]/);
-    const tags = tagsMatch
-        ? tagsMatch[1]
-            .split(",")
-            .map((s) => s.trim().replace(/^["']|["']$/g, ""))
-            .filter(Boolean)
-        : undefined;
-    return {
-        name: nameMatch?.[1] ?? "",
-        description: descMatch?.[1] ?? "",
-        category: categoryMatch?.[1],
-        tags,
-    };
-}
-export function resolveTemplates(config) {
-    const adapters = getAdapters(config.tools);
-    const entries = [];
-    const commandMetas = COMMAND_TEMPLATES.map((cmd) => {
-        const src = `commands/${cmd}.md`;
-        const rawContent = readFileSync(join(TEMPLATE_DIR, src), "utf-8");
-        return { cmd, src, rawContent, meta: parseMeta(rawContent) };
-    });
-    const skillContents = SKILL_TEMPLATES.map((skill) => ({
-        ...skill,
-        rawContent: readFileSync(join(TEMPLATE_DIR, skill.src), "utf-8"),
-    }));
-    for (const adapter of adapters) {
-        if (adapter.supportsCommands !== false) {
-            for (const { cmd, src, rawContent, meta } of commandMetas) {
-                entries.push({ src, dst: adapter.commandPath(cmd), adapter, meta, rawContent });
-            }
-        }
-        for (const skill of skillContents) {
-            entries.push({
-                src: skill.src,
-                dst: skillInstallPath(adapter, skill.skillName),
-                adapter,
-                meta: { name: skill.skillName, description: "" },
-                rawContent: skill.rawContent,
-            });
-        }
-    }
-    return entries;
-}
-export function renderFile(entry, config) {
-    const content = entry.rawContent.replace(/\r\n/g, "\n");
-    const rendered = renderTemplate(content, {
-        conditions: {
-            subagent: config.subagent,
-        },
-    });
-    const substituted = rendered
-        .replace(/\$DocsDir/g, config.docsDir)
-        .replace(/\$CodebaseDir/g, config.codebaseDir)
-        .replace(/\$ScaffVersion/g, SCAFF_VERSION);
-    if (entry.src.startsWith("skills/")) {
-        return formatSkill(substituted);
-    }
-    return entry.adapter.formatCommand(substituted, entry.meta);
-}

package/dist/ui/ascii-logo.d.ts

@@ -1,6 +0,0 @@
-export declare const SCAFF_LOGO: {
-    readonly frame: readonly ["  ████        ████  ", "  █              █  ", "█████          █████", "  █              █  ", "  █              █  ", "  █              █  ", "  █              █  ", "  █              █  ", "█████          █████", "  █              █  ", "  ████        ████  "];
-    readonly inner: readonly ["                    ", "                    ", "     ██      ████   ", "      ▒█    █▒      ", "       ▒█  █▒       ", "        ▒██▒        ", "       ▒█  █▒       ", "      ▒█    █▒      ", "   ████      ██     ", "                    ", "                    "];
-};
-export declare const SCAFF_LOGO_WIDTH: number;
-export declare const SCAFF_LOGO_HEIGHT: 11;

package/dist/ui/ascii-logo.js

@@ -1,38 +0,0 @@
-// Two-layer logo. Layers are overlaid at render time: any non-space char in
-// `inner` wins over `frame`. This lets the same block char (█, ▒, ...) carry
-// a different color depending on which layer it belongs to, without a parallel
-// mask array to keep in sync.
-//
-// Palette: █ (full), ▓ (dark), ▒ (medium), ░ (light) — shade blocks give a
-// pseudo-anti-aliased gradient on diagonal edges that renders uniformly across
-// monospace fonts, unlike slash/diagonal glyphs (╲ ╱ ╳) which frequently break.
-export const SCAFF_LOGO = {
-    frame: [
-        "  ████        ████  ",
-        "  █              █  ",
-        "█████          █████",
-        "  █              █  ",
-        "  █              █  ",
-        "  █              █  ",
-        "  █              █  ",
-        "  █              █  ",
-        "█████          █████",
-        "  █              █  ",
-        "  ████        ████  ",
-    ],
-    inner: [
-        "                    ",
-        "                    ",
-        "     ██      ████   ",
-        "      ▒█    █▒      ",
-        "       ▒█  █▒       ",
-        "        ▒██▒        ",
-        "       ▒█  █▒       ",
-        "      ▒█    █▒      ",
-        "   ████      ██     ",
-        "                    ",
-        "                    ",
-    ],
-};
-export const SCAFF_LOGO_WIDTH = SCAFF_LOGO.frame[0].length;
-export const SCAFF_LOGO_HEIGHT = SCAFF_LOGO.frame.length;

package/dist/ui/colors.d.ts

@@ -1,2 +0,0 @@
-export declare const brand: import("chalk").ChalkInstance;
-export declare const brandInner: import("chalk").ChalkInstance;

package/dist/ui/colors.js

@@ -1,3 +0,0 @@
-import chalk from "chalk";
-export const brand = chalk.hex("#A8948B");
-export const brandInner = chalk.hex("#3C4C5C");

package/dist/ui/welcome.d.ts

@@ -1 +0,0 @@
-export declare function showWelcome(): Promise<void>;