agience-flare-dkg-integration 0.3.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Manoj Modhwadia
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,68 @@
+# agience-flare-dkg-integration (npm wrapper)
+
+Thin npm wrapper around the **Agience FLARE × DKG v10 Integration** Python package shipped on PyPI as [`agience-flare-dkg-integration`](https://pypi.org/project/agience-flare-dkg-integration/).
+
+The wrapper exists so the integration can be installed via `npm install -g` and resolved through the [OriginTrail DKG integrations registry](https://github.com/OriginTrail/dkg-integrations) `cli`-kind install flow, without bundling Python or running any install-time scripts.
+
+## What this package is — and is not
+
+**Is:** a 50-line Node CLI shim that spawns the Python `agience-dkg` CLI if it is on PATH, or prints a single clear `pipx install` / `pip install` hint if it is not.
+
+**Is not:** an alternative implementation. All logic — Working Memory writes, Shared Memory promotion, FLARE confidential retrieval, governed-mode commit-receipt projection, MCP Streamable HTTP transport, typed `agience:` RDF Knowledge Asset shaping — lives in the Python package.
+
+## Security posture
+
+- **No `preinstall`, `install`, or `postinstall` scripts.** Section 8a-compliant.
+- **No dynamic code loading.** No `eval`, no remote module fetch.
+- **No runtime dependencies.** Zero third-party packages in `dependencies`.
+- **No egress at install time.** The wrapper does nothing until you invoke `agience-dkg`.
+
+## Install
+
+```bash
+npm install -g agience-flare-dkg-integration
+```
+
+Then install the Python CLI it wraps:
+
+```bash
+pipx install agience-flare-dkg-integration==0.3.1
+# or:
+python -m pip install --user agience-flare-dkg-integration==0.3.1
+```
+
+If you invoke `agience-dkg` before the Python CLI is installed, the wrapper prints the install hint above and exits with code `127`.
+
+## Usage
+
+All flags and subcommands pass through to the Python CLI unchanged:
+
+```bash
+agience-dkg wm-write --title "session-note" --content "…"
+agience-dkg promote <ual>
+agience-dkg search "topic"
+```
+
+Wrapper-only flag:
+
+```bash
+agience-dkg --wrapper-version
+```
+
+## Configuration
+
+Set on the operator's environment, not handled by the wrapper:
+
+| Variable | Purpose |
+|---|---|
+| `DKG_BASE_URL` | Local DKG node base URL (default `http://localhost:8081`) |
+| `DKG_TOKEN` | Bearer token for the local DKG node |
+| `DKG_CONTEXT_GRAPH` | Context Graph slug to project into |
+| `AGIENCE_BASE_URL` | (governed mode) Agience platform base URL |
+| `AGIENCE_TOKEN` | (governed mode) Agience bearer token |
+
+See the [parent repository README](https://github.com/Muffinman75/agience-flare-dkg-integration#readme) and [DESIGN_BRIEF.md](https://github.com/Muffinman75/agience-flare-dkg-integration/blob/main/DESIGN_BRIEF.md) for the full integration story.
+
+## License
+
+MIT

package/bin/agience-dkg.js

@@ -0,0 +1,82 @@
+#!/usr/bin/env node
+// Thin Node-side wrapper around the Python `agience-dkg` CLI shipped on PyPI as
+// `agience-flare-dkg-integration`. This wrapper exists purely so the integration
+// can be installed via `npm install -g` (and resolved by the DKG integrations
+// registry installer) without bundling Python. It does *not* download, install,
+// or execute any remote code at install time: no postinstall hooks, no eval,
+// no remote fetch. All it does at runtime is spawn `agience-dkg` if it is on
+// PATH, or print a single clear install hint if it is not.
+//
+// SPDX-License-Identifier: MIT
+
+import { spawn } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { resolve, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { createRequire } from 'node:module';
+
+const require = createRequire(import.meta.url);
+const pkg = require('../package.json');
+
+const PYTHON_PACKAGE = 'agience-flare-dkg-integration';
+const PYTHON_CLI = 'agience-dkg';
+const PINNED_VERSION = pkg.version;
+
+const args = process.argv.slice(2);
+
+// `--wrapper-version` is a wrapper-only flag so operators can see exactly which
+// npm wrapper they have without invoking the Python side. Everything else
+// passes through untouched.
+if (args.length === 1 && args[0] === '--wrapper-version') {
+  process.stdout.write(`${pkg.name}@${pkg.version} (npm wrapper)\n`);
+  process.exit(0);
+}
+
+run();
+
+function run() {
+  const child = spawn(PYTHON_CLI, args, {
+    stdio: 'inherit',
+    shell: process.platform === 'win32',
+  });
+
+  child.on('error', (err) => {
+    if (err && err.code === 'ENOENT') {
+      printMissingPythonCliHint();
+      process.exit(127);
+    }
+    process.stderr.write(`agience-dkg: failed to launch underlying CLI: ${err.message}\n`);
+    process.exit(1);
+  });
+
+  child.on('exit', (code, signal) => {
+    if (signal) {
+      process.exit(1);
+    }
+    process.exit(code ?? 0);
+  });
+}
+
+function printMissingPythonCliHint() {
+  const lines = [
+    '',
+    `agience-dkg: underlying Python CLI '${PYTHON_CLI}' was not found on PATH.`,
+    '',
+    `This npm package (${pkg.name}@${pkg.version}) is a thin wrapper around the`,
+    `Python implementation shipped on PyPI as '${PYTHON_PACKAGE}'. The wrapper does`,
+    'not auto-install Python dependencies (no postinstall hooks, by design).',
+    '',
+    'One-line install:',
+    '',
+    `  pipx install ${PYTHON_PACKAGE}==${PINNED_VERSION}`,
+    '',
+    'Or via pip:',
+    '',
+    `  python -m pip install --user ${PYTHON_PACKAGE}==${PINNED_VERSION}`,
+    '',
+    'Then re-run the same command. Configure the local DKG node endpoint with',
+    'DKG_BASE_URL and DKG_TOKEN as documented in the README.',
+    '',
+  ];
+  process.stderr.write(lines.join('\n'));
+}

package/index.js

@@ -0,0 +1,27 @@
+// Programmatic surface for the agience-flare-dkg-integration npm wrapper.
+//
+// The integration's library API (DkgHttpClient, AgienceClient, models) lives
+// in the Python package on PyPI (`agience-flare-dkg-integration`). This npm
+// package exists to make the integration installable via `npm install -g` and
+// resolvable through the DKG integrations registry's `cli`-kind install flow.
+//
+// Node-side consumers should drive the CLI via spawn(), or call the local DKG
+// node's MCP Streamable HTTP transport directly. See the repository README for
+// MCP tool names and JSON-RPC shapes.
+//
+// SPDX-License-Identifier: MIT
+
+import { createRequire } from 'node:module';
+
+const require = createRequire(import.meta.url);
+const pkg = require('./package.json');
+
+export const wrapperVersion = pkg.version;
+export const pythonPackage = 'agience-flare-dkg-integration';
+export const pythonCli = 'agience-dkg';
+
+export default {
+  wrapperVersion,
+  pythonPackage,
+  pythonCli,
+};

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "agience-flare-dkg-integration",
+  "version": "0.3.1",
+  "description": "npm wrapper for the Agience FLARE \u00d7 DKG v10 Integration. Governance layer above DKG v10: commit-gated Agience artifacts \u2192 typed agience: RDF Knowledge Assets in Working Memory and Shared Memory via MCP Streamable HTTP. Wrapper delegates to the Python CLI (agience-dkg) shipped on PyPI as agience-flare-dkg-integration.",
+  "keywords": [
+    "origintrail",
+    "dkg",
+    "dkg-v10",
+    "working-memory",
+    "shared-memory",
+    "agience",
+    "flare",
+    "mcp",
+    "knowledge-graph",
+    "governance"
+  ],
+  "license": "MIT",
+  "author": "Manoj Modhwadia <manojmodhwadia@outlook.com>",
+  "homepage": "https://github.com/Muffinman75/agience-flare-dkg-integration#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Muffinman75/agience-flare-dkg-integration.git",
+    "directory": "npm-wrapper"
+  },
+  "bugs": {
+    "url": "https://github.com/Muffinman75/agience-flare-dkg-integration/issues"
+  },
+  "type": "module",
+  "main": "index.js",
+  "bin": {
+    "agience-dkg": "bin/agience-dkg.js"
+  },
+  "files": [
+    "bin/",
+    "index.js",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {}
+}