briefops 1.0.0

package/dist/core/memory.js

@@ -0,0 +1,353 @@
+import { randomBytes } from "node:crypto";
+import { BriefOpsError } from "./errors.js";
+import { withWorkspaceLock } from "./lock.js";
+import { memoryCategories, memoryFilePath, normalizeName } from "./paths.js";
+import { estimateTokens } from "./tokens.js";
+import { parseCommaList, readYamlFile, writeYamlFile } from "./storage.js";
+import { requireWorkspace } from "./workspace.js";
+import { memoryFileSchema, memoryItemSchema, memoryStatuses, memoryVisibilities } from "../schemas/memory.js";
+const categoryToItemType = {
+    facts: "fact",
+    decisions: "decision",
+    lessons: "lesson",
+    incidents: "incident",
+    deprecated: "deprecated"
+};
+const singularToCategory = {
+    fact: "facts",
+    decision: "decisions",
+    lesson: "lessons",
+    incident: "incidents",
+    deprecated: "deprecated"
+};
+export function normalizeMemoryCategory(value) {
+    const normalized = value.trim().toLowerCase();
+    if (memoryCategories.includes(normalized)) {
+        return normalized;
+    }
+    const singular = singularToCategory[normalized];
+    if (singular) {
+        return singular;
+    }
+    throw new BriefOpsError(`Invalid memory type: ${value}`);
+}
+export function normalizeMemoryStatus(value) {
+    const status = (value ?? "active").trim().toLowerCase();
+    if (memoryStatuses.includes(status)) {
+        return status;
+    }
+    throw new BriefOpsError(`Invalid memory status: ${value}`);
+}
+export function normalizeMemoryVisibility(value) {
+    const visibility = (value ?? "private").trim().toLowerCase();
+    if (memoryVisibilities.includes(visibility)) {
+        return visibility;
+    }
+    throw new BriefOpsError(`Invalid memory visibility: ${value}`);
+}
+async function readMemoryFile(cwd, category) {
+    return readYamlFile(memoryFilePath(cwd, category), memoryFileSchema, { items: [] });
+}
+async function writeMemoryFile(cwd, category, memoryFile) {
+    await writeYamlFile(memoryFilePath(cwd, category), memoryFile);
+}
+export async function addMemoryIfMissing(options) {
+    const cwd = options.cwd ?? process.cwd();
+    return withWorkspaceLock({ cwd, name: "memory" }, async () => addMemoryIfMissingUnlocked({
+        ...options,
+        cwd
+    }));
+}
+export async function addMemoryIfMissingUnlocked(options) {
+    const cwd = options.cwd ?? process.cwd();
+    await requireWorkspace(cwd);
+    const category = normalizeMemoryCategory(options.type);
+    const project = options.project ? normalizeName(options.project) : undefined;
+    const skill = options.skill ? normalizeName(options.skill) : undefined;
+    const content = options.content.trim();
+    const existing = (await readMemoryFile(cwd, category)).items.find((item) => item.project === project &&
+        item.skill === skill &&
+        item.type === categoryToItemType[category] &&
+        item.content.trim().toLowerCase() === content.toLowerCase());
+    if (existing) {
+        return { item: existing, created: false };
+    }
+    return {
+        item: await addMemoryUnlocked({
+            ...options,
+            cwd
+        }),
+        created: true
+    };
+}
+export async function addMemory(options) {
+    const cwd = options.cwd ?? process.cwd();
+    return withWorkspaceLock({ cwd, name: "memory" }, async () => addMemoryUnlocked({
+        ...options,
+        cwd
+    }));
+}
+export async function addMemoryUnlocked(options) {
+    const cwd = options.cwd ?? process.cwd();
+    await requireWorkspace(cwd);
+    const category = normalizeMemoryCategory(options.type);
+    const memoryFile = await readMemoryFile(cwd, category);
+    const tags = Array.isArray(options.tags) ? options.tags : parseCommaList(options.tags);
+    const createdAt = new Date().toISOString();
+    const item = memoryItemSchema.parse({
+        id: `mem_${createdAt.replace(/[-:.TZ]/g, "").slice(0, 17)}_${randomBytes(3).toString("hex")}`,
+        type: categoryToItemType[category],
+        status: normalizeMemoryStatus(options.status),
+        project: options.project ? normalizeName(options.project) : undefined,
+        skill: options.skill ? normalizeName(options.skill) : undefined,
+        content: options.content.trim(),
+        source: options.source ?? "manual",
+        created_at: createdAt,
+        tags,
+        visibility: normalizeMemoryVisibility(options.visibility),
+        exportable: options.exportable ?? false
+    });
+    memoryFile.items.push(item);
+    await writeMemoryFile(cwd, category, memoryFile);
+    return item;
+}
+export async function listMemory(filters = {}) {
+    const cwd = filters.cwd ?? process.cwd();
+    await requireWorkspace(cwd);
+    const categories = filters.type
+        ? [normalizeMemoryCategory(filters.type)]
+        : [...memoryCategories];
+    const status = filters.status ? normalizeMemoryStatus(filters.status) : undefined;
+    const project = filters.project ? normalizeName(filters.project) : undefined;
+    const skill = filters.skill ? normalizeName(filters.skill) : undefined;
+    const tag = filters.tag?.trim();
+    const items = (await Promise.all(categories.map((category) => readMemoryFile(cwd, category)))).flatMap((file) => file.items);
+    return items
+        .filter((item) => (project ? item.project === project : true))
+        .filter((item) => (skill ? item.skill === skill : true))
+        .filter((item) => (status ? item.status === status : true))
+        .filter((item) => (tag ? item.tags.includes(tag) : true))
+        .sort((a, b) => b.created_at.localeCompare(a.created_at));
+}
+async function findMemoryById(cwd, id) {
+    await requireWorkspace(cwd);
+    for (const category of memoryCategories) {
+        const file = await readMemoryFile(cwd, category);
+        const index = file.items.findIndex((item) => item.id === id);
+        if (index !== -1) {
+            return {
+                category,
+                file,
+                item: file.items[index],
+                index
+            };
+        }
+    }
+    throw new BriefOpsError(`Memory item not found: ${id}`);
+}
+export async function showMemory(cwd, id) {
+    return (await findMemoryById(cwd, id)).item;
+}
+export async function updateMemoryStatus(options) {
+    const cwd = options.cwd ?? process.cwd();
+    return withWorkspaceLock({ cwd, name: "memory" }, async () => {
+        const found = await findMemoryById(cwd, options.id);
+        const updated = {
+            ...found.item,
+            status: normalizeMemoryStatus(options.status)
+        };
+        found.file.items[found.index] = updated;
+        await writeMemoryFile(cwd, found.category, found.file);
+        return updated;
+    });
+}
+export function formatMemoryItem(item) {
+    const parts = [
+        item.project ? `project: ${item.project}` : undefined,
+        item.skill ? `skill: ${item.skill}` : undefined,
+        item.tags.length > 0 ? `tags: ${item.tags.join(",")}` : undefined
+    ].filter(Boolean);
+    const suffix = parts.length > 0 ? ` (${parts.join("; ")})` : "";
+    return `- [${item.type}] ${item.content}${suffix}`;
+}
+const typeWeights = {
+    decision: 12,
+    lesson: 10,
+    incident: 8,
+    fact: 6,
+    deprecated: -100
+};
+const itemTypeToCategory = {
+    fact: "facts",
+    decision: "decisions",
+    lesson: "lessons",
+    incident: "incidents",
+    deprecated: "deprecated"
+};
+const stopwords = new Set([
+    "this",
+    "that",
+    "with",
+    "from",
+    "into",
+    "about",
+    "should",
+    "would",
+    "could",
+    "previous",
+    "latest",
+    "recent",
+    "review",
+    "task",
+    "change",
+    "changes",
+    "continue",
+    "finish",
+    "update"
+]);
+export function taskKeywords(value) {
+    return new Set((value ?? "")
+        .toLowerCase()
+        .split(/[^a-z0-9가-힣_-]+/i)
+        .flatMap((word) => word.split(/[-_]+/))
+        .map((word) => word.trim())
+        .filter((word) => word.length >= 4)
+        .filter((word) => !stopwords.has(word)));
+}
+function freshnessScore(createdAt) {
+    const created = Date.parse(createdAt);
+    if (Number.isNaN(created)) {
+        return 0;
+    }
+    const ageDays = (Date.now() - created) / 86_400_000;
+    if (ageDays <= 30) {
+        return 4;
+    }
+    return 0;
+}
+export function scoreMemoryItem(options) {
+    const project = options.project ? normalizeName(options.project) : undefined;
+    const skill = options.skill ? normalizeName(options.skill) : undefined;
+    const skills = new Set([
+        ...(skill ? [skill] : []),
+        ...(options.skills ?? []).map(normalizeName)
+    ]);
+    const reasons = [];
+    let score = 0;
+    let tier = 0;
+    const skillMatches = options.item.skill ? skills.has(options.item.skill) : false;
+    if (project && options.item.project === project && skillMatches) {
+        score += 50;
+        tier = 3;
+        reasons.push("project+skill");
+    }
+    else {
+        if (project && options.item.project === project) {
+            score += 35;
+            tier = Math.max(tier, 2);
+            reasons.push("project");
+        }
+        if (skillMatches) {
+            score += 30;
+            tier = Math.max(tier, 1);
+            reasons.push("skill");
+        }
+    }
+    if (options.worker && (skillMatches || options.item.source?.includes(options.worker))) {
+        score += 20;
+        reasons.push("worker-related");
+    }
+    const taskWords = taskKeywords(options.task);
+    const itemWords = taskKeywords(`${options.item.content} ${options.item.tags.join(" ")}`);
+    const overlap = [...taskWords].filter((word) => itemWords.has(word));
+    if (overlap.length > 0) {
+        score += overlap.length * 8;
+        reasons.push(`task match: ${overlap.join("/")}`);
+    }
+    score += typeWeights[options.item.type];
+    reasons.push(`${options.item.type} type`);
+    const fresh = freshnessScore(options.item.created_at);
+    if (fresh > 0) {
+        score += fresh;
+        reasons.push(fresh === 10 ? "recent 30d" : "recent 90d");
+    }
+    if (options.item.status === "deprecated" || options.item.type === "deprecated") {
+        score -= 100;
+        reasons.push("deprecated penalty");
+    }
+    return {
+        item: options.item,
+        score,
+        tier,
+        reason: reasons.join(", ") || "no direct match"
+    };
+}
+export async function selectRelevantMemory(options) {
+    const types = options.types?.map(normalizeMemoryCategory);
+    const active = await listMemory({ cwd: options.cwd, status: "active" });
+    const candidates = active.filter((item) => {
+        const category = itemTypeToCategory[item.type];
+        if (types && !types.includes(category)) {
+            return false;
+        }
+        if (!options.includeDeprecated && category === "deprecated") {
+            return false;
+        }
+        return true;
+    });
+    const ordered = candidates
+        .map((item) => scoreMemoryItem({
+        item,
+        project: options.project,
+        skill: options.skill,
+        skills: options.skills,
+        worker: options.worker,
+        task: options.task
+    }))
+        .filter((selection) => selection.score > 0)
+        .sort((a, b) => b.tier - a.tier ||
+        b.score - a.score ||
+        b.item.created_at.localeCompare(a.item.created_at));
+    const selected = [];
+    const selections = [];
+    const quotaCounts = new Map();
+    let tokens = 0;
+    for (const selection of ordered) {
+        const item = selection.item;
+        const category = itemTypeToCategory[item.type];
+        const quota = options.quotas?.[category];
+        if (quota !== undefined && (quotaCounts.get(category) ?? 0) >= quota) {
+            continue;
+        }
+        const itemTokens = estimateTokens(formatMemoryItem(item));
+        if (tokens + itemTokens > options.maxTokens) {
+            continue;
+        }
+        selected.push(item);
+        selections.push(selection);
+        quotaCounts.set(category, (quotaCounts.get(category) ?? 0) + 1);
+        tokens += itemTokens;
+    }
+    return {
+        items: selected,
+        text: selected.map(formatMemoryItem).join("\n"),
+        tokens,
+        omitted: ordered.length - selected.length,
+        selections,
+        omittedSelections: ordered.filter((selection) => !selected.some((item) => item.id === selection.item.id))
+    };
+}
+export async function selectContinuityContext(options) {
+    return selectRelevantMemory({
+        ...options,
+        includeDeprecated: options.includeDeprecated ?? false,
+        quotas: options.quotas ?? {
+            facts: 3,
+            decisions: 4,
+            lessons: 5,
+            incidents: 3,
+            deprecated: 0
+        }
+    });
+}
+//# sourceMappingURL=memory.js.map

package/dist/core/memory.js.map

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

package/dist/core/memoryHygiene.d.ts

@@ -0,0 +1,25 @@
+import { type MemoryCategory } from "./paths.js";
+import type { MemoryItem } from "../schemas/memory.js";
+export type MemoryHygieneReport = {
+    counts: Record<MemoryCategory, number>;
+    warnings: string[];
+    duplicateLike: Array<{
+        ids: string[];
+        content: string;
+    }>;
+    stale: MemoryItem[];
+    deprecated: MemoryItem[];
+};
+export type MemoryPrunePlan = {
+    archive: Array<{
+        id: string;
+        reason: string;
+        content: string;
+    }>;
+};
+export declare function inspectMemoryHygiene(options?: {
+    cwd?: string;
+}): Promise<MemoryHygieneReport>;
+export declare function planMemoryPrune(options?: {
+    cwd?: string;
+}): Promise<MemoryPrunePlan>;

package/dist/core/memoryHygiene.js

@@ -0,0 +1,95 @@
+import { memoryCategories } from "./paths.js";
+import { listMemory } from "./memory.js";
+const thresholds = {
+    facts: 30,
+    decisions: 30,
+    lessons: 40,
+    incidents: 25,
+    deprecated: 0
+};
+const categoryTypes = {
+    facts: "fact",
+    decisions: "decision",
+    lessons: "lesson",
+    incidents: "incident",
+    deprecated: "deprecated"
+};
+function normalizeContent(value) {
+    return value
+        .toLowerCase()
+        .replace(/[^a-z0-9가-힣]+/g, " ")
+        .trim()
+        .replace(/\s+/g, " ");
+}
+function findDuplicateLike(items) {
+    const groups = new Map();
+    for (const item of items) {
+        const key = normalizeContent(item.content);
+        if (!key) {
+            continue;
+        }
+        groups.set(key, [...(groups.get(key) ?? []), item]);
+    }
+    return [...groups.values()]
+        .filter((group) => group.length > 1)
+        .map((group) => ({
+        ids: group.map((item) => item.id),
+        content: group[0].content
+    }));
+}
+export async function inspectMemoryHygiene(options = {}) {
+    const cwd = options.cwd ?? process.cwd();
+    const active = await listMemory({ cwd, status: "active" });
+    const all = await listMemory({ cwd });
+    const counts = Object.fromEntries(memoryCategories.map((category) => [
+        category,
+        active.filter((item) => item.type === categoryTypes[category]).length
+    ]));
+    const duplicateLike = findDuplicateLike(active);
+    const stale = all.filter((item) => item.status === "stale");
+    const deprecated = all.filter((item) => item.status === "deprecated" || item.type === "deprecated");
+    const warnings = [];
+    for (const category of memoryCategories) {
+        if (category !== "deprecated" && counts[category] > thresholds[category]) {
+            warnings.push(`${category} active memory count is high.`);
+        }
+    }
+    if (duplicateLike.length > 0) {
+        warnings.push("duplicate-like memories detected.");
+    }
+    if (stale.length > 0) {
+        warnings.push("stale memory exists.");
+    }
+    if (deprecated.length > 0) {
+        warnings.push("deprecated memory exists.");
+    }
+    return {
+        counts,
+        warnings,
+        duplicateLike,
+        stale,
+        deprecated
+    };
+}
+export async function planMemoryPrune(options = {}) {
+    const report = await inspectMemoryHygiene(options);
+    const archive = [
+        ...report.stale.map((item) => ({
+            id: item.id,
+            reason: "stale memory",
+            content: item.content
+        })),
+        ...report.deprecated.map((item) => ({
+            id: item.id,
+            reason: "deprecated memory",
+            content: item.content
+        })),
+        ...report.duplicateLike.flatMap((group) => group.ids.slice(1).map((id) => ({
+            id,
+            reason: "duplicate-like memory",
+            content: group.content
+        })))
+    ];
+    return { archive };
+}
+//# sourceMappingURL=memoryHygiene.js.map

package/dist/core/memoryHygiene.js.map

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

package/dist/core/memoryProposal.d.ts

@@ -0,0 +1,40 @@
+import { type MemoryProposal, type MemoryProposalStatus } from "../schemas/memoryProposal.js";
+export type ProposeMemoryFromLogOptions = {
+    cwd?: string;
+    fromLog: string;
+};
+export type ListMemoryProposalFilters = {
+    cwd?: string;
+    status?: MemoryProposalStatus | string;
+    project?: string;
+    skill?: string;
+};
+export declare const NO_MEMORY_PROPOSAL_CANDIDATES_PREFIX = "No memory proposal candidates found in log:";
+export declare function isNoMemoryProposalCandidatesError(error: unknown): boolean;
+export declare function proposeMemoryFromLog(options: ProposeMemoryFromLogOptions): Promise<{
+    path: string;
+    proposal: MemoryProposal;
+}>;
+export declare function readMemoryProposal(cwd: string, id: string): Promise<MemoryProposal>;
+export declare function readLatestProposedMemoryProposal(cwd?: string): Promise<MemoryProposal>;
+export declare function listMemoryProposals(filters?: ListMemoryProposalFilters): Promise<MemoryProposal[]>;
+export declare function applyMemoryProposal(options: {
+    cwd?: string;
+    id: string;
+}): Promise<{
+    proposal: MemoryProposal;
+    created: number;
+    skipped: number;
+}>;
+export declare function applyMemoryProposalUnlocked(options: {
+    cwd?: string;
+    id: string;
+}): Promise<{
+    proposal: MemoryProposal;
+    created: number;
+    skipped: number;
+}>;
+export declare function rejectMemoryProposal(options: {
+    cwd?: string;
+    id: string;
+}): Promise<MemoryProposal>;