@zebeqo/vendy 0.2.0 → 0.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/main.mjs +181 -111
- package/package.json +1 -1
package/dist/main.mjs
CHANGED
|
@@ -26761,6 +26761,12 @@ const Use = Struct({
|
|
|
26761
26761
|
read: optionalKey(Lines),
|
|
26762
26762
|
guide: optionalKey(Line)
|
|
26763
26763
|
});
|
|
26764
|
+
const lineDelimiters = [
|
|
26765
|
+
"[",
|
|
26766
|
+
"]",
|
|
26767
|
+
"→",
|
|
26768
|
+
"·"
|
|
26769
|
+
];
|
|
26764
26770
|
const normalizePath = (path) => path.replace(/^\.\//, "").replace(/\/+$/, "");
|
|
26765
26771
|
const scopeAlternatives = (glob) => {
|
|
26766
26772
|
for (let open = 0; open < glob.length; open++) {
|
|
@@ -26799,13 +26805,14 @@ const partitionScope = (scope) => ({
|
|
|
26799
26805
|
});
|
|
26800
26806
|
const unlocated = (use) => ["scope", "read"].filter((key) => use[key] === void 0);
|
|
26801
26807
|
const isProvisional = (use) => unlocated(use).length > 0;
|
|
26808
|
+
const scopeText = (use) => use.scope === void 0 ? "" : ` [${use.scope.join(", ")}]`;
|
|
26809
|
+
const provisionalText = (use) => isProvisional(use) ? " (provisional)" : "";
|
|
26802
26810
|
const line = (use) => {
|
|
26803
|
-
const scope = use.scope === void 0 ? "" : ` [${use.scope.join(", ")}]`;
|
|
26804
26811
|
const read = use.read === void 0 ? "" : ` → ${use.read.join(", ")}`;
|
|
26805
|
-
const provisional = isProvisional(use) ? " (provisional)" : "";
|
|
26806
26812
|
const guide = use.guide === void 0 ? "" : ` · guide ${use.guide}`;
|
|
26807
|
-
return `${use.for}${
|
|
26813
|
+
return `${use.for}${scopeText(use)}${read}${provisionalText(use)}${guide}`;
|
|
26808
26814
|
};
|
|
26815
|
+
const scopeLine = (use) => `${use.for}${scopeText(use)}${provisionalText(use)}`;
|
|
26809
26816
|
const sameLines = (left, right) => left?.join("\0") === right?.join("\0");
|
|
26810
26817
|
const same = (left, right) => left.for === right.for && sameLines(left.scope, right.scope) && sameLines(left.read, right.read) && left.guide === right.guide;
|
|
26811
26818
|
const sameUses = (left, right) => left.length === right.length && left.every((use, index) => {
|
|
@@ -27188,7 +27195,7 @@ const failUnknownNames = fnUntraced(function* (names) {
|
|
|
27188
27195
|
recovery: yield* render$9({ _tag: "UnknownNames" })
|
|
27189
27196
|
});
|
|
27190
27197
|
});
|
|
27191
|
-
const select$
|
|
27198
|
+
const select$2 = fn("Inventory.select")(function* (inventory, names) {
|
|
27192
27199
|
const { selected, unknown } = selectNamed(inventory, names, ({ repo }) => repo.name);
|
|
27193
27200
|
if (unknown.length > 0) return yield* failUnknownNames(unknown);
|
|
27194
27201
|
return selected;
|
|
@@ -34336,6 +34343,7 @@ const render$5 = (current, install) => {
|
|
|
34336
34343
|
const events = ["SessionStart", "SubagentStart"];
|
|
34337
34344
|
const cursorEvents = ["sessionStart"];
|
|
34338
34345
|
const hookEvents = [...events, ...cursorEvents];
|
|
34346
|
+
const contextLimit = 1e4;
|
|
34339
34347
|
const agents = [
|
|
34340
34348
|
"claude",
|
|
34341
34349
|
"codex",
|
|
@@ -34632,6 +34640,13 @@ const withSnapshot = fnUntraced(function* (root, git, item) {
|
|
|
34632
34640
|
snapshot: recorded?.trim() === item.repo.commit ? "Current" : "Stale"
|
|
34633
34641
|
};
|
|
34634
34642
|
});
|
|
34643
|
+
const select$1 = fn("Catalog.select")(function* (loaded, names) {
|
|
34644
|
+
if (names.length === 0) return loaded;
|
|
34645
|
+
return {
|
|
34646
|
+
items: yield* select$2(loaded.items, names),
|
|
34647
|
+
pullable: 0
|
|
34648
|
+
};
|
|
34649
|
+
});
|
|
34635
34650
|
const load = fn("Catalog.load")(function* (cwd) {
|
|
34636
34651
|
const pathService = yield* Path$1;
|
|
34637
34652
|
const root = yield* findRoot(cwd);
|
|
@@ -34652,6 +34667,86 @@ const load = fn("Catalog.load")(function* (cwd) {
|
|
|
34652
34667
|
pullable: mainLocal?.manifest.repos.filter((repo) => !here.has(repo.name)).length ?? 0
|
|
34653
34668
|
};
|
|
34654
34669
|
});
|
|
34670
|
+
const header = (runner) => `Vendored repos in this worktree (\`${runner} catalog\`), each at ${vendorDir}/<name>.`;
|
|
34671
|
+
const legend = "Each use: what this project draws on it for [the project files it governs] → where in the snapshot to read · its guide, a file in this project. Before changing a file a use governs, read those paths and the guide.";
|
|
34672
|
+
const scopesLegend = (runner) => `Each use: what this project draws on it for [the project files it governs]. Before changing a file a use governs, run \`${runner} catalog <name>\`: it prints that repo's uses in full, adding → where in the snapshot to read · its guide, a file in this project. Then read those paths and the guide.`;
|
|
34673
|
+
const empty = `No repos are vendored under ${vendorDir}/ in this worktree.`;
|
|
34674
|
+
const unreadable = (detail) => [
|
|
34675
|
+
`No vendored catalog is available this session: ${manifestFileName} could not be read.`,
|
|
34676
|
+
"",
|
|
34677
|
+
detail,
|
|
34678
|
+
"",
|
|
34679
|
+
"Report this to the user. Fix a use by hand; repair anything else with the vendy verbs."
|
|
34680
|
+
];
|
|
34681
|
+
const parenthetical = (item) => {
|
|
34682
|
+
const { ref } = item.repo;
|
|
34683
|
+
const parts = [`at ${isCommitSha(ref) ? shortSha(ref) : ref}`];
|
|
34684
|
+
if (item.local) parts.push("local");
|
|
34685
|
+
if (item.snapshot !== "Current") parts.push(item.snapshot === "Missing" ? "missing" : "stale");
|
|
34686
|
+
if (item.repo.paths !== void 0) parts.push(`only ${item.repo.paths.map((path) => `${path}/`).join(", ")}`);
|
|
34687
|
+
return ` (${parts.join("; ")})`;
|
|
34688
|
+
};
|
|
34689
|
+
const repoLines = (item, useLine) => [`- ${item.repo.name}${parenthetical(item)}`, ...(item.repo.uses ?? []).map((use) => ` - ${useLine(use)}`)];
|
|
34690
|
+
const missingLine = (count, runner) => `${count} ${count === 1 ? "snapshot is" : "snapshots are"} missing: run \`${runner} sync <name>\` before reading ${count === 1 ? "it" : "them"}, not another worktree's copy, which may be at another pin.`;
|
|
34691
|
+
const staleLine = (count, runner) => `${count} ${count === 1 ? "snapshot is" : "snapshots are"} stale, not materialized from ${count === 1 ? "its pin" : "their pins"}: run \`${runner} sync <name>\` before reading ${count === 1 ? "it" : "them"}.`;
|
|
34692
|
+
const provisionalLine = (count, runner) => `${count} ${count === 1 ? "use is" : "uses are"} provisional: the scope or evidence is not recorded yet. Find the evidence in the snapshot before building on it, then record both (\`${runner} skills get align\`).`;
|
|
34693
|
+
const pullLine = (count, runner) => `${count} local ${count === 1 ? "repo" : "repos"} in the main worktree ${count === 1 ? "is" : "are"} not in this one: run \`${runner} local pull\` to copy ${count === 1 ? "it" : "them"} here.`;
|
|
34694
|
+
const entries = ({ items, pullable }, runner, useLine) => {
|
|
34695
|
+
const missing = items.filter((item) => item.snapshot === "Missing").length;
|
|
34696
|
+
const stale = items.filter((item) => item.snapshot === "Stale").length;
|
|
34697
|
+
const provisional = items.flatMap((item) => item.repo.uses ?? []).filter(isProvisional).length;
|
|
34698
|
+
const footer = [
|
|
34699
|
+
...missing === 0 ? [] : [missingLine(missing, runner)],
|
|
34700
|
+
...stale === 0 ? [] : [staleLine(stale, runner)],
|
|
34701
|
+
...provisional === 0 ? [] : [provisionalLine(provisional, runner)],
|
|
34702
|
+
...pullable === 0 ? [] : [pullLine(pullable, runner)]
|
|
34703
|
+
];
|
|
34704
|
+
return [...items.flatMap((item) => repoLines(item, useLine)), ...footer.length === 0 ? [] : ["", ...footer]];
|
|
34705
|
+
};
|
|
34706
|
+
const listing = (loaded, runner, form) => {
|
|
34707
|
+
const hasUses = loaded.items.some((item) => (item.repo.uses ?? []).length > 0);
|
|
34708
|
+
return [
|
|
34709
|
+
header(runner),
|
|
34710
|
+
...hasUses ? [form.legend] : [],
|
|
34711
|
+
"",
|
|
34712
|
+
...entries(loaded, runner, form.useLine)
|
|
34713
|
+
];
|
|
34714
|
+
};
|
|
34715
|
+
const text = (lines) => lines.join("\n");
|
|
34716
|
+
const render$4 = (loaded, runner) => {
|
|
34717
|
+
if (loaded.items.length === 0) return loaded.pullable === 0 ? [empty] : [
|
|
34718
|
+
empty,
|
|
34719
|
+
"",
|
|
34720
|
+
pullLine(loaded.pullable, runner)
|
|
34721
|
+
];
|
|
34722
|
+
return listing(loaded, runner, {
|
|
34723
|
+
legend,
|
|
34724
|
+
useLine: line
|
|
34725
|
+
});
|
|
34726
|
+
};
|
|
34727
|
+
const renderNamed = (loaded, runner) => entries(loaded, runner, line);
|
|
34728
|
+
/** The whole catalog when it fits in `limit` characters; otherwise each use with only its `for` and scope. */
|
|
34729
|
+
const renderWithin = (loaded, runner, limit) => {
|
|
34730
|
+
const full = render$4(loaded, runner);
|
|
34731
|
+
return text(full).length <= limit ? full : listing(loaded, runner, {
|
|
34732
|
+
legend: scopesLegend(runner),
|
|
34733
|
+
useLine: scopeLine
|
|
34734
|
+
});
|
|
34735
|
+
};
|
|
34736
|
+
const inFreshWorktree = (inventory) => ({
|
|
34737
|
+
items: inventory.map((item) => ({
|
|
34738
|
+
...item,
|
|
34739
|
+
snapshot: "Missing"
|
|
34740
|
+
})),
|
|
34741
|
+
pullable: 0
|
|
34742
|
+
});
|
|
34743
|
+
const hookOutput = (event, lines) => {
|
|
34744
|
+
const additionalContext = text(lines);
|
|
34745
|
+
return event === "sessionStart" ? JSON.stringify({ additional_context: additionalContext }) : JSON.stringify({ hookSpecificOutput: {
|
|
34746
|
+
hookEventName: event,
|
|
34747
|
+
additionalContext
|
|
34748
|
+
} });
|
|
34749
|
+
};
|
|
34655
34750
|
//#endregion
|
|
34656
34751
|
//#region ../../node_modules/.pnpm/picomatch@4.0.7/node_modules/picomatch/lib/constants.js
|
|
34657
34752
|
var require_constants = /* @__PURE__ */ __commonJSMin(((exports, module) => {
|
|
@@ -36612,11 +36707,25 @@ const specifierPattern = /(?:\bfrom\s*|\bimport\s*\(\s*|\brequire\s*\(\s*|^\s*im
|
|
|
36612
36707
|
const specifiers = (source) => new Set([...source.matchAll(specifierPattern)].map((match) => match[1] ?? ""));
|
|
36613
36708
|
const loads = (specifier, name) => specifier === name || specifier.startsWith(`${name}/`);
|
|
36614
36709
|
//#endregion
|
|
36710
|
+
//#region ../core/src/Runner.ts
|
|
36711
|
+
const io = {
|
|
36712
|
+
existsSync,
|
|
36713
|
+
readFileSync,
|
|
36714
|
+
join,
|
|
36715
|
+
dirname
|
|
36716
|
+
};
|
|
36717
|
+
const packageManager = (root) => detectPackageManager(root, io);
|
|
36718
|
+
const commands = (packageManager) => runnerCommands(packageManager, packageName$1, executable);
|
|
36719
|
+
const command = (packageManager) => commands(packageManager)[0] ?? "vendy";
|
|
36720
|
+
const invocation = (root) => findLocalCli(root, "@zebeqo/vendy", "vendy", io) === void 0 ? executable : command(packageManager(root));
|
|
36721
|
+
//#endregion
|
|
36615
36722
|
//#region ../core/src/Check.ts
|
|
36616
36723
|
const quote = (text) => `"${text.length > 48 ? `${text.slice(0, 47)}…` : text}"`;
|
|
36617
36724
|
const describe = (finding, runner) => {
|
|
36618
36725
|
switch (finding._tag) {
|
|
36726
|
+
case "CatalogOverLimit": return `the session catalog is ${finding.length} characters with only each use's \`for\` and scope, over the ${finding.limit} Claude Code injects; shorten \`for\`s and scopes, or remove repos the project no longer draws on`;
|
|
36619
36727
|
case "ForOverBudget": return `use ${quote(finding.for)} has a ${finding.for.length}-character \`for\`; keep it to the role in 120, and let \`read\` and the guide carry the rest`;
|
|
36728
|
+
case "ForHasDelimiter": return `use ${quote(finding.for)}: \`for\` contains ${finding.delimiters.map((delimiter) => `"${delimiter}"`).join(", ")}, which the catalog writes between a use's parts; reword it`;
|
|
36620
36729
|
case "Provisional": return `use ${quote(finding.for)} is provisional: it has no ${finding.missing.map((key) => `\`${key}\``).join(" or ")} yet`;
|
|
36621
36730
|
case "ScopeMatchesNothing": {
|
|
36622
36731
|
const verb = isExclusion(finding.glob) ? "excludes" : "matches";
|
|
@@ -36638,7 +36747,17 @@ const describe = (finding, runner) => {
|
|
|
36638
36747
|
}
|
|
36639
36748
|
}
|
|
36640
36749
|
};
|
|
36641
|
-
const message = (finding, runner) => `${finding.name}: ${describe(finding, runner)}`;
|
|
36750
|
+
const message = (finding, runner) => finding._tag === "CatalogOverLimit" ? describe(finding, runner) : `${finding.name}: ${describe(finding, runner)}`;
|
|
36751
|
+
const catalogFindings = (root, inventory) => {
|
|
36752
|
+
const limit = contextLimit;
|
|
36753
|
+
const lines = renderWithin(inFreshWorktree(inventory), command(packageManager(root)), limit);
|
|
36754
|
+
const { length } = text(lines);
|
|
36755
|
+
return length > limit ? [{
|
|
36756
|
+
_tag: "CatalogOverLimit",
|
|
36757
|
+
length,
|
|
36758
|
+
limit
|
|
36759
|
+
}] : [];
|
|
36760
|
+
};
|
|
36642
36761
|
const listFiles = fnUntraced(function* (root, args) {
|
|
36643
36762
|
return (yield* run$17([
|
|
36644
36763
|
"ls-files",
|
|
@@ -36701,26 +36820,35 @@ const scopeFindings = (name, purpose, glob, files) => {
|
|
|
36701
36820
|
alternative
|
|
36702
36821
|
}));
|
|
36703
36822
|
};
|
|
36704
|
-
const useFindings = (name, use, files, guides) =>
|
|
36705
|
-
|
|
36706
|
-
|
|
36707
|
-
|
|
36708
|
-
|
|
36709
|
-
|
|
36710
|
-
|
|
36711
|
-
|
|
36712
|
-
|
|
36713
|
-
|
|
36714
|
-
|
|
36715
|
-
|
|
36716
|
-
|
|
36717
|
-
|
|
36718
|
-
|
|
36719
|
-
|
|
36720
|
-
|
|
36721
|
-
|
|
36722
|
-
|
|
36723
|
-
]
|
|
36823
|
+
const useFindings = (name, use, files, guides) => {
|
|
36824
|
+
const delimiters = lineDelimiters.filter((delimiter) => use.for.includes(delimiter));
|
|
36825
|
+
return [
|
|
36826
|
+
...use.for.length > 120 ? [{
|
|
36827
|
+
_tag: "ForOverBudget",
|
|
36828
|
+
name,
|
|
36829
|
+
for: use.for
|
|
36830
|
+
}] : [],
|
|
36831
|
+
...delimiters.length === 0 ? [] : [{
|
|
36832
|
+
_tag: "ForHasDelimiter",
|
|
36833
|
+
name,
|
|
36834
|
+
for: use.for,
|
|
36835
|
+
delimiters
|
|
36836
|
+
}],
|
|
36837
|
+
...isProvisional(use) ? [{
|
|
36838
|
+
_tag: "Provisional",
|
|
36839
|
+
name,
|
|
36840
|
+
for: use.for,
|
|
36841
|
+
missing: unlocated(use)
|
|
36842
|
+
}] : [],
|
|
36843
|
+
...(use.scope ?? []).flatMap((glob) => scopeFindings(name, use.for, glob, files)),
|
|
36844
|
+
...use.guide === void 0 || guides.has(normalize(use.guide)) ? [] : [{
|
|
36845
|
+
_tag: "GuideMissing",
|
|
36846
|
+
name,
|
|
36847
|
+
for: use.for,
|
|
36848
|
+
guide: use.guide
|
|
36849
|
+
}]
|
|
36850
|
+
];
|
|
36851
|
+
};
|
|
36724
36852
|
const localGuideFindings = (name, use, project) => {
|
|
36725
36853
|
if (use.guide === void 0) return [];
|
|
36726
36854
|
const guide = normalize(use.guide);
|
|
@@ -36837,7 +36965,7 @@ const inspect$4 = fn("Check.inspect")(function* (options) {
|
|
|
36837
36965
|
});
|
|
36838
36966
|
const { root } = view;
|
|
36839
36967
|
const inventory = view.items;
|
|
36840
|
-
const selected = yield* select$
|
|
36968
|
+
const selected = yield* select$2(inventory, options.names);
|
|
36841
36969
|
const listed = yield* projectFiles(root);
|
|
36842
36970
|
const files = listed.files;
|
|
36843
36971
|
const guides = /* @__PURE__ */ new Set();
|
|
@@ -36897,6 +37025,7 @@ const inspect$4 = fn("Check.inspect")(function* (options) {
|
|
|
36897
37025
|
findings.push(...report.findings);
|
|
36898
37026
|
dependencies.push(...report.dependencies);
|
|
36899
37027
|
}
|
|
37028
|
+
if (options.names === void 0 || options.names.length === 0) findings.push(...catalogFindings(root, inventory));
|
|
36900
37029
|
return {
|
|
36901
37030
|
findings,
|
|
36902
37031
|
dependencies
|
|
@@ -37028,7 +37157,7 @@ const run$10 = fn("LocalPull.run")(function* (options = {}) {
|
|
|
37028
37157
|
});
|
|
37029
37158
|
const state = view.local;
|
|
37030
37159
|
const source = yield* findSource(state, options.from, options.cwd ?? process.cwd());
|
|
37031
|
-
const selected = yield* select$
|
|
37160
|
+
const selected = yield* select$2(repos(empty$1, source.manifest), options.names);
|
|
37032
37161
|
const outcomes = yield* forEach$1(selected, fnUntraced(function* ({ repo }) {
|
|
37033
37162
|
const here = state.current.manifest.repos.find((existing) => existing.name === repo.name);
|
|
37034
37163
|
const outcome = here !== void 0 ? {
|
|
@@ -37144,18 +37273,6 @@ const run$8 = fn("Remove.run")(function* (options) {
|
|
|
37144
37273
|
};
|
|
37145
37274
|
});
|
|
37146
37275
|
//#endregion
|
|
37147
|
-
//#region ../core/src/Runner.ts
|
|
37148
|
-
const io = {
|
|
37149
|
-
existsSync,
|
|
37150
|
-
readFileSync,
|
|
37151
|
-
join,
|
|
37152
|
-
dirname
|
|
37153
|
-
};
|
|
37154
|
-
const packageManager = (root) => detectPackageManager(root, io);
|
|
37155
|
-
const commands = (packageManager) => runnerCommands(packageManager, packageName$1, executable);
|
|
37156
|
-
const command = (packageManager) => commands(packageManager)[0] ?? "vendy";
|
|
37157
|
-
const invocation = (root) => findLocalCli(root, "@zebeqo/vendy", "vendy", io) === void 0 ? executable : command(packageManager(root));
|
|
37158
|
-
//#endregion
|
|
37159
37276
|
//#region ../core/src/AgentsFile.ts
|
|
37160
37277
|
const targetNames = agentsFileNames;
|
|
37161
37278
|
var UnusableAgentsFile = class extends TaggedError()("UnusableAgentsFile", {
|
|
@@ -37294,7 +37411,7 @@ const ownedEntry = (settings) => {
|
|
|
37294
37411
|
};
|
|
37295
37412
|
const ownedIndices = (autoImports) => (autoImports?.children ?? []).flatMap((pattern, index) => pattern.type === "string" && pattern.value === vendoredPattern ? [index] : []);
|
|
37296
37413
|
/** Parses before editing: jsonc-parser's editor tolerates faults that setup must skip. */
|
|
37297
|
-
const render$
|
|
37414
|
+
const render$3 = (current, install) => {
|
|
37298
37415
|
if (!install && current === void 0) return succeed$7(void 0);
|
|
37299
37416
|
const source = current ?? "{}\n";
|
|
37300
37417
|
const errors = [];
|
|
@@ -37357,7 +37474,7 @@ const render$4 = (current, install) => {
|
|
|
37357
37474
|
return next;
|
|
37358
37475
|
});
|
|
37359
37476
|
};
|
|
37360
|
-
const inspect$2 = (current) => flatMap$3(render$
|
|
37477
|
+
const inspect$2 = (current) => flatMap$3(render$3(current, false), (without) => without === current ? succeed$7("Absent") : map$10(render$3(current, true), (installed) => installed === current ? "Current" : "Stale"));
|
|
37361
37478
|
//#endregion
|
|
37362
37479
|
//#region ../core/src/Setup.ts
|
|
37363
37480
|
const inspectVSCodeSettings = fnUntraced(function* (root) {
|
|
@@ -37460,7 +37577,7 @@ const planVSCodeBody = fnUntraced(function* (file, install) {
|
|
|
37460
37577
|
if (yield* isSymbolicLink(pathService.dirname(file.absolute))) return skippedFile(file, "its parent directory is a symbolic link, and vendy will not write through it");
|
|
37461
37578
|
if (yield* isSymbolicLink(file.absolute)) return skippedFile(file, "it is a symbolic link, and vendy will not replace the link");
|
|
37462
37579
|
const current = yield* readFileStringOptional(file.absolute);
|
|
37463
|
-
const rendered = render$
|
|
37580
|
+
const rendered = render$3(current, install);
|
|
37464
37581
|
if (isFailure$1(rendered)) return skippedFile(file, rendered.failure.detail);
|
|
37465
37582
|
return filePlan(file, current, rendered.success);
|
|
37466
37583
|
});
|
|
@@ -37562,7 +37679,7 @@ const devDependencyGap = fn("Setup.devDependencyGap")(function* (root) {
|
|
|
37562
37679
|
const contents = yield* readFileStringOptional(pathService.join(root, "package.json"));
|
|
37563
37680
|
return contents !== void 0 && declarations(/* @__PURE__ */ new Map([["package.json", contents]])).some((declaration) => declaration.name === "@zebeqo/vendy") ? void 0 : packageManager(root);
|
|
37564
37681
|
});
|
|
37565
|
-
const render$
|
|
37682
|
+
const render$2 = (devDependency) => `Next steps:\n${[
|
|
37566
37683
|
...devDependency === void 0 ? [] : [devDependencyPointer(devDependency)],
|
|
37567
37684
|
skillPointer,
|
|
37568
37685
|
formatterReminder
|
|
@@ -37682,7 +37799,7 @@ const check$1 = fn("Status.check")(function* (options = {}) {
|
|
|
37682
37799
|
cwd: options.cwd
|
|
37683
37800
|
});
|
|
37684
37801
|
const root = view.root;
|
|
37685
|
-
const selected = yield* select$
|
|
37802
|
+
const selected = yield* select$2(view.items, options.names);
|
|
37686
37803
|
const inspect = fnUntraced(function* (item) {
|
|
37687
37804
|
const { repo } = item;
|
|
37688
37805
|
const [upstream, snapshot] = yield* all([checkUpstream(root, repo, options.log === true), inspect$6({
|
|
@@ -38458,7 +38575,7 @@ const run$4 = fn("Sync.run")(function* (options = {}) {
|
|
|
38458
38575
|
const root = view.root;
|
|
38459
38576
|
yield* ensureDirectoryBoundary(root, vendorDir);
|
|
38460
38577
|
const inventory = view.items;
|
|
38461
|
-
const selected = yield* select$
|
|
38578
|
+
const selected = yield* select$2(inventory, options.names);
|
|
38462
38579
|
yield* repair(root);
|
|
38463
38580
|
const inspections = yield* forEach$1(selected, fnUntraced(function* (item) {
|
|
38464
38581
|
const result$3 = yield* result(inspect$6({
|
|
@@ -38723,7 +38840,7 @@ const run$3 = fn("Update.run")(function* (options) {
|
|
|
38723
38840
|
verb: "update",
|
|
38724
38841
|
cwd: options.cwd
|
|
38725
38842
|
});
|
|
38726
|
-
const selected = yield* select$
|
|
38843
|
+
const selected = yield* select$2(view.items, options.names);
|
|
38727
38844
|
if (selected.some((item) => !item.local) || selected.length === 0) yield* ensure$1(view.root, [manifestPath]);
|
|
38728
38845
|
yield* repair(view.root);
|
|
38729
38846
|
if (selected.length === 0) return [];
|
|
@@ -45780,62 +45897,6 @@ const runWith = (command, config) => {
|
|
|
45780
45897
|
}, catchFilter((error) => isCliError(error) && error._tag === "ShowHelp" ? succeed$7(error) : fail$5(error), (error) => andThen(showHelp(command, error, config.renderErrors !== false), fail$1(error))), catchFilter((error) => config.renderErrors !== false && isCliError(error) && error._tag === "UserError" ? succeed$7(error) : fail$5(error), (error) => andThen(showUserError(error), fail$1(error))), catchFilter((e) => isQuitError(e) ? succeed$7(e) : fail$5(e), (_) => interrupt$1));
|
|
45781
45898
|
};
|
|
45782
45899
|
//#endregion
|
|
45783
|
-
//#region src/cli/Catalog.ts
|
|
45784
|
-
const header = (runner) => `Vendored repos in this worktree (\`${runner} catalog\`), each at ${vendorDir}/<name>.`;
|
|
45785
|
-
const legend = "Each use: what this project draws on it for [the project files it governs] → where in the snapshot to read · its guide. Before changing a file a use governs, read those paths and the guide.";
|
|
45786
|
-
const empty = `No repos are vendored under ${vendorDir}/ in this worktree.`;
|
|
45787
|
-
const unreadable = (detail) => [
|
|
45788
|
-
`No vendored catalog is available this session: ${manifestFileName} could not be read.`,
|
|
45789
|
-
"",
|
|
45790
|
-
detail,
|
|
45791
|
-
"",
|
|
45792
|
-
"Report this to the user. Fix a use by hand; repair anything else with the vendy verbs."
|
|
45793
|
-
];
|
|
45794
|
-
const parenthetical = (item) => {
|
|
45795
|
-
const { ref } = item.repo;
|
|
45796
|
-
const parts = [`at ${isCommitSha(ref) ? shortSha(ref) : ref}`];
|
|
45797
|
-
if (item.local) parts.push("local");
|
|
45798
|
-
if (item.snapshot !== "Current") parts.push(item.snapshot === "Missing" ? "missing" : "stale");
|
|
45799
|
-
if (item.repo.paths !== void 0) parts.push(`only ${item.repo.paths.map((path) => `${path}/`).join(", ")}`);
|
|
45800
|
-
return ` (${parts.join(", ")})`;
|
|
45801
|
-
};
|
|
45802
|
-
const repoLines = (item) => [`- ${item.repo.name}${parenthetical(item)}`, ...(item.repo.uses ?? []).map((use) => ` - ${line(use)}`)];
|
|
45803
|
-
const missingLine = (count, runner) => `${count} ${count === 1 ? "snapshot is" : "snapshots are"} missing: run \`${runner} sync <name>\` before reading ${count === 1 ? "it" : "them"}, not another worktree's copy, which may be at another pin.`;
|
|
45804
|
-
const staleLine = (count, runner) => `${count} ${count === 1 ? "snapshot is" : "snapshots are"} stale, not materialized from ${count === 1 ? "its pin" : "their pins"}: run \`${runner} sync <name>\` before reading ${count === 1 ? "it" : "them"}.`;
|
|
45805
|
-
const provisionalLine = (count, runner) => `${count} ${count === 1 ? "use is" : "uses are"} provisional: the scope or evidence is not recorded yet. Find the evidence in the snapshot before building on it, then record both (\`${runner} skills get align\`).`;
|
|
45806
|
-
const pullLine = (count, runner) => `${count} local ${count === 1 ? "repo" : "repos"} in the main worktree ${count === 1 ? "is" : "are"} not in this one: run \`${runner} local pull\` to copy ${count === 1 ? "it" : "them"} here.`;
|
|
45807
|
-
const render$2 = ({ items, pullable }, runner) => {
|
|
45808
|
-
if (items.length === 0) return pullable === 0 ? [empty] : [
|
|
45809
|
-
empty,
|
|
45810
|
-
"",
|
|
45811
|
-
pullLine(pullable, runner)
|
|
45812
|
-
];
|
|
45813
|
-
const missing = items.filter((item) => item.snapshot === "Missing").length;
|
|
45814
|
-
const stale = items.filter((item) => item.snapshot === "Stale").length;
|
|
45815
|
-
const uses = items.flatMap((item) => item.repo.uses ?? []);
|
|
45816
|
-
const provisional = uses.filter(isProvisional).length;
|
|
45817
|
-
const footer = [
|
|
45818
|
-
...missing === 0 ? [] : [missingLine(missing, runner)],
|
|
45819
|
-
...stale === 0 ? [] : [staleLine(stale, runner)],
|
|
45820
|
-
...provisional === 0 ? [] : [provisionalLine(provisional, runner)],
|
|
45821
|
-
...pullable === 0 ? [] : [pullLine(pullable, runner)]
|
|
45822
|
-
];
|
|
45823
|
-
return [
|
|
45824
|
-
header(runner),
|
|
45825
|
-
...uses.length === 0 ? [] : [legend],
|
|
45826
|
-
"",
|
|
45827
|
-
...items.flatMap(repoLines),
|
|
45828
|
-
...footer.length === 0 ? [] : ["", ...footer]
|
|
45829
|
-
];
|
|
45830
|
-
};
|
|
45831
|
-
const hookOutput = (event, lines) => {
|
|
45832
|
-
const additionalContext = lines.join("\n");
|
|
45833
|
-
return event === "sessionStart" ? JSON.stringify({ additional_context: additionalContext }) : JSON.stringify({ hookSpecificOutput: {
|
|
45834
|
-
hookEventName: event,
|
|
45835
|
-
additionalContext
|
|
45836
|
-
} });
|
|
45837
|
-
};
|
|
45838
|
-
//#endregion
|
|
45839
45900
|
//#region src/cli/Check.ts
|
|
45840
45901
|
const code = (tag) => tag.replaceAll(/(?<!^)[A-Z]/gu, (letter) => `-${letter}`).toLowerCase();
|
|
45841
45902
|
const json$2 = (findings, runner) => findings.map((finding) => {
|
|
@@ -46125,7 +46186,7 @@ const skills$1 = {
|
|
|
46125
46186
|
},
|
|
46126
46187
|
"core": {
|
|
46127
46188
|
description: "The vendy model and its reference — repos, snapshots, modes, the `uses` schema that makes up the map, what `vendy check` verifies, and the inventory verbs the other workflows leave out (inspect, sync, remove, cache cleanup, recovery).",
|
|
46128
|
-
content: "---\nname: core\ndescription: The vendy model and its reference — repos, snapshots, modes, the `uses` schema that makes up the map, what `vendy check` verifies, and the inventory verbs the other workflows leave out (inspect, sync, remove, cache cleanup, recovery).\n---\n\n# vendy core\n\nvendy keeps pinned snapshots of external repositories at `.vendy/<name>`, and a map of what this project uses each one for.\n\n- Treat `.vendy/` as read-only reference material: never edit it or import from it.\n- Edit only the `uses` of `vendy.json` by hand, then run `vendy check`. Every other field moves through a verb. Never edit vendy's managed block in `AGENTS.md`.\n\n## Repos and modes\n\n| Mode | Pin | Snapshot bytes | A fresh clone gets |\n| -------- | ------------------------- | -------------- | ----------------------------------- |\n| `shared` | committed in `vendy.json` | git-ignored | the pin; run `vendy sync` for bytes |\n| `local` | `vendy.local.json` | git-excluded | nothing |\n\nA repo is a **library repo** when a package its snapshot publishes is a dependency of a project package its scope covers, and a **reference repo** otherwise. The difference decides what it tracks:\n\n- **Library repos track release tags.** The project runs the published package, so the snapshot must be the same release: reading unreleased code on a branch produces calls the installed version does not have. \"Newest\" means the newest published release, and the dependency moves with the tag.\n- **Reference repos track branches** — projects imitated, documentation read. Nothing installed has to match them, except the version of a tool the project pins when the snapshot is that tool's documentation.\n\nNot every dependency is a repo: the vendor workflow's \"Is it worth a repo?\" says which ones are.\n\n### Matching a dependency to its snapshot\n\n- **Snapshot ahead:** set the dependency to the snapshot's own version, keeping the range operator already there (`^1.4.0` → `^1.5.0`). Never `latest`: it drifts out of step with the pin the moment upstream publishes again. A pnpm dependency written as `catalog:` takes its version from `pnpm-workspace.yaml`; change it there, not in `package.json`.\n- **Dependency ahead:** move the snapshot instead — `vendy track <name> <tag-of-that-release>`.\n- **No `package.json`, or no dependency on it:** a reference repo; nothing to align — unless it documents a tool the project pins, such as a package manager's docs and `packageManager` in `package.json`. Set that pin to the tool's newest stable release whenever the snapshot moves, and treat what the docs mark as added in a later version as not yet available.\n\n### Two releases of one library\n\nWhen part of the project has to run another release — a plugin pinned to the version its host was built with — one snapshot cannot describe both. Take that part out of the use's scope with a `!` glob (`\"scope\": [\"**/*.ts\", \"!packages/plugin/**\"]`): the snapshot then answers for the rest, and `vendy check` compares it only with the dependencies of the packages its scope covers. When that part's code needs evidence of its own, also vendor the same upstream under a second name at the release it runs (`vendy add <url> --name <name>-plugin --ref <tag>`), with a use scoped to it.\n\n## The map\n\nEach shared repo carries `uses`: one per role the snapshot plays in this project.\n\n```json\n{\n \"name\": \"opencode\",\n \"url\": \"https://github.com/anomalyco/opencode.git\",\n \"ref\": \"v2.0.22\",\n \"commit\": \"…\",\n \"uses\": [\n {\n \"for\": \"Writing vendy's OpenCode plugin\",\n \"scope\": [\"packages/opencode/**\"],\n \"read\": [\"services/www/src/docs/content/build/plugins/\"]\n },\n {\n \"for\": \"Self-update and distribution, modeled on opencode's\",\n \"scope\": [\"packages/vendy/src/upgrade/**\", \"install.sh\"],\n \"read\": [\"packages/cli/src/services/updater.ts\", \"install\"],\n \"guide\": \"docs/guides/self-update.md\"\n }\n ]\n}\n```\n\n| Field | Relative to | Meaning | Absent means |\n| ------- | ----------------- | ----------------------------------------------------------------- | ---------------------- |\n| `for` | — | The role, in the user's words. One clause, at most 120 characters | (required) |\n| `scope` | the project root | Globs for the project files this use governs; `!` globs exclude | the use is provisional |\n| `read` | the snapshot root | Where the evidence lives: docs, examples, tests, source | the use is provisional |\n| `guide` | the project root | This use's guide | no guide |\n\nA use scoped to all the code a snapshot shapes is **project-wide**: a framework like Effect governs every TypeScript file, so it has one use, scoped to `**/*.ts` (`**` only when every file is, docs and config included), `\"for\": \"Effect 4 APIs and Node platform behavior\"`, and never one per module it touches. A use with no `scope` or no `read` is **provisional**: written at vendoring time, before where it applies and its evidence are located, and completed by align.\n\nA local repo's uses live in `vendy.local.json` the same way, and its guides stay out of Git with it: that is how a project draws on a repository without its history naming it. `vendy check` reports a local guide that is committed or not excluded.\n\nThe catalog renders every use as one line, into every session. Keep `for` to the role and let `read` and the guide carry the detail. A role says what reading the snapshot settles: \"Effect is the application framework\" only restates the project's imports, while the use above names what it settles.\n\n`scope` shares that line, so write it in as few globs as name the feature exactly: `dir/**` for a directory the feature owns, one brace glob for sibling files (`scripts/{release.mts,distribution.ts}`, `.github/workflows/{publish,release-*}.yml`), never one glob per file. Shorter must not mean wider: every file a scope matches costs a read of its evidence before any change there.\n\n## Check\n\n```bash\nvendy check # every finding across the map; exits non-zero on any\nvendy check <name> # one repo's uses\n```\n\nEach finding is decidable without judgment:\n\n- a `uses` field with the wrong shape, or a `for` over budget\n- a `scope` glob, or one of its brace alternatives, that matches or excludes no file — the feature it covered is gone\n- a `read` path the snapshot does not contain — upstream moved or deleted it\n- a `guide` that does not exist\n- a provisional use\n- a library repo whose dependency, in a package its scope covers, is behind its snapshot, or ahead of it\n- a project file importing a vendored package that no use's scope covers or excludes\n\nWhether the code inside a scope actually follows its evidence takes judgment, and belongs to the health workflow.\n\n## Inspect\n\n```bash\nvendy list # all repos, including local ones; offline\nvendy show <name> # source, ref, pin, paths, mode, dependencies, uses\nvendy status # local integrity and upstream changes\nvendy status --log # also count and list the upstream commits touching each behind repo\nvendy catalog # the map as agents receive it\nvendy diff <name> # pinned snapshot versus local bytes\nvendy diff <name> <from>..<to> # revision range, filtered to repo paths\nvendy diff <name> <from>..<to> --read # only the paths the uses read; --stat for a diffstat\nvendy diff <name> <from>..<to> --dirstat # where upstream changed, by directory\nvendy diff <name> <from>..<to> <path>... # only these paths in the snapshot\nvendy diff <name> <from>..<to> --log # the upstream commits in the range, one per line\nvendy git <name> show <from>:<path>\n```\n\nSnapshots have no `.git`; read upstream history with `vendy diff`, and use `vendy git <name> <args>` for any other Git operation — everything after the name goes to git.\n\n`list`, `show`, `status`, and `check` take `--json` to print the same report as one JSON document, with the same exit code.\n\n`status` exits non-zero for modified, unexpectedly missing, or `unverified` snapshots. Behind or unreachable upstreams do not fail it. `unverified` means local integrity cannot be established, commonly after clearing the cache; run `vendy sync <name>`.\n\n## Maintain\n\n```bash\nvendy sync [<name>...] # restore bytes to existing pins\nvendy sync --prune # also delete what no repo owns: snapshot dirs, store views, indexes\nvendy mode <mode> <name>... # move repos between shared and local\nvendy local pull [<name>...] # copy the main worktree's local repos into this one\nvendy remove <name>... # remove repos, their uses, and their worktree state\nvendy store list # the shared cache: each upstream, its size, when it was last used\nvendy store gc --dry-run # preview cache cleanup; default age is 90 days\nvendy store gc --max-age 30d # reclaim eligible cache data\n```\n\n`sync` keeps pins fixed; moving them is the update workflow. A new worktree starts with no local repos, and `vendy local pull` never overwrites a copy that differs.\n\nThe store is a rebuildable cache shared across projects. `remove` and `sync --prune` leave it intact; `store gc` reclaims it, skipping busy or recently used stores. Commands that fetch also run it on their own, at most once a day (`VENDY_STORE_AUTO_CLEAN_FREQUENCY`: `never`, `always`, or a duration such as `12h`). `store gc --repack` also compacts retained stores.\n\n## Recover\n\n- **Modified snapshot:** inspect with `vendy diff <name>`. Before `sync` or `update` overwrites edits, it saves a rescue.\n- **Missing snapshot:** run `vendy sync <name>`.\n- **Failed operation:** do not delete internal locks or migration data as a generic repair.\n\nRescues belong to the current worktree and survive shared-cache cleanup. Removing a repo or pruning its orphan store view deletes its rescues too; recover anything needed first.\n"
|
|
46189
|
+
content: "---\nname: core\ndescription: The vendy model and its reference — repos, snapshots, modes, the `uses` schema that makes up the map, what `vendy check` verifies, and the inventory verbs the other workflows leave out (inspect, sync, remove, cache cleanup, recovery).\n---\n\n# vendy core\n\nvendy keeps pinned snapshots of external repositories at `.vendy/<name>`, and a map of what this project uses each one for.\n\n- Treat `.vendy/` as read-only reference material: never edit it or import from it.\n- Edit only the `uses` of `vendy.json` by hand, then run `vendy check`. Every other field moves through a verb. Never edit vendy's managed block in `AGENTS.md`.\n\n## Repos and modes\n\n| Mode | Pin | Snapshot bytes | A fresh clone gets |\n| -------- | ------------------------- | -------------- | ----------------------------------- |\n| `shared` | committed in `vendy.json` | git-ignored | the pin; run `vendy sync` for bytes |\n| `local` | `vendy.local.json` | git-excluded | nothing |\n\nA repo is a **library repo** when a package its snapshot publishes is a dependency of a project package its scope covers, and a **reference repo** otherwise. The difference decides what it tracks:\n\n- **Library repos track release tags.** The project runs the published package, so the snapshot must be the same release: reading unreleased code on a branch produces calls the installed version does not have. \"Newest\" means the newest published release, and the dependency moves with the tag.\n- **Reference repos track branches** — projects imitated, documentation read. Nothing installed has to match them, except the version of a tool the project pins when the snapshot is that tool's documentation.\n\nNot every dependency is a repo: the vendor workflow's \"Is it worth a repo?\" says which ones are.\n\n### Matching a dependency to its snapshot\n\n- **Snapshot ahead:** set the dependency to the snapshot's own version, keeping the range operator already there (`^1.4.0` → `^1.5.0`). Never `latest`: it drifts out of step with the pin the moment upstream publishes again. A pnpm dependency written as `catalog:` takes its version from `pnpm-workspace.yaml`; change it there, not in `package.json`.\n- **Dependency ahead:** move the snapshot instead — `vendy track <name> <tag-of-that-release>`.\n- **No `package.json`, or no dependency on it:** a reference repo; nothing to align — unless it documents a tool the project pins, such as a package manager's docs and `packageManager` in `package.json`. Set that pin to the tool's newest stable release whenever the snapshot moves, and treat what the docs mark as added in a later version as not yet available.\n\n### Two releases of one library\n\nWhen part of the project has to run another release — a plugin pinned to the version its host was built with — one snapshot cannot describe both. Take that part out of the use's scope with a `!` glob (`\"scope\": [\"**/*.ts\", \"!packages/plugin/**\"]`): the snapshot then answers for the rest, and `vendy check` compares it only with the dependencies of the packages its scope covers. When that part's code needs evidence of its own, also vendor the same upstream under a second name at the release it runs (`vendy add <url> --name <name>-plugin --ref <tag>`), with a use scoped to it.\n\n## The map\n\nEach shared repo carries `uses`: one per role the snapshot plays in this project.\n\n```json\n{\n \"name\": \"opencode\",\n \"url\": \"https://github.com/anomalyco/opencode.git\",\n \"ref\": \"v2.0.22\",\n \"commit\": \"…\",\n \"uses\": [\n {\n \"for\": \"Writing vendy's OpenCode plugin\",\n \"scope\": [\"packages/opencode/**\"],\n \"read\": [\"services/www/src/docs/content/build/plugins/\"]\n },\n {\n \"for\": \"Self-update and distribution, modeled on opencode's\",\n \"scope\": [\"packages/vendy/src/upgrade/**\", \"install.sh\"],\n \"read\": [\"packages/cli/src/services/updater.ts\", \"install\"],\n \"guide\": \"docs/guides/self-update.md\"\n }\n ]\n}\n```\n\n| Field | Relative to | Meaning | Absent means |\n| ------- | ----------------- | ----------------------------------------------------------------------------------------------- | ---------------------- |\n| `for` | — | The role, in the user's words. One clause, at most 120 characters, without `[`, `]`, `→` or `·` | (required) |\n| `scope` | the project root | Globs for the project files this use governs; `!` globs exclude | the use is provisional |\n| `read` | the snapshot root | Files or directories where the evidence lives: docs, examples, tests, source | the use is provisional |\n| `guide` | the project root | This use's guide, one file | no guide |\n\n`scope` globs are [picomatch](https://github.com/micromatch/picomatch) patterns that also match dot paths, so `**/*.ts` covers `.github/`. As in tinyglobby and fast-glob, a `!` glob subtracts from what every other glob matches, whatever their order, and no later glob adds a file back. `read` and `guide` are plain paths, never globs: a `read` directory covers everything under it.\n\nA use scoped to all the code a snapshot shapes is **project-wide**: a framework like Effect governs every TypeScript file, so it has one use, scoped to `**/*.ts` (`**` only when every file is, docs and config included), `\"for\": \"Effect 4 APIs and Node platform behavior\"`, and never one per module it touches. A use with no `scope` or no `read` is **provisional**: written at vendoring time, before where it applies and its evidence are located, and completed by align.\n\nA local repo's uses live in `vendy.local.json` the same way, and its guides stay out of Git with it: that is how a project draws on a repository without its history naming it. `vendy check` reports a local guide that is committed or not excluded.\n\nThe catalog renders every use as one line, into every session. Keep `for` to the role and let `read` and the guide carry the detail. A role says what reading the snapshot settles: \"Effect is the application framework\" only restates the project's imports, while the use above names what it settles.\n\n`scope` shares that line, so write it in as few globs as name the feature exactly: `dir/**` for a directory the feature owns, one brace glob for sibling files (`scripts/{release.mts,distribution.ts}`, `.github/workflows/{publish,release-*}.yml`), never one glob per file. Shorter must not mean wider: every file a scope matches costs a read of its evidence before any change there.\n\n## Check\n\n```bash\nvendy check # every finding across the map; exits non-zero on any\nvendy check <name> # one repo's uses\n```\n\nEach finding is decidable without judgment:\n\n- a `uses` field with the wrong shape, or a `for` over budget or containing `[`, `]`, `→` or `·`\n- a `scope` glob, or one of its brace alternatives, that matches or excludes no file — the feature it covered is gone\n- a `read` path the snapshot does not contain — upstream moved or deleted it\n- a `guide` that does not exist\n- a provisional use\n- a session catalog over the hook's 10,000-character limit even with only each use's `for` and scope; only when no repo is named\n- a library repo whose dependency, in a package its scope covers, is behind its snapshot, or ahead of it\n- a project file importing a vendored package that no use's scope covers or excludes\n\nWhether the code inside a scope actually follows its evidence takes judgment, and belongs to the health workflow.\n\n## Inspect\n\n```bash\nvendy list # all repos, including local ones; offline\nvendy show <name> # source, ref, pin, paths, mode, dependencies, uses\nvendy status # local integrity and upstream changes\nvendy status --log # also count and list the upstream commits touching each behind repo\nvendy catalog # the map as agents receive it\nvendy catalog <name>... # only these repos, with where to read\nvendy diff <name> # pinned snapshot versus local bytes\nvendy diff <name> <from>..<to> # revision range, filtered to repo paths\nvendy diff <name> <from>..<to> --read # only the paths the uses read; --stat for a diffstat\nvendy diff <name> <from>..<to> --dirstat # where upstream changed, by directory\nvendy diff <name> <from>..<to> <path>... # only these paths in the snapshot\nvendy diff <name> <from>..<to> --log # the upstream commits in the range, one per line\nvendy git <name> show <from>:<path>\n```\n\nSnapshots have no `.git`; read upstream history with `vendy diff`, and use `vendy git <name> <args>` for any other Git operation — everything after the name goes to git.\n\n`list`, `show`, `status`, and `check` take `--json` to print the same report as one JSON document, with the same exit code.\n\n`status` exits non-zero for modified, unexpectedly missing, or `unverified` snapshots. Behind or unreachable upstreams do not fail it. `unverified` means local integrity cannot be established, commonly after clearing the cache; run `vendy sync <name>`.\n\n## Maintain\n\n```bash\nvendy sync [<name>...] # restore bytes to existing pins\nvendy sync --prune # also delete what no repo owns: snapshot dirs, store views, indexes\nvendy mode <mode> <name>... # move repos between shared and local\nvendy local pull [<name>...] # copy the main worktree's local repos into this one\nvendy remove <name>... # remove repos, their uses, and their worktree state\nvendy store list # the shared cache: each upstream, its size, when it was last used\nvendy store gc --dry-run # preview cache cleanup; default age is 90 days\nvendy store gc --max-age 30d # reclaim eligible cache data\n```\n\n`sync` keeps pins fixed; moving them is the update workflow. A new worktree starts with no local repos, and `vendy local pull` never overwrites a copy that differs.\n\nThe store is a rebuildable cache shared across projects. `remove` and `sync --prune` leave it intact; `store gc` reclaims it, skipping busy or recently used stores. Commands that fetch also run it on their own, at most once a day (`VENDY_STORE_AUTO_CLEAN_FREQUENCY`: `never`, `always`, or a duration such as `12h`). `store gc --repack` also compacts retained stores.\n\n## Recover\n\n- **Modified snapshot:** inspect with `vendy diff <name>`. Before `sync` or `update` overwrites edits, it saves a rescue.\n- **Missing snapshot:** run `vendy sync <name>`.\n- **Failed operation:** do not delete internal locks or migration data as a generic repair.\n\nRescues belong to the current worktree and survive shared-cache cleanup. Removing a repo or pruning its orphan store view deletes its rescues too; recover anything needed first.\n"
|
|
46129
46190
|
},
|
|
46130
46191
|
"health": {
|
|
46131
46192
|
description: "Audit the whole map, or only the repos named — run vendy status and vendy check, let the user choose whether to bring any repo that is behind up to date first through the update workflow, then judge use by use whether the code in each scope follows its evidence, whether the map still describes the project, and whether each guide still holds. Fixes every finding, each citing both sides, commits the fixes, and reports what changed.",
|
|
@@ -46568,17 +46629,26 @@ const list = make("list", { json: jsonFlag }, fn("Cli.list")(function* (config)
|
|
|
46568
46629
|
if (lines.length === 0) return yield* emptyInventoryHint;
|
|
46569
46630
|
return yield* printLines(lines);
|
|
46570
46631
|
}, reportErrors)).pipe(withAlias("ls"), withDescription("List every repo, local ones included"));
|
|
46571
|
-
const catalogLines = fn("Cli.catalogLines")(function* (cwd) {
|
|
46632
|
+
const catalogLines = fn("Cli.catalogLines")(function* (cwd, names, render) {
|
|
46572
46633
|
const loaded = yield* result(load(cwd));
|
|
46573
|
-
if (isSuccess$1(loaded)) return render$
|
|
46634
|
+
if (isSuccess$1(loaded)) return render(yield* select$1(loaded.success, names), command(packageManager(cwd)));
|
|
46574
46635
|
const failure = loaded.failure;
|
|
46575
46636
|
return failure._tag === "ManifestParseError" || failure._tag === "ManifestValidationError" ? unreadable(failure.message) : yield* failure;
|
|
46576
46637
|
});
|
|
46577
|
-
const
|
|
46638
|
+
const renderHookCatalog = (loaded, runner) => renderWithin(loaded, runner, contextLimit);
|
|
46639
|
+
const catalogRenderer = (named, event) => {
|
|
46640
|
+
if (named) return renderNamed;
|
|
46641
|
+
return event === void 0 ? render$4 : renderHookCatalog;
|
|
46642
|
+
};
|
|
46643
|
+
const catalog = make("catalog", {
|
|
46644
|
+
names: String$2("name").pipe(withDescription$2("Repos to show; omit for every repo"), variadic()),
|
|
46645
|
+
hook: Literals("hook", hookEvents).pipe(optional, withMetavar("event"), withDescription$1("Emit the payload as hook JSON for this lifecycle event instead of plain text"), withHidden)
|
|
46646
|
+
}, fn("Cli.catalog")(function* (config) {
|
|
46578
46647
|
const event = getOrUndefined$1(config.hook);
|
|
46579
|
-
const
|
|
46580
|
-
|
|
46581
|
-
|
|
46648
|
+
const named = config.names.length > 0;
|
|
46649
|
+
const printed = catalogLines(process.cwd(), config.names, catalogRenderer(named, event)).pipe(flatMap$1((lines) => event === void 0 ? printLines(lines) : log(hookOutput(event, lines))));
|
|
46650
|
+
return yield* named ? reportErrors(printed) : printed.pipe(ignoreCause());
|
|
46651
|
+
})).pipe(withDescription("Print every repo, or the named ones, with one line per use and where to read for it"));
|
|
46582
46652
|
const setupAgents = Literals("agent", agents).pipe(atLeast(1), optional, withMetavar("claude|codex|cursor|opencode"), withDescription$1("Install hooks for an agent; repeat to select several. Agents not named lose vendy's hooks"));
|
|
46583
46653
|
const setupNoAgent = Boolean$1("no-agent").pipe(withDefault(false), withDescription$1("Install no session hooks, and uninstall any vendy installed before"));
|
|
46584
46654
|
const resolveSetupAgents = fn("Cli.resolveSetupAgents")(function* (flag, none, interactive, inspection) {
|
|
@@ -46650,7 +46720,7 @@ const setup = make("setup", {
|
|
|
46650
46720
|
yield* reportSkipped(newSkipped);
|
|
46651
46721
|
yield* printLines(result.changed.map(planLine));
|
|
46652
46722
|
if (agents.length === 0) yield* error("no session hook installed; `vendy catalog` will not be injected automatically");
|
|
46653
|
-
yield* note$1(render$
|
|
46723
|
+
yield* note$1(render$2(yield* devDependencyGap(preview.root)));
|
|
46654
46724
|
}, reportErrors)).pipe(withDescription("Install or repair vendy's project guidance and agent hooks"));
|
|
46655
46725
|
const statusVerdict = (statuses) => {
|
|
46656
46726
|
const dirty = statuses.filter(isDirty).length;
|
|
@@ -46760,7 +46830,7 @@ const withGitSeparator = (args) => {
|
|
|
46760
46830
|
const run = (args, config) => runWith(vendy, config)(withGitSeparator(args)).pipe(provideService(Blocking, (description) => error(`waiting for file lock on ${description}`)), provideService(runner, invocation(process.cwd())), provideService(CliConfig, cliConfig), provideService(Formatter, formatter));
|
|
46761
46831
|
//#endregion
|
|
46762
46832
|
//#region src/main.ts
|
|
46763
|
-
const version = "0.
|
|
46833
|
+
const version = "0.3.0";
|
|
46764
46834
|
const isSqliteExperimentalWarning = (warning) => warning.name === "ExperimentalWarning" && warning.message.startsWith("SQLite ");
|
|
46765
46835
|
for (const printWarning of process.listeners("warning")) {
|
|
46766
46836
|
process.off("warning", printWarning);
|
package/package.json
CHANGED