@indigoai-us/hq-cloud 6.18.6 → 6.18.8
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/bin/sync-runner-company.d.ts +2 -0
- package/dist/bin/sync-runner-company.d.ts.map +1 -1
- package/dist/bin/sync-runner-company.js +14 -0
- package/dist/bin/sync-runner-company.js.map +1 -1
- package/dist/bin/sync-runner-company.test.js +45 -1
- package/dist/bin/sync-runner-company.test.js.map +1 -1
- package/dist/bin/sync-runner-publish-expansion.test.d.ts +2 -0
- package/dist/bin/sync-runner-publish-expansion.test.d.ts.map +1 -0
- package/dist/bin/sync-runner-publish-expansion.test.js +54 -0
- package/dist/bin/sync-runner-publish-expansion.test.js.map +1 -0
- package/dist/bin/sync-runner-watch-loop.d.ts +11 -0
- package/dist/bin/sync-runner-watch-loop.d.ts.map +1 -1
- package/dist/bin/sync-runner-watch-loop.js +58 -1
- package/dist/bin/sync-runner-watch-loop.js.map +1 -1
- package/dist/bin/sync-runner.d.ts +4 -0
- package/dist/bin/sync-runner.d.ts.map +1 -1
- package/dist/bin/sync-runner.js +1 -0
- package/dist/bin/sync-runner.js.map +1 -1
- package/dist/cli/share.d.ts +26 -2
- package/dist/cli/share.d.ts.map +1 -1
- package/dist/cli/share.js +113 -23
- package/dist/cli/share.js.map +1 -1
- package/dist/cli/share.test.js +320 -9
- package/dist/cli/share.test.js.map +1 -1
- package/dist/lib/ontology-entity-meta.d.ts +21 -0
- package/dist/lib/ontology-entity-meta.d.ts.map +1 -0
- package/dist/lib/ontology-entity-meta.js +51 -0
- package/dist/lib/ontology-entity-meta.js.map +1 -0
- package/dist/lib/ontology-entity-meta.test.d.ts +2 -0
- package/dist/lib/ontology-entity-meta.test.d.ts.map +1 -0
- package/dist/lib/ontology-entity-meta.test.js +79 -0
- package/dist/lib/ontology-entity-meta.test.js.map +1 -0
- package/dist/lib/ontology-entity-push.d.ts +9 -4
- package/dist/lib/ontology-entity-push.d.ts.map +1 -1
- package/dist/lib/ontology-entity-push.js +19 -20
- package/dist/lib/ontology-entity-push.js.map +1 -1
- package/dist/lib/ontology-entity-push.test.js +7 -0
- package/dist/lib/ontology-entity-push.test.js.map +1 -1
- package/dist/lib/ontology-outbox.d.ts +52 -0
- package/dist/lib/ontology-outbox.d.ts.map +1 -0
- package/dist/lib/ontology-outbox.js +118 -0
- package/dist/lib/ontology-outbox.js.map +1 -0
- package/dist/lib/skill-register-landed-bytes.d.ts +16 -0
- package/dist/lib/skill-register-landed-bytes.d.ts.map +1 -0
- package/dist/lib/skill-register-landed-bytes.js +78 -0
- package/dist/lib/skill-register-landed-bytes.js.map +1 -0
- package/dist/lib/skill-register-landed-bytes.test.d.ts +2 -0
- package/dist/lib/skill-register-landed-bytes.test.d.ts.map +1 -0
- package/dist/lib/skill-register-landed-bytes.test.js +83 -0
- package/dist/lib/skill-register-landed-bytes.test.js.map +1 -0
- package/dist/private-folder-transport.d.ts.map +1 -1
- package/dist/private-folder-transport.js +16 -1
- package/dist/private-folder-transport.js.map +1 -1
- package/dist/private-folder-transport.test.d.ts +2 -0
- package/dist/private-folder-transport.test.d.ts.map +1 -0
- package/dist/private-folder-transport.test.js +33 -0
- package/dist/private-folder-transport.test.js.map +1 -0
- package/dist/s3.d.ts +1 -1
- package/dist/s3.d.ts.map +1 -1
- package/dist/s3.js +34 -4
- package/dist/s3.js.map +1 -1
- package/dist/s3.test.js +51 -0
- package/dist/s3.test.js.map +1 -1
- package/package.json +2 -1
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Dependency-free helpers for checkpoint-written ontology entity files, shared
|
|
3
|
+
* by the push leg (../cli/share.ts) and the upload primitives (../s3.ts).
|
|
4
|
+
*/
|
|
5
|
+
/** S3 user-metadata key carrying an entity's frontmatter `last_updated`. */
|
|
6
|
+
export declare const ENTITY_LAST_UPDATED_META_KEY = "hq-entity-last-updated";
|
|
7
|
+
/** Vault-relative form of an hqRoot-relative (`companies/<slug>/…`) or vault-relative path. */
|
|
8
|
+
export declare function ontologyVaultKey(relPath: string): string;
|
|
9
|
+
/**
|
|
10
|
+
* True iff `relPath` is an ontology entity file. Accepts an hqRoot-relative
|
|
11
|
+
* (`companies/<slug>/…`) or vault-relative path, like `isCloudAuthoritative`.
|
|
12
|
+
*/
|
|
13
|
+
export declare function isOntologyEntityKey(relPath: string): boolean;
|
|
14
|
+
/**
|
|
15
|
+
* The frontmatter `last_updated` of an entity body, as written, or null when
|
|
16
|
+
* the body has no frontmatter, no such key, or a value that is not a date.
|
|
17
|
+
*/
|
|
18
|
+
export declare function entityLastUpdated(body: string): string | null;
|
|
19
|
+
/** `{hq-entity-last-updated}` for an entity key whose body carries a valid date; `{}` otherwise. */
|
|
20
|
+
export declare function buildEntityMetadata(key: string, body: Buffer | string): Record<string, string>;
|
|
21
|
+
//# sourceMappingURL=ontology-entity-meta.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"ontology-entity-meta.d.ts","sourceRoot":"","sources":["../../src/lib/ontology-entity-meta.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,4EAA4E;AAC5E,eAAO,MAAM,4BAA4B,2BAA2B,CAAC;AAErE,+FAA+F;AAC/F,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAMxD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE5D;AAID;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAU7D;AAED,oGAAoG;AACpG,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAI9F"}
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Dependency-free helpers for checkpoint-written ontology entity files, shared
|
|
3
|
+
* by the push leg (../cli/share.ts) and the upload primitives (../s3.ts).
|
|
4
|
+
*/
|
|
5
|
+
/** Vault-relative entity files the checkpoint writes. */
|
|
6
|
+
const ONTOLOGY_ENTITY_KEY = /^ontology\/entities\/[a-z][a-z0-9-]*\/[^/]+\.md$/;
|
|
7
|
+
/** S3 user-metadata key carrying an entity's frontmatter `last_updated`. */
|
|
8
|
+
export const ENTITY_LAST_UPDATED_META_KEY = "hq-entity-last-updated";
|
|
9
|
+
/** Vault-relative form of an hqRoot-relative (`companies/<slug>/…`) or vault-relative path. */
|
|
10
|
+
export function ontologyVaultKey(relPath) {
|
|
11
|
+
return relPath
|
|
12
|
+
.split("\\")
|
|
13
|
+
.join("/")
|
|
14
|
+
.replace(/^\.?\//, "")
|
|
15
|
+
.replace(/^companies\/[^/]+\//, "");
|
|
16
|
+
}
|
|
17
|
+
/**
|
|
18
|
+
* True iff `relPath` is an ontology entity file. Accepts an hqRoot-relative
|
|
19
|
+
* (`companies/<slug>/…`) or vault-relative path, like `isCloudAuthoritative`.
|
|
20
|
+
*/
|
|
21
|
+
export function isOntologyEntityKey(relPath) {
|
|
22
|
+
return ONTOLOGY_ENTITY_KEY.test(ontologyVaultKey(relPath));
|
|
23
|
+
}
|
|
24
|
+
const STAMP_RE = /^\d{4}-\d{2}-\d{2}(?:[T ][0-9:.]+(?:Z|[+-]\d{2}:?\d{2})?)?$/;
|
|
25
|
+
/**
|
|
26
|
+
* The frontmatter `last_updated` of an entity body, as written, or null when
|
|
27
|
+
* the body has no frontmatter, no such key, or a value that is not a date.
|
|
28
|
+
*/
|
|
29
|
+
export function entityLastUpdated(body) {
|
|
30
|
+
const text = body.startsWith("") ? body.slice(1) : body;
|
|
31
|
+
if (!/^---\r?\n/.test(text))
|
|
32
|
+
return null;
|
|
33
|
+
const end = text.search(/\r?\n---\s*(?:\r?\n|$)/);
|
|
34
|
+
if (end < 0)
|
|
35
|
+
return null;
|
|
36
|
+
const match = /^last_updated:[ \t]*(.*?)[ \t]*$/m.exec(text.slice(0, end));
|
|
37
|
+
if (!match)
|
|
38
|
+
return null;
|
|
39
|
+
const value = match[1].replace(/^(["'])(.*)\1$/, "$2");
|
|
40
|
+
if (!STAMP_RE.test(value) || !Number.isFinite(Date.parse(value)))
|
|
41
|
+
return null;
|
|
42
|
+
return value;
|
|
43
|
+
}
|
|
44
|
+
/** `{hq-entity-last-updated}` for an entity key whose body carries a valid date; `{}` otherwise. */
|
|
45
|
+
export function buildEntityMetadata(key, body) {
|
|
46
|
+
if (!isOntologyEntityKey(key))
|
|
47
|
+
return {};
|
|
48
|
+
const stamp = entityLastUpdated(typeof body === "string" ? body : body.toString("utf8"));
|
|
49
|
+
return stamp === null ? {} : { [ENTITY_LAST_UPDATED_META_KEY]: stamp };
|
|
50
|
+
}
|
|
51
|
+
//# sourceMappingURL=ontology-entity-meta.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"ontology-entity-meta.js","sourceRoot":"","sources":["../../src/lib/ontology-entity-meta.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,yDAAyD;AACzD,MAAM,mBAAmB,GAAG,kDAAkD,CAAC;AAE/E,4EAA4E;AAC5E,MAAM,CAAC,MAAM,4BAA4B,GAAG,wBAAwB,CAAC;AAErE,+FAA+F;AAC/F,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,OAAO,OAAO;SACX,KAAK,CAAC,IAAI,CAAC;SACX,IAAI,CAAC,GAAG,CAAC;SACT,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;SACrB,OAAO,CAAC,qBAAqB,EAAE,EAAE,CAAC,CAAC;AACxC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAe;IACjD,OAAO,mBAAmB,CAAC,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,QAAQ,GAAG,6DAA6D,CAAC;AAE/E;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACzD,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACzC,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,wBAAwB,CAAC,CAAC;IAClD,IAAI,GAAG,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACzB,MAAM,KAAK,GAAG,mCAAmC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IAC3E,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,OAAO,CAAC,gBAAgB,EAAE,IAAI,CAAC,CAAC;IACxD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9E,OAAO,KAAK,CAAC;AACf,CAAC;AAED,oGAAoG;AACpG,MAAM,UAAU,mBAAmB,CAAC,GAAW,EAAE,IAAqB;IACpE,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IACzC,MAAM,KAAK,GAAG,iBAAiB,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IACzF,OAAO,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,4BAA4B,CAAC,EAAE,KAAK,EAAE,CAAC;AACzE,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"ontology-entity-meta.test.d.ts","sourceRoot":"","sources":["../../src/lib/ontology-entity-meta.test.ts"],"names":[],"mappings":""}
|
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
import { describe, expect, it } from "vitest";
|
|
2
|
+
import { buildEntityMetadata, entityLastUpdated, isOntologyEntityKey } from "./ontology-entity-meta.js";
|
|
3
|
+
import fs from "node:fs";
|
|
4
|
+
import os from "node:os";
|
|
5
|
+
import path from "node:path";
|
|
6
|
+
import { createHash } from "node:crypto";
|
|
7
|
+
import { entityIsFreshForCreate, outboxAllowsEntityPush, readOntologyOutbox } from "./ontology-outbox.js";
|
|
8
|
+
describe("entityLastUpdated", () => {
|
|
9
|
+
it("reads an ISO timestamp, a date, and a quoted value from the frontmatter", () => {
|
|
10
|
+
expect(entityLastUpdated("---\nid: a\nlast_updated: 2026-09-26T10:00:00.000Z\n---\n")).toBe("2026-09-26T10:00:00.000Z");
|
|
11
|
+
expect(entityLastUpdated("---\nlast_updated: 2026-09-26\n---\nbody")).toBe("2026-09-26");
|
|
12
|
+
expect(entityLastUpdated("---\r\nlast_updated: \"2026-09-26T10:00:00Z\"\r\n---\r\n")).toBe("2026-09-26T10:00:00Z");
|
|
13
|
+
});
|
|
14
|
+
it("ignores a last_updated outside the frontmatter, a missing one, and a non-date", () => {
|
|
15
|
+
expect(entityLastUpdated("---\nid: a\n---\nlast_updated: 2026-09-26\n")).toBeNull();
|
|
16
|
+
expect(entityLastUpdated("last_updated: 2026-09-26\n")).toBeNull();
|
|
17
|
+
expect(entityLastUpdated("---\nlast_updated: soon\n---\n")).toBeNull();
|
|
18
|
+
expect(entityLastUpdated("---\nlast_updated: 2026-13-45\n---\n")).toBeNull();
|
|
19
|
+
expect(entityLastUpdated("---\nlast_updated: 2026-09-26\n")).toBeNull();
|
|
20
|
+
});
|
|
21
|
+
});
|
|
22
|
+
describe("buildEntityMetadata", () => {
|
|
23
|
+
it("stamps entity keys only", () => {
|
|
24
|
+
const body = "---\nlast_updated: 2026-09-26\n---\n";
|
|
25
|
+
expect(buildEntityMetadata("ontology/entities/person/a.md", body)).toEqual({ "hq-entity-last-updated": "2026-09-26" });
|
|
26
|
+
expect(buildEntityMetadata("ontology/facts/a.md", body)).toEqual({});
|
|
27
|
+
expect(isOntologyEntityKey(["companies", "indigo", "ontology", "entities", "person", "a.md"].join("/"))).toBe(true);
|
|
28
|
+
});
|
|
29
|
+
});
|
|
30
|
+
describe("entityIsFreshForCreate", () => {
|
|
31
|
+
const now = Date.parse("2026-09-26T12:00:00.000Z");
|
|
32
|
+
it("allows a body updated within 24 hours and refuses an older or undated one", () => {
|
|
33
|
+
expect(entityIsFreshForCreate("---\nlast_updated: 2026-09-25T12:00:00.000Z\n---\n", now)).toBe(true);
|
|
34
|
+
expect(entityIsFreshForCreate("---\nlast_updated: 2026-09-25T11:59:59.000Z\n---\n", now)).toBe(false);
|
|
35
|
+
expect(entityIsFreshForCreate("---\nid: a\n---\n", now)).toBe(false);
|
|
36
|
+
});
|
|
37
|
+
it("refuses a last_updated more than five minutes in the future", () => {
|
|
38
|
+
expect(entityIsFreshForCreate("---\nlast_updated: 2026-09-26T12:05:00.000Z\n---\n", now)).toBe(true);
|
|
39
|
+
expect(entityIsFreshForCreate("---\nlast_updated: 2026-09-26T12:05:01.000Z\n---\n", now)).toBe(false);
|
|
40
|
+
expect(entityIsFreshForCreate("---\nlast_updated: 2027-01-01\n---\n", now)).toBe(false);
|
|
41
|
+
});
|
|
42
|
+
});
|
|
43
|
+
describe("ontology outbox", () => {
|
|
44
|
+
const sha = (body) => createHash("sha256").update(body).digest("hex");
|
|
45
|
+
const rel = "ontology/entities/person/a.md";
|
|
46
|
+
function root(entries) {
|
|
47
|
+
const dir = fs.mkdtempSync(path.join(os.tmpdir(), "outbox-"));
|
|
48
|
+
fs.mkdirSync(path.join(dir, ".hq", "ontology-outbox"), { recursive: true });
|
|
49
|
+
fs.writeFileSync(path.join(dir, ".hq", "ontology-outbox", "indigo.json"), JSON.stringify({ schema: "hq-ontology-outbox.v1", company: "indigo", entries }));
|
|
50
|
+
return dir;
|
|
51
|
+
}
|
|
52
|
+
it("treats the whole outbox as malformed when one entry is malformed", () => {
|
|
53
|
+
const good = { sha256: sha("a"), written_at: "2026-09-26T10:00:00.000Z" };
|
|
54
|
+
for (const bad of [
|
|
55
|
+
{ sha256: "nothex", written_at: "2026-09-26T10:00:00.000Z" },
|
|
56
|
+
{ sha256: sha("b") },
|
|
57
|
+
{ sha256: sha("b"), written_at: "later" },
|
|
58
|
+
null,
|
|
59
|
+
]) {
|
|
60
|
+
const errors = [];
|
|
61
|
+
const outbox = readOntologyOutbox(root({ [rel]: good, "ontology/entities/person/b.md": bad }), "indigo", (e) => errors.push(e));
|
|
62
|
+
expect(outbox.entries.size).toBe(0);
|
|
63
|
+
expect(errors.map((e) => e.message)).toEqual(["ontology outbox has a malformed entry"]);
|
|
64
|
+
}
|
|
65
|
+
const errors = [];
|
|
66
|
+
expect(readOntologyOutbox(root({ [rel]: good }), "indigo", (e) => errors.push(e)).entries.get(rel)).toBe(sha("a"));
|
|
67
|
+
expect(errors).toEqual([]);
|
|
68
|
+
});
|
|
69
|
+
it("allows a push only when the planned hash is the recorded one", () => {
|
|
70
|
+
const dir = root({ [rel]: { sha256: sha("body"), written_at: "2026-09-26T10:00:00.000Z" } });
|
|
71
|
+
const file = path.join(dir, "a.md");
|
|
72
|
+
fs.writeFileSync(file, "body");
|
|
73
|
+
const outbox = readOntologyOutbox(dir, "indigo", () => undefined);
|
|
74
|
+
expect(outboxAllowsEntityPush(outbox, rel, file)).toBe(true);
|
|
75
|
+
expect(outboxAllowsEntityPush(outbox, rel, file, sha("body"))).toBe(true);
|
|
76
|
+
expect(outboxAllowsEntityPush(outbox, rel, file, sha("older body"))).toBe(false);
|
|
77
|
+
});
|
|
78
|
+
});
|
|
79
|
+
//# sourceMappingURL=ontology-entity-meta.test.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"ontology-entity-meta.test.js","sourceRoot":"","sources":["../../src/lib/ontology-entity-meta.test.ts"],"names":[],"mappings":"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"}
|
|
@@ -28,10 +28,13 @@ import { type FlagClient, type FlagClientOptions } from "@indigoai-us/hq-flags-c
|
|
|
28
28
|
/** Flag that gates both the checkpoint ontology step and this push path. */
|
|
29
29
|
export declare const ONTOLOGY_ENTITY_PUSH_FLAG = "checkpoint.ontology";
|
|
30
30
|
/**
|
|
31
|
-
*
|
|
32
|
-
*
|
|
31
|
+
* Flag that gates the several-writers rules (see ./ontology-outbox.ts): an
|
|
32
|
+
* entity is pushed only when this machine's checkpoint wrote those bytes, and
|
|
33
|
+
* a stale create over an absent remote is set aside. Read only when
|
|
34
|
+
* `checkpoint.ontology` is on.
|
|
33
35
|
*/
|
|
34
|
-
export declare
|
|
36
|
+
export declare const ONTOLOGY_MULTI_WRITER_FLAG = "checkpoint.ontology.multi-writer";
|
|
37
|
+
export { isOntologyEntityKey } from "./ontology-entity-meta.js";
|
|
35
38
|
export interface OntologyEntityPushInput {
|
|
36
39
|
/** Company vault uid (`cmp_*`). Personal vaults never push entities. */
|
|
37
40
|
companyUid: string;
|
|
@@ -44,8 +47,10 @@ export interface OntologyEntityPushInput {
|
|
|
44
47
|
now?: () => number;
|
|
45
48
|
/** Told about each failed read. Defaults to one line on stderr. */
|
|
46
49
|
onError?: (error: unknown) => void;
|
|
50
|
+
/** Flag to read. Defaults to `checkpoint.ontology`. */
|
|
51
|
+
flag?: string;
|
|
47
52
|
}
|
|
48
|
-
/** Resolve `checkpoint.ontology` for one company vault. Never throws. */
|
|
53
|
+
/** Resolve `checkpoint.ontology` (or `input.flag`) for one company vault. Never throws. */
|
|
49
54
|
export declare function resolveOntologyEntityPush(input: OntologyEntityPushInput): Promise<boolean>;
|
|
50
55
|
export declare function _resetOntologyEntityPushCacheForTests(): void;
|
|
51
56
|
//# sourceMappingURL=ontology-entity-push.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"ontology-entity-push.d.ts","sourceRoot":"","sources":["../../src/lib/ontology-entity-push.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAGH,OAAO,EAAuC,KAAK,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAE5H,4EAA4E;AAC5E,eAAO,MAAM,yBAAyB,wBAAwB,CAAC;
|
|
1
|
+
{"version":3,"file":"ontology-entity-push.d.ts","sourceRoot":"","sources":["../../src/lib/ontology-entity-push.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAGH,OAAO,EAAuC,KAAK,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAE5H,4EAA4E;AAC5E,eAAO,MAAM,yBAAyB,wBAAwB,CAAC;AAE/D;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,qCAAqC,CAAC;AAK7E,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAEhE,MAAM,WAAW,uBAAuB;IACtC,wEAAwE;IACxE,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1C,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IACnD,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,IAAI,CAAC,UAAU,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC,CAAC;IAC/F,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,mEAAmE;IACnE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACnC,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAID,2FAA2F;AAC3F,wBAAsB,yBAAyB,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,OAAO,CAAC,CAuEhG;AAED,wBAAgB,qCAAqC,IAAI,IAAI,CAE5D"}
|
|
@@ -28,37 +28,36 @@ import { createHash } from "node:crypto";
|
|
|
28
28
|
import { createFlagClient, readLocalOverride } from "@indigoai-us/hq-flags-client";
|
|
29
29
|
/** Flag that gates both the checkpoint ontology step and this push path. */
|
|
30
30
|
export const ONTOLOGY_ENTITY_PUSH_FLAG = "checkpoint.ontology";
|
|
31
|
-
const FLAG_READ_TIMEOUT_MS = 5_000;
|
|
32
|
-
const FLAG_CACHE_TTL_MS = 5 * 60_000;
|
|
33
|
-
/** Vault-relative entity files the checkpoint writes. */
|
|
34
|
-
const ONTOLOGY_ENTITY_KEY = /^ontology\/entities\/[a-z][a-z0-9-]*\/[^/]+\.md$/;
|
|
35
31
|
/**
|
|
36
|
-
*
|
|
37
|
-
*
|
|
32
|
+
* Flag that gates the several-writers rules (see ./ontology-outbox.ts): an
|
|
33
|
+
* entity is pushed only when this machine's checkpoint wrote those bytes, and
|
|
34
|
+
* a stale create over an absent remote is set aside. Read only when
|
|
35
|
+
* `checkpoint.ontology` is on.
|
|
38
36
|
*/
|
|
39
|
-
export
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
.replace(/^\.?\//, "")
|
|
44
|
-
.replace(/^companies\/[^/]+\//, "");
|
|
45
|
-
return ONTOLOGY_ENTITY_KEY.test(vaultRel);
|
|
46
|
-
}
|
|
37
|
+
export const ONTOLOGY_MULTI_WRITER_FLAG = "checkpoint.ontology.multi-writer";
|
|
38
|
+
const FLAG_READ_TIMEOUT_MS = 5_000;
|
|
39
|
+
const FLAG_CACHE_TTL_MS = 5 * 60_000;
|
|
40
|
+
export { isOntologyEntityKey } from "./ontology-entity-meta.js";
|
|
47
41
|
const cache = new Map();
|
|
48
|
-
/** Resolve `checkpoint.ontology` for one company vault. Never throws. */
|
|
42
|
+
/** Resolve `checkpoint.ontology` (or `input.flag`) for one company vault. Never throws. */
|
|
49
43
|
export async function resolveOntologyEntityPush(input) {
|
|
50
44
|
if (!input.companyUid.startsWith("cmp_"))
|
|
51
45
|
return false;
|
|
46
|
+
const flag = input.flag ?? ONTOLOGY_ENTITY_PUSH_FLAG;
|
|
52
47
|
const env = input.env ?? process.env;
|
|
53
|
-
const local = readLocalOverride(
|
|
48
|
+
const local = readLocalOverride(flag, env);
|
|
54
49
|
if (local !== null)
|
|
55
50
|
return local;
|
|
56
51
|
const endpoint = (env.HQ_FLAGS_API_URL ?? "").trim() || (input.endpoint ?? "").trim();
|
|
57
|
-
if (!endpoint || !input.getToken)
|
|
52
|
+
if (!endpoint || !input.getToken) {
|
|
53
|
+
// A caller that passes onError fails closed on an unreadable flag; a flag
|
|
54
|
+
// with no endpoint or token to read it with is unreadable too.
|
|
55
|
+
input.onError?.(new Error(`no flags endpoint or token to read ${flag}`));
|
|
58
56
|
return false;
|
|
57
|
+
}
|
|
59
58
|
const reportError = input.onError ?? ((error) => {
|
|
60
59
|
const detail = error instanceof Error ? error.message : String(error);
|
|
61
|
-
process.stderr.write(`hq-cloud: could not read ${
|
|
60
|
+
process.stderr.write(`hq-cloud: could not read ${flag}; ontology entities stay pull-only this pass (${detail.slice(0, 200)})\n`);
|
|
62
61
|
});
|
|
63
62
|
let failed = false;
|
|
64
63
|
let reported = false;
|
|
@@ -82,7 +81,7 @@ export async function resolveOntologyEntityPush(input) {
|
|
|
82
81
|
}
|
|
83
82
|
const now = input.now ?? Date.now;
|
|
84
83
|
const caller = createHash("sha256").update(token).digest("hex").slice(0, 32);
|
|
85
|
-
const cacheKey = `${endpoint}\n${input.companyUid}\n${caller}`;
|
|
84
|
+
const cacheKey = `${flag}\n${endpoint}\n${input.companyUid}\n${caller}`;
|
|
86
85
|
const hit = cache.get(cacheKey);
|
|
87
86
|
if (hit && hit.expiresAt > now())
|
|
88
87
|
return hit.value;
|
|
@@ -100,7 +99,7 @@ export async function resolveOntologyEntityPush(input) {
|
|
|
100
99
|
onError: fail,
|
|
101
100
|
});
|
|
102
101
|
await client.ready();
|
|
103
|
-
const resolution = client.explain(
|
|
102
|
+
const resolution = client.explain(flag, { fallback: false });
|
|
104
103
|
value = !failed && resolution.source === "snapshot" && resolution.value === true;
|
|
105
104
|
}
|
|
106
105
|
catch (error) {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"ontology-entity-push.js","sourceRoot":"","sources":["../../src/lib/ontology-entity-push.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAA2C,MAAM,8BAA8B,CAAC;AAE5H,4EAA4E;AAC5E,MAAM,CAAC,MAAM,yBAAyB,GAAG,qBAAqB,CAAC;AAE/D,MAAM,
|
|
1
|
+
{"version":3,"file":"ontology-entity-push.js","sourceRoot":"","sources":["../../src/lib/ontology-entity-push.ts"],"names":[],"mappings":"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"}
|
|
@@ -92,6 +92,13 @@ describe("resolveOntologyEntityPush", () => {
|
|
|
92
92
|
expect(await resolveOntologyEntityPush(input({ getToken: undefined, createClient: fake.createClient }))).toBe(false);
|
|
93
93
|
expect(fake.createClient).not.toHaveBeenCalled();
|
|
94
94
|
});
|
|
95
|
+
it("reports a missing endpoint or token to an explicit onError, so that caller can fail closed", async () => {
|
|
96
|
+
const onError = vi.fn();
|
|
97
|
+
expect(await resolveOntologyEntityPush(input({ endpoint: undefined, onError }))).toBe(false);
|
|
98
|
+
expect(await resolveOntologyEntityPush(input({ getToken: undefined, onError }))).toBe(false);
|
|
99
|
+
expect(onError).toHaveBeenCalledTimes(2);
|
|
100
|
+
expect(String(onError.mock.calls[0][0])).toContain("no flags endpoint or token to read checkpoint.ontology");
|
|
101
|
+
});
|
|
95
102
|
it("prefers HQ_FLAGS_API_URL over the vault endpoint", async () => {
|
|
96
103
|
const fake = fakeClient({ source: "snapshot", value: true });
|
|
97
104
|
await resolveOntologyEntityPush(input({ env: { HQ_FLAGS_API_URL: "https://override.test" }, createClient: fake.createClient }));
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"ontology-entity-push.test.js","sourceRoot":"","sources":["../../src/lib/ontology-entity-push.test.ts"],"names":[],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"ontology-entity-push.test.js","sourceRoot":"","sources":["../../src/lib/ontology-entity-push.test.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The checkpoint ontology outbox: which entity bytes this machine's
|
|
3
|
+
* `hq core checkpoint` wrote.
|
|
4
|
+
*
|
|
5
|
+
* Several people's checkpoints now write one company's ontology. Sync must
|
|
6
|
+
* upload an entity file only when this machine's checkpoint produced those
|
|
7
|
+
* exact bytes. Otherwise an old pulled copy (a file another writer has since
|
|
8
|
+
* merged away, or rewritten) goes back up and undoes their work: the
|
|
9
|
+
* 2026-09-26 Indigo re-creates and overwrites.
|
|
10
|
+
*
|
|
11
|
+
* hq-cli records every entity file it writes in
|
|
12
|
+
* `<hqRoot>/.hq/ontology-outbox/<company-slug>.json`
|
|
13
|
+
* (`{schema: "hq-ontology-outbox.v1", company, entries: {<vault key>:
|
|
14
|
+
* {sha256, written_at}}}`), always before it writes the file. The file lives
|
|
15
|
+
* under `.hq/`, so it never syncs. This module reads it; the rules are
|
|
16
|
+
* enforced in ../cli/share.ts while `checkpoint.ontology.multi-writer` is on.
|
|
17
|
+
*/
|
|
18
|
+
export declare const ONTOLOGY_OUTBOX_SCHEMA = "hq-ontology-outbox.v1";
|
|
19
|
+
export declare const ONTOLOGY_OUTBOX_DIR: readonly [".hq", "ontology-outbox"];
|
|
20
|
+
/** A create over an absent remote with no journal row is allowed only this soon after `last_updated`. */
|
|
21
|
+
export declare const ENTITY_CREATE_WINDOW_MS: number;
|
|
22
|
+
export interface OntologyOutbox {
|
|
23
|
+
/** Vault key → SHA-256 (hex) of the bytes the checkpoint wrote. */
|
|
24
|
+
readonly entries: ReadonlyMap<string, string>;
|
|
25
|
+
}
|
|
26
|
+
export declare function ontologyOutboxPath(hqRoot: string, companySlug: string): string;
|
|
27
|
+
/** How far in the future a `last_updated` may be (clock skew) and still count as fresh. */
|
|
28
|
+
export declare const ENTITY_CREATE_FUTURE_SKEW_MS: number;
|
|
29
|
+
/**
|
|
30
|
+
* Read a company's outbox. A missing file is an empty outbox. An unreadable or
|
|
31
|
+
* malformed one is also empty, reported through `onError`: an empty outbox
|
|
32
|
+
* only holds entity files back, which is the safe direction. One malformed
|
|
33
|
+
* entry makes the whole outbox malformed, so a partly corrupt file or a
|
|
34
|
+
* producer on another schema never authorizes a push.
|
|
35
|
+
*/
|
|
36
|
+
export declare function readOntologyOutbox(hqRoot: string, companySlug: string, onError: (error: Error) => void): OntologyOutbox;
|
|
37
|
+
/**
|
|
38
|
+
* True iff the local file at `absolutePath` is a regular file whose bytes are
|
|
39
|
+
* the ones the checkpoint recorded for `relativePath`. With `plannedHash`, the
|
|
40
|
+
* recorded bytes must also be the ones the push planned to upload; uploadFile
|
|
41
|
+
* then refuses a body that no longer hashes to the planned value, so the bytes
|
|
42
|
+
* sent are the bytes checked here.
|
|
43
|
+
*/
|
|
44
|
+
export declare function outboxAllowsEntityPush(outbox: OntologyOutbox, relativePath: string, absolutePath: string, plannedHash?: string): boolean;
|
|
45
|
+
/**
|
|
46
|
+
* True iff the entity body's `last_updated` is within the create window of
|
|
47
|
+
* `nowMs`. A body without a readable `last_updated` is not fresh, and neither
|
|
48
|
+
* is one dated more than {@link ENTITY_CREATE_FUTURE_SKEW_MS} ahead: a future
|
|
49
|
+
* date would otherwise stay "fresh" for good.
|
|
50
|
+
*/
|
|
51
|
+
export declare function entityIsFreshForCreate(body: string, nowMs: number): boolean;
|
|
52
|
+
//# sourceMappingURL=ontology-outbox.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"ontology-outbox.d.ts","sourceRoot":"","sources":["../../src/lib/ontology-outbox.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAOH,eAAO,MAAM,sBAAsB,0BAA0B,CAAC;AAC9D,eAAO,MAAM,mBAAmB,qCAAsC,CAAC;AAEvE,yGAAyG;AACzG,eAAO,MAAM,uBAAuB,QAAsB,CAAC;AAE3D,MAAM,WAAW,cAAc;IAC7B,mEAAmE;IACnE,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/C;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAE9E;AAED,2FAA2F;AAC3F,eAAO,MAAM,4BAA4B,QAAgB,CAAC;AAE1D;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAC9B,cAAc,CA2ChB;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,cAAc,EACtB,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAWT;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAK3E"}
|
|
@@ -0,0 +1,118 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The checkpoint ontology outbox: which entity bytes this machine's
|
|
3
|
+
* `hq core checkpoint` wrote.
|
|
4
|
+
*
|
|
5
|
+
* Several people's checkpoints now write one company's ontology. Sync must
|
|
6
|
+
* upload an entity file only when this machine's checkpoint produced those
|
|
7
|
+
* exact bytes. Otherwise an old pulled copy (a file another writer has since
|
|
8
|
+
* merged away, or rewritten) goes back up and undoes their work: the
|
|
9
|
+
* 2026-09-26 Indigo re-creates and overwrites.
|
|
10
|
+
*
|
|
11
|
+
* hq-cli records every entity file it writes in
|
|
12
|
+
* `<hqRoot>/.hq/ontology-outbox/<company-slug>.json`
|
|
13
|
+
* (`{schema: "hq-ontology-outbox.v1", company, entries: {<vault key>:
|
|
14
|
+
* {sha256, written_at}}}`), always before it writes the file. The file lives
|
|
15
|
+
* under `.hq/`, so it never syncs. This module reads it; the rules are
|
|
16
|
+
* enforced in ../cli/share.ts while `checkpoint.ontology.multi-writer` is on.
|
|
17
|
+
*/
|
|
18
|
+
import fs from "node:fs";
|
|
19
|
+
import path from "node:path";
|
|
20
|
+
import { hashFile } from "../journal.js";
|
|
21
|
+
import { entityLastUpdated, ontologyVaultKey } from "./ontology-entity-meta.js";
|
|
22
|
+
export const ONTOLOGY_OUTBOX_SCHEMA = "hq-ontology-outbox.v1";
|
|
23
|
+
export const ONTOLOGY_OUTBOX_DIR = [".hq", "ontology-outbox"];
|
|
24
|
+
/** A create over an absent remote with no journal row is allowed only this soon after `last_updated`. */
|
|
25
|
+
export const ENTITY_CREATE_WINDOW_MS = 24 * 60 * 60 * 1000;
|
|
26
|
+
export function ontologyOutboxPath(hqRoot, companySlug) {
|
|
27
|
+
return path.join(hqRoot, ...ONTOLOGY_OUTBOX_DIR, `${companySlug}.json`);
|
|
28
|
+
}
|
|
29
|
+
/** How far in the future a `last_updated` may be (clock skew) and still count as fresh. */
|
|
30
|
+
export const ENTITY_CREATE_FUTURE_SKEW_MS = 5 * 60 * 1000;
|
|
31
|
+
/**
|
|
32
|
+
* Read a company's outbox. A missing file is an empty outbox. An unreadable or
|
|
33
|
+
* malformed one is also empty, reported through `onError`: an empty outbox
|
|
34
|
+
* only holds entity files back, which is the safe direction. One malformed
|
|
35
|
+
* entry makes the whole outbox malformed, so a partly corrupt file or a
|
|
36
|
+
* producer on another schema never authorizes a push.
|
|
37
|
+
*/
|
|
38
|
+
export function readOntologyOutbox(hqRoot, companySlug, onError) {
|
|
39
|
+
const entries = new Map();
|
|
40
|
+
let raw;
|
|
41
|
+
try {
|
|
42
|
+
raw = fs.readFileSync(ontologyOutboxPath(hqRoot, companySlug), "utf8");
|
|
43
|
+
}
|
|
44
|
+
catch (error) {
|
|
45
|
+
if (error.code !== "ENOENT")
|
|
46
|
+
onError(error);
|
|
47
|
+
return { entries };
|
|
48
|
+
}
|
|
49
|
+
let doc;
|
|
50
|
+
try {
|
|
51
|
+
doc = JSON.parse(raw);
|
|
52
|
+
}
|
|
53
|
+
catch (error) {
|
|
54
|
+
onError(error);
|
|
55
|
+
return { entries };
|
|
56
|
+
}
|
|
57
|
+
const shaped = doc;
|
|
58
|
+
if (!shaped ||
|
|
59
|
+
typeof shaped !== "object" ||
|
|
60
|
+
shaped.schema !== ONTOLOGY_OUTBOX_SCHEMA ||
|
|
61
|
+
shaped.company !== companySlug ||
|
|
62
|
+
!shaped.entries ||
|
|
63
|
+
typeof shaped.entries !== "object" ||
|
|
64
|
+
Array.isArray(shaped.entries)) {
|
|
65
|
+
onError(new Error("ontology outbox has an unexpected shape"));
|
|
66
|
+
return { entries };
|
|
67
|
+
}
|
|
68
|
+
for (const [key, entry] of Object.entries(shaped.entries)) {
|
|
69
|
+
const { sha256, written_at } = (entry ?? {});
|
|
70
|
+
if (typeof sha256 !== "string" ||
|
|
71
|
+
!/^[0-9a-f]{64}$/.test(sha256) ||
|
|
72
|
+
typeof written_at !== "string" ||
|
|
73
|
+
!Number.isFinite(Date.parse(written_at))) {
|
|
74
|
+
onError(new Error("ontology outbox has a malformed entry"));
|
|
75
|
+
return { entries: new Map() };
|
|
76
|
+
}
|
|
77
|
+
entries.set(ontologyVaultKey(key), sha256);
|
|
78
|
+
}
|
|
79
|
+
return { entries };
|
|
80
|
+
}
|
|
81
|
+
/**
|
|
82
|
+
* True iff the local file at `absolutePath` is a regular file whose bytes are
|
|
83
|
+
* the ones the checkpoint recorded for `relativePath`. With `plannedHash`, the
|
|
84
|
+
* recorded bytes must also be the ones the push planned to upload; uploadFile
|
|
85
|
+
* then refuses a body that no longer hashes to the planned value, so the bytes
|
|
86
|
+
* sent are the bytes checked here.
|
|
87
|
+
*/
|
|
88
|
+
export function outboxAllowsEntityPush(outbox, relativePath, absolutePath, plannedHash) {
|
|
89
|
+
const recorded = outbox.entries.get(ontologyVaultKey(relativePath));
|
|
90
|
+
if (recorded === undefined)
|
|
91
|
+
return false;
|
|
92
|
+
if (plannedHash !== undefined && plannedHash !== recorded)
|
|
93
|
+
return false;
|
|
94
|
+
try {
|
|
95
|
+
if (!fs.lstatSync(absolutePath).isFile())
|
|
96
|
+
return false;
|
|
97
|
+
return hashFile(absolutePath) === recorded;
|
|
98
|
+
}
|
|
99
|
+
catch (error) {
|
|
100
|
+
if (error.code === "ENOENT")
|
|
101
|
+
return false;
|
|
102
|
+
throw error;
|
|
103
|
+
}
|
|
104
|
+
}
|
|
105
|
+
/**
|
|
106
|
+
* True iff the entity body's `last_updated` is within the create window of
|
|
107
|
+
* `nowMs`. A body without a readable `last_updated` is not fresh, and neither
|
|
108
|
+
* is one dated more than {@link ENTITY_CREATE_FUTURE_SKEW_MS} ahead: a future
|
|
109
|
+
* date would otherwise stay "fresh" for good.
|
|
110
|
+
*/
|
|
111
|
+
export function entityIsFreshForCreate(body, nowMs) {
|
|
112
|
+
const stamp = entityLastUpdated(body);
|
|
113
|
+
if (stamp === null)
|
|
114
|
+
return false;
|
|
115
|
+
const age = nowMs - Date.parse(stamp);
|
|
116
|
+
return age >= -ENTITY_CREATE_FUTURE_SKEW_MS && age <= ENTITY_CREATE_WINDOW_MS;
|
|
117
|
+
}
|
|
118
|
+
//# sourceMappingURL=ontology-outbox.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"ontology-outbox.js","sourceRoot":"","sources":["../../src/lib/ontology-outbox.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
import { type FlagClient, type FlagClientOptions } from "@indigoai-us/hq-flags-client";
|
|
2
|
+
export declare const SKILL_REGISTER_LANDED_BYTES_FLAG = "sync.skill-register-landed-bytes";
|
|
3
|
+
export interface SkillRegisterLandedBytesInput {
|
|
4
|
+
companyUid: string;
|
|
5
|
+
companySlug?: string;
|
|
6
|
+
endpoint?: string;
|
|
7
|
+
getToken?: () => string | Promise<string>;
|
|
8
|
+
env?: Readonly<Record<string, string | undefined>>;
|
|
9
|
+
createClient?: (options: FlagClientOptions) => Pick<FlagClient, "ready" | "explain" | "close">;
|
|
10
|
+
now?: () => number;
|
|
11
|
+
onError?: (error: unknown) => void;
|
|
12
|
+
}
|
|
13
|
+
/** Resolve the sync rollout flag. Missing rows and read errors preserve current behavior. */
|
|
14
|
+
export declare function resolveSkillRegisterLandedBytes(input: SkillRegisterLandedBytesInput): Promise<boolean>;
|
|
15
|
+
export declare function _resetSkillRegisterLandedBytesCacheForTests(): void;
|
|
16
|
+
//# sourceMappingURL=skill-register-landed-bytes.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"skill-register-landed-bytes.d.ts","sourceRoot":"","sources":["../../src/lib/skill-register-landed-bytes.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,iBAAiB,EACvB,MAAM,8BAA8B,CAAC;AAEtC,eAAO,MAAM,gCAAgC,qCAAqC,CAAC;AAInF,MAAM,WAAW,6BAA6B;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1C,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IACnD,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,IAAI,CAAC,UAAU,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC,CAAC;IAC/F,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACpC;AAID,6FAA6F;AAC7F,wBAAsB,+BAA+B,CACnD,KAAK,EAAE,6BAA6B,GACnC,OAAO,CAAC,OAAO,CAAC,CA8DlB;AAED,wBAAgB,2CAA2C,IAAI,IAAI,CAElE"}
|