@mrc2204/agent-smart-memo 5.1.0 → 5.1.3

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 (73) hide show
  1. package/README.md +209 -375
  2. package/bin/asm.mjs +365 -0
  3. package/bin/opencode-mcp-server.mjs +320 -0
  4. package/dist/cli/platform-installers.d.ts +62 -0
  5. package/dist/cli/platform-installers.d.ts.map +1 -0
  6. package/dist/cli/platform-installers.js +342 -0
  7. package/dist/cli/platform-installers.js.map +1 -0
  8. package/dist/core/contracts/adapter-contracts.d.ts +1 -1
  9. package/dist/core/contracts/adapter-contracts.d.ts.map +1 -1
  10. package/dist/core/contracts/change-overlay-contracts.d.ts +69 -0
  11. package/dist/core/contracts/change-overlay-contracts.d.ts.map +1 -0
  12. package/dist/core/contracts/change-overlay-contracts.js +2 -0
  13. package/dist/core/contracts/change-overlay-contracts.js.map +1 -0
  14. package/dist/core/contracts/feature-pack-contracts.d.ts +37 -0
  15. package/dist/core/contracts/feature-pack-contracts.d.ts.map +1 -0
  16. package/dist/core/contracts/feature-pack-contracts.js +8 -0
  17. package/dist/core/contracts/feature-pack-contracts.js.map +1 -0
  18. package/dist/core/contracts/project-query-contracts.d.ts +157 -0
  19. package/dist/core/contracts/project-query-contracts.d.ts.map +1 -0
  20. package/dist/core/contracts/project-query-contracts.js +2 -0
  21. package/dist/core/contracts/project-query-contracts.js.map +1 -0
  22. package/dist/core/graph/code-graph-model.d.ts +9 -0
  23. package/dist/core/graph/code-graph-model.d.ts.map +1 -0
  24. package/dist/core/graph/code-graph-model.js +70 -0
  25. package/dist/core/graph/code-graph-model.js.map +1 -0
  26. package/dist/core/graph/code-graph-populator.d.ts +20 -0
  27. package/dist/core/graph/code-graph-populator.d.ts.map +1 -0
  28. package/dist/core/graph/code-graph-populator.js +760 -0
  29. package/dist/core/graph/code-graph-populator.js.map +1 -0
  30. package/dist/core/graph/contracts.d.ts +29 -0
  31. package/dist/core/graph/contracts.d.ts.map +1 -0
  32. package/dist/core/graph/contracts.js +47 -0
  33. package/dist/core/graph/contracts.js.map +1 -0
  34. package/dist/core/ingest/contracts.d.ts +1 -1
  35. package/dist/core/ingest/contracts.d.ts.map +1 -1
  36. package/dist/core/ingest/ingest-pipeline.js +1 -1
  37. package/dist/core/ingest/ingest-pipeline.js.map +1 -1
  38. package/dist/core/ingest/semantic-block-extractor.d.ts.map +1 -1
  39. package/dist/core/ingest/semantic-block-extractor.js +36 -0
  40. package/dist/core/ingest/semantic-block-extractor.js.map +1 -1
  41. package/dist/core/usecases/default-memory-usecase-port.d.ts +38 -0
  42. package/dist/core/usecases/default-memory-usecase-port.d.ts.map +1 -1
  43. package/dist/core/usecases/default-memory-usecase-port.js +1675 -19
  44. package/dist/core/usecases/default-memory-usecase-port.js.map +1 -1
  45. package/dist/db/graph-db.d.ts +24 -0
  46. package/dist/db/graph-db.d.ts.map +1 -1
  47. package/dist/db/graph-db.js +81 -2
  48. package/dist/db/graph-db.js.map +1 -1
  49. package/dist/db/slot-db.d.ts +227 -1
  50. package/dist/db/slot-db.d.ts.map +1 -1
  51. package/dist/db/slot-db.js +700 -13
  52. package/dist/db/slot-db.js.map +1 -1
  53. package/dist/index.d.ts +7 -247
  54. package/dist/index.d.ts.map +1 -1
  55. package/dist/index.js +32 -119
  56. package/dist/index.js.map +1 -1
  57. package/dist/shared/asm-config.d.ts +82 -0
  58. package/dist/shared/asm-config.d.ts.map +1 -0
  59. package/dist/shared/asm-config.js +254 -0
  60. package/dist/shared/asm-config.js.map +1 -0
  61. package/dist/shared/slotdb-path.d.ts +4 -3
  62. package/dist/shared/slotdb-path.d.ts.map +1 -1
  63. package/dist/shared/slotdb-path.js +15 -6
  64. package/dist/shared/slotdb-path.js.map +1 -1
  65. package/dist/tools/graph-tools.d.ts.map +1 -1
  66. package/dist/tools/graph-tools.js +131 -0
  67. package/dist/tools/graph-tools.js.map +1 -1
  68. package/dist/tools/project-tools.d.ts.map +1 -1
  69. package/dist/tools/project-tools.js +561 -1
  70. package/dist/tools/project-tools.js.map +1 -1
  71. package/openclaw.plugin.json +5 -164
  72. package/package.json +61 -26
  73. package/scripts/init-openclaw.mjs +727 -0
@@ -0,0 +1,157 @@
1
+ import type { FeaturePackKey, FeaturePackV1 } from "./feature-pack-contracts.js";
2
+ export type ProjectDeveloperQueryCanonicalIntent = "locate_symbol" | "locate_file" | "feature_lookup" | "change_lookup";
3
+ export type ProjectDeveloperQueryLegacyIntent = "locate" | "trace_flow" | "impact" | "impact_analysis" | "change_aware_lookup" | "feature_understanding";
4
+ export type ProjectDeveloperQueryIntent = ProjectDeveloperQueryCanonicalIntent | ProjectDeveloperQueryLegacyIntent;
5
+ export interface ProjectDeveloperQueryPayload {
6
+ project_id?: string;
7
+ project_alias?: string;
8
+ query?: string;
9
+ intent?: ProjectDeveloperQueryIntent;
10
+ limit?: number;
11
+ feature_key?: FeaturePackKey;
12
+ feature_name?: string;
13
+ symbol_name?: string;
14
+ relative_path?: string;
15
+ route_path?: string;
16
+ tracker_issue_key?: string;
17
+ task_id?: string;
18
+ task_title?: string;
19
+ tracker_issue_keys?: string[];
20
+ task_ids?: string[];
21
+ route_paths?: string[];
22
+ }
23
+ export interface ProjectDeveloperQueryPrimaryResult {
24
+ type: "file" | "symbol" | "chunk" | "task" | "feature_pack";
25
+ id: string;
26
+ title: string;
27
+ score?: number;
28
+ relative_path?: string;
29
+ symbol_name?: string;
30
+ snippet?: string;
31
+ }
32
+ export interface ProjectDeveloperQueryResponseV1 {
33
+ query_id: string;
34
+ intent: ProjectDeveloperQueryIntent;
35
+ project_id: string;
36
+ project_alias: string | null;
37
+ query: string;
38
+ primary_results: ProjectDeveloperQueryPrimaryResult[];
39
+ files: string[];
40
+ symbols: string[];
41
+ snippets: string[];
42
+ graph_paths: string[];
43
+ feature_packs: FeaturePackV1[];
44
+ change_context: string[];
45
+ assembly_sources: Array<"file" | "symbol" | "feature_pack" | "change_overlay">;
46
+ answer_template: "locate" | "feature_understanding" | "generic";
47
+ answer_summary: string;
48
+ answer_points: string[];
49
+ explainability: {
50
+ ranking_rules: string[];
51
+ top_n: {
52
+ primary_results: number;
53
+ files: number;
54
+ symbols: number;
55
+ snippets: number;
56
+ graph_paths: number;
57
+ change_context: number;
58
+ answer_points: number;
59
+ };
60
+ evidence_counts: {
61
+ locate_hits: number;
62
+ feature_pack_hits: number;
63
+ overlay_changed_files: number;
64
+ overlay_related_symbols: number;
65
+ };
66
+ dedup: {
67
+ primary_results: boolean;
68
+ files: boolean;
69
+ symbols: boolean;
70
+ snippets: boolean;
71
+ graph_paths: boolean;
72
+ change_context: boolean;
73
+ };
74
+ fallbacks: string[];
75
+ };
76
+ confidence: {
77
+ overall: number;
78
+ reason: string;
79
+ };
80
+ why_this_result: string[];
81
+ generated_at: string;
82
+ generator_version: "asm-109-slice8";
83
+ }
84
+ export type ProjectWorkstreamType = "research_execution" | "coding_execution" | "review_execution";
85
+ export interface ProjectRoutingContractPayload {
86
+ project_id?: string;
87
+ project_alias?: string;
88
+ query?: string;
89
+ objective?: string;
90
+ workstream_type?: ProjectWorkstreamType;
91
+ }
92
+ export interface ProjectRoutingContractV1 {
93
+ routing_contract_version: "asm-routing-v1";
94
+ workstream_type: ProjectWorkstreamType;
95
+ project_id: string;
96
+ project_alias: string | null;
97
+ route_target: {
98
+ lane: "opencode";
99
+ mode: "foundation";
100
+ reason: string;
101
+ };
102
+ retrieval_profile: {
103
+ project_aware: true;
104
+ code_aware: true;
105
+ primary_usecase: "project.developer_query";
106
+ };
107
+ generated_at: string;
108
+ }
109
+ export interface ProjectCodingPacketPayload {
110
+ project_id?: string;
111
+ project_alias?: string;
112
+ query?: string;
113
+ objective?: string;
114
+ task_id?: string;
115
+ tracker_issue_key?: string;
116
+ task_title?: string;
117
+ symbol_name?: string;
118
+ relative_path?: string;
119
+ route_path?: string;
120
+ limit?: number;
121
+ acceptance_criteria?: string[];
122
+ constraints?: string[];
123
+ out_of_scope?: string[];
124
+ validation_commands?: string[];
125
+ }
126
+ export interface ProjectCodingPacketV1 {
127
+ packet_version: "asm-coding-packet-v1";
128
+ routing: ProjectRoutingContractV1;
129
+ objective: string;
130
+ project: {
131
+ project_id: string;
132
+ project_alias: string | null;
133
+ };
134
+ selectors: {
135
+ task_id?: string;
136
+ tracker_issue_key?: string;
137
+ task_title?: string;
138
+ symbol_name?: string;
139
+ relative_path?: string;
140
+ route_path?: string;
141
+ };
142
+ context: {
143
+ developer_query: ProjectDeveloperQueryResponseV1;
144
+ primary_files: string[];
145
+ primary_symbols: string[];
146
+ change_context: string[];
147
+ };
148
+ execution_hints: {
149
+ acceptance_criteria: string[];
150
+ constraints: string[];
151
+ out_of_scope: string[];
152
+ validation_commands: string[];
153
+ handoff_language: "vi";
154
+ };
155
+ generated_at: string;
156
+ }
157
+ //# sourceMappingURL=project-query-contracts.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"project-query-contracts.d.ts","sourceRoot":"","sources":["../../../src/core/contracts/project-query-contracts.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=project-query-contracts.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"project-query-contracts.js","sourceRoot":"","sources":["../../../src/core/contracts/project-query-contracts.ts"],"names":[],"mappings":""}
@@ -0,0 +1,9 @@
1
+ import type { GraphDB } from "../../db/graph-db.js";
2
+ import { type UniversalGraphNodeInput, type UniversalGraphRelationInput } from "./contracts.js";
3
+ export declare function upsertUniversalGraphNode(graph: GraphDB, scopeUserId: string, scopeAgentId: string, input: UniversalGraphNodeInput): import("../../db/graph-db.js").Entity | null;
4
+ export declare function upsertUniversalGraphRelation(graph: GraphDB, scopeUserId: string, scopeAgentId: string, input: UniversalGraphRelationInput): import("../../db/graph-db.js").Relationship;
5
+ export declare function readUniversalGraphChain(graph: GraphDB, scopeUserId: string, scopeAgentId: string, startNodeId: string, depth?: number): {
6
+ entities: import("../../db/graph-db.js").Entity[];
7
+ relationships: import("../../db/graph-db.js").Relationship[];
8
+ };
9
+ //# sourceMappingURL=code-graph-model.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"code-graph-model.d.ts","sourceRoot":"","sources":["../../../src/core/graph/code-graph-model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAEL,KAAK,uBAAuB,EAC5B,KAAK,2BAA2B,EAEjC,MAAM,gBAAgB,CAAC;AA8BxB,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,OAAO,EACd,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,uBAAuB,gDAuB/B;AAED,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,OAAO,EACd,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,2BAA2B,+CAoBnC;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,OAAO,EACd,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,KAAK,GAAE,MAAU;;;EAGlB"}
@@ -0,0 +1,70 @@
1
+ import { UNIVERSAL_GRAPH_MODEL_VERSION, } from "./contracts.js";
2
+ function normalizeConfidence(input) {
3
+ if (!Number.isFinite(input))
4
+ return 0;
5
+ if (input < 0)
6
+ return 0;
7
+ if (input > 1)
8
+ return 1;
9
+ return Number(input.toFixed(6));
10
+ }
11
+ function normalizeProvenance(provenance) {
12
+ const normalized = {
13
+ adapter_kind: String(provenance.adapter_kind || "unknown"),
14
+ confidence: normalizeConfidence(provenance.confidence),
15
+ };
16
+ if (typeof provenance.evidence_path === "string" && provenance.evidence_path.trim()) {
17
+ normalized.evidence_path = provenance.evidence_path.trim();
18
+ }
19
+ if (typeof provenance.evidence_start_line === "number" && Number.isFinite(provenance.evidence_start_line)) {
20
+ normalized.evidence_start_line = Math.max(1, Math.floor(provenance.evidence_start_line));
21
+ }
22
+ if (typeof provenance.evidence_end_line === "number" && Number.isFinite(provenance.evidence_end_line)) {
23
+ normalized.evidence_end_line = Math.max(1, Math.floor(provenance.evidence_end_line));
24
+ }
25
+ return normalized;
26
+ }
27
+ export function upsertUniversalGraphNode(graph, scopeUserId, scopeAgentId, input) {
28
+ const existing = graph.getEntity(scopeUserId, scopeAgentId, input.node_id);
29
+ const mergedProperties = {
30
+ ...(existing?.properties || {}),
31
+ ...(input.properties || {}),
32
+ graph_model: UNIVERSAL_GRAPH_MODEL_VERSION,
33
+ };
34
+ if (existing) {
35
+ return graph.updateEntity(scopeUserId, scopeAgentId, input.node_id, {
36
+ name: input.name,
37
+ type: input.node_type,
38
+ properties: mergedProperties,
39
+ });
40
+ }
41
+ return graph.createEntityWithId(scopeUserId, scopeAgentId, {
42
+ id: input.node_id,
43
+ name: input.name,
44
+ type: input.node_type,
45
+ properties: mergedProperties,
46
+ });
47
+ }
48
+ export function upsertUniversalGraphRelation(graph, scopeUserId, scopeAgentId, input) {
49
+ const provenance = normalizeProvenance(input.provenance);
50
+ const properties = {
51
+ ...(input.properties || {}),
52
+ graph_model: UNIVERSAL_GRAPH_MODEL_VERSION,
53
+ adapter_kind: provenance.adapter_kind,
54
+ confidence: provenance.confidence,
55
+ evidence_path: provenance.evidence_path,
56
+ evidence_start_line: provenance.evidence_start_line,
57
+ evidence_end_line: provenance.evidence_end_line,
58
+ };
59
+ return graph.createRelationship(scopeUserId, scopeAgentId, {
60
+ source_entity_id: input.source_node_id,
61
+ target_entity_id: input.target_node_id,
62
+ relation_type: input.relation_type,
63
+ weight: provenance.confidence,
64
+ properties,
65
+ });
66
+ }
67
+ export function readUniversalGraphChain(graph, scopeUserId, scopeAgentId, startNodeId, depth = 2) {
68
+ return graph.traverseGraph(scopeUserId, scopeAgentId, startNodeId, depth);
69
+ }
70
+ //# sourceMappingURL=code-graph-model.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"code-graph-model.js","sourceRoot":"","sources":["../../../src/core/graph/code-graph-model.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,20 @@
1
+ import type { GraphDB } from "../../db/graph-db.js";
2
+ import type { SemanticBlock } from "../ingest/contracts.js";
3
+ export interface PopulateCodeGraphFileInput {
4
+ projectId: string;
5
+ relativePath: string;
6
+ module?: string | null;
7
+ language?: string | null;
8
+ content: string;
9
+ blocks?: SemanticBlock[];
10
+ }
11
+ export interface PopulateCodeGraphFileResult {
12
+ nodes_upserted: number;
13
+ relations_upserted: number;
14
+ relation_type_counts: Record<string, number>;
15
+ }
16
+ export declare function buildCodeGraphFileNodeId(projectId: string, relativePath: string): string;
17
+ export declare function buildCodeGraphModuleNodeId(projectId: string, moduleName: string): string;
18
+ export declare function buildCodeGraphSymbolNodeId(projectId: string, relativePath: string, semanticPath: string): string;
19
+ export declare function populateUniversalCodeGraphForFile(graph: GraphDB, scopeUserId: string, scopeAgentId: string, input: PopulateCodeGraphFileInput): PopulateCodeGraphFileResult;
20
+ //# sourceMappingURL=code-graph-populator.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"code-graph-populator.d.ts","sourceRoot":"","sources":["../../../src/core/graph/code-graph-populator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAS5D,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,2BAA2B;IAC1C,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9C;AAkBD,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAExF;AAED,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAExF;AAED,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAEhH;AA2SD,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,OAAO,EACd,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,0BAA0B,GAChC,2BAA2B,CAwf7B"}