@nick848/fet 0.1.0 → 1.0.0

package/dist/opencode-skills.js

@@ -1,236 +0,0 @@
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import { join } from "node:path";
-import JSON5 from "json5";
-import { writeFileAtomicSync } from "./atomic-write.js";
-import { promptSkillConflict } from "./prompt.js";
-const OPENCODE_SKILLS = [
-    {
-        id: "fet-explore",
-        description: "FET: run fet explore (openspec proxy)",
-        body: "Run in terminal: `fet explore`",
-    },
-    {
-        id: "fet-propose",
-        description: "FET: run fet propose (openspec proxy)",
-        body: "Run in terminal: `fet propose`",
-    },
-    {
-        id: "fet-new",
-        description: "FET: create change skeleton via fet new <id>",
-        body: "Run in terminal: `fet new <change-id>`",
-    },
-    {
-        id: "fet-continue",
-        description: "FET: run fet continue",
-        body: "Run in terminal: `fet continue`",
-    },
-    {
-        id: "fet-ff",
-        description: "FET: run fet ff",
-        body: "Run in terminal: `fet ff`",
-    },
-    {
-        id: "fet-apply",
-        description: "FET: refresh apply-instructions and implement current task",
-        body: "Run `fet apply` in the project terminal to refresh `openspec/changes/<change-id>/apply-instructions.md`, then follow that file.",
-    },
-    {
-        id: "fet-validate",
-        description: "FET: validate current apply task",
-        body: "Run in terminal: `fet validate`",
-    },
-    {
-        id: "fet-verify",
-        description: "FET: final verify (manual or --auto)",
-        body: "Run `fet verify` or `fet verify --auto` per team policy.",
-    },
-    {
-        id: "fet-sync",
-        description: "FET: sync delta specs (needs interactive TTY)",
-        body: "Run `fet sync` in an interactive terminal after verify.",
-    },
-    {
-        id: "fet-archive",
-        description: "FET: archive a change after verify",
-        body: "Run `fet archive <change-id>` after verify.",
-    },
-    {
-        id: "fet-bulk-archive",
-        description: "FET: bulk archive multiple changes",
-        body: "Run `fet bulk-archive <id> [<id> ...]`",
-    },
-    {
-        id: "fet-onboard",
-        description: "FET: run fet onboard",
-        body: "Run in terminal: `fet onboard`",
-    },
-    {
-        id: "fet-update-context",
-        description: "FET: refresh AGENTS.md and openspec config fet block",
-        body: "Run in terminal: `fet update-context`",
-    },
-    {
-        id: "fet-doctor",
-        description: "FET: diagnose fet-state, openspec path, and tooling",
-        body: "Run in terminal: `fet doctor`",
-    },
-];
-/** Paths merged into `instructions` (OpenCode config docs); includes Cursor rule for parity. */
-const FET_INSTRUCTION_ENTRIES = [
-    "AGENTS.md",
-    "openspec/config.yaml",
-    ".cursor/rules/fet-context.mdc",
-    ".opencode/instructions/fet-context.md",
-];
-function skillMd(s) {
-    return [
-        "---",
-        `name: ${s.id}`,
-        `description: ${s.description}`,
-        "metadata:",
-        "  fet: \"true\"",
-        "---",
-        "",
-        s.body,
-        "",
-    ].join("\n");
-}
-function writeFetInstructionContext(cwd) {
-    const dir = join(cwd, ".opencode", "instructions");
-    mkdirSync(dir, { recursive: true });
-    const p = join(dir, "fet-context.md");
-    const body = [
-        "# FET / OpenSpec — project instructions",
-        "",
-        "OpenCode loads this file via root `opencode.json` → `instructions` (see https://opencode.ai/docs/zh-cn/config/ ).",
-        "",
-        "## Before substantive edits",
-        "",
-        "1. Read `AGENTS.md` and `openspec/config.yaml`.",
-        "2. If present, follow `.cursor/rules/fet-context.mdc` (same file as Cursor; listed in `opencode.json` → `instructions` for OpenCode).",
-        "3. Use the **skill** tool to load FET workflow skills from `.opencode/skills/fet-*/SKILL.md` when needed (e.g. `fet-apply`, `fet-validate`).",
-        "4. `fet` orchestrates around OpenSpec; terminal commands are `fet <subcommand>` unless you intentionally call `openspec` directly.",
-        "",
-        "## Token saving",
-        "",
-        "For trivial Q&A you may skip loading every instruction file; for code changes prefer full context.",
-        "",
-    ].join("\n");
-    if (!existsSync(p)) {
-        writeFileSync(p, body, "utf8");
-        return;
-    }
-    const cur = readFileSync(p, "utf8");
-    if (cur.includes("FET / OpenSpec"))
-        return;
-    writeFileSync(p, `${cur.trimEnd()}\n\n---\n\n${body}`, "utf8");
-}
-function resolveExistingOpenCodeConfigPath(cwd) {
-    const json = join(cwd, "opencode.json");
-    if (existsSync(json))
-        return json;
-    const jsonc = join(cwd, "opencode.jsonc");
-    if (existsSync(jsonc))
-        return jsonc;
-    return null;
-}
-function defaultOpenCodeConfig() {
-    return {
-        $schema: "https://opencode.ai/config.json",
-        permission: {
-            skill: {
-                "fet-*": "allow",
-            },
-        },
-        instructions: [...FET_INSTRUCTION_ENTRIES],
-    };
-}
-function mergeInstructions(cur) {
-    const inst = cur.instructions;
-    const arr = Array.isArray(inst) ? inst.map((x) => String(x)) : [];
-    const set = new Set(arr);
-    for (const p of FET_INSTRUCTION_ENTRIES) {
-        if (!set.has(p)) {
-            arr.push(p);
-            set.add(p);
-        }
-    }
-    return arr;
-}
-function mergeOpenCodeConfig(cwd) {
-    writeFetInstructionContext(cwd);
-    const existingPath = resolveExistingOpenCodeConfigPath(cwd);
-    const targetPath = existingPath ?? join(cwd, "opencode.json");
-    if (!existingPath) {
-        writeFileAtomicSync(targetPath, `${JSON.stringify(defaultOpenCodeConfig(), null, 2)}\n`);
-        return;
-    }
-    let raw;
-    try {
-        raw = readFileSync(existingPath, "utf8");
-    }
-    catch {
-        console.warn(`[fet] could not read ${existingPath}`);
-        return;
-    }
-    let cur;
-    try {
-        cur = JSON5.parse(raw);
-    }
-    catch {
-        console.warn(`[fet] could not parse ${existingPath} — fix syntax or merge instructions / permission manually`);
-        return;
-    }
-    if (existingPath.endsWith(".jsonc")) {
-        console.warn(`[fet] Merging ${existingPath}: comments will be stripped on save (OpenCode supports JSONC; fet rewrites as formatted JSON).`);
-    }
-    cur.$schema = cur.$schema || "https://opencode.ai/config.json";
-    const perm = typeof cur.permission === "object" && cur.permission !== null
-        ? { ...cur.permission }
-        : {};
-    if (typeof perm.skill === "string") {
-        console.warn(`[fet] permission.skill is a string ("${perm.skill}"); skipping fet-* merge — use an object map for skill patterns (see https://opencode.ai/docs/skills ).`);
-    }
-    else {
-        const skillPerm = typeof perm.skill === "object" && perm.skill !== null
-            ? { ...perm.skill }
-            : {};
-        skillPerm["fet-*"] = "allow";
-        perm.skill = skillPerm;
-    }
-    cur.permission = perm;
-    cur.instructions = mergeInstructions(cur);
-    const out = `${JSON.stringify(cur, null, 2)}\n`;
-    writeFileAtomicSync(targetPath, out);
-}
-export async function generateOpenCodeTooling(cwd, opts) {
-    const root = join(cwd, ".opencode", "skills");
-    mkdirSync(root, { recursive: true });
-    for (const s of OPENCODE_SKILLS) {
-        const dir = join(root, s.id);
-        const filePath = join(dir, "SKILL.md");
-        mkdirSync(dir, { recursive: true });
-        if (!existsSync(filePath) || opts.force) {
-            writeFileSync(filePath, skillMd(s), "utf8");
-            continue;
-        }
-        const existing = readFileSync(filePath, "utf8");
-        if (existing.includes("metadata:") && existing.includes("fet:")) {
-            console.log(`[fet] skip OpenCode skill (already FET): ${filePath}`);
-            continue;
-        }
-        const choice = await promptSkillConflict(filePath);
-        if (choice === "skip") {
-            console.log(`[fet] skipped OpenCode skill: ${filePath}`);
-            continue;
-        }
-        if (choice === "merge") {
-            const merged = `${existing.trimEnd()}\n\n---\n\n## FET (merged)\n\n${s.body}\n`;
-            writeFileSync(filePath, merged, "utf8");
-            continue;
-        }
-        writeFileSync(filePath, skillMd(s), "utf8");
-    }
-    mergeOpenCodeConfig(cwd);
-    console.log(`[fet] OpenCode: skills → ${root}; config → opencode.json / opencode.jsonc + instructions (see opencode.ai/docs/zh-cn/config/)`);
-}

package/dist/openspec.d.ts

@@ -1,16 +0,0 @@
-/** Resolved absolute path to global `openspec` on PATH, or null (DESIGN 3.1, 14.2). */
-export declare function resolveOpenSpecExecutable(): string | null;
-/** How to spawn OpenSpec: direct binary or npx fallback (DESIGN 3.1). */
-export declare function getOpenSpecLaunch(): {
-    command: string;
-    prefixArgs: string[];
-    /** For doctor / logging */
-    displayPath: string;
-};
-export declare function spawnOpenSpec(args: string[], options?: {
-    cwd?: string;
-    inheritStdio?: boolean;
-}): Promise<number>;
-/** Best-effort version string for doctor (may use npx). */
-export declare function openSpecVersionLine(): string | null;
-export declare const FET_VERSION = "0.1.0";

package/dist/openspec.js

@@ -1,73 +0,0 @@
-import { execFileSync, spawn } from "node:child_process";
-import { existsSync } from "node:fs";
-import { delimiter, join } from "node:path";
-function pathDirs() {
-    const p = process.env.PATH ?? process.env.Path ?? "";
-    return p.split(delimiter).filter(Boolean);
-}
-const WIN_EXTS = [".exe", ".cmd", ".bat", ".ps1", ""];
-function resolveOnPath(cmd) {
-    const dirs = pathDirs();
-    for (const d of dirs) {
-        for (const ext of WIN_EXTS) {
-            const candidate = join(d, cmd + ext);
-            if (existsSync(candidate))
-                return candidate;
-        }
-    }
-    return null;
-}
-/** Resolved absolute path to global `openspec` on PATH, or null (DESIGN 3.1, 14.2). */
-export function resolveOpenSpecExecutable() {
-    const direct = resolveOnPath(process.platform === "win32" ? "openspec.cmd" : "openspec");
-    if (direct)
-        return direct;
-    return resolveOnPath("openspec");
-}
-function npxCmd() {
-    return process.platform === "win32" ? "npx.cmd" : "npx";
-}
-/** How to spawn OpenSpec: direct binary or npx fallback (DESIGN 3.1). */
-export function getOpenSpecLaunch() {
-    const direct = resolveOpenSpecExecutable();
-    if (direct) {
-        return { command: direct, prefixArgs: [], displayPath: direct };
-    }
-    return {
-        command: npxCmd(),
-        prefixArgs: ["--yes", "@fission-ai/openspec"],
-        displayPath: `${npxCmd()} --yes @fission-ai/openspec`,
-    };
-}
-export function spawnOpenSpec(args, options = {}) {
-    const { command, prefixArgs } = getOpenSpecLaunch();
-    const fullArgs = [...prefixArgs, ...args];
-    const inheritStdio = options.inheritStdio ?? true;
-    return new Promise((resolve, reject) => {
-        const child = spawn(command, fullArgs, {
-            cwd: options.cwd,
-            stdio: inheritStdio ? "inherit" : "pipe",
-            shell: false,
-            env: process.env,
-        });
-        child.on("error", reject);
-        child.on("close", (code) => resolve(code ?? 1));
-    });
-}
-/** Best-effort version string for doctor (may use npx). */
-export function openSpecVersionLine() {
-    try {
-        const { command, prefixArgs } = getOpenSpecLaunch();
-        const out = execFileSync(command, [...prefixArgs, "-V"], {
-            encoding: "utf8",
-            stdio: ["ignore", "pipe", "ignore"],
-            timeout: 60_000,
-            maxBuffer: 2_000_000,
-        });
-        return out.trim().split("\n")[0] ?? null;
-    }
-    catch {
-        return null;
-    }
-}
-export const FET_VERSION = "0.1.0";

package/dist/paths.d.ts

@@ -1,9 +0,0 @@
-export declare const OPENSPEC_DIR = "openspec";
-export declare const GLOBAL_STATE_FILE: string;
-export declare const CONFIG_FILE: string;
-export declare const CHANGES_DIR: string;
-export declare function changeDir(changeId: string): string;
-export declare function changeStatePath(changeId: string): string;
-export declare function applyInstructionsPath(changeId: string): string;
-export declare function verifyInstructionsPath(changeId: string): string;
-export declare function tasksPath(changeId: string): string;

package/dist/paths.js

@@ -1,20 +0,0 @@
-import { join } from "node:path";
-export const OPENSPEC_DIR = "openspec";
-export const GLOBAL_STATE_FILE = join(OPENSPEC_DIR, "fet-state.json");
-export const CONFIG_FILE = join(OPENSPEC_DIR, "config.yaml");
-export const CHANGES_DIR = join(OPENSPEC_DIR, "changes");
-export function changeDir(changeId) {
-    return join(OPENSPEC_DIR, "changes", changeId);
-}
-export function changeStatePath(changeId) {
-    return join(changeDir(changeId), "fet-state.json");
-}
-export function applyInstructionsPath(changeId) {
-    return join(changeDir(changeId), "apply-instructions.md");
-}
-export function verifyInstructionsPath(changeId) {
-    return join(changeDir(changeId), "VerifyInstructions.txt");
-}
-export function tasksPath(changeId) {
-    return join(changeDir(changeId), "tasks.md");
-}

package/dist/prompt.d.ts

@@ -1,4 +0,0 @@
-export declare function confirmAutoRun(message: string): Promise<boolean>;
-export type SkillConflictChoice = "overwrite" | "merge" | "skip";
-/** DESIGN 9.3: interactive conflict for Cursor skills */
-export declare function promptSkillConflict(path: string): Promise<SkillConflictChoice>;

package/dist/prompt.js

@@ -1,30 +0,0 @@
-import * as readline from "node:readline/promises";
-export async function confirmAutoRun(message) {
-    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-    try {
-        const ans = (await rl.question(`${message} (type yes to approve): `)).trim().toLowerCase();
-        return ans === "yes";
-    }
-    finally {
-        rl.close();
-    }
-}
-/** DESIGN 9.3: interactive conflict for Cursor skills */
-export async function promptSkillConflict(path) {
-    if (!process.stdin.isTTY)
-        return "skip";
-    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-    try {
-        const ans = (await rl.question(`[fet] ${path} exists. Overwrite / Merge / Skip? [o/m/S] `))
-            .trim()
-            .toLowerCase();
-        if (ans === "o" || ans === "overwrite")
-            return "overwrite";
-        if (ans === "m" || ans === "merge")
-            return "merge";
-        return "skip";
-    }
-    finally {
-        rl.close();
-    }
-}

package/dist/scanner.d.ts

@@ -1,23 +0,0 @@
-export interface ScanResult {
-    projectName: string;
-    description: string;
-    frameworkGuess: string;
-    languageGuess: string;
-    bundlerGuess: string;
-    stateManagementGuess: string;
-    uiLibraryGuess: string;
-    readmeExcerpt: string;
-    scriptsTable: string;
-    testCommand: string;
-    eslintHint: string;
-    tsconfigHint: string;
-    routeFiles: string;
-    i18nHint: string;
-    projectTree: string;
-    warnings: string[];
-}
-export declare function scanProject(cwd: string): ScanResult;
-export declare function renderAgents(scan: ScanResult): string;
-export declare function writeAgentsMd(cwd: string, scan: ScanResult): void;
-export declare function mergeConfigYaml(cwd: string, scan: ScanResult): void;
-export declare function runUpdateContext(cwd: string): void;