@lore-co/core 0.2.37 → 0.2.39

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.
Files changed (98) hide show
  1. package/dist/auth-schemas.d.ts +16 -0
  2. package/dist/auth-schemas.d.ts.map +1 -1
  3. package/dist/auth-schemas.js +14 -0
  4. package/dist/auth-schemas.js.map +1 -1
  5. package/dist/beta-features.d.ts +29 -0
  6. package/dist/beta-features.d.ts.map +1 -0
  7. package/dist/beta-features.js +28 -0
  8. package/dist/beta-features.js.map +1 -0
  9. package/dist/connection-refresh.d.ts +91 -0
  10. package/dist/connection-refresh.d.ts.map +1 -0
  11. package/dist/connection-refresh.js +525 -0
  12. package/dist/connection-refresh.js.map +1 -0
  13. package/dist/guard-evaluation.d.ts +29 -0
  14. package/dist/guard-evaluation.d.ts.map +1 -1
  15. package/dist/guard-evaluation.js +174 -0
  16. package/dist/guard-evaluation.js.map +1 -1
  17. package/dist/in-memory-repository.d.ts +3 -0
  18. package/dist/in-memory-repository.d.ts.map +1 -1
  19. package/dist/in-memory-repository.js +8 -0
  20. package/dist/in-memory-repository.js.map +1 -1
  21. package/dist/index.d.ts +7 -0
  22. package/dist/index.d.ts.map +1 -1
  23. package/dist/index.js +7 -0
  24. package/dist/index.js.map +1 -1
  25. package/dist/local-scope.d.ts +3 -0
  26. package/dist/local-scope.d.ts.map +1 -1
  27. package/dist/local-scope.js +8 -4
  28. package/dist/local-scope.js.map +1 -1
  29. package/dist/package-names.d.ts +10 -0
  30. package/dist/package-names.d.ts.map +1 -0
  31. package/dist/package-names.js +22 -0
  32. package/dist/package-names.js.map +1 -0
  33. package/dist/package-rules.d.ts +54 -0
  34. package/dist/package-rules.d.ts.map +1 -0
  35. package/dist/package-rules.js +132 -0
  36. package/dist/package-rules.js.map +1 -0
  37. package/dist/package-warnings.d.ts +63 -0
  38. package/dist/package-warnings.d.ts.map +1 -0
  39. package/dist/package-warnings.js +69 -0
  40. package/dist/package-warnings.js.map +1 -0
  41. package/dist/pilot-schemas.d.ts +3 -3
  42. package/dist/platform-admin-schemas.d.ts +6 -0
  43. package/dist/platform-admin-schemas.d.ts.map +1 -1
  44. package/dist/platform-admin-schemas.js +2 -0
  45. package/dist/platform-admin-schemas.js.map +1 -1
  46. package/dist/ports.d.ts +2 -0
  47. package/dist/ports.d.ts.map +1 -1
  48. package/dist/problem-reports.d.ts +352 -0
  49. package/dist/problem-reports.d.ts.map +1 -0
  50. package/dist/problem-reports.js +94 -0
  51. package/dist/problem-reports.js.map +1 -0
  52. package/dist/product-usage.d.ts +41 -3
  53. package/dist/product-usage.d.ts.map +1 -1
  54. package/dist/product-usage.js +18 -4
  55. package/dist/product-usage.js.map +1 -1
  56. package/dist/public-rule-text.d.ts +10 -0
  57. package/dist/public-rule-text.d.ts.map +1 -0
  58. package/dist/public-rule-text.js +24 -0
  59. package/dist/public-rule-text.js.map +1 -0
  60. package/dist/public-rules-client.d.ts +75 -0
  61. package/dist/public-rules-client.d.ts.map +1 -0
  62. package/dist/public-rules-client.js +273 -0
  63. package/dist/public-rules-client.js.map +1 -0
  64. package/dist/public-rules.d.ts +121 -0
  65. package/dist/public-rules.d.ts.map +1 -0
  66. package/dist/public-rules.js +192 -0
  67. package/dist/public-rules.js.map +1 -0
  68. package/dist/pull-request-rules.d.ts +30 -0
  69. package/dist/pull-request-rules.d.ts.map +1 -0
  70. package/dist/pull-request-rules.js +16 -0
  71. package/dist/pull-request-rules.js.map +1 -0
  72. package/dist/redaction.d.ts +7 -0
  73. package/dist/redaction.d.ts.map +1 -1
  74. package/dist/redaction.js +30 -0
  75. package/dist/redaction.js.map +1 -1
  76. package/dist/reliability-schemas.d.ts +2 -2
  77. package/dist/schemas.d.ts +2 -2
  78. package/dist/search-schemas.d.ts +1 -1
  79. package/dist/session-schemas.d.ts +6 -0
  80. package/dist/session-schemas.d.ts.map +1 -1
  81. package/dist/session-schemas.js +2 -0
  82. package/dist/session-schemas.js.map +1 -1
  83. package/dist/skill-context.d.ts +0 -3
  84. package/dist/skill-context.d.ts.map +1 -1
  85. package/dist/skill-context.js +2 -15
  86. package/dist/skill-context.js.map +1 -1
  87. package/dist/skill-folder.d.ts.map +1 -1
  88. package/dist/skill-folder.js +10 -5
  89. package/dist/skill-folder.js.map +1 -1
  90. package/dist/skill-secrets.d.ts +11 -0
  91. package/dist/skill-secrets.d.ts.map +1 -0
  92. package/dist/skill-secrets.js +263 -0
  93. package/dist/skill-secrets.js.map +1 -0
  94. package/dist/skills.d.ts +34 -5
  95. package/dist/skills.d.ts.map +1 -1
  96. package/dist/skills.js +127 -36
  97. package/dist/skills.js.map +1 -1
  98. package/package.json +17 -1
@@ -0,0 +1,273 @@
1
+ import { constants } from "node:fs";
2
+ import { lstat, open, readdir, realpath } from "node:fs/promises";
3
+ import { dirname, join, relative, resolve, sep } from "node:path";
4
+ import { escapeLoreContextDelimiters } from "./delivered-text.js";
5
+ import { normalizePackageName, packageLabel } from "./package-names.js";
6
+ import { PUBLIC_RULES_LIMITS, publicRuleLine } from "./public-rule-text.js";
7
+ import { repositoryIdentity } from "./repository-address.js";
8
+ const MAX_MANIFEST_BYTES = 1_000_000;
9
+ const MAX_DEPENDENCIES = 500;
10
+ async function regularFileText(file) {
11
+ // Never follow a link, never wait on a pipe, and skip anything huge.
12
+ const handle = await open(file, constants.O_RDONLY | (constants.O_NOFOLLOW ?? 0) | (constants.O_NONBLOCK ?? 0)).catch(() => undefined);
13
+ if (handle === undefined)
14
+ return undefined;
15
+ try {
16
+ const info = await handle.stat();
17
+ if (!info.isFile() || info.size > MAX_MANIFEST_BYTES)
18
+ return undefined;
19
+ return await handle.readFile("utf8");
20
+ }
21
+ catch {
22
+ return undefined;
23
+ }
24
+ finally {
25
+ await handle.close().catch(() => undefined);
26
+ }
27
+ }
28
+ function npmDependencies(text) {
29
+ try {
30
+ const manifest = JSON.parse(text);
31
+ return ["dependencies", "devDependencies", "peerDependencies", "optionalDependencies"]
32
+ .flatMap(field => typeof manifest[field] === "object" && manifest[field] !== null ? Object.keys(manifest[field]) : []);
33
+ }
34
+ catch {
35
+ return [];
36
+ }
37
+ }
38
+ /** The leading package name of a PEP 508 requirement such as `requests[socks]>=2; python_version>"3"`. */
39
+ function requirementName(line) {
40
+ const name = /^\s*([A-Za-z0-9][A-Za-z0-9._-]*)/u.exec(line)?.[1];
41
+ return name === undefined || /^(?:python)$/iu.test(name) ? undefined : name;
42
+ }
43
+ /** `[project] dependencies` and Poetry's dependency tables. A small reader for these keys only, not a TOML parser. */
44
+ function pyprojectDependencies(text) {
45
+ const names = [];
46
+ let table = "";
47
+ let inArray = false;
48
+ for (const raw of text.split(/\r?\n/u)) {
49
+ const line = raw.replace(/\s+#.*$/u, "").trim();
50
+ if (inArray) {
51
+ for (const match of line.matchAll(/["']([^"']+)["']/gu)) {
52
+ const name = requirementName(match[1]);
53
+ if (name)
54
+ names.push(name);
55
+ }
56
+ if (line.includes("]"))
57
+ inArray = false;
58
+ continue;
59
+ }
60
+ const header = /^\[([^\]]+)\]$/u.exec(line);
61
+ if (header) {
62
+ table = header[1].trim();
63
+ continue;
64
+ }
65
+ if (table === "project" && /^dependencies\s*=\s*\[/u.test(line)) {
66
+ for (const match of line.matchAll(/["']([^"']+)["']/gu)) {
67
+ const name = requirementName(match[1]);
68
+ if (name)
69
+ names.push(name);
70
+ }
71
+ inArray = !line.includes("]");
72
+ continue;
73
+ }
74
+ if (/^tool\.poetry(?:\.group\.[^.]+)?\.(?:dev-)?dependencies$/u.test(table)) {
75
+ const key = /^["']?([A-Za-z0-9][A-Za-z0-9._-]*)["']?\s*=/u.exec(line)?.[1];
76
+ if (key && key.toLowerCase() !== "python")
77
+ names.push(key);
78
+ }
79
+ }
80
+ return names;
81
+ }
82
+ function requirementsDependencies(text) {
83
+ return text.split(/\r?\n/u).flatMap(raw => {
84
+ const line = raw.replace(/\s+#.*$/u, "").trim();
85
+ if (!line || line.startsWith("#") || line.startsWith("-") || /^[a-z]+:\/\//iu.test(line))
86
+ return [];
87
+ const name = requirementName(line);
88
+ return name === undefined ? [] : [name];
89
+ });
90
+ }
91
+ /** The real path of a folder, or of the nearest folder above it that exists. */
92
+ async function existingRealPath(folder) {
93
+ let current = folder;
94
+ while (true) {
95
+ const real = await realpath(current).catch(() => undefined);
96
+ if (real !== undefined)
97
+ return current === folder ? real : join(real, relative(current, folder));
98
+ if (dirname(current) === current)
99
+ return undefined;
100
+ current = dirname(current);
101
+ }
102
+ }
103
+ /**
104
+ * Direct dependencies named in the checkout root and in the nearest package
105
+ * folder from `cwd` up to the root: names only, never versions, lockfiles or
106
+ * registry addresses.
107
+ */
108
+ export async function readProjectDependencies(root, cwd) {
109
+ const top = await realpath(root).catch(() => resolve(root));
110
+ const folders = [top];
111
+ // A working folder reached through a link out of the checkout is not part of it.
112
+ const real = cwd === undefined ? undefined : await existingRealPath(resolve(cwd));
113
+ if (real !== undefined) {
114
+ let current = real;
115
+ while (current !== top && (current + sep).startsWith(top + sep) && !relative(top, current).startsWith("..")) {
116
+ const entries = await readdir(current).catch(() => []);
117
+ if (entries.some(entry => entry === "package.json" || entry === "pyproject.toml" || /^requirements.*\.txt$/u.test(entry))) {
118
+ folders.push(current);
119
+ break;
120
+ }
121
+ current = dirname(current);
122
+ }
123
+ }
124
+ const found = new Map();
125
+ const add = (ecosystem, raw) => {
126
+ const name = normalizePackageName(ecosystem, raw);
127
+ if (name !== undefined && found.size < MAX_DEPENDENCIES)
128
+ found.set(`${ecosystem}:${name}`, { ecosystem, name });
129
+ };
130
+ for (const folder of folders) {
131
+ const packageJson = await regularFileText(join(folder, "package.json"));
132
+ if (packageJson !== undefined)
133
+ npmDependencies(packageJson).forEach(name => add("npm", name));
134
+ const pyproject = await regularFileText(join(folder, "pyproject.toml"));
135
+ if (pyproject !== undefined)
136
+ pyprojectDependencies(pyproject).forEach(name => add("pypi", name));
137
+ for (const entry of (await readdir(folder).catch(() => [])).filter(entry => /^requirements.*\.txt$/u.test(entry)).slice(0, 10)) {
138
+ const text = await regularFileText(join(folder, entry));
139
+ if (text !== undefined)
140
+ requirementsDependencies(text).forEach(name => add("pypi", name));
141
+ }
142
+ }
143
+ return [...found.values()];
144
+ }
145
+ const SETTING_MS = 60 * 60_000;
146
+ const RETRY_AFTER_FAILURE_MS = 5 * 60_000;
147
+ const INDEX_MS = 24 * 60 * 60_000;
148
+ const RULES_MS = 60 * 60_000;
149
+ const MAX_SUBJECTS = 10;
150
+ const MAX_BLOCK_CHARACTERS = 2_000;
151
+ const subjectKey = (subject) => subject.kind === "repository" ? `repository:${subject.repository}` : `package:${subject.ecosystem}:${subject.name}`;
152
+ /** The subjects on Lore's public list that this checkout is, or depends on, minus the workspace's own. */
153
+ export function matchPublicRules(index, checkout, own) {
154
+ const listed = new Set(index.map(subjectKey));
155
+ const ownKeys = new Set([...own.repositories.map(repository => `repository:${repository}`), ...own.packages.map(item => `package:${item.ecosystem}:${item.name}`)]);
156
+ const identity = checkout.repository === undefined ? undefined : repositoryIdentity(checkout.repository);
157
+ const candidates = [
158
+ ...(identity === undefined ? [] : [{ kind: "repository", repository: identity }]),
159
+ ...checkout.dependencies.map(item => ({ kind: "package", ecosystem: item.ecosystem, name: item.name })),
160
+ ];
161
+ return candidates.filter(subject => listed.has(subjectKey(subject)) && !ownKeys.has(subjectKey(subject))).slice(0, MAX_SUBJECTS);
162
+ }
163
+ /** The block agents get: whole rule lines only, within its budget, framed as another team's rules, never the workspace's own decisions. */
164
+ export function renderPublicRulesBlock(sections) {
165
+ let text = [
166
+ "## Rules from outside your workspace",
167
+ "",
168
+ "The maintainers of this repository and the makers of packages it uses published these rules with Lore. Follow them where they apply; your team's decisions and the user's request come first.",
169
+ "",
170
+ PUBLIC_RULES_LIMITS,
171
+ ].join("\n");
172
+ const header = text;
173
+ for (const { subject, rules } of sections) {
174
+ const title = subject.kind === "repository"
175
+ ? `\n\n### ${subject.repository.replace(/^github\.com\//u, "")}, from its maintainers`
176
+ : `\n\n### ${packageLabel(subject.ecosystem, subject.name)}, from its makers`;
177
+ let section = title;
178
+ for (const rule of rules) {
179
+ const line = `\n${publicRuleLine(rule)}`;
180
+ if (text.length + section.length + line.length > MAX_BLOCK_CHARACTERS)
181
+ break;
182
+ section += line;
183
+ }
184
+ if (section !== title)
185
+ text += section;
186
+ }
187
+ return text === header ? undefined : escapeLoreContextDelimiters(text);
188
+ }
189
+ async function cached(cache, key, maxAgeMs, now, load) {
190
+ const saved = await cache.read(key).catch(() => undefined);
191
+ if (saved !== undefined && now - saved.writtenAt < maxAgeMs)
192
+ return saved.value;
193
+ // After a failure, wait a few minutes before asking again instead of on every prompt.
194
+ const failed = await cache.read(`${key}:failed`).catch(() => undefined);
195
+ if (failed !== undefined && now - failed.writtenAt < RETRY_AFTER_FAILURE_MS)
196
+ return saved?.value;
197
+ const fresh = await load(saved?.value).catch(() => undefined);
198
+ if (fresh === undefined) {
199
+ await cache.write(`${key}:failed`, true).catch(() => undefined);
200
+ return saved?.value;
201
+ }
202
+ await cache.write(key, fresh).catch(() => undefined);
203
+ return fresh;
204
+ }
205
+ /**
206
+ * The block of public rules for a checkout, or undefined: off on this machine
207
+ * or for the workspace, nothing matched, or Lore unreachable with nothing
208
+ * cached. Each network call is short and failures fall back to the cache.
209
+ */
210
+ export async function publicRulesForCheckout(input) {
211
+ const call = input.fetch ?? fetch;
212
+ const now = input.now ?? Date.now();
213
+ const api = input.apiUrl.replace(/\/+$/u, "");
214
+ const timeout = () => AbortSignal.timeout(input.timeoutMs ?? 600);
215
+ const [setting, index] = await Promise.all([
216
+ cached(input.cache, "public-rules-setting", SETTING_MS, now, async () => {
217
+ const response = await call(`${api}/v1/workspace/package-rules`, { headers: { accept: "application/json", authorization: `Bearer ${input.token}` }, signal: timeout() });
218
+ // A connection that may not read the setting, or a server without it, gets nothing.
219
+ if (response.status === 403 || response.status === 404)
220
+ return { enabled: false, own: { repositories: [], packages: [] } };
221
+ return response.ok ? await response.json() : undefined;
222
+ }),
223
+ cached(input.cache, "public-rules-index", INDEX_MS, now, async (previous) => {
224
+ const response = await call(`${api}/public/v1/rules/index`, { headers: { accept: "application/json", ...(previous?.etag ? { "if-none-match": previous.etag } : {}) }, signal: timeout() });
225
+ if (response.status === 304 && previous)
226
+ return previous;
227
+ if (!response.ok)
228
+ return undefined;
229
+ const etag = response.headers.get("etag");
230
+ return { ...(etag ? { etag } : {}), entries: (await response.json()).entries };
231
+ }),
232
+ ]);
233
+ // The workspace's choice unknown: nothing, rather than rules an admin may have turned off.
234
+ if (setting?.enabled !== true || !index?.entries.length)
235
+ return undefined;
236
+ const dependencies = input.root === undefined ? [] : await readProjectDependencies(input.root, input.cwd);
237
+ const subjects = matchPublicRules(index.entries, { ...(input.repository && !input.skipRepository ? { repository: input.repository } : {}), dependencies }, setting.own);
238
+ if (subjects.length === 0)
239
+ return undefined;
240
+ const sections = await Promise.all(subjects.map(async (subject) => {
241
+ const rules = await cached(input.cache, `public-rules:${subjectKey(subject)}`, RULES_MS, now, async () => {
242
+ const path = subject.kind === "repository"
243
+ ? `/public/v1/rules/${subject.repository.replace(/^github\.com\//u, "")}?channel=lore_context`
244
+ : `/public/v1/packages/${subject.ecosystem}/rules?channel=client&name=${encodeURIComponent(subject.name)}`;
245
+ const response = await call(`${api}${path}`, { headers: { accept: "application/json" }, signal: timeout() });
246
+ if (response.status === 404)
247
+ return [];
248
+ return response.ok ? (await response.json()).rules.map(rule => rule.text) : undefined;
249
+ });
250
+ return { subject, rules: rules ?? [] };
251
+ }));
252
+ return renderPublicRulesBlock(sections);
253
+ }
254
+ /** A cache for a long-running process, such as the MCP server. */
255
+ export function memoryPublicRulesCache() {
256
+ const entries = new Map();
257
+ return {
258
+ async read(key) { return entries.get(key); },
259
+ async write(key, value) { entries.set(key, { writtenAt: Date.now(), value }); },
260
+ };
261
+ }
262
+ /** The Git checkout around a folder: the nearest folder up that holds `.git`. */
263
+ export async function checkoutRoot(cwd) {
264
+ let current = resolve(cwd);
265
+ while (true) {
266
+ if (await lstat(join(current, ".git")).then(() => true, () => false))
267
+ return current;
268
+ if (dirname(current) === current)
269
+ return undefined;
270
+ current = dirname(current);
271
+ }
272
+ }
273
+ //# sourceMappingURL=public-rules-client.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"public-rules-client.js","sourceRoot":"","sources":["../src/public-rules-client.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,121 @@
1
+ import { z } from "zod";
2
+ /** Public rules beta: the most rules one repository can publish, and how long each can be. */
3
+ export declare const PUBLIC_RULES_PER_REPOSITORY = 50;
4
+ export declare const PUBLIC_RULE_MAX_LENGTH = 500;
5
+ /** A GitHub owner or repository name as Lore accepts it in a public address: never only dots. */
6
+ export declare const PUBLIC_REPOSITORY_SEGMENT: RegExp;
7
+ export type PublicRuleRefusalKind = "too_long" | "hidden" | "private" | "link" | "command" | "agent";
8
+ /** Why this text can't be published, and what kind of reason that is, or null when it can. */
9
+ export declare function publicRuleRefusal(content: string): {
10
+ kind: PublicRuleRefusalKind;
11
+ message: string;
12
+ } | null;
13
+ /** Why this text can't be published, or null when it can. Only the text is ever public. */
14
+ export declare function publicRuleProblem(content: string): string | null;
15
+ export declare const VerifyPublicRepositoryRequestSchema: z.ZodObject<{
16
+ repository: z.ZodString;
17
+ githubToken: z.ZodString;
18
+ }, z.core.$strict>;
19
+ export type VerifyPublicRepositoryRequest = z.infer<typeof VerifyPublicRepositoryRequestSchema>;
20
+ export declare const PublicRepositorySchema: z.ZodObject<{
21
+ repository: z.ZodString;
22
+ permission: z.ZodEnum<{
23
+ admin: "admin";
24
+ maintain: "maintain";
25
+ }>;
26
+ verifiedAt: z.ZodISODateTime;
27
+ }, z.core.$strict>;
28
+ export declare const PublicRuleSchema: z.ZodObject<{
29
+ learningId: z.ZodUUID;
30
+ content: z.ZodString;
31
+ repository: z.ZodString;
32
+ publishedAt: z.ZodISODateTime;
33
+ publishedBy: z.ZodNullable<z.ZodString>;
34
+ askedBefore: z.ZodNumber;
35
+ askedSince: z.ZodNumber;
36
+ withheld: z.ZodOptional<z.ZodString>;
37
+ }, z.core.$strict>;
38
+ export type PublicRule = z.infer<typeof PublicRuleSchema>;
39
+ export declare const PublicRulesOverviewSchema: z.ZodObject<{
40
+ repositories: z.ZodArray<z.ZodObject<{
41
+ repository: z.ZodString;
42
+ permission: z.ZodEnum<{
43
+ admin: "admin";
44
+ maintain: "maintain";
45
+ }>;
46
+ verifiedAt: z.ZodISODateTime;
47
+ }, z.core.$strict>>;
48
+ rules: z.ZodArray<z.ZodObject<{
49
+ learningId: z.ZodUUID;
50
+ content: z.ZodString;
51
+ repository: z.ZodString;
52
+ publishedAt: z.ZodISODateTime;
53
+ publishedBy: z.ZodNullable<z.ZodString>;
54
+ askedBefore: z.ZodNumber;
55
+ askedSince: z.ZodNumber;
56
+ withheld: z.ZodOptional<z.ZodString>;
57
+ }, z.core.$strict>>;
58
+ lost: z.ZodArray<z.ZodObject<{
59
+ repository: z.ZodString;
60
+ at: z.ZodISODateTime;
61
+ }, z.core.$strict>>;
62
+ packages: z.ZodArray<z.ZodObject<{
63
+ id: z.ZodUUID;
64
+ ecosystem: z.ZodEnum<{
65
+ npm: "npm";
66
+ pypi: "pypi";
67
+ }>;
68
+ name: z.ZodString;
69
+ repository: z.ZodString;
70
+ verifiedAt: z.ZodISODateTime;
71
+ rules: z.ZodArray<z.ZodObject<{
72
+ learningId: z.ZodUUID;
73
+ content: z.ZodString;
74
+ publishedBy: z.ZodNullable<z.ZodString>;
75
+ withheld: z.ZodOptional<z.ZodString>;
76
+ }, z.core.$strict>>;
77
+ }, z.core.$strict>>;
78
+ }, z.core.$strict>;
79
+ export type PublicRulesOverview = z.infer<typeof PublicRulesOverviewSchema>;
80
+ export declare const PUBLIC_RULES_BLOCK_START = "<!-- BEGIN LORE PUBLIC RULES -->";
81
+ export declare const PUBLIC_RULES_BLOCK_END = "<!-- END LORE PUBLIC RULES -->";
82
+ export declare const AGENT_POINTER_START = "<!-- BEGIN LORE AGENTS.md -->";
83
+ export declare const AGENT_POINTER_END = "<!-- END LORE AGENTS.md -->";
84
+ export declare const PublicRulesBlockSchema: z.ZodObject<{
85
+ repository: z.ZodString;
86
+ pageUrl: z.ZodURL;
87
+ rulesUrl: z.ZodURL;
88
+ block: z.ZodString;
89
+ }, z.core.$strict>;
90
+ export type PublicRulesBlock = z.infer<typeof PublicRulesBlockSchema>;
91
+ /** The block Lore keeps in a repository's AGENTS.md. */
92
+ export declare function renderPublicRulesBlock(input: {
93
+ rules: readonly string[];
94
+ pageUrl: string;
95
+ rulesUrl: string;
96
+ }): string;
97
+ /** The pointer for agents that read their own file and can import AGENTS.md (Claude Code, Gemini CLI). */
98
+ export declare const AGENT_POINTER_BLOCK: string;
99
+ /**
100
+ * The file with Lore's block put in or replaced, leaving everything outside
101
+ * the markers as it was. Throws when the markers are broken or repeated, so
102
+ * nobody's text is overwritten by guesswork.
103
+ */
104
+ export declare function withManagedBlock(text: string, block: string, start: string, end: string): string;
105
+ /**
106
+ * A repository's public rules as Markdown, for agents that fetch them or call
107
+ * the hosted MCP tool: the rules framed as the maintainers', with a link to
108
+ * their page. Each rule is one cleaned line.
109
+ */
110
+ export declare function renderPublicRulesMarkdown(input: {
111
+ repository: string;
112
+ rules: readonly {
113
+ text: string;
114
+ askedCount: number;
115
+ }[];
116
+ pageUrl: string;
117
+ selected?: boolean;
118
+ audience?: "repository" | "package";
119
+ }): string;
120
+ export { PUBLIC_RULES_LIMITS, publicRuleLine, visiblePublicRuleText } from "./public-rule-text.js";
121
+ //# sourceMappingURL=public-rules.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"public-rules.d.ts","sourceRoot":"","sources":["../src/public-rules.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,8FAA8F;AAC9F,eAAO,MAAM,2BAA2B,KAAK,CAAC;AAC9C,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAE1C,iGAAiG;AACjG,eAAO,MAAM,yBAAyB,QAAqC,CAAC;AAwD5E,MAAM,MAAM,qBAAqB,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;AAErG,8FAA8F;AAC9F,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,qBAAqB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAkB1G;AAED,2FAA2F;AAC3F,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEhE;AAED,eAAO,MAAM,mCAAmC;;;kBAIrC,CAAC;AACZ,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mCAAmC,CAAC,CAAC;AAEhG,eAAO,MAAM,sBAAsB;;;;;;;kBAIxB,CAAC;AAEZ,eAAO,MAAM,gBAAgB;;;;;;;;;kBAYlB,CAAC;AACZ,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAO3B,CAAC;AACZ,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,eAAO,MAAM,wBAAwB,qCAAqC,CAAC;AAC3E,eAAO,MAAM,sBAAsB,mCAAmC,CAAC;AACvE,eAAO,MAAM,mBAAmB,kCAAkC,CAAC;AACnE,eAAO,MAAM,iBAAiB,gCAAgC,CAAC;AAE/D,eAAO,MAAM,sBAAsB;;;;;kBAKxB,CAAC;AACZ,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,wDAAwD;AACxD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAAE,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAerH;AAED,0GAA0G;AAC1G,eAAO,MAAM,mBAAmB,QAAoE,CAAC;AAErG;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAShG;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,YAAY,GAAG,SAAS,CAAA;CAAE,GAAG,MAAM,CAgBjN;AAED,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC"}
@@ -0,0 +1,192 @@
1
+ import { z } from "zod";
2
+ import { PUBLIC_RULES_LIMITS, publicRuleLine, visiblePublicRuleText } from "./public-rule-text.js";
3
+ import { redactSensitiveText } from "./redaction.js";
4
+ import { PublicPackageSchema } from "./package-rules.js";
5
+ /** Public rules beta: the most rules one repository can publish, and how long each can be. */
6
+ export const PUBLIC_RULES_PER_REPOSITORY = 50;
7
+ export const PUBLIC_RULE_MAX_LENGTH = 500;
8
+ /** A GitHub owner or repository name as Lore accepts it in a public address: never only dots. */
9
+ export const PUBLIC_REPOSITORY_SEGMENT = /^(?!\.+$)[A-Za-z0-9_.-]{1,100}$/u;
10
+ // Agents outside the workspace follow public rules, so a rule never carries a link, or a way to
11
+ // fetch, install or run software: a taken-over owner or admin account can't turn it into a payload.
12
+ const PUBLIC_RULE_LINK = [
13
+ /\b[a-z][a-z0-9+.-]*:\/\/|\bwww\./iu,
14
+ // A host with a path, such as example.sh/x, but not a file name such as index.ts/.
15
+ /\b(?:[a-z0-9-]+\.)+(?!(?:[cm]?js|jsx|tsx?|md|py|rb|rs|json|ya?ml|toml|txt|vue|css|lock)\/)[a-z]{2,24}\/\S/iu,
16
+ /\b\d{1,3}(?:\.\d{1,3}){3}\b/u,
17
+ /\[[0-9a-f:]*:[0-9a-f:]*\]:\d/iu,
18
+ // Links without "://": other schemes, Git's user@host:path, and addresses written to dodge a check.
19
+ /\b(?:javascript|vbscript|mailto):\S|\bdata:[a-z]+\/|\bfile:\/|\bgit@[\w.-]+:/iu,
20
+ /\bhxxps?\b|\[(?:\.|dot)\]/iu,
21
+ // A bare address, but not ASP.NET.
22
+ /\b[a-z0-9-]+\.(?:com|net|org)\b(?<!\basp\.net)/iu,
23
+ ];
24
+ const PUBLIC_RULE_COMMAND = [
25
+ // Piping into a shell or an interpreter.
26
+ /\|\s*(?:sudo\s+)?(?:(?:ba|z|da|k|fi|c|tc)?sh|python[0-9.]*|node|deno|bun|perl|ruby|php|iex|pwsh|powershell)\b/iu,
27
+ // Downloading.
28
+ /\b(?:curl|wget|Invoke-WebRequest|Invoke-RestMethod|Invoke-Expression|iwr|irm|certutil|bitsadmin)\b/iu,
29
+ // Running a package straight from a registry.
30
+ /\b(?:npx|pnpx|bunx|uvx|pipx)\b|\b(?:pnpm|yarn)\s+dlx\b|\bnpm\s+(?:exec|x)\b/iu,
31
+ // Installing packages. A bare `pnpm install` is fine; one followed by a name is not.
32
+ /\b(?:pip[0-9.]*|uv|poetry|pdm|conda|gem|cargo|go|brew|apt(?:-get)?|yum|dnf|apk|choco|winget|scoop)\s+(?:pip\s+|tool\s+)?(?:install|add)\b/iu,
33
+ /\b(?:npm|pnpm|yarn|bun)\s+(?:(?:-\S+|global)\s+)*(?:add\b|(?:install|i)\s+(?:-\S+\s+)*(?!(?:and|before|after|first|then|to|when|once|if|for|in|with|from|on|or|not)\b)[@A-Za-z0-9])/iu,
34
+ /\bdeno\s+(?:install|add)\b|\bdeno\s+run\s+(?:-\S+\s+)*(?:npm|jsr):/iu,
35
+ /\beasy_install\b|\bcomposer\s+(?:require|global)\b|\bdotnet\s+(?:add\s+package|tool\s+install)\b|\bnuget\s+install\b|\bgo\s+get\b|\bgo\s+run\s+\S+@/iu,
36
+ /\badd\s+\S+\s+to\s+(?:the\s+|your\s+)?(?:\S+\s+)?(?:dependencies|devDependencies|package\.json|requirements\.txt|pyproject\.toml|Gemfile|go\.mod|Cargo\.toml)\b/iu,
37
+ // Getting code from elsewhere.
38
+ /\bgit\s+(?:clone|submodule\s+add|remote\s+add)\b|\b(?:docker|podman)\s+(?:run|pull)\b/iu,
39
+ // Running code given inline, or making a file runnable.
40
+ /\b(?:ba|z|da|k|fi)?sh\s+-c\b|\b(?:python[0-9.]*|node|ruby|perl|php)\s+(?:-c|-e|--eval)\b|\beval\s+["'$`(]/iu,
41
+ /\bchmod\s+(?:\S*x|[0-7]{3,4})\b/iu,
42
+ // Copying files to another machine.
43
+ /\b(?:scp|sftp|rsync|socat|ncat|netcat|aria2c)\b|\bnc\s+-?[a-z0-9]|\bssh\s+\S+@/iu,
44
+ // Scripts that run on install, and Git hooks.
45
+ /\b(?:pre|post)install\b|\bprepare\s+script\b|"prepare"\s*:|\bcore\.hooksPath\b/iu,
46
+ // Running as root, or deleting recursively.
47
+ /\bsudo\b|\brm\s+-[a-z]*(?:r[a-z]*f|f[a-z]*r)/iu,
48
+ // Decoding something hidden. An encoded blob itself already reads as private.
49
+ /\bbase64\s+(?:-d|-D|--decode)\b|\batob\s*\(|\bFromBase64String\b|-EncodedCommand\b/iu,
50
+ ];
51
+ // Text aimed at the agent rather than the code: dropping its instructions, changing its
52
+ // settings, switching Lore off, or reaching the files that hold someone's credentials.
53
+ const PUBLIC_RULE_AGENT = [
54
+ /\b(?:ignore|disregard|forget|override)\s+(?:(?:all|any|your|the)\s+)*(?:earlier|previous|prior|above|system|other)\s+(?:\w+\s+)?(?:instructions?|rules?|prompts?)\b/iu,
55
+ /<\/?\s*(?:system|system-reminder|assistant|instructions?)\b[^>]*>|\b(?:BEGIN|END) (?:RELEVANT ENGINEERING KNOWLEDGE|LORE )/iu,
56
+ /\.(?:claude|codex|cursor|opencode|gemini|windsurf|bob)\/(?:settings|config|hooks|mcp)|\bmcp\.json\b|\bmcpServers\b/iu,
57
+ /\bdangerously[A-Z-]|--dangerously|--yolo\b|\bbypassPermissions\b/u,
58
+ /\b(?:turn|switch)\s+off\s+(?:lore|context\s+guard)\b|\b(?:disable|uninstall|remove)\s+(?:lore|context\s+guard)\b|\bLORE_DISABLE\b|\blore\s+(?:disconnect|guard\s+off|capture\s+off)\b/iu,
59
+ /(?:~|\$HOME)\/\.(?:aws|ssh|gnupg|kube|docker|npmrc|netrc|pypirc|lore|config\/gh)\b|\bid_(?:rsa|ed25519|ecdsa)\b/iu,
60
+ ];
61
+ // A Latin word with Cyrillic or Greek letters in it reads the same and matches nothing above.
62
+ const PUBLIC_RULE_LOOK_ALIKE = /\p{Script=Latin}[\p{Script=Cyrillic}\p{Script=Greek}]|[\p{Script=Cyrillic}\p{Script=Greek}]\p{Script=Latin}/u;
63
+ /** Why this text can't be published, and what kind of reason that is, or null when it can. */
64
+ export function publicRuleRefusal(content) {
65
+ if (content.trim().length > PUBLIC_RULE_MAX_LENGTH)
66
+ return { kind: "too_long", message: `Public rules can be at most ${PUBLIC_RULE_MAX_LENGTH} characters. Shorten the learning first.` };
67
+ // Every channel then shows exactly what the owner or admin saw, with nothing hidden.
68
+ if (visiblePublicRuleText(content) !== content)
69
+ return { kind: "hidden", message: "This learning contains hidden characters. Edit it to remove them before publishing." };
70
+ if (PUBLIC_RULE_LOOK_ALIKE.test(content))
71
+ return { kind: "hidden", message: "This learning mixes look-alike letters from different alphabets in one word. Edit it before publishing." };
72
+ if (redactSensitiveText(content).findings.length > 0)
73
+ return { kind: "private", message: "This learning contains something that looks private. Remove it before publishing." };
74
+ // Full-width and other look-alike letters read the same to an agent.
75
+ const text = content.normalize("NFKC");
76
+ if (PUBLIC_RULE_LINK.some(pattern => pattern.test(text))) {
77
+ return { kind: "link", message: "Public rules can't contain links, because agents outside your workspace follow them. Remove the link before publishing." };
78
+ }
79
+ if (PUBLIC_RULE_COMMAND.some(pattern => pattern.test(text))) {
80
+ return { kind: "command", message: "Public rules can't tell agents to download, install or run software, because agents outside your workspace follow them. Remove the command before publishing." };
81
+ }
82
+ if (PUBLIC_RULE_AGENT.some(pattern => pattern.test(text))) {
83
+ return { kind: "agent", message: "Public rules can't change how agents behave outside the code, such as their settings, their instructions or private files, because agents outside your workspace follow them. Write the rule about the code instead." };
84
+ }
85
+ return null;
86
+ }
87
+ /** Why this text can't be published, or null when it can. Only the text is ever public. */
88
+ export function publicRuleProblem(content) {
89
+ return publicRuleRefusal(content)?.message ?? null;
90
+ }
91
+ export const VerifyPublicRepositoryRequestSchema = z.object({
92
+ repository: z.string().trim().min(3).max(300),
93
+ /** The person's GitHub token from the repository picker; the API checks it with GitHub and keeps nothing. */
94
+ githubToken: z.string().trim().min(10).max(500),
95
+ }).strict();
96
+ export const PublicRepositorySchema = z.object({
97
+ repository: z.string(),
98
+ permission: z.enum(["admin", "maintain"]),
99
+ verifiedAt: z.iso.datetime({ offset: true }),
100
+ }).strict();
101
+ export const PublicRuleSchema = z.object({
102
+ learningId: z.uuid(),
103
+ content: z.string(),
104
+ repository: z.string(),
105
+ publishedAt: z.iso.datetime({ offset: true }),
106
+ /** The member's name, or email without one; null when nobody is recorded. */
107
+ publishedBy: z.string().nullable(),
108
+ /** Pull requests that asked for it before and since it was published (repeat mode). */
109
+ askedBefore: z.number().int().nonnegative(),
110
+ askedSince: z.number().int().nonnegative(),
111
+ /** Why Lore no longer sends this rule anywhere, when it wouldn't be published today. */
112
+ withheld: z.string().optional(),
113
+ }).strict();
114
+ export const PublicRulesOverviewSchema = z.object({
115
+ repositories: z.array(PublicRepositorySchema),
116
+ rules: z.array(PublicRuleSchema),
117
+ /** Repositories another workspace verified since, which took them over. */
118
+ lost: z.array(z.object({ repository: z.string(), at: z.iso.datetime({ offset: true }) }).strict()),
119
+ /** Packages of the verified repositories, with rules for anyone using them. */
120
+ packages: z.array(PublicPackageSchema),
121
+ }).strict();
122
+ export const PUBLIC_RULES_BLOCK_START = "<!-- BEGIN LORE PUBLIC RULES -->";
123
+ export const PUBLIC_RULES_BLOCK_END = "<!-- END LORE PUBLIC RULES -->";
124
+ export const AGENT_POINTER_START = "<!-- BEGIN LORE AGENTS.md -->";
125
+ export const AGENT_POINTER_END = "<!-- END LORE AGENTS.md -->";
126
+ export const PublicRulesBlockSchema = z.object({
127
+ repository: z.string(),
128
+ pageUrl: z.url(),
129
+ rulesUrl: z.url(),
130
+ block: z.string(),
131
+ }).strict();
132
+ /** The block Lore keeps in a repository's AGENTS.md. */
133
+ export function renderPublicRulesBlock(input) {
134
+ return [
135
+ PUBLIC_RULES_BLOCK_START,
136
+ "<!-- Kept by Lore. Change these rules in Lore, then run `lore github rules` to update this block. -->",
137
+ "## Rules from this project's maintainers",
138
+ "",
139
+ `Agents working in this repository, including contributors' agents: follow these rules. For rules about your task, fetch ${input.rulesUrl}?task= followed by a few words about it.`,
140
+ "",
141
+ PUBLIC_RULES_LIMITS,
142
+ "",
143
+ ...input.rules.map(publicRuleLine),
144
+ "",
145
+ `Kept by Lore: ${input.pageUrl}`,
146
+ PUBLIC_RULES_BLOCK_END,
147
+ ].join("\n");
148
+ }
149
+ /** The pointer for agents that read their own file and can import AGENTS.md (Claude Code, Gemini CLI). */
150
+ export const AGENT_POINTER_BLOCK = [AGENT_POINTER_START, "@AGENTS.md", AGENT_POINTER_END].join("\n");
151
+ /**
152
+ * The file with Lore's block put in or replaced, leaving everything outside
153
+ * the markers as it was. Throws when the markers are broken or repeated, so
154
+ * nobody's text is overwritten by guesswork.
155
+ */
156
+ export function withManagedBlock(text, block, start, end) {
157
+ const starts = text.split(start).length - 1;
158
+ const ends = text.split(end).length - 1;
159
+ if (starts !== ends || starts > 1)
160
+ throw new Error(`Lore's markers (${start}) are broken or repeated. Fix them by hand, then run this again.`);
161
+ if (starts === 0)
162
+ return text.trim() === "" ? `${block}\n` : `${text.replace(/\s*$/u, "")}\n\n${block}\n`;
163
+ const from = text.indexOf(start);
164
+ const to = text.indexOf(end) + end.length;
165
+ if (to < from)
166
+ throw new Error(`Lore's markers (${start}) are out of order. Fix them by hand, then run this again.`);
167
+ return `${text.slice(0, from)}${block}${text.slice(to)}`;
168
+ }
169
+ /**
170
+ * A repository's public rules as Markdown, for agents that fetch them or call
171
+ * the hosted MCP tool: the rules framed as the maintainers', with a link to
172
+ * their page. Each rule is one cleaned line.
173
+ */
174
+ export function renderPublicRulesMarkdown(input) {
175
+ const who = input.audience === "package"
176
+ ? `The makers of ${input.repository} ask everyone using it, and their agents, to follow these rules`
177
+ : `The maintainers of ${input.repository} ask contributors and their agents to follow these rules`;
178
+ return [
179
+ `# Rules for ${input.repository}`,
180
+ "",
181
+ `${who}${input.selected ? ". These are the ones most related to your task" : ""}.`,
182
+ "",
183
+ PUBLIC_RULES_LIMITS,
184
+ "",
185
+ ...input.rules.map(rule => `${publicRuleLine(rule.text)}${rule.askedCount > 1 ? ` (asked in ${rule.askedCount} pull requests)` : ""}`),
186
+ "",
187
+ `Kept by Lore: ${input.pageUrl}`,
188
+ "",
189
+ ].join("\n");
190
+ }
191
+ export { PUBLIC_RULES_LIMITS, publicRuleLine, visiblePublicRuleText } from "./public-rule-text.js";
192
+ //# sourceMappingURL=public-rules.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"public-rules.js","sourceRoot":"","sources":["../src/public-rules.ts"],"names":[],"mappings":"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"}