- CHANGELOG.md:v2.8.0 条目(中英双语); - README.md:版本行 2.7.1→2.8.0 + 愿景第 6 条(知识可证明); - doc/releases/v2.8.0.md:双语发版说明(亮点/用法/已知限制); - skills/marqdo-dev/index.mq.md:新增 prove 任务(路径/目录模式/ require_lean/json;参数用 + 行声明升参,check 与 narrative-ratio 通过); - 设计文档 §12.5 标记已合入;发版链接统一指向 doc/releases/v2.8.0.md。
56 lines
1.8 KiB
C
Executable File
56 lines
1.8 KiB
C
Executable File
/* Marqdo plugin ABI v2 — C contract (source of truth).
|
|
*
|
|
* Plugins are optional shared libraries (.dll / .so / .dylib), never linked
|
|
* into the marqdo binary. Values cross the boundary as UTF-8 JSON.
|
|
*
|
|
* v1: register_fn, alloc, free
|
|
* v2: + host_query (allowlisted host introspection for plugins)
|
|
*/
|
|
#ifndef MARQDO_ABI_H
|
|
#define MARQDO_ABI_H
|
|
|
|
#include <stddef.h>
|
|
#include <stdint.h>
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
#define MARQDO_ABI_VERSION 2u
|
|
#define MARQDO_ABI_VERSION_MIN 1u
|
|
|
|
/* Plugin function: args_json is a UTF-8 JSON object whose keys are param names.
|
|
* On success: return 0, set *out_json to a heap string (host frees via free).
|
|
* On failure: return non-zero; optional *err_msg heap string (host frees).
|
|
* out_json / err_msg may be left NULL.
|
|
*/
|
|
typedef int (*MarqdoPluginFn)(const char *args_json, char **out_json, char **err_msg);
|
|
|
|
/* Host → plugin query (v2). `name` is an allowlisted query id.
|
|
* Same success/failure convention as MarqdoPluginFn.
|
|
*/
|
|
typedef int (*MarqdoHostQueryFn)(void *userdata, const char *name, const char *args_json,
|
|
char **out_json, char **err_msg);
|
|
|
|
typedef struct MarqdoHostApi {
|
|
void *userdata;
|
|
/* params: comma-separated param names in order, e.g. "a,b". May be "". */
|
|
int (*register_fn)(void *userdata, const char *name, const char *params,
|
|
MarqdoPluginFn fn);
|
|
void *(*alloc)(size_t n);
|
|
void (*free)(void *p);
|
|
/* v2: NULL for hosts that only speak v1; required when plugin abi >= 2 */
|
|
MarqdoHostQueryFn host_query;
|
|
} MarqdoHostApi;
|
|
|
|
/* Required exports from every plugin shared library. */
|
|
uint32_t marqdo_plugin_abi_version(void);
|
|
int marqdo_plugin_init(const MarqdoHostApi *host);
|
|
void marqdo_plugin_shutdown(void);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* MARQDO_ABI_H */
|