@pantion/dialogs 0.2.1

package/dist/core/protocol/system-prompt.js

@@ -0,0 +1,68 @@
+import { loadProtocolCore, loadProtocolCommand } from './loader.js';
+/**
+ * Assemble the full system prompt from protocol core + command + skill rules.
+ * This is the bridge between the protocol .md files and the LLM.
+ */
+export function assembleSystemPrompt(options) {
+    const parts = [];
+    // 1. Core protocol knowledge (advanced sections only for modes that need them)
+    const advancedModes = ['reconverge', 'decompose', 'reverse', 'create-dialog', 'redialog'];
+    const needsAdvanced = advancedModes.includes(options.mode);
+    parts.push(loadProtocolCore(options.protocolDir, { includeAdvanced: needsAdvanced }));
+    // 2. Mode-specific command protocol
+    parts.push('\n---\n');
+    const commandName = options.mode === 'reconverge' ? 'redialog' : options.mode;
+    parts.push(loadProtocolCommand(commandName, options.protocolDir));
+    // 3. Dialog-specific convergence rules (if a dialog is active)
+    if (options.dialogRules) {
+        parts.push('\n---\n');
+        parts.push('# Active Dialog — Additional Convergence Rules\n\n');
+        parts.push(options.dialogRules);
+    }
+    // 4. Soul interaction style (if configured)
+    if (options.soulRules) {
+        parts.push('\n---\n');
+        parts.push('# Active Soul — Interaction Style\n\n');
+        parts.push(options.soulRules);
+    }
+    // 5. Context
+    parts.push('\n---\n');
+    parts.push('# Session Context\n\n');
+    if (options.canonName) {
+        parts.push(`Canon name: ${options.canonName}\n`);
+    }
+    if (options.userLanguage) {
+        parts.push(`User language: ${options.userLanguage}. Respond in this language.\n`);
+    }
+    parts.push(`Date: ${new Date().toISOString().split('T')[0]}\n`);
+    // 6. Inference Policy enforcement (dynamic based on stamp value)
+    if (options.inferencePolicy === 'strict') {
+        parts.push('\n---\n');
+        parts.push('# Inference Policy: STRICT\n\n');
+        parts.push('This canon operates under STRICT inference policy. You MUST:\n');
+        parts.push('- On ANY ambiguity: STOP and formulate OPEN QUESTIONS. Do not guess.\n');
+        parts.push('- Make NO implicit assumptions — every decision must trace to an explicit dialog turn.\n');
+        parts.push('- Do NOT choose between alternatives — present them as open questions for the user.\n');
+        parts.push('- If a concept has multiple interpretations, ask which one the user means.\n');
+        parts.push('- Treat FLEX zones as "undecided", not as "your choice".\n');
+    }
+    // 7. For resume/reconverge/decompose: include the existing dialog
+    if (options.existingDialog) {
+        parts.push('\n---\n');
+        if (options.mode === 'reconverge') {
+            parts.push('# Existing Dialog (reconvergence context)\n\n');
+            parts.push('The following dialog has already been conducted and converged. Analyze it for gaps — questions that should have been asked, assumptions that were never made explicit, edge cases not explored. Do NOT continue the dialog yet. First produce a gap analysis, then conduct a targeted supplementary dialog for the gaps the user selects.\n\n');
+        }
+        else if (options.mode === 'decompose') {
+            parts.push('# Existing Dialog (decomposition context)\n\n');
+            parts.push('The following dialog has already been conducted and converged as a standalone canon. It is now being decomposed into subsystems. Use the existing dialog as a starting point — summarize what you already know and focus on decomposition.\n\n');
+        }
+        else {
+            parts.push('# Existing Dialog (resume context)\n\n');
+            parts.push('The following dialog has already been conducted. Continue from where it left off.\n\n');
+        }
+        parts.push(options.existingDialog);
+    }
+    return parts.join('\n');
+}
+//# sourceMappingURL=system-prompt.js.map

package/dist/core/protocol/system-prompt.js.map

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

package/dist/core/session/canon-writer.d.ts

@@ -0,0 +1,33 @@
+import type { Session, CanonMetadata } from '../types.js';
+/**
+ * Write the dialog file (THE CANON — verbatim dialog).
+ * No LLM dependency — this is purely file I/O.
+ */
+export declare function writeDialogFile(session: Session, name: string, date: string, projectPath: string, mode?: 'dialog' | 'full', metadata?: CanonMetadata): string;
+/**
+ * Write a summary file (DERIVED — content provided by the client LLM).
+ * The server does not generate summaries; it writes what the client provides.
+ */
+export declare function writeSummaryFile(name: string, date: string, summaryContent: string, projectPath: string): string;
+/**
+ * Append an amendment block to an existing dialog file.
+ */
+export declare function appendAmendment(canonName: string, projectPath: string, amendmentDialog: Array<{
+    role: string;
+    content: string;
+}>, stampRaw: string): string;
+/**
+ * Append a Reality Convergence block to an existing dialog file.
+ * Reality Convergence captures empirical feedback from a built implementation
+ * back into the canon as intent-deepening.
+ */
+export declare function appendRealityConvergence(canonName: string, projectPath: string, validationDialog: Array<{
+    role: string;
+    content: string;
+}>, stampRaw: string): string;
+/**
+ * Update the canon index with a new or updated entry.
+ * Regenerates the full index from filesystem state.
+ */
+export declare function updateCanonIndex(_name: string, _status: string, _date: string, projectPath: string): void;
+//# sourceMappingURL=canon-writer.d.ts.map

package/dist/core/session/canon-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canon-writer.d.ts","sourceRoot":"","sources":["../../../src/core/session/canon-writer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAK1D;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,IAAI,CAAC,EAAE,QAAQ,GAAG,MAAM,EACxB,QAAQ,CAAC,EAAE,aAAa,GACvB,MAAM,CASR;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM,GAClB,MAAM,CAgBR;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,EACzD,QAAQ,EAAE,MAAM,GACf,MAAM,CAgCR;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,gBAAgB,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,EAC1D,QAAQ,EAAE,MAAM,GACf,MAAM,CAgCR;AAwDD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,GAClB,IAAI,CAEN"}

package/dist/core/session/canon-writer.js

@@ -0,0 +1,152 @@
+import { resolve } from 'node:path';
+import { writeFile, readFileSafe, canonDir, ensureDir, assertSafeName } from '../utils/fs.js';
+import { createPendingHumanStamp, createAutoApprovedHumanStamp, formatCanonMetadata } from '../protocol/stamp-parser.js';
+import { regenerateIndex } from '../canon/index-manager.js';
+/**
+ * Write the dialog file (THE CANON — verbatim dialog).
+ * No LLM dependency — this is purely file I/O.
+ */
+export function writeDialogFile(session, name, date, projectPath, mode, metadata) {
+    assertSafeName(name);
+    const dir = canonDir(projectPath);
+    ensureDir(dir);
+    const content = formatDialog(session, name, date, mode, metadata);
+    const dialogPath = resolve(dir, name, 'dialog.md');
+    writeFile(dialogPath, content);
+    return dialogPath;
+}
+/**
+ * Write a summary file (DERIVED — content provided by the client LLM).
+ * The server does not generate summaries; it writes what the client provides.
+ */
+export function writeSummaryFile(name, date, summaryContent, projectPath) {
+    assertSafeName(name);
+    const dir = canonDir(projectPath);
+    ensureDir(dir);
+    // Normalize literal \n sequences to real newlines (client may send escaped strings)
+    let content = normalizeLiteralNewlines(summaryContent);
+    // Ensure the summary has the derivation comment
+    if (!content.includes('Derived from:')) {
+        content = `<!-- Derived from: canon/${name}/dialog.md, ${date} -->\n<!-- This is a DERIVED file for navigation — the dialog is the only source of truth -->\n\n${content}`;
+    }
+    const summaryPath = resolve(dir, name, 'summary.md');
+    writeFile(summaryPath, content);
+    return summaryPath;
+}
+/**
+ * Append an amendment block to an existing dialog file.
+ */
+export function appendAmendment(canonName, projectPath, amendmentDialog, stampRaw) {
+    assertSafeName(canonName);
+    const dir = canonDir(projectPath);
+    const dialogPath = resolve(dir, canonName, 'dialog.md');
+    const existing = readFileSafe(dialogPath);
+    if (!existing) {
+        throw new Error(`Canon dialog not found: ${dialogPath}`);
+    }
+    const lines = [
+        existing,
+        '',
+        '---',
+        '',
+        '# Amendment',
+        '',
+        stampRaw,
+        '',
+        '---',
+        '',
+    ];
+    for (const msg of amendmentDialog) {
+        const role = msg.role === 'user' ? 'HUMAN' : 'ASSISTANT';
+        lines.push(`${role}: ${msg.content}`);
+        lines.push('');
+    }
+    const content = lines.join('\n');
+    writeFile(dialogPath, content);
+    return dialogPath;
+}
+/**
+ * Append a Reality Convergence block to an existing dialog file.
+ * Reality Convergence captures empirical feedback from a built implementation
+ * back into the canon as intent-deepening.
+ */
+export function appendRealityConvergence(canonName, projectPath, validationDialog, stampRaw) {
+    assertSafeName(canonName);
+    const dir = canonDir(projectPath);
+    const dialogPath = resolve(dir, canonName, 'dialog.md');
+    const existing = readFileSafe(dialogPath);
+    if (!existing) {
+        throw new Error(`Canon dialog not found: ${dialogPath}`);
+    }
+    const lines = [
+        existing,
+        '',
+        '---',
+        '',
+        '# Reality Convergence',
+        '',
+        stampRaw,
+        '',
+        '---',
+        '',
+    ];
+    for (const msg of validationDialog) {
+        const role = msg.role === 'user' ? 'HUMAN' : 'ASSISTANT';
+        lines.push(`${role}: ${msg.content}`);
+        lines.push('');
+    }
+    const content = lines.join('\n');
+    writeFile(dialogPath, content);
+    return dialogPath;
+}
+/**
+ * Normalize literal \n (backslash + n) sequences to real newlines.
+ * Client LLMs sometimes send escaped strings via MCP.
+ */
+function normalizeLiteralNewlines(text) {
+    // Only replace if the text contains literal \n but no real newlines —
+    // this indicates the entire content is on one line with escaped newlines.
+    if (!text.includes('\n') && text.includes('\\n')) {
+        return text.replace(/\\n/g, '\n');
+    }
+    return text;
+}
+function formatDialog(session, _name, _date, mode, metadata) {
+    const lines = [];
+    lines.push('# DialogSpec Dialog');
+    lines.push('<!-- This is the canon — the verbatim dialog is the only source of truth -->');
+    lines.push('<!-- All other files (summary, project files, tests) are derived from this dialog -->');
+    lines.push('');
+    // Only add stampRaw at the top if the stamp is NOT already in the dialog messages.
+    // The client may include the stamp in the last assistant message, which would cause duplication.
+    const stampInMessages = session.stampRaw && session.messages.some((msg) => msg.content.includes('=== DIALOGSPEC STAMP ==='));
+    if (session.stampRaw && !stampInMessages) {
+        lines.push(session.stampRaw);
+        lines.push('');
+    }
+    lines.push('---');
+    lines.push('');
+    for (const msg of session.messages) {
+        const role = msg.role === 'user' ? 'HUMAN' : 'ASSISTANT';
+        lines.push(`${role}: ${msg.content}`);
+        lines.push('');
+    }
+    // Append CANON METADATA block (server-generated replay context)
+    if (metadata) {
+        lines.push('');
+        lines.push(formatCanonMetadata(metadata));
+    }
+    // Append HUMAN STAMP block (auto-approved for dialog mode, pending for full mode)
+    lines.push('');
+    lines.push(mode === 'dialog' ? createAutoApprovedHumanStamp() : createPendingHumanStamp());
+    lines.push('');
+    return lines.join('\n');
+}
+/**
+ * Update the canon index with a new or updated entry.
+ * Regenerates the full index from filesystem state.
+ */
+export function updateCanonIndex(_name, _status, _date, projectPath) {
+    regenerateIndex(projectPath);
+}
+//# sourceMappingURL=canon-writer.js.map

package/dist/core/session/canon-writer.js.map

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

package/dist/core/session/manager.d.ts

@@ -0,0 +1,10 @@
+import type { Session, SessionMeta, SessionStatus, Message } from '../types.js';
+export declare function createSession(projectPath: string, name: string, systemPrompt: string): Session;
+export declare function saveSession(projectPath: string, session: Session): void;
+export declare function loadSession(projectPath: string, id: string): Session | null;
+export declare function listSessions(projectPath: string): SessionMeta[];
+export declare function getLastSession(projectPath: string): Session | null;
+export declare function findSessionByName(projectPath: string, name: string): Session | null;
+export declare function addMessage(session: Session, message: Message): void;
+export declare function updateStatus(session: Session, status: SessionStatus): void;
+//# sourceMappingURL=manager.d.ts.map

package/dist/core/session/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../src/core/session/manager.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAgChF,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAa9F;AAED,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAIvE;AAED,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAS3E;AAED,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,EAAE,CA4B/D;AAED,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAIlE;AAED,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAOnF;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAEnE;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAE1E"}

package/dist/core/session/manager.js

@@ -0,0 +1,105 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync, readdirSync } from 'node:fs';
+import { resolve } from 'node:path';
+function isSession(obj) {
+    return (typeof obj === 'object' && obj !== null &&
+        typeof obj.id === 'string' &&
+        typeof obj.name === 'string' &&
+        Array.isArray(obj.messages));
+}
+const SESSIONS_DIR = '.pantion/sessions';
+function getSessionsDir(projectPath) {
+    const dir = resolve(projectPath, SESSIONS_DIR);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    return dir;
+}
+function sessionPath(projectPath, id) {
+    return resolve(getSessionsDir(projectPath), `${id}.json`);
+}
+function generateId() {
+    const now = new Date();
+    const date = now.toISOString().split('T')[0].replace(/-/g, '');
+    const rand = Math.random().toString(36).slice(2, 8);
+    return `${date}-${rand}`;
+}
+export function createSession(projectPath, name, systemPrompt) {
+    const now = new Date().toISOString();
+    const session = {
+        id: generateId(),
+        name,
+        status: 'active',
+        messages: [],
+        systemPrompt,
+        createdAt: now,
+        updatedAt: now,
+    };
+    saveSession(projectPath, session);
+    return session;
+}
+export function saveSession(projectPath, session) {
+    session.updatedAt = new Date().toISOString();
+    const path = sessionPath(projectPath, session.id);
+    writeFileSync(path, JSON.stringify(session, null, 2), 'utf-8');
+}
+export function loadSession(projectPath, id) {
+    const path = sessionPath(projectPath, id);
+    if (!existsSync(path))
+        return null;
+    try {
+        const data = JSON.parse(readFileSync(path, 'utf-8'));
+        return isSession(data) ? data : null;
+    }
+    catch {
+        return null;
+    }
+}
+export function listSessions(projectPath) {
+    const dir = getSessionsDir(projectPath);
+    const files = readdirSync(dir).filter((f) => f.endsWith('.json'));
+    const metas = [];
+    for (const file of files) {
+        try {
+            const data = JSON.parse(readFileSync(resolve(dir, file), 'utf-8'));
+            if (!isSession(data))
+                continue;
+            const session = data;
+            metas.push({
+                id: session.id,
+                name: session.name,
+                status: session.status,
+                dialog: session.dialog,
+                soul: session.soul,
+                updatedAt: session.updatedAt,
+                canonName: session.canonName,
+                messageCount: session.messages.length,
+                canonType: session.canonType,
+                targetDialogName: session.targetDialogName,
+            });
+        }
+        catch {
+            // skip corrupt files
+        }
+    }
+    return metas.sort((a, b) => b.updatedAt.localeCompare(a.updatedAt));
+}
+export function getLastSession(projectPath) {
+    const metas = listSessions(projectPath);
+    if (metas.length === 0)
+        return null;
+    return loadSession(projectPath, metas[0].id);
+}
+export function findSessionByName(projectPath, name) {
+    const metas = listSessions(projectPath);
+    const match = metas.find((m) => m.name === name || m.canonName === name || m.id === name);
+    if (!match)
+        return null;
+    return loadSession(projectPath, match.id);
+}
+export function addMessage(session, message) {
+    session.messages.push(message);
+}
+export function updateStatus(session, status) {
+    session.status = status;
+}
+//# sourceMappingURL=manager.js.map

package/dist/core/session/manager.js.map

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

package/dist/core/skill/canon-writer.d.ts

@@ -0,0 +1,22 @@
+import type { Session, CanonMetadata } from '../types.js';
+/**
+ * Get the skill canon directory: skills/{skillName}/canon/
+ */
+export declare function skillCanonDir(projectPath: string, skillName: string): string;
+/**
+ * Write a skill dialog file (THE CANON for the skill).
+ */
+export declare function writeSkillDialogFile(session: Session, skillName: string, date: string, projectPath: string, mode?: 'dialog' | 'full', metadata?: CanonMetadata): string;
+/**
+ * Write a skill summary file (DERIVED from skill canon).
+ */
+export declare function writeSkillSummaryFile(skillName: string, date: string, summaryContent: string, projectPath: string): string;
+/**
+ * Check if a skill has a canon (is a dynamic skill).
+ */
+export declare function skillHasCanon(projectPath: string, skillName: string): boolean;
+/**
+ * Read a skill's canon dialog.
+ */
+export declare function readSkillCanonDialog(projectPath: string, skillName: string): string | null;
+//# sourceMappingURL=canon-writer.d.ts.map

package/dist/core/skill/canon-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canon-writer.d.ts","sourceRoot":"","sources":["../../../src/core/skill/canon-writer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAI1D;;GAEG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAE5E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,IAAI,CAAC,EAAE,QAAQ,GAAG,MAAM,EACxB,QAAQ,CAAC,EAAE,aAAa,GACvB,MAAM,CASR;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM,GAClB,MAAM,CAcR;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAI7E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAI1F"}

package/dist/core/skill/canon-writer.js

@@ -0,0 +1,96 @@
+import { resolve } from 'node:path';
+import { existsSync } from 'node:fs';
+import { writeFile, readFileSafe, ensureDir, assertSafeName } from '../utils/fs.js';
+import { createPendingHumanStamp, createAutoApprovedHumanStamp, formatCanonMetadata } from '../protocol/stamp-parser.js';
+/**
+ * Get the skill canon directory: skills/{skillName}/canon/
+ */
+export function skillCanonDir(projectPath, skillName) {
+    return resolve(projectPath, 'skills', skillName, 'canon');
+}
+/**
+ * Write a skill dialog file (THE CANON for the skill).
+ */
+export function writeSkillDialogFile(session, skillName, date, projectPath, mode, metadata) {
+    assertSafeName(skillName);
+    const dir = skillCanonDir(projectPath, skillName);
+    ensureDir(dir);
+    const content = formatSkillDialog(session, skillName, mode, metadata);
+    const dialogPath = resolve(dir, 'skill-dialog.md');
+    writeFile(dialogPath, content);
+    return dialogPath;
+}
+/**
+ * Write a skill summary file (DERIVED from skill canon).
+ */
+export function writeSkillSummaryFile(skillName, date, summaryContent, projectPath) {
+    assertSafeName(skillName);
+    const dir = skillCanonDir(projectPath, skillName);
+    ensureDir(dir);
+    // Normalize literal \n sequences to real newlines (client may send escaped strings)
+    let content = normalizeLiteralNewlines(summaryContent);
+    if (!content.includes('Derived from:')) {
+        content = `<!-- Derived from: skills/${skillName}/canon/skill-dialog.md, ${date} -->\n<!-- This is a DERIVED file — the skill dialog is the only source of truth -->\n\n${content}`;
+    }
+    const summaryPath = resolve(dir, 'skill-summary.md');
+    writeFile(summaryPath, content);
+    return summaryPath;
+}
+/**
+ * Check if a skill has a canon (is a dynamic skill).
+ */
+export function skillHasCanon(projectPath, skillName) {
+    assertSafeName(skillName);
+    const dialogPath = resolve(skillCanonDir(projectPath, skillName), 'skill-dialog.md');
+    return existsSync(dialogPath);
+}
+/**
+ * Read a skill's canon dialog.
+ */
+export function readSkillCanonDialog(projectPath, skillName) {
+    assertSafeName(skillName);
+    const dialogPath = resolve(skillCanonDir(projectPath, skillName), 'skill-dialog.md');
+    return readFileSafe(dialogPath);
+}
+/**
+ * Normalize literal \n (backslash + n) sequences to real newlines.
+ * Client LLMs sometimes send escaped strings via MCP.
+ */
+function normalizeLiteralNewlines(text) {
+    if (!text.includes('\n') && text.includes('\\n')) {
+        return text.replace(/\\n/g, '\n');
+    }
+    return text;
+}
+function formatSkillDialog(session, skillName, mode, metadata) {
+    const lines = [];
+    lines.push('# Skill DialogSpec Dialog');
+    lines.push(`<!-- Skill canon for: ${skillName} -->`);
+    lines.push('<!-- This is the canon — the verbatim dialog is the only source of truth -->');
+    lines.push('<!-- All skill files (skill.json, convergence-rules.md, translate.md, prompts/) are derived from this dialog -->');
+    lines.push('');
+    // Only add stampRaw at the top if the stamp is NOT already in the dialog messages.
+    const stampInMessages = session.stampRaw && session.messages.some((msg) => msg.content.includes('=== DIALOGSPEC STAMP ==='));
+    if (session.stampRaw && !stampInMessages) {
+        lines.push(session.stampRaw);
+        lines.push('');
+    }
+    lines.push('---');
+    lines.push('');
+    for (const msg of session.messages) {
+        const role = msg.role === 'user' ? 'HUMAN' : 'ASSISTANT';
+        lines.push(`${role}: ${msg.content}`);
+        lines.push('');
+    }
+    // Append CANON METADATA block (server-generated replay context)
+    if (metadata) {
+        lines.push('');
+        lines.push(formatCanonMetadata(metadata));
+    }
+    // Append HUMAN STAMP block (auto-approved for dialog mode, pending for full mode)
+    lines.push('');
+    lines.push(mode === 'dialog' ? createAutoApprovedHumanStamp() : createPendingHumanStamp());
+    lines.push('');
+    return lines.join('\n');
+}
+//# sourceMappingURL=canon-writer.js.map

package/dist/core/skill/canon-writer.js.map

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

package/dist/core/skill/registry.d.ts

@@ -0,0 +1,10 @@
+import type { Skill } from '../types.js';
+/**
+ * List all available skills (deduplicated by name, project > user > bundled).
+ */
+export declare function listSkills(projectPath: string, skillsDir?: string): Skill[];
+/**
+ * Get a specific skill by name.
+ */
+export declare function getSkill(name: string, projectPath: string, skillsDir?: string): Skill | null;
+//# sourceMappingURL=registry.d.ts.map

package/dist/core/skill/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/core/skill/registry.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAiB,MAAM,aAAa,CAAC;AA0FxD;;GAEG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,KAAK,EAAE,CAkB3E;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAE5F"}