@reposkein/mcp 0.3.0 → 0.4.0

package/dist/store/sidecar.js

@@ -1,7 +1,49 @@
-import { existsSync, readFileSync, writeFileSync, mkdirSync } from "node:fs";
-import { dirname, join } from "node:path";
-export function sidecarPath(repoPath) {
-    return join(repoPath, ".reposkein", "local", "summaries.jsonl");
+import { existsSync, readFileSync, writeFileSync, mkdirSync, readdirSync } from "node:fs";
+import { basename, dirname, join } from "node:path";
+import { absorbSummaryLines, emptyAccumulator, } from "./summaryShards.js";
+/** Directory holding every agent's sidecar. Git-ignored in full. */
+export function sidecarDir(repoPath) {
+    return join(repoPath, ".reposkein", "local");
+}
+/** Filesystem-safe slug for the writing agent.
+ *
+ *  Untrusted input: REPOSKEIN_AGENT comes from whatever launched the server, so
+ *  it is reduced to `[a-z0-9._-]` and capped. A value that reduces to nothing
+ *  (or is absent) falls back to "agent", which is also the pre-multi-agent
+ *  name — so a single-agent setup keeps one stable file. */
+export function agentSlug(agent = process.env.REPOSKEIN_AGENT) {
+    const slug = (agent ?? "")
+        .toLowerCase()
+        .replace(/[^a-z0-9._-]+/g, "-")
+        .replace(/^[-.]+|[-.]+$/g, "")
+        .slice(0, 40)
+        .replace(/[-.]+$/, "");
+    return slug === "" ? "agent" : slug;
+}
+/** THIS process's sidecar: one file per agent.
+ *
+ *  A single shared `local/summaries.jsonl` meant two agents running against the
+ *  same checkout silently overwrote each other — `upsertSidecar` rewrites the
+ *  whole file, so the slower writer's prose vanished with no error anywhere.
+ *  One file per writer removes the shared mutable state; the indexer folds
+ *  every `local/summaries*.jsonl` into the committed shards. */
+export function sidecarPath(repoPath, agent) {
+    return join(sidecarDir(repoPath), `summaries-${agentSlug(agent)}.jsonl`);
+}
+/** Every agent's sidecar in this repo, sorted, so reads are deterministic and
+ *  independent of directory order. Includes the pre-split
+ *  `local/summaries.jsonl` an older client may still be writing. */
+export function sidecarPaths(repoPath) {
+    const dir = sidecarDir(repoPath);
+    try {
+        return readdirSync(dir)
+            .filter((f) => f.startsWith("summaries") && f.endsWith(".jsonl"))
+            .sort()
+            .map((f) => join(dir, f));
+    }
+    catch {
+        return [];
+    }
 }
 /** Reads the sidecar into a map keyed by node id. Missing file → empty map.
  *  Best-effort: malformed lines / read errors are skipped. */
@@ -38,8 +80,50 @@ export function readSidecar(path) {
     }
     return map;
 }
+/** Every agent's sidecar records, folded through the SAME rules the Rust
+ *  indexer applies — `beats` within the sidecar set, losers preserved — so the
+ *  server serves exactly the record the next `index` is going to write.
+ *
+ *  This used to be a plain last-file-wins merge, which disagreed with the
+ *  indexer whenever two agents summarised the same node, and dropped the loser
+ *  with no trace. Callers should hand `conflicts` to `recordSummaryConflicts`. */
+export function loadAllSidecars(repoPath) {
+    const acc = emptyAccumulator();
+    for (const p of sidecarPaths(repoPath)) {
+        let text;
+        try {
+            text = readFileSync(p, "utf8");
+        }
+        catch {
+            continue;
+        }
+        absorbSummaryLines(acc, `local/${basename(p)}`, text);
+    }
+    return acc;
+}
+/** Convenience view of `loadAllSidecars` for callers that only want the
+ *  winning record per node id. Divergence losers are dropped on the floor
+ *  here, so prefer `loadAllSidecars` anywhere they can be recorded. */
+export function readAllSidecars(repoPath) {
+    const merged = new Map();
+    for (const [id, rec] of loadAllSidecars(repoPath).summaries) {
+        const s = (k) => typeof rec.props[k] === "string" ? rec.props[k] : "";
+        merged.set(id, {
+            id,
+            semantic_summary: s("semantic_summary"),
+            summary_of_hash: s("summary_of_hash"),
+            summary_model: s("summary_model"),
+            summary_at: s("summary_at"),
+            summary_by: s("summary_by"),
+        });
+    }
+    return merged;
+}
 /** Upserts one record and rewrites the sidecar sorted by id (deterministic, no
- *  duplicate lines). Creates the local/ dir if needed. Best-effort. */
+ *  duplicate lines). Creates the local/ dir if needed. Best-effort.
+ *
+ *  Rewriting the whole file is safe only because `path` belongs to one agent:
+ *  see `sidecarPath`. */
 export function upsertSidecar(path, rec) {
     const map = readSidecar(path);
     map.set(rec.id, rec);

package/dist/store/sidecar.js.map

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

package/dist/store/summaryShards.d.ts

@@ -0,0 +1,117 @@
+/** Reader for the committed authored summaries, `.reposkein/summaries/<xx>.jsonl`.
+ *
+ *  Sharding replaced a single `.reposkein/summaries.jsonl` for the reason
+ *  `docs/migrations/2026-08-06-stop-committing-derived-graph.md` records: one
+ *  committed file that every branch rewrites conflicts on every merge, and no
+ *  `.gitattributes` rule can fix it, because a forge computes mergeability in a
+ *  bare repo where tree-level attributes are never consulted. File granularity
+ *  is the only thing that works there — the same reason decisions are one file
+ *  each.
+ *
+ *  This module ONLY READS. The Rust indexer is the sole writer of committed
+ *  shards, so byte-identical output has exactly one serializer to hold to it
+ *  (serde_json and JSON.stringify differ on escapes and number formatting).
+ *  Writes from this process go to the git-ignored per-agent sidecar, which the
+ *  next `index` folds into the shards.
+ *
+ *  Reading never needs a shard key — `readdir` enumerates the files — which is
+ *  why no BLAKE3 implementation is required on this side.
+ *
+ *  Tolerance is the other half. A shard is a MERGED file: it can carry git
+ *  conflict markers, duplicate lines from a `merge=union` resolution, or two
+ *  genuinely different summaries for the same node. None of that may take
+ *  recall down, and none of it may silently destroy authored prose — the same
+ *  contract `loadDecisions` keeps for a damaged decision file. */
+export interface SummaryShardRecord {
+    id: string;
+    /** Every field except `id`, exactly as parsed. */
+    props: Record<string, unknown>;
+    /** The raw source line, which is also the divergence tiebreak. */
+    line: string;
+}
+export interface LoadedSummaryShards {
+    /** Winner per node id, insertion-ordered by id. */
+    summaries: Map<string, SummaryShardRecord>;
+    /** Divergence losers, preserved rather than dropped. */
+    conflicts: SummaryShardRecord[];
+    warnings: string[];
+    /** Set when the pre-sharding `.reposkein/summaries.jsonl` is still present —
+     *  doctor turns this into "run `reposkein-indexer index` to migrate". */
+    legacyFilePresent: boolean;
+}
+export declare function summariesDir(repoPath: string): string;
+/** The pre-sharding committed file. Still read (dual-read) for one release. */
+export declare function legacySummariesPath(repoPath: string): string;
+export declare function conflictsPath(repoPath: string): string;
+/** Mirrors the Rust `is_shard_file_name`: exactly two lowercase hex chars. */
+export declare function isShardFileName(name: string): boolean;
+/** A line git left behind from an unresolved textual merge. A canonical
+ *  summary line always starts with `{`, so a marker run is damage, not data. */
+export declare function isConflictMarker(line: string): boolean;
+/** Whether these props carry an authored summary worth keeping.
+ *
+ *  Deliberately identical to the Rust `has_summary`. The two languages read the
+ *  same committed shards, so a record one accepts and the other rejects is a
+ *  divergence between what the server serves and what the indexer writes — and
+ *  a record with nothing in it must never displace one that has prose, in
+ *  either language. Pinned by the `null-valued`/`non-string` fixture vectors. */
+export declare function hasSummary(props: Record<string, unknown>): boolean;
+/** Deterministic winner between two records claiming the same node id, when
+ *  nothing is known about where either came from:
+ *  newer `summary_at`, then smaller raw line by UTF-8 byte order. Both are
+ *  pure functions of bytes on disk, so every machine — and the Rust indexer —
+ *  picks the same winner without coordinating. Kept in lockstep with the Rust
+ *  `beats` by the shared vectors in `fixtures/summary-shard-vectors.json`.
+ *
+ *  This is the rule for records found in the SAME source (two lines of one
+ *  merged shard, two agents' sidecars). Across sources of known provenance,
+ *  use `supersedes`. */
+export declare function beats(candidate: SummaryShardRecord, incumbent: SummaryShardRecord): boolean;
+/** Whether a record from a strictly NEWER-provenance source displaces one
+ *  already held from an older source.
+ *
+ *  `summary_at` is day-precision (PRD §6.2.5 keeps wall-clock time out of
+ *  committed bytes), so re-summarising a node already summarised today TIES.
+ *  Resolving that tie by byte order would silently discard the rewrite. A
+ *  newer source therefore wins unless it is *strictly older* — which is the
+ *  case that matters, because that is a stale local record about to clobber a
+ *  teammate's newer one. Mirrors the Rust `supersedes`. */
+export declare function supersedes(candidate: SummaryShardRecord, incumbent: SummaryShardRecord): boolean;
+export interface SummaryAccumulator {
+    summaries: Map<string, SummaryShardRecord>;
+    conflicts: SummaryShardRecord[];
+    warnings: string[];
+}
+export declare function emptyAccumulator(): SummaryAccumulator;
+/** Folds a whole source of strictly NEWER provenance into `acc`. Mirrors the
+ *  Rust `absorb_source`: displacement uses `supersedes`, and every displaced
+ *  record is preserved. */
+export declare function absorbSummarySource(acc: SummaryAccumulator, other: SummaryAccumulator): void;
+/** Folds one file's text in, resolving same-source records with `beats`.
+ *  Exported for the shared vectors. */
+export declare function absorbSummaryLines(acc: SummaryAccumulator, source: string, text: string): void;
+/** Reads every committed shard plus the pre-sharding file, tolerantly.
+ *  A missing directory is the normal state for a repo with no authored prose,
+ *  and returns an empty result rather than an error. */
+export declare function loadSummaryShards(repoPath: string): LoadedSummaryShards;
+/** A cheap fingerprint of everything the summary overlay reads on disk.
+ *
+ *  The store keys its reload on this, so a `git pull` that brings in a
+ *  teammate's shards — or another agent's sidecar write on this machine — is
+ *  visible without restarting the process. Stat calls only, O(shards +
+ *  sidecars), no content read, because this runs on every read and not just on
+ *  change. mtime alone is not enough on filesystems with coarse timestamps, so
+ *  size rides along.
+ *
+ *  `sidecarFiles` is injected rather than imported to keep this module free of
+ *  a cycle with sidecar.ts, which imports the fold from here. */
+export declare function summaryShardsStamp(repoPath: string, sidecarFiles?: (repoPath: string) => string[]): string;
+/** Merges divergence losers into the git-ignored `local/conflicts.jsonl`.
+ *
+ *  Deduped and sorted, so repeated reads converge instead of growing the file,
+ *  and never truncating: a loser recorded by an earlier run (or by the indexer)
+ *  stays. Best-effort — failing to record a conflict must not break a tool
+ *  call. Mirrors the Rust `conflicts_to_jsonl`. */
+export declare function recordSummaryConflicts(repoPath: string, losers: readonly SummaryShardRecord[]): void;
+/** How many divergence losers are on record. Doctor surfaces this. */
+export declare function countRecordedConflicts(repoPath: string): number;

package/dist/store/summaryShards.js

@@ -0,0 +1,291 @@
+import { existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync, } from "node:fs";
+import { basename, join } from "node:path";
+export function summariesDir(repoPath) {
+    return join(repoPath, ".reposkein", "summaries");
+}
+/** The pre-sharding committed file. Still read (dual-read) for one release. */
+export function legacySummariesPath(repoPath) {
+    return join(repoPath, ".reposkein", "summaries.jsonl");
+}
+export function conflictsPath(repoPath) {
+    return join(repoPath, ".reposkein", "local", "conflicts.jsonl");
+}
+/** Mirrors the Rust `is_shard_file_name`: exactly two lowercase hex chars. */
+export function isShardFileName(name) {
+    return /^[0-9a-f]{2}\.jsonl$/.test(name);
+}
+/** A line git left behind from an unresolved textual merge. A canonical
+ *  summary line always starts with `{`, so a marker run is damage, not data. */
+export function isConflictMarker(line) {
+    return (line.startsWith("<<<<<<<") ||
+        line.startsWith("=======") ||
+        line.startsWith(">>>>>>>") ||
+        line.startsWith("|||||||"));
+}
+/** True for a value that is actually authored prose: a non-empty string.
+ *  `null`, a number, or `""` all mean "the field is present but says nothing". */
+function isProse(v) {
+    return typeof v === "string" && v !== "";
+}
+/** Whether these props carry an authored summary worth keeping.
+ *
+ *  Deliberately identical to the Rust `has_summary`. The two languages read the
+ *  same committed shards, so a record one accepts and the other rejects is a
+ *  divergence between what the server serves and what the indexer writes — and
+ *  a record with nothing in it must never displace one that has prose, in
+ *  either language. Pinned by the `null-valued`/`non-string` fixture vectors. */
+export function hasSummary(props) {
+    return isProse(props.semantic_summary) || isProse(props.purpose_summary);
+}
+function summaryAt(rec) {
+    const v = rec.props.summary_at;
+    return typeof v === "string" ? v : "";
+}
+/** Byte-lexicographic comparison. JavaScript's `<` compares UTF-16 code units,
+ *  which orders some astral/BMP pairs differently from the UTF-8 byte order
+ *  Rust uses. Comparing the encoded bytes is what makes the two languages
+ *  agree on every input, not just ASCII ones. */
+function lineIsSmaller(a, b) {
+    return Buffer.compare(Buffer.from(a, "utf8"), Buffer.from(b, "utf8")) < 0;
+}
+/** Deterministic winner between two records claiming the same node id, when
+ *  nothing is known about where either came from:
+ *  newer `summary_at`, then smaller raw line by UTF-8 byte order. Both are
+ *  pure functions of bytes on disk, so every machine — and the Rust indexer —
+ *  picks the same winner without coordinating. Kept in lockstep with the Rust
+ *  `beats` by the shared vectors in `fixtures/summary-shard-vectors.json`.
+ *
+ *  This is the rule for records found in the SAME source (two lines of one
+ *  merged shard, two agents' sidecars). Across sources of known provenance,
+ *  use `supersedes`. */
+export function beats(candidate, incumbent) {
+    const ca = summaryAt(candidate);
+    const ia = summaryAt(incumbent);
+    if (ca !== ia)
+        return ca > ia;
+    return lineIsSmaller(candidate.line, incumbent.line);
+}
+/** Whether a record from a strictly NEWER-provenance source displaces one
+ *  already held from an older source.
+ *
+ *  `summary_at` is day-precision (PRD §6.2.5 keeps wall-clock time out of
+ *  committed bytes), so re-summarising a node already summarised today TIES.
+ *  Resolving that tie by byte order would silently discard the rewrite. A
+ *  newer source therefore wins unless it is *strictly older* — which is the
+ *  case that matters, because that is a stale local record about to clobber a
+ *  teammate's newer one. Mirrors the Rust `supersedes`. */
+export function supersedes(candidate, incumbent) {
+    return summaryAt(candidate) >= summaryAt(incumbent);
+}
+export function emptyAccumulator() {
+    return { summaries: new Map(), conflicts: [], warnings: [] };
+}
+/** Folds one candidate in, keeping whichever record `wins` selects and
+ *  preserving the other. The single place a record can be displaced, so no
+ *  caller can bypass conflict recording by accident. */
+function offer(acc, rec, wins) {
+    const existing = acc.summaries.get(rec.id);
+    if (!existing) {
+        acc.summaries.set(rec.id, rec);
+        return;
+    }
+    // A union merge duplicating an unchanged line is not a conflict.
+    if (existing.line === rec.line)
+        return;
+    if (wins(rec, existing)) {
+        acc.summaries.set(rec.id, rec);
+        acc.conflicts.push(existing);
+    }
+    else {
+        acc.conflicts.push(rec);
+    }
+}
+/** Folds a whole source of strictly NEWER provenance into `acc`. Mirrors the
+ *  Rust `absorb_source`: displacement uses `supersedes`, and every displaced
+ *  record is preserved. */
+export function absorbSummarySource(acc, other) {
+    for (const rec of other.summaries.values())
+        offer(acc, rec, supersedes);
+    acc.conflicts.push(...other.conflicts);
+    acc.warnings.push(...other.warnings);
+}
+/** Folds one file's text in, resolving same-source records with `beats`.
+ *  Exported for the shared vectors. */
+export function absorbSummaryLines(acc, source, text) {
+    let markers = 0;
+    let malformed = 0;
+    for (const raw of text.split("\n")) {
+        const line = raw.endsWith("\r") ? raw.slice(0, -1) : raw;
+        if (line.trim() === "")
+            continue;
+        if (isConflictMarker(line)) {
+            markers++;
+            continue;
+        }
+        let obj;
+        try {
+            const parsed = JSON.parse(line);
+            if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+                malformed++;
+                continue;
+            }
+            obj = parsed;
+        }
+        catch {
+            malformed++;
+            continue;
+        }
+        const id = obj.id;
+        if (typeof id !== "string" || id === "") {
+            malformed++;
+            continue;
+        }
+        const { id: _drop, ...props } = obj;
+        // A line with no authored prose is not a summary. Letting it into the map
+        // would let it WIN a tiebreak against a real summary and evict it — see
+        // `hasSummary` for the null-valued case that did exactly that.
+        if (!hasSummary(props)) {
+            malformed++;
+            continue;
+        }
+        offer(acc, { id, props, line }, beats);
+    }
+    if (markers > 0) {
+        acc.warnings.push(`${source}: skipped ${markers} git conflict-marker line(s); run \`reposkein-indexer index\` to rewrite the shard cleanly`);
+    }
+    if (malformed > 0) {
+        acc.warnings.push(`${source}: skipped ${malformed} malformed line(s)`);
+    }
+}
+/** Reads every committed shard plus the pre-sharding file, tolerantly.
+ *  A missing directory is the normal state for a repo with no authored prose,
+ *  and returns an empty result rather than an error. */
+export function loadSummaryShards(repoPath) {
+    const acc = emptyAccumulator();
+    const dir = summariesDir(repoPath);
+    let names = [];
+    try {
+        names = readdirSync(dir).filter(isShardFileName).sort();
+    }
+    catch {
+        names = [];
+    }
+    for (const name of names) {
+        try {
+            absorbSummaryLines(acc, `summaries/${name}`, readFileSync(join(dir, name), "utf8"));
+        }
+        catch {
+            acc.warnings.push(`summaries/${name}: unreadable`);
+        }
+    }
+    const legacy = legacySummariesPath(repoPath);
+    const legacyFilePresent = existsSync(legacy);
+    if (legacyFilePresent) {
+        try {
+            absorbSummaryLines(acc, "summaries.jsonl", readFileSync(legacy, "utf8"));
+        }
+        catch {
+            acc.warnings.push("summaries.jsonl: unreadable");
+        }
+    }
+    // Sorted by id so callers iterate deterministically.
+    const summaries = new Map([...acc.summaries.entries()].sort((a, b) => (a[0] < b[0] ? -1 : a[0] > b[0] ? 1 : 0)));
+    return { summaries, conflicts: acc.conflicts, warnings: acc.warnings, legacyFilePresent };
+}
+/** A cheap fingerprint of everything the summary overlay reads on disk.
+ *
+ *  The store keys its reload on this, so a `git pull` that brings in a
+ *  teammate's shards — or another agent's sidecar write on this machine — is
+ *  visible without restarting the process. Stat calls only, O(shards +
+ *  sidecars), no content read, because this runs on every read and not just on
+ *  change. mtime alone is not enough on filesystems with coarse timestamps, so
+ *  size rides along.
+ *
+ *  `sidecarFiles` is injected rather than imported to keep this module free of
+ *  a cycle with sidecar.ts, which imports the fold from here. */
+export function summaryShardsStamp(repoPath, sidecarFiles = () => []) {
+    const parts = [];
+    const dir = summariesDir(repoPath);
+    let names = [];
+    try {
+        names = readdirSync(dir).filter(isShardFileName).sort();
+    }
+    catch {
+        names = [];
+    }
+    for (const name of names) {
+        try {
+            const s = statSync(join(dir, name));
+            parts.push(`${name}:${s.mtimeMs}:${s.size}`);
+        }
+        catch {
+            parts.push(`${name}:?`);
+        }
+    }
+    try {
+        const s = statSync(legacySummariesPath(repoPath));
+        parts.push(`legacy:${s.mtimeMs}:${s.size}`);
+    }
+    catch {
+        // absent, which is the post-migration norm
+    }
+    // Sidecars too. Without them a second agent's write on the same checkout was
+    // invisible to an already-open server for the life of the process — which
+    // the overlay explicitly promises to surface.
+    for (const p of sidecarFiles(repoPath)) {
+        try {
+            const s = statSync(p);
+            parts.push(`sc/${basename(p)}:${s.mtimeMs}:${s.size}`);
+        }
+        catch {
+            parts.push(`sc/${basename(p)}:?`);
+        }
+    }
+    return parts.join("|");
+}
+/** Merges divergence losers into the git-ignored `local/conflicts.jsonl`.
+ *
+ *  Deduped and sorted, so repeated reads converge instead of growing the file,
+ *  and never truncating: a loser recorded by an earlier run (or by the indexer)
+ *  stays. Best-effort — failing to record a conflict must not break a tool
+ *  call. Mirrors the Rust `conflicts_to_jsonl`. */
+export function recordSummaryConflicts(repoPath, losers) {
+    if (losers.length === 0)
+        return;
+    const path = conflictsPath(repoPath);
+    const lines = new Set();
+    try {
+        for (const raw of readFileSync(path, "utf8").split("\n")) {
+            const line = raw.endsWith("\r") ? raw.slice(0, -1) : raw;
+            if (line.trim() !== "" && !isConflictMarker(line))
+                lines.add(line);
+        }
+    }
+    catch {
+        // no existing file
+    }
+    const before = lines.size;
+    for (const l of losers)
+        lines.add(l.line);
+    if (lines.size === before)
+        return;
+    try {
+        mkdirSync(join(repoPath, ".reposkein", "local"), { recursive: true });
+        writeFileSync(path, [...lines].sort().join("\n") + "\n");
+    }
+    catch {
+        // best-effort
+    }
+}
+/** How many divergence losers are on record. Doctor surfaces this. */
+export function countRecordedConflicts(repoPath) {
+    try {
+        return readFileSync(conflictsPath(repoPath), "utf8")
+            .split("\n")
+            .filter((l) => l.trim() !== "").length;
+    }
+    catch {
+        return 0;
+    }
+}
+//# sourceMappingURL=summaryShards.js.map

package/dist/store/summaryShards.js.map

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

package/dist/store/teamConfig.d.ts

@@ -0,0 +1,13 @@
+/** Reads `pages_url` from the `[team]` section of `.reposkein/config.toml`,
+ *  or null when the file/section/key is absent (the common case — this is
+ *  an opt-in field a team adds after publishing a hosted constellation, see
+ *  docs/HOSTING.md). Points the viewer's header at wherever the team's
+ *  canonical/CI-published constellation lives (e.g. a GitHub Pages URL),
+ *  distinct from whatever ad-hoc `view`/`view --export` a given machine
+ *  happens to be looking at right now.
+ *
+ *  A deliberate ~20-line scanner rather than a TOML dependency — mirrors
+ *  `config_bool` in indexer/crates/cli/src/main.rs: this reads exactly one
+ *  setting, and its config is a file `reposkein-indexer init` writes.
+ *  Absent file, section, or key all mean `null`. */
+export declare function readTeamPagesUrl(repoPath: string): string | null;

package/dist/store/teamConfig.js

@@ -0,0 +1,49 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+/** Reads `pages_url` from the `[team]` section of `.reposkein/config.toml`,
+ *  or null when the file/section/key is absent (the common case — this is
+ *  an opt-in field a team adds after publishing a hosted constellation, see
+ *  docs/HOSTING.md). Points the viewer's header at wherever the team's
+ *  canonical/CI-published constellation lives (e.g. a GitHub Pages URL),
+ *  distinct from whatever ad-hoc `view`/`view --export` a given machine
+ *  happens to be looking at right now.
+ *
+ *  A deliberate ~20-line scanner rather than a TOML dependency — mirrors
+ *  `config_bool` in indexer/crates/cli/src/main.rs: this reads exactly one
+ *  setting, and its config is a file `reposkein-indexer init` writes.
+ *  Absent file, section, or key all mean `null`. */
+export function readTeamPagesUrl(repoPath) {
+    const path = join(repoPath, ".reposkein", "config.toml");
+    if (!existsSync(path))
+        return null;
+    let text;
+    try {
+        text = readFileSync(path, "utf8");
+    }
+    catch {
+        return null;
+    }
+    let inTeamSection = false;
+    for (const rawLine of text.split(/\r?\n/)) {
+        const line = rawLine.trim();
+        if (line === "" || line.startsWith("#"))
+            continue;
+        if (line.startsWith("[")) {
+            inTeamSection = line === "[team]";
+            continue;
+        }
+        if (!inTeamSection)
+            continue;
+        const eq = line.indexOf("=");
+        if (eq === -1)
+            continue;
+        const key = line.slice(0, eq).trim();
+        if (key !== "pages_url")
+            continue;
+        const rawValue = line.slice(eq + 1).split("#")[0].trim();
+        const quoted = rawValue.match(/^"([^"]*)"$/) ?? rawValue.match(/^'([^']*)'$/);
+        return quoted ? quoted[1] : null;
+    }
+    return null;
+}
+//# sourceMappingURL=teamConfig.js.map

package/dist/store/teamConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"teamConfig.js","sourceRoot":"","sources":["../../src/store/teamConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;;;;;;;;;;oDAWoD;AACpD,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,YAAY,EAAE,aAAa,CAAC,CAAC;IACzD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,aAAa,GAAG,KAAK,CAAC;IAC1B,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,IAAI,KAAK,EAAE,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QAClD,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACzB,aAAa,GAAG,IAAI,KAAK,QAAQ,CAAC;YAClC,SAAS;QACX,CAAC;QACD,IAAI,CAAC,aAAa;YAAE,SAAS;QAC7B,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,EAAE,KAAK,CAAC,CAAC;YAAE,SAAS;QACxB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACrC,IAAI,GAAG,KAAK,WAAW;YAAE,SAAS;QAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC;QAC1D,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QAC9E,OAAO,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACpC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/tools/indexerTools.d.ts

@@ -22,8 +22,20 @@ export interface InitArgs {
     path?: string;
     full?: boolean;
 }
-export declare function makeInitCpgSkeleton(repoId: string, deps?: Partial<IndexerDeps>): (args: InitArgs) => Promise<ToolResult>;
+/** `path` (the repo to index) MUST come from the caller's already-resolved
+ *  active repo (mcp/src/store/repoSession.ts), not re-derived here — this
+ *  tool used to default to REPOSKEIN_REPO_PATH/cwd internally via
+ *  runIndexer.js's `repoPath()`, which bypassed session.select_repo entirely
+ *  and could index the wrong repo in workspace mode. Args-supplied `path`
+ *  still wins, matching the original "explicit arg beats everything" rule. */
+export declare function makeInitCpgSkeleton(repoId: string, repoPath: string, deps?: Partial<IndexerDeps>): (args: InitArgs) => Promise<ToolResult>;
 export interface ReindexArgs {
     path: string;
 }
-export declare function makeReindexFile(repoId: string, deps?: Partial<IndexerDeps>): (args: ReindexArgs) => Promise<ToolResult>;
+/** `path` has no override — `reindex_file`'s args only carry the file being
+ *  reindexed, not a repo root — so this ALWAYS targets the caller's resolved
+ *  active repo. Same reasoning as `makeInitCpgSkeleton` above: previously
+ *  this read REPOSKEIN_REPO_PATH/cwd internally, independent of
+ *  session.select_repo — the exact "reindex the wrong repo" bug class this
+ *  parameter exists to close. */
+export declare function makeReindexFile(repoId: string, repoPath: string, deps?: Partial<IndexerDeps>): (args: ReindexArgs) => Promise<ToolResult>;