@haneinfo/settings 0.0.0-stage → 0.1.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.
@@ -0,0 +1 @@
1
+ {"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"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"}
package/dist/store.js ADDED
@@ -0,0 +1,149 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.PrismaSettingsStore = exports.SETTINGS_CLOCK = exports.SETTINGS_CONFIG = exports.SETTINGS_STORE = void 0;
4
+ exports.SETTINGS_STORE = Symbol.for('haneinfo.settings.store');
5
+ exports.SETTINGS_CONFIG = Symbol.for('haneinfo.settings.config');
6
+ /** Optional clock for cache expiry and decision times; defaults to the system clock. */
7
+ exports.SETTINGS_CLOCK = Symbol.for('haneinfo.settings.clock');
8
+ function change(row) {
9
+ return {
10
+ id: row.id,
11
+ code: row.code,
12
+ before: (row.before ?? null),
13
+ after: (row.after ?? null),
14
+ actorId: row.actorId,
15
+ reason: row.reason ?? null,
16
+ source: row.source,
17
+ at: row.at,
18
+ };
19
+ }
20
+ function proposal(row) {
21
+ return {
22
+ id: row.id,
23
+ code: row.code,
24
+ value: row.value,
25
+ reason: row.reason ?? null,
26
+ proposedBy: row.proposedBy,
27
+ status: row.status,
28
+ decidedBy: row.decidedBy ?? null,
29
+ decidedAt: row.decidedAt ?? null,
30
+ createdAt: row.createdAt,
31
+ };
32
+ }
33
+ /** JSON null is never a setting value; an absent before/after is stored as SQL NULL. */
34
+ function json(field, value) {
35
+ return value === null ? {} : { [field]: value };
36
+ }
37
+ class PrismaSettingsStoreTx {
38
+ constructor(client) {
39
+ this.client = client;
40
+ }
41
+ async lock(code) {
42
+ await this.client.$queryRawUnsafe("SELECT 1 AS locked FROM (SELECT pg_advisory_xact_lock(hashtext('haneinfo.settings:' || $1))) l", code);
43
+ }
44
+ getSetting(code) {
45
+ return this.client.setting.findUnique({ where: { code } });
46
+ }
47
+ async saveSetting(code, value, revision, actorId) {
48
+ return revision === 1
49
+ ? this.client.setting.create({ data: { code, value, revision, updatedBy: actorId } })
50
+ : this.client.setting.update({
51
+ where: { code },
52
+ data: { value, revision, updatedBy: actorId },
53
+ });
54
+ }
55
+ async deleteSetting(code) {
56
+ await this.client.setting.deleteMany({ where: { code } });
57
+ }
58
+ async appendChange(input) {
59
+ await this.client.settingChange.create({
60
+ data: {
61
+ code: input.code,
62
+ ...json('before', input.before),
63
+ ...json('after', input.after),
64
+ actorId: input.actorId,
65
+ reason: input.reason,
66
+ source: input.source,
67
+ },
68
+ });
69
+ }
70
+ async pruneHistory(code, keep) {
71
+ const stale = await this.client.settingChange.findMany({
72
+ where: { code },
73
+ orderBy: [{ at: 'desc' }, { id: 'desc' }],
74
+ skip: keep,
75
+ select: { id: true },
76
+ });
77
+ if (stale.length)
78
+ await this.client.settingChange.deleteMany({
79
+ where: { id: { in: stale.map((row) => row.id) } },
80
+ });
81
+ }
82
+ async getProposal(id) {
83
+ const row = await this.client.settingProposal.findUnique({ where: { id } });
84
+ return row ? proposal(row) : null;
85
+ }
86
+ async supersedePending(code, at) {
87
+ await this.client.settingProposal.updateMany({
88
+ where: { code, status: 'PENDING' },
89
+ data: { status: 'REJECTED', decidedAt: at },
90
+ });
91
+ }
92
+ async createProposal(input) {
93
+ return proposal(await this.client.settingProposal.create({ data: input }));
94
+ }
95
+ async decideProposal(id, status, decidedBy, at) {
96
+ return proposal(await this.client.settingProposal.update({
97
+ where: { id },
98
+ data: { status, decidedBy, decidedAt: at },
99
+ }));
100
+ }
101
+ }
102
+ class PrismaSettingsStore {
103
+ constructor(prisma) {
104
+ this.db = prisma;
105
+ }
106
+ get(code) {
107
+ return this.db.setting.findUnique({ where: { code } });
108
+ }
109
+ list() {
110
+ return this.db.setting.findMany({ orderBy: [{ code: 'asc' }] });
111
+ }
112
+ async history(code, offset, limit) {
113
+ const [rows, total] = await Promise.all([
114
+ this.db.settingChange.findMany({
115
+ where: { code },
116
+ orderBy: [{ at: 'desc' }, { id: 'desc' }],
117
+ skip: offset,
118
+ take: limit,
119
+ }),
120
+ this.db.settingChange.count({ where: { code } }),
121
+ ]);
122
+ return { items: rows.map(change), total };
123
+ }
124
+ async proposals(status, offset, limit) {
125
+ const where = status ? { status } : {};
126
+ const [rows, total] = await Promise.all([
127
+ this.db.settingProposal.findMany({
128
+ where,
129
+ orderBy: [{ createdAt: 'desc' }, { id: 'desc' }],
130
+ skip: offset,
131
+ take: limit,
132
+ }),
133
+ this.db.settingProposal.count({ where }),
134
+ ]);
135
+ return { items: rows.map(proposal), total };
136
+ }
137
+ async getProposal(id) {
138
+ const row = await this.db.settingProposal.findUnique({ where: { id } });
139
+ return row ? proposal(row) : null;
140
+ }
141
+ transaction(work) {
142
+ return this.db.$transaction((client) => work(new PrismaSettingsStoreTx(client)), {
143
+ timeout: 15_000,
144
+ maxWait: 10_000,
145
+ });
146
+ }
147
+ }
148
+ exports.PrismaSettingsStore = PrismaSettingsStore;
149
+ //# sourceMappingURL=store.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"store.js","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,55 @@
1
+ {
2
+ "schemaVersion": "haneinfo.plugin/v1",
3
+ "id": "settings",
4
+ "displayName": "Settings and feature flags",
5
+ "cardinality": "singleton",
6
+ "distribution": "official",
7
+ "engine": {
8
+ "haneinfoPluginApi": "^1.22.0",
9
+ "node": ">=22.0.0",
10
+ "frameworks": {
11
+ "@nestjs/common": "^11.0.5",
12
+ "@nestjs/core": "^11.0.5",
13
+ "@prisma/client": "^6.2.0"
14
+ }
15
+ },
16
+ "provides": ["haneinfo.settings"],
17
+ "requires": ["haneinfo.prisma", "haneinfo.principal-context"],
18
+ "optionalRequires": ["haneinfo.rbac-policy", "haneinfo.domain-events"],
19
+ "configSchema": {
20
+ "configRef": "settings"
21
+ },
22
+ "facets": {
23
+ "backend": {
24
+ "modulePath": "./dist/module.js",
25
+ "exportName": "SettingsModule",
26
+ "controllerRoutes": ["settings"],
27
+ "providerTokens": ["haneinfo.settings"],
28
+ "mcpTools": [
29
+ {
30
+ "name": "list_settings",
31
+ "requiredScopes": ["{namespace}:settings:read"],
32
+ "description": "Read-only list of declared settings and flags with value, source and default. Descriptions and values are $userContent."
33
+ },
34
+ {
35
+ "name": "get_setting",
36
+ "requiredScopes": ["{namespace}:settings:read"]
37
+ },
38
+ {
39
+ "name": "propose_setting_change",
40
+ "requiredScopes": ["{namespace}:settings:propose"],
41
+ "description": "Creates a pending proposal bound to the acting user; a person approves or rejects it. Agents cannot change settings."
42
+ }
43
+ ],
44
+ "agentGuide": "./agent-guide.md"
45
+ },
46
+ "prisma": {
47
+ "owns": ["Setting", "SettingChange", "SettingProposal"],
48
+ "schemaFragment": "prisma/settings.prisma",
49
+ "schemaDigest": "sha256:048814bde0c5940ac40579e5d536f2e7ae2db91ce9f99e41f3d07fa044ef13d4"
50
+ },
51
+ "permissions": {
52
+ "definitions": ["settings:setting:read", "settings:setting:write"]
53
+ }
54
+ }
55
+ }
package/package.json CHANGED
@@ -1,6 +1,68 @@
1
1
  {
2
2
  "name": "@haneinfo/settings",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
3
+ "version": "0.1.1",
4
+ "private": false,
5
+ "description": "Runtime-adjustable settings and feature flags declared by plugins, with audited overrides, agent proposals and an optional MCP tool switch.",
6
+ "files": [
7
+ "dist",
8
+ "prisma",
9
+ "agent-guide.md",
10
+ "haneinfo.plugin.json",
11
+ "plugin.js",
12
+ "plugin.d.ts",
13
+ "README.md"
14
+ ],
15
+ "type": "commonjs",
16
+ "main": "./dist/index.js",
17
+ "types": "./dist/index.d.ts",
18
+ "exports": {
19
+ ".": {
20
+ "types": "./dist/index.d.ts",
21
+ "default": "./dist/index.js"
22
+ },
23
+ "./plugin": {
24
+ "types": "./dist/plugin.d.ts",
25
+ "default": "./dist/plugin.js"
26
+ },
27
+ "./haneinfo.plugin.json": "./haneinfo.plugin.json",
28
+ "./agent-guide.md": "./agent-guide.md",
29
+ "./package.json": "./package.json",
30
+ "./prisma/settings.prisma": "./prisma/settings.prisma",
31
+ "./prisma/settings.sql": "./prisma/settings.sql"
32
+ },
33
+ "dependencies": {
34
+ "@haneinfo/plugin-api": "1.23.0"
35
+ },
36
+ "peerDependencies": {
37
+ "@haneinfo/common": "^0.3.4 || ^0.4.0 || ^0.5.0",
38
+ "@haneinfo/plugin-host-nest": "^2.1.0",
39
+ "@nestjs/common": "^11.0.0",
40
+ "@nestjs/core": "^11.0.0",
41
+ "@prisma/client": "^6.19.0",
42
+ "zod": "^4.4.0",
43
+ "@haneinfo/plugin-api": "^1.22.0"
44
+ },
45
+ "devDependencies": {
46
+ "@nestjs/common": "^11.0.0",
47
+ "@nestjs/core": "^11.0.0",
48
+ "@prisma/client": "^6.19.0",
49
+ "@types/node": "^24.13.0",
50
+ "typescript": "^5.9.3",
51
+ "vitest": "^4.1.11",
52
+ "zod": "^4.4.0",
53
+ "@haneinfo/common": "0.5.0",
54
+ "@haneinfo/plugin-host-nest": "2.1.0",
55
+ "@haneinfo/plugin-testkit": "2.3.0"
56
+ },
57
+ "license": "UNLICENSED",
58
+ "publishConfig": {
59
+ "registry": "https://registry.npmjs.org/",
60
+ "access": "public"
61
+ },
62
+ "scripts": {
63
+ "build": "tsc -p tsconfig.build.json",
64
+ "dev": "tsc -p tsconfig.build.json --watch",
65
+ "test": "vitest run",
66
+ "typecheck": "tsc --noEmit"
67
+ }
6
68
  }
package/plugin.d.ts ADDED
@@ -0,0 +1 @@
1
+ export * from './dist/plugin';
package/plugin.js ADDED
@@ -0,0 +1 @@
1
+ module.exports = require('./dist/plugin.js');
@@ -0,0 +1,43 @@
1
+ /// Runtime override of a declared setting or feature flag. No row means no override: the value then
2
+ /// comes from static configuration or the declared default. Values are never secrets. @internal
3
+ model Setting {
4
+ code String @id
5
+ value Json
6
+ revision Int @default(1)
7
+ updatedBy String @map("updated_by")
8
+ updatedAt DateTime @default(now()) @updatedAt @map("updated_at")
9
+
10
+ @@map("settings")
11
+ }
12
+
13
+ /// Append-only audit of every override change (HTTP write or applied proposal). @internal
14
+ model SettingChange {
15
+ id String @id @default(cuid())
16
+ code String
17
+ before Json?
18
+ after Json?
19
+ actorId String @map("actor_id")
20
+ reason String?
21
+ source String
22
+ at DateTime @default(now())
23
+
24
+ @@index([code, at])
25
+ @@map("setting_changes")
26
+ }
27
+
28
+ /// A value an agent proposed; a person applies or rejects it. At most one PENDING per code. @internal
29
+ model SettingProposal {
30
+ id String @id @default(cuid())
31
+ code String
32
+ value Json
33
+ reason String?
34
+ proposedBy String @map("proposed_by")
35
+ status String @default("PENDING")
36
+ decidedBy String? @map("decided_by")
37
+ decidedAt DateTime? @map("decided_at")
38
+ createdAt DateTime @default(now()) @map("created_at")
39
+
40
+ @@index([code])
41
+ @@index([status, createdAt])
42
+ @@map("setting_proposals")
43
+ }
@@ -0,0 +1,39 @@
1
+ -- @haneinfo/settings: runtime overrides, their append-only audit and agent proposals.
2
+ CREATE TABLE settings (
3
+ code TEXT NOT NULL,
4
+ value JSONB NOT NULL,
5
+ revision INTEGER NOT NULL DEFAULT 1,
6
+ updated_by TEXT NOT NULL,
7
+ updated_at TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
8
+ CONSTRAINT settings_pkey PRIMARY KEY (code)
9
+ );
10
+ CREATE TABLE setting_changes (
11
+ id TEXT NOT NULL,
12
+ code TEXT NOT NULL,
13
+ before JSONB,
14
+ after JSONB,
15
+ actor_id TEXT NOT NULL,
16
+ reason TEXT,
17
+ source TEXT NOT NULL,
18
+ at TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
19
+ CONSTRAINT setting_changes_pkey PRIMARY KEY (id),
20
+ CONSTRAINT setting_changes_source_check CHECK (source IN ('HTTP', 'PROPOSAL'))
21
+ );
22
+ CREATE INDEX setting_changes_code_at_idx ON setting_changes (code, at);
23
+ CREATE TABLE setting_proposals (
24
+ id TEXT NOT NULL,
25
+ code TEXT NOT NULL,
26
+ value JSONB NOT NULL,
27
+ reason TEXT,
28
+ proposed_by TEXT NOT NULL,
29
+ status TEXT NOT NULL DEFAULT 'PENDING',
30
+ decided_by TEXT,
31
+ decided_at TIMESTAMP(3),
32
+ created_at TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
33
+ CONSTRAINT setting_proposals_pkey PRIMARY KEY (id),
34
+ CONSTRAINT setting_proposals_status_check CHECK (status IN ('PENDING', 'APPLIED', 'REJECTED'))
35
+ );
36
+ CREATE INDEX setting_proposals_code_idx ON setting_proposals (code);
37
+ CREATE INDEX setting_proposals_status_created_at_idx ON setting_proposals (status, created_at);
38
+ -- At most one pending proposal per code; a new proposal replaces the old one in the same transaction.
39
+ CREATE UNIQUE INDEX setting_proposals_one_pending_idx ON setting_proposals (code) WHERE status = 'PENDING';