briefops 1.0.0

package/dist/core/memoryProposal.js

@@ -0,0 +1,279 @@
+import { randomBytes } from "node:crypto";
+import path from "node:path";
+import { BriefOpsError } from "./errors.js";
+import { readWorkLog } from "./log.js";
+import { withWorkspaceLock } from "./lock.js";
+import { addMemoryIfMissingUnlocked } from "./memory.js";
+import { formatDateStamp, normalizeName, slugForFilename, workspacePaths } from "./paths.js";
+import { listFilesBySuffix, readTextFile, writeYamlFile } from "./storage.js";
+import { requireWorkspace } from "./workspace.js";
+import { memoryProposalSchema } from "../schemas/memoryProposal.js";
+import YAML from "yaml";
+export const NO_MEMORY_PROPOSAL_CANDIDATES_PREFIX = "No memory proposal candidates found in log:";
+export function isNoMemoryProposalCandidatesError(error) {
+    return error instanceof BriefOpsError &&
+        error.message.startsWith(NO_MEMORY_PROPOSAL_CANDIDATES_PREFIX);
+}
+function proposalId(date = new Date()) {
+    return `memprop_${formatDateStamp(date)}_${randomBytes(3).toString("hex")}`;
+}
+const tagKeywords = [
+    "turnover",
+    "slippage",
+    "risk",
+    "rebalance",
+    "policy",
+    "test",
+    "release",
+    "billing",
+    "localization",
+    "security",
+    "performance",
+    "migration"
+];
+function tagsFromText(value) {
+    const lower = value.toLowerCase();
+    const tags = tagKeywords.filter((tag) => lower.includes(tag));
+    return [...new Set(tags)];
+}
+function extractPrefixedNotes(notes, prefix) {
+    return notes
+        .split(/\r?\n/)
+        .map((line) => line.trim())
+        .filter((line) => line.toLowerCase().startsWith(`${prefix}:`))
+        .map((line) => line.slice(prefix.length + 1).trim())
+        .filter(Boolean)
+        .map((content) => ({
+        category: prefix === "decision" ? "decisions" : "facts",
+        type: prefix,
+        status: "active",
+        content,
+        tags: tagsFromText(content),
+        visibility: "private",
+        exportable: false,
+        rationale: `Extracted from work log note prefix: ${prefix}.`
+    }));
+}
+function isIncidentCandidate(result) {
+    return /\b(missing|missed|failed|blocked|unverified|risk|violation|regression|incident|error|bug|failure)\b/i.test(result);
+}
+function isNormativeNextStep(value) {
+    return /\b(must|always|never|require|requires|required|policy|verify|check)\b/i.test(value);
+}
+function entry(options) {
+    const category = {
+        fact: "facts",
+        decision: "decisions",
+        lesson: "lessons",
+        incident: "incidents",
+        deprecated: "deprecated"
+    }[options.type];
+    return {
+        category,
+        type: options.type,
+        status: "active",
+        content: options.content.trim(),
+        source: options.source,
+        tags: tagsFromText(options.content),
+        visibility: "private",
+        exportable: false,
+        rationale: options.rationale
+    };
+}
+async function writeProposal(cwd, proposal) {
+    const filePath = path.join(workspacePaths(cwd).memoryProposals, `${proposal.id}-${slugForFilename(proposal.project ?? "global")}-${slugForFilename(proposal.worker ?? proposal.skill ?? "memory")}.memory-proposal.yaml`);
+    await writeYamlFile(filePath, proposal);
+    return filePath;
+}
+export async function proposeMemoryFromLog(options) {
+    const cwd = options.cwd ?? process.cwd();
+    return withWorkspaceLock({ cwd, name: "memory-proposal" }, async () => proposeMemoryFromLogUnlocked({
+        ...options,
+        cwd
+    }));
+}
+async function proposeMemoryFromLogUnlocked(options) {
+    const cwd = options.cwd ?? process.cwd();
+    await requireWorkspace(cwd);
+    const log = await readWorkLog(cwd, options.fromLog);
+    const createdAt = new Date().toISOString();
+    const proposals = [
+        ...log.lessons.map((lesson) => entry({
+            type: "lesson",
+            content: lesson,
+            source: log.id,
+            rationale: "Extracted from work log lesson."
+        })),
+        ...log.open_risks.map((risk) => entry({
+            type: "incident",
+            content: risk,
+            source: log.id,
+            rationale: "Extracted from work log open risk."
+        })),
+        ...log.decisions.map((decision) => entry({
+            type: "decision",
+            content: decision,
+            source: log.id,
+            rationale: "Extracted from work log decision."
+        })),
+        ...log.incidents.map((incident) => entry({
+            type: "incident",
+            content: incident,
+            source: log.id,
+            rationale: "Extracted from work log incident."
+        })),
+        ...log.next_steps
+            .filter(isNormativeNextStep)
+            .map((step) => entry({
+            type: "decision",
+            content: step,
+            source: log.id,
+            rationale: "Extracted from normative work log next step."
+        })),
+        ...extractPrefixedNotes(log.notes, "decision"),
+        ...extractPrefixedNotes(log.notes, "fact")
+    ];
+    if (isIncidentCandidate(log.result)) {
+        proposals.push(entry({
+            type: "incident",
+            content: log.result,
+            source: log.id,
+            rationale: "Extracted from work log result because it contains failure/risk language."
+        }));
+    }
+    if (proposals.length === 0) {
+        throw new BriefOpsError(`${NO_MEMORY_PROPOSAL_CANDIDATES_PREFIX} ${log.id}`);
+    }
+    const proposal = memoryProposalSchema.parse({
+        id: proposalId(new Date(createdAt)),
+        created_at: createdAt,
+        from_log: log.id,
+        status: "proposed",
+        project: log.project,
+        skill: log.skill,
+        worker: log.worker,
+        items: proposals
+    });
+    return {
+        path: await writeProposal(cwd, proposal),
+        proposal
+    };
+}
+export async function readMemoryProposal(cwd, id) {
+    await requireWorkspace(cwd);
+    const normalized = id.trim().toLowerCase();
+    try {
+        const files = await listFilesBySuffix(workspacePaths(cwd).memoryProposals, ".memory-proposal.yaml");
+        const filePath = normalized === "latest"
+            ? [...files].sort().at(-1)
+            : files.find((file) => path.basename(file).startsWith(normalizeName(id)));
+        if (!filePath) {
+            throw new BriefOpsError(`Memory proposal not found: ${id}`);
+        }
+        const parsed = YAML.parse(await readTextFile(filePath));
+        const result = memoryProposalSchema.safeParse(parsed);
+        if (!result.success) {
+            throw new BriefOpsError(`Invalid memory proposal ${filePath}: ${result.error.message}`);
+        }
+        return result.data;
+    }
+    catch (error) {
+        if (error instanceof BriefOpsError && error.message.startsWith("File not found")) {
+            throw new BriefOpsError(`Memory proposal not found: ${id}`);
+        }
+        throw error;
+    }
+}
+export async function readLatestProposedMemoryProposal(cwd = process.cwd()) {
+    const proposals = await listMemoryProposals({
+        cwd,
+        status: "proposed"
+    });
+    const latest = proposals[0];
+    if (!latest) {
+        throw new BriefOpsError("No proposed memory proposals found.");
+    }
+    return latest;
+}
+export async function listMemoryProposals(filters = {}) {
+    const cwd = filters.cwd ?? process.cwd();
+    await requireWorkspace(cwd);
+    const project = filters.project ? normalizeName(filters.project) : undefined;
+    const skill = filters.skill ? normalizeName(filters.skill) : undefined;
+    const files = await listFilesBySuffix(workspacePaths(cwd).memoryProposals, ".memory-proposal.yaml");
+    const proposals = await Promise.all(files.map(async (filePath) => {
+        const parsed = YAML.parse(await readTextFile(filePath));
+        const result = memoryProposalSchema.safeParse(parsed);
+        if (!result.success) {
+            throw new BriefOpsError(`Invalid memory proposal ${filePath}: ${result.error.message}`);
+        }
+        return result.data;
+    }));
+    return proposals
+        .filter((proposal) => (filters.status ? proposal.status === filters.status : true))
+        .filter((proposal) => (project ? proposal.project === project : true))
+        .filter((proposal) => (skill ? proposal.skill === skill : true))
+        .sort((a, b) => b.created_at.localeCompare(a.created_at));
+}
+export async function applyMemoryProposal(options) {
+    const cwd = options.cwd ?? process.cwd();
+    return withWorkspaceLock({ cwd, name: "memory" }, async () => applyMemoryProposalUnlocked({
+        ...options,
+        cwd
+    }));
+}
+export async function applyMemoryProposalUnlocked(options) {
+    const cwd = options.cwd ?? process.cwd();
+    const proposal = options.id.trim().toLowerCase() === "latest"
+        ? await readLatestProposedMemoryProposal(cwd)
+        : await readMemoryProposal(cwd, options.id);
+    if (proposal.status !== "proposed") {
+        throw new BriefOpsError(`Memory proposal is already ${proposal.status}: ${proposal.id}`);
+    }
+    let created = 0;
+    let skipped = 0;
+    for (const entry of proposal.items) {
+        const result = await addMemoryIfMissingUnlocked({
+            cwd,
+            type: entry.type,
+            project: proposal.project,
+            skill: proposal.skill,
+            content: entry.content,
+            status: entry.status,
+            tags: entry.tags,
+            source: entry.source ?? proposal.from_log,
+            visibility: entry.visibility,
+            exportable: entry.exportable
+        });
+        if (result.created) {
+            created += 1;
+        }
+        else {
+            skipped += 1;
+        }
+    }
+    const updated = {
+        ...proposal,
+        status: "applied",
+        applied_at: new Date().toISOString()
+    };
+    await writeProposal(cwd, updated);
+    return { proposal: updated, created, skipped };
+}
+export async function rejectMemoryProposal(options) {
+    const cwd = options.cwd ?? process.cwd();
+    return withWorkspaceLock({ cwd, name: "memory" }, async () => {
+        const proposal = await readMemoryProposal(cwd, options.id);
+        if (proposal.status !== "proposed") {
+            throw new BriefOpsError(`Memory proposal is already ${proposal.status}: ${proposal.id}`);
+        }
+        const updated = {
+            ...proposal,
+            status: "rejected",
+            rejected_at: new Date().toISOString()
+        };
+        await writeProposal(cwd, updated);
+        return updated;
+    });
+}
+//# sourceMappingURL=memoryProposal.js.map

package/dist/core/memoryProposal.js.map

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

package/dist/core/output.d.ts

@@ -0,0 +1,7 @@
+export declare function writeGeneratedOutput(options: {
+    defaultPath: string;
+    outputPath?: string;
+    content: string;
+    force?: boolean;
+}): Promise<string>;
+export declare function resolveCliOutputPath(cwd: string, value?: string): string | undefined;

package/dist/core/output.js

@@ -0,0 +1,18 @@
+import path from "node:path";
+import { BriefOpsError } from "./errors.js";
+import { pathExists, writeTextFile } from "./storage.js";
+export async function writeGeneratedOutput(options) {
+    const targetPath = options.outputPath ?? options.defaultPath;
+    const isExplicit = Boolean(options.outputPath);
+    if (isExplicit && !options.force && await pathExists(targetPath)) {
+        throw new BriefOpsError(`Output file already exists: ${targetPath}. Re-run with --force to overwrite.`);
+    }
+    await writeTextFile(targetPath, options.content, {
+        force: !isExplicit || Boolean(options.force)
+    });
+    return targetPath;
+}
+export function resolveCliOutputPath(cwd, value) {
+    return value ? path.resolve(cwd, value) : undefined;
+}
+//# sourceMappingURL=output.js.map

package/dist/core/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/core/output.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAEzD,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,OAK1C;IACC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,WAAW,CAAC;IAC7D,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAE/C,IAAI,UAAU,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,MAAM,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACjE,MAAM,IAAI,aAAa,CACrB,+BAA+B,UAAU,qCAAqC,CAC/E,CAAC;IACJ,CAAC;IAED,MAAM,aAAa,CAAC,UAAU,EAAE,OAAO,CAAC,OAAO,EAAE;QAC/C,KAAK,EAAE,CAAC,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC;KAC7C,CAAC,CAAC;IACH,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,GAAW,EAAE,KAAc;IAC9D,OAAO,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACtD,CAAC"}

package/dist/core/patch.d.ts

@@ -0,0 +1,37 @@
+import { type SkillPatch } from "../schemas/patch.js";
+export type ProposeSkillPatchOptions = {
+    cwd?: string;
+    skill: string;
+    fromLog?: string;
+};
+export declare const NO_SKILL_PATCH_CANDIDATES_PREFIX = "No skill patch candidates found in log:";
+export declare function isNoSkillPatchCandidatesError(error: unknown): boolean;
+export declare function renderSkillPatchDiff(patch: SkillPatch): string;
+export declare function proposeSkillPatch(options: ProposeSkillPatchOptions): Promise<{
+    path: string;
+    patch: SkillPatch;
+    diff: string;
+}>;
+export declare function readSkillPatch(cwd: string, id: string): Promise<SkillPatch>;
+export declare function readLatestProposedSkillPatch(cwd?: string): Promise<SkillPatch>;
+export declare function listSkillPatches(cwd?: string): Promise<SkillPatch[]>;
+export declare function applySkillPatch(options: {
+    cwd?: string;
+    skill: string;
+    patch: string;
+}): Promise<{
+    patch: SkillPatch;
+    skillPath: string;
+}>;
+export declare function applySkillPatchUnlocked(options: {
+    cwd?: string;
+    skill: string;
+    patch: string;
+}): Promise<{
+    patch: SkillPatch;
+    skillPath: string;
+}>;
+export declare function rejectSkillPatch(options: {
+    cwd?: string;
+    patch: string;
+}): Promise<SkillPatch>;

package/dist/core/patch.js

@@ -0,0 +1,220 @@
+import { randomBytes } from "node:crypto";
+import path from "node:path";
+import { BriefOpsError } from "./errors.js";
+import { withWorkspaceLock } from "./lock.js";
+import { readWorkLog } from "./log.js";
+import { normalizeName, skillFilePath, skillPatchFilePath, workspacePaths } from "./paths.js";
+import { readSkill } from "./skill.js";
+import { listFilesBySuffix, readTextFile, stringifyMarkdownWithFrontmatter, writeTextFile, writeYamlFile } from "./storage.js";
+import { requireWorkspace } from "./workspace.js";
+import { skillPatchSchema } from "../schemas/patch.js";
+import YAML from "yaml";
+export const NO_SKILL_PATCH_CANDIDATES_PREFIX = "No skill patch candidates found in log:";
+export function isNoSkillPatchCandidatesError(error) {
+    return error instanceof BriefOpsError &&
+        error.message.startsWith(NO_SKILL_PATCH_CANDIDATES_PREFIX);
+}
+function patchId(date = new Date()) {
+    return `patch_${date.toISOString().replace(/[-:.TZ]/g, "").slice(0, 17)}_${randomBytes(3).toString("hex")}`;
+}
+function bumpPatchVersion(version) {
+    const match = version.match(/^(\d+)\.(\d+)\.(\d+)(.*)$/);
+    if (!match) {
+        return `${version}.1`;
+    }
+    return `${match[1]}.${match[2]}.${Number(match[3]) + 1}${match[4] ?? ""}`;
+}
+function normalizeAddition(lesson) {
+    const content = lesson.trim().replace(/^\-\s+/, "");
+    return `- ${content}`;
+}
+function insertAdditionsIntoSection(body, section, additions) {
+    const lines = body.split(/\r?\n/);
+    const headingPattern = new RegExp(`^##\\s+${section.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}\\s*$`, "i");
+    const start = lines.findIndex((line) => headingPattern.test(line.trim()));
+    const missing = additions.filter((addition) => {
+        const content = addition.replace(/^\-\s+/, "");
+        return !body.includes(addition) && !body.includes(content);
+    });
+    if (missing.length === 0) {
+        return body;
+    }
+    if (start === -1) {
+        return [body.trimEnd(), "", `## ${section}`, "", ...missing].join("\n");
+    }
+    const endOffset = lines.slice(start + 1).findIndex((line) => /^##\s+/.test(line.trim()));
+    const end = endOffset === -1 ? lines.length : start + 1 + endOffset;
+    const before = lines.slice(0, end);
+    const after = lines.slice(end);
+    const needsBlank = before[before.length - 1]?.trim() !== "";
+    const needsTrailingBlank = after.length > 0 && after[0]?.trim() !== "";
+    return [
+        ...before,
+        ...(needsBlank ? [""] : []),
+        ...missing,
+        ...(needsTrailingBlank ? [""] : []),
+        ...after
+    ].join("\n").trim();
+}
+function appendChangelog(body, patch) {
+    const entry = `- ${new Date().toISOString()}: applied ${patch.id} from ${patch.from_log}`;
+    if (/^##\s+Changelog\s*$/im.test(body)) {
+        return insertAdditionsIntoSection(body, "Changelog", [entry]);
+    }
+    return [body.trimEnd(), "", "## Changelog", "", entry].join("\n");
+}
+async function writeSkillPatch(cwd, patch) {
+    const filePath = skillPatchFilePath(cwd, patch.id);
+    await writeYamlFile(filePath, patch);
+    return filePath;
+}
+export function renderSkillPatchDiff(patch) {
+    return [
+        `Suggested patch for ${patch.skill}.skill.md`,
+        "",
+        `## ${patch.target_section}`,
+        "",
+        ...patch.additions.map((addition) => `+ ${addition}`),
+        ""
+    ].join("\n");
+}
+export async function proposeSkillPatch(options) {
+    const cwd = options.cwd ?? process.cwd();
+    return withWorkspaceLock({ cwd, name: "skill-patch" }, async () => proposeSkillPatchUnlocked({
+        ...options,
+        cwd
+    }));
+}
+async function proposeSkillPatchUnlocked(options) {
+    const cwd = options.cwd ?? process.cwd();
+    await requireWorkspace(cwd);
+    const skill = normalizeName(options.skill);
+    await readSkill(cwd, skill);
+    const log = await readWorkLog(cwd, options.fromLog ?? "latest");
+    const lessons = log.lessons.map((lesson) => lesson.trim()).filter(Boolean);
+    if (log.skill && log.skill !== skill) {
+        throw new BriefOpsError(`Work log ${log.id} is linked to skill ${log.skill}, not ${skill}.`);
+    }
+    if (lessons.length === 0) {
+        throw new BriefOpsError(`${NO_SKILL_PATCH_CANDIDATES_PREFIX} ${log.id}`);
+    }
+    const createdAt = new Date();
+    const patch = skillPatchSchema.parse({
+        id: patchId(createdAt),
+        created_at: createdAt.toISOString(),
+        skill,
+        from_log: log.id,
+        status: "proposed",
+        target_section: "Check",
+        lessons,
+        additions: lessons.map(normalizeAddition)
+    });
+    const filePath = await writeSkillPatch(cwd, patch);
+    return {
+        path: filePath,
+        patch,
+        diff: renderSkillPatchDiff(patch)
+    };
+}
+export async function readSkillPatch(cwd, id) {
+    await requireWorkspace(cwd);
+    const normalized = id.trim().toLowerCase();
+    try {
+        const files = await listFilesBySuffix(workspacePaths(cwd).patches, ".patch.yaml");
+        const filePath = normalized === "latest"
+            ? [...files].sort().at(-1)
+            : files.find((file) => path.basename(file).startsWith(normalizeName(id)));
+        if (!filePath) {
+            throw new BriefOpsError(`Skill patch not found: ${id}`);
+        }
+        const raw = await readTextFile(filePath);
+        const parsed = YAML.parse(raw);
+        const result = skillPatchSchema.safeParse(parsed);
+        if (!result.success) {
+            throw new BriefOpsError(`Invalid skill patch ${filePath}: ${result.error.message}`);
+        }
+        return result.data;
+    }
+    catch (error) {
+        if (error instanceof BriefOpsError && error.message.startsWith("File not found")) {
+            throw new BriefOpsError(`Skill patch not found: ${id}`);
+        }
+        throw error;
+    }
+}
+export async function readLatestProposedSkillPatch(cwd = process.cwd()) {
+    const patches = (await listSkillPatches(cwd)).filter((patch) => patch.status === "proposed");
+    const latest = patches[0];
+    if (!latest) {
+        throw new BriefOpsError("No proposed skill patches found.");
+    }
+    return latest;
+}
+export async function listSkillPatches(cwd = process.cwd()) {
+    await requireWorkspace(cwd);
+    const files = await listFilesBySuffix(workspacePaths(cwd).patches, ".patch.yaml");
+    const patches = await Promise.all(files.map(async (filePath) => {
+        const raw = await readTextFile(filePath);
+        const parsed = YAML.parse(raw);
+        const result = skillPatchSchema.safeParse(parsed);
+        if (!result.success) {
+            throw new BriefOpsError(`Invalid skill patch ${filePath}: ${result.error.message}`);
+        }
+        return result.data;
+    }));
+    return patches.sort((a, b) => b.created_at.localeCompare(a.created_at));
+}
+export async function applySkillPatch(options) {
+    const cwd = options.cwd ?? process.cwd();
+    return withWorkspaceLock({ cwd, name: "skill-patch" }, async () => applySkillPatchUnlocked({
+        ...options,
+        cwd
+    }));
+}
+export async function applySkillPatchUnlocked(options) {
+    const cwd = options.cwd ?? process.cwd();
+    const skillName = normalizeName(options.skill);
+    const patch = options.patch.trim().toLowerCase() === "latest"
+        ? await readLatestProposedSkillPatch(cwd)
+        : await readSkillPatch(cwd, options.patch);
+    if (patch.skill !== skillName) {
+        throw new BriefOpsError(`Patch ${patch.id} targets ${patch.skill}, not ${skillName}.`);
+    }
+    if (patch.status !== "proposed") {
+        throw new BriefOpsError(`Patch ${patch.id} is already ${patch.status}.`);
+    }
+    const skill = await readSkill(cwd, skillName);
+    const patchedBody = appendChangelog(insertAdditionsIntoSection(skill.body, patch.target_section, patch.additions), patch);
+    const nextData = {
+        ...skill.data,
+        version: bumpPatchVersion(skill.data.version)
+    };
+    const skillPath = skillFilePath(cwd, skillName);
+    await writeTextFile(skillPath, stringifyMarkdownWithFrontmatter(nextData, patchedBody), {
+        force: true
+    });
+    const appliedPatch = skillPatchSchema.parse({
+        ...patch,
+        status: "applied",
+        applied_at: new Date().toISOString()
+    });
+    await writeSkillPatch(cwd, appliedPatch);
+    return { patch: appliedPatch, skillPath };
+}
+export async function rejectSkillPatch(options) {
+    const cwd = options.cwd ?? process.cwd();
+    return withWorkspaceLock({ cwd, name: "skill-patch" }, async () => {
+        const patch = await readSkillPatch(cwd, options.patch);
+        if (patch.status !== "proposed") {
+            throw new BriefOpsError(`Patch ${patch.id} is already ${patch.status}.`);
+        }
+        const rejectedPatch = skillPatchSchema.parse({
+            ...patch,
+            status: "rejected",
+            rejected_at: new Date().toISOString()
+        });
+        await writeSkillPatch(cwd, rejectedPatch);
+        return rejectedPatch;
+    });
+}
+//# sourceMappingURL=patch.js.map

package/dist/core/patch.js.map

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

package/dist/core/paths.d.ts

@@ -0,0 +1,33 @@
+export declare const memoryCategories: readonly ["facts", "decisions", "lessons", "incidents", "deprecated"];
+export type MemoryCategory = (typeof memoryCategories)[number];
+export declare function normalizeName(name: string): string;
+export declare function workspacePaths(cwd?: string): {
+    cwd: string;
+    root: string;
+    config: string;
+    skills: string;
+    projects: string;
+    memory: string;
+    memoryProposals: string;
+    workers: string;
+    workerSummaries: string;
+    logs: string;
+    handoffs: string;
+    briefs: string;
+    codex: string;
+    codexPrompts: string;
+    evals: string;
+    evalResults: string;
+    patches: string;
+    templates: string;
+};
+export declare function skillFilePath(cwd: string, name: string): string;
+export declare function projectFilePath(cwd: string, name: string): string;
+export declare function memoryFilePath(cwd: string, category: MemoryCategory): string;
+export declare function memoryProposalFilePath(cwd: string, id: string): string;
+export declare function workerFilePath(cwd: string, name: string): string;
+export declare function workerSummaryFilePath(cwd: string, name: string): string;
+export declare function evalCaseFilePath(cwd: string, name: string): string;
+export declare function skillPatchFilePath(cwd: string, id: string): string;
+export declare function formatDateStamp(date?: Date): string;
+export declare function slugForFilename(value: string): string;