aaronrene / knowtation public
section-source-transport-plan.test.mjs
131 lines 5.8 KB
Raw
sha256:8915fe406161f95c1681f9469375e7bae5b28c884f00bedbdef65e4b0cd0738d docs(flow): commit FLOW-V0-SPEC.md hygiene for 7A-INT merge Human 21 hours ago
1 /**
2 * SectionSource Phase 1D transport planning tests.
3 *
4 * Phase 1D accepted future body-free CLI and self-hosted MCP surfaces only. It
5 * must not allow hosted MCP, Hub, search, persistence, Scooling runtime
6 * behavior, section bodies, snippets, summaries, PageIndex, OCR, LLM calls, or
7 * provider routing.
8 */
9 import { describe, it } from 'node:test';
10 import assert from 'node:assert/strict';
11 import fs from 'fs';
12 import path from 'path';
13 import { fileURLToPath } from 'url';
14
15 import { readSectionSource } from '../lib/section-source-note.mjs';
16
17 const __dirname = path.dirname(fileURLToPath(import.meta.url));
18 const repoRoot = path.dirname(__dirname);
19 const fixtureVault = path.join(__dirname, 'fixtures', 'vault-fs');
20 const planPath = path.join(repoRoot, 'docs', 'SECTION-SOURCE-TRANSPORT-PLAN.md');
21
22 function readRepoFile(relativePath) {
23 return fs.readFileSync(path.join(repoRoot, relativePath), 'utf8');
24 }
25
26 describe('SectionSource Phase 1D body-free transport plan', () => {
27 it('unit: plan covers the required transport decision areas', () => {
28 const plan = fs.readFileSync(planPath, 'utf8');
29 const requiredSections = [
30 '## Transport Decision',
31 '## Allowed Future Local CLI Shape',
32 '## Allowed Future Self-Hosted MCP Shape',
33 '## Hosted Transport Block',
34 '## Search And Persistence Block',
35 '## Scooling Boundary',
36 '## Seven-Tier Test Requirements',
37 '## Stop Conditions',
38 '## Acceptance Criteria',
39 ];
40
41 for (const section of requiredSections) {
42 assert.equal(plan.includes(section), true, `${section} is documented`);
43 }
44 assert.match(plan, /The local CLI and self-hosted MCP surfaces are now implemented/);
45 assert.match(plan, /This plan does not accept a hosted route, schema extension/);
46 });
47
48 it('integration: current SectionSource library output remains body-free after transport planning', () => {
49 const source = readSectionSource(fixtureVault, 'inbox/one.md');
50 const serialized = JSON.stringify(source);
51
52 assert.equal(source.sections.every((section) => section.body_returned === false), true);
53 assert.equal(source.sections.every((section) => section.snippet_returned === false), true);
54 assert.equal(Object.hasOwn(source, 'body'), false);
55 assert.equal(Object.hasOwn(source, 'snippet'), false);
56 assert.equal(Object.hasOwn(source, 'frontmatter'), false);
57 assert.equal(serialized.includes('Body of inbox one'), false);
58 assert.equal(serialized.includes('knowtation://'), false);
59 });
60
61 it('end-to-end: local CLI, self-hosted MCP, and hosted MCP are exposed while Hub remains blocked', () => {
62 const cliSource = readRepoFile('cli/index.mjs');
63 const selfHostedMcp = readRepoFile('mcp/create-server.mjs');
64 const hostedMcp = readRepoFile('hub/gateway/mcp-hosted-server.mjs');
65 const hostedAcl = readRepoFile('hub/gateway/mcp-tool-acl.mjs');
66 const hubServer = readRepoFile('hub/gateway/server.mjs');
67
68 assert.equal(cliSource.includes('get-section-source'), true);
69 assert.equal(cliSource.includes('readSectionSource'), true);
70 assert.equal(selfHostedMcp.includes('get_section_source'), true);
71 assert.equal(selfHostedMcp.includes('readSectionSource'), true);
72 assert.equal(hostedMcp.includes('get_section_source'), true);
73 assert.equal(hostedMcp.includes('buildSectionSource'), true);
74 assert.equal(hostedAcl.includes('get_section_source'), true);
75 assert.equal(hostedMcp.includes('readSectionSource'), false);
76 assert.equal(hubServer.includes('get_section_source'), false);
77 assert.equal(hubServer.includes('section_source/v0'), false);
78 });
79
80 it('stress: transport planning checks bounded files without scanning the vault', () => {
81 const started = Date.now();
82 const files = [
83 'docs/SECTION-SOURCE-TRANSPORT-PLAN.md',
84 'docs/SECTION-SOURCE-BODY-SNIPPET-POLICY.md',
85 'docs/SECTION-SOURCE-V0-SPEC.md',
86 'lib/section-source.mjs',
87 'lib/section-source-note.mjs',
88 ].map((relativePath) => readRepoFile(relativePath));
89 const elapsedMs = Date.now() - started;
90
91 assert.equal(files.length, 5);
92 assert.ok(elapsedMs < 200, `expected bounded plan check under 200ms, got ${elapsedMs}ms`);
93 });
94
95 it('data-integrity: transport planning adds no writes, sidecars, indexes, vectors, or summaries', () => {
96 const implementation = [
97 readRepoFile('lib/section-source.mjs'),
98 readRepoFile('lib/section-source-note.mjs'),
99 ].join('\n');
100
101 assert.doesNotMatch(implementation, /\bwriteFile(Sync)?\s*\(/);
102 assert.doesNotMatch(implementation, /\bappendFile(Sync)?\s*\(/);
103 assert.doesNotMatch(implementation, /\bsidecar[A-Za-z0-9_]*\s*=/);
104 assert.doesNotMatch(implementation, /\bvector[A-Za-z0-9_]*\s*=/);
105 assert.doesNotMatch(implementation, /\bsummary[A-Za-z0-9_]*\s*=/);
106 });
107
108 it('performance: plan keeps one-note transport bounded and provider-free', () => {
109 const plan = fs.readFileSync(planPath, 'utf8');
110
111 assert.match(plan, /One-note transport calls do not scan the whole vault/);
112 assert.match(plan, /No external provider calls occur/);
113 assert.match(plan, /Transport output size remains bounded by section count and text caps/);
114 });
115
116 it('security: plan blocks body, snippet, hosted, search, persistence, and Scooling exposure', () => {
117 const plan = fs.readFileSync(planPath, 'utf8');
118 const blockedPhrases = [
119 'No note body text in transport output.',
120 'No section body text in transport output.',
121 'No snippets in transport output.',
122 'Hosted MCP and Hub transport remain blocked.',
123 'Transport planning does not approve search or persistence.',
124 ];
125
126 for (const phrase of blockedPhrases) {
127 assert.equal(plan.includes(phrase), true, `${phrase} is documented`);
128 }
129 assert.match(plan, /Scooling remains blocked from live SectionSource runtime consumption until a separate\s+Scooling phase/);
130 });
131 });
File History 1 commit
sha256:8915fe406161f95c1681f9469375e7bae5b28c884f00bedbdef65e4b0cd0738d docs(flow): commit FLOW-V0-SPEC.md hygiene for 7A-INT merge Human 21 hours ago