instar 1.3.5 → 1.3.7
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/feedback-factory/processor/fingerprint.d.ts +45 -0
- package/dist/feedback-factory/processor/fingerprint.d.ts.map +1 -0
- package/dist/feedback-factory/processor/fingerprint.js +97 -0
- package/dist/feedback-factory/processor/fingerprint.js.map +1 -0
- package/dist/monitoring/FrameworkIssueLedger.d.ts +46 -0
- package/dist/monitoring/FrameworkIssueLedger.d.ts.map +1 -1
- package/dist/monitoring/FrameworkIssueLedger.js +79 -0
- package/dist/monitoring/FrameworkIssueLedger.js.map +1 -1
- package/dist/server/CapabilityIndex.d.ts.map +1 -1
- package/dist/server/CapabilityIndex.js +1 -0
- package/dist/server/CapabilityIndex.js.map +1 -1
- package/dist/server/routes.d.ts.map +1 -1
- package/dist/server/routes.js +9 -0
- package/dist/server/routes.js.map +1 -1
- package/package.json +1 -1
- package/scripts/feedback-factory/_py_fingerprint_ref.py +43 -0
- package/scripts/feedback-factory/fingerprint-corpus.json +38 -0
- package/scripts/feedback-factory/fingerprint-parity.mjs +69 -0
- package/src/data/builtin-manifest.json +46 -46
- package/upgrades/1.3.6.md +43 -0
- package/upgrades/1.3.7.md +29 -0
- package/upgrades/side-effects/feedback-factory-fingerprint.md +36 -0
- package/upgrades/side-effects/framework-issue-capture.md +68 -0
package/package.json
CHANGED
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
"""Parity reference: compute fingerprints using the REAL feedback-processor.py.
|
|
3
|
+
|
|
4
|
+
Imports the reference processor (the-portal/.claude/scripts/feedback-processor.py)
|
|
5
|
+
WITHOUT running its CLI main (it has an `if __name__ == '__main__'` guard; loading
|
|
6
|
+
under a different module name keeps that dormant), then calls its actual
|
|
7
|
+
compute_fingerprint over the shared corpus. Emits JSON to stdout so the Node
|
|
8
|
+
harness can diff the TS port against this ground truth.
|
|
9
|
+
|
|
10
|
+
Usage: python3 _py_fingerprint_ref.py <processor_path> <corpus_path>
|
|
11
|
+
"""
|
|
12
|
+
import sys
|
|
13
|
+
import json
|
|
14
|
+
import importlib.util
|
|
15
|
+
|
|
16
|
+
|
|
17
|
+
def load_processor(path):
|
|
18
|
+
spec = importlib.util.spec_from_file_location("_feedback_processor_ref", path)
|
|
19
|
+
mod = importlib.util.module_from_spec(spec)
|
|
20
|
+
spec.loader.exec_module(mod) # safe: top-level is imports + constants + defs; DB work is inside cmd_* only
|
|
21
|
+
return mod
|
|
22
|
+
|
|
23
|
+
|
|
24
|
+
def main():
|
|
25
|
+
if len(sys.argv) != 3:
|
|
26
|
+
print("usage: _py_fingerprint_ref.py <processor_path> <corpus_path>", file=sys.stderr)
|
|
27
|
+
sys.exit(2)
|
|
28
|
+
processor_path, corpus_path = sys.argv[1], sys.argv[2]
|
|
29
|
+
proc = load_processor(processor_path)
|
|
30
|
+
with open(corpus_path, encoding="utf-8") as f:
|
|
31
|
+
corpus = json.load(f)
|
|
32
|
+
out = []
|
|
33
|
+
for case in corpus["cases"]:
|
|
34
|
+
t = case["type"]
|
|
35
|
+
title = case["title"]
|
|
36
|
+
component = case.get("component", "")
|
|
37
|
+
fp = proc.compute_fingerprint(t, title, component)
|
|
38
|
+
out.append({"type": t, "title": title, "component": component, "fp": fp})
|
|
39
|
+
sys.stdout.write(json.dumps(out, ensure_ascii=False))
|
|
40
|
+
|
|
41
|
+
|
|
42
|
+
if __name__ == "__main__":
|
|
43
|
+
main()
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
{
|
|
2
|
+
"_comment": "Parity corpus for the feedback fingerprint port. Real cases + the adversarial Unicode/encoding/whitespace cases the convergence flagged. Each entry: {type, title, component?}. The parity harness asserts the TS port produces byte-identical fingerprints to the reference Python (the-portal/.claude/scripts/feedback-processor.py) for every entry. Tricky code points are written as \\u escapes so both json.load (Python) and JSON.parse (Node) decode identical bytes.",
|
|
3
|
+
"cases": [
|
|
4
|
+
{ "type": "bug", "title": "GitSync.pull fails intermittently" },
|
|
5
|
+
{ "type": "bug", "title": "StateManager.listSessions returns stale data" },
|
|
6
|
+
{ "type": "bug", "title": "auth token refresh broken in v1.1.0" },
|
|
7
|
+
{ "type": "bug", "title": "auth token refresh broken in v1.1.1" },
|
|
8
|
+
{ "type": "bug", "title": "auth token refresh broken in v2.13.4-beta.2" },
|
|
9
|
+
{ "type": "feature", "title": "[DEGRADATION] StateManager.listSessions timeout" },
|
|
10
|
+
{ "type": "bug", "title": "[ALERT] GitSync.pull deadlock" },
|
|
11
|
+
{ "type": "bug", "title": "CRITICAL: auth refresh broken" },
|
|
12
|
+
{ "type": "bug", "title": "VERIFIED FIX: GitSync.pull race" },
|
|
13
|
+
{ "type": "bug", "title": "BUG REPORT: session reaper kills active session" },
|
|
14
|
+
{ "type": "bug", "title": "WONTFIX: legacy thing" },
|
|
15
|
+
{ "type": "bug", "title": "NOTASEVERITY: should not be stripped" },
|
|
16
|
+
{ "type": "bug", "title": "commit abc123def4567890 broke the build" },
|
|
17
|
+
{ "type": "bug", "title": "deadbeefcafe1234 hash in title" },
|
|
18
|
+
{ "type": "bug", "title": "retry 5 times then 12 failures at 300 seconds" },
|
|
19
|
+
{ "type": "bug", "title": "lowercase already and simple" },
|
|
20
|
+
{ "type": "bug", "title": "Title With Irregular Spacing" },
|
|
21
|
+
{ "type": "bug", "title": " leading and trailing whitespace " },
|
|
22
|
+
{ "type": "bug", "title": "" },
|
|
23
|
+
{ "type": "bug", "title": "[TAG] only a tag then word" },
|
|
24
|
+
{ "type": "bug", "title": "Component.sub.deep.path.identifier works" },
|
|
25
|
+
{ "type": "BUG", "title": "Type Case BUG vs bug", "component": "Explicit.Component" },
|
|
26
|
+
{ "type": "bug", "title": "version ٣.١.٠ with arabic-indic digits" },
|
|
27
|
+
{ "type": "bug", "title": "bare arabic-indic ٥ digit here" },
|
|
28
|
+
{ "type": "bug", "title": "em dash — separates words" },
|
|
29
|
+
{ "type": "bug", "title": "non breaking space title" },
|
|
30
|
+
{ "type": "bug", "title": "café composed NFC" },
|
|
31
|
+
{ "type": "bug", "title": "café decomposed NFD" },
|
|
32
|
+
{ "type": "bug", "title": "İstanbul Turkish dotted I" },
|
|
33
|
+
{ "type": "bug", "title": "ınternal Turkish dotless i" },
|
|
34
|
+
{ "type": "bug", "title": "Straße German eszett" },
|
|
35
|
+
{ "type": "bug", "title": "tab\tand\nnewline whitespace" },
|
|
36
|
+
{ "type": "bug", "title": "MixedCASE GitSync.Pull AND v3.4.5 plus abcdef1234567 hash" }
|
|
37
|
+
]
|
|
38
|
+
}
|
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
/**
|
|
3
|
+
* fingerprint-parity.mjs — LOCAL parity gate for the feedback fingerprint port.
|
|
4
|
+
*
|
|
5
|
+
* Runs the REAL reference Python (the-portal/.claude/scripts/feedback-processor.py
|
|
6
|
+
* compute_fingerprint) and the TS port over the shared corpus and asserts every
|
|
7
|
+
* fingerprint is byte-identical. This is the empirical equivalence gate the spec
|
|
8
|
+
* requires — it is intentionally NOT a CI test (CI doesn't have the reference
|
|
9
|
+
* checkout); it is run locally and its output recorded as evidence, and re-run
|
|
10
|
+
* whenever the port's regexes/normalization change.
|
|
11
|
+
*
|
|
12
|
+
* Reference path is configurable: PORTAL_PROCESSOR env var, else the default
|
|
13
|
+
* the-portal checkout. The TS port is imported from the built dist (run
|
|
14
|
+
* `npm run build` first).
|
|
15
|
+
*
|
|
16
|
+
* Exit 0 = 100% parity; exit 1 = at least one mismatch (printed).
|
|
17
|
+
*/
|
|
18
|
+
|
|
19
|
+
import { spawnSync } from 'node:child_process';
|
|
20
|
+
import fs from 'node:fs';
|
|
21
|
+
import path from 'node:path';
|
|
22
|
+
import { fileURLToPath } from 'node:url';
|
|
23
|
+
|
|
24
|
+
const __dirname = path.dirname(fileURLToPath(import.meta.url));
|
|
25
|
+
const ROOT = path.resolve(__dirname, '..', '..');
|
|
26
|
+
|
|
27
|
+
const PROCESSOR = process.env.PORTAL_PROCESSOR
|
|
28
|
+
|| '/Users/justin/Documents/Projects/the-portal/.claude/scripts/feedback-processor.py';
|
|
29
|
+
const CORPUS = path.join(__dirname, 'fingerprint-corpus.json');
|
|
30
|
+
const PY_REF = path.join(__dirname, '_py_fingerprint_ref.py');
|
|
31
|
+
|
|
32
|
+
if (!fs.existsSync(PROCESSOR)) {
|
|
33
|
+
console.error(`[parity] reference processor not found: ${PROCESSOR}`);
|
|
34
|
+
console.error('[parity] set PORTAL_PROCESSOR to the reference feedback-processor.py');
|
|
35
|
+
process.exit(2);
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
// Reference fingerprints from the real Python.
|
|
39
|
+
const py = spawnSync('python3', [PY_REF, PROCESSOR, CORPUS], { encoding: 'utf8' });
|
|
40
|
+
if (py.status !== 0) {
|
|
41
|
+
console.error('[parity] python reference failed:\n', py.stderr || py.stdout);
|
|
42
|
+
process.exit(2);
|
|
43
|
+
}
|
|
44
|
+
const reference = JSON.parse(py.stdout);
|
|
45
|
+
|
|
46
|
+
// TS port from the built dist.
|
|
47
|
+
const distUrl = new URL('file://' + path.join(ROOT, 'dist', 'feedback-factory', 'processor', 'fingerprint.js'));
|
|
48
|
+
const { computeFingerprint } = await import(distUrl.href);
|
|
49
|
+
|
|
50
|
+
let mismatches = 0;
|
|
51
|
+
for (const ref of reference) {
|
|
52
|
+
const got = computeFingerprint(ref.type, ref.title, ref.component);
|
|
53
|
+
const ok = got === ref.fp;
|
|
54
|
+
if (!ok) {
|
|
55
|
+
mismatches++;
|
|
56
|
+
console.error(`[MISMATCH] type=${JSON.stringify(ref.type)} title=${JSON.stringify(ref.title)} component=${JSON.stringify(ref.component)}`);
|
|
57
|
+
console.error(` python=${ref.fp}`);
|
|
58
|
+
console.error(` ts =${got}`);
|
|
59
|
+
}
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
const total = reference.length;
|
|
63
|
+
if (mismatches === 0) {
|
|
64
|
+
console.error(`[parity] ✓ ${total}/${total} fingerprints byte-identical to the reference Python.`);
|
|
65
|
+
process.exit(0);
|
|
66
|
+
} else {
|
|
67
|
+
console.error(`[parity] ✗ ${mismatches}/${total} mismatches — the TS port diverges from the reference.`);
|
|
68
|
+
process.exit(1);
|
|
69
|
+
}
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "./builtin-manifest.schema.json",
|
|
3
3
|
"schemaVersion": 1,
|
|
4
|
-
"generatedAt": "2026-05-
|
|
5
|
-
"instarVersion": "1.3.
|
|
4
|
+
"generatedAt": "2026-05-27T04:08:37.598Z",
|
|
5
|
+
"instarVersion": "1.3.7",
|
|
6
6
|
"entryCount": 192,
|
|
7
7
|
"entries": {
|
|
8
8
|
"hook:session-start": {
|
|
@@ -401,7 +401,7 @@
|
|
|
401
401
|
"type": "route-group",
|
|
402
402
|
"domain": "monitoring",
|
|
403
403
|
"sourcePath": "src/server/routes.ts",
|
|
404
|
-
"contentHash": "
|
|
404
|
+
"contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
|
|
405
405
|
"since": "2025-01-01"
|
|
406
406
|
},
|
|
407
407
|
"route-group:agents": {
|
|
@@ -409,7 +409,7 @@
|
|
|
409
409
|
"type": "route-group",
|
|
410
410
|
"domain": "sessions",
|
|
411
411
|
"sourcePath": "src/server/routes.ts",
|
|
412
|
-
"contentHash": "
|
|
412
|
+
"contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
|
|
413
413
|
"since": "2025-01-01"
|
|
414
414
|
},
|
|
415
415
|
"route-group:backups": {
|
|
@@ -417,7 +417,7 @@
|
|
|
417
417
|
"type": "route-group",
|
|
418
418
|
"domain": "operations",
|
|
419
419
|
"sourcePath": "src/server/routes.ts",
|
|
420
|
-
"contentHash": "
|
|
420
|
+
"contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
|
|
421
421
|
"since": "2025-01-01"
|
|
422
422
|
},
|
|
423
423
|
"route-group:git": {
|
|
@@ -425,7 +425,7 @@
|
|
|
425
425
|
"type": "route-group",
|
|
426
426
|
"domain": "coordination",
|
|
427
427
|
"sourcePath": "src/server/routes.ts",
|
|
428
|
-
"contentHash": "
|
|
428
|
+
"contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
|
|
429
429
|
"since": "2025-01-01"
|
|
430
430
|
},
|
|
431
431
|
"route-group:memory": {
|
|
@@ -433,7 +433,7 @@
|
|
|
433
433
|
"type": "route-group",
|
|
434
434
|
"domain": "memory",
|
|
435
435
|
"sourcePath": "src/server/routes.ts",
|
|
436
|
-
"contentHash": "
|
|
436
|
+
"contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
|
|
437
437
|
"since": "2025-01-01"
|
|
438
438
|
},
|
|
439
439
|
"route-group:semantic": {
|
|
@@ -441,7 +441,7 @@
|
|
|
441
441
|
"type": "route-group",
|
|
442
442
|
"domain": "memory",
|
|
443
443
|
"sourcePath": "src/server/routes.ts",
|
|
444
|
-
"contentHash": "
|
|
444
|
+
"contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
|
|
445
445
|
"since": "2025-01-01"
|
|
446
446
|
},
|
|
447
447
|
"route-group:status": {
|
|
@@ -449,7 +449,7 @@
|
|
|
449
449
|
"type": "route-group",
|
|
450
450
|
"domain": "monitoring",
|
|
451
451
|
"sourcePath": "src/server/routes.ts",
|
|
452
|
-
"contentHash": "
|
|
452
|
+
"contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
|
|
453
453
|
"since": "2025-01-01"
|
|
454
454
|
},
|
|
455
455
|
"route-group:capabilities": {
|
|
@@ -457,7 +457,7 @@
|
|
|
457
457
|
"type": "route-group",
|
|
458
458
|
"domain": "mapping",
|
|
459
459
|
"sourcePath": "src/server/routes.ts",
|
|
460
|
-
"contentHash": "
|
|
460
|
+
"contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
|
|
461
461
|
"since": "2025-01-01"
|
|
462
462
|
},
|
|
463
463
|
"route-group:project-map": {
|
|
@@ -465,7 +465,7 @@
|
|
|
465
465
|
"type": "route-group",
|
|
466
466
|
"domain": "mapping",
|
|
467
467
|
"sourcePath": "src/server/routes.ts",
|
|
468
|
-
"contentHash": "
|
|
468
|
+
"contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
|
|
469
469
|
"since": "2025-01-01"
|
|
470
470
|
},
|
|
471
471
|
"route-group:coherence": {
|
|
@@ -473,7 +473,7 @@
|
|
|
473
473
|
"type": "route-group",
|
|
474
474
|
"domain": "coherence",
|
|
475
475
|
"sourcePath": "src/server/routes.ts",
|
|
476
|
-
"contentHash": "
|
|
476
|
+
"contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
|
|
477
477
|
"since": "2025-01-01"
|
|
478
478
|
},
|
|
479
479
|
"route-group:topic-bindings": {
|
|
@@ -481,7 +481,7 @@
|
|
|
481
481
|
"type": "route-group",
|
|
482
482
|
"domain": "sessions",
|
|
483
483
|
"sourcePath": "src/server/routes.ts",
|
|
484
|
-
"contentHash": "
|
|
484
|
+
"contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
|
|
485
485
|
"since": "2025-01-01"
|
|
486
486
|
},
|
|
487
487
|
"route-group:context": {
|
|
@@ -489,7 +489,7 @@
|
|
|
489
489
|
"type": "route-group",
|
|
490
490
|
"domain": "context",
|
|
491
491
|
"sourcePath": "src/server/routes.ts",
|
|
492
|
-
"contentHash": "
|
|
492
|
+
"contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
|
|
493
493
|
"since": "2025-01-01"
|
|
494
494
|
},
|
|
495
495
|
"route-group:scope-coherence": {
|
|
@@ -497,7 +497,7 @@
|
|
|
497
497
|
"type": "route-group",
|
|
498
498
|
"domain": "coherence",
|
|
499
499
|
"sourcePath": "src/server/routes.ts",
|
|
500
|
-
"contentHash": "
|
|
500
|
+
"contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
|
|
501
501
|
"since": "2025-01-01"
|
|
502
502
|
},
|
|
503
503
|
"route-group:canonical-state": {
|
|
@@ -505,7 +505,7 @@
|
|
|
505
505
|
"type": "route-group",
|
|
506
506
|
"domain": "state",
|
|
507
507
|
"sourcePath": "src/server/routes.ts",
|
|
508
|
-
"contentHash": "
|
|
508
|
+
"contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
|
|
509
509
|
"since": "2025-01-01"
|
|
510
510
|
},
|
|
511
511
|
"route-group:ci": {
|
|
@@ -513,7 +513,7 @@
|
|
|
513
513
|
"type": "route-group",
|
|
514
514
|
"domain": "monitoring",
|
|
515
515
|
"sourcePath": "src/server/routes.ts",
|
|
516
|
-
"contentHash": "
|
|
516
|
+
"contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
|
|
517
517
|
"since": "2025-01-01"
|
|
518
518
|
},
|
|
519
519
|
"route-group:sessions": {
|
|
@@ -521,7 +521,7 @@
|
|
|
521
521
|
"type": "route-group",
|
|
522
522
|
"domain": "sessions",
|
|
523
523
|
"sourcePath": "src/server/routes.ts",
|
|
524
|
-
"contentHash": "
|
|
524
|
+
"contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
|
|
525
525
|
"since": "2025-01-01"
|
|
526
526
|
},
|
|
527
527
|
"route-group:jobs": {
|
|
@@ -529,7 +529,7 @@
|
|
|
529
529
|
"type": "route-group",
|
|
530
530
|
"domain": "scheduling",
|
|
531
531
|
"sourcePath": "src/server/routes.ts",
|
|
532
|
-
"contentHash": "
|
|
532
|
+
"contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
|
|
533
533
|
"since": "2025-01-01"
|
|
534
534
|
},
|
|
535
535
|
"route-group:skip-ledger": {
|
|
@@ -537,7 +537,7 @@
|
|
|
537
537
|
"type": "route-group",
|
|
538
538
|
"domain": "scheduling",
|
|
539
539
|
"sourcePath": "src/server/routes.ts",
|
|
540
|
-
"contentHash": "
|
|
540
|
+
"contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
|
|
541
541
|
"since": "2025-01-01"
|
|
542
542
|
},
|
|
543
543
|
"route-group:telegram": {
|
|
@@ -545,7 +545,7 @@
|
|
|
545
545
|
"type": "route-group",
|
|
546
546
|
"domain": "communication",
|
|
547
547
|
"sourcePath": "src/server/routes.ts",
|
|
548
|
-
"contentHash": "
|
|
548
|
+
"contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
|
|
549
549
|
"since": "2025-01-01"
|
|
550
550
|
},
|
|
551
551
|
"route-group:attention": {
|
|
@@ -553,7 +553,7 @@
|
|
|
553
553
|
"type": "route-group",
|
|
554
554
|
"domain": "communication",
|
|
555
555
|
"sourcePath": "src/server/routes.ts",
|
|
556
|
-
"contentHash": "
|
|
556
|
+
"contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
|
|
557
557
|
"since": "2025-01-01"
|
|
558
558
|
},
|
|
559
559
|
"route-group:relationships": {
|
|
@@ -561,7 +561,7 @@
|
|
|
561
561
|
"type": "route-group",
|
|
562
562
|
"domain": "relationships",
|
|
563
563
|
"sourcePath": "src/server/routes.ts",
|
|
564
|
-
"contentHash": "
|
|
564
|
+
"contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
|
|
565
565
|
"since": "2025-01-01"
|
|
566
566
|
},
|
|
567
567
|
"route-group:feedback": {
|
|
@@ -569,7 +569,7 @@
|
|
|
569
569
|
"type": "route-group",
|
|
570
570
|
"domain": "feedback",
|
|
571
571
|
"sourcePath": "src/server/routes.ts",
|
|
572
|
-
"contentHash": "
|
|
572
|
+
"contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
|
|
573
573
|
"since": "2025-01-01"
|
|
574
574
|
},
|
|
575
575
|
"route-group:updates": {
|
|
@@ -577,7 +577,7 @@
|
|
|
577
577
|
"type": "route-group",
|
|
578
578
|
"domain": "updates",
|
|
579
579
|
"sourcePath": "src/server/routes.ts",
|
|
580
|
-
"contentHash": "
|
|
580
|
+
"contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
|
|
581
581
|
"since": "2025-01-01"
|
|
582
582
|
},
|
|
583
583
|
"route-group:dispatches": {
|
|
@@ -585,7 +585,7 @@
|
|
|
585
585
|
"type": "route-group",
|
|
586
586
|
"domain": "dispatches",
|
|
587
587
|
"sourcePath": "src/server/routes.ts",
|
|
588
|
-
"contentHash": "
|
|
588
|
+
"contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
|
|
589
589
|
"since": "2025-01-01"
|
|
590
590
|
},
|
|
591
591
|
"route-group:quota": {
|
|
@@ -593,7 +593,7 @@
|
|
|
593
593
|
"type": "route-group",
|
|
594
594
|
"domain": "monitoring",
|
|
595
595
|
"sourcePath": "src/server/routes.ts",
|
|
596
|
-
"contentHash": "
|
|
596
|
+
"contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
|
|
597
597
|
"since": "2025-01-01"
|
|
598
598
|
},
|
|
599
599
|
"route-group:publishing": {
|
|
@@ -601,7 +601,7 @@
|
|
|
601
601
|
"type": "route-group",
|
|
602
602
|
"domain": "publishing",
|
|
603
603
|
"sourcePath": "src/server/routes.ts",
|
|
604
|
-
"contentHash": "
|
|
604
|
+
"contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
|
|
605
605
|
"since": "2025-01-01"
|
|
606
606
|
},
|
|
607
607
|
"route-group:private-views": {
|
|
@@ -609,7 +609,7 @@
|
|
|
609
609
|
"type": "route-group",
|
|
610
610
|
"domain": "publishing",
|
|
611
611
|
"sourcePath": "src/server/routes.ts",
|
|
612
|
-
"contentHash": "
|
|
612
|
+
"contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
|
|
613
613
|
"since": "2025-01-01"
|
|
614
614
|
},
|
|
615
615
|
"route-group:tunnel": {
|
|
@@ -617,7 +617,7 @@
|
|
|
617
617
|
"type": "route-group",
|
|
618
618
|
"domain": "networking",
|
|
619
619
|
"sourcePath": "src/server/routes.ts",
|
|
620
|
-
"contentHash": "
|
|
620
|
+
"contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
|
|
621
621
|
"since": "2025-01-01"
|
|
622
622
|
},
|
|
623
623
|
"route-group:events": {
|
|
@@ -625,7 +625,7 @@
|
|
|
625
625
|
"type": "route-group",
|
|
626
626
|
"domain": "networking",
|
|
627
627
|
"sourcePath": "src/server/routes.ts",
|
|
628
|
-
"contentHash": "
|
|
628
|
+
"contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
|
|
629
629
|
"since": "2025-01-01"
|
|
630
630
|
},
|
|
631
631
|
"route-group:evolution": {
|
|
@@ -633,7 +633,7 @@
|
|
|
633
633
|
"type": "route-group",
|
|
634
634
|
"domain": "evolution",
|
|
635
635
|
"sourcePath": "src/server/routes.ts",
|
|
636
|
-
"contentHash": "
|
|
636
|
+
"contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
|
|
637
637
|
"since": "2025-01-01"
|
|
638
638
|
},
|
|
639
639
|
"route-group:watchdog": {
|
|
@@ -641,7 +641,7 @@
|
|
|
641
641
|
"type": "route-group",
|
|
642
642
|
"domain": "monitoring",
|
|
643
643
|
"sourcePath": "src/server/routes.ts",
|
|
644
|
-
"contentHash": "
|
|
644
|
+
"contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
|
|
645
645
|
"since": "2025-01-01"
|
|
646
646
|
},
|
|
647
647
|
"route-group:topic-memory": {
|
|
@@ -649,7 +649,7 @@
|
|
|
649
649
|
"type": "route-group",
|
|
650
650
|
"domain": "memory",
|
|
651
651
|
"sourcePath": "src/server/routes.ts",
|
|
652
|
-
"contentHash": "
|
|
652
|
+
"contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
|
|
653
653
|
"since": "2025-01-01"
|
|
654
654
|
},
|
|
655
655
|
"route-group:state-sync": {
|
|
@@ -657,7 +657,7 @@
|
|
|
657
657
|
"type": "route-group",
|
|
658
658
|
"domain": "coordination",
|
|
659
659
|
"sourcePath": "src/server/routes.ts",
|
|
660
|
-
"contentHash": "
|
|
660
|
+
"contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
|
|
661
661
|
"since": "2025-01-01"
|
|
662
662
|
},
|
|
663
663
|
"route-group:intent": {
|
|
@@ -665,7 +665,7 @@
|
|
|
665
665
|
"type": "route-group",
|
|
666
666
|
"domain": "intent",
|
|
667
667
|
"sourcePath": "src/server/routes.ts",
|
|
668
|
-
"contentHash": "
|
|
668
|
+
"contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
|
|
669
669
|
"since": "2025-01-01"
|
|
670
670
|
},
|
|
671
671
|
"route-group:triage": {
|
|
@@ -673,7 +673,7 @@
|
|
|
673
673
|
"type": "route-group",
|
|
674
674
|
"domain": "safety",
|
|
675
675
|
"sourcePath": "src/server/routes.ts",
|
|
676
|
-
"contentHash": "
|
|
676
|
+
"contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
|
|
677
677
|
"since": "2025-01-01"
|
|
678
678
|
},
|
|
679
679
|
"route-group:operations": {
|
|
@@ -681,7 +681,7 @@
|
|
|
681
681
|
"type": "route-group",
|
|
682
682
|
"domain": "safety",
|
|
683
683
|
"sourcePath": "src/server/routes.ts",
|
|
684
|
-
"contentHash": "
|
|
684
|
+
"contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
|
|
685
685
|
"since": "2025-01-01"
|
|
686
686
|
},
|
|
687
687
|
"route-group:sentinel": {
|
|
@@ -689,7 +689,7 @@
|
|
|
689
689
|
"type": "route-group",
|
|
690
690
|
"domain": "safety",
|
|
691
691
|
"sourcePath": "src/server/routes.ts",
|
|
692
|
-
"contentHash": "
|
|
692
|
+
"contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
|
|
693
693
|
"since": "2025-01-01"
|
|
694
694
|
},
|
|
695
695
|
"route-group:trust": {
|
|
@@ -697,7 +697,7 @@
|
|
|
697
697
|
"type": "route-group",
|
|
698
698
|
"domain": "safety",
|
|
699
699
|
"sourcePath": "src/server/routes.ts",
|
|
700
|
-
"contentHash": "
|
|
700
|
+
"contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
|
|
701
701
|
"since": "2025-01-01"
|
|
702
702
|
},
|
|
703
703
|
"route-group:monitoring": {
|
|
@@ -705,7 +705,7 @@
|
|
|
705
705
|
"type": "route-group",
|
|
706
706
|
"domain": "monitoring",
|
|
707
707
|
"sourcePath": "src/server/routes.ts",
|
|
708
|
-
"contentHash": "
|
|
708
|
+
"contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
|
|
709
709
|
"since": "2025-01-01"
|
|
710
710
|
},
|
|
711
711
|
"route-group:commitments": {
|
|
@@ -713,7 +713,7 @@
|
|
|
713
713
|
"type": "route-group",
|
|
714
714
|
"domain": "commitments",
|
|
715
715
|
"sourcePath": "src/server/routes.ts",
|
|
716
|
-
"contentHash": "
|
|
716
|
+
"contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
|
|
717
717
|
"since": "2025-01-01"
|
|
718
718
|
},
|
|
719
719
|
"route-group:episodes": {
|
|
@@ -721,7 +721,7 @@
|
|
|
721
721
|
"type": "route-group",
|
|
722
722
|
"domain": "memory",
|
|
723
723
|
"sourcePath": "src/server/routes.ts",
|
|
724
|
-
"contentHash": "
|
|
724
|
+
"contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
|
|
725
725
|
"since": "2025-01-01"
|
|
726
726
|
},
|
|
727
727
|
"route-group:messages": {
|
|
@@ -729,7 +729,7 @@
|
|
|
729
729
|
"type": "route-group",
|
|
730
730
|
"domain": "coordination",
|
|
731
731
|
"sourcePath": "src/server/routes.ts",
|
|
732
|
-
"contentHash": "
|
|
732
|
+
"contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
|
|
733
733
|
"since": "2025-01-01"
|
|
734
734
|
},
|
|
735
735
|
"route-group:system-reviews": {
|
|
@@ -737,7 +737,7 @@
|
|
|
737
737
|
"type": "route-group",
|
|
738
738
|
"domain": "monitoring",
|
|
739
739
|
"sourcePath": "src/server/routes.ts",
|
|
740
|
-
"contentHash": "
|
|
740
|
+
"contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
|
|
741
741
|
"since": "2025-01-01"
|
|
742
742
|
},
|
|
743
743
|
"route-group:machine-mesh": {
|
|
@@ -753,7 +753,7 @@
|
|
|
753
753
|
"type": "route-group",
|
|
754
754
|
"domain": "security",
|
|
755
755
|
"sourcePath": "src/server/routes.ts",
|
|
756
|
-
"contentHash": "
|
|
756
|
+
"contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
|
|
757
757
|
"since": "2025-01-01"
|
|
758
758
|
},
|
|
759
759
|
"cli:init": {
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
# Instar Upgrade Guide — NEXT
|
|
2
|
+
|
|
3
|
+
<!-- bump: patch -->
|
|
4
|
+
|
|
5
|
+
## What Changed
|
|
6
|
+
|
|
7
|
+
**Framework-Onboarding Mentor System — Stage-B auto-capture (§19.2).** Building on the issue
|
|
8
|
+
ledger shipped last release, this adds the *write path*: a single atomic `captureRun()` entry
|
|
9
|
+
point that the mentor tick will call after observing a framework, plus a **capture funnel** that
|
|
10
|
+
logs **every** run — including runs that found nothing. That funnel is the structural guard
|
|
11
|
+
against a silent, broken writer: because a zero-finding run is still recorded as a run, "ran and
|
|
12
|
+
found nothing" is always distinguishable from "never ran / writer is dead." Regression candidates
|
|
13
|
+
(a new issue matching a previously-fixed one) are *surfaced for review, never auto-linked* — the
|
|
14
|
+
writer doesn't get to decide a regression.
|
|
15
|
+
|
|
16
|
+
A new read-only route `GET /framework-issues/capture-stats` exposes the funnel (runs vs
|
|
17
|
+
observations written, broken down per framework). Still observability-only — nothing gates, and
|
|
18
|
+
there is no production caller yet (the mentor job that calls `captureRun` ships in a later staged
|
|
19
|
+
PR), so this is dormant infrastructure with full test coverage.
|
|
20
|
+
|
|
21
|
+
## What to Tell Your User
|
|
22
|
+
|
|
23
|
+
- The "notebook" now has a guaranteed *hand that writes* — whatever I notice while inspecting a
|
|
24
|
+
framework gets recorded automatically, and there's a visible counter so a broken writer can't
|
|
25
|
+
hide by looking quiet.
|
|
26
|
+
- Nothing changes in your day-to-day yet; it's the next layer of a system that's still rolling
|
|
27
|
+
out gradually and stays off by default.
|
|
28
|
+
|
|
29
|
+
## Summary of New Capabilities
|
|
30
|
+
|
|
31
|
+
| Capability | How to Use |
|
|
32
|
+
|-----------|-----------|
|
|
33
|
+
| Stage-B auto-capture | `FrameworkIssueLedger.captureRun({ framework, tickId, findings })` — one atomic call the mentor tick makes; writes findings + logs the run |
|
|
34
|
+
| Capture funnel | `curl -H "Authorization: Bearer $AUTH" http://localhost:<port>/framework-issues/capture-stats` — runs vs observations written, per framework (inert-writer guard) |
|
|
35
|
+
|
|
36
|
+
## Evidence
|
|
37
|
+
|
|
38
|
+
Net-new feature, not a bug fix — no prior failure to reproduce. Behavior is verified by tests:
|
|
39
|
+
the inert-writer guard is proven by a unit test asserting a **zero-finding `captureRun` still
|
|
40
|
+
increments the funnel's run count while observations stay at 0** (so "ran, found nothing" ≠ "never
|
|
41
|
+
ran"), and a Tier-3 e2e boots the real server, runs a capture against the live ledger, and confirms
|
|
42
|
+
`GET /framework-issues/capture-stats` reflects both the run and the written observation. 46 feature
|
|
43
|
+
tests + 299 capability tests green; affected push-config suite (842) green vs canonical main.
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
# Upgrade Guide — vNEXT
|
|
2
|
+
|
|
3
|
+
<!-- bump: patch -->
|
|
4
|
+
|
|
5
|
+
## What Changed
|
|
6
|
+
|
|
7
|
+
First increment of the **Feedback Factory Migration** (Dawn → Echo; spec `docs/specs/feedback-factory-migration.md`, approved). Ports the dedup **fingerprinter** — scar (b), the single most correctness-critical piece of the "sorting brain" that decides whether two reports describe the same bug — from the reference Python (`the-portal/.claude/scripts/feedback-processor.py`) to TypeScript at `src/feedback-factory/processor/fingerprint.ts`.
|
|
8
|
+
|
|
9
|
+
This is an internal building block: it is **not wired into any route, job, or runtime path yet**, so there is no behavioral change for any agent or user. It establishes the new `src/feedback-factory/` module and — importantly — the **parity-harness methodology** (`scripts/feedback-factory/fingerprint-parity.mjs`) that runs the real reference Python and asserts the TS port is byte-identical. Every subsequent scar port reuses this harness.
|
|
10
|
+
|
|
11
|
+
## What to Tell Your User
|
|
12
|
+
|
|
13
|
+
- This is groundwork, not a feature you'll notice yet — the first verified piece of moving the feedback system to where it's built.
|
|
14
|
+
- The interesting part: I proved my rewrite produces exactly the same results as the original, character-for-character, including the tricky non-English-text cases — so nothing in the bug history can quietly drift as the move proceeds.
|
|
15
|
+
|
|
16
|
+
## Summary of New Capabilities
|
|
17
|
+
|
|
18
|
+
| Capability | How to Use |
|
|
19
|
+
|-----------|-----------|
|
|
20
|
+
| Feedback fingerprinter (TS port) | Internal module `src/feedback-factory/processor/fingerprint.ts` — not yet wired; foundation for the processor job |
|
|
21
|
+
| Parity harness | `node scripts/feedback-factory/fingerprint-parity.mjs` (local; set `PORTAL_PROCESSOR` to the reference) |
|
|
22
|
+
|
|
23
|
+
## Evidence
|
|
24
|
+
|
|
25
|
+
The byte-exact port is the whole risk, so it was verified empirically, not by reasoning:
|
|
26
|
+
|
|
27
|
+
- **Parity vs the real reference Python:** ran `compute_fingerprint` from `the-portal/.claude/scripts/feedback-processor.py` and the TS port over a 33-entry corpus (real titles + adversarial Unicode/encoding/whitespace cases). Result: **33/33 byte-identical**.
|
|
28
|
+
- **The harness caught a real divergence before it could ship:** the first cut diverged on a bare arabic-indic digit, because Python's `\b\d+\b` is a *Unicode* word boundary while JavaScript's `\b` is ASCII-only — so the digit wasn't collapsed. Fixed by emulating the Unicode boundary with lookarounds; re-ran → 33/33. This is exactly the silent-history-fork hazard the spec's convergence flagged, caught at the foundation.
|
|
29
|
+
- **CI regression anchors:** three golden fingerprint values captured from the reference are asserted in the unit test, so a future regex/encoding regression fails in CI even where the reference checkout isn't present.
|