@zihanw/pi-forge 0.3.0 → 0.3.2

package/dist/stack-migration.js

@@ -0,0 +1,126 @@
+import { copyFileSync, existsSync, mkdirSync, readdirSync, unlinkSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { legacyPromptStacksDir, promptStacksDir } from "./storage.js";
+export function migrateLegacyPromptStacks(cwd, options = {}) {
+    const sourceDir = legacyPromptStacksDir(cwd);
+    const targetDir = promptStacksDir(cwd);
+    const report = {
+        sourceDir,
+        targetDir,
+        dryRun: options.dryRun === true,
+        overwrite: options.overwrite === true,
+        deleteLegacy: options.deleteLegacy === true,
+        files: [],
+        copied: 0,
+        overwritten: 0,
+        skipped: 0,
+        errors: 0,
+        deletedLegacy: 0,
+    };
+    if (!existsSync(sourceDir))
+        return report;
+    let entries;
+    try {
+        entries = readdirSync(sourceDir).filter((name) => name.endsWith(".json")).sort();
+    }
+    catch (error) {
+        report.files.push({
+            name: "(legacy directory)",
+            sourcePath: sourceDir,
+            targetPath: targetDir,
+            action: "error",
+            reason: error instanceof Error ? error.message : String(error),
+            deleteLegacy: false,
+        });
+        report.errors++;
+        return report;
+    }
+    for (const name of entries) {
+        const sourcePath = join(sourceDir, name);
+        const targetPath = join(targetDir, name);
+        const targetExists = existsSync(targetPath);
+        if (targetExists && !report.overwrite) {
+            report.files.push({
+                name,
+                sourcePath,
+                targetPath,
+                action: "skip",
+                reason: "target already exists",
+                deleteLegacy: false,
+            });
+            report.skipped++;
+            continue;
+        }
+        const action = targetExists ? "overwrite" : "copy";
+        try {
+            if (!report.dryRun) {
+                mkdirSync(dirname(targetPath), { recursive: true });
+                copyFileSync(sourcePath, targetPath);
+                if (report.deleteLegacy) {
+                    unlinkSync(sourcePath);
+                    report.deletedLegacy++;
+                }
+            }
+            if (action === "overwrite")
+                report.overwritten++;
+            else
+                report.copied++;
+            report.files.push({
+                name,
+                sourcePath,
+                targetPath,
+                action,
+                deleteLegacy: report.deleteLegacy,
+            });
+        }
+        catch (error) {
+            report.files.push({
+                name,
+                sourcePath,
+                targetPath,
+                action: "error",
+                reason: error instanceof Error ? error.message : String(error),
+                deleteLegacy: false,
+            });
+            report.errors++;
+        }
+    }
+    return report;
+}
+export function renderMigrationReport(report) {
+    const lines = [
+        "# Prompt Stack Migration",
+        "",
+        `Source: ${report.sourceDir}`,
+        `Target: ${report.targetDir}`,
+        `Mode: ${report.dryRun ? "dry run" : "write"}`,
+        `Overwrite existing target files: ${report.overwrite ? "yes" : "no"}`,
+        `Delete legacy files after copy: ${report.deleteLegacy ? "yes" : "no"}`,
+        "",
+        `Copied: ${report.copied}`,
+        `Overwritten: ${report.overwritten}`,
+        `Skipped: ${report.skipped}`,
+        `Errors: ${report.errors}`,
+        `Deleted legacy files: ${report.deletedLegacy}`,
+        "",
+        "## Files",
+        "",
+    ];
+    if (report.files.length === 0) {
+        lines.push("No legacy prompt-stack JSON files found.");
+        return lines.join("\n");
+    }
+    for (const file of report.files) {
+        const suffix = file.reason ? ` (${file.reason})` : "";
+        lines.push(`- ${file.action}: ${file.name}${suffix}`);
+        lines.push(`  from: ${file.sourcePath}`);
+        lines.push(`  to:   ${file.targetPath}`);
+        if (file.deleteLegacy)
+            lines.push("  legacy delete: yes");
+    }
+    if (!report.deleteLegacy && !report.dryRun && (report.copied || report.overwritten)) {
+        lines.push("", "Legacy files were left in place. Re-run with `--delete-legacy` after checking the migrated stacks if you want to remove them.");
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=stack-migration.js.map

package/dist/stack-migration.js.map

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

package/dist/storage.d.ts

@@ -0,0 +1,10 @@
+export declare function promptStacksDir(cwd: string): string;
+export declare function forgeDir(cwd: string): string;
+export declare function forgeExtensionsDir(cwd: string): string;
+export declare function globalForgeDir(): string;
+export declare function globalForgeExtensionsDir(): string;
+export declare function legacyPromptStacksDir(cwd: string): string;
+export declare function promptStackReadDirs(cwd: string): string[];
+export declare function promptStackPath(cwd: string, id: string): string;
+export declare function isInsidePromptStackStorage(cwd: string, filePath: string): boolean;
+//# sourceMappingURL=storage.d.ts.map

package/dist/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAGA,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,wBAAgB,wBAAwB,IAAI,MAAM,CAEjD;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAEzD;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEjF"}

package/dist/storage.js

@@ -0,0 +1,36 @@
+import { homedir } from "node:os";
+import { isAbsolute, join, relative, resolve } from "node:path";
+export function promptStacksDir(cwd) {
+    return join(cwd, ".pi", "forge", "prompt-stacks");
+}
+export function forgeDir(cwd) {
+    return join(cwd, ".pi", "forge");
+}
+export function forgeExtensionsDir(cwd) {
+    return join(forgeDir(cwd), "extensions");
+}
+export function globalForgeDir() {
+    return join(homedir(), ".pi", "forge");
+}
+export function globalForgeExtensionsDir() {
+    return join(globalForgeDir(), "extensions");
+}
+export function legacyPromptStacksDir(cwd) {
+    return join(cwd, ".pi", "prompt-stacks");
+}
+export function promptStackReadDirs(cwd) {
+    return [promptStacksDir(cwd), legacyPromptStacksDir(cwd)];
+}
+export function promptStackPath(cwd, id) {
+    return join(promptStacksDir(cwd), `${id}.json`);
+}
+export function isInsidePromptStackStorage(cwd, filePath) {
+    return promptStackReadDirs(cwd).some((dir) => isInsideDir(dir, filePath));
+}
+function isInsideDir(rootDir, filePath) {
+    const root = resolve(rootDir);
+    const target = resolve(filePath);
+    const rel = relative(root, target);
+    return !!rel && !rel.startsWith("..") && !isAbsolute(rel);
+}
+//# sourceMappingURL=storage.js.map

package/dist/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEhE,MAAM,UAAU,eAAe,CAAC,GAAW;IAC1C,OAAO,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,GAAW;IACnC,OAAO,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC7C,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,YAAY,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,cAAc;IAC7B,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,wBAAwB;IACvC,OAAO,IAAI,CAAC,cAAc,EAAE,EAAE,YAAY,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,GAAW;IAChD,OAAO,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,eAAe,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,GAAW;IAC9C,OAAO,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,qBAAqB,CAAC,GAAG,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAW,EAAE,EAAU;IACtD,OAAO,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,GAAW,EAAE,QAAgB;IACvE,OAAO,mBAAmB,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC;AAC3E,CAAC;AAED,SAAS,WAAW,CAAC,OAAe,EAAE,QAAgB;IACrD,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9B,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACjC,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACnC,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;AAC3D,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,173 @@
+import type { AgentMessage } from "@earendil-works/pi-agent-core";
+import type { BuildSystemPromptOptions, ExtensionContext } from "@earendil-works/pi-coding-agent";
+export type PromptStackMode = "replace" | "append" | "prepend";
+export type PromptStackRole = "system" | "user" | "assistant" | "custom";
+export type PromptStackSlot = "chat-history" | "tools" | "tool-guidelines" | "skills" | "project-context" | "append-system-prompt" | "date" | "cwd" | "date-cwd" | "active-model" | "pi-docs" | "variables";
+export type PromptStackSlotFormat = "xml" | "json" | "plain";
+export type PromptRegexStage = "history" | "compiled";
+export type PromptRegexEffect = "outgoing" | "display" | "both" | "finalize";
+export type PromptRegexTarget = "system" | "messages";
+export interface PromptRegexRule {
+    id: string;
+    name?: string;
+    enabled?: boolean;
+    stage: PromptRegexStage;
+    effect?: PromptRegexEffect;
+    pattern: string;
+    flags?: string;
+    replace?: string;
+    trimStrings?: string[];
+    roles?: string[];
+    targets?: PromptRegexTarget[];
+    maxMessages?: number;
+    maxChars?: number;
+    minDepth?: number;
+    maxDepth?: number;
+    source?: Record<string, unknown>;
+}
+export interface PromptRegexConfig {
+    schemaVersion?: 1;
+    rules?: PromptRegexRule[];
+}
+export type PromptResourcePolicy = {
+    allow?: string[];
+    deny?: never;
+} | {
+    allow?: never;
+    deny?: string[];
+};
+export interface PromptStackDefaults {
+    syntheticMessagesVisible?: boolean;
+    unresolvedMacroPolicy?: "warn" | "keep" | "error";
+}
+export interface PromptStackContextOptions {
+    allowDuplicateChatHistory?: boolean;
+}
+export interface PromptStackBaseItem {
+    kind: "block" | "slot";
+    id: string;
+    name?: string;
+    enabled?: boolean;
+    role?: PromptStackRole;
+    tags?: string[];
+    source?: Record<string, unknown>;
+}
+export interface PromptStackBlockItem extends PromptStackBaseItem {
+    kind: "block";
+    content: string;
+}
+export interface VariablesSlotOptions {
+    /** Include static stack variables. Default: true. */
+    includeStatic?: boolean;
+    /** Include session variables. Default: true. */
+    includeSession?: boolean;
+    /** Include turn variables. Default: true. */
+    includeTurn?: boolean;
+    /** Render format. Default: xml. */
+    format?: Exclude<PromptStackSlotFormat, "json">;
+}
+export interface PromptStackSlotOptions {
+    /** For chat-history: include the latest user message in the expanded history. Default: true. */
+    includeLastUserMessage?: boolean;
+    /** For chat-history: remove assistant thinking content blocks from inserted history. Default: false. */
+    stripAssistantThinking?: boolean;
+    /** For chat-history: keep only messages with these roles. Default: all roles. */
+    roles?: string[];
+    /** For chat-history: include Pi branch/compaction summaries. Default: true. */
+    includeSummaries?: boolean;
+    /** For chat-history: keep or drop tool-call/tool-result history. Default: keep. */
+    toolMode?: "keep" | "drop";
+    /** For chat-history: keep only the most recent N messages after filtering. */
+    maxMessages?: number;
+    /** For chat-history: keep only the most recent messages within an approximate character budget. */
+    maxChars?: number;
+    /** For variables: control which variable scopes are included. */
+    includeStatic?: boolean;
+    includeSession?: boolean;
+    includeTurn?: boolean;
+    format?: PromptStackSlotFormat;
+    /** For tools: only render tools that provide prompt snippets, matching Pi's default prompt builder. */
+    onlyWithSnippets?: boolean;
+    /** For date/date-cwd: include the exact current time. Default: false. */
+    includeTime?: boolean;
+    /** For tool-guidelines: override the plain-format section heading. */
+    heading?: string;
+    /** For tool-guidelines: include Pi's default concise/file-path guideline bullets. */
+    includePiDefaultGuidelines?: boolean;
+    /** For tool-guidelines: match Pi's default wording where it differs from pi-forge's generic wording. */
+    piStyle?: boolean;
+    /** For skills: omit the skills section unless the read tool is active, matching Pi's default prompt builder. */
+    requireReadTool?: boolean;
+    [key: string]: unknown;
+}
+export interface PromptStackSlotItem extends PromptStackBaseItem {
+    kind: "slot";
+    slot: PromptStackSlot | string;
+    options?: PromptStackSlotOptions;
+}
+export type PromptStackItem = PromptStackBlockItem | PromptStackSlotItem;
+export type PromptVariablePrimitive = string | number | boolean | null;
+export type PromptVariableValue = PromptVariablePrimitive | PromptVariableValue[] | {
+    [key: string]: PromptVariableValue;
+};
+export interface PromptStack {
+    schemaVersion: 1;
+    type?: "pi-forge.prompt-stack";
+    id: string;
+    name?: string;
+    description?: string;
+    autoActivate?: boolean;
+    mode?: PromptStackMode;
+    defaults?: PromptStackDefaults;
+    context?: PromptStackContextOptions;
+    tools?: PromptResourcePolicy;
+    skills?: PromptResourcePolicy;
+    variables?: Record<string, string>;
+    regex?: PromptRegexConfig;
+    items: PromptStackItem[];
+    import?: Record<string, unknown>;
+}
+export interface LoadedPromptStack {
+    stack: PromptStack;
+    filePath: string;
+    diagnostics: PromptStackDiagnostic[];
+}
+export type PromptStackDiagnosticLevel = "error" | "warning" | "info";
+export interface PromptStackDiagnostic {
+    level: PromptStackDiagnosticLevel;
+    message: string;
+    itemId?: string;
+}
+export interface PromptVariableStore {
+    turn: Record<string, PromptVariableValue>;
+    session: Record<string, PromptVariableValue>;
+    sessionDirty?: boolean;
+}
+export interface PromptRuntime {
+    options: BuildSystemPromptOptions;
+    ctx?: ExtensionContext;
+    latestUserMessage?: string;
+    now: Date;
+    variables?: PromptVariableStore;
+}
+export interface CompileSystemPromptResult {
+    systemPrompt: string;
+    diagnostics: PromptStackDiagnostic[];
+}
+export type CompileMessageSourceKind = "stack-item" | "chat-history" | "implicit-history";
+export interface CompileMessageSource {
+    kind: CompileMessageSourceKind;
+    itemId?: string;
+    itemName?: string;
+    slot?: string;
+    historyIndex?: number;
+    historyCount?: number;
+    role?: string;
+}
+export interface CompileMessagesResult {
+    messages: AgentMessage[];
+    messageSources: CompileMessageSource[];
+    diagnostics: PromptStackDiagnostic[];
+}
+export { SUPPORTED_SLOTS } from "./slot-renderers.ts";
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+export { SUPPORTED_SLOTS } from "./slot-renderers.js";
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAgNA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/web-editor/index.d.ts

@@ -0,0 +1,3 @@
+export { DEFAULT_WEB_EDITOR_PORT, startWebEditorServer } from "./server.ts";
+export type * from "./types.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/web-editor/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/web-editor/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAC5E,mBAAmB,YAAY,CAAC"}

package/dist/web-editor/index.js

@@ -0,0 +1,2 @@
+export { DEFAULT_WEB_EDITOR_PORT, startWebEditorServer } from "./server.js";
+//# sourceMappingURL=index.js.map

package/dist/web-editor/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/web-editor/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC"}

package/dist/web-editor/page.d.ts

@@ -0,0 +1,2 @@
+export declare function renderEditorHtml(): string;
+//# sourceMappingURL=page.d.ts.map

package/dist/web-editor/page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page.d.ts","sourceRoot":"","sources":["../../src/web-editor/page.ts"],"names":[],"mappings":"AAAA,wBAAgB,gBAAgB,IAAI,MAAM,CAiwGzC"}