@quolu/lattice 0.60.7 → 0.61.1

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 (62) hide show
  1. package/LICENSE +147 -147
  2. package/README.ja.md +374 -387
  3. package/README.md +291 -291
  4. package/bin/lattice-mcp.mjs +0 -0
  5. package/bin/lattice-scripted-adapter.mjs +0 -0
  6. package/bin/lattice-scripted-worker.mjs +0 -0
  7. package/bin/lattice-work-order-adapter.mjs +0 -0
  8. package/bin/lattice.mjs +0 -1
  9. package/docs/bridge-setup.md +248 -239
  10. package/docs/schemas/lattice.executor_packet.v1.schema.json +57 -57
  11. package/docs/schemas/lattice.executor_receipt.v1.schema.json +66 -66
  12. package/docs/schemas/lattice.phase_todo_revision.v3.schema.json +360 -360
  13. package/docs/schemas/lattice.plan_create_input.v1.schema.json +56 -56
  14. package/docs/schemas/lattice.plan_create_input.v2.schema.json +72 -72
  15. package/docs/schemas/lattice.plan_create_input.v3.schema.json +81 -81
  16. package/docs/schemas/lattice.plan_create_input.v4.schema.json +85 -85
  17. package/docs/schemas/lattice.plan_scope_review.v1.schema.json +55 -55
  18. package/docs/schemas/lattice.run_request.v1.schema.json +238 -238
  19. package/docs/schemas/lattice.runtime_adapter_capabilities.v2.schema.json +55 -55
  20. package/docs/schemas/lattice.runtime_adapter_registration_input.v1.schema.json +78 -78
  21. package/docs/schemas/lattice.runtime_adapter_registration_input.v2.schema.json +86 -86
  22. package/docs/schemas/lattice.todo_extraction.v2.schema.json +298 -298
  23. package/docs/schemas/lattice.todo_extraction.v3.schema.json +150 -150
  24. package/docs/schemas/lattice.todo_extraction.v4.schema.json +161 -161
  25. package/docs/schemas/lattice.todo_revision.v2.schema.json +260 -260
  26. package/docs/schemas/lattice.todo_revision_set.v3.schema.json +363 -363
  27. package/docs/schemas/lattice.todo_structure_binding.v1.schema.json +47 -47
  28. package/docs/schemas/lattice.todo_structure_realization.v1.schema.json +55 -55
  29. package/docs/schemas/lattice.todo_structure_set.v1.schema.json +264 -264
  30. package/package.json +109 -109
  31. package/sensor/LICENSE +21 -21
  32. package/sensor/NOTICE +19 -19
  33. package/sensor/dist/bin/lattice-sensor.js +9 -9
  34. package/sensor/dist/db/index.js +24 -24
  35. package/sensor/dist/db/migrations.js +41 -41
  36. package/sensor/dist/db/queries.js +164 -164
  37. package/sensor/dist/db/schema.sql +205 -205
  38. package/sensor/dist/directory.js +5 -5
  39. package/sensor/dist/extraction/wasm/tree-sitter-c_sharp.wasm +0 -0
  40. package/sensor/dist/extraction/wasm/tree-sitter-cfml.wasm +0 -0
  41. package/sensor/dist/extraction/wasm/tree-sitter-cfquery.wasm +0 -0
  42. package/sensor/dist/extraction/wasm/tree-sitter-cfscript.wasm +0 -0
  43. package/sensor/dist/extraction/wasm/tree-sitter-cobol.wasm +0 -0
  44. package/sensor/dist/extraction/wasm/tree-sitter-erlang.wasm +0 -0
  45. package/sensor/dist/extraction/wasm/tree-sitter-go.wasm +0 -0
  46. package/sensor/dist/extraction/wasm/tree-sitter-java.wasm +0 -0
  47. package/sensor/dist/extraction/wasm/tree-sitter-javascript.wasm +0 -0
  48. package/sensor/dist/extraction/wasm/tree-sitter-nix.wasm +0 -0
  49. package/sensor/dist/extraction/wasm/tree-sitter-pascal.wasm +0 -0
  50. package/sensor/dist/extraction/wasm/tree-sitter-python.wasm +0 -0
  51. package/sensor/dist/extraction/wasm/tree-sitter-tsx.wasm +0 -0
  52. package/sensor/dist/extraction/wasm/tree-sitter-typescript.wasm +0 -0
  53. package/sensor/dist/extraction/wasm/tree-sitter-vbnet.wasm +0 -0
  54. package/sensor/dist/mcp/liveness-watchdog.js +53 -53
  55. package/sensor/dist/mcp/server-instructions.js +95 -95
  56. package/sensor/package.json +56 -56
  57. package/src/cli-help.mjs +5 -4
  58. package/src/project-cli.mjs +2 -5
  59. package/src/runtime-pull-intake.mjs +37 -2
  60. package/src/runtime-windows-process.mjs +44 -0
  61. package/src/todo-cli.mjs +12 -105
  62. package/src/todo-dispatch-shape.mjs +9 -39
@@ -18,79 +18,79 @@ exports.SERVER_INSTRUCTIONS_NO_ROOT_INDEX = exports.SERVER_INSTRUCTIONS = void 0
18
18
  * burn tokens. ADR 0049 / 0059 require the eight compatibility tools to remain
19
19
  * visible by default; provider identity is Lattice regardless of their names.
20
20
  */
21
- exports.SERVER_INSTRUCTIONS = `# Lattice sensor — code intelligence over an indexed knowledge graph
22
-
23
- Provider identity: lattice. The lattice_sensor_* names below are compatibility tool names served by Lattice's own bundled sensor; they do not call or require the independent Lattice sensor product.
24
-
25
- Lattice sensor is a SQLite knowledge graph of every symbol, edge, and file in
26
- the workspace — pre-computed structure you would otherwise re-derive by
27
- reading files (cached intelligence: thousands of parse/trace decisions you
28
- don't pay to re-reason each run). Reads are sub-millisecond; the index lags
29
- writes by ~1s through the file watcher. Reach for it BEFORE *and* while
30
- writing or editing code — not just for questions: one call returns the
31
- verbatim source PLUS who calls it and what it affects, so you edit with the
32
- blast radius in view. More accurate context, in far fewer tokens and
33
- round-trips than reading files yourself.
34
-
35
- ## One tool: lattice_sensor_explore — use it instead of reading files
36
-
37
- There is a single tool, \`lattice_sensor_explore\`, and it is Read-equivalent. It
38
- takes either a natural-language question or a bag of symbol/file names and
39
- returns the **verbatim, line-numbered source** of the relevant symbols
40
- grouped by file — the same \`<n>\\t<line>\` shape \`Read\` gives you, safe to
41
- \`Edit\` from — PLUS the call path among them (including dynamic-dispatch hops
42
- like callbacks, React re-render, and JSX children that grep can't follow) and
43
- a blast-radius summary of what depends on them.
44
-
45
- Whether you're answering "how does X work" or implementing a change (fixing a
46
- bug, adding a feature), call \`lattice_sensor_explore\` before you Read. ONE call
47
- usually answers the whole question. Lattice sensor IS the pre-built search index —
48
- so running your own grep + read loop, or delegating the lookup to a separate
49
- file-reading sub-task/agent, repeats work lattice sensor already did and costs more
50
- for the same answer. A direct lattice sensor answer is typically one to a few
51
- calls; a grep/read exploration is dozens.
52
-
53
- ## How to query
54
-
55
- - **Almost any question — "how does X work", architecture, a bug, "what/where is X", or surveying an area** → \`lattice_sensor_explore\` with a natural-language question or the relevant names. ONE capped call returns the verbatim source grouped by file; most often the ONLY call you need.
56
- - **"How does X reach/become Y? / the flow / the path from X to Y"** → \`lattice_sensor_explore\`, naming the symbols that span the flow (e.g. \`mutateElement renderScene\`) — it surfaces the call path among them, riding dynamic-dispatch hops, and returns their source.
57
- - **Reading or editing a file/symbol you can name** → put its name or file path in the \`lattice_sensor_explore\` query — it returns that current line-numbered source (safe to \`Edit\` from) with the call path and blast radius attached, so you don't Read it separately. For an overloaded name it returns every matching definition's body in one call.
58
- - **Need more?** Call \`lattice_sensor_explore\` again with more specific names — treat the source it returns as already Read.
59
-
60
- ## Anti-patterns
61
-
62
- - **Trust lattice sensor's results — don't re-verify them with grep.** They come from a full AST parse; re-checking with grep is slower, less accurate, and wastes context.
63
- - **Don't grep or Read first** to find or understand indexed code — ONE \`lattice_sensor_explore\` returns the relevant symbols' source together in a single round-trip. Reach for raw \`Read\`/\`Grep\` only to confirm a specific detail lattice sensor didn't cover, or for what lattice sensor doesn't index (configs, docs).
64
- - **Don't reconstruct a flow by hand** — name the endpoints in one \`lattice_sensor_explore\` and it surfaces the path between them, dynamic-dispatch hops included.
65
- - **After editing, check the staleness banner.** When a tool response starts with "⚠️ Some files referenced below were edited since the last index sync…", the listed files are pending re-index — Read those specific files for accurate content. Every file NOT in that banner is fresh, so still trust lattice sensor. A different, rarer banner — "⚠️ LatticeSensor auto-sync is DISABLED…" — means live watching stopped entirely (the whole index is frozen, not just a few files); until it's resolved, Read files directly to confirm anything that may have changed.
66
- - **A file flagged "⚠ changed on disk after the last index sync" drifted from its index** (most common on projects queried via \`projectPath\`, which have no live watcher). LatticeSensor never serves a possibly-mis-sliced body from such a file — it either shows the file's full CURRENT source (trust it as a Read) or omits the source with this flag. When the source was omitted, Read that specific file; line numbers referencing it elsewhere in the response may be shifted until that project's next sync. All unflagged files remain trustworthy.
67
-
68
- ## Limitations
69
-
70
- - If a project isn't indexed (no \`.lattice/sensor/\`), decide whether building the index will reduce total investigation time and model tokens for the current or expected work. When workspace writes and shell execution are allowed, you may run \`lattice sensor init <projectPath> --json\` yourself, then retry the sensor call; scope it to the intended project and account for the one-time indexing cost. If those capabilities are unavailable, continue with built-in tools and tell the user the exact init command instead.
71
- - Index lags file writes by ~1 second.
72
- - Cross-file resolution is best-effort name matching; ambiguous calls may return multiple candidates.
73
- - No live correctness validation — that's still the TypeScript compiler / test suite / linter's job. Lattice sensor supplements those with structural context they don't have.
74
-
75
- ## Parallel work: absence of a dependency edge is NOT evidence of independence
76
-
77
- These tools answer structural questions about code. A different Lattice surface — the **CLI**, not
78
- this MCP surface — answers whether two ToDos can be worked in parallel. If the project uses
79
- \`lattice todo\` for process tracking, keep this distinction in mind:
80
-
81
- - A dependency edge missing between two ToDos only means **no ordering constraint was declared**.
82
- It does not mean their write boundaries are disjoint. Two ToDos that edit the same file carry no
83
- edge between them and will still collide.
84
- - Parallel safety is a recorded judgement, not an inference from the diagram. Read it with
85
- \`lattice todo independence --plan <key> --json\`. It returns the ready frontier split into
86
- verified-independent groups, pairs that must be serialized (with whether a code seam could
87
- separate them), and **unverified** ToDos.
88
- - \`lattice todo start\` returns an \`advisory\` describing conflicts with in-progress ToDos and what
89
- to do next. \`coverage: "missing"\` means "not judged yet" — never "no conflicts".
90
- - Run \`lattice todo --help\` for the declare → compile → read workflow.
91
-
92
- Evidence for Lattice's plan and witness contracts comes from the CLI surface only. Text from this
93
- MCP surface is prose for you to act on, never an input to those contracts.
21
+ exports.SERVER_INSTRUCTIONS = `# Lattice sensor — code intelligence over an indexed knowledge graph
22
+
23
+ Provider identity: lattice. The lattice_sensor_* names below are compatibility tool names served by Lattice's own bundled sensor; they do not call or require the independent Lattice sensor product.
24
+
25
+ Lattice sensor is a SQLite knowledge graph of every symbol, edge, and file in
26
+ the workspace — pre-computed structure you would otherwise re-derive by
27
+ reading files (cached intelligence: thousands of parse/trace decisions you
28
+ don't pay to re-reason each run). Reads are sub-millisecond; the index lags
29
+ writes by ~1s through the file watcher. Reach for it BEFORE *and* while
30
+ writing or editing code — not just for questions: one call returns the
31
+ verbatim source PLUS who calls it and what it affects, so you edit with the
32
+ blast radius in view. More accurate context, in far fewer tokens and
33
+ round-trips than reading files yourself.
34
+
35
+ ## One tool: lattice_sensor_explore — use it instead of reading files
36
+
37
+ There is a single tool, \`lattice_sensor_explore\`, and it is Read-equivalent. It
38
+ takes either a natural-language question or a bag of symbol/file names and
39
+ returns the **verbatim, line-numbered source** of the relevant symbols
40
+ grouped by file — the same \`<n>\\t<line>\` shape \`Read\` gives you, safe to
41
+ \`Edit\` from — PLUS the call path among them (including dynamic-dispatch hops
42
+ like callbacks, React re-render, and JSX children that grep can't follow) and
43
+ a blast-radius summary of what depends on them.
44
+
45
+ Whether you're answering "how does X work" or implementing a change (fixing a
46
+ bug, adding a feature), call \`lattice_sensor_explore\` before you Read. ONE call
47
+ usually answers the whole question. Lattice sensor IS the pre-built search index —
48
+ so running your own grep + read loop, or delegating the lookup to a separate
49
+ file-reading sub-task/agent, repeats work lattice sensor already did and costs more
50
+ for the same answer. A direct lattice sensor answer is typically one to a few
51
+ calls; a grep/read exploration is dozens.
52
+
53
+ ## How to query
54
+
55
+ - **Almost any question — "how does X work", architecture, a bug, "what/where is X", or surveying an area** → \`lattice_sensor_explore\` with a natural-language question or the relevant names. ONE capped call returns the verbatim source grouped by file; most often the ONLY call you need.
56
+ - **"How does X reach/become Y? / the flow / the path from X to Y"** → \`lattice_sensor_explore\`, naming the symbols that span the flow (e.g. \`mutateElement renderScene\`) — it surfaces the call path among them, riding dynamic-dispatch hops, and returns their source.
57
+ - **Reading or editing a file/symbol you can name** → put its name or file path in the \`lattice_sensor_explore\` query — it returns that current line-numbered source (safe to \`Edit\` from) with the call path and blast radius attached, so you don't Read it separately. For an overloaded name it returns every matching definition's body in one call.
58
+ - **Need more?** Call \`lattice_sensor_explore\` again with more specific names — treat the source it returns as already Read.
59
+
60
+ ## Anti-patterns
61
+
62
+ - **Trust lattice sensor's results — don't re-verify them with grep.** They come from a full AST parse; re-checking with grep is slower, less accurate, and wastes context.
63
+ - **Don't grep or Read first** to find or understand indexed code — ONE \`lattice_sensor_explore\` returns the relevant symbols' source together in a single round-trip. Reach for raw \`Read\`/\`Grep\` only to confirm a specific detail lattice sensor didn't cover, or for what lattice sensor doesn't index (configs, docs).
64
+ - **Don't reconstruct a flow by hand** — name the endpoints in one \`lattice_sensor_explore\` and it surfaces the path between them, dynamic-dispatch hops included.
65
+ - **After editing, check the staleness banner.** When a tool response starts with "⚠️ Some files referenced below were edited since the last index sync…", the listed files are pending re-index — Read those specific files for accurate content. Every file NOT in that banner is fresh, so still trust lattice sensor. A different, rarer banner — "⚠️ LatticeSensor auto-sync is DISABLED…" — means live watching stopped entirely (the whole index is frozen, not just a few files); until it's resolved, Read files directly to confirm anything that may have changed.
66
+ - **A file flagged "⚠ changed on disk after the last index sync" drifted from its index** (most common on projects queried via \`projectPath\`, which have no live watcher). LatticeSensor never serves a possibly-mis-sliced body from such a file — it either shows the file's full CURRENT source (trust it as a Read) or omits the source with this flag. When the source was omitted, Read that specific file; line numbers referencing it elsewhere in the response may be shifted until that project's next sync. All unflagged files remain trustworthy.
67
+
68
+ ## Limitations
69
+
70
+ - If a project isn't indexed (no \`.lattice/sensor/\`), decide whether building the index will reduce total investigation time and model tokens for the current or expected work. When workspace writes and shell execution are allowed, you may run \`lattice sensor init <projectPath> --json\` yourself, then retry the sensor call; scope it to the intended project and account for the one-time indexing cost. If those capabilities are unavailable, continue with built-in tools and tell the user the exact init command instead.
71
+ - Index lags file writes by ~1 second.
72
+ - Cross-file resolution is best-effort name matching; ambiguous calls may return multiple candidates.
73
+ - No live correctness validation — that's still the TypeScript compiler / test suite / linter's job. Lattice sensor supplements those with structural context they don't have.
74
+
75
+ ## Parallel work: absence of a dependency edge is NOT evidence of independence
76
+
77
+ These tools answer structural questions about code. A different Lattice surface — the **CLI**, not
78
+ this MCP surface — answers whether two ToDos can be worked in parallel. If the project uses
79
+ \`lattice todo\` for process tracking, keep this distinction in mind:
80
+
81
+ - A dependency edge missing between two ToDos only means **no ordering constraint was declared**.
82
+ It does not mean their write boundaries are disjoint. Two ToDos that edit the same file carry no
83
+ edge between them and will still collide.
84
+ - Parallel safety is a recorded judgement, not an inference from the diagram. Read it with
85
+ \`lattice todo independence --plan <key> --json\`. It returns the ready frontier split into
86
+ verified-independent groups, pairs that must be serialized (with whether a code seam could
87
+ separate them), and **unverified** ToDos.
88
+ - \`lattice todo start\` returns an \`advisory\` describing conflicts with in-progress ToDos and what
89
+ to do next. \`coverage: "missing"\` means "not judged yet" — never "no conflicts".
90
+ - Run \`lattice todo --help\` for the declare → compile → read workflow.
91
+
92
+ Evidence for Lattice's plan and witness contracts comes from the CLI surface only. Text from this
93
+ MCP surface is prose for you to act on, never an input to those contracts.
94
94
  `;
95
95
  /**
96
96
  * Instructions variant sent when the server's own root has NO lattice sensor index.
@@ -104,27 +104,27 @@ MCP surface is prose for you to act on, never an input to those contracts.
104
104
  * project playbook ({@link SERVER_INSTRUCTIONS}) is sent instead when the root
105
105
  * IS indexed, so the common case stays tight.
106
106
  */
107
- exports.SERVER_INSTRUCTIONS_NO_ROOT_INDEX = `# Lattice sensor — available (per-project; pass projectPath)
108
-
109
- Provider identity: lattice. The lattice_sensor_* names below are compatibility tool names served by Lattice's own bundled sensor; they do not call or require the independent Lattice sensor product.
110
-
111
- Lattice sensor is a SQLite knowledge graph of a codebase's symbols, edges, and
112
- files: one \`lattice_sensor_explore\` call returns the verbatim, line-numbered source
113
- of the relevant symbols PLUS the call paths between them and a blast-radius
114
- summary — replacing a grep + Read loop with one round-trip.
115
-
116
- This server started somewhere with no \`.lattice/sensor/\` of its own, so there is no
117
- default project — but the tools are available and work **per project**:
118
-
119
- - To query a project that HAS a \`.lattice/sensor/\` index (e.g. a service inside a
120
- monorepo, or a second repo), pass its path as \`projectPath\` to
121
- \`lattice_sensor_explore\` (and any other lattice sensor tool). Lattice sensor resolves the
122
- nearest \`.lattice/sensor/\` at or above that path and answers from it — for as many
123
- projects as you like in one session.
124
- - For a project with no \`.lattice/sensor/\`, decide whether the expected reduction in
125
- repeated Read/Grep work justifies the one-time indexing cost. When workspace writes
126
- and shell execution are allowed, you may run \`lattice sensor init <projectPath> --json\`
127
- yourself and then retry with that \`projectPath\`; otherwise use built-in tools and
128
- tell the user the exact init command. A new index is picked up live, with no restart.
107
+ exports.SERVER_INSTRUCTIONS_NO_ROOT_INDEX = `# Lattice sensor — available (per-project; pass projectPath)
108
+
109
+ Provider identity: lattice. The lattice_sensor_* names below are compatibility tool names served by Lattice's own bundled sensor; they do not call or require the independent Lattice sensor product.
110
+
111
+ Lattice sensor is a SQLite knowledge graph of a codebase's symbols, edges, and
112
+ files: one \`lattice_sensor_explore\` call returns the verbatim, line-numbered source
113
+ of the relevant symbols PLUS the call paths between them and a blast-radius
114
+ summary — replacing a grep + Read loop with one round-trip.
115
+
116
+ This server started somewhere with no \`.lattice/sensor/\` of its own, so there is no
117
+ default project — but the tools are available and work **per project**:
118
+
119
+ - To query a project that HAS a \`.lattice/sensor/\` index (e.g. a service inside a
120
+ monorepo, or a second repo), pass its path as \`projectPath\` to
121
+ \`lattice_sensor_explore\` (and any other lattice sensor tool). Lattice sensor resolves the
122
+ nearest \`.lattice/sensor/\` at or above that path and answers from it — for as many
123
+ projects as you like in one session.
124
+ - For a project with no \`.lattice/sensor/\`, decide whether the expected reduction in
125
+ repeated Read/Grep work justifies the one-time indexing cost. When workspace writes
126
+ and shell execution are allowed, you may run \`lattice sensor init <projectPath> --json\`
127
+ yourself and then retry with that \`projectPath\`; otherwise use built-in tools and
128
+ tell the user the exact init command. A new index is picked up live, with no restart.
129
129
  `;
130
130
  //# sourceMappingURL=server-instructions.js.map
@@ -1,56 +1,56 @@
1
- {
2
- "name": "@quolu/lattice-sensor",
3
- "version": "0.7.3-lattice.1",
4
- "private": true,
5
- "description": "Lattice-owned local structural sensor.",
6
- "repository": {
7
- "type": "git",
8
- "url": "git+https://github.com/kitepon/Lattice.git"
9
- },
10
- "main": "dist/index.js",
11
- "types": "dist/index.d.ts",
12
- "files": [
13
- "dist",
14
- "README.md"
15
- ],
16
- "scripts": {
17
- "build": "npm run clean && tsc && npm run copy-assets",
18
- "copy-assets": "node -e \"const fs=require('fs');fs.mkdirSync('dist/db',{recursive:true});fs.copyFileSync('src/db/schema.sql','dist/db/schema.sql');fs.mkdirSync('dist/extraction/wasm',{recursive:true});fs.readdirSync('src/extraction/wasm').filter(f=>f.endsWith('.wasm')).forEach(f=>fs.copyFileSync('src/extraction/wasm/'+f,'dist/extraction/wasm/'+f))\"",
19
- "dev": "tsc --watch",
20
- "build:kernel": "bash scripts/build-kernel.sh",
21
- "test": "vitest run --maxWorkers=4 --minWorkers=1",
22
- "test:watch": "vitest",
23
- "test:eval": "vitest run __tests__/evaluation/",
24
- "eval": "npm run build && npx tsx __tests__/evaluation/runner.ts",
25
- "clean": "node -e \"const fs=require('fs');fs.rmSync('dist',{recursive:true,force:true})\""
26
- },
27
- "keywords": [
28
- "code-intelligence",
29
- "knowledge-graph",
30
- "static-analysis"
31
- ],
32
- "author": "",
33
- "license": "MIT",
34
- "dependencies": {
35
- "@clack/prompts": "^1.3.0",
36
- "commander": "^14.0.2",
37
- "fast-string-width": "^3.0.2",
38
- "fast-wrap-ansi": "^0.2.0",
39
- "ignore": "^7.0.5",
40
- "jsonc-parser": "^3.3.1",
41
- "picomatch": "^4.0.4",
42
- "sisteransi": "^1.0.5",
43
- "tree-sitter-wasms": "^0.1.11",
44
- "web-tree-sitter": "^0.25.3"
45
- },
46
- "devDependencies": {
47
- "@types/better-sqlite3": "^7.6.0",
48
- "@types/node": "^20.19.30",
49
- "@types/picomatch": "^4.0.2",
50
- "typescript": "^5.0.0",
51
- "vitest": "^2.1.9"
52
- },
53
- "engines": {
54
- "node": ">=20.0.0 <25.0.0 || >=26.0.0"
55
- }
56
- }
1
+ {
2
+ "name": "@quolu/lattice-sensor",
3
+ "version": "0.7.3-lattice.1",
4
+ "private": true,
5
+ "description": "Lattice-owned local structural sensor.",
6
+ "repository": {
7
+ "type": "git",
8
+ "url": "git+https://github.com/kitepon/Lattice.git"
9
+ },
10
+ "main": "dist/index.js",
11
+ "types": "dist/index.d.ts",
12
+ "files": [
13
+ "dist",
14
+ "README.md"
15
+ ],
16
+ "scripts": {
17
+ "build": "npm run clean && tsc && npm run copy-assets",
18
+ "copy-assets": "node -e \"const fs=require('fs');fs.mkdirSync('dist/db',{recursive:true});fs.copyFileSync('src/db/schema.sql','dist/db/schema.sql');fs.mkdirSync('dist/extraction/wasm',{recursive:true});fs.readdirSync('src/extraction/wasm').filter(f=>f.endsWith('.wasm')).forEach(f=>fs.copyFileSync('src/extraction/wasm/'+f,'dist/extraction/wasm/'+f))\"",
19
+ "dev": "tsc --watch",
20
+ "build:kernel": "bash scripts/build-kernel.sh",
21
+ "test": "vitest run --maxWorkers=4 --minWorkers=1",
22
+ "test:watch": "vitest",
23
+ "test:eval": "vitest run __tests__/evaluation/",
24
+ "eval": "npm run build && npx tsx __tests__/evaluation/runner.ts",
25
+ "clean": "node -e \"const fs=require('fs');fs.rmSync('dist',{recursive:true,force:true})\""
26
+ },
27
+ "keywords": [
28
+ "code-intelligence",
29
+ "knowledge-graph",
30
+ "static-analysis"
31
+ ],
32
+ "author": "",
33
+ "license": "MIT",
34
+ "dependencies": {
35
+ "@clack/prompts": "^1.3.0",
36
+ "commander": "^14.0.2",
37
+ "fast-string-width": "^3.0.2",
38
+ "fast-wrap-ansi": "^0.2.0",
39
+ "ignore": "^7.0.5",
40
+ "jsonc-parser": "^3.3.1",
41
+ "picomatch": "^4.0.4",
42
+ "sisteransi": "^1.0.5",
43
+ "tree-sitter-wasms": "^0.1.11",
44
+ "web-tree-sitter": "^0.25.3"
45
+ },
46
+ "devDependencies": {
47
+ "@types/better-sqlite3": "^7.6.0",
48
+ "@types/node": "^20.19.30",
49
+ "@types/picomatch": "^4.0.2",
50
+ "typescript": "^5.0.0",
51
+ "vitest": "^2.1.9"
52
+ },
53
+ "engines": {
54
+ "node": ">=20.0.0 <25.0.0 || >=26.0.0"
55
+ }
56
+ }
package/src/cli-help.mjs CHANGED
@@ -25,8 +25,7 @@ const NAMESPACE_HELP = Object.freeze({
25
25
 
26
26
  Commands:
27
27
  create --input <file> [--serialization-reviewed]
28
- # 依存グラフがほぼ一直線(serialization_ratioが閾値超)なら一度突き返す。
29
- # 再考した上でなお直列でよいなら --serialization-reviewed を付けて再実行する
28
+ # 結果へdispatch_shapeを載せる。--serialization-reviewedは互換のため受理するだけで門ではない
30
29
  create --schema --json # 既定は最新版(v4)のJSON Schemaを返す
31
30
  create --schema-version <1|2|3|4> --json
32
31
  show <plan_key> --json # task・依存・phase・状態をplan本体から1コマンドで投影する
@@ -94,9 +93,10 @@ Write commands:
94
93
  migrate --input <extraction.json> [--serialization-reviewed] [--json]
95
94
  migrate --input <extraction.json> --dry-run --json [--serialization-reviewed]
96
95
  # 既存storeへplanを追加する(plan createは空store初期化専用)。
97
- # 依存グラフがほぼ一直線なら一度突き返し、再考後の --serialization-reviewed で通す
96
+ # 結果へdispatch_shapeを載せる。--serialization-reviewedは互換のため受理するだけで門ではない
98
97
  start --plan <key> --task <id> [--parallel-frontier|--override-reason <text> [--serial-confirmed]]
99
- # 既定は全ready同時dispatch。直列にするには理由の申告後、再考を経て --serial-confirmed が要る
98
+ # readyならflagなしで着手する。--parallel-frontierと--override-reasonは方針・理由の記録。
99
+ # --serial-confirmedは互換のため受理する。いずれも門ではない
100
100
  block --plan <key> --task <id> --reason <text>
101
101
  unblock --plan <key> --task <id>
102
102
  done --plan <key> --task <id> --evidence <file> # 構造対象taskはfresh realizationを要求する
@@ -152,6 +152,7 @@ ${TODO_INDEPENDENCE_WORKFLOW.join('\n')}
152
152
 
153
153
  判定していない工程は「競合が無い」ではなく「未検査」として扱われ、
154
154
  todo startのadvisoryとtodo independenceの投影が、その状況と次の一歩を返す。
155
+ 並列既定はstatusのdispatch_frontierとnext_actionが案内する。着手・作成を拒まない。
155
156
  `,
156
157
  sensor: `Usage: lattice sensor <init|sync> [path] --json
157
158
  lattice sensor diff <rootA> <rootB> [options] --json
@@ -37,7 +37,6 @@ import {
37
37
  TodoStoreError,
38
38
  } from './todo-store.mjs';
39
39
  import {
40
- assertTodoDispatchShapeReviewed,
41
40
  computeTodoDispatchShapeForPlan,
42
41
  } from './todo-dispatch-shape.mjs';
43
42
 
@@ -485,7 +484,7 @@ function validateCreateInput(value) {
485
484
  } catch { return false; }
486
485
  }
487
486
 
488
- export async function runPlanCreate({ cwd, inputRef, stdout, serializationReviewed = false }) {
487
+ export async function runPlanCreate({ cwd, inputRef, stdout }) {
489
488
  const repoRoot = resolveRepoRoot(cwd);
490
489
  if (repoRoot === null) throw new TodoStoreError('REPO_UNRESOLVED', 'git_toplevel_unresolved');
491
490
  const input = await readCanonicalInput(repoRoot, inputRef);
@@ -526,8 +525,7 @@ export async function runPlanCreate({ cwd, inputRef, stdout, serializationReview
526
525
  next_action: 'correct_the_reported_pointer_then_rerun_plan_create',
527
526
  });
528
527
  }
529
- // dispatch_shapeのgateはstore初期化より前に判定する(拒否時にstoreへ何も書かないため、
530
- // 再考後の再実行がplan_key_already_existsで詰まらない)。
528
+ // dispatch_shapeは結果へ載せる観測であり、直列度では初期化を拒まない(ADR 0180)。
531
529
  const dispatchShape = computeTodoDispatchShapeForPlan({
532
530
  projectId: input.project_id,
533
531
  planKey: input.plan_key,
@@ -535,7 +533,6 @@ export async function runPlanCreate({ cwd, inputRef, stdout, serializationReview
535
533
  hardDependencies: input.hard_dependencies,
536
534
  joins: input.joins,
537
535
  });
538
- assertTodoDispatchShapeReviewed({ shape: dispatchShape, reviewed: serializationReviewed });
539
536
  const store = await initializeAuthoredTodoStore({
540
537
  repoRoot, writer: createTodoStoreWriter({ caller: 'g5-authoring' }),
541
538
  projectId: input.project_id, repositories: [{ repo_id: 'self', path: '.' }],
@@ -13,6 +13,7 @@ import { classifyObservedDiff } from './runtime-decision-verifier.mjs';
13
13
  import { captureWorktreeDiff, detectCheckpointFindings } from './runtime-diff-observer.mjs';
14
14
  import { acquireRuntimeLifecycleLock } from './runtime-lifecycle-lock.mjs';
15
15
  import { observeManagedProcessStartIdentity } from './runtime-managed-supervisor.mjs';
16
+ import { observeWindowsWorkerProcess } from './runtime-windows-process.mjs';
16
17
  import { ensureScriptedWorktree } from './runtime-scripted-worktree.mjs';
17
18
  import {
18
19
  BOUNDARY_MANIFEST_SCHEMA, selfDigest, validateRuntimeBoundaryManifest, validateRuntimePlan,
@@ -890,6 +891,36 @@ export async function releasePullTask({ runDir, taskId, environment = process.en
890
891
 
891
892
  async function observeProcessBinding(pid) {
892
893
  if (!Number.isSafeInteger(pid) || pid < 1) fail('INVALID_WORKER_PID', 'pidが正整数でない');
894
+ if (process.platform === 'win32') {
895
+ let observed;
896
+ try {
897
+ observed = await observeWindowsWorkerProcess(pid);
898
+ } catch (error) {
899
+ fail('WORKER_IDENTITY_MISMATCH', `Windows worker process identityを完全観測できない: ${error.message}`);
900
+ }
901
+ const processStartIdentity = {
902
+ schema: 'lattice.process_start_identity.v1',
903
+ platform: 'win32',
904
+ pid: observed.pid,
905
+ started_identity: observed.started_identity,
906
+ identity_digest: '',
907
+ };
908
+ processStartIdentity.identity_digest = selfDigest(processStartIdentity, 'identity_digest');
909
+ const expected = {
910
+ pid: observed.pid,
911
+ process_group_id: observed.process_group_id,
912
+ process_start_identity: processStartIdentity,
913
+ };
914
+ if (!validateExpectedWorkerProcess(expected) || observed.argv.length === 0) {
915
+ fail('WORKER_IDENTITY_MISMATCH', 'worker process identityを完全観測できない');
916
+ }
917
+ return {
918
+ pid: observed.pid,
919
+ process_group_id: observed.process_group_id,
920
+ process_start_identity: processStartIdentity,
921
+ argv_digest: createHash('sha256').update(observed.argv, 'utf8').digest('hex'),
922
+ };
923
+ }
893
924
  const processStartIdentity = await observeManagedProcessStartIdentity(pid);
894
925
  const { stdout: pgidOut } = await execFileAsync('/bin/ps', ['-o', 'pgid=', '-p', String(pid)], { encoding: 'utf8' });
895
926
  const { stdout: argvOut } = await execFileAsync('/bin/ps', ['-o', 'command=', '-p', String(pid)], { encoding: 'utf8' });
@@ -1082,8 +1113,12 @@ function doneBinding(store, intake) {
1082
1113
  }
1083
1114
  const task = member.tasks.find((entry) => entry.task_id === intake.task_id);
1084
1115
  if (task?.status !== 'done') fail('TASK_NOT_DONE', `todo done前はacceptできない: ${intake.task_id}`);
1085
- const event = literalEvent(member, { kind: 'done', taskId: intake.task_id, actor: intake.actor });
1086
- if (event === null) fail('TASK_DONE_BINDING_UNSUPPORTED', 'same-version literal authored doneだけをacceptする');
1116
+ // accept intake actor に束縛する。done の記録者は別でよい(監査担当が閉じ、intake 席が accept)。
1117
+ const event = member.journal?.events?.findLast((entry) => (
1118
+ entry.kind === 'done' && entry.task_id === intake.task_id
1119
+ && entry.plan_version === member.plan.plan_version
1120
+ )) ?? null;
1121
+ if (event === null) fail('TASK_DONE_BINDING_UNSUPPORTED', 'same-version literal doneだけをacceptする');
1087
1122
  return event;
1088
1123
  }
1089
1124
 
@@ -0,0 +1,44 @@
1
+ import { execFile } from 'node:child_process';
2
+ import { promisify } from 'node:util';
3
+
4
+ const execFileAsync = promisify(execFile);
5
+
6
+ export function parseWindowsCreationDate(value) {
7
+ if (value instanceof Date) {
8
+ if (Number.isNaN(value.getTime())) throw new Error('Windows CreationDateを解釈できない');
9
+ return value.toISOString();
10
+ }
11
+ if (typeof value === 'number' && Number.isFinite(value)) {
12
+ const parsed = new Date(value);
13
+ if (Number.isNaN(parsed.getTime())) throw new Error('Windows CreationDateを解釈できない');
14
+ return parsed.toISOString();
15
+ }
16
+ const text = String(value ?? '').trim();
17
+ const microsoft = /^\/Date\((-?\d+)(?:[+-]\d+)?\)\/$/u.exec(text);
18
+ if (microsoft) return new Date(Number(microsoft[1])).toISOString();
19
+ const parsed = new Date(text);
20
+ if (Number.isNaN(parsed.getTime())) throw new Error(`Windows CreationDateを解釈できない: ${text}`);
21
+ return parsed.toISOString();
22
+ }
23
+
24
+ export async function observeWindowsWorkerProcess(pid) {
25
+ if (!Number.isSafeInteger(pid) || pid < 1) {
26
+ throw new Error('pidが正整数でない');
27
+ }
28
+ const filter = JSON.stringify(`ProcessId=${pid}`);
29
+ const script = `Get-CimInstance Win32_Process -Filter ${filter} | Select-Object ProcessId,CommandLine,CreationDate | ConvertTo-Json -Compress`;
30
+ const { stdout } = await execFileAsync('powershell.exe', ['-NoProfile', '-Command', script], {
31
+ encoding: 'utf8',
32
+ });
33
+ const row = JSON.parse(stdout.trim() || 'null');
34
+ if (!row || Number(row.ProcessId) !== pid) throw new Error(`Win32_Processを観測できない: ${pid}`);
35
+ const argv = String(row.CommandLine || '').trim();
36
+ const startedIdentity = parseWindowsCreationDate(row.CreationDate);
37
+ if (!argv || !startedIdentity) throw new Error('Windows worker process identityを完全観測できない');
38
+ return {
39
+ pid,
40
+ process_group_id: pid,
41
+ started_identity: startedIdentity,
42
+ argv,
43
+ };
44
+ }