@jterrats/open-orchestra 1.0.14 → 1.0.16

package/dist/context-pack-service.js

@@ -0,0 +1,153 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { removeUndefined } from "./command-utils.js";
+import { ensureDir, resolveWorkflowPath, resolveWorkspaceWritePath, } from "./fs-utils.js";
+import { searchContextIndex } from "./context-search-service.js";
+import { writeArtifact } from "./workspace.js";
+const DEFAULT_TARGET_CHARS = 30000;
+const DEFAULT_HARD_CAP_CHARS = 40000;
+const DEFAULT_MAX_FILES = 20;
+const DEFAULT_MAX_SNIPPETS = 60;
+const DEFAULT_PER_SNIPPET_CHARS = 1200;
+export async function buildContextPack({ root = process.cwd(), query, taskId, phase, role, targetChars = DEFAULT_TARGET_CHARS, hardCapChars = DEFAULT_HARD_CAP_CHARS, maxFiles = DEFAULT_MAX_FILES, maxSnippets = DEFAULT_MAX_SNIPPETS, perSnippetChars = DEFAULT_PER_SNIPPET_CHARS, }) {
+    const search = await searchContextIndex(removeUndefined({
+        root,
+        query,
+        taskId,
+        phase,
+        role,
+        limit: maxFiles,
+    }));
+    if (search.status !== "ok") {
+        throw new Error(`context pack requires a fresh context index: ${search.reason}`);
+    }
+    const state = {
+        usedChars: 0,
+        snippets: 0,
+        redactions: 0,
+        truncated: false,
+    };
+    const items = [];
+    for (const match of search.results.slice(0, maxFiles)) {
+        if (state.usedChars >= targetChars || state.snippets >= maxSnippets) {
+            state.truncated = true;
+            break;
+        }
+        const item = await buildPackItem(root, match, {
+            query,
+            perSnippetChars,
+            remainingChars: Math.min(hardCapChars, targetChars) - state.usedChars,
+        });
+        state.usedChars += item.item.snippets.reduce((sum, snippet) => sum + snippet.text.length, 0);
+        state.snippets += item.item.snippets.length;
+        state.redactions += item.redactions;
+        items.push(item.item);
+    }
+    const result = removeUndefined({
+        generatedAt: new Date().toISOString(),
+        query,
+        taskId,
+        phase,
+        role,
+        jsonArtifact: "",
+        markdownArtifact: "",
+        budget: {
+            targetChars,
+            hardCapChars,
+            usedChars: state.usedChars,
+            maxFiles,
+            maxSnippets,
+            perSnippetChars,
+            truncated: state.truncated || state.usedChars >= targetChars,
+        },
+        items,
+        redactions: state.redactions,
+        omitted: search.omitted,
+    });
+    await ensureDir(resolveWorkflowPath(root, "context-packs"));
+    const baseName = contextPackFileName(taskId ?? "advisory", query);
+    const jsonArtifact = await writeArtifact(root, "context-packs", `${baseName}.json`, `${JSON.stringify({ ...result, jsonArtifact: undefined, markdownArtifact: undefined }, null, 2)}\n`);
+    const markdownArtifact = await writeArtifact(root, "context-packs", `${baseName}.md`, renderContextPackMarkdown({
+        ...result,
+        jsonArtifact,
+        markdownArtifact: "",
+    }));
+    return { ...result, jsonArtifact, markdownArtifact };
+}
+function renderContextPackMarkdown(pack) {
+    return [
+        `# Context Pack: ${pack.query}`,
+        "",
+        `- Task: ${pack.taskId ?? "none"}`,
+        `- Role: ${pack.role ?? "none"}`,
+        `- Phase: ${pack.phase ?? "none"}`,
+        `- Budget: ${pack.budget.usedChars}/${pack.budget.targetChars} chars`,
+        `- Redactions: ${pack.redactions}`,
+        "",
+        ...pack.items.flatMap((item) => [
+            `## ${item.path}`,
+            "",
+            `Inclusion: ${item.inclusionReason}`,
+            "",
+            ...item.snippets.flatMap((snippet) => [
+                `Lines ${snippet.startLine}-${snippet.endLine}${snippet.truncated ? " (truncated)" : ""}`,
+                "",
+                "```",
+                snippet.text,
+                "```",
+                "",
+            ]),
+        ]),
+    ].join("\n");
+}
+async function buildPackItem(root, match, options) {
+    const absolutePath = resolveWorkspaceWritePath(root, match.path);
+    const content = await readFile(absolutePath, "utf8");
+    const redacted = redactSecrets(content);
+    const snippets = selectSnippets(redacted.text, options);
+    return {
+        item: {
+            path: match.path,
+            inclusionReason: match.reasons.join("; ") || "ranked search match",
+            score: match.score,
+            snippets,
+        },
+        redactions: redacted.count,
+    };
+}
+function selectSnippets(content, options) {
+    const lines = content.split(/\r?\n/);
+    const tokens = normalize(options.query).split(" ").filter(Boolean);
+    const index = lines.findIndex((line) => tokens.some((token) => normalize(line).includes(token)));
+    const center = index >= 0 ? index : 0;
+    const start = Math.max(0, center - 6);
+    const end = Math.min(lines.length, center + 7);
+    let text = lines.slice(start, end).join("\n").trim();
+    const maxChars = Math.max(0, Math.min(options.perSnippetChars, options.remainingChars));
+    const truncated = text.length > maxChars;
+    text = text.slice(0, maxChars);
+    return text ? [{ startLine: start + 1, endLine: end, text, truncated }] : [];
+}
+function redactSecrets(content) {
+    let count = 0;
+    const text = content.replace(/\b(?:api[_-]?key|token|secret|password)\b\s*[:=]\s*["']?[^"'\s]+/gi, (match) => {
+        count += 1;
+        const key = match.split(/[:=]/)[0]?.trim() ?? "secret";
+        return `${key}=<redacted>`;
+    });
+    return { text, count };
+}
+function contextPackFileName(taskId, query) {
+    const slug = normalize(`${taskId}-${query}`)
+        .replaceAll(" ", "-")
+        .slice(0, 80);
+    return `${slug || "context-pack"}-${Date.now()}`;
+}
+function normalize(value) {
+    return path
+        .basename(value, "")
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, " ")
+        .trim();
+}
+//# sourceMappingURL=context-pack-service.js.map

package/dist/context-pack-service.js.map

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

package/dist/context-search-service.d.ts

@@ -0,0 +1,10 @@
+import type { ContextIndexSearchResult } from "./types.js";
+export interface ContextIndexSearchOptions {
+    root?: string;
+    query: string;
+    taskId?: string;
+    phase?: string;
+    role?: string;
+    limit?: number;
+}
+export declare function searchContextIndex({ root, query, taskId, phase, role, limit, }: ContextIndexSearchOptions): Promise<ContextIndexSearchResult>;

package/dist/context-search-service.js

@@ -0,0 +1,142 @@
+import path from "node:path";
+import { getContextIndexStatus, readIndexedFiles, } from "./context-index-service.js";
+import { removeUndefined } from "./command-utils.js";
+import { listTasks } from "./workflow-task-service.js";
+const DEFAULT_LIMIT = 10;
+export async function searchContextIndex({ root = process.cwd(), query, taskId, phase, role, limit = DEFAULT_LIMIT, }) {
+    const status = await getContextIndexStatus(root);
+    const base = {
+        generatedAt: new Date().toISOString(),
+        query,
+        ...(taskId ? { taskId } : {}),
+        ...(phase ? { phase } : {}),
+        ...(role ? { role } : {}),
+        limit,
+    };
+    if (!status.exists) {
+        return {
+            ...base,
+            status: "missing",
+            reason: status.reason,
+            results: [],
+            omitted: [],
+        };
+    }
+    if (status.stale) {
+        return {
+            ...base,
+            status: "stale",
+            reason: status.reason,
+            results: [],
+            omitted: [],
+        };
+    }
+    const task = taskId ? await findTask(root, taskId) : undefined;
+    const tokens = tokenize(query);
+    const matches = (await readIndexedFiles(root))
+        .map((file) => scoreFile(removeUndefined({
+        file,
+        tokens,
+        task,
+        phase,
+        role,
+    })))
+        .filter((match) => match.score > 0)
+        .sort(compareMatches);
+    return {
+        ...base,
+        status: "ok",
+        reason: "context index search completed",
+        results: matches.slice(0, limit),
+        omitted: matches.slice(limit).map((match) => ({
+            ...match,
+            omissionReasons: ["below result limit"],
+        })),
+    };
+}
+function scoreFile({ file, tokens, task, phase, role, }) {
+    const matchedSignals = [];
+    const reasons = [];
+    let score = 0;
+    for (const token of tokens) {
+        score += scoreText(file.path, token, 25, "path", matchedSignals, reasons);
+        score += scoreText(path.basename(file.path), token, 40, "basename", matchedSignals, reasons);
+        score += scoreList(file.headings, token, 18, "heading", matchedSignals, reasons);
+        score += scoreList(file.imports, token, 12, "import", matchedSignals, reasons);
+        score += scoreList(file.symbols, token, 22, "symbol", matchedSignals, reasons);
+        score += scoreList(file.testHints, token, 15, "test", matchedSignals, reasons);
+    }
+    score += taskPathBoost(file, task, reasons);
+    score += phaseRoleBoost(file, phase, role, reasons);
+    return {
+        path: file.path,
+        score,
+        matchedSignals: [...new Set(matchedSignals)],
+        reasons: [...new Set(reasons)],
+        omissionReasons: [],
+    };
+}
+function scoreText(value, token, points, label, matchedSignals, reasons) {
+    if (!normalize(value).includes(token))
+        return 0;
+    matchedSignals.push(`${label}:${value}`);
+    reasons.push(`${label} matched query`);
+    return points;
+}
+function scoreList(values, token, points, label, matchedSignals, reasons) {
+    return (values ?? []).reduce((sum, value) => sum + scoreText(value, token, points, label, matchedSignals, reasons), 0);
+}
+function taskPathBoost(file, task, reasons) {
+    if (!task?.paths?.some((taskPath) => pathOverlaps(file.path, taskPath))) {
+        return 0;
+    }
+    reasons.push("task ownership path boost");
+    return 35;
+}
+function phaseRoleBoost(file, phase, role, reasons) {
+    const normalized = normalize([phase, role, file.path, file.testHints?.join(" ")].join(" "));
+    if (/(qa|test)/.test(normalized) && isTestLike(file)) {
+        reasons.push("qa/test phase boost");
+        return 20;
+    }
+    if (/(architect|architecture)/.test(normalized) &&
+        /(^|\/)(docs|src)\//.test(file.path)) {
+        reasons.push("architecture phase boost");
+        return 10;
+    }
+    if (/(developer|dev)/.test(normalized) &&
+        /(^|\/)(src|test)\//.test(file.path)) {
+        reasons.push("developer phase boost");
+        return 10;
+    }
+    return 0;
+}
+function compareMatches(left, right) {
+    return right.score - left.score || left.path.localeCompare(right.path);
+}
+function pathOverlaps(filePath, taskPath) {
+    const normalized = taskPath.replaceAll("\\", "/").replace(/\*\*?\/?/g, "");
+    return Boolean(normalized && filePath.includes(normalized));
+}
+function isTestLike(file) {
+    return (Boolean(file.testHints?.length) ||
+        /(^|\/)(test|e2e|specs?|__tests__)(\/|$)/i.test(file.path) ||
+        /\.(test|spec)\.[cm]?[jt]sx?$/i.test(file.path));
+}
+async function findTask(root, taskId) {
+    return (await listTasks(root)).find((task) => task.id === taskId);
+}
+function tokenize(query) {
+    return [
+        ...new Set(normalize(query)
+            .split(" ")
+            .filter((token) => token.length > 1)),
+    ];
+}
+function normalize(value) {
+    return value
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, " ")
+        .trim();
+}
+//# sourceMappingURL=context-search-service.js.map

package/dist/context-search-service.js.map

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

package/dist/context-vault-commands.d.ts

@@ -0,0 +1,5 @@
+import type { CliIo, CliOptions } from "./types.js";
+export declare function contextVaultAddCommand(options: CliOptions, io: CliIo): Promise<void>;
+export declare function contextVaultListCommand(options: CliOptions, io: CliIo): Promise<void>;
+export declare function contextVaultShowCommand(options: CliOptions, io: CliIo): Promise<void>;
+export declare function contextVaultPackCommand(options: CliOptions, io: CliIo): Promise<void>;

package/dist/context-vault-commands.js

@@ -0,0 +1,79 @@
+import { buildVaultContextPack, getContextVaultArtifact, listContextVaultArtifacts, registerVaultArtifact, } from "./context-vault-service.js";
+import { numberOption, removeUndefined, stringOption, targetRootOption, } from "./command-utils.js";
+export async function contextVaultAddCommand(options, io) {
+    const artifact = await registerVaultArtifact(removeUndefined({
+        root: targetRootOption(options),
+        path: required(options.path, "context-vault add requires --path"),
+        source: required(options.source, "context-vault add requires --source"),
+        type: required(options.type, "context-vault add requires --type"),
+        owner: stringOption(options.owner) ?? "user",
+        tenant: stringOption(options.tenant),
+        workspace: stringOption(options.workspace),
+        sensitivity: stringOption(options.sensitivity),
+        retention: stringOption(options.retention),
+        ingestionStatus: stringOption(options.status),
+        transcriptPath: stringOption(options.transcript),
+    }));
+    if (options.json) {
+        io.log(JSON.stringify(artifact, null, 2));
+        return;
+    }
+    io.log(`Registered vault artifact ${artifact.id}: ${artifact.source}`);
+}
+export async function contextVaultListCommand(options, io) {
+    const result = await listContextVaultArtifacts(removeUndefined({
+        root: targetRootOption(options),
+        tenant: stringOption(options.tenant),
+        workspace: stringOption(options.workspace),
+        type: stringOption(options.type),
+        sensitivity: stringOption(options.sensitivity),
+        status: stringOption(options.status),
+        limit: numberOption(options.limit, 25),
+        cursor: numberOption(options.cursor, 0),
+    }));
+    if (options.json) {
+        io.log(JSON.stringify(result, null, 2));
+        return;
+    }
+    for (const artifact of result.items) {
+        io.log(`${artifact.id} ${artifact.type}/${artifact.sensitivity} ${artifact.source}`);
+    }
+}
+export async function contextVaultShowCommand(options, io) {
+    const artifact = await getContextVaultArtifact(required(options.id, "context-vault show requires --id"), targetRootOption(options));
+    if (options.json) {
+        io.log(JSON.stringify(artifact, null, 2));
+        return;
+    }
+    io.log(`${artifact.id}: ${artifact.source}`);
+    io.log(`Path: ${artifact.path}`);
+    io.log(`Tenant/workspace: ${artifact.tenant}/${artifact.workspace}`);
+    io.log(`Sensitivity: ${artifact.sensitivity}`);
+    io.log(`Checksum: ${artifact.checksum}`);
+}
+export async function contextVaultPackCommand(options, io) {
+    const result = await buildVaultContextPack(removeUndefined({
+        root: targetRootOption(options),
+        query: required(options.query, "context-vault pack requires --query"),
+        taskId: stringOption(options.task),
+        phase: stringOption(options.phase),
+        role: stringOption(options.role),
+        targetChars: numberOption(options["target-chars"], 12000),
+        maxArtifacts: numberOption(options["max-artifacts"], 10),
+        tenant: stringOption(options.tenant),
+        workspace: stringOption(options.workspace),
+    }));
+    if (options.json) {
+        io.log(JSON.stringify(result, null, 2));
+        return;
+    }
+    io.log(`Vault context pack: ${result.markdownArtifact}`);
+    io.log(`Vault context pack JSON: ${result.jsonArtifact}`);
+}
+function required(value, message) {
+    const resolved = stringOption(value);
+    if (!resolved)
+        throw new Error(message);
+    return resolved;
+}
+//# sourceMappingURL=context-vault-commands.js.map

package/dist/context-vault-commands.js.map

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

package/dist/context-vault-file-metadata.d.ts

@@ -0,0 +1,3 @@
+import type { VaultArtifactType } from "./context-vault-model.js";
+export declare function sha256File(filePath: string): Promise<string>;
+export declare function mediaTypeForPath(filePath: string, type: VaultArtifactType): string;

package/dist/context-vault-file-metadata.js

@@ -0,0 +1,25 @@
+import { createHash } from "node:crypto";
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+export async function sha256File(filePath) {
+    return createHash("sha256")
+        .update(await readFile(filePath))
+        .digest("hex");
+}
+export function mediaTypeForPath(filePath, type) {
+    const extension = path.extname(filePath).toLowerCase();
+    if (extension === ".md" || extension === ".txt")
+        return "text/markdown";
+    if (extension === ".pdf")
+        return "application/pdf";
+    if (extension === ".png")
+        return "image/png";
+    if (extension === ".jpg" || extension === ".jpeg")
+        return "image/jpeg";
+    if (extension === ".mp3")
+        return "audio/mpeg";
+    if (extension === ".mp4")
+        return "video/mp4";
+    return type === "document" ? "text/plain" : "application/octet-stream";
+}
+//# sourceMappingURL=context-vault-file-metadata.js.map

package/dist/context-vault-file-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-vault-file-metadata.js","sourceRoot":"","sources":["../src/context-vault-file-metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,QAAgB;IAC/C,OAAO,UAAU,CAAC,QAAQ,CAAC;SACxB,MAAM,CAAC,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC;SAChC,MAAM,CAAC,KAAK,CAAC,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,QAAgB,EAChB,IAAuB;IAEvB,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;IACvD,IAAI,SAAS,KAAK,KAAK,IAAI,SAAS,KAAK,MAAM;QAAE,OAAO,eAAe,CAAC;IACxE,IAAI,SAAS,KAAK,MAAM;QAAE,OAAO,iBAAiB,CAAC;IACnD,IAAI,SAAS,KAAK,MAAM;QAAE,OAAO,WAAW,CAAC;IAC7C,IAAI,SAAS,KAAK,MAAM,IAAI,SAAS,KAAK,OAAO;QAAE,OAAO,YAAY,CAAC;IACvE,IAAI,SAAS,KAAK,MAAM;QAAE,OAAO,YAAY,CAAC;IAC9C,IAAI,SAAS,KAAK,MAAM;QAAE,OAAO,WAAW,CAAC;IAC7C,OAAO,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,0BAA0B,CAAC;AACzE,CAAC"}

package/dist/context-vault-model.d.ts

@@ -0,0 +1,79 @@
+export type VaultArtifactType = "document" | "pdf" | "image" | "diagram" | "audio" | "video" | "transcript" | "reference";
+export type VaultSensitivity = "public" | "internal" | "confidential" | "restricted";
+export type VaultIngestionStatus = "registered" | "indexed" | "transcribed" | "redacted" | "failed";
+export interface VaultArtifact {
+    id: string;
+    source: string;
+    path: string;
+    fileName: string;
+    type: VaultArtifactType;
+    mediaType: string;
+    sizeBytes: number;
+    checksum: string;
+    owner: string;
+    tenant: string;
+    workspace: string;
+    sensitivity: VaultSensitivity;
+    retention: string;
+    ingestionStatus: VaultIngestionStatus;
+    transcriptPath?: string;
+    registeredAt: string;
+}
+export interface VaultCatalog {
+    schemaVersion: 1;
+    updatedAt: string;
+    artifacts: VaultArtifact[];
+}
+export interface VaultListOptions {
+    root?: string;
+    tenant?: string;
+    workspace?: string;
+    type?: string;
+    sensitivity?: string;
+    status?: string;
+    limit?: number;
+    cursor?: number;
+}
+export interface VaultListResult {
+    items: VaultArtifact[];
+    total: number;
+    limit: number;
+    cursor: number;
+    nextCursor?: number;
+}
+export interface VaultPackOptions {
+    root?: string;
+    query: string;
+    taskId?: string;
+    phase?: string;
+    role?: string;
+    targetChars?: number;
+    maxArtifacts?: number;
+    tenant?: string;
+    workspace?: string;
+}
+export interface VaultPackResult {
+    generatedAt: string;
+    query: string;
+    taskId?: string;
+    phase?: string;
+    role?: string;
+    markdownArtifact: string;
+    jsonArtifact: string;
+    budget: {
+        targetChars: number;
+        usedChars: number;
+        truncated: boolean;
+    };
+    redactions: number;
+    items: VaultPackItem[];
+}
+export interface VaultPackItem {
+    artifactId: string;
+    source: string;
+    path: string;
+    sensitivity: VaultSensitivity;
+    inclusionReason: string;
+    excerpt: string;
+    transcriptPath?: string;
+}

package/dist/context-vault-model.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=context-vault-model.js.map

package/dist/context-vault-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-vault-model.js","sourceRoot":"","sources":["../src/context-vault-model.ts"],"names":[],"mappings":""}

package/dist/context-vault-redaction.d.ts

@@ -0,0 +1,5 @@
+export interface RedactionResult {
+    text: string;
+    count: number;
+}
+export declare function redactVaultText(content: string): RedactionResult;

package/dist/context-vault-redaction.js

@@ -0,0 +1,22 @@
+const SECRET_PATTERN = /\b(?:api[_-]?key|token|secret|password|authorization)\b\s*[:=]\s*["']?[^"'\s]+/gi;
+const EMAIL_PATTERN = /\b[A-Z0-9._%+-]+@[A-Z0-9.-]+\.[A-Z]{2,}\b/gi;
+const PHONE_PATTERN = /\b(?:\+?\d[\d .-]{7,}\d)\b/g;
+export function redactVaultText(content) {
+    let count = 0;
+    const text = content
+        .replace(SECRET_PATTERN, (match) => {
+        count += 1;
+        const key = match.split(/[:=]/)[0]?.trim() ?? "secret";
+        return `${key}=<redacted>`;
+    })
+        .replace(EMAIL_PATTERN, () => {
+        count += 1;
+        return "<redacted-email>";
+    })
+        .replace(PHONE_PATTERN, () => {
+        count += 1;
+        return "<redacted-phone>";
+    });
+    return { text, count };
+}
+//# sourceMappingURL=context-vault-redaction.js.map

package/dist/context-vault-redaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-vault-redaction.js","sourceRoot":"","sources":["../src/context-vault-redaction.ts"],"names":[],"mappings":"AAAA,MAAM,cAAc,GAClB,kFAAkF,CAAC;AACrF,MAAM,aAAa,GAAG,6CAA6C,CAAC;AACpE,MAAM,aAAa,GAAG,6BAA6B,CAAC;AAOpD,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,MAAM,IAAI,GAAG,OAAO;SACjB,OAAO,CAAC,cAAc,EAAE,CAAC,KAAK,EAAE,EAAE;QACjC,KAAK,IAAI,CAAC,CAAC;QACX,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,QAAQ,CAAC;QACvD,OAAO,GAAG,GAAG,aAAa,CAAC;IAC7B,CAAC,CAAC;SACD,OAAO,CAAC,aAAa,EAAE,GAAG,EAAE;QAC3B,KAAK,IAAI,CAAC,CAAC;QACX,OAAO,kBAAkB,CAAC;IAC5B,CAAC,CAAC;SACD,OAAO,CAAC,aAAa,EAAE,GAAG,EAAE;QAC3B,KAAK,IAAI,CAAC,CAAC;QACX,OAAO,kBAAkB,CAAC;IAC5B,CAAC,CAAC,CAAC;IACL,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AACzB,CAAC"}

package/dist/context-vault-renderer.d.ts

@@ -0,0 +1,3 @@
+import type { VaultPackResult } from "./context-vault-model.js";
+export declare function renderVaultPackMarkdown(pack: VaultPackResult): string;
+export declare function vaultPackSlug(value: string): string;

package/dist/context-vault-renderer.js

@@ -0,0 +1,30 @@
+export function renderVaultPackMarkdown(pack) {
+    return [
+        `# Vault Context Pack: ${pack.query}`,
+        "",
+        `- Task: ${pack.taskId ?? "none"}`,
+        `- Budget: ${pack.budget.usedChars}/${pack.budget.targetChars} chars`,
+        `- Redactions: ${pack.redactions}`,
+        "",
+        ...pack.items.flatMap((item) => [
+            `## ${item.source}`,
+            "",
+            `Artifact: ${item.artifactId}`,
+            `Path: ${item.path}`,
+            `Sensitivity: ${item.sensitivity}`,
+            `Inclusion: ${item.inclusionReason}`,
+            "",
+            "```",
+            item.excerpt,
+            "```",
+            "",
+        ]),
+    ].join("\n");
+}
+export function vaultPackSlug(value) {
+    return value
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .slice(0, 80);
+}
+//# sourceMappingURL=context-vault-renderer.js.map

package/dist/context-vault-renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-vault-renderer.js","sourceRoot":"","sources":["../src/context-vault-renderer.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,uBAAuB,CAAC,IAAqB;IAC3D,OAAO;QACL,yBAAyB,IAAI,CAAC,KAAK,EAAE;QACrC,EAAE;QACF,WAAW,IAAI,CAAC,MAAM,IAAI,MAAM,EAAE;QAClC,aAAa,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,QAAQ;QACrE,iBAAiB,IAAI,CAAC,UAAU,EAAE;QAClC,EAAE;QACF,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;YAC9B,MAAM,IAAI,CAAC,MAAM,EAAE;YACnB,EAAE;YACF,aAAa,IAAI,CAAC,UAAU,EAAE;YAC9B,SAAS,IAAI,CAAC,IAAI,EAAE;YACpB,gBAAgB,IAAI,CAAC,WAAW,EAAE;YAClC,cAAc,IAAI,CAAC,eAAe,EAAE;YACpC,EAAE;YACF,KAAK;YACL,IAAI,CAAC,OAAO;YACZ,KAAK;YACL,EAAE;SACH,CAAC;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,OAAO,KAAK;SACT,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAClB,CAAC"}

package/dist/context-vault-service.d.ts

@@ -0,0 +1,17 @@
+import type { VaultArtifact, VaultArtifactType, VaultIngestionStatus, VaultListOptions, VaultListResult, VaultPackOptions, VaultPackResult, VaultSensitivity } from "./context-vault-model.js";
+export declare function registerVaultArtifact(input: {
+    root?: string;
+    path: string;
+    source: string;
+    type: VaultArtifactType;
+    owner: string;
+    tenant?: string;
+    workspace?: string;
+    sensitivity?: VaultSensitivity;
+    retention?: string;
+    ingestionStatus?: VaultIngestionStatus;
+    transcriptPath?: string;
+}): Promise<VaultArtifact>;
+export declare function listContextVaultArtifacts(options?: VaultListOptions): Promise<VaultListResult>;
+export declare function getContextVaultArtifact(id: string, root?: string): Promise<VaultArtifact>;
+export declare function buildVaultContextPack(options: VaultPackOptions): Promise<VaultPackResult>;