@designerbyron/lifecode-rag 0.0.0-stage → 1.1.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/LICENSE +21 -0
- package/README.md +220 -2
- package/bin/lifecode-rag.mjs +449 -0
- package/client.js +3515 -0
- package/cordis.patch.yml +3 -0
- package/docs/ARCHITECTURE-v0.2.md +269 -0
- package/docs/AUTO-DISCOVERY.md +111 -0
- package/docs/AUTOMATION-POLICIES.md +232 -0
- package/docs/CONTRATO-v0.1.md +195 -0
- package/docs/EMBEDDING-PROVIDERS.md +105 -0
- package/docs/OBSERVABILITY.md +241 -0
- package/docs/PA-UI-0-API-CONTRACT.md +887 -0
- package/docs/PERFORMANCE-BUDGETS.md +118 -0
- package/docs/PROJECT-AWARE-ARCHITECTURE.md +580 -0
- package/docs/PROJECT-AWARE-DATA-CONTRACT.md +411 -0
- package/docs/PROJECT-AWARE-ERROR-CONTRACT.md +112 -0
- package/docs/PROJECT-AWARE-SESSION-CONTRACT.md +120 -0
- package/docs/WORKSPACE-API.md +239 -0
- package/icon.svg +7 -0
- package/index.js +198 -0
- package/lib/audit-export.mjs +70 -0
- package/lib/audit.mjs +120 -0
- package/lib/auto-context.mjs +322 -0
- package/lib/automation.mjs +214 -0
- package/lib/chunk.mjs +100 -0
- package/lib/config-resolve.mjs +119 -0
- package/lib/context.mjs +150 -0
- package/lib/conversation-events.mjs +145 -0
- package/lib/db.mjs +309 -0
- package/lib/diagnose.mjs +197 -0
- package/lib/discovery.mjs +402 -0
- package/lib/doctor.mjs +82 -0
- package/lib/embed.mjs +96 -0
- package/lib/embedders.mjs +103 -0
- package/lib/errors.mjs +231 -0
- package/lib/exec-context.mjs +238 -0
- package/lib/extract.mjs +260 -0
- package/lib/harness-workspaces.mjs +85 -0
- package/lib/hash.mjs +34 -0
- package/lib/ingest.mjs +239 -0
- package/lib/inputs.mjs +67 -0
- package/lib/library-state.mjs +252 -0
- package/lib/maintenance.mjs +113 -0
- package/lib/metrics.mjs +164 -0
- package/lib/migrate.mjs +373 -0
- package/lib/operations.mjs +132 -0
- package/lib/pa-api.mjs +946 -0
- package/lib/paths.mjs +345 -0
- package/lib/policy.mjs +125 -0
- package/lib/profile.mjs +128 -0
- package/lib/readmodel.mjs +159 -0
- package/lib/recovery.mjs +557 -0
- package/lib/registry-schema.mjs +206 -0
- package/lib/registry.mjs +606 -0
- package/lib/resolve.mjs +318 -0
- package/lib/retention.mjs +143 -0
- package/lib/revocation.mjs +124 -0
- package/lib/roots-structure.mjs +224 -0
- package/lib/schema.mjs +173 -0
- package/lib/scope-ops.mjs +379 -0
- package/lib/scope-stores.mjs +128 -0
- package/lib/search.mjs +345 -0
- package/lib/selection.mjs +225 -0
- package/lib/server.mjs +340 -0
- package/lib/session-identity.mjs +51 -0
- package/lib/sessions.mjs +343 -0
- package/lib/sync-scheduler.mjs +354 -0
- package/lib/sync.mjs +755 -0
- package/lib/tags.mjs +45 -0
- package/lib/tools.mjs +364 -0
- package/lib/trusted-roots.mjs +149 -0
- package/lib/worker-context.mjs +22 -0
- package/package.json +67 -5
|
@@ -0,0 +1,206 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* DDL del registro Project-Aware (PA1). Es la traducción literal del contrato de datos
|
|
3
|
+
* `docs/PROJECT-AWARE-DATA-CONTRACT.md` §3. Cualquier cambio aquí debe reflejarse allí y en
|
|
4
|
+
* `eval/pa0/sql-check.mjs`.
|
|
5
|
+
*/
|
|
6
|
+
|
|
7
|
+
export const REGISTRY_APPLICATION_ID = 1_279_480_402; // 'LCRR'
|
|
8
|
+
/** v2: añade `pa_selection` (selección de proyecto persistida con revisión monotónica, CR-1). */
|
|
9
|
+
export const REGISTRY_VERSION = 2;
|
|
10
|
+
|
|
11
|
+
export const REGISTRY_DDL = Object.freeze([
|
|
12
|
+
`CREATE TABLE meta (key TEXT PRIMARY KEY, value TEXT NOT NULL) STRICT`,
|
|
13
|
+
|
|
14
|
+
`CREATE TABLE projects (
|
|
15
|
+
id TEXT PRIMARY KEY
|
|
16
|
+
CHECK (substr(id,1,4)='prj_' AND length(id)=30
|
|
17
|
+
AND substr(id,5) NOT GLOB '*[^0-9A-HJKMNP-TV-Z]*'),
|
|
18
|
+
name TEXT NOT NULL CHECK (length(trim(name)) BETWEEN 1 AND 120),
|
|
19
|
+
status TEXT NOT NULL DEFAULT 'active' CHECK (status IN ('active','archived')),
|
|
20
|
+
created_at TEXT NOT NULL,
|
|
21
|
+
updated_at TEXT NOT NULL,
|
|
22
|
+
archived_at TEXT,
|
|
23
|
+
CHECK ((status='archived') = (archived_at IS NOT NULL))
|
|
24
|
+
) STRICT`,
|
|
25
|
+
|
|
26
|
+
`CREATE TABLE libraries (
|
|
27
|
+
id TEXT PRIMARY KEY
|
|
28
|
+
CHECK (substr(id,1,4)='lib_' AND length(id)=30
|
|
29
|
+
AND substr(id,5) NOT GLOB '*[^0-9A-HJKMNP-TV-Z]*'),
|
|
30
|
+
name TEXT NOT NULL CHECK (length(trim(name)) BETWEEN 1 AND 120),
|
|
31
|
+
status TEXT NOT NULL DEFAULT 'active' CHECK (status IN ('active','archived')),
|
|
32
|
+
created_at TEXT NOT NULL,
|
|
33
|
+
updated_at TEXT NOT NULL,
|
|
34
|
+
archived_at TEXT,
|
|
35
|
+
CHECK ((status='archived') = (archived_at IS NOT NULL))
|
|
36
|
+
) STRICT`,
|
|
37
|
+
|
|
38
|
+
`CREATE TABLE roots (
|
|
39
|
+
id TEXT PRIMARY KEY
|
|
40
|
+
CHECK (substr(id,1,3)='rt_' AND length(id)=29
|
|
41
|
+
AND substr(id,4) NOT GLOB '*[^0-9A-HJKMNP-TV-Z]*'),
|
|
42
|
+
scope_kind TEXT NOT NULL CHECK (scope_kind IN ('prj','lib')),
|
|
43
|
+
scope_id TEXT NOT NULL,
|
|
44
|
+
path TEXT NOT NULL CHECK (length(path) > 0),
|
|
45
|
+
path_key TEXT NOT NULL UNIQUE,
|
|
46
|
+
state TEXT NOT NULL DEFAULT 'authorized' CHECK (state IN ('authorized','revoked')),
|
|
47
|
+
added_at TEXT NOT NULL,
|
|
48
|
+
added_by TEXT NOT NULL CHECK (added_by IN ('human','host')),
|
|
49
|
+
revoked_at TEXT,
|
|
50
|
+
CHECK ((state='revoked') = (revoked_at IS NOT NULL)),
|
|
51
|
+
CHECK ((scope_kind='prj' AND substr(scope_id,1,4)='prj_')
|
|
52
|
+
OR (scope_kind='lib' AND substr(scope_id,1,4)='lib_')),
|
|
53
|
+
UNIQUE (id, scope_kind, scope_id)
|
|
54
|
+
) STRICT`,
|
|
55
|
+
|
|
56
|
+
`CREATE TRIGGER roots_scope_insert BEFORE INSERT ON roots
|
|
57
|
+
WHEN (NEW.scope_kind='prj' AND NOT EXISTS (SELECT 1 FROM projects WHERE id=NEW.scope_id))
|
|
58
|
+
OR (NEW.scope_kind='lib' AND NOT EXISTS (SELECT 1 FROM libraries WHERE id=NEW.scope_id))
|
|
59
|
+
BEGIN SELECT RAISE(ABORT,'root-scope-missing'); END`,
|
|
60
|
+
|
|
61
|
+
`CREATE TRIGGER roots_scope_immutable BEFORE UPDATE OF scope_kind, scope_id ON roots
|
|
62
|
+
BEGIN SELECT RAISE(ABORT,'root-scope-immutable'); END`,
|
|
63
|
+
|
|
64
|
+
`CREATE TRIGGER projects_roots_guard BEFORE DELETE ON projects
|
|
65
|
+
WHEN EXISTS (SELECT 1 FROM roots WHERE scope_kind='prj' AND scope_id=OLD.id)
|
|
66
|
+
BEGIN SELECT RAISE(ABORT,'scope-has-roots'); END`,
|
|
67
|
+
|
|
68
|
+
`CREATE TRIGGER libraries_roots_guard BEFORE DELETE ON libraries
|
|
69
|
+
WHEN EXISTS (SELECT 1 FROM roots WHERE scope_kind='lib' AND scope_id=OLD.id)
|
|
70
|
+
BEGIN SELECT RAISE(ABORT,'scope-has-roots'); END`,
|
|
71
|
+
|
|
72
|
+
`CREATE TABLE grants (
|
|
73
|
+
id INTEGER PRIMARY KEY AUTOINCREMENT,
|
|
74
|
+
project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
|
|
75
|
+
library_id TEXT NOT NULL REFERENCES libraries(id) ON DELETE CASCADE,
|
|
76
|
+
permission TEXT NOT NULL DEFAULT 'read' CHECK (permission='read'),
|
|
77
|
+
granted_at TEXT NOT NULL,
|
|
78
|
+
granted_by TEXT NOT NULL CHECK (granted_by IN ('human','host')),
|
|
79
|
+
revoked_at TEXT,
|
|
80
|
+
revoked_by TEXT,
|
|
81
|
+
CHECK ((revoked_at IS NULL) = (revoked_by IS NULL))
|
|
82
|
+
) STRICT`,
|
|
83
|
+
|
|
84
|
+
`CREATE UNIQUE INDEX grants_one_open ON grants(project_id, library_id) WHERE revoked_at IS NULL`,
|
|
85
|
+
|
|
86
|
+
`CREATE TABLE session_scope (
|
|
87
|
+
session_id TEXT PRIMARY KEY
|
|
88
|
+
CHECK (length(session_id) BETWEEN 1 AND 200 AND session_id NOT GLOB '*[^ -~]*'),
|
|
89
|
+
project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE RESTRICT,
|
|
90
|
+
state TEXT NOT NULL DEFAULT 'active'
|
|
91
|
+
CHECK (state IN ('active','expired','invalidated')),
|
|
92
|
+
selection_source TEXT NOT NULL CHECK (selection_source IN ('explicit','cwd')),
|
|
93
|
+
selected_by TEXT NOT NULL CHECK (selected_by IN ('human','host')),
|
|
94
|
+
selected_at TEXT NOT NULL,
|
|
95
|
+
updated_at TEXT NOT NULL,
|
|
96
|
+
expires_at TEXT,
|
|
97
|
+
invalidated_at TEXT,
|
|
98
|
+
invalid_reason TEXT CHECK (invalid_reason IS NULL OR invalid_reason IN
|
|
99
|
+
('project-archived','grant-revoked','root-revoked','profile-changed',
|
|
100
|
+
'admin','session-cloned')),
|
|
101
|
+
cwd TEXT,
|
|
102
|
+
clone_of TEXT,
|
|
103
|
+
revision INTEGER NOT NULL DEFAULT 1 CHECK (revision >= 1),
|
|
104
|
+
CHECK (state <> 'active' OR (invalidated_at IS NULL AND invalid_reason IS NULL)),
|
|
105
|
+
CHECK (state <> 'expired' OR (expires_at IS NOT NULL AND invalidated_at IS NULL
|
|
106
|
+
AND invalid_reason IS NULL)),
|
|
107
|
+
CHECK (state <> 'invalidated' OR (invalidated_at IS NOT NULL AND invalid_reason IS NOT NULL
|
|
108
|
+
AND expires_at IS NULL))
|
|
109
|
+
) STRICT`,
|
|
110
|
+
|
|
111
|
+
`CREATE TABLE pa_selection (
|
|
112
|
+
selection_key TEXT PRIMARY KEY CHECK (selection_key='profile'),
|
|
113
|
+
project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
|
|
114
|
+
revision INTEGER NOT NULL CHECK (revision >= 1),
|
|
115
|
+
selection_source TEXT NOT NULL CHECK (selection_source IN ('explicit','cwd')),
|
|
116
|
+
selected_by TEXT NOT NULL CHECK (selected_by IN ('human','host')),
|
|
117
|
+
principal TEXT NOT NULL DEFAULT 'owner',
|
|
118
|
+
selected_at TEXT NOT NULL,
|
|
119
|
+
updated_at TEXT NOT NULL
|
|
120
|
+
) STRICT`,
|
|
121
|
+
|
|
122
|
+
`CREATE TABLE sync_state (
|
|
123
|
+
scope_kind TEXT NOT NULL CHECK (scope_kind IN ('prj','lib')),
|
|
124
|
+
scope_id TEXT NOT NULL,
|
|
125
|
+
root_id TEXT NOT NULL,
|
|
126
|
+
source_key TEXT NOT NULL,
|
|
127
|
+
status TEXT NOT NULL CHECK (status IN ('present','missing','unreadable')),
|
|
128
|
+
last_seen_at TEXT,
|
|
129
|
+
last_hash TEXT,
|
|
130
|
+
missing_since TEXT,
|
|
131
|
+
error_code TEXT,
|
|
132
|
+
updated_at TEXT NOT NULL,
|
|
133
|
+
PRIMARY KEY (scope_kind, scope_id, root_id, source_key),
|
|
134
|
+
CHECK ((scope_kind='prj' AND substr(scope_id,1,4)='prj_')
|
|
135
|
+
OR (scope_kind='lib' AND substr(scope_id,1,4)='lib_')),
|
|
136
|
+
FOREIGN KEY (root_id, scope_kind, scope_id)
|
|
137
|
+
REFERENCES roots(id, scope_kind, scope_id) ON DELETE CASCADE
|
|
138
|
+
) STRICT`,
|
|
139
|
+
|
|
140
|
+
`CREATE TABLE audit_registry (
|
|
141
|
+
seq INTEGER PRIMARY KEY AUTOINCREMENT,
|
|
142
|
+
at TEXT NOT NULL,
|
|
143
|
+
actor TEXT NOT NULL CHECK (actor IN ('human','host','model','automation')),
|
|
144
|
+
session_id TEXT,
|
|
145
|
+
action TEXT NOT NULL,
|
|
146
|
+
target TEXT NOT NULL,
|
|
147
|
+
outcome TEXT NOT NULL CHECK (outcome IN ('ok','failed','denied','skipped')),
|
|
148
|
+
detail TEXT,
|
|
149
|
+
prev_hash TEXT NOT NULL,
|
|
150
|
+
hash TEXT NOT NULL
|
|
151
|
+
) STRICT`,
|
|
152
|
+
|
|
153
|
+
`CREATE TABLE operations (
|
|
154
|
+
id TEXT PRIMARY KEY
|
|
155
|
+
CHECK (substr(id,1,3)='op_' AND length(id)=29
|
|
156
|
+
AND substr(id,4) NOT GLOB '*[^0-9A-HJKMNP-TV-Z]*'),
|
|
157
|
+
kind TEXT NOT NULL,
|
|
158
|
+
state TEXT NOT NULL CHECK (state IN ('started','committed','failed','reconciled')),
|
|
159
|
+
started_at TEXT NOT NULL,
|
|
160
|
+
finished_at TEXT,
|
|
161
|
+
detail TEXT,
|
|
162
|
+
CHECK ((state IN ('committed','failed','reconciled')) = (finished_at IS NOT NULL))
|
|
163
|
+
) STRICT`,
|
|
164
|
+
|
|
165
|
+
`CREATE TABLE operation_steps (
|
|
166
|
+
operation_id TEXT NOT NULL REFERENCES operations(id) ON DELETE CASCADE,
|
|
167
|
+
step TEXT NOT NULL,
|
|
168
|
+
state TEXT NOT NULL CHECK (state IN ('pending','done','failed')),
|
|
169
|
+
effect_key TEXT,
|
|
170
|
+
updated_at TEXT NOT NULL,
|
|
171
|
+
PRIMARY KEY (operation_id, step)
|
|
172
|
+
) STRICT`,
|
|
173
|
+
|
|
174
|
+
`CREATE UNIQUE INDEX operation_steps_effect
|
|
175
|
+
ON operation_steps(operation_id, effect_key) WHERE effect_key IS NOT NULL`,
|
|
176
|
+
|
|
177
|
+
`CREATE INDEX projects_status ON projects(status)`,
|
|
178
|
+
`CREATE INDEX roots_scope ON roots(scope_kind, scope_id, state)`,
|
|
179
|
+
`CREATE INDEX grants_project_open ON grants(project_id) WHERE revoked_at IS NULL`,
|
|
180
|
+
`CREATE INDEX session_scope_project ON session_scope(project_id, state)`,
|
|
181
|
+
`CREATE INDEX session_scope_expiry ON session_scope(state, expires_at)`,
|
|
182
|
+
`CREATE INDEX pa_selection_project ON pa_selection(project_id)`,
|
|
183
|
+
`CREATE INDEX sync_state_status ON sync_state(scope_kind, scope_id, status)`,
|
|
184
|
+
`CREATE INDEX audit_registry_at ON audit_registry(at)`,
|
|
185
|
+
]);
|
|
186
|
+
|
|
187
|
+
/**
|
|
188
|
+
* Migraciones aditivas del registro, por versión de destino. Sólo crean estructuras nuevas: ninguna
|
|
189
|
+
* toca filas existentes, así que un registro v1 se abre y sigue sirviendo con los mismos datos.
|
|
190
|
+
* La versión se fija con `PRAGMA user_version` y `meta.registry_version` en la misma transacción.
|
|
191
|
+
*/
|
|
192
|
+
export const REGISTRY_MIGRATIONS = Object.freeze({
|
|
193
|
+
2: Object.freeze([
|
|
194
|
+
`CREATE TABLE IF NOT EXISTS pa_selection (
|
|
195
|
+
selection_key TEXT PRIMARY KEY CHECK (selection_key='profile'),
|
|
196
|
+
project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
|
|
197
|
+
revision INTEGER NOT NULL CHECK (revision >= 1),
|
|
198
|
+
selection_source TEXT NOT NULL CHECK (selection_source IN ('explicit','cwd')),
|
|
199
|
+
selected_by TEXT NOT NULL CHECK (selected_by IN ('human','host')),
|
|
200
|
+
principal TEXT NOT NULL DEFAULT 'owner',
|
|
201
|
+
selected_at TEXT NOT NULL,
|
|
202
|
+
updated_at TEXT NOT NULL
|
|
203
|
+
) STRICT`,
|
|
204
|
+
`CREATE INDEX IF NOT EXISTS pa_selection_project ON pa_selection(project_id)`,
|
|
205
|
+
]),
|
|
206
|
+
});
|