@warpgogol/forge 2.1.0 → 2.2.0

package/dist/os/session/handlers/save.js

@@ -0,0 +1,297 @@
+/*
+<MODULE_CONTRACT>
+<purpose>
+session.save handler — converts raw ATIF files from docs/sessions/.raw/ to
+structured markdown in docs/sessions/ with auto-extracted metadata.
+Deterministic only — no LLM/intelligent annotation (that is fo-session-save skill).
+</purpose>
+<non-goals>
+  <item>Does not generate semantic summaries or decisions — that is the fo-session-save skill.</item>
+  <item>Does not archive sessions — that is session.archive.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0537: implement session.save command handler.</item>
+  <item>Replace fs.unlink with trashPath for raw file deletion (trash bin for LLM-initiated deletions).</item>
+</CHANGE_SUMMARY>
+*/
+import fs from "node:fs/promises";
+import path from "node:path";
+import { createHash } from "node:crypto";
+import YAML from "yaml";
+import { parseAtif, messagesToTranscriptMarkdown } from "../atif-parser.js";
+import { trashPath } from "../../../src/utils/fs-trash.js";
+import { SESSION_DIR, SESSION_RAW_SUBDIR, } from "../types.js";
+const RFC_PATTERN = /\bRFC-\d{4}\b/g;
+const FILE_PATH_PATTERN = /\b(?:packages|docs|services|systems|tools|scripts)\/[^\s"'`<>|]+/g;
+const COMMIT_HASH_PATTERN = /\b[0-9a-f]{7,40}\b/g;
+const COMMAND_PATTERN = /\b(?:session|rfc|adr|plan|audit|docs|mission|forge|compass|werkstatt|spec|naming|workflow|bordbuch|sternsystem|release)\.\w+/g;
+const TYPE_INDICATORS = [
+    { type: "grilling", patterns: [/grilling/i, /\/grilling/i, /fo-idea.*plan/i] },
+    {
+        type: "mission",
+        patterns: [/mission\.open/i, /mission\.materialize/i, /mission\.reconcile/i, /mission\.close/i],
+    },
+    {
+        type: "implementation",
+        patterns: [/rfc\.implement\.stamp/i, /implement:\s/i, /fo-idea-implement/i],
+    },
+    { type: "review", patterns: [/fo-review/i, /review:\s/i] },
+    { type: "fix", patterns: [/fo-fix/i, /fix:\s/i] },
+];
+function extractRfcIds(content) {
+    const matches = content.match(RFC_PATTERN);
+    return matches ? [...new Set(matches)] : [];
+}
+function extractFilePaths(content) {
+    const matches = content.match(FILE_PATH_PATTERN);
+    return matches ? [...new Set(matches)] : [];
+}
+function extractCommitHashes(content) {
+    const matches = content.match(COMMIT_HASH_PATTERN);
+    if (!matches)
+        return [];
+    // Filter to plausible git hashes (7-40 hex chars, but exclude pure version numbers)
+    const filtered = matches.filter((h) => {
+        // Exclude strings that look like version numbers (e.g. 1.0.0)
+        if (/^\d+$/.test(h) && h.length <= 8)
+            return false;
+        return true;
+    });
+    return [...new Set(filtered)];
+}
+function extractCommands(content) {
+    const matches = content.match(COMMAND_PATTERN);
+    return matches ? [...new Set(matches)] : [];
+}
+function detectSessionTypes(content) {
+    const detected = [];
+    for (const { type, patterns } of TYPE_INDICATORS) {
+        if (patterns.some((p) => p.test(content))) {
+            detected.push(type);
+        }
+    }
+    if (detected.length === 0) {
+        return ["freeform"];
+    }
+    return detected;
+}
+function computeSessionId(rawContent, timestamp) {
+    const hash = createHash("sha256").update(rawContent).digest("hex").slice(0, 6);
+    const parts = [
+        timestamp.getFullYear(),
+        String(timestamp.getMonth() + 1).padStart(2, "0"),
+        String(timestamp.getDate()).padStart(2, "0"),
+        String(timestamp.getHours()).padStart(2, "0"),
+        String(timestamp.getMinutes()).padStart(2, "0"),
+        String(timestamp.getSeconds()).padStart(2, "0"),
+    ];
+    return `${parts.join("-")}-${hash}`;
+}
+function extractTimestampFromContent(content) {
+    // Try to find an ISO 8601 timestamp in the content
+    const isoMatch = content.match(/\d{4}-\d{2}-\d{2}[T ]\d{2}:\d{2}:\d{2}(?:[+-]\d{2}:?\d{2}|Z)?/);
+    if (isoMatch) {
+        const date = new Date(isoMatch[0].replace(" ", "T"));
+        if (!isNaN(date.getTime()))
+            return date;
+    }
+    // Try date-only
+    const dateMatch = content.match(/\d{4}-\d{2}-\d{2}/);
+    if (dateMatch) {
+        const date = new Date(dateMatch[0] + "T00:00:00");
+        if (!isNaN(date.getTime()))
+            return date;
+    }
+    return null;
+}
+function buildSessionMarkdown(id, timestamp, types, metadata, transcriptMarkdown) {
+    const isoDate = timestamp.toISOString();
+    const frontmatter = {
+        id,
+        date: isoDate,
+        duration: null,
+        types,
+        summary: "",
+        relatedRfcs: metadata.relatedRfcs,
+        relatedArtifacts: metadata.relatedArtifacts,
+        decisions: [],
+        commits: metadata.commits,
+        files: metadata.files,
+        commands: metadata.commands,
+    };
+    const yamlStr = YAML.stringify(frontmatter, { lineWidth: 0 });
+    return `---\n${yamlStr}---\n\n# Session: ${id}\n\n## Transcript\n\n${transcriptMarkdown}\n`;
+}
+export async function runSessionSave(input, context) {
+    const { workspaceRoot, logger, outputFormat } = context;
+    const sessionDirPath = path.join(workspaceRoot, SESSION_DIR);
+    const rawDirPath = path.join(sessionDirPath, SESSION_RAW_SUBDIR);
+    const dryRun = context.dryRun || input.flags["dry-run"] === true;
+    const keepRaw = input.flags["keep-raw"] === true;
+    const rawFileFlag = input.flags["raw-file"];
+    // Determine which raw files to process
+    let rawFiles;
+    if (rawFileFlag) {
+        const resolvedPath = path.isAbsolute(rawFileFlag)
+            ? rawFileFlag
+            : path.join(workspaceRoot, rawFileFlag);
+        try {
+            await fs.access(resolvedPath);
+        }
+        catch {
+            throw new Error(`Raw file not found: ${rawFileFlag}`);
+        }
+        rawFiles = [
+            path.isAbsolute(rawFileFlag)
+                ? path.relative(rawDirPath, resolvedPath)
+                : rawFileFlag.replace(`${SESSION_DIR}/${SESSION_RAW_SUBDIR}/`, ""),
+        ];
+    }
+    else {
+        try {
+            const entries = await fs.readdir(rawDirPath, { withFileTypes: true });
+            rawFiles = entries.filter((e) => e.isFile()).map((e) => e.name);
+        }
+        catch {
+            rawFiles = [];
+        }
+    }
+    if (rawFiles.length === 0) {
+        if (outputFormat === "pretty") {
+            logger.info("No raw files to process.");
+        }
+        return {
+            data: {
+                command: "session.save",
+                status: "ok",
+                file: "",
+                rawFile: "",
+                rawDeleted: false,
+                id: "",
+                types: [],
+                extractedMetadata: {
+                    relatedRfcs: [],
+                    relatedArtifacts: [],
+                    commits: [],
+                    files: [],
+                    commands: [],
+                },
+                dryRun,
+                skipped: [],
+            },
+            summary: "No raw files to process",
+        };
+    }
+    const saved = [];
+    const skipped = [];
+    for (const rawFileName of rawFiles) {
+        const rawFilePath = path.join(rawDirPath, rawFileName);
+        let rawContent;
+        try {
+            rawContent = await fs.readFile(rawFilePath, "utf-8");
+        }
+        catch (err) {
+            if (err.code === "ENOENT") {
+                skipped.push({ rawFile: rawFileName, reason: "already processed by another process" });
+                continue;
+            }
+            throw err;
+        }
+        // Parse ATIF
+        const atifResult = parseAtif(rawContent);
+        const transcriptText = messagesToTranscriptMarkdown(atifResult.messages);
+        // Extract metadata
+        const fullContent = rawContent;
+        const relatedRfcs = extractRfcIds(fullContent);
+        const relatedArtifacts = extractFilePaths(fullContent);
+        const commits = extractCommitHashes(fullContent);
+        const files = extractFilePaths(fullContent);
+        const commands = extractCommands(fullContent);
+        const types = detectSessionTypes(fullContent);
+        // Compute session id
+        const extractedTimestamp = extractTimestampFromContent(fullContent);
+        const timestamp = extractedTimestamp ?? new Date();
+        const id = computeSessionId(rawContent, timestamp);
+        // Check if output already exists (idempotency)
+        const outputFileName = `${id}.md`;
+        const outputPath = path.join(sessionDirPath, outputFileName);
+        const outputRel = path.join(SESSION_DIR, outputFileName);
+        try {
+            await fs.access(outputPath);
+            skipped.push({ rawFile: rawFileName, reason: "already converted" });
+            if (outputFormat === "pretty") {
+                logger.info(`Skipped ${rawFileName}: already converted to ${outputRel}`);
+            }
+            continue;
+        }
+        catch {
+            // Output doesn't exist — proceed
+        }
+        // Build markdown
+        const markdown = buildSessionMarkdown(id, timestamp, types, { relatedRfcs, relatedArtifacts, commits, files, commands }, transcriptText);
+        if (!dryRun) {
+            await fs.mkdir(sessionDirPath, { recursive: true });
+            await fs.writeFile(outputPath, markdown, "utf-8");
+            // Delete raw file unless --keep-raw
+            if (!keepRaw) {
+                try {
+                    await trashPath(rawFilePath);
+                }
+                catch (err) {
+                    if (err.code !== "ENOENT") {
+                        throw err;
+                    }
+                }
+            }
+        }
+        const result = {
+            command: "session.save",
+            status: "ok",
+            file: outputRel,
+            rawFile: path.join(SESSION_DIR, SESSION_RAW_SUBDIR, rawFileName),
+            rawDeleted: !dryRun && !keepRaw,
+            id,
+            types,
+            extractedMetadata: {
+                relatedRfcs,
+                relatedArtifacts,
+                commits,
+                files,
+                commands,
+            },
+            dryRun,
+        };
+        saved.push(result);
+        if (outputFormat === "pretty") {
+            logger.success(`Saved session ${id} to ${outputRel}`);
+        }
+    }
+    const firstSaved = saved[0];
+    return {
+        data: firstSaved
+            ? { ...firstSaved, skipped }
+            : {
+                command: "session.save",
+                status: "ok",
+                file: "",
+                rawFile: "",
+                rawDeleted: false,
+                id: "",
+                types: [],
+                extractedMetadata: {
+                    relatedRfcs: [],
+                    relatedArtifacts: [],
+                    commits: [],
+                    files: [],
+                    commands: [],
+                },
+                dryRun,
+                skipped,
+            },
+        summary: dryRun
+            ? `[dry-run] Would save ${saved.length} session(s), skip ${skipped.length}`
+            : `Saved ${saved.length} session(s), skipped ${skipped.length}`,
+    };
+}
+//# sourceMappingURL=save.js.map

package/dist/os/session/handlers/save.js.map

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

package/dist/os/session/handlers/validate.d.ts

@@ -0,0 +1,4 @@
+import type { ForgeCommandInput, ForgeCommandResult, ForgeRuntimeContext } from "../../../src/types.ts";
+import { type SessionValidationResult } from "../types.ts";
+export declare function runSessionValidate(input: ForgeCommandInput, context: ForgeRuntimeContext): Promise<ForgeCommandResult<SessionValidationResult>>;
+//# sourceMappingURL=validate.d.ts.map

package/dist/os/session/handlers/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../../os/session/handlers/validate.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAML,KAAK,uBAAuB,EAE7B,MAAM,aAAa,CAAC;AAgBrB,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,uBAAuB,CAAC,CAAC,CAuKtD"}

package/dist/os/session/handlers/validate.js

@@ -0,0 +1,188 @@
+/*
+<MODULE_CONTRACT>
+<purpose>
+session.validate handler — checks session frontmatter schema (SES-01),
+id-filename match (SES-02), RFC-id existence (SES-03), raw file hygiene
+(SES-04), and non-markdown file detection (SES-05).
+</purpose>
+<non-goals>
+  <item>Does not move or modify files — that is session.archive.</item>
+  <item>Does not check transcript content quality — that is the fo-session-save skill.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0537: implement session.validate command handler.</item>
+</CHANGE_SUMMARY>
+*/
+import path from "node:path";
+import { listSessionFiles, listNonMarkdownSessionFiles, listRawFiles, readAndParseSession, } from "../frontmatter-io.js";
+import { listRfcFiles, readAndParseRfc } from "../../rfc/frontmatter-io.js";
+import { SESSION_DIR, SESSION_KNOWN_KEYS, SESSION_REQUIRED_KEYS, SESSION_TYPES, SES_RULES, } from "../types.js";
+const RFC_DIR = "docs/rfcs";
+async function loadRfcIds(workspaceRoot) {
+    const rfcIds = new Set();
+    const rfcDirPath = path.join(workspaceRoot, RFC_DIR);
+    const files = await listRfcFiles(rfcDirPath);
+    for (const fileName of files) {
+        const result = await readAndParseRfc(rfcDirPath, fileName);
+        const id = result && "parsed" in result ? String(result.parsed.frontmatter["id"] ?? "") : "";
+        if (id)
+            rfcIds.add(id);
+    }
+    return rfcIds;
+}
+export async function runSessionValidate(input, context) {
+    const { workspaceRoot, logger, outputFormat } = context;
+    const sessionDirPath = path.join(workspaceRoot, SESSION_DIR);
+    const targetId = input.flags["id"];
+    const allFiles = await listSessionFiles(sessionDirPath);
+    const filesToValidate = targetId
+        ? allFiles.filter((f) => path.basename(f).toLowerCase().startsWith(targetId.toLowerCase()))
+        : allFiles;
+    if (filesToValidate.length === 0) {
+        if (outputFormat === "pretty") {
+            logger.info("No session files found to validate.");
+        }
+        return {
+            data: {
+                command: "session.validate",
+                status: "pass",
+                violations: [],
+                checked: 0,
+            },
+            summary: "No session files found to validate",
+        };
+    }
+    const knownRfcIds = await loadRfcIds(workspaceRoot);
+    const knownKeys = new Set(SESSION_KNOWN_KEYS);
+    const violations = [];
+    for (const fileName of filesToValidate) {
+        const result = await readAndParseSession(sessionDirPath, fileName);
+        if (!result)
+            continue;
+        const fm = result.parsed.frontmatter;
+        const id = String(fm["id"] ?? "");
+        const relFile = path.join(SESSION_DIR, fileName);
+        const basename = path.basename(fileName, ".md");
+        // SES-01: Required frontmatter fields
+        for (const key of SESSION_REQUIRED_KEYS) {
+            if (!(key in fm) || fm[key] === undefined || fm[key] === null) {
+                violations.push({
+                    rule: SES_RULES.SES_01,
+                    file: relFile,
+                    message: `Required field "${key}" is missing`,
+                    severity: "error",
+                });
+            }
+        }
+        // SES-01: Check types is a valid array
+        const typesValue = fm["types"];
+        if (Array.isArray(typesValue)) {
+            for (const t of typesValue) {
+                if (!SESSION_TYPES.includes(t)) {
+                    violations.push({
+                        rule: SES_RULES.SES_01,
+                        file: relFile,
+                        message: `Invalid session type "${t}". Must be one of: ${SESSION_TYPES.join(", ")}`,
+                        severity: "error",
+                    });
+                }
+            }
+        }
+        else if (typesValue !== undefined) {
+            violations.push({
+                rule: SES_RULES.SES_01,
+                file: relFile,
+                message: `Field "types" must be an array`,
+                severity: "error",
+            });
+        }
+        // SES-01: Warn on unknown keys
+        for (const key of Object.keys(fm)) {
+            if (!knownKeys.has(key)) {
+                violations.push({
+                    rule: SES_RULES.SES_01,
+                    file: relFile,
+                    message: `Unknown frontmatter key "${key}"`,
+                    severity: "warning",
+                });
+            }
+        }
+        // SES-02: id matches filename
+        if (id && id !== basename) {
+            violations.push({
+                rule: SES_RULES.SES_02,
+                file: relFile,
+                message: `id "${id}" does not match filename "${basename}"`,
+                severity: "error",
+            });
+        }
+        // SES-03: relatedRfcs reference existing RFCs
+        const relatedRfcs = Array.isArray(fm["relatedRfcs"]) ? fm["relatedRfcs"] : [];
+        for (const rfcId of relatedRfcs) {
+            if (!knownRfcIds.has(rfcId)) {
+                violations.push({
+                    rule: SES_RULES.SES_03,
+                    file: relFile,
+                    message: `relatedRfcs references non-existent RFC "${rfcId}"`,
+                    severity: "error",
+                });
+            }
+        }
+    }
+    // SES-04: Raw files in .raw/ that haven't been processed (warning)
+    const rawFiles = await listRawFiles(sessionDirPath);
+    for (const rawFile of rawFiles) {
+        violations.push({
+            rule: SES_RULES.SES_04,
+            file: path.join(SESSION_DIR, ".raw", rawFile),
+            message: `Unprocessed raw file in .raw/ — run session.save to convert`,
+            severity: "warning",
+        });
+    }
+    // SES-05: Non-markdown files in docs/sessions/ (excluding .raw/ and archive/)
+    const nonMdFiles = await listNonMarkdownSessionFiles(sessionDirPath);
+    for (const nonMdFile of nonMdFiles) {
+        violations.push({
+            rule: SES_RULES.SES_05,
+            file: path.join(SESSION_DIR, nonMdFile),
+            message: `Non-markdown file in docs/sessions/ — only .md files are allowed (excluding .raw/ and archive/)`,
+            severity: "error",
+        });
+    }
+    const hasErrors = violations.some((v) => v.severity === "error");
+    const resultStatus = hasErrors ? "fail" : "pass";
+    if (outputFormat === "pretty") {
+        if (violations.length === 0) {
+            logger.success(`All ${filesToValidate.length} session file(s) passed validation.`);
+        }
+        else {
+            logger.section(`Session Validation (${filesToValidate.length} file(s))`);
+            for (const v of violations) {
+                const prefix = v.severity === "error" ? "ERROR" : "WARN";
+                logger[v.severity === "error" ? "error" : "warn"](`[${prefix}] ${v.rule}: ${v.file}: ${v.message}`);
+            }
+            const errorCount = violations.filter((v) => v.severity === "error").length;
+            const warnCount = violations.filter((v) => v.severity === "warning").length;
+            if (errorCount > 0) {
+                logger.error(`${errorCount} error(s), ${warnCount} warning(s)`);
+            }
+            else {
+                logger.warn(`${warnCount} warning(s), 0 errors — passed`);
+            }
+        }
+    }
+    return {
+        data: {
+            command: "session.validate",
+            status: resultStatus,
+            violations,
+            checked: filesToValidate.length,
+        },
+        exitCode: hasErrors ? 1 : 0,
+        summary: hasErrors
+            ? `${violations.filter((v) => v.severity === "error").length} error(s) found`
+            : `All ${filesToValidate.length} session file(s) passed validation`,
+    };
+}
+//# sourceMappingURL=validate.js.map

package/dist/os/session/handlers/validate.js.map

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

package/dist/os/session/index.d.ts

@@ -0,0 +1,9 @@
+export { forgeSessionModule } from "./session.module.ts";
+export { runSessionSave } from "./handlers/save.ts";
+export { runSessionArchive } from "./handlers/archive.ts";
+export { runSessionValidate } from "./handlers/validate.ts";
+export { runSessionList } from "./handlers/list.ts";
+export { parseSessionFile, listSessionFiles, listArchivedSessionFiles, readAndParseSession, listNonMarkdownSessionFiles, listRawFiles, type ParsedSession, } from "./frontmatter-io.ts";
+export { parseAtif, messagesToTranscriptMarkdown, type AtifMessage, type AtifParseResult, } from "./atif-parser.ts";
+export { SESSION_DIR, SESSION_RAW_SUBDIR, SESSION_ARCHIVE_SUBDIR, SESSION_TYPES, SES_RULES, type SessionType, type SessionFrontmatter, type SessionSaveResult, type SessionArchiveResult, type SessionArchiveMove, type SessionArchiveSkip, type SessionValidationResult, type SessionValidationViolation, type SessionListResult, type SessionListEntry, type SesRule, } from "./types.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/os/session/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../os/session/index.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,wBAAwB,EACxB,mBAAmB,EACnB,2BAA2B,EAC3B,YAAY,EACZ,KAAK,aAAa,GACnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,SAAS,EACT,4BAA4B,EAC5B,KAAK,WAAW,EAChB,KAAK,eAAe,GACrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,sBAAsB,EACtB,aAAa,EACb,SAAS,EACT,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,0BAA0B,EAC/B,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,OAAO,GACb,MAAM,YAAY,CAAC"}

package/dist/os/session/index.js

@@ -0,0 +1,20 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Barrel export for the session domain — types, module, and handlers.</purpose>
+<non-goals>
+  <item>Do not implement session logic here; delegate to handlers/ and session.module.ts.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0537: initial session module barrel.</item>
+</CHANGE_SUMMARY>
+*/
+export { forgeSessionModule } from "./session.module.js";
+export { runSessionSave } from "./handlers/save.js";
+export { runSessionArchive } from "./handlers/archive.js";
+export { runSessionValidate } from "./handlers/validate.js";
+export { runSessionList } from "./handlers/list.js";
+export { parseSessionFile, listSessionFiles, listArchivedSessionFiles, readAndParseSession, listNonMarkdownSessionFiles, listRawFiles, } from "./frontmatter-io.js";
+export { parseAtif, messagesToTranscriptMarkdown, } from "./atif-parser.js";
+export { SESSION_DIR, SESSION_RAW_SUBDIR, SESSION_ARCHIVE_SUBDIR, SESSION_TYPES, SES_RULES, } from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/os/session/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../os/session/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;EAUE;AAEF,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,wBAAwB,EACxB,mBAAmB,EACnB,2BAA2B,EAC3B,YAAY,GAEb,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,SAAS,EACT,4BAA4B,GAG7B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,sBAAsB,EACtB,aAAa,EACb,SAAS,GAYV,MAAM,YAAY,CAAC"}

package/dist/os/session/session.module.d.ts

@@ -0,0 +1,3 @@
+import type { ForgeModule } from "../../src/forge-module.ts";
+export declare const forgeSessionModule: ForgeModule;
+//# sourceMappingURL=session.module.d.ts.map

package/dist/os/session/session.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.module.d.ts","sourceRoot":"","sources":["../../../os/session/session.module.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE7D,eAAO,MAAM,kBAAkB,EAAE,WA+GhC,CAAC"}